fresh-squeezy 0.1.13 → 0.1.15

package/dist/index.d.ts

@@ -757,7 +757,8 @@ interface RequestOptions {
     method?: "GET" | "POST" | "PATCH" | "DELETE";
     path: string;
     query?: Record<string, string | number | undefined>;
-    body?: Record<string, unknown>;
+    /** JSON:API document or other request body; stringified when present. */
+    body?: unknown;
     signal?: AbortSignal;
 }
 /**
@@ -783,6 +784,29 @@ declare class HttpClient {
      * 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
@@ -827,6 +851,71 @@ interface DiscountAttributes extends GeneratedDiscountAttributes {
     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>;
 
 /**
  * Subset of Lemon Squeezy license-key attributes used by the license key
@@ -843,6 +932,53 @@ interface LicenseKeyAttributes extends GeneratedLicenseKeyAttributes {
     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>>;
 
 /**
  * Subset of product attributes we need for validation. `status` drives the
@@ -861,13 +997,13 @@ interface ProductAttributes extends GeneratedProductAttributes {
     created_at?: string;
     updated_at?: string;
 }
-declare function getProduct(http: HttpClient, productId: string | number): Promise<JsonApiResource<ProductAttributes>>;
+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 function listProducts(http: HttpClient, storeId: string | number): Promise<JsonApiResource<ProductAttributes>[]>;
+declare const listProducts: (http: HttpClient, storeId: string | number) => Promise<JsonApiResource<ProductAttributes>[]>;
 
 /**
  * Subset of store attributes fresh-squeezy reads.
@@ -884,14 +1020,14 @@ interface StoreAttributes extends GeneratedStoreAttributes {
     created_at?: string;
     updated_at?: string;
 }
-declare function getStore(http: HttpClient, storeId: string | number): Promise<JsonApiResource<StoreAttributes>>;
+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 function listStores(http: HttpClient): Promise<JsonApiResource<StoreAttributes>[]>;
+declare const listStores: (http: HttpClient) => Promise<JsonApiResource<StoreAttributes>[]>;
 
 /**
  * Subset of webhook attributes we read. `events` is an ordered list of
@@ -907,12 +1043,90 @@ interface WebhookAttributes extends GeneratedWebhookAttributes {
     updated_at?: string;
     test_mode?: boolean;
 }
+/**
+ * Retrieve one webhook by id.
+ *
+ * @param http - Shared API client.
+ * @param webhookId - Webhook id.
+ * @returns The webhook resource.
+ * @throws {FreshSqueezyError} On HTTP/network failure.
+ *
+ * @example
+ * ```ts
+ * const webhook = await getWebhook(http, 1);
+ * ```
+ */
+declare const getWebhook: (http: HttpClient, webhookId: string | number) => Promise<JsonApiResource<WebhookAttributes>>;
 /**
  * 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.
+ *
+ * @example
+ * ```ts
+ * const webhooks = await listWebhooksForStore(http, 1);
+ * ```
  */
-declare function listWebhooksForStore(http: HttpClient, storeId: string | number): Promise<JsonApiResource<WebhookAttributes>[]>;
+declare const listWebhooksForStore: (http: HttpClient, storeId: string | number) => Promise<JsonApiResource<WebhookAttributes>[]>;
+/**
+ * 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.
+ *
+ * @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" } } },
+ *   },
+ * });
+ * ```
+ */
+declare const createWebhook: (http: HttpClient, body: unknown) => Promise<JsonApiResource<WebhookAttributes>>;
+/**
+ * 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.
+ *
+ * @example
+ * ```ts
+ * const webhook = await updateWebhook(http, 1, {
+ *   data: { type: "webhooks", id: "1", attributes: { events: ["order_created"] } },
+ * });
+ * ```
+ */
+declare const updateWebhook: (http: HttpClient, webhookId: string | number, body: unknown) => Promise<JsonApiResource<WebhookAttributes>>;
+/**
+ * Delete a webhook (DELETE /v1/webhooks/:id).
+ * Docs: https://docs.lemonsqueezy.com/api/webhooks/delete-webhook
+ *
+ * @param http - Shared API client.
+ * @param webhookId - Webhook id.
+ * @returns Nothing on success.
+ * @throws {FreshSqueezyError} On HTTP/network failure.
+ *
+ * @example
+ * ```ts
+ * await deleteWebhook(http, 1);
+ * ```
+ */
+declare const deleteWebhook: (http: HttpClient, webhookId: string | number) => Promise<void>;
 
 /**
  * Subset of the Lemon Squeezy `users` resource attributes we rely on.
@@ -954,12 +1168,12 @@ type AuthenticatedUserDocument = JsonApiDocument<UserAttributes> & {
  * account identity for logs, and exposes `meta.test_mode` for mode
  * mismatch detection.
  */
-declare function getAuthenticatedUser(http: HttpClient): Promise<AuthenticatedUserDocument>;
+declare const getAuthenticatedUser: (http: HttpClient) => Promise<AuthenticatedUserDocument>;
 /**
  * Backwards-compatible helper if a caller only wants the resource (old
  * `getAuthenticatedUser` shape). Internal — not re-exported from the root.
  */
-declare function userResource(doc: AuthenticatedUserDocument): JsonApiResource<UserAttributes>;
+declare const userResource: (doc: AuthenticatedUserDocument) => JsonApiResource<UserAttributes>;
 
 /**
  * Connection validator summary attached to the `resource` field. Keeps the
@@ -987,7 +1201,7 @@ interface ConnectionSummary {
  * This is the first check every `doctor()` run performs; if it fails,
  * no downstream validator has anything useful to report.
  */
-declare function validateConnection(http: HttpClient, mode: Mode): Promise<ValidationResult<ConnectionSummary>>;
+declare const validateConnection: (http: HttpClient, mode: Mode) => Promise<ValidationResult<ConnectionSummary>>;
 /**
  * Ask the Lemon Squeezy API which mode the configured key actually belongs to.
  *
@@ -1002,7 +1216,7 @@ declare function validateConnection(http: HttpClient, mode: Mode): Promise<Valid
  * failure; callers that want a structured non-throwing result should use
  * `validateConnection` instead.
  */
-declare function fetchActualMode(http: HttpClient): Promise<Mode | undefined>;
+declare const fetchActualMode: (http: HttpClient) => Promise<Mode | undefined>;
 
 interface DiscountValidationOptions {
     storeId: string | number;
@@ -1020,15 +1234,15 @@ interface DiscountValidationOptions {
  * `/v1/discount-redemptions?filter[discount_id]=` is YAGNI until a consumer
  * asks for it.
  */
-declare function validateDiscount(http: HttpClient, mode: Mode, options: DiscountValidationOptions): Promise<ValidationResult<DiscountAttributes>>;
+declare const validateDiscount: (http: HttpClient, mode: Mode, options: DiscountValidationOptions) => Promise<ValidationResult<DiscountAttributes>>;
 /**
  * Pure attribute assertions for a discount: store ownership, draft/expiry/
  * activation windows, redemption exhaustion, and amount validity. No I/O, so
  * the rules are unit-testable with plain data.
  */
-declare function checkDiscount(attrs: DiscountAttributes, options: {
+declare const checkDiscount: (attrs: DiscountAttributes, options: {
     storeId: string | number;
-}): ValidationIssue[];
+}) => ValidationIssue[];
 
 interface LicenseKeyValidationOptions {
     storeId: string | number;
@@ -1040,15 +1254,15 @@ interface LicenseKeyValidationOptions {
  * four states most likely to cause "why can't my customer activate?"
  * support tickets.
  */
-declare function validateLicenseKey(http: HttpClient, mode: Mode, options: LicenseKeyValidationOptions): Promise<ValidationResult<LicenseKeyAttributes>>;
+declare const validateLicenseKey: (http: HttpClient, mode: Mode, options: LicenseKeyValidationOptions) => Promise<ValidationResult<LicenseKeyAttributes>>;
 /**
  * Pure attribute assertions for a license key: store ownership, disabled/
  * expired state, and activation-limit exhaustion. No I/O, so the rules are
  * unit-testable with plain data.
  */
-declare function checkLicenseKey(attrs: LicenseKeyAttributes, options: {
+declare const checkLicenseKey: (attrs: LicenseKeyAttributes, options: {
     storeId: string | number;
-}): ValidationIssue[];
+}) => ValidationIssue[];
 
 interface ProductValidationOptions {
     productId: string | number;
@@ -1060,16 +1274,16 @@ interface ProductValidationOptions {
  * least one published variant. Surfaces the most common misconfigurations
  * caught in the wild (unpublished product, wrong store, missing variants).
  */
-declare function validateProduct(http: HttpClient, mode: Mode, options: ProductValidationOptions): Promise<ValidationResult<ProductAttributes>>;
+declare const validateProduct: (http: HttpClient, mode: Mode, options: ProductValidationOptions) => Promise<ValidationResult<ProductAttributes>>;
 /**
  * Pure attribute assertions for a product: store ownership, publish state, and
  * hosted-checkout availability. The variant-population rule needs a second
  * fetch and stays in `validateProduct`; everything here runs on plain data, so
  * the rules are unit-testable without a mock fetch.
  */
-declare function checkProduct(attrs: ProductAttributes, options?: {
+declare const checkProduct: (attrs: ProductAttributes, options?: {
     expectedStoreId?: string | number;
-}): ValidationIssue[];
+}) => ValidationIssue[];
 
 interface VariantLink {
     title: string;
@@ -1127,13 +1341,13 @@ interface SubscriptionVariantAttributes extends VariantAttributes {
  * Fetch a single variant by ID. Used by the subscription plan validator to
  * inspect subscription-specific fields (interval, trial, price).
  */
-declare function getVariant<TAttr = VariantAttributes>(http: HttpClient, variantId: string | number): Promise<JsonApiResource<TAttr>>;
+declare const getVariant: <TAttr = VariantAttributes>(http: HttpClient, variantId: string | number) => Promise<JsonApiResource<TAttr>>;
 /**
  * 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.
  */
-declare function listVariantsForProduct(http: HttpClient, productId: string | number): Promise<JsonApiResource<VariantAttributes>[]>;
+declare const listVariantsForProduct: (http: HttpClient, productId: string | number) => Promise<JsonApiResource<VariantAttributes>[]>;
 
 interface SubscriptionPlanValidationOptions {
     storeId: string | number;
@@ -1159,7 +1373,7 @@ interface SubscriptionPlanSummary {
  * `storeId` as advisory — if the product fetch fails the cross-check is
  * silently skipped rather than blocking the entire validation.
  */
-declare function validateSubscriptionPlan(http: HttpClient, mode: Mode, options: SubscriptionPlanValidationOptions): Promise<ValidationResult<SubscriptionPlanSummary>>;
+declare const validateSubscriptionPlan: (http: HttpClient, mode: Mode, options: SubscriptionPlanValidationOptions) => Promise<ValidationResult<SubscriptionPlanSummary>>;
 /**
  * Pure attribute assertions for a subscription variant: that it is actually a
  * subscription, has a valid interval / interval_count, is not free-priced, has
@@ -1167,9 +1381,9 @@ declare function validateSubscriptionPlan(http: HttpClient, mode: Mode, options:
  * second fetch and stays in `validateSubscriptionPlan`; everything here runs on
  * plain data, so the rules are unit-testable without a mock fetch.
  */
-declare function checkSubscriptionPlan(attrs: SubscriptionVariantAttributes, options: {
+declare const checkSubscriptionPlan: (attrs: SubscriptionVariantAttributes, options: {
     variantId: string | number;
-}): ValidationIssue[];
+}) => ValidationIssue[];
 
 interface WebhookValidationOptions {
     storeId: string | number;
@@ -1184,7 +1398,7 @@ interface WebhookValidationOptions {
  * Missing recommended events = error. Missing optional events = info, because
  * not every integration needs them.
  */
-declare function validateWebhook(http: HttpClient, mode: Mode, options: WebhookValidationOptions): Promise<ValidationResult<WebhookAttributes>>;
+declare const validateWebhook: (http: HttpClient, mode: Mode, options: WebhookValidationOptions) => Promise<ValidationResult<WebhookAttributes>>;
 
 /**
  * Optional targets for the doctor run. If a target is omitted, its validator
@@ -1234,14 +1448,116 @@ declare const DEFAULT_VALIDATORS: DoctorValidators;
  * The optional `validators` parameter lets tests inject fakes without a fetch
  * mock; production callers omit it and get `DEFAULT_VALIDATORS`.
  */
-declare function doctor(http: HttpClient, mode: Mode, options?: DoctorOptions, validators?: DoctorValidators): Promise<DoctorReport>;
+declare const doctor: (http: HttpClient, mode: Mode, options?: DoctorOptions, validators?: DoctorValidators) => Promise<DoctorReport>;
 
 /**
- * The public client. All consumer code flows through the factory below —
- * direct instantiation is intentionally not exposed so we can evolve the
- * internals without breaking callers.
+ * Nested resource namespaces for docs-backed Lemon Squeezy ops.
+ * Methods only exist when the official API documents them (no product.create).
  */
-interface FreshSqueezyClient {
+interface FreshSqueezyOps {
+    users: {
+        me: () => Promise<unknown>;
+    };
+    stores: {
+        get: (id: string | number) => Promise<unknown>;
+        list: () => Promise<unknown>;
+    };
+    products: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (storeId: string | number) => Promise<unknown>;
+    };
+    variants: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (productId: string | number) => Promise<unknown>;
+    };
+    prices: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (variantId: string | number) => Promise<unknown>;
+    };
+    files: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (variantId: string | number) => Promise<unknown>;
+    };
+    customers: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (storeId: string | number) => Promise<unknown>;
+        create: (body: unknown) => Promise<unknown>;
+        update: (id: string | number, body: unknown) => Promise<unknown>;
+    };
+    orders: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (storeId: string | number) => Promise<unknown>;
+        refund: (id: string | number, body?: unknown) => Promise<unknown>;
+        generateInvoice: (id: string | number, body?: unknown) => Promise<unknown>;
+    };
+    orderItems: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (orderId: string | number) => Promise<unknown>;
+    };
+    subscriptions: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (storeId: string | number) => Promise<unknown>;
+        update: (id: string | number, body: unknown) => Promise<unknown>;
+        cancel: (id: string | number) => Promise<unknown>;
+    };
+    subscriptionItems: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (subscriptionId: string | number) => Promise<unknown>;
+        update: (id: string | number, body: unknown) => Promise<unknown>;
+        currentUsage: (id: string | number) => Promise<unknown>;
+    };
+    subscriptionInvoices: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (subscriptionId: string | number) => Promise<unknown>;
+        refund: (id: string | number, body?: unknown) => Promise<unknown>;
+        generateInvoice: (id: string | number, body?: unknown) => Promise<unknown>;
+    };
+    usageRecords: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (subscriptionItemId: string | number) => Promise<unknown>;
+        create: (body: unknown) => Promise<unknown>;
+    };
+    discounts: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (storeId: string | number) => Promise<unknown>;
+        create: (body: unknown) => Promise<unknown>;
+        delete: (id: string | number) => Promise<unknown>;
+    };
+    discountRedemptions: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (discountId: string | number) => Promise<unknown>;
+    };
+    licenseKeys: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (storeId: string | number) => Promise<unknown>;
+        update: (id: string | number, body: unknown) => Promise<unknown>;
+    };
+    licenseKeyInstances: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (licenseKeyId: string | number) => Promise<unknown>;
+    };
+    checkouts: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (storeId: string | number) => Promise<unknown>;
+        create: (body: unknown) => Promise<unknown>;
+    };
+    webhooks: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (storeId: string | number) => Promise<unknown>;
+        create: (body: unknown) => Promise<unknown>;
+        update: (id: string | number, body: unknown) => Promise<unknown>;
+        delete: (id: string | number) => Promise<unknown>;
+    };
+    affiliates: {
+        get: (id: string | number) => Promise<unknown>;
+        list: (storeId: string | number) => Promise<unknown>;
+    };
+}
+/**
+ * The public client. Validators stay flat; ops live under nested namespaces
+ * that mirror docs-backed resources.
+ */
+interface FreshSqueezyClient extends FreshSqueezyOps {
     /** Resolved mode (test or live). Surfaced so consumers can log it. */
     readonly mode: Mode;
     /** Raw HTTP escape hatch for endpoints fresh-squeezy does not wrap. */
@@ -1260,14 +1576,20 @@ interface FreshSqueezyClient {
  * `LEMON_SQUEEZY_API_KEY`, `LEMON_SQUEEZY_STORE_ID`, and `LEMON_SQUEEZY_MODE`
  * from `process.env`.
  *
+ * @param config - Optional overrides for key, mode, store, fetch.
+ * @returns Client with validators + nested docs-backed ops.
+ * @throws {FreshSqueezyError} When config is invalid (missing key, bad mode).
+ *
  * @example
  * ```ts
  * const lemon = createFreshSqueezy();
  * const report = await lemon.doctor();
  * if (!report.ok) process.exit(1);
+ * const product = await lemon.products.get(42);
+ * const webhook = await lemon.webhooks.create({ data: { type: "webhooks", … } });
  * ```
  */
-declare function createFreshSqueezy(config?: FreshSqueezyConfig): FreshSqueezyClient;
+declare const createFreshSqueezy: (config?: FreshSqueezyConfig) => FreshSqueezyClient;
 
 /**
  * Domain-equality primitives for fresh-squeezy.
@@ -1283,7 +1605,7 @@ declare function createFreshSqueezy(config?: FreshSqueezyConfig): FreshSqueezyCl
  * 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 function sameWebhookUrl(a: string, b: string): boolean;
+declare const sameWebhookUrl: (a: string, b: string) => boolean;
 
 /**
  * Unified error type for fresh-squeezy. All HTTP and validation failures that
@@ -1323,7 +1645,7 @@ declare const ENV_KEYS: {
  * just `apiKey`), so callers can surface a clear setup error at construction
  * time rather than at first request.
  */
-declare function resolveConfig(input?: FreshSqueezyConfig): ResolvedConfig;
+declare const resolveConfig: (input?: FreshSqueezyConfig) => ResolvedConfig;
 
 /**
  * Map the boolean `meta.test_mode` flag from `/v1/users/me` to our `Mode` type.
@@ -1339,7 +1661,7 @@ declare function resolveConfig(input?: FreshSqueezyConfig): ResolvedConfig;
  * lets `core/` stay foundational (it never reaches up into `resources/`); the
  * I/O counterpart `fetchActualMode` lives in `validate/connection.ts`.
  */
-declare function resolveActualMode(testMode: boolean | undefined): Mode | undefined;
+declare const resolveActualMode: (testMode: boolean | undefined) => Mode | undefined;
 
 /**
  * Stable issue codes. Consumers may switch on these in CI — do not rename
@@ -1385,26 +1707,26 @@ declare const ISSUE_CODES: {
  * Build a `ValidationIssue` with defaults for the common case.
  * Extracted so every validator produces consistently shaped issues.
  */
-declare function issue(code: string, severity: ValidationSeverity, message: string, extras?: {
+declare const issue: (code: string, severity: ValidationSeverity, message: string, extras?: {
     suggestedFix?: string;
     context?: ValidationIssue["context"];
-}): ValidationIssue;
+}) => ValidationIssue;
 /**
  * Fold an issue list into a boolean. Used by every validator so `ok` is
  * computed the same way everywhere.
  */
-declare function isOk(issues: ValidationIssue[]): boolean;
+declare const isOk: (issues: ValidationIssue[]) => boolean;
 /**
  * Compose a `ValidationResult` with the `ok` flag derived from issues.
  */
-declare function buildResult<T>(name: string, mode: ValidationResult["mode"], issues: ValidationIssue[], resource?: T, target?: ValidationTarget): ValidationResult<T>;
+declare const buildResult: <T>(name: string, mode: ValidationResult["mode"], issues: ValidationIssue[], resource?: T, target?: ValidationTarget) => ValidationResult<T>;
 
 /**
  * Verify a store exists and is reachable with the current API key. A 404
  * typically means the key belongs to a different account, not that the store
  * is gone — the suggested fix reflects that.
  */
-declare function validateStore(http: HttpClient, mode: Mode, storeId: string | number): Promise<ValidationResult<StoreAttributes>>;
+declare const validateStore: (http: HttpClient, mode: Mode, storeId: string | number) => Promise<ValidationResult<StoreAttributes>>;
 
 type AffiliateStatus = "active" | "pending" | "disabled";
 /**
@@ -1426,8 +1748,8 @@ interface AffiliateAttributes extends GeneratedAffiliateAttributes {
     created_at?: string;
     updated_at?: string;
 }
-declare function getAffiliate(http: HttpClient, affiliateId: string | number): Promise<JsonApiResource<AffiliateAttributes>>;
-declare function listAffiliatesForStore(http: HttpClient, storeId: string | number): Promise<JsonApiResource<AffiliateAttributes>[]>;
+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 {
@@ -1511,8 +1833,58 @@ interface CheckoutAttributes extends GeneratedCheckoutAttributes {
     updated_at?: string;
     test_mode?: boolean;
 }
-declare function getCheckout(http: HttpClient, checkoutId: string | number): Promise<JsonApiResource<CheckoutAttributes>>;
-declare function listCheckoutsForStore(http: HttpClient, storeId: string | number): Promise<JsonApiResource<CheckoutAttributes>[]>;
+/**
+ * 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 {
@@ -1542,8 +1914,73 @@ interface CustomerAttributes extends GeneratedCustomerAttributes {
     updated_at?: string;
     test_mode?: boolean;
 }
-declare function getCustomer(http: HttpClient, customerId: string | number): Promise<JsonApiResource<CustomerAttributes>>;
-declare function listCustomersForStore(http: HttpClient, storeId: string | number): Promise<JsonApiResource<CustomerAttributes>[]>;
+/**
+ * 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;
@@ -1556,8 +1993,8 @@ interface DiscountRedemptionAttributes extends GeneratedDiscountRedemptionAttrib
     created_at?: string;
     updated_at?: string;
 }
-declare function getDiscountRedemption(http: HttpClient, discountRedemptionId: string | number): Promise<JsonApiResource<DiscountRedemptionAttributes>>;
-declare function listDiscountRedemptionsForDiscount(http: HttpClient, discountId: string | number): Promise<JsonApiResource<DiscountRedemptionAttributes>[]>;
+declare const getDiscountRedemption: (http: HttpClient, discountRedemptionId: string | number) => Promise<JsonApiResource<DiscountRedemptionAttributes>>;
+declare const listDiscountRedemptionsForDiscount: (http: HttpClient, discountId: string | number) => Promise<JsonApiResource<DiscountRedemptionAttributes>[]>;
 
 /**
  * Lemon Squeezy file attributes, generated from the public object docs.
@@ -1566,8 +2003,8 @@ declare function listDiscountRedemptionsForDiscount(http: HttpClient, discountId
  */
 interface FileAttributes extends GeneratedFileAttributes {
 }
-declare function getFile(http: HttpClient, fileId: string | number): Promise<JsonApiResource<FileAttributes>>;
-declare function listFilesForVariant(http: HttpClient, variantId: string | number): Promise<JsonApiResource<FileAttributes>[]>;
+declare const getFile: (http: HttpClient, fileId: string | number) => Promise<JsonApiResource<FileAttributes>>;
+declare const listFilesForVariant: (http: HttpClient, variantId: string | number) => Promise<JsonApiResource<FileAttributes>[]>;
 
 interface LicenseKeyInstanceAttributes extends GeneratedLicenseKeyInstanceAttributes {
     license_key_id: number;
@@ -1576,8 +2013,8 @@ interface LicenseKeyInstanceAttributes extends GeneratedLicenseKeyInstanceAttrib
     created_at?: string;
     updated_at?: string;
 }
-declare function getLicenseKeyInstance(http: HttpClient, licenseKeyInstanceId: string | number): Promise<JsonApiResource<LicenseKeyInstanceAttributes>>;
-declare function listLicenseKeyInstancesForLicenseKey(http: HttpClient, licenseKeyId: string | number): Promise<JsonApiResource<LicenseKeyInstanceAttributes>[]>;
+declare const getLicenseKeyInstance: (http: HttpClient, licenseKeyInstanceId: string | number) => Promise<JsonApiResource<LicenseKeyInstanceAttributes>>;
+declare const listLicenseKeyInstancesForLicenseKey: (http: HttpClient, licenseKeyId: string | number) => Promise<JsonApiResource<LicenseKeyInstanceAttributes>[]>;
 
 /**
  * Order item attributes. `quantity` was added to the documented object in
@@ -1594,8 +2031,8 @@ interface OrderItemAttributes extends GeneratedOrderItemAttributes {
     created_at?: string;
     updated_at?: string;
 }
-declare function getOrderItem(http: HttpClient, orderItemId: string | number): Promise<JsonApiResource<OrderItemAttributes>>;
-declare function listOrderItemsForOrder(http: HttpClient, orderId: string | number): Promise<JsonApiResource<OrderItemAttributes>[]>;
+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;
@@ -1670,11 +2107,65 @@ interface OrderAttributes extends GeneratedOrderAttributes {
     test_mode?: boolean;
 }
 /**
- * Fetch a single order by ID. Provided for consumers that want typed
- * access to orders without hand-rolling the JSON:API envelope; the
- * library intentionally has no order *validator* yet.
+ * 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 function getOrder(http: HttpClient, orderId: string | number): Promise<JsonApiResource<OrderAttributes>>;
+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);
+ * ```
+ */
+declare const generateOrderInvoice: (http: HttpClient, orderId: string | number, body?: unknown) => Promise<unknown>;
 
 /**
  * Subset of Lemon Squeezy price attributes. Prices are nested under
@@ -1711,11 +2202,33 @@ interface PriceAttributes extends GeneratedPriceAttributes {
     updated_at?: string;
 }
 /**
- * Fetch a single price by ID. Provided for consumers reaching the prices
- * endpoint directly — fresh-squeezy reads price information through the
- * subscription plan validator and does not surface a price validator yet.
+ * 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 function getPrice(http: HttpClient, priceId: string | number): Promise<JsonApiResource<PriceAttributes>>;
+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);
+ * ```
+ */
+declare const listPricesForVariant: (http: HttpClient, variantId: string | number) => Promise<JsonApiResource<PriceAttributes>[]>;
 
 /**
  * URLs Lemon Squeezy attaches to a subscription so consumers can deep-link
@@ -1788,11 +2301,66 @@ interface SubscriptionAttributes extends GeneratedSubscriptionAttributes {
     tax_inclusive?: boolean;
 }
 /**
- * Fetch a single subscription by ID. Provided for consumers that want
- * typed access without hand-rolling the JSON:API envelope; the library
- * has no subscription *validator* yet.
+ * 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);
+ * ```
+ */
+declare const listSubscriptionsForStore: (http: HttpClient, storeId: string | number) => Promise<JsonApiResource<SubscriptionAttributes>[]>;
+/**
+ * Update a subscription (PATCH /v1/subscriptions/:id) — plan change, pause, etc.
+ * Docs: https://docs.lemonsqueezy.com/api/subscriptions/update-subscription
+ *
+ * @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.
+ *
+ * @example
+ * ```ts
+ * const sub = await updateSubscription(http, 1, {
+ *   data: { type: "subscriptions", id: "1", attributes: { variant_id: 2 } },
+ * });
+ * ```
+ */
+declare const updateSubscription: (http: HttpClient, subscriptionId: string | number, body: unknown) => Promise<JsonApiResource<SubscriptionAttributes>>;
+/**
+ * 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);
+ * ```
  */
-declare function getSubscription(http: HttpClient, subscriptionId: string | number): Promise<JsonApiResource<SubscriptionAttributes>>;
+declare const cancelSubscription: (http: HttpClient, subscriptionId: string | number) => Promise<JsonApiResource<SubscriptionAttributes> | undefined>;
 
 type SubscriptionInvoiceStatus = "pending" | "paid" | "void" | "refunded" | "partial_refund";
 type SubscriptionInvoiceBillingReason = "initial" | "renewal" | "updated";
@@ -1839,8 +2407,66 @@ interface SubscriptionInvoiceAttributes extends GeneratedSubscriptionInvoiceAttr
     updated_at?: string;
     test_mode?: boolean;
 }
-declare function getSubscriptionInvoice(http: HttpClient, subscriptionInvoiceId: string | number): Promise<JsonApiResource<SubscriptionInvoiceAttributes>>;
-declare function listSubscriptionInvoicesForSubscription(http: HttpClient, subscriptionId: string | number): Promise<JsonApiResource<SubscriptionInvoiceAttributes>[]>;
+/**
+ * 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;
@@ -1859,9 +2485,83 @@ interface SubscriptionItemUpdateAttributes {
     invoice_immediately?: boolean;
     disable_prorations?: boolean;
 }
-declare function getSubscriptionItem(http: HttpClient, subscriptionItemId: string | number): Promise<JsonApiResource<SubscriptionItemAttributes>>;
-declare function listSubscriptionItemsForSubscription(http: HttpClient, subscriptionId: string | number): Promise<JsonApiResource<SubscriptionItemAttributes>[]>;
-declare function buildSubscriptionItemUpdateBody(subscriptionItemId: string | number, attributes: SubscriptionItemUpdateAttributes): RequestOptions["body"];
+/**
+ * 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>>;
+/**
+ * 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);
+ * ```
+ */
+declare const getSubscriptionItemCurrentUsage: (http: HttpClient, subscriptionItemId: string | number) => Promise<unknown>;
 
 type UsageRecordAction = "increment" | "set";
 interface UsageRecordAttributes extends GeneratedUsageRecordAttributes {
@@ -1871,8 +2571,136 @@ interface UsageRecordAttributes extends GeneratedUsageRecordAttributes {
     created_at?: string;
     updated_at?: string;
 }
-declare function getUsageRecord(http: HttpClient, usageRecordId: string | number): Promise<JsonApiResource<UsageRecordAttributes>>;
-declare function listUsageRecordsForSubscriptionItem(http: HttpClient, subscriptionItemId: string | number): Promise<JsonApiResource<UsageRecordAttributes>[]>;
+/**
+ * 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" } },
+ *     },
+ *   },
+ * });
+ * ```
+ */
+declare const createUsageRecord: (http: HttpClient, body: unknown) => Promise<JsonApiResource<UsageRecordAttributes>>;
+
+/**
+ * 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";
+    /**
+     * 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";
+}
+/**
+ * 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[];
+/**
+ * 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[];
+
+/**
+ * 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>;
 
 /**
  * Support manifest: the locally reviewed source of truth for what
@@ -2015,4 +2843,4 @@ declare const ACKNOWLEDGED_CHANGELOG_ENTRIES: readonly [{
 type RecommendedEvent = (typeof RECOMMENDED_WEBHOOK_EVENTS)[number];
 type OptionalEvent = (typeof OPTIONAL_WEBHOOK_EVENTS)[number];
 
-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 DiscountRedemptionAttributes, type DiscountValidationOptions, type DoctorOptions, type DoctorReport, type DoctorValidators, ENV_KEYS, type FileAttributes, type FreshSqueezyClient, type FreshSqueezyConfig, FreshSqueezyError, 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 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 LicenseKeyInstanceAttributes, type LicenseKeyValidationOptions, type Mode, OPTIONAL_WEBHOOK_EVENTS, type OptionalEvent, type OrderAttributes, type OrderFirstItem, type OrderItemAttributes, type OrderUrls, type PriceAttributes, type ProductAttributes, type ProductValidationOptions, RECOMMENDED_WEBHOOK_EVENTS, type RecommendedEvent, type ResolvedConfig, 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, getAffiliate, getAuthenticatedUser, getCheckout, getCustomer, getDiscountRedemption, getFile, getLicenseKeyInstance, getOrder, getOrderItem, getPrice, getProduct, getStore, getSubscription, getSubscriptionInvoice, getSubscriptionItem, getUsageRecord, getVariant, isOk, issue, listAffiliatesForStore, listCheckoutsForStore, listCustomersForStore, listDiscountRedemptionsForDiscount, listFilesForVariant, listLicenseKeyInstancesForLicenseKey, listOrderItemsForOrder, listProducts, listStores, listSubscriptionInvoicesForSubscription, listSubscriptionItemsForSubscription, listUsageRecordsForSubscriptionItem, listVariantsForProduct, listWebhooksForStore, resolveActualMode, resolveConfig, sameWebhookUrl, userResource, 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, 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, listStores, listSubscriptionInvoicesForSubscription, listSubscriptionItemsForSubscription, listSubscriptionsForStore, listUsageRecordsForSubscriptionItem, listVariantsForProduct, listWebhooksForStore, refundOrder, refundSubscriptionInvoice, resolveActualMode, resolveConfig, resourceRegistry, sameWebhookUrl, updateCustomer, updateLicenseKey, updateSubscription, updateSubscriptionItem, updateWebhook, userResource, validateConnection, validateDiscount, validateLicenseKey, validateProduct, validateStore, validateSubscriptionPlan, validateWebhook };