@proxy-checkout/stripe-server-js 0.0.0 → 0.0.1

package/package.json

@@ -1,24 +1,31 @@
 {
   "description": "Server-side Stripe adapter for Proxy Checkout: required metadata, provider binding, openCheckout, and cart sync.",
   "license": "MIT",
-  "module": "./dist/index.js",
+  "module": "./dist/esm/index.js",
   "name": "@proxy-checkout/stripe-server-js",
   "private": false,
   "sideEffects": false,
   "type": "module",
-  "types": "./dist/index.d.ts",
-  "version": "0.0.0",
+  "types": "./dist/esm/index.d.ts",
+  "version": "0.0.1",
   "devDependencies": {
     "@types/node": "^24.12.4",
     "@vitest/coverage-v8": "4.1.7",
+    "stripe": "^21.0.1",
     "typescript": "^6.0.3",
     "vitest": "4.1.7",
     "@proxy-checkout/server-js": "0.0.4"
   },
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "import": {
+        "default": "./dist/esm/index.js",
+        "types": "./dist/esm/index.d.ts"
+      },
+      "require": {
+        "default": "./dist/cjs/index.js",
+        "types": "./dist/cjs/index.d.cts"
+      }
     }
   },
   "files": [
@@ -34,7 +41,7 @@
     "sdk"
   ],
   "peerDependencies": {
-    "@proxy-checkout/server-js": "0.0.4"
+    "@proxy-checkout/server-js": ">=0.0.4-0 <0.1.0"
   },
   "publishConfig": {
     "access": "public"
@@ -45,7 +52,7 @@
     "url": "git+https://github.com/linuslabs/proxy.git"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "node ../../scripts/sdk/build-dual-package.mjs",
     "test:all": "vitest run",
     "test:coverage": "vitest run --coverage.enabled --coverage.reportsDirectory=coverage/all",
     "test:coverage:changed": "vitest run --coverage.enabled --coverage.reportsDirectory=coverage/changed",
@@ -54,5 +61,6 @@
     "test:integration": "vitest run --project integration",
     "test:unit": "vitest run --project unit",
     "typecheck": "tsc --noEmit -p tsconfig.json"
-  }
+  },
+  "main": "./dist/cjs/index.js"
 }

package/dist/errors.d.ts

@@ -1,20 +0,0 @@
-/**
- * Adapter-specific error raised when a Stripe/Proxy cart synchronization cannot
- * complete cleanly. The `reconciled` flag states whether the Proxy cart was
- * restored to its prior state, so callers can react deterministically.
- */
-export type ProxyStripeCartSyncCode = "reconciliation_failed" | "stripe_update_failed";
-export declare class ProxyStripeCartSyncError extends Error {
-    readonly name = "ProxyStripeCartSyncError";
-    readonly code: ProxyStripeCartSyncCode;
-    /** True when the Proxy cart was rolled back to its prior state after the failure. */
-    readonly reconciled: boolean;
-    readonly cause: unknown;
-    readonly rollbackCause: unknown;
-    constructor(message: string, details: {
-        code: ProxyStripeCartSyncCode;
-        reconciled: boolean;
-        cause: unknown;
-        rollbackCause?: unknown;
-    });
-}

package/dist/errors.js

@@ -1,15 +0,0 @@
-export class ProxyStripeCartSyncError extends Error {
-    name = "ProxyStripeCartSyncError";
-    code;
-    /** True when the Proxy cart was rolled back to its prior state after the failure. */
-    reconciled;
-    cause;
-    rollbackCause;
-    constructor(message, details) {
-        super(message);
-        this.code = details.code;
-        this.reconciled = details.reconciled;
-        this.cause = details.cause;
-        this.rollbackCause = details.rollbackCause;
-    }
-}

package/dist/index.d.ts

@@ -1,6 +0,0 @@
-export { type ProxyStripeCartSyncCode, ProxyStripeCartSyncError, } from "./errors.js";
-export { assertCheckoutSessionBelongsToProxy, assertPaymentIntentBelongsToProxy, assertSubscriptionBelongsToProxy, PROXY_SESSION_METADATA_KEY, type ProxySessionMetadata, type ProxyStripeRequiredMetadata, requiredMetadata, } from "./metadata.js";
-export { type OpenCheckoutOptions, type OpenCheckoutResult, openCheckout, } from "./open-checkout.js";
-export { type SyncCheckoutCartOptions, type SyncCheckoutCartResult, type SyncedCart, syncCheckoutCart, } from "./sync-checkout-cart.js";
-export type { StripeCheckoutSessionLike, StripeCheckoutSessionsApiLike, StripeCheckoutSessionUpdateParams, StripeClientLike, StripeMetadata, StripePaymentIntentLike, StripeSubscriptionLike, } from "./types.js";
-export { proxyCheckoutStripeServerSdkName, proxyCheckoutStripeServerSdkVersion, } from "./version.js";

package/dist/index.js

@@ -1,5 +0,0 @@
-export { ProxyStripeCartSyncError, } from "./errors.js";
-export { assertCheckoutSessionBelongsToProxy, assertPaymentIntentBelongsToProxy, assertSubscriptionBelongsToProxy, PROXY_SESSION_METADATA_KEY, requiredMetadata, } from "./metadata.js";
-export { openCheckout, } from "./open-checkout.js";
-export { syncCheckoutCart, } from "./sync-checkout-cart.js";
-export { proxyCheckoutStripeServerSdkName, proxyCheckoutStripeServerSdkVersion, } from "./version.js";

package/dist/open-checkout.d.ts

@@ -1,48 +0,0 @@
-/**
- * `openCheckout` — the payer-opened + provider-object creation workflow.
- *
- * It performs the Proxy protocol steps (record payer-opened, validate the cart,
- * supply required metadata, record the provider binding) and delegates only the
- * app-specific Stripe object creation to the merchant callback. This makes it
- * hard to create a Stripe checkout that is not correctly linked to a session.
- */
-import type { PayerOpenedResult, ProxyCartValidator, ProxyCheckoutServerClient } from "@proxy-checkout/server-js";
-import type { ProxyStripeRequiredMetadata } from "./metadata.js";
-import type { StripeCheckoutSessionLike } from "./types.js";
-export interface OpenCheckoutOptions<TStripe, TCart, TOffer, TSession> {
-    /** Optional schema validating the session cart snapshot into a typed cart. */
-    readonly cartSchema?: ProxyCartValidator<TCart>;
-    /** Builds the Stripe checkout object. Must place `metadata.checkoutSession` (and subscription/payment-intent metadata) on the created object. */
-    readonly createCheckoutSession: (input: {
-        cart: TCart;
-        metadata: ProxyStripeRequiredMetadata;
-        offer: TOffer;
-        proxySession: PayerOpenedResult;
-        stripe: TStripe;
-    }) => Promise<TSession> | TSession;
-    /** Optional extractor used to assert the cart buyer reference matches the session. */
-    readonly getCartBuyerReference?: (cart: TCart) => string | null | undefined;
-    /** A Proxy server SDK client. */
-    readonly proxy: ProxyCheckoutServerClient;
-    readonly proxySessionId: string;
-    /** Provider identifier recorded with the binding. Defaults to "stripe". */
-    readonly psp?: string;
-    readonly requestId?: string;
-    /** The merchant's Stripe instance, forwarded to `createCheckoutSession`. */
-    readonly stripe: TStripe;
-    /** Optional merchant cart validation that derives an app-specific offer. */
-    readonly validateCart?: (input: {
-        cart: TCart;
-        session: PayerOpenedResult;
-    }) => Promise<TOffer> | TOffer;
-}
-export interface OpenCheckoutResult<TCart, TOffer, TSession> {
-    readonly binding: Awaited<ReturnType<ProxyCheckoutServerClient["sessions"]["recordProviderBinding"]>>;
-    readonly cart: TCart;
-    readonly checkoutSession: TSession;
-    readonly clientSecret: string | null;
-    readonly offer: TOffer;
-    readonly proxySession: PayerOpenedResult;
-    readonly proxySessionId: string;
-}
-export declare function openCheckout<TStripe, TCart = unknown, TOffer = undefined, TSession extends StripeCheckoutSessionLike = StripeCheckoutSessionLike>(options: OpenCheckoutOptions<TStripe, TCart, TOffer, TSession>): Promise<OpenCheckoutResult<TCart, TOffer, TSession>>;

package/dist/open-checkout.js

@@ -1,48 +0,0 @@
-/**
- * `openCheckout` — the payer-opened + provider-object creation workflow.
- *
- * It performs the Proxy protocol steps (record payer-opened, validate the cart,
- * supply required metadata, record the provider binding) and delegates only the
- * app-specific Stripe object creation to the merchant callback. This makes it
- * hard to create a Stripe checkout that is not correctly linked to a session.
- */
-import { assertCheckoutSessionBelongsToProxy, requiredMetadata } from "./metadata.js";
-export async function openCheckout(options) {
-    const psp = options.psp ?? "stripe";
-    const proxySession = await options.proxy.sessions.payerOpened(options.proxySessionId, {
-        requestId: options.requestId,
-    });
-    // Parse the cart (and run the buyer-reference check) whenever a schema OR a
-    // buyer-reference extractor is provided, so the consistency check is never
-    // silently skipped just because no custom schema was passed.
-    const cart = options.cartSchema || options.getCartBuyerReference
-        ? options.proxy.sessions.parseCart(proxySession, options.cartSchema ?? ((value) => value), { getBuyerReference: options.getCartBuyerReference })
-        : proxySession.cartSnapshot;
-    const offer = options.validateCart
-        ? await options.validateCart({ cart, session: proxySession })
-        : undefined;
-    const metadata = requiredMetadata(proxySession);
-    const checkoutSession = await options.createCheckoutSession({
-        cart,
-        metadata,
-        offer,
-        proxySession,
-        stripe: options.stripe,
-    });
-    // Fail closed if the merchant forgot to place proxy_session_id metadata.
-    assertCheckoutSessionBelongsToProxy(checkoutSession, proxySession.id);
-    const binding = await options.proxy.sessions.recordProviderBinding(proxySession.id, {
-        providerCheckoutSessionId: checkoutSession.id,
-        psp,
-        requestId: options.requestId,
-    });
-    return {
-        binding,
-        cart,
-        checkoutSession,
-        clientSecret: checkoutSession.client_secret ?? null,
-        offer,
-        proxySession,
-        proxySessionId: proxySession.id,
-    };
-}