[
{
"path": ".gitignore",
"content": "## Ignore Visual Studio temporary files, build results, and\n## files generated by popular Visual Studio add-ons.\n\n# User-specific files\n*.suo\n*.user\n*.userosscache\n*.sln.docstates\n\n# User-specific files (MonoDevelop/Xamarin Studio)\n*.userprefs\n\n# Build results\n[Dd]ebug/\n[Dd]ebugPublic/\n[Rr]elease/\n[Rr]eleases/\nx64/\nx86/\nbuild/\nbld/\n[Bb]in/\n[Oo]bj/\n\n# Visual Studo 2015 cache/options directory\n.vs/\n\n# MSTest test Results\n[Tt]est[Rr]esult*/\n[Bb]uild[Ll]og.*\n\n# NUNIT\n*.VisualState.xml\nTestResult.xml\n\n# Build Results of an ATL Project\n[Dd]ebugPS/\n[Rr]eleasePS/\ndlldata.c\n\n*_i.c\n*_p.c\n*_i.h\n*.ilk\n*.meta\n*.obj\n*.pch\n*.pdb\n*.pgc\n*.pgd\n*.rsp\n*.sbr\n*.tlb\n*.tli\n*.tlh\n*.tmp\n*.tmp_proj\n*.log\n*.vspscc\n*.vssscc\n.builds\n*.pidb\n*.svclog\n*.scc\n\n# Chutzpah Test files\n_Chutzpah*\n\n# Visual C++ cache files\nipch/\n*.aps\n*.ncb\n*.opensdf\n*.sdf\n*.cachefile\n\n# Visual Studio profiler\n*.psess\n*.vsp\n*.vspx\n\n# TFS 2012 Local Workspace\n$tf/\n\n# Guidance Automation Toolkit\n*.gpState\n\n# ReSharper is a .NET coding add-in\n_ReSharper*/\n*.[Rr]e[Ss]harper\n*.DotSettings.user\n\n# JustCode is a .NET coding addin-in\n.JustCode\n\n# TeamCity is a build add-in\n_TeamCity*\n\n# DotCover is a Code Coverage Tool\n*.dotCover\n\n# NCrunch\n_NCrunch_*\n.*crunch*.local.xml\n\n# MightyMoose\n*.mm.*\nAutoTest.Net/\n\n# Web workbench (sass)\n.sass-cache/\n\n# Installshield output folder\n[Ee]xpress/\n\n# DocProject is a documentation generator add-in\nDocProject/buildhelp/\nDocProject/Help/*.HxT\nDocProject/Help/*.HxC\nDocProject/Help/*.hhc\nDocProject/Help/*.hhk\nDocProject/Help/*.hhp\nDocProject/Help/Html2\nDocProject/Help/html\n\n# Click-Once directory\npublish/\n\n# Publish Web Output\n*.[Pp]ublish.xml\n*.azurePubxml\n# TODO: Comment the next line if you want to checkin your web deploy settings \n# but database connection strings (with potential passwords) will be unencrypted\n*.pubxml\n*.publishproj\n\n# NuGet Packages\n*.nupkg\n.nuget/nuget.exe\n# The packages folder can be ignored because of Package Restore\n**/packages/*\n# except build/, which is used as an MSBuild target.\n!**/packages/build/\n# Uncomment if necessary however generally it will be regenerated when needed\n#!**/packages/repositories.config\n\n# Windows Azure Build Output\ncsx/\n*.build.csdef\n\n# Windows Store app package directory\nAppPackages/\n\n# Others\n*.[Cc]ache\nClientBin/\n[Ss]tyle[Cc]op.*\n~$*\n*~\n*.dbmdl\n*.dbproj.schemaview\n*.pfx\n*.publishsettings\nnode_modules/\nbower_components/\n\n# RIA/Silverlight projects\nGenerated_Code/\n\n# Backup & report files from converting an old project file\n# to a newer Visual Studio version. Backup files are not needed,\n# because we have git ;-)\n_UpgradeReport_Files/\nBackup*/\nUpgradeLog*.XML\nUpgradeLog*.htm\n\n# SQL Server files\n*.mdf\n*.ldf\n\n# Business Intelligence projects\n*.rdl.data\n*.bim.layout\n*.bim_*.settings\n\n# Microsoft Fakes\nFakesAssemblies/\n\n# Node.js Tools for Visual Studio\n.ntvs_analysis.dat\n\n# Visual Studio 6 build log\n*.plg\n\n# Visual Studio 6 workspace options file\n*.opt\n"
},
{
"path": ".nuget/AlexaSkillsKit.Lib.nuspec",
"content": "\n\n \n AlexaSkillsKit.NET\n 1.6.0\n AlexaSkillsKit.NET\n Stefan Negritoiu (FreeBusy) and contributors\n Stefan Negritoiu (FreeBusy)\n https://github.com/AreYouFreeBusy/AlexaSkillsKit.NET\n http://opensource.org/licenses/MIT\n https://developer.amazon.com/public/binaries/content/gallery/developerportalpublic/solutions/alexa/dp_image_kit_02.png\n false\n \n.NET library that simplifies Alexa skills development; same object model as Amazon's AlexaSkillsKit for Java\n \n \n1.4.0: Ability to override request validation policy and support for SSML output speech type\n1.5.0: Fully implement certificate verification requirement and support for Standard cards\n1.6.0: Implement support for Context object (Device Location, Audio Player, etc.), PlaybackController, Display, Dialog directives, and VideoApp. See project README for new interfaces.\n \n Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors\n amazon echo alexa speechlet\n \n \n \n \n \n \n \n \n \n"
},
{
"path": ".nuget/NuGet.Config",
"content": "\n\n \n \n \n"
},
{
"path": ".nuget/pack.cmd",
"content": "msbuild /property:Configuration=Release ..\\AlexaSkillsKit.Lib\\AlexaSkillsKit.Lib.csproj\nnuget pack AlexaSkillsKit.Lib.nuspec"
},
{
"path": "AlexaSkillsKit.Lib/AlexaSkillsKit.Lib.csproj",
"content": "\n\n \n \n Debug\n AnyCPU\n {0EC882A8-AACA-4BD5-B449-72F20FDB8586}\n Library\n Properties\n AlexaSkillsKit\n AlexaSkillsKit\n v4.5\n 512\n ..\\\n true\n \n \n true\n full\n false\n bin\\Debug\\\n DEBUG;TRACE\n prompt\n 4\n \n \n pdbonly\n true\n bin\\Release\\\n TRACE\n prompt\n 4\n \n \n \n ..\\packages\\BouncyCastle.1.8.1\\lib\\BouncyCastle.Crypto.dll\n True\n \n \n ..\\packages\\Newtonsoft.Json.7.0.1\\lib\\net45\\Newtonsoft.Json.dll\n True\n \n \n \n \n \n \n ..\\packages\\Microsoft.AspNet.WebApi.Client.5.2.3\\lib\\net45\\System.Net.Http.Formatting.dll\n True\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "AlexaSkillsKit.Lib/AsyncHelpers.cs",
"content": "// As discussed at http://stackoverflow.com/a/5097066\n\nusing System;\nusing System.Collections.Generic;\nusing System.Threading;\nusing System.Threading.Tasks;\n\nnamespace AlexaSkillsKit\n{\n public static class AsyncHelpers\n {\n /// \n /// Execute's an async Task method which has a void return value synchronously\n /// \n /// Task method to execute\n public static void RunSync(Func task) {\n var oldContext = SynchronizationContext.Current;\n var synch = new ExclusiveSynchronizationContext();\n SynchronizationContext.SetSynchronizationContext(synch);\n synch.Post(async _ => {\n try {\n await task();\n }\n catch (Exception e) {\n synch.InnerException = e;\n throw;\n }\n finally {\n synch.EndMessageLoop();\n }\n }, null);\n synch.BeginMessageLoop();\n\n SynchronizationContext.SetSynchronizationContext(oldContext);\n }\n\n /// \n /// Execute's an async Task method which has a T return type synchronously\n /// \n /// Return Type\n /// Task method to execute\n /// \n public static T RunSync(Func> task) {\n var oldContext = SynchronizationContext.Current;\n var synch = new ExclusiveSynchronizationContext();\n SynchronizationContext.SetSynchronizationContext(synch);\n T ret = default(T);\n synch.Post(async _ => {\n try {\n ret = await task();\n }\n catch (Exception e) {\n synch.InnerException = e;\n throw;\n }\n finally {\n synch.EndMessageLoop();\n }\n }, null);\n synch.BeginMessageLoop();\n SynchronizationContext.SetSynchronizationContext(oldContext);\n return ret;\n }\n\n private class ExclusiveSynchronizationContext : SynchronizationContext\n {\n private bool done;\n public Exception InnerException { get; set; }\n readonly AutoResetEvent workItemsWaiting = new AutoResetEvent(false);\n readonly Queue> items =\n new Queue>();\n\n public override void Send(SendOrPostCallback d, object state) {\n throw new NotSupportedException(\"We cannot send to our same thread\");\n }\n\n public override void Post(SendOrPostCallback d, object state) {\n lock (items) {\n items.Enqueue(Tuple.Create(d, state));\n }\n workItemsWaiting.Set();\n }\n\n public void EndMessageLoop() {\n Post(_ => done = true, null);\n }\n\n public void BeginMessageLoop() {\n while (!done) {\n Tuple task = null;\n lock (items) {\n if (items.Count > 0) {\n task = items.Dequeue();\n }\n }\n if (task != null) {\n task.Item1(task.Item2);\n if (InnerException != null) // the method threw an exeption\n {\n throw new AggregateException(\"AsyncHelpers.Run method threw an exception.\", InnerException);\n }\n }\n else {\n workItemsWaiting.WaitOne();\n }\n }\n }\n\n public override SynchronizationContext CreateCopy() {\n return this;\n }\n }\n }\n}\n"
},
{
"path": "AlexaSkillsKit.Lib/Authentication/SpeechletRequestSignatureVerifier.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing System.Collections;\nusing System.Collections.Generic;\nusing System.IO;\nusing System.Linq;\nusing System.Net;\nusing System.Net.Http;\nusing System.Runtime.Caching;\nusing System.Text;\nusing System.Text.RegularExpressions;\nusing System.Threading.Tasks;\nusing Org.BouncyCastle.X509;\nusing Org.BouncyCastle.Security.Certificates;\n\nnamespace AlexaSkillsKit.Authentication\n{\n public class SpeechletRequestSignatureVerifier\n {\n private static Func _getCertCacheKey = (string url) => string.Format(\"{0}_{1}\", Sdk.SIGNATURE_CERT_URL_REQUEST_HEADER, url);\n\n private static CacheItemPolicy _policy = new CacheItemPolicy {\n Priority = CacheItemPriority.Default,\n AbsoluteExpiration = DateTimeOffset.UtcNow.AddHours(24)\n };\n\n\n /// \n /// Verifying the Signature Certificate URL per requirements documented at\n /// https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/developing-an-alexa-skill-as-a-web-service\n /// \n public static bool VerifyCertificateUrl(string certChainUrl) {\n if (String.IsNullOrEmpty(certChainUrl)) {\n return false;\n }\n\n Uri certChainUri;\n if (!Uri.TryCreate(certChainUrl, UriKind.Absolute, out certChainUri)) {\n return false;\n }\n\n return\n certChainUri.Host.Equals(Sdk.SIGNATURE_CERT_URL_HOST, StringComparison.OrdinalIgnoreCase) &&\n certChainUri.PathAndQuery.StartsWith(Sdk.SIGNATURE_CERT_URL_PATH) &&\n certChainUri.Scheme == Uri.UriSchemeHttps &&\n certChainUri.Port == 443;\n }\n\n\n /// \n /// Verifies request signature and manages the caching of the signature certificate\n /// \n public static bool VerifyRequestSignature(\n byte[] serializedSpeechletRequest, string expectedSignature, string certChainUrl) {\n\n string certCacheKey = _getCertCacheKey(certChainUrl);\n X509Certificate cert = MemoryCache.Default.Get(certCacheKey) as X509Certificate;\n if (cert == null ||\n !CheckRequestSignature(serializedSpeechletRequest, expectedSignature, cert)) {\n\n // download the cert \n // if we don't have it in cache or\n // if we have it but it's stale because the current request was signed with a newer cert\n // (signaled by signature check fail with cached cert)\n cert = RetrieveAndVerifyCertificate(certChainUrl);\n if (cert == null) return false;\n\n MemoryCache.Default.Set(certCacheKey, cert, _policy);\n }\n\n return CheckRequestSignature(serializedSpeechletRequest, expectedSignature, cert);\n }\n\n\n /// \n /// Verifies request signature and manages the caching of the signature certificate\n /// \n public async static Task VerifyRequestSignatureAsync(\n byte[] serializedSpeechletRequest, string expectedSignature, string certChainUrl) {\n\n string certCacheKey = _getCertCacheKey(certChainUrl);\n X509Certificate cert = MemoryCache.Default.Get(certCacheKey) as X509Certificate;\n if (cert == null ||\n !CheckRequestSignature(serializedSpeechletRequest, expectedSignature, cert)) {\n\n // download the cert \n // if we don't have it in cache or \n // if we have it but it's stale because the current request was signed with a newer cert\n // (signaled by signature check fail with cached cert)\n cert = await RetrieveAndVerifyCertificateAsync(certChainUrl);\n if (cert == null) return false;\n\n MemoryCache.Default.Set(certCacheKey, cert, _policy);\n }\n\n return CheckRequestSignature(serializedSpeechletRequest, expectedSignature, cert);\n }\n\n\n /// \n /// \n /// \n public static X509Certificate RetrieveAndVerifyCertificate(string certChainUrl) {\n // making requests to externally-supplied URLs is an open invitation to DoS\n // so restrict host to an Alexa controlled subdomain/path\n if (!VerifyCertificateUrl(certChainUrl)) return null;\n\n var webClient = new WebClient();\n var content = webClient.DownloadString(certChainUrl);\n\n var pemReader = new Org.BouncyCastle.OpenSsl.PemReader(new StringReader(content));\n var cert = (X509Certificate)pemReader.ReadObject();\n try {\n cert.CheckValidity();\n if (!CheckCertSubjectNames(cert)) return null;\n }\n catch (CertificateExpiredException) {\n return null;\n }\n catch (CertificateNotYetValidException) {\n return null;\n }\n\n return cert;\n }\n\n\n /// \n /// \n /// \n public async static Task RetrieveAndVerifyCertificateAsync(string certChainUrl) {\n // making requests to externally-supplied URLs is an open invitation to DoS\n // so restrict host to an Alexa controlled subdomain/path\n if (!VerifyCertificateUrl(certChainUrl)) return null;\n\n var httpClient = new HttpClient();\n var httpResponse = await httpClient.GetAsync(certChainUrl);\n var content = await httpResponse.Content.ReadAsStringAsync();\n if (String.IsNullOrEmpty(content)) return null;\n\n var pemReader = new Org.BouncyCastle.OpenSsl.PemReader(new StringReader(content));\n var cert = (X509Certificate)pemReader.ReadObject();\n try {\n cert.CheckValidity(); \n if (!CheckCertSubjectNames(cert)) return null;\n }\n catch (CertificateExpiredException) {\n return null;\n }\n catch (CertificateNotYetValidException) {\n return null;\n }\n\n return cert;\n }\n\n\n /// \n /// \n /// \n public static bool CheckRequestSignature(\n byte[] serializedSpeechletRequest, string expectedSignature, Org.BouncyCastle.X509.X509Certificate cert) {\n\n byte[] expectedSig = null;\n try {\n expectedSig = Convert.FromBase64String(expectedSignature);\n }\n catch (FormatException) {\n return false;\n }\n\n var publicKey = (Org.BouncyCastle.Crypto.Parameters.RsaKeyParameters)cert.GetPublicKey();\n var signer = Org.BouncyCastle.Security.SignerUtilities.GetSigner(Sdk.SIGNATURE_ALGORITHM);\n signer.Init(false, publicKey);\n signer.BlockUpdate(serializedSpeechletRequest, 0, serializedSpeechletRequest.Length); \n\n return signer.VerifySignature(expectedSig);\n }\n\n\n /// \n /// \n /// \n private static bool CheckCertSubjectNames(X509Certificate cert) {\n bool found = false;\n ArrayList subjectNamesList = (ArrayList)cert.GetSubjectAlternativeNames();\n for (int i=0; i < subjectNamesList.Count; i++) {\n ArrayList subjectNames = (ArrayList)subjectNamesList[i];\n for (int j = 0; j < subjectNames.Count; j++) {\n if (subjectNames[j] is String && subjectNames[j].Equals(Sdk.ECHO_API_DOMAIN_NAME)) {\n found = true;\n break;\n }\n }\n }\n\n return found;\n }\n }\n}\n"
},
{
"path": "AlexaSkillsKit.Lib/Authentication/SpeechletRequestTimestampVerifier.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing System.Diagnostics;\nusing AlexaSkillsKit.Json;\n\nnamespace AlexaSkillsKit.Authentication\n{\n public class SpeechletRequestTimestampVerifier\n {\n /// \n /// Verifies request timestamp\n /// \n public static bool VerifyRequestTimestamp(SpeechletRequestEnvelope requestEnvelope, DateTime referenceTimeUtc) {\n // verify timestamp is within tolerance\n var diff = referenceTimeUtc - requestEnvelope.Request.Timestamp;\n Debug.WriteLine(\"Request was timestamped {0:0.00} seconds ago.\", diff.TotalSeconds);\n return (Math.Abs((decimal)diff.TotalSeconds) <= Sdk.TIMESTAMP_TOLERANCE_SEC);\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Authentication/SpeechletRequestValidationResult.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\n\nnamespace AlexaSkillsKit.Authentication\n{\n [Flags]\n public enum SpeechletRequestValidationResult\n {\n OK = 0,\n NoSignatureHeader = 1,\n NoCertHeader = 2,\n InvalidSignature = 4,\n InvalidTimestamp = 8,\n InvalidJson = 16,\n InvalidApplicationId = 32,\n NoContent = 64,\n InvalidVersion = 128\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Helpers/DateTimeHelpers.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing Newtonsoft.Json;\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Helpers\n{\n public class DateTimeHelpers\n {\n public static DateTime FromAlexaTimestamp(JObject requestJson) {\n try {\n return requestJson[\"timestamp\"].Value();\n }\n catch (Exception ex) \n when (ex is InvalidCastException || ex is FormatException) {\n try {\n return FromUnixTimeMilliseconds(requestJson[\"timestamp\"].Value()).DateTime;\n }\n catch (ArgumentOutOfRangeException) {\n throw ex;\n }\n }\n }\n\n\n /// \n /// Mirror DateTimeOffset.FromUnixTimeMilliseconds method signature introduced in .NET Framework 4.6\n /// https://msdn.microsoft.com/en-us/library/system.datetimeoffset.fromunixtimemilliseconds(v=vs.110).aspx\n /// \n /// \n /// A Unix time, expressed as the number of milliseconds that have elapsed since 1970-01-01T00:00:00Z (January 1, 1970, at 12:00 AM UTC). For Unix times before this date, its value is negative.\n /// \n /// \n /// A date and time value that represents the same moment in time as the Unix time.\n /// \n public static DateTimeOffset FromUnixTimeMilliseconds(string timestamp) {\n long milliseconds;\n if (!long.TryParse(timestamp, out milliseconds) ||\n milliseconds < -62135596800000 ||\n milliseconds > 253402300799999) {\n throw new ArgumentOutOfRangeException(\"timestamp\");\n }\n\n var epoch = new DateTimeOffset(1970, 1, 1, 0, 0, 0, TimeZoneInfo.Utc.BaseUtcOffset);\n return epoch.AddMilliseconds(milliseconds);\n }\n }\n}\n"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/AudioPlayer/AudioItem.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Interfaces.AudioPlayer\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/audioplayer-interface-reference.html#play\n /// \n public class AudioItem\n {\n public virtual AudioItemStream Stream {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/AudioPlayer/AudioItemStream.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Interfaces.AudioPlayer\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/audioplayer-interface-reference.html#play\n /// \n public class AudioItemStream\n {\n public virtual string Url {\n get;\n set;\n }\n\n public virtual string Token {\n get;\n set;\n }\n\n public virtual string ExpectedPreviousToken {\n get;\n set;\n }\n\n public virtual long OffsetInMilliseconds {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/AudioPlayer/AudioPlayerInterface.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Speechlet;\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Interfaces.AudioPlayer\n{\n public class AudioPlayerInterface : ISpeechletInterface\n {\n public static AudioPlayerInterface FromJson(JObject json)\n {\n if (json == null) return null;\n\n return new AudioPlayerInterface();\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/AudioPlayer/AudioPlayerPlaybackFailedRequest.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Speechlet;\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Interfaces.AudioPlayer\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/audioplayer-interface-reference.html#playbackfailed\n /// \n public class AudioPlayerPlaybackFailedRequest : AudioPlayerRequest\n {\n public AudioPlayerPlaybackFailedRequest(string subtype, JObject json) : base(subtype, json) {\n Error = Error.FromJson(json.Value(\"error\"));\n CurrentPlaybackState = PlaybackState.FromJson(json.Value(\"currentPlaybackState\"));\n }\n\n public Error Error {\n get;\n private set;\n }\n\n public PlaybackState CurrentPlaybackState {\n get;\n private set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/AudioPlayer/AudioPlayerRequest.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Speechlet;\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Interfaces.AudioPlayer\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/audioplayer-interface-reference.html#requests\n /// \n public class AudioPlayerRequest : ExtendedSpeechletRequest\n {\n public static readonly string TypeName = \"AudioPlayer\";\n\n public AudioPlayerRequest(string subtype, JObject json) : base(TypeName, subtype, json) {\n Token = json.Value(\"token\");\n OffsetInMilliseconds = json.Value(\"offsetInMilliseconds\");\n }\n\n public string Token {\n get;\n private set;\n }\n\n public long? OffsetInMilliseconds {\n get;\n private set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/AudioPlayer/AudioPlayerResponse.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Interfaces.AudioPlayer.Directives;\nusing AlexaSkillsKit.Speechlet;\nusing System.Collections.Generic;\n\nnamespace AlexaSkillsKit.Interfaces.AudioPlayer\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/request-and-response-json-reference.html#response-to-audioplayer-or-playbackcontroller-example-directives-only\n /// \n public class AudioPlayerResponse : ISpeechletResponse\n {\n public virtual IEnumerable Directives {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/AudioPlayer/AudioPlayerState.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Speechlet;\nusing Newtonsoft.Json.Linq;\nusing System;\n\nnamespace AlexaSkillsKit.Interfaces.AudioPlayer\n{\n public class AudioPlayerState : ISpeechletInterfaceState\n {\n public static AudioPlayerState FromJson(JObject json) {\n if (json == null) return null;\n\n PlayerActivityEnum playerActivity = PlayerActivityEnum.NONE;\n Enum.TryParse(json.Value(\"playerActivity\"), out playerActivity);\n return new AudioPlayerState {\n OffsetInMilliseconds = json.Value(\"offsetInMilliseconds\"),\n Token = json.Value(\"token\"),\n PlayerActivity = playerActivity\n };\n }\n\n public long? OffsetInMilliseconds {\n get;\n private set;\n }\n\n public string Token {\n get;\n private set;\n }\n\n public PlayerActivityEnum PlayerActivity {\n get;\n private set;\n }\n\n public enum PlayerActivityEnum\n {\n NONE = 0, // default in case parsing fails\n PLAYING,\n PAUSED,\n FINISHED,\n BUFFER_UNDERRUN,\n IDLE,\n STOPPED\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/AudioPlayer/Directives/AudioPlayerClearQueueDirective.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Interfaces.AudioPlayer.Directives\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/audioplayer-interface-reference.html#clearqueue\n /// \n public class AudioPlayerClearQueueDirective : AudioPlayerDirective\n {\n public AudioPlayerClearQueueDirective() : base(\"ClearQueue\") {\n\n }\n\n public virtual ClearBehaviorEnum ClearBehavior {\n get;\n set;\n }\n\n public enum ClearBehaviorEnum\n {\n CLEAR_ENQUEUED,\n CLEAR_ALL\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/AudioPlayer/Directives/AudioPlayerDirective.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Speechlet;\n\nnamespace AlexaSkillsKit.Interfaces.AudioPlayer.Directives\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/audioplayer-interface-reference.html#directives\n /// \n public class AudioPlayerDirective : Directive\n {\n public AudioPlayerDirective(string subtype) : base($\"AudioPlayer.{subtype}\") {\n\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/AudioPlayer/Directives/AudioPlayerPlayDirective.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Interfaces.AudioPlayer.Directives\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/audioplayer-interface-reference.html#play\n /// \n public class AudioPlayerPlayDirective : AudioPlayerDirective\n {\n public AudioPlayerPlayDirective() : base(\"Play\") {\n\n }\n\n public virtual PlayBehaviorEnum PlayBehavior {\n get;\n set;\n }\n\n public virtual AudioItem AudioItem {\n get;\n set;\n }\n\n public enum PlayBehaviorEnum\n {\n REPLACE_ALL,\n ENQUEUE,\n REPLACE_ENQUEUED\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/AudioPlayer/Directives/AudioPlayerStopDirective.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Interfaces.AudioPlayer.Directives\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/audioplayer-interface-reference.html#stop\n /// \n public class AudioPlayerStopDirective : AudioPlayerDirective\n {\n public AudioPlayerStopDirective() : base(\"Stop\") {\n\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/AudioPlayer/IAudioPlayerSpeechlet.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Speechlet;\n\nnamespace AlexaSkillsKit.Interfaces.AudioPlayer\n{\n public interface IAudioPlayerSpeechlet\n {\n AudioPlayerResponse OnAudioPlayer(AudioPlayerRequest audioRequest, Context context);\n AudioPlayerResponse OnPlaybackController(PlaybackControllerRequest playbackRequest, Context context);\n void OnSystemExceptionEncountered(SystemExceptionEncounteredRequest systemRequest, Context context);\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/AudioPlayer/IAudioPlayerSpeechletAsync.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Speechlet;\nusing System.Threading.Tasks;\n\nnamespace AlexaSkillsKit.Interfaces.AudioPlayer\n{\n public interface IAudioPlayerSpeechletAsync\n {\n Task OnAudioPlayerAsync(AudioPlayerRequest audioRequest, Context context);\n Task OnPlaybackControllerAsync(PlaybackControllerRequest playbackRequest, Context context);\n Task OnSystemExceptionEncounteredAsync(SystemExceptionEncounteredRequest systemRequest, Context context);\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/AudioPlayer/PlaybackControllerRequest.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Speechlet;\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Interfaces.AudioPlayer\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/playback-controller-interface-reference.html#requests\n /// \n public class PlaybackControllerRequest : ExtendedSpeechletRequest\n {\n public static readonly string TypeName = \"PlaybackController\";\n\n public PlaybackControllerRequest(string subtype, JObject json) : base(TypeName, subtype, json) {\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Dialog/Directives/DialogConfirmIntentDirective.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Interfaces.Dialog.Directives\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/dialog-interface-reference.html#confirmintent\n /// \n public class DialogConfirmIntentDirective : DialogDirective\n {\n public DialogConfirmIntentDirective() : base(\"ConfirmIntent\") {\n\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Dialog/Directives/DialogConfirmSlotDirective.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Interfaces.Dialog.Directives\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/dialog-interface-reference.html#confirmslot\n /// \n public class DialogConfirmSlotDirective : DialogDirective\n {\n public DialogConfirmSlotDirective() : base(\"ConfirmSlot\") {\n\n }\n\n public virtual string SlotToConfirm {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Dialog/Directives/DialogDelegateDirective.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Interfaces.Dialog.Directives\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/dialog-interface-reference.html#delegate\n /// \n public class DialogDelegateDirective : DialogDirective\n {\n public DialogDelegateDirective() : base(\"Delegate\") {\n\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Dialog/Directives/DialogDirective.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Slu;\nusing AlexaSkillsKit.Speechlet;\n\nnamespace AlexaSkillsKit.Interfaces.Dialog.Directives\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/dialog-interface-reference.html#directives\n /// \n public class DialogDirective: Directive\n {\n public DialogDirective(string subtype) : base($\"Dialog.{subtype}\") {\n\n }\n\n public virtual Intent UpdatedIntent {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Dialog/Directives/DialogElicitSlotDirective.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Interfaces.Dialog.Directives\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/dialog-interface-reference.html#elicitslot\n /// \n public class DialogElicitSlotDirective : DialogDirective\n {\n public DialogElicitSlotDirective() : base(\"ElicitSlot\") {\n\n }\n\n public virtual string SlotToElicit {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Display/Directives/DisplayRenderTemplateDirective.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Speechlet;\n\nnamespace AlexaSkillsKit.Interfaces.Display.Directives\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/display-interface-reference.html#form-of-the-displayrendertemplate-directive\n /// \n public class DisplayRenderTemplateDirective : Directive\n {\n public DisplayRenderTemplateDirective() : base(\"Display.RenderTemplate\") {\n\n }\n\n public virtual DisplayTemplate Template {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Display/Directives/HintDirective.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Speechlet;\n\nnamespace AlexaSkillsKit.Interfaces.Display.Directives\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/display-interface-reference.html#hint-directive\n /// \n public class HintDirective : Directive\n {\n public HintDirective() : base(\"Hint\") {\n\n }\n\n public virtual TextField Hint {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Display/DisplayImage.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System.Collections.Generic;\n\nnamespace AlexaSkillsKit.Interfaces.Display\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/display-interface-reference.html#image-object-specifications\n /// \n public class DisplayImage\n {\n public virtual string ContentDescription {\n get;\n set;\n }\n\n public virtual IEnumerable Sources {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Display/DisplayImageSource.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Interfaces.Display\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/display-interface-reference.html#image-object-specifications\n /// \n public class DisplayImageSource\n {\n public virtual string Url {\n get;\n set;\n }\n\n public virtual ImageSizeEnum Size {\n get;\n set;\n }\n\n public virtual int WidthPixels {\n get;\n set;\n }\n\n public virtual int HeightPixels {\n get;\n set;\n }\n\n public enum ImageSizeEnum\n {\n X_SMALL,\n SMALL,\n MEDIUM,\n LARGE,\n X_LARGE\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Display/DisplayInterface.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Speechlet;\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Interfaces.Display\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/display-interface-reference.html#determining-the-version-of-the-supported-display\n /// \n public class DisplayInterface: ISpeechletInterface\n {\n private const string DefaultTemplateVersion = \"1\";\n private const string DefaultMarkupVersion = \"1\";\n\n public static DisplayInterface FromJson(JObject json) {\n if (json == null) return null;\n\n return new DisplayInterface {\n TemplateVersion = json.Value(\"templateVersion\") ?? DefaultTemplateVersion,\n MarkupVersion = json.Value(\"markupVersion\") ?? DefaultMarkupVersion,\n Token = json.Value(\"token\")\n };\n }\n\n public string TemplateVersion {\n get;\n private set;\n }\n\n public string MarkupVersion {\n get;\n private set;\n }\n\n public string Token {\n get;\n private set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Display/DisplayRequest.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Speechlet;\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Interfaces.Display\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/display-interface-reference.html#touch-selection-events\n /// \n public class DisplayRequest : ExtendedSpeechletRequest\n {\n public static readonly string TypeName = \"Display\";\n\n public DisplayRequest(string subtype, JObject json) : base(TypeName, subtype, json) {\n Token = json.Value(\"token\");\n }\n\n public string Token {\n get;\n private set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Display/DisplayTemplate.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System.Collections.Generic;\n\nnamespace AlexaSkillsKit.Interfaces.Display\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/display-interface-reference.html#display-template-elements\n /// \n public class DisplayTemplate\n {\n public virtual string Type {\n get;\n set;\n }\n\n public virtual string Token {\n get;\n set;\n }\n\n public virtual string Title {\n get;\n set;\n }\n\n public virtual TextContent TextContent {\n get;\n set;\n }\n\n public virtual ButtonStateEnum BackButton {\n get;\n set;\n }\n\n public virtual DisplayImage BackgroundImage {\n get;\n set;\n }\n\n public virtual DisplayImage Image {\n get;\n set;\n }\n\n public virtual IEnumerable ListItems {\n get;\n set;\n }\n\n public enum ButtonStateEnum\n {\n HIDDEN,\n VISIBLE\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Display/IDisplaySpeechlet.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Speechlet;\n\nnamespace AlexaSkillsKit.Interfaces.Display\n{\n public interface IDisplaySpeechlet\n {\n SpeechletResponse OnDisplay(DisplayRequest displayRequest, Context context);\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Display/IDisplaySpeechletAsync.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Speechlet;\nusing System.Threading.Tasks;\n\nnamespace AlexaSkillsKit.Interfaces.Display\n{\n public interface IDisplaySpeechletAsync\n {\n Task OnDisplayAsync(DisplayRequest displayRequest, Context context);\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Display/ListItem.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Interfaces.Display\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/display-interface-reference.html#display-template-elements\n /// \n public class ListItem\n {\n public virtual string Token {\n get;\n set;\n }\n\n public virtual DisplayImage Image {\n get;\n set;\n }\n\n public virtual TextContent TextContent {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Display/TextContent.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Interfaces.Display\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/display-interface-reference.html#textcontent-object-specifications\n /// \n public class TextContent\n {\n public virtual TextField PrimaryText {\n get;\n set;\n }\n\n public virtual TextField SecondaryText {\n get;\n set;\n }\n\n public virtual TextField TertiaryText {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/Display/TextField.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Interfaces.Display\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/display-interface-reference.html#textcontent-object-specifications\n /// \n public class TextField\n {\n public virtual TextTypeEnum Type {\n get;\n set;\n }\n\n public virtual string Text {\n get;\n set;\n }\n\n public enum TextTypeEnum\n {\n PlainText,\n RichText\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/VideoApp/Directives/VideoAppLaunchDirective.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Speechlet;\n\nnamespace AlexaSkillsKit.Interfaces.VideoApp.Directives\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/videoapp-interface-reference.html#videoapp-directives\n /// \n public class VideoAppLaunchDirective : Directive\n {\n public VideoAppLaunchDirective() : base(\"VideoApp.Launch\") {\n\n }\n\n public virtual VideoItem VideoItem {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/VideoApp/VideoItem.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Interfaces.VideoApp\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/videoapp-interface-reference.html#parameters-of-response\n /// \n public class VideoItem\n {\n public virtual string Source {\n get;\n set;\n }\n\n public virtual VideoItemMetadata Metadata {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Interfaces/VideoApp/VideoItemMetadata.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Interfaces.VideoApp\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/videoapp-interface-reference.html#parameters-of-response\n /// \n public class VideoItemMetadata\n {\n public virtual string Title {\n get;\n set;\n }\n\n public virtual string Subtitle {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Json/CamelCasePropertyNamesExceptDictionaryKeysContractResolver.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Serialization;\nusing System;\n\nnamespace AlexaSkillsKit.Json\n{\n public class CamelCasePropertyNamesExceptDictionaryKeysContractResolver : CamelCasePropertyNamesContractResolver\n {\n protected override JsonDictionaryContract CreateDictionaryContract(Type objectType) {\n var contract = base.CreateDictionaryContract(objectType);\n contract.DictionaryKeyResolver = propertyName => propertyName;\n return contract;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Json/Deserializer.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Linq;\nusing System;\nusing System.Collections.Generic;\n\nnamespace AlexaSkillsKit.Json\n{\n public class Deserializer\n {\n private static IDictionary> deserializers = new Dictionary>();\n\n public static void RegisterDeserializer(string name, Func fromJson) {\n deserializers.Add(name, fromJson);\n }\n\n public static T FromJson(JProperty json) {\n if (json == null || !deserializers.ContainsKey(json.Name)) return default(T);\n\n return deserializers[json.Name](json.Value as JObject);\n }\n }\n}\n"
},
{
"path": "AlexaSkillsKit.Lib/Json/SpeechletRequestEnvelope.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing Newtonsoft.Json;\nusing Newtonsoft.Json.Linq;\nusing AlexaSkillsKit.Speechlet;\nusing AlexaSkillsKit.Authentication;\n\nnamespace AlexaSkillsKit.Json\n{\n public class SpeechletRequestEnvelope\n {\n public static SpeechletRequestParser RequestParser { get; } = new SpeechletRequestParser();\n\n static SpeechletRequestEnvelope() {\n RequestParser.AddStandard();\n RequestParser.AddSystem();\n RequestParser.AddAudioPlayer();\n RequestParser.AddPlaybackController();\n RequestParser.AddDisplay();\n }\n\n /// \n /// \n /// \n /// \n /// \n public static SpeechletRequestEnvelope FromJson(string content) {\n if (String.IsNullOrEmpty(content)) {\n throw new SpeechletValidationException(SpeechletRequestValidationResult.NoContent, \"Request content is empty\");\n }\n\n JObject json = JsonConvert.DeserializeObject(content, Sdk.DeserializationSettings);\n return FromJson(json);\n }\n\n\n /// \n /// \n /// \n /// \n /// \n public static SpeechletRequestEnvelope FromJson(JObject json) {\n var version = json.Value(\"version\");\n if (version != null && version != Sdk.VERSION) {\n throw new SpeechletValidationException(SpeechletRequestValidationResult.InvalidVersion, \"Request must conform to 1.0 schema.\");\n }\n\n return new SpeechletRequestEnvelope {\n Version = version,\n Request = RequestParser.Parse(json.Value(\"request\")),\n Session = Session.FromJson(json.Value(\"session\")),\n Context = Context.FromJson(json.Value(\"context\"))\n };\n }\n\n\n public virtual SpeechletRequest Request {\n get;\n set;\n }\n\n public virtual Session Session {\n get;\n set;\n }\n\n public virtual string Version {\n get;\n set;\n }\n\n public virtual Context Context {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Json/SpeechletRequestParser.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Speechlet;\nusing Newtonsoft.Json.Linq;\nusing System;\nusing System.Collections.Generic;\nusing System.Linq;\n\nnamespace AlexaSkillsKit.Json\n{\n public class SpeechletRequestParser\n {\n private IDictionary> resolvers\n = new Dictionary>();\n\n private SpeechletRequest Parse(string type, string subtype, JObject json) {\n if (json == null || !resolvers.ContainsKey(type)) return null;\n\n return resolvers[type](subtype, json);\n }\n\n public SpeechletRequest Parse(JObject json) {\n var requestTypeParts = json?.Value(\"type\")?.Split('.');\n if (requestTypeParts == null) {\n throw new ArgumentException(\"json\");\n }\n\n var requestType = requestTypeParts.Length > 1 ? requestTypeParts[0] : string.Empty;\n var requestSubtype = requestTypeParts.Last();\n\n var request = Parse(requestType, requestSubtype, json);\n if (request == null) {\n throw new ArgumentException(\"json\");\n }\n\n return request;\n }\n\n public void AddInterface(string name, Func resolver) {\n resolvers[name] = resolver;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Json/SpeechletRequestParserExtensions.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Interfaces.AudioPlayer;\nusing AlexaSkillsKit.Interfaces.Display;\nusing AlexaSkillsKit.Speechlet;\n\nnamespace AlexaSkillsKit.Json\n{\n public static class SpeechletRequestParserExtensions\n {\n public static void AddStandard(this SpeechletRequestParser parser) {\n parser.AddInterface(string.Empty, (subtype, json) => {\n switch (subtype) {\n case \"LaunchRequest\":\n return new LaunchRequest(json);\n case \"IntentRequest\":\n return new IntentRequest(json);\n case \"SessionEndedRequest\":\n return new SessionEndedRequest(json);\n }\n return null;\n });\n }\n\n public static void AddSystem(this SpeechletRequestParser parser) {\n parser.AddInterface(SystemRequest.TypeName, (subtype, json) => {\n switch (subtype) {\n case \"ExceptionEncountered\":\n return new SystemExceptionEncounteredRequest(subtype, json);\n }\n return null;\n });\n }\n\n public static void AddAudioPlayer(this SpeechletRequestParser parser) {\n parser.AddInterface(AudioPlayerRequest.TypeName, (subtype, json) => {\n switch (subtype) {\n case \"PlaybackFailed\":\n return new AudioPlayerPlaybackFailedRequest(subtype, json);\n default:\n return new AudioPlayerRequest(subtype, json);\n }\n });\n }\n\n public static void AddPlaybackController(this SpeechletRequestParser parser) {\n parser.AddInterface(PlaybackControllerRequest.TypeName, (subtype, json) => new PlaybackControllerRequest(subtype, json));\n }\n\n public static void AddDisplay(this SpeechletRequestParser parser) {\n parser.AddInterface(DisplayRequest.TypeName, (subtype, json) => new DisplayRequest(subtype, json));\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Json/SpeechletResponseEnvelope.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System.Collections.Generic;\nusing Newtonsoft.Json;\nusing AlexaSkillsKit.Speechlet;\n\nnamespace AlexaSkillsKit.Json\n{\n public class SpeechletResponseEnvelope\n {\n private static JsonSerializerSettings _serializerSettings = new JsonSerializerSettings() {\n NullValueHandling = NullValueHandling.Ignore, \n ContractResolver = new CamelCasePropertyNamesExceptDictionaryKeysContractResolver(),\n Converters = new List { new Newtonsoft.Json.Converters.StringEnumConverter() }\n };\n\n\n /// \n /// \n /// \n /// \n public virtual string ToJson() {\n return JsonConvert.SerializeObject(this, _serializerSettings);\n }\n\n\n public virtual ISpeechletResponse Response {\n get;\n set;\n }\n\n public virtual Dictionary SessionAttributes {\n get;\n set;\n }\n\n public virtual string Version {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Properties/AssemblyInfo.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System.Reflection;\nusing System.Runtime.CompilerServices;\nusing System.Runtime.InteropServices;\n\n// General Information about an assembly is controlled through the following \n// set of attributes. Change these attribute values to modify the information\n// associated with an assembly.\n[assembly: AssemblyTitle(\"AlexaSkillsKit\")]\n[assembly: AssemblyDescription(\"\")]\n[assembly: AssemblyConfiguration(\"\")]\n[assembly: AssemblyCompany(\"\")]\n[assembly: AssemblyProduct(\"AlexaSkillsKit\")]\n[assembly: AssemblyCopyright(\"Copyright © 2018 Stefan Negritoiu (FreeBusy) and contributors\")]\n[assembly: AssemblyTrademark(\"\")]\n[assembly: AssemblyCulture(\"\")]\n\n// Setting ComVisible to false makes the types in this assembly not visible \n// to COM components. If you need to access a type in this assembly from \n// COM, set the ComVisible attribute to true on that type.\n[assembly: ComVisible(false)]\n\n// The following GUID is for the ID of the typelib if this project is exposed to COM\n[assembly: Guid(\"5471ba5b-32c1-486c-851b-dbb8d9c53f13\")]\n\n// Version information for an assembly consists of the following four values:\n//\n// Major Version\n// Minor Version \n// Build Number\n// Revision\n//\n// You can specify all the values or you can default the Build and Revision Numbers \n// by using the '*' as shown below:\n// [assembly: AssemblyVersion(\"1.0.*\")]\n[assembly: AssemblyVersion(\"1.6.0\")]\n[assembly: AssemblyFileVersion(\"1.6.0\")]\n"
},
{
"path": "AlexaSkillsKit.Lib/Sdk.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing Newtonsoft.Json;\n\nnamespace AlexaSkillsKit\n{\n public static class Sdk\n {\n public const string VERSION = \"1.0\";\n public const string CHARACTER_ENCODING = \"UTF-8\";\n public const string ECHO_API_DOMAIN_NAME = \"echo-api.amazon.com\";\n public const string SIGNATURE_CERT_URL_REQUEST_HEADER = \"SignatureCertChainUrl\";\n public const string SIGNATURE_CERT_URL_HOST = \"s3.amazonaws.com\";\n public const string SIGNATURE_CERT_URL_PATH = \"/echo.api/\";\n public const string SIGNATURE_CERT_TYPE = \"X.509\";\n public const string SIGNATURE_REQUEST_HEADER = \"Signature\";\n public const string SIGNATURE_ALGORITHM = \"SHA1withRSA\";\n public const string SIGNATURE_KEY_TYPE = \"RSA\";\n public const int TIMESTAMP_TOLERANCE_SEC = 150;\n\n public static JsonSerializerSettings DeserializationSettings = new JsonSerializerSettings {\n MissingMemberHandling = MissingMemberHandling.Ignore\n };\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Slu/ConfirmationStatusEnum.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Slu\n{\n public enum ConfirmationStatusEnum\n {\n NONE,\n CONFIRMED,\n DENIED\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Slu/Intent.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System.Collections.Generic;\nusing System.Linq;\nusing Newtonsoft.Json.Linq;\nusing System;\n\nnamespace AlexaSkillsKit.Slu\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/request-types-reference.html#intent-object\n /// \n public class Intent\n {\n /// \n /// \n /// \n /// \n /// \n public static Intent FromJson(JObject json) {\n if (json == null) return null;\n\n var slots = json.Value(\"slots\")?.Children()\n .ToDictionary(x => x.Name, x => Slot.FromJson(x.Value as JObject));\n ConfirmationStatusEnum confirmationStatus;\n Enum.TryParse(json.Value(\"confirmationStatus\"), out confirmationStatus);\n\n return new Intent {\n Name = json.Value(\"name\"),\n ConfirmationStatus = confirmationStatus,\n Slots = slots ?? new Dictionary()\n };\n }\n\n public virtual string Name {\n get;\n set;\n }\n\n public virtual ConfirmationStatusEnum ConfirmationStatus {\n get;\n set;\n }\n\n public virtual IDictionary Slots {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Slu/Resolutions.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Linq;\nusing System.Collections.Generic;\nusing System.Linq;\n\nnamespace AlexaSkillsKit.Slu\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/request-types-reference.html#resolutions-object\n /// \n public class Resolutions\n {\n public static Resolutions FromJson(JObject json) {\n if (json == null) return null;\n\n var resolutionsPerAuthority = json.Value(\"resolutionsPerAuthority\")?.Children()\n .Select(x => Slu.ResolutionsPerAuthority.FromJson(x.Value()));\n return new Resolutions {\n ResolutionsPerAuthority = resolutionsPerAuthority\n };\n }\n\n public virtual IEnumerable ResolutionsPerAuthority {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Slu/ResolutionsPerAuthority.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Linq;\nusing System.Collections.Generic;\nusing System.Linq;\n\nnamespace AlexaSkillsKit.Slu\n{\n public class ResolutionsPerAuthority\n {\n public static ResolutionsPerAuthority FromJson(JObject json) {\n if (json == null) return null;\n\n var values = json.Value(\"values\")?.Children()\n .Select(x => ResolutionsPerAuthorityValue.FromJson(x.Value()));\n return new ResolutionsPerAuthority {\n Authority = json.Value(\"authority\"),\n Status = ResolutionsPerAuthorityStatus.FromJson(json.Value(\"status\")),\n Values = values\n };\n }\n\n public virtual string Authority {\n get;\n set;\n }\n\n public virtual ResolutionsPerAuthorityStatus Status {\n get;\n set;\n }\n\n public virtual IEnumerable Values {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Slu/ResolutionsPerAuthorityStatus.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Slu\n{\n public class ResolutionsPerAuthorityStatus\n {\n public static ResolutionsPerAuthorityStatus FromJson(JObject json) {\n if (json == null) return null;\n\n return new ResolutionsPerAuthorityStatus {\n Code = json.Value(\"code\")\n };\n }\n\n public virtual string Code {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Slu/ResolutionsPerAuthorityValue.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Slu\n{\n public class ResolutionsPerAuthorityValue\n {\n public static ResolutionsPerAuthorityValue FromJson(JObject json) {\n if (json == null) return null;\n\n return new ResolutionsPerAuthorityValue {\n Value = ResolutionsPerAuthorityValueValue.FromJson(json.Value(\"value\"))\n };\n }\n\n public virtual ResolutionsPerAuthorityValueValue Value {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Slu/ResolutionsPerAuthorityValueValue.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Slu\n{\n public class ResolutionsPerAuthorityValueValue\n {\n public static ResolutionsPerAuthorityValueValue FromJson(JObject json) {\n if (json == null) return null;\n\n return new ResolutionsPerAuthorityValueValue {\n Name = json.Value(\"name\"),\n Id = json.Value(\"id\")\n };\n }\n\n public virtual string Name {\n get;\n set;\n }\n\n public virtual string Id {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Slu/Slot.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json;\nusing Newtonsoft.Json.Linq;\nusing System;\n\nnamespace AlexaSkillsKit.Slu\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/request-types-reference.html#slot-object\n /// \n public class Slot\n {\n /// \n /// \n /// \n /// \n /// \n public static Slot FromJson(JObject json) {\n if (json == null) return null;\n\n ConfirmationStatusEnum confirmationStatus;\n Enum.TryParse(json.Value(\"confirmationStatus\"), out confirmationStatus);\n return new Slot {\n Name = json.Value(\"name\"),\n Value = json.Value(\"value\"),\n ConfirmationStatus = confirmationStatus,\n Resolutions = Resolutions.FromJson(json.Value(\"resolutions\"))\n };\n }\n \n public virtual string Name {\n get;\n set;\n }\n\n public virtual string Value {\n get;\n set;\n }\n\n public virtual ConfirmationStatusEnum ConfirmationStatus {\n get;\n set;\n }\n\n [JsonIgnore]\n public virtual Resolutions Resolutions {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/Application.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public class Application\n {\n /// \n /// \n /// \n /// \n /// \n public static Application FromJson(JObject json) {\n return new Application {\n Id = json.Value(\"applicationId\")\n };\n }\n\n public virtual string Id {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/Cause.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/audioplayer-interface-reference.html#system-exceptionencountered\n /// \n public class Cause\n {\n public static Cause FromJson(JObject json) {\n if (json == null) return null;\n\n return new Cause {\n RequestId = json.Value(\"requestId\")\n };\n }\n\n public string RequestId {\n get;\n private set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/Context.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Interfaces.AudioPlayer;\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/request-and-response-json-reference.html#context-object\n /// \n public class Context\n {\n public static Context FromJson(JObject json) {\n if (json == null) return null;\n\n return new Context {\n System = SystemState.FromJson(json.Value(\"System\")),\n AudioPlayer = AudioPlayerState.FromJson(json.Value(\"AudioPlayer\"))\n };\n }\n\n public SystemState System {\n get;\n private set;\n }\n\n public AudioPlayerState AudioPlayer {\n get;\n private set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/Device.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/request-and-response-json-reference.html#system-object\n /// \n public class Device\n {\n public static Device FromJson(JObject json) {\n if (json == null) return null;\n\n return new Device {\n DeviceId = json.Value(\"deviceId\"),\n SupportedInterfaces = SupportedInterfaces.FromJson(json.Value(\"supportedInterfaces\"))\n };\n }\n\n public string DeviceId {\n get;\n private set;\n }\n\n public SupportedInterfaces SupportedInterfaces {\n get;\n private set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/Directive.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Speechlet\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/request-and-response-json-reference.html#response-object\n /// \n public class Directive\n {\n public Directive(string type) {\n Type = type;\n }\n\n public virtual string Type {\n get;\n private set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/Error.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Linq;\nusing System;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/audioplayer-interface-reference.html#playbackfailed\n /// https://developer.amazon.com/docs/custom-skills/audioplayer-interface-reference.html#system-exceptionencountered\n /// \n public class Error\n {\n public static Error FromJson(JObject json) {\n if (json == null) return null;\n\n TypeEnum type = TypeEnum.NONE;\n Enum.TryParse(json.Value(\"type\"), out type);\n return new Error {\n Type = type,\n Message = json.Value(\"message\")\n };\n }\n\n public TypeEnum Type {\n get;\n private set;\n }\n\n public string Message {\n get;\n private set;\n }\n\n public enum TypeEnum\n {\n NONE = 0, // default in case parsing fails\n INVALID_RESPONSE,\n DEVICE_COMMUNICATION_ERROR,\n INTERNAL_ERROR,\n MEDIA_ERROR_UNKNOWN,\n MEDIA_ERROR_INVALID_REQUEST,\n MEDIA_ERROR_SERVICE_UNAVAILABLE,\n MEDIA_ERROR_INTERNAL_SERVER_ERROR,\n MEDIA_ERROR_INTERNAL_DEVICE_ERROR\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/ExtendedSpeechletRequest.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/request-and-response-json-reference.html#request-body-parameters\n /// https://developer.amazon.com/docs/custom-skills/audioplayer-interface-reference.html#requests\n /// https://developer.amazon.com/docs/custom-skills/playback-controller-interface-reference.html#requests\n /// \n public class ExtendedSpeechletRequest : SpeechletRequest\n {\n public ExtendedSpeechletRequest(string type, string subtype, JObject json) : base(json) {\n Type = type;\n Subtype = subtype;\n }\n\n public string Type {\n get;\n private set;\n }\n\n public string Subtype {\n get;\n private set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/ISpeechlet.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n [Obsolete(\"Does not support context object. Implement ISpeechletWithContext instead\")]\n public interface ISpeechlet : ISpeechletBase\n {\n SpeechletResponse OnIntent(IntentRequest intentRequest, Session session);\n SpeechletResponse OnLaunch(LaunchRequest launchRequest, Session session);\n void OnSessionStarted(SessionStartedRequest sessionStartedRequest, Session session);\n void OnSessionEnded(SessionEndedRequest sessionEndedRequest, Session session);\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/ISpeechletAsync.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing System.Threading.Tasks;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n [Obsolete(\"Does not support context object. Implement ISpeechletWithContextAsync instead\")]\n public interface ISpeechletAsync : ISpeechletBase\n {\n Task OnIntentAsync(IntentRequest intentRequest, Session session);\n Task OnLaunchAsync(LaunchRequest launchRequest, Session session);\n Task OnSessionStartedAsync(SessionStartedRequest sessionStartedRequest, Session session);\n Task OnSessionEndedAsync(SessionEndedRequest sessionEndedRequest, Session session);\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/ISpeechletBase.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing AlexaSkillsKit.Authentication;\nusing AlexaSkillsKit.Json;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public interface ISpeechletBase\n {\n bool OnRequestValidation(SpeechletRequestValidationResult result, DateTime referenceTimeUtc, SpeechletRequestEnvelope requestEnvelope);\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/ISpeechletInterface.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public interface ISpeechletInterface\n {\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/ISpeechletInterfaceState.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public interface ISpeechletInterfaceState\n {\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/ISpeechletResponse.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public interface ISpeechletResponse\n {\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/ISpeechletWithContext.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public interface ISpeechletWithContext\n {\n SpeechletResponse OnIntent(IntentRequest intentRequest, Session session, Context context);\n SpeechletResponse OnLaunch(LaunchRequest launchRequest, Session session, Context context);\n void OnSessionStarted(SessionStartedRequest sessionStartedRequest, Session session, Context context);\n void OnSessionEnded(SessionEndedRequest sessionEndedRequest, Session session, Context context);\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/ISpeechletWithContextAsync.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System.Threading.Tasks;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public interface ISpeechletWithContextAsync\n {\n Task OnIntentAsync(IntentRequest intentRequest, Session session, Context context);\n Task OnLaunchAsync(LaunchRequest launchRequest, Session session, Context context);\n Task OnSessionStartedAsync(SessionStartedRequest sessionStartedRequest, Session session, Context context);\n Task OnSessionEndedAsync(SessionEndedRequest sessionEndedRequest, Session session, Context context);\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/IntentRequest.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Slu;\nusing Newtonsoft.Json.Linq;\nusing System;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public class IntentRequest : SpeechletRequest\n {\n public IntentRequest(JObject json) : base(json) {\n Intent = Intent.FromJson(json.Value(\"intent\"));\n\n DialogStateEnum dialogState = DialogStateEnum.UNKNOWN;\n Enum.TryParse(json.Value(\"dialogState\"), out dialogState);\n DialogState = dialogState;\n }\n\n public virtual Intent Intent {\n get;\n private set;\n }\n\n public virtual DialogStateEnum DialogState {\n get;\n private set;\n }\n\n public enum DialogStateEnum\n {\n UNKNOWN = 0, // default in case parsing fails\n STARTED,\n IN_PROGRESS,\n COMPLETED\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/LaunchRequest.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public class LaunchRequest : SpeechletRequest\n {\n public LaunchRequest(JObject json) : base(json) {\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/Person.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public class Person\n {\n /// \n /// \n /// \n /// \n /// \n public static Person FromJson(JObject json) {\n if (json == null) return null;\n\n return new Person{\n PersonId = json.Value(\"personId\"),\n AccessToken = json.Value(\"accessToken\")\n };\n }\n\n public string PersonId{\n get;\n private set;\n }\n\n public virtual string AccessToken{\n get;\n set;\n }\n\n }\n}\n"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/PlaybackState.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Linq;\nusing System;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/audioplayer-interface-reference.html#playbackfailed\n /// \n public class PlaybackState\n {\n public static PlaybackState FromJson(JObject json) {\n if (json == null) return null;\n\n PlayerActivityEnum playerActivity = PlayerActivityEnum.NONE;\n Enum.TryParse(json.Value(\"playerActivity\"), out playerActivity);\n return new PlaybackState {\n Token = json.Value(\"token\"),\n OffsetInMilliseconds = json.Value(\"offsetInMilliseconds\"),\n PlayerActivity = playerActivity\n };\n }\n\n public string Token {\n get;\n private set;\n }\n\n public long? OffsetInMilliseconds {\n get;\n private set;\n }\n\n public PlayerActivityEnum PlayerActivity {\n get;\n private set;\n }\n\n public enum PlayerActivityEnum\n {\n NONE = 0, // default in case parsing fails\n PLAYING,\n PAUSED,\n FINISHED,\n BUFFER_UNDERRUN,\n IDLE\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/Session.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing System.Collections.Generic;\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public class Session\n {\n public const string INTENT_SEQUENCE = \"intentSequence\";\n public const string SEPARATOR = \";\";\n\n /// \n /// \n /// \n /// \n /// \n public static Session FromJson(JObject json) {\n if (json == null) return null;\n\n var attributes = new Dictionary();\n var jsonAttributes = json.Value(\"attributes\");\n if (jsonAttributes != null) {\n foreach (var attrib in jsonAttributes.Children()) {\n attributes.Add(attrib.Value().Name, attrib.Value().Value.ToString());\n }\n }\n\n return new Session {\n SessionId = json.Value(\"sessionId\"),\n IsNew = json.Value(\"new\"),\n User = User.FromJson(json.Value(\"user\")),\n Application = Application.FromJson(json.Value(\"application\")),\n Attributes = attributes\n };\n }\n\n public virtual string SessionId {\n get;\n set;\n }\n\n public virtual bool IsNew {\n get;\n set;\n }\n\n public virtual Application Application {\n get;\n set;\n }\n\n public virtual User User {\n get;\n set;\n }\n\n public virtual Dictionary Attributes {\n get;\n set;\n }\n\n public virtual string[] IntentSequence {\n get {\n return !Attributes.ContainsKey(INTENT_SEQUENCE) || String.IsNullOrEmpty(Attributes[INTENT_SEQUENCE]) ?\n new string[0] : \n Attributes[INTENT_SEQUENCE].Split(\n new string[1] { SEPARATOR }, StringSplitOptions.RemoveEmptyEntries);\n }\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/SessionEndedRequest.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Linq;\nusing System;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public class SessionEndedRequest : SpeechletRequest\n {\n public SessionEndedRequest(JObject json) : base(json) {\n\n ReasonEnum reason = ReasonEnum.UNKNOWN;\n Enum.TryParse(json.Value(\"reason\"), out reason);\n Reason = reason;\n Error = Error.FromJson(json.Value(\"error\"));\n }\n\n public virtual ReasonEnum Reason {\n get;\n private set;\n }\n\n public Error Error {\n get;\n private set;\n }\n\n public enum ReasonEnum\n {\n NONE = 0, // default in case parsing fails (backwards compatibility)\n UNKNOWN = 0, // default in case parsing fails\n ERROR,\n USER_INITIATED,\n EXCEEDED_MAX_REPROMPTS,\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/SessionStartedRequest.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public class SessionStartedRequest : SpeechletRequest\n {\n public SessionStartedRequest(SpeechletRequest other) : base(other) {\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/Speechlet.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n [Obsolete(\"Does not support context object. Derive from SpeechletBase instead and implement ISpeechletWithContext\")]\n public abstract class Speechlet : SpeechletBase, ISpeechlet\n {\n public abstract SpeechletResponse OnIntent(IntentRequest intentRequest, Session session);\n public abstract SpeechletResponse OnLaunch(LaunchRequest launchRequest, Session session);\n public abstract void OnSessionStarted(SessionStartedRequest sessionStartedRequest, Session session);\n public abstract void OnSessionEnded(SessionEndedRequest sessionEndedRequest, Session session);\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/SpeechletAsync.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing System.Threading.Tasks;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n [Obsolete(\"Does not support context object. Derive from SpeechletBase instead and implement ISpeechletWithContextAsync\")]\n public abstract class SpeechletAsync : SpeechletBase, ISpeechletAsync\n {\n public abstract Task OnIntentAsync(IntentRequest intentRequest, Session session);\n public abstract Task OnLaunchAsync(LaunchRequest launchRequest, Session session);\n public abstract Task OnSessionEndedAsync(SessionEndedRequest sessionEndedRequest, Session session);\n public abstract Task OnSessionStartedAsync(SessionStartedRequest sessionStartedRequest, Session session);\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/SpeechletBase.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Authentication;\nusing AlexaSkillsKit.Json;\nusing Newtonsoft.Json.Linq;\nusing System;\nusing System.Net.Http;\nusing System.Threading.Tasks;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public class SpeechletBase : ISpeechletBase\n {\n public SpeechletService Service { get; }\n\n protected SpeechletBase() {\n Service = new SpeechletService(this);\n }\n\n\n /// \n /// Processes Alexa request AND validates request signature\n /// \n /// \n /// \n public HttpResponseMessage GetResponse(HttpRequestMessage httpRequest) {\n return AsyncHelpers.RunSync(async () => await Service.GetResponseAsync(httpRequest));\n }\n\n public async Task GetResponseAsync(HttpRequestMessage httpRequest) {\n return await Service.GetResponseAsync(httpRequest);\n }\n\n\n /// \n /// Processes Alexa request but does NOT validate request signature \n /// \n /// \n /// \n public string ProcessRequest(string requestContent) {\n return AsyncHelpers.RunSync(async () => await ProcessRequestAsync(requestContent));\n }\n\n public async Task ProcessRequestAsync(string requestContent) {\n var requestEnvelope = SpeechletRequestEnvelope.FromJson(requestContent);\n return (await Service.ProcessRequestAsync(requestEnvelope))?.ToJson();\n }\n\n\n /// \n /// Processes Alexa request but does NOT validate request signature \n /// \n /// \n /// \n public virtual string ProcessRequest(JObject requestJson) {\n return AsyncHelpers.RunSync(async () => await ProcessRequestAsync(requestJson));\n }\n\n public async Task ProcessRequestAsync(JObject requestJson) {\n var requestEnvelope = SpeechletRequestEnvelope.FromJson(requestJson);\n return (await Service.ProcessRequestAsync(requestEnvelope))?.ToJson();\n }\n\n\n /// \n /// Opportunity to set policy for handling requests with invalid signatures and/or timestamps\n /// \n /// true if request processing should continue, otherwise false\n public virtual bool OnRequestValidation(\n SpeechletRequestValidationResult result, DateTime referenceTimeUtc, SpeechletRequestEnvelope requestEnvelope) {\n \n return result == SpeechletRequestValidationResult.OK;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/SpeechletException.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public class SpeechletException : Exception\n {\n public SpeechletException() : base() {\n\n }\n\n public SpeechletException(string message) : base(message) {\n\n }\n\n public SpeechletException(string message, Exception cause) : base(message, cause) {\n\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/SpeechletRequest.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Helpers;\nusing Newtonsoft.Json.Linq;\nusing System;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public abstract class SpeechletRequest\n {\n protected SpeechletRequest(JObject json) {\n RequestId = json.Value(\"requestId\");\n Timestamp = DateTimeHelpers.FromAlexaTimestamp(json);\n Locale = json.Value(\"locale\");\n }\n\n protected SpeechletRequest(SpeechletRequest other) {\n RequestId = other.RequestId;\n Timestamp = other.Timestamp;\n Locale = other.Locale;\n }\n\n public string RequestId {\n get;\n private set;\n }\n\n public DateTime Timestamp {\n get;\n private set;\n }\n\n public string Locale {\n get;\n private set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/SpeechletResponse.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.UI;\nusing System.Collections.Generic;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/request-and-response-json-reference.html#response-object\n /// \n public class SpeechletResponse : ISpeechletResponse\n {\n /// \n /// Set default ShouldEndSession value to false for the sake of backwards compatibility\n /// \n public SpeechletResponse() {\n ShouldEndSession = false;\n }\n\n public virtual Card Card {\n get;\n set;\n }\n\n public virtual IEnumerable Directives {\n get;\n set;\n }\n\n public virtual OutputSpeech OutputSpeech {\n get;\n set;\n }\n\n public virtual Reprompt Reprompt {\n get;\n set;\n }\n\n public virtual bool? ShouldEndSession {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/SpeechletService.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Authentication;\nusing AlexaSkillsKit.Interfaces.AudioPlayer;\nusing AlexaSkillsKit.Interfaces.Display;\nusing AlexaSkillsKit.Json;\nusing Newtonsoft.Json;\nusing System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Net;\nusing System.Net.Http;\nusing System.Text;\nusing System.Threading.Tasks;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public class SpeechletService\n {\n private ISpeechletBase speechlet;\n\n private IDictionary>> handlers\n = new Dictionary>>();\n\n public string ApplicationId { get; set; }\n\n\n public void AddHandler(string type, Func> handler) where T : SpeechletRequest {\n handlers[type] = (request, context) => handler(request as T, context);\n }\n\n\n public SpeechletService(ISpeechletBase speechlet) {\n this.speechlet = speechlet;\n\n if (speechlet is IAudioPlayerSpeechletAsync || speechlet is IAudioPlayerSpeechlet) {\n AddHandler(AudioPlayerRequest.TypeName, async (request, context) => {\n return (speechlet as IAudioPlayerSpeechlet)?.OnAudioPlayer(request, context) ??\n await (speechlet as IAudioPlayerSpeechletAsync).OnAudioPlayerAsync(request, context);\n });\n\n AddHandler(PlaybackControllerRequest.TypeName, async (request, context) => {\n return (speechlet as IAudioPlayerSpeechlet)?.OnPlaybackController(request, context) ??\n await (speechlet as IAudioPlayerSpeechletAsync).OnPlaybackControllerAsync(request, context);\n });\n\n AddHandler(SystemRequest.TypeName, async (request, context) => {\n (speechlet as IAudioPlayerSpeechlet)?.OnSystemExceptionEncountered(request, context);\n await (speechlet as IAudioPlayerSpeechletAsync).OnSystemExceptionEncounteredAsync(request, context);\n return null;\n });\n }\n\n if (speechlet is IDisplaySpeechletAsync) {\n AddHandler(DisplayRequest.TypeName, async (request, context) => {\n return (speechlet as IDisplaySpeechlet)?.OnDisplay(request, context) ??\n await (speechlet as IDisplaySpeechletAsync).OnDisplayAsync(request, context);\n });\n }\n }\n\n\n /// \n /// Processes Alexa request AND validates request signature\n /// \n /// \n /// \n public async Task GetResponseAsync(HttpRequestMessage httpRequest) {\n string chainUrl = null;\n if (httpRequest.Headers.Contains(Sdk.SIGNATURE_CERT_URL_REQUEST_HEADER)) {\n chainUrl = httpRequest.Headers.GetValues(Sdk.SIGNATURE_CERT_URL_REQUEST_HEADER).FirstOrDefault(x => !string.IsNullOrEmpty(x));\n }\n\n string signature = null;\n if (httpRequest.Headers.Contains(Sdk.SIGNATURE_REQUEST_HEADER)) {\n signature = httpRequest.Headers.GetValues(Sdk.SIGNATURE_REQUEST_HEADER).FirstOrDefault(x => !string.IsNullOrEmpty(x));\n }\n\n var content = await httpRequest.Content.ReadAsStringAsync();\n\n try {\n var alexaRequest = await GetRequestAsync(content, chainUrl, signature);\n var alexaResponse = await ProcessRequestAsync(alexaRequest);\n var json = alexaResponse?.ToJson();\n\n return (json == null) ?\n new HttpResponseMessage(HttpStatusCode.InternalServerError) :\n new HttpResponseMessage(HttpStatusCode.OK) {\n Content = new StringContent(json, Encoding.UTF8, \"application/json\")\n };\n }\n catch (SpeechletValidationException ex) {\n return new HttpResponseMessage(HttpStatusCode.BadRequest) {\n ReasonPhrase = ex.ValidationResult.ToString()\n };\n }\n }\n\n\n public async Task GetRequestAsync(string content, string chainUrl, string signature) {\n var validationResult = SpeechletRequestValidationResult.OK;\n\n if (string.IsNullOrEmpty(chainUrl)) {\n validationResult |= SpeechletRequestValidationResult.NoCertHeader;\n }\n\n if (string.IsNullOrEmpty(signature)) {\n validationResult |= SpeechletRequestValidationResult.NoSignatureHeader;\n }\n\n // attempt to verify signature only if we were able to locate certificate and signature headers\n if (validationResult == SpeechletRequestValidationResult.OK) {\n var alexaBytes = Encoding.UTF8.GetBytes(content);\n\n if (!await SpeechletRequestSignatureVerifier.VerifyRequestSignatureAsync(alexaBytes, signature, chainUrl)) {\n validationResult |= SpeechletRequestValidationResult.InvalidSignature;\n }\n }\n\n SpeechletRequestEnvelope result = null;\n try {\n result = SpeechletRequestEnvelope.FromJson(content);\n }\n catch (SpeechletValidationException ex) {\n validationResult |= ex.ValidationResult;\n }\n catch (Exception ex)\n when (ex is JsonReaderException || ex is InvalidCastException || ex is FormatException) {\n validationResult |= SpeechletRequestValidationResult.InvalidJson;\n }\n\n var success = false;\n\n // attempt to verify timestamp only if we were able to parse request body\n if (result != null) {\n var now = DateTime.UtcNow; // reference time for this request\n\n if (!SpeechletRequestTimestampVerifier.VerifyRequestTimestamp(result, now)) {\n validationResult |= SpeechletRequestValidationResult.InvalidTimestamp;\n }\n\n if (!string.IsNullOrEmpty(ApplicationId) && result.Context.System.Application.Id != ApplicationId) {\n validationResult |= SpeechletRequestValidationResult.InvalidApplicationId;\n }\n\n success = speechlet?.OnRequestValidation(validationResult, now, result) ?? (validationResult == SpeechletRequestValidationResult.OK);\n }\n\n if (!success) {\n throw new SpeechletValidationException(validationResult);\n }\n\n return result;\n }\n\n\n /// \n /// \n /// \n /// \n /// \n public async Task ProcessRequestAsync(SpeechletRequestEnvelope requestEnvelope) {\n var session = requestEnvelope.Session;\n var context = requestEnvelope.Context;\n var request = requestEnvelope.Request;\n\n var response = !(request is ExtendedSpeechletRequest) ?\n await HandleStandardRequestAsync(request, session, context) :\n await HandleExtendedRequestAsync(request as ExtendedSpeechletRequest, context);\n\n if (response == null) {\n response = new SpeechletResponse();\n }\n\n var responseEnvelope = new SpeechletResponseEnvelope {\n Version = requestEnvelope.Version,\n Response = response,\n SessionAttributes = session?.Attributes\n };\n\n return responseEnvelope;\n }\n\n\n /// \n /// \n /// \n private async Task HandleStandardRequestAsync(\n SpeechletRequest request, Session session, Context context) {\n \n #pragma warning disable 612, 618\n if (session != null) {\n // Do session management prior to calling OnSessionStarted and OnIntentAsync \n // to allow dev to change session values if behavior is not desired\n DoSessionManagement(request as IntentRequest, session);\n\n if (session.IsNew) {\n var sessionStartedRequest = new SessionStartedRequest(request);\n if (speechlet is ISpeechletWithContext)\n (speechlet as ISpeechletWithContext).OnSessionStarted(sessionStartedRequest, session, context);\n else if (speechlet is ISpeechletWithContextAsync)\n await (speechlet as ISpeechletWithContextAsync).OnSessionStartedAsync(sessionStartedRequest, session, context);\n else if (speechlet is ISpeechlet)\n (speechlet as ISpeechlet).OnSessionStarted(sessionStartedRequest, session);\n else if (speechlet is ISpeechletAsync)\n await (speechlet as ISpeechletAsync).OnSessionStartedAsync(sessionStartedRequest, session);\n }\n }\n #pragma warning restore 612, 618\n\n #pragma warning disable 612, 618\n if (request is LaunchRequest) {\n // process launch request\n if (speechlet is ISpeechletWithContext)\n return (speechlet as ISpeechletWithContext).OnLaunch(request as LaunchRequest, session, context);\n else if (speechlet is ISpeechletWithContextAsync)\n return await (speechlet as ISpeechletWithContextAsync).OnLaunchAsync(request as LaunchRequest, session, context);\n else if (speechlet is ISpeechlet)\n return (speechlet as ISpeechlet).OnLaunch(request as LaunchRequest, session);\n else if (speechlet is ISpeechletAsync)\n return await (speechlet as ISpeechletAsync).OnLaunchAsync(request as LaunchRequest, session);\n }\n else if (request is IntentRequest) {\n // process intent request\n if (speechlet is ISpeechletWithContext)\n return (speechlet as ISpeechletWithContext).OnIntent(request as IntentRequest, session, context);\n else if (speechlet is ISpeechletWithContextAsync)\n return await (speechlet as ISpeechletWithContextAsync).OnIntentAsync(request as IntentRequest, session, context);\n else if (speechlet is ISpeechlet)\n return (speechlet as ISpeechlet).OnIntent(request as IntentRequest, session);\n else if (speechlet is ISpeechletAsync)\n return await (speechlet as ISpeechletAsync).OnIntentAsync(request as IntentRequest, session);\n }\n else if (request is SessionEndedRequest) {\n // process session ended request\n if (speechlet is ISpeechletWithContext)\n (speechlet as ISpeechletWithContext).OnSessionEnded(request as SessionEndedRequest, session, context);\n else if (speechlet is ISpeechletWithContextAsync)\n await (speechlet as ISpeechletWithContextAsync).OnSessionEndedAsync(request as SessionEndedRequest, session, context);\n else if (speechlet is ISpeechlet)\n (speechlet as ISpeechlet).OnSessionEnded(request as SessionEndedRequest, session);\n else if (speechlet is ISpeechletAsync)\n await (speechlet as ISpeechletAsync).OnSessionEndedAsync(request as SessionEndedRequest, session);\n }\n #pragma warning restore 612, 618\n\n return null;\n }\n\n\n private async Task HandleExtendedRequestAsync(ExtendedSpeechletRequest request, Context context) {\n return handlers.ContainsKey(request.Type) ? (await handlers[request.Type].Invoke(request, context)) : null;\n }\n\n\n /// \n /// \n /// \n private void DoSessionManagement(IntentRequest request, Session session) {\n if (request == null) return;\n\n if (session.Attributes == null) {\n session.Attributes = new Dictionary();\n }\n\n if (session.IsNew) {\n session.Attributes[Session.INTENT_SEQUENCE] = request.Intent.Name;\n }\n else {\n // if the session was started as a result of a launch request \n // a first intent isn't yet set, so set it to the current intent\n if (!session.Attributes.ContainsKey(Session.INTENT_SEQUENCE)) {\n session.Attributes[Session.INTENT_SEQUENCE] = request.Intent.Name;\n }\n else {\n session.Attributes[Session.INTENT_SEQUENCE] += Session.SEPARATOR + request.Intent.Name;\n }\n }\n\n // Auto-session management: copy all slot values from current intent into session\n foreach (var slot in request.Intent.Slots.Values) {\n session.Attributes[slot.Name] = slot.Value;\n }\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/SpeechletValidationException.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing AlexaSkillsKit.Authentication;\nusing System;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public class SpeechletValidationException : SpeechletException\n {\n public SpeechletRequestValidationResult ValidationResult { get; }\n\n public SpeechletValidationException(SpeechletRequestValidationResult validationResult) : base() {\n ValidationResult = validationResult;\n }\n\n public SpeechletValidationException(SpeechletRequestValidationResult validationResult, string message) : base(message) {\n ValidationResult = validationResult;\n }\n\n public SpeechletValidationException(SpeechletRequestValidationResult validationResult, string message, Exception cause) : base(message, cause) {\n ValidationResult = validationResult;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/SupportedInterfaces.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System.Collections.Generic;\nusing Newtonsoft.Json.Linq;\nusing System.Linq;\nusing AlexaSkillsKit.Interfaces.Display;\nusing AlexaSkillsKit.Interfaces.AudioPlayer;\nusing AlexaSkillsKit.Json;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/request-and-response-json-reference.html#system-object\n /// \n public class SupportedInterfaces : Dictionary\n {\n /// \n /// Register supported interfaces for deserialization\n /// \n static SupportedInterfaces() {\n Deserializer.RegisterDeserializer(\"Display\", DisplayInterface.FromJson);\n Deserializer.RegisterDeserializer(\"AudioPlayer\", AudioPlayerInterface.FromJson);\n }\n\n public static SupportedInterfaces FromJson(JObject json) {\n if (json == null) return null;\n\n var dictionary = json.Children()\n .ToDictionary(x => x.Name, x => Deserializer.FromJson(x));\n\n return new SupportedInterfaces(dictionary);\n }\n\n private SupportedInterfaces(IDictionary dictionary) : base(dictionary) { }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/SystemExceptionEncounteredRequest.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/audioplayer-interface-reference.html#system-exceptionencountered\n /// \n public class SystemExceptionEncounteredRequest : SystemRequest\n {\n public SystemExceptionEncounteredRequest(string subtype, JObject json) : base(subtype, json) {\n Error = Error.FromJson(json.Value(\"error\"));\n Cause = Cause.FromJson(json.Value(\"cause\"));\n }\n\n public Error Error {\n get;\n private set;\n }\n\n public Cause Cause {\n get;\n private set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/SystemRequest.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/audioplayer-interface-reference.html#system-exceptionencountered\n /// \n public class SystemRequest : ExtendedSpeechletRequest\n {\n public static readonly string TypeName = \"System\";\n\n public SystemRequest(string subtype, JObject json) : base(TypeName, subtype, json) {\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/SystemState.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/request-and-response-json-reference.html#system-object\n /// \n public class SystemState : ISpeechletInterfaceState\n {\n public static SystemState FromJson(JObject json) {\n if (json == null) return null;\n\n return new SystemState {\n Application = Application.FromJson(json.Value(\"application\")),\n User = User.FromJson(json.Value(\"user\")),\n Device = Device.FromJson(json.Value(\"device\")),\n Person = Person.FromJson(json.Value(\"person\")),\n ApiEndpoint = json.Value(\"apiEndpoint\"),\n ApiAccessToken = json.Value(\"apiAccessToken\")\n };\n }\n\n public Application Application {\n get;\n private set;\n }\n\n public User User {\n get;\n private set;\n }\n\n public Person Person {\n get;\n private set;\n }\n\n public Device Device {\n get;\n private set;\n }\n\n public string ApiEndpoint {\n get;\n private set;\n }\n\n public string ApiAccessToken {\n get;\n private set;\n }\n }\n}\n"
},
{
"path": "AlexaSkillsKit.Lib/Speechlet/User.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing Newtonsoft.Json.Linq;\n\nnamespace AlexaSkillsKit.Speechlet\n{\n public class User\n {\n /// \n /// \n /// \n /// \n /// \n public static User FromJson(JObject json) {\n return new User {\n Id = json.Value(\"userId\"),\n AccessToken = json.Value(\"accessToken\")\n };\n }\n\n public virtual string Id {\n get;\n set;\n }\n\n public virtual string AccessToken {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/UI/AskForPermissionsConsentCard.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System.Collections.Generic;\n\nnamespace AlexaSkillsKit.UI\n{\n /// \n /// https://developer.amazon.com/docs/custom-skills/device-address-api.html#permissions-card\n /// \n public class AskForPermissionsConsentCard : Card\n {\n public override string Type {\n get { return \"AskForPermissionsConsent\"; }\n }\n\n public virtual IEnumerable Permissions {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/UI/Card.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\n\nnamespace AlexaSkillsKit.UI\n{\n public abstract class Card\n {\n public abstract string Type {\n get;\n } \n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/UI/Image.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing System.Collections.Generic;\n\nnamespace AlexaSkillsKit.UI\n{\n public class Image\n {\n public virtual string SmallImageUrl {\n get;\n set;\n }\n\n public virtual string LargeImageUrl {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/UI/LinkAccountCard.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing System.Collections.Generic;\n\nnamespace AlexaSkillsKit.UI\n{\n public class LinkAccountCard : Card\n {\n public override string Type {\n get { return \"LinkAccount\"; }\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/UI/OutputSpeech.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing System.Collections.Generic;\n\nnamespace AlexaSkillsKit.UI\n{\n public abstract class OutputSpeech\n {\n public abstract string Type {\n get;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/UI/PlainTextOutputSpeech.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.UI\n{\n public class PlainTextOutputSpeech : OutputSpeech\n {\n public override string Type {\n get { return \"PlainText\"; }\n }\n\n public virtual string Text {\n get;\n set;\n }\n \n public static implicit operator PlainTextOutputSpeech(string spokenText)\n {\n return new PlainTextOutputSpeech()\n {\n Text = spokenText\n };\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/UI/Reprompt.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing System.Collections.Generic;\n\nnamespace AlexaSkillsKit.UI\n{\n public class Reprompt\n {\n public OutputSpeech OutputSpeech {\n get;\n set;\n }\n }\n}\n"
},
{
"path": "AlexaSkillsKit.Lib/UI/SimpleCard.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.UI\n{\n public class SimpleCard : Card\n {\n public override string Type {\n get { return \"Simple\"; }\n }\n\n public virtual string Title {\n get;\n set;\n }\n\n public virtual string Content {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/UI/SsmlOutputSpeech.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nusing System;\nusing System.Collections.Generic;\n\nnamespace AlexaSkillsKit.UI\n{\n public class SsmlOutputSpeech : OutputSpeech\n {\n public override string Type {\n get { return \"SSML\"; }\n }\n\n public virtual string Ssml {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/UI/StandardCard.cs",
"content": "// Copyright 2018 Stefan Negritoiu (FreeBusy) and contributors. See LICENSE file for more information.\n\nnamespace AlexaSkillsKit.UI\n{\n public class StandardCard : Card\n {\n public override string Type {\n get { return \"Standard\"; }\n }\n\n public virtual string Title {\n get;\n set;\n }\n\n public virtual string Text {\n get;\n set;\n }\n\n public virtual Image Image {\n get;\n set;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Lib/app.config",
"content": "\n\n \n \n \n \n \n \n \n \n"
},
{
"path": "AlexaSkillsKit.Lib/packages.config",
"content": "\n\n \n \n \n"
},
{
"path": "AlexaSkillsKit.Sample/AlexaSkillsKit.Sample.csproj",
"content": "\n\n \n \n Debug\n AnyCPU\n \n \n 2.0\n {9FDEF793-5832-4D37-B0D5-62C55AB1C12E}\n {349c5851-65df-11da-9384-00065b846f21};{fae04ec0-301f-11d3-bf4b-00c04f79efbc}\n Library\n Properties\n Sample\n Sample\n v4.5\n false\n true\n \n \n \n \n ..\\\n true\n \n \n \n true\n full\n false\n bin\\\n DEBUG;TRACE\n prompt\n 4\n \n \n pdbonly\n true\n bin\\\n TRACE\n prompt\n 4\n \n \n \n ..\\packages\\Antlr.3.5.0.2\\lib\\Antlr3.Runtime.dll\n True\n \n \n ..\\packages\\EntityFramework.6.1.3\\lib\\net45\\EntityFramework.dll\n True\n \n \n ..\\packages\\EntityFramework.6.1.3\\lib\\net45\\EntityFramework.SqlServer.dll\n True\n \n \n ..\\packages\\Microsoft.AspNet.Identity.Core.2.2.1\\lib\\net45\\Microsoft.AspNet.Identity.Core.dll\n True\n \n \n ..\\packages\\Microsoft.AspNet.Identity.EntityFramework.2.2.1\\lib\\net45\\Microsoft.AspNet.Identity.EntityFramework.dll\n True\n \n \n ..\\packages\\Microsoft.AspNet.Identity.Owin.2.2.1\\lib\\net45\\Microsoft.AspNet.Identity.Owin.dll\n True\n \n \n \n ..\\packages\\Microsoft.Owin.3.0.1\\lib\\net45\\Microsoft.Owin.dll\n True\n \n \n ..\\packages\\Microsoft.Owin.Host.SystemWeb.3.0.1\\lib\\net45\\Microsoft.Owin.Host.SystemWeb.dll\n True\n \n \n ..\\packages\\Microsoft.Owin.Security.3.0.1\\lib\\net45\\Microsoft.Owin.Security.dll\n True\n \n \n ..\\packages\\Microsoft.Owin.Security.Cookies.3.0.1\\lib\\net45\\Microsoft.Owin.Security.Cookies.dll\n True\n \n \n ..\\packages\\Microsoft.Owin.Security.Facebook.3.0.1\\lib\\net45\\Microsoft.Owin.Security.Facebook.dll\n True\n \n \n ..\\packages\\Microsoft.Owin.Security.Google.3.0.1\\lib\\net45\\Microsoft.Owin.Security.Google.dll\n True\n \n \n ..\\packages\\Microsoft.Owin.Security.MicrosoftAccount.3.0.1\\lib\\net45\\Microsoft.Owin.Security.MicrosoftAccount.dll\n True\n \n \n ..\\packages\\Microsoft.Owin.Security.OAuth.3.0.1\\lib\\net45\\Microsoft.Owin.Security.OAuth.dll\n True\n \n \n ..\\packages\\Microsoft.Owin.Security.Twitter.3.0.1\\lib\\net45\\Microsoft.Owin.Security.Twitter.dll\n True\n \n \n False\n ..\\packages\\Microsoft.Web.Infrastructure.1.0.0.0\\lib\\net40\\Microsoft.Web.Infrastructure.dll\n \n \n ..\\packages\\Newtonsoft.Json.7.0.1\\lib\\net45\\Newtonsoft.Json.dll\n True\n \n \n ..\\packages\\NLog.3.2.1\\lib\\net45\\NLog.dll\n True\n \n \n ..\\packages\\Owin.1.0\\lib\\net40\\Owin.dll\n \n \n \n \n \n \n \n \n ..\\packages\\Microsoft.AspNet.WebApi.Client.5.2.3\\lib\\net45\\System.Net.Http.Formatting.dll\n True\n \n \n \n \n \n ..\\packages\\Microsoft.AspNet.WebPages.3.2.3\\lib\\net45\\System.Web.Helpers.dll\n True\n \n \n ..\\packages\\Microsoft.AspNet.WebApi.Core.5.2.3\\lib\\net45\\System.Web.Http.dll\n True\n \n \n ..\\packages\\Microsoft.AspNet.WebApi.Owin.5.2.3\\lib\\net45\\System.Web.Http.Owin.dll\n True\n \n \n ..\\packages\\Microsoft.AspNet.WebApi.WebHost.5.2.3\\lib\\net45\\System.Web.Http.WebHost.dll\n True\n \n \n ..\\packages\\Microsoft.AspNet.Mvc.5.2.3\\lib\\net45\\System.Web.Mvc.dll\n True\n \n \n ..\\packages\\Microsoft.AspNet.Web.Optimization.1.1.3\\lib\\net40\\System.Web.Optimization.dll\n \n \n ..\\packages\\Microsoft.AspNet.Razor.3.2.3\\lib\\net45\\System.Web.Razor.dll\n True\n \n \n ..\\packages\\Microsoft.AspNet.WebPages.3.2.3\\lib\\net45\\System.Web.WebPages.dll\n True\n \n \n ..\\packages\\Microsoft.AspNet.WebPages.3.2.3\\lib\\net45\\System.Web.WebPages.Deployment.dll\n True\n \n \n ..\\packages\\Microsoft.AspNet.WebPages.3.2.3\\lib\\net45\\System.Web.WebPages.Razor.dll\n True\n \n \n \n \n \n \n \n \n \n \n \n ..\\packages\\WebGrease.1.6.0\\lib\\WebGrease.dll\n True\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n Global.asax\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n Always\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n Designer\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n Web.config\n \n \n Web.config\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n Designer\n \n \n \n \n \n {0ec882a8-aaca-4bd5-b449-72f20fdb8586}\n AlexaSkillsKit.Lib\n \n \n \n 10.0\n $(MSBuildExtensionsPath32)\\Microsoft\\VisualStudio\\v$(VisualStudioVersion)\n \n \n \n \n \n \n \n \n \n \n \n True\n True\n 58080\n /\n http://localhost:58080/\n False\n False\n \n \n False\n \n \n \n \n \n"
},
{
"path": "AlexaSkillsKit.Sample/App_Start/BundleConfig.cs",
"content": "using System.Web;\nusing System.Web.Optimization;\n\nnamespace Sample\n{\n public class BundleConfig\n {\n // For more information on bundling, visit http://go.microsoft.com/fwlink/?LinkId=301862\n public static void RegisterBundles(BundleCollection bundles) {\n bundles.Add(new ScriptBundle(\"~/bundles/jquery\").Include(\n \"~/Scripts/jquery-{version}.js\"));\n\n // Use the development version of Modernizr to develop with and learn from. Then, when you're\n // ready for production, use the build tool at http://modernizr.com to pick only the tests you need.\n bundles.Add(new ScriptBundle(\"~/bundles/modernizr\").Include(\n \"~/Scripts/modernizr-*\"));\n\n bundles.Add(new ScriptBundle(\"~/bundles/bootstrap\").Include(\n \"~/Scripts/bootstrap.js\",\n \"~/Scripts/respond.js\"));\n\n bundles.Add(new StyleBundle(\"~/Content/css\").Include(\n \"~/Content/bootstrap.css\",\n \"~/Content/site.css\"));\n }\n }\n}\n"
},
{
"path": "AlexaSkillsKit.Sample/App_Start/FilterConfig.cs",
"content": "using System.Web;\nusing System.Web.Mvc;\n\nnamespace Sample\n{\n public class FilterConfig\n {\n public static void RegisterGlobalFilters(GlobalFilterCollection filters) {\n filters.Add(new HandleErrorAttribute());\n }\n }\n}\n"
},
{
"path": "AlexaSkillsKit.Sample/App_Start/IdentityConfig.cs",
"content": "using System.Threading.Tasks;\nusing Microsoft.AspNet.Identity;\nusing Microsoft.AspNet.Identity.EntityFramework;\nusing Microsoft.AspNet.Identity.Owin;\nusing Microsoft.Owin;\nusing Sample.Models;\n\nnamespace Sample\n{\n // Configure the application user manager used in this application. UserManager is defined in ASP.NET Identity and is used by the application.\n\n public class ApplicationUserManager : UserManager\n {\n public ApplicationUserManager(IUserStore store)\n : base(store)\n {\n }\n\n public static ApplicationUserManager Create(IdentityFactoryOptions options, IOwinContext context)\n {\n var manager = new ApplicationUserManager(new UserStore(context.Get()));\n // Configure validation logic for usernames\n manager.UserValidator = new UserValidator(manager)\n {\n AllowOnlyAlphanumericUserNames = false,\n RequireUniqueEmail = true\n };\n // Configure validation logic for passwords\n manager.PasswordValidator = new PasswordValidator\n {\n RequiredLength = 6,\n RequireNonLetterOrDigit = true,\n RequireDigit = true,\n RequireLowercase = true,\n RequireUppercase = true,\n };\n var dataProtectionProvider = options.DataProtectionProvider;\n if (dataProtectionProvider != null)\n {\n manager.UserTokenProvider = new DataProtectorTokenProvider(dataProtectionProvider.Create(\"ASP.NET Identity\"));\n }\n return manager;\n }\n }\n}\n"
},
{
"path": "AlexaSkillsKit.Sample/App_Start/RouteConfig.cs",
"content": "using System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Web;\nusing System.Web.Mvc;\nusing System.Web.Routing;\n\nnamespace Sample\n{\n public class RouteConfig\n {\n public static void RegisterRoutes(RouteCollection routes) {\n routes.IgnoreRoute(\"{resource}.axd/{*pathInfo}\");\n\n routes.MapRoute(\n name: \"Default\",\n url: \"{controller}/{action}/{id}\",\n defaults: new { controller = \"Home\", action = \"Index\", id = UrlParameter.Optional }\n );\n }\n }\n}\n"
},
{
"path": "AlexaSkillsKit.Sample/App_Start/Startup.Auth.cs",
"content": "using System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing Microsoft.AspNet.Identity;\nusing Microsoft.AspNet.Identity.EntityFramework;\nusing Microsoft.Owin;\nusing Microsoft.Owin.Security.Cookies;\nusing Microsoft.Owin.Security.Google;\nusing Microsoft.Owin.Security.OAuth;\nusing Owin;\nusing Sample.Providers;\nusing Sample.Models;\n\nnamespace Sample\n{\n public partial class Startup\n {\n public static OAuthAuthorizationServerOptions OAuthOptions { get; private set; }\n\n public static string PublicClientId { get; private set; }\n\n // For more information on configuring authentication, please visit http://go.microsoft.com/fwlink/?LinkId=301864\n public void ConfigureAuth(IAppBuilder app)\n {\n // Configure the db context and user manager to use a single instance per request\n app.CreatePerOwinContext(ApplicationDbContext.Create);\n app.CreatePerOwinContext(ApplicationUserManager.Create);\n\n // Enable the application to use a cookie to store information for the signed in user\n // and to use a cookie to temporarily store information about a user logging in with a third party login provider\n app.UseCookieAuthentication(new CookieAuthenticationOptions());\n app.UseExternalSignInCookie(DefaultAuthenticationTypes.ExternalCookie);\n\n // Configure the application for OAuth based flow\n PublicClientId = \"self\";\n OAuthOptions = new OAuthAuthorizationServerOptions\n {\n TokenEndpointPath = new PathString(\"/Token\"),\n Provider = new ApplicationOAuthProvider(PublicClientId),\n AuthorizeEndpointPath = new PathString(\"/api/Account/ExternalLogin\"),\n AccessTokenExpireTimeSpan = TimeSpan.FromDays(14),\n AllowInsecureHttp = true\n };\n\n // Enable the application to use bearer tokens to authenticate users\n app.UseOAuthBearerTokens(OAuthOptions);\n\n // Uncomment the following lines to enable logging in with third party login providers\n //app.UseMicrosoftAccountAuthentication(\n // clientId: \"\",\n // clientSecret: \"\");\n\n //app.UseTwitterAuthentication(\n // consumerKey: \"\",\n // consumerSecret: \"\");\n\n //app.UseFacebookAuthentication(\n // appId: \"\",\n // appSecret: \"\");\n\n //app.UseGoogleAuthentication(new GoogleOAuth2AuthenticationOptions()\n //{\n // ClientId = \"\",\n // ClientSecret = \"\"\n //});\n }\n }\n}\n"
},
{
"path": "AlexaSkillsKit.Sample/App_Start/WebApiConfig.cs",
"content": "using System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Net.Http;\nusing System.Web.Http;\nusing Microsoft.Owin.Security.OAuth;\nusing Newtonsoft.Json.Serialization;\n\nnamespace Sample\n{\n public static class WebApiConfig\n {\n public static void Register(HttpConfiguration config)\n {\n // Web API configuration and services\n // Configure Web API to use only bearer token authentication.\n config.SuppressDefaultHostAuthentication();\n config.Filters.Add(new HostAuthenticationFilter(OAuthDefaults.AuthenticationType));\n\n // Web API routes\n config.MapHttpAttributeRoutes();\n\n config.Routes.MapHttpRoute(\n name: \"DefaultApi\",\n routeTemplate: \"api/{controller}/{id}\",\n defaults: new { id = RouteParameter.Optional }\n );\n }\n }\n}\n"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/ApiDescriptionExtensions.cs",
"content": "using System;\nusing System.Text;\nusing System.Web;\nusing System.Web.Http.Description;\n\nnamespace Sample.Areas.HelpPage\n{\n public static class ApiDescriptionExtensions\n {\n /// \n /// Generates an URI-friendly ID for the . E.g. \"Get-Values-id_name\" instead of \"GetValues/{id}?name={name}\"\n /// \n /// The .\n /// The ID as a string.\n public static string GetFriendlyId(this ApiDescription description)\n {\n string path = description.RelativePath;\n string[] urlParts = path.Split('?');\n string localPath = urlParts[0];\n string queryKeyString = null;\n if (urlParts.Length > 1)\n {\n string query = urlParts[1];\n string[] queryKeys = HttpUtility.ParseQueryString(query).AllKeys;\n queryKeyString = String.Join(\"_\", queryKeys);\n }\n\n StringBuilder friendlyPath = new StringBuilder();\n friendlyPath.AppendFormat(\"{0}-{1}\",\n description.HttpMethod.Method,\n localPath.Replace(\"/\", \"-\").Replace(\"{\", String.Empty).Replace(\"}\", String.Empty));\n if (queryKeyString != null)\n {\n friendlyPath.AppendFormat(\"_{0}\", queryKeyString.Replace('.', '-'));\n }\n return friendlyPath.ToString();\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/App_Start/HelpPageConfig.cs",
"content": "// Uncomment the following to provide samples for PageResult. Must also add the Microsoft.AspNet.WebApi.OData\n// package to your project.\n////#define Handle_PageResultOfT\n\nusing System;\nusing System.Collections;\nusing System.Collections.Generic;\nusing System.Diagnostics;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Linq;\nusing System.Net.Http.Headers;\nusing System.Reflection;\nusing System.Web;\nusing System.Web.Http;\n#if Handle_PageResultOfT\nusing System.Web.Http.OData;\n#endif\n\nnamespace Sample.Areas.HelpPage\n{\n /// \n /// Use this class to customize the Help Page.\n /// For example you can set a custom to supply the documentation\n /// or you can provide the samples for the requests/responses.\n /// \n public static class HelpPageConfig\n {\n [SuppressMessage(\"Microsoft.Globalization\", \"CA1303:Do not pass literals as localized parameters\",\n MessageId = \"Sample.Areas.HelpPage.TextSample.#ctor(System.String)\",\n Justification = \"End users may choose to merge this string with existing localized resources.\")]\n [SuppressMessage(\"Microsoft.Naming\", \"CA2204:Literals should be spelled correctly\",\n MessageId = \"bsonspec\",\n Justification = \"Part of a URI.\")]\n public static void Register(HttpConfiguration config)\n {\n //// Uncomment the following to use the documentation from XML documentation file.\n //config.SetDocumentationProvider(new XmlDocumentationProvider(HttpContext.Current.Server.MapPath(\"~/App_Data/XmlDocument.xml\")));\n\n //// Uncomment the following to use \"sample string\" as the sample for all actions that have string as the body parameter or return type.\n //// Also, the string arrays will be used for IEnumerable. The sample objects will be serialized into different media type \n //// formats by the available formatters.\n //config.SetSampleObjects(new Dictionary\n //{\n // {typeof(string), \"sample string\"},\n // {typeof(IEnumerable), new string[]{\"sample 1\", \"sample 2\"}}\n //});\n\n // Extend the following to provide factories for types not handled automatically (those lacking parameterless\n // constructors) or for which you prefer to use non-default property values. Line below provides a fallback\n // since automatic handling will fail and GeneratePageResult handles only a single type.\n#if Handle_PageResultOfT\n config.GetHelpPageSampleGenerator().SampleObjectFactories.Add(GeneratePageResult);\n#endif\n\n // Extend the following to use a preset object directly as the sample for all actions that support a media\n // type, regardless of the body parameter or return type. The lines below avoid display of binary content.\n // The BsonMediaTypeFormatter (if available) is not used to serialize the TextSample object.\n config.SetSampleForMediaType(\n new TextSample(\"Binary JSON content. See http://bsonspec.org for details.\"),\n new MediaTypeHeaderValue(\"application/bson\"));\n\n //// Uncomment the following to use \"[0]=foo&[1]=bar\" directly as the sample for all actions that support form URL encoded format\n //// and have IEnumerable as the body parameter or return type.\n //config.SetSampleForType(\"[0]=foo&[1]=bar\", new MediaTypeHeaderValue(\"application/x-www-form-urlencoded\"), typeof(IEnumerable));\n\n //// Uncomment the following to use \"1234\" directly as the request sample for media type \"text/plain\" on the controller named \"Values\"\n //// and action named \"Put\".\n //config.SetSampleRequest(\"1234\", new MediaTypeHeaderValue(\"text/plain\"), \"Values\", \"Put\");\n\n //// Uncomment the following to use the image on \"../images/aspNetHome.png\" directly as the response sample for media type \"image/png\"\n //// on the controller named \"Values\" and action named \"Get\" with parameter \"id\".\n //config.SetSampleResponse(new ImageSample(\"../images/aspNetHome.png\"), new MediaTypeHeaderValue(\"image/png\"), \"Values\", \"Get\", \"id\");\n\n //// Uncomment the following to correct the sample request when the action expects an HttpRequestMessage with ObjectContent.\n //// The sample will be generated as if the controller named \"Values\" and action named \"Get\" were having string as the body parameter.\n //config.SetActualRequestType(typeof(string), \"Values\", \"Get\");\n\n //// Uncomment the following to correct the sample response when the action returns an HttpResponseMessage with ObjectContent.\n //// The sample will be generated as if the controller named \"Values\" and action named \"Post\" were returning a string.\n //config.SetActualResponseType(typeof(string), \"Values\", \"Post\");\n }\n\n#if Handle_PageResultOfT\n private static object GeneratePageResult(HelpPageSampleGenerator sampleGenerator, Type type)\n {\n if (type.IsGenericType)\n {\n Type openGenericType = type.GetGenericTypeDefinition();\n if (openGenericType == typeof(PageResult<>))\n {\n // Get the T in PageResult\n Type[] typeParameters = type.GetGenericArguments();\n Debug.Assert(typeParameters.Length == 1);\n\n // Create an enumeration to pass as the first parameter to the PageResult constuctor\n Type itemsType = typeof(List<>).MakeGenericType(typeParameters);\n object items = sampleGenerator.GetSampleObject(itemsType);\n\n // Fill in the other information needed to invoke the PageResult constuctor\n Type[] parameterTypes = new Type[] { itemsType, typeof(Uri), typeof(long?), };\n object[] parameters = new object[] { items, null, (long)ObjectGenerator.DefaultCollectionSize, };\n\n // Call PageResult(IEnumerable items, Uri nextPageLink, long? count) constructor\n ConstructorInfo constructor = type.GetConstructor(parameterTypes);\n return constructor.Invoke(parameters);\n }\n }\n\n return null;\n }\n#endif\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/Controllers/HelpController.cs",
"content": "using System;\nusing System.Web.Http;\nusing System.Web.Mvc;\nusing Sample.Areas.HelpPage.ModelDescriptions;\nusing Sample.Areas.HelpPage.Models;\n\nnamespace Sample.Areas.HelpPage.Controllers\n{\n /// \n /// The controller that will handle requests for the help page.\n /// \n public class HelpController : Controller\n {\n private const string ErrorViewName = \"Error\";\n\n public HelpController()\n : this(GlobalConfiguration.Configuration)\n {\n }\n\n public HelpController(HttpConfiguration config)\n {\n Configuration = config;\n }\n\n public HttpConfiguration Configuration { get; private set; }\n\n public ActionResult Index()\n {\n ViewBag.DocumentationProvider = Configuration.Services.GetDocumentationProvider();\n return View(Configuration.Services.GetApiExplorer().ApiDescriptions);\n }\n\n public ActionResult Api(string apiId)\n {\n if (!String.IsNullOrEmpty(apiId))\n {\n HelpPageApiModel apiModel = Configuration.GetHelpPageApiModel(apiId);\n if (apiModel != null)\n {\n return View(apiModel);\n }\n }\n\n return View(ErrorViewName);\n }\n\n public ActionResult ResourceModel(string modelName)\n {\n if (!String.IsNullOrEmpty(modelName))\n {\n ModelDescriptionGenerator modelDescriptionGenerator = Configuration.GetModelDescriptionGenerator();\n ModelDescription modelDescription;\n if (modelDescriptionGenerator.GeneratedModels.TryGetValue(modelName, out modelDescription))\n {\n return View(modelDescription);\n }\n }\n\n return View(ErrorViewName);\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/HelpPage.css",
"content": ".help-page h1,\n.help-page .h1,\n.help-page h2,\n.help-page .h2,\n.help-page h3,\n.help-page .h3,\n#body.help-page,\n.help-page-table th,\n.help-page-table pre,\n.help-page-table p {\n font-family: \"Segoe UI Light\", Frutiger, \"Frutiger Linotype\", \"Dejavu Sans\", \"Helvetica Neue\", Arial, sans-serif;\n}\n\n.help-page pre.wrapped {\n white-space: -moz-pre-wrap;\n white-space: -pre-wrap;\n white-space: -o-pre-wrap;\n white-space: pre-wrap;\n}\n\n.help-page .warning-message-container {\n margin-top: 20px;\n padding: 0 10px;\n color: #525252;\n background: #EFDCA9; \n border: 1px solid #CCCCCC;\n}\n\n.help-page-table {\n width: 100%;\n border-collapse: collapse;\n text-align: left;\n margin: 0px 0px 20px 0px;\n border-top: 1px solid #D4D4D4;\n}\n\n.help-page-table th {\n text-align: left;\n font-weight: bold;\n border-bottom: 1px solid #D4D4D4;\n padding: 5px 6px 5px 6px;\n}\n\n.help-page-table td {\n border-bottom: 1px solid #D4D4D4;\n padding: 10px 8px 10px 8px;\n vertical-align: top;\n}\n\n.help-page-table pre,\n.help-page-table p {\n margin: 0px;\n padding: 0px;\n font-family: inherit;\n font-size: 100%;\n}\n\n.help-page-table tbody tr:hover td {\n background-color: #F3F3F3;\n}\n\n.help-page a:hover {\n background-color: transparent;\n}\n\n.help-page .sample-header {\n border: 2px solid #D4D4D4;\n background: #00497E;\n color: #FFFFFF;\n padding: 8px 15px;\n border-bottom: none;\n display: inline-block;\n margin: 10px 0px 0px 0px;\n}\n\n.help-page .sample-content {\n display: block;\n border-width: 0;\n padding: 15px 20px;\n background: #FFFFFF;\n border: 2px solid #D4D4D4;\n margin: 0px 0px 10px 0px;\n}\n\n.help-page .api-name {\n width: 40%;\n}\n\n.help-page .api-documentation {\n width: 60%;\n}\n\n.help-page .parameter-name {\n width: 20%;\n}\n\n.help-page .parameter-documentation {\n width: 40%;\n}\n\n.help-page .parameter-type {\n width: 20%;\n}\n\n.help-page .parameter-annotations {\n width: 20%;\n}\n\n.help-page h1,\n.help-page .h1 {\n font-size: 36px;\n line-height: normal;\n}\n\n.help-page h2,\n.help-page .h2 {\n font-size: 24px;\n}\n\n.help-page h3,\n.help-page .h3 {\n font-size: 20px;\n}\n\n#body.help-page {\n font-size: 14px;\n line-height: 143%;\n color: #333;\n}\n\n.help-page a {\n color: #0000EE;\n text-decoration: none;\n}\n"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/HelpPageAreaRegistration.cs",
"content": "using System.Web.Http;\nusing System.Web.Mvc;\n\nnamespace Sample.Areas.HelpPage\n{\n public class HelpPageAreaRegistration : AreaRegistration\n {\n public override string AreaName\n {\n get\n {\n return \"HelpPage\";\n }\n }\n\n public override void RegisterArea(AreaRegistrationContext context)\n {\n context.MapRoute(\n \"HelpPage_Default\",\n \"Help/{action}/{apiId}\",\n new { controller = \"Help\", action = \"Index\", apiId = UrlParameter.Optional });\n\n HelpPageConfig.Register(GlobalConfiguration.Configuration);\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/HelpPageConfigurationExtensions.cs",
"content": "using System;\nusing System.Collections.Generic;\nusing System.Collections.ObjectModel;\nusing System.ComponentModel;\nusing System.Diagnostics;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Globalization;\nusing System.Linq;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Web.Http;\nusing System.Web.Http.Controllers;\nusing System.Web.Http.Description;\nusing Sample.Areas.HelpPage.ModelDescriptions;\nusing Sample.Areas.HelpPage.Models;\n\nnamespace Sample.Areas.HelpPage\n{\n public static class HelpPageConfigurationExtensions\n {\n private const string ApiModelPrefix = \"MS_HelpPageApiModel_\";\n\n /// \n /// Sets the documentation provider for help page.\n /// \n /// The .\n /// The documentation provider.\n public static void SetDocumentationProvider(this HttpConfiguration config, IDocumentationProvider documentationProvider)\n {\n config.Services.Replace(typeof(IDocumentationProvider), documentationProvider);\n }\n\n /// \n /// Sets the objects that will be used by the formatters to produce sample requests/responses.\n /// \n /// The .\n /// The sample objects.\n public static void SetSampleObjects(this HttpConfiguration config, IDictionary sampleObjects)\n {\n config.GetHelpPageSampleGenerator().SampleObjects = sampleObjects;\n }\n\n /// \n /// Sets the sample request directly for the specified media type and action.\n /// \n /// The .\n /// The sample request.\n /// The media type.\n /// Name of the controller.\n /// Name of the action.\n public static void SetSampleRequest(this HttpConfiguration config, object sample, MediaTypeHeaderValue mediaType, string controllerName, string actionName)\n {\n config.GetHelpPageSampleGenerator().ActionSamples.Add(new HelpPageSampleKey(mediaType, SampleDirection.Request, controllerName, actionName, new[] { \"*\" }), sample);\n }\n\n /// \n /// Sets the sample request directly for the specified media type and action with parameters.\n /// \n /// The .\n /// The sample request.\n /// The media type.\n /// Name of the controller.\n /// Name of the action.\n /// The parameter names.\n public static void SetSampleRequest(this HttpConfiguration config, object sample, MediaTypeHeaderValue mediaType, string controllerName, string actionName, params string[] parameterNames)\n {\n config.GetHelpPageSampleGenerator().ActionSamples.Add(new HelpPageSampleKey(mediaType, SampleDirection.Request, controllerName, actionName, parameterNames), sample);\n }\n\n /// \n /// Sets the sample request directly for the specified media type of the action.\n /// \n /// The .\n /// The sample response.\n /// The media type.\n /// Name of the controller.\n /// Name of the action.\n public static void SetSampleResponse(this HttpConfiguration config, object sample, MediaTypeHeaderValue mediaType, string controllerName, string actionName)\n {\n config.GetHelpPageSampleGenerator().ActionSamples.Add(new HelpPageSampleKey(mediaType, SampleDirection.Response, controllerName, actionName, new[] { \"*\" }), sample);\n }\n\n /// \n /// Sets the sample response directly for the specified media type of the action with specific parameters.\n /// \n /// The .\n /// The sample response.\n /// The media type.\n /// Name of the controller.\n /// Name of the action.\n /// The parameter names.\n public static void SetSampleResponse(this HttpConfiguration config, object sample, MediaTypeHeaderValue mediaType, string controllerName, string actionName, params string[] parameterNames)\n {\n config.GetHelpPageSampleGenerator().ActionSamples.Add(new HelpPageSampleKey(mediaType, SampleDirection.Response, controllerName, actionName, parameterNames), sample);\n }\n\n /// \n /// Sets the sample directly for all actions with the specified media type.\n /// \n /// The .\n /// The sample.\n /// The media type.\n public static void SetSampleForMediaType(this HttpConfiguration config, object sample, MediaTypeHeaderValue mediaType)\n {\n config.GetHelpPageSampleGenerator().ActionSamples.Add(new HelpPageSampleKey(mediaType), sample);\n }\n\n /// \n /// Sets the sample directly for all actions with the specified type and media type.\n /// \n /// The .\n /// The sample.\n /// The media type.\n /// The parameter type or return type of an action.\n public static void SetSampleForType(this HttpConfiguration config, object sample, MediaTypeHeaderValue mediaType, Type type)\n {\n config.GetHelpPageSampleGenerator().ActionSamples.Add(new HelpPageSampleKey(mediaType, type), sample);\n }\n\n /// \n /// Specifies the actual type of passed to the in an action.\n /// The help page will use this information to produce more accurate request samples.\n /// \n /// The .\n /// The type.\n /// Name of the controller.\n /// Name of the action.\n public static void SetActualRequestType(this HttpConfiguration config, Type type, string controllerName, string actionName)\n {\n config.GetHelpPageSampleGenerator().ActualHttpMessageTypes.Add(new HelpPageSampleKey(SampleDirection.Request, controllerName, actionName, new[] { \"*\" }), type);\n }\n\n /// \n /// Specifies the actual type of passed to the in an action.\n /// The help page will use this information to produce more accurate request samples.\n /// \n /// The .\n /// The type.\n /// Name of the controller.\n /// Name of the action.\n /// The parameter names.\n public static void SetActualRequestType(this HttpConfiguration config, Type type, string controllerName, string actionName, params string[] parameterNames)\n {\n config.GetHelpPageSampleGenerator().ActualHttpMessageTypes.Add(new HelpPageSampleKey(SampleDirection.Request, controllerName, actionName, parameterNames), type);\n }\n\n /// \n /// Specifies the actual type of returned as part of the in an action.\n /// The help page will use this information to produce more accurate response samples.\n /// \n /// The .\n /// The type.\n /// Name of the controller.\n /// Name of the action.\n public static void SetActualResponseType(this HttpConfiguration config, Type type, string controllerName, string actionName)\n {\n config.GetHelpPageSampleGenerator().ActualHttpMessageTypes.Add(new HelpPageSampleKey(SampleDirection.Response, controllerName, actionName, new[] { \"*\" }), type);\n }\n\n /// \n /// Specifies the actual type of returned as part of the in an action.\n /// The help page will use this information to produce more accurate response samples.\n /// \n /// The .\n /// The type.\n /// Name of the controller.\n /// Name of the action.\n /// The parameter names.\n public static void SetActualResponseType(this HttpConfiguration config, Type type, string controllerName, string actionName, params string[] parameterNames)\n {\n config.GetHelpPageSampleGenerator().ActualHttpMessageTypes.Add(new HelpPageSampleKey(SampleDirection.Response, controllerName, actionName, parameterNames), type);\n }\n\n /// \n /// Gets the help page sample generator.\n /// \n /// The .\n /// The help page sample generator.\n public static HelpPageSampleGenerator GetHelpPageSampleGenerator(this HttpConfiguration config)\n {\n return (HelpPageSampleGenerator)config.Properties.GetOrAdd(\n typeof(HelpPageSampleGenerator),\n k => new HelpPageSampleGenerator());\n }\n\n /// \n /// Sets the help page sample generator.\n /// \n /// The .\n /// The help page sample generator.\n public static void SetHelpPageSampleGenerator(this HttpConfiguration config, HelpPageSampleGenerator sampleGenerator)\n {\n config.Properties.AddOrUpdate(\n typeof(HelpPageSampleGenerator),\n k => sampleGenerator,\n (k, o) => sampleGenerator);\n }\n\n /// \n /// Gets the model description generator.\n /// \n /// The configuration.\n /// The \n public static ModelDescriptionGenerator GetModelDescriptionGenerator(this HttpConfiguration config)\n {\n return (ModelDescriptionGenerator)config.Properties.GetOrAdd(\n typeof(ModelDescriptionGenerator),\n k => InitializeModelDescriptionGenerator(config));\n }\n\n /// \n /// Gets the model that represents an API displayed on the help page. The model is initialized on the first call and cached for subsequent calls.\n /// \n /// The .\n /// The ID.\n /// \n /// An \n /// \n public static HelpPageApiModel GetHelpPageApiModel(this HttpConfiguration config, string apiDescriptionId)\n {\n object model;\n string modelId = ApiModelPrefix + apiDescriptionId;\n if (!config.Properties.TryGetValue(modelId, out model))\n {\n Collection apiDescriptions = config.Services.GetApiExplorer().ApiDescriptions;\n ApiDescription apiDescription = apiDescriptions.FirstOrDefault(api => String.Equals(api.GetFriendlyId(), apiDescriptionId, StringComparison.OrdinalIgnoreCase));\n if (apiDescription != null)\n {\n model = GenerateApiModel(apiDescription, config);\n config.Properties.TryAdd(modelId, model);\n }\n }\n\n return (HelpPageApiModel)model;\n }\n\n private static HelpPageApiModel GenerateApiModel(ApiDescription apiDescription, HttpConfiguration config)\n {\n HelpPageApiModel apiModel = new HelpPageApiModel()\n {\n ApiDescription = apiDescription,\n };\n\n ModelDescriptionGenerator modelGenerator = config.GetModelDescriptionGenerator();\n HelpPageSampleGenerator sampleGenerator = config.GetHelpPageSampleGenerator();\n GenerateUriParameters(apiModel, modelGenerator);\n GenerateRequestModelDescription(apiModel, modelGenerator, sampleGenerator);\n GenerateResourceDescription(apiModel, modelGenerator);\n GenerateSamples(apiModel, sampleGenerator);\n\n return apiModel;\n }\n\n private static void GenerateUriParameters(HelpPageApiModel apiModel, ModelDescriptionGenerator modelGenerator)\n {\n ApiDescription apiDescription = apiModel.ApiDescription;\n foreach (ApiParameterDescription apiParameter in apiDescription.ParameterDescriptions)\n {\n if (apiParameter.Source == ApiParameterSource.FromUri)\n {\n HttpParameterDescriptor parameterDescriptor = apiParameter.ParameterDescriptor;\n Type parameterType = null;\n ModelDescription typeDescription = null;\n ComplexTypeModelDescription complexTypeDescription = null;\n if (parameterDescriptor != null)\n {\n parameterType = parameterDescriptor.ParameterType;\n typeDescription = modelGenerator.GetOrCreateModelDescription(parameterType);\n complexTypeDescription = typeDescription as ComplexTypeModelDescription;\n }\n\n // Example:\n // [TypeConverter(typeof(PointConverter))]\n // public class Point\n // {\n // public Point(int x, int y)\n // {\n // X = x;\n // Y = y;\n // }\n // public int X { get; set; }\n // public int Y { get; set; }\n // }\n // Class Point is bindable with a TypeConverter, so Point will be added to UriParameters collection.\n // \n // public class Point\n // {\n // public int X { get; set; }\n // public int Y { get; set; }\n // }\n // Regular complex class Point will have properties X and Y added to UriParameters collection.\n if (complexTypeDescription != null\n && !IsBindableWithTypeConverter(parameterType))\n {\n foreach (ParameterDescription uriParameter in complexTypeDescription.Properties)\n {\n apiModel.UriParameters.Add(uriParameter);\n }\n }\n else if (parameterDescriptor != null)\n {\n ParameterDescription uriParameter =\n AddParameterDescription(apiModel, apiParameter, typeDescription);\n\n if (!parameterDescriptor.IsOptional)\n {\n uriParameter.Annotations.Add(new ParameterAnnotation() { Documentation = \"Required\" });\n }\n\n object defaultValue = parameterDescriptor.DefaultValue;\n if (defaultValue != null)\n {\n uriParameter.Annotations.Add(new ParameterAnnotation() { Documentation = \"Default value is \" + Convert.ToString(defaultValue, CultureInfo.InvariantCulture) });\n }\n }\n else\n {\n Debug.Assert(parameterDescriptor == null);\n\n // If parameterDescriptor is null, this is an undeclared route parameter which only occurs\n // when source is FromUri. Ignored in request model and among resource parameters but listed\n // as a simple string here.\n ModelDescription modelDescription = modelGenerator.GetOrCreateModelDescription(typeof(string));\n AddParameterDescription(apiModel, apiParameter, modelDescription);\n }\n }\n }\n }\n\n private static bool IsBindableWithTypeConverter(Type parameterType)\n {\n if (parameterType == null)\n {\n return false;\n }\n\n return TypeDescriptor.GetConverter(parameterType).CanConvertFrom(typeof(string));\n }\n\n private static ParameterDescription AddParameterDescription(HelpPageApiModel apiModel,\n ApiParameterDescription apiParameter, ModelDescription typeDescription)\n {\n ParameterDescription parameterDescription = new ParameterDescription\n {\n Name = apiParameter.Name,\n Documentation = apiParameter.Documentation,\n TypeDescription = typeDescription,\n };\n\n apiModel.UriParameters.Add(parameterDescription);\n return parameterDescription;\n }\n\n private static void GenerateRequestModelDescription(HelpPageApiModel apiModel, ModelDescriptionGenerator modelGenerator, HelpPageSampleGenerator sampleGenerator)\n {\n ApiDescription apiDescription = apiModel.ApiDescription;\n foreach (ApiParameterDescription apiParameter in apiDescription.ParameterDescriptions)\n {\n if (apiParameter.Source == ApiParameterSource.FromBody)\n {\n Type parameterType = apiParameter.ParameterDescriptor.ParameterType;\n apiModel.RequestModelDescription = modelGenerator.GetOrCreateModelDescription(parameterType);\n apiModel.RequestDocumentation = apiParameter.Documentation;\n }\n else if (apiParameter.ParameterDescriptor != null &&\n apiParameter.ParameterDescriptor.ParameterType == typeof(HttpRequestMessage))\n {\n Type parameterType = sampleGenerator.ResolveHttpRequestMessageType(apiDescription);\n\n if (parameterType != null)\n {\n apiModel.RequestModelDescription = modelGenerator.GetOrCreateModelDescription(parameterType);\n }\n }\n }\n }\n\n private static void GenerateResourceDescription(HelpPageApiModel apiModel, ModelDescriptionGenerator modelGenerator)\n {\n ResponseDescription response = apiModel.ApiDescription.ResponseDescription;\n Type responseType = response.ResponseType ?? response.DeclaredType;\n if (responseType != null && responseType != typeof(void))\n {\n apiModel.ResourceDescription = modelGenerator.GetOrCreateModelDescription(responseType);\n }\n }\n\n [SuppressMessage(\"Microsoft.Design\", \"CA1031:DoNotCatchGeneralExceptionTypes\", Justification = \"The exception is recorded as ErrorMessages.\")]\n private static void GenerateSamples(HelpPageApiModel apiModel, HelpPageSampleGenerator sampleGenerator)\n {\n try\n {\n foreach (var item in sampleGenerator.GetSampleRequests(apiModel.ApiDescription))\n {\n apiModel.SampleRequests.Add(item.Key, item.Value);\n LogInvalidSampleAsError(apiModel, item.Value);\n }\n\n foreach (var item in sampleGenerator.GetSampleResponses(apiModel.ApiDescription))\n {\n apiModel.SampleResponses.Add(item.Key, item.Value);\n LogInvalidSampleAsError(apiModel, item.Value);\n }\n }\n catch (Exception e)\n {\n apiModel.ErrorMessages.Add(String.Format(CultureInfo.CurrentCulture,\n \"An exception has occurred while generating the sample. Exception message: {0}\",\n HelpPageSampleGenerator.UnwrapException(e).Message));\n }\n }\n\n private static bool TryGetResourceParameter(ApiDescription apiDescription, HttpConfiguration config, out ApiParameterDescription parameterDescription, out Type resourceType)\n {\n parameterDescription = apiDescription.ParameterDescriptions.FirstOrDefault(\n p => p.Source == ApiParameterSource.FromBody ||\n (p.ParameterDescriptor != null && p.ParameterDescriptor.ParameterType == typeof(HttpRequestMessage)));\n\n if (parameterDescription == null)\n {\n resourceType = null;\n return false;\n }\n\n resourceType = parameterDescription.ParameterDescriptor.ParameterType;\n\n if (resourceType == typeof(HttpRequestMessage))\n {\n HelpPageSampleGenerator sampleGenerator = config.GetHelpPageSampleGenerator();\n resourceType = sampleGenerator.ResolveHttpRequestMessageType(apiDescription);\n }\n\n if (resourceType == null)\n {\n parameterDescription = null;\n return false;\n }\n\n return true;\n }\n\n private static ModelDescriptionGenerator InitializeModelDescriptionGenerator(HttpConfiguration config)\n {\n ModelDescriptionGenerator modelGenerator = new ModelDescriptionGenerator(config);\n Collection apis = config.Services.GetApiExplorer().ApiDescriptions;\n foreach (ApiDescription api in apis)\n {\n ApiParameterDescription parameterDescription;\n Type parameterType;\n if (TryGetResourceParameter(api, config, out parameterDescription, out parameterType))\n {\n modelGenerator.GetOrCreateModelDescription(parameterType);\n }\n }\n return modelGenerator;\n }\n\n private static void LogInvalidSampleAsError(HelpPageApiModel apiModel, object sample)\n {\n InvalidSample invalidSample = sample as InvalidSample;\n if (invalidSample != null)\n {\n apiModel.ErrorMessages.Add(invalidSample.ErrorMessage);\n }\n }\n }\n}\n"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/ModelDescriptions/CollectionModelDescription.cs",
"content": "namespace Sample.Areas.HelpPage.ModelDescriptions\n{\n public class CollectionModelDescription : ModelDescription\n {\n public ModelDescription ElementDescription { get; set; }\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/ModelDescriptions/ComplexTypeModelDescription.cs",
"content": "using System.Collections.ObjectModel;\n\nnamespace Sample.Areas.HelpPage.ModelDescriptions\n{\n public class ComplexTypeModelDescription : ModelDescription\n {\n public ComplexTypeModelDescription()\n {\n Properties = new Collection();\n }\n\n public Collection Properties { get; private set; }\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/ModelDescriptions/DictionaryModelDescription.cs",
"content": "namespace Sample.Areas.HelpPage.ModelDescriptions\n{\n public class DictionaryModelDescription : KeyValuePairModelDescription\n {\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/ModelDescriptions/EnumTypeModelDescription.cs",
"content": "using System.Collections.Generic;\nusing System.Collections.ObjectModel;\n\nnamespace Sample.Areas.HelpPage.ModelDescriptions\n{\n public class EnumTypeModelDescription : ModelDescription\n {\n public EnumTypeModelDescription()\n {\n Values = new Collection();\n }\n\n public Collection Values { get; private set; }\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/ModelDescriptions/EnumValueDescription.cs",
"content": "namespace Sample.Areas.HelpPage.ModelDescriptions\n{\n public class EnumValueDescription\n {\n public string Documentation { get; set; }\n\n public string Name { get; set; }\n\n public string Value { get; set; }\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/ModelDescriptions/IModelDocumentationProvider.cs",
"content": "using System;\nusing System.Reflection;\n\nnamespace Sample.Areas.HelpPage.ModelDescriptions\n{\n public interface IModelDocumentationProvider\n {\n string GetDocumentation(MemberInfo member);\n\n string GetDocumentation(Type type);\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/ModelDescriptions/KeyValuePairModelDescription.cs",
"content": "namespace Sample.Areas.HelpPage.ModelDescriptions\n{\n public class KeyValuePairModelDescription : ModelDescription\n {\n public ModelDescription KeyModelDescription { get; set; }\n\n public ModelDescription ValueModelDescription { get; set; }\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/ModelDescriptions/ModelDescription.cs",
"content": "using System;\n\nnamespace Sample.Areas.HelpPage.ModelDescriptions\n{\n /// \n /// Describes a type model.\n /// \n public abstract class ModelDescription\n {\n public string Documentation { get; set; }\n\n public Type ModelType { get; set; }\n\n public string Name { get; set; }\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/ModelDescriptions/ModelDescriptionGenerator.cs",
"content": "using System;\nusing System.Collections;\nusing System.Collections.Generic;\nusing System.Collections.Specialized;\nusing System.ComponentModel.DataAnnotations;\nusing System.Globalization;\nusing System.Reflection;\nusing System.Runtime.Serialization;\nusing System.Web.Http;\nusing System.Web.Http.Description;\nusing System.Xml.Serialization;\nusing Newtonsoft.Json;\n\nnamespace Sample.Areas.HelpPage.ModelDescriptions\n{\n /// \n /// Generates model descriptions for given types.\n /// \n public class ModelDescriptionGenerator\n {\n // Modify this to support more data annotation attributes.\n private readonly IDictionary> AnnotationTextGenerator = new Dictionary>\n {\n { typeof(RequiredAttribute), a => \"Required\" },\n { typeof(RangeAttribute), a =>\n {\n RangeAttribute range = (RangeAttribute)a;\n return String.Format(CultureInfo.CurrentCulture, \"Range: inclusive between {0} and {1}\", range.Minimum, range.Maximum);\n }\n },\n { typeof(MaxLengthAttribute), a =>\n {\n MaxLengthAttribute maxLength = (MaxLengthAttribute)a;\n return String.Format(CultureInfo.CurrentCulture, \"Max length: {0}\", maxLength.Length);\n }\n },\n { typeof(MinLengthAttribute), a =>\n {\n MinLengthAttribute minLength = (MinLengthAttribute)a;\n return String.Format(CultureInfo.CurrentCulture, \"Min length: {0}\", minLength.Length);\n }\n },\n { typeof(StringLengthAttribute), a =>\n {\n StringLengthAttribute strLength = (StringLengthAttribute)a;\n return String.Format(CultureInfo.CurrentCulture, \"String length: inclusive between {0} and {1}\", strLength.MinimumLength, strLength.MaximumLength);\n }\n },\n { typeof(DataTypeAttribute), a =>\n {\n DataTypeAttribute dataType = (DataTypeAttribute)a;\n return String.Format(CultureInfo.CurrentCulture, \"Data type: {0}\", dataType.CustomDataType ?? dataType.DataType.ToString());\n }\n },\n { typeof(RegularExpressionAttribute), a =>\n {\n RegularExpressionAttribute regularExpression = (RegularExpressionAttribute)a;\n return String.Format(CultureInfo.CurrentCulture, \"Matching regular expression pattern: {0}\", regularExpression.Pattern);\n }\n },\n };\n\n // Modify this to add more default documentations.\n private readonly IDictionary DefaultTypeDocumentation = new Dictionary\n {\n { typeof(Int16), \"integer\" },\n { typeof(Int32), \"integer\" },\n { typeof(Int64), \"integer\" },\n { typeof(UInt16), \"unsigned integer\" },\n { typeof(UInt32), \"unsigned integer\" },\n { typeof(UInt64), \"unsigned integer\" },\n { typeof(Byte), \"byte\" },\n { typeof(Char), \"character\" },\n { typeof(SByte), \"signed byte\" },\n { typeof(Uri), \"URI\" },\n { typeof(Single), \"decimal number\" },\n { typeof(Double), \"decimal number\" },\n { typeof(Decimal), \"decimal number\" },\n { typeof(String), \"string\" },\n { typeof(Guid), \"globally unique identifier\" },\n { typeof(TimeSpan), \"time interval\" },\n { typeof(DateTime), \"date\" },\n { typeof(DateTimeOffset), \"date\" },\n { typeof(Boolean), \"boolean\" },\n };\n\n private Lazy _documentationProvider;\n\n public ModelDescriptionGenerator(HttpConfiguration config)\n {\n if (config == null)\n {\n throw new ArgumentNullException(\"config\");\n }\n\n _documentationProvider = new Lazy(() => config.Services.GetDocumentationProvider() as IModelDocumentationProvider);\n GeneratedModels = new Dictionary(StringComparer.OrdinalIgnoreCase);\n }\n\n public Dictionary GeneratedModels { get; private set; }\n\n private IModelDocumentationProvider DocumentationProvider\n {\n get\n {\n return _documentationProvider.Value;\n }\n }\n\n public ModelDescription GetOrCreateModelDescription(Type modelType)\n {\n if (modelType == null)\n {\n throw new ArgumentNullException(\"modelType\");\n }\n\n Type underlyingType = Nullable.GetUnderlyingType(modelType);\n if (underlyingType != null)\n {\n modelType = underlyingType;\n }\n\n ModelDescription modelDescription;\n string modelName = ModelNameHelper.GetModelName(modelType);\n if (GeneratedModels.TryGetValue(modelName, out modelDescription))\n {\n if (modelType != modelDescription.ModelType)\n {\n throw new InvalidOperationException(\n String.Format(\n CultureInfo.CurrentCulture,\n \"A model description could not be created. Duplicate model name '{0}' was found for types '{1}' and '{2}'. \" +\n \"Use the [ModelName] attribute to change the model name for at least one of the types so that it has a unique name.\",\n modelName,\n modelDescription.ModelType.FullName,\n modelType.FullName));\n }\n\n return modelDescription;\n }\n\n if (DefaultTypeDocumentation.ContainsKey(modelType))\n {\n return GenerateSimpleTypeModelDescription(modelType);\n }\n\n if (modelType.IsEnum)\n {\n return GenerateEnumTypeModelDescription(modelType);\n }\n\n if (modelType.IsGenericType)\n {\n Type[] genericArguments = modelType.GetGenericArguments();\n\n if (genericArguments.Length == 1)\n {\n Type enumerableType = typeof(IEnumerable<>).MakeGenericType(genericArguments);\n if (enumerableType.IsAssignableFrom(modelType))\n {\n return GenerateCollectionModelDescription(modelType, genericArguments[0]);\n }\n }\n if (genericArguments.Length == 2)\n {\n Type dictionaryType = typeof(IDictionary<,>).MakeGenericType(genericArguments);\n if (dictionaryType.IsAssignableFrom(modelType))\n {\n return GenerateDictionaryModelDescription(modelType, genericArguments[0], genericArguments[1]);\n }\n\n Type keyValuePairType = typeof(KeyValuePair<,>).MakeGenericType(genericArguments);\n if (keyValuePairType.IsAssignableFrom(modelType))\n {\n return GenerateKeyValuePairModelDescription(modelType, genericArguments[0], genericArguments[1]);\n }\n }\n }\n\n if (modelType.IsArray)\n {\n Type elementType = modelType.GetElementType();\n return GenerateCollectionModelDescription(modelType, elementType);\n }\n\n if (modelType == typeof(NameValueCollection))\n {\n return GenerateDictionaryModelDescription(modelType, typeof(string), typeof(string));\n }\n\n if (typeof(IDictionary).IsAssignableFrom(modelType))\n {\n return GenerateDictionaryModelDescription(modelType, typeof(object), typeof(object));\n }\n\n if (typeof(IEnumerable).IsAssignableFrom(modelType))\n {\n return GenerateCollectionModelDescription(modelType, typeof(object));\n }\n\n return GenerateComplexTypeModelDescription(modelType);\n }\n\n // Change this to provide different name for the member.\n private static string GetMemberName(MemberInfo member, bool hasDataContractAttribute)\n {\n JsonPropertyAttribute jsonProperty = member.GetCustomAttribute();\n if (jsonProperty != null && !String.IsNullOrEmpty(jsonProperty.PropertyName))\n {\n return jsonProperty.PropertyName;\n }\n\n if (hasDataContractAttribute)\n {\n DataMemberAttribute dataMember = member.GetCustomAttribute();\n if (dataMember != null && !String.IsNullOrEmpty(dataMember.Name))\n {\n return dataMember.Name;\n }\n }\n\n return member.Name;\n }\n\n private static bool ShouldDisplayMember(MemberInfo member, bool hasDataContractAttribute)\n {\n JsonIgnoreAttribute jsonIgnore = member.GetCustomAttribute();\n XmlIgnoreAttribute xmlIgnore = member.GetCustomAttribute();\n IgnoreDataMemberAttribute ignoreDataMember = member.GetCustomAttribute();\n NonSerializedAttribute nonSerialized = member.GetCustomAttribute();\n ApiExplorerSettingsAttribute apiExplorerSetting = member.GetCustomAttribute();\n\n bool hasMemberAttribute = member.DeclaringType.IsEnum ?\n member.GetCustomAttribute() != null :\n member.GetCustomAttribute() != null;\n\n // Display member only if all the followings are true:\n // no JsonIgnoreAttribute\n // no XmlIgnoreAttribute\n // no IgnoreDataMemberAttribute\n // no NonSerializedAttribute\n // no ApiExplorerSettingsAttribute with IgnoreApi set to true\n // no DataContractAttribute without DataMemberAttribute or EnumMemberAttribute\n return jsonIgnore == null &&\n xmlIgnore == null &&\n ignoreDataMember == null &&\n nonSerialized == null &&\n (apiExplorerSetting == null || !apiExplorerSetting.IgnoreApi) &&\n (!hasDataContractAttribute || hasMemberAttribute);\n }\n\n private string CreateDefaultDocumentation(Type type)\n {\n string documentation;\n if (DefaultTypeDocumentation.TryGetValue(type, out documentation))\n {\n return documentation;\n }\n if (DocumentationProvider != null)\n {\n documentation = DocumentationProvider.GetDocumentation(type);\n }\n\n return documentation;\n }\n\n private void GenerateAnnotations(MemberInfo property, ParameterDescription propertyModel)\n {\n List annotations = new List();\n\n IEnumerable attributes = property.GetCustomAttributes();\n foreach (Attribute attribute in attributes)\n {\n Func textGenerator;\n if (AnnotationTextGenerator.TryGetValue(attribute.GetType(), out textGenerator))\n {\n annotations.Add(\n new ParameterAnnotation\n {\n AnnotationAttribute = attribute,\n Documentation = textGenerator(attribute)\n });\n }\n }\n\n // Rearrange the annotations\n annotations.Sort((x, y) =>\n {\n // Special-case RequiredAttribute so that it shows up on top\n if (x.AnnotationAttribute is RequiredAttribute)\n {\n return -1;\n }\n if (y.AnnotationAttribute is RequiredAttribute)\n {\n return 1;\n }\n\n // Sort the rest based on alphabetic order of the documentation\n return String.Compare(x.Documentation, y.Documentation, StringComparison.OrdinalIgnoreCase);\n });\n\n foreach (ParameterAnnotation annotation in annotations)\n {\n propertyModel.Annotations.Add(annotation);\n }\n }\n\n private CollectionModelDescription GenerateCollectionModelDescription(Type modelType, Type elementType)\n {\n ModelDescription collectionModelDescription = GetOrCreateModelDescription(elementType);\n if (collectionModelDescription != null)\n {\n return new CollectionModelDescription\n {\n Name = ModelNameHelper.GetModelName(modelType),\n ModelType = modelType,\n ElementDescription = collectionModelDescription\n };\n }\n\n return null;\n }\n\n private ModelDescription GenerateComplexTypeModelDescription(Type modelType)\n {\n ComplexTypeModelDescription complexModelDescription = new ComplexTypeModelDescription\n {\n Name = ModelNameHelper.GetModelName(modelType),\n ModelType = modelType,\n Documentation = CreateDefaultDocumentation(modelType)\n };\n\n GeneratedModels.Add(complexModelDescription.Name, complexModelDescription);\n bool hasDataContractAttribute = modelType.GetCustomAttribute() != null;\n PropertyInfo[] properties = modelType.GetProperties(BindingFlags.Public | BindingFlags.Instance);\n foreach (PropertyInfo property in properties)\n {\n if (ShouldDisplayMember(property, hasDataContractAttribute))\n {\n ParameterDescription propertyModel = new ParameterDescription\n {\n Name = GetMemberName(property, hasDataContractAttribute)\n };\n\n if (DocumentationProvider != null)\n {\n propertyModel.Documentation = DocumentationProvider.GetDocumentation(property);\n }\n\n GenerateAnnotations(property, propertyModel);\n complexModelDescription.Properties.Add(propertyModel);\n propertyModel.TypeDescription = GetOrCreateModelDescription(property.PropertyType);\n }\n }\n\n FieldInfo[] fields = modelType.GetFields(BindingFlags.Public | BindingFlags.Instance);\n foreach (FieldInfo field in fields)\n {\n if (ShouldDisplayMember(field, hasDataContractAttribute))\n {\n ParameterDescription propertyModel = new ParameterDescription\n {\n Name = GetMemberName(field, hasDataContractAttribute)\n };\n\n if (DocumentationProvider != null)\n {\n propertyModel.Documentation = DocumentationProvider.GetDocumentation(field);\n }\n\n complexModelDescription.Properties.Add(propertyModel);\n propertyModel.TypeDescription = GetOrCreateModelDescription(field.FieldType);\n }\n }\n\n return complexModelDescription;\n }\n\n private DictionaryModelDescription GenerateDictionaryModelDescription(Type modelType, Type keyType, Type valueType)\n {\n ModelDescription keyModelDescription = GetOrCreateModelDescription(keyType);\n ModelDescription valueModelDescription = GetOrCreateModelDescription(valueType);\n\n return new DictionaryModelDescription\n {\n Name = ModelNameHelper.GetModelName(modelType),\n ModelType = modelType,\n KeyModelDescription = keyModelDescription,\n ValueModelDescription = valueModelDescription\n };\n }\n\n private EnumTypeModelDescription GenerateEnumTypeModelDescription(Type modelType)\n {\n EnumTypeModelDescription enumDescription = new EnumTypeModelDescription\n {\n Name = ModelNameHelper.GetModelName(modelType),\n ModelType = modelType,\n Documentation = CreateDefaultDocumentation(modelType)\n };\n bool hasDataContractAttribute = modelType.GetCustomAttribute() != null;\n foreach (FieldInfo field in modelType.GetFields(BindingFlags.Public | BindingFlags.Static))\n {\n if (ShouldDisplayMember(field, hasDataContractAttribute))\n {\n EnumValueDescription enumValue = new EnumValueDescription\n {\n Name = field.Name,\n Value = field.GetRawConstantValue().ToString()\n };\n if (DocumentationProvider != null)\n {\n enumValue.Documentation = DocumentationProvider.GetDocumentation(field);\n }\n enumDescription.Values.Add(enumValue);\n }\n }\n GeneratedModels.Add(enumDescription.Name, enumDescription);\n\n return enumDescription;\n }\n\n private KeyValuePairModelDescription GenerateKeyValuePairModelDescription(Type modelType, Type keyType, Type valueType)\n {\n ModelDescription keyModelDescription = GetOrCreateModelDescription(keyType);\n ModelDescription valueModelDescription = GetOrCreateModelDescription(valueType);\n\n return new KeyValuePairModelDescription\n {\n Name = ModelNameHelper.GetModelName(modelType),\n ModelType = modelType,\n KeyModelDescription = keyModelDescription,\n ValueModelDescription = valueModelDescription\n };\n }\n\n private ModelDescription GenerateSimpleTypeModelDescription(Type modelType)\n {\n SimpleTypeModelDescription simpleModelDescription = new SimpleTypeModelDescription\n {\n Name = ModelNameHelper.GetModelName(modelType),\n ModelType = modelType,\n Documentation = CreateDefaultDocumentation(modelType)\n };\n GeneratedModels.Add(simpleModelDescription.Name, simpleModelDescription);\n\n return simpleModelDescription;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/ModelDescriptions/ModelNameAttribute.cs",
"content": "using System;\n\nnamespace Sample.Areas.HelpPage.ModelDescriptions\n{\n /// \n /// Use this attribute to change the name of the generated for a type.\n /// \n [AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Enum, AllowMultiple = false, Inherited = false)]\n public sealed class ModelNameAttribute : Attribute\n {\n public ModelNameAttribute(string name)\n {\n Name = name;\n }\n\n public string Name { get; private set; }\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/ModelDescriptions/ModelNameHelper.cs",
"content": "using System;\nusing System.Globalization;\nusing System.Linq;\nusing System.Reflection;\n\nnamespace Sample.Areas.HelpPage.ModelDescriptions\n{\n internal static class ModelNameHelper\n {\n // Modify this to provide custom model name mapping.\n public static string GetModelName(Type type)\n {\n ModelNameAttribute modelNameAttribute = type.GetCustomAttribute();\n if (modelNameAttribute != null && !String.IsNullOrEmpty(modelNameAttribute.Name))\n {\n return modelNameAttribute.Name;\n }\n\n string modelName = type.Name;\n if (type.IsGenericType)\n {\n // Format the generic type name to something like: GenericOfAgurment1AndArgument2\n Type genericType = type.GetGenericTypeDefinition();\n Type[] genericArguments = type.GetGenericArguments();\n string genericTypeName = genericType.Name;\n\n // Trim the generic parameter counts from the name\n genericTypeName = genericTypeName.Substring(0, genericTypeName.IndexOf('`'));\n string[] argumentTypeNames = genericArguments.Select(t => GetModelName(t)).ToArray();\n modelName = String.Format(CultureInfo.InvariantCulture, \"{0}Of{1}\", genericTypeName, String.Join(\"And\", argumentTypeNames));\n }\n\n return modelName;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/ModelDescriptions/ParameterAnnotation.cs",
"content": "using System;\n\nnamespace Sample.Areas.HelpPage.ModelDescriptions\n{\n public class ParameterAnnotation\n {\n public Attribute AnnotationAttribute { get; set; }\n\n public string Documentation { get; set; }\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/ModelDescriptions/ParameterDescription.cs",
"content": "using System.Collections.Generic;\nusing System.Collections.ObjectModel;\n\nnamespace Sample.Areas.HelpPage.ModelDescriptions\n{\n public class ParameterDescription\n {\n public ParameterDescription()\n {\n Annotations = new Collection();\n }\n\n public Collection Annotations { get; private set; }\n\n public string Documentation { get; set; }\n\n public string Name { get; set; }\n\n public ModelDescription TypeDescription { get; set; }\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/ModelDescriptions/SimpleTypeModelDescription.cs",
"content": "namespace Sample.Areas.HelpPage.ModelDescriptions\n{\n public class SimpleTypeModelDescription : ModelDescription\n {\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/Models/HelpPageApiModel.cs",
"content": "using System.Collections.Generic;\nusing System.Collections.ObjectModel;\nusing System.Net.Http.Headers;\nusing System.Web.Http.Description;\nusing Sample.Areas.HelpPage.ModelDescriptions;\n\nnamespace Sample.Areas.HelpPage.Models\n{\n /// \n /// The model that represents an API displayed on the help page.\n /// \n public class HelpPageApiModel\n {\n /// \n /// Initializes a new instance of the class.\n /// \n public HelpPageApiModel()\n {\n UriParameters = new Collection();\n SampleRequests = new Dictionary();\n SampleResponses = new Dictionary();\n ErrorMessages = new Collection();\n }\n\n /// \n /// Gets or sets the that describes the API.\n /// \n public ApiDescription ApiDescription { get; set; }\n\n /// \n /// Gets or sets the collection that describes the URI parameters for the API.\n /// \n public Collection UriParameters { get; private set; }\n\n /// \n /// Gets or sets the documentation for the request.\n /// \n public string RequestDocumentation { get; set; }\n\n /// \n /// Gets or sets the that describes the request body.\n /// \n public ModelDescription RequestModelDescription { get; set; }\n\n /// \n /// Gets the request body parameter descriptions.\n /// \n public IList RequestBodyParameters\n {\n get\n {\n return GetParameterDescriptions(RequestModelDescription);\n }\n }\n\n /// \n /// Gets or sets the that describes the resource.\n /// \n public ModelDescription ResourceDescription { get; set; }\n\n /// \n /// Gets the resource property descriptions.\n /// \n public IList ResourceProperties\n {\n get\n {\n return GetParameterDescriptions(ResourceDescription);\n }\n }\n\n /// \n /// Gets the sample requests associated with the API.\n /// \n public IDictionary SampleRequests { get; private set; }\n\n /// \n /// Gets the sample responses associated with the API.\n /// \n public IDictionary SampleResponses { get; private set; }\n\n /// \n /// Gets the error messages associated with this model.\n /// \n public Collection ErrorMessages { get; private set; }\n\n private static IList GetParameterDescriptions(ModelDescription modelDescription)\n {\n ComplexTypeModelDescription complexTypeModelDescription = modelDescription as ComplexTypeModelDescription;\n if (complexTypeModelDescription != null)\n {\n return complexTypeModelDescription.Properties;\n }\n\n CollectionModelDescription collectionModelDescription = modelDescription as CollectionModelDescription;\n if (collectionModelDescription != null)\n {\n complexTypeModelDescription = collectionModelDescription.ElementDescription as ComplexTypeModelDescription;\n if (complexTypeModelDescription != null)\n {\n return complexTypeModelDescription.Properties;\n }\n }\n\n return null;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/SampleGeneration/HelpPageSampleGenerator.cs",
"content": "using System;\nusing System.Collections.Generic;\nusing System.Collections.ObjectModel;\nusing System.ComponentModel;\nusing System.Diagnostics.CodeAnalysis;\nusing System.Globalization;\nusing System.IO;\nusing System.Linq;\nusing System.Net.Http;\nusing System.Net.Http.Formatting;\nusing System.Net.Http.Headers;\nusing System.Web.Http.Description;\nusing System.Xml.Linq;\nusing Newtonsoft.Json;\n\nnamespace Sample.Areas.HelpPage\n{\n /// \n /// This class will generate the samples for the help page.\n /// \n public class HelpPageSampleGenerator\n {\n /// \n /// Initializes a new instance of the class.\n /// \n public HelpPageSampleGenerator()\n {\n ActualHttpMessageTypes = new Dictionary();\n ActionSamples = new Dictionary();\n SampleObjects = new Dictionary();\n SampleObjectFactories = new List>\n {\n DefaultSampleObjectFactory,\n };\n }\n\n /// \n /// Gets CLR types that are used as the content of or .\n /// \n public IDictionary ActualHttpMessageTypes { get; internal set; }\n\n /// \n /// Gets the objects that are used directly as samples for certain actions.\n /// \n public IDictionary ActionSamples { get; internal set; }\n\n /// \n /// Gets the objects that are serialized as samples by the supported formatters.\n /// \n public IDictionary SampleObjects { get; internal set; }\n\n /// \n /// Gets factories for the objects that the supported formatters will serialize as samples. Processed in order,\n /// stopping when the factory successfully returns a non- object.\n /// \n /// \n /// Collection includes just initially. Use\n /// SampleObjectFactories.Insert(0, func) to provide an override and\n /// SampleObjectFactories.Add(func) to provide a fallback.\n [SuppressMessage(\"Microsoft.Design\", \"CA1006:DoNotNestGenericTypesInMemberSignatures\",\n Justification = \"This is an appropriate nesting of generic types\")]\n public IList> SampleObjectFactories { get; private set; }\n\n /// \n /// Gets the request body samples for a given .\n /// \n /// The .\n /// The samples keyed by media type.\n public IDictionary GetSampleRequests(ApiDescription api)\n {\n return GetSample(api, SampleDirection.Request);\n }\n\n /// \n /// Gets the response body samples for a given .\n /// \n /// The .\n /// The samples keyed by media type.\n public IDictionary GetSampleResponses(ApiDescription api)\n {\n return GetSample(api, SampleDirection.Response);\n }\n\n /// \n /// Gets the request or response body samples.\n /// \n /// The .\n /// The value indicating whether the sample is for a request or for a response.\n /// The samples keyed by media type.\n public virtual IDictionary GetSample(ApiDescription api, SampleDirection sampleDirection)\n {\n if (api == null)\n {\n throw new ArgumentNullException(\"api\");\n }\n string controllerName = api.ActionDescriptor.ControllerDescriptor.ControllerName;\n string actionName = api.ActionDescriptor.ActionName;\n IEnumerable parameterNames = api.ParameterDescriptions.Select(p => p.Name);\n Collection formatters;\n Type type = ResolveType(api, controllerName, actionName, parameterNames, sampleDirection, out formatters);\n var samples = new Dictionary();\n\n // Use the samples provided directly for actions\n var actionSamples = GetAllActionSamples(controllerName, actionName, parameterNames, sampleDirection);\n foreach (var actionSample in actionSamples)\n {\n samples.Add(actionSample.Key.MediaType, WrapSampleIfString(actionSample.Value));\n }\n\n // Do the sample generation based on formatters only if an action doesn't return an HttpResponseMessage.\n // Here we cannot rely on formatters because we don't know what's in the HttpResponseMessage, it might not even use formatters.\n if (type != null && !typeof(HttpResponseMessage).IsAssignableFrom(type))\n {\n object sampleObject = GetSampleObject(type);\n foreach (var formatter in formatters)\n {\n foreach (MediaTypeHeaderValue mediaType in formatter.SupportedMediaTypes)\n {\n if (!samples.ContainsKey(mediaType))\n {\n object sample = GetActionSample(controllerName, actionName, parameterNames, type, formatter, mediaType, sampleDirection);\n\n // If no sample found, try generate sample using formatter and sample object\n if (sample == null && sampleObject != null)\n {\n sample = WriteSampleObjectUsingFormatter(formatter, sampleObject, type, mediaType);\n }\n\n samples.Add(mediaType, WrapSampleIfString(sample));\n }\n }\n }\n }\n\n return samples;\n }\n\n /// \n /// Search for samples that are provided directly through .\n /// \n /// Name of the controller.\n /// Name of the action.\n /// The parameter names.\n /// The CLR type.\n /// The formatter.\n /// The media type.\n /// The value indicating whether the sample is for a request or for a response.\n /// The sample that matches the parameters.\n public virtual object GetActionSample(string controllerName, string actionName, IEnumerable parameterNames, Type type, MediaTypeFormatter formatter, MediaTypeHeaderValue mediaType, SampleDirection sampleDirection)\n {\n object sample;\n\n // First, try to get the sample provided for the specified mediaType, sampleDirection, controllerName, actionName and parameterNames.\n // If not found, try to get the sample provided for the specified mediaType, sampleDirection, controllerName and actionName regardless of the parameterNames.\n // If still not found, try to get the sample provided for the specified mediaType and type.\n // Finally, try to get the sample provided for the specified mediaType.\n if (ActionSamples.TryGetValue(new HelpPageSampleKey(mediaType, sampleDirection, controllerName, actionName, parameterNames), out sample) ||\n ActionSamples.TryGetValue(new HelpPageSampleKey(mediaType, sampleDirection, controllerName, actionName, new[] { \"*\" }), out sample) ||\n ActionSamples.TryGetValue(new HelpPageSampleKey(mediaType, type), out sample) ||\n ActionSamples.TryGetValue(new HelpPageSampleKey(mediaType), out sample))\n {\n return sample;\n }\n\n return null;\n }\n\n /// \n /// Gets the sample object that will be serialized by the formatters. \n /// First, it will look at the . If no sample object is found, it will try to create\n /// one using (which wraps an ) and other\n /// factories in .\n /// \n /// The type.\n /// The sample object.\n [SuppressMessage(\"Microsoft.Design\", \"CA1031:DoNotCatchGeneralExceptionTypes\",\n Justification = \"Even if all items in SampleObjectFactories throw, problem will be visible as missing sample.\")]\n public virtual object GetSampleObject(Type type)\n {\n object sampleObject;\n\n if (!SampleObjects.TryGetValue(type, out sampleObject))\n {\n // No specific object available, try our factories.\n foreach (Func factory in SampleObjectFactories)\n {\n if (factory == null)\n {\n continue;\n }\n\n try\n {\n sampleObject = factory(this, type);\n if (sampleObject != null)\n {\n break;\n }\n }\n catch\n {\n // Ignore any problems encountered in the factory; go on to the next one (if any).\n }\n }\n }\n\n return sampleObject;\n }\n\n /// \n /// Resolves the actual type of passed to the in an action.\n /// \n /// The .\n /// The type.\n public virtual Type ResolveHttpRequestMessageType(ApiDescription api)\n {\n string controllerName = api.ActionDescriptor.ControllerDescriptor.ControllerName;\n string actionName = api.ActionDescriptor.ActionName;\n IEnumerable parameterNames = api.ParameterDescriptions.Select(p => p.Name);\n Collection formatters;\n return ResolveType(api, controllerName, actionName, parameterNames, SampleDirection.Request, out formatters);\n }\n\n /// \n /// Resolves the type of the action parameter or return value when or is used.\n /// \n /// The .\n /// Name of the controller.\n /// Name of the action.\n /// The parameter names.\n /// The value indicating whether the sample is for a request or a response.\n /// The formatters.\n [SuppressMessage(\"Microsoft.Design\", \"CA1021:AvoidOutParameters\", Justification = \"This is only used in advanced scenarios.\")]\n public virtual Type ResolveType(ApiDescription api, string controllerName, string actionName, IEnumerable parameterNames, SampleDirection sampleDirection, out Collection formatters)\n {\n if (!Enum.IsDefined(typeof(SampleDirection), sampleDirection))\n {\n throw new InvalidEnumArgumentException(\"sampleDirection\", (int)sampleDirection, typeof(SampleDirection));\n }\n if (api == null)\n {\n throw new ArgumentNullException(\"api\");\n }\n Type type;\n if (ActualHttpMessageTypes.TryGetValue(new HelpPageSampleKey(sampleDirection, controllerName, actionName, parameterNames), out type) ||\n ActualHttpMessageTypes.TryGetValue(new HelpPageSampleKey(sampleDirection, controllerName, actionName, new[] { \"*\" }), out type))\n {\n // Re-compute the supported formatters based on type\n Collection newFormatters = new Collection();\n foreach (var formatter in api.ActionDescriptor.Configuration.Formatters)\n {\n if (IsFormatSupported(sampleDirection, formatter, type))\n {\n newFormatters.Add(formatter);\n }\n }\n formatters = newFormatters;\n }\n else\n {\n switch (sampleDirection)\n {\n case SampleDirection.Request:\n ApiParameterDescription requestBodyParameter = api.ParameterDescriptions.FirstOrDefault(p => p.Source == ApiParameterSource.FromBody);\n type = requestBodyParameter == null ? null : requestBodyParameter.ParameterDescriptor.ParameterType;\n formatters = api.SupportedRequestBodyFormatters;\n break;\n case SampleDirection.Response:\n default:\n type = api.ResponseDescription.ResponseType ?? api.ResponseDescription.DeclaredType;\n formatters = api.SupportedResponseFormatters;\n break;\n }\n }\n\n return type;\n }\n\n /// \n /// Writes the sample object using formatter.\n /// \n /// The formatter.\n /// The value.\n /// The type.\n /// Type of the media.\n /// \n [SuppressMessage(\"Microsoft.Design\", \"CA1031:DoNotCatchGeneralExceptionTypes\", Justification = \"The exception is recorded as InvalidSample.\")]\n public virtual object WriteSampleObjectUsingFormatter(MediaTypeFormatter formatter, object value, Type type, MediaTypeHeaderValue mediaType)\n {\n if (formatter == null)\n {\n throw new ArgumentNullException(\"formatter\");\n }\n if (mediaType == null)\n {\n throw new ArgumentNullException(\"mediaType\");\n }\n\n object sample = String.Empty;\n MemoryStream ms = null;\n HttpContent content = null;\n try\n {\n if (formatter.CanWriteType(type))\n {\n ms = new MemoryStream();\n content = new ObjectContent(type, value, formatter, mediaType);\n formatter.WriteToStreamAsync(type, value, ms, content, null).Wait();\n ms.Position = 0;\n StreamReader reader = new StreamReader(ms);\n string serializedSampleString = reader.ReadToEnd();\n if (mediaType.MediaType.ToUpperInvariant().Contains(\"XML\"))\n {\n serializedSampleString = TryFormatXml(serializedSampleString);\n }\n else if (mediaType.MediaType.ToUpperInvariant().Contains(\"JSON\"))\n {\n serializedSampleString = TryFormatJson(serializedSampleString);\n }\n\n sample = new TextSample(serializedSampleString);\n }\n else\n {\n sample = new InvalidSample(String.Format(\n CultureInfo.CurrentCulture,\n \"Failed to generate the sample for media type '{0}'. Cannot use formatter '{1}' to write type '{2}'.\",\n mediaType,\n formatter.GetType().Name,\n type.Name));\n }\n }\n catch (Exception e)\n {\n sample = new InvalidSample(String.Format(\n CultureInfo.CurrentCulture,\n \"An exception has occurred while using the formatter '{0}' to generate sample for media type '{1}'. Exception message: {2}\",\n formatter.GetType().Name,\n mediaType.MediaType,\n UnwrapException(e).Message));\n }\n finally\n {\n if (ms != null)\n {\n ms.Dispose();\n }\n if (content != null)\n {\n content.Dispose();\n }\n }\n\n return sample;\n }\n\n internal static Exception UnwrapException(Exception exception)\n {\n AggregateException aggregateException = exception as AggregateException;\n if (aggregateException != null)\n {\n return aggregateException.Flatten().InnerException;\n }\n return exception;\n }\n\n // Default factory for sample objects\n private static object DefaultSampleObjectFactory(HelpPageSampleGenerator sampleGenerator, Type type)\n {\n // Try to create a default sample object\n ObjectGenerator objectGenerator = new ObjectGenerator();\n return objectGenerator.GenerateObject(type);\n }\n\n [SuppressMessage(\"Microsoft.Design\", \"CA1031:DoNotCatchGeneralExceptionTypes\", Justification = \"Handling the failure by returning the original string.\")]\n private static string TryFormatJson(string str)\n {\n try\n {\n object parsedJson = JsonConvert.DeserializeObject(str);\n return JsonConvert.SerializeObject(parsedJson, Formatting.Indented);\n }\n catch\n {\n // can't parse JSON, return the original string\n return str;\n }\n }\n\n [SuppressMessage(\"Microsoft.Design\", \"CA1031:DoNotCatchGeneralExceptionTypes\", Justification = \"Handling the failure by returning the original string.\")]\n private static string TryFormatXml(string str)\n {\n try\n {\n XDocument xml = XDocument.Parse(str);\n return xml.ToString();\n }\n catch\n {\n // can't parse XML, return the original string\n return str;\n }\n }\n\n private static bool IsFormatSupported(SampleDirection sampleDirection, MediaTypeFormatter formatter, Type type)\n {\n switch (sampleDirection)\n {\n case SampleDirection.Request:\n return formatter.CanReadType(type);\n case SampleDirection.Response:\n return formatter.CanWriteType(type);\n }\n return false;\n }\n\n private IEnumerable> GetAllActionSamples(string controllerName, string actionName, IEnumerable parameterNames, SampleDirection sampleDirection)\n {\n HashSet parameterNamesSet = new HashSet(parameterNames, StringComparer.OrdinalIgnoreCase);\n foreach (var sample in ActionSamples)\n {\n HelpPageSampleKey sampleKey = sample.Key;\n if (String.Equals(controllerName, sampleKey.ControllerName, StringComparison.OrdinalIgnoreCase) &&\n String.Equals(actionName, sampleKey.ActionName, StringComparison.OrdinalIgnoreCase) &&\n (sampleKey.ParameterNames.SetEquals(new[] { \"*\" }) || parameterNamesSet.SetEquals(sampleKey.ParameterNames)) &&\n sampleDirection == sampleKey.SampleDirection)\n {\n yield return sample;\n }\n }\n }\n\n private static object WrapSampleIfString(object sample)\n {\n string stringSample = sample as string;\n if (stringSample != null)\n {\n return new TextSample(stringSample);\n }\n\n return sample;\n }\n }\n}"
},
{
"path": "AlexaSkillsKit.Sample/Areas/HelpPage/SampleGeneration/HelpPageSampleKey.cs",
"content": "using System;\nusing System.Collections.Generic;\nusing System.ComponentModel;\nusing System.Net.Http.Headers;\n\nnamespace Sample.Areas.HelpPage\n{\n /// \n /// This is used to identify the place where the sample should be applied.\n /// \n public class HelpPageSampleKey\n {\n /// \n /// Creates a new based on media type.\n /// \n /// The media type.\n public HelpPageSampleKey(MediaTypeHeaderValue mediaType)\n {\n if (mediaType == null)\n {\n throw new ArgumentNullException(\"mediaType\");\n }\n\n ActionName = String.Empty;\n ControllerName = String.Empty;\n MediaType = mediaType;\n ParameterNames = new HashSet(StringComparer.OrdinalIgnoreCase);\n }\n\n /// \n /// Creates a new based on media type and CLR type.\n /// \n /// The media type.\n /// The CLR type.\n public HelpPageSampleKey(MediaTypeHeaderValue mediaType, Type type)\n : this(mediaType)\n {\n if (type == null)\n {\n throw new ArgumentNullException(\"type\");\n }\n\n ParameterType = type;\n }\n\n /// \n /// Creates a new based on , controller name, action name and parameter names.\n /// \n /// The .\n /// Name of the controller.\n /// Name of the action.\n /// The parameter names.\n public HelpPageSampleKey(SampleDirection sampleDirection, string controllerName, string actionName, IEnumerable parameterNames)\n {\n if (!Enum.IsDefined(typeof(SampleDirection), sampleDirection))\n {\n throw new InvalidEnumArgumentException(\"sampleDirection\", (int)sampleDirection, typeof(SampleDirection));\n }\n if (controllerName == null)\n {\n throw new ArgumentNullException(\"controllerName\");\n }\n if (actionName == null)\n {\n throw new ArgumentNullException(\"actionName\");\n }\n if (parameterNames == null)\n {\n throw new ArgumentNullException(\"parameterNames\");\n }\n\n ControllerName = controllerName;\n ActionName = actionName;\n ParameterNames = new HashSet(parameterNames, StringComparer.OrdinalIgnoreCase);\n SampleDirection = sampleDirection;\n }\n\n /// \n /// Creates a new