@pagefront/lint-commerce 0.1.0 → 0.2.0

package/README.md

@@ -39,7 +39,9 @@ internal):
   `{ layer: 1, schemaErrors: SchemaError[] }` or
   `{ layer: 2, report: Report }`. The bundled schemas are the current
   format version; a document declaring another `format_version` fails
-  Layer 1 by design.
+  Layer 1 by design. Layer 1 runs validators compiled ahead of time at
+  package build, so the pipeline needs no runtime code generation and
+  runs under Cloudflare Workers and strict Content Security Policies.
 - `lintSheet(sheet: Sheet, options?: LintOptions): Report` — Layer 2
   only, for input you have already schema-validated. Dispatches to the
   page type's catalogue the same way.
@@ -48,7 +50,8 @@ internal):
   `{ valid: true }` or `{ valid: false, schemaErrors: SchemaError[] }`.
 - `detectSheetType(sheet: Sheet): SheetType` — the page-type dispatch:
   `"organization"` when the envelope `$schema` path contains
-  `/schemas/organization/` (a `/schemas/product/` path likewise wins
+  `/spec/commerce/organization/` or `/schemas/organization/` (a
+  `/spec/commerce/product/` or `/schemas/product/` path likewise wins
   for `"product"`), falling back to a data block whose `@type` is
   `Organization`/`OnlineStore`/`OnlineBusiness` with
   `pagefront:commerceRole` present; `"product"` otherwise.

package/dist/organization-schema.js

@@ -8,9 +8,9 @@
  */
 export const ORGANIZATION_SCHEMA = {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://themachineweb.org/pagefront/commerce/schemas/organization/v0.9.json",
+    "$id": "https://themachineweb.org/pagefront/spec/commerce/organization/v0.9.json",
     "title": "Pagefront Commerce Organization Sheet v0.9",
-    "description": "Formal schema for the Pagefront Commerce Organization Sheet — the sheet describing the entity behind products (brand owner, manufacturer, seller), introduced with commerce format 0.9 alongside the reference-capable legalEntity and the seller-sheet return/shipping model. The data block roots on Schema.org Organization (recognized subtypes permitted; @type is not constrained to a single value). pagefront:commerceRole is the required role discriminator, an array of one or more values from the closed enum brand_owner / manufacturer / seller. pagefront:fulfillmentTerms carries the store-wide shipping defaults as an array of Schema.org-native OfferShippingDetails objects; only the attachment shell is validated, the payload is Schema.org content. pagefront:socialAccount carries the organization's official social accounts (platform / url / handle; publisher-stated only), distinct from sameAs, which carries identity authority records only. pagefront:authorizedResellers (Organization Sheet spec 0.2) carries the brand's authorization claim over its distribution — a pagefront:AuthorizedResellers object with an optional exhaustive flag and a reseller array whose entries name an Organization either as a reference stub (@id) or inline (name plus url and/or address), with optional Schema.org-native areaServed; valid only where commerceRole includes brand_owner (linter ORG-W-006). There is no GTIN-equivalent identifier requirement: identity is @id + name. Validates the envelope and pagefront-namespaced extensions strictly; Schema.org-typed blocks permit additional unspecified properties.",
+    "description": "Formal schema for the Pagefront Commerce Organization Sheet — the sheet describing the entity behind products (brand owner, manufacturer, seller), introduced with commerce format 0.9 alongside the reference-capable legalEntity and the seller-sheet return/shipping model. The data block roots on Schema.org Organization (recognized subtypes permitted; @type is not constrained to a single value). pagefront:commerceRole is the required role discriminator, an array of one or more values from the closed enum brand_owner / manufacturer / seller. pagefront:fulfillmentTerms carries the store-wide shipping defaults as an array of Schema.org-native OfferShippingDetails objects; only the attachment shell is validated, the payload is Schema.org content. pagefront:socialAccount carries the organization's official social accounts (platform / url / handle; publisher-stated only), distinct from sameAs, which carries identity authority records only. pagefront:authorizedResellers carries the brand's authorization claim over its distribution — a pagefront:AuthorizedResellers object with an optional exhaustive flag and a reseller array whose entries name an Organization either as a reference stub (@id) or inline (name plus url and/or address), with optional Schema.org-native areaServed; valid only where commerceRole includes brand_owner (linter ORG-W-006). There is no GTIN-equivalent identifier requirement: identity is @id + name. Validates the envelope and pagefront-namespaced extensions strictly; Schema.org-typed blocks permit additional unspecified properties.",
     "type": "object",
     "required": [
         "format_version",

package/dist/product-schema.js

@@ -8,7 +8,7 @@
  */
 export const PRODUCT_SCHEMA = {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://themachineweb.org/pagefront/commerce/schemas/product/v0.9.json",
+    "$id": "https://themachineweb.org/pagefront/spec/commerce/product/v0.9.json",
     "title": "Pagefront Product Sheet v0.9",
     "description": "Formal schema for the Pagefront product sheet. v0.9 is an additive release on top of v0.8: the legalEntity entry's organization now also validates in reference-stub form (@type + @id, no name) so entries can reference a Commerce Organization Sheet; the inline form and all other constraints are unchanged, and v0.8 sheets remain valid once their format_version is updated. v0.8 is an additive release on top of v0.7: it adds a pagefront:featureGroup[] array for grouped, ordered technical specifications (groups of Schema.org PropertyValue entries, with an optional pagefront:presentationValue display variant per entry), a pagefront:productHighlights[] array of ordered publisher-authored selling-point strings, and a pagefront:legalEntity[] array for role-typed legal entities behind a product (closed role enum: brand_owner, licensee, authorized_representative, importer, manufacturer — EU GPSR responsible persons and similar). gtin and gtin13 now accept a string or an array of strings (regional packaging, re-releases); category now accepts the display string, a Schema.org CategoryCode object, or a mixed array of both. The pagefront:Document role enum gains repairability_index, recall_notice, and declaration_of_conformity; the pagefront:RelatedProduct relationship enum gains service. v0.8 also adds two GPSR-driven safety fields: a pagefront:safetyWarning[] array for typed, language-scoped safety warnings (text required; optional pictogram URL and open-vocabulary hazardCategory) and a pagefront:safetyNotice[] array for structured recall/safety notices (closed noticeType enum: recall, warning; closed remedy enum: repair, replacement, refund). v0.7 sheets remain valid under v0.8 once their format_version is updated. Validates the envelope and pagefront-namespaced extensions strictly; Schema.org-typed blocks permit additional unspecified properties.",
     "type": "object",

package/dist/schema-validators.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The Layer 1 validators, compiled ahead of time from the bundled
+ * schemas by scripts/compile-validators.mjs into dist/schema-validators.js
+ * (the second half of `npm run build`). This declaration is the module's
+ * type; the script copies it beside the generated file.
+ */
+import type { ValidateFunction } from "ajv";
+
+export const validateProduct: ValidateFunction;
+export const validateOrganization: ValidateFunction;