@tailor-platform/create-sdk 1.19.0 → 1.21.0

package/templates/resolver/.oxfmtrc.json

@@ -0,0 +1,3 @@
+{
+  "ignorePatterns": ["src/generated/", "pnpm-lock.yaml"]
+}

package/templates/resolver/.oxlintrc.json

@@ -0,0 +1,197 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": ["typescript"],
+  "categories": {
+    "correctness": "off"
+  },
+  "env": {
+    "builtin": true
+  },
+  "ignorePatterns": [".tailor-sdk/", "src/generated/"],
+  "rules": {
+    "constructor-super": "error",
+    "for-direction": "error",
+    "no-async-promise-executor": "error",
+    "no-case-declarations": "error",
+    "no-class-assign": "error",
+    "no-compare-neg-zero": "error",
+    "no-cond-assign": "error",
+    "no-const-assign": "error",
+    "no-constant-binary-expression": "error",
+    "no-constant-condition": "error",
+    "no-control-regex": "error",
+    "no-debugger": "error",
+    "no-delete-var": "error",
+    "no-dupe-class-members": "error",
+    "no-dupe-else-if": "error",
+    "no-dupe-keys": "error",
+    "no-duplicate-case": "error",
+    "no-empty": "error",
+    "no-empty-character-class": "error",
+    "no-empty-pattern": "error",
+    "no-empty-static-block": "error",
+    "no-ex-assign": "error",
+    "no-extra-boolean-cast": "error",
+    "no-fallthrough": "error",
+    "no-func-assign": "error",
+    "no-global-assign": "error",
+    "no-import-assign": "error",
+    "no-invalid-regexp": "error",
+    "no-irregular-whitespace": "error",
+    "no-loss-of-precision": "error",
+    "no-new-native-nonconstructor": "error",
+    "no-nonoctal-decimal-escape": "error",
+    "no-obj-calls": "error",
+    "no-prototype-builtins": "error",
+    "no-redeclare": "error",
+    "no-regex-spaces": "error",
+    "no-self-assign": "error",
+    "no-setter-return": "error",
+    "no-shadow-restricted-names": "error",
+    "no-sparse-arrays": "error",
+    "no-this-before-super": "error",
+    "no-unexpected-multiline": "error",
+    "no-unsafe-finally": "error",
+    "no-unsafe-negation": "error",
+    "no-unsafe-optional-chaining": "error",
+    "no-unused-labels": "error",
+    "no-unused-private-class-members": "error",
+    "no-unused-vars": "error",
+    "no-useless-backreference": "error",
+    "no-useless-catch": "error",
+    "no-useless-escape": "error",
+    "no-with": "error",
+    "require-yield": "error",
+    "use-isnan": "error",
+    "valid-typeof": "error",
+    "@typescript-eslint/await-thenable": "error",
+    "@typescript-eslint/ban-ts-comment": "error",
+    "no-array-constructor": "error",
+    "@typescript-eslint/no-array-delete": "error",
+    "@typescript-eslint/no-base-to-string": "error",
+    "@typescript-eslint/no-duplicate-enum-values": "error",
+    "@typescript-eslint/no-duplicate-type-constituents": "error",
+    "@typescript-eslint/no-empty-object-type": "error",
+    "@typescript-eslint/no-explicit-any": "error",
+    "@typescript-eslint/no-extra-non-null-assertion": "error",
+    "@typescript-eslint/no-floating-promises": "error",
+    "@typescript-eslint/no-for-in-array": "error",
+    "@typescript-eslint/no-implied-eval": "error",
+    "@typescript-eslint/no-misused-new": "error",
+    "@typescript-eslint/no-misused-promises": "error",
+    "@typescript-eslint/no-namespace": "error",
+    "@typescript-eslint/no-non-null-asserted-optional-chain": "error",
+    "@typescript-eslint/no-redundant-type-constituents": "error",
+    "@typescript-eslint/no-require-imports": "error",
+    "@typescript-eslint/no-this-alias": "error",
+    "@typescript-eslint/no-unnecessary-type-assertion": "error",
+    "@typescript-eslint/no-unnecessary-type-constraint": "error",
+    "@typescript-eslint/no-unsafe-argument": "error",
+    "@typescript-eslint/no-unsafe-assignment": "error",
+    "@typescript-eslint/no-unsafe-call": "error",
+    "@typescript-eslint/no-unsafe-declaration-merging": "error",
+    "@typescript-eslint/no-unsafe-enum-comparison": "error",
+    "@typescript-eslint/no-unsafe-function-type": "error",
+    "@typescript-eslint/no-unsafe-member-access": "error",
+    "@typescript-eslint/no-unsafe-return": "error",
+    "@typescript-eslint/no-unsafe-unary-minus": "error",
+    "no-unused-expressions": "error",
+    "@typescript-eslint/no-wrapper-object-types": "error",
+    "@typescript-eslint/only-throw-error": "error",
+    "@typescript-eslint/prefer-as-const": "error",
+    "@typescript-eslint/prefer-namespace-keyword": "error",
+    "@typescript-eslint/prefer-promise-reject-errors": "error",
+    "@typescript-eslint/require-await": "error",
+    "@typescript-eslint/restrict-plus-operands": "error",
+    "@typescript-eslint/restrict-template-expressions": "error",
+    "@typescript-eslint/triple-slash-reference": "error",
+    "@typescript-eslint/unbound-method": "error",
+    "@typescript-eslint/adjacent-overload-signatures": "error",
+    "@typescript-eslint/array-type": "error",
+    "@typescript-eslint/ban-tslint-comment": "error",
+    "@typescript-eslint/consistent-generic-constructors": "error",
+    "@typescript-eslint/consistent-indexed-object-style": "error",
+    "@typescript-eslint/consistent-type-definitions": "error",
+    "@typescript-eslint/no-confusing-non-null-assertion": "error",
+    "no-empty-function": "error",
+    "@typescript-eslint/no-inferrable-types": "error",
+    "@typescript-eslint/non-nullable-type-assertion-style": "error",
+    "@typescript-eslint/prefer-for-of": "error",
+    "@typescript-eslint/prefer-function-type": "error",
+    "@typescript-eslint/prefer-includes": "error",
+    "@typescript-eslint/prefer-nullish-coalescing": "error"
+  },
+  "overrides": [
+    {
+      "files": ["**/*.ts", "**/*.tsx", "**/*.mts", "**/*.cts"],
+      "rules": {
+        "constructor-super": "off",
+        "no-class-assign": "off",
+        "no-const-assign": "off",
+        "no-dupe-class-members": "off",
+        "no-dupe-keys": "off",
+        "no-func-assign": "off",
+        "no-import-assign": "off",
+        "no-new-native-nonconstructor": "off",
+        "no-obj-calls": "off",
+        "no-redeclare": "off",
+        "no-setter-return": "off",
+        "no-this-before-super": "off",
+        "no-unsafe-negation": "off",
+        "no-var": "error",
+        "no-with": "off",
+        "prefer-rest-params": "error",
+        "prefer-spread": "error"
+      }
+    },
+    {
+      "files": ["eslint.config.js"],
+      "rules": {
+        "@typescript-eslint/await-thenable": "off",
+        "@typescript-eslint/no-array-delete": "off",
+        "@typescript-eslint/no-base-to-string": "off",
+        "@typescript-eslint/no-confusing-void-expression": "off",
+        "@typescript-eslint/no-deprecated": "off",
+        "@typescript-eslint/no-duplicate-type-constituents": "off",
+        "@typescript-eslint/no-floating-promises": "off",
+        "@typescript-eslint/no-for-in-array": "off",
+        "@typescript-eslint/no-implied-eval": "off",
+        "@typescript-eslint/no-meaningless-void-operator": "off",
+        "@typescript-eslint/no-misused-promises": "off",
+        "@typescript-eslint/no-misused-spread": "off",
+        "@typescript-eslint/no-mixed-enums": "off",
+        "@typescript-eslint/no-redundant-type-constituents": "off",
+        "@typescript-eslint/no-unnecessary-boolean-literal-compare": "off",
+        "@typescript-eslint/no-unnecessary-template-expression": "off",
+        "@typescript-eslint/no-unnecessary-type-arguments": "off",
+        "@typescript-eslint/no-unnecessary-type-assertion": "off",
+        "@typescript-eslint/no-unsafe-argument": "off",
+        "@typescript-eslint/no-unsafe-assignment": "off",
+        "@typescript-eslint/no-unsafe-call": "off",
+        "@typescript-eslint/no-unsafe-enum-comparison": "off",
+        "@typescript-eslint/no-unsafe-member-access": "off",
+        "@typescript-eslint/no-unsafe-return": "off",
+        "@typescript-eslint/no-unsafe-type-assertion": "off",
+        "@typescript-eslint/no-unsafe-unary-minus": "off",
+        "@typescript-eslint/non-nullable-type-assertion-style": "off",
+        "@typescript-eslint/only-throw-error": "off",
+        "@typescript-eslint/prefer-includes": "off",
+        "@typescript-eslint/prefer-nullish-coalescing": "off",
+        "@typescript-eslint/prefer-promise-reject-errors": "off",
+        "@typescript-eslint/prefer-reduce-type-parameter": "off",
+        "@typescript-eslint/prefer-return-this-type": "off",
+        "@typescript-eslint/promise-function-async": "off",
+        "@typescript-eslint/related-getter-setter-pairs": "off",
+        "@typescript-eslint/require-array-sort-compare": "off",
+        "@typescript-eslint/require-await": "off",
+        "@typescript-eslint/restrict-plus-operands": "off",
+        "@typescript-eslint/restrict-template-expressions": "off",
+        "@typescript-eslint/return-await": "off",
+        "@typescript-eslint/strict-boolean-expressions": "off",
+        "@typescript-eslint/switch-exhaustiveness-check": "off",
+        "@typescript-eslint/unbound-method": "off",
+        "@typescript-eslint/use-unknown-in-catch-callback-variable": "off"
+      }
+    }
+  ]
+}

package/templates/resolver/.prettierrc

@@ -0,0 +1 @@
+{}

package/templates/resolver/README.md

@@ -0,0 +1,31 @@
+# Resolver Template
+
+Demonstrates all resolver patterns with comprehensive testing approaches.
+
+## Features
+
+- Simple query resolver (pure logic)
+- Database query resolver (Kysely with transactions)
+- Database mutation resolver (dependency injection pattern)
+- Environment variable access
+- User context access
+
+## Testing Approaches
+
+1. **Direct `body()` call** - Simple resolvers with `unauthenticatedTailorUser`
+2. **Mock `tailordb.Client`** - Database resolvers via `vi.stubGlobal`
+3. **Dependency injection** - Extract `DbOperations` interface for testability
+
+## Getting Started
+
+```bash
+pnpm install
+pnpm generate
+pnpm deploy
+```
+
+## Testing
+
+```bash
+pnpm test
+```

package/templates/resolver/__dot__gitignore

@@ -0,0 +1,3 @@
+node_modules/
+.tailor-sdk/
+.eslintcache

package/templates/resolver/eslint.config.js

@@ -0,0 +1,24 @@
+import eslint from "@eslint/js";
+import tseslint from "typescript-eslint";
+import { defineConfig, globalIgnores } from "eslint/config";
+import oxlint from "eslint-plugin-oxlint";
+
+export default defineConfig([
+  globalIgnores([".tailor-sdk/", "src/generated/"]),
+  eslint.configs.recommended,
+  tseslint.configs.recommendedTypeChecked,
+  tseslint.configs.stylisticTypeChecked,
+  {
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+  },
+  {
+    files: ["eslint.config.js"],
+    extends: [tseslint.configs.disableTypeChecked],
+  },
+  ...oxlint.buildFromOxlintConfigFile("./.oxlintrc.json"),
+]);

package/templates/resolver/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "resolver",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "generate": "tailor-sdk generate",
+    "deploy": "tailor-sdk apply",
+    "test": "vitest --project unit",
+    "test:unit": "vitest --project unit",
+    "format": "oxfmt --write .",
+    "format:check": "oxfmt --check .",
+    "lint": "oxlint --type-aware . && eslint --cache .",
+    "lint:fix": "oxlint --type-aware --fix . && eslint --cache --fix .",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@eslint/js": "9.39.2",
+    "@tailor-platform/function-types": "0.8.0",
+    "@tailor-platform/sdk": "1.21.0",
+    "@types/node": "24.10.9",
+    "eslint": "9.39.2",
+    "eslint-plugin-oxlint": "1.39.0",
+    "oxfmt": "0.24.0",
+    "oxlint": "1.39.0",
+    "oxlint-tsgolint": "0.11.1",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.53.0",
+    "vitest": "4.0.17"
+  }
+}

package/templates/resolver/src/resolver/add.test.ts

@@ -0,0 +1,23 @@
+import { unauthenticatedTailorUser } from "@tailor-platform/sdk/test";
+import { describe, expect, test } from "vitest";
+import resolver from "./add";
+
+describe("add resolver", () => {
+  test("adds two positive numbers", async () => {
+    const result = await resolver.body({
+      input: { left: 1, right: 2 },
+      user: unauthenticatedTailorUser,
+      env: { appName: "Resolver Template", version: 1 },
+    });
+    expect(result).toBe(3);
+  });
+
+  test("handles negative numbers", async () => {
+    const result = await resolver.body({
+      input: { left: -5, right: 3 },
+      user: unauthenticatedTailorUser,
+      env: { appName: "Resolver Template", version: 1 },
+    });
+    expect(result).toBe(-2);
+  });
+});

package/templates/{testing/src/resolver/mockTailordb.test.ts → resolver/src/resolver/queryUser.test.ts}

@@ -1,9 +1,8 @@
 import { unauthenticatedTailorUser } from "@tailor-platform/sdk/test";
 import { afterAll, afterEach, beforeAll, describe, expect, test, vi } from "vitest";
-import resolver from "./mockTailordb";
+import resolver from "./queryUser";
 
 describe("incrementUserAge resolver", () => {
-  // Mock queryObject method to simulate database interactions
   const mockQueryObject = vi.fn();
   beforeAll(() => {
     vi.stubGlobal("tailordb", {
@@ -23,7 +22,7 @@ describe("incrementUserAge resolver", () => {
     mockQueryObject.mockReset();
   });
 
-  test("basic functionality", async () => {
+  test("increments user age", async () => {
     // 1: Begin transaction
     mockQueryObject.mockResolvedValueOnce({});
     // 2: Select current age
@@ -38,13 +37,13 @@ describe("incrementUserAge resolver", () => {
     const result = await resolver.body({
       input: { email: "test@example.com" },
       user: unauthenticatedTailorUser,
-      env: {},
+      env: { appName: "Resolver Template", version: 1 },
     });
     expect(result).toEqual({ oldAge: 30, newAge: 31 });
     expect(mockQueryObject).toHaveBeenCalledTimes(4);
   });
 
-  test("user not found", async () => {
+  test("throws when user not found", async () => {
     // 1: Begin transaction
     mockQueryObject.mockResolvedValueOnce({});
     // 2: Select current age (no rows returned)
@@ -57,7 +56,7 @@ describe("incrementUserAge resolver", () => {
     const result = resolver.body({
       input: { email: "test@example.com" },
       user: unauthenticatedTailorUser,
-      env: {},
+      env: { appName: "Resolver Template", version: 1 },
     });
     await expect(result).rejects.toThrowError();
     expect(mockQueryObject).toHaveBeenCalledTimes(3);

package/templates/{testing/src/resolver/mockTailordb.ts → resolver/src/resolver/queryUser.ts}

@@ -8,11 +8,9 @@ const resolver = createResolver({
     email: t.string(),
   },
   body: async (context) => {
-    // Initialize database client
     const db = getDB("main-db");
 
     return await db.transaction().execute(async (trx) => {
-      // Select current age
       const { age } = await trx
         .selectFrom("User")
         .where("email", "=", context.input.email)
@@ -20,18 +18,15 @@ const resolver = createResolver({
         .forUpdate()
         .executeTakeFirstOrThrow();
 
-      // Increase age by 1
       const oldAge = age;
       const newAge = age + 1;
 
-      // Update age in database
       await trx
         .updateTable("User")
         .set({ age: newAge })
         .where("email", "=", context.input.email)
         .execute();
 
-      // Return old and new age
       return { oldAge, newAge };
     });
   },

package/templates/resolver/src/resolver/showEnv.test.ts

@@ -0,0 +1,14 @@
+import { unauthenticatedTailorUser } from "@tailor-platform/sdk/test";
+import { describe, expect, test } from "vitest";
+import resolver from "./showEnv";
+
+describe("showEnv resolver", () => {
+  test("returns environment variables", async () => {
+    const result = await resolver.body({
+      input: undefined as never,
+      user: unauthenticatedTailorUser,
+      env: { appName: "Resolver Template", version: 1 },
+    });
+    expect(result).toEqual({ appName: "Resolver Template", version: 1 });
+  });
+});

package/templates/resolver/src/resolver/showEnv.ts

@@ -0,0 +1,19 @@
+import { createResolver, t } from "@tailor-platform/sdk";
+
+const resolver = createResolver({
+  name: "showEnv",
+  description: "Returns environment variables from config",
+  operation: "query",
+  body: (context) => {
+    return {
+      appName: context.env.appName,
+      version: context.env.version,
+    };
+  },
+  output: t.object({
+    appName: t.string(),
+    version: t.int(),
+  }),
+});
+
+export default resolver;

package/templates/resolver/src/resolver/showUserInfo.test.ts

@@ -0,0 +1,37 @@
+import { unauthenticatedTailorUser } from "@tailor-platform/sdk/test";
+import { describe, expect, test } from "vitest";
+import resolver from "./showUserInfo";
+
+describe("showUserInfo resolver", () => {
+  test("returns default user info", async () => {
+    const result = await resolver.body({
+      input: undefined as never,
+      user: unauthenticatedTailorUser,
+      env: { appName: "Resolver Template", version: 1 },
+    });
+    expect(result).toEqual({
+      userId: unauthenticatedTailorUser.id,
+      userType: unauthenticatedTailorUser.type,
+      workspaceId: unauthenticatedTailorUser.workspaceId,
+    });
+  });
+
+  test("returns custom user info", async () => {
+    const customUser = {
+      ...unauthenticatedTailorUser,
+      id: "user-123",
+      type: "machine_user" as const,
+      workspaceId: "ws-456",
+    };
+    const result = await resolver.body({
+      input: undefined as never,
+      user: customUser,
+      env: { appName: "Resolver Template", version: 1 },
+    });
+    expect(result).toEqual({
+      userId: "user-123",
+      userType: "machine_user",
+      workspaceId: "ws-456",
+    });
+  });
+});

package/templates/resolver/src/resolver/showUserInfo.ts

@@ -0,0 +1,21 @@
+import { createResolver, t } from "@tailor-platform/sdk";
+
+const resolver = createResolver({
+  name: "showUserInfo",
+  description: "Returns information about the current user",
+  operation: "query",
+  body: (context) => {
+    return {
+      userId: context.user.id,
+      userType: context.user.type,
+      workspaceId: context.user.workspaceId,
+    };
+  },
+  output: t.object({
+    userId: t.string(),
+    userType: t.string(),
+    workspaceId: t.string(),
+  }),
+});
+
+export default resolver;

package/templates/{testing/src/resolver/wrapTailordb.test.ts → resolver/src/resolver/updateUser.test.ts}

@@ -1,9 +1,8 @@
 import { describe, expect, test, vi } from "vitest";
-import { DbOperations, decrementUserAge } from "./wrapTailordb";
+import { type DbOperations, decrementUserAge } from "./updateUser";
 
 describe("decrementUserAge resolver", () => {
-  test("basic functionality", async () => {
-    // Mock database operations
+  test("decrements user age", async () => {
     const dbOperations = {
       transaction: vi.fn(
         async (fn: (ops: DbOperations) => Promise<unknown>) => await fn(dbOperations),
@@ -24,8 +23,7 @@ describe("decrementUserAge resolver", () => {
     );
   });
 
-  test("user not found", async () => {
-    // Mock database operations
+  test("throws when user not found", async () => {
     const dbOperations = {
       transaction: vi.fn(
         async (fn: (ops: DbOperations) => Promise<unknown>) => await fn(dbOperations),

package/templates/{testing/src/resolver/wrapTailordb.ts → resolver/src/resolver/updateUser.ts}

@@ -37,17 +37,13 @@ function createDbOperations(db: DB<"main-db">): DbOperations {
 
 export async function decrementUserAge(email: string, dbOperations: DbOperations) {
   return await dbOperations.transaction(async (ops) => {
-    // Select user
     const user = await ops.getUser(email, true);
 
-    // Decrease age by 1
     const oldAge = user.age;
     const newAge = user.age - 1;
 
-    // Update user
     await ops.updateUser({ ...user, age: newAge });
 
-    // Return old and new age
     return { oldAge, newAge };
   });
 }
@@ -59,7 +55,6 @@ export default createResolver({
     email: t.string(),
   },
   body: async (context) => {
-    // Initialize database client
     const db = getDB("main-db");
     const dbOperations = createDbOperations(db);
 

package/templates/resolver/tailor.config.ts

@@ -0,0 +1,26 @@
+import { defineAuth, defineConfig, definePlugins, t } from "@tailor-platform/sdk";
+import { kyselyTypePlugin } from "@tailor-platform/sdk/plugin/kysely-type";
+
+export default defineConfig({
+  name: "resolver",
+  env: {
+    appName: "Resolver Template",
+    version: 1,
+  },
+  auth: defineAuth("main-auth", {
+    machineUserAttributes: {
+      role: t.string(),
+    },
+    machineUsers: {
+      admin: {
+        attributes: {
+          role: "admin",
+        },
+      },
+    },
+  }),
+  db: { "main-db": { files: ["./src/db/*.ts"] } },
+  resolver: { "main-resolver": { files: ["./src/resolver/*.ts"] } },
+});
+
+export const plugins = definePlugins(kyselyTypePlugin({ distPath: "./src/generated/db.ts" }));

package/templates/resolver/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "allowJs": true,
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "types": ["node", "@tailor-platform/function-types"]
+  },
+  "include": ["**/*.ts"]
+}

package/templates/resolver/user-defined.d.ts

@@ -0,0 +1,18 @@
+// This file is auto-generated by @tailor-platform/sdk
+// Do not edit this file manually
+// Regenerated automatically when running 'tailor-sdk apply' or 'tailor-sdk generate'
+
+declare module "@tailor-platform/sdk" {
+  interface AttributeMap {
+    role: string;
+  }
+  interface AttributeList {
+    __tuple?: [];
+  }
+  interface Env {
+    appName: "Resolver Template";
+    version: 1;
+  }
+}
+
+export {};

package/templates/resolver/vitest.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    watch: false,
+    projects: [
+      {
+        test: {
+          name: { label: "unit", color: "blue" },
+          include: ["src/**/*.test.ts"],
+        },
+      },
+    ],
+  },
+});

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

@@ -0,0 +1,3 @@
+{
+  "ignorePatterns": ["src/generated/", "pnpm-lock.yaml"]
+}