youeduc-sdk-messaging 0.0.0 → 0.5.0

package/dist/headers.js

@@ -0,0 +1,144 @@
+/**
+ * Message headers. In Kafka headers are bytes; in the SDK they travel as a `string → string`
+ * map, (de)coded as UTF-8 at the edge. Header names and value formats are protocol: identical
+ * to the Python SDK.
+ */
+import { randomUUID } from 'node:crypto';
+import { errorMessage, errorTypeName, formatIsoUtc, truncateChars } from './util.js';
+export const MESSAGE_ID = 'message_id';
+export const EVENT_TYPE = 'event_type';
+export const SCHEMA_VERSION = 'schema_version';
+export const PUBLISHED_AT = 'published_at';
+export const PRODUCER = 'producer';
+export const CORRELATION_ID = 'correlation_id';
+export const IDEMPOTENCY_KEY = 'idempotency_key';
+export const TENANT_ID = 'x-tenant-id';
+export const RETRY_COUNT = 'x-retry-count';
+/** Epoch in milliseconds. */
+export const RETRY_DUE_AT = 'x-retry-due-at';
+export const FIRST_FAILED_AT = 'x-first-failed-at';
+export const LAST_ERROR = 'x-last-error';
+export const LAST_ERROR_TYPE = 'x-last-error-type';
+export const ORIGINAL_TOPIC = 'x-original-topic';
+export const ORIGINAL_PARTITION = 'x-original-partition';
+export const ORIGINAL_OFFSET = 'x-original-offset';
+export const DLQ_REASON = 'x-dlq-reason';
+/** Error messages are truncated (in characters / code points, like Python) to keep headers small. */
+export const MAX_ERROR_LENGTH = 1024;
+const utf8 = new TextDecoder('utf-8', { fatal: false, ignoreBOM: true });
+/** Epoch milliseconds now. */
+export function nowMs() {
+    return Date.now();
+}
+/** `MessageHeaders` → wire format (UTF-8), keeping insertion order. */
+export function encode(headers) {
+    return Object.entries(headers).map(([name, value]) => [name, Buffer.from(value, 'utf8')]);
+}
+function decodeValue(value) {
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    return utf8.decode(value); // invalid UTF-8 → U+FFFD, like errors="replace"
+}
+/**
+ * Last occurrence wins; invalid UTF-8 is replaced (U+FFFD); `null` values become `''`.
+ * The result has no prototype, so a header named `__proto__` is kept as a plain entry.
+ */
+export function decode(raw) {
+    const decoded = Object.create(null);
+    if (raw === null || raw === undefined)
+        return decoded;
+    if (Array.isArray(raw)) {
+        for (const [name, value] of raw) {
+            decoded[name] = decodeValue(value);
+        }
+        return decoded;
+    }
+    for (const [name, value] of Object.entries(raw)) {
+        if (Array.isArray(value)) {
+            if (value.length > 0)
+                decoded[name] = decodeValue(value[value.length - 1]);
+        }
+        else {
+            decoded[name] = decodeValue(value);
+        }
+    }
+    return decoded;
+}
+// Spec §4.1: `^\s*[+-]?[0-9]+\s*$` (ASCII); anything else → 0.
+const HEADER_INT_RE = /^[ \t\n\r\f\v]*([+-]?[0-9]+)[ \t\n\r\f\v]*$/;
+/** Integer header (`x-retry-count`, `x-retry-due-at`): absent, empty or invalid → 0. */
+export function parseHeaderInt(value) {
+    const match = value === undefined ? null : HEADER_INT_RE.exec(value);
+    if (match === null)
+        return 0;
+    const parsed = Number(match[1]);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+/** Reads `x-retry-count` tolerating absence/invalid values (→ 0); negative → 0. */
+export function retryCount(headers) {
+    return Math.max(parseHeaderInt(headers[RETRY_COUNT]), 0);
+}
+/** Reads `x-retry-due-at` (epoch ms); absent or invalid → 0 (= already due). */
+export function retryDueAtMs(headers) {
+    return parseHeaderInt(headers[RETRY_DUE_AT]);
+}
+/**
+ * Dedup key (spec §8.1): `idempotency_key` if not empty, else `message_id` if not empty, else
+ * `null` (no dedup). Used verbatim.
+ */
+export function dedupKey(headers) {
+    return headers[IDEMPOTENCY_KEY] || headers[MESSAGE_ID] || null;
+}
+/** Headers of a new publication: fresh UUID4 `message_id`, `correlation_id` given or new. */
+export function buildPublishHeaders(init) {
+    const newId = init.newId ?? randomUUID;
+    const clock = init.clock ?? nowMs;
+    const headers = {
+        [MESSAGE_ID]: newId(),
+        [EVENT_TYPE]: init.eventType,
+        [SCHEMA_VERSION]: init.schemaVersion,
+        [PUBLISHED_AT]: formatIsoUtc(clock()),
+        [PRODUCER]: init.producer,
+        // Python: `correlation_id or uuid4()` (empty string also generates a new one).
+        [CORRELATION_ID]: init.correlationId || newId(),
+    };
+    if (init.idempotencyKey !== null && init.idempotencyKey !== undefined) {
+        headers[IDEMPOTENCY_KEY] = init.idempotencyKey;
+    }
+    // An empty tenant is the same as no tenant (spec vectors `publish-headers`).
+    if (init.tenantId)
+        headers[TENANT_ID] = init.tenantId;
+    return headers;
+}
+function withError(headers, error, position) {
+    const updated = { ...headers };
+    updated[LAST_ERROR] = truncateChars(errorMessage(error), MAX_ERROR_LENGTH);
+    updated[LAST_ERROR_TYPE] = errorTypeName(error);
+    // The origin is the first consumption (main topic), preserved across retries.
+    setDefault(updated, FIRST_FAILED_AT, () => formatIsoUtc((position.clock ?? nowMs)()));
+    setDefault(updated, ORIGINAL_TOPIC, () => position.topic);
+    setDefault(updated, ORIGINAL_PARTITION, () => String(position.partition));
+    setDefault(updated, ORIGINAL_OFFSET, () => String(position.offset));
+    return updated;
+}
+function setDefault(headers, name, value) {
+    if (!Object.hasOwn(headers, name))
+        headers[name] = value();
+}
+/** Headers for the next retry: increments `x-retry-count`, sets `x-retry-due-at` (epoch ms). */
+export function buildRetryHeaders(headers, error, init) {
+    const updated = withError(headers, error, init);
+    updated[RETRY_COUNT] = String(retryCount(headers) + 1);
+    updated[RETRY_DUE_AT] = String(Math.trunc(init.dueAtMs));
+    return updated;
+}
+/** Headers for the DLQ: removes `x-retry-due-at`, sets `x-dlq-reason`, keeps `x-retry-count`. */
+export function buildDlqHeaders(headers, error, init) {
+    const updated = withError(headers, error, init);
+    delete updated[RETRY_DUE_AT];
+    updated[DLQ_REASON] = init.reason;
+    return updated;
+}
+//# sourceMappingURL=headers.js.map

package/dist/headers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/** youeduc-sdk-messaging — asynchronous messaging SDK over Apache Kafka (Node.js). */
+export { type AdminFactory, type AdminTopicConfig, createConfluentAdmin, type EnsureTopicsOptions, ensureTopics, type KafkaAdminLike, } from './admin.js';
+export { type ClientConfig, type Environment, KafkaConfig, type KafkaConfigInit, type KafkaSslOptions, SECURITY_PROTOCOLS, type SecurityProtocol, } from './config.js';
+export { type AutoOffsetReset, Consumer, type ConsumerHandlers, type ConsumerOptions, isFatalPollError, } from './consumer.js';
+export { ConfluentConsumerClient, type ConsumerClientFactory, type ConsumerClientHooks, type ConsumerRecord, createConfluentConsumer, type KafkaConsumerClient, type RdKafkaConsumerConstructor, type RdKafkaConsumerLike, type RdKafkaMessage, type RebalanceListener, type TopicPartition, type TopicPartitionOffset, } from './consumer-client.js';
+/** Business contracts generated from `../contracts` (types + bundled schemas). */
+export * as contracts from './contracts/index.js';
+export { InMemoryDuplicateChecker, type InMemoryDuplicateCheckerOptions } from './dedup.js';
+export { createConfluentReplayConsumer, createConfluentReplayProducer, type ReplayConsumerClient, type ReplayConsumerFactory, type ReplayDlqOptions, type ReplayProducerClient, type ReplayProducerFactory, type ReplayRecord, type ReplayReport, replayDlq, replayGroupId, replayHeaders, } from './dlq.js';
+export { DedupUnavailableError, HandlerCancelledError, InvalidHandlerError, InvalidPayloadError, MessagingError, NotStartedError, PermanentProcessingError, PublishError, SchemaNotFoundError, SchemaValidationError, } from './errors.js';
+export type { KafkaHeaders, MessageHeaders, RawHeaders } from './headers.js';
+export * as headers from './headers.js';
+/**
+ * Framework-agnostic runtime (canonical `SDK_MESSAGING` settings, consumer process). It has no
+ * static `redis` import: `RedisDedupStore` stays on the `./redis` subpath and `buildDedupStore`
+ * loads it on demand.
+ */
+export { buildDedupStore, buildMessaging, type ConsumerBuilder, type ConsumerFactory, type DedupStore, MessagingSettings, type MessagingSettingsInit, RedisSettings, type RunnableConsumer, type RunnableMessaging, runConsumers, type SdkMessagingMapping, type ServeConsumersOptions, type SignalSource, serveConsumers, } from './integrations/runtime.js';
+export { defaultLogger, defaultPinoOptions, type LogFields, type Logger, noopLogger, type PinoLike, pinoLogger, setDefaultLogger, } from './logger.js';
+export { type ManagedSender, Messaging, type MessagingConsumerOptions, type MessagingEnsureTopicsOptions, type MessagingOptions, type StoppableConsumer, } from './messaging.js';
+export * as naming from './naming.js';
+export { decodePayload } from './payload.js';
+export { Publisher, type PublisherOptions, type PublishOptions, publishKey } from './publisher.js';
+export { DEFAULT_RETRY_DELAYS_MS, RetryPolicy, type RetryPolicyOptions } from './retry.js';
+export { ChainSchemaLoader, FileSystemSchemaLoader, InMemorySchemaLoader, JsonSchemaValidator, type SchemaFileSystem, SchemaRegistry, } from './schema.js';
+export { DURATION_BUCKETS_S, NoopTelemetry, OtelTelemetry, type OtelTelemetryOptions, } from './telemetry.js';
+export { type CompressionType, createConfluentProducer, isKafkaClientError, isRetriable, KafkaErrorCodes, type KafkaProducerLike, KafkaProducerSender, type KafkaProducerSenderOptions, type ProducerFactory, type ProducerHeaders, type ProducerRecordMetadata, } from './transport.js';
+export { CONSUME_OUTCOMES, type ConsumedMessage, type ConsumeOutcome, type ConsumeRecord, type ConsumeSpan, createMessageInfo, DLQ_REASONS, type DlqReason, type DlqRecord, type DuplicateChecker, type JsonObject, type MessageHandler, type MessageInfo, type MessageInfoInit, type MessageSender, type PayloadValidationRequest, type PayloadValidator, type PublishRecord, type PublishResult, type PublishStatus, type RetryRecord, type SchemaLoader, type SchemaValidator, type SchemaValidatorFactory, type SendOptions, type SentRecord, type Telemetry, } from './types.js';
+/** Package version (from `package.json`; the release tag `vX.Y.Z` → `X.Y.Z`). */
+export declare const version: string;

package/dist/index.js

@@ -0,0 +1,32 @@
+/** youeduc-sdk-messaging — asynchronous messaging SDK over Apache Kafka (Node.js). */
+import { createRequire } from 'node:module';
+export { createConfluentAdmin, ensureTopics, } from './admin.js';
+export { KafkaConfig, SECURITY_PROTOCOLS, } from './config.js';
+export { Consumer, isFatalPollError, } from './consumer.js';
+export { ConfluentConsumerClient, createConfluentConsumer, } from './consumer-client.js';
+/** Business contracts generated from `../contracts` (types + bundled schemas). */
+export * as contracts from './contracts/index.js';
+export { InMemoryDuplicateChecker } from './dedup.js';
+export { createConfluentReplayConsumer, createConfluentReplayProducer, replayDlq, replayGroupId, replayHeaders, } from './dlq.js';
+export { DedupUnavailableError, HandlerCancelledError, InvalidHandlerError, InvalidPayloadError, MessagingError, NotStartedError, PermanentProcessingError, PublishError, SchemaNotFoundError, SchemaValidationError, } from './errors.js';
+export * as headers from './headers.js';
+/**
+ * Framework-agnostic runtime (canonical `SDK_MESSAGING` settings, consumer process). It has no
+ * static `redis` import: `RedisDedupStore` stays on the `./redis` subpath and `buildDedupStore`
+ * loads it on demand.
+ */
+export { buildDedupStore, buildMessaging, MessagingSettings, RedisSettings, runConsumers, serveConsumers, } from './integrations/runtime.js';
+export { defaultLogger, defaultPinoOptions, noopLogger, pinoLogger, setDefaultLogger, } from './logger.js';
+export { Messaging, } from './messaging.js';
+export * as naming from './naming.js';
+export { decodePayload } from './payload.js';
+export { Publisher, publishKey } from './publisher.js';
+export { DEFAULT_RETRY_DELAYS_MS, RetryPolicy } from './retry.js';
+export { ChainSchemaLoader, FileSystemSchemaLoader, InMemorySchemaLoader, JsonSchemaValidator, SchemaRegistry, } from './schema.js';
+export { DURATION_BUCKETS_S, NoopTelemetry, OtelTelemetry, } from './telemetry.js';
+export { createConfluentProducer, isKafkaClientError, isRetriable, KafkaErrorCodes, KafkaProducerSender, } from './transport.js';
+export { CONSUME_OUTCOMES, createMessageInfo, DLQ_REASONS, } from './types.js';
+/** Package version (from `package.json`; the release tag `vX.Y.Z` → `X.Y.Z`). */
+export const version = createRequire(import.meta.url)('../package.json')
+    .version;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAGL,oBAAoB,EAEpB,YAAY,GAEb,MAAM,YAAY,CAAC;AACpB,OAAO,EAGL,WAAW,EAGX,kBAAkB,GAEnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,QAAQ,EAGR,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,uBAAuB,EAIvB,uBAAuB,GAQxB,MAAM,sBAAsB,CAAC;AAC9B,kFAAkF;AAClF,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAwC,MAAM,YAAY,CAAC;AAC5F,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAQ7B,SAAS,EACT,aAAa,EACb,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,wBAAwB,EACxB,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC;;;;GAIG;AACH,OAAO,EACL,eAAe,EACf,cAAc,EAId,iBAAiB,EAEjB,aAAa,EAGb,YAAY,EAIZ,cAAc,GACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,aAAa,EACb,kBAAkB,EAGlB,UAAU,EAEV,UAAU,EACV,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,SAAS,GAKV,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,SAAS,EAA8C,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAA2B,MAAM,YAAY,CAAC;AAC3F,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EAEnB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,aAAa,GAEd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,uBAAuB,EACvB,kBAAkB,EAClB,WAAW,EACX,eAAe,EAEf,mBAAmB,GAKpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAKhB,iBAAiB,EACjB,WAAW,GAqBZ,MAAM,YAAY,CAAC;AAEpB,iFAAiF;AACjF,MAAM,CAAC,MAAM,OAAO,GAAY,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAyB;KACtG,OAAO,CAAC"}

package/dist/integrations/redis.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Shared deduplication in Redis (spec §8.2), a {@link DuplicateChecker} per consumer group.
+ *
+ * Exposed as the subpath export `youeduc-sdk-messaging/redis` (never from the main entry point):
+ * `redis` (node-redis) is an optional peer dependency and only this module imports it, so
+ * applications without Redis never load it.
+ *
+ * ```ts
+ * const store = RedisDedupStore.fromUrl('redis://redis:6379/0', { namespace: 'hmgcatalogo_api' });
+ * const consumer = messaging.consumer({ ..., group: 'learning-worker',
+ *   duplicateChecker: store.checker('learning-worker') });
+ * ...
+ * await store.close();
+ * ```
+ *
+ * Isolation in a shared Redis: every key lives under the system/environment `namespace`
+ * (`catalogo_api`, `hmgcatalogo_api`...): `{namespace}:sdk-messaging:dedup:{group}:{dedupKey}`. The
+ * namespace has no `:` and the group is kebab-case, so the prefix is unambiguous. To clean an
+ * environment: `SCAN` + `UNLINK` on `{namespace}:sdk-messaging:*`.
+ *
+ * TTL (`ttlMs`, default 7 days): the mark must outlive every window in which the same message
+ * can still be redelivered (retry ladder, consumer lag, routing holds, manual replays). It is
+ * sent to Redis in whole seconds, rounded up, minimum 1 (`SET key "1" EX n`, no `NX`: marking
+ * again renews the TTL).
+ *
+ * Timeouts (`timeoutMs`, default 5000): every operation is bounded by it; `fromUrl` also uses it
+ * as the connection timeout (`socket.connectTimeout`, overridable through the client options).
+ * A timeout or a Redis failure becomes {@link DedupUnavailableError}: the consumer treats a
+ * failed query as "not processed" and only logs a failed mark, so with Redis down the
+ * consumption goes on **without** deduplication (handlers must be idempotent).
+ *
+ * The dedup key (idempotency key / message id) may be PII: it never appears in error messages
+ * of this module (only namespace, group and operation).
+ */
+import { type RedisClientOptions, type RedisFunctions, type RedisModules, type RedisScripts, type RespVersions } from 'redis';
+import type { DuplicateChecker } from '../types.js';
+export { DedupUnavailableError } from '../errors.js';
+/** Default TTL of a mark: 7 days. */
+export declare const DEFAULT_TTL_MS = 604800000;
+/** Default timeout of each Redis operation (and of the connection created by `fromUrl`). */
+export declare const DEFAULT_TIMEOUT_MS = 5000;
+/**
+ * What the store uses from a Redis client. A node-redis client (`createClient()`) satisfies it;
+ * an injected client must already be connected (its lifecycle belongs to the caller).
+ */
+export interface RedisClientLike {
+    exists(key: string): Promise<unknown>;
+    set(key: string, value: string, options: {
+        expiration: {
+            type: 'EX';
+            value: number;
+        };
+    }): Promise<unknown>;
+    ping(): Promise<unknown>;
+}
+export interface RedisDedupStoreOptions {
+    /** System/environment prefix (spec §2.1): 1-100 chars of `[A-Za-z0-9_.-]`, no `:`. */
+    namespace: string;
+    /** Validity of a mark. Default 604 800 000 ms (7 days); sent as whole seconds, rounded up. */
+    ttlMs?: number;
+    /** Bound of every operation. Default 5000 ms. */
+    timeoutMs?: number;
+}
+/** {@link RedisDedupStoreOptions} plus node-redis client options (they override the defaults). */
+export type RedisDedupStoreFromUrlOptions = RedisDedupStoreOptions & Omit<RedisClientOptions<RedisModules, RedisFunctions, RedisScripts, RespVersions>, 'url'>;
+/** Module-private members shared by the store and its checkers. */
+declare const CALL: unique symbol;
+declare const TTL_SECONDS: unique symbol;
+/**
+ * Owner of the configuration (namespace, TTL, timeout) and of the Redis client. One store per
+ * process/system; one {@link RedisDuplicateChecker} per consumer group (`checker(group)`), all
+ * sharing the same client.
+ */
+export declare class RedisDedupStore {
+    #private;
+    /**
+     * Wraps a client owned by the caller: `close()` does not close it and the store never connects
+     * it (connect it before use).
+     */
+    constructor(client: RedisClientLike, options: RedisDedupStoreOptions);
+    /**
+     * Creates a node-redis client for `url` (lazy: it connects on the first operation) and owns it:
+     * `close()` closes it. `socket.connectTimeout` defaults to `timeoutMs`; the remaining options
+     * are passed to `createClient` and override the defaults.
+     */
+    static fromUrl(url: string, options: RedisDedupStoreFromUrlOptions): RedisDedupStore;
+    get namespace(): string;
+    get ttlMs(): number;
+    get timeoutMs(): number;
+    /** Checker of the consumer group `group` (validated by `naming.consumerGroup`). */
+    checker(group: string): RedisDuplicateChecker;
+    /** Health check bounded by `timeoutMs`. Never throws: failure → `false`. */
+    ping(): Promise<boolean>;
+    /** Closes the client only if it was created by {@link fromUrl}. Idempotent. */
+    close(): Promise<void>;
+    /** Runs a Redis command for a checker (timeout + error wrapping). */
+    [CALL]<T>(operation: string, group: string, command: (client: RedisClientLike) => Promise<T>): Promise<T>;
+    /** TTL sent to Redis (`EX`): whole seconds, rounded up, minimum 1. */
+    get [TTL_SECONDS](): number;
+}
+/**
+ * {@link DuplicateChecker} of one group, created by {@link RedisDedupStore.checker}.
+ *
+ * - `isProcessed`: `EXISTS` of the key.
+ * - `markProcessed`: `SET key "1" EX ttl`. Plain SET (no `NX`): a new mark overwrites and renews
+ *   the TTL. Safe because the consumer only marks after the handler **succeeded**.
+ */
+export declare class RedisDuplicateChecker implements DuplicateChecker {
+    #private;
+    constructor(store: RedisDedupStore, group: string);
+    get group(): string;
+    get namespace(): string;
+    /** Redis key of `dedupKey`: `{namespace}:sdk-messaging:dedup:{group}:{dedupKey}`. */
+    keyFor(dedupKey: string): string;
+    isProcessed(key: string): Promise<boolean>;
+    markProcessed(key: string): Promise<void>;
+    toString(): string;
+}

package/dist/integrations/redis.js

@@ -0,0 +1,272 @@
+/**
+ * Shared deduplication in Redis (spec §8.2), a {@link DuplicateChecker} per consumer group.
+ *
+ * Exposed as the subpath export `youeduc-sdk-messaging/redis` (never from the main entry point):
+ * `redis` (node-redis) is an optional peer dependency and only this module imports it, so
+ * applications without Redis never load it.
+ *
+ * ```ts
+ * const store = RedisDedupStore.fromUrl('redis://redis:6379/0', { namespace: 'hmgcatalogo_api' });
+ * const consumer = messaging.consumer({ ..., group: 'learning-worker',
+ *   duplicateChecker: store.checker('learning-worker') });
+ * ...
+ * await store.close();
+ * ```
+ *
+ * Isolation in a shared Redis: every key lives under the system/environment `namespace`
+ * (`catalogo_api`, `hmgcatalogo_api`...): `{namespace}:sdk-messaging:dedup:{group}:{dedupKey}`. The
+ * namespace has no `:` and the group is kebab-case, so the prefix is unambiguous. To clean an
+ * environment: `SCAN` + `UNLINK` on `{namespace}:sdk-messaging:*`.
+ *
+ * TTL (`ttlMs`, default 7 days): the mark must outlive every window in which the same message
+ * can still be redelivered (retry ladder, consumer lag, routing holds, manual replays). It is
+ * sent to Redis in whole seconds, rounded up, minimum 1 (`SET key "1" EX n`, no `NX`: marking
+ * again renews the TTL).
+ *
+ * Timeouts (`timeoutMs`, default 5000): every operation is bounded by it; `fromUrl` also uses it
+ * as the connection timeout (`socket.connectTimeout`, overridable through the client options).
+ * A timeout or a Redis failure becomes {@link DedupUnavailableError}: the consumer treats a
+ * failed query as "not processed" and only logs a failed mark, so with Redis down the
+ * consumption goes on **without** deduplication (handlers must be idempotent).
+ *
+ * The dedup key (idempotency key / message id) may be PII: it never appears in error messages
+ * of this module (only namespace, group and operation).
+ */
+import { createClient, } from 'redis';
+import { DedupUnavailableError } from '../errors.js';
+import * as naming from '../naming.js';
+import { formatSeconds } from '../util.js';
+export { DedupUnavailableError } from '../errors.js';
+const KEY_SEGMENT = 'sdk-messaging:dedup';
+/** Default TTL of a mark: 7 days. */
+export const DEFAULT_TTL_MS = 604_800_000;
+/** Default timeout of each Redis operation (and of the connection created by `fromUrl`). */
+export const DEFAULT_TIMEOUT_MS = 5000;
+/** Fixed text (§8.2, same as Python): the URL never appears in the error, it may carry the password. */
+const INVALID_URL_MESSAGE = 'invalid Redis URL: expected redis[s]://[[user]:password@]host[:port][/db] or unix://;' +
+    ' percent-encode reserved characters (/ # ? @ :) in the password' +
+    ' (the URL is not shown: it may contain a password)';
+function requirePositiveFinite(value, field) {
+    if (typeof value !== 'number') {
+        throw new TypeError(`'${field}' must be a number; got ${String(value)}`);
+    }
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new RangeError(`'${field}' must be finite and > 0; got ${String(value)}`);
+    }
+    return value;
+}
+/** `Error` class name (node-redis errors do not all set `name`), never the message. */
+function errorClassName(error) {
+    if (error instanceof Error) {
+        const ctor = error.constructor;
+        const name = typeof ctor?.name === 'string' && ctor.name !== '' ? ctor.name : error.name;
+        return name || 'Error';
+    }
+    return 'Error';
+}
+const TIMED_OUT = Symbol('timed out');
+/** Module-private members shared by the store and its checkers. */
+const CALL = Symbol('call');
+const TTL_SECONDS = Symbol('ttlSeconds');
+/**
+ * Owner of the configuration (namespace, TTL, timeout) and of the Redis client. One store per
+ * process/system; one {@link RedisDuplicateChecker} per consumer group (`checker(group)`), all
+ * sharing the same client.
+ */
+export class RedisDedupStore {
+    #client;
+    #owned = null;
+    #namespace;
+    #ttlMs;
+    #ttlSeconds;
+    #timeoutMs;
+    #connecting = null;
+    #closed = false;
+    /**
+     * Wraps a client owned by the caller: `close()` does not close it and the store never connects
+     * it (connect it before use).
+     */
+    constructor(client, options) {
+        this.#namespace = naming.dedupNamespace(options.namespace);
+        this.#ttlMs = requirePositiveFinite(options.ttlMs ?? DEFAULT_TTL_MS, 'ttl_ms');
+        this.#timeoutMs = requirePositiveFinite(options.timeoutMs ?? DEFAULT_TIMEOUT_MS, 'timeout_ms');
+        this.#ttlSeconds = Math.max(1, Math.ceil(this.#ttlMs / 1000));
+        this.#client = client;
+    }
+    /**
+     * Creates a node-redis client for `url` (lazy: it connects on the first operation) and owns it:
+     * `close()` closes it. `socket.connectTimeout` defaults to `timeoutMs`; the remaining options
+     * are passed to `createClient` and override the defaults.
+     */
+    static fromUrl(url, options) {
+        // Never let node-redis' own error escape: WHATWG URL errors carry the whole URL (`input`).
+        const { namespace, ttlMs, timeoutMs, ...redisOptions } = options;
+        // Validate before creating the client (no leaked client on error).
+        naming.dedupNamespace(namespace);
+        requirePositiveFinite(ttlMs ?? DEFAULT_TTL_MS, 'ttl_ms');
+        const timeout = requirePositiveFinite(timeoutMs ?? DEFAULT_TIMEOUT_MS, 'timeout_ms');
+        const socket = { connectTimeout: timeout, ...(redisOptions.socket ?? {}) };
+        let client;
+        try {
+            client = createClient({ ...redisOptions, url, socket });
+        }
+        catch {
+            // Rethrown below as a new error without `cause`: the original may quote the URL (password).
+        }
+        if (client === undefined)
+            throw new TypeError(INVALID_URL_MESSAGE);
+        // node-redis emits 'error' on every failed (re)connection attempt; without a listener the
+        // EventEmitter would crash the process. Failures surface as DedupUnavailableError instead.
+        client.on('error', () => { });
+        const store = new RedisDedupStore(client, {
+            namespace,
+            ...(ttlMs === undefined ? {} : { ttlMs }),
+            timeoutMs: timeout,
+        });
+        store.#owned = client;
+        return store;
+    }
+    get namespace() {
+        return this.#namespace;
+    }
+    get ttlMs() {
+        return this.#ttlMs;
+    }
+    get timeoutMs() {
+        return this.#timeoutMs;
+    }
+    /** Checker of the consumer group `group` (validated by `naming.consumerGroup`). */
+    checker(group) {
+        return new RedisDuplicateChecker(this, naming.consumerGroup(group));
+    }
+    /** Health check bounded by `timeoutMs`. Never throws: failure → `false`. */
+    async ping() {
+        try {
+            await this.#bounded(() => this.#client.ping());
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Closes the client only if it was created by {@link fromUrl}. Idempotent. */
+    async close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        const owned = this.#owned;
+        if (owned === null || !owned.isOpen)
+            return;
+        if (!owned.isReady) {
+            // Still (re)connecting: nothing to flush; reject the offline queue right away.
+            owned.destroy();
+            return;
+        }
+        let timer;
+        const timedOut = new Promise((resolve) => {
+            timer = setTimeout(() => resolve(TIMED_OUT), this.#timeoutMs);
+        });
+        try {
+            // Graceful close waits for the pending replies; bounded, then forced.
+            if ((await Promise.race([owned.close(), timedOut])) === TIMED_OUT && owned.isOpen)
+                owned.destroy();
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /** Runs a Redis command for a checker (timeout + error wrapping). */
+    async [CALL](operation, group, command) {
+        try {
+            return await this.#bounded(() => command(this.#client));
+        }
+        catch (error) {
+            const reason = error === TIMED_OUT ? `timed out after ${formatSeconds(this.#timeoutMs)}s` : errorClassName(error);
+            throw new DedupUnavailableError(operation, this.#namespace, group, reason, {
+                ...(error === TIMED_OUT ? {} : { cause: error }),
+            });
+        }
+    }
+    /** TTL sent to Redis (`EX`): whole seconds, rounded up, minimum 1. */
+    get [TTL_SECONDS]() {
+        return this.#ttlSeconds;
+    }
+    /** Runs `fn` (after the lazy connection of an owned client) within `timeoutMs`. */
+    async #bounded(fn) {
+        let expired = false;
+        let timer;
+        const timeout = new Promise((_, reject) => {
+            timer = setTimeout(() => {
+                expired = true;
+                reject(TIMED_OUT);
+            }, this.#timeoutMs);
+        });
+        const run = (async () => {
+            await this.#ensureConnected();
+            // A command issued after the deadline would only pile up in the offline queue.
+            if (expired)
+                throw TIMED_OUT;
+            return fn();
+        })();
+        run.catch(() => { }); // a late rejection after the timeout won the race is not "unhandled"
+        try {
+            return await Promise.race([run, timeout]);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    #ensureConnected() {
+        const owned = this.#owned;
+        if (owned === null || this.#closed || owned.isOpen)
+            return this.#connecting ?? Promise.resolve();
+        // Not open: first use, or a previous attempt gave up (custom reconnectStrategy).
+        const connecting = owned.connect().then(() => undefined, (error) => {
+            if (this.#connecting === connecting)
+                this.#connecting = null;
+            throw error;
+        });
+        connecting.catch(() => { });
+        this.#connecting = connecting;
+        return connecting;
+    }
+}
+/**
+ * {@link DuplicateChecker} of one group, created by {@link RedisDedupStore.checker}.
+ *
+ * - `isProcessed`: `EXISTS` of the key.
+ * - `markProcessed`: `SET key "1" EX ttl`. Plain SET (no `NX`): a new mark overwrites and renews
+ *   the TTL. Safe because the consumer only marks after the handler **succeeded**.
+ */
+export class RedisDuplicateChecker {
+    #store;
+    #group;
+    #prefix;
+    constructor(store, group) {
+        this.#store = store;
+        this.#group = naming.consumerGroup(group);
+        this.#prefix = `${store.namespace}:${KEY_SEGMENT}:${this.#group}:`;
+    }
+    get group() {
+        return this.#group;
+    }
+    get namespace() {
+        return this.#store.namespace;
+    }
+    /** Redis key of `dedupKey`: `{namespace}:sdk-messaging:dedup:{group}:{dedupKey}`. */
+    keyFor(dedupKey) {
+        return this.#prefix + dedupKey;
+    }
+    async isProcessed(key) {
+        const count = await this.#store[CALL]('is_processed', this.#group, (client) => client.exists(this.keyFor(key)));
+        return Number(count) > 0;
+    }
+    async markProcessed(key) {
+        const ttl = this.#store[TTL_SECONDS];
+        await this.#store[CALL]('mark_processed', this.#group, (client) => client.set(this.keyFor(key), '1', { expiration: { type: 'EX', value: ttl } }));
+    }
+    toString() {
+        return `RedisDuplicateChecker(namespace=${this.namespace}, group=${this.#group})`;
+    }
+}
+//# sourceMappingURL=redis.js.map

package/dist/integrations/redis.js.map

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