@yiaany/ghostapi 0.1.7 → 0.1.9

package/examples/stripe-node/checkout-flow.mjs

@@ -0,0 +1,61 @@
+import Stripe from "stripe";
+
+const host = process.env.GHOSTAPI_HOST ?? "127.0.0.1";
+const port = Number(process.env.GHOSTAPI_PORT ?? "8080");
+const protocol = process.env.GHOSTAPI_PROTOCOL ?? "http";
+const baseUrl = `${protocol}://${host}:${port}`;
+const webhookSecret = process.env.GHOSTAPI_STRIPE_WEBHOOK_SECRET ?? "whsec_ghostapi_local_test_secret";
+
+const stripe = new Stripe(process.env.STRIPE_SECRET_KEY ?? "sk_test_ghostapi_local_only", {
+  host,
+  port,
+  protocol,
+  apiVersion: "2026-02-25.clover"
+});
+
+const customer = await stripe.customers.create({
+  email: "ada@example.com",
+  name: "Ada Lovelace",
+  metadata: { example: "ghostapi-subscription-flow" }
+});
+
+const product = await stripe.products.create({ name: "GhostAPI Pro" });
+const price = await stripe.prices.create({
+  product: product.id,
+  currency: "usd",
+  unit_amount: 2500,
+  recurring: { interval: "month" }
+});
+
+const subscription = await stripe.subscriptions.create({
+  customer: customer.id,
+  items: [{ price: price.id }],
+  trial_period_days: 7
+});
+
+// The renewal action is a GhostAPI local test control, not a live Stripe endpoint.
+const renewalResponse = await fetch(`${baseUrl}/v1/subscriptions/${subscription.id}/renew`, {
+  method: "POST",
+  headers: { "content-type": "application/json" },
+  body: JSON.stringify({})
+});
+const renewed = await renewalResponse.json();
+
+const events = await stripe.events.list({ limit: 20 });
+const event = events.data.find((candidate) => candidate.type === "invoice.payment_succeeded");
+if (event === undefined) throw new Error("Expected a local invoice.payment_succeeded webhook event.");
+
+const delivery = await fetch(`${baseUrl}/v1/events/${event.id}/deliver?delivery_mode=duplicate`);
+const payload = await delivery.text();
+const signature = delivery.headers.get("stripe-signature");
+if (signature === null) throw new Error("GhostAPI webhook delivery did not include stripe-signature.");
+const verifiedEvent = stripe.webhooks.constructEvent(payload, signature, webhookSecret);
+
+console.log(JSON.stringify({
+  customer: customer.id,
+  product: product.id,
+  price: price.id,
+  trialSubscription: subscription.id,
+  renewedSubscription: renewed.id,
+  verifiedWebhook: { id: verifiedEvent.id, type: verifiedEvent.type }
+}, null, 2));

package/examples/twilio-node/README.md

@@ -1,21 +1,21 @@
-# Twilio Node Example
-
-Send a Twilio-like SMS through GhostAPI. This does not send a real SMS.
-
-## Run
-
-Start GhostAPI:
-
-```bash
-ghostapi start
-```
-
-Send a message:
-
-```bash
-curl -X POST http://localhost:8080/2010-04-01/Accounts/AC_mock/Messages.json \
-  -H "content-type: application/x-www-form-urlencoded" \
-  -d "To=+15551234567&From=+15557654321&Body=Hello%20from%20GhostAPI"
-```
-
-GhostAPI detects Twilio from the `/2010-04-01/Accounts/...` path and returns a local message SID.
+# Twilio Node Example
+
+Send a Twilio-like SMS through GhostAPI. This does not send a real SMS.
+
+## Run
+
+Start GhostAPI:
+
+```bash
+ghostapi start
+```
+
+Send a message:
+
+```bash
+curl -X POST http://localhost:8080/2010-04-01/Accounts/AC_mock/Messages.json \
+  -H "content-type: application/x-www-form-urlencoded" \
+  -d "To=+15551234567&From=+15557654321&Body=Hello%20from%20GhostAPI"
+```
+
+GhostAPI detects Twilio from the `/2010-04-01/Accounts/...` path and returns a local message SID.

package/examples/worlds/README.md

@@ -0,0 +1,19 @@
+# Stateful Synthetic World Example
+
+This local-only workflow keeps one synthetic persona and organization consistent across Stripe, GitHub, email, and generic REST state.
+
+```bash
+ghostapi world create --id subscription-recovery --seed demo-seed
+npm run build
+node examples/worlds/subscription-recovery.mjs
+ghostapi world inspect subscription-recovery --json
+```
+
+The workflow atomically creates a Stripe customer and past-due subscription, records a generic REST payment failure, sends a synthetic email to a `ghostapi.invalid` inbox, and opens a synthetic GitHub recovery issue. Re-running the same action is idempotent. Reset and fork remain local:
+
+```bash
+ghostapi world reset subscription-recovery
+ghostapi world fork subscription-recovery --id subscription-recovery-investigation
+```
+
+Worlds are local JSON under `.ghostapi/worlds/`. They are bounded to 512 KiB and 100 workflow receipts, use one file lock plus atomic replacement for each transition, and intentionally do not call provider APIs or contain real credentials, inboxes, or PII.

package/examples/worlds/subscription-recovery.mjs

@@ -0,0 +1,12 @@
+import { runSubscriptionFailureWorkflow } from "../../dist/index.js";
+
+const worldId = process.env.GHOSTAPI_WORLD_ID ?? "subscription-recovery";
+const receipt = await runSubscriptionFailureWorkflow(worldId, "subscription-payment-failed");
+
+console.log(JSON.stringify({
+  customerId: receipt.customerId,
+  subscriptionId: receipt.subscriptionId,
+  emailId: receipt.emailId,
+  githubIssue: receipt.issueNumber,
+  genericRestFailureId: receipt.genericFailureId
+}, null, 2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yiaany/ghostapi",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "The local internet for AI coding agents.",
   "type": "module",
   "repository": {
@@ -10,7 +10,17 @@
   "bugs": {
     "url": "https://github.com/yiaany/ghostapi/issues"
   },
-  "homepage": "https://github.com/yiaany/ghostweb#readme",
+  "homepage": "https://github.com/yiaany/ghostapi#readme",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "bin": {
     "ghostapi": "dist/cli/index.js"
   },
@@ -26,11 +36,14 @@
   ],
   "scripts": {
     "dev": "tsx src/cli/index.ts start",
-    "build": "tsc -p tsconfig.json && vite build --config vite.landing.config.ts && npm run build:static",
+    "build": "tsc -p tsconfig.json && npm run build:static",
     "build:static": "node -e \"const {cpSync, mkdirSync} = require('fs'); mkdirSync('dist/dashboard', {recursive:true}); cpSync('src/dashboard/index.html', 'dist/dashboard/index.html'); cpSync('src/dashboard/styles.css', 'dist/dashboard/styles.css'); cpSync('src/dashboard/app.js', 'dist/dashboard/app.js');\"",
     "start": "node dist/cli/index.js start",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run"
+    "test": "vitest run",
+    "smoke:package": "node scripts/package-smoke.mjs",
+    "lint": "npm run format:check",
+    "format:check": "prettier --check package.json tsconfig.json vitest.config.ts scripts/package-smoke.mjs test/dashboardAssets.test.ts"
   },
   "keywords": [
     "mcp",
@@ -49,23 +62,25 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@modelcontextprotocol/sdk": "^1.30.0",
     "express": "^4.19.2",
     "selfsigned": "^5.5.0",
+    "yaml": "2.9.0",
     "zod": "^4.4.3"
   },
+  "overrides": {
+    "@hono/node-server": "2.1.0",
+    "fast-uri": "3.1.5",
+    "hono": "4.13.0",
+    "ip-address": "10.4.0"
+  },
   "devDependencies": {
     "@types/express": "^4.17.21",
     "@types/node": "^20.14.10",
-    "@types/react": "^19.2.7",
-    "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^4.7.0",
-    "react": "^19.2.3",
-    "react-dom": "^19.2.3",
+    "prettier": "^3.9.6",
     "tsx": "^4.16.2",
     "typescript": "^5.5.3",
-    "vite": "^5.4.21",
-    "vitest": "^2.0.3"
+    "vitest": "^4.1.11"
   },
   "engines": {
     "node": ">=20"

package/dist/providers/stripe.d.ts

@@ -1,2 +0,0 @@
-import type { ProviderAdapter } from "./types.js";
-export declare const stripeAdapter: ProviderAdapter;

package/dist/providers/stripe.js

@@ -1,15 +0,0 @@
-export const stripeAdapter = {
-    name: "stripe",
-    displayName: "Stripe",
-    formatError(details) {
-        return {
-            error: {
-                type: details.type ?? "invalid_request_error",
-                message: details.message,
-                code: typeof details.code === "string" ? details.code : "parameter_missing",
-                param: details.param ?? "unknown"
-            }
-        };
-    }
-};
-//# sourceMappingURL=stripe.js.map

package/dist/providers/stripe.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stripe.js","sourceRoot":"","sources":["../../src/providers/stripe.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAoB;IAC5C,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,QAAQ;IACrB,WAAW,CAAC,OAA6B;QACvC,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,uBAAuB;gBAC7C,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,IAAI,EAAE,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB;gBAC3E,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;aAClC;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}