@tailor-platform/sdk 2.0.0-next.2 → 2.0.0-next.4

package/dist/cli/shared/config-loader.d.mts

@@ -0,0 +1,26 @@
+import { Plugin } from "../../plugin/types.mjs";
+import { AppConfig } from "../../configure/config/types.mjs";
+
+//#region src/cli/shared/config-loader.d.ts
+/**
+ * Loaded configuration with resolved path
+ */
+type LoadedConfig = AppConfig & {
+  path: string;
+};
+interface LoadConfigOptions {
+  /** Import cache-busting value for watch-mode reloads. */
+  importNonce?: string;
+}
+/**
+ * Load Tailor configuration file and associated plugins.
+ * @param configPath - Optional explicit config path
+ * @param options - Optional module import behavior.
+ * @returns Loaded config, plugins, and config path
+ */
+declare function loadConfig(configPath?: string, options?: LoadConfigOptions): Promise<{
+  config: LoadedConfig;
+  plugins: Plugin[];
+}>;
+//#endregion
+export { LoadConfigOptions, LoadedConfig, loadConfig };

package/dist/cli/shared/context.d.mts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+
+//#region src/cli/shared/context.d.ts
+type LoadWorkspaceIdOptions = {
+  workspaceId?: string;
+  profile?: string;
+};
+type LoadAccessTokenOptions = {
+  profile?: string;
+};
+/**
+ * Load workspace ID from command options, environment variables, or platform config.
+ * In CLI context, env fallback is also handled by politty's arg env option.
+ * Priority: opts/workspaceId > env/workspaceId > opts/profile > error
+ * @param opts - Workspace and profile options
+ * @returns Resolved workspace ID
+ */
+declare function loadWorkspaceId(opts?: LoadWorkspaceIdOptions): Promise<string>;
+/**
+ * Load access token from environment variables, command options, or platform config.
+ * In CLI context, profile env fallback is also handled by politty's arg env option.
+ * Priority: env/TAILOR_PLATFORM_TOKEN > env/TAILOR_TOKEN (deprecated) > opts/profile > env/profile > config/currentUser > error
+ * @param opts - Profile options
+ * @returns Resolved access token
+ */
+declare function loadAccessToken(opts?: LoadAccessTokenOptions): Promise<string>;
+//#endregion
+export { loadAccessToken, loadWorkspaceId };

package/dist/cli/shared/script-executor.d.mts

@@ -0,0 +1,75 @@
+import { AuthInvoker } from "../../tailor-proto/src/tailor/v1/auth_resource_pb.mjs";
+import { FunctionExecution_Status } from "../../tailor-proto/src/tailor/v1/function_resource_pb.mjs";
+import { OperatorClient } from "./client.mjs";
+import { Jsonifiable } from "type-fest";
+
+//#region src/cli/shared/script-executor.d.ts
+/**
+ * Options for script execution
+ */
+interface ScriptExecutionOptions<T extends Jsonifiable = Jsonifiable> {
+  /** Operator client instance */
+  client: OperatorClient;
+  /** Workspace ID */
+  workspaceId: string;
+  /** Script name (for identification) */
+  name: string;
+  /** Bundled script code to execute */
+  code: string;
+  /** Optional JSON-serializable argument to pass to the script */
+  arg?: T;
+  /** Auth invoker for script execution */
+  invoker: AuthInvoker;
+  /** Polling interval in milliseconds (default: 1000ms) */
+  pollInterval?: number;
+}
+/**
+ * Result of script execution
+ */
+interface ScriptExecutionResult {
+  /** Whether the script executed successfully */
+  success: boolean;
+  /** Logs output from the script execution */
+  logs: string;
+  /** Result value from the script execution */
+  result: string;
+  /** Error message if execution failed */
+  error?: string;
+}
+/**
+ * Result from waiting for execution completion
+ */
+interface ExecutionWaitResult {
+  /** Execution status */
+  status: FunctionExecution_Status;
+  /** Logs output from the execution */
+  logs: string;
+  /** Result value from the execution */
+  result: string;
+}
+/**
+ * Wait for a function execution to complete
+ *
+ * Polls the getFunctionExecution API until the execution reaches a terminal state
+ * (SUCCESS or FAILED).
+ * @param {OperatorClient} client - Operator client instance
+ * @param {string} workspaceId - Workspace ID
+ * @param {string} executionId - Execution ID to wait for
+ * @param {number} [pollInterval] - Polling interval in milliseconds (default: 1000ms)
+ * @returns {Promise<ExecutionWaitResult>} Execution result
+ * @throws {Error} If execution is not found
+ */
+declare function waitForExecution(client: OperatorClient, workspaceId: string, executionId: string, pollInterval?: number): Promise<ExecutionWaitResult>;
+/**
+ * Execute a script via TestExecScript API and wait for completion
+ *
+ * This function:
+ * 1. Calls testExecScript API to start execution
+ * 2. Polls getFunctionExecution until completion
+ * 3. Returns structured result with success/failure status
+ * @param {ScriptExecutionOptions} options - Execution options
+ * @returns {Promise<ScriptExecutionResult>} Execution result
+ */
+declare function executeScript<T extends Jsonifiable = Jsonifiable>(options: ScriptExecutionOptions<T>): Promise<ScriptExecutionResult>;
+//#endregion
+export { ExecutionWaitResult, ScriptExecutionOptions, ScriptExecutionResult, executeScript, waitForExecution };

package/dist/cli/shared/seed-chunker.d.mts

@@ -0,0 +1,46 @@
+//#region src/cli/shared/seed-chunker.d.ts
+/**
+ * Seed data chunker for splitting large seed data into manageable message sizes.
+ *
+ * When seed data exceeds the gRPC message size limit, this module splits the data
+ * into multiple chunks at type boundaries (or record boundaries for large types).
+ */
+/**
+ * Seed data keyed by type name, with an array of records per type.
+ */
+type SeedData = Record<string, Record<string, unknown>[]>;
+/**
+ * A single chunk of seed data with metadata for ordered execution.
+ */
+type SeedChunk = {
+  data: SeedData;
+  order: string[];
+  index: number;
+  total: number;
+};
+/**
+ * Options for chunking seed data.
+ */
+type ChunkSeedDataOptions = {
+  /** Seed data keyed by type name */data: SeedData; /** Ordered list of type names (dependency order) */
+  order: string[]; /** Byte size of the bundled seed script code */
+  codeByteSize: number; /** Maximum gRPC message size in bytes (default: 3.5MB) */
+  maxMessageSize?: number;
+};
+/**
+ * Split seed data into chunks that fit within the gRPC message size limit.
+ *
+ * Algorithm:
+ * 1. Calculate the available budget for the arg field (maxMessageSize - codeByteSize - overhead)
+ * 2. If all data fits in one message, return a single chunk
+ * 3. Otherwise, iterate through types in dependency order:
+ *    - If a type fits in the current chunk, add it
+ *    - If adding a type would exceed the budget, finalize the current chunk and start a new one
+ *    - If a single type exceeds the budget, split its records across multiple chunks
+ *    - If a single record exceeds the budget, throw an error
+ * @param options - Chunking options
+ * @returns Array of seed chunks
+ */
+declare function chunkSeedData(options: ChunkSeedDataOptions): SeedChunk[];
+//#endregion
+export { ChunkSeedDataOptions, SeedChunk, SeedData, chunkSeedData };

package/dist/cli/shared/trigger-context.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli/shared/type-generator.d.mts

@@ -0,0 +1,20 @@
+import { AppConfig } from "../../configure/config/types.mjs";
+
+//#region src/cli/shared/type-generator.d.ts
+/**
+ * Options for generating user type definitions
+ */
+interface GenerateUserTypesOptions {
+  /** Application config */
+  config: AppConfig;
+  /** Path to Tailor config file */
+  configPath: string;
+}
+/**
+ * Generate user type definitions from the app config and write them to disk.
+ * @param options - Generation options
+ * @returns Promise that resolves when types are generated
+ */
+declare function generateUserTypes(options: GenerateUserTypesOptions): Promise<void>;
+//#endregion
+export { generateUserTypes };

package/dist/cli/ts-hook.d.mts

@@ -0,0 +1,4 @@
+export declare function resolve(...args: unknown[]): Promise<unknown>;
+export declare function load(...args: unknown[]): Promise<unknown>;
+export declare function resolveSync(...args: unknown[]): unknown;
+export declare function loadSync(...args: unknown[]): unknown;

package/dist/cli/ts-hook.mjs

@@ -0,0 +1,333 @@
+import { readFileSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { dirname, join, resolve as resolvePath } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+// Node.js module hook: TypeScript resolver + type stripper via amaro.
+// Registered programmatically so the CLI can import user .ts files without
+// requiring --experimental-strip-types at process startup.
+import { transformSync } from "amaro";
+
+const TS_EXTENSIONS = [".ts", ".mts"];
+const JS_TO_TS = new Map([
+  [".js", ".ts"],
+  [".mjs", ".mts"],
+]);
+const KNOWN_EXTENSIONS = [".ts", ".tsx", ".mts", ".js", ".mjs", ".json"];
+
+// --- tsconfig paths resolution ---
+
+const tsconfigPathsCache = new Map();
+
+// Walks the `extends` chain and returns the nearest-defined `baseUrl` (which
+// may come from a different config than the one defining `paths`), the
+// nearest-defined `paths` object (TypeScript replaces, not merges, inherited
+// `paths` once a config defines its own), and the directory of the config
+// that defines that `paths` object (the TS 5.0+ fallback base when no
+// `baseUrl` is defined anywhere in the chain).
+function resolveEffectiveConfig(configFilePath, content, visited) {
+  if (visited.has(configFilePath)) return {};
+  visited.add(configFilePath);
+
+  const baseDir = dirname(configFilePath);
+  const opts = content.compilerOptions ?? {};
+  const ownBaseUrl =
+    typeof opts.baseUrl === "string" ? resolvePath(baseDir, opts.baseUrl) : undefined;
+  const ownRawPaths =
+    opts.paths && typeof opts.paths === "object" && !Array.isArray(opts.paths)
+      ? opts.paths
+      : undefined;
+
+  let inherited = {};
+  const extendsField = content.extends;
+  if (typeof extendsField === "string") {
+    const base = resolvePath(baseDir, extendsField);
+    const extendsPath = base.endsWith(".json") ? base : base + ".json";
+    try {
+      const sub = JSON.parse(readFileSync(extendsPath, "utf-8"));
+      inherited = resolveEffectiveConfig(extendsPath, sub, visited);
+    } catch (e) {
+      if (e?.code !== "ENOENT" && !(e instanceof SyntaxError)) throw e;
+    }
+  }
+
+  return {
+    baseUrl: ownBaseUrl ?? inherited.baseUrl,
+    rawPaths: ownRawPaths ?? inherited.rawPaths,
+    pathsBaseDir: ownRawPaths ? baseDir : inherited.pathsBaseDir,
+  };
+}
+
+function collectPathsInto(out, configFilePath, content, visited) {
+  const { baseUrl, rawPaths, pathsBaseDir } = resolveEffectiveConfig(
+    configFilePath,
+    content,
+    visited,
+  );
+  if (!rawPaths) return;
+
+  const absBase = baseUrl ?? pathsBaseDir ?? dirname(configFilePath);
+  for (const [alias, targets] of Object.entries(rawPaths)) {
+    if (!Array.isArray(targets)) continue;
+    const normalized = targets
+      .filter((t) => typeof t === "string")
+      .map((t) => {
+        const isWildcard = t.endsWith("/*");
+        const resolved = resolvePath(absBase, isWildcard ? t.slice(0, -2) : t);
+        return pathToFileURL(resolved).href + (isWildcard ? "/*" : "");
+      });
+    if (normalized.length === 0) continue;
+    out[alias] = normalized;
+  }
+}
+
+function loadTsconfigPaths(startDir) {
+  if (tsconfigPathsCache.has(startDir)) return tsconfigPathsCache.get(startDir);
+
+  const paths = Object.create(null);
+  let dir = startDir;
+  let prev = "";
+  while (dir !== prev) {
+    try {
+      const configFilePath = join(dir, "tsconfig.json");
+      const content = JSON.parse(readFileSync(configFilePath, "utf-8"));
+      collectPathsInto(paths, configFilePath, content, new Set());
+      break;
+    } catch (e) {
+      if (e?.code !== "ENOENT" && !(e instanceof SyntaxError)) throw e;
+      if (e instanceof SyntaxError) break;
+    }
+    prev = dir;
+    dir = dirname(dir);
+  }
+
+  tsconfigPathsCache.set(startDir, paths);
+  return paths;
+}
+
+function matchTsconfigPaths(specifier, paths) {
+  if (paths[specifier]?.length > 0) {
+    return paths[specifier];
+  }
+  const wildcardEntries = Object.entries(paths)
+    .filter(([alias]) => alias.endsWith("/*"))
+    .toSorted((a, b) => b[0].length - a[0].length);
+  for (const [alias, targets] of wildcardEntries) {
+    const prefix = alias.slice(0, -2);
+    if (specifier.startsWith(prefix + "/")) {
+      const rest = specifier.slice(prefix.length + 1);
+      return targets.map((t) => (t.endsWith("/*") ? t.slice(0, -2) + "/" + rest : t));
+    }
+  }
+  return null;
+}
+
+async function tryResolveWithExtensions(base, context, nextResolve) {
+  if (!TS_EXTENSIONS.some((ext) => base.endsWith(ext))) {
+    for (const ext of TS_EXTENSIONS) {
+      for (const suffix of ["", "/index"]) {
+        try {
+          return await nextResolve(base + suffix + ext, context);
+        } catch (e) {
+          if (e?.code !== "ERR_MODULE_NOT_FOUND") throw e;
+        }
+      }
+    }
+  }
+  try {
+    return await nextResolve(base, context);
+  } catch (e) {
+    const code = e?.code;
+    if (code !== "ERR_MODULE_NOT_FOUND" && code !== "ERR_UNSUPPORTED_DIR_IMPORT") throw e;
+  }
+  return null;
+}
+
+function tryResolveWithExtensionsSync(base, context, nextResolve) {
+  if (!TS_EXTENSIONS.some((ext) => base.endsWith(ext))) {
+    for (const ext of TS_EXTENSIONS) {
+      for (const suffix of ["", "/index"]) {
+        try {
+          return nextResolve(base + suffix + ext, context);
+        } catch (e) {
+          if (e?.code !== "ERR_MODULE_NOT_FOUND") throw e;
+        }
+      }
+    }
+  }
+  try {
+    return nextResolve(base, context);
+  } catch (e) {
+    const code = e?.code;
+    if (code !== "ERR_MODULE_NOT_FOUND" && code !== "ERR_UNSUPPORTED_DIR_IMPORT") throw e;
+  }
+  return null;
+}
+
+// --- module hooks ---
+
+export async function resolve(specifier, context, nextResolve) {
+  try {
+    return await nextResolve(specifier, context);
+  } catch (err) {
+    if (err.code !== "ERR_MODULE_NOT_FOUND" && err.code !== "ERR_UNSUPPORTED_DIR_IMPORT") throw err;
+
+    if (
+      err.code === "ERR_UNSUPPORTED_DIR_IMPORT" &&
+      (specifier.startsWith(".") || specifier.startsWith("/"))
+    ) {
+      for (const ext of TS_EXTENSIONS) {
+        try {
+          return await nextResolve(specifier + "/index" + ext, context);
+        } catch (e) {
+          if (e?.code !== "ERR_MODULE_NOT_FOUND") throw e;
+        }
+      }
+      throw err;
+    }
+
+    if (!specifier.startsWith(".") && !specifier.startsWith("/")) {
+      // Non-relative: try tsconfig path aliases
+      if (context.parentURL?.startsWith("file://")) {
+        const parentParsed = new URL(context.parentURL);
+        parentParsed.search = "";
+        parentParsed.hash = "";
+        const parentDir = dirname(fileURLToPath(parentParsed));
+        const tsconfigPaths = loadTsconfigPaths(parentDir);
+        const candidates = matchTsconfigPaths(specifier, tsconfigPaths);
+        if (candidates) {
+          for (const candidate of candidates) {
+            const result = await tryResolveWithExtensions(candidate, context, nextResolve);
+            if (result) return result;
+          }
+        }
+      }
+      throw err;
+    }
+
+    const lastSegment = specifier.split("/").pop() ?? "";
+    if (!KNOWN_EXTENSIONS.some((ext) => lastSegment.endsWith(ext))) {
+      for (const ext of TS_EXTENSIONS) {
+        try {
+          return await nextResolve(specifier + ext, context);
+        } catch (e) {
+          if (e?.code !== "ERR_MODULE_NOT_FOUND") throw e;
+        }
+      }
+    }
+
+    for (const [jsExt, tsExt] of JS_TO_TS) {
+      if (specifier.endsWith(jsExt)) {
+        try {
+          return await nextResolve(specifier.slice(0, -jsExt.length) + tsExt, context);
+        } catch (e) {
+          if (e?.code !== "ERR_MODULE_NOT_FOUND") throw e;
+        }
+      }
+    }
+
+    throw err;
+  }
+}
+
+export async function load(url, context, nextLoad) {
+  if (url.startsWith("file:")) {
+    const parsedUrl = new URL(url);
+    if (
+      TS_EXTENSIONS.some((ext) => parsedUrl.pathname.endsWith(ext)) &&
+      !parsedUrl.pathname.endsWith(".d.ts") &&
+      !parsedUrl.pathname.endsWith(".d.mts")
+    ) {
+      parsedUrl.search = "";
+      parsedUrl.hash = "";
+      const filePath = fileURLToPath(parsedUrl);
+      const source = await readFile(filePath, "utf-8");
+      const { code } = transformSync(source, { mode: "transform", filename: filePath });
+      return { format: "module", shortCircuit: true, source: `${code}\n//# sourceURL=${url}` };
+    }
+  }
+  return nextLoad(url, context);
+}
+
+// Sync hooks for module.registerHooks() (Node >= 22.15.0).
+export function resolveSync(specifier, context, nextResolve) {
+  try {
+    return nextResolve(specifier, context);
+  } catch (err) {
+    if (err.code !== "ERR_MODULE_NOT_FOUND" && err.code !== "ERR_UNSUPPORTED_DIR_IMPORT") throw err;
+
+    if (
+      err.code === "ERR_UNSUPPORTED_DIR_IMPORT" &&
+      (specifier.startsWith(".") || specifier.startsWith("/"))
+    ) {
+      for (const ext of TS_EXTENSIONS) {
+        try {
+          return nextResolve(specifier + "/index" + ext, context);
+        } catch (e) {
+          if (e?.code !== "ERR_MODULE_NOT_FOUND") throw e;
+        }
+      }
+      throw err;
+    }
+
+    if (!specifier.startsWith(".") && !specifier.startsWith("/")) {
+      // Non-relative: try tsconfig path aliases
+      if (context.parentURL?.startsWith("file://")) {
+        const parentParsed = new URL(context.parentURL);
+        parentParsed.search = "";
+        parentParsed.hash = "";
+        const parentDir = dirname(fileURLToPath(parentParsed));
+        const tsconfigPaths = loadTsconfigPaths(parentDir);
+        const candidates = matchTsconfigPaths(specifier, tsconfigPaths);
+        if (candidates) {
+          for (const candidate of candidates) {
+            const result = tryResolveWithExtensionsSync(candidate, context, nextResolve);
+            if (result) return result;
+          }
+        }
+      }
+      throw err;
+    }
+
+    const lastSegment = specifier.split("/").pop() ?? "";
+    if (!KNOWN_EXTENSIONS.some((ext) => lastSegment.endsWith(ext))) {
+      for (const ext of TS_EXTENSIONS) {
+        try {
+          return nextResolve(specifier + ext, context);
+        } catch (e) {
+          if (e?.code !== "ERR_MODULE_NOT_FOUND") throw e;
+        }
+      }
+    }
+
+    for (const [jsExt, tsExt] of JS_TO_TS) {
+      if (specifier.endsWith(jsExt)) {
+        try {
+          return nextResolve(specifier.slice(0, -jsExt.length) + tsExt, context);
+        } catch (e) {
+          if (e?.code !== "ERR_MODULE_NOT_FOUND") throw e;
+        }
+      }
+    }
+
+    throw err;
+  }
+}
+
+export function loadSync(url, context, nextLoad) {
+  if (url.startsWith("file:")) {
+    const parsedUrl = new URL(url);
+    if (
+      TS_EXTENSIONS.some((ext) => parsedUrl.pathname.endsWith(ext)) &&
+      !parsedUrl.pathname.endsWith(".d.ts") &&
+      !parsedUrl.pathname.endsWith(".d.mts")
+    ) {
+      parsedUrl.search = "";
+      parsedUrl.hash = "";
+      const filePath = fileURLToPath(parsedUrl);
+      const source = readFileSync(filePath, "utf-8");
+      const { code } = transformSync(source, { mode: "transform", filename: filePath });
+      return { format: "module", shortCircuit: true, source: `${code}\n//# sourceURL=${url}` };
+    }
+  }
+  return nextLoad(url, context);
+}