@aws-amplify/interactions 5.2.12-api-v6-models.b3abc9b.0 → 6.0.1-api-v6-models.572a7b5.0

package/README.md

@@ -0,0 +1,3 @@
+> INTERNAL USE ONLY
+
+This package contains the AWS Amplify Interactions category and is intended for internal use only. To integrate Amplify into your app, please use [aws-amplify](https://www.npmjs.com/package/aws-amplify).

package/lex-v1/package.json

@@ -0,0 +1,7 @@
+{
+	"name": "@aws-amplify/interactions/lex-v1",
+	"main": "../lib/lex-v1/index.js",
+	"browser": "../lib-esm/lex-v1/index.js",
+	"module": "../lib-esm/lex-v1/index.js",
+	"typings": "../lib-esm/lex-v1/index.d.ts"
+}

package/lex-v2/package.json

@@ -0,0 +1,7 @@
+{
+	"name": "@aws-amplify/interactions/lex-v2",
+	"main": "../lib/lex-v2/index.js",
+	"browser": "../lib-esm/lex-v2/index.js",
+	"module": "../lib-esm/lex-v2/index.js",
+	"typings": "../lib-esm/lex-v2/index.d.ts"
+}

package/lib/errors/InteractionsError.d.ts

@@ -0,0 +1,4 @@
+import { AmplifyError, AmplifyErrorParams } from '@aws-amplify/core/internals/utils';
+export declare class InteractionsError extends AmplifyError {
+    constructor(params: AmplifyErrorParams);
+}

package/lib/errors/InteractionsError.js

@@ -0,0 +1,20 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InteractionsError = void 0;
+var tslib_1 = require("tslib");
+var utils_1 = require("@aws-amplify/core/internals/utils");
+var InteractionsError = /** @class */ (function (_super) {
+    tslib_1.__extends(InteractionsError, _super);
+    function InteractionsError(params) {
+        var _this = _super.call(this, params) || this;
+        // Hack for making the custom error class work when transpiled to es5
+        // TODO: Delete the following 2 lines after we change the build target to >= es2015
+        _this.constructor = InteractionsError;
+        Object.setPrototypeOf(_this, InteractionsError.prototype);
+        return _this;
+    }
+    return InteractionsError;
+}(utils_1.AmplifyError));
+exports.InteractionsError = InteractionsError;

package/lib/errors/assertValidationError.d.ts

@@ -0,0 +1,2 @@
+import { InteractionsValidationErrorCode } from './validation';
+export declare function assertValidationError(assertion: boolean, name: InteractionsValidationErrorCode, message?: string): asserts assertion;

package/lib/errors/assertValidationError.js

@@ -0,0 +1,18 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertValidationError = void 0;
+var validation_1 = require("./validation");
+var InteractionsError_1 = require("./InteractionsError");
+function assertValidationError(assertion, name, message) {
+    if (!assertion) {
+        var _a = validation_1.validationErrorMap[name], defaultMessage = _a.message, recoverySuggestion = _a.recoverySuggestion;
+        throw new InteractionsError_1.InteractionsError({
+            name: name,
+            message: message !== null && message !== void 0 ? message : defaultMessage,
+            recoverySuggestion: recoverySuggestion,
+        });
+    }
+}
+exports.assertValidationError = assertValidationError;

package/lib/errors/index.d.ts

@@ -0,0 +1,2 @@
+export { assertValidationError } from './assertValidationError';
+export { InteractionsValidationErrorCode } from './validation';

package/lib/errors/index.js

@@ -0,0 +1,9 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InteractionsValidationErrorCode = exports.assertValidationError = void 0;
+var assertValidationError_1 = require("./assertValidationError");
+Object.defineProperty(exports, "assertValidationError", { enumerable: true, get: function () { return assertValidationError_1.assertValidationError; } });
+var validation_1 = require("./validation");
+Object.defineProperty(exports, "InteractionsValidationErrorCode", { enumerable: true, get: function () { return validation_1.InteractionsValidationErrorCode; } });

package/lib/errors/validation.d.ts

@@ -0,0 +1,5 @@
+import { AmplifyErrorMap } from '@aws-amplify/core/internals/utils';
+export declare enum InteractionsValidationErrorCode {
+    NoBotConfig = "NoBotConfig"
+}
+export declare const validationErrorMap: AmplifyErrorMap<InteractionsValidationErrorCode>;

package/lib/errors/validation.js

@@ -0,0 +1,15 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validationErrorMap = exports.InteractionsValidationErrorCode = void 0;
+var InteractionsValidationErrorCode;
+(function (InteractionsValidationErrorCode) {
+    InteractionsValidationErrorCode["NoBotConfig"] = "NoBotConfig";
+})(InteractionsValidationErrorCode || (exports.InteractionsValidationErrorCode = InteractionsValidationErrorCode = {}));
+exports.validationErrorMap = (_a = {},
+    _a[InteractionsValidationErrorCode.NoBotConfig] = {
+        message: 'Missing configuration for the bot',
+    },
+    _a);

package/lib/index.d.ts

@@ -1,5 +1,2 @@
-export { Interactions } from './Interactions';
-export * from './types';
-export { AbstractInteractionsProvider } from './Providers/InteractionsProvider';
-export { AWSLexProvider } from './Providers/AWSLexProvider';
-export { AWSLexV2Provider } from './Providers/AWSLexV2Provider';
+export { InteractionsMessage, InteractionsResponse, InteractionsVoiceMessage, InteractionsTextMessage, CompletionCallback, } from './types';
+export { Interactions } from './lex-v2';

package/lib/index.js

@@ -2,12 +2,6 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
 Object.defineProperty(exports, "__esModule", { value: true });
-var Interactions_1 = require("./Interactions");
-exports.Interactions = Interactions_1.Interactions;
-var InteractionsProvider_1 = require("./Providers/InteractionsProvider");
-exports.AbstractInteractionsProvider = InteractionsProvider_1.AbstractInteractionsProvider;
-var AWSLexProvider_1 = require("./Providers/AWSLexProvider");
-exports.AWSLexProvider = AWSLexProvider_1.AWSLexProvider;
-var AWSLexV2Provider_1 = require("./Providers/AWSLexV2Provider");
-exports.AWSLexV2Provider = AWSLexV2Provider_1.AWSLexV2Provider;
-//# sourceMappingURL=index.js.map
+exports.Interactions = void 0;
+var lex_v2_1 = require("./lex-v2");
+Object.defineProperty(exports, "Interactions", { enumerable: true, get: function () { return lex_v2_1.Interactions; } });

package/lib/lex-v1/AWSLexProvider.d.ts

@@ -0,0 +1,20 @@
+import { CompletionCallback, InteractionsMessage, InteractionsResponse } from '../types';
+import { PostContentCommandOutput, PostTextCommandOutput } from '@aws-sdk/client-lex-runtime-service';
+import { AWSLexProviderOption } from './types';
+interface PostContentCommandOutputFormatted extends Omit<PostContentCommandOutput, 'audioStream'> {
+    audioStream?: Uint8Array;
+}
+type AWSLexProviderSendResponse = PostTextCommandOutput | PostContentCommandOutputFormatted;
+declare class AWSLexProvider {
+    private readonly _botsCompleteCallback;
+    /**
+     * @deprecated
+     * This is used internally by 'sendMessage' to call onComplete callback
+     * for a bot if configured
+     */
+    reportBotStatus(data: AWSLexProviderSendResponse, { name }: AWSLexProviderOption): void;
+    sendMessage(botConfig: AWSLexProviderOption, message: string | InteractionsMessage): Promise<InteractionsResponse>;
+    onComplete({ name }: AWSLexProviderOption, callback: CompletionCallback): void;
+}
+export declare const lexProvider: AWSLexProvider;
+export {};

package/lib/lex-v1/AWSLexProvider.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lexProvider = void 0;
+var tslib_1 = require("tslib");
+var client_lex_runtime_service_1 = require("@aws-sdk/client-lex-runtime-service");
+var utils_1 = require("@aws-amplify/core/internals/utils");
+var core_1 = require("@aws-amplify/core");
+var utils_2 = require("../utils");
+var logger = new core_1.ConsoleLogger('AWSLexProvider');
+var AWSLexProvider = /** @class */ (function () {
+    function AWSLexProvider() {
+        this._botsCompleteCallback = {};
+    }
+    /**
+     * @deprecated
+     * This is used internally by 'sendMessage' to call onComplete callback
+     * for a bot if configured
+     */
+    AWSLexProvider.prototype.reportBotStatus = function (data, _a) {
+        var name = _a.name;
+        var callback = this._botsCompleteCallback[name];
+        if (!callback) {
+            return;
+        }
+        // Check if state is fulfilled to resolve onFullfilment promise
+        logger.debug('postContent state', data.dialogState);
+        switch (data.dialogState) {
+            case client_lex_runtime_service_1.DialogState.READY_FOR_FULFILLMENT:
+            case client_lex_runtime_service_1.DialogState.FULFILLED:
+                callback(undefined, data);
+                break;
+            case client_lex_runtime_service_1.DialogState.FAILED:
+                callback(new Error('Bot conversation failed'));
+                break;
+            default:
+                break;
+        }
+    };
+    AWSLexProvider.prototype.sendMessage = function (botConfig, message) {
+        return tslib_1.__awaiter(this, void 0, void 0, function () {
+            var session, error_1, name, region, alias, client, params, postTextCommand, data, err_1, content, messageType, inputStream, _a, postContentCommand, data, audioArray, _b, response, err_2;
+            return tslib_1.__generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        _c.trys.push([0, 2, , 3]);
+                        return [4 /*yield*/, (0, core_1.fetchAuthSession)()];
+                    case 1:
+                        session = _c.sent();
+                        return [3 /*break*/, 3];
+                    case 2:
+                        error_1 = _c.sent();
+                        return [2 /*return*/, Promise.reject('No credentials')];
+                    case 3:
+                        name = botConfig.name, region = botConfig.region, alias = botConfig.alias;
+                        client = new client_lex_runtime_service_1.LexRuntimeServiceClient({
+                            region: region,
+                            credentials: session.credentials,
+                            customUserAgent: (0, utils_1.getAmplifyUserAgentObject)(),
+                        });
+                        if (!(typeof message === 'string')) return [3 /*break*/, 8];
+                        params = {
+                            botAlias: alias,
+                            botName: name,
+                            inputText: message,
+                            userId: session.identityId,
+                        };
+                        logger.debug('postText to lex', message);
+                        _c.label = 4;
+                    case 4:
+                        _c.trys.push([4, 6, , 7]);
+                        postTextCommand = new client_lex_runtime_service_1.PostTextCommand(params);
+                        return [4 /*yield*/, client.send(postTextCommand)];
+                    case 5:
+                        data = _c.sent();
+                        this.reportBotStatus(data, botConfig);
+                        return [2 /*return*/, data];
+                    case 6:
+                        err_1 = _c.sent();
+                        return [2 /*return*/, Promise.reject(err_1)];
+                    case 7: return [3 /*break*/, 20];
+                    case 8:
+                        content = message.content, messageType = message.options.messageType;
+                        if (!(messageType === 'voice')) return [3 /*break*/, 12];
+                        if (typeof content !== 'object') {
+                            return [2 /*return*/, Promise.reject('invalid content type')];
+                        }
+                        if (!(content instanceof Uint8Array)) return [3 /*break*/, 9];
+                        _a = content;
+                        return [3 /*break*/, 11];
+                    case 9: return [4 /*yield*/, (0, utils_2.convert)(content)];
+                    case 10:
+                        _a = _c.sent();
+                        _c.label = 11;
+                    case 11:
+                        inputStream = _a;
+                        params = {
+                            botAlias: alias,
+                            botName: name,
+                            contentType: 'audio/x-l16; sample-rate=16000; channel-count=1',
+                            userId: session.identityId,
+                            accept: 'audio/mpeg',
+                            inputStream: inputStream,
+                        };
+                        return [3 /*break*/, 13];
+                    case 12:
+                        if (typeof content !== 'string')
+                            return [2 /*return*/, Promise.reject('invalid content type')];
+                        params = {
+                            botAlias: alias,
+                            botName: name,
+                            contentType: 'text/plain; charset=utf-8',
+                            inputStream: content,
+                            userId: session.identityId,
+                            accept: 'audio/mpeg',
+                        };
+                        _c.label = 13;
+                    case 13:
+                        logger.debug('postContent to lex', message);
+                        _c.label = 14;
+                    case 14:
+                        _c.trys.push([14, 19, , 20]);
+                        postContentCommand = new client_lex_runtime_service_1.PostContentCommand(params);
+                        return [4 /*yield*/, client.send(postContentCommand)];
+                    case 15:
+                        data = _c.sent();
+                        if (!data.audioStream) return [3 /*break*/, 17];
+                        return [4 /*yield*/, (0, utils_2.convert)(data.audioStream)];
+                    case 16:
+                        _b = _c.sent();
+                        return [3 /*break*/, 18];
+                    case 17:
+                        _b = undefined;
+                        _c.label = 18;
+                    case 18:
+                        audioArray = _b;
+                        response = tslib_1.__assign(tslib_1.__assign({}, data), { audioStream: audioArray });
+                        this.reportBotStatus(response, botConfig);
+                        return [2 /*return*/, response];
+                    case 19:
+                        err_2 = _c.sent();
+                        return [2 /*return*/, Promise.reject(err_2)];
+                    case 20: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    AWSLexProvider.prototype.onComplete = function (_a, callback) {
+        var name = _a.name;
+        this._botsCompleteCallback[name] = callback;
+    };
+    return AWSLexProvider;
+}());
+exports.lexProvider = new AWSLexProvider();

package/lib/lex-v1/apis/index.d.ts

@@ -0,0 +1,2 @@
+export { send } from './send';
+export { onComplete } from './onComplete';

package/lib/lex-v1/apis/index.js

@@ -0,0 +1,9 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onComplete = exports.send = void 0;
+var send_1 = require("./send");
+Object.defineProperty(exports, "send", { enumerable: true, get: function () { return send_1.send; } });
+var onComplete_1 = require("./onComplete");
+Object.defineProperty(exports, "onComplete", { enumerable: true, get: function () { return onComplete_1.onComplete; } });

package/lib/lex-v1/apis/onComplete.d.ts

@@ -0,0 +1,2 @@
+import { CompletionCallback } from '../../types';
+export declare const onComplete: (botName: string, callback: CompletionCallback) => void;

package/lib/lex-v1/apis/onComplete.js

@@ -0,0 +1,14 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onComplete = void 0;
+var utils_1 = require("../utils");
+var AWSLexProvider_1 = require("../AWSLexProvider");
+var errors_1 = require("../../errors");
+var onComplete = function (botName, callback) {
+    var botConfig = (0, utils_1.resolveBotConfig)(botName);
+    (0, errors_1.assertValidationError)(!!botConfig, errors_1.InteractionsValidationErrorCode.NoBotConfig, "Bot ".concat(botName, " does not exist."));
+    AWSLexProvider_1.lexProvider.onComplete(botConfig, callback);
+};
+exports.onComplete = onComplete;

package/lib/lex-v1/apis/send.d.ts

@@ -0,0 +1,2 @@
+import { InteractionsMessage, InteractionsResponse } from '../../types';
+export declare const send: (botName: string, message: string | InteractionsMessage) => Promise<InteractionsResponse>;

package/lib/lex-v1/apis/send.js

@@ -0,0 +1,18 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.send = void 0;
+var tslib_1 = require("tslib");
+var utils_1 = require("../utils");
+var AWSLexProvider_1 = require("../AWSLexProvider");
+var errors_1 = require("../../errors");
+var send = function (botName, message) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+    var botConfig;
+    return tslib_1.__generator(this, function (_a) {
+        botConfig = (0, utils_1.resolveBotConfig)(botName);
+        (0, errors_1.assertValidationError)(!!botConfig, errors_1.InteractionsValidationErrorCode.NoBotConfig, "Bot ".concat(botName, " does not exist."));
+        return [2 /*return*/, AWSLexProvider_1.lexProvider.sendMessage(botConfig, message)];
+    });
+}); };
+exports.send = send;

package/lib/lex-v1/index.d.ts

@@ -0,0 +1,5 @@
+import { IInteractions } from '../types/Interactions';
+/**
+ * @deprecated recommend to migrate to AWS Lex V2 instead
+ * */
+export declare const Interactions: IInteractions;

package/lib/lex-v1/index.js

@@ -0,0 +1,13 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Interactions = void 0;
+var apis_1 = require("./apis");
+/**
+ * @deprecated recommend to migrate to AWS Lex V2 instead
+ * */
+exports.Interactions = {
+    send: apis_1.send,
+    onComplete: apis_1.onComplete,
+};

package/lib/lex-v1/types/AWSLexProviderOption.d.ts

@@ -0,0 +1,5 @@
+export interface AWSLexProviderOption {
+    name: string;
+    alias: string;
+    region: string;
+}

package/lib/lex-v1/types/AWSLexProviderOption.js

@@ -0,0 +1,4 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/lex-v1/types/index.d.ts

@@ -0,0 +1 @@
+export { AWSLexProviderOption } from './AWSLexProviderOption';

package/lib/lex-v1/types/index.js

@@ -0,0 +1,4 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/lex-v1/utils/index.d.ts

@@ -0,0 +1 @@
+export { resolveBotConfig } from './resolveBotConfig';

package/lib/lex-v1/utils/index.js

@@ -0,0 +1,7 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveBotConfig = void 0;
+var resolveBotConfig_1 = require("./resolveBotConfig");
+Object.defineProperty(exports, "resolveBotConfig", { enumerable: true, get: function () { return resolveBotConfig_1.resolveBotConfig; } });

package/lib/lex-v1/utils/resolveBotConfig.d.ts

@@ -0,0 +1,2 @@
+import { AWSLexProviderOption } from '../types';
+export declare const resolveBotConfig: (botName: string) => AWSLexProviderOption | undefined;

package/lib/lex-v1/utils/resolveBotConfig.js

@@ -0,0 +1,15 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveBotConfig = void 0;
+var tslib_1 = require("tslib");
+var core_1 = require("@aws-amplify/core");
+var resolveBotConfig = function (botName) {
+    var _a, _b;
+    var _c = (_b = (_a = core_1.Amplify.getConfig().Interactions) === null || _a === void 0 ? void 0 : _a.LexV1) !== null && _b !== void 0 ? _b : {}, _d = botName, _e = _c[_d], botConfig = _e === void 0 ? undefined : _e;
+    if (botConfig !== undefined) {
+        return tslib_1.__assign(tslib_1.__assign({}, botConfig), { name: botName });
+    }
+};
+exports.resolveBotConfig = resolveBotConfig;

package/lib/lex-v2/AWSLexV2Provider.d.ts

@@ -0,0 +1,52 @@
+import { CompletionCallback, InteractionsMessage, InteractionsResponse } from '../types';
+import { RecognizeTextCommandOutput, RecognizeUtteranceCommandOutput } from '@aws-sdk/client-lex-runtime-v2';
+import { AWSLexV2ProviderOption } from './types';
+interface RecognizeUtteranceCommandOutputFormatted extends Omit<RecognizeUtteranceCommandOutput, 'messages' | 'interpretations' | 'sessionState' | 'requestAttributes' | 'audioStream'> {
+    messages?: RecognizeTextCommandOutput['messages'];
+    sessionState?: RecognizeTextCommandOutput['sessionState'];
+    interpretations?: RecognizeTextCommandOutput['interpretations'];
+    requestAttributes?: RecognizeTextCommandOutput['requestAttributes'];
+    audioStream?: Uint8Array;
+}
+type AWSLexV2ProviderSendResponse = RecognizeTextCommandOutput | RecognizeUtteranceCommandOutputFormatted;
+declare class AWSLexV2Provider {
+    private readonly _botsCompleteCallback;
+    private defaultSessionId;
+    /**
+     * Send a message to a bot
+     * @async
+     * @param {AWSLexV2ProviderOption} botConfig - Bot configuration for sending the message
+     * @param {string | InteractionsMessage} message - message to send to the bot
+     * @return {Promise<InteractionsResponse>} A promise resolves to the response from the bot
+     */
+    sendMessage(botConfig: AWSLexV2ProviderOption, message: string | InteractionsMessage): Promise<InteractionsResponse>;
+    /**
+     * Attach a onComplete callback function to a bot.
+     * The callback is called once the bot's intent is fulfilled
+     * @param {AWSLexV2ProviderOption} botConfig - Bot configuration to attach the onComplete callback
+     * @param {CompletionCallback} callback - called when Intent Fulfilled
+     */
+    onComplete({ name }: AWSLexV2ProviderOption, callback: CompletionCallback): void;
+    /**
+     * call onComplete callback for a bot if configured
+     */
+    _reportBotStatus(data: AWSLexV2ProviderSendResponse, { name }: AWSLexV2ProviderOption): void;
+    /**
+     * Format UtteranceCommandOutput's response
+     * decompress attributes
+     * update audioStream format
+     */
+    private _formatUtteranceCommandOutput;
+    /**
+     * handle client's `RecognizeTextCommand`
+     * used for sending simple text message
+     */
+    private _handleRecognizeTextCommand;
+    /**
+     * handle client's `RecognizeUtteranceCommand`
+     * used for obj text or obj voice message
+     */
+    private _handleRecognizeUtteranceCommand;
+}
+export declare const lexProvider: AWSLexV2Provider;
+export {};