@delopay/sdk 0.183.0 → 0.184.0

package/README.md

@@ -141,6 +141,32 @@ const payment = await delopay.payments.create({
 });
 ```
 
+### Sell from the catalog
+
+```typescript
+// A product belongs to a shop; every call names the shop last.
+const product = await delopay.products.create(
+  {
+    name: 'Annual report',
+    kind: 'one_time',
+    prices: [{ amount: 2999, currency: 'EUR', is_default: true }],
+  },
+  'pro_abc123',
+);
+
+// Price a payment from the catalog: no amount, no currency — the server
+// freezes the product's active default price (or a named `price_id`) onto it.
+const payment = await delopay.payments.create({
+  product_id: product.id,
+  profile_id: 'pro_abc123',
+  payment_link: true,
+});
+
+// What the payment sold, as it was when it was created — unchanged by later
+// catalog edits or deletion.
+const sold = await delopay.payments.productLines(payment.payment_id);
+```
+
 ### Handle disputes
 
 ```typescript

package/dist/{chunk-HITQ3SXH.js → chunk-RH4CX4MU.js}

@@ -3984,6 +3984,14 @@ var Users = class {
   async listUserRoles(params) {
     return this.request("POST", "/user/employees", { body: params });
   }
+  /**
+   * The current role's explicit payment-data policy, or `null` when the role
+   * retains its pre-control access. A dashboard hint: every API response
+   * enforces the same policy on its own. `GET /user/role/payment-visibility`
+   */
+  async getRolePaymentVisibility() {
+    return this.request("GET", "/user/role/payment-visibility");
+  }
   /**
    * Change a team member's role. `POST /user/employees/update-role`
    *
@@ -5036,6 +5044,89 @@ var Products = class {
       { ...this.scoped(profileId, options) }
     );
   }
+  // --- add-on selection groups ---------------------------------------
+  /**
+   * Add a group of optional extras to a one-time product, with how many of
+   * them a buyer must and may choose. Each add-on is an active product of kind
+   * `addon` in the same shop. Returns the whole product.
+   * `POST /products/{product_id}/addon-groups`
+   */
+  async createAddonGroup(productId, group, profileId, options) {
+    return this.request("POST", `/products/${encodeURIComponent(productId)}/addon-groups`, {
+      body: group,
+      ...this.scoped(profileId, options)
+    });
+  }
+  /**
+   * Change a group's name, bounds, or the add-ons it offers; a new list
+   * replaces the old one whole.
+   * `POST /products/{product_id}/addon-groups/{group_id}`
+   */
+  async updateAddonGroup(productId, groupId, changes, profileId, options) {
+    return this.request(
+      "POST",
+      `/products/${encodeURIComponent(productId)}/addon-groups/${encodeURIComponent(groupId)}`,
+      { body: changes, ...this.scoped(profileId, options) }
+    );
+  }
+  /**
+   * Remove a group and what it offered. The add-on products themselves stay.
+   * `DELETE /products/{product_id}/addon-groups/{group_id}`
+   */
+  async deleteAddonGroup(productId, groupId, profileId, options) {
+    return this.request(
+      "DELETE",
+      `/products/${encodeURIComponent(productId)}/addon-groups/${encodeURIComponent(groupId)}`,
+      { ...this.scoped(profileId, options) }
+    );
+  }
+  // --- bundles ---------------------------------------------------------
+  /**
+   * Replace what a bundle contains. Its pricing mode is fixed at creation;
+   * past purchases keep their own frozen lines.
+   * `POST /products/{product_id}/bundle`
+   */
+  async replaceBundle(productId, bundle, profileId, options) {
+    return this.request("POST", `/products/${encodeURIComponent(productId)}/bundle`, {
+      body: bundle,
+      ...this.scoped(profileId, options)
+    });
+  }
+  // --- provider import ---------------------------------------------
+  /**
+   * Read a connected billing account's products and say how each relates to
+   * the catalog. Reads only: nothing is written to the provider or the catalog.
+   * `POST /products/import/preview`
+   */
+  async importPreview(request, profileId, options) {
+    return this.request("POST", "/products/import/preview", {
+      body: request,
+      ...this.scoped(profileId, options)
+    });
+  }
+  /**
+   * Create a product for every new item and add the new prices of every
+   * changed one, tied to the provider's ids. Nothing is edited or removed, and
+   * nothing is written to the provider. A failed item is reported with its
+   * reason and can be retried by naming it in `connector_product_ids`.
+   * `POST /products/import/apply`
+   */
+  async importApply(request, profileId, options) {
+    return this.request("POST", "/products/import/apply", {
+      body: request,
+      ...this.scoped(profileId, options)
+    });
+  }
+  /**
+   * The shop's past imports from one connected account, newest first.
+   * `GET /products/import/runs`
+   */
+  async listImportRuns(merchantConnectorId, profileId, options) {
+    return this.request("GET", "/products/import/runs", {
+      query: { merchant_connector_id: merchantConnectorId },
+      ...this.scoped(profileId, options)
+    });
+  }
 };
 
 // src/resources/processorCosts.ts
@@ -5170,6 +5261,16 @@ var CheckoutMethods = class {
       query: { merchant_id: merchantId }
     });
   }
+  /**
+   * The same document as {@link retrieve}, on the route that stays open to a
+   * reader of the checkout's appearance while the role's payment-data
+   * visibility is restricted. `GET /checkout-methods/{profile_id}/preview`
+   */
+  async preview(merchantId, profileId) {
+    return this.request("GET", `/checkout-methods/${encodeURIComponent(profileId)}/preview`, {
+      query: { merchant_id: merchantId }
+    });
+  }
   /**
    * Replace the shop's layout. The router refuses an express item that does
    * not draw its own button, more than two rows of two in the express strip,
@@ -10475,4 +10576,4 @@ export {
   decodeNativePanes,
   encodeNativePanes
 };
-//# sourceMappingURL=chunk-HITQ3SXH.js.map
+//# sourceMappingURL=chunk-RH4CX4MU.js.map