@walkeros/cli 2.2.0-next-1773136823705 → 3.0.0

package/dist/index.js

@@ -573,6 +573,8 @@ var init_core = __esm({
     init_local_packages();
     init_input_detector();
     init_stdin();
+    init_auth();
+    init_sse();
   }
 });
 
@@ -744,6 +746,7 @@ var init_config = __esm({
   "src/config/index.ts"() {
     "use strict";
     init_validators();
+    init_build_defaults();
     init_utils();
     init_loader();
   }
@@ -751,8 +754,10 @@ var init_config = __esm({
 
 // src/core/cache-utils.ts
 import { getHashServer } from "@walkeros/server-core";
+import semver from "semver";
 function isMutableVersion(version) {
-  return version === "latest" || version.includes("^") || version.includes("~") || version.includes("*") || version.includes("x");
+  if (semver.valid(version)) return false;
+  return true;
 }
 function getTodayDate() {
   return (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
@@ -789,7 +794,7 @@ var init_cache_utils = __esm({
 import pacote from "pacote";
 import path7 from "path";
 import fs6 from "fs-extra";
-import semver from "semver";
+import semver2 from "semver";
 async function withTimeout(promise, ms, errorMessage) {
   let timer;
   const timeout = new Promise((_2, reject) => {
@@ -901,14 +906,14 @@ function resolveVersionConflicts(allSpecs, logger) {
       (a2, b2) => SOURCE_PRIORITY[a2.source] - SOURCE_PRIORITY[b2.source]
     );
     const directSpecs = activeSpecs.filter((s2) => s2.source === "direct");
-    const directExact = directSpecs.find((s2) => semver.valid(s2.spec) !== null);
+    const directExact = directSpecs.find((s2) => semver2.valid(s2.spec) !== null);
     let chosenVersion;
     if (directExact) {
       chosenVersion = directExact.spec;
     } else if (directSpecs.length > 0) {
       chosenVersion = directSpecs[0].spec;
     } else {
-      const exactVersions = activeSpecs.filter((s2) => semver.valid(s2.spec) !== null).map((s2) => s2.spec);
+      const exactVersions = activeSpecs.filter((s2) => semver2.valid(s2.spec) !== null).map((s2) => s2.spec);
       const uniqueExact = [...new Set(exactVersions)];
       if (uniqueExact.length > 1) {
         throw new Error(
@@ -920,10 +925,10 @@ function resolveVersionConflicts(allSpecs, logger) {
         chosenVersion = activeSpecs[0].spec;
       }
     }
-    if (semver.valid(chosenVersion)) {
+    if (semver2.valid(chosenVersion)) {
       for (const spec of specs) {
         if (spec.localPath) continue;
-        if (semver.valid(spec.spec)) {
+        if (semver2.valid(spec.spec)) {
           if (spec.spec !== chosenVersion) {
             if (spec.source === "peerDependency") {
               logger.warn(
@@ -932,7 +937,7 @@ function resolveVersionConflicts(allSpecs, logger) {
             }
           }
         } else {
-          if (!semver.satisfies(chosenVersion, spec.spec, {
+          if (!semver2.satisfies(chosenVersion, spec.spec, {
             includePrerelease: true
           })) {
             if (spec.source === "peerDependency") {
@@ -2506,11 +2511,11 @@ import fs12 from "fs-extra";
 import { assign as o } from "@walkeros/core";
 import { assign as r, createLogger as i } from "@walkeros/core";
 import { assign as a, clone as c, debounce as u, getId as f, getGrantedConsent as l, isDefined as g, isFunction as d, isObject as m, processEventMapping as p, tryCatchAsync as h, useHooks as w } from "@walkeros/core";
-import { isArray as y } from "@walkeros/core";
-import { tryCatch as b, tryCatchAsync as v } from "@walkeros/core";
-import { getMappingValue as k, tryCatchAsync as C } from "@walkeros/core";
-import { isObject as O, tryCatchAsync as j, useHooks as q } from "@walkeros/core";
-import { assign as M, getId as Q, isFunction as V, isString as _ } from "@walkeros/core";
+import { isArray as b } from "@walkeros/core";
+import { tryCatch as y, tryCatchAsync as v } from "@walkeros/core";
+import { getMappingValue as k, tryCatchAsync as O } from "@walkeros/core";
+import { isObject as C, tryCatchAsync as j, useHooks as q } from "@walkeros/core";
+import { assign as L, getId as Q, isFunction as V, isString as _ } from "@walkeros/core";
 import { isObject as K } from "@walkeros/core";
 import { getGrantedConsent as en, processEventMapping as tn, tryCatchAsync as on, useHooks as sn } from "@walkeros/core";
 import { useHooks as an, tryCatchAsync as cn } from "@walkeros/core";
@@ -2555,7 +2560,7 @@ async function x(n, e2, t2) {
     s2.debug("init");
     const i2 = await q(e2.init, "TransformerInit", n.hooks)(r2);
     if (false === i2) return false;
-    e2.config = { ...i2 || e2.config, init: true }, s2.debug("init done");
+    e2.config = { ...i2 || e2.config, env: i2?.env || e2.config.env, init: true }, s2.debug("init done");
   }
   return true;
 }
@@ -2588,7 +2593,7 @@ async function S(n, e2, t2, o2, s2, r2) {
   return i2;
 }
 function $(n) {
-  return n && O(n) ? n : {};
+  return n && C(n) ? n : {};
 }
 async function R(n, e2, t2) {
   const { code: o2, config: s2 = {}, env: r2 = {}, primary: i2, next: a2 } = t2;
@@ -2597,7 +2602,7 @@ async function R(n, e2, t2) {
     c2 = s2.ingest ? await k(e3, s2.ingest, { collector: n }) : void 0;
   }, setRespond: (n2) => {
     u2 = n2;
-  } }, m2 = await C(o2)(d2);
+  } }, m2 = await O(o2)(d2);
   if (!m2) return;
   const p2 = m2.type || "unknown", h2 = n.logger.scope(p2).scope(e2);
   return g2.logger = h2, i2 && (m2.config = { ...m2.config, primary: i2 }), m2;
@@ -2616,15 +2621,15 @@ async function T(n, e2 = {}) {
   return t2;
 }
 async function I(n, e2, t2) {
-  const o2 = n.on, s2 = o2[e2] || [], r2 = y(t2) ? t2 : [t2];
+  const o2 = n.on, s2 = o2[e2] || [], r2 = b(t2) ? t2 : [t2];
   r2.forEach((n2) => {
     s2.push(n2);
   }), o2[e2] = s2, await G(n, e2, r2);
 }
 function B(n, e2, t2, o2, s2) {
   if (!e2.on) return;
-  const r2 = e2.type || "unknown", i2 = n.logger.scope(r2).scope("on").scope(o2), a2 = { collector: n, logger: i2, id: t2, config: e2.config, data: s2, env: L(e2.env, e2.config.env) };
-  b(e2.on)(o2, a2);
+  const r2 = e2.type || "unknown", i2 = n.logger.scope(r2).scope("on").scope(o2), a2 = { collector: n, logger: i2, id: t2, config: e2.config, data: s2, env: W(e2.env, e2.config.env) };
+  y(e2.on)(o2, a2);
 }
 async function G(n, e2, o2, s2) {
   let r2, i2 = o2 || [];
@@ -2681,7 +2686,7 @@ async function G(n, e2, o2, s2) {
       if (-1 === r3) continue;
       if (s3.splice(r3, 1), s3.length > 0) continue;
       delete n2.pending.destinations[t2];
-      const i3 = W(o3);
+      const i3 = M(o3);
       false !== i3.config.queue && (i3.queuePush = [...n2.queue]), n2.destinations[t2] = i3;
     }
   })(n, e2), !i2.length) return !a2;
@@ -2691,7 +2696,7 @@ async function G(n, e2, o2, s2) {
         const o3 = t2 || n2.consent;
         e3.forEach((e4) => {
           Object.keys(o3).filter((n3) => n3 in e4).forEach((t3) => {
-            b(e4[t3])(n2, o3);
+            y(e4[t3])(n2, o3);
           });
         });
       })(n, i2, s2);
@@ -2700,7 +2705,7 @@ async function G(n, e2, o2, s2) {
     case t.Commands.Run:
       !(function(n2, e3) {
         n2.allowed && e3.forEach((e4) => {
-          b(e4)(n2);
+          y(e4)(n2);
         });
       })(n, i2);
       break;
@@ -2708,21 +2713,21 @@ async function G(n, e2, o2, s2) {
       !(function(n2, e3) {
         if (!n2.session) return;
         e3.forEach((e4) => {
-          b(e4)(n2, n2.session);
+          y(e4)(n2, n2.session);
         });
       })(n, i2);
       break;
     default:
       i2.forEach((e3) => {
-        "function" == typeof e3 && b(e3)(n, r2);
+        "function" == typeof e3 && y(e3)(n, r2);
       });
   }
   return !a2;
 }
 async function H(n, e2, t2) {
   const { code: o2, config: s2 = {}, env: r2 = {}, before: i2 } = e2;
-  if (!d(o2.push)) return N({ ok: false, failed: { invalid: { type: "invalid", error: "Destination code must have a push method" } } });
-  const a2 = t2 || s2 || { init: false }, c2 = i2 ? { ...a2, before: i2 } : a2, u2 = { ...o2, config: c2, env: L(o2.env, r2) };
+  if (!d(o2.push)) return J({ ok: false, failed: { invalid: { type: "invalid", error: "Destination code must have a push method" } } });
+  const a2 = t2 || s2 || { init: false }, c2 = i2 ? { ...a2, before: i2 } : a2, u2 = { ...o2, config: c2, env: W(o2.env, r2) };
   let l2 = u2.config.id;
   if (!l2) do {
     l2 = f(4);
@@ -2731,7 +2736,7 @@ async function H(n, e2, t2) {
 }
 async function U(n, e2, t2 = {}, o2) {
   const { allowed: s2, consent: r2, globals: i2, user: u2 } = n;
-  if (!s2) return N({ ok: false });
+  if (!s2) return J({ ok: false });
   e2 && (n.queue.push(e2), n.status.in++), o2 || (o2 = n.destinations);
   const f2 = await Promise.all(Object.entries(o2 || {}).map(async ([o3, s3]) => {
     let f3 = (s3.queuePush || []).map((n2) => ({ ...n2, consent: r2 }));
@@ -2741,7 +2746,7 @@ async function U(n, e2, t2 = {}, o2) {
     }
     if (!f3.length && !s3.queueOn?.length) return { id: o3, destination: s3, skipped: true };
     if (!f3.length && s3.queueOn?.length) {
-      const e3 = await h(F)(n, s3, o3);
+      const e3 = await h(z)(n, s3, o3);
       return { id: o3, destination: s3, skipped: !e3 };
     }
     const g3 = [], d3 = f3.filter((n2) => {
@@ -2749,14 +2754,14 @@ async function U(n, e2, t2 = {}, o2) {
       return !e3 || (n2.consent = e3, g3.push(n2), false);
     });
     if (s3.queuePush.push(...d3), !g3.length) return { id: o3, destination: s3, queue: f3 };
-    if (!await h(F)(n, s3, o3)) return { id: o3, destination: s3, queue: f3 };
+    if (!await h(z)(n, s3, o3)) return { id: o3, destination: s3, queue: f3 };
     let m3, p2;
     s3.dlq || (s3.dlq = []);
     const w2 = (function(n2, e3) {
       const t3 = n2.config.before;
       return t3 ? E(t3, D(e3)) : [];
     })(s3, n.transformers);
-    let y2 = 0;
+    let b2 = 0;
     return await Promise.all(g3.map(async (e3) => {
       e3.globals = a(i2, e3.globals), e3.user = a(u2, e3.user);
       let r3 = e3;
@@ -2765,12 +2770,12 @@ async function U(n, e2, t2 = {}, o2) {
         if (null === o4) return e3;
         r3 = o4;
       }
-      const c2 = Date.now(), f4 = await h(J, (e4) => {
+      const c2 = Date.now(), f4 = await h(F, (e4) => {
         const t3 = s3.type || "unknown";
         n.logger.scope(t3).error("Push failed", { error: e4, event: r3.name }), m3 = e4, s3.dlq.push([r3, e4]);
       })(n, s3, o3, r3, t2.ingest, t2.respond);
-      return y2 += Date.now() - c2, void 0 !== f4 && (p2 = f4), e3;
-    })), { id: o3, destination: s3, error: m3, response: p2, totalDuration: y2 };
+      return b2 += Date.now() - c2, void 0 !== f4 && (p2 = f4), e3;
+    })), { id: o3, destination: s3, error: m3, response: p2, totalDuration: b2 };
   })), g2 = {}, d2 = {}, m2 = {};
   for (const e3 of f2) {
     if (e3.skipped) continue;
@@ -2779,11 +2784,11 @@ async function U(n, e2, t2 = {}, o2) {
     const o3 = n.status.destinations[e3.id], s3 = Date.now();
     e3.error ? (t3.error = e3.error, m2[e3.id] = t3, o3.failed++, o3.lastAt = s3, o3.duration += e3.totalDuration || 0, n.status.failed++) : e3.queue && e3.queue.length ? d2[e3.id] = t3 : (g2[e3.id] = t3, o3.count++, o3.lastAt = s3, o3.duration += e3.totalDuration || 0, n.status.out++);
   }
-  return N({ event: e2, ...Object.keys(g2).length && { done: g2 }, ...Object.keys(d2).length && { queued: d2 }, ...Object.keys(m2).length && { failed: m2 } });
+  return J({ event: e2, ...Object.keys(g2).length && { done: g2 }, ...Object.keys(d2).length && { queued: d2 }, ...Object.keys(m2).length && { failed: m2 } });
 }
-async function F(n, e2, t2) {
+async function z(n, e2, t2) {
   if (e2.init && !e2.config.init) {
-    const o2 = e2.type || "unknown", s2 = n.logger.scope(o2), r2 = { collector: n, logger: s2, id: t2, config: e2.config, env: L(e2.env, e2.config.env) };
+    const o2 = e2.type || "unknown", s2 = n.logger.scope(o2), r2 = { collector: n, logger: s2, id: t2, config: e2.config, env: W(e2.env, e2.config.env) };
     s2.debug("init");
     const i2 = await w(e2.init, "DestinationInit", n.hooks)(r2);
     if (false === i2) return i2;
@@ -2796,10 +2801,10 @@ async function F(n, e2, t2) {
   }
   return true;
 }
-async function J(n, e2, t2, o2, s2, r2) {
+async function F(n, e2, t2, o2, s2, r2) {
   const { config: i2 } = e2, a2 = await p(o2, i2, n);
   if (a2.ignore) return false;
-  const c2 = e2.type || "unknown", f2 = n.logger.scope(c2), l2 = { collector: n, logger: f2, id: t2, config: i2, data: a2.data, rule: a2.mapping, ingest: s2, env: { ...L(e2.env, i2.env), ...r2 ? { respond: r2 } : {} } }, d2 = a2.mapping, m2 = a2.mappingKey || "* *";
+  const c2 = e2.type || "unknown", f2 = n.logger.scope(c2), l2 = { collector: n, logger: f2, id: t2, config: i2, data: a2.data, rule: a2.mapping, ingest: s2, env: { ...W(e2.env, i2.env), ...r2 ? { respond: r2 } : {} } }, d2 = a2.mapping, m2 = a2.mappingKey || "* *";
   if (!d2?.batch || !e2.pushBatch) {
     f2.debug("push", { event: a2.event.name });
     const t3 = await w(e2.push, "DestinationPush", n.hooks)(a2.event, l2);
@@ -2809,7 +2814,7 @@ async function J(n, e2, t2, o2, s2, r2) {
     if (e2.batches = e2.batches || {}, !e2.batches[m2]) {
       const o4 = { key: m2, events: [], data: [] };
       e2.batches[m2] = { batched: o4, batchFn: u(() => {
-        const o5 = e2.batches[m2].batched, a3 = { collector: n, logger: f2, id: t2, config: i2, data: void 0, rule: d2, ingest: s2, env: { ...L(e2.env, i2.env), ...r2 ? { respond: r2 } : {} } };
+        const o5 = e2.batches[m2].batched, a3 = { collector: n, logger: f2, id: t2, config: i2, data: void 0, rule: d2, ingest: s2, env: { ...W(e2.env, i2.env), ...r2 ? { respond: r2 } : {} } };
         f2.debug("push batch", { events: o5.events.length }), w(e2.pushBatch, "DestinationPushBatch", n.hooks)(o5, a3), f2.debug("push batch done"), o5.events = [], o5.data = [];
       }, d2.batch) };
     }
@@ -2818,19 +2823,19 @@ async function J(n, e2, t2, o2, s2, r2) {
   }
   return true;
 }
-function N(n) {
+function J(n) {
   return { ok: !n?.failed, ...n };
 }
-function W(n) {
-  const { code: e2, config: t2 = {}, env: o2 = {} } = n, { config: s2 } = A(n, "before"), r2 = { ...e2.config, ...t2, ...s2 }, i2 = L(e2.env, o2);
+function M(n) {
+  const { code: e2, config: t2 = {}, env: o2 = {} } = n, { config: s2 } = A(n, "before"), r2 = { ...e2.config, ...t2, ...s2 }, i2 = W(e2.env, o2);
   return { ...e2, config: r2, env: i2 };
 }
-async function z(n, e2 = {}) {
+async function N(n, e2 = {}) {
   const t2 = {};
-  for (const [o2, s2] of Object.entries(e2)) s2.config?.require?.length ? n.pending.destinations[o2] = s2 : t2[o2] = W(s2);
+  for (const [o2, s2] of Object.entries(e2)) s2.config?.require?.length ? n.pending.destinations[o2] = s2 : t2[o2] = M(s2);
   return t2;
 }
-function L(n, e2) {
+function W(n, e2) {
   return n || e2 ? e2 ? n && m(n) && m(e2) ? { ...n, ...e2 } : e2 : n : {};
 }
 async function X(n, e2, t2) {
@@ -2850,7 +2855,7 @@ async function Y(n, e2, o2, r2) {
   let i2, a2, c2 = false, u2 = false;
   switch (e2) {
     case t.Commands.Config:
-      K(o2) && (M(n.config, o2, { shallow: false }), a2 = o2, c2 = true);
+      K(o2) && (L(n.config, o2, { shallow: false }), a2 = o2, c2 = true);
       break;
     case t.Commands.Consent:
       if (K(o2)) {
@@ -2859,13 +2864,13 @@ async function Y(n, e2, o2, r2) {
       }
       break;
     case t.Commands.Custom:
-      K(o2) && (n.custom = M(n.custom, o2), a2 = o2, c2 = true);
+      K(o2) && (n.custom = L(n.custom, o2), a2 = o2, c2 = true);
       break;
     case t.Commands.Destination:
       K(o2) && ("code" in o2 && K(o2.code) ? i2 = await H(n, o2, r2) : V(o2.push) && (i2 = await H(n, { code: o2 }, r2)));
       break;
     case t.Commands.Globals:
-      K(o2) && (n.globals = M(n.globals, o2), a2 = o2, c2 = true);
+      K(o2) && (n.globals = L(n.globals, o2), a2 = o2, c2 = true);
       break;
     case t.Commands.On:
       _(o2) && await I(n, o2, r2);
@@ -2886,20 +2891,20 @@ async function Y(n, e2, o2, r2) {
       })(n);
       break;
     case t.Commands.User:
-      K(o2) && (M(n.user, o2, { shallow: false }), a2 = o2, c2 = true);
+      K(o2) && (L(n.user, o2, { shallow: false }), a2 = o2, c2 = true);
   }
-  return c2 && await G(n, e2, void 0, a2), u2 && (i2 = await U(n)), i2 || N({ ok: true });
+  return c2 && await G(n, e2, void 0, a2), u2 && (i2 = await U(n)), i2 || J({ ok: true });
 }
 function Z(n, e2) {
   if (!e2.name) throw new Error("Event name is required");
   const [t2, o2] = e2.name.split(" ");
   if (!t2 || !o2) throw new Error("Event name is invalid");
   ++n.count;
-  const { timestamp: s2 = Date.now(), group: r2 = n.group, count: i2 = n.count } = e2, { name: a2 = `${t2} ${o2}`, data: c2 = {}, context: u2 = {}, globals: f2 = n.globals, custom: l2 = {}, user: g2 = n.user, nested: d2 = [], consent: m2 = n.consent, id: p2 = `${s2}-${r2}-${i2}`, trigger: h2 = "", entity: w2 = t2, action: y2 = o2, timing: b2 = 0, version: v2 = { source: n.version, tagging: n.config.tagging || 0 }, source: k2 = { type: "collector", id: "", previous_id: "" } } = e2;
-  return { name: a2, data: c2, context: u2, globals: f2, custom: l2, user: g2, nested: d2, consent: m2, id: p2, trigger: h2, entity: w2, action: y2, timestamp: s2, timing: b2, group: r2, count: i2, version: v2, source: k2 };
+  const { timestamp: s2 = Date.now(), group: r2 = n.group, count: i2 = n.count } = e2, { name: a2 = `${t2} ${o2}`, data: c2 = {}, context: u2 = {}, globals: f2 = n.globals, custom: l2 = {}, user: g2 = n.user, nested: d2 = [], consent: m2 = n.consent, id: p2 = `${s2}-${r2}-${i2}`, trigger: h2 = "", entity: w2 = t2, action: b2 = o2, timing: y2 = 0, version: v2 = { source: n.version, tagging: n.config.tagging || 0 }, source: k2 = { type: "collector", id: "", previous_id: "" } } = e2;
+  return { name: a2, data: c2, context: u2, globals: f2, custom: l2, user: g2, nested: d2, consent: m2, id: p2, trigger: h2, entity: w2, action: b2, timestamp: s2, timing: y2, group: r2, count: i2, version: v2, source: k2 };
 }
 async function nn(n, e2) {
-  n.allowed = true, n.count = 0, n.group = Q(), n.timing = Date.now(), e2 && (e2.consent && (n.consent = M(n.consent, e2.consent)), e2.user && (n.user = M(n.user, e2.user)), e2.globals && (n.globals = M(n.config.globalsStatic || {}, e2.globals)), e2.custom && (n.custom = M(n.custom, e2.custom))), Object.values(n.destinations).forEach((n2) => {
+  n.allowed = true, n.count = 0, n.group = Q(), n.timing = Date.now(), e2 && (e2.consent && (n.consent = L(n.consent, e2.consent)), e2.user && (n.user = L(n.user, e2.user)), e2.globals && (n.globals = L(n.config.globalsStatic || {}, e2.globals)), e2.custom && (n.custom = L(n.custom, e2.custom))), Object.values(n.destinations).forEach((n2) => {
     n2.queuePush = [];
   }), n.queue = [], n.round++;
   return await U(n);
@@ -2911,15 +2916,15 @@ function rn(n, e2) {
     const l2 = i2 ? Object.freeze(i2) : void 0;
     if (c2) {
       const e3 = await tn(f2, c2, n);
-      if (e3.ignore) return N({ ok: true });
+      if (e3.ignore) return J({ ok: true });
       if (c2.consent) {
-        if (!en(c2.consent, n.consent, e3.event.consent)) return N({ ok: true });
+        if (!en(c2.consent, n.consent, e3.event.consent)) return J({ ok: true });
       }
       f2 = e3.event;
     }
     if (u2?.length && n.transformers && Object.keys(n.transformers).length > 0) {
       const e3 = await S(n, n.transformers, u2, f2, l2, a2);
-      if (null === e3) return N({ ok: true });
+      if (null === e3) return J({ ok: true });
       f2 = e3;
     }
     const g2 = e2(f2), d2 = Z(n, g2), m2 = await U(n, d2, { id: r2, ingest: l2, respond: a2 });
@@ -2929,24 +2934,40 @@ function rn(n, e2) {
       e3.count++, e3.lastAt = Date.now(), e3.duration += Date.now() - s2;
     }
     return m2;
-  }, () => N({ ok: false }))(), "Push", n.hooks);
+  }, () => J({ ok: false }))(), "Push", n.hooks);
 }
 async function un(n) {
   const e2 = r({ globalsStatic: {}, sessionStatic: {}, tagging: 0, run: true }, n, { merge: false, extend: false }), t2 = { level: n.logger?.level, handler: n.logger?.handler }, o2 = i(t2), s2 = { ...e2.globalsStatic, ...n.globals }, a2 = { allowed: false, config: e2, consent: n.consent || {}, count: 0, custom: n.custom || {}, destinations: {}, transformers: {}, stores: {}, globals: s2, group: "", hooks: {}, logger: o2, on: {}, queue: [], round: 0, session: void 0, status: { startedAt: Date.now(), in: 0, out: 0, failed: 0, sources: {}, destinations: {} }, timing: Date.now(), user: n.user || {}, version: "2.1.1", sources: {}, pending: { sources: {}, destinations: {} }, push: void 0, command: void 0 };
-  return a2.push = rn(a2, (n2) => ({ timing: Math.round((Date.now() - a2.timing) / 10) / 100, source: { type: "collector", id: "", previous_id: "" }, ...n2 })), a2.command = (function(n2, e3) {
-    return an(async (t3, o3, s3) => await cn(async () => await e3(n2, t3, o3, s3), () => N({ ok: false }))(), "Command", n2.hooks);
-  })(a2, Y), a2.stores = await (async function(n2, e3 = {}) {
+  a2.push = rn(a2, (n2) => ({ timing: Math.round((Date.now() - a2.timing) / 10) / 100, source: { type: "collector", id: "", previous_id: "" }, ...n2 })), a2.command = (function(n2, e3) {
+    return an(async (t3, o3, s3) => await cn(async () => await e3(n2, t3, o3, s3), () => J({ ok: false }))(), "Command", n2.hooks);
+  })(a2, Y);
+  const c2 = n.stores || {};
+  return a2.stores = await (async function(n2, e3 = {}) {
     const t3 = {};
     for (const [o3, s3] of Object.entries(e3)) {
-      const { code: e4, config: r2 = {}, env: i2 = {} } = s3, a3 = n2.logger.scope("store").scope(o3), c2 = { collector: n2, logger: a3, id: o3, config: r2, env: i2 }, u2 = await e4(c2);
+      const { code: e4, config: r2 = {}, env: i2 = {} } = s3, a3 = n2.logger.scope("store").scope(o3), c3 = { collector: n2, logger: a3, id: o3, config: r2, env: i2 }, u2 = await e4(c3);
       t3[o3] = u2;
     }
     return t3;
-  })(a2, n.stores || {}), a2.destinations = await z(a2, n.destinations || {}), a2.transformers = await (async function(n2, e3 = {}) {
+  })(a2, c2), (function(n2, e3, t3) {
+    const o3 = /* @__PURE__ */ new Map();
+    for (const [t4, s4] of Object.entries(n2)) e3[t4] && o3.set(s4, e3[t4]);
+    if (0 !== o3.size) {
+      for (const n3 of [t3.transformers, t3.destinations, t3.sources]) if (n3) for (const e4 of Object.values(n3)) s3(e4.env);
+    }
+    function s3(n3) {
+      if (n3) {
+        for (const [e4, t4] of Object.entries(n3)) if ("object" == typeof t4 && null !== t4) {
+          const s4 = o3.get(t4);
+          s4 && (n3[e4] = s4);
+        }
+      }
+    }
+  })(c2, a2.stores, n), a2.destinations = await N(a2, n.destinations || {}), a2.transformers = await (async function(n2, e3 = {}) {
     const t3 = {};
     for (const [o3, s3] of Object.entries(e3)) {
-      const { code: e4, env: r2 = {} } = s3, { config: i2 } = A(s3, "next"), a3 = n2.logger.scope("transformer").scope(o3), c2 = { collector: n2, logger: a3, id: o3, config: i2, env: r2 }, u2 = await e4(c2);
-      t3[o3] = u2;
+      const { code: e4, env: r2 = {} } = s3, { config: i2 } = A(s3, "next"), a3 = Object.keys(r2).length > 0 ? { ...i2, env: r2 } : i2, c3 = n2.logger.scope("transformer").scope(o3), u2 = { collector: n2, logger: c3, id: o3, config: a3, env: r2 }, f2 = await e4(u2);
+      t3[o3] = f2;
     }
     return t3;
   })(a2, n.transformers || {}), a2;
@@ -2961,7 +2982,7 @@ async function fn(n) {
     let a3;
     if ("string" == typeof n2) a3 = { name: n2 }, e3 && "object" == typeof e3 && !Array.isArray(e3) && (a3.data = e3);
     else {
-      if (!n2 || "object" != typeof n2) return N({ ok: false });
+      if (!n2 || "object" != typeof n2) return J({ ok: false });
       a3 = n2, e3 && "object" == typeof e3 && !Array.isArray(e3) && (a3.data = { ...a3.data || {}, ...e3 });
     }
     return s3 && "object" == typeof s3 && (a3.context = s3), r3 && Array.isArray(r3) && (a3.nested = r3), i3 && "object" == typeof i3 && (a3.custom = i3), o2.push(a3);
@@ -4072,6 +4093,91 @@ import { z as z2 } from "@walkeros/core/dev";
 var PortSchema = z2.number().int("Port must be an integer").min(1, "Port must be at least 1").max(65535, "Port must be at most 65535").describe("HTTP server port number");
 var FilePathSchema = z2.string().min(1, "File path cannot be empty").describe("Path to configuration file");
 
+// src/schemas/run.ts
+import { z as z3 } from "@walkeros/core/dev";
+var RunOptionsSchema = z3.object({
+  flow: FilePathSchema,
+  port: PortSchema.default(8080),
+  flowName: z3.string().optional().describe("Specific flow name to run")
+});
+
+// src/schemas/validate.ts
+import { z as z4 } from "@walkeros/core/dev";
+var ValidationTypeSchema = z4.enum(["contract", "event", "flow", "mapping"]).describe('Validation type: "event", "flow", "mapping", or "contract"');
+var ValidateOptionsSchema = z4.object({
+  flow: z4.string().optional().describe("Flow name for multi-flow configs"),
+  path: z4.string().optional().describe(
+    'Entry path for package schema validation (e.g., "destinations.snowplow", "sources.browser")'
+  )
+});
+var ValidateInputShape = {
+  type: ValidationTypeSchema,
+  input: z4.string().min(1).describe("JSON string, file path, or URL to validate"),
+  flow: z4.string().optional().describe("Flow name for multi-flow configs"),
+  path: z4.string().optional().describe(
+    'Entry path for package schema validation (e.g., "destinations.snowplow"). When provided, validates the entry against its package JSON Schema instead of using --type.'
+  )
+};
+var ValidateInputSchema = z4.object(ValidateInputShape);
+
+// src/schemas/bundle.ts
+import { z as z5 } from "@walkeros/core/dev";
+var BundleOptionsSchema = z5.object({
+  silent: z5.boolean().optional().describe("Suppress all output"),
+  verbose: z5.boolean().optional().describe("Enable verbose logging"),
+  stats: z5.boolean().optional().default(true).describe("Return bundle statistics"),
+  cache: z5.boolean().optional().default(true).describe("Enable package caching"),
+  flowName: z5.string().optional().describe("Flow name for multi-flow configs")
+});
+var BundleInputShape = {
+  configPath: FilePathSchema.describe(
+    "Path to flow configuration file (JSON or JavaScript)"
+  ),
+  flow: z5.string().optional().describe("Flow name for multi-flow configs"),
+  stats: z5.boolean().optional().default(true).describe("Return bundle statistics"),
+  output: z5.string().optional().describe("Output file path (defaults to config-defined)")
+};
+var BundleInputSchema = z5.object(BundleInputShape);
+
+// src/schemas/simulate.ts
+import { z as z6 } from "@walkeros/core/dev";
+var PlatformSchema = z6.enum(["web", "server"]).describe("Platform type for event processing");
+var SimulateOptionsSchema = z6.object({
+  silent: z6.boolean().optional().describe("Suppress all output"),
+  verbose: z6.boolean().optional().describe("Enable verbose logging"),
+  json: z6.boolean().optional().describe("Format output as JSON")
+});
+var SimulateInputShape = {
+  configPath: FilePathSchema.describe("Path to flow configuration file"),
+  event: z6.string().min(1).optional().describe(
+    "Event as JSON string, file path, or URL. Optional when example is provided."
+  ),
+  flow: z6.string().optional().describe("Flow name for multi-flow configs"),
+  platform: PlatformSchema.optional().describe("Override platform detection"),
+  example: z6.string().optional().describe(
+    'Name of a step example to use as event input (uses its "in" value)'
+  ),
+  step: z6.string().optional().describe(
+    'Step target in type.name format (e.g. "destination.gtag") to narrow example lookup'
+  )
+};
+var SimulateInputSchema = z6.object(SimulateInputShape);
+
+// src/schemas/push.ts
+import { z as z7 } from "@walkeros/core/dev";
+var PushOptionsSchema = z7.object({
+  silent: z7.boolean().optional().describe("Suppress all output"),
+  verbose: z7.boolean().optional().describe("Enable verbose logging"),
+  json: z7.boolean().optional().describe("Format output as JSON")
+});
+var PushInputShape = {
+  configPath: FilePathSchema.describe("Path to flow configuration file"),
+  event: z7.string().min(1).describe("Event as JSON string, file path, or URL"),
+  flow: z7.string().optional().describe("Flow name for multi-flow configs"),
+  platform: PlatformSchema.optional().describe("Override platform detection")
+};
+var PushInputSchema = z7.object(PushInputShape);
+
 // src/commands/run/validators.ts
 function validateFlowFile(filePath) {
   const absolutePath = resolveAsset(filePath, "bundle");
@@ -4763,6 +4869,14 @@ init_config();
 import chalk2 from "chalk";
 
 // src/commands/validate/validators/contract.ts
+var SECTION_KEYS = ["globals", "context", "custom", "user", "consent"];
+var KNOWN_KEYS = /* @__PURE__ */ new Set([
+  "extends",
+  "tagging",
+  "description",
+  "events",
+  ...SECTION_KEYS
+]);
 function validateContract(input) {
   const errors = [];
   const warnings = [];
@@ -4770,32 +4884,108 @@ function validateContract(input) {
   if (typeof input !== "object" || input === null || Array.isArray(input)) {
     errors.push({
       path: "root",
-      message: "Contract must be an object",
+      message: "Contract must be an object of named contract entries",
       code: "INVALID_CONTRACT"
     });
     return { valid: false, type: "contract", errors, warnings, details };
   }
-  const contract = input;
-  let entityCount = 0;
-  let actionCount = 0;
-  if ("$tagging" in contract) {
-    const tagging = contract.$tagging;
-    if (typeof tagging !== "number" || !Number.isInteger(tagging) || tagging < 0) {
+  const contracts = input;
+  const contractNames = Object.keys(contracts);
+  details.contractCount = contractNames.length;
+  for (const [name, entry] of Object.entries(contracts)) {
+    if (typeof entry !== "object" || entry === null) {
       errors.push({
-        path: "$tagging",
-        message: "$tagging must be a non-negative integer",
-        value: tagging,
-        code: "INVALID_TAGGING"
+        path: name,
+        message: `Contract "${name}" must be an object`,
+        code: "INVALID_CONTRACT_ENTRY"
       });
-    } else {
-      details.tagging = tagging;
+      continue;
+    }
+    const obj = entry;
+    if (obj.extends !== void 0) {
+      if (typeof obj.extends !== "string") {
+        errors.push({
+          path: `${name}.extends`,
+          message: "extends must be a string",
+          code: "INVALID_EXTENDS"
+        });
+      } else if (!contractNames.includes(obj.extends)) {
+        errors.push({
+          path: `${name}.extends`,
+          message: `extends references non-existent contract "${obj.extends}"`,
+          value: obj.extends,
+          code: "INVALID_EXTENDS"
+        });
+      }
+    }
+    if (obj.tagging !== void 0) {
+      if (typeof obj.tagging !== "number" || !Number.isInteger(obj.tagging) || obj.tagging < 0) {
+        errors.push({
+          path: `${name}.tagging`,
+          message: "tagging must be a non-negative integer",
+          value: obj.tagging,
+          code: "INVALID_TAGGING"
+        });
+      }
+    }
+    for (const key of SECTION_KEYS) {
+      if (key in obj) {
+        if (typeof obj[key] !== "object" || obj[key] === null) {
+          errors.push({
+            path: `${name}.${key}`,
+            message: `Section "${key}" must be a JSON Schema object`,
+            value: obj[key],
+            code: "INVALID_SECTION"
+          });
+        }
+      }
+    }
+    if (obj.events !== void 0) {
+      if (typeof obj.events !== "object" || obj.events === null) {
+        errors.push({
+          path: `${name}.events`,
+          message: "events must be an object",
+          code: "INVALID_EVENTS"
+        });
+      } else {
+        validateEntityActions(
+          obj.events,
+          `${name}.events`,
+          errors
+        );
+      }
     }
   }
-  for (const [entityKey, entityValue] of Object.entries(contract)) {
-    if (entityKey.startsWith("$")) continue;
+  for (const name of contractNames) {
+    const visited = /* @__PURE__ */ new Set();
+    let current = name;
+    while (current) {
+      if (visited.has(current)) {
+        errors.push({
+          path: `${name}.extends`,
+          message: `Circular extends chain: ${[...visited, current].join(" \u2192 ")}`,
+          code: "CIRCULAR_EXTENDS"
+        });
+        break;
+      }
+      visited.add(current);
+      const entry = contracts[current];
+      current = entry?.extends || "";
+    }
+  }
+  return {
+    valid: errors.length === 0,
+    type: "contract",
+    errors,
+    warnings,
+    details
+  };
+}
+function validateEntityActions(obj, prefix, errors) {
+  for (const [entityKey, entityValue] of Object.entries(obj)) {
     if (entityKey.trim() === "") {
       errors.push({
-        path: entityKey,
+        path: `${prefix}.${entityKey}`,
         message: "Entity key cannot be empty",
         code: "INVALID_ENTITY_KEY"
       });
@@ -4803,19 +4993,19 @@ function validateContract(input) {
     }
     if (typeof entityValue !== "object" || entityValue === null) {
       errors.push({
-        path: entityKey,
-        message: `Entity "${entityKey}" must be an object of action entries`,
+        path: `${prefix}.${entityKey}`,
+        message: `Entity "${entityKey}" must be an object`,
         value: entityValue,
         code: "INVALID_ENTITY"
       });
       continue;
     }
-    entityCount++;
-    const actions = entityValue;
-    for (const [actionKey, actionValue] of Object.entries(actions)) {
+    for (const [actionKey, actionValue] of Object.entries(
+      entityValue
+    )) {
       if (actionKey.trim() === "") {
         errors.push({
-          path: `${entityKey}.${actionKey}`,
+          path: `${prefix}.${entityKey}.${actionKey}`,
           message: "Action key cannot be empty",
           code: "INVALID_ACTION_KEY"
         });
@@ -4823,25 +5013,14 @@ function validateContract(input) {
       }
       if (typeof actionValue !== "object" || actionValue === null || Array.isArray(actionValue)) {
         errors.push({
-          path: `${entityKey}.${actionKey}`,
-          message: `Contract entry must be a JSON Schema object`,
+          path: `${prefix}.${entityKey}.${actionKey}`,
+          message: "Contract entry must be a JSON Schema object",
           value: typeof actionValue,
           code: "INVALID_SCHEMA_ENTRY"
         });
-        continue;
       }
-      actionCount++;
     }
   }
-  details.entityCount = entityCount;
-  details.actionCount = actionCount;
-  return {
-    valid: errors.length === 0,
-    type: "contract",
-    errors,
-    warnings,
-    details
-  };
 }
 
 // src/commands/validate/validators/event.ts
@@ -4995,23 +5174,38 @@ function validateFlow(input, options = {}) {
     for (const name of flowsToCheck) {
       const flowSettings = flows[name];
       if (!flowSettings) continue;
-      checkExampleCoverage(flowSettings, warnings);
       const connections = buildConnectionGraph(flowSettings);
       for (const conn of connections) {
         checkCompatibility(conn, errors, warnings);
       }
       totalConnections += connections.length;
-      const setupContract = config.contract;
-      if (setupContract || flowSettings.contract) {
-        checkContractCompliance(
-          flowSettings,
-          setupContract,
-          flowSettings.contract,
-          warnings
-        );
+      const contract = config.contract;
+      if (contract) {
+        checkContractCompliance(flowSettings, contract, warnings);
       }
     }
     details.connectionsChecked = totalConnections;
+    for (const name of flowsToCheck) {
+      const flowSettings = flows[name];
+      if (!flowSettings) continue;
+      for (const [destName, dest] of Object.entries(
+        flowSettings.destinations || {}
+      )) {
+        const destConfig = dest;
+        const mapping = destConfig.config?.mapping;
+        if (!mapping || typeof mapping !== "object") continue;
+        for (const key of Object.keys(mapping)) {
+          if (key.includes(".") && !key.includes(" ")) {
+            const parts = key.split(".");
+            warnings.push({
+              path: `destination.${destName}.config.mapping`,
+              message: `Mapping key "${key}" looks like dot-notation. Mapping uses nested entity \u2192 action structure.`,
+              suggestion: `Use nested format: { "${parts[0]}": { "${parts.slice(1).join(".")}": { ... } } }`
+            });
+          }
+        }
+      }
+    }
   }
   return {
     valid: errors.length === 0,
@@ -5021,26 +5215,6 @@ function validateFlow(input, options = {}) {
     details
   };
 }
-function checkExampleCoverage(config, warnings) {
-  const stepTypes = [
-    { key: "sources", type: "source" },
-    { key: "transformers", type: "transformer" },
-    { key: "destinations", type: "destination" }
-  ];
-  for (const { key, type } of stepTypes) {
-    const refs = config[key];
-    if (!refs) continue;
-    for (const [name, ref] of Object.entries(refs)) {
-      if (!ref.examples || Object.keys(ref.examples).length === 0) {
-        warnings.push({
-          path: `${type}.${name}`,
-          message: `Step has no examples`,
-          suggestion: `Add examples to ${type}.${name} for testing and documentation`
-        });
-      }
-    }
-  }
-}
 function buildConnectionGraph(config) {
   const connections = [];
   for (const [name, source] of Object.entries(config.sources || {})) {
@@ -5142,16 +5316,16 @@ function isStructurallyCompatible(a2, b2) {
   }
   return true;
 }
-function checkContractCompliance(config, setupContract, flowContract, warnings) {
+function checkContractCompliance(config, contract, warnings) {
   for (const [name, dest] of Object.entries(config.destinations || {})) {
     if (!dest.examples) continue;
     for (const [exName, example] of Object.entries(dest.examples)) {
       if (!example.in || typeof example.in !== "object") continue;
       const event = example.in;
       if (!event.entity || !event.action) continue;
-      const contract = flowContract?.[event.entity] || setupContract?.[event.entity];
-      if (!contract || typeof contract !== "object") continue;
-      const actionSchema = contract[event.action] || contract["*"];
+      const entityContract = contract[event.entity];
+      if (!entityContract || typeof entityContract !== "object") continue;
+      const actionSchema = entityContract[event.action] || entityContract["*"];
       if (actionSchema) {
         warnings.push({
           path: `destination.${name}.examples.${exName}`,