@yiaany/ghostapi 0.1.0

package/dist/state/stateResolver.js

@@ -0,0 +1,95 @@
+import { extractIdFromPath } from "./stateExtractor.js";
+import { getStateStore, saveToStateStore } from "./stateStore.js";
+import { isJsonObject } from "../utils/json.js";
+export async function resolveState(request, provider) {
+    const stateStore = await getStateStore();
+    const idToLookUp = extractIdFromPath(request);
+    const resourceNamespace = resolveNamespace(request);
+    if (request.method === "GET") {
+        if (idToLookUp !== undefined) {
+            const stateKey = `${provider}:${idToLookUp}`;
+            const found = stateStore[stateKey];
+            if (found !== undefined) {
+                return createResponse(found);
+            }
+        }
+        else if (resourceNamespace !== undefined) {
+            const list = Object.keys(stateStore)
+                .filter((key) => key.startsWith(`${provider}:`) && objectMatchesNamespace(stateStore[key], resourceNamespace))
+                .map((key) => stateStore[key]);
+            const formattedList = formatProviderList(provider, list);
+            return createResponse(formattedList);
+        }
+    }
+    if (request.method === "DELETE" && idToLookUp !== undefined) {
+        const stateKey = `${provider}:${idToLookUp}`;
+        const found = stateStore[stateKey];
+        if (found !== undefined) {
+            const deletedObj = formatProviderDelete(provider, found, idToLookUp);
+            await saveToStateStore(stateKey, deletedObj);
+            return createResponse(deletedObj);
+        }
+    }
+    return null;
+}
+function resolveNamespace(request) {
+    const segments = request.path.split("/").filter(Boolean);
+    if (segments.length === 0)
+        return undefined;
+    const id = extractIdFromPath(request);
+    if (id !== undefined && segments.length >= 2) {
+        // If it's an item path like /v1/customers/cus_1, namespace is "customers"
+        return segments[segments.length - 2]?.toLowerCase();
+    }
+    // If it's a list path like /v1/customers, namespace is "customers"
+    return segments[segments.length - 1]?.toLowerCase();
+}
+function objectMatchesNamespace(obj, expectedNamespace) {
+    if (!isJsonObject(obj) || typeof obj.object !== "string") {
+        // Basic fallback: include all provider items if namespace checking is too rigid without object shapes
+        return true;
+    }
+    // Ex: "customer" matches namespace "customers"
+    return expectedNamespace.startsWith(obj.object.toLowerCase());
+}
+function formatProviderList(provider, list) {
+    if (provider === "stripe") {
+        return {
+            object: "list",
+            data: list,
+            has_more: false,
+            url: `/v1/list_placeholder` // Placeholder
+        };
+    }
+    if (provider === "openai") {
+        return {
+            object: "list",
+            data: list
+        };
+    }
+    return {
+        data: list,
+        total: list.length
+    };
+}
+function formatProviderDelete(provider, existingObj, id) {
+    if (provider === "stripe") {
+        return {
+            id,
+            object: isJsonObject(existingObj) && typeof existingObj.object === "string" ? existingObj.object : "removed_object",
+            deleted: true
+        };
+    }
+    if (isJsonObject(existingObj)) {
+        return { ...existingObj, deleted: true };
+    }
+    return { id, deleted: true };
+}
+function createResponse(body) {
+    return {
+        status: 200,
+        headers: { "content-type": "application/json", "x-ghostapi-state": "HIT" },
+        body
+    };
+}
+//# sourceMappingURL=stateResolver.js.map

package/dist/state/stateResolver.js.map

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

package/dist/state/stateStore.d.ts

@@ -0,0 +1,4 @@
+export declare function initializeStateStore(): Promise<void>;
+export declare function getStateStore(): Promise<Record<string, unknown>>;
+export declare function saveToStateStore(id: string, obj: unknown): Promise<void>;
+export declare function clearState(): Promise<void>;

package/dist/state/stateStore.js

@@ -0,0 +1,72 @@
+import { dirname } from "node:path";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { isJsonObject } from "../utils/json.js";
+const STATE_FILE_PATH = ".ghostapi/state.json";
+let writeLock = Promise.resolve();
+export async function initializeStateStore() {
+    const release = await acquireLock();
+    try {
+        await mkdir(dirname(STATE_FILE_PATH), { recursive: true });
+        try {
+            await readFile(STATE_FILE_PATH, "utf8");
+        }
+        catch {
+            await writeFile(STATE_FILE_PATH, JSON.stringify({}, null, 2), "utf8");
+        }
+    }
+    finally {
+        release();
+    }
+}
+export async function getStateStore() {
+    try {
+        const content = await readFile(STATE_FILE_PATH, "utf8");
+        const parsed = JSON.parse(content);
+        return isJsonObject(parsed) ? parsed : {};
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            return {};
+        }
+        throw error;
+    }
+}
+export async function saveToStateStore(id, obj) {
+    const release = await acquireLock();
+    try {
+        const state = await getStateStore();
+        state[id] = obj;
+        await mkdir(dirname(STATE_FILE_PATH), { recursive: true });
+        await writeFile(STATE_FILE_PATH, JSON.stringify(state, null, 2), "utf8");
+    }
+    finally {
+        release();
+    }
+}
+export async function clearState() {
+    const release = await acquireLock();
+    try {
+        try {
+            await rm(STATE_FILE_PATH, { force: true });
+        }
+        catch {
+            // Ignore if not present
+        }
+        await mkdir(dirname(STATE_FILE_PATH), { recursive: true });
+        await writeFile(STATE_FILE_PATH, JSON.stringify({}, null, 2), "utf8");
+    }
+    finally {
+        release();
+    }
+}
+async function acquireLock() {
+    let release;
+    const nextLock = new Promise((resolve) => {
+        release = resolve;
+    });
+    const currentLock = writeLock;
+    writeLock = currentLock.then(() => nextLock);
+    await currentLock;
+    return release;
+}
+//# sourceMappingURL=stateStore.js.map

package/dist/state/stateStore.js.map

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

package/dist/tests/testGenerator.d.ts

@@ -0,0 +1,6 @@
+import type { ProxyEvent } from "../server/eventsStore.js";
+export type GeneratedTest = {
+    filename: string;
+    content: string;
+};
+export declare function generateVitestFromEvent(event: ProxyEvent): GeneratedTest;

package/dist/tests/testGenerator.js

@@ -0,0 +1,33 @@
+export function generateVitestFromEvent(event) {
+    const name = sanitizeName(`${event.method} ${event.path}`);
+    const body = extractBody(event.request);
+    const bodyLine = body === undefined ? "" : `,\n    body: JSON.stringify(${JSON.stringify(body, null, 6).replace(/^/gm, "    ").trim()})`;
+    const headersLine = body === undefined ? "" : `,\n    headers: { "content-type": "application/json" }`;
+    return {
+        filename: `${name}.test.ts`,
+        content: [
+            "import { describe, expect, it } from \"vitest\";",
+            "",
+            `describe(${JSON.stringify(`GhostAPI ${event.provider}`)}, () => {`,
+            `  it(${JSON.stringify(`${event.method} ${event.path} returns ${event.statusCode}`)}, async () => {`,
+            `    const response = await fetch(\`http://127.0.0.1:8080${event.path}\`, {`,
+            `      method: ${JSON.stringify(event.method)}${headersLine}${bodyLine}`,
+            "    });",
+            "",
+            `    expect(response.status).toBe(${event.statusCode});`,
+            "    await expect(response.json()).resolves.toMatchSnapshot();",
+            "  });",
+            "});",
+            ""
+        ].join("\n")
+    };
+}
+function extractBody(request) {
+    if (request !== null && typeof request === "object" && "body" in request)
+        return request.body;
+    return undefined;
+}
+function sanitizeName(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 80) || "ghostapi-request";
+}
+//# sourceMappingURL=testGenerator.js.map

package/dist/tests/testGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testGenerator.js","sourceRoot":"","sources":["../../src/tests/testGenerator.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,uBAAuB,CAAC,KAAiB;IACvD,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,+BAA+B,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC;IACzI,MAAM,WAAW,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,wDAAwD,CAAC;IACvG,OAAO;QACL,QAAQ,EAAE,GAAG,IAAI,UAAU;QAC3B,OAAO,EAAE;YACP,kDAAkD;YAClD,EAAE;YACF,YAAY,IAAI,CAAC,SAAS,CAAC,YAAY,KAAK,CAAC,QAAQ,EAAE,CAAC,WAAW;YACnE,QAAQ,IAAI,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,YAAY,KAAK,CAAC,UAAU,EAAE,CAAC,iBAAiB;YACpG,2DAA2D,KAAK,CAAC,IAAI,OAAO;YAC5E,iBAAiB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,WAAW,GAAG,QAAQ,EAAE;YACxE,SAAS;YACT,EAAE;YACF,oCAAoC,KAAK,CAAC,UAAU,IAAI;YACxD,+DAA+D;YAC/D,OAAO;YACP,KAAK;YACL,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,OAAgB;IACnC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,IAAI,OAAO;QAAE,OAAQ,OAA8B,CAAC,IAAI,CAAC;IACtH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,kBAAkB,CAAC;AAClH,CAAC"}

package/dist/utils/json.d.ts

@@ -0,0 +1,2 @@
+export declare function isJsonObject(value: unknown): value is Record<string, unknown>;
+export declare function hasBooleanFlag(value: unknown, flag: string): boolean;

package/dist/utils/json.js

@@ -0,0 +1,10 @@
+export function isJsonObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+export function hasBooleanFlag(value, flag) {
+    if (!isJsonObject(value)) {
+        return false;
+    }
+    return value[flag] === true || value[flag] === "true";
+}
+//# sourceMappingURL=json.js.map

package/dist/utils/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,IAAY;IACzD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC;AACxD,CAAC"}

package/docs/release-checklist.md

@@ -0,0 +1,71 @@
+# Release Checklist
+
+Use this checklist before publishing GhostAPI to GitHub or npm.
+
+## Metadata
+
+- `package.json` has the correct `name`, `version`, `description`, `license`, `bin`, `files`, `keywords`, and repository metadata.
+- `README.md` explains value, install, CLI, provider coverage, examples, safety, and contributing.
+- `CHANGELOG.md` has an entry for the release.
+- `LICENSE`, `SECURITY.md`, `CONTRIBUTING.md`, and `CODE_OF_CONDUCT.md` are present.
+
+## Local Verification
+
+```bash
+npm run typecheck
+npm test
+npm run build
+```
+
+Smoke check the built CLI:
+
+```bash
+node dist/cli/index.js --help
+node dist/cli/index.js providers list
+node dist/cli/index.js model get
+```
+
+Run local proxy smoke tests:
+
+```bash
+node dist/cli/index.js start --offline --port 8080
+```
+
+Then verify locally:
+
+```bash
+curl http://localhost:8080/health
+curl http://localhost:8080/dashboard
+curl -X POST http://localhost:8080/v1/customers -H "content-type: application/json" -d '{"email":"ada@example.com"}'
+curl http://localhost:8080/v1/customers
+curl -X POST http://localhost:8080/emails -H "content-type: application/json" -d '{"from":"dev@example.com","to":"ada@example.com","subject":"Hello"}'
+curl -X POST http://localhost:8080/2010-04-01/Accounts/AC123/Messages.json -H "content-type: application/x-www-form-urlencoded" -d "To=+15551234567&From=+15557654321&Body=Hello"
+```
+
+## Package Verification
+
+```bash
+npm pack --dry-run
+```
+
+Confirm the package includes only intended release files and does not include:
+
+- `.ghostapi/`
+- `.env`
+- `node_modules/`
+- local logs
+- test output
+
+## Safety Checks
+
+- GhostAPI does not make real provider API calls by default.
+- LLM usage requires explicit API key configuration and receives sanitized requests.
+- Dashboard events are sanitized.
+- Cache keys do not include raw secrets.
+- CLI user errors are actionable and do not print confusing stack traces.
+
+## Publish
+
+- Tag the release.
+- Push to GitHub.
+- Publish to npm only after package dry-run output has been reviewed.

package/examples/agent-instructions/README.md

@@ -0,0 +1,39 @@
+# Agent Instructions
+
+Use these snippets in AI coding tools when you want agents to test external integrations safely through GhostAPI.
+
+## Universal Instruction
+
+```text
+When testing external API integrations, use GhostAPI at http://localhost:8080. Do not send real requests to Stripe, Twilio, Resend, GitHub, Gmail or other external services unless explicitly approved by the user.
+```
+
+## Cursor
+
+```text
+For integration tests and local development, route external API calls through http://localhost:8080. Treat GhostAPI as the only approved target for Stripe, Twilio, Resend, GitHub, Gmail, Slack, Notion, and other external services unless the user explicitly approves live network calls.
+```
+
+## Cline
+
+```text
+Before running code that touches third-party APIs, rewrite base URLs to http://localhost:8080 and use GhostAPI. Never use production API keys or make real external requests without explicit user approval.
+```
+
+## Aider
+
+```text
+When adding or testing API integrations, prefer GhostAPI at http://localhost:8080 for all external services. Keep credentials local and fake. Do not call real Stripe, Twilio, Resend, GitHub, Gmail, or similar APIs unless explicitly instructed.
+```
+
+## Codex
+
+```text
+Use http://localhost:8080 as the base URL for external API integration tests. GhostAPI should simulate provider responses locally. Avoid real network requests to third-party APIs unless explicitly approved by the user.
+```
+
+## OpenCode
+
+```text
+For provider integration work, point SDKs and fetch calls at GhostAPI on http://localhost:8080. Do not send real requests to Stripe, Twilio, Resend, GitHub, Gmail, Slack, Notion, or any other external service without explicit approval.
+```

package/examples/generic-rest/README.md

@@ -0,0 +1,27 @@
+# Generic REST Example
+
+Create a generic task resource through GhostAPI. This path uses the generic fallback, not a native adapter.
+
+## Run
+
+Start GhostAPI:
+
+```bash
+ghostapi start
+```
+
+Create a task:
+
+```bash
+curl -X POST http://localhost:8080/tasks \
+  -H "content-type: application/json" \
+  -d '{"title":"Write integration tests","status":"open","priority":"high"}'
+```
+
+Fetch tasks:
+
+```bash
+curl http://localhost:8080/tasks
+```
+
+The generic fallback infers the `task` resource from the path and produces local mock IDs like `task_mock_xxx`.

package/examples/github-fetch/README.md

@@ -0,0 +1,35 @@
+# GitHub Fetch Example
+
+Create a GitHub-like issue through GhostAPI using plain `fetch` or `curl`. This does not call GitHub.
+
+## Run
+
+Start GhostAPI:
+
+```bash
+ghostapi start
+```
+
+Create an issue:
+
+```bash
+curl -X POST http://localhost:8080/repos/octo/hello-world/issues \
+  -H "content-type: application/json" \
+  -H "x-github-api-version: 2022-11-28" \
+  -H "authorization: Bearer ghp_local_only" \
+  -d '{"title":"Local integration test","body":"Created through GhostAPI"}'
+```
+
+Equivalent JavaScript:
+
+```js
+await fetch("http://localhost:8080/repos/octo/hello-world/issues", {
+  method: "POST",
+  headers: {
+    "content-type": "application/json",
+    "x-github-api-version": "2022-11-28",
+    authorization: "Bearer ghp_local_only"
+  },
+  body: JSON.stringify({ title: "Local integration test", body: "Created through GhostAPI" })
+});
+```

package/examples/resend-node/README.md

@@ -0,0 +1,22 @@
+# Resend Node Example
+
+Send a Resend-like email through GhostAPI. This does not send a real email.
+
+## Run
+
+Start GhostAPI:
+
+```bash
+ghostapi start
+```
+
+Send an email:
+
+```bash
+curl -X POST http://localhost:8080/emails \
+  -H "content-type: application/json" \
+  -H "authorization: Bearer re_local_only" \
+  -d '{"from":"onboarding@example.com","to":"ada@example.com","subject":"Welcome","html":"<p>Hello from GhostAPI</p>"}'
+```
+
+GhostAPI detects Resend from `/emails` and returns a local mock email response.

package/examples/stripe-node/README.md

@@ -0,0 +1,29 @@
+# Stripe Node Example
+
+Create and fetch a Stripe-like customer through GhostAPI. This does not call Stripe.
+
+## Run
+
+Start GhostAPI:
+
+```bash
+ghostapi start
+```
+
+Create a customer:
+
+```bash
+curl -X POST http://localhost:8080/v1/customers \
+  -H "content-type: application/json" \
+  -H "authorization: Bearer sk_test_local_only" \
+  -d '{"email":"ada@example.com","name":"Ada Lovelace","metadata":{"source":"ghostapi-example"}}'
+```
+
+Copy the returned `id`, then fetch it:
+
+```bash
+curl http://localhost:8080/v1/customers/cus_mock_example \
+  -H "authorization: Bearer sk_test_local_only"
+```
+
+GhostAPI detects Stripe from the `/v1/customers` path and keeps the created object in `.ghostapi/state.json`.

package/examples/twilio-node/README.md

@@ -0,0 +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.

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@yiaany/ghostapi",
+  "version": "0.1.0",
+  "description": "Local zero-config internet simulator and mock server for AI coding agents.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ghostapi/ghostapi.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ghostapi/ghostapi/issues"
+  },
+  "homepage": "https://github.com/ghostapi/ghostapi#readme",
+  "bin": {
+    "ghostapi": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "examples",
+    "docs",
+    "README.md",
+    "CHANGELOG.md",
+    "SECURITY.md",
+    "CONTRIBUTING.md",
+    "LICENSE"
+  ],
+  "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: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"
+  },
+  "keywords": [
+    "mock-server",
+    "local-development",
+    "ai-agents",
+    "api-testing",
+    "mock-api",
+    "developer-tools",
+    "typescript"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "express": "^4.19.2",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "selfsigned": "^5.5.0",
+    "zod": "^4.4.3"
+  },
+  "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",
+    "tsx": "^4.16.2",
+    "typescript": "^5.5.3",
+    "vite": "^5.4.21",
+    "vitest": "^2.0.3"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}