@pagefront/lint-commerce 0.8.0 → 0.10.0

package/dist/sheet-type.d.ts

@@ -15,4 +15,21 @@ import type { Sheet } from "@pagefront/lint-core";
  * page type the catalogue predates dispatch with.
  */
 export type SheetType = "product" | "organization";
+/**
+ * The two lines a sheet can belong to. A sheet on the *release* line
+ * carries `release` and validates against the current sheet-spec
+ * schemas; a sheet on the *legacy* draft line carries `format_version`
+ * (≤ 0.9) and validates against the frozen legacy schemas.
+ */
+export type SheetLine = "release" | "legacy";
+/**
+ * Line detection reads the envelope field first: `release` puts a sheet
+ * on the release line (also when `format_version` is present beside it,
+ * which the release-line schemas and PDP-E-016 / ORG-E-002 reject), and
+ * `format_version` alone puts it on the legacy line. A sheet carrying
+ * neither is placed by its `$schema`: a two-part version segment, or
+ * the pre-2026-09-08 `/schemas/` path, is legacy; anything else is the
+ * release line, whose schema then reports the missing `release`.
+ */
+export declare function detectSheetLine(sheet: Sheet): SheetLine;
 export declare function detectSheetType(sheet: Sheet): SheetType;

package/dist/sheet-type.js

@@ -1,3 +1,28 @@
+/** The legacy line's `$schema` version segment: two parts, `v0.9.json`. */
+const LEGACY_SCHEMA_SEGMENT = /\/v\d+\.\d+\.json$/;
+/**
+ * Line detection reads the envelope field first: `release` puts a sheet
+ * on the release line (also when `format_version` is present beside it,
+ * which the release-line schemas and PDP-E-016 / ORG-E-002 reject), and
+ * `format_version` alone puts it on the legacy line. A sheet carrying
+ * neither is placed by its `$schema`: a two-part version segment, or
+ * the pre-2026-09-08 `/schemas/` path, is legacy; anything else is the
+ * release line, whose schema then reports the missing `release`.
+ */
+export function detectSheetLine(sheet) {
+    if (sheet.release !== undefined)
+        return "release";
+    if (sheet.format_version !== undefined)
+        return "legacy";
+    const schema = sheet.$schema;
+    if (typeof schema === "string") {
+        if (LEGACY_SCHEMA_SEGMENT.test(schema))
+            return "legacy";
+        if (schema.includes("/schemas/organization/") || schema.includes("/schemas/product/"))
+            return "legacy";
+    }
+    return "release";
+}
 const ORG_DATA_TYPES = new Set(["Organization", "OnlineStore", "OnlineBusiness"]);
 export function detectSheetType(sheet) {
     const schema = sheet.$schema;

package/dist/validate-and-lint.d.ts

@@ -5,6 +5,9 @@
  * boundary: callers see `SchemaError`, never Ajv's own error type.
  */
 import type { LintOptions, Report } from "@pagefront/lint-core";
+import type { SheetLine, SheetType } from "./sheet-type.js";
+/** The Layer 1 validator for a sheet type on a line. */
+export declare function validatorFor(sheetType: SheetType, line: SheetLine): import("ajv").ValidateFunction<unknown>;
 /**
  * One Layer 1 (JSON Schema) validation failure, in a shape this
  * package owns. `instancePath` is a JSON Pointer to the offending
@@ -31,11 +34,12 @@ export type ValidateAndLintResult = {
  * catalogue; Layer 1 success is also what makes the internal cast to
  * `Sheet` sound (the schema requires the envelope fields).
  *
- * The bundled schemas are the current catalogue's format version. A
- * document declaring some other `format_version` failing Layer 1 is
- * the intended behavior, not a gap: this package lints exactly one
- * format version, and there is no separate "unsupported version"
- * outcome.
+ * Two lines are validated (see sheet-type.ts): a sheet carrying
+ * `release` validates against the current sheet-spec schema for its
+ * type, and a legacy sheet carrying `format_version` validates against
+ * the frozen legacy schema (format 0.9). A legacy sheet declaring some
+ * other `format_version` failing Layer 1 is the intended behavior:
+ * there is no separate "unsupported version" outcome.
  *
  * Dispatches by page type (see sheet-type.ts): product sheets validate
  * against the product schema and lint with the product catalogue;

package/dist/validate-and-lint.js

@@ -1,6 +1,13 @@
 import { lintSheet } from "./lint-sheet.js";
-import { detectSheetType } from "./sheet-type.js";
-import { validateProduct, validateOrganization } from "./schema-validators.js";
+import { detectSheetLine, detectSheetType } from "./sheet-type.js";
+import { validateProduct, validateOrganization, validateLegacyProduct, validateLegacyOrganization, } from "./schema-validators.js";
+/** The Layer 1 validator for a sheet type on a line. */
+export function validatorFor(sheetType, line) {
+    if (line === "legacy") {
+        return sheetType === "organization" ? validateLegacyOrganization : validateLegacyProduct;
+    }
+    return sheetType === "organization" ? validateOrganization : validateProduct;
+}
 // The validators are compiled ahead of time (see schema-validators.d.ts):
 // nothing here generates code at load time, so the pipeline runs where
 // eval is unavailable, and consumers calling it in a loop pay no
@@ -13,11 +20,12 @@ import { validateProduct, validateOrganization } from "./schema-validators.js";
  * catalogue; Layer 1 success is also what makes the internal cast to
  * `Sheet` sound (the schema requires the envelope fields).
  *
- * The bundled schemas are the current catalogue's format version. A
- * document declaring some other `format_version` failing Layer 1 is
- * the intended behavior, not a gap: this package lints exactly one
- * format version, and there is no separate "unsupported version"
- * outcome.
+ * Two lines are validated (see sheet-type.ts): a sheet carrying
+ * `release` validates against the current sheet-spec schema for its
+ * type, and a legacy sheet carrying `format_version` validates against
+ * the frozen legacy schema (format 0.9). A legacy sheet declaring some
+ * other `format_version` failing Layer 1 is the intended behavior:
+ * there is no separate "unsupported version" outcome.
  *
  * Dispatches by page type (see sheet-type.ts): product sheets validate
  * against the product schema and lint with the product catalogue;
@@ -27,8 +35,8 @@ import { validateProduct, validateOrganization } from "./schema-validators.js";
  * document of either type routes to its own schema's errors.
  */
 export function validateAndLint(input, options) {
-    const sheetType = detectSheetType((typeof input === "object" && input !== null ? input : {}));
-    const validate = sheetType === "organization" ? validateOrganization : validateProduct;
+    const envelope = (typeof input === "object" && input !== null ? input : {});
+    const validate = validatorFor(detectSheetType(envelope), detectSheetLine(envelope));
     if (!validate(input)) {
         const schemaErrors = (validate.errors ?? []).map((error) => ({
             instancePath: error.instancePath,

package/dist/validate-organization.d.ts

@@ -19,9 +19,9 @@ export type ValidateOrganizationResult = {
 };
 /**
  * Validate a parsed-but-unvalidated document against the bundled
- * Commerce Organization Sheet JSON Schema. The bundled schema is the
- * current format version; a document declaring some other
- * `format_version` failing Layer 1 is the intended behavior, exactly
- * as in the product pipeline.
+ * Commerce Organization Sheet JSON Schema for its line: the current
+ * sheet-spec schema for a sheet carrying `release`, the frozen legacy
+ * schema for one carrying `format_version`, exactly as in the product
+ * pipeline.
  */
 export declare function validateOrganizationSheet(input: unknown): ValidateOrganizationResult;

package/dist/validate-organization.js

@@ -1,12 +1,15 @@
-import { validateOrganization as validate } from "./schema-validators.js";
+import { detectSheetLine } from "./sheet-type.js";
+import { validatorFor } from "./validate-and-lint.js";
 /**
  * Validate a parsed-but-unvalidated document against the bundled
- * Commerce Organization Sheet JSON Schema. The bundled schema is the
- * current format version; a document declaring some other
- * `format_version` failing Layer 1 is the intended behavior, exactly
- * as in the product pipeline.
+ * Commerce Organization Sheet JSON Schema for its line: the current
+ * sheet-spec schema for a sheet carrying `release`, the frozen legacy
+ * schema for one carrying `format_version`, exactly as in the product
+ * pipeline.
  */
 export function validateOrganizationSheet(input) {
+    const envelope = (typeof input === "object" && input !== null ? input : {});
+    const validate = validatorFor("organization", detectSheetLine(envelope));
     if (!validate(input)) {
         const schemaErrors = (validate.errors ?? []).map((error) => ({
             instancePath: error.instancePath,

package/dist/version.d.ts

@@ -5,4 +5,4 @@
  * (test/linter-version.test.mjs) fails when they diverge. Regenerate
  * on version bump.
  */
-export declare const PACKAGE_VERSION = "0.8.0";
+export declare const PACKAGE_VERSION = "0.10.0";

package/dist/version.js

@@ -5,4 +5,4 @@
  * (test/linter-version.test.mjs) fails when they diverge. Regenerate
  * on version bump.
  */
-export const PACKAGE_VERSION = "0.8.0";
+export const PACKAGE_VERSION = "0.10.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pagefront/lint-commerce",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Pagefront commerce linter: the commerce rule catalogue and CLI, on the @pagefront/lint-core engine.",
   "license": "Apache-2.0",
   "repository": {
@@ -39,7 +39,7 @@
     "prepublishOnly": "npm test"
   },
   "dependencies": {
-    "@pagefront/lint-core": "^0.1.0",
+    "@pagefront/lint-core": "^0.2.0",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1"
   },