@revturbine/cli 0.14.0 → 0.16.0

package/dist/cli.js

@@ -9554,10 +9554,106 @@ function renderHandlesModule(byType, opts) {
   );
   return lines.join("\n");
 }
+function collectStrings(values) {
+  const out = /* @__PURE__ */ new Set();
+  for (const value of values) {
+    const s = nonEmptyString(value);
+    if (s) out.add(s);
+  }
+  return [...out].sort();
+}
+function extractPlanHandles(config) {
+  if (!isRecord4(config) || !Array.isArray(config.plans)) return [];
+  return collectStrings(
+    config.plans.map(
+      (p) => isRecord4(p) ? nonEmptyString(p.unique_handle) ?? nonEmptyString(p.handle) ?? p.id : null
+    )
+  );
+}
+function extractSegmentHandles(config) {
+  if (!isRecord4(config) || !Array.isArray(config.segments)) return [];
+  return collectStrings(
+    config.segments.map((s) => isRecord4(s) ? nonEmptyString(s.handle) ?? s.id : null)
+  );
+}
+function extractSurfaceTemplateIds(config) {
+  if (!isRecord4(config)) return [];
+  const ids = [];
+  if (Array.isArray(config.surface_templates)) {
+    for (const t of config.surface_templates) {
+      if (isRecord4(t)) ids.push(t.id ?? t.template_id);
+    }
+  }
+  const surfacesOf = (payload) => {
+    if (!isRecord4(payload) || !Array.isArray(payload.surfaces)) return;
+    for (const surface of payload.surfaces) {
+      if (isRecord4(surface)) ids.push(surface.template_id);
+    }
+  };
+  if (Array.isArray(config.placements)) {
+    for (const placement of config.placements) {
+      if (!isRecord4(placement) || !Array.isArray(placement.payloads)) continue;
+      for (const payload of placement.payloads) surfacesOf(payload);
+    }
+  }
+  if (Array.isArray(config.placement_payloads)) {
+    for (const payload of config.placement_payloads) surfacesOf(payload);
+  }
+  return collectStrings(ids);
+}
+function extractUiPathActionTypes(config) {
+  if (!isRecord4(config) || !Array.isArray(config.content_ui_paths)) return [];
+  return collectStrings(
+    config.content_ui_paths.map((p) => isRecord4(p) ? p.action_type : null)
+  );
+}
+function renderFlatFamily(lines, opts) {
+  lines.push("", `/** ${opts.doc} */`);
+  if (opts.values.length === 0) {
+    lines.push(`export const ${opts.constName} = {} as const;`);
+    lines.push(`export type ${opts.typeName} = never;`);
+    return;
+  }
+  lines.push(`export const ${opts.constName} = {`);
+  for (const value of opts.values) {
+    lines.push(`  ${key(value)}: ${quote(value)},`);
+  }
+  lines.push("} as const;");
+  lines.push(`export type ${opts.typeName} =`);
+  opts.values.forEach((value, i) => {
+    lines.push(`  | ${quote(value)}${i === opts.values.length - 1 ? ";" : ""}`);
+  });
+}
 function generateHandleTypes(config, opts) {
   const byType = extractEntitlementHandles(config);
   const handles = [...new Set(Object.values(byType).flat())].sort();
-  return { byType, handles, ts: renderHandlesModule(byType, opts) };
+  const lines = [renderHandlesModule(byType, opts).trimEnd()];
+  renderFlatFamily(lines, {
+    doc: "Plan handles \u2014 the values plan targeting and planHandle options take.",
+    constName: "Plans",
+    typeName: "PlanHandle",
+    values: extractPlanHandles(config)
+  });
+  renderFlatFamily(lines, {
+    doc: "Segment handles.",
+    constName: "Segments",
+    typeName: "SegmentHandle",
+    values: extractSegmentHandles(config)
+  });
+  renderFlatFamily(lines, {
+    doc: "Surface-template ids \u2014 catalog entries plus every template a payload references.",
+    constName: "SurfaceTemplates",
+    typeName: "SurfaceTemplateId",
+    values: extractSurfaceTemplateIds(config)
+  });
+  renderFlatFamily(lines, {
+    doc: "Authored ui-path action types \u2014 exactly the key set uiPathResolvers must cover.",
+    constName: "UiPathActionTypes",
+    typeName: "UiPathActionType",
+    values: extractUiPathActionTypes(config)
+  });
+  lines.push("");
+  return { byType, handles, ts: lines.join("\n") };
 }
 
 // src/lib/output.ts
@@ -9609,6 +9705,36 @@ function fail(cls, message) {
   process.exit(cls);
 }
 
+// src/lib/pin-drift.ts
+function isRecord5(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function pinOf(pkg, name) {
+  for (const field of ["devDependencies", "dependencies"]) {
+    const deps = pkg[field];
+    if (isRecord5(deps) && typeof deps[name] === "string") return deps[name];
+  }
+  return void 0;
+}
+var EXACT = /^\d+\.\d+\.\d+(-[0-9A-Za-z.-]+)?$/;
+function checkPinDrift(pkg) {
+  if (!isRecord5(pkg)) return [];
+  const warnings = [];
+  const cliPin = pinOf(pkg, "@revturbine/cli");
+  if (cliPin !== void 0 && !EXACT.test(cliPin)) {
+    warnings.push(
+      `@revturbine/cli is pinned "${cliPin}" \u2014 the repo-pinned CLI must be EXACT (e.g. "0.14.0"): delegation runs the repo's version, and a range makes the running CLI drift from the committed one.`
+    );
+  }
+  const sdkPin = pinOf(pkg, "@revturbine/sdk");
+  if (sdkPin !== void 0 && !sdkPin.startsWith("^")) {
+    warnings.push(
+      `@revturbine/sdk is pinned "${sdkPin}" \u2014 use a caret (e.g. "^${sdkPin.replace(/^[~>=\s]*/, "")}") so additive SDK releases flow in. (Note: on 0.x, ^ spans PATCH releases only.)`
+    );
+  }
+  return warnings;
+}
+
 // src/lib/selectors.ts
 var SelectorError = class extends Error {
   code = "STATE_REQUIRED";
@@ -10531,7 +10657,7 @@ program.command("evaluate").description("Run placement/entitlement decisions for
 );
 var generateCmd = program.command("generate").description("Code generation from a config version (see: generate types).");
 generateCmd.command("types").description(
-  "Generate a TypeScript module of entitlement handles (namespaced by entitlement type) for type-safe can()/gate() calls."
+  "Generate a TypeScript module of Playbook handles \u2014 entitlements (namespaced by type), plans, segments, surface-template ids, and ui-path action types \u2014 for type-safe call sites."
 ).argument("[file...]", "Path to a Config File").option("--draft", "The tenant's open draft").option("--live", "The current live Release").option("--release <id>", "A specific playbook version / Release").option("-o, --out <path>", "Write the generated module to this path (parent dirs created); default stdout").option("--json", "Emit the handle map as JSON instead of TypeScript").option("-u, --url <url>", "RevTurbine instance URL", DEFAULT_URL).option("-t, --tenant-id <id>", "x-tenant-id (defaults to the stored token tenant)").action(
   async (files, opts) => {
     const [sel] = requireSelectors(opts, files, {
@@ -10700,6 +10826,20 @@ function gitRootOf(from) {
     process.exit(child.status ?? EXIT.UNEXPECTED);
   }
 }
+if (process.argv.includes("-V") || process.argv.includes("--version")) {
+  process.stdout.write(`${pkgVersion} (schema ${SCHEMA_VERSION})
+`);
+  try {
+    const pkgPath = path2.resolve("package.json");
+    if (existsSync2(pkgPath)) {
+      for (const warning of checkPinDrift(JSON.parse(readFileSync2(pkgPath, "utf8")))) {
+        diag(`\u26A0 pin drift: ${warning}`);
+      }
+    }
+  } catch {
+  }
+  process.exit(EXIT.OK);
+}
 program.exitOverride();
 try {
   await program.parseAsync(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revturbine/cli",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "revturbine — verify RevTurbine ExportedConfig files and ship them to a RevTurbine instance through the Change Set lifecycle.",
   "license": "MIT",
   "repository": {