youeduc-sdk-messaging 0.0.0 → 0.5.0

package/dist/integrations/runtime.js

@@ -0,0 +1,554 @@
+/**
+ * Framework-agnostic runtime of the SDK (Python `integrations/runtime.py`, without the sync
+ * bridge: Node is async-native).
+ *
+ * - {@link MessagingSettings} — canonical configuration (`SDK_MESSAGING`, spec §14), the same
+ *   mapping used by the Python SDK (Django `settings.SDK_MESSAGING`, Flask `app.config`).
+ * - {@link buildMessaging} / {@link buildDedupStore} — facade and shared dedup store from it.
+ * - {@link serveConsumers} / {@link runConsumers} — consumer process for CLI entry points
+ *   (signals, draining, exit code).
+ *
+ * Redis is loaded only by {@link buildDedupStore} (dynamic `import('./redis.js')`), so `redis`
+ * stays an optional peer dependency.
+ */
+import { statSync } from 'node:fs';
+import { inspect } from 'node:util';
+import { isMainThread } from 'node:worker_threads';
+import { KafkaConfig } from '../config.js';
+import { schemaLoader as bundledSchemaLoader } from '../contracts/index.js';
+import { defaultLogger } from '../logger.js';
+import { Messaging } from '../messaging.js';
+import * as naming from '../naming.js';
+import { ChainSchemaLoader, FileSystemSchemaLoader } from '../schema.js';
+import { OtelTelemetry } from '../telemetry.js';
+import { errorFields, isPlainObject, pyRepr } from '../util.js';
+// =========================================================================== settings
+const REQUIRED_KEYS = ['SERVICE', 'ENVIRONMENT'];
+const OPTIONAL_KEYS = [
+    'SCHEMAS_DIR',
+    'KAFKA',
+    'SEND_TIMEOUT_S',
+    'PUBLISH_TIMEOUT_S',
+    'DRAIN_TIMEOUT_S',
+    'TENANT_METRIC_LABEL',
+    'REDIS',
+    'RESOURCE_PREFIX',
+];
+const KNOWN_KEYS = [...REQUIRED_KEYS, ...OPTIONAL_KEYS];
+const REDIS_REQUIRED_KEYS = ['URL', 'NAMESPACE'];
+const REDIS_KNOWN_KEYS = [...REDIS_REQUIRED_KEYS, 'TTL_S', 'TIMEOUT_S'];
+/**
+ * Keys of the `KAFKA` mapping: the canonical (snake_case) field names of `KafkaConfig`, identical
+ * in both SDKs (spec §14) so one `SDK_MESSAGING` document configures either of them.
+ */
+const KAFKA_KEYS = [
+    'bootstrap_servers',
+    'client_id',
+    'security_protocol',
+    'sasl_mechanism',
+    'sasl_username',
+    'sasl_password',
+];
+// Below gunicorn's default --timeout (30 s) on the Python side; same canonical defaults here.
+/** Default `SEND_TIMEOUT_S` (20 s), in ms. */
+export const DEFAULT_SEND_TIMEOUT_MS = 20_000;
+/** Default `PUBLISH_TIMEOUT_S` (25 s), in ms. */
+export const DEFAULT_PUBLISH_TIMEOUT_MS = 25_000;
+/** Default `DRAIN_TIMEOUT_S` (30 s), in ms. */
+export const DEFAULT_DRAIN_TIMEOUT_MS = 30_000;
+/** Default `REDIS.TTL_S` (7 days), in ms. */
+export const DEFAULT_REDIS_TTL_MS = 604_800_000;
+/** Default `REDIS.TIMEOUT_S` (5 s), in ms. */
+export const DEFAULT_REDIS_TIMEOUT_MS = 5000;
+/** `REDIS` block of {@link MessagingSettings} (shared dedup). Durations in ms. */
+export class RedisSettings {
+    // Private: the URL may carry a password (redis://:secret@host); kept out of JSON/inspect.
+    #url;
+    namespace;
+    ttlMs;
+    timeoutMs;
+    constructor(init) {
+        this.#url = init.url;
+        this.namespace = init.namespace;
+        this.ttlMs = init.ttlMs ?? DEFAULT_REDIS_TTL_MS;
+        this.timeoutMs = init.timeoutMs ?? DEFAULT_REDIS_TIMEOUT_MS;
+        Object.freeze(this);
+    }
+    get url() {
+        return this.#url;
+    }
+    toJSON() {
+        return { namespace: this.namespace, ttlMs: this.ttlMs, timeoutMs: this.timeoutMs };
+    }
+    [inspect.custom]() {
+        return `RedisSettings ${inspect(this.toJSON())}`;
+    }
+}
+/**
+ * Validated canonical configuration. Build it with {@link MessagingSettings.fromMapping} from the
+ * `SDK_MESSAGING` object:
+ *
+ * ```ts
+ * const settings = MessagingSettings.fromMapping({
+ *   SERVICE: 'enrollment-api',       // required (kebab-case)
+ *   ENVIRONMENT: 'production',       // required
+ *   SCHEMAS_DIR: './schemas',        // optional: null/absent → bundled contracts only
+ *   KAFKA: null,                     // null → KafkaConfig.fromEnv() (KAFKA_BOOTSTRAP_SERVERS...)
+ *   SEND_TIMEOUT_S: 20,              // broker ack wait
+ *   PUBLISH_TIMEOUT_S: 25,           // caller-side publish bound (> SEND_TIMEOUT_S)
+ *   DRAIN_TIMEOUT_S: 30,             // draining on shutdown
+ *   TENANT_METRIC_LABEL: true,
+ *   REDIS: null,                     // or { URL, NAMESPACE, TTL_S, TIMEOUT_S }
+ *   RESOURCE_PREFIX: null,           // e.g. 'hmg'/'prd' → hmg.<topic>, hmg.<group> (spec §2.7)
+ * });
+ * ```
+ *
+ * Units: the mapping is the canonical document shared with the Python SDK, so its durations are
+ * in **seconds** (`*_S`); the settings object exposes them in **milliseconds** (`sendTimeoutMs`,
+ * `publishTimeoutMs`, `drainTimeoutMs`, `redis.ttlMs`, `redis.timeoutMs`), like the rest of the
+ * Node API. `KAFKA` is a mapping with the snake_case `KafkaConfig` field names
+ * (`{ bootstrap_servers: 'kafka:9092', ... }`), never a `KafkaConfig` instance (spec §18).
+ *
+ * `publishTimeoutMs` is validated and exposed for parity; Node has no sync bridge, so the SDK
+ * itself does not use it (applications may use it to bound their own publish waits).
+ */
+export class MessagingSettings {
+    service;
+    environment;
+    /** `null` = no `SCHEMAS_DIR`: {@link buildMessaging} uses only the bundled contracts. */
+    schemasDir;
+    kafka;
+    sendTimeoutMs;
+    publishTimeoutMs;
+    drainTimeoutMs;
+    tenantMetricLabel;
+    redis;
+    /** Resource prefix applied by {@link buildMessaging} to every topic and group id (`null` = none). */
+    resourcePrefix;
+    /** No validation here: use {@link MessagingSettings.fromMapping}. */
+    constructor(init) {
+        this.service = init.service;
+        this.environment = init.environment;
+        this.schemasDir = init.schemasDir ?? null;
+        this.kafka = init.kafka;
+        this.sendTimeoutMs = init.sendTimeoutMs ?? DEFAULT_SEND_TIMEOUT_MS;
+        this.publishTimeoutMs = init.publishTimeoutMs ?? DEFAULT_PUBLISH_TIMEOUT_MS;
+        this.drainTimeoutMs = init.drainTimeoutMs ?? DEFAULT_DRAIN_TIMEOUT_MS;
+        this.tenantMetricLabel = init.tenantMetricLabel ?? true;
+        this.redis = init.redis ?? null;
+        this.resourcePrefix = init.resourcePrefix ?? null;
+        Object.freeze(this);
+    }
+    /**
+     * Validates and converts `SDK_MESSAGING`. Any problem → `TypeError` (Python `ValueError`; the
+     * `KafkaConfig` and `naming` validations also throw `TypeError`). Unknown keys are rejected,
+     * also inside `KAFKA` and `REDIS` (a typo must not pass silently). `env` replaces
+     * `process.env` when `KAFKA` is `null`/absent. An `undefined` value counts as absent.
+     */
+    static fromMapping(mapping, options = {}) {
+        if (!isPlainObject(mapping)) {
+            throw new TypeError(`SDK_MESSAGING must be a mapping; got ${typeName(mapping)}`);
+        }
+        rejectUnknown(mapping, KNOWN_KEYS, 'SDK_MESSAGING');
+        requireKeys(mapping, REQUIRED_KEYS, 'SDK_MESSAGING');
+        const service = requireStr(mapping.SERVICE, "SDK_MESSAGING['SERVICE']");
+        naming.serviceName(service);
+        const environment = requireStr(mapping.ENVIRONMENT, "SDK_MESSAGING['ENVIRONMENT']");
+        const schemasDir = mapping.SCHEMAS_DIR ?? null;
+        if (schemasDir !== null && typeof schemasDir !== 'string') {
+            throw new TypeError(`SDK_MESSAGING['SCHEMAS_DIR'] must be null or a str; got ${typeName(schemasDir)}`);
+        }
+        if (schemasDir !== null && schemasDir.trim() === '') {
+            throw new TypeError("SDK_MESSAGING['SCHEMAS_DIR'] must not be empty");
+        }
+        const tenantMetricLabel = mapping.TENANT_METRIC_LABEL === undefined ? true : mapping.TENANT_METRIC_LABEL;
+        if (typeof tenantMetricLabel !== 'boolean') {
+            throw new TypeError(`SDK_MESSAGING['TENANT_METRIC_LABEL'] must be a bool; got ${typeName(tenantMetricLabel)}`);
+        }
+        const resourcePrefix = mapping.RESOURCE_PREFIX ?? null;
+        if (resourcePrefix !== null) {
+            if (typeof resourcePrefix !== 'string') {
+                throw new TypeError(`SDK_MESSAGING['RESOURCE_PREFIX'] must be null or a str; got ${typeName(resourcePrefix)}`);
+            }
+            try {
+                naming.resourcePrefix(resourcePrefix);
+            }
+            catch (error) {
+                throw new TypeError(`SDK_MESSAGING['RESOURCE_PREFIX']: ${error.message}`);
+            }
+        }
+        const sendTimeoutS = positiveSeconds(mapping, 'SEND_TIMEOUT_S', 20, 'SDK_MESSAGING');
+        const publishTimeoutS = positiveSeconds(mapping, 'PUBLISH_TIMEOUT_S', 25, 'SDK_MESSAGING');
+        if (publishTimeoutS <= sendTimeoutS) {
+            throw new TypeError("SDK_MESSAGING['PUBLISH_TIMEOUT_S'] must be greater than" +
+                ` 'SEND_TIMEOUT_S' (${pyFloat(publishTimeoutS)} <= ${pyFloat(sendTimeoutS)}):` +
+                ' the caller must outlive the broker ack wait');
+        }
+        const kafka = parseKafka(mapping.KAFKA, options.env);
+        const drainTimeoutS = positiveSeconds(mapping, 'DRAIN_TIMEOUT_S', 30, 'SDK_MESSAGING');
+        const redis = parseRedis(mapping.REDIS);
+        return new MessagingSettings({
+            service,
+            environment,
+            schemasDir,
+            kafka,
+            sendTimeoutMs: sendTimeoutS * 1000,
+            publishTimeoutMs: publishTimeoutS * 1000,
+            drainTimeoutMs: drainTimeoutS * 1000,
+            tenantMetricLabel,
+            redis,
+            resourcePrefix,
+        });
+    }
+}
+function typeName(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'array';
+    if (typeof value === 'object') {
+        const ctor = value.constructor;
+        return typeof ctor?.name === 'string' && ctor.name !== '' ? ctor.name : 'object';
+    }
+    return typeof value;
+}
+/** Python-like repr of a configuration value (never used for secrets). */
+function repr(value) {
+    if (typeof value === 'string')
+        return pyRepr(value);
+    if (typeof value === 'number' || typeof value === 'boolean' || value == null)
+        return String(value);
+    try {
+        return JSON.stringify(value) ?? typeName(value);
+    }
+    catch {
+        return typeName(value);
+    }
+}
+/** `25` → `25.0` (Python float repr), for messages identical in shape to the Python SDK. */
+function pyFloat(value) {
+    return Number.isInteger(value) ? `${value}.0` : String(value);
+}
+function rejectUnknown(mapping, known, where) {
+    const unknown = Object.keys(mapping)
+        .filter((key) => !known.includes(key))
+        .sort();
+    if (unknown.length > 0) {
+        throw new TypeError(`unknown key(s) in ${where}: ${unknown.join(', ')} (accepted: ${[...known].sort().join(', ')})`);
+    }
+}
+function requireKeys(mapping, keys, where) {
+    const missing = keys.filter((key) => mapping[key] === undefined);
+    if (missing.length > 0) {
+        throw new TypeError(`missing required key(s) in ${where}: ${missing.join(', ')}`);
+    }
+}
+function requireStr(value, where) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new TypeError(`${where} must be a non-empty str; got ${repr(value)}`);
+    }
+    return value;
+}
+/** Finite number > 0, in seconds (booleans and numeric strings rejected). */
+function positiveSeconds(mapping, key, defaultS, where) {
+    const value = mapping[key] === undefined ? defaultS : mapping[key];
+    if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
+        throw new TypeError(`${where}['${key}'] must be a finite number > 0; got ${repr(value)}`);
+    }
+    return value;
+}
+function optionalStr(value, key, where) {
+    const field = value[key];
+    if (field === undefined || field === null || typeof field === 'string')
+        return field;
+    throw new TypeError(`${where}['${key}'] must be a str or null; got ${typeName(field)}`);
+}
+function parseKafka(value, env) {
+    if (value === undefined || value === null) {
+        return KafkaConfig.fromEnv(env === undefined ? {} : { env });
+    }
+    const where = "SDK_MESSAGING['KAFKA']";
+    if (!isPlainObject(value)) {
+        throw new TypeError(`${where} must be null or a mapping of KafkaConfig fields; got ${typeName(value)}`);
+    }
+    rejectUnknown(value, KAFKA_KEYS, where);
+    if (value.bootstrap_servers === undefined) {
+        throw new TypeError(`missing required key(s) in ${where}: bootstrap_servers`);
+    }
+    if (typeof value.bootstrap_servers !== 'string') {
+        throw new TypeError(`invalid ${where}: 'bootstrap_servers' must be a str`);
+    }
+    const protocol = value.security_protocol;
+    if (protocol !== undefined && typeof protocol !== 'string') {
+        throw new TypeError(`invalid ${where}: 'security_protocol' must be a str; got ${typeName(protocol)}`);
+    }
+    return new KafkaConfig({
+        bootstrapServers: value.bootstrap_servers,
+        clientId: optionalStr(value, 'client_id', where),
+        securityProtocol: protocol,
+        saslMechanism: optionalStr(value, 'sasl_mechanism', where),
+        saslUsername: optionalStr(value, 'sasl_username', where),
+        saslPassword: optionalStr(value, 'sasl_password', where),
+    });
+}
+function parseRedis(value) {
+    if (value === undefined || value === null)
+        return null;
+    const where = "SDK_MESSAGING['REDIS']";
+    if (!isPlainObject(value)) {
+        throw new TypeError(`${where} must be null or a mapping; got ${typeName(value)}`);
+    }
+    rejectUnknown(value, REDIS_KNOWN_KEYS, where);
+    requireKeys(value, REDIS_REQUIRED_KEYS, where);
+    const url = requireStr(value.URL, `${where}['URL']`);
+    const namespace = naming.dedupNamespace(requireStr(value.NAMESPACE, `${where}['NAMESPACE']`));
+    return new RedisSettings({
+        url,
+        namespace,
+        ttlMs: positiveSeconds(value, 'TTL_S', 604_800, where) * 1000,
+        timeoutMs: positiveSeconds(value, 'TIMEOUT_S', 5, where) * 1000,
+    });
+}
+// =========================================================================== factories
+/**
+ * Schema loader of {@link buildMessaging} (spec §14): no `SCHEMAS_DIR` → the bundled contracts
+ * (`contracts.schemaLoader()`); with it → `ChainSchemaLoader(FileSystemSchemaLoader(SCHEMAS_DIR),
+ * bundled)` (the service's schemas win, the bundled ones cover the rest). A `SCHEMAS_DIR` that is
+ * not a directory → `TypeError` (fail early instead of `SchemaNotFoundError` later).
+ */
+function buildSchemaLoader(settings) {
+    const dir = settings.schemasDir;
+    if (dir === null)
+        return bundledSchemaLoader();
+    let isDirectory = false;
+    try {
+        isDirectory = statSync(dir).isDirectory();
+    }
+    catch {
+        // missing / unreadable → not a directory
+    }
+    if (!isDirectory) {
+        throw new TypeError(`SDK_MESSAGING['SCHEMAS_DIR'] is not a directory: ${dir}`);
+    }
+    return new ChainSchemaLoader(new FileSystemSchemaLoader(dir), bundledSchemaLoader());
+}
+/**
+ * {@link Messaging} with the schema loader described in spec §14 (bundled contracts, preceded
+ * by `FileSystemSchemaLoader(SCHEMAS_DIR)` when set) and `OtelTelemetry`. Starts nothing. A
+ * `SCHEMAS_DIR` that is not a directory → `TypeError`.
+ */
+export function buildMessaging(settings, options = {}) {
+    const schemaLoader = buildSchemaLoader(settings);
+    return new Messaging(settings.kafka, {
+        service: settings.service,
+        environment: settings.environment,
+        schemaLoader,
+        telemetry: new OtelTelemetry(settings.service, settings.environment, {
+            tenantMetricLabel: settings.tenantMetricLabel,
+        }),
+        sendTimeoutMs: settings.sendTimeoutMs,
+        resourcePrefix: settings.resourcePrefix,
+        ...(options.logger === undefined ? {} : { logger: options.logger }),
+    });
+}
+/**
+ * `RedisDedupStore` from the `REDIS` block (`null` without it). The Redis module (and `redis`
+ * itself) is imported only here, so the peer dependency stays optional.
+ */
+export async function buildDedupStore(settings) {
+    const redis = settings.redis;
+    if (redis === null)
+        return null;
+    const { RedisDedupStore } = await import('./redis.js');
+    return RedisDedupStore.fromUrl(redis.url, {
+        namespace: redis.namespace,
+        ttlMs: redis.ttlMs,
+        timeoutMs: redis.timeoutMs,
+    });
+}
+/**
+ * Runs consumers until SIGINT/SIGTERM (or `requestStop`) or the first fatal error.
+ *
+ * - Facade: `messagingFactory()` or `buildMessaging(settings)`.
+ * - Dedup store: `dedupStoreFactory()` or `buildDedupStore(settings)`; pinged once
+ *   (`dedup_store_unreachable` when down) and always closed at the end.
+ * - Shutdown: stops the consumers and the facade, draining up to `drainTimeoutMs`. Signals stay
+ *   captured while draining: a second signal is only logged.
+ *
+ * Resolves `0` (signal / requested stop) or `1` (a consumer crashed — `consumers_crashed` — or the
+ * shutdown failed). Startup errors (`build`, `start`, empty build) are rethrown after cleanup.
+ */
+export async function serveConsumers(build, options = {}) {
+    const { settings, messagingFactory } = options;
+    if (messagingFactory === undefined && settings === undefined) {
+        throw new TypeError("serveConsumers() needs 'settings' or 'messagingFactory'");
+    }
+    const drainTimeoutMs = options.drainTimeoutMs ?? settings?.drainTimeoutMs ?? DEFAULT_DRAIN_TIMEOUT_MS;
+    if (typeof drainTimeoutMs !== 'number' || !Number.isFinite(drainTimeoutMs) || drainTimeoutMs <= 0) {
+        throw new RangeError(`'drain_timeout_ms' must be a finite number > 0; got ${String(drainTimeoutMs)}`);
+    }
+    let stopRequested = false;
+    let signalStop = () => { };
+    const stopPromise = new Promise((resolve) => {
+        signalStop = resolve;
+    });
+    const requestStop = () => {
+        stopRequested = true;
+        signalStop();
+    };
+    const messaging = messagingFactory !== undefined
+        ? await messagingFactory()
+        : buildMessaging(settings, {
+            ...(options.logger === undefined ? {} : { logger: options.logger }),
+        });
+    const logger = options.logger ?? messaging.logger ?? defaultLogger();
+    let store = null;
+    let consumers = [];
+    let restoreSignals = null;
+    let exitCode = 0;
+    try {
+        if (options.installSignalHandlers ?? true) {
+            // Before start: a SIGTERM during startup also ends cleanly.
+            restoreSignals = installSignalHandlers(options.signals, requestStop, logger);
+        }
+        if (options.dedupStoreFactory !== undefined)
+            store = await options.dedupStoreFactory();
+        else if (settings !== undefined)
+            store = await buildDedupStore(settings);
+        if (store !== null && !(await store.ping()))
+            logger.warn('dedup_store_unreachable');
+        await messaging.start();
+        consumers = [...(await build(messaging, store))];
+        if (consumers.length === 0)
+            throw new TypeError('build() returned no consumers');
+        for (const consumer of consumers)
+            await consumer.start();
+        const results = consumers.map(() => ({ settled: false }));
+        const waiters = consumers.map((consumer, index) => Promise.resolve()
+            .then(() => consumer.wait())
+            .then(() => {
+            results[index] = { settled: true, error: undefined, failed: false };
+        }, (error) => {
+            results[index] = { settled: true, error, failed: true };
+        }));
+        logger.info('consumers_running', { messaging: { groups: consumers.map((c) => c.group) } });
+        options.onReady?.(requestStop);
+        await Promise.race([stopPromise, ...waiters]);
+        const stopNow = stopRequested;
+        results.forEach((result, index) => {
+            if (!result.settled)
+                return;
+            if (!result.failed && stopNow)
+                return; // stopped together with the stop request
+            // Fatal error, or loop ended without anyone asking: the process must not stay alive
+            // without consuming.
+            exitCode = 1;
+            logger.error('consumers_crashed', {
+                messaging: { group: consumers[index]?.group },
+                error: result.failed
+                    ? errorFields(result.error)
+                    : { type: 'ConsumerStopped', message: 'stopped unexpectedly' },
+            });
+        });
+        if (exitCode === 0)
+            logger.info('consumers_stop_requested');
+    }
+    finally {
+        try {
+            exitCode = await shutdownConsumers(messaging, consumers, store, drainTimeoutMs, exitCode, logger);
+        }
+        finally {
+            restoreSignals?.();
+        }
+    }
+    return exitCode;
+}
+/**
+ * CLI entry point: `await serveConsumers(...)` and sets `process.exitCode` to the result.
+ *
+ * Run it in a process/Deployment **separate** from the web server and keep the termination
+ * grace period above `drainTimeoutMs`. Startup errors are rethrown (unhandled → exit code 1).
+ */
+export async function runConsumers(build, options = {}) {
+    const code = await serveConsumers(build, options);
+    process.exitCode = code;
+    return code;
+}
+async function shutdownConsumers(messaging, consumers, store, drainTimeoutMs, exitCode, logger) {
+    let code = exitCode;
+    try {
+        try {
+            // Consumers created outside messaging.consumer() are stopped too (stop() is idempotent).
+            const results = await Promise.allSettled(consumers.map((consumer) => Promise.resolve().then(() => consumer.stop({ drainTimeoutMs }))));
+            results.forEach((result, index) => {
+                if (result.status === 'fulfilled')
+                    return;
+                code = 1;
+                logger.error('consumer_stop_failed', {
+                    messaging: { group: consumers[index]?.group },
+                    error: errorFields(result.reason),
+                });
+            });
+            await messaging.stop({ drainTimeoutMs });
+        }
+        catch (error) {
+            code = 1;
+            logger.error('consumers_shutdown_failed', { error: errorFields(error) });
+        }
+    }
+    finally {
+        if (store !== null) {
+            try {
+                await store.close();
+            }
+            catch (error) {
+                logger.warn('dedup_store_close_failed', { error: errorFields(error) });
+            }
+        }
+    }
+    logger.info('consumers_stopped', { exit_code: code });
+    return code;
+}
+const STOP_SIGNALS = ['SIGINT', 'SIGTERM'];
+/** Installs SIGINT/SIGTERM listeners; returns the function that removes them. */
+function installSignalHandlers(source, requestStop, logger) {
+    if (source === undefined && !isMainThread) {
+        logger.warn('signal_handlers_not_installed', { reason: 'not the main thread' });
+        return null;
+    }
+    const target = source ?? process;
+    const installed = [];
+    let received = 0;
+    const remove = () => {
+        for (const [signal, listener] of installed.splice(0)) {
+            try {
+                target.off(signal, listener);
+            }
+            catch {
+                // defensive: nothing else to restore
+            }
+        }
+    };
+    try {
+        for (const signal of STOP_SIGNALS) {
+            const listener = () => {
+                received += 1;
+                if (received === 1)
+                    logger.info('consumers_signal_received', { signal });
+                else
+                    logger.warn('consumers_shutdown_already_in_progress', { signal });
+                requestStop();
+            };
+            target.on(signal, listener);
+            installed.push([signal, listener]);
+        }
+    }
+    catch (error) {
+        remove();
+        const { type, message } = errorFields(error);
+        logger.warn('signal_handlers_not_installed', { reason: `${type}: ${message}` });
+        return null;
+    }
+    return remove;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/integrations/runtime.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Logging contract. The SDK logs structured events (same event names as the Python SDK) with
+ * the context grouped in `messaging` and failures in `error: {type, message}`. Payload and
+ * message key are never logged.
+ *
+ * Default: JSON via `pino`, logger name `sdk_messaging`, the event name in the `event` field
+ * (like structlog) and the level as text (`"level":"info"`).
+ */
+import pino from 'pino';
+/** Structured fields of a log event (`messaging`, `error`, ...). */
+export type LogFields = Record<string, unknown>;
+export interface Logger {
+    debug(event: string, fields?: LogFields): void;
+    info(event: string, fields?: LogFields): void;
+    warn(event: string, fields?: LogFields): void;
+    error(event: string, fields?: LogFields): void;
+}
+/** Logger that discards everything. */
+export declare const noopLogger: Logger;
+/** Minimal shape of a pino logger used by {@link pinoLogger}. */
+export interface PinoLike {
+    debug(obj: object, msg?: string): void;
+    info(obj: object, msg?: string): void;
+    warn(obj: object, msg?: string): void;
+    error(obj: object, msg?: string): void;
+}
+/** Options of the default pino instance (`name: "sdk_messaging"`, `event` as message key). */
+export declare function defaultPinoOptions(): pino.LoggerOptions;
+/**
+ * Adapts a pino instance (default: a new one with {@link defaultPinoOptions}) to {@link Logger}.
+ * The event name is passed as the pino message; the fields are merged into the JSON line.
+ */
+export declare function pinoLogger(instance?: PinoLike): Logger;
+/** Process-wide default logger (lazily created pino JSON logger). */
+export declare function defaultLogger(): Logger;
+/** Replaces the process-wide default logger (e.g. to plug the application's pino instance). */
+export declare function setDefaultLogger(logger: Logger): void;

package/dist/logger.js

@@ -0,0 +1,49 @@
+/**
+ * Logging contract. The SDK logs structured events (same event names as the Python SDK) with
+ * the context grouped in `messaging` and failures in `error: {type, message}`. Payload and
+ * message key are never logged.
+ *
+ * Default: JSON via `pino`, logger name `sdk_messaging`, the event name in the `event` field
+ * (like structlog) and the level as text (`"level":"info"`).
+ */
+import pino from 'pino';
+/** Logger that discards everything. */
+export const noopLogger = Object.freeze({
+    debug() { },
+    info() { },
+    warn() { },
+    error() { },
+});
+/** Options of the default pino instance (`name: "sdk_messaging"`, `event` as message key). */
+export function defaultPinoOptions() {
+    return {
+        name: 'sdk_messaging',
+        messageKey: 'event',
+        formatters: { level: (label) => ({ level: label }) },
+        timestamp: pino.stdTimeFunctions.isoTime,
+    };
+}
+/**
+ * Adapts a pino instance (default: a new one with {@link defaultPinoOptions}) to {@link Logger}.
+ * The event name is passed as the pino message; the fields are merged into the JSON line.
+ */
+export function pinoLogger(instance) {
+    const target = instance ?? pino(defaultPinoOptions());
+    return {
+        debug: (event, fields) => target.debug(fields ?? {}, event),
+        info: (event, fields) => target.info(fields ?? {}, event),
+        warn: (event, fields) => target.warn(fields ?? {}, event),
+        error: (event, fields) => target.error(fields ?? {}, event),
+    };
+}
+let shared;
+/** Process-wide default logger (lazily created pino JSON logger). */
+export function defaultLogger() {
+    shared ??= pinoLogger();
+    return shared;
+}
+/** Replaces the process-wide default logger (e.g. to plug the application's pino instance). */
+export function setDefaultLogger(logger) {
+    shared = logger;
+}
+//# sourceMappingURL=logger.js.map