@central-ticket/queue-sdk 0.0.3 → 0.0.4

package/dist/centralq-I9tdL_Xr.d.ts

@@ -1,133 +0,0 @@
-interface CentralQOptions {
-    /** URL del queue worker. */
-    apiUrl?: string;
-    /** Publishable API key (ctq_pub_xxx) */
-    apiKey: string;
-    /** ID del evento/recurso a proteger */
-    eventId: string;
-    /** ID de usuario externo. Si no se provee, se autogenera y persiste en sessionStorage */
-    userId?: string;
-    /** Init token corto emitido por backend (recomendado para producción) */
-    queueInitToken?: string;
-    /** Intervalo de polling en ms (default: 10000) */
-    pollInterval?: number;
-    /** Contenedor donde montar el overlay. Default: document.body */
-    container?: HTMLElement;
-}
-interface CentralQClientOptions {
-    /** URL del queue worker */
-    apiUrl?: string;
-    /** Publishable API key (ctq_pub_xxx) */
-    apiKey: string;
-    /** ID de usuario externo por defecto para todas las colas creadas por el client */
-    userId?: string;
-    /** Init token corto por defecto para colas creadas por el client */
-    queueInitToken?: string;
-    /** Intervalo de polling por defecto en ms */
-    pollInterval?: number;
-    /** Contenedor por defecto donde montar el overlay */
-    container?: HTMLElement;
-}
-interface CentralQCreateOptions {
-    /** ID del evento/recurso a proteger */
-    eventId: string;
-    /** Override opcional del userId por cola */
-    userId?: string;
-    /** Override opcional del queue init token por cola */
-    queueInitToken?: string;
-    /** Override opcional del poll interval por cola */
-    pollInterval?: number;
-    /** Override opcional del contenedor por cola */
-    container?: HTMLElement;
-    /** Override opcional del apiUrl por cola */
-    apiUrl?: string;
-    /** Override opcional del apiKey por cola */
-    apiKey?: string;
-}
-interface PassedDetail {
-    token: string;
-    expiresAt: number;
-    userId: string;
-    eventId: string;
-}
-interface PositionDetail {
-    position: number;
-    ahead: number;
-    userId: string;
-    eventId: string;
-}
-interface ExpiredDetail {
-    userId: string;
-    eventId: string;
-}
-interface ErrorDetail {
-    userId: string;
-    eventId: string;
-}
-type EventMap = {
-    passed: PassedDetail;
-    expired: ExpiredDetail;
-    position: PositionDetail;
-    error: ErrorDetail;
-};
-type EventName = keyof EventMap;
-type Listener<T> = (detail: T) => void;
-type QueueStatus = "idle" | "joining" | "waiting" | "passed" | "expired" | "error";
-declare class CentralQ {
-    private client;
-    private element;
-    private userId;
-    private eventId;
-    private pollInterval;
-    private container;
-    private pollingTimer?;
-    private heartbeatTimer?;
-    private expiryTimer?;
-    private destroyed;
-    private listeners;
-    private constructor();
-    /**
-     * Inicializa CentralQ y comienza el flujo de cola automáticamente.
-     * Monta el overlay de UI y empieza a hacer polling.
-     */
-    static init(options: CentralQOptions): CentralQ;
-    /** Suscribirse a un evento del ciclo de vida de la cola */
-    on<K extends EventName>(event: K, listener: Listener<EventMap[K]>): this;
-    /** Desuscribirse de un evento */
-    off<K extends EventName>(event: K, listener: Listener<EventMap[K]>): this;
-    private emit;
-    /**
-     * Libera el slot del usuario inmediatamente.
-     * Llamar cuando el usuario completa la compra.
-     */
-    leave(): void;
-    /**
-     * Destruye la instancia: para todos los timers, desmonta el overlay,
-     * y libera el slot en el servidor.
-     */
-    destroy(): void;
-    /** Retorna el userId resuelto (externo o autogenerado) */
-    getUserId(): string;
-    private resolveUserId;
-    private mount;
-    private unmount;
-    private updateUI;
-    private stopTimers;
-    private startHeartbeat;
-    private scheduleExpiry;
-    private handleExpired;
-    private checkQueue;
-}
-declare class CentralQClient {
-    private defaults;
-    constructor(defaults: CentralQClientOptions);
-    issueQueueInitToken(eventId: string, userId?: string): Promise<{
-        userId: string;
-        queueInitToken: string;
-        expiresAt: number;
-    }>;
-    createQueue(options: CentralQCreateOptions): CentralQ;
-}
-declare function createCentralQClient(options: CentralQClientOptions): CentralQClient;
-
-export { CentralQ as C, type ErrorDetail as E, type PassedDetail as P, type QueueStatus as Q, CentralQClient as a, type CentralQClientOptions as b, type CentralQCreateOptions as c, type CentralQOptions as d, type ExpiredDetail as e, type PositionDetail as f, createCentralQClient as g };

package/dist/chunk-4MXU7S6A.mjs

@@ -1,235 +0,0 @@
-import {
-  CENTRALQ_DEFAULT_API_URL,
-  QueueHttpClient
-} from "./chunk-A37B25XO.mjs";
-
-// src/centralq.ts
-var CentralQ = class _CentralQ {
-  constructor(options) {
-    this.element = null;
-    this.destroyed = false;
-    // biome-ignore lint: allow explicit any for generic event map
-    this.listeners = /* @__PURE__ */ new Map();
-    this.client = new QueueHttpClient(
-      options.apiUrl,
-      options.apiKey,
-      options.queueInitToken
-    );
-    this.eventId = options.eventId;
-    this.pollInterval = options.pollInterval ?? 1e4;
-    this.container = options.container ?? document.body;
-    this.userId = this.resolveUserId(options.userId);
-  }
-  /**
-   * Inicializa CentralQ y comienza el flujo de cola automáticamente.
-   * Monta el overlay de UI y empieza a hacer polling.
-   */
-  static init(options) {
-    const instance = new _CentralQ(options);
-    instance.mount();
-    instance.checkQueue();
-    return instance;
-  }
-  // Event API
-  /** Suscribirse a un evento del ciclo de vida de la cola */
-  on(event, listener) {
-    if (!this.listeners.has(event)) {
-      this.listeners.set(event, /* @__PURE__ */ new Set());
-    }
-    this.listeners.get(event).add(listener);
-    return this;
-  }
-  /** Desuscribirse de un evento */
-  off(event, listener) {
-    this.listeners.get(event)?.delete(listener);
-    return this;
-  }
-  emit(event, detail) {
-    this.listeners.get(event)?.forEach((fn) => fn(detail));
-  }
-  // Métodos públicos
-  /**
-   * Libera el slot del usuario inmediatamente.
-   * Llamar cuando el usuario completa la compra.
-   */
-  leave() {
-    this.stopTimers();
-    this.updateUI("ACTIVE");
-    this.client.leaveQueue(this.eventId, this.userId).catch(() => {
-    });
-  }
-  /**
-   * Destruye la instancia: para todos los timers, desmonta el overlay,
-   * y libera el slot en el servidor.
-   */
-  destroy() {
-    this.destroyed = true;
-    this.stopTimers();
-    this.client.leaveQueue(this.eventId, this.userId).catch(() => {
-    });
-    this.unmount();
-    this.listeners.clear();
-  }
-  /** Retorna el userId resuelto (externo o autogenerado) */
-  getUserId() {
-    return this.userId;
-  }
-  // userId: genera y persiste automáticamente
-  resolveUserId(externalId) {
-    if (externalId) return externalId;
-    const key = `ctq_anon_${this.eventId}`;
-    try {
-      const stored = sessionStorage.getItem(key);
-      if (stored) return stored;
-    } catch {
-    }
-    const generated = `anon_${crypto.randomUUID()}`;
-    try {
-      sessionStorage.setItem(key, generated);
-    } catch {
-    }
-    return generated;
-  }
-  // UI: montar/desmontar el Web Component
-  mount() {
-    import("./queue-element-DXBW64U2.mjs");
-    this.element = document.createElement("central-q");
-    this.element.onRetry = () => {
-      this.updateUI("LOADING");
-      this.checkQueue();
-    };
-    this.container.appendChild(this.element);
-  }
-  unmount() {
-    if (this.element) {
-      this.element.remove();
-      this.element = null;
-    }
-  }
-  updateUI(status, data) {
-    if (!this.element) return;
-    this.element.status = status;
-    if (data?.position !== void 0) this.element.position = data.position;
-    if (data?.ahead !== void 0) this.element.ahead = data.ahead;
-  }
-  // Timers
-  stopTimers() {
-    if (this.pollingTimer) {
-      clearInterval(this.pollingTimer);
-      this.pollingTimer = void 0;
-    }
-    if (this.heartbeatTimer) {
-      clearInterval(this.heartbeatTimer);
-      this.heartbeatTimer = void 0;
-    }
-    if (this.expiryTimer) {
-      clearTimeout(this.expiryTimer);
-      this.expiryTimer = void 0;
-    }
-  }
-  startHeartbeat() {
-    if (this.heartbeatTimer) return;
-    this.heartbeatTimer = setInterval(() => {
-      this.client.sendHeartbeat(this.eventId, this.userId).catch(() => {
-      });
-    }, this.pollInterval);
-  }
-  scheduleExpiry(expiresAt) {
-    if (this.expiryTimer) clearTimeout(this.expiryTimer);
-    const msLeft = expiresAt * 1e3 - Date.now();
-    if (msLeft <= 0) {
-      this.handleExpired();
-      return;
-    }
-    this.expiryTimer = setTimeout(() => this.handleExpired(), msLeft);
-  }
-  handleExpired() {
-    this.stopTimers();
-    this.updateUI("EXPIRED");
-    this.emit("expired", {
-      userId: this.userId,
-      eventId: this.eventId
-    });
-  }
-  // Core: polling + join
-  async checkQueue() {
-    if (this.destroyed) return;
-    try {
-      const res = await this.client.joinQueue(this.eventId, this.userId);
-      if (res.status === "ACTIVE") {
-        if (this.pollingTimer) {
-          clearInterval(this.pollingTimer);
-          this.pollingTimer = void 0;
-        }
-        this.startHeartbeat();
-        this.scheduleExpiry(res.expiresAt);
-        this.updateUI("ACTIVE");
-        this.emit("passed", {
-          token: res.token,
-          expiresAt: res.expiresAt,
-          userId: this.userId,
-          eventId: this.eventId
-        });
-      } else if (res.status === "WAITING") {
-        this.updateUI("WAITING", {
-          position: res.position,
-          ahead: res.ahead
-        });
-        this.emit("position", {
-          position: res.position,
-          ahead: res.ahead,
-          userId: this.userId,
-          eventId: this.eventId
-        });
-        if (!this.pollingTimer) {
-          this.pollingTimer = setInterval(
-            () => this.checkQueue(),
-            this.pollInterval
-          );
-        }
-      }
-    } catch {
-      this.updateUI("ERROR");
-      this.stopTimers();
-      this.emit("error", {
-        userId: this.userId,
-        eventId: this.eventId
-      });
-    }
-  }
-};
-var CentralQClient = class {
-  constructor(defaults) {
-    this.defaults = defaults;
-  }
-  issueQueueInitToken(eventId, userId) {
-    const client = new QueueHttpClient(
-      this.defaults.apiUrl,
-      this.defaults.apiKey
-    );
-    return client.issueQueueInitToken(eventId, userId);
-  }
-  createQueue(options) {
-    return CentralQ.init({
-      apiUrl: options.apiUrl ?? this.defaults.apiUrl,
-      apiKey: options.apiKey ?? this.defaults.apiKey,
-      eventId: options.eventId,
-      userId: options.userId ?? this.defaults.userId,
-      queueInitToken: options.queueInitToken ?? this.defaults.queueInitToken,
-      pollInterval: options.pollInterval ?? this.defaults.pollInterval,
-      container: options.container ?? this.defaults.container
-    });
-  }
-};
-function createCentralQClient(options) {
-  return new CentralQClient({
-    ...options,
-    apiUrl: options.apiUrl ?? CENTRALQ_DEFAULT_API_URL
-  });
-}
-
-export {
-  CentralQ,
-  CentralQClient,
-  createCentralQClient
-};

package/dist/chunk-A37B25XO.mjs

@@ -1,126 +0,0 @@
-// src/queue-client.ts
-var CENTRALQ_DEFAULT_API_URL = "http://localhost:3001";
-function normalizeApiUrl(apiUrl) {
-  const trimmed = apiUrl.replace(/\/+$/, "");
-  return trimmed.endsWith("/api") ? trimmed.slice(0, -4) : trimmed;
-}
-var QueueHttpClient = class {
-  constructor(apiUrl = CENTRALQ_DEFAULT_API_URL, apiKey, queueInitToken) {
-    this.apiUrl = apiUrl;
-    this.apiKey = apiKey;
-    this.queueInitToken = queueInitToken;
-    this.apiUrl = normalizeApiUrl(this.apiUrl);
-  }
-  get headers() {
-    const h = { "Content-Type": "application/json" };
-    if (this.apiKey) h["x-api-key"] = this.apiKey;
-    if (this.queueInitToken) h["x-queue-init-token"] = this.queueInitToken;
-    return h;
-  }
-  /**
-   * Intenta unir a un usuario a la cola de un evento.
-   * Llama a POST /api/queue/:eventId/join en el worker.
-   */
-  async joinQueue(eventId, userId) {
-    const res = await fetch(
-      `${this.apiUrl}/api/queue/${encodeURIComponent(eventId)}/join`,
-      {
-        method: "POST",
-        headers: this.headers,
-        body: JSON.stringify({ userId })
-      }
-    );
-    if (!res.ok) {
-      const body = await res.json().catch(() => ({}));
-      throw new Error(
-        body.message ?? `Error ${res.status} al conectar con el sistema de colas`
-      );
-    }
-    return res.json();
-  }
-  /**
-   * Envía un heartbeat para mantener vivo el slot (waiting o active).
-   * El SDK lo llama cada 10s automáticamente.
-   */
-  async sendHeartbeat(eventId, userId) {
-    await fetch(
-      `${this.apiUrl}/api/queue/${encodeURIComponent(eventId)}/heartbeat`,
-      {
-        method: "POST",
-        headers: this.headers,
-        body: JSON.stringify({ userId })
-      }
-    );
-  }
-  /**
-   * Libera el slot del usuario inmediatamente.
-   * Llamar al completar la compra o al salir voluntariamente.
-   */
-  async leaveQueue(eventId, userId) {
-    await fetch(
-      `${this.apiUrl}/api/queue/${encodeURIComponent(eventId)}/leave`,
-      {
-        method: "POST",
-        headers: this.headers,
-        body: JSON.stringify({ userId })
-      }
-    );
-  }
-  async issueQueueInitToken(eventId, userId) {
-    const res = await fetch(
-      `${this.apiUrl}/api/queue/init/${encodeURIComponent(eventId)}`,
-      {
-        method: "POST",
-        headers: this.headers,
-        body: JSON.stringify({ userId })
-      }
-    );
-    const body = await res.json().catch(() => ({}));
-    if (!res.ok) {
-      throw new Error(
-        body.message ?? `Error ${res.status} al inicializar sesi\xF3n de cola`
-      );
-    }
-    const token = body.queueInitToken ?? body.initToken;
-    if (!body.userId || !token || !body.expiresAt) {
-      throw new Error("Respuesta inv\xE1lida al inicializar sesi\xF3n de cola");
-    }
-    return {
-      userId: body.userId,
-      queueInitToken: token,
-      expiresAt: body.expiresAt
-    };
-  }
-  async verifyToken(eventId, token) {
-    const res = await fetch(
-      `${this.apiUrl}/api/queue/verify/${encodeURIComponent(eventId)}`,
-      {
-        method: "POST",
-        headers: this.headers,
-        body: JSON.stringify({ token })
-      }
-    );
-    const body = await res.json().catch(() => ({
-      valid: false,
-      reason: "Respuesta inv\xE1lida"
-    }));
-    if (body.valid === true && body.userId && body.eventId && body.expiresAt) {
-      return body;
-    }
-    if (body.valid === false) {
-      return { valid: false, reason: body.reason ?? "Token inv\xE1lido" };
-    }
-    if (!res.ok) {
-      return {
-        valid: false,
-        reason: body.message ?? `Error ${res.status} al validar token de cola`
-      };
-    }
-    return { valid: false, reason: "Respuesta inv\xE1lida" };
-  }
-};
-
-export {
-  CENTRALQ_DEFAULT_API_URL,
-  QueueHttpClient
-};

package/dist/chunk-CURBGL7P.mjs

@@ -1,63 +0,0 @@
-import {
-  CENTRALQ_DEFAULT_API_URL
-} from "./chunk-P73Q2ZIO.mjs";
-
-// src/server.ts
-function normalizeApiUrl(apiUrl) {
-  return apiUrl.replace(/\/+$/, "");
-}
-async function postQueueServer(apiUrl, path, secretKey, body, fallback) {
-  const response = await fetch(`${normalizeApiUrl(apiUrl)}${path}`, {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      "x-api-key": secretKey
-    },
-    body: JSON.stringify(body)
-  });
-  const data = await response.json().catch(() => fallback);
-  return { status: response.status, data };
-}
-async function validateQueueTokenServer(options) {
-  const apiUrl = options.apiUrl ?? CENTRALQ_DEFAULT_API_URL;
-  return postQueueServer(
-    apiUrl,
-    `/api/queue/verify/${encodeURIComponent(options.eventId)}`,
-    options.secretKey,
-    { token: options.token },
-    { valid: false, reason: "Respuesta inv\xE1lida" }
-  );
-}
-async function verifyQueueAccessServer(options) {
-  const apiUrl = options.apiUrl ?? CENTRALQ_DEFAULT_API_URL;
-  return postQueueServer(
-    apiUrl,
-    `/api/queue/verify/${encodeURIComponent(options.eventId)}/access`,
-    options.secretKey,
-    { token: options.token ?? null },
-    {
-      allowed: false,
-      reason: "invalid_response",
-      message: "Respuesta inv\xE1lida"
-    }
-  );
-}
-async function completeQueueAccessServer(options) {
-  const apiUrl = options.apiUrl ?? CENTRALQ_DEFAULT_API_URL;
-  return postQueueServer(
-    apiUrl,
-    `/api/queue/verify/${encodeURIComponent(options.eventId)}/complete`,
-    options.secretKey,
-    {
-      token: options.token,
-      completionId: options.completionId
-    },
-    { completed: false, reason: "invalid_response" }
-  );
-}
-
-export {
-  validateQueueTokenServer,
-  verifyQueueAccessServer,
-  completeQueueAccessServer
-};

package/dist/chunk-GWPLLJTU.mjs

@@ -1,31 +0,0 @@
-import {
-  CENTRALQ_DEFAULT_API_URL
-} from "./chunk-A37B25XO.mjs";
-
-// src/server.ts
-function normalizeApiUrl(apiUrl) {
-  return apiUrl.replace(/\/+$/, "");
-}
-async function validateQueueTokenServer(options) {
-  const apiUrl = options.apiUrl ?? CENTRALQ_DEFAULT_API_URL;
-  const response = await fetch(
-    `${normalizeApiUrl(apiUrl)}/api/queue/verify/${encodeURIComponent(options.eventId)}`,
-    {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "x-api-key": options.secretKey
-      },
-      body: JSON.stringify({ token: options.token })
-    }
-  );
-  const data = await response.json().catch(() => ({
-    valid: false,
-    reason: "Respuesta inv\xE1lida"
-  }));
-  return { status: response.status, data };
-}
-
-export {
-  validateQueueTokenServer
-};

package/dist/chunk-JJ33EJ65.mjs

@@ -1,31 +0,0 @@
-import {
-  CENTRALQ_DEFAULT_API_URL
-} from "./chunk-P73Q2ZIO.mjs";
-
-// src/server.ts
-function normalizeApiUrl(apiUrl) {
-  return apiUrl.replace(/\/+$/, "");
-}
-async function validateQueueTokenServer(options) {
-  const apiUrl = options.apiUrl ?? CENTRALQ_DEFAULT_API_URL;
-  const response = await fetch(
-    `${normalizeApiUrl(apiUrl)}/api/queue/verify/${encodeURIComponent(options.eventId)}`,
-    {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "x-api-key": options.secretKey
-      },
-      body: JSON.stringify({ token: options.token })
-    }
-  );
-  const data = await response.json().catch(() => ({
-    valid: false,
-    reason: "Respuesta inv\xE1lida"
-  }));
-  return { status: response.status, data };
-}
-
-export {
-  validateQueueTokenServer
-};