@walkeros/cli 3.4.0 → 3.4.1

package/dist/cli.js

@@ -30,6 +30,67 @@ var init_client_context = __esm({
   }
 });
 
+// src/core/api-error.ts
+function throwApiError(error48, fallbackMessage) {
+  if (error48 && typeof error48 === "object" && "error" in error48 && typeof error48.error === "object") {
+    const inner = error48.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);
+}
+var ApiError;
+var init_api_error = __esm({
+  "src/core/api-error.ts"() {
+    "use strict";
+    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;
+      }
+    };
+  }
+});
+
 // ../core/dist/index.mjs
 function x(e3) {
   return { _meta: { hops: 0, path: [e3] } };
@@ -283,11 +344,24 @@ function Se(e3, t, n3) {
     }
   };
 }
-function De(e3, t, n3) {
-  return function(...o2) {
-    let r2;
-    const i2 = "post" + t, s2 = n3["pre" + t], a2 = n3[i2];
-    return r2 = s2 ? s2({ fn: e3 }, ...o2) : e3(...o2), a2 && (r2 = a2({ fn: e3, result: r2 }, ...o2)), r2;
+function De(e3, t, n3, o2) {
+  return function(...r2) {
+    let i2;
+    const s2 = "pre" + t, a2 = "post" + t, c3 = n3[s2], u4 = n3[a2], f2 = (e4, t2) => {
+      o2 ? o2.warn(e4, { error: t2 }) : console.warn(e4, t2);
+    };
+    if (c3) try {
+      i2 = c3({ fn: e3 }, ...r2);
+    } catch (t2) {
+      f2(`Hook ${String(s2)} failed, falling back to original function`, t2), i2 = e3(...r2);
+    }
+    else i2 = e3(...r2);
+    if (u4) try {
+      i2 = u4({ fn: e3, result: i2 }, ...r2);
+    } catch (e4) {
+      f2(`Hook ${String(a2)} failed, keeping original result`, e4);
+    }
+    return i2;
   };
 }
 function Xe(e3) {
@@ -15560,7 +15634,7 @@ function nt(e3, n3, i2) {
 function it2(e3) {
   return external_exports.toJSONSchema(e3, { target: "draft-7" });
 }
-var e2, n, i, r, a, s, c2, l, d, p, u2, m, b, f, g, h, v, S2, y, w, k, C2, x2, j, E2, R2, P2, J, O, I2, D2, z3, q2, U2, W, B2, A2, $, V, H2, F2, G, _2, K, Q2, X, Y, Z, ee, ne2, ie, te, oe, re, ae, se, ce, le, de, pe, ue, me, be2, fe, ge, he2, ve2, Se2, ye, we2, ke, Ce, xe, je2, Ee, Re, Pe, Je, Oe, Ie, De2, Ne, Me, Te, Le, ze, qe, Ue, We, Be, Ae, $e, Ve, He, Fe, Ge, _e, Ke, Qe2, Xe2, Ye2, Ze, en, nn, tn, on, rn, an, sn, cn, ln, dn, pn, un, mn, bn, fn, gn, hn, vn, Sn, yn, wn, kn, Cn, xn, jn, En, Rn, Pn, Jn, On, In, Dn, Nn, Mn, Tn, Ln, zn, qn, Un, Wn, Bn, An, $n, Vn, Hn, Fn, Gn, _n, Kn, Qn, Xn, Yn, Zn, ei, ni, ii, ti, oi, ri, ai, si, ci, li, di, pi, ui, mi, bi, fi, gi, hi, vi, Si, yi, wi, ki, Ci, xi, ji, Oi, Ii, Di, Ni, Mi, Ti, Li, zi, Ui, Wi, Bi, Ai, ot;
+var e2, n, i, r, a, s, c2, l, d, p, u2, m, b, f, g, h, v, S2, y, w, k, C2, x2, j, E2, R2, P2, J, I2, O, D2, z3, q2, U2, W, B2, A2, $, V, H2, F2, G, _2, K, Q2, X, Y, Z, ee, ne2, ie, te, oe, re, ae, se, ce, le, de, pe, ue, me, be2, fe, ge, he2, ve2, Se2, ye, we2, ke, Ce, xe, je2, Ee, Re, Pe, Je, Ie, Oe, De2, Ne, Me, Te, Le, ze, qe, Ue, We, Be, Ae, $e, Ve, He, Fe, Ge, _e, Ke, Qe2, Xe2, Ye2, Ze, en, nn, tn, on, rn, an, sn, cn, ln, dn, pn, un, mn, bn, fn, gn, hn, vn, Sn, yn, wn, kn, Cn, xn, jn, En, Rn, Pn, Jn, In, On, Dn, Nn, Mn, Tn, Ln, zn, qn, Un, Wn, Bn, An, $n, Vn, Hn, Fn, Gn, _n, Kn, Qn, Xn, Yn, Zn, ei, ni, ii, ti, oi, ri, ai, si, ci, li, di, pi, ui, mi, bi, fi, gi, hi, vi, Si, yi, wi, ki, Ci, xi, ji, Ii, Oi, Di, Ni, Mi, Ti, Li, zi, Ui, Wi, Bi, Ai, ot;
 var init_dev = __esm({
   "../core/dist/dev.mjs"() {
     "use strict";
@@ -15571,7 +15645,7 @@ var init_dev = __esm({
       for (var t in i2) e2(n3, t, { get: i2[t], enumerable: true });
     };
     i = {};
-    n(i, { BaseContextConfig: () => q2, BatchConfig: () => U2, CacheRuleSchema: () => $e, CacheSchema: () => Ve, CacheSchemas: () => Ae, ClickIdEntrySchema: () => Ai, CodeSchema: () => Ui, CollectorSchemas: () => hn, ConsentSchema: () => Q2, ContractActionsSchema: () => yi, ContractSchema: () => Ci, ContractSchemaEntry: () => Si, Counter: () => d, DeepPartialEventSchema: () => oe, DestinationReferenceSchema: () => hi, DestinationSchemas: () => Me, DestinationsMapConfig: () => A2, EntitiesSchema: () => ne2, EntitySchema: () => ee, EventSchema: () => ie, FlowConfigSchema: () => ji, FlowSchemas: () => ii, FlowSettingsSchema: () => xi, GenericEnvConfig: () => D2, GenericSettingsConfig: () => I2, HandlersConfig: () => j, HintSchema: () => Wi, HintsSchema: () => Bi, IdConfig: () => P2, Identifier: () => c2, InitConfig: () => J, LoopSchema: () => ge, MapSchema: () => ve2, MappingResultSchema: () => xe, MappingSchemas: () => me, MatchExpressionSchema: () => qe, MatcherSchemas: () => Te, NextRuleSchema: () => Be, OptionalPrimitiveValue: () => m, OrderedPropertiesSchema: () => _2, PartialEventSchema: () => te, PolicySchema: () => ye, PrimaryConfig: () => O, PrimitiveSchema: () => ti, PrimitiveValue: () => u2, ProcessingControlConfig: () => W, PropertiesSchema: () => G, PropertySchema: () => F2, PropertyTypeSchema: () => H2, QueueConfig: () => R2, RequiredBoolean: () => s, RequiredNumber: () => a, RequiredString: () => r, RoutableNextSchema: () => We, RuleSchema: () => we2, RulesSchema: () => ke, RuntimeInstanceConfig: () => z3, SetSchema: () => he2, SourceReferenceSchema: () => fi, SourceSchema: () => Z, SourceSchemas: () => Dn, SourceTypeSchema: () => K, SourcesMapConfig: () => B2, StoreReferenceSchema: () => vi, StoreSchemas: () => Xn, TaggingVersion: () => p, Timestamp: () => l, TransformerReferenceSchema: () => gi, TransformerSchemas: () => Fn, UserSchema: () => X, UtilitySchemas: () => b, ValueConfigSchema: () => Se2, ValueSchema: () => be2, ValuesSchema: () => fe, VerboseConfig: () => E2, VersionSchema: () => Y, WalkerOSSchemas: () => $, configJsonSchema: () => Oi, consentJsonSchema: () => ue, contractEntryJsonSchema: () => Li, contractJsonSchema: () => zi, createArraySchema: () => Zi, createConsentConfig: () => L, createDataTransformationConfig: () => N2, createEnumSchema: () => et2, createMappingRulesConfig: () => M2, createObjectSchema: () => Xi, createPolicyConfig: () => T2, createTupleSchema: () => nt, destinationReferenceJsonSchema: () => Ni, entityJsonSchema: () => de, eventJsonSchema: () => re, loopJsonSchema: () => Re, mapJsonSchema: () => Je, orderedPropertiesJsonSchema: () => le, parseConfig: () => Ei, parseSettings: () => Pi, partialEventJsonSchema: () => ae, policyJsonSchema: () => Oe, propertiesJsonSchema: () => ce, ruleJsonSchema: () => Ie, rulesJsonSchema: () => De2, safeParseConfig: () => Ri, safeParseSettings: () => Ji, setJsonSchema: () => Pe, settingsJsonSchema: () => Ii, sourceReferenceJsonSchema: () => Di, sourceTypeJsonSchema: () => pe, storeReferenceJsonSchema: () => Ti, transformerReferenceJsonSchema: () => Mi, userJsonSchema: () => se, validateFlowConfig: () => $i, valueConfigJsonSchema: () => Ee, valueJsonSchema: () => je2, z: () => external_exports, zodToSchema: () => it2 });
+    n(i, { BaseContextConfig: () => q2, BatchConfig: () => U2, CacheRuleSchema: () => $e, CacheSchema: () => Ve, CacheSchemas: () => Ae, ClickIdEntrySchema: () => Ai, CodeSchema: () => Ui, CollectorSchemas: () => hn, ConsentSchema: () => Q2, ContractActionsSchema: () => yi, ContractSchema: () => Ci, ContractSchemaEntry: () => Si, Counter: () => d, DeepPartialEventSchema: () => oe, DestinationReferenceSchema: () => hi, DestinationSchemas: () => Me, DestinationsMapConfig: () => A2, EntitiesSchema: () => ne2, EntitySchema: () => ee, EventSchema: () => ie, FlowConfigSchema: () => ji, FlowSchemas: () => ii, FlowSettingsSchema: () => xi, GenericEnvConfig: () => D2, GenericSettingsConfig: () => O, HandlersConfig: () => j, HintSchema: () => Wi, HintsSchema: () => Bi, IdConfig: () => P2, Identifier: () => c2, InitConfig: () => J, LoopSchema: () => ge, MapSchema: () => ve2, MappingResultSchema: () => xe, MappingSchemas: () => me, MatchExpressionSchema: () => qe, MatcherSchemas: () => Te, NextRuleSchema: () => Be, OptionalPrimitiveValue: () => m, OrderedPropertiesSchema: () => _2, PartialEventSchema: () => te, PolicySchema: () => ye, PrimaryConfig: () => I2, PrimitiveSchema: () => ti, PrimitiveValue: () => u2, ProcessingControlConfig: () => W, PropertiesSchema: () => G, PropertySchema: () => F2, PropertyTypeSchema: () => H2, QueueConfig: () => R2, RequiredBoolean: () => s, RequiredNumber: () => a, RequiredString: () => r, RoutableNextSchema: () => We, RuleSchema: () => we2, RulesSchema: () => ke, RuntimeInstanceConfig: () => z3, SetSchema: () => he2, SourceReferenceSchema: () => fi, SourceSchema: () => Z, SourceSchemas: () => Dn, SourceTypeSchema: () => K, SourcesMapConfig: () => B2, StoreReferenceSchema: () => vi, StoreSchemas: () => Xn, TaggingVersion: () => p, Timestamp: () => l, TransformerReferenceSchema: () => gi, TransformerSchemas: () => Fn, UserSchema: () => X, UtilitySchemas: () => b, ValueConfigSchema: () => Se2, ValueSchema: () => be2, ValuesSchema: () => fe, VerboseConfig: () => E2, VersionSchema: () => Y, WalkerOSSchemas: () => $, configJsonSchema: () => Ii, consentJsonSchema: () => ue, contractEntryJsonSchema: () => Li, contractJsonSchema: () => zi, createArraySchema: () => Zi, createConsentConfig: () => L, createDataTransformationConfig: () => N2, createEnumSchema: () => et2, createMappingRulesConfig: () => M2, createObjectSchema: () => Xi, createPolicyConfig: () => T2, createTupleSchema: () => nt, destinationReferenceJsonSchema: () => Ni, entityJsonSchema: () => de, eventJsonSchema: () => re, loopJsonSchema: () => Re, mapJsonSchema: () => Je, orderedPropertiesJsonSchema: () => le, parseConfig: () => Ei, parseSettings: () => Pi, partialEventJsonSchema: () => ae, policyJsonSchema: () => Ie, propertiesJsonSchema: () => ce, ruleJsonSchema: () => Oe, rulesJsonSchema: () => De2, safeParseConfig: () => Ri, safeParseSettings: () => Ji, setJsonSchema: () => Pe, settingsJsonSchema: () => Oi, sourceReferenceJsonSchema: () => Di, sourceTypeJsonSchema: () => pe, storeReferenceJsonSchema: () => Ti, transformerReferenceJsonSchema: () => Mi, userJsonSchema: () => se, validateFlowConfig: () => $i, valueConfigJsonSchema: () => Ee, valueJsonSchema: () => je2, z: () => external_exports, zodToSchema: () => it2 });
     r = external_exports.string();
     a = external_exports.number();
     s = external_exports.boolean();
@@ -15598,8 +15672,8 @@ var init_dev = __esm({
     R2 = external_exports.object({ queue: external_exports.boolean().describe("Whether to queue events when consent is not granted").optional() }).partial();
     P2 = external_exports.object({}).partial();
     J = external_exports.object({ init: external_exports.boolean().describe("Whether to initialize immediately").optional(), loadScript: external_exports.boolean().describe("Whether to load external script (for web destinations)").optional() }).partial();
-    O = external_exports.object({ primary: external_exports.boolean().describe("Mark as primary (only one can be primary)").optional() }).partial();
-    I2 = external_exports.object({ settings: external_exports.any().optional().describe("Implementation-specific configuration") }).partial();
+    I2 = external_exports.object({ primary: external_exports.boolean().describe("Mark as primary (only one can be primary)").optional() }).partial();
+    O = external_exports.object({ settings: external_exports.any().optional().describe("Implementation-specific configuration") }).partial();
     D2 = external_exports.object({ env: external_exports.any().optional().describe("Environment dependencies (platform-specific)") }).partial();
     z3 = external_exports.object({ type: external_exports.string().optional().describe("Instance type identifier"), config: external_exports.unknown().describe("Instance configuration") }).partial();
     q2 = external_exports.object({ collector: external_exports.unknown().describe("Collector instance (runtime object)"), config: external_exports.unknown().describe("Configuration"), env: external_exports.unknown().describe("Environment dependencies") }).partial();
@@ -15632,7 +15706,7 @@ var init_dev = __esm({
     pe = o(K);
     ue = o(Q2);
     me = {};
-    n(me, { ConfigSchema: () => Ce, LoopSchema: () => ge, MapSchema: () => ve2, PolicySchema: () => ye, ResultSchema: () => xe, RuleSchema: () => we2, RulesSchema: () => ke, SetSchema: () => he2, ValueConfigSchema: () => Se2, ValueSchema: () => be2, ValuesSchema: () => fe, configJsonSchema: () => Ne, loopJsonSchema: () => Re, mapJsonSchema: () => Je, policyJsonSchema: () => Oe, ruleJsonSchema: () => Ie, rulesJsonSchema: () => De2, setJsonSchema: () => Pe, valueConfigJsonSchema: () => Ee, valueJsonSchema: () => je2 });
+    n(me, { ConfigSchema: () => Ce, LoopSchema: () => ge, MapSchema: () => ve2, PolicySchema: () => ye, ResultSchema: () => xe, RuleSchema: () => we2, RulesSchema: () => ke, SetSchema: () => he2, ValueConfigSchema: () => Se2, ValueSchema: () => be2, ValuesSchema: () => fe, configJsonSchema: () => Ne, loopJsonSchema: () => Re, mapJsonSchema: () => Je, policyJsonSchema: () => Ie, ruleJsonSchema: () => Oe, rulesJsonSchema: () => De2, setJsonSchema: () => Pe, valueConfigJsonSchema: () => Ee, valueJsonSchema: () => je2 });
     be2 = external_exports.lazy(() => external_exports.union([external_exports.string().describe('String value or property path (e.g., "data.id")'), external_exports.number().describe("Numeric value"), external_exports.boolean().describe("Boolean value"), external_exports.lazy(() => V), external_exports.array(be2).describe("Array of values")])).meta({ id: "MappingValue", title: "Mapping.Value", description: "Polymorphic transform primitive used in every mapping field. A string path, constant, operator object (map/loop/set/condition/consent), or array of values." });
     fe = external_exports.array(be2).describe("Array of transformation values");
     ge = external_exports.lazy(() => external_exports.tuple([be2, be2]).describe("Loop transformation: [source, transform] tuple for array processing"));
@@ -15649,8 +15723,8 @@ var init_dev = __esm({
     Re = o(ge);
     Pe = o(he2);
     Je = o(ve2);
-    Oe = o(ye);
-    Ie = o(we2);
+    Ie = o(ye);
+    Oe = o(we2);
     De2 = o(ke);
     Ne = o(Ce);
     Me = {};
@@ -15693,7 +15767,7 @@ var init_dev = __esm({
     fn = o(nn);
     gn = o(cn);
     hn = {};
-    n(hn, { CommandTypeSchema: () => vn, ConfigSchema: () => Sn, DestinationsSchema: () => xn, InitConfigSchema: () => wn, InstanceSchema: () => jn, PushContextSchema: () => kn, SessionDataSchema: () => yn, SourcesSchema: () => Cn, commandTypeJsonSchema: () => En, configJsonSchema: () => Rn, initConfigJsonSchema: () => Jn, instanceJsonSchema: () => In, pushContextJsonSchema: () => On, sessionDataJsonSchema: () => Pn });
+    n(hn, { CommandTypeSchema: () => vn, ConfigSchema: () => Sn, DestinationsSchema: () => xn, InitConfigSchema: () => wn, InstanceSchema: () => jn, PushContextSchema: () => kn, SessionDataSchema: () => yn, SourcesSchema: () => Cn, commandTypeJsonSchema: () => En, configJsonSchema: () => Rn, initConfigJsonSchema: () => Jn, instanceJsonSchema: () => On, pushContextJsonSchema: () => In, sessionDataJsonSchema: () => Pn });
     vn = external_exports.union([external_exports.enum(["action", "config", "consent", "context", "destination", "elb", "globals", "hook", "init", "link", "run", "user", "walker"]), external_exports.string()]).describe("Collector command type: standard commands or custom string for extensions");
     Sn = external_exports.object({ run: external_exports.boolean().describe("Whether to run collector automatically on initialization").optional(), tagging: p, globalsStatic: G.describe("Static global properties that persist across collector runs"), sessionStatic: external_exports.record(external_exports.string(), external_exports.unknown()).describe("Static session data that persists across collector runs"), logger: external_exports.object({ level: external_exports.union([external_exports.number(), external_exports.enum(["ERROR", "WARN", "INFO", "DEBUG"])]).optional().describe("Minimum log level (default: ERROR)"), handler: external_exports.any().optional().describe("Custom log handler function") }).optional().describe("Logger configuration (level, handler)") }).describe("Core collector configuration");
     yn = G.and(external_exports.object({ isStart: external_exports.boolean().describe("Whether this is a new session start"), storage: external_exports.boolean().describe("Whether storage is available"), id: c2.describe("Session identifier").optional(), start: l.describe("Session start timestamp").optional(), marketing: external_exports.literal(true).optional().describe("Marketing attribution flag"), updated: l.describe("Last update timestamp").optional(), isNew: external_exports.boolean().describe("Whether this is a new session").optional(), device: c2.describe("Device identifier").optional(), count: d.describe("Event count in session").optional(), runs: d.describe("Number of runs").optional() })).describe("Session state and tracking data");
@@ -15706,8 +15780,8 @@ var init_dev = __esm({
     Rn = o(Sn);
     Pn = o(yn);
     Jn = o(wn);
-    On = o(kn);
-    In = o(jn);
+    In = o(kn);
+    On = o(jn);
     Dn = {};
     n(Dn, { BaseEnvSchema: () => Nn, ConfigSchema: () => Mn, InitSchema: () => zn, InitSourceSchema: () => qn, InitSourcesSchema: () => Un, InstanceSchema: () => Ln, PartialConfigSchema: () => Tn, baseEnvJsonSchema: () => Wn, configJsonSchema: () => Bn, initSourceJsonSchema: () => Vn, initSourcesJsonSchema: () => Hn, instanceJsonSchema: () => $n, partialConfigJsonSchema: () => An });
     Nn = external_exports.object({ push: external_exports.unknown().describe("Collector push function"), command: external_exports.unknown().describe("Collector command function"), sources: external_exports.unknown().optional().describe("Map of registered source instances"), elb: external_exports.unknown().describe("Public API function (alias for collector.push)") }).catchall(external_exports.unknown()).describe("Base environment for dependency injection - platform-specific sources extend this");
@@ -15736,7 +15810,7 @@ var init_dev = __esm({
     ei = o(Yn);
     ni = o(Zn);
     ii = {};
-    n(ii, { BundleSchema: () => li, ConfigSchema: () => ji, ContractActionsSchema: () => yi, ContractEntrySchema: () => ki, ContractEventsSchema: () => wi, ContractSchema: () => Ci, ContractSchemaEntry: () => Si, DefinitionsSchema: () => ri, DestinationReferenceSchema: () => hi, InlineCodeSchema: () => ui, OverridesSchema: () => ci, PackagesSchema: () => si, PrimitiveSchema: () => ti, ServerSchema: () => pi, SettingsSchema: () => xi, SourceReferenceSchema: () => fi, StepExampleSchema: () => mi, StepExamplesSchema: () => bi, StoreReferenceSchema: () => vi, TransformerReferenceSchema: () => gi, VariablesSchema: () => oi, WebSchema: () => di, configJsonSchema: () => Oi, contractEntryJsonSchema: () => Li, contractJsonSchema: () => zi, destinationReferenceJsonSchema: () => Ni, parseConfig: () => Ei, parseSettings: () => Pi, safeParseConfig: () => Ri, safeParseSettings: () => Ji, settingsJsonSchema: () => Ii, sourceReferenceJsonSchema: () => Di, storeReferenceJsonSchema: () => Ti, transformerReferenceJsonSchema: () => Mi });
+    n(ii, { BundleSchema: () => li, ConfigSchema: () => ji, ContractActionsSchema: () => yi, ContractEntrySchema: () => ki, ContractEventsSchema: () => wi, ContractSchema: () => Ci, ContractSchemaEntry: () => Si, DefinitionsSchema: () => ri, DestinationReferenceSchema: () => hi, InlineCodeSchema: () => ui, OverridesSchema: () => ci, PackagesSchema: () => si, PrimitiveSchema: () => ti, ServerSchema: () => pi, SettingsSchema: () => xi, SourceReferenceSchema: () => fi, StepExampleSchema: () => mi, StepExamplesSchema: () => bi, StoreReferenceSchema: () => vi, TransformerReferenceSchema: () => gi, VariablesSchema: () => oi, WebSchema: () => di, configJsonSchema: () => Ii, contractEntryJsonSchema: () => Li, contractJsonSchema: () => zi, destinationReferenceJsonSchema: () => Ni, parseConfig: () => Ei, parseSettings: () => Pi, safeParseConfig: () => Ri, safeParseSettings: () => Ji, settingsJsonSchema: () => Oi, sourceReferenceJsonSchema: () => Di, storeReferenceJsonSchema: () => Ti, transformerReferenceJsonSchema: () => Mi });
     ti = external_exports.union([external_exports.string(), external_exports.number(), external_exports.boolean()]).describe("Primitive value: string, number, or boolean");
     oi = external_exports.record(external_exports.string(), ti).describe("Variables for interpolation");
     ri = external_exports.record(external_exports.string(), external_exports.unknown()).describe("Reusable configuration definitions");
@@ -15747,7 +15821,7 @@ var init_dev = __esm({
     di = external_exports.object({ windowCollector: external_exports.string().default("collector").optional().describe('Window property name for the collector instance (default: "collector")'), windowElb: external_exports.string().default("elb").optional().describe('Window property name for the elb command queue (default: "elb")') }).describe("Web platform configuration");
     pi = external_exports.object({}).passthrough().describe("Server platform configuration (reserved for future options)");
     ui = external_exports.object({ push: external_exports.string().min(1, "Push function cannot be empty").describe('JavaScript function for processing events. Must start with "$code:" prefix. Example: "$code:(event) => { console.log(event); }"'), type: external_exports.string().optional().describe("Optional type identifier for the inline instance"), init: external_exports.string().optional().describe("Optional initialization function. Use $code: prefix for inline JavaScript.") }).describe("Inline code for custom sources/transformers/destinations");
-    mi = external_exports.object({ description: external_exports.string().optional().describe("Human-readable description"), in: external_exports.unknown().optional().describe("Input to the step"), trigger: external_exports.object({ type: external_exports.string().optional().describe("Trigger mechanism (e.g., click, POST, load)"), options: external_exports.unknown().optional().describe("Mechanism-specific options") }).optional().describe("Source trigger metadata"), mapping: external_exports.unknown().optional().describe("Mapping configuration"), out: external_exports.unknown().optional().describe("Expected output from the step"), command: external_exports.enum(["config", "consent", "user", "run"]).optional().describe("Invoke elb('walker <command>', in) instead of pushing in as an event") }).describe("Named example with input/output pair");
+    mi = external_exports.object({ title: external_exports.string().optional().describe("Human-readable title (overrides default heading)"), description: external_exports.string().optional().describe("Human-readable description"), public: external_exports.boolean().optional().describe("Whether this example is shown in docs/UI/MCP default output (default: true). Set false for test-only fixtures."), in: external_exports.unknown().optional().describe("Input to the step"), trigger: external_exports.object({ type: external_exports.string().optional().describe("Trigger mechanism (e.g., click, POST, load)"), options: external_exports.unknown().optional().describe("Mechanism-specific options") }).optional().describe("Source trigger metadata"), mapping: external_exports.unknown().optional().describe("Mapping configuration"), out: external_exports.unknown().optional().describe("Expected output from the step"), command: external_exports.enum(["config", "consent", "user", "run"]).optional().describe("Invoke elb('walker <command>', in) instead of pushing in as an event") }).describe("Named example with input/output pair");
     bi = external_exports.record(external_exports.string(), mi).describe("Named step examples for testing and documentation");
     fi = external_exports.object({ package: external_exports.string().min(1, "Package name cannot be empty").optional().describe('Package specifier with optional version (e.g., "@walkeros/web-source-browser@2.0.0")'), code: external_exports.union([external_exports.string(), ui]).optional().describe('Either a named export string (e.g., "sourceExpress") or an inline code object with push function'), config: external_exports.unknown().optional().describe("Source-specific configuration object"), env: external_exports.unknown().optional().describe("Source environment configuration"), primary: external_exports.boolean().optional().describe("Mark as primary source (provides main elb). Only one source should be primary."), variables: oi.optional().describe("Source-level variables (highest priority in cascade)"), definitions: ri.optional().describe("Source-level definitions (highest priority in cascade)"), next: We.optional().describe("Pre-collector transformer chain. String, string[], or NextRule[] for conditional routing based on ingest data."), before: We.optional().describe("Pre-source transformer chain (consent-exempt). Handles transport-level preprocessing."), examples: bi.optional().describe("Named step examples for testing and documentation (stripped during bundling)"), cache: Ve.optional().describe("Cache configuration for this source (match \u2192 key \u2192 ttl rules)") }).describe("Source package reference with configuration");
     gi = external_exports.object({ package: external_exports.string().min(1, "Package name cannot be empty").optional().describe('Package specifier with optional version (e.g., "@walkeros/transformer-enricher@1.0.0")'), code: external_exports.union([external_exports.string(), ui]).optional().describe('Either a named export string (e.g., "transformerEnricher") or an inline code object with push function'), config: external_exports.unknown().optional().describe("Transformer-specific configuration object"), env: external_exports.unknown().optional().describe("Transformer environment configuration"), before: We.optional().describe("Pre-transformer chain. Runs before this transformer push function."), next: We.optional().describe("Next transformer in chain. String, string[], or NextRule[] for conditional routing."), variables: oi.optional().describe("Transformer-level variables (highest priority in cascade)"), definitions: ri.optional().describe("Transformer-level definitions (highest priority in cascade)"), examples: bi.optional().describe("Named step examples for testing and documentation (stripped during bundling)"), cache: Ve.optional().describe("Cache configuration for this transformer (match \u2192 key \u2192 ttl rules)") }).describe("Transformer package reference with configuration");
@@ -15763,8 +15837,8 @@ var init_dev = __esm({
       return (n3 || i2) && !(n3 && i2);
     }, { message: 'Exactly one of "web" or "server" must be present' }).describe("Single flow settings for one deployment target");
     ji = external_exports.object({ $schema: external_exports.string().url("Schema URL must be a valid URL").optional().describe('JSON Schema reference for IDE validation (e.g., "https://walkeros.io/schema/flow/v2.json")'), include: external_exports.array(external_exports.string()).optional().describe("Folders to include in the bundle output"), variables: oi.optional().describe("Shared variables for interpolation across all flows (use $var.name syntax)"), definitions: ri.optional().describe("Reusable configuration definitions (use $def.name syntax)"), flows: external_exports.record(external_exports.string(), xi).refine((e3) => Object.keys(e3).length > 0, { message: "At least one flow is required" }).describe("Named flow configurations (e.g., production, staging, development)") }).extend({ version: external_exports.literal(3).describe("Configuration schema version"), contract: Ci.optional().describe("Named contracts with extends inheritance and dot-path references") }).describe("walkerOS flow configuration (walkeros.config.json)");
-    Oi = external_exports.toJSONSchema(ji, { target: "draft-7" });
-    Ii = o(xi);
+    Ii = external_exports.toJSONSchema(ji, { target: "draft-7" });
+    Oi = o(xi);
     Di = o(fi);
     Ni = o(hi);
     Mi = o(gi);
@@ -18227,6 +18301,293 @@ var init_utils3 = __esm({
   }
 });
 
+// src/commands/flows/index.ts
+async function listFlows(options = {}) {
+  const id = options.projectId ?? requireProjectId();
+  const client = createApiClient();
+  const { data, error: error48 } = await client.GET("/api/projects/{projectId}/flows", {
+    params: {
+      path: { projectId: id },
+      query: {
+        sort: options.sort,
+        order: options.order,
+        include_deleted: options.includeDeleted ? "true" : void 0
+      }
+    }
+  });
+  if (error48) throwApiError(error48, "Failed to list flows");
+  return data;
+}
+async function getFlow(options) {
+  const id = options.projectId ?? requireProjectId();
+  const client = createApiClient();
+  const { data, error: error48 } = await client.GET(
+    "/api/projects/{projectId}/flows/{flowId}",
+    {
+      params: {
+        path: { projectId: id, flowId: options.flowId },
+        query: options.fields ? { fields: options.fields.join(",") } : {}
+      }
+    }
+  );
+  if (error48) throwApiError(error48, "Failed to get flow");
+  return data;
+}
+async function createFlow(options) {
+  const id = options.projectId ?? requireProjectId();
+  const client = createApiClient();
+  const { data, error: error48 } = await client.POST("/api/projects/{projectId}/flows", {
+    params: { path: { projectId: id } },
+    // Config is user-provided JSON; server validates the full schema
+    body: { name: options.name, config: options.content }
+  });
+  if (error48) throwApiError(error48, "Failed to create flow");
+  return data;
+}
+async function updateFlow(options) {
+  const id = options.projectId ?? requireProjectId();
+  const client = createApiClient();
+  const body = {};
+  if (options.name !== void 0) body.name = options.name;
+  if (options.content !== void 0) body.config = options.content;
+  const { data, error: error48 } = await client.PATCH(
+    "/api/projects/{projectId}/flows/{flowId}",
+    {
+      params: { path: { projectId: id, flowId: options.flowId } },
+      // Dynamically constructed body; server validates the full schema
+      body,
+      ...options.mergePatch && {
+        headers: { "Content-Type": "application/merge-patch+json" }
+      }
+    }
+  );
+  if (error48) throwApiError(error48, "Failed to update flow");
+  return data;
+}
+async function deleteFlow(options) {
+  const id = options.projectId ?? requireProjectId();
+  const client = createApiClient();
+  const { data, error: error48 } = await client.DELETE(
+    "/api/projects/{projectId}/flows/{flowId}",
+    {
+      params: { path: { projectId: id, flowId: options.flowId } }
+    }
+  );
+  if (error48) throwApiError(error48, "Failed to delete flow");
+  return data ?? { success: true };
+}
+async function duplicateFlow(options) {
+  const id = options.projectId ?? requireProjectId();
+  const client = createApiClient();
+  const { data, error: error48 } = await client.POST(
+    "/api/projects/{projectId}/flows/{flowId}/duplicate",
+    {
+      params: { path: { projectId: id, flowId: options.flowId } },
+      body: { name: options.name }
+    }
+  );
+  if (error48) throwApiError(error48, "Failed to duplicate flow");
+  return data;
+}
+async function handleResult2(fn2, options) {
+  try {
+    const result = await fn2();
+    await writeResult(JSON.stringify(result, null, 2), options);
+  } catch (error48) {
+    handleCliError(error48);
+  }
+}
+async function listFlowsCommand(options) {
+  await handleResult2(
+    () => listFlows({
+      projectId: options.project,
+      sort: options.sort,
+      order: options.order,
+      includeDeleted: options.includeDeleted
+    }),
+    options
+  );
+}
+async function getFlowCommand(flowId, options) {
+  await handleResult2(
+    () => getFlow({ flowId, projectId: options.project }),
+    options
+  );
+}
+async function createFlowCommand(name, options) {
+  const content = options.content ? JSON.parse(options.content) : JSON.parse(await readFlowStdin());
+  await handleResult2(
+    () => createFlow({ name, content, projectId: options.project }),
+    options
+  );
+}
+async function updateFlowCommand(flowId, options) {
+  const content = options.content ? JSON.parse(options.content) : void 0;
+  await handleResult2(
+    () => updateFlow({
+      flowId,
+      name: options.name,
+      content,
+      projectId: options.project
+    }),
+    options
+  );
+}
+async function deleteFlowCommand(flowId, options) {
+  await handleResult2(
+    () => deleteFlow({ flowId, projectId: options.project }),
+    options
+  );
+}
+async function duplicateFlowCommand(flowId, options) {
+  await handleResult2(
+    () => duplicateFlow({ flowId, name: options.name, projectId: options.project }),
+    options
+  );
+}
+async function readFlowStdin() {
+  if (!isStdinPiped()) {
+    throw new Error("Content required: use --content or pipe via stdin");
+  }
+  return readStdin();
+}
+var init_flows = __esm({
+  "src/commands/flows/index.ts"() {
+    "use strict";
+    init_api_client();
+    init_api_error();
+    init_auth();
+    init_output();
+    init_stdin();
+  }
+});
+
+// src/commands/previews/index.ts
+var previews_exports = {};
+__export(previews_exports, {
+  createPreview: () => createPreview,
+  deletePreview: () => deletePreview,
+  getPreview: () => getPreview,
+  listPreviews: () => listPreviews
+});
+async function listPreviews(options) {
+  const pid = options.projectId ?? requireProjectId();
+  const response = await apiFetch(
+    `/api/projects/${pid}/flows/${options.flowId}/previews`
+  );
+  if (!response.ok) {
+    const body = await response.json().catch(() => ({}));
+    throwApiError(body, "Failed to list previews");
+  }
+  return response.json();
+}
+async function getPreview(options) {
+  const pid = options.projectId ?? requireProjectId();
+  const response = await apiFetch(
+    `/api/projects/${pid}/flows/${options.flowId}/previews/${options.previewId}`
+  );
+  if (!response.ok) {
+    const body = await response.json().catch(() => ({}));
+    throwApiError(body, "Failed to get preview");
+  }
+  return response.json();
+}
+async function createPreview(options) {
+  const pid = options.projectId ?? requireProjectId();
+  let settingsId = options.flowSettingsId;
+  if (!settingsId) {
+    if (!options.flowName) {
+      throw new Error("Either flowName or flowSettingsId is required");
+    }
+    const flow = await getFlow({ projectId: pid, flowId: options.flowId });
+    const settings = flow.settings;
+    const match = settings?.find((s2) => s2.name === options.flowName);
+    if (!match) {
+      throw new Error(
+        `Flow settings named "${options.flowName}" not found on flow ${options.flowId}`
+      );
+    }
+    settingsId = match.id;
+  }
+  const response = await apiFetch(
+    `/api/projects/${pid}/flows/${options.flowId}/previews`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ flowSettingsId: settingsId })
+    }
+  );
+  if (!response.ok) {
+    const body = await response.json().catch(() => ({}));
+    throwApiError(body, "Failed to create preview");
+  }
+  return response.json();
+}
+async function deletePreview(options) {
+  const pid = options.projectId ?? requireProjectId();
+  const response = await apiFetch(
+    `/api/projects/${pid}/flows/${options.flowId}/previews/${options.previewId}`,
+    { method: "DELETE" }
+  );
+  if (!response.ok) {
+    const body = await response.json().catch(() => ({}));
+    throwApiError(body, "Failed to delete preview");
+  }
+  if (response.status === 204) return null;
+  return response.json().catch(() => null);
+}
+var init_previews = __esm({
+  "src/commands/previews/index.ts"() {
+    "use strict";
+    init_auth();
+    init_http();
+    init_api_error();
+    init_flows();
+  }
+});
+
+// src/commands/previews/output.ts
+var output_exports = {};
+__export(output_exports, {
+  formatPreviewCreated: () => formatPreviewCreated,
+  printPreviewCreated: () => printPreviewCreated
+});
+function formatPreviewCreated(preview, options) {
+  let stdoutLast;
+  let deactivationUrl = null;
+  if (options.url) {
+    const u4 = new URL(options.url);
+    u4.searchParams.set("elbPreview", preview.token);
+    stdoutLast = u4.toString();
+    const off = new URL(options.url);
+    off.searchParams.set("elbPreview", "off");
+    deactivationUrl = off.toString();
+  } else {
+    stdoutLast = preview.activationUrl;
+  }
+  const lines = [
+    `Preview created (${preview.id})`,
+    `  Token:      ${preview.token}`,
+    `  Created by: ${preview.createdBy}`,
+    `  Bundle URL: ${preview.bundleUrl}`,
+    "",
+    options.url ? `  Activate:   ${stdoutLast}` : `  Activate:   Append ${stdoutLast} to any URL on your site`,
+    deactivationUrl ? `  Deactivate: ${deactivationUrl}` : `  Deactivate: Append ?elbPreview=off to any URL on your site`,
+    ""
+  ];
+  return { stdoutLast, stderr: lines.join("\n") };
+}
+function printPreviewCreated(preview, options) {
+  const { stdoutLast, stderr } = formatPreviewCreated(preview, options);
+  process.stderr.write(stderr + "\n");
+  process.stdout.write(stdoutLast + "\n");
+}
+var init_output2 = __esm({
+  "src/commands/previews/output.ts"() {
+    "use strict";
+  }
+});
+
 // src/cli.ts
 import { Command } from "commander";
 
@@ -18255,61 +18616,7 @@ var VERSION = JSON.parse(findPackageJson()).version;
 
 // src/cli.ts
 init_client_context();
-
-// 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(error48, fallbackMessage) {
-  if (error48 && typeof error48 === "object" && "error" in error48 && typeof error48.error === "object") {
-    const inner = error48.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);
-}
+init_api_error();
 
 // src/core/banner.ts
 import chalk from "chalk";
@@ -18374,7 +18681,7 @@ async function ne3(e3, n3, t) {
   if (n3.init && !n3.config.init) {
     const o2 = n3.type || "unknown", s2 = e3.logger.scope(`transformer:${o2}`), r2 = { collector: e3, logger: s2, id: t, ingest: x(t), config: n3.config, env: se2(n3.config.env) };
     s2.debug("init");
-    const i2 = await De(n3.init, "TransformerInit", e3.hooks)(r2);
+    const i2 = await De(n3.init, "TransformerInit", e3.hooks, e3.logger)(r2);
     if (false === i2) return false;
     n3.config = { ...i2 || n3.config, env: i2?.env || n3.config.env, init: true }, s2.debug("init done");
   }
@@ -18383,7 +18690,7 @@ async function ne3(e3, n3, t) {
 async function te3(e3, n3, t, o2, s2, r2) {
   const i2 = n3.type || "unknown", a2 = e3.logger.scope(`transformer:${i2}`), c3 = { collector: e3, logger: a2, id: t, ingest: s2, config: n3.config, env: { ...se2(n3.config.env), ...r2 ? { respond: r2 } : {} } };
   a2.debug("push", { event: o2.name });
-  const u4 = await De(n3.push, "TransformerPush", e3.hooks)(o2, c3);
+  const u4 = await De(n3.push, "TransformerPush", e3.hooks, e3.logger)(o2, c3);
   return a2.debug("push done"), u4;
 }
 async function oe2(e3, n3, t, o2, s2, r2, i2) {
@@ -21411,6 +21718,7 @@ async function logoutCommand(options) {
 
 // src/commands/auth/index.ts
 init_api_client();
+init_api_error();
 init_cli_logger();
 init_output();
 async function whoami() {
@@ -21438,6 +21746,7 @@ async function whoamiCommand(options) {
 
 // src/commands/projects/index.ts
 init_api_client();
+init_api_error();
 init_auth();
 init_output();
 async function listProjects() {
@@ -21525,168 +21834,18 @@ async function deleteProjectCommand(projectId, options) {
   );
 }
 
-// src/commands/flows/index.ts
-init_api_client();
-init_auth();
-init_output();
-init_stdin();
-async function listFlows(options = {}) {
-  const id = options.projectId ?? requireProjectId();
-  const client = createApiClient();
-  const { data, error: error48 } = await client.GET("/api/projects/{projectId}/flows", {
-    params: {
-      path: { projectId: id },
-      query: {
-        sort: options.sort,
-        order: options.order,
-        include_deleted: options.includeDeleted ? "true" : void 0
-      }
-    }
-  });
-  if (error48) throwApiError(error48, "Failed to list flows");
-  return data;
-}
-async function getFlow(options) {
-  const id = options.projectId ?? requireProjectId();
-  const client = createApiClient();
-  const { data, error: error48 } = await client.GET(
-    "/api/projects/{projectId}/flows/{flowId}",
-    {
-      params: {
-        path: { projectId: id, flowId: options.flowId },
-        query: options.fields ? { fields: options.fields.join(",") } : {}
-      }
-    }
-  );
-  if (error48) throwApiError(error48, "Failed to get flow");
-  return data;
-}
-async function createFlow(options) {
-  const id = options.projectId ?? requireProjectId();
-  const client = createApiClient();
-  const { data, error: error48 } = await client.POST("/api/projects/{projectId}/flows", {
-    params: { path: { projectId: id } },
-    // Config is user-provided JSON; server validates the full schema
-    body: { name: options.name, config: options.content }
-  });
-  if (error48) throwApiError(error48, "Failed to create flow");
-  return data;
-}
-async function updateFlow(options) {
-  const id = options.projectId ?? requireProjectId();
-  const client = createApiClient();
-  const body = {};
-  if (options.name !== void 0) body.name = options.name;
-  if (options.content !== void 0) body.config = options.content;
-  const { data, error: error48 } = await client.PATCH(
-    "/api/projects/{projectId}/flows/{flowId}",
-    {
-      params: { path: { projectId: id, flowId: options.flowId } },
-      // Dynamically constructed body; server validates the full schema
-      body,
-      ...options.mergePatch && {
-        headers: { "Content-Type": "application/merge-patch+json" }
-      }
-    }
-  );
-  if (error48) throwApiError(error48, "Failed to update flow");
-  return data;
-}
-async function deleteFlow(options) {
-  const id = options.projectId ?? requireProjectId();
-  const client = createApiClient();
-  const { data, error: error48 } = await client.DELETE(
-    "/api/projects/{projectId}/flows/{flowId}",
-    {
-      params: { path: { projectId: id, flowId: options.flowId } }
-    }
-  );
-  if (error48) throwApiError(error48, "Failed to delete flow");
-  return data ?? { success: true };
-}
-async function duplicateFlow(options) {
-  const id = options.projectId ?? requireProjectId();
-  const client = createApiClient();
-  const { data, error: error48 } = await client.POST(
-    "/api/projects/{projectId}/flows/{flowId}/duplicate",
-    {
-      params: { path: { projectId: id, flowId: options.flowId } },
-      body: { name: options.name }
-    }
-  );
-  if (error48) throwApiError(error48, "Failed to duplicate flow");
-  return data;
-}
-async function handleResult2(fn2, options) {
-  try {
-    const result = await fn2();
-    await writeResult(JSON.stringify(result, null, 2), options);
-  } catch (error48) {
-    handleCliError(error48);
-  }
-}
-async function listFlowsCommand(options) {
-  await handleResult2(
-    () => listFlows({
-      projectId: options.project,
-      sort: options.sort,
-      order: options.order,
-      includeDeleted: options.includeDeleted
-    }),
-    options
-  );
-}
-async function getFlowCommand(flowId, options) {
-  await handleResult2(
-    () => getFlow({ flowId, projectId: options.project }),
-    options
-  );
-}
-async function createFlowCommand(name, options) {
-  const content = options.content ? JSON.parse(options.content) : JSON.parse(await readFlowStdin());
-  await handleResult2(
-    () => createFlow({ name, content, projectId: options.project }),
-    options
-  );
-}
-async function updateFlowCommand(flowId, options) {
-  const content = options.content ? JSON.parse(options.content) : void 0;
-  await handleResult2(
-    () => updateFlow({
-      flowId,
-      name: options.name,
-      content,
-      projectId: options.project
-    }),
-    options
-  );
-}
-async function deleteFlowCommand(flowId, options) {
-  await handleResult2(
-    () => deleteFlow({ flowId, projectId: options.project }),
-    options
-  );
-}
-async function duplicateFlowCommand(flowId, options) {
-  await handleResult2(
-    () => duplicateFlow({ flowId, name: options.name, projectId: options.project }),
-    options
-  );
-}
-async function readFlowStdin() {
-  if (!isStdinPiped()) {
-    throw new Error("Content required: use --content or pipe via stdin");
-  }
-  return readStdin();
-}
+// src/cli.ts
+init_flows();
 
 // src/commands/deploy/index.ts
 init_api_client();
 init_auth();
 init_http();
+init_api_error();
 init_sse();
 init_cli_logger();
 init_output();
+init_flows();
 async function resolveSettingsId(options) {
   const flow = await getFlow({
     flowId: options.flowId,
@@ -21873,6 +22032,7 @@ async function deployCommand(flowId, options) {
 init_dist();
 init_auth();
 init_http();
+init_api_error();
 init_cli_logger();
 init_output();
 init_loader();
@@ -22032,8 +22192,9 @@ async function createDeployCommand(config2, options) {
 // src/commands/feedback/index.ts
 init_config_file();
 init_http();
-import { createInterface } from "readline";
+init_api_error();
 init_cli_logger();
+import { createInterface } from "readline";
 async function feedback(text, options) {
   const config2 = readConfig();
   const anonymous = options?.anonymous ?? config2?.anonymousFeedback ?? true;
@@ -22103,6 +22264,7 @@ function promptUser(question) {
 }
 
 // src/cli.ts
+init_output();
 setClientContext({ type: "cli", version: VERSION });
 process.on("uncaughtException", handleCliError);
 process.on("unhandledRejection", handleCliError);
@@ -22264,6 +22426,71 @@ deployCmd.command("status <id-or-slug>").description("Get deployment details by
 deployCmd.command("delete <id-or-slug>").description("Delete a deployment").option("--project <id>", "project ID").option("--json", "output as JSON").option("-v, --verbose", "verbose output").option("-s, --silent", "suppress output").action(async (idOrSlug, options) => {
   await deleteDeploymentCommand(idOrSlug, options);
 });
+var previewsCmd = program.command("previews").description("Manage preview bundles for testing flow changes on live sites");
+previewsCmd.command("list <flowId>").description("List previews for a flow").option("--project <projectId>", "Project ID (overrides default)").action(async (flowId, options) => {
+  try {
+    const { listPreviews: listPreviews2 } = await Promise.resolve().then(() => (init_previews(), previews_exports));
+    const result = await listPreviews2({
+      projectId: options.project,
+      flowId
+    });
+    await writeResult(JSON.stringify(result.previews, null, 2), {});
+  } catch (err) {
+    handleCliError(err);
+  }
+});
+previewsCmd.command("get <flowId> <previewId>").description("Get preview details").option("--project <projectId>", "Project ID (overrides default)").action(async (flowId, previewId, options) => {
+  try {
+    const { getPreview: getPreview2 } = await Promise.resolve().then(() => (init_previews(), previews_exports));
+    const result = await getPreview2({
+      projectId: options.project,
+      flowId,
+      previewId
+    });
+    await writeResult(JSON.stringify(result, null, 2), {});
+  } catch (err) {
+    handleCliError(err);
+  }
+});
+previewsCmd.command("create <flowId>").description("Create a preview bundle for a flow settings entry").option("-f, --flow <name>", "Flow settings name (resolved to ID)").option("-s, --settings-id <id>", "Flow settings ID (alternative to --flow)").option("-u, --url <url>", "Site URL to construct activation URL").option("--project <projectId>", "Project ID (overrides default)").action(async (flowId, options) => {
+  try {
+    if (options.url) {
+      try {
+        new URL(options.url);
+      } catch {
+        throw new Error(`Invalid --url value: ${options.url}`);
+      }
+    }
+    const { createPreview: createPreview2 } = await Promise.resolve().then(() => (init_previews(), previews_exports));
+    const { printPreviewCreated: printPreviewCreated2 } = await Promise.resolve().then(() => (init_output2(), output_exports));
+    const preview = await createPreview2({
+      projectId: options.project,
+      flowId,
+      flowName: options.flow,
+      flowSettingsId: options.settingsId
+    });
+    printPreviewCreated2(preview, { url: options.url });
+  } catch (err) {
+    handleCliError(err);
+  }
+});
+previewsCmd.command("delete <flowId> <previewId>").description("Delete a preview").option("-y, --yes", "Skip confirmation prompt").option("--project <projectId>", "Project ID (overrides default)").action(async (flowId, previewId, options) => {
+  try {
+    if (!options.yes) {
+      throw new Error("Confirmation required. Use --yes to skip.");
+    }
+    const { deletePreview: deletePreview2 } = await Promise.resolve().then(() => (init_previews(), previews_exports));
+    await deletePreview2({
+      projectId: options.project,
+      flowId,
+      previewId
+    });
+    process.stderr.write(`Deleted ${previewId}
+`);
+  } catch (err) {
+    handleCliError(err);
+  }
+});
 program.command("run [file]").description("Run a walkerOS flow").option("-f, --flow <name>", "flow name for multi-flow configs").option("--flow-id <id>", "API flow ID (enables heartbeat, polling, secrets)").option("--project <id>", "project ID (defaults to WALKEROS_PROJECT_ID)").option("-p, --port <number>", "port to listen on (default: 8080)", parseInt).option("--json", "output as JSON").option("-v, --verbose", "verbose output").option("-s, --silent", "suppress output").action(async (file2, options) => {
   await runCommand({
     config: file2 || process.env.BUNDLE,