bonescript-compiler 0.6.2 → 0.8.0

package/dist/emit_prisma.js

@@ -0,0 +1,314 @@
+"use strict";
+/**
+ * BoneScript Prisma Schema Emitter
+ * Generates a Prisma schema file from the IR.
+ *
+ * Maps BoneScript entities, relations, and constraints to Prisma's
+ * schema language. Produces a single `schema.prisma` file that can
+ * be used with `npx prisma migrate dev` and `npx prisma generate`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrismaEmitter = void 0;
+function toSnakeCase(s) {
+    return s.replace(/([a-z])([A-Z])/g, "$1_$2").toLowerCase();
+}
+function toPascalCase(s) {
+    return s.replace(/(^|[-_\s])(\w)/g, (_, __, c) => c.toUpperCase());
+}
+// ─── Type Mapping ─────────────────────────────────────────────────────────────
+const PRISMA_TYPE_MAP = {
+    string: "String",
+    uint: "Int",
+    int: "Int",
+    float: "Float",
+    bool: "Boolean",
+    timestamp: "DateTime",
+    uuid: "String",
+    bytes: "Bytes",
+    json: "Json",
+};
+function toPrismaType(irType) {
+    if (PRISMA_TYPE_MAP[irType])
+        return PRISMA_TYPE_MAP[irType];
+    const listMatch = irType.match(/^(list|set)<(.+)>$/);
+    if (listMatch)
+        return `${toPrismaType(listMatch[2])}[]`;
+    const optMatch = irType.match(/^optional<(.+)>$/);
+    if (optMatch)
+        return `${toPrismaType(optMatch[1])}?`;
+    // Entity reference — will be handled as a relation
+    return "String";
+}
+function toPrismaNativeType(irType) {
+    switch (irType) {
+        case "uuid": return "@db.Uuid";
+        case "string": return null; // default is fine
+        case "json": return null; // Json maps directly
+        case "bytes": return null;
+        case "timestamp": return "@db.Timestamptz";
+        case "float": return "@db.DoublePrecision";
+        case "uint": return "@db.BigInt";
+        case "int": return "@db.BigInt";
+        default: return null;
+    }
+}
+// ─── Prisma Emitter ───────────────────────────────────────────────────────────
+class PrismaEmitter {
+    emit(system) {
+        const files = [];
+        files.push({
+            path: "prisma/schema.prisma",
+            content: this.emitSchema(system),
+            language: "typescript", // closest match for syntax highlighting
+            source_module: "prisma",
+        });
+        return files;
+    }
+    emitSchema(system) {
+        const lines = [];
+        // Header
+        lines.push(`// Generated by BoneScript compiler. DO NOT EDIT.`);
+        lines.push(`// Source: ${system.name} (${system.source_hash})`);
+        lines.push(`// Run: npx prisma migrate dev --name init`);
+        lines.push(`//      npx prisma generate`);
+        lines.push(``);
+        // Datasource
+        lines.push(`datasource db {`);
+        lines.push(`  provider = "postgresql"`);
+        lines.push(`  url      = env("DATABASE_URL")`);
+        lines.push(`}`);
+        lines.push(``);
+        // Generator
+        lines.push(`generator client {`);
+        lines.push(`  provider = "prisma-client-js"`);
+        lines.push(`}`);
+        lines.push(``);
+        // Collect all models across modules, deduplicating by name
+        const modelMap = new Map();
+        const allRelations = [];
+        for (const mod of system.modules) {
+            if (mod.kind === "data_store" || mod.kind === "api_service") {
+                for (const model of mod.models) {
+                    if (!modelMap.has(model.name)) {
+                        modelMap.set(model.name, { model, mod });
+                    }
+                }
+                allRelations.push(...mod.relations);
+            }
+        }
+        // Deduplicate relations by a stable key
+        const seenRelations = new Set();
+        const uniqueRelations = [];
+        for (const rel of allRelations) {
+            const key = `${rel.from_entity}:${rel.to_entity}:${rel.kind}:${rel.foreign_key}`;
+            if (!seenRelations.has(key)) {
+                seenRelations.add(key);
+                uniqueRelations.push(rel);
+            }
+        }
+        // Build a lookup: entity name → relations where it's the "from" side
+        const relationsFrom = new Map();
+        const relationsTo = new Map();
+        for (const rel of uniqueRelations) {
+            if (!relationsFrom.has(rel.from_entity))
+                relationsFrom.set(rel.from_entity, []);
+            relationsFrom.get(rel.from_entity).push(rel);
+            if (!relationsTo.has(rel.to_entity))
+                relationsTo.set(rel.to_entity, []);
+            relationsTo.get(rel.to_entity).push(rel);
+        }
+        // Emit each model
+        for (const [name, { model, mod }] of modelMap) {
+            lines.push(this.emitModel(name, model, mod, relationsFrom.get(name) || [], relationsTo.get(name) || [], modelMap));
+            lines.push(``);
+        }
+        // Emit junction tables for many_to_many
+        for (const rel of uniqueRelations) {
+            if (rel.kind === "many_to_many" && rel.junction_table) {
+                lines.push(this.emitJunctionModel(rel));
+                lines.push(``);
+            }
+        }
+        // Emit audit_log and event_outbox models (infrastructure)
+        lines.push(this.emitAuditLogModel());
+        lines.push(``);
+        lines.push(this.emitEventOutboxModel());
+        lines.push(``);
+        return lines.join("\n");
+    }
+    emitModel(name, model, mod, relationsFrom, relationsTo, allModels) {
+        const lines = [];
+        const tableName = toSnakeCase(name) + "s";
+        lines.push(`model ${toPascalCase(name)} {`);
+        // Fields
+        for (const field of model.fields) {
+            lines.push(`  ${this.emitField(field, model, name)}`);
+        }
+        // State field (if entity has a state machine)
+        const hasSM = mod.state_machines.some(sm => sm.entity === name);
+        const hasStateField = model.fields.some(f => f.name === "state");
+        if (hasSM && !hasStateField) {
+            lines.push(`  state         String`);
+        }
+        // Relation fields
+        for (const rel of relationsFrom) {
+            if (rel.kind === "belongs_to") {
+                // The FK field is already in the model fields. Add the relation object.
+                const targetModel = toPascalCase(rel.to_entity);
+                const fieldName = toSnakeCase(rel.to_entity);
+                lines.push(`  ${fieldName}   ${targetModel}  @relation(fields: [${rel.foreign_key}], references: [id], onDelete: Cascade)`);
+            }
+            else if (rel.kind === "has_many") {
+                const targetModel = toPascalCase(rel.to_entity);
+                const fieldName = toSnakeCase(rel.to_entity) + "s";
+                lines.push(`  ${fieldName}  ${targetModel}[]`);
+            }
+            else if (rel.kind === "has_one") {
+                const targetModel = toPascalCase(rel.to_entity);
+                const fieldName = toSnakeCase(rel.to_entity);
+                lines.push(`  ${fieldName}   ${targetModel}?`);
+            }
+        }
+        // Inverse relations (where this model is the "to" side)
+        for (const rel of relationsTo) {
+            if (rel.kind === "belongs_to") {
+                // This model is the target of a belongs_to — add the inverse has_many
+                const sourceModel = toPascalCase(rel.from_entity);
+                const fieldName = toSnakeCase(rel.from_entity) + "s";
+                // Only add if not already covered by relationsFrom
+                const alreadyCovered = relationsFrom.some(r => r.to_entity === rel.from_entity && r.kind === "has_many");
+                if (!alreadyCovered) {
+                    lines.push(`  ${fieldName}  ${sourceModel}[]`);
+                }
+            }
+        }
+        // Table mapping
+        lines.push(``);
+        lines.push(`  @@map("${tableName}")`);
+        // Indexes
+        for (const idx of model.indexes) {
+            if (idx.unique) {
+                lines.push(`  @@unique([${idx.fields.join(", ")}])`);
+            }
+            else {
+                lines.push(`  @@index([${idx.fields.join(", ")}])`);
+            }
+        }
+        lines.push(`}`);
+        return lines.join("\n");
+    }
+    emitField(field, model, entityName) {
+        const parts = [];
+        // Field name (padded for alignment)
+        parts.push(field.name.padEnd(14));
+        // Type
+        let prismaType = toPrismaType(field.type);
+        if (field.nullable)
+            prismaType += "?";
+        parts.push(prismaType.padEnd(12));
+        // Attributes
+        const attrs = [];
+        // Primary key
+        if (field.name === model.primary_key) {
+            attrs.push("@id");
+        }
+        // Default values
+        if (field.name === "id" && field.type === "uuid") {
+            attrs.push("@default(uuid())");
+        }
+        else if (field.name === "created_at" || (field.type === "timestamp" && field.name.includes("created"))) {
+            attrs.push("@default(now())");
+        }
+        else if (field.name === "updated_at") {
+            attrs.push("@updatedAt");
+        }
+        else if (field.default_value) {
+            const dv = this.mapDefaultValue(field.default_value, field.type);
+            if (dv)
+                attrs.push(dv);
+        }
+        // Unique constraint (skip if already primary key — @id implies uniqueness)
+        if (field.unique && field.name !== model.primary_key) {
+            attrs.push("@unique");
+        }
+        // Native type annotation
+        const nativeType = toPrismaNativeType(field.type);
+        if (nativeType) {
+            attrs.push(nativeType);
+        }
+        if (attrs.length > 0) {
+            parts.push(attrs.join(" "));
+        }
+        return parts.join(" ").trimEnd();
+    }
+    mapDefaultValue(value, type) {
+        if (value === "gen_random_uuid()" || value === "uuid()")
+            return "@default(uuid())";
+        if (value === "now()")
+            return "@default(now())";
+        if (value === "true" || value === "false")
+            return `@default(${value})`;
+        if (/^\d+$/.test(value))
+            return `@default(${value})`;
+        if (/^\d+\.\d+$/.test(value))
+            return `@default(${value})`;
+        if (value.startsWith('"') && value.endsWith('"'))
+            return `@default(${value})`;
+        return null;
+    }
+    emitJunctionModel(rel) {
+        const lines = [];
+        const fromCol = toSnakeCase(rel.from_entity) + "_id";
+        const toCol = toSnakeCase(rel.to_entity) + "_id";
+        lines.push(`model ${toPascalCase(rel.junction_table)} {`);
+        lines.push(`  ${fromCol.padEnd(14)} String       @db.Uuid`);
+        lines.push(`  ${toCol.padEnd(14)} String       @db.Uuid`);
+        lines.push(`  created_at     DateTime     @default(now()) @db.Timestamptz`);
+        lines.push(``);
+        lines.push(`  ${toSnakeCase(rel.from_entity).padEnd(14)} ${toPascalCase(rel.from_entity)}  @relation(fields: [${fromCol}], references: [id], onDelete: Cascade)`);
+        lines.push(`  ${toSnakeCase(rel.to_entity).padEnd(14)} ${toPascalCase(rel.to_entity)}  @relation(fields: [${toCol}], references: [id], onDelete: Cascade)`);
+        lines.push(``);
+        lines.push(`  @@id([${fromCol}, ${toCol}])`);
+        lines.push(`  @@index([${fromCol}])`);
+        lines.push(`  @@index([${toCol}])`);
+        lines.push(`  @@map("${rel.junction_table}")`);
+        lines.push(`}`);
+        return lines.join("\n");
+    }
+    emitAuditLogModel() {
+        return `model AuditLog {
+  id             String       @id @default(uuid()) @db.Uuid
+  actor_id       String?      @db.Uuid
+  action         String
+  entity_type    String
+  entity_id      String?      @db.Uuid
+  payload        Json?
+  ip             String?
+  user_agent     String?
+  trace_id       String?      @db.Uuid
+  created_at     DateTime     @default(now()) @db.Timestamptz
+
+  @@index([actor_id])
+  @@index([entity_type, entity_id])
+  @@index([created_at])
+  @@map("audit_log")
+}`;
+    }
+    emitEventOutboxModel() {
+        return `model EventOutbox {
+  id             String       @id @default(uuid()) @db.Uuid
+  event_type     String
+  payload        Json
+  status         String       @default("pending")
+  attempts       Int          @default(0)
+  created_at     DateTime     @default(now()) @db.Timestamptz
+  processed_at   DateTime?    @db.Timestamptz
+  error          String?
+
+  @@index([status, created_at])
+  @@map("event_outbox")
+}`;
+    }
+}
+exports.PrismaEmitter = PrismaEmitter;
+//# sourceMappingURL=emit_prisma.js.map

package/dist/emit_prisma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit_prisma.js","sourceRoot":"","sources":["../src/emit_prisma.ts"],"names":[],"mappings":"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"}

package/dist/emit_react.d.ts

@@ -0,0 +1,24 @@
+/**
+ * BoneScript React Hooks Emitter
+ *
+ * Generates a typed React hooks file (sdk/react.ts) on top of the existing
+ * fetch SDK. Hooks are zero-dep — they use React's built-in useState +
+ * useEffect rather than pulling in @tanstack/react-query so consumers can
+ * decide their own data layer.
+ *
+ * For each entity:
+ *   useList<Entity>()      → { data, loading, error, refetch }
+ *   use<Entity>(id)        → { data, loading, error, refetch }
+ *   useCreate<Entity>()    → mutate(input) → Promise<Entity>
+ *   useUpdate<Entity>()    → mutate(id, patch) → Promise<Entity>
+ *   useDelete<Entity>()    → mutate(id) → Promise<void>
+ *
+ * For each capability:
+ *   useCapability<Name>()  → mutate(input) → Promise<unknown>
+ *
+ * Hooks are framework-agnostic in shape (no react-query, no SWR) so they work
+ * with Next.js, Vite, CRA, or any plain React app.
+ */
+import * as IR from "./ir";
+import { EmittedFile } from "./emitter";
+export declare function emitReactHooks(system: IR.IRSystem): EmittedFile;

package/dist/emit_react.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * BoneScript React Hooks Emitter
+ *
+ * Generates a typed React hooks file (sdk/react.ts) on top of the existing
+ * fetch SDK. Hooks are zero-dep — they use React's built-in useState +
+ * useEffect rather than pulling in @tanstack/react-query so consumers can
+ * decide their own data layer.
+ *
+ * For each entity:
+ *   useList<Entity>()      → { data, loading, error, refetch }
+ *   use<Entity>(id)        → { data, loading, error, refetch }
+ *   useCreate<Entity>()    → mutate(input) → Promise<Entity>
+ *   useUpdate<Entity>()    → mutate(id, patch) → Promise<Entity>
+ *   useDelete<Entity>()    → mutate(id) → Promise<void>
+ *
+ * For each capability:
+ *   useCapability<Name>()  → mutate(input) → Promise<unknown>
+ *
+ * Hooks are framework-agnostic in shape (no react-query, no SWR) so they work
+ * with Next.js, Vite, CRA, or any plain React app.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitReactHooks = void 0;
+function toSnakeCase(s) {
+    return s.replace(/([a-z])([A-Z])/g, "$1_$2").toLowerCase();
+}
+function toPascalCase(s) {
+    return s.replace(/(^|[-_\s])(\w)/g, (_, __, c) => c.toUpperCase());
+}
+const TS_TYPE_MAP = {
+    string: "string", uint: "number", int: "number", float: "number",
+    bool: "boolean", timestamp: "string", uuid: "string", bytes: "string", json: "unknown",
+};
+function toTsType(irType) {
+    if (TS_TYPE_MAP[irType])
+        return TS_TYPE_MAP[irType];
+    const m = irType.match(/^(list|set)<(.+)>$/);
+    if (m)
+        return `${toTsType(m[2])}[]`;
+    const om = irType.match(/^optional<(.+)>$/);
+    if (om)
+        return `${toTsType(om[1])} | null`;
+    return irType;
+}
+function emitReactHooks(system) {
+    const lines = [];
+    lines.push(`// Generated by BoneScript compiler. DO NOT EDIT.`);
+    lines.push(`// React hooks for the ${system.name} API.`);
+    lines.push(`//`);
+    lines.push(`// Pair with sdk/client.ts. Pass an instance of <System>Client to <ApiProvider>.`);
+    lines.push(``);
+    lines.push(`import { useCallback, useEffect, useState, createContext, useContext, ReactNode, createElement } from "react";`);
+    lines.push(``);
+    // Entity types (forward-declared so the hooks compile without importing the SDK)
+    // We re-declare them here to keep this file independent — the consumer can
+    // also import these types from sdk/client.ts if they prefer.
+    const apiModules = system.modules.filter(m => m.kind === "api_service" && m.models.length > 0);
+    for (const mod of apiModules) {
+        const model = mod.models[0];
+        lines.push(`export interface ${toPascalCase(model.name)} {`);
+        for (const field of model.fields) {
+            const optional = field.nullable ? "?" : "";
+            lines.push(`  ${field.name}${optional}: ${toTsType(field.type)};`);
+        }
+        lines.push(`}`);
+        lines.push(``);
+    }
+    lines.push(`export interface ApiClient {`);
+    lines.push(`  baseUrl: string;`);
+    lines.push(`  getToken: () => string | null;`);
+    lines.push(`}`);
+    lines.push(``);
+    lines.push(`async function apiFetch<T>(client: ApiClient, method: string, path: string, body?: unknown): Promise<T> {`);
+    lines.push(`  const headers: Record<string, string> = { "Content-Type": "application/json" };`);
+    lines.push(`  const token = client.getToken();`);
+    lines.push(`  if (token) headers["Authorization"] = "Bearer " + token;`);
+    lines.push(`  const res = await fetch(client.baseUrl + path, {`);
+    lines.push(`    method,`);
+    lines.push(`    headers,`);
+    lines.push(`    body: body !== undefined ? JSON.stringify(body) : undefined,`);
+    lines.push(`  });`);
+    lines.push(`  if (!res.ok) {`);
+    lines.push(`    let errMsg = "Request failed: " + res.status;`);
+    lines.push(`    try { const j = await res.json() as { error?: { message?: string } }; if (j.error?.message) errMsg = j.error.message; } catch {}`);
+    lines.push(`    throw new Error(errMsg);`);
+    lines.push(`  }`);
+    lines.push(`  if (res.status === 204) return undefined as unknown as T;`);
+    lines.push(`  return await res.json() as T;`);
+    lines.push(`}`);
+    lines.push(``);
+    // Provider + context. createElement avoids needing JSX in this generated file.
+    lines.push(`const ApiContext = createContext<ApiClient | null>(null);`);
+    lines.push(``);
+    lines.push(`export interface ApiProviderProps {`);
+    lines.push(`  client: ApiClient;`);
+    lines.push(`  children: ReactNode;`);
+    lines.push(`}`);
+    lines.push(``);
+    lines.push(`export function ApiProvider(props: ApiProviderProps) {`);
+    lines.push(`  return createElement(ApiContext.Provider, { value: props.client }, props.children);`);
+    lines.push(`}`);
+    lines.push(``);
+    lines.push(`function useApi(): ApiClient {`);
+    lines.push(`  const ctx = useContext(ApiContext);`);
+    lines.push(`  if (!ctx) throw new Error("useApi must be used inside <ApiProvider>");`);
+    lines.push(`  return ctx;`);
+    lines.push(`}`);
+    lines.push(``);
+    // Generic shape helpers
+    lines.push(`export interface QueryState<T> {`);
+    lines.push(`  data: T | null;`);
+    lines.push(`  loading: boolean;`);
+    lines.push(`  error: Error | null;`);
+    lines.push(`  refetch: () => Promise<void>;`);
+    lines.push(`}`);
+    lines.push(``);
+    lines.push(`export interface MutationState<TInput, TOutput> {`);
+    lines.push(`  mutate: (input: TInput) => Promise<TOutput>;`);
+    lines.push(`  loading: boolean;`);
+    lines.push(`  error: Error | null;`);
+    lines.push(`  reset: () => void;`);
+    lines.push(`}`);
+    lines.push(``);
+    lines.push(`export interface PaginatedResponse<T> {`);
+    lines.push(`  items: T[];`);
+    lines.push(`  total: number;`);
+    lines.push(`  page: number;`);
+    lines.push(`  page_size: number;`);
+    lines.push(`}`);
+    lines.push(``);
+    // Generic primitive hooks. Specific entity / capability hooks below wrap these.
+    lines.push(`function useQueryGeneric<T>(method: string, path: string, deps: unknown[]): QueryState<T> {`);
+    lines.push(`  const client = useApi();`);
+    lines.push(`  const [data, setData] = useState<T | null>(null);`);
+    lines.push(`  const [loading, setLoading] = useState(true);`);
+    lines.push(`  const [error, setError] = useState<Error | null>(null);`);
+    lines.push(`  const fetchOnce = useCallback(async () => {`);
+    lines.push(`    setLoading(true); setError(null);`);
+    lines.push(`    try { const result = await apiFetch<T>(client, method, path); setData(result); }`);
+    lines.push(`    catch (e: unknown) { setError(e instanceof Error ? e : new Error(String(e))); }`);
+    lines.push(`    finally { setLoading(false); }`);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    lines.push(`  }, [client, method, path]);`);
+    lines.push(`  useEffect(() => { void fetchOnce(); /* eslint-disable-next-line react-hooks/exhaustive-deps */ }, deps);`);
+    lines.push(`  return { data, loading, error, refetch: fetchOnce };`);
+    lines.push(`}`);
+    lines.push(``);
+    lines.push(`function useMutationGeneric<TInput, TOutput>(builder: (input: TInput) => { method: string; path: string; body?: unknown }): MutationState<TInput, TOutput> {`);
+    lines.push(`  const client = useApi();`);
+    lines.push(`  const [loading, setLoading] = useState(false);`);
+    lines.push(`  const [error, setError] = useState<Error | null>(null);`);
+    lines.push(`  const mutate = useCallback(async (input: TInput): Promise<TOutput> => {`);
+    lines.push(`    setLoading(true); setError(null);`);
+    lines.push(`    try { const req = builder(input); return await apiFetch<TOutput>(client, req.method, req.path, req.body); }`);
+    lines.push(`    catch (e: unknown) { const err = e instanceof Error ? e : new Error(String(e)); setError(err); throw err; }`);
+    lines.push(`    finally { setLoading(false); }`);
+    lines.push(`  }, [client, builder]);`);
+    lines.push(`  const reset = useCallback(() => setError(null), []);`);
+    lines.push(`  return { mutate, loading, error, reset };`);
+    lines.push(`}`);
+    lines.push(``);
+    // Per-entity hooks
+    for (const mod of apiModules) {
+        const model = mod.models[0];
+        const entity = toPascalCase(model.name);
+        const tableName = toSnakeCase(model.name) + "s";
+        const route = `/${tableName}`;
+        lines.push(`// ─── ${entity} ───────────────────────────────────────────────────────────`);
+        lines.push(``);
+        // List
+        lines.push(`export function useList${entity}(): QueryState<PaginatedResponse<${entity}>> {`);
+        lines.push(`  return useQueryGeneric<PaginatedResponse<${entity}>>("GET", "${route}", []);`);
+        lines.push(`}`);
+        lines.push(``);
+        // Read
+        lines.push(`export function use${entity}(id: string | null): QueryState<${entity}> {`);
+        lines.push(`  return useQueryGeneric<${entity}>("GET", id ? \`${route}/\${id}\` : "${route}", [id]);`);
+        lines.push(`}`);
+        lines.push(``);
+        // Create
+        const createInputType = `Partial<${entity}>`;
+        lines.push(`export function useCreate${entity}(): MutationState<${createInputType}, ${entity}> {`);
+        lines.push(`  return useMutationGeneric<${createInputType}, ${entity}>((input) => ({ method: "POST", path: "${route}", body: input }));`);
+        lines.push(`}`);
+        lines.push(``);
+        // Update
+        lines.push(`export function useUpdate${entity}(): MutationState<{ id: string; patch: Partial<${entity}> }, ${entity}> {`);
+        lines.push(`  return useMutationGeneric<{ id: string; patch: Partial<${entity}> }, ${entity}>(({ id, patch }) => ({ method: "PUT", path: \`${route}/\${id}\`, body: patch }));`);
+        lines.push(`}`);
+        lines.push(``);
+        // Delete
+        lines.push(`export function useDelete${entity}(): MutationState<string, void> {`);
+        lines.push(`  return useMutationGeneric<string, void>((id) => ({ method: "DELETE", path: \`${route}/\${id}\` }));`);
+        lines.push(`}`);
+        lines.push(``);
+        // Capability hooks
+        for (const iface of mod.interfaces) {
+            for (const method of iface.methods) {
+                if (["create", "read", "update", "delete", "list"].includes(method.name))
+                    continue;
+                const capName = toPascalCase(method.name);
+                const inputType = method.input.length > 0
+                    ? `{ ${method.input.map(p => `${p.name}${p.nullable ? "?" : ""}: ${toTsType(p.type)}`).join("; ")} }`
+                    : "Record<string, never>";
+                const endpoint = `${route}/${method.name.replace(/_/g, "-")}`;
+                lines.push(`export function useCapability${capName}(): MutationState<${inputType}, unknown> {`);
+                lines.push(`  return useMutationGeneric<${inputType}, unknown>((input) => ({ method: "POST", path: "${endpoint}", body: input }));`);
+                lines.push(`}`);
+                lines.push(``);
+            }
+        }
+    }
+    return {
+        path: "sdk/react.ts",
+        content: lines.join("\n"),
+        language: "typescript",
+        source_module: "sdk",
+    };
+}
+exports.emitReactHooks = emitReactHooks;
+//# sourceMappingURL=emit_react.js.map

package/dist/emit_react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit_react.js","sourceRoot":"","sources":["../src/emit_react.ts"],"names":[],"mappings":"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"}

package/dist/emit_sqlite.d.ts

@@ -0,0 +1,33 @@
+/**
+ * BoneScript SQLite Target Emitter
+ *
+ * Generates a SQLite-flavored project: same shape as the Express target but
+ * with a SQLite type map, no triggers, and the better-sqlite3 driver in place
+ * of pg.
+ *
+ * SQLite differences from PostgreSQL that this emitter handles:
+ *   - No JSONB / no native UUID — TEXT for both
+ *   - No CREATE OR REPLACE FUNCTION / no triggers needed (we do updated_at in app code)
+ *   - Parameter style is ? not $1, $2 — but better-sqlite3 also supports named (:name)
+ *   - No SKIP LOCKED, no transactional outbox locking semantics — outbox uses simpler ordering
+ *   - No CHECK constraints with subqueries — basic CHECK only
+ *
+ * Strategy: keep the SQL flat and portable. Use better-sqlite3's prepared
+ * statements. Keep the public interface identical to the Postgres target so
+ * route handlers and capability bodies don't need to change.
+ */
+import * as IR from "./ir";
+import { EmittedFile } from "./emitter";
+export declare function toSqliteType(irType: string): string;
+export declare function emitSqliteSchema(model: IR.IRModel, mod: IR.IRModule, system: IR.IRSystem): EmittedFile;
+export declare function emitSqliteOutboxSchema(): string;
+export declare function emitSqliteAuditSchema(): string;
+export declare function emitSqliteDbClient(system: IR.IRSystem): string;
+export declare function emitSqliteMigration(_system: IR.IRSystem, schemas: string[]): string;
+export declare function emitSqlitePackageJson(system: IR.IRSystem): string;
+export declare class SqliteEmitter {
+    emit(system: IR.IRSystem): EmittedFile[];
+    private emitTsConfig;
+    private emitEnvExample;
+    private emitReadme;
+}