@waffo/pancake-ts 0.11.0 → 0.13.0

package/dist/index.js

@@ -11,9 +11,9 @@ var WaffoPancakeError = class extends Error {
   }
 };
 
-// src/buyer-http-client.ts
+// src/customer-http-client.ts
 var DEFAULT_BASE_URL = "https://api.waffo.ai";
-var BuyerHttpClient = class {
+var CustomerHttpClient = class {
   token;
   baseUrl;
   _fetch;
@@ -327,7 +327,7 @@ var AuthResource = class {
     this.http = http;
   }
   /**
-   * Issue a session token for a buyer.
+   * Issue a session token for a customer.
    *
    * @param params - Token issuance parameters
    * @returns Issued session token with expiration
@@ -361,122 +361,6 @@ var AuthResource = class {
   }
 };
 
-// src/resources/buyer.ts
-var BuyerSession = class {
-  constructor(http) {
-    this.http = http;
-    this.graphql = new BuyerGraphQL(http);
-  }
-  /** GraphQL query access scoped to the buyer's data. */
-  graphql;
-  /**
-   * Cancel a subscription order.
-   *
-   * @param params - Order to cancel
-   * @returns Order ID and resulting status
-   *
-   * @example
-   * const { orderId, status } = await buyer.cancelSubscription({ orderId: "ORD_xxx" });
-   * // status: "canceled" (was pending) or "canceling" (was active)
-   */
-  async cancelSubscription(params) {
-    validateShortId("orderId", params.orderId, "ORD");
-    return unwrapAction(await this.http.post("/v1/actions/subscription-order/cancel-order", params));
-  }
-  /**
-   * Cancel a one-time order (only while payment is still pending).
-   *
-   * @param params - Order to cancel
-   * @returns Order ID and resulting status
-   *
-   * @example
-   * const { orderId, status } = await buyer.cancelOnetimeOrder({ orderId: "ORD_xxx" });
-   */
-  async cancelOnetimeOrder(params) {
-    validateShortId("orderId", params.orderId, "ORD");
-    return unwrapAction(await this.http.post("/v1/actions/onetime-order/cancel-order", params));
-  }
-  /**
-   * Reactivate a subscription that is in `canceling` status.
-   *
-   * @param params - Order to reactivate
-   * @returns Order ID and resulting status
-   *
-   * @example
-   * const { orderId, status } = await buyer.reactivateSubscription({ orderId: "ORD_xxx" });
-   * // status: "active"
-   */
-  async reactivateSubscription(params) {
-    validateShortId("orderId", params.orderId, "ORD");
-    return unwrapAction(await this.http.post("/v1/actions/subscription-order/reactivate-order", params));
-  }
-  /**
-   * Submit a refund request for a payment.
-   *
-   * @param params - Refund ticket details
-   * @returns Created refund ticket
-   *
-   * @example
-   * const { ticket } = await buyer.createRefundTicket({
-   *   paymentId: "PAY_xxx",
-   *   reason: "Product not as described",
-   *   requestedAmount: { amount: "29.00", currency: "USD" },
-   *   refundTicketMerchantExternalId: "REF-2026-00891",
-   * });
-   */
-  async createRefundTicket(params) {
-    validateShortId("paymentId", params.paymentId, "PAY");
-    validateRequired("reason", params.reason);
-    validateAmountString("requestedAmount.amount", params.requestedAmount.amount);
-    validateCurrencyCode("requestedAmount.currency", params.requestedAmount.currency);
-    validateMaxLength("refundTicketMerchantExternalId", params.refundTicketMerchantExternalId, 128);
-    return unwrapAction(await this.http.post("/v1/actions/refund-ticket/create-ticket", params));
-  }
-  /**
-   * Resubmit a previously rejected refund ticket with updated details.
-   *
-   * @param params - Updated ticket details
-   * @returns Updated refund ticket
-   *
-   * @example
-   * const { ticket } = await buyer.resubmitRefundTicket({
-   *   ticketId: "TKT_xxx",
-   *   paymentId: "PAY_xxx",
-   *   reason: "Updated reason with more detail",
-   *   requestedAmount: { amount: "29.00", currency: "USD" },
-   * });
-   */
-  async resubmitRefundTicket(params) {
-    validateShortId("ticketId", params.ticketId, "TKT");
-    validateShortId("paymentId", params.paymentId, "PAY");
-    validateRequired("reason", params.reason);
-    validateAmountString("requestedAmount.amount", params.requestedAmount.amount);
-    validateCurrencyCode("requestedAmount.currency", params.requestedAmount.currency);
-    return unwrapAction(await this.http.post("/v1/actions/refund-ticket/resubmit-ticket", params));
-  }
-};
-var BuyerGraphQL = class {
-  constructor(http) {
-    this.http = http;
-  }
-  /**
-   * Execute a GraphQL query scoped to the buyer's data.
-   *
-   * @param params - GraphQL query and variables
-   * @returns GraphQL response
-   *
-   * @example
-   * const result = await buyer.graphql.query({
-   *   query: `query { orders { id status } }`,
-   * });
-   */
-  async query(params) {
-    validateRequired("query", params.query);
-    const result = await this.http.post("/v1/graphql", params);
-    return { data: result.data, errors: result.errors, warnings: result.warnings };
-  }
-};
-
 // src/resources/checkout-anonymous.ts
 var CheckoutAnonymousResource = class {
   constructor(http) {
@@ -485,11 +369,11 @@ var CheckoutAnonymousResource = class {
   /**
    * Create an anonymous checkout session.
    *
-   * @param params - Checkout parameters (no buyer identity required)
+   * @param params - Checkout parameters (no customer identity required)
    * @returns Session ID, checkout URL, and expiration
    *
    * @example
-   * // Minimal — buyer fills everything on the page
+   * // Minimal — customer fills everything on the page
    * const result = await client.checkout.anonymous.create({
    *   productId: "PROD_xxx",
    *   currency: "USD",
@@ -529,7 +413,7 @@ var CheckoutAuthenticatedResource = class {
    * `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
+   * @param params - Checkout parameters including customer identity
    * @returns Session details with token-appended checkout URL
    *
    * @example
@@ -578,9 +462,9 @@ var CheckoutResource = class {
     this.anonymous = new CheckoutAnonymousResource(http);
     this.authenticated = new CheckoutAuthenticatedResource(http);
   }
-  /** Anonymous checkout — no buyer identity, empty form. */
+  /** Anonymous checkout — no customer identity, empty form. */
   anonymous;
-  /** Authenticated checkout — merchant provides buyer identity. */
+  /** Authenticated checkout — merchant provides customer identity. */
   authenticated;
   /**
    * Create a checkout session (low-level). Returns a URL to redirect the customer to.
@@ -606,6 +490,122 @@ var CheckoutResource = class {
   }
 };
 
+// src/resources/customer.ts
+var CustomerSession = class {
+  constructor(http) {
+    this.http = http;
+    this.graphql = new CustomerGraphQL(http);
+  }
+  /** GraphQL query access scoped to the customer's data. */
+  graphql;
+  /**
+   * Cancel a subscription order.
+   *
+   * @param params - Order to cancel
+   * @returns Order ID and resulting status
+   *
+   * @example
+   * const { orderId, status } = await customer.cancelSubscription({ orderId: "ORD_xxx" });
+   * // status: "canceled" (was pending) or "canceling" (was active)
+   */
+  async cancelSubscription(params) {
+    validateShortId("orderId", params.orderId, "ORD");
+    return unwrapAction(await this.http.post("/v1/actions/subscription-order/cancel-order", params));
+  }
+  /**
+   * Cancel a one-time order (only while payment is still pending).
+   *
+   * @param params - Order to cancel
+   * @returns Order ID and resulting status
+   *
+   * @example
+   * const { orderId, status } = await customer.cancelOnetimeOrder({ orderId: "ORD_xxx" });
+   */
+  async cancelOnetimeOrder(params) {
+    validateShortId("orderId", params.orderId, "ORD");
+    return unwrapAction(await this.http.post("/v1/actions/onetime-order/cancel-order", params));
+  }
+  /**
+   * Reactivate a subscription that is in `canceling` status.
+   *
+   * @param params - Order to reactivate
+   * @returns Order ID and resulting status
+   *
+   * @example
+   * const { orderId, status } = await customer.reactivateSubscription({ orderId: "ORD_xxx" });
+   * // status: "active"
+   */
+  async reactivateSubscription(params) {
+    validateShortId("orderId", params.orderId, "ORD");
+    return unwrapAction(await this.http.post("/v1/actions/subscription-order/reactivate-order", params));
+  }
+  /**
+   * Submit a refund request for a payment.
+   *
+   * @param params - Refund ticket details
+   * @returns Created refund ticket
+   *
+   * @example
+   * const { ticket } = await customer.createRefundTicket({
+   *   paymentId: "PAY_xxx",
+   *   reason: "Product not as described",
+   *   requestedAmount: { amount: "29.00", currency: "USD" },
+   *   refundTicketMerchantExternalId: "REF-2026-00891",
+   * });
+   */
+  async createRefundTicket(params) {
+    validateShortId("paymentId", params.paymentId, "PAY");
+    validateRequired("reason", params.reason);
+    validateAmountString("requestedAmount.amount", params.requestedAmount.amount);
+    validateCurrencyCode("requestedAmount.currency", params.requestedAmount.currency);
+    validateMaxLength("refundTicketMerchantExternalId", params.refundTicketMerchantExternalId, 128);
+    return unwrapAction(await this.http.post("/v1/actions/refund-ticket/create-ticket", params));
+  }
+  /**
+   * Resubmit a previously rejected refund ticket with updated details.
+   *
+   * @param params - Updated ticket details
+   * @returns Updated refund ticket
+   *
+   * @example
+   * const { ticket } = await customer.resubmitRefundTicket({
+   *   ticketId: "TKT_xxx",
+   *   paymentId: "PAY_xxx",
+   *   reason: "Updated reason with more detail",
+   *   requestedAmount: { amount: "29.00", currency: "USD" },
+   * });
+   */
+  async resubmitRefundTicket(params) {
+    validateShortId("ticketId", params.ticketId, "TKT");
+    validateShortId("paymentId", params.paymentId, "PAY");
+    validateRequired("reason", params.reason);
+    validateAmountString("requestedAmount.amount", params.requestedAmount.amount);
+    validateCurrencyCode("requestedAmount.currency", params.requestedAmount.currency);
+    return unwrapAction(await this.http.post("/v1/actions/refund-ticket/resubmit-ticket", params));
+  }
+};
+var CustomerGraphQL = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Execute a GraphQL query scoped to the customer's data.
+   *
+   * @param params - GraphQL query and variables
+   * @returns GraphQL response
+   *
+   * @example
+   * const result = await customer.graphql.query({
+   *   query: `query { orders { id status } }`,
+   * });
+   */
+  async query(params) {
+    validateRequired("query", params.query);
+    const result = await this.http.post("/v1/graphql", params);
+    return { data: result.data, errors: result.errors, warnings: result.warnings };
+  }
+};
+
 // src/resources/graphql.ts
 var GraphQLResource = class {
   constructor(http) {
@@ -1297,29 +1297,45 @@ var WaffoPancake = class {
     this.webhooks = new WebhooksResource(this.http, config.webhookPublicKey);
   }
   /**
-   * Create a buyer session for self-service operations.
+   * Create a customer session for self-service operations.
    *
    * The returned session uses Bearer token authentication and provides
    * methods for order cancellation, subscription management, refund tickets,
    * and scoped GraphQL queries.
    *
    * @param token - Session token from `client.auth.issueSessionToken()`
-   * @returns A buyer session with self-service methods
+   * @returns A customer session with self-service methods
    *
    * @example
    * const { token } = await client.auth.issueSessionToken({
    *   storeId: "STO_xxx",
    *   buyerIdentity: "customer@example.com",
    * });
-   * const buyer = client.buyer(token);
-   * await buyer.cancelSubscription({ orderId: "ORD_xxx" });
+   * const customer = client.customer(token);
+   * await customer.cancelSubscription({ orderId: "ORD_xxx" });
    */
-  buyer(token) {
-    const buyerHttp = new BuyerHttpClient(token, {
+  customer(token) {
+    const customerHttp = new CustomerHttpClient(token, {
       baseUrl: this.config.baseUrl,
       fetch: this.config.fetch
     });
-    return new BuyerSession(buyerHttp);
+    return new CustomerSession(customerHttp);
+  }
+  /**
+   * Create a customer session for self-service operations.
+   *
+   * @param token - Session token from `client.auth.issueSessionToken()`
+   * @returns A customer session with self-service methods
+   *
+   * @example
+   * ```typescript
+   * const session = client.buyer(token); // prefer client.customer(token)
+   * ```
+   *
+   * @deprecated Use {@link WaffoPancake.customer} instead.
+   */
+  buyer(token) {
+    return this.customer(token);
   }
 };