@tailor-platform/create-sdk 2.0.0-next.0 → 2.0.0-next.2

package/CHANGELOG.md

@@ -1,7 +1,37 @@
 # @tailor-platform/create-sdk
 
+## 2.0.0-next.2
+### Major Changes
+
+
+
+- [#1498](https://github.com/tailor-platform/sdk/pull/1498) [`83145db`](https://github.com/tailor-platform/sdk/commit/83145db9a0d243aa68c1b641c2b6026771a62188) Thanks [@dqn](https://github.com/dqn)! - Set `db.fields.timestamps()` `updatedAt` when records are created and make the generated field non-null. `createdAt` keeps its existing create-time behavior, while `updatedAt` keeps its update-time behavior and now also gets a create hook that preserves provided values and falls back to the current time.
+  
+  Update create-sdk templates so scaffolded projects use the new non-null `updatedAt` Kysely types and seed schemas.
+  
+  Existing TailorDB schemas that already use this helper will change `updatedAt` from optional to required. Backfill existing records that have `updatedAt: null` before applying the schema change.
+
+### Patch Changes
+
+
+
+- [#1509](https://github.com/tailor-platform/sdk/pull/1509) [`7cadaa7`](https://github.com/tailor-platform/sdk/commit/7cadaa7c4987b81130ca80ba80bc5d5b26276394) Thanks [@dqn](https://github.com/dqn)! - Rename resolver, executor, workflow trigger, and typed workflow start machine-user options from `authInvoker` to `invoker`.
+  
+  Update create-sdk templates and the v2 auth invoker codemod to generate the new `invoker` option.
+
+
+- [#1484](https://github.com/tailor-platform/sdk/pull/1484) [`a376dc8`](https://github.com/tailor-platform/sdk/commit/a376dc8cd053d20744c90104e8b44ed2729ffe8c) Thanks [@dqn](https://github.com/dqn)! - Remove the deprecated `openDownloadStream` file streaming API. Use `downloadStream` for streamed file downloads.
+  
+  The generated file utilities now emit `downloadFileStream`, which calls `downloadStream` and returns `FileDownloadStreamResponse`, instead of the removed `openFileDownloadStream` helper.
+
+## 2.0.0-next.1
+
 ## 2.0.0-next.0
 
+## 1.66.0
+
+## 1.65.0
+
 ## 1.64.0
 
 ## 1.63.0

package/dist/index.js

@@ -23,7 +23,7 @@ const templateHints = {
 	workflow: "Workflow patterns with job chaining and testing",
 	executor: "Executor trigger types (record, resolver, schedule, webhook)",
 	"static-web-site": "Static website with auth and IdP integration",
-	generators: "Built-in generators: kysely, enums, files, seed"
+	generators: "Built-in generation plugins: kysely, enums, files, seed"
 };
 const validateName = (name) => {
 	if (!name) return "Project name is required.";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailor-platform/create-sdk",
-  "version": "2.0.0-next.0",
+  "version": "2.0.0-next.2",
   "description": "A CLI tool to quickly create a new Tailor Platform SDK project",
   "license": "MIT",
   "repository": {
@@ -21,15 +21,15 @@
     "execa": "9.6.1",
     "picocolors": "1.1.1",
     "pkg-types": "2.3.1",
-    "politty": "0.5.1",
+    "politty": "0.6.0",
     "zod": "4.4.3"
   },
   "devDependencies": {
-    "@types/node": "24.13.1",
+    "@types/node": "24.13.2",
     "oxlint": "1.69.0",
     "oxlint-tsgolint": "0.23.0",
     "tsdown": "0.22.2",
-    "typescript": "5.9.3"
+    "typescript": "6.0.3"
   },
   "scripts": {
     "build": "tsdown",

package/templates/executor/package.json

@@ -14,12 +14,12 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/sdk": "2.0.0-next.0",
-    "@types/node": "24.13.1",
+    "@tailor-platform/sdk": "2.0.0-next.2",
+    "@types/node": "24.13.2",
     "oxfmt": "0.54.0",
     "oxlint": "1.69.0",
     "oxlint-tsgolint": "0.23.0",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vitest": "4.1.8"
   }
 }

package/templates/executor/src/generated/db.ts

@@ -20,7 +20,7 @@ export interface Namespace {
       entityId: string;
       message: string;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
 
     Notification: {
@@ -30,7 +30,7 @@ export interface Namespace {
       body: string;
       isRead: boolean;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
 
     User: {
@@ -39,7 +39,7 @@ export interface Namespace {
       email: string;
       role: "ADMIN" | "MEMBER";
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
   }
 }

package/templates/generators/package.json

@@ -14,12 +14,12 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/sdk": "2.0.0-next.0",
-    "@types/node": "24.13.1",
+    "@tailor-platform/sdk": "2.0.0-next.2",
+    "@types/node": "24.13.2",
     "oxfmt": "0.54.0",
     "oxlint": "1.69.0",
     "oxlint-tsgolint": "0.23.0",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vitest": "4.1.8"
   }
 }

package/templates/generators/src/generated/db.ts

@@ -28,7 +28,7 @@ export interface Namespace {
       totalPrice: number;
       status: "PENDING" | "CONFIRMED" | "SHIPPED" | "DELIVERED" | "CANCELLED";
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
 
     Product: {
@@ -39,7 +39,7 @@ export interface Namespace {
       status: "DRAFT" | "ACTIVE" | "DISCONTINUED";
       categoryId: string | null;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
 
     User: {
@@ -48,7 +48,7 @@ export interface Namespace {
       email: string;
       role: "ADMIN" | "MEMBER" | "VIEWER";
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
   }
 }

package/templates/generators/src/generated/files.ts

@@ -3,7 +3,7 @@ import type {
   FileUploadOptions,
   FileUploadResponse,
   FileMetadata,
-  FileStreamIterator,
+  FileDownloadStreamResponse,
 } from "@tailor-platform/sdk/runtime/file";
 
 export interface TypeWithFiles {
@@ -50,10 +50,10 @@ export async function getFileMetadata<T extends keyof TypeWithFiles>(
   return await file.getMetadata(namespaces[type], type, field, recordId);
 }
 
-export async function openFileDownloadStream<T extends keyof TypeWithFiles>(
+export async function downloadFileStream<T extends keyof TypeWithFiles>(
   type: T,
   field: TypeWithFiles[T]["fields"],
   recordId: string,
-): Promise<FileStreamIterator> {
-  return await file.openDownloadStream(namespaces[type], type, field, recordId);
+): Promise<FileDownloadStreamResponse> {
+  return await file.downloadStream(namespaces[type], type, field, recordId);
 }

package/templates/generators/src/resolver/getProduct.test.ts

@@ -1,4 +1,3 @@
-import { unauthenticatedTailorUser } from "@tailor-platform/sdk/test";
 import { mockTailordb } from "@tailor-platform/sdk/vitest";
 import { describe, expect, test } from "vitest";
 import resolver from "./getProduct";
@@ -22,7 +21,8 @@ describe("getProduct resolver", () => {
 
     const result = await resolver.body({
       input: { productId: "product-1" },
-      user: unauthenticatedTailorUser,
+      caller: null,
+      invoker: null,
       env: {},
     });
 
@@ -51,7 +51,8 @@ describe("getProduct resolver", () => {
 
     const result = await resolver.body({
       input: { productId: "product-2" },
-      user: unauthenticatedTailorUser,
+      caller: null,
+      invoker: null,
       env: {},
     });
 

package/templates/generators/src/seed/data/Order.schema.ts

@@ -4,8 +4,8 @@ import { createTailorDBHook, createStandardSchema } from "@tailor-platform/sdk/t
 import { order } from "../../db/order";
 
 const schemaType = t.object({
-  ...order.pickFields(["id","createdAt"], { optional: true }),
-  ...order.omitFields(["id","createdAt"]),
+  ...order.pickFields(["id","createdAt","updatedAt"], { optional: true }),
+  ...order.omitFields(["id","createdAt","updatedAt"]),
 });
 
 const hook = createTailorDBHook(order);

package/templates/generators/src/seed/data/Product.schema.ts

@@ -4,8 +4,8 @@ import { createTailorDBHook, createStandardSchema } from "@tailor-platform/sdk/t
 import { product } from "../../db/product";
 
 const schemaType = t.object({
-  ...product.pickFields(["id","createdAt"], { optional: true }),
-  ...product.omitFields(["id","createdAt"]),
+  ...product.pickFields(["id","createdAt","updatedAt"], { optional: true }),
+  ...product.omitFields(["id","createdAt","updatedAt"]),
 });
 
 const hook = createTailorDBHook(product);

package/templates/generators/src/seed/data/User.schema.ts

@@ -4,8 +4,8 @@ import { createTailorDBHook, createStandardSchema } from "@tailor-platform/sdk/t
 import { user } from "../../db/user";
 
 const schemaType = t.object({
-  ...user.pickFields(["id","createdAt"], { optional: true }),
-  ...user.omitFields(["id","createdAt"]),
+  ...user.pickFields(["id","createdAt","updatedAt"], { optional: true }),
+  ...user.omitFields(["id","createdAt","updatedAt"]),
 });
 
 const hook = createTailorDBHook(user);

package/templates/generators/src/seed/exec.mjs

@@ -388,7 +388,7 @@ const seedViaTestExecScript = async (namespace, typesToSeed, deps, selfRefTypes)
       workspaceId,
       name: `seed-${namespace}.ts`,
       code: bundled.bundledCode,
-      arg: JSON.stringify({ data: chunk.data, order: chunk.order, selfRefTypes }),
+      arg: { data: chunk.data, order: chunk.order, selfRefTypes },
       invoker: {
         namespace: authNamespace,
         machineUserName,

package/templates/hello-world/package.json

@@ -12,11 +12,11 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/sdk": "2.0.0-next.0",
-    "@types/node": "24.13.1",
+    "@tailor-platform/sdk": "2.0.0-next.2",
+    "@types/node": "24.13.2",
     "oxfmt": "0.54.0",
     "oxlint": "1.69.0",
     "oxlint-tsgolint": "0.23.0",
-    "typescript": "5.9.3"
+    "typescript": "6.0.3"
   }
 }

package/templates/hello-world/src/generated/kysely-tailordb.ts

@@ -19,7 +19,7 @@ export interface Namespace {
       email: string;
       role: "MANAGER" | "STAFF";
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
   }
 }

package/templates/inventory-management/package.json

@@ -12,11 +12,11 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/sdk": "2.0.0-next.0",
-    "@types/node": "24.13.1",
+    "@tailor-platform/sdk": "2.0.0-next.2",
+    "@types/node": "24.13.2",
     "oxfmt": "0.54.0",
     "oxlint": "1.69.0",
     "oxlint-tsgolint": "0.23.0",
-    "typescript": "5.9.3"
+    "typescript": "6.0.3"
   }
 }

package/templates/inventory-management/src/executor/checkInventory.ts

@@ -1,6 +1,5 @@
 import { createExecutor, recordUpdatedTrigger } from "@tailor-platform/sdk";
 import { inventory } from "../db/inventory";
-import config from "../../tailor.config";
 import { getDB } from "../generated/kysely-tailordb";
 
 export default createExecutor({
@@ -22,6 +21,6 @@ export default createExecutor({
         })
         .execute();
     },
-    invoker: config.auth.invoker("manager"),
+    invoker: "manager",
   },
 });

package/templates/inventory-management/src/generated/kysely-tailordb.ts

@@ -18,7 +18,7 @@ export interface Namespace {
       name: string;
       description: string | null;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
 
     Contact: {
@@ -28,7 +28,7 @@ export interface Namespace {
       phone: string | null;
       address: string | null;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
 
     Inventory: {
@@ -36,14 +36,14 @@ export interface Namespace {
       productId: string;
       quantity: number;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
 
     Notification: {
       id: Generated<string>;
       message: string;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
 
     Order: {
@@ -54,7 +54,7 @@ export interface Namespace {
       orderType: "PURCHASE" | "SALES";
       contactId: string;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
 
     OrderItem: {
@@ -65,7 +65,7 @@ export interface Namespace {
       unitPrice: number;
       totalPrice: Generated<number | null>;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
 
     Product: {
@@ -74,7 +74,7 @@ export interface Namespace {
       description: string | null;
       categoryId: string;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
 
     User: {
@@ -83,7 +83,7 @@ export interface Namespace {
       email: string;
       role: "MANAGER" | "STAFF";
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
   }
 }

package/templates/inventory-management/src/resolver/registerOrder.ts

@@ -4,8 +4,8 @@ import { orderItem } from "../db/orderItem";
 import { type DB, getDB } from "../generated/kysely-tailordb";
 
 const input = {
-  order: t.object(order.omitFields(["id", "createdAt"])),
-  items: t.object(orderItem.omitFields(["id", "createdAt"]), { array: true }),
+  order: t.object(order.omitFields(["id", "createdAt", "updatedAt"])),
+  items: t.object(orderItem.omitFields(["id", "createdAt", "updatedAt"]), { array: true }),
 };
 interface Input {
   order: t.infer<typeof input.order>;

package/templates/multi-application/apps/admin/db/adminNote.ts

@@ -8,7 +8,7 @@ export const adminNote = db
   .type("AdminNote", {
     title: db.string(),
     content: db.string(),
-    authorId: db.uuid().hooks({ create: ({ user }) => user.id }),
+    authorId: db.uuid().hooks({ create: ({ invoker }) => invoker?.id ?? crypto.randomUUID() }),
     ...db.fields.timestamps(),
   })
   // NOTE: This permits all operations for simplicity.

package/templates/multi-application/package.json

@@ -13,11 +13,11 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/sdk": "2.0.0-next.0",
-    "@types/node": "24.13.1",
+    "@tailor-platform/sdk": "2.0.0-next.2",
+    "@types/node": "24.13.2",
     "oxfmt": "0.54.0",
     "oxlint": "1.69.0",
     "oxlint-tsgolint": "0.23.0",
-    "typescript": "5.9.3"
+    "typescript": "6.0.3"
   }
 }

package/templates/resolver/README.md

@@ -8,11 +8,11 @@ Demonstrates all resolver patterns with comprehensive testing approaches.
 - Database query resolver (Kysely with transactions)
 - Database mutation resolver (dependency injection pattern)
 - Environment variable access
-- User context access
+- Caller and invoker context access
 
 ## Testing Approaches
 
-1. **Direct `body()` call** - Simple resolvers with `unauthenticatedTailorUser`
+1. **Direct `body()` call** - Simple resolvers with explicit `caller` / `invoker` context values
 2. **`tailor-runtime` environment + `mockTailordb`** - Database resolvers via `mockTailordb` from `@tailor-platform/sdk/vitest` (no `vi.stubGlobal` needed)
 3. **Dependency injection** - Extract `DbOperations` interface for testability
 

package/templates/resolver/package.json

@@ -14,12 +14,12 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/sdk": "2.0.0-next.0",
-    "@types/node": "24.13.1",
+    "@tailor-platform/sdk": "2.0.0-next.2",
+    "@types/node": "24.13.2",
     "oxfmt": "0.54.0",
     "oxlint": "1.69.0",
     "oxlint-tsgolint": "0.23.0",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vitest": "4.1.8"
   }
 }

package/templates/resolver/src/generated/db.ts

@@ -19,7 +19,7 @@ export interface Namespace {
       email: string;
       age: number;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
   }
 }

package/templates/resolver/src/resolver/add.test.ts

@@ -1,4 +1,3 @@
-import { unauthenticatedTailorUser } from "@tailor-platform/sdk/test";
 import { describe, expect, test } from "vitest";
 import resolver from "./add";
 
@@ -6,7 +5,8 @@ describe("add resolver", () => {
   test("adds two positive numbers", async () => {
     const result = await resolver.body({
       input: { left: 1, right: 2 },
-      user: unauthenticatedTailorUser,
+      caller: null,
+      invoker: null,
       env: { appName: "Resolver Template", version: 1 },
     });
     expect(result).toBe(3);
@@ -15,7 +15,8 @@ describe("add resolver", () => {
   test("handles negative numbers", async () => {
     const result = await resolver.body({
       input: { left: -5, right: 3 },
-      user: unauthenticatedTailorUser,
+      caller: null,
+      invoker: null,
       env: { appName: "Resolver Template", version: 1 },
     });
     expect(result).toBe(-2);

package/templates/resolver/src/resolver/incrementUserAge.test.ts

@@ -1,4 +1,3 @@
-import { unauthenticatedTailorUser } from "@tailor-platform/sdk/test";
 import { mockTailordb } from "@tailor-platform/sdk/vitest";
 import { describe, expect, test } from "vitest";
 import resolver from "./incrementUserAge";
@@ -15,7 +14,8 @@ describe("incrementUserAge resolver", () => {
 
     const result = await resolver.body({
       input: { email: "test@example.com" },
-      user: unauthenticatedTailorUser,
+      caller: null,
+      invoker: null,
       env: { appName: "Resolver Template", version: 1 },
     });
     expect(result).toEqual({ oldAge: 30, newAge: 31 });
@@ -32,7 +32,8 @@ describe("incrementUserAge resolver", () => {
 
     const result = resolver.body({
       input: { email: "test@example.com" },
-      user: unauthenticatedTailorUser,
+      caller: null,
+      invoker: null,
       env: { appName: "Resolver Template", version: 1 },
     });
     await expect(result).rejects.toThrowError(/no result/i);

package/templates/resolver/src/resolver/showEnv.test.ts

@@ -1,4 +1,3 @@
-import { unauthenticatedTailorUser } from "@tailor-platform/sdk/test";
 import { describe, expect, test } from "vitest";
 import resolver from "./showEnv";
 
@@ -6,7 +5,8 @@ describe("showEnv resolver", () => {
   test("returns environment variables", async () => {
     const result = await resolver.body({
       input: undefined as never,
-      user: unauthenticatedTailorUser,
+      caller: null,
+      invoker: null,
       env: { appName: "Resolver Template", version: 1 },
     });
     expect(result).toEqual({ appName: "Resolver Template", version: 1 });

package/templates/resolver/src/resolver/showUserInfo.test.ts

@@ -1,4 +1,4 @@
-import { unauthenticatedTailorUser } from "@tailor-platform/sdk/test";
+import type { TailorPrincipal } from "@tailor-platform/sdk";
 import { describe, expect, test } from "vitest";
 import resolver from "./showUserInfo";
 
@@ -6,26 +6,29 @@ describe("showUserInfo resolver", () => {
   test("returns default user info", async () => {
     const result = await resolver.body({
       input: undefined as never,
-      user: unauthenticatedTailorUser,
+      caller: null,
+      invoker: null,
       env: { appName: "Resolver Template", version: 1 },
     });
     expect(result).toEqual({
-      userId: unauthenticatedTailorUser.id,
-      userType: unauthenticatedTailorUser.type,
-      workspaceId: unauthenticatedTailorUser.workspaceId,
+      userId: "anonymous",
+      userType: "anonymous",
+      workspaceId: "",
     });
   });
 
   test("returns custom user info", async () => {
-    const customUser = {
-      ...unauthenticatedTailorUser,
+    const customCaller = {
       id: "user-123",
       type: "machine_user" as const,
       workspaceId: "ws-456",
-    };
+      attributes: { role: "admin" },
+      attributeList: [],
+    } satisfies TailorPrincipal;
     const result = await resolver.body({
       input: undefined as never,
-      user: customUser,
+      caller: customCaller,
+      invoker: customCaller,
       env: { appName: "Resolver Template", version: 1 },
     });
     expect(result).toEqual({

package/templates/resolver/src/resolver/showUserInfo.ts

@@ -6,9 +6,9 @@ const resolver = createResolver({
   operation: "query",
   body: (context) => {
     return {
-      userId: context.user.id,
-      userType: context.user.type,
-      workspaceId: context.user.workspaceId,
+      userId: context.caller?.id ?? "anonymous",
+      userType: context.caller?.type ?? "anonymous",
+      workspaceId: context.caller?.workspaceId ?? "",
     };
   },
   output: t.object({

package/templates/resolver/src/resolver/upsertUsers.test.ts

@@ -1,4 +1,3 @@
-import { unauthenticatedTailorUser } from "@tailor-platform/sdk/test";
 import { createKyselyMock } from "@tailor-platform/sdk/vitest";
 import { describe, expect, test, vi } from "vitest";
 import { getDB, type Namespace } from "../generated/db";
@@ -30,7 +29,8 @@ describe("upsertUsers resolver", () => {
           { name: "Existing", email: "exists@example.com", age: 41 },
         ],
       },
-      user: unauthenticatedTailorUser,
+      caller: null,
+      invoker: null,
       env: { appName: "Resolver Template", version: 1 },
     });
 

package/templates/static-web-site/package.json

@@ -12,11 +12,11 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/sdk": "2.0.0-next.0",
-    "@types/node": "24.13.1",
+    "@tailor-platform/sdk": "2.0.0-next.2",
+    "@types/node": "24.13.2",
     "oxfmt": "0.54.0",
     "oxlint": "1.69.0",
     "oxlint-tsgolint": "0.23.0",
-    "typescript": "5.9.3"
+    "typescript": "6.0.3"
   }
 }

package/templates/tailordb/package.json

@@ -14,12 +14,12 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/sdk": "2.0.0-next.0",
-    "@types/node": "24.13.1",
+    "@tailor-platform/sdk": "2.0.0-next.2",
+    "@types/node": "24.13.2",
     "oxfmt": "0.54.0",
     "oxlint": "1.69.0",
     "oxlint-tsgolint": "0.23.0",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vitest": "4.1.8"
   }
 }

package/templates/tailordb/src/generated/db.ts

@@ -32,7 +32,7 @@ export interface Namespace {
         isInternal: boolean;
       }>;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
 
     Task: {
@@ -46,7 +46,7 @@ export interface Namespace {
       categoryId: string | null;
       isArchived: Generated<boolean>;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
 
     User: {
@@ -56,7 +56,7 @@ export interface Namespace {
       role: "ADMIN" | "MEMBER" | "VIEWER";
       bio: string | null;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
   }
 }

package/templates/workflow/README.md

@@ -7,7 +7,7 @@ Demonstrates workflow patterns with job chaining, trigger testing, and dependenc
 - Workflow with multiple jobs (`createWorkflow`, `createWorkflowJob`)
 - Job chaining via `.trigger()`
 - Database operations in workflow jobs (DI pattern)
-- Integration testing with `workflow.mainJob.trigger()`
+- Integration testing with `runWorkflowLocally()`
 
 ## Getting Started
 

package/templates/workflow/e2e/workflow.test.ts

@@ -1,7 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { describe, expect, test } from "vitest";
 import { startWorkflow } from "@tailor-platform/sdk/cli";
-import config from "../tailor.config";
 import userProfileSyncWorkflow from "../src/workflow/sync-profile";
 
 describe("workflow", () => {
@@ -11,7 +10,7 @@ describe("workflow", () => {
 
     const { executionId, wait } = await startWorkflow({
       workflow: userProfileSyncWorkflow,
-      authInvoker: config.auth.invoker("admin"),
+      invoker: "admin",
       arg: {
         name: "workflow-test-user",
         email: testEmail,

package/templates/workflow/package.json

@@ -15,14 +15,14 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/sdk": "2.0.0-next.0",
-    "@types/node": "24.13.1",
-    "graphql": "16.14.1",
+    "@tailor-platform/sdk": "2.0.0-next.2",
+    "@types/node": "24.13.2",
+    "graphql": "16.14.2",
     "graphql-request": "7.4.0",
     "oxfmt": "0.54.0",
     "oxlint": "1.69.0",
     "oxlint-tsgolint": "0.23.0",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vitest": "4.1.8"
   }
 }

package/templates/workflow/src/generated/db.ts

@@ -19,7 +19,7 @@ export interface Namespace {
       amount: number;
       status: "PENDING" | "PROCESSING" | "COMPLETED" | "FAILED";
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
 
     User: {
@@ -28,7 +28,7 @@ export interface Namespace {
       email: string;
       age: number;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp>;
     }
   }
 }

package/templates/workflow/src/resolver/resolveApproval.test.ts

@@ -1,6 +1,5 @@
 import { describe, expect, test } from "vitest";
 import { mockWorkflow } from "@tailor-platform/sdk/vitest";
-import { unauthenticatedTailorUser } from "@tailor-platform/sdk/test";
 import resolver from "./resolveApproval";
 
 describe("resolveApproval resolver", () => {
@@ -16,7 +15,8 @@ describe("resolveApproval resolver", () => {
 
     const result = await resolver.body({
       input: { executionId: "exec-1", approved: true },
-      user: unauthenticatedTailorUser,
+      caller: null,
+      invoker: null,
       env: {},
     });
 
@@ -33,7 +33,8 @@ describe("resolveApproval resolver", () => {
 
     const result = await resolver.body({
       input: { executionId: "exec-2", approved: false },
-      user: unauthenticatedTailorUser,
+      caller: null,
+      invoker: null,
       env: {},
     });
 

package/templates/workflow/src/workflow/approval.test.ts

@@ -7,7 +7,10 @@ describe("approval workflow", () => {
     using wf = mockWorkflow();
     wf.setWaitHandler((_key, _payload) => ({ approved: true }));
 
-    const result = await processWithApproval.body({ orderId: "order-1" }, { env: {} });
+    const result = await processWithApproval.body(
+      { orderId: "order-1" },
+      { env: {}, invoker: null },
+    );
 
     expect(result).toEqual({ orderId: "order-1", status: "approved" });
     expect(wf.waitCalls).toEqual([
@@ -22,7 +25,10 @@ describe("approval workflow", () => {
     using wf = mockWorkflow();
     wf.setWaitHandler({ approved: false });
 
-    const result = await processWithApproval.body({ orderId: "order-2" }, { env: {} });
+    const result = await processWithApproval.body(
+      { orderId: "order-2" },
+      { env: {}, invoker: null },
+    );
 
     expect(result).toEqual({ orderId: "order-2", status: "rejected" });
   });

package/templates/workflow/src/workflow/order-fulfillment.test.ts

@@ -1,3 +1,4 @@
+import { runWorkflowLocally } from "@tailor-platform/sdk/vitest";
 import { describe, expect, test, vi } from "vitest";
 import workflow, {
   fulfillOrder,
@@ -9,18 +10,24 @@ import workflow, {
 describe("order fulfillment workflow", () => {
   describe("individual job tests with .body()", () => {
     test("validateOrder accepts valid order", () => {
-      const result = validateOrder.body({ orderId: "order-1", amount: 100 }, { env: {} });
+      const result = validateOrder.body(
+        { orderId: "order-1", amount: 100 },
+        { env: {}, invoker: null },
+      );
       expect(result).toEqual({ valid: true, orderId: "order-1" });
     });
 
     test("validateOrder rejects zero amount", () => {
-      expect(() => validateOrder.body({ orderId: "order-1", amount: 0 }, { env: {} })).toThrow(
-        "Order amount must be positive",
-      );
+      expect(() =>
+        validateOrder.body({ orderId: "order-1", amount: 0 }, { env: {}, invoker: null }),
+      ).toThrow("Order amount must be positive");
     });
 
     test("processPayment returns transaction", () => {
-      const result = processPayment.body({ orderId: "order-1", amount: 100 }, { env: {} });
+      const result = processPayment.body(
+        { orderId: "order-1", amount: 100 },
+        { env: {}, invoker: null },
+      );
       expect(result).toEqual({
         transactionId: "txn-order-1",
         amount: 100,
@@ -31,7 +38,7 @@ describe("order fulfillment workflow", () => {
     test("sendConfirmation returns confirmation", () => {
       const result = sendConfirmation.body(
         { orderId: "order-1", transactionId: "txn-1" },
-        { env: {} },
+        { env: {}, invoker: null },
       );
       expect(result).toEqual({
         orderId: "order-1",
@@ -43,22 +50,25 @@ describe("order fulfillment workflow", () => {
 
   describe("orchestration tests with mocked triggers", () => {
     test("fulfillOrder chains all jobs", async () => {
-      using _validateSpy = vi.spyOn(validateOrder, "trigger").mockResolvedValue({
+      using _validateSpy = vi.spyOn(validateOrder, "trigger").mockReturnValue({
         valid: true,
         orderId: "order-1",
       });
-      using _paymentSpy = vi.spyOn(processPayment, "trigger").mockResolvedValue({
+      using _paymentSpy = vi.spyOn(processPayment, "trigger").mockReturnValue({
         transactionId: "txn-order-1",
         amount: 100,
         status: "completed" as const,
       });
-      using _confirmSpy = vi.spyOn(sendConfirmation, "trigger").mockResolvedValue({
+      using _confirmSpy = vi.spyOn(sendConfirmation, "trigger").mockReturnValue({
         orderId: "order-1",
         transactionId: "txn-order-1",
         confirmed: true,
       });
 
-      const result = await fulfillOrder.body({ orderId: "order-1", amount: 100 }, { env: {} });
+      const result = await fulfillOrder.body(
+        { orderId: "order-1", amount: 100 },
+        { env: {}, invoker: null },
+      );
 
       expect(validateOrder.trigger).toHaveBeenCalledWith({
         orderId: "order-1",
@@ -81,22 +91,25 @@ describe("order fulfillment workflow", () => {
     });
 
     test("workflow.mainJob.body() chains all jobs", async () => {
-      using _validateSpy = vi.spyOn(validateOrder, "trigger").mockResolvedValue({
+      using _validateSpy = vi.spyOn(validateOrder, "trigger").mockReturnValue({
         valid: true,
         orderId: "order-2",
       });
-      using _paymentSpy = vi.spyOn(processPayment, "trigger").mockResolvedValue({
+      using _paymentSpy = vi.spyOn(processPayment, "trigger").mockReturnValue({
         transactionId: "txn-order-2",
         amount: 200,
         status: "completed" as const,
       });
-      using _confirmSpy = vi.spyOn(sendConfirmation, "trigger").mockResolvedValue({
+      using _confirmSpy = vi.spyOn(sendConfirmation, "trigger").mockReturnValue({
         orderId: "order-2",
         transactionId: "txn-order-2",
         confirmed: true,
       });
 
-      const result = await workflow.mainJob.body({ orderId: "order-2", amount: 200 }, { env: {} });
+      const result = await workflow.mainJob.body(
+        { orderId: "order-2", amount: 200 },
+        { env: {}, invoker: null },
+      );
 
       expect(result).toEqual({
         orderId: "order-2",
@@ -107,9 +120,9 @@ describe("order fulfillment workflow", () => {
     });
   });
 
-  describe("integration tests with .trigger()", () => {
-    test("workflow.mainJob.trigger() executes all jobs", async () => {
-      const result = await workflow.mainJob.trigger({
+  describe("integration tests with runWorkflowLocally()", () => {
+    test("runWorkflowLocally() executes all jobs", async () => {
+      const result = await runWorkflowLocally(workflow, {
         orderId: "order-3",
         amount: 300,
       });

package/templates/workflow/src/workflow/order-fulfillment.ts

@@ -34,8 +34,8 @@ export const sendConfirmation = createWorkflowJob({
 
 export const fulfillOrder = createWorkflowJob({
   name: "fulfill-order",
-  body: async (input: { orderId: string; amount: number }) => {
-    const validation = await validateOrder.trigger({
+  body: (input: { orderId: string; amount: number }) => {
+    const validation = validateOrder.trigger({
       orderId: input.orderId,
       amount: input.amount,
     });
@@ -44,12 +44,12 @@ export const fulfillOrder = createWorkflowJob({
       throw new Error("Order validation failed");
     }
 
-    const payment = await processPayment.trigger({
+    const payment = processPayment.trigger({
       orderId: input.orderId,
       amount: input.amount,
     });
 
-    const confirmation = await sendConfirmation.trigger({
+    const confirmation = sendConfirmation.trigger({
       orderId: input.orderId,
       transactionId: payment.transactionId,
     });

package/templates/workflow/vitest.config.ts

@@ -20,6 +20,7 @@ export default defineConfig({
           name: { label: "e2e", color: "green" },
           include: ["e2e/**/*.test.ts"],
           globalSetup: "e2e/globalSetup.ts",
+          testTimeout: 60_000,
         },
       },
     ],