feat(tailordb,resolver)!: object-literal descriptor API and record-level hooks/validate

.changeset/object-literal-descriptor-api.md

@@ -0,0 +1,12 @@
+---
+"@tailor-platform/sdk": major
+---
+
+TailorDB API refactor: object-literal descriptor API and record-level hooks/validate
+
+- **New**: `createTable(name, fields, options?)` accepts object-literal field descriptors alongside the existing fluent API.
+- **New**: Resolver fields accept object-literal descriptors.
+- **Breaking**: Removed field-level `.hooks()` and `.validate()` from the TailorDB field builder (`db.string().hooks(...)`, `db.int().validate(...)`, etc.) and from field descriptors passed to `createTable`.
+- **Breaking**: `createTable` type-level `hooks` / `validate` options are now **record-level** callbacks that receive the full record via `({ data, user }) => ...`. Hooks return an object containing **only the fields to override**; omitted fields keep their incoming values. The SDK statically extracts the override key set from the returned object literal and expands each entry into a field-level hook on the affected field, so the platform-generated GraphQL `CreateInput` treats those fields as optional. `validate` accepts a single function, a `[fn, message]` tuple, or an array of either.
+
+Migration: move field-level hook/validate logic into record-level callbacks on the type. Record-level hook bodies must end in a static object literal (`({ data }) => ({ k1: v1, k2: v2 })`) so the override keys can be statically resolved; branched or computed return shapes will throw at parse time.

.gitignore

@@ -55,3 +55,4 @@ CLAUDE.local.md
 llm-challenge/results/
 llm-challenge/problems/*/work
 .claude/tmp/
+.agent/tmp/

CLAUDE.md

@@ -41,7 +41,7 @@ Refer to `example/` for working implementations of all patterns (config, models,
 Key files:
 
 - `example/tailor.config.ts` - Configuration with defineConfig, defineAuth, defineIdp, defineStaticWebSite, definePlugins
-- `example/tailordb/*.ts` - Model definitions with `db.type()`
+- `example/tailordb/*.ts` - Model definitions with `db.type()` or `createTable`
 - `example/resolvers/*.ts` - Resolver implementations with `createResolver`
 - `example/executors/*.ts` - Executor implementations with `createExecutor`
 - `example/workflows/*.ts` - Workflow implementations with `createWorkflow` / `createWorkflowJob`

example/e2e/executor.test.ts

@@ -177,6 +177,7 @@ describe("dataplane", () => {
               email: "customer@example.com"
               country: "USA"
               postalCode: "12345"
+              fullAddress: "12345"
               state: "California"
             }
           ) {

example/e2e/tailordb.test.ts

@@ -236,6 +236,7 @@ describe("dataplane", () => {
               email: "customer-${randomUUID()}@example.com"
               country: "USA"
               postalCode: "12345"
+              fullAddress: "12345"
               state: "California"
             }
           ) {
@@ -419,6 +420,7 @@ describe("dataplane", () => {
               email: "customer@example.com"
               country: "USA"
               postalCode: "12345"
+              fullAddress: "12345"
               state: "California"
             }
           ) {
@@ -535,6 +537,8 @@ describe("dataplane", () => {
       });
     });
 
+    // TODO(record-level-hooks): once the platform supports record-level hooks,
+    // remove the explicit fullAddress input and verify the hook computes it.
     test("custom hooks execute correctly", async () => {
       const query = gql`
         mutation {
@@ -546,6 +550,7 @@ describe("dataplane", () => {
               postalCode: "12345"
               address: "123 Main St"
               city: "Los Angeles"
+              fullAddress: "12345 123 Main St Los Angeles"
               state: "California"
             }
           ) {
@@ -577,6 +582,7 @@ describe("dataplane", () => {
               email: "bob@example.com"
               country: "USA"
               postalCode: "12345"
+              fullAddress: "12345"
               state: "California"
             }
           ) {

example/executors/userRecordLog.ts

@@ -15,6 +15,8 @@ export default async ({ newRecord }: { newRecord: t.infer<typeof user> }) => {
     .values({
       userID: newRecord.id,
       message: `User created: ${record?.name} (${record?.email})`,
+      createdAt: new Date(),
+      updatedAt: new Date(),
     })
     .execute();
 };

example/generated/enums.ts

@@ -14,6 +14,13 @@ export const InvoiceStatus = {
 } as const;
 export type InvoiceStatus = (typeof InvoiceStatus)[keyof typeof InvoiceStatus];
 
+export const ProductCategory = {
+  "electronics": "electronics",
+  "clothing": "clothing",
+  "food": "food"
+} as const;
+export type ProductCategory = (typeof ProductCategory)[keyof typeof ProductCategory];
+
 export const PurchaseOrderAttachedFilesType = {
   "text": "text",
   "image": "image"

example/generated/tailordb.ts

@@ -27,7 +27,7 @@ export interface Namespace {
       fullAddress: Generated<string>;
       state: string;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp | null>;
     }
 
     Invoice: {
@@ -38,7 +38,7 @@ export interface Namespace {
       sequentialId: Serial<number>;
       status: "draft" | "sent" | "paid" | "cancelled" | null;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp | null>;
     }
 
     NestedProfile: {
@@ -57,7 +57,19 @@ export interface Namespace {
       }>;
       archived: boolean | null;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp | null>;
+    }
+
+    Product: {
+      id: Generated<string>;
+      name: string;
+      sku: string;
+      price: number;
+      stock: number;
+      category: "electronics" | "clothing" | "food";
+      supplierId: string;
+      createdAt: Generated<Timestamp>;
+      updatedAt: Generated<Timestamp | null>;
     }
 
     PurchaseOrder: {
@@ -73,7 +85,7 @@ export interface Namespace {
         type: "text" | "image";
       }[];
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp | null>;
     }
 
     SalesOrder: {
@@ -86,7 +98,7 @@ export interface Namespace {
       cancelReason: string | null;
       canceledAt: Timestamp | null;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp | null>;
     }
 
     SalesOrderCreated: {
@@ -115,7 +127,7 @@ export interface Namespace {
       state: "Alabama" | "Alaska";
       city: string;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp | null>;
     }
 
     User: {
@@ -126,31 +138,31 @@ export interface Namespace {
       department: string | null;
       role: "MANAGER" | "STAFF";
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp | null>;
     }
 
     UserLog: {
       id: Generated<string>;
       userID: string;
       message: string;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp | null>;
     }
 
     UserSetting: {
       id: Generated<string>;
       language: "jp" | "en";
       userID: string;
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp | null>;
     }
   },
   "analyticsdb": {
     Event: {
       id: Generated<string>;
       name: "CLICK" | "VIEW" | "PURCHASE";
       createdAt: Generated<Timestamp>;
-      updatedAt: Timestamp | null;
+      updatedAt: Generated<Timestamp | null>;
     }
   }
 }