@molecule/api-payments-stripe 1.0.0

package/dist/secrets.js

@@ -0,0 +1,32 @@
+/**
+ * Stripe secret definitions — self-registered at import time so the
+ * runtime secrets registry (`@molecule/api-secrets`) can drive boot-time
+ * configuration reports and actionable "not configured" errors.
+ *
+ * Content is derived MECHANICALLY from this package's mlcl registry secrets
+ * entry (label/instructions/setupUrl/example) via the fleet formula, so
+ * packages sharing a key register byte-identical definitions and
+ * registration order never matters.
+ *
+ * @module
+ */
+import { registerSecrets } from '@molecule/api-secrets';
+/** Secret definitions required by the Stripe payments bond. */
+export const stripeSecretDefinitions = [
+    {
+        key: 'STRIPE_SECRET_KEY',
+        description: 'Stripe secret key — Stripe Dashboard → Developers → API keys; use the sk_test_ key in test mode, sk_live_ in production.',
+        helpUrl: 'https://dashboard.stripe.com/apikeys',
+        required: true,
+        example: 'sk_test_...',
+    },
+    {
+        key: 'STRIPE_WEBHOOK_SECRET',
+        description: 'Stripe webhook signing secret — Stripe Dashboard → Developers → Webhooks → Add endpoint pointing at {apiUrl}/api/users/payment-notification/stripe, then copy its signing secret.',
+        helpUrl: 'https://dashboard.stripe.com/webhooks',
+        required: true,
+        example: 'whsec_...',
+    },
+];
+registerSecrets(stripeSecretDefinitions);
+//# sourceMappingURL=secrets.js.map

package/dist/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,uBAAuB,GAAuB;IACzD;QACE,GAAG,EAAE,mBAAmB;QACxB,WAAW,EACT,0HAA0H;QAC5H,OAAO,EAAE,sCAAsC;QAC/C,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,aAAa;KACvB;IACD;QACE,GAAG,EAAE,uBAAuB;QAC5B,WAAW,EACT,mLAAmL;QACrL,OAAO,EAAE,uCAAuC;QAChD,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,WAAW;KACrB;CACF,CAAA;AAED,eAAe,CAAC,uBAAuB,CAAC,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Type definitions for the Stripe payment provider.
+ *
+ * @module
+ */
+export type { NormalizedPurchase, NormalizedSubscription, PaymentProvider, SubscriptionStatus, } from '@molecule/api-payments';
+/**
+ * Result of creating or retrieving a checkout session.
+ */
+export interface CheckoutSessionResult {
+    id: string;
+    url: string | null;
+    /** The Stripe Subscription ID created by the checkout session, if available. */
+    subscription?: string;
+}
+/**
+ * Normalized subscription data from Stripe.
+ */
+export interface SubscriptionResult {
+    id: string;
+    status: string;
+    /**
+     * The Stripe Customer ID (`cus_...`) that owns this subscription. Used to bind
+     * a verified subscription to the calling user so a foreign subscription id
+     * cannot be claimed (ownership check in `verifyPayment`).
+     */
+    customer?: string;
+    items: {
+        data: Array<{
+            id: string;
+            price?: {
+                id?: string;
+                product?: string;
+            };
+        }>;
+    };
+    current_period_start: number;
+    current_period_end: number;
+    cancel_at_period_end: boolean;
+    canceled_at: number | null;
+}
+/**
+ * Parameters for updating a subscription.
+ */
+export interface SubscriptionUpdateParams {
+    items?: Array<{
+        id: string;
+        price: string;
+    }>;
+    cancel_at_period_end?: boolean;
+}
+/**
+ * Result of verifying a webhook event.
+ */
+export interface WebhookEventResult {
+    type: string;
+    data: {
+        object: Record<string, unknown>;
+    };
+}
+declare global {
+    namespace NodeJS {
+        /**
+         * Process Env interface.
+         */
+        interface ProcessEnv {
+            /**
+             * The key used for Stripe's API.
+             */
+            STRIPE_SECRET_KEY?: string;
+            /**
+             * The Stripe webhook secret for verifying webhook signatures.
+             */
+            STRIPE_WEBHOOK_SECRET?: string;
+        }
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,GACnB,MAAM,wBAAwB,CAAA;AAE/B;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE;QAAE,IAAI,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE;gBAAE,EAAE,CAAC,EAAE,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC,CAAA;KAAE,CAAA;IACjF,oBAAoB,EAAE,MAAM,CAAA;IAC5B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,oBAAoB,EAAE,OAAO,CAAA;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC5C,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;CAC1C;AAED,OAAO,CAAC,MAAM,CAAC;IAEb,UAAU,MAAM,CAAC;QACf;;WAEG;QACH,UAAiB,UAAU;YACzB;;eAEG;YACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;YAE1B;;eAEG;YACH,qBAAqB,CAAC,EAAE,MAAM,CAAA;SAC/B;KACF;CACF"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Type definitions for the Stripe payment provider.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@molecule/api-payments-stripe",
+  "version": "1.0.0",
+  "description": "Stripe payment provider for molecule.dev.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "molecule",
+    "payments",
+    "stripe"
+  ],
+  "license": "Apache-2.0",
+  "dependencies": {
+    "stripe": "22.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "26.1.2",
+    "typescript": "6.0.3",
+    "vitest": "4.1.10"
+  },
+  "peerDependencies": {
+    "@molecule/api-bond": "^1.0.0",
+    "@molecule/api-i18n": "^1.0.0",
+    "@molecule/api-payments": "^1.0.0",
+    "@molecule/api-jwt": "^1.0.0",
+    "@molecule/api-secrets": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@molecule/api-payments": {
+      "optional": true
+    },
+    "@molecule/api-jwt": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/molecule-dev/molecule.git",
+    "directory": "packages/api/bonds/payments/stripe"
+  },
+  "homepage": "https://github.com/molecule-dev/molecule/tree/main/packages/api/bonds/payments/stripe",
+  "bugs": "https://github.com/molecule-dev/molecule/issues",
+  "publishConfig": {
+    "access": "public"
+  }
+}