@wokuapp/sdk 0.2.0

package/dist/index.cjs

@@ -0,0 +1,1137 @@
+'use strict';
+
+// src/core/errors.ts
+var WokuError = class extends Error {
+  constructor(message, options) {
+    super(message);
+    this.name = "WokuError";
+    this.code = options?.code;
+    if (options?.cause !== void 0) {
+      this.cause = options.cause;
+    }
+  }
+};
+var WokuConnectionError = class extends WokuError {
+  constructor(message, options) {
+    super(message, {
+      code: options?.code ?? "connection_error",
+      cause: options?.cause
+    });
+    this.name = "WokuConnectionError";
+  }
+};
+var WokuTimeoutError = class extends WokuConnectionError {
+  constructor(message = "Request timed out") {
+    super(message, { code: "timeout" });
+    this.name = "WokuTimeoutError";
+  }
+};
+var WokuAPIError = class _WokuAPIError extends WokuError {
+  constructor(status, body, message, requestId, code, retryAfterSeconds) {
+    super(message, { code: code ?? codeForStatus(status) });
+    this.name = "WokuAPIError";
+    this.status = status;
+    this.body = body;
+    this.requestId = requestId;
+    this.retryAfterSeconds = retryAfterSeconds ?? retryAfterFromBody(body);
+  }
+  /** Build the most specific error subclass for a status + body. */
+  static from(status, body, requestId, retryAfterSeconds) {
+    const message = messageFrom(status, body, requestId);
+    const ra = retryAfterSeconds;
+    switch (true) {
+      case status === 400:
+        return new BadRequestError(status, body, message, requestId, void 0, ra);
+      case status === 401:
+        return new AuthenticationError(status, body, message, requestId, void 0, ra);
+      case status === 403:
+        return new PermissionDeniedError(status, body, message, requestId, void 0, ra);
+      case status === 404:
+        return new NotFoundError(status, body, message, requestId, void 0, ra);
+      case status === 409:
+        return new ConflictError(status, body, message, requestId, void 0, ra);
+      case status === 422:
+        return new UnprocessableEntityError(status, body, message, requestId, void 0, ra);
+      case status === 429:
+        return new RateLimitError(status, body, message, requestId, void 0, ra);
+      case status >= 500:
+        return new InternalServerError(status, body, message, requestId, void 0, ra);
+      default:
+        return new _WokuAPIError(status, body, message, requestId, void 0, ra);
+    }
+  }
+};
+var BadRequestError = class extends WokuAPIError {
+  constructor(...args) {
+    super(...args);
+    this.name = "BadRequestError";
+  }
+};
+var AuthenticationError = class extends WokuAPIError {
+  constructor(...args) {
+    super(...args);
+    this.name = "AuthenticationError";
+  }
+};
+var PermissionDeniedError = class extends WokuAPIError {
+  constructor(...args) {
+    super(...args);
+    this.name = "PermissionDeniedError";
+  }
+};
+var NotFoundError = class extends WokuAPIError {
+  constructor(...args) {
+    super(...args);
+    this.name = "NotFoundError";
+  }
+};
+var ConflictError = class extends WokuAPIError {
+  constructor(...args) {
+    super(...args);
+    this.name = "ConflictError";
+  }
+};
+var UnprocessableEntityError = class extends WokuAPIError {
+  constructor(...args) {
+    super(...args);
+    this.name = "UnprocessableEntityError";
+  }
+};
+var RateLimitError = class extends WokuAPIError {
+  constructor(...args) {
+    super(...args);
+    this.name = "RateLimitError";
+  }
+};
+var InternalServerError = class extends WokuAPIError {
+  constructor(...args) {
+    super(...args);
+    this.name = "InternalServerError";
+  }
+};
+var retryAfterFromBody = (body) => body && typeof body === "object" && typeof body.retryAfter === "number" ? body.retryAfter : void 0;
+var codeForStatus = (status) => {
+  const map = {
+    400: "bad_request",
+    401: "authentication_error",
+    403: "permission_denied",
+    404: "not_found",
+    409: "conflict",
+    422: "unprocessable_entity",
+    429: "rate_limited"
+  };
+  return map[status] ?? (status >= 500 ? "internal_server_error" : "api_error");
+};
+var messageFrom = (status, body, requestId) => {
+  let detail = `HTTP ${status}`;
+  if (typeof body === "string" && body.trim()) {
+    detail = body.trim();
+  } else if (body && typeof body === "object") {
+    const { message } = body;
+    if (Array.isArray(message)) detail = message.join(", ");
+    else if (typeof message === "string" && message) detail = message;
+    else if (typeof body.error === "string") detail = body.error;
+  }
+  return requestId ? `${status} ${detail} (request_id: ${requestId})` : `${status} ${detail}`;
+};
+
+// src/core/pagination.ts
+var isPageResponse = (value) => typeof value === "object" && value !== null && Array.isArray(value.data) && typeof value.total === "number";
+var Page = class {
+  constructor(response, fetchPage, options) {
+    this.fetchPage = fetchPage;
+    this.options = options;
+    this.data = response.data;
+    this.total = response.total;
+    this.page = response.page;
+    this.limit = response.limit;
+  }
+  /** Whether another page exists after this one. */
+  hasNextPage() {
+    if (this.limit <= 0) return false;
+    return this.page * this.limit < this.total;
+  }
+  /** Fetch the next page (throws if there is none — guard with hasNextPage). */
+  getNextPage() {
+    if (!this.hasNextPage()) {
+      throw new RangeError("No next page");
+    }
+    return this.fetchPage(this.page + 1, this.options);
+  }
+  /** Yield every item across all pages, fetching lazily as needed. */
+  async *[Symbol.asyncIterator]() {
+    for await (const page of walkPages(this)) {
+      for (const item of page.data) yield item;
+    }
+  }
+  /** Yield each Page, fetching lazily as needed. */
+  iterPages() {
+    return walkPages(this);
+  }
+};
+async function* walkPages(start) {
+  let current = start;
+  for (; ; ) {
+    yield current;
+    if (!current.hasNextPage()) return;
+    current = await current.getNextPage();
+  }
+}
+
+// src/core/client.ts
+var DEFAULT_BASE_URL = "https://clientapi.woku.app";
+var DEFAULT_TIMEOUT = 6e4;
+var DEFAULT_MAX_RETRIES = 2;
+var RETRY_BASE_MS = 500;
+var RETRY_CAP_MS = 8e3;
+var RETRYABLE_STATUS = /* @__PURE__ */ new Set([408, 429, 500, 502, 503, 504]);
+var SDK_VERSION = "0.1.0";
+var randomId = () => {
+  const c = globalThis.crypto;
+  if (c?.randomUUID) return c.randomUUID();
+  return `idmp_${Date.now().toString(36)}${Math.random().toString(36).slice(2, 12)}`;
+};
+var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var WokuClient = class {
+  constructor(options = {}) {
+    const apiKey = options.apiKey ?? globalThis.process?.env?.WOKU_API_KEY;
+    if (!apiKey) {
+      throw new WokuError(
+        "Missing API key: pass { apiKey } or set WOKU_API_KEY.",
+        { code: "config_error" }
+      );
+    }
+    if (!options.dangerouslyAllowBrowser && isBrowser()) {
+      throw new WokuError(
+        "The Woku SDK is server-only: the secret key must not run in a browser. Pass { dangerouslyAllowBrowser: true } only if you fully control the runtime.",
+        { code: "config_error" }
+      );
+    }
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    if (!fetchImpl) {
+      throw new WokuError(
+        "No fetch implementation available; pass { fetch }.",
+        {
+          code: "config_error"
+        }
+      );
+    }
+    this.apiKey = apiKey;
+    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
+    this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    this.fetch = fetchImpl;
+    this.defaultHeaders = options.defaultHeaders ?? {};
+  }
+  /** Issue one request and return the parsed JSON body typed as `T`. */
+  async request(method, path, args = {}) {
+    const url = this.buildUrl(path, args.query);
+    const idempotencyKey = args.idempotencyKey ?? (args.idempotent && method.toUpperCase() === "POST" ? randomId() : void 0);
+    const headers = this.buildHeaders(method, { ...args, idempotencyKey });
+    const bodyText = args.body === void 0 ? void 0 : JSON.stringify(args.body);
+    const maxRetries = args.maxRetries ?? this.maxRetries;
+    const timeout = args.timeout ?? this.timeout;
+    const retryable = method.toUpperCase() === "GET" || Boolean(headers["X-Woku-Idempotency-Key"]);
+    let attempt = 0;
+    for (; ; ) {
+      try {
+        const { status, body, requestId, retryAfterSeconds } = await this.send(
+          url,
+          method,
+          headers,
+          bodyText,
+          timeout,
+          args.signal
+        );
+        if (status >= 200 && status < 300) {
+          return body;
+        }
+        const apiError = WokuAPIError.from(
+          status,
+          body,
+          requestId,
+          retryAfterSeconds
+        );
+        if (retryable && attempt < maxRetries && RETRYABLE_STATUS.has(status)) {
+          await sleep(this.backoff(attempt, apiError));
+          attempt += 1;
+          continue;
+        }
+        throw apiError;
+      } catch (error) {
+        if (error instanceof WokuAPIError) throw error;
+        const connError = toConnectionError(error);
+        if (connError.code === "aborted") throw connError;
+        if (retryable && attempt < maxRetries) {
+          await sleep(this.backoff(attempt));
+          attempt += 1;
+          continue;
+        }
+        throw connError;
+      }
+    }
+  }
+  /**
+   * Issue a GET that returns a paginated envelope and wrap it as a {@link Page}.
+   * `params` accepts any plain object (a resource's typed params interface).
+   */
+  async getPage(path, params, opts) {
+    const base = params ?? {};
+    const query = { ...base, ...opts?.query };
+    const response = await this.request("get", path, {
+      ...opts,
+      query
+    });
+    const envelope = isPageResponse(response) ? response : {
+      data: response ?? [],
+      total: Array.isArray(response) ? response.length : 0,
+      page: 1,
+      limit: Array.isArray(response) ? response.length : 0
+    };
+    return new Page(
+      envelope,
+      (page, pageOpts) => this.getPage(path, { ...base, page }, { ...opts, ...pageOpts }),
+      opts
+    );
+  }
+  buildUrl(path, query) {
+    const url = `${this.baseURL}${path.startsWith("/") ? path : `/${path}`}`;
+    if (!query) return url;
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+      if (value === void 0 || value === null) continue;
+      if (Array.isArray(value)) {
+        for (const item of value) search.append(key, String(item));
+      } else {
+        search.append(key, String(value));
+      }
+    }
+    const qs = search.toString();
+    return qs ? `${url}?${qs}` : url;
+  }
+  buildHeaders(method, args) {
+    const headers = {
+      Accept: "application/json",
+      "User-Agent": `woku-sdk-js/${SDK_VERSION}`,
+      ...this.defaultHeaders,
+      ...args.headers
+    };
+    headers["Authorization"] = `Bearer ${this.apiKey}`;
+    if (args.body !== void 0) {
+      headers["Content-Type"] = "application/json";
+    }
+    if (args.idempotencyKey !== void 0 && method.toUpperCase() === "POST") {
+      headers["X-Woku-Idempotency-Key"] = args.idempotencyKey;
+    }
+    return headers;
+  }
+  async send(url, method, headers, body, timeout, signal) {
+    const controller = new AbortController();
+    let timedOut = false;
+    const timer = setTimeout(() => {
+      timedOut = true;
+      controller.abort();
+    }, timeout);
+    const onExternalAbort = () => controller.abort();
+    if (signal) {
+      if (signal.aborted) controller.abort();
+      else signal.addEventListener("abort", onExternalAbort);
+    }
+    try {
+      const response = await this.fetch(url, {
+        method: method.toUpperCase(),
+        headers,
+        body,
+        signal: controller.signal
+      });
+      const text = await response.text();
+      return {
+        status: response.status,
+        body: parseBody(text),
+        requestId: requestIdFrom(response.headers),
+        retryAfterSeconds: retryAfterFromHeaders(response.headers)
+      };
+    } catch (error) {
+      if (timedOut) throw new WokuTimeoutError();
+      if (signal?.aborted) {
+        throw new WokuConnectionError("Request aborted", { code: "aborted" });
+      }
+      throw error;
+    } finally {
+      clearTimeout(timer);
+      if (signal) signal.removeEventListener("abort", onExternalAbort);
+    }
+  }
+  backoff(attempt, apiError) {
+    const retryAfter = apiError && typeof apiError.retryAfterSeconds === "number" ? apiError.retryAfterSeconds * 1e3 : void 0;
+    if (retryAfter !== void 0) return Math.min(retryAfter, RETRY_CAP_MS);
+    const ceiling = Math.min(RETRY_CAP_MS, RETRY_BASE_MS * 2 ** attempt);
+    return Math.random() * ceiling;
+  }
+};
+var isBrowser = () => typeof globalThis.document !== "undefined";
+var parseBody = (text) => {
+  if (!text) return void 0;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+};
+var requestIdFrom = (headers) => headers.get("x-request-id") ?? headers.get("request-id") ?? headers.get("x-woku-request-id") ?? void 0;
+var retryAfterFromHeaders = (headers) => {
+  const raw = headers.get("retry-after");
+  if (!raw) return void 0;
+  const seconds = Number(raw);
+  if (Number.isFinite(seconds)) return Math.max(0, seconds);
+  const when = Date.parse(raw);
+  if (!Number.isNaN(when)) return Math.max(0, (when - Date.now()) / 1e3);
+  return void 0;
+};
+var toConnectionError = (error) => {
+  if (error instanceof WokuConnectionError) return error;
+  const message = error instanceof Error ? error.message : "Network request failed";
+  return new WokuConnectionError(message, { cause: error });
+};
+
+// src/resources/trackers.ts
+var Trackers = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** List the company tracker definitions (paginated). */
+  list(params, opts) {
+    return this.client.getPage("/v1/external-trackers", params, opts);
+  }
+  /** Create a tracker definition (idempotent). */
+  create(body, opts) {
+    return this.client.request("post", "/v1/external-trackers", {
+      ...opts,
+      body,
+      idempotent: true
+    });
+  }
+  /** Get one tracker definition. */
+  get(id, opts) {
+    return this.client.request(
+      "get",
+      `/v1/external-trackers/${id}`,
+      opts
+    );
+  }
+  /** Update a tracker definition. */
+  update(id, body, opts) {
+    return this.client.request(
+      "patch",
+      `/v1/external-trackers/${id}`,
+      { ...opts, body }
+    );
+  }
+  /** Activate a tracker definition. */
+  activate(id, opts) {
+    return this.client.request(
+      "patch",
+      `/v1/external-trackers/${id}/activate`,
+      opts
+    );
+  }
+  /** Deactivate a tracker definition. */
+  deactivate(id, opts) {
+    return this.client.request(
+      "patch",
+      `/v1/external-trackers/${id}/deactivate`,
+      opts
+    );
+  }
+  /** Search VoC entities whose trackers match every filter (AND). */
+  searchEntities(body, opts) {
+    return this.client.request(
+      "post",
+      "/v1/external-trackers/search-entities",
+      { ...opts, body }
+    );
+  }
+  /** List the tracker values assigned to a woku. */
+  listWokuValues(wokuId, opts) {
+    return this.client.request(
+      "get",
+      `/v1/external-trackers/wokus/${wokuId}`,
+      opts
+    );
+  }
+  /** Assign (upsert) a tracker value to a woku by tracker name. */
+  assignToWoku(wokuId, body, opts) {
+    return this.client.request(
+      "post",
+      `/v1/external-trackers/wokus/${wokuId}`,
+      { ...opts, body, idempotent: true }
+    );
+  }
+  /** Remove a tracker value from a woku by tracker name. */
+  removeFromWoku(wokuId, trackerName, opts) {
+    return this.client.request(
+      "delete",
+      `/v1/external-trackers/wokus/${wokuId}/${encodeURIComponent(trackerName)}`,
+      opts
+    );
+  }
+  /** Search wokus by an exact `(tracker name, value)` pair (paginated). */
+  searchWokus(params, opts) {
+    return this.client.getPage(
+      "/v1/external-trackers/search",
+      params,
+      opts
+    );
+  }
+  /** List the tracker values assigned to a VoC entity (nps/csat/ces/form/flow). */
+  listEntityValues(entityType, id, opts) {
+    return this.client.request(
+      "get",
+      `/v1/external-trackers/${entityType}/${id}`,
+      opts
+    );
+  }
+  /** Assign (upsert) a tracker value to a VoC entity by tracker name. */
+  assignToEntity(entityType, id, body, opts) {
+    return this.client.request(
+      "post",
+      `/v1/external-trackers/${entityType}/${id}`,
+      { ...opts, body, idempotent: true }
+    );
+  }
+  /** Remove a tracker value from a VoC entity by tracker name. */
+  removeFromEntity(entityType, id, trackerName, opts) {
+    return this.client.request(
+      "delete",
+      `/v1/external-trackers/${entityType}/${id}/${encodeURIComponent(trackerName)}`,
+      opts
+    );
+  }
+};
+
+// src/resources/voc-tools.ts
+var NpsTools = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params, opts) {
+    return this.client.getPage("/v1/nps-tools", params, opts);
+  }
+  create(body, opts) {
+    return this.client.request("post", "/v1/nps-tools", {
+      ...opts,
+      body,
+      idempotent: true
+    });
+  }
+  get(id, opts) {
+    return this.client.request("get", `/v1/nps-tool/${id}`, opts);
+  }
+  update(id, body, opts) {
+    return this.client.request("patch", `/v1/nps-tools/${id}`, {
+      ...opts,
+      body
+    });
+  }
+  delete(id, opts) {
+    return this.client.request(
+      "delete",
+      `/v1/nps-tools/${id}`,
+      opts
+    );
+  }
+};
+var CsatTools = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params, opts) {
+    return this.client.getPage("/v1/csat-tools", params, opts);
+  }
+  create(body, opts) {
+    return this.client.request("post", "/v1/csat-tools", {
+      ...opts,
+      body,
+      idempotent: true
+    });
+  }
+  get(id, opts) {
+    return this.client.request("get", `/v1/csat-tool/${id}`, opts);
+  }
+  update(id, body, opts) {
+    return this.client.request("patch", `/v1/csat-tools/${id}`, {
+      ...opts,
+      body
+    });
+  }
+  delete(id, opts) {
+    return this.client.request(
+      "delete",
+      `/v1/csat-tools/${id}`,
+      opts
+    );
+  }
+};
+var CesTools = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params, opts) {
+    return this.client.getPage("/v1/ces-tools", params, opts);
+  }
+  create(body, opts) {
+    return this.client.request("post", "/v1/ces-tools", {
+      ...opts,
+      body,
+      idempotent: true
+    });
+  }
+  get(id, opts) {
+    return this.client.request("get", `/v1/ces-tool/${id}`, opts);
+  }
+  update(id, body, opts) {
+    return this.client.request("patch", `/v1/ces-tools/${id}`, {
+      ...opts,
+      body
+    });
+  }
+  delete(id, opts) {
+    return this.client.request(
+      "delete",
+      `/v1/ces-tools/${id}`,
+      opts
+    );
+  }
+};
+
+// src/resources/surveys.ts
+var Nps = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Send the NPS survey by email or WhatsApp (idempotent). */
+  sendInvitations(body, opts) {
+    return this.client.request(
+      "post",
+      "/v1/nps/invitations",
+      {
+        ...opts,
+        body,
+        idempotent: true
+      }
+    );
+  }
+  /** List NPS responses (paginated). */
+  listResponses(params, opts) {
+    return this.client.getPage("/v1/nps", params, opts);
+  }
+  /** Get one NPS response. */
+  getResponse(id, opts) {
+    return this.client.request("get", `/v1/nps/${id}`, opts);
+  }
+};
+var Csat = class {
+  constructor(client) {
+    this.client = client;
+  }
+  sendInvitations(body, opts) {
+    return this.client.request(
+      "post",
+      "/v1/csat/invitations",
+      { ...opts, body, idempotent: true }
+    );
+  }
+  listResponses(params, opts) {
+    return this.client.getPage("/v1/csat", params, opts);
+  }
+  getResponse(id, opts) {
+    return this.client.request("get", `/v1/csat/${id}`, opts);
+  }
+};
+var Ces = class {
+  constructor(client) {
+    this.client = client;
+  }
+  sendInvitations(body, opts) {
+    return this.client.request(
+      "post",
+      "/v1/ces/invitations",
+      {
+        ...opts,
+        body,
+        idempotent: true
+      }
+    );
+  }
+  listResponses(params, opts) {
+    return this.client.getPage("/v1/ces", params, opts);
+  }
+  getResponse(id, opts) {
+    return this.client.request("get", `/v1/ces/${id}`, opts);
+  }
+};
+
+// src/resources/wokus.ts
+var Wokus = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params, opts) {
+    return this.client.getPage("/v1/wokus", params, opts);
+  }
+  create(body, opts) {
+    return this.client.request("post", "/v1/wokus", {
+      ...opts,
+      body,
+      idempotent: true
+    });
+  }
+  /** Get one woku with aggregated review stats. */
+  get(id, opts) {
+    return this.client.request("get", `/v1/wokus/${id}`, opts);
+  }
+  update(id, body, opts) {
+    return this.client.request("patch", `/v1/wokus/${id}`, {
+      ...opts,
+      body
+    });
+  }
+  delete(id, opts) {
+    return this.client.request(
+      "delete",
+      `/v1/wokus/${id}`,
+      opts
+    );
+  }
+  /** Apply the boolean settings idempotently (closed/reviewsDisabled/...). */
+  updateSettings(id, body, opts) {
+    return this.client.request("patch", `/v1/wokus/${id}/settings`, {
+      ...opts,
+      body
+    });
+  }
+  /** Move the woku into a folder, or to the root with `{ folderId: null }`. */
+  move(id, body, opts) {
+    return this.client.request("patch", `/v1/wokus/${id}/move`, {
+      ...opts,
+      body
+    });
+  }
+  /** List the reviews of a woku (paginated). */
+  listReviews(id, params, opts) {
+    return this.client.getPage(
+      `/v1/wokus/${id}/reviews`,
+      params,
+      opts
+    );
+  }
+  /** Send a woku review invitation by email or WhatsApp (idempotent). */
+  sendInvitations(id, body, opts) {
+    return this.client.request(
+      "post",
+      `/v1/wokus/${id}/invitations`,
+      { ...opts, body, idempotent: true }
+    );
+  }
+  /** Share a woku review link by email. */
+  share(id, body, opts) {
+    return this.client.request("post", `/v1/wokus/${id}/share`, {
+      ...opts,
+      body
+    });
+  }
+};
+
+// src/resources/forms.ts
+var Forms = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params, opts) {
+    return this.client.getPage("/v1/forms", params, opts);
+  }
+  get(id, opts) {
+    return this.client.request("get", `/v1/forms/${id}`, opts);
+  }
+  /** List the responses of a form (paginated). */
+  listResponses(id, params, opts) {
+    return this.client.getPage(
+      `/v1/forms/${id}/responses`,
+      params,
+      opts
+    );
+  }
+  /** Send a form by email or WhatsApp (idempotent). */
+  sendInvitations(id, body, opts) {
+    return this.client.request(
+      "post",
+      `/v1/forms/${id}/invitations`,
+      { ...opts, body, idempotent: true }
+    );
+  }
+};
+
+// src/resources/flows.ts
+var Flows = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params, opts) {
+    return this.client.getPage("/v1/flows", params, opts);
+  }
+  get(id, opts) {
+    return this.client.request("get", `/v1/flows/${id}`, opts);
+  }
+};
+
+// src/resources/action-plans.ts
+var ActionPlans = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params, opts) {
+    return this.client.getPage("/v1/action-plans", params, opts);
+  }
+  get(id, opts) {
+    return this.client.request(
+      "get",
+      `/v1/action-plans/${id}`,
+      opts
+    );
+  }
+  /** The plan timeline (events, oldest first). */
+  events(id, opts) {
+    return this.client.request(
+      "get",
+      `/v1/action-plans/${id}/events`,
+      opts
+    );
+  }
+  /** The plan AI conversation (read-only). */
+  getConversation(id, opts) {
+    return this.client.request(
+      "get",
+      `/v1/action-plans/${id}/conversation`,
+      opts
+    );
+  }
+  /**
+   * Reply to the plan AI agent. Each reply is a paid AI turn (`confirm:true` is
+   * sent automatically); the reply is composed asynchronously, so poll
+   * {@link getConversation} until `busy` is false.
+   */
+  reply(id, text, opts) {
+    return this.client.request(
+      "post",
+      `/v1/action-plans/${id}/conversation`,
+      { ...opts, body: { text, confirm: true } }
+    );
+  }
+  /** Send an approved plan to a destination (jira/monday/clickup/notion/internal). */
+  send(id, body, opts) {
+    return this.client.request(
+      "post",
+      `/v1/action-plans/${id}/send`,
+      { ...opts, body }
+    );
+  }
+  createTask(id, body, opts) {
+    return this.client.request(
+      "post",
+      `/v1/action-plans/${id}/tasks`,
+      { ...opts, body, idempotent: true }
+    );
+  }
+  updateTask(id, taskId, body, opts) {
+    return this.client.request(
+      "patch",
+      `/v1/action-plans/${id}/tasks/${taskId}`,
+      { ...opts, body }
+    );
+  }
+  reorderTasks(id, body, opts) {
+    return this.client.request(
+      "patch",
+      `/v1/action-plans/${id}/tasks/reorder`,
+      { ...opts, body }
+    );
+  }
+  deleteTask(id, taskId, opts) {
+    return this.client.request(
+      "delete",
+      `/v1/action-plans/${id}/tasks/${taskId}`,
+      opts
+    );
+  }
+  approve(id, opts) {
+    return this.status(id, "approve", opts);
+  }
+  reopen(id, opts) {
+    return this.status(id, "reopen", opts);
+  }
+  cancel(id, opts) {
+    return this.status(id, "cancel", opts);
+  }
+  complete(id, opts) {
+    return this.status(id, "complete", opts);
+  }
+  resume(id, opts) {
+    return this.status(id, "resume", opts);
+  }
+  status(id, action, opts) {
+    return this.client.request(
+      "post",
+      `/v1/action-plans/${id}/${action}`,
+      opts
+    );
+  }
+};
+var ActionPlanGroups = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params, opts) {
+    return this.client.request("get", "/v1/action-plan-groups", {
+      ...opts,
+      query: { ...params, ...opts?.query }
+    });
+  }
+  /** Get one group with its embedded stats. */
+  get(id, opts) {
+    return this.client.request(
+      "get",
+      `/v1/action-plan-groups/${id}`,
+      opts
+    );
+  }
+  create(body, opts) {
+    return this.client.request("post", "/v1/action-plan-groups", {
+      ...opts,
+      body,
+      idempotent: true
+    });
+  }
+  update(id, body, opts) {
+    return this.client.request(
+      "patch",
+      `/v1/action-plan-groups/${id}`,
+      { ...opts, body }
+    );
+  }
+  setEnabled(id, enabled, opts) {
+    return this.client.request(
+      "patch",
+      `/v1/action-plan-groups/${id}/enabled`,
+      { ...opts, body: { enabled } }
+    );
+  }
+  delete(id, opts) {
+    return this.client.request(
+      "delete",
+      `/v1/action-plan-groups/${id}`,
+      opts
+    );
+  }
+};
+
+// src/resources/tickets.ts
+var Tickets = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params, opts) {
+    return this.client.getPage("/v1/tickets", params, opts);
+  }
+  /** Aggregate counts by tool and by SAC destination. */
+  stats(params, opts) {
+    return this.client.request("get", "/v1/tickets/stats", {
+      ...opts,
+      query: { ...params, ...opts?.query }
+    });
+  }
+  get(id, opts) {
+    return this.client.request("get", `/v1/tickets/${id}`, opts);
+  }
+  update(id, body, opts) {
+    return this.client.request("patch", `/v1/tickets/${id}`, {
+      ...opts,
+      body
+    });
+  }
+};
+var TicketDestinations = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(opts) {
+    return this.client.request(
+      "get",
+      "/v1/ticket-destinations",
+      opts
+    );
+  }
+  get(id, opts) {
+    return this.client.request(
+      "get",
+      `/v1/ticket-destinations/${id}`,
+      opts
+    );
+  }
+  create(body, opts) {
+    return this.client.request("post", "/v1/ticket-destinations", {
+      ...opts,
+      body,
+      idempotent: true
+    });
+  }
+  update(id, body, opts) {
+    return this.client.request(
+      "patch",
+      `/v1/ticket-destinations/${id}`,
+      { ...opts, body }
+    );
+  }
+  delete(id, opts) {
+    return this.client.request(
+      "delete",
+      `/v1/ticket-destinations/${id}`,
+      opts
+    );
+  }
+  /**
+   * Send a real connectivity test to a saved destination. Requires
+   * `confirm: true` (the test reaches the live destination).
+   */
+  test(id, opts) {
+    return this.client.request(
+      "post",
+      `/v1/ticket-destinations/${id}/test`,
+      { ...opts, body: { confirm: true } }
+    );
+  }
+};
+
+// src/resources/dispatches.ts
+var Dispatches = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** List the invitation dispatches (delivery status, no recipient PII). */
+  list(params, opts) {
+    return this.client.getPage("/v1/dispatches", params, opts);
+  }
+  /** Response-rate metrics over the dispatches. */
+  stats(params, opts) {
+    return this.client.request("get", "/v1/dispatches/stats", {
+      ...opts,
+      query: { ...params, ...opts?.query }
+    });
+  }
+};
+
+// src/resources/reports.ts
+var Reports = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Company-level NPS report. */
+  companyNps(params, opts) {
+    return this.client.request("get", "/v1/reports/company-nps", {
+      ...opts,
+      query: { ...params, ...opts?.query }
+    });
+  }
+  /** NPS report for one tool. */
+  npsTool(npsToolId, params, opts) {
+    return this.client.request(
+      "get",
+      `/v1/reports/nps-tool/${npsToolId}`,
+      { ...opts, query: { ...params, ...opts?.query } }
+    );
+  }
+};
+
+// src/resources/company.ts
+var Company = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Get the caller company. */
+  me(opts) {
+    return this.client.request("get", "/v1/companies/me", opts);
+  }
+  /** Rotate the secret key. The returned key replaces the current one. */
+  rotateKey(opts) {
+    return this.client.request(
+      "post",
+      "/v1/companies/me/rotate-key",
+      opts
+    );
+  }
+  /** Revoke the secret key (all subsequent requests will be unauthorized). */
+  revokeKey(opts) {
+    return this.client.request(
+      "post",
+      "/v1/companies/me/revoke-key",
+      opts
+    );
+  }
+};
+
+// src/resources/quarantines.ts
+var Quarantines = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Check whether a contact is quarantined. */
+  check(params, opts) {
+    return this.client.request("get", "/v1/quarantines/check", {
+      ...opts,
+      query: { ...params, ...opts?.query }
+    });
+  }
+};
+
+// src/woku.ts
+var Woku = class {
+  constructor(options) {
+    const opts = typeof options === "string" ? { apiKey: options } : options ?? {};
+    this.client = new WokuClient(opts);
+    this.trackers = new Trackers(this.client);
+    this.npsTools = new NpsTools(this.client);
+    this.csatTools = new CsatTools(this.client);
+    this.cesTools = new CesTools(this.client);
+    this.nps = new Nps(this.client);
+    this.csat = new Csat(this.client);
+    this.ces = new Ces(this.client);
+    this.wokus = new Wokus(this.client);
+    this.forms = new Forms(this.client);
+    this.flows = new Flows(this.client);
+    this.actionPlans = new ActionPlans(this.client);
+    this.actionPlanGroups = new ActionPlanGroups(this.client);
+    this.tickets = new Tickets(this.client);
+    this.ticketDestinations = new TicketDestinations(this.client);
+    this.dispatches = new Dispatches(this.client);
+    this.reports = new Reports(this.client);
+    this.company = new Company(this.client);
+    this.quarantines = new Quarantines(this.client);
+  }
+};
+
+exports.AuthenticationError = AuthenticationError;
+exports.BadRequestError = BadRequestError;
+exports.ConflictError = ConflictError;
+exports.InternalServerError = InternalServerError;
+exports.NotFoundError = NotFoundError;
+exports.Page = Page;
+exports.PermissionDeniedError = PermissionDeniedError;
+exports.RateLimitError = RateLimitError;
+exports.UnprocessableEntityError = UnprocessableEntityError;
+exports.Woku = Woku;
+exports.WokuAPIError = WokuAPIError;
+exports.WokuClient = WokuClient;
+exports.WokuConnectionError = WokuConnectionError;
+exports.WokuError = WokuError;
+exports.WokuTimeoutError = WokuTimeoutError;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map