create-tollstile 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Paradigm AI Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { basename, resolve } from "path";
+import process from "process";
+
+// src/scaffold.ts
+import { mkdir, readdir, writeFile } from "fs/promises";
+import { dirname, join } from "path";
+
+// src/templates.ts
+function honoTemplate(name2) {
+  return [
+    {
+      path: "package.json",
+      contents: `${JSON.stringify(
+        {
+          name: name2,
+          private: true,
+          type: "module",
+          scripts: {
+            dev: "tsx watch src/server.ts",
+            agent: "tsx src/agent.ts"
+          },
+          dependencies: {
+            "@hono/node-server": "^1.13.0",
+            "@tollstile/hono": "^0.1.0",
+            hono: "^4.6.0",
+            tollstile: "^0.1.0"
+          },
+          devDependencies: {
+            "@types/node": "^22.0.0",
+            tsx: "^4.19.0",
+            typescript: "^5.9.0"
+          }
+        },
+        null,
+        2
+      )}
+`
+    },
+    {
+      path: "tsconfig.json",
+      contents: `${JSON.stringify(
+        {
+          compilerOptions: {
+            target: "ES2022",
+            module: "NodeNext",
+            moduleResolution: "NodeNext",
+            strict: true,
+            skipLibCheck: true,
+            noEmit: true
+          },
+          include: ["src"]
+        },
+        null,
+        2
+      )}
+`
+    },
+    {
+      path: "src/toll.ts",
+      contents: `import { createTollstile, memoryLedger, testRail } from "tollstile";
+
+// The test rail runs the whole payment lifecycle locally: no wallet, network, or account.
+// Swap in real rails (x402, MPP, \u2026) and a database ledger when you deploy.
+export const toll = createTollstile({
+  rails: [testRail()],
+  ledger: memoryLedger(),
+});
+`
+    },
+    {
+      path: "src/server.ts",
+      contents: `import { serve } from "@hono/node-server";
+import { tollstile } from "@tollstile/hono";
+import { Hono } from "hono";
+import { toll } from "./toll.js";
+
+const app = new Hono();
+
+app.get("/", (c) => c.text("GET /weather costs $0.01. Run \`npm run agent\` to pay for it."));
+
+app.get("/weather", tollstile(toll.price("$0.01")), (c) => {
+  return c.json({ forecast: "clear", paidWith: c.get("payment").via });
+});
+
+serve({ fetch: app.fetch, port: 3000 }, ({ port }) => {
+  console.log(\`Paid API listening on http://localhost:\${port}/weather\`);
+  console.log("In another terminal, run: npm run agent");
+});
+`
+    },
+    {
+      path: "src/agent.ts",
+      contents: `// A tiny agent that meets a 402, pays with the test rail, and gets through.
+const url = process.argv[2] ?? "http://localhost:3000/weather";
+
+type Challenge = { price: string; accepts: { rail: string }[] };
+
+console.log(\`\u2192 GET \${url}\`);
+const unpaid = await fetch(url);
+console.log(\`\u2190 \${unpaid.status} \${unpaid.statusText}\`);
+
+if (unpaid.status !== 402) {
+  console.log("Expected 402 Payment Required. Is the server running?");
+  process.exit(1);
+}
+
+const challenge = (await unpaid.json()) as Challenge;
+console.log(\`  price \${challenge.price} \xB7 rails \${challenge.accepts.map((offer) => offer.rail).join(", ")}\`);
+
+// An Idempotency-Key makes the paid request safe to retry: a retry is never paid or run twice.
+console.log(\`\u2192 GET \${url}  (Payment: test, Idempotency-Key)\`);
+const paid = await fetch(url, { headers: { payment: "test", "idempotency-key": crypto.randomUUID() } });
+console.log(\`\u2190 \${paid.status} \${paid.statusText}\`);
+console.log(\`  receipt \${paid.headers.get("payment-receipt") ?? "none"}\`);
+console.log(\`  \${await paid.text()}\`);
+`
+    },
+    {
+      path: "README.md",
+      contents: `# ${name2}
+
+A paid API built with [Tollstile](https://tollstile.com).
+
+\`\`\`bash
+npm install
+npm run dev     # starts the API on :3000
+npm run agent   # in another terminal: 402, pay, 200
+\`\`\`
+
+- \`src/toll.ts\` \u2014 rails and ledger.
+- \`src/server.ts\` \u2014 \`GET /weather\` costs $0.01.
+- \`src/agent.ts\` \u2014 a test agent that pays with the test rail.
+
+Next: read the [quickstart](https://tollstile.com/docs/quickstart) and replace the test rail with a real one.
+`
+    },
+    {
+      path: ".gitignore",
+      contents: "node_modules\n.env\n"
+    }
+  ];
+}
+
+// src/scaffold.ts
+var PACKAGE_NAME = /^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
+async function scaffold(directory2, name2) {
+  if (!PACKAGE_NAME.test(name2)) {
+    return { status: "invalid_name", reason: `"${name2}" is not a valid npm package name. Use lowercase letters, digits, and dashes.` };
+  }
+  if ((await listDirectory(directory2)).length > 0) return { status: "not_empty" };
+  const files = honoTemplate(name2);
+  for (const file of files) {
+    const target2 = join(directory2, file.path);
+    await mkdir(dirname(target2), { recursive: true });
+    await writeFile(target2, file.contents, { flag: "wx" });
+  }
+  return { status: "created", files: files.map((file) => file.path) };
+}
+async function listDirectory(directory2) {
+  await mkdir(directory2, { recursive: true });
+  return readdir(directory2);
+}
+
+// src/index.ts
+var target = process.argv[2] ?? "my-paid-api";
+var directory = resolve(process.cwd(), target);
+var name = basename(directory);
+var result = await scaffold(directory, name);
+switch (result.status) {
+  case "invalid_name":
+    console.error(result.reason);
+    process.exitCode = 1;
+    break;
+  case "not_empty":
+    console.error(`${target} already exists and is not empty. Choose another directory name.`);
+    process.exitCode = 1;
+    break;
+  case "created": {
+    const runner = packageManager();
+    console.log(`
+Created ${name} with a paid route and a test agent.
+`);
+    console.log(`  cd ${target}`);
+    console.log(`  ${runner} install`);
+    console.log(`  ${runner} run dev`);
+    console.log(`  ${runner} run agent   # in another terminal
+`);
+    break;
+  }
+}
+function packageManager() {
+  const agent = process.env.npm_config_user_agent ?? "";
+  if (agent.startsWith("pnpm")) return "pnpm";
+  if (agent.startsWith("yarn")) return "yarn";
+  if (agent.startsWith("bun")) return "bun";
+  return "npm";
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "create-tollstile",
+  "version": "0.1.1",
+  "description": "Create a paid API in one command: a Hono server with pay-per-call pricing, a test payment rail, and an agent that pays for it.",
+  "keywords": [
+    "create",
+    "scaffold",
+    "starter",
+    "paid-api",
+    "x402",
+    "agent-payments",
+    "api-monetization",
+    "pay-per-call",
+    "mcp"
+  ],
+  "homepage": "https://tollstile.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tollstile/tollstile.git",
+    "directory": "packages/create-tollstile"
+  },
+  "bugs": {
+    "url": "https://github.com/tollstile/tollstile/issues"
+  },
+  "author": "Paradigm AI Inc.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "create-tollstile": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc -p tsconfig.json"
+  }
+}