@walkeros/cli 3.3.1 → 3.4.0-next-1776749829492

package/dist/index.js

@@ -193,6 +193,33 @@ var init_config_file = __esm({
   }
 });
 
+// src/core/client-context.ts
+function setClientContext(input) {
+  const envType = process.env.WALKEROS_CLIENT_TYPE;
+  const type = envType ?? input.type ?? "cli";
+  context = { type, version: input.version };
+}
+function getClientContext() {
+  return context;
+}
+function resetClientContext() {
+  context = void 0;
+}
+function clientContextHeaders() {
+  if (!context) return {};
+  return {
+    "User-Agent": `walkeros-${context.type}/${context.version}`,
+    "X-WalkerOS-Client": context.type,
+    "X-WalkerOS-Client-Version": context.version
+  };
+}
+var context;
+var init_client_context = __esm({
+  "src/core/client-context.ts"() {
+    "use strict";
+  }
+});
+
 // src/core/http.ts
 function normalizeHeaders(headers) {
   if (!headers) return {};
@@ -205,17 +232,29 @@ function mergeAuthHeaders(token, headers) {
   if (token) normalized.Authorization = `Bearer ${token}`;
   return normalized;
 }
+function buildHeaders(token, headers) {
+  return {
+    ...clientContextHeaders(),
+    ...mergeAuthHeaders(token, headers)
+  };
+}
 async function apiFetch(path19, init) {
   const baseUrl = resolveAppUrl();
   const token = resolveToken()?.token;
   return fetch(`${baseUrl}${path19}`, {
     ...init,
-    headers: mergeAuthHeaders(token, init?.headers)
+    headers: buildHeaders(token, init?.headers)
   });
 }
 async function publicFetch(path19, init) {
   const baseUrl = resolveAppUrl();
-  return fetch(`${baseUrl}${path19}`, init);
+  return fetch(`${baseUrl}${path19}`, {
+    ...init,
+    headers: {
+      ...clientContextHeaders(),
+      ...normalizeHeaders(init?.headers)
+    }
+  });
 }
 async function deployFetch(path19, init) {
   const baseUrl = resolveAppUrl();
@@ -226,13 +265,14 @@ async function deployFetch(path19, init) {
     );
   return fetch(`${baseUrl}${path19}`, {
     ...init,
-    headers: mergeAuthHeaders(token, init?.headers)
+    headers: buildHeaders(token, init?.headers)
   });
 }
 var init_http = __esm({
   "src/core/http.ts"() {
     "use strict";
     init_config_file();
+    init_client_context();
   }
 });
 
@@ -1741,7 +1781,8 @@ ${dataDeclaration}`;
     } else {
       const stage2Entry = (buildOptions.platform || "node") === "browser" ? generateWebEntry(stage1Path, dataPayload, {
         windowCollector: buildOptions.windowCollector,
-        windowElb: buildOptions.windowElb
+        windowElb: buildOptions.windowElb,
+        platform: buildOptions.platform
       }) : generateServerEntry(stage1Path, dataPayload);
       const stage2EntryPath = path10.join(TEMP_DIR, "stage2.mjs");
       await fs9.writeFile(stage2EntryPath, stage2Entry);
@@ -2131,6 +2172,7 @@ async function createEntryPoint(flowSettings, buildOptions, packagePaths) {
     validateComponentNames(flowWithSections.transformers, "transformers");
   if (flowWithSections.stores)
     validateComponentNames(flowWithSections.stores, "stores");
+  const withDev = buildOptions.withDev !== void 0 ? buildOptions.withDev === true : buildOptions.skipWrapper === true;
   const { importStatements, devExportEntries } = await generateImportStatements(
     buildOptions.packages,
     destinationPackages,
@@ -2139,7 +2181,7 @@ async function createEntryPoint(flowSettings, buildOptions, packagePaths) {
     storePackages,
     explicitCodeImports,
     packagePaths,
-    buildOptions.skipWrapper === true
+    withDev
   );
   const importsCode = importStatements.join("\n");
   const hasFlow = Object.values(flowSettings.sources || {}).some(
@@ -2408,12 +2450,24 @@ function generateWebEntry(stage1Path, dataPayload, options = {}) {
     );
   }
   const assignmentCode = assignments.length > 0 ? "\n" + assignments.join("\n") : "";
+  const platform = options.platform ?? "browser";
+  const envBlock = platform === "browser" ? `
+  if (config.sources) {
+    for (const key of Object.keys(config.sources)) {
+      const source = config.sources[key];
+      if (!source) continue;
+      const env = source.env ?? (source.env = {});
+      env.window = env.window ?? (typeof window !== 'undefined' ? window : undefined);
+      env.document = env.document ?? (typeof document !== 'undefined' ? document : undefined);
+    }
+  }` : "";
   return `import { startFlow, wireConfig } from '${stage1Path}';
 
 const __configData = ${dataPayload};
 
 (async () => {
-  const { collector, elb } = await startFlow(wireConfig(__configData));${assignmentCode}
+  const config = wireConfig(__configData);${envBlock}
+  const { collector, elb } = await startFlow(config);${assignmentCode}
 })();`;
 }
 function generateWrapEntry(stage1Path, options = {}) {
@@ -2459,10 +2513,22 @@ function generateWrapEntry(stage1Path, options = {}) {
   }
   // --- End preview mode preflight ---
 ` : "";
+  const platform = options.platform ?? "browser";
+  const envBlock = platform === "browser" ? `
+  if (config.sources) {
+    for (const key of Object.keys(config.sources)) {
+      const source = config.sources[key];
+      if (!source) continue;
+      const env = source.env ?? (source.env = {});
+      env.window = env.window ?? (typeof window !== 'undefined' ? window : undefined);
+      env.document = env.document ?? (typeof document !== 'undefined' ? document : undefined);
+    }
+  }` : "";
   return `import { startFlow, wireConfig, __configData } from '${stage1Path}';
 
 (async () => {${preflightBlock}
-  const { collector, elb } = await startFlow(wireConfig(__configData));${assignmentCode}
+  const config = wireConfig(__configData);${envBlock}
+  const { collector, elb } = await startFlow(config);${assignmentCode}
 })();`;
 }
 function generateWrapEntryServer(stage1Path) {
@@ -2568,6 +2634,55 @@ var init_bundler = __esm({
   }
 });
 
+// src/commands/bundle/targets.ts
+function resolveTarget(target) {
+  const preset = BUNDLE_TARGETS[target];
+  if (!preset) {
+    throw new Error(
+      `Unknown target: ${target}. Valid: ${Object.keys(BUNDLE_TARGETS).join(", ")}`
+    );
+  }
+  return preset;
+}
+var BUNDLE_TARGETS;
+var init_targets = __esm({
+  "src/commands/bundle/targets.ts"() {
+    "use strict";
+    BUNDLE_TARGETS = Object.freeze({
+      cdn: Object.freeze({
+        skipWrapper: false,
+        withDev: false,
+        platform: "browser",
+        injectEnv: true
+      }),
+      "cdn-skeleton": Object.freeze({
+        skipWrapper: true,
+        withDev: false,
+        platform: "browser",
+        injectEnv: false
+      }),
+      runner: Object.freeze({
+        skipWrapper: true,
+        withDev: false,
+        platform: "node",
+        injectEnv: false
+      }),
+      simulate: Object.freeze({
+        skipWrapper: true,
+        withDev: true,
+        platform: "node",
+        injectEnv: false
+      }),
+      push: Object.freeze({
+        skipWrapper: true,
+        withDev: true,
+        platform: "node",
+        injectEnv: false
+      })
+    });
+  }
+});
+
 // src/commands/bundle/upload.ts
 import fs10 from "fs-extra";
 function sanitizeUrl(url) {
@@ -2640,7 +2755,8 @@ function createApiClient() {
     baseUrl: resolveAppUrl(),
     headers: {
       Authorization: `Bearer ${token}`,
-      "Content-Type": "application/json"
+      "Content-Type": "application/json",
+      ...clientContextHeaders()
     }
   });
 }
@@ -2649,6 +2765,7 @@ var init_api_client = __esm({
     "use strict";
     init_auth();
     init_config_file();
+    init_client_context();
   }
 });
 
@@ -2868,6 +2985,20 @@ Build Summary: ${successCount}/${results.length} succeeded`
   }
 }
 async function bundle(configOrPath, options = {}) {
+  let effectiveTarget;
+  if (options.target) {
+    effectiveTarget = options.target;
+  } else if (options.buildOverrides?.skipWrapper === true) {
+    effectiveTarget = "simulate";
+  } else {
+    effectiveTarget = "cdn";
+  }
+  const preset = resolveTarget(effectiveTarget);
+  if (options.buildOverrides?.skipWrapper !== void 0 && !options.target && process.env.WALKEROS_SUPPRESS_DEPRECATIONS !== "1") {
+    console.warn(
+      "[@walkeros/cli] buildOverrides.skipWrapper is deprecated. Pass `target: 'cdn' | 'cdn-skeleton' | 'runner' | 'simulate' | 'push'` instead. Set WALKEROS_SUPPRESS_DEPRECATIONS=1 to silence this warning."
+    );
+  }
   let rawConfig;
   let configPath = path12.resolve(process.cwd(), "walkeros.config.json");
   if (typeof configOrPath === "string") {
@@ -2876,10 +3007,15 @@ async function bundle(configOrPath, options = {}) {
   } else {
     rawConfig = configOrPath;
   }
+  const mergedOverrides = {
+    ...options.buildOverrides ?? {},
+    skipWrapper: preset.skipWrapper,
+    withDev: preset.withDev
+  };
   const { flowSettings, buildOptions } = loadBundleConfig(rawConfig, {
     configPath,
     flowName: options.flowName,
-    buildOverrides: options.buildOverrides
+    buildOverrides: mergedOverrides
   });
   if (options.cache !== void 0) {
     buildOptions.cache = options.cache;
@@ -2918,6 +3054,7 @@ var init_bundle = __esm({
     init_config();
     init_utils();
     init_bundler();
+    init_targets();
     init_upload();
     init_stats();
     init_api_client();
@@ -4645,7 +4782,7 @@ import { resolve as resolve2, dirname as dirname2 } from "path";
 // src/runtime/load-bundle.ts
 import { resolve } from "path";
 import { pathToFileURL as pathToFileURL2 } from "url";
-async function loadBundle(file, context, logger) {
+async function loadBundle(file, context2, logger) {
   const absolutePath = resolve(file);
   const fileUrl = pathToFileURL2(absolutePath).href;
   logger?.debug?.(`Importing bundle: ${absolutePath}`);
@@ -4656,7 +4793,7 @@ async function loadBundle(file, context, logger) {
     );
   }
   logger?.debug?.("Calling factory function...");
-  const result = await module.default(context ?? {});
+  const result = await module.default(context2 ?? {});
   if (!result || !result.collector || typeof result.collector.push !== "function") {
     throw new Error(
       `Invalid bundle: factory must return { collector } with a push function`
@@ -5652,7 +5789,7 @@ function buildConnectionGraph(config) {
   return connections;
 }
 function checkCompatibility(conn, errors, warnings) {
-  const fromOuts = Object.entries(conn.from.examples).filter(([, ex]) => ex.out !== void 0 && ex.out !== false).map(([name, ex]) => ({ name, value: ex.out }));
+  const fromOuts = Object.entries(conn.from.examples).filter(([, ex]) => ex.out !== void 0 && ex.out.length > 0).map(([name, ex]) => ({ name, value: ex.out }));
   const toIns = Object.entries(conn.to.examples).filter(([, ex]) => ex.in !== void 0).map(([name, ex]) => ({ name, value: ex.in }));
   const path19 = `${conn.from.type}.${conn.from.name} \u2192 ${conn.to.type}.${conn.to.name}`;
   if (fromOuts.length === 0 || toIns.length === 0) {
@@ -6125,6 +6262,63 @@ async function logoutCommand(options) {
 
 // src/commands/auth/index.ts
 init_api_client();
+
+// src/core/api-error.ts
+var ApiError = class extends Error {
+  code;
+  details;
+  // Populated only for CLIENT_OUTDATED responses (HTTP 426).
+  minVersion;
+  clientVersion;
+  client;
+  upgrade;
+  docs;
+  constructor(message, options) {
+    super(message);
+    this.name = "ApiError";
+    this.code = options?.code;
+    this.details = options?.details;
+    this.minVersion = options?.minVersion;
+    this.clientVersion = options?.clientVersion;
+    this.client = options?.client;
+    this.upgrade = options?.upgrade;
+    this.docs = options?.docs;
+  }
+};
+function throwApiError(error, fallbackMessage) {
+  if (error && typeof error === "object" && "error" in error && typeof error.error === "object") {
+    const inner = error.error;
+    const message = inner.message || fallbackMessage;
+    const code = inner.code;
+    const details = inner.details?.errors;
+    const options = { code, details };
+    if (code === "CLIENT_OUTDATED") {
+      options.minVersion = inner.minVersion;
+      options.clientVersion = inner.clientVersion;
+      options.client = inner.client;
+      options.upgrade = inner.upgrade;
+      options.docs = inner.docs;
+    }
+    throw new ApiError(message, options);
+  }
+  throw new ApiError(fallbackMessage);
+}
+function handleCliError(err) {
+  if (err instanceof ApiError && err.code === "CLIENT_OUTDATED") {
+    console.error(`
+${err.message}
+`);
+    if (err.upgrade) console.error(`  Upgrade: ${err.upgrade}`);
+    if (err.docs) console.error(`  Docs:    ${err.docs}
+`);
+    process.exit(2);
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  console.error(message);
+  process.exit(1);
+}
+
+// src/commands/auth/index.ts
 init_cli_logger();
 init_output();
 async function whoami() {
@@ -6146,15 +6340,13 @@ async function whoamiCommand(options) {
       if (data.projectId) logger.info(`Project: ${data.projectId}`);
     }
   } catch (error) {
-    logger.error(error instanceof Error ? error.message : String(error));
-    process.exit(1);
+    handleCliError(error);
   }
 }
 
 // src/commands/projects/index.ts
 init_api_client();
 init_auth();
-init_cli_logger();
 init_output();
 async function listProjects() {
   const client = createApiClient();
@@ -6202,13 +6394,11 @@ async function deleteProject(options = {}) {
   return data ?? { success: true };
 }
 async function handleResult(fn, options) {
-  const logger = createCLILogger(options);
   try {
     const result = await fn();
     await writeResult(JSON.stringify(result, null, 2), options);
   } catch (error) {
-    logger.error(error instanceof Error ? error.message : String(error));
-    process.exit(1);
+    handleCliError(error);
   }
 }
 async function listProjectsCommand(options) {
@@ -6245,32 +6435,7 @@ async function deleteProjectCommand(projectId, options) {
 
 // src/commands/flows/index.ts
 init_api_client();
-
-// src/core/api-error.ts
-var ApiError = class extends Error {
-  code;
-  details;
-  constructor(message, options) {
-    super(message);
-    this.name = "ApiError";
-    this.code = options?.code;
-    this.details = options?.details;
-  }
-};
-function throwApiError(error, fallbackMessage) {
-  if (error && typeof error === "object" && "error" in error && typeof error.error === "object") {
-    const inner = error.error;
-    const message = inner.message || fallbackMessage;
-    const code = inner.code;
-    const details = inner.details?.errors;
-    throw new ApiError(message, { code, details });
-  }
-  throw new ApiError(fallbackMessage);
-}
-
-// src/commands/flows/index.ts
 init_auth();
-init_cli_logger();
 init_output();
 init_stdin();
 async function listFlows(options = {}) {
@@ -6361,13 +6526,11 @@ async function duplicateFlow(options) {
   return data;
 }
 async function handleResult2(fn, options) {
-  const logger = createCLILogger(options);
   try {
     const result = await fn();
     await writeResult(JSON.stringify(result, null, 2), options);
   } catch (error) {
-    logger.error(error instanceof Error ? error.message : String(error));
-    process.exit(1);
+    handleCliError(error);
   }
 }
 async function listFlowsCommand(options) {
@@ -6635,8 +6798,7 @@ async function deployCommand(flowId, options) {
       log.info(`Status: ${r2.status}`);
     }
   } catch (err) {
-    log.error(err instanceof Error ? err.message : "Deploy failed");
-    process.exit(1);
+    handleCliError(err);
   }
 }
 async function getDeploymentCommand(flowId, options) {
@@ -6663,8 +6825,7 @@ async function getDeploymentCommand(flowId, options) {
     if (r2.publicUrl) log.info(`URL: ${r2.publicUrl}`);
     if (r2.errorMessage) log.error(`Error: ${r2.errorMessage}`);
   } catch (err) {
-    log.error(err instanceof Error ? err.message : "Failed to get deployment");
-    process.exit(1);
+    handleCliError(err);
   }
 }
 
@@ -6728,13 +6889,11 @@ async function deleteDeployment(options) {
   return data ?? { success: true };
 }
 async function handleResult3(fn, options) {
-  const logger = createCLILogger(options);
   try {
     const result = await fn();
     await writeResult(JSON.stringify(result, null, 2), options);
   } catch (error) {
-    logger.error(error instanceof Error ? error.message : String(error));
-    process.exit(1);
+    handleCliError(error);
   }
 }
 async function listDeploymentsCommand(options) {
@@ -6836,18 +6995,15 @@ async function createDeployCommand(config, options) {
     log.info("             -e WALKEROS_APP_URL=https://app.walkeros.io \\");
     log.info("             walkeros/flow:latest");
   } catch (err) {
-    log.error(
-      err instanceof Error ? err.message : "Failed to create deployment"
-    );
-    process.exit(1);
+    handleCliError(err);
   }
 }
 
 // src/commands/feedback/index.ts
 init_config_file();
 init_http();
-init_cli_logger();
 import { createInterface } from "readline";
+init_cli_logger();
 async function feedback(text, options) {
   const config = readConfig();
   const anonymous = options?.anonymous ?? config?.anonymousFeedback ?? true;
@@ -6900,8 +7056,7 @@ async function feedbackCommand(text) {
     await feedback(text, { anonymous });
     logger.info("Feedback sent. Thanks!");
   } catch (error) {
-    logger.error(error instanceof Error ? error.message : String(error));
-    process.exit(1);
+    handleCliError(error);
   }
 }
 function promptUser(question) {
@@ -6955,7 +7110,8 @@ async function wrapSkeleton(options) {
     ...windowCollector ? { windowCollector } : {},
     ...windowElb ? { windowElb } : {},
     ...options.previewOrigin ? { previewOrigin: options.previewOrigin } : {},
-    ...options.previewScope ? { previewScope: options.previewScope } : {}
+    ...options.previewScope ? { previewScope: options.previewScope } : {},
+    platform
   }) : generateWrapEntryServer(absoluteSkeletonPath);
   const entryDir = await fs17.mkdtemp(path18.join(os2.tmpdir(), "walkeros-wrap-"));
   const entryPath = path18.join(entryDir, "entry.mjs");
@@ -7003,6 +7159,7 @@ async function wrapSkeleton(options) {
 init_auth();
 init_http();
 init_api_client();
+init_client_context();
 init_config_file();
 init_sse();
 init_utils();
@@ -7114,6 +7271,7 @@ export {
   bundle,
   bundleCommand,
   bundleRemote,
+  clientContextHeaders,
   compareOutput,
   createApiClient,
   createDeployCommand,
@@ -7138,6 +7296,7 @@ export {
   feedbackCommand,
   findExample,
   getAuthHeaders,
+  getClientContext,
   getDeployment,
   getDeploymentBySlug,
   getDeploymentBySlugCommand,
@@ -7164,8 +7323,10 @@ export {
   pushCommand,
   readConfig,
   requireProjectId,
+  resetClientContext,
   run,
   runCommand,
+  setClientContext,
   simulateDestination,
   simulateSource,
   simulateTransformer,