@delopay/sdk 0.366.0 → 0.370.0

package/dist/internal.cjs

@@ -37,8 +37,10 @@ __export(internal_exports, {
   APPLE_PAY_BUTTON_TYPES: () => APPLE_PAY_BUTTON_TYPES,
   Admin: () => Admin,
   AdminBranding: () => AdminBranding,
+  AdminIndustries: () => AdminIndustries,
   AdminLive: () => AdminLive,
   AdminPortal: () => AdminPortal,
+  AdminSupport: () => AdminSupport,
   Analytics: () => Analytics,
   AnalyticsDashboard: () => AnalyticsDashboard,
   Audit: () => Audit,
@@ -186,6 +188,7 @@ __export(internal_exports, {
   Settlement: () => Settlement,
   ShopLabels: () => ShopLabels,
   Subscriptions: () => Subscriptions,
+  Support: () => Support,
   UNKNOWN_SECTION_ORDER: () => UNKNOWN_SECTION_ORDER,
   WCAG_AA_TEXT: () => WCAG_AA_TEXT,
   WCAG_AA_UI: () => WCAG_AA_UI,
@@ -1273,9 +1276,9 @@ var Connectors = class {
    *   to a single event.
    */
   async registerWebhook(merchantId, connectorId, params) {
-    const path = `/account/${encodeURIComponent(merchantId)}/connectors/webhooks/${encodeURIComponent(connectorId)}`;
-    if (params === void 0) return this.request("POST", path);
-    return this.request("POST", path, { body: params });
+    const path4 = `/account/${encodeURIComponent(merchantId)}/connectors/webhooks/${encodeURIComponent(connectorId)}`;
+    if (params === void 0) return this.request("POST", path4);
+    return this.request("POST", path4, { body: params });
   }
   /**
    * Register checkout/shop domains as Stripe payment method domains, so Apple
@@ -2073,11 +2076,11 @@ function negotiated(options, format, presentation) {
   }
   return format === "json" ? { ...options, headers } : { ...options, headers, responseType: "blob" };
 }
-function runExport(request, method, path, base, options) {
+function runExport(request, method, path4, base, options) {
   const format = options?.format ?? "json";
   return downloadExport(
     request,
-    { method, path, request: negotiated(base, format, options?.presentation), format },
+    { method, path: path4, request: negotiated(base, format, options?.presentation), format },
     options
   );
 }
@@ -3078,15 +3081,15 @@ var Payments = class {
    * ```
    */
   async retrieve(paymentId, options) {
-    const path = `/payments/${encodeURIComponent(paymentId)}`;
-    if (options === void 0) return this.request("GET", path);
+    const path4 = `/payments/${encodeURIComponent(paymentId)}`;
+    if (options === void 0) return this.request("GET", path4);
     const query = {};
     if (options.force_sync !== void 0) query["force_sync"] = options.force_sync;
     if (options.all_keys_required !== void 0) {
       query["all_keys_required"] = options.all_keys_required;
     }
-    if (Object.keys(query).length === 0) return this.request("GET", path);
-    return this.request("GET", path, { query });
+    if (Object.keys(query).length === 0) return this.request("GET", path4);
+    return this.request("GET", path4, { query });
   }
   /**
    * The payment's buyer risk evaluations, newest first (at most 50): each
@@ -3441,6 +3444,36 @@ var Payments = class {
       options
     );
   }
+  /**
+   * The statement name and suffix each attempt of a payment asked for and was
+   * sent to its provider with. A name the merchant, the shop or the connector
+   * account configures replaces the payment's own: `name_ignored` /
+   * `suffix_ignored` say the payment's value was not used, and a `null` sent
+   * value leaves the provider account's own default.
+   *
+   * Only attempts with a record are listed: one that carried no name and was
+   * sent none, or ran before the record existed, is absent.
+   *
+   * `GET /payments/{paymentId}/statement-descriptors`
+   *
+   * @param paymentId - The payment intent ID.
+   * @param options - Optional per-call extras: extra `headers`, a `timeout`
+   *   override, and an `AbortSignal`.
+   *
+   * @example
+   * ```typescript
+   * const { attempts } = await delopay.payments.statementDescriptors('pay_abc123');
+   * const last = attempts.at(-1);
+   * if (last?.name_ignored) console.log(`Sent as ${last.sent_name}`);
+   * ```
+   */
+  async statementDescriptors(paymentId, options) {
+    return this.request(
+      "GET",
+      `/payments/${encodeURIComponent(paymentId)}/statement-descriptors`,
+      options
+    );
+  }
   /**
    * Open a playback of the payment's stored checkout recording: the audited
    * act of watching. Answers the manifest — which slices exist, how long the
@@ -3966,9 +3999,9 @@ var Projects = class {
    * @returns The project.
    */
   async retrieve(projectId, merchantId) {
-    const path = `/projects/${encodeURIComponent(projectId)}`;
-    if (merchantId === void 0) return this.request("GET", path);
-    return this.request("GET", path, { query: { merchant_id: merchantId } });
+    const path4 = `/projects/${encodeURIComponent(projectId)}`;
+    if (merchantId === void 0) return this.request("GET", path4);
+    return this.request("GET", path4, { query: { merchant_id: merchantId } });
   }
   /**
    * Update a project's details, or move it with `parent_id` (omitted keeps the
@@ -3986,9 +4019,9 @@ var Projects = class {
    * @returns The updated project.
    */
   async update(projectId, params, merchantId, options) {
-    const path = `/projects/${encodeURIComponent(projectId)}`;
-    if (merchantId === void 0) return this.request("PUT", path, { body: params, ...options });
-    return this.request("PUT", path, {
+    const path4 = `/projects/${encodeURIComponent(projectId)}`;
+    if (merchantId === void 0) return this.request("PUT", path4, { body: params, ...options });
+    return this.request("PUT", path4, {
       body: params,
       query: { merchant_id: merchantId },
       ...options
@@ -4005,9 +4038,9 @@ var Projects = class {
    * @returns The deleted project object.
    */
   async delete(projectId, merchantId) {
-    const path = `/projects/${encodeURIComponent(projectId)}`;
-    if (merchantId === void 0) return this.request("DELETE", path);
-    return this.request("DELETE", path, { query: { merchant_id: merchantId } });
+    const path4 = `/projects/${encodeURIComponent(projectId)}`;
+    if (merchantId === void 0) return this.request("DELETE", path4);
+    return this.request("DELETE", path4, { query: { merchant_id: merchantId } });
   }
   /**
    * List all projects for a merchant, at every level, as a flat array. Rebuild
@@ -5012,9 +5045,9 @@ var Shops = class {
    * ```
    */
   async stats(merchantId, shopId, period) {
-    const path = `/shops/${encodeURIComponent(merchantId)}/${encodeURIComponent(shopId)}/stats`;
-    if (period === void 0) return this.request("GET", path);
-    return this.request("GET", path, { query: { period: String(period) } });
+    const path4 = `/shops/${encodeURIComponent(merchantId)}/${encodeURIComponent(shopId)}/stats`;
+    if (period === void 0) return this.request("GET", path4);
+    return this.request("GET", path4, { query: { period: String(period) } });
   }
   /**
    * Upload a logo file for a shop. The file is stored in Delopay's configured
@@ -8299,6 +8332,69 @@ var Products = class {
   }
 };
 
+// src/resources/support.ts
+var path = (id) => `/support/conversations/${encodeURIComponent(id)}`;
+var Support = class {
+  constructor(request) {
+    this.request = request;
+  }
+  /** Start a conversation with its first message. `POST /support/conversations` */
+  async create(body) {
+    return this.request("POST", "/support/conversations", { body });
+  }
+  /** The conversations the caller may read. `GET /support/conversations` */
+  async list(query) {
+    return this.request("GET", "/support/conversations", {
+      query: query === void 0 ? void 0 : { ...query }
+    });
+  }
+  /** One conversation. `GET /support/conversations/{id}` */
+  async retrieve(id) {
+    return this.request("GET", path(id));
+  }
+  /** A conversation's messages. `GET /support/conversations/{id}/messages` */
+  async messages(id, query) {
+    return this.request("GET", `${path(id)}/messages`, {
+      query: query === void 0 ? void 0 : { ...query }
+    });
+  }
+  /** Answer in a conversation. `POST /support/conversations/{id}/messages` */
+  async reply(id, body) {
+    return this.request("POST", `${path(id)}/messages`, { body });
+  }
+  /**
+   * Upload a file for a message. PNG, JPEG, WebP, PDF, text, MP4 or WebM, read from the
+   * content; 10 MB, a video 25 MB. It belongs to the caller until a message names it in
+   * `attachments`. Uploading again with the same `clientUploadId` returns the same file.
+   * `POST /support/conversations/{id}/attachments`
+   */
+  async uploadAttachment(id, file, clientUploadId, fileName) {
+    const form = new FormData();
+    form.append("client_upload_id", clientUploadId);
+    if (fileName === void 0) form.append("file", file);
+    else form.append("file", file, fileName);
+    return this.request("POST", `${path(id)}/attachments`, { body: form });
+  }
+  /**
+   * Fetch a file once its scan is clean. Refused with `support_attachment_checking` while
+   * the scan runs, and `support_attachment_blocked` after a block.
+   * `GET /support/conversations/{id}/attachments/{fileId}`
+   */
+  async downloadAttachment(id, fileId) {
+    return this.request("GET", `${path(id)}/attachments/${encodeURIComponent(fileId)}`, {
+      responseType: "blob"
+    });
+  }
+  /**
+   * Clear the merchant's unread mark and read the conversation as it is now.
+   * Someone acting as somebody else leaves the mark in place.
+   * `POST /support/conversations/{id}/read`
+   */
+  async markRead(id) {
+    return this.request("POST", `${path(id)}/read`);
+  }
+};
+
 // src/resources/invoices.ts
 var Invoices = class {
   constructor(request) {
@@ -10767,8 +10863,8 @@ var LiveEventStream = class {
     return toLiveStreamEvent(dispatch.event, this._lastEventId, this._retry);
   }
 };
-async function openLiveStream(openStream, path, options = {}) {
-  const connection = await openStream(path, {
+async function openLiveStream(openStream, path4, options = {}) {
+  const connection = await openStream(path4, {
     ...options.lastEventId ? { lastEventId: options.lastEventId } : {},
     ...options.signal ? { signal: options.signal } : {},
     ...options.idleTimeoutMs !== void 0 ? { idleTimeoutMs: options.idleTimeoutMs } : {},
@@ -10955,8 +11051,8 @@ var ProcessorImports = class {
 
 // src/resources/deploymentBranding.ts
 function brandingAssetPath(asset, version) {
-  const path = `/branding/assets/${encodeURIComponent(asset)}`;
-  return version ? `${path}?v=${encodeURIComponent(version)}` : path;
+  const path4 = `/branding/assets/${encodeURIComponent(asset)}`;
+  return version ? `${path4}?v=${encodeURIComponent(version)}` : path4;
 }
 var Branding = class {
   constructor(request, baseUrl) {
@@ -11290,6 +11386,7 @@ var Delopay = class {
     this.costRules = new CostRules(request);
     this.externalRecords = new ExternalRecords(request);
     this.products = new Products(request);
+    this.support = new Support(request);
     this.invoices = new Invoices(request);
     this.invoiceSettings = new InvoiceSettingsResource(request);
     this.processorCosts = new ProcessorCosts(request);
@@ -11350,8 +11447,8 @@ var Delopay = class {
     return response;
   }
   /** `path` on the base URL, with the query string `query` makes. */
-  buildUrl(path, query) {
-    let url = `${this.baseUrl}${path}`;
+  buildUrl(path4, query) {
+    let url = `${this.baseUrl}${path4}`;
     if (query) {
       const params = new URLSearchParams();
       for (const [key, value] of Object.entries(query)) {
@@ -11421,8 +11518,8 @@ var Delopay = class {
    * on a 2xx that is not `text/event-stream` (code `NOT_EVENT_STREAM`), and
    * with `TIMEOUT`, `NETWORK` or `ABORTED` like `request()`.
    */
-  async openEventStream(path, options = {}) {
-    const url = this.buildUrl(path, options.query);
+  async openEventStream(path4, options = {}) {
+    const url = this.buildUrl(path4, options.query);
     const lastEventId = options.lastEventId ?? "";
     const headers = {
       ...this.authHeaders(),
@@ -11462,7 +11559,7 @@ var Delopay = class {
       `Network error: ${cause instanceof Error ? cause.message : String(cause ?? "stream failed")}`,
       { status: 0, code: "NETWORK", type: "network_error" }
     );
-    this.log("request", { method: "GET", url: redactUrlForLogging(url), path });
+    this.log("request", { method: "GET", url: redactUrlForLogging(url), path: path4 });
     startIdleTimer();
     let response;
     try {
@@ -11474,7 +11571,7 @@ var Delopay = class {
       throw network(err);
     }
     const requestId = response.headers?.get("x-request-id") ?? response.headers?.get("x-trace-id") ?? void 0;
-    this.log("response", { status: response.status, method: "GET", path, requestId });
+    this.log("response", { status: response.status, method: "GET", path: path4, requestId });
     if (!response.ok) {
       const error = await errorFromResponse(response, requestId);
       release();
@@ -11560,8 +11657,8 @@ var Delopay = class {
    * @throws {DelopayAuthenticationError} On 401 responses.
    * @throws {DelopayError} On all other non-2xx responses, timeouts, and network errors.
    */
-  async request(method, path, options) {
-    const url = this.buildUrl(path, options?.query);
+  async request(method, path4, options) {
+    const url = this.buildUrl(path4, options?.query);
     let headers = {
       ...this.authHeaders(),
       ...this.profileHeaders(options?.headers),
@@ -11625,7 +11722,7 @@ var Delopay = class {
         const delay = Math.max(retryAfterOverrideMs ?? 0, jittered);
         retryAfterOverrideMs = null;
         await new Promise((resolve) => setTimeout(resolve, delay));
-        emit("retry", { attempt, maxRetries: this.maxRetries, method, path });
+        emit("retry", { attempt, maxRetries: this.maxRetries, method, path: path4 });
       }
       const timeoutCtrl = new AbortController();
       let timeoutId = setTimeout(() => timeoutCtrl.abort(), timeoutMs);
@@ -11638,7 +11735,7 @@ var Delopay = class {
         callerSignal ? [timeoutCtrl.signal, callerSignal] : [timeoutCtrl.signal]
       );
       try {
-        emit("request", { method, url: safeUrl(), path });
+        emit("request", { method, url: safeUrl(), path: path4 });
         const response = await fetch(url, {
           method,
           headers,
@@ -11647,7 +11744,7 @@ var Delopay = class {
           ...options?.keepalive !== void 0 ? { keepalive: options.keepalive } : {}
         });
         const requestId = response.headers?.get("x-request-id") ?? response.headers?.get("x-trace-id") ?? void 0;
-        emit("response", { status: response.status, method, path, requestId });
+        emit("response", { status: response.status, method, path: path4, requestId });
         if (!response.ok) {
           const error = await errorFromResponse(response, requestId);
           const isTransientStatus = response.status >= 500 || response.status === 429;
@@ -16979,7 +17076,7 @@ function encodePanes(panes) {
 var OPAQUE_PAYMENT_LINK_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
 function focusedCheckoutUrl(params) {
   const base = params.checkoutBaseUrl.replace(/\/+$/, "");
-  const path = params.paymentLinkId && OPAQUE_PAYMENT_LINK_ID.test(params.paymentLinkId) ? `${base}/pay/${params.paymentLinkId}` : `${base}/pay/${encodeURIComponent(params.merchantId)}/${encodeURIComponent(
+  const path4 = params.paymentLinkId && OPAQUE_PAYMENT_LINK_ID.test(params.paymentLinkId) ? `${base}/pay/${params.paymentLinkId}` : `${base}/pay/${encodeURIComponent(params.merchantId)}/${encodeURIComponent(
     params.paymentId
   )}`;
   const query = new URLSearchParams({ pane: params.method });
@@ -16989,16 +17086,16 @@ function focusedCheckoutUrl(params) {
   if (merchantConnectorId) query.set("mca", merchantConnectorId);
   if (params.locale) query.set("locale", params.locale);
   if (params.customFieldsCollected) query.set("cf", "1");
-  return `${path}?${query.toString()}`;
+  return `${path4}?${query.toString()}`;
 }
 function checkoutEntryUrl(params) {
   const base = params.checkoutBaseUrl.replace(/\/+$/, "");
-  const path = params.paymentLinkId && OPAQUE_PAYMENT_LINK_ID.test(params.paymentLinkId) ? `${base}/pay/${params.paymentLinkId}` : `${base}/pay/${encodeURIComponent(params.merchantId)}/${encodeURIComponent(
+  const path4 = params.paymentLinkId && OPAQUE_PAYMENT_LINK_ID.test(params.paymentLinkId) ? `${base}/pay/${params.paymentLinkId}` : `${base}/pay/${encodeURIComponent(params.merchantId)}/${encodeURIComponent(
     params.paymentId
   )}`;
   const query = new URLSearchParams({ entry: params.entry.trim() });
   if (params.locale) query.set("locale", params.locale);
-  return `${path}?${query.toString()}`;
+  return `${path4}?${query.toString()}`;
 }
 function isCheckoutOpenEntryMessage(data) {
   if (typeof data !== "object" || data === null) return false;
@@ -17099,6 +17196,60 @@ var AdminBranding = class {
   }
 };
 
+// src/internal/resources/adminIndustries.ts
+var path2 = (id) => `/admin-portal/industries/${encodeURIComponent(id)}`;
+var AdminIndustries = class {
+  constructor(request) {
+    this.request = request;
+  }
+  /** The whole catalog, archived entries included. `GET /admin-portal/industries` */
+  async list() {
+    return this.request("GET", "/admin-portal/industries");
+  }
+  /**
+   * Create an industry, or a sub-industry under `parent_id`. Without
+   * `availability` it can be selected nowhere until availability is set.
+   * `POST /admin-portal/industries`
+   */
+  async create(body) {
+    return this.request("POST", "/admin-portal/industries", { body });
+  }
+  /** Rename an entry; its id stays. `PATCH /admin-portal/industries/{industry_id}` */
+  async rename(industryId, body) {
+    return this.request("PATCH", path2(industryId), { body });
+  }
+  /**
+   * Stop offering an entry, and for an industry its sub-industries, for new
+   * selections. Existing selections keep it. `POST /admin-portal/industries/{industry_id}/archive`
+   */
+  async archive(industryId) {
+    return this.request("POST", `${path2(industryId)}/archive`);
+  }
+  /**
+   * Offer an archived entry again. Refused while an active sibling holds its
+   * name, or for a sub-industry while its industry is archived.
+   * `POST /admin-portal/industries/{industry_id}/restore`
+   */
+  async restore(industryId) {
+    return this.request("POST", `${path2(industryId)}/restore`);
+  }
+  /**
+   * Replace where an entry can be selected.
+   * `PUT /admin-portal/industries/{industry_id}/availability`
+   */
+  async setAvailability(industryId, body) {
+    return this.request("PUT", `${path2(industryId)}/availability`, { body });
+  }
+  /**
+   * Every entry as seen from one merchant, or one of its projects or shops:
+   * whether it can be selected there, why, and which scope grants it.
+   * `GET /admin-portal/industries/preview`
+   */
+  async preview(query) {
+    return this.request("GET", "/admin-portal/industries/preview", { query: { ...query } });
+  }
+};
+
 // src/internal/resources/adminLive.ts
 var AdminLive = class {
   constructor(request, openStream) {
@@ -17659,6 +17810,15 @@ var AdminPortal = class {
       query
     });
   }
+  /**
+   * Every shop's device intelligence account, with its assessments per environment and
+   * its error rate over the last `window_days` days. The error rate counts finished
+   * assessments: one still running and a payment naming no buyer are not errors.
+   * `GET /admin-portal/device-intelligence`
+   */
+  async deviceIntelligenceUsage() {
+    return this.request("GET", "/admin-portal/device-intelligence");
+  }
   /**
    * Device analytics over the canonical client-context observation per
    * payment, rooted at all merchants and drillable via `merchant_id` /
@@ -18470,6 +18630,65 @@ function adminAccount(merchantId) {
   return `/admin-portal/accounts/${encodeURIComponent(merchantId)}`;
 }
 
+// src/internal/resources/adminSupport.ts
+var path3 = (id) => `/admin-portal/support/conversations/${encodeURIComponent(id)}`;
+var AdminSupport = class {
+  constructor(request) {
+    this.request = request;
+  }
+  /** The queue. `GET /admin-portal/support/conversations` */
+  async list(query) {
+    return this.request("GET", "/admin-portal/support/conversations", {
+      query: query === void 0 ? void 0 : { ...query }
+    });
+  }
+  /** One conversation. `GET /admin-portal/support/conversations/{id}` */
+  async retrieve(id) {
+    return this.request("GET", path3(id));
+  }
+  /** Change status, kind, category or assignee. `PATCH /admin-portal/support/conversations/{id}` */
+  async update(id, body) {
+    return this.request("PATCH", path3(id), { body });
+  }
+  /** Messages, notes included. `GET /admin-portal/support/conversations/{id}/messages` */
+  async messages(id, query) {
+    return this.request("GET", `${path3(id)}/messages`, {
+      query: query === void 0 ? void 0 : { ...query }
+    });
+  }
+  /** Answer, or leave a note. `POST /admin-portal/support/conversations/{id}/messages` */
+  async reply(id, body) {
+    return this.request("POST", `${path3(id)}/messages`, { body });
+  }
+  /**
+   * Upload a file for a message from staff, scanned like a merchant's.
+   * `POST /admin-portal/support/conversations/{id}/attachments`
+   */
+  async uploadAttachment(id, file, clientUploadId, fileName) {
+    const form = new FormData();
+    form.append("client_upload_id", clientUploadId);
+    if (fileName === void 0) form.append("file", file);
+    else form.append("file", file, fileName);
+    return this.request("POST", `${path3(id)}/attachments`, { body: form });
+  }
+  /**
+   * Fetch a file once its scan is clean. A blocked file stays shut for staff too.
+   * `GET /admin-portal/support/conversations/{id}/attachments/{fileId}`
+   */
+  async downloadAttachment(id, fileId) {
+    return this.request("GET", `${path3(id)}/attachments/${encodeURIComponent(fileId)}`, {
+      responseType: "blob"
+    });
+  }
+  /**
+   * Clear the staff unread mark and read the conversation as it is now.
+   * `POST /admin-portal/support/conversations/{id}/read`
+   */
+  async markRead(id) {
+    return this.request("POST", `${path3(id)}/read`);
+  }
+};
+
 // src/internal/resources/auditLogs.ts
 var AuditLogs = class {
   constructor(request) {
@@ -19249,6 +19468,8 @@ var DelopayInternal = class extends Delopay {
     const request = this.request.bind(this);
     this.admin = new Admin(request);
     this.adminPortal = new AdminPortal(request);
+    this.adminSupport = new AdminSupport(request);
+    this.adminIndustries = new AdminIndustries(request);
     const openStream = this.openEventStream.bind(this);
     this.adminLive = new AdminLive(request, openStream);
     this.adminBranding = new AdminBranding(request);
@@ -19286,8 +19507,10 @@ var DelopayInternal = class extends Delopay {
   APPLE_PAY_BUTTON_TYPES,
   Admin,
   AdminBranding,
+  AdminIndustries,
   AdminLive,
   AdminPortal,
+  AdminSupport,
   Analytics,
   AnalyticsDashboard,
   Audit,
@@ -19435,6 +19658,7 @@ var DelopayInternal = class extends Delopay {
   Settlement,
   ShopLabels,
   Subscriptions,
+  Support,
   UNKNOWN_SECTION_ORDER,
   WCAG_AA_TEXT,
   WCAG_AA_UI,