feat(tailordb,resolver): add object-literal descriptor API

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

@@ -0,0 +1,5 @@
+---
+"@tailor-platform/sdk": minor
+---
+
+Add object-literal descriptor API for TailorDB types (`createTable`) and resolver fields

.gitignore

@@ -52,3 +52,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, defineGenerators
-- `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/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

@@ -60,6 +60,18 @@ export interface Namespace {
       updatedAt: Timestamp | null;
     }
 
+    Product: {
+      id: Generated<string>;
+      name: string;
+      sku: string;
+      price: number;
+      stock: number;
+      category: "electronics" | "clothing" | "food";
+      supplierId: string;
+      createdAt: Generated<Timestamp>;
+      updatedAt: Timestamp | null;
+    }
+
     PurchaseOrder: {
       id: Generated<string>;
       supplierID: string;

example/migrations/0001/diff.json

@@ -0,0 +1,212 @@
+{
+  "version": 1,
+  "namespace": "tailordb",
+  "createdAt": "2026-04-04T23:52:28.003Z",
+  "changes": [
+    {
+      "kind": "type_added",
+      "typeName": "Product",
+      "after": {
+        "name": "Product",
+        "fields": {
+          "id": {
+            "type": "uuid",
+            "required": true
+          },
+          "name": {
+            "type": "string",
+            "required": true,
+            "description": "Product name"
+          },
+          "sku": {
+            "type": "string",
+            "required": true,
+            "index": true,
+            "unique": true,
+            "description": "Stock keeping unit"
+          },
+          "price": {
+            "type": "float",
+            "required": true
+          },
+          "stock": {
+            "type": "integer",
+            "required": true,
+            "index": true
+          },
+          "category": {
+            "type": "enum",
+            "required": true,
+            "allowedValues": [
+              {
+                "value": "electronics"
+              },
+              {
+                "value": "clothing"
+              },
+              {
+                "value": "food"
+              }
+            ]
+          },
+          "supplierId": {
+            "type": "uuid",
+            "required": true,
+            "index": true,
+            "foreignKey": true,
+            "foreignKeyType": "Supplier",
+            "foreignKeyField": "id"
+          },
+          "createdAt": {
+            "type": "datetime",
+            "required": true,
+            "description": "Record creation timestamp",
+            "hooks": {
+              "create": {
+                "expr": "(() => /* @__PURE__ */ new Date())({ value: _value, data: _data, user: { id: user.id, type: user.type, workspaceId: user.workspace_id, attributes: user.attribute_map, attributeList: user.attributes } })"
+              }
+            }
+          },
+          "updatedAt": {
+            "type": "datetime",
+            "required": false,
+            "description": "Record last update timestamp",
+            "hooks": {
+              "update": {
+                "expr": "(() => /* @__PURE__ */ new Date())({ value: _value, data: _data, user: { id: user.id, type: user.type, workspaceId: user.workspace_id, attributes: user.attribute_map, attributeList: user.attributes } })"
+              }
+            }
+          }
+        },
+        "pluralForm": "Products",
+        "description": "Product catalog entry",
+        "settings": {},
+        "forwardRelationships": {
+          "supplier": {
+            "targetType": "Supplier",
+            "targetField": "supplierId",
+            "sourceField": "id",
+            "isArray": false,
+            "description": ""
+          }
+        },
+        "permissions": {
+          "record": {
+            "create": [
+              {
+                "conditions": [
+                  [
+                    {
+                      "user": "role"
+                    },
+                    "eq",
+                    "MANAGER"
+                  ]
+                ],
+                "permit": "allow"
+              }
+            ],
+            "read": [
+              {
+                "conditions": [
+                  [
+                    {
+                      "user": "role"
+                    },
+                    "eq",
+                    "MANAGER"
+                  ]
+                ],
+                "permit": "allow"
+              },
+              {
+                "conditions": [
+                  [
+                    {
+                      "user": "_loggedIn"
+                    },
+                    "eq",
+                    true
+                  ]
+                ],
+                "permit": "allow"
+              }
+            ],
+            "update": [
+              {
+                "conditions": [
+                  [
+                    {
+                      "user": "role"
+                    },
+                    "eq",
+                    "MANAGER"
+                  ]
+                ],
+                "permit": "allow"
+              }
+            ],
+            "delete": [
+              {
+                "conditions": [
+                  [
+                    {
+                      "user": "role"
+                    },
+                    "eq",
+                    "MANAGER"
+                  ]
+                ],
+                "permit": "allow"
+              }
+            ]
+          },
+          "gql": [
+            {
+              "conditions": [
+                [
+                  {
+                    "user": "role"
+                  },
+                  "eq",
+                  "MANAGER"
+                ]
+              ],
+              "actions": ["create", "read", "update", "delete", "aggregate", "bulkUpsert"],
+              "permit": "allow"
+            },
+            {
+              "conditions": [
+                [
+                  {
+                    "user": "_loggedIn"
+                  },
+                  "eq",
+                  true
+                ]
+              ],
+              "actions": ["read"],
+              "permit": "allow"
+            }
+          ]
+        }
+      }
+    },
+    {
+      "kind": "relationship_added",
+      "typeName": "Supplier",
+      "relationshipName": "products",
+      "relationshipType": "backward",
+      "after": {
+        "targetType": "Product",
+        "targetField": "supplierId",
+        "sourceField": "id",
+        "isArray": true,
+        "description": "Product catalog entry"
+      }
+    }
+  ],
+  "hasBreakingChanges": false,
+  "breakingChanges": [],
+  "requiresMigrationScript": false
+}

example/seed/data/Product.schema.ts

@@ -0,0 +1,23 @@
+import { t } from "@tailor-platform/sdk";
+import { defineSchema } from "@tailor-platform/sdk/seed";
+import { createTailorDBHook, createStandardSchema } from "@tailor-platform/sdk/test";
+import { product } from "../../tailordb/product";
+
+const schemaType = t.object({
+  ...product.pickFields(["id","createdAt"], { optional: true }),
+  ...product.omitFields(["id","createdAt"]),
+});
+
+const hook = createTailorDBHook(product);
+
+export const schema = defineSchema(
+  createStandardSchema(schemaType, hook),
+  {
+    foreignKeys: [
+      {"column":"supplierId","references":{"table":"Supplier","column":"id"}},
+    ],
+    indexes: [
+      {"name":"product_sku_unique_idx","columns":["sku"],"unique":true},
+    ],
+  }
+);

example/seed/exec.mjs

@@ -144,6 +144,7 @@ const namespaceEntities = {
     "Customer",
     "Invoice",
     "NestedProfile",
+    "Product",
     "PurchaseOrder",
     "SalesOrder",
     "SalesOrderCreated",
@@ -162,6 +163,7 @@ const namespaceDeps = {
     "Customer": [],
     "Invoice": ["SalesOrder"],
     "NestedProfile": [],
+    "Product": ["Supplier"],
     "PurchaseOrder": ["Supplier"],
     "SalesOrder": ["Customer", "User"],
     "SalesOrderCreated": [],

example/tailordb/product.ts

@@ -0,0 +1,28 @@
+import { createTable, timestampFields } from "@tailor-platform/sdk";
+import { defaultGqlPermission, defaultPermission } from "./permissions";
+import { supplier } from "./supplier";
+
+export const product = createTable(
+  "Product",
+  {
+    name: { kind: "string", description: "Product name" },
+    sku: { kind: "string", unique: true, description: "Stock keeping unit" },
+    price: { kind: "float" },
+    stock: { kind: "int", index: true },
+    category: { kind: "enum", values: ["electronics", "clothing", "food"] },
+    supplierId: {
+      kind: "uuid",
+      relation: {
+        type: "n-1",
+        toward: { type: supplier },
+      },
+    },
+    ...timestampFields(),
+  },
+  {
+    description: "Product catalog entry",
+    permission: defaultPermission,
+    gqlPermission: defaultGqlPermission,
+  },
+);
+export type product = typeof product;

packages/sdk/docs/services/resolver.md

@@ -103,7 +103,54 @@ export default createResolver({
 
 ## Input/Output Schemas
 
-Define input/output schemas using methods of `t` object. Basic usage and supported field types are the same as TailorDB. TailorDB-specific options (e.g., index, relation) are not supported.
+Define input/output schemas using methods of `t` object or object-literal descriptors (`{ kind: "..." }`). Both styles can be mixed in the same resolver.
+
+### Fluent API (`t.*()`)
+
+```typescript
+createResolver({
+  input: {
+    name: t.string(),
+    age: t.int(),
+  },
+  output: t.object({ name: t.string(), age: t.int() }),
+  // ...
+});
+```
+
+### Object-Literal Descriptors
+
+Use `{ kind: "..." }` syntax as a concise alternative. Supported options: `optional`, `array`, `description`, `validate`, and `typeName` (for enum/object).
+
+```typescript
+createResolver({
+  name: "addNumbers",
+  operation: "query",
+  input: {
+    a: { kind: "int", description: "First number" },
+    b: { kind: "int", description: "Second number" },
+  },
+  output: { kind: "int", description: "Sum" },
+  body: ({ input }) => input.a + input.b,
+});
+```
+
+### Mixing Styles
+
+Fluent and descriptor fields can be freely combined:
+
+```typescript
+createResolver({
+  input: {
+    name: t.string(),
+    status: { kind: "enum", values: ["active", "inactive"] },
+  },
+  output: t.object({ result: t.bool() }),
+  // ...
+});
+```
+
+### Reusing TailorDB Fields
 
 You can reuse fields defined with `db` object, but note that unsupported options will be ignored: