bonescript-compiler 0.5.7 → 0.5.8

package/src/emit_graphql.ts

@@ -0,0 +1,161 @@
+/**
+ * BoneScript GraphQL Schema Emitter
+ * Generates schema.graphql from an IRSystem.
+ */
+
+import * as IR from "./ir";
+
+function toCamelCase(s: string): string {
+  return s.replace(/_([a-z])/g, (_, c: string) => c.toUpperCase());
+}
+
+function toCamelCasePlural(s: string): string {
+  const camel = toCamelCase(s);
+  // Simple pluralisation: append 's' (good enough for generated stubs)
+  return camel.endsWith("s") ? camel : camel + "s";
+}
+
+function toGraphQLType(irType: string): string {
+  // Handle optional<X> — nullable in GraphQL (just unwrap, no !)
+  const optMatch = irType.match(/^optional<(.+)>$/);
+  if (optMatch) return toGraphQLType(optMatch[1]);
+
+  // Handle list<X> / set<X>
+  const listMatch = irType.match(/^(list|set)<(.+)>$/);
+  if (listMatch) return `[${toGraphQLType(listMatch[2])}]`;
+
+  switch (irType) {
+    case "string":    return "String";
+    case "uint":
+    case "int":       return "Int";
+    case "float":     return "Float";
+    case "bool":      return "Boolean";
+    case "timestamp": return "String";
+    case "uuid":      return "ID";
+    case "bytes":     return "String";
+    case "json":      return "String";
+    default:          return "String";
+  }
+}
+
+function isOptional(irType: string): boolean {
+  return irType.startsWith("optional<");
+}
+
+function fieldLine(field: IR.IRField): string {
+  const gqlType = toGraphQLType(field.type);
+  const nullable = isOptional(field.type) || field.nullable;
+  return `  ${field.name}: ${gqlType}${nullable ? "" : "!"}`;
+}
+
+export function emitGraphQLSchema(system: IR.IRSystem): string {
+  const lines: string[] = [];
+
+  lines.push(`# Generated by BoneScript compiler. DO NOT EDIT.`);
+  lines.push(`# System: ${system.name} v${system.version}`);
+  lines.push(``);
+
+  // Collect all models from api_service modules
+  const apiModules = system.modules.filter(m => m.kind === "api_service" && m.models.length > 0);
+
+  const queryFields: string[] = [];
+  const mutationFields: string[] = [];
+  const extraTypes: string[] = [];
+
+  for (const mod of apiModules) {
+    const model = mod.models[0];
+    const modelName = model.name;
+    const camelName = toCamelCase(modelName.charAt(0).toLowerCase() + modelName.slice(1));
+    const camelPlural = toCamelCasePlural(modelName.charAt(0).toLowerCase() + modelName.slice(1));
+
+    // ─── type {ModelName} ───
+    lines.push(`type ${modelName} {`);
+    // Always include id, created_at, updated_at
+    lines.push(`  id: ID!`);
+    for (const field of model.fields) {
+      if (field.name === "id") continue; // already emitted
+      lines.push(fieldLine(field));
+    }
+    lines.push(`}`);
+    lines.push(``);
+
+    // ─── type {ModelName}Page ───
+    lines.push(`type ${modelName}Page {`);
+    lines.push(`  items: [${modelName}!]!`);
+    lines.push(`  total: Int!`);
+    lines.push(`  page: Int!`);
+    lines.push(`  pageSize: Int!`);
+    lines.push(`}`);
+    lines.push(``);
+
+    // ─── input {ModelName}Input ───
+    const inputFields = model.fields.filter(
+      f => !["id", "created_at", "updated_at"].includes(f.name)
+    );
+    lines.push(`input ${modelName}Input {`);
+    for (const field of inputFields) {
+      lines.push(fieldLine(field));
+    }
+    lines.push(`}`);
+    lines.push(``);
+
+    // Capability inputs + results
+    const capabilities = mod.interfaces.flatMap(i => i.methods)
+      .filter(m => !["create", "read", "update", "delete", "list"].includes(m.name));
+
+    for (const cap of capabilities) {
+      const capPascal = cap.name.charAt(0).toUpperCase() + toCamelCase(cap.name).slice(1);
+      extraTypes.push(`input ${modelName}${capPascal}Input {`);
+      for (const param of cap.input) {
+        extraTypes.push(fieldLine(param));
+      }
+      extraTypes.push(`}`);
+      extraTypes.push(``);
+    }
+
+    // ─── Query fields ───
+    queryFields.push(`  ${camelName}(id: ID!): ${modelName}`);
+    queryFields.push(`  ${camelPlural}(page: Int, pageSize: Int): ${modelName}Page`);
+
+    // ─── Mutation fields ───
+    mutationFields.push(`  create${modelName}(input: ${modelName}Input!): ${modelName}!`);
+    mutationFields.push(`  update${modelName}(id: ID!, input: ${modelName}Input!): ${modelName}!`);
+    mutationFields.push(`  delete${modelName}(id: ID!): Boolean!`);
+
+    for (const cap of capabilities) {
+      const capCamel = toCamelCase(cap.name);
+      const capPascal = cap.name.charAt(0).toUpperCase() + capCamel.slice(1);
+      mutationFields.push(`  ${capCamel}(input: ${modelName}${capPascal}Input): CapabilityResult!`);
+    }
+  }
+
+  // ─── type CapabilityResult ───
+  lines.push(`type CapabilityResult {`);
+  lines.push(`  ok: Boolean!`);
+  lines.push(`  action: String!`);
+  lines.push(`}`);
+  lines.push(``);
+
+  // ─── Extra capability input types ───
+  for (const l of extraTypes) {
+    lines.push(l);
+  }
+
+  // ─── type Query ───
+  lines.push(`type Query {`);
+  for (const f of queryFields) {
+    lines.push(f);
+  }
+  lines.push(`}`);
+  lines.push(``);
+
+  // ─── type Mutation ───
+  lines.push(`type Mutation {`);
+  for (const f of mutationFields) {
+    lines.push(f);
+  }
+  lines.push(`}`);
+  lines.push(``);
+
+  return lines.join("\n");
+}

package/src/emit_notify.ts

@@ -0,0 +1,88 @@
+/**
+ * BoneScript Notification Service Emitter
+ * Generates src/notify.ts — fires on event emissions.
+ */
+
+import * as IR from "./ir";
+
+function toPascalCase(s: string): string {
+  return s.replace(/(^|[-_\s])(\w)/g, (_, __, c: string) => c.toUpperCase());
+}
+
+export function emitNotifyService(system: IR.IRSystem): string {
+  const lines: string[] = [];
+
+  lines.push(`// Generated by BoneScript compiler.`);
+  lines.push(`// Notification service — fires on event emissions.`);
+  lines.push(`// Configure NOTIFY_PROVIDER=resend|sendgrid|log (default: log)`);
+  lines.push(`// Set NOTIFY_API_KEY and NOTIFY_FROM_EMAIL in .env`);
+  lines.push(``);
+  lines.push(`import { SystemEvent } from "./events";`);
+  lines.push(``);
+  lines.push(`export type NotifyProvider = "resend" | "sendgrid" | "log";`);
+  lines.push(``);
+  lines.push(`const PROVIDER = (process.env.NOTIFY_PROVIDER || "log") as NotifyProvider;`);
+  lines.push(`const API_KEY = process.env.NOTIFY_API_KEY || "";`);
+  lines.push(`const FROM_EMAIL = process.env.NOTIFY_FROM_EMAIL || "noreply@example.com";`);
+  lines.push(``);
+  lines.push(`export interface NotifyMessage {`);
+  lines.push(`  to: string;`);
+  lines.push(`  subject: string;`);
+  lines.push(`  body: string;`);
+  lines.push(`}`);
+  lines.push(``);
+  lines.push(`async function sendEmail(msg: NotifyMessage): Promise<void> {`);
+  lines.push(`  if (PROVIDER === "log") {`);
+  lines.push(`    console.log(\`[notify] \${msg.subject} → \${msg.to}\`);`);
+  lines.push(`    return;`);
+  lines.push(`  }`);
+  lines.push(`  if (PROVIDER === "resend") {`);
+  lines.push(`    const res = await fetch("https://api.resend.com/emails", {`);
+  lines.push(`      method: "POST",`);
+  lines.push(`      headers: { "Authorization": \`Bearer \${API_KEY}\`, "Content-Type": "application/json" },`);
+  lines.push(`      body: JSON.stringify({ from: FROM_EMAIL, to: msg.to, subject: msg.subject, html: msg.body }),`);
+  lines.push(`    });`);
+  lines.push(`    if (!res.ok) throw new Error(\`Resend error: \${res.status}\`);`);
+  lines.push(`    return;`);
+  lines.push(`  }`);
+  lines.push(`  if (PROVIDER === "sendgrid") {`);
+  lines.push(`    const res = await fetch("https://api.sendgrid.com/v3/mail/send", {`);
+  lines.push(`      method: "POST",`);
+  lines.push(`      headers: { "Authorization": \`Bearer \${API_KEY}\`, "Content-Type": "application/json" },`);
+  lines.push(`      body: JSON.stringify({ personalizations: [{ to: [{ email: msg.to }] }], from: { email: FROM_EMAIL }, subject: msg.subject, content: [{ type: "text/html", value: msg.body }] }),`);
+  lines.push(`    });`);
+  lines.push(`    if (!res.ok) throw new Error(\`SendGrid error: \${res.status}\`);`);
+  lines.push(`    return;`);
+  lines.push(`  }`);
+  lines.push(`}`);
+  lines.push(``);
+
+  // Per-event handlers
+  for (const event of system.events) {
+    const eventName = toPascalCase(event.name);
+    lines.push(`// Handler for ${eventName}`);
+    lines.push(`export async function notify${eventName}(event: SystemEvent, recipientEmail: string): Promise<void> {`);
+    lines.push(`  await sendEmail({`);
+    lines.push(`    to: recipientEmail,`);
+    lines.push(`    subject: "${eventName} notification",`);
+    lines.push(`    body: \`<p>Event <strong>${eventName}</strong> occurred.</p><pre>\${JSON.stringify(event.payload, null, 2)}</pre>\`,`);
+    lines.push(`  });`);
+    lines.push(`}`);
+    lines.push(``);
+  }
+
+  // registerNotificationHandlers
+  lines.push(`export function registerNotificationHandlers(eventBus: any): void {`);
+  lines.push(`  // TODO: implement recipient lookup per event type`);
+  for (const event of system.events) {
+    const eventName = toPascalCase(event.name);
+    lines.push(`  // eventBus.subscribe("${eventName}", async (event: SystemEvent) => {`);
+    lines.push(`  //   const recipientEmail = await lookupRecipient(event);`);
+    lines.push(`  //   await notify${eventName}(event, recipientEmail);`);
+    lines.push(`  // });`);
+  }
+  lines.push(`}`);
+  lines.push(``);
+
+  return lines.join("\n");
+}

package/src/emit_runtime.ts

@@ -57,6 +57,7 @@ export function emitPackageJson(system: IR.IRSystem): string {
       "express-rate-limit": "7.1.5",
       jsonwebtoken: "9.0.2",
       dotenv: "16.3.1",
+      "node-cron": "3.0.3",
     },
     devDependencies: {
       "@types/express": "4.17.21",
@@ -66,6 +67,7 @@ export function emitPackageJson(system: IR.IRSystem): string {
       "@types/cors": "2.8.17",
       "@types/jsonwebtoken": "9.0.5",
       "@types/uuid": "9.0.7",
+      "@types/node-cron": "3.0.11",
       typescript: "5.3.3",
       "ts-node": "10.9.2",
     },
@@ -576,6 +578,7 @@ export function emitIndex(system: IR.IRSystem): string {
   );
   if (hasBatch) {
     lines.push(`import { startBatchWorker } from "./batch";`);
+    lines.push(`import { startCronJobs } from "./cron";`);
   }
   if (hasWebSocket) {
     lines.push(`import { setupWebSocketServer } from "./websocket";`);
@@ -653,6 +656,8 @@ export function emitIndex(system: IR.IRSystem): string {
   if (hasBatch) {
     lines.push(`  // Start batch executor`);
     lines.push(`  startBatchWorker();`);
+    lines.push(`  // Start cron jobs`);
+    lines.push(`  startCronJobs();`);
   }
   lines.push(`  console.log(\`[${system.name}] Running on port \${PORT}\`);`);
   lines.push(`  console.log(\`  HTTP routes:\`);`);

package/src/index.ts

@@ -48,6 +48,9 @@ export { emitPostmanCollection } from "./emit_postman";
 export { emitSeedFile } from "./emit_seed";
 export { emitAuditSchema, emitAuditMiddleware } from "./emit_audit";
 export { emitAdminPanel } from "./emit_admin";
+export { emitNotifyService } from "./emit_notify";
+export { emitCronJobs } from "./emit_cron";
+export { emitGraphQLSchema } from "./emit_graphql";
 
 /**
  * Convenience function: compile a .bone source string to files.

package/src/scaffold.ts

@@ -15,7 +15,9 @@ export type ScaffoldDomain =
   | "realtime_collaboration";
 
 const TEMPLATES: Record<ScaffoldDomain, string> = {
-  multiplayer_game: `system MyGame {
+  multiplayer_game: `// Compile with: bonec compile {name}.bone --target nakama
+// for Nakama TypeScript runtime output instead of Express/PostgreSQL
+system MyGame {
   domain: multiplayer_game
 
   entity Player {