@central-ticket/queue-sdk 0.0.2 → 0.0.4

package/dist/{centralq-C3ukDo0x.d.mts → centralq-CCw_Cqam.d.mts}

@@ -1,3 +1,90 @@
+type QueueJoinResponse = {
+    status: "ACTIVE";
+    token: string;
+    expiresAt: number;
+} | {
+    status: "WAITING";
+    position: number;
+    ahead: number;
+} | {
+    status: "PAUSED";
+    message: string;
+    retryAfterSeconds: number;
+} | {
+    status: "ERROR";
+    message: string;
+};
+interface QueueInitResponse {
+    userId: string;
+    queueInitToken: string;
+    expiresAt: number;
+}
+interface QueueBypassResponse {
+    status: "ACTIVE";
+    token: string;
+    expiresAt: number;
+    bypass: true;
+}
+type AdmissionMode = "PUBLIC" | "MANAGED" | "TRUSTED";
+interface QueueProtectionResponse {
+    eventId: string;
+    configured: boolean;
+    protected: boolean;
+    isActive: boolean;
+    isPaused: boolean;
+    admissionMode: AdmissionMode;
+    challengeRequired: boolean;
+}
+type AdmissionChallengeResponse = {
+    required: false;
+} | {
+    required: true;
+    publicKey: string;
+    appearance: "interaction-only";
+};
+type QueueVerifyResponse = {
+    valid: true;
+    userId: string;
+    eventId: string;
+    expiresAt: string;
+} | {
+    valid: false;
+    reason: string;
+};
+declare const CENTRALQ_DEFAULT_API_URL = "http://localhost:3001";
+/** @internal — HTTP client usado internamente por CentralQ */
+declare class QueueHttpClient {
+    apiUrl: string;
+    private apiKey?;
+    private queueInitToken?;
+    constructor(apiUrl?: string, apiKey?: string | undefined, queueInitToken?: string | undefined);
+    private get headers();
+    /**
+     * Intenta unir a un usuario a la cola de un evento.
+     * Llama a POST /api/queue/:eventId/join en el worker.
+     */
+    joinQueue(eventId: string, userId: string): Promise<QueueJoinResponse>;
+    /**
+     * Canjea un código de bypass por un token de acceso activo.
+     * El worker descuenta un uso únicamente cuando el canje es exitoso.
+     */
+    redeemBypassCode(eventId: string, code: string, userId?: string): Promise<QueueBypassResponse>;
+    /**
+     * Envía un heartbeat para mantener vivo el slot (waiting o active).
+     * El SDK lo llama cada 10s automáticamente.
+     */
+    sendHeartbeat(eventId: string, userId: string): Promise<void>;
+    /**
+     * Libera el slot del usuario inmediatamente.
+     * Llamar al completar la compra o al salir voluntariamente.
+     */
+    leaveQueue(eventId: string, userId: string): Promise<void>;
+    issueQueueInitToken(eventId: string, userId?: string, admissionProof?: string): Promise<QueueInitResponse>;
+    getProtection(eventId: string): Promise<QueueProtectionResponse>;
+    getAdmissionChallenge(eventId: string): Promise<AdmissionChallengeResponse>;
+    verifyToken(eventId: string, token: string): Promise<QueueVerifyResponse>;
+}
+
 interface CentralQOptions {
     /** URL del queue worker. */
     apiUrl?: string;
@@ -64,15 +151,22 @@ interface ErrorDetail {
     userId: string;
     eventId: string;
 }
+interface PausedDetail {
+    message: string;
+    retryAfterSeconds: number;
+    userId: string;
+    eventId: string;
+}
 type EventMap = {
     passed: PassedDetail;
     expired: ExpiredDetail;
     position: PositionDetail;
+    paused: PausedDetail;
     error: ErrorDetail;
 };
 type EventName = keyof EventMap;
 type Listener<T> = (detail: T) => void;
-type QueueStatus = "idle" | "joining" | "waiting" | "passed" | "expired" | "error";
+type QueueStatus = "idle" | "joining" | "waiting" | "paused" | "passed" | "expired" | "error";
 declare class CentralQ {
     private client;
     private element;
@@ -121,6 +215,7 @@ declare class CentralQ {
 declare class CentralQClient {
     private defaults;
     constructor(defaults: CentralQClientOptions);
+    redeemBypassCode(eventId: string, code: string, userId?: string): Promise<QueueBypassResponse>;
     issueQueueInitToken(eventId: string, userId?: string): Promise<{
         userId: string;
         queueInitToken: string;
@@ -131,4 +226,4 @@ declare class CentralQClient {
 }
 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 };
+export { type AdmissionChallengeResponse as A, CENTRALQ_DEFAULT_API_URL as C, type ErrorDetail as E, type PassedDetail as P, type QueueBypassResponse as Q, type AdmissionMode as a, CentralQ as b, CentralQClient as c, type CentralQClientOptions as d, type CentralQCreateOptions as e, type CentralQOptions as f, type ExpiredDetail as g, type PausedDetail as h, type PositionDetail as i, QueueHttpClient as j, type QueueJoinResponse as k, type QueueProtectionResponse as l, type QueueStatus as m, type QueueVerifyResponse as n, createCentralQClient as o };

package/dist/{centralq-C3ukDo0x.d.ts → centralq-CCw_Cqam.d.ts}

@@ -1,3 +1,90 @@
+type QueueJoinResponse = {
+    status: "ACTIVE";
+    token: string;
+    expiresAt: number;
+} | {
+    status: "WAITING";
+    position: number;
+    ahead: number;
+} | {
+    status: "PAUSED";
+    message: string;
+    retryAfterSeconds: number;
+} | {
+    status: "ERROR";
+    message: string;
+};
+interface QueueInitResponse {
+    userId: string;
+    queueInitToken: string;
+    expiresAt: number;
+}
+interface QueueBypassResponse {
+    status: "ACTIVE";
+    token: string;
+    expiresAt: number;
+    bypass: true;
+}
+type AdmissionMode = "PUBLIC" | "MANAGED" | "TRUSTED";
+interface QueueProtectionResponse {
+    eventId: string;
+    configured: boolean;
+    protected: boolean;
+    isActive: boolean;
+    isPaused: boolean;
+    admissionMode: AdmissionMode;
+    challengeRequired: boolean;
+}
+type AdmissionChallengeResponse = {
+    required: false;
+} | {
+    required: true;
+    publicKey: string;
+    appearance: "interaction-only";
+};
+type QueueVerifyResponse = {
+    valid: true;
+    userId: string;
+    eventId: string;
+    expiresAt: string;
+} | {
+    valid: false;
+    reason: string;
+};
+declare const CENTRALQ_DEFAULT_API_URL = "http://localhost:3001";
+/** @internal — HTTP client usado internamente por CentralQ */
+declare class QueueHttpClient {
+    apiUrl: string;
+    private apiKey?;
+    private queueInitToken?;
+    constructor(apiUrl?: string, apiKey?: string | undefined, queueInitToken?: string | undefined);
+    private get headers();
+    /**
+     * Intenta unir a un usuario a la cola de un evento.
+     * Llama a POST /api/queue/:eventId/join en el worker.
+     */
+    joinQueue(eventId: string, userId: string): Promise<QueueJoinResponse>;
+    /**
+     * Canjea un código de bypass por un token de acceso activo.
+     * El worker descuenta un uso únicamente cuando el canje es exitoso.
+     */
+    redeemBypassCode(eventId: string, code: string, userId?: string): Promise<QueueBypassResponse>;
+    /**
+     * Envía un heartbeat para mantener vivo el slot (waiting o active).
+     * El SDK lo llama cada 10s automáticamente.
+     */
+    sendHeartbeat(eventId: string, userId: string): Promise<void>;
+    /**
+     * Libera el slot del usuario inmediatamente.
+     * Llamar al completar la compra o al salir voluntariamente.
+     */
+    leaveQueue(eventId: string, userId: string): Promise<void>;
+    issueQueueInitToken(eventId: string, userId?: string, admissionProof?: string): Promise<QueueInitResponse>;
+    getProtection(eventId: string): Promise<QueueProtectionResponse>;
+    getAdmissionChallenge(eventId: string): Promise<AdmissionChallengeResponse>;
+    verifyToken(eventId: string, token: string): Promise<QueueVerifyResponse>;
+}
+
 interface CentralQOptions {
     /** URL del queue worker. */
     apiUrl?: string;
@@ -64,15 +151,22 @@ interface ErrorDetail {
     userId: string;
     eventId: string;
 }
+interface PausedDetail {
+    message: string;
+    retryAfterSeconds: number;
+    userId: string;
+    eventId: string;
+}
 type EventMap = {
     passed: PassedDetail;
     expired: ExpiredDetail;
     position: PositionDetail;
+    paused: PausedDetail;
     error: ErrorDetail;
 };
 type EventName = keyof EventMap;
 type Listener<T> = (detail: T) => void;
-type QueueStatus = "idle" | "joining" | "waiting" | "passed" | "expired" | "error";
+type QueueStatus = "idle" | "joining" | "waiting" | "paused" | "passed" | "expired" | "error";
 declare class CentralQ {
     private client;
     private element;
@@ -121,6 +215,7 @@ declare class CentralQ {
 declare class CentralQClient {
     private defaults;
     constructor(defaults: CentralQClientOptions);
+    redeemBypassCode(eventId: string, code: string, userId?: string): Promise<QueueBypassResponse>;
     issueQueueInitToken(eventId: string, userId?: string): Promise<{
         userId: string;
         queueInitToken: string;
@@ -131,4 +226,4 @@ declare class CentralQClient {
 }
 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 };
+export { type AdmissionChallengeResponse as A, CENTRALQ_DEFAULT_API_URL as C, type ErrorDetail as E, type PassedDetail as P, type QueueBypassResponse as Q, type AdmissionMode as a, CentralQ as b, CentralQClient as c, type CentralQClientOptions as d, type CentralQCreateOptions as e, type CentralQOptions as f, type ExpiredDetail as g, type PausedDetail as h, type PositionDetail as i, QueueHttpClient as j, type QueueJoinResponse as k, type QueueProtectionResponse as l, type QueueStatus as m, type QueueVerifyResponse as n, createCentralQClient as o };

package/dist/chunk-CFWLZCAR.mjs

@@ -0,0 +1,115 @@
+import {
+  CENTRALQ_DEFAULT_API_URL
+} from "./chunk-OR3GGW4J.mjs";
+
+// src/server.ts
+var DEFAULT_TIMEOUT_MS = 5e3;
+var CentralQServerRequestError = class extends Error {
+  constructor(code, message, options) {
+    super(message, options);
+    this.name = "CentralQServerRequestError";
+    this.code = code;
+  }
+};
+function normalizeApiUrl(apiUrl) {
+  const trimmed = apiUrl.trim().replace(/\/+$/, "");
+  return trimmed.endsWith("/api") ? trimmed.slice(0, -4) : trimmed;
+}
+function validateOptions(options) {
+  if (!options.secretKey?.trim()) {
+    throw new TypeError("CentralQ secretKey es requerida");
+  }
+  if (options.timeoutMs !== void 0 && options.timeoutMs <= 0) {
+    throw new TypeError("CentralQ timeoutMs debe ser mayor a cero");
+  }
+}
+var CentralQServerClient = class {
+  constructor(options) {
+    validateOptions(options);
+    this.apiUrl = normalizeApiUrl(options.apiUrl ?? CENTRALQ_DEFAULT_API_URL);
+    this.secretKey = options.secretKey.trim();
+    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.fetchFn = options.fetch ?? globalThis.fetch;
+  }
+  validateToken(input) {
+    return this.post(
+      `/api/queue/verify/${encodeURIComponent(input.eventId)}`,
+      { token: input.token },
+      { valid: false, reason: "Respuesta inv\xE1lida" }
+    );
+  }
+  verifyAccess(input) {
+    return this.post(
+      `/api/queue/verify/${encodeURIComponent(input.eventId)}/access`,
+      { token: input.token ?? null },
+      {
+        allowed: false,
+        reason: "invalid_response",
+        message: "Respuesta inv\xE1lida"
+      }
+    );
+  }
+  completeAccess(input) {
+    return this.post(
+      `/api/queue/verify/${encodeURIComponent(input.eventId)}/complete`,
+      {
+        token: input.token,
+        completionId: input.completionId
+      },
+      { completed: false, reason: "invalid_response" }
+    );
+  }
+  async post(path, body, fallback) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      const response = await this.fetchFn(`${this.apiUrl}${path}`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "x-api-key": this.secretKey
+        },
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+      const data = await response.json().catch(() => fallback);
+      return { status: response.status, data };
+    } catch (error) {
+      if (controller.signal.aborted) {
+        throw new CentralQServerRequestError(
+          "timeout",
+          `CentralQ no respondi\xF3 en ${this.timeoutMs}ms`,
+          { cause: error }
+        );
+      }
+      throw new CentralQServerRequestError(
+        "network_error",
+        "No se pudo conectar con CentralQ",
+        { cause: error }
+      );
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+};
+function createCentralQServerClient(options) {
+  return new CentralQServerClient(options);
+}
+function validateQueueTokenServer(options) {
+  return createCentralQServerClient(options).validateToken(options);
+}
+function verifyQueueAccessServer(options) {
+  return createCentralQServerClient(options).verifyAccess(options);
+}
+function completeQueueAccessServer(options) {
+  return createCentralQServerClient(options).completeAccess(options);
+}
+
+export {
+  CentralQServerRequestError,
+  CentralQServerClient,
+  createCentralQServerClient,
+  validateQueueTokenServer,
+  verifyQueueAccessServer,
+  completeQueueAccessServer
+};

package/dist/{chunk-P73Q2ZIO.mjs → chunk-OR3GGW4J.mjs}

@@ -38,6 +38,30 @@ var QueueHttpClient = class {
     }
     return res.json();
   }
+  /**
+   * Canjea un código de bypass por un token de acceso activo.
+   * El worker descuenta un uso únicamente cuando el canje es exitoso.
+   */
+  async redeemBypassCode(eventId, code, userId) {
+    const res = await fetch(
+      `${this.apiUrl}/api/queue/${encodeURIComponent(eventId)}/bypass`,
+      {
+        method: "POST",
+        headers: this.headers,
+        body: JSON.stringify({ code, userId })
+      }
+    );
+    const body = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      throw new Error(
+        body.message ?? `Error ${res.status} al canjear c\xF3digo bypass`
+      );
+    }
+    if (body.status !== "ACTIVE" || !body.token || !body.expiresAt || body.bypass !== true) {
+      throw new Error("Respuesta inv\xE1lida al canjear c\xF3digo bypass");
+    }
+    return body;
+  }
   /**
    * Envía un heartbeat para mantener vivo el slot (waiting o active).
    * El SDK lo llama cada 10s automáticamente.
@@ -107,6 +131,7 @@ var QueueHttpClient = class {
       configured: body.configured === true,
       protected: body.protected === true,
       isActive: body.isActive === true,
+      isPaused: body.isPaused === true,
       admissionMode: body.admissionMode ?? "PUBLIC",
       challengeRequired: body.challengeRequired === true
     };

package/dist/{chunk-BVCZFNM3.mjs → chunk-OVV3CIZZ.mjs}

@@ -1,7 +1,7 @@
 import {
   CENTRALQ_DEFAULT_API_URL,
   QueueHttpClient
-} from "./chunk-P73Q2ZIO.mjs";
+} from "./chunk-OR3GGW4J.mjs";
 
 // src/admission.ts
 var turnstileScript = null;
@@ -171,7 +171,7 @@ var CentralQ = class _CentralQ {
   }
   // UI: montar/desmontar el Web Component
   mount() {
-    import("./queue-element-DXBW64U2.mjs");
+    import("./queue-element-QDDGTF6K.mjs");
     this.element = document.createElement("central-q");
     this.element.onRetry = () => {
       this.updateUI("LOADING");
@@ -266,6 +266,24 @@ var CentralQ = class _CentralQ {
             this.pollInterval
           );
         }
+      } else if (res.status === "PAUSED") {
+        this.updateUI("PAUSED");
+        this.emit("paused", {
+          message: res.message,
+          retryAfterSeconds: res.retryAfterSeconds,
+          userId: this.userId,
+          eventId: this.eventId
+        });
+        if (!this.pollingTimer) {
+          const retryInterval = Math.max(
+            this.pollInterval,
+            res.retryAfterSeconds * 1e3
+          );
+          this.pollingTimer = setInterval(
+            () => this.checkQueue(),
+            retryInterval
+          );
+        }
       }
     } catch {
       this.updateUI("ERROR");
@@ -281,6 +299,13 @@ var CentralQClient = class {
   constructor(defaults) {
     this.defaults = defaults;
   }
+  redeemBypassCode(eventId, code, userId) {
+    const client = new QueueHttpClient(
+      this.defaults.apiUrl,
+      this.defaults.apiKey
+    );
+    return client.redeemBypassCode(eventId, code, userId);
+  }
   issueQueueInitToken(eventId, userId) {
     const client = new QueueHttpClient(
       this.defaults.apiUrl,

package/dist/index.d.mts

@@ -1,86 +1,15 @@
-export { C as CentralQ, a as CentralQClient, b as CentralQClientOptions, c as CentralQCreateOptions, d as CentralQOptions, E as ErrorDetail, e as ExpiredDetail, P as PassedDetail, f as PositionDetail, Q as QueueStatus, g as createCentralQClient } from './centralq-C3ukDo0x.mjs';
-export { QueueTokenValidationResult, ValidateQueueTokenServerOptions, validateQueueTokenServer } from './server.mjs';
+export { A as AdmissionChallengeResponse, a as AdmissionMode, C as CENTRALQ_DEFAULT_API_URL, b as CentralQ, c as CentralQClient, d as CentralQClientOptions, e as CentralQCreateOptions, f as CentralQOptions, E as ErrorDetail, g as ExpiredDetail, P as PassedDetail, h as PausedDetail, i as PositionDetail, Q as QueueBypassResponse, j as QueueHttpClient, k as QueueJoinResponse, l as QueueProtectionResponse, m as QueueStatus, n as QueueVerifyResponse, o as createCentralQClient } from './centralq-CCw_Cqam.mjs';
+export { CentralQServerClient, CentralQServerClientOptions, CentralQServerRequestError, CentralQServerRequestErrorCode, CompleteQueueAccessServerOptions, QueueAccessCompletionResult, QueueAccessValidationResult, QueueTokenValidationResult, ValidateQueueTokenServerOptions, VerifyQueueAccessServerOptions, completeQueueAccessServer, createCentralQServerClient, validateQueueTokenServer, verifyQueueAccessServer } from './server.mjs';
 import * as lit from 'lit';
 import { LitElement } from 'lit';
 
-type QueueJoinResponse = {
-    status: "ACTIVE";
-    token: string;
-    expiresAt: number;
-} | {
-    status: "WAITING";
-    position: number;
-    ahead: number;
-} | {
-    status: "ERROR";
-    message: string;
-};
-interface QueueInitResponse {
-    userId: string;
-    queueInitToken: string;
-    expiresAt: number;
-}
-type AdmissionMode = "PUBLIC" | "MANAGED" | "TRUSTED";
-interface QueueProtectionResponse {
-    eventId: string;
-    configured: boolean;
-    protected: boolean;
-    isActive: boolean;
-    admissionMode: AdmissionMode;
-    challengeRequired: boolean;
-}
-type AdmissionChallengeResponse = {
-    required: false;
-} | {
-    required: true;
-    publicKey: string;
-    appearance: "interaction-only";
-};
-type QueueVerifyResponse = {
-    valid: true;
-    userId: string;
-    eventId: string;
-    expiresAt: string;
-} | {
-    valid: false;
-    reason: string;
-};
-declare const CENTRALQ_DEFAULT_API_URL = "http://localhost:3001";
-/** @internal — HTTP client usado internamente por CentralQ */
-declare class QueueHttpClient {
-    apiUrl: string;
-    private apiKey?;
-    private queueInitToken?;
-    constructor(apiUrl?: string, apiKey?: string | undefined, queueInitToken?: string | undefined);
-    private get headers();
-    /**
-     * Intenta unir a un usuario a la cola de un evento.
-     * Llama a POST /api/queue/:eventId/join en el worker.
-     */
-    joinQueue(eventId: string, userId: string): Promise<QueueJoinResponse>;
-    /**
-     * Envía un heartbeat para mantener vivo el slot (waiting o active).
-     * El SDK lo llama cada 10s automáticamente.
-     */
-    sendHeartbeat(eventId: string, userId: string): Promise<void>;
-    /**
-     * Libera el slot del usuario inmediatamente.
-     * Llamar al completar la compra o al salir voluntariamente.
-     */
-    leaveQueue(eventId: string, userId: string): Promise<void>;
-    issueQueueInitToken(eventId: string, userId?: string, admissionProof?: string): Promise<QueueInitResponse>;
-    getProtection(eventId: string): Promise<QueueProtectionResponse>;
-    getAdmissionChallenge(eventId: string): Promise<AdmissionChallengeResponse>;
-    verifyToken(eventId: string, token: string): Promise<QueueVerifyResponse>;
-}
-
 /**
  * <central-q> — Web Component de UI puro (internal).
  * Solo renderiza el overlay de la fila. Toda la lógica la maneja CentralQ.
  * No usar directamente — instanciar CentralQ en su lugar.
  */
 declare class CentralQElement extends LitElement {
-    status: "LOADING" | "WAITING" | "ACTIVE" | "EXPIRED" | "ERROR";
+    status: "LOADING" | "WAITING" | "PAUSED" | "ACTIVE" | "EXPIRED" | "ERROR";
     position: number;
     ahead: number;
     /** Callback que CentralQ inyecta para manejar "Volver a la fila" */
@@ -89,4 +18,4 @@ declare class CentralQElement extends LitElement {
     render(): lit.TemplateResult<1>;
 }
 
-export { type AdmissionChallengeResponse, type AdmissionMode, CENTRALQ_DEFAULT_API_URL, CentralQElement, QueueHttpClient, type QueueJoinResponse, type QueueProtectionResponse, type QueueVerifyResponse };
+export { CentralQElement };

package/dist/index.d.ts

@@ -1,86 +1,15 @@
-export { C as CentralQ, a as CentralQClient, b as CentralQClientOptions, c as CentralQCreateOptions, d as CentralQOptions, E as ErrorDetail, e as ExpiredDetail, P as PassedDetail, f as PositionDetail, Q as QueueStatus, g as createCentralQClient } from './centralq-C3ukDo0x.js';
-export { QueueTokenValidationResult, ValidateQueueTokenServerOptions, validateQueueTokenServer } from './server.js';
+export { A as AdmissionChallengeResponse, a as AdmissionMode, C as CENTRALQ_DEFAULT_API_URL, b as CentralQ, c as CentralQClient, d as CentralQClientOptions, e as CentralQCreateOptions, f as CentralQOptions, E as ErrorDetail, g as ExpiredDetail, P as PassedDetail, h as PausedDetail, i as PositionDetail, Q as QueueBypassResponse, j as QueueHttpClient, k as QueueJoinResponse, l as QueueProtectionResponse, m as QueueStatus, n as QueueVerifyResponse, o as createCentralQClient } from './centralq-CCw_Cqam.js';
+export { CentralQServerClient, CentralQServerClientOptions, CentralQServerRequestError, CentralQServerRequestErrorCode, CompleteQueueAccessServerOptions, QueueAccessCompletionResult, QueueAccessValidationResult, QueueTokenValidationResult, ValidateQueueTokenServerOptions, VerifyQueueAccessServerOptions, completeQueueAccessServer, createCentralQServerClient, validateQueueTokenServer, verifyQueueAccessServer } from './server.js';
 import * as lit from 'lit';
 import { LitElement } from 'lit';
 
-type QueueJoinResponse = {
-    status: "ACTIVE";
-    token: string;
-    expiresAt: number;
-} | {
-    status: "WAITING";
-    position: number;
-    ahead: number;
-} | {
-    status: "ERROR";
-    message: string;
-};
-interface QueueInitResponse {
-    userId: string;
-    queueInitToken: string;
-    expiresAt: number;
-}
-type AdmissionMode = "PUBLIC" | "MANAGED" | "TRUSTED";
-interface QueueProtectionResponse {
-    eventId: string;
-    configured: boolean;
-    protected: boolean;
-    isActive: boolean;
-    admissionMode: AdmissionMode;
-    challengeRequired: boolean;
-}
-type AdmissionChallengeResponse = {
-    required: false;
-} | {
-    required: true;
-    publicKey: string;
-    appearance: "interaction-only";
-};
-type QueueVerifyResponse = {
-    valid: true;
-    userId: string;
-    eventId: string;
-    expiresAt: string;
-} | {
-    valid: false;
-    reason: string;
-};
-declare const CENTRALQ_DEFAULT_API_URL = "http://localhost:3001";
-/** @internal — HTTP client usado internamente por CentralQ */
-declare class QueueHttpClient {
-    apiUrl: string;
-    private apiKey?;
-    private queueInitToken?;
-    constructor(apiUrl?: string, apiKey?: string | undefined, queueInitToken?: string | undefined);
-    private get headers();
-    /**
-     * Intenta unir a un usuario a la cola de un evento.
-     * Llama a POST /api/queue/:eventId/join en el worker.
-     */
-    joinQueue(eventId: string, userId: string): Promise<QueueJoinResponse>;
-    /**
-     * Envía un heartbeat para mantener vivo el slot (waiting o active).
-     * El SDK lo llama cada 10s automáticamente.
-     */
-    sendHeartbeat(eventId: string, userId: string): Promise<void>;
-    /**
-     * Libera el slot del usuario inmediatamente.
-     * Llamar al completar la compra o al salir voluntariamente.
-     */
-    leaveQueue(eventId: string, userId: string): Promise<void>;
-    issueQueueInitToken(eventId: string, userId?: string, admissionProof?: string): Promise<QueueInitResponse>;
-    getProtection(eventId: string): Promise<QueueProtectionResponse>;
-    getAdmissionChallenge(eventId: string): Promise<AdmissionChallengeResponse>;
-    verifyToken(eventId: string, token: string): Promise<QueueVerifyResponse>;
-}
-
 /**
  * <central-q> — Web Component de UI puro (internal).
  * Solo renderiza el overlay de la fila. Toda la lógica la maneja CentralQ.
  * No usar directamente — instanciar CentralQ en su lugar.
  */
 declare class CentralQElement extends LitElement {
-    status: "LOADING" | "WAITING" | "ACTIVE" | "EXPIRED" | "ERROR";
+    status: "LOADING" | "WAITING" | "PAUSED" | "ACTIVE" | "EXPIRED" | "ERROR";
     position: number;
     ahead: number;
     /** Callback que CentralQ inyecta para manejar "Volver a la fila" */
@@ -89,4 +18,4 @@ declare class CentralQElement extends LitElement {
     render(): lit.TemplateResult<1>;
 }
 
-export { type AdmissionChallengeResponse, type AdmissionMode, CENTRALQ_DEFAULT_API_URL, CentralQElement, QueueHttpClient, type QueueJoinResponse, type QueueProtectionResponse, type QueueVerifyResponse };
+export { CentralQElement };