@entifix/core 0.1.0-0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 r10c Technologies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# core
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build core` to build the library.
+
+## Running unit tests
+
+Run `nx test core` to execute the unit tests via [Jest](https://jestjs.io).

package/dist/base-entities/configuration-client/configuration-client-singleton.d.ts

@@ -0,0 +1,39 @@
+import { Effect } from 'effect';
+import { EntifixBuildError } from '../entifix-error/index.js';
+import { ConfigurationClient, ConfigurationClientGroup, ConfigurationExtractMode, ConfigurationItem, ConfigurationPlain } from './types.js';
+/**
+ * In-memory {@link ConfigurationClientGroup} backed by a group's
+ * {@link ConfigurationItem} list.
+ *
+ * String resolution supports `exact` and `compose`; the numeric/date/array
+ * getters resolve the raw value with `exact` semantics (the `compose` mode is
+ * URL-oriented and only meaningful for strings). `match` remains unimplemented
+ * (no defined semantics / consumer yet) and fails explicitly.
+ */
+export declare class ConfigurationClientGroupInMemory implements ConfigurationClientGroup {
+    #private;
+    constructor(items?: ConfigurationItem[]);
+    getString(key: string, extractMode?: ConfigurationExtractMode): Effect.Effect<string, EntifixBuildError>;
+    getNumber(key: string, extractMode?: ConfigurationExtractMode): Effect.Effect<number, EntifixBuildError>;
+    getDate(key: string, extractMode?: ConfigurationExtractMode): Effect.Effect<Date, EntifixBuildError>;
+    getArrayString(key: string, extractMode?: ConfigurationExtractMode): Effect.Effect<string[], EntifixBuildError>;
+    getArrayNumber(key: string, extractMode?: ConfigurationExtractMode): Effect.Effect<number[], EntifixBuildError>;
+    getArrayDate(key: string, extractMode?: ConfigurationExtractMode): Effect.Effect<Date[], EntifixBuildError>;
+    getOptionalString(key: string, extractMode?: ConfigurationExtractMode): Effect.Effect<string | undefined, EntifixBuildError>;
+    getOptionalNumber(key: string, extractMode?: ConfigurationExtractMode): Effect.Effect<number | undefined, EntifixBuildError>;
+    getOptionalDate(key: string, extractMode?: ConfigurationExtractMode): Effect.Effect<Date | undefined, EntifixBuildError>;
+    getOptionalArrayNumber(key: string, extractMode?: ConfigurationExtractMode): Effect.Effect<number[] | undefined, EntifixBuildError>;
+    getOptionalArrayString(key: string, extractMode?: ConfigurationExtractMode): Effect.Effect<string[] | undefined, EntifixBuildError>;
+    getOptionalArrayDate(key: string, extractMode?: ConfigurationExtractMode): Effect.Effect<Date[] | undefined, EntifixBuildError>;
+}
+/**
+ * In-memory {@link ConfigurationClient} backed by a loaded
+ * {@link ConfigurationPlain}. Each `in(group)` returns a group view scoped to
+ * that group's items.
+ */
+export declare class ConfigurationClientInMemory implements ConfigurationClient {
+    #private;
+    constructor(plainConfig?: ConfigurationPlain);
+    in(group: string): ConfigurationClientGroup;
+}
+//# sourceMappingURL=configuration-client-singleton.d.ts.map

package/dist/base-entities/configuration-client/configuration-client-singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-client-singleton.d.ts","sourceRoot":"","sources":["../../../src/base-entities/configuration-client/configuration-client-singleton.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAkEpB;;;;;;;;GAQG;AACH,qBAAa,gCAAiC,YAAW,wBAAwB;;gBAGnE,KAAK,GAAE,iBAAiB,EAAO;IA0C3C,SAAS,CACP,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,wBAAkC,GAC9C,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAa3C,SAAS,CACP,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,wBAAkC,GAC9C,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAK3C,OAAO,CACL,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,wBAAkC,GAC9C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAKzC,cAAc,CACZ,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,wBAAkC,GAC9C,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC;IAK7C,cAAc,CACZ,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,wBAAkC,GAC9C,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC;IAS7C,YAAY,CACV,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,wBAAkC,GAC9C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,iBAAiB,CAAC;IAS3C,iBAAiB,CACf,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,wBAAkC,GAC9C,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,iBAAiB,CAAC;IAKvD,iBAAiB,CACf,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,wBAAkC,GAC9C,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,iBAAiB,CAAC;IASvD,eAAe,CACb,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,wBAAkC,GAC9C,MAAM,CAAC,MAAM,CAAC,IAAI,GAAG,SAAS,EAAE,iBAAiB,CAAC;IASrD,sBAAsB,CACpB,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,wBAAkC,GAC9C,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,SAAS,EAAE,iBAAiB,CAAC;IAazD,sBAAsB,CACpB,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,wBAAkC,GAC9C,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,SAAS,EAAE,iBAAiB,CAAC;IAOzD,oBAAoB,CAClB,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,wBAAkC,GAC9C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,SAAS,EAAE,iBAAiB,CAAC;CAUxD;AAED;;;;GAIG;AACH,qBAAa,2BAA4B,YAAW,mBAAmB;;gBAGzD,WAAW,GAAE,kBAAuB;IAIhD,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,wBAAwB;CAG5C"}

package/dist/base-entities/configuration-client/configuration-client-singleton.js

@@ -0,0 +1,164 @@
+import { _ as _class_private_field_loose_base } from "@swc/helpers/_/_class_private_field_loose_base";
+import { _ as _class_private_field_loose_key } from "@swc/helpers/_/_class_private_field_loose_key";
+import { Effect } from 'effect';
+import { EntifixBuildError } from '../entifix-error/index.js';
+/**
+ * Joins a base URL with extra path segments, normalizing slashes so neither
+ * doubled nor missing separators appear (e.g. `http://h/api` + `['product']`
+ * -> `http://h/api/product`).
+ */ function composeUrl(base, segments) {
+    return [
+        base.replace(/\/+$/, ''),
+        ...segments.map((segment)=>segment.replace(/^\/+|\/+$/g, ''))
+    ].filter((part)=>part.length > 0).join('/');
+}
+/** Parses a raw string into a finite number, failing on non-numeric input. */ function parseNumber(key, raw) {
+    const parsed = Number(raw);
+    if (raw.trim() === '' || Number.isNaN(parsed)) {
+        return Effect.fail(new EntifixBuildError(`Configuration key "${key}" is not a number`, undefined, {
+            key,
+            raw
+        }));
+    }
+    return Effect.succeed(parsed);
+}
+/** Parses a raw string into a valid Date, failing on unparseable input. */ function parseDate(key, raw) {
+    const parsed = new Date(raw);
+    if (Number.isNaN(parsed.getTime())) {
+        return Effect.fail(new EntifixBuildError(`Configuration key "${key}" is not a date`, undefined, {
+            key,
+            raw
+        }));
+    }
+    return Effect.succeed(parsed);
+}
+/** Splits a comma-separated raw value into trimmed, non-empty segments. */ function splitArray(raw) {
+    return raw.split(',').map((segment)=>segment.trim()).filter((segment)=>segment.length > 0);
+}
+var _items = /*#__PURE__*/ _class_private_field_loose_key("_items"), _find = /*#__PURE__*/ _class_private_field_loose_key("_find"), _lookup = /*#__PURE__*/ _class_private_field_loose_key("_lookup"), _lookupOptional = /*#__PURE__*/ _class_private_field_loose_key("_lookupOptional"), _unsupportedMode = /*#__PURE__*/ _class_private_field_loose_key("_unsupportedMode");
+/**
+ * In-memory {@link ConfigurationClientGroup} backed by a group's
+ * {@link ConfigurationItem} list.
+ *
+ * String resolution supports `exact` and `compose`; the numeric/date/array
+ * getters resolve the raw value with `exact` semantics (the `compose` mode is
+ * URL-oriented and only meaningful for strings). `match` remains unimplemented
+ * (no defined semantics / consumer yet) and fails explicitly.
+ */ export class ConfigurationClientGroupInMemory {
+    getString(key, extractMode = 'exact') {
+        if (extractMode === 'compose') {
+            const [head, ...segments] = key.split('.');
+            return _class_private_field_loose_base(this, _lookup)[_lookup](head).pipe(Effect.map((base)=>composeUrl(base, segments)));
+        }
+        if (extractMode === 'exact') {
+            return _class_private_field_loose_base(this, _lookup)[_lookup](key);
+        }
+        return _class_private_field_loose_base(this, _unsupportedMode)[_unsupportedMode](key, extractMode);
+    }
+    getNumber(key, extractMode = 'exact') {
+        if (extractMode !== 'exact') return _class_private_field_loose_base(this, _unsupportedMode)[_unsupportedMode](key, extractMode);
+        return _class_private_field_loose_base(this, _lookup)[_lookup](key).pipe(Effect.flatMap((raw)=>parseNumber(key, raw)));
+    }
+    getDate(key, extractMode = 'exact') {
+        if (extractMode !== 'exact') return _class_private_field_loose_base(this, _unsupportedMode)[_unsupportedMode](key, extractMode);
+        return _class_private_field_loose_base(this, _lookup)[_lookup](key).pipe(Effect.flatMap((raw)=>parseDate(key, raw)));
+    }
+    getArrayString(key, extractMode = 'exact') {
+        if (extractMode !== 'exact') return _class_private_field_loose_base(this, _unsupportedMode)[_unsupportedMode](key, extractMode);
+        return _class_private_field_loose_base(this, _lookup)[_lookup](key).pipe(Effect.map(splitArray));
+    }
+    getArrayNumber(key, extractMode = 'exact') {
+        if (extractMode !== 'exact') return _class_private_field_loose_base(this, _unsupportedMode)[_unsupportedMode](key, extractMode);
+        return _class_private_field_loose_base(this, _lookup)[_lookup](key).pipe(Effect.flatMap((raw)=>Effect.all(splitArray(raw).map((segment)=>parseNumber(key, segment)))));
+    }
+    getArrayDate(key, extractMode = 'exact') {
+        if (extractMode !== 'exact') return _class_private_field_loose_base(this, _unsupportedMode)[_unsupportedMode](key, extractMode);
+        return _class_private_field_loose_base(this, _lookup)[_lookup](key).pipe(Effect.flatMap((raw)=>Effect.all(splitArray(raw).map((segment)=>parseDate(key, segment)))));
+    }
+    getOptionalString(key, extractMode = 'exact') {
+        if (extractMode !== 'exact') return _class_private_field_loose_base(this, _unsupportedMode)[_unsupportedMode](key, extractMode);
+        return _class_private_field_loose_base(this, _lookupOptional)[_lookupOptional](key);
+    }
+    getOptionalNumber(key, extractMode = 'exact') {
+        if (extractMode !== 'exact') return _class_private_field_loose_base(this, _unsupportedMode)[_unsupportedMode](key, extractMode);
+        return _class_private_field_loose_base(this, _lookupOptional)[_lookupOptional](key).pipe(Effect.flatMap((raw)=>raw === undefined ? Effect.succeed(undefined) : parseNumber(key, raw)));
+    }
+    getOptionalDate(key, extractMode = 'exact') {
+        if (extractMode !== 'exact') return _class_private_field_loose_base(this, _unsupportedMode)[_unsupportedMode](key, extractMode);
+        return _class_private_field_loose_base(this, _lookupOptional)[_lookupOptional](key).pipe(Effect.flatMap((raw)=>raw === undefined ? Effect.succeed(undefined) : parseDate(key, raw)));
+    }
+    getOptionalArrayNumber(key, extractMode = 'exact') {
+        if (extractMode !== 'exact') return _class_private_field_loose_base(this, _unsupportedMode)[_unsupportedMode](key, extractMode);
+        return _class_private_field_loose_base(this, _lookupOptional)[_lookupOptional](key).pipe(Effect.flatMap((raw)=>raw === undefined ? Effect.succeed(undefined) : Effect.all(splitArray(raw).map((segment)=>parseNumber(key, segment)))));
+    }
+    getOptionalArrayString(key, extractMode = 'exact') {
+        if (extractMode !== 'exact') return _class_private_field_loose_base(this, _unsupportedMode)[_unsupportedMode](key, extractMode);
+        return _class_private_field_loose_base(this, _lookupOptional)[_lookupOptional](key).pipe(Effect.map((raw)=>raw === undefined ? undefined : splitArray(raw)));
+    }
+    getOptionalArrayDate(key, extractMode = 'exact') {
+        if (extractMode !== 'exact') return _class_private_field_loose_base(this, _unsupportedMode)[_unsupportedMode](key, extractMode);
+        return _class_private_field_loose_base(this, _lookupOptional)[_lookupOptional](key).pipe(Effect.flatMap((raw)=>raw === undefined ? Effect.succeed(undefined) : Effect.all(splitArray(raw).map((segment)=>parseDate(key, segment)))));
+    }
+    constructor(items = []){
+        Object.defineProperty(this, _find, {
+            value: find
+        });
+        Object.defineProperty(this, _lookup, {
+            value: lookup
+        });
+        Object.defineProperty(this, _lookupOptional, {
+            value: lookupOptional
+        });
+        Object.defineProperty(this, _unsupportedMode, {
+            value: unsupportedMode
+        });
+        Object.defineProperty(this, _items, {
+            writable: true,
+            value: void 0
+        });
+        _class_private_field_loose_base(this, _items)[_items] = items;
+    }
+}
+function find(key) {
+    return _class_private_field_loose_base(this, _items)[_items].find((candidate)=>candidate.key === key);
+}
+function lookup(key) {
+    const item = _class_private_field_loose_base(this, _find)[_find](key);
+    if (item === undefined || item.value == null) {
+        return Effect.fail(new EntifixBuildError(`Configuration key "${key}" not found`, undefined, {
+            key,
+            availableKeys: _class_private_field_loose_base(this, _items)[_items].map((candidate)=>candidate.key)
+        }));
+    }
+    return Effect.succeed(String(item.value));
+}
+function lookupOptional(key) {
+    const item = _class_private_field_loose_base(this, _find)[_find](key);
+    return Effect.succeed(item === undefined || item.value == null ? undefined : String(item.value));
+}
+function unsupportedMode(key, extractMode) {
+    return Effect.fail(new EntifixBuildError(`Configuration extract mode "${extractMode}" is not implemented yet`, undefined, {
+        key,
+        extractMode
+    }));
+}
+var _plainConfig = /*#__PURE__*/ _class_private_field_loose_key("_plainConfig");
+/**
+ * In-memory {@link ConfigurationClient} backed by a loaded
+ * {@link ConfigurationPlain}. Each `in(group)` returns a group view scoped to
+ * that group's items.
+ */ export class ConfigurationClientInMemory {
+    in(group) {
+        var _class_private_field_loose_base__plainConfig_group;
+        return new ConfigurationClientGroupInMemory((_class_private_field_loose_base__plainConfig_group = _class_private_field_loose_base(this, _plainConfig)[_plainConfig][group]) != null ? _class_private_field_loose_base__plainConfig_group : []);
+    }
+    constructor(plainConfig = {}){
+        Object.defineProperty(this, _plainConfig, {
+            writable: true,
+            value: void 0
+        });
+        _class_private_field_loose_base(this, _plainConfig)[_plainConfig] = plainConfig;
+    }
+}
+
+//# sourceMappingURL=configuration-client-singleton.js.map

package/dist/base-entities/configuration-client/configuration-client-singleton.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/base-entities/configuration-client/configuration-client-singleton.ts"],"sourcesContent":["import { Effect } from 'effect';\n\nimport { EntifixBuildError } from '../entifix-error/index.js';\nimport {\n  ConfigurationClient,\n  ConfigurationClientGroup,\n  ConfigurationExtractMode,\n  ConfigurationItem,\n  ConfigurationPlain,\n} from './types.js';\n\n/**\n * Joins a base URL with extra path segments, normalizing slashes so neither\n * doubled nor missing separators appear (e.g. `http://h/api` + `['product']`\n * -> `http://h/api/product`).\n */\nfunction composeUrl(base: string, segments: string[]): string {\n  return [\n    base.replace(/\\/+$/, ''),\n    ...segments.map(segment => segment.replace(/^\\/+|\\/+$/g, '')),\n  ]\n    .filter(part => part.length > 0)\n    .join('/');\n}\n\n/** Parses a raw string into a finite number, failing on non-numeric input. */\nfunction parseNumber(\n  key: string,\n  raw: string,\n): Effect.Effect<number, EntifixBuildError> {\n  const parsed = Number(raw);\n  if (raw.trim() === '' || Number.isNaN(parsed)) {\n    return Effect.fail(\n      new EntifixBuildError(\n        `Configuration key \"${key}\" is not a number`,\n        undefined,\n        {\n          key,\n          raw,\n        },\n      ),\n    );\n  }\n  return Effect.succeed(parsed);\n}\n\n/** Parses a raw string into a valid Date, failing on unparseable input. */\nfunction parseDate(\n  key: string,\n  raw: string,\n): Effect.Effect<Date, EntifixBuildError> {\n  const parsed = new Date(raw);\n  if (Number.isNaN(parsed.getTime())) {\n    return Effect.fail(\n      new EntifixBuildError(\n        `Configuration key \"${key}\" is not a date`,\n        undefined,\n        {\n          key,\n          raw,\n        },\n      ),\n    );\n  }\n  return Effect.succeed(parsed);\n}\n\n/** Splits a comma-separated raw value into trimmed, non-empty segments. */\nfunction splitArray(raw: string): string[] {\n  return raw\n    .split(',')\n    .map(segment => segment.trim())\n    .filter(segment => segment.length > 0);\n}\n\n/**\n * In-memory {@link ConfigurationClientGroup} backed by a group's\n * {@link ConfigurationItem} list.\n *\n * String resolution supports `exact` and `compose`; the numeric/date/array\n * getters resolve the raw value with `exact` semantics (the `compose` mode is\n * URL-oriented and only meaningful for strings). `match` remains unimplemented\n * (no defined semantics / consumer yet) and fails explicitly.\n */\nexport class ConfigurationClientGroupInMemory implements ConfigurationClientGroup {\n  #items: ConfigurationItem[];\n\n  constructor(items: ConfigurationItem[] = []) {\n    this.#items = items;\n  }\n\n  #find(key: string): ConfigurationItem | undefined {\n    return this.#items.find(candidate => candidate.key === key);\n  }\n\n  #lookup(key: string): Effect.Effect<string, EntifixBuildError> {\n    const item = this.#find(key);\n    if (item === undefined || item.value == null) {\n      return Effect.fail(\n        new EntifixBuildError(\n          `Configuration key \"${key}\" not found`,\n          undefined,\n          { key, availableKeys: this.#items.map(candidate => candidate.key) },\n        ),\n      );\n    }\n    return Effect.succeed(String(item.value));\n  }\n\n  #lookupOptional(key: string): Effect.Effect<string | undefined, never> {\n    const item = this.#find(key);\n    return Effect.succeed(\n      item === undefined || item.value == null ? undefined : String(item.value),\n    );\n  }\n\n  #unsupportedMode(\n    key: string,\n    extractMode: ConfigurationExtractMode,\n  ): Effect.Effect<never, EntifixBuildError> {\n    return Effect.fail(\n      new EntifixBuildError(\n        `Configuration extract mode \"${extractMode}\" is not implemented yet`,\n        undefined,\n        { key, extractMode },\n      ),\n    );\n  }\n\n  getString(\n    key: string,\n    extractMode: ConfigurationExtractMode = 'exact',\n  ): Effect.Effect<string, EntifixBuildError> {\n    if (extractMode === 'compose') {\n      const [head, ...segments] = key.split('.');\n      return this.#lookup(head).pipe(\n        Effect.map(base => composeUrl(base, segments)),\n      );\n    }\n    if (extractMode === 'exact') {\n      return this.#lookup(key);\n    }\n    return this.#unsupportedMode(key, extractMode);\n  }\n\n  getNumber(\n    key: string,\n    extractMode: ConfigurationExtractMode = 'exact',\n  ): Effect.Effect<number, EntifixBuildError> {\n    if (extractMode !== 'exact') return this.#unsupportedMode(key, extractMode);\n    return this.#lookup(key).pipe(Effect.flatMap(raw => parseNumber(key, raw)));\n  }\n\n  getDate(\n    key: string,\n    extractMode: ConfigurationExtractMode = 'exact',\n  ): Effect.Effect<Date, EntifixBuildError> {\n    if (extractMode !== 'exact') return this.#unsupportedMode(key, extractMode);\n    return this.#lookup(key).pipe(Effect.flatMap(raw => parseDate(key, raw)));\n  }\n\n  getArrayString(\n    key: string,\n    extractMode: ConfigurationExtractMode = 'exact',\n  ): Effect.Effect<string[], EntifixBuildError> {\n    if (extractMode !== 'exact') return this.#unsupportedMode(key, extractMode);\n    return this.#lookup(key).pipe(Effect.map(splitArray));\n  }\n\n  getArrayNumber(\n    key: string,\n    extractMode: ConfigurationExtractMode = 'exact',\n  ): Effect.Effect<number[], EntifixBuildError> {\n    if (extractMode !== 'exact') return this.#unsupportedMode(key, extractMode);\n    return this.#lookup(key).pipe(\n      Effect.flatMap(raw =>\n        Effect.all(splitArray(raw).map(segment => parseNumber(key, segment))),\n      ),\n    );\n  }\n\n  getArrayDate(\n    key: string,\n    extractMode: ConfigurationExtractMode = 'exact',\n  ): Effect.Effect<Date[], EntifixBuildError> {\n    if (extractMode !== 'exact') return this.#unsupportedMode(key, extractMode);\n    return this.#lookup(key).pipe(\n      Effect.flatMap(raw =>\n        Effect.all(splitArray(raw).map(segment => parseDate(key, segment))),\n      ),\n    );\n  }\n\n  getOptionalString(\n    key: string,\n    extractMode: ConfigurationExtractMode = 'exact',\n  ): Effect.Effect<string | undefined, EntifixBuildError> {\n    if (extractMode !== 'exact') return this.#unsupportedMode(key, extractMode);\n    return this.#lookupOptional(key);\n  }\n\n  getOptionalNumber(\n    key: string,\n    extractMode: ConfigurationExtractMode = 'exact',\n  ): Effect.Effect<number | undefined, EntifixBuildError> {\n    if (extractMode !== 'exact') return this.#unsupportedMode(key, extractMode);\n    return this.#lookupOptional(key).pipe(\n      Effect.flatMap(raw =>\n        raw === undefined ? Effect.succeed(undefined) : parseNumber(key, raw),\n      ),\n    );\n  }\n\n  getOptionalDate(\n    key: string,\n    extractMode: ConfigurationExtractMode = 'exact',\n  ): Effect.Effect<Date | undefined, EntifixBuildError> {\n    if (extractMode !== 'exact') return this.#unsupportedMode(key, extractMode);\n    return this.#lookupOptional(key).pipe(\n      Effect.flatMap(raw =>\n        raw === undefined ? Effect.succeed(undefined) : parseDate(key, raw),\n      ),\n    );\n  }\n\n  getOptionalArrayNumber(\n    key: string,\n    extractMode: ConfigurationExtractMode = 'exact',\n  ): Effect.Effect<number[] | undefined, EntifixBuildError> {\n    if (extractMode !== 'exact') return this.#unsupportedMode(key, extractMode);\n    return this.#lookupOptional(key).pipe(\n      Effect.flatMap(raw =>\n        raw === undefined\n          ? Effect.succeed(undefined)\n          : Effect.all(\n              splitArray(raw).map(segment => parseNumber(key, segment)),\n            ),\n      ),\n    );\n  }\n\n  getOptionalArrayString(\n    key: string,\n    extractMode: ConfigurationExtractMode = 'exact',\n  ): Effect.Effect<string[] | undefined, EntifixBuildError> {\n    if (extractMode !== 'exact') return this.#unsupportedMode(key, extractMode);\n    return this.#lookupOptional(key).pipe(\n      Effect.map(raw => (raw === undefined ? undefined : splitArray(raw))),\n    );\n  }\n\n  getOptionalArrayDate(\n    key: string,\n    extractMode: ConfigurationExtractMode = 'exact',\n  ): Effect.Effect<Date[] | undefined, EntifixBuildError> {\n    if (extractMode !== 'exact') return this.#unsupportedMode(key, extractMode);\n    return this.#lookupOptional(key).pipe(\n      Effect.flatMap(raw =>\n        raw === undefined\n          ? Effect.succeed(undefined)\n          : Effect.all(splitArray(raw).map(segment => parseDate(key, segment))),\n      ),\n    );\n  }\n}\n\n/**\n * In-memory {@link ConfigurationClient} backed by a loaded\n * {@link ConfigurationPlain}. Each `in(group)` returns a group view scoped to\n * that group's items.\n */\nexport class ConfigurationClientInMemory implements ConfigurationClient {\n  #plainConfig: ConfigurationPlain;\n\n  constructor(plainConfig: ConfigurationPlain = {}) {\n    this.#plainConfig = plainConfig;\n  }\n\n  in(group: string): ConfigurationClientGroup {\n    return new ConfigurationClientGroupInMemory(this.#plainConfig[group] ?? []);\n  }\n}\n"],"names":["Effect","EntifixBuildError","composeUrl","base","segments","replace","map","segment","filter","part","length","join","parseNumber","key","raw","parsed","Number","trim","isNaN","fail","undefined","succeed","parseDate","Date","getTime","splitArray","split","ConfigurationClientGroupInMemory","getString","extractMode","head","pipe","getNumber","flatMap","getDate","getArrayString","getArrayNumber","all","getArrayDate","getOptionalString","getOptionalNumber","getOptionalDate","getOptionalArrayNumber","getOptionalArrayString","getOptionalArrayDate","items","find","candidate","item","value","availableKeys","String","ConfigurationClientInMemory","in","group","plainConfig"],"mappings":"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"}

package/dist/base-entities/configuration-client/index.d.ts

@@ -0,0 +1,4 @@
+export * from './configuration-client-singleton.js';
+export * from './read-configuration-from-process.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/base-entities/configuration-client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/base-entities/configuration-client/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,YAAY,CAAC"}

package/dist/base-entities/configuration-client/index.js

@@ -0,0 +1,5 @@
+export * from './configuration-client-singleton.js';
+export * from './read-configuration-from-process.js';
+export * from './types.js';
+
+//# sourceMappingURL=index.js.map

package/dist/base-entities/configuration-client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/base-entities/configuration-client/index.ts"],"sourcesContent":["export * from './configuration-client-singleton.js';\nexport * from './read-configuration-from-process.js';\nexport * from './types.js';\n"],"names":[],"mappings":"AAAA,cAAc,sCAAsC;AACpD,cAAc,uCAAuC;AACrD,cAAc,aAAa"}

package/dist/base-entities/configuration-client/read-configuration-from-process.d.ts

@@ -0,0 +1,11 @@
+import { ConfigurationPlain } from './types.js';
+/**
+ * Groups a flat record of `GROUP__KEY=value` entries into `ConfigurationPlain`.
+ *
+ * The input is expected to be already scoped to a single service (the
+ * `SERVICE__` prefix removed by the caller). Each entry's name is split on the
+ * first `__` into a group and a key (the key may itself contain `__`). Malformed
+ * entries without a group/key pair are skipped.
+ */
+export declare const readConfigurationFromProcess: (keys: Record<string, string>) => ConfigurationPlain;
+//# sourceMappingURL=read-configuration-from-process.d.ts.map

package/dist/base-entities/configuration-client/read-configuration-from-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-configuration-from-process.d.ts","sourceRoot":"","sources":["../../../src/base-entities/configuration-client/read-configuration-from-process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEnE;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B,kBAeF,CAAC"}

package/dist/base-entities/configuration-client/read-configuration-from-process.js

@@ -0,0 +1,26 @@
+/**
+ * Groups a flat record of `GROUP__KEY=value` entries into `ConfigurationPlain`.
+ *
+ * The input is expected to be already scoped to a single service (the
+ * `SERVICE__` prefix removed by the caller). Each entry's name is split on the
+ * first `__` into a group and a key (the key may itself contain `__`). Malformed
+ * entries without a group/key pair are skipped.
+ */ export const readConfigurationFromProcess = (keys)=>{
+    const config = {};
+    for (const [name, value] of Object.entries(keys)){
+        var _config, _group, _;
+        const [group, ...rest] = name.split('__');
+        if (!group || rest.length === 0) {
+            continue;
+        }
+        const key = rest.join('__');
+        const item = {
+            key,
+            value
+        };
+        ((_ = (_config = config)[_group = group]) != null ? _ : _config[_group] = []).push(item);
+    }
+    return config;
+};
+
+//# sourceMappingURL=read-configuration-from-process.js.map

package/dist/base-entities/configuration-client/read-configuration-from-process.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/base-entities/configuration-client/read-configuration-from-process.ts"],"sourcesContent":["import { ConfigurationItem, ConfigurationPlain } from './types.js';\n\n/**\n * Groups a flat record of `GROUP__KEY=value` entries into `ConfigurationPlain`.\n *\n * The input is expected to be already scoped to a single service (the\n * `SERVICE__` prefix removed by the caller). Each entry's name is split on the\n * first `__` into a group and a key (the key may itself contain `__`). Malformed\n * entries without a group/key pair are skipped.\n */\nexport const readConfigurationFromProcess = (\n  keys: Record<string, string>,\n): ConfigurationPlain => {\n  const config: ConfigurationPlain = {};\n\n  for (const [name, value] of Object.entries(keys)) {\n    const [group, ...rest] = name.split('__');\n    if (!group || rest.length === 0) {\n      continue;\n    }\n\n    const key = rest.join('__');\n    const item: ConfigurationItem = { key, value };\n    (config[group] ??= []).push(item);\n  }\n\n  return config;\n};\n"],"names":["readConfigurationFromProcess","keys","config","name","value","Object","entries","group","rest","split","length","key","join","item","push"],"mappings":"AAEA;;;;;;;CAOC,GACD,OAAO,MAAMA,+BAA+B,CAC1CC;IAEA,MAAMC,SAA6B,CAAC;IAEpC,KAAK,MAAM,CAACC,MAAMC,MAAM,IAAIC,OAAOC,OAAO,CAACL,MAAO;YAQ/CC,SAAOK,QAAPL;QAPD,MAAM,CAACK,OAAO,GAAGC,KAAK,GAAGL,KAAKM,KAAK,CAAC;QACpC,IAAI,CAACF,SAASC,KAAKE,MAAM,KAAK,GAAG;YAC/B;QACF;QAEA,MAAMC,MAAMH,KAAKI,IAAI,CAAC;QACtB,MAAMC,OAA0B;YAAEF;YAAKP;QAAM;QAC7C,EAACF,IAAAA,CAAAA,UAAAA,OAAM,CAACK,SAAAA,MAAM,YAAbL,IAAAA,OAAM,CAACK,OAAM,GAAK,EAAE,EAAEO,IAAI,CAACD;IAC9B;IAEA,OAAOX;AACT,EAAE"}

package/dist/base-entities/configuration-client/types.d.ts

@@ -0,0 +1,38 @@
+import { Effect } from 'effect/Effect';
+import { EntifixBuildError } from '../entifix-error/index.js';
+export type ConfigurationExtractMode = 'exact' | 'match' | 'compose';
+export interface ConfigurationClientGroup {
+    getNumber(key: string, extractMode?: ConfigurationExtractMode): Effect<number, EntifixBuildError>;
+    getString(key: string, extractMode?: ConfigurationExtractMode): Effect<string, EntifixBuildError>;
+    getDate(key: string, extractMode?: ConfigurationExtractMode): Effect<Date, EntifixBuildError>;
+    getArrayNumber(key: string, extractMode?: ConfigurationExtractMode): Effect<number[], EntifixBuildError>;
+    getArrayString(key: string, extractMode?: ConfigurationExtractMode): Effect<string[], EntifixBuildError>;
+    getArrayDate(key: string, extractMode?: ConfigurationExtractMode): Effect<Date[], EntifixBuildError>;
+    getOptionalNumber(key: string, extractMode?: ConfigurationExtractMode): Effect<number | undefined, EntifixBuildError>;
+    getOptionalString(key: string, extractMode?: ConfigurationExtractMode): Effect<string | undefined, EntifixBuildError>;
+    getOptionalDate(key: string, extractMode?: ConfigurationExtractMode): Effect<Date | undefined, EntifixBuildError>;
+    getOptionalArrayNumber(key: string, extractMode?: ConfigurationExtractMode): Effect<number[] | undefined, EntifixBuildError>;
+    getOptionalArrayString(key: string, extractMode?: ConfigurationExtractMode): Effect<string[] | undefined, EntifixBuildError>;
+    getOptionalArrayDate(key: string, extractMode?: ConfigurationExtractMode): Effect<Date[] | undefined, EntifixBuildError>;
+}
+export interface ConfigurationClient {
+    in(key: string): ConfigurationClientGroup;
+}
+export interface ConfigurationItem {
+    key: string;
+    value: unknown;
+    /**
+     * Marks the value as a credential — a connection password, a signing key.
+     *
+     * It travels with the item because the only place that knows is the
+     * configuration store's own `is_secret` column, while the place that must act
+     * on it is a service's `GET /api/config` introspection route, several hops
+     * away. Inferring it there from the key's *name* would be a guess, and the
+     * cost of guessing wrong is publishing a private key.
+     */
+    isSecret?: boolean;
+}
+export interface ConfigurationPlain {
+    [key: string]: ConfigurationItem[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/base-entities/configuration-client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/base-entities/configuration-client/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAErE,MAAM,WAAW,wBAAwB;IACvC,SAAS,CACP,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACrC,SAAS,CACP,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACrC,OAAO,CACL,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IACnC,cAAc,CACZ,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC;IACvC,cAAc,CACZ,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC;IACvC,YAAY,CACV,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,IAAI,EAAE,EAAE,iBAAiB,CAAC,CAAC;IACrC,iBAAiB,CACf,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACjD,iBAAiB,CACf,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACjD,eAAe,CACb,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,IAAI,GAAG,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAC/C,sBAAsB,CACpB,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,MAAM,EAAE,GAAG,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACnD,sBAAsB,CACpB,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,MAAM,EAAE,GAAG,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACnD,oBAAoB,CAClB,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,wBAAwB,GACrC,MAAM,CAAC,IAAI,EAAE,GAAG,SAAS,EAAE,iBAAiB,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,wBAAwB,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAAC;CACpC"}

package/dist/base-entities/configuration-client/types.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=types.js.map

package/dist/base-entities/configuration-client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/base-entities/configuration-client/types.ts"],"sourcesContent":["import { Effect } from 'effect/Effect';\n\nimport { EntifixBuildError } from '../entifix-error/index.js';\n\nexport type ConfigurationExtractMode = 'exact' | 'match' | 'compose';\n\nexport interface ConfigurationClientGroup {\n  getNumber(\n    key: string,\n    extractMode?: ConfigurationExtractMode,\n  ): Effect<number, EntifixBuildError>;\n  getString(\n    key: string,\n    extractMode?: ConfigurationExtractMode,\n  ): Effect<string, EntifixBuildError>;\n  getDate(\n    key: string,\n    extractMode?: ConfigurationExtractMode,\n  ): Effect<Date, EntifixBuildError>;\n  getArrayNumber(\n    key: string,\n    extractMode?: ConfigurationExtractMode,\n  ): Effect<number[], EntifixBuildError>;\n  getArrayString(\n    key: string,\n    extractMode?: ConfigurationExtractMode,\n  ): Effect<string[], EntifixBuildError>;\n  getArrayDate(\n    key: string,\n    extractMode?: ConfigurationExtractMode,\n  ): Effect<Date[], EntifixBuildError>;\n  getOptionalNumber(\n    key: string,\n    extractMode?: ConfigurationExtractMode,\n  ): Effect<number | undefined, EntifixBuildError>;\n  getOptionalString(\n    key: string,\n    extractMode?: ConfigurationExtractMode,\n  ): Effect<string | undefined, EntifixBuildError>;\n  getOptionalDate(\n    key: string,\n    extractMode?: ConfigurationExtractMode,\n  ): Effect<Date | undefined, EntifixBuildError>;\n  getOptionalArrayNumber(\n    key: string,\n    extractMode?: ConfigurationExtractMode,\n  ): Effect<number[] | undefined, EntifixBuildError>;\n  getOptionalArrayString(\n    key: string,\n    extractMode?: ConfigurationExtractMode,\n  ): Effect<string[] | undefined, EntifixBuildError>;\n  getOptionalArrayDate(\n    key: string,\n    extractMode?: ConfigurationExtractMode,\n  ): Effect<Date[] | undefined, EntifixBuildError>;\n}\n\nexport interface ConfigurationClient {\n  in(key: string): ConfigurationClientGroup;\n}\n\nexport interface ConfigurationItem {\n  key: string;\n  value: unknown;\n  /**\n   * Marks the value as a credential — a connection password, a signing key.\n   *\n   * It travels with the item because the only place that knows is the\n   * configuration store's own `is_secret` column, while the place that must act\n   * on it is a service's `GET /api/config` introspection route, several hops\n   * away. Inferring it there from the key's *name* would be a guess, and the\n   * cost of guessing wrong is publishing a private key.\n   */\n  isSecret?: boolean;\n}\n\nexport interface ConfigurationPlain {\n  [key: string]: ConfigurationItem[];\n}\n"],"names":[],"mappings":"AA4EA,WAEC"}

package/dist/base-entities/entifix-error/entifix-error.d.ts

@@ -0,0 +1,31 @@
+export declare abstract class EntifixError extends Error {
+    abstract readonly _tag: string;
+    readonly cause: Error | undefined;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, cause?: unknown, details?: Record<string, unknown>);
+}
+export declare class EntifixBuildError extends EntifixError {
+    _tag: string;
+}
+export declare class EntifixLogicError extends EntifixError {
+    _tag: string;
+}
+export declare class EntifixConnError extends EntifixError {
+    _tag: string;
+}
+/**
+ * A transaction/saga step failed (validate, execute, rollback, free) — distinct
+ * from a lock acquisition failure, which callers retry, and from a build error,
+ * which is the client's fault.
+ */
+export declare class EntifixTransactionError extends EntifixError {
+    _tag: string;
+}
+/**
+ * A resource could not be locked within the allowed retries/TTL — a contention
+ * signal callers surface as a `409`/`423`, not a `500`.
+ */
+export declare class EntifixLockError extends EntifixError {
+    _tag: string;
+}
+//# sourceMappingURL=entifix-error.d.ts.map

package/dist/base-entities/entifix-error/entifix-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entifix-error.d.ts","sourceRoot":"","sources":["../../../src/base-entities/entifix-error/entifix-error.ts"],"names":[],"mappings":"AAUA,8BAAsB,YAAa,SAAQ,KAAK;IAE9C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,SAAkB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAKzC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOpC;AAED,qBAAa,iBAAkB,SAAQ,YAAY;IAExC,IAAI,SAAuB;CAErC;AAED,qBAAa,iBAAkB,SAAQ,YAAY;IAExC,IAAI,SAAuB;CAErC;AAED,qBAAa,gBAAiB,SAAQ,YAAY;IAEvC,IAAI,SAAsB;CAEpC;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;IAE9C,IAAI,SAA6B;CAE3C;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAEvC,IAAI,SAAsB;CAEpC"}

package/dist/base-entities/entifix-error/entifix-error.js

@@ -0,0 +1,56 @@
+function assertCause(cause) {
+    if (cause instanceof Error) {
+        return cause;
+    } else if (cause && typeof cause === 'object' && 'message' in cause) {
+        return new Error(String(cause['message']));
+    }
+    return undefined;
+}
+export class EntifixError extends Error {
+    // #endregion properties
+    // #region constructors
+    constructor(message, cause, details){
+        super(message);
+        this.cause = assertCause(cause);
+        this.details = details;
+    }
+}
+export class EntifixBuildError extends EntifixError {
+    constructor(...args){
+        super(...args), // #region properties
+        this._tag = 'EntifixBuildError';
+    }
+}
+export class EntifixLogicError extends EntifixError {
+    constructor(...args){
+        super(...args), // #region properties
+        this._tag = 'EntifixLogicError';
+    }
+}
+export class EntifixConnError extends EntifixError {
+    constructor(...args){
+        super(...args), // #region properties
+        this._tag = 'EntifixConnError';
+    }
+}
+/**
+ * A transaction/saga step failed (validate, execute, rollback, free) — distinct
+ * from a lock acquisition failure, which callers retry, and from a build error,
+ * which is the client's fault.
+ */ export class EntifixTransactionError extends EntifixError {
+    constructor(...args){
+        super(...args), // #region properties
+        this._tag = 'EntifixTransactionError';
+    }
+}
+/**
+ * A resource could not be locked within the allowed retries/TTL — a contention
+ * signal callers surface as a `409`/`423`, not a `500`.
+ */ export class EntifixLockError extends EntifixError {
+    constructor(...args){
+        super(...args), // #region properties
+        this._tag = 'EntifixLockError';
+    }
+}
+
+//# sourceMappingURL=entifix-error.js.map

package/dist/base-entities/entifix-error/entifix-error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/base-entities/entifix-error/entifix-error.ts"],"sourcesContent":["function assertCause(cause: unknown): Error | undefined {\n  if (cause instanceof Error) {\n    return cause;\n  } else if (cause && typeof cause === 'object' && 'message' in cause) {\n    return new Error(String(cause['message']));\n  }\n\n  return undefined;\n}\n\nexport abstract class EntifixError extends Error {\n  // #region properties\n  abstract readonly _tag: string;\n  override readonly cause: Error | undefined;\n  readonly details?: Record<string, unknown>;\n  // #endregion properties\n\n  // #region constructors\n  constructor(\n    message: string,\n    cause?: unknown,\n    details?: Record<string, unknown>,\n  ) {\n    super(message);\n    this.cause = assertCause(cause);\n    this.details = details;\n  }\n  // #endregion constructors\n}\n\nexport class EntifixBuildError extends EntifixError {\n  // #region properties\n  override _tag = 'EntifixBuildError';\n  // #endregion properties\n}\n\nexport class EntifixLogicError extends EntifixError {\n  // #region properties\n  override _tag = 'EntifixLogicError';\n  // #endregion properties\n}\n\nexport class EntifixConnError extends EntifixError {\n  // #region properties\n  override _tag = 'EntifixConnError';\n  // #endregion properties\n}\n\n/**\n * A transaction/saga step failed (validate, execute, rollback, free) — distinct\n * from a lock acquisition failure, which callers retry, and from a build error,\n * which is the client's fault.\n */\nexport class EntifixTransactionError extends EntifixError {\n  // #region properties\n  override _tag = 'EntifixTransactionError';\n  // #endregion properties\n}\n\n/**\n * A resource could not be locked within the allowed retries/TTL — a contention\n * signal callers surface as a `409`/`423`, not a `500`.\n */\nexport class EntifixLockError extends EntifixError {\n  // #region properties\n  override _tag = 'EntifixLockError';\n  // #endregion properties\n}\n"],"names":["assertCause","cause","Error","String","undefined","EntifixError","message","details","EntifixBuildError","_tag","EntifixLogicError","EntifixConnError","EntifixTransactionError","EntifixLockError"],"mappings":"AAAA,SAASA,YAAYC,KAAc;IACjC,IAAIA,iBAAiBC,OAAO;QAC1B,OAAOD;IACT,OAAO,IAAIA,SAAS,OAAOA,UAAU,YAAY,aAAaA,OAAO;QACnE,OAAO,IAAIC,MAAMC,OAAOF,KAAK,CAAC,UAAU;IAC1C;IAEA,OAAOG;AACT;AAEA,OAAO,MAAeC,qBAAqBH;IAKzC,wBAAwB;IAExB,uBAAuB;IACvB,YACEI,OAAe,EACfL,KAAe,EACfM,OAAiC,CACjC;QACA,KAAK,CAACD;QACN,IAAI,CAACL,KAAK,GAAGD,YAAYC;QACzB,IAAI,CAACM,OAAO,GAAGA;IACjB;AAEF;AAEA,OAAO,MAAMC,0BAA0BH;;QAAhC,gBACL,qBAAqB;aACZI,OAAO;;AAElB;AAEA,OAAO,MAAMC,0BAA0BL;;QAAhC,gBACL,qBAAqB;aACZI,OAAO;;AAElB;AAEA,OAAO,MAAME,yBAAyBN;;QAA/B,gBACL,qBAAqB;aACZI,OAAO;;AAElB;AAEA;;;;CAIC,GACD,OAAO,MAAMG,gCAAgCP;;QAAtC,gBACL,qBAAqB;aACZI,OAAO;;AAElB;AAEA;;;CAGC,GACD,OAAO,MAAMI,yBAAyBR;;QAA/B,gBACL,qBAAqB;aACZI,OAAO;;AAElB"}

package/dist/base-entities/entifix-error/index.d.ts

@@ -0,0 +1,2 @@
+export * from './entifix-error.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/base-entities/entifix-error/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/base-entities/entifix-error/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/base-entities/entifix-error/index.js

@@ -0,0 +1,3 @@
+export * from './entifix-error.js';
+
+//# sourceMappingURL=index.js.map

package/dist/base-entities/entifix-error/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/base-entities/entifix-error/index.ts"],"sourcesContent":["export * from './entifix-error.js';\n"],"names":[],"mappings":"AAAA,cAAc,qBAAqB"}

package/dist/command-palette/command-matching.d.ts

@@ -0,0 +1,79 @@
+import type { CommandOption } from './command-source.js';
+/**
+ * Normalize a string for matching: case-folded, and with accents removed.
+ *
+ * ⚠️ The accent fold is correctness, not polish. The fleet ships Spanish as its
+ * default locale, and without it `categoria` does not match `Categoría`, `marron`
+ * does not match `Marrón`, and `articulo` does not match `Artículo` — so the
+ * palette silently finds nothing for the most natural way to type most of its
+ * own copy. Nobody reaches for the accented key in a search box.
+ *
+ * NFD splits a precomposed letter into its base plus a combining mark, and the
+ * `\p{Diacritic}` class is what then removes only the mark. `ñ` decomposes too,
+ * so `nino` matches `Niño` — which is what a person typing quickly wants, even
+ * though ñ is a letter of its own in Spanish rather than an accented n.
+ */
+export declare function foldForMatch(text: string): string;
+/**
+ * Does `text` contain every character of `term`, in order?
+ *
+ * Subsequence rather than substring, so `prbr` finds "Producto Bruto" and `numa`
+ * finds "Nueva marca" — the thing that makes a palette feel fast. Deliberately
+ * **not** scored: ADR 0040 fixed group order as the ranking, and a score inside
+ * a group would reshuffle it on every keystroke for no gain a person can learn.
+ *
+ * An empty term matches everything, which is what makes an unfiltered palette
+ * the same code path as a filtered one.
+ */
+export declare function subsequenceMatch(term: string, text: string): boolean;
+/**
+ * Does this option answer to `term`, by its label or by any of its keywords?
+ *
+ * The keywords are what let a Spanish command match an English word someone
+ * typed — "Nuevo producto" answering to `new` — without translating the label.
+ */
+export declare function matchesCommand(term: string, option: CommandOption): boolean;
+/**
+ * Split a catalog-resolved keyword list into terms.
+ *
+ * `MetaUseCase.keywordsKey` is a catalog **key** rather than a `string[]` so the
+ * terms are per-locale; what the catalog holds is therefore one string, and this
+ * is the convention for reading it. Commas, because a keyword may itself be two
+ * words ("cerrar sesión") and splitting on whitespace would break that into
+ * terms that match nothing on their own.
+ *
+ * Empty entries are dropped rather than kept as `''`, which would match every
+ * option through {@link subsequenceMatch}'s empty-term rule.
+ */
+export declare function parseKeywords(value: string | undefined): string[];
+/** Which sources a typed term is asking for. */
+export type CommandScope = 'all' | 'commands' | 'records';
+/** A term, split into the scope its prefix asked for and the rest. */
+export interface ParsedCommandTerm {
+    readonly scope: CommandScope;
+    readonly term: string;
+}
+/**
+ * `>` narrows to commands, `#` to records, anything else searches both.
+ *
+ * A grammar for *entry* rather than for depth: descending into a sub-picker is a
+ * page stack, not a third prefix, because a prefix a person has to remember is
+ * worse than a list they can see. Two characters only, and both are the ones
+ * VS Code and GitHub already trained people on.
+ *
+ * The prefix is stripped and the remainder trimmed at the front only — a
+ * trailing space is something the person is still typing, and eating it would
+ * make the list jump between keystrokes.
+ */
+export declare function parseCommandTerm(raw: string): ParsedCommandTerm;
+/**
+ * The one thing selecting an option does.
+ *
+ * An option declaring none is a line that looks selectable and does nothing;
+ * one declaring two is a line whose behaviour depends on the order a renderer
+ * happens to check its members in. Both are silent, so this throws — at the
+ * first render of the palette rather than on the click, which is the posture
+ * `surfaceFor` and `assertSearchable` already take for the same reason.
+ */
+export declare function commandEffectOf(option: CommandOption): 'href' | 'run' | 'push';
+//# sourceMappingURL=command-matching.d.ts.map

package/dist/command-palette/command-matching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-matching.d.ts","sourceRoot":"","sources":["../../src/command-palette/command-matching.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAWpE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAK3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAMjE;AAED,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,CAAC;AAE1D,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAQ/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,GACpB,MAAM,GAAG,KAAK,GAAG,MAAM,CAezB"}