lakebed 0.0.1

package/README.md

@@ -0,0 +1,94 @@
+# Lakebed
+
+Lakebed is an agent-native CLI and runtime for building small full-stack TypeScript apps called capsules.
+
+This package is an early public prototype. It includes the `lakebed` CLI, a local dev runtime, an anonymous deploy artifact compiler, and an anonymous deploy runner.
+
+## Install
+
+```sh
+npm install -g lakebed
+lakebed new my-app
+lakebed dev my-app
+```
+
+Or run it without a global install:
+
+```sh
+npm exec --package lakebed -- lakebed new my-app
+npm exec --package lakebed -- lakebed dev my-app
+```
+
+## Capsule Shape
+
+Lakebed v0 expects this directory layout:
+
+```txt
+server/index.ts
+client/index.tsx
+shared/
+```
+
+Server code imports from `lakebed/server`. Client code imports from `lakebed/client`.
+
+```ts
+import { capsule, mutation, query, string, table } from "lakebed/server";
+
+export default capsule({
+  schema: {
+    messages: table({
+      body: string(),
+      authorId: string()
+    })
+  },
+  queries: {
+    messages: query((ctx) => ctx.db.messages.orderBy("createdAt", "desc").all())
+  },
+  mutations: {
+    sendMessage: mutation((ctx, body: string) =>
+      ctx.db.messages.insert({
+        body,
+        authorId: ctx.auth.userId
+      })
+    )
+  }
+});
+```
+
+## Commands
+
+```sh
+lakebed new <name> [--template todo]
+lakebed dev <capsule-dir> [--port 3000]
+lakebed build <capsule-dir> --target anonymous [--out .lakebed/artifacts/app.json] [--json]
+lakebed deploy <capsule-dir> [--ttl 7d] [--api <url>] [--json]
+lakebed anonymous-server [--port 8787] [--public-root-url <url>]
+lakebed inspect <deploy-id-or-url> [--api <url>] [--json]
+lakebed db list [deploy-id-or-url] [--port 3000]
+lakebed db dump [deploy-id-or-url] [--port 3000]
+lakebed logs [deploy-id-or-url] [--port 3000]
+```
+
+## Current Constraints
+
+- App code can use relative imports, `lakebed/server`, `lakebed/client`, and Lakebed-provided Preact modules.
+- Arbitrary npm imports inside capsules are not supported yet.
+- Node built-ins are not available inside capsule modules.
+- Tailwind classes in JSX are the only styling path in v0.
+- Guest auth is the only auth mode.
+- Anonymous deploys disable outbound `fetch`.
+
+## Hosted Deploys
+
+Once a Lakebed deploy runner is available, deploy a capsule with:
+
+```sh
+lakebed deploy my-app --api https://api.lakebed.app
+```
+
+For local deploy-runner testing:
+
+```sh
+lakebed anonymous-server --port 8787
+lakebed deploy my-app --api http://localhost:8787
+```

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "lakebed",
+  "version": "0.0.1",
+  "description": "Agent-native CLI and runtime for building and deploying Lakebed capsules.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "homepage": "https://lakebed.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pingdotgg/span.git",
+    "directory": "packages/lakebed"
+  },
+  "keywords": [
+    "agents",
+    "app-runtime",
+    "cli",
+    "lakebed"
+  ],
+  "bin": {
+    "lakebed": "src/cli.js"
+  },
+  "files": [
+    "src/anonymous-server.js",
+    "src/anonymous.js",
+    "src/cli.js",
+    "src/client.d.ts",
+    "src/client.js",
+    "src/runtime.js",
+    "src/server.d.ts",
+    "src/server.js",
+    "src/source-store.js"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    "./server": {
+      "types": "./src/server.d.ts",
+      "default": "./src/server.js"
+    },
+    "./client": {
+      "types": "./src/client.d.ts",
+      "default": "./src/client.js"
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "check": "node --check src/cli.js && node --check src/runtime.js && node --check src/server.js && node --check src/client.js && node --check src/source-store.js && node --check src/anonymous.js && node --check src/anonymous-server.js"
+  },
+  "dependencies": {
+    "esbuild": "^0.27.1",
+    "pg": "^8.16.3",
+    "preact": "^10.28.0",
+    "ws": "^8.18.3"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.18.1"
+  }
+}