@supacloud/compiler 0.58.0 → 0.59.0

package/dist/cli.js

@@ -1090,7 +1090,13 @@ function validateGraph(graph, options = false) {
       if (command.rpc && command.branches) {
         error("command-rpc-branches-conflict", `Command ${command.name} cannot declare both rpc and branches.`, module.file, module.line);
       }
+      if (command.branchesFallback !== undefined && command.branchesFallback !== "reject" && command.branchesFallback !== "command") {
+        error("command-branches-fallback-invalid", `Command ${command.name} has an invalid branches fallback.`, module.file, module.line);
+      }
       const branchAdapters = command.branches ?? [];
+      if (command.branchesFallback === "command" && branchAdapters.length === 0) {
+        error("command-branches-fallback-without-branches", `Command ${command.name} declares a fallback without branches.`, module.file, module.line);
+      }
       for (const branch of branchAdapters) {
         if (typeof options !== "object" || !Object.hasOwn(options.commandCapabilities?.rpc ?? {}, branch.rpc)) {
           error("command-rpc-unavailable", `Command ${command.name} requires configured RPC adapter '${branch.rpc}'.`, module.file, module.line);
@@ -1120,7 +1126,7 @@ function validateGraph(graph, options = false) {
             error("command-transaction-unsupported", `Command ${command.name} branch '${branch.when}' declares transaction, but transaction support is unavailable.`, module.file, module.line);
           }
         }
-        if (hostCaps.requirePersistentAdapters && (command.rpc !== undefined && (!rpcCaps?.boundary || rpcCaps.audit !== true || rpcCaps.idempotency !== true) || branchCaps.length > 0 && branchCaps.some(({ branch, capabilities }) => !capabilities?.boundary || capabilities.audit !== true || capabilities.idempotency !== true || capabilities.boundary === "database" && (capabilities.transaction !== true || branch.transaction !== "required")) || hostCaps.permission !== true || !command.permission || branchCaps.length === 0 && (!command.audit || command.idempotency !== "required") || branchCaps.length > 0 && branchCaps.some(({ branch }) => !branch.audit || branch.idempotency !== "required") || branchCaps.length > 0 && branchCaps.some(({ capabilities }) => capabilities?.boundary === "external" && capabilities.reconcile !== true) || command.rpc !== undefined && rpcCaps?.boundary === "database" && (rpcCaps.transaction !== true || command.transaction !== "required") || command.rpc === undefined && branchCaps.length === 0 && (hostCaps.audit !== true || hostCaps.idempotency !== true || hostCaps.transaction !== true || command.transaction !== "required") || command.rpc !== undefined && rpcCaps?.boundary === "external" && rpcCaps.reconcile !== true)) {
+        if (hostCaps.requirePersistentAdapters && (command.rpc !== undefined && (!rpcCaps?.boundary || rpcCaps.audit !== true || rpcCaps.idempotency !== true) || branchCaps.length > 0 && branchCaps.some(({ branch, capabilities }) => !capabilities?.boundary || capabilities.audit !== true || capabilities.idempotency !== true || capabilities.boundary === "database" && (capabilities.transaction !== true || branch.transaction !== "required")) || hostCaps.permission !== true || !command.permission || branchCaps.length === 0 && (!command.audit || command.idempotency !== "required") || branchCaps.length > 0 && branchCaps.some(({ branch }) => !branch.audit || branch.idempotency !== "required") || branchCaps.length > 0 && branchCaps.some(({ capabilities }) => capabilities?.boundary === "external" && capabilities.reconcile !== true) || command.branchesFallback === "command" && (!command.audit || command.idempotency !== "required" || command.transaction !== "required" || hostCaps.audit !== true || hostCaps.idempotency !== true || hostCaps.transaction !== true) || command.rpc !== undefined && rpcCaps?.boundary === "database" && (rpcCaps.transaction !== true || command.transaction !== "required") || command.rpc === undefined && branchCaps.length === 0 && (hostCaps.audit !== true || hostCaps.idempotency !== true || hostCaps.transaction !== true || command.transaction !== "required") || command.rpc !== undefined && rpcCaps?.boundary === "external" && rpcCaps.reconcile !== true)) {
           error("command-persistence-required", `Command ${command.name} requires an explicit persistent adapter, permission, audit and idempotency policy.`, module.file, module.line, "Register a named database/external adapter, enable permission checks and declare permission, audit and required idempotency on the command.");
         }
         if (rpcCaps?.boundary === "external" && (command.transaction === "required" || rpcCaps.transaction === true)) {
@@ -1673,6 +1679,7 @@ function buildContractManifest(graph, artifacts) {
         module: module.name,
         ...command.permission === undefined ? {} : { permission: command.permission },
         ...command.rpc === undefined ? {} : { rpc: command.rpc },
+        ...command.branchesFallback === undefined ? {} : { branchesFallback: command.branchesFallback },
         ...command.branches === undefined ? {} : {
           branches: command.branches.map((branch) => ({
             when: branch.when,
@@ -2404,6 +2411,7 @@ function renderApplication(graph, options) {
     permission: command.permission ?? null,
     rpc: command.rpc ?? null,
     branches: command.branches ?? [],
+    branchesFallback: command.branchesFallback ?? "reject",
     transaction: command.transaction ?? null,
     audit: command.audit ?? null,
     idempotency: command.idempotency ?? null
@@ -2482,6 +2490,7 @@ function renderApplication(graph, options) {
         transaction: command.transaction,
         idempotency: command.idempotency,
         branches: command.branches ?? [],
+        branchesFallback: command.branchesFallback ?? "reject",
         ...command.tenantScope === undefined ? {} : { tenantScope: command.tenantScope },
         requiredCapabilities: {
           permission: true,
@@ -2974,6 +2983,7 @@ ${indent(item, 2)}`).join(",")}
         `idempotency: ${JSON.stringify(command.idempotency)}`,
         ...command.tenantScope ? [`tenantScope: ${JSON.stringify(command.tenantScope)}`] : [],
         ...command.rpc ? [`rpc: ${JSON.stringify(command.rpc)}`] : [],
+        ...command.branchesFallback ? [`branchesFallback: ${JSON.stringify(command.branchesFallback)}`] : [],
         ...command.branches && command.branches.length > 0 ? [`branches: ${JSON.stringify(command.branches)}`] : [],
         ...command.standalone ? ["standalone: true"] : [],
         ...command.aspects && command.aspects.length > 0 ? [`aspects: ${this.renderAspects(command.aspects)}`, `aspectPipeline: ${this.renderAspectPipeline(command.aspects)}`] : []
@@ -4733,6 +4743,7 @@ var HEADER = "// GENERATED BY @supacloud/compiler — do not edit", INTERFACES =
 export interface CompiledCommand {
   rpc?: string;
   branches?: readonly CompiledCommandBranch[];
+  branchesFallback?: "reject" | "command";
   className: string;
   name: string;
   permission: string;
@@ -4865,7 +4876,7 @@ async function compiledAspectStep(context: CompiledAspectContext, handler: () =>
     }
     called = true;
     pending = Promise.resolve().then(handler).then(result => {
-      if (strict) freezeCompiledAspectData(result);
+      if (strict && !(result instanceof Response)) freezeCompiledAspectData(result);
       value = result;
       return result;
     });
@@ -16494,23 +16505,49 @@ var init_application_development2 = __esm(() => {
 });
 
 // node_modules/@supacloud/delivery/src/worker-execution.ts
+function workerShardCount(group) {
+  return group.shardCount ?? 1;
+}
+function shardSuffix(shard) {
+  if (!Number.isSafeInteger(shard) || shard < 0 || shard >= 64) {
+    throw new Error("WORKER_SHARD_INVALID");
+  }
+  return `s${shard.toString(36).padStart(2, "0")}`;
+}
+function workerShardQueue(group, shard) {
+  const count = workerShardCount(group);
+  if (!Number.isSafeInteger(shard) || shard < 0 || shard >= count) {
+    throw new Error("WORKER_SHARD_INVALID");
+  }
+  if (count === 1)
+    return group.queue;
+  const queue = `${group.queue}_${shardSuffix(shard)}`;
+  if (!/^scw_[a-z0-9_]{1,40}$/.test(queue))
+    throw new Error("WORKER_QUEUE_INVALID");
+  return queue;
+}
 function parseWorkerExecutionGroup(value) {
   if (!Check2(WorkerExecutionGroupSchema, value) || value.replicas > value.maxReplicas || !value.queue.endsWith(`_v${value.definitionVersion}`) || value.lifecycle.visibilityTimeoutSeconds < value.lifecycle.executionTimeoutSeconds + value.lifecycle.shutdownGraceSeconds + 30) {
     throw new Error("WORKER_EXECUTION_INVALID");
   }
-  return structuredClone(value);
+  const group = structuredClone(value);
+  for (let shard = 0;shard < workerShardCount(group); shard += 1)
+    workerShardQueue(group, shard);
+  return group;
 }
 function validateWorkerExecution(groups) {
   const names = new Set, targets = new Set, queues = new Set, routes = new Set;
   for (const candidate of groups) {
     const group = parseWorkerExecutionGroup(candidate);
     const route = `${group.taskKey}:${group.definitionVersion}`;
-    if (names.has(group.name) || targets.has(group.target) || queues.has(group.queue) || routes.has(route)) {
+    const physicalQueues = Array.from({ length: workerShardCount(group) }, (_, shard) => workerShardQueue(group, shard));
+    if (names.has(group.name) || targets.has(group.target) || queues.has(group.queue) || physicalQueues.some((queue) => queues.has(queue)) || routes.has(route)) {
       throw new Error("WORKER_EXECUTION_CONFLICT");
     }
     names.add(group.name);
     targets.add(group.target);
     queues.add(group.queue);
+    physicalQueues.forEach((queue) => queues.add(queue));
     routes.add(route);
   }
 }
@@ -16534,6 +16571,7 @@ var init_worker_execution = __esm(() => {
     definitionVersion: String2({ pattern: "^[1-9][0-9]{0,8}$" }),
     replicas: positive(16),
     maxReplicas: positive(16),
+    shardCount: Optional(positive(64)),
     concurrencyPerReplica: positive(32),
     resources: ComputeResourcesSchema,
     database: _Object_({
@@ -16943,7 +16981,7 @@ function parseDeliveryBuildManifest(value) {
   if (!Check2(DeliveryBuildManifestSchema, value))
     throw new Error("Invalid delivery build manifest.");
   validateWorkerExecution(value.plan.targets.flatMap((target) => target.execution ? [target.execution] : []));
-  if (value.plan.targets.reduce((count, target) => count + (target.execution?.replicas ?? 1), 0) > 32) {
+  if (value.plan.targets.reduce((count, target) => count + (target.execution ? (target.execution.replicas ?? 1) * workerShardCount(target.execution) : 1), 0) > 256) {
     throw new Error("Invalid delivery replica count.");
   }
   for (const target of value.plan.targets) {
@@ -19879,6 +19917,7 @@ async function analyzeProject(rootDir, include, cache, changedPaths, effectOptio
             const permission = stringLiteralProp(meta, "permission");
             const rpc = checkedRpc(meta, ctx);
             const branches = checkedBranches(meta, ctx);
+            const branchesFallback = checkedBranchesFallback(meta, ctx);
             const audit = stringLiteralProp(meta, "audit");
             const standaloneName = stringLiteralProp(meta, "name") ?? classInfo.decl.name?.text ?? name;
             const standaloneUses = await parseInfraResourceUseRefs(infraResourceProp(meta, "uses", ctx), ctx, `command ${standaloneName}`, sourcePath(ctx.rootDir, classInfo.file), lineOf(classInfo.decl));
@@ -19889,6 +19928,7 @@ async function analyzeProject(rootDir, include, cache, changedPaths, effectOptio
               ...permission === undefined ? {} : { permission },
               ...rpc === undefined ? {} : { rpc },
               ...branches === undefined ? {} : { branches },
+              ...branchesFallback === undefined ? {} : { branchesFallback },
               transaction: checkedCommandMode(meta, "transaction", ctx, classInfo.decl.name?.text ?? name) ?? "none",
               ...audit === undefined ? {} : { audit },
               idempotency: checkedCommandMode(meta, "idempotency", ctx, classInfo.decl.name?.text ?? name) ?? "none",
@@ -20263,6 +20303,7 @@ async function parseModule(candidate, nameByNode, ctx) {
         const permission = stringLiteralProp(meta, "permission");
         const rpc = checkedRpc(meta, ctx);
         const branches = checkedBranches(meta, ctx);
+        const branchesFallback = checkedBranchesFallback(meta, ctx);
         const audit = stringLiteralProp(meta, "audit");
         const commandName = stringLiteralProp(meta, "name") ?? cls.name?.text ?? "<anonymous>";
         const uses = await parseInfraResourceUseRefs(infraResourceProp(meta, "uses", ctx), ctx, `command ${commandName}`, sourcePath(ctx.rootDir, cls.getSourceFile().fileName), lineOf(cls));
@@ -20274,6 +20315,7 @@ async function parseModule(candidate, nameByNode, ctx) {
           ...permission === undefined ? {} : { permission },
           ...rpc === undefined ? {} : { rpc },
           ...branches === undefined ? {} : { branches },
+          ...branchesFallback === undefined ? {} : { branchesFallback },
           transaction: checkedCommandMode(meta, "transaction", ctx, cls.name?.text ?? "<anonymous>") ?? "none",
           ...audit === undefined ? {} : { audit },
           idempotency: checkedCommandMode(meta, "idempotency", ctx, cls.name?.text ?? "<anonymous>") ?? "none",
@@ -22112,6 +22154,23 @@ function checkedBranches(meta, ctx) {
   }
   return branches;
 }
+function checkedBranchesFallback(meta, ctx) {
+  const expression = getProp(meta, "branchesFallback");
+  if (!expression)
+    return;
+  const value = stringLiteralProp(meta, "branchesFallback");
+  if (value === "reject" || value === "command")
+    return value;
+  ctx.diagnostics.push({
+    severity: "error",
+    code: "invalid-command-branches-fallback",
+    file: sourcePath(ctx.rootDir, expression.getSourceFile().fileName),
+    line: lineOf(expression),
+    message: "Command branchesFallback must be 'reject' or 'command'.",
+    suggestion: "Use branchesFallback: 'command' only when the command handler owns the unmatched-input boundary."
+  });
+  return;
+}
 async function classDeps(cls, ctx) {
   const injectable = await parseInjectableOptions(cls, ctx);
   const ctor = cls.members.find(ts8.isConstructorDeclaration);
@@ -25292,8 +25351,8 @@ function createDeliveryPlan(graph, input, validation) {
       target.execution = group;
     }
   }
-  if ([...targets.values()].reduce((count, target) => count + (target.execution?.replicas ?? 1), 0) > 32) {
-    fail("delivery-execution-replica-limit", "A release supports at most 32 runtime targets including replicas.", "Reduce the replica count or split independent applications.");
+  if ([...targets.values()].reduce((count, target) => count + (target.execution ? (target.execution.replicas ?? 1) * (target.execution.shardCount ?? 1) : 1), 0) > 256) {
+    fail("delivery-execution-replica-limit", "A release supports at most 256 runtime targets including replicas and queue shards.", "Reduce the replica or shard count, or split independent applications.");
   }
   const canonicalDiagnostics = [...new Map(diagnostics.map((item) => [JSON.stringify(item), item])).values()].sort((a, b) => compare2(JSON.stringify(a), JSON.stringify(b)));
   if (canonicalDiagnostics.some((item) => item.severity === "error")) {
@@ -25384,6 +25443,7 @@ function validateExecutionManifest(plan, capabilities = {}) {
         ...command.adapter === null ? {} : { rpc: command.adapter },
         ...command.audit === null ? {} : { audit: command.audit },
         ...command.branches.length === 0 ? {} : { branches: command.branches },
+        ...command.branchesFallback === undefined ? {} : { branchesFallback: command.branchesFallback },
         transaction: command.transaction,
         idempotency: command.idempotency
       }))
@@ -26450,10 +26510,10 @@ import { readFileSync as readFileSync4 } from "node:fs";
 import { resolve as resolve19 } from "node:path";
 
 // src/migration-app-version.ts
-var MIGRATION_APP_VERSION = "0.39.0";
+var MIGRATION_APP_VERSION = "0.39.1";
 
 // src/migration-elysia-version.ts
-var MIGRATION_ELYSIA_VERSION = "0.41.0";
+var MIGRATION_ELYSIA_VERSION = "0.42.0";
 
 // src/migration-policy.ts
 var cachedCompilerVersion;

package/dist/contract-manifest.d.ts

@@ -7,6 +7,7 @@ export interface ContractManifest {
         module: string;
         permission?: string;
         rpc?: string;
+        branchesFallback?: "reject" | "command";
         branches?: Array<{
             when: string;
             adapter: string;

package/dist/delivery-bundle-protocol.d.ts

@@ -19,6 +19,7 @@ declare const requestSchema: Type.TObject<{
                 definitionVersion: Type.TString;
                 replicas: Type.TInteger;
                 maxReplicas: Type.TInteger;
+                shardCount: Type.TOptional<Type.TInteger>;
                 concurrencyPerReplica: Type.TInteger;
                 resources: Type.TObject<{
                     cpuLimit: Type.TNumber;

package/dist/delivery-bundle-worker.js

@@ -10103,23 +10103,49 @@ var init_build2 = __esm(() => {
 });
 
 // node_modules/@supacloud/delivery/src/worker-execution.ts
+function workerShardCount(group) {
+  return group.shardCount ?? 1;
+}
+function shardSuffix(shard) {
+  if (!Number.isSafeInteger(shard) || shard < 0 || shard >= 64) {
+    throw new Error("WORKER_SHARD_INVALID");
+  }
+  return `s${shard.toString(36).padStart(2, "0")}`;
+}
+function workerShardQueue(group, shard) {
+  const count = workerShardCount(group);
+  if (!Number.isSafeInteger(shard) || shard < 0 || shard >= count) {
+    throw new Error("WORKER_SHARD_INVALID");
+  }
+  if (count === 1)
+    return group.queue;
+  const queue = `${group.queue}_${shardSuffix(shard)}`;
+  if (!/^scw_[a-z0-9_]{1,40}$/.test(queue))
+    throw new Error("WORKER_QUEUE_INVALID");
+  return queue;
+}
 function parseWorkerExecutionGroup(value) {
   if (!Check2(WorkerExecutionGroupSchema, value) || value.replicas > value.maxReplicas || !value.queue.endsWith(`_v${value.definitionVersion}`) || value.lifecycle.visibilityTimeoutSeconds < value.lifecycle.executionTimeoutSeconds + value.lifecycle.shutdownGraceSeconds + 30) {
     throw new Error("WORKER_EXECUTION_INVALID");
   }
-  return structuredClone(value);
+  const group = structuredClone(value);
+  for (let shard = 0;shard < workerShardCount(group); shard += 1)
+    workerShardQueue(group, shard);
+  return group;
 }
 function validateWorkerExecution(groups) {
   const names = new Set, targets = new Set, queues = new Set, routes = new Set;
   for (const candidate of groups) {
     const group = parseWorkerExecutionGroup(candidate);
     const route = `${group.taskKey}:${group.definitionVersion}`;
-    if (names.has(group.name) || targets.has(group.target) || queues.has(group.queue) || routes.has(route)) {
+    const physicalQueues = Array.from({ length: workerShardCount(group) }, (_, shard) => workerShardQueue(group, shard));
+    if (names.has(group.name) || targets.has(group.target) || queues.has(group.queue) || physicalQueues.some((queue) => queues.has(queue)) || routes.has(route)) {
       throw new Error("WORKER_EXECUTION_CONFLICT");
     }
     names.add(group.name);
     targets.add(group.target);
     queues.add(group.queue);
+    physicalQueues.forEach((queue) => queues.add(queue));
     routes.add(route);
   }
 }
@@ -10143,6 +10169,7 @@ var init_worker_execution = __esm(() => {
     definitionVersion: String2({ pattern: "^[1-9][0-9]{0,8}$" }),
     replicas: positive(16),
     maxReplicas: positive(16),
+    shardCount: Optional(positive(64)),
     concurrencyPerReplica: positive(32),
     resources: ComputeResourcesSchema,
     database: _Object_({

package/dist/index.js

@@ -1089,7 +1089,13 @@ function validateGraph(graph, options = false) {
       if (command.rpc && command.branches) {
         error("command-rpc-branches-conflict", `Command ${command.name} cannot declare both rpc and branches.`, module.file, module.line);
       }
+      if (command.branchesFallback !== undefined && command.branchesFallback !== "reject" && command.branchesFallback !== "command") {
+        error("command-branches-fallback-invalid", `Command ${command.name} has an invalid branches fallback.`, module.file, module.line);
+      }
       const branchAdapters = command.branches ?? [];
+      if (command.branchesFallback === "command" && branchAdapters.length === 0) {
+        error("command-branches-fallback-without-branches", `Command ${command.name} declares a fallback without branches.`, module.file, module.line);
+      }
       for (const branch of branchAdapters) {
         if (typeof options !== "object" || !Object.hasOwn(options.commandCapabilities?.rpc ?? {}, branch.rpc)) {
           error("command-rpc-unavailable", `Command ${command.name} requires configured RPC adapter '${branch.rpc}'.`, module.file, module.line);
@@ -1119,7 +1125,7 @@ function validateGraph(graph, options = false) {
             error("command-transaction-unsupported", `Command ${command.name} branch '${branch.when}' declares transaction, but transaction support is unavailable.`, module.file, module.line);
           }
         }
-        if (hostCaps.requirePersistentAdapters && (command.rpc !== undefined && (!rpcCaps?.boundary || rpcCaps.audit !== true || rpcCaps.idempotency !== true) || branchCaps.length > 0 && branchCaps.some(({ branch, capabilities }) => !capabilities?.boundary || capabilities.audit !== true || capabilities.idempotency !== true || capabilities.boundary === "database" && (capabilities.transaction !== true || branch.transaction !== "required")) || hostCaps.permission !== true || !command.permission || branchCaps.length === 0 && (!command.audit || command.idempotency !== "required") || branchCaps.length > 0 && branchCaps.some(({ branch }) => !branch.audit || branch.idempotency !== "required") || branchCaps.length > 0 && branchCaps.some(({ capabilities }) => capabilities?.boundary === "external" && capabilities.reconcile !== true) || command.rpc !== undefined && rpcCaps?.boundary === "database" && (rpcCaps.transaction !== true || command.transaction !== "required") || command.rpc === undefined && branchCaps.length === 0 && (hostCaps.audit !== true || hostCaps.idempotency !== true || hostCaps.transaction !== true || command.transaction !== "required") || command.rpc !== undefined && rpcCaps?.boundary === "external" && rpcCaps.reconcile !== true)) {
+        if (hostCaps.requirePersistentAdapters && (command.rpc !== undefined && (!rpcCaps?.boundary || rpcCaps.audit !== true || rpcCaps.idempotency !== true) || branchCaps.length > 0 && branchCaps.some(({ branch, capabilities }) => !capabilities?.boundary || capabilities.audit !== true || capabilities.idempotency !== true || capabilities.boundary === "database" && (capabilities.transaction !== true || branch.transaction !== "required")) || hostCaps.permission !== true || !command.permission || branchCaps.length === 0 && (!command.audit || command.idempotency !== "required") || branchCaps.length > 0 && branchCaps.some(({ branch }) => !branch.audit || branch.idempotency !== "required") || branchCaps.length > 0 && branchCaps.some(({ capabilities }) => capabilities?.boundary === "external" && capabilities.reconcile !== true) || command.branchesFallback === "command" && (!command.audit || command.idempotency !== "required" || command.transaction !== "required" || hostCaps.audit !== true || hostCaps.idempotency !== true || hostCaps.transaction !== true) || command.rpc !== undefined && rpcCaps?.boundary === "database" && (rpcCaps.transaction !== true || command.transaction !== "required") || command.rpc === undefined && branchCaps.length === 0 && (hostCaps.audit !== true || hostCaps.idempotency !== true || hostCaps.transaction !== true || command.transaction !== "required") || command.rpc !== undefined && rpcCaps?.boundary === "external" && rpcCaps.reconcile !== true)) {
           error("command-persistence-required", `Command ${command.name} requires an explicit persistent adapter, permission, audit and idempotency policy.`, module.file, module.line, "Register a named database/external adapter, enable permission checks and declare permission, audit and required idempotency on the command.");
         }
         if (rpcCaps?.boundary === "external" && (command.transaction === "required" || rpcCaps.transaction === true)) {
@@ -1672,6 +1678,7 @@ function buildContractManifest(graph, artifacts) {
         module: module.name,
         ...command.permission === undefined ? {} : { permission: command.permission },
         ...command.rpc === undefined ? {} : { rpc: command.rpc },
+        ...command.branchesFallback === undefined ? {} : { branchesFallback: command.branchesFallback },
         ...command.branches === undefined ? {} : {
           branches: command.branches.map((branch) => ({
             when: branch.when,
@@ -2403,6 +2410,7 @@ function renderApplication(graph, options) {
     permission: command.permission ?? null,
     rpc: command.rpc ?? null,
     branches: command.branches ?? [],
+    branchesFallback: command.branchesFallback ?? "reject",
     transaction: command.transaction ?? null,
     audit: command.audit ?? null,
     idempotency: command.idempotency ?? null
@@ -2481,6 +2489,7 @@ function renderApplication(graph, options) {
         transaction: command.transaction,
         idempotency: command.idempotency,
         branches: command.branches ?? [],
+        branchesFallback: command.branchesFallback ?? "reject",
         ...command.tenantScope === undefined ? {} : { tenantScope: command.tenantScope },
         requiredCapabilities: {
           permission: true,
@@ -2973,6 +2982,7 @@ ${indent(item, 2)}`).join(",")}
         `idempotency: ${JSON.stringify(command.idempotency)}`,
         ...command.tenantScope ? [`tenantScope: ${JSON.stringify(command.tenantScope)}`] : [],
         ...command.rpc ? [`rpc: ${JSON.stringify(command.rpc)}`] : [],
+        ...command.branchesFallback ? [`branchesFallback: ${JSON.stringify(command.branchesFallback)}`] : [],
         ...command.branches && command.branches.length > 0 ? [`branches: ${JSON.stringify(command.branches)}`] : [],
         ...command.standalone ? ["standalone: true"] : [],
         ...command.aspects && command.aspects.length > 0 ? [`aspects: ${this.renderAspects(command.aspects)}`, `aspectPipeline: ${this.renderAspectPipeline(command.aspects)}`] : []
@@ -4732,6 +4742,7 @@ var HEADER = "// GENERATED BY @supacloud/compiler — do not edit", INTERFACES =
 export interface CompiledCommand {
   rpc?: string;
   branches?: readonly CompiledCommandBranch[];
+  branchesFallback?: "reject" | "command";
   className: string;
   name: string;
   permission: string;
@@ -4864,7 +4875,7 @@ async function compiledAspectStep(context: CompiledAspectContext, handler: () =>
     }
     called = true;
     pending = Promise.resolve().then(handler).then(result => {
-      if (strict) freezeCompiledAspectData(result);
+      if (strict && !(result instanceof Response)) freezeCompiledAspectData(result);
       value = result;
       return result;
     });
@@ -15630,23 +15641,49 @@ var init_value2 = __esm(() => {
 });
 
 // node_modules/@supacloud/delivery/src/worker-execution.ts
+function workerShardCount(group) {
+  return group.shardCount ?? 1;
+}
+function shardSuffix(shard) {
+  if (!Number.isSafeInteger(shard) || shard < 0 || shard >= 64) {
+    throw new Error("WORKER_SHARD_INVALID");
+  }
+  return `s${shard.toString(36).padStart(2, "0")}`;
+}
+function workerShardQueue(group, shard) {
+  const count = workerShardCount(group);
+  if (!Number.isSafeInteger(shard) || shard < 0 || shard >= count) {
+    throw new Error("WORKER_SHARD_INVALID");
+  }
+  if (count === 1)
+    return group.queue;
+  const queue = `${group.queue}_${shardSuffix(shard)}`;
+  if (!/^scw_[a-z0-9_]{1,40}$/.test(queue))
+    throw new Error("WORKER_QUEUE_INVALID");
+  return queue;
+}
 function parseWorkerExecutionGroup(value) {
   if (!Check2(WorkerExecutionGroupSchema, value) || value.replicas > value.maxReplicas || !value.queue.endsWith(`_v${value.definitionVersion}`) || value.lifecycle.visibilityTimeoutSeconds < value.lifecycle.executionTimeoutSeconds + value.lifecycle.shutdownGraceSeconds + 30) {
     throw new Error("WORKER_EXECUTION_INVALID");
   }
-  return structuredClone(value);
+  const group = structuredClone(value);
+  for (let shard = 0;shard < workerShardCount(group); shard += 1)
+    workerShardQueue(group, shard);
+  return group;
 }
 function validateWorkerExecution(groups) {
   const names = new Set, targets = new Set, queues = new Set, routes = new Set;
   for (const candidate of groups) {
     const group = parseWorkerExecutionGroup(candidate);
     const route = `${group.taskKey}:${group.definitionVersion}`;
-    if (names.has(group.name) || targets.has(group.target) || queues.has(group.queue) || routes.has(route)) {
+    const physicalQueues = Array.from({ length: workerShardCount(group) }, (_, shard) => workerShardQueue(group, shard));
+    if (names.has(group.name) || targets.has(group.target) || queues.has(group.queue) || physicalQueues.some((queue) => queues.has(queue)) || routes.has(route)) {
       throw new Error("WORKER_EXECUTION_CONFLICT");
     }
     names.add(group.name);
     targets.add(group.target);
     queues.add(group.queue);
+    physicalQueues.forEach((queue) => queues.add(queue));
     routes.add(route);
   }
 }
@@ -15670,6 +15707,7 @@ var init_worker_execution = __esm(() => {
     definitionVersion: String2({ pattern: "^[1-9][0-9]{0,8}$" }),
     replicas: positive(16),
     maxReplicas: positive(16),
+    shardCount: Optional(positive(64)),
     concurrencyPerReplica: positive(32),
     resources: ComputeResourcesSchema,
     database: _Object_({
@@ -16079,7 +16117,7 @@ function parseDeliveryBuildManifest(value) {
   if (!Check2(DeliveryBuildManifestSchema, value))
     throw new Error("Invalid delivery build manifest.");
   validateWorkerExecution(value.plan.targets.flatMap((target) => target.execution ? [target.execution] : []));
-  if (value.plan.targets.reduce((count, target) => count + (target.execution?.replicas ?? 1), 0) > 32) {
+  if (value.plan.targets.reduce((count, target) => count + (target.execution ? (target.execution.replicas ?? 1) * workerShardCount(target.execution) : 1), 0) > 256) {
     throw new Error("Invalid delivery replica count.");
   }
   for (const target of value.plan.targets) {
@@ -19838,6 +19876,7 @@ async function analyzeProject(rootDir, include, cache, changedPaths, effectOptio
             const permission = stringLiteralProp(meta, "permission");
             const rpc = checkedRpc(meta, ctx);
             const branches = checkedBranches(meta, ctx);
+            const branchesFallback = checkedBranchesFallback(meta, ctx);
             const audit = stringLiteralProp(meta, "audit");
             const standaloneName = stringLiteralProp(meta, "name") ?? classInfo.decl.name?.text ?? name;
             const standaloneUses = await parseInfraResourceUseRefs(infraResourceProp(meta, "uses", ctx), ctx, `command ${standaloneName}`, sourcePath(ctx.rootDir, classInfo.file), lineOf(classInfo.decl));
@@ -19848,6 +19887,7 @@ async function analyzeProject(rootDir, include, cache, changedPaths, effectOptio
               ...permission === undefined ? {} : { permission },
               ...rpc === undefined ? {} : { rpc },
               ...branches === undefined ? {} : { branches },
+              ...branchesFallback === undefined ? {} : { branchesFallback },
               transaction: checkedCommandMode(meta, "transaction", ctx, classInfo.decl.name?.text ?? name) ?? "none",
               ...audit === undefined ? {} : { audit },
               idempotency: checkedCommandMode(meta, "idempotency", ctx, classInfo.decl.name?.text ?? name) ?? "none",
@@ -20222,6 +20262,7 @@ async function parseModule(candidate, nameByNode, ctx) {
         const permission = stringLiteralProp(meta, "permission");
         const rpc = checkedRpc(meta, ctx);
         const branches = checkedBranches(meta, ctx);
+        const branchesFallback = checkedBranchesFallback(meta, ctx);
         const audit = stringLiteralProp(meta, "audit");
         const commandName = stringLiteralProp(meta, "name") ?? cls.name?.text ?? "<anonymous>";
         const uses = await parseInfraResourceUseRefs(infraResourceProp(meta, "uses", ctx), ctx, `command ${commandName}`, sourcePath(ctx.rootDir, cls.getSourceFile().fileName), lineOf(cls));
@@ -20233,6 +20274,7 @@ async function parseModule(candidate, nameByNode, ctx) {
           ...permission === undefined ? {} : { permission },
           ...rpc === undefined ? {} : { rpc },
           ...branches === undefined ? {} : { branches },
+          ...branchesFallback === undefined ? {} : { branchesFallback },
           transaction: checkedCommandMode(meta, "transaction", ctx, cls.name?.text ?? "<anonymous>") ?? "none",
           ...audit === undefined ? {} : { audit },
           idempotency: checkedCommandMode(meta, "idempotency", ctx, cls.name?.text ?? "<anonymous>") ?? "none",
@@ -22071,6 +22113,23 @@ function checkedBranches(meta, ctx) {
   }
   return branches;
 }
+function checkedBranchesFallback(meta, ctx) {
+  const expression = getProp(meta, "branchesFallback");
+  if (!expression)
+    return;
+  const value = stringLiteralProp(meta, "branchesFallback");
+  if (value === "reject" || value === "command")
+    return value;
+  ctx.diagnostics.push({
+    severity: "error",
+    code: "invalid-command-branches-fallback",
+    file: sourcePath(ctx.rootDir, expression.getSourceFile().fileName),
+    line: lineOf(expression),
+    message: "Command branchesFallback must be 'reject' or 'command'.",
+    suggestion: "Use branchesFallback: 'command' only when the command handler owns the unmatched-input boundary."
+  });
+  return;
+}
 async function classDeps(cls, ctx) {
   const injectable = await parseInjectableOptions(cls, ctx);
   const ctor = cls.members.find(ts8.isConstructorDeclaration);
@@ -23860,8 +23919,8 @@ function createDeliveryPlan(graph, input, validation) {
       target.execution = group;
     }
   }
-  if ([...targets.values()].reduce((count, target) => count + (target.execution?.replicas ?? 1), 0) > 32) {
-    fail("delivery-execution-replica-limit", "A release supports at most 32 runtime targets including replicas.", "Reduce the replica count or split independent applications.");
+  if ([...targets.values()].reduce((count, target) => count + (target.execution ? (target.execution.replicas ?? 1) * (target.execution.shardCount ?? 1) : 1), 0) > 256) {
+    fail("delivery-execution-replica-limit", "A release supports at most 256 runtime targets including replicas and queue shards.", "Reduce the replica or shard count, or split independent applications.");
   }
   const canonicalDiagnostics = [...new Map(diagnostics.map((item) => [JSON.stringify(item), item])).values()].sort((a, b) => compare2(JSON.stringify(a), JSON.stringify(b)));
   if (canonicalDiagnostics.some((item) => item.severity === "error")) {
@@ -23951,6 +24010,7 @@ function validateExecutionManifest(plan, capabilities = {}) {
         ...command.adapter === null ? {} : { rpc: command.adapter },
         ...command.audit === null ? {} : { audit: command.audit },
         ...command.branches.length === 0 ? {} : { branches: command.branches },
+        ...command.branchesFallback === undefined ? {} : { branchesFallback: command.branchesFallback },
         transaction: command.transaction,
         idempotency: command.idempotency
       }))
@@ -25702,10 +25762,10 @@ import { readFileSync as readFileSync4 } from "node:fs";
 import { resolve as resolve17 } from "node:path";
 
 // src/migration-app-version.ts
-var MIGRATION_APP_VERSION = "0.39.0";
+var MIGRATION_APP_VERSION = "0.39.1";
 
 // src/migration-elysia-version.ts
-var MIGRATION_ELYSIA_VERSION = "0.41.0";
+var MIGRATION_ELYSIA_VERSION = "0.42.0";
 
 // src/migration-policy.ts
 var cachedCompilerVersion;

package/dist/migration-app-version.d.ts

@@ -1 +1 @@
-export declare const MIGRATION_APP_VERSION = "0.39.0";
+export declare const MIGRATION_APP_VERSION = "0.39.1";

package/dist/migration-elysia-version.d.ts

@@ -1 +1 @@
-export declare const MIGRATION_ELYSIA_VERSION = "0.41.0";
+export declare const MIGRATION_ELYSIA_VERSION = "0.42.0";

package/dist/types.d.ts

@@ -324,6 +324,7 @@ export interface ControllerNode {
 export interface CommandNode {
     rpc?: string;
     branches?: CommandBranchNode[];
+    branchesFallback?: "reject" | "command";
     className: string;
     name: string;
     permission?: string;
@@ -432,6 +433,7 @@ export interface ExecutionPlanCommand {
     transaction: CommandNode["transaction"];
     idempotency: CommandNode["idempotency"];
     branches: CommandBranchNode[];
+    branchesFallback: "reject" | "command";
     tenantScope?: CommandNode["tenantScope"];
     requiredCapabilities: {
         permission: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/compiler",
-  "version": "0.58.0",
+  "version": "0.59.0",
   "description": "Static compiler for @supacloud/app metadata: builds the application graph from AST, validates it, and generates reflection-free factory code",
   "type": "module",
   "main": "./dist/index.js",
@@ -57,8 +57,8 @@
     "directory": "packages/compiler"
   },
   "dependencies": {
-    "@supacloud/db": "0.22.0",
-    "@supacloud/delivery": "0.25.0",
+    "@supacloud/db": "0.23.1",
+    "@supacloud/delivery": "0.26.0",
     "typebox": "1.4.3",
     "@graphql-codegen/core": "^6.2.2",
     "@graphql-codegen/typed-document-node": "^7.2.0",