@lunora/server 1.0.0-alpha.188 → 1.0.0-alpha.189

package/dist/types.d.mts

@@ -1818,6 +1818,29 @@ interface WorkflowStatusResult {
   output?: unknown;
   status: WorkflowInstanceStatus;
 }
+/** Options accepted by {@link WorkflowHandle.createBatch}: explicit `instances`, or `count` sharing one `params`/`retention`. Mirrors `@lunora/workflow`'s `WorkflowCreateBatchOptions`. */
+type WorkflowCreateBatchOptions<Params = Record<string, unknown>> = {
+  instances: ReadonlyArray<WorkflowCreateOptions<Params>>;
+} | {
+  count: number;
+  params?: Params;
+  retention?: {
+    errorRetention?: string;
+    successRetention?: string;
+  };
+};
+/** One instance a batch did not create; `index` is its input position. Mirrors `@lunora/workflow`'s `WorkflowCreateBatchError`. */
+interface WorkflowCreateBatchError {
+  code: number;
+  id?: string;
+  index: number;
+  message: string;
+}
+/** Result of {@link WorkflowHandle.createBatch}. Mirrors `@lunora/workflow`'s `WorkflowCreateBatchResult`. */
+interface WorkflowCreateBatchResult {
+  created: WorkflowInstance[];
+  errors: WorkflowCreateBatchError[];
+}
 /** Options accepted by {@link WorkflowHandle.create}. Mirrors `@lunora/workflow`'s `WorkflowCreateOptions`. */
 interface WorkflowCreateOptions<Params = Record<string, unknown>> {
   /** Unique-within-the-workflow instance id. Generated by Cloudflare when omitted. */
@@ -1876,8 +1899,8 @@ interface WorkflowInstance {
 interface WorkflowHandle<Params = Record<string, unknown>> {
   /** Start a new instance (optionally with an id + params). */
   create: (options?: WorkflowCreateOptions<Params>) => Promise<WorkflowInstance>;
-  /** Start many instances in one batched RPC. */
-  createBatch: (batch: ReadonlyArray<WorkflowCreateOptions<Params>>) => Promise<WorkflowInstance[]>;
+  /** Start many instances in one batched RPC; per-instance failures come back in `errors`, not dropped. */
+  createBatch: (options: WorkflowCreateBatchOptions<Params>) => Promise<WorkflowCreateBatchResult>;
   /** Delete up to 100 instances and their stored state; ids that do not exist come back as per-instance errors. */
   deleteBatch: (instanceIds: ReadonlyArray<string>) => Promise<{
     deleted: {

package/dist/types.d.ts

@@ -1818,6 +1818,29 @@ interface WorkflowStatusResult {
   output?: unknown;
   status: WorkflowInstanceStatus;
 }
+/** Options accepted by {@link WorkflowHandle.createBatch}: explicit `instances`, or `count` sharing one `params`/`retention`. Mirrors `@lunora/workflow`'s `WorkflowCreateBatchOptions`. */
+type WorkflowCreateBatchOptions<Params = Record<string, unknown>> = {
+  instances: ReadonlyArray<WorkflowCreateOptions<Params>>;
+} | {
+  count: number;
+  params?: Params;
+  retention?: {
+    errorRetention?: string;
+    successRetention?: string;
+  };
+};
+/** One instance a batch did not create; `index` is its input position. Mirrors `@lunora/workflow`'s `WorkflowCreateBatchError`. */
+interface WorkflowCreateBatchError {
+  code: number;
+  id?: string;
+  index: number;
+  message: string;
+}
+/** Result of {@link WorkflowHandle.createBatch}. Mirrors `@lunora/workflow`'s `WorkflowCreateBatchResult`. */
+interface WorkflowCreateBatchResult {
+  created: WorkflowInstance[];
+  errors: WorkflowCreateBatchError[];
+}
 /** Options accepted by {@link WorkflowHandle.create}. Mirrors `@lunora/workflow`'s `WorkflowCreateOptions`. */
 interface WorkflowCreateOptions<Params = Record<string, unknown>> {
   /** Unique-within-the-workflow instance id. Generated by Cloudflare when omitted. */
@@ -1876,8 +1899,8 @@ interface WorkflowInstance {
 interface WorkflowHandle<Params = Record<string, unknown>> {
   /** Start a new instance (optionally with an id + params). */
   create: (options?: WorkflowCreateOptions<Params>) => Promise<WorkflowInstance>;
-  /** Start many instances in one batched RPC. */
-  createBatch: (batch: ReadonlyArray<WorkflowCreateOptions<Params>>) => Promise<WorkflowInstance[]>;
+  /** Start many instances in one batched RPC; per-instance failures come back in `errors`, not dropped. */
+  createBatch: (options: WorkflowCreateBatchOptions<Params>) => Promise<WorkflowCreateBatchResult>;
   /** Delete up to 100 instances and their stored state; ids that do not exist come back as per-instance errors. */
   deleteBatch: (instanceIds: ReadonlyArray<string>) => Promise<{
     deleted: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/server",
-  "version": "1.0.0-alpha.188",
+  "version": "1.0.0-alpha.189",
   "description": "Server primitives for Lunora: defineSchema, defineTable, query, mutation, and action",
   "keywords": [
     "backend",