@_linked/core 2.12.0 → 2.13.0

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

@@ -1,49 +0,0 @@
-/** 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

@@ -1,110 +0,0 @@
-"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

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

package/lib/esm/package.json

@@ -1,9 +0,0 @@
-{
-  "type": "module",
-  "sideEffects": [
-    "**/ontologies/*.js",
-    "**/ontologies/*.ts",
-    "**/utils/Package.js",
-    "**/utils/Package.ts"
-  ]
-}