@_linked/core 2.6.0-next.20260509053822 → 2.6.0

package/lib/cjs/utils/LinkedStorage.js

@@ -5,18 +5,30 @@ const CoreMap_js_1 = require("../collections/CoreMap.js");
 const CoreSet_js_1 = require("../collections/CoreSet.js");
 const queryDispatch_js_1 = require("../queries/queryDispatch.js");
 const ShapeClass_js_1 = require("./ShapeClass.js");
+/**
+ * Primary routing layer (arch-04 §The IDataset abstraction).
+ *
+ * Resolves an incoming Linked Query to the IDataset that should handle it,
+ * based on the query's target shape. Composite IDatasets (gateways, routers,
+ * forwarders, resolvers) plug in here just like storage IDatasets do.
+ *
+ * The "Dataset" naming aligns with the IDataset contract. Earlier "Store"
+ * names were renamed in phase-1 — see docs/plans/002-phase-1-create-user-project-flow.md.
+ */
 class LinkedStorage {
     static isInitialised() {
-        return !!this.defaultStore;
+        return !!this.defaultDataset;
     }
-    static getDefaultStore() {
-        return this.defaultStore;
+    /** The catch-all IDataset for shapes with no explicit mapping. */
+    static getDefaultDataset() {
+        return this.defaultDataset;
     }
-    static setDefaultStore(store) {
+    /** Set the default IDataset (catch-all for shapes with no explicit mapping). */
+    static setDefaultDataset(dataset) {
         var _a;
-        this.defaultStore = store;
-        if ((_a = this.defaultStore) === null || _a === void 0 ? void 0 : _a.init) {
-            this.defaultStore.init();
+        this.defaultDataset = dataset;
+        if ((_a = this.defaultDataset) === null || _a === void 0 ? void 0 : _a.init) {
+            this.defaultDataset.init();
         }
         (0, queryDispatch_js_1.setQueryDispatch)({
             selectQuery: (q) => this.selectQuery(q),
@@ -25,79 +37,86 @@ class LinkedStorage {
             deleteQuery: (q) => this.deleteQuery(q),
         });
     }
-    static setStoreForShapes(store, ...shapeClasses) {
+    /** Pin one or more shape classes to a specific IDataset implementer. */
+    static setDatasetForShapes(dataset, ...shapeClasses) {
         shapeClasses.forEach((shapeClass) => {
-            this.shapeToStore.set(shapeClass, store);
+            this.shapeToDataset.set(shapeClass, dataset);
         });
     }
-    static getStores() {
-        const stores = new CoreSet_js_1.CoreSet();
-        if (this.defaultStore) {
-            stores.add(this.defaultStore);
+    /** Every IDataset known to the primary router (default + all pinned). */
+    static getDatasets() {
+        const datasets = new CoreSet_js_1.CoreSet();
+        if (this.defaultDataset) {
+            datasets.add(this.defaultDataset);
         }
-        this.shapeToStore.forEach((store) => stores.add(store));
-        return stores;
+        this.shapeToDataset.forEach((dataset) => datasets.add(dataset));
+        return datasets;
     }
-    static getShapeToStoreMap() {
-        return this.shapeToStore;
+    /** Read-only view of the shape→IDataset map. */
+    static getShapeToDatasetMap() {
+        return this.shapeToDataset;
     }
-    static getStoreForShapeClass(shapeClass) {
+    /** Resolve the IDataset for a given shape class. Walks the prototype chain. */
+    static getDatasetForShapeClass(shapeClass) {
         let current = shapeClass !== null && shapeClass !== void 0 ? shapeClass : null;
         while (typeof current === 'function') {
-            const store = this.shapeToStore.get(current);
-            if (store) {
-                return store;
+            const dataset = this.shapeToDataset.get(current);
+            if (dataset) {
+                return dataset;
             }
             const parent = Object.getPrototypeOf(current);
             if (parent === Function.prototype || parent === null)
                 break;
             current = parent;
         }
-        return this.defaultStore;
+        return this.defaultDataset;
     }
-    static resolveStoreForQueryShape(shape) {
+    static resolveDatasetForQueryShape(shape) {
         if (!shape) {
-            return this.defaultStore;
+            return this.defaultDataset;
         }
         if (typeof shape === 'function') {
-            return this.getStoreForShapeClass(shape);
+            return this.getDatasetForShapeClass(shape);
         }
         if (typeof shape === 'string') {
             const shapeClass = (0, ShapeClass_js_1.getShapeClass)(shape);
-            return this.getStoreForShapeClass(shapeClass);
+            return this.getDatasetForShapeClass(shapeClass);
         }
-        return this.defaultStore;
+        return this.defaultDataset;
     }
     static selectQuery(query) {
         var _a;
-        const store = this.resolveStoreForQueryShape((_a = query === null || query === void 0 ? void 0 : query.root) === null || _a === void 0 ? void 0 : _a.shape);
-        if (!(store === null || store === void 0 ? void 0 : store.selectQuery)) {
-            return Promise.reject(new Error('No query store configured. Call LinkedStorage.setDefaultStore().'));
+        if (!(query === null || query === void 0 ? void 0 : query.root)) {
+            return Promise.reject(new Error(`Invalid select query passed to LinkedStorage.selectQuery(): missing root. Payload: ${query ? JSON.stringify(query) : 'undefined'}`));
         }
-        return store.selectQuery(query);
+        const dataset = this.resolveDatasetForQueryShape((_a = query === null || query === void 0 ? void 0 : query.root) === null || _a === void 0 ? void 0 : _a.shape);
+        if (!(dataset === null || dataset === void 0 ? void 0 : dataset.selectQuery)) {
+            return Promise.reject(new Error('No query dataset configured. Call LinkedStorage.setDefaultDataset().'));
+        }
+        return dataset.selectQuery(query);
     }
     static updateQuery(query) {
-        const store = this.resolveStoreForQueryShape(query === null || query === void 0 ? void 0 : query.shape);
-        if (!(store === null || store === void 0 ? void 0 : store.updateQuery)) {
-            return Promise.reject(new Error('No update handler configured on the query store.'));
+        const dataset = this.resolveDatasetForQueryShape(query === null || query === void 0 ? void 0 : query.shape);
+        if (!(dataset === null || dataset === void 0 ? void 0 : dataset.updateQuery)) {
+            return Promise.reject(new Error('No update handler configured on the query dataset.'));
         }
-        return store.updateQuery(query);
+        return dataset.updateQuery(query);
     }
     static createQuery(query) {
-        const store = this.resolveStoreForQueryShape(query === null || query === void 0 ? void 0 : query.shape);
-        if (!(store === null || store === void 0 ? void 0 : store.createQuery)) {
-            return Promise.reject(new Error('No create handler configured on the query store.'));
+        const dataset = this.resolveDatasetForQueryShape(query === null || query === void 0 ? void 0 : query.shape);
+        if (!(dataset === null || dataset === void 0 ? void 0 : dataset.createQuery)) {
+            return Promise.reject(new Error('No create handler configured on the query dataset.'));
         }
-        return store.createQuery(query);
+        return dataset.createQuery(query);
     }
     static deleteQuery(query) {
-        const store = this.resolveStoreForQueryShape(query === null || query === void 0 ? void 0 : query.shape);
-        if (!(store === null || store === void 0 ? void 0 : store.deleteQuery)) {
-            return Promise.reject(new Error('No delete handler configured on the query store.'));
+        const dataset = this.resolveDatasetForQueryShape(query === null || query === void 0 ? void 0 : query.shape);
+        if (!(dataset === null || dataset === void 0 ? void 0 : dataset.deleteQuery)) {
+            return Promise.reject(new Error('No delete handler configured on the query dataset.'));
         }
-        return store.deleteQuery(query);
+        return dataset.deleteQuery(query);
     }
 }
 exports.LinkedStorage = LinkedStorage;
-LinkedStorage.shapeToStore = new CoreMap_js_1.CoreMap();
+LinkedStorage.shapeToDataset = new CoreMap_js_1.CoreMap();
 //# sourceMappingURL=LinkedStorage.js.map

package/lib/cjs/utils/LinkedStorage.js.map

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

package/lib/cjs/utils/loadStores.d.ts

@@ -0,0 +1,34 @@
+import type { DatasetsConfig } from './parseDatasetsConfig.js';
+/**
+ * Dynamically imports each alias's `store` (an npm specifier) and
+ * instantiates the resolved class with the entry's `config` verbatim —
+ * `new StoreClass(entry.config)`. Returns alias → store.
+ *
+ * Convention: the last segment of the `store` path is the named export
+ * to use (e.g. `@_linked/fuseki/shapes/FusekiStore` → `FusekiStore`).
+ * Falls back to the module's `default` export if the named export is
+ * absent. Each store class must accept a single config-object argument.
+ *
+ * Async + uses runtime dynamic import; works in Node where the module
+ * specifier can be resolved at runtime. Frontends should instead
+ * import each store class explicitly in their storage-config file and
+ * instantiate per alias by hand (webpack can't bundle
+ * `import(variableString)`).
+ *
+ * @example
+ * ```ts
+ * import rawConfig from './linked.backend.datasets.json' assert { type: 'json' };
+ * import { parseDatasetsConfig } from '@_linked/core/utils/parseDatasetsConfig';
+ * import { loadStores } from '@_linked/core/utils/loadStores';
+ * import { LinkedStorage } from '@_linked/core/utils/LinkedStorage';
+ *
+ * const config = parseDatasetsConfig(rawConfig, process.env);
+ * const stores = await loadStores(config);
+ * LinkedStorage.setDefaultDataset(stores.appData);
+ * ```
+ *
+ * @param config  Parsed config from {@link parseDatasetsConfig}.
+ * @returns       Map of alias → constructed store instance.
+ * @throws        If a `store` path can't be resolved to a class export.
+ */
+export declare function loadStores<T = unknown>(config: DatasetsConfig): Promise<Record<string, T>>;

package/lib/cjs/utils/loadStores.js

@@ -0,0 +1,101 @@
+"use strict";
+// Backend-side store loader. Lives in its own file so that frontend
+// bundlers (webpack) consuming parseDatasetsConfig don't pull in the
+// dynamic-import code below — webpack flags `import(variableString)` as
+// a critical dependency when it can't analyse the target statically.
+//
+// Backends import this directly; frontends never do.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadStores = loadStores;
+/**
+ * Dynamically imports each alias's `store` (an npm specifier) and
+ * instantiates the resolved class with the entry's `config` verbatim —
+ * `new StoreClass(entry.config)`. Returns alias → store.
+ *
+ * Convention: the last segment of the `store` path is the named export
+ * to use (e.g. `@_linked/fuseki/shapes/FusekiStore` → `FusekiStore`).
+ * Falls back to the module's `default` export if the named export is
+ * absent. Each store class must accept a single config-object argument.
+ *
+ * Async + uses runtime dynamic import; works in Node where the module
+ * specifier can be resolved at runtime. Frontends should instead
+ * import each store class explicitly in their storage-config file and
+ * instantiate per alias by hand (webpack can't bundle
+ * `import(variableString)`).
+ *
+ * @example
+ * ```ts
+ * import rawConfig from './linked.backend.datasets.json' assert { type: 'json' };
+ * import { parseDatasetsConfig } from '@_linked/core/utils/parseDatasetsConfig';
+ * import { loadStores } from '@_linked/core/utils/loadStores';
+ * import { LinkedStorage } from '@_linked/core/utils/LinkedStorage';
+ *
+ * const config = parseDatasetsConfig(rawConfig, process.env);
+ * const stores = await loadStores(config);
+ * LinkedStorage.setDefaultDataset(stores.appData);
+ * ```
+ *
+ * @param config  Parsed config from {@link parseDatasetsConfig}.
+ * @returns       Map of alias → constructed store instance.
+ * @throws        If a `store` path can't be resolved to a class export.
+ */
+function loadStores(config) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const stores = {};
+        for (const [alias, entry] of Object.entries(config.datasets)) {
+            const mod = yield Promise.resolve(`${entry.store}`).then(s => __importStar(require(s)));
+            const exportName = entry.store.split('/').pop();
+            const StoreClass = (_a = (mod && mod[exportName])) !== null && _a !== void 0 ? _a : (mod && mod.default);
+            if (typeof StoreClass !== 'function') {
+                throw new Error(`loadStores: could not resolve a class export from "${entry.store}" for alias "${alias}". ` +
+                    `Expected a named export "${exportName}" or a default export that is a class.`);
+            }
+            stores[alias] = new StoreClass(entry.config);
+        }
+        return stores;
+    });
+}
+//# sourceMappingURL=loadStores.js.map

package/lib/cjs/utils/loadStores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadStores.js","sourceRoot":"","sources":["../../../src/utils/loadStores.ts"],"names":[],"mappings":";AAAA,oEAAoE;AACpE,qEAAqE;AACrE,wEAAwE;AACxE,qEAAqE;AACrE,EAAE;AACF,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCrD,gCAmBC;AAnDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,SAAsB,UAAU,CAC9B,MAAsB;;;QAEtB,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7D,MAAM,GAAG,GAAG,yBAAa,KAAK,CAAC,KAAK,uCAAC,CAAC;YACtC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC;YACjD,MAAM,UAAU,GACd,MAAA,CAAC,GAAG,IAAK,GAA+B,CAAC,UAAU,CAAC,CAAC,mCACrD,CAAC,GAAG,IAAK,GAA2B,CAAC,OAAO,CAAC,CAAC;YAChD,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CACb,sDAAsD,KAAK,CAAC,KAAK,gBAAgB,KAAK,KAAK;oBACzF,4BAA4B,UAAU,wCAAwC,CACjF,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,GAAG,IAAK,UAAsC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CAAA"}

package/lib/cjs/utils/parseDatasetsConfig.d.ts

@@ -0,0 +1,49 @@
+/** One entry under `datasets`. Keyed by alias name in the parent object. */
+export interface DatasetEntry {
+    /** npm import path to the IDataset class — e.g. "@_linked/fuseki/shapes/FusekiStore". */
+    store: string;
+    /** Constructor argument forwarded to the store class. Shape is store-specific. */
+    config: Record<string, unknown>;
+}
+/** Top-level structure of linked.{backend,frontend}.datasets.json. */
+export interface DatasetsConfig {
+    /** Alias → store entry. */
+    datasets: Record<string, DatasetEntry>;
+    /** Reserved for future top-level sections (fileStorage, services, etc.). */
+    [section: string]: unknown;
+}
+/**
+ * Parse + env-resolve a raw datasets config object.
+ *
+ * - Requires a top-level `datasets` object (other top-level sections are passed
+ *   through unchanged for future extension).
+ * - Resolves `${VAR}` and `${VAR:-default}` placeholders against `env` recursively
+ *   across all string leaves.
+ * - Strips keys starting with `_` (treated as comments / `_note` fields).
+ * - Throws on a referenced env var with no default that is unset or empty.
+ *
+ * Pure + browser-safe — no file I/O, no dynamic imports. Use this on both
+ * backend and frontend. The companion `loadStores` (separate file) does the
+ * runtime dynamic-import dispatch for the backend.
+ *
+ * @example Backend
+ * ```ts
+ * import rawConfig from './linked.backend.datasets.json' assert { type: 'json' };
+ * const config = parseDatasetsConfig(rawConfig, process.env);
+ * ```
+ *
+ * @example Frontend
+ * ```ts
+ * import rawConfig from './linked.frontend.datasets.json' assert { type: 'json' };
+ * // No runtime env in the browser; pass empty {}
+ * const config = parseDatasetsConfig(rawConfig, {});
+ * const appData = new BackendAPIStore(config.datasets.appData.config);
+ * ```
+ *
+ * @param raw   Parsed JSON object (or anything object-shaped). Throws otherwise.
+ * @param env   Env map. Defaults to {} (no interpolation).
+ * @returns     Typed, env-resolved {@link DatasetsConfig}.
+ * @throws      On missing/malformed `datasets`, on malformed alias entry, or
+ *              on an unresolved `${VAR}` with no default.
+ */
+export declare function parseDatasetsConfig(raw: unknown, env?: Record<string, string | undefined>): DatasetsConfig;

package/lib/cjs/utils/parseDatasetsConfig.js

@@ -0,0 +1,110 @@
+"use strict";
+// Pure parser + dispatcher for linked.{backend,frontend}.datasets.json.
+//
+// Per the spec in docs/backlog/016-ejection-export-flow.md:
+//
+//   {
+//     "datasets": {
+//       "<alias>": {
+//         "store":  "<npm-import-path>",
+//         "config": { /* passed verbatim to the store's constructor */ }
+//       }
+//     }
+//   }
+//
+// `store` is an npm import path string (e.g. "@_linked/fuseki/shapes/FusekiStore").
+// `config` is the store class's own concern — the runtime never inspects it.
+// `${VAR}` / `${VAR:-default}` placeholders inside string values are resolved
+// against an env map at parse time.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDatasetsConfig = parseDatasetsConfig;
+/**
+ * Parse + env-resolve a raw datasets config object.
+ *
+ * - Requires a top-level `datasets` object (other top-level sections are passed
+ *   through unchanged for future extension).
+ * - Resolves `${VAR}` and `${VAR:-default}` placeholders against `env` recursively
+ *   across all string leaves.
+ * - Strips keys starting with `_` (treated as comments / `_note` fields).
+ * - Throws on a referenced env var with no default that is unset or empty.
+ *
+ * Pure + browser-safe — no file I/O, no dynamic imports. Use this on both
+ * backend and frontend. The companion `loadStores` (separate file) does the
+ * runtime dynamic-import dispatch for the backend.
+ *
+ * @example Backend
+ * ```ts
+ * import rawConfig from './linked.backend.datasets.json' assert { type: 'json' };
+ * const config = parseDatasetsConfig(rawConfig, process.env);
+ * ```
+ *
+ * @example Frontend
+ * ```ts
+ * import rawConfig from './linked.frontend.datasets.json' assert { type: 'json' };
+ * // No runtime env in the browser; pass empty {}
+ * const config = parseDatasetsConfig(rawConfig, {});
+ * const appData = new BackendAPIStore(config.datasets.appData.config);
+ * ```
+ *
+ * @param raw   Parsed JSON object (or anything object-shaped). Throws otherwise.
+ * @param env   Env map. Defaults to {} (no interpolation).
+ * @returns     Typed, env-resolved {@link DatasetsConfig}.
+ * @throws      On missing/malformed `datasets`, on malformed alias entry, or
+ *              on an unresolved `${VAR}` with no default.
+ */
+function parseDatasetsConfig(raw, env = {}) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new Error('Invalid datasets config: expected a top-level JSON object');
+    }
+    const resolved = resolveInterpolations(raw, env);
+    const datasets = resolved.datasets;
+    if (!datasets || typeof datasets !== 'object' || Array.isArray(datasets)) {
+        throw new Error('Invalid datasets config: missing or malformed "datasets" section');
+    }
+    for (const [alias, entry] of Object.entries(datasets)) {
+        if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
+            throw new Error(`Invalid datasets config: alias "${alias}" must be an object`);
+        }
+        const e = entry;
+        if (typeof e.store !== 'string' || !e.store) {
+            throw new Error(`Invalid datasets config: alias "${alias}" is missing a string "store" (npm import path)`);
+        }
+        if (e.config !== undefined && (typeof e.config !== 'object' || Array.isArray(e.config))) {
+            throw new Error(`Invalid datasets config: alias "${alias}" "config" must be an object if present`);
+        }
+        if (e.config === undefined)
+            e.config = {};
+    }
+    return resolved;
+}
+function resolveInterpolations(value, env) {
+    if (typeof value === 'string')
+        return resolveString(value, env);
+    if (Array.isArray(value)) {
+        return value.map((v) => resolveInterpolations(v, env));
+    }
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const key of Object.keys(value)) {
+            if (key.startsWith('_'))
+                continue; // _note, _comment, ...
+            out[key] = resolveInterpolations(value[key], env);
+        }
+        return out;
+    }
+    return value;
+}
+// Matches ${VAR} or ${VAR:-default}. VAR is uppercase alphanum + underscore.
+// Default text may contain anything except `}`.
+const INTERP_RE = /\$\{([A-Z0-9_]+)(?::-([^}]*))?\}/g;
+function resolveString(input, env) {
+    return input.replace(INTERP_RE, (_full, varName, defaultValue) => {
+        const v = env[varName];
+        if (v !== undefined && v !== '')
+            return v;
+        if (defaultValue !== undefined)
+            return defaultValue;
+        throw new Error(`Required env var "${varName}" is not set and has no default (referenced in datasets config)`);
+    });
+}
+//# sourceMappingURL=parseDatasetsConfig.js.map

package/lib/cjs/utils/parseDatasetsConfig.js.map

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

package/lib/esm/queries/queryDispatch.js

@@ -4,7 +4,7 @@ export function setQueryDispatch(d) {
 }
 export function getQueryDispatch() {
     if (!dispatch) {
-        throw new Error('No query dispatch configured. Call LinkedStorage.setDefaultStore() first.');
+        throw new Error('No query dispatch configured. Call LinkedStorage.setDefaultDataset() first.');
     }
     return dispatch;
 }

package/lib/esm/queries/queryDispatch.js.map

@@ -1 +1 @@
-{"version":3,"file":"queryDispatch.js","sourceRoot":"","sources":["../../../src/queries/queryDispatch.ts"],"names":[],"mappings":"AAoBA,IAAI,QAAQ,GAAyB,IAAI,CAAC;AAE1C,MAAM,UAAU,gBAAgB,CAAC,CAAgB;IAC/C,QAAQ,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"queryDispatch.js","sourceRoot":"","sources":["../../../src/queries/queryDispatch.ts"],"names":[],"mappings":"AAoBA,IAAI,QAAQ,GAAyB,IAAI,CAAC;AAE1C,MAAM,UAAU,gBAAgB,CAAC,CAAgB;IAC/C,QAAQ,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/lib/esm/shapes/SHACL.d.ts

@@ -175,6 +175,19 @@ export interface ParameterConfig {
 }
 export declare class NodeShape extends Shape {
     static targetClass: NodeReferenceValue;
+    /** One-time keys for missing/invalid `propertyShapes` on superclass static `shape`. */
+    private static readonly _warnedMissingPropertyShapesKeys;
+    /**
+     * Returns `propertyShapes` when it is a real array; otherwise `[]` and logs once per
+     * `(ownerClassName, shapeId)` — common when a superclass `static shape` is a plain object
+     * or came from another `@_linked/core` copy without field initializers.
+     *
+     * Label for logs / dedupe keys when walking the shape class chain.
+     * Prefer `class.name` (almost always set for `class X {}`); if missing, use the static
+     * shape's `id` so diagnostics stay useful without vague "(anonymous)".
+     */
+    private static shapeOwnerLabel;
+    private static listPropertyShapesSafe;
     private _label?;
     description?: string;
     targetClass?: NodeReferenceValue;

package/lib/esm/shapes/SHACL.js

@@ -36,6 +36,44 @@ const EXPLICIT_NODE_KIND_SYMBOL = Symbol('explicitNodeKind');
 const EXPLICIT_MIN_COUNT_SYMBOL = Symbol('explicitMinCount');
 const EXPLICIT_MAX_COUNT_SYMBOL = Symbol('explicitMaxCount');
 export class NodeShape extends Shape {
+    /**
+     * Returns `propertyShapes` when it is a real array; otherwise `[]` and logs once per
+     * `(ownerClassName, shapeId)` — common when a superclass `static shape` is a plain object
+     * or came from another `@_linked/core` copy without field initializers.
+     *
+     * Label for logs / dedupe keys when walking the shape class chain.
+     * Prefer `class.name` (almost always set for `class X {}`); if missing, use the static
+     * shape's `id` so diagnostics stay useful without vague "(anonymous)".
+     */
+    static shapeOwnerLabel(shapeClass, nodeShape) {
+        var _a;
+        const n = (_a = shapeClass.name) === null || _a === void 0 ? void 0 : _a.trim();
+        if (n) {
+            return n;
+        }
+        const sid = nodeShape.id;
+        if (sid) {
+            return `<shape ${sid}>`;
+        }
+        return '(unknown-class)';
+    }
+    static listPropertyShapesSafe(nodeShape, ownerClassName, context) {
+        var _a;
+        const raw = nodeShape
+            .propertyShapes;
+        if (Array.isArray(raw)) {
+            return raw;
+        }
+        const id = (_a = nodeShape.id) !== null && _a !== void 0 ? _a : '';
+        const key = `${ownerClassName}:${String(id)}`;
+        if (!NodeShape._warnedMissingPropertyShapesKeys.has(key)) {
+            NodeShape._warnedMissingPropertyShapesKeys.add(key);
+            console.warn(`[@_linked/core] '${ownerClassName}' static shape has missing or invalid propertyShapes ` +
+                `(${context}). Treating as []. Often caused by duplicate @linked/core installs or a ` +
+                `non-normalized static shape on a superclass.`);
+        }
+        return [];
+    }
     constructor(node) {
         super(node);
         this.propertyShapes = [];
@@ -58,15 +96,19 @@ export class NodeShape extends Shape {
     }
     getPropertyShapes(includeSuperClasses = false) {
         if (!includeSuperClasses) {
-            return [...this.propertyShapes];
+            const own = this
+                .propertyShapes;
+            return Array.isArray(own) ? [...own] : [];
         }
         const res = [];
         let shapeClass = getShapeClass(this.id);
         if (!shapeClass) {
-            return [...this.propertyShapes];
+            const own = this
+                .propertyShapes;
+            return Array.isArray(own) ? [...own] : [];
         }
         while (shapeClass === null || shapeClass === void 0 ? void 0 : shapeClass.shape) {
-            res.push(...shapeClass.shape.propertyShapes);
+            res.push(...NodeShape.listPropertyShapesSafe(shapeClass.shape, NodeShape.shapeOwnerLabel(shapeClass, shapeClass.shape), 'getPropertyShapes(includeSuperClasses=true)'));
             // Stop at Shape base class. Cast needed: ShapeConstructor (concrete new) vs
             // typeof Shape (abstract new) are structurally incompatible for ===.
             if (shapeClass === Shape) {
@@ -91,10 +133,14 @@ export class NodeShape extends Shape {
         let shapeClass = getShapeClass(this.id);
         let res;
         if (!shapeClass) {
-            return this.propertyShapes.find((shape) => shape.label === label);
+            const own = this
+                .propertyShapes;
+            return Array.isArray(own)
+                ? own.find((shape) => shape.label === label)
+                : undefined;
         }
         while (!res && (shapeClass === null || shapeClass === void 0 ? void 0 : shapeClass.shape)) {
-            res = shapeClass.shape.propertyShapes.find((shape) => shape.label === label);
+            res = NodeShape.listPropertyShapesSafe(shapeClass.shape, NodeShape.shapeOwnerLabel(shapeClass, shapeClass.shape), 'getPropertyShape').find((shape) => shape.label === label);
             if (checkSubShapes) {
                 if (shapeClass === Shape) {
                     break;
@@ -115,6 +161,8 @@ export class NodeShape extends Shape {
     }
 }
 NodeShape.targetClass = shacl.NodeShape;
+/** One-time keys for missing/invalid `propertyShapes` on superclass static `shape`. */
+NodeShape._warnedMissingPropertyShapesKeys = new Set();
 export class PropertyShape extends Shape {
     constructor() {
         super();