209 lines
16 KiB
JavaScript
209 lines
16 KiB
JavaScript
import { access, readFile } from "node:fs/promises";
|
|
import { dirname, resolve } from "node:path";
|
|
import { fileURLToPath } from "node:url";
|
|
|
|
const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
|
|
const parse = async (path) => JSON.parse(await readFile(resolve(root, path), "utf8"));
|
|
|
|
const registry = await parse("registry/registry.json");
|
|
const sources = await parse("registry/sources.json");
|
|
const components = await parse("registry/components.json");
|
|
const candidates = await parse("registry/candidates.json");
|
|
const icons = await parse("registry/icons.json");
|
|
const pages = await parse("registry/pages.json");
|
|
const applicationManifestSchema = await parse("registry/schemas/application-manifest-v0.1.schema.json");
|
|
const designProfileSchema = await parse("registry/schemas/design-profile-v0.1.schema.json");
|
|
const mapSceneFixtureSchema = await parse("registry/schemas/map-scene-fixture-v0.1.schema.json");
|
|
const mapLodPolicySchema = await parse("registry/schemas/map-lod-policy-v0.1.schema.json");
|
|
const mapPresentationProfiles = await parse("registry/map-presentation-profiles.json");
|
|
const dataProductConsumerPolicies = await parse("registry/data-product-consumer-policies.json");
|
|
|
|
const failures = [];
|
|
const requireValue = (condition, message) => {
|
|
if (!condition) failures.push(message);
|
|
};
|
|
|
|
requireValue(registry.schemaVersion === "1.0.0", "registry schemaVersion must be 1.0.0");
|
|
requireValue(registry.libraryVersion, "registry libraryVersion is required");
|
|
requireValue(Array.isArray(registry.packages) && registry.packages.length >= 4, "registry must list all packages");
|
|
requireValue(Array.isArray(sources.sources) && sources.sources.length >= 6, "source audit is incomplete");
|
|
requireValue(Array.isArray(components.components) && components.components.length >= 10, "component registry is incomplete");
|
|
requireValue(Array.isArray(candidates.candidates) && candidates.candidates.length >= 1, "candidate registry is incomplete");
|
|
requireValue(
|
|
Array.isArray(components.components)
|
|
&& Array.isArray(candidates.candidates)
|
|
&& components.components.length + candidates.candidates.length >= 20,
|
|
"component inventory is incomplete",
|
|
);
|
|
requireValue(Array.isArray(icons.groups) && icons.groups.length >= 5, "icon registry is incomplete");
|
|
requireValue(pages.schemaVersion === "0.1.0", "page registry schemaVersion must be 0.1.0");
|
|
requireValue(Array.isArray(pages.templates) && pages.templates.length >= 1, "page registry must contain at least one template");
|
|
requireValue(registry.applicationManifestSchema === "schemas/application-manifest-v0.1.schema.json", "application manifest schema must be registered");
|
|
requireValue(registry.designProfileSchema === "schemas/design-profile-v0.1.schema.json", "design profile schema must be registered");
|
|
requireValue(registry.mapSceneFixtureSchema === "schemas/map-scene-fixture-v0.1.schema.json", "map scene fixture schema must be registered");
|
|
requireValue(registry.mapLodPolicySchema === "schemas/map-lod-policy-v0.1.schema.json", "map LOD policy schema must be registered");
|
|
requireValue(registry.mapPresentationProfileRegistry === "map-presentation-profiles.json", "map presentation profile registry must be registered");
|
|
requireValue(applicationManifestSchema.properties?.schemaVersion?.const === "0.1.0", "application manifest schema version must be 0.1.0");
|
|
requireValue(designProfileSchema.properties?.schemaVersion?.const === "0.1.0", "design profile schema version must be 0.1.0");
|
|
requireValue(mapSceneFixtureSchema.properties?.schemaVersion?.const === "0.1.0", "map scene fixture schema version must be 0.1.0");
|
|
requireValue(mapLodPolicySchema.properties?.schemaVersion?.const === "0.1.0", "map LOD policy schema version must be 0.1.0");
|
|
requireValue(mapPresentationProfiles.schemaVersion === "nodedc.map-presentation-profiles/v1", "map presentation profile registry schema is unsupported");
|
|
requireValue(Array.isArray(mapPresentationProfiles.profiles) && mapPresentationProfiles.profiles.length >= 1, "map presentation profiles are missing");
|
|
requireValue(dataProductConsumerPolicies.schemaVersion === "nodedc.foundry.data-product-consumer-policies/v1", "data product consumer policy registry schema is unsupported");
|
|
requireValue(Array.isArray(dataProductConsumerPolicies.policies) && dataProductConsumerPolicies.policies.length >= 1, "data product consumer policies are missing");
|
|
|
|
const consumerPolicies = dataProductConsumerPolicies.policies ?? [];
|
|
const consumerPolicyIds = consumerPolicies.map((policy) => `${policy.id}@${policy.version}`);
|
|
const consumerPolicyProducts = consumerPolicies.map((policy) => `${policy.dataProductId}@${policy.productVersion}`);
|
|
requireValue(new Set(consumerPolicyIds).size === consumerPolicyIds.length, "data product consumer policy id/version pairs must be unique");
|
|
requireValue(new Set(consumerPolicyProducts).size === consumerPolicyProducts.length, "data product consumer policy product/version pairs must be unique");
|
|
for (const policy of consumerPolicies) {
|
|
const statusContract = policy.statusContract;
|
|
requireValue(typeof policy.id === "string" && /^[a-z0-9._-]{1,160}$/.test(policy.id), `invalid data product consumer policy id: ${policy.id ?? "unknown"}`);
|
|
requireValue(typeof policy.version === "string" && /^\d+\.\d+\.\d+$/.test(policy.version), `invalid data product consumer policy version: ${policy.id ?? "unknown"}`);
|
|
requireValue(typeof policy.dataProductId === "string" && /^[A-Za-z0-9._:-]{1,160}$/.test(policy.dataProductId), `invalid data product consumer policy product: ${policy.id ?? "unknown"}`);
|
|
requireValue(typeof policy.productVersion === "string" && /^\d+\.\d+\.\d+$/.test(policy.productVersion), `invalid data product consumer product version: ${policy.id ?? "unknown"}`);
|
|
requireValue(Array.isArray(policy.terminalStatuses) && policy.terminalStatuses.every((value) => typeof value === "string" && /^[a-z0-9_-]{1,64}$/.test(value)), `invalid terminal statuses: ${policy.id ?? "unknown"}`);
|
|
requireValue(policy.removeMode === "canonical-tombstone-or-snapshot-rebase", `invalid remove mode: ${policy.id ?? "unknown"}`);
|
|
if (statusContract === undefined) {
|
|
requireValue(Number.isInteger(policy.staleAfterMs) && policy.staleAfterMs >= 1_000 && policy.staleAfterMs <= 7 * 24 * 60 * 60 * 1000, `invalid stale window: ${policy.id ?? "unknown"}`);
|
|
continue;
|
|
}
|
|
requireValue(statusContract && typeof statusContract === "object" && !Array.isArray(statusContract), `invalid status contract: ${policy.id ?? "unknown"}`);
|
|
requireValue(typeof statusContract?.attribute === "string" && /^[A-Za-z][A-Za-z0-9_.-]{0,127}$/.test(statusContract.attribute), `invalid status attribute: ${policy.id ?? "unknown"}`);
|
|
requireValue(Array.isArray(statusContract?.allowedValues) && statusContract.allowedValues.length >= 1 && new Set(statusContract.allowedValues).size === statusContract.allowedValues.length, `invalid allowed status values: ${policy.id ?? "unknown"}`);
|
|
requireValue(statusContract?.allowedValues?.every((value) => typeof value === "string" && /^[a-z0-9_-]{1,64}$/.test(value)), `invalid allowed status value: ${policy.id ?? "unknown"}`);
|
|
requireValue(statusContract?.missing === "reject", `status contract must reject missing values: ${policy.id ?? "unknown"}`);
|
|
requireValue(["none", "observed-at"].includes(statusContract?.freshness), `invalid status freshness mode: ${policy.id ?? "unknown"}`);
|
|
requireValue(statusContract?.freshness === "none" ? policy.staleAfterMs === null : Number.isInteger(policy.staleAfterMs), `status freshness/stale window mismatch: ${policy.id ?? "unknown"}`);
|
|
requireValue(policy.terminalStatuses.every((value) => statusContract.allowedValues.includes(value)), `terminal status is outside the closed value contract: ${policy.id ?? "unknown"}`);
|
|
}
|
|
|
|
const movingObjectV4Policy = consumerPolicies.find((policy) => policy.dataProductId === "fleet.positions.current.v4" && policy.productVersion === "4.0.0");
|
|
requireValue(movingObjectV4Policy?.id === "map-moving-object-current-v4", "fleet.positions.current.v4 consumer policy is missing");
|
|
requireValue(movingObjectV4Policy?.statusContract?.attribute === "signal_state", "fleet.positions.current.v4 status source must be signal_state");
|
|
requireValue(JSON.stringify(movingObjectV4Policy?.statusContract?.allowedValues) === JSON.stringify(["active", "inactive"]), "fleet.positions.current.v4 signal states must remain closed active/inactive");
|
|
requireValue(movingObjectV4Policy?.statusContract?.freshness === "none" && movingObjectV4Policy?.staleAfterMs === null, "fleet.positions.current.v4 must not invent freshness states");
|
|
|
|
const ids = components.components.map((component) => component.id);
|
|
requireValue(new Set(ids).size === ids.length, "component ids must be unique");
|
|
const candidateIds = candidates.candidates.map((component) => component.id);
|
|
requireValue(new Set(candidateIds).size === candidateIds.length, "candidate ids must be unique");
|
|
requireValue(candidateIds.every((id) => !ids.includes(id)), "a component cannot be both baseline and candidate");
|
|
const iconNames = icons.groups.flatMap((group) => group.names ?? []);
|
|
requireValue(iconNames.length >= 35, "icon registry must contain the audited baseline set");
|
|
requireValue(new Set(iconNames).size === iconNames.length, "icon names must be unique across groups");
|
|
const pageTemplateKeys = pages.templates.map((template) => `${template.id}@${template.version}`);
|
|
requireValue(new Set(pageTemplateKeys).size === pageTemplateKeys.length, "page template id/version pairs must be unique");
|
|
|
|
for (const template of pages.templates) {
|
|
requireValue(template.schemaVersion === "0.1.0", `unsupported page template schema: ${template.id ?? "unknown"}`);
|
|
requireValue(template.id && template.version && template.title && template.page, `page template entry is incomplete: ${template.id ?? "unknown"}`);
|
|
requireValue(Array.isArray(template.features), `page template features are missing: ${template.id ?? "unknown"}`);
|
|
requireValue(Array.isArray(template.slots), `page template slots are missing: ${template.id ?? "unknown"}`);
|
|
requireValue(Array.isArray(template.actions), `page template actions are missing: ${template.id ?? "unknown"}`);
|
|
|
|
if (template.contracts) {
|
|
requireValue(typeof template.contracts.fixtureSchema === "string", `page template fixture schema is missing: ${template.id ?? "unknown"}`);
|
|
requireValue(Array.isArray(template.contracts.acceptanceFixtures) && template.contracts.acceptanceFixtures.length >= 1, `page template acceptance fixtures are missing: ${template.id ?? "unknown"}`);
|
|
|
|
for (const fixturePath of template.contracts.acceptanceFixtures ?? []) {
|
|
let fixture;
|
|
try {
|
|
fixture = await parse(fixturePath);
|
|
} catch {
|
|
failures.push(`missing or invalid acceptance fixture: ${fixturePath}`);
|
|
continue;
|
|
}
|
|
|
|
requireValue(fixture.schemaVersion === "0.1.0", `unsupported fixture schema: ${fixturePath}`);
|
|
requireValue(fixture.template?.id === template.id && fixture.template?.version === template.version, `fixture template mismatch: ${fixturePath}`);
|
|
requireValue(["ready", "loading", "empty", "stale", "error", "offline"].includes(fixture.state), `unsupported fixture state: ${fixturePath}`);
|
|
requireValue(Array.isArray(fixture.capabilities), `fixture capabilities are missing: ${fixturePath}`);
|
|
requireValue(Array.isArray(fixture.styleProfiles), `fixture style profiles are missing: ${fixturePath}`);
|
|
requireValue(Array.isArray(fixture.acceptance) && fixture.acceptance.length >= 1, `fixture acceptance checks are missing: ${fixturePath}`);
|
|
|
|
const collections = ["layers", "places", "movingObjects", "stations", "routes", "tracks", "zones"];
|
|
requireValue(collections.every((name) => Array.isArray(fixture.scene?.[name])), `fixture scene collections are incomplete: ${fixturePath}`);
|
|
|
|
const entities = collections.flatMap((name) => fixture.scene?.[name] ?? []);
|
|
const entityIds = entities.map((entity) => entity.id);
|
|
requireValue(entityIds.every(Boolean), `fixture entity id is missing: ${fixturePath}`);
|
|
requireValue(new Set(entityIds).size === entityIds.length, `fixture entity ids must be unique: ${fixturePath}`);
|
|
|
|
const styleIds = fixture.styleProfiles?.map((style) => style.id) ?? [];
|
|
requireValue(styleIds.every(Boolean), `fixture style profile id is missing: ${fixturePath}`);
|
|
requireValue(new Set(styleIds).size === styleIds.length, `fixture style profile ids must be unique: ${fixturePath}`);
|
|
|
|
const referencedStyleIds = entities.flatMap((entity) => [entity.styleProfileId, entity.pinStyleProfileId, entity.label?.styleProfileId]).filter(Boolean);
|
|
requireValue(referencedStyleIds.every((id) => styleIds.includes(id)), `fixture references an unknown style profile: ${fixturePath}`);
|
|
|
|
const selectedEntityId = fixture.selection?.entityId;
|
|
requireValue(selectedEntityId === null || entityIds.includes(selectedEntityId), `fixture selection references an unknown entity: ${fixturePath}`);
|
|
|
|
for (const layer of fixture.scene?.layers ?? []) {
|
|
if (!layer.lodLevels) continue;
|
|
const levels = [...layer.lodLevels].sort((a, b) => a.minRange - b.minRange);
|
|
requireValue(levels.every((level) => level.maxRange > level.minRange), `fixture LOD range is invalid: ${fixturePath}#${layer.id}`);
|
|
requireValue(levels.every((level, index) => index === 0 || level.minRange === levels[index - 1].maxRange), `fixture LOD ranges must be contiguous: ${fixturePath}#${layer.id}`);
|
|
}
|
|
}
|
|
|
|
if (template.contracts.lodPolicies) {
|
|
let policySet;
|
|
try {
|
|
policySet = await parse(template.contracts.lodPolicies);
|
|
} catch {
|
|
failures.push(`missing or invalid LOD policy set: ${template.contracts.lodPolicies}`);
|
|
}
|
|
|
|
if (policySet) {
|
|
requireValue(policySet.schemaVersion === "0.1.0", `unsupported LOD policy schema: ${template.contracts.lodPolicies}`);
|
|
requireValue(policySet.template?.id === template.id && policySet.template?.version === template.version, `LOD policy template mismatch: ${template.contracts.lodPolicies}`);
|
|
requireValue(policySet.metric === "camera-range-meters", `LOD policy metric must be provider-neutral camera range: ${template.contracts.lodPolicies}`);
|
|
requireValue(policySet.intervalRule === "min-inclusive-max-exclusive", `LOD interval rule is unsupported: ${template.contracts.lodPolicies}`);
|
|
requireValue(Array.isArray(policySet.policies) && policySet.policies.length >= 1, `LOD policies are missing: ${template.contracts.lodPolicies}`);
|
|
|
|
const policyIds = policySet.policies?.map((policy) => policy.id) ?? [];
|
|
requireValue(new Set(policyIds).size === policyIds.length, `LOD policy ids must be unique: ${template.contracts.lodPolicies}`);
|
|
|
|
for (const policy of policySet.policies ?? []) {
|
|
const bands = [...(policy.bands ?? [])].sort((a, b) => a.minRange - b.minRange);
|
|
requireValue(bands.length >= 1, `LOD policy bands are missing: ${policy.id}`);
|
|
requireValue(new Set(bands.map((band) => band.id)).size === bands.length, `LOD band ids must be unique: ${policy.id}`);
|
|
requireValue(bands.every((band) => band.maxRange > band.minRange), `LOD range is invalid: ${policy.id}`);
|
|
requireValue(bands.every((band, index) => index === 0 || band.minRange === bands[index - 1].maxRange), `LOD ranges must be contiguous: ${policy.id}`);
|
|
requireValue(typeof policy.hysteresisRatio === "number" && policy.hysteresisRatio >= 0 && policy.hysteresisRatio <= 0.5, `LOD hysteresis ratio is invalid: ${policy.id}`);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
for (const component of components.components) {
|
|
requireValue(component.id && component.status && component.summary, `component entry is incomplete: ${component.id ?? "unknown"}`);
|
|
}
|
|
|
|
for (const pkg of registry.packages) {
|
|
try {
|
|
await access(resolve(root, pkg.path, "package.json"));
|
|
} catch {
|
|
failures.push(`missing package manifest: ${pkg.path}/package.json`);
|
|
}
|
|
}
|
|
|
|
for (const path of Object.values(registry.documentation)) {
|
|
try {
|
|
await access(resolve(root, "registry", path));
|
|
} catch {
|
|
failures.push(`missing documentation target: ${path}`);
|
|
}
|
|
}
|
|
|
|
if (failures.length > 0) {
|
|
console.error(failures.map((failure) => `- ${failure}`).join("\n"));
|
|
process.exit(1);
|
|
}
|
|
|
|
console.log(`Registry valid: ${components.components.length} components, ${iconNames.length} icons, ${pages.templates.length} page templates, ${candidates.candidates.length} candidates, ${sources.sources.length} audited sources.`);
|