@tailor-platform/create-sdk 2.1.0 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,56 @@
 # @tailor-platform/create-sdk
 
+## 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
+
+- [#1975](https://github.com/tailor-platform/sdk/pull/1975) [`b5ca25b`](https://github.com/tailor-platform/sdk/commit/b5ca25b796e8a5e4262ea2e3527973d77cab766a) Thanks [@toiroakr](https://github.com/toiroakr)! - Add `tailor seed fill` to fill in the values a record gets on create for the JSONL seed data rows that are missing them. It fills `id` by default, so rows can reference each other by id, and `--fields` names any other create-time field:
+  
+  ```bash
+  # ./seed/data/Customer.jsonl: {"name":"Acme Corporation"}
+  tailor seed fill
+  # ./seed/data/Customer.jsonl: {"id":"0b6b6f5e-...","name":"Acme Corporation"}
+  
+  # also stamp a creation time on rows that have none
+  tailor seed fill --fields id,createdAt
+  ```
+  
+  The values come from the type itself — its `id`, its field defaults, its create hooks — applied to each row on its own. Nothing is validated, so a row can be filled while a required field is still missing or while another file references an id that does not exist yet; that is the point, since the ids are what you need in order to write the rows that reference them. Run `tailor seed validate` when the data is ready.
+  
+  Only the named fields are written, and only into a row that has no value for them, so a value already in the file is never replaced. A line that gains nothing is left byte for byte as it was; a line that takes a value is written with its keys in the order the type declares its fields, so a filled-in `id` lands at the front. A field the type gives no value to is skipped, so `--fields id` covers a whole data directory and leaves the IdP `_User` data alone, and naming a field the platform assigns — a `serial` field, for instance — fills nothing and says so.
+  
+  `tailor seed apply --upsert` now points at the command when a row has no `id`, since that is the run it blocks, and newly scaffolded projects get a `seed:fill` script next to `seed:validate`.
+  
+  The generated seed schema files now export the type's create hook, which is where the values come from. Run `tailor generate` after upgrading; until then `tailor seed fill` reports which file needs regenerating.
+  
+  `createTailorDBHook` from `@tailor-platform/sdk/test` no longer runs the type's own `validate`. Computing the values a record gets on create and deciding whether a record is acceptable are separate jobs, and the second one now sits where the field-level validation already was: `createStandardSchema` takes the type as a third argument and reports type-level issues through its result.
+  
+  `tailor seed validate` also stops printing two markers on the header of a failed run (`\u2716 \u2717 Found 2 error(s) in ...`), now that it hands the CLI a report that is already formatted.
+  
+  That also fixes how `tailor seed validate` reports them. A type-level `validate` failure used to end the run at the first offending row with a bare message; it now lands in the same report as every other issue, naming the file and every row that fails.
+  
+  A test calling `createTailorDBHook` directly to assert a type-level `validate` throws needs to go through `createStandardSchema` instead.
+  
+  The same operation is available as `fillSeedData` from `@tailor-platform/sdk/seed`.
+
+### Patch Changes
+
+- [#2008](https://github.com/tailor-platform/sdk/pull/2008) [`f2135ab`](https://github.com/tailor-platform/sdk/commit/f2135ab6dd3d130d88803b9829a26024de930ed3) Thanks [@toiroakr](https://github.com/toiroakr)! - Consistently call a TailorDB schema definition a "table" instead of a "type" across the docs, matching the `db.type()` → `db.table()` rename. Also fix three leftover `db.type(...)` code samples in `docs/services/tailordb.md` that should have read `db.table(...)`.
+  
+  Update the `v2/idp-publish-events-rename` codemod registry description to say "tables" instead of "types", matching the same wording fix.
+
 ## 2.1.0
 
 ## 2.0.1

package/README.md

@@ -48,7 +48,7 @@ A complete inventory management system demonstrating real-world patterns.
 
 **Includes:**
 
-- TailorDB types: User, Product, Category, Order, Inventory, Contact, Notification
+- TailorDB tables: User, Product, Category, Order, Inventory, Contact, Notification
 - Role-based permissions (Manager, Staff)
 - Custom resolver for order registration with inventory updates
 - Executor for inventory threshold monitoring

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailor-platform/create-sdk",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "A CLI tool to quickly create a new Tailor Platform SDK project",
   "license": "MIT",
   "repository": {

package/templates/executor/package.json

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

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

@@ -7,6 +7,7 @@
     "generate": "tailor generate",
     "deploy": "tailor deploy",
     "seed": "tailor seed apply",
+    "seed:fill": "tailor seed fill",
     "seed:validate": "tailor seed validate",
     "test": "vitest --project unit",
     "test:unit": "vitest --project unit",
@@ -17,9 +18,9 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@tailor-platform/eslint-plugin-sdk": "0.2.0",
-    "@tailor-platform/sdk": "2.1.0",
-    "@tailor-platform/sdk-plugin-seed": "0.1.1",
+    "@tailor-platform/eslint-plugin-sdk": "0.2.2",
+    "@tailor-platform/sdk": "2.3.0",
+    "@tailor-platform/sdk-plugin-seed": "0.2.1",
     "@types/node": "24.13.3",
     "oxfmt": "0.61.0",
     "oxlint": "1.76.0",

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

@@ -8,10 +8,10 @@ const schemaType = t.object({
   ...category.omitFields(["id"]),
 });
 
-const hook = createTailorDBHook(category);
+export const hook = createTailorDBHook(category);
 
 export const schema = defineSchema(
-  createStandardSchema(schemaType, hook),
+  createStandardSchema(schemaType, hook, category),
   {
     foreignKeys: [
       {"column":"parentCategoryId","references":{"table":"Category","column":"id"}},

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

@@ -8,10 +8,10 @@ const schemaType = t.object({
   ...order.omitFields(["id"]),
 });
 
-const hook = createTailorDBHook(order);
+export const hook = createTailorDBHook(order);
 
 export const schema = defineSchema(
-  createStandardSchema(schemaType, hook),
+  createStandardSchema(schemaType, hook, order),
   {
     foreignKeys: [
       {"column":"productId","references":{"table":"Product","column":"id"}},

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

@@ -8,10 +8,10 @@ const schemaType = t.object({
   ...product.omitFields(["id"]),
 });
 
-const hook = createTailorDBHook(product);
+export const hook = createTailorDBHook(product);
 
 export const schema = defineSchema(
-  createStandardSchema(schemaType, hook),
+  createStandardSchema(schemaType, hook, product),
   {
     foreignKeys: [
       {"column":"categoryId","references":{"table":"Category","column":"id"}},

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

@@ -8,10 +8,10 @@ const schemaType = t.object({
   ...user.omitFields(["id"]),
 });
 
-const hook = createTailorDBHook(user);
+export const hook = createTailorDBHook(user);
 
 export const schema = defineSchema(
-  createStandardSchema(schemaType, hook),
+  createStandardSchema(schemaType, hook, user),
   {
     indexes: [
       {"name":"user_email_unique_idx","columns":["email"],"unique":true},

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.0",
-    "@tailor-platform/sdk": "2.1.0",
+    "@tailor-platform/eslint-plugin-sdk": "0.2.2",
+    "@tailor-platform/sdk": "2.3.0",
     "@types/node": "24.13.3",
     "oxfmt": "0.61.0",
     "oxlint": "1.76.0",

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.0",
-    "@tailor-platform/sdk": "2.1.0",
+    "@tailor-platform/eslint-plugin-sdk": "0.2.2",
+    "@tailor-platform/sdk": "2.3.0",
     "@types/node": "24.13.3",
     "oxfmt": "0.61.0",
     "oxlint": "1.76.0",

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.0",
-    "@tailor-platform/sdk": "2.1.0",
+    "@tailor-platform/eslint-plugin-sdk": "0.2.2",
+    "@tailor-platform/sdk": "2.3.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.0",
-    "@tailor-platform/sdk": "2.1.0",
+    "@tailor-platform/eslint-plugin-sdk": "0.2.2",
+    "@tailor-platform/sdk": "2.3.0",
     "@types/node": "24.13.3",
     "oxfmt": "0.61.0",
     "oxlint": "1.76.0",

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.0",
-    "@tailor-platform/sdk": "2.1.0",
+    "@tailor-platform/eslint-plugin-sdk": "0.2.2",
+    "@tailor-platform/sdk": "2.3.0",
     "@types/node": "24.13.3",
     "oxfmt": "0.61.0",
     "oxlint": "1.76.0",

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

@@ -1,6 +1,6 @@
 # TailorDB Template
 
-Comprehensive TailorDB type definitions demonstrating all features of `db.table()`.
+Comprehensive TailorDB table definitions demonstrating all features of `db.table()`.
 
 ## Features
 

package/templates/tailordb/package.json

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

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.0",
-    "@tailor-platform/sdk": "2.1.0",
+    "@tailor-platform/eslint-plugin-sdk": "0.2.2",
+    "@tailor-platform/sdk": "2.3.0",
     "@types/node": "24.13.3",
     "graphql": "17.0.2",
     "graphql-request": "7.4.0",

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"],
         },
       },
       {