@omen.foundation/node-microservice-runtime 0.1.0

package/dist/storage.js

@@ -0,0 +1,144 @@
+import { MongoClient } from 'mongodb';
+const STORAGE_OBJECT_METADATA = new Map();
+export function StorageObject(storageName) {
+    if (!storageName || !storageName.trim()) {
+        throw new Error('@StorageObject requires a non-empty storage name.');
+    }
+    return (target) => {
+        STORAGE_OBJECT_METADATA.set(target, { storageName: storageName.trim() });
+    };
+}
+export function getStorageMetadata(target) {
+    return STORAGE_OBJECT_METADATA.get(target);
+}
+export function listRegisteredStorageObjects() {
+    return Array.from(STORAGE_OBJECT_METADATA.values());
+}
+const CONNECTION_STRING_ENV_PREFIX = 'STORAGE_CONNSTR_';
+export class StorageService {
+    requester;
+    api;
+    env;
+    logger;
+    databaseCache = new Map();
+    clientCache = new Map();
+    cachedConnectionString;
+    constructor(dependencies) {
+        this.requester = dependencies.requester;
+        this.api = dependencies.api;
+        this.env = dependencies.env;
+        this.logger = dependencies.logger.child({ component: 'StorageService' });
+    }
+    async getDatabase(storageName, options = {}) {
+        const normalized = this.normalizeStorageName(storageName);
+        if (!options.useCache) {
+            this.databaseCache.delete(normalized);
+        }
+        const cached = this.databaseCache.get(normalized);
+        if (cached) {
+            return cached;
+        }
+        const connectionString = await this.getConnectionString(normalized);
+        const client = await this.getMongoClient(connectionString);
+        const databaseName = this.buildDatabaseName(normalized);
+        const database = client.db(databaseName);
+        this.databaseCache.set(normalized, database);
+        return database;
+    }
+    async getDatabaseFor(storageCtor, options = {}) {
+        const metadata = getStorageMetadata(storageCtor);
+        if (!metadata) {
+            throw new Error(`Storage metadata for ${storageCtor.name} not found. Did you decorate the class with @StorageObject('Name')?`);
+        }
+        return this.getDatabase(metadata.storageName, options);
+    }
+    async getCollection(storageName, options = {}) {
+        const database = await this.getDatabase(storageName, options);
+        const collectionName = options.collectionName?.trim();
+        if (!collectionName) {
+            throw new Error('Collection name must be provided when using getCollection with raw storage name.');
+        }
+        return database.collection(collectionName);
+    }
+    async getCollectionFor(storageCtor, collectionCtor, options = {}) {
+        const metadata = getStorageMetadata(storageCtor);
+        if (!metadata) {
+            throw new Error(`Storage metadata for ${storageCtor.name} not found. Did you decorate the class with @StorageObject('Name')?`);
+        }
+        const collectionName = options.collectionName?.trim() ?? collectionCtor.name;
+        const database = await this.getDatabase(metadata.storageName, options);
+        return database.collection(collectionName);
+    }
+    async getMongoClient(connectionString) {
+        if (this.clientCache.has(connectionString)) {
+            return this.clientCache.get(connectionString);
+        }
+        const client = new MongoClient(connectionString, {
+            maxPoolSize: 20,
+        });
+        await client.connect();
+        this.clientCache.set(connectionString, client);
+        return client;
+    }
+    async getConnectionString(storageName) {
+        const variableName = `${CONNECTION_STRING_ENV_PREFIX}${storageName}`;
+        const envValue = process.env[variableName];
+        if (envValue && envValue.trim()) {
+            return envValue.trim();
+        }
+        if (this.cachedConnectionString) {
+            return this.cachedConnectionString;
+        }
+        const response = await this.fetchConnectionString();
+        if (!response.connectionString || !response.connectionString.trim()) {
+            throw new Error(`Connection string for storage "${storageName}" is empty.`);
+        }
+        this.cachedConnectionString = response.connectionString.trim();
+        return this.cachedConnectionString;
+    }
+    async fetchConnectionString() {
+        if (typeof this.api.beamoGetStorageConnectionBasic === 'function') {
+            const result = await this.api.beamoGetStorageConnectionBasic();
+            if (result && typeof result === 'object' && 'body' in result) {
+                return result.body;
+            }
+            return result;
+        }
+        this.logger.warn('beamable-sdk does not expose beamoGetStorageConnectionBasic; falling back to manual requester call.');
+        const response = await this.requester.request({
+            method: 'GET',
+            url: '/basic/beamo/storage/connection',
+            withAuth: true,
+        });
+        const body = response.body;
+        if (!body || typeof body.connectionString !== 'string') {
+            throw new Error('Failed to retrieve Beamable storage connection string.');
+        }
+        return body;
+    }
+    buildDatabaseName(storageName) {
+        const cid = this.sanitize(this.env.cid);
+        const pid = this.sanitize(this.env.pid);
+        const storage = this.sanitize(storageName);
+        return `${cid}${pid}_${storage}`;
+    }
+    sanitize(value) {
+        return value.replace(/[^A-Za-z0-9_]/g, '_');
+    }
+    normalizeStorageName(storageName) {
+        const normalized = storageName.trim();
+        if (!normalized) {
+            throw new Error('Storage name cannot be empty.');
+        }
+        return normalized;
+    }
+    async dispose() {
+        for (const client of this.clientCache.values()) {
+            await client.close();
+        }
+        this.clientCache.clear();
+        this.databaseCache.clear();
+        this.cachedConnectionString = undefined;
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAA2C,MAAM,SAAS,CAAC;AAiB/E,MAAM,uBAAuB,GAAG,IAAI,GAAG,EAA6B,CAAC;AAErE,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,uBAAuB,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAgB;IACjD,OAAO,uBAAuB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,MAAM,EAAE,CAAC,CAAC;AACtD,CAAC;AAaD,MAAM,4BAA4B,GAAG,kBAAkB,CAAC;AAExD,MAAM,OAAO,cAAc;IACR,SAAS,CAAgB;IACzB,GAAG,CAAe;IAClB,GAAG,CAAoB;IACvB,MAAM,CAAS;IACf,aAAa,GAAG,IAAI,GAAG,EAAc,CAAC;IACtC,WAAW,GAAG,IAAI,GAAG,EAAuB,CAAC;IACtD,sBAAsB,CAAU;IAExC,YAAY,YAAwC;QAClD,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC;QACxC,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC;QAC5B,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,WAAmB,EAAE,UAAoC,EAAE;QAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;QAC3D,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;QACzC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC7C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,cAAc,CAAI,WAAwB,EAAE,UAAoC,EAAE;QACtF,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CACb,wBAAwB,WAAW,CAAC,IAAI,qEAAqE,CAC9G,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,WAAmB,EACnB,UAAoC,EAAE;QAEtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC9D,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;QACtD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;QACtG,CAAC;QACD,OAAO,QAAQ,CAAC,UAAU,CAAY,cAAc,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,WAA+B,EAC/B,cAAmC,EACnC,UAAoC,EAAE;QAEtC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CACb,wBAAwB,WAAW,CAAC,IAAI,qEAAqE,CAC9G,CAAC;QACJ,CAAC;QACD,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC;QAC7E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACvE,OAAO,QAAQ,CAAC,UAAU,CAAY,cAAc,CAAC,CAAC;IACxD,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,gBAAwB;QACnD,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAgB,CAAC;QAC/D,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,gBAAgB,EAAE;YAC/C,WAAW,EAAE,EAAE;SAChB,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;QAC/C,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QACnD,MAAM,YAAY,GAAG,GAAG,4BAA4B,GAAG,WAAW,EAAE,CAAC;QACrE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC3C,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;YAChC,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC;QAED,IAAI,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,sBAAsB,CAAC;QACrC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACpD,IAAI,CAAC,QAAQ,CAAC,gBAAgB,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,kCAAkC,WAAW,aAAa,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,CAAC,sBAAsB,GAAG,QAAQ,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC,sBAAsB,CAAC;IACrC,CAAC;IAEO,KAAK,CAAC,qBAAqB;QACjC,IAAI,OAAO,IAAI,CAAC,GAAG,CAAC,8BAA8B,KAAK,UAAU,EAAE,CAAC;YAClE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,8BAA8B,EAAE,CAAC;YAC/D,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;gBAC7D,OAAQ,MAA6C,CAAC,IAAI,CAAC;YAC7D,CAAC;YACD,OAAO,MAAkC,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,qGAAqG,CACtG,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5C,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,iCAAiC;YACtC,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAA4C,CAAC;QACnE,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,gBAAgB,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,iBAAiB,CAAC,WAAmB;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC3C,OAAO,GAAG,GAAG,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC;IACnC,CAAC;IAEO,QAAQ,CAAC,KAAa;QAC5B,OAAO,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;IAEO,oBAAoB,CAAC,WAAmB;QAC9C,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import type { Logger } from 'pino';\r\nimport { MongoClient, type Db, type Collection, type Document } from 'mongodb';\r\nimport type { BoundBeamApi } from './services.js';\r\nimport type { EnvironmentConfig } from './types.js';\r\nimport type { HttpRequester } from 'beamable-sdk';\r\n\r\nexport interface StorageConnectionOptions {\r\n  useCache?: boolean;\r\n}\r\n\r\nexport interface StorageCollectionOptions extends StorageConnectionOptions {\r\n  collectionName?: string;\r\n}\r\n\r\nexport interface StorageMetadata {\r\n  storageName: string;\r\n}\r\n\r\nconst STORAGE_OBJECT_METADATA = new Map<Function, StorageMetadata>();\r\n\r\nexport function StorageObject(storageName: string): ClassDecorator {\r\n  if (!storageName || !storageName.trim()) {\r\n    throw new Error('@StorageObject requires a non-empty storage name.');\r\n  }\r\n  return (target) => {\r\n    STORAGE_OBJECT_METADATA.set(target, { storageName: storageName.trim() });\r\n  };\r\n}\r\n\r\nexport function getStorageMetadata(target: Function): StorageMetadata | undefined {\r\n  return STORAGE_OBJECT_METADATA.get(target);\r\n}\r\n\r\nexport function listRegisteredStorageObjects(): StorageMetadata[] {\r\n  return Array.from(STORAGE_OBJECT_METADATA.values());\r\n}\r\n\r\ninterface StorageServiceDependencies {\r\n  requester: HttpRequester;\r\n  api: BoundBeamApi;\r\n  env: EnvironmentConfig;\r\n  logger: Logger;\r\n}\r\n\r\ninterface ConnectionStringResponse {\r\n  connectionString: string;\r\n}\r\n\r\nconst CONNECTION_STRING_ENV_PREFIX = 'STORAGE_CONNSTR_';\r\n\r\nexport class StorageService {\r\n  private readonly requester: HttpRequester;\r\n  private readonly api: BoundBeamApi;\r\n  private readonly env: EnvironmentConfig;\r\n  private readonly logger: Logger;\r\n  private readonly databaseCache = new Map<string, Db>();\r\n  private readonly clientCache = new Map<string, MongoClient>();\r\n  private cachedConnectionString?: string;\r\n\r\n  constructor(dependencies: StorageServiceDependencies) {\r\n    this.requester = dependencies.requester;\r\n    this.api = dependencies.api;\r\n    this.env = dependencies.env;\r\n    this.logger = dependencies.logger.child({ component: 'StorageService' });\r\n  }\r\n\r\n  async getDatabase(storageName: string, options: StorageConnectionOptions = {}): Promise<Db> {\r\n    const normalized = this.normalizeStorageName(storageName);\r\n    if (!options.useCache) {\r\n      this.databaseCache.delete(normalized);\r\n    }\r\n    const cached = this.databaseCache.get(normalized);\r\n    if (cached) {\r\n      return cached;\r\n    }\r\n\r\n    const connectionString = await this.getConnectionString(normalized);\r\n    const client = await this.getMongoClient(connectionString);\r\n    const databaseName = this.buildDatabaseName(normalized);\r\n    const database = client.db(databaseName);\r\n    this.databaseCache.set(normalized, database);\r\n    return database;\r\n  }\r\n\r\n  async getDatabaseFor<T>(storageCtor: new () => T, options: StorageConnectionOptions = {}): Promise<Db> {\r\n    const metadata = getStorageMetadata(storageCtor);\r\n    if (!metadata) {\r\n      throw new Error(\r\n        `Storage metadata for ${storageCtor.name} not found. Did you decorate the class with @StorageObject('Name')?`,\r\n      );\r\n    }\r\n    return this.getDatabase(metadata.storageName, options);\r\n  }\r\n\r\n  async getCollection<TDocument extends Document>(\r\n    storageName: string,\r\n    options: StorageCollectionOptions = {},\r\n  ): Promise<Collection<TDocument>> {\r\n    const database = await this.getDatabase(storageName, options);\r\n    const collectionName = options.collectionName?.trim();\r\n    if (!collectionName) {\r\n      throw new Error('Collection name must be provided when using getCollection with raw storage name.');\r\n    }\r\n    return database.collection<TDocument>(collectionName);\r\n  }\r\n\r\n  async getCollectionFor<TStorage, TDocument extends Document>(\r\n    storageCtor: new () => TStorage,\r\n    collectionCtor: new () => TDocument,\r\n    options: StorageCollectionOptions = {},\r\n  ): Promise<Collection<TDocument>> {\r\n    const metadata = getStorageMetadata(storageCtor);\r\n    if (!metadata) {\r\n      throw new Error(\r\n        `Storage metadata for ${storageCtor.name} not found. Did you decorate the class with @StorageObject('Name')?`,\r\n      );\r\n    }\r\n    const collectionName = options.collectionName?.trim() ?? collectionCtor.name;\r\n    const database = await this.getDatabase(metadata.storageName, options);\r\n    return database.collection<TDocument>(collectionName);\r\n  }\r\n\r\n  private async getMongoClient(connectionString: string): Promise<MongoClient> {\r\n    if (this.clientCache.has(connectionString)) {\r\n      return this.clientCache.get(connectionString) as MongoClient;\r\n    }\r\n    const client = new MongoClient(connectionString, {\r\n      maxPoolSize: 20,\r\n    });\r\n    await client.connect();\r\n    this.clientCache.set(connectionString, client);\r\n    return client;\r\n  }\r\n\r\n  private async getConnectionString(storageName: string): Promise<string> {\r\n    const variableName = `${CONNECTION_STRING_ENV_PREFIX}${storageName}`;\r\n    const envValue = process.env[variableName];\r\n    if (envValue && envValue.trim()) {\r\n      return envValue.trim();\r\n    }\r\n\r\n    if (this.cachedConnectionString) {\r\n      return this.cachedConnectionString;\r\n    }\r\n\r\n    const response = await this.fetchConnectionString();\r\n    if (!response.connectionString || !response.connectionString.trim()) {\r\n      throw new Error(`Connection string for storage \"${storageName}\" is empty.`);\r\n    }\r\n    this.cachedConnectionString = response.connectionString.trim();\r\n    return this.cachedConnectionString;\r\n  }\r\n\r\n  private async fetchConnectionString(): Promise<ConnectionStringResponse> {\r\n    if (typeof this.api.beamoGetStorageConnectionBasic === 'function') {\r\n      const result = await this.api.beamoGetStorageConnectionBasic();\r\n      if (result && typeof result === 'object' && 'body' in result) {\r\n        return (result as { body: ConnectionStringResponse }).body;\r\n      }\r\n      return result as ConnectionStringResponse;\r\n    }\r\n\r\n    this.logger.warn(\r\n      'beamable-sdk does not expose beamoGetStorageConnectionBasic; falling back to manual requester call.',\r\n    );\r\n    const response = await this.requester.request({\r\n      method: 'GET',\r\n      url: '/basic/beamo/storage/connection',\r\n      withAuth: true,\r\n    });\r\n    const body = response.body as ConnectionStringResponse | undefined;\r\n    if (!body || typeof body.connectionString !== 'string') {\r\n      throw new Error('Failed to retrieve Beamable storage connection string.');\r\n    }\r\n    return body;\r\n  }\r\n\r\n  private buildDatabaseName(storageName: string): string {\r\n    const cid = this.sanitize(this.env.cid);\r\n    const pid = this.sanitize(this.env.pid);\r\n    const storage = this.sanitize(storageName);\r\n    return `${cid}${pid}_${storage}`;\r\n  }\r\n\r\n  private sanitize(value: string): string {\r\n    return value.replace(/[^A-Za-z0-9_]/g, '_');\r\n  }\r\n\r\n  private normalizeStorageName(storageName: string): string {\r\n    const normalized = storageName.trim();\r\n    if (!normalized) {\r\n      throw new Error('Storage name cannot be empty.');\r\n    }\r\n    return normalized;\r\n  }\r\n\r\n  async dispose(): Promise<void> {\r\n    for (const client of this.clientCache.values()) {\r\n      await client.close();\r\n    }\r\n    this.clientCache.clear();\r\n    this.databaseCache.clear();\r\n    this.cachedConnectionString = undefined;\r\n  }\r\n}\r\n\r\n"]}

package/dist/types.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types.d.ts

@@ -0,0 +1,108 @@
+import type { Logger } from 'pino';
+import type { BeamableMicroserviceServices } from './services.js';
+import type { DependencyScope } from './dependency.js';
+export type ServiceAccess = 'public' | 'client' | 'server' | 'admin';
+export interface MicroserviceOptions {
+    /** When true, legacy serialization is enabled for every callable unless overridden per method. */
+    useLegacySerialization?: boolean;
+    /** When true the runtime will skip auto-registration for Beamable events. */
+    disableAllBeamableEvents?: boolean;
+}
+export interface CallableOptions {
+    /** Optional explicit route name. Defaults to the method name. */
+    route?: string;
+    /** Whether an authenticated user is required for invocation. */
+    requireAuth?: boolean;
+    /** Scopes required for the invocation. */
+    requiredScopes?: string[];
+    /** Override legacy serialization behaviour for this callable. */
+    useLegacySerialization?: boolean;
+    access?: ServiceAccess;
+    /** Optional OpenAPI/Swagger tags to apply to the callable. */
+    tags?: string[];
+}
+export interface EnvironmentConfig {
+    cid: string;
+    pid: string;
+    host: string;
+    secret?: string;
+    refreshToken?: string;
+    routingKey?: string;
+    accountId?: number;
+    accountEmail?: string;
+    logLevel: string;
+    healthPort: number;
+    disableCustomInitializationHooks: boolean;
+    watchToken: boolean;
+    sdkVersionExecution: string;
+    beamInstanceCount: number;
+    logTruncateLimit: number;
+}
+export interface GatewayRequest {
+    id: number;
+    method: string;
+    path: string;
+    from?: number;
+    body?: unknown;
+    scopes?: string[];
+    headers?: Record<string, string>;
+}
+export interface GatewayResponse<T = unknown> {
+    id: number;
+    status: number;
+    body: T;
+}
+export interface WebsocketEventEnvelope {
+    id: number;
+    status: number;
+    path?: string;
+    method?: string;
+    body?: unknown;
+    from?: number;
+    scopes?: string[];
+    headers?: Record<string, string>;
+}
+export interface RequestContext {
+    id: number;
+    path: string;
+    method: string;
+    status: number;
+    userId: number;
+    payload?: unknown;
+    body?: Record<string, unknown>;
+    scopes: Set<string>;
+    headers: Record<string, string>;
+    cid: string;
+    pid: string;
+    services: BeamableMicroserviceServices;
+    throwIfCancelled(): void;
+    isCancelled(): boolean;
+    hasScopes(...scopes: string[]): boolean;
+    requireScopes(...scopes: string[]): void;
+    provider: DependencyScope;
+}
+export interface ServiceCallableMetadata {
+    route: string;
+    displayName: string;
+    requireAuth: boolean;
+    requiredScopes: string[];
+    useLegacySerialization: boolean;
+    parameterTypes: ReadonlyArray<unknown>;
+    access: ServiceAccess;
+    tags: string[];
+}
+export interface ServiceDefinition {
+    name: string;
+    qualifiedName: string;
+    ctor: new (...args: unknown[]) => unknown;
+    callables: Map<string, ServiceCallableMetadata>;
+    options?: MicroserviceOptions;
+}
+export interface RuntimeComponents {
+    env: EnvironmentConfig;
+    logger: Logger;
+}
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Logger } from 'pino';\r\nimport type { BeamableMicroserviceServices } from './services.js';\r\nimport type { DependencyScope } from './dependency.js';\r\n\r\nexport type ServiceAccess = 'public' | 'client' | 'server' | 'admin';\r\n\r\nexport interface MicroserviceOptions {\r\n  /** When true, legacy serialization is enabled for every callable unless overridden per method. */\r\n  useLegacySerialization?: boolean;\r\n  /** When true the runtime will skip auto-registration for Beamable events. */\r\n  disableAllBeamableEvents?: boolean;\r\n}\r\n\r\nexport interface CallableOptions {\r\n  /** Optional explicit route name. Defaults to the method name. */\r\n  route?: string;\r\n  /** Whether an authenticated user is required for invocation. */\r\n  requireAuth?: boolean;\r\n  /** Scopes required for the invocation. */\r\n  requiredScopes?: string[];\r\n  /** Override legacy serialization behaviour for this callable. */\r\n  useLegacySerialization?: boolean;\r\n  access?: ServiceAccess;\r\n  /** Optional OpenAPI/Swagger tags to apply to the callable. */\r\n  tags?: string[];\r\n}\r\n\r\nexport interface EnvironmentConfig {\r\n  cid: string;\r\n  pid: string;\r\n  host: string;\r\n  secret?: string;\r\n  refreshToken?: string;\r\n  routingKey?: string; // undefined for deployed services (becomes None in Scala)\r\n  accountId?: number;\r\n  accountEmail?: string;\r\n  logLevel: string;\r\n  healthPort: number;\r\n  disableCustomInitializationHooks: boolean;\r\n  watchToken: boolean;\r\n  sdkVersionExecution: string;\r\n  beamInstanceCount: number;\r\n  logTruncateLimit: number;\r\n}\r\n\r\nexport interface GatewayRequest {\r\n  id: number;\r\n  method: string;\r\n  path: string;\r\n  from?: number;\r\n  body?: unknown;\r\n  scopes?: string[];\r\n  headers?: Record<string, string>;\r\n}\r\n\r\nexport interface GatewayResponse<T = unknown> {\r\n  id: number;\r\n  status: number;\r\n  body: T;\r\n}\r\n\r\nexport interface WebsocketEventEnvelope {\r\n  id: number;\r\n  status: number;\r\n  path?: string;\r\n  method?: string;\r\n  body?: unknown;\r\n  from?: number;\r\n  scopes?: string[];\r\n  headers?: Record<string, string>;\r\n}\r\n\r\nexport interface RequestContext {\r\n  id: number;\r\n  path: string;\r\n  method: string;\r\n  status: number;\r\n  userId: number;\r\n  payload?: unknown;\r\n  body?: Record<string, unknown>;\r\n  scopes: Set<string>;\r\n  headers: Record<string, string>;\r\n  cid: string;\r\n  pid: string;\r\n  services: BeamableMicroserviceServices;\r\n  throwIfCancelled(): void;\r\n  isCancelled(): boolean;\r\n  hasScopes(...scopes: string[]): boolean;\r\n  requireScopes(...scopes: string[]): void;\r\n  provider: DependencyScope;\r\n}\r\n\r\nexport interface ServiceCallableMetadata {\r\n  route: string;\r\n  displayName: string;\r\n  requireAuth: boolean;\r\n  requiredScopes: string[];\r\n  useLegacySerialization: boolean;\r\n  parameterTypes: ReadonlyArray<unknown>;\r\n  access: ServiceAccess;\r\n  tags: string[];\r\n}\r\n\r\nexport interface ServiceDefinition {\r\n  name: string;\r\n  qualifiedName: string;\r\n  ctor: new (...args: unknown[]) => unknown;\r\n  callables: Map<string, ServiceCallableMetadata>;\r\n  options?: MicroserviceOptions;\r\n}\r\n\r\nexport interface RuntimeComponents {\r\n  env: EnvironmentConfig;\r\n  logger: Logger;\r\n}\r\n\r\nexport type JsonValue = string | number | boolean | null | JsonValue[] | { [key: string]: JsonValue };\r\n"]}

package/dist/utils/urls.cjs

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hostToHttpUrl = hostToHttpUrl;
+exports.hostToPortalUrl = hostToPortalUrl;
+exports.hostToStorageUrl = hostToStorageUrl;
+exports.hostToMicroserviceRegistryUrl = hostToMicroserviceRegistryUrl;
+function hostToHttpUrl(host) {
+    const normalized = host.replace(/\/$/, '');
+    if (normalized.startsWith('wss://')) {
+        return `https://${normalized.substring('wss://'.length).replace(/\/socket$/, '')}`;
+    }
+    if (normalized.startsWith('ws://')) {
+        return `http://${normalized.substring('ws://'.length).replace(/\/socket$/, '')}`;
+    }
+    return normalized.replace(/\/socket$/, '');
+}
+function transformApiHostname(hostname, replacement) {
+    let host = hostname;
+    if (host.startsWith('dev.')) {
+        host = host.replace('dev.', 'dev-');
+    }
+    if (host.startsWith('api.')) {
+        return host.replace('api.', `${replacement}.`);
+    }
+    if (host.startsWith('api-')) {
+        return host.replace('api-', `${replacement}-`);
+    }
+    const index = host.indexOf('api');
+    if (index >= 0) {
+        return `${host.slice(0, index)}${replacement}${host.slice(index + 3)}`;
+    }
+    return host;
+}
+function transformHost(httpHost, replacement) {
+    try {
+        const url = new URL(httpHost);
+        url.hostname = transformApiHostname(url.hostname, replacement);
+        url.pathname = '/';
+        url.search = '';
+        url.hash = '';
+        return url.toString().replace(/\/$/, '');
+    }
+    catch (error) {
+        return transformApiHostname(httpHost, replacement);
+    }
+}
+function hostToPortalUrl(httpHost) {
+    return transformHost(httpHost, 'portal');
+}
+function hostToStorageUrl(httpHost) {
+    return transformHost(httpHost, 'storage');
+}
+function hostToMicroserviceRegistryUrl(httpHost) {
+    return transformHost(httpHost, 'microservices');
+}

package/dist/utils/urls.d.ts

@@ -0,0 +1,5 @@
+export declare function hostToHttpUrl(host: string): string;
+export declare function hostToPortalUrl(httpHost: string): string;
+export declare function hostToStorageUrl(httpHost: string): string;
+export declare function hostToMicroserviceRegistryUrl(httpHost: string): string;
+//# sourceMappingURL=urls.d.ts.map

package/dist/utils/urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../../src/utils/urls.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASlD;AAiCD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtE"}

package/dist/utils/urls.js

@@ -0,0 +1,50 @@
+export function hostToHttpUrl(host) {
+    const normalized = host.replace(/\/$/, '');
+    if (normalized.startsWith('wss://')) {
+        return `https://${normalized.substring('wss://'.length).replace(/\/socket$/, '')}`;
+    }
+    if (normalized.startsWith('ws://')) {
+        return `http://${normalized.substring('ws://'.length).replace(/\/socket$/, '')}`;
+    }
+    return normalized.replace(/\/socket$/, '');
+}
+function transformApiHostname(hostname, replacement) {
+    let host = hostname;
+    if (host.startsWith('dev.')) {
+        host = host.replace('dev.', 'dev-');
+    }
+    if (host.startsWith('api.')) {
+        return host.replace('api.', `${replacement}.`);
+    }
+    if (host.startsWith('api-')) {
+        return host.replace('api-', `${replacement}-`);
+    }
+    const index = host.indexOf('api');
+    if (index >= 0) {
+        return `${host.slice(0, index)}${replacement}${host.slice(index + 3)}`;
+    }
+    return host;
+}
+function transformHost(httpHost, replacement) {
+    try {
+        const url = new URL(httpHost);
+        url.hostname = transformApiHostname(url.hostname, replacement);
+        url.pathname = '/';
+        url.search = '';
+        url.hash = '';
+        return url.toString().replace(/\/$/, '');
+    }
+    catch (error) {
+        return transformApiHostname(httpHost, replacement);
+    }
+}
+export function hostToPortalUrl(httpHost) {
+    return transformHost(httpHost, 'portal');
+}
+export function hostToStorageUrl(httpHost) {
+    return transformHost(httpHost, 'storage');
+}
+export function hostToMicroserviceRegistryUrl(httpHost) {
+    return transformHost(httpHost, 'microservices');
+}
+//# sourceMappingURL=urls.js.map

package/dist/utils/urls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.js","sourceRoot":"","sources":["../../src/utils/urls.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC3C,IAAI,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,OAAO,WAAW,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC;IACrF,CAAC;IACD,IAAI,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,OAAO,UAAU,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC;IACnF,CAAC;IACD,OAAO,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAgB,EAAE,WAAmB;IACjE,IAAI,IAAI,GAAG,QAAQ,CAAC;IACpB,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,WAAW,GAAG,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,WAAW,GAAG,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;IACzE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAE,WAAmB;IAC1D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,GAAG,CAAC,QAAQ,GAAG,oBAAoB,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC/D,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC;QACnB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;QAChB,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;QACd,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,oBAAoB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,QAAgB;IAC5D,OAAO,aAAa,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;AAClD,CAAC","sourcesContent":["export function hostToHttpUrl(host: string): string {\r\n  const normalized = host.replace(/\\/$/, '');\r\n  if (normalized.startsWith('wss://')) {\r\n    return `https://${normalized.substring('wss://'.length).replace(/\\/socket$/, '')}`;\r\n  }\r\n  if (normalized.startsWith('ws://')) {\r\n    return `http://${normalized.substring('ws://'.length).replace(/\\/socket$/, '')}`;\r\n  }\r\n  return normalized.replace(/\\/socket$/, '');\r\n}\r\n\r\nfunction transformApiHostname(hostname: string, replacement: string): string {\r\n  let host = hostname;\r\n  if (host.startsWith('dev.')) {\r\n    host = host.replace('dev.', 'dev-');\r\n  }\r\n  if (host.startsWith('api.')) {\r\n    return host.replace('api.', `${replacement}.`);\r\n  }\r\n  if (host.startsWith('api-')) {\r\n    return host.replace('api-', `${replacement}-`);\r\n  }\r\n  const index = host.indexOf('api');\r\n  if (index >= 0) {\r\n    return `${host.slice(0, index)}${replacement}${host.slice(index + 3)}`;\r\n  }\r\n  return host;\r\n}\r\n\r\nfunction transformHost(httpHost: string, replacement: string): string {\r\n  try {\r\n    const url = new URL(httpHost);\r\n    url.hostname = transformApiHostname(url.hostname, replacement);\r\n    url.pathname = '/';\r\n    url.search = '';\r\n    url.hash = '';\r\n    return url.toString().replace(/\\/$/, '');\r\n  } catch (error) {\r\n    return transformApiHostname(httpHost, replacement);\r\n  }\r\n}\r\n\r\nexport function hostToPortalUrl(httpHost: string): string {\r\n  return transformHost(httpHost, 'portal');\r\n}\r\n\r\nexport function hostToStorageUrl(httpHost: string): string {\r\n  return transformHost(httpHost, 'storage');\r\n}\r\n\r\nexport function hostToMicroserviceRegistryUrl(httpHost: string): string {\r\n  return transformHost(httpHost, 'microservices');\r\n}\r\n"]}

package/dist/websocket.cjs

@@ -0,0 +1,142 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BeamableWebSocket = void 0;
+const promises_1 = require("node:timers/promises");
+const node_events_1 = require("node:events");
+const ws_1 = __importDefault(require("ws"));
+class BeamableWebSocket {
+    constructor(options) {
+        var _a, _b;
+        this.emitter = new node_events_1.EventEmitter();
+        this.socket = null;
+        this.isDisposed = false;
+        this.logger = options.logger.child({ component: 'BeamableWebSocket' });
+        this.url = options.url;
+        this.maxRetries = (_a = options.maxRetries) !== null && _a !== void 0 ? _a : 20;
+        this.retryDelayMs = (_b = options.retryDelayMs) !== null && _b !== void 0 ? _b : 1000;
+    }
+    on(event, listener) {
+        this.emitter.on(event, listener);
+        return this;
+    }
+    off(event, listener) {
+        this.emitter.off(event, listener);
+        return this;
+    }
+    emit(event, ...args) {
+        this.emitter.emit(event, ...args);
+    }
+    async connect() {
+        let attempt = 0;
+        while (!this.isDisposed) {
+            try {
+                attempt += 1;
+                await this.createSocket();
+                return;
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                this.logger.warn({ err, attempt }, 'WebSocket connection attempt failed.');
+                if (attempt >= this.maxRetries) {
+                    throw err;
+                }
+                await (0, promises_1.setTimeout)(this.retryDelayMs * attempt);
+            }
+        }
+        throw new Error('WebSocket disposed before connection could be established.');
+    }
+    async createSocket() {
+        if (this.socket) {
+            this.socket.removeAllListeners();
+            this.socket.terminate();
+            this.socket = null;
+        }
+        return new Promise((resolve, reject) => {
+            const ws = new ws_1.default(this.url, {
+                perMessageDeflate: true,
+                handshakeTimeout: 30000,
+            });
+            const handleOpen = () => {
+                this.logger.info({ url: this.url }, 'WebSocket connected.');
+                this.socket = ws;
+                ws.off('error', handleError);
+                ws.off('close', handlePrematureClose);
+                this.registerSocketHandlers(ws);
+                this.emit('open');
+                resolve();
+            };
+            const handleError = (error) => {
+                ws.off('open', handleOpen);
+                ws.off('close', handlePrematureClose);
+                reject(error);
+            };
+            const handlePrematureClose = (code, reason) => {
+                ws.off('open', handleOpen);
+                ws.off('error', handleError);
+                const err = new Error(`WebSocket closed before open handshake. code=${code} reason=${reason.toString()}`);
+                reject(err);
+            };
+            ws.on('open', handleOpen);
+            ws.on('error', handleError);
+            ws.on('close', handlePrematureClose);
+        });
+    }
+    registerSocketHandlers(ws) {
+        ws.on('message', (data) => {
+            const payload = typeof data === 'string' ? data : data.toString('utf8');
+            this.logger.debug({ payload }, 'WebSocket received frame.');
+            this.emit('message', payload);
+        });
+        ws.on('close', (code, reason) => {
+            this.logger.warn({ code, reason: reason.toString() }, 'WebSocket closed.');
+            this.emit('close', code === 1000);
+            if (!this.isDisposed) {
+                void this.reconnect();
+            }
+        });
+        ws.on('error', (error) => {
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.logger.error({ err }, 'WebSocket error.');
+            this.emit('error', err);
+        });
+    }
+    async reconnect() {
+        this.logger.info('Attempting to reconnect websocket.');
+        let attempt = 0;
+        while (!this.isDisposed) {
+            try {
+                attempt += 1;
+                await this.createSocket();
+                this.emit('open');
+                return;
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                this.logger.warn({ err, attempt }, 'Retrying websocket connection.');
+                await (0, promises_1.setTimeout)(this.retryDelayMs * Math.min(attempt, 10));
+            }
+        }
+    }
+    async send(text) {
+        if (!this.socket || this.socket.readyState !== ws_1.default.OPEN) {
+            throw new Error('WebSocket is not connected.');
+        }
+        this.logger.debug({ message: text }, 'Sending websocket frame.');
+        this.socket.send(text);
+    }
+    async close() {
+        this.isDisposed = true;
+        if (!this.socket) {
+            return;
+        }
+        const ws = this.socket;
+        if (ws.readyState === ws_1.default.CLOSED || ws.readyState === ws_1.default.CLOSING) {
+            return;
+        }
+        ws.close(1000, 'shutdown');
+    }
+}
+exports.BeamableWebSocket = BeamableWebSocket;

package/dist/websocket.d.ts

@@ -0,0 +1,33 @@
+import type { Logger } from 'pino';
+export interface WebSocketOptions {
+    logger: Logger;
+    url: string;
+    maxRetries?: number;
+    retryDelayMs?: number;
+}
+export interface WebSocketEvents {
+    open: [];
+    close: [wasClean: boolean];
+    message: [payload: string];
+    error: [error: Error];
+}
+export declare class BeamableWebSocket {
+    private readonly logger;
+    private readonly url;
+    private readonly maxRetries;
+    private readonly retryDelayMs;
+    private readonly emitter;
+    private socket;
+    private isDisposed;
+    constructor(options: WebSocketOptions);
+    on(event: string, listener: (...args: unknown[]) => void): this;
+    off(event: string, listener: (...args: unknown[]) => void): this;
+    private emit;
+    connect(): Promise<void>;
+    private createSocket;
+    private registerSocketHandlers;
+    private reconnect;
+    send(text: string): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=websocket.d.ts.map

package/dist/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../src/websocket.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,EAAE,CAAC;IACT,KAAK,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACvB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAE9C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,gBAAgB;IAOrC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAK/D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAKhE,OAAO,CAAC,IAAI;IAIN,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAmBhB,YAAY;IA0C1B,OAAO,CAAC,sBAAsB;YAsBhB,SAAS;IAiBjB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAW7B"}