@tailor-platform/sdk 1.14.2 → 1.15.0

package/dist/{index-q3n7wQOs.d.mts → index-Bs9AsQb2.d.mts}

@@ -1,6 +1,6 @@
 /// <reference path="./user-defined.d.ts" />
-import { $ as ArrayFieldOutput, Ct as AllowedValues, F as Plugin, M as TailorDBType, T as UserAttributeMap, _t as TailorEnv, a as AuthInvoker$1, at as TailorAnyField, et as DefinedFieldMetadata, ht as output$1, it as TailorFieldType, j as TailorDBInstance, l as DefinedAuth, mt as JsonCompatible, nt as FieldOptions, ot as TailorField, pt as InferFieldsOutput, rt as FieldOutput, s as AuthServiceInput, tt as FieldMetadata, ut as ResolverInput, vt as TailorActor, w as UserAttributeListKey, wt as AllowedValuesOutput, xt as TailorUser } from "./types-DbvONSS-.mjs";
-import { C as ScheduleTriggerInput, S as ResolverExecutedTrigger$1, T as WorkflowOperation$1, _ as FunctionOperation$1, b as IncomingWebhookTrigger$1, f as AuthAccessTokenTrigger$1, m as ExecutorInput, n as GeneratorConfig, o as IdPInput, r as AppConfig, s as IdpDefinitionBrand, v as GqlOperation$1, w as WebhookOperation$1, x as RecordTrigger$1, y as IdpUserTrigger$1 } from "./index-YzESrtj0.mjs";
+import { F as Plugin, M as TailorDBType, St as TailorUser, T as UserAttributeMap, Tt as AllowedValuesOutput, a as AuthInvoker$1, at as TailorFieldType, dt as ResolverInput, et as ArrayFieldOutput, gt as output$1, ht as JsonCompatible, it as FieldOutput, j as TailorDBInstance, l as DefinedAuth, mt as InferFieldsOutput, nt as FieldMetadata, ot as TailorAnyField, rt as FieldOptions, s as AuthServiceInput, st as TailorField, tt as DefinedFieldMetadata, vt as TailorEnv, w as UserAttributeListKey, wt as AllowedValues, yt as TailorActor } from "./types-Db1oxr0U.mjs";
+import { C as ScheduleTriggerInput, S as ResolverExecutedTrigger$1, T as WorkflowOperation$1, _ as FunctionOperation$1, b as IncomingWebhookTrigger$1, f as AuthAccessTokenTrigger$1, m as ExecutorInput, n as GeneratorConfig, o as IdPInput, r as AppConfig, s as IdpDefinitionBrand, v as GqlOperation$1, w as WebhookOperation$1, x as RecordTrigger$1, y as IdpUserTrigger$1 } from "./index-DomkP6gz.mjs";
 import * as zod0 from "zod";
 import { JsonPrimitive, Jsonifiable, Jsonify } from "type-fest";
 import * as zod_v4_core0 from "zod/v4/core";
@@ -404,29 +404,45 @@ type Trigger<Args> = RecordTrigger<Args> | ResolverExecutedTrigger<Args> | Sched
  * Extract mainJob's Input type from Workflow.
  */
 type WorkflowInput<W$1 extends Workflow> = Parameters<W$1["trigger"]>[0];
-type ExecutorBase<Args> = Omit<ExecutorInput, "trigger" | "operation"> & {
-  trigger: Trigger<Args>;
+type TriggerArgs<T extends Trigger<unknown>> = T extends {
+  __args: infer Args;
+} ? Args : never;
+type ExecutorBase<T extends Trigger<unknown>> = Omit<ExecutorInput, "trigger" | "operation"> & {
+  trigger: T;
 };
 /**
  * Executor type with conditional inference for workflow operations.
  * When operation.kind is "workflow", infers W from the workflow property
  * to ensure args type matches the workflow's mainJob input type.
  */
-type Executor<Args, O> = O extends {
+type Executor<T extends Trigger<unknown>, O> = O extends {
   kind: "workflow";
   workflow: infer W extends Workflow;
-} ? ExecutorBase<Args> & {
+} ? ExecutorBase<T> & {
   operation: {
     kind: "workflow";
     workflow: W;
-    args?: WorkflowInput<W> | ((args: Args) => WorkflowInput<W>);
+    args?: WorkflowInput<W> | ((args: TriggerArgs<T>) => WorkflowInput<W>);
     authInvoker?: AuthInvoker<string>;
   };
-} : ExecutorBase<Args> & {
+} : ExecutorBase<T> & {
   operation: O;
 };
 /**
  * Create an executor configuration for the Tailor SDK.
+ * @template T
+ * @template O
+ * @param config - Executor configuration
+ * @returns The same executor configuration
+ */
+declare function createExecutor<T extends Trigger<unknown>, O extends Operation<TriggerArgs<T>> | {
+  kind: "workflow";
+  workflow: Workflow;
+}>(config: Executor<T, O>): Executor<T, O>;
+/**
+ * Create an executor configuration for the Tailor SDK.
+ * This overload preserves source compatibility for legacy explicit generic calls,
+ * where the first generic argument represents trigger args.
  * @template Args
  * @template O
  * @param config - Executor configuration
@@ -435,7 +451,7 @@ type Executor<Args, O> = O extends {
 declare function createExecutor<Args, O extends Operation<Args> | {
   kind: "workflow";
   workflow: Workflow;
-}>(config: Executor<Args, O>): Executor<Args, O>;
+}>(config: Executor<Trigger<Args>, O>): Executor<Trigger<Args>, O>;
 //#endregion
 //#region src/configure/services/idp/index.d.ts
 /**
@@ -515,7 +531,7 @@ declare function defineGenerators(...configs: GeneratorConfig[]): (["@tailor-pla
  * @param configs - Plugin configurations
  * @returns Plugin configurations as given
  */
-declare function definePlugins(...configs: Plugin[]): Plugin[];
+declare function definePlugins(...configs: Plugin[]): Plugin<unknown, unknown>[];
 //#endregion
 //#region src/configure/index.d.ts
 type TailorOutput<T> = output$1<T>;
@@ -589,4 +605,4 @@ declare namespace t {
 }
 //#endregion
 export { defineAuth as $, idpUserCreatedTrigger as A, WebhookOperation as B, RecordTrigger as C, authAccessTokenIssuedTrigger as D, ResolverExecutedTrigger as E, recordUpdatedTrigger as F, WORKFLOW_TEST_ENV_KEY as G, Workflow as H, resolverExecutedTrigger as I, WorkflowJobInput as J, WorkflowJob as K, FunctionOperation as L, idpUserUpdatedTrigger as M, recordCreatedTrigger as N, authAccessTokenRefreshedTrigger as O, recordDeletedTrigger as P, AuthInvoker as Q, GqlOperation as R, RecordDeletedArgs as S, ResolverExecutedArgs as T, WorkflowConfig as U, WorkflowOperation as V, createWorkflow as W, createWorkflowJob as X, WorkflowJobOutput as Y, createResolver as Z, AuthAccessTokenArgs as _, defineGenerators as a, IdpUserTrigger as b, createExecutor as c, IncomingWebhookRequest as d, IncomingWebhookTrigger as f, scheduleTrigger as g, ScheduleTrigger as h, defineConfig as i, idpUserDeletedTrigger as j, authAccessTokenRevokedTrigger as k, Trigger as l, ScheduleArgs as m, output as n, definePlugins as o, incomingWebhookTrigger as p, WorkflowJobContext as q, t as r, defineIdp as s, infer as t, IncomingWebhookArgs as u, AuthAccessTokenTrigger as v, RecordUpdatedArgs as w, RecordCreatedArgs as x, IdpUserArgs as y, Operation as z };
-//# sourceMappingURL=index-q3n7wQOs.d.mts.map
+//# sourceMappingURL=index-Bs9AsQb2.d.mts.map

package/dist/{index-YzESrtj0.d.mts → index-DomkP6gz.d.mts}

@@ -1,5 +1,5 @@
 /// <reference path="./user-defined.d.ts" />
-import { Tt as TailorDBServiceInput, c as BuiltinIdP, ft as ResolverServiceInput, r as AuthConfig } from "./types-DbvONSS-.mjs";
+import { Et as TailorDBServiceInput, c as BuiltinIdP, pt as ResolverServiceInput, r as AuthConfig } from "./types-Db1oxr0U.mjs";
 import { z } from "zod";
 
 //#region src/parser/service/executor/schema.d.ts
@@ -393,4 +393,4 @@ type GeneratorConfigSchemaType = ReturnType<typeof createGeneratorConfigSchema>;
 type Generator = z.output<GeneratorConfigSchemaType>;
 //#endregion
 export { ScheduleTriggerInput as C, ResolverExecutedTrigger as S, WorkflowOperation as T, FunctionOperation as _, IdPExternalConfig as a, IncomingWebhookTrigger as b, WorkflowServiceConfig as c, defineStaticWebSite as d, AuthAccessTokenTrigger as f, ExecutorServiceInput as g, ExecutorServiceConfig as h, IdPConfig as i, WorkflowServiceInput as l, ExecutorInput as m, GeneratorConfig as n, IdPInput as o, Executor as p, AppConfig as r, IdpDefinitionBrand as s, Generator as t, StaticWebsiteConfig as u, GqlOperation as v, WebhookOperation as w, RecordTrigger as x, IdpUserTrigger as y };
-//# sourceMappingURL=index-YzESrtj0.d.mts.map
+//# sourceMappingURL=index-DomkP6gz.d.mts.map

package/dist/plugin/index.d.mts

@@ -1,5 +1,5 @@
 /// <reference path="./../user-defined.d.ts" />
-import { _t as TailorEnv, k as TailorAnyDBType, vt as TailorActor } from "../types-DbvONSS-.mjs";
+import { k as TailorAnyDBType, vt as TailorEnv, yt as TailorActor } from "../types-Db1oxr0U.mjs";
 
 //#region src/plugin/with-context.d.ts
 

package/dist/plugin/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["fs","namespace","cacheKey"],"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 \"@/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","import * as fs from \"node:fs\";\nimport { pathToFileURL } from \"node:url\";\nimport * as path from \"pathe\";\nimport type { NamespacePluginOutput, Plugin, PluginOutput } from \"@/parser/plugin-config/types\";\nimport type { TailorAnyDBType } from \"@/parser/service/tailordb/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>).importPath === \"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 processNamespace() 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: NamespacePluginOutput }> {\n  if (!config.db) {\n    throw new Error(`No db configuration found in config`);\n  }\n\n  if (!plugin.processNamespace) {\n    throw new Error(`Plugin \"${plugin.id}\" does not have a processNamespace() 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.processNamespace({\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 -> PluginOutput\nconst processCache = new WeakMap<Plugin, Map<string, PluginOutput>>();\n\n// Cache for namespace plugins: plugin -> cacheKey -> NamespacePluginOutput\nconst namespaceProcessCache = new WeakMap<Plugin, Map<string, NamespacePluginOutput>>();\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 processType() with the sourceType.\n * For namespace plugins, calls processNamespace() 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 processType() 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.processType) {\n    throw new Error(`Plugin \"${plugin.id}\" does not have a processType() 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.processType({\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 processNamespace() 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.processNamespace) {\n    throw new Error(`Plugin \"${plugin.id}\" does not have a processNamespace() 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 * @lintignore\n */\nexport function _clearCacheForTesting(): void {\n  configCacheMap.clear();\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["fs","namespace","cacheKey"],"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 \"@/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","import * as fs from \"node:fs\";\nimport { pathToFileURL } from \"node:url\";\nimport * as path from \"pathe\";\nimport type { Plugin, PluginOutput, TypePluginOutput } from \"@/parser/plugin-config/types\";\nimport type { TailorAnyDBType } from \"@/parser/service/tailordb/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>).importPath === \"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 processNamespace() 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.processNamespace) {\n    throw new Error(`Plugin \"${plugin.id}\" does not have a processNamespace() 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.processNamespace({\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 processType() with the sourceType.\n * For namespace plugins, calls processNamespace() 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 processType() 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.processType) {\n    throw new Error(`Plugin \"${plugin.id}\" does not have a processType() 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.processType({\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 processNamespace() 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.processNamespace) {\n    throw new Error(`Plugin \"${plugin.id}\" does not have a processNamespace() 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 * @lintignore\n */\nexport function _clearCacheForTesting(): void {\n  configCacheMap.clear();\n}\n"],"mappings":"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"}

package/dist/{types-DbvONSS-.d.mts → types-Db1oxr0U.d.mts}

@@ -492,8 +492,8 @@ declare const RawPermissionsSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodBoolean>]>], null>>>>;
     actions: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodReadonly<z.ZodArray<z.ZodEnum<{
       create: "create";
-      update: "update";
       delete: "delete";
+      update: "update";
       aggregate: "aggregate";
       bulkUpsert: "bulkUpsert";
       read: "read";
@@ -635,11 +635,11 @@ declare const TailorFieldSchema: z.ZodObject<{
   type: z.ZodEnum<{
     string: "string";
     boolean: "boolean";
+    date: "date";
+    enum: "enum";
     uuid: "uuid";
     integer: "integer";
     float: "float";
-    enum: "enum";
-    date: "date";
     datetime: "datetime";
     time: "time";
     nested: "nested";
@@ -668,11 +668,11 @@ declare const ResolverSchema: z.ZodObject<{
     type: z.ZodEnum<{
       string: "string";
       boolean: "boolean";
+      date: "date";
+      enum: "enum";
       uuid: "uuid";
       integer: "integer";
       float: "float";
-      enum: "enum";
-      date: "date";
       datetime: "datetime";
       time: "time";
       nested: "nested";
@@ -698,11 +698,11 @@ declare const ResolverSchema: z.ZodObject<{
     type: z.ZodEnum<{
       string: "string";
       boolean: "boolean";
+      date: "date";
+      enum: "enum";
       uuid: "uuid";
       integer: "integer";
       float: "float";
-      enum: "enum";
-      date: "date";
       datetime: "datetime";
       time: "time";
       nested: "nested";
@@ -1342,10 +1342,11 @@ interface PluginExtends {
    * These fields will be merged into the original type's fields.
    * Existing fields (from original definition or earlier plugins) take precedence.
    */
-  fields?: Record<string, unknown>;
+  fields?: Record<string, TailorAnyDBField>;
 }
 /**
- * Output returned by a plugin's process method
+ * Base output returned by a plugin's process method.
+ * Used by both processType and processNamespace.
  */
 interface PluginOutput {
   /**
@@ -1358,20 +1359,26 @@ interface PluginOutput {
   resolvers?: PluginGeneratedResolver[];
   /** Additional executors to generate */
   executors?: PluginGeneratedExecutor[];
+}
+/**
+ * Output returned by a plugin's processType method.
+ * Extends PluginOutput with the ability to add fields to the source type.
+ */
+interface TypePluginOutput extends PluginOutput {
   /** Extensions to apply to the source type */
   extends?: PluginExtends;
 }
 /**
  * Output returned by a plugin's processNamespace method.
- * Namespace plugins cannot extend a source type.
+ * Alias for PluginOutput (namespace plugins cannot extend a source type).
  */
-type NamespacePluginOutput = Omit<PluginOutput, "extends"> & {
-  extends?: never;
-};
+type NamespacePluginOutput = PluginOutput;
 /**
- * Base plugin interface that all plugins must implement
+ * 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 PluginCommon<PluginConfig = unknown> {
+interface Plugin<TypeConfig = unknown, PluginConfig = unknown> {
   /** Unique identifier for the plugin */
   readonly id: string;
   /** Human-readable description of the plugin */
@@ -1382,19 +1389,6 @@ interface PluginCommon<PluginConfig = unknown> {
    * (e.g., plugin executors and seed schema generation).
    */
   readonly importPath: string;
-  /**
-   * Schema defining the expected plugin-level configuration.
-   * Used to validate the `pluginConfig` property on the plugin object.
-   * If not provided, pluginConfig validation is skipped.
-   * @example
-   * ```typescript
-   * pluginConfigSchema: t.object({
-   *   archiveTablePrefix: t.string({ optional: true }),
-   *   defaultRetentionDays: t.int({ optional: true }),
-   * })
-   * ```
-   */
-  readonly pluginConfigSchema?: TailorAnyField;
   /**
    * Controls whether per-type plugin config is required when attaching via .plugin().
    * If a function is provided, it receives pluginConfig from definePlugins().
@@ -1407,24 +1401,13 @@ interface PluginCommon<PluginConfig = unknown> {
    * to both processType() and processNamespace() methods.
    */
   readonly pluginConfig?: PluginConfig;
-  /**
-   * TypeScript type template for generating type-safe plugin configuration.
-   * Use `Fields` to reference the field names of the type being configured.
-   * If not provided, the type is generated from configSchema.
-   * @example
-   * ```typescript
-   * // For field-aware configs:
-   * configTypeTemplate: "{ labels: Partial<Record<Fields, FieldLabel>>; typeLabel?: FieldLabel }"
-   * ```
-   */
-  readonly configTypeTemplate?: string;
   /**
    * Process a single TailorDB type and generate outputs.
    * This method is called for each type that has this plugin attached via .plugin().
    * @param context - Context containing the type, config, pluginConfig, and namespace
    * @returns Plugin output with generated types, resolvers, and executors
    */
-  processType?(context: PluginProcessContext): PluginOutput | Promise<PluginOutput>;
+  processType?(context: PluginProcessContext<TypeConfig, PluginConfig>): TypePluginOutput | Promise<TypePluginOutput>;
   /**
    * Process plugin for a namespace without requiring a source type.
    * This method is called once per namespace for plugins configured via definePlugins().
@@ -1432,32 +1415,8 @@ interface PluginCommon<PluginConfig = unknown> {
    * @param context - Context containing the plugin config, namespace, and types
    * @returns Plugin output with generated types, resolvers, and executors
    */
-  processNamespace?(context: PluginNamespaceProcessContext): NamespacePluginOutput | Promise<NamespacePluginOutput>;
-}
-interface PluginWithConfig<PluginConfig = unknown> extends PluginCommon<PluginConfig> {
-  /**
-   * Schema defining the expected per-type configuration for this plugin.
-   * Used to validate config passed via `.plugin({ pluginId: config })`.
-   * Uses the same field types as createResolver's input (t.string(), t.number(), etc.).
-   * @example
-   * ```typescript
-   * configSchema: t.object({
-   *   archiveReason: t.bool({ optional: true }),
-   * })
-   * ```
-   */
-  readonly configSchema: TailorAnyField;
+  processNamespace?(context: PluginNamespaceProcessContext<PluginConfig>): NamespacePluginOutput | Promise<NamespacePluginOutput>;
 }
-interface PluginNamespaceOnly<PluginConfig = unknown> extends PluginCommon<PluginConfig> {
-  /** Namespace-only plugins do not accept per-type config. */
-  readonly configSchema?: undefined;
-  /** Namespace-only plugins cannot define processType(). */
-  processType?: never;
-}
-/**
- * Plugin interface that all plugins must implement
- */
-type Plugin<PluginConfig = unknown> = PluginWithConfig<PluginConfig> | PluginNamespaceOnly<PluginConfig>;
 //#endregion
 //#region src/configure/services/tailordb/schema.d.ts
 interface RelationConfig<S extends RelationType, T extends TailorDBType$1> {
@@ -2277,5 +2236,5 @@ interface TailorDBType {
   files?: TailorDBTypeMetadata["files"];
 }
 //#endregion
-export { ArrayFieldOutput as $, TailorDBField as A, PluginGeneratedExecutor as B, UserAttributeKey as C, AllowedValues as Ct, ValueOperand as D, UsernameFieldKey as E, Plugin as F, PluginOutput as G, PluginGeneratedResolver as H, PluginAttachment as I, PermissionCondition as J, PluginProcessContext as K, PluginConfigs as L, TailorDBType$1 as M, db as N, TailorAnyDBField as O, NamespacePluginOutput as P, unsafeAllowAllTypePermission as Q, PluginExecutorContext as R, TenantProviderConfig as S, unauthenticatedTailorUser as St, UserAttributeMap as T, TailorDBServiceInput as Tt, PluginGeneratedType as U, PluginGeneratedExecutorWithFile as V, PluginNamespaceProcessContext as W, TailorTypePermission as X, TailorTypeGqlPermission as Y, unsafeAllowAllGqlPermission as Z, SCIMAttributeMapping as _, TailorEnv as _t, AuthInvoker as a, TailorAnyField as at, SCIMConfig as b, AttributeMap as bt, BuiltinIdP as c, Resolver as ct, IdProviderConfig as d, ResolverServiceConfig as dt, DefinedFieldMetadata as et, OAuth2ClientGrantType as f, ResolverServiceInput as ft, SCIMAttribute as g, Env as gt, SAML as h, output as ht, AuthExternalConfig as i, TailorFieldType as it, TailorDBInstance as j, TailorAnyDBType as k, DefinedAuth as l, ResolverExternalConfig as lt, OIDC as m, JsonCompatible as mt, TypeSourceInfoEntry as n, FieldOptions as nt, AuthOwnConfig as o, TailorField as ot, OAuth2ClientInput as p, InferFieldsOutput as pt, TailorDBTypeForPlugin as q, AuthConfig as r, FieldOutput$1 as rt, AuthServiceInput as s, QueryType as st, TailorDBType as t, FieldMetadata as tt, IDToken as u, ResolverInput as ut, SCIMAttributeType as v, TailorActor as vt, UserAttributeListKey as w, AllowedValuesOutput as wt, SCIMResource as x, TailorUser as xt, SCIMAuthorization as y, AttributeList as yt, PluginExecutorContextBase as z };
-//# sourceMappingURL=types-DbvONSS-.d.mts.map
+export { unsafeAllowAllTypePermission as $, TailorDBField as A, PluginGeneratedExecutor as B, UserAttributeKey as C, unauthenticatedTailorUser as Ct, ValueOperand as D, UsernameFieldKey as E, TailorDBServiceInput as Et, Plugin as F, PluginOutput as G, PluginGeneratedResolver as H, PluginAttachment as I, TypePluginOutput as J, PluginProcessContext as K, PluginConfigs as L, TailorDBType$1 as M, db as N, TailorAnyDBField as O, NamespacePluginOutput as P, unsafeAllowAllGqlPermission as Q, PluginExecutorContext as R, TenantProviderConfig as S, TailorUser as St, UserAttributeMap as T, AllowedValuesOutput as Tt, PluginGeneratedType as U, PluginGeneratedExecutorWithFile as V, PluginNamespaceProcessContext as W, TailorTypeGqlPermission as X, PermissionCondition as Y, TailorTypePermission as Z, SCIMAttributeMapping as _, Env as _t, AuthInvoker as a, TailorFieldType as at, SCIMConfig as b, AttributeList as bt, BuiltinIdP as c, QueryType as ct, IdProviderConfig as d, ResolverInput as dt, ArrayFieldOutput as et, OAuth2ClientGrantType as f, ResolverServiceConfig as ft, SCIMAttribute as g, output as gt, SAML as h, JsonCompatible as ht, AuthExternalConfig as i, FieldOutput$1 as it, TailorDBInstance as j, TailorAnyDBType as k, DefinedAuth as l, Resolver as lt, OIDC as m, InferFieldsOutput as mt, TypeSourceInfoEntry as n, FieldMetadata as nt, AuthOwnConfig as o, TailorAnyField as ot, OAuth2ClientInput as p, ResolverServiceInput as pt, TailorDBTypeForPlugin as q, AuthConfig as r, FieldOptions as rt, AuthServiceInput as s, TailorField as st, TailorDBType as t, DefinedFieldMetadata as tt, IDToken as u, ResolverExternalConfig as ut, SCIMAttributeType as v, TailorEnv as vt, UserAttributeListKey as w, AllowedValues as wt, SCIMResource as x, AttributeMap as xt, SCIMAuthorization as y, TailorActor as yt, PluginExecutorContextBase as z };
+//# sourceMappingURL=types-Db1oxr0U.d.mts.map