fresh-squeezy 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -160,6 +160,7 @@ interface GeneratedFileAttributes {
     version?: string | null;
 }
 interface GeneratedOrderAttributes {
+    affiliate_id?: number | null;
     created_at?: string | null;
     currency?: string | null;
     currency_rate?: string | number | null;
@@ -181,6 +182,7 @@ interface GeneratedOrderAttributes {
     } | null;
     identifier?: string | null;
     order_number?: number | null;
+    referral_amount?: number | null;
     refunded?: boolean | null;
     refunded_at?: string | null;
     setup_fee?: number | null;
@@ -260,6 +262,7 @@ interface GeneratedSubscriptionAttributes {
     variant_name?: string | null;
 }
 interface GeneratedSubscriptionInvoiceAttributes {
+    affiliate_id?: number | null;
     billing_reason?: string | null;
     card_brand?: string | null;
     card_last_four?: string | null;
@@ -270,6 +273,7 @@ interface GeneratedSubscriptionInvoiceAttributes {
     discount_total?: number | null;
     discount_total_formatted?: string | null;
     discount_total_usd?: number | null;
+    referral_amount?: number | null;
     refunded?: boolean | null;
     refunded_amount?: boolean | number | null;
     refunded_amount_formatted?: string | null;
@@ -600,22 +604,6 @@ declare const ENV_KEYS: {
  */
 declare const resolveConfig: (input?: FreshSqueezyConfig) => ResolvedConfig;
 
-/**
- * Domain-equality primitives for fresh-squeezy.
- *
- * These helpers encode "when are two values the same in our domain?" — separate
- * from the validators that consume them so the rules are testable on their own
- * and reusable from any future surface (init, dedupe, repair, etc.).
- */
-/**
- * Compare two webhook URLs ignoring trailing slashes and casing.
- *
- * Lemon Squeezy strips trailing slashes when persisting a webhook, but users
- * often paste the trailing-slash form into their config. The webhook validator
- * relies on this rule to match a configured URL against the registered list.
- */
-declare const sameWebhookUrl: (a: string, b: string) => boolean;
-
 /**
  * Unified error type for fresh-squeezy. All HTTP and validation failures that
  * bubble up to consumers pass through this class so caller code can branch on
@@ -638,787 +626,130 @@ declare class FreshSqueezyError extends Error {
 }
 
 /**
- * Map the boolean `meta.test_mode` flag from `/v1/users/me` to our `Mode` type.
- *
- * Returns `undefined` when the field is absent so older accounts and proxies
- * that don't surface the flag don't produce spurious mode mismatches. Lemon
- * Squeezy added `meta.test_mode` to the endpoint on 2024-01-05 (see API
- * changelog: https://docs.lemonsqueezy.com/api/getting-started/changelog).
+ * Typed attributes for every Lemon Squeezy object fresh-squeezy touches.
  *
- * Pure function — exposed publicly so consumers can resolve a key's true mode
- * from a `/v1/users/me` document they already have, without re-running the
- * full connection validator. Keeping it free of any resource import is what
- * lets `core/` stay foundational (it never reaches up into `resources/`); the
- * I/O counterpart `fetchActualMode` lives in `validate/connection.ts`.
+ * Each `*Attributes` extends the docs-generated `Generated*Attributes` and
+ * tightens the fields validators rely on. Ops return `unknown`; narrow with
+ * these, e.g. `(await lemon.orders.get(1)) as JsonApiResource<OrderAttributes>`.
  */
-declare const resolveActualMode: (testMode: boolean | undefined) => Mode | undefined;
-
 /**
- * Options for a single HTTP request.
- *
- * `path` is a Lemon Squeezy API path starting with `/v1/...`. The `query`
- * record is serialized via `URLSearchParams` (JSON:API bracket keys such as
- * `filter[store_id]` are accepted as-is and percent-encoded in the final URL).
+ * Subset of the Lemon Squeezy `users` resource attributes we rely on.
+ * Full schema at https://docs.lemonsqueezy.com/api/users.
  */
-interface RequestOptions {
-    method?: "GET" | "POST" | "PATCH" | "DELETE";
-    path: string;
-    query?: Record<string, string | number | undefined>;
-    /** JSON:API document or other request body; stringified when present. */
-    body?: unknown;
-    signal?: AbortSignal;
+interface UserAttributes extends GeneratedUserAttributes {
+    name: string;
+    email: string;
+    color?: string;
+    avatar_url?: string | null;
+    has_custom_avatar?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
 }
 /**
- * Low-level HTTP client. Callers usually go through resource/validator helpers,
- * but this is also exposed as the public escape hatch so consumers can reach
- * endpoints fresh-squeezy does not wrap yet.
- *
- * Responsibilities kept in this one place (per plan.md "one source of truth
- * for transport"):
- *   - auth header injection
- *   - query string serialization (JSON:API bracket keys via URLSearchParams)
- *   - response parsing + error normalization
- *   - surfacing HTTP status in `FreshSqueezyError`
+ * Document-level metadata on `/v1/users/me`.
  *
- * Retries, pagination helpers, and rate-limit handling live in separate files
- * so this layer stays small and obvious.
+ * `test_mode` was added to the endpoint on 2024-01-05 (per the Lemon Squeezy
+ * API changelog: https://docs.lemonsqueezy.com/api/getting-started/changelog).
+ * It reports whether the *key* being used is a test-mode key, independent of
+ * what the caller declared. The connection validator compares this against
+ * the caller's declared mode to catch the common "prod key in staging"
+ * (or vice versa) misconfiguration.
  */
-declare class HttpClient {
-    private readonly config;
-    constructor(config: ResolvedConfig);
-    request<T>(options: RequestOptions): Promise<T>;
-    /**
-     * Fetch a single JSON:API resource and return its `data` object.
-     */
-    getResource<TAttr>(path: string): Promise<JsonApiResource<TAttr>>;
-    /**
-     * POST a JSON:API document and return the created `data` resource.
-     *
-     * @param path - API path starting with `/v1/...`.
-     * @param body - JSON:API create document.
-     * @returns The created resource.
-     */
-    postResource<TAttr>(path: string, body: unknown): Promise<JsonApiResource<TAttr>>;
-    /**
-     * PATCH a JSON:API document and return the updated `data` resource.
-     *
-     * @param path - API path starting with `/v1/...`.
-     * @param body - JSON:API update document.
-     * @returns The updated resource.
-     */
-    patchResource<TAttr>(path: string, body: unknown): Promise<JsonApiResource<TAttr>>;
-    /**
-     * DELETE a resource. Lemon Squeezy often returns an empty body on success.
-     *
-     * @param path - API path starting with `/v1/...`.
-     * @returns Nothing — single void return, not a multi-field bag.
-     */
-    deleteResource(path: string): Promise<void>;
-    /**
-     * Fetch a single page of a JSON:API collection. Most callers want
-     * `paginate()` instead — this method is kept for one-shot lookups where
-     * the caller knows the result fits in a single page.
-     */
-    getCollection<TAttr>(path: string, query?: RequestOptions["query"]): Promise<JsonApiResource<TAttr>[]>;
-    /**
-     * Walk a JSON:API collection across every page and concatenate the
-     * results. Lemon Squeezy returns 25 items per page by default; without
-     * pagination, validators silently miss anything past the first page (e.g.
-     * `validateWebhook` on a store with 26+ webhooks would falsely report
-     * `WEBHOOK_NOT_FOUND` for any webhook on page 2).
-     *
-     * Stops as soon as `meta.page.lastPage` is reached. Falls back to a
-     * single-page fetch if the API does not surface page metadata.
-     *
-     * Caller-supplied `page[number]` is honored as the starting page; we
-     * advance from there. `page[size]` is left untouched so callers can tune
-     * batch size (max 100 per Lemon Squeezy docs).
-     */
-    paginate<TAttr>(path: string, query?: RequestOptions["query"]): Promise<JsonApiResource<TAttr>[]>;
-    private requestUrl;
+interface UserMeta {
+    test_mode?: boolean;
 }
-
-type AffiliateStatus = "active" | "pending" | "disabled";
 /**
- * Affiliate attributes added with the 2025-01-21 Affiliates API surface.
- * No validator consumes these yet; the helpers give typed access while
- * preserving the raw request escape hatch for mutations and includes.
+ * Authenticated-user document with the `data` + `meta` block preserved.
+ * The connection validator needs the meta flag, so it reads the full
+ * `/v1/users/me` document rather than just `data`.
  */
-interface AffiliateAttributes extends GeneratedAffiliateAttributes {
-    store_id: number;
-    user_id: number;
-    user_name: string;
-    user_email: string;
-    share_domain: string;
-    status: AffiliateStatus;
-    application_note?: string | null;
-    products?: unknown;
-    total_earnings: number;
-    unpaid_earnings: number;
+type AuthenticatedUserDocument = JsonApiDocument<UserAttributes> & {
+    meta?: UserMeta;
+};
+/**
+ * Subset of store attributes fresh-squeezy reads.
+ * Full schema at https://docs.lemonsqueezy.com/api/stores.
+ */
+interface StoreAttributes extends GeneratedStoreAttributes {
+    name: string;
+    slug: string;
+    domain?: string | null;
+    url?: string | null;
+    country?: string;
+    currency?: string;
+    plan?: string;
     created_at?: string;
     updated_at?: string;
 }
-declare const getAffiliate: (http: HttpClient, affiliateId: string | number) => Promise<JsonApiResource<AffiliateAttributes>>;
-declare const listAffiliatesForStore: (http: HttpClient, storeId: string | number) => Promise<JsonApiResource<AffiliateAttributes>[]>;
-
-type CheckoutLocale = "bg" | "hr" | "cs" | "da" | "nl" | "en" | "et" | "fil" | "fi" | "fr" | "de" | "el" | "hu" | "id" | "it" | "ja" | "ko" | "lv" | "lt" | "ms" | "mt" | "pl" | "pt" | "ro" | "ru" | "zh-CN" | "sk" | "sl" | "es" | "sv" | "th" | "tr" | "vi";
-interface CheckoutProductOptions {
-    name?: string;
-    description?: string;
-    media?: string[];
-    redirect_url?: string;
-    receipt_button_text?: string;
-    receipt_link_url?: string;
-    receipt_thank_you_note?: string;
-    enabled_variants?: number[];
-}
-interface CheckoutOptions {
-    embed?: boolean;
-    media?: boolean;
-    logo?: boolean;
-    desc?: boolean;
-    discount?: boolean;
-    subscription_preview?: boolean;
-    /** Added 2024-03-28. */
-    skip_trial?: boolean;
-    /** Deprecated 2024-09-04; keep typed so old payloads still compile. */
-    dark?: boolean;
-    background_color?: string;
-    headings_color?: string;
-    primary_text_color?: string;
-    secondary_text_color?: string;
-    links_color?: string;
-    borders_color?: string;
-    checkbox_color?: string;
-    active_state_color?: string;
-    button_color?: string;
-    button_text_color?: string;
-    terms_privacy_color?: string;
-    locale?: CheckoutLocale | string | null;
-}
-interface CheckoutVariantQuantity {
-    variant_id: number;
-    quantity: number;
-}
-interface CheckoutData {
-    email?: string;
-    name?: string;
-    billing_address?: {
-        country?: string;
-        zip?: string;
-    };
-    tax_number?: string;
-    discount_code?: string;
-    custom?: Record<string, unknown>;
-    /** Added 2023-08-23 for multi-variant checkout quantities. */
-    variant_quantities?: CheckoutVariantQuantity[];
-}
-interface CheckoutPreview {
-    currency: string;
-    currency_rate: number | string;
-    subtotal: number;
-    discount_total: number;
-    tax: number;
-    total: number;
-    subtotal_usd: number;
-    discount_total_usd: number;
-    tax_usd: number;
-    total_usd: number;
-    subtotal_formatted: string;
-    discount_total_formatted: string;
-    tax_formatted: string;
-    total_formatted: string;
-}
-interface CheckoutAttributes extends GeneratedCheckoutAttributes {
+/**
+ * Subset of product attributes we need for validation. `status` drives the
+ * "unpublished product" check; `store_id` drives ownership checks.
+ */
+interface ProductAttributes extends GeneratedProductAttributes {
+    name: string;
+    slug: string;
+    description?: string | null;
+    status: "draft" | "published";
+    status_formatted?: string;
     store_id: number;
-    variant_id: number;
-    custom_price?: number | null;
-    product_options?: CheckoutProductOptions;
-    checkout_options?: CheckoutOptions;
-    checkout_data?: CheckoutData;
-    preview?: CheckoutPreview;
-    expires_at?: string | null;
-    url?: string;
+    buy_now_url?: string | null;
+    from_price?: number | null;
+    to_price?: number | null;
     created_at?: string;
     updated_at?: string;
-    test_mode?: boolean;
 }
-/**
- * Retrieve a checkout (GET /v1/checkouts/:id).
- *
- * @param http - Shared API client.
- * @param checkoutId - Checkout id.
- * @returns The checkout resource.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const checkout = await getCheckout(http, 1);
- * ```
- */
-declare const getCheckout: (http: HttpClient, checkoutId: string | number) => Promise<JsonApiResource<CheckoutAttributes>>;
-/**
- * List checkouts for a store.
- *
- * @param http - Shared API client.
- * @param storeId - Store filter.
- * @returns Checkout resources.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const checkouts = await listCheckoutsForStore(http, 1);
- * ```
- */
-declare const listCheckoutsForStore: (http: HttpClient, storeId: string | number) => Promise<JsonApiResource<CheckoutAttributes>[]>;
-/**
- * Create a checkout (POST /v1/checkouts).
- * Docs: https://docs.lemonsqueezy.com/api/checkouts/create-checkout
- *
- * @param http - Shared API client.
- * @param body - JSON:API create document (store + variant relationships).
- * @returns The created checkout (includes `url` for the hosted checkout).
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const checkout = await createCheckout(http, {
- *   data: {
- *     type: "checkouts",
- *     attributes: { checkout_data: { email: "buyer@example.com" } },
- *     relationships: {
- *       store: { data: { type: "stores", id: "1" } },
- *       variant: { data: { type: "variants", id: "1" } },
- *     },
- *   },
- * });
- * ```
- */
-declare const createCheckout: (http: HttpClient, body: unknown) => Promise<JsonApiResource<CheckoutAttributes>>;
-
-type CustomerStatus = "subscribed" | "unsubscribed" | "archived" | "requires_verification" | "invalid_email" | "bounced";
-interface CustomerUrls {
-    customer_portal?: string | null;
+interface VariantLink {
+    title: string;
+    url: string;
 }
 /**
- * Lemon Squeezy customer attributes. The customer portal URL was called out
- * in the 2023-09-19 changelog and is useful for apps linking users back to
- * billing without another API shape.
+ * Variant attributes used by the product validator to detect
+ * variant/price drift from the product they belong to.
  */
-interface CustomerAttributes extends GeneratedCustomerAttributes {
-    store_id: number;
-    name: string;
-    email: string;
-    status: CustomerStatus;
-    city?: string | null;
-    region?: string | null;
-    country?: string | null;
-    total_revenue_currency: number;
-    mrr: number;
-    status_formatted: string;
-    country_formatted?: string | null;
-    total_revenue_currency_formatted: string;
-    mrr_formatted: string;
-    urls?: CustomerUrls;
-    created_at?: string;
-    updated_at?: string;
-    test_mode?: boolean;
-}
-/**
- * Retrieve a customer (GET /v1/customers/:id).
- *
- * @param http - Shared API client.
- * @param customerId - Customer id.
- * @returns The customer resource.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const customer = await getCustomer(http, 1);
- * ```
- */
-declare const getCustomer: (http: HttpClient, customerId: string | number) => Promise<JsonApiResource<CustomerAttributes>>;
-/**
- * List customers for a store.
- *
- * @param http - Shared API client.
- * @param storeId - Store filter.
- * @returns Customer resources.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const customers = await listCustomersForStore(http, 1);
- * ```
- */
-declare const listCustomersForStore: (http: HttpClient, storeId: string | number) => Promise<JsonApiResource<CustomerAttributes>[]>;
-/**
- * Create a customer (POST /v1/customers).
- * Docs: https://docs.lemonsqueezy.com/api/customers/create-customer
- *
- * @param http - Shared API client.
- * @param body - JSON:API create document.
- * @returns The created customer.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const customer = await createCustomer(http, {
- *   data: {
- *     type: "customers",
- *     attributes: { name: "Ada", email: "ada@example.com" },
- *     relationships: { store: { data: { type: "stores", id: "1" } } },
- *   },
- * });
- * ```
- */
-declare const createCustomer: (http: HttpClient, body: unknown) => Promise<JsonApiResource<CustomerAttributes>>;
-/**
- * Update a customer (PATCH /v1/customers/:id).
- * Docs: https://docs.lemonsqueezy.com/api/customers/update-customer
- *
- * @param http - Shared API client.
- * @param customerId - Customer id.
- * @param body - JSON:API update document.
- * @returns The updated customer.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const customer = await updateCustomer(http, 1, {
- *   data: { type: "customers", id: "1", attributes: { name: "Ada Lovelace" } },
- * });
- * ```
- */
-declare const updateCustomer: (http: HttpClient, customerId: string | number, body: unknown) => Promise<JsonApiResource<CustomerAttributes>>;
-
-interface DiscountRedemptionAttributes extends GeneratedDiscountRedemptionAttributes {
-    discount_id: number;
-    order_id: number;
-    discount_name: string;
-    discount_code: string;
-    discount_amount: number;
-    discount_amount_type: "percent" | "fixed";
-    amount: number;
-    created_at?: string;
-    updated_at?: string;
-}
-declare const getDiscountRedemption: (http: HttpClient, discountRedemptionId: string | number) => Promise<JsonApiResource<DiscountRedemptionAttributes>>;
-declare const listDiscountRedemptionsForDiscount: (http: HttpClient, discountId: string | number) => Promise<JsonApiResource<DiscountRedemptionAttributes>[]>;
-
-/**
- * Subset of Lemon Squeezy discount attributes used by the discount validator.
- * Full schema at https://docs.lemonsqueezy.com/api/discounts.
- */
-interface DiscountAttributes extends GeneratedDiscountAttributes {
+interface VariantAttributes extends GeneratedVariantAttributes {
+    product_id: number;
     name: string;
-    code: string;
-    amount: number;
-    amount_type: "percent" | "fixed";
-    is_limited_to_products: boolean;
-    is_limited_redemptions: boolean;
-    max_redemptions: number;
-    starts_at: string | null;
-    expires_at: string | null;
-    status: "draft" | "published";
-    duration: "once" | "repeating" | "forever";
-    store_id: number;
-    created_at?: string;
-    updated_at?: string;
-}
-/**
- * Fetch a single discount by ID. The validator uses the discount's
- * `relationships.store` to confirm ownership against the caller's storeId.
- *
- * @param http - Shared API client.
- * @param discountId - Discount id.
- * @returns The discount resource.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const discount = await getDiscount(http, 1);
- * ```
- */
-declare const getDiscount: (http: HttpClient, discountId: string | number) => Promise<JsonApiResource<DiscountAttributes>>;
-/**
- * List discounts for a store (GET /v1/discounts?filter[store_id]=…).
- *
- * @param http - Shared API client.
- * @param storeId - Store filter.
- * @returns Discount resources.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const discounts = await listDiscountsForStore(http, 1);
- * ```
- */
-declare const listDiscountsForStore: (http: HttpClient, storeId: string | number) => Promise<JsonApiResource<DiscountAttributes>[]>;
-/**
- * Create a discount (POST /v1/discounts). No update endpoint exists in the API.
- * Docs: https://docs.lemonsqueezy.com/api/discounts/create-discount
- *
- * @param http - Shared API client.
- * @param body - JSON:API create document.
- * @returns The created discount.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const discount = await createDiscount(http, {
- *   data: {
- *     type: "discounts",
- *     attributes: { name: "Launch", code: "LAUNCH10", amount: 10, amount_type: "percent" },
- *     relationships: { store: { data: { type: "stores", id: "1" } } },
- *   },
- * });
- * ```
- */
-declare const createDiscount: (http: HttpClient, body: unknown) => Promise<JsonApiResource<DiscountAttributes>>;
-/**
- * Delete a discount (DELETE /v1/discounts/:id).
- * Docs: https://docs.lemonsqueezy.com/api/discounts/delete-discount
- *
- * @param http - Shared API client.
- * @param discountId - Discount id.
- * @returns Nothing on success.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * await deleteDiscount(http, 1);
- * ```
- */
-declare const deleteDiscount: (http: HttpClient, discountId: string | number) => Promise<void>;
-
-/**
- * Lemon Squeezy file attributes, generated from the public object docs.
- * Exposed so consumers can type file-resource escape-hatch calls without
- * waiting for a hand-written validator.
- */
-interface FileAttributes extends GeneratedFileAttributes {
-}
-declare const getFile: (http: HttpClient, fileId: string | number) => Promise<JsonApiResource<FileAttributes>>;
-declare const listFilesForVariant: (http: HttpClient, variantId: string | number) => Promise<JsonApiResource<FileAttributes>[]>;
-
-/**
- * Docs-backed ops matrix for Lemon Squeezy.
- *
- * Only verbs that exist at https://docs.lemonsqueezy.com/api are listed.
- * Catalog resources (products, variants, prices, files, stores, …) are
- * read-only. CI changelog scrape may propose gaps; this registry is what ships.
- */
-/** CLI / client verb tokens, including non-CRUD LS actions. */
-type OpVerb = "get" | "list" | "create" | "update" | "delete" | "cancel" | "refund" | "generate-invoice" | "current-usage";
-/**
- * One implemented, documented operation.
- *
- * @remarks `docsPath` is the path under `/api/` on the LS docs site.
- */
-interface ResourceVerbSpec {
-    /** CLI resource token (singular), e.g. `webhook`. */
-    resource: string;
-    verb: OpVerb;
-    /** Docs path fragment, e.g. `webhooks/create-webhook`. */
-    docsPath: string;
-    /** Requires --yes or TTY confirm always (delete/cancel/refund). */
-    destructive?: boolean;
-    body?: "required" | "optional" | "none";
+    slug: string;
+    description?: string | null;
+    has_license_keys?: boolean;
+    license_activation_limit?: number | null;
+    is_license_limit_unlimited?: boolean;
+    license_length_value?: number | null;
+    license_length_unit?: "day" | "week" | "month" | "year" | null;
+    is_license_length_unlimited?: boolean;
+    status: "pending" | "draft" | "published";
+    status_formatted?: string;
+    is_subscription?: boolean;
+    interval?: string | null;
+    interval_count?: number | null;
+    sort?: number;
     /**
-     * How list/get resolve the primary id filter.
-     * - `id` — --id
-     * - `store` — --store-ids (first) or store filter
-     * - `parent` — --parent-id (subscription, order, product, …)
+     * Hosted-checkout-style links keyed by purpose. Added 2024-06-09 — older
+     * SDK and validator versions don't surface this field, so consumers had
+     * to read `meta.product_links` manually before. Optional because the
+     * field is absent on older variants.
      */
-    idRole?: "id" | "store" | "parent" | "none";
-}
-/**
- * Implemented ops. Keep in sync with exports in `src/resources/*` and the
- * CLI dispatcher. Do not register fantasy endpoints (e.g. product create).
- */
-declare const resourceRegistry: readonly ResourceVerbSpec[];
-/**
- * Normalize a CLI resource token to the singular registry key.
- *
- * @param resource - Raw token (`products`, `order_items`, `webhook`).
- * @returns Canonical singular resource name used in `resourceRegistry`.
- */
-declare const normalizeResourceName: (resource: string) => string;
-/**
- * Look up a registry entry.
- *
- * @param resource - CLI resource token.
- * @param verb - Op verb.
- * @returns The spec, or undefined when not implemented / not in LS API.
- */
-declare const findResourceVerb: (resource: string, verb: string) => ResourceVerbSpec | undefined;
-/**
- * Unique resource names that have at least one verb.
- *
- * @returns Sorted resource tokens for help text / menus.
- */
-declare const listRegisteredResources: () => string[];
-/**
- * All verbs registered for a resource (empty when unknown).
- *
- * @param resource - CLI resource token (plural or singular).
- * @returns Sorted verb list for help / menus.
- */
-declare const listRegisteredVerbs: (resource: string) => OpVerb[];
-
-/**
- * Arguments for a single resource op invocation.
- *
- * One named input type — not a bag of unrelated returns.
- */
-interface InvokeOpArgs {
-    id?: string | number;
-    storeId?: string | number;
-    parentId?: string | number;
-    body?: unknown;
-}
-/**
- * Dispatch a docs-backed resource verb through the thin resource helpers.
- *
- * @param http - Shared API client.
- * @param resource - CLI resource token (`webhook`, `product`, …).
- * @param verb - Op verb (`get`, `create`, `refund`, …).
- * @param args - Ids / body for the call.
- * @returns A single JSON:API resource, list, void, or action payload.
- * @throws {FreshSqueezyError} When the verb is unknown or HTTP fails.
- *
- * @example
- * ```ts
- * const product = await invokeOp(http, "product", "get", { id: 42 });
- * ```
- */
-declare const invokeOp: (http: HttpClient, resource: string, verb: OpVerb | string, args?: InvokeOpArgs) => Promise<unknown>;
-
-interface LicenseKeyInstanceAttributes extends GeneratedLicenseKeyInstanceAttributes {
-    license_key_id: number;
-    identifier: string;
-    name: string;
-    created_at?: string;
-    updated_at?: string;
-}
-declare const getLicenseKeyInstance: (http: HttpClient, licenseKeyInstanceId: string | number) => Promise<JsonApiResource<LicenseKeyInstanceAttributes>>;
-declare const listLicenseKeyInstancesForLicenseKey: (http: HttpClient, licenseKeyId: string | number) => Promise<JsonApiResource<LicenseKeyInstanceAttributes>[]>;
-
-/**
- * Subset of Lemon Squeezy license-key attributes used by the license key
- * validator. Full schema at https://docs.lemonsqueezy.com/api/license-keys.
- */
-interface LicenseKeyAttributes extends GeneratedLicenseKeyAttributes {
-    key_short: string;
-    status: "active" | "inactive" | "expired" | "disabled";
-    expires_at: string | null;
-    activation_limit: number | null;
-    instances_count: number;
-    disabled: boolean;
-    store_id: number;
-    created_at?: string;
-    updated_at?: string;
-}
-/**
- * Fetch a single license key by ID. Used by the license key validator to
- * check activation limits, expiration, and store ownership.
- *
- * @param http - Shared API client.
- * @param licenseKeyId - License key id.
- * @returns The license key resource.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const key = await getLicenseKey(http, 1);
- * ```
- */
-declare const getLicenseKey: (http: HttpClient, licenseKeyId: string | number) => Promise<JsonApiResource<LicenseKeyAttributes>>;
-/**
- * List license keys for a store.
- *
- * @param http - Shared API client.
- * @param storeId - Store filter.
- * @returns License key resources.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const keys = await listLicenseKeysForStore(http, 1);
- * ```
- */
-declare const listLicenseKeysForStore: (http: HttpClient, storeId: string | number) => Promise<JsonApiResource<LicenseKeyAttributes>[]>;
-/**
- * Update a license key (PATCH /v1/license-keys/:id) — e.g. `expires_at`, disabled.
- * Docs: https://docs.lemonsqueezy.com/api/license-keys/update-license-key
- *
- * @param http - Shared API client.
- * @param licenseKeyId - License key id.
- * @param body - JSON:API update document.
- * @returns The updated license key.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const key = await updateLicenseKey(http, 1, {
- *   data: { type: "license-keys", id: "1", attributes: { disabled: true } },
- * });
- * ```
- */
-declare const updateLicenseKey: (http: HttpClient, licenseKeyId: string | number, body: unknown) => Promise<JsonApiResource<LicenseKeyAttributes>>;
-
-/**
- * Order item attributes. `quantity` was added to the documented object in
- * the 2024-12-06 changelog and is needed for multi-quantity reconciliation.
- */
-interface OrderItemAttributes extends GeneratedOrderItemAttributes {
-    order_id: number;
-    product_id: number;
-    variant_id: number;
-    product_name: string;
-    variant_name: string;
-    price: number;
-    quantity: number;
-    created_at?: string;
-    updated_at?: string;
-}
-declare const getOrderItem: (http: HttpClient, orderItemId: string | number) => Promise<JsonApiResource<OrderItemAttributes>>;
-declare const listOrderItemsForOrder: (http: HttpClient, orderId: string | number) => Promise<JsonApiResource<OrderItemAttributes>[]>;
-
-interface OrderUrls {
-    receipt?: string;
-}
-interface OrderFirstItem {
-    id: number;
-    order_id?: number;
-    product_id: number;
-    variant_id: number;
-    product_name: string;
-    variant_name: string;
-    price: number;
-    quantity?: number;
-    created_at?: string;
-    updated_at?: string;
-}
-/**
- * Subset of Lemon Squeezy order attributes fresh-squeezy understands.
- *
- * fresh-squeezy does not (yet) validate orders — the type is exported so
- * consumers using the raw `client.request<OrderAttributes>()` escape hatch
- * get a typed response that includes platform additions the official SDK
- * has not yet picked up.
- *
- * Field provenance against the changelog
- * (https://docs.lemonsqueezy.com/api/getting-started/changelog):
- *
- *   - `status: "fraudulent"` — added 2024-09-10. Indicates a manual fraud
- *     flag; treat as terminal and refund or chargeback as appropriate.
- *   - `refunded_amount`, `refunded_amount_usd`, `refunded_amount_formatted`
- *     — added 2024-08-07. Useful for consumers reconciling partial refunds.
- *   - `tax_inclusive` — added 2024-02-05.
- */
-interface OrderAttributes extends GeneratedOrderAttributes {
-    store_id: number;
-    customer_id?: number;
-    identifier: string;
-    order_number: number;
-    user_name: string;
-    user_email: string;
-    currency: string;
-    currency_rate: string;
-    subtotal: number;
-    setup_fee?: number;
-    discount_total: number;
-    tax: number;
-    tax_inclusive?: boolean;
-    total: number;
-    refunded_amount?: number;
-    subtotal_usd?: number;
-    setup_fee_usd?: number;
-    discount_total_usd?: number;
-    tax_usd?: number;
-    total_usd?: number;
-    refunded_amount_usd?: number | null;
-    tax_name?: string | null;
-    tax_rate?: number | string | null;
-    refunded_amount_formatted?: string | null;
-    refunded?: boolean;
-    refunded_at?: string | null;
-    status: "pending" | "failed" | "paid" | "refunded" | "fraudulent" | "partial_refund";
-    status_formatted: string;
-    subtotal_formatted?: string;
-    setup_fee_formatted?: string;
-    discount_total_formatted?: string;
-    tax_formatted?: string;
-    total_formatted?: string;
-    first_order_item?: OrderFirstItem | null;
-    urls?: OrderUrls;
+    links?: VariantLink[] | Record<string, string>;
     created_at?: string;
     updated_at?: string;
     test_mode?: boolean;
 }
 /**
- * Fetch a single order by ID.
- *
- * @param http - Shared API client.
- * @param orderId - Order id.
- * @returns The order resource.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const order = await getOrder(http, 1);
- * ```
- */
-declare const getOrder: (http: HttpClient, orderId: string | number) => Promise<JsonApiResource<OrderAttributes>>;
-/**
- * List orders for a store.
- *
- * @param http - Shared API client.
- * @param storeId - Store filter.
- * @returns Order resources.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const orders = await listOrdersForStore(http, 1);
- * ```
- */
-declare const listOrdersForStore: (http: HttpClient, storeId: string | number) => Promise<JsonApiResource<OrderAttributes>[]>;
-/**
- * Issue a full or partial order refund (POST /v1/orders/:id/refund).
- * Docs: https://docs.lemonsqueezy.com/api/orders/issue-refund
- *
- * @param http - Shared API client.
- * @param orderId - Order to refund.
- * @param body - Optional JSON:API body (`attributes.amount` for partial).
- * @returns The updated order after refund.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const order = await refundOrder(http, 1);
- * ```
- */
-declare const refundOrder: (http: HttpClient, orderId: string | number, body?: unknown) => Promise<JsonApiResource<OrderAttributes>>;
-/**
- * Generate an order invoice (POST /v1/orders/:id/generate-invoice).
- * Docs: https://docs.lemonsqueezy.com/api/orders/generate-order-invoice
- *
- * @param http - Shared API client.
- * @param orderId - Order id.
- * @param body - Optional locale/name attributes document.
- * @returns API response document (invoice URL payload).
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const invoice = await generateOrderInvoice(http, 1);
- * ```
+ * Extended variant attributes for subscription plan validation. In Lemon
+ * Squeezy, "subscription plans" live as variants with `is_subscription: true`.
+ * These fields are only present on subscription variants and are checked by
+ * the subscription plan validator to catch misconfigured trial periods,
+ * zero-price plans, and invalid billing intervals.
  */
-declare const generateOrderInvoice: (http: HttpClient, orderId: string | number, body?: unknown) => Promise<unknown>;
-
+interface SubscriptionVariantAttributes extends VariantAttributes {
+    is_subscription: boolean;
+    interval: string | null;
+    interval_count: number | null;
+    has_free_trial: boolean;
+    trial_interval: string | null;
+    trial_interval_count: number | null;
+    price: number;
+}
 /**
  * Subset of Lemon Squeezy price attributes. Prices are nested under
  * variants in the API surface; consumers that read them directly via
@@ -1454,284 +785,127 @@ interface PriceAttributes extends GeneratedPriceAttributes {
     updated_at?: string;
 }
 /**
- * Fetch a single price by ID (read-only — no create/update/delete in LS API).
- *
- * @param http - Shared API client.
- * @param priceId - Price id.
- * @returns The price resource.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const price = await getPrice(http, 1);
- * ```
- */
-declare const getPrice: (http: HttpClient, priceId: string | number) => Promise<JsonApiResource<PriceAttributes>>;
-/**
- * List prices for a variant.
- *
- * @param http - Shared API client.
- * @param variantId - Variant filter.
- * @returns Price resources.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const prices = await listPricesForVariant(http, 1);
- * ```
+ * Lemon Squeezy file attributes, generated from the public object docs.
+ * Exposed so consumers can type file-resource escape-hatch calls without
+ * waiting for a hand-written validator.
  */
-declare const listPricesForVariant: (http: HttpClient, variantId: string | number) => Promise<JsonApiResource<PriceAttributes>[]>;
-
+interface FileAttributes extends GeneratedFileAttributes {
+}
+type CustomerStatus = "subscribed" | "unsubscribed" | "archived" | "requires_verification" | "invalid_email" | "bounced";
+interface CustomerUrls {
+    customer_portal?: string | null;
+}
 /**
- * Subset of product attributes we need for validation. `status` drives the
- * "unpublished product" check; `store_id` drives ownership checks.
+ * Lemon Squeezy customer attributes. The customer portal URL was called out
+ * in the 2023-09-19 changelog and is useful for apps linking users back to
+ * billing without another API shape.
  */
-interface ProductAttributes extends GeneratedProductAttributes {
-    name: string;
-    slug: string;
-    description?: string | null;
-    status: "draft" | "published";
-    status_formatted?: string;
+interface CustomerAttributes extends GeneratedCustomerAttributes {
     store_id: number;
-    buy_now_url?: string | null;
-    from_price?: number | null;
-    to_price?: number | null;
+    name: string;
+    email: string;
+    status: CustomerStatus;
+    city?: string | null;
+    region?: string | null;
+    country?: string | null;
+    total_revenue_currency: number;
+    mrr: number;
+    status_formatted: string;
+    country_formatted?: string | null;
+    total_revenue_currency_formatted: string;
+    mrr_formatted: string;
+    urls?: CustomerUrls;
     created_at?: string;
     updated_at?: string;
+    test_mode?: boolean;
 }
-declare const getProduct: (http: HttpClient, productId: string | number) => Promise<JsonApiResource<ProductAttributes>>;
-/**
- * List every product in the store, paginated. Used by the CLI's
- * interactive product picker; without pagination only the first 25
- * products are offered.
- */
-declare const listProducts: (http: HttpClient, storeId: string | number) => Promise<JsonApiResource<ProductAttributes>[]>;
-
-/**
- * Subset of store attributes fresh-squeezy reads.
- * Full schema at https://docs.lemonsqueezy.com/api/stores.
- */
-interface StoreAttributes extends GeneratedStoreAttributes {
-    name: string;
-    slug: string;
-    domain?: string | null;
-    url?: string | null;
-    country?: string;
-    currency?: string;
-    plan?: string;
+interface OrderUrls {
+    receipt?: string;
+}
+interface OrderFirstItem {
+    id: number;
+    order_id?: number;
+    product_id: number;
+    variant_id: number;
+    product_name: string;
+    variant_name: string;
+    price: number;
+    quantity?: number;
     created_at?: string;
     updated_at?: string;
 }
-declare const getStore: (http: HttpClient, storeId: string | number) => Promise<JsonApiResource<StoreAttributes>>;
-/**
- * List every store reachable with the configured API key, paginated.
- * Used by `validateConnection` to populate the connection summary, and by
- * the CLI's `--all-stores` flag. Pagination matters here for accounts that
- * own a large catalogue of stores.
- */
-declare const listStores: (http: HttpClient) => Promise<JsonApiResource<StoreAttributes>[]>;
-
-type SubscriptionInvoiceStatus = "pending" | "paid" | "void" | "refunded" | "partial_refund";
-type SubscriptionInvoiceBillingReason = "initial" | "renewal" | "updated";
-interface SubscriptionInvoiceUrls {
-    invoice_url?: string;
-}
 /**
- * Subscription invoice attributes, including fields added across the
- * changelog: customer identity, tax inclusion, and partial refund amounts.
+ * Subset of Lemon Squeezy order attributes fresh-squeezy understands.
+ *
+ * fresh-squeezy does not (yet) validate orders — the type is exported so
+ * consumers using the raw `client.request<OrderAttributes>()` escape hatch
+ * get a typed response that includes platform additions the official SDK
+ * has not yet picked up.
+ *
+ * Field provenance against the changelog
+ * (https://docs.lemonsqueezy.com/api/getting-started/changelog):
+ *
+ *   - `status: "fraudulent"` — added 2024-09-10. Indicates a manual fraud
+ *     flag; treat as terminal and refund or chargeback as appropriate.
+ *   - `refunded_amount`, `refunded_amount_usd`, `refunded_amount_formatted`
+ *     — added 2024-08-07. Useful for consumers reconciling partial refunds.
+ *   - `tax_inclusive` — added 2024-02-05.
  */
-interface SubscriptionInvoiceAttributes extends GeneratedSubscriptionInvoiceAttributes {
+interface OrderAttributes extends GeneratedOrderAttributes {
     store_id: number;
-    subscription_id: number;
-    customer_id: number;
+    customer_id?: number;
+    identifier: string;
+    order_number: number;
     user_name: string;
     user_email: string;
-    billing_reason: SubscriptionInvoiceBillingReason | string;
-    card_brand?: string | null;
-    card_last_four?: string | null;
     currency: string;
     currency_rate: string;
-    status: SubscriptionInvoiceStatus;
-    status_formatted: string;
-    refunded: boolean;
-    refunded_at: string | null;
     subtotal: number;
+    setup_fee?: number;
     discount_total: number;
     tax: number;
-    tax_inclusive: boolean;
+    tax_inclusive?: boolean;
     total: number;
-    refunded_amount: number;
-    subtotal_usd: number;
-    discount_total_usd: number;
-    tax_usd: number;
-    total_usd: number;
-    refunded_amount_usd: number;
-    subtotal_formatted: string;
-    discount_total_formatted: string;
-    tax_formatted: string;
-    total_formatted: string;
-    refunded_amount_formatted: string;
-    urls?: SubscriptionInvoiceUrls;
-    created_at?: string;
-    updated_at?: string;
-    test_mode?: boolean;
-}
-/**
- * Retrieve a subscription invoice.
- *
- * @param http - Shared API client.
- * @param subscriptionInvoiceId - Invoice id.
- * @returns The invoice resource.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const invoice = await getSubscriptionInvoice(http, 1);
- * ```
- */
-declare const getSubscriptionInvoice: (http: HttpClient, subscriptionInvoiceId: string | number) => Promise<JsonApiResource<SubscriptionInvoiceAttributes>>;
-/**
- * List invoices for a subscription.
- *
- * @param http - Shared API client.
- * @param subscriptionId - Parent subscription id.
- * @returns Invoice resources.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const invoices = await listSubscriptionInvoicesForSubscription(http, 1);
- * ```
- */
-declare const listSubscriptionInvoicesForSubscription: (http: HttpClient, subscriptionId: string | number) => Promise<JsonApiResource<SubscriptionInvoiceAttributes>[]>;
-/**
- * Refund a subscription invoice (POST /v1/subscription-invoices/:id/refund).
- * Docs: https://docs.lemonsqueezy.com/api/subscription-invoices/issue-refund
- *
- * @param http - Shared API client.
- * @param subscriptionInvoiceId - Invoice id.
- * @param body - Optional partial-refund document.
- * @returns The updated invoice.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const invoice = await refundSubscriptionInvoice(http, 1);
- * ```
- */
-declare const refundSubscriptionInvoice: (http: HttpClient, subscriptionInvoiceId: string | number, body?: unknown) => Promise<JsonApiResource<SubscriptionInvoiceAttributes>>;
-/**
- * Generate a subscription invoice PDF/URL.
- * Docs: https://docs.lemonsqueezy.com/api/subscription-invoices/generate-subscription-invoice
- *
- * @param http - Shared API client.
- * @param subscriptionInvoiceId - Invoice id.
- * @param body - Optional generation attributes.
- * @returns API response document.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const doc = await generateSubscriptionInvoice(http, 1);
- * ```
- */
-declare const generateSubscriptionInvoice: (http: HttpClient, subscriptionInvoiceId: string | number, body?: unknown) => Promise<unknown>;
-
-interface SubscriptionItemAttributes extends GeneratedSubscriptionItemAttributes {
-    subscription_id: number;
-    price_id: number;
-    quantity: number;
-    is_usage_based: boolean;
+    refunded_amount?: number;
+    subtotal_usd?: number;
+    setup_fee_usd?: number;
+    discount_total_usd?: number;
+    tax_usd?: number;
+    total_usd?: number;
+    refunded_amount_usd?: number | null;
+    tax_name?: string | null;
+    tax_rate?: number | string | null;
+    refunded_amount_formatted?: string | null;
+    refunded?: boolean;
+    refunded_at?: string | null;
+    status: "pending" | "failed" | "paid" | "refunded" | "fraudulent" | "partial_refund";
+    status_formatted: string;
+    subtotal_formatted?: string;
+    setup_fee_formatted?: string;
+    discount_total_formatted?: string;
+    tax_formatted?: string;
+    total_formatted?: string;
+    first_order_item?: OrderFirstItem | null;
+    urls?: OrderUrls;
     created_at?: string;
-    updated_at?: string;
-}
-/**
- * Attributes accepted by the update subscription item endpoint. The proration
- * controls were added in the 2024-02-12 changelog.
- */
-interface SubscriptionItemUpdateAttributes {
-    quantity?: number;
-    invoice_immediately?: boolean;
-    disable_prorations?: boolean;
-}
-/**
- * Retrieve a subscription item.
- *
- * @param http - Shared API client.
- * @param subscriptionItemId - Item id.
- * @returns The subscription item resource.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const item = await getSubscriptionItem(http, 1);
- * ```
- */
-declare const getSubscriptionItem: (http: HttpClient, subscriptionItemId: string | number) => Promise<JsonApiResource<SubscriptionItemAttributes>>;
-/**
- * List subscription items for a subscription.
- *
- * @param http - Shared API client.
- * @param subscriptionId - Parent subscription id.
- * @returns Subscription item resources.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const items = await listSubscriptionItemsForSubscription(http, 1);
- * ```
- */
-declare const listSubscriptionItemsForSubscription: (http: HttpClient, subscriptionId: string | number) => Promise<JsonApiResource<SubscriptionItemAttributes>[]>;
-/**
- * Build a JSON:API update body for a subscription item (quantity / proration).
- *
- * @param subscriptionItemId - Item id embedded in the document.
- * @param attributes - Fields accepted by the update endpoint.
- * @returns A single JSON:API document (not multiple loose objects).
- *
- * @example
- * ```ts
- * const body = buildSubscriptionItemUpdateBody(1, { quantity: 3 });
- * await updateSubscriptionItem(http, 1, body);
- * ```
- */
-declare const buildSubscriptionItemUpdateBody: (subscriptionItemId: string | number, attributes: SubscriptionItemUpdateAttributes) => unknown;
-/**
- * Update a subscription item (PATCH /v1/subscription-items/:id).
- * Docs: https://docs.lemonsqueezy.com/api/subscription-items/update-subscription-item
- *
- * @param http - Shared API client.
- * @param subscriptionItemId - Item id.
- * @param body - JSON:API update document.
- * @returns The updated subscription item.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const item = await updateSubscriptionItem(
- *   http,
- *   1,
- *   buildSubscriptionItemUpdateBody(1, { quantity: 2 }),
- * );
- * ```
- */
-declare const updateSubscriptionItem: (http: HttpClient, subscriptionItemId: string | number, body: unknown) => Promise<JsonApiResource<SubscriptionItemAttributes>>;
+    updated_at?: string;
+    test_mode?: boolean;
+}
 /**
- * Current-period usage for a usage-based subscription item.
- * Docs: https://docs.lemonsqueezy.com/api/subscription-items/retrieve-subscription-item-current-usage
- *
- * @param http - Shared API client.
- * @param subscriptionItemId - Item id.
- * @returns Usage payload for the current billing period.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const usage = await getSubscriptionItemCurrentUsage(http, 1);
- * ```
+ * Order item attributes. `quantity` was added to the documented object in
+ * the 2024-12-06 changelog and is needed for multi-quantity reconciliation.
  */
-declare const getSubscriptionItemCurrentUsage: (http: HttpClient, subscriptionItemId: string | number) => Promise<unknown>;
-
+interface OrderItemAttributes extends GeneratedOrderItemAttributes {
+    order_id: number;
+    product_id: number;
+    variant_id: number;
+    product_name: string;
+    variant_name: string;
+    price: number;
+    quantity: number;
+    created_at?: string;
+    updated_at?: string;
+}
 /**
  * URLs Lemon Squeezy attaches to a subscription so consumers can deep-link
  * users to billing pages. The set has grown over time; we keep optional
@@ -1802,68 +976,82 @@ interface SubscriptionAttributes extends GeneratedSubscriptionAttributes {
     /** Compatibility field for older fresh-squeezy consumers; prefer SubscriptionInvoiceAttributes.tax_inclusive. */
     tax_inclusive?: boolean;
 }
+interface SubscriptionItemAttributes extends GeneratedSubscriptionItemAttributes {
+    subscription_id: number;
+    price_id: number;
+    quantity: number;
+    is_usage_based: boolean;
+    created_at?: string;
+    updated_at?: string;
+}
 /**
- * Fetch a single subscription by ID.
- *
- * @param http - Shared API client.
- * @param subscriptionId - Subscription id.
- * @returns The subscription resource.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const sub = await getSubscription(http, 1);
- * ```
- */
-declare const getSubscription: (http: HttpClient, subscriptionId: string | number) => Promise<JsonApiResource<SubscriptionAttributes>>;
-/**
- * List subscriptions for a store.
- *
- * @param http - Shared API client.
- * @param storeId - Store filter.
- * @returns Subscription resources.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const subs = await listSubscriptionsForStore(http, 1);
- * ```
+ * Attributes accepted by the update subscription item endpoint. The proration
+ * controls were added in the 2024-02-12 changelog.
  */
-declare const listSubscriptionsForStore: (http: HttpClient, storeId: string | number) => Promise<JsonApiResource<SubscriptionAttributes>[]>;
+interface SubscriptionItemUpdateAttributes {
+    quantity?: number;
+    invoice_immediately?: boolean;
+    disable_prorations?: boolean;
+}
 /**
- * Update a subscription (PATCH /v1/subscriptions/:id) — plan change, pause, etc.
- * Docs: https://docs.lemonsqueezy.com/api/subscriptions/update-subscription
+ * Build a JSON:API update body for a subscription item (quantity / proration).
  *
- * @param http - Shared API client.
- * @param subscriptionId - Subscription id.
- * @param body - JSON:API update document.
- * @returns The updated subscription.
- * @throws {FreshSqueezyError} On HTTP/network failure.
+ * @param subscriptionItemId - Item id embedded in the document.
+ * @param attributes - Fields accepted by the update endpoint.
+ * @returns A single JSON:API document (not multiple loose objects).
  *
  * @example
  * ```ts
- * const sub = await updateSubscription(http, 1, {
- *   data: { type: "subscriptions", id: "1", attributes: { variant_id: 2 } },
- * });
+ * const body = buildSubscriptionItemUpdateBody(1, { quantity: 3 });
+ * await lemon.subscriptionItems.update(1, body);
  * ```
  */
-declare const updateSubscription: (http: HttpClient, subscriptionId: string | number, body: unknown) => Promise<JsonApiResource<SubscriptionAttributes>>;
+declare const buildSubscriptionItemUpdateBody: (subscriptionItemId: string | number, attributes: SubscriptionItemUpdateAttributes) => unknown;
+type SubscriptionInvoiceStatus = "pending" | "paid" | "void" | "refunded" | "partial_refund";
+type SubscriptionInvoiceBillingReason = "initial" | "renewal" | "updated";
+interface SubscriptionInvoiceUrls {
+    invoice_url?: string;
+}
 /**
- * Cancel a subscription (DELETE /v1/subscriptions/:id).
- * Docs: https://docs.lemonsqueezy.com/api/subscriptions/cancel-subscription
- *
- * @param http - Shared API client.
- * @param subscriptionId - Subscription id.
- * @returns The cancelled subscription resource when the API returns one.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const sub = await cancelSubscription(http, 1);
- * ```
+ * Subscription invoice attributes, including fields added across the
+ * changelog: customer identity, tax inclusion, and partial refund amounts.
  */
-declare const cancelSubscription: (http: HttpClient, subscriptionId: string | number) => Promise<JsonApiResource<SubscriptionAttributes> | undefined>;
-
+interface SubscriptionInvoiceAttributes extends GeneratedSubscriptionInvoiceAttributes {
+    store_id: number;
+    subscription_id: number;
+    customer_id: number;
+    user_name: string;
+    user_email: string;
+    billing_reason: SubscriptionInvoiceBillingReason | string;
+    card_brand?: string | null;
+    card_last_four?: string | null;
+    currency: string;
+    currency_rate: string;
+    status: SubscriptionInvoiceStatus;
+    status_formatted: string;
+    refunded: boolean;
+    refunded_at: string | null;
+    subtotal: number;
+    discount_total: number;
+    tax: number;
+    tax_inclusive: boolean;
+    total: number;
+    refunded_amount: number;
+    subtotal_usd: number;
+    discount_total_usd: number;
+    tax_usd: number;
+    total_usd: number;
+    refunded_amount_usd: number;
+    subtotal_formatted: string;
+    discount_total_formatted: string;
+    tax_formatted: string;
+    total_formatted: string;
+    refunded_amount_formatted: string;
+    urls?: SubscriptionInvoiceUrls;
+    created_at?: string;
+    updated_at?: string;
+    test_mode?: boolean;
+}
 type UsageRecordAction = "increment" | "set";
 interface UsageRecordAttributes extends GeneratedUsageRecordAttributes {
     subscription_item_id: number;
@@ -1873,271 +1061,321 @@ interface UsageRecordAttributes extends GeneratedUsageRecordAttributes {
     updated_at?: string;
 }
 /**
- * Retrieve a usage record.
- *
- * @param http - Shared API client.
- * @param usageRecordId - Usage record id.
- * @returns The usage record resource.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const record = await getUsageRecord(http, 1);
- * ```
- */
-declare const getUsageRecord: (http: HttpClient, usageRecordId: string | number) => Promise<JsonApiResource<UsageRecordAttributes>>;
-/**
- * List usage records for a subscription item.
- *
- * @param http - Shared API client.
- * @param subscriptionItemId - Parent subscription item id.
- * @returns Usage record resources.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const records = await listUsageRecordsForSubscriptionItem(http, 1);
- * ```
- */
-declare const listUsageRecordsForSubscriptionItem: (http: HttpClient, subscriptionItemId: string | number) => Promise<JsonApiResource<UsageRecordAttributes>[]>;
-/**
- * Create a usage record (POST /v1/usage-records).
- * Docs: https://docs.lemonsqueezy.com/api/usage-records/create-usage-record
- *
- * @param http - Shared API client.
- * @param body - JSON:API create document.
- * @returns The created usage record.
- * @throws {FreshSqueezyError} On HTTP/network failure.
- *
- * @example
- * ```ts
- * const record = await createUsageRecord(http, {
- *   data: {
- *     type: "usage-records",
- *     attributes: { quantity: 5, action: "increment" },
- *     relationships: {
- *       "subscription-item": { data: { type: "subscription-items", id: "1" } },
- *     },
- *   },
- * });
- * ```
+ * Subset of Lemon Squeezy discount attributes used by the discount validator.
+ * Full schema at https://docs.lemonsqueezy.com/api/discounts.
  */
-declare const createUsageRecord: (http: HttpClient, body: unknown) => Promise<JsonApiResource<UsageRecordAttributes>>;
-
+interface DiscountAttributes extends GeneratedDiscountAttributes {
+    name: string;
+    code: string;
+    amount: number;
+    amount_type: "percent" | "fixed";
+    is_limited_to_products: boolean;
+    is_limited_redemptions: boolean;
+    max_redemptions: number;
+    starts_at: string | null;
+    expires_at: string | null;
+    status: "draft" | "published";
+    duration: "once" | "repeating" | "forever";
+    store_id: number;
+    created_at?: string;
+    updated_at?: string;
+}
+interface DiscountRedemptionAttributes extends GeneratedDiscountRedemptionAttributes {
+    discount_id: number;
+    order_id: number;
+    discount_name: string;
+    discount_code: string;
+    discount_amount: number;
+    discount_amount_type: "percent" | "fixed";
+    amount: number;
+    created_at?: string;
+    updated_at?: string;
+}
 /**
- * Subset of the Lemon Squeezy `users` resource attributes we rely on.
- * Full schema at https://docs.lemonsqueezy.com/api/users.
+ * Subset of Lemon Squeezy license-key attributes used by the license key
+ * validator. Full schema at https://docs.lemonsqueezy.com/api/license-keys.
  */
-interface UserAttributes extends GeneratedUserAttributes {
+interface LicenseKeyAttributes extends GeneratedLicenseKeyAttributes {
+    key_short: string;
+    status: "active" | "inactive" | "expired" | "disabled";
+    expires_at: string | null;
+    activation_limit: number | null;
+    instances_count: number;
+    disabled: boolean;
+    store_id: number;
+    created_at?: string;
+    updated_at?: string;
+}
+interface LicenseKeyInstanceAttributes extends GeneratedLicenseKeyInstanceAttributes {
+    license_key_id: number;
+    identifier: string;
     name: string;
-    email: string;
-    color?: string;
-    avatar_url?: string | null;
-    has_custom_avatar?: boolean;
-    createdAt?: string;
-    updatedAt?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+type CheckoutLocale = "bg" | "hr" | "cs" | "da" | "nl" | "en" | "et" | "fil" | "fi" | "fr" | "de" | "el" | "hu" | "id" | "it" | "ja" | "ko" | "lv" | "lt" | "ms" | "mt" | "pl" | "pt" | "ro" | "ru" | "zh-CN" | "sk" | "sl" | "es" | "sv" | "th" | "tr" | "vi";
+interface CheckoutProductOptions {
+    name?: string;
+    description?: string;
+    media?: string[];
+    redirect_url?: string;
+    receipt_button_text?: string;
+    receipt_link_url?: string;
+    receipt_thank_you_note?: string;
+    enabled_variants?: number[];
+}
+interface CheckoutOptions {
+    embed?: boolean;
+    media?: boolean;
+    logo?: boolean;
+    desc?: boolean;
+    discount?: boolean;
+    subscription_preview?: boolean;
+    /** Added 2024-03-28. */
+    skip_trial?: boolean;
+    /** Deprecated 2024-09-04; keep typed so old payloads still compile. */
+    dark?: boolean;
+    background_color?: string;
+    headings_color?: string;
+    primary_text_color?: string;
+    secondary_text_color?: string;
+    links_color?: string;
+    borders_color?: string;
+    checkbox_color?: string;
+    active_state_color?: string;
+    button_color?: string;
+    button_text_color?: string;
+    terms_privacy_color?: string;
+    locale?: CheckoutLocale | string | null;
+}
+interface CheckoutVariantQuantity {
+    variant_id: number;
+    quantity: number;
+}
+interface CheckoutData {
+    email?: string;
+    name?: string;
+    billing_address?: {
+        country?: string;
+        zip?: string;
+    };
+    tax_number?: string;
+    discount_code?: string;
+    custom?: Record<string, unknown>;
+    /** Added 2023-08-23 for multi-variant checkout quantities. */
+    variant_quantities?: CheckoutVariantQuantity[];
+}
+interface CheckoutPreview {
+    currency: string;
+    currency_rate: number | string;
+    subtotal: number;
+    discount_total: number;
+    tax: number;
+    total: number;
+    subtotal_usd: number;
+    discount_total_usd: number;
+    tax_usd: number;
+    total_usd: number;
+    subtotal_formatted: string;
+    discount_total_formatted: string;
+    tax_formatted: string;
+    total_formatted: string;
+}
+interface CheckoutAttributes extends GeneratedCheckoutAttributes {
+    store_id: number;
+    variant_id: number;
+    custom_price?: number | null;
+    product_options?: CheckoutProductOptions;
+    checkout_options?: CheckoutOptions;
+    checkout_data?: CheckoutData;
+    preview?: CheckoutPreview;
+    expires_at?: string | null;
+    url?: string;
+    created_at?: string;
+    updated_at?: string;
+    test_mode?: boolean;
 }
 /**
- * Document-level metadata on `/v1/users/me`.
- *
- * `test_mode` was added to the endpoint on 2024-01-05 (per the Lemon Squeezy
- * API changelog: https://docs.lemonsqueezy.com/api/getting-started/changelog).
- * It reports whether the *key* being used is a test-mode key, independent of
- * what the caller declared. The connection validator compares this against
- * the caller's declared mode to catch the common "prod key in staging"
- * (or vice versa) misconfiguration.
+ * Subset of webhook attributes we read. `events` is an ordered list of
+ * subscribed event names; the validator cross-references these against the
+ * support manifest to catch missing subscriptions.
  */
-interface UserMeta {
+interface WebhookAttributes extends GeneratedWebhookAttributes {
+    store_id: number;
+    url: string;
+    events: string[];
+    last_sent_at?: string | null;
+    created_at?: string;
+    updated_at?: string;
     test_mode?: boolean;
 }
+type AffiliateStatus = "active" | "pending" | "disabled";
 /**
- * Authenticated-user document with the `data` + `meta` block preserved.
- * The connection validator needs the meta flag, so we return the full
- * document here rather than just `data` as the collection helpers do.
+ * Affiliate attributes added with the 2025-01-21 Affiliates API surface.
+ * No validator consumes these yet; they type `lemon.affiliates.*` results.
  */
-type AuthenticatedUserDocument = JsonApiDocument<UserAttributes> & {
-    meta?: UserMeta;
-};
+interface AffiliateAttributes extends GeneratedAffiliateAttributes {
+    store_id: number;
+    user_id: number;
+    user_name: string;
+    user_email: string;
+    share_domain: string;
+    status: AffiliateStatus;
+    application_note?: string | null;
+    products?: unknown;
+    total_earnings: number;
+    unpaid_earnings: number;
+    created_at?: string;
+    updated_at?: string;
+}
+
 /**
- * Fetch the user associated with the API key. Primary use is the connection
- * validator: a successful call confirms the key is valid, surfaces the
- * account identity for logs, and exposes `meta.test_mode` for mode
- * mismatch detection.
- *
- * @param http - Shared API client.
- * @returns Full `/v1/users/me` document including `meta.test_mode`.
- * @throws {FreshSqueezyError} On HTTP/network failure.
+ * Options for a single HTTP request.
  *
- * @example
- * ```ts
- * const doc = await getAuthenticatedUser(http);
- * const mode = doc.meta?.test_mode ? "test" : "live";
- * ```
+ * `path` is a Lemon Squeezy API path starting with `/v1/...`. The `query`
+ * record is serialized via `URLSearchParams` (JSON:API bracket keys such as
+ * `filter[store_id]` are accepted as-is and percent-encoded in the final URL).
  */
-declare const getAuthenticatedUser: (http: HttpClient) => Promise<AuthenticatedUserDocument>;
-
-interface VariantLink {
-    title: string;
-    url: string;
+interface RequestOptions {
+    method?: "GET" | "POST" | "PATCH" | "DELETE";
+    path: string;
+    query?: Record<string, string | number | undefined>;
+    /** JSON:API document or other request body; stringified when present. */
+    body?: unknown;
+    signal?: AbortSignal;
 }
 /**
- * Variant attributes used by the product validator to detect
- * variant/price drift from the product they belong to.
+ * Low-level HTTP client. Callers usually go through resource/validator helpers,
+ * but this is also exposed as the public escape hatch so consumers can reach
+ * endpoints fresh-squeezy does not wrap yet.
+ *
+ * Responsibilities kept in this one place (the single transport chokepoint):
+ *   - auth header injection
+ *   - query string serialization (JSON:API bracket keys via URLSearchParams)
+ *   - response parsing + error normalization
+ *   - surfacing HTTP status in `FreshSqueezyError`
+ *   - walking paginated collections
  */
-interface VariantAttributes extends GeneratedVariantAttributes {
-    product_id: number;
-    name: string;
-    slug: string;
-    description?: string | null;
-    has_license_keys?: boolean;
-    license_activation_limit?: number | null;
-    is_license_limit_unlimited?: boolean;
-    license_length_value?: number | null;
-    license_length_unit?: "day" | "week" | "month" | "year" | null;
-    is_license_length_unlimited?: boolean;
-    status: "pending" | "draft" | "published";
-    status_formatted?: string;
-    is_subscription?: boolean;
-    interval?: string | null;
-    interval_count?: number | null;
-    sort?: number;
+declare class HttpClient {
+    private readonly config;
+    constructor(config: ResolvedConfig);
+    request<T>(options: RequestOptions): Promise<T>;
     /**
-     * Hosted-checkout-style links keyed by purpose. Added 2024-06-09 — older
-     * SDK and validator versions don't surface this field, so consumers had
-     * to read `meta.product_links` manually before. Optional because the
-     * field is absent on older variants.
+     * Fetch a single JSON:API resource and return its `data` object.
      */
-    links?: VariantLink[] | Record<string, string>;
-    created_at?: string;
-    updated_at?: string;
-    test_mode?: boolean;
+    getResource<TAttr>(path: string): Promise<JsonApiResource<TAttr>>;
+    /**
+     * Walk a JSON:API collection across every page and concatenate the
+     * results. Lemon Squeezy returns 25 items per page by default; without
+     * pagination, validators silently miss anything past the first page (e.g.
+     * `validateWebhook` on a store with 26+ webhooks would falsely report
+     * `WEBHOOK_NOT_FOUND` for any webhook on page 2).
+     *
+     * Stops as soon as `meta.page.lastPage` is reached. Falls back to a
+     * single-page fetch if the API does not surface page metadata.
+     *
+     * Caller-supplied `page[number]` is honored as the starting page; we
+     * advance from there. `page[size]` is left untouched so callers can tune
+     * batch size (max 100 per Lemon Squeezy docs).
+     */
+    paginate<TAttr>(path: string, query?: RequestOptions["query"]): Promise<JsonApiResource<TAttr>[]>;
+    private requestUrl;
 }
+
 /**
- * Extended variant attributes for subscription plan validation. In Lemon
- * Squeezy, "subscription plans" live as variants with `is_subscription: true`.
- * These fields are only present on subscription variants and are checked by
- * the subscription plan validator to catch misconfigured trial periods,
- * zero-price plans, and invalid billing intervals.
+ * Docs-backed ops matrix for Lemon Squeezy.
+ *
+ * Only verbs that exist at https://docs.lemonsqueezy.com/api are listed.
+ * Catalog resources (products, variants, prices, files, stores, …) are
+ * read-only. CI changelog scrape may propose gaps; this registry is what ships.
  */
-interface SubscriptionVariantAttributes extends VariantAttributes {
-    is_subscription: boolean;
-    interval: string | null;
-    interval_count: number | null;
-    has_free_trial: boolean;
-    trial_interval: string | null;
-    trial_interval_count: number | null;
-    price: number;
-}
+/** CLI / client verb tokens, including non-CRUD LS actions. */
+type OpVerb = "get" | "list" | "create" | "update" | "delete" | "cancel" | "refund" | "generate-invoice" | "current-usage";
 /**
- * Fetch a single variant by ID. Used by the subscription plan validator to
- * inspect subscription-specific fields (interval, trial, price).
+ * One implemented, documented operation.
+ *
+ * @remarks `docsPath` is the path under `/api/` on the LS docs site.
  */
-declare const getVariant: <TAttr = VariantAttributes>(http: HttpClient, variantId: string | number) => Promise<JsonApiResource<TAttr>>;
+interface ResourceVerbSpec {
+    /** CLI resource token (singular), e.g. `webhook`. */
+    resource: string;
+    verb: OpVerb;
+    /** Docs path fragment, e.g. `webhooks/create-webhook`. */
+    docsPath: string;
+    /** Requires --yes or TTY confirm always (delete/cancel/refund). */
+    destructive?: boolean;
+    body?: "required" | "optional" | "none";
+    /**
+     * How list/get resolve the primary id filter.
+     * - `id` — --id
+     * - `store` — --store-ids (first) or store filter
+     * - `parent` — --parent-id (subscription, order, product, …)
+     */
+    idRole?: "id" | "store" | "parent" | "none";
+}
 /**
- * List every variant of the product, paginated so products with more than
- * one page of variants don't trip the `VARIANT_UNPUBLISHED` heuristic when
- * the only published variants happen to live past page 1.
+ * Arguments for a single resource op invocation.
+ *
+ * One named input type — not a bag of unrelated returns.
  */
-declare const listVariantsForProduct: (http: HttpClient, productId: string | number) => Promise<JsonApiResource<VariantAttributes>[]>;
-
+interface InvokeOpArgs {
+    id?: string | number;
+    storeId?: string | number;
+    parentId?: string | number;
+    body?: unknown;
+}
 /**
- * Subset of webhook attributes we read. `events` is an ordered list of
- * subscribed event names; the validator cross-references these against the
- * support manifest to catch missing subscriptions.
+ * Implemented ops, one entry per documented resource verb. Keep in sync with
+ * the nested client in `createFreshSqueezy`.
  */
-interface WebhookAttributes extends GeneratedWebhookAttributes {
-    store_id: number;
-    url: string;
-    events: string[];
-    last_sent_at?: string | null;
-    created_at?: string;
-    updated_at?: string;
-    test_mode?: boolean;
-}
+declare const resourceRegistry: readonly ResourceVerbSpec[];
 /**
- * Retrieve one webhook by id.
- *
- * @param http - Shared API client.
- * @param webhookId - Webhook id.
- * @returns The webhook resource.
- * @throws {FreshSqueezyError} On HTTP/network failure.
+ * Normalize a CLI resource token to the singular registry key.
  *
- * @example
- * ```ts
- * const webhook = await getWebhook(http, 1);
- * ```
+ * @param resource - Raw token (`products`, `order_items`, `webhook`).
+ * @returns Canonical singular resource name used in `resourceRegistry`.
  */
-declare const getWebhook: (http: HttpClient, webhookId: string | number) => Promise<JsonApiResource<WebhookAttributes>>;
+declare const normalizeResourceName: (resource: string) => string;
 /**
- * List every webhook registered on the store, walking pagination so a store
- * with more than one page of webhooks doesn't produce a false
- * `WEBHOOK_NOT_FOUND` from `validateWebhook`.
- *
- * @param http - Shared API client.
- * @param storeId - Store to filter.
- * @returns All webhook resources for the store.
- * @throws {FreshSqueezyError} On HTTP/network failure.
+ * Look up a registry entry.
  *
- * @example
- * ```ts
- * const webhooks = await listWebhooksForStore(http, 1);
- * ```
+ * @param resource - CLI resource token.
+ * @param verb - Op verb.
+ * @returns The spec, or undefined when not implemented / not in LS API.
  */
-declare const listWebhooksForStore: (http: HttpClient, storeId: string | number) => Promise<JsonApiResource<WebhookAttributes>[]>;
+declare const findResourceVerb: (resource: string, verb: string) => ResourceVerbSpec | undefined;
 /**
- * Create a webhook (POST /v1/webhooks).
- * Docs: https://docs.lemonsqueezy.com/api/webhooks/create-webhook
- *
- * @param http - Shared API client.
- * @param body - JSON:API create document.
- * @returns The created webhook.
- * @throws {FreshSqueezyError} On HTTP/network failure.
+ * Unique resource names that have at least one verb.
  *
- * @example
- * ```ts
- * const webhook = await createWebhook(http, {
- *   data: {
- *     type: "webhooks",
- *     attributes: { url: "https://app.example.com/hook", events: ["order_created"] },
- *     relationships: { store: { data: { type: "stores", id: "1" } } },
- *   },
- * });
- * ```
+ * @returns Sorted resource tokens for help text / menus.
  */
-declare const createWebhook: (http: HttpClient, body: unknown) => Promise<JsonApiResource<WebhookAttributes>>;
+declare const listRegisteredResources: () => string[];
 /**
- * Update a webhook (PATCH /v1/webhooks/:id).
- * Docs: https://docs.lemonsqueezy.com/api/webhooks/update-webhook
- *
- * @param http - Shared API client.
- * @param webhookId - Webhook id.
- * @param body - JSON:API update document.
- * @returns The updated webhook.
- * @throws {FreshSqueezyError} On HTTP/network failure.
+ * All verbs registered for a resource (empty when unknown).
  *
- * @example
- * ```ts
- * const webhook = await updateWebhook(http, 1, {
- *   data: { type: "webhooks", id: "1", attributes: { events: ["order_created"] } },
- * });
- * ```
+ * @param resource - CLI resource token (plural or singular).
+ * @returns Sorted verb list for help / menus.
  */
-declare const updateWebhook: (http: HttpClient, webhookId: string | number, body: unknown) => Promise<JsonApiResource<WebhookAttributes>>;
+declare const listRegisteredVerbs: (resource: string) => OpVerb[];
 /**
- * Delete a webhook (DELETE /v1/webhooks/:id).
- * Docs: https://docs.lemonsqueezy.com/api/webhooks/delete-webhook
+ * Run a docs-backed resource verb: look it up in `resourceRegistry`, then make
+ * the one HTTP call its verb rule describes.
  *
  * @param http - Shared API client.
- * @param webhookId - Webhook id.
- * @returns Nothing on success.
- * @throws {FreshSqueezyError} On HTTP/network failure.
+ * @param resource - CLI resource token (`webhook`, `product`, …).
+ * @param verb - Op verb (`get`, `create`, `refund`, …).
+ * @param args - Ids / body for the call.
+ * @returns The JSON:API `data` (resource or list), the whole document for
+ * endpoints that return only `meta` (invoices, usage), or undefined after a delete.
+ * @throws {FreshSqueezyError} When the verb is unknown, an argument is missing, or HTTP fails.
  *
  * @example
  * ```ts
- * await deleteWebhook(http, 1);
+ * const product = await invokeOp(http, "product", "get", { id: 42 });
+ * // GET /v1/products/42
  * ```
  */
-declare const deleteWebhook: (http: HttpClient, webhookId: string | number) => Promise<void>;
+declare const invokeOp: (http: HttpClient, resource: string, verb: OpVerb | string, args?: InvokeOpArgs) => Promise<unknown>;
 
 /**
  * Connection validator summary attached to the `resource` field. Keeps the
@@ -2158,11 +1396,24 @@ interface ConnectionSummary {
     /** The mode the caller asked for at construction time. */
     declaredMode: Mode;
 }
+/**
+ * Map the boolean `meta.test_mode` flag from `/v1/users/me` to our `Mode` type.
+ *
+ * Returns `undefined` when the field is absent so older accounts and proxies
+ * that don't surface the flag don't produce spurious mode mismatches. Lemon
+ * Squeezy added `meta.test_mode` to the endpoint on 2024-01-05 (see API
+ * changelog: https://docs.lemonsqueezy.com/api/getting-started/changelog).
+ *
+ * Pure function — exposed publicly so consumers can resolve a key's true mode
+ * from a `/v1/users/me` document they already have, without re-running the
+ * full connection validator.
+ */
+declare const resolveActualMode: (testMode: boolean | undefined) => Mode | undefined;
 /**
  * Verify that the API key works, surface the account identity + reachable
  * stores, and cross-check declared mode vs the key's true mode.
  *
- * This is the first check every `doctor()` run performs; if it fails,
+ * This is the first validator every `doctor()` run performs; if it fails,
  * no downstream validator has anything useful to report.
  */
 declare const validateConnection: (http: HttpClient, mode: Mode) => Promise<ValidationResult<ConnectionSummary>>;
@@ -2174,11 +1425,8 @@ declare const validateConnection: (http: HttpClient, mode: Mode) => Promise<Vali
  * Returns `undefined` if the API doesn't surface `meta.test_mode` (older
  * proxies, partial responses).
  *
- * Lives here rather than in `core/mode.ts` so the foundational `core/` layer
- * never imports from `resources/`; the pure `resolveActualMode` it delegates to
- * still lives in `core/`. Throws `FreshSqueezyError` on auth or network
- * failure; callers that want a structured non-throwing result should use
- * `validateConnection` instead.
+ * Throws `FreshSqueezyError` on auth or network failure; callers that want a
+ * structured non-throwing result should use `validateConnection` instead.
  */
 declare const fetchActualMode: (http: HttpClient) => Promise<Mode | undefined>;
 
@@ -2290,6 +1538,14 @@ interface WebhookValidationOptions {
     /** The public URL your app exposes for Lemon Squeezy to POST to. */
     url: string;
 }
+/**
+ * Compare two webhook URLs ignoring trailing slashes and casing.
+ *
+ * Lemon Squeezy strips trailing slashes when persisting a webhook, but users
+ * often paste the trailing-slash form into their config. `validateWebhook`
+ * relies on this rule to match a configured URL against the registered list.
+ */
+declare const sameWebhookUrl: (a: string, b: string) => boolean;
 /**
  * Confirm a webhook matching `options.url` is registered against the given
  * store, and cross-reference its subscribed events against the support
@@ -2339,7 +1595,7 @@ interface DoctorValidators {
 declare const DEFAULT_VALIDATORS: DoctorValidators;
 /**
  * Compose every configured validator into a single report. This is the
- * primary entry point for CI health checks: one call, one structured result,
+ * primary entry point for CI pre-flight runs: one call, one structured result,
  * one exit code decision.
  *
  * Order is meaningful. Connection runs first because downstream validators
@@ -2475,7 +1731,7 @@ declare const ACKNOWLEDGED_CHANGELOG_ENTRIES: readonly [{
 }, {
     readonly date: "2025-06-11";
     readonly summary: "Added payment_processor attribute to Subscription objects.";
-    readonly handledBy: "Surfaced as SubscriptionAttributes.payment_processor in src/resources/subscriptions.ts.";
+    readonly handledBy: "Surfaced as SubscriptionAttributes.payment_processor in src/resources/attributes.ts.";
 }, {
     readonly date: "2025-01-21";
     readonly summary: "Added Affiliates endpoints and affiliate_activated webhook.";
@@ -2483,11 +1739,11 @@ declare const ACKNOWLEDGED_CHANGELOG_ENTRIES: readonly [{
 }, {
     readonly date: "2024-12-06";
     readonly summary: "Added quantity parameter to OrderItem objects.";
-    readonly handledBy: "OrderItemAttributes.quantity (src/resources/orderItems.ts).";
+    readonly handledBy: "OrderItemAttributes.quantity (src/resources/attributes.ts).";
 }, {
     readonly date: "2024-09-10";
     readonly summary: "Added fraudulent Order status.";
-    readonly handledBy: "OrderAttributes.status union includes 'fraudulent' (src/resources/orders.ts).";
+    readonly handledBy: "OrderAttributes.status union includes 'fraudulent' (src/resources/attributes.ts).";
 }, {
     readonly date: "2024-09-04";
     readonly summary: "Added Issue an Order refund and Issue a Subscription Invoice refund endpoints.";
@@ -2499,7 +1755,7 @@ declare const ACKNOWLEDGED_CHANGELOG_ENTRIES: readonly [{
 }, {
     readonly date: "2024-06-09";
     readonly summary: "Added links property to Variant objects.";
-    readonly handledBy: "VariantAttributes.links (src/resources/variants.ts).";
+    readonly handledBy: "VariantAttributes.links (src/resources/attributes.ts).";
 }, {
     readonly date: "2024-05-20";
     readonly summary: "Added Generate order invoice endpoint.";
@@ -2515,7 +1771,7 @@ declare const ACKNOWLEDGED_CHANGELOG_ENTRIES: readonly [{
 }, {
     readonly date: "2024-02-20";
     readonly summary: "Added urls.update_customer_portal to Subscription objects.";
-    readonly handledBy: "SubscriptionUrls.update_customer_portal (src/resources/subscriptions.ts).";
+    readonly handledBy: "SubscriptionUrls.update_customer_portal (src/resources/attributes.ts).";
 }, {
     readonly date: "2024-02-12";
     readonly summary: "Added Generate subscription invoice endpoint and invoice_immediately / disable_prorations parameters.";
@@ -2870,4 +2126,4 @@ interface FreshSqueezyClient extends FreshSqueezyOps {
  */
 declare const createFreshSqueezy: (config?: FreshSqueezyConfig) => FreshSqueezyClient;
 
-export { ACKNOWLEDGED_CHANGELOG_ENTRIES, type AffiliateAttributes, type AffiliateStatus, type AuthenticatedUserDocument, type CheckoutAttributes, type CheckoutData, type CheckoutLocale, type CheckoutOptions, type CheckoutPreview, type CheckoutProductOptions, type CheckoutVariantQuantity, type ConnectionSummary, type CustomerAttributes, type CustomerStatus, type CustomerUrls, DEFAULT_VALIDATORS, type DiscountAttributes, type DiscountRedemptionAttributes, type DiscountValidationOptions, type DoctorOptions, type DoctorReport, type DoctorValidators, ENV_KEYS, type FileAttributes, type FreshSqueezyClient, type FreshSqueezyConfig, FreshSqueezyError, type FreshSqueezyOps, GENERATED_LEMON_SQUEEZY_RESOURCES, GENERATED_LEMON_SQUEEZY_TYPE_SOURCE, type GeneratedAffiliateAttributes, type GeneratedCheckoutAttributes, type GeneratedCustomerAttributes, type GeneratedDiscountAttributes, type GeneratedDiscountRedemptionAttributes, type GeneratedFileAttributes, type GeneratedLemonSqueezyFieldMap, type GeneratedLemonSqueezyResourceName, type GeneratedLemonSqueezyResourceType, type GeneratedLicenseKeyAttributes, type GeneratedLicenseKeyInstanceAttributes, type GeneratedOrderAttributes, type GeneratedOrderItemAttributes, type GeneratedPriceAttributes, type GeneratedProductAttributes, type GeneratedStoreAttributes, type GeneratedSubscriptionAttributes, type GeneratedSubscriptionInvoiceAttributes, type GeneratedSubscriptionItemAttributes, type GeneratedUsageRecordAttributes, type GeneratedUserAttributes, type GeneratedVariantAttributes, type GeneratedWebhookAttributes, ISSUE_CODES, type InvokeOpArgs, type JsonApiCollection, type JsonApiDocument, type JsonApiResource, type LatestCheckoutDataFields, type LatestCheckoutFields, type LatestCheckoutOptionsFields, type LatestFieldsFor, type LatestLemonSqueezyFieldMap, type LatestLemonSqueezyResourceName, type LatestOrderFields, type LatestOrderItemFields, type LatestPriceFields, type LatestSubscriptionFields, type LatestSubscriptionInvoiceFields, type LatestSubscriptionItemUpdateFields, type LatestVariantFields, type LicenseKeyAttributes, type LicenseKeyInstanceAttributes, type LicenseKeyValidationOptions, type Mode, OPTIONAL_WEBHOOK_EVENTS, type OpVerb, type OptionalEvent, type OrderAttributes, type OrderFirstItem, type OrderItemAttributes, type OrderUrls, type PriceAttributes, type ProductAttributes, type ProductValidationOptions, RECOMMENDED_WEBHOOK_EVENTS, type RecommendedEvent, type ResolvedConfig, type ResourceVerbSpec, SUPPORTED_RESOURCES, type StoreAttributes, type SubscriptionAttributes, type SubscriptionInvoiceAttributes, type SubscriptionInvoiceBillingReason, type SubscriptionInvoiceStatus, type SubscriptionInvoiceUrls, type SubscriptionItemAttributes, type SubscriptionItemSummary, type SubscriptionItemUpdateAttributes, type SubscriptionPause, type SubscriptionPlanSummary, type SubscriptionPlanValidationOptions, type SubscriptionUrls, type SubscriptionVariantAttributes, type UsageRecordAction, type UsageRecordAttributes, type UserAttributes, type UserMeta, type ValidationIssue, type ValidationResult, type ValidationSeverity, type ValidationTarget, type VariantAttributes, type VariantLink, type WebhookAttributes, type WebhookValidationOptions, type WithLatestLemonSqueezyFields, buildResult, buildSubscriptionItemUpdateBody, cancelSubscription, checkDiscount, checkLicenseKey, checkProduct, checkSubscriptionPlan, createCheckout, createCustomer, createDiscount, createFreshSqueezy, createUsageRecord, createWebhook, deleteDiscount, deleteWebhook, doctor, fetchActualMode, findResourceVerb, generateOrderInvoice, generateSubscriptionInvoice, getAffiliate, getAuthenticatedUser, getCheckout, getCustomer, getDiscount, getDiscountRedemption, getFile, getLicenseKey, getLicenseKeyInstance, getOrder, getOrderItem, getPrice, getProduct, getStore, getSubscription, getSubscriptionInvoice, getSubscriptionItem, getSubscriptionItemCurrentUsage, getUsageRecord, getVariant, getWebhook, invokeOp, isOk, issue, listAffiliatesForStore, listCheckoutsForStore, listCustomersForStore, listDiscountRedemptionsForDiscount, listDiscountsForStore, listFilesForVariant, listLicenseKeyInstancesForLicenseKey, listLicenseKeysForStore, listOrderItemsForOrder, listOrdersForStore, listPricesForVariant, listProducts, listRegisteredResources, listRegisteredVerbs, listStores, listSubscriptionInvoicesForSubscription, listSubscriptionItemsForSubscription, listSubscriptionsForStore, listUsageRecordsForSubscriptionItem, listVariantsForProduct, listWebhooksForStore, normalizeResourceName, refundOrder, refundSubscriptionInvoice, resolveActualMode, resolveConfig, resourceRegistry, sameWebhookUrl, updateCustomer, updateLicenseKey, updateSubscription, updateSubscriptionItem, updateWebhook, validateConnection, validateDiscount, validateLicenseKey, validateProduct, validateStore, validateSubscriptionPlan, validateWebhook };
+export { ACKNOWLEDGED_CHANGELOG_ENTRIES, type AffiliateAttributes, type AffiliateStatus, type AuthenticatedUserDocument, type CheckoutAttributes, type CheckoutData, type CheckoutLocale, type CheckoutOptions, type CheckoutPreview, type CheckoutProductOptions, type CheckoutVariantQuantity, type ConnectionSummary, type CustomerAttributes, type CustomerStatus, type CustomerUrls, DEFAULT_VALIDATORS, type DiscountAttributes, type DiscountRedemptionAttributes, type DiscountValidationOptions, type DoctorOptions, type DoctorReport, type DoctorValidators, ENV_KEYS, type FileAttributes, type FreshSqueezyClient, type FreshSqueezyConfig, FreshSqueezyError, type FreshSqueezyOps, GENERATED_LEMON_SQUEEZY_RESOURCES, GENERATED_LEMON_SQUEEZY_TYPE_SOURCE, type GeneratedAffiliateAttributes, type GeneratedCheckoutAttributes, type GeneratedCustomerAttributes, type GeneratedDiscountAttributes, type GeneratedDiscountRedemptionAttributes, type GeneratedFileAttributes, type GeneratedLemonSqueezyFieldMap, type GeneratedLemonSqueezyResourceName, type GeneratedLemonSqueezyResourceType, type GeneratedLicenseKeyAttributes, type GeneratedLicenseKeyInstanceAttributes, type GeneratedOrderAttributes, type GeneratedOrderItemAttributes, type GeneratedPriceAttributes, type GeneratedProductAttributes, type GeneratedStoreAttributes, type GeneratedSubscriptionAttributes, type GeneratedSubscriptionInvoiceAttributes, type GeneratedSubscriptionItemAttributes, type GeneratedUsageRecordAttributes, type GeneratedUserAttributes, type GeneratedVariantAttributes, type GeneratedWebhookAttributes, ISSUE_CODES, type InvokeOpArgs, type JsonApiCollection, type JsonApiDocument, type JsonApiResource, type LatestCheckoutDataFields, type LatestCheckoutFields, type LatestCheckoutOptionsFields, type LatestFieldsFor, type LatestLemonSqueezyFieldMap, type LatestLemonSqueezyResourceName, type LatestOrderFields, type LatestOrderItemFields, type LatestPriceFields, type LatestSubscriptionFields, type LatestSubscriptionInvoiceFields, type LatestSubscriptionItemUpdateFields, type LatestVariantFields, type LicenseKeyAttributes, type LicenseKeyInstanceAttributes, type LicenseKeyValidationOptions, type Mode, OPTIONAL_WEBHOOK_EVENTS, type OpVerb, type OptionalEvent, type OrderAttributes, type OrderFirstItem, type OrderItemAttributes, type OrderUrls, type PriceAttributes, type ProductAttributes, type ProductValidationOptions, RECOMMENDED_WEBHOOK_EVENTS, type RecommendedEvent, type ResolvedConfig, type ResourceVerbSpec, SUPPORTED_RESOURCES, type StoreAttributes, type SubscriptionAttributes, type SubscriptionInvoiceAttributes, type SubscriptionInvoiceBillingReason, type SubscriptionInvoiceStatus, type SubscriptionInvoiceUrls, type SubscriptionItemAttributes, type SubscriptionItemSummary, type SubscriptionItemUpdateAttributes, type SubscriptionPause, type SubscriptionPlanSummary, type SubscriptionPlanValidationOptions, type SubscriptionUrls, type SubscriptionVariantAttributes, type UsageRecordAction, type UsageRecordAttributes, type UserAttributes, type UserMeta, type ValidationIssue, type ValidationResult, type ValidationSeverity, type ValidationTarget, type VariantAttributes, type VariantLink, type WebhookAttributes, type WebhookValidationOptions, type WithLatestLemonSqueezyFields, buildResult, buildSubscriptionItemUpdateBody, checkDiscount, checkLicenseKey, checkProduct, checkSubscriptionPlan, createFreshSqueezy, doctor, fetchActualMode, findResourceVerb, invokeOp, isOk, issue, listRegisteredResources, listRegisteredVerbs, normalizeResourceName, resolveActualMode, resolveConfig, resourceRegistry, sameWebhookUrl, validateConnection, validateDiscount, validateLicenseKey, validateProduct, validateStore, validateSubscriptionPlan, validateWebhook };