@checkoutpage/sdk 0.1.31 → 0.1.32

package/dist/index.mjs

@@ -65,14 +65,19 @@ var InvoiceResource = class {
    *
    * @example
    * const { data: invoice } = await client.invoices.get(invoiceId);
+   *
+   * @example
+   * // A test invoice
+   * const { data: testInvoice } = await client.invoices.get(invoiceId, { livemode: false });
    */
-  async get(id) {
+  async get(id, options = {}) {
     if (!id) {
       throw new Error("Invoice ID is required");
     }
     return this.client.request({
       method: "GET",
-      path: `/v1/invoices/${id}`
+      path: `/v1/invoices/${id}`,
+      query: { livemode: options.livemode?.toString() }
     });
   }
   async list(args = {}) {
@@ -86,7 +91,8 @@ var InvoiceResource = class {
       chargeId: args.chargeId,
       poNumber: args.poNumber,
       createdAfter: args.createdAfter,
-      createdBefore: args.createdBefore
+      createdBefore: args.createdBefore,
+      livemode: args.livemode?.toString()
     };
     return this.client.request({
       method: "GET",
@@ -248,6 +254,8 @@ var CustomerResource = class {
   async list(args = {}) {
     const query = {
       search: args.search,
+      createdAfter: args.createdAfter,
+      createdBefore: args.createdBefore,
       limit: args.limit?.toString(),
       starting_after: args.starting_after,
       ending_before: args.ending_before
@@ -345,6 +353,9 @@ var CouponResource = class {
     if (params.appliesToSetupFee !== void 0) {
       body.appliesToSetupFee = params.appliesToSetupFee;
     }
+    if (params.appliesToTicketFees !== void 0) {
+      body.appliesToTicketFees = params.appliesToTicketFees;
+    }
     if (params.pageIds !== void 0) {
       body.pageIds = params.pageIds;
     }
@@ -382,20 +393,26 @@ var PaymentResource = class {
    *
    * @example
    * const { data: payment } = await client.payments.get(paymentId);
+   *
+   * @example
+   * // A test payment
+   * const { data: testPayment } = await client.payments.get(paymentId, { livemode: false });
    */
-  async get(paymentId) {
+  async get(paymentId, options = {}) {
     if (!paymentId) {
       throw new Error("Payment ID is required");
     }
     return this.client.request({
       method: "GET",
-      path: `/v1/payments/${paymentId}`
+      path: `/v1/payments/${paymentId}`,
+      query: { livemode: options.livemode?.toString() }
     });
   }
   async list(args = {}) {
     const query = {
       search: args.search,
       status: args.status,
+      orderStatus: args.orderStatus,
       pageId: args.pageId,
       customerId: args.customerId,
       orderId: args.orderId,
@@ -404,6 +421,7 @@ var PaymentResource = class {
       createdAfter: args.createdAfter,
       createdBefore: args.createdBefore,
       abandonmentStatus: args.abandonmentStatus,
+      livemode: args.livemode?.toString(),
       limit: args.limit?.toString(),
       starting_after: args.starting_after,
       ending_before: args.ending_before
@@ -426,21 +444,34 @@ var SubscriptionResource = class {
    *
    * @example
    * const { data: subscription } = await client.subscriptions.get(subscriptionId);
+   *
+   * @example
+   * // A test subscription
+   * const { data: testSubscription } = await client.subscriptions.get(subscriptionId, {
+   *   livemode: false,
+   * });
    */
-  async get(subscriptionId) {
+  async get(subscriptionId, options = {}) {
     if (!subscriptionId) {
       throw new Error("Subscription ID is required");
     }
     return this.client.request({
       method: "GET",
-      path: `/v1/subscriptions/${subscriptionId}`
+      path: `/v1/subscriptions/${subscriptionId}`,
+      query: { livemode: options.livemode?.toString() }
     });
   }
   async list(args = {}) {
     const query = {
       search: args.search,
       pageId: args.pageId,
+      customerId: args.customerId,
+      orderId: args.orderId,
+      createdAfter: args.createdAfter,
+      createdBefore: args.createdBefore,
+      abandonmentStatus: args.abandonmentStatus,
       status: args.status,
+      livemode: args.livemode?.toString(),
       limit: args.limit?.toString(),
       starting_after: args.starting_after,
       ending_before: args.ending_before
@@ -485,14 +516,21 @@ var SubscriptionPaymentResource = class {
    *
    * @example
    * const { data: payment } = await client.subscriptionPayments.get(paymentId);
+   *
+   * @example
+   * // A test subscription payment
+   * const { data: testPayment } = await client.subscriptionPayments.get(paymentId, {
+   *   livemode: false,
+   * });
    */
-  async get(subscriptionPaymentId) {
+  async get(subscriptionPaymentId, options = {}) {
     if (!subscriptionPaymentId) {
       throw new Error("Subscription payment ID is required");
     }
     return this.client.request({
       method: "GET",
-      path: `/v1/subscription-payments/${subscriptionPaymentId}`
+      path: `/v1/subscription-payments/${subscriptionPaymentId}`,
+      query: { livemode: options.livemode?.toString() }
     });
   }
   async list(args = {}) {
@@ -508,7 +546,8 @@ var SubscriptionPaymentResource = class {
       refunded: args.refunded,
       billingReason: args.billingReason,
       createdAfter: args.createdAfter,
-      createdBefore: args.createdBefore
+      createdBefore: args.createdBefore,
+      livemode: args.livemode?.toString()
     };
     return this.client.request({
       method: "GET",
@@ -523,20 +562,70 @@ var BookingResource = class {
   constructor(client) {
     this.client = client;
   }
+  /**
+   * Create an event booking without collecting card payment. This is a real
+   * booking: tickets are issued, the customer receives a confirmation email
+   * with the ticket PDF, live-mode bookings decrement capacity, and booking webhooks fire.
+   * There are two ways to settle it. With `paymentOption.manualType` the
+   * booking is recorded as `unpaid`, to be settled outside checkout via the
+   * chosen manual option; a free booking simply has nothing due. With
+   * `complimentary: true` the tickets are issued at no charge: the booking is
+   * recorded as `paid` with `amount`, `amountPaid` and `amountDue` of 0 and
+   * `isComplimentary: true`, while the ticket lines keep their face value and
+   * `complimentaryDiscountAmount` records what they would have cost.
+   * `complimentary` is mutually exclusive with `paymentOption` and `couponId`,
+   * and one of `paymentOption` or `complimentary` is required.
+   *
+   * Field entries carry a `fieldId` plus the value. Every required field on
+   * the event must be supplied, and a stock event requires name, email and a
+   * billing address. The ids come from `GET /v1/events/{eventId}/fields`,
+   * which this client does not yet wrap.
+   *
+   * @example
+   * const { data: booking } = await client.bookings.create({
+   *   eventId,
+   *   tickets: { [ticketTypeId]: 2 },
+   *   fields: [
+   *     { fieldId: emailFieldId, value: 'ada@example.com' },
+   *     { fieldId: nameFieldId, value: 'Ada Lovelace' },
+   *   ],
+   *   paymentOption: { manualType: 'invoice' },
+   * });
+   *
+   * @example
+   * const { data: booking } = await client.bookings.create({
+   *   eventId,
+   *   tickets: { [ticketTypeId]: 2 },
+   *   fields: [{ fieldId: emailFieldId, value: 'ada@example.com' }],
+   *   complimentary: true,
+   * });
+   */
+  async create(params) {
+    return this.client.request({
+      method: "POST",
+      path: "/v1/bookings/",
+      body: params
+    });
+  }
   /**
    * Retrieve a single booking by ID. Only event bookings are returned —
    * a checkout charge is a payment, and 404s here.
    *
    * @example
    * const { data: booking } = await client.bookings.get(bookingId);
+   *
+   * @example
+   * // A test booking
+   * const { data: testBooking } = await client.bookings.get(bookingId, { livemode: false });
    */
-  async get(bookingId) {
+  async get(bookingId, options = {}) {
     if (!bookingId) {
       throw new Error("Booking ID is required");
     }
     return this.client.request({
       method: "GET",
-      path: `/v1/bookings/${bookingId}`
+      path: `/v1/bookings/${bookingId}`,
+      query: { livemode: options.livemode?.toString() }
     });
   }
   /**
@@ -548,20 +637,26 @@ var BookingResource = class {
    * @example
    * const pdf = await client.bookings.downloadTicketPdf(bookingId);
    * fs.writeFileSync('tickets.pdf', Buffer.from(pdf));
+   *
+   * @example
+   * // The tickets of a test booking
+   * const testPdf = await client.bookings.downloadTicketPdf(bookingId, { livemode: false });
    */
-  async downloadTicketPdf(bookingId) {
+  async downloadTicketPdf(bookingId, options = {}) {
     if (!bookingId) {
       throw new Error("Booking ID is required");
     }
     return this.client.requestRaw({
       method: "GET",
-      path: `/v1/bookings/${bookingId}/ticket-pdf`
+      path: `/v1/bookings/${bookingId}/ticket-pdf`,
+      query: { livemode: options.livemode?.toString() }
     });
   }
   async list(args = {}) {
     const query = {
       search: args.search,
       status: args.status,
+      orderStatus: args.orderStatus,
       pageId: args.pageId,
       customerId: args.customerId,
       orderId: args.orderId,
@@ -569,6 +664,8 @@ var BookingResource = class {
       createdAfter: args.createdAfter,
       createdBefore: args.createdBefore,
       abandonmentStatus: args.abandonmentStatus,
+      isComplimentary: args.isComplimentary,
+      livemode: args.livemode?.toString(),
       limit: args.limit?.toString(),
       starting_after: args.starting_after,
       ending_before: args.ending_before
@@ -598,6 +695,7 @@ var TicketResource = class {
       createdAfter: args.createdAfter,
       createdBefore: args.createdBefore,
       search: args.search,
+      livemode: args.livemode?.toString(),
       limit: args.limit?.toString(),
       starting_after: args.starting_after,
       ending_before: args.ending_before
@@ -644,6 +742,20 @@ var ProductResource = class {
   constructor(client) {
     this.client = client;
   }
+  async list(args = {}) {
+    const query = {
+      limit: args.limit?.toString(),
+      starting_after: args.starting_after,
+      ending_before: args.ending_before,
+      role: args.role,
+      search: args.search
+    };
+    return this.client.request({
+      method: "GET",
+      path: "/v1/products/",
+      query
+    });
+  }
   async get(productId) {
     if (!productId) {
       throw new Error("Product ID is required");
@@ -700,6 +812,9 @@ var ProductResource = class {
     if (params.limitSubscriptions !== void 0) {
       body.limitSubscriptions = params.limitSubscriptions;
     }
+    if (params.limitPayments !== void 0) {
+      body.limitPayments = params.limitPayments;
+    }
     if (params.enableFileAccessForInactiveSubscriptions !== void 0) {
       body.enableFileAccessForInactiveSubscriptions = params.enableFileAccessForInactiveSubscriptions;
     }
@@ -715,6 +830,9 @@ var ProductResource = class {
     if (params.defaultPriceId !== void 0) {
       body.defaultPriceId = params.defaultPriceId;
     }
+    if (params.pricePicker !== void 0) {
+      body.pricePicker = params.pricePicker;
+    }
     return this.client.request({
       method: "PATCH",
       path: `/v1/products/${productId}`,
@@ -839,7 +957,8 @@ var CheckoutPagesResource = class {
       starting_after: args.starting_after,
       ending_before: args.ending_before,
       status: args.status,
-      search: args.search
+      search: args.search,
+      testmode: args.testmode?.toString()
     };
     return this.client.request({
       method: "GET",
@@ -1099,7 +1218,8 @@ var EventsResource = class {
       starting_after: args.starting_after,
       ending_before: args.ending_before,
       status: args.status,
-      search: args.search
+      search: args.search,
+      testmode: args.testmode?.toString()
     };
     return this.client.request({
       method: "GET",
@@ -1218,7 +1338,8 @@ var FormsResource = class {
       starting_after: args.starting_after,
       ending_before: args.ending_before,
       status: args.status,
-      search: args.search
+      search: args.search,
+      testmode: args.testmode?.toString()
     };
     return this.client.request({
       method: "GET",
@@ -1268,13 +1389,14 @@ var SubmissionResource = class {
   constructor(client) {
     this.client = client;
   }
-  async get(submissionId) {
+  async get(submissionId, options = {}) {
     if (!submissionId) {
       throw new Error("Submission ID is required");
     }
     return this.client.request({
       method: "GET",
-      path: `/v1/submissions/${submissionId}`
+      path: `/v1/submissions/${submissionId}`,
+      query: { livemode: options.livemode?.toString() }
     });
   }
   async list(args = {}) {
@@ -1285,6 +1407,7 @@ var SubmissionResource = class {
       status: args.status,
       createdAfter: args.createdAfter,
       createdBefore: args.createdBefore,
+      livemode: args.livemode?.toString(),
       limit: args.limit?.toString(),
       starting_after: args.starting_after,
       ending_before: args.ending_before
@@ -1340,6 +1463,16 @@ var TaxRateResource = class {
       body
     });
   }
+  /** Removes the rate from list(); pages and products that used it stop charging that tax. */
+  async delete(taxRateId) {
+    if (!taxRateId) {
+      throw new Error("Tax rate ID is required");
+    }
+    return this.client.request({
+      method: "DELETE",
+      path: `/v1/tax-rates/${taxRateId}`
+    });
+  }
 };
 
 // src/resources/webhooks/webhooks.ts
@@ -1388,6 +1521,45 @@ var WebhookResource = class {
       body: params
     });
   }
+  /**
+   * Retrieve a webhook endpoint by id, with its events, status and delivery
+   * counters. The signing `secret` is not returned.
+   *
+   * @example
+   * const { data: webhook } = await client.webhooks.get('6a1f0c2e9b1d4a0012345678');
+   */
+  async get(webhookId) {
+    if (!webhookId) {
+      throw new Error("Webhook ID is required");
+    }
+    return this.client.request({
+      method: "GET",
+      path: `/v1/webhooks/${encodeURIComponent(webhookId)}`
+    });
+  }
+  /**
+   * Update a webhook endpoint. Only the fields you send change; `events` and
+   * `customHeaders` replace the existing values. Set `status` to `'inactive'`
+   * to pause deliveries and `'active'` to resume. A new `url` must use https
+   * and must not already be registered on another of your webhooks. The
+   * signing secret cannot be changed here.
+   *
+   * @example
+   * const { data: webhook } = await client.webhooks.update(webhookId, {
+   *   events: ['payment.paid', 'checkout_page.updated'],
+   *   status: 'inactive',
+   * });
+   */
+  async update(webhookId, params) {
+    if (!webhookId) {
+      throw new Error("Webhook ID is required");
+    }
+    return this.client.request({
+      method: "PATCH",
+      path: `/v1/webhooks/${encodeURIComponent(webhookId)}`,
+      body: params
+    });
+  }
   /**
    * Delete a webhook endpoint. Deliveries stop immediately; the returned
    * object is its final state. The webhook no longer appears in `list()`,
@@ -1404,6 +1576,105 @@ var WebhookResource = class {
   }
 };
 
+// src/resources/themes/themes.ts
+var ThemeResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List the themes your pages can use, newest first: your own themes and the
+   * built-in (`global`) ones. A retired built-in theme is only listed while one
+   * of your pages uses it.
+   *
+   * @example
+   * const { data: themes, has_more } = await client.themes.list({ scope: 'seller' });
+   */
+  async list(args = {}) {
+    const query = {
+      scope: args.scope,
+      limit: args.limit?.toString(),
+      starting_after: args.starting_after,
+      ending_before: args.ending_before
+    };
+    return this.client.request({
+      method: "GET",
+      path: "/v1/themes/",
+      query
+    });
+  }
+  /**
+   * Retrieve one of your themes or a built-in theme.
+   *
+   * @example
+   * const { data: theme } = await client.themes.get(themeId);
+   */
+  async get(themeId) {
+    if (!themeId) {
+      throw new Error("Theme ID is required");
+    }
+    return this.client.request({
+      method: "GET",
+      path: `/v1/themes/${encodeURIComponent(themeId)}`
+    });
+  }
+  /**
+   * Create a theme. Pass `baseThemeId` to start from a copy of one of your
+   * themes or a built-in theme, then set what should differ in `variables`.
+   * `variables` takes the same shape as a page's `themeOverrides`. A copy of a
+   * built-in theme does not follow your store's brand colour, so set
+   * `tokens.colorPrimary` if you want it.
+   *
+   * @example
+   * const { data: theme } = await client.themes.create({
+   *   name: 'Brand',
+   *   baseThemeId: builtInThemeId,
+   *   variables: { tokens: { colorPrimary: { light: '#4f46e5' } } },
+   * });
+   */
+  async create(params) {
+    return this.client.request({
+      method: "POST",
+      path: "/v1/themes/",
+      body: params
+    });
+  }
+  /**
+   * Update one of your themes. Every page that uses it changes too. Keys left
+   * out of `variables` keep their value, and `null` resets a property or
+   * everything under a key. Built-in themes are read-only.
+   *
+   * @example
+   * const { data: theme } = await client.themes.update(themeId, {
+   *   variables: { tokens: { colorPrimary: { light: '#0f766e' } } },
+   * });
+   */
+  async update(themeId, params) {
+    if (!themeId) {
+      throw new Error("Theme ID is required");
+    }
+    return this.client.request({
+      method: "PATCH",
+      path: `/v1/themes/${encodeURIComponent(themeId)}`,
+      body: params
+    });
+  }
+  /**
+   * Delete one of your themes and return its final state. A theme that any of
+   * your pages uses, archived ones included, or that is your store's default
+   * theme, can't be deleted (a `ConflictError`): move those pages to another
+   * theme with `themeId` first.
+   */
+  async delete(themeId) {
+    if (!themeId) {
+      throw new Error("Theme ID is required");
+    }
+    return this.client.request({
+      method: "DELETE",
+      path: `/v1/themes/${encodeURIComponent(themeId)}`
+    });
+  }
+};
+
 // src/index.ts
 var CheckoutPageClient = class {
   accounts;
@@ -1423,6 +1694,7 @@ var CheckoutPageClient = class {
   taxRates;
   invoices;
   webhooks;
+  themes;
   client;
   constructor(options) {
     this.client = new CheckoutPageApiClient(options);
@@ -1443,6 +1715,7 @@ var CheckoutPageClient = class {
     this.taxRates = new TaxRateResource(this.client);
     this.invoices = new InvoiceResource(this.client);
     this.webhooks = new WebhookResource(this.client);
+    this.themes = new ThemeResource(this.client);
   }
 };
 var createCheckoutPageClient = (options) => {