@proxy-checkout/server-js 0.0.4-pr-76.31.1 → 0.0.4-pr-76.33.1

package/dist/cjs/cart.d.cts

@@ -0,0 +1,17 @@
+/**
+ * Typed cart-snapshot validation.
+ *
+ * The cart snapshot is merchant-defined and opaque to Proxy, so the SDK keeps
+ * the shape app-owned but standardizes the parse step: pass a zod-style schema
+ * (or a plain validator function) and get a typed cart or a structured error.
+ */
+/** A zod-style schema (`{ parse }`) or a plain validator function. */
+export type ProxyCartValidator<TCart> = {
+    parse: (value: unknown) => TCart;
+} | ((value: unknown) => TCart);
+/** Run a cart snapshot through a validator, wrapping failures in a structured SDK error. */
+export declare function parseProxyCart<TCart>(cartSnapshot: unknown, validator: ProxyCartValidator<TCart>): TCart;
+/** Optional extraction of a buyer reference embedded in the typed cart, for consistency checks. */
+export interface ProxyCartParseOptions<TCart> {
+    readonly getBuyerReference?: (cart: TCart) => string | null | undefined;
+}

package/dist/cjs/cart.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Typed cart-snapshot validation.
+ *
+ * The cart snapshot is merchant-defined and opaque to Proxy, so the SDK keeps
+ * the shape app-owned but standardizes the parse step: pass a zod-style schema
+ * (or a plain validator function) and get a typed cart or a structured error.
+ */
+/** A zod-style schema (`{ parse }`) or a plain validator function. */
+export type ProxyCartValidator<TCart> = {
+    parse: (value: unknown) => TCart;
+} | ((value: unknown) => TCart);
+/** Run a cart snapshot through a validator, wrapping failures in a structured SDK error. */
+export declare function parseProxyCart<TCart>(cartSnapshot: unknown, validator: ProxyCartValidator<TCart>): TCart;
+/** Optional extraction of a buyer reference embedded in the typed cart, for consistency checks. */
+export interface ProxyCartParseOptions<TCart> {
+    readonly getBuyerReference?: (cart: TCart) => string | null | undefined;
+}

package/dist/cjs/client.d.cts

@@ -0,0 +1,19 @@
+import { ProxyEventsResource } from "./events.js";
+import { ProxySessionsResource } from "./sessions.js";
+import { ProxySubscriptionsResource } from "./subscriptions.js";
+import type { ProxyCheckoutServerClientOptions } from "./types.js";
+import { ProxyWebhooksResource } from "./webhook-handler.js";
+import { ProxyWebhookEndpointsResource } from "./webhooks.js";
+export declare class ProxyCheckoutServerClient {
+    readonly apiHost: string;
+    readonly sessions: ProxySessionsResource;
+    readonly subscriptions: ProxySubscriptionsResource;
+    /** Current-state lifecycle resolver for signed webhook events. */
+    readonly events: ProxyEventsResource;
+    /** Webhook delivery handling: `handle`, `process`, `constructEvent`. */
+    readonly webhooks: ProxyWebhooksResource;
+    /** Webhook endpoint management API (create/list/rotate). */
+    readonly webhookEndpoints: ProxyWebhookEndpointsResource;
+    constructor(options: ProxyCheckoutServerClientOptions);
+}
+export declare function createProxyCheckoutServerClient(options: ProxyCheckoutServerClientOptions): ProxyCheckoutServerClient;

package/dist/cjs/client.d.ts

@@ -0,0 +1,19 @@
+import { ProxyEventsResource } from "./events.js";
+import { ProxySessionsResource } from "./sessions.js";
+import { ProxySubscriptionsResource } from "./subscriptions.js";
+import type { ProxyCheckoutServerClientOptions } from "./types.js";
+import { ProxyWebhooksResource } from "./webhook-handler.js";
+import { ProxyWebhookEndpointsResource } from "./webhooks.js";
+export declare class ProxyCheckoutServerClient {
+    readonly apiHost: string;
+    readonly sessions: ProxySessionsResource;
+    readonly subscriptions: ProxySubscriptionsResource;
+    /** Current-state lifecycle resolver for signed webhook events. */
+    readonly events: ProxyEventsResource;
+    /** Webhook delivery handling: `handle`, `process`, `constructEvent`. */
+    readonly webhooks: ProxyWebhooksResource;
+    /** Webhook endpoint management API (create/list/rotate). */
+    readonly webhookEndpoints: ProxyWebhookEndpointsResource;
+    constructor(options: ProxyCheckoutServerClientOptions);
+}
+export declare function createProxyCheckoutServerClient(options: ProxyCheckoutServerClientOptions): ProxyCheckoutServerClient;

package/dist/cjs/consistency.d.cts

@@ -0,0 +1,20 @@
+/**
+ * Buyer-reference and session linkage consistency checks.
+ *
+ * Proxy current-state retrieval is the source of truth, but the SDK still
+ * guards that the records it stitches together actually belong to the same
+ * buyer and session before a merchant acts on them.
+ */
+import type { MerchantProxySession } from "./sessions.js";
+import type { MerchantProxySubscription } from "./subscriptions.js";
+/**
+ * Assert that a subscription belongs to the given original session and that the
+ * buyer references agree. Throws {@link ProxyCheckoutValidationError} otherwise.
+ */
+export declare function assertSubscriptionMatchesSession(subscription: Pick<MerchantProxySubscription, "buyerReference" | "id" | "originalProxySessionId">, session: Pick<MerchantProxySession, "buyerReference" | "id">): void;
+/**
+ * Assert that a cart-embedded buyer reference, when present, matches the session
+ * buyer reference. A `null`/`undefined` cart buyer reference is allowed (the
+ * cart simply does not carry one).
+ */
+export declare function assertCartBuyerReference(cartBuyerReference: string | null | undefined, session: Pick<MerchantProxySession, "buyerReference" | "id">): void;

package/dist/cjs/consistency.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Buyer-reference and session linkage consistency checks.
+ *
+ * Proxy current-state retrieval is the source of truth, but the SDK still
+ * guards that the records it stitches together actually belong to the same
+ * buyer and session before a merchant acts on them.
+ */
+import type { MerchantProxySession } from "./sessions.js";
+import type { MerchantProxySubscription } from "./subscriptions.js";
+/**
+ * Assert that a subscription belongs to the given original session and that the
+ * buyer references agree. Throws {@link ProxyCheckoutValidationError} otherwise.
+ */
+export declare function assertSubscriptionMatchesSession(subscription: Pick<MerchantProxySubscription, "buyerReference" | "id" | "originalProxySessionId">, session: Pick<MerchantProxySession, "buyerReference" | "id">): void;
+/**
+ * Assert that a cart-embedded buyer reference, when present, matches the session
+ * buyer reference. A `null`/`undefined` cart buyer reference is allowed (the
+ * cart simply does not carry one).
+ */
+export declare function assertCartBuyerReference(cartBuyerReference: string | null | undefined, session: Pick<MerchantProxySession, "buyerReference" | "id">): void;

package/dist/cjs/errors.d.cts

@@ -0,0 +1,32 @@
+export interface ProxyCheckoutApiErrorDetails {
+    readonly code?: string;
+    readonly requestId?: string;
+    readonly responseBody: unknown;
+    readonly statusCode: number;
+}
+export type ProxyCheckoutValidationCode = "buyer_reference_mismatch" | "cart_invalid" | "invalid_date" | "provider_binding_mismatch" | "subscription_session_mismatch";
+/**
+ * Raised when the SDK receives Proxy data it cannot safely normalize, for
+ * example an invalid date string, a cart snapshot that fails the merchant
+ * schema, or a buyer-reference / provider-binding consistency violation.
+ */
+export declare class ProxyCheckoutValidationError extends Error {
+    readonly name = "ProxyCheckoutValidationError";
+    readonly code: ProxyCheckoutValidationCode;
+    readonly field: string | undefined;
+    readonly cause: unknown;
+    constructor(message: string, details: {
+        code: ProxyCheckoutValidationCode;
+        field?: string;
+        cause?: unknown;
+    });
+}
+export declare class ProxyCheckoutApiError extends Error {
+    readonly name = "ProxyCheckoutApiError";
+    readonly code: string | undefined;
+    readonly requestId: string | undefined;
+    readonly responseBody: unknown;
+    readonly statusCode: number;
+    constructor(message: string, details: ProxyCheckoutApiErrorDetails);
+}
+export declare function toApiError(statusCode: number, responseBody: unknown, headerRequestId?: string): ProxyCheckoutApiError;

package/dist/cjs/errors.d.ts

@@ -0,0 +1,32 @@
+export interface ProxyCheckoutApiErrorDetails {
+    readonly code?: string;
+    readonly requestId?: string;
+    readonly responseBody: unknown;
+    readonly statusCode: number;
+}
+export type ProxyCheckoutValidationCode = "buyer_reference_mismatch" | "cart_invalid" | "invalid_date" | "provider_binding_mismatch" | "subscription_session_mismatch";
+/**
+ * Raised when the SDK receives Proxy data it cannot safely normalize, for
+ * example an invalid date string, a cart snapshot that fails the merchant
+ * schema, or a buyer-reference / provider-binding consistency violation.
+ */
+export declare class ProxyCheckoutValidationError extends Error {
+    readonly name = "ProxyCheckoutValidationError";
+    readonly code: ProxyCheckoutValidationCode;
+    readonly field: string | undefined;
+    readonly cause: unknown;
+    constructor(message: string, details: {
+        code: ProxyCheckoutValidationCode;
+        field?: string;
+        cause?: unknown;
+    });
+}
+export declare class ProxyCheckoutApiError extends Error {
+    readonly name = "ProxyCheckoutApiError";
+    readonly code: string | undefined;
+    readonly requestId: string | undefined;
+    readonly responseBody: unknown;
+    readonly statusCode: number;
+    constructor(message: string, details: ProxyCheckoutApiErrorDetails);
+}
+export declare function toApiError(statusCode: number, responseBody: unknown, headerRequestId?: string): ProxyCheckoutApiError;

package/dist/cjs/events.d.cts

@@ -0,0 +1,89 @@
+/**
+ * Current-state lifecycle resolver for signed Proxy webhook events.
+ *
+ * A webhook is only a wakeup: this resolver re-reads the authoritative session
+ * and subscription state with the merchant secret key and returns a typed
+ * lifecycle decision. It never grants from webhook payload fields, and it
+ * classifies subscription events from current state rather than event order.
+ */
+import type { MerchantProxySession, ProxySessionsResource } from "./sessions.js";
+import type { MerchantProxySubscription, ProxySubscriptionsResource } from "./subscriptions.js";
+import type { ProxyCheckoutServerRequestOptions } from "./types.js";
+import type { ProxyWebhookEvent } from "./webhooks.js";
+export interface ResolveProxyEventOptions extends ProxyCheckoutServerRequestOptions {
+}
+interface ResolvedBase {
+    readonly event: ProxyWebhookEvent;
+}
+/**
+ * First paid/provisionable wakeup for a session. `subscription` is present when
+ * the event carried a subscription id; otherwise the merchant computes initial
+ * access from its own cart policy (`accessEndsAt`/`willRenew` are then null).
+ */
+export interface ResolvedInitialProvision extends ResolvedBase {
+    readonly accessEndsAt: Date | null;
+    readonly kind: "initial_provision";
+    readonly session: MerchantProxySession;
+    readonly subscription: MerchantProxySubscription | null;
+    readonly willRenew: boolean | null;
+}
+export interface ResolvedSubscriptionRenewed extends ResolvedBase {
+    readonly accessEndsAt: Date | null;
+    readonly kind: "subscription_renewed";
+    readonly session: MerchantProxySession;
+    readonly subscription: MerchantProxySubscription;
+    readonly willRenew: boolean;
+}
+export interface ResolvedSubscriptionCancelScheduled extends ResolvedBase {
+    readonly accessEndsAt: Date | null;
+    readonly kind: "subscription_cancel_scheduled";
+    readonly session: MerchantProxySession;
+    readonly subscription: MerchantProxySubscription;
+    readonly willRenew: false;
+}
+export interface ResolvedSubscriptionCancelled extends ResolvedBase {
+    readonly accessEndsAt: Date | null;
+    readonly kind: "subscription_cancelled";
+    readonly session: MerchantProxySession;
+    readonly subscription: MerchantProxySubscription;
+    readonly willRenew: false;
+}
+export interface ResolvedPaymentRisk extends ResolvedBase {
+    readonly accessEndsAt: Date | null;
+    readonly kind: "payment_risk";
+    readonly latestPaymentStatus: string | null;
+    readonly session: MerchantProxySession;
+    readonly subscription: MerchantProxySubscription;
+    readonly willRenew: boolean;
+}
+export interface ResolvedTerminalSession extends ResolvedBase {
+    readonly kind: "terminal_session";
+    readonly session: MerchantProxySession;
+}
+export interface ResolvedPaymentAttempt extends ResolvedBase {
+    readonly kind: "payment_attempt";
+    readonly paymentAttemptId: string | null;
+    readonly sessionId: string | null;
+    readonly subscriptionId: string | null;
+}
+export interface ResolvedIgnored extends ResolvedBase {
+    readonly kind: "ignored";
+    readonly reason: string;
+    readonly sessionId: string | null;
+    readonly subscriptionId: string | null;
+}
+export type ResolvedProxyEvent = ResolvedInitialProvision | ResolvedSubscriptionRenewed | ResolvedSubscriptionCancelScheduled | ResolvedSubscriptionCancelled | ResolvedPaymentRisk | ResolvedTerminalSession | ResolvedPaymentAttempt | ResolvedIgnored;
+export type ResolvedProxyEventKind = ResolvedProxyEvent["kind"];
+export declare class ProxyEventsResource {
+    private readonly sessions;
+    private readonly subscriptions;
+    constructor(sessions: ProxySessionsResource, subscriptions: ProxySubscriptionsResource);
+    /**
+     * Resolve a signed webhook event into a current-state lifecycle decision by
+     * re-reading the authoritative session/subscription with the secret key.
+     */
+    resolveCurrentState(event: ProxyWebhookEvent, options?: ResolveProxyEventOptions): Promise<ResolvedProxyEvent>;
+    private resolveSessionEvent;
+    private resolveSubscriptionEvent;
+}
+export {};

package/dist/cjs/events.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Current-state lifecycle resolver for signed Proxy webhook events.
+ *
+ * A webhook is only a wakeup: this resolver re-reads the authoritative session
+ * and subscription state with the merchant secret key and returns a typed
+ * lifecycle decision. It never grants from webhook payload fields, and it
+ * classifies subscription events from current state rather than event order.
+ */
+import type { MerchantProxySession, ProxySessionsResource } from "./sessions.js";
+import type { MerchantProxySubscription, ProxySubscriptionsResource } from "./subscriptions.js";
+import type { ProxyCheckoutServerRequestOptions } from "./types.js";
+import type { ProxyWebhookEvent } from "./webhooks.js";
+export interface ResolveProxyEventOptions extends ProxyCheckoutServerRequestOptions {
+}
+interface ResolvedBase {
+    readonly event: ProxyWebhookEvent;
+}
+/**
+ * First paid/provisionable wakeup for a session. `subscription` is present when
+ * the event carried a subscription id; otherwise the merchant computes initial
+ * access from its own cart policy (`accessEndsAt`/`willRenew` are then null).
+ */
+export interface ResolvedInitialProvision extends ResolvedBase {
+    readonly accessEndsAt: Date | null;
+    readonly kind: "initial_provision";
+    readonly session: MerchantProxySession;
+    readonly subscription: MerchantProxySubscription | null;
+    readonly willRenew: boolean | null;
+}
+export interface ResolvedSubscriptionRenewed extends ResolvedBase {
+    readonly accessEndsAt: Date | null;
+    readonly kind: "subscription_renewed";
+    readonly session: MerchantProxySession;
+    readonly subscription: MerchantProxySubscription;
+    readonly willRenew: boolean;
+}
+export interface ResolvedSubscriptionCancelScheduled extends ResolvedBase {
+    readonly accessEndsAt: Date | null;
+    readonly kind: "subscription_cancel_scheduled";
+    readonly session: MerchantProxySession;
+    readonly subscription: MerchantProxySubscription;
+    readonly willRenew: false;
+}
+export interface ResolvedSubscriptionCancelled extends ResolvedBase {
+    readonly accessEndsAt: Date | null;
+    readonly kind: "subscription_cancelled";
+    readonly session: MerchantProxySession;
+    readonly subscription: MerchantProxySubscription;
+    readonly willRenew: false;
+}
+export interface ResolvedPaymentRisk extends ResolvedBase {
+    readonly accessEndsAt: Date | null;
+    readonly kind: "payment_risk";
+    readonly latestPaymentStatus: string | null;
+    readonly session: MerchantProxySession;
+    readonly subscription: MerchantProxySubscription;
+    readonly willRenew: boolean;
+}
+export interface ResolvedTerminalSession extends ResolvedBase {
+    readonly kind: "terminal_session";
+    readonly session: MerchantProxySession;
+}
+export interface ResolvedPaymentAttempt extends ResolvedBase {
+    readonly kind: "payment_attempt";
+    readonly paymentAttemptId: string | null;
+    readonly sessionId: string | null;
+    readonly subscriptionId: string | null;
+}
+export interface ResolvedIgnored extends ResolvedBase {
+    readonly kind: "ignored";
+    readonly reason: string;
+    readonly sessionId: string | null;
+    readonly subscriptionId: string | null;
+}
+export type ResolvedProxyEvent = ResolvedInitialProvision | ResolvedSubscriptionRenewed | ResolvedSubscriptionCancelScheduled | ResolvedSubscriptionCancelled | ResolvedPaymentRisk | ResolvedTerminalSession | ResolvedPaymentAttempt | ResolvedIgnored;
+export type ResolvedProxyEventKind = ResolvedProxyEvent["kind"];
+export declare class ProxyEventsResource {
+    private readonly sessions;
+    private readonly subscriptions;
+    constructor(sessions: ProxySessionsResource, subscriptions: ProxySubscriptionsResource);
+    /**
+     * Resolve a signed webhook event into a current-state lifecycle decision by
+     * re-reading the authoritative session/subscription with the secret key.
+     */
+    resolveCurrentState(event: ProxyWebhookEvent, options?: ResolveProxyEventOptions): Promise<ResolvedProxyEvent>;
+    private resolveSessionEvent;
+    private resolveSubscriptionEvent;
+}
+export {};

package/dist/cjs/http-client.d.cts

@@ -0,0 +1,16 @@
+import type { JsonValue, ProxyCheckoutFetch } from "./types.js";
+export interface ProxyCheckoutRequestOptions {
+    readonly idempotencyKey?: string;
+    readonly requestId?: string;
+}
+export declare class ProxyCheckoutHttpClient {
+    readonly apiHost: string;
+    private readonly apiKey;
+    private readonly fetchImpl;
+    constructor({ apiHost, apiKey, fetchImpl, }: {
+        apiHost?: string;
+        apiKey: string;
+        fetchImpl?: ProxyCheckoutFetch;
+    });
+    request(method: "GET" | "PATCH" | "POST" | "PUT", path: string, body?: JsonValue, options?: ProxyCheckoutRequestOptions): Promise<unknown>;
+}

package/dist/cjs/http-client.d.ts

@@ -0,0 +1,16 @@
+import type { JsonValue, ProxyCheckoutFetch } from "./types.js";
+export interface ProxyCheckoutRequestOptions {
+    readonly idempotencyKey?: string;
+    readonly requestId?: string;
+}
+export declare class ProxyCheckoutHttpClient {
+    readonly apiHost: string;
+    private readonly apiKey;
+    private readonly fetchImpl;
+    constructor({ apiHost, apiKey, fetchImpl, }: {
+        apiHost?: string;
+        apiKey: string;
+        fetchImpl?: ProxyCheckoutFetch;
+    });
+    request(method: "GET" | "PATCH" | "POST" | "PUT", path: string, body?: JsonValue, options?: ProxyCheckoutRequestOptions): Promise<unknown>;
+}

package/dist/cjs/index.d.cts

@@ -0,0 +1,13 @@
+export { type ProxyCartParseOptions, type ProxyCartValidator, parseProxyCart, } from "./cart.js";
+export { createProxyCheckoutServerClient, ProxyCheckoutServerClient, } from "./client.js";
+export { assertCartBuyerReference, assertSubscriptionMatchesSession, } from "./consistency.js";
+export { ProxyCheckoutApiError, type ProxyCheckoutApiErrorDetails, type ProxyCheckoutValidationCode, ProxyCheckoutValidationError, } from "./errors.js";
+export { ProxyEventsResource, type ResolvedIgnored, type ResolvedInitialProvision, type ResolvedPaymentAttempt, type ResolvedPaymentRisk, type ResolvedProxyEvent, type ResolvedProxyEventKind, type ResolvedSubscriptionCancelled, type ResolvedSubscriptionCancelScheduled, type ResolvedSubscriptionRenewed, type ResolvedTerminalSession, type ResolveProxyEventOptions, } from "./events.js";
+export { AT_RISK_SUBSCRIPTION_STATUSES, ENDED_SUBSCRIPTION_STATUSES, isSessionProvisionable, isSessionTerminal, isSubscriptionEnded, isSubscriptionPaymentAtRisk, PROVISIONABLE_SESSION_STATUSES, parseOptionalProxyDate, requireProxyDate, subscriptionAccessEndsAt, subscriptionWillRenew, TERMINAL_SESSION_STATUSES, } from "./lifecycle.js";
+export { type CreateProxySessionHandoffInput, type CreateProxySessionInput, type CreateProxySessionOptions, type MerchantProxySession, type PayerHandoffResult, type PayerOpenedResult, type ProxySession, ProxySessionCartResource, type ProxySessionCartResult, type ProxySessionHandoff, type ProxySessionProviderBinding, ProxySessionsResource, proxyCheckoutServerEndpoints, type RecordProviderBindingInput, type SetProxySessionCartInput, type TypedMerchantProxySession, } from "./sessions.js";
+export { type MerchantProxySubscription, ProxySubscriptionsResource, type ProxySubscriptionWithSession, type ProxySubscriptionWithUntypedSession, proxyCheckoutSubscriptionEndpoints, } from "./subscriptions.js";
+export type { JsonObject, JsonPrimitive, JsonValue, ProxyCheckoutFetch, ProxyCheckoutServerClientOptions, ProxyCheckoutServerRequestOptions, } from "./types.js";
+export { proxyCheckoutServerSdkName, proxyCheckoutServerSdkUserAgent, proxyCheckoutServerSdkVersion, } from "./version.js";
+export { isProxyPaymentAttemptEvent, isProxySessionEvent, isProxySubscriptionEvent, PROXY_WEBHOOK_EVENT_TYPES, type ProxyWebhookEventType, } from "./webhook-events.js";
+export { PROXY_WEBHOOK_RETRY_AFTER_SECONDS, type ProxyWebhookClaimResult, type ProxyWebhookHandlerOptions, type ProxyWebhookOutcome, type ProxyWebhookPayloadInput, type ProxyWebhookProcessRecord, type ProxyWebhookProcessResult, type ProxyWebhookRequestInput, type ProxyWebhookStore, ProxyWebhooksResource, } from "./webhook-handler.js";
+export { type ConstructProxyWebhookEventInput, type CreateWebhookEndpointInput, constructProxyWebhookEvent, PROXY_SIGNATURE_HEADER, ProxyWebhookEndpointsResource, type ProxyWebhookEvent, ProxyWebhookSignatureVerificationError, proxyCheckoutWebhookEndpointEndpoints, type RotateWebhookEndpointSecretInput, type UpdateWebhookEndpointInput, type VerifyProxyWebhookSignatureInput, verifyProxyWebhookSignature, type WebhookEndpoint, type WebhookEndpointSecretResult, } from "./webhooks.js";

package/dist/cjs/index.d.ts

@@ -0,0 +1,13 @@
+export { type ProxyCartParseOptions, type ProxyCartValidator, parseProxyCart, } from "./cart.js";
+export { createProxyCheckoutServerClient, ProxyCheckoutServerClient, } from "./client.js";
+export { assertCartBuyerReference, assertSubscriptionMatchesSession, } from "./consistency.js";
+export { ProxyCheckoutApiError, type ProxyCheckoutApiErrorDetails, type ProxyCheckoutValidationCode, ProxyCheckoutValidationError, } from "./errors.js";
+export { ProxyEventsResource, type ResolvedIgnored, type ResolvedInitialProvision, type ResolvedPaymentAttempt, type ResolvedPaymentRisk, type ResolvedProxyEvent, type ResolvedProxyEventKind, type ResolvedSubscriptionCancelled, type ResolvedSubscriptionCancelScheduled, type ResolvedSubscriptionRenewed, type ResolvedTerminalSession, type ResolveProxyEventOptions, } from "./events.js";
+export { AT_RISK_SUBSCRIPTION_STATUSES, ENDED_SUBSCRIPTION_STATUSES, isSessionProvisionable, isSessionTerminal, isSubscriptionEnded, isSubscriptionPaymentAtRisk, PROVISIONABLE_SESSION_STATUSES, parseOptionalProxyDate, requireProxyDate, subscriptionAccessEndsAt, subscriptionWillRenew, TERMINAL_SESSION_STATUSES, } from "./lifecycle.js";
+export { type CreateProxySessionHandoffInput, type CreateProxySessionInput, type CreateProxySessionOptions, type MerchantProxySession, type PayerHandoffResult, type PayerOpenedResult, type ProxySession, ProxySessionCartResource, type ProxySessionCartResult, type ProxySessionHandoff, type ProxySessionProviderBinding, ProxySessionsResource, proxyCheckoutServerEndpoints, type RecordProviderBindingInput, type SetProxySessionCartInput, type TypedMerchantProxySession, } from "./sessions.js";
+export { type MerchantProxySubscription, ProxySubscriptionsResource, type ProxySubscriptionWithSession, type ProxySubscriptionWithUntypedSession, proxyCheckoutSubscriptionEndpoints, } from "./subscriptions.js";
+export type { JsonObject, JsonPrimitive, JsonValue, ProxyCheckoutFetch, ProxyCheckoutServerClientOptions, ProxyCheckoutServerRequestOptions, } from "./types.js";
+export { proxyCheckoutServerSdkName, proxyCheckoutServerSdkUserAgent, proxyCheckoutServerSdkVersion, } from "./version.js";
+export { isProxyPaymentAttemptEvent, isProxySessionEvent, isProxySubscriptionEvent, PROXY_WEBHOOK_EVENT_TYPES, type ProxyWebhookEventType, } from "./webhook-events.js";
+export { PROXY_WEBHOOK_RETRY_AFTER_SECONDS, type ProxyWebhookClaimResult, type ProxyWebhookHandlerOptions, type ProxyWebhookOutcome, type ProxyWebhookPayloadInput, type ProxyWebhookProcessRecord, type ProxyWebhookProcessResult, type ProxyWebhookRequestInput, type ProxyWebhookStore, ProxyWebhooksResource, } from "./webhook-handler.js";
+export { type ConstructProxyWebhookEventInput, type CreateWebhookEndpointInput, constructProxyWebhookEvent, PROXY_SIGNATURE_HEADER, ProxyWebhookEndpointsResource, type ProxyWebhookEvent, ProxyWebhookSignatureVerificationError, proxyCheckoutWebhookEndpointEndpoints, type RotateWebhookEndpointSecretInput, type UpdateWebhookEndpointInput, type VerifyProxyWebhookSignatureInput, verifyProxyWebhookSignature, type WebhookEndpoint, type WebhookEndpointSecretResult, } from "./webhooks.js";

package/dist/cjs/lifecycle.d.cts

@@ -0,0 +1,47 @@
+/**
+ * SDK-owned normalization of Proxy session and subscription lifecycle.
+ *
+ * These helpers turn raw Proxy state into the small set of derived facts a
+ * merchant entitlement layer actually needs (`willRenew`, `accessEndsAt`,
+ * terminal/provisionable predicates) so every customer does not re-encode
+ * Proxy lifecycle semantics by hand.
+ */
+import type { MerchantProxySession } from "./sessions.js";
+import type { MerchantProxySubscription } from "./subscriptions.js";
+/** Session statuses that mean the payer has paid and entitlement may be granted. */
+export declare const PROVISIONABLE_SESSION_STATUSES: Set<string>;
+/**
+ * Session statuses that are terminal from the SDK's lifecycle perspective — the
+ * automatic flow has stopped and the merchant must observe the outcome. This
+ * includes `merchant_action_required`, which halts the session pending merchant
+ * intervention; classifying it here keeps a `proxy_session.merchant_action_required`
+ * event from silently resolving to `ignored` and being marked processed.
+ */
+export declare const TERMINAL_SESSION_STATUSES: Set<string>;
+/** Subscription statuses that mean the subscription is no longer active. */
+export declare const ENDED_SUBSCRIPTION_STATUSES: Set<string>;
+/** Subscription statuses that indicate a payment problem on an otherwise live subscription. */
+export declare const AT_RISK_SUBSCRIPTION_STATUSES: Set<string>;
+/** Parse a required ISO date from Proxy, throwing a structured error when missing/invalid. */
+export declare function requireProxyDate(value: string | null | undefined, field: string): Date;
+/** Parse an optional ISO date from Proxy, returning null when absent and throwing when invalid. */
+export declare function parseOptionalProxyDate(value: string | null | undefined, field?: string): Date | null;
+/** True once the payer has paid / the session is provisionable for entitlement. */
+export declare function isSessionProvisionable(session: Pick<MerchantProxySession, "status">): boolean;
+/** True once the session has reached a terminal state. */
+export declare function isSessionTerminal(session: Pick<MerchantProxySession, "status">): boolean;
+/**
+ * Whether the subscription is expected to renew at the end of the current period.
+ * A subscription will not renew once it is scheduled to cancel or has ended.
+ */
+export declare function subscriptionWillRenew(subscription: Pick<MerchantProxySubscription, "cancelAtPeriodEnd" | "endedAt" | "status">): boolean;
+/**
+ * The instant at which paid access should end given current subscription state.
+ * Prefers an explicit `endedAt` (hard stop) over the current period boundary.
+ * Returns null when neither is known.
+ */
+export declare function subscriptionAccessEndsAt(subscription: Pick<MerchantProxySubscription, "currentPeriodEnd" | "endedAt">): Date | null;
+/** True when the subscription has ended (cancelled / expired / explicitly ended). */
+export declare function isSubscriptionEnded(subscription: Pick<MerchantProxySubscription, "endedAt" | "status">): boolean;
+/** True when the subscription is live but has a payment problem (past_due / unpaid / failed). */
+export declare function isSubscriptionPaymentAtRisk(subscription: Pick<MerchantProxySubscription, "latestPaymentStatus" | "status">): boolean;

package/dist/cjs/lifecycle.d.ts

@@ -0,0 +1,47 @@
+/**
+ * SDK-owned normalization of Proxy session and subscription lifecycle.
+ *
+ * These helpers turn raw Proxy state into the small set of derived facts a
+ * merchant entitlement layer actually needs (`willRenew`, `accessEndsAt`,
+ * terminal/provisionable predicates) so every customer does not re-encode
+ * Proxy lifecycle semantics by hand.
+ */
+import type { MerchantProxySession } from "./sessions.js";
+import type { MerchantProxySubscription } from "./subscriptions.js";
+/** Session statuses that mean the payer has paid and entitlement may be granted. */
+export declare const PROVISIONABLE_SESSION_STATUSES: Set<string>;
+/**
+ * Session statuses that are terminal from the SDK's lifecycle perspective — the
+ * automatic flow has stopped and the merchant must observe the outcome. This
+ * includes `merchant_action_required`, which halts the session pending merchant
+ * intervention; classifying it here keeps a `proxy_session.merchant_action_required`
+ * event from silently resolving to `ignored` and being marked processed.
+ */
+export declare const TERMINAL_SESSION_STATUSES: Set<string>;
+/** Subscription statuses that mean the subscription is no longer active. */
+export declare const ENDED_SUBSCRIPTION_STATUSES: Set<string>;
+/** Subscription statuses that indicate a payment problem on an otherwise live subscription. */
+export declare const AT_RISK_SUBSCRIPTION_STATUSES: Set<string>;
+/** Parse a required ISO date from Proxy, throwing a structured error when missing/invalid. */
+export declare function requireProxyDate(value: string | null | undefined, field: string): Date;
+/** Parse an optional ISO date from Proxy, returning null when absent and throwing when invalid. */
+export declare function parseOptionalProxyDate(value: string | null | undefined, field?: string): Date | null;
+/** True once the payer has paid / the session is provisionable for entitlement. */
+export declare function isSessionProvisionable(session: Pick<MerchantProxySession, "status">): boolean;
+/** True once the session has reached a terminal state. */
+export declare function isSessionTerminal(session: Pick<MerchantProxySession, "status">): boolean;
+/**
+ * Whether the subscription is expected to renew at the end of the current period.
+ * A subscription will not renew once it is scheduled to cancel or has ended.
+ */
+export declare function subscriptionWillRenew(subscription: Pick<MerchantProxySubscription, "cancelAtPeriodEnd" | "endedAt" | "status">): boolean;
+/**
+ * The instant at which paid access should end given current subscription state.
+ * Prefers an explicit `endedAt` (hard stop) over the current period boundary.
+ * Returns null when neither is known.
+ */
+export declare function subscriptionAccessEndsAt(subscription: Pick<MerchantProxySubscription, "currentPeriodEnd" | "endedAt">): Date | null;
+/** True when the subscription has ended (cancelled / expired / explicitly ended). */
+export declare function isSubscriptionEnded(subscription: Pick<MerchantProxySubscription, "endedAt" | "status">): boolean;
+/** True when the subscription is live but has a payment problem (past_due / unpaid / failed). */
+export declare function isSubscriptionPaymentAtRisk(subscription: Pick<MerchantProxySubscription, "latestPaymentStatus" | "status">): boolean;

package/dist/cjs/response-validators.d.cts

@@ -0,0 +1,8 @@
+import type { JsonObject } from "./types.js";
+export declare function requireJsonObject(value: unknown, operation: string): JsonObject;
+export declare function requireString(value: unknown, field: string): string;
+export declare function requireNullableString(value: unknown, field: string): string | null;
+export declare function requireInteger(value: unknown, field: string): number;
+export declare function requireNullableInteger(value: unknown, field: string): number | null;
+export declare function requireBoolean(value: unknown, field: string): boolean;
+export declare function requireStringArrayOrNull(value: unknown, field: string): string[] | null;

package/dist/cjs/response-validators.d.ts

@@ -0,0 +1,8 @@
+import type { JsonObject } from "./types.js";
+export declare function requireJsonObject(value: unknown, operation: string): JsonObject;
+export declare function requireString(value: unknown, field: string): string;
+export declare function requireNullableString(value: unknown, field: string): string | null;
+export declare function requireInteger(value: unknown, field: string): number;
+export declare function requireNullableInteger(value: unknown, field: string): number | null;
+export declare function requireBoolean(value: unknown, field: string): boolean;
+export declare function requireStringArrayOrNull(value: unknown, field: string): string[] | null;