bonescript-compiler 0.2.1 → 0.4.0

package/src/emit_models.ts

@@ -0,0 +1,176 @@
+/**
+ * BoneScript Model Emitter
+ * Generates per-model TypeScript artifacts as specified in spec/09_CODEGEN.md §5.1:
+ *   - XxxInterface  — typed interface
+ *   - XxxSchema     — const with field metadata (type, nullable, unique, indexed)
+ *   - validateXxx() — runtime validation function derived from IR constraints
+ *
+ * These are emitted to src/models/<entity_name>.ts
+ */
+
+import * as IR from "./ir";
+import { toTsType, toSnakeCase } from "./emit_router";
+
+// ─── Per-model file ───────────────────────────────────────────────────────────
+
+export function emitModelFile(model: IR.IRModel, mod: IR.IRModule, system: IR.IRSystem): string {
+  const lines: string[] = [];
+  lines.push(`// Generated by BoneScript compiler. DO NOT EDIT.`);
+  lines.push(`// Source hash: ${system.source_hash}`);
+  lines.push(`// Module: ${mod.name}`);
+  lines.push(``);
+
+  // ── Interface ──────────────────────────────────────────────────────────────
+  lines.push(`export interface ${model.name} {`);
+  for (const field of model.fields) {
+    // Skip generated-always fields (derived columns)
+    if (field.default_value?.startsWith("GENERATED ALWAYS")) continue;
+    const nullable = field.nullable ? " | null" : "";
+    lines.push(`  ${field.name}: ${toTsType(field.type)}${nullable};`);
+  }
+  lines.push(`}`);
+  lines.push(``);
+
+  // ── Schema const ───────────────────────────────────────────────────────────
+  lines.push(`export const ${model.name}Schema = {`);
+  for (const field of model.fields) {
+    if (field.default_value?.startsWith("GENERATED ALWAYS")) continue;
+    const meta: string[] = [
+      `type: ${JSON.stringify(field.type)}`,
+      `nullable: ${field.nullable}`,
+      `unique: ${field.unique}`,
+      `indexed: ${field.indexed}`,
+    ];
+    if (field.default_value && !field.default_value.startsWith("GENERATED")) {
+      meta.push(`default: ${JSON.stringify(field.default_value)}`);
+    }
+    lines.push(`  ${field.name}: { ${meta.join(", ")} },`);
+  }
+  lines.push(`} as const;`);
+  lines.push(``);
+
+  // ── Input type (omits server-set fields) ──────────────────────────────────
+  const inputFields = model.fields.filter(f =>
+    !["id", "created_at", "updated_at"].includes(f.name) &&
+    !f.default_value?.startsWith("GENERATED ALWAYS")
+  );
+  lines.push(`export interface Create${model.name}Input {`);
+  for (const field of inputFields) {
+    const nullable = field.nullable ? "?" : "";
+    lines.push(`  ${field.name}${nullable}: ${toTsType(field.type)};`);
+  }
+  lines.push(`}`);
+  lines.push(``);
+
+  lines.push(`export interface Update${model.name}Input {`);
+  for (const field of inputFields) {
+    lines.push(`  ${field.name}?: ${toTsType(field.type)};`);
+  }
+  lines.push(`}`);
+  lines.push(``);
+
+  // ── Validation function ────────────────────────────────────────────────────
+  lines.push(`export interface ValidationError {`);
+  lines.push(`  field: string;`);
+  lines.push(`  code: string;`);
+  lines.push(`  message: string;`);
+  lines.push(`}`);
+  lines.push(``);
+  lines.push(`export function validate${model.name}(input: unknown): { ok: true; value: ${model.name} } | { ok: false; errors: ValidationError[] } {`);
+  lines.push(`  const errors: ValidationError[] = [];`);
+  lines.push(`  const data = input as Record<string, unknown>;`);
+  lines.push(``);
+
+  // Required field presence checks
+  for (const field of model.fields) {
+    if (field.nullable || field.default_value || ["id", "created_at", "updated_at"].includes(field.name)) continue;
+    if (field.default_value?.startsWith("GENERATED ALWAYS")) continue;
+    lines.push(`  if (data.${field.name} === undefined || data.${field.name} === null) {`);
+    lines.push(`    errors.push({ field: "${field.name}", code: "REQUIRED", message: "${field.name} is required" });`);
+    lines.push(`  }`);
+  }
+
+  // Type checks for primitive fields
+  for (const field of model.fields) {
+    if (["id", "created_at", "updated_at"].includes(field.name)) continue;
+    if (field.default_value?.startsWith("GENERATED ALWAYS")) continue;
+    const check = typeCheckExpr(field.type, `data.${field.name}`);
+    if (check) {
+      lines.push(`  if (data.${field.name} !== undefined && data.${field.name} !== null && !(${check})) {`);
+      lines.push(`    errors.push({ field: "${field.name}", code: "INVALID_TYPE", message: "${field.name} must be ${field.type}" });`);
+      lines.push(`  }`);
+    }
+  }
+
+  // Constraint-derived checks from model constraints
+  for (const c of model.constraints) {
+    if (c.kind === "unique") continue; // enforced by DB
+    if (c.kind === "range" && c.params["min"] !== undefined && c.params["max"] !== undefined) {
+      lines.push(`  if (typeof data.${c.target} === "number" && (data.${c.target} < ${c.params["min"]} || data.${c.target} > ${c.params["max"]})) {`);
+      lines.push(`    errors.push({ field: "${c.target}", code: "OUT_OF_RANGE", message: "${c.target} must be between ${c.params["min"]} and ${c.params["max"]}" });`);
+      lines.push(`  }`);
+    }
+    if (c.kind === "enum" && Array.isArray(c.params["values"])) {
+      const vals = (c.params["values"] as string[]).map(v => JSON.stringify(v)).join(", ");
+      lines.push(`  if (data.${c.target} !== undefined && ![${vals}].includes(data.${c.target} as string)) {`);
+      lines.push(`    errors.push({ field: "${c.target}", code: "INVALID_ENUM", message: "${c.target} must be one of: ${(c.params["values"] as string[]).join(", ")}" });`);
+      lines.push(`  }`);
+    }
+    if (c.kind === "check" && typeof c.params["expression"] === "string") {
+      // Parse length-in-range constraints like "username.length in 3..32"
+      const lenMatch = (c.params["expression"] as string).match(/^(\w+)\.length\s+in\s+(\d+)\.\.(\d+)$/);
+      if (lenMatch) {
+        const [, fieldName, minLen, maxLen] = lenMatch;
+        lines.push(`  if (typeof data.${fieldName} === "string" && (data.${fieldName}.length < ${minLen} || data.${fieldName}.length > ${maxLen})) {`);
+        lines.push(`    errors.push({ field: "${fieldName}", code: "INVALID_LENGTH", message: "${fieldName} must be between ${minLen} and ${maxLen} characters" });`);
+        lines.push(`  }`);
+      }
+      // Parse non-negative constraints like "score >= 0"
+      const nonNegMatch = (c.params["expression"] as string).match(/^(\w+)\s*>=\s*0$/);
+      if (nonNegMatch) {
+        const [, fieldName] = nonNegMatch;
+        lines.push(`  if (typeof data.${fieldName} === "number" && data.${fieldName} < 0) {`);
+        lines.push(`    errors.push({ field: "${fieldName}", code: "OUT_OF_RANGE", message: "${fieldName} must be >= 0" });`);
+        lines.push(`  }`);
+      }
+    }
+  }
+
+  lines.push(``);
+  lines.push(`  if (errors.length > 0) return { ok: false, errors };`);
+  lines.push(`  return { ok: true, value: data as unknown as ${model.name} };`);
+  lines.push(`}`);
+  lines.push(``);
+
+  return lines.join("\n");
+}
+
+function typeCheckExpr(irType: string, expr: string): string | null {
+  switch (irType) {
+    case "string":    return `typeof ${expr} === "string"`;
+    case "uint":      return `typeof ${expr} === "number" && Number.isInteger(${expr}) && ${expr} >= 0`;
+    case "int":       return `typeof ${expr} === "number" && Number.isInteger(${expr})`;
+    case "float":     return `typeof ${expr} === "number"`;
+    case "bool":      return `typeof ${expr} === "boolean"`;
+    case "uuid":      return `typeof ${expr} === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(${expr})`;
+    case "timestamp": return `${expr} instanceof Date || typeof ${expr} === "string"`;
+    default:
+      if (irType.startsWith("list<") || irType.startsWith("set<")) return `Array.isArray(${expr})`;
+      return null;
+  }
+}
+
+// ─── Barrel index for all models ─────────────────────────────────────────────
+
+export function emitModelsIndex(system: IR.IRSystem): string {
+  const lines: string[] = [];
+  lines.push(`// Generated by BoneScript compiler. DO NOT EDIT.`);
+  lines.push(`// Re-exports all model interfaces, schemas, and validators.`);
+  lines.push(``);
+  for (const mod of system.modules) {
+    for (const model of mod.models) {
+      lines.push(`export * from "./${toSnakeCase(model.name)}";`);
+    }
+  }
+  return lines.join("\n");
+}

package/src/emit_openapi.ts

@@ -0,0 +1,318 @@
+/**
+ * BoneScript OpenAPI 3.1 Schema Emitter
+ * Generates a complete openapi.json for each api_service module.
+ * Implements spec/09_CODEGEN.md §2 (ApiService → JSON secondary target).
+ *
+ * Produces: openapi.json at the project root.
+ */
+
+import * as IR from "./ir";
+
+// ─── Type mapping ─────────────────────────────────────────────────────────────
+
+function irTypeToJsonSchema(irType: string): Record<string, unknown> {
+  switch (irType) {
+    case "string":    return { type: "string" };
+    case "uint":      return { type: "integer", minimum: 0 };
+    case "int":       return { type: "integer" };
+    case "float":     return { type: "number" };
+    case "bool":      return { type: "boolean" };
+    case "timestamp": return { type: "string", format: "date-time" };
+    case "uuid":      return { type: "string", format: "uuid" };
+    case "bytes":     return { type: "string", format: "byte" };
+    case "json":      return {};
+    default: {
+      const listMatch = irType.match(/^list<(.+)>$/);
+      if (listMatch) return { type: "array", items: irTypeToJsonSchema(listMatch[1]) };
+      const setMatch = irType.match(/^set<(.+)>$/);
+      if (setMatch) return { type: "array", items: irTypeToJsonSchema(setMatch[1]), uniqueItems: true };
+      const optMatch = irType.match(/^optional<(.+)>$/);
+      if (optMatch) return { oneOf: [irTypeToJsonSchema(optMatch[1]), { type: "null" }] };
+      // Entity reference — use $ref
+      return { $ref: `#/components/schemas/${irType}` };
+    }
+  }
+}
+
+function modelToSchema(model: IR.IRModel): Record<string, unknown> {
+  const properties: Record<string, unknown> = {};
+  const required: string[] = [];
+
+  for (const field of model.fields) {
+    if (field.default_value?.startsWith("GENERATED ALWAYS")) continue;
+    properties[field.name] = irTypeToJsonSchema(field.type);
+    if (!field.nullable && !field.default_value) {
+      required.push(field.name);
+    }
+  }
+
+  return {
+    type: "object",
+    properties,
+    ...(required.length > 0 ? { required } : {}),
+  };
+}
+
+function toSnakeCase(s: string): string {
+  return s.replace(/([a-z])([A-Z])/g, "$1_$2").toLowerCase();
+}
+
+// ─── Main emitter ─────────────────────────────────────────────────────────────
+
+export function emitOpenApiSchema(system: IR.IRSystem): string {
+  const apiModules = system.modules.filter(m => m.kind === "api_service" && m.models.length > 0);
+  if (apiModules.length === 0) return "";
+
+  // ── Collect all schemas ──────────────────────────────────────────────────
+  const schemas: Record<string, unknown> = {};
+
+  // Standard error schema
+  schemas["Error"] = {
+    type: "object",
+    required: ["error"],
+    properties: {
+      error: {
+        type: "object",
+        required: ["code", "message"],
+        properties: {
+          code: { type: "string" },
+          message: { type: "string" },
+        },
+      },
+    },
+  };
+
+  // Paginated result wrapper
+  schemas["PaginatedResult"] = {
+    type: "object",
+    required: ["items", "total", "page", "page_size"],
+    properties: {
+      items: { type: "array", items: {} },
+      total: { type: "integer", minimum: 0 },
+      page: { type: "integer", minimum: 1 },
+      page_size: { type: "integer", minimum: 1 },
+    },
+  };
+
+  for (const mod of apiModules) {
+    for (const model of mod.models) {
+      schemas[model.name] = modelToSchema(model);
+
+      // Create input schema (omit server-set fields)
+      const createProps: Record<string, unknown> = {};
+      const createRequired: string[] = [];
+      for (const field of model.fields) {
+        if (["id", "created_at", "updated_at"].includes(field.name)) continue;
+        if (field.default_value?.startsWith("GENERATED ALWAYS")) continue;
+        createProps[field.name] = irTypeToJsonSchema(field.type);
+        if (!field.nullable && !field.default_value) createRequired.push(field.name);
+      }
+      schemas[`Create${model.name}Input`] = {
+        type: "object",
+        properties: createProps,
+        ...(createRequired.length > 0 ? { required: createRequired } : {}),
+      };
+
+      // Update input schema (all optional)
+      const updateProps: Record<string, unknown> = {};
+      for (const field of model.fields) {
+        if (["id", "created_at", "updated_at"].includes(field.name)) continue;
+        if (field.default_value?.startsWith("GENERATED ALWAYS")) continue;
+        updateProps[field.name] = irTypeToJsonSchema(field.type);
+      }
+      schemas[`Update${model.name}Input`] = {
+        type: "object",
+        properties: updateProps,
+      };
+    }
+  }
+
+  // Event payload schemas
+  for (const ev of system.events) {
+    const props: Record<string, unknown> = {};
+    for (const field of ev.payload) {
+      props[field.name] = irTypeToJsonSchema(field.type);
+    }
+    schemas[`${ev.name}Payload`] = { type: "object", properties: props };
+  }
+
+  // ── Build paths ──────────────────────────────────────────────────────────
+  const paths: Record<string, unknown> = {};
+
+  for (const mod of apiModules) {
+    const model = mod.models[0];
+    const basePath = `/${toSnakeCase(model.name)}s`;
+    const tag = mod.name;
+
+    // GET / — list
+    paths[basePath] = {
+      get: {
+        tags: [tag],
+        summary: `List ${model.name}s`,
+        security: [{ bearerAuth: [] }],
+        parameters: [
+          { name: "page", in: "query", schema: { type: "integer", minimum: 1, default: 1 } },
+          { name: "page_size", in: "query", schema: { type: "integer", minimum: 1, maximum: 100, default: 50 } },
+        ],
+        responses: {
+          "200": {
+            description: `List of ${model.name}s`,
+            content: {
+              "application/json": {
+                schema: {
+                  allOf: [
+                    { $ref: "#/components/schemas/PaginatedResult" },
+                    { properties: { items: { type: "array", items: { $ref: `#/components/schemas/${model.name}` } } } },
+                  ],
+                },
+              },
+            },
+          },
+          "401": { $ref: "#/components/responses/Unauthorized" },
+        },
+      },
+      post: {
+        tags: [tag],
+        summary: `Create ${model.name}`,
+        security: [{ bearerAuth: [] }],
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: { $ref: `#/components/schemas/Create${model.name}Input` },
+            },
+          },
+        },
+        responses: {
+          "201": {
+            description: `${model.name} created`,
+            content: { "application/json": { schema: { $ref: `#/components/schemas/${model.name}` } } },
+          },
+          "400": { $ref: "#/components/responses/BadRequest" },
+          "401": { $ref: "#/components/responses/Unauthorized" },
+        },
+      },
+    };
+
+    // GET /:id, PUT /:id, DELETE /:id
+    const idPath = `${basePath}/{id}`;
+    paths[idPath] = {
+      parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
+      get: {
+        tags: [tag],
+        summary: `Get ${model.name} by id`,
+        security: [{ bearerAuth: [] }],
+        responses: {
+          "200": { description: `${model.name}`, content: { "application/json": { schema: { $ref: `#/components/schemas/${model.name}` } } } },
+          "401": { $ref: "#/components/responses/Unauthorized" },
+          "404": { $ref: "#/components/responses/NotFound" },
+        },
+      },
+      put: {
+        tags: [tag],
+        summary: `Update ${model.name}`,
+        security: [{ bearerAuth: [] }],
+        requestBody: {
+          required: true,
+          content: { "application/json": { schema: { $ref: `#/components/schemas/Update${model.name}Input` } } },
+        },
+        responses: {
+          "200": { description: `Updated ${model.name}`, content: { "application/json": { schema: { $ref: `#/components/schemas/${model.name}` } } } },
+          "400": { $ref: "#/components/responses/BadRequest" },
+          "401": { $ref: "#/components/responses/Unauthorized" },
+          "404": { $ref: "#/components/responses/NotFound" },
+        },
+      },
+      delete: {
+        tags: [tag],
+        summary: `Delete ${model.name}`,
+        security: [{ bearerAuth: [] }],
+        responses: {
+          "204": { description: "Deleted" },
+          "401": { $ref: "#/components/responses/Unauthorized" },
+          "404": { $ref: "#/components/responses/NotFound" },
+        },
+      },
+    };
+
+    // Capability endpoints
+    for (const iface of mod.interfaces) {
+      for (const method of iface.methods) {
+        if (["create", "read", "update", "delete", "list"].includes(method.name)) continue;
+
+        const capPath = `${basePath}/${method.name.replace(/_/g, "-")}`;
+        const inputProps: Record<string, unknown> = {};
+        for (const param of method.input) {
+          inputProps[param.name] = irTypeToJsonSchema(param.type);
+        }
+
+        paths[capPath] = {
+          post: {
+            tags: [tag],
+            summary: method.name.replace(/_/g, " "),
+            description: [
+              method.preconditions.length > 0 ? `**Preconditions:** ${method.preconditions.map(p => p.description).join("; ")}` : "",
+              method.effects.length > 0 ? `**Effects:** ${method.effects.map(e => `${e.target} ${e.op === "assign" ? "=" : e.op === "add" ? "+=" : "-="} ${e.value}`).join("; ")}` : "",
+              method.sync ? `**Sync:** ${method.sync}` : "",
+            ].filter(Boolean).join("\n\n"),
+            security: [{ bearerAuth: [] }],
+            requestBody: {
+              required: true,
+              content: {
+                "application/json": {
+                  schema: { type: "object", properties: inputProps },
+                },
+              },
+            },
+            responses: {
+              "200": { description: "Success", content: { "application/json": { schema: { type: "object", properties: { ok: { type: "boolean" }, action: { type: "string" } } } } } },
+              "401": { $ref: "#/components/responses/Unauthorized" },
+              "422": { description: "Precondition failed", content: { "application/json": { schema: { $ref: "#/components/schemas/Error" } } } },
+            },
+          },
+        };
+      }
+    }
+  }
+
+  // ── Assemble document ────────────────────────────────────────────────────
+  const doc = {
+    openapi: "3.1.0",
+    info: {
+      title: system.name,
+      version: system.version,
+      description: `Generated by BoneScript compiler. Source hash: ${system.source_hash}`,
+    },
+    servers: [
+      { url: "http://localhost:3000", description: "Local development" },
+    ],
+    tags: apiModules.map(m => ({ name: m.name, description: `${m.name} endpoints` })),
+    paths,
+    components: {
+      securitySchemes: {
+        bearerAuth: {
+          type: "http",
+          scheme: "bearer",
+          bearerFormat: "JWT",
+        },
+      },
+      schemas,
+      responses: {
+        Unauthorized: {
+          description: "Authentication required",
+          content: { "application/json": { schema: { $ref: "#/components/schemas/Error" } } },
+        },
+        NotFound: {
+          description: "Resource not found",
+          content: { "application/json": { schema: { $ref: "#/components/schemas/Error" } } },
+        },
+        BadRequest: {
+          description: "Invalid request",
+          content: { "application/json": { schema: { $ref: "#/components/schemas/Error" } } },
+        },
+      },
+    },
+  };
+
+  return JSON.stringify(doc, null, 2);
+}

package/src/emit_package.ts

@@ -0,0 +1,69 @@
+/**
+ * BoneScript Package Emitter
+ * Generates package.json and tsconfig.json for the output project.
+ */
+
+import * as IR from "./ir";
+
+function toSnakeCase(s: string): string {
+  return s.replace(/([a-z])([A-Z])/g, "$1_$2").toLowerCase();
+}
+
+export function emitPackageJson(system: IR.IRSystem): string {
+  const pkg = {
+    name: toSnakeCase(system.name),
+    version: system.version,
+    private: true,
+    scripts: {
+      build: "tsc",
+      start: "node dist/index.js",
+      dev: "ts-node src/index.ts",
+      migrate: "ts-node src/migrate.ts",
+    },
+    dependencies: {
+      express: "4.18.2",
+      pg: "8.11.3",
+      ioredis: "5.3.2",
+      ws: "8.16.0",
+      uuid: "9.0.0",
+      cors: "2.8.5",
+      helmet: "7.1.0",
+      "express-rate-limit": "7.1.5",
+      jsonwebtoken: "9.0.2",
+      dotenv: "16.3.1",
+    },
+    devDependencies: {
+      "@types/express": "4.17.21",
+      "@types/node": "18.19.0",
+      "@types/pg": "8.10.9",
+      "@types/ws": "8.5.10",
+      "@types/cors": "2.8.17",
+      "@types/jsonwebtoken": "9.0.5",
+      "@types/uuid": "9.0.7",
+      typescript: "5.3.3",
+      "ts-node": "10.9.2",
+    },
+  };
+  return JSON.stringify(pkg, null, 2);
+}
+
+export function emitTsConfig(): string {
+  const cfg = {
+    compilerOptions: {
+      target: "ES2020",
+      module: "commonjs",
+      lib: ["ES2020"],
+      outDir: "./dist",
+      rootDir: "./src",
+      strict: true,
+      esModuleInterop: true,
+      skipLibCheck: true,
+      forceConsistentCasingInFileNames: true,
+      declaration: true,
+      sourceMap: true,
+    },
+    include: ["src/**/*"],
+    exclude: ["node_modules", "dist"],
+  };
+  return JSON.stringify(cfg, null, 2);
+}