@volter/twin-stripe 3.0.1 → 3.0.2

package/README.md

@@ -3,7 +3,31 @@
 A local Stripe: the REST API the unmodified `stripe` SDK calls (`https://api.stripe.com/v1`), the hosted pages an
 application sends a person through, and Stripe.js, over one state.
 
-A Protocol 3 pack (twin-world's docs/contributing/architecture.md, "Protocol 3: the derived pack"). Its surface is
+## Use with an existing app
+
+In an app that already uses this vendor, install this exact release and the product CLI:
+
+```console
+npm install --save-dev --save-exact @volter/world@3.0.68 @volter/twin-stripe@3.0.2
+npx volter world init --name my-app --twins stripe --source stripe=@volter/twin-stripe
+```
+
+Review the detected vendor and generated bindings before booting. Read the credential names and limitations below; the World supplies throwaway credentials. Then run your app's own command through the World:
+
+```console
+npx volter world up
+npx volter world run -- npm test
+npx volter world log
+npx volter world down
+```
+
+Here `npm test` is your app's existing command; replace it with your app or test command. `down` retains state.
+A later `up` resumes it; do not reset or initialize again merely to return.
+
+Publisher and catalog contribution instructions: [the public publisher guide](https://github.com/volter-ai/twin-catalog-open/blob/main/docs/contributing.md).
+
+
+A Protocol 3 pack ([publisher guide](https://github.com/volter-ai/twin-catalog-open/blob/main/docs/contributing.md)). Its surface is
 generated from Stripe's published OpenAPI document (`spec/`). The derived core serves plain reads, writes and deletes.
 Handlers are in `src/semantics/<family>.ts`, the state machines in `src/semantics/states.ts`, and Stripe's own
 computation (money and declines, billing, the ledger, the API versions) in `src/engine/`.

package/dist/src/screens/dashboard.js

@@ -67,6 +67,10 @@ async function publicDetails(ctx) {
 /** Dashboard settings, Radar list creation and test Issuing funding; other pages answer Stripe's 404. */
 export async function screen(ctx) {
     const path = new URL(ctx.call.request.url).pathname.replace(/\/+$/, '');
+    // The twin's declared workspace entry opens its implemented Public details page; this authored choice does not
+    // reproduce Stripe's Dashboard home. The request's public base retains the World mount when the console frames it.
+    if (path === '' && ['GET', 'HEAD'].includes(ctx.call.request.method))
+        return redirect(`${ctx.publicBase}${PUBLIC_DETAILS_PATH}`);
     // source: https://docs.stripe.com/radar/lists "Use the Dashboard or the API to create lists."
     // source: https://docs.stripe.com/radar/lists "Enter a name for the list"
     // source: https://docs.stripe.com/radar/lists "Select the type of list to create."

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/twin-stripe",
-  "version": "3.0.1",
-  "description": "Local Stripe twin — a faithful, stateful local Stripe API your real `stripe` SDK talks to unmodified, its hosted pages and Stripe.js. Built on @volter/world-core.",
+  "version": "3.0.2",
+  "description": "Local Stripe customer, checkout and billing workflows with synthetic state and the real Stripe SDK. Supported operations and hosted-page limits are documented in the README.",
   "keywords": [
     "twin",
     "local",
@@ -34,27 +34,24 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/volter-ai/twin-packs-p3.git",
+    "url": "git+https://github.com/volter-ai/twin-packs-open.git",
     "directory": "stripe"
   },
-  "homepage": "https://github.com/volter-ai/twin-packs-p3/tree/main/stripe#readme",
+  "homepage": "https://github.com/volter-ai/twin-packs-open/tree/main/stripe#readme",
   "type": "module",
   "exports": {
-    ".": {
-      "types": "./dist/src/index.d.ts",
-      "default": "./dist/src/index.js"
-    }
+    ".": "./dist/src/index.js"
   },
   "bin": {
     "world-stripe": "dist/src/cli.js"
   },
   "dependencies": {
-    "@volter/world-ui": "^1.0.38",
+    "@volter/world-ui": "^1.0.65",
     "react": "^19.2.7",
     "react-dom": "^19.2.7"
   },
   "peerDependencies": {
-    "@volter/world-core": "^3.0.38"
+    "@volter/world-core": "^3.0.68"
   },
   "devDependencies": {
     "@types/bun": "^1.2.20",
@@ -66,5 +63,8 @@
   },
   "engines": {
     "node": ">=22.3"
+  },
+  "bugs": {
+    "url": "https://github.com/volter-ai/twin-packs-open/issues"
   }
 }

package/src/screens/dashboard.tsx

@@ -130,6 +130,9 @@ async function publicDetails(ctx: HandlerContext): Promise<Response> {
 /** Dashboard settings, Radar list creation and test Issuing funding; other pages answer Stripe's 404. */
 export async function screen(ctx: HandlerContext): Promise<Response> {
   const path = new URL(ctx.call.request.url).pathname.replace(/\/+$/, '');
+  // The twin's declared workspace entry opens its implemented Public details page; this authored choice does not
+  // reproduce Stripe's Dashboard home. The request's public base retains the World mount when the console frames it.
+  if (path === '' && ['GET', 'HEAD'].includes(ctx.call.request.method)) return redirect(`${ctx.publicBase}${PUBLIC_DETAILS_PATH}`);
   // source: https://docs.stripe.com/radar/lists "Use the Dashboard or the API to create lists."
   // source: https://docs.stripe.com/radar/lists "Enter a name for the list"
   // source: https://docs.stripe.com/radar/lists "Select the type of list to create."
@@ -175,4 +178,3 @@ export async function screen(ctx: HandlerContext): Promise<Response> {
   }
   return path === PUBLIC_DETAILS_PATH ? publicDetails(ctx) : notFound();
 }
-

package/dist/generated/pack-facts.json

@@ -1,94 +0,0 @@
-{
-  "//": "GENERATED by scripts/pack-facts.ts — current pack descriptors and explicit world-runtime server backings; no prior-artifact entries are retained.",
-  "packs": {
-    "stripe": {
-      "adoption": {
-        "pypi": [
-          "stripe"
-        ],
-        "sdks": [
-          "stripe"
-        ],
-        "envStems": [
-          "STRIPE",
-          "NEXTPRIVATESTRIPE"
-        ]
-      },
-      "hosts": [
-        {
-          "host": "api.stripe.com"
-        },
-        {
-          "host": "checkout.stripe.com",
-          "pathPattern": "^/c/pay/"
-        },
-        {
-          "host": "billing.stripe.com",
-          "pathPattern": "^/p/session/"
-        },
-        {
-          "host": "connect.stripe.com",
-          "pathPattern": "^/setup/"
-        },
-        {
-          "host": "dashboard.stripe.com",
-          "pathPattern": "^/radar/lists(?:/[^/]+)?/?$|^/test/issuing/balance/?$|^/settings/public/?$"
-        },
-        {
-          "host": "verify.stripe.com",
-          "pathPattern": "^/start/"
-        },
-        {
-          "host": "js.stripe.com",
-          "pathPattern": "^/v3/?$|^/(v3|[a-z]+)/stripe\\.js$"
-        }
-      ],
-      "archetype": "crud",
-      "protocol": {
-        "declared": "3",
-        "major": 3,
-        "standing": "current"
-      },
-      "transport": "rest",
-      "resources": [
-        "charge",
-        "customer",
-        "payment_intent",
-        "setup_intent",
-        "payment_method",
-        "subscription",
-        "price",
-        "product",
-        "invoice",
-        "invoiceitem",
-        "refund",
-        "event"
-      ],
-      "credentialDoor": {
-        "path": "/_twin/app-credentials",
-        "body": {},
-        "fill": {
-          "STRIPE_SECRET_KEY": "secret_key",
-          "STRIPE_API_KEY": "secret_key",
-          "STRIPE_PRIVATE_KEY": "secret_key",
-          "BILLING_STRIPE_API_KEY": "secret_key",
-          "STRIPE_PUBLISHABLE_KEY": "publishable_key",
-          "NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY": "publishable_key",
-          "NEXT_PUBLIC_STRIPE_PUBLIC_KEY": "publishable_key",
-          "NEXT_PUBLIC_STRIPE_KEY": "publishable_key",
-          "STRIPE_WEBHOOK_SECRET": "webhook_secret",
-          "STRIPE_WEBHOOK_SIGNING_SECRET": "webhook_secret",
-          "STRIPE_ENDPOINT_SECRET": "webhook_secret",
-          "STRIPE_WEBHOOK_SECRET_KEY": "webhook_secret",
-          "NEXT_PRIVATE_STRIPE_WEBHOOK_SECRET": "webhook_secret",
-          "BILLING_STRIPE_WEBHOOK_SECRET": "webhook_secret",
-          "STRIPE_CONNECT_WEBHOOK_SECRET": "connect_webhook_secret",
-          "STRIPE_WEBHOOK_SECRET_CONNECT": "connect_webhook_secret",
-          "STRIPE_CONNECT_WEBHOOK_SIGNING_SECRET": "connect_webhook_secret"
-        }
-      },
-      "serveExport": "createStripeTwinServer"
-    }
-  },
-  "undeclared": []
-}