@reachflow/sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,352 @@
+// src/errors.ts
+var ReachFlowError = class _ReachFlowError extends Error {
+  statusCode;
+  code;
+  retryable;
+  retryAfterMs;
+  body;
+  constructor(params) {
+    super(params.message, params.cause ? { cause: params.cause } : void 0);
+    this.name = "ReachFlowError";
+    this.statusCode = params.statusCode;
+    this.code = params.code;
+    this.retryable = params.retryable ?? false;
+    this.retryAfterMs = params.retryAfterMs;
+    this.body = params.body;
+  }
+  static fromResponse(status, body, fallbackMessage) {
+    const parsed = body ?? {};
+    const apiError = parsed.error;
+    const message = parsed.message ?? fallbackMessage ?? `ReachFlow API error (HTTP ${status})`;
+    const code = mapApiErrorToCode(status, apiError);
+    const retryable = status === 429 || status === 408 || status >= 500 && status < 600;
+    return new _ReachFlowError({
+      message,
+      statusCode: status,
+      code,
+      retryable,
+      body
+    });
+  }
+  static network(cause) {
+    return new _ReachFlowError({
+      message: "Network error while calling ReachFlow API",
+      statusCode: 0,
+      code: "network_error",
+      retryable: true,
+      cause
+    });
+  }
+  static timeout(timeoutMs) {
+    return new _ReachFlowError({
+      message: `Request timed out after ${timeoutMs}ms`,
+      statusCode: 408,
+      code: "timeout",
+      retryable: true
+    });
+  }
+};
+function mapApiErrorToCode(status, apiError) {
+  switch (apiError) {
+    case "unauthorized":
+      return "unauthorized";
+    case "plan_required":
+      return "plan_required";
+    case "insufficient_scope":
+      return "insufficient_scope";
+    case "rate_limit_exceeded":
+      return "rate_limit_exceeded";
+    case "too_many_auth_failures":
+      return "too_many_auth_failures";
+    default:
+      break;
+  }
+  if (status === 401) return "unauthorized";
+  if (status === 403) return "insufficient_scope";
+  if (status === 404) return "not_found";
+  if (status === 400 || status === 422) return "validation_error";
+  if (status === 429) return "rate_limit_exceeded";
+  return "api_error";
+}
+function parseRetryAfterMs(header) {
+  if (!header) return void 0;
+  const seconds = Number(header);
+  if (!Number.isNaN(seconds)) return Math.max(0, seconds * 1e3);
+  const date = Date.parse(header);
+  if (!Number.isNaN(date)) return Math.max(0, date - Date.now());
+  return void 0;
+}
+
+// src/types.ts
+var TERMINAL_MESSAGE_STATUSES = /* @__PURE__ */ new Set([
+  "sent",
+  "delivered",
+  "failed",
+  "cancelled"
+]);
+var DEFAULT_BASE_URL = "https://sandbox-api.reachflow.me";
+
+// src/http.ts
+function resolveConfig(options) {
+  const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+  return {
+    apiKey: options.apiKey.trim(),
+    baseUrl,
+    apiPrefix: `${baseUrl}/api/v1`,
+    timeoutMs: options.timeoutMs ?? 3e4,
+    fetchImpl: options.fetch ?? globalThis.fetch,
+    maxRetries: options.maxRetries ?? 2
+  };
+}
+var HttpClient = class {
+  constructor(config) {
+    this.config = config;
+  }
+  config;
+  async request(options) {
+    let attempt = 0;
+    let lastError;
+    while (attempt <= this.config.maxRetries) {
+      try {
+        return await this.requestOnce(options);
+      } catch (err) {
+        if (!(err instanceof ReachFlowError)) throw err;
+        lastError = err;
+        if (!err.retryable || attempt >= this.config.maxRetries) throw err;
+        const delayMs = err.retryAfterMs ?? backoffMs(attempt);
+        await sleep(delayMs);
+        attempt += 1;
+      }
+    }
+    throw lastError ?? new ReachFlowError({
+      message: "Request failed",
+      statusCode: 0,
+      code: "api_error"
+    });
+  }
+  async requestOnce(options) {
+    const url = `${this.config.apiPrefix}${options.path}`;
+    const headers = {
+      Accept: "application/json",
+      "X-API-Key": this.config.apiKey
+    };
+    if (options.body !== void 0) {
+      headers["Content-Type"] = "application/json";
+    }
+    if (options.idempotencyKey) {
+      headers["Idempotency-Key"] = options.idempotencyKey;
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.config.timeoutMs);
+    try {
+      const response = await this.config.fetchImpl(url, {
+        method: options.method,
+        headers,
+        body: options.body !== void 0 ? JSON.stringify(options.body) : void 0,
+        signal: controller.signal
+      });
+      const text = await response.text();
+      let data = null;
+      if (text) {
+        try {
+          data = JSON.parse(text);
+        } catch {
+          data = { raw: text.slice(0, 500) };
+        }
+      }
+      if (!response.ok) {
+        const err = ReachFlowError.fromResponse(
+          response.status,
+          data
+        );
+        const retryAfterMs = parseRetryAfterMs(
+          response.headers.get("Retry-After")
+        );
+        if (retryAfterMs !== void 0) {
+          throw new ReachFlowError({
+            message: err.message,
+            statusCode: err.statusCode,
+            code: err.code,
+            retryable: err.retryable,
+            retryAfterMs,
+            body: err.body
+          });
+        }
+        throw err;
+      }
+      return data;
+    } catch (err) {
+      if (err instanceof ReachFlowError) throw err;
+      if (err instanceof Error && err.name === "AbortError") {
+        throw ReachFlowError.timeout(this.config.timeoutMs);
+      }
+      throw ReachFlowError.network(err);
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+};
+function backoffMs(attempt) {
+  return Math.min(1e3 * 2 ** attempt, 1e4);
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/resources/messages.ts
+var MessagesResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** Envoie un message texte (réponse HTTP 202). */
+  async send(params) {
+    const { idempotencyKey, ...body } = params;
+    return this.http.request({
+      method: "POST",
+      path: "/messages/send",
+      body,
+      idempotencyKey
+    });
+  }
+  /** Envoie un média via URL HTTPS publique (réponse HTTP 202). */
+  async sendMedia(params) {
+    const { idempotencyKey, ...body } = params;
+    return this.http.request({
+      method: "POST",
+      path: "/messages/send-media",
+      body,
+      idempotencyKey
+    });
+  }
+  /** Envoie un lot de messages (même modèle, destinataires multiples). */
+  async sendBulk(params) {
+    const { idempotencyKey, ...body } = params;
+    return this.http.request({
+      method: "POST",
+      path: "/messages/send-bulk",
+      body,
+      idempotencyKey
+    });
+  }
+  /** Consulte le statut d'un message précédemment accepté. */
+  async getStatus(messageId) {
+    return this.http.request({
+      method: "GET",
+      path: `/messages/${messageId}`
+    });
+  }
+  /**
+   * Poll jusqu'à un statut terminal (`sent`, `delivered`, `failed`, `cancelled`).
+   * Lance `ReachFlowError` si timeout.
+   */
+  async waitForTerminal(messageId, options) {
+    const pollIntervalMs = options?.pollIntervalMs ?? 2e3;
+    const timeoutMs = options?.timeoutMs ?? 12e4;
+    const started = Date.now();
+    while (Date.now() - started < timeoutMs) {
+      const status = await this.getStatus(messageId);
+      if (TERMINAL_MESSAGE_STATUSES.has(status.status)) {
+        return status;
+      }
+      await sleep2(pollIntervalMs);
+    }
+    throw new ReachFlowError({
+      message: `Message ${messageId} did not reach a terminal status within ${timeoutMs}ms`,
+      statusCode: 408,
+      code: "timeout",
+      retryable: false
+    });
+  }
+};
+function sleep2(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/resources/otp.ts
+var OtpResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Génère et envoie un code OTP par WhatsApp.
+   * Le code n'est jamais retourné par l'API — uniquement sur WhatsApp.
+   */
+  async send(params) {
+    return this.http.request({
+      method: "POST",
+      path: "/otp/send",
+      body: params
+    });
+  }
+  /** Vérifie un code saisi par l'utilisateur final. */
+  async verify(params) {
+    return this.http.request({
+      method: "POST",
+      path: "/otp/verify",
+      body: params
+    });
+  }
+};
+
+// src/resources/providers.ts
+var ProvidersResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** Liste les numéros WhatsApp accessibles via l'API. */
+  async list() {
+    return this.http.request({
+      method: "GET",
+      path: "/providers"
+    });
+  }
+  /** Détail d'un provider avec statistiques journalières. */
+  async get(providerId) {
+    return this.http.request({
+      method: "GET",
+      path: `/providers/${providerId}`
+    });
+  }
+  /**
+   * Retourne le premier provider au statut `connected`, ou le premier de la liste.
+   * Utile pour les scripts de test / démarrage rapide.
+   */
+  async findConnected() {
+    const { providers } = await this.list();
+    if (providers.length === 0) return null;
+    return providers.find((p) => p.status.toLowerCase() === "connected") ?? providers[0] ?? null;
+  }
+};
+
+// src/client.ts
+var ReachFlow = class {
+  messages;
+  providers;
+  otp;
+  http;
+  config;
+  constructor(options) {
+    if (!options.apiKey?.trim()) {
+      throw new Error("ReachFlow: apiKey is required");
+    }
+    this.config = resolveConfig(options);
+    this.http = new HttpClient(this.config);
+    this.messages = new MessagesResource(this.http);
+    this.providers = new ProvidersResource(this.http);
+    this.otp = new OtpResource(this.http);
+  }
+  /** URL de base configurée (sans `/api/v1`). */
+  get baseUrl() {
+    return this.config.baseUrl;
+  }
+};
+export {
+  DEFAULT_BASE_URL,
+  ReachFlow,
+  ReachFlowError,
+  TERMINAL_MESSAGE_STATUSES
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/types.ts","../src/http.ts","../src/resources/messages.ts","../src/resources/otp.ts","../src/resources/providers.ts","../src/client.ts"],"sourcesContent":["export type ReachFlowErrorCode =\n  | 'unauthorized'\n  | 'plan_required'\n  | 'insufficient_scope'\n  | 'rate_limit_exceeded'\n  | 'too_many_auth_failures'\n  | 'validation_error'\n  | 'not_found'\n  | 'api_error'\n  | 'network_error'\n  | 'timeout';\n\nexport interface ReachFlowErrorBody {\n  statusCode?: number;\n  error?: string;\n  message?: string;\n}\n\nexport class ReachFlowError extends Error {\n  readonly statusCode: number;\n  readonly code: ReachFlowErrorCode;\n  readonly retryable: boolean;\n  readonly retryAfterMs?: number;\n  readonly body?: unknown;\n\n  constructor(params: {\n    message: string;\n    statusCode: number;\n    code: ReachFlowErrorCode;\n    retryable?: boolean;\n    retryAfterMs?: number;\n    body?: unknown;\n    cause?: unknown;\n  }) {\n    super(params.message, params.cause ? { cause: params.cause } : undefined);\n    this.name = 'ReachFlowError';\n    this.statusCode = params.statusCode;\n    this.code = params.code;\n    this.retryable = params.retryable ?? false;\n    this.retryAfterMs = params.retryAfterMs;\n    this.body = params.body;\n  }\n\n  static fromResponse(\n    status: number,\n    body: unknown,\n    fallbackMessage?: string,\n  ): ReachFlowError {\n    const parsed = (body ?? {}) as ReachFlowErrorBody;\n    const apiError = parsed.error;\n    const message =\n      parsed.message ??\n      fallbackMessage ??\n      `ReachFlow API error (HTTP ${status})`;\n\n    const code = mapApiErrorToCode(status, apiError);\n    const retryable =\n      status === 429 || status === 408 || (status >= 500 && status < 600);\n\n    return new ReachFlowError({\n      message,\n      statusCode: status,\n      code,\n      retryable,\n      body,\n    });\n  }\n\n  static network(cause: unknown): ReachFlowError {\n    return new ReachFlowError({\n      message: 'Network error while calling ReachFlow API',\n      statusCode: 0,\n      code: 'network_error',\n      retryable: true,\n      cause,\n    });\n  }\n\n  static timeout(timeoutMs: number): ReachFlowError {\n    return new ReachFlowError({\n      message: `Request timed out after ${timeoutMs}ms`,\n      statusCode: 408,\n      code: 'timeout',\n      retryable: true,\n    });\n  }\n}\n\nfunction mapApiErrorToCode(\n  status: number,\n  apiError?: string,\n): ReachFlowErrorCode {\n  switch (apiError) {\n    case 'unauthorized':\n      return 'unauthorized';\n    case 'plan_required':\n      return 'plan_required';\n    case 'insufficient_scope':\n      return 'insufficient_scope';\n    case 'rate_limit_exceeded':\n      return 'rate_limit_exceeded';\n    case 'too_many_auth_failures':\n      return 'too_many_auth_failures';\n    default:\n      break;\n  }\n\n  if (status === 401) return 'unauthorized';\n  if (status === 403) return 'insufficient_scope';\n  if (status === 404) return 'not_found';\n  if (status === 400 || status === 422) return 'validation_error';\n  if (status === 429) return 'rate_limit_exceeded';\n  return 'api_error';\n}\n\nexport function parseRetryAfterMs(header: string | null): number | undefined {\n  if (!header) return undefined;\n  const seconds = Number(header);\n  if (!Number.isNaN(seconds)) return Math.max(0, seconds * 1000);\n  const date = Date.parse(header);\n  if (!Number.isNaN(date)) return Math.max(0, date - Date.now());\n  return undefined;\n}\n","/** Statut de cycle de vie d'un message API. */\nexport type MessageStatus =\n  | 'queued'\n  | 'processing'\n  | 'sent'\n  | 'delivered'\n  | 'failed'\n  | 'cancelled';\n\nexport type MediaType = 'image' | 'document' | 'audio' | 'video';\n\nexport type FailureCode =\n  | 'warmup_daily_limit'\n  | 'risk_circuit_open'\n  | 'provider_disconnected'\n  | 'provider_banned'\n  | 'send_not_allowed'\n  | 'instance_busy'\n  | 'delivery_timeout'\n  | 'delivery_failed'\n  | 'send_error'\n  | 'provider_not_found';\n\nexport type OtpVerifyReason =\n  | 'invalidated'\n  | 'already_used'\n  | 'expired'\n  | 'max_attempts_reached'\n  | 'invalid_code'\n  | 'not_found';\n\nexport interface ReachFlowClientOptions {\n  /** Clé API `rfl_live_…` ou `rfl_test_…`. */\n  apiKey: string;\n  /**\n   * URL de base sans `/api/v1` (défaut : sandbox ReachFlow).\n   * @default \"https://sandbox-api.reachflow.me\"\n   */\n  baseUrl?: string;\n  /** Timeout HTTP en millisecondes. @default 30000 */\n  timeoutMs?: number;\n  /** Implémentation fetch (tests, Node < 18). @default global fetch */\n  fetch?: typeof fetch;\n  /** Nombre max de retries sur 429 / 5xx retryables. @default 2 */\n  maxRetries?: number;\n}\n\nexport interface SendMessageParams {\n  providerId: string;\n  to: string;\n  message: string;\n  variables?: Record<string, string>;\n  scheduleAt?: string;\n  saveContact?: boolean;\n  idempotencyKey?: string;\n}\n\nexport interface SendMediaParams {\n  providerId: string;\n  to: string;\n  mediaUrl: string;\n  mediaType: MediaType;\n  caption?: string;\n  saveContact?: boolean;\n  idempotencyKey?: string;\n}\n\nexport interface BulkRecipient {\n  to: string;\n  variables?: Record<string, string>;\n}\n\nexport interface SendBulkParams {\n  providerId: string;\n  messageTemplate: string;\n  recipients: BulkRecipient[];\n  scheduleAt?: string;\n  saveContact?: boolean;\n  idempotencyKey?: string;\n}\n\nexport interface SendAcceptedResponse {\n  messageId: string;\n  status: 'queued';\n  queuedAt: string;\n}\n\nexport interface BulkRejection {\n  to: string;\n  reason: string;\n}\n\nexport interface SendBulkResponse {\n  bulkId: string;\n  accepted: number;\n  rejected: number;\n  rejections: BulkRejection[];\n  messageIds: string[];\n}\n\nexport interface MessageStatusResponse {\n  messageId: string;\n  status: MessageStatus;\n  to: string;\n  providerId: string;\n  queuedAt: string;\n  sentAt: string | null;\n  deliveredAt: string | null;\n  failedAt: string | null;\n  failureCode: FailureCode | null;\n  failureReason: string | null;\n}\n\nexport interface ProviderSummary {\n  id: string;\n  name: string;\n  phoneNumber: string | null;\n  status: string;\n  warmupDay: number;\n  riskScore: number;\n}\n\nexport interface ProviderDailyStats {\n  sent: number;\n  delivered: number;\n  failed: number;\n  messagesLimit: number | null;\n  newContactsLimit: number | null;\n}\n\nexport interface ProviderDetail extends ProviderSummary {\n  dailyStats: ProviderDailyStats;\n}\n\nexport interface ProviderListResponse {\n  providers: ProviderSummary[];\n}\n\nexport interface OtpSendParams {\n  providerId: string;\n  phoneNumber: string;\n  codeLength?: number;\n  expiresIn?: number;\n  brandName?: string;\n  template?: string;\n  saveContact?: boolean;\n}\n\nexport interface OtpSendResponse {\n  otpId: string;\n  messageId: string;\n  expiresAt: string;\n}\n\nexport interface OtpVerifyParams {\n  otpId: string;\n  code: string;\n}\n\nexport interface OtpVerifyResponse {\n  valid: boolean;\n  reason?: OtpVerifyReason;\n  attemptsLeft?: number;\n}\n\nexport interface WaitForTerminalOptions {\n  /** Intervalle entre polls en ms. @default 2000 */\n  pollIntervalMs?: number;\n  /** Timeout total en ms. @default 120000 */\n  timeoutMs?: number;\n}\n\nexport const TERMINAL_MESSAGE_STATUSES: ReadonlySet<MessageStatus> = new Set([\n  'sent',\n  'delivered',\n  'failed',\n  'cancelled',\n]);\n\nexport const DEFAULT_BASE_URL = 'https://sandbox-api.reachflow.me';\n","import { ReachFlowError, parseRetryAfterMs } from './errors.js';\nimport type { ReachFlowClientOptions } from './types.js';\nimport { DEFAULT_BASE_URL } from './types.js';\n\nexport interface RequestOptions {\n  method: 'GET' | 'POST';\n  path: string;\n  body?: unknown;\n  idempotencyKey?: string;\n}\n\nexport interface ResolvedClientConfig {\n  apiKey: string;\n  baseUrl: string;\n  apiPrefix: string;\n  timeoutMs: number;\n  fetchImpl: typeof fetch;\n  maxRetries: number;\n}\n\nexport function resolveConfig(\n  options: ReachFlowClientOptions,\n): ResolvedClientConfig {\n  const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '');\n  return {\n    apiKey: options.apiKey.trim(),\n    baseUrl,\n    apiPrefix: `${baseUrl}/api/v1`,\n    timeoutMs: options.timeoutMs ?? 30_000,\n    fetchImpl: options.fetch ?? globalThis.fetch,\n    maxRetries: options.maxRetries ?? 2,\n  };\n}\n\nexport class HttpClient {\n  constructor(private readonly config: ResolvedClientConfig) {}\n\n  async request<T>(options: RequestOptions): Promise<T> {\n    let attempt = 0;\n    let lastError: ReachFlowError | undefined;\n\n    while (attempt <= this.config.maxRetries) {\n      try {\n        return await this.requestOnce<T>(options);\n      } catch (err) {\n        if (!(err instanceof ReachFlowError)) throw err;\n        lastError = err;\n        if (!err.retryable || attempt >= this.config.maxRetries) throw err;\n        const delayMs = err.retryAfterMs ?? backoffMs(attempt);\n        await sleep(delayMs);\n        attempt += 1;\n      }\n    }\n\n    throw lastError ?? new ReachFlowError({\n      message: 'Request failed',\n      statusCode: 0,\n      code: 'api_error',\n    });\n  }\n\n  private async requestOnce<T>(options: RequestOptions): Promise<T> {\n    const url = `${this.config.apiPrefix}${options.path}`;\n    const headers: Record<string, string> = {\n      Accept: 'application/json',\n      'X-API-Key': this.config.apiKey,\n    };\n\n    if (options.body !== undefined) {\n      headers['Content-Type'] = 'application/json';\n    }\n    if (options.idempotencyKey) {\n      headers['Idempotency-Key'] = options.idempotencyKey;\n    }\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.config.timeoutMs);\n\n    try {\n      const response = await this.config.fetchImpl(url, {\n        method: options.method,\n        headers,\n        body:\n          options.body !== undefined\n            ? JSON.stringify(options.body)\n            : undefined,\n        signal: controller.signal,\n      });\n\n      const text = await response.text();\n      let data: unknown = null;\n      if (text) {\n        try {\n          data = JSON.parse(text) as unknown;\n        } catch {\n          data = { raw: text.slice(0, 500) };\n        }\n      }\n\n      if (!response.ok) {\n        const err = ReachFlowError.fromResponse(\n          response.status,\n          data,\n        );\n        const retryAfterMs = parseRetryAfterMs(\n          response.headers.get('Retry-After'),\n        );\n        if (retryAfterMs !== undefined) {\n          throw new ReachFlowError({\n            message: err.message,\n            statusCode: err.statusCode,\n            code: err.code,\n            retryable: err.retryable,\n            retryAfterMs,\n            body: err.body,\n          });\n        }\n        throw err;\n      }\n\n      return data as T;\n    } catch (err) {\n      if (err instanceof ReachFlowError) throw err;\n      if (err instanceof Error && err.name === 'AbortError') {\n        throw ReachFlowError.timeout(this.config.timeoutMs);\n      }\n      throw ReachFlowError.network(err);\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n}\n\nfunction backoffMs(attempt: number): number {\n  return Math.min(1000 * 2 ** attempt, 10_000);\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import type { HttpClient } from '../http.js';\nimport { ReachFlowError } from '../errors.js';\nimport type {\n  MessageStatusResponse,\n  SendAcceptedResponse,\n  SendBulkParams,\n  SendBulkResponse,\n  SendMediaParams,\n  SendMessageParams,\n  WaitForTerminalOptions,\n} from '../types.js';\nimport { TERMINAL_MESSAGE_STATUSES } from '../types.js';\n\nexport class MessagesResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Envoie un message texte (réponse HTTP 202). */\n  async send(params: SendMessageParams): Promise<SendAcceptedResponse> {\n    const { idempotencyKey, ...body } = params;\n    return this.http.request<SendAcceptedResponse>({\n      method: 'POST',\n      path: '/messages/send',\n      body,\n      idempotencyKey,\n    });\n  }\n\n  /** Envoie un média via URL HTTPS publique (réponse HTTP 202). */\n  async sendMedia(params: SendMediaParams): Promise<SendAcceptedResponse> {\n    const { idempotencyKey, ...body } = params;\n    return this.http.request<SendAcceptedResponse>({\n      method: 'POST',\n      path: '/messages/send-media',\n      body,\n      idempotencyKey,\n    });\n  }\n\n  /** Envoie un lot de messages (même modèle, destinataires multiples). */\n  async sendBulk(params: SendBulkParams): Promise<SendBulkResponse> {\n    const { idempotencyKey, ...body } = params;\n    return this.http.request<SendBulkResponse>({\n      method: 'POST',\n      path: '/messages/send-bulk',\n      body,\n      idempotencyKey,\n    });\n  }\n\n  /** Consulte le statut d'un message précédemment accepté. */\n  async getStatus(messageId: string): Promise<MessageStatusResponse> {\n    return this.http.request<MessageStatusResponse>({\n      method: 'GET',\n      path: `/messages/${messageId}`,\n    });\n  }\n\n  /**\n   * Poll jusqu'à un statut terminal (`sent`, `delivered`, `failed`, `cancelled`).\n   * Lance `ReachFlowError` si timeout.\n   */\n  async waitForTerminal(\n    messageId: string,\n    options?: WaitForTerminalOptions,\n  ): Promise<MessageStatusResponse> {\n    const pollIntervalMs = options?.pollIntervalMs ?? 2_000;\n    const timeoutMs = options?.timeoutMs ?? 120_000;\n    const started = Date.now();\n\n    while (Date.now() - started < timeoutMs) {\n      const status = await this.getStatus(messageId);\n      if (TERMINAL_MESSAGE_STATUSES.has(status.status)) {\n        return status;\n      }\n      await sleep(pollIntervalMs);\n    }\n\n    throw new ReachFlowError({\n      message: `Message ${messageId} did not reach a terminal status within ${timeoutMs}ms`,\n      statusCode: 408,\n      code: 'timeout',\n      retryable: false,\n    });\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import type { HttpClient } from '../http.js';\nimport type {\n  OtpSendParams,\n  OtpSendResponse,\n  OtpVerifyParams,\n  OtpVerifyResponse,\n} from '../types.js';\n\nexport class OtpResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Génère et envoie un code OTP par WhatsApp.\n   * Le code n'est jamais retourné par l'API — uniquement sur WhatsApp.\n   */\n  async send(params: OtpSendParams): Promise<OtpSendResponse> {\n    return this.http.request<OtpSendResponse>({\n      method: 'POST',\n      path: '/otp/send',\n      body: params,\n    });\n  }\n\n  /** Vérifie un code saisi par l'utilisateur final. */\n  async verify(params: OtpVerifyParams): Promise<OtpVerifyResponse> {\n    return this.http.request<OtpVerifyResponse>({\n      method: 'POST',\n      path: '/otp/verify',\n      body: params,\n    });\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport type { ProviderDetail, ProviderListResponse } from '../types.js';\n\nexport class ProvidersResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Liste les numéros WhatsApp accessibles via l'API. */\n  async list(): Promise<ProviderListResponse> {\n    return this.http.request<ProviderListResponse>({\n      method: 'GET',\n      path: '/providers',\n    });\n  }\n\n  /** Détail d'un provider avec statistiques journalières. */\n  async get(providerId: string): Promise<ProviderDetail> {\n    return this.http.request<ProviderDetail>({\n      method: 'GET',\n      path: `/providers/${providerId}`,\n    });\n  }\n\n  /**\n   * Retourne le premier provider au statut `connected`, ou le premier de la liste.\n   * Utile pour les scripts de test / démarrage rapide.\n   */\n  async findConnected(): Promise<ProviderDetail | ProviderListResponse['providers'][number] | null> {\n    const { providers } = await this.list();\n    if (providers.length === 0) return null;\n    return (\n      providers.find((p) => p.status.toLowerCase() === 'connected') ??\n      providers[0] ??\n      null\n    );\n  }\n}\n","import { HttpClient, resolveConfig } from './http.js';\nimport { MessagesResource } from './resources/messages.js';\nimport { OtpResource } from './resources/otp.js';\nimport { ProvidersResource } from './resources/providers.js';\nimport type { ReachFlowClientOptions } from './types.js';\n\n/**\n * Client officiel pour l'API publique ReachFlow (REST v1).\n *\n * @example\n * ```ts\n * const client = new ReachFlow({ apiKey: process.env.REACHFLOW_API_KEY! });\n * const { providers } = await client.providers.list();\n * ```\n */\nexport class ReachFlow {\n  readonly messages: MessagesResource;\n  readonly providers: ProvidersResource;\n  readonly otp: OtpResource;\n\n  private readonly http: HttpClient;\n  private readonly config: ReturnType<typeof resolveConfig>;\n\n  constructor(options: ReachFlowClientOptions) {\n    if (!options.apiKey?.trim()) {\n      throw new Error('ReachFlow: apiKey is required');\n    }\n\n    this.config = resolveConfig(options);\n    this.http = new HttpClient(this.config);\n    this.messages = new MessagesResource(this.http);\n    this.providers = new ProvidersResource(this.http);\n    this.otp = new OtpResource(this.http);\n  }\n\n  /** URL de base configurée (sans `/api/v1`). */\n  get baseUrl(): string {\n    return this.config.baseUrl;\n  }\n}\n"],"mappings":"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","names":["sleep"]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@reachflow/sdk",
+  "version": "0.1.0",
+  "description": "Client officiel Node.js / TypeScript pour l'API publique ReachFlow",
+  "author": "ReachFlow",
+  "license": "MIT",
+  "homepage": "https://docs.reachflow.me/developpeurs",
+  "bugs": {
+    "url": "https://github.com/reachflow/reachflow-node/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "reachflow",
+    "whatsapp",
+    "api",
+    "sdk",
+    "otp"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reachflow/reachflow-node.git"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}