@tailor-platform/sdk 0.10.4 → 0.11.1

package/dist/{types-CCSNkBzX.d.mts → types-C5oBGPO0.d.mts}

@@ -1179,6 +1179,15 @@ declare function defineStaticWebSite(name: string, config: Omit<StaticWebsiteInp
 } & StaticWebsiteDefinitionBrand;
 type StaticWebsiteConfig = Omit<ReturnType<typeof defineStaticWebSite>, "url">;
 //#endregion
+//#region src/configure/services/workflow/types.d.ts
+type WorkflowServiceConfig = {
+  files: string[];
+  job_files?: string[];
+  ignores?: string[];
+  job_ignores?: string[];
+};
+type WorkflowServiceInput = WorkflowServiceConfig;
+//#endregion
 //#region src/parser/generator-config/index.d.ts
 declare const CodeGeneratorSchema: z.ZodObject<{
   id: z.ZodString;
@@ -1278,6 +1287,7 @@ interface AppConfig<Auth extends AuthConfig = AuthConfig, Idp extends IdPConfig[
   idp?: Idp;
   auth?: Auth;
   executor?: ExecutorServiceInput;
+  workflow?: WorkflowServiceInput;
   staticWebsites?: StaticWebsites;
 }
 declare function defineConfig<const Config extends AppConfig & Record<Exclude<keyof Config, keyof AppConfig>, never>>(config: Config): Config;
@@ -1418,4 +1428,5 @@ type WebhookOperation = z.infer<typeof WebhookOperationSchema>;
 type Executor = z.infer<typeof ExecutorSchema>;
 type ExecutorInput = z.input<typeof ExecutorSchema>;
 //#endregion
-export { AllowedValues, AllowedValuesOutput, AppConfig, ArrayFieldOutput, AuthConfig, AuthExternalConfig, AuthOwnConfig, type AuthServiceInput, type BuiltinIdP, CodeGeneratorBase, Executor, ExecutorInput, ExecutorServiceConfig, ExecutorServiceInput, FieldMetadata, FieldOptions, FieldOutput, FunctionOperation, Generator, GqlOperation, type IDToken, IdPConfig, IdPExternalConfig, type IdProviderConfig, IncomingWebhookTrigger, InferFieldsOutput, type OAuth2Client, type OAuth2ClientGrantType, type OIDC, PermissionCondition, QueryType, RecordTrigger, Resolver, ResolverExecutedTrigger, ResolverExternalConfig, ResolverInput, ResolverServiceConfig, ResolverServiceInput, type SAML, type SCIMAttribute, type SCIMAttributeMapping, type SCIMAttributeType, type SCIMAuthorization, type SCIMConfig, type SCIMResource, ScheduleTriggerInput, StaticWebsiteConfig, TailorDBField, TailorDBInstance, TailorDBType, TailorDBTypeConfig, TailorField, TailorTypeGqlPermission, TailorTypePermission, TailorUser, type TenantProviderConfig, type UserAttributeKey, type UserAttributeListKey, type UserAttributeMap, type UsernameFieldKey, type ValueOperand, WebhookOperation, db, defineAuth, defineConfig, defineGenerators, defineIdp, defineStaticWebSite, output, unauthenticatedTailorUser };
+export { AllowedValues, AllowedValuesOutput, AppConfig, ArrayFieldOutput, AuthConfig, AuthExternalConfig, AuthOwnConfig, type AuthServiceInput, type BuiltinIdP, CodeGeneratorBase, Executor, ExecutorInput, ExecutorServiceConfig, ExecutorServiceInput, FieldMetadata, FieldOptions, FieldOutput, FunctionOperation, Generator, GqlOperation, type IDToken, IdPConfig, IdPExternalConfig, type IdProviderConfig, IncomingWebhookTrigger, InferFieldsOutput, type OAuth2Client, type OAuth2ClientGrantType, type OIDC, PermissionCondition, QueryType, RecordTrigger, Resolver, ResolverExecutedTrigger, ResolverExternalConfig, ResolverInput, ResolverServiceConfig, ResolverServiceInput, type SAML, type SCIMAttribute, type SCIMAttributeMapping, type SCIMAttributeType, type SCIMAuthorization, type SCIMConfig, type SCIMResource, ScheduleTriggerInput, StaticWebsiteConfig, TailorDBField, TailorDBInstance, TailorDBType, TailorDBTypeConfig, TailorField, TailorTypeGqlPermission, TailorTypePermission, TailorUser, type TenantProviderConfig, type UserAttributeKey, type UserAttributeListKey, type UserAttributeMap, type UsernameFieldKey, type ValueOperand, WebhookOperation, WorkflowServiceConfig, WorkflowServiceInput, db, defineAuth, defineConfig, defineGenerators, defineIdp, defineStaticWebSite, output, unauthenticatedTailorUser };
+//# sourceMappingURL=types-C5oBGPO0.d.mts.map

package/dist/utils/test/index.d.mts

@@ -1,7 +1,7 @@
 /// <reference path="./../../plugin-generated.d.ts" />
 
-import { TailorDBType, TailorField, TailorUser } from "../../types-CCSNkBzX.mjs";
-import { output } from "../../index-DENkoB_m.mjs";
+import { TailorDBType, TailorField, TailorUser } from "../../types-C5oBGPO0.mjs";
+import { output } from "../../index-DIPoP-nY.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/utils/test/index.d.ts
@@ -37,4 +37,5 @@ declare function createStandardSchema<T = Record<string, unknown>>(schemaType: T
   };
 };
 //#endregion
-export { createStandardSchema, createTailorDBHook, unauthenticatedTailorUser };
+export { createStandardSchema, createTailorDBHook, unauthenticatedTailorUser };
+//# sourceMappingURL=index.d.mts.map

package/dist/utils/test/index.mjs

@@ -60,4 +60,5 @@ function createStandardSchema(schemaType, hook) {
 }
 
 //#endregion
-export { createStandardSchema, createTailorDBHook, unauthenticatedTailorUser };
+export { createStandardSchema, createTailorDBHook, unauthenticatedTailorUser };
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["unauthenticatedTailorUser: TailorUser"],"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: TailorUser = {\n  id: \"00000000-0000-0000-0000-000000000000\",\n  type: \"\",\n  workspaceId: \"00000000-0000-0000-0000-000000000000\",\n  attributes: null,\n  attributeList: [],\n} as const;\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 *\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\"\n              ? (data as Record<string, unknown>)[key]\n              : 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        } 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 *\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,MAAaA,4BAAwC;CACnD,IAAI;CACJ,MAAM;CACN,aAAa;CACb,YAAY;CACZ,eAAe,EAAE;CAClB;;;;;;;;;;;AAaD,SAAgB,mBAAqD,MAAS;AAC5E,SAAQ,SAAkB;AACxB,SAAO,OAAO,QAAQ,KAAK,OAAO,CAAC,QAChC,QAAQ,CAAC,KAAK,WAAW;GAExB,MAAM,QAAQ;AACd,OAAI,QAAQ,KAMV,QAAO,QAHL,QAAQ,OAAO,SAAS,WACnB,KAAiC,OAClC,WACsB,OAAO,YAAY;YACtC,MAAM,SAAS,SAExB,QAAO,OAAO,mBAAmB,EAAE,QAAQ,MAAM,QAAQ,CAAQ,CAC9D,KAAiC,KACnC;YACQ,MAAM,SAAS,OAAO,OAC/B,QAAO,OAAO,MAAM,SAAS,MAAM,OAAO;IACxC,OAAQ,KAAiC;IACnC;IACN,MAAM;IACP,CAAC;YACO,QAAQ,OAAO,SAAS,SACjC,QAAO,OAAQ,KAAiC;AAElD,UAAO;KAET,EAAE,CACH;;;;;;;;;;;;AAaL,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/configuration.md

@@ -41,6 +41,9 @@ export default defineConfig({
   executor: {
     files: ["executors/**/*.ts"],
   },
+  workflow: {
+    files: ["workflows/**/*.ts"],
+  },
 });
 ```
 
@@ -161,3 +164,20 @@ body: ({ newRecord, env }) => {
   console.log(`Environment: ${env.bar}, User: ${newRecord.name}`);
 };
 ```
+
+### Workflow Service
+
+Configure Workflow service by specifying glob patterns for workflow files:
+
+```typescript
+export default defineConfig({
+  workflow: {
+    files: ["workflows/**/*.ts"],
+    ignores: ["workflows/**/*.draft.ts"],
+  },
+});
+```
+
+**files**: Glob patterns to match workflow files. Required.
+
+**ignores**: Glob patterns to exclude files. Optional.

package/docs/core-concepts.md

@@ -502,3 +502,117 @@ Context varies based on trigger type:
 - `resolverName`: Name of the resolver
 - `result`: Resolver's return value (when execution succeeds)
 - `error`: Error object (when execution fails)
+
+### Workflow Concepts
+
+Define Workflows in files matching glob patterns specified in `tailor.config.ts`. Workflows orchestrate multiple jobs that can depend on each other.
+
+#### Workflow Rules
+
+**Important**: All workflow components must follow these rules:
+
+| Rule                                           | Required | Description                                         |
+| ---------------------------------------------- | -------- | --------------------------------------------------- |
+| `createWorkflow` result must be default export | Yes      | Workflow files must export the workflow as default  |
+| All jobs must be named exports                 | Yes      | Every job used in a workflow must be a named export |
+| Job names must be unique                       | Yes      | Job names must be unique across the entire project  |
+| `mainJob` is required                          | Yes      | Every workflow must specify a `mainJob`             |
+| Jobs in `deps` must be job objects             | Yes      | Pass job objects, not strings                       |
+
+#### Workflow Job Definition
+
+Define workflow jobs using `createWorkflowJob`:
+
+```typescript
+import { createWorkflowJob } from "@tailor-platform/sdk";
+import { getDB } from "../generated/tailordb";
+
+// All jobs must be named exports
+export const fetchCustomer = createWorkflowJob({
+  name: "fetch-customer",
+  body: async (input: { customerId: string }) => {
+    const db = getDB("tailordb");
+    const customer = await db
+      .selectFrom("Customer")
+      .selectAll()
+      .where("id", "=", input.customerId)
+      .executeTakeFirst();
+    return customer;
+  },
+});
+```
+
+#### Job Dependencies
+
+Jobs can depend on other jobs using the `deps` array. Dependent jobs are accessible via the second argument of `body` function with hyphens replaced by underscores:
+
+```typescript
+import { createWorkflowJob } from "@tailor-platform/sdk";
+import { fetchCustomer } from "./jobs/fetch-customer";
+import { sendNotification } from "./jobs/send-notification";
+
+// All jobs must be named exports - including jobs with dependencies
+export const processOrder = createWorkflowJob({
+  name: "process-order",
+  deps: [fetchCustomer, sendNotification],
+  body: async (input: { orderId: string; customerId: string }, jobs) => {
+    // Access dependent jobs with hyphens replaced by underscores
+    // "fetch-customer" -> jobs.fetch_customer()
+    // "send-notification" -> jobs.send_notification()
+    const customer = await jobs.fetch_customer({
+      customerId: input.customerId,
+    });
+
+    const notification = await jobs.send_notification({
+      message: `Order ${input.orderId} is being processed`,
+      recipient: customer.email,
+    });
+
+    return {
+      orderId: input.orderId,
+      customerEmail: customer.email,
+      notificationSent: notification.sent,
+    };
+  },
+});
+```
+
+#### Workflow Definition
+
+Define a workflow using `createWorkflow` and export it as default:
+
+```typescript
+import { createWorkflow, createWorkflowJob } from "@tailor-platform/sdk";
+import { fetchCustomer } from "./jobs/fetch-customer";
+import { sendNotification } from "./jobs/send-notification";
+
+// Jobs must be named exports
+export const processOrder = createWorkflowJob({
+  name: "process-order",
+  deps: [fetchCustomer, sendNotification],
+  body: async (input, jobs) => {
+    // ... job logic
+  },
+});
+
+// Workflow must be default export
+export default createWorkflow({
+  name: "order-processing",
+  mainJob: processOrder,
+});
+```
+
+#### File Organization
+
+Recommended file structure for workflows:
+
+```
+workflows/
+├── jobs/
+│   ├── fetch-customer.ts    # export const fetchCustomer = createWorkflowJob(...)
+│   └── send-notification.ts # export const sendNotification = createWorkflowJob(...)
+└── order-processing.ts      # export const processOrder = createWorkflowJob(...)
+                             # export default createWorkflow(...)
+```
+
+All jobs can be in a single file or split across multiple files, as long as they are named exports.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailor-platform/sdk",
-  "version": "0.10.4",
+  "version": "0.11.1",
   "description": "Tailor Platform SDK - The SDK to work with Tailor Platform",
   "license": "MIT",
   "main": "./dist/configure/index.mjs",
@@ -55,6 +55,7 @@
     "madge": "8.0.0",
     "multiline-ts": "4.0.1",
     "open": "10.2.0",
+    "oxc-parser": "0.98.0",
     "pkg-types": "2.3.0",
     "rolldown": "1.0.0-beta.41",
     "smol-toml": "1.4.2",
@@ -70,9 +71,10 @@
     "@eslint/js": "9.39.1",
     "@tailor-platform/function-types": "0.7.2",
     "@types/madge": "5.0.3",
-    "@types/node": "22.19.0",
+    "@types/node": "22.19.1",
     "eslint": "9.39.1",
     "globals": "16.5.0",
+    "sonda": "0.10.0",
     "tsdown": "0.15.6",
     "typescript": "5.9.3",
     "typescript-eslint": "8.47.0",
@@ -85,6 +87,7 @@
     "lint:fix": "eslint --cache . --fix",
     "typecheck": "tsc --noEmit",
     "prepublish": "pnpm run build",
-    "postinstall": "node postinstall.mjs"
+    "postinstall": "node postinstall.mjs",
+    "measure:bundle": "node ../../scripts/measure-bundle-size-sonda.js"
   }
 }