@zentto/platform-client 0.1.0 → 0.3.0

package/dist/events/client.d.ts

@@ -0,0 +1,94 @@
+/**
+ * EventBusClient — producer + consumer de eventos Zentto sobre Kafka.
+ *
+ * `kafkajs` es una dependencia OPCIONAL. El paquete es zero-deps para callers
+ * que no usan eventos. Si un caller importa este submódulo sin kafkajs
+ * instalado, el constructor lanza con un mensaje claro.
+ *
+ * Uso:
+ *   import { EventBusClient } from "@zentto/platform-client/events";
+ *
+ *   const bus = new EventBusClient({
+ *     brokers: ["kafka:9092"],
+ *     source: "zentto-hotel",
+ *     tenantCode: "ACME",
+ *   });
+ *
+ *   // Producer
+ *   await bus.connect();
+ *   await bus.publish({ eventType: "hotel.reservation.confirmed", data: {...} });
+ *
+ *   // Consumer (otro proceso)
+ *   bus.on("crm.lead.created", async (evt) => { ... });
+ *   bus.on(/crm\..+/, async (evt) => { ... });
+ *   await bus.start();
+ */
+import { type EventEnvelope } from "./envelope.js";
+export interface EventBusConfig {
+    brokers: string[];
+    source: string;
+    /** TenantCode por default para `publish`. Override por-llamada con `.publish({ tenantCode })`. */
+    tenantCode: string;
+    clientId?: string;
+    groupId?: string;
+    /** Log level: default "warn". */
+    logLevel?: "debug" | "info" | "warn" | "error" | "nothing";
+    /** Dedup por eventId. Default: en memoria con TTL 10min. */
+    dedup?: EventDedup;
+    onError?: (err: Error, ctx: {
+        where: string;
+        topic?: string;
+        eventId?: string;
+    }) => void;
+}
+export interface EventDedup {
+    seen(eventId: string): Promise<boolean>;
+    mark(eventId: string): Promise<void>;
+}
+type Handler = (evt: EventEnvelope, raw: {
+    topic: string;
+    partition: number;
+    offset: string;
+}) => Promise<void> | void;
+export declare class EventBusClient {
+    private readonly cfg;
+    private readonly subs;
+    private producer;
+    private consumer;
+    private started;
+    private connected;
+    constructor(cfg: EventBusConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    publish<T>(params: {
+        eventType: string;
+        data: T;
+        tenantCode?: string;
+        tenantId?: number;
+        correlationId?: string;
+        version?: number;
+        eventId?: string;
+    }): Promise<EventEnvelope<T>>;
+    on(pattern: string | RegExp, handler: Handler): void;
+    start(opts?: {
+        fromBeginning?: boolean;
+        topics?: (string | RegExp)[];
+    }): Promise<void>;
+}
+export declare class InMemoryDedup implements EventDedup {
+    private readonly ttlMs;
+    private readonly seenAt;
+    constructor(ttlMs?: number);
+    seen(eventId: string): Promise<boolean>;
+    mark(eventId: string): Promise<void>;
+    private sweep;
+}
+/**
+ * Factory desde env vars:
+ *   KAFKA_BROKERS — CSV (obligatoria)
+ *   ZENTTO_SERVICE_NAME — source (obligatoria)
+ *   ZENTTO_TENANT_CODE — tenantCode default
+ */
+export declare function eventsFromEnv(overrides?: Partial<EventBusConfig>): EventBusClient;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/events/client.d.ts.map

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

package/dist/events/client.js

@@ -0,0 +1,208 @@
+/**
+ * EventBusClient — producer + consumer de eventos Zentto sobre Kafka.
+ *
+ * `kafkajs` es una dependencia OPCIONAL. El paquete es zero-deps para callers
+ * que no usan eventos. Si un caller importa este submódulo sin kafkajs
+ * instalado, el constructor lanza con un mensaje claro.
+ *
+ * Uso:
+ *   import { EventBusClient } from "@zentto/platform-client/events";
+ *
+ *   const bus = new EventBusClient({
+ *     brokers: ["kafka:9092"],
+ *     source: "zentto-hotel",
+ *     tenantCode: "ACME",
+ *   });
+ *
+ *   // Producer
+ *   await bus.connect();
+ *   await bus.publish({ eventType: "hotel.reservation.confirmed", data: {...} });
+ *
+ *   // Consumer (otro proceso)
+ *   bus.on("crm.lead.created", async (evt) => { ... });
+ *   bus.on(/crm\..+/, async (evt) => { ... });
+ *   await bus.start();
+ */
+import { buildEnvelope, topicName } from "./envelope.js";
+export class EventBusClient {
+    cfg;
+    subs = [];
+    producer;
+    consumer;
+    started = false;
+    connected = false;
+    constructor(cfg) {
+        this.cfg = {
+            clientId: `zentto-${cfg.source}-${process.pid}`,
+            groupId: `zentto-${cfg.source}`,
+            logLevel: "warn",
+            dedup: new InMemoryDedup(),
+            onError: () => { },
+            ...cfg,
+        };
+    }
+    // ── Lifecycle ────────────────────────────────────────────────────────────
+    async connect() {
+        if (this.connected)
+            return;
+        const { Kafka } = await loadKafka();
+        const kafka = new Kafka({
+            clientId: this.cfg.clientId,
+            brokers: this.cfg.brokers,
+            logLevel: mapLogLevel(this.cfg.logLevel),
+            retry: { initialRetryTime: 2000, retries: 5 },
+        });
+        this.producer = kafka.producer({ idempotent: true, maxInFlightRequests: 1 });
+        this.consumer = kafka.consumer({ groupId: this.cfg.groupId });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        await this.producer.connect();
+        this.connected = true;
+    }
+    async disconnect() {
+        if (!this.connected)
+            return;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        if (this.producer)
+            await this.producer.disconnect().catch(() => { });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        if (this.consumer && this.started)
+            await this.consumer.disconnect().catch(() => { });
+        this.connected = false;
+        this.started = false;
+    }
+    // ── Producer ─────────────────────────────────────────────────────────────
+    async publish(params) {
+        if (!this.connected)
+            await this.connect();
+        const tenantCode = (params.tenantCode ?? this.cfg.tenantCode).toUpperCase();
+        const envelope = buildEnvelope({
+            eventType: params.eventType,
+            tenantCode,
+            tenantId: params.tenantId,
+            source: this.cfg.source,
+            data: params.data,
+            version: params.version,
+            correlationId: params.correlationId,
+            eventId: params.eventId,
+        });
+        const topic = topicName(tenantCode, params.eventType);
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            await this.producer.send({
+                topic,
+                messages: [{ key: tenantCode, value: JSON.stringify(envelope) }],
+            });
+        }
+        catch (err) {
+            this.cfg.onError(err, { where: "publish", topic, eventId: envelope.eventId });
+            throw err;
+        }
+        return envelope;
+    }
+    // ── Consumer ─────────────────────────────────────────────────────────────
+    on(pattern, handler) {
+        this.subs.push({ pattern, handler });
+    }
+    async start(opts) {
+        if (this.started)
+            return;
+        if (!this.connected)
+            await this.connect();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const consumer = this.consumer;
+        await consumer.connect();
+        const topics = opts?.topics ?? [/^zentto\..+/];
+        for (const t of topics) {
+            await consumer.subscribe({ topic: t, fromBeginning: opts?.fromBeginning ?? false });
+        }
+        await consumer.run({
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            eachMessage: async ({ topic, partition, message }) => {
+                const raw = message.value?.toString("utf-8");
+                if (!raw)
+                    return;
+                let envelope;
+                try {
+                    envelope = JSON.parse(raw);
+                }
+                catch (err) {
+                    this.cfg.onError(err, { where: "decode", topic });
+                    return;
+                }
+                // Dedup
+                if (await this.cfg.dedup.seen(envelope.eventId))
+                    return;
+                await this.cfg.dedup.mark(envelope.eventId);
+                // Dispatch a handlers que matcheen el eventType o el topic
+                for (const sub of this.subs) {
+                    const ok = typeof sub.pattern === "string"
+                        ? envelope.eventType === sub.pattern || topic === sub.pattern
+                        : sub.pattern.test(envelope.eventType) || sub.pattern.test(topic);
+                    if (!ok)
+                        continue;
+                    try {
+                        await sub.handler(envelope, { topic, partition, offset: message.offset });
+                    }
+                    catch (err) {
+                        this.cfg.onError(err, { where: "handler", topic, eventId: envelope.eventId });
+                    }
+                }
+            },
+        });
+        this.started = true;
+    }
+}
+// ── Dedup in-memory (default) ───────────────────────────────────────────────
+export class InMemoryDedup {
+    ttlMs;
+    seenAt = new Map();
+    constructor(ttlMs = 10 * 60 * 1000) {
+        this.ttlMs = ttlMs;
+    }
+    async seen(eventId) {
+        this.sweep();
+        return this.seenAt.has(eventId);
+    }
+    async mark(eventId) {
+        this.seenAt.set(eventId, Date.now());
+    }
+    sweep() {
+        const cutoff = Date.now() - this.ttlMs;
+        for (const [k, t] of this.seenAt) {
+            if (t < cutoff)
+                this.seenAt.delete(k);
+        }
+    }
+}
+// ── Kafka loading (optional dep) ────────────────────────────────────────────
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function loadKafka() {
+    try {
+        // optional peer dep — resolve dinámico para no requerir tipos/install.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const mod = await import(/* @vite-ignore */ "kafkajs");
+        return { Kafka: mod.Kafka };
+    }
+    catch (err) {
+        throw new Error("EventBusClient requires `kafkajs` to be installed.\n" +
+            "Run: npm install kafkajs\n" +
+            "(kafkajs es una optional dependency de @zentto/platform-client — se carga solo si importás el submódulo /events)");
+    }
+}
+function mapLogLevel(l) {
+    // kafkajs logLevel: NOTHING=0, ERROR=1, WARN=2, INFO=4, DEBUG=5
+    return { nothing: 0, error: 1, warn: 2, info: 4, debug: 5 }[l] ?? 2;
+}
+/**
+ * Factory desde env vars:
+ *   KAFKA_BROKERS — CSV (obligatoria)
+ *   ZENTTO_SERVICE_NAME — source (obligatoria)
+ *   ZENTTO_TENANT_CODE — tenantCode default
+ */
+export function eventsFromEnv(overrides) {
+    const brokers = (process.env.KAFKA_BROKERS ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+    const source = process.env.ZENTTO_SERVICE_NAME ?? "unknown-service";
+    const tenantCode = process.env.ZENTTO_TENANT_CODE ?? "ZENTTO";
+    return new EventBusClient({ brokers, source, tenantCode, ...overrides });
+}
+//# sourceMappingURL=client.js.map

package/dist/events/client.js.map

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

package/dist/events/envelope.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Envelope estándar para eventos del bus Zentto.
+ * Ver docs/wiki/15-event-bus.md en zentto-web.
+ */
+export interface EventEnvelope<T = unknown> {
+    eventId: string;
+    eventType: string;
+    tenantCode: string;
+    tenantId?: number;
+    timestamp: string;
+    source: string;
+    correlationId?: string;
+    data: T;
+    version: number;
+}
+export declare function buildEnvelope<T>(params: {
+    eventType: string;
+    tenantCode: string;
+    tenantId?: number;
+    source: string;
+    data: T;
+    version?: number;
+    correlationId?: string;
+    eventId?: string;
+    timestamp?: string;
+}): EventEnvelope<T>;
+export declare function topicName(tenantCode: string, eventType: string): string;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/events/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/events/envelope.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,MAAM,CAAC;CACjB;AAkBD,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,aAAa,CAAC,CAAC,CAAC,CAYnB;AAED,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvE"}

package/dist/events/envelope.js

@@ -0,0 +1,38 @@
+/**
+ * Envelope estándar para eventos del bus Zentto.
+ * Ver docs/wiki/15-event-bus.md en zentto-web.
+ */
+function uuid() {
+    // RFC 4122 v4 — sin dependencias
+    const bytes = new Uint8Array(16);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const g = globalThis;
+    if (g.crypto?.getRandomValues) {
+        g.crypto.getRandomValues(bytes);
+    }
+    else {
+        for (let i = 0; i < 16; i++)
+            bytes[i] = Math.floor(Math.random() * 256);
+    }
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+export function buildEnvelope(params) {
+    return {
+        eventId: params.eventId ?? `evt_${uuid()}`,
+        eventType: params.eventType,
+        tenantCode: params.tenantCode.toUpperCase(),
+        tenantId: params.tenantId,
+        timestamp: params.timestamp ?? new Date().toISOString(),
+        source: params.source,
+        correlationId: params.correlationId,
+        data: params.data,
+        version: params.version ?? 1,
+    };
+}
+export function topicName(tenantCode, eventType) {
+    return `zentto.${tenantCode.toLowerCase()}.${eventType}`;
+}
+//# sourceMappingURL=envelope.js.map

package/dist/events/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/events/envelope.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,SAAS,IAAI;IACX,iCAAiC;IACjC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACjC,8DAA8D;IAC9D,MAAM,CAAC,GAAQ,UAAiB,CAAC;IACjC,IAAI,CAAC,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;QAC9B,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;YAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IAC1E,CAAC;IACD,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/E,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7G,CAAC;AAED,MAAM,UAAU,aAAa,CAAI,MAUhC;IACC,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO,IAAI,EAAE,EAAE;QAC1C,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE;QAC3C,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACvD,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,UAAkB,EAAE,SAAiB;IAC7D,OAAO,UAAU,UAAU,CAAC,WAAW,EAAE,IAAI,SAAS,EAAE,CAAC;AAC3D,CAAC"}

package/dist/events/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./envelope.js";
+export * from "./client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/events/index.js

@@ -0,0 +1,3 @@
+export * from "./envelope.js";
+export * from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,7 @@
 export * as notify from "./notify/index.js";
+export * as auth from "./auth/index.js";
+export * as cache from "./cache/index.js";
+export * as landing from "./landing/index.js";
+export * as events from "./events/index.js";
+export * from "./internal/errors.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAG5C,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,8 +1,11 @@
-// Barrel del platform-client. Cada submódulo expone su propia API; acá
-// re-exportamos en namespaces para llamadas tipo `platform.notify.email.send(...)`.
+// Barrel de @zentto/platform-client. Un submódulo por servicio de plataforma.
+// Uso: `import { notify } from "@zentto/platform-client"` o import directo
+// del subpath `@zentto/platform-client/notify`.
 export * as notify from "./notify/index.js";
-// Placeholders — se llenan cuando se migren cache/auth/landing al mismo patrón.
-// export * as cache from "./cache/index.js";
-// export * as auth from "./auth/index.js";
-// export * as landing from "./landing/index.js";
+export * as auth from "./auth/index.js";
+export * as cache from "./cache/index.js";
+export * as landing from "./landing/index.js";
+export * as events from "./events/index.js";
+// Tipos de error compartidos (útiles para `instanceof` en callers).
+export * from "./internal/errors.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,oFAAoF;AAEpF,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,gFAAgF;AAChF,6CAA6C;AAC7C,2CAA2C;AAC3C,iDAAiD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2EAA2E;AAC3E,gDAAgD;AAEhD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,oEAAoE;AACpE,cAAc,sBAAsB,CAAC"}

package/dist/internal/circuit.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Circuit breaker minimal — un breaker por (baseUrl, path-prefix).
+ *
+ * Estados:
+ *   closed  → pasa tráfico. Cuenta fallos consecutivos.
+ *   open    → rechaza inmediato. Despeja tras cooldown.
+ *   half    → deja pasar 1 request de prueba. Si falla, vuelve a open.
+ *             Si pasa, vuelve a closed.
+ *
+ * Evita cascade failures cuando un servicio upstream se cae.
+ */
+export interface CircuitOptions {
+    /** Fallos consecutivos antes de abrir. Default 5. */
+    failureThreshold?: number;
+    /** Tiempo en open antes de probar half. Default 30s. */
+    cooldownMs?: number;
+}
+type State = "closed" | "open" | "half";
+export declare class CircuitBreaker {
+    private readonly failureThreshold;
+    private readonly cooldownMs;
+    private readonly slots;
+    constructor(opts?: CircuitOptions);
+    private slot;
+    /** Llamado antes de disparar un request. Retorna false si el circuito está abierto. */
+    allow(key: string): boolean;
+    recordSuccess(key: string): void;
+    recordFailure(key: string): void;
+    /** Sólo para tests/debug. */
+    _state(key: string): State;
+}
+export {};
+//# sourceMappingURL=circuit.d.ts.map

package/dist/internal/circuit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit.d.ts","sourceRoot":"","sources":["../../src/internal/circuit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AASxC,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;gBAErC,IAAI,GAAE,cAAmB;IAKrC,OAAO,CAAC,IAAI;IASZ,uFAAuF;IACvF,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAiB3B,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOhC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAehC,6BAA6B;IAC7B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK;CAG3B"}

package/dist/internal/circuit.js

@@ -0,0 +1,73 @@
+/**
+ * Circuit breaker minimal — un breaker por (baseUrl, path-prefix).
+ *
+ * Estados:
+ *   closed  → pasa tráfico. Cuenta fallos consecutivos.
+ *   open    → rechaza inmediato. Despeja tras cooldown.
+ *   half    → deja pasar 1 request de prueba. Si falla, vuelve a open.
+ *             Si pasa, vuelve a closed.
+ *
+ * Evita cascade failures cuando un servicio upstream se cae.
+ */
+export class CircuitBreaker {
+    failureThreshold;
+    cooldownMs;
+    slots = new Map();
+    constructor(opts = {}) {
+        this.failureThreshold = Math.max(1, opts.failureThreshold ?? 5);
+        this.cooldownMs = Math.max(1000, opts.cooldownMs ?? 30_000);
+    }
+    slot(key) {
+        let s = this.slots.get(key);
+        if (!s) {
+            s = { state: "closed", consecutiveFailures: 0, openedAt: 0, halfInFlight: false };
+            this.slots.set(key, s);
+        }
+        return s;
+    }
+    /** Llamado antes de disparar un request. Retorna false si el circuito está abierto. */
+    allow(key) {
+        const s = this.slot(key);
+        if (s.state === "closed")
+            return true;
+        if (s.state === "open") {
+            if (Date.now() - s.openedAt >= this.cooldownMs) {
+                s.state = "half";
+                s.halfInFlight = false;
+            }
+            else {
+                return false;
+            }
+        }
+        // half: solo 1 in-flight a la vez
+        if (s.halfInFlight)
+            return false;
+        s.halfInFlight = true;
+        return true;
+    }
+    recordSuccess(key) {
+        const s = this.slot(key);
+        s.consecutiveFailures = 0;
+        s.halfInFlight = false;
+        s.state = "closed";
+    }
+    recordFailure(key) {
+        const s = this.slot(key);
+        s.consecutiveFailures++;
+        s.halfInFlight = false;
+        if (s.state === "half") {
+            s.state = "open";
+            s.openedAt = Date.now();
+            return;
+        }
+        if (s.consecutiveFailures >= this.failureThreshold) {
+            s.state = "open";
+            s.openedAt = Date.now();
+        }
+    }
+    /** Sólo para tests/debug. */
+    _state(key) {
+        return this.slot(key).state;
+    }
+}
+//# sourceMappingURL=circuit.js.map

package/dist/internal/circuit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit.js","sourceRoot":"","sources":["../../src/internal/circuit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAkBH,MAAM,OAAO,cAAc;IACR,gBAAgB,CAAS;IACzB,UAAU,CAAS;IACnB,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IAEjD,YAAY,OAAuB,EAAE;QACnC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,CAAC;IAC9D,CAAC;IAEO,IAAI,CAAC,GAAW;QACtB,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;YAClF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,uFAAuF;IACvF,KAAK,CAAC,GAAW;QACf,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACtC,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC/C,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC;gBACjB,CAAC,CAAC,YAAY,GAAG,KAAK,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,kCAAkC;QAClC,IAAI,CAAC,CAAC,YAAY;YAAE,OAAO,KAAK,CAAC;QACjC,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAC,GAAW;QACvB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAC1B,CAAC,CAAC,YAAY,GAAG,KAAK,CAAC;QACvB,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC;IACrB,CAAC;IAED,aAAa,CAAC,GAAW;QACvB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC,CAAC,mBAAmB,EAAE,CAAC;QACxB,CAAC,CAAC,YAAY,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YACvB,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC;YACjB,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,CAAC,mBAAmB,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACnD,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC;YACjB,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;IAC9B,CAAC;CACF"}

package/dist/internal/errors.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Jerarquía de errores tipados del SDK.
+ *
+ * El SDK NO lanza por default (mantiene shape best-effort `{ ok, error }`).
+ * Estos errores se usan:
+ *   a) En `result.errorInstance` para callers que quieran `instanceof`.
+ *   b) Opcionalmente en modo `throwOnError: true` (futuro).
+ *
+ * La jerarquía permite reaccionar fino:
+ *   if (err instanceof RateLimitedError) backoff();
+ *   if (err instanceof AuthError) redirectToLogin();
+ */
+export declare class PlatformError extends Error {
+    readonly status?: number;
+    readonly path?: string;
+    readonly attempt?: number;
+    constructor(message: string, opts?: {
+        status?: number;
+        path?: string;
+        attempt?: number;
+        cause?: unknown;
+    });
+}
+/** 4xx 401/403 — token inválido/expirado, scope faltante. */
+export declare class AuthError extends PlatformError {
+    constructor(message: string, opts?: ConstructorParameters<typeof PlatformError>[1]);
+}
+/** 4xx 400/422 — body mal formado, campos faltantes. */
+export declare class ValidationError extends PlatformError {
+    constructor(message: string, opts?: ConstructorParameters<typeof PlatformError>[1]);
+}
+/** 4xx 404 — recurso no existe. */
+export declare class NotFoundError extends PlatformError {
+    constructor(message: string, opts?: ConstructorParameters<typeof PlatformError>[1]);
+}
+/** 4xx 429 — rate limited upstream. */
+export declare class RateLimitedError extends PlatformError {
+    readonly retryAfterSec?: number;
+    constructor(message: string, opts?: ConstructorParameters<typeof PlatformError>[1] & {
+        retryAfterSec?: number;
+    });
+}
+/** 5xx — error del servicio upstream. Normalmente reintentable. */
+export declare class ServiceError extends PlatformError {
+    constructor(message: string, opts?: ConstructorParameters<typeof PlatformError>[1]);
+}
+/** Errores de red (timeout, DNS, connection reset). Reintentables. */
+export declare class NetworkError extends PlatformError {
+    constructor(message: string, opts?: ConstructorParameters<typeof PlatformError>[1]);
+}
+/** Circuit breaker abierto — upstream fallando demasiado. */
+export declare class CircuitOpenError extends PlatformError {
+    constructor(message: string, opts?: ConstructorParameters<typeof PlatformError>[1]);
+}
+/** Mapea HTTP status + contexto a un error tipado. */
+export declare function mapHttpError(status: number | undefined, body: Record<string, unknown>, path: string, attempt: number): PlatformError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/internal/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/internal/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAQ1G;AAED,6DAA6D;AAC7D,qBAAa,SAAU,SAAQ,aAAa;gBAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;CAInF;AAED,wDAAwD;AACxD,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;CAInF;AAED,mCAAmC;AACnC,qBAAa,aAAc,SAAQ,aAAa;gBAClC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;CAInF;AAED,uCAAuC;AACvC,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;gBACpB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE;CAKhH;AAED,mEAAmE;AACnE,qBAAa,YAAa,SAAQ,aAAa;gBACjC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;CAInF;AAED,sEAAsE;AACtE,qBAAa,YAAa,SAAQ,aAAa;gBACjC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;CAInF;AAED,6DAA6D;AAC7D,qBAAa,gBAAiB,SAAQ,aAAa;gBACrC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;CAInF;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAYpI"}