@tailor-platform/sdk 1.11.0 → 1.12.0

package/dist/{job-l-pIR9IY.mjs → job-zGAXCidt.mjs}

@@ -18,4 +18,4 @@ const createWorkflowJob = (config) => {
 
 //#endregion
 export { createWorkflowJob as n, WORKFLOW_TEST_ENV_KEY as t };
-//# sourceMappingURL=job-l-pIR9IY.mjs.map
+//# sourceMappingURL=job-zGAXCidt.mjs.map

package/dist/{job-l-pIR9IY.mjs.map → job-zGAXCidt.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"job-l-pIR9IY.mjs","names":[],"sources":["../src/configure/services/workflow/job.ts"],"sourcesContent":["import type { TailorEnv } from \"@/configure/types/env\";\nimport type { JsonCompatible } from \"@/configure/types/helpers\";\nimport type { Jsonifiable, Jsonify, JsonPrimitive } from \"type-fest\";\n\n/**\n * Context object passed as the second argument to workflow job body functions.\n */\nexport type WorkflowJobContext = {\n  env: TailorEnv;\n};\n\n/**\n * Allowed output types for workflow job body functions.\n * Includes Jsonifiable (JSON-serializable values including objects with toJSON like Date),\n * undefined, and void.\n */\nexport type WorkflowJobOutput = Jsonifiable | undefined | void;\n\n/**\n * Convert output type to what trigger returns after JSON serialization.\n * - Jsonifiable values are converted via Jsonify (Date -> string, etc.)\n * - undefined remains undefined\n * - void becomes void\n */\ntype JsonifyOutput<T> = T extends Jsonifiable ? Jsonify<T> : T;\n\n/**\n * Input type constraint for workflow jobs.\n * Accepts any type that is JSON-compatible (primitives, arrays, objects with JSON-compatible values).\n * Excludes objects with toJSON method (like Date) since they won't be serialized in input.\n */\nexport type WorkflowJobInput = undefined | JsonCompatible<unknown>;\n\n/**\n * WorkflowJob represents a job that can be triggered in a workflow.\n *\n * Type constraints:\n * - Input: Must be JSON-compatible (no Date/toJSON objects) or undefined. Interfaces are allowed.\n * - Output: Must be Jsonifiable, undefined, or void\n * - Trigger returns Jsonify<Output> (Date becomes string after JSON.stringify)\n */\nexport interface WorkflowJob<Name extends string = string, Input = undefined, Output = undefined> {\n  name: Name;\n  /**\n   * Trigger this job with the given input.\n   * At runtime, this is a placeholder that calls the body function.\n   * During bundling, calls to .trigger() are transformed to\n   * tailor.workflow.triggerJobFunction(\"<job-name>\", args).\n   *\n   * Returns Jsonify<Output> because the value passes through JSON.stringify.\n   */\n  trigger: [Input] extends [undefined]\n    ? () => Promise<JsonifyOutput<Awaited<Output>>>\n    : (input: Input) => Promise<JsonifyOutput<Awaited<Output>>>;\n  body: (input: Input, context: WorkflowJobContext) => Output | Promise<Output>;\n}\n\n/**\n * Helper type to check if all property types are valid.\n * Uses -? to remove optional modifiers so all properties are treated uniformly.\n */\ntype AllPropertiesValid<T> = {\n  [K in keyof T]-?: IsValidInput<T[K]> extends true ? true : false;\n}[keyof T] extends true\n  ? true\n  : false;\n\n/**\n * Check if a type contains any non-JSON-compatible values.\n * Returns `true` if the type is valid for input, `false` otherwise.\n *\n * Accepts:\n * - JSON primitives (string, number, boolean, null)\n * - undefined\n * - Optional primitives (e.g., string | undefined)\n * - Arrays of valid types\n * - Objects with valid field types\n *\n * Rejects:\n * - Objects with toJSON methods (like Date)\n * - Other non-JSON-serializable types\n */\ntype IsValidInput<T> = T extends undefined\n  ? true\n  : T extends JsonPrimitive\n    ? true\n    : T extends readonly (infer U)[]\n      ? IsValidInput<U>\n      : T extends object\n        ? T extends { toJSON: () => unknown }\n          ? false\n          : AllPropertiesValid<T>\n        : false;\n\n/**\n * Helper type to check if all property types are valid for output.\n * Uses -? to remove optional modifiers so all properties are treated uniformly.\n */\ntype AllPropertiesValidOutput<T> = {\n  [K in keyof T]-?: IsValidOutput<T[K]> extends true ? true : false;\n}[keyof T] extends true\n  ? true\n  : false;\n\n/**\n * Check if a type is valid for output.\n * Returns `true` if the type is valid, `false` otherwise.\n *\n * Accepts:\n * - JSON primitives (string, number, boolean, null)\n * - undefined and void\n * - Optional primitives (e.g., string | undefined)\n * - Jsonifiable types (Date, objects with toJSON)\n * - Arrays of valid types\n * - Objects with valid field types\n */\ntype IsValidOutput<T> = T extends undefined | void\n  ? true\n  : T extends JsonPrimitive\n    ? true\n    : T extends readonly (infer U)[]\n      ? IsValidOutput<U>\n      : T extends object\n        ? AllPropertiesValidOutput<T>\n        : false;\n\n/**\n * Body function type with conditional constraint.\n * If input contains invalid types (like Date), the body type becomes `never` to cause an error.\n */\ntype WorkflowJobBody<I, O> =\n  IsValidInput<I> extends true\n    ? IsValidOutput<O> extends true\n      ? (input: I, context: WorkflowJobContext) => O | Promise<O>\n      : never\n    : never;\n\n/**\n * Environment variable key for workflow testing.\n * Contains JSON-serialized TailorEnv object.\n */\nexport const WORKFLOW_TEST_ENV_KEY = \"TAILOR_TEST_WORKFLOW_ENV\";\n\nexport const createWorkflowJob = <const Name extends string, I = undefined, O = undefined>(config: {\n  readonly name: Name;\n  readonly body: WorkflowJobBody<I, O>;\n}): WorkflowJob<Name, I, Awaited<O>> => {\n  return {\n    name: config.name,\n    // JSON.parse(JSON.stringify(...)) ensures the return value matches Jsonify<Output> type.\n    // This converts Date objects to strings, matching actual runtime behavior.\n    // In production, bundler transforms .trigger() calls to tailor.workflow.triggerJobFunction().\n    trigger: async (args?: unknown) => {\n      const env: TailorEnv = JSON.parse(process.env[WORKFLOW_TEST_ENV_KEY] || \"{}\");\n      const result = await config.body(args as I, { env });\n      return result ? JSON.parse(JSON.stringify(result)) : result;\n    },\n    body: config.body,\n  } as WorkflowJob<Name, I, Awaited<O>>;\n};\n"],"mappings":";;;;;AA6IA,MAAa,wBAAwB;AAErC,MAAa,qBAA8E,WAGnD;AACtC,QAAO;EACL,MAAM,OAAO;EAIb,SAAS,OAAO,SAAmB;GACjC,MAAM,MAAiB,KAAK,MAAM,QAAQ,IAAI,0BAA0B,KAAK;GAC7E,MAAM,SAAS,MAAM,OAAO,KAAK,MAAW,EAAE,KAAK,CAAC;AACpD,UAAO,SAAS,KAAK,MAAM,KAAK,UAAU,OAAO,CAAC,GAAG;;EAEvD,MAAM,OAAO;EACd"}
+{"version":3,"file":"job-zGAXCidt.mjs","names":[],"sources":["../src/configure/services/workflow/job.ts"],"sourcesContent":["import type { TailorEnv } from \"@/configure/types/env\";\nimport type { JsonCompatible } from \"@/configure/types/helpers\";\nimport type { Jsonifiable, Jsonify, JsonPrimitive } from \"type-fest\";\n\n/**\n * Context object passed as the second argument to workflow job body functions.\n */\nexport type WorkflowJobContext = {\n  env: TailorEnv;\n};\n\n/**\n * Allowed output types for workflow job body functions.\n * Includes Jsonifiable (JSON-serializable values including objects with toJSON like Date),\n * undefined, and void.\n */\nexport type WorkflowJobOutput = Jsonifiable | undefined | void;\n\n/**\n * Convert output type to what trigger returns after JSON serialization.\n * - Jsonifiable values are converted via Jsonify (Date -> string, etc.)\n * - undefined remains undefined\n * - void becomes void\n */\ntype JsonifyOutput<T> = T extends Jsonifiable ? Jsonify<T> : T;\n\n/**\n * Input type constraint for workflow jobs.\n * Accepts any type that is JSON-compatible (primitives, arrays, objects with JSON-compatible values).\n * Excludes objects with toJSON method (like Date) since they won't be serialized in input.\n */\nexport type WorkflowJobInput = undefined | JsonCompatible<unknown>;\n\n/**\n * WorkflowJob represents a job that can be triggered in a workflow.\n *\n * Type constraints:\n * - Input: Must be JSON-compatible (no Date/toJSON objects) or undefined. Interfaces are allowed.\n * - Output: Must be Jsonifiable, undefined, or void\n * - Trigger returns Jsonify<Output> (Date becomes string after JSON.stringify)\n */\nexport interface WorkflowJob<Name extends string = string, Input = undefined, Output = undefined> {\n  name: Name;\n  /**\n   * Trigger this job with the given input.\n   * At runtime, this is a placeholder that calls the body function.\n   * During bundling, calls to .trigger() are transformed to\n   * tailor.workflow.triggerJobFunction(\"<job-name>\", args).\n   *\n   * Returns Jsonify<Output> because the value passes through JSON.stringify.\n   */\n  trigger: [Input] extends [undefined]\n    ? () => Promise<JsonifyOutput<Awaited<Output>>>\n    : (input: Input) => Promise<JsonifyOutput<Awaited<Output>>>;\n  body: (input: Input, context: WorkflowJobContext) => Output | Promise<Output>;\n}\n\n/**\n * Helper type to check if all property types are valid.\n * Uses -? to remove optional modifiers so all properties are treated uniformly.\n */\ntype AllPropertiesValid<T> = {\n  [K in keyof T]-?: IsValidInput<T[K]> extends true ? true : false;\n}[keyof T] extends true\n  ? true\n  : false;\n\n/**\n * Check if a type contains any non-JSON-compatible values.\n * Returns `true` if the type is valid for input, `false` otherwise.\n *\n * Accepts:\n * - JSON primitives (string, number, boolean, null)\n * - undefined\n * - Optional primitives (e.g., string | undefined)\n * - Arrays of valid types\n * - Objects with valid field types\n *\n * Rejects:\n * - Objects with toJSON methods (like Date)\n * - Other non-JSON-serializable types\n */\ntype IsValidInput<T> = T extends undefined\n  ? true\n  : T extends JsonPrimitive\n    ? true\n    : T extends readonly (infer U)[]\n      ? IsValidInput<U>\n      : T extends object\n        ? T extends { toJSON: () => unknown }\n          ? false\n          : AllPropertiesValid<T>\n        : false;\n\n/**\n * Helper type to check if all property types are valid for output.\n * Uses -? to remove optional modifiers so all properties are treated uniformly.\n */\ntype AllPropertiesValidOutput<T> = {\n  [K in keyof T]-?: IsValidOutput<T[K]> extends true ? true : false;\n}[keyof T] extends true\n  ? true\n  : false;\n\n/**\n * Check if a type is valid for output.\n * Returns `true` if the type is valid, `false` otherwise.\n *\n * Accepts:\n * - JSON primitives (string, number, boolean, null)\n * - undefined and void\n * - Optional primitives (e.g., string | undefined)\n * - Jsonifiable types (Date, objects with toJSON)\n * - Arrays of valid types\n * - Objects with valid field types\n */\ntype IsValidOutput<T> = T extends undefined | void\n  ? true\n  : T extends JsonPrimitive\n    ? true\n    : T extends readonly (infer U)[]\n      ? IsValidOutput<U>\n      : T extends object\n        ? AllPropertiesValidOutput<T>\n        : false;\n\n/**\n * Body function type with conditional constraint.\n * If input contains invalid types (like Date), the body type becomes `never` to cause an error.\n */\ntype WorkflowJobBody<I, O> =\n  IsValidInput<I> extends true\n    ? IsValidOutput<O> extends true\n      ? (input: I, context: WorkflowJobContext) => O | Promise<O>\n      : never\n    : never;\n\n/**\n * Environment variable key for workflow testing.\n * Contains JSON-serialized TailorEnv object.\n */\nexport const WORKFLOW_TEST_ENV_KEY = \"TAILOR_TEST_WORKFLOW_ENV\";\n\nexport const createWorkflowJob = <const Name extends string, I = undefined, O = undefined>(config: {\n  readonly name: Name;\n  readonly body: WorkflowJobBody<I, O>;\n}): WorkflowJob<Name, I, Awaited<O>> => {\n  return {\n    name: config.name,\n    // JSON.parse(JSON.stringify(...)) ensures the return value matches Jsonify<Output> type.\n    // This converts Date objects to strings, matching actual runtime behavior.\n    // In production, bundler transforms .trigger() calls to tailor.workflow.triggerJobFunction().\n    trigger: async (args?: unknown) => {\n      const env: TailorEnv = JSON.parse(process.env[WORKFLOW_TEST_ENV_KEY] || \"{}\");\n      const result = await config.body(args as I, { env });\n      return result ? JSON.parse(JSON.stringify(result)) : result;\n    },\n    body: config.body,\n  } as WorkflowJob<Name, I, Awaited<O>>;\n};\n"],"mappings":";;;;;AA6IA,MAAa,wBAAwB;AAErC,MAAa,qBAA8E,WAGnD;AACtC,QAAO;EACL,MAAM,OAAO;EAIb,SAAS,OAAO,SAAmB;GACjC,MAAM,MAAiB,KAAK,MAAM,QAAQ,IAAI,0BAA0B,KAAK;GAC7E,MAAM,SAAS,MAAM,OAAO,KAAK,MAAW,EAAE,KAAK,CAAC;AACpD,UAAO,SAAS,KAAK,MAAM,KAAK,UAAU,OAAO,CAAC,GAAG;;EAEvD,MAAM,OAAO;EACd"}

package/dist/kysely/index.d.mts

@@ -0,0 +1,25 @@
+/// <reference path="./../user-defined.d.ts" />
+import { TailordbDialect } from "@tailor-platform/function-kysely-tailordb";
+import { ColumnType, ColumnType as ColumnType$1, Insertable, Insertable as Insertable$1, Kysely, Kysely as Kysely$1, KyselyConfig, KyselyConfig as KyselyConfig$1, Selectable, Selectable as Selectable$1, Transaction, Transaction as Transaction$1, Updateable, Updateable as Updateable$1 } from "kysely";
+
+//#region src/kysely/index.d.ts
+
+type Timestamp = ColumnType$1<Date, Date | string, Date | string>;
+type Generated<T> = T extends ColumnType$1<infer S, infer I, infer U> ? ColumnType$1<S, I | undefined, U> : ColumnType$1<T, T | undefined, T>;
+type Serial<T = string | number> = ColumnType$1<T, never, never>;
+type TailordbKysely<DB$1> = Kysely$1<DB$1>;
+type NamespaceDB<NS, N$1 extends keyof NS = keyof NS> = TailordbKysely<NS[N$1]>;
+/**
+ * Create a namespace-aware getDB function for generated code.
+ * @returns A getDB function that creates Kysely instances for specific namespaces
+ */
+declare function createGetDB<NS>(): <const N$1 extends keyof NS & string>(namespace: N$1, config?: Omit<KyselyConfig$1, "dialect">) => TailordbKysely<NS[N$1]>;
+type NamespaceTransaction<NS, K extends keyof NS | TailordbKysely<NS[keyof NS]> = keyof NS> = K extends TailordbKysely<infer DB> ? Transaction$1<DB> : K extends keyof NS ? Transaction$1<NS[K]> : never;
+type NamespaceTableName<NS> = { [N in keyof NS]: keyof NS[N] }[keyof NS];
+type NamespaceTable<NS, T extends NamespaceTableName<NS>> = { [N in keyof NS]: T extends keyof NS[N] ? NS[N][T] : never }[keyof NS];
+type NamespaceInsertable<NS, T extends NamespaceTableName<NS>> = Insertable$1<NamespaceTable<NS, T>>;
+type NamespaceSelectable<NS, T extends NamespaceTableName<NS>> = Selectable$1<NamespaceTable<NS, T>>;
+type NamespaceUpdateable<NS, T extends NamespaceTableName<NS>> = Updateable$1<NamespaceTable<NS, T>>;
+//#endregion
+export { type ColumnType, Generated, type Insertable, Kysely, type KyselyConfig, NamespaceDB, NamespaceInsertable, NamespaceSelectable, NamespaceTable, NamespaceTableName, NamespaceTransaction, NamespaceUpdateable, type Selectable, Serial, TailordbDialect, TailordbKysely, Timestamp, type Transaction, type Updateable, createGetDB };
+//# sourceMappingURL=index.d.mts.map

package/dist/kysely/index.mjs

@@ -0,0 +1,27 @@
+import { TailordbDialect, TailordbDialect as TailordbDialect$1 } from "@tailor-platform/function-kysely-tailordb";
+import { Kysely, Kysely as Kysely$1 } from "kysely";
+
+//#region src/kysely/index.ts
+/**
+* Kysely integration module for generated TailorDB code.
+*
+* Re-exports kysely and function-kysely-tailordb types through a single import path
+* to avoid phantom dependency issues with pnpm, and provides namespace-aware
+* utility types and factory functions used by the code generator.
+*/
+/**
+* Create a namespace-aware getDB function for generated code.
+* @returns A getDB function that creates Kysely instances for specific namespaces
+*/
+function createGetDB() {
+	return function getDB(namespace, config) {
+		return new Kysely$1({
+			dialect: new TailordbDialect$1(new tailordb.Client({ namespace })),
+			...config
+		});
+	};
+}
+
+//#endregion
+export { Kysely, TailordbDialect, createGetDB };
+//# sourceMappingURL=index.mjs.map

package/dist/kysely/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["Kysely","TailordbDialect"],"sources":["../../src/kysely/index.ts"],"sourcesContent":["/**\n * Kysely integration module for generated TailorDB code.\n *\n * Re-exports kysely and function-kysely-tailordb types through a single import path\n * to avoid phantom dependency issues with pnpm, and provides namespace-aware\n * utility types and factory functions used by the code generator.\n */\n\nimport { TailordbDialect } from \"@tailor-platform/function-kysely-tailordb\";\nimport {\n  type ColumnType,\n  Kysely,\n  type Insertable,\n  type KyselyConfig,\n  type Selectable,\n  type Transaction as KyselyTransaction,\n  type Updateable,\n} from \"kysely\";\n\nexport {\n  type ColumnType,\n  Kysely,\n  type KyselyConfig,\n  type Transaction,\n  type Insertable,\n  type Selectable,\n  type Updateable,\n} from \"kysely\";\n\nexport { TailordbDialect } from \"@tailor-platform/function-kysely-tailordb\";\n\nexport type Timestamp = ColumnType<Date, Date | string, Date | string>;\nexport type Generated<T> =\n  T extends ColumnType<infer S, infer I, infer U>\n    ? ColumnType<S, I | undefined, U>\n    : ColumnType<T, T | undefined, T>;\nexport type Serial<T = string | number> = ColumnType<T, never, never>;\n\nexport type TailordbKysely<DB> = Kysely<DB>;\nexport type NamespaceDB<NS, N extends keyof NS = keyof NS> = TailordbKysely<NS[N]>;\n\n/**\n * Create a namespace-aware getDB function for generated code.\n * @returns A getDB function that creates Kysely instances for specific namespaces\n */\nexport function createGetDB<NS>() {\n  return function getDB<const N extends keyof NS & string>(\n    namespace: N,\n    config?: Omit<KyselyConfig, \"dialect\">,\n  ): TailordbKysely<NS[N]> {\n    const client = new tailordb.Client({ namespace });\n    return new Kysely<NS[N]>({\n      dialect: new TailordbDialect(client),\n      ...config,\n    });\n  };\n}\n\nexport type NamespaceTransaction<NS, K extends keyof NS | TailordbKysely<NS[keyof NS]> = keyof NS> =\n  K extends TailordbKysely<infer DB>\n    ? KyselyTransaction<DB>\n    : K extends keyof NS\n      ? KyselyTransaction<NS[K]>\n      : never;\n\nexport type NamespaceTableName<NS> = {\n  [N in keyof NS]: keyof NS[N];\n}[keyof NS];\n\nexport type NamespaceTable<NS, T extends NamespaceTableName<NS>> = {\n  [N in keyof NS]: T extends keyof NS[N] ? NS[N][T] : never;\n}[keyof NS];\n\nexport type NamespaceInsertable<NS, T extends NamespaceTableName<NS>> = Insertable<\n  NamespaceTable<NS, T>\n>;\nexport type NamespaceSelectable<NS, T extends NamespaceTableName<NS>> = Selectable<\n  NamespaceTable<NS, T>\n>;\nexport type NamespaceUpdateable<NS, T extends NamespaceTableName<NS>> = Updateable<\n  NamespaceTable<NS, T>\n>;\n"],"mappings":";;;;;;;;;;;;;;;AA6CA,SAAgB,cAAkB;AAChC,QAAO,SAAS,MACd,WACA,QACuB;AAEvB,SAAO,IAAIA,SAAc;GACvB,SAAS,IAAIC,kBAFA,IAAI,SAAS,OAAO,EAAE,WAAW,CAAC,CAEX;GACpC,GAAG;GACJ,CAAC"}

package/dist/plugin/index.d.mts

@@ -0,0 +1,105 @@
+/// <reference path="./../user-defined.d.ts" />
+import { n as TailorEnv, r as TailorActor } from "../env-4RO7szrH.mjs";
+
+//#region src/plugin/with-context.d.ts
+
+/**
+ * Plugin executor factory function type.
+ * Takes context and returns an executor configuration.
+ * Returns unknown since the exact return type depends on createExecutor's generic params.
+ */
+type PluginExecutorFactory<Ctx> = (ctx: Ctx) => unknown;
+/**
+ * Base args for plugin executor function operations.
+ * Provides typed access to runtime context without requiring specific record types.
+ */
+interface PluginFunctionArgs {
+  /** Workspace ID where the executor runs */
+  workspaceId: string;
+  /** Application namespace */
+  appNamespace: string;
+  /** Environment variables */
+  env: TailorEnv;
+  /** Actor (user) who triggered the event, null for system events */
+  actor: TailorActor | null;
+  /** Name of the TailorDB type */
+  typeName: string;
+  /** TailorDB connections by namespace */
+  tailordb: Record<string, unknown>;
+}
+/**
+ * Args for plugin executors triggered on record creation.
+ */
+interface PluginRecordCreatedArgs extends PluginFunctionArgs {
+  /** The newly created record */
+  newRecord: Record<string, unknown>;
+}
+/**
+ * Args for plugin executors triggered on record update.
+ */
+interface PluginRecordUpdatedArgs extends PluginFunctionArgs {
+  /** The record after update */
+  newRecord: Record<string, unknown>;
+  /** The record before update */
+  oldRecord: Record<string, unknown>;
+}
+/**
+ * Args for plugin executors triggered on record deletion.
+ */
+interface PluginRecordDeletedArgs extends PluginFunctionArgs {
+  /** The deleted record */
+  oldRecord: Record<string, unknown>;
+}
+/**
+ * Database schema type for plugins.
+ * Since plugins work with dynamic types, the schema uses Record types.
+ */
+type PluginDBSchema = Record<string, Record<string, unknown>>;
+/**
+ * Base record type for TailorDB records.
+ * All records have an id field.
+ */
+type PluginRecord = {
+  id: string;
+} & Record<string, unknown>;
+/**
+ * Define a plugin executor that receives context at runtime.
+ * This allows executor definitions to be in separate files while
+ * still receiving dynamic values like typeName, generated types, and namespace.
+ * @param factory - Function that takes context and returns executor configuration
+ * @returns The same factory function (for type inference)
+ * @example
+ * ```typescript
+ * // executors/on-create.ts
+ * import { withPluginContext } from "@tailor-platform/sdk/plugin";
+ * import { createExecutor, recordCreatedTrigger } from "@tailor-platform/sdk";
+ * import { getDB } from "@tailor-platform/function-kysely-tailordb";
+ *
+ * interface MyContext {
+ *   sourceType: TailorAnyDBType;
+ *   historyType: TailorAnyDBType;
+ *   namespace: string;
+ * }
+ *
+ * export default withPluginContext<MyContext>((ctx) =>
+ *   createExecutor({
+ *     name: `${ctx.sourceType.name.toLowerCase()}-on-create`,
+ *     trigger: recordCreatedTrigger({ type: ctx.sourceType }),
+ *     operation: {
+ *       kind: "function",
+ *       body: async (args) => {
+ *         const db = getDB(ctx.namespace);
+ *         await db.insertInto(ctx.historyType.name).values({
+ *           recordId: args.newRecord.id,
+ *           // ...
+ *         }).execute();
+ *       },
+ *     },
+ *   })
+ * );
+ * ```
+ */
+declare function withPluginContext<Ctx>(factory: PluginExecutorFactory<Ctx>): PluginExecutorFactory<Ctx>;
+//#endregion
+export { type PluginDBSchema, type PluginExecutorFactory, type PluginFunctionArgs, type PluginRecord, type PluginRecordCreatedArgs, type PluginRecordDeletedArgs, type PluginRecordUpdatedArgs, withPluginContext };
+//# sourceMappingURL=index.d.mts.map

package/dist/plugin/index.mjs

@@ -0,0 +1,45 @@
+//#region src/plugin/with-context.ts
+/**
+* Define a plugin executor that receives context at runtime.
+* This allows executor definitions to be in separate files while
+* still receiving dynamic values like typeName, generated types, and namespace.
+* @param factory - Function that takes context and returns executor configuration
+* @returns The same factory function (for type inference)
+* @example
+* ```typescript
+* // executors/on-create.ts
+* import { withPluginContext } from "@tailor-platform/sdk/plugin";
+* import { createExecutor, recordCreatedTrigger } from "@tailor-platform/sdk";
+* import { getDB } from "@tailor-platform/function-kysely-tailordb";
+*
+* interface MyContext {
+*   sourceType: TailorAnyDBType;
+*   historyType: TailorAnyDBType;
+*   namespace: string;
+* }
+*
+* export default withPluginContext<MyContext>((ctx) =>
+*   createExecutor({
+*     name: `${ctx.sourceType.name.toLowerCase()}-on-create`,
+*     trigger: recordCreatedTrigger({ type: ctx.sourceType }),
+*     operation: {
+*       kind: "function",
+*       body: async (args) => {
+*         const db = getDB(ctx.namespace);
+*         await db.insertInto(ctx.historyType.name).values({
+*           recordId: args.newRecord.id,
+*           // ...
+*         }).execute();
+*       },
+*     },
+*   })
+* );
+* ```
+*/
+function withPluginContext(factory) {
+	return factory;
+}
+
+//#endregion
+export { withPluginContext };
+//# sourceMappingURL=index.mjs.map

package/dist/plugin/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/plugin/with-context.ts"],"sourcesContent":["/**\n * Plugin executor context support for defining plugin executors in separate files.\n * This module provides utilities for creating type-safe plugin executors that receive\n * context (like type references and namespace) at runtime.\n */\n\nimport type { TailorActor, TailorEnv } from \"@/parser/types\";\n\n/**\n * Plugin executor factory function type.\n * Takes context and returns an executor configuration.\n * Returns unknown since the exact return type depends on createExecutor's generic params.\n */\nexport type PluginExecutorFactory<Ctx> = (ctx: Ctx) => unknown;\n\n// ============================================================================\n// Plugin Executor Args Types\n// ============================================================================\n\n/**\n * Base args for plugin executor function operations.\n * Provides typed access to runtime context without requiring specific record types.\n */\nexport interface PluginFunctionArgs {\n  /** Workspace ID where the executor runs */\n  workspaceId: string;\n  /** Application namespace */\n  appNamespace: string;\n  /** Environment variables */\n  env: TailorEnv;\n  /** Actor (user) who triggered the event, null for system events */\n  actor: TailorActor | null;\n  /** Name of the TailorDB type */\n  typeName: string;\n  /** TailorDB connections by namespace */\n  tailordb: Record<string, unknown>;\n}\n\n/**\n * Args for plugin executors triggered on record creation.\n */\nexport interface PluginRecordCreatedArgs extends PluginFunctionArgs {\n  /** The newly created record */\n  newRecord: Record<string, unknown>;\n}\n\n/**\n * Args for plugin executors triggered on record update.\n */\nexport interface PluginRecordUpdatedArgs extends PluginFunctionArgs {\n  /** The record after update */\n  newRecord: Record<string, unknown>;\n  /** The record before update */\n  oldRecord: Record<string, unknown>;\n}\n\n/**\n * Args for plugin executors triggered on record deletion.\n */\nexport interface PluginRecordDeletedArgs extends PluginFunctionArgs {\n  /** The deleted record */\n  oldRecord: Record<string, unknown>;\n}\n\n/**\n * Database schema type for plugins.\n * Since plugins work with dynamic types, the schema uses Record types.\n */\nexport type PluginDBSchema = Record<string, Record<string, unknown>>;\n\n/**\n * Base record type for TailorDB records.\n * All records have an id field.\n */\nexport type PluginRecord = { id: string } & Record<string, unknown>;\n\n/**\n * Define a plugin executor that receives context at runtime.\n * This allows executor definitions to be in separate files while\n * still receiving dynamic values like typeName, generated types, and namespace.\n * @param factory - Function that takes context and returns executor configuration\n * @returns The same factory function (for type inference)\n * @example\n * ```typescript\n * // executors/on-create.ts\n * import { withPluginContext } from \"@tailor-platform/sdk/plugin\";\n * import { createExecutor, recordCreatedTrigger } from \"@tailor-platform/sdk\";\n * import { getDB } from \"@tailor-platform/function-kysely-tailordb\";\n *\n * interface MyContext {\n *   sourceType: TailorAnyDBType;\n *   historyType: TailorAnyDBType;\n *   namespace: string;\n * }\n *\n * export default withPluginContext<MyContext>((ctx) =>\n *   createExecutor({\n *     name: `${ctx.sourceType.name.toLowerCase()}-on-create`,\n *     trigger: recordCreatedTrigger({ type: ctx.sourceType }),\n *     operation: {\n *       kind: \"function\",\n *       body: async (args) => {\n *         const db = getDB(ctx.namespace);\n *         await db.insertInto(ctx.historyType.name).values({\n *           recordId: args.newRecord.id,\n *           // ...\n *         }).execute();\n *       },\n *     },\n *   })\n * );\n * ```\n */\nexport function withPluginContext<Ctx>(\n  factory: PluginExecutorFactory<Ctx>,\n): PluginExecutorFactory<Ctx> {\n  return factory;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiHA,SAAgB,kBACd,SAC4B;AAC5B,QAAO"}