zitejs 0.1.0 → 0.2.0

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "zitejs",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "The Zite framework — build apps on Zite Database",
   "type": "module",
+  "bin": {
+    "zitejs": "./sync/index.js"
+  },
   "exports": {
     "./db": {
       "types": "./db/index.d.ts",
@@ -35,7 +38,8 @@
     "auth",
     "upload",
     "pdf",
-    "schedules"
+    "schedules",
+    "sync"
   ],
   "keywords": ["zite", "zitejs", "framework", "database", "vibe-coding"],
   "license": "MIT",

package/sync/index.js

@@ -0,0 +1,221 @@
+#!/usr/bin/env node
+
+/**
+ * zitejs sync — fetches your Zite Database schema and generates
+ * a typed .zite/db.ts client with a fetch()-based runtime.
+ *
+ * Usage:
+ *   ZITE_DB_TOKEN=sk_prod_... npx zitejs sync
+ *
+ * Environment:
+ *   ZITE_DB_TOKEN  — API token (required)
+ *   ZITE_DB_URL    — Base URL (default: https://tables.fillout.com/api/v1)
+ *   ZITE_BASE_ID   — Database ID (auto-detected from zite.config.json if omitted)
+ */
+
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+
+const BASE_URL =
+  process.env.ZITE_DB_URL ?? 'https://tables.fillout.com/api/v1';
+const TOKEN = process.env.ZITE_DB_TOKEN ?? '';
+
+// Field type → TypeScript type mapping
+const FIELD_TYPE_MAP = {
+  single_line_text: 'string',
+  long_text: 'string',
+  email: 'string',
+  url: 'string',
+  phone_number: 'string',
+  number: 'number',
+  currency: 'number',
+  percent: 'number',
+  rating: 'number',
+  duration: 'number',
+  single_select: 'string',
+  multiple_select: 'string[]',
+  checkbox: 'boolean',
+  date: 'string',
+  datetime: 'string',
+  attachments: 'Array<{ url: string; name?: string }>',
+  linked_record: 'string[]',
+  lookup: 'unknown',
+  autonumber: 'number',
+  source: 'string',
+};
+
+function toLowerCamel(name) {
+  return name.charAt(0).toLowerCase() + name.slice(1);
+}
+
+function toPascalCase(name) {
+  return name
+    .replace(/[^a-zA-Z0-9]+(.)/g, (_, c) => c.toUpperCase())
+    .replace(/^(.)/, (_, c) => c.toUpperCase());
+}
+
+function toCamelCase(name) {
+  const pascal = toPascalCase(name);
+  return toLowerCamel(pascal);
+}
+
+function tsTypeForField(field) {
+  return FIELD_TYPE_MAP[field.type] ?? 'unknown';
+}
+
+async function fetchBaseMetadata(baseId) {
+  const url = `${BASE_URL}/bases/${encodeURIComponent(baseId)}`;
+  const res = await fetch(url, {
+    headers: { Authorization: `Bearer ${TOKEN}` },
+  });
+  if (!res.ok) {
+    throw new Error(
+      `Failed to fetch base metadata (${res.status}): ${await res.text()}`,
+    );
+  }
+  return res.json();
+}
+
+function generateSchema(base) {
+  const schema = { tables: {} };
+  for (const table of base.tables ?? []) {
+    const tableName = toCamelCase(table.name);
+    const fields = {};
+    for (const field of table.fields ?? []) {
+      fields[toCamelCase(field.name)] = { id: field.id };
+    }
+    schema.tables[tableName] = { id: table.id, fields };
+  }
+  return schema;
+}
+
+function generateDbTs(base, schema, baseId) {
+  const lines = [];
+
+  lines.push('// Auto-generated by zitejs sync. Do not edit manually.');
+  lines.push('');
+
+  // Runtime
+  lines.push(`const BASE_URL = process.env.ZITE_DB_URL ?? 'https://tables.fillout.com/api/v1';`);
+  lines.push(`const TOKEN = process.env.ZITE_DB_TOKEN ?? '';`);
+  lines.push('');
+  lines.push('async function dbFetch(method: string, path: string, body?: unknown) {');
+  lines.push('  const res = await fetch(BASE_URL + path, {');
+  lines.push('    method,');
+  lines.push('    headers: {');
+  lines.push('      Authorization: `Bearer ${TOKEN}`,');
+  lines.push("      ...(body ? { 'Content-Type': 'application/json' } : {}),");
+  lines.push('    },');
+  lines.push('    body: body ? JSON.stringify(body) : undefined,');
+  lines.push('  });');
+  lines.push('  if (!res.ok) {');
+  lines.push("    const text = await res.text().catch(() => '');");
+  lines.push('    throw new Error(`Zite DB request failed (${res.status}): ${text}`);');
+  lines.push('  }');
+  lines.push('  return res.json();');
+  lines.push('}');
+  lines.push('');
+
+  // Per-table types + client
+  for (const table of base.tables ?? []) {
+    const className = toPascalCase(table.name);
+    const propName = toCamelCase(table.name);
+    const recordType = `${className}RecordType`;
+
+    // Record type
+    lines.push(`export type ${recordType} = {`);
+    lines.push('  id: string;');
+    for (const field of table.fields ?? []) {
+      const fieldName = toCamelCase(field.name);
+      const tsType = tsTypeForField(field);
+      lines.push(`  ${fieldName}: ${tsType};`);
+    }
+    lines.push('  createdAt: string;');
+    lines.push('  updatedAt: string;');
+    lines.push('};');
+    lines.push('');
+  }
+
+  // createTableClient helper
+  lines.push('function createTableClient<T>(baseId: string, tableId: string) {');
+  lines.push('  const base = `/bases/${encodeURIComponent(baseId)}/tables/${encodeURIComponent(tableId)}`;');
+  lines.push('  return {');
+  lines.push('    findMany: (options?: { limit?: number; offset?: number; sort?: unknown[]; filter?: unknown }): Promise<{ records: T[]; total: number; hasMore: boolean }> =>');
+  lines.push('      dbFetch("POST", `${base}/records/list`, options),');
+  lines.push('    findOne: (recordId: string): Promise<T> =>');
+  lines.push('      dbFetch("GET", `${base}/records/${encodeURIComponent(recordId)}`),');
+  lines.push('    create: (data: Partial<T>): Promise<T> =>');
+  lines.push('      dbFetch("POST", `${base}/records`, { record: data }),');
+  lines.push('    update: (recordId: string, data: Partial<T>): Promise<T> =>');
+  lines.push('      dbFetch("PATCH", `${base}/records/${encodeURIComponent(recordId)}`, { record: data }),');
+  lines.push('    delete: (recordId: string): Promise<{ deleted: true }> =>');
+  lines.push('      dbFetch("DELETE", `${base}/records/${encodeURIComponent(recordId)}`),');
+  lines.push('    bulkCreate: (records: Partial<T>[]): Promise<T[]> =>');
+  lines.push('      dbFetch("POST", `${base}/records/bulk`, { records }),');
+  lines.push('  };');
+  lines.push('}');
+  lines.push('');
+
+  // Singleton
+  lines.push(`const BASE_ID = '${baseId}';`);
+  lines.push('');
+  lines.push('export const zite = {');
+  for (const table of base.tables ?? []) {
+    const className = toPascalCase(table.name);
+    const propName = toCamelCase(table.name);
+    const tableId = schema.tables[propName]?.id ?? table.id;
+    lines.push(`  ${propName}: createTableClient<${className}RecordType>(BASE_ID, '${tableId}'),`);
+  }
+  lines.push('};');
+  lines.push('');
+
+  return lines.join('\n');
+}
+
+async function main() {
+  if (!TOKEN) {
+    console.error('Error: ZITE_DB_TOKEN is required. Set it in your .env or environment.');
+    process.exit(1);
+  }
+
+  // Find base ID from zite.config.json or env
+  let baseId = process.env.ZITE_BASE_ID;
+  if (!baseId) {
+    try {
+      const config = JSON.parse(readFileSync('zite.config.json', 'utf-8'));
+      baseId = config.project?.basePublicIdentifier;
+    } catch {
+      // ignore
+    }
+  }
+
+  if (!baseId) {
+    console.error('Error: Could not determine base ID. Set ZITE_BASE_ID or ensure zite.config.json exists.');
+    process.exit(1);
+  }
+
+  console.log(`Syncing database ${baseId}...`);
+
+  const base = await fetchBaseMetadata(baseId);
+  console.log(`Found ${base.tables?.length ?? 0} tables`);
+
+  const schema = generateSchema(base);
+
+  // Write zite.schema.json
+  writeFileSync('zite.schema.json', JSON.stringify(schema, null, 2));
+  console.log('Wrote zite.schema.json');
+
+  // Write .zite/db.ts
+  const dbTs = generateDbTs(base, schema, baseId);
+  const dbPath = join('.zite', 'db.ts');
+  mkdirSync(dirname(dbPath), { recursive: true });
+  writeFileSync(dbPath, dbTs);
+  console.log(`Wrote ${dbPath}`);
+
+  console.log('Done!');
+}
+
+main().catch(err => {
+  console.error('Sync failed:', err.message);
+  process.exit(1);
+});