@tailor-platform/sdk 2.0.0-next.1 → 2.0.0-next.10

package/dist/plugin/builtin/seed/index.d.mts

@@ -1,2 +1,46 @@
-import { n as seedPlugin, t as SeedGeneratorID } from "../../../index-B7AKc18V.mjs";
-export { SeedGeneratorID, seedPlugin };
+import { Plugin } from "../../types.mjs";
+//#region src/plugin/builtin/seed/index.d.ts
+/** Unique identifier for the seed generator plugin. */
+declare const SeedGeneratorID = "@tailor-platform/seed";
+type DisableIdpUserSyncDirections = {
+  /**
+   * Skip emitting the foreign key from `<userProfile>.<usernameField>` to
+   * `_User.name`. Defaults to `false` (FK emitted).
+   *
+   * Set to `true` to seed pre-registration states such as
+   * invited-but-not-registered users.
+   */
+  userToIdp?: boolean;
+  /**
+   * Skip emitting the foreign key from `_User.name` to
+   * `<userProfile>.<usernameField>`. Defaults to `false` (FK emitted).
+   *
+   * Set to `true` to seed `_User` rows that do not yet have a corresponding
+   * userProfile row.
+   */
+  idpToUser?: boolean;
+};
+type SeedPluginOptions = {
+  distPath: string;
+  machineUserName?: string;
+  /**
+   * Disable individual `_User <-> userProfile` foreign keys emitted into
+   * the generated seed schema. Both directions are emitted by default.
+   *
+   * Set a direction to `true` to relax it — for example to seed invited
+   * users that do not yet have an IdP credential.
+   */
+  disableIdpUserSync?: DisableIdpUserSyncDirections;
+};
+/**
+ * Plugin that generates seed data and schema files consumed by the
+ * `tailor seed` commands (@tailor-platform/sdk-plugin-seed).
+ * @param options - Plugin options
+ * @param options.distPath - Output directory path for generated seed files
+ * @param options.machineUserName - Default machine user name for authentication
+ * @param options.disableIdpUserSync - Skip emitting individual `_User <-> userProfile` foreign keys. Both directions are emitted by default; set a direction to `true` to relax that side.
+ * @returns Plugin instance with onTailorDBReady hook
+ */
+declare function seedPlugin(options: SeedPluginOptions): Plugin<unknown, SeedPluginOptions>;
+//#endregion
+export { SeedGeneratorID, SeedPluginOptions, seedPlugin };

package/dist/plugin/builtin/seed/index.mjs

@@ -1,3 +1,3 @@
-import { n as seedPlugin, t as SeedGeneratorID } from "../../../seed-jf3008-h.mjs";
+import { n as seedPlugin, t as SeedGeneratorID } from "../../../seed-LUVr7jHL.mjs";
 
 export { SeedGeneratorID, seedPlugin };

package/dist/plugin/builtin/seed/seed-type-processor.d.mts

@@ -0,0 +1,19 @@
+import "../../../parser/service/tailordb/types.mjs";
+import "../../types.mjs";
+import "./types.mjs";
+//#region src/plugin/builtin/seed/seed-type-processor.d.ts
+/**
+ * Seed ordering information for a TailorDB namespace.
+ */
+interface SeedNamespaceConfig {
+  /** TailorDB namespace name. */
+  namespace: string;
+  /** Type names in the namespace, in definition order. */
+  types: string[];
+  /** Seed dependencies (referenced type names) per type. */
+  dependencies: Record<string, string[]>;
+  /** Types with self-referencing fields, seeded in two passes. */
+  selfRefTypes: string[];
+}
+//#endregion
+export { SeedNamespaceConfig };

package/dist/plugin/builtin/seed/types.d.mts

@@ -0,0 +1,2 @@
+import "../../../parser/service/tailordb/types.mjs";
+import "@toiroakr/lines-db";

package/dist/plugin/get-generated-type.d.mts

@@ -0,0 +1,16 @@
+import { TailorAnyDBType } from "../configure/services/tailordb/types.mjs";
+//#region src/plugin/get-generated-type.d.ts
+/**
+ * Get a generated type from a plugin by loading the config and resolving everything automatically.
+ * For type-attached plugins, calls onTypeLoaded() with the sourceType.
+ * For namespace plugins, calls onNamespaceLoaded() with auto-resolved namespace.
+ * Results are cached per config path, plugin, namespace, and pluginConfig to avoid redundant processing.
+ * @param configPath - Path to tailor.config.ts (absolute or relative to cwd)
+ * @param pluginId - The plugin's unique identifier
+ * @param sourceType - The source TailorDB type (null for namespace plugins)
+ * @param kind - The generated type kind (e.g., "request", "step")
+ * @returns The generated TailorDB type
+ */
+declare function getGeneratedType(configPath: string, pluginId: string, sourceType: TailorAnyDBType | null, kind: string): Promise<TailorAnyDBType>;
+//#endregion
+export { getGeneratedType };

package/dist/plugin/index.d.mts

@@ -1,117 +1,3 @@
-import { B as TailorActor, V as TailorEnv, f as TailorAnyDBType } from "../types-DCUhgpyI.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
-//#region src/plugin/get-generated-type.d.ts
-/**
- * Get a generated type from a plugin by loading the config and resolving everything automatically.
- * For type-attached plugins, calls onTypeLoaded() with the sourceType.
- * For namespace plugins, calls onNamespaceLoaded() with auto-resolved namespace.
- * Results are cached per config path, plugin, namespace, and pluginConfig to avoid redundant processing.
- * @param configPath - Path to tailor.config.ts (absolute or relative to cwd)
- * @param pluginId - The plugin's unique identifier
- * @param sourceType - The source TailorDB type (null for namespace plugins)
- * @param kind - The generated type kind (e.g., "request", "step")
- * @returns The generated TailorDB type
- */
-declare function getGeneratedType(configPath: string, pluginId: string, sourceType: TailorAnyDBType | null, kind: string): Promise<TailorAnyDBType>;
-//#endregion
-export { type PluginDBSchema, type PluginExecutorFactory, type PluginFunctionArgs, type PluginRecord, type PluginRecordCreatedArgs, type PluginRecordDeletedArgs, type PluginRecordUpdatedArgs, getGeneratedType, withPluginContext };
-//# sourceMappingURL=index.d.mts.map
+import { PluginDBSchema, PluginExecutorFactory, PluginFunctionArgs, PluginRecord, PluginRecordCreatedArgs, PluginRecordDeletedArgs, PluginRecordUpdatedArgs, withPluginContext } from "./with-context.mjs";
+import { getGeneratedType } from "./get-generated-type.mjs";
+export { type PluginDBSchema, type PluginExecutorFactory, type PluginFunctionArgs, type PluginRecord, type PluginRecordCreatedArgs, type PluginRecordDeletedArgs, type PluginRecordUpdatedArgs, getGeneratedType, withPluginContext };

package/dist/plugin/index.mjs

@@ -1,5 +1,5 @@
-import * as fs from "node:fs";
 import * as path from "pathe";
+import * as fs from "node:fs";
 import { pathToFileURL } from "node:url";
 
 //#region src/plugin/with-context.ts

package/dist/plugin/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/plugin/with-context.ts","../../src/plugin/get-generated-type.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 \"@/runtime/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","import * as fs from \"node:fs\";\nimport { pathToFileURL } from \"node:url\";\nimport * as path from \"pathe\";\nimport type { TailorAnyDBType } from \"@/configure/services/tailordb/types\";\nimport type { Plugin, PluginOutput, TypePluginOutput } from \"@/plugin/types\";\n\n// ========================================\n// Config loading and caching\n// ========================================\n\ninterface PluginEntry {\n  plugin: Plugin;\n  pluginConfig: unknown;\n}\n\ninterface ConfigCache {\n  config: { db?: Record<string, unknown> };\n  plugins: Map<string, PluginEntry>;\n  configDir: string;\n}\n\n/** Cache: resolved config path -> loaded config data */\nconst configCacheMap = new Map<string, ConfigCache>();\n\n/**\n * Check if a value is a Plugin instance.\n * @param value - Value to check\n * @returns True if value has the shape of Plugin\n */\nfunction isPlugin(value: unknown): value is Plugin {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as Record<string, unknown>).id === \"string\" &&\n    typeof (value as Record<string, unknown>).description === \"string\"\n  );\n}\n\n/**\n * Load and cache config module from the given path.\n * Extracts plugins from all array exports using definePlugins() format.\n * Returns null if the config file does not exist (e.g., in bundled executor on platform server).\n * @param configPath - Absolute or relative path to tailor.config.ts\n * @returns Cached config data with plugins map, or null if config file is not available\n */\nasync function loadAndCacheConfig(configPath: string): Promise<ConfigCache | null> {\n  const resolvedPath = path.resolve(configPath);\n\n  const cached = configCacheMap.get(resolvedPath);\n  if (cached) return cached;\n\n  // Config file may not exist in bundled environments (e.g., platform server)\n  if (!fs.existsSync(resolvedPath)) {\n    return null;\n  }\n\n  const configModule = await import(pathToFileURL(resolvedPath).href);\n  if (!configModule?.default) {\n    throw new Error(`Invalid config module at \"${resolvedPath}\": default export not found`);\n  }\n\n  const config = configModule.default as { db?: Record<string, unknown> };\n  const configDir = path.dirname(resolvedPath);\n  const plugins = new Map<string, PluginEntry>();\n\n  // Find plugin arrays from exports (definePlugins returns PluginConfig[])\n  for (const value of Object.values(configModule)) {\n    if (!Array.isArray(value)) continue;\n\n    for (const item of value) {\n      if (isPlugin(item)) {\n        plugins.set(item.id, { plugin: item, pluginConfig: item.pluginConfig });\n      }\n    }\n  }\n\n  const result: ConfigCache = { config, plugins, configDir };\n  configCacheMap.set(resolvedPath, result);\n  return result;\n}\n\n// ========================================\n// Namespace resolution\n// ========================================\n\ninterface DbNamespaceConfig {\n  files?: string[];\n  external?: boolean;\n}\n\n/**\n * Resolve the namespace for a type-attached sourceType by checking config.db file patterns.\n * Uses ESM module cache identity: same file path yields same object references.\n * @param config - App config with db namespace definitions\n * @param config.db - DB namespace definitions\n * @param configDir - Directory containing the config file\n * @param sourceType - The TailorDB type to look up\n * @returns The namespace name\n */\nasync function resolveNamespaceForType(\n  config: { db?: Record<string, unknown> },\n  configDir: string,\n  sourceType: TailorAnyDBType,\n): Promise<string> {\n  if (!config.db) {\n    throw new Error(`No db configuration found in config`);\n  }\n\n  for (const [namespace, nsConfig] of Object.entries(config.db)) {\n    const dbConfig = nsConfig as DbNamespaceConfig;\n    // Skip external namespaces (no files to resolve)\n    if (dbConfig.external || !dbConfig.files) continue;\n\n    for (const pattern of dbConfig.files) {\n      const absolutePattern = path.resolve(configDir, pattern);\n      let matchedFiles: string[];\n      try {\n        matchedFiles = fs.globSync(absolutePattern);\n      } catch {\n        continue;\n      }\n\n      for (const file of matchedFiles) {\n        const mod = await import(pathToFileURL(file).href);\n        for (const exported of Object.values(mod)) {\n          if (exported === sourceType) {\n            return namespace;\n          }\n        }\n      }\n    }\n  }\n\n  throw new Error(\n    `Could not resolve namespace for type \"${sourceType.name}\". ` +\n      `Ensure the type file is included in a db namespace's files pattern.`,\n  );\n}\n\n/**\n * Resolve the namespace for a namespace plugin by trying each namespace.\n * Calls onNamespaceLoaded() for each and returns the first whose output contains the requested kind.\n * @param config - App config with db namespace definitions\n * @param config.db - DB namespace definitions\n * @param plugin - Plugin instance\n * @param kind - The generated type kind to look for\n * @param pluginConfig - Plugin-level configuration\n * @returns The namespace name\n */\nasync function resolveNamespaceForNamespacePlugin(\n  config: { db?: Record<string, unknown> },\n  plugin: Plugin,\n  kind: string,\n  pluginConfig: unknown,\n): Promise<{ namespace: string; output: PluginOutput }> {\n  if (!config.db) {\n    throw new Error(`No db configuration found in config`);\n  }\n\n  if (!plugin.onNamespaceLoaded) {\n    throw new Error(`Plugin \"${plugin.id}\" does not have a onNamespaceLoaded() method`);\n  }\n\n  for (const namespace of Object.keys(config.db)) {\n    const dbConfig = config.db[namespace] as DbNamespaceConfig;\n    if (dbConfig.external) continue;\n\n    const output = await plugin.onNamespaceLoaded({\n      pluginConfig,\n      namespace,\n    });\n\n    if (output.types?.[kind]) {\n      return { namespace, output };\n    }\n  }\n\n  throw new Error(\n    `Could not resolve namespace for plugin \"${plugin.id}\" with kind \"${kind}\". ` +\n      `No namespace produced a type with that kind.`,\n  );\n}\n\n// ========================================\n// Process caching\n// ========================================\n\n// Cache: plugin -> cacheKey -> TypePluginOutput\nconst processCache = new WeakMap<Plugin, Map<string, TypePluginOutput>>();\n\n// Cache for namespace plugins: plugin -> cacheKey -> PluginOutput\nconst namespaceProcessCache = new WeakMap<Plugin, Map<string, PluginOutput>>();\n\n/**\n * Generate a cache key that includes pluginConfig.\n * @param baseKey - Base key for the cache\n * @param pluginConfig - Plugin configuration to include in the key\n * @returns Cache key string\n */\nfunction getCacheKey(baseKey: string, pluginConfig: unknown): string {\n  if (pluginConfig === undefined) {\n    return baseKey;\n  }\n  try {\n    return `${baseKey}:${JSON.stringify(pluginConfig)}`;\n  } catch {\n    throw new Error(\n      `pluginConfig must be JSON-serializable for caching. Received non-serializable value.`,\n    );\n  }\n}\n\n// ========================================\n// Main API\n// ========================================\n\n/**\n * Get a generated type from a plugin by loading the config and resolving everything automatically.\n * For type-attached plugins, calls onTypeLoaded() with the sourceType.\n * For namespace plugins, calls onNamespaceLoaded() with auto-resolved namespace.\n * Results are cached per config path, plugin, namespace, and pluginConfig to avoid redundant processing.\n * @param configPath - Path to tailor.config.ts (absolute or relative to cwd)\n * @param pluginId - The plugin's unique identifier\n * @param sourceType - The source TailorDB type (null for namespace plugins)\n * @param kind - The generated type kind (e.g., \"request\", \"step\")\n * @returns The generated TailorDB type\n */\nexport async function getGeneratedType(\n  configPath: string,\n  pluginId: string,\n  sourceType: TailorAnyDBType | null,\n  kind: string,\n): Promise<TailorAnyDBType> {\n  const cache = await loadAndCacheConfig(configPath);\n\n  if (!cache) {\n    // Config not available (e.g., running in bundled executor on platform server).\n    // Return a placeholder. The actual type is resolved at generate/apply time.\n    return { name: `__placeholder_${kind}__`, fields: {} } as TailorAnyDBType;\n  }\n\n  const { config, configDir, plugins } = cache;\n\n  const pluginEntry = plugins.get(pluginId);\n  if (!pluginEntry) {\n    throw new Error(\n      `Plugin \"${pluginId}\" not found in config at \"${configPath}\". ` +\n        `Ensure the plugin is registered via definePlugins().`,\n    );\n  }\n\n  const { plugin, pluginConfig } = pluginEntry;\n\n  if (sourceType === null) {\n    return getGeneratedTypeForNamespacePlugin(config, plugin, kind, pluginConfig);\n  }\n\n  const namespace = await resolveNamespaceForType(config, configDir, sourceType);\n  return getGeneratedTypeForTypeAttachedPlugin(plugin, sourceType, kind, pluginConfig, namespace);\n}\n\n/**\n * Get a generated type from a type-attached plugin.\n * @param plugin - The plugin instance (must have onTypeLoaded() method)\n * @param sourceType - The source TailorDB type\n * @param kind - The generated type kind\n * @param pluginConfig - Plugin-level configuration\n * @param namespace - Resolved namespace\n * @returns The generated TailorDB type\n */\nasync function getGeneratedTypeForTypeAttachedPlugin(\n  plugin: Plugin,\n  sourceType: TailorAnyDBType,\n  kind: string,\n  pluginConfig: unknown,\n  namespace: string,\n): Promise<TailorAnyDBType> {\n  if (!plugin.onTypeLoaded) {\n    throw new Error(`Plugin \"${plugin.id}\" does not have a onTypeLoaded() method`);\n  }\n\n  // Check cache first\n  let pluginCache = processCache.get(plugin);\n  if (!pluginCache) {\n    pluginCache = new Map();\n    processCache.set(plugin, pluginCache);\n  }\n\n  const cacheKey = getCacheKey(`${sourceType.name}:ns=${namespace}`, pluginConfig);\n  let output = pluginCache.get(cacheKey);\n\n  if (!output) {\n    const typeConfig = sourceType.plugins.find((p) => p.pluginId === plugin.id)?.config;\n    output = await plugin.onTypeLoaded({\n      type: sourceType,\n      typeConfig: typeConfig ?? {},\n      pluginConfig,\n      namespace,\n    });\n    pluginCache.set(cacheKey, output);\n  }\n\n  const generatedType = output.types?.[kind];\n  if (!generatedType) {\n    throw new Error(\n      `Generated type not found: plugin=${plugin.id}, sourceType=${sourceType.name}, kind=${kind}`,\n    );\n  }\n\n  return generatedType as TailorAnyDBType;\n}\n\n/**\n * Get a generated type from a namespace plugin.\n * Auto-resolves the namespace by trying each one.\n * @param config - App config with db namespace definitions\n * @param config.db - DB namespace definitions\n * @param plugin - The plugin instance (must have onNamespaceLoaded() method)\n * @param kind - The generated type kind\n * @param pluginConfig - Plugin-level configuration\n * @returns The generated TailorDB type\n */\nasync function getGeneratedTypeForNamespacePlugin(\n  config: { db?: Record<string, unknown> },\n  plugin: Plugin,\n  kind: string,\n  pluginConfig: unknown,\n): Promise<TailorAnyDBType> {\n  if (!plugin.onNamespaceLoaded) {\n    throw new Error(`Plugin \"${plugin.id}\" does not have a onNamespaceLoaded() method`);\n  }\n\n  // Check cache first - try all namespaces\n  let pluginCache = namespaceProcessCache.get(plugin);\n  if (!pluginCache) {\n    pluginCache = new Map();\n    namespaceProcessCache.set(plugin, pluginCache);\n  }\n\n  // Try cached results first\n  if (config.db) {\n    for (const namespace of Object.keys(config.db)) {\n      const dbConfig = config.db[namespace] as DbNamespaceConfig;\n      if (dbConfig.external) continue;\n\n      const cacheKey = getCacheKey(`namespace:ns=${namespace}`, pluginConfig);\n      const cached = pluginCache.get(cacheKey);\n      if (cached?.types?.[kind]) {\n        return cached.types[kind] as TailorAnyDBType;\n      }\n    }\n  }\n\n  // Not in cache - resolve namespace and process\n  const { namespace, output } = await resolveNamespaceForNamespacePlugin(\n    config,\n    plugin,\n    kind,\n    pluginConfig,\n  );\n\n  const cacheKey = getCacheKey(`namespace:ns=${namespace}`, pluginConfig);\n  pluginCache.set(cacheKey, output);\n\n  const generatedType = output.types?.[kind];\n  if (!generatedType) {\n    throw new Error(`Generated type not found: plugin=${plugin.id}, kind=${kind}`);\n  }\n\n  return generatedType as TailorAnyDBType;\n}\n\n/**\n * Clear all internal caches. For testing only.\n */\nexport function _clearCacheForTesting(): void {\n  configCacheMap.clear();\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/plugin/with-context.ts","../../src/plugin/get-generated-type.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 { TailorEnv, TailorPrincipal } from \"#/runtime/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  /** Principal that triggered the event, null for system events */\n  actor: TailorPrincipal | 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","import * as fs from \"node:fs\";\nimport { pathToFileURL } from \"node:url\";\nimport * as path from \"pathe\";\nimport type { TailorAnyDBType } from \"#/configure/services/tailordb/types\";\nimport type { Plugin, PluginOutput, TypePluginOutput } from \"#/plugin/types\";\n\n// ========================================\n// Config loading and caching\n// ========================================\n\ninterface PluginEntry {\n  plugin: Plugin;\n  pluginConfig: unknown;\n}\n\ninterface ConfigCache {\n  config: { db?: Record<string, unknown> };\n  plugins: Map<string, PluginEntry>;\n  configDir: string;\n}\n\n/** Cache: resolved config path -> loaded config data */\nconst configCacheMap = new Map<string, ConfigCache>();\n\n/**\n * Check if a value is a Plugin instance.\n * @param value - Value to check\n * @returns True if value has the shape of Plugin\n */\nfunction isPlugin(value: unknown): value is Plugin {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as Record<string, unknown>).id === \"string\" &&\n    typeof (value as Record<string, unknown>).description === \"string\"\n  );\n}\n\n/**\n * Load and cache config module from the given path.\n * Extracts plugins from all array exports using definePlugins() format.\n * Returns null if the config file does not exist (e.g., in bundled executor on platform server).\n * @param configPath - Absolute or relative path to tailor.config.ts\n * @returns Cached config data with plugins map, or null if config file is not available\n */\nasync function loadAndCacheConfig(configPath: string): Promise<ConfigCache | null> {\n  const resolvedPath = path.resolve(configPath);\n\n  const cached = configCacheMap.get(resolvedPath);\n  if (cached) return cached;\n\n  // Config file may not exist in bundled environments (e.g., platform server)\n  if (!fs.existsSync(resolvedPath)) {\n    return null;\n  }\n\n  const configModule = await import(pathToFileURL(resolvedPath).href);\n  if (!configModule?.default) {\n    throw new Error(`Invalid config module at \"${resolvedPath}\": default export not found`);\n  }\n\n  const config = configModule.default as { db?: Record<string, unknown> };\n  const configDir = path.dirname(resolvedPath);\n  const plugins = new Map<string, PluginEntry>();\n\n  // Find plugin arrays from exports (definePlugins returns PluginConfig[])\n  for (const value of Object.values(configModule)) {\n    if (!Array.isArray(value)) continue;\n\n    for (const item of value) {\n      if (isPlugin(item)) {\n        plugins.set(item.id, { plugin: item, pluginConfig: item.pluginConfig });\n      }\n    }\n  }\n\n  const result: ConfigCache = { config, plugins, configDir };\n  configCacheMap.set(resolvedPath, result);\n  return result;\n}\n\n// ========================================\n// Namespace resolution\n// ========================================\n\ninterface DbNamespaceConfig {\n  files?: string[];\n  external?: boolean;\n}\n\n/**\n * Resolve the namespace for a type-attached sourceType by checking config.db file patterns.\n * Uses ESM module cache identity: same file path yields same object references.\n * @param config - App config with db namespace definitions\n * @param config.db - DB namespace definitions\n * @param configDir - Directory containing the config file\n * @param sourceType - The TailorDB type to look up\n * @returns The namespace name\n */\nasync function resolveNamespaceForType(\n  config: { db?: Record<string, unknown> },\n  configDir: string,\n  sourceType: TailorAnyDBType,\n): Promise<string> {\n  if (!config.db) {\n    throw new Error(`No db configuration found in config`);\n  }\n\n  for (const [namespace, nsConfig] of Object.entries(config.db)) {\n    const dbConfig = nsConfig as DbNamespaceConfig;\n    // Skip external namespaces (no files to resolve)\n    if (dbConfig.external || !dbConfig.files) continue;\n\n    for (const pattern of dbConfig.files) {\n      const absolutePattern = path.resolve(configDir, pattern);\n      let matchedFiles: string[];\n      try {\n        matchedFiles = fs.globSync(absolutePattern);\n      } catch {\n        continue;\n      }\n\n      for (const file of matchedFiles) {\n        const mod = await import(pathToFileURL(file).href);\n        for (const exported of Object.values(mod)) {\n          if (exported === sourceType) {\n            return namespace;\n          }\n        }\n      }\n    }\n  }\n\n  throw new Error(\n    `Could not resolve namespace for type \"${sourceType.name}\". ` +\n      `Ensure the type file is included in a db namespace's files pattern.`,\n  );\n}\n\n/**\n * Resolve the namespace for a namespace plugin by trying each namespace.\n * Calls onNamespaceLoaded() for each and returns the first whose output contains the requested kind.\n * @param config - App config with db namespace definitions\n * @param config.db - DB namespace definitions\n * @param plugin - Plugin instance\n * @param kind - The generated type kind to look for\n * @param pluginConfig - Plugin-level configuration\n * @returns The namespace name\n */\nasync function resolveNamespaceForNamespacePlugin(\n  config: { db?: Record<string, unknown> },\n  plugin: Plugin,\n  kind: string,\n  pluginConfig: unknown,\n): Promise<{ namespace: string; output: PluginOutput }> {\n  if (!config.db) {\n    throw new Error(`No db configuration found in config`);\n  }\n\n  if (!plugin.onNamespaceLoaded) {\n    throw new Error(`Plugin \"${plugin.id}\" does not have a onNamespaceLoaded() method`);\n  }\n\n  for (const namespace of Object.keys(config.db)) {\n    const dbConfig = config.db[namespace] as DbNamespaceConfig;\n    if (dbConfig.external) continue;\n\n    const output = await plugin.onNamespaceLoaded({\n      pluginConfig,\n      namespace,\n    });\n\n    if (output.types?.[kind]) {\n      return { namespace, output };\n    }\n  }\n\n  throw new Error(\n    `Could not resolve namespace for plugin \"${plugin.id}\" with kind \"${kind}\". ` +\n      `No namespace produced a type with that kind.`,\n  );\n}\n\n// ========================================\n// Process caching\n// ========================================\n\n// Cache: plugin -> cacheKey -> TypePluginOutput\nconst processCache = new WeakMap<Plugin, Map<string, TypePluginOutput>>();\n\n// Cache for namespace plugins: plugin -> cacheKey -> PluginOutput\nconst namespaceProcessCache = new WeakMap<Plugin, Map<string, PluginOutput>>();\n\n/**\n * Generate a cache key that includes pluginConfig.\n * @param baseKey - Base key for the cache\n * @param pluginConfig - Plugin configuration to include in the key\n * @returns Cache key string\n */\nfunction getCacheKey(baseKey: string, pluginConfig: unknown): string {\n  if (pluginConfig === undefined) {\n    return baseKey;\n  }\n  try {\n    return `${baseKey}:${JSON.stringify(pluginConfig)}`;\n  } catch {\n    throw new Error(\n      `pluginConfig must be JSON-serializable for caching. Received non-serializable value.`,\n    );\n  }\n}\n\n// ========================================\n// Main API\n// ========================================\n\n/**\n * Get a generated type from a plugin by loading the config and resolving everything automatically.\n * For type-attached plugins, calls onTypeLoaded() with the sourceType.\n * For namespace plugins, calls onNamespaceLoaded() with auto-resolved namespace.\n * Results are cached per config path, plugin, namespace, and pluginConfig to avoid redundant processing.\n * @param configPath - Path to tailor.config.ts (absolute or relative to cwd)\n * @param pluginId - The plugin's unique identifier\n * @param sourceType - The source TailorDB type (null for namespace plugins)\n * @param kind - The generated type kind (e.g., \"request\", \"step\")\n * @returns The generated TailorDB type\n */\nexport async function getGeneratedType(\n  configPath: string,\n  pluginId: string,\n  sourceType: TailorAnyDBType | null,\n  kind: string,\n): Promise<TailorAnyDBType> {\n  const cache = await loadAndCacheConfig(configPath);\n\n  if (!cache) {\n    // Config not available (e.g., running in bundled executor on platform server).\n    // Return a placeholder. The actual type is resolved at generate/apply time.\n    return { name: `__placeholder_${kind}__`, fields: {} } as TailorAnyDBType;\n  }\n\n  const { config, configDir, plugins } = cache;\n\n  const pluginEntry = plugins.get(pluginId);\n  if (!pluginEntry) {\n    throw new Error(\n      `Plugin \"${pluginId}\" not found in config at \"${configPath}\". ` +\n        `Ensure the plugin is registered via definePlugins().`,\n    );\n  }\n\n  const { plugin, pluginConfig } = pluginEntry;\n\n  if (sourceType === null) {\n    return getGeneratedTypeForNamespacePlugin(config, plugin, kind, pluginConfig);\n  }\n\n  const namespace = await resolveNamespaceForType(config, configDir, sourceType);\n  return getGeneratedTypeForTypeAttachedPlugin(plugin, sourceType, kind, pluginConfig, namespace);\n}\n\n/**\n * Get a generated type from a type-attached plugin.\n * @param plugin - The plugin instance (must have onTypeLoaded() method)\n * @param sourceType - The source TailorDB type\n * @param kind - The generated type kind\n * @param pluginConfig - Plugin-level configuration\n * @param namespace - Resolved namespace\n * @returns The generated TailorDB type\n */\nasync function getGeneratedTypeForTypeAttachedPlugin(\n  plugin: Plugin,\n  sourceType: TailorAnyDBType,\n  kind: string,\n  pluginConfig: unknown,\n  namespace: string,\n): Promise<TailorAnyDBType> {\n  if (!plugin.onTypeLoaded) {\n    throw new Error(`Plugin \"${plugin.id}\" does not have a onTypeLoaded() method`);\n  }\n\n  // Check cache first\n  let pluginCache = processCache.get(plugin);\n  if (!pluginCache) {\n    pluginCache = new Map();\n    processCache.set(plugin, pluginCache);\n  }\n\n  const cacheKey = getCacheKey(`${sourceType.name}:ns=${namespace}`, pluginConfig);\n  let output = pluginCache.get(cacheKey);\n\n  if (!output) {\n    const typeConfig = sourceType.plugins.find((p) => p.pluginId === plugin.id)?.config;\n    output = await plugin.onTypeLoaded({\n      type: sourceType,\n      typeConfig: typeConfig ?? {},\n      pluginConfig,\n      namespace,\n    });\n    pluginCache.set(cacheKey, output);\n  }\n\n  const generatedType = output.types?.[kind];\n  if (!generatedType) {\n    throw new Error(\n      `Generated type not found: plugin=${plugin.id}, sourceType=${sourceType.name}, kind=${kind}`,\n    );\n  }\n\n  return generatedType as TailorAnyDBType;\n}\n\n/**\n * Get a generated type from a namespace plugin.\n * Auto-resolves the namespace by trying each one.\n * @param config - App config with db namespace definitions\n * @param config.db - DB namespace definitions\n * @param plugin - The plugin instance (must have onNamespaceLoaded() method)\n * @param kind - The generated type kind\n * @param pluginConfig - Plugin-level configuration\n * @returns The generated TailorDB type\n */\nasync function getGeneratedTypeForNamespacePlugin(\n  config: { db?: Record<string, unknown> },\n  plugin: Plugin,\n  kind: string,\n  pluginConfig: unknown,\n): Promise<TailorAnyDBType> {\n  if (!plugin.onNamespaceLoaded) {\n    throw new Error(`Plugin \"${plugin.id}\" does not have a onNamespaceLoaded() method`);\n  }\n\n  // Check cache first - try all namespaces\n  let pluginCache = namespaceProcessCache.get(plugin);\n  if (!pluginCache) {\n    pluginCache = new Map();\n    namespaceProcessCache.set(plugin, pluginCache);\n  }\n\n  // Try cached results first\n  if (config.db) {\n    for (const namespace of Object.keys(config.db)) {\n      const dbConfig = config.db[namespace] as DbNamespaceConfig;\n      if (dbConfig.external) continue;\n\n      const cacheKey = getCacheKey(`namespace:ns=${namespace}`, pluginConfig);\n      const cached = pluginCache.get(cacheKey);\n      if (cached?.types?.[kind]) {\n        return cached.types[kind] as TailorAnyDBType;\n      }\n    }\n  }\n\n  // Not in cache - resolve namespace and process\n  const { namespace, output } = await resolveNamespaceForNamespacePlugin(\n    config,\n    plugin,\n    kind,\n    pluginConfig,\n  );\n\n  const cacheKey = getCacheKey(`namespace:ns=${namespace}`, pluginConfig);\n  pluginCache.set(cacheKey, output);\n\n  const generatedType = output.types?.[kind];\n  if (!generatedType) {\n    throw new Error(`Generated type not found: plugin=${plugin.id}, kind=${kind}`);\n  }\n\n  return generatedType as TailorAnyDBType;\n}\n\n/**\n * Clear all internal caches. For testing only.\n */\nexport function _clearCacheForTesting(): void {\n  configCacheMap.clear();\n}\n"],"mappings":"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"}

package/dist/plugin/manager.d.mts

@@ -0,0 +1,2 @@
+import "./types.mjs";
+import "../configure/services/tailordb/index.mjs";

package/dist/plugin/types.d.mts

@@ -0,0 +1,242 @@
+import { PluginAttachment, TailorAnyDBField, TailorAnyDBType } from "../configure/services/tailordb/types.mjs";
+import { IdProvider, OAuth2Client } from "../types/auth.generated.mjs";
+import { TailorDBType, TypeSourceInfoEntry } from "../parser/service/tailordb/types.mjs";
+import { Executor } from "../types/executor.generated.mjs";
+import { Resolver } from "../types/resolver.generated.mjs";
+//#region src/plugin/types.d.ts
+/**
+ * A single generated file to write to disk.
+ */
+interface GeneratedFile {
+  path: string;
+  content: string;
+  skipIfExists?: boolean;
+  executable?: boolean;
+}
+/**
+ * Result returned by generation-time hooks.
+ */
+interface GeneratorResult {
+  files: GeneratedFile[];
+  errors?: string[];
+}
+/**
+ * Auth configuration available to generation-time hooks.
+ */
+interface GeneratorAuthInput {
+  name: string;
+  userProfile?: {
+    typeName: string;
+    namespace: string;
+    usernameField: string;
+  };
+  machineUsers?: Record<string, {
+    attributes?: Record<string, unknown>;
+  }>;
+  oauth2Clients?: Record<string, OAuth2Client>;
+  idProvider?: IdProvider;
+}
+/**
+ * Namespace-level TailorDB data available to generation-time hooks.
+ */
+interface TailorDBNamespaceData {
+  /** Namespace name */
+  namespace: string;
+  /** All TailorDB types in this namespace, keyed by type name */
+  types: Record<string, TailorDBType>;
+  /** Source info for each type (file path, export name, plugin info) */
+  sourceInfo: ReadonlyMap<string, TypeSourceInfoEntry>;
+  /** Plugin attachments configured on each type via .plugin() method */
+  pluginAttachments: ReadonlyMap<string, readonly PluginAttachment[]>;
+}
+/**
+ * Namespace-level resolver data available to generation-time hooks.
+ */
+interface ResolverNamespaceData {
+  /** Namespace name */
+  namespace: string;
+  /** All resolvers in this namespace, keyed by resolver name */
+  resolvers: Record<string, Resolver>;
+}
+/**
+ * Context passed to plugin's onTailorDBReady hook.
+ * @template PluginConfig - Plugin-level configuration type
+ */
+interface TailorDBReadyContext<PluginConfig = unknown> {
+  /** All TailorDB namespaces with their types and metadata */
+  tailordb: TailorDBNamespaceData[];
+  /** Auth configuration */
+  auth?: GeneratorAuthInput;
+  /** Base directory for generated files */
+  baseDir: string;
+  /** Path to tailor.config.ts */
+  configPath: string;
+  /** Plugin-level configuration passed via definePlugins() */
+  pluginConfig: PluginConfig;
+}
+/**
+ * Context passed to plugin's onResolverReady hook.
+ * @template PluginConfig - Plugin-level configuration type
+ */
+interface ResolverReadyContext<PluginConfig = unknown> {
+  /** All TailorDB namespaces with their types and metadata */
+  tailordb: TailorDBNamespaceData[];
+  /** All resolver namespaces with their resolvers */
+  resolvers: ResolverNamespaceData[];
+  /** Auth configuration */
+  auth?: GeneratorAuthInput;
+  /** Base directory for generated files */
+  baseDir: string;
+  /** Path to tailor.config.ts */
+  configPath: string;
+  /** Plugin-level configuration passed via definePlugins() */
+  pluginConfig: PluginConfig;
+}
+/**
+ * Context passed to plugin's onExecutorReady hook.
+ * @template PluginConfig - Plugin-level configuration type
+ */
+interface ExecutorReadyContext<PluginConfig = unknown> {
+  /** All TailorDB namespaces with their types and metadata */
+  tailordb: TailorDBNamespaceData[];
+  /** All resolver namespaces with their resolvers */
+  resolvers: ResolverNamespaceData[];
+  /** All executors, keyed by executor name */
+  executors: Record<string, Executor>;
+  /** Auth configuration */
+  auth?: GeneratorAuthInput;
+  /** Base directory for generated files */
+  baseDir: string;
+  /** Path to tailor.config.ts */
+  configPath: string;
+  /** Plugin-level configuration passed via definePlugins() */
+  pluginConfig: PluginConfig;
+}
+type TypeConfigRequired<PluginConfig = unknown> = boolean | ((pluginConfig: PluginConfig | undefined) => boolean);
+/**
+ * Interface for plugin configuration mapping.
+ * Extend this interface via declaration merging to add typed plugin configs.
+ */
+interface PluginConfigs<Fields extends string = string> {}
+/**
+ * Context passed to plugin's process method
+ */
+interface PluginProcessContext<TypeConfig = unknown, PluginConfig = unknown> {
+  type: TailorAnyDBType;
+  typeConfig: TypeConfig;
+  pluginConfig: PluginConfig;
+  namespace: string;
+}
+/**
+ * Context passed to plugin's onNamespaceLoaded hook.
+ */
+interface PluginNamespaceProcessContext<PluginConfig = unknown> {
+  pluginConfig: PluginConfig;
+  namespace: string;
+}
+/**
+ * Interface representing a TailorDB type for plugin output.
+ */
+interface TailorDBTypeForPlugin {
+  readonly name: string;
+  readonly fields: Record<string, unknown>;
+}
+type PluginGeneratedType = TailorDBTypeForPlugin;
+type PluginGeneratedTypes = Record<string, PluginGeneratedType>;
+interface PluginGeneratedResolver {
+  name: string;
+  operation: "query" | "mutation";
+  inputFields?: Record<string, unknown>;
+  outputFields: Record<string, unknown>;
+  body: string;
+}
+interface PluginRecordTriggerConfig {
+  kind: "tailordb";
+  events: ("tailordb.type_record.created" | "tailordb.type_record.updated" | "tailordb.type_record.deleted")[];
+  typeName: string;
+}
+interface PluginScheduleTriggerConfig {
+  kind: "schedule";
+  cron: string;
+  timezone?: string;
+}
+interface PluginIncomingWebhookTriggerConfig {
+  kind: "incomingWebhook";
+}
+type PluginTriggerConfig = PluginRecordTriggerConfig | PluginScheduleTriggerConfig | PluginIncomingWebhookTriggerConfig;
+type PluginInjectValue = string | number | boolean | null;
+type PluginInjectMap = Record<string, PluginInjectValue>;
+interface PluginFunctionOperationConfig {
+  kind: "function";
+  body: string;
+  inject?: PluginInjectMap;
+}
+interface PluginGraphQLOperationConfig {
+  kind: "graphql";
+  query: string;
+  appName?: string;
+  variables?: string;
+}
+interface PluginWebhookOperationConfig {
+  kind: "webhook";
+  url: string;
+}
+interface PluginWorkflowOperationConfig {
+  kind: "workflow";
+  workflowName: string;
+}
+type PluginOperationConfig = PluginFunctionOperationConfig | PluginGraphQLOperationConfig | PluginWebhookOperationConfig | PluginWorkflowOperationConfig;
+type PluginExecutorContextValue = TailorAnyDBType | string | number | boolean | null | undefined;
+interface PluginExecutorContextBase {
+  sourceType: TailorAnyDBType | null;
+  namespace: string;
+}
+type PluginExecutorContext = PluginExecutorContextBase & {
+  [key: string]: PluginExecutorContextValue;
+};
+interface PluginExecutorModule {
+  default: unknown;
+}
+interface PluginGeneratedExecutorWithFile<Ctx = PluginExecutorContext> {
+  name: string;
+  resolve: () => Promise<PluginExecutorModule>;
+  context: Ctx;
+}
+interface PluginGeneratedExecutorLegacy {
+  name: string;
+  description?: string;
+  trigger: PluginTriggerConfig;
+  operation: PluginOperationConfig;
+}
+type PluginGeneratedExecutor = PluginGeneratedExecutorWithFile | PluginGeneratedExecutorLegacy;
+interface PluginExtends {
+  fields?: Record<string, TailorAnyDBField>;
+}
+interface PluginOutput {
+  types?: PluginGeneratedTypes;
+  resolvers?: PluginGeneratedResolver[];
+  executors?: PluginGeneratedExecutor[];
+}
+interface TypePluginOutput extends PluginOutput {
+  extends?: PluginExtends;
+}
+type NamespacePluginOutput = PluginOutput;
+/**
+ * Plugin interface that all plugins must implement.
+ * @template TypeConfig - Type for per-type configuration passed via .plugin() method
+ * @template PluginConfig - Type for plugin-level configuration passed via definePlugins()
+ */
+interface Plugin<TypeConfig = unknown, PluginConfig = unknown> {
+  readonly id: string;
+  readonly description: string;
+  readonly importPath?: string;
+  readonly typeConfigRequired?: TypeConfigRequired<PluginConfig>;
+  readonly pluginConfig?: PluginConfig;
+  onTypeLoaded?(context: PluginProcessContext<TypeConfig, PluginConfig>): TypePluginOutput | Promise<TypePluginOutput>;
+  onNamespaceLoaded?(context: PluginNamespaceProcessContext<PluginConfig>): NamespacePluginOutput | Promise<NamespacePluginOutput>;
+  onTailorDBReady?(context: TailorDBReadyContext<PluginConfig>): GeneratorResult | Promise<GeneratorResult>;
+  onResolverReady?(context: ResolverReadyContext<PluginConfig>): GeneratorResult | Promise<GeneratorResult>;
+  onExecutorReady?(context: ExecutorReadyContext<PluginConfig>): GeneratorResult | Promise<GeneratorResult>;
+}
+//#endregion
+export { ExecutorReadyContext, GeneratedFile, GeneratorAuthInput, GeneratorResult, NamespacePluginOutput, Plugin, type PluginAttachment, PluginConfigs, PluginExecutorContext, PluginExecutorContextBase, PluginExecutorContextValue, PluginExecutorModule, PluginExtends, PluginFunctionOperationConfig, PluginGeneratedExecutor, PluginGeneratedExecutorLegacy, PluginGeneratedExecutorWithFile, PluginGeneratedResolver, PluginGeneratedType, PluginGeneratedTypes, PluginGraphQLOperationConfig, PluginIncomingWebhookTriggerConfig, PluginInjectMap, PluginInjectValue, PluginNamespaceProcessContext, PluginOperationConfig, PluginOutput, PluginProcessContext, PluginRecordTriggerConfig, PluginScheduleTriggerConfig, PluginTriggerConfig, PluginWebhookOperationConfig, PluginWorkflowOperationConfig, ResolverNamespaceData, ResolverReadyContext, TailorDBNamespaceData, TailorDBReadyContext, TailorDBTypeForPlugin, TypeConfigRequired, TypePluginOutput };