@wokuapp/sdk 0.2.2 → 0.3.0

package/dist/index.js

@@ -1,3 +1,28 @@
+// src/resources/media.ts
+var Media = class {
+  constructor(client) {
+    this.client = client;
+  }
+  upload(input, opts) {
+    const file = new Blob(
+      [input.file instanceof Blob ? input.file : new Uint8Array(input.file)],
+      {
+        type: input.contentType ?? (input.file instanceof Blob ? input.file.type : "")
+      }
+    );
+    const body = new FormData();
+    body.append("file", file, input.filename);
+    return this.client.request("post", "/v1/woku-media", {
+      ...opts,
+      body,
+      maxRetries: 0
+    });
+  }
+};
+
+// package.json
+var version = "0.3.0";
+
 // src/core/errors.ts
 var WokuError = class extends Error {
   constructor(message, options) {
@@ -39,23 +64,95 @@ var WokuAPIError = class _WokuAPIError extends WokuError {
     const ra = retryAfterSeconds;
     switch (true) {
       case status === 400:
-        return new BadRequestError(status, body, message, requestId, void 0, ra);
+        return new BadRequestError(
+          status,
+          body,
+          message,
+          requestId,
+          void 0,
+          ra
+        );
       case status === 401:
-        return new AuthenticationError(status, body, message, requestId, void 0, ra);
+        return new AuthenticationError(
+          status,
+          body,
+          message,
+          requestId,
+          void 0,
+          ra
+        );
       case status === 403:
-        return new PermissionDeniedError(status, body, message, requestId, void 0, ra);
+        return new PermissionDeniedError(
+          status,
+          body,
+          message,
+          requestId,
+          void 0,
+          ra
+        );
       case status === 404:
-        return new NotFoundError(status, body, message, requestId, void 0, ra);
+        return new NotFoundError(
+          status,
+          body,
+          message,
+          requestId,
+          void 0,
+          ra
+        );
       case status === 409:
-        return new ConflictError(status, body, message, requestId, void 0, ra);
+        return new ConflictError(
+          status,
+          body,
+          message,
+          requestId,
+          void 0,
+          ra
+        );
+      case status === 413:
+        return new PayloadTooLargeError(
+          status,
+          body,
+          message,
+          requestId,
+          void 0,
+          ra
+        );
       case status === 422:
-        return new UnprocessableEntityError(status, body, message, requestId, void 0, ra);
+        return new UnprocessableEntityError(
+          status,
+          body,
+          message,
+          requestId,
+          void 0,
+          ra
+        );
       case status === 429:
-        return new RateLimitError(status, body, message, requestId, void 0, ra);
+        return new RateLimitError(
+          status,
+          body,
+          message,
+          requestId,
+          void 0,
+          ra
+        );
       case status >= 500:
-        return new InternalServerError(status, body, message, requestId, void 0, ra);
+        return new InternalServerError(
+          status,
+          body,
+          message,
+          requestId,
+          void 0,
+          ra
+        );
       default:
-        return new _WokuAPIError(status, body, message, requestId, void 0, ra);
+        return new _WokuAPIError(
+          status,
+          body,
+          message,
+          requestId,
+          void 0,
+          ra
+        );
     }
   }
 };
@@ -89,6 +186,12 @@ var ConflictError = class extends WokuAPIError {
     this.name = "ConflictError";
   }
 };
+var PayloadTooLargeError = class extends WokuAPIError {
+  constructor(...args) {
+    super(...args);
+    this.name = "PayloadTooLargeError";
+  }
+};
 var UnprocessableEntityError = class extends WokuAPIError {
   constructor(...args) {
     super(...args);
@@ -107,7 +210,7 @@ var InternalServerError = class extends WokuAPIError {
     this.name = "InternalServerError";
   }
 };
-var retryAfterFromBody = (body) => body && typeof body === "object" && typeof body.retryAfter === "number" ? body.retryAfter : void 0;
+var retryAfterFromBody = (body) => body && typeof body === "object" && typeof body.retryAfter === "number" && Number.isFinite(body.retryAfter) && body.retryAfter >= 0 ? body.retryAfter : void 0;
 var codeForStatus = (status) => {
   const map = {
     400: "bad_request",
@@ -115,6 +218,7 @@ var codeForStatus = (status) => {
     403: "permission_denied",
     404: "not_found",
     409: "conflict",
+    413: "payload_too_large",
     422: "unprocessable_entity",
     429: "rate_limited"
   };
@@ -125,7 +229,7 @@ var messageFrom = (status, body, requestId) => {
   if (typeof body === "string" && body.trim()) {
     detail = body.trim();
   } else if (body && typeof body === "object") {
-    const { message } = body;
+    const message = body.message && typeof body.message === "object" && !Array.isArray(body.message) ? body.message.message : body.message;
     if (Array.isArray(message)) detail = message.join(", ");
     else if (typeof message === "string" && message) detail = message;
     else if (typeof body.error === "string") detail = body.error;
@@ -154,7 +258,13 @@ var Page = class {
     if (!this.hasNextPage()) {
       throw new RangeError("No next page");
     }
-    return this.fetchPage(this.page + 1, this.options);
+    return this.fetchPage(this.page + 1, this.options).then((next) => {
+      if (next.page <= this.page)
+        throw new WokuError("Pagination did not advance.", {
+          code: "pagination_error"
+        });
+      return next;
+    });
   }
   /** Yield every item across all pages, fetching lazily as needed. */
   async *[Symbol.asyncIterator]() {
@@ -183,13 +293,32 @@ 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 sleep = (ms, signal) => ms > 2147483647 ? sleep(2147483647, signal).then(() => sleep(ms - 2147483647, signal)) : new Promise((resolve, reject) => {
+  if (signal?.aborted) {
+    reject(
+      new WokuConnectionError("Request aborted", { code: "aborted" })
+    );
+    return;
+  }
+  const cleanup = () => signal?.removeEventListener("abort", abort);
+  const timer = setTimeout(() => {
+    cleanup();
+    resolve();
+  }, ms);
+  const abort = () => {
+    clearTimeout(timer);
+    cleanup();
+    reject(
+      new WokuConnectionError("Request aborted", { code: "aborted" })
+    );
+  };
+  signal?.addEventListener("abort", abort, { once: true });
+});
 var WokuClient = class {
   constructor(options = {}) {
     const apiKey = options.apiKey ?? globalThis.process?.env?.WOKU_API_KEY;
@@ -226,10 +355,10 @@ var WokuClient = class {
     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 bodyText = args.body === void 0 ? void 0 : args.body instanceof FormData ? args.body : 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"]);
+    const retryable = method.toUpperCase() === "GET" || method.toUpperCase() === "POST" && args.idempotent === true && Boolean(headers["X-Woku-Idempotency-Key"]);
     let attempt = 0;
     for (; ; ) {
       try {
@@ -250,8 +379,9 @@ var WokuClient = class {
           requestId,
           retryAfterSeconds
         );
+        apiError.idempotencyKey = idempotencyKey;
         if (retryable && attempt < maxRetries && RETRYABLE_STATUS.has(status)) {
-          await sleep(this.backoff(attempt, apiError));
+          await sleep(this.backoff(attempt, apiError), args.signal);
           attempt += 1;
           continue;
         }
@@ -259,9 +389,16 @@ var WokuClient = class {
       } catch (error) {
         if (error instanceof WokuAPIError) throw error;
         const connError = toConnectionError(error);
+        connError.idempotencyKey = idempotencyKey;
         if (connError.code === "aborted") throw connError;
         if (retryable && attempt < maxRetries) {
-          await sleep(this.backoff(attempt));
+          try {
+            await sleep(this.backoff(attempt), args.signal);
+          } catch (waitingError) {
+            if (waitingError instanceof WokuError)
+              waitingError.idempotencyKey = idempotencyKey;
+            throw waitingError;
+          }
           attempt += 1;
           continue;
         }
@@ -288,11 +425,25 @@ var WokuClient = class {
     };
     return new Page(
       envelope,
-      (page, pageOpts) => this.getPage(path, { ...base, page }, { ...opts, ...pageOpts }),
+      (page, pageOpts) => this.getPage(
+        path,
+        { ...query, page },
+        {
+          ...opts,
+          ...pageOpts,
+          query: { ...opts?.query, ...pageOpts?.query, page }
+        }
+      ),
       opts
     );
   }
   buildUrl(path, query) {
+    if (/^\s*[a-z][a-z0-9+.-]*:/i.test(path) || path.startsWith("//")) {
+      throw new WokuError(
+        "Use an API path relative to baseURL, not an external URL.",
+        { code: "config_error" }
+      );
+    }
     const url = `${this.baseURL}${path.startsWith("/") ? path : `/${path}`}`;
     if (!query) return url;
     const search = new URLSearchParams();
@@ -308,22 +459,35 @@ var WokuClient = class {
     return qs ? `${url}?${qs}` : url;
   }
   buildHeaders(method, args) {
-    const headers = {
+    const defaults = {
       Accept: "application/json",
-      "User-Agent": `woku-sdk-js/${SDK_VERSION}`,
-      ...this.defaultHeaders,
-      ...args.headers
+      "User-Agent": `woku-sdk-js/${version}`
     };
+    const merged = /* @__PURE__ */ new Map();
+    for (const source of [defaults, this.defaultHeaders, args.headers ?? {}]) {
+      for (const [name, value] of Object.entries(source))
+        merged.set(name.toLowerCase(), [name, value]);
+    }
+    merged.set("authorization", ["Authorization", `Bearer ${this.apiKey}`]);
+    const headers = Object.fromEntries(merged.values());
     headers["Authorization"] = `Bearer ${this.apiKey}`;
     if (args.body !== void 0) {
-      headers["Content-Type"] = "application/json";
+      for (const name of Object.keys(headers))
+        if (name.toLowerCase() === "content-type") delete headers[name];
+      if (!(args.body instanceof FormData))
+        headers["Content-Type"] = "application/json";
     }
     if (args.idempotencyKey !== void 0 && method.toUpperCase() === "POST") {
+      for (const name of Object.keys(headers))
+        if (name.toLowerCase() === "x-woku-idempotency-key")
+          delete headers[name];
       headers["X-Woku-Idempotency-Key"] = args.idempotencyKey;
     }
     return headers;
   }
   async send(url, method, headers, body, timeout, signal) {
+    if (signal?.aborted)
+      throw new WokuConnectionError("Request aborted", { code: "aborted" });
     const controller = new AbortController();
     let timedOut = false;
     const timer = setTimeout(() => {
@@ -362,7 +526,8 @@ var WokuClient = class {
   }
   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);
+    if (retryAfter !== void 0 && Number.isFinite(retryAfter) && retryAfter >= 0)
+      return retryAfter;
     const ceiling = Math.min(RETRY_CAP_MS, RETRY_BASE_MS * 2 ** attempt);
     return Math.random() * ceiling;
   }
@@ -413,7 +578,7 @@ var Trackers = class {
   get(id, opts) {
     return this.client.request(
       "get",
-      `/v1/external-trackers/${id}`,
+      `/v1/external-trackers/${encodeURIComponent(id)}`,
       opts
     );
   }
@@ -421,7 +586,7 @@ var Trackers = class {
   update(id, body, opts) {
     return this.client.request(
       "patch",
-      `/v1/external-trackers/${id}`,
+      `/v1/external-trackers/${encodeURIComponent(id)}`,
       { ...opts, body }
     );
   }
@@ -429,7 +594,7 @@ var Trackers = class {
   activate(id, opts) {
     return this.client.request(
       "patch",
-      `/v1/external-trackers/${id}/activate`,
+      `/v1/external-trackers/${encodeURIComponent(id)}/activate`,
       opts
     );
   }
@@ -437,7 +602,7 @@ var Trackers = class {
   deactivate(id, opts) {
     return this.client.request(
       "patch",
-      `/v1/external-trackers/${id}/deactivate`,
+      `/v1/external-trackers/${encodeURIComponent(id)}/deactivate`,
       opts
     );
   }
@@ -453,7 +618,7 @@ var Trackers = class {
   listWokuValues(wokuId, opts) {
     return this.client.request(
       "get",
-      `/v1/external-trackers/wokus/${wokuId}`,
+      `/v1/external-trackers/wokus/${encodeURIComponent(wokuId)}`,
       opts
     );
   }
@@ -461,15 +626,15 @@ var Trackers = class {
   assignToWoku(wokuId, body, opts) {
     return this.client.request(
       "post",
-      `/v1/external-trackers/wokus/${wokuId}`,
-      { ...opts, body, idempotent: true }
+      `/v1/external-trackers/wokus/${encodeURIComponent(wokuId)}`,
+      { ...opts, body, maxRetries: 0 }
     );
   }
   /** 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)}`,
+      `/v1/external-trackers/wokus/${encodeURIComponent(wokuId)}/${encodeURIComponent(trackerName)}`,
       opts
     );
   }
@@ -485,7 +650,7 @@ var Trackers = class {
   listEntityValues(entityType, id, opts) {
     return this.client.request(
       "get",
-      `/v1/external-trackers/${entityType}/${id}`,
+      `/v1/external-trackers/${encodeURIComponent(entityType)}/${encodeURIComponent(id)}`,
       opts
     );
   }
@@ -493,15 +658,15 @@ var Trackers = class {
   assignToEntity(entityType, id, body, opts) {
     return this.client.request(
       "post",
-      `/v1/external-trackers/${entityType}/${id}`,
-      { ...opts, body, idempotent: true }
+      `/v1/external-trackers/${encodeURIComponent(entityType)}/${encodeURIComponent(id)}`,
+      { ...opts, body, maxRetries: 0 }
     );
   }
   /** 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)}`,
+      `/v1/external-trackers/${encodeURIComponent(entityType)}/${encodeURIComponent(id)}/${encodeURIComponent(trackerName)}`,
       opts
     );
   }
@@ -523,18 +688,26 @@ var NpsTools = class {
     });
   }
   get(id, opts) {
-    return this.client.request("get", `/v1/nps-tool/${id}`, opts);
+    return this.client.request(
+      "get",
+      `/v1/nps-tool/${encodeURIComponent(id)}`,
+      opts
+    );
   }
   update(id, body, opts) {
-    return this.client.request("patch", `/v1/nps-tools/${id}`, {
-      ...opts,
-      body
-    });
+    return this.client.request(
+      "patch",
+      `/v1/nps-tools/${encodeURIComponent(id)}`,
+      {
+        ...opts,
+        body
+      }
+    );
   }
   delete(id, opts) {
     return this.client.request(
       "delete",
-      `/v1/nps-tools/${id}`,
+      `/v1/nps-tools/${encodeURIComponent(id)}`,
       opts
     );
   }
@@ -554,18 +727,26 @@ var CsatTools = class {
     });
   }
   get(id, opts) {
-    return this.client.request("get", `/v1/csat-tool/${id}`, opts);
+    return this.client.request(
+      "get",
+      `/v1/csat-tool/${encodeURIComponent(id)}`,
+      opts
+    );
   }
   update(id, body, opts) {
-    return this.client.request("patch", `/v1/csat-tools/${id}`, {
-      ...opts,
-      body
-    });
+    return this.client.request(
+      "patch",
+      `/v1/csat-tools/${encodeURIComponent(id)}`,
+      {
+        ...opts,
+        body
+      }
+    );
   }
   delete(id, opts) {
     return this.client.request(
       "delete",
-      `/v1/csat-tools/${id}`,
+      `/v1/csat-tools/${encodeURIComponent(id)}`,
       opts
     );
   }
@@ -585,18 +766,26 @@ var CesTools = class {
     });
   }
   get(id, opts) {
-    return this.client.request("get", `/v1/ces-tool/${id}`, opts);
+    return this.client.request(
+      "get",
+      `/v1/ces-tool/${encodeURIComponent(id)}`,
+      opts
+    );
   }
   update(id, body, opts) {
-    return this.client.request("patch", `/v1/ces-tools/${id}`, {
-      ...opts,
-      body
-    });
+    return this.client.request(
+      "patch",
+      `/v1/ces-tools/${encodeURIComponent(id)}`,
+      {
+        ...opts,
+        body
+      }
+    );
   }
   delete(id, opts) {
     return this.client.request(
       "delete",
-      `/v1/ces-tools/${id}`,
+      `/v1/ces-tools/${encodeURIComponent(id)}`,
       opts
     );
   }
@@ -625,7 +814,11 @@ var Nps = class {
   }
   /** Get one NPS response. */
   getResponse(id, opts) {
-    return this.client.request("get", `/v1/nps/${id}`, opts);
+    return this.client.request(
+      "get",
+      `/v1/nps/${encodeURIComponent(id)}`,
+      opts
+    );
   }
 };
 var Csat = class {
@@ -643,7 +836,11 @@ var Csat = class {
     return this.client.getPage("/v1/csat", params, opts);
   }
   getResponse(id, opts) {
-    return this.client.request("get", `/v1/csat/${id}`, opts);
+    return this.client.request(
+      "get",
+      `/v1/csat/${encodeURIComponent(id)}`,
+      opts
+    );
   }
 };
 var Ces = class {
@@ -665,7 +862,11 @@ var Ces = class {
     return this.client.getPage("/v1/ces", params, opts);
   }
   getResponse(id, opts) {
-    return this.client.request("get", `/v1/ces/${id}`, opts);
+    return this.client.request(
+      "get",
+      `/v1/ces/${encodeURIComponent(id)}`,
+      opts
+    );
   }
 };
 
@@ -681,44 +882,60 @@ var Wokus = class {
     return this.client.request("post", "/v1/wokus", {
       ...opts,
       body,
-      idempotent: true
+      maxRetries: 0
     });
   }
   /** Get one woku with aggregated review stats. */
   get(id, opts) {
-    return this.client.request("get", `/v1/wokus/${id}`, opts);
+    return this.client.request(
+      "get",
+      `/v1/wokus/${encodeURIComponent(id)}`,
+      opts
+    );
   }
   update(id, body, opts) {
-    return this.client.request("patch", `/v1/wokus/${id}`, {
-      ...opts,
-      body
-    });
+    return this.client.request(
+      "patch",
+      `/v1/wokus/${encodeURIComponent(id)}`,
+      {
+        ...opts,
+        body
+      }
+    );
   }
   delete(id, opts) {
     return this.client.request(
       "delete",
-      `/v1/wokus/${id}`,
+      `/v1/wokus/${encodeURIComponent(id)}`,
       opts
     );
   }
   /** Apply the boolean settings idempotently (closed/reviewsDisabled/...). */
   updateSettings(id, body, opts) {
-    return this.client.request("patch", `/v1/wokus/${id}/settings`, {
-      ...opts,
-      body
-    });
+    return this.client.request(
+      "patch",
+      `/v1/wokus/${encodeURIComponent(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
-    });
+    return this.client.request(
+      "patch",
+      `/v1/wokus/${encodeURIComponent(id)}/move`,
+      {
+        ...opts,
+        body
+      }
+    );
   }
   /** List the reviews of a woku (paginated). */
   listReviews(id, params, opts) {
     return this.client.getPage(
-      `/v1/wokus/${id}/reviews`,
+      `/v1/wokus/${encodeURIComponent(id)}/reviews`,
       params,
       opts
     );
@@ -727,16 +944,20 @@ var Wokus = class {
   sendInvitations(id, body, opts) {
     return this.client.request(
       "post",
-      `/v1/wokus/${id}/invitations`,
+      `/v1/wokus/${encodeURIComponent(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
-    });
+    return this.client.request(
+      "post",
+      `/v1/wokus/${encodeURIComponent(id)}/share`,
+      {
+        ...opts,
+        body
+      }
+    );
   }
 };
 
@@ -749,12 +970,16 @@ var Forms = class {
     return this.client.getPage("/v1/forms", params, opts);
   }
   get(id, opts) {
-    return this.client.request("get", `/v1/forms/${id}`, opts);
+    return this.client.request(
+      "get",
+      `/v1/forms/${encodeURIComponent(id)}`,
+      opts
+    );
   }
   /** List the responses of a form (paginated). */
   listResponses(id, params, opts) {
     return this.client.getPage(
-      `/v1/forms/${id}/responses`,
+      `/v1/forms/${encodeURIComponent(id)}/responses`,
       params,
       opts
     );
@@ -763,7 +988,7 @@ var Forms = class {
   sendInvitations(id, body, opts) {
     return this.client.request(
       "post",
-      `/v1/forms/${id}/invitations`,
+      `/v1/forms/${encodeURIComponent(id)}/invitations`,
       { ...opts, body, idempotent: true }
     );
   }
@@ -778,7 +1003,11 @@ var Flows = class {
     return this.client.getPage("/v1/flows", params, opts);
   }
   get(id, opts) {
-    return this.client.request("get", `/v1/flows/${id}`, opts);
+    return this.client.request(
+      "get",
+      `/v1/flows/${encodeURIComponent(id)}`,
+      opts
+    );
   }
 };
 
@@ -793,7 +1022,7 @@ var ActionPlans = class {
   get(id, opts) {
     return this.client.request(
       "get",
-      `/v1/action-plans/${id}`,
+      `/v1/action-plans/${encodeURIComponent(id)}`,
       opts
     );
   }
@@ -801,7 +1030,7 @@ var ActionPlans = class {
   events(id, opts) {
     return this.client.request(
       "get",
-      `/v1/action-plans/${id}/events`,
+      `/v1/action-plans/${encodeURIComponent(id)}/events`,
       opts
     );
   }
@@ -809,7 +1038,7 @@ var ActionPlans = class {
   getConversation(id, opts) {
     return this.client.request(
       "get",
-      `/v1/action-plans/${id}/conversation`,
+      `/v1/action-plans/${encodeURIComponent(id)}/conversation`,
       opts
     );
   }
@@ -821,35 +1050,35 @@ var ActionPlans = class {
   reply(id, text, opts) {
     return this.client.request(
       "post",
-      `/v1/action-plans/${id}/conversation`,
+      `/v1/action-plans/${encodeURIComponent(id)}/conversation`,
       { ...opts, body: { text, confirm: true } }
     );
   }
   createTask(id, body, opts) {
     return this.client.request(
       "post",
-      `/v1/action-plans/${id}/tasks`,
-      { ...opts, body, idempotent: true }
+      `/v1/action-plans/${encodeURIComponent(id)}/tasks`,
+      { ...opts, body, maxRetries: 0 }
     );
   }
   updateTask(id, taskId, body, opts) {
     return this.client.request(
       "patch",
-      `/v1/action-plans/${id}/tasks/${taskId}`,
+      `/v1/action-plans/${encodeURIComponent(id)}/tasks/${encodeURIComponent(taskId)}`,
       { ...opts, body }
     );
   }
   reorderTasks(id, body, opts) {
     return this.client.request(
       "patch",
-      `/v1/action-plans/${id}/tasks/reorder`,
+      `/v1/action-plans/${encodeURIComponent(id)}/tasks/reorder`,
       { ...opts, body }
     );
   }
   deleteTask(id, taskId, opts) {
     return this.client.request(
       "delete",
-      `/v1/action-plans/${id}/tasks/${taskId}`,
+      `/v1/action-plans/${encodeURIComponent(id)}/tasks/${encodeURIComponent(taskId)}`,
       opts
     );
   }
@@ -871,7 +1100,7 @@ var ActionPlans = class {
   status(id, action, opts) {
     return this.client.request(
       "post",
-      `/v1/action-plans/${id}/${action}`,
+      `/v1/action-plans/${encodeURIComponent(id)}/${action}`,
       opts
     );
   }
@@ -890,7 +1119,7 @@ var ActionPlanGroups = class {
   get(id, opts) {
     return this.client.request(
       "get",
-      `/v1/action-plan-groups/${id}`,
+      `/v1/action-plan-groups/${encodeURIComponent(id)}`,
       opts
     );
   }
@@ -898,27 +1127,27 @@ var ActionPlanGroups = class {
     return this.client.request("post", "/v1/action-plan-groups", {
       ...opts,
       body,
-      idempotent: true
+      maxRetries: 0
     });
   }
   update(id, body, opts) {
     return this.client.request(
       "patch",
-      `/v1/action-plan-groups/${id}`,
+      `/v1/action-plan-groups/${encodeURIComponent(id)}`,
       { ...opts, body }
     );
   }
   setEnabled(id, enabled, opts) {
     return this.client.request(
       "patch",
-      `/v1/action-plan-groups/${id}/enabled`,
+      `/v1/action-plan-groups/${encodeURIComponent(id)}/enabled`,
       { ...opts, body: { enabled } }
     );
   }
   delete(id, opts) {
     return this.client.request(
       "delete",
-      `/v1/action-plan-groups/${id}`,
+      `/v1/action-plan-groups/${encodeURIComponent(id)}`,
       opts
     );
   }
@@ -940,13 +1169,21 @@ var Tickets = class {
     });
   }
   get(id, opts) {
-    return this.client.request("get", `/v1/tickets/${id}`, opts);
+    return this.client.request(
+      "get",
+      `/v1/tickets/${encodeURIComponent(id)}`,
+      opts
+    );
   }
   update(id, body, opts) {
-    return this.client.request("patch", `/v1/tickets/${id}`, {
-      ...opts,
-      body
-    });
+    return this.client.request(
+      "patch",
+      `/v1/tickets/${encodeURIComponent(id)}`,
+      {
+        ...opts,
+        body
+      }
+    );
   }
 };
 var TicketDestinations = class {
@@ -963,7 +1200,7 @@ var TicketDestinations = class {
   get(id, opts) {
     return this.client.request(
       "get",
-      `/v1/ticket-destinations/${id}`,
+      `/v1/ticket-destinations/${encodeURIComponent(id)}`,
       opts
     );
   }
@@ -971,20 +1208,20 @@ var TicketDestinations = class {
     return this.client.request("post", "/v1/ticket-destinations", {
       ...opts,
       body,
-      idempotent: true
+      maxRetries: 0
     });
   }
   update(id, body, opts) {
     return this.client.request(
       "patch",
-      `/v1/ticket-destinations/${id}`,
+      `/v1/ticket-destinations/${encodeURIComponent(id)}`,
       { ...opts, body }
     );
   }
   delete(id, opts) {
     return this.client.request(
       "delete",
-      `/v1/ticket-destinations/${id}`,
+      `/v1/ticket-destinations/${encodeURIComponent(id)}`,
       opts
     );
   }
@@ -995,7 +1232,7 @@ var TicketDestinations = class {
   test(id, opts) {
     return this.client.request(
       "post",
-      `/v1/ticket-destinations/${id}/test`,
+      `/v1/ticket-destinations/${encodeURIComponent(id)}/test`,
       { ...opts, body: { confirm: true } }
     );
   }
@@ -1035,7 +1272,7 @@ var Reports = class {
   npsTool(npsToolId, params, opts) {
     return this.client.request(
       "get",
-      `/v1/reports/nps-tool/${npsToolId}`,
+      `/v1/reports/nps-tool/${encodeURIComponent(npsToolId)}`,
       { ...opts, query: { ...params, ...opts?.query } }
     );
   }
@@ -1068,6 +1305,193 @@ var Company = class {
   }
 };
 
+// src/resources/journeys.ts
+var Journeys = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Read customer entry metadata without starting or preparing an evaluation. */
+  entryInfo(journeyId, opts) {
+    return this.client.request(
+      "get",
+      `/v1/journey-entries/${encodeURIComponent(journeyId)}`,
+      opts
+    );
+  }
+  /** Prepare a first tool. Only its saved response with dispatchToken confirms entry. */
+  prepareEntry(journeyId, body, opts) {
+    return this.client.request(
+      "post",
+      `/v1/journey-entries/${encodeURIComponent(journeyId)}`,
+      { ...opts, body, maxRetries: 0 }
+    );
+  }
+  /** Every journey of your company. */
+  list(opts) {
+    return this.client.request("get", "/v1/journeys", opts);
+  }
+  /** One journey with its moments. */
+  get(journeyId, opts) {
+    return this.client.request(
+      "get",
+      `/v1/journeys/${encodeURIComponent(journeyId)}`,
+      opts
+    );
+  }
+  /**
+   * Create a journey. The response carries `webhookSecret` once and only here:
+   * it signs legacy woku_signature calls. V2 URL tokens and sender secrets
+   * are configured separately per moment. Store it securely.
+   */
+  create(body, opts) {
+    return this.client.request("post", "/v1/journeys", {
+      ...opts,
+      body,
+      idempotent: true
+    });
+  }
+  /**
+   * Rename a journey, switch it on or off, or replace its moments. Replacing
+   * the moments mints a new version; the enrollments already running keep
+   * executing the version they started with.
+   */
+  update(journeyId, body, opts) {
+    return this.client.request(
+      "patch",
+      `/v1/journeys/${encodeURIComponent(journeyId)}`,
+      {
+        ...opts,
+        body
+      }
+    );
+  }
+  /** Cursor page of exact customer cases; pass nextCursor to retrieve another page. */
+  listEnrollments(journeyId, params, opts) {
+    return this.client.request(
+      "get",
+      `/v1/journeys/${encodeURIComponent(journeyId)}/enrollments`,
+      { ...opts, query: { ...params, ...opts?.query } }
+    );
+  }
+  /** Iterate exact cases lazily, preserving options while advancing the server cursor. */
+  async *iterEnrollments(journeyId, params, opts) {
+    let query = { ...params, ...opts?.query };
+    const seen = /* @__PURE__ */ new Set();
+    for (; ; ) {
+      const page = await this.listEnrollments(journeyId, void 0, {
+        ...opts,
+        query
+      });
+      for (const item of page.items) yield item;
+      const next = page.nextCursor;
+      if (!next) return;
+      if (seen.has(next) || next === query.cursor)
+        throw new WokuError("Enrollment pagination did not advance.", {
+          code: "pagination_error"
+        });
+      seen.add(next);
+      query = { ...query, cursor: next };
+    }
+  }
+  /** History and next step for one exact participation. */
+  getEnrollment(journeyId, enrollmentId, opts) {
+    return this.client.request(
+      "get",
+      `/v1/journeys/${encodeURIComponent(journeyId)}/enrollments/${encodeURIComponent(enrollmentId)}`,
+      opts
+    );
+  }
+  /** Cancel future work for this case. Accepted provider sends cannot be recalled. */
+  stopEnrollment(journeyId, enrollmentId, body = {}, opts) {
+    return this.client.request(
+      "post",
+      `/v1/journeys/${encodeURIComponent(journeyId)}/enrollments/${encodeURIComponent(enrollmentId)}/stop`,
+      { ...opts, body, idempotent: true }
+    );
+  }
+  /** Credential readiness is not evidence that an actual webhook has arrived. */
+  connections(journeyId, opts) {
+    return this.client.request(
+      "get",
+      `/v1/journeys/${encodeURIComponent(journeyId)}/connections`,
+      opts
+    );
+  }
+  /** Replaces this moment's URL credential. Store the returned URL in the sender. */
+  async mintMomentUrl(journeyId, stageKey, opts) {
+    const result = await this.client.request(
+      "post",
+      `/v1/journeys/${encodeURIComponent(journeyId)}/moments/${encodeURIComponent(stageKey)}/url-token`,
+      { ...opts, body: {}, idempotent: true }
+    );
+    return {
+      ...result,
+      url: new URL(result.url, this.client.baseURL).toString()
+    };
+  }
+  /** Store the external sender's signing secret encrypted; it is never returned. */
+  setSenderSecret(journeyId, stageKey, senderSecret, opts) {
+    return this.client.request(
+      "post",
+      `/v1/journeys/${encodeURIComponent(journeyId)}/moments/${encodeURIComponent(stageKey)}/sender-secret`,
+      { ...opts, body: { senderSecret }, maxRetries: 0 }
+    );
+  }
+  /** Test saved payload mapping without creating a participation or sending a tool. */
+  previewMoment(journeyId, stageKey, payload, opts) {
+    return this.client.request(
+      "post",
+      `/v1/journeys/${encodeURIComponent(journeyId)}/moments/${encodeURIComponent(stageKey)}/preview`,
+      { ...opts, body: { payload }, maxRetries: 0 }
+    );
+  }
+  /** Delete a journey. What it already started keeps its own history. */
+  delete(journeyId, opts) {
+    return this.client.request(
+      "delete",
+      `/v1/journeys/${encodeURIComponent(journeyId)}`,
+      opts
+    );
+  }
+  /**
+   * Mint a new signing secret. The previous one stays valid until the next
+   * rotation, so senders can be updated without a gap.
+   */
+  rotateWebhookSecret(journeyId, opts) {
+    return this.client.request(
+      "post",
+      `/v1/journeys/${encodeURIComponent(journeyId)}/webhook-secret`,
+      { ...opts, body: {}, maxRetries: 0 }
+    );
+  }
+  /**
+   * Start the journey for one subject. Enrolling the same person for a later
+   * cycle reuses the subject key after the previous cycle completes or stops.
+   */
+  enroll(journeyId, body, opts) {
+    return this.client.request(
+      "post",
+      `/v1/journeys/${encodeURIComponent(journeyId)}/enrollments`,
+      { ...opts, body, idempotent: true }
+    );
+  }
+  /**
+   * Emit one of your own events. Every journey whose moments listen for that
+   * name reacts.
+   */
+  emitEvent(body, opts) {
+    return this.client.request(
+      "post",
+      "/v1/journey-events",
+      {
+        ...opts,
+        body,
+        idempotent: true
+      }
+    );
+  }
+};
+
 // src/resources/quarantines.ts
 var Quarantines = class {
   constructor(client) {
@@ -1087,6 +1511,7 @@ var Woku = class {
   constructor(options) {
     const opts = typeof options === "string" ? { apiKey: options } : options ?? {};
     this.client = new WokuClient(opts);
+    this.media = new Media(this.client);
     this.trackers = new Trackers(this.client);
     this.npsTools = new NpsTools(this.client);
     this.csatTools = new CsatTools(this.client);
@@ -1104,10 +1529,11 @@ var Woku = class {
     this.dispatches = new Dispatches(this.client);
     this.reports = new Reports(this.client);
     this.company = new Company(this.client);
+    this.journeys = new Journeys(this.client);
     this.quarantines = new Quarantines(this.client);
   }
 };
 
-export { AuthenticationError, BadRequestError, ConflictError, InternalServerError, NotFoundError, Page, PermissionDeniedError, RateLimitError, UnprocessableEntityError, Woku, WokuAPIError, WokuClient, WokuConnectionError, WokuError, WokuTimeoutError };
+export { AuthenticationError, BadRequestError, ConflictError, InternalServerError, Journeys, Media, NotFoundError, Page, PayloadTooLargeError, PermissionDeniedError, RateLimitError, UnprocessableEntityError, Woku, WokuAPIError, WokuClient, WokuConnectionError, WokuError, WokuTimeoutError };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map