@omen.foundation/node-microservice-runtime 0.1.71 → 0.1.73

package/dist/cli/utils/name-utils.js

@@ -0,0 +1,42 @@
+/**
+ * Utility functions for transforming service names and validating naming conventions.
+ */
+/**
+ * Converts a string to PascalCase.
+ * @example "my-service" -> "MyService"
+ * @example "user_profile" -> "UserProfile"
+ */
+export function toPascalCase(str) {
+    return str
+        .split(/[-_\s]+/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+}
+/**
+ * Converts a string to kebab-case.
+ * @example "MyService" -> "my-service"
+ * @example "user_profile" -> "user-profile"
+ */
+export function toKebabCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/[_\s]+/g, '-')
+        .toLowerCase();
+}
+/**
+ * Converts a string to camelCase.
+ * @example "MyService" -> "myService"
+ * @example "user-profile" -> "userProfile"
+ */
+export function toCamelCase(str) {
+    const pascal = toPascalCase(str);
+    return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+/**
+ * Validates that a service name matches the required pattern.
+ * Only alphanumeric characters and underscores are allowed.
+ */
+export function validateServiceName(name) {
+    return /^[A-Za-z0-9_]+$/.test(name);
+}
+//# sourceMappingURL=name-utils.js.map

package/dist/cli/utils/name-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-utils.js","sourceRoot":"","sources":["../../../src/cli/utils/name-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG;SACP,KAAK,CAAC,SAAS,CAAC;SAChB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SACzE,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG;SACP,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC","sourcesContent":["/**\r\n * Utility functions for transforming service names and validating naming conventions.\r\n */\r\n\r\n/**\r\n * Converts a string to PascalCase.\r\n * @example \"my-service\" -> \"MyService\"\r\n * @example \"user_profile\" -> \"UserProfile\"\r\n */\r\nexport function toPascalCase(str: string): string {\r\n  return str\r\n    .split(/[-_\\s]+/)\r\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\r\n    .join('');\r\n}\r\n\r\n/**\r\n * Converts a string to kebab-case.\r\n * @example \"MyService\" -> \"my-service\"\r\n * @example \"user_profile\" -> \"user-profile\"\r\n */\r\nexport function toKebabCase(str: string): string {\r\n  return str\r\n    .replace(/([a-z])([A-Z])/g, '$1-$2')\r\n    .replace(/[_\\s]+/g, '-')\r\n    .toLowerCase();\r\n}\r\n\r\n/**\r\n * Converts a string to camelCase.\r\n * @example \"MyService\" -> \"myService\"\r\n * @example \"user-profile\" -> \"userProfile\"\r\n */\r\nexport function toCamelCase(str: string): string {\r\n  const pascal = toPascalCase(str);\r\n  return pascal.charAt(0).toLowerCase() + pascal.slice(1);\r\n}\r\n\r\n/**\r\n * Validates that a service name matches the required pattern.\r\n * Only alphanumeric characters and underscores are allowed.\r\n */\r\nexport function validateServiceName(name: string): boolean {\r\n  return /^[A-Za-z0-9_]+$/.test(name);\r\n}\r\n\r\n"]}

package/dist/cli/utils/prompt-utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Utility functions for interactive prompts in CLI commands.
+ */
+/**
+ * Prompts the user for input with an optional default value.
+ */
+export declare function promptInput(question: string, defaultValue?: string): Promise<string>;
+/**
+ * Prompts the user for a yes/no answer.
+ * @returns true if user answers 'y' or 'yes', false otherwise
+ */
+export declare function promptYesNo(question: string, defaultValue?: boolean): Promise<boolean>;
+//# sourceMappingURL=prompt-utils.d.ts.map

package/dist/cli/utils/prompt-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-utils.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/prompt-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS1F;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAczF"}

package/dist/cli/utils/prompt-utils.js

@@ -0,0 +1,39 @@
+/**
+ * Utility functions for interactive prompts in CLI commands.
+ */
+import readline from 'node:readline';
+import { stdin, stdout } from 'node:process';
+/**
+ * Prompts the user for input with an optional default value.
+ */
+export async function promptInput(question, defaultValue) {
+    const rl = readline.createInterface({ input: stdin, output: stdout });
+    return new Promise((resolve) => {
+        rl.question(defaultValue ? `${question} (${defaultValue}): ` : `${question}: `, (answer) => {
+            rl.close();
+            const value = answer.trim();
+            resolve(value === '' && defaultValue !== undefined ? defaultValue : value);
+        });
+    });
+}
+/**
+ * Prompts the user for a yes/no answer.
+ * @returns true if user answers 'y' or 'yes', false otherwise
+ */
+export async function promptYesNo(question, defaultValue = true) {
+    const rl = readline.createInterface({ input: stdin, output: stdout });
+    const defaultText = defaultValue ? 'Y/n' : 'y/N';
+    return new Promise((resolve) => {
+        rl.question(`${question} (${defaultText}): `, (answer) => {
+            rl.close();
+            const normalized = answer.trim().toLowerCase();
+            if (normalized === '') {
+                resolve(defaultValue);
+            }
+            else {
+                resolve(normalized === 'y' || normalized === 'yes');
+            }
+        });
+    });
+}
+//# sourceMappingURL=prompt-utils.js.map

package/dist/cli/utils/prompt-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-utils.js","sourceRoot":"","sources":["../../../src/cli/utils/prompt-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,YAAqB;IACvE,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACtE,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACrC,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,QAAQ,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE;YACzF,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,KAAK,EAAE,IAAI,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC7E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,YAAY,GAAG,IAAI;IACrE,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACtE,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IACjD,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QACtC,EAAE,CAAC,QAAQ,CAAC,GAAG,QAAQ,KAAK,WAAW,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE;YACvD,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC/C,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;gBACtB,OAAO,CAAC,YAAY,CAAC,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,CAAC,CAAC;YACtD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\r\n * Utility functions for interactive prompts in CLI commands.\r\n */\r\n\r\nimport readline from 'node:readline';\r\nimport { stdin, stdout } from 'node:process';\r\n\r\n/**\r\n * Prompts the user for input with an optional default value.\r\n */\r\nexport async function promptInput(question: string, defaultValue?: string): Promise<string> {\r\n  const rl = readline.createInterface({ input: stdin, output: stdout });\r\n  return new Promise<string>((resolve) => {\r\n    rl.question(defaultValue ? `${question} (${defaultValue}): ` : `${question}: `, (answer) => {\r\n      rl.close();\r\n      const value = answer.trim();\r\n      resolve(value === '' && defaultValue !== undefined ? defaultValue : value);\r\n    });\r\n  });\r\n}\r\n\r\n/**\r\n * Prompts the user for a yes/no answer.\r\n * @returns true if user answers 'y' or 'yes', false otherwise\r\n */\r\nexport async function promptYesNo(question: string, defaultValue = true): Promise<boolean> {\r\n  const rl = readline.createInterface({ input: stdin, output: stdout });\r\n  const defaultText = defaultValue ? 'Y/n' : 'y/N';\r\n  return new Promise<boolean>((resolve) => {\r\n    rl.question(`${question} (${defaultText}): `, (answer) => {\r\n      rl.close();\r\n      const normalized = answer.trim().toLowerCase();\r\n      if (normalized === '') {\r\n        resolve(defaultValue);\r\n      } else {\r\n        resolve(normalized === 'y' || normalized === 'yes');\r\n      }\r\n    });\r\n  });\r\n}\r\n\r\n"]}

package/dist/cli/utils/version-utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Utility functions for fetching the latest version of the Node Microservice Runtime from npm registry.
+ */
+/**
+ * Fetches the latest version of @omen.foundation/node-microservice-runtime from npm registry.
+ *
+ * @returns The latest version string (e.g., "0.1.68")
+ * @throws Error if version cannot be determined and no fallback is available
+ */
+export declare function fetchLatestRuntimeVersion(): Promise<string>;
+//# sourceMappingURL=version-utils.d.ts.map

package/dist/cli/utils/version-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-utils.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/version-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH;;;;;GAKG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,MAAM,CAAC,CAgDjE"}

package/dist/cli/utils/version-utils.js

@@ -0,0 +1,92 @@
+/**
+ * Utility functions for fetching the latest version of the Node Microservice Runtime from npm registry.
+ */
+/**
+ * Fetches the latest version of @omen.foundation/node-microservice-runtime from npm registry.
+ *
+ * @returns The latest version string (e.g., "0.1.68")
+ * @throws Error if version cannot be determined and no fallback is available
+ */
+export async function fetchLatestRuntimeVersion() {
+    const PACKAGE_NAME = '@omen.foundation/node-microservice-runtime';
+    const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}`;
+    const TIMEOUT_MS = 5000;
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);
+        const response = await fetch(REGISTRY_URL, {
+            signal: controller.signal,
+            headers: { Accept: 'application/json' },
+        });
+        clearTimeout(timeoutId);
+        if (!response.ok) {
+            throw new Error(`Registry returned ${response.status}`);
+        }
+        const data = (await response.json());
+        const latestVersion = data['dist-tags']?.latest;
+        if (latestVersion && typeof latestVersion === 'string') {
+            return latestVersion;
+        }
+        // Fallback: find highest version from versions object
+        const versions = Object.keys(data.versions || {});
+        if (versions.length > 0) {
+            // Sort versions semantically and return highest
+            const sorted = versions.sort((a, b) => compareVersions(b, a));
+            return sorted[0];
+        }
+        throw new Error('No versions found in registry response');
+    }
+    catch (error) {
+        // Try local fallback: check if we're in Microservice directory
+        const localVersion = await getLocalRuntimeVersion();
+        if (localVersion) {
+            console.warn(`Warning: Could not fetch from registry, using local version ${localVersion}`);
+            return localVersion;
+        }
+        // Final fallback: hardcoded minimum version
+        console.warn('Warning: Could not fetch latest version, using fallback version 0.1.0');
+        return '0.1.0';
+    }
+}
+/**
+ * Compares two semantic version strings.
+ * @returns Positive if a > b, negative if a < b, zero if equal
+ */
+function compareVersions(a, b) {
+    const partsA = a.split('.').map(Number);
+    const partsB = b.split('.').map(Number);
+    const maxLength = Math.max(partsA.length, partsB.length);
+    for (let i = 0; i < maxLength; i++) {
+        const partA = partsA[i] ?? 0;
+        const partB = partsB[i] ?? 0;
+        if (partA > partB)
+            return 1;
+        if (partA < partB)
+            return -1;
+    }
+    return 0;
+}
+/**
+ * Attempts to get the runtime version from a local package.json file.
+ * This is used as a fallback when the npm registry is unavailable.
+ */
+async function getLocalRuntimeVersion() {
+    try {
+        const fs = await import('node:fs/promises');
+        const path = await import('node:path');
+        const { fileURLToPath } = await import('node:url');
+        // Try to find package.json in the Microservice directory
+        const __dirname = path.dirname(fileURLToPath(import.meta.url));
+        const packageJsonPath = path.resolve(__dirname, '../../package.json');
+        const content = await fs.readFile(packageJsonPath, 'utf8');
+        const packageJson = JSON.parse(content);
+        if (packageJson.version && typeof packageJson.version === 'string') {
+            return packageJson.version;
+        }
+    }
+    catch {
+        // Ignore errors, return null to use final fallback
+    }
+    return null;
+}
+//# sourceMappingURL=version-utils.js.map

package/dist/cli/utils/version-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-utils.js","sourceRoot":"","sources":["../../../src/cli/utils/version-utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * Utility functions for fetching the latest version of the Node Microservice Runtime from npm registry.\r\n */\r\n\r\ninterface NpmRegistryResponse {\r\n  'dist-tags': {\r\n    latest: string;\r\n    [key: string]: string;\r\n  };\r\n  versions: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * Fetches the latest version of @omen.foundation/node-microservice-runtime from npm registry.\r\n * \r\n * @returns The latest version string (e.g., \"0.1.68\")\r\n * @throws Error if version cannot be determined and no fallback is available\r\n */\r\nexport async function fetchLatestRuntimeVersion(): Promise<string> {\r\n  const PACKAGE_NAME = '@omen.foundation/node-microservice-runtime';\r\n  const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}`;\r\n  const TIMEOUT_MS = 5000;\r\n\r\n  try {\r\n    const controller = new AbortController();\r\n    const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);\r\n\r\n    const response = await fetch(REGISTRY_URL, {\r\n      signal: controller.signal,\r\n      headers: { Accept: 'application/json' },\r\n    });\r\n\r\n    clearTimeout(timeoutId);\r\n\r\n    if (!response.ok) {\r\n      throw new Error(`Registry returned ${response.status}`);\r\n    }\r\n\r\n    const data = (await response.json()) as NpmRegistryResponse;\r\n    const latestVersion = data['dist-tags']?.latest;\r\n\r\n    if (latestVersion && typeof latestVersion === 'string') {\r\n      return latestVersion;\r\n    }\r\n\r\n    // Fallback: find highest version from versions object\r\n    const versions = Object.keys(data.versions || {});\r\n    if (versions.length > 0) {\r\n      // Sort versions semantically and return highest\r\n      const sorted = versions.sort((a, b) => compareVersions(b, a));\r\n      return sorted[0];\r\n    }\r\n\r\n    throw new Error('No versions found in registry response');\r\n  } catch (error) {\r\n    // Try local fallback: check if we're in Microservice directory\r\n    const localVersion = await getLocalRuntimeVersion();\r\n    if (localVersion) {\r\n      console.warn(`Warning: Could not fetch from registry, using local version ${localVersion}`);\r\n      return localVersion;\r\n    }\r\n\r\n    // Final fallback: hardcoded minimum version\r\n    console.warn('Warning: Could not fetch latest version, using fallback version 0.1.0');\r\n    return '0.1.0';\r\n  }\r\n}\r\n\r\n/**\r\n * Compares two semantic version strings.\r\n * @returns Positive if a > b, negative if a < b, zero if equal\r\n */\r\nfunction compareVersions(a: string, b: string): number {\r\n  const partsA = a.split('.').map(Number);\r\n  const partsB = b.split('.').map(Number);\r\n  const maxLength = Math.max(partsA.length, partsB.length);\r\n\r\n  for (let i = 0; i < maxLength; i++) {\r\n    const partA = partsA[i] ?? 0;\r\n    const partB = partsB[i] ?? 0;\r\n    if (partA > partB) return 1;\r\n    if (partA < partB) return -1;\r\n  }\r\n  return 0;\r\n}\r\n\r\n/**\r\n * Attempts to get the runtime version from a local package.json file.\r\n * This is used as a fallback when the npm registry is unavailable.\r\n */\r\nasync function getLocalRuntimeVersion(): Promise<string | null> {\r\n  try {\r\n    const fs = await import('node:fs/promises');\r\n    const path = await import('node:path');\r\n    const { fileURLToPath } = await import('node:url');\r\n\r\n    // Try to find package.json in the Microservice directory\r\n    const __dirname = path.dirname(fileURLToPath(import.meta.url));\r\n    const packageJsonPath = path.resolve(__dirname, '../../package.json');\r\n\r\n    const content = await fs.readFile(packageJsonPath, 'utf8');\r\n    const packageJson = JSON.parse(content) as { version?: string };\r\n\r\n    if (packageJson.version && typeof packageJson.version === 'string') {\r\n      return packageJson.version;\r\n    }\r\n  } catch {\r\n    // Ignore errors, return null to use final fallback\r\n  }\r\n  return null;\r\n}\r\n\r\n"]}

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAa,EAAe,KAAK,MAAM,EAAsB,MAAM,MAAM,CAAC;AAI1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAiCpD,UAAU,oBAAoB;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA0eD,wBAAgB,YAAY,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CA6L/F"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAa,EAAe,KAAK,MAAM,EAAsB,MAAM,MAAM,CAAC;AAI1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAiCpD,UAAU,oBAAoB;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAmmBD,wBAAgB,YAAY,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CA6L/F"}

package/dist/logger.js

@@ -51,6 +51,93 @@ function mapPinoLevelToBeamableLevel(level) {
             return 'Info';
     }
 }
+/**
+ * Initializes BetterStack OTLP log exporter if enabled.
+ * BetterStack is an optional logging provider that can be used alongside Beamable's ClickHouse logging
+ * for debugging and monitoring. This enables "double-pumping" logs to both ClickHouse and BetterStack.
+ *
+ * To enable BetterStack logging, set the following environment variables:
+ *   - BEAM_BETTERSTACK_ENABLED=true (or 1)
+ *   - BEAM_BETTERSTACK_TOKEN=<your-betterstack-ingestion-token>
+ *   - BEAM_BETTERSTACK_ENDPOINT=<optional-custom-endpoint> (defaults to https://in.logs.betterstack.com)
+ *
+ * Default ingestion token: QxFSMKUoS66bgA4aZmqih7ec (from created BetterStack source)
+ *
+ * Logs will be sent to both:
+ *   1. Beamable ClickHouse (via OTLP collector) - for Portal integration
+ *   2. BetterStack (via OTLP HTTP) - for debugging and monitoring
+ *
+ * @param serviceName - Service name for resource attributes
+ * @param qualifiedServiceName - Qualified service name for resource attributes
+ * @param env - Environment configuration
+ * @returns BetterStack OTLP exporter if configured, null otherwise
+ */
+async function initializeBetterStackLogging(serviceName, qualifiedServiceName, env) {
+    // Check if BetterStack logging is enabled
+    const betterStackEnabled = process.env.BEAM_BETTERSTACK_ENABLED === 'true' ||
+        process.env.BEAM_BETTERSTACK_ENABLED === '1';
+    if (!betterStackEnabled) {
+        return Promise.resolve(null);
+    }
+    // Get BetterStack configuration
+    // Token: Use BEAM_BETTERSTACK_TOKEN or BETTERSTACK_TOKEN environment variable
+    // Default token from created source: QxFSMKUoS66bgA4aZmqih7ec (can be overridden)
+    const betterStackToken = process.env.BEAM_BETTERSTACK_TOKEN || process.env.BETTERSTACK_TOKEN;
+    // Endpoint: BetterStack OTLP endpoint (defaults to EU region)
+    // Can be overridden via BEAM_BETTERSTACK_ENDPOINT or BETTERSTACK_ENDPOINT
+    const betterStackEndpoint = process.env.BEAM_BETTERSTACK_ENDPOINT ||
+        process.env.BETTERSTACK_ENDPOINT ||
+        'https://in.logs.betterstack.com';
+    if (!betterStackToken) {
+        console.warn('[BetterStack] BetterStack logging is enabled but BEAM_BETTERSTACK_TOKEN is not set. Skipping BetterStack logging.');
+        return Promise.resolve(null);
+    }
+    try {
+        // Build resource attributes (same as main OTLP)
+        const resourceAttributes = {};
+        if (serviceName) {
+            resourceAttributes['service.namespace'] = serviceName;
+            resourceAttributes['service.name'] = serviceName;
+        }
+        if (qualifiedServiceName) {
+            resourceAttributes['service.instance.id'] = qualifiedServiceName;
+        }
+        if (env?.cid) {
+            resourceAttributes['beam.cid'] = String(env.cid);
+        }
+        if (env?.pid) {
+            resourceAttributes['beam.pid'] = String(env.pid);
+        }
+        if (env?.routingKey) {
+            resourceAttributes['beam.routing_key'] = String(env.routingKey);
+        }
+        // BetterStack OTLP endpoint format
+        // BetterStack accepts OTLP logs at: https://in.logs.betterstack.com/v1/logs
+        const endpointUrl = betterStackEndpoint.includes('/v1/logs')
+            ? betterStackEndpoint
+            : `${betterStackEndpoint.replace(/\/$/, '')}/v1/logs`;
+        // Create OTLP HTTP exporter for BetterStack
+        // BetterStack supports OTLP HTTP with JSON or Protobuf
+        // Using JSON format for better compatibility
+        const exporterOptions = {
+            url: endpointUrl,
+            headers: {
+                'Authorization': `Bearer ${betterStackToken}`,
+            },
+            contentType: 'application/json', // BetterStack supports both JSON and Protobuf, JSON is more compatible
+        };
+        const exporter = new OTLPLogExporter(exporterOptions);
+        console.error(`[BetterStack] BetterStack logging initialized. Endpoint: ${endpointUrl}, Service: ${serviceName || 'unknown'}`);
+        return Promise.resolve(exporter);
+    }
+    catch (error) {
+        console.error('[BetterStack] Failed to initialize BetterStack logging:', error instanceof Error ? error.message : String(error));
+        if (error instanceof Error && error.stack) {
+            console.error('[BetterStack] Stack trace:', error.stack);
+        }
+        return Promise.resolve(null);
+    }
+}
 /**
  * Initializes OpenTelemetry OTLP log exporter if configured.
  * Similar to C# microservices, checks for BEAM_OTEL_EXPORTER_OTLP_ENDPOINT or uses standard enabled flag.
@@ -203,14 +290,27 @@ async function initializeOtlpLogging(serviceName, qualifiedServiceName, env, log
         const baseResource = defaultResource();
         const customResource = resourceFromAttributes(resourceAttributes);
         const resource = baseResource.merge(customResource);
-        // Create log record processor
+        // Create log record processor for Beamable ClickHouse
         // C# uses BatchLogRecordExportProcessor which batches logs for better performance
         // and includes retry logic. We should match this behavior.
-        const processor = new BatchLogRecordProcessor(exporter);
-        // Create logger provider with resource and processor
+        const processors = [new BatchLogRecordProcessor(exporter)];
+        // Optionally add BetterStack as a second exporter for double-pumping logs
+        // This allows developers to enable BetterStack for debugging/monitoring
+        try {
+            const betterStackExporter = await initializeBetterStackLogging(serviceName, qualifiedServiceName, env);
+            if (betterStackExporter) {
+                processors.push(new BatchLogRecordProcessor(betterStackExporter));
+                console.error('[BetterStack] BetterStack exporter added as second processor - logs will be sent to both ClickHouse and BetterStack');
+            }
+        }
+        catch (error) {
+            // If BetterStack initialization fails, continue without it
+            console.warn('[BetterStack] Failed to initialize BetterStack exporter (continuing without it):', error instanceof Error ? error.message : String(error));
+        }
+        // Create logger provider with resource and processors (both ClickHouse and optionally BetterStack)
         const loggerProvider = new LoggerProvider({
             resource: resource,
-            processors: [processor],
+            processors: processors,
         });
         // Set as global logger provider
         logs.setGlobalLoggerProvider(loggerProvider);