@tailor-platform/sdk 2.2.0 → 2.4.0

package/dist/cli/ts-hook.mjs

@@ -80,8 +80,11 @@ function collectPathsInto(out, configFilePath, content, visited) {
   }
 }
 
-function loadTsconfigPaths(startDir) {
-  if (tsconfigPathsCache.has(startDir)) return tsconfigPathsCache.get(startDir);
+// cacheGeneration partitions the cache per import-nonce run, so a tsconfig
+// edited between two in-process runs is re-read instead of served stale.
+function loadTsconfigPaths(startDir, cacheGeneration) {
+  const cacheKey = `${cacheGeneration}\u0000${startDir}`;
+  if (tsconfigPathsCache.has(cacheKey)) return tsconfigPathsCache.get(cacheKey);
 
   const paths = Object.create(null);
   let dir = startDir;
@@ -100,7 +103,7 @@ function loadTsconfigPaths(startDir) {
     dir = dirname(dir);
   }
 
-  tsconfigPathsCache.set(startDir, paths);
+  tsconfigPathsCache.set(cacheKey, paths);
   return paths;
 }
 
@@ -163,9 +166,44 @@ function tryResolveWithExtensionsSync(base, context, nextResolve) {
   return null;
 }
 
+// --- import-nonce propagation ---
+
+const IMPORT_NONCE_PARAM = "tailorImportNonce";
+
+// Carries a parent's cache-busting nonce onto project-local resolutions, so a
+// nonce'd entry module gets a fresh evaluation of its whole project subgraph.
+// Bare specifiers are left alone: node_modules packages (and workspace-linked
+// ones resolving outside node_modules) must stay singletons.
+function propagateImportNonce(resolved, context) {
+  if (!resolved?.url?.startsWith("file:")) return resolved;
+  if (!context.parentURL?.startsWith("file:")) return resolved;
+  const nonce = new URL(context.parentURL).searchParams.get(IMPORT_NONCE_PARAM);
+  if (!nonce) return resolved;
+  const url = new URL(resolved.url);
+  if (url.searchParams.has(IMPORT_NONCE_PARAM) || url.pathname.includes("/node_modules/")) {
+    return resolved;
+  }
+  url.searchParams.set(IMPORT_NONCE_PARAM, nonce);
+  return { ...resolved, url: url.href };
+}
+
+function isProjectLocalSpecifier(specifier) {
+  return (
+    specifier.startsWith(".") ||
+    specifier.startsWith("/") ||
+    specifier.startsWith("file:") ||
+    specifier.startsWith("#")
+  );
+}
+
 // --- module hooks ---
 
 export async function resolve(specifier, context, nextResolve) {
+  const resolved = await resolveTs(specifier, context, nextResolve);
+  return isProjectLocalSpecifier(specifier) ? propagateImportNonce(resolved, context) : resolved;
+}
+
+async function resolveTs(specifier, context, nextResolve) {
   try {
     return await nextResolve(specifier, context);
   } catch (err) {
@@ -189,15 +227,16 @@ export async function resolve(specifier, context, nextResolve) {
       // Non-relative: try tsconfig path aliases
       if (context.parentURL?.startsWith("file://")) {
         const parentParsed = new URL(context.parentURL);
+        const parentNonce = parentParsed.searchParams.get(IMPORT_NONCE_PARAM) ?? "";
         parentParsed.search = "";
         parentParsed.hash = "";
         const parentDir = dirname(fileURLToPath(parentParsed));
-        const tsconfigPaths = loadTsconfigPaths(parentDir);
+        const tsconfigPaths = loadTsconfigPaths(parentDir, parentNonce);
         const candidates = matchTsconfigPaths(specifier, tsconfigPaths);
         if (candidates) {
           for (const candidate of candidates) {
             const result = await tryResolveWithExtensions(candidate, context, nextResolve);
-            if (result) return result;
+            if (result) return propagateImportNonce(result, context);
           }
         }
       }
@@ -248,8 +287,15 @@ export async function load(url, context, nextLoad) {
   return nextLoad(url, context);
 }
 
-// Sync hooks for module.registerHooks() (Node >= 22.15.0).
+// Sync hooks for module.registerHooks() (Node >= 22.15.0). Node < 22.18.0 crashes
+// on require() of scheme-only builtins (node:sqlite, node:test, node:sea) once both
+// resolve and load are registered — nodejs/node#58607, fixed by nodejs/node#58612.
 export function resolveSync(specifier, context, nextResolve) {
+  const resolved = resolveTsSync(specifier, context, nextResolve);
+  return isProjectLocalSpecifier(specifier) ? propagateImportNonce(resolved, context) : resolved;
+}
+
+function resolveTsSync(specifier, context, nextResolve) {
   try {
     return nextResolve(specifier, context);
   } catch (err) {
@@ -273,15 +319,16 @@ export function resolveSync(specifier, context, nextResolve) {
       // Non-relative: try tsconfig path aliases
       if (context.parentURL?.startsWith("file://")) {
         const parentParsed = new URL(context.parentURL);
+        const parentNonce = parentParsed.searchParams.get(IMPORT_NONCE_PARAM) ?? "";
         parentParsed.search = "";
         parentParsed.hash = "";
         const parentDir = dirname(fileURLToPath(parentParsed));
-        const tsconfigPaths = loadTsconfigPaths(parentDir);
+        const tsconfigPaths = loadTsconfigPaths(parentDir, parentNonce);
         const candidates = matchTsconfigPaths(specifier, tsconfigPaths);
         if (candidates) {
           for (const candidate of candidates) {
             const result = tryResolveWithExtensionsSync(candidate, context, nextResolve);
-            if (result) return result;
+            if (result) return propagateImportNonce(result, context);
           }
         }
       }

package/dist/completion/zsh-worker.zsh

@@ -1,5 +1,5 @@
 # politty-completion-version: 1
-# politty-bin-sig: 1786155894
+# politty-bin-sig: 1787009813
 # politty-bin-path: /home/runner/work/sdk/sdk/node_modules/.bin/tailor
 # program: tailor
 # shell: zsh
@@ -590,6 +590,12 @@ __tailor_worker_opt_takes_value() {
         function:logs:--profile|function:logs:-p|function:logs:--p) return 0 ;;
         function:logs:--order) return 0 ;;
         function:logs:--limit|function:logs:-l|function:logs:--l) return 0 ;;
+        function:run:--workspace-id|function:run:--workspaceId|function:run:-w|function:run:--w) return 0 ;;
+        function:run:--profile|function:run:-p|function:run:--p) return 0 ;;
+        function:run:--name|function:run:-n|function:run:--n) return 0 ;;
+        function:run:--arg|function:run:-a|function:run:--a) return 0 ;;
+        function:run:--machine-user|function:run:--machineUser|function:run:-m|function:run:--m) return 0 ;;
+        function:run:--config|function:run:-c|function:run:--c) return 0 ;;
         function:test-run:--workspace-id|function:test-run:--workspaceId|function:test-run:-w|function:test-run:--w) return 0 ;;
         function:test-run:--profile|function:test-run:-p|function:test-run:--p) return 0 ;;
         function:test-run:--name|function:test-run:-n|function:test-run:--n) return 0 ;;
@@ -739,6 +745,9 @@ __tailor_worker_opt_takes_value() {
         tailordb:truncate:--namespace|tailordb:truncate:-n|tailordb:truncate:--n) return 0 ;;
         tailordb:migration:generate:--config|tailordb:migration:generate:-c|tailordb:migration:generate:--c) return 0 ;;
         tailordb:migration:generate:--name|tailordb:migration:generate:-n|tailordb:migration:generate:--n) return 0 ;;
+        tailordb:migration:generate:--rename) return 0 ;;
+        tailordb:migration:generate:--drop) return 0 ;;
+        tailordb:migration:generate:--expand-contract|tailordb:migration:generate:--expandContract) return 0 ;;
         tailordb:migration:rebaseline:--workspace-id|tailordb:migration:rebaseline:--workspaceId|tailordb:migration:rebaseline:-w|tailordb:migration:rebaseline:--w) return 0 ;;
         tailordb:migration:rebaseline:--profile|tailordb:migration:rebaseline:-p|tailordb:migration:rebaseline:--p) return 0 ;;
         tailordb:migration:rebaseline:--config|tailordb:migration:rebaseline:-c|tailordb:migration:rebaseline:--c) return 0 ;;
@@ -898,6 +907,7 @@ __tailor_worker_is_subcmd() {
         function:get) return 0 ;;
         function:list) return 0 ;;
         function:logs) return 0 ;;
+        function:run) return 0 ;;
         function:test-run) return 0 ;;
         :function) return 0 ;;
         :generate) return 0 ;;
@@ -945,6 +955,7 @@ __tailor_worker_is_subcmd() {
         setup:preview) return 0 ;;
         setup:action) return 0 ;;
         setup:coordinate) return 0 ;;
+        setup:renovate) return 0 ;;
         setup:check) return 0 ;;
         setup:delete) return 0 ;;
         :setup) return 0 ;;
@@ -1645,9 +1656,9 @@ __tailor_worker_complete_function_logs() {
     esac
 }
 
-__tailor_worker_complete_function_test_run() {
+__tailor_worker_complete_function_run() {
     local -a _vals=()
-    if __tailor_worker_opt_takes_value "function:test-run" "${words[CURRENT-1]}"; then return 0; fi
+    if __tailor_worker_opt_takes_value "function:run" "${words[CURRENT-1]}"; then return 0; fi
     if (( _after_dd )); then
         case "$_pos_count" in
             0)
@@ -1683,7 +1694,7 @@ __tailor_worker_complete_function() {
         __tailor_worker_cdescribe 'options' _opts
         return 0
     fi
-    local -a _subs=("get:Get a function registry by name" "list:List function registries in a workspace" "logs:List or get function execution logs." "test-run:Run a function on the Tailor Platform server without deploying.")
+    local -a _subs=("get:Get a function registry by name" "list:List function registries in a workspace" "logs:List or get function execution logs." "run:Run a function on the Tailor Platform server without deploying." "test-run:Run a function on the Tailor Platform server without deploying.")
     __tailor_worker_cdescribe 'subcommands' _subs
 }
 
@@ -2241,7 +2252,7 @@ __tailor_worker_complete_profile_create() {
         __tailor_worker_not_used "--user" "-u" "--u" && _opts+=("--user:User email address or machine user client ID")
         __tailor_worker_not_used "--workspace-id" "--workspaceId" "-w" "--w" && _opts+=("--workspace-id:Workspace ID")
         __tailor_worker_not_used "--permission" && _opts+=("--permission:Profile permission. 'read' blocks all write commands while the profile is active.")
-        __tailor_worker_not_used "--machine-user" "--machineUser" "-m" "--m" && _opts+=("--machine-user:Default machine user name for application-data commands (query, workflow start, function test-run, machineuser token).")
+        __tailor_worker_not_used "--machine-user" "--machineUser" "-m" "--m" && _opts+=("--machine-user:Default machine user name for application-data commands (query, workflow start, function run, machineuser token).")
         __tailor_worker_not_used "--machine-user-override" "--machineUserOverride" && _opts+=("--machine-user-override:Whether the command line or TAILOR_PLATFORM_MACHINE_USER_NAME may override the profile's machine user. 'deny' requires --machine-user.")
         __tailor_worker_not_used "--platform-url" "--platformUrl" && _opts+=("--platform-url:Platform API base URL for this profile.")
         __tailor_worker_not_used "--oauth2-client-id" "--oauth2ClientId" && _opts+=("--oauth2-client-id:OAuth2 client ID for logging in to this profile's platform.")
@@ -2315,7 +2326,7 @@ __tailor_worker_complete_profile_update() {
         __tailor_worker_not_used "--user" "-u" "--u" && _opts+=("--user:New user email address or machine user client ID")
         __tailor_worker_not_used "--workspace-id" "--workspaceId" "-w" "--w" && _opts+=("--workspace-id:New workspace ID")
         __tailor_worker_not_used "--permission" && _opts+=("--permission:Profile permission. 'read' blocks all write commands; 'write' lifts the restriction.")
-        __tailor_worker_not_used "--machine-user" "--machineUser" "-m" "--m" && _opts+=("--machine-user:Default machine user name for application-data commands (query, workflow start, function test-run, machineuser token). Pass an empty string to clear.")
+        __tailor_worker_not_used "--machine-user" "--machineUser" "-m" "--m" && _opts+=("--machine-user:Default machine user name for application-data commands (query, workflow start, function run, machineuser token). Pass an empty string to clear.")
         __tailor_worker_not_used "--machine-user-override" "--machineUserOverride" && _opts+=("--machine-user-override:Whether the command line or TAILOR_PLATFORM_MACHINE_USER_NAME may override the profile's machine user. 'deny' requires --machine-user; 'allow' lifts the restriction.")
         __tailor_worker_not_used "--platform-url" "--platformUrl" && _opts+=("--platform-url:Platform API base URL for this profile. Pass an empty string to clear.")
         __tailor_worker_not_used "--oauth2-client-id" "--oauth2ClientId" && _opts+=("--oauth2-client-id:OAuth2 client ID for logging in to this profile's platform. Pass an empty string to clear.")
@@ -2705,6 +2716,18 @@ __tailor_worker_complete_setup_coordinate() {
     fi
 }
 
+__tailor_worker_complete_setup_renovate() {
+    local -a _vals=()
+    if __tailor_worker_opt_takes_value "setup:renovate" "${words[CURRENT-1]}"; then return 0; fi
+    if (( _after_dd )); then return 0; fi
+    if [[ "${words[CURRENT]}" == -* ]]; then
+        local -a _opts=()
+        __tailor_worker_not_used "--help" && _opts+=("--help:Show help")
+        __tailor_worker_cdescribe 'options' _opts
+        return 0
+    fi
+}
+
 __tailor_worker_complete_setup_check() {
     local -a _vals=()
     if __tailor_worker_opt_takes_value "setup:check" "${words[CURRENT-1]}"; then return 0; fi
@@ -2751,7 +2774,7 @@ __tailor_worker_complete_setup() {
         __tailor_worker_cdescribe 'options' _opts
         return 0
     fi
-    local -a _subs=("branch:Generate a branch-target deploy workflow (push to branch triggers deploy)." "tag:Generate a tag-target deploy workflow (tag push triggers deploy)." "preview:Generate a preview workflow (PR open/sync triggers deploy to a per-PR workspace)." "action:Generate a per-app composite action for use with setup coordinate (monorepo multi-app deploys)." "coordinate:Generate a coordinator workflow that orchestrates multiple --action-generated composite actions." "check:Audit generated workflows for drift against the current config/repo (read-only)." "delete:Delete managed workflow/action file(s) and their .github/tailor.lock entries.")
+    local -a _subs=("branch:Generate a branch-target deploy workflow (push to branch triggers deploy)." "tag:Generate a tag-target deploy workflow (tag push triggers deploy)." "preview:Generate a preview workflow (PR open/sync triggers deploy to a per-PR workspace)." "action:Generate a per-app composite action for use with setup coordinate (monorepo multi-app deploys)." "coordinate:Generate a coordinator workflow that orchestrates multiple --action-generated composite actions." "renovate:Generate a Renovate config for Tailor dependency and workflow updates." "check:Audit generated workflows for drift against the current config/repo (read-only)." "delete:Delete managed workflow/action file(s) and their .github/tailor.lock entries.")
     __tailor_worker_cdescribe 'subcommands' _subs
 }
 
@@ -3035,6 +3058,9 @@ __tailor_worker_complete_tailordb_migration_generate() {
         __tailor_worker_not_used "--config" "-c" "--c" && _opts+=("--config:Path to Tailor config file")
         __tailor_worker_not_used "--name" "-n" "--n" && _opts+=("--name:Optional description for the migration")
         __tailor_worker_not_used "--init" && _opts+=("--init:Delete existing migrations and start fresh")
+        _opts+=("--rename:Record a field or table rename instead of remove + add (format\: \"Table.oldField\:newField\" or \"OldTable\:NewTable\"; repeatable). Renames require a migration script that copies the data.")
+        _opts+=("--drop:Confirm that a removed field or table is a genuine removal, not a rename (format\: \"Table.field\" or \"Table\"; repeatable). Required in non-interactive runs for a removal with rename candidates.")
+        _opts+=("--expand-contract:Convert a field type through a temporary field (format\: \"Table.field\"; repeatable). Generates two migrations.")
         __tailor_worker_not_used "--help" && _opts+=("--help:Show help")
         __tailor_worker_cdescribe 'options' _opts
         return 0
@@ -3430,7 +3456,7 @@ __tailor_worker_complete_tailordb_migration() {
         __tailor_worker_cdescribe 'options' _opts
         return 0
     fi
-    local -a _subs=("generate:Generate migration files by detecting schema differences between current local types and the previous migration snapshot." "rebaseline:Collapse the full migration history into a new 0000 baseline." "script:Add a migration script (migrate.ts) template to an existing migration directory, or record with --no-script that a migration intentionally has none." "set:Set migration checkpoint to a specific number." "status:Show the current migration status for TailorDB namespaces, including applied and pending migrations." "sync:Sync remote TailorDB schema to a specific migration snapshot (recovery from --no-schema-check drift)." "test:Test pending migrations with seed fixtures or cloned data in a temporary workspace." "validate:Validate the full migration history, unreviewed generated migration scripts, and schema drift (local types vs. migration snapshot, remote schema vs. migration checkpoint) without deploying. This includes the migration and schema-drift checks used by 'deploy' and exits with a non-zero code when issues are found.")
+    local -a _subs=("generate:Generate migration files by detecting schema differences between current local tables and the previous migration snapshot." "rebaseline:Collapse the full migration history into a new 0000 baseline." "script:Add a migration script (migrate.ts) template to an existing migration directory, or record with --no-script that a migration intentionally has none." "set:Set migration checkpoint to a specific number." "status:Show the current migration status for TailorDB namespaces, including applied and pending migrations." "sync:Sync remote TailorDB schema to a specific migration snapshot (recovery from --no-schema-check drift)." "test:Test pending migrations with seed fixtures or cloned data in a temporary workspace." "validate:Validate the full migration history, unreviewed generated migration scripts, and schema drift (local tables vs. migration snapshot, remote schema vs. migration checkpoint) without deploying. This includes the migration and schema-drift checks used by 'deploy' and exits with a non-zero code when issues are found.")
     __tailor_worker_cdescribe 'subcommands' _subs
 }
 
@@ -4241,7 +4267,7 @@ __tailor_worker_complete_root() {
         __tailor_worker_not_used "--help" && _opts+=("--help:Show help")
         __tailor_worker_cdescribe 'options' _opts
     else
-        local -a _subs=("api:Call Tailor Platform API endpoints directly." "auth:Authentication helpers for scripts and plugins." "authconnection:Manage auth connections." "crashreport:Manage crash reports." "deploy:Deploy your application by applying the Tailor configuration." "executor:Manage executors" "function:Manage functions" "generate:Generate files using Tailor configuration." "init:Initialize a new project using create-sdk." "login:Login to Tailor Platform." "logout:Logout from Tailor Platform." "machineuser:Manage machine users in your Tailor Platform application." "oauth2client:Manage OAuth2 clients in your Tailor Platform application." "open:Open Tailor Platform Console." "organization:Manage Tailor Platform organizations." "plugin:Manage and inspect CLI plugins (beta)." "profile:Manage workspace profiles (user + workspace combinations)." "query:Run SQL/GraphQL query." "remove:Remove all resources managed by the application from the workspace." "secret:Manage Secret Manager vaults and secrets." "setup:Generate CI deploy workflows for your project. (beta)" "show:Show information about the deployed application." "staticwebsite:Manage static websites in your workspace." "tailordb:Manage TailorDB tables and data." "upgrade:Run codemods to upgrade your project to a newer SDK version." "user:Manage Tailor Platform users." "workflow:Manage workflows and workflow executions." "workspace:Manage Tailor Platform workspaces." "skills:Manage Tailor SDK agent skills." "completion:Generate shell completion script")
+        local -a _subs=("api:Call Tailor Platform API endpoints directly." "auth:Authentication helpers for scripts and plugins." "authconnection:Manage auth connections." "crashreport:Manage crash reports." "deploy:Deploy your application by applying the Tailor configuration." "executor:Manage executors" "function:Manage functions" "generate:Generate files using Tailor configuration." "init:Initialize a new project using create-sdk." "login:Login to Tailor Platform." "logout:Logout from Tailor Platform." "machineuser:Manage machine users in your Tailor Platform application." "oauth2client:Manage OAuth2 clients in your Tailor Platform application." "open:Open Tailor Platform Console." "organization:Manage Tailor Platform organizations." "plugin:Manage and inspect CLI plugins (beta)." "profile:Manage workspace profiles (user + workspace combinations)." "query:Run SQL/GraphQL query." "remove:Remove all resources managed by the application from the workspace." "secret:Manage Secret Manager vaults and secrets." "setup:Set up repository automation for your project. (beta)" "show:Show information about the deployed application." "staticwebsite:Manage static websites in your workspace." "tailordb:Manage TailorDB tables and data." "upgrade:Run codemods to upgrade your project to a newer SDK version." "user:Manage Tailor Platform users." "workflow:Manage workflows and workflow executions." "workspace:Manage Tailor Platform workspaces." "skills:Manage Tailor SDK agent skills." "completion:Generate shell completion script")
         __tailor_worker_cdescribe 'subcommands' _subs
     fi
 }
@@ -4313,7 +4339,8 @@ _tailor_worker_completions() {
         function:get) __tailor_worker_complete_function_get ;;
         function:list) __tailor_worker_complete_function_list ;;
         function:logs) __tailor_worker_complete_function_logs ;;
-        function:test-run) __tailor_worker_complete_function_test_run ;;
+        function:run) __tailor_worker_complete_function_run ;;
+        function:test-run) __tailor_worker_complete_function_run ;;
         function) __tailor_worker_complete_function ;;
         generate) __tailor_worker_complete_generate ;;
         init) __tailor_worker_complete_init ;;
@@ -4360,6 +4387,7 @@ _tailor_worker_completions() {
         setup:preview) __tailor_worker_complete_setup_preview ;;
         setup:action) __tailor_worker_complete_setup_action ;;
         setup:coordinate) __tailor_worker_complete_setup_coordinate ;;
+        setup:renovate) __tailor_worker_complete_setup_renovate ;;
         setup:check) __tailor_worker_complete_setup_check ;;
         setup:delete) __tailor_worker_complete_setup_delete ;;
         setup) __tailor_worker_complete_setup ;;

package/dist/configure/config/index.d.mts

@@ -11,7 +11,7 @@ declare function defineConfig<const Config extends AppConfig & Record<Exclude<ke
 /**
  * Define plugins to be used with the Tailor SDK.
  * Plugins can generate additional types, resolvers, and executors
- * based on existing TailorDB types.
+ * based on existing TailorDB tables.
  * @param configs - Plugin configurations
  * @returns Plugin configurations as given
  */

package/dist/configure/index.d.mts

@@ -10,6 +10,7 @@ import { Resolver } from "../types/resolver.generated.mjs";
 import { ExecutorReadyContext, GeneratorResult, NamespacePluginOutput, Plugin, PluginConfigs, PluginExecutorContext, PluginExecutorContextBase, PluginGeneratedExecutor, PluginGeneratedExecutorWithFile, PluginGeneratedResolver, PluginGeneratedType, PluginNamespaceProcessContext, PluginOutput, PluginProcessContext, ResolverNamespaceData, ResolverReadyContext, TailorDBNamespaceData, TailorDBReadyContext, TailorDBTypeForPlugin, TypePluginOutput } from "../plugin/types.mjs";
 import { PermissionCondition, TailorTypeGqlPermission, TailorTypePermission, unsafeAllowAllGqlPermission, unsafeAllowAllTypePermission } from "./services/tailordb/permission.mjs";
 import { TailorAnyDBField, TailorAnyDBType, TailorDBField, TailorDBInstance, TailorDBType, db } from "./services/tailordb/schema.mjs";
+import { AuthNamespaceName, AuthNamespaceNameRegistry } from "./types/auth-namespace-name.mjs";
 import { AIGatewayConfig } from "./services/aigateway/types.mjs";
 import { IdPPermission, IdPPermissionCondition, unsafeAllowAllIdPPermission } from "./services/idp/permission.mjs";
 import { IdPEmailConfig, IdPGqlOperations, IdPGqlOperationsInput } from "../types/idp.generated.mjs";
@@ -38,7 +39,7 @@ import { IncomingWebhookArgs, IncomingWebhookRequest, IncomingWebhookResponse, I
 import { Trigger } from "./services/executor/trigger/index.mjs";
 import { createExecutor } from "./services/executor/executor.mjs";
 import { defineWorkflowExecutionPolicies, defineWorkflowExecutionPolicy } from "./services/workflow/execution-policy.mjs";
-import { WaitPointInstance, createWaitPoint, createWaitPoints } from "./services/workflow/wait-point.mjs";
+import { ParameterizedWaitPointInstance, WaitPointInstance, createWaitPoint, createWaitPoints } from "./services/workflow/wait-point.mjs";
 import { defineStaticWebSite } from "./services/staticwebsite/index.mjs";
 import { defineAIGateway } from "./services/aigateway/index.mjs";
 import { defineIdp } from "./services/idp/index.mjs";
@@ -132,4 +133,4 @@ declare namespace t {
   type infer<T> = TailorOutput<T>;
 }
 //#endregion
-export { type AIGatewayConfig, type AIGatewayName, type AIGatewayNameRegistry, type AttributeList, type Attributes, AuthAccessTokenArgs, AuthAccessTokenIssuedArgs, AuthAccessTokenRefreshedArgs, AuthAccessTokenRevokedArgs, AuthAccessTokenTrigger, type AuthConfig, type AuthConnectionConfig, type AuthConnectionOAuth2Config, type AuthConnectionTokenResult, type AuthExternalConfig, type AuthOwnConfig, type AuthServiceInput, type BeforeLoginClaims, type BeforeLoginHookArgs, type BuiltinIdP, type ConcurrencyPolicy, type ConnectionName, type ConnectionNameRegistry, type DefinedAuth, type Env, type ExecutionPolicyConcurrency, type ExecutionPolicyDefInput, type ExecutionPolicyExactInstance, type ExecutionPolicyGroupOptions, type ExecutionPolicyInstance, type ExecutionPolicyWildcardInstance, type ExecutorReadyContext, type ExecutorServiceConfig, type ExecutorServiceInput, type FederatedIdentity, type FederatedIdentityClaims, type FederatedIdentityProvider, FunctionOperation, type GeneratorResult, GqlOperation, HttpAdapter, HttpAdapterGraphQLQuery, HttpAdapterGraphQLRequest, HttpAdapterGraphQLResponse, HttpAdapterInput, HttpAdapterInputFn, HttpAdapterOutputFn, HttpAdapterRequest, HttpAdapterResponse, HttpAdapterTypedDocumentNode, type IDToken, type IdPConfig, type IdPEmailConfig, type IdPExternalConfig, type IdPGqlOperations, type IdPGqlOperationsInput as IdPGqlOperationsConfig, type IdPPermission, type IdPPermissionCondition, type IdProvider as IdProviderConfig, type IdpName, type IdpNameRegistry, IdpUserArgs, IdpUserCreatedArgs, IdpUserDeletedArgs, IdpUserTrigger, IdpUserUpdatedArgs, IncomingWebhookArgs, IncomingWebhookRequest, IncomingWebhookResponse, IncomingWebhookResponseConfig, IncomingWebhookTrigger, IncomingWebhookTriggerOptions, type IsAutoFilledDBField, type IsReadOnlyDBField, type MachineUserName, type MachineUserNameRegistry, type NamespacePluginOutput, type OAuth2ClientInput as OAuth2Client, type OAuth2ClientGrantType, type OIDC, Operation, type PermissionCondition, type Plugin, type PluginAttachment, type PluginConfigs, type PluginExecutorContext, type PluginExecutorContextBase, type PluginGeneratedExecutor, type PluginGeneratedExecutorWithFile, type PluginGeneratedResolver, type PluginGeneratedType, type PluginNamespaceProcessContext, type PluginOutput, type PluginProcessContext, type QueryType, RecordCreatedArgs, RecordDeletedArgs, RecordUpdatedArgs, type ResolvedExecutionPolicyInstance, type Resolver, ResolverExecutedArgs, ResolverExecutedTrigger, type ResolverExternalConfig, type ResolverNamespaceData, type ResolverPermission, type ResolverPermissionCondition, type ResolverPermissionPolicy, type ResolverReadyContext, type ResolverServiceConfig, type ResolverServiceInput, type RetryPolicy, type SAML, type SCIMAttribute, type SCIMAttributeMapping, type SCIMAttributeType, type SCIMAuthorization, type SCIMConfig, type SCIMResource, ScheduleArgs, ScheduleTrigger, type SecretsConfig, type StaticWebsiteConfig, type TailorAnyDBField, type TailorAnyDBType, type TailorDBField, type TailorDBInstance, type TailorDBNamespaceData, type TailorDBReadyContext, TailorDBTrigger, type TailorDBType, type TailorDBTypeForPlugin, type TailorField, type TailorPrincipal, type TailorTypeGqlPermission, type TailorTypePermission, type TenantProvider as TenantProviderConfig, Trigger, type TypePluginOutput, type UserAttributeKey, type UserAttributeListKey, type UserAttributes, type UsernameFieldKey, type ValueOperand, WaitPointInstance, WebhookOperation, Workflow, WorkflowConfig, WorkflowExecutionArgs, WorkflowExecutionCompletedArgs, WorkflowExecutionResumedArgs, WorkflowExecutionRetriedArgs, WorkflowExecutionStartedArgs, WorkflowExecutionTrigger, WorkflowExecutionWaitResolvedArgs, WorkflowExecutionWaitStartedArgs, WorkflowJob, WorkflowJobContext, WorkflowJobExecutionArgs, WorkflowJobExecutionCompletedArgs, WorkflowJobExecutionStartedArgs, WorkflowJobExecutionTrigger, WorkflowJobExecutionWaitResolvedArgs, WorkflowJobExecutionWaitStartedArgs, WorkflowOperation, type WorkflowServiceConfig, type WorkflowServiceInput, authAccessTokenIssuedTrigger, authAccessTokenRefreshedTrigger, authAccessTokenRevokedTrigger, authAccessTokenTrigger, createExecutor, createHttpAdapter, createResolver, createWaitPoint, createWaitPoints, createWorkflow, createWorkflowJob, db, defineAIGateway, defineAuth, defineConfig, defineIdp, definePlugins, defineSecretManager, defineStaticWebSite, defineWorkflowExecutionPolicies, defineWorkflowExecutionPolicy, idpUserCreatedTrigger, idpUserDeletedTrigger, idpUserTrigger, idpUserUpdatedTrigger, incomingWebhookTrigger, infer, output, recordCreatedTrigger, recordDeletedTrigger, recordTrigger, recordUpdatedTrigger, resolverExecutedTrigger, scheduleTrigger, t, unsafeAllowAllGqlPermission, unsafeAllowAllIdPPermission, unsafeAllowAllTypePermission, workflowExecutionCompletedTrigger, workflowExecutionResumedTrigger, workflowExecutionRetriedTrigger, workflowExecutionStartedTrigger, workflowExecutionTrigger, workflowExecutionWaitResolvedTrigger, workflowExecutionWaitStartedTrigger, workflowJobExecutionCompletedTrigger, workflowJobExecutionStartedTrigger, workflowJobExecutionTrigger, workflowJobExecutionWaitResolvedTrigger, workflowJobExecutionWaitStartedTrigger };
+export { type AIGatewayConfig, type AIGatewayName, type AIGatewayNameRegistry, type AttributeList, type Attributes, AuthAccessTokenArgs, AuthAccessTokenIssuedArgs, AuthAccessTokenRefreshedArgs, AuthAccessTokenRevokedArgs, AuthAccessTokenTrigger, type AuthConfig, type AuthConnectionConfig, type AuthConnectionOAuth2Config, type AuthConnectionTokenResult, type AuthExternalConfig, type AuthNamespaceName, type AuthNamespaceNameRegistry, type AuthOwnConfig, type AuthServiceInput, type BeforeLoginClaims, type BeforeLoginHookArgs, type BuiltinIdP, type ConcurrencyPolicy, type ConnectionName, type ConnectionNameRegistry, type DefinedAuth, type Env, type ExecutionPolicyConcurrency, type ExecutionPolicyDefInput, type ExecutionPolicyExactInstance, type ExecutionPolicyGroupOptions, type ExecutionPolicyInstance, type ExecutionPolicyWildcardInstance, type ExecutorReadyContext, type ExecutorServiceConfig, type ExecutorServiceInput, type FederatedIdentity, type FederatedIdentityClaims, type FederatedIdentityProvider, FunctionOperation, type GeneratorResult, GqlOperation, HttpAdapter, HttpAdapterGraphQLQuery, HttpAdapterGraphQLRequest, HttpAdapterGraphQLResponse, HttpAdapterInput, HttpAdapterInputFn, HttpAdapterOutputFn, HttpAdapterRequest, HttpAdapterResponse, HttpAdapterTypedDocumentNode, type IDToken, type IdPConfig, type IdPEmailConfig, type IdPExternalConfig, type IdPGqlOperations, type IdPGqlOperationsInput as IdPGqlOperationsConfig, type IdPPermission, type IdPPermissionCondition, type IdProvider as IdProviderConfig, type IdpName, type IdpNameRegistry, IdpUserArgs, IdpUserCreatedArgs, IdpUserDeletedArgs, IdpUserTrigger, IdpUserUpdatedArgs, IncomingWebhookArgs, IncomingWebhookRequest, IncomingWebhookResponse, IncomingWebhookResponseConfig, IncomingWebhookTrigger, IncomingWebhookTriggerOptions, type IsAutoFilledDBField, type IsReadOnlyDBField, type MachineUserName, type MachineUserNameRegistry, type NamespacePluginOutput, type OAuth2ClientInput as OAuth2Client, type OAuth2ClientGrantType, type OIDC, Operation, ParameterizedWaitPointInstance, type PermissionCondition, type Plugin, type PluginAttachment, type PluginConfigs, type PluginExecutorContext, type PluginExecutorContextBase, type PluginGeneratedExecutor, type PluginGeneratedExecutorWithFile, type PluginGeneratedResolver, type PluginGeneratedType, type PluginNamespaceProcessContext, type PluginOutput, type PluginProcessContext, type QueryType, RecordCreatedArgs, RecordDeletedArgs, RecordUpdatedArgs, type ResolvedExecutionPolicyInstance, type Resolver, ResolverExecutedArgs, ResolverExecutedTrigger, type ResolverExternalConfig, type ResolverNamespaceData, type ResolverPermission, type ResolverPermissionCondition, type ResolverPermissionPolicy, type ResolverReadyContext, type ResolverServiceConfig, type ResolverServiceInput, type RetryPolicy, type SAML, type SCIMAttribute, type SCIMAttributeMapping, type SCIMAttributeType, type SCIMAuthorization, type SCIMConfig, type SCIMResource, ScheduleArgs, ScheduleTrigger, type SecretsConfig, type StaticWebsiteConfig, type TailorAnyDBField, type TailorAnyDBType, type TailorDBField, type TailorDBInstance, type TailorDBNamespaceData, type TailorDBReadyContext, TailorDBTrigger, type TailorDBType, type TailorDBTypeForPlugin, type TailorField, type TailorPrincipal, type TailorTypeGqlPermission, type TailorTypePermission, type TenantProvider as TenantProviderConfig, Trigger, type TypePluginOutput, type UserAttributeKey, type UserAttributeListKey, type UserAttributes, type UsernameFieldKey, type ValueOperand, WaitPointInstance, WebhookOperation, Workflow, WorkflowConfig, WorkflowExecutionArgs, WorkflowExecutionCompletedArgs, WorkflowExecutionResumedArgs, WorkflowExecutionRetriedArgs, WorkflowExecutionStartedArgs, WorkflowExecutionTrigger, WorkflowExecutionWaitResolvedArgs, WorkflowExecutionWaitStartedArgs, WorkflowJob, WorkflowJobContext, WorkflowJobExecutionArgs, WorkflowJobExecutionCompletedArgs, WorkflowJobExecutionStartedArgs, WorkflowJobExecutionTrigger, WorkflowJobExecutionWaitResolvedArgs, WorkflowJobExecutionWaitStartedArgs, WorkflowOperation, type WorkflowServiceConfig, type WorkflowServiceInput, authAccessTokenIssuedTrigger, authAccessTokenRefreshedTrigger, authAccessTokenRevokedTrigger, authAccessTokenTrigger, createExecutor, createHttpAdapter, createResolver, createWaitPoint, createWaitPoints, createWorkflow, createWorkflowJob, db, defineAIGateway, defineAuth, defineConfig, defineIdp, definePlugins, defineSecretManager, defineStaticWebSite, defineWorkflowExecutionPolicies, defineWorkflowExecutionPolicy, idpUserCreatedTrigger, idpUserDeletedTrigger, idpUserTrigger, idpUserUpdatedTrigger, incomingWebhookTrigger, infer, output, recordCreatedTrigger, recordDeletedTrigger, recordTrigger, recordUpdatedTrigger, resolverExecutedTrigger, scheduleTrigger, t, unsafeAllowAllGqlPermission, unsafeAllowAllIdPPermission, unsafeAllowAllTypePermission, workflowExecutionCompletedTrigger, workflowExecutionResumedTrigger, workflowExecutionRetriedTrigger, workflowExecutionStartedTrigger, workflowExecutionTrigger, workflowExecutionWaitResolvedTrigger, workflowExecutionWaitStartedTrigger, workflowJobExecutionCompletedTrigger, workflowJobExecutionStartedTrigger, workflowJobExecutionTrigger, workflowJobExecutionWaitResolvedTrigger, workflowJobExecutionWaitStartedTrigger };

package/dist/configure/index.mjs

@@ -1,7 +1,8 @@
-import { i as parseInternal, n as mapAllowedValues, t as db } from "../schema--xYWRGfe.mjs";
+import { i as parseInternal, n as mapAllowedValues, t as db } from "../schema-D4TC4BC3.mjs";
 import { t as brandValue } from "../brand-Eo4pLXPJ.mjs";
 import { a as registerJob, n as dispatchStartJob, r as dispatchStartWorkflow } from "../registry-BIGVUrMB.mjs";
-import { i as withWorkflowTestInvoker } from "../test-env-key-D7UkZp99.mjs";
+import { l as withWorkflowTestInvoker, n as attachWaitPointKey, r as createWaitPointInvoker, t as attachWaitPointInvoker } from "../wait-point-invoker-__oE88_P.mjs";
+import { r as registerWaitPoint } from "../wait-point-registry-TL99zotw.mjs";
 
 //#region src/configure/types/type.ts
 function createTailorField(type, options, fields, values, metadata) {
@@ -880,10 +881,39 @@ function createWorkflowJob(config) {
 
 //#endregion
 //#region src/configure/services/workflow/wait-point.ts
-function getPlatformWorkflow() {
-	const workflow = globalThis.tailor?.workflow;
-	if (!workflow) throw new Error("tailor.workflow is not available. Run tests in the `tailor-runtime` Vitest environment, or acquire mockWorkflow() from @tailor-platform/sdk/vitest and set a wait/resolve handler.");
-	return workflow;
+const KEY_REGEX = /^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$/;
+const PARAM_VALUE_REGEX = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
+const MAX_KEY_LENGTH = 63;
+const KEY_GRAMMAR = "[a-z0-9-] (3-63 characters; must start and end with [a-z0-9])";
+function parseKey(key) {
+	const segments = key.split("-");
+	return {
+		segments,
+		paramNames: segments.filter((s) => s.startsWith("$") && s.length > 1).map((s) => s.slice(1))
+	};
+}
+function composeKey(key, parsed, params) {
+	const composed = parsed.segments.map((segment) => {
+		if (!segment.startsWith("$") || segment.length === 1) return segment;
+		const name = segment.slice(1);
+		const value = params[name];
+		if (typeof value !== "string") throw new Error(`Wait point "${key}" needs a string for parameter "${name}" but received ${value === void 0 ? "undefined" : typeof value}.`);
+		if (!PARAM_VALUE_REGEX.test(value)) throw new Error(`Wait point "${key}" cannot use ${JSON.stringify(value)} for parameter "${name}": values may only contain [a-z0-9-] and cannot be empty or start or end with "-".`);
+		return value;
+	}).join("-");
+	if (composed.length > MAX_KEY_LENGTH) throw new Error(`Wait point key "${composed}" built from "${key}" is ${composed.length} characters; the limit is ${MAX_KEY_LENGTH}.`);
+	if (!KEY_REGEX.test(composed)) throw new Error(`Wait point key "${composed}" built from "${key}" must match ${KEY_GRAMMAR}.`);
+	return composed;
+}
+function createBoundWaitPoint(invoker, readKey) {
+	return {
+		wait(payload) {
+			return Promise.resolve(invoker.wait(readKey(), payload));
+		},
+		async resolve(executionId, callback) {
+			await invoker.resolve(readKey(), executionId, callback);
+		}
+	};
 }
 /**
 * Create a WaitPointInstance that delegates to the platform runtime.
@@ -894,22 +924,47 @@ function getPlatformWorkflow() {
 */
 function createWaitPointInstance(initialKey) {
 	let key = initialKey;
+	const invoker = createWaitPointInvoker();
+	const instance = brandValue(createBoundWaitPoint(invoker, () => key), "wait-point");
+	attachWaitPointInvoker(instance, invoker);
 	return {
-		instance: brandValue({
-			wait(payload) {
-				return Promise.resolve(getPlatformWorkflow().wait(key, payload));
-			},
-			async resolve(executionId, callback) {
-				await getPlatformWorkflow().resolve(executionId, key, callback);
-			}
-		}, "wait-point"),
+		instance,
 		setKey: (k) => {
 			key = k;
 		}
 	};
 }
+function createParameterizedWaitPointInstance(key, parsed, declaredBy) {
+	const invoker = createWaitPointInvoker();
+	const unbound = () => {
+		throw new Error(declaredBy === "define" ? `Wait point key "${key}" has $params, so it identifies no single suspension on its own. Bind them first: waitPoint.with({ ... }).wait(...).` : `Wait point key "${key}" has $params, which createWaitPoint cannot type. Declare it through createWaitPoints instead: createWaitPoints((define) => ({ myWaitPoint: define.for("${key}")<Payload, Result>() })).`);
+	};
+	const instance = brandValue({
+		with(params) {
+			const composed = composeKey(key, parsed, params);
+			return attachWaitPointKey(createBoundWaitPoint(invoker, () => composed), composed);
+		},
+		wait: unbound,
+		resolve: unbound
+	}, "wait-point");
+	attachWaitPointInvoker(instance, invoker);
+	return instance;
+}
+function createKeyedWaitPoint(key, declaredBy) {
+	registerWaitPoint({
+		key,
+		declaredBy
+	});
+	const parsed = parseKey(key);
+	return parsed.paramNames.length > 0 ? createParameterizedWaitPointInstance(key, parsed, declaredBy) : createWaitPointInstance(key).instance;
+}
 /**
-* Create a single typed wait point with an explicit key.
+* Create a single typed wait point with a fixed key.
+*
+* The key must match `[a-z0-9-]` (3-63 characters, starting and ending with
+* `[a-z0-9]`), which `deploy` reports on. For a key with `$params`, use
+* {@link createWaitPoints}: binding params needs the key inferred as a literal
+* type, which only its `define` offers.
 *
 * `Payload` and `Result` must be JsonValue-compatible.
 * Functions and objects with a `toJSON` method are rejected at the type level;
@@ -921,13 +976,14 @@ function createWaitPointInstance(initialKey) {
 *
 * await approval.wait({ message: "Please approve" });
 */
-/* @__NO_SIDE_EFFECTS__ */
 function createWaitPoint(key) {
-	return createWaitPointInstance(key).instance;
+	return createKeyedWaitPoint(key, "createWaitPoint");
 }
 /**
 * Create a group of typed wait points for human-in-the-loop workflows.
-* Property names become the wait point keys.
+* Property names become the wait point keys, so they must match
+* `[a-z0-9-]`, which `deploy` reports on — pass an explicit key to `define`
+* when they do not.
 *
 * The return type is the same as the builder's return type, so JSDoc on each
 * property is preserved and visible in IDE autocompletion.
@@ -941,23 +997,34 @@ function createWaitPoint(key) {
 * export const waitPoints = createWaitPoints(define => ({
 *   // Preceding JSDoc on this property is shown in IDE autocompletion
 *   approval: define<{ message: string }, { approved: boolean }>(),
+*   // A key with $params is bound per call through `.with()`
+*   lineApproval: define.for("line-approval-$lineId")<{ message: string }, { approved: boolean }>(),
 * }));
 *
-* // IDE shows the JSDoc when typing `waitPoints.`
 * await waitPoints.approval.wait({ message: "Please approve" });
+* await waitPoints.lineApproval.with({ lineId: line.id }).wait({ message: "Please approve" });
 *
 * // For 2-level access, use destructured export with JSDoc attached to the export itself.
 */
-/* @__NO_SIDE_EFFECTS__ */
 function createWaitPoints(builder) {
 	const setters = /* @__PURE__ */ new Map();
-	const define = (() => {
+	const result = builder(Object.assign(() => {
 		const { instance, setKey } = createWaitPointInstance("__pending__");
 		setters.set(instance, setKey);
 		return instance;
-	});
-	const result = builder(define);
-	for (const key of Object.keys(result)) setters.get(result[key])?.(key);
+	}, { for: (key) => {
+		const instance = createKeyedWaitPoint(key, "define");
+		return () => instance;
+	} }));
+	for (const propName of Object.keys(result)) {
+		const setter = setters.get(result[propName]);
+		if (!setter) continue;
+		registerWaitPoint({
+			key: propName,
+			declaredBy: "property"
+		});
+		setter(propName);
+	}
 	return result;
 }
 
@@ -1182,7 +1249,7 @@ function defineConfig(config) {
 /**
 * Define plugins to be used with the Tailor SDK.
 * Plugins can generate additional types, resolvers, and executors
-* based on existing TailorDB types.
+* based on existing TailorDB tables.
 * @param configs - Plugin configurations
 * @returns Plugin configurations as given
 */