@goldstack/template-dynamodb 0.3.34 → 0.3.36

package/dist/src/local/config.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Configuration options for local DynamoDB instances
+ */
+export interface DynamoDBConfig {
+    /** Port to use for the DynamoDB instance */
+    port: number;
+    /** Region to use for the DynamoDB client */
+    region: string;
+    /** Credentials for local DynamoDB access */
+    credentials: {
+        accessKeyId: string;
+        secretAccessKey: string;
+    };
+}
+/**
+ * Default configuration for local DynamoDB instances
+ */
+export declare const defaultConfig: DynamoDBConfig;
+/**
+ * Gets the endpoint URL for a DynamoDB instance
+ */
+export declare function getEndpointUrl(port: number): string;
+/**
+ * Checks if we are running in a Jest test environment
+ */
+export declare function isTestEnvironment(): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/local/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/local/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,WAAW,EAAE;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,cAO3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}

package/dist/src/local/config.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultConfig = void 0;
+exports.getEndpointUrl = getEndpointUrl;
+exports.isTestEnvironment = isTestEnvironment;
+/**
+ * Default configuration for local DynamoDB instances
+ */
+exports.defaultConfig = {
+    port: parseInt(process.env.DYNAMODB_LOCAL_PORT || '8000'),
+    region: 'eu-central-1',
+    credentials: {
+        accessKeyId: 'dummy',
+        secretAccessKey: 'dummy',
+    },
+};
+/**
+ * Gets the endpoint URL for a DynamoDB instance
+ */
+function getEndpointUrl(port) {
+    return `http://127.0.0.1:${port}`;
+}
+/**
+ * Checks if we are running in a Jest test environment
+ */
+function isTestEnvironment() {
+    return process.env.JEST_WORKER_ID !== undefined;
+}
+//# sourceMappingURL=config.js.map

package/dist/src/local/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/local/config.ts"],"names":[],"mappings":";;;AA8BA,wCAEC;AAKD,8CAEC;AAxBD;;GAEG;AACU,QAAA,aAAa,GAAmB;IAC3C,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,MAAM,CAAC;IACzD,MAAM,EAAE,cAAc;IACtB,WAAW,EAAE;QACX,WAAW,EAAE,OAAO;QACpB,eAAe,EAAE,OAAO;KACzB;CACF,CAAC;AAEF;;GAEG;AACH,SAAgB,cAAc,CAAC,IAAY;IACzC,OAAO,oBAAoB,IAAI,EAAE,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC;AAClD,CAAC"}

package/dist/src/local/instanceManager.d.ts

@@ -0,0 +1,61 @@
+import { DynamoDBInstance } from './localDynamoDB';
+/**
+ * Manages DynamoDB instance lifecycle and state
+ */
+export declare class InstanceManager {
+    private readonly stateFile;
+    private instances;
+    private usageCounts;
+    private constructor();
+    /**
+     * Creates and initializes a new InstanceManager
+     */
+    static create(): Promise<InstanceManager>;
+    /**
+     * Gets an instance for a specific port
+     */
+    getInstance(port: number): Promise<DynamoDBInstance | 'stopped' | undefined>;
+    /**
+     * Gets the first running instance
+     */
+    getFirstRunningInstance(): Promise<DynamoDBInstance | undefined>;
+    /**
+     * Sets an instance for a specific port
+     */
+    setInstance(port: number, instance: DynamoDBInstance | 'stopped'): void;
+    /**
+     * Gets all instances
+     */
+    getAllInstances(): Map<number, DynamoDBInstance | 'stopped'>;
+    /**
+     * Gets the number of instances
+     */
+    getInstanceCount(): number;
+    /**
+     * Increments the usage counter for a port
+     */
+    incrementUsageCounter(port: number): void;
+    /**
+     * Decrements the usage counter for a port
+     */
+    decrementUsageCounter(port: number): number;
+    /**
+     * Gets the usage count for a port
+     */
+    getUsageCount(port: number): number;
+    /**
+     * Removes the usage counter for a port
+     */
+    removeUsageCounter(port: number): void;
+    /**
+     * Stops an instance
+     */
+    stopInstance(instance: DynamoDBInstance): Promise<void>;
+    private loadState;
+    private saveState;
+}
+/**
+ * Gets the singleton instance of InstanceManager
+ */
+export declare function getInstanceManager(): Promise<InstanceManager>;
+//# sourceMappingURL=instanceManager.d.ts.map

package/dist/src/local/instanceManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instanceManager.d.ts","sourceRoot":"","sources":["../../../src/local/instanceManager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAgBnD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,SAAS,CAAwD;IACzE,OAAO,CAAC,WAAW,CAAkC;IAErD,OAAO;IAEP;;OAEG;WACiB,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC;IAMtD;;OAEG;IACG,WAAW,CACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;IAapD;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAgBtE;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,SAAS,GAAG,IAAI;IAiBvE;;OAEG;IACH,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAI5D;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKzC;;OAEG;IACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAY3C;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAInC;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;YAQ/C,SAAS;IA0CvB,OAAO,CAAC,SAAS;CA6BlB;AAKD;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAKnE"}

package/dist/src/local/instanceManager.js

@@ -0,0 +1,212 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstanceManager = void 0;
+exports.getInstanceManager = getInstanceManager;
+const utils_log_1 = require("@goldstack/utils-log");
+const tcp_port_used_1 = require("tcp-port-used");
+const fs_1 = __importDefault(require("fs"));
+const processManager_1 = require("./processManager");
+/**
+ * Manages DynamoDB instance lifecycle and state
+ */
+class InstanceManager {
+    constructor() {
+        this.stateFile = '.localInstances.json';
+        this.instances = new Map();
+        this.usageCounts = new Map();
+    }
+    /**
+     * Creates and initializes a new InstanceManager
+     */
+    static async create() {
+        const manager = new InstanceManager();
+        await manager.loadState();
+        return manager;
+    }
+    /**
+     * Gets an instance for a specific port
+     */
+    async getInstance(port) {
+        const instance = this.instances.get(port);
+        if (instance && instance !== 'stopped') {
+            const isPortInUse = await (0, tcp_port_used_1.check)(port);
+            if (!isPortInUse) {
+                (0, utils_log_1.debug)(`Port ${port} not in use, marking instance as stopped`);
+                this.setInstance(port, 'stopped');
+                return 'stopped';
+            }
+        }
+        return instance;
+    }
+    /**
+     * Gets the first running instance
+     */
+    async getFirstRunningInstance() {
+        for (const [port, instance] of this.instances.entries()) {
+            if (instance !== 'stopped') {
+                const isPortInUse = await (0, tcp_port_used_1.check)(port);
+                if (!isPortInUse) {
+                    (0, utils_log_1.debug)(`Port ${port} not in use, marking instance as stopped`);
+                    this.setInstance(port, 'stopped');
+                    continue;
+                }
+                (0, utils_log_1.debug)(`Found existing local DynamoDB instance on port ${port}`);
+                return instance;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Sets an instance for a specific port
+     */
+    setInstance(port, instance) {
+        this.instances.set(port, instance);
+        (0, utils_log_1.debug)(`DynamoDB local instance ${instance === 'stopped' ? 'stopped' : 'started'} on port ${port}. Currently defined instances: ${this.instances.size}`, {
+            definedInstances: this.instances.size,
+            stoppedInstances: [...this.instances.entries()].filter((e) => e[1] === 'stopped').length,
+            allInstances: [...this.instances.entries()],
+        });
+        this.saveState();
+    }
+    /**
+     * Gets all instances
+     */
+    getAllInstances() {
+        return this.instances;
+    }
+    /**
+     * Gets the number of instances
+     */
+    getInstanceCount() {
+        return this.instances.size;
+    }
+    /**
+     * Increments the usage counter for a port
+     */
+    incrementUsageCounter(port) {
+        this.usageCounts.set(port, (this.usageCounts.get(port) || 0) + 1);
+        this.saveState();
+    }
+    /**
+     * Decrements the usage counter for a port
+     */
+    decrementUsageCounter(port) {
+        const currentCount = this.usageCounts.get(port) || 0;
+        if (currentCount <= 1) {
+            this.usageCounts.delete(port);
+            this.saveState();
+            return 0;
+        }
+        this.usageCounts.set(port, currentCount - 1);
+        this.saveState();
+        return currentCount - 1;
+    }
+    /**
+     * Gets the usage count for a port
+     */
+    getUsageCount(port) {
+        return this.usageCounts.get(port) || 0;
+    }
+    /**
+     * Removes the usage counter for a port
+     */
+    removeUsageCounter(port) {
+        this.usageCounts.delete(port);
+        this.saveState();
+    }
+    /**
+     * Stops an instance
+     */
+    async stopInstance(instance) {
+        if (instance.processId) {
+            await (0, processManager_1.terminateProcess)(instance.processId);
+        }
+        else if (instance.dockerContainerId) {
+            await (0, processManager_1.stopContainer)(instance.dockerContainerId);
+        }
+    }
+    async loadState() {
+        try {
+            const data = fs_1.default.readFileSync(this.stateFile, 'utf8');
+            const state = JSON.parse(data);
+            // Clear existing maps
+            this.instances.clear();
+            this.usageCounts.clear();
+            // Restore instances
+            for (const [port, instance] of Object.entries(state.instances)) {
+                const portNum = parseInt(port);
+                if (instance === 'stopped') {
+                    this.instances.set(portNum, 'stopped');
+                }
+                else {
+                    // Check if port is actually in use
+                    const isPortInUse = await (0, tcp_port_used_1.check)(portNum);
+                    if (!isPortInUse) {
+                        (0, utils_log_1.debug)(`Port ${portNum} not in use, marking instance as stopped`);
+                        this.instances.set(portNum, 'stopped');
+                    }
+                    else {
+                        this.instances.set(portNum, {
+                            port: portNum,
+                            processId: instance.processId,
+                            dockerContainerId: instance.dockerContainerId,
+                        });
+                    }
+                }
+            }
+            // Restore usage counts
+            Object.entries(state.usageCounts).forEach(([port, count]) => {
+                this.usageCounts.set(parseInt(port), count);
+            });
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT') {
+                (0, utils_log_1.error)('Failed to load local instances state:', err);
+            }
+            // File doesn't exist yet, that's fine
+        }
+    }
+    saveState() {
+        try {
+            const state = {
+                instances: {},
+                usageCounts: {},
+            };
+            // Save instances
+            this.instances.forEach((instance, port) => {
+                state.instances[port] =
+                    instance === 'stopped'
+                        ? 'stopped'
+                        : {
+                            port: instance.port,
+                            processId: instance.processId,
+                            dockerContainerId: instance.dockerContainerId,
+                        };
+            });
+            // Save usage counts
+            this.usageCounts.forEach((count, port) => {
+                state.usageCounts[port] = count;
+            });
+            fs_1.default.writeFileSync(this.stateFile, JSON.stringify(state, null, 2));
+        }
+        catch (err) {
+            (0, utils_log_1.error)('Failed to save local instances state:', err);
+        }
+    }
+}
+exports.InstanceManager = InstanceManager;
+// Initialize singleton instance
+let instanceManagerInstance;
+/**
+ * Gets the singleton instance of InstanceManager
+ */
+async function getInstanceManager() {
+    if (!instanceManagerInstance) {
+        instanceManagerInstance = await InstanceManager.create();
+    }
+    return instanceManagerInstance;
+}
+//# sourceMappingURL=instanceManager.js.map

package/dist/src/local/instanceManager.js.map

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

package/dist/src/{localDynamoDB.d.ts → local/localDynamoDB.d.ts}

@@ -1,12 +1,11 @@
 import { EmbeddedPackageConfig } from '@goldstack/utils-package-config-embedded';
 import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
-import { DynamoDBDeployment, DynamoDBPackage } from './templateDynamoDB';
+import { DynamoDBPackage, DynamoDBDeployment } from '../types/DynamoDBPackage';
 export interface DynamoDBInstance {
     port: number;
     processId?: number;
     dockerContainerId?: string;
 }
-export declare function stopInstance(instance: DynamoDBInstance): Promise<void>;
 export type LocalConnectType = (packageConfig: EmbeddedPackageConfig<DynamoDBPackage, DynamoDBDeployment>, deploymentName?: string) => Promise<DynamoDBClient>;
 export type StartLocalDynamoDBType = (packageConfig: EmbeddedPackageConfig<DynamoDBPackage, DynamoDBDeployment>, options: {
     port: number;
@@ -16,10 +15,20 @@ export interface StopLocalDynamoDBOptions {
 }
 export type StopLocalDynamoDBType = (packageConfig: EmbeddedPackageConfig<DynamoDBPackage, DynamoDBDeployment>, options?: StopLocalDynamoDBOptions, deploymentName?: string) => Promise<void>;
 export type StopAllLocalDynamoDBType = (packageConfig: EmbeddedPackageConfig<DynamoDBPackage, DynamoDBDeployment>, deploymentName?: string) => Promise<void>;
+/**
+ * Connects to a local DynamoDB instance, starting one if necessary
+ */
 export declare const localConnect: LocalConnectType;
-export declare const endpointUrl: (startedContainer: DynamoDBInstance) => string;
-export declare const createClient: (startedContainer: DynamoDBInstance) => DynamoDBClient;
+/**
+ * Starts a local DynamoDB instance
+ */
 export declare const startLocalDynamoDB: StartLocalDynamoDBType;
+/**
+ * Stops all local DynamoDB instances
+ */
 export declare const stopAllLocalDynamoDB: StopAllLocalDynamoDBType;
+/**
+ * Stops a specific local DynamoDB instance
+ */
 export declare const stopLocalDynamoDB: StopLocalDynamoDBType;
 //# sourceMappingURL=localDynamoDB.d.ts.map

package/dist/src/local/localDynamoDB.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localDynamoDB.d.ts","sourceRoot":"","sources":["../../../src/local/localDynamoDB.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAK1D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE/E,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAGD,MAAM,MAAM,gBAAgB,GAAG,CAC7B,aAAa,EAAE,qBAAqB,CAAC,eAAe,EAAE,kBAAkB,CAAC,EACzE,cAAc,CAAC,EAAE,MAAM,KACpB,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B,MAAM,MAAM,sBAAsB,GAAG,CACnC,aAAa,EAAE,qBAAqB,CAAC,eAAe,EAAE,kBAAkB,CAAC,EACzE,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACzB,cAAc,CAAC,EAAE,MAAM,KACpB,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE/B,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,qBAAqB,GAAG,CAClC,aAAa,EAAE,qBAAqB,CAAC,eAAe,EAAE,kBAAkB,CAAC,EACzE,OAAO,CAAC,EAAE,wBAAwB,EAClC,cAAc,CAAC,EAAE,MAAM,KACpB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,MAAM,wBAAwB,GAAG,CACrC,aAAa,EAAE,qBAAqB,CAAC,eAAe,EAAE,kBAAkB,CAAC,EACzE,cAAc,CAAC,EAAE,MAAM,KACpB,OAAO,CAAC,IAAI,CAAC,CAAC;AAiBnB;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,gBAuB1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,sBA+BhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,wBAmBlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,qBAiB/B,CAAC"}

package/dist/src/local/localDynamoDB.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stopLocalDynamoDB = exports.stopAllLocalDynamoDB = exports.startLocalDynamoDB = exports.localConnect = void 0;
+const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
+const utils_log_1 = require("@goldstack/utils-log");
+const instanceManager_1 = require("./instanceManager");
+const config_1 = require("./config");
+const spawner_1 = require("./spawner");
+/**
+ * Creates a DynamoDB client for a local instance
+ */
+async function createClient(instance) {
+    const endpoint = (0, config_1.getEndpointUrl)(instance.port);
+    (0, utils_log_1.debug)(`Connecting to local DynamoDB instance on endpoint: ${endpoint}`);
+    return new client_dynamodb_1.DynamoDBClient({
+        endpoint,
+        region: config_1.defaultConfig.region,
+        credentials: config_1.defaultConfig.credentials,
+    });
+}
+/**
+ * Connects to a local DynamoDB instance, starting one if necessary
+ */
+const localConnect = async (packageConfig, deploymentName) => {
+    const manager = await (0, instanceManager_1.getInstanceManager)();
+    const existingInstance = await manager.getFirstRunningInstance();
+    if (existingInstance) {
+        return await createClient(existingInstance);
+    }
+    if ((0, config_1.isTestEnvironment)()) {
+        throw new Error('DynamoDB Local has not been started. When running Jest test, start Local DynamoDB explicitly with `startLocalDynamoDB` and shut the instance down with `stopLocalDynamoDB` when tests are completed.');
+    }
+    // No running instance found, start a new one
+    const newInstance = await (0, exports.startLocalDynamoDB)(packageConfig, { port: config_1.defaultConfig.port }, deploymentName);
+    return await createClient(newInstance);
+};
+exports.localConnect = localConnect;
+/**
+ * Starts a local DynamoDB instance
+ */
+const startLocalDynamoDB = async (packageConfig, { port }, deploymentName) => {
+    const manager = await (0, instanceManager_1.getInstanceManager)();
+    // Check if instance already exists on requested port
+    const existingInstance = await manager.getInstance(port);
+    if (existingInstance && existingInstance !== 'stopped') {
+        (0, utils_log_1.debug)(`Starting DynamoDB local not required since instance already running on port ${port}`);
+        manager.incrementUsageCounter(port);
+        return existingInstance;
+    }
+    // Check if any instance is already running on a different port
+    const allInstances = manager.getAllInstances();
+    for (const [existingPort, instance] of allInstances.entries()) {
+        if (instance !== 'stopped') {
+            (0, utils_log_1.warn)(`You are starting a new DynamoDB instance on port ${port}. But a local DynamoDB instance is already running on port ${existingPort}.
+        It is recommended to have only one instance of local DynamoDB running at a time (since one instance can support multiple tables).`);
+        }
+    }
+    (0, utils_log_1.debug)(`Starting new DynamoDB local instance on port ${port}`);
+    const newInstance = await (0, spawner_1.spawnInstance)({ port });
+    manager.setInstance(port, newInstance);
+    manager.incrementUsageCounter(port);
+    return newInstance;
+};
+exports.startLocalDynamoDB = startLocalDynamoDB;
+/**
+ * Stops all local DynamoDB instances
+ */
+const stopAllLocalDynamoDB = async (packageConfig, deploymentName) => {
+    const manager = await (0, instanceManager_1.getInstanceManager)();
+    (0, utils_log_1.debug)('Stopping all local DynamoDB instances. Currently defined: ' +
+        manager.getInstanceCount());
+    const allInstances = manager.getAllInstances();
+    for (const [port, instance] of allInstances.entries()) {
+        if (instance && instance !== 'stopped') {
+            (0, utils_log_1.debug)(`Stopping instance on port ${port}`);
+            manager.setInstance(port, 'stopped');
+            manager.removeUsageCounter(port);
+            await manager.stopInstance(instance);
+        }
+    }
+};
+exports.stopAllLocalDynamoDB = stopAllLocalDynamoDB;
+/**
+ * Stops a specific local DynamoDB instance
+ */
+const stopLocalDynamoDB = async (packageConfig, options, deploymentName) => {
+    var _a;
+    const manager = await (0, instanceManager_1.getInstanceManager)();
+    const portToStop = (_a = options === null || options === void 0 ? void 0 : options.port) !== null && _a !== void 0 ? _a : config_1.defaultConfig.port;
+    const instance = await manager.getInstance(portToStop);
+    if (instance && instance !== 'stopped') {
+        const remainingUsers = manager.decrementUsageCounter(portToStop);
+        if (remainingUsers === 0) {
+            // Last user, stop the instance
+            manager.setInstance(portToStop, 'stopped');
+            await manager.stopInstance(instance);
+        }
+    }
+};
+exports.stopLocalDynamoDB = stopLocalDynamoDB;
+//# sourceMappingURL=localDynamoDB.js.map

package/dist/src/local/localDynamoDB.js.map

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

package/dist/src/{localInstances.d.ts → local/localInstances.d.ts}

@@ -23,25 +23,8 @@ export interface LocalInstancesManager {
     removeUsageCounter(port: number): void;
 }
 /**
- * Implementation of LocalInstancesManager for managing DynamoDB local instances
+ * Gets the singleton instance of LocalInstancesManager, initializing it if necessary
  */
-declare class LocalInstancesManagerImpl implements LocalInstancesManager {
-    private readonly stateFile;
-    private startedInstances;
-    private portUsageCounter;
-    constructor();
-    private loadState;
-    private saveState;
-    getInstance(port: number): DynamoDBInstance | 'stopped' | undefined;
-    getFirstRunningInstance(): DynamoDBInstance | undefined;
-    setInstance(port: number, instance: DynamoDBInstance | 'stopped'): void;
-    getAllInstances(): Map<number, DynamoDBInstance | 'stopped'>;
-    getInstanceCount(): number;
-    incrementUsageCounter(port: number): void;
-    decrementUsageCounter(port: number): number;
-    getUsageCount(port: number): number;
-    removeUsageCounter(port: number): void;
-}
-export declare const localInstancesManager: LocalInstancesManagerImpl;
-export {};
+export declare function getLocalInstancesManager(): Promise<LocalInstancesManager>;
+export declare const localInstancesManager: LocalInstancesManager;
 //# sourceMappingURL=localInstances.d.ts.map

package/dist/src/local/localInstances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localInstances.d.ts","sourceRoot":"","sources":["../../../src/local/localInstances.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAoBnD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;IACpE,mDAAmD;IACnD,uBAAuB,IAAI,gBAAgB,GAAG,SAAS,CAAC;IACxD,0CAA0C;IAC1C,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,SAAS,GAAG,IAAI,CAAC;IACxE,gCAAgC;IAChC,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC,CAAC;IAC7D,sCAAsC;IACtC,gBAAgB,IAAI,MAAM,CAAC;IAC3B,yCAAyC;IACzC,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,yCAAyC;IACzC,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5C,yCAAyC;IACzC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,sCAAsC;IACtC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AA0KD;;GAEG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAK/E;AAQD,eAAO,MAAM,qBAAqB,EAAS,qBAAqB,CAAC"}