@tailor-platform/sdk 2.24.0 → 2.25.0

package/dist/plugin/index.mjs

@@ -1,2 +1,2 @@
-import{t as e}from"../manager-8-JOvuLl.mjs";import*as t from"pathe";import*as n from"node:fs";import{pathToFileURL as r}from"node:url";function withPluginContext(e){return e}const i=/* @__PURE__ */ new Map,a=[`onTableLoaded`,`onNamespaceLoaded`,`onTailorDBReady`,`onResolverReady`,`onExecutorReady`];function isPlugin(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=e;if(typeof t.id!=`string`||typeof t.description!=`string`||t.importPath!==void 0&&typeof t.importPath!=`string`||t.tableConfigRequired!==void 0&&typeof t.tableConfigRequired!=`boolean`&&typeof t.tableConfigRequired!=`function`)return!1;for(let e of a)if(t[e]!==void 0&&typeof t[e]!=`function`)return!1;return!((t.onTableLoaded||t.onNamespaceLoaded)&&!t.importPath)}async function loadAndCacheConfig(e){let a=t.resolve(e),o=i.get(a);if(o)return o;if(!n.existsSync(a))return null;let s=await import(r(a).href);if(!s?.default)throw Error(`Invalid config module at "${a}": default export not found`);let c=s.default,l=t.dirname(a),u=/* @__PURE__ */ new Map;if(Object.hasOwn(s,`plugins`)){let e=s.plugins;if(!Array.isArray(e))throw Error(`Invalid \`plugins\` export in "${a}": expected an array returned by definePlugins(), got ${typeof e}`);for(let t of e){if(!isPlugin(t))throw Error(`Invalid \`plugins\` export in "${a}": every item must be a plugin created by definePlugins()`);if(u.has(t.id))throw Error(`Duplicate plugin ID "${t.id}" detected in "${a}". Each plugin must have a unique ID.`);u.set(t.id,{plugin:t,pluginConfig:t.pluginConfig})}}let d={config:c,plugins:u,configDir:l};return i.set(a,d),d}async function resolveNamespaceForTable(e,i,a){if(!e.db)throw Error(`No db configuration found in config`);for(let[o,s]of Object.entries(e.db)){let e=s;if(!e.external&&e.files)for(let s of e.files){let e=t.resolve(i,s),c;try{c=n.globSync(e)}catch{continue}for(let e of c){let t=await import(r(e).href);for(let e of Object.values(t))if(e===a)return o}}}throw Error(`Could not resolve namespace for table "${a.name}". Ensure the table file is included in a db namespace's files pattern.`)}async function resolveNamespaceForNamespacePlugin(e,t,n,r){if(!e.db)throw Error(`No db configuration found in config`);if(!t.onNamespaceLoaded)throw Error(`Plugin "${t.id}" does not have a onNamespaceLoaded() method`);for(let i of Object.keys(e.db)){if(e.db[i].external)continue;let a=await t.onNamespaceLoaded({pluginConfig:r,namespace:i});if(a.tables?.[n])return{namespace:i,output:a}}throw Error(`Could not resolve namespace for plugin "${t.id}" with kind "${n}". No namespace produced a table with that kind.`)}const o=/* @__PURE__ */ new WeakMap,s=/* @__PURE__ */ new WeakMap;function getCacheKey(e,t){if(t===void 0)return e;try{return`${e}:${JSON.stringify(t)}`}catch{throw Error(`pluginConfig must be JSON-serializable for caching. Received non-serializable value.`)}}async function getGeneratedTable(e,t,n,r){let i=await loadAndCacheConfig(e);if(!i)return{name:`__placeholder_${r}__`,fields:{}};let{config:a,configDir:o,plugins:s}=i,c=s.get(t);if(!c)throw Error(`Plugin "${t}" not found in config at "${e}". Ensure the plugin is registered via definePlugins().`);let{plugin:l,pluginConfig:u}=c;return n===null?getGeneratedTableForNamespacePlugin(a,l,r,u):getGeneratedTableForTableAttachedPlugin(l,n,r,u,await resolveNamespaceForTable(a,o,n))}async function getGeneratedTableForTableAttachedPlugin(e,t,n,r,i){if(!e.onTableLoaded)throw Error(`Plugin "${e.id}" does not have an onTableLoaded() method`);let a=o.get(e);a||(a=/* @__PURE__ */ new Map,o.set(e,a));let s=getCacheKey(`${t.name}:ns=${i}`,r),c=a.get(s);if(!c){let n=t.plugins.find(t=>t.pluginId===e.id)?.config;c=await e.onTableLoaded({table:t,tableConfig:n??{},pluginConfig:r,namespace:i}),a.set(s,c)}let l=c.tables?.[n];if(!l)throw Error(`Generated table not found: plugin=${e.id}, sourceTable=${t.name}, kind=${n}`);return l}async function getGeneratedTableForNamespacePlugin(e,t,n,r){if(!t.onNamespaceLoaded)throw Error(`Plugin "${t.id}" does not have a onNamespaceLoaded() method`);let i=s.get(t);if(i||(i=/* @__PURE__ */ new Map,s.set(t,i)),e.db)for(let t of Object.keys(e.db)){if(e.db[t].external)continue;let a=getCacheKey(`namespace:ns=${t}`,r),o=i.get(a);if(o?.tables?.[n])return o.tables[n]}let{namespace:a,output:o}=await resolveNamespaceForNamespacePlugin(e,t,n,r),c=getCacheKey(`namespace:ns=${a}`,r);i.set(c,o);let l=o.tables?.[n];if(!l)throw Error(`Generated table not found: plugin=${t.id}, kind=${n}`);return l}const c=/* @__PURE__ */ new Map;async function getExtendedTable(e,n){if(n.plugins.length===0)return n;let r=t.resolve(e),i=c.get(r);i||(i=/* @__PURE__ */ new WeakMap,c.set(r,i));let a=i.get(n);if(a)return a;let o=applyPluginExtensions(r,n);return i.set(n,o),o.catch(()=>i.delete(n)),o}async function applyPluginExtensions(t,n){let r=await loadAndCacheConfig(t);if(!r)return n;let{config:i,configDir:a,plugins:o}=r,s=await resolveNamespaceForTable(i,a,n),{extendedTable:c}=await new e([...o.values()].map(e=>e.plugin)).processAttachmentsForTable({rawTable:n,attachments:[...n.plugins],namespace:s});return c??n}export{getExtendedTable,getGeneratedTable,withPluginContext};
+import{t as e}from"../manager-8-JOvuLl.mjs";import*as t from"pathe";import*as n from"node:fs";import{pathToFileURL as r}from"node:url";function withPluginContext(e){return e}const i=/* @__PURE__ */ new Map,a=[`onTableLoaded`,`onNamespaceLoaded`,`onTailorDBReady`,`onResolverReady`,`onExecutorReady`,`onDeployed`];function isPlugin(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=e;if(typeof t.id!=`string`||typeof t.description!=`string`||t.importPath!==void 0&&typeof t.importPath!=`string`||t.tableConfigRequired!==void 0&&typeof t.tableConfigRequired!=`boolean`&&typeof t.tableConfigRequired!=`function`)return!1;for(let e of a)if(t[e]!==void 0&&typeof t[e]!=`function`)return!1;return!((t.onTableLoaded||t.onNamespaceLoaded)&&!t.importPath)}async function loadAndCacheConfig(e){let a=t.resolve(e),o=i.get(a);if(o)return o;if(!n.existsSync(a))return null;let s=await import(r(a).href);if(!s?.default)throw Error(`Invalid config module at "${a}": default export not found`);let c=s.default,l=t.dirname(a),u=/* @__PURE__ */ new Map;if(Object.hasOwn(s,`plugins`)){let e=s.plugins;if(!Array.isArray(e))throw Error(`Invalid \`plugins\` export in "${a}": expected an array returned by definePlugins(), got ${typeof e}`);for(let t of e){if(!isPlugin(t))throw Error(`Invalid \`plugins\` export in "${a}": every item must be a plugin created by definePlugins()`);if(u.has(t.id))throw Error(`Duplicate plugin ID "${t.id}" detected in "${a}". Each plugin must have a unique ID.`);u.set(t.id,{plugin:t,pluginConfig:t.pluginConfig})}}let d={config:c,plugins:u,configDir:l};return i.set(a,d),d}async function resolveNamespaceForTable(e,i,a){if(!e.db)throw Error(`No db configuration found in config`);for(let[o,s]of Object.entries(e.db)){let e=s;if(!e.external&&e.files)for(let s of e.files){let e=t.resolve(i,s),c;try{c=n.globSync(e)}catch{continue}for(let e of c){let t=await import(r(e).href);for(let e of Object.values(t))if(e===a)return o}}}throw Error(`Could not resolve namespace for table "${a.name}". Ensure the table file is included in a db namespace's files pattern.`)}async function resolveNamespaceForNamespacePlugin(e,t,n,r){if(!e.db)throw Error(`No db configuration found in config`);if(!t.onNamespaceLoaded)throw Error(`Plugin "${t.id}" does not have a onNamespaceLoaded() method`);for(let i of Object.keys(e.db)){if(e.db[i].external)continue;let a=await t.onNamespaceLoaded({pluginConfig:r,namespace:i});if(a.tables?.[n])return{namespace:i,output:a}}throw Error(`Could not resolve namespace for plugin "${t.id}" with kind "${n}". No namespace produced a table with that kind.`)}const o=/* @__PURE__ */ new WeakMap,s=/* @__PURE__ */ new WeakMap;function getCacheKey(e,t){if(t===void 0)return e;try{return`${e}:${JSON.stringify(t)}`}catch{throw Error(`pluginConfig must be JSON-serializable for caching. Received non-serializable value.`)}}async function getGeneratedTable(e,t,n,r){let i=await loadAndCacheConfig(e);if(!i)return{name:`__placeholder_${r}__`,fields:{}};let{config:a,configDir:o,plugins:s}=i,c=s.get(t);if(!c)throw Error(`Plugin "${t}" not found in config at "${e}". Ensure the plugin is registered via definePlugins().`);let{plugin:l,pluginConfig:u}=c;return n===null?getGeneratedTableForNamespacePlugin(a,l,r,u):getGeneratedTableForTableAttachedPlugin(l,n,r,u,await resolveNamespaceForTable(a,o,n))}async function getGeneratedTableForTableAttachedPlugin(e,t,n,r,i){if(!e.onTableLoaded)throw Error(`Plugin "${e.id}" does not have an onTableLoaded() method`);let a=o.get(e);a||(a=/* @__PURE__ */ new Map,o.set(e,a));let s=getCacheKey(`${t.name}:ns=${i}`,r),c=a.get(s);if(!c){let n=t.plugins.find(t=>t.pluginId===e.id)?.config;c=await e.onTableLoaded({table:t,tableConfig:n??{},pluginConfig:r,namespace:i}),a.set(s,c)}let l=c.tables?.[n];if(!l)throw Error(`Generated table not found: plugin=${e.id}, sourceTable=${t.name}, kind=${n}`);return l}async function getGeneratedTableForNamespacePlugin(e,t,n,r){if(!t.onNamespaceLoaded)throw Error(`Plugin "${t.id}" does not have a onNamespaceLoaded() method`);let i=s.get(t);if(i||(i=/* @__PURE__ */ new Map,s.set(t,i)),e.db)for(let t of Object.keys(e.db)){if(e.db[t].external)continue;let a=getCacheKey(`namespace:ns=${t}`,r),o=i.get(a);if(o?.tables?.[n])return o.tables[n]}let{namespace:a,output:o}=await resolveNamespaceForNamespacePlugin(e,t,n,r),c=getCacheKey(`namespace:ns=${a}`,r);i.set(c,o);let l=o.tables?.[n];if(!l)throw Error(`Generated table not found: plugin=${t.id}, kind=${n}`);return l}const c=/* @__PURE__ */ new Map;async function getExtendedTable(e,n){if(n.plugins.length===0)return n;let r=t.resolve(e),i=c.get(r);i||(i=/* @__PURE__ */ new WeakMap,c.set(r,i));let a=i.get(n);if(a)return a;let o=applyPluginExtensions(r,n);return i.set(n,o),o.catch(()=>i.delete(n)),o}async function applyPluginExtensions(t,n){let r=await loadAndCacheConfig(t);if(!r)return n;let{config:i,configDir:a,plugins:o}=r,s=await resolveNamespaceForTable(i,a,n),{extendedTable:c}=await new e([...o.values()].map(e=>e.plugin)).processAttachmentsForTable({rawTable:n,attachments:[...n.plugins],namespace:s});return c??n}export{getExtendedTable,getGeneratedTable,withPluginContext};
 //# sourceMappingURL=index.mjs.map

package/dist/plugin/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["PluginManager","path","fs","factory","configCacheMap","OPTIONAL_HOOK_KEYS","value","candidate","key","resolvedPath","configPath","cached","configModule","pathToFileURL","config","configDir","plugins","pluginsExport","item","result","namespace","nsConfig","dbConfig","pattern","absolutePattern","matchedFiles","file","mod","exported","sourceTable","plugin","output","kind","processCache","namespaceProcessCache","pluginConfig","baseKey","cache","pluginEntry","pluginId","pluginCache","cacheKey","tableConfig","p","generatedTable","extendedTableCache","tables","pending","entry","extendedTable"],"sources":["../../src/plugin/with-context.ts","../../src/plugin/get-generated-table.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 table 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 table */\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 *   sourceTable: TailorAnyDBType;\n *   historyType: TailorAnyDBType;\n *   namespace: string;\n * }\n *\n * export default withPluginContext<MyContext>((ctx) =>\n *   createExecutor({\n *     name: `${ctx.sourceTable.name.toLowerCase()}-on-create`,\n *     trigger: recordCreatedTrigger({ type: ctx.sourceTable }),\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 { PluginManager } from \"./manager\";\nimport type { TailorAnyDBType } from \"#/configure/services/tailordb/types\";\nimport type { Plugin, PluginOutput, TablePluginOutput } from \"#/plugin/types\";\nimport type { TailorDBTypeRaw } from \"#/types/tailordb.generated\";\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\nconst OPTIONAL_HOOK_KEYS = [\n  \"onTableLoaded\",\n  \"onNamespaceLoaded\",\n  \"onTailorDBReady\",\n  \"onResolverReady\",\n  \"onExecutorReady\",\n] as const;\n\n/**\n * Check if a value is a Plugin instance. Mirrors PluginConfigSchema's shape without\n * depending on zod, since this module must stay usable from a bundled executor.\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  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return false;\n  const candidate = value as Record<string, unknown>;\n  if (typeof candidate.id !== \"string\" || typeof candidate.description !== \"string\") return false;\n  if (candidate.importPath !== undefined && typeof candidate.importPath !== \"string\") return false;\n  if (\n    candidate.tableConfigRequired !== undefined &&\n    typeof candidate.tableConfigRequired !== \"boolean\" &&\n    typeof candidate.tableConfigRequired !== \"function\"\n  )\n    return false;\n  for (const key of OPTIONAL_HOOK_KEYS) {\n    if (candidate[key] !== undefined && typeof candidate[key] !== \"function\") return false;\n  }\n  const hasDefinitionTimeHooks = candidate.onTableLoaded || candidate.onNamespaceLoaded;\n  if (hasDefinitionTimeHooks && !candidate.importPath) return false;\n  return true;\n}\n\n/**\n * Load and cache config module from the given path.\n * Reads plugins from the config module's `plugins` export (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  if (Object.hasOwn(configModule, \"plugins\")) {\n    const pluginsExport: unknown = configModule.plugins;\n    if (!Array.isArray(pluginsExport)) {\n      throw new Error(\n        `Invalid \\`plugins\\` export in \"${resolvedPath}\": expected an array returned by definePlugins(), got ${typeof pluginsExport}`,\n      );\n    }\n    for (const item of pluginsExport) {\n      if (!isPlugin(item)) {\n        throw new Error(\n          `Invalid \\`plugins\\` export in \"${resolvedPath}\": every item must be a plugin created by definePlugins()`,\n        );\n      }\n      if (plugins.has(item.id)) {\n        throw new Error(\n          `Duplicate plugin ID \"${item.id}\" detected in \"${resolvedPath}\". Each plugin must have a unique ID.`,\n        );\n      }\n      plugins.set(item.id, { plugin: item, pluginConfig: item.pluginConfig });\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 table-attached source table 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 sourceTable - The TailorDB table to look up\n * @returns The namespace name\n */\nasync function resolveNamespaceForTable(\n  config: { db?: Record<string, unknown> },\n  configDir: string,\n  sourceTable: 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 === sourceTable) {\n            return namespace;\n          }\n        }\n      }\n    }\n  }\n\n  throw new Error(\n    `Could not resolve namespace for table \"${sourceTable.name}\". ` +\n      `Ensure the table 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 table 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.tables?.[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 table with that kind.`,\n  );\n}\n\n// ========================================\n// Process caching\n// ========================================\n\n// Cache: plugin -> cacheKey -> TablePluginOutput\nconst processCache = new WeakMap<Plugin, Map<string, TablePluginOutput>>();\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 table from a plugin by loading the config and resolving everything automatically.\n * For table-attached plugins, calls onTableLoaded() with the source table.\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 sourceTable - The source TailorDB table (null for namespace plugins)\n * @param kind - The generated table kind (e.g., \"request\", \"step\")\n * @returns The generated TailorDB table\n */\nexport async function getGeneratedTable(\n  configPath: string,\n  pluginId: string,\n  sourceTable: 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 table 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 (sourceTable === null) {\n    return getGeneratedTableForNamespacePlugin(config, plugin, kind, pluginConfig);\n  }\n\n  const namespace = await resolveNamespaceForTable(config, configDir, sourceTable);\n  return getGeneratedTableForTableAttachedPlugin(\n    plugin,\n    sourceTable,\n    kind,\n    pluginConfig,\n    namespace,\n  );\n}\n\n/**\n * Get a generated table from a table-attached plugin.\n * @param plugin - The plugin instance (must have onTableLoaded() method)\n * @param sourceTable - The source TailorDB table\n * @param kind - The generated table kind\n * @param pluginConfig - Plugin-level configuration\n * @param namespace - Resolved namespace\n * @returns The generated TailorDB table\n */\nasync function getGeneratedTableForTableAttachedPlugin(\n  plugin: Plugin,\n  sourceTable: TailorAnyDBType,\n  kind: string,\n  pluginConfig: unknown,\n  namespace: string,\n): Promise<TailorAnyDBType> {\n  if (!plugin.onTableLoaded) {\n    throw new Error(`Plugin \"${plugin.id}\" does not have an onTableLoaded() 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(`${sourceTable.name}:ns=${namespace}`, pluginConfig);\n  let output = pluginCache.get(cacheKey);\n\n  if (!output) {\n    const tableConfig = sourceTable.plugins.find((p) => p.pluginId === plugin.id)?.config;\n    output = await plugin.onTableLoaded({\n      table: sourceTable,\n      tableConfig: tableConfig ?? {},\n      pluginConfig,\n      namespace,\n    });\n    pluginCache.set(cacheKey, output);\n  }\n\n  const generatedTable = output.tables?.[kind];\n  if (!generatedTable) {\n    throw new Error(\n      `Generated table not found: plugin=${plugin.id}, sourceTable=${sourceTable.name}, kind=${kind}`,\n    );\n  }\n\n  return generatedTable as TailorAnyDBType;\n}\n\n/**\n * Get a generated table 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 table kind\n * @param pluginConfig - Plugin-level configuration\n * @returns The generated TailorDB table\n */\nasync function getGeneratedTableForNamespacePlugin(\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?.tables?.[kind]) {\n        return cached.tables[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 generatedTable = output.tables?.[kind];\n  if (!generatedTable) {\n    throw new Error(`Generated table not found: plugin=${plugin.id}, kind=${kind}`);\n  }\n\n  return generatedTable as TailorAnyDBType;\n}\n\n// Cache: resolved config path -> source table -> the table with plugin fields applied.\n// Holds the pending promise so concurrent callers share one plugin run.\nconst extendedTableCache = new Map<string, WeakMap<TailorAnyDBType, Promise<TailorAnyDBType>>>();\n\n/**\n * Get a table with the fields its attached plugins add to it, as `tailor generate` sees it.\n * The plugins attached with `.plugin()` run in order, each seeing the fields the ones before\n * it added, and the result is cached per config path and table.\n * The table exported from the source file is not changed; the returned table is a new object.\n * Returns the source table itself when no plugin is attached to it, or when the config is\n * not available (e.g. in a bundled executor on the platform server).\n * @template T - The source table's own type, which the returned table keeps\n * @param configPath - Path to tailor.config.ts (absolute or relative to cwd)\n * @param sourceTable - The TailorDB table as exported from its source file\n * @returns The table with every plugin-added field\n */\nexport async function getExtendedTable<T extends TailorAnyDBType>(\n  configPath: string,\n  sourceTable: T,\n): Promise<T> {\n  if (sourceTable.plugins.length === 0) {\n    return sourceTable;\n  }\n  const resolvedPath = path.resolve(configPath);\n  let tables = extendedTableCache.get(resolvedPath);\n  if (!tables) {\n    tables = new WeakMap();\n    extendedTableCache.set(resolvedPath, tables);\n  }\n  const cached = tables.get(sourceTable);\n  if (cached) {\n    return cached as Promise<T>;\n  }\n  const pending = applyPluginExtensions(resolvedPath, sourceTable);\n  tables.set(sourceTable, pending);\n  pending.catch(() => tables.delete(sourceTable));\n  return pending as Promise<T>;\n}\n\nasync function applyPluginExtensions(\n  configPath: string,\n  sourceTable: TailorAnyDBType,\n): Promise<TailorAnyDBType> {\n  const cache = await loadAndCacheConfig(configPath);\n  if (!cache) {\n    return sourceTable;\n  }\n  const { config, configDir, plugins } = cache;\n  const namespace = await resolveNamespaceForTable(config, configDir, sourceTable);\n  const manager = new PluginManager([...plugins.values()].map((entry) => entry.plugin));\n  const { extendedTable } = await manager.processAttachmentsForTable({\n    rawTable: sourceTable as unknown as TailorDBTypeRaw,\n    attachments: [...sourceTable.plugins],\n    namespace,\n  });\n  return (extendedTable as TailorAnyDBType | undefined) ?? sourceTable;\n}\n\n/**\n * Clear all internal caches. For testing only.\n */\nexport function _clearCacheForTesting(): void {\n  configCacheMap.clear();\n  extendedTableCache.clear();\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["PluginManager","path","fs","factory","configCacheMap","OPTIONAL_HOOK_KEYS","value","candidate","key","resolvedPath","configPath","cached","configModule","pathToFileURL","config","configDir","plugins","pluginsExport","item","result","namespace","nsConfig","dbConfig","pattern","absolutePattern","matchedFiles","file","mod","exported","sourceTable","plugin","output","kind","processCache","namespaceProcessCache","pluginConfig","baseKey","cache","pluginEntry","pluginId","pluginCache","cacheKey","tableConfig","p","generatedTable","extendedTableCache","tables","pending","entry","extendedTable"],"sources":["../../src/plugin/with-context.ts","../../src/plugin/get-generated-table.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 table 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 table */\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 *   sourceTable: TailorAnyDBType;\n *   historyType: TailorAnyDBType;\n *   namespace: string;\n * }\n *\n * export default withPluginContext<MyContext>((ctx) =>\n *   createExecutor({\n *     name: `${ctx.sourceTable.name.toLowerCase()}-on-create`,\n *     trigger: recordCreatedTrigger({ type: ctx.sourceTable }),\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 { PluginManager } from \"./manager\";\nimport type { TailorAnyDBType } from \"#/configure/services/tailordb/types\";\nimport type { Plugin, PluginOutput, TablePluginOutput } from \"#/plugin/types\";\nimport type { TailorDBTypeRaw } from \"#/types/tailordb.generated\";\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\nconst OPTIONAL_HOOK_KEYS = [\n  \"onTableLoaded\",\n  \"onNamespaceLoaded\",\n  \"onTailorDBReady\",\n  \"onResolverReady\",\n  \"onExecutorReady\",\n  \"onDeployed\",\n] as const;\n\n/**\n * Check if a value is a Plugin instance. Mirrors PluginConfigSchema's shape without\n * depending on zod, since this module must stay usable from a bundled executor.\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  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return false;\n  const candidate = value as Record<string, unknown>;\n  if (typeof candidate.id !== \"string\" || typeof candidate.description !== \"string\") return false;\n  if (candidate.importPath !== undefined && typeof candidate.importPath !== \"string\") return false;\n  if (\n    candidate.tableConfigRequired !== undefined &&\n    typeof candidate.tableConfigRequired !== \"boolean\" &&\n    typeof candidate.tableConfigRequired !== \"function\"\n  )\n    return false;\n  for (const key of OPTIONAL_HOOK_KEYS) {\n    if (candidate[key] !== undefined && typeof candidate[key] !== \"function\") return false;\n  }\n  const hasDefinitionTimeHooks = candidate.onTableLoaded || candidate.onNamespaceLoaded;\n  if (hasDefinitionTimeHooks && !candidate.importPath) return false;\n  return true;\n}\n\n/**\n * Load and cache config module from the given path.\n * Reads plugins from the config module's `plugins` export (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  if (Object.hasOwn(configModule, \"plugins\")) {\n    const pluginsExport: unknown = configModule.plugins;\n    if (!Array.isArray(pluginsExport)) {\n      throw new Error(\n        `Invalid \\`plugins\\` export in \"${resolvedPath}\": expected an array returned by definePlugins(), got ${typeof pluginsExport}`,\n      );\n    }\n    for (const item of pluginsExport) {\n      if (!isPlugin(item)) {\n        throw new Error(\n          `Invalid \\`plugins\\` export in \"${resolvedPath}\": every item must be a plugin created by definePlugins()`,\n        );\n      }\n      if (plugins.has(item.id)) {\n        throw new Error(\n          `Duplicate plugin ID \"${item.id}\" detected in \"${resolvedPath}\". Each plugin must have a unique ID.`,\n        );\n      }\n      plugins.set(item.id, { plugin: item, pluginConfig: item.pluginConfig });\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 table-attached source table 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 sourceTable - The TailorDB table to look up\n * @returns The namespace name\n */\nasync function resolveNamespaceForTable(\n  config: { db?: Record<string, unknown> },\n  configDir: string,\n  sourceTable: 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 === sourceTable) {\n            return namespace;\n          }\n        }\n      }\n    }\n  }\n\n  throw new Error(\n    `Could not resolve namespace for table \"${sourceTable.name}\". ` +\n      `Ensure the table 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 table 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.tables?.[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 table with that kind.`,\n  );\n}\n\n// ========================================\n// Process caching\n// ========================================\n\n// Cache: plugin -> cacheKey -> TablePluginOutput\nconst processCache = new WeakMap<Plugin, Map<string, TablePluginOutput>>();\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 table from a plugin by loading the config and resolving everything automatically.\n * For table-attached plugins, calls onTableLoaded() with the source table.\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 sourceTable - The source TailorDB table (null for namespace plugins)\n * @param kind - The generated table kind (e.g., \"request\", \"step\")\n * @returns The generated TailorDB table\n */\nexport async function getGeneratedTable(\n  configPath: string,\n  pluginId: string,\n  sourceTable: 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 table 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 (sourceTable === null) {\n    return getGeneratedTableForNamespacePlugin(config, plugin, kind, pluginConfig);\n  }\n\n  const namespace = await resolveNamespaceForTable(config, configDir, sourceTable);\n  return getGeneratedTableForTableAttachedPlugin(\n    plugin,\n    sourceTable,\n    kind,\n    pluginConfig,\n    namespace,\n  );\n}\n\n/**\n * Get a generated table from a table-attached plugin.\n * @param plugin - The plugin instance (must have onTableLoaded() method)\n * @param sourceTable - The source TailorDB table\n * @param kind - The generated table kind\n * @param pluginConfig - Plugin-level configuration\n * @param namespace - Resolved namespace\n * @returns The generated TailorDB table\n */\nasync function getGeneratedTableForTableAttachedPlugin(\n  plugin: Plugin,\n  sourceTable: TailorAnyDBType,\n  kind: string,\n  pluginConfig: unknown,\n  namespace: string,\n): Promise<TailorAnyDBType> {\n  if (!plugin.onTableLoaded) {\n    throw new Error(`Plugin \"${plugin.id}\" does not have an onTableLoaded() 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(`${sourceTable.name}:ns=${namespace}`, pluginConfig);\n  let output = pluginCache.get(cacheKey);\n\n  if (!output) {\n    const tableConfig = sourceTable.plugins.find((p) => p.pluginId === plugin.id)?.config;\n    output = await plugin.onTableLoaded({\n      table: sourceTable,\n      tableConfig: tableConfig ?? {},\n      pluginConfig,\n      namespace,\n    });\n    pluginCache.set(cacheKey, output);\n  }\n\n  const generatedTable = output.tables?.[kind];\n  if (!generatedTable) {\n    throw new Error(\n      `Generated table not found: plugin=${plugin.id}, sourceTable=${sourceTable.name}, kind=${kind}`,\n    );\n  }\n\n  return generatedTable as TailorAnyDBType;\n}\n\n/**\n * Get a generated table 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 table kind\n * @param pluginConfig - Plugin-level configuration\n * @returns The generated TailorDB table\n */\nasync function getGeneratedTableForNamespacePlugin(\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?.tables?.[kind]) {\n        return cached.tables[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 generatedTable = output.tables?.[kind];\n  if (!generatedTable) {\n    throw new Error(`Generated table not found: plugin=${plugin.id}, kind=${kind}`);\n  }\n\n  return generatedTable as TailorAnyDBType;\n}\n\n// Cache: resolved config path -> source table -> the table with plugin fields applied.\n// Holds the pending promise so concurrent callers share one plugin run.\nconst extendedTableCache = new Map<string, WeakMap<TailorAnyDBType, Promise<TailorAnyDBType>>>();\n\n/**\n * Get a table with the fields its attached plugins add to it, as `tailor generate` sees it.\n * The plugins attached with `.plugin()` run in order, each seeing the fields the ones before\n * it added, and the result is cached per config path and table.\n * The table exported from the source file is not changed; the returned table is a new object.\n * Returns the source table itself when no plugin is attached to it, or when the config is\n * not available (e.g. in a bundled executor on the platform server).\n * @template T - The source table's own type, which the returned table keeps\n * @param configPath - Path to tailor.config.ts (absolute or relative to cwd)\n * @param sourceTable - The TailorDB table as exported from its source file\n * @returns The table with every plugin-added field\n */\nexport async function getExtendedTable<T extends TailorAnyDBType>(\n  configPath: string,\n  sourceTable: T,\n): Promise<T> {\n  if (sourceTable.plugins.length === 0) {\n    return sourceTable;\n  }\n  const resolvedPath = path.resolve(configPath);\n  let tables = extendedTableCache.get(resolvedPath);\n  if (!tables) {\n    tables = new WeakMap();\n    extendedTableCache.set(resolvedPath, tables);\n  }\n  const cached = tables.get(sourceTable);\n  if (cached) {\n    return cached as Promise<T>;\n  }\n  const pending = applyPluginExtensions(resolvedPath, sourceTable);\n  tables.set(sourceTable, pending);\n  pending.catch(() => tables.delete(sourceTable));\n  return pending as Promise<T>;\n}\n\nasync function applyPluginExtensions(\n  configPath: string,\n  sourceTable: TailorAnyDBType,\n): Promise<TailorAnyDBType> {\n  const cache = await loadAndCacheConfig(configPath);\n  if (!cache) {\n    return sourceTable;\n  }\n  const { config, configDir, plugins } = cache;\n  const namespace = await resolveNamespaceForTable(config, configDir, sourceTable);\n  const manager = new PluginManager([...plugins.values()].map((entry) => entry.plugin));\n  const { extendedTable } = await manager.processAttachmentsForTable({\n    rawTable: sourceTable as unknown as TailorDBTypeRaw,\n    attachments: [...sourceTable.plugins],\n    namespace,\n  });\n  return (extendedTable as TailorAnyDBType | undefined) ?? sourceTable;\n}\n\n/**\n * Clear all internal caches. For testing only.\n */\nexport function _clearCacheForTesting(): void {\n  configCacheMap.clear();\n  extendedTableCache.clear();\n}\n"],"mappings":"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"}

package/dist/plugin/types.d.mts

@@ -254,6 +254,103 @@ export interface Plugin<TableConfig = unknown, PluginConfig = unknown, FieldExte
   onTailorDBReady?(context: TailorDBReadyContext<PluginConfig>): GeneratorResult | Promise<GeneratorResult>;
   onResolverReady?(context: ResolverReadyContext<PluginConfig>): GeneratorResult | Promise<GeneratorResult>;
   onExecutorReady?(context: ExecutorReadyContext<PluginConfig>): GeneratorResult | Promise<GeneratorResult>;
+  /** Runs after a successful deploy, including deploys with no resource changes. */
+  onDeployed?(context: DeployedContext<PluginConfig>): void | DeployedHookResult | Promise<void | DeployedHookResult>;
+}
+export interface PublishStaticWebsiteResult {
+  url: string;
+  skippedFiles: string[];
+}
+export interface DeployedStaticWebsite {
+  name: string;
+  url: string;
+}
+/** A static website declared in the config that registers the plugin, which the plugin can publish to. */
+export interface PublishableStaticWebsite extends DeployedStaticWebsite {
+  /** Uploads the directory at the absolute path `dir` and publishes it to this website. */
+  publish(dir: string): Promise<PublishStaticWebsiteResult>;
+}
+export interface DeployedOAuth2Client {
+  name: string;
+  clientId: string;
+}
+export interface DeployedApplication<StaticWebsite extends DeployedStaticWebsite = DeployedStaticWebsite> {
+  /** SDK-managed application ID from defineConfig(); undefined when the config has none. */
+  id?: string;
+  name: string;
+  configPath: string;
+  /** Application endpoint URL, present when a matching Platform Application exists. */
+  url?: string;
+  domain?: string;
+  aiGateways: {
+    name: string;
+    url: string;
+  }[];
+  /** Static websites declared in this application's config, keyed by name. */
+  staticWebsites: Readonly<Partial<Record<string, StaticWebsite>>>;
+  auth?: {
+    namespace: string;
+    oauth2Clients: DeployedOAuth2Client[];
+  };
+}
+export interface PluginLogger {
+  info(message: string): void;
+  warn(message: string): void;
+  success(message: string): void;
+}
+export interface PluginExecOptions {
+  /** Directory to run the command in. */
+  workingDir: string;
+  /** Environment variables added to the environment `tailor` runs with. */
+  env?: Record<string, string>;
+  /**
+   * Where the command's output goes. `"stream"` (default) writes both stdout and stderr to stderr
+   * so `--json` results on stdout stay parseable, `"capture"` returns them, and `"ignore"` discards them.
+   */
+  output?: "stream" | "capture" | "ignore";
+}
+export interface PluginExecResult {
+  /** Captured stdout. Empty unless `output` is `"capture"`. */
+  stdout: string;
+  /** Captured stderr. Empty unless `output` is `"capture"`. */
+  stderr: string;
+}
+/** Values available after all applications in this deploy run have been applied. */
+export interface DeployedContext<PluginConfig = unknown> {
+  workspaceId: string;
+  /** Application whose config registers this plugin. Only its static websites can be published. */
+  application: DeployedApplication<PublishableStaticWebsite>;
+  /** Every application in this deploy run, including the registering one. */
+  applications: readonly DeployedApplication[];
+  /** Absolute path of the config registering this plugin. */
+  configPath: string;
+  pluginConfig: PluginConfig;
+  logger: PluginLogger;
+  /**
+   * Run a shell command on the machine running `tailor deploy`. Rejects when the command exits with a non-zero code.
+   * @param command - Shell command, such as `pnpm build`
+   * @param options - Working directory, added environment variables, and output handling
+   * @returns Captured output when `options.output` is `"capture"`
+   */
+  exec(command: string, options: PluginExecOptions): Promise<PluginExecResult>;
+}
+type OutputObject = object & {
+  [Symbol.iterator]?: never;
+  [Symbol.toStringTag]?: never;
+  [Symbol.hasInstance]?: never;
+  [Symbol.toPrimitive]?: never;
+  [Symbol.match]?: never;
+};
+/**
+ * A value a plugin hook can return in `outputs`. Interface-typed objects are accepted;
+ * a `Date` or class instance nested inside one is rejected when the deploy runs.
+ */
+export type PluginOutputValue = string | number | boolean | null | readonly PluginOutputValue[] | {
+  [key: string]: PluginOutputValue;
+} | OutputObject;
+export interface DeployedHookResult {
+  /** Values included in deploy's JSON result. Interface-typed values are accepted, but a `Date` or class instance nested inside one fails the deploy instead of the type check. */
+  outputs?: Record<string, PluginOutputValue>;
 }
 //#endregion
 export type { PluginAttachment };