@walkeros/cli 4.3.0-next-1784120651691 → 4.3.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @walkeros/cli
 
-## 4.3.0-next-1784120651691
+## 4.3.0
 
 ### Minor Changes
 
@@ -62,11 +62,11 @@
 - Updated dependencies [f8408fd]
 - Updated dependencies [907eed0]
 - Updated dependencies [9506e3e]
-  - @walkeros/collector@4.3.0-next-1784120651691
-  - @walkeros/core@4.3.0-next-1784120651691
-  - @walkeros/server-core@4.3.0-next-1784120651691
-  - @walkeros/server-destination-api@4.3.0-next-1784120651691
-  - @walkeros/transformer-validate@4.3.0-next-1784120651691
+  - @walkeros/collector@4.3.0
+  - @walkeros/core@4.3.0
+  - @walkeros/server-core@4.3.0
+  - @walkeros/server-destination-api@4.3.0
+  - @walkeros/transformer-validate@4.3.0
 
 ## 4.2.1
 

package/dist/cli.js

@@ -6652,7 +6652,7 @@ async function Be2(e4, t4, n5, o4, r6, s4, a4) {
     }
     p3 && p3.length > 0 && (i5 = await er(p3, (t5) => Te(t5, e4), i5, e4));
     const y3 = await Xe(Fe, (t5) => (e4.logger.scope(`transformer:${s5.type || "unknown"}`).error("Push failed", { error: t5 }), false))(e4, s5, o5, i5, r6, c2);
-    if (false === y3) return { event: null, respond: c2 };
+    if (false === y3) return { event: null, respond: c2, droppedBy: o5 };
     if (Array.isArray(y3)) {
       const s6 = n5.slice(n5.indexOf(o5) + 1), u3 = await Promise.all(y3.map(async (n6) => {
         const o6 = await m3(n6.event || i5), u4 = Ue2(r6, "unknown");
@@ -7464,7 +7464,7 @@ function Gt(e4, t4, n5) {
   if (!o4 || !r6) throw new Error("Event name is invalid");
   const { timestamp: s4 = Date.now(), name: a4 = `${o4} ${r6}`, data: i5 = {}, context: c2 = {}, globals: u2 = e4.globals, custom: d2 = {}, user: l3 = e4.user, nested: f3 = [], consent: p3 = e4.consent, id: g3 = Ne(), trigger: m3 = "", entity: h2 = o4, action: v3 = r6, timing: y3 = 0, source: w3 = { type: "collector", schema: "4" } } = t4, b3 = w3.count ?? (e4.count += 1), k3 = w3.trace ?? n5?._meta.trace ?? e4.trace, I2 = { ...w3, count: b3 };
   void 0 !== k3 && (I2.trace = k3);
-  const C3 = e4.name ?? w3.platform ?? "default", E3 = e4.release ?? "4.3.0-next-1784120651691";
+  const C3 = e4.name ?? w3.platform ?? "default", E3 = e4.release ?? "4.3.0";
   return I2.release = { ...w3.release, [C3]: E3 }, { name: a4, data: i5, context: c2, globals: u2, custom: d2, user: l3, nested: f3, consent: p3, id: g3, trigger: m3, entity: h2, action: v3, timestamp: s4, timing: y3, source: I2 };
 }
 function Wt(e4, t4, n5) {
@@ -7494,7 +7494,7 @@ function en2(e4, t4) {
     }
     if (u2?.length && e4.transformers && Object.keys(e4.transformers).length > 0) {
       const n7 = await Be2(e4, e4.transformers, u2, p3, m3, f3, s4 ? `source.${s4}.next` : void 0);
-      if (null === n7.event) return Ot2({ ok: true });
+      if (null === n7.event) return e4.logger.debug("Event dropped by transformer chain" + (n7.droppedBy ? ` (${n7.droppedBy})` : "")), Ot2({ ok: true, dropped: true });
       if (n7.stopped) return n7.respond && (f3 = n7.respond), Ot2({ ok: true });
       if (n7.respond && (f3 = n7.respond), Array.isArray(n7.event)) {
         const o5 = await Promise.all(n7.event.map(async (n8) => {
@@ -10225,11 +10225,14 @@ function createPoller(config, logger) {
 init_dist();
 import http from "http";
 var PREVIEW_LOG = "[walkerOS:preview]";
-function answerPreviewPreflight(res) {
+function answerPreviewPreflight(req, res) {
+  const requested = req.headers["access-control-request-headers"];
+  const requestedHeaders = Array.isArray(requested) ? requested.join(", ") : requested;
   res.writeHead(204, {
     "Access-Control-Allow-Origin": "*",
     "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
-    "Access-Control-Allow-Headers": "Content-Type, X-Walkeros-Preview"
+    "Access-Control-Allow-Headers": requestedHeaders || "Content-Type, X-Walkeros-Preview",
+    Vary: "Access-Control-Request-Headers"
   });
   res.end();
 }
@@ -10319,7 +10322,7 @@ function createHealthServer(port, logger, previewGate) {
       };
       if (previewGate) {
         if (req.method === "OPTIONS") {
-          answerPreviewPreflight(res);
+          answerPreviewPreflight(req, res);
           return;
         }
         guardPreviewIntake(req, res, previewGate, logger, delegate);
@@ -11618,11 +11621,14 @@ init_config();
 import chalk3 from "chalk";
 
 // src/commands/validate/validators/contract.ts
+init_dist();
 var SECTION_KEYS = ["globals", "context", "custom", "user", "consent"];
 var KNOWN_KEYS = /* @__PURE__ */ new Set([
   "extend",
+  "tagging",
   "description",
   "events",
+  "schema",
   ...SECTION_KEYS
 ]);
 function validateContract(input) {
@@ -11640,7 +11646,19 @@ function validateContract(input) {
   const contracts = input;
   const contractNames = Object.keys(contracts);
   details.contractCount = contractNames.length;
+  for (const name of contractNames) {
+    if (name.startsWith("$")) {
+      errors.push({
+        path: name,
+        message: `"${name}" is not a named contract entry. This looks like the flat shape; use named ContractRule entries, lift $tagging to the rule field "tagging", and nest entity-action schemas under "events".`,
+        code: "FLAT_CONTRACT_SHAPE"
+      });
+    }
+  }
   for (const [name, entry] of Object.entries(contracts)) {
+    if (name.startsWith("$")) {
+      continue;
+    }
     if (typeof entry !== "object" || entry === null) {
       errors.push({
         path: name,
@@ -11650,6 +11668,39 @@ function validateContract(input) {
       continue;
     }
     const obj = entry;
+    const keys = Object.keys(obj);
+    const unknownKeys = keys.filter((k3) => !KNOWN_KEYS.has(k3));
+    const hasKnownKey = keys.some((k3) => KNOWN_KEYS.has(k3));
+    const objectValuedUnknown = unknownKeys.filter((k3) => de(obj[k3]));
+    if (!hasKnownKey && objectValuedUnknown.length > 0) {
+      errors.push({
+        path: name,
+        message: `Contract "${name}" looks like a flat entity-action map. Nest entity-action schemas under an "events" key of a named ContractRule.`,
+        code: "FLAT_CONTRACT_SHAPE"
+      });
+      continue;
+    }
+    for (const key of unknownKeys) {
+      warnings.push({
+        path: `${name}.${key}`,
+        message: `Unknown contract key "${key}" is ignored`,
+        code: "UNKNOWN_CONTRACT_KEY"
+      });
+    }
+    if (obj.tagging !== void 0 && typeof obj.tagging !== "number") {
+      errors.push({
+        path: `${name}.tagging`,
+        message: "tagging must be a number",
+        code: "INVALID_TAGGING"
+      });
+    }
+    if (obj.schema !== void 0 && !de(obj.schema)) {
+      errors.push({
+        path: `${name}.schema`,
+        message: "schema must be a JSON Schema object",
+        code: "INVALID_SCHEMA"
+      });
+    }
     if (obj.extend !== void 0) {
       if (typeof obj.extend !== "string") {
         errors.push({
@@ -13401,7 +13452,7 @@ function validateMapping(input) {
 // src/commands/validate/validators/entry.ts
 init_dist();
 import Ajv from "ajv";
-var CLIENT_HEADER = "walkeros-cli/4.3.0-next-1784120651691";
+var CLIENT_HEADER = "walkeros-cli/4.3.0";
 var SECTIONS = ["destinations", "sources", "transformers"];
 function resolveEntry(path19, flowConfig) {
   const flows = flowConfig.flows;

package/dist/index.d.ts

@@ -665,6 +665,7 @@ interface ValidationWarning {
     path: string;
     message: string;
     suggestion?: string;
+    code?: string;
 }
 interface ValidateResult {
     valid: boolean;

package/dist/index.js

@@ -6409,11 +6409,14 @@ function createPoller(config, logger) {
 import http from "http";
 import { verifyActivation } from "@walkeros/core";
 var PREVIEW_LOG = "[walkerOS:preview]";
-function answerPreviewPreflight(res) {
+function answerPreviewPreflight(req, res) {
+  const requested = req.headers["access-control-request-headers"];
+  const requestedHeaders = Array.isArray(requested) ? requested.join(", ") : requested;
   res.writeHead(204, {
     "Access-Control-Allow-Origin": "*",
     "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
-    "Access-Control-Allow-Headers": "Content-Type, X-Walkeros-Preview"
+    "Access-Control-Allow-Headers": requestedHeaders || "Content-Type, X-Walkeros-Preview",
+    Vary: "Access-Control-Request-Headers"
   });
   res.end();
 }
@@ -6503,7 +6506,7 @@ function createHealthServer(port, logger, previewGate) {
       };
       if (previewGate) {
         if (req.method === "OPTIONS") {
-          answerPreviewPreflight(res);
+          answerPreviewPreflight(req, res);
           return;
         }
         guardPreviewIntake(req, res, previewGate, logger, delegate);
@@ -7574,11 +7577,14 @@ init_config();
 import chalk2 from "chalk";
 
 // src/commands/validate/validators/contract.ts
+import { isObject as isObject4 } from "@walkeros/core";
 var SECTION_KEYS = ["globals", "context", "custom", "user", "consent"];
 var KNOWN_KEYS = /* @__PURE__ */ new Set([
   "extend",
+  "tagging",
   "description",
   "events",
+  "schema",
   ...SECTION_KEYS
 ]);
 function validateContract(input) {
@@ -7596,7 +7602,19 @@ function validateContract(input) {
   const contracts = input;
   const contractNames = Object.keys(contracts);
   details.contractCount = contractNames.length;
+  for (const name of contractNames) {
+    if (name.startsWith("$")) {
+      errors.push({
+        path: name,
+        message: `"${name}" is not a named contract entry. This looks like the flat shape; use named ContractRule entries, lift $tagging to the rule field "tagging", and nest entity-action schemas under "events".`,
+        code: "FLAT_CONTRACT_SHAPE"
+      });
+    }
+  }
   for (const [name, entry] of Object.entries(contracts)) {
+    if (name.startsWith("$")) {
+      continue;
+    }
     if (typeof entry !== "object" || entry === null) {
       errors.push({
         path: name,
@@ -7606,6 +7624,39 @@ function validateContract(input) {
       continue;
     }
     const obj = entry;
+    const keys = Object.keys(obj);
+    const unknownKeys = keys.filter((k) => !KNOWN_KEYS.has(k));
+    const hasKnownKey = keys.some((k) => KNOWN_KEYS.has(k));
+    const objectValuedUnknown = unknownKeys.filter((k) => isObject4(obj[k]));
+    if (!hasKnownKey && objectValuedUnknown.length > 0) {
+      errors.push({
+        path: name,
+        message: `Contract "${name}" looks like a flat entity-action map. Nest entity-action schemas under an "events" key of a named ContractRule.`,
+        code: "FLAT_CONTRACT_SHAPE"
+      });
+      continue;
+    }
+    for (const key of unknownKeys) {
+      warnings.push({
+        path: `${name}.${key}`,
+        message: `Unknown contract key "${key}" is ignored`,
+        code: "UNKNOWN_CONTRACT_KEY"
+      });
+    }
+    if (obj.tagging !== void 0 && typeof obj.tagging !== "number") {
+      errors.push({
+        path: `${name}.tagging`,
+        message: "tagging must be a number",
+        code: "INVALID_TAGGING"
+      });
+    }
+    if (obj.schema !== void 0 && !isObject4(obj.schema)) {
+      errors.push({
+        path: `${name}.schema`,
+        message: "schema must be a JSON Schema object",
+        code: "INVALID_SCHEMA"
+      });
+    }
     if (obj.extend !== void 0) {
       if (typeof obj.extend !== "string") {
         errors.push({
@@ -7733,7 +7784,7 @@ function validateEvent2(input) {
 // src/commands/validate/validators/flow.ts
 import {
   getFlowSettings as getFlowSettings2,
-  isObject as isObject4,
+  isObject as isObject5,
   resolveContracts,
   validateStepEntry as validateStepEntry2
 } from "@walkeros/core";
@@ -7741,9 +7792,9 @@ import { schemas as schemas4 } from "@walkeros/core/dev";
 import { validateEventAgainstContract } from "@walkeros/transformer-validate";
 var { validateFlowConfig: validateFlowConfig2 } = schemas4;
 function isFlowJson(value) {
-  if (!isObject4(value)) return false;
+  if (!isObject5(value)) return false;
   if (!("version" in value) || !("flows" in value)) return false;
-  return isObject4(value.flows);
+  return isObject5(value.flows);
 }
 function validateFlow(input, options = {}) {
   const errors = [];
@@ -7774,9 +7825,9 @@ function validateFlow(input, options = {}) {
       message: issue.message
     });
   }
-  const config = isObject4(input) ? input : {};
+  const config = isObject5(input) ? input : {};
   const flowsValue = config.flows;
-  const flows = isObject4(flowsValue) ? flowsValue : void 0;
+  const flows = isObject5(flowsValue) ? flowsValue : void 0;
   if (flows && Object.keys(flows).length === 0) {
     errors.push({
       path: "flows",
@@ -7786,13 +7837,13 @@ function validateFlow(input, options = {}) {
   }
   if (flows) {
     for (const [flowName, flowValue] of Object.entries(flows)) {
-      if (!isObject4(flowValue)) continue;
+      if (!isObject5(flowValue)) continue;
       const transformersValue = flowValue.transformers;
-      if (!isObject4(transformersValue)) continue;
+      if (!isObject5(transformersValue)) continue;
       for (const [name, transformerValue] of Object.entries(
         transformersValue
       )) {
-        if (!isObject4(transformerValue)) continue;
+        if (!isObject5(transformerValue)) continue;
         const result = validateStepEntry2(transformerValue, "Transformer");
         if (!result.ok) {
           errors.push({
@@ -7823,15 +7874,15 @@ function validateFlow(input, options = {}) {
   let totalPackageCount = 0;
   if (flows) {
     for (const [flowName, flowValue] of Object.entries(flows)) {
-      if (!isObject4(flowValue)) continue;
+      if (!isObject5(flowValue)) continue;
       const flowConfig = flowValue.config;
-      if (!isObject4(flowConfig)) continue;
+      if (!isObject5(flowConfig)) continue;
       const bundle2 = flowConfig.bundle;
-      if (!isObject4(bundle2)) continue;
+      if (!isObject5(bundle2)) continue;
       const packages = bundle2.packages;
-      if (!isObject4(packages)) continue;
+      if (!isObject5(packages)) continue;
       for (const [pkgName, pkgConfigValue] of Object.entries(packages)) {
-        if (!isObject4(pkgConfigValue)) continue;
+        if (!isObject5(pkgConfigValue)) continue;
         if (!pkgConfigValue.version && !pkgConfigValue.path) {
           warnings.push({
             path: `flows.${flowName}.config.bundle.packages.${pkgName}`,
@@ -7880,9 +7931,9 @@ function validateFlow(input, options = {}) {
       for (const [destName, dest] of Object.entries(
         flowSettings.destinations || {}
       )) {
-        if (!isObject4(dest.config)) continue;
+        if (!isObject5(dest.config)) continue;
         const mapping = dest.config.mapping;
-        if (!isObject4(mapping)) continue;
+        if (!isObject5(mapping)) continue;
         for (const key of Object.keys(mapping)) {
           if (key.includes(".") && !key.includes(" ")) {
             const parts = key.split(".");
@@ -8164,7 +8215,7 @@ function checkContractCompliance(config, contract, errors, warnings, strict) {
   const rules = Object.values(resolved);
   if (rules.length === 0) return;
   const checkExample = (path20, candidate) => {
-    if (!isObject4(candidate)) return;
+    if (!isObject5(candidate)) return;
     const entity = typeof candidate.entity === "string" ? candidate.entity : void 0;
     const action = typeof candidate.action === "string" ? candidate.action : void 0;
     if (!entity || !action) return;
@@ -8254,7 +8305,7 @@ function validateMapping(input) {
 // src/commands/validate/validators/entry.ts
 import Ajv from "ajv";
 import { fetchPackageSchema } from "@walkeros/core";
-var CLIENT_HEADER = "walkeros-cli/4.3.0-next-1784120651691";
+var CLIENT_HEADER = "walkeros-cli/4.3.0";
 var SECTIONS = ["destinations", "sources", "transformers"];
 function resolveEntry(path20, flowConfig) {
   const flows = flowConfig.flows;
@@ -9974,7 +10025,7 @@ init_config_classifier();
 
 // src/commands/bundle/validate-structure.ts
 init_structural_validators();
-import { isObject as isObject5, validateStepEntry as validateStepEntry3 } from "@walkeros/core";
+import { isObject as isObject6, validateStepEntry as validateStepEntry3 } from "@walkeros/core";
 var STEP_SECTIONS = [
   "sources",
   "destinations",
@@ -10001,7 +10052,7 @@ function getSection(flow, section) {
 }
 function hasCodeReference3(code) {
   if (typeof code === "string") return true;
-  return isObject5(code) && "push" in code;
+  return isObject6(code) && "push" in code;
 }
 function messageOf(error) {
   return error instanceof Error ? error.message : String(error);
@@ -10010,10 +10061,10 @@ function validateFlowStructure(flowConfig) {
   const errors = [];
   const details = {};
   const flows = flowConfig.flows;
-  const flowNames = isObject5(flows) ? Object.keys(flows) : [];
+  const flowNames = isObject6(flows) ? Object.keys(flows) : [];
   details.flowNames = flowNames;
   details.flowCount = flowNames.length;
-  if (!isObject5(flows) || flowNames.length === 0) {
+  if (!isObject6(flows) || flowNames.length === 0) {
     errors.push({
       path: "flows",
       message: "At least one flow is required",