@kodice.one/stripefirebase-client 1.0.0

package/README.md

@@ -0,0 +1,204 @@
+# Firebase + Stripe Payments — Monorepo
+
+End-to-end payment integration using **Firebase Functions v2**, **Firestore**, and **Stripe Checkout**, structured as an npm workspaces monorepo.
+
+---
+
+## Project structure
+
+```
+firebase-stripe-payments/
+├── package.json              ← workspace root
+├── tsconfig.base.json        ← shared TS compiler base
+├── firebase.json             ← Firebase project config
+├── firebase/
+│   ├── firestore.rules       ← Firestore security rules
+│   └── firestore.indexes.json
+└── packages/
+    ├── shared/               ← @kodice.one/stripefirebase-shared
+    │   ├── package.json
+    │   ├── tsconfig.json
+    │   └── src/index.ts      ← all shared TypeScript types
+    │
+    ├── functions/            ← @kodice.one/stripefirebase-functions
+    │   ├── package.json
+    │   ├── tsconfig.json
+    │   └── src/index.ts      ← createCheckout + stripeWebhook (Functions v2)
+    │
+    └── client/               ← @kodice.one/stripefirebase-client  (publishable npm lib)
+        ├── package.json
+        ├── tsconfig.json
+        ├── tsconfig.esm.json
+        └── src/
+            ├── index.ts      ← createCheckoutUrl, onPaymentStatusChange, onUserCheckouts
+            ├── react.ts      ← useStripeCheckout, usePaymentStatus, useUserCheckouts
+            └── example.tsx   ← reference React components
+```
+
+---
+
+## Architecture
+
+```
+React App
+  │
+  ├─ @kodice.one/stripefirebase-client
+  │    ├─ createCheckoutUrl()          → calls Firebase Function (onCall v2)
+  │    ├─ onPaymentStatusChange()      → real-time Firestore listener
+  │    └─ /react hooks
+  │
+Firebase Functions (v2)
+  ├─ createCheckout  (onCall)
+  │    ├─ Validates auth + input
+  │    ├─ Creates Stripe Checkout Session
+  │    └─ Writes  checkouts/{uid}/sessions/{sid}  status: "pending"
+  │
+  └─ stripeWebhook  (onRequest)
+       ├─ Verifies Stripe signature
+       └─ Updates Firestore status on each event:
+            checkout.session.completed   → "succeeded"
+            checkout.session.expired     → "expired"
+            payment_intent.payment_failed → "failed"
+            customer.subscription.deleted → "canceled"
+
+Firestore
+  └─ checkouts/{userId}/sessions/{sessionId}
+```
+
+---
+
+## Getting started
+
+### 1. Install dependencies
+
+```bash
+npm install
+```
+
+This installs all workspace packages in one shot.
+
+### 2. Set Stripe secrets (stored in Google Cloud Secret Manager)
+
+```bash
+firebase functions:secrets:set STRIPE_SECRET_KEY
+# paste sk_live_... or sk_test_...
+
+firebase functions:secrets:set STRIPE_WEBHOOK_SECRET
+# paste whsec_... (from the Stripe Dashboard after step 4)
+```
+
+### 3. Build & deploy
+
+```bash
+# Build everything (shared → functions → client)
+npm run build
+
+# Deploy Functions + Firestore rules/indexes
+firebase deploy
+```
+
+### 4. Register the Stripe webhook
+
+In [Stripe Dashboard → Webhooks](https://dashboard.stripe.com/webhooks) add:
+
+- **URL:** `https://<region>-<project-id>.cloudfunctions.net/stripeWebhook`
+- **Events:**
+  - `checkout.session.completed`
+  - `checkout.session.expired`
+  - `payment_intent.payment_failed`
+  - `customer.subscription.deleted`
+
+Copy the **Signing secret** and save it: `firebase functions:secrets:set STRIPE_WEBHOOK_SECRET`.
+
+### 5. Use the client in your React app
+
+```bash
+npm install @kodice.one/stripefirebase-client
+```
+
+```tsx
+// main.tsx
+import { initializeApp }     from "firebase/app";
+import { getFunctions }      from "firebase/functions";
+import { getFirestore }      from "firebase/firestore";
+import { initStripeFirebase } from "@kodice.one/stripefirebase-client";
+
+const app = initializeApp({ /* your firebase config */ });
+
+initStripeFirebase({
+  functions: getFunctions(app),
+  firestore: getFirestore(app),
+});
+```
+
+```tsx
+// PricingPage.tsx
+import { useStripeCheckout } from "@kodice.one/stripefirebase-client/react";
+
+export function SubscribeButton({ priceId }: { priceId: string }) {
+  const { startCheckout, loading, error } = useStripeCheckout();
+
+  return (
+    <button
+      disabled={loading}
+      onClick={() => startCheckout({
+        lineItems: [{ priceId, quantity: 1 }],
+        mode: "subscription",
+        successUrl: `${location.origin}/welcome?session_id={CHECKOUT_SESSION_ID}`,
+        cancelUrl:  `${location.origin}/pricing`,
+      })}
+    >
+      {loading ? "Loading…" : "Subscribe"}
+    </button>
+  );
+}
+```
+
+```tsx
+// SuccessPage.tsx — mounted at your successUrl route
+import { usePaymentStatus } from "@kodice.one/stripefirebase-client/react";
+
+export function SuccessPage({ userId }: { userId: string }) {
+  const sessionId = new URLSearchParams(location.search).get("session_id");
+  const { status, session } = usePaymentStatus({ userId, sessionId });
+
+  if (status === "succeeded") return <h1>Welcome! 🎉</h1>;
+  if (status === "failed")    return <p>Payment failed — please retry.</p>;
+  return <p>Confirming payment…</p>;
+}
+```
+
+---
+
+## Local development
+
+```bash
+# Start Firebase emulators (Functions + Firestore)
+npm run emulate
+
+# In a separate terminal — forward live Stripe events to the local webhook
+stripe listen --forward-to http://localhost:5001/<project-id>/us-central1/stripeWebhook
+```
+
+---
+
+## Functions v2 highlights
+
+| Feature | v1 | v2 (this project) |
+|---|---|---|
+| Import path | `firebase-functions` | `firebase-functions/v2/https` |
+| Secrets | `functions.config()` | `defineSecret()` → Secret Manager |
+| Config | `functions.config().stripe.key` | `process.env` / `secret.value()` |
+| Logging | `functions.logger` | `import { logger } from "firebase-functions/v2"` |
+| onCall data | `(data, context)` | `(request)` → `request.data`, `request.auth` |
+| Concurrency | 1 req / instance | Up to 1000 req / instance |
+
+---
+
+## Security notes
+
+- **Firestore rules** deny all client writes; only the Admin SDK (Functions) may write.
+- **Auth guard** in `createCheckout` blocks unauthenticated callers.
+- **Webhook signature** verification prevents spoofed Stripe events.
+- `client_reference_id` and `metadata.userId` are set server-side — clients cannot impersonate another user's session.
+- Stripe secrets are stored in **Google Cloud Secret Manager**, never in source code or `firebase.json`.

package/dist/example.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Example React components — illustrates the full client integration.
+ * This file is for reference only; do not ship it in production.
+ */
+import React from "react";
+export declare function BuyButton({ priceId }: {
+    priceId: string;
+}): React.JSX.Element;
+export declare function SubscribeButton({ priceId }: {
+    priceId: string;
+}): React.JSX.Element;
+export declare function SuccessPage({ userId }: {
+    userId: string;
+}): React.JSX.Element | null;
+export declare function OrderHistory({ userId }: {
+    userId: string;
+}): React.JSX.Element;
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../src/example.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAU1B,wBAAgB,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,qBAqBzD;AAID,wBAAgB,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,qBAsB/D;AAMD,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,4BAuBzD;AAID,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,qBAiB1D"}

package/dist/example.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Example React components — illustrates the full client integration.
+ * This file is for reference only; do not ship it in production.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuyButton = BuyButton;
+exports.SubscribeButton = SubscribeButton;
+exports.SuccessPage = SuccessPage;
+exports.OrderHistory = OrderHistory;
+const react_1 = __importDefault(require("react"));
+const react_2 = require("./react");
+// ── One-time payment button ──────────────────────────────────────────────────
+function BuyButton({ priceId }) {
+    const { startCheckout, loading, error } = (0, react_2.useStripeCheckout)();
+    return (react_1.default.createElement("div", null,
+        react_1.default.createElement("button", { disabled: loading, onClick: () => startCheckout({
+                lineItems: [{ priceId, quantity: 1 }],
+                mode: "payment",
+                successUrl: `${window.location.origin}/success?session_id={CHECKOUT_SESSION_ID}`,
+                cancelUrl: `${window.location.origin}/pricing`,
+            }) }, loading ? "Redirecting…" : "Buy now"),
+        error && react_1.default.createElement("p", { style: { color: "red" } }, error.message)));
+}
+// ── Subscription button ──────────────────────────────────────────────────────
+function SubscribeButton({ priceId }) {
+    const { startCheckout, loading, error } = (0, react_2.useStripeCheckout)();
+    return (react_1.default.createElement("div", null,
+        react_1.default.createElement("button", { disabled: loading, onClick: () => startCheckout({
+                lineItems: [{ priceId, quantity: 1 }],
+                mode: "subscription",
+                successUrl: `${window.location.origin}/welcome?session_id={CHECKOUT_SESSION_ID}`,
+                cancelUrl: `${window.location.origin}/pricing`,
+                metadata: { plan: "pro" },
+            }) }, loading ? "Loading…" : "Subscribe"),
+        error && react_1.default.createElement("p", { style: { color: "red" } }, error.message)));
+}
+// ── Success page ─────────────────────────────────────────────────────────────
+// Mount at whatever URL you pass as successUrl (e.g. /success).
+// Stripe appends ?session_id=cs_... automatically.
+function SuccessPage({ userId }) {
+    const sessionId = new URLSearchParams(window.location.search).get("session_id");
+    const { status, session, loading, error } = (0, react_2.usePaymentStatus)({ userId, sessionId });
+    if (loading)
+        return react_1.default.createElement("p", null, "Confirming payment\u2026");
+    if (error)
+        return react_1.default.createElement("p", null,
+            "Error: ",
+            error.message);
+    if (status === "succeeded") {
+        return (react_1.default.createElement("div", null,
+            react_1.default.createElement("h1", null, "Payment confirmed!"),
+            react_1.default.createElement("p", null,
+                "Mode: ", session === null || session === void 0 ? void 0 :
+                session.mode),
+            (session === null || session === void 0 ? void 0 : session.mode) === "subscription" && (react_1.default.createElement("p", null,
+                "Subscription ID: ",
+                session.subscriptionId))));
+    }
+    if (status === "failed")
+        return react_1.default.createElement("p", null, "Payment failed. Please try again.");
+    if (status === "pending")
+        return react_1.default.createElement("p", null, "Waiting for confirmation\u2026");
+    return null;
+}
+// ── Order history ─────────────────────────────────────────────────────────────
+function OrderHistory({ userId }) {
+    const { sessions, loading, error } = (0, react_2.useUserCheckouts)({ userId });
+    if (loading)
+        return react_1.default.createElement("p", null, "Loading orders\u2026");
+    if (error)
+        return react_1.default.createElement("p", null,
+            "Error: ",
+            error.message);
+    if (!sessions.length)
+        return react_1.default.createElement("p", null, "No orders yet.");
+    return (react_1.default.createElement("ul", null, sessions.map((s) => (react_1.default.createElement("li", { key: s.sessionId },
+        react_1.default.createElement("strong", null, s.mode),
+        " \u2014 ",
+        s.status,
+        " \u2014",
+        " ",
+        new Date(s.createdAt).toLocaleDateString())))));
+}
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../src/example.tsx"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @kodice.one/stripefirebase-client — core
+ *
+ * Framework-agnostic helpers for creating Stripe Checkout sessions and
+ * listening to payment status updates via Firestore.
+ *
+ * Initialize once at app startup, then call createCheckoutUrl() and
+ * onPaymentStatusChange() anywhere in your application.
+ */
+import { Functions } from "firebase/functions";
+import { Firestore, Unsubscribe } from "firebase/firestore";
+export type { PaymentMode, CheckoutStatus, LineItem, CreateCheckoutRequest, CreateCheckoutResponse, CheckoutDocument, } from "@kodice.one/stripefirebase-shared";
+import type { CreateCheckoutRequest, CreateCheckoutResponse, CheckoutDocument, CheckoutStatus } from "@kodice.one/stripefirebase-shared";
+/**
+ * Initialise the client library. Call once after `initializeApp()`.
+ *
+ * @example
+ * import { initializeApp }  from "firebase/app";
+ * import { getFunctions }   from "firebase/functions";
+ * import { getFirestore }   from "firebase/firestore";
+ * import { initStripeFirebase } from "@kodice.one/stripefirebase-client";
+ *
+ * const app = initializeApp({ ...firebaseConfig });
+ * initStripeFirebase({
+ *   functions: getFunctions(app),
+ *   firestore: getFirestore(app),
+ * });
+ */
+export declare function initStripeFirebase(opts: {
+    functions: Functions;
+    firestore: Firestore;
+}): void;
+/**
+ * Calls the `createCheckout` Firebase Function and returns the Stripe
+ * Checkout URL along with the session ID.
+ *
+ * @example
+ * const { sessionId, checkoutUrl } = await createCheckoutUrl({
+ *   lineItems: [{ priceId: "price_abc123", quantity: 1 }],
+ *   mode: "subscription",
+ *   successUrl: `${location.origin}/success?session_id={CHECKOUT_SESSION_ID}`,
+ *   cancelUrl:  `${location.origin}/pricing`,
+ * });
+ * window.location.href = checkoutUrl;
+ */
+export declare function createCheckoutUrl(request: CreateCheckoutRequest): Promise<CreateCheckoutResponse>;
+export interface PaymentStatusChangeOptions {
+    /** Firebase Auth UID of the current user. */
+    userId: string;
+    /** Stripe Checkout Session ID returned by createCheckoutUrl. */
+    sessionId: string;
+    /** Invoked on every document change (including the initial read). */
+    onStatusChange: (status: CheckoutStatus, document: CheckoutDocument) => void;
+    /** Invoked on Firestore errors. Defaults to console.error. */
+    onError?: (error: Error) => void;
+}
+/**
+ * Subscribes to real-time Firestore updates for a single Checkout session.
+ * Returns an unsubscribe function — call it in cleanup / useEffect teardown.
+ *
+ * @example
+ * const unsub = onPaymentStatusChange({
+ *   userId,
+ *   sessionId,
+ *   onStatusChange: (status, doc) => {
+ *     if (status === "succeeded") showSuccessBanner(doc);
+ *     if (status === "failed")    showErrorBanner();
+ *   },
+ * });
+ * return () => unsub(); // cleanup
+ */
+export declare function onPaymentStatusChange(opts: PaymentStatusChangeOptions): Unsubscribe;
+/**
+ * Subscribes to all Checkout sessions for a user, newest first.
+ * Useful for building an order history page.
+ */
+export declare function onUserCheckouts(opts: {
+    userId: string;
+    maxSessions?: number;
+    onCheckouts: (sessions: CheckoutDocument[]) => void;
+    onError?: (error: Error) => void;
+}): Unsubscribe;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,SAAS,EAGV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,SAAS,EAOT,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,WAAW,EACX,cAAc,EACd,QAAQ,EACR,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACf,MAAM,mCAAmC,CAAC;AAS3C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;CACtB,GAAG,IAAI,CAGP;AAgBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,sBAAsB,CAAC,CAejC;AAMD,MAAM,WAAW,0BAA0B;IACzC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,cAAc,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC7E,8DAA8D;IAC9D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,0BAA0B,GAC/B,WAAW,CAqBb;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,IAAI,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC,GAAG,WAAW,CAed"}

package/dist/index.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * @kodice.one/stripefirebase-client — core
+ *
+ * Framework-agnostic helpers for creating Stripe Checkout sessions and
+ * listening to payment status updates via Firestore.
+ *
+ * Initialize once at app startup, then call createCheckoutUrl() and
+ * onPaymentStatusChange() anywhere in your application.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initStripeFirebase = initStripeFirebase;
+exports.createCheckoutUrl = createCheckoutUrl;
+exports.onPaymentStatusChange = onPaymentStatusChange;
+exports.onUserCheckouts = onUserCheckouts;
+const functions_1 = require("firebase/functions");
+const firestore_1 = require("firebase/firestore");
+// ─────────────────────────────────────────────────────────────────────────────
+// Singleton state
+// ─────────────────────────────────────────────────────────────────────────────
+let _functions = null;
+let _firestore = null;
+/**
+ * Initialise the client library. Call once after `initializeApp()`.
+ *
+ * @example
+ * import { initializeApp }  from "firebase/app";
+ * import { getFunctions }   from "firebase/functions";
+ * import { getFirestore }   from "firebase/firestore";
+ * import { initStripeFirebase } from "@kodice.one/stripefirebase-client";
+ *
+ * const app = initializeApp({ ...firebaseConfig });
+ * initStripeFirebase({
+ *   functions: getFunctions(app),
+ *   firestore: getFirestore(app),
+ * });
+ */
+function initStripeFirebase(opts) {
+    _functions = opts.functions;
+    _firestore = opts.firestore;
+}
+function requireFunctions() {
+    if (!_functions)
+        throw new Error("[kodice.one/stripefirebase-client] Call initStripeFirebase() first.");
+    return _functions;
+}
+function requireFirestore() {
+    if (!_firestore)
+        throw new Error("[kodice.one/stripefirebase-client] Call initStripeFirebase() first.");
+    return _firestore;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// createCheckoutUrl
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Calls the `createCheckout` Firebase Function and returns the Stripe
+ * Checkout URL along with the session ID.
+ *
+ * @example
+ * const { sessionId, checkoutUrl } = await createCheckoutUrl({
+ *   lineItems: [{ priceId: "price_abc123", quantity: 1 }],
+ *   mode: "subscription",
+ *   successUrl: `${location.origin}/success?session_id={CHECKOUT_SESSION_ID}`,
+ *   cancelUrl:  `${location.origin}/pricing`,
+ * });
+ * window.location.href = checkoutUrl;
+ */
+async function createCheckoutUrl(request) {
+    const fn = (0, functions_1.httpsCallable)(requireFunctions(), "createCheckout");
+    let result;
+    try {
+        result = await fn(request);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Failed to create checkout";
+        throw new Error(`[kodice.one/stripefirebase-client] ${msg}`);
+    }
+    return result.data;
+}
+/**
+ * Subscribes to real-time Firestore updates for a single Checkout session.
+ * Returns an unsubscribe function — call it in cleanup / useEffect teardown.
+ *
+ * @example
+ * const unsub = onPaymentStatusChange({
+ *   userId,
+ *   sessionId,
+ *   onStatusChange: (status, doc) => {
+ *     if (status === "succeeded") showSuccessBanner(doc);
+ *     if (status === "failed")    showErrorBanner();
+ *   },
+ * });
+ * return () => unsub(); // cleanup
+ */
+function onPaymentStatusChange(opts) {
+    const ref = (0, firestore_1.doc)(requireFirestore(), "checkouts", opts.userId, "sessions", opts.sessionId);
+    return (0, firestore_1.onSnapshot)(ref, (snap) => {
+        if (!snap.exists())
+            return;
+        const data = snap.data();
+        opts.onStatusChange(data.status, data);
+    }, (err) => {
+        if (opts.onError)
+            opts.onError(err);
+        else
+            console.error("[kodice.one/stripefirebase-client] Firestore error:", err);
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// onUserCheckouts
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Subscribes to all Checkout sessions for a user, newest first.
+ * Useful for building an order history page.
+ */
+function onUserCheckouts(opts) {
+    var _a;
+    const q = (0, firestore_1.query)((0, firestore_1.collection)(requireFirestore(), "checkouts", opts.userId, "sessions"), (0, firestore_1.orderBy)("createdAt", "desc"), (0, firestore_1.limit)((_a = opts.maxSessions) !== null && _a !== void 0 ? _a : 20));
+    return (0, firestore_1.onSnapshot)(q, (snap) => opts.onCheckouts(snap.docs.map((d) => d.data())), (err) => {
+        if (opts.onError)
+            opts.onError(err);
+        else
+            console.error("[kodice.one/stripefirebase-client] Firestore error:", err);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/react.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @kodice.one/stripefirebase-client/react
+ *
+ * React hooks built on top of the core library.
+ * Import: `import { useStripeCheckout } from "@kodice.one/stripefirebase-client/react"`
+ */
+import type { CreateCheckoutRequest, CreateCheckoutResponse, CheckoutDocument, CheckoutStatus } from "@kodice.one/stripefirebase-shared";
+export interface UseStripeCheckoutOptions {
+    /**
+     * When true (default), the hook automatically redirects to the Stripe
+     * Checkout page after a session is created.
+     */
+    autoRedirect?: boolean;
+}
+export interface UseStripeCheckoutReturn {
+    /** Initiates the checkout flow. Resolves with the session data or null on error. */
+    startCheckout: (req: CreateCheckoutRequest) => Promise<CreateCheckoutResponse | null>;
+    loading: boolean;
+    error: Error | null;
+    /** Session ID of the most recently created checkout — use with usePaymentStatus. */
+    sessionId: string | null;
+    checkoutUrl: string | null;
+}
+/**
+ * Hook that wraps createCheckoutUrl with loading/error state and optional
+ * auto-redirect to the Stripe Checkout page.
+ *
+ * @example
+ * const { startCheckout, loading, error } = useStripeCheckout();
+ *
+ * <button onClick={() => startCheckout({
+ *   lineItems: [{ priceId: "price_abc", quantity: 1 }],
+ *   mode: "subscription",
+ *   successUrl: `${location.origin}/success?session_id={CHECKOUT_SESSION_ID}`,
+ *   cancelUrl:  `${location.origin}/pricing`,
+ * })}>
+ *   Subscribe
+ * </button>
+ */
+export declare function useStripeCheckout(options?: UseStripeCheckoutOptions): UseStripeCheckoutReturn;
+export interface UsePaymentStatusReturn {
+    status: CheckoutStatus | null;
+    session: CheckoutDocument | null;
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * Subscribes to real-time status updates for a specific Checkout session.
+ * Mount this on your `/success` page to confirm payment before showing
+ * the confirmation UI.
+ *
+ * @example
+ * // /success page — Stripe appends ?session_id=... to your successUrl
+ * const sessionId = new URLSearchParams(location.search).get("session_id");
+ * const { status, session } = usePaymentStatus({ userId: user.uid, sessionId });
+ *
+ * if (status === "succeeded") return <SuccessBanner plan={session?.metadata.plan} />;
+ * if (status === "failed")    return <RetryButton />;
+ */
+export declare function usePaymentStatus(opts: {
+    userId: string | null | undefined;
+    sessionId: string | null | undefined;
+}): UsePaymentStatusReturn;
+export interface UseUserCheckoutsReturn {
+    sessions: CheckoutDocument[];
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * Subscribes to all Checkout sessions for the current user, newest first.
+ *
+ * @example
+ * const { sessions } = useUserCheckouts({ userId: user.uid });
+ * return <OrderList orders={sessions} />;
+ */
+export declare function useUserCheckouts(opts: {
+    userId: string | null | undefined;
+    maxSessions?: number;
+}): UseUserCheckoutsReturn;
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACf,MAAM,mCAAmC,CAAC;AAM3C,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,oFAAoF;IACpF,aAAa,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IACtF,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,oFAAoF;IACpF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CA+BzB;AAMD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACtC,GAAG,sBAAsB,CAgCzB;AAMD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,sBAAsB,CA4BzB"}

package/dist/react.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * @kodice.one/stripefirebase-client/react
+ *
+ * React hooks built on top of the core library.
+ * Import: `import { useStripeCheckout } from "@kodice.one/stripefirebase-client/react"`
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useStripeCheckout = useStripeCheckout;
+exports.usePaymentStatus = usePaymentStatus;
+exports.useUserCheckouts = useUserCheckouts;
+const react_1 = require("react");
+const index_1 = require("./index");
+/**
+ * Hook that wraps createCheckoutUrl with loading/error state and optional
+ * auto-redirect to the Stripe Checkout page.
+ *
+ * @example
+ * const { startCheckout, loading, error } = useStripeCheckout();
+ *
+ * <button onClick={() => startCheckout({
+ *   lineItems: [{ priceId: "price_abc", quantity: 1 }],
+ *   mode: "subscription",
+ *   successUrl: `${location.origin}/success?session_id={CHECKOUT_SESSION_ID}`,
+ *   cancelUrl:  `${location.origin}/pricing`,
+ * })}>
+ *   Subscribe
+ * </button>
+ */
+function useStripeCheckout(options = {}) {
+    const { autoRedirect = true } = options;
+    const [loading, setLoading] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    const [sessionId, setSessionId] = (0, react_1.useState)(null);
+    const [checkoutUrl, setCheckoutUrl] = (0, react_1.useState)(null);
+    const startCheckout = (0, react_1.useCallback)(async (req) => {
+        setLoading(true);
+        setError(null);
+        try {
+            const response = await (0, index_1.createCheckoutUrl)(req);
+            setSessionId(response.sessionId);
+            setCheckoutUrl(response.checkoutUrl);
+            if (autoRedirect)
+                window.location.href = response.checkoutUrl;
+            return response;
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            return null;
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [autoRedirect]);
+    return { startCheckout, loading, error, sessionId, checkoutUrl };
+}
+/**
+ * Subscribes to real-time status updates for a specific Checkout session.
+ * Mount this on your `/success` page to confirm payment before showing
+ * the confirmation UI.
+ *
+ * @example
+ * // /success page — Stripe appends ?session_id=... to your successUrl
+ * const sessionId = new URLSearchParams(location.search).get("session_id");
+ * const { status, session } = usePaymentStatus({ userId: user.uid, sessionId });
+ *
+ * if (status === "succeeded") return <SuccessBanner plan={session?.metadata.plan} />;
+ * if (status === "failed")    return <RetryButton />;
+ */
+function usePaymentStatus(opts) {
+    const [status, setStatus] = (0, react_1.useState)(null);
+    const [session, setSession] = (0, react_1.useState)(null);
+    const [loading, setLoading] = (0, react_1.useState)(true);
+    const [error, setError] = (0, react_1.useState)(null);
+    (0, react_1.useEffect)(() => {
+        if (!opts.userId || !opts.sessionId) {
+            setLoading(false);
+            return;
+        }
+        setLoading(true);
+        const unsub = (0, index_1.onPaymentStatusChange)({
+            userId: opts.userId,
+            sessionId: opts.sessionId,
+            onStatusChange: (newStatus, doc) => {
+                setStatus(newStatus);
+                setSession(doc);
+                setLoading(false);
+            },
+            onError: (err) => {
+                setError(err);
+                setLoading(false);
+            },
+        });
+        return () => unsub();
+    }, [opts.userId, opts.sessionId]);
+    return { status, session, loading, error };
+}
+/**
+ * Subscribes to all Checkout sessions for the current user, newest first.
+ *
+ * @example
+ * const { sessions } = useUserCheckouts({ userId: user.uid });
+ * return <OrderList orders={sessions} />;
+ */
+function useUserCheckouts(opts) {
+    const [sessions, setSessions] = (0, react_1.useState)([]);
+    const [loading, setLoading] = (0, react_1.useState)(true);
+    const [error, setError] = (0, react_1.useState)(null);
+    (0, react_1.useEffect)(() => {
+        if (!opts.userId) {
+            setLoading(false);
+            return;
+        }
+        const unsub = (0, index_1.onUserCheckouts)({
+            userId: opts.userId,
+            maxSessions: opts.maxSessions,
+            onCheckouts: (docs) => {
+                setSessions(docs);
+                setLoading(false);
+            },
+            onError: (err) => {
+                setError(err);
+                setLoading(false);
+            },
+        });
+        return () => unsub();
+    }, [opts.userId, opts.maxSessions]);
+    return { sessions, loading, error };
+}
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@kodice.one/stripefirebase-client",
+  "version": "1.0.0",
+  "private": false,
+  "description": "React client library for Firebase + Stripe payment integration",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/react.esm.js",
+      "require": "./dist/react.js",
+      "types": "./dist/react.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.esm.json",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf dist"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "dependencies": {
+    "@kodice.one/stripefirebase-shared": "^1.0.0"
+  },
+  "peerDependencies": {
+    "firebase": ">=10.0.0",
+    "react": ">=17.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "@types/react": "^18.0.0",
+    "typescript": "^5.4.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT"
+}