@uncefact/untp-utils 0.1.0 → 0.3.0

package/build/artefacts/urls.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Construction of UNTP artefact URLs (JSON Schema and JSON-LD context) for a
+ * given credential / artefact type and spec version.
+ *
+ * UNTP v0.7.0 relocated the artefacts. Schemas moved from the legacy
+ * per-credential-type layout on `test.uncefact.org` to the unece.org
+ * artefacts origin, and the JSON-LD context was unified into a single
+ * per-version context on `vocabulary.uncefact.org` (the same context URL for
+ * every type, including the Conformity Vocabulary Catalogue `ConformityScheme`
+ * artefact, which was introduced in v0.7.0). Earlier versions (v0.6.x)
+ * continue to be served from the legacy layout. This is the forward
+ * counterpart to {@link detectVersionFromContext}, which derives the version
+ * from a context URL.
+ *
+ * @see https://untp.unece.org/artefacts/schema/v0.7.0/dpp/DigitalProductPassport.json
+ * @see https://vocabulary.uncefact.org/untp/0.7.0/context/
+ */
+/** Short artefact codes used in UNTP artefact paths, keyed by credential / artefact type. */
+export declare const UNTP_SHORT_CREDENTIAL_TYPES: Record<string, string>;
+/**
+ * v0.7.0+ core schema file names keyed by credential / artefact type. Most
+ * match the type verbatim; `DigitalConformityCredential` is published as
+ * `ConformityCredential`.
+ */
+export declare const UNTP_CORE_SCHEMA_FILENAMES: Record<string, string>;
+/**
+ * UNTP specification page slugs keyed by credential / artefact type. Slugs are
+ * version-independent. Several differ from the credential type name:
+ * `DigitalConformityCredential` is documented at `ConformityCredential`,
+ * `DigitalTraceabilityEvent` at the plural `DigitalTraceabilityEvents`, and
+ * `ConformityScheme` at `ConformityVocabularyCatalog`.
+ */
+export declare const UNTP_SPECIFICATION_PAGE_SLUGS: Record<string, string>;
+/**
+ * The UNTP docs version currently served at the unversioned ("current") docs
+ * path. This version is linked at `/docs/specification/<slug>`; older versions
+ * are linked at `/docs/<version>/specification/<slug>`.
+ *
+ * Maintenance point: update this when UNTP promotes a newer docs version to
+ * current. The previously-current version then gains its own
+ * `/docs/<version>/` path, so this constant moving keeps existing links
+ * pointing at the right version.
+ */
+export declare const CURRENT_UNTP_DOCS_VERSION = "0.7.0";
+/**
+ * Builds the human-readable UNTP specification page URL for a credential /
+ * artefact type at a given version.
+ *
+ * The current docs version ({@link CURRENT_UNTP_DOCS_VERSION}) is served at
+ * the unversioned `/docs/specification/<slug>` path; older versions resolve to
+ * `/docs/<version>/specification/<slug>`. Versions without their own docs fall
+ * back to the nearest published docs version (see `DOCS_VERSION_FALLBACKS`).
+ *
+ * @param type - UNTP credential / artefact type (e.g. `DigitalProductPassport`).
+ * @param version - Semantic version of the artefact (e.g. `0.7.0`).
+ * @returns The specification page URL.
+ * @throws {Error} When `type` is not a recognised UNTP artefact type.
+ */
+export declare function buildSpecificationPageUrl(type: string, version: string): string;
+/** The schema and context URLs for a UNTP artefact. */
+export interface UntpArtefactUrls {
+    /** URL of the JSON Schema the document validates against. */
+    schemaUrl: string;
+    /** URL of the JSON-LD context the document references in `@context`. */
+    contextUrl: string;
+}
+/**
+ * Builds the JSON Schema and JSON-LD context URLs for a UNTP artefact.
+ *
+ * `ConformityScheme` was introduced in v0.7.0 and has no legacy layout; only
+ * call it with a v0.7.0+ version.
+ *
+ * @param type - UNTP credential / artefact type (e.g. `DigitalProductPassport`,
+ *   `ConformityScheme`). Must be a recognised type.
+ * @param version - Semantic version of the artefact (e.g. `0.7.0`).
+ * @returns The {@link UntpArtefactUrls} appropriate for the version.
+ * @throws {Error} When `type` is not a recognised UNTP artefact type.
+ */
+export declare function buildUntpArtefactUrls(type: string, version: string): UntpArtefactUrls;
+/**
+ * The published Identity Resolver link set schema URL for a UNTP version. The schema exists from
+ * 0.7.0 under the artefacts layout only (`/idr/LinksetSchema.json`); no legacy per-type form ever
+ * existed, so this is a single layout rather than a version switch.
+ */
+export declare function buildLinkSetSchemaUrl(version: string): string;

package/build/artefacts/urls.js

@@ -0,0 +1,141 @@
+/**
+ * Construction of UNTP artefact URLs (JSON Schema and JSON-LD context) for a
+ * given credential / artefact type and spec version.
+ *
+ * UNTP v0.7.0 relocated the artefacts. Schemas moved from the legacy
+ * per-credential-type layout on `test.uncefact.org` to the unece.org
+ * artefacts origin, and the JSON-LD context was unified into a single
+ * per-version context on `vocabulary.uncefact.org` (the same context URL for
+ * every type, including the Conformity Vocabulary Catalogue `ConformityScheme`
+ * artefact, which was introduced in v0.7.0). Earlier versions (v0.6.x)
+ * continue to be served from the legacy layout. This is the forward
+ * counterpart to {@link detectVersionFromContext}, which derives the version
+ * from a context URL.
+ *
+ * @see https://untp.unece.org/artefacts/schema/v0.7.0/dpp/DigitalProductPassport.json
+ * @see https://vocabulary.uncefact.org/untp/0.7.0/context/
+ */
+import { isV070OrAbove } from './version.js';
+const LEGACY_BASE = 'https://test.uncefact.org/vocabulary/untp';
+const ARTEFACTS_SCHEMA_BASE = 'https://untp.unece.org/artefacts/schema';
+const UNIFIED_CONTEXT_BASE = 'https://vocabulary.uncefact.org/untp';
+/** Short artefact codes used in UNTP artefact paths, keyed by credential / artefact type. */
+export const UNTP_SHORT_CREDENTIAL_TYPES = {
+    DigitalProductPassport: 'dpp',
+    DigitalConformityCredential: 'dcc',
+    DigitalTraceabilityEvent: 'dte',
+    DigitalFacilityRecord: 'dfr',
+    DigitalIdentityAnchor: 'dia',
+    ConformityScheme: 'cvc',
+};
+/**
+ * v0.7.0+ core schema file names keyed by credential / artefact type. Most
+ * match the type verbatim; `DigitalConformityCredential` is published as
+ * `ConformityCredential`.
+ */
+export const UNTP_CORE_SCHEMA_FILENAMES = {
+    DigitalProductPassport: 'DigitalProductPassport',
+    DigitalConformityCredential: 'ConformityCredential',
+    DigitalTraceabilityEvent: 'DigitalTraceabilityEvent',
+    DigitalFacilityRecord: 'DigitalFacilityRecord',
+    DigitalIdentityAnchor: 'DigitalIdentityAnchor',
+    ConformityScheme: 'ConformityScheme',
+};
+const DOCS_BASE = 'https://untp.unece.org/docs';
+/**
+ * UNTP specification page slugs keyed by credential / artefact type. Slugs are
+ * version-independent. Several differ from the credential type name:
+ * `DigitalConformityCredential` is documented at `ConformityCredential`,
+ * `DigitalTraceabilityEvent` at the plural `DigitalTraceabilityEvents`, and
+ * `ConformityScheme` at `ConformityVocabularyCatalog`.
+ */
+export const UNTP_SPECIFICATION_PAGE_SLUGS = {
+    DigitalProductPassport: 'DigitalProductPassport',
+    DigitalConformityCredential: 'ConformityCredential',
+    DigitalTraceabilityEvent: 'DigitalTraceabilityEvents',
+    DigitalFacilityRecord: 'DigitalFacilityRecord',
+    DigitalIdentityAnchor: 'DigitalIdentityAnchor',
+    ConformityScheme: 'ConformityVocabularyCatalog',
+};
+/**
+ * The UNTP docs version currently served at the unversioned ("current") docs
+ * path. This version is linked at `/docs/specification/<slug>`; older versions
+ * are linked at `/docs/<version>/specification/<slug>`.
+ *
+ * Maintenance point: update this when UNTP promotes a newer docs version to
+ * current. The previously-current version then gains its own
+ * `/docs/<version>/` path, so this constant moving keeps existing links
+ * pointing at the right version.
+ */
+export const CURRENT_UNTP_DOCS_VERSION = '0.7.0';
+/**
+ * Versions that ship no docs of their own, mapped to the published docs
+ * version that covers them. UNTP released 0.6.1 schemas without separate
+ * 0.6.1 docs; the 0.6.0 docs document the whole 0.6.x line.
+ */
+const DOCS_VERSION_FALLBACKS = {
+    '0.6.1': '0.6.0',
+};
+/**
+ * Builds the human-readable UNTP specification page URL for a credential /
+ * artefact type at a given version.
+ *
+ * The current docs version ({@link CURRENT_UNTP_DOCS_VERSION}) is served at
+ * the unversioned `/docs/specification/<slug>` path; older versions resolve to
+ * `/docs/<version>/specification/<slug>`. Versions without their own docs fall
+ * back to the nearest published docs version (see `DOCS_VERSION_FALLBACKS`).
+ *
+ * @param type - UNTP credential / artefact type (e.g. `DigitalProductPassport`).
+ * @param version - Semantic version of the artefact (e.g. `0.7.0`).
+ * @returns The specification page URL.
+ * @throws {Error} When `type` is not a recognised UNTP artefact type.
+ */
+export function buildSpecificationPageUrl(type, version) {
+    const slug = UNTP_SPECIFICATION_PAGE_SLUGS[type];
+    if (!slug) {
+        throw new Error(`Unknown UNTP artefact type "${type}". Expected one of: ${Object.keys(UNTP_SPECIFICATION_PAGE_SLUGS).join(', ')}.`);
+    }
+    const docsVersion = DOCS_VERSION_FALLBACKS[version] ?? version;
+    if (docsVersion === CURRENT_UNTP_DOCS_VERSION) {
+        return `${DOCS_BASE}/specification/${slug}`;
+    }
+    return `${DOCS_BASE}/${docsVersion}/specification/${slug}`;
+}
+/**
+ * Builds the JSON Schema and JSON-LD context URLs for a UNTP artefact.
+ *
+ * `ConformityScheme` was introduced in v0.7.0 and has no legacy layout; only
+ * call it with a v0.7.0+ version.
+ *
+ * @param type - UNTP credential / artefact type (e.g. `DigitalProductPassport`,
+ *   `ConformityScheme`). Must be a recognised type.
+ * @param version - Semantic version of the artefact (e.g. `0.7.0`).
+ * @returns The {@link UntpArtefactUrls} appropriate for the version.
+ * @throws {Error} When `type` is not a recognised UNTP artefact type.
+ */
+export function buildUntpArtefactUrls(type, version) {
+    const shortCode = UNTP_SHORT_CREDENTIAL_TYPES[type];
+    if (!shortCode) {
+        throw new Error(`Unknown UNTP artefact type "${type}". Expected one of: ${Object.keys(UNTP_SHORT_CREDENTIAL_TYPES).join(', ')}.`);
+    }
+    if (isV070OrAbove(version)) {
+        const fileName = UNTP_CORE_SCHEMA_FILENAMES[type];
+        return {
+            schemaUrl: `${ARTEFACTS_SCHEMA_BASE}/v${version}/${shortCode}/${fileName}.json`,
+            contextUrl: `${UNIFIED_CONTEXT_BASE}/${version}/context/`,
+        };
+    }
+    return {
+        schemaUrl: `${LEGACY_BASE}/${shortCode}/untp-${shortCode}-schema-${version}.json`,
+        contextUrl: `${LEGACY_BASE}/${shortCode}/${version}/context/`,
+    };
+}
+/**
+ * The published Identity Resolver link set schema URL for a UNTP version. The schema exists from
+ * 0.7.0 under the artefacts layout only (`/idr/LinksetSchema.json`); no legacy per-type form ever
+ * existed, so this is a single layout rather than a version switch.
+ */
+export function buildLinkSetSchemaUrl(version) {
+    return `${ARTEFACTS_SCHEMA_BASE}/v${version}/idr/LinksetSchema.json`;
+}
+//# sourceMappingURL=urls.js.map

package/build/artefacts/urls.js.map

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

package/build/artefacts/urls.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/artefacts/urls.test.js

@@ -0,0 +1,99 @@
+import { buildUntpArtefactUrls, buildSpecificationPageUrl, UNTP_SHORT_CREDENTIAL_TYPES, UNTP_CORE_SCHEMA_FILENAMES, UNTP_SPECIFICATION_PAGE_SLUGS, buildLinkSetSchemaUrl, } from './urls';
+describe('buildUntpArtefactUrls', () => {
+    describe('v0.6.x (legacy layout)', () => {
+        it('builds the legacy per-credential-type schema and context URLs', () => {
+            expect(buildUntpArtefactUrls('DigitalProductPassport', '0.6.1')).toEqual({
+                schemaUrl: 'https://test.uncefact.org/vocabulary/untp/dpp/untp-dpp-schema-0.6.1.json',
+                contextUrl: 'https://test.uncefact.org/vocabulary/untp/dpp/0.6.1/context/',
+            });
+        });
+        it('uses the legacy layout for v0.6.0', () => {
+            expect(buildUntpArtefactUrls('DigitalConformityCredential', '0.6.0')).toEqual({
+                schemaUrl: 'https://test.uncefact.org/vocabulary/untp/dcc/untp-dcc-schema-0.6.0.json',
+                contextUrl: 'https://test.uncefact.org/vocabulary/untp/dcc/0.6.0/context/',
+            });
+        });
+    });
+    describe('v0.7.0+ (artefacts layout)', () => {
+        it('builds the artefacts schema URL and unified context URL for DPP', () => {
+            expect(buildUntpArtefactUrls('DigitalProductPassport', '0.7.0')).toEqual({
+                schemaUrl: 'https://untp.unece.org/artefacts/schema/v0.7.0/dpp/DigitalProductPassport.json',
+                contextUrl: 'https://vocabulary.uncefact.org/untp/0.7.0/context/',
+            });
+        });
+        it('maps DigitalConformityCredential to the ConformityCredential schema file name', () => {
+            expect(buildUntpArtefactUrls('DigitalConformityCredential', '0.7.0').schemaUrl).toBe('https://untp.unece.org/artefacts/schema/v0.7.0/dcc/ConformityCredential.json');
+        });
+        it.each([
+            ['DigitalFacilityRecord', 'dfr', 'DigitalFacilityRecord'],
+            ['DigitalIdentityAnchor', 'dia', 'DigitalIdentityAnchor'],
+            ['DigitalTraceabilityEvent', 'dte', 'DigitalTraceabilityEvent'],
+        ])('builds the artefacts schema URL for %s', (type, shortCode, fileName) => {
+            expect(buildUntpArtefactUrls(type, '0.7.0').schemaUrl).toBe(`https://untp.unece.org/artefacts/schema/v0.7.0/${shortCode}/${fileName}.json`);
+        });
+        it('builds the artefacts schema and unified context URLs for ConformityScheme (introduced in v0.7.0)', () => {
+            expect(buildUntpArtefactUrls('ConformityScheme', '0.7.0')).toEqual({
+                schemaUrl: 'https://untp.unece.org/artefacts/schema/v0.7.0/cvc/ConformityScheme.json',
+                contextUrl: 'https://vocabulary.uncefact.org/untp/0.7.0/context/',
+            });
+        });
+        it('shares one unified context URL across credentials and the conformity scheme', () => {
+            const dpp = buildUntpArtefactUrls('DigitalProductPassport', '0.7.0').contextUrl;
+            const dte = buildUntpArtefactUrls('DigitalTraceabilityEvent', '0.7.0').contextUrl;
+            const cvc = buildUntpArtefactUrls('ConformityScheme', '0.7.0').contextUrl;
+            expect(new Set([dpp, dte, cvc]).size).toBe(1);
+            expect(dpp).toBe('https://vocabulary.uncefact.org/untp/0.7.0/context/');
+        });
+        it('treats a future minor (0.8.0) as the artefacts layout', () => {
+            expect(buildUntpArtefactUrls('DigitalProductPassport', '0.8.0').schemaUrl).toBe('https://untp.unece.org/artefacts/schema/v0.8.0/dpp/DigitalProductPassport.json');
+        });
+        it('treats a future major (1.0.0) as the artefacts layout', () => {
+            expect(buildUntpArtefactUrls('DigitalProductPassport', '1.0.0').contextUrl).toBe('https://vocabulary.uncefact.org/untp/1.0.0/context/');
+        });
+    });
+    describe('unknown artefact type', () => {
+        it('throws with a helpful message listing the supported types', () => {
+            expect(() => buildUntpArtefactUrls('DigitalLivestockPassport', '0.7.0')).toThrow(/Unknown UNTP artefact type/);
+        });
+    });
+    describe('exported maps', () => {
+        it('the short-code and schema-filename maps agree on the set of supported types', () => {
+            expect(Object.keys(UNTP_SHORT_CREDENTIAL_TYPES).sort()).toEqual(Object.keys(UNTP_CORE_SCHEMA_FILENAMES).sort());
+        });
+    });
+});
+describe('buildSpecificationPageUrl', () => {
+    it('links the current docs version (0.7.0) at the unversioned path', () => {
+        expect(buildSpecificationPageUrl('DigitalProductPassport', '0.7.0')).toBe('https://untp.unece.org/docs/specification/DigitalProductPassport');
+    });
+    it('links an older version (0.6.0) at the versioned path', () => {
+        expect(buildSpecificationPageUrl('DigitalProductPassport', '0.6.0')).toBe('https://untp.unece.org/docs/0.6.0/specification/DigitalProductPassport');
+    });
+    it('falls back to the 0.6.0 docs for 0.6.1 (which has no docs of its own)', () => {
+        expect(buildSpecificationPageUrl('DigitalProductPassport', '0.6.1')).toBe('https://untp.unece.org/docs/0.6.0/specification/DigitalProductPassport');
+    });
+    it('uses the ConformityCredential slug for DigitalConformityCredential', () => {
+        expect(buildSpecificationPageUrl('DigitalConformityCredential', '0.7.0')).toBe('https://untp.unece.org/docs/specification/ConformityCredential');
+    });
+    it('uses the plural DigitalTraceabilityEvents slug for DigitalTraceabilityEvent', () => {
+        expect(buildSpecificationPageUrl('DigitalTraceabilityEvent', '0.6.0')).toBe('https://untp.unece.org/docs/0.6.0/specification/DigitalTraceabilityEvents');
+    });
+    it('uses the ConformityVocabularyCatalog slug for ConformityScheme', () => {
+        expect(buildSpecificationPageUrl('ConformityScheme', '0.7.0')).toBe('https://untp.unece.org/docs/specification/ConformityVocabularyCatalog');
+    });
+    it('throws for an unknown artefact type', () => {
+        expect(() => buildSpecificationPageUrl('DigitalLivestockPassport', '0.7.0')).toThrow(/Unknown UNTP artefact type/);
+    });
+    it('keeps the slug set aligned with the short-code map', () => {
+        expect(Object.keys(UNTP_SPECIFICATION_PAGE_SLUGS).sort()).toEqual(Object.keys(UNTP_SHORT_CREDENTIAL_TYPES).sort());
+    });
+});
+describe('buildLinkSetSchemaUrl', () => {
+    it('builds the artefacts-layout idr schema URL the manifest pins for v0.7.0', () => {
+        expect(buildLinkSetSchemaUrl('0.7.0')).toBe('https://untp.unece.org/artefacts/schema/v0.7.0/idr/LinksetSchema.json');
+    });
+    it('uses the same layout for a later version', () => {
+        expect(buildLinkSetSchemaUrl('0.8.0')).toBe('https://untp.unece.org/artefacts/schema/v0.8.0/idr/LinksetSchema.json');
+    });
+});
+//# sourceMappingURL=urls.test.js.map

package/build/artefacts/urls.test.js.map

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

package/build/artefacts/version.d.ts

@@ -0,0 +1,9 @@
+/**
+ * UNTP spec version predicates.
+ *
+ * The v0.7.0 boundary is significant because v0.7.0 relocated the published
+ * artefacts (see `./urls.ts`): schema origin, context unification, and the
+ * introduction of the Conformity Vocabulary Catalogue.
+ */
+/** Returns true when the given UNTP version string is v0.7.0 or newer. */
+export declare function isV070OrAbove(version: string): boolean;

package/build/artefacts/version.js

@@ -0,0 +1,17 @@
+/**
+ * UNTP spec version predicates.
+ *
+ * The v0.7.0 boundary is significant because v0.7.0 relocated the published
+ * artefacts (see `./urls.ts`): schema origin, context unification, and the
+ * introduction of the Conformity Vocabulary Catalogue.
+ */
+/** Returns true when the given UNTP version string is v0.7.0 or newer. */
+export function isV070OrAbove(version) {
+    const match = version.match(/^(\d+)\.(\d+)/);
+    if (!match)
+        return false;
+    const major = Number(match[1]);
+    const minor = Number(match[2]);
+    return major > 0 || (major === 0 && minor >= 7);
+}
+//# sourceMappingURL=version.js.map

package/build/artefacts/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/artefacts/version.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,OAAO,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/build/artefacts/version.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/artefacts/version.test.js

@@ -0,0 +1,16 @@
+import { isV070OrAbove } from './version';
+describe('isV070OrAbove', () => {
+    it.each([
+        ['0.7.0', true],
+        ['0.7.1', true],
+        ['0.8.0', true],
+        ['1.0.0', true],
+        ['0.6.1', false],
+        ['0.6.0', false],
+        ['0.5.0', false],
+        ['not-a-version', false],
+    ])('returns %s -> %s', (version, expected) => {
+        expect(isV070OrAbove(version)).toBe(expected);
+    });
+});
+//# sourceMappingURL=version.test.js.map

package/build/artefacts/version.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.test.js","sourceRoot":"","sources":["../../src/artefacts/version.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,IAAI,CAAC;QACN,CAAC,OAAO,EAAE,IAAI,CAAC;QACf,CAAC,OAAO,EAAE,IAAI,CAAC;QACf,CAAC,OAAO,EAAE,IAAI,CAAC;QACf,CAAC,OAAO,EAAE,IAAI,CAAC;QACf,CAAC,OAAO,EAAE,KAAK,CAAC;QAChB,CAAC,OAAO,EAAE,KAAK,CAAC;QAChB,CAAC,OAAO,EAAE,KAAK,CAAC;QAChB,CAAC,eAAe,EAAE,KAAK,CAAC;KACzB,CAAC,CAAC,kBAAkB,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;QAC3C,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/bundle/artefacts/context/untp/0.6.0/dcc.d.ts

@@ -0,0 +1,2 @@
+declare const artefact: Record<string, unknown>;
+export default artefact;