@tailor-platform/sdk 1.2.6 → 1.4.0

package/dist/utils/test/index.mjs

@@ -13,8 +13,8 @@ const unauthenticatedTailorUser = {
 * - Recursively processes nested types
 * - Executes hooks.create for fields with create hooks
 * @template T - The output type of the hook function
-* @param {TailorDBType<unknown, unknown>} type - TailorDB type definition
-* @returns {(data: unknown) => Partial<output<T>>} A function that transforms input data according to field hooks
+* @param type - TailorDB type definition
+* @returns A function that transforms input data according to field hooks
 */
 function createTailorDBHook(type) {
 	return (data) => {
@@ -38,9 +38,9 @@ function createTailorDBHook(type) {
 * Creates the standard schema definition for lines-db
 * This returns the first argument for defineSchema with the ~standard section
 * @template T - The output type after validation
-* @param {TailorField<unknown, T>} schemaType - TailorDB field schema for validation
-* @param {(data: unknown) => Partial<T>} hook - Hook function to transform data before validation
-* @returns {{ "~standard": StandardSchemaV1<T>["~standard"] }} Schema object with ~standard section for defineSchema
+* @param schemaType - TailorDB field schema for validation
+* @param hook - Hook function to transform data before validation
+* @returns Schema object with ~standard section for defineSchema
 */
 function createStandardSchema(schemaType, hook) {
 	return { "~standard": {

package/dist/utils/test/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/utils/test/index.ts"],"sourcesContent":["import type { output, TailorUser } from \"@/configure\";\nimport type { TailorDBType } from \"@/configure/services/tailordb/schema\";\nimport type { TailorField } from \"@/configure/types/type\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/** Represents an unauthenticated user in the Tailor platform. */\nexport const unauthenticatedTailorUser = {\n  id: \"00000000-0000-0000-0000-000000000000\",\n  type: \"\",\n  workspaceId: \"00000000-0000-0000-0000-000000000000\",\n  attributes: null,\n  attributeList: [],\n} as const satisfies TailorUser;\n\n/**\n * Creates a hook function that processes TailorDB type fields\n * - Uses existing id from data if provided, otherwise generates UUID for id fields\n * - Recursively processes nested types\n * - Executes hooks.create for fields with create hooks\n * @template T - The output type of the hook function\n * @param {TailorDBType<unknown, unknown>} type - TailorDB type definition\n * @returns {(data: unknown) => Partial<output<T>>} A function that transforms input data according to field hooks\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function createTailorDBHook<T extends TailorDBType<any, any>>(type: T) {\n  return (data: unknown) => {\n    return Object.entries(type.fields).reduce(\n      (hooked, [key, value]) => {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const field = value as TailorField<any, any, any>;\n        if (key === \"id\") {\n          // Use existing id from data if provided, otherwise generate new UUID\n          const existingId =\n            data && typeof data === \"object\" ? (data as Record<string, unknown>)[key] : undefined;\n          hooked[key] = existingId ?? crypto.randomUUID();\n        } else if (field.type === \"nested\") {\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          hooked[key] = createTailorDBHook({ fields: field.fields } as any)(\n            (data as Record<string, unknown>)[key],\n          );\n        } else if (field.metadata.hooks?.create) {\n          hooked[key] = field.metadata.hooks.create({\n            value: (data as Record<string, unknown>)[key],\n            data: data,\n            user: unauthenticatedTailorUser,\n          });\n          if (hooked[key] instanceof Date) {\n            hooked[key] = hooked[key].toISOString();\n          }\n        } else if (data && typeof data === \"object\") {\n          hooked[key] = (data as Record<string, unknown>)[key];\n        }\n        return hooked;\n      },\n      {} as Record<string, unknown>,\n    ) as Partial<output<T>>;\n  };\n}\n\n/**\n * Creates the standard schema definition for lines-db\n * This returns the first argument for defineSchema with the ~standard section\n * @template T - The output type after validation\n * @param {TailorField<unknown, T>} schemaType - TailorDB field schema for validation\n * @param {(data: unknown) => Partial<T>} hook - Hook function to transform data before validation\n * @returns {{ \"~standard\": StandardSchemaV1<T>[\"~standard\"] }} Schema object with ~standard section for defineSchema\n */\nexport function createStandardSchema<T = Record<string, unknown>>(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  schemaType: TailorField<any, T>,\n  hook: (data: unknown) => Partial<T>,\n) {\n  return {\n    \"~standard\": {\n      version: 1,\n      vendor: \"@tailor-platform/sdk\",\n      validate: (value: unknown) => {\n        const hooked = hook(value);\n        const result = schemaType.parse({\n          value: hooked,\n          data: hooked,\n          user: unauthenticatedTailorUser,\n        });\n        if (result.issues) {\n          return result;\n        }\n        return { value: hooked as T };\n      },\n    },\n  } as const satisfies StandardSchemaV1<T>;\n}\n"],"mappings":";;AAMA,MAAa,4BAA4B;CACvC,IAAI;CACJ,MAAM;CACN,aAAa;CACb,YAAY;CACZ,eAAe,EAAE;CAClB;;;;;;;;;;AAYD,SAAgB,mBAAqD,MAAS;AAC5E,SAAQ,SAAkB;AACxB,SAAO,OAAO,QAAQ,KAAK,OAAO,CAAC,QAChC,QAAQ,CAAC,KAAK,WAAW;GAExB,MAAM,QAAQ;AACd,OAAI,QAAQ,KAIV,QAAO,QADL,QAAQ,OAAO,SAAS,WAAY,KAAiC,OAAO,WAClD,OAAO,YAAY;YACtC,MAAM,SAAS,SAExB,QAAO,OAAO,mBAAmB,EAAE,QAAQ,MAAM,QAAQ,CAAQ,CAC9D,KAAiC,KACnC;YACQ,MAAM,SAAS,OAAO,QAAQ;AACvC,WAAO,OAAO,MAAM,SAAS,MAAM,OAAO;KACxC,OAAQ,KAAiC;KACnC;KACN,MAAM;KACP,CAAC;AACF,QAAI,OAAO,gBAAgB,KACzB,QAAO,OAAO,OAAO,KAAK,aAAa;cAEhC,QAAQ,OAAO,SAAS,SACjC,QAAO,OAAQ,KAAiC;AAElD,UAAO;KAET,EAAE,CACH;;;;;;;;;;;AAYL,SAAgB,qBAEd,YACA,MACA;AACA,QAAO,EACL,aAAa;EACX,SAAS;EACT,QAAQ;EACR,WAAW,UAAmB;GAC5B,MAAM,SAAS,KAAK,MAAM;GAC1B,MAAM,SAAS,WAAW,MAAM;IAC9B,OAAO;IACP,MAAM;IACN,MAAM;IACP,CAAC;AACF,OAAI,OAAO,OACT,QAAO;AAET,UAAO,EAAE,OAAO,QAAa;;EAEhC,EACF"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/utils/test/index.ts"],"sourcesContent":["import type { output, TailorUser } from \"@/configure\";\nimport type { TailorDBType } from \"@/configure/services/tailordb/schema\";\nimport type { TailorField } from \"@/configure/types/type\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/** Represents an unauthenticated user in the Tailor platform. */\nexport const unauthenticatedTailorUser = {\n  id: \"00000000-0000-0000-0000-000000000000\",\n  type: \"\",\n  workspaceId: \"00000000-0000-0000-0000-000000000000\",\n  attributes: null,\n  attributeList: [],\n} as const satisfies TailorUser;\n\n/**\n * Creates a hook function that processes TailorDB type fields\n * - Uses existing id from data if provided, otherwise generates UUID for id fields\n * - Recursively processes nested types\n * - Executes hooks.create for fields with create hooks\n * @template T - The output type of the hook function\n * @param type - TailorDB type definition\n * @returns A function that transforms input data according to field hooks\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function createTailorDBHook<T extends TailorDBType<any, any>>(type: T) {\n  return (data: unknown) => {\n    return Object.entries(type.fields).reduce(\n      (hooked, [key, value]) => {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const field = value as TailorField<any, any, any>;\n        if (key === \"id\") {\n          // Use existing id from data if provided, otherwise generate new UUID\n          const existingId =\n            data && typeof data === \"object\" ? (data as Record<string, unknown>)[key] : undefined;\n          hooked[key] = existingId ?? crypto.randomUUID();\n        } else if (field.type === \"nested\") {\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          hooked[key] = createTailorDBHook({ fields: field.fields } as any)(\n            (data as Record<string, unknown>)[key],\n          );\n        } else if (field.metadata.hooks?.create) {\n          hooked[key] = field.metadata.hooks.create({\n            value: (data as Record<string, unknown>)[key],\n            data: data,\n            user: unauthenticatedTailorUser,\n          });\n          if (hooked[key] instanceof Date) {\n            hooked[key] = hooked[key].toISOString();\n          }\n        } else if (data && typeof data === \"object\") {\n          hooked[key] = (data as Record<string, unknown>)[key];\n        }\n        return hooked;\n      },\n      {} as Record<string, unknown>,\n    ) as Partial<output<T>>;\n  };\n}\n\n/**\n * Creates the standard schema definition for lines-db\n * This returns the first argument for defineSchema with the ~standard section\n * @template T - The output type after validation\n * @param schemaType - TailorDB field schema for validation\n * @param hook - Hook function to transform data before validation\n * @returns Schema object with ~standard section for defineSchema\n */\nexport function createStandardSchema<T = Record<string, unknown>>(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  schemaType: TailorField<any, T>,\n  hook: (data: unknown) => Partial<T>,\n) {\n  return {\n    \"~standard\": {\n      version: 1,\n      vendor: \"@tailor-platform/sdk\",\n      validate: (value: unknown) => {\n        const hooked = hook(value);\n        const result = schemaType.parse({\n          value: hooked,\n          data: hooked,\n          user: unauthenticatedTailorUser,\n        });\n        if (result.issues) {\n          return result;\n        }\n        return { value: hooked as T };\n      },\n    },\n  } as const satisfies StandardSchemaV1<T>;\n}\n"],"mappings":";;AAMA,MAAa,4BAA4B;CACvC,IAAI;CACJ,MAAM;CACN,aAAa;CACb,YAAY;CACZ,eAAe,EAAE;CAClB;;;;;;;;;;AAYD,SAAgB,mBAAqD,MAAS;AAC5E,SAAQ,SAAkB;AACxB,SAAO,OAAO,QAAQ,KAAK,OAAO,CAAC,QAChC,QAAQ,CAAC,KAAK,WAAW;GAExB,MAAM,QAAQ;AACd,OAAI,QAAQ,KAIV,QAAO,QADL,QAAQ,OAAO,SAAS,WAAY,KAAiC,OAAO,WAClD,OAAO,YAAY;YACtC,MAAM,SAAS,SAExB,QAAO,OAAO,mBAAmB,EAAE,QAAQ,MAAM,QAAQ,CAAQ,CAC9D,KAAiC,KACnC;YACQ,MAAM,SAAS,OAAO,QAAQ;AACvC,WAAO,OAAO,MAAM,SAAS,MAAM,OAAO;KACxC,OAAQ,KAAiC;KACnC;KACN,MAAM;KACP,CAAC;AACF,QAAI,OAAO,gBAAgB,KACzB,QAAO,OAAO,OAAO,KAAK,aAAa;cAEhC,QAAQ,OAAO,SAAS,SACjC,QAAO,OAAQ,KAAiC;AAElD,UAAO;KAET,EAAE,CACH;;;;;;;;;;;AAYL,SAAgB,qBAEd,YACA,MACA;AACA,QAAO,EACL,aAAa;EACX,SAAS;EACT,QAAQ;EACR,WAAW,UAAmB;GAC5B,MAAM,SAAS,KAAK,MAAM;GAC1B,MAAM,SAAS,WAAW,MAAM;IAC9B,OAAO;IACP,MAAM;IACN,MAAM;IACP,CAAC;AACF,OAAI,OAAO,OACT,QAAO;AAET,UAAO,EAAE,OAAO,QAAa;;EAEhC,EACF"}

package/docs/cli/application.md

@@ -134,3 +134,132 @@ tailor-sdk tailordb truncate User Post --yes
   - `--namespace`: requires typing `truncate <namespace-name>`
   - Specific types: requires typing `yes`
 - Use `--yes` flag to skip confirmation prompts (useful for scripts and CI/CD)
+
+### tailordb erd (beta)
+
+Generate ERD artifacts for TailorDB namespaces using [Liam ERD](https://liambx.com/erd).
+
+```bash
+tailor-sdk tailordb erd <subcommand> [options]
+```
+
+**Notes:**
+
+- This command is a beta feature and may introduce breaking changes in future releases
+- `@liam-hq/cli` is required for `export`, `serve`, and `deploy`
+- `serve` is required only for `tailordb erd serve`
+
+Install dependencies:
+
+```bash
+npm i -D @liam-hq/cli serve
+# OR
+yarn add -D @liam-hq/cli serve
+# OR
+pnpm add -D @liam-hq/cli serve
+```
+
+#### tailordb erd export
+
+Export Liam ERD dist from applied TailorDB schema.
+
+```bash
+tailor-sdk tailordb erd export [options]
+```
+
+**Options:**
+
+- `-n, --namespace` - TailorDB namespace name (optional - exports all namespaces with erdSite if omitted)
+- `-o, --output` - Output directory path for tbls-compatible ERD JSON (writes to `<outputDir>/<namespace>/schema.json`) (default: `.tailor-sdk/erd`)
+- `-j, --json` - Output as JSON
+- `-w, --workspace-id` - ID of the workspace
+- `-p, --profile` - Workspace profile to use
+- `-c, --config` - Path to the SDK config file (default: `tailor.config.ts`)
+- `-e, --env-file` - Path to the environment file
+
+**Usage Examples:**
+
+```bash
+# Export ERD for all namespaces with erdSite configured
+tailor-sdk tailordb erd export
+
+# Export ERD for a specific namespace
+tailor-sdk tailordb erd export --namespace myNamespace
+
+# Export ERD with custom output directory
+tailor-sdk tailordb erd export --output ./my-erd
+
+# Export ERD with JSON output
+tailor-sdk tailordb erd export --json
+```
+
+#### tailordb erd serve
+
+Generate and serve ERD locally (liam build + `serve dist`).
+
+```bash
+tailor-sdk tailordb erd serve [options]
+```
+
+**Options:**
+
+- `-n, --namespace` - TailorDB namespace name (uses first namespace with erdSite if not specified)
+- `-w, --workspace-id` - ID of the workspace
+- `-p, --profile` - Workspace profile to use
+- `-c, --config` - Path to the SDK config file (default: `tailor.config.ts`)
+- `-e, --env-file` - Path to the environment file
+
+**Usage Examples:**
+
+```bash
+# Serve ERD for the first namespace with erdSite configured
+tailor-sdk tailordb erd serve
+
+# Serve ERD for a specific namespace
+tailor-sdk tailordb erd serve --namespace myNamespace
+```
+
+#### tailordb erd deploy
+
+Deploy ERD static website for TailorDB namespace(s).
+
+```bash
+tailor-sdk tailordb erd deploy [options]
+```
+
+**Options:**
+
+- `-n, --namespace` - TailorDB namespace name (optional - deploys all namespaces with erdSite if omitted)
+- `-j, --json` - Output as JSON
+- `-w, --workspace-id` - ID of the workspace
+- `-p, --profile` - Workspace profile to use
+- `-c, --config` - Path to the SDK config file (default: `tailor.config.ts`)
+- `-e, --env-file` - Path to the environment file
+
+**Usage Examples:**
+
+```bash
+# Deploy ERD for all namespaces with erdSite configured
+tailor-sdk tailordb erd deploy
+
+# Deploy ERD for a specific namespace
+tailor-sdk tailordb erd deploy --namespace myNamespace
+
+# Deploy ERD with JSON output
+tailor-sdk tailordb erd deploy --json
+```
+
+**Notes:**
+
+- Requires `erdSite` to be configured in `tailor.config.ts` for each namespace you want to deploy
+- Example config:
+  ```typescript
+  export default defineConfig({
+    db: {
+      myNamespace: {
+        // ... table definitions
+        erdSite: "my-erd-site-name",
+      },
+    },
+  });
+  ```

package/docs/cli-reference.md

@@ -12,15 +12,32 @@ tailor-sdk <command> [options]
 
 The following options are available for most commands:
 
-| Option           | Short | Description                                         |
-| ---------------- | ----- | --------------------------------------------------- |
-| `--env-file`     | `-e`  | Specify a custom environment file path              |
-| `--verbose`      |       | Enable verbose logging (show stack traces on error) |
-| `--json`         | `-j`  | Output as JSON (where applicable)                   |
-| `--workspace-id` | `-w`  | Workspace ID (for deployment commands)              |
-| `--profile`      | `-p`  | Workspace profile                                   |
-| `--config`       | `-c`  | Path to SDK config file                             |
-| `--yes`          | `-y`  | Skip confirmation prompts                           |
+| Option                 | Short | Description                                         |
+| ---------------------- | ----- | --------------------------------------------------- |
+| `--env-file`           | `-e`  | Path to environment file (error if not found)       |
+| `--env-file-if-exists` |       | Path to environment file (ignored if not found)     |
+| `--verbose`            |       | Enable verbose logging (show stack traces on error) |
+| `--json`               | `-j`  | Output as JSON (where applicable)                   |
+| `--workspace-id`       | `-w`  | Workspace ID (for deployment commands)              |
+| `--profile`            | `-p`  | Workspace profile                                   |
+| `--config`             | `-c`  | Path to SDK config file                             |
+| `--yes`                | `-y`  | Skip confirmation prompts                           |
+
+### Environment File Loading
+
+Both `--env-file` and `--env-file-if-exists` can be specified multiple times and follow Node.js `--env-file` behavior:
+
+- Variables already set in the environment are **not** overwritten
+- Later files override earlier files
+- `--env-file` files are loaded first, then `--env-file-if-exists` files
+
+```bash
+# Load .env (required) and .env.local (optional, if exists)
+tailor-sdk apply --env-file .env --env-file-if-exists .env.local
+
+# Load multiple files
+tailor-sdk apply --env-file .env --env-file .env.production
+```
 
 ## Environment Variables
 

package/docs/services/auth.md

@@ -17,6 +17,11 @@ For the official Tailor Platform documentation, see [Auth Guide](https://docs.ta
 
 Configure Auth service using `defineAuth()`:
 
+**Definition Rules:**
+
+- **One auth per application**: Each application can have exactly one Auth service
+- **Configuration location**: Define in `tailor.config.ts` using `defineAuth()` and reference directly in the config's `auth` field
+
 ```typescript
 import { defineAuth } from "@tailor-platform/sdk";
 import { user } from "./tailordb/user";

package/docs/services/executor.md

@@ -18,6 +18,12 @@ For the official Tailor Platform documentation, see [Executor Guide](https://doc
 
 Define executors in files matching glob patterns specified in `tailor.config.ts`.
 
+**Definition Rules:**
+
+- **One executor per file**: Each file must contain exactly one executor definition
+- **Export method**: Must use `export default`
+- **Uniqueness**: Executor names must be unique globally across your entire application
+
 ```typescript
 import { createExecutor, recordCreatedTrigger, t } from "@tailor-platform/sdk";
 import { user } from "../tailordb/user";

package/docs/services/idp.md

@@ -16,6 +16,12 @@ For the official Tailor Platform documentation, see [Identity Provider Setup](ht
 
 Configure the Built-in IdP using `defineIdp()`:
 
+**Definition Rules:**
+
+- **Multiple IdPs allowed**: You can define multiple IdP instances in your config file
+- **Configuration location**: Define in `tailor.config.ts` and add to the `idp` array
+- **Uniqueness**: IdP names must be unique across all IdP instances
+
 ```typescript
 import { defineIdp, defineConfig } from "@tailor-platform/sdk";
 
@@ -24,8 +30,14 @@ const idp = defineIdp("my-idp", {
   clients: ["my-client"],
 });
 
+// You can define multiple IdPs
+const anotherIdp = defineIdp("another-idp", {
+  authorization: "loggedIn",
+  clients: ["another-client"],
+});
+
 export default defineConfig({
-  idp: [idp],
+  idp: [idp, anotherIdp], // Add all IdPs to the array
 });
 ```
 

package/docs/services/resolver.md

@@ -74,6 +74,12 @@ createResolver({
 
 Define resolvers in files matching glob patterns specified in `tailor.config.ts`.
 
+**Definition Rules:**
+
+- **One resolver per file**: Each file must contain exactly one resolver definition
+- **Export method**: Must use `export default`
+- **Uniqueness**: Resolver names must be unique per namespace
+
 ```typescript
 import { createResolver, t } from "@tailor-platform/sdk";
 

package/docs/services/staticwebsite.md

@@ -16,6 +16,12 @@ For the official Tailor Platform documentation, see [Static Website Guide](https
 
 Configure static website hosting using `defineStaticWebSite()`:
 
+**Definition Rules:**
+
+- **Multiple websites allowed**: You can define multiple static websites in your config file
+- **Configuration location**: Define in `tailor.config.ts` and add to the `staticWebsites` array
+- **Uniqueness**: Website names must be unique across all static websites
+
 ```typescript
 import { defineStaticWebSite, defineConfig } from "@tailor-platform/sdk";
 
@@ -23,8 +29,13 @@ const website = defineStaticWebSite("my-website", {
   description: "My Static Website",
 });
 
+// You can define multiple static websites
+const adminWebsite = defineStaticWebSite("admin-website", {
+  description: "Admin Dashboard",
+});
+
 export default defineConfig({
-  staticWebsites: [website],
+  staticWebsites: [website, adminWebsite], // Add all websites to the array
 });
 ```
 

package/docs/services/tailordb.md

@@ -18,15 +18,30 @@ For the official Tailor Platform documentation, see [TailorDB Guide](https://doc
 
 Define TailorDB Types in files matching glob patterns specified in `tailor.config.ts`.
 
+**Definition Rules:**
+
+- **Multiple types per file**: You can define multiple TailorDB types in a single file
+- **Export method**: Use named exports (`export const`)
+- **Export both value and type**: Always export both the runtime value and TypeScript type
+- **Uniqueness**: Type names must be unique across all TailorDB files
+
 ```typescript
 import { db } from "@tailor-platform/sdk";
 
+// Export both value and type
 export const user = db.type("User", {
   name: db.string(),
   email: db.string().unique(),
   age: db.int(),
   ...db.fields.timestamps(),
 });
+export type user = typeof user;
+
+// You can define multiple types in the same file
+export const role = db.type("Role", {
+  name: db.string().unique(),
+});
+export type role = typeof role;
 ```
 
 Specify plural form by passing an array as first argument:
@@ -190,26 +205,130 @@ type User {
 
 ### Hooks
 
-Add hooks to execute functions during data creation or update:
+Add hooks to execute functions during data creation or update. Hooks receive three arguments:
+
+- `value`: User input if provided, otherwise existing value on update or null on create
+- `data`: Entire record data (for accessing other field values)
+- `user`: User performing the operation
+
+#### Field-level Hooks
+
+Set hooks directly on individual fields:
 
 ```typescript
-db.datetime().hooks({
-  create: () => new Date(),
-  update: () => new Date(),
+db.string().hooks({
+  create: ({ user }) => user.id,
+  update: ({ value }) => value,
 });
 ```
 
-Function arguments include: `value` (field value), `data` (entire record value), `user` (user performing the operation).
+**Note:** When setting hooks at the field level, the `data` argument type is `unknown` since the field doesn't know about other fields in the type. Use type-level hooks if you need to access other fields with type safety.
+
+#### Type-level Hooks
+
+Set hooks for multiple fields at once using `db.type().hooks()`:
+
+```typescript
+export const customer = db
+  .type("Customer", {
+    firstName: db.string(),
+    lastName: db.string(),
+    fullName: db.string(),
+  })
+  .hooks({
+    fullName: {
+      create: ({ data }) => `${data.firstName} ${data.lastName}`,
+      update: ({ data }) => `${data.firstName} ${data.lastName}`,
+    },
+  });
+```
+
+**⚠️ Important:** Field-level and type-level hooks cannot coexist on the same field. TypeScript will prevent this at compile time:
+
+```typescript
+// ❌ Compile error - cannot set hooks on the same field twice
+export const user = db
+  .type("User", {
+    name: db.string().hooks({ create: ({ data }) => data.firstName }), // Field-level
+  })
+  .hooks({
+    name: { create: ({ data }) => data.lastName }, // Type-level - ERROR
+  });
+
+// ✅ Correct - set hooks on different fields
+export const user = db
+  .type("User", {
+    firstName: db.string().hooks({ create: () => "John" }), // Field-level on firstName
+    lastName: db.string(),
+  })
+  .hooks({
+    lastName: { create: () => "Doe" }, // Type-level on lastName
+  });
+```
 
 ### Validation
 
+Add validation rules to fields. Validators receive three arguments (executed after hooks):
+
+- `value`: Field value after hook transformation
+- `data`: Entire record data after hook transformations (for accessing other field values)
+- `user`: User performing the operation
+
+Validators return `true` for success, `false` for failure. Use array form `[validator, errorMessage]` for custom error messages.
+
+#### Field-level Validation
+
+Set validators directly on individual fields:
+
 ```typescript
 db.string().validate(
-  ({ value }) => value.length > 5,
-  [({ value }) => value.length < 10, "Value must be shorter than 10 characters"],
+  ({ value }) => value.includes("@"),
+  [({ value }) => value.length >= 5, "Email must be at least 5 characters"],
 );
 ```
 
+#### Type-level Validation
+
+Set validators for multiple fields at once using `db.type().validate()`:
+
+```typescript
+export const user = db
+  .type("User", {
+    name: db.string(),
+    email: db.string(),
+  })
+  .validate({
+    name: [({ value }) => value.length > 5, "Name must be longer than 5 characters"],
+    email: [
+      ({ value }) => value.includes("@"),
+      [({ value }) => value.length >= 5, "Email must be at least 5 characters"],
+    ],
+  });
+```
+
+**⚠️ Important:** Field-level and type-level validation cannot coexist on the same field. TypeScript will prevent this at compile time:
+
+```typescript
+// ❌ Compile error - cannot set validation on the same field twice
+export const user = db
+  .type("User", {
+    name: db.string().validate(({ value }) => value.length > 0), // Field-level
+  })
+  .validate({
+    name: [({ value }) => value.length < 100, "Too long"], // Type-level - ERROR
+  });
+
+// ✅ Correct - set validation on different fields
+export const user = db
+  .type("User", {
+    name: db.string().validate(({ value }) => value.length > 0), // Field-level on name
+    email: db.string(),
+  })
+  .validate({
+    email: [({ value }) => value.includes("@"), "Invalid email"], // Type-level on email
+  });
+```
+
 ### Vector Search
 
 ```typescript

package/docs/services/workflow.md

@@ -18,6 +18,14 @@ For the official Tailor Platform documentation, see [Workflow Guide](https://doc
 
 All workflow components must follow these rules:
 
+**Definition Rules:**
+
+- **One workflow + multiple jobs per file**: Each file can define multiple jobs (named exports) and one workflow (default export)
+- **Workflow export method**: Must use `export default`
+- **Job export method**: Must use named exports (`export const`)
+- **Job name uniqueness**: Job names must be unique across the entire project (not just within one file)
+- **mainJob required**: Every workflow must specify a `mainJob`
+
 | Rule                                           | Description                                                                                              |
 | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
 | `createWorkflow` result must be default export | Workflow files must export the workflow as default                                                       |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailor-platform/sdk",
-  "version": "1.2.6",
+  "version": "1.4.0",
   "description": "Tailor Platform SDK - The SDK to work with Tailor Platform",
   "license": "MIT",
   "repository": {
@@ -43,7 +43,7 @@
     "@bufbuild/protobuf": "2.10.2",
     "@connectrpc/connect": "2.1.1",
     "@connectrpc/connect-node": "2.1.1",
-    "@oxc-project/types": "0.107.0",
+    "@oxc-project/types": "0.108.0",
     "@standard-schema/spec": "1.1.0",
     "@urql/core": "6.0.1",
     "chalk": "5.6.2",
@@ -59,15 +59,16 @@
     "multiline-ts": "4.0.1",
     "open": "11.0.0",
     "ora": "9.0.0",
-    "oxc-parser": "0.107.0",
+    "oxc-parser": "0.108.0",
     "p-limit": "7.2.0",
+    "pathe": "2.0.3",
     "pkg-types": "2.3.0",
-    "rolldown": "1.0.0-beta.59",
+    "rolldown": "1.0.0-beta.60",
     "std-env": "3.10.0",
     "table": "6.9.0",
     "ts-cron-validator": "1.1.5",
     "tsx": "4.21.0",
-    "type-fest": "5.3.1",
+    "type-fest": "5.4.1",
     "xdg-basedir": "5.1.0",
     "zod": "4.3.5"
   },
@@ -77,21 +78,33 @@
     "@toiroakr/lines-db": "0.6.1",
     "@types/madge": "5.0.3",
     "@types/mime-types": "3.0.1",
-    "@types/node": "24.10.7",
-    "@typescript/native-preview": "7.0.0-dev.20260111.1",
-    "@vitest/coverage-v8": "4.0.16",
+    "@types/node": "24.10.9",
+    "@typescript/native-preview": "7.0.0-dev.20260117.1",
+    "@vitest/coverage-v8": "4.0.17",
     "cross-env": "10.1.0",
     "eslint": "9.39.2",
-    "eslint-plugin-jsdoc": "62.0.0",
-    "eslint-plugin-oxlint": "1.38.0",
+    "eslint-plugin-jsdoc": "62.1.0",
+    "eslint-plugin-oxlint": "1.39.0",
     "globals": "17.0.0",
-    "oxlint": "1.38.0",
-    "oxlint-tsgolint": "0.11.0",
+    "oxlint": "1.39.0",
+    "oxlint-tsgolint": "0.11.1",
     "sonda": "0.10.1",
     "tsdown": "0.19.0",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.52.0",
-    "vitest": "4.0.16"
+    "typescript-eslint": "8.53.0",
+    "vitest": "4.0.17"
+  },
+  "peerDependencies": {
+    "@liam-hq/cli": "*",
+    "serve": "*"
+  },
+  "peerDependenciesMeta": {
+    "@liam-hq/cli": {
+      "optional": true
+    },
+    "serve": {
+      "optional": true
+    }
   },
   "scripts": {
     "test": "vitest",