@lunora/codegen 1.0.0-alpha.43 → 1.0.0-alpha.44

package/dist/index.d.mts

@@ -122,13 +122,13 @@ interface ExternalSourceIR {
   binding: string;
   /** Whether a `columns` projection allow-list was given. */
   columns?: ReadonlyArray<string>;
-  /** `true` when a `reconcileEveryMs` was given (the incremental-mode delete-visibility companion). */
+  /** `true` when a `reconcileEveryMs` was given — reserved for a future incremental mode's delete-visibility lint; not on the typed `.source()` surface today. */
   hasReconcile?: boolean;
   /** `true` when a `tenantBy` mapper was given — the tenant-isolation boundary the `external_source_unscoped` lint checks. */
   hasTenantBy: boolean;
   /** The `idColumn` literal, when given (defaults to `"id"` at runtime). */
   idColumn?: string;
-  /** Delete-detection mode literal, when given (`"full-pull"` | `"incremental"`). */
+  /** Delete-detection mode literal, when given (`"full-pull"` today). */
   mode?: string;
   /** The membership query literal, when statically knowable. */
   query?: string;
@@ -870,6 +870,15 @@ interface StorageRulesMetadataIR {
 interface HttpRouteIR {
   /** `v.*` validators decoding the JSON request body (`.body({...})`), keyed by field. */
   body: Record<string, ValidatorIR>;
+  /**
+  * Rendered TS type of one SSE chunk — the `R` the `.stream(handler)`
+  * handler yields — inferred from the handler via the type checker. Present
+  * only when {@link HttpRouteIR.stream} is `true`; `"unknown"` when the
+  * checker can't resolve enough context. Feeds the emitted
+  * `HttpStreamRef&lt;Chunk, …>` so the chunk type flows to the client.
+  * @experimental Part of the HTTP-SSE stream surface (the `httpStreams.*` emission).
+  */
+  chunkType?: string;
   /** Export binding name of the route handler (used only for diagnostics / dedupe). */
   exportName: string;
   /** Path relative to `&lt;projectRoot>/lunora/` without extension, e.g. "http". */
@@ -1968,6 +1977,8 @@ declare const emitDataModel: (schema: SchemaIR, useUmbrella?: boolean) => string
 interface EmitApiOptions {
   agents?: ReadonlyArray<AgentIR>;
   functions: ReadonlyArray<FunctionIR>;
+  /** Typed REST routes; only `.stream()` (SSE) routes emit a `httpStreams.*` reference. */
+  httpRoutes?: ReadonlyArray<HttpRouteIR>;
   useUmbrella?: boolean;
   workflows?: ReadonlyArray<WorkflowIR>;
 }

package/dist/index.d.ts

@@ -122,13 +122,13 @@ interface ExternalSourceIR {
   binding: string;
   /** Whether a `columns` projection allow-list was given. */
   columns?: ReadonlyArray<string>;
-  /** `true` when a `reconcileEveryMs` was given (the incremental-mode delete-visibility companion). */
+  /** `true` when a `reconcileEveryMs` was given — reserved for a future incremental mode's delete-visibility lint; not on the typed `.source()` surface today. */
   hasReconcile?: boolean;
   /** `true` when a `tenantBy` mapper was given — the tenant-isolation boundary the `external_source_unscoped` lint checks. */
   hasTenantBy: boolean;
   /** The `idColumn` literal, when given (defaults to `"id"` at runtime). */
   idColumn?: string;
-  /** Delete-detection mode literal, when given (`"full-pull"` | `"incremental"`). */
+  /** Delete-detection mode literal, when given (`"full-pull"` today). */
   mode?: string;
   /** The membership query literal, when statically knowable. */
   query?: string;
@@ -870,6 +870,15 @@ interface StorageRulesMetadataIR {
 interface HttpRouteIR {
   /** `v.*` validators decoding the JSON request body (`.body({...})`), keyed by field. */
   body: Record<string, ValidatorIR>;
+  /**
+  * Rendered TS type of one SSE chunk — the `R` the `.stream(handler)`
+  * handler yields — inferred from the handler via the type checker. Present
+  * only when {@link HttpRouteIR.stream} is `true`; `"unknown"` when the
+  * checker can't resolve enough context. Feeds the emitted
+  * `HttpStreamRef&lt;Chunk, …>` so the chunk type flows to the client.
+  * @experimental Part of the HTTP-SSE stream surface (the `httpStreams.*` emission).
+  */
+  chunkType?: string;
   /** Export binding name of the route handler (used only for diagnostics / dedupe). */
   exportName: string;
   /** Path relative to `&lt;projectRoot>/lunora/` without extension, e.g. "http". */
@@ -1968,6 +1977,8 @@ declare const emitDataModel: (schema: SchemaIR, useUmbrella?: boolean) => string
 interface EmitApiOptions {
   agents?: ReadonlyArray<AgentIR>;
   functions: ReadonlyArray<FunctionIR>;
+  /** Typed REST routes; only `.stream()` (SSE) routes emit a `httpStreams.*` reference. */
+  httpRoutes?: ReadonlyArray<HttpRouteIR>;
   useUmbrella?: boolean;
   workflows?: ReadonlyArray<WorkflowIR>;
 }

package/dist/index.mjs

@@ -1,30 +1,30 @@
 export { formatAdvisories, lintSchema } from './packem_shared/formatAdvisories-DRhEiJUz.mjs';
 export { CodegenDiagnosticError, diagnosticAt } from './packem_shared/CodegenDiagnosticError-DyQ5FwkM.mjs';
 export { AGENTS_FILENAME, discoverAgents } from './packem_shared/AGENTS_FILENAME-BksnAJgx.mjs';
-export { default as discoverAuthApiCalls } from './packem_shared/discoverAuthApiCalls-WMx8L2FG.mjs';
+export { default as discoverAuthApiCalls } from './packem_shared/discoverAuthApiCalls-Dx3K42rk.mjs';
 export { CONTAINERS_FILENAME, discoverContainers } from './packem_shared/CONTAINERS_FILENAME-DjpXMqhp.mjs';
-export { default as discoverCrons } from './packem_shared/discoverCrons-DJJ3ZE5F.mjs';
-export { FLAGS_FILENAME, discoverFlags } from './packem_shared/FLAGS_FILENAME-fEZtzWXi.mjs';
-export { discoverFunctions } from './packem_shared/discoverFunctions-CZ91aenA.mjs';
-export { default as discoverHttpRoutes } from './packem_shared/discoverHttpRoutes-DNZLDCmm.mjs';
-export { default as discoverInserts } from './packem_shared/discoverInserts-DFRJhmCv.mjs';
-export { default as discoverMaskProcedures } from './packem_shared/discoverMaskProcedures-B5iFnZ-X.mjs';
-export { default as discoverMigrations } from './packem_shared/discoverMigrations-CdKtMlBc.mjs';
+export { default as discoverCrons } from './packem_shared/discoverCrons-_aosTRLr.mjs';
+export { FLAGS_FILENAME, discoverFlags } from './packem_shared/FLAGS_FILENAME-Dg4mKUuz.mjs';
+export { discoverFunctions } from './packem_shared/discoverFunctions-BJ-qR7Rg.mjs';
+export { default as discoverHttpRoutes } from './packem_shared/discoverHttpRoutes-daCzuTe8.mjs';
+export { default as discoverInserts } from './packem_shared/discoverInserts-DI4q5NxE.mjs';
+export { default as discoverMaskProcedures } from './packem_shared/discoverMaskProcedures-BcTOEKNU.mjs';
+export { default as discoverMigrations } from './packem_shared/discoverMigrations-VNUFvCwr.mjs';
 export { MUTATORS_FILENAME, discoverMutators } from './packem_shared/MUTATORS_FILENAME-BZOfUhlY.mjs';
-export { default as discoverNondeterministicCalls } from './packem_shared/discoverNondeterministicCalls-C_PrQPkA.mjs';
-export { default as discoverQueries } from './packem_shared/discoverQueries-B8W9UPrt.mjs';
+export { default as discoverNondeterministicCalls } from './packem_shared/discoverNondeterministicCalls-S0N2xLCq.mjs';
+export { default as discoverQueries } from './packem_shared/discoverQueries-CJnnnLpd.mjs';
 export { QUEUES_FILENAME, discoverQueues } from './packem_shared/QUEUES_FILENAME-Xv6Vy-Ku.mjs';
-export { default as discoverR2sqlCalls } from './packem_shared/discoverR2sqlCalls-Bm7Rfnf4.mjs';
-export { discoverRlsMetadata, default as discoverRlsProcedures } from './packem_shared/discoverRlsMetadata-B4GL4ZKm.mjs';
+export { default as discoverR2sqlCalls } from './packem_shared/discoverR2sqlCalls-pnpicWfz.mjs';
+export { discoverRlsMetadata, default as discoverRlsProcedures } from './packem_shared/discoverRlsMetadata-DppniPUH.mjs';
 export { default as discoverSchema } from './packem_shared/discoverSchema-DFWVgU5o.mjs';
 export { SHAPES_FILENAME, discoverShapes } from './packem_shared/SHAPES_FILENAME-DOhPGi-6.mjs';
-export { default as discoverStorageRulesMetadata } from './packem_shared/discoverStorageRulesMetadata-nosjYcvN.mjs';
+export { default as discoverStorageRulesMetadata } from './packem_shared/discoverStorageRulesMetadata-CnHl2rXD.mjs';
 export { WORKFLOWS_FILENAME, discoverWorkflows } from './packem_shared/WORKFLOWS_FILENAME-B2By8S4s.mjs';
-export { G as GENERATED_HEADER, e as emitAgents, a as emitApi, b as emitCollections, c as emitContainers, d as emitCrons, f as emitDataModel, g as emitDrizzleSchema, h as emitFunctions, i as emitServer, j as emitShard, k as emitVectors, l as emitWorkflows, m as emitWranglerCronTriggers } from './packem_shared/emit-DtherCpQ.mjs';
-export { emitApp } from './packem_shared/emitApp-D7daY94X.mjs';
-export { buildOpenApiDocument, emitOpenApi, emitOpenApiModule } from './packem_shared/buildOpenApiDocument-BrN41JMl.mjs';
-export { OPENRPC_VERSION, buildOpenRpcDocument, emitOpenRpc, emitOpenRpcModule } from './packem_shared/OPENRPC_VERSION-DqTYxQ22.mjs';
-export { SCHEMA_SNAPSHOT_FILENAME, createCodegenProject, refreshCodegenProject, runCodegen } from './packem_shared/SCHEMA_SNAPSHOT_FILENAME-BbF69nj9.mjs';
+export { G as GENERATED_HEADER, e as emitAgents, a as emitApi, b as emitCollections, c as emitContainers, d as emitCrons, f as emitDataModel, g as emitDrizzleSchema, h as emitFunctions, i as emitServer, j as emitShard, k as emitVectors, l as emitWorkflows, m as emitWranglerCronTriggers } from './packem_shared/emit-C_29WVlW.mjs';
+export { emitApp } from './packem_shared/emitApp-C9oljiZd.mjs';
+export { buildOpenApiDocument, emitOpenApi, emitOpenApiModule } from './packem_shared/buildOpenApiDocument-saZ_-kl4.mjs';
+export { OPENRPC_VERSION, buildOpenRpcDocument, emitOpenRpc, emitOpenRpcModule } from './packem_shared/OPENRPC_VERSION-Cyttekkt.mjs';
+export { SCHEMA_SNAPSHOT_FILENAME, createCodegenProject, refreshCodegenProject, runCodegen } from './packem_shared/SCHEMA_SNAPSHOT_FILENAME-CMjGZSa1.mjs';
 export { SCHEMA_SNAPSHOT_VERSION, SchemaSnapshotParseError, buildSchemaSnapshot, diffSchemaSnapshots, evaluateSchemaDrift, parseSchemaSnapshot, serializeSchemaSnapshot } from './packem_shared/SCHEMA_SNAPSHOT_VERSION-D0ARY6rL.mjs';
 export { schemaFromIr } from './packem_shared/schemaFromIr-DTYsLBaA.mjs';
 export { LUNORA_ERROR_CODES, validatorIrToJsonSchema } from './packem_shared/LUNORA_ERROR_CODES-DvTLozCu.mjs';

package/dist/packem_shared/{FLAGS_FILENAME-fEZtzWXi.mjs → FLAGS_FILENAME-Dg4mKUuz.mjs}

@@ -1,7 +1,7 @@
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { SyntaxKind, Node } from 'ts-morph';
-import { listLunoraSourceFiles } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const FLAGS_FILENAME = "flags.ts";
 const FLAG_TYPES = /* @__PURE__ */ new Set(["boolean", "number", "object", "string"]);

package/dist/packem_shared/{GENERATED_HEADER-B-FzJ297.mjs → GENERATED_HEADER-7W9f2IG3.mjs}

@@ -1,4 +1,4 @@
 import '@lunora/agent/component';
 import '@lunora/errors';
-export { G as GENERATED_HEADER, n as buildStorageColumns, e as emitAgents, a as emitApi, b as emitCollections, c as emitContainers, d as emitCrons, f as emitDataModel, g as emitDrizzleSchema, h as emitFunctions, o as emitQueues, p as emitSeed, i as emitServer, j as emitShard, k as emitVectors, l as emitWorkflows, m as emitWranglerCronTriggers } from './emit-DtherCpQ.mjs';
+export { G as GENERATED_HEADER, n as buildStorageColumns, e as emitAgents, a as emitApi, b as emitCollections, c as emitContainers, d as emitCrons, f as emitDataModel, g as emitDrizzleSchema, h as emitFunctions, o as emitQueues, p as emitSeed, i as emitServer, j as emitShard, k as emitVectors, l as emitWorkflows, m as emitWranglerCronTriggers } from './emit-C_29WVlW.mjs';
 import './paths-BRd6JHuF.mjs';

package/dist/packem_shared/{OPENRPC_VERSION-DqTYxQ22.mjs → OPENRPC_VERSION-Cyttekkt.mjs}

@@ -1,4 +1,4 @@
-import { G as GENERATED_HEADER } from './emit-DtherCpQ.mjs';
+import { G as GENERATED_HEADER } from './emit-C_29WVlW.mjs';
 import { s as sanitizeNamespace } from './paths-BRd6JHuF.mjs';
 import { argsObjectSchema, LUNORA_ERROR_CODES } from './LUNORA_ERROR_CODES-DvTLozCu.mjs';
 

package/dist/packem_shared/{SCHEMA_SNAPSHOT_FILENAME-BbF69nj9.mjs → SCHEMA_SNAPSHOT_FILENAME-CMjGZSa1.mjs}

@@ -4,33 +4,33 @@ import { performance } from 'node:perf_hooks';
 import { LunoraError } from '@lunora/errors';
 import { Node, SyntaxKind, Project } from 'ts-morph';
 import { lintSchema } from './formatAdvisories-DRhEiJUz.mjs';
-import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall, inlineHandler as inlineHandler$1, procedureHandler, chainUsesWrappedCall, isDatabaseAccessor, chainHasStep, discoverFunctions } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall, inlineHandler as inlineHandler$1, procedureHandler, chainUsesWrappedCall, isDatabaseAccessor, chainHasStep, discoverFunctions } from './discoverFunctions-BJ-qR7Rg.mjs';
 import { discoverAgents } from './AGENTS_FILENAME-BksnAJgx.mjs';
-import discoverAuthApiCalls from './discoverAuthApiCalls-WMx8L2FG.mjs';
+import discoverAuthApiCalls from './discoverAuthApiCalls-Dx3K42rk.mjs';
 import { discoverContainers } from './CONTAINERS_FILENAME-DjpXMqhp.mjs';
-import discoverCrons from './discoverCrons-DJJ3ZE5F.mjs';
+import discoverCrons from './discoverCrons-_aosTRLr.mjs';
 import { diagnosticAt } from './CodegenDiagnosticError-DyQ5FwkM.mjs';
-import { C as CAPABILITIES, n as buildStorageColumns, f as emitDataModel, a as emitApi, i as emitServer, h as emitFunctions, j as emitShard, b as emitCollections, c as emitContainers, l as emitWorkflows, e as emitAgents, o as emitQueues, d as emitCrons, k as emitVectors, g as emitDrizzleSchema, p as emitSeed, m as emitWranglerCronTriggers } from './emit-DtherCpQ.mjs';
-import { discoverFlagKeys } from './FLAGS_FILENAME-fEZtzWXi.mjs';
-import discoverHttpRoutes from './discoverHttpRoutes-DNZLDCmm.mjs';
-import discoverInserts from './discoverInserts-DFRJhmCv.mjs';
-import discoverMaskProcedures, { discoverMaskStrategies, discoverMaskMetadata } from './discoverMaskProcedures-B5iFnZ-X.mjs';
-import discoverMigrations from './discoverMigrations-CdKtMlBc.mjs';
+import { C as CAPABILITIES, n as buildStorageColumns, f as emitDataModel, a as emitApi, i as emitServer, h as emitFunctions, j as emitShard, b as emitCollections, c as emitContainers, l as emitWorkflows, e as emitAgents, o as emitQueues, d as emitCrons, k as emitVectors, g as emitDrizzleSchema, p as emitSeed, m as emitWranglerCronTriggers } from './emit-C_29WVlW.mjs';
+import { discoverFlagKeys } from './FLAGS_FILENAME-Dg4mKUuz.mjs';
+import discoverHttpRoutes from './discoverHttpRoutes-daCzuTe8.mjs';
+import discoverInserts from './discoverInserts-DI4q5NxE.mjs';
+import discoverMaskProcedures, { discoverMaskStrategies, discoverMaskMetadata } from './discoverMaskProcedures-BcTOEKNU.mjs';
+import discoverMigrations from './discoverMigrations-VNUFvCwr.mjs';
 import { MUTATORS_FILENAME, isDefineMutatorCallee, discoverMutators } from './MUTATORS_FILENAME-BZOfUhlY.mjs';
-import discoverNondeterministicCalls from './discoverNondeterministicCalls-C_PrQPkA.mjs';
-import discoverQueries from './discoverQueries-B8W9UPrt.mjs';
+import discoverNondeterministicCalls from './discoverNondeterministicCalls-S0N2xLCq.mjs';
+import discoverQueries from './discoverQueries-CJnnnLpd.mjs';
 import { discoverQueues } from './QUEUES_FILENAME-Xv6Vy-Ku.mjs';
-import discoverR2sqlCalls from './discoverR2sqlCalls-Bm7Rfnf4.mjs';
-import discoverRlsProcedures, { discoverRlsMetadata } from './discoverRlsMetadata-B4GL4ZKm.mjs';
+import discoverR2sqlCalls from './discoverR2sqlCalls-pnpicWfz.mjs';
+import discoverRlsProcedures, { discoverRlsMetadata } from './discoverRlsMetadata-DppniPUH.mjs';
 import discoverSchema from './discoverSchema-DFWVgU5o.mjs';
 import { secretKindOf, redact } from './redact-oTmsol5A.mjs';
 import { discoverShapes } from './SHAPES_FILENAME-DOhPGi-6.mjs';
-import discoverStorageRulesMetadata from './discoverStorageRulesMetadata-nosjYcvN.mjs';
+import discoverStorageRulesMetadata from './discoverStorageRulesMetadata-CnHl2rXD.mjs';
 import { e as enclosingExportName$2 } from './discover-ast-CT6BgBr4.mjs';
 import { discoverWorkflows } from './WORKFLOWS_FILENAME-B2By8S4s.mjs';
-import { emitApp } from './emitApp-D7daY94X.mjs';
-import { buildOpenApiDocument, emitOpenApiModule } from './buildOpenApiDocument-BrN41JMl.mjs';
-import { buildOpenRpcDocument, emitOpenRpcModule } from './OPENRPC_VERSION-DqTYxQ22.mjs';
+import { emitApp } from './emitApp-C9oljiZd.mjs';
+import { buildOpenApiDocument, emitOpenApiModule } from './buildOpenApiDocument-saZ_-kl4.mjs';
+import { buildOpenRpcDocument, emitOpenRpcModule } from './OPENRPC_VERSION-Cyttekkt.mjs';
 import { buildSchemaSnapshot, serializeSchemaSnapshot } from './SCHEMA_SNAPSHOT_VERSION-D0ARY6rL.mjs';
 
 const HTTP_VERBS$1 = /* @__PURE__ */ new Set(["delete", "get", "head", "options", "patch", "post", "put"]);
@@ -3288,7 +3288,7 @@ const runCodegen = (options) => {
   const useUmbrella = dependencies.has("lunorash");
   const emitStartedAt = timingEnabled ? performance.now() : 0;
   const dataModelContent = emitDataModel(schema, useUmbrella);
-  const apiContent = emitApi({ agents, functions, useUmbrella, workflows });
+  const apiContent = emitApi({ agents, functions, httpRoutes, useUmbrella, workflows });
   const serverContent = emitServer({
     agents,
     containers,

package/dist/packem_shared/{buildOpenApiDocument-BrN41JMl.mjs → buildOpenApiDocument-saZ_-kl4.mjs}

@@ -1,4 +1,4 @@
-import { G as GENERATED_HEADER } from './emit-DtherCpQ.mjs';
+import { G as GENERATED_HEADER } from './emit-C_29WVlW.mjs';
 import { s as sanitizeNamespace } from './paths-BRd6JHuF.mjs';
 import { LUNORA_ERROR_CODES, objectSchema, argsObjectSchema, validatorIrToJsonSchema } from './LUNORA_ERROR_CODES-DvTLozCu.mjs';
 

package/dist/packem_shared/{discoverAuthApiCalls-WMx8L2FG.mjs → discoverAuthApiCalls-Dx3K42rk.mjs}

@@ -1,7 +1,7 @@
 import { relative, sep } from 'node:path';
 import { SyntaxKind, Node } from 'ts-morph';
 import { T as TS_EXTENSION_RE, e as enclosingExportName } from './discover-ast-CT6BgBr4.mjs';
-import { listLunoraSourceFiles } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const isAuthApiCall = (call) => {
   const callee = call.getExpression();

package/dist/packem_shared/{discoverCrons-DJJ3ZE5F.mjs → discoverCrons-_aosTRLr.mjs}

@@ -2,7 +2,7 @@ import { LunoraError } from '@lunora/errors';
 import { isValidCronExpression, compileCronSchedule, CRON_SCHEDULE_KINDS } from '@lunora/scheduler';
 import { SyntaxKind, Node } from 'ts-morph';
 import { diagnosticAt } from './CodegenDiagnosticError-DyQ5FwkM.mjs';
-import { listLunoraSourceFiles } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles } from './discoverFunctions-BJ-qR7Rg.mjs';
 import { s as sanitizeNamespace } from './paths-BRd6JHuF.mjs';
 
 const CRON_METHODS = /* @__PURE__ */ new Set([...CRON_SCHEDULE_KINDS, "cron"]);

package/dist/packem_shared/{discoverFunctions-CZ91aenA.mjs → discoverFunctions-BJ-qR7Rg.mjs}

@@ -515,4 +515,4 @@ const discoverFunctions = (project, lunoraDirectory) => {
   return functions;
 };
 
-export { chainHasStep, chainUsesWrappedCall, classifyProcedureCall, discoverFunctions, inlineHandler, isDatabaseAccessor, listLunoraSourceFiles, lunoraRelativePath, procedureHandler };
+export { chainHasStep, chainUsesWrappedCall, classifyProcedureCall, discoverFunctions, inlineHandler, isDatabaseAccessor, listLunoraSourceFiles, lunoraRelativePath, procedureHandler, unwrapHandlerReturn };

package/dist/packem_shared/{discoverHttpRoutes-DNZLDCmm.mjs → discoverHttpRoutes-daCzuTe8.mjs}

@@ -1,6 +1,6 @@
 import { relative, sep } from 'node:path';
 import { Node } from 'ts-morph';
-import { listLunoraSourceFiles } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, unwrapHandlerReturn } from './discoverFunctions-BJ-qR7Rg.mjs';
 import { p as parseValidator, a as parseObjectShape } from './parse-validator-BSJo1HGP.mjs';
 
 const TS_EXTENSION_RE = /\.ts$/u;
@@ -72,6 +72,13 @@ const walkRouteChain = (terminalCall, terminalStep) => {
   state.path = root.path;
   return state;
 };
+const chunkTypeFromStreamTerminal = (call) => {
+  const handler = call.getArguments()[0];
+  if (!handler || !(Node.isArrowFunction(handler) || Node.isFunctionExpression(handler))) {
+    return "unknown";
+  }
+  return unwrapHandlerReturn(handler);
+};
 const routeFromTerminal = (call, callee, exportName, filePath) => {
   const step = callee.getName();
   if (!TERMINAL_STEPS.has(step)) {
@@ -90,6 +97,7 @@ const routeFromTerminal = (call, callee, exportName, filePath) => {
     path: state.path,
     searchParams: state.searchParams,
     stream: state.stream,
+    ...state.stream ? { chunkType: chunkTypeFromStreamTerminal(call) } : {},
     ...state.output ? { output: state.output } : {}
   };
 };

package/dist/packem_shared/{discoverInserts-DFRJhmCv.mjs → discoverInserts-DI4q5NxE.mjs}

@@ -1,6 +1,6 @@
 import { SyntaxKind, Node } from 'ts-morph';
 import { e as enclosingExportName } from './discover-ast-CT6BgBr4.mjs';
-import { listLunoraSourceFiles, lunoraRelativePath } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, lunoraRelativePath } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const isDatabaseInsertCall = (call) => {
   const callee = call.getExpression();

package/dist/packem_shared/{discoverMaskProcedures-B5iFnZ-X.mjs → discoverMaskProcedures-BcTOEKNU.mjs}

@@ -1,5 +1,5 @@
 import { Node, SyntaxKind } from 'ts-morph';
-import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const isMaskCall = (node) => {
   if (!Node.isCallExpression(node)) {

package/dist/packem_shared/{discoverMigrations-CdKtMlBc.mjs → discoverMigrations-VNUFvCwr.mjs}

@@ -1,7 +1,7 @@
 import { relative, sep } from 'node:path';
 import { SyntaxKind, Node } from 'ts-morph';
 import { diagnosticAt } from './CodegenDiagnosticError-DyQ5FwkM.mjs';
-import { listLunoraSourceFiles } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const TS_EXTENSION_RE = /\.ts$/u;
 const isDefineMigration = (identifier) => {

package/dist/packem_shared/{discoverNondeterministicCalls-C_PrQPkA.mjs → discoverNondeterministicCalls-S0N2xLCq.mjs}

@@ -1,5 +1,5 @@
 import { Node, SyntaxKind } from 'ts-morph';
-import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const PROPERTY_CALLS = {
   "crypto.getRandomValues": "crypto.getRandomValues",

package/dist/packem_shared/{discoverQueries-B8W9UPrt.mjs → discoverQueries-CJnnnLpd.mjs}

@@ -1,5 +1,5 @@
 import { SyntaxKind, Node } from 'ts-morph';
-import { listLunoraSourceFiles, lunoraRelativePath } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, lunoraRelativePath } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const INDEX_METHODS = /* @__PURE__ */ new Set(["withIndex", "withSearchIndex"]);
 const isDatabaseQueryCall = (call) => {

package/dist/packem_shared/{discoverR2sqlCalls-Bm7Rfnf4.mjs → discoverR2sqlCalls-pnpicWfz.mjs}

@@ -1,5 +1,5 @@
 import { Node, SyntaxKind } from 'ts-morph';
-import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const handlerOf = (call, receiver) => {
   if (receiver) {

package/dist/packem_shared/{discoverRlsMetadata-B4GL4ZKm.mjs → discoverRlsMetadata-DppniPUH.mjs}

@@ -1,5 +1,5 @@
 import { Node, SyntaxKind } from 'ts-morph';
-import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const isRlsCall = (node) => {
   if (!Node.isCallExpression(node)) {

package/dist/packem_shared/{discoverStorageRulesMetadata-nosjYcvN.mjs → discoverStorageRulesMetadata-CnHl2rXD.mjs}

@@ -1,5 +1,5 @@
 import { Node } from 'ts-morph';
-import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-CZ91aenA.mjs';
+import { listLunoraSourceFiles, lunoraRelativePath, classifyProcedureCall } from './discoverFunctions-BJ-qR7Rg.mjs';
 
 const STORAGE_OPERATIONS = /* @__PURE__ */ new Set(["delete", "list", "read", "write"]);
 const isStorageRulesCall = (node) => {

package/dist/packem_shared/{emit-DtherCpQ.mjs → emit-C_29WVlW.mjs}

@@ -865,15 +865,58 @@ const syntheticAgentApiFunctions = (agents, functions) => {
   }
   return definitions.filter((definition) => !taken.has(definition.exportName));
 };
+const renderHttpStreamsRef = (httpRoutes) => {
+  const streams = httpRoutes.filter((route) => route.stream);
+  if (streams.length === 0) {
+    return { block: "", body: "" };
+  }
+  const namespaces = /* @__PURE__ */ new Map();
+  for (const route of streams) {
+    const list = namespaces.get(route.filePath) ?? [];
+    list.push(route);
+    namespaces.set(route.filePath, list);
+  }
+  const sortedNamespaces = [...namespaces.entries()].toSorted(([a], [b]) => a.localeCompare(b));
+  const typeBody = sortedNamespaces.map(([file, list]) => {
+    const members = list.map((route) => {
+      const chunkType = relocateGeneratedImports(route.chunkType ?? "unknown");
+      return `        ${renderPropertyKey(route.exportName)}: HttpStreamRef<${chunkType}, ${renderArgsType(route.searchParams)}, ${renderArgsType(route.params)}>;`;
+    }).join("\n");
+    return `    ${renderPropertyKey(sanitizeNamespace(file))}: {
+${members}
+    };`;
+  }).join("\n");
+  const valueBody = sortedNamespaces.map(([file, list]) => {
+    const members = list.map(
+      (route) => `        ${renderPropertyKey(route.exportName)}: { method: ${JSON.stringify(route.method)}, path: ${JSON.stringify(route.path)} },`
+    ).join("\n");
+    return `    ${renderPropertyKey(sanitizeNamespace(file))}: {
+${members}
+    },`;
+  }).join("\n");
+  const block = `
+/** This project's HTTP-SSE stream routes (\`httpRoute.<verb>(path).stream()\`), addressable as typed references for \`client.httpStream\` / \`useHttpStream\`. */
+export interface HttpStreamsRef {
+${typeBody}
+}
+
+export const httpStreams: HttpStreamsRef = {
+${valueBody}
+};
+`;
+  return { block, body: typeBody };
+};
 const emitApi = (options) => {
-  const { agents = [], functions, useUmbrella = false, workflows = [] } = options;
+  const { agents = [], functions, httpRoutes = [], useUmbrella = false, workflows = [] } = options;
   const base = baseSpecifiers(useUmbrella);
   const publicFunctions = [...functions.filter((definition) => definition.visibility !== "internal"), ...syntheticAgentApiFunctions(agents, functions)];
   const internalFunctions = functions.filter((definition) => definition.visibility === "internal");
   const publicBody = renderApiBody(publicFunctions);
   const internalBody = renderApiBody(internalFunctions);
+  const httpStreamsRef = renderHttpStreamsRef(httpRoutes);
   const combinedBody = `${publicBody}
-${internalBody}`;
+${internalBody}
+${httpStreamsRef.body}`;
   const dataModelImports = referencedDataModelImports(combinedBody);
   const dataModelImportLine = dataModelImports.length > 0 ? `
 import type { ${dataModelImports.join(", ")} } from "./dataModel.js";
@@ -885,8 +928,9 @@ ${publicBody}
 ${internalBody}
 ` : "";
   const schedulerReferences = renderSchedulerReferences(workflows, agents);
+  const clientImports = httpStreamsRef.block === "" ? "FunctionReference" : "FunctionReference, HttpStreamRef";
   return `${GENERATED_HEADER}import { anyApi } from "${base.serverTypes}";
-import type { FunctionReference } from "${base.client}";
+import type { ${clientImports} } from "${base.client}";
 ${schedulerReferences.importLine}${dataModelImportLine}
 export interface ApiTypes {${apiBlock}}
 
@@ -896,7 +940,7 @@ export const api = anyApi as unknown as ApiTypes;
 export interface InternalApiTypes {${internalBlock}}
 
 export const internal = anyApi as unknown as InternalApiTypes;
-${schedulerReferences.block}`;
+${schedulerReferences.block}${httpStreamsRef.block}`;
 };
 const emitSeed = (enabled) => {
   if (!enabled) {

package/dist/packem_shared/{emitApp-D7daY94X.mjs → emitApp-C9oljiZd.mjs}

@@ -1,4 +1,4 @@
-import { A as APP_METHOD_CAPABILITIES, G as GENERATED_HEADER } from './emit-DtherCpQ.mjs';
+import { A as APP_METHOD_CAPABILITIES, G as GENERATED_HEADER } from './emit-C_29WVlW.mjs';
 
 const hasFlagKey = (key) => `has${key.charAt(0).toUpperCase()}${key.slice(1)}`;
 const LONG_TAIL = APP_METHOD_CAPABILITIES.map(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/codegen",
-  "version": "1.0.0-alpha.43",
+  "version": "1.0.0-alpha.44",
   "description": "Code generator for Lunora: emits _generated/{api,server,dataModel}.ts from your schema",
   "keywords": [
     "cloudflare",
@@ -46,14 +46,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/advisor": "1.0.0-alpha.27",
-    "@lunora/agent": "1.0.0-alpha.1",
-    "@lunora/container": "1.0.0-alpha.11",
-    "@lunora/errors": "1.0.0-alpha.4",
-    "@lunora/queue": "1.0.0-alpha.7",
-    "@lunora/scheduler": "1.0.0-alpha.9",
-    "@lunora/values": "1.0.0-alpha.7",
-    "@lunora/workflow": "1.0.0-alpha.9",
+    "@lunora/advisor": "1.0.0-alpha.28",
+    "@lunora/agent": "1.0.0-alpha.2",
+    "@lunora/container": "1.0.0-alpha.12",
+    "@lunora/errors": "1.0.0-alpha.5",
+    "@lunora/queue": "1.0.0-alpha.8",
+    "@lunora/scheduler": "1.0.0-alpha.10",
+    "@lunora/values": "1.0.0-alpha.8",
+    "@lunora/workflow": "1.0.0-alpha.10",
     "ts-morph": "^28.0.0"
   },
   "engines": {