@delopay/sdk 0.365.0 → 0.368.0

package/dist/internal.cjs

@@ -39,6 +39,7 @@ __export(internal_exports, {
   AdminBranding: () => AdminBranding,
   AdminLive: () => AdminLive,
   AdminPortal: () => AdminPortal,
+  AdminSupport: () => AdminSupport,
   Analytics: () => Analytics,
   AnalyticsDashboard: () => AnalyticsDashboard,
   Audit: () => Audit,
@@ -186,6 +187,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 +1275,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 path3 = `/account/${encodeURIComponent(merchantId)}/connectors/webhooks/${encodeURIComponent(connectorId)}`;
+    if (params === void 0) return this.request("POST", path3);
+    return this.request("POST", path3, { body: params });
   }
   /**
    * Register checkout/shop domains as Stripe payment method domains, so Apple
@@ -2073,11 +2075,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, path3, base, options) {
   const format = options?.format ?? "json";
   return downloadExport(
     request,
-    { method, path, request: negotiated(base, format, options?.presentation), format },
+    { method, path: path3, request: negotiated(base, format, options?.presentation), format },
     options
   );
 }
@@ -2338,6 +2340,34 @@ var ChargebackPrevention = class {
   async retrieveCase(caseId) {
     return this.request("GET", `/chargeback-prevention/cases/${encodeURIComponent(caseId)}`);
   }
+  /**
+   * The refund rule of every connected account and environment; version `0`
+   * and off for one never saved. Needs a merchant-wide key or sign-in.
+   */
+  async listRefundRules() {
+    return this.request("GET", "/chargeback-prevention/refund-rules");
+  }
+  /**
+   * Save a refund rule over the version read. Dashboard sign-in only, by a
+   * merchant-wide user who may write refunds; an API key is refused. A rule
+   * saved since the version named is not overwritten: the call fails.
+   */
+  async saveRefundRule(body) {
+    return this.request("PUT", "/chargeback-prevention/refund-rules", { body });
+  }
+  /**
+   * What the stored rule, or unsaved `settings`, would do with each open
+   * alert of the account now. Nothing is refunded.
+   */
+  async previewRefundRule(body) {
+    return this.request("POST", "/chargeback-prevention/refund-rules/preview", { body });
+  }
+  /** What the merchant's refund rules did, newest first. */
+  async listRefundActions(params) {
+    return this.request("GET", "/chargeback-prevention/refund-actions", {
+      query: params
+    });
+  }
 };
 
 // src/resources/paypalDisputes.ts
@@ -3050,15 +3080,15 @@ var Payments = class {
    * ```
    */
   async retrieve(paymentId, options) {
-    const path = `/payments/${encodeURIComponent(paymentId)}`;
-    if (options === void 0) return this.request("GET", path);
+    const path3 = `/payments/${encodeURIComponent(paymentId)}`;
+    if (options === void 0) return this.request("GET", path3);
     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", path3);
+    return this.request("GET", path3, { query });
   }
   /**
    * The payment's buyer risk evaluations, newest first (at most 50): each
@@ -3413,6 +3443,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
@@ -3938,9 +3998,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 path3 = `/projects/${encodeURIComponent(projectId)}`;
+    if (merchantId === void 0) return this.request("GET", path3);
+    return this.request("GET", path3, { query: { merchant_id: merchantId } });
   }
   /**
    * Update a project's details, or move it with `parent_id` (omitted keeps the
@@ -3958,9 +4018,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 path3 = `/projects/${encodeURIComponent(projectId)}`;
+    if (merchantId === void 0) return this.request("PUT", path3, { body: params, ...options });
+    return this.request("PUT", path3, {
       body: params,
       query: { merchant_id: merchantId },
       ...options
@@ -3977,9 +4037,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 path3 = `/projects/${encodeURIComponent(projectId)}`;
+    if (merchantId === void 0) return this.request("DELETE", path3);
+    return this.request("DELETE", path3, { query: { merchant_id: merchantId } });
   }
   /**
    * List all projects for a merchant, at every level, as a flat array. Rebuild
@@ -4984,9 +5044,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 path3 = `/shops/${encodeURIComponent(merchantId)}/${encodeURIComponent(shopId)}/stats`;
+    if (period === void 0) return this.request("GET", path3);
+    return this.request("GET", path3, { query: { period: String(period) } });
   }
   /**
    * Upload a logo file for a shop. The file is stored in Delopay's configured
@@ -8271,6 +8331,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) {
@@ -10739,8 +10862,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, path3, options = {}) {
+  const connection = await openStream(path3, {
     ...options.lastEventId ? { lastEventId: options.lastEventId } : {},
     ...options.signal ? { signal: options.signal } : {},
     ...options.idleTimeoutMs !== void 0 ? { idleTimeoutMs: options.idleTimeoutMs } : {},
@@ -10927,8 +11050,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 path3 = `/branding/assets/${encodeURIComponent(asset)}`;
+  return version ? `${path3}?v=${encodeURIComponent(version)}` : path3;
 }
 var Branding = class {
   constructor(request, baseUrl) {
@@ -11262,6 +11385,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);
@@ -11322,8 +11446,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(path3, query) {
+    let url = `${this.baseUrl}${path3}`;
     if (query) {
       const params = new URLSearchParams();
       for (const [key, value] of Object.entries(query)) {
@@ -11393,8 +11517,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(path3, options = {}) {
+    const url = this.buildUrl(path3, options.query);
     const lastEventId = options.lastEventId ?? "";
     const headers = {
       ...this.authHeaders(),
@@ -11434,7 +11558,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: path3 });
     startIdleTimer();
     let response;
     try {
@@ -11446,7 +11570,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: path3, requestId });
     if (!response.ok) {
       const error = await errorFromResponse(response, requestId);
       release();
@@ -11532,8 +11656,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, path3, options) {
+    const url = this.buildUrl(path3, options?.query);
     let headers = {
       ...this.authHeaders(),
       ...this.profileHeaders(options?.headers),
@@ -11597,7 +11721,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: path3 });
       }
       const timeoutCtrl = new AbortController();
       let timeoutId = setTimeout(() => timeoutCtrl.abort(), timeoutMs);
@@ -11610,7 +11734,7 @@ var Delopay = class {
         callerSignal ? [timeoutCtrl.signal, callerSignal] : [timeoutCtrl.signal]
       );
       try {
-        emit("request", { method, url: safeUrl(), path });
+        emit("request", { method, url: safeUrl(), path: path3 });
         const response = await fetch(url, {
           method,
           headers,
@@ -11619,7 +11743,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: path3, requestId });
         if (!response.ok) {
           const error = await errorFromResponse(response, requestId);
           const isTransientStatus = response.status >= 500 || response.status === 429;
@@ -16951,7 +17075,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 path3 = 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 });
@@ -16961,16 +17085,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 `${path3}?${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 path3 = 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 `${path3}?${query.toString()}`;
 }
 function isCheckoutOpenEntryMessage(data) {
   if (typeof data !== "object" || data === null) return false;
@@ -17446,6 +17570,27 @@ var AdminPortal = class {
       query: { ...preventionCaseQuery(filters), ...merchant_id ? { merchant_id } : {} }
     });
   }
+  /** Chargeback prevention refund rules across merchants, or of one merchant. */
+  async listChargebackPreventionRefundRules(params) {
+    return this.request("GET", "/admin-portal/chargeback-prevention/refund-rules", {
+      query: params
+    });
+  }
+  /**
+   * Turn a merchant's refund rule off. Its settings are kept, and what it
+   * already did is still settled and reported.
+   */
+  async stopChargebackPreventionRefundRule(body) {
+    return this.request("POST", "/admin-portal/chargeback-prevention/refund-rules/disable", {
+      body
+    });
+  }
+  /** What refund rules did, across merchants or for one merchant. */
+  async listChargebackPreventionRefundActions(params) {
+    return this.request("GET", "/admin-portal/chargeback-prevention/refund-actions", {
+      query: params
+    });
+  }
   /** One chargeback prevention case of any merchant, with its history. */
   async getChargebackPreventionCase(caseId) {
     return this.request(
@@ -17610,6 +17755,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` /
@@ -18421,6 +18575,65 @@ function adminAccount(merchantId) {
   return `/admin-portal/accounts/${encodeURIComponent(merchantId)}`;
 }
 
+// src/internal/resources/adminSupport.ts
+var path2 = (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", path2(id));
+  }
+  /** Change status, kind, category or assignee. `PATCH /admin-portal/support/conversations/{id}` */
+  async update(id, body) {
+    return this.request("PATCH", path2(id), { body });
+  }
+  /** Messages, notes included. `GET /admin-portal/support/conversations/{id}/messages` */
+  async messages(id, query) {
+    return this.request("GET", `${path2(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", `${path2(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", `${path2(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", `${path2(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", `${path2(id)}/read`);
+  }
+};
+
 // src/internal/resources/auditLogs.ts
 var AuditLogs = class {
   constructor(request) {
@@ -19200,6 +19413,7 @@ 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);
     const openStream = this.openEventStream.bind(this);
     this.adminLive = new AdminLive(request, openStream);
     this.adminBranding = new AdminBranding(request);
@@ -19239,6 +19453,7 @@ var DelopayInternal = class extends Delopay {
   AdminBranding,
   AdminLive,
   AdminPortal,
+  AdminSupport,
   Analytics,
   AnalyticsDashboard,
   Audit,
@@ -19386,6 +19601,7 @@ var DelopayInternal = class extends Delopay {
   Settlement,
   ShopLabels,
   Subscriptions,
+  Support,
   UNKNOWN_SECTION_ORDER,
   WCAG_AA_TEXT,
   WCAG_AA_UI,