@waffo/pancake-ts 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,1258 @@
+interface WaffoPancakeConfig {
+    /** Merchant ID (X-Merchant-Id header) */
+    merchantId: string;
+    /** RSA private key in PEM format for request signing */
+    privateKey: string;
+    /** Base URL override (default: https://waffo-pancake-auth-service.vercel.app) */
+    baseUrl?: string;
+    /** Custom fetch implementation (default: global fetch) */
+    fetch?: typeof fetch;
+}
+/**
+ * Single error object within the `errors` array.
+ *
+ * @example
+ * { message: "Store slug already exists", layer: "store" }
+ */
+interface ApiError {
+    /** Error message */
+    message: string;
+    /** Layer where the error originated */
+    layer: `${ErrorLayer}`;
+}
+/** Successful API response envelope. */
+interface ApiSuccessResponse<T> {
+    data: T;
+}
+/**
+ * Error API response envelope.
+ *
+ * `errors` are ordered by call stack: `[0]` is the deepest layer, `[n]` is the outermost.
+ */
+interface ApiErrorResponse {
+    data: null;
+    errors: ApiError[];
+}
+/** Union type of success and error API responses. */
+type ApiResponse<T> = ApiSuccessResponse<T> | ApiErrorResponse;
+/**
+ * Environment type.
+ * @see waffo-pancake-order-service/app/lib/types.ts
+ */
+declare enum Environment {
+    Test = "test",
+    Prod = "prod"
+}
+/**
+ * Tax category for products.
+ * @see waffo-pancake-product-service/app/lib/resources/types.ts
+ */
+declare enum TaxCategory {
+    DigitalGoods = "digital_goods",
+    SaaS = "saas",
+    Software = "software",
+    Ebook = "ebook",
+    OnlineCourse = "online_course",
+    Consulting = "consulting",
+    ProfessionalService = "professional_service"
+}
+/**
+ * Subscription billing period.
+ * @see waffo-pancake-product-service/app/lib/resources/types.ts
+ */
+declare enum BillingPeriod {
+    Weekly = "weekly",
+    Monthly = "monthly",
+    Quarterly = "quarterly",
+    Yearly = "yearly"
+}
+/**
+ * Product version status.
+ * @see waffo-pancake-product-service/app/lib/resources/types.ts
+ */
+declare enum ProductVersionStatus {
+    Active = "active",
+    Inactive = "inactive"
+}
+/**
+ * Store entity status.
+ * @see waffo-pancake-store-service/app/lib/resources/store.ts
+ */
+declare enum EntityStatus {
+    Active = "active",
+    Inactive = "inactive",
+    Suspended = "suspended"
+}
+/**
+ * Store member role.
+ * @see waffo-pancake-store-service/app/lib/resources/store.ts
+ */
+declare enum StoreRole {
+    Owner = "owner",
+    Admin = "admin",
+    Member = "member"
+}
+/**
+ * One-time order status.
+ * @see waffo-pancake-order-service/app/lib/resources/onetime-order.ts
+ */
+declare enum OnetimeOrderStatus {
+    Pending = "pending",
+    Completed = "completed",
+    Canceled = "canceled"
+}
+/**
+ * Subscription order status.
+ *
+ * State machine:
+ * - pending -> active, canceled
+ * - active -> canceling, past_due, canceled, expired
+ * - canceling -> active, canceled
+ * - past_due -> active, canceled
+ * - canceled -> terminal
+ * - expired -> terminal
+ *
+ * @see waffo-pancake-order-service/app/lib/resources/subscription-order.ts
+ */
+declare enum SubscriptionOrderStatus {
+    Pending = "pending",
+    Active = "active",
+    Canceling = "canceling",
+    Canceled = "canceled",
+    PastDue = "past_due",
+    Expired = "expired"
+}
+/**
+ * Payment status.
+ * @see waffo-pancake-order-service/app/lib/resources/payment.ts
+ */
+declare enum PaymentStatus {
+    Pending = "pending",
+    Succeeded = "succeeded",
+    Failed = "failed",
+    Canceled = "canceled"
+}
+/**
+ * Refund ticket status.
+ * @see waffo-pancake-order-service/app/lib/resources/refund-ticket.ts
+ */
+declare enum RefundTicketStatus {
+    Pending = "pending",
+    Approved = "approved",
+    Rejected = "rejected",
+    Processing = "processing",
+    Succeeded = "succeeded",
+    Failed = "failed"
+}
+/**
+ * Refund status.
+ * @see waffo-pancake-order-service/app/lib/resources/refund.ts
+ */
+declare enum RefundStatus {
+    Succeeded = "succeeded",
+    Failed = "failed"
+}
+/**
+ * Media asset type.
+ * @see waffo-pancake-product-service/app/lib/resources/types.ts
+ */
+declare enum MediaType {
+    Image = "image",
+    Video = "video"
+}
+/**
+ * Checkout session product type.
+ * @see waffo-pancake-order-service/app/lib/types.ts
+ */
+declare enum CheckoutSessionProductType {
+    Onetime = "onetime",
+    Subscription = "subscription"
+}
+/** Error layer identifier in the call stack. */
+declare enum ErrorLayer {
+    Gateway = "gateway",
+    User = "user",
+    Store = "store",
+    Product = "product",
+    Order = "order",
+    GraphQL = "graphql",
+    Resource = "resource",
+    Email = "email"
+}
+/**
+ * Parameters for issuing a buyer session token.
+ * @see waffo-pancake-user-service/app/lib/utils/jwt.ts IssueSessionTokenRequest
+ */
+interface IssueSessionTokenParams {
+    /** Buyer identity (email or any merchant-provided identifier string) */
+    buyerIdentity: string;
+    /** Store ID */
+    storeId: string;
+}
+/**
+ * Issued session token response.
+ *
+ * @example
+ * { token: "eyJhbGciOi...", expiresAt: "2026-03-10T09:00:00.000Z" }
+ */
+interface SessionToken {
+    /** JWT token string */
+    token: string;
+    /** Expiration time (ISO 8601 UTC) */
+    expiresAt: string;
+}
+/**
+ * Webhook configuration for test and production environments.
+ * @see waffo-pancake-store-service/app/lib/types.ts
+ */
+interface WebhookSettings {
+    /** Test environment webhook URL */
+    testWebhookUrl: string | null;
+    /** Production environment webhook URL */
+    prodWebhookUrl: string | null;
+    /** Event types subscribed in test environment */
+    testEvents: string[];
+    /** Event types subscribed in production environment */
+    prodEvents: string[];
+}
+/**
+ * Notification settings (all default to true).
+ * @see waffo-pancake-store-service/app/lib/types.ts
+ */
+interface NotificationSettings {
+    emailOrderConfirmation: boolean;
+    emailSubscriptionConfirmation: boolean;
+    emailSubscriptionCycled: boolean;
+    emailSubscriptionCanceled: boolean;
+    emailSubscriptionRevoked: boolean;
+    emailSubscriptionPastDue: boolean;
+    notifyNewOrders: boolean;
+    notifyNewSubscriptions: boolean;
+}
+/**
+ * Single-theme checkout page styling.
+ * @see waffo-pancake-store-service/app/lib/types.ts
+ */
+interface CheckoutThemeSettings {
+    checkoutLogo: string | null;
+    checkoutColorPrimary: string;
+    checkoutColorBackground: string;
+    checkoutColorCard: string;
+    checkoutColorText: string;
+    checkoutColorTextSecondary: string;
+    checkoutBorderRadius: string;
+}
+/**
+ * Checkout page configuration (light and dark themes).
+ * @see waffo-pancake-store-service/app/lib/types.ts
+ */
+interface CheckoutSettings {
+    light: CheckoutThemeSettings;
+    dark: CheckoutThemeSettings;
+}
+/**
+ * Store entity.
+ * @see waffo-pancake-store-service/app/lib/resources/store.ts
+ */
+interface Store {
+    id: string;
+    name: string;
+    status: EntityStatus;
+    logo: string | null;
+    supportEmail: string | null;
+    website: string | null;
+    slug: string | null;
+    isPublic: boolean;
+    prodEnabled: boolean;
+    webhookSettings: WebhookSettings | null;
+    notificationSettings: NotificationSettings | null;
+    checkoutSettings: CheckoutSettings | null;
+    deletedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Parameters for creating a store. */
+interface CreateStoreParams {
+    /** Store name (slug is auto-generated) */
+    name: string;
+}
+/** Parameters for updating a store. */
+interface UpdateStoreParams {
+    /** Store ID */
+    id: string;
+    name?: string;
+    status?: EntityStatus;
+    logo?: string | null;
+    supportEmail?: string | null;
+    website?: string | null;
+    isPublic?: boolean;
+    webhookSettings?: WebhookSettings | null;
+    notificationSettings?: NotificationSettings | null;
+    checkoutSettings?: CheckoutSettings | null;
+}
+/** Parameters for deleting (soft-delete) a store. */
+interface DeleteStoreParams {
+    /** Store ID */
+    id: string;
+}
+/** Parameters for adding a merchant to a store. */
+interface AddMerchantParams {
+    storeId: string;
+    email: string;
+    role: "admin" | "member";
+}
+/** Result of adding a merchant to a store. */
+interface AddMerchantResult {
+    storeId: string;
+    merchantId: string;
+    email: string;
+    role: string;
+    status: string;
+    addedAt: string;
+}
+/** Parameters for removing a merchant from a store. */
+interface RemoveMerchantParams {
+    storeId: string;
+    merchantId: string;
+}
+/** Result of removing a merchant from a store. */
+interface RemoveMerchantResult {
+    message: string;
+    removedAt: string;
+}
+/** Parameters for updating a merchant's role. */
+interface UpdateRoleParams {
+    storeId: string;
+    merchantId: string;
+    role: "admin" | "member";
+}
+/** Result of updating a merchant's role. */
+interface UpdateRoleResult {
+    storeId: string;
+    merchantId: string;
+    role: string;
+    updatedAt: string;
+}
+/**
+ * Price for a single currency.
+ *
+ * Amounts are stored in the smallest currency unit (e.g. cents, yen)
+ * to avoid floating-point precision issues.
+ *
+ * @see waffo-pancake-product-service/app/lib/resources/types.ts
+ *
+ * @example
+ * // USD $9.99
+ * { amount: 999, taxIncluded: true, taxCategory: "saas" }
+ *
+ * @example
+ * // JPY ¥1000
+ * { amount: 1000, taxIncluded: false, taxCategory: "software" }
+ */
+interface PriceInfo {
+    /** Price amount in smallest currency unit */
+    amount: number;
+    /** Whether the price is tax-inclusive */
+    taxIncluded: boolean;
+    /** Tax category */
+    taxCategory: TaxCategory;
+}
+/**
+ * Multi-currency prices (keyed by ISO 4217 currency code).
+ *
+ * @see waffo-pancake-product-service/app/lib/resources/types.ts
+ *
+ * @example
+ * {
+ *   "USD": { amount: 999, taxIncluded: true, taxCategory: "saas" },
+ *   "EUR": { amount: 899, taxIncluded: true, taxCategory: "saas" }
+ * }
+ */
+type Prices = Record<string, PriceInfo>;
+/**
+ * Media asset (image or video).
+ * @see waffo-pancake-product-service/app/lib/resources/types.ts
+ */
+interface MediaItem {
+    /** Media type */
+    type: `${MediaType}`;
+    /** Asset URL */
+    url: string;
+    /** Alt text */
+    alt?: string;
+    /** Thumbnail URL */
+    thumbnail?: string;
+}
+/**
+ * One-time product detail (public API shape).
+ * @see waffo-pancake-product-service/app/lib/resources/onetime-product.ts OnetimeProductDetail
+ */
+interface OnetimeProductDetail {
+    id: string;
+    storeId: string;
+    name: string;
+    description: string | null;
+    prices: Prices;
+    media: MediaItem[];
+    successUrl: string | null;
+    metadata: Record<string, unknown>;
+    status: ProductVersionStatus;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Parameters for creating a one-time product.
+ * @see waffo-pancake-product-service/app/lib/resources/onetime-product.ts CreateOnetimeProductRequestBody
+ */
+interface CreateOnetimeProductParams {
+    storeId: string;
+    name: string;
+    prices: Prices;
+    description?: string;
+    media?: MediaItem[];
+    successUrl?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Parameters for updating a one-time product (creates a new version; skips if unchanged).
+ * @see waffo-pancake-product-service/app/lib/resources/onetime-product.ts UpdateOnetimeProductContentRequestBody
+ */
+interface UpdateOnetimeProductParams {
+    id: string;
+    name: string;
+    prices: Prices;
+    description?: string;
+    media?: MediaItem[];
+    successUrl?: string;
+    metadata?: Record<string, unknown>;
+}
+/** Parameters for publishing a one-time product's test version to production. */
+interface PublishOnetimeProductParams {
+    /** Product ID */
+    id: string;
+}
+/**
+ * Parameters for updating a one-time product's status.
+ * @see waffo-pancake-product-service/app/lib/resources/onetime-product.ts UpdateOnetimeStatusRequestBody
+ */
+interface UpdateOnetimeStatusParams {
+    id: string;
+    status: ProductVersionStatus;
+}
+/**
+ * Subscription product detail (public API shape).
+ * @see waffo-pancake-product-service/app/lib/resources/subscription-product.ts SubscriptionProductDetail
+ */
+interface SubscriptionProductDetail {
+    id: string;
+    storeId: string;
+    name: string;
+    description: string | null;
+    billingPeriod: BillingPeriod;
+    prices: Prices;
+    media: MediaItem[];
+    successUrl: string | null;
+    metadata: Record<string, unknown>;
+    status: ProductVersionStatus;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Parameters for creating a subscription product.
+ * @see waffo-pancake-product-service/app/lib/resources/subscription-product.ts CreateSubscriptionProductRequestBody
+ */
+interface CreateSubscriptionProductParams {
+    storeId: string;
+    name: string;
+    billingPeriod: BillingPeriod;
+    prices: Prices;
+    description?: string;
+    media?: MediaItem[];
+    successUrl?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Parameters for updating a subscription product (creates a new version; skips if unchanged).
+ * @see waffo-pancake-product-service/app/lib/resources/subscription-product.ts UpdateSubscriptionProductContentRequestBody
+ */
+interface UpdateSubscriptionProductParams {
+    id: string;
+    name: string;
+    billingPeriod: BillingPeriod;
+    prices: Prices;
+    description?: string;
+    media?: MediaItem[];
+    successUrl?: string;
+    metadata?: Record<string, unknown>;
+}
+/** Parameters for publishing a subscription product's test version to production. */
+interface PublishSubscriptionProductParams {
+    /** Product ID */
+    id: string;
+}
+/**
+ * Parameters for updating a subscription product's status.
+ * @see waffo-pancake-product-service/app/lib/resources/subscription-product.ts UpdateSubscriptionStatusRequestBody
+ */
+interface UpdateSubscriptionStatusParams {
+    id: string;
+    status: ProductVersionStatus;
+}
+/**
+ * Group rules for subscription product groups.
+ * @see waffo-pancake-product-service/app/lib/resources/subscription-product-group.ts
+ */
+interface GroupRules {
+    /** Whether trial period is shared across products in the group */
+    sharedTrial: boolean;
+}
+/**
+ * Subscription product group entity.
+ * @see waffo-pancake-product-service/app/lib/resources/subscription-product-group.ts
+ */
+interface SubscriptionProductGroup {
+    id: string;
+    storeId: string;
+    name: string;
+    description: string | null;
+    rules: GroupRules;
+    productIds: string[];
+    environment: Environment;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Parameters for creating a subscription product group.
+ * @see waffo-pancake-product-service/app/lib/resources/subscription-product-group.ts CreateGroupRequestBody
+ */
+interface CreateSubscriptionProductGroupParams {
+    storeId: string;
+    name: string;
+    description?: string;
+    rules?: GroupRules;
+    productIds?: string[];
+}
+/**
+ * Parameters for updating a subscription product group (`productIds` is a full replacement).
+ * @see waffo-pancake-product-service/app/lib/resources/subscription-product-group.ts UpdateGroupRequestBody
+ */
+interface UpdateSubscriptionProductGroupParams {
+    id: string;
+    name?: string;
+    description?: string;
+    rules?: GroupRules;
+    productIds?: string[];
+}
+/** Parameters for hard-deleting a subscription product group. */
+interface DeleteSubscriptionProductGroupParams {
+    /** Group ID */
+    id: string;
+}
+/** Parameters for publishing a test-environment group to production (upsert). */
+interface PublishSubscriptionProductGroupParams {
+    /** Group ID */
+    id: string;
+}
+/** Parameters for canceling a subscription order. */
+interface CancelSubscriptionParams {
+    /** Order ID */
+    orderId: string;
+}
+/**
+ * Result of canceling a subscription order.
+ * @see waffo-pancake-order-service cancel-order route.ts
+ */
+interface CancelSubscriptionResult {
+    orderId: string;
+    /** Status after cancellation (`"canceled"` or `"canceling"`) */
+    status: `${SubscriptionOrderStatus}`;
+}
+/**
+ * Buyer billing details for checkout.
+ * @see waffo-pancake-order-service/app/lib/types.ts
+ */
+interface BillingDetail {
+    /** Country code (ISO 3166-1 alpha-2) */
+    country: string;
+    /** Whether this is a business purchase */
+    isBusiness: boolean;
+    /** Postal / ZIP code */
+    postcode?: string;
+    /** State / province code (required for US/CA) */
+    state?: string;
+    /** Business name (required when isBusiness=true) */
+    businessName?: string;
+    /** Tax ID (required for EU businesses) */
+    taxId?: string;
+}
+/**
+ * Parameters for creating a checkout session.
+ * @see waffo-pancake-order-service/app/lib/types.ts CreateCheckoutSessionRequest
+ */
+interface CreateCheckoutSessionParams {
+    /** Store ID */
+    storeId?: string;
+    /** Product ID */
+    productId: string;
+    /** Product type */
+    productType: `${CheckoutSessionProductType}`;
+    /** Currency code (ISO 4217) */
+    currency: string;
+    /** Optional price snapshot override (reads from DB if omitted) */
+    priceSnapshot?: PriceInfo;
+    /** Trial toggle override (subscription only) */
+    withTrial?: boolean;
+    /** Pre-filled buyer email */
+    buyerEmail?: string;
+    /** Pre-filled billing details */
+    billingDetail?: BillingDetail;
+    /** Redirect URL after successful payment */
+    successUrl?: string;
+    /** Session expiration in seconds (default: 7 days) */
+    expiresInSeconds?: number;
+    /** Custom metadata */
+    metadata?: Record<string, string>;
+}
+/** Result of creating a checkout session. */
+interface CheckoutSessionResult {
+    /** Session ID */
+    sessionId: string;
+    /** URL to redirect the customer to */
+    checkoutUrl: string;
+    /** Session expiration time (ISO 8601 UTC) */
+    expiresAt: string;
+}
+/** Parameters for a GraphQL query. */
+interface GraphQLParams {
+    /** GraphQL query string */
+    query: string;
+    /** Query variables */
+    variables?: Record<string, unknown>;
+}
+/** GraphQL response envelope. */
+interface GraphQLResponse<T = Record<string, unknown>> {
+    data: T | null;
+    errors?: Array<{
+        message: string;
+        locations?: Array<{
+            line: number;
+            column: number;
+        }>;
+        path?: string[];
+    }>;
+}
+/**
+ * Webhook event types.
+ * @see docs/api-reference/webhooks.mdx
+ */
+declare enum WebhookEventType {
+    /** One-time order first payment succeeded */
+    OrderCompleted = "order.completed",
+    /** Subscription first payment succeeded (newly activated) */
+    SubscriptionActivated = "subscription.activated",
+    /** Subscription renewal payment succeeded */
+    SubscriptionPaymentSucceeded = "subscription.payment_succeeded",
+    /** Buyer initiated cancellation (expires at end of current period) */
+    SubscriptionCanceling = "subscription.canceling",
+    /** Buyer withdrew cancellation (subscription restored) */
+    SubscriptionUncanceled = "subscription.uncanceled",
+    /** Subscription product changed (upgrade/downgrade) */
+    SubscriptionUpdated = "subscription.updated",
+    /** Subscription fully terminated */
+    SubscriptionCanceled = "subscription.canceled",
+    /** Renewal payment failed (past due) */
+    SubscriptionPastDue = "subscription.past_due",
+    /** Refund succeeded */
+    RefundSucceeded = "refund.succeeded",
+    /** Refund failed */
+    RefundFailed = "refund.failed"
+}
+/**
+ * Common data fields in a webhook event payload.
+ * @see docs/api-reference/webhooks.mdx
+ */
+interface WebhookEventData {
+    orderId: string;
+    buyerEmail: string;
+    currency: string;
+    /** Amount in smallest currency unit */
+    amount: number;
+    /** Tax amount in smallest currency unit */
+    taxAmount: number;
+    productName: string;
+}
+/**
+ * Webhook event payload.
+ *
+ * @see docs/api-reference/webhooks.mdx
+ *
+ * @example
+ * {
+ *   id: "550e8400-...",
+ *   timestamp: "2026-03-10T08:30:00.000Z",
+ *   eventType: "order.completed",
+ *   eventId: "pay_660e8400-...",
+ *   storeId: "770e8400-...",
+ *   mode: "prod",
+ *   data: { orderId: "...", buyerEmail: "...", currency: "USD", amount: 2900, taxAmount: 290, productName: "Pro Plan" }
+ * }
+ */
+interface WebhookEvent<T = WebhookEventData> {
+    /** Delivery record unique ID (UUID), usable for idempotent deduplication */
+    id: string;
+    /** Event timestamp (ISO 8601 UTC) */
+    timestamp: string;
+    /** Event type */
+    eventType: `${WebhookEventType}` | (string & {});
+    /** Business event ID (e.g. payment ID, order ID) */
+    eventId: string;
+    /** Store ID the event belongs to */
+    storeId: string;
+    /** Environment identifier */
+    mode: `${Environment}`;
+    /** Event data */
+    data: T;
+}
+/** Options for {@link verifyWebhook}. */
+interface VerifyWebhookOptions {
+    /**
+     * Specify which environment's public key to use for verification.
+     * When omitted, both keys are tried automatically (prod first).
+     */
+    environment?: `${Environment}`;
+    /**
+     * Timestamp tolerance window in milliseconds for replay protection.
+     * Set to 0 to skip timestamp checking.
+     * @default 300000 (5 minutes)
+     */
+    toleranceMs?: number;
+}
+
+/**
+ * Internal HTTP client that auto-signs requests and attaches idempotency keys.
+ *
+ * Not exported publicly — used by resource classes via {@link WaffoPancake}.
+ */
+declare class HttpClient {
+    private readonly merchantId;
+    private readonly privateKey;
+    private readonly baseUrl;
+    private readonly _fetch;
+    constructor(config: WaffoPancakeConfig);
+    /**
+     * Send a signed POST request and return the parsed `data` field.
+     *
+     * Behavior:
+     * - Generates a deterministic `X-Idempotency-Key` from `merchantId + path + body` (same request produces same key)
+     * - Auto-builds RSA-SHA256 signature (`X-Merchant-Id` / `X-Timestamp` / `X-Signature`)
+     * - Unwraps the response envelope: returns `data` on success, throws `WaffoPancakeError` on failure
+     *
+     * @param path - API path (e.g. `/v1/actions/store/create-store`)
+     * @param body - Request body object
+     * @returns Parsed `data` field from the response
+     * @throws {WaffoPancakeError} When the API returns errors
+     */
+    post<T>(path: string, body: object): Promise<T>;
+}
+
+/** Authentication resource — issue session tokens for buyers. */
+declare class AuthResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Issue a session token for a buyer.
+     *
+     * @param params - Token issuance parameters
+     * @returns Issued session token with expiration
+     *
+     * @example
+     * const { token, expiresAt } = await client.auth.issueSessionToken({
+     *   storeId: "store_xxx",
+     *   buyerIdentity: "customer@example.com",
+     * });
+     */
+    issueSessionToken(params: IssueSessionTokenParams): Promise<SessionToken>;
+}
+
+/** Checkout resource — create checkout sessions for payments. */
+declare class CheckoutResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Create a checkout session. Returns a URL to redirect the customer to.
+     *
+     * @param params - Checkout session parameters
+     * @returns Session ID, checkout URL, and expiration
+     *
+     * @example
+     * const session = await client.checkout.createSession({
+     *   storeId: "store_xxx",
+     *   productId: "prod_xxx",
+     *   productType: "onetime",
+     *   currency: "USD",
+     *   buyerEmail: "customer@example.com",
+     * });
+     * // Redirect to session.checkoutUrl
+     */
+    createSession(params: CreateCheckoutSessionParams): Promise<CheckoutSessionResult>;
+}
+
+/** GraphQL query resource (Query only, no Mutations). */
+declare class GraphQLResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Execute a GraphQL query (Query only, no Mutations).
+     *
+     * @param params - GraphQL query and optional variables
+     * @returns GraphQL response with data and optional errors
+     *
+     * @example
+     * const result = await client.graphql.query<{ stores: Array<{ id: string; name: string }> }>({
+     *   query: `query { stores { id name status } }`,
+     * });
+     * console.log(result.data?.stores);
+     *
+     * @example
+     * const result = await client.graphql.query({
+     *   query: `query ($id: ID!) { onetimeProduct(id: $id) { id name prices } }`,
+     *   variables: { id: "prod_xxx" },
+     * });
+     */
+    query<T = Record<string, unknown>>(params: GraphQLParams): Promise<GraphQLResponse<T>>;
+}
+
+/** One-time product management resource. */
+declare class OnetimeProductsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Create a one-time product with multi-currency pricing.
+     *
+     * @param params - Product creation parameters
+     * @returns Created product detail
+     *
+     * @example
+     * const { product } = await client.onetimeProducts.create({
+     *   storeId: "store_xxx",
+     *   name: "E-Book",
+     *   prices: { USD: { amount: 2900, taxIncluded: false, taxCategory: "digital_goods" } },
+     * });
+     */
+    create(params: CreateOnetimeProductParams): Promise<{
+        product: OnetimeProductDetail;
+    }>;
+    /**
+     * Update a one-time product. Creates a new version; skips if unchanged.
+     *
+     * @param params - Product update parameters (all content fields required)
+     * @returns Updated product detail
+     *
+     * @example
+     * const { product } = await client.onetimeProducts.update({
+     *   id: "prod_xxx",
+     *   name: "E-Book v2",
+     *   prices: { USD: { amount: 3900, taxIncluded: false, taxCategory: "digital_goods" } },
+     * });
+     */
+    update(params: UpdateOnetimeProductParams): Promise<{
+        product: OnetimeProductDetail;
+    }>;
+    /**
+     * Publish a one-time product's test version to production.
+     *
+     * @param params - Product to publish
+     * @returns Published product detail
+     *
+     * @example
+     * const { product } = await client.onetimeProducts.publish({ id: "prod_xxx" });
+     */
+    publish(params: PublishOnetimeProductParams): Promise<{
+        product: OnetimeProductDetail;
+    }>;
+    /**
+     * Update a one-time product's status (active/inactive).
+     *
+     * @param params - Status update parameters
+     * @returns Updated product detail
+     *
+     * @example
+     * const { product } = await client.onetimeProducts.updateStatus({
+     *   id: "prod_xxx",
+     *   status: ProductVersionStatus.Inactive,
+     * });
+     */
+    updateStatus(params: UpdateOnetimeStatusParams): Promise<{
+        product: OnetimeProductDetail;
+    }>;
+}
+
+/** Order management resource. */
+declare class OrdersResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Cancel a subscription order.
+     *
+     * - pending -> canceled (immediate)
+     * - active/trialing -> canceling (PSP cancel, webhook updates later)
+     *
+     * @param params - Order to cancel
+     * @returns Order ID and resulting status
+     *
+     * @example
+     * const { orderId, status } = await client.orders.cancelSubscription({
+     *   orderId: "order_xxx",
+     * });
+     * // status: "canceled" or "canceling"
+     */
+    cancelSubscription(params: CancelSubscriptionParams): Promise<CancelSubscriptionResult>;
+}
+
+/** Store merchant management resource (coming soon — endpoints return 501). */
+declare class StoreMerchantsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Add a merchant to a store.
+     *
+     * @param params - Merchant addition parameters
+     * @returns Added merchant details
+     *
+     * @example
+     * const result = await client.storeMerchants.add({
+     *   storeId: "store_xxx",
+     *   email: "member@example.com",
+     *   role: "admin",
+     * });
+     */
+    add(params: AddMerchantParams): Promise<AddMerchantResult>;
+    /**
+     * Remove a merchant from a store.
+     *
+     * @param params - Merchant removal parameters
+     * @returns Removal confirmation
+     *
+     * @example
+     * const result = await client.storeMerchants.remove({
+     *   storeId: "store_xxx",
+     *   merchantId: "merchant_xxx",
+     * });
+     */
+    remove(params: RemoveMerchantParams): Promise<RemoveMerchantResult>;
+    /**
+     * Update a merchant's role in a store.
+     *
+     * @param params - Role update parameters
+     * @returns Updated role details
+     *
+     * @example
+     * const result = await client.storeMerchants.updateRole({
+     *   storeId: "store_xxx",
+     *   merchantId: "merchant_xxx",
+     *   role: "member",
+     * });
+     */
+    updateRole(params: UpdateRoleParams): Promise<UpdateRoleResult>;
+}
+
+/** Store management resource — create, update, and delete stores. */
+declare class StoresResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Create a new store. Slug is auto-generated from the name.
+     *
+     * @param params - Store creation parameters
+     * @returns Created store entity
+     *
+     * @example
+     * const { store } = await client.stores.create({ name: "My Store" });
+     */
+    create(params: CreateStoreParams): Promise<{
+        store: Store;
+    }>;
+    /**
+     * Update an existing store's settings.
+     *
+     * @param params - Fields to update (only provided fields are changed)
+     * @returns Updated store entity
+     *
+     * @example
+     * const { store } = await client.stores.update({
+     *   id: "store_xxx",
+     *   name: "Updated Name",
+     *   supportEmail: "help@example.com",
+     * });
+     */
+    update(params: UpdateStoreParams): Promise<{
+        store: Store;
+    }>;
+    /**
+     * Soft-delete a store. Only the owner can delete.
+     *
+     * @param params - Store to delete
+     * @returns Deleted store entity (with `deletedAt` set)
+     *
+     * @example
+     * const { store } = await client.stores.delete({ id: "store_xxx" });
+     */
+    delete(params: DeleteStoreParams): Promise<{
+        store: Store;
+    }>;
+}
+
+/** Subscription product group management resource (shared trial, plan switching). */
+declare class SubscriptionProductGroupsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Create a subscription product group for shared-trial or plan switching.
+     *
+     * @param params - Group creation parameters
+     * @returns Created group entity
+     *
+     * @example
+     * const { group } = await client.subscriptionProductGroups.create({
+     *   storeId: "store_xxx",
+     *   name: "Pro Plans",
+     *   rules: { sharedTrial: true },
+     *   productIds: ["prod_aaa", "prod_bbb"],
+     * });
+     */
+    create(params: CreateSubscriptionProductGroupParams): Promise<{
+        group: SubscriptionProductGroup;
+    }>;
+    /**
+     * Update a subscription product group. `productIds` is a full replacement.
+     *
+     * @param params - Group update parameters
+     * @returns Updated group entity
+     *
+     * @example
+     * const { group } = await client.subscriptionProductGroups.update({
+     *   id: "group_xxx",
+     *   productIds: ["prod_aaa", "prod_bbb", "prod_ccc"],
+     * });
+     */
+    update(params: UpdateSubscriptionProductGroupParams): Promise<{
+        group: SubscriptionProductGroup;
+    }>;
+    /**
+     * Hard-delete a subscription product group.
+     *
+     * @param params - Group to delete
+     * @returns Deleted group entity
+     *
+     * @example
+     * const { group } = await client.subscriptionProductGroups.delete({ id: "group_xxx" });
+     */
+    delete(params: DeleteSubscriptionProductGroupParams): Promise<{
+        group: SubscriptionProductGroup;
+    }>;
+    /**
+     * Publish a test-environment group to production (upsert).
+     *
+     * @param params - Group to publish
+     * @returns Published group entity
+     *
+     * @example
+     * const { group } = await client.subscriptionProductGroups.publish({ id: "group_xxx" });
+     */
+    publish(params: PublishSubscriptionProductGroupParams): Promise<{
+        group: SubscriptionProductGroup;
+    }>;
+}
+
+/** Subscription product management resource. */
+declare class SubscriptionProductsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Create a subscription product with billing period and multi-currency pricing.
+     *
+     * @param params - Product creation parameters
+     * @returns Created product detail
+     *
+     * @example
+     * const { product } = await client.subscriptionProducts.create({
+     *   storeId: "store_xxx",
+     *   name: "Pro Plan",
+     *   billingPeriod: "monthly",
+     *   prices: { USD: { amount: 999, taxIncluded: false, taxCategory: "saas" } },
+     * });
+     */
+    create(params: CreateSubscriptionProductParams): Promise<{
+        product: SubscriptionProductDetail;
+    }>;
+    /**
+     * Update a subscription product. Creates a new version; skips if unchanged.
+     *
+     * @param params - Product update parameters (all content fields required)
+     * @returns Updated product detail
+     *
+     * @example
+     * const { product } = await client.subscriptionProducts.update({
+     *   id: "prod_xxx",
+     *   name: "Pro Plan v2",
+     *   billingPeriod: "monthly",
+     *   prices: { USD: { amount: 1499, taxIncluded: false, taxCategory: "saas" } },
+     * });
+     */
+    update(params: UpdateSubscriptionProductParams): Promise<{
+        product: SubscriptionProductDetail;
+    }>;
+    /**
+     * Publish a subscription product's test version to production.
+     *
+     * @param params - Product to publish
+     * @returns Published product detail
+     *
+     * @example
+     * const { product } = await client.subscriptionProducts.publish({ id: "prod_xxx" });
+     */
+    publish(params: PublishSubscriptionProductParams): Promise<{
+        product: SubscriptionProductDetail;
+    }>;
+    /**
+     * Update a subscription product's status (active/inactive).
+     *
+     * @param params - Status update parameters
+     * @returns Updated product detail
+     *
+     * @example
+     * const { product } = await client.subscriptionProducts.updateStatus({
+     *   id: "prod_xxx",
+     *   status: ProductVersionStatus.Active,
+     * });
+     */
+    updateStatus(params: UpdateSubscriptionStatusParams): Promise<{
+        product: SubscriptionProductDetail;
+    }>;
+}
+
+/**
+ * Waffo Pancake TypeScript SDK client.
+ *
+ * Uses Merchant API Key (RSA-SHA256) authentication. All requests are
+ * automatically signed — no manual header construction needed.
+ *
+ * @example
+ * import { WaffoPancake } from "@waffo/pancake-ts";
+ *
+ * const client = new WaffoPancake({
+ *   merchantId: process.env.WAFFO_MERCHANT_ID!,
+ *   privateKey: process.env.WAFFO_PRIVATE_KEY!,
+ * });
+ *
+ * // Create a store
+ * const { store } = await client.stores.create({ name: "My Store" });
+ *
+ * // Create a product
+ * const { product } = await client.onetimeProducts.create({
+ *   storeId: store.id,
+ *   name: "E-Book",
+ *   prices: { USD: { amount: 2900, taxIncluded: false, taxCategory: "digital_goods" } },
+ * });
+ *
+ * // Create a checkout session
+ * const session = await client.checkout.createSession({
+ *   storeId: store.id,
+ *   productId: product.id,
+ *   productType: "onetime",
+ *   currency: "USD",
+ * });
+ * // => redirect customer to session.checkoutUrl
+ *
+ * // Query data via GraphQL
+ * const result = await client.graphql.query({
+ *   query: `query { stores { id name status } }`,
+ * });
+ */
+declare class WaffoPancake {
+    private readonly http;
+    readonly auth: AuthResource;
+    readonly stores: StoresResource;
+    readonly storeMerchants: StoreMerchantsResource;
+    readonly onetimeProducts: OnetimeProductsResource;
+    readonly subscriptionProducts: SubscriptionProductsResource;
+    readonly subscriptionProductGroups: SubscriptionProductGroupsResource;
+    readonly orders: OrdersResource;
+    readonly checkout: CheckoutResource;
+    readonly graphql: GraphQLResource;
+    constructor(config: WaffoPancakeConfig);
+}
+
+/**
+ * Error thrown when the API returns a non-success response.
+ *
+ * @example
+ * try {
+ *   await client.stores.create({ name: "My Store" });
+ * } catch (err) {
+ *   if (err instanceof WaffoPancakeError) {
+ *     console.log(err.status);        // 400
+ *     console.log(err.errors[0]);     // { message: "...", layer: "store" }
+ *   }
+ * }
+ */
+declare class WaffoPancakeError extends Error {
+    readonly status: number;
+    readonly errors: ApiError[];
+    constructor(status: number, errors: ApiError[]);
+}
+
+/**
+ * Verify and parse an incoming Waffo Pancake webhook event.
+ *
+ * Uses built-in Waffo public keys (RSA-SHA256) for signature verification.
+ * Test and production environments use different key pairs; both are embedded in the SDK.
+ *
+ * Behavior:
+ * - Parses the `X-Waffo-Signature` header (`t=<timestamp>,v1=<base64sig>`)
+ * - Builds signature input `${t}.${rawBody}` and verifies with RSA-SHA256
+ * - When `environment` is not specified, tries prod key first, then test key
+ * - Optional: checks timestamp to prevent replay attacks (default 5-minute tolerance)
+ *
+ * @param payload - Raw request body string (must be unparsed)
+ * @param signatureHeader - Value of the `X-Waffo-Signature` header
+ * @param options - Verification options
+ * @returns Parsed webhook event
+ * @throws Error if header is missing/malformed, signature is invalid, or timestamp is stale
+ *
+ * @example
+ * // Express (use raw body!)
+ * app.post("/webhooks", express.raw({ type: "application/json" }), (req, res) => {
+ *   try {
+ *     const event = verifyWebhook(
+ *       req.body.toString("utf-8"),
+ *       req.headers["x-waffo-signature"] as string,
+ *     );
+ *     res.status(200).send("OK");
+ *     handleEventAsync(event).catch(console.error);
+ *   } catch {
+ *     res.status(401).send("Invalid signature");
+ *   }
+ * });
+ *
+ * @example
+ * // Next.js App Router
+ * export async function POST(request: Request) {
+ *   const body = await request.text();
+ *   const sig = request.headers.get("x-waffo-signature");
+ *   const event = verifyWebhook(body, sig);
+ *   // handle event ...
+ *   return new Response("OK");
+ * }
+ *
+ * @example
+ * // Specify environment explicitly
+ * const event = verifyWebhook(body, sig, { environment: "prod" });
+ *
+ * @example
+ * // Disable replay protection
+ * const event = verifyWebhook(body, sig, { toleranceMs: 0 });
+ */
+declare function verifyWebhook<T = Record<string, unknown>>(payload: string, signatureHeader: string | undefined | null, options?: VerifyWebhookOptions): WebhookEvent<T>;
+
+export { type AddMerchantParams, type AddMerchantResult, type ApiError, type ApiErrorResponse, type ApiResponse, type ApiSuccessResponse, type BillingDetail, BillingPeriod, type CancelSubscriptionParams, type CancelSubscriptionResult, CheckoutSessionProductType, type CheckoutSessionResult, type CheckoutSettings, type CheckoutThemeSettings, type CreateCheckoutSessionParams, type CreateOnetimeProductParams, 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, RefundStatus, RefundTicketStatus, type RemoveMerchantParams, type RemoveMerchantResult, 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 WebhookSettings, verifyWebhook };