@aimee.shop/sdk 0.0.1

package/dist/services/core/storefront/storefront-reviews.client.d.ts

@@ -0,0 +1,60 @@
+import type { HttpClientTransport as HttpClient } from '../../../core/http-client.js';
+import { type CreateReviewDto, type ReportReviewDto, type Review, type ReviewAggregates, type ReviewListResponse, type StorefrontProductReviewOptions } from '../reviews.client.js';
+/**
+ * Storefront reviews surface (PDP list/aggregates + shopper create/vote).
+ *
+ * Hits `/v1/reviews` (there is no `/v1/storefront/reviews` prefix). Guest
+ * getByProduct / getAggregates work with the publishable API key alone.
+ * create / voteHelpful / report need a customer JWT -- obtain a scoped
+ * client via `sdk.storefront.withCustomer(accessToken)`. Merchant reply is
+ * not on this client; use `sdk.reviews.reply()`.
+ *
+ * @example
+ * ```typescript
+ * const page = await sdk.storefront.reviews.getByProduct(productId, { sortBy: 'helpful' });
+ * const stats = await sdk.storefront.reviews.getAggregates(productId);
+ *
+ * const scoped = sdk.storefront.withCustomer(accessToken);
+ * await scoped.reviews.create({ productId, rating: 5, comment: 'Great product!' });
+ * await scoped.reviews.voteHelpful(reviewId);
+ * await scoped.reviews.voteHelpful(reviewId, false);
+ * await scoped.reviews.report(reviewId, { reason: 'spam' });
+ * ```
+ */
+export declare class StorefrontReviewsClient {
+    private readonly http;
+    private readonly baseUrl;
+    private readonly customerToken?;
+    constructor(http: HttpClient, baseUrl: string, customerToken?: string | undefined);
+    private get endpoint();
+    /**
+     * Per-call axios config carrying the customer JWT when bound via withCustomer.
+     * The HttpClient interceptor only adds x-api-key under API-key auth, so this
+     * Authorization header survives onto the wire.
+     */
+    private customerConfig;
+    /**
+     * Paginated reviews for a product (approved only). Guest-safe.
+     */
+    getByProduct(productId: string, options?: StorefrontProductReviewOptions): Promise<ReviewListResponse>;
+    /**
+     * Formatted rating aggregates for a product. Guest-safe.
+     */
+    getAggregates(productId: string): Promise<ReviewAggregates>;
+    /**
+     * Submit a review as the authenticated customer.
+     * Requires a customer token -- use `withCustomer(accessToken).reviews.create()`.
+     */
+    create(data: CreateReviewDto): Promise<Review>;
+    /**
+     * Vote a review helpful (default) or unhelpful (`isHelpful: false`) as the
+     * authenticated customer. Requires `withCustomer(accessToken)`.
+     */
+    voteHelpful(id: string, isHelpful?: boolean): Promise<Review>;
+    /**
+     * Report a published review for moderation as the authenticated customer.
+     * Requires `withCustomer(accessToken)`.
+     */
+    report(id: string, data?: ReportReviewDto): Promise<Review>;
+}
+//# sourceMappingURL=storefront-reviews.client.d.ts.map

package/dist/services/core/storefront/storefront-reviews.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-reviews.client.d.ts","sourceRoot":"","sources":["../../../../../../src/services/core/storefront/storefront-reviews.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,8BAA8B,EACpC,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,uBAAuB;IAEhC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAFd,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,YAAA;IAGzC,OAAO,KAAK,QAAQ,GAEnB;IAED;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACG,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,kBAAkB,CAAC;IAS9B;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOjE;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAIpD;;;OAGG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,UAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAQhE;;;OAGG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;CAGtE"}

package/dist/services/core/storefront/storefront-reviews.client.js

@@ -0,0 +1,88 @@
+import { productReviewQueryParams, } from '../reviews.client.js';
+/**
+ * Storefront reviews surface (PDP list/aggregates + shopper create/vote).
+ *
+ * Hits `/v1/reviews` (there is no `/v1/storefront/reviews` prefix). Guest
+ * getByProduct / getAggregates work with the publishable API key alone.
+ * create / voteHelpful / report need a customer JWT -- obtain a scoped
+ * client via `sdk.storefront.withCustomer(accessToken)`. Merchant reply is
+ * not on this client; use `sdk.reviews.reply()`.
+ *
+ * @example
+ * ```typescript
+ * const page = await sdk.storefront.reviews.getByProduct(productId, { sortBy: 'helpful' });
+ * const stats = await sdk.storefront.reviews.getAggregates(productId);
+ *
+ * const scoped = sdk.storefront.withCustomer(accessToken);
+ * await scoped.reviews.create({ productId, rating: 5, comment: 'Great product!' });
+ * await scoped.reviews.voteHelpful(reviewId);
+ * await scoped.reviews.voteHelpful(reviewId, false);
+ * await scoped.reviews.report(reviewId, { reason: 'spam' });
+ * ```
+ */
+export class StorefrontReviewsClient {
+    http;
+    baseUrl;
+    customerToken;
+    constructor(http, baseUrl, customerToken) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+        this.customerToken = customerToken;
+    }
+    get endpoint() {
+        return `${this.baseUrl}/v1/reviews`;
+    }
+    /**
+     * Per-call axios config carrying the customer JWT when bound via withCustomer.
+     * The HttpClient interceptor only adds x-api-key under API-key auth, so this
+     * Authorization header survives onto the wire.
+     */
+    customerConfig(params) {
+        const headers = this.customerToken
+            ? { Authorization: `Bearer ${this.customerToken}` }
+            : undefined;
+        if (!headers && !params) {
+            return undefined;
+        }
+        return {
+            ...(params ? { params } : {}),
+            ...(headers ? { headers } : {}),
+        };
+    }
+    /**
+     * Paginated reviews for a product (approved only). Guest-safe.
+     */
+    async getByProduct(productId, options = {}) {
+        const params = productReviewQueryParams(options);
+        const hasParams = Object.keys(params).length > 0;
+        return this.http.get(`${this.endpoint}/product/${productId}`, this.customerConfig(hasParams ? params : undefined));
+    }
+    /**
+     * Formatted rating aggregates for a product. Guest-safe.
+     */
+    async getAggregates(productId) {
+        return this.http.get(`${this.endpoint}/product/${productId}/aggregates`, this.customerConfig());
+    }
+    /**
+     * Submit a review as the authenticated customer.
+     * Requires a customer token -- use `withCustomer(accessToken).reviews.create()`.
+     */
+    async create(data) {
+        return this.http.post(this.endpoint, data, this.customerConfig());
+    }
+    /**
+     * Vote a review helpful (default) or unhelpful (`isHelpful: false`) as the
+     * authenticated customer. Requires `withCustomer(accessToken)`.
+     */
+    async voteHelpful(id, isHelpful = true) {
+        return this.http.post(`${this.endpoint}/${id}/helpful`, { isHelpful }, this.customerConfig());
+    }
+    /**
+     * Report a published review for moderation as the authenticated customer.
+     * Requires `withCustomer(accessToken)`.
+     */
+    async report(id, data = {}) {
+        return this.http.post(`${this.endpoint}/${id}/report`, data, this.customerConfig());
+    }
+}
+//# sourceMappingURL=storefront-reviews.client.js.map

package/dist/services/core/storefront/storefront-reviews.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-reviews.client.js","sourceRoot":"","sources":["../../../../../../src/services/core/storefront/storefront-reviews.client.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,GAOzB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,uBAAuB;IAEf;IACA;IACA;IAHnB,YACmB,IAAgB,EAChB,OAAe,EACf,aAAsB;QAFtB,SAAI,GAAJ,IAAI,CAAY;QAChB,YAAO,GAAP,OAAO,CAAQ;QACf,kBAAa,GAAb,aAAa,CAAS;IACtC,CAAC;IAEJ,IAAY,QAAQ;QAClB,OAAO,GAAG,IAAI,CAAC,OAAO,aAAa,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACK,cAAc,CAAC,MAA+B;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa;YAChC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,aAAa,EAAE,EAAE;YACnD,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;YACxB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO;YACL,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAChB,SAAiB,EACjB,UAA0C,EAAE;QAE5C,MAAM,MAAM,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,GAAG,IAAI,CAAC,QAAQ,YAAY,SAAS,EAAE,EACvC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CACpD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,GAAG,IAAI,CAAC,QAAQ,YAAY,SAAS,aAAa,EAClD,IAAI,CAAC,cAAc,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,IAAqB;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAS,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,EAAU,EAAE,SAAS,GAAG,IAAI;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,UAAU,EAChC,EAAE,SAAS,EAAE,EACb,IAAI,CAAC,cAAc,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,OAAwB,EAAE;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAS,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;IAC9F,CAAC;CACF"}

package/dist/services/core/storefront/storefront-subscriptions.client.d.ts

@@ -0,0 +1,199 @@
+import type { HttpClientTransport as HttpClient } from '../../../core/http-client.js';
+import type { AddressSnapshot } from '../../../core/types/address.js';
+import type { StorefrontBillingInterval } from './types.js';
+export type StorefrontSubscriptionStatus = 'trialing' | 'active' | 'past_due' | 'cancelled' | 'expired' | 'paused' | 'incomplete' | 'incomplete_expired' | 'requires_action';
+/**
+ * Shopper-visible subscription. Admin engine/provider fields are omitted.
+ * Matches the core-api storefront hop DTO (customerId is the authenticated shopper).
+ */
+export interface StorefrontSubscription {
+    id: string;
+    storeId: string;
+    customerId: string;
+    planId: string;
+    status: StorefrontSubscriptionStatus;
+    currentPeriodStart: string;
+    currentPeriodEnd: string;
+    nextBillingDate: string;
+    cancelAt?: string | null;
+    cancelledAt?: string | null;
+    cancelAtPeriodEnd: boolean;
+    trialStart?: string | null;
+    trialEnd?: string | null;
+    paymentMethodId?: string | null;
+    billingInterval: StorefrontBillingInterval;
+    billingIntervalCount: number;
+    amount: number;
+    currency: string;
+    shippingAddress: AddressSnapshot | null;
+    failedPaymentAttempts: number;
+    lastPaymentAttempt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    /** Present on change-cadence responses when proration applies (cents). */
+    prorationAmount?: number;
+    /** Present on cancel responses when a refund is issued (cents). */
+    refundAmount?: number;
+}
+export interface StorefrontSubscriptionPagination {
+    page: number;
+    limit: number;
+    total: number;
+    pages: number;
+}
+export interface StorefrontSubscriptionListResponse {
+    data: StorefrontSubscription[];
+    pagination: StorefrontSubscriptionPagination;
+}
+export interface StorefrontSubscriptionListOptions {
+    status?: StorefrontSubscriptionStatus;
+    page?: number;
+    limit?: number;
+    sortBy?: 'createdAt' | 'updatedAt' | 'nextBillingDate' | 'status';
+    sortOrder?: 'asc' | 'desc';
+}
+export interface CancelStorefrontSubscriptionDto {
+    cancelImmediately?: boolean;
+    reason?: string;
+}
+export interface PauseStorefrontSubscriptionDto {
+    resumeDate?: string;
+}
+export interface ChangeStorefrontCadenceDto {
+    /** Target plan ID (must belong to the same store) */
+    planId: string;
+    /** Apply proration immediately (true, default) or at next renewal (false) */
+    prorate?: boolean;
+}
+export interface PreviewStorefrontInvoiceDto {
+    /** Preview a hypothetical plan change. Omit for next-cycle preview. */
+    newPlanId?: string;
+    /** Apply proration when previewing a plan change (default true) */
+    prorate?: boolean;
+}
+export type StorefrontPreviewInvoiceFor = 'next_cycle' | 'plan_change';
+export interface StorefrontPreviewInvoiceLineItem {
+    description: string;
+    /** Amount in cents (can be negative for credits) */
+    amount: number;
+    proration: boolean;
+    periodStart?: string;
+    periodEnd?: string;
+}
+export interface StorefrontPreviewInvoiceResponse {
+    subscriptionId: string;
+    previewFor: StorefrontPreviewInvoiceFor;
+    currency: string;
+    subtotal: number;
+    total: number;
+    proratedAmount: number;
+    lineItems: StorefrontPreviewInvoiceLineItem[];
+    periodStart: string;
+    periodEnd: string;
+}
+export interface UpdateStorefrontSubscriptionPaymentMethodDto {
+    /** Vault payment method UUID from /v1/storefront/payment-methods -- not a raw PSP token */
+    paymentMethodId: string;
+}
+export interface StorefrontPaymentAuthenticationDetails {
+    subscriptionId: string;
+    paymentId: string;
+    clientSecret: string;
+    amount: number;
+    currency: string;
+}
+export interface UpdateStorefrontSubscriptionAddressDto {
+    shippingAddress: AddressSnapshot;
+}
+/**
+ * Customer-scoped storefront subscriptions.
+ *
+ * All lifecycle methods require a customer JWT in addition to the storefront API key.
+ * Obtain a scoped client via `sdk.storefront.withCustomer(accessToken)`.
+ * Ownership is enforced server-side from the verified JWT; non-owned subscriptions
+ * return 404. Do not pass customerId.
+ *
+ * Payment-method updates take a vault UUID from core-api `/v1/storefront/payment-methods`
+ * (provider SDK collects the card; this client does not vault).
+ *
+ * @example
+ * ```typescript
+ * const scoped = sdk.storefront.withCustomer(accessToken);
+ * const page = await scoped.subscriptions.list({ page: 1, limit: 10 });
+ * const sub = await scoped.subscriptions.get(subscriptionId);
+ * await scoped.subscriptions.pause(subscriptionId);
+ * await scoped.subscriptions.changeCadence(subscriptionId, { planId: annualPlanId });
+ * await scoped.subscriptions.updatePaymentMethod(subscriptionId, {
+ *   paymentMethodId: vaultedMethodId,
+ * });
+ * ```
+ */
+export declare class StorefrontSubscriptionsClient {
+    private readonly http;
+    private readonly baseUrl;
+    private readonly customerToken?;
+    constructor(http: HttpClient, baseUrl: string, customerToken?: string | undefined);
+    private get endpoint();
+    /**
+     * Per-call axios config carrying the customer JWT for customer-scoped endpoints.
+     * The HttpClient interceptor only adds x-api-key under API-key auth, so this
+     * Authorization header survives onto the wire.
+     */
+    private customerConfig;
+    /**
+     * List the authenticated customer's subscriptions (newest first).
+     * Requires a customer token -- use `withCustomer(accessToken).subscriptions.list()`.
+     */
+    list(options?: StorefrontSubscriptionListOptions): Promise<StorefrontSubscriptionListResponse>;
+    /**
+     * Get one of the authenticated customer's subscriptions by ID.
+     * Non-owned or missing subscriptions return 404.
+     */
+    get(id: string): Promise<StorefrontSubscription>;
+    /**
+     * Cancel a subscription. Default: cancel at period end.
+     * Pass `cancelImmediately: true` to cancel now.
+     */
+    cancel(id: string, data?: CancelStorefrontSubscriptionDto): Promise<StorefrontSubscription>;
+    /**
+     * Pause a subscription. Optionally schedule a resume date.
+     */
+    pause(id: string, data?: PauseStorefrontSubscriptionDto): Promise<StorefrontSubscription>;
+    /**
+     * Resume a paused subscription.
+     */
+    resume(id: string): Promise<StorefrontSubscription>;
+    /**
+     * Skip the next billing cycle: advances the next billing date one plan
+     * interval without charging. Active subscriptions only -- 409 when paused,
+     * cancelled, past_due, scheduled to cancel, or provider-engine.
+     */
+    skip(id: string): Promise<StorefrontSubscription>;
+    /**
+     * Undo a scheduled cancel. Succeeds only when cancelAt is set and cancelledAt is not.
+     */
+    reactivate(id: string): Promise<StorefrontSubscription>;
+    /**
+     * Switch the subscription to a different plan in the same store (cadence change).
+     */
+    changeCadence(id: string, data: ChangeStorefrontCadenceDto): Promise<StorefrontSubscription>;
+    /**
+     * Compute the next invoice (or a hypothetical plan-change invoice) without applying changes.
+     */
+    previewInvoice(id: string, data?: PreviewStorefrontInvoiceDto): Promise<StorefrontPreviewInvoiceResponse>;
+    /**
+     * Update the payment method used for recurring charges.
+     * `paymentMethodId` must be a vault UUID from `/v1/storefront/payment-methods`.
+     */
+    updatePaymentMethod(id: string, data: UpdateStorefrontSubscriptionPaymentMethodDto): Promise<StorefrontSubscription>;
+    /**
+     * Fetch 3DS/SCA authentication details for a subscription in `requires_action`.
+     * Use `clientSecret` with the provider SDK (Stripe.js confirmCardPayment).
+     */
+    getPaymentAuthenticationDetails(id: string): Promise<StorefrontPaymentAuthenticationDetails>;
+    /**
+     * Replace the shipping address snapshot used for renewal tax/shipping.
+     */
+    updateAddress(id: string, data: UpdateStorefrontSubscriptionAddressDto): Promise<StorefrontSubscription>;
+}
+//# sourceMappingURL=storefront-subscriptions.client.d.ts.map

package/dist/services/core/storefront/storefront-subscriptions.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-subscriptions.client.d.ts","sourceRoot":"","sources":["../../../../../../src/services/core/storefront/storefront-subscriptions.client.ts"],"names":[],"mappings":"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"}

package/dist/services/core/storefront/storefront-subscriptions.client.js

@@ -0,0 +1,149 @@
+/**
+ * Customer-scoped storefront subscriptions.
+ *
+ * All lifecycle methods require a customer JWT in addition to the storefront API key.
+ * Obtain a scoped client via `sdk.storefront.withCustomer(accessToken)`.
+ * Ownership is enforced server-side from the verified JWT; non-owned subscriptions
+ * return 404. Do not pass customerId.
+ *
+ * Payment-method updates take a vault UUID from core-api `/v1/storefront/payment-methods`
+ * (provider SDK collects the card; this client does not vault).
+ *
+ * @example
+ * ```typescript
+ * const scoped = sdk.storefront.withCustomer(accessToken);
+ * const page = await scoped.subscriptions.list({ page: 1, limit: 10 });
+ * const sub = await scoped.subscriptions.get(subscriptionId);
+ * await scoped.subscriptions.pause(subscriptionId);
+ * await scoped.subscriptions.changeCadence(subscriptionId, { planId: annualPlanId });
+ * await scoped.subscriptions.updatePaymentMethod(subscriptionId, {
+ *   paymentMethodId: vaultedMethodId,
+ * });
+ * ```
+ */
+export class StorefrontSubscriptionsClient {
+    http;
+    baseUrl;
+    customerToken;
+    constructor(http, baseUrl, customerToken) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+        this.customerToken = customerToken;
+    }
+    get endpoint() {
+        return `${this.baseUrl}/v1/storefront/subscriptions`;
+    }
+    /**
+     * Per-call axios config carrying the customer JWT for customer-scoped endpoints.
+     * The HttpClient interceptor only adds x-api-key under API-key auth, so this
+     * Authorization header survives onto the wire.
+     */
+    customerConfig(params) {
+        const headers = this.customerToken
+            ? { Authorization: `Bearer ${this.customerToken}` }
+            : undefined;
+        if (!headers && !params) {
+            return undefined;
+        }
+        return {
+            ...(params ? { params } : {}),
+            ...(headers ? { headers } : {}),
+        };
+    }
+    /**
+     * List the authenticated customer's subscriptions (newest first).
+     * Requires a customer token -- use `withCustomer(accessToken).subscriptions.list()`.
+     */
+    async list(options = {}) {
+        const params = {};
+        if (options.status !== undefined) {
+            params.status = options.status;
+        }
+        if (options.page !== undefined) {
+            params.page = options.page;
+        }
+        if (options.limit !== undefined) {
+            params.limit = options.limit;
+        }
+        if (options.sortBy !== undefined) {
+            params.sortBy = options.sortBy;
+        }
+        if (options.sortOrder !== undefined) {
+            params.sortOrder = options.sortOrder;
+        }
+        return this.http.get(this.endpoint, this.customerConfig(Object.keys(params).length > 0 ? params : undefined));
+    }
+    /**
+     * Get one of the authenticated customer's subscriptions by ID.
+     * Non-owned or missing subscriptions return 404.
+     */
+    async get(id) {
+        return this.http.get(`${this.endpoint}/${id}`, this.customerConfig());
+    }
+    /**
+     * Cancel a subscription. Default: cancel at period end.
+     * Pass `cancelImmediately: true` to cancel now.
+     */
+    async cancel(id, data = {}) {
+        return this.http.post(`${this.endpoint}/${id}/cancel`, data, this.customerConfig());
+    }
+    /**
+     * Pause a subscription. Optionally schedule a resume date.
+     */
+    async pause(id, data = {}) {
+        return this.http.post(`${this.endpoint}/${id}/pause`, data, this.customerConfig());
+    }
+    /**
+     * Resume a paused subscription.
+     */
+    async resume(id) {
+        return this.http.post(`${this.endpoint}/${id}/resume`, {}, this.customerConfig());
+    }
+    /**
+     * Skip the next billing cycle: advances the next billing date one plan
+     * interval without charging. Active subscriptions only -- 409 when paused,
+     * cancelled, past_due, scheduled to cancel, or provider-engine.
+     */
+    async skip(id) {
+        return this.http.post(`${this.endpoint}/${id}/skip`, {}, this.customerConfig());
+    }
+    /**
+     * Undo a scheduled cancel. Succeeds only when cancelAt is set and cancelledAt is not.
+     */
+    async reactivate(id) {
+        return this.http.post(`${this.endpoint}/${id}/reactivate`, {}, this.customerConfig());
+    }
+    /**
+     * Switch the subscription to a different plan in the same store (cadence change).
+     */
+    async changeCadence(id, data) {
+        return this.http.post(`${this.endpoint}/${id}/change-plan`, data, this.customerConfig());
+    }
+    /**
+     * Compute the next invoice (or a hypothetical plan-change invoice) without applying changes.
+     */
+    async previewInvoice(id, data = {}) {
+        return this.http.post(`${this.endpoint}/${id}/preview-invoice`, data, this.customerConfig());
+    }
+    /**
+     * Update the payment method used for recurring charges.
+     * `paymentMethodId` must be a vault UUID from `/v1/storefront/payment-methods`.
+     */
+    async updatePaymentMethod(id, data) {
+        return this.http.patch(`${this.endpoint}/${id}/payment-method`, data, this.customerConfig());
+    }
+    /**
+     * Fetch 3DS/SCA authentication details for a subscription in `requires_action`.
+     * Use `clientSecret` with the provider SDK (Stripe.js confirmCardPayment).
+     */
+    async getPaymentAuthenticationDetails(id) {
+        return this.http.get(`${this.endpoint}/${id}/authenticate-payment`, this.customerConfig());
+    }
+    /**
+     * Replace the shipping address snapshot used for renewal tax/shipping.
+     */
+    async updateAddress(id, data) {
+        return this.http.patch(`${this.endpoint}/${id}`, data, this.customerConfig());
+    }
+}
+//# sourceMappingURL=storefront-subscriptions.client.js.map

package/dist/services/core/storefront/storefront-subscriptions.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-subscriptions.client.js","sourceRoot":"","sources":["../../../../../../src/services/core/storefront/storefront-subscriptions.client.ts"],"names":[],"mappings":"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"}