@uns-kit/core 2.0.20 → 2.0.22

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2023 Aljoša Vister
-
-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.
+MIT License
+
+Copyright (c) 2023 Aljoša Vister
+
+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

@@ -1,130 +1,130 @@
-# @uns-kit/core
-
-Core utilities and runtime building blocks for building Unified Namespace (UNS) realtime transformers. The package bundles the process lifecycle manager, MQTT integrations, gRPC gateway helpers, configuration tooling, and shared type definitions that power the UNS ecosystem.
-
-Note: Apps built with uns-kit are intended to be managed by the **UNS Datahub controller**.
-
-## uns-kit in context
-
-uns-kit is a batteries-included toolkit for Unified Namespace applications. It standardizes MQTT wiring, auth, config schemas, and scaffolding so teams can focus on domain logic instead of boilerplate. This package is the foundation; the full toolkit includes:
-
-| Package | Description |
-| --- | --- |
-| [`@uns-kit/core`](https://github.com/uns-datahub/uns-kit/tree/main/packages/uns-core) | Base runtime utilities (UnsProxyProcess, MQTT helpers, configuration tooling, gRPC gateway support). |
-| [`@uns-kit/api`](https://github.com/uns-datahub/uns-kit/tree/main/packages/uns-api) | Express plugin that exposes HTTP endpoints, handles JWT/JWKS auth, and republishes API metadata to UNS. |
-| [`@uns-kit/cron`](https://github.com/uns-datahub/uns-kit/tree/main/packages/uns-cron) | Cron-driven scheduler that emits UNS events on a fixed cadence. |
-| [`@uns-kit/temporal`](https://github.com/uns-datahub/uns-kit/tree/main/packages/uns-temporal) | Temporal.io integration that wires workflows into UnsProxyProcess. |
-| [`@uns-kit/cli`](https://github.com/uns-datahub/uns-kit/tree/main/packages/uns-cli) | Command line tool for scaffolding new UNS applications. |
-
-## Installation
-
-```bash
-pnpm add @uns-kit/core
-# or
-npm install @uns-kit/core
-```
-
-## Key Features
-
-- **UnsProxyProcess** – plugin-ready runtime for managing UNS proxy instances and MQTT wiring.
-- **MQTT helpers** – resilient publishers, topic builders, throttled queues, and handover support.
-- **Configuration utilities** – Zod-powered config schema generation and secret resolution helpers.
-- **gRPC gateway helpers** – infrastructure to bridge Python workers into the UNS message fabric.
-- **GraphQL tooling** – utilities such as `refresh-uns` that rebuild UNS topic/tag unions from your environment.
-
-## Usage
-
-Most projects start by creating an `UnsProxyProcess` and registering plugins:
-
-```ts
-import UnsProxyProcess from "@uns-kit/core/uns/uns-proxy-process";
-
-const process = new UnsProxyProcess("mqtt-broker.svc:1883", { processName: "my-rtt" });
-```
-
-See the individual plugin packages (`@uns-kit/cron`, `@uns-kit/api`, `@uns-kit/temporal`) for examples on extending the process with runtime capabilities.
-For a list of topics published by core (and the API plugin), see `../../docs/uns-topics.md`.
-
-### Refresh UNS topic/tag/attribute unions
-
-The package ships a CLI tool that regenerates strongly-typed UNS topics and tags based on the live GraphQL schema:
-
-```bash
-pnpm run refresh-uns
-```
-
-When configured via `uns-kit configure-codegen`, this script lives in your project `package.json` and writes into `src/uns/` (topics, tags, and attribute summaries for IntelliSense).
-
-### Generate UNS dictionary (object types & attributes with descriptions)
-
-Use `packages/uns-core/src/tools/generate-uns-dictionary.ts` to turn a JSON dictionary into a TypeScript helper. No network or GraphQL calls are involved.
-
-```bash
-pnpm tsx packages/uns-core/src/tools/generate-uns-dictionary.ts \ 
-  --input uns-dictionary.json \            # base JSON
-  --output src/uns/uns-dictionary.generated.ts \ 
-  --lang sl                                # pick language code from descriptions
-```
-
-- Reads the provided JSON and emits TypeScript constants, description maps, and helper getters for IntelliSense and metadata emission.
-
-To generate both dictionary and measurements in one step, use the wrapper:
-
-```bash
-pnpm tsx packages/uns-core/src/tools/generate-uns-reference.ts \
-  --dictionary uns-dictionary.json \
-  --dictionary-output src/uns/uns-dictionary.generated.ts \
-  --measurements uns-measurements.json \
-  --measurements-output src/uns/uns-measurements.generated.ts \
-  --lang sl
-```
-
-### Sync canonical UNS schema from the controller
-
-Use `sync-uns-schema` when you need to refresh the repo-maintained schema files from
-the controller’s REST export endpoints.
-
-```bash
-pnpm run sync-uns-schema -- \
-  --controller-url http://localhost:3200 \
-  --token <bearer-token>
-```
-
-- Uses `GET /api/schema/export/uns-dictionary?status=...` and `GET /api/schema/export/uns-measurements`.
-- Sends `Authorization: Bearer <token>`.
-- Preserves the full exported JSON document when updating:
-  - `packages/uns-cli/templates/uns-dictionary/uns-dictionary.json`
-  - `packages/uns-cli/templates/uns-measurements/uns-measurements.json`
-- Regenerates the local TS artifacts unless you pass `--skip-generate`.
-- Defaults dictionary sync to `--status active`.
-- Supports environment fallbacks: `UNS_CONTROLLER_URL`, `UNS_CONTROLLER_TOKEN`, `UNS_SCHEMA_STATUS`.
-
-Useful variants:
-
-```bash
-pnpm run sync-uns-schema -- --dry-run
-pnpm run sync-uns-schema -- --dictionary-only
-pnpm run sync-uns-schema -- --measurements-only --skip-generate
-```
-
-### Infisical secret resolution in development
-
-- The resolver looks for `SecretResolverOptions.infisical.fetchSecret`, then `INFISICAL_TOKEN`/`INFISICAL_PERSONAL_TOKEN`, then `/run/secrets/infisical_token` (or `/var/lib/uns/secrets/infisical_token`).
-- If no fetcher/token is available, the resolver now logs a warning and returns the placeholder `default`, or `undefined` when `optional: true`; required secrets still trigger `onMissingSecret` before throwing.
-- If Infisical is configured but the host is unreachable (e.g., DNS/network failure), the resolver warns and falls back to the same `default`/`optional` handling, reusing a cached value when present; required secrets throw with the original error message.
-- To inspect what would be used, call `resolveInfisicalConfig()` to get `{ token, projectId, siteUrl }` via the same lookup rules.
-- Use this to run locally without Infisical: mark dev-only secrets as `optional` or give `default` values, and provide real tokens only in production.
-
-## Development
-
-```bash
-# Lint and type-check the sources
-pnpm run typecheck
-
-# Emit JavaScript and declaration files to dist/
-pnpm run build
-```
-
-## License
-
-MIT © Aljoša Vister
+# @uns-kit/core
+
+Core utilities and runtime building blocks for building Unified Namespace (UNS) realtime transformers. The package bundles the process lifecycle manager, MQTT integrations, gRPC gateway helpers, configuration tooling, and shared type definitions that power the UNS ecosystem.
+
+Note: Apps built with uns-kit are intended to be managed by the **UNS Datahub controller**.
+
+## uns-kit in context
+
+uns-kit is a batteries-included toolkit for Unified Namespace applications. It standardizes MQTT wiring, auth, config schemas, and scaffolding so teams can focus on domain logic instead of boilerplate. This package is the foundation; the full toolkit includes:
+
+| Package | Description |
+| --- | --- |
+| [`@uns-kit/core`](https://github.com/uns-datahub/uns-kit/tree/main/packages/uns-core) | Base runtime utilities (UnsProxyProcess, MQTT helpers, configuration tooling, gRPC gateway support). |
+| [`@uns-kit/api`](https://github.com/uns-datahub/uns-kit/tree/main/packages/uns-api) | Express plugin that exposes HTTP endpoints, handles JWT/JWKS auth, and republishes API metadata to UNS. |
+| [`@uns-kit/cron`](https://github.com/uns-datahub/uns-kit/tree/main/packages/uns-cron) | Cron-driven scheduler that emits UNS events on a fixed cadence. |
+| [`@uns-kit/temporal`](https://github.com/uns-datahub/uns-kit/tree/main/packages/uns-temporal) | Temporal.io integration that wires workflows into UnsProxyProcess. |
+| [`@uns-kit/cli`](https://github.com/uns-datahub/uns-kit/tree/main/packages/uns-cli) | Command line tool for scaffolding new UNS applications. |
+
+## Installation
+
+```bash
+pnpm add @uns-kit/core
+# or
+npm install @uns-kit/core
+```
+
+## Key Features
+
+- **UnsProxyProcess** – plugin-ready runtime for managing UNS proxy instances and MQTT wiring.
+- **MQTT helpers** – resilient publishers, topic builders, throttled queues, and handover support.
+- **Configuration utilities** – Zod-powered config schema generation and secret resolution helpers.
+- **gRPC gateway helpers** – infrastructure to bridge Python workers into the UNS message fabric.
+- **GraphQL tooling** – utilities such as `refresh-uns` that rebuild UNS topic/tag unions from your environment.
+
+## Usage
+
+Most projects start by creating an `UnsProxyProcess` and registering plugins:
+
+```ts
+import UnsProxyProcess from "@uns-kit/core/uns/uns-proxy-process";
+
+const process = new UnsProxyProcess("mqtt-broker.svc:1883", { processName: "my-rtt" });
+```
+
+See the individual plugin packages (`@uns-kit/cron`, `@uns-kit/api`, `@uns-kit/temporal`) for examples on extending the process with runtime capabilities.
+For a list of topics published by core (and the API plugin), see `../../docs/uns-topics.md`.
+
+### Refresh UNS topic/tag/attribute unions
+
+The package ships a CLI tool that regenerates strongly-typed UNS topics and tags based on the live GraphQL schema:
+
+```bash
+pnpm run refresh-uns
+```
+
+When configured via `uns-kit configure-codegen`, this script lives in your project `package.json` and writes into `src/uns/` (topics, tags, and attribute summaries for IntelliSense).
+
+### Generate UNS dictionary (object types & attributes with descriptions)
+
+Use `packages/uns-core/src/tools/generate-uns-dictionary.ts` to turn a JSON dictionary into a TypeScript helper. No network or GraphQL calls are involved.
+
+```bash
+pnpm tsx packages/uns-core/src/tools/generate-uns-dictionary.ts \ 
+  --input uns-dictionary.json \            # base JSON
+  --output src/uns/uns-dictionary.generated.ts \ 
+  --lang sl                                # pick language code from descriptions
+```
+
+- Reads the provided JSON and emits TypeScript constants, description maps, and helper getters for IntelliSense and metadata emission.
+
+To generate both dictionary and measurements in one step, use the wrapper:
+
+```bash
+pnpm tsx packages/uns-core/src/tools/generate-uns-reference.ts \
+  --dictionary uns-dictionary.json \
+  --dictionary-output src/uns/uns-dictionary.generated.ts \
+  --measurements uns-measurements.json \
+  --measurements-output src/uns/uns-measurements.generated.ts \
+  --lang sl
+```
+
+### Sync canonical UNS schema from the controller
+
+Use `sync-uns-schema` when you need to refresh the repo-maintained schema files from
+the controller’s REST export endpoints.
+
+```bash
+pnpm run sync-uns-schema -- \
+  --controller-url http://localhost:3200 \
+  --token <bearer-token>
+```
+
+- Uses `GET /api/schema/export/uns-dictionary?status=...` and `GET /api/schema/export/uns-measurements`.
+- Sends `Authorization: Bearer <token>`.
+- Preserves the full exported JSON document when updating:
+  - `packages/uns-cli/templates/uns-dictionary/uns-dictionary.json`
+  - `packages/uns-cli/templates/uns-measurements/uns-measurements.json`
+- Regenerates the local TS artifacts unless you pass `--skip-generate`.
+- Defaults dictionary sync to `--status active`.
+- Supports environment fallbacks: `UNS_CONTROLLER_URL`, `UNS_CONTROLLER_TOKEN`, `UNS_SCHEMA_STATUS`.
+
+Useful variants:
+
+```bash
+pnpm run sync-uns-schema -- --dry-run
+pnpm run sync-uns-schema -- --dictionary-only
+pnpm run sync-uns-schema -- --measurements-only --skip-generate
+```
+
+### Infisical secret resolution in development
+
+- The resolver looks for `SecretResolverOptions.infisical.fetchSecret`, then `INFISICAL_TOKEN`/`INFISICAL_PERSONAL_TOKEN`, then `/run/secrets/infisical_token` (or `/var/lib/uns/secrets/infisical_token`).
+- If no fetcher/token is available, the resolver now logs a warning and returns the placeholder `default`, or `undefined` when `optional: true`; required secrets still trigger `onMissingSecret` before throwing.
+- If Infisical is configured but the host is unreachable (e.g., DNS/network failure), the resolver warns and falls back to the same `default`/`optional` handling, reusing a cached value when present; required secrets throw with the original error message.
+- To inspect what would be used, call `resolveInfisicalConfig()` to get `{ token, projectId, siteUrl }` via the same lookup rules.
+- Use this to run locally without Infisical: mark dev-only secrets as `optional` or give `default` values, and provide real tokens only in production.
+
+## Development
+
+```bash
+# Lint and type-check the sources
+pnpm run typecheck
+
+# Emit JavaScript and declaration files to dist/
+pnpm run build
+```
+
+## License
+
+MIT © Aljoša Vister

package/dist/app-config.d.ts.map

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

package/dist/app-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.js","sourceRoot":"","sources":["../src/app-config.ts"],"names":[],"mappings":"","sourcesContent":["/* Auto-generated. Do not edit by hand. */\r\nexport type AppConfig = {\r\n    uns: {\r\n        graphql: string;\r\n        rest: string;\r\n        instanceMode?: \"wait\" | \"force\" | \"handover\";\r\n        processName?: string | undefined;\r\n        handover?: boolean;\r\n        jwksWellKnownUrl?: string | undefined;\r\n        kidWellKnownUrl?: string | undefined;\r\n        env?: \"dev\" | \"staging\" | \"test\" | \"prod\";\r\n    };\r\n    input?: {\r\n        host: string | ({\r\n            /** Use the supplied host or IP address. */\r\n            provider: \"inline\";\r\n            /** Host or IP address that should be used directly. */\r\n            value: string;\r\n        } | {\r\n            /** Resolve the host from an external mapping. */\r\n            provider: \"external\";\r\n            /** Identifier used when resolving the host from HostResolverOptions. */\r\n            key: string;\r\n            /** Allow the external host to be missing without throwing during resolution. */\r\n            optional?: boolean | undefined;\r\n            /** Fallback host when optional is true and the external entry is missing. */\r\n            default?: string | undefined;\r\n        } | {\r\n            /** Resolve the host from local network interfaces. */\r\n            provider: \"system\";\r\n            /** Address family to return when scanning interfaces. */\r\n            family?: \"IPv4\" | \"IPv6\";\r\n            /** Specific interface to read (falls back to the first match when omitted). */\r\n            interfaceName?: string | undefined;\r\n            /** Allow the interface lookup to fail without throwing during resolution. */\r\n            optional?: boolean | undefined;\r\n            /** Fallback host/IP when optional is true and no interface matches. */\r\n            default?: string | undefined;\r\n        });\r\n        username?: string | undefined;\r\n        password?: (string | ({\r\n            /** Load the secret from an environment variable. */\r\n            provider: \"env\";\r\n            /** Name of the environment variable to read. */\r\n            key: string;\r\n            /** Allow the variable to be absent without throwing during resolution. */\r\n            optional?: boolean | undefined;\r\n            /** Fallback value when optional is true and the variable is missing. */\r\n            default?: string | undefined;\r\n        } | {\r\n            /** Load the secret from Infisical. */\r\n            provider: \"infisical\";\r\n            /** Secret folder path in Infisical, e.g. '/app/database'. */\r\n            path: string;\r\n            /** Secret key/name inside the given path. */\r\n            key: string;\r\n            /** Allow the secret to be absent without throwing during resolution. */\r\n            optional?: boolean | undefined;\r\n            /** Infisical environment override (defaults to current mode if omitted). */\r\n            environment?: string | undefined;\r\n            /** Optional Infisical project identifier when not using the default. */\r\n            projectId?: string | undefined;\r\n            /** Fallback value when the secret is missing and optional resolution is allowed. */\r\n            default?: string | undefined;\r\n        })) | undefined;\r\n        clientId?: string | undefined;\r\n    } | undefined;\r\n    output?: {\r\n        host: string | ({\r\n            /** Use the supplied host or IP address. */\r\n            provider: \"inline\";\r\n            /** Host or IP address that should be used directly. */\r\n            value: string;\r\n        } | {\r\n            /** Resolve the host from an external mapping. */\r\n            provider: \"external\";\r\n            /** Identifier used when resolving the host from HostResolverOptions. */\r\n            key: string;\r\n            /** Allow the external host to be missing without throwing during resolution. */\r\n            optional?: boolean | undefined;\r\n            /** Fallback host when optional is true and the external entry is missing. */\r\n            default?: string | undefined;\r\n        } | {\r\n            /** Resolve the host from local network interfaces. */\r\n            provider: \"system\";\r\n            /** Address family to return when scanning interfaces. */\r\n            family?: \"IPv4\" | \"IPv6\";\r\n            /** Specific interface to read (falls back to the first match when omitted). */\r\n            interfaceName?: string | undefined;\r\n            /** Allow the interface lookup to fail without throwing during resolution. */\r\n            optional?: boolean | undefined;\r\n            /** Fallback host/IP when optional is true and no interface matches. */\r\n            default?: string | undefined;\r\n        });\r\n        username?: string | undefined;\r\n        password?: (string | ({\r\n            /** Load the secret from an environment variable. */\r\n            provider: \"env\";\r\n            /** Name of the environment variable to read. */\r\n            key: string;\r\n            /** Allow the variable to be absent without throwing during resolution. */\r\n            optional?: boolean | undefined;\r\n            /** Fallback value when optional is true and the variable is missing. */\r\n            default?: string | undefined;\r\n        } | {\r\n            /** Load the secret from Infisical. */\r\n            provider: \"infisical\";\r\n            /** Secret folder path in Infisical, e.g. '/app/database'. */\r\n            path: string;\r\n            /** Secret key/name inside the given path. */\r\n            key: string;\r\n            /** Allow the secret to be absent without throwing during resolution. */\r\n            optional?: boolean | undefined;\r\n            /** Infisical environment override (defaults to current mode if omitted). */\r\n            environment?: string | undefined;\r\n            /** Optional Infisical project identifier when not using the default. */\r\n            projectId?: string | undefined;\r\n            /** Fallback value when the secret is missing and optional resolution is allowed. */\r\n            default?: string | undefined;\r\n        })) | undefined;\r\n        clientId?: string | undefined;\r\n    } | undefined;\r\n    infra: {\r\n        host: string | ({\r\n            /** Use the supplied host or IP address. */\r\n            provider: \"inline\";\r\n            /** Host or IP address that should be used directly. */\r\n            value: string;\r\n        } | {\r\n            /** Resolve the host from an external mapping. */\r\n            provider: \"external\";\r\n            /** Identifier used when resolving the host from HostResolverOptions. */\r\n            key: string;\r\n            /** Allow the external host to be missing without throwing during resolution. */\r\n            optional?: boolean | undefined;\r\n            /** Fallback host when optional is true and the external entry is missing. */\r\n            default?: string | undefined;\r\n        } | {\r\n            /** Resolve the host from local network interfaces. */\r\n            provider: \"system\";\r\n            /** Address family to return when scanning interfaces. */\r\n            family?: \"IPv4\" | \"IPv6\";\r\n            /** Specific interface to read (falls back to the first match when omitted). */\r\n            interfaceName?: string | undefined;\r\n            /** Allow the interface lookup to fail without throwing during resolution. */\r\n            optional?: boolean | undefined;\r\n            /** Fallback host/IP when optional is true and no interface matches. */\r\n            default?: string | undefined;\r\n        });\r\n        username?: string | undefined;\r\n        password?: (string | ({\r\n            /** Load the secret from an environment variable. */\r\n            provider: \"env\";\r\n            /** Name of the environment variable to read. */\r\n            key: string;\r\n            /** Allow the variable to be absent without throwing during resolution. */\r\n            optional?: boolean | undefined;\r\n            /** Fallback value when optional is true and the variable is missing. */\r\n            default?: string | undefined;\r\n        } | {\r\n            /** Load the secret from Infisical. */\r\n            provider: \"infisical\";\r\n            /** Secret folder path in Infisical, e.g. '/app/database'. */\r\n            path: string;\r\n            /** Secret key/name inside the given path. */\r\n            key: string;\r\n            /** Allow the secret to be absent without throwing during resolution. */\r\n            optional?: boolean | undefined;\r\n            /** Infisical environment override (defaults to current mode if omitted). */\r\n            environment?: string | undefined;\r\n            /** Optional Infisical project identifier when not using the default. */\r\n            projectId?: string | undefined;\r\n            /** Fallback value when the secret is missing and optional resolution is allowed. */\r\n            default?: string | undefined;\r\n        })) | undefined;\r\n        clientId?: string | undefined;\r\n    };\r\n    devops?: {\r\n        provider?: string | undefined;\r\n        organization: string;\r\n        project?: string | undefined;\r\n    } | undefined;\r\n}\r\n"]}

package/dist/base-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-path.js","sourceRoot":"","sources":["../src/base-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEhE,MAAM,uBAAuB,GAAG,oBAAsF,CAAC;AAEvH,MAAM,YAAY,GAAG,CAAC,KAAa,EAAsB,EAAE;IACzD,IAAI,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAE7B,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,SAAkB,EAAsB,EAAE;IAClE,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAEjC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAErC,IAAI,OAAO,uBAAuB,KAAK,UAAU,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,uBAAuB,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;YAC3D,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/B,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;YAClD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/B,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sCAAsC;QACxC,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC;AAC9C,CAAC,CAAC;AAQF,MAAM,UAAU,eAAe,CAAC,UAAkC,EAAE;IAClE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAErG,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,WAAW,IAAI,SAAS,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC;IAE3E,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC","sourcesContent":["import { fileURLToPath } from \"url\";\nimport { dirname, resolve, join } from \"path\";\nimport { existsSync } from \"fs\";\nimport { packageDirectorySync } from \"pkg-dir\";\n\nconst moduleDirectory = dirname(fileURLToPath(import.meta.url));\n\nconst packageDirectorySyncAny = packageDirectorySync as unknown as ((arg?: unknown) => string | undefined) | undefined;\n\nconst fallbackFind = (start: string): string | undefined => {\n  let current = resolve(start);\n\n  while (true) {\n    if (existsSync(join(current, \"package.json\"))) {\n      return current;\n    }\n\n    const parent = dirname(current);\n    if (parent === current) {\n      return undefined;\n    }\n\n    current = parent;\n  }\n};\n\nconst resolveCandidate = (candidate?: string): string | undefined => {\n  if (!candidate) return undefined;\n\n  const directory = resolve(candidate);\n\n  if (typeof packageDirectorySyncAny === \"function\") {\n    try {\n      const result = packageDirectorySyncAny({ cwd: directory });\n      if (typeof result === \"string\") {\n        return result;\n      }\n    } catch {\n      // ignore – fall back to alternate invocation style\n    }\n\n    try {\n      const result = packageDirectorySyncAny(directory);\n      if (typeof result === \"string\") {\n        return result;\n      }\n    } catch {\n      // ignore – fall back to manual search\n    }\n  }\n\n  return fallbackFind(directory) ?? directory;\n};\n\nexport interface ResolveBasePathOptions {\n  start?: string;\n  envBasePath?: string | null;\n  cwd?: string;\n}\n\nexport function resolveBasePath(options: ResolveBasePathOptions = {}): string {\n  const { start, envBasePath = process.env.UNS_BASE_PATH ?? undefined, cwd = process.cwd() } = options;\n\n  const candidates = [start, envBasePath ?? undefined, cwd, moduleDirectory];\n\n  for (const candidate of candidates) {\n    const resolved = resolveCandidate(candidate);\n    if (resolved) {\n      return resolved;\n    }\n  }\n\n  return resolve(moduleDirectory, \"..\");\n}\n\nexport const basePath = resolveBasePath();\n"]}
+{"version":3,"file":"base-path.js","sourceRoot":"","sources":["../src/base-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEhE,MAAM,uBAAuB,GAAG,oBAAsF,CAAC;AAEvH,MAAM,YAAY,GAAG,CAAC,KAAa,EAAsB,EAAE;IACzD,IAAI,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAE7B,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,SAAkB,EAAsB,EAAE;IAClE,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAEjC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAErC,IAAI,OAAO,uBAAuB,KAAK,UAAU,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,uBAAuB,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;YAC3D,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/B,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;YAClD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/B,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sCAAsC;QACxC,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC;AAC9C,CAAC,CAAC;AAQF,MAAM,UAAU,eAAe,CAAC,UAAkC,EAAE;IAClE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAErG,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,WAAW,IAAI,SAAS,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC;IAE3E,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC","sourcesContent":["import { fileURLToPath } from \"url\";\r\nimport { dirname, resolve, join } from \"path\";\r\nimport { existsSync } from \"fs\";\r\nimport { packageDirectorySync } from \"pkg-dir\";\r\n\r\nconst moduleDirectory = dirname(fileURLToPath(import.meta.url));\r\n\r\nconst packageDirectorySyncAny = packageDirectorySync as unknown as ((arg?: unknown) => string | undefined) | undefined;\r\n\r\nconst fallbackFind = (start: string): string | undefined => {\r\n  let current = resolve(start);\r\n\r\n  while (true) {\r\n    if (existsSync(join(current, \"package.json\"))) {\r\n      return current;\r\n    }\r\n\r\n    const parent = dirname(current);\r\n    if (parent === current) {\r\n      return undefined;\r\n    }\r\n\r\n    current = parent;\r\n  }\r\n};\r\n\r\nconst resolveCandidate = (candidate?: string): string | undefined => {\r\n  if (!candidate) return undefined;\r\n\r\n  const directory = resolve(candidate);\r\n\r\n  if (typeof packageDirectorySyncAny === \"function\") {\r\n    try {\r\n      const result = packageDirectorySyncAny({ cwd: directory });\r\n      if (typeof result === \"string\") {\r\n        return result;\r\n      }\r\n    } catch {\r\n      // ignore – fall back to alternate invocation style\r\n    }\r\n\r\n    try {\r\n      const result = packageDirectorySyncAny(directory);\r\n      if (typeof result === \"string\") {\r\n        return result;\r\n      }\r\n    } catch {\r\n      // ignore – fall back to manual search\r\n    }\r\n  }\r\n\r\n  return fallbackFind(directory) ?? directory;\r\n};\r\n\r\nexport interface ResolveBasePathOptions {\r\n  start?: string;\r\n  envBasePath?: string | null;\r\n  cwd?: string;\r\n}\r\n\r\nexport function resolveBasePath(options: ResolveBasePathOptions = {}): string {\r\n  const { start, envBasePath = process.env.UNS_BASE_PATH ?? undefined, cwd = process.cwd() } = options;\r\n\r\n  const candidates = [start, envBasePath ?? undefined, cwd, moduleDirectory];\r\n\r\n  for (const candidate of candidates) {\r\n    const resolved = resolveCandidate(candidate);\r\n    if (resolved) {\r\n      return resolved;\r\n    }\r\n  }\r\n\r\n  return resolve(moduleDirectory, \"..\");\r\n}\r\n\r\nexport const basePath = resolveBasePath();\r\n"]}