@tangle-network/starter-foundry 0.5.3 → 0.7.0

package/registry/families/bun-http/manifest.json

@@ -0,0 +1,163 @@
+{
+  "id": "bun-http",
+  "description": "Bun HTTP API starter using Bun.serve() \u2014 zero-transpile TS, native Bun runtime, instant cold start.",
+  "tags": [
+    "bun",
+    "api",
+    "backend",
+    "typescript"
+  ],
+  "taxonomy": {
+    "language": "typescript",
+    "runtime": "bun",
+    "surface": "api"
+  },
+  "slots": {
+    "database": {
+      "options": [
+        "database:sqlite",
+        "database:postgres",
+        "database:mongodb",
+        "database:convex"
+      ],
+      "default": "database:sqlite"
+    },
+    "auth": {
+      "options": [
+        "auth:none",
+        "auth:better-auth",
+        "auth:clerk"
+      ],
+      "default": "auth:none"
+    },
+    "payments": {
+      "options": [
+        "payments:none",
+        "payments:stripe"
+      ],
+      "default": "payments:none"
+    },
+    "queue": {
+      "options": [
+        "queue:none",
+        "queue:bullmq",
+        "queue:trigger-dev"
+      ],
+      "default": "queue:none"
+    }
+  },
+  "defaults": {
+    "projectType": "api",
+    "serviceName": "starter-foundry-bun",
+    "port": 8095,
+    "databaseProvider": "sqlite"
+  },
+  "files": [
+    {
+      "source": "files/package.json",
+      "target": "package.json"
+    },
+    {
+      "source": "files/tsconfig.json",
+      "target": "tsconfig.json"
+    },
+    {
+      "source": "files/bunfig.toml",
+      "target": "bunfig.toml"
+    },
+    {
+      "source": "files/validate-bun.mjs",
+      "target": "validate-bun.mjs"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "src/server.ts"
+    },
+    {
+      "type": "file-exists",
+      "path": "package.json"
+    },
+    {
+      "type": "command-success",
+      "command": [
+        "node",
+        "validate-bun.mjs"
+      ],
+      "expect": "bun starter ok"
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "bun install",
+      "bun run dev",
+      "bun test"
+    ],
+    "entrypoints": [
+      "src/server.ts",
+      "src/handlers.ts",
+      "package.json"
+    ],
+    "preview": {
+      "path": "/health"
+    },
+    "extensionPoints": [
+      "database-config.json",
+      "auth-config.json",
+      "payments-config.json",
+      "queue-config.json"
+    ]
+  },
+  "keywords": [
+    "bun",
+    "bun.js",
+    "bunjs",
+    "bun runtime",
+    "bun http",
+    "bun.serve",
+    "bun api"
+  ],
+  "scoring": {
+    "boost": {
+      "bun": 3
+    }
+  },
+  "tieredKeywords": {
+    "tier1": [
+      "bun",
+      "bun.serve",
+      "bun runtime"
+    ],
+    "tier2": [
+      "bun api",
+      "bun http",
+      "bun.js"
+    ]
+  },
+  "buildHints": {
+    "whenToUse": "Bun-native HTTP server. Measurably faster cold-start + throughput than Node for small APIs.",
+    "firstSteps": [
+      "Install deps with `bun install` \u2014 NOT `pnpm install`. Bun has its own lockfile (bun.lockb) and resolution.",
+      "Run the dev server with `bun run dev` (hot-reload via --watch). Don't use nodemon / tsx / ts-node \u2014 Bun runs TypeScript directly.",
+      "Tests use Bun's built-in runner: `bun test`. Do NOT add vitest/jest \u2014 Bun's runner is Jest-API-compatible and ships zero-config.",
+      "Extend `src/handlers.ts` \u2014 add new routes to the `routes` map. Handlers are Request \u2192 Response; Bun.serve invokes them per request.",
+      "Env vars: `process.env` OR `Bun.env` (both work). `.env` files auto-load under `bun run`."
+    ],
+    "gotchas": [
+      "Do NOT run `pnpm add` / `npm install` to add deps. Use `bun add <pkg>`. Mixing package managers corrupts node_modules symlink resolution.",
+      "TypeScript types are auto-stripped \u2014 no tsc step. If CI needs real type-checking, add `bun tsc --noEmit` explicitly.",
+      "Bun's Node compat layer is not 100% \u2014 cluster/worker_threads/fs-native APIs that wrap libuv primitives may differ."
+    ],
+    "architectureNotes": [
+      "Bun.serve returns a Server with `port` and `hostname` \u2014 bind it at module scope; don't call it from within a handler.",
+      "Request/Response are standard Fetch API \u2014 handlers are portable to Cloudflare Workers, Deno, fetch-based edge runtimes."
+    ],
+    "placeholders": [
+      {
+        "path": "src/handlers.ts",
+        "description": "Default routes map with just `/health`. Add the product's endpoints here \u2014 each route is `(Request) => Response | Promise<Response>`."
+      }
+    ]
+  }
+}

package/registry/families/celestia-da/files/README.md

@@ -0,0 +1,53 @@
+# {{serviceName}}
+
+Celestia data-availability starter. Runs a **light node** against the `{{celestiaNetwork}}` testnet via docker-compose, plus a Go client that submits and retrieves blobs through the node's JSON-RPC interface.
+
+## What Celestia gives you
+
+A blob is arbitrary bytes committed under a 29-byte **namespace**. Once included in a Celestia block, any observer can retrieve it by `(height, namespace, commitment)` — that's the DA guarantee. Rollups use this as their DA layer instead of posting calldata to Ethereum L1.
+
+## Architecture
+
+```
+┌─────────────────┐    JSON-RPC     ┌──────────────────────┐     P2P     ┌────────────────┐
+│ client/main.go  │  ─────────────> │ celestia-node:light  │  <────────> │  Celestia net  │
+│  - Submit blob  │   (port {{rpcPort}})  │  (docker-compose)    │             │   ({{celestiaNetwork}})      │
+│  - Retrieve blob│                 │                      │             │                │
+└─────────────────┘                 └──────────────────────┘             └────────────────┘
+```
+
+## Prereqs
+
+- Docker (for the light node)
+- Go 1.22+ (for the client)
+
+## Quick start
+
+```bash
+# 1. Start the light node (first run syncs headers — takes a minute or two)
+docker compose up -d
+docker compose logs -f node   # watch sync progress; stop with Ctrl+C
+
+# 2. Grab the auth token from inside the container (needed by the RPC)
+export CELESTIA_NODE_AUTH_TOKEN=$(docker compose exec node celestia light auth admin --p2p.network {{celestiaNetwork}})
+
+# 3. Submit a blob and retrieve it back in one round-trip
+go run ./client
+```
+
+Or use the shell script for a CLI-only round-trip:
+
+```bash
+bash submit-blob.sh "hello celestia"
+```
+
+## Namespace
+
+This starter uses namespace `{{namespaceHex}}`. In production you pick a unique 10-byte namespace per application (the first 19 bytes are reserved/zero, the last 10 are yours).
+
+## Notes
+
+- **Light-node mode** verifies data-availability via DAS (data-availability sampling) — it does NOT download full blocks. Great for clients, wrong for indexers.
+- **Namespaced Merkle proofs** are how you prove a blob is in a block without needing the full block. The `blob.Get` RPC returns the proof.
+- **Finality**: a blob is "available" once its block has enough signatures. For Mocha testnet this is ~12 seconds.
+- **Pay-for-blob**: submitting a blob spends TIA. Fund your light node's address with the faucet before submitting: https://faucet.celestia-mocha.com/

package/registry/families/celestia-da/files/validate-celestia.mjs

@@ -0,0 +1,43 @@
+import fs from "node:fs/promises";
+
+const [compose, config, submit, client, gomod] = await Promise.all([
+  fs.readFile("docker-compose.yml", "utf8"),
+  fs.readFile("config.toml", "utf8"),
+  fs.readFile("submit-blob.sh", "utf8"),
+  fs.readFile("client/main.go", "utf8"),
+  fs.readFile("go.mod", "utf8"),
+]);
+
+if (!compose.includes("ghcr.io/celestiaorg/celestia-node")) {
+  throw new Error("docker-compose.yml missing celestia-node image");
+}
+
+if (!compose.includes("light")) {
+  throw new Error("docker-compose.yml should run the light-node mode by default");
+}
+
+if (!config.includes("RPC")) {
+  throw new Error("config.toml missing [RPC] section");
+}
+
+if (!submit.includes("blob.Submit") && !submit.includes("state.SubmitPayForBlob") && !submit.includes("blob submit")) {
+  throw new Error("submit-blob.sh missing celestia blob submit incantation");
+}
+
+if (!client.includes("package main") || !client.includes("func main")) {
+  throw new Error("client/main.go missing main entrypoint");
+}
+
+if (!client.includes("blob.Submit") && !client.includes("/blob/submit")) {
+  throw new Error("client/main.go missing blob submit call to Celestia RPC");
+}
+
+if (!client.includes("blob.GetAll") && !client.includes("/blob/get_all")) {
+  throw new Error("client/main.go missing blob retrieval call");
+}
+
+if (!gomod.includes("module {{packageName}}")) {
+  throw new Error("go.mod missing expected module path");
+}
+
+console.log("celestia starter ok");

package/registry/families/celestia-da/manifest.json

@@ -0,0 +1,117 @@
+{
+  "id": "celestia-da",
+  "description": "Celestia data-availability starter — light-node docker-compose, Go client that submits and retrieves blobs via the RPC.",
+  "tags": [
+    "celestia",
+    "data-availability",
+    "da-layer",
+    "go",
+    "crypto"
+  ],
+  "taxonomy": {
+    "language": "go",
+    "runtime": "go",
+    "surface": "api"
+  },
+  "defaults": {
+    "projectType": "api",
+    "serviceName": "starter-foundry-celestia",
+    "celestiaNetwork": "mocha",
+    "namespaceHex": "0000000000000000000000000000000000000000000000000000deadbeef",
+    "rpcPort": 26658,
+    "nodeImageTag": "v0.21.0-mocha"
+  },
+  "files": [
+    {
+      "source": "files/validate-celestia.mjs",
+      "target": "validate-celestia.mjs"
+    },
+    {
+      "source": "files/README.md",
+      "target": "README.md"
+    },
+    {
+      "source": "files/.gitignore",
+      "target": ".gitignore"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "docker-compose.yml"
+    },
+    {
+      "type": "file-exists",
+      "path": "config.toml"
+    },
+    {
+      "type": "file-exists",
+      "path": "submit-blob.sh"
+    },
+    {
+      "type": "file-exists",
+      "path": "client/main.go"
+    },
+    {
+      "type": "file-exists",
+      "path": "go.mod"
+    },
+    {
+      "type": "command-success",
+      "command": [
+        "node",
+        "validate-celestia.mjs"
+      ],
+      "expect": "celestia starter ok"
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "docker compose up -d",
+      "bash submit-blob.sh \"hello celestia\"",
+      "go run ./client"
+    ],
+    "entrypoints": [
+      "docker-compose.yml",
+      "config.toml",
+      "submit-blob.sh",
+      "client/main.go"
+    ],
+    "preview": null,
+    "extensionPoints": [
+      "client/main.go",
+      "config.toml",
+      "docker-compose.yml"
+    ]
+  },
+  "keywords": [
+    "celestia",
+    "data availability",
+    "da layer",
+    "blobstream",
+    "celestia light node",
+    "celestia blob",
+    "modular blockchain",
+    "sovereign rollup"
+  ],
+  "scoring": {
+    "boost": {
+      "celestia": 4
+    }
+  },
+  "tieredKeywords": {
+    "tier1": [
+      "celestia",
+      "celestia blob",
+      "celestia light node",
+      "data availability",
+      "da layer"
+    ],
+    "tier2": [
+      "blobstream",
+      "modular blockchain",
+      "sovereign rollup",
+      "namespace commitment"
+    ]
+  }
+}

package/registry/families/cli-ts/files/package.json

@@ -7,6 +7,19 @@
   },
   "scripts": {
     "dev": "node --experimental-strip-types src/index.ts",
+    "typecheck": "tsc --noEmit",
     "validate": "node validate-types.mjs"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.0",
+    "@types/node": "^20.17.0"
+  },
+  "overrides": {
+    "vite": "^6.4.2"
+  },
+  "pnpm": {
+    "overrides": {
+      "vite": "^6.4.2"
+    }
   }
 }

package/registry/families/cloudflare-worker-ts/files/package.json

@@ -7,5 +7,13 @@
   },
   "devDependencies": {
     "wrangler": "^4.0.0"
+  },
+  "overrides": {
+    "vite": "^6.4.2"
+  },
+  "pnpm": {
+    "overrides": {
+      "vite": "^6.4.2"
+    }
   }
 }

package/registry/families/crm-backend/files/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "{{packageName}}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "node --watch --experimental-strip-types src/server.ts",
+    "start": "node --experimental-strip-types src/server.ts",
+    "validate": "node validate-crm.mjs",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate"
+  },
+  "dependencies": {
+    "drizzle-orm": "^0.36.0",
+    "postgres": "^3.4.5"
+  },
+  "devDependencies": {
+    "drizzle-kit": "^0.30.0",
+    "typescript": "^5.9.0",
+    "@types/node": "^20.17.0"
+  },
+  "overrides": { "vite": "^6.4.2" },
+  "pnpm": { "overrides": { "vite": "^6.4.2" } }
+}

package/registry/families/crm-backend/files/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "noEmit": true
+  },
+  "include": ["src/**/*.ts"]
+}

package/registry/families/crm-backend/files/validate-crm.mjs

@@ -0,0 +1,32 @@
+import fs from "node:fs/promises";
+import { stripTypeScriptTypes } from "node:module";
+
+const paths = [
+  "src/server.ts",
+  "src/db/schema.ts",
+  "src/api/pipeline.ts",
+  "src/api/reporting.ts",
+];
+const sources = await Promise.all(paths.map((p) => fs.readFile(p, "utf8")));
+for (const s of sources) stripTypeScriptTypes(s);
+const [server, schema, pipeline, reporting] = sources;
+
+const required = ["contacts", "companies", "deals", "activities", "stages"];
+for (const t of required) {
+  if (!schema.includes(t)) throw new Error(`schema.ts missing table: ${t}`);
+}
+
+if (!pipeline.includes("moveDealStage") && !pipeline.includes("moveDeal") && !pipeline.includes("stageId")) {
+  throw new Error("pipeline.ts must expose a deal-stage move endpoint");
+}
+
+if (!reporting.includes("wonAmount") && !reporting.includes("won_amount") && !reporting.includes("won amount")) {
+  throw new Error("reporting.ts must expose a won-amount-by-month report");
+}
+
+if (!server.includes('/health')) {
+  throw new Error("server.ts missing /health route");
+}
+
+JSON.parse(await fs.readFile("package.json", "utf8"));
+console.log("crm starter ok");

package/registry/families/crm-backend/manifest.json

@@ -0,0 +1,132 @@
+{
+  "id": "crm-backend",
+  "description": "CRM backend API \u2014 contacts, companies, deals with configurable pipeline stages, activities (calls/emails/meetings), reporting endpoints (won-amount-by-month).",
+  "tags": [
+    "crm",
+    "sales",
+    "api",
+    "typescript"
+  ],
+  "taxonomy": {
+    "language": "typescript",
+    "runtime": "node",
+    "surface": "api"
+  },
+  "slots": {
+    "database": {
+      "options": [
+        "database:sqlite",
+        "database:postgres"
+      ],
+      "default": "database:postgres"
+    },
+    "auth": {
+      "options": [
+        "auth:none",
+        "auth:better-auth",
+        "auth:clerk"
+      ],
+      "default": "auth:better-auth"
+    }
+  },
+  "defaults": {
+    "projectType": "api",
+    "serviceName": "starter-foundry-crm",
+    "port": 8104,
+    "databaseProvider": "postgres"
+  },
+  "files": [
+    {
+      "source": "files/package.json",
+      "target": "package.json"
+    },
+    {
+      "source": "files/tsconfig.json",
+      "target": "tsconfig.json"
+    },
+    {
+      "source": "files/validate-crm.mjs",
+      "target": "validate-crm.mjs"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "src/server.ts"
+    },
+    {
+      "type": "file-exists",
+      "path": "src/db/schema.ts"
+    },
+    {
+      "type": "file-exists",
+      "path": "src/api/pipeline.ts"
+    },
+    {
+      "type": "file-exists",
+      "path": "src/api/reporting.ts"
+    },
+    {
+      "type": "command-success",
+      "command": [
+        "node",
+        "validate-crm.mjs"
+      ],
+      "expect": "crm starter ok"
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "pnpm install",
+      "pnpm dev",
+      "pnpm drizzle-kit generate",
+      "pnpm drizzle-kit migrate"
+    ],
+    "entrypoints": [
+      "src/server.ts",
+      "src/db/schema.ts",
+      "src/api/pipeline.ts",
+      "src/api/reporting.ts"
+    ],
+    "preview": {
+      "path": "/health"
+    },
+    "extensionPoints": [
+      "src/db/schema.ts",
+      "src/api/"
+    ]
+  },
+  "keywords": [
+    "crm backend",
+    "customer relationship",
+    "customer relationship management",
+    "sales pipeline",
+    "deals pipeline",
+    "sales backend",
+    "contact management",
+    "deals crm",
+    "salesforce clone",
+    "hubspot clone",
+    "pipeline management"
+  ],
+  "scoring": {
+    "boost": {}
+  },
+  "tieredKeywords": {
+    "tier1": [
+      "crm backend",
+      "sales pipeline",
+      "deals pipeline",
+      "customer relationship management",
+      "contact management"
+    ],
+    "tier2": [
+      "salesforce clone",
+      "hubspot clone",
+      "pipeline management",
+      "lead tracking",
+      "sales backend",
+      "crm"
+    ]
+  }
+}

package/registry/families/deno-edge/files/deno.json

@@ -0,0 +1,17 @@
+{
+  "name": "{{packageName}}",
+  "tasks": {
+    "dev": "deno run --allow-net --allow-env --allow-read --watch src/server.ts",
+    "start": "deno run --allow-net --allow-env --allow-read src/server.ts",
+    "test": "deno test --allow-net --allow-env --allow-read",
+    "validate": "node validate-deno.mjs"
+  },
+  "compilerOptions": {
+    "strict": true,
+    "lib": ["deno.ns", "deno.window", "dom"]
+  },
+  "fmt": {
+    "lineWidth": 100,
+    "singleQuote": true
+  }
+}

package/registry/families/deno-edge/files/validate-deno.mjs

@@ -0,0 +1,21 @@
+import fs from "node:fs/promises";
+
+const [serverSource, denoJson] = await Promise.all([
+  fs.readFile("src/server.ts", "utf8"),
+  fs.readFile("deno.json", "utf8"),
+]);
+
+const config = JSON.parse(denoJson);
+if (config.name !== "{{packageName}}") {
+  throw new Error(`deno.json name should be "{{packageName}}", got "${config.name}"`);
+}
+
+if (!serverSource.includes("Deno.serve")) {
+  throw new Error("src/server.ts should call Deno.serve");
+}
+
+if (!serverSource.includes('"/health"')) {
+  throw new Error("src/server.ts missing /health route contract");
+}
+
+console.log("deno starter ok");