@nipigev2/messaging-client 0.1.0

package/README.md

@@ -0,0 +1,54 @@
+# @nipigev2/messaging-client
+
+Shared Redis Streams messaging for Nipige services — one source of truth for the
+stream publisher, the resilient consumer-group utility, and the shared event/intent
+types. Replaces the per-service `notify.publisher.ts` copies and the duplicated
+`amqpConsumer.ts`, as the platform moves off RabbitMQ onto Redis Streams.
+
+Inject your service's existing `ioredis` client — the package does no config or
+connection management of its own.
+
+## Publish
+
+```ts
+import { publishToStream, publishNotification, streamName } from '@nipigev2/messaging-client';
+import { redisClient } from '../utils/cache';
+import logger from '../utils/logger';
+
+// domain event → its business stream (fire-and-forget; never throws)
+await publishToStream(redisClient, streamName('booking_events'), bookingEvent, { logger });
+
+// notification intent → the unified notification bus (notify:stream)
+await publishNotification(redisClient, intent, { logger });
+```
+
+## Consume
+
+```ts
+import { startStreamConsumer, streamName } from '@nipigev2/messaging-client';
+import { redisClient } from '../utils/cache';
+import logger from '../utils/logger';
+
+const handle = startStreamConsumer(redisClient, {
+  name: 'dispatch-service.bookingEvents',
+  stream: streamName('booking_events'),
+  group: 'dispatch-service',      // one group per consuming service (fan-out)
+  handler: async (event) => { /* switch on event.eventType */ },
+  logger,
+});
+// on shutdown: await handle.stop();
+```
+
+Semantics: at-least-once (manual `XACK`), crash recovery (`XPENDING` + `XCLAIM`
+reclaim sweep), poison-pill dead-lettering after `maxDeliveries`, load-balancing
+across replicas within a group. Blocking reads run on a duplicated connection.
+
+## Conventions
+- One stream per former exchange: `streamName('<exchange>')` → `<exchange>:stream`.
+- One consumer **group per consuming service** (fan-out). Multiple instances of a
+  service share its group (load-balanced).
+- Entries store the JSON payload under the single field `payload` (`STREAM_FIELD`).
+
+## Build / publish
+`npm run build` (tsc → `dist/`), then publish to the private registry. Consumers
+depend on it like `@nipigev2/rbac-client`.

package/dist/consumer.d.ts

@@ -0,0 +1,27 @@
+import type { Redis } from 'ioredis';
+import { MessagingLogger } from './types';
+export interface StreamConsumerOptions<T> {
+    /** Identifier used in logs, e.g. 'dispatch-service.bookingEvents'. */
+    name: string;
+    stream: string;
+    group: string;
+    /** Handler for one parsed message. Throw to leave the entry pending (redelivered). */
+    handler: (payload: T) => Promise<void>;
+    /** Max delivery attempts before an entry is dead-lettered. Default 5. */
+    maxDeliveries?: number;
+    /** XREADGROUP block window in ms. Default 5000. */
+    blockMs?: number;
+    /** Max entries fetched per read. Default 10. */
+    count?: number;
+    /** Idle threshold (ms) before a pending entry is reclaimed. Default 60000. */
+    reclaimIdleMs?: number;
+    /** How often the reclaim sweep runs (ms). Default 30000. */
+    reclaimIntervalMs?: number;
+    logger?: MessagingLogger;
+}
+export interface StreamConsumerHandle {
+    isRunning: () => boolean;
+    stop: () => Promise<void>;
+}
+export declare function startStreamConsumer<T = unknown>(redis: Redis, opts: StreamConsumerOptions<T>): StreamConsumerHandle;
+//# sourceMappingURL=consumer.d.ts.map

package/dist/consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer.d.ts","sourceRoot":"","sources":["../src/consumer.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAgB,eAAe,EAAc,MAAM,SAAS,CAAC;AAEpE,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAC7C,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC7B,oBAAoB,CA8HtB"}

package/dist/consumer.js

@@ -0,0 +1,141 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startStreamConsumer = startStreamConsumer;
+/**
+ * Resilient Redis Streams consumer (consumer-group based) — the Streams analogue
+ * of an AMQP resilient consumer. Preserves at-least-once delivery, per-message
+ * ack, redelivery on crash, and load-balancing across replicas. Lifted from the
+ * production-proven implementation in the communication service.
+ *
+ * Inject the service's own `ioredis` client; the utility runs blocking reads on a
+ * dedicated duplicated connection (XREADGROUP BLOCK monopolises a connection).
+ */
+const os_1 = __importDefault(require("os"));
+const types_1 = require("./types");
+function startStreamConsumer(redis, opts) {
+    const logger = opts.logger ?? types_1.noopLogger;
+    const maxDeliveries = opts.maxDeliveries ?? 5;
+    const blockMs = opts.blockMs ?? 5000;
+    const count = opts.count ?? 10;
+    const reclaimIdleMs = opts.reclaimIdleMs ?? 60000;
+    const reclaimIntervalMs = opts.reclaimIntervalMs ?? 30000;
+    const consumerName = `${os_1.default.hostname()}-${process.pid}`;
+    // Dedicated connection — XREADGROUP BLOCK monopolises it.
+    const conn = redis.duplicate();
+    conn.on('error', (err) => logger.error({ consumer: opts.name, err }, 'stream consumer: redis error'));
+    let stopped = false;
+    let running = false;
+    let reclaimTimer = null;
+    const ensureGroup = async () => {
+        try {
+            await conn.xgroup('CREATE', opts.stream, opts.group, '$', 'MKSTREAM');
+            logger.info({ consumer: opts.name, stream: opts.stream, group: opts.group }, 'stream consumer: group created');
+        }
+        catch (err) {
+            if (String(err?.message || '').includes('BUSYGROUP'))
+                return;
+            throw err;
+        }
+    };
+    const fieldValue = (fields) => {
+        for (let i = 0; i + 1 < fields.length; i += 2) {
+            if (fields[i] === types_1.STREAM_FIELD)
+                return fields[i + 1];
+        }
+        return fields[1];
+    };
+    const processEntry = async (id, fields, deliveries) => {
+        const raw = fieldValue(fields);
+        if (raw == null) {
+            logger.error({ consumer: opts.name, id }, 'stream consumer: empty entry — dead-lettering');
+            await conn.xack(opts.stream, opts.group, id);
+            return;
+        }
+        let payload;
+        try {
+            payload = JSON.parse(raw);
+        }
+        catch (err) {
+            logger.error({ consumer: opts.name, id, err }, 'stream consumer: unparseable payload — dead-lettering');
+            await conn.xack(opts.stream, opts.group, id);
+            return;
+        }
+        try {
+            await opts.handler(payload);
+            await conn.xack(opts.stream, opts.group, id);
+        }
+        catch (err) {
+            if (deliveries >= maxDeliveries) {
+                logger.error({ consumer: opts.name, id, deliveries, err }, 'stream consumer: max deliveries exceeded — dead-lettering');
+                await conn.xack(opts.stream, opts.group, id);
+                return;
+            }
+            logger.warn({ consumer: opts.name, id, deliveries, err }, 'stream consumer: handler failed — will retry');
+        }
+    };
+    const readLoop = async () => {
+        while (!stopped) {
+            try {
+                const res = (await conn.xreadgroup('GROUP', opts.group, consumerName, 'COUNT', count, 'BLOCK', blockMs, 'STREAMS', opts.stream, '>'));
+                if (!res)
+                    continue;
+                for (const [, entries] of res) {
+                    for (const [id, fields] of entries) {
+                        await processEntry(id, fields, 1);
+                    }
+                }
+            }
+            catch (err) {
+                if (stopped)
+                    break;
+                logger.error({ consumer: opts.name, err }, 'stream consumer: read loop error — retrying shortly');
+                await new Promise((r) => setTimeout(r, 1000));
+            }
+        }
+    };
+    const reclaimSweep = async () => {
+        try {
+            const pending = (await conn.xpending(opts.stream, opts.group, 'IDLE', reclaimIdleMs, '-', '+', 50));
+            if (!pending?.length)
+                return;
+            for (const [id, , , deliveries] of pending) {
+                const claimed = (await conn.xclaim(opts.stream, opts.group, consumerName, reclaimIdleMs, id));
+                if (!claimed?.length)
+                    continue;
+                const [, fields] = claimed[0];
+                await processEntry(id, fields, deliveries);
+            }
+        }
+        catch (err) {
+            logger.error({ consumer: opts.name, err }, 'stream consumer: reclaim sweep error');
+        }
+    };
+    void (async () => {
+        try {
+            await ensureGroup();
+            running = true;
+            logger.info({ consumer: opts.name, consumerName }, 'stream consumer started');
+            reclaimTimer = setInterval(() => { void reclaimSweep(); }, reclaimIntervalMs);
+            await readLoop();
+        }
+        catch (err) {
+            running = false;
+            logger.error({ consumer: opts.name, err }, 'stream consumer: failed to start');
+        }
+    })();
+    return {
+        isRunning: () => running,
+        stop: async () => {
+            stopped = true;
+            running = false;
+            if (reclaimTimer) {
+                clearInterval(reclaimTimer);
+                reclaimTimer = null;
+            }
+            conn.disconnect();
+        },
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { STREAM_FIELD, NOTIFY_STREAM, NOTIFY_GROUP, streamName, noopLogger, } from './types';
+export type { NotificationChannel, NotificationRecipient, NotificationIntent, DomainEvent, MessagingLogger, } from './types';
+export { publishToStream, publishNotification } from './publisher';
+export type { PublishOptions } from './publisher';
+export { startStreamConsumer } from './consumer';
+export type { StreamConsumerOptions, StreamConsumerHandle } from './consumer';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACV,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,WAAW,EACX,eAAe,GAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startStreamConsumer = exports.publishNotification = exports.publishToStream = exports.noopLogger = exports.streamName = exports.NOTIFY_GROUP = exports.NOTIFY_STREAM = exports.STREAM_FIELD = void 0;
+var types_1 = require("./types");
+Object.defineProperty(exports, "STREAM_FIELD", { enumerable: true, get: function () { return types_1.STREAM_FIELD; } });
+Object.defineProperty(exports, "NOTIFY_STREAM", { enumerable: true, get: function () { return types_1.NOTIFY_STREAM; } });
+Object.defineProperty(exports, "NOTIFY_GROUP", { enumerable: true, get: function () { return types_1.NOTIFY_GROUP; } });
+Object.defineProperty(exports, "streamName", { enumerable: true, get: function () { return types_1.streamName; } });
+Object.defineProperty(exports, "noopLogger", { enumerable: true, get: function () { return types_1.noopLogger; } });
+var publisher_1 = require("./publisher");
+Object.defineProperty(exports, "publishToStream", { enumerable: true, get: function () { return publisher_1.publishToStream; } });
+Object.defineProperty(exports, "publishNotification", { enumerable: true, get: function () { return publisher_1.publishNotification; } });
+var consumer_1 = require("./consumer");
+Object.defineProperty(exports, "startStreamConsumer", { enumerable: true, get: function () { return consumer_1.startStreamConsumer; } });

package/dist/publisher.d.ts

@@ -0,0 +1,17 @@
+import type { Redis } from 'ioredis';
+import { NotificationIntent, MessagingLogger } from './types';
+export interface PublishOptions {
+    /** Approximate stream cap (XADD MAXLEN ~ N). Default 100000. */
+    maxLen?: number;
+    logger?: MessagingLogger;
+}
+/**
+ * XADD a JSON payload to a stream. Fire-and-forget: on Redis error it logs and
+ * returns null rather than throwing, so a messaging failure never breaks the
+ * caller's business path. Pass a real `ioredis` client (or null in STUB/dev —
+ * then it no-ops).
+ */
+export declare function publishToStream(redis: Redis | null | undefined, stream: string, payload: unknown, opts?: PublishOptions): Promise<string | null>;
+/** Convenience: publish a NotificationIntent to the unified notification bus. */
+export declare function publishNotification(redis: Redis | null | undefined, intent: NotificationIntent, opts?: PublishOptions): Promise<string | null>;
+//# sourceMappingURL=publisher.d.ts.map

package/dist/publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher.d.ts","sourceRoot":"","sources":["../src/publisher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAA+B,kBAAkB,EAAE,eAAe,EAAc,MAAM,SAAS,CAAC;AAIvG,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcxB;AAED,iFAAiF;AACjF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EAC/B,MAAM,EAAE,kBAAkB,EAC1B,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAExB"}

package/dist/publisher.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.publishToStream = publishToStream;
+exports.publishNotification = publishNotification;
+const types_1 = require("./types");
+const DEFAULT_MAXLEN = 100000;
+/**
+ * XADD a JSON payload to a stream. Fire-and-forget: on Redis error it logs and
+ * returns null rather than throwing, so a messaging failure never breaks the
+ * caller's business path. Pass a real `ioredis` client (or null in STUB/dev —
+ * then it no-ops).
+ */
+async function publishToStream(redis, stream, payload, opts = {}) {
+    const logger = opts.logger ?? types_1.noopLogger;
+    if (!redis) {
+        logger.warn({ stream }, '[STUB] publishToStream: no Redis client');
+        return null;
+    }
+    try {
+        const id = await redis.xadd(stream, 'MAXLEN', '~', opts.maxLen ?? DEFAULT_MAXLEN, '*', types_1.STREAM_FIELD, JSON.stringify(payload));
+        logger.info({ stream, id }, 'published to stream');
+        return id;
+    }
+    catch (err) {
+        logger.error({ err, stream }, 'publishToStream failed — dropped');
+        return null;
+    }
+}
+/** Convenience: publish a NotificationIntent to the unified notification bus. */
+async function publishNotification(redis, intent, opts = {}) {
+    return publishToStream(redis, types_1.NOTIFY_STREAM, intent, opts);
+}

package/dist/types.d.ts

@@ -0,0 +1,69 @@
+/** Shared Redis Streams messaging types + constants. */
+/** Stream entries store the JSON payload under this single field. */
+export declare const STREAM_FIELD = "payload";
+/** The unified notification bus. */
+export declare const NOTIFY_STREAM = "notify:stream";
+export declare const NOTIFY_GROUP = "comm";
+/** Conventional stream name for a domain exchange (e.g. 'booking_events' → 'booking_events:stream'). */
+export declare const streamName: (exchange: string) => string;
+export type NotificationChannel = 'push' | 'email' | 'sms' | 'inapp';
+export interface NotificationRecipient {
+    userId?: string;
+    userType?: string;
+    email?: string;
+    phone?: string;
+    name?: string;
+}
+/**
+ * The notification-bus contract. Producers author it; the communication service
+ * dispatches it. Email/SMS carry a template `concern`; push/in-app carry rendered
+ * text; in-app also supports a concern/template variant.
+ */
+export interface NotificationIntent {
+    id: string;
+    tenant: string;
+    source: string;
+    eventType: string;
+    recipient: NotificationRecipient;
+    channels: NotificationChannel[];
+    push?: {
+        title: string;
+        body: string;
+        data?: Record<string, string>;
+    };
+    inapp?: {
+        title?: string;
+        body?: string;
+        service?: string;
+        concern?: string;
+        meta?: Record<string, unknown>;
+        data?: Record<string, unknown>;
+    };
+    email?: {
+        concern: string;
+        subject?: string;
+        data?: Record<string, unknown>;
+    };
+    sms?: {
+        concern: string;
+        data?: Record<string, unknown>;
+    };
+    timestamp: string;
+}
+/** Generic domain-event envelope for business streams (booking/order/ride/etc.). */
+export interface DomainEvent<T = Record<string, unknown>> {
+    eventType: string;
+    tenant?: string;
+    timestamp: string;
+    payload?: T;
+    [k: string]: unknown;
+}
+/** Minimal logger the utilities use; defaults to a no-op. */
+export interface MessagingLogger {
+    info: (obj: unknown, msg?: string) => void;
+    warn: (obj: unknown, msg?: string) => void;
+    error: (obj: unknown, msg?: string) => void;
+    debug?: (obj: unknown, msg?: string) => void;
+}
+export declare const noopLogger: MessagingLogger;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAExD,qEAAqE;AACrE,eAAO,MAAM,YAAY,YAAY,CAAC;AAEtC,oCAAoC;AACpC,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAC7C,eAAO,MAAM,YAAY,SAAS,CAAC;AAEnC,wGAAwG;AACxG,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,KAAG,MAA8B,CAAC;AAE7E,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,qBAAqB,CAAC;IACjC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IACtE,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC9I,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC9E,GAAG,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC1D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oFAAoF;AACpF,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,eAAO,MAAM,UAAU,EAAE,eAKxB,CAAC"}

package/dist/types.js

@@ -0,0 +1,18 @@
+"use strict";
+/** Shared Redis Streams messaging types + constants. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noopLogger = exports.streamName = exports.NOTIFY_GROUP = exports.NOTIFY_STREAM = exports.STREAM_FIELD = void 0;
+/** Stream entries store the JSON payload under this single field. */
+exports.STREAM_FIELD = 'payload';
+/** The unified notification bus. */
+exports.NOTIFY_STREAM = 'notify:stream';
+exports.NOTIFY_GROUP = 'comm';
+/** Conventional stream name for a domain exchange (e.g. 'booking_events' → 'booking_events:stream'). */
+const streamName = (exchange) => `${exchange}:stream`;
+exports.streamName = streamName;
+exports.noopLogger = {
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+    debug: () => { },
+};

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@nipigev2/messaging-client",
+  "version": "0.1.0",
+  "description": "Shared Redis Streams messaging (publisher + consumer-group utility) for Nipige services",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "jest --forceExit",
+    "prepublishOnly": "npm run clean && npm run build && npm test"
+  },
+  "jest": {
+    "preset": "ts-jest",
+    "testEnvironment": "node",
+    "testMatch": ["**/__tests__/**/*.test.ts"],
+    "moduleFileExtensions": ["ts", "js", "json"]
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "redis",
+    "streams",
+    "messaging",
+    "nipige"
+  ],
+  "author": "Nipige",
+  "license": "UNLICENSED",
+  "peerDependencies": {
+    "ioredis": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "ioredis": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.0.0",
+    "ioredis": "^5.10.1",
+    "ioredis-mock": "^8.13.1",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.4.9",
+    "typescript": "^5.0.0"
+  }
+}