@lunora/codegen 1.0.0-alpha.7 → 1.0.0-alpha.8

package/dist/index.d.mts

@@ -731,8 +731,14 @@ declare class CodegenDiagnosticError extends Error {
 * ts-morph `Node`'s position in its source file.
 *
 * Message format: `@lunora/codegen: <detail> (<file>:<line>:<column>)`
+*
+* `meta` is merged onto the returned error for callers that also carry the
+* project-wide `LunoraError` envelope (`code`/`name`/`status`) — it never
+* touches `file`/`line`/`column`, and the error stays an instance of
+* {@link CodegenDiagnosticError} so the Vite overlay's `instanceof` location
+* lookup is unaffected.
 */
-declare const diagnosticAt: (node: Node, detail: string) => CodegenDiagnosticError;
+declare const diagnosticAt: (node: Node, detail: string, meta?: Record<string, unknown>) => CodegenDiagnosticError;
 /**
 * Discover `ctx.authApi.&lt;method>(...)` (and bare `authApi.&lt;method>(...)`) calls
 * under the lunora source directory and attribute each to the exported function
@@ -1357,6 +1363,11 @@ declare const refreshCodegenProject: (project: Project, lunoraDirectory: string)
 * Top-level codegen entry. Parses `&lt;projectRoot>/lunora/schema.ts` and every
 * function file under `&lt;projectRoot>/lunora/`, then writes
 * `_generated/{api,server,dataModel}.ts` next to them.
+*
+* When `LUNORA_CODEGEN_TIMING` is set (truthy), a single diagnostic summary
+* line is written to stderr with the total wall time and the discovery-vs-emit
+* split — opt-in instrumentation that is otherwise zero-cost and side-effect-free
+* on the returned {@link CodegenResult}.
 */
 declare const runCodegen: (options: CodegenOptions) => CodegenResult;
 interface CodegenOptions {

package/dist/index.d.ts

@@ -731,8 +731,14 @@ declare class CodegenDiagnosticError extends Error {
 * ts-morph `Node`'s position in its source file.
 *
 * Message format: `@lunora/codegen: <detail> (<file>:<line>:<column>)`
+*
+* `meta` is merged onto the returned error for callers that also carry the
+* project-wide `LunoraError` envelope (`code`/`name`/`status`) — it never
+* touches `file`/`line`/`column`, and the error stays an instance of
+* {@link CodegenDiagnosticError} so the Vite overlay's `instanceof` location
+* lookup is unaffected.
 */
-declare const diagnosticAt: (node: Node, detail: string) => CodegenDiagnosticError;
+declare const diagnosticAt: (node: Node, detail: string, meta?: Record<string, unknown>) => CodegenDiagnosticError;
 /**
 * Discover `ctx.authApi.&lt;method>(...)` (and bare `authApi.&lt;method>(...)`) calls
 * under the lunora source directory and attribute each to the exported function
@@ -1357,6 +1363,11 @@ declare const refreshCodegenProject: (project: Project, lunoraDirectory: string)
 * Top-level codegen entry. Parses `&lt;projectRoot>/lunora/schema.ts` and every
 * function file under `&lt;projectRoot>/lunora/`, then writes
 * `_generated/{api,server,dataModel}.ts` next to them.
+*
+* When `LUNORA_CODEGEN_TIMING` is set (truthy), a single diagnostic summary
+* line is written to stderr with the total wall time and the discovery-vs-emit
+* split — opt-in instrumentation that is otherwise zero-cost and side-effect-free
+* on the returned {@link CodegenResult}.
 */
 declare const runCodegen: (options: CodegenOptions) => CodegenResult;
 interface CodegenOptions {

package/dist/index.mjs

@@ -1,25 +1,25 @@
 export { formatAdvisories, lintSchema } from './packem_shared/formatAdvisories-8NIv1k0I.mjs';
-export { CodegenDiagnosticError, diagnosticAt } from './packem_shared/CodegenDiagnosticError-54jWDxA9.mjs';
+export { CodegenDiagnosticError, diagnosticAt } from './packem_shared/CodegenDiagnosticError-DeblMkzO.mjs';
 export { default as discoverAuthApiCalls } from './packem_shared/discoverAuthApiCalls-C35R6z0T.mjs';
-export { CONTAINERS_FILENAME, discoverContainers } from './packem_shared/CONTAINERS_FILENAME-0K-pjNb8.mjs';
-export { default as discoverCrons } from './packem_shared/discoverCrons-BL6iGuJ3.mjs';
+export { CONTAINERS_FILENAME, discoverContainers } from './packem_shared/CONTAINERS_FILENAME-DlP6YM_Q.mjs';
+export { default as discoverCrons } from './packem_shared/discoverCrons-nHPo3UeE.mjs';
 export { discoverFunctions } from './packem_shared/discoverFunctions-DEgAcRuD.mjs';
 export { default as discoverHttpRoutes } from './packem_shared/discoverHttpRoutes-C978pBiG.mjs';
 export { default as discoverInserts } from './packem_shared/discoverInserts-pLBFsSAV.mjs';
 export { default as discoverMaskProcedures } from './packem_shared/discoverMaskProcedures-B64zA740.mjs';
-export { default as discoverMigrations } from './packem_shared/discoverMigrations-Doj_-BAA.mjs';
+export { default as discoverMigrations } from './packem_shared/discoverMigrations-Dy24kmeD.mjs';
 export { default as discoverNondeterministicCalls } from './packem_shared/discoverNondeterministicCalls-4KiPQxQU.mjs';
 export { default as discoverQueries } from './packem_shared/discoverQueries-BkIi0dBD.mjs';
 export { default as discoverR2sqlCalls } from './packem_shared/discoverR2sqlCalls-BpDqvcUn.mjs';
 export { discoverRlsMetadata, default as discoverRlsProcedures } from './packem_shared/discoverRlsMetadata-DpRB1HMe.mjs';
-export { default as discoverSchema } from './packem_shared/discoverSchema-DYl0QfDH.mjs';
+export { default as discoverSchema } from './packem_shared/discoverSchema-fVmAXacI.mjs';
 export { default as discoverStorageRulesMetadata } from './packem_shared/discoverStorageRulesMetadata-DAqJUxUv.mjs';
-export { WORKFLOWS_FILENAME, discoverWorkflows } from './packem_shared/WORKFLOWS_FILENAME-DRDQdhfq.mjs';
+export { WORKFLOWS_FILENAME, discoverWorkflows } from './packem_shared/WORKFLOWS_FILENAME-D62dcBGg.mjs';
 export { GENERATED_HEADER, emitApi, emitContainers, emitCrons, emitDataModel, emitDrizzleSchema, emitFunctions, emitServer, emitShard, emitVectors, emitWorkflows, emitWranglerCronTriggers } from './packem_shared/GENERATED_HEADER-DF1hQcix.mjs';
 export { emitApp } from './packem_shared/emitApp-Ci_hcJNO.mjs';
 export { buildOpenApiDocument, emitOpenApi, emitOpenApiModule } from './packem_shared/buildOpenApiDocument-Cns1EkCQ.mjs';
 export { OPENRPC_VERSION, buildOpenRpcDocument, emitOpenRpc, emitOpenRpcModule } from './packem_shared/OPENRPC_VERSION-C7zKVeKi.mjs';
-export { SCHEMA_SNAPSHOT_FILENAME, createCodegenProject, refreshCodegenProject, runCodegen } from './packem_shared/SCHEMA_SNAPSHOT_FILENAME-g7kpX8hu.mjs';
+export { SCHEMA_SNAPSHOT_FILENAME, createCodegenProject, refreshCodegenProject, runCodegen } from './packem_shared/SCHEMA_SNAPSHOT_FILENAME-Ic_wUaIc.mjs';
 export { SCHEMA_SNAPSHOT_VERSION, SchemaSnapshotParseError, buildSchemaSnapshot, diffSchemaSnapshots, evaluateSchemaDrift, parseSchemaSnapshot, serializeSchemaSnapshot } from './packem_shared/SCHEMA_SNAPSHOT_VERSION-DzLDbWk3.mjs';
 export { schemaFromIr } from './packem_shared/schemaFromIr-DTYsLBaA.mjs';
 export { LUNORA_ERROR_CODES, validatorIrToJsonSchema } from './packem_shared/LUNORA_ERROR_CODES-CySpQPD3.mjs';

package/dist/packem_shared/{CONTAINERS_FILENAME-0K-pjNb8.mjs → CONTAINERS_FILENAME-DlP6YM_Q.mjs}

@@ -2,7 +2,7 @@ import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { containerClassName, containerBindingName, normalizeContainerImage } from '@lunora/container';
 import { SyntaxKind, Node } from 'ts-morph';
-import { diagnosticAt } from './CodegenDiagnosticError-54jWDxA9.mjs';
+import { diagnosticAt } from './CodegenDiagnosticError-DeblMkzO.mjs';
 
 const CONTAINERS_FILENAME = "containers.ts";
 const isDefineContainer = (identifier) => {

package/dist/packem_shared/{CodegenDiagnosticError-54jWDxA9.mjs → CodegenDiagnosticError-DeblMkzO.mjs}

@@ -10,13 +10,14 @@ class CodegenDiagnosticError extends Error {
     this.column = column;
   }
 }
-const diagnosticAt = (node, detail) => {
+const diagnosticAt = (node, detail, meta) => {
   const sourceFile = node.getSourceFile();
   const file = sourceFile.getFilePath();
   const line = node.getStartLineNumber();
   const { column } = sourceFile.getLineAndColumnAtPos(node.getStart());
   const message = `@lunora/codegen: ${detail} (${file}:${line.toString()}:${column.toString()})`;
-  return new CodegenDiagnosticError(message, file, line, column);
+  const error = new CodegenDiagnosticError(message, file, line, column);
+  return meta ? Object.assign(error, meta) : error;
 };
 
 export { CodegenDiagnosticError, diagnosticAt };

package/dist/packem_shared/{SCHEMA_SNAPSHOT_FILENAME-g7kpX8hu.mjs → SCHEMA_SNAPSHOT_FILENAME-Ic_wUaIc.mjs}

@@ -1,23 +1,24 @@
 import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs';
 import { join, dirname } from 'node:path';
+import { performance } from 'node:perf_hooks';
 import { Node, SyntaxKind, Project } from 'ts-morph';
 import { lintSchema } from './formatAdvisories-8NIv1k0I.mjs';
 import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall, discoverFunctions } from './discoverFunctions-DEgAcRuD.mjs';
 import discoverAuthApiCalls from './discoverAuthApiCalls-C35R6z0T.mjs';
-import { discoverContainers } from './CONTAINERS_FILENAME-0K-pjNb8.mjs';
-import discoverCrons from './discoverCrons-BL6iGuJ3.mjs';
+import { discoverContainers } from './CONTAINERS_FILENAME-DlP6YM_Q.mjs';
+import discoverCrons from './discoverCrons-nHPo3UeE.mjs';
 import discoverHttpRoutes from './discoverHttpRoutes-C978pBiG.mjs';
 import discoverInserts from './discoverInserts-pLBFsSAV.mjs';
 import discoverMaskProcedures, { discoverMaskMetadata } from './discoverMaskProcedures-B64zA740.mjs';
-import discoverMigrations from './discoverMigrations-Doj_-BAA.mjs';
+import discoverMigrations from './discoverMigrations-Dy24kmeD.mjs';
 import discoverNondeterministicCalls from './discoverNondeterministicCalls-4KiPQxQU.mjs';
 import discoverQueries from './discoverQueries-BkIi0dBD.mjs';
 import discoverR2sqlCalls from './discoverR2sqlCalls-BpDqvcUn.mjs';
 import discoverRlsProcedures, { discoverRlsMetadata } from './discoverRlsMetadata-DpRB1HMe.mjs';
-import discoverSchema from './discoverSchema-DYl0QfDH.mjs';
+import discoverSchema from './discoverSchema-fVmAXacI.mjs';
 import discoverStorageRulesMetadata from './discoverStorageRulesMetadata-DAqJUxUv.mjs';
 import { e as enclosingExportName$1 } from './discover-ast-CT6BgBr4.mjs';
-import { discoverWorkflows } from './WORKFLOWS_FILENAME-DRDQdhfq.mjs';
+import { discoverWorkflows } from './WORKFLOWS_FILENAME-D62dcBGg.mjs';
 import { buildStorageColumns, emitDataModel, emitApi, emitServer, emitFunctions, emitShard, emitContainers, emitWorkflows, emitCrons, emitVectors, emitDrizzleSchema, emitSeed, emitWranglerCronTriggers } from './GENERATED_HEADER-DF1hQcix.mjs';
 import { emitApp } from './emitApp-Ci_hcJNO.mjs';
 import { buildOpenApiDocument, emitOpenApiModule } from './buildOpenApiDocument-Cns1EkCQ.mjs';
@@ -676,6 +677,10 @@ const readProjectVersion = (projectRoot) => {
     return void 0;
   }
 };
+const isTimingEnabled = () => {
+  const flag = process.env["LUNORA_CODEGEN_TIMING"];
+  return flag !== void 0 && flag !== "";
+};
 const findTsconfig = (startPath) => {
   let directory = existsSync(startPath) ? startPath : dirname(startPath);
   while (directory && directory !== dirname(directory)) {
@@ -717,6 +722,8 @@ const refreshCodegenProject = (project, lunoraDirectory) => {
   }
 };
 const runCodegen = (options) => {
+  const timingEnabled = isTimingEnabled();
+  const startedAt = timingEnabled ? performance.now() : 0;
   const lunoraDirectory = join(options.projectRoot, options.lunoraDirectory ?? "lunora");
   const schemaPath = join(lunoraDirectory, "schema.ts");
   if (!existsSync(schemaPath)) {
@@ -771,6 +778,7 @@ const runCodegen = (options) => {
     workflowCount: workflows.length
   });
   const useUmbrella = dependencies.has("lunorash");
+  const emitStartedAt = timingEnabled ? performance.now() : 0;
   const dataModelContent = emitDataModel(schema, useUmbrella);
   const apiContent = emitApi(functions, workflows, useUmbrella);
   const serverContent = emitServer({
@@ -889,6 +897,13 @@ const runCodegen = (options) => {
       writeIfChanged(schemaSnapshotPath, serializeSchemaSnapshot(schemaSnapshot));
     }
   }
+  if (timingEnabled) {
+    const finishedAt = performance.now();
+    const total = Math.round(finishedAt - startedAt);
+    const discovery = Math.round(emitStartedAt - startedAt);
+    const emit = Math.round(finishedAt - emitStartedAt);
+    console.error(`@lunora/codegen: codegen took ${total.toString()}ms (discovery ${discovery.toString()}ms, emit ${emit.toString()}ms)`);
+  }
   return {
     advisories,
     containers,

package/dist/packem_shared/{WORKFLOWS_FILENAME-DRDQdhfq.mjs → WORKFLOWS_FILENAME-D62dcBGg.mjs}

@@ -2,7 +2,7 @@ import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { workflowDefaultName, workflowClassName, workflowBindingName } from '@lunora/workflow';
 import { SyntaxKind, Node } from 'ts-morph';
-import { diagnosticAt } from './CodegenDiagnosticError-54jWDxA9.mjs';
+import { diagnosticAt } from './CodegenDiagnosticError-DeblMkzO.mjs';
 
 const WORKFLOWS_FILENAME = "workflows.ts";
 const isDefineWorkflow = (identifier) => {

package/dist/packem_shared/{discoverCrons-BL6iGuJ3.mjs → discoverCrons-nHPo3UeE.mjs}

@@ -1,5 +1,6 @@
 import { isValidCronExpression, compileCronSchedule, CRON_SCHEDULE_KINDS } from '@lunora/scheduler';
 import { SyntaxKind, Node } from 'ts-morph';
+import { diagnosticAt } from './CodegenDiagnosticError-DeblMkzO.mjs';
 import { listLunoraSourceFiles } from './discoverFunctions-DEgAcRuD.mjs';
 import { s as sanitizeNamespace } from './paths-BRd6JHuF.mjs';
 
@@ -71,7 +72,7 @@ const literalValue = (node, jobName) => {
   if (Node.isArrayLiteralExpression(node)) {
     return node.getElements().map((element) => literalValue(element, jobName));
   }
-  throw Object.assign(new Error(`Cron job "${jobName}" passes a non-static value where a literal is required; codegen can only read literals.`), {
+  throw diagnosticAt(node, `Cron job "${jobName}" passes a non-static value where a literal is required; codegen can only read literals.`, {
     code: "CRON_NON_STATIC_VALUE",
     name: "LunoraError",
     status: 500
@@ -81,8 +82,9 @@ const objectLiteralValue = (object, jobName) => {
   const result = {};
   for (const property of object.getProperties()) {
     if (!Node.isPropertyAssignment(property)) {
-      throw Object.assign(
-        new Error(`Cron job "${jobName}" uses an unsupported object property (shorthand/spread/method) where a static literal is required.`),
+      throw diagnosticAt(
+        property,
+        `Cron job "${jobName}" uses an unsupported object property (shorthand/spread/method) where a static literal is required.`,
         {
           code: "CRON_NON_STATIC_VALUE",
           name: "LunoraError",
@@ -100,8 +102,9 @@ const objectLiteralValue = (object, jobName) => {
 const functionPathFromArgument = (call, index, jobName) => {
   const argument = call.getArguments()[index];
   if (!argument || !Node.isPropertyAccessExpression(argument)) {
-    throw Object.assign(
-      new Error(`Cron job "${jobName}" must reference a function statically (e.g. internal.email.digest); codegen cannot resolve a dynamic reference.`),
+    throw diagnosticAt(
+      call,
+      `Cron job "${jobName}" must reference a function statically (e.g. internal.email.digest); codegen cannot resolve a dynamic reference.`,
       {
         code: "CRON_NON_STATIC_FN",
         name: "LunoraError",
@@ -112,7 +115,7 @@ const functionPathFromArgument = (call, index, jobName) => {
   const functionName = argument.getName();
   const receiver = argument.getExpression();
   if (!Node.isPropertyAccessExpression(receiver)) {
-    throw Object.assign(new Error(`Cron job "${jobName}" function reference must be of the form internal.file.fn (two property accesses).`), {
+    throw diagnosticAt(argument, `Cron job "${jobName}" function reference must be of the form internal.file.fn (two property accesses).`, {
       code: "CRON_NON_STATIC_FN",
       name: "LunoraError",
       status: 500
@@ -133,8 +136,9 @@ const resolveTarget = (call, index, jobName, workflowsByName) => {
       if (workflow) {
         return workflowTarget(workflow);
       }
-      throw Object.assign(
-        new Error(`Cron job "${jobName}" targets workflows.${argument.getName()}, but no such workflow is declared in lunora/workflows.ts.`),
+      throw diagnosticAt(
+        argument,
+        `Cron job "${jobName}" targets workflows.${argument.getName()}, but no such workflow is declared in lunora/workflows.ts.`,
         {
           code: "CRON_NON_STATIC_FN",
           name: "LunoraError",
@@ -149,10 +153,9 @@ const resolveTarget = (call, index, jobName, workflowsByName) => {
     if (workflow) {
       return workflowTarget(workflow);
     }
-    throw Object.assign(
-      new Error(
-        `Cron job "${jobName}" references "${argument.getText()}", which is neither a function (internal.file.fn / api.file.fn) nor a declared workflow in lunora/workflows.ts.`
-      ),
+    throw diagnosticAt(
+      argument,
+      `Cron job "${jobName}" references "${argument.getText()}", which is neither a function (internal.file.fn / api.file.fn) nor a declared workflow in lunora/workflows.ts.`,
       {
         code: "CRON_NON_STATIC_FN",
         name: "LunoraError",
@@ -172,7 +175,7 @@ const cronFromCall = (call, callee, builderNames, workflowsByName) => {
   }
   const name = stringArgument(call, 0);
   if (name === void 0 || name.trim() === "") {
-    throw Object.assign(new Error(`A cron ".${method}(...)" registration must pass a non-empty string-literal name as its first argument.`), {
+    throw diagnosticAt(call, `A cron ".${method}(...)" registration must pass a non-empty string-literal name as its first argument.`, {
       code: "CRON_NAME_NOT_STATIC",
       name: "LunoraError",
       status: 500
@@ -182,14 +185,14 @@ const cronFromCall = (call, callee, builderNames, workflowsByName) => {
   if (method === "cron") {
     const expression = stringArgument(call, 1);
     if (expression === void 0) {
-      throw Object.assign(new Error(`Cron job "${name}" must pass a string-literal cron expression to ".cron(...)".`), {
+      throw diagnosticAt(call, `Cron job "${name}" must pass a string-literal cron expression to ".cron(...)".`, {
         code: "CRON_EXPR_NOT_STATIC",
         name: "LunoraError",
         status: 500
       });
     }
     if (!isValidCronExpression(expression)) {
-      throw Object.assign(new Error(`Cron job "${name}" has an invalid cron expression "${expression}" — expected 5 or 6 space-separated fields.`), {
+      throw diagnosticAt(call, `Cron job "${name}" has an invalid cron expression "${expression}" — expected 5 or 6 space-separated fields.`, {
         code: "CRON_EXPR_INVALID",
         name: "LunoraError",
         status: 500
@@ -199,7 +202,7 @@ const cronFromCall = (call, callee, builderNames, workflowsByName) => {
   } else {
     const scheduleArgument = call.getArguments()[1];
     if (!scheduleArgument || !Node.isObjectLiteralExpression(scheduleArgument)) {
-      throw Object.assign(new Error(`Cron job "${name}" must pass an object-literal schedule to ".${method}(...)".`), {
+      throw diagnosticAt(call, `Cron job "${name}" must pass an object-literal schedule to ".${method}(...)".`, {
         code: "CRON_SCHEDULE_NOT_STATIC",
         name: "LunoraError",
         status: 500

package/dist/packem_shared/{discoverMigrations-Doj_-BAA.mjs → discoverMigrations-Dy24kmeD.mjs}

@@ -1,5 +1,6 @@
 import { relative, sep } from 'node:path';
 import { SyntaxKind, Node } from 'ts-morph';
+import { diagnosticAt } from './CodegenDiagnosticError-DeblMkzO.mjs';
 import { listLunoraSourceFiles } from './discoverFunctions-DEgAcRuD.mjs';
 
 const TS_EXTENSION_RE = /\.ts$/u;
@@ -43,9 +44,14 @@ const migrationFromDeclaration = (declaration, relativePath) => {
   const id = stringProperty(argument, "id");
   const exportName = declaration.getName();
   if (id === void 0 || id.trim() === "") {
-    throw Object.assign(
-      new Error(`Migration "${exportName}" in "${relativePath}" must declare \`id\` as a non-empty string literal so codegen can key the registry.`),
-      { code: "MIGRATION_ID_NOT_STATIC", name: "LunoraError", status: 500 }
+    throw diagnosticAt(
+      argument,
+      `Migration "${exportName}" in "${relativePath}" must declare \`id\` as a non-empty string literal so codegen can key the registry.`,
+      {
+        code: "MIGRATION_ID_NOT_STATIC",
+        name: "LunoraError",
+        status: 500
+      }
     );
   }
   return { exportName, filePath: relativePath, id, table: stringProperty(argument, "table") ?? "" };

package/dist/packem_shared/{discoverSchema-DYl0QfDH.mjs → discoverSchema-fVmAXacI.mjs}

@@ -1,5 +1,5 @@
 import { Node, SyntaxKind } from 'ts-morph';
-import { diagnosticAt } from './CodegenDiagnosticError-54jWDxA9.mjs';
+import { diagnosticAt } from './CodegenDiagnosticError-DeblMkzO.mjs';
 import { a as parseObjectShape } from './parse-validator-tuQtHrsr.mjs';
 import { createRequire } from 'node:module';
 import { join } from 'node:path';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/codegen",
-  "version": "1.0.0-alpha.7",
+  "version": "1.0.0-alpha.8",
   "description": "Code generator for Lunora: emits _generated/{api,server,dataModel}.ts from your schema",
   "keywords": [
     "cloudflare",