@microsoft/agents-hosting 0.1.49

package/dist/src/state/agentState.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { Storage, StorageKeyFactory } from '../storage/storage';
+import { TurnContext } from '../turnContext';
+import { AgentStatePropertyAccessor } from './agentStatePropertyAccesor';
+export interface CachedAgentState {
+    state: {
+        [id: string]: any;
+    };
+    hash: string;
+}
+/**
+ * Manages the state of an Agent.
+ */
+export declare class AgentState {
+    protected storage: Storage;
+    protected storageKey: StorageKeyFactory;
+    private readonly stateKey;
+    /**
+      * Creates a new instance of AgentState.
+      * @param storage The storage provider.
+      * @param storageKey The storage key factory.
+      */
+    constructor(storage: Storage, storageKey: StorageKeyFactory);
+    /**
+     * Creates a property accessor for the specified property.
+     * @param name The name of the property.
+     * @returns A property accessor for the specified property.
+     */
+    createProperty<T = any>(name: string): AgentStatePropertyAccessor<T>;
+    /**
+     * Loads the state from storage.
+     * @param context The turn context.
+     * @param force Whether to force loading the state.
+     * @returns A promise that resolves to the loaded state.
+     */
+    load(context: TurnContext, force?: boolean): Promise<any>;
+    /**
+     * Saves the state to storage.
+     * @param context The turn context.
+     * @param force Whether to force saving the state.
+     * @returns A promise that resolves when the save operation is complete.
+     */
+    saveChanges(context: TurnContext, force?: boolean): Promise<void>;
+    /**
+     * Clears the state from the turn context.
+     * @param context The turn context.
+     * @returns A promise that resolves when the clear operation is complete.
+     */
+    clear(context: TurnContext): Promise<void>;
+    /**
+     * Deletes the state from storage.
+     * @param context The turn context.
+     * @returns A promise that resolves when the delete operation is complete.
+     */
+    delete(context: TurnContext): Promise<void>;
+    /**
+     * Gets the state from the turn context.
+     * @param context The turn context.
+     * @returns The state, or undefined if the state is not found.
+     */
+    get(context: TurnContext): any | undefined;
+    /**
+     * Calculates the change hash for the specified item.
+     * @param item The item to calculate the hash for.
+     * @returns The calculated hash.
+     */
+    private readonly calculateChangeHash;
+}

package/dist/src/state/agentState.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentState = void 0;
+const node_crypto_1 = require("node:crypto");
+const agentStatePropertyAccesor_1 = require("./agentStatePropertyAccesor");
+const logger_1 = require("../logger");
+const logger = (0, logger_1.debug)('agents:state');
+/**
+ * Manages the state of an Agent.
+ */
+class AgentState {
+    /**
+      * Creates a new instance of AgentState.
+      * @param storage The storage provider.
+      * @param storageKey The storage key factory.
+      */
+    constructor(storage, storageKey) {
+        this.storage = storage;
+        this.storageKey = storageKey;
+        this.stateKey = Symbol('state');
+        /**
+         * Calculates the change hash for the specified item.
+         * @param item The item to calculate the hash for.
+         * @returns The calculated hash.
+         */
+        this.calculateChangeHash = (item) => {
+            const { eTag, ...rest } = item;
+            // TODO review circular json structure
+            const result = JSON.stringify(rest);
+            const hash = (0, node_crypto_1.createHash)('sha256', { encoding: 'utf-8' });
+            const hashed = hash.update(result).digest('hex');
+            return hashed;
+        };
+    }
+    /**
+     * Creates a property accessor for the specified property.
+     * @param name The name of the property.
+     * @returns A property accessor for the specified property.
+     */
+    createProperty(name) {
+        const prop = new agentStatePropertyAccesor_1.AgentStatePropertyAccessor(this, name);
+        return prop;
+    }
+    /**
+     * Loads the state from storage.
+     * @param context The turn context.
+     * @param force Whether to force loading the state.
+     * @returns A promise that resolves to the loaded state.
+     */
+    async load(context, force = false) {
+        const cached = context.turnState.get(this.stateKey);
+        if (force || !cached || !cached.state) {
+            const key = await this.storageKey(context);
+            logger.info(`Reading storage with key ${key}`);
+            const storedItem = await this.storage.read([key]);
+            const state = storedItem[key] || {};
+            const hash = this.calculateChangeHash(state);
+            context.turnState.set(this.stateKey, { state, hash });
+            return state;
+        }
+        return cached.state;
+    }
+    /**
+     * Saves the state to storage.
+     * @param context The turn context.
+     * @param force Whether to force saving the state.
+     * @returns A promise that resolves when the save operation is complete.
+     */
+    async saveChanges(context, force = false) {
+        let cached = context.turnState.get(this.stateKey);
+        if (force || (cached && cached.hash !== this.calculateChangeHash(cached === null || cached === void 0 ? void 0 : cached.state))) {
+            if (!cached) {
+                cached = { state: {}, hash: '' };
+            }
+            cached.state.eTag = '*';
+            const changes = {};
+            const key = await this.storageKey(context);
+            changes[key] = cached.state;
+            logger.info(`Writing storage with key ${key}`);
+            await this.storage.write(changes);
+            cached.hash = this.calculateChangeHash(cached.state);
+            context.turnState.set(this.stateKey, cached);
+        }
+    }
+    /**
+     * Clears the state from the turn context.
+     * @param context The turn context.
+     * @returns A promise that resolves when the clear operation is complete.
+     */
+    async clear(context) {
+        const emptyObjectToForceSave = { state: {}, hash: '' };
+        context.turnState.set(this.stateKey, emptyObjectToForceSave);
+    }
+    /**
+     * Deletes the state from storage.
+     * @param context The turn context.
+     * @returns A promise that resolves when the delete operation is complete.
+     */
+    async delete(context) {
+        if (context.turnState.has(this.stateKey)) {
+            context.turnState.delete(this.stateKey);
+        }
+        const key = await this.storageKey(context);
+        logger.info(`Deleting storage with key ${key}`);
+        await this.storage.delete([key]);
+    }
+    /**
+     * Gets the state from the turn context.
+     * @param context The turn context.
+     * @returns The state, or undefined if the state is not found.
+     */
+    get(context) {
+        const cached = context.turnState.get(this.stateKey);
+        return typeof cached === 'object' && typeof cached.state === 'object' ? cached.state : undefined;
+    }
+}
+exports.AgentState = AgentState;
+//# sourceMappingURL=agentState.js.map

package/dist/src/state/agentState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentState.js","sourceRoot":"","sources":["../../../src/state/agentState.ts"],"names":[],"mappings":"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"}

package/dist/src/state/agentStatePropertyAccesor.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { TurnContext } from '../turnContext';
+import { AgentState } from './agentState';
+/**
+ * Provides access to an Agent state property.
+ */
+export declare class AgentStatePropertyAccessor<T = any> {
+    protected readonly state: AgentState;
+    readonly name: string;
+    /**
+     * Creates a new instance of AgentStatePropertyAccessor.
+     * @param state The agent state.
+     * @param name The name of the property.
+     */
+    constructor(state: AgentState, name: string);
+    /**
+     * Deletes the property from the state.
+     * @param context The turn context.
+     * @returns A promise that resolves when the delete operation is complete.
+     */
+    delete(context: TurnContext): Promise<void>;
+    /**
+     * Gets the value of the property from the state.
+     * @param context The turn context.
+     * @param defaultValue The default value to return if the property is not found.
+     * @returns A promise that resolves to the value of the property.
+     */
+    get(context: TurnContext, defaultValue?: T): Promise<T>;
+    /**
+     * Sets the value of the property in the state.
+     * @param context The turn context.
+     * @param value The value to set.
+     * @returns A promise that resolves when the set operation is complete.
+     */
+    set(context: TurnContext, value: T): Promise<void>;
+}

package/dist/src/state/agentStatePropertyAccesor.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentStatePropertyAccessor = void 0;
+/**
+ * Provides access to an Agent state property.
+ */
+class AgentStatePropertyAccessor {
+    /**
+     * Creates a new instance of AgentStatePropertyAccessor.
+     * @param state The agent state.
+     * @param name The name of the property.
+     */
+    constructor(state, name) {
+        this.state = state;
+        this.name = name;
+    }
+    /**
+     * Deletes the property from the state.
+     * @param context The turn context.
+     * @returns A promise that resolves when the delete operation is complete.
+     */
+    async delete(context) {
+        const obj = await this.state.load(context);
+        if (Object.prototype.hasOwnProperty.call(obj, this.name)) {
+            delete obj[this.name];
+        }
+    }
+    /**
+     * Gets the value of the property from the state.
+     * @param context The turn context.
+     * @param defaultValue The default value to return if the property is not found.
+     * @returns A promise that resolves to the value of the property.
+     */
+    async get(context, defaultValue) {
+        const obj = await this.state.load(context);
+        if (!Object.prototype.hasOwnProperty.call(obj, this.name) && defaultValue !== undefined) {
+            const clone = typeof defaultValue === 'object' || Array.isArray(defaultValue)
+                ? JSON.parse(JSON.stringify(defaultValue))
+                : defaultValue;
+            obj[this.name] = clone;
+        }
+        return obj[this.name];
+    }
+    /**
+     * Sets the value of the property in the state.
+     * @param context The turn context.
+     * @param value The value to set.
+     * @returns A promise that resolves when the set operation is complete.
+     */
+    async set(context, value) {
+        const obj = await this.state.load(context);
+        obj[this.name] = value;
+    }
+}
+exports.AgentStatePropertyAccessor = AgentStatePropertyAccessor;
+//# sourceMappingURL=agentStatePropertyAccesor.js.map

package/dist/src/state/agentStatePropertyAccesor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentStatePropertyAccesor.js","sourceRoot":"","sources":["../../../src/state/agentStatePropertyAccesor.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAKH;;GAEG;AACH,MAAa,0BAA0B;IACrC;;;;OAIG;IACH,YAAgC,KAAiB,EAAkB,IAAY;QAA/C,UAAK,GAAL,KAAK,CAAY;QAAkB,SAAI,GAAJ,IAAI,CAAQ;IAAI,CAAC;IAEpF;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAE,OAAoB;QAChC,MAAM,GAAG,GAAQ,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/C,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAE,OAAoB,EAAE,YAAgB;QAC/C,MAAM,GAAG,GAAQ,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YACxF,MAAM,KAAK,GACT,OAAO,YAAY,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;gBAC7D,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;gBAC1C,CAAC,CAAC,YAAY,CAAA;YAClB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;QACxB,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAE,OAAoB,EAAE,KAAQ;QACvC,MAAM,GAAG,GAAQ,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/C,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;IACxB,CAAC;CACF;AAjDD,gEAiDC"}

package/dist/src/state/conversationState.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { AgentState } from './agentState';
+import { Storage } from '../storage/storage';
+/**
+ * Manages the state of a conversation.
+ */
+export declare class ConversationState extends AgentState {
+    private readonly namespace;
+    /**
+     * Creates a new instance of ConversationState.
+     * @param storage The storage provider.
+     */
+    constructor(storage: Storage, namespace?: string);
+    private getStorageKey;
+}

package/dist/src/state/conversationState.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationState = void 0;
+const agentState_1 = require("./agentState");
+/**
+ * Manages the state of a conversation.
+ */
+class ConversationState extends agentState_1.AgentState {
+    /**
+     * Creates a new instance of ConversationState.
+     * @param storage The storage provider.
+     */
+    constructor(storage, namespace = '') {
+        super(storage, (context) => {
+            const key = this.getStorageKey(context);
+            return key !== null && key !== void 0 ? key : new Error('ConversationState: overridden getStorageKey method did not return a key.');
+        });
+        this.namespace = namespace;
+    }
+    getStorageKey(context) {
+        const activity = context.activity;
+        const channelId = activity.channelId;
+        const conversationId = activity && (activity.conversation != null) && activity.conversation.id ? activity.conversation.id : undefined;
+        if (!channelId) {
+            throw new Error('missing activity.channelId');
+        }
+        if (!conversationId) {
+            throw new Error('missing activity.conversation.id');
+        }
+        return `${channelId}/conversations/${conversationId}/${this.namespace}`;
+    }
+}
+exports.ConversationState = ConversationState;
+//# sourceMappingURL=conversationState.js.map

package/dist/src/state/conversationState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationState.js","sourceRoot":"","sources":["../../../src/state/conversationState.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6CAAyC;AAKzC;;GAEG;AACH,MAAa,iBAAkB,SAAQ,uBAAU;IAC/C;;;OAGG;IACH,YAAa,OAAgB,EAAmB,YAAoB,EAAE;QACpE,KAAK,CAAC,OAAO,EAAE,CAAC,OAAoB,EAAE,EAAE;YACtC,MAAM,GAAG,GAAW,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;YAE/C,OAAO,GAAG,aAAH,GAAG,cAAH,GAAG,GAAI,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAA;QACrG,CAAC,CAAC,CAAA;QAL4C,cAAS,GAAT,SAAS,CAAa;IAMtE,CAAC;IAEO,aAAa,CAAE,OAAoB;QACzC,MAAM,QAAQ,GAAa,OAAO,CAAC,QAAQ,CAAA;QAC3C,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAA;QACpC,MAAM,cAAc,GAAG,QAAQ,IAAI,CAAC,QAAQ,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;QAErI,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;QAC/C,CAAC;QAED,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;QACrD,CAAC;QAED,OAAO,GAAG,SAAS,kBAAkB,cAAc,IAAI,IAAI,CAAC,SAAS,EAAE,CAAA;IACzE,CAAC;CACF;AA5BD,8CA4BC"}

package/dist/src/state/index.d.ts

@@ -0,0 +1,4 @@
+export * from './userState';
+export * from './conversationState';
+export * from './agentStatePropertyAccesor';
+export * from './agentState';

package/dist/src/state/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./userState"), exports);
+__exportStar(require("./conversationState"), exports);
+__exportStar(require("./agentStatePropertyAccesor"), exports);
+__exportStar(require("./agentState"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/state/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA2B;AAC3B,sDAAmC;AACnC,8DAA2C;AAC3C,+CAA4B"}

package/dist/src/state/userState.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { AgentState } from './agentState';
+import { Storage } from '../storage/storage';
+/**
+ * Manages the state of a user.
+ */
+export declare class UserState extends AgentState {
+    private readonly namespace;
+    /**
+      * Creates a new instance of UserState.
+      * @param storage The storage provider.
+      */
+    constructor(storage: Storage, namespace?: string);
+    private getStorageKey;
+}

package/dist/src/state/userState.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserState = void 0;
+const agentState_1 = require("./agentState");
+/**
+ * Manages the state of a user.
+ */
+class UserState extends agentState_1.AgentState {
+    /**
+      * Creates a new instance of UserState.
+      * @param storage The storage provider.
+      */
+    constructor(storage, namespace = '') {
+        super(storage, (context) => {
+            const key = this.getStorageKey(context);
+            return key !== null && key !== void 0 ? key : new Error('UserState: overridden getStorageKey method did not return a key.');
+        });
+        this.namespace = namespace;
+    }
+    getStorageKey(context) {
+        const activity = context.activity;
+        const channelId = activity.channelId;
+        const userId = activity && (activity.from != null) && activity.from.id ? activity.from.id : undefined;
+        if (!channelId) {
+            throw new Error('missing activity.channelId');
+        }
+        if (!userId) {
+            throw new Error('missing activity.from.id');
+        }
+        return `${channelId}/users/${userId}/${this.namespace}`;
+    }
+}
+exports.UserState = UserState;
+//# sourceMappingURL=userState.js.map

package/dist/src/state/userState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userState.js","sourceRoot":"","sources":["../../../src/state/userState.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6CAAyC;AAKzC;;GAEG;AACH,MAAa,SAAU,SAAQ,uBAAU;IACvC;;;QAGI;IACJ,YAAa,OAAgB,EAAmB,YAAoB,EAAE;QACpE,KAAK,CAAC,OAAO,EAAE,CAAC,OAAoB,EAAE,EAAE;YACtC,MAAM,GAAG,GAAW,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;YAE/C,OAAO,GAAG,aAAH,GAAG,cAAH,GAAG,GAAI,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAA;QAC7F,CAAC,CAAC,CAAA;QAL4C,cAAS,GAAT,SAAS,CAAa;IAMtE,CAAC;IAEO,aAAa,CAAE,OAAoB;QACzC,MAAM,QAAQ,GAAa,OAAO,CAAC,QAAQ,CAAA;QAE3C,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAA;QACpC,MAAM,MAAM,GAAG,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;QAErG,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;QAC/C,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;QAC7C,CAAC;QAED,OAAO,GAAG,SAAS,UAAU,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAA;IACzD,CAAC;CACF;AA7BD,8BA6BC"}

package/dist/src/statusCodes.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export declare enum StatusCodes {
+    OK = 200,
+    CREATED = 201,
+    MULTIPLE_CHOICES = 300,
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    NOT_FOUND = 404,
+    METHOD_NOT_ALLOWED = 405,
+    CONFLICT = 409,
+    PRECONDITION_FAILED = 412,
+    UPGRADE_REQUIRED = 426,
+    INTERNAL_SERVER_ERROR = 500,
+    NOT_IMPLEMENTED = 501,
+    BAD_GATEWAY = 502
+}

package/dist/src/statusCodes.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatusCodes = void 0;
+var StatusCodes;
+(function (StatusCodes) {
+    StatusCodes[StatusCodes["OK"] = 200] = "OK";
+    StatusCodes[StatusCodes["CREATED"] = 201] = "CREATED";
+    StatusCodes[StatusCodes["MULTIPLE_CHOICES"] = 300] = "MULTIPLE_CHOICES";
+    StatusCodes[StatusCodes["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+    StatusCodes[StatusCodes["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+    StatusCodes[StatusCodes["NOT_FOUND"] = 404] = "NOT_FOUND";
+    StatusCodes[StatusCodes["METHOD_NOT_ALLOWED"] = 405] = "METHOD_NOT_ALLOWED";
+    StatusCodes[StatusCodes["CONFLICT"] = 409] = "CONFLICT";
+    StatusCodes[StatusCodes["PRECONDITION_FAILED"] = 412] = "PRECONDITION_FAILED";
+    StatusCodes[StatusCodes["UPGRADE_REQUIRED"] = 426] = "UPGRADE_REQUIRED";
+    StatusCodes[StatusCodes["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+    StatusCodes[StatusCodes["NOT_IMPLEMENTED"] = 501] = "NOT_IMPLEMENTED";
+    StatusCodes[StatusCodes["BAD_GATEWAY"] = 502] = "BAD_GATEWAY";
+})(StatusCodes || (exports.StatusCodes = StatusCodes = {}));
+//# sourceMappingURL=statusCodes.js.map

package/dist/src/statusCodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusCodes.js","sourceRoot":"","sources":["../../src/statusCodes.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,IAAY,WAcX;AAdD,WAAY,WAAW;IACrB,2CAAQ,CAAA;IACR,qDAAa,CAAA;IACb,uEAAsB,CAAA;IACtB,6DAAiB,CAAA;IACjB,+DAAkB,CAAA;IAClB,yDAAe,CAAA;IACf,2EAAwB,CAAA;IACxB,uDAAc,CAAA;IACd,6EAAyB,CAAA;IACzB,uEAAsB,CAAA;IACtB,iFAA2B,CAAA;IAC3B,qEAAqB,CAAA;IACrB,6DAAiB,CAAA;AACnB,CAAC,EAdW,WAAW,2BAAX,WAAW,QActB"}

package/dist/src/storage/index.d.ts

@@ -0,0 +1,2 @@
+export * from './storage';
+export * from './memoryStorage';

package/dist/src/storage/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./storage"), exports);
+__exportStar(require("./memoryStorage"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/storage/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAAyB;AACzB,kDAA+B"}

package/dist/src/storage/memoryStorage.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { Storage, StoreItem } from './storage';
+/**
+ * A simple in-memory storage provider.
+ */
+export declare class MemoryStorage implements Storage {
+    private memory;
+    private static instance;
+    private etag;
+    /**
+     * Creates a new instance of the MemoryStorage class.
+     * @param memory An optional initial memory store.
+     */
+    constructor(memory?: {
+        [k: string]: string;
+    });
+    /**
+     * Gets a single instance of the MemoryStorage class.
+     */
+    static getSingleInstance(): MemoryStorage;
+    /**
+     * Reads storage items from memory.
+     * @param keys The keys of the items to read.
+     * @returns A promise that resolves to the read items.
+     * @throws Will throw an error if keys are not provided.
+     */
+    read(keys: string[]): Promise<StoreItem>;
+    /**
+     * Writes storage items to memory.
+     * @param changes The items to write.
+     * @returns A promise that resolves when the write operation is complete.
+     * @throws Will throw an error if changes are not provided.
+     */
+    write(changes: StoreItem): Promise<void>;
+    /**
+     * Deletes storage items from memory.
+     * @param keys The keys of the items to delete.
+     * @returns A promise that resolves when the delete operation is complete.
+     */
+    delete(keys: string[]): Promise<void>;
+    /**
+     * Saves an item to memory.
+     * @param key The key of the item to save.
+     * @param item The item to save.
+     */
+    private saveItem;
+}