primitive-admin 1.0.49 → 1.0.50

package/dist/src/validators.js

@@ -0,0 +1,63 @@
+/**
+ * Public subpath export: `primitive-admin/validators` (issue #983).
+ *
+ * Re-exports the TOML validators that `sync push` runs as its load-bearing
+ * gate, so external tooling (e.g. `primitive-docs`) can validate the exact
+ * same way the published CLI does — instead of re-implementing the parse /
+ * expand / validate flow against submodule source and silently drifting.
+ *
+ * Two kinds of entry points are exported:
+ *
+ *  1. `validateWorkflowTomlSource(raw, filePath)` — the **source-level**
+ *     wrapper. Runs the identical parse → fragment-expand → validate → format
+ *     path that `sync push` runs for workflow TOML (`cli/src/commands/sync.ts`:
+ *     `parseTomlFile()` → `validateWorkflowToml()` → `formatWorkflowTomlErrors()`).
+ *     Use this when you have the raw TOML string and want zero divergence from
+ *     `sync push`, including `include` fragment expansion.
+ *
+ *  2. The raw validators (`validateWorkflowToml`, `validateOperations`) and
+ *     their formatters (`formatWorkflowTomlErrors`, `formatIssue`). These are
+ *     **pure functions over already-parsed TOML** — they do not read files or
+ *     parse TOML themselves. The consumer is responsible for parsing (e.g. with
+ *     `@iarna/toml`) and, for workflows, for any `include` expansion. There is
+ *     no coupling on a specific TOML parser version; pass whatever parsed
+ *     object/operations[] you already have.
+ *
+ * Internal helpers (`collectParamRefs`, `declaredParamNames`,
+ * `locateOperationLine`) are intentionally NOT exported — they are
+ * implementation details of `validateOperations`.
+ */
+import * as TOML from "@iarna/toml";
+import { validateWorkflowToml, formatWorkflowTomlErrors, } from "./lib/workflow-toml-validator.js";
+import { expandWorkflowTomlData } from "./lib/workflow-fragments.js";
+export { validateWorkflowToml, formatWorkflowTomlErrors, } from "./lib/workflow-toml-validator.js";
+export { validateOperations, formatIssue, } from "./lib/toml-params-validator.js";
+/**
+ * Validate a workflow TOML **source string** the exact way `sync push` does.
+ *
+ * Runs the identical pipeline `sync push` runs on every workflow file:
+ *   `TOML.parse(raw)` → `expandWorkflowTomlData(parsed, filePath)`
+ *   → `validateWorkflowToml(expanded)` → `formatWorkflowTomlErrors(...)`.
+ *
+ * The `include` fragment expansion resolves fragments relative to
+ * `<filePath>/../../workflow-fragments/` — pass the real (or intended) on-disk
+ * path of the workflow so fragment resolution matches `sync push`. If the
+ * source uses no `include` key the expander is a no-op and `filePath` is only
+ * used for error attribution.
+ *
+ * @param raw The raw workflow TOML source string.
+ * @param filePath The workflow's file path (used for fragment resolution and
+ *   error attribution).
+ * @returns `{ errors, formatted }` — `errors` is empty and `formatted` is
+ *   `null` when the source is valid.
+ */
+export function validateWorkflowTomlSource(raw, filePath) {
+    const parsed = TOML.parse(raw);
+    const expanded = expandWorkflowTomlData(parsed, filePath);
+    const errors = validateWorkflowToml(expanded);
+    return {
+        errors,
+        formatted: errors.length > 0 ? formatWorkflowTomlErrors(filePath, errors) : null,
+    };
+}
+//# sourceMappingURL=validators.js.map

package/dist/src/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GAEzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GAEzB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,kBAAkB,EAClB,WAAW,GAIZ,MAAM,gCAAgC,CAAC;AAexC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,0BAA0B,CACxC,GAAW,EACX,QAAgB;IAEhB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwB,CAAC;IACtD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO;QACL,MAAM;QACN,SAAS,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;KACjF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,11 +1,17 @@
 {
   "name": "primitive-admin",
-  "version": "1.0.49",
+  "version": "1.0.50",
   "description": "CLI for administering Primitive applications",
   "type": "module",
   "bin": {
     "primitive": "dist/bin/primitive.js"
   },
+  "exports": {
+    "./validators": {
+      "types": "./dist/src/validators.d.ts",
+      "import": "./dist/src/validators.js"
+    }
+  },
   "files": [
     "dist/",
     "assets/",