@lunora/codegen 1.0.0-alpha.10 → 1.0.0-alpha.12

package/dist/index.d.mts

@@ -312,6 +312,37 @@ interface WorkflowIR {
   name: string;
 }
 /**
+* A queue lifted from a `defineQueue()` export in `lunora/queues.ts`. Carries
+* what the emitters and the config layer need to wire the typed `ctx.queues`
+* producer, the generated worker `queue()` dispatch, and the wrangler
+* `queues.producers[]` / `queues.consumers[]` entries. Like workflows, a queue
+* is NOT a Durable Object — wrangler gets only `queues.*` entries. Names are
+* derived via `@lunora/queue`'s shared helpers so codegen and the config layer
+* can never disagree.
+*/
+interface QueueIR {
+  /** The Cloudflare `Queue` producer binding name, e.g. `QUEUE_EMAIL`. */
+  bindingName: string;
+  /** The `lunora/queues.ts` export name, e.g. `emailQueue`. */
+  exportName: string;
+  /** How the queue is consumed: `"push"` (a worker `queue()` handler) or `"pull"` (external HTTP). */
+  mode: "pull" | "push";
+  /**
+  * The stable wrangler queue name (`queues.producers[].queue`). Defaults to
+  * the kebab-cased export name (`emailQueue` → `email-queue`); a static
+  * `name:` literal in the definition overrides it.
+  */
+  name: string;
+  /** Push-consumer batch/retry tuning, mirrored onto the wrangler `queues.consumers[]` entry. */
+  tuning: {
+    deadLetterQueue?: string;
+    maxBatchSize?: number;
+    maxBatchTimeout?: number;
+    maxRetries?: number;
+    retryDelay?: number;
+  };
+}
+/**
 * A `ctx.workflows.get("name")…` call discovered in a function body — the
 * use-site analog of {@link WorkflowIR} (which is the declaration side). Feeds
 * the `workflow_unused` lint (a declared workflow with zero call sites) and the
@@ -851,6 +882,15 @@ declare const discoverNondeterministicCalls: (project: Project, lunoraDirectory:
 * dropping the rest keeps the lint input small.
 */
 declare const discoverQueries: (project: Project, lunoraDirectory: string) => QueryReadIR[];
+/** The only file queues may be declared in — mirrors `lunora/workflows.ts`. */
+declare const QUEUES_FILENAME = "queues.ts";
+/**
+* Discover every queue the project declares: exported `defineQueue()` calls in
+* `lunora/queues.ts`. Returns `[]` when the file doesn't exist. Only the
+* wrangler-relevant literals (`name`/`mode`/batch tuning) are read; the handler
+* body is runtime-only, so codegen never evaluates it.
+*/
+declare const discoverQueues: (project: Project, lunoraDirectory: string) => QueueIR[];
 /**
 * Discover `ctx.r2sql` accesses lexically inside the handler body of every
 * exported `query(...)` / `mutation(...)` registration under the lunora source
@@ -925,21 +965,23 @@ declare const emitApi: (functions: ReadonlyArray<FunctionIR>, workflows?: Readon
 interface EmitServerOptions {
   containers?: ReadonlyArray<ContainerIR>;
   hasAi?: boolean;
-  /** A `lunora/` source uses `@lunora/analytics` / `ctx.analytics` — wires the write helper onto every ctx. */
+  /** A `lunora/` source uses `@lunora/bindings/analytics` / `ctx.analytics` — wires the write helper onto every ctx. */
   hasAnalytics?: boolean;
   /** A `lunora/` source uses `@lunora/browser` / `ctx.browser` — wires `ctx.browser` onto ActionCtx only. */
   hasBrowser?: boolean;
   /** A `lunora/` source uses `@lunora/hyperdrive` / `ctx.sql` — wires `ctx.sql` onto ActionCtx only. */
   hasHyperdrive?: boolean;
-  /** A `lunora/` source uses `@lunora/images` / `ctx.images` — wires `ctx.images` onto ActionCtx only. */
+  /** A `lunora/` source uses `@lunora/bindings/images` / `ctx.images` — wires `ctx.images` onto ActionCtx only. */
   hasImages?: boolean;
-  /** A `lunora/` source uses `@lunora/kv` / `ctx.kv` — wires `ctx.kv` onto every ctx. */
+  /** A `lunora/` source uses `@lunora/bindings/kv` / `ctx.kv` — wires `ctx.kv` onto every ctx. */
   hasKv?: boolean;
   hasPayments?: boolean;
-  /** A `lunora/` source uses `@lunora/pipelines` / `ctx.pipelines` — wires `ctx.pipelines` onto ActionCtx only. */
+  /** A `lunora/` source uses `@lunora/bindings/pipelines` / `ctx.pipelines` — wires `ctx.pipelines` onto ActionCtx only. */
   hasPipelines?: boolean;
-  /** A `lunora/` source uses `@lunora/r2sql` / `ctx.r2sql` — wires `ctx.r2sql` onto ActionCtx only. */
+  /** A `lunora/` source uses `@lunora/bindings/r2sql` / `ctx.r2sql` — wires `ctx.r2sql` onto ActionCtx only. */
   hasR2sql?: boolean;
+  /** Queues declared via `defineQueue` exports — wires the typed `ctx.queues` producers onto Mutation/Action contexts. */
+  queues?: ReadonlyArray<QueueIR>;
   schema?: SchemaIR;
   storageRuleBuckets?: ReadonlyArray<string>;
   /** The project depends on the `lunora` umbrella — import base packages via its subpaths. */
@@ -957,6 +999,7 @@ declare const emitServer: ({
   hasPayments,
   hasPipelines,
   hasR2sql,
+  queues,
   schema,
   storageRuleBuckets,
   useUmbrella,
@@ -990,6 +1033,14 @@ declare const emitContainers: (containers: ReadonlyArray<ContainerIR>, jurisdict
 * when the project declares no workflows (the file is not written then).
 */
 declare const emitWorkflows: (workflows: ReadonlyArray<WorkflowIR>) => string;
+/**
+* Emit `_generated/queues.ts` — the push-consumer registry the worker `queue()`
+* handler dispatches through. Maps each push queue's stable wrangler name (which
+* `batch.queue` carries) to its `defineQueue` definition + export name. Pull
+* queues are consumed by an external worker, so they carry no handler and are
+* omitted here. Returns "" (and the file is not written) when no push queues are
+* declared — a pull-only or queue-free app keeps a clean `_generated/`.
+*/
 interface EmitShardOptions {
   advisories?: ReadonlyArray<Finding>;
   containers?: ReadonlyArray<ContainerIR>;
@@ -1005,9 +1056,13 @@ interface EmitShardOptions {
   /** A `lunora/` source reads `ctx.kv` — wires `ctx.kv` onto every ctx. */
   hasKv?: boolean;
   hasPayments?: boolean;
+  /** A `lunora/` source reads `ctx.pipelines` — wires `ctx.pipelines` onto the ActionCtx only. */
+  hasPipelines?: boolean;
   /** A `lunora/` source reads `ctx.r2sql` (R2 SQL) — wires `ctx.r2sql` onto the ActionCtx only. */
   hasR2sql?: boolean;
   maskMetadata?: MaskMetadataIR;
+  /** Queues declared via `defineQueue` exports in `lunora/queues.ts` — wires the typed `ctx.queues` producers. */
+  queues?: ReadonlyArray<QueueIR>;
   rlsMetadata?: RlsMetadataIR;
   schema: SchemaIR;
   storageRules?: StorageRulesMetadataIR;
@@ -1026,8 +1081,10 @@ declare const emitShard: ({
   hasImages,
   hasKv,
   hasPayments,
+  hasPipelines,
   hasR2sql,
   maskMetadata,
+  queues,
   rlsMetadata,
   schema,
   storageRules,
@@ -1096,7 +1153,7 @@ declare const emitWranglerCronTriggers: (crons: ReadonlyArray<CronJobIR>) => str
 interface EmitAppOptions {
   /** App uses `@lunora/ai` / `ctx.ai` → emit `.ai()` (override the Workers AI binding backing `ctx.ai`). */
   hasAi: boolean;
-  /** App uses `@lunora/analytics` / `ctx.analytics` → emit `.analytics()` (override the dataset backing `ctx.analytics`). */
+  /** App uses `@lunora/bindings/analytics` / `ctx.analytics` → emit `.analytics()` (override the dataset backing `ctx.analytics`). */
   hasAnalytics: boolean;
   /** App depends on `@lunora/auth` → emit `.auth()` + the lazy build/migrate dance. */
   hasAuth: boolean;
@@ -1110,13 +1167,15 @@ interface EmitAppOptions {
   hasHyperdrive: boolean;
   /** Schema declares **Hyperdrive-backed** `.global({ backend: "hyperdrive" })` tables → emit `.hyperdriveGlobal()` (reactive Postgres/MySQL ctx-db over Hyperdrive). */
   hasHyperdriveGlobal: boolean;
-  /** App uses `@lunora/images` / `ctx.images` → emit `.images()`. */
+  /** App uses `@lunora/bindings/images` / `ctx.images` → emit `.images()`. */
   hasImages: boolean;
-  /** App uses `@lunora/kv` / `ctx.kv` → emit `.kv()`. */
+  /** App uses `@lunora/bindings/kv` / `ctx.kv` → emit `.kv()`. */
   hasKv: boolean;
   /** App uses `@lunora/payment` / `ctx.payments` → emit `.payment()`. */
   hasPayments: boolean;
-  /** App uses `@lunora/r2sql` / `ctx.r2sql` → emit `.r2sql()`. */
+  /** App declares push queues (`defineQueue`) → wire `LUNORA_QUEUE_REGISTRY` into the worker's `queue()` consumer entry. */
+  hasQueue: boolean;
+  /** App uses `@lunora/bindings/r2sql` / `ctx.r2sql` → emit `.r2sql()`. */
   hasR2sql: boolean;
   /** App imports `@lunora/scheduler` / declares crons → emit `.scheduler()`. */
   hasScheduler: boolean;
@@ -1505,6 +1564,8 @@ interface CodegenResult {
     * `apiSpec` includes `openrpc`.
     */
     openRpcModule: string;
+    /** Push-consumer queue registry (`_generated/queues.ts`); `""` (and not written) when no push queues are declared. */
+    queues: string;
     /** Project-bound seed client (`_generated/seed.ts`); `""` (and not written) when `@lunora/seed` is not a declared dependency. */
     seed: string;
     server: string;
@@ -1515,6 +1576,13 @@ interface CodegenResult {
   };
   outputDirectory: string;
   /**
+  * Queues discovered from `defineQueue` exports in `lunora/queues.ts` — the
+  * list the config layer reconciles into wrangler's `queues.producers[]` /
+  * `queues.consumers[]`. Queues are NOT Durable Objects, so this adds no
+  * binding or migration. Empty when the project declares no queues.
+  */
+  queues: ReadonlyArray<QueueIR>;
+  /**
   * The CURRENT structural schema snapshot computed this run (tables + field
   * kinds/optionality + indexes/relations/shard mode + declared migration ids).
   * The pre-deploy drift gate diffs this against the committed baseline read
@@ -1559,4 +1627,4 @@ declare const validatorIrToJsonSchema: (validator: ValidatorIR) => JsonSchema;
 */
 declare const LUNORA_ERROR_CODES: ReadonlyArray<string>;
 declare const VERSION = "0.0.0";
-export { type AuthApiCallIR, CONTAINERS_FILENAME, CodegenDiagnosticError, type CodegenOptions, type CodegenResult, type ContainerIR, type CronJobIR, type DriftChange, type EmitAppOptions, type FieldSnapshot, type FunctionIR, GENERATED_HEADER, type HttpRouteIR, type IndexIR, type IndexSnapshot, type InsertWriteIR, LUNORA_ERROR_CODES, type MaskProcedureIR, type MigrationIR, OPENRPC_VERSION, type OpenApiEmitInput, type OpenRpcEmitInput, type ProjectIR, type QueryReadIR, type R2sqlCallIR, type RelationSnapshot, type RlsMetadataIR, type RlsPolicyIR, type RlsProcedureIR, type RlsRoleIR, SCHEMA_SNAPSHOT_FILENAME, SCHEMA_SNAPSHOT_VERSION, type SchemaDrift, type SchemaDriftDecision, type SchemaIR, type SchemaSnapshot, SchemaSnapshotParseError, type StorageRuleIR, type StorageRulesMetadataIR, type TableIR, type TableSnapshot, VERSION, type ValidatorIR, type VectorIndexIR, WORKFLOWS_FILENAME, type WorkflowIR, buildOpenApiDocument, buildOpenRpcDocument, buildSchemaSnapshot, createCodegenProject, diagnosticAt, diffSchemaSnapshots, discoverAuthApiCalls, discoverContainers, discoverCrons, discoverFunctions, discoverHttpRoutes, discoverInserts, discoverMaskProcedures, discoverMigrations, discoverNondeterministicCalls, discoverQueries, discoverR2sqlCalls, discoverRlsMetadata, discoverRlsProcedures, discoverSchema, discoverStorageRulesMetadata, discoverWorkflows, emitApi, emitApp, emitContainers, emitCrons, emitDataModel, emitDrizzleSchema, emitFunctions, emitOpenApi, emitOpenApiModule, emitOpenRpc, emitOpenRpcModule, emitServer, emitShard, emitVectors, emitWorkflows, emitWranglerCronTriggers, evaluateSchemaDrift, formatAdvisories, lintSchema, parseSchemaSnapshot, refreshCodegenProject, runCodegen, schemaFromIr, serializeSchemaSnapshot, validatorIrToJsonSchema };
+export { type AuthApiCallIR, CONTAINERS_FILENAME, CodegenDiagnosticError, type CodegenOptions, type CodegenResult, type ContainerIR, type CronJobIR, type DriftChange, type EmitAppOptions, type FieldSnapshot, type FunctionIR, GENERATED_HEADER, type HttpRouteIR, type IndexIR, type IndexSnapshot, type InsertWriteIR, LUNORA_ERROR_CODES, type MaskProcedureIR, type MigrationIR, OPENRPC_VERSION, type OpenApiEmitInput, type OpenRpcEmitInput, type ProjectIR, QUEUES_FILENAME, type QueryReadIR, type QueueIR, type R2sqlCallIR, type RelationSnapshot, type RlsMetadataIR, type RlsPolicyIR, type RlsProcedureIR, type RlsRoleIR, SCHEMA_SNAPSHOT_FILENAME, SCHEMA_SNAPSHOT_VERSION, type SchemaDrift, type SchemaDriftDecision, type SchemaIR, type SchemaSnapshot, SchemaSnapshotParseError, type StorageRuleIR, type StorageRulesMetadataIR, type TableIR, type TableSnapshot, VERSION, type ValidatorIR, type VectorIndexIR, WORKFLOWS_FILENAME, type WorkflowIR, buildOpenApiDocument, buildOpenRpcDocument, buildSchemaSnapshot, createCodegenProject, diagnosticAt, diffSchemaSnapshots, discoverAuthApiCalls, discoverContainers, discoverCrons, discoverFunctions, discoverHttpRoutes, discoverInserts, discoverMaskProcedures, discoverMigrations, discoverNondeterministicCalls, discoverQueries, discoverQueues, discoverR2sqlCalls, discoverRlsMetadata, discoverRlsProcedures, discoverSchema, discoverStorageRulesMetadata, discoverWorkflows, emitApi, emitApp, emitContainers, emitCrons, emitDataModel, emitDrizzleSchema, emitFunctions, emitOpenApi, emitOpenApiModule, emitOpenRpc, emitOpenRpcModule, emitServer, emitShard, emitVectors, emitWorkflows, emitWranglerCronTriggers, evaluateSchemaDrift, formatAdvisories, lintSchema, parseSchemaSnapshot, refreshCodegenProject, runCodegen, schemaFromIr, serializeSchemaSnapshot, validatorIrToJsonSchema };

package/dist/index.d.ts

@@ -312,6 +312,37 @@ interface WorkflowIR {
   name: string;
 }
 /**
+* A queue lifted from a `defineQueue()` export in `lunora/queues.ts`. Carries
+* what the emitters and the config layer need to wire the typed `ctx.queues`
+* producer, the generated worker `queue()` dispatch, and the wrangler
+* `queues.producers[]` / `queues.consumers[]` entries. Like workflows, a queue
+* is NOT a Durable Object — wrangler gets only `queues.*` entries. Names are
+* derived via `@lunora/queue`'s shared helpers so codegen and the config layer
+* can never disagree.
+*/
+interface QueueIR {
+  /** The Cloudflare `Queue` producer binding name, e.g. `QUEUE_EMAIL`. */
+  bindingName: string;
+  /** The `lunora/queues.ts` export name, e.g. `emailQueue`. */
+  exportName: string;
+  /** How the queue is consumed: `"push"` (a worker `queue()` handler) or `"pull"` (external HTTP). */
+  mode: "pull" | "push";
+  /**
+  * The stable wrangler queue name (`queues.producers[].queue`). Defaults to
+  * the kebab-cased export name (`emailQueue` → `email-queue`); a static
+  * `name:` literal in the definition overrides it.
+  */
+  name: string;
+  /** Push-consumer batch/retry tuning, mirrored onto the wrangler `queues.consumers[]` entry. */
+  tuning: {
+    deadLetterQueue?: string;
+    maxBatchSize?: number;
+    maxBatchTimeout?: number;
+    maxRetries?: number;
+    retryDelay?: number;
+  };
+}
+/**
 * A `ctx.workflows.get("name")…` call discovered in a function body — the
 * use-site analog of {@link WorkflowIR} (which is the declaration side). Feeds
 * the `workflow_unused` lint (a declared workflow with zero call sites) and the
@@ -851,6 +882,15 @@ declare const discoverNondeterministicCalls: (project: Project, lunoraDirectory:
 * dropping the rest keeps the lint input small.
 */
 declare const discoverQueries: (project: Project, lunoraDirectory: string) => QueryReadIR[];
+/** The only file queues may be declared in — mirrors `lunora/workflows.ts`. */
+declare const QUEUES_FILENAME = "queues.ts";
+/**
+* Discover every queue the project declares: exported `defineQueue()` calls in
+* `lunora/queues.ts`. Returns `[]` when the file doesn't exist. Only the
+* wrangler-relevant literals (`name`/`mode`/batch tuning) are read; the handler
+* body is runtime-only, so codegen never evaluates it.
+*/
+declare const discoverQueues: (project: Project, lunoraDirectory: string) => QueueIR[];
 /**
 * Discover `ctx.r2sql` accesses lexically inside the handler body of every
 * exported `query(...)` / `mutation(...)` registration under the lunora source
@@ -925,21 +965,23 @@ declare const emitApi: (functions: ReadonlyArray<FunctionIR>, workflows?: Readon
 interface EmitServerOptions {
   containers?: ReadonlyArray<ContainerIR>;
   hasAi?: boolean;
-  /** A `lunora/` source uses `@lunora/analytics` / `ctx.analytics` — wires the write helper onto every ctx. */
+  /** A `lunora/` source uses `@lunora/bindings/analytics` / `ctx.analytics` — wires the write helper onto every ctx. */
   hasAnalytics?: boolean;
   /** A `lunora/` source uses `@lunora/browser` / `ctx.browser` — wires `ctx.browser` onto ActionCtx only. */
   hasBrowser?: boolean;
   /** A `lunora/` source uses `@lunora/hyperdrive` / `ctx.sql` — wires `ctx.sql` onto ActionCtx only. */
   hasHyperdrive?: boolean;
-  /** A `lunora/` source uses `@lunora/images` / `ctx.images` — wires `ctx.images` onto ActionCtx only. */
+  /** A `lunora/` source uses `@lunora/bindings/images` / `ctx.images` — wires `ctx.images` onto ActionCtx only. */
   hasImages?: boolean;
-  /** A `lunora/` source uses `@lunora/kv` / `ctx.kv` — wires `ctx.kv` onto every ctx. */
+  /** A `lunora/` source uses `@lunora/bindings/kv` / `ctx.kv` — wires `ctx.kv` onto every ctx. */
   hasKv?: boolean;
   hasPayments?: boolean;
-  /** A `lunora/` source uses `@lunora/pipelines` / `ctx.pipelines` — wires `ctx.pipelines` onto ActionCtx only. */
+  /** A `lunora/` source uses `@lunora/bindings/pipelines` / `ctx.pipelines` — wires `ctx.pipelines` onto ActionCtx only. */
   hasPipelines?: boolean;
-  /** A `lunora/` source uses `@lunora/r2sql` / `ctx.r2sql` — wires `ctx.r2sql` onto ActionCtx only. */
+  /** A `lunora/` source uses `@lunora/bindings/r2sql` / `ctx.r2sql` — wires `ctx.r2sql` onto ActionCtx only. */
   hasR2sql?: boolean;
+  /** Queues declared via `defineQueue` exports — wires the typed `ctx.queues` producers onto Mutation/Action contexts. */
+  queues?: ReadonlyArray<QueueIR>;
   schema?: SchemaIR;
   storageRuleBuckets?: ReadonlyArray<string>;
   /** The project depends on the `lunora` umbrella — import base packages via its subpaths. */
@@ -957,6 +999,7 @@ declare const emitServer: ({
   hasPayments,
   hasPipelines,
   hasR2sql,
+  queues,
   schema,
   storageRuleBuckets,
   useUmbrella,
@@ -990,6 +1033,14 @@ declare const emitContainers: (containers: ReadonlyArray<ContainerIR>, jurisdict
 * when the project declares no workflows (the file is not written then).
 */
 declare const emitWorkflows: (workflows: ReadonlyArray<WorkflowIR>) => string;
+/**
+* Emit `_generated/queues.ts` — the push-consumer registry the worker `queue()`
+* handler dispatches through. Maps each push queue's stable wrangler name (which
+* `batch.queue` carries) to its `defineQueue` definition + export name. Pull
+* queues are consumed by an external worker, so they carry no handler and are
+* omitted here. Returns "" (and the file is not written) when no push queues are
+* declared — a pull-only or queue-free app keeps a clean `_generated/`.
+*/
 interface EmitShardOptions {
   advisories?: ReadonlyArray<Finding>;
   containers?: ReadonlyArray<ContainerIR>;
@@ -1005,9 +1056,13 @@ interface EmitShardOptions {
   /** A `lunora/` source reads `ctx.kv` — wires `ctx.kv` onto every ctx. */
   hasKv?: boolean;
   hasPayments?: boolean;
+  /** A `lunora/` source reads `ctx.pipelines` — wires `ctx.pipelines` onto the ActionCtx only. */
+  hasPipelines?: boolean;
   /** A `lunora/` source reads `ctx.r2sql` (R2 SQL) — wires `ctx.r2sql` onto the ActionCtx only. */
   hasR2sql?: boolean;
   maskMetadata?: MaskMetadataIR;
+  /** Queues declared via `defineQueue` exports in `lunora/queues.ts` — wires the typed `ctx.queues` producers. */
+  queues?: ReadonlyArray<QueueIR>;
   rlsMetadata?: RlsMetadataIR;
   schema: SchemaIR;
   storageRules?: StorageRulesMetadataIR;
@@ -1026,8 +1081,10 @@ declare const emitShard: ({
   hasImages,
   hasKv,
   hasPayments,
+  hasPipelines,
   hasR2sql,
   maskMetadata,
+  queues,
   rlsMetadata,
   schema,
   storageRules,
@@ -1096,7 +1153,7 @@ declare const emitWranglerCronTriggers: (crons: ReadonlyArray<CronJobIR>) => str
 interface EmitAppOptions {
   /** App uses `@lunora/ai` / `ctx.ai` → emit `.ai()` (override the Workers AI binding backing `ctx.ai`). */
   hasAi: boolean;
-  /** App uses `@lunora/analytics` / `ctx.analytics` → emit `.analytics()` (override the dataset backing `ctx.analytics`). */
+  /** App uses `@lunora/bindings/analytics` / `ctx.analytics` → emit `.analytics()` (override the dataset backing `ctx.analytics`). */
   hasAnalytics: boolean;
   /** App depends on `@lunora/auth` → emit `.auth()` + the lazy build/migrate dance. */
   hasAuth: boolean;
@@ -1110,13 +1167,15 @@ interface EmitAppOptions {
   hasHyperdrive: boolean;
   /** Schema declares **Hyperdrive-backed** `.global({ backend: "hyperdrive" })` tables → emit `.hyperdriveGlobal()` (reactive Postgres/MySQL ctx-db over Hyperdrive). */
   hasHyperdriveGlobal: boolean;
-  /** App uses `@lunora/images` / `ctx.images` → emit `.images()`. */
+  /** App uses `@lunora/bindings/images` / `ctx.images` → emit `.images()`. */
   hasImages: boolean;
-  /** App uses `@lunora/kv` / `ctx.kv` → emit `.kv()`. */
+  /** App uses `@lunora/bindings/kv` / `ctx.kv` → emit `.kv()`. */
   hasKv: boolean;
   /** App uses `@lunora/payment` / `ctx.payments` → emit `.payment()`. */
   hasPayments: boolean;
-  /** App uses `@lunora/r2sql` / `ctx.r2sql` → emit `.r2sql()`. */
+  /** App declares push queues (`defineQueue`) → wire `LUNORA_QUEUE_REGISTRY` into the worker's `queue()` consumer entry. */
+  hasQueue: boolean;
+  /** App uses `@lunora/bindings/r2sql` / `ctx.r2sql` → emit `.r2sql()`. */
   hasR2sql: boolean;
   /** App imports `@lunora/scheduler` / declares crons → emit `.scheduler()`. */
   hasScheduler: boolean;
@@ -1505,6 +1564,8 @@ interface CodegenResult {
     * `apiSpec` includes `openrpc`.
     */
     openRpcModule: string;
+    /** Push-consumer queue registry (`_generated/queues.ts`); `""` (and not written) when no push queues are declared. */
+    queues: string;
     /** Project-bound seed client (`_generated/seed.ts`); `""` (and not written) when `@lunora/seed` is not a declared dependency. */
     seed: string;
     server: string;
@@ -1515,6 +1576,13 @@ interface CodegenResult {
   };
   outputDirectory: string;
   /**
+  * Queues discovered from `defineQueue` exports in `lunora/queues.ts` — the
+  * list the config layer reconciles into wrangler's `queues.producers[]` /
+  * `queues.consumers[]`. Queues are NOT Durable Objects, so this adds no
+  * binding or migration. Empty when the project declares no queues.
+  */
+  queues: ReadonlyArray<QueueIR>;
+  /**
   * The CURRENT structural schema snapshot computed this run (tables + field
   * kinds/optionality + indexes/relations/shard mode + declared migration ids).
   * The pre-deploy drift gate diffs this against the committed baseline read
@@ -1559,4 +1627,4 @@ declare const validatorIrToJsonSchema: (validator: ValidatorIR) => JsonSchema;
 */
 declare const LUNORA_ERROR_CODES: ReadonlyArray<string>;
 declare const VERSION = "0.0.0";
-export { type AuthApiCallIR, CONTAINERS_FILENAME, CodegenDiagnosticError, type CodegenOptions, type CodegenResult, type ContainerIR, type CronJobIR, type DriftChange, type EmitAppOptions, type FieldSnapshot, type FunctionIR, GENERATED_HEADER, type HttpRouteIR, type IndexIR, type IndexSnapshot, type InsertWriteIR, LUNORA_ERROR_CODES, type MaskProcedureIR, type MigrationIR, OPENRPC_VERSION, type OpenApiEmitInput, type OpenRpcEmitInput, type ProjectIR, type QueryReadIR, type R2sqlCallIR, type RelationSnapshot, type RlsMetadataIR, type RlsPolicyIR, type RlsProcedureIR, type RlsRoleIR, SCHEMA_SNAPSHOT_FILENAME, SCHEMA_SNAPSHOT_VERSION, type SchemaDrift, type SchemaDriftDecision, type SchemaIR, type SchemaSnapshot, SchemaSnapshotParseError, type StorageRuleIR, type StorageRulesMetadataIR, type TableIR, type TableSnapshot, VERSION, type ValidatorIR, type VectorIndexIR, WORKFLOWS_FILENAME, type WorkflowIR, buildOpenApiDocument, buildOpenRpcDocument, buildSchemaSnapshot, createCodegenProject, diagnosticAt, diffSchemaSnapshots, discoverAuthApiCalls, discoverContainers, discoverCrons, discoverFunctions, discoverHttpRoutes, discoverInserts, discoverMaskProcedures, discoverMigrations, discoverNondeterministicCalls, discoverQueries, discoverR2sqlCalls, discoverRlsMetadata, discoverRlsProcedures, discoverSchema, discoverStorageRulesMetadata, discoverWorkflows, emitApi, emitApp, emitContainers, emitCrons, emitDataModel, emitDrizzleSchema, emitFunctions, emitOpenApi, emitOpenApiModule, emitOpenRpc, emitOpenRpcModule, emitServer, emitShard, emitVectors, emitWorkflows, emitWranglerCronTriggers, evaluateSchemaDrift, formatAdvisories, lintSchema, parseSchemaSnapshot, refreshCodegenProject, runCodegen, schemaFromIr, serializeSchemaSnapshot, validatorIrToJsonSchema };
+export { type AuthApiCallIR, CONTAINERS_FILENAME, CodegenDiagnosticError, type CodegenOptions, type CodegenResult, type ContainerIR, type CronJobIR, type DriftChange, type EmitAppOptions, type FieldSnapshot, type FunctionIR, GENERATED_HEADER, type HttpRouteIR, type IndexIR, type IndexSnapshot, type InsertWriteIR, LUNORA_ERROR_CODES, type MaskProcedureIR, type MigrationIR, OPENRPC_VERSION, type OpenApiEmitInput, type OpenRpcEmitInput, type ProjectIR, QUEUES_FILENAME, type QueryReadIR, type QueueIR, type R2sqlCallIR, type RelationSnapshot, type RlsMetadataIR, type RlsPolicyIR, type RlsProcedureIR, type RlsRoleIR, SCHEMA_SNAPSHOT_FILENAME, SCHEMA_SNAPSHOT_VERSION, type SchemaDrift, type SchemaDriftDecision, type SchemaIR, type SchemaSnapshot, SchemaSnapshotParseError, type StorageRuleIR, type StorageRulesMetadataIR, type TableIR, type TableSnapshot, VERSION, type ValidatorIR, type VectorIndexIR, WORKFLOWS_FILENAME, type WorkflowIR, buildOpenApiDocument, buildOpenRpcDocument, buildSchemaSnapshot, createCodegenProject, diagnosticAt, diffSchemaSnapshots, discoverAuthApiCalls, discoverContainers, discoverCrons, discoverFunctions, discoverHttpRoutes, discoverInserts, discoverMaskProcedures, discoverMigrations, discoverNondeterministicCalls, discoverQueries, discoverQueues, discoverR2sqlCalls, discoverRlsMetadata, discoverRlsProcedures, discoverSchema, discoverStorageRulesMetadata, discoverWorkflows, emitApi, emitApp, emitContainers, emitCrons, emitDataModel, emitDrizzleSchema, emitFunctions, emitOpenApi, emitOpenApiModule, emitOpenRpc, emitOpenRpcModule, emitServer, emitShard, emitVectors, emitWorkflows, emitWranglerCronTriggers, evaluateSchemaDrift, formatAdvisories, lintSchema, parseSchemaSnapshot, refreshCodegenProject, runCodegen, schemaFromIr, serializeSchemaSnapshot, validatorIrToJsonSchema };

package/dist/index.mjs

@@ -10,16 +10,17 @@ export { default as discoverMaskProcedures } from './packem_shared/discoverMaskP
 export { default as discoverMigrations } from './packem_shared/discoverMigrations-Bi5nJ0mJ.mjs';
 export { default as discoverNondeterministicCalls } from './packem_shared/discoverNondeterministicCalls-C4M8AXmQ.mjs';
 export { default as discoverQueries } from './packem_shared/discoverQueries-B0wGT-xe.mjs';
+export { QUEUES_FILENAME, discoverQueues } from './packem_shared/QUEUES_FILENAME-B5_eWCRe.mjs';
 export { default as discoverR2sqlCalls } from './packem_shared/discoverR2sqlCalls-BVNMd428.mjs';
 export { discoverRlsMetadata, default as discoverRlsProcedures } from './packem_shared/discoverRlsMetadata-BS9GOGC5.mjs';
 export { default as discoverSchema } from './packem_shared/discoverSchema-BnWHHJ4T.mjs';
 export { default as discoverStorageRulesMetadata } from './packem_shared/discoverStorageRulesMetadata-Da8BKXcI.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-BiFXNUvo.mjs';
-export { emitApp } from './packem_shared/emitApp-KfMaKXWe.mjs';
-export { buildOpenApiDocument, emitOpenApi, emitOpenApiModule } from './packem_shared/buildOpenApiDocument-Cu3mZl-8.mjs';
-export { OPENRPC_VERSION, buildOpenRpcDocument, emitOpenRpc, emitOpenRpcModule } from './packem_shared/OPENRPC_VERSION-B4i9Qp3v.mjs';
-export { SCHEMA_SNAPSHOT_FILENAME, createCodegenProject, refreshCodegenProject, runCodegen } from './packem_shared/SCHEMA_SNAPSHOT_FILENAME-Bvv7qa_u.mjs';
+export { GENERATED_HEADER, emitApi, emitContainers, emitCrons, emitDataModel, emitDrizzleSchema, emitFunctions, emitServer, emitShard, emitVectors, emitWorkflows, emitWranglerCronTriggers } from './packem_shared/GENERATED_HEADER-BEA7oWGC.mjs';
+export { emitApp } from './packem_shared/emitApp-DiK0QSBn.mjs';
+export { buildOpenApiDocument, emitOpenApi, emitOpenApiModule } from './packem_shared/buildOpenApiDocument-699G4RP4.mjs';
+export { OPENRPC_VERSION, buildOpenRpcDocument, emitOpenRpc, emitOpenRpcModule } from './packem_shared/OPENRPC_VERSION-CQ3f8YQ-.mjs';
+export { SCHEMA_SNAPSHOT_FILENAME, createCodegenProject, refreshCodegenProject, runCodegen } from './packem_shared/SCHEMA_SNAPSHOT_FILENAME-BXtduJFE.mjs';
 export { SCHEMA_SNAPSHOT_VERSION, SchemaSnapshotParseError, buildSchemaSnapshot, diffSchemaSnapshots, evaluateSchemaDrift, parseSchemaSnapshot, serializeSchemaSnapshot } from './packem_shared/SCHEMA_SNAPSHOT_VERSION-wWGP2_5E.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/{GENERATED_HEADER-BiFXNUvo.mjs → GENERATED_HEADER-BEA7oWGC.mjs}

@@ -722,6 +722,7 @@ const emitServer = ({
   hasPayments = false,
   hasPipelines = false,
   hasR2sql = false,
+  queues = [],
   schema,
   storageRuleBuckets = [],
   useUmbrella = false,
@@ -755,6 +756,11 @@ const emitServer = ({
       assertIdentifier(workflow.bindingName, `workflow binding "${workflow.bindingName}"`);
       return `    /** Workflow binding for the \`${workflow.exportName}\` workflow. */
     readonly ${workflow.bindingName}?: unknown;`;
+    }),
+    ...queues.map((queue) => {
+      assertIdentifier(queue.bindingName, `queue binding "${queue.bindingName}"`);
+      return `    /** Queue producer binding for the \`${queue.exportName}\` queue. */
+    readonly ${queue.bindingName}?: unknown;`;
     })
   ].join("\n");
   const envBlock = `
@@ -777,7 +783,7 @@ ${envBindingFields}` : ""}
 /** Alias for {@link CloudflareBindings} — the typed shape of \`env\`. */
 export type Env = CloudflareBindings;`;
   const kvContextField = hasKv ? `
-    readonly kv: import("@lunora/kv").Kv;` : "";
+    readonly kv: import("@lunora/bindings/kv").Kv;` : "";
   const hyperdriveActionField = hasHyperdrive ? `
     /**
      * External database access via Hyperdrive. Non-deterministic — available only in actions. Writes here are NOT tracked by Lunora live queries; subscriptions will not re-run on external DB changes.
@@ -788,18 +794,18 @@ export type Env = CloudflareBindings;`;
     readonly browser: import("@lunora/browser").Browser;` : "";
   const imagesActionField = hasImages ? `
     /** Cloudflare Images transforms (resize/format/optimize). Non-deterministic — available only in actions. */
-    readonly images: import("@lunora/images").Images;` : "";
+    readonly images: import("@lunora/bindings/images").Images;` : "";
   const analyticsContextField = hasAnalytics ? `
     /** Analytics Engine telemetry sink. Fire-and-forget and sampled; do not read it back in-handler. */
-    readonly analytics: import("@lunora/analytics").AnalyticsClient;` : "";
+    readonly analytics: import("@lunora/bindings/analytics").AnalyticsClient;` : "";
   const pipelinesActionField = hasPipelines ? `
     /** Pipelines ingestion sink (durable, R2-backed). Fire-and-forget and batched; do not read it back in-handler. */
-    readonly pipelines: import("@lunora/pipelines").PipelineClient;` : "";
+    readonly pipelines: import("@lunora/bindings/pipelines").PipelineClient;` : "";
   const r2sqlActionField = hasR2sql ? `
     /**
      * R2 SQL over Apache Iceberg tables (window functions, DISTINCT, set operations). Non-deterministic — available only in actions. Reads here are NOT tracked by Lunora live queries.
      */
-    readonly r2sql: import("@lunora/r2sql").R2SqlClient;` : "";
+    readonly r2sql: import("@lunora/bindings/r2sql").R2SqlClient;` : "";
   const hasWorkflows = workflows.length > 0;
   const workflowsTypeImport = hasWorkflows ? `import type { WorkflowHandle } from "@lunora/workflow";
 import type * as lunoraWorkflowDefinitions from "../workflows.js";
@@ -820,6 +826,21 @@ ${workflows.map((workflow) => `    get(name: ${JSON.stringify(workflow.exportNam
   const workflowsOmit = hasWorkflows ? ` | "workflows"` : "";
   const workflowsContextField = hasWorkflows ? `
     readonly workflows: LunoraWorkflows;` : "";
+  const hasQueues = queues.length > 0;
+  const queuesTypeImport = hasQueues ? `import type { QueueProducer } from "@lunora/queue";
+import type * as lunoraQueueDefinitions from "../queues.js";
+` : "";
+  const queuesTypeBlock = hasQueues ? `
+
+/** Message body type carried by a \`defineQueue\` definition (its phantom \`__lunoraBody\`). */
+type QueueBodyOf<Definition> = Definition extends { __lunoraBody?: infer Body } ? (unknown extends Body ? unknown : NonNullable<Body>) : unknown;
+
+/** This project's declared queues, addressable from \`ctx.queues\` by their \`lunora/queues.ts\` export name. */
+export interface LunoraQueues {
+${queues.map((queue) => `    readonly ${queue.exportName}: QueueProducer<QueueBodyOf<typeof lunoraQueueDefinitions.${queue.exportName}>>;`).join("\n")}
+}` : "";
+  const queuesContextField = hasQueues ? `
+    readonly queues: LunoraQueues;` : "";
   const server = `${GENERATED_HEADER}import { createPolicyDsl, initLunora, v as vBase } from "${base.server}";
 import type {
     ActionBuilder,
@@ -841,11 +862,11 @@ import type {
 } from "${base.server}";
 
 import type { DataModel, DatabaseReaderFacade, DatabaseWriterFacade, Doc, Id as IdOfTable, OrmReader, OrmWriter, Relations, TableName } from "./dataModel.js";
-${aiTypeImport}${paymentsTypeImport}${containersTypeImport}${workflowsTypeImport}
+${aiTypeImport}${paymentsTypeImport}${containersTypeImport}${workflowsTypeImport}${queuesTypeImport}
 export type { DataModel, Doc, Id, TableName } from "./dataModel.js";
 
 /** Storage buckets this schema declares (\`v.storage("name")\`), narrowing \`ctx.storage.bucket(name)\`. */
-export type StorageBucketName = ${storageBucketUnion};${envBlock}${workflowsTypeBlock}
+export type StorageBucketName = ${storageBucketUnion};${envBlock}${workflowsTypeBlock}${queuesTypeBlock}
 
 /**
  * Project-typed contexts. The base contexts from \`@lunora/server\` are
@@ -883,13 +904,13 @@ export interface QueryCtx extends Omit<QueryCtxBase, "db" | "storage"> {
 export interface MutationCtx extends Omit<MutationCtxBase, "db" | "storage"${workflowsOmit}> {
     readonly db: Omit<DatabaseWriter, "query" | "get"> & DatabaseWriterFacade & { query: TypedTableQuery; get: TypedTableGet };
     readonly orm: OrmWriter;
-    readonly storage: ReadOnlyStorage<StorageBucketName>;${kvContextField}${analyticsContextField}${workflowsContextField}
+    readonly storage: ReadOnlyStorage<StorageBucketName>;${kvContextField}${analyticsContextField}${workflowsContextField}${queuesContextField}
 }
 
 export interface ActionCtx extends Omit<ActionCtxBase, "db" | "storage"${workflowsOmit}> {
     readonly db: Omit<DatabaseWriter, "query" | "get"> & DatabaseWriterFacade & { query: TypedTableQuery; get: TypedTableGet };
     readonly orm: OrmWriter;
-    readonly storage: StorageBase<StorageBucketName>;${aiActionField}${paymentsActionField}${containersActionField}${kvContextField}${hyperdriveActionField}${browserActionField}${imagesActionField}${analyticsContextField}${pipelinesActionField}${r2sqlActionField}${workflowsContextField}
+    readonly storage: StorageBase<StorageBucketName>;${aiActionField}${paymentsActionField}${containersActionField}${kvContextField}${hyperdriveActionField}${browserActionField}${imagesActionField}${analyticsContextField}${pipelinesActionField}${r2sqlActionField}${workflowsContextField}${queuesContextField}
 }
 
 /**
@@ -1235,7 +1256,7 @@ const emitKvFragments = (hasKv) => {
     kv?: (env: Record<string, unknown>) => KVNamespaceLike;`,
     contextField: `
                 kv,`,
-    importLines: [`import type { Kv, KVNamespaceLike } from "@lunora/kv";`, `import { createKv } from "@lunora/kv";`],
+    importLines: [`import type { Kv, KVNamespaceLike } from "@lunora/bindings/kv";`, `import { createKv } from "@lunora/bindings/kv";`],
     stub: `
 const kvStub: Kv = {
     delete: async () => {
@@ -1275,8 +1296,8 @@ const emitAnalyticsFragments = (hasAnalytics) => {
     contextField: `
                 analytics,`,
     importLines: [
-      `import type { AnalyticsClient, AnalyticsEngineDatasetLike } from "@lunora/analytics";`,
-      `import { createAnalytics } from "@lunora/analytics";`
+      `import type { AnalyticsClient, AnalyticsEngineDatasetLike } from "@lunora/bindings/analytics";`,
+      `import { createAnalytics } from "@lunora/bindings/analytics";`
     ],
     stub: `
 const analyticsStub: AnalyticsClient = {
@@ -1305,7 +1326,7 @@ const emitImagesFragments = (hasImages) => {
     // ActionCtx-only: woven onto the action ctx object, never query/mutation.
     contextField: `
                 images,`,
-    importLines: [`import type { Images, ImagesBindingLike } from "@lunora/images";`, `import { createImages } from "@lunora/images";`],
+    importLines: [`import type { Images, ImagesBindingLike } from "@lunora/bindings/images";`, `import { createImages } from "@lunora/bindings/images";`],
     stub: `
 const imagesStub: Images = {
     info: async () => {
@@ -1404,10 +1425,10 @@ const emitR2sqlFragments = (hasR2sql) => {
     // ActionCtx-only: attached via the \`ctx.r2sql = r2sql\` assignment in the
     // \`isAction\` block, never the every-ctx object literal.
     contextField: "",
-    importLines: [`import type { R2SqlClient } from "@lunora/r2sql";`, `import { createR2Sql } from "@lunora/r2sql";`],
+    importLines: [`import type { R2SqlClient } from "@lunora/bindings/r2sql";`, `import { createR2Sql } from "@lunora/bindings/r2sql";`],
     // The stub is typed `R2SqlClient`, so TS flags a missing method at build
     // time — but it must stay structurally in sync with that interface
-    // (`@lunora/r2sql` client.ts) when a method is added there.
+    // (`@lunora/bindings/r2sql` client.ts) when a method is added there.
     stub: `
 const r2sqlStub: R2SqlClient = {
     describe: async () => {
@@ -1432,6 +1453,34 @@ const r2sqlStub: R2SqlClient = {
 `
   };
 };
+const emitPipelinesFragments = (hasPipelines) => {
+  if (!hasPipelines) {
+    return EMPTY_HELPER_FRAGMENTS;
+  }
+  const pipelinesMissing = `throw new Error("ctx.pipelines: no Pipelines binding found. Add a \\\`pipelines\\\` binding (env.PIPELINES) to wrangler.jsonc, or pass \\\`pipelines\\\` to createShardDO().");`;
+  return {
+    build: `
+            const pipelinesBinding = config.pipelines?.(env) ?? (env as Record<string, unknown>).PIPELINES;
+            const pipelines: PipelineClient = pipelinesBinding ? createPipelines({ binding: pipelinesBinding as PipelineBindingLike }) : pipelinesStub;
+`,
+    configField: `
+    pipelines?: (env: Record<string, unknown>) => PipelineBindingLike;`,
+    // ActionCtx-only: attached via the \`ctx.pipelines = pipelines\` assignment
+    // in the \`isAction\` block, never the every-ctx object literal.
+    contextField: "",
+    importLines: [
+      `import type { PipelineBindingLike, PipelineClient } from "@lunora/bindings/pipelines";`,
+      `import { createPipelines } from "@lunora/bindings/pipelines";`
+    ],
+    stub: `
+const pipelinesStub: PipelineClient = {
+    send: async () => {
+        ${pipelinesMissing}
+    },
+};
+`
+  };
+};
 const emitContainers = (containers, jurisdiction) => {
   if (containers.length === 0) {
     return "";
@@ -1455,11 +1504,18 @@ export class ${container.className} extends LunoraContainer {
  * requires each \`containers[].class_name\` to be exported by the worker:
  *
  * \`export * from "./lunora/_generated/containers.js";\`
+ *
+ * \`ContainerProxy\` is re-exported alongside them: the egress-interception path
+ * (\`allowedHosts\`/\`deniedHosts\`/\`interceptHttps\` and the runtime
+ * \`handle.egress\` controls) routes container outbound traffic through this
+ * WorkerEntrypoint, so it too must be exported by the deployed worker.
  */
-import LunoraContainer from "@lunora/container/do";
+import { LunoraContainer } from "@lunora/container/do";
 
 import { ${imports} } from "../containers.js";
 
+export { ContainerProxy } from "@lunora/container/do";
+
 ${classes}`;
 };
 const emitContainerFragments = (containers, jurisdiction) => {
@@ -1532,6 +1588,32 @@ type WorkflowOutputOf<Definition> = Definition extends { __output?: infer Output
 
 ${classes}`;
 };
+const emitQueues = (queues) => {
+  const pushQueues = queues.filter((queue) => queue.mode === "push");
+  if (pushQueues.length === 0) {
+    return "";
+  }
+  for (const queue of pushQueues) {
+    assertIdentifier(queue.exportName, `queue export "${queue.exportName}"`);
+  }
+  const imports = pushQueues.map((queue) => queue.exportName).join(", ");
+  const entries = pushQueues.map((queue) => `    ${JSON.stringify(queue.name)}: { definition: ${queue.exportName}, exportName: ${JSON.stringify(queue.exportName)} },`).join("\n");
+  return `${GENERATED_HEADER}/**
+ * Push-consumer registry for the queues declared in \`lunora/queues.ts\`. The
+ * composed worker's \`queue(batch, env, ctx)\` entry routes each delivered batch
+ * by \`batch.queue\` to the matching \`defineQueue\` handler. Wired automatically
+ * by \`defineApp\` — you don't import this directly.
+ */
+import type { QueueRegistry } from "@lunora/queue";
+
+import { ${imports} } from "../queues.js";
+
+/** Stable wrangler queue name → { definition, exportName } for batch routing. */
+export const LUNORA_QUEUE_REGISTRY: QueueRegistry = {
+${entries}
+};
+`;
+};
 const emitWorkflowFragments = (workflows) => {
   if (workflows.length === 0) {
     return { build: "", contextField: "", importLines: [], specs: "" };
@@ -1557,6 +1639,31 @@ ${specEntries}
 `
   };
 };
+const emitQueueFragments = (queues) => {
+  if (queues.length === 0) {
+    return { build: "", contextField: "", importLines: [], specs: "" };
+  }
+  for (const queue of queues) {
+    assertIdentifier(queue.exportName, `queue export "${queue.exportName}"`);
+    assertIdentifier(queue.bindingName, `queue binding "${queue.bindingName}"`);
+  }
+  const specEntries = queues.map((queue) => `    { binding: "${queue.bindingName}", exportName: "${queue.exportName}", name: ${JSON.stringify(queue.name)} },`).join("\n");
+  return {
+    build: `
+            const queues = createQueueContext(env, LUNORA_QUEUES);
+`,
+    contextField: `
+                queues,`,
+    importLines: [`import type { QueueBindingSpec } from "@lunora/queue";`, `import { createQueueContext } from "@lunora/queue";`],
+    // eslint-disable-next-line no-secrets/no-secrets -- the emitted readonly-array type annotation is dense generated TS, not a credential
+    specs: `
+/** Wiring specs for \`ctx.queues\` (codegen-derived from \`lunora/queues.ts\`). */
+const LUNORA_QUEUES: ReadonlyArray<QueueBindingSpec> = [
+${specEntries}
+];
+`
+  };
+};
 const emitWorkflowsMetadataFragments = (workflows) => {
   if (workflows.length === 0) {
     return { constant: "", override: "" };
@@ -1583,6 +1690,33 @@ const LUNORA_WORKFLOWS_INFO: WorkflowsResult = ${JSON.stringify(metadata, void 0
 `
   };
 };
+const emitQueuesMetadataFragments = (queues) => {
+  if (queues.length === 0) {
+    return { constant: "", override: "" };
+  }
+  const metadata = {
+    queues: queues.map((queue) => {
+      return {
+        binding: queue.bindingName,
+        ...queue.tuning.deadLetterQueue === void 0 ? {} : { deadLetterQueue: queue.tuning.deadLetterQueue },
+        exportName: queue.exportName,
+        mode: queue.mode,
+        name: queue.name
+      };
+    })
+  };
+  return {
+    constant: `
+/** Read-only declared-queue metadata (discovered from \`lunora/queues.ts\`) served via \`__lunora_admin__:listQueues\` for the studio's queues view. */
+const LUNORA_QUEUES_INFO: QueuesResult = ${JSON.stringify(metadata, void 0, 4)};
+`,
+    override: `
+        protected override queuesMetadata(): QueuesResult {
+            return LUNORA_QUEUES_INFO;
+        }
+`
+  };
+};
 const emitPaymentFragments = (hasPayments) => {
   if (!hasPayments) {
     return { build: "", configField: "", contextField: "", imports: [], stub: "" };
@@ -1638,13 +1772,14 @@ const paymentStub: LunoraPayment = {
 `
   };
 };
-const buildDoTypeImports = (hasVectors, hasWorkflows) => [
+const buildDoTypeImports = (hasVectors, hasWorkflows, hasQueues) => [
   "AdvisoryFinding",
   "DatabaseWriterLike",
   "DataMigrationLike",
   "LogSink",
   "MaskPoliciesResult",
   "MigrationRunResult",
+  ...hasQueues ? ["QueuesResult"] : [],
   "RunShardApplyCdcArgs",
   "RunShardMigrationArgs",
   "RlsPoliciesResult",
@@ -1673,8 +1808,10 @@ const emitShard = ({
   hasImages = false,
   hasKv = false,
   hasPayments = false,
+  hasPipelines = false,
   hasR2sql = false,
   maskMetadata,
+  queues = [],
   rlsMetadata,
   schema,
   storageRules,
@@ -1690,6 +1827,8 @@ const emitShard = ({
   const hyperdriveFragments = emitHyperdriveFragments(hasHyperdrive);
   const browserFragments = emitBrowserFragments(hasBrowser);
   const r2sqlFragments = emitR2sqlFragments(hasR2sql);
+  const pipelinesFragments = emitPipelinesFragments(hasPipelines);
+  const { build: queuesBuild, contextField: queuesContextField, importLines: queueImportLines, specs: queueSpecs } = emitQueueFragments(queues);
   const {
     build: containersBuild,
     contextField: containersContextField,
@@ -1716,12 +1855,14 @@ const emitShard = ({
   const studioFeaturesData = studioFeatures ?? {
     mail: false,
     payments: false,
+    queues: false,
     scheduler: false,
     storage: false,
     vectors: false,
     workflows: false
   };
   const { constant: workflowsMetadataConst, override: workflowsMetadataOverride } = emitWorkflowsMetadataFragments(workflows);
+  const { constant: queuesMetadataConst, override: queuesMetadataOverride } = emitQueuesMetadataFragments(queues);
   const hasVectors = schema.vectorIndexes.length > 0;
   const hasGlobalTables = schema.tables.some((table) => table.shardMode === "global");
   const hasHyperdriveGlobal = schema.tables.some((table) => table.shardMode === "global" && table.globalBackend === "hyperdrive");
@@ -1736,23 +1877,24 @@ const emitShard = ({
   const tableIndexes = buildTableIndexes(schema);
   const tableColumns = buildTableColumns(schema);
   const storageColumns = buildStorageColumns(schema);
-  const doTypeImports = buildDoTypeImports(hasVectors, workflows.length > 0);
+  const doTypeImports = buildDoTypeImports(hasVectors, workflows.length > 0, queues.length > 0);
   const relationFanout = emitRelationFanout(hasGlobalTables);
   const importLines = [
     `import type { ${doTypeImports.join(", ")} } from "${base.do}";`,
     `import { applyCdcChanges, createShardCtxDb, runDataMigration, runShardMigrations, ${relationFanout.importFragment}ShardDO as ShardDOBase } from "${base.do}";`,
-    // `asBucketStorage` (the bucket-aware `ctx.storage` wrapper) lives in
+    // `asBucketStorage` (the bucket-aware `ctx.storage` wrapper) and
+    // `createSecrets` (the `ctx.secrets` core built-in) live in
     // `@lunora/server`, the single source — imported here rather than stamped
     // inline into every generated shard.
-    `import { asBucketStorage } from "${base.server}";`
+    `import { asBucketStorage, createSecrets } from "${base.server}";`
   ];
   if (hasTables) {
     importLines.push(`import { bindOrm, bindTableFacade } from "${base.server}";`);
   }
   if (hasVectors) {
     importLines.push(
-      `import type { SchemaLike as VectorSchemaLike, VectorizeIndexLike, VectorSearchLike } from "@lunora/vectors";`,
-      `import { createContextVectors, createVectors, createVectorSyncHook } from "@lunora/vectors";`
+      `import type { SchemaLike as VectorSchemaLike, VectorizeIndexLike, VectorSearchLike } from "@lunora/bindings/vectors";`,
+      `import { createContextVectors, createVectors, createVectorSyncHook } from "@lunora/bindings/vectors";`
     );
   }
   if (hasAi) {
@@ -1765,8 +1907,10 @@ const emitShard = ({
     ...hyperdriveFragments.importLines,
     ...browserFragments.importLines,
     ...r2sqlFragments.importLines,
+    ...pipelinesFragments.importLines,
     ...containerImportLines,
     ...workflowImportLines,
+    ...queueImportLines,
     ...paymentsImports,
     ``,
     `import schema from "../schema.js";`,
@@ -1908,18 +2052,23 @@ ${schema.tables.map(
     (table) => `            facade[${JSON.stringify(table.name)}] = bindTableFacade(db, ${JSON.stringify(table.name)});`
   ).join("\n")}
 ` : "";
-  const everyContextBuild = `${kvFragments.build}${analyticsFragments.build}`;
-  const everyContextField = `${kvFragments.contextField}${analyticsFragments.contextField}`;
-  const actionOnlyHasAny = hasImages || hasHyperdrive || hasBrowser || hasR2sql;
+  const secretsBuild = `
+            const secrets = createSecrets(env);
+`;
+  const everyContextBuild = `${kvFragments.build}${analyticsFragments.build}${secretsBuild}`;
+  const everyContextField = `${kvFragments.contextField}${analyticsFragments.contextField}
+                secrets,`;
+  const actionOnlyHasAny = hasImages || hasHyperdrive || hasBrowser || hasR2sql || hasPipelines;
   const actionOnlyBlock = actionOnlyHasAny ? `
             // ActionCtx-only helpers (external, non-deterministic I/O): constructed
             // and attached only for an \`action\` so query/mutation ctx never carry them.
             if (isAction) {
-${imagesFragments.build}${hyperdriveFragments.build}${browserFragments.build}${r2sqlFragments.build}${[
+${imagesFragments.build}${hyperdriveFragments.build}${browserFragments.build}${r2sqlFragments.build}${pipelinesFragments.build}${[
     ...hasImages ? ["                ctx.images = images;"] : [],
     ...hasHyperdrive ? ["                ctx.sql = sql;"] : [],
     ...hasBrowser ? ["                ctx.browser = browser;"] : [],
-    ...hasR2sql ? ["                ctx.r2sql = r2sql;"] : []
+    ...hasR2sql ? ["                ctx.r2sql = r2sql;"] : [],
+    ...hasPipelines ? ["                ctx.pipelines = pipelines;"] : []
   ].join("\n")}
             }
 ` : "";
@@ -1959,14 +2108,14 @@ const LUNORA_STORAGE_RULES: StorageRulesResult = ${JSON.stringify(storageRulesDa
 
 /** Which optional package-backed features this app wires up (discovered from imports / \`ctx.*\` reads / schema signals) served via \`__lunora_admin__:studioFeatures\` so the studio hides nav pages whose package isn't enabled. */
 const LUNORA_STUDIO_FEATURES: StudioFeaturesResult = ${JSON.stringify(studioFeaturesData, void 0, 4)};
-${workflowsMetadataConst}${containerSpecs}${workflowSpecs}
+${workflowsMetadataConst}${queuesMetadataConst}${containerSpecs}${workflowSpecs}${queueSpecs}
 export interface ShardDOConfig {
     /** Opt into change-data-capture: records a post-image to \`__cdc_log\` on every write (backs streaming export + replay-PITR). */
     cdc?: boolean;
     /** Optional telemetry sink. When supplied, each \`ctx.log.*\` call is forwarded to \`sink.onLog\`. Pass the SAME sink you give \`createWorker({ observability })\` (which drives \`onRpc\`) to route both RPC and log events. */
     observability?: (env: Record<string, unknown>) => LogSink | undefined;
     scheduler?: (env: Record<string, unknown>) => unknown;
-    storage?: (env: Record<string, unknown>) => unknown;${vectorsConfigField}${aiConfigField}${kvFragments.configField}${analyticsFragments.configField}${imagesFragments.configField}${hyperdriveFragments.configField}${browserFragments.configField}${r2sqlFragments.configField}${paymentsConfigField}${d1ConfigField}${hyperdriveGlobalConfigField}
+    storage?: (env: Record<string, unknown>) => unknown;${vectorsConfigField}${aiConfigField}${kvFragments.configField}${analyticsFragments.configField}${imagesFragments.configField}${hyperdriveFragments.configField}${browserFragments.configField}${r2sqlFragments.configField}${pipelinesFragments.configField}${paymentsConfigField}${d1ConfigField}${hyperdriveGlobalConfigField}
 }
 
 const schedulerStub = {
@@ -2004,7 +2153,7 @@ const storageStub = {
         throw new Error("ctx.storage: no storage configured. Pass \`storage\` to createShardDO().");
     },
 };
-${globalDatabaseStub}${vectorsStub}${aiStub}${kvFragments.stub}${analyticsFragments.stub}${imagesFragments.stub}${hyperdriveFragments.stub}${browserFragments.stub}${r2sqlFragments.stub}${paymentStub}${bindTableHelper}
+${globalDatabaseStub}${vectorsStub}${aiStub}${kvFragments.stub}${analyticsFragments.stub}${imagesFragments.stub}${hyperdriveFragments.stub}${browserFragments.stub}${r2sqlFragments.stub}${pipelinesFragments.stub}${paymentStub}${bindTableHelper}
 // Bound in-process \`ctx.run*\` composition depth so a self- or cyclically-
 // referencing call fails loudly with a clear error instead of overflowing the
 // stack. Tracked across the awaited handler chain (one DO invocation is
@@ -2149,7 +2298,7 @@ ${relationFanout.override}
         protected override studioFeatures(): StudioFeaturesResult {
             return LUNORA_STUDIO_FEATURES;
         }
-${workflowsMetadataOverride}
+${workflowsMetadataOverride}${queuesMetadataOverride}
         protected override advisories(): AdvisoryFinding[] {
             return LUNORA_ADVISORIES;
         }
@@ -2383,7 +2532,7 @@ ${workflowsMetadataOverride}
             // dispatch path) fall back to the per-request fields as before.
             const userId = options.identity ? options.identity.userId : this.getCurrentUserId();
             const identity = options.identity ? options.identity.identity : this.getCurrentIdentity();
-${vectorsBuild}${aiBuild}${everyContextBuild}${containersBuild}${workflowsBuild}
+${vectorsBuild}${aiBuild}${everyContextBuild}${containersBuild}${workflowsBuild}${queuesBuild}
             const scheduler = (config.scheduler?.(env) ?? schedulerStub) as SchedulerLike;
             // Build the storage adapter once and share it between \`ctx.storage\`
             // and \`ctx.db.system._storage\` so both read the same R2 binding. The
@@ -2425,7 +2574,7 @@ ${facadeBlock}${paymentsBuild}
                 log,
                 now,${ormContextField}
                 scheduler,
-                storage,${vectorsContextField}${aiContextField}${everyContextField}${paymentsContextField}${containersContextField}${workflowsContextField}
+                storage,${vectorsContextField}${aiContextField}${everyContextField}${paymentsContextField}${containersContextField}${workflowsContextField}${queuesContextField}
             };
 ${isActionLine}${actionOnlyBlock}
             ctx.runAction = (reference: FunctionReference, fnArgs: Record<string, unknown>) => dispatchRun("action", reference.__lunoraRef, fnArgs, ctx);
@@ -2689,4 +2838,4 @@ const emitWranglerCronTriggers = (crons) => {
   return triggers;
 };
 
-export { GENERATED_HEADER, buildStorageColumns, emitApi, emitContainers, emitCrons, emitDataModel, emitDrizzleSchema, emitFunctions, emitSeed, emitServer, emitShard, emitVectors, emitWorkflows, emitWranglerCronTriggers };
+export { GENERATED_HEADER, buildStorageColumns, emitApi, emitContainers, emitCrons, emitDataModel, emitDrizzleSchema, emitFunctions, emitQueues, emitSeed, emitServer, emitShard, emitVectors, emitWorkflows, emitWranglerCronTriggers };

package/dist/packem_shared/{OPENRPC_VERSION-B4i9Qp3v.mjs → OPENRPC_VERSION-CQ3f8YQ-.mjs}

@@ -1,4 +1,4 @@
-import { GENERATED_HEADER } from './GENERATED_HEADER-BiFXNUvo.mjs';
+import { GENERATED_HEADER } from './GENERATED_HEADER-BEA7oWGC.mjs';
 import { s as sanitizeNamespace } from './paths-BRd6JHuF.mjs';
 import { argsObjectSchema, LUNORA_ERROR_CODES } from './LUNORA_ERROR_CODES-CySpQPD3.mjs';
 

package/dist/packem_shared/QUEUES_FILENAME-B5_eWCRe.mjs

@@ -0,0 +1,119 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { queueDefaultName, queueBindingName } from '@lunora/queue';
+import { SyntaxKind, Node } from 'ts-morph';
+import { diagnosticAt } from './CodegenDiagnosticError-DeblMkzO.mjs';
+
+const QUEUES_FILENAME = "queues.ts";
+const isDefineQueue = (identifier) => {
+  const symbol = identifier.getSymbol();
+  if (!symbol) {
+    return identifier.getText() === "defineQueue";
+  }
+  for (const declaration of symbol.getDeclarations()) {
+    if (!Node.isImportSpecifier(declaration)) {
+      continue;
+    }
+    if (declaration.getImportDeclaration().getModuleSpecifierValue() !== "@lunora/queue") {
+      return false;
+    }
+    return declaration.getNameNode().getText() === "defineQueue";
+  }
+  return false;
+};
+const stringProperty = (expression, exportName, property) => {
+  if (Node.isStringLiteral(expression) || Node.isNoSubstitutionTemplateLiteral(expression)) {
+    return expression.getLiteralValue();
+  }
+  throw diagnosticAt(
+    expression,
+    `queue "${exportName}": \`${property}\` must be a static string literal — it is deploy configuration codegen writes into wrangler.jsonc`
+  );
+};
+const numberProperty = (expression, exportName, property) => {
+  if (Node.isNumericLiteral(expression)) {
+    return expression.getLiteralValue();
+  }
+  throw diagnosticAt(
+    expression,
+    `queue "${exportName}": \`${property}\` must be a static numeric literal — it is deploy configuration codegen writes into wrangler.jsonc`
+  );
+};
+const queueNameOverride = (argument, exportName) => {
+  const nameProperty = argument.getProperty("name");
+  if (!nameProperty || !Node.isPropertyAssignment(nameProperty)) {
+    return void 0;
+  }
+  const name = stringProperty(nameProperty.getInitializerOrThrow(), exportName, "name");
+  if (name.length === 0) {
+    throw diagnosticAt(nameProperty, `queue "${exportName}": \`name\` must be a non-empty string when provided`);
+  }
+  return name;
+};
+const queueFromCall = (call, exportName) => {
+  const argument = call.getArguments()[0];
+  if (!argument || !Node.isObjectLiteralExpression(argument)) {
+    throw diagnosticAt(call, `queue "${exportName}": defineQueue must be passed an inline object literal`);
+  }
+  const ir = {
+    bindingName: queueBindingName(exportName),
+    exportName,
+    mode: "push",
+    name: queueNameOverride(argument, exportName) ?? queueDefaultName(exportName),
+    tuning: {}
+  };
+  const modeProperty = argument.getProperty("mode");
+  if (modeProperty && Node.isPropertyAssignment(modeProperty)) {
+    const mode = stringProperty(modeProperty.getInitializerOrThrow(), exportName, "mode");
+    if (mode !== "push" && mode !== "pull") {
+      throw diagnosticAt(modeProperty, `queue "${exportName}": \`mode\` must be "push" or "pull" (got ${JSON.stringify(mode)})`);
+    }
+    ir.mode = mode;
+  }
+  const dlqProperty = argument.getProperty("deadLetterQueue");
+  if (dlqProperty && Node.isPropertyAssignment(dlqProperty)) {
+    ir.tuning.deadLetterQueue = stringProperty(dlqProperty.getInitializerOrThrow(), exportName, "deadLetterQueue");
+  }
+  for (const property of ["maxBatchSize", "maxBatchTimeout", "maxRetries", "retryDelay"]) {
+    const node = argument.getProperty(property);
+    if (node && Node.isPropertyAssignment(node)) {
+      ir.tuning[property] = numberProperty(node.getInitializerOrThrow(), exportName, property);
+    }
+  }
+  return ir;
+};
+const queuesFromSource = (source) => {
+  const queues = [];
+  for (const declaration of source.getVariableDeclarations()) {
+    if (!declaration.isExported()) {
+      continue;
+    }
+    const initializer = declaration.getInitializer();
+    if (initializer?.getKind() !== SyntaxKind.CallExpression) {
+      continue;
+    }
+    const call = initializer;
+    const callee = call.getExpression();
+    if (!Node.isIdentifier(callee) || !isDefineQueue(callee)) {
+      continue;
+    }
+    const nameNode = declaration.getNameNode();
+    if (!Node.isIdentifier(nameNode)) {
+      throw diagnosticAt(nameNode, "defineQueue exports must be plain named exports (no destructuring)");
+    }
+    queues.push(queueFromCall(call, nameNode.getText()));
+  }
+  return queues;
+};
+const discoverQueues = (project, lunoraDirectory) => {
+  const queuesPath = join(lunoraDirectory, QUEUES_FILENAME);
+  if (!existsSync(queuesPath)) {
+    return [];
+  }
+  const source = project.getSourceFile(queuesPath) ?? project.addSourceFileAtPath(queuesPath);
+  const queues = queuesFromSource(source);
+  queues.sort((a, b) => a.exportName.localeCompare(b.exportName));
+  return queues;
+};
+
+export { QUEUES_FILENAME, discoverQueues };

package/dist/packem_shared/{SCHEMA_SNAPSHOT_FILENAME-Bvv7qa_u.mjs → SCHEMA_SNAPSHOT_FILENAME-BXtduJFE.mjs}

@@ -13,16 +13,17 @@ import discoverMaskProcedures, { discoverMaskMetadata } from './discoverMaskProc
 import discoverMigrations from './discoverMigrations-Bi5nJ0mJ.mjs';
 import discoverNondeterministicCalls from './discoverNondeterministicCalls-C4M8AXmQ.mjs';
 import discoverQueries from './discoverQueries-B0wGT-xe.mjs';
+import { discoverQueues } from './QUEUES_FILENAME-B5_eWCRe.mjs';
 import discoverR2sqlCalls from './discoverR2sqlCalls-BVNMd428.mjs';
 import discoverRlsProcedures, { discoverRlsMetadata } from './discoverRlsMetadata-BS9GOGC5.mjs';
 import discoverSchema from './discoverSchema-BnWHHJ4T.mjs';
 import discoverStorageRulesMetadata from './discoverStorageRulesMetadata-Da8BKXcI.mjs';
 import { e as enclosingExportName$1 } from './discover-ast-CT6BgBr4.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-BiFXNUvo.mjs';
-import { emitApp } from './emitApp-KfMaKXWe.mjs';
-import { buildOpenApiDocument, emitOpenApiModule } from './buildOpenApiDocument-Cu3mZl-8.mjs';
-import { buildOpenRpcDocument, emitOpenRpcModule } from './OPENRPC_VERSION-B4i9Qp3v.mjs';
+import { buildStorageColumns, emitDataModel, emitApi, emitServer, emitFunctions, emitShard, emitContainers, emitWorkflows, emitQueues, emitCrons, emitVectors, emitDrizzleSchema, emitSeed, emitWranglerCronTriggers } from './GENERATED_HEADER-BEA7oWGC.mjs';
+import { emitApp } from './emitApp-DiK0QSBn.mjs';
+import { buildOpenApiDocument, emitOpenApiModule } from './buildOpenApiDocument-699G4RP4.mjs';
+import { buildOpenRpcDocument, emitOpenRpcModule } from './OPENRPC_VERSION-CQ3f8YQ-.mjs';
 import { buildSchemaSnapshot, serializeSchemaSnapshot } from './SCHEMA_SNAPSHOT_VERSION-wWGP2_5E.mjs';
 
 const HTTP_VERBS = /* @__PURE__ */ new Set(["delete", "get", "head", "options", "patch", "post", "put"]);
@@ -240,18 +241,21 @@ const discoverArgumentValidators = (project, lunoraDirectory) => {
 
 const PROBES = {
   ai: { contextProperty: "ai", moduleSpecifier: "@lunora/ai" },
-  analytics: { contextProperty: "analytics", moduleSpecifier: "@lunora/analytics" },
+  analytics: { contextProperty: "analytics", moduleSpecifier: "@lunora/bindings/analytics" },
   browser: { contextProperty: "browser", moduleSpecifier: "@lunora/browser" },
   hyperdrive: { contextProperty: "sql", moduleSpecifier: "@lunora/hyperdrive" },
-  images: { contextProperty: "images", moduleSpecifier: "@lunora/images" },
-  kv: { contextProperty: "kv", moduleSpecifier: "@lunora/kv" },
+  images: { contextProperty: "images", moduleSpecifier: "@lunora/bindings/images" },
+  kv: { contextProperty: "kv", moduleSpecifier: "@lunora/bindings/kv" },
   mail: { moduleSpecifier: "@lunora/mail" },
   payments: { contextProperty: "payments", moduleSpecifier: "@lunora/payment" },
-  pipelines: { contextProperty: "pipelines", moduleSpecifier: "@lunora/pipelines" },
-  r2sql: { contextProperty: "r2sql", moduleSpecifier: "@lunora/r2sql" },
+  // Pipelines is its own `@lunora/bindings/pipelines` subpath (distinct from
+  // `/analytics`), so a real import is a clean signal that won't be flipped by a
+  // plain analytics import; `ctx.pipelines` reads flip it too.
+  pipelines: { contextProperty: "pipelines", moduleSpecifier: "@lunora/bindings/pipelines" },
+  r2sql: { contextProperty: "r2sql", moduleSpecifier: "@lunora/bindings/r2sql" },
   scheduler: { contextProperty: "scheduler", moduleSpecifier: "@lunora/scheduler" },
   storage: { contextProperty: "storage", moduleSpecifier: "@lunora/storage" },
-  vectors: { contextProperty: "vectors", moduleSpecifier: "@lunora/vectors" },
+  vectors: { contextProperty: "vectors", moduleSpecifier: "@lunora/bindings/vectors" },
   workflows: { contextProperty: "workflows", moduleSpecifier: "@lunora/workflow" }
 };
 const readsContextProperty = (sourceFile, property) => {
@@ -313,9 +317,10 @@ const buildStudioFeatures = (usage, signals) => {
   return {
     mail: usage.mail || signals.dependencies.has("@lunora/mail"),
     payments: usage.payments || signals.dependencies.has("@lunora/payment"),
+    queues: signals.queueCount > 0 || signals.dependencies.has("@lunora/queue"),
     scheduler: usage.scheduler || signals.cronCount > 0 || signals.dependencies.has("@lunora/scheduler"),
     storage: usage.storage || signals.storageRuleCount > 0 || signals.storageColumnCount > 0 || signals.dependencies.has("@lunora/storage"),
-    vectors: usage.vectors || signals.vectorIndexCount > 0 || signals.dependencies.has("@lunora/vectors"),
+    vectors: usage.vectors || signals.vectorIndexCount > 0 || signals.dependencies.has("@lunora/bindings/vectors"),
     workflows: usage.workflows || signals.workflowCount > 0 || signals.dependencies.has("@lunora/workflow")
   };
 };
@@ -735,6 +740,7 @@ const runCodegen = (options) => {
   const httpRoutes = discoverHttpRoutes(project, lunoraDirectory);
   const migrations = discoverMigrations(project, lunoraDirectory);
   const workflows = discoverWorkflows(project, lunoraDirectory);
+  const queues = discoverQueues(project, lunoraDirectory);
   const crons = discoverCrons(project, lunoraDirectory, workflows);
   const containers = discoverContainers(project, lunoraDirectory);
   const advisories = options.lint === false ? [] : lintSchema(
@@ -772,6 +778,7 @@ const runCodegen = (options) => {
   const studioFeatures = buildStudioFeatures(featureUsage, {
     cronCount: crons.length,
     dependencies,
+    queueCount: queues.length,
     storageColumnCount: Object.keys(buildStorageColumns(schema)).length,
     storageRuleCount: storageRulesMetadata.rules.length,
     vectorIndexCount: schema.vectorIndexes.length,
@@ -792,6 +799,7 @@ const runCodegen = (options) => {
     hasPayments,
     hasPipelines,
     hasR2sql,
+    queues,
     schema,
     storageRuleBuckets: storageRulesMetadata.rules.map((rule) => rule.bucket),
     useUmbrella,
@@ -808,8 +816,10 @@ const runCodegen = (options) => {
     hasImages,
     hasKv,
     hasPayments,
+    hasPipelines,
     hasR2sql,
     maskMetadata,
+    queues,
     rlsMetadata,
     schema,
     storageRules: storageRulesMetadata,
@@ -819,6 +829,7 @@ const runCodegen = (options) => {
   });
   const containersContent = emitContainers(containers, schema.jurisdiction);
   const workflowsContent = emitWorkflows(workflows);
+  const queuesContent = emitQueues(queues);
   const cronsContent = emitCrons(crons);
   const vectorsContent = emitVectors(schema.vectorIndexes);
   const drizzleFiles = emitDrizzleSchema(schema, useUmbrella);
@@ -844,6 +855,7 @@ const runCodegen = (options) => {
     hasKv,
     hasPayments,
     hasR2sql,
+    hasQueue: queues.some((queue) => queue.mode === "push"),
     hasScheduler: studioFeatures.scheduler,
     hasStorage: studioFeatures.storage,
     hasVectors: schema.vectorIndexes.length > 0,
@@ -886,6 +898,7 @@ const runCodegen = (options) => {
     writeIfChanged(join(outputDirectory, "drizzle.shard.ts"), drizzleFiles.shard);
     writeIfPresent(join(outputDirectory, "containers.ts"), containersContent);
     writeIfPresent(join(outputDirectory, "workflows.ts"), workflowsContent);
+    writeIfPresent(join(outputDirectory, "queues.ts"), queuesContent);
     writeIfPresent(join(outputDirectory, "seed.ts"), seedContent);
     if (wantsOpenApi) {
       writeIfChanged(join(outputDirectory, "openapi.json"), openApiContent);
@@ -923,6 +936,7 @@ const runCodegen = (options) => {
       openApiModule: openApiModuleContent,
       openRpc: openRpcContent,
       openRpcModule: openRpcModuleContent,
+      queues: queuesContent,
       seed: seedContent,
       server: serverContent,
       shard: shardContent,
@@ -930,6 +944,7 @@ const runCodegen = (options) => {
       workflows: workflowsContent
     },
     outputDirectory,
+    queues,
     schemaSnapshot,
     schemaSnapshotPath,
     workflows

package/dist/packem_shared/{buildOpenApiDocument-Cu3mZl-8.mjs → buildOpenApiDocument-699G4RP4.mjs}

@@ -1,4 +1,4 @@
-import { GENERATED_HEADER } from './GENERATED_HEADER-BiFXNUvo.mjs';
+import { GENERATED_HEADER } from './GENERATED_HEADER-BEA7oWGC.mjs';
 import { s as sanitizeNamespace } from './paths-BRd6JHuF.mjs';
 import { LUNORA_ERROR_CODES, objectSchema, argsObjectSchema, validatorIrToJsonSchema } from './LUNORA_ERROR_CODES-CySpQPD3.mjs';
 

package/dist/packem_shared/{emitApp-KfMaKXWe.mjs → emitApp-DiK0QSBn.mjs}

@@ -1,4 +1,4 @@
-import { GENERATED_HEADER } from './GENERATED_HEADER-BiFXNUvo.mjs';
+import { GENERATED_HEADER } from './GENERATED_HEADER-BEA7oWGC.mjs';
 
 const LONG_TAIL = [
   ["hasAi", "ai", "ai", "Override the Workers AI binding backing `ctx.ai` (defaults to `env.AI`)."],
@@ -23,7 +23,7 @@ const LONG_TAIL = [
 ];
 const hasAnyLongTail = (options) => LONG_TAIL.some(([flag]) => options[flag]);
 const buildImportLines = (options) => {
-  const { hasAuth, hasFramework, hasGlobal, hasHyperdriveGlobal, hasScheduler, hasStorage, hasWorkflow, useUmbrella, wantsOpenApi, wantsOpenRpc } = options;
+  const { hasAuth, hasFramework, hasGlobal, hasHyperdriveGlobal, hasQueue, hasScheduler, hasStorage, hasWorkflow, useUmbrella, wantsOpenApi, wantsOpenRpc } = options;
   const runtimeModule = useUmbrella ? "lunorash/runtime" : "@lunora/runtime";
   const runtimeTypeImports = ["ExecutionContextLike", "LunoraWorker", "Route", "ScheduledControllerLike", "ShardNamespaceLike", "WorkerOptions"];
   if (hasGlobal) {
@@ -60,6 +60,7 @@ const buildImportLines = (options) => {
     ...hasGlobal || hasHyperdriveGlobal ? [`import schema from "../schema.js";`] : [],
     `import { LUNORA_CRONS } from "./crons.js";`,
     `import { LUNORA_FUNCTIONS } from "./functions.js";`,
+    ...hasQueue ? [`import { dispatchQueueBatch } from "@lunora/queue";`, `import { LUNORA_QUEUE_REGISTRY } from "./queues.js";`] : [],
     ...wantsOpenApi ? [`import { openApiSpec } from "./openapi.js";`] : [],
     ...wantsOpenRpc ? [`import { openRpcSpec } from "./openrpc.js";`] : [],
     `import { createShardDO } from "./shard.js";`
@@ -354,6 +355,14 @@ const buildBaseWorkerOptions = (options) => [
   ...options.jurisdiction ? [`            jurisdiction: ${JSON.stringify(options.jurisdiction)},`] : [],
   ...options.wantsOpenApi ? [`            openApiSpec,`] : [],
   ...options.wantsOpenRpc ? [`            openRpcSpec,`] : [],
+  // The push-consumer handler backing the worker's `queue(batch, …)` entry:
+  // routes each delivered batch to its `defineQueue` handler. Built from
+  // `@lunora/queue` here (keeping the runtime decoupled) and wired only when the
+  // app declares push queues in `lunora/queues.ts`.
+  ...options.hasQueue ? [
+    `            queue: (batch: unknown, queueEnv: unknown, _context: ExecutionContextLike): Promise<void> =>`,
+    `                dispatchQueueBatch(batch as Parameters<typeof dispatchQueueBatch>[0], LUNORA_QUEUE_REGISTRY, { env: queueEnv as Record<string, unknown> }),`
+  ] : [],
   `            routes: this.routeMap,`,
   `            shardDO: this.shardSelector?.(env) ?? (undefined as unknown as ShardNamespaceLike),`
 ];
@@ -562,7 +571,12 @@ ${buildWorkerLine}
                 worker ??= buildWorker(rawEnv as Env);
 
                 return worker.serverQuery(request, rawEnv, reference, args, options);
-            },
+            },${options.hasQueue ? `
+            queue: async (batch: unknown, rawEnv: unknown, context: ExecutionContextLike): Promise<void> => {
+                worker ??= buildWorker(rawEnv as Env);
+
+                return worker.queue?.(batch, rawEnv, context);
+            },` : ""}
         };
 
         if (this.emailHandler) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/codegen",
-  "version": "1.0.0-alpha.10",
+  "version": "1.0.0-alpha.12",
   "description": "Code generator for Lunora: emits _generated/{api,server,dataModel}.ts from your schema",
   "keywords": [
     "cloudflare",
@@ -25,7 +25,7 @@
     "directory": "packages/codegen"
   },
   "files": [
-    "dist",
+    "./dist",
     "__assets__",
     "README.md",
     "LICENSE.md"
@@ -46,11 +46,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/advisor": "1.0.0-alpha.5",
-    "@lunora/container": "1.0.0-alpha.2",
-    "@lunora/scheduler": "1.0.0-alpha.2",
-    "@lunora/values": "1.0.0-alpha.2",
-    "@lunora/workflow": "1.0.0-alpha.2",
+    "@lunora/advisor": "1.0.0-alpha.6",
+    "@lunora/container": "1.0.0-alpha.4",
+    "@lunora/queue": "1.0.0-alpha.1",
+    "@lunora/scheduler": "1.0.0-alpha.3",
+    "@lunora/values": "1.0.0-alpha.3",
+    "@lunora/workflow": "1.0.0-alpha.3",
     "ts-morph": "^28.0.0"
   },
   "engines": {