@zeroxyz/cli 1.3.0 → 1.5.0

package/dist/index.js

@@ -76582,7 +76582,7 @@ init_esm_shims();
 
 // package.json
 var package_default = {
-  version: "1.3.0"};
+  version: "1.5.0"};
 
 // src/app.ts
 init_esm_shims();
@@ -147012,12 +147012,27 @@ var coerceToType = (value, type2) => {
   }
   return value;
 };
-var sampleValueFor = (fieldName, propSchema) => {
+var sampleValueFor = (fieldName, propSchema, depth = 0) => {
   const node = asNode(propSchema);
   const type2 = schemaType(node);
-  const example = node?.example ?? node?.default;
-  if (example !== void 0 && example !== null) {
-    return coerceToType(example, type2);
+  const enumFirst = Array.isArray(node?.enum) && node.enum.length > 0 ? node.enum[0] : void 0;
+  const fixed = node?.const ?? node?.example ?? node?.default ?? enumFirst;
+  if (fixed !== void 0 && fixed !== null) {
+    return coerceToType(fixed, type2);
+  }
+  if (node && depth < MAX_SCHEMA_DEPTH) {
+    const props = asNode(node.properties);
+    if (props && (type2 === "object" || type2 === void 0)) {
+      const obj = {};
+      for (const [k3, sub] of Object.entries(props)) {
+        obj[k3] = sampleValueFor(k3, sub, depth + 1);
+      }
+      return obj;
+    }
+    if (type2 === "array") {
+      const items = asNode(node.items);
+      return items ? [sampleValueFor(fieldName, items, depth + 1)] : [];
+    }
   }
   switch (type2) {
     case "number":
@@ -147061,35 +147076,87 @@ var schemaTypeLabel = (node) => {
 };
 var constraintHint = (node) => {
   const num2 = (k3) => typeof node[k3] === "number" ? node[k3] : void 0;
+  const hints = [];
   const min = num2("minimum");
   const max = num2("maximum");
-  if (min !== void 0 && max !== void 0) return `range: ${min}..${max}`;
-  if (min !== void 0) return `min: ${min}`;
-  if (max !== void 0) return `max: ${max}`;
+  if (min !== void 0 && max !== void 0)
+    hints.push(`range: ${min}..${max}`);
+  else if (min !== void 0) hints.push(`min: ${min}`);
+  else if (max !== void 0) hints.push(`max: ${max}`);
+  const exMin = num2("exclusiveMinimum");
+  const exMax = num2("exclusiveMaximum");
+  if (exMin !== void 0) hints.push(`> ${exMin}`);
+  if (exMax !== void 0) hints.push(`< ${exMax}`);
   const minLen = num2("minLength");
   const maxLen = num2("maxLength");
   if (minLen !== void 0 && maxLen !== void 0)
-    return `length: ${minLen}..${maxLen}`;
-  if (maxLen !== void 0) return `maxLength: ${maxLen}`;
-  if (minLen !== void 0) return `minLength: ${minLen}`;
-  return null;
-};
-var renderParam = (name, propSchema, required3) => {
-  const node = asNode(propSchema) ?? {};
+    hints.push(`length: ${minLen}..${maxLen}`);
+  else if (maxLen !== void 0) hints.push(`maxLength: ${maxLen}`);
+  else if (minLen !== void 0) hints.push(`minLength: ${minLen}`);
+  const minItems = num2("minItems");
+  const maxItems = num2("maxItems");
+  if (minItems !== void 0 && maxItems !== void 0)
+    hints.push(`items: ${minItems}..${maxItems}`);
+  else if (maxItems !== void 0) hints.push(`maxItems: ${maxItems}`);
+  else if (minItems !== void 0) hints.push(`minItems: ${minItems}`);
+  if (typeof node.pattern === "string") hints.push(`pattern: ${node.pattern}`);
+  return hints.length > 0 ? hints.join(", ") : null;
+};
+var MAX_SCHEMA_DEPTH = 5;
+var paramAttrs = (node, required3) => {
   const attrs = [schemaTypeLabel(node)];
   if (required3) attrs.push("required");
+  if (node.const !== void 0)
+    attrs.push(`const: ${JSON.stringify(node.const)}`);
   if (node.default !== void 0)
     attrs.push(`default: ${JSON.stringify(node.default)}`);
   if (Array.isArray(node.enum))
     attrs.push(`one of: ${node.enum.map((v) => String(v)).join(" | ")}`);
+  if (typeof node.format === "string") attrs.push(`format: ${node.format}`);
   const hint = constraintHint(node);
   if (hint) attrs.push(hint);
-  const lines = [`    ${name} (${attrs.join(", ")})`];
+  return attrs.join(", ");
+};
+var renderParam = (name, propSchema, required3, depth = 0) => {
+  const node = asNode(propSchema) ?? {};
+  const pad9 = `    ${"  ".repeat(depth)}`;
+  const lines = [`${pad9}${name} (${paramAttrs(node, required3)})`];
   const desc = typeof node.description === "string" ? node.description.trim() : "";
-  if (desc) lines.push(`      ${desc}`);
+  if (desc) lines.push(`${pad9}  ${desc}`);
+  if (depth >= MAX_SCHEMA_DEPTH) return lines;
+  if (asNode(node.properties)) {
+    lines.push(...renderProps(node, depth + 1));
+  }
+  const items = asNode(node.items);
+  if (items) {
+    if (asNode(items.properties)) {
+      lines.push(`${pad9}  each item (${schemaTypeLabel(items)}):`);
+      lines.push(...renderProps(items, depth + 2));
+    } else {
+      lines.push(`${pad9}  each item (${paramAttrs(items, false)})`);
+    }
+  }
+  const variants = Array.isArray(node.oneOf) ? node.oneOf : Array.isArray(node.anyOf) ? node.anyOf : null;
+  if (variants && variants.length > 0) {
+    lines.push(`${pad9}  one of these shapes:`);
+    variants.forEach((v, i) => {
+      lines.push(...renderParam(`option ${i + 1}`, v, false, depth + 2));
+    });
+  }
+  if (Array.isArray(node.allOf) && node.allOf.length > 0) {
+    lines.push(`${pad9}  must satisfy all of:`);
+    node.allOf.forEach((v, i) => {
+      lines.push(...renderParam(`part ${i + 1}`, v, false, depth + 2));
+    });
+  }
+  if (typeof node.$ref === "string") {
+    lines.push(
+      `${pad9}  \u26A0 schema reference not inlined (${node.$ref}) \u2014 shape incomplete, see provider docs`
+    );
+  }
   return lines;
 };
-var renderProps = (node) => {
+var renderProps = (node, depth = 0) => {
   const props = node ? asNode(node.properties) : null;
   if (!props) return [];
   const entries = Object.entries(props);
@@ -147098,7 +147165,7 @@ var renderProps = (node) => {
     Array.isArray(node?.required) ? node.required.filter((x2) => typeof x2 === "string") : []
   );
   return entries.flatMap(
-    ([name, schema]) => renderParam(name, schema, requiredSet.has(name))
+    ([name, schema]) => renderParam(name, schema, requiredSet.has(name), depth)
   );
 };
 var buildSchemaSection = (capability) => {
@@ -147106,7 +147173,17 @@ var buildSchemaSection = (capability) => {
     capability.bodySchema,
     capability.method
   );
-  return [...renderProps(queryParams), ...renderProps(body)];
+  const lines = [...renderProps(queryParams), ...renderProps(body)];
+  if (lines.length === 0) {
+    const root = asNode(capability.bodySchema);
+    const unresolved = (n) => !!n && (n.$ref !== void 0 || Array.isArray(n.allOf));
+    if (unresolved(root ?? void 0) || unresolved(queryParams) || unresolved(body)) {
+      return [
+        "  \u26A0 input schema could not be expanded ($ref/allOf not inlined) \u2014 use the verified example below or the provider's docs"
+      ];
+    }
+  }
+  return lines;
 };
 var buildResponseSection = (capability) => {
   const rs = asNode(capability.responseSchema);
@@ -147126,6 +147203,13 @@ var buildResponseSection = (capability) => {
   }
   return [];
 };
+var buildVerifiedExampleSection = (capability) => {
+  const req = capability.example?.request;
+  if (req === void 0 || req === null) return [];
+  const json3 = typeof req === "string" ? req : JSON.stringify(req);
+  const truncated = json3.length > 600 ? `${json3.slice(0, 600)}\u2026` : json3;
+  return ["", "Verified example (request):", `  ${truncated}`];
+};
 var buildTryItExample = (capability) => {
   const method = capability.method.toUpperCase();
   const lines = ["", "Try it:"];
@@ -147199,6 +147283,7 @@ var formatCapability = (capability) => {
     lines.push("", "Parameters:");
     lines.push(...schemaLines);
   }
+  lines.push(...buildVerifiedExampleSection(capability));
   lines.push(...buildResponseSection(capability));
   lines.push(...buildTryItExample(capability));
   return lines.join("\n");

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zeroxyz/cli",
-	"version": "1.3.0",
+	"version": "1.5.0",
 	"type": "module",
 	"bin": {
 		"zero": "dist/index.js",