bonescript-compiler 0.5.5 → 0.5.7

package/src/emit_sdk.ts

@@ -0,0 +1,195 @@
+/**
+ * BoneScript TypeScript SDK Emitter
+ * Generates a typed fetch client SDK from an IRSystem.
+ */
+
+import * as IR from "./ir";
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+function toSnakeCase(s: string): string {
+  return s.replace(/([a-z])([A-Z])/g, "$1_$2").toLowerCase();
+}
+
+function toCamelCase(s: string): string {
+  return s.replace(/_([a-z])/g, (_: string, c: string) => c.toUpperCase());
+}
+
+function toPascalCase(s: string): string {
+  const c = toCamelCase(s);
+  return c.charAt(0).toUpperCase() + c.slice(1);
+}
+
+function irTypeToTs(irType: string): string {
+  if (irType === "string") return "string";
+  if (irType === "uint" || irType === "int") return "number";
+  if (irType === "float") return "number";
+  if (irType === "bool") return "boolean";
+  if (irType === "timestamp") return "string";
+  if (irType === "uuid") return "string";
+  if (irType === "bytes") return "string";
+  if (irType === "json") return "unknown";
+  const listMatch = irType.match(/^list<(.+)>$/);
+  if (listMatch) return irTypeToTs(listMatch[1]) + "[]";
+  const setMatch = irType.match(/^set<(.+)>$/);
+  if (setMatch) return irTypeToTs(setMatch[1]) + "[]";
+  const optMatch = irType.match(/^optional<(.+)>$/);
+  if (optMatch) return irTypeToTs(optMatch[1]) + " | null";
+  return "unknown";
+}
+
+// ─── SDK generator ────────────────────────────────────────────────────────────
+
+export function emitTypescriptSdk(system: IR.IRSystem): string {
+  const lines: string[] = [];
+  const systemPascal = toPascalCase(system.name.replace(/[^a-zA-Z0-9_]/g, "_"));
+
+  lines.push("// Generated by BoneScript compiler. Import this file into your frontend.");
+  lines.push(`// System: ${system.name} v${system.version}`);
+  lines.push("");
+
+  // Collect all models for interface generation
+  const allModels: { mod: IR.IRModule; model: IR.IRModel }[] = [];
+  for (const mod of system.modules) {
+    if (mod.kind === "api_service" && mod.models.length > 0) {
+      for (const model of mod.models) {
+        allModels.push({ mod, model });
+      }
+    }
+  }
+
+  // Emit TypeScript interfaces
+  for (const { model } of allModels) {
+    const typeName = toPascalCase(model.name);
+    lines.push(`export interface ${typeName} {`);
+    for (const field of model.fields) {
+      const nullable = field.nullable ? " | null" : "";
+      lines.push(`  ${field.name}: ${irTypeToTs(field.type)}${nullable};`);
+    }
+    lines.push("}");
+    lines.push("");
+  }
+
+  // Emit client class
+  lines.push(`export class ${systemPascal}Client {`);
+  lines.push(
+    `  constructor(private baseUrl: string, private getToken?: () => string | null) {}`
+  );
+  lines.push("");
+
+  // Private request helper
+  lines.push(
+    `  private async request<T>(method: string, path: string, body?: unknown): Promise<T> {`
+  );
+  lines.push(`    const headers: Record<string, string> = {`);
+  lines.push(`      "Content-Type": "application/json",`);
+  lines.push(`    };`);
+  lines.push(`    if (this.getToken) {`);
+  lines.push(`      const token = this.getToken();`);
+  lines.push(`      if (token) headers["Authorization"] = "Bearer " + token;`);
+  lines.push(`    }`);
+  lines.push(`    const res = await fetch(this.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(
+    `      const text = await res.text().catch(() => res.statusText);`
+  );
+  lines.push(`      throw new Error(\`HTTP \${res.status}: \${text}\`);`);
+  lines.push(`    }`);
+  lines.push(`    if (res.status === 204) return undefined as unknown as T;`);
+  lines.push(`    return res.json() as Promise<T>;`);
+  lines.push(`  }`);
+  lines.push("");
+
+  // Per-entity methods
+  for (const { mod, model } of allModels) {
+    const entity = toPascalCase(model.name);
+    const tableName = toSnakeCase(model.name);
+    const basePath = `/${tableName}s`;
+
+    lines.push(`  // ─── ${entity} ───`);
+    lines.push("");
+
+    lines.push(
+      `  list${entity}(page = 1, pageSize = 50): Promise<{ items: ${entity}[]; total: number; page: number; page_size: number }> {`
+    );
+    lines.push(
+      `    return this.request("GET", \`${basePath}?page=\${page}&page_size=\${pageSize}\`);`
+    );
+    lines.push(`  }`);
+    lines.push("");
+
+    lines.push(`  get${entity}(id: string): Promise<${entity}> {`);
+    lines.push(`    return this.request("GET", \`${basePath}/\${id}\`);`);
+    lines.push(`  }`);
+    lines.push("");
+
+    lines.push(
+      `  create${entity}(data: Partial<${entity}>): Promise<${entity}> {`
+    );
+    lines.push(`    return this.request("POST", "${basePath}", data);`);
+    lines.push(`  }`);
+    lines.push("");
+
+    lines.push(
+      `  update${entity}(id: string, data: Partial<${entity}>): Promise<${entity}> {`
+    );
+    lines.push(`    return this.request("PUT", \`${basePath}/\${id}\`, data);`);
+    lines.push(`  }`);
+    lines.push("");
+
+    lines.push(`  delete${entity}(id: string): Promise<void> {`);
+    lines.push(`    return this.request("DELETE", \`${basePath}/\${id}\`);`);
+    lines.push(`  }`);
+    lines.push("");
+
+    // Capability methods
+    const crudNames = new Set(["create", "read", "update", "delete", "list"]);
+    const allMethods: IR.IRMethod[] = mod.interfaces.flatMap((i) => i.methods);
+    const capabilityMethods = allMethods.filter(
+      (m) => !crudNames.has(m.name.toLowerCase())
+    );
+
+    for (const method of capabilityMethods) {
+      const methodCamel = toCamelCase(method.name);
+      const dashName = toSnakeCase(method.name).replace(/_/g, "-");
+      lines.push(
+        `  ${methodCamel}(data: Record<string, unknown>): Promise<{ ok: boolean; action: string }> {`
+      );
+      lines.push(
+        `    return this.request("POST", "${basePath}/${dashName}", data);`
+      );
+      lines.push(`  }`);
+      lines.push("");
+    }
+  }
+
+  lines.push("}");
+  lines.push("");
+
+  return lines.join("\n");
+}
+
+export function emitSdkPackageJson(system: IR.IRSystem): string {
+  const pkgName = toSnakeCase(system.name).replace(/_/g, "-") + "-sdk";
+  return JSON.stringify(
+    {
+      name: pkgName,
+      version: system.version,
+      description: `TypeScript SDK for ${system.name} — generated by BoneScript compiler`,
+      main: "client.js",
+      types: "client.d.ts",
+      scripts: {
+        build: "tsc",
+      },
+      devDependencies: {
+        typescript: "5.3.3",
+      },
+    },
+    null,
+    2
+  );
+}

package/src/emit_seed.ts

@@ -0,0 +1,91 @@
+/**
+ * BoneScript Seed File Emitter
+ * Generates a TypeScript seed script from an IRSystem.
+ */
+
+import * as IR from "./ir";
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+function toSnakeCase(s: string): string {
+  return s.replace(/([a-z])([A-Z])/g, "$1_$2").toLowerCase();
+}
+
+function seedValue(irType: string, fieldName: string, i: number): string {
+  if (irType === "string") return `"sample_${fieldName}_${i + 1}"`;
+  if (irType === "uint" || irType === "int") return String(i + 1);
+  if (irType === "float") return String((i + 1) * 1.5);
+  if (irType === "bool") return i % 2 === 0 ? "true" : "false";
+  if (irType === "uuid") return "uuid()";
+  if (irType === "timestamp") return "new Date().toISOString()";
+  if (irType === "bytes") return `"sample_${fieldName}_${i + 1}"`;
+  if (irType === "json") return "JSON.stringify({})";
+  const listMatch = irType.match(/^list<(.+)>$/);
+  if (listMatch) return "JSON.stringify([])";
+  const setMatch = irType.match(/^set<(.+)>$/);
+  if (setMatch) return "JSON.stringify([])";
+  const optMatch = irType.match(/^optional<(.+)>$/);
+  if (optMatch) return "null";
+  return `"sample_${fieldName}_${i + 1}"`;
+}
+
+// ─── Public API ───────────────────────────────────────────────────────────────
+
+export function emitSeedFile(system: IR.IRSystem): string {
+  const lines: string[] = [];
+
+  lines.push(`// Generated by BoneScript compiler.`);
+  lines.push(`// Seed script for: ${system.name} v${system.version}`);
+  lines.push(`// Run: npx ts-node src/seed.ts`);
+  lines.push("");
+  lines.push(`import { query, pool } from "./db";`);
+  lines.push(`import { v4 as uuid } from "uuid";`);
+  lines.push("");
+
+  const seedModels: { mod: IR.IRModule; model: IR.IRModel }[] = [];
+  for (const mod of system.modules) {
+    if (mod.kind === "api_service" || mod.kind === "data_store") {
+      for (const model of mod.models) {
+        seedModels.push({ mod, model });
+      }
+    }
+  }
+
+  lines.push(`async function main(): Promise<void> {`);
+  lines.push(`  console.log("Seeding ${system.name}...");`);
+  lines.push("");
+
+  for (const { model } of seedModels) {
+    const tableName = toSnakeCase(model.name) + "s";
+    lines.push(`  // Seed ${model.name}`);
+    lines.push(`  console.log("  Seeding ${tableName}...");`);
+
+    for (let i = 0; i < 3; i++) {
+      const fieldNames = model.fields.map((f) => f.name);
+      const fieldValues = model.fields.map((f) =>
+        seedValue(f.type, f.name, i)
+      );
+
+      lines.push(`  await query(`);
+      lines.push(
+        `    \`INSERT INTO ${tableName} (${fieldNames.join(", ")}) VALUES (${fieldNames.map((_, idx) => `$${idx + 1}`).join(", ")}) ON CONFLICT DO NOTHING\`,`
+      );
+      lines.push(`    [${fieldValues.join(", ")}]`);
+      lines.push(`  );`);
+    }
+    lines.push("");
+  }
+
+  lines.push(`  console.log("Seed complete.");`);
+  lines.push(`}`);
+  lines.push("");
+  lines.push(`main()`);
+  lines.push(`  .catch((err) => {`);
+  lines.push(`    console.error("Seed failed:", err);`);
+  lines.push(`    process.exit(1);`);
+  lines.push(`  })`);
+  lines.push(`  .finally(() => pool.end());`);
+  lines.push("");
+
+  return lines.join("\n");
+}

package/src/emit_zod.ts

@@ -0,0 +1,111 @@
+/**
+ * BoneScript Zod Schema Emitter
+ * Generates Zod v3 validation schemas from an IRSystem.
+ */
+
+import * as IR from "./ir";
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+function toPascalCase(s: string): string {
+  return s
+    .replace(/_([a-z])/g, (_: string, c: string) => c.toUpperCase())
+    .replace(/^([a-z])/, (_: string, c: string) => c.toUpperCase());
+}
+
+function irTypeToZod(irType: string): string {
+  if (irType === "string") return "z.string()";
+  if (irType === "uint") return "z.number().int().nonnegative()";
+  if (irType === "int") return "z.number().int()";
+  if (irType === "float") return "z.number()";
+  if (irType === "bool") return "z.boolean()";
+  if (irType === "timestamp") return "z.string().datetime()";
+  if (irType === "uuid") return "z.string().uuid()";
+  if (irType === "bytes") return "z.string()";
+  if (irType === "json") return "z.unknown()";
+  const listMatch = irType.match(/^list<(.+)>$/);
+  if (listMatch) return `z.array(${irTypeToZod(listMatch[1])})`;
+  const setMatch = irType.match(/^set<(.+)>$/);
+  if (setMatch) return `z.array(${irTypeToZod(setMatch[1])})`;
+  const optMatch = irType.match(/^optional<(.+)>$/);
+  if (optMatch) return `${irTypeToZod(optMatch[1])}.nullable()`;
+  return "z.unknown()";
+}
+
+function applyConstraints(
+  baseZod: string,
+  fieldName: string,
+  constraints: IR.IRModelConstraint[]
+): string {
+  let result = baseZod;
+  for (const c of constraints) {
+    if (c.target !== fieldName) continue;
+    if (c.kind === "range") {
+      if (c.params.min !== undefined) result += `.min(${c.params.min})`;
+      if (c.params.max !== undefined) result += `.max(${c.params.max})`;
+    } else if (c.kind === "enum") {
+      const vals = c.params.values as string[];
+      if (vals && vals.length > 0) {
+        result = `z.enum([${vals.map((v) => JSON.stringify(v)).join(", ")}])`;
+      }
+    }
+  }
+  return result;
+}
+
+// ─── Public API ───────────────────────────────────────────────────────────────
+
+export function emitZodSchemas(system: IR.IRSystem): string {
+  const lines: string[] = [];
+
+  lines.push(`// Generated by BoneScript compiler.`);
+  lines.push(`import { z } from "zod";`);
+  lines.push("");
+
+  // Model schemas
+  for (const mod of system.modules) {
+    for (const model of mod.models) {
+      const schemaName = toPascalCase(model.name) + "Schema";
+      const typeName = toPascalCase(model.name);
+
+      lines.push(`export const ${schemaName} = z.object({`);
+      for (const field of model.fields) {
+        let zodType = irTypeToZod(field.type);
+        zodType = applyConstraints(zodType, field.name, model.constraints);
+        if (field.nullable) {
+          zodType = zodType + ".nullable()";
+        }
+        lines.push(`  ${field.name}: ${zodType},`);
+      }
+      lines.push(`});`);
+      lines.push(`export type ${typeName} = z.infer<typeof ${schemaName}>;`);
+      lines.push("");
+    }
+  }
+
+  // Capability input schemas
+  for (const mod of system.modules) {
+    for (const iface of mod.interfaces) {
+      for (const method of iface.methods) {
+        if (method.input.length === 0) continue;
+        const modPascal = toPascalCase(mod.name);
+        const methodPascal = toPascalCase(method.name);
+        const schemaName = `${modPascal}${methodPascal}InputSchema`;
+
+        lines.push(`export const ${schemaName} = z.object({`);
+        for (const field of method.input) {
+          const zodType = irTypeToZod(field.type);
+          lines.push(`  ${field.name}: ${zodType},`);
+        }
+        lines.push(`});`);
+        lines.push("");
+      }
+    }
+  }
+
+  return lines.join("\n");
+}
+
+export function emitZodPackageAdditions(): string {
+  return JSON.stringify({ zod: "3.22.4" }, null, 2);
+}

package/src/index.ts

@@ -40,6 +40,15 @@ export { lookupAlgorithm, listAlgorithms, listByCategory } from "./algorithm_cat
 // Extension system
 export { mergeWithExisting, extractImplementations, validateExtensions } from "./extension_manager";
 
+// New emitters
+export { emitOpenApiSpec, emitOpenApiJson } from "./emit_openapi";
+export { emitTypescriptSdk, emitSdkPackageJson } from "./emit_sdk";
+export { emitZodSchemas } from "./emit_zod";
+export { emitPostmanCollection } from "./emit_postman";
+export { emitSeedFile } from "./emit_seed";
+export { emitAuditSchema, emitAuditMiddleware } from "./emit_audit";
+export { emitAdminPanel } from "./emit_admin";
+
 /**
  * Convenience function: compile a .bone source string to files.
  */

package/src/lowering.ts

@@ -118,7 +118,7 @@ export class Lowering {
       const relatedCaps = capabilities.filter(c =>
         c.params.some(p => p.type.kind === "EntityRefType" && p.type.name === entity.name)
       );
-      modules.push(this.lowerEntity(entity, relatedCaps, stores));
+      modules.push(this.lowerEntity(entity, relatedCaps, stores, policies));
     }
 
     // Lower channels → realtime_service modules
@@ -233,7 +233,7 @@ export class Lowering {
 
   // ─── Entity Lowering ───────────────────────────────────────────────────────
 
-  private lowerEntity(entity: AST.EntityDeclNode, capabilities: AST.CapabilityDeclNode[], stores: AST.StoreDeclNode[]): IR.IRModule {
+  private lowerEntity(entity: AST.EntityDeclNode, capabilities: AST.CapabilityDeclNode[], stores: AST.StoreDeclNode[], policies: AST.PolicyDeclNode[] = []): IR.IRModule {
     const moduleId = makeId(this.systemName, "api_service", `${entity.name}Service`);
 
     // Build model from entity fields + ontology entailments
@@ -380,6 +380,9 @@ export class Lowering {
       config: {
         authenticated: entity.auth !== null && entity.auth !== "none",
         auth_method: entity.auth || "none",
+        audit: policies.some(p => p.audit === true),
+        rate_limit: policies.length > 0 && policies[0].rateLimit ? policies[0].rateLimit.count : 0,
+        rate_limit_window_ms: policies.length > 0 && policies[0].rateLimit ? (parseDurationMs(String(policies[0].rateLimit.per)) || 60000) : 60000,
       },
     };
   }