@bopen-io/messagebox-server 1.2.1 → 1.2.3

package/out/knexfile.js

@@ -0,0 +1,25 @@
+import dotenv from 'dotenv';
+dotenv.config();
+const connectionConfig = process.env.KNEX_DB_CONNECTION != null && process.env.KNEX_DB_CONNECTION.trim() !== ''
+    ? JSON.parse(process.env.KNEX_DB_CONNECTION)
+    : undefined;
+const config = {
+    client: process.env.KNEX_DB_CLIENT ?? 'mysql2',
+    connection: connectionConfig,
+    useNullAsDefault: true,
+    migrations: {
+        directory: './out/src/migrations'
+    },
+    pool: {
+        min: 0,
+        max: 7,
+        idleTimeoutMillis: 15000
+    }
+};
+const knexfile = {
+    development: config,
+    staging: config,
+    production: config
+};
+export default knexfile;
+//# sourceMappingURL=knexfile.js.map

package/out/knexfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knexfile.js","sourceRoot":"","sources":["../knexfile.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAA;AAE3B,MAAM,CAAC,MAAM,EAAE,CAAA;AAEf,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE;IAC7G,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC5C,CAAC,CAAC,SAAS,CAAA;AAEb,MAAM,MAAM,GAAgB;IAC1B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,QAAQ;IAC9C,UAAU,EAAE,gBAAgB;IAC5B,gBAAgB,EAAE,IAAI;IACtB,UAAU,EAAE;QACV,SAAS,EAAE,sBAAsB;KAClC;IACD,IAAI,EAAE;QACJ,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,iBAAiB,EAAE,KAAK;KACzB;CACF,CAAA;AAED,MAAM,QAAQ,GAAmC;IAC/C,WAAW,EAAE,MAAM;IACnB,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,MAAM;CACnB,CAAA;AAED,eAAe,QAAQ,CAAA"}

package/out/src/__tests/compose.test.js

@@ -0,0 +1,25 @@
+/* eslint-env jest */
+import knexLib from 'knex';
+import { createMessageBoxContext, createMessageBoxApp, mountMessageBoxRoutes } from '../compose.js';
+describe('compose API', () => {
+    it('createMessageBoxContext requires wallet and knex', () => {
+        expect(() => createMessageBoxContext({})).toThrow(/wallet/);
+    });
+    it('mountMessageBoxRoutes attaches without throwing', () => {
+        const knexConfig = { client: 'mysql2', connection: {}, useNullAsDefault: true };
+        const knex = knexLib.default?.(knexConfig) ?? knexLib(knexConfig);
+        const wallet = {
+            getPublicKey: async () => ({ publicKey: '02' + '11'.repeat(32) })
+        };
+        const app = createMessageBoxApp();
+        const ctx = createMessageBoxContext({
+            wallet,
+            knex,
+            enableSwagger: false,
+            enableWebSockets: false
+        });
+        expect(() => { mountMessageBoxRoutes(app, ctx); }).not.toThrow();
+        expect(typeof app.use).toBe('function');
+    });
+});
+//# sourceMappingURL=compose.test.js.map

package/out/src/__tests/compose.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.test.js","sourceRoot":"","sources":["../../../src/__tests/compose.test.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,OAAO,MAAM,MAAM,CAAA;AAC1B,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,eAAe,CAAA;AAEtB,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC,EAAS,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IACpE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,UAAU,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAA;QAC/E,MAAM,IAAI,GAAI,OAAe,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,IAAK,OAAe,CAAC,UAAU,CAAC,CAAA;QACnF,MAAM,MAAM,GAAG;YACb,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;SAC3D,CAAA;QACR,MAAM,GAAG,GAAG,mBAAmB,EAAE,CAAA;QACjC,MAAM,GAAG,GAAG,uBAAuB,CAAC;YAClC,MAAM;YACN,IAAI;YACJ,aAAa,EAAE,KAAK;YACpB,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAA;QACF,MAAM,CAAC,GAAG,EAAE,GAAG,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;QAC/D,MAAM,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/out/src/app.js

@@ -0,0 +1,162 @@
+/**
+ * @file app.ts
+ * @description
+ * Initializes the MessageBoxServer Express app.
+ *
+ * Responsibilities:
+ * - Parses environment variables and loads config
+ * - Sets up Knex for DB access
+ * - Initializes WalletClient from the BSV SDK
+ * - Mounts Express routes (pre-auth and post-auth)
+ * - Applies auth middleware using wallet identity
+ *
+ * This file exports:
+ * - `app`: the configured Express instance
+ * - `walletReady`: a promise that resolves once the wallet is ready
+ * - `getWallet()`: async accessor for the WalletClient
+ * - `useRoutes()`: middleware + route initialization
+ * - `appReady`: promise that completes once all setup is done
+ */
+import * as dotenv from 'dotenv';
+import express from 'express';
+import bodyParser from 'body-parser';
+import { preAuth, postAuth } from './routes/index.js';
+import { Logger } from './utils/logger.js';
+import sendMessageRoute from './routes/sendMessage.js';
+import { Setup } from '@bsv/wallet-toolbox';
+import knexLib from 'knex';
+import knexConfig from '../knexfile.js';
+import { createAuthMiddleware } from '@bsv/auth-express-middleware';
+import { createPaymentMiddleware } from '@bsv/payment-express-middleware';
+import { setupSwagger } from './swagger.js';
+import { bindMessageBoxRuntime } from './runtimeDeps.js';
+import * as crypto from 'crypto';
+global.self = { crypto };
+dotenv.config();
+// Create the Express app instance
+export const app = express();
+// Load environment variables
+const { NODE_ENV = 'development', ROUTING_PREFIX = '', SERVER_PRIVATE_KEY, WALLET_STORAGE_URL, BSV_NETWORK = 'mainnet' } = process.env;
+// Enable logger in dev mode or if explicitly enabled
+if (NODE_ENV === 'development' || process.env.LOGGING_ENABLED === 'true') {
+    Logger.enable();
+}
+/**
+ * Knex instance connected based on environment (development, production, or staging).
+ */
+export const knex = knexLib.default?.(NODE_ENV === 'production' || NODE_ENV === 'staging'
+    ? knexConfig.production
+    : knexConfig.development) ?? knexLib(NODE_ENV === 'production' || NODE_ENV === 'staging'
+    ? knexConfig.production
+    : knexConfig.development);
+// Wallet initialization logic
+let _wallet;
+let _resolveReady;
+export const walletReady = new Promise((resolve) => {
+    _resolveReady = resolve;
+});
+/**
+ * @function initializeWallet
+ * @description Initializes the WalletClient with a root identity key and storage backend.
+ *
+ * Loads configuration from the environment and connects to the wallet service.
+ *
+ * @returns {Promise<void>} Resolves when the wallet is initialized.
+ * @throws If SERVER_PRIVATE_KEY is missing or invalid.
+ */
+export async function initializeWallet() {
+    if (SERVER_PRIVATE_KEY == null || SERVER_PRIVATE_KEY.trim() === '') {
+        throw new Error('SERVER_PRIVATE_KEY is not defined in environment variables.');
+    }
+    _wallet = await Setup.createWalletClientNoEnv({
+        chain: BSV_NETWORK === 'testnet' ? 'test' : 'main',
+        rootKeyHex: SERVER_PRIVATE_KEY,
+        storageUrl: WALLET_STORAGE_URL
+    });
+    bindMessageBoxRuntime({ knex, wallet: _wallet });
+    _resolveReady();
+}
+/**
+ * @function getWallet
+ * @description Waits for the WalletClient to be ready and returns the instance.
+ *
+ * @returns {Promise<WalletInterface>} The initialized wallet client
+ * @throws {Error} If called before the wallet is initialized
+ */
+export async function getWallet() {
+    await walletReady;
+    if (_wallet == null) {
+        throw new Error('Wallet has not been initialized yet.');
+    }
+    return _wallet;
+}
+// Run on app startup to prep wallet and activate routes
+export const appReady = (async () => {
+    await initializeWallet();
+    await useRoutes();
+})();
+/**
+ * @function useRoutes
+ * @description Registers all routes and middleware on the Express app instance.
+ *
+ * Steps:
+ * - Applies JSON body parser
+ * - Enables CORS headers for all routes
+ * - Waits for WalletClient to initialize
+ * - Adds authentication middleware
+ * - Mounts pre-auth and post-auth route handlers
+ *
+ * @returns {Promise<void>} Once all middleware and routes are mounted
+ * @throws If wallet is not available when needed
+ */
+export async function useRoutes() {
+    // Parse incoming JSON bodies with a high limit
+    app.use(bodyParser.json({ limit: '1gb', type: 'application/json' }));
+    // CORS setup
+    app.use((req, res, next) => {
+        res.header('Access-Control-Allow-Origin', '*');
+        res.header('Access-Control-Allow-Headers', '*');
+        res.header('Access-Control-Allow-Methods', '*');
+        res.header('Access-Control-Expose-Headers', '*');
+        res.header('Access-Control-Allow-Private-Network', 'true');
+        if (req.method === 'OPTIONS') {
+            res.sendStatus(200);
+        }
+        else {
+            next();
+        }
+    });
+    // Enable Swagger docs
+    setupSwagger(app);
+    await walletReady;
+    if (_wallet == null) {
+        throw new Error('Wallet is not initialized for auth middleware');
+    }
+    app.use(createAuthMiddleware({
+        wallet: _wallet,
+        logger: console
+    }));
+    app.use(createPaymentMiddleware({
+        wallet: _wallet,
+        calculateRequestPrice: async (req) => {
+            if (req.url.includes('/sendMessage')) {
+                // TODO: Configure a custom price calculation as needed.
+            }
+            return 0;
+        }
+    }));
+    // Register pre-authentication routes (no auth required)
+    preAuth.forEach((route) => {
+        app[route.type](`${String(ROUTING_PREFIX)}${String(route.path)}`, route.func);
+    });
+    // Register post-authentication routes (requires auth header)
+    postAuth.forEach((route) => {
+        if (route.path === '/sendMessage') {
+            app[route.type](`${ROUTING_PREFIX}${route.path}`, sendMessageRoute.func);
+        }
+        else {
+            app[route.type](`${ROUTING_PREFIX}${route.path}`, route.func);
+        }
+    });
+}
+//# sourceMappingURL=app.js.map

package/out/src/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAChC,OAAO,OAMN,MAAM,SAAS,CAAA;AAChB,OAAO,UAAU,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,gBAAgB,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAC3C,OAAO,OAAiB,MAAM,MAAM,CAAA;AACpC,OAAO,UAAU,MAAM,gBAAgB,CAAA;AAEvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAC/B,MAAM,CAAC,IAAY,GAAG,EAAE,MAAM,EAAE,CAAA;AAEjC,MAAM,CAAC,MAAM,EAAE,CAAA;AAEf,kCAAkC;AAClC,MAAM,CAAC,MAAM,GAAG,GAAY,OAAO,EAAE,CAAA;AAErC,6BAA6B;AAC7B,MAAM,EACJ,QAAQ,GAAG,aAAa,EACxB,cAAc,GAAG,EAAE,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,GAAG,SAAS,EACxB,GAAG,OAAO,CAAC,GAAG,CAAA;AAEf,qDAAqD;AACrD,IAAI,QAAQ,KAAK,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,MAAM,EAAE,CAAC;IACzE,MAAM,CAAC,MAAM,EAAE,CAAA;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAU,OAAe,CAAC,OAAO,EAAE,CAClD,QAAQ,KAAK,YAAY,IAAI,QAAQ,KAAK,SAAS;IACjD,CAAC,CAAC,UAAU,CAAC,UAAU;IACvB,CAAC,CAAC,UAAU,CAAC,WAAW,CAC3B,IAAK,OAAe,CACnB,QAAQ,KAAK,YAAY,IAAI,QAAQ,KAAK,SAAS;IACjD,CAAC,CAAC,UAAU,CAAC,UAAU;IACvB,CAAC,CAAC,UAAU,CAAC,WAAW,CAC3B,CAAA;AAED,8BAA8B;AAC9B,IAAI,OAAoC,CAAA;AACxC,IAAI,aAAyB,CAAA;AAC7B,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;IACvD,aAAa,GAAG,OAAO,CAAA;AACzB,CAAC,CAAC,CAAA;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,kBAAkB,IAAI,IAAI,IAAI,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAA;IAChF,CAAC;IAED,OAAO,GAAG,MAAM,KAAK,CAAC,uBAAuB,CAAC;QAC5C,KAAK,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QAClD,UAAU,EAAE,kBAAkB;QAC9B,UAAU,EAAE,kBAAkB;KAC/B,CAAC,CAAA;IAEF,qBAAqB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;IAChD,aAAa,EAAE,CAAA;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,WAAW,CAAA;IACjB,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;IACzD,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAK,IAAI,EAAE;IAClC,MAAM,gBAAgB,EAAE,CAAA;IACxB,MAAM,SAAS,EAAE,CAAA;AACnB,CAAC,CAAC,EAAE,CAAA;AAEJ;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,+CAA+C;IAC/C,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAA;IAEpE,aAAa;IACb,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACzB,GAAG,CAAC,MAAM,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAA;QAC9C,GAAG,CAAC,MAAM,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAA;QAC/C,GAAG,CAAC,MAAM,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAA;QAC/C,GAAG,CAAC,MAAM,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAA;QAChD,GAAG,CAAC,MAAM,CAAC,sCAAsC,EAAE,MAAM,CAAC,CAAA;QAE1D,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7B,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;QACrB,CAAC;aAAM,CAAC;YACN,IAAI,EAAE,CAAA;QACR,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,sBAAsB;IACtB,YAAY,CAAC,GAAG,CAAC,CAAA;IAEjB,MAAM,WAAW,CAAA;IACjB,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;IAClE,CAAC;IAED,GAAG,CAAC,GAAG,CACL,oBAAoB,CAAC;QACnB,MAAM,EAAE,OAAO;QACf,MAAM,EAAE,OAAO;KAChB,CAAC,CACH,CAAA;IAED,GAAG,CAAC,GAAG,CACL,uBAAuB,CAAC;QACtB,MAAM,EAAE,OAAO;QACf,qBAAqB,EAAE,KAAK,EAAE,GAAY,EAAE,EAAE;YAC5C,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBACrC,wDAAwD;YAC1D,CAAC;YACD,OAAO,CAAC,CAAA;QACV,CAAC;KACF,CAAC,CACH,CAAA;IAED,wDAAwD;IACxD,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACxB,GAAG,CAAC,KAAK,CAAC,IAAyC,CAAC,CAClD,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAChD,KAAK,CAAC,IAAmF,CAC1F,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACzB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAClC,GAAG,CAAC,KAAK,CAAC,IAAyC,CAAC,CAClD,GAAG,cAAc,GAAG,KAAK,CAAC,IAAI,EAAE,EAChC,gBAAgB,CAAC,IAAiC,CACnD,CAAA;QACH,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,CAAC,IAAyC,CAAC,CAClD,GAAG,cAAc,GAAG,KAAK,CAAC,IAAI,EAAE,EAChC,KAAK,CAAC,IAAsB,CAC7B,CAAA;QACH,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/out/src/compose.js

@@ -0,0 +1,239 @@
+/**
+ * Composable entrypoints for embedding messagebox in a parent app.
+ * Standalone binary continues to use index.ts → app.ts as before.
+ */
+import express, { Router } from 'express';
+import bodyParser from 'body-parser';
+import { PublicKey } from '@bsv/sdk';
+import { createAuthMiddleware } from '@bsv/auth-express-middleware';
+import { createPaymentMiddleware } from '@bsv/payment-express-middleware';
+import { AuthSocketServer } from '@bsv/authsocket';
+import { preAuth, postAuth } from './routes/index.js';
+import sendMessageRoute from './routes/sendMessage.js';
+import { setupSwagger } from './swagger.js';
+import { Logger } from './utils/logger.js';
+import { bindMessageBoxRuntime } from './runtimeDeps.js';
+export { createMessageBoxContext } from './context.js';
+export function createMessageBoxApp() {
+    return express();
+}
+/**
+ * Mount messagebox HTTP routes on an Express app.
+ * Auth/payment middleware apply only to this router (not the parent app).
+ */
+export function mountMessageBoxRoutes(app, ctx) {
+    bindMessageBoxRuntime({ knex: ctx.knex, wallet: ctx.wallet });
+    const router = Router();
+    router.use(bodyParser.json({ limit: '1gb', type: 'application/json' }));
+    router.use((req, res, next) => {
+        res.header('Access-Control-Allow-Origin', '*');
+        res.header('Access-Control-Allow-Headers', '*');
+        res.header('Access-Control-Allow-Methods', '*');
+        res.header('Access-Control-Expose-Headers', '*');
+        res.header('Access-Control-Allow-Private-Network', 'true');
+        if (req.method === 'OPTIONS') {
+            res.sendStatus(200);
+        }
+        else {
+            next();
+        }
+    });
+    if (ctx.enableSwagger) {
+        setupSwagger(app);
+    }
+    preAuth.forEach((route) => {
+        router[route.type](route.path, route.func);
+    });
+    router.use(createAuthMiddleware({
+        wallet: ctx.wallet,
+        logger: ctx.logger
+    }));
+    router.use(createPaymentMiddleware({
+        wallet: ctx.wallet,
+        calculateRequestPrice: async (req) => await Promise.resolve(ctx.calculateRequestPrice(req))
+    }));
+    postAuth.forEach((route) => {
+        const method = route.type;
+        if (route.path === '/sendMessage') {
+            router[method](route.path, sendMessageRoute.func);
+        }
+        else {
+            router[method](route.path, route.func);
+        }
+    });
+    const prefix = ctx.routingPrefix ?? '';
+    app.use(prefix === '' ? '/' : prefix, router);
+}
+/**
+ * Attach authenticated WebSocket handlers. Mirrors standalone index.ts behavior
+ * with injected wallet/knex instead of module singletons.
+ */
+export function attachMessageBoxWebSockets(httpServer, ctx) {
+    if (!ctx.enableWebSockets) {
+        return null;
+    }
+    bindMessageBoxRuntime({ knex: ctx.knex, wallet: ctx.wallet });
+    Logger.log('[WEBSOCKET] Initializing WebSocket support...');
+    const io = new AuthSocketServer(httpServer, {
+        wallet: ctx.wallet,
+        cors: {
+            origin: '*',
+            methods: ['GET', 'POST']
+        }
+    });
+    const knex = ctx.knex;
+    const authenticatedSockets = new Map();
+    io.on('connection', (socket) => {
+        Logger.log('[WEBSOCKET] New connection established.');
+        if (typeof socket.identityKey === 'string' && socket.identityKey.trim() !== '') {
+            try {
+                const parsedIdentityKey = PublicKey.fromString(socket.identityKey);
+                Logger.log('[DEBUG] Parsed WebSocket Identity Key Successfully:', parsedIdentityKey.toString());
+                authenticatedSockets.set(socket.id, parsedIdentityKey.toString());
+                Logger.log('[WEBSOCKET] Identity key stored for socket ID:', socket.id);
+                void socket.emit('authenticationSuccess', { status: 'success' });
+            }
+            catch (error) {
+                Logger.error('[ERROR] Failed to parse WebSocket identity key:', error);
+            }
+        }
+        else {
+            Logger.warn('[WARN] WebSocket connection received without identity key. Waiting for authentication...');
+            let identityKeyHandled = false;
+            const authListener = async (data) => {
+                if (identityKeyHandled)
+                    return;
+                Logger.log('[WEBSOCKET] Received authentication data:', data);
+                if (data?.identityKey != null && data.identityKey.trim().length > 0) {
+                    try {
+                        const parsedIdentityKey = PublicKey.fromString(data.identityKey);
+                        authenticatedSockets.set(socket.id, parsedIdentityKey.toString());
+                        identityKeyHandled = true;
+                        await socket.emit('authenticationSuccess', { status: 'success' }).catch(error => {
+                            Logger.error('[WEBSOCKET ERROR] Failed to send authentication success event:', error);
+                        });
+                    }
+                    catch (error) {
+                        Logger.error('[ERROR] Failed to parse Identity Key from authenticated event:', error);
+                        await socket.emit('authenticationFailed', { reason: 'Invalid identity key format' });
+                    }
+                }
+                else {
+                    Logger.warn('[WARN] Invalid or missing identity key in authentication event.');
+                    await socket.emit('authenticationFailed', { reason: 'Missing identity key' });
+                }
+            };
+            socket.on('authenticated', authListener);
+        }
+        socket.on('sendMessage', async (data) => {
+            if (typeof data !== 'object' || data == null) {
+                Logger.error('[WEBSOCKET ERROR] Invalid data object received.');
+                await socket.emit('messageFailed', { reason: 'Invalid data object' });
+                return;
+            }
+            const { roomId, message } = data;
+            if (!authenticatedSockets.has(socket.id)) {
+                Logger.warn('[WEBSOCKET] Unauthorized attempt to send a message.');
+                await socket.emit('paymentFailed', { reason: 'Unauthorized: WebSocket not authenticated' });
+                return;
+            }
+            try {
+                if (typeof roomId !== 'string' || roomId.trim() === '') {
+                    await socket.emit('messageFailed', { reason: 'Invalid room ID' });
+                    return;
+                }
+                if (typeof message !== 'object' || message == null) {
+                    await socket.emit('messageFailed', { reason: 'Invalid message object' });
+                    return;
+                }
+                if (typeof message.body !== 'string' || message.body.trim() === '') {
+                    await socket.emit('messageFailed', { reason: 'Invalid message body' });
+                    return;
+                }
+                socket.emit(`sendMessageAck-${roomId}`, {
+                    status: 'success',
+                    messageId: message.messageId
+                }).catch((error) => {
+                    Logger.error(`[WEBSOCKET ERROR] Failed to emit sendMessageAck-${roomId}:`, error);
+                });
+                try {
+                    const parts = roomId.split('-');
+                    const messageBoxType = parts.length > 1 ? parts[1] : 'default';
+                    let messageBox = await knex('messageBox')
+                        .where({ identityKey: message.recipient, type: messageBoxType })
+                        .first();
+                    if (messageBox == null) {
+                        await knex('messageBox').insert({
+                            identityKey: message.recipient,
+                            type: messageBoxType,
+                            created_at: new Date(),
+                            updated_at: new Date()
+                        });
+                    }
+                    messageBox = await knex('messageBox')
+                        .where({ identityKey: message.recipient, type: messageBoxType })
+                        .select('messageBoxId')
+                        .first();
+                    const messageBoxId = messageBox?.messageBoxId ?? null;
+                    const senderKey = authenticatedSockets.get(socket.id) ?? null;
+                    await knex('messages')
+                        .insert({
+                        messageId: message.messageId,
+                        messageBoxId,
+                        sender: senderKey,
+                        recipient: message.recipient,
+                        body: message.body,
+                        created_at: new Date(),
+                        updated_at: new Date()
+                    })
+                        .onConflict('messageId')
+                        .ignore();
+                }
+                catch (dbError) {
+                    Logger.error('[WEBSOCKET ERROR] Failed to store message in DB:', dbError);
+                    await socket.emit('messageFailed', { reason: 'Failed to store message' });
+                    return;
+                }
+                io.emit(`sendMessage-${roomId}`, {
+                    sender: authenticatedSockets.get(socket.id),
+                    messageId: message.messageId,
+                    body: message.body
+                });
+            }
+            catch (error) {
+                Logger.error('[WEBSOCKET ERROR] Unexpected failure in sendMessage handler:', error);
+                await socket.emit('messageFailed', { reason: 'Unexpected error occurred' });
+            }
+        });
+        socket.on('joinRoom', async (roomId) => {
+            if (!authenticatedSockets.has(socket.id)) {
+                await socket.emit('joinFailed', { reason: 'Unauthorized: WebSocket not authenticated' });
+                return;
+            }
+            if (typeof roomId !== 'string' || roomId.trim() === '') {
+                await socket.emit('joinFailed', { reason: 'Invalid room ID' });
+                return;
+            }
+            Logger.log(`[WEBSOCKET] User ${socket.id} joined room ${roomId}`);
+            await socket.emit('joinedRoom', { roomId });
+        });
+        socket.on('leaveRoom', async (roomId) => {
+            if (!authenticatedSockets.has(socket.id)) {
+                await socket.emit('leaveFailed', { reason: 'Unauthorized: WebSocket not authenticated' });
+                return;
+            }
+            if (typeof roomId !== 'string' || roomId.trim() === '') {
+                await socket.emit('leaveFailed', { reason: 'Invalid room ID' });
+                return;
+            }
+            Logger.log(`[WEBSOCKET] User ${socket.id} left room ${roomId}`);
+            await socket.emit('leftRoom', { roomId });
+        });
+        socket.on('disconnect', (reason) => {
+            Logger.log(`[WEBSOCKET] Disconnected: ${reason}`);
+            authenticatedSockets.delete(socket.id);
+        });
+    });
+    return io;
+}
+//# sourceMappingURL=compose.js.map

package/out/src/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../src/compose.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,OAAO,EAAE,EAMd,MAAM,EACP,MAAM,SAAS,CAAA;AAChB,OAAO,UAAU,MAAM,aAAa,CAAA;AAEpC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,gBAAgB,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAGxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAMtD,MAAM,UAAU,mBAAmB;IACjC,OAAO,OAAO,EAAE,CAAA;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAE,GAAY,EAAE,GAAsB;IACzE,qBAAqB,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;IAE7D,MAAM,MAAM,GAAG,MAAM,EAAE,CAAA;IACvB,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAA;IACvE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC5B,GAAG,CAAC,MAAM,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAA;QAC9C,GAAG,CAAC,MAAM,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAA;QAC/C,GAAG,CAAC,MAAM,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAA;QAC/C,GAAG,CAAC,MAAM,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAA;QAChD,GAAG,CAAC,MAAM,CAAC,sCAAsC,EAAE,MAAM,CAAC,CAAA;QAC1D,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7B,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;QACrB,CAAC;aAAM,CAAC;YACN,IAAI,EAAE,CAAA;QACR,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;QACtB,YAAY,CAAC,GAAG,CAAC,CAAA;IACnB,CAAC;IAED,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACxB,MAAM,CAAC,KAAK,CAAC,IAAkB,CAAC,CAC9B,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,IAAmF,CAC1F,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,GAAG,CACR,oBAAoB,CAAC;QACnB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,GAAG,CAAC,MAAM;KACnB,CAAC,CACH,CAAA;IAED,MAAM,CAAC,GAAG,CACR,uBAAuB,CAAC;QACtB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CACnC,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,GAAgC,CAAC,CAAC;KACrF,CAAC,CACH,CAAA;IAED,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACzB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAkB,CAAA;QACvC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAiC,CAAC,CAAA;QAChF,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAsB,CAAC,CAAA;QAC1D,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,IAAI,EAAE,CAAA;IACtC,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAsB,EACtB,GAAsB;IAEtB,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,qBAAqB,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;IAE7D,MAAM,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAA;IAE3D,MAAM,EAAE,GAAG,IAAI,gBAAgB,CAAC,UAAU,EAAE;QAC1C,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,IAAI,EAAE;YACJ,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;SACzB;KACF,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAA;IACrB,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEtD,EAAE,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAA;QAErD,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC/E,IAAI,CAAC;gBACH,MAAM,iBAAiB,GAAG,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;gBAClE,MAAM,CAAC,GAAG,CAAC,qDAAqD,EAAE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,CAAA;gBAC/F,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,CAAA;gBACjE,MAAM,CAAC,GAAG,CAAC,gDAAgD,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;gBACvE,KAAK,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;YAClE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,iDAAiD,EAAE,KAAK,CAAC,CAAA;YACxE,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,0FAA0F,CAAC,CAAA;YACvG,IAAI,kBAAkB,GAAG,KAAK,CAAA;YAC9B,MAAM,YAAY,GAAG,KAAK,EAAE,IAA8B,EAAiB,EAAE;gBAC3E,IAAI,kBAAkB;oBAAE,OAAM;gBAC9B,MAAM,CAAC,GAAG,CAAC,2CAA2C,EAAE,IAAI,CAAC,CAAA;gBAC7D,IAAI,IAAI,EAAE,WAAW,IAAI,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpE,IAAI,CAAC;wBACH,MAAM,iBAAiB,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;wBAChE,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,CAAA;wBACjE,kBAAkB,GAAG,IAAI,CAAA;wBACzB,MAAM,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;4BAC9E,MAAM,CAAC,KAAK,CAAC,gEAAgE,EAAE,KAAK,CAAC,CAAA;wBACvF,CAAC,CAAC,CAAA;oBACJ,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,CAAC,KAAK,CAAC,gEAAgE,EAAE,KAAK,CAAC,CAAA;wBACrF,MAAM,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAC,CAAA;oBACtF,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAA;oBAC9E,MAAM,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAA;gBAC/E,CAAC;YACH,CAAC,CAAA;YACD,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,YAAY,CAAC,CAAA;QAC1C,CAAC;QAED,MAAM,CAAC,EAAE,CACP,aAAa,EACb,KAAK,EAAE,IAAyF,EAAiB,EAAE;YACjH,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;gBAC7C,MAAM,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAA;gBAC/D,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAA;gBACrE,OAAM;YACR,CAAC;YACD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;YAChC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBACzC,MAAM,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAA;gBAClE,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,2CAA2C,EAAE,CAAC,CAAA;gBAC3F,OAAM;YACR,CAAC;YACD,IAAI,CAAC;gBACH,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;oBACvD,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAA;oBACjE,OAAM;gBACR,CAAC;gBACD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;oBACnD,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC,CAAA;oBACxE,OAAM;gBACR,CAAC;gBACD,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;oBACnE,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAA;oBACtE,OAAM;gBACR,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,kBAAkB,MAAM,EAAE,EAAE;oBACtC,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,OAAO,CAAC,SAAS;iBAC7B,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;oBACjB,MAAM,CAAC,KAAK,CAAC,mDAAmD,MAAM,GAAG,EAAE,KAAK,CAAC,CAAA;gBACnF,CAAC,CAAC,CAAA;gBAEF,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;oBAC/B,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;oBAE9D,IAAI,UAAU,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC;yBACtC,KAAK,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;yBAC/D,KAAK,EAAE,CAAA;oBAEV,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;wBACvB,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC;4BAC9B,WAAW,EAAE,OAAO,CAAC,SAAS;4BAC9B,IAAI,EAAE,cAAc;4BACpB,UAAU,EAAE,IAAI,IAAI,EAAE;4BACtB,UAAU,EAAE,IAAI,IAAI,EAAE;yBACvB,CAAC,CAAA;oBACJ,CAAC;oBAED,UAAU,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC;yBAClC,KAAK,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;yBAC/D,MAAM,CAAC,cAAc,CAAC;yBACtB,KAAK,EAAE,CAAA;oBAEV,MAAM,YAAY,GAAG,UAAU,EAAE,YAAY,IAAI,IAAI,CAAA;oBACrD,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,IAAI,CAAA;oBAE7D,MAAM,IAAI,CAAC,UAAU,CAAC;yBACnB,MAAM,CAAC;wBACN,SAAS,EAAE,OAAO,CAAC,SAAS;wBAC5B,YAAY;wBACZ,MAAM,EAAE,SAAS;wBACjB,SAAS,EAAE,OAAO,CAAC,SAAS;wBAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;wBAClB,UAAU,EAAE,IAAI,IAAI,EAAE;wBACtB,UAAU,EAAE,IAAI,IAAI,EAAE;qBACvB,CAAC;yBACD,UAAU,CAAC,WAAW,CAAC;yBACvB,MAAM,EAAE,CAAA;gBACb,CAAC;gBAAC,OAAO,OAAO,EAAE,CAAC;oBACjB,MAAM,CAAC,KAAK,CAAC,kDAAkD,EAAE,OAAO,CAAC,CAAA;oBACzE,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC,CAAA;oBACzE,OAAM;gBACR,CAAC;gBAED,EAAE,CAAC,IAAI,CAAC,eAAe,MAAM,EAAE,EAAE;oBAC/B,MAAM,EAAE,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC3C,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;iBACnB,CAAC,CAAA;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,8DAA8D,EAAE,KAAK,CAAC,CAAA;gBACnF,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC,CAAA;YAC7E,CAAC;QACH,CAAC,CACF,CAAA;QAED,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,MAAc,EAAE,EAAE;YAC7C,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBACzC,MAAM,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,2CAA2C,EAAE,CAAC,CAAA;gBACxF,OAAM;YACR,CAAC;YACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACvD,MAAM,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAA;gBAC9D,OAAM;YACR,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,EAAE,gBAAgB,MAAM,EAAE,CAAC,CAAA;YACjE,MAAM,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;QAC7C,CAAC,CAAC,CAAA;QAEF,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,MAAc,EAAE,EAAE;YAC9C,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBACzC,MAAM,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,2CAA2C,EAAE,CAAC,CAAA;gBACzF,OAAM;YACR,CAAC;YACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACvD,MAAM,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAA;gBAC/D,OAAM;YACR,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,EAAE,cAAc,MAAM,EAAE,CAAC,CAAA;YAC/D,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;QAEF,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAc,EAAE,EAAE;YACzC,MAAM,CAAC,GAAG,CAAC,6BAA6B,MAAM,EAAE,CAAC,CAAA;YACjD,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACxC,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,OAAO,EAAE,CAAA;AACX,CAAC"}

package/out/src/config/firebase.js

@@ -0,0 +1,150 @@
+import { initializeApp, getApps, getApp, cert, applicationDefault } from 'firebase-admin/app';
+import { getMessaging } from 'firebase-admin/messaging';
+import { getFirestore } from 'firebase-admin/firestore';
+import * as path from 'path';
+import dotenv from 'dotenv';
+import { log } from '../utils/logger.js';
+dotenv.config();
+let firebaseApp = null;
+/**
+ * Initialize Firebase Admin SDK.
+ * Returns null (and logs a warning) when ENABLE_FIREBASE is not 'true',
+ * or when FIREBASE_PROJECT_ID is absent, so the server can run without Firebase.
+ */
+export function initializeFirebase() {
+    const enableFirebase = process.env.ENABLE_FIREBASE;
+    if (enableFirebase !== 'true') {
+        log.info({ operation: 'firebase.init', enable_firebase: enableFirebase ?? 'unset' }, 'Firebase disabled, skipping initialization');
+        return null;
+    }
+    if (firebaseApp != null) {
+        log.info({ operation: 'firebase.init' }, 'Firebase already initialized');
+        return firebaseApp;
+    }
+    try {
+        const serviceAccountJson = process.env.FIREBASE_SERVICE_ACCOUNT_JSON;
+        const serviceAccountPath = process.env.FIREBASE_SERVICE_ACCOUNT_PATH;
+        const projectId = process.env.FIREBASE_PROJECT_ID;
+        if (projectId == null || projectId === '') {
+            throw new Error('FIREBASE_PROJECT_ID environment variable is required');
+        }
+        let firebaseCredential; // Will be assigned based on auth method
+        if (serviceAccountJson != null && serviceAccountJson !== '') {
+            log.info({ operation: 'firebase.init', credential_source: 'env' }, 'Using Firebase service account from environment variable');
+            try {
+                log.debug({ operation: 'firebase.init', service_account_json_length: serviceAccountJson.length }, 'Service account JSON length');
+                // Debug credential functions
+                log.debug({ operation: 'firebase.init', cert_function_type: typeof cert }, 'cert function type');
+                log.debug({ operation: 'firebase.init', application_default_function_type: typeof applicationDefault }, 'applicationDefault function type');
+                const serviceAccount = JSON.parse(serviceAccountJson);
+                log.debug({ operation: 'firebase.init', service_account_keys: Object.keys(serviceAccount ?? {}) }, 'Parsed service account keys');
+                if (serviceAccount == null || typeof serviceAccount !== 'object') {
+                    throw new Error('Parsed service account is not a valid object');
+                }
+                if (serviceAccount.private_key == null || serviceAccount.client_email == null || serviceAccount.project_id == null) {
+                    throw new Error('Service account missing required fields (private_key, client_email, project_id)');
+                }
+                firebaseCredential = cert(serviceAccount);
+                log.info({ operation: 'firebase.init' }, 'Firebase credential created successfully');
+            }
+            catch (parseError) {
+                log.error({ operation: 'firebase.init', outcome: 'error', err: parseError }, 'Firebase service account parsing failed');
+                throw new Error(`Failed to parse FIREBASE_SERVICE_ACCOUNT_JSON: ${(parseError instanceof Error) ? parseError.message : 'Invalid JSON'}`);
+            }
+        }
+        else if (serviceAccountPath != null && serviceAccountPath !== '') {
+            log.info({ operation: 'firebase.init', credential_source: 'file' }, 'Using Firebase service account key file');
+            const absolutePath = path.resolve(process.cwd(), serviceAccountPath);
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            firebaseCredential = cert(require(absolutePath));
+        }
+        else {
+            log.info({ operation: 'firebase.init', credential_source: 'default' }, 'Using Firebase default credentials');
+            firebaseCredential = applicationDefault();
+        }
+        // Check if Firebase app is already initialized
+        if (getApps().length === 0) {
+            firebaseApp = initializeApp({
+                credential: firebaseCredential,
+                projectId
+            });
+        }
+        else {
+            firebaseApp = getApp();
+        }
+        log.info({ operation: 'firebase.init' }, 'Firebase Admin SDK initialized successfully');
+        return firebaseApp;
+    }
+    catch (error) {
+        log.error({ operation: 'firebase.init', outcome: 'error', err: error }, 'Firebase initialization failed');
+        throw error;
+    }
+}
+/**
+ * Get Firebase Messaging instance, or null if Firebase is not initialized.
+ */
+export function getFirebaseMessaging() {
+    if (firebaseApp == null) {
+        return null;
+    }
+    return getMessaging(firebaseApp);
+}
+/**
+ * Get Firestore instance
+ */
+export function getFirebaseFirestore() {
+    if (firebaseApp == null) {
+        throw new Error('Firebase not initialized. Call initializeFirebase() first.');
+    }
+    return getFirestore(firebaseApp);
+}
+/**
+ * Send a push notification via FCM
+ */
+export async function sendNotification(fcmToken, payload) {
+    try {
+        const messaging = getFirebaseMessaging();
+        if (messaging == null) {
+            throw new Error('Firebase Messaging is not initialized (ENABLE_FIREBASE != true)');
+        }
+        const message = {
+            token: fcmToken,
+            notification: {
+                title: payload.title,
+                body: payload.body,
+                ...(payload.icon && { imageUrl: payload.icon }),
+            },
+            data: payload.data || {},
+            android: {
+                priority: "high",
+                notification: {
+                    clickAction: "OPEN_ACTIVITY_1",
+                    ...(payload.badge && { notificationCount: payload.badge }),
+                },
+            },
+            apns: {
+                headers: {
+                    "apns-priority": "10",
+                },
+                payload: {
+                    aps: {
+                        alert: {
+                            title: payload.title,
+                            body: payload.body,
+                        },
+                        sound: "default",
+                        badge: payload.badge || 1,
+                    },
+                },
+            },
+        };
+        const response = await messaging.send(message);
+        log.info({ operation: 'firebase.send_notification', message_id: response }, 'Notification sent successfully');
+        return { success: true, messageId: response };
+    }
+    catch (error) {
+        log.error({ operation: 'firebase.send_notification', outcome: 'error', err: error }, 'Failed to send notification');
+        throw error;
+    }
+}
+//# sourceMappingURL=firebase.js.map

package/out/src/config/firebase.js.map

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