@zentto/platform-client 0.1.0 → 0.3.0

package/dist/internal/errors.js

@@ -0,0 +1,96 @@
+/**
+ * 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 class PlatformError extends Error {
+    status;
+    path;
+    attempt;
+    constructor(message, opts) {
+        super(message);
+        this.name = "PlatformError";
+        this.status = opts?.status;
+        this.path = opts?.path;
+        this.attempt = opts?.attempt;
+        if (opts?.cause !== undefined)
+            this.cause = opts.cause;
+    }
+}
+/** 4xx 401/403 — token inválido/expirado, scope faltante. */
+export class AuthError extends PlatformError {
+    constructor(message, opts) {
+        super(message, opts);
+        this.name = "AuthError";
+    }
+}
+/** 4xx 400/422 — body mal formado, campos faltantes. */
+export class ValidationError extends PlatformError {
+    constructor(message, opts) {
+        super(message, opts);
+        this.name = "ValidationError";
+    }
+}
+/** 4xx 404 — recurso no existe. */
+export class NotFoundError extends PlatformError {
+    constructor(message, opts) {
+        super(message, opts);
+        this.name = "NotFoundError";
+    }
+}
+/** 4xx 429 — rate limited upstream. */
+export class RateLimitedError extends PlatformError {
+    retryAfterSec;
+    constructor(message, opts) {
+        super(message, opts);
+        this.name = "RateLimitedError";
+        this.retryAfterSec = opts?.retryAfterSec;
+    }
+}
+/** 5xx — error del servicio upstream. Normalmente reintentable. */
+export class ServiceError extends PlatformError {
+    constructor(message, opts) {
+        super(message, opts);
+        this.name = "ServiceError";
+    }
+}
+/** Errores de red (timeout, DNS, connection reset). Reintentables. */
+export class NetworkError extends PlatformError {
+    constructor(message, opts) {
+        super(message, opts);
+        this.name = "NetworkError";
+    }
+}
+/** Circuit breaker abierto — upstream fallando demasiado. */
+export class CircuitOpenError extends PlatformError {
+    constructor(message, opts) {
+        super(message, opts);
+        this.name = "CircuitOpenError";
+    }
+}
+/** Mapea HTTP status + contexto a un error tipado. */
+export function mapHttpError(status, body, path, attempt) {
+    const msg = body.error ?? body.message ?? (status ? `HTTP ${status}` : "unknown error");
+    const opts = { status, path, attempt };
+    if (status === 401 || status === 403)
+        return new AuthError(msg, opts);
+    if (status === 404)
+        return new NotFoundError(msg, opts);
+    if (status === 429) {
+        const retryAfterSec = typeof body.retryAfter === "number" ? body.retryAfter : undefined;
+        return new RateLimitedError(msg, { ...opts, retryAfterSec });
+    }
+    if (status && status >= 400 && status < 500)
+        return new ValidationError(msg, opts);
+    if (status && status >= 500)
+        return new ServiceError(msg, opts);
+    return new NetworkError(msg, opts);
+}
+//# sourceMappingURL=errors.js.map

package/dist/internal/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/internal/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,MAAM,CAAU;IAChB,IAAI,CAAU;IACd,OAAO,CAAU;IAE1B,YAAY,OAAe,EAAE,IAA4E;QACvG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC;QAC7B,IAAI,IAAI,EAAE,KAAK,KAAK,SAAS;YAAG,IAAY,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAClE,CAAC;CACF;AAED,6DAA6D;AAC7D,MAAM,OAAO,SAAU,SAAQ,aAAa;IAC1C,YAAY,OAAe,EAAE,IAAqD;QAChF,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,wDAAwD;AACxD,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAChD,YAAY,OAAe,EAAE,IAAqD;QAChF,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,mCAAmC;AACnC,MAAM,OAAO,aAAc,SAAQ,aAAa;IAC9C,YAAY,OAAe,EAAE,IAAqD;QAChF,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,uCAAuC;AACvC,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IACxC,aAAa,CAAU;IAChC,YAAY,OAAe,EAAE,IAAkF;QAC7G,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,aAAa,GAAG,IAAI,EAAE,aAAa,CAAC;IAC3C,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,OAAO,YAAa,SAAQ,aAAa;IAC7C,YAAY,OAAe,EAAE,IAAqD;QAChF,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,sEAAsE;AACtE,MAAM,OAAO,YAAa,SAAQ,aAAa;IAC7C,YAAY,OAAe,EAAE,IAAqD;QAChF,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,6DAA6D;AAC7D,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IACjD,YAAY,OAAe,EAAE,IAAqD;QAChF,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAC,MAA0B,EAAE,IAA6B,EAAE,IAAY,EAAE,OAAe;IACnH,MAAM,GAAG,GAAI,IAAI,CAAC,KAAgB,IAAK,IAAI,CAAC,OAAkB,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,MAAM,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IAChH,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACvC,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtE,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,MAAM,aAAa,GAAG,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QACxF,OAAO,IAAI,gBAAgB,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,MAAM,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,IAAI,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnF,IAAI,MAAM,IAAI,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAChE,OAAO,IAAI,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/internal/http.d.ts

@@ -0,0 +1,59 @@
+/**
+ * HTTP helper compartido entre submódulos.
+ *
+ * Features:
+ *   - Retries con backoff exponencial ante errores de red o 5xx.
+ *   - Sin retry en 4xx (es error del caller).
+ *   - Timeout por request.
+ *   - Circuit breaker por (baseUrl): evita cascade cuando upstream cae.
+ *   - Errores tipados (AuthError, RateLimitedError, ServiceError, etc.) en `errorInstance`.
+ *   - Hook `beforeRetry` (ej. AuthClient lo usa para auto-refresh del JWT).
+ *   - No lanza: siempre retorna Result<T> (ok/error).
+ */
+import { CircuitBreaker, type CircuitOptions } from "./circuit.js";
+import { type PlatformError } from "./errors.js";
+export interface HttpConfig {
+    baseUrl: string;
+    timeoutMs: number;
+    retries: number;
+    onError: (err: Error, ctx: {
+        path: string;
+        attempt: number;
+    }) => void;
+    /** Opcional: permite al AuthClient interceptar 401 para refresh + retry. */
+    beforeRetry?: (err: PlatformError, ctx: {
+        path: string;
+        attempt: number;
+    }) => Promise<{
+        retry: boolean;
+        headers?: Record<string, string>;
+    }>;
+    /** Circuit breaker compartido entre requests del mismo cliente. */
+    breaker: CircuitBreaker;
+}
+export interface HttpResult<T = unknown> {
+    ok: boolean;
+    status?: number;
+    data?: T;
+    error?: string;
+    errorInstance?: PlatformError;
+}
+export interface RequestOptions {
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    path: string;
+    body?: object;
+    headers?: Record<string, string>;
+    query?: Record<string, string | number | undefined | null>;
+    credentials?: "include" | "omit";
+}
+export declare function httpRequest<T = unknown>(cfg: HttpConfig, opts: RequestOptions): Promise<HttpResult<T>>;
+export interface HttpConfigInput {
+    baseUrl: string;
+    timeoutMs?: number;
+    retries?: number;
+    onError?: HttpConfig["onError"];
+    circuit?: CircuitOptions;
+    beforeRetry?: HttpConfig["beforeRetry"];
+}
+export declare function defaultHttpConfig(overrides: HttpConfigInput): HttpConfig;
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/internal/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAgD,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/F,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACtE,4EAA4E;IAC5E,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC;IAC5I,mEAAmE;IACnE,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;IAC3D,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAClC;AAcD,wBAAsB,WAAW,CAAC,CAAC,GAAG,OAAO,EAC3C,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CA+DxB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,WAAW,CAAC,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC;CACzC;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,eAAe,GAAG,UAAU,CASxE"}

package/dist/internal/http.js

@@ -0,0 +1,95 @@
+/**
+ * HTTP helper compartido entre submódulos.
+ *
+ * Features:
+ *   - Retries con backoff exponencial ante errores de red o 5xx.
+ *   - Sin retry en 4xx (es error del caller).
+ *   - Timeout por request.
+ *   - Circuit breaker por (baseUrl): evita cascade cuando upstream cae.
+ *   - Errores tipados (AuthError, RateLimitedError, ServiceError, etc.) en `errorInstance`.
+ *   - Hook `beforeRetry` (ej. AuthClient lo usa para auto-refresh del JWT).
+ *   - No lanza: siempre retorna Result<T> (ok/error).
+ */
+import { CircuitBreaker } from "./circuit.js";
+import { CircuitOpenError, NetworkError, mapHttpError } from "./errors.js";
+function buildUrl(baseUrl, path, query) {
+    const url = `${baseUrl.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
+    if (!query)
+        return url;
+    const params = new URLSearchParams();
+    for (const [k, v] of Object.entries(query)) {
+        if (v === undefined || v === null)
+            continue;
+        params.set(k, String(v));
+    }
+    const qs = params.toString();
+    return qs ? `${url}?${qs}` : url;
+}
+export async function httpRequest(cfg, opts) {
+    const url = buildUrl(cfg.baseUrl, opts.path, opts.query);
+    const breakerKey = cfg.baseUrl;
+    if (!cfg.breaker.allow(breakerKey)) {
+        const err = new CircuitOpenError(`Circuit open for ${cfg.baseUrl}`, { path: opts.path, attempt: 0 });
+        cfg.onError(err, { path: opts.path, attempt: 0 });
+        return { ok: false, error: err.message, errorInstance: err };
+    }
+    let headers = { "Content-Type": "application/json", ...opts.headers };
+    let lastErr;
+    for (let attempt = 0; attempt <= cfg.retries; attempt++) {
+        try {
+            const res = await fetch(url, {
+                method: opts.method,
+                headers,
+                body: opts.body ? JSON.stringify(opts.body) : undefined,
+                credentials: opts.credentials,
+                signal: AbortSignal.timeout(cfg.timeoutMs),
+            });
+            const json = (await res.json().catch(() => ({})));
+            if (res.ok) {
+                cfg.breaker.recordSuccess(breakerKey);
+                return { ok: true, status: res.status, data: json };
+            }
+            const err = mapHttpError(res.status, json, opts.path, attempt);
+            lastErr = err;
+            // 4xx: sin retry por default. Pero beforeRetry puede pedir retry
+            // (ej. AuthClient refresca token y reintenta 401 una vez).
+            if (res.status >= 400 && res.status < 500) {
+                const shouldRetry = cfg.beforeRetry && attempt < cfg.retries
+                    ? await cfg.beforeRetry(err, { path: opts.path, attempt })
+                    : { retry: false };
+                if (!shouldRetry.retry) {
+                    // 4xx → NO toca el breaker (es error del caller, no del servicio).
+                    return { ok: false, status: res.status, error: err.message, errorInstance: err };
+                }
+                if (shouldRetry.headers)
+                    headers = { ...headers, ...shouldRetry.headers };
+                continue;
+            }
+            // 5xx → cuenta para el breaker
+            cfg.breaker.recordFailure(breakerKey);
+        }
+        catch (netErr) {
+            const err = new NetworkError(netErr.message, { path: opts.path, attempt, cause: netErr });
+            lastErr = err;
+            cfg.breaker.recordFailure(breakerKey);
+        }
+        if (attempt < cfg.retries) {
+            cfg.onError(lastErr, { path: opts.path, attempt });
+            await new Promise((r) => setTimeout(r, 250 * Math.pow(2, attempt)));
+        }
+    }
+    const err = lastErr ?? new NetworkError("unknown error", { path: opts.path, attempt: cfg.retries });
+    cfg.onError(err, { path: opts.path, attempt: cfg.retries });
+    return { ok: false, error: err.message, errorInstance: err };
+}
+export function defaultHttpConfig(overrides) {
+    return {
+        baseUrl: overrides.baseUrl,
+        timeoutMs: overrides.timeoutMs ?? 10_000,
+        retries: Math.max(0, overrides.retries ?? 1),
+        onError: overrides.onError ?? (() => { }),
+        beforeRetry: overrides.beforeRetry,
+        breaker: new CircuitBreaker(overrides.circuit ?? {}),
+    };
+}
+//# sourceMappingURL=http.js.map

package/dist/internal/http.js.map

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

package/dist/landing/client.d.ts

@@ -0,0 +1,50 @@
+/**
+ * LandingClient — cliente tipado para el endpoint público de leads del
+ * ERP Zentto (POST https://api.zentto.net/api/landing/register).
+ *
+ * Útil para sitios externos de tenants clientes (acme.com) que quieren
+ * integrar su formulario de contacto sin reescribir fetch a mano. Resuelve
+ * el tenant destino vía `X-Tenant-Key` emitido desde el CRM del cliente.
+ *
+ * Para el landing propio de Zentto (zentto.net), la Pages Function ya
+ * llama al ERP directamente — no necesita este cliente.
+ */
+import { type HttpConfig, type HttpResult } from "../internal/http.js";
+export interface LandingConfig {
+    baseUrl?: string;
+    /** Header `X-Tenant-Key` — PublicApiKey emitida desde el CRM del tenant. */
+    tenantKey?: string;
+    timeoutMs?: number;
+    retries?: number;
+    onError?: HttpConfig["onError"];
+}
+export interface RegisterLeadParams {
+    email: string;
+    name: string;
+    company?: string;
+    country?: string;
+    phone?: string;
+    source?: string;
+    topic?: string;
+    message?: string;
+}
+export interface RegisterLeadResponse {
+    ok: boolean;
+    mensaje?: string;
+    targetCompanyId?: number | null;
+    zentto_registered?: boolean;
+    paddle_customer_id?: string | null;
+}
+export declare class LandingClient {
+    private readonly cfg;
+    private readonly tenantKey?;
+    constructor(opts: LandingConfig);
+    registerLead(params: RegisterLeadParams): Promise<HttpResult<RegisterLeadResponse>>;
+}
+/**
+ * Factory desde env vars:
+ *   ZENTTO_API_URL — default https://api.zentto.net
+ *   ZENTTO_TENANT_KEY — PublicApiKey del tenant (si el caller es externo)
+ */
+export declare function landingFromEnv(overrides?: Partial<LandingConfig>): LandingClient;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/landing/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAkC,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEvG,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;gBAExB,IAAI,EAAE,aAAa;IAUzB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;CAQ1F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAMhF"}

package/dist/landing/client.js

@@ -0,0 +1,46 @@
+/**
+ * LandingClient — cliente tipado para el endpoint público de leads del
+ * ERP Zentto (POST https://api.zentto.net/api/landing/register).
+ *
+ * Útil para sitios externos de tenants clientes (acme.com) que quieren
+ * integrar su formulario de contacto sin reescribir fetch a mano. Resuelve
+ * el tenant destino vía `X-Tenant-Key` emitido desde el CRM del cliente.
+ *
+ * Para el landing propio de Zentto (zentto.net), la Pages Function ya
+ * llama al ERP directamente — no necesita este cliente.
+ */
+import { defaultHttpConfig, httpRequest } from "../internal/http.js";
+export class LandingClient {
+    cfg;
+    tenantKey;
+    constructor(opts) {
+        this.cfg = defaultHttpConfig({
+            baseUrl: opts.baseUrl ?? "https://api.zentto.net",
+            timeoutMs: opts.timeoutMs,
+            retries: opts.retries,
+            onError: opts.onError,
+        });
+        this.tenantKey = opts.tenantKey;
+    }
+    async registerLead(params) {
+        return httpRequest(this.cfg, {
+            method: "POST",
+            path: "/api/landing/register",
+            body: params,
+            headers: this.tenantKey ? { "X-Tenant-Key": this.tenantKey } : undefined,
+        });
+    }
+}
+/**
+ * Factory desde env vars:
+ *   ZENTTO_API_URL — default https://api.zentto.net
+ *   ZENTTO_TENANT_KEY — PublicApiKey del tenant (si el caller es externo)
+ */
+export function landingFromEnv(overrides) {
+    return new LandingClient({
+        baseUrl: process.env.ZENTTO_API_URL,
+        tenantKey: process.env.ZENTTO_TENANT_KEY,
+        ...overrides,
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/landing/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/landing/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAoC,MAAM,qBAAqB,CAAC;AA8BvG,MAAM,OAAO,aAAa;IACP,GAAG,CAAa;IAChB,SAAS,CAAU;IAEpC,YAAY,IAAmB;QAC7B,IAAI,CAAC,GAAG,GAAG,iBAAiB,CAAC;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,wBAAwB;YACjD,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,OAAO,WAAW,CAAuB,IAAI,CAAC,GAAG,EAAE;YACjD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,uBAAuB;YAC7B,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;SACzE,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,SAAkC;IAC/D,OAAO,IAAI,aAAa,CAAC;QACvB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;QACnC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;QACxC,GAAG,SAAS;KACb,CAAC,CAAC;AACL,CAAC"}

package/dist/landing/index.d.ts

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

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

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

package/dist/landing/index.js

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

package/dist/landing/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zentto/platform-client",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Cliente tipado para los servicios de plataforma Zentto (notify, cache, auth, landing). Uso oficial en ERP, verticals y sitios de tenants clientes.",
   "type": "module",
   "main": "dist/index.js",
@@ -13,8 +13,30 @@
     "./notify": {
       "types": "./dist/notify/index.d.ts",
       "import": "./dist/notify/index.js"
+    },
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "import": "./dist/auth/index.js"
+    },
+    "./cache": {
+      "types": "./dist/cache/index.d.ts",
+      "import": "./dist/cache/index.js"
+    },
+    "./landing": {
+      "types": "./dist/landing/index.d.ts",
+      "import": "./dist/landing/index.js"
+    },
+    "./events": {
+      "types": "./dist/events/index.d.ts",
+      "import": "./dist/events/index.js"
     }
   },
+  "peerDependenciesMeta": {
+    "kafkajs": { "optional": true }
+  },
+  "peerDependencies": {
+    "kafkajs": "^2.2.4"
+  },
   "files": [
     "dist",
     "README.md",
@@ -23,6 +45,8 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "clean": "rm -rf dist",
     "prepublishOnly": "npm run clean && npm run build"
   },
@@ -47,7 +71,8 @@
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
-    "typescript": "^5.7.0"
+    "typescript": "^5.7.0",
+    "vitest": "^3.2.4"
   },
   "engines": {
     "node": ">=20"