bonescript-compiler 0.5.3 → 0.5.5

package/dist/emit_maintenance.js

@@ -13,152 +13,152 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.emitMigrationDiff = exports.emitFailureRules = exports.emitHealthChecks = exports.emitMetrics = exports.emitLogger = void 0;
 // ─── Logger ──────────────────────────────────────────────────────────────────
 function emitLogger(system) {
-    return `// Generated by BoneScript compiler. DO NOT EDIT.
-// Implements spec/10 §3 (Logging Schema)
-
-import { v4 as uuid } from "uuid";
-
-export type LogLevel = "debug" | "info" | "warn" | "error" | "fatal";
-export type LogStatus = "success" | "failure" | "timeout" | "rejected";
-
-export interface LogEntry {
-  timestamp: string;
-  level: LogLevel;
-  service: string;
-  trace_id: string;
-  span_id: string;
-  event: string;
-  duration_ms?: number;
-  status: LogStatus;
-  entity_id?: string;
-  actor_id?: string | null;
-  error_code?: string | null;
-  metadata?: Record<string, unknown>;
-}
-
-class Logger {
-  private service: string;
-
-  constructor(service: string) {
-    this.service = service;
-  }
-
-  emit(entry: Omit<LogEntry, "timestamp" | "service" | "span_id">): void {
-    const full: LogEntry = {
-      timestamp: new Date().toISOString(),
-      service: this.service,
-      span_id: uuid(),
-      ...entry,
-    };
-    // In production: send to log aggregator. In dev: console.
-    const fn = entry.level === "error" || entry.level === "fatal" ? console.error : console.log;
-    fn(JSON.stringify(full));
-  }
-
-  info(event: string, fields: Partial<LogEntry> = {}): void {
-    this.emit({ level: "info", event, status: "success", trace_id: fields.trace_id || "", ...fields });
-  }
-
-  warn(event: string, fields: Partial<LogEntry> = {}): void {
-    this.emit({ level: "warn", event, status: "rejected", trace_id: fields.trace_id || "", ...fields });
-  }
-
-  error(event: string, fields: Partial<LogEntry> = {}): void {
-    this.emit({ level: "error", event, status: "failure", trace_id: fields.trace_id || "", ...fields });
-  }
-
-  debug(event: string, fields: Partial<LogEntry> = {}): void {
-    if (process.env.LOG_LEVEL === "debug") {
-      this.emit({ level: "debug", event, status: "success", trace_id: fields.trace_id || "", ...fields });
-    }
-  }
-}
-
-export function createLogger(service: string): Logger {
-  return new Logger(service);
-}
-
-export const logger = createLogger("${system.name}");
+    return `// Generated by BoneScript compiler. DO NOT EDIT.
+// Implements spec/10 §3 (Logging Schema)
+
+import { v4 as uuid } from "uuid";
+
+export type LogLevel = "debug" | "info" | "warn" | "error" | "fatal";
+export type LogStatus = "success" | "failure" | "timeout" | "rejected";
+
+export interface LogEntry {
+  timestamp: string;
+  level: LogLevel;
+  service: string;
+  trace_id: string;
+  span_id: string;
+  event: string;
+  duration_ms?: number;
+  status: LogStatus;
+  entity_id?: string;
+  actor_id?: string | null;
+  error_code?: string | null;
+  metadata?: Record<string, unknown>;
+}
+
+class Logger {
+  private service: string;
+
+  constructor(service: string) {
+    this.service = service;
+  }
+
+  emit(entry: Omit<LogEntry, "timestamp" | "service" | "span_id">): void {
+    const full: LogEntry = {
+      timestamp: new Date().toISOString(),
+      service: this.service,
+      span_id: uuid(),
+      ...entry,
+    };
+    // In production: send to log aggregator. In dev: console.
+    const fn = entry.level === "error" || entry.level === "fatal" ? console.error : console.log;
+    fn(JSON.stringify(full));
+  }
+
+  info(event: string, fields: Partial<LogEntry> = {}): void {
+    this.emit({ level: "info", event, status: "success", trace_id: fields.trace_id || "", ...fields });
+  }
+
+  warn(event: string, fields: Partial<LogEntry> = {}): void {
+    this.emit({ level: "warn", event, status: "rejected", trace_id: fields.trace_id || "", ...fields });
+  }
+
+  error(event: string, fields: Partial<LogEntry> = {}): void {
+    this.emit({ level: "error", event, status: "failure", trace_id: fields.trace_id || "", ...fields });
+  }
+
+  debug(event: string, fields: Partial<LogEntry> = {}): void {
+    if (process.env.LOG_LEVEL === "debug") {
+      this.emit({ level: "debug", event, status: "success", trace_id: fields.trace_id || "", ...fields });
+    }
+  }
+}
+
+export function createLogger(service: string): Logger {
+  return new Logger(service);
+}
+
+export const logger = createLogger("${system.name}");
 `;
 }
 exports.emitLogger = emitLogger;
 // ─── Metrics ─────────────────────────────────────────────────────────────────
 function emitMetrics() {
-    return `// Generated by BoneScript compiler. DO NOT EDIT.
-// Implements spec/10 §4 (Telemetry Hooks)
-
-interface Counter {
-  type: "counter";
-  value: number;
-  labels: Record<string, string>;
-}
-
-interface Histogram {
-  type: "histogram";
-  values: number[];
-  labels: Record<string, string>;
-}
-
-interface Gauge {
-  type: "gauge";
-  value: number;
-  labels: Record<string, string>;
-}
-
-type Metric = Counter | Histogram | Gauge;
-
-const metrics: Map<string, Metric> = new Map();
-
-function key(name: string, labels: Record<string, string>): string {
-  const parts = Object.keys(labels).sort().map(k => \`\${k}="\${labels[k]}"\`);
-  return parts.length > 0 ? \`\${name}{\${parts.join(",")}}\` : name;
-}
-
-export function counter(name: string, labels: Record<string, string> = {}): void {
-  const k = key(name, labels);
-  const existing = metrics.get(k);
-  if (existing && existing.type === "counter") {
-    existing.value++;
-  } else {
-    metrics.set(k, { type: "counter", value: 1, labels });
-  }
-}
-
-export function histogram(name: string, value: number, labels: Record<string, string> = {}): void {
-  const k = key(name, labels);
-  const existing = metrics.get(k);
-  if (existing && existing.type === "histogram") {
-    existing.values.push(value);
-  } else {
-    metrics.set(k, { type: "histogram", values: [value], labels });
-  }
-}
-
-export function gauge(name: string, value: number, labels: Record<string, string> = {}): void {
-  const k = key(name, labels);
-  metrics.set(k, { type: "gauge", value, labels });
-}
-
-export function dump(): string {
-  const lines: string[] = [];
-  for (const [k, m] of metrics.entries()) {
-    if (m.type === "counter" || m.type === "gauge") {
-      lines.push(\`\${k} \${m.value}\`);
-    } else {
-      const sum = m.values.reduce((a, b) => a + b, 0);
-      const count = m.values.length;
-      const avg = count > 0 ? sum / count : 0;
-      lines.push(\`\${k}_count \${count}\`);
-      lines.push(\`\${k}_sum \${sum}\`);
-      lines.push(\`\${k}_avg \${avg.toFixed(2)}\`);
-    }
-  }
-  return lines.join("\\n");
-}
-
-export function reset(): void {
-  metrics.clear();
-}
+    return `// Generated by BoneScript compiler. DO NOT EDIT.
+// Implements spec/10 §4 (Telemetry Hooks)
+
+interface Counter {
+  type: "counter";
+  value: number;
+  labels: Record<string, string>;
+}
+
+interface Histogram {
+  type: "histogram";
+  values: number[];
+  labels: Record<string, string>;
+}
+
+interface Gauge {
+  type: "gauge";
+  value: number;
+  labels: Record<string, string>;
+}
+
+type Metric = Counter | Histogram | Gauge;
+
+const metrics: Map<string, Metric> = new Map();
+
+function key(name: string, labels: Record<string, string>): string {
+  const parts = Object.keys(labels).sort().map(k => \`\${k}="\${labels[k]}"\`);
+  return parts.length > 0 ? \`\${name}{\${parts.join(",")}}\` : name;
+}
+
+export function counter(name: string, labels: Record<string, string> = {}): void {
+  const k = key(name, labels);
+  const existing = metrics.get(k);
+  if (existing && existing.type === "counter") {
+    existing.value++;
+  } else {
+    metrics.set(k, { type: "counter", value: 1, labels });
+  }
+}
+
+export function histogram(name: string, value: number, labels: Record<string, string> = {}): void {
+  const k = key(name, labels);
+  const existing = metrics.get(k);
+  if (existing && existing.type === "histogram") {
+    existing.values.push(value);
+  } else {
+    metrics.set(k, { type: "histogram", values: [value], labels });
+  }
+}
+
+export function gauge(name: string, value: number, labels: Record<string, string> = {}): void {
+  const k = key(name, labels);
+  metrics.set(k, { type: "gauge", value, labels });
+}
+
+export function dump(): string {
+  const lines: string[] = [];
+  for (const [k, m] of metrics.entries()) {
+    if (m.type === "counter" || m.type === "gauge") {
+      lines.push(\`\${k} \${m.value}\`);
+    } else {
+      const sum = m.values.reduce((a, b) => a + b, 0);
+      const count = m.values.length;
+      const avg = count > 0 ? sum / count : 0;
+      lines.push(\`\${k}_count \${count}\`);
+      lines.push(\`\${k}_sum \${sum}\`);
+      lines.push(\`\${k}_avg \${avg.toFixed(2)}\`);
+    }
+  }
+  return lines.join("\\n");
+}
+
+export function reset(): void {
+  metrics.clear();
+}
 `;
 }
 exports.emitMetrics = emitMetrics;
@@ -328,114 +328,114 @@ function emitFailureRules(system) {
 exports.emitFailureRules = emitFailureRules;
 // ─── Migration Diff Generator ────────────────────────────────────────────────
 function emitMigrationDiff() {
-    return `// Generated by BoneScript compiler. DO NOT EDIT.
-// Migration diff utility — compares two IR snapshots and produces ALTER statements.
-
-import * as fs from "fs";
-
-interface Field {
-  name: string;
-  type: string;
-  nullable: boolean;
-}
-
-interface Model {
-  name: string;
-  fields: Field[];
-  primary_key: string;
-}
-
-export function diffModels(oldModels: Model[], newModels: Model[]): string[] {
-  const statements: string[] = [];
-  const oldByName = new Map(oldModels.map(m => [m.name, m]));
-  const newByName = new Map(newModels.map(m => [m.name, m]));
-
-  // New tables
-  for (const [name, model] of newByName) {
-    if (!oldByName.has(name)) {
-      const tableName = toSnake(name) + "s";
-      statements.push(\`-- New table: \${tableName}\`);
-      statements.push(\`-- (Generated by previous migration)\`);
-    }
-  }
-
-  // Removed tables (warn but don't auto-drop)
-  for (const [name] of oldByName) {
-    if (!newByName.has(name)) {
-      const tableName = toSnake(name) + "s";
-      statements.push(\`-- WARNING: Table \${tableName} no longer in schema. Manual DROP required.\`);
-    }
-  }
-
-  // Modified tables
-  for (const [name, newModel] of newByName) {
-    const oldModel = oldByName.get(name);
-    if (!oldModel) continue;
-
-    const tableName = toSnake(name) + "s";
-    const oldFields = new Map(oldModel.fields.map(f => [f.name, f]));
-    const newFields = new Map(newModel.fields.map(f => [f.name, f]));
-
-    // New columns (backward-compatible)
-    for (const [fname, field] of newFields) {
-      if (!oldFields.has(fname)) {
-        const sqlType = mapType(field.type);
-        const nullability = field.nullable ? "" : " NOT NULL DEFAULT (CASE WHEN false THEN NULL ELSE NULL END)";
-        statements.push(\`ALTER TABLE \${tableName} ADD COLUMN \${fname} \${sqlType}\${nullability};\`);
-      }
-    }
-
-    // Removed columns (NOT auto-dropped — backward compat)
-    for (const [fname] of oldFields) {
-      if (!newFields.has(fname)) {
-        statements.push(\`-- WARNING: Column \${tableName}.\${fname} removed from schema. Run manually: ALTER TABLE \${tableName} DROP COLUMN \${fname};\`);
-      }
-    }
-
-    // Type changes
-    for (const [fname, newField] of newFields) {
-      const oldField = oldFields.get(fname);
-      if (!oldField) continue;
-      if (oldField.type !== newField.type) {
-        const sqlType = mapType(newField.type);
-        statements.push(\`ALTER TABLE \${tableName} ALTER COLUMN \${fname} TYPE \${sqlType};\`);
-      }
-    }
-  }
-
-  return statements;
-}
-
-function toSnake(s: string): string {
-  return s.replace(/([a-z])([A-Z])/g, "$1_$2").toLowerCase();
-}
-
-function mapType(t: string): string {
-  const map: Record<string, string> = {
-    string: "VARCHAR", uint: "BIGINT", int: "BIGINT", float: "DOUBLE PRECISION",
-    bool: "BOOLEAN", timestamp: "TIMESTAMPTZ", uuid: "UUID", bytes: "BYTEA", json: "JSONB",
-  };
-  return map[t] || "JSONB";
-}
-
-if (require.main === module) {
-  const oldFile = process.argv[2];
-  const newFile = process.argv[3];
-  if (!oldFile || !newFile) {
-    console.error("Usage: node migration-diff.js <old-ir.json> <new-ir.json>");
-    process.exit(1);
-  }
-  const oldIR = JSON.parse(fs.readFileSync(oldFile, "utf-8"));
-  const newIR = JSON.parse(fs.readFileSync(newFile, "utf-8"));
-
-  const oldModels: Model[] = [];
-  const newModels: Model[] = [];
-  for (const sys of oldIR) for (const mod of sys.modules) for (const m of mod.models) oldModels.push(m);
-  for (const sys of newIR) for (const mod of sys.modules) for (const m of mod.models) newModels.push(m);
-
-  const diff = diffModels(oldModels, newModels);
-  console.log(diff.join("\\n"));
-}
+    return `// Generated by BoneScript compiler. DO NOT EDIT.
+// Migration diff utility — compares two IR snapshots and produces ALTER statements.
+
+import * as fs from "fs";
+
+interface Field {
+  name: string;
+  type: string;
+  nullable: boolean;
+}
+
+interface Model {
+  name: string;
+  fields: Field[];
+  primary_key: string;
+}
+
+export function diffModels(oldModels: Model[], newModels: Model[]): string[] {
+  const statements: string[] = [];
+  const oldByName = new Map(oldModels.map(m => [m.name, m]));
+  const newByName = new Map(newModels.map(m => [m.name, m]));
+
+  // New tables
+  for (const [name, model] of newByName) {
+    if (!oldByName.has(name)) {
+      const tableName = toSnake(name) + "s";
+      statements.push(\`-- New table: \${tableName}\`);
+      statements.push(\`-- (Generated by previous migration)\`);
+    }
+  }
+
+  // Removed tables (warn but don't auto-drop)
+  for (const [name] of oldByName) {
+    if (!newByName.has(name)) {
+      const tableName = toSnake(name) + "s";
+      statements.push(\`-- WARNING: Table \${tableName} no longer in schema. Manual DROP required.\`);
+    }
+  }
+
+  // Modified tables
+  for (const [name, newModel] of newByName) {
+    const oldModel = oldByName.get(name);
+    if (!oldModel) continue;
+
+    const tableName = toSnake(name) + "s";
+    const oldFields = new Map(oldModel.fields.map(f => [f.name, f]));
+    const newFields = new Map(newModel.fields.map(f => [f.name, f]));
+
+    // New columns (backward-compatible)
+    for (const [fname, field] of newFields) {
+      if (!oldFields.has(fname)) {
+        const sqlType = mapType(field.type);
+        const nullability = field.nullable ? "" : " NOT NULL DEFAULT (CASE WHEN false THEN NULL ELSE NULL END)";
+        statements.push(\`ALTER TABLE \${tableName} ADD COLUMN \${fname} \${sqlType}\${nullability};\`);
+      }
+    }
+
+    // Removed columns (NOT auto-dropped — backward compat)
+    for (const [fname] of oldFields) {
+      if (!newFields.has(fname)) {
+        statements.push(\`-- WARNING: Column \${tableName}.\${fname} removed from schema. Run manually: ALTER TABLE \${tableName} DROP COLUMN \${fname};\`);
+      }
+    }
+
+    // Type changes
+    for (const [fname, newField] of newFields) {
+      const oldField = oldFields.get(fname);
+      if (!oldField) continue;
+      if (oldField.type !== newField.type) {
+        const sqlType = mapType(newField.type);
+        statements.push(\`ALTER TABLE \${tableName} ALTER COLUMN \${fname} TYPE \${sqlType};\`);
+      }
+    }
+  }
+
+  return statements;
+}
+
+function toSnake(s: string): string {
+  return s.replace(/([a-z])([A-Z])/g, "$1_$2").toLowerCase();
+}
+
+function mapType(t: string): string {
+  const map: Record<string, string> = {
+    string: "VARCHAR", uint: "BIGINT", int: "BIGINT", float: "DOUBLE PRECISION",
+    bool: "BOOLEAN", timestamp: "TIMESTAMPTZ", uuid: "UUID", bytes: "BYTEA", json: "JSONB",
+  };
+  return map[t] || "JSONB";
+}
+
+if (require.main === module) {
+  const oldFile = process.argv[2];
+  const newFile = process.argv[3];
+  if (!oldFile || !newFile) {
+    console.error("Usage: node migration-diff.js <old-ir.json> <new-ir.json>");
+    process.exit(1);
+  }
+  const oldIR = JSON.parse(fs.readFileSync(oldFile, "utf-8"));
+  const newIR = JSON.parse(fs.readFileSync(newFile, "utf-8"));
+
+  const oldModels: Model[] = [];
+  const newModels: Model[] = [];
+  for (const sys of oldIR) for (const mod of sys.modules) for (const m of mod.models) oldModels.push(m);
+  for (const sys of newIR) for (const mod of sys.modules) for (const m of mod.models) newModels.push(m);
+
+  const diff = diffModels(oldModels, newModels);
+  console.log(diff.join("\\n"));
+}
 `;
 }
 exports.emitMigrationDiff = emitMigrationDiff;

package/dist/emit_nakama.d.ts

@@ -0,0 +1,23 @@
+/**
+ * BoneScript Nakama Emitter
+ *
+ * Generates a Nakama TypeScript runtime module from an IRSystem.
+ * Output is a self-contained src/index.ts that registers:
+ *   - nk.registerRpc()  for every capability  (capability -> RPC)
+ *   - nk.registerMatch() for every realtime_service module (channel -> match handler)
+ *   - Storage helpers    for every entity/model (entity -> storage object)
+ *   - Event hooks        for every event emission (event -> stream send)
+ *
+ * Deploy with: nakama migrate up && nakama --runtime.path ./build
+ * Docs: https://heroiclabs.com/docs/nakama/server-framework/typescript-runtime/
+ */
+import * as IR from "./ir";
+export interface NakamaEmittedFile {
+    path: string;
+    content: string;
+    language: "typescript" | "json" | "markdown";
+    source_module: string;
+}
+export declare class NakamaEmitter {
+    emit(system: IR.IRSystem): NakamaEmittedFile[];
+}