@usecds/server 0.0.0-stage → 0.1.1

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function deterministicStringify(val: any): string;
+export declare function sha256(content: string | Buffer): string;

package/dist/utils.js

@@ -0,0 +1,17 @@
+import crypto from "crypto";
+export function deterministicStringify(val) {
+    if (val === null)
+        return "null";
+    if (Array.isArray(val)) {
+        return "[" + val.map(v => deterministicStringify(v)).join(",") + "]";
+    }
+    if (typeof val === "object") {
+        const keys = Object.keys(val).sort();
+        return "{" + keys.map(k => JSON.stringify(k) + ":" + deterministicStringify(val[k])).join(",") + "}";
+    }
+    return JSON.stringify(val);
+}
+export function sha256(content) {
+    return crypto.createHash("sha256").update(content).digest("hex");
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,UAAU,sBAAsB,CAAC,GAAQ;IAC7C,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAChC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACvE,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACvG,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,OAAwB;IAC7C,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,23 @@
+export declare function validateChannelManifest(data: any): void;
+export declare function validateReleaseManifest(data: any): void;
+export declare function validateCollection(data: any): void;
+export declare function validateTargetDefinition(data: any): void;
+export declare function validateMediaMetadataItem(data: any): void;
+export declare function validateJsonLdDefinition(data: any): void;
+export declare const validateRouteItem: (data: any) => void;
+export declare const validatePageItem: (data: any) => void;
+export declare const validateBlockItem: (data: any) => void;
+export declare const validateMenuItem: (data: any) => void;
+export declare const validateSiteItem: (data: any) => void;
+export declare const validateLanguageItem: (data: any) => void;
+export interface ContentSchemaError {
+    keyword: string;
+    instancePath: string;
+    params: Record<string, any>;
+    message?: string;
+}
+/**
+ * Compiles a JSON Schema declared in a target definition (requirements/recommendations).
+ * The returned function lists all violations; an empty list means valid.
+ */
+export declare function compileContentSchema(schema: object): (data: any) => ContentSchemaError[];

package/dist/validation.js

@@ -0,0 +1,102 @@
+import AjvModule from "ajv";
+import addFormatsModule from "ajv-formats";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+const Ajv = AjvModule.default || AjvModule;
+const addFormats = addFormatsModule.default || addFormatsModule;
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Helper to load schema files from the monorepo root
+function loadSchema(filename) {
+    // We look for schemas first in ../../schemas/v1/ (development/test run)
+    // or inside a relative path depending on build outputs.
+    const possiblePaths = [
+        path.join(__dirname, "..", "..", "schemas", "v1", filename),
+        path.join(__dirname, "..", "schemas", "v1", filename),
+        path.join(__dirname, "schemas", "v1", filename)
+    ];
+    for (const p of possiblePaths) {
+        if (fs.existsSync(p)) {
+            return JSON.parse(fs.readFileSync(p, "utf-8"));
+        }
+    }
+    throw new Error(`Schema file not found: ${filename}`);
+}
+const channelManifestSchema = loadSchema("channel-manifest.json");
+const releaseManifestSchema = loadSchema("release-manifest.json");
+const collectionSchema = loadSchema("collection.json");
+const targetSchema = loadSchema("target.json");
+const mediaMetadataSchema = loadSchema("media-metadata.json");
+const jsonLdSchema = loadSchema("jsonld.json");
+const ajv = new Ajv({ allErrors: true });
+addFormats(ajv);
+const validateChannelManifestFn = ajv.compile(channelManifestSchema);
+const validateReleaseManifestFn = ajv.compile(releaseManifestSchema);
+const validateCollectionFn = ajv.compile(collectionSchema);
+const validateTargetFn = ajv.compile(targetSchema);
+const validateMediaMetadataFn = ajv.compile(mediaMetadataSchema);
+const validateJsonLdFn = ajv.compile(jsonLdSchema);
+// Target-provided schemas are often partial (e.g. only "required"), so strict-mode type hints are off
+const contentAjv = new Ajv({ allErrors: true, strict: false });
+addFormats(contentAjv);
+export function validateChannelManifest(data) {
+    const valid = validateChannelManifestFn(data);
+    if (!valid) {
+        throw new Error(`Invalid Channel Manifest: ${ajv.errorsText(validateChannelManifestFn.errors)}`);
+    }
+}
+export function validateReleaseManifest(data) {
+    const valid = validateReleaseManifestFn(data);
+    if (!valid) {
+        throw new Error(`Invalid Release Manifest: ${ajv.errorsText(validateReleaseManifestFn.errors)}`);
+    }
+}
+export function validateCollection(data) {
+    const valid = validateCollectionFn(data);
+    if (!valid) {
+        throw new Error(`Invalid Collection (${data.collection || "unknown"}): ${ajv.errorsText(validateCollectionFn.errors)}`);
+    }
+}
+export function validateTargetDefinition(data) {
+    const valid = validateTargetFn(data);
+    if (!valid) {
+        throw new Error(`Invalid Target Definition (${data?.id || "unknown"}): ${ajv.errorsText(validateTargetFn.errors)}`);
+    }
+}
+export function validateMediaMetadataItem(data) {
+    const valid = validateMediaMetadataFn(data);
+    if (!valid) {
+        throw new Error(`Invalid _media item (${data?.id || "unknown"}): ${ajv.errorsText(validateMediaMetadataFn.errors)}`);
+    }
+}
+export function validateJsonLdDefinition(data) {
+    const valid = validateJsonLdFn(data);
+    if (!valid) {
+        throw new Error(`Invalid _jsonld item (${data?.id || "unknown"}): ${ajv.errorsText(validateJsonLdFn.errors)}`);
+    }
+}
+// Validators for items of the optional site-structure collections
+function itemValidator(schemaFile, label) {
+    const validate = ajv.compile(loadSchema(schemaFile));
+    return (data) => {
+        if (!validate(data)) {
+            throw new Error(`Invalid ${label} item (${data?.id || "unknown"}): ${ajv.errorsText(validate.errors)}`);
+        }
+    };
+}
+export const validateRouteItem = itemValidator("route.json", "_routes");
+export const validatePageItem = itemValidator("page.json", "_pages");
+export const validateBlockItem = itemValidator("block.json", "_blocks");
+export const validateMenuItem = itemValidator("menu.json", "_menu");
+export const validateSiteItem = itemValidator("site.json", "_site");
+export const validateLanguageItem = itemValidator("language.json", "_languages");
+/**
+ * Compiles a JSON Schema declared in a target definition (requirements/recommendations).
+ * The returned function lists all violations; an empty list means valid.
+ */
+export function compileContentSchema(schema) {
+    const validate = contentAjv.compile(schema);
+    return (data) => (validate(data) ? [] : validate.errors);
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,31 @@
 {
   "name": "@usecds/server",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.4"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/usecds/cds.git",
+    "directory": "server"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "schemas"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf dist"
+  }
 }

package/schemas/v1/block.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Block",
+  "description": "An item of the optional _blocks collection: one section of a page. CDS doesn't interpret type or settings.",
+  "type": "object",
+  "properties": {
+    "id": { "type": "string", "minLength": 1 },
+    "type": { "type": "string", "minLength": 1 },
+    "items": {
+      "type": "array",
+      "description": "Explicit, ordered items",
+      "items": {
+        "type": "object",
+        "properties": { "collection": { "type": "string" }, "id": { "type": "string" } },
+        "required": ["collection", "id"],
+        "additionalProperties": true
+      }
+    },
+    "source": {
+      "type": "object",
+      "description": "All items of a collection, in its order",
+      "properties": { "collection": { "type": "string" } },
+      "required": ["collection"],
+      "additionalProperties": true
+    },
+    "links": { "type": "array", "items": { "type": "string" }, "description": "_menu link item ids" },
+    "settings": { "type": "object", "description": "Presentation settings for the renderer" }
+  },
+  "required": ["id", "type"],
+  "additionalProperties": true
+}

package/schemas/v1/channel-manifest.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "ChannelManifest",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "type": "integer",
+      "const": 1
+    },
+    "channel": {
+      "type": "string"
+    },
+    "releaseId": {
+      "type": "string"
+    },
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time"
+    }
+  },
+  "required": ["schemaVersion", "channel", "releaseId", "updatedAt"],
+  "additionalProperties": true
+}

package/schemas/v1/collection.json

@@ -0,0 +1,89 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Collection",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "type": "integer",
+      "const": 1
+    },
+    "collection": {
+      "type": "string"
+    },
+    "items": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": { "type": "string" },
+          "key": { "type": "string" },
+          "translations": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "object",
+              "properties": {
+                "media": {
+                  "type": "array",
+                  "items": { "type": "string" }
+                }
+              },
+              "additionalProperties": true
+            }
+          },
+          "references": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "collection": { "type": "string" },
+                "id": { "type": "string" }
+              },
+              "required": ["collection", "id"],
+              "additionalProperties": true
+            }
+          },
+          "media": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "_provenance": {
+            "type": "object",
+            "properties": {
+              "translations": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "object",
+                  "additionalProperties": { "$ref": "#/definitions/provenanceMarker" }
+                }
+              },
+              "fields": {
+                "type": "object",
+                "additionalProperties": { "$ref": "#/definitions/provenanceMarker" }
+              }
+            },
+            "additionalProperties": true
+          }
+        },
+        "required": ["id", "key", "translations"],
+        "additionalProperties": true
+      }
+    }
+  },
+  "definitions": {
+    "provenanceMarker": {
+      "type": "object",
+      "properties": {
+        "status": { "enum": ["original", "human", "machine", "reviewed"] },
+        "from": { "type": "string" },
+        "sourceHash": { "type": "string" },
+        "model": { "type": "string" }
+      },
+      "required": ["status"],
+      "additionalProperties": true
+    }
+  },
+  "required": ["schemaVersion", "collection", "items"],
+  "additionalProperties": true
+}

package/schemas/v1/jsonld.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "JsonLdDefinition",
+  "description": "An item of the reserved _jsonld collection: how content items are described as schema.org JSON-LD.",
+  "type": "object",
+  "properties": {
+    "id": { "type": "string", "minLength": 1 },
+    "type": { "type": "string", "minLength": 1, "description": "schema.org type, e.g. Hotel" },
+    "appliesTo": { "type": "string", "description": "Collection this definition is the default for" },
+    "values": { "type": "object", "description": "Fixed values; localized ones go in translations[locale]" },
+    "map": {
+      "type": "object",
+      "description": "schema.org property (dots for nesting, e.g. author.name) -> field path",
+      "additionalProperties": { "type": "string" }
+    }
+  },
+  "required": ["id", "type"],
+  "additionalProperties": true
+}

package/schemas/v1/language.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Language",
+  "description": "An item of the optional _languages collection: a language the site is published in. The key is its locale code, as used in translations (en, de, en-GB); translations[locale].name is its name in each language.",
+  "type": "object",
+  "properties": {
+    "id": { "type": "string", "minLength": 1 },
+    "key": { "type": "string", "pattern": "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$" }
+  },
+  "required": ["id", "key"],
+  "additionalProperties": true
+}

package/schemas/v1/media-metadata.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MediaMetadataItem",
+  "description": "An item of the reserved _media collection. id = the media file's virtual path.",
+  "type": "object",
+  "properties": {
+    "id": { "type": "string", "minLength": 1 },
+    "name": { "type": "string", "description": "Readable output file name (slug); defaults to the original file name" },
+    "translations": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "alt": { "type": ["string", "null"] },
+          "description": { "type": ["string", "null"] }
+        },
+        "additionalProperties": true
+      }
+    },
+    "focalPoint": { "$ref": "#/definitions/point" },
+    "focalPoints": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/definitions/point" }
+    },
+    "width": { "type": "integer", "minimum": 1 },
+    "height": { "type": "integer", "minimum": 1 }
+  },
+  "definitions": {
+    "point": {
+      "type": "object",
+      "properties": {
+        "x": { "type": "number", "minimum": 0, "maximum": 1 },
+        "y": { "type": "number", "minimum": 0, "maximum": 1 }
+      },
+      "required": ["x", "y"],
+      "additionalProperties": true
+    }
+  },
+  "required": ["id"],
+  "additionalProperties": true
+}

package/schemas/v1/menu.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MenuItem",
+  "description": "An item of the optional _menu collection. Items no other item lists in children are menus (e.g. key main); entries carry a link and translations[locale].label.",
+  "type": "object",
+  "properties": {
+    "id": { "type": "string", "minLength": 1 },
+    "children": { "type": "array", "items": { "type": "string" }, "description": "_menu ids in order" },
+    "link": {
+      "type": "object",
+      "properties": {
+        "route": { "type": "string", "description": "_routes id" },
+        "block": { "type": "string", "description": "_blocks id on the route's page (anchor)" },
+        "url": { "type": "string", "description": "External URL" }
+      },
+      "additionalProperties": true
+    }
+  },
+  "required": ["id"],
+  "additionalProperties": true
+}

package/schemas/v1/page.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Page",
+  "description": "An item of the optional _pages collection: page metadata (translations[locale].title / description) and its blocks in order.",
+  "type": "object",
+  "properties": {
+    "id": { "type": "string", "minLength": 1 },
+    "blocks": { "type": "array", "items": { "type": "string" } }
+  },
+  "required": ["id"],
+  "additionalProperties": true
+}

package/schemas/v1/release-manifest.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "ReleaseManifest",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "type": "integer",
+      "const": 1
+    },
+    "releaseId": {
+      "type": "string"
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "sourceReadAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When the publisher started reading the source: the content is at least this recent"
+    },
+    "collections": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "hash": { "type": "string" },
+          "itemCount": { "type": "integer", "minimum": 0 },
+          "size": { "type": "integer", "minimum": 0 }
+        },
+        "required": ["hash", "itemCount", "size"],
+        "additionalProperties": true
+      }
+    },
+    "media": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "hash": { "type": "string" },
+          "size": { "type": "integer", "minimum": 0 },
+          "mimeType": { "type": "string" }
+        },
+        "required": ["hash", "size", "mimeType"],
+        "additionalProperties": true
+      }
+    },
+    "translations": {
+      "type": "object",
+      "properties": {
+        "sourceLocale": { "type": "string" },
+        "locales": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/definitions/translationCounts" }
+        },
+        "overall": { "$ref": "#/definitions/translationCounts" }
+      },
+      "required": ["sourceLocale", "locales", "overall"],
+      "additionalProperties": true
+    },
+    "targets": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "definitions": {
+    "translationCounts": {
+      "type": "object",
+      "properties": {
+        "expected": { "type": "integer", "minimum": 0 },
+        "translated": { "type": "integer", "minimum": 0 },
+        "missing": { "type": "integer", "minimum": 0 },
+        "stale": { "type": "integer", "minimum": 0 },
+        "machine": { "type": "integer", "minimum": 0 }
+      },
+      "required": ["expected", "translated", "missing", "stale", "machine"],
+      "additionalProperties": true
+    }
+  },
+  "required": ["schemaVersion", "releaseId", "createdAt", "collections", "media"],
+  "additionalProperties": true
+}

package/schemas/v1/route.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Route",
+  "description": "An item of the optional _routes collection: one URL, with its path per language in translations[locale].path.",
+  "type": "object",
+  "properties": {
+    "id": { "type": "string", "minLength": 1 },
+    "page": { "type": "string", "description": "_pages id this route shows" },
+    "redirect": { "type": "string", "description": "_routes id to redirect to, instead of a page" },
+    "status": { "enum": [301, 302], "description": "Redirect status (default 301)" },
+    "translations": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "path": { "type": "string", "pattern": "^/" }
+        },
+        "additionalProperties": true
+      }
+    }
+  },
+  "required": ["id"],
+  "additionalProperties": true
+}

package/schemas/v1/site.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Site",
+  "description": "The one item of the optional _site collection: the site's settings. translations[locale].siteName names the site in each language; defaultLanguage is a _languages key. Other fields (copyright, styles, social links) are the site's own.",
+  "type": "object",
+  "properties": {
+    "id": { "type": "string", "minLength": 1 },
+    "defaultLanguage": { "type": "string", "minLength": 1, "description": "_languages key" },
+    "translations": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": {
+        "type": "object",
+        "properties": { "siteName": { "type": "string", "minLength": 1 } },
+        "required": ["siteName"]
+      }
+    }
+  },
+  "required": ["id", "translations"],
+  "additionalProperties": true
+}