Legislation · public publication pilot

consumer-structural-targets: schema and stability

Generated reference for this publication’s exact JSON Schema sidecar. Field constraints below come directly from the sidecar; JSON Schema does not reproduce every Effect refinement.

Browse the data Consumer guide Download exact schema

Published stability metadata

Schema version: 1.0.0
Digest meaning: exact-file-bytes
Empty file meaning: valid-empty-file
Additive changes: enum-value-added, field-added, record-added
Breaking changes: contract-digest-changed, digest-framing-changed, enum-value-removed, field-removed, path-pattern-changed, record-changed, record-removed, schema-digest-changed

Identifier stability rules

[
  {
    "identifierName": "canonicalPath",
    "mechanicalInputs": "slug, version date, artifact path, and structural path",
    "stabilityRule": "stable-while-structural-inputs-stable",
    "uniquenessScope": "slug-version"
  },
  {
    "identifierName": "slug",
    "mechanicalInputs": "source descriptor slug",
    "stabilityRule": "stable-while-source-descriptor-stable",
    "uniquenessScope": "dataset"
  },
  {
    "identifierName": "structuralPath",
    "mechanicalInputs": "slug, version date, artifact path, and structural path",
    "stabilityRule": "stable-while-structural-inputs-stable",
    "uniquenessScope": "slug-version"
  }
]

Fields (12)

Variant	Field	Required	Published constraints
Common	`artifactKind`	Yes	{ "enum": [ "structural-container" ], "type": "string" }
Common	`artifactRelativePath`	Yes	{ "allOf": [ { "pattern": "^(?!\\/)(?!.(?:^\|\\/)\\.\\.(?:\\/\|$))(?!.\\/\\/)[^\\0\\r\\n]+$" } ], "type": "string" }
Common	`canonicalPath`	Yes	{ "allOf": [ { "pattern": "^(?!\\/)(?!.(?:^\|\\/)\\.\\.(?:\\/\|$))(?!.\\/\\/)[^\\0\\r\\n]+$" } ], "type": "string" }
Common	`headingText`	Yes	{ "type": "string" }
Common	`headingTrail`	Yes	{ "items": { "type": "string" }, "type": "array" }
Common	`name`	Yes	{ "type": "string" }
Common	`schemaVersion`	Yes	{ "type": "string" }
Common	`slug`	Yes	{ "allOf": [ { "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" } ], "type": "string" }
Common	`sourceTextUrl`	Yes	{ "allOf": [ { "pattern": "^https:\\/\\/www\\.legislation\\.gov\\.au\\/.+$" } ], "type": "string" }
Common	`structuralPath`	Yes	{ "items": { "type": "string" }, "type": "array" }
Common	`titleId`	Yes	{ "type": "string" }
Common	`versionDate`	Yes	{ "allOf": [ { "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" } ], "type": "string" }

Complete JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "artifactKind": {
      "enum": [
        "structural-container"
      ],
      "type": "string"
    },
    "artifactRelativePath": {
      "allOf": [
        {
          "pattern": "^(?!\\/)(?!.*(?:^|\\/)\\.\\.(?:\\/|$))(?!.*\\/\\/)[^\\0\\r\\n]+$"
        }
      ],
      "type": "string"
    },
    "canonicalPath": {
      "allOf": [
        {
          "pattern": "^(?!\\/)(?!.*(?:^|\\/)\\.\\.(?:\\/|$))(?!.*\\/\\/)[^\\0\\r\\n]+$"
        }
      ],
      "type": "string"
    },
    "headingText": {
      "type": "string"
    },
    "headingTrail": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "name": {
      "type": "string"
    },
    "schemaVersion": {
      "type": "string"
    },
    "slug": {
      "allOf": [
        {
          "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
        }
      ],
      "type": "string"
    },
    "sourceTextUrl": {
      "allOf": [
        {
          "pattern": "^https:\\/\\/www\\.legislation\\.gov\\.au\\/.+$"
        }
      ],
      "type": "string"
    },
    "structuralPath": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "titleId": {
      "type": "string"
    },
    "versionDate": {
      "allOf": [
        {
          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
        }
      ],
      "type": "string"
    }
  },
  "required": [
    "schemaVersion",
    "slug",
    "titleId",
    "name",
    "versionDate",
    "sourceTextUrl",
    "canonicalPath",
    "artifactRelativePath",
    "artifactKind",
    "structuralPath",
    "headingTrail",
    "headingText"
  ],
  "type": "object",
  "x-legislation": {
    "artifactFamilyKey": "consumer-structural-targets",
    "artifactPathPattern": ".tooling/consumer-structural-targets/<slug>.jsonl",
    "derivationMode": "effect-derived",
    "schemaPath": ".tooling/schemas/consumer-structural-targets.schema.json",
    "schemaVersion": "1.0.0",
    "shapeKind": "encoded-jsonl-record",
    "sourceEffectExport": "ConsumerStructuralTargetRecordJson",
    "sourceEffectModule": "src/domain/consumerSurface.ts"
  }
}

a6de85cccf489b7b121dcec0cddf38c459fff4af3f64d1bc4fde69b4753ec0c5