@lde/dataset 0.7.6 → 0.7.7

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './dataset.js';
 export * from './distribution.js';
 export * from './mediaType.js';
+export * from './skolem.js';
 export * from './validation.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from './dataset.js';
 export * from './distribution.js';
 export * from './mediaType.js';
+export * from './skolem.js';
 export * from './validation.js';

package/dist/skolem.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Mint a deterministic IRI for an otherwise-anonymous structural node — a PROV
+ * `Activity`/`Usage`, a DQV measurement, a `void:Linkset`, a `void:subset` or a
+ * `void:*Partition` — by extending a `base` IRI that is already unique within
+ * the dataset's graph (typically the dataset IRI or one of its subsets) with
+ * `-`-joined `suffixes`.
+ *
+ * Use this instead of a blank node for any such node. A dataset's graph is
+ * assembled from the output of several independent pipeline stages, and
+ * blank-node labels are not preserved across separately serialised documents:
+ * two stages' `_:b0` collapse into one node when the documents are merged into
+ * one graph, silently fusing unrelated provenance, measurements and linksets
+ * (see dataset-knowledge-graph issue #352). IRIs are never relabelled, so
+ * deriving every structural node from a unique base keeps distinct nodes
+ * distinct across stages and makes a re-run idempotent rather than additive —
+ * and lets a later stage address (and extend) a subset or partition another
+ * stage emitted.
+ *
+ * Pass opaque, possibly non-IRI-safe `suffixes` (e.g. a URL) through
+ * {@link hashSuffix} first.
+ */
+export declare function skolemIri(base: string, ...suffixes: string[]): string;
+/**
+ * An md5 hex digest, for embedding an opaque value (e.g. a URL) as a stable,
+ * IRI-safe segment in a {@link skolemIri}.
+ */
+export declare function hashSuffix(value: string): string;
+//# sourceMappingURL=skolem.d.ts.map

package/dist/skolem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skolem.d.ts","sourceRoot":"","sources":["../src/skolem.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAErE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/skolem.js

@@ -0,0 +1,32 @@
+import { createHash } from 'node:crypto';
+/**
+ * Mint a deterministic IRI for an otherwise-anonymous structural node — a PROV
+ * `Activity`/`Usage`, a DQV measurement, a `void:Linkset`, a `void:subset` or a
+ * `void:*Partition` — by extending a `base` IRI that is already unique within
+ * the dataset's graph (typically the dataset IRI or one of its subsets) with
+ * `-`-joined `suffixes`.
+ *
+ * Use this instead of a blank node for any such node. A dataset's graph is
+ * assembled from the output of several independent pipeline stages, and
+ * blank-node labels are not preserved across separately serialised documents:
+ * two stages' `_:b0` collapse into one node when the documents are merged into
+ * one graph, silently fusing unrelated provenance, measurements and linksets
+ * (see dataset-knowledge-graph issue #352). IRIs are never relabelled, so
+ * deriving every structural node from a unique base keeps distinct nodes
+ * distinct across stages and makes a re-run idempotent rather than additive —
+ * and lets a later stage address (and extend) a subset or partition another
+ * stage emitted.
+ *
+ * Pass opaque, possibly non-IRI-safe `suffixes` (e.g. a URL) through
+ * {@link hashSuffix} first.
+ */
+export function skolemIri(base, ...suffixes) {
+    return [base, ...suffixes].join('-');
+}
+/**
+ * An md5 hex digest, for embedding an opaque value (e.g. a URL) as a stable,
+ * IRI-safe segment in a {@link skolemIri}.
+ */
+export function hashSuffix(value) {
+    return createHash('md5').update(value).digest('hex');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lde/dataset",
-  "version": "0.7.6",
+  "version": "0.7.7",
   "repository": {
     "url": "git+https://github.com/ldelements/lde.git",
     "directory": "packages/dataset"