@waffo/pancake-ts 0.3.4 → 0.4.1

package/dist/index.d.cts

@@ -211,7 +211,12 @@ declare enum ErrorLayer {
  * @see waffo-pancake-user-service/app/lib/utils/jwt.ts IssueSessionTokenRequest
  */
 interface IssueSessionTokenParams {
-    /** Buyer identity (email or any merchant-provided identifier string) */
+    /**
+     * Buyer identity — encoded into the JWT payload for merchant-side buyer
+     * identification. Accepts an email or any merchant-provided identifier string.
+     * To pre-fill the checkout page's email field, use `buyerEmail` on
+     * `checkout.authenticated.create`.
+     */
     buyerIdentity: string;
     /** Store ID (optional when `productId` is provided) */
     storeId?: string;
@@ -690,6 +695,16 @@ interface RequestedAmount {
     /** Currency code (ISO 4217) */
     currency: string;
 }
+/**
+ * Per-version data for a refund ticket. Each ticket can be submitted/resubmitted
+ * multiple times; this is the shape of a single submission.
+ */
+interface RefundTicketVersionData {
+    /** Refund reason supplied by the buyer */
+    reason: string;
+    /** Requested refund amount; `null` if the version has no amount recorded */
+    requestedAmount: RequestedAmount | null;
+}
 /** Parameters for creating a refund ticket (buyer-side). */
 interface CreateRefundTicketParams {
     /** Payment ID to refund */
@@ -742,8 +757,8 @@ interface RefundTicket {
     metadata: Record<string, unknown>;
     /** Current version number */
     versionNumber: number | null;
-    /** Current version data (includes reason, amount, etc.) */
-    versionData: Record<string, unknown> | null;
+    /** Current (latest) version data */
+    versionData: RefundTicketVersionData | null;
     /** Creation timestamp (ISO 8601) */
     createdAt: string;
     /** Last update timestamp (ISO 8601) */
@@ -752,8 +767,11 @@ interface RefundTicket {
 /**
  * Parameters for anonymous checkout.
  *
- * The buyer enters the checkout page without a session token and fills in
- * billing details manually. No identity is provided upfront.
+ * The buyer reaches the checkout page without a session token. Merchants may still
+ * pre-fill `buyerEmail` and `billingDetail`; omitting them leaves the form blank.
+ *
+ * Accepts every field of {@link CreateCheckoutSessionParams} — this wrapper simply
+ * forwards the params unchanged to `/v1/actions/checkout/create-session`.
  *
  * @example
  * const result = await client.checkout.anonymous.create({
@@ -762,61 +780,32 @@ interface RefundTicket {
  * });
  * // Redirect to result.checkoutUrl
  */
-interface AnonymousCheckoutParams {
-    /** Product ID */
-    productId: string;
-    /** Currency code (ISO 4217) */
-    currency: string;
-    /** Optional price snapshot override (reads from DB if omitted) */
-    priceSnapshot?: PriceInfo;
-    /** Trial toggle override (subscription only) */
-    withTrial?: boolean;
-    /** Redirect URL after successful payment */
-    successUrl?: string;
-    /** Session expiration in seconds (default: 45 minutes) */
-    expiresInSeconds?: number;
-    /** Dark mode override (true=dark, false=light, omit=use store default) */
-    darkMode?: boolean;
-    /** Custom metadata */
-    metadata?: Record<string, string>;
-}
+type AnonymousCheckoutParams = CreateCheckoutSessionParams;
 /**
  * Parameters for authenticated checkout.
  *
- * The merchant provides a buyer identity; the SDK issues a session token
- * and appends it to the checkout URL as a URL fragment.
+ * Merges the checkout-session fields ({@link CreateCheckoutSessionParams}) with the
+ * extra `buyerIdentity` required by `issue-session-token`. The wrapper splits the
+ * input: `buyerIdentity` goes to the token call; everything else (including
+ * `buyerEmail`) goes to the create-session call. The two fields are independent.
  *
  * @example
  * const result = await client.checkout.authenticated.create({
  *   productId: "PROD_xxx",
  *   currency: "USD",
- *   buyerIdentity: "customer@example.com",
+ *   buyerIdentity: "user-123",            // merchant-side buyer id (goes into JWT)
+ *   buyerEmail: "customer@example.com",   // pre-filled on the checkout page
  * });
  * // Redirect to result.checkoutUrl (includes #token=...)
  */
-interface AuthenticatedCheckoutParams {
-    /** Product ID */
-    productId: string;
-    /** Currency code (ISO 4217) */
-    currency: string;
-    /** Buyer identity (email or merchant-provided identifier) */
+interface AuthenticatedCheckoutParams extends CreateCheckoutSessionParams {
+    /**
+     * Buyer identity — sent to `issue-session-token` and encoded into the JWT
+     * payload for merchant-side buyer identification. Accepts an email or any
+     * merchant-provided identifier string. Use `buyerEmail` to pre-fill the
+     * checkout page's email input.
+     */
     buyerIdentity: string;
-    /** Pre-filled buyer email (defaults to `buyerIdentity` when omitted) */
-    buyerEmail?: string;
-    /** Pre-filled billing details */
-    billingDetail?: BillingDetail;
-    /** Optional price snapshot override (reads from DB if omitted) */
-    priceSnapshot?: PriceInfo;
-    /** Trial toggle override (subscription only) */
-    withTrial?: boolean;
-    /** Redirect URL after successful payment */
-    successUrl?: string;
-    /** Session expiration in seconds (default: 45 minutes) */
-    expiresInSeconds?: number;
-    /** Dark mode override (true=dark, false=light, omit=use store default) */
-    darkMode?: boolean;
-    /** Custom metadata */
-    metadata?: Record<string, string>;
 }
 /**
  * Result of an authenticated checkout creation.
@@ -1163,7 +1152,8 @@ declare class BuyerGraphQL {
 /**
  * Anonymous checkout — no buyer identity provided.
  *
- * The buyer fills in billing details manually on the checkout page.
+ * The buyer reaches the checkout page without a session token. Merchants may still
+ * pre-fill `buyerEmail` and `billingDetail` on the page by passing them here.
  * Internally creates a checkout session and returns the redirect URL.
  */
 declare class CheckoutAnonymousResource {
@@ -1176,11 +1166,20 @@ declare class CheckoutAnonymousResource {
      * @returns Session ID, checkout URL, and expiration
      *
      * @example
+     * // Minimal — buyer fills everything on the page
+     * const result = await client.checkout.anonymous.create({
+     *   productId: "PROD_xxx",
+     *   currency: "USD",
+     * });
+     *
+     * @example
+     * // Pre-fill email and billing without issuing a session token
      * const result = await client.checkout.anonymous.create({
      *   productId: "PROD_xxx",
      *   currency: "USD",
+     *   buyerEmail: "customer@example.com",
+     *   billingDetail: { country: "US", isBusiness: false, postcode: "10001" },
      * });
-     * // Redirect to result.checkoutUrl
      */
     create(params: AnonymousCheckoutParams): Promise<CheckoutSessionResult>;
 }
@@ -1199,10 +1198,12 @@ declare class CheckoutAuthenticatedResource {
      * Create an authenticated checkout session.
      *
      * Behavior:
-     * - Issues a session token via `issue-session-token`
-     * - Creates a checkout session via `create-session`
-     * - Appends the token to the checkout URL as a URL fragment
-     * - Defaults `buyerEmail` to `buyerIdentity` when omitted
+     * - Issues a session token via `issue-session-token` (receives `buyerIdentity` + `productId` only)
+     * - Creates a checkout session via `create-session` (receives every other field unchanged)
+     * - Appends the token to the checkout URL as a URL fragment (`#token=...`)
+     *
+     * `buyerIdentity` and `buyerEmail` are independent inputs: identity is for the JWT,
+     * email is for pre-filling the checkout page. The SDK forwards each to its own endpoint.
      *
      * @param params - Checkout parameters including buyer identity
      * @returns Session details with token-appended checkout URL
@@ -1211,7 +1212,8 @@ declare class CheckoutAuthenticatedResource {
      * const result = await client.checkout.authenticated.create({
      *   productId: "PROD_xxx",
      *   currency: "USD",
-     *   buyerIdentity: "customer@example.com",
+     *   buyerIdentity: "user-123",
+     *   buyerEmail: "customer@example.com",
      * });
      * // Redirect to result.checkoutUrl (includes #token=...)
      */
@@ -1239,7 +1241,8 @@ declare class CheckoutAuthenticatedResource {
  * const result = await client.checkout.authenticated.create({
  *   productId: "PROD_xxx",
  *   currency: "USD",
- *   buyerIdentity: "customer@example.com",
+ *   buyerIdentity: "userIdInYourSystem",
+ *   buyerEmail: "customer@example.com",
  * });
  * // result.checkoutUrl includes #token=...
  */
@@ -1830,4 +1833,4 @@ declare class WaffoPancakeError extends Error {
  */
 declare function verifyWebhook<T = Record<string, unknown>>(payload: string, signatureHeader: string | undefined | null, options?: VerifyWebhookOptions): WebhookEvent<T>;
 
-export { type AddMerchantParams, type AddMerchantResult, type AnonymousCheckoutParams, type ApiError, type ApiErrorResponse, type ApiResponse, type ApiSuccessResponse, type AuthenticatedCheckoutParams, type AuthenticatedCheckoutResult, type BillingDetail, BillingPeriod, type CancelOnetimeOrderParams, type CancelOnetimeOrderResult, type CancelSubscriptionParams, type CancelSubscriptionResult, type CheckoutSessionResult, type CheckoutSettings, type CheckoutThemeSettings, type CreateCheckoutSessionParams, type CreateOnetimeProductParams, type CreateRefundTicketParams, type CreateStoreParams, type CreateSubscriptionProductGroupParams, type CreateSubscriptionProductParams, type DeleteStoreParams, type DeleteSubscriptionProductGroupParams, EntityStatus, Environment, ErrorLayer, type GraphQLParams, type GraphQLResponse, type GroupRules, type IssueSessionTokenParams, type MediaItem, MediaType, type NotificationSettings, OnetimeOrderStatus, type OnetimeProductDetail, PaymentStatus, type PriceInfo, type Prices, ProductVersionStatus, type PublishOnetimeProductParams, type PublishSubscriptionProductGroupParams, type PublishSubscriptionProductParams, type ReactivateSubscriptionParams, type ReactivateSubscriptionResult, RefundStatus, type RefundTicket, RefundTicketStatus, type RemoveMerchantParams, type RemoveMerchantResult, type RequestedAmount, type ResubmitRefundTicketParams, type SessionToken, type Store, StoreRole, SubscriptionOrderStatus, type SubscriptionProductDetail, type SubscriptionProductGroup, TaxCategory, type UpdateOnetimeProductParams, type UpdateOnetimeStatusParams, type UpdateRoleParams, type UpdateRoleResult, type UpdateStoreParams, type UpdateSubscriptionProductGroupParams, type UpdateSubscriptionProductParams, type UpdateSubscriptionStatusParams, type VerifyWebhookOptions, WaffoPancake, type WaffoPancakeConfig, WaffoPancakeError, type WebhookEvent, type WebhookEventData, WebhookEventType, type WebhookPublicKeys, type WebhookSettings, verifyWebhook };
+export { type AddMerchantParams, type AddMerchantResult, type AnonymousCheckoutParams, type ApiError, type ApiErrorResponse, type ApiResponse, type ApiSuccessResponse, type AuthenticatedCheckoutParams, type AuthenticatedCheckoutResult, type BillingDetail, BillingPeriod, type CancelOnetimeOrderParams, type CancelOnetimeOrderResult, type CancelSubscriptionParams, type CancelSubscriptionResult, type CheckoutSessionResult, type CheckoutSettings, type CheckoutThemeSettings, type CreateCheckoutSessionParams, type CreateOnetimeProductParams, type CreateRefundTicketParams, type CreateStoreParams, type CreateSubscriptionProductGroupParams, type CreateSubscriptionProductParams, type DeleteStoreParams, type DeleteSubscriptionProductGroupParams, EntityStatus, Environment, ErrorLayer, type GraphQLParams, type GraphQLResponse, type GroupRules, type IssueSessionTokenParams, type MediaItem, MediaType, type NotificationSettings, OnetimeOrderStatus, type OnetimeProductDetail, PaymentStatus, type PriceInfo, type Prices, ProductVersionStatus, type PublishOnetimeProductParams, type PublishSubscriptionProductGroupParams, type PublishSubscriptionProductParams, type ReactivateSubscriptionParams, type ReactivateSubscriptionResult, RefundStatus, type RefundTicket, RefundTicketStatus, type RefundTicketVersionData, type RemoveMerchantParams, type RemoveMerchantResult, type RequestedAmount, type ResubmitRefundTicketParams, type SessionToken, type Store, StoreRole, SubscriptionOrderStatus, type SubscriptionProductDetail, type SubscriptionProductGroup, TaxCategory, type UpdateOnetimeProductParams, type UpdateOnetimeStatusParams, type UpdateRoleParams, type UpdateRoleResult, type UpdateStoreParams, type UpdateSubscriptionProductGroupParams, type UpdateSubscriptionProductParams, type UpdateSubscriptionStatusParams, type VerifyWebhookOptions, WaffoPancake, type WaffoPancakeConfig, WaffoPancakeError, type WebhookEvent, type WebhookEventData, WebhookEventType, type WebhookPublicKeys, type WebhookSettings, verifyWebhook };

package/dist/index.d.ts

@@ -211,7 +211,12 @@ declare enum ErrorLayer {
  * @see waffo-pancake-user-service/app/lib/utils/jwt.ts IssueSessionTokenRequest
  */
 interface IssueSessionTokenParams {
-    /** Buyer identity (email or any merchant-provided identifier string) */
+    /**
+     * Buyer identity — encoded into the JWT payload for merchant-side buyer
+     * identification. Accepts an email or any merchant-provided identifier string.
+     * To pre-fill the checkout page's email field, use `buyerEmail` on
+     * `checkout.authenticated.create`.
+     */
     buyerIdentity: string;
     /** Store ID (optional when `productId` is provided) */
     storeId?: string;
@@ -690,6 +695,16 @@ interface RequestedAmount {
     /** Currency code (ISO 4217) */
     currency: string;
 }
+/**
+ * Per-version data for a refund ticket. Each ticket can be submitted/resubmitted
+ * multiple times; this is the shape of a single submission.
+ */
+interface RefundTicketVersionData {
+    /** Refund reason supplied by the buyer */
+    reason: string;
+    /** Requested refund amount; `null` if the version has no amount recorded */
+    requestedAmount: RequestedAmount | null;
+}
 /** Parameters for creating a refund ticket (buyer-side). */
 interface CreateRefundTicketParams {
     /** Payment ID to refund */
@@ -742,8 +757,8 @@ interface RefundTicket {
     metadata: Record<string, unknown>;
     /** Current version number */
     versionNumber: number | null;
-    /** Current version data (includes reason, amount, etc.) */
-    versionData: Record<string, unknown> | null;
+    /** Current (latest) version data */
+    versionData: RefundTicketVersionData | null;
     /** Creation timestamp (ISO 8601) */
     createdAt: string;
     /** Last update timestamp (ISO 8601) */
@@ -752,8 +767,11 @@ interface RefundTicket {
 /**
  * Parameters for anonymous checkout.
  *
- * The buyer enters the checkout page without a session token and fills in
- * billing details manually. No identity is provided upfront.
+ * The buyer reaches the checkout page without a session token. Merchants may still
+ * pre-fill `buyerEmail` and `billingDetail`; omitting them leaves the form blank.
+ *
+ * Accepts every field of {@link CreateCheckoutSessionParams} — this wrapper simply
+ * forwards the params unchanged to `/v1/actions/checkout/create-session`.
  *
  * @example
  * const result = await client.checkout.anonymous.create({
@@ -762,61 +780,32 @@ interface RefundTicket {
  * });
  * // Redirect to result.checkoutUrl
  */
-interface AnonymousCheckoutParams {
-    /** Product ID */
-    productId: string;
-    /** Currency code (ISO 4217) */
-    currency: string;
-    /** Optional price snapshot override (reads from DB if omitted) */
-    priceSnapshot?: PriceInfo;
-    /** Trial toggle override (subscription only) */
-    withTrial?: boolean;
-    /** Redirect URL after successful payment */
-    successUrl?: string;
-    /** Session expiration in seconds (default: 45 minutes) */
-    expiresInSeconds?: number;
-    /** Dark mode override (true=dark, false=light, omit=use store default) */
-    darkMode?: boolean;
-    /** Custom metadata */
-    metadata?: Record<string, string>;
-}
+type AnonymousCheckoutParams = CreateCheckoutSessionParams;
 /**
  * Parameters for authenticated checkout.
  *
- * The merchant provides a buyer identity; the SDK issues a session token
- * and appends it to the checkout URL as a URL fragment.
+ * Merges the checkout-session fields ({@link CreateCheckoutSessionParams}) with the
+ * extra `buyerIdentity` required by `issue-session-token`. The wrapper splits the
+ * input: `buyerIdentity` goes to the token call; everything else (including
+ * `buyerEmail`) goes to the create-session call. The two fields are independent.
  *
  * @example
  * const result = await client.checkout.authenticated.create({
  *   productId: "PROD_xxx",
  *   currency: "USD",
- *   buyerIdentity: "customer@example.com",
+ *   buyerIdentity: "user-123",            // merchant-side buyer id (goes into JWT)
+ *   buyerEmail: "customer@example.com",   // pre-filled on the checkout page
  * });
  * // Redirect to result.checkoutUrl (includes #token=...)
  */
-interface AuthenticatedCheckoutParams {
-    /** Product ID */
-    productId: string;
-    /** Currency code (ISO 4217) */
-    currency: string;
-    /** Buyer identity (email or merchant-provided identifier) */
+interface AuthenticatedCheckoutParams extends CreateCheckoutSessionParams {
+    /**
+     * Buyer identity — sent to `issue-session-token` and encoded into the JWT
+     * payload for merchant-side buyer identification. Accepts an email or any
+     * merchant-provided identifier string. Use `buyerEmail` to pre-fill the
+     * checkout page's email input.
+     */
     buyerIdentity: string;
-    /** Pre-filled buyer email (defaults to `buyerIdentity` when omitted) */
-    buyerEmail?: string;
-    /** Pre-filled billing details */
-    billingDetail?: BillingDetail;
-    /** Optional price snapshot override (reads from DB if omitted) */
-    priceSnapshot?: PriceInfo;
-    /** Trial toggle override (subscription only) */
-    withTrial?: boolean;
-    /** Redirect URL after successful payment */
-    successUrl?: string;
-    /** Session expiration in seconds (default: 45 minutes) */
-    expiresInSeconds?: number;
-    /** Dark mode override (true=dark, false=light, omit=use store default) */
-    darkMode?: boolean;
-    /** Custom metadata */
-    metadata?: Record<string, string>;
 }
 /**
  * Result of an authenticated checkout creation.
@@ -1163,7 +1152,8 @@ declare class BuyerGraphQL {
 /**
  * Anonymous checkout — no buyer identity provided.
  *
- * The buyer fills in billing details manually on the checkout page.
+ * The buyer reaches the checkout page without a session token. Merchants may still
+ * pre-fill `buyerEmail` and `billingDetail` on the page by passing them here.
  * Internally creates a checkout session and returns the redirect URL.
  */
 declare class CheckoutAnonymousResource {
@@ -1176,11 +1166,20 @@ declare class CheckoutAnonymousResource {
      * @returns Session ID, checkout URL, and expiration
      *
      * @example
+     * // Minimal — buyer fills everything on the page
+     * const result = await client.checkout.anonymous.create({
+     *   productId: "PROD_xxx",
+     *   currency: "USD",
+     * });
+     *
+     * @example
+     * // Pre-fill email and billing without issuing a session token
      * const result = await client.checkout.anonymous.create({
      *   productId: "PROD_xxx",
      *   currency: "USD",
+     *   buyerEmail: "customer@example.com",
+     *   billingDetail: { country: "US", isBusiness: false, postcode: "10001" },
      * });
-     * // Redirect to result.checkoutUrl
      */
     create(params: AnonymousCheckoutParams): Promise<CheckoutSessionResult>;
 }
@@ -1199,10 +1198,12 @@ declare class CheckoutAuthenticatedResource {
      * Create an authenticated checkout session.
      *
      * Behavior:
-     * - Issues a session token via `issue-session-token`
-     * - Creates a checkout session via `create-session`
-     * - Appends the token to the checkout URL as a URL fragment
-     * - Defaults `buyerEmail` to `buyerIdentity` when omitted
+     * - Issues a session token via `issue-session-token` (receives `buyerIdentity` + `productId` only)
+     * - Creates a checkout session via `create-session` (receives every other field unchanged)
+     * - Appends the token to the checkout URL as a URL fragment (`#token=...`)
+     *
+     * `buyerIdentity` and `buyerEmail` are independent inputs: identity is for the JWT,
+     * email is for pre-filling the checkout page. The SDK forwards each to its own endpoint.
      *
      * @param params - Checkout parameters including buyer identity
      * @returns Session details with token-appended checkout URL
@@ -1211,7 +1212,8 @@ declare class CheckoutAuthenticatedResource {
      * const result = await client.checkout.authenticated.create({
      *   productId: "PROD_xxx",
      *   currency: "USD",
-     *   buyerIdentity: "customer@example.com",
+     *   buyerIdentity: "user-123",
+     *   buyerEmail: "customer@example.com",
      * });
      * // Redirect to result.checkoutUrl (includes #token=...)
      */
@@ -1239,7 +1241,8 @@ declare class CheckoutAuthenticatedResource {
  * const result = await client.checkout.authenticated.create({
  *   productId: "PROD_xxx",
  *   currency: "USD",
- *   buyerIdentity: "customer@example.com",
+ *   buyerIdentity: "userIdInYourSystem",
+ *   buyerEmail: "customer@example.com",
  * });
  * // result.checkoutUrl includes #token=...
  */
@@ -1830,4 +1833,4 @@ declare class WaffoPancakeError extends Error {
  */
 declare function verifyWebhook<T = Record<string, unknown>>(payload: string, signatureHeader: string | undefined | null, options?: VerifyWebhookOptions): WebhookEvent<T>;
 
-export { type AddMerchantParams, type AddMerchantResult, type AnonymousCheckoutParams, type ApiError, type ApiErrorResponse, type ApiResponse, type ApiSuccessResponse, type AuthenticatedCheckoutParams, type AuthenticatedCheckoutResult, type BillingDetail, BillingPeriod, type CancelOnetimeOrderParams, type CancelOnetimeOrderResult, type CancelSubscriptionParams, type CancelSubscriptionResult, type CheckoutSessionResult, type CheckoutSettings, type CheckoutThemeSettings, type CreateCheckoutSessionParams, type CreateOnetimeProductParams, type CreateRefundTicketParams, type CreateStoreParams, type CreateSubscriptionProductGroupParams, type CreateSubscriptionProductParams, type DeleteStoreParams, type DeleteSubscriptionProductGroupParams, EntityStatus, Environment, ErrorLayer, type GraphQLParams, type GraphQLResponse, type GroupRules, type IssueSessionTokenParams, type MediaItem, MediaType, type NotificationSettings, OnetimeOrderStatus, type OnetimeProductDetail, PaymentStatus, type PriceInfo, type Prices, ProductVersionStatus, type PublishOnetimeProductParams, type PublishSubscriptionProductGroupParams, type PublishSubscriptionProductParams, type ReactivateSubscriptionParams, type ReactivateSubscriptionResult, RefundStatus, type RefundTicket, RefundTicketStatus, type RemoveMerchantParams, type RemoveMerchantResult, type RequestedAmount, type ResubmitRefundTicketParams, type SessionToken, type Store, StoreRole, SubscriptionOrderStatus, type SubscriptionProductDetail, type SubscriptionProductGroup, TaxCategory, type UpdateOnetimeProductParams, type UpdateOnetimeStatusParams, type UpdateRoleParams, type UpdateRoleResult, type UpdateStoreParams, type UpdateSubscriptionProductGroupParams, type UpdateSubscriptionProductParams, type UpdateSubscriptionStatusParams, type VerifyWebhookOptions, WaffoPancake, type WaffoPancakeConfig, WaffoPancakeError, type WebhookEvent, type WebhookEventData, WebhookEventType, type WebhookPublicKeys, type WebhookSettings, verifyWebhook };
+export { type AddMerchantParams, type AddMerchantResult, type AnonymousCheckoutParams, type ApiError, type ApiErrorResponse, type ApiResponse, type ApiSuccessResponse, type AuthenticatedCheckoutParams, type AuthenticatedCheckoutResult, type BillingDetail, BillingPeriod, type CancelOnetimeOrderParams, type CancelOnetimeOrderResult, type CancelSubscriptionParams, type CancelSubscriptionResult, type CheckoutSessionResult, type CheckoutSettings, type CheckoutThemeSettings, type CreateCheckoutSessionParams, type CreateOnetimeProductParams, type CreateRefundTicketParams, type CreateStoreParams, type CreateSubscriptionProductGroupParams, type CreateSubscriptionProductParams, type DeleteStoreParams, type DeleteSubscriptionProductGroupParams, EntityStatus, Environment, ErrorLayer, type GraphQLParams, type GraphQLResponse, type GroupRules, type IssueSessionTokenParams, type MediaItem, MediaType, type NotificationSettings, OnetimeOrderStatus, type OnetimeProductDetail, PaymentStatus, type PriceInfo, type Prices, ProductVersionStatus, type PublishOnetimeProductParams, type PublishSubscriptionProductGroupParams, type PublishSubscriptionProductParams, type ReactivateSubscriptionParams, type ReactivateSubscriptionResult, RefundStatus, type RefundTicket, RefundTicketStatus, type RefundTicketVersionData, type RemoveMerchantParams, type RemoveMerchantResult, type RequestedAmount, type ResubmitRefundTicketParams, type SessionToken, type Store, StoreRole, SubscriptionOrderStatus, type SubscriptionProductDetail, type SubscriptionProductGroup, TaxCategory, type UpdateOnetimeProductParams, type UpdateOnetimeStatusParams, type UpdateRoleParams, type UpdateRoleResult, type UpdateStoreParams, type UpdateSubscriptionProductGroupParams, type UpdateSubscriptionProductParams, type UpdateSubscriptionStatusParams, type VerifyWebhookOptions, WaffoPancake, type WaffoPancakeConfig, WaffoPancakeError, type WebhookEvent, type WebhookEventData, WebhookEventType, type WebhookPublicKeys, type WebhookSettings, verifyWebhook };

package/dist/index.js

@@ -464,11 +464,20 @@ var CheckoutAnonymousResource = class {
    * @returns Session ID, checkout URL, and expiration
    *
    * @example
+   * // Minimal — buyer fills everything on the page
    * const result = await client.checkout.anonymous.create({
    *   productId: "PROD_xxx",
    *   currency: "USD",
    * });
-   * // Redirect to result.checkoutUrl
+   *
+   * @example
+   * // Pre-fill email and billing without issuing a session token
+   * const result = await client.checkout.anonymous.create({
+   *   productId: "PROD_xxx",
+   *   currency: "USD",
+   *   buyerEmail: "customer@example.com",
+   *   billingDetail: { country: "US", isBusiness: false, postcode: "10001" },
+   * });
    */
   async create(params) {
     validateCheckoutCommon(params);
@@ -485,10 +494,12 @@ var CheckoutAuthenticatedResource = class {
    * Create an authenticated checkout session.
    *
    * Behavior:
-   * - Issues a session token via `issue-session-token`
-   * - Creates a checkout session via `create-session`
-   * - Appends the token to the checkout URL as a URL fragment
-   * - Defaults `buyerEmail` to `buyerIdentity` when omitted
+   * - Issues a session token via `issue-session-token` (receives `buyerIdentity` + `productId` only)
+   * - Creates a checkout session via `create-session` (receives every other field unchanged)
+   * - Appends the token to the checkout URL as a URL fragment (`#token=...`)
+   *
+   * `buyerIdentity` and `buyerEmail` are independent inputs: identity is for the JWT,
+   * email is for pre-filling the checkout page. The SDK forwards each to its own endpoint.
    *
    * @param params - Checkout parameters including buyer identity
    * @returns Session details with token-appended checkout URL
@@ -497,14 +508,15 @@ var CheckoutAuthenticatedResource = class {
    * const result = await client.checkout.authenticated.create({
    *   productId: "PROD_xxx",
    *   currency: "USD",
-   *   buyerIdentity: "customer@example.com",
+   *   buyerIdentity: "user-123",
+   *   buyerEmail: "customer@example.com",
    * });
    * // Redirect to result.checkoutUrl (includes #token=...)
    */
   async create(params) {
     validateCheckoutCommon(params);
     validateRequired("buyerIdentity", params.buyerIdentity);
-    const { buyerIdentity, buyerEmail, ...sessionFields } = params;
+    const { buyerIdentity, ...sessionParams } = params;
     const [tokenResult, sessionResult] = await Promise.all([
       this.http.post(
         "/v1/actions/auth/issue-session-token",
@@ -514,14 +526,7 @@ var CheckoutAuthenticatedResource = class {
         },
         { idempotencyWindow: 60 }
       ),
-      this.http.post(
-        "/v1/actions/checkout/create-session",
-        {
-          ...sessionFields,
-          buyerEmail: buyerEmail ?? buyerIdentity
-        },
-        { idempotencyWindow: 60 }
-      )
+      this.http.post("/v1/actions/checkout/create-session", sessionParams, { idempotencyWindow: 60 })
     ]);
     return {
       sessionId: sessionResult.sessionId,