edgebase-worker 0.1.0

package/README.md

@@ -0,0 +1,166 @@
+# EdgeBase Worker - Example Deployment
+
+This is an **example deployment** of EdgeBase using **published NPM packages**.
+
+> **For External Users:** This demonstrates how to use `@edgebasejs/worker` and the EdgeBase CLI to deploy a complete backend to Cloudflare Workers, independently from the monorepo.
+
+This package is the Cloudflare Workers backend only.  
+The admin UI is deployed separately via `@edgebasejs/admin-console` and connects to this worker URL.
+
+## Features
+
+- **Auth**: Login/Register with email and password
+- **Todos CRUD**: Create, read, update, delete todos
+- **User Isolation**: Each user only sees their own todos
+- **Session Management**: Token-based authentication
+
+## Schema & Migrations
+
+- Schema source: `apps/worker/edgebase.schema.ts`
+- Migrations: `apps/worker/migrations/*.sql`
+- Worker entrypoint: `apps/worker/src/index.ts` (EdgeBase worker factory)
+
+Generate SDK + migrations after schema changes:
+
+```bash
+cd apps/worker
+npx edgebase generate
+```
+
+Apply migrations to local D1:
+
+```bash
+cd apps/worker
+npx edgebase migrate
+```
+
+Note: In development, the worker can auto-initialize tables from the schema.
+In production, run migrations explicitly.
+
+## Quick Start
+
+```bash
+# Install dependencies
+npm install
+
+# Start worker development server
+npm run dev
+# Opens: http://localhost:8787 (Worker API)
+```
+
+Start admin console separately (in another terminal):
+
+```bash
+cd ../admin-console
+npm run dev
+# Opens: http://localhost:3001
+# First open asks for Worker URL (e.g. http://localhost:8787)
+```
+
+Build/publish commands are available via the EdgeBase CLI:
+
+```bash
+# Start development
+npm run dev
+
+# Build for deployment
+npm run build
+
+# Deploy to Cloudflare Workers
+npm run deploy
+
+# Publish to npm
+npm run publish
+```
+
+## API Endpoints
+
+### Auth
+
+```bash
+# Login
+curl -X POST http://localhost:8787/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{"email":"user@example.com","password":"password123"}'
+
+# Register
+curl -X POST http://localhost:8787/auth/register \
+  -H "Content-Type: application/json" \
+  -d '{"email":"user@example.com","password":"password123"}'
+```
+
+### Todos
+
+```bash
+TOKEN="..." # From login response
+
+# Create todo
+curl -X POST http://localhost:8787/todos \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"title":"Buy milk","completed":false}'
+
+# Get all todos
+curl http://localhost:8787/todos \
+  -H "Authorization: Bearer $TOKEN"
+
+# Get single todo
+curl http://localhost:8787/todos/TODOID \
+  -H "Authorization: Bearer $TOKEN"
+
+# Update todo
+curl -X PATCH http://localhost:8787/todos/TODOID \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"completed":true}'
+
+# Delete todo
+curl -X DELETE http://localhost:8787/todos/TODOID \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+## Storage
+
+Uses **Cloudflare D1** (SQLite). System tables and entity tables are managed via EdgeBase migrations.
+
+## Deployment
+
+```bash
+# Build for production
+npm run build
+
+# Deploy to Cloudflare Workers
+npm run deploy
+
+# Or publish worker package
+npm run publish
+```
+
+Set environment variables in `wrangler.toml` for production.
+
+### About the Admin Console
+
+The admin console is a separate deployment:
+- Uses this worker via its URL
+- On first start it asks for the Worker URL
+- Supports login with an existing admin account
+- Supports first-admin setup when no admin exists yet
+
+## Architecture
+
+```
+Client (React Native + Expo)
+    ↓
+EdgeBase SDK
+    ↓
+This Worker (REST API)
+    ↓
+In-Memory Storage (or D1 in production)
+```
+
+The app communicates with this worker via HTTP. The SDK handles:
+
+- Authentication (token management)
+- Offline-first caching
+- Sync logic
+- Query caching

package/edgebase.schema.ts

@@ -0,0 +1,48 @@
+// EdgeBase schema definition for worker
+import type { DatabaseSchema } from '@edgebasejs/types';
+
+const schema: DatabaseSchema = {
+  entities: {
+    todos: {
+      fields: {
+        id: {
+          type: 'string',
+          required: true,
+          primary: true,
+        },
+        userId: {
+          type: 'reference',
+          reference: 'users',
+          required: true,
+        },
+        title: {
+          type: 'string',
+          required: true,
+        },
+        completed: {
+          type: 'boolean',
+          required: true,
+          default: false,
+        },
+        createdAt: {
+          type: 'timestamp',
+          required: true,
+        },
+        updatedAt: {
+          type: 'timestamp',
+          required: true,
+        },
+      },
+      accessRules: {
+        create: (user: any, data: any) => data.userId === user.id,
+        read: (user: any, data: any) => data.userId === user.id,
+        update: (user: any, existing: any, updates: any) =>
+          existing.userId === user.id && (!updates.userId || updates.userId === existing.userId),
+        delete: (user: any, existing: any) => existing.userId === user.id,
+      },
+      indexes: [{ fields: ['userId'] }],
+    },
+  },
+};
+
+export default schema;

package/migrations/0000_init_system_tables.sql

@@ -0,0 +1,29 @@
+CREATE TABLE IF NOT EXISTS users (
+  id TEXT PRIMARY KEY,
+  email TEXT NOT NULL UNIQUE,
+  password_hash TEXT NOT NULL,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS refresh_tokens (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL,
+  token TEXT NOT NULL UNIQUE,
+  expires_at INTEGER NOT NULL,
+  created_at INTEGER NOT NULL,
+  FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS sync_metadata (
+  entity TEXT NOT NULL,
+  record_id TEXT NOT NULL,
+  version INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  deleted_at INTEGER,
+  PRIMARY KEY (entity, record_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_sync_metadata_updated ON sync_metadata(entity, updated_at);
+CREATE INDEX IF NOT EXISTS idx_refresh_tokens_user ON refresh_tokens(user_id);
+CREATE INDEX IF NOT EXISTS idx_refresh_tokens_token ON refresh_tokens(token);

package/migrations/0001_schema_changes.sql

@@ -0,0 +1,7 @@
+CREATE TABLE todos (
+  id TEXT PRIMARY KEY,
+  title TEXT NOT NULL,
+  completed INTEGER NOT NULL DEFAULT 0,
+  createdAt INTEGER NOT NULL,
+  updatedAt INTEGER NOT NULL
+);

package/migrations/0002_add_todos_user_id.sql

@@ -0,0 +1,2 @@
+ALTER TABLE todos ADD COLUMN userId TEXT;
+CREATE INDEX IF NOT EXISTS idx_todos_userId ON todos(userId);

package/migrations/0003_add_admin_tables.sql

@@ -0,0 +1,21 @@
+CREATE TABLE IF NOT EXISTS admins (
+  id TEXT PRIMARY KEY,
+  email TEXT NOT NULL UNIQUE,
+  password_hash TEXT NOT NULL,
+  role TEXT NOT NULL,
+  is_active INTEGER NOT NULL DEFAULT 1,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS admin_refresh_tokens (
+  id TEXT PRIMARY KEY,
+  admin_id TEXT NOT NULL,
+  token TEXT NOT NULL UNIQUE,
+  expires_at INTEGER NOT NULL,
+  created_at INTEGER NOT NULL,
+  FOREIGN KEY (admin_id) REFERENCES admins(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_admin_refresh_tokens_admin ON admin_refresh_tokens(admin_id);
+CREATE INDEX IF NOT EXISTS idx_admin_refresh_tokens_token ON admin_refresh_tokens(token);

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "edgebase-worker",
+  "version": "0.1.0",
+  "description": "EdgeBase Worker - Cloudflare Workers deployment (uses published npm packages)",
+  "type": "module",
+  "main": "dist/index.js",
+  "dependencies": {
+    "@edgebasejs/worker": "0.1.12"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20240605.0",
+    "@edgebasejs/cli": "^0.9.1",
+    "@edgebasejs/types": "^0.1.12",
+    "@types/node": "^25.2.2",
+    "typescript": "^5.4.5",
+    "wrangler": "^3.28.0"
+  },
+  "scripts": {
+    "dev": "npm run dev:worker",
+    "dev:worker": "wrangler dev --ip 0.0.0.0",
+    "build": "edgebase build",
+    "type-check": "../../node_modules/.bin/tsc --noEmit",
+    "deploy": "npm run build && wrangler deploy"
+  }
+}

package/src/index.ts

@@ -0,0 +1,18 @@
+import { createEdgeBaseWorker } from '@edgebasejs/worker';
+import schema from '../edgebase.schema';
+
+const app = createEdgeBaseWorker({
+  schema,
+  getDb: (c) => c.env.DB,
+  getJwtSecret: (c) => c.env.JWT_SECRET,
+  getEnvironment: (c) => c.env.ENVIRONMENT,
+  getR2Bucket: (c) => c.env.FILES,
+  apiVersion: '0.1.0',
+  // Auto-initialize database on first request (safe with CREATE TABLE IF NOT EXISTS)
+  autoInitialize: true,
+  // Admin Console disabled - RSC rendering not supported on Edge Runtime
+  // For admin features, deploy a separate instance or use external admin service
+  adminConsole: false,
+});
+
+export default app;

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "lib": ["ES2020"],
+    "target": "ES2020",
+    "outDir": "./dist",
+    "types": ["@cloudflare/workers-types", "node"],
+    "jsx": "react-jsx",
+    "skipLibCheck": true,
+    "skipDefaultLibCheck": true,
+    "noEmit": false,
+    "moduleResolution": "node",
+    "module": "ES2020",
+    "declaration": false,
+    "baseUrl": ".",
+    "paths": {
+      "@edgebasejs/types": ["../../packages/shared-types/src"]
+    }
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist", "edgebase.schema.ts"]
+}

package/wrangler.toml

@@ -0,0 +1,38 @@
+name = "edgebase-worker"
+main = "src/index.ts"
+compatibility_date = "2024-09-23"
+compatibility_flags = ["nodejs_compat"]
+
+# Default environment (development/local)
+[[d1_databases]]
+binding = "DB"
+database_name = "edgebase"
+database_id = "2ddd0305-d96d-48ad-84bd-5d7697c33728"
+
+[[r2_buckets]]
+binding = "FILES"
+bucket_name = "edgebase-files"
+preview_bucket_name = "edgebase-files-preview"
+
+[vars]
+JWT_SECRET = "dev-secret-change-in-production"
+ENVIRONMENT = "development"
+
+# Production environment
+[env.production]
+[[env.production.d1_databases]]
+binding = "DB"
+database_name = "edgebase"
+database_id = "2ddd0305-d96d-48ad-84bd-5d7697c33728"
+
+[[env.production.r2_buckets]]
+binding = "FILES"
+bucket_name = "edgebase-files"
+
+[env.production.vars]
+JWT_SECRET = "2db53d655ad743e29574e8d1912440afbaacf0651fb002e0676dfc490f23a968"
+ENVIRONMENT = "production"
+
+[[env.production.routes]]
+pattern = "backend.edgebase.tandamo.com"
+custom_domain = true