@omen.foundation/node-microservice-runtime 0.1.76 → 0.1.78

package/dist/services.cjs

@@ -0,0 +1,356 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BeamableServiceManager = void 0;
+const pino_1 = __importDefault(require("pino"));
+const beamable_sdk_1 = require("beamable-sdk");
+const urls_js_1 = require("./utils/urls.js");
+const inventory_js_1 = require("./inventory.js");
+const storage_js_1 = require("./storage.js");
+const errors_js_1 = require("./errors.js");
+const RUNTIME_ENVIRONMENT_NAME = 'node-runtime';
+let cachedBeamApiModule = null;
+async function resolveBeamApiModule() {
+    if (!cachedBeamApiModule) {
+        const imported = await Promise.resolve().then(() => __importStar(require('beamable-sdk/api')));
+        cachedBeamApiModule =
+            imported && typeof imported === 'object' && 'default' in imported
+                ? imported.default
+                : imported;
+    }
+    return cachedBeamApiModule;
+}
+async function bindBeamApi(requester) {
+    const module = await resolveBeamApiModule();
+    const bound = {};
+    for (const key of Object.keys(module)) {
+        const value = module[key];
+        if (typeof value === 'function') {
+            bound[key] = (...args) => value(requester, ...args);
+        }
+    }
+    return bound;
+}
+function createFailingApi(error) {
+    return new Proxy({}, {
+        get() {
+            throw error;
+        },
+    });
+}
+class UnavailableRequester {
+    constructor(error) {
+        this.error = error;
+    }
+    async request() {
+        throw this.error;
+    }
+    set baseUrl(_) {
+    }
+    set defaultHeaders(_) {
+    }
+}
+class UnavailableBeamableServices {
+    constructor(error) {
+        this.error = error;
+        this.requesterImpl = new UnavailableRequester(this.error);
+        this.apiBindings = createFailingApi(this.error);
+    }
+    fail() {
+        throw this.error;
+    }
+    get account() {
+        return this.fail();
+    }
+    get announcements() {
+        return this.fail();
+    }
+    get auth() {
+        return this.fail();
+    }
+    get content() {
+        return this.fail();
+    }
+    get leaderboards() {
+        return this.fail();
+    }
+    get stats() {
+        return this.fail();
+    }
+    get inventory() {
+        return this.fail();
+    }
+    get storage() {
+        return this.fail();
+    }
+    get federation() {
+        return this.fail();
+    }
+    get api() {
+        return this.apiBindings;
+    }
+    get requester() {
+        return this.requesterImpl;
+    }
+    hasScopes(..._scopes) {
+        return false;
+    }
+    requireScopes(...scopes) {
+        throw new errors_js_1.MissingScopesError(scopes);
+    }
+    assumeUser() {
+        return this;
+    }
+    getLogger() {
+        return (0, pino_1.default)({ name: 'beamable-unavailable', level: 'info' }, process.stdout);
+    }
+}
+class BeamableServicesFacade {
+    constructor(manager, beamServer, userId, scopes, serviceName) {
+        this.manager = manager;
+        this.beamServer = beamServer;
+        this.userId = userId;
+        this.cache = {};
+        this.apiBindings = this.manager.getBoundApi();
+        this.storageService = this.manager.getStorageService();
+        this.scopes = scopes;
+        this.serviceName = serviceName;
+        this.federationRegistry = serviceName ? this.manager.getFederationRegistry(serviceName) : undefined;
+        this.logger = this.manager.getLogger().child({ component: 'BeamableServicesFacade', service: serviceName });
+    }
+    getOrCreate(key, factory) {
+        if (!this.cache[key]) {
+            this.cache[key] = factory();
+        }
+        return this.cache[key];
+    }
+    get account() {
+        return this.getOrCreate('account', () => this.beamServer.account(this.userId));
+    }
+    get announcements() {
+        return this.getOrCreate('announcements', () => this.beamServer.announcements(this.userId));
+    }
+    get auth() {
+        return this.getOrCreate('auth', () => this.beamServer.auth(this.userId));
+    }
+    get content() {
+        return this.getOrCreate('content', () => this.beamServer.content(this.userId));
+    }
+    get leaderboards() {
+        return this.getOrCreate('leaderboards', () => this.beamServer.leaderboards(this.userId));
+    }
+    get stats() {
+        return this.getOrCreate('stats', () => this.beamServer.stats(this.userId));
+    }
+    get inventory() {
+        if (!this.inventoryClient) {
+            this.inventoryClient = (0, inventory_js_1.createInventoryService)(this.apiBindings, this.logger.child({ component: 'InventoryClient' }), this.userId, (requiredScopes) => this.hasScopes(...requiredScopes));
+        }
+        return this.inventoryClient;
+    }
+    get storage() {
+        return this.storageService;
+    }
+    get federation() {
+        if (!this.federationRegistry) {
+            throw new Error(this.serviceName
+                ? `Federation registry is not configured for service "${this.serviceName}".`
+                : 'Federation registry is not configured.');
+        }
+        return this.federationRegistry;
+    }
+    get api() {
+        return this.apiBindings;
+    }
+    get requester() {
+        return this.manager.getRequester();
+    }
+    hasScopes(...requiredScopes) {
+        if (requiredScopes.length === 0) {
+            return true;
+        }
+        return requiredScopes.every((scope) => this.scopeSetHas(scope));
+    }
+    requireScopes(...requiredScopes) {
+        if (!this.hasScopes(...requiredScopes)) {
+            throw new errors_js_1.MissingScopesError(requiredScopes);
+        }
+    }
+    assumeUser(userId) {
+        return this.manager.createFacade(String(userId), new Set(this.scopes), this.serviceName);
+    }
+    getLogger() {
+        return this.logger;
+    }
+    scopeSetHas(scope) {
+        const normalized = scope.trim().toLowerCase();
+        if (!normalized) {
+            return false;
+        }
+        return this.scopes.has('*') || this.scopes.has(normalized);
+    }
+}
+class BeamableServiceManager {
+    constructor(env, logger) {
+        var _a;
+        this.initialized = false;
+        this.federationRegistries = new Map();
+        this.env = env;
+        this.logger = logger.child({ component: 'BeamableServiceManager' });
+        this.tokenStorage = (0, beamable_sdk_1.defaultTokenStorage)({ pid: env.pid, tag: (_a = env.routingKey) !== null && _a !== void 0 ? _a : RUNTIME_ENVIRONMENT_NAME });
+    }
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        this.registerEnvironment();
+        this.configureSharedEnvironment();
+        if (this.env.refreshToken) {
+            await this.tokenStorage.setTokenData({ refreshToken: this.env.refreshToken });
+        }
+        const useSignedRequest = Boolean(this.env.secret);
+        if (!useSignedRequest && !this.env.refreshToken) {
+            this.logger.warn('Beamable realm secret and refresh token are both missing; Beamable SDK requests may fail due to missing credentials.');
+        }
+        try {
+            this.beamServer = await beamable_sdk_1.BeamServer.init({
+                cid: this.env.cid,
+                pid: this.env.pid,
+                environment: RUNTIME_ENVIRONMENT_NAME,
+                useSignedRequest,
+                tokenStorage: this.tokenStorage,
+                serverEvents: { enabled: false },
+            });
+        }
+        catch (error) {
+            this.logger.error({ err: error }, 'Failed to initialize Beamable SDK. Services layer will be unavailable.');
+            this.beamServer = undefined;
+            this.initialized = false;
+            return;
+        }
+        this.boundApi = await bindBeamApi(this.beamServer.requester);
+        this.storageService = new storage_js_1.StorageService({
+            requester: this.beamServer.requester,
+            api: this.boundApi,
+            env: this.env,
+            logger: this.logger.child({ component: 'StorageService' }),
+        });
+        this.registerDefaultServices();
+        this.initialized = true;
+        this.logger.debug('Beamable SDK services initialized.');
+    }
+    createFacade(userId, scopes, serviceName) {
+        if (!this.initialized || !this.beamServer || !this.boundApi || !this.storageService) {
+            return new UnavailableBeamableServices(new Error('Beamable services are not initialized.'));
+        }
+        if (serviceName && this.beamServer.requester) {
+            const fullRoutingKey = `micro_${serviceName}:${this.env.routingKey}`;
+            beamable_sdk_1.BeamServer.env.BEAM_ROUTING_KEY = fullRoutingKey;
+            const scopeHeader = `${this.env.cid}.${this.env.pid}`;
+            this.beamServer.requester.defaultHeaders = {
+                ...this.beamServer.requester.defaultHeaders,
+                'X-BEAM-SCOPE': scopeHeader,
+                'X-BEAM-SERVICE-ROUTING-KEY': fullRoutingKey,
+            };
+        }
+        return new BeamableServicesFacade(this, this.beamServer, String(userId), new Set(scopes), serviceName);
+    }
+    getRequester() {
+        if (!this.initialized || !this.beamServer) {
+            return new UnavailableRequester(new Error('Beamable services are not initialized.'));
+        }
+        return this.beamServer.requester;
+    }
+    getBoundApi() {
+        if (!this.boundApi) {
+            throw new Error('Beamable bound API is not available.');
+        }
+        return this.boundApi;
+    }
+    getStorageService() {
+        if (!this.storageService) {
+            throw new Error('Storage service is not initialized.');
+        }
+        return this.storageService;
+    }
+    getLogger() {
+        return this.logger;
+    }
+    registerFederationRegistry(serviceName, registry) {
+        this.federationRegistries.set(serviceName, registry);
+    }
+    getFederationRegistry(serviceName) {
+        return this.federationRegistries.get(serviceName);
+    }
+    registerEnvironment() {
+        const apiUrl = (0, urls_js_1.hostToHttpUrl)(this.env.host);
+        const portalUrl = (0, urls_js_1.hostToPortalUrl)(apiUrl);
+        const storageUrl = (0, urls_js_1.hostToStorageUrl)(apiUrl);
+        const registryUrl = (0, urls_js_1.hostToMicroserviceRegistryUrl)(apiUrl);
+        try {
+            beamable_sdk_1.BeamEnvironment.register(RUNTIME_ENVIRONMENT_NAME, {
+                apiUrl,
+                portalUrl,
+                beamMongoExpressUrl: storageUrl,
+                dockerRegistryUrl: `${registryUrl}/v2/`,
+            });
+        }
+        catch (error) {
+            this.logger.debug({ err: error }, 'Beamable environment was already registered. Reusing existing configuration.');
+        }
+    }
+    configureSharedEnvironment() {
+        var _a;
+        if (this.env.secret) {
+            beamable_sdk_1.BeamServer.env.BEAM_REALM_SECRET = this.env.secret;
+        }
+        beamable_sdk_1.BeamServer.env.BEAM_ROUTING_KEY = (_a = this.env.routingKey) !== null && _a !== void 0 ? _a : '';
+    }
+    registerDefaultServices() {
+        if (!this.beamServer) {
+            return;
+        }
+        this.beamServer.use(beamable_sdk_1.AccountService);
+        this.beamServer.use(beamable_sdk_1.AnnouncementsService);
+        this.beamServer.use(beamable_sdk_1.AuthService);
+        this.beamServer.use(beamable_sdk_1.ContentService);
+        this.beamServer.use(beamable_sdk_1.LeaderboardsService);
+        this.beamServer.use(beamable_sdk_1.StatsService);
+    }
+}
+exports.BeamableServiceManager = BeamableServiceManager;

package/dist/storage.cjs

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageService = void 0;
+exports.StorageObject = StorageObject;
+exports.getStorageMetadata = getStorageMetadata;
+exports.listRegisteredStorageObjects = listRegisteredStorageObjects;
+const mongodb_1 = require("mongodb");
+const STORAGE_OBJECT_METADATA = new Map();
+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() });
+    };
+}
+function getStorageMetadata(target) {
+    return STORAGE_OBJECT_METADATA.get(target);
+}
+function listRegisteredStorageObjects() {
+    return Array.from(STORAGE_OBJECT_METADATA.values());
+}
+const CONNECTION_STRING_ENV_PREFIX = 'STORAGE_CONNSTR_';
+class StorageService {
+    constructor(dependencies) {
+        this.databaseCache = new Map();
+        this.clientCache = new Map();
+        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 = {}) {
+        var _a;
+        const database = await this.getDatabase(storageName, options);
+        const collectionName = (_a = options.collectionName) === null || _a === void 0 ? void 0 : _a.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 = {}) {
+        var _a, _b;
+        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 = (_b = (_a = options.collectionName) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : 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 mongodb_1.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;
+    }
+}
+exports.StorageService = StorageService;

package/dist/types.cjs

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

package/dist/types.d.ts

@@ -70,6 +70,7 @@ export interface RequestContext {
     userId: number;
     payload?: unknown;
     body?: Record<string, unknown>;
+    query: Record<string, string | string[]>;
     scopes: Set<string>;
     headers: Record<string, string>;
     cid: string;

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +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"]}
+{"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  query: Record<string, string | string[]>;\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');
+}