@tailor-platform/create-sdk 2.2.0 → 2.4.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @tailor-platform/create-sdk
 
+## 2.4.0
+
+### Patch Changes
+
+- [#2069](https://github.com/tailor-platform/sdk/pull/2069) [`d07a120`](https://github.com/tailor-platform/sdk/commit/d07a120950c5bac0bd8b5d2e341ad80dd6694448) Thanks [@dqn](https://github.com/dqn)! - The remaining published docs that named a `db.table()` definition a type now say table: the migration guide's rebaseline description, the testing guide's executor trigger description, and the create-sdk `tailordb` template README's feature list (`field-level and table-level` validations).
+
+- [#2062](https://github.com/tailor-platform/sdk/pull/2062) [`153a780`](https://github.com/tailor-platform/sdk/commit/153a78038c65f4376f2f9f75eec8a7a37ea3f6dc) Thanks [@dqn](https://github.com/dqn)! - `tailor seed` now calls a `db.table()` definition a table instead of a type, in its help, progress, and errors — `Seeding 3 tables via Kysely batch insert`. The `fillSeedData` documentation and the `create-sdk` template hint follow.
+  
+  Messages that list the seed targets say entities rather than tables, because `_User` is an IdP entity rather than a TailorDB table and can appear in the same list.
+  
+  The positional is now named `entities`, so `--help` shows `[entities]` instead of `[types]`. Positionals are matched by argv order, so existing invocations are unaffected.
+
+- [#2063](https://github.com/tailor-platform/sdk/pull/2063) [`5d16dc9`](https://github.com/tailor-platform/sdk/commit/5d16dc918f77bd4c76d0d90811207ec15ac30f4e) Thanks [@dqn](https://github.com/dqn)! - The remaining docs and editor tooltips now describe a `db.table()` definition as a table instead of a type. The TailorDB docs say table-level (matching the sentences around them that already say table), the file-upload runtime API documents its `typeName` parameters as table names, and the create-sdk tailordb template's test titles follow suit.
+
+## 2.3.0
+
+### Patch Changes
+
+- [#2025](https://github.com/tailor-platform/sdk/pull/2025) [`2574bdd`](https://github.com/tailor-platform/sdk/commit/2574bdd69947b0f6e050c3c0af224fc3f18c6435) Thanks [@dqn](https://github.com/dqn)! - Template Vitest configs now collect migration script tests (`migrations/**/*.test.ts`) scaffolded by `tailordb migration script --with-test`.
+
+- [#2023](https://github.com/tailor-platform/sdk/pull/2023) [`9dc826f`](https://github.com/tailor-platform/sdk/commit/9dc826fc0a83aa926de5b07245513f67c1ace877) Thanks [@dqn](https://github.com/dqn)! - Guide users through the v2 type-only import requirement. The CLI loads TypeScript by stripping types from each file in isolation, so a plain import of a type-only export fails at load time with `SyntaxError: ... does not provide an export named '<name>'` and no indication that the import form is the cause.
+  
+  - The CLI now appends a suggestion to that error: import the name with `import type` and set `"verbatimModuleSyntax": true` in tsconfig.json to catch violations at typecheck.
+  - Projects scaffolded by `tailor init` now enable `verbatimModuleSyntax` in their tsconfig.json, so new projects catch violations at typecheck instead of at load time.
+  - The v2 migration guide gains a `v2/type-only-imports` entry documenting the requirement, the failure mode, and the migration steps, offered by `tailor upgrade` when crossing the v2 boundary.
+
 ## 2.2.0
 
 ### Minor Changes

package/dist/index.js

@@ -18,7 +18,7 @@ const templateHints = {
 	"hello-world": "Initial project to get started with Tailor Platform SDK",
 	"inventory-management": "Simple inventory management system",
 	"multi-application": "Multi-application setup with shared databases",
-	tailordb: "Comprehensive TailorDB type definitions with all features",
+	tailordb: "Comprehensive TailorDB table definitions with all features",
 	resolver: "Resolver patterns with testing (simple, DB, env, user)",
 	workflow: "Workflow patterns with job chaining and testing",
 	executor: "Executor trigger types (record, resolver, schedule, webhook)",
@@ -63,12 +63,13 @@ const collectContext = async ({ name, template }) => {
 		name = ret;
 	} else log.info(`📦 Project: ${name}`);
 	if (!template) {
+		const options = (await availableTemplates()).map((value) => ({
+			value,
+			hint: templateHints[value]
+		}));
 		const ret = await select({
 			message: "🎨 Choose your template",
-			options: (await availableTemplates()).map((value) => ({
-				value,
-				hint: templateHints[value]
-			}))
+			options
 		});
 		if (isCancel(ret)) {
 			cancel("Operation cancelled");
@@ -154,7 +155,7 @@ const initProject = async () => {
 //#region src/index.ts
 const main = async () => {
 	const packageJson = await readPackageJSON(import.meta.url);
-	await runMain(defineCommand({
+	const cmd = defineCommand({
 		name: packageJson.name ?? "create-sdk",
 		description: packageJson.description,
 		args: z.object({
@@ -179,7 +180,8 @@ const main = async () => {
 
 ` + pc.dim("Learn more: https://docs.tailor.tech"));
 		}
-	}), { version: packageJson.version });
+	});
+	await runMain(cmd, { version: packageJson.version });
 };
 await main();
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailor-platform/create-sdk",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "A CLI tool to quickly create a new Tailor Platform SDK project",
   "license": "MIT",
   "repository": {
@@ -26,7 +26,7 @@
   },
   "devDependencies": {
     "@types/node": "24.13.3",
-    "eslint-plugin-zod": "4.9.0",
+    "eslint-plugin-zod": "4.9.1",
     "oxlint": "1.76.0",
     "oxlint-tsgolint": "7.0.2001",
     "tsdown": "0.22.14",

package/templates/executor/package.json

@@ -15,8 +15,8 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/eslint-plugin-sdk": "0.2.1",
-    "@tailor-platform/sdk": "2.2.0",
+    "@tailor-platform/eslint-plugin-sdk": "0.2.2",
+    "@tailor-platform/sdk": "2.4.0",
     "@types/node": "24.13.3",
     "oxfmt": "0.61.0",
     "oxlint": "1.76.0",

package/templates/executor/tailor.d.ts

@@ -18,6 +18,9 @@ declare module "@tailor-platform/sdk" {
   }
   interface ConnectionNameRegistry {}
   interface AIGatewayNameRegistry {}
+  interface AuthNamespaceNameRegistry {
+    "main-auth": true;
+  }
 }
 
 export {};

package/templates/executor/tsconfig.json

@@ -7,6 +7,7 @@
     "esModuleInterop": true,
     "allowJs": true,
     "strict": true,
+    "verbatimModuleSyntax": true,
     "noEmit": true,
     "skipLibCheck": true,
     "resolveJsonModule": true,

package/templates/executor/vitest.config.ts

@@ -11,7 +11,7 @@ export default defineConfig({
         test: {
           name: { label: "unit", color: "blue" },
           environment: "tailor-runtime",
-          include: ["src/**/*.test.ts"],
+          include: ["src/**/*.test.ts", "migrations/**/*.test.ts"],
         },
       },
     ],

package/templates/generators/package.json

@@ -18,9 +18,9 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/eslint-plugin-sdk": "0.2.1",
-    "@tailor-platform/sdk": "2.2.0",
-    "@tailor-platform/sdk-plugin-seed": "0.2.0",
+    "@tailor-platform/eslint-plugin-sdk": "0.2.2",
+    "@tailor-platform/sdk": "2.4.0",
+    "@tailor-platform/sdk-plugin-seed": "0.2.2",
     "@types/node": "24.13.3",
     "oxfmt": "0.61.0",
     "oxlint": "1.76.0",

package/templates/generators/tailor.d.ts

@@ -18,6 +18,9 @@ declare module "@tailor-platform/sdk" {
   }
   interface ConnectionNameRegistry {}
   interface AIGatewayNameRegistry {}
+  interface AuthNamespaceNameRegistry {
+    "main-auth": true;
+  }
 }
 
 export {};

package/templates/generators/tsconfig.json

@@ -7,6 +7,7 @@
     "esModuleInterop": true,
     "allowJs": true,
     "strict": true,
+    "verbatimModuleSyntax": true,
     "noEmit": true,
     "skipLibCheck": true,
     "resolveJsonModule": true,

package/templates/generators/vitest.config.ts

@@ -11,7 +11,7 @@ export default defineConfig({
         test: {
           name: { label: "unit", color: "blue" },
           environment: "tailor-runtime",
-          include: ["src/**/*.test.ts"],
+          include: ["src/**/*.test.ts", "migrations/**/*.test.ts"],
         },
       },
     ],

package/templates/hello-world/package.json

@@ -13,8 +13,8 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/eslint-plugin-sdk": "0.2.1",
-    "@tailor-platform/sdk": "2.2.0",
+    "@tailor-platform/eslint-plugin-sdk": "0.2.2",
+    "@tailor-platform/sdk": "2.4.0",
     "@types/node": "24.13.3",
     "oxfmt": "0.61.0",
     "oxlint": "1.76.0",

package/templates/hello-world/tailor.d.ts

@@ -12,6 +12,7 @@ declare module "@tailor-platform/sdk" {
   interface IdpNameRegistry {}
   interface ConnectionNameRegistry {}
   interface AIGatewayNameRegistry {}
+  interface AuthNamespaceNameRegistry {}
 }
 
 export {};

package/templates/hello-world/tsconfig.json

@@ -7,6 +7,7 @@
     "esModuleInterop": true,
     "allowJs": true,
     "strict": true,
+    "verbatimModuleSyntax": true,
     "noEmit": true,
     "skipLibCheck": true,
     "resolveJsonModule": true,

package/templates/inventory-management/package.json

@@ -13,8 +13,8 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/eslint-plugin-sdk": "0.2.1",
-    "@tailor-platform/sdk": "2.2.0",
+    "@tailor-platform/eslint-plugin-sdk": "0.2.2",
+    "@tailor-platform/sdk": "2.4.0",
     "@types/node": "24.13.3",
     "oxfmt": "0.61.0",
     "oxlint": "1.76.0",

package/templates/inventory-management/tailor.d.ts

@@ -17,6 +17,9 @@ declare module "@tailor-platform/sdk" {
   interface IdpNameRegistry {}
   interface ConnectionNameRegistry {}
   interface AIGatewayNameRegistry {}
+  interface AuthNamespaceNameRegistry {
+    "main-auth": true;
+  }
 }
 
 export {};

package/templates/inventory-management/tsconfig.json

@@ -7,6 +7,7 @@
     "esModuleInterop": true,
     "allowJs": true,
     "strict": true,
+    "verbatimModuleSyntax": true,
     "noEmit": true,
     "skipLibCheck": true,
     "resolveJsonModule": true,

package/templates/multi-application/package.json

@@ -14,8 +14,8 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/eslint-plugin-sdk": "0.2.1",
-    "@tailor-platform/sdk": "2.2.0",
+    "@tailor-platform/eslint-plugin-sdk": "0.2.2",
+    "@tailor-platform/sdk": "2.4.0",
     "@types/node": "24.13.3",
     "oxfmt": "0.61.0",
     "oxlint": "1.76.0",

package/templates/multi-application/tsconfig.json

@@ -7,6 +7,7 @@
     "esModuleInterop": true,
     "allowJs": true,
     "strict": true,
+    "verbatimModuleSyntax": true,
     "noEmit": true,
     "skipLibCheck": true,
     "resolveJsonModule": true,

package/templates/resolver/package.json

@@ -15,8 +15,8 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/eslint-plugin-sdk": "0.2.1",
-    "@tailor-platform/sdk": "2.2.0",
+    "@tailor-platform/eslint-plugin-sdk": "0.2.2",
+    "@tailor-platform/sdk": "2.4.0",
     "@types/node": "24.13.3",
     "oxfmt": "0.61.0",
     "oxlint": "1.76.0",

package/templates/resolver/tailor.d.ts

@@ -19,6 +19,9 @@ declare module "@tailor-platform/sdk" {
   interface IdpNameRegistry {}
   interface ConnectionNameRegistry {}
   interface AIGatewayNameRegistry {}
+  interface AuthNamespaceNameRegistry {
+    "main-auth": true;
+  }
 }
 
 export {};

package/templates/resolver/tsconfig.json

@@ -7,6 +7,7 @@
     "esModuleInterop": true,
     "allowJs": true,
     "strict": true,
+    "verbatimModuleSyntax": true,
     "noEmit": true,
     "skipLibCheck": true,
     "resolveJsonModule": true,

package/templates/resolver/vitest.config.ts

@@ -11,7 +11,7 @@ export default defineConfig({
         test: {
           name: { label: "unit", color: "blue" },
           environment: "tailor-runtime",
-          include: ["src/**/*.test.ts"],
+          include: ["src/**/*.test.ts", "migrations/**/*.test.ts"],
         },
       },
     ],

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

@@ -13,8 +13,8 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/eslint-plugin-sdk": "0.2.1",
-    "@tailor-platform/sdk": "2.2.0",
+    "@tailor-platform/eslint-plugin-sdk": "0.2.2",
+    "@tailor-platform/sdk": "2.4.0",
     "@types/node": "24.13.3",
     "oxfmt": "0.61.0",
     "oxlint": "1.76.0",

package/templates/static-web-site/tailor.d.ts

@@ -18,6 +18,9 @@ declare module "@tailor-platform/sdk" {
   }
   interface ConnectionNameRegistry {}
   interface AIGatewayNameRegistry {}
+  interface AuthNamespaceNameRegistry {
+    "my-auth": true;
+  }
 }
 
 export {};

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

@@ -7,6 +7,7 @@
     "esModuleInterop": true,
     "allowJs": true,
     "strict": true,
+    "verbatimModuleSyntax": true,
     "noEmit": true,
     "skipLibCheck": true,
     "resolveJsonModule": true,

package/templates/tailordb/README.md

@@ -6,7 +6,7 @@ Comprehensive TailorDB table definitions demonstrating all features of `db.table
 
 - All field types (string, int, float, datetime, uuid, enum, boolean)
 - Relations (n-1, self-referential)
-- Validations (field-level and type-level)
+- Validations (field-level and table-level)
 - Hooks (computed fields)
 - File attachments
 - Composite indexes

package/templates/tailordb/package.json

@@ -15,8 +15,8 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/eslint-plugin-sdk": "0.2.1",
-    "@tailor-platform/sdk": "2.2.0",
+    "@tailor-platform/eslint-plugin-sdk": "0.2.2",
+    "@tailor-platform/sdk": "2.4.0",
     "@types/node": "24.13.3",
     "oxfmt": "0.61.0",
     "oxlint": "1.76.0",

package/templates/tailordb/src/db/task.test.ts

@@ -4,8 +4,8 @@ import { user } from "./user";
 import { category } from "./category";
 import { comment } from "./comment";
 
-describe("TailorDB type definitions", () => {
-  test("task type has expected fields", () => {
+describe("TailorDB table definitions", () => {
+  test("task table has expected fields", () => {
     const { fields } = task;
     expect(fields).toHaveProperty("title");
     expect(fields).toHaveProperty("status");
@@ -16,7 +16,7 @@ describe("TailorDB type definitions", () => {
     expect(fields).toHaveProperty("isArchived");
   });
 
-  test("user type has expected fields", () => {
+  test("user table has expected fields", () => {
     const { fields } = user;
     expect(fields).toHaveProperty("name");
     expect(fields).toHaveProperty("email");
@@ -24,14 +24,14 @@ describe("TailorDB type definitions", () => {
     expect(fields).toHaveProperty("bio");
   });
 
-  test("category type has expected fields", () => {
+  test("category table has expected fields", () => {
     const { fields } = category;
     expect(fields).toHaveProperty("name");
     expect(fields).toHaveProperty("description");
     expect(fields).toHaveProperty("parentCategoryId");
   });
 
-  test("comment type has expected fields", () => {
+  test("comment table has expected fields", () => {
     const { fields } = comment;
     expect(fields).toHaveProperty("body");
     expect(fields).toHaveProperty("taskId");

package/templates/tailordb/tailor.d.ts

@@ -17,6 +17,9 @@ declare module "@tailor-platform/sdk" {
   interface IdpNameRegistry {}
   interface ConnectionNameRegistry {}
   interface AIGatewayNameRegistry {}
+  interface AuthNamespaceNameRegistry {
+    "main-auth": true;
+  }
 }
 
 export {};

package/templates/tailordb/tsconfig.json

@@ -7,6 +7,7 @@
     "esModuleInterop": true,
     "allowJs": true,
     "strict": true,
+    "verbatimModuleSyntax": true,
     "noEmit": true,
     "skipLibCheck": true,
     "resolveJsonModule": true,

package/templates/tailordb/vitest.config.ts

@@ -11,7 +11,7 @@ export default defineConfig({
         test: {
           name: { label: "unit", color: "blue" },
           environment: "tailor-runtime",
-          include: ["src/**/*.test.ts"],
+          include: ["src/**/*.test.ts", "migrations/**/*.test.ts"],
         },
       },
     ],

package/templates/workflow/package.json

@@ -16,8 +16,8 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/eslint-plugin-sdk": "0.2.1",
-    "@tailor-platform/sdk": "2.2.0",
+    "@tailor-platform/eslint-plugin-sdk": "0.2.2",
+    "@tailor-platform/sdk": "2.4.0",
     "@types/node": "24.13.3",
     "graphql": "17.0.2",
     "graphql-request": "7.4.0",

package/templates/workflow/tailor.d.ts

@@ -16,6 +16,9 @@ declare module "@tailor-platform/sdk" {
   interface IdpNameRegistry {}
   interface ConnectionNameRegistry {}
   interface AIGatewayNameRegistry {}
+  interface AuthNamespaceNameRegistry {
+    "main-auth": true;
+  }
 }
 
 export {};

package/templates/workflow/tsconfig.json

@@ -7,6 +7,7 @@
     "esModuleInterop": true,
     "allowJs": true,
     "strict": true,
+    "verbatimModuleSyntax": true,
     "noEmit": true,
     "skipLibCheck": true,
     "resolveJsonModule": true,

package/templates/workflow/vitest.config.ts

@@ -11,7 +11,7 @@ export default defineConfig({
         test: {
           name: { label: "unit", color: "blue" },
           environment: "tailor-runtime",
-          include: ["src/**/*.test.ts"],
+          include: ["src/**/*.test.ts", "migrations/**/*.test.ts"],
         },
       },
       {