@managesome/knotr-toolkit 0.1.1 → 0.8.5

package/dist/backend/logger.d.ts

@@ -0,0 +1,23 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp: string;
+    service?: string;
+    [key: string]: unknown;
+}
+export interface Logger {
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+/**
+ * Structured logger for backend services
+ */
+export declare const logger: Logger;
+/**
+ * Create a child logger with preset metadata
+ */
+export declare function createLogger(defaultMeta: Record<string, unknown>): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/backend/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/backend/logger.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9D;AA+ED;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,MAapB,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAezE"}

package/dist/backend/logger.js

@@ -0,0 +1,107 @@
+// ============================================
+// Logger Utility
+// Backend-only structured logging
+// ============================================
+// Get log level from environment
+function getLogLevel() {
+    const envLevel = process.env.LOG_LEVEL?.toLowerCase();
+    if (envLevel === 'debug' || envLevel === 'info' || envLevel === 'warn' || envLevel === 'error') {
+        return envLevel;
+    }
+    return process.env.NODE_ENV === 'production' ? 'info' : 'debug';
+}
+// Determine if we should use JSON format (production) or human-readable (development)
+function useJsonFormat() {
+    return process.env.NODE_ENV === 'production' || process.env.LOG_FORMAT === 'json';
+}
+// Log level priority
+const levelPriority = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+// Get service name from environment or default
+function getServiceName() {
+    return process.env.SERVICE_NAME || process.env.npm_package_name || 'knotr-service';
+}
+// Format log entry for output
+function formatLogEntry(level, message, meta) {
+    const entry = {
+        level,
+        message,
+        timestamp: new Date().toISOString(),
+        service: getServiceName(),
+        ...meta,
+    };
+    if (useJsonFormat()) {
+        return JSON.stringify(entry);
+    }
+    // Human-readable format for development
+    const metaStr = meta && Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : '';
+    const levelUpper = level.toUpperCase().padEnd(5);
+    return `[${entry.timestamp}] ${levelUpper} ${message}${metaStr}`;
+}
+// Output log to console
+function log(level, message, meta) {
+    const currentLevel = getLogLevel();
+    if (levelPriority[level] < levelPriority[currentLevel]) {
+        return;
+    }
+    const formattedEntry = formatLogEntry(level, message, meta);
+    // tslint:disable-next-line:no-console
+    switch (level) {
+        case 'error':
+            // tslint:disable-next-line:no-console
+            console.error(formattedEntry);
+            break;
+        case 'warn':
+            // tslint:disable-next-line:no-console
+            console.warn(formattedEntry);
+            break;
+        case 'debug':
+            // tslint:disable-next-line:no-console
+            console.debug(formattedEntry);
+            break;
+        default:
+            // tslint:disable-next-line:no-console
+            console.log(formattedEntry);
+    }
+}
+/**
+ * Structured logger for backend services
+ */
+export const logger = {
+    debug(message, meta) {
+        log('debug', message, meta);
+    },
+    info(message, meta) {
+        log('info', message, meta);
+    },
+    warn(message, meta) {
+        log('warn', message, meta);
+    },
+    error(message, meta) {
+        log('error', message, meta);
+    },
+};
+/**
+ * Create a child logger with preset metadata
+ */
+export function createLogger(defaultMeta) {
+    return {
+        debug(message, meta) {
+            log('debug', message, { ...defaultMeta, ...meta });
+        },
+        info(message, meta) {
+            log('info', message, { ...defaultMeta, ...meta });
+        },
+        warn(message, meta) {
+            log('warn', message, { ...defaultMeta, ...meta });
+        },
+        error(message, meta) {
+            log('error', message, { ...defaultMeta, ...meta });
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/backend/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/backend/logger.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,iBAAiB;AACjB,kCAAkC;AAClC,+CAA+C;AAmB/C,iCAAiC;AACjC,SAAS,WAAW;IAClB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC;IACtD,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC/F,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;AAClE,CAAC;AAED,sFAAsF;AACtF,SAAS,aAAa;IACpB,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,MAAM,CAAC;AACpF,CAAC;AAED,qBAAqB;AACrB,MAAM,aAAa,GAA6B;IAC9C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,+CAA+C;AAC/C,SAAS,cAAc;IACrB,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,eAAe,CAAC;AACrF,CAAC;AAED,8BAA8B;AAC9B,SAAS,cAAc,CAAC,KAAe,EAAE,OAAe,EAAE,IAA8B;IACtF,MAAM,KAAK,GAAa;QACtB,KAAK;QACL,OAAO;QACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,cAAc,EAAE;QACzB,GAAG,IAAI;KACR,CAAC;IAEF,IAAI,aAAa,EAAE,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,wCAAwC;IACxC,MAAM,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvF,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACjD,OAAO,IAAI,KAAK,CAAC,SAAS,KAAK,UAAU,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;AACnE,CAAC;AAED,wBAAwB;AACxB,SAAS,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAA8B;IAC3E,MAAM,YAAY,GAAG,WAAW,EAAE,CAAC;IAEnC,IAAI,aAAa,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;QACvD,OAAO;IACT,CAAC;IAED,MAAM,cAAc,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAE5D,sCAAsC;IACtC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YAC9B,MAAM;QACR,KAAK,MAAM;YACT,sCAAsC;YACtC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC7B,MAAM;QACR,KAAK,OAAO;YACV,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YAC9B,MAAM;QACR;YACE,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW;IAC5B,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,WAAoC;IAC/D,OAAO;QACL,KAAK,CAAC,OAAe,EAAE,IAA8B;YACnD,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,OAAe,EAAE,IAA8B;YAClD,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,OAAe,EAAE,IAA8B;YAClD,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,KAAK,CAAC,OAAe,EAAE,IAA8B;YACnD,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/backend/redis.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Set the Redis client instances
+ */
+export declare function setRedisClients(options: {
+    client?: unknown;
+    pubClient?: unknown;
+    subClient?: unknown;
+}): void;
+/**
+ * Get the main Redis client
+ */
+export declare function getRedisClient<T = unknown>(): T;
+/**
+ * Get the Redis pub client
+ */
+export declare function getRedisPubClient<T = unknown>(): T;
+/**
+ * Get the Redis sub client
+ */
+export declare function getRedisSubClient<T = unknown>(): T;
+/**
+ * Create Redis clients using ioredis
+ * Returns raw clients that can be used with setRedisClients
+ * @param RedisConstructor - The Redis constructor from ioredis
+ * @param redisUrl - The Redis connection URL
+ */
+export declare function createRedisClients(RedisConstructor: any, redisUrl?: string): Promise<{
+    client: unknown;
+    pubClient: unknown;
+    subClient: unknown;
+}>;
+/**
+ * Publish a message to a Redis channel
+ */
+export declare function redisPublish(channel: string, message: unknown): Promise<void>;
+/**
+ * Subscribe to a Redis channel
+ */
+export declare function redisSubscribe(channel: string, callback: (message: string, channel: string) => void): Promise<void>;
+/**
+ * Get a value from Redis
+ */
+export declare function redisGet(key: string): Promise<string | null>;
+/**
+ * Set a value in Redis
+ */
+export declare function redisSet(key: string, value: string, options?: {
+    ex?: number;
+    px?: number;
+}): Promise<void>;
+/**
+ * Delete keys from Redis
+ */
+export declare function redisDel(...keys: string[]): Promise<number>;
+/**
+ * Close all Redis connections gracefully
+ */
+export declare function closeRedisConnections(): Promise<void>;
+//# sourceMappingURL=redis.d.ts.map

package/dist/backend/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/backend/redis.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAI7G;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,CAK/C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,CAKlD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,CAKlD;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAEtC,gBAAgB,EAAE,GAAG,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAgCtE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAInF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GACnD,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGlE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAahH;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAGjE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAgC3D"}

package/dist/backend/redis.js

@@ -0,0 +1,169 @@
+// ============================================
+// Redis Client Utilities
+// Backend-only Redis connection and pub/sub
+// ============================================
+import { getConfig, isConfigInitialized } from './config.js';
+import { logger } from './logger.js';
+// Store Redis client instances
+let redisClient = null;
+let redisPubClient = null;
+let redisSubClient = null;
+/**
+ * Set the Redis client instances
+ */
+export function setRedisClients(options) {
+    if (options.client)
+        redisClient = options.client;
+    if (options.pubClient)
+        redisPubClient = options.pubClient;
+    if (options.subClient)
+        redisSubClient = options.subClient;
+}
+/**
+ * Get the main Redis client
+ */
+export function getRedisClient() {
+    if (!redisClient) {
+        throw new Error('Redis client not initialized. Call setRedisClients() first.');
+    }
+    return redisClient;
+}
+/**
+ * Get the Redis pub client
+ */
+export function getRedisPubClient() {
+    if (!redisPubClient) {
+        throw new Error('Redis pub client not initialized. Call setRedisClients() first.');
+    }
+    return redisPubClient;
+}
+/**
+ * Get the Redis sub client
+ */
+export function getRedisSubClient() {
+    if (!redisSubClient) {
+        throw new Error('Redis sub client not initialized. Call setRedisClients() first.');
+    }
+    return redisSubClient;
+}
+/**
+ * Create Redis clients using ioredis
+ * Returns raw clients that can be used with setRedisClients
+ * @param RedisConstructor - The Redis constructor from ioredis
+ * @param redisUrl - The Redis connection URL
+ */
+export async function createRedisClients(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+RedisConstructor, redisUrl) {
+    const url = redisUrl || (isConfigInitialized() ? getConfig().redisUrl : undefined);
+    if (!url) {
+        throw new Error('No Redis URL provided. Either pass a URL or set REDIS_URL in config.');
+    }
+    try {
+        const client = new RedisConstructor(url);
+        const pubClient = new RedisConstructor(url);
+        const subClient = new RedisConstructor(url);
+        // Set up error handlers
+        [client, pubClient, subClient].forEach((c, i) => {
+            const name = ['client', 'pubClient', 'subClient'][i];
+            c.on('error', (err) => {
+                logger.error(`Redis ${name} error`, { error: err.message });
+            });
+            c.on('connect', () => {
+                logger.debug(`Redis ${name} connected`);
+            });
+        });
+        logger.info('Redis clients created');
+        return { client, pubClient, subClient };
+    }
+    catch (error) {
+        logger.error('Failed to create Redis clients', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        throw error;
+    }
+}
+/**
+ * Publish a message to a Redis channel
+ */
+export async function redisPublish(channel, message) {
+    const pub = getRedisPubClient();
+    const payload = typeof message === 'string' ? message : JSON.stringify(message);
+    await pub.publish(channel, payload);
+}
+/**
+ * Subscribe to a Redis channel
+ */
+export async function redisSubscribe(channel, callback) {
+    const sub = getRedisSubClient();
+    await sub.subscribe(channel);
+    sub.on('message', (ch, msg) => {
+        if (ch === channel) {
+            callback(msg, ch);
+        }
+    });
+}
+/**
+ * Get a value from Redis
+ */
+export async function redisGet(key) {
+    const client = getRedisClient();
+    return client.get(key);
+}
+/**
+ * Set a value in Redis
+ */
+export async function redisSet(key, value, options) {
+    const client = getRedisClient();
+    const args = [];
+    if (options?.ex) {
+        args.push('EX', options.ex);
+    }
+    else if (options?.px) {
+        args.push('PX', options.px);
+    }
+    await client.set(key, value, ...args);
+}
+/**
+ * Delete keys from Redis
+ */
+export async function redisDel(...keys) {
+    const client = getRedisClient();
+    return client.del(...keys);
+}
+/**
+ * Close all Redis connections gracefully
+ */
+export async function closeRedisConnections() {
+    const closeClient = async (client, name) => {
+        if (!client)
+            return;
+        try {
+            const c = client;
+            if (typeof c.quit === 'function') {
+                await c.quit();
+                logger.debug(`Redis ${name} closed via quit()`);
+            }
+            else if (typeof c.disconnect === 'function') {
+                c.disconnect();
+                logger.debug(`Redis ${name} closed via disconnect()`);
+            }
+        }
+        catch (error) {
+            logger.warn(`Error closing Redis ${name}`, {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    };
+    await Promise.all([
+        closeClient(redisClient, 'client'),
+        closeClient(redisPubClient, 'pubClient'),
+        closeClient(redisSubClient, 'subClient'),
+    ]);
+    // Reset references
+    redisClient = null;
+    redisPubClient = null;
+    redisSubClient = null;
+    logger.info('All Redis connections closed');
+}
+//# sourceMappingURL=redis.js.map

package/dist/backend/redis.js.map

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

package/dist/backend/socket.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Set the Socket.IO server instance
+ */
+export declare function setSocketServer(io: unknown): void;
+/**
+ * Get the Socket.IO server instance
+ */
+export declare function getSocketServer<T = unknown>(): T;
+/**
+ * Check if Socket.IO server is available
+ */
+export declare function hasSocketServer(): boolean;
+/**
+ * Socket event payload for cross-service communication
+ */
+interface SocketEventPayload {
+    room: string;
+    event: string;
+    data: unknown;
+    broadcast?: boolean;
+}
+/**
+ * Emit an event to a specific user (by userId/accountId)
+ */
+export declare function ioEmitToUser(userId: string, event: string, data: unknown): Promise<void>;
+/**
+ * Emit an event to all members of an account
+ */
+export declare function ioEmitToAccount(accountId: string, event: string, data: unknown): Promise<void>;
+/**
+ * Emit an event to all participants in a chat
+ */
+export declare function ioEmitToChat(chatId: string, event: string, data: unknown): Promise<void>;
+/**
+ * Emit an event to all participants in a match
+ */
+export declare function ioEmitToMatch(matchId: string, event: string, data: unknown): Promise<void>;
+/**
+ * Chat message payload interface
+ */
+export interface ChatMessagePayload {
+    messageId: string;
+    senderId: string;
+    content: string;
+    contentType: string;
+    mediaUrl?: string;
+    createdAt: Date;
+}
+/**
+ * Emit a new chat message event
+ */
+export declare function emitChatMessage(chatId: string, message: ChatMessagePayload): Promise<void>;
+/**
+ * Emit a read receipt event
+ */
+export declare function emitReadReceipt(chatId: string, readerId: string, messageId: string): Promise<void>;
+/**
+ * Emit a typing indicator event
+ */
+export declare function emitTypingIndicator(chatId: string, userId: string, isTyping: boolean): Promise<void>;
+/**
+ * New match payload interface
+ */
+export interface NewMatchPayload {
+    matchId: string;
+    matchedAccountId: string;
+    matchedProfileName?: string;
+    matchType: string;
+    matchedAt: Date;
+}
+/**
+ * Emit a new match event
+ */
+export declare function emitNewMatch(accountId: string, payload: NewMatchPayload): Promise<void>;
+/**
+ * Subscribe to socket events from Redis
+ * This is used by the listener-service to receive events from other services
+ */
+export declare function subscribeToSocketEvents(handler: (payload: SocketEventPayload) => void): Promise<void>;
+export {};
+//# sourceMappingURL=socket.d.ts.map

package/dist/backend/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/backend/socket.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,CAKhD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;GAEG;AACH,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAoBD;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9F;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpG;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9F;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhG;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhG;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOxG;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1G;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7F;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAe3G"}

package/dist/backend/socket.js

@@ -0,0 +1,132 @@
+// ============================================
+// Socket.IO Emit Utilities
+// Backend-only real-time event emission
+// ============================================
+import { SOCKET_EVENTS } from '../constants/socket.js';
+import { logger } from './logger.js';
+import { redisPublish } from './redis.js';
+// Store Socket.IO server instance
+let ioServer = null;
+// Redis channel for cross-service socket events
+const SOCKET_REDIS_CHANNEL = 'knotr:socket:events';
+/**
+ * Set the Socket.IO server instance
+ */
+export function setSocketServer(io) {
+    ioServer = io;
+}
+/**
+ * Get the Socket.IO server instance
+ */
+export function getSocketServer() {
+    if (!ioServer) {
+        throw new Error('Socket.IO server not initialized. Call setSocketServer() first.');
+    }
+    return ioServer;
+}
+/**
+ * Check if Socket.IO server is available
+ */
+export function hasSocketServer() {
+    return ioServer !== null;
+}
+/**
+ * Emit an event to a specific room
+ * If Socket.IO is not available, publishes via Redis for other services to handle
+ */
+async function emitToRoom(room, event, data) {
+    if (ioServer) {
+        // Direct emit if we have the Socket.IO server
+        const io = ioServer;
+        io.to(room).emit(event, data);
+        logger.debug('Socket event emitted', { room, event });
+    }
+    else {
+        // Publish via Redis for other services (like listener-service) to handle
+        const payload = { room, event, data };
+        await redisPublish(SOCKET_REDIS_CHANNEL, payload);
+        logger.debug('Socket event published to Redis', { room, event });
+    }
+}
+/**
+ * Emit an event to a specific user (by userId/accountId)
+ */
+export async function ioEmitToUser(userId, event, data) {
+    const room = `user:${userId}`;
+    await emitToRoom(room, event, data);
+}
+/**
+ * Emit an event to all members of an account
+ */
+export async function ioEmitToAccount(accountId, event, data) {
+    const room = `account:${accountId}`;
+    await emitToRoom(room, event, data);
+}
+/**
+ * Emit an event to all participants in a chat
+ */
+export async function ioEmitToChat(chatId, event, data) {
+    const room = `chat:${chatId}`;
+    await emitToRoom(room, event, data);
+}
+/**
+ * Emit an event to all participants in a match
+ */
+export async function ioEmitToMatch(matchId, event, data) {
+    const room = `match:${matchId}`;
+    await emitToRoom(room, event, data);
+}
+/**
+ * Emit a new chat message event
+ */
+export async function emitChatMessage(chatId, message) {
+    await ioEmitToChat(chatId, SOCKET_EVENTS.MESSAGE_RECEIVED, message);
+}
+/**
+ * Emit a read receipt event
+ */
+export async function emitReadReceipt(chatId, readerId, messageId) {
+    await ioEmitToChat(chatId, SOCKET_EVENTS.MESSAGE_READ, {
+        chatId,
+        readerId,
+        messageId,
+        readAt: new Date(),
+    });
+}
+/**
+ * Emit a typing indicator event
+ */
+export async function emitTypingIndicator(chatId, userId, isTyping) {
+    const event = isTyping ? SOCKET_EVENTS.TYPING_START : SOCKET_EVENTS.TYPING_STOP;
+    await ioEmitToChat(chatId, event, {
+        chatId,
+        userId,
+        timestamp: new Date(),
+    });
+}
+/**
+ * Emit a new match event
+ */
+export async function emitNewMatch(accountId, payload) {
+    await ioEmitToAccount(accountId, SOCKET_EVENTS.MATCH_CREATED, payload);
+}
+/**
+ * Subscribe to socket events from Redis
+ * This is used by the listener-service to receive events from other services
+ */
+export async function subscribeToSocketEvents(handler) {
+    const { redisSubscribe } = await import('./redis.js');
+    await redisSubscribe(SOCKET_REDIS_CHANNEL, (message) => {
+        try {
+            const payload = JSON.parse(message);
+            handler(payload);
+        }
+        catch (error) {
+            logger.error('Failed to parse socket event from Redis', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    });
+    logger.info('Subscribed to socket events channel');
+}
+//# sourceMappingURL=socket.js.map

package/dist/backend/socket.js.map

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

package/dist/backend/worker-queue.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Set the Cloud Tasks client instance
+ */
+export declare function setCloudTasksClient(client: unknown): void;
+/**
+ * Worker request payload interface
+ */
+export interface WorkerRequestPayload {
+    type: string;
+    [key: string]: unknown;
+}
+/**
+ * Options for scheduling a worker request
+ */
+export interface WorkerRequestOptions {
+    /** Delay in seconds before the task should execute */
+    delaySeconds?: number;
+    /** Absolute Unix timestamp (seconds) when the task should execute */
+    scheduleTime?: number;
+    /** Queue name override */
+    queue?: string;
+}
+/**
+ * Post a request to the workers service via Cloud Tasks
+ * Falls back to HTTP POST in development mode
+ *
+ * @param endpoint - The worker endpoint (e.g., "process-matching")
+ * @param payload - The request payload
+ * @param options - Optional scheduling options
+ */
+export declare function postWorkerRequest(endpoint: string, payload: WorkerRequestPayload, options?: WorkerRequestOptions): Promise<void>;
+/**
+ * Convenience function for scheduling a delayed worker request
+ */
+export declare function scheduleWorkerRequest(endpoint: string, payload: WorkerRequestPayload, delaySeconds: number): Promise<void>;
+/**
+ * Convenience function for scheduling a worker request at a specific time
+ */
+export declare function scheduleWorkerRequestAt(endpoint: string, payload: WorkerRequestPayload, scheduledTime: Date): Promise<void>;
+//# sourceMappingURL=worker-queue.d.ts.map

package/dist/backend/worker-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-queue.d.ts","sourceRoot":"","sources":["../../src/backend/worker-queue.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAEzD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAYf;AAiHD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,oBAAoB,EAC7B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,oBAAoB,EAC7B,aAAa,EAAE,IAAI,GAClB,OAAO,CAAC,IAAI,CAAC,CAIf"}