@next-box/appsettings 0.0.0-stage → 0.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 miami-man
+
+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,3 +1,183 @@
-# Temporary Holding Version
+# @next-box/appsettings
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A type-safe configuration library for TypeScript applications, inspired by .NET's `appsettings.json`.
+
+[![npm version](https://badge.fury.io/js/%40next-box%2Fappsettings.svg)](https://badge.fury.io/js/%40next-box%2Fappsettings)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+Applications often need to combine configuration from defaults, files, and environment variables. Keeping those values consistent and validated across an application can be difficult.
+
+`@next-box/appsettings` loads and validates configuration on the server, then provides a read-only settings context for React client components.
+
+## Installation
+
+```shell
+# terminal
+npm add @next-box/appsettings
+```
+
+## Usage
+
+### Define a schema
+
+```ts
+// ./src/appSettings.schema.ts
+import { z } from 'zod';
+
+export const appSettingsSchema = z.object({
+  App: z.object({
+    Name: z.string(),
+    Environment: z.enum(['development', 'test', 'production']),
+  }),
+  Api: z.object({
+    BaseUrl: z.string().url(),
+    Timeout: z.number(),
+  }),
+  Features: z.object({
+    DarkMode: z.boolean(),
+    NewDashboard: z.boolean(),
+  }),
+});
+
+export type AppSettingsConfig = z.infer<typeof appSettingsSchema>;
+```
+
+### Load configuration on the server
+
+`createAppSettings` is exported from `@next-box/appsettings/server`. It merges defaults and sources in order, validates the complete result with the schema, and returns plain configuration data suitable for passing to a Client Component.
+
+```ts
+// ./src/appSettings.ts
+import { AppSettingsSource, createAppSettings, EnvironmentSource } from '@next-box/appsettings/server';
+import { appSettingsSchema } from './appSettings.schema';
+
+export const loadAppSettings = () =>
+  createAppSettings({
+    schema: appSettingsSchema,
+    defaults: {
+      App: { Name: 'My Application', Environment: 'development' },
+      Api: { BaseUrl: 'https://api.example.com', Timeout: 5000 },
+      Features: { DarkMode: true, NewDashboard: false },
+    },
+    sources: [
+      new AppSettingsSource({ directory: './config', environment: process.env.NODE_ENV }),
+      new EnvironmentSource({ envs: process.env, prefix: 'APP_' }),
+    ],
+  });
+```
+
+Defaults form the first layer; sources load sequentially in declaration order, with later sources overriding earlier values. Plain objects merge recursively. Arrays and primitive values are replaced. Inputs are not mutated. If loading or validation fails, `createAppSettings` rejects and does not return partial configuration.
+
+In Next.js, call the loader from a Server Component and pass the result to the provider:
+
+```tsx
+// ./app/layout.tsx
+import { AppSettingsProvider } from '@next-box/appsettings';
+import { loadAppSettings } from '../src/appSettings';
+
+export default async function RootLayout({ children }: { children: React.ReactNode }) {
+  const settings = await loadAppSettings();
+
+  return (
+    <html lang="en">
+      <body>
+        <AppSettingsProvider settings={settings}>{children}</AppSettingsProvider>
+      </body>
+    </html>
+  );
+}
+```
+
+The provider creates a read-only in-memory settings instance from the supplied data. Client components do not load files, validate configuration, or reload settings.
+
+### Configure server sources
+
+The `@next-box/appsettings/server` entry provides source classes. Pass instances to `createAppSettings` in the order they should be applied:
+
+- `new AppSettingsSource({ directory, environment })` reads `appsettings.json` followed by `appsettings.{environment}.json` from the filesystem. The environment file is optional and overrides matching values from the base file. If `environment` is omitted, it uses `NODE_ENV` and defaults to `development`.
+- `new EnvironmentSource({ envs, prefix })` maps the provided environment variable record into nested settings. Pass `process.env` for Node's environment or a separate record for controlled use.
+- `new RemoteSource({ url, fetch, responsePath })` fetches JSON from a URL. `fetch` is required; `responsePath` optionally selects a nested object from the response.
+- `new MemorySource({ values })` supplies in-memory values, useful for additional overrides.
+
+Environment keys after the prefix use `__` as a nesting separator. For example, `APP_API__TIMEOUT` maps to `Api.Timeout`. Exact `true`, `false`, and numeric strings are converted to booleans and numbers; other values remain strings.
+
+For example, these sources can be combined in one configuration:
+
+```ts
+import {
+  AppSettingsSource,
+  EnvironmentSource,
+  MemorySource,
+  RemoteSource,
+  createAppSettings,
+} from '@next-box/appsettings/server';
+
+const settings = await createAppSettings({
+  schema: appSettingsSchema,
+  defaults: {
+    App: { Name: 'My Application', Environment: 'development' },
+    Api: { BaseUrl: 'https://api.example.com', Timeout: 5000 },
+    Features: { DarkMode: true, NewDashboard: false },
+  },
+  sources: [
+    new AppSettingsSource({ directory: './config' }),
+    new RemoteSource({ url: 'https://config.example.com/appsettings.json', fetch }),
+    new EnvironmentSource({ envs: process.env, prefix: 'APP_' }),
+    new MemorySource({ values: { Features: { NewDashboard: true } } }),
+  ],
+});
+```
+
+Each later source overrides earlier values according to the merge rules described above. The resulting settings object can be passed to `AppSettingsProvider`.
+
+### Read settings
+
+Paths use dot notation. `useAppSetting` reads a leaf value and `useAppSettings` reads an object section:
+
+```tsx
+// ./src/ApiTimeout.tsx
+'use client';
+
+import { useAppSetting, useAppSettings } from '@next-box/appsettings';
+
+export const ApiTimeout = () => {
+  const timeout = useAppSetting('Api.Timeout');
+  const features = useAppSettings('Features');
+
+  return <span>{features?.DarkMode ? timeout : 'Disabled'}</span>;
+};
+```
+
+The settings snapshot is read-only. Configuration is loaded and validated before it reaches the provider; there are no client-side mutation or reload methods.
+
+Leaf paths and their values are checked against the inferred schema. The reader uses bounded nested path types and `type-fest`'s `Get<T, P>` for path value types.
+
+React context cannot infer the settings type from a provider at a separate hook call site. Generate a module augmentation from the exported schema type:
+
+```shell
+pnpm exec appsettings generate-types ./src/appSettings.schema.ts ./src/appSettings.generated.d.ts --type AppSettingsConfig
+```
+
+The command writes a declaration that imports `AppSettingsConfig` and augments the package's `AppSettingsSchema`. TypeScript then infers each hook result from the value type at the end of its path. Zod enums and literals stay precise, while `z.string()` and `z.number()` remain broad types. The declaration only provides types; configuration still loads and validates on the server.
+
+Run the command after changing the schema, or add it to the consuming application's `predev`, `prebuild`, and type-check scripts so the declaration stays current. The generated file must be included by the application's `tsconfig.json`.
+
+### Conditionally render with `Setting`
+
+`Setting` renders its children when the current value at `path` strictly equals `value`. Pass an array of expected values to match any one of them. It renders `fallback` when there is no match; `negate` inverts the match.
+
+```tsx
+import { Setting } from '@next-box/appsettings';
+
+<Setting path="Features.DarkMode" value={true} fallback={<p>Dark mode is off</p>}>
+  <p>Dark mode is on</p>
+</Setting>
+```
+
+## Changelog
+
+Check out the [features, fixes and more](../../CHANGELOG.md) that go into each major, minor and patch version.
+
+## License
+
+`@next-box/appsettings` is [MIT Licensed](LICENSE).

package/bin/appsettings.mjs

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+
+// Is unresolved before library has been built.
+// eslint-disable-next-line import-x/no-unresolved
+import { runAppsettingsCli } from '@next-box/appsettings/cli';
+
+await runAppsettingsCli();

package/dist/cjs/cli/command.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("./handler.cjs");exports.handler=e.handler,exports.builder=e=>e.positional("schema",{demandOption:!0,describe:"TypeScript module that exports the inferred settings type.",type:"string"}).positional("output",{default:"appsettings.generated.d.ts",describe:"Declaration file to generate.",type:"string"}).option("type",{default:"AppSettingsConfig",describe:"Exported type name.",type:"string"}).check(({type:e})=>{if(!/^[A-Za-z_$][\w$]*$/u.test(e))throw new Error("--type must be a TypeScript identifier.");return!0}),exports.command="generate-types <schema> <output>",exports.describe="Generate a declaration that types appsettings hooks from your schema.";
+//# sourceMappingURL=command.cjs.map

package/dist/cjs/cli/command.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.cjs","sources":["../../../src/cli/command.ts"],"sourcesContent":["import { type CommandBuilder } from 'yargs';\nimport { type GenerateTypesArguments } from '#cli/handler.ts';\n\nexport const builder: CommandBuilder<object, GenerateTypesArguments> = yargs =>\n  yargs\n    .positional('schema', {\n      demandOption: true,\n      describe: 'TypeScript module that exports the inferred settings type.',\n      type: 'string',\n    })\n    .positional('output', {\n      default: 'appsettings.generated.d.ts',\n      describe: 'Declaration file to generate.',\n      type: 'string',\n    })\n    .option('type', {\n      default: 'AppSettingsConfig',\n      describe: 'Exported type name.',\n      type: 'string',\n    })\n    .check(({ type }) => {\n      if (!/^[A-Za-z_$][\\w$]*$/u.test(type)) {\n        throw new Error('--type must be a TypeScript identifier.');\n      }\n\n      return true;\n    });\n\nexport const command = 'generate-types <schema> <output>';\n\nexport const describe = 'Generate a declaration that types appsettings hooks from your schema.';\n\nexport { handler } from './handler.ts';\n"],"names":["yargs","positional","demandOption","describe","type","default","option","check","test","Error"],"mappings":"sFAGuEA,GACrEA,EACGC,WAAW,SAAU,CACpBC,cAAc,EACdC,SAAU,6DACVC,KAAM,WAEPH,WAAW,SAAU,CACpBI,QAAS,6BACTF,SAAU,gCACVC,KAAM,WAEPE,OAAO,OAAQ,CACdD,QAAS,oBACTF,SAAU,sBACVC,KAAM,WAEPG,MAAM,EAAGH,WACR,IAAK,sBAAsBI,KAAKJ,GAC9B,MAAM,IAAIK,MAAM,2CAGlB,OAAO,oBAGU,oDAEC"}

package/dist/cjs/cli/handler.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("node:fs/promises"),t=require("node:path");exports.handler=async({output:r,schema:s,type:i})=>{const o=t.resolve(process.cwd(),s),a=t.resolve(process.cwd(),r),c=[`import type { ${i} } from '${(e=>{let r=e.split(t.sep).join("/").replace(/\.(?:[cm]?tsx?)$/u,"");return r.startsWith(".")||(r=`./${r}`),r})(t.relative(t.dirname(a),o))}';`,"","declare module '@next-box/appsettings' {",`  interface AppSettingsSchema extends ${i} {}`,"}","","export {};",""].join("\n");let p;try{p=await e.readFile(a,"utf8")}catch(e){if(!(e=>!!e&&"object"==typeof e&&"code"in e&&"ENOENT"===e.code)(e))throw e}p!==c&&(await e.mkdir(t.dirname(a),{recursive:!0}),await e.writeFile(a,c,"utf8")),process.stdout.write(`Generated ${t.relative(process.cwd(),a)}\n`)};
+//# sourceMappingURL=handler.cjs.map

package/dist/cjs/cli/handler.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.cjs","sources":["../../../src/cli/handler.ts"],"sourcesContent":["import { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { dirname, relative, resolve, sep } from 'node:path';\n\nconst createModuleSpecifier = (path: string): string => {\n  let specifier = path\n    .split(sep)\n    .join('/')\n    .replace(/\\.(?:[cm]?tsx?)$/u, '');\n\n  if (!specifier.startsWith('.')) {\n    specifier = `./${specifier}`;\n  }\n\n  return specifier;\n};\n\nconst isMissingFile = (error: unknown): boolean =>\n  !!error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT';\n\nexport interface GenerateTypesArguments {\n  output: string;\n  schema: string;\n  type: string;\n}\n\nexport const handler = async ({ output, schema, type }: GenerateTypesArguments): Promise<void> => {\n  const schemaPath = resolve(process.cwd(), schema);\n  const outputPath = resolve(process.cwd(), output);\n  const schemaImportPath = createModuleSpecifier(relative(dirname(outputPath), schemaPath));\n\n  const contents = [\n    `import type { ${type} } from '${schemaImportPath}';`,\n    '',\n    \"declare module '@next-box/appsettings' {\",\n    `  interface AppSettingsSchema extends ${type} {}`,\n    '}',\n    '',\n    'export {};',\n    '',\n  ].join('\\n');\n\n  let existingContents: string | undefined;\n\n  try {\n    existingContents = await readFile(outputPath, 'utf8');\n  } catch (error) {\n    if (!isMissingFile(error)) {\n      throw error;\n    }\n  }\n\n  if (existingContents !== contents) {\n    await mkdir(dirname(outputPath), { recursive: true });\n    await writeFile(outputPath, contents, 'utf8');\n  }\n\n  process.stdout.write(`Generated ${relative(process.cwd(), outputPath)}\\n`);\n};\n"],"names":["async","output","schema","type","schemaPath","resolve","process","cwd","outputPath","contents","path","specifier","split","sep","join","replace","startsWith","createModuleSpecifier","relative","dirname","existingContents","readFile","error","code","isMissingFile","mkdir","recursive","writeFile","stdout","write"],"mappings":"sFAyBuBA,OAASC,SAAQC,SAAQC,WAC9C,MAAMC,EAAaC,EAAAA,QAAQC,QAAQC,MAAOL,GACpCM,EAAaH,EAAAA,QAAQC,QAAQC,MAAON,GAGpCQ,EAAW,CACf,iBAAiBN,aA5BS,CAACO,IAC7B,IAAIC,EAAYD,EACbE,MAAMC,OACNC,KAAK,KACLC,QAAQ,oBAAqB,IAMhC,OAJKJ,EAAUK,WAAW,OACxBL,EAAY,KAAKA,KAGZA,GAekBM,CAAsBC,EAAAA,SAASC,EAAAA,QAAQX,GAAaJ,QAI3E,GACA,2CACA,yCAAyCD,OACzC,IACA,GACA,aACA,IACAW,KAAK,MAEP,IAAIM,EAEJ,IACEA,QAAyBC,EAAAA,SAASb,EAAY,OAChD,CAAE,MAAOc,GACP,IA9BkB,CAACA,KACnBA,GAA0B,iBAAVA,GAAsB,SAAUA,GAAwB,WAAfA,EAAMC,KA6B1DC,CAAcF,GACjB,MAAMA,CAEV,CAEIF,IAAqBX,UACjBgB,EAAAA,MAAMN,UAAQX,GAAa,CAAEkB,WAAW,UACxCC,YAAUnB,EAAYC,EAAU,SAGxCH,QAAQsB,OAAOC,MAAM,aAAaX,EAAAA,SAASZ,QAAQC,MAAOC"}

package/dist/cjs/cli.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("yargs"),r=require("yargs/helpers"),s=require("./cli/command.cjs");exports.runAppsettingsCli=async()=>{await e(r.hideBin(process.argv)).scriptName("appsettings").command(s).demandCommand(1,"Choose a command to run.").strict().help().parseAsync()};
+//# sourceMappingURL=cli.cjs.map

package/dist/cjs/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.cjs","sources":["../../src/cli.ts"],"sourcesContent":["import yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\nimport * as generateTypesCommand from './cli/command.ts';\n\nexport const runAppsettingsCli = async (): Promise<void> => {\n  await yargs(hideBin(process.argv))\n    .scriptName('appsettings')\n    .command(generateTypesCommand)\n    .demandCommand(1, 'Choose a command to run.')\n    .strict()\n    .help()\n    .parseAsync();\n};\n"],"names":["async","yargs","hideBin","process","argv","scriptName","command","generateTypesCommand","demandCommand","strict","help","parseAsync"],"mappings":"wHAIiCA,gBACzBC,EAAMC,EAAAA,QAAQC,QAAQC,OACzBC,WAAW,eACXC,QAAQC,GACRC,cAAc,EAAG,4BACjBC,SACAC,OACAC"}

package/dist/cjs/components/AppSettingsProvider.cjs

@@ -0,0 +1,3 @@
+"use client";
+"use strict";var e=require("react/jsx-runtime"),t=require("react"),r=require("../config/AppSettingsImplementation.cjs"),n=require("../hooks/useAppSettingsContext.cjs");exports.AppSettingsProvider=({children:i,settings:s})=>{const p=t.useMemo(()=>new r.AppSettingsImplementation(s),[s]);return e.jsx(n.AppSettingsContext,{value:p,children:i})};
+//# sourceMappingURL=AppSettingsProvider.cjs.map

package/dist/cjs/components/AppSettingsProvider.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppSettingsProvider.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/cjs/components/Setting.cjs

@@ -0,0 +1,3 @@
+"use client";
+"use strict";var e=require("../hooks/useAppSettingsContext.cjs");exports.Setting=function({children:t,fallback:r,negate:n=!1,path:s,value:a}){const i=e.useAppSettingsContext().read(s),u=(Array.isArray(a)?a:[a]).includes(i);return(n?!u:u)?t:r};
+//# sourceMappingURL=Setting.cjs.map

package/dist/cjs/components/Setting.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Setting.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/cjs/config/AppSettingsImplementation.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("remeda"),t=require("./ScopedSettingsImplementation.cjs"),r=require("./ConfigReader.cjs"),n=require("./ConfigStore.cjs");exports.AppSettingsImplementation=class{constructor(e){this.store=new n.ConfigStore(e)}get(e){return this.read(e)}read(e){return new r.ConfigReader(this.store.getSnapshot()).read(e)}getAll(){return this.store.getSnapshot()}getOrThrow(e){const t=new r.ConfigReader(this.store.getSnapshot()).read(e);if(void 0===t)throw new Error(`Required app setting "${e}" is missing.`);return t}getSection(e){return new r.ConfigReader(this.store.getSnapshot()).read(e)}has(e){return new r.ConfigReader(this.store.getSnapshot()).has(e)}scope(n){const s=new r.ConfigReader(this.store.getSnapshot()).read(n);if(!e.isPlainObject(s))throw new Error(`App setting section "${n}" is missing.`);return new t.ScopedSettingsImplementation(s,n)}};
+//# sourceMappingURL=AppSettingsImplementation.cjs.map

package/dist/cjs/config/AppSettingsImplementation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppSettingsImplementation.cjs","sources":["../../../src/config/AppSettingsImplementation.ts"],"sourcesContent":["import { isPlainObject } from 'remeda';\nimport { type Get } from 'type-fest';\nimport { ScopedSettingsImplementation } from '#config/ScopedSettingsImplementation.ts';\nimport { type InternalAppSettings, type ScopedSettings } from '#types/AppSettings.types.ts';\nimport { type SettingPath, type SettingSectionPath } from '#types/Config.types.ts';\nimport { ConfigReader } from './ConfigReader.ts';\nimport { ConfigStore } from './ConfigStore.ts';\n\nexport class AppSettingsImplementation<T extends object> implements InternalAppSettings<T> {\n  private readonly store: ConfigStore<T>;\n\n  constructor(settings: T) {\n    this.store = new ConfigStore(settings);\n  }\n\n  get<P extends SettingPath<T>>(path: P): Get<T, P> | undefined;\n  get(path: string): unknown {\n    return this.read(path);\n  }\n\n  read(path: string): unknown {\n    return new ConfigReader(this.store.getSnapshot()).read(path);\n  }\n\n  getAll(): Readonly<T> {\n    return this.store.getSnapshot();\n  }\n\n  getOrThrow<P extends SettingPath<T>>(path: P): Get<T, P>;\n  getOrThrow(path: string): unknown {\n    const value = new ConfigReader(this.store.getSnapshot()).read(path);\n\n    if (value === undefined) {\n      throw new Error(`Required app setting \"${path}\" is missing.`);\n    }\n\n    return value;\n  }\n\n  getSection<P extends SettingSectionPath<T>>(path: P): Get<T, P> | undefined;\n  getSection(path: string): unknown {\n    return new ConfigReader(this.store.getSnapshot()).read(path);\n  }\n\n  has(path: SettingPath<T> | SettingSectionPath<T>): boolean;\n  has(path: string): boolean {\n    return new ConfigReader(this.store.getSnapshot()).has(path);\n  }\n\n  scope<P extends SettingSectionPath<T>>(path: P): ScopedSettings<Extract<Get<T, P>, object>>;\n  scope(path: string): ScopedSettings<object> {\n    const reader = new ConfigReader(this.store.getSnapshot());\n    const section = reader.read(path);\n\n    if (!isPlainObject(section)) {\n      throw new Error(`App setting section \"${path}\" is missing.`);\n    }\n\n    return new ScopedSettingsImplementation(section, path);\n  }\n}\n"],"names":["constructor","settings","this","store","ConfigStore","get","path","read","ConfigReader","getSnapshot","getAll","getOrThrow","value","undefined","Error","getSection","has","scope","section","isPlainObject","ScopedSettingsImplementation"],"mappings":"sLAQO,MAGL,WAAAA,CAAYC,GACVC,KAAKC,MAAQ,IAAIC,EAAAA,YAAYH,EAC/B,CAGAI,GAAAA,CAAIC,GACF,OAAOJ,KAAKK,KAAKD,EACnB,CAEAC,IAAAA,CAAKD,GACH,OAAO,IAAIE,EAAAA,aAAaN,KAAKC,MAAMM,eAAeF,KAAKD,EACzD,CAEAI,MAAAA,GACE,OAAOR,KAAKC,MAAMM,aACpB,CAGAE,UAAAA,CAAWL,GACT,MAAMM,EAAQ,IAAIJ,EAAAA,aAAaN,KAAKC,MAAMM,eAAeF,KAAKD,GAE9D,QAAcO,IAAVD,EACF,MAAM,IAAIE,MAAM,yBAAyBR,kBAG3C,OAAOM,CACT,CAGAG,UAAAA,CAAWT,GACT,OAAO,IAAIE,EAAAA,aAAaN,KAAKC,MAAMM,eAAeF,KAAKD,EACzD,CAGAU,GAAAA,CAAIV,GACF,OAAO,IAAIE,EAAAA,aAAaN,KAAKC,MAAMM,eAAeO,IAAIV,EACxD,CAGAW,KAAAA,CAAMX,GACJ,MACMY,EADS,IAAIV,EAAAA,aAAaN,KAAKC,MAAMM,eACpBF,KAAKD,GAE5B,IAAKa,EAAAA,cAAcD,GACjB,MAAM,IAAIJ,MAAM,wBAAwBR,kBAG1C,OAAO,IAAIc,EAAAA,6BAA6BF,EAASZ,EACnD"}

package/dist/cjs/config/ConfigMerger.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("remeda");exports.ConfigMerger=class{merge(r,...s){return s.reduce((r,s)=>e.mergeDeep(r,s),r)}};
+//# sourceMappingURL=ConfigMerger.cjs.map

package/dist/cjs/config/ConfigMerger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigMerger.cjs","sources":["../../../src/config/ConfigMerger.ts"],"sourcesContent":["import { mergeDeep } from 'remeda';\n\nexport class ConfigMerger {\n  merge<T extends object>(first: T, ...configs: readonly T[]): T {\n    // TypeScript cannot guarantee that merging arbitrary objects produces T\n    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions\n    return configs.reduce((merged, config) => mergeDeep(merged, config) as T, first);\n  }\n}\n"],"names":["merge","first","configs","reduce","merged","config","mergeDeep"],"mappings":"0DAEO,MACLA,KAAAA,CAAwBC,KAAaC,GAGnC,OAAOA,EAAQC,OAAO,CAACC,EAAQC,IAAWC,EAAAA,UAAUF,EAAQC,GAAcJ,EAC5E"}

package/dist/cjs/config/ConfigReader.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("remeda"),r=require("zcb");exports.ConfigReader=class{constructor(e){this.config=e,this.reader=r.createConfigReader(e)}getAt(r){return r.split(".").reduce((r,t)=>{if(e.isPlainObject(r))return r[t]},this.config)}get(e){return this.reader.read(e)}getSection(e){return this.getAt(e)}has(e){return void 0!==this.getAt(e)}read(e){return this.getAt(e)}scope(e){return this.reader.scope(e)}};
+//# sourceMappingURL=ConfigReader.cjs.map

package/dist/cjs/config/ConfigReader.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigReader.cjs","sources":["../../../src/config/ConfigReader.ts"],"sourcesContent":["import { isPlainObject } from 'remeda';\nimport { type Get } from 'type-fest';\nimport { type Path, type Scope, type ConfigReader as ZcbConfigReader, createConfigReader } from 'zcb';\n\nexport class ConfigReader<T extends object> {\n  private reader: ZcbConfigReader<T>;\n  private readonly config: T;\n\n  constructor(config: T) {\n    this.config = config;\n    this.reader = createConfigReader(config);\n  }\n\n  private getAt(path: string): unknown {\n    return path.split('.').reduce<unknown>((current, key) => {\n      if (!isPlainObject(current)) {\n        return;\n      }\n\n      return current[key];\n    }, this.config);\n  }\n\n  public get<P extends Path<T>>(path: P): Get<T, P> {\n    return this.reader.read(path);\n  }\n\n  public getSection<P extends Scope<T>>(path: P): Get<T, P> {\n    // Required as underlying getAt needs to be kept permissive\n    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions\n    return this.getAt(path) as Get<T, P>;\n  }\n\n  public has(path: string): boolean {\n    return this.getAt(path) !== undefined;\n  }\n\n  public read(path: string): unknown {\n    return this.getAt(path);\n  }\n\n  public scope<P extends Scope<T>>(path: P): ZcbConfigReader<Get<T, P>> {\n    return this.reader.scope(path);\n  }\n}\n"],"names":["constructor","config","this","reader","createConfigReader","getAt","path","split","reduce","current","key","isPlainObject","get","read","getSection","has","undefined","scope"],"mappings":"2EAIO,MAIL,WAAAA,CAAYC,GACVC,KAAKD,OAASA,EACdC,KAAKC,OAASC,EAAAA,mBAAmBH,EACnC,CAEQI,KAAAA,CAAMC,GACZ,OAAOA,EAAKC,MAAM,KAAKC,OAAgB,CAACC,EAASC,KAC/C,GAAKC,EAAAA,cAAcF,GAInB,OAAOA,EAAQC,IACdR,KAAKD,OACV,CAEOW,GAAAA,CAAuBN,GAC5B,OAAOJ,KAAKC,OAAOU,KAAKP,EAC1B,CAEOQ,UAAAA,CAA+BR,GAGpC,OAAOJ,KAAKG,MAAMC,EACpB,CAEOS,GAAAA,CAAIT,GACT,YAA4BU,IAArBd,KAAKG,MAAMC,EACpB,CAEOO,IAAAA,CAAKP,GACV,OAAOJ,KAAKG,MAAMC,EACpB,CAEOW,KAAAA,CAA0BX,GAC/B,OAAOJ,KAAKC,OAAOc,MAAMX,EAC3B"}

package/dist/cjs/config/ConfigStore.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("remeda"),s=require("./helpers/freezeDeep.cjs");exports.ConfigStore=class{constructor(r){this.getSnapshot=()=>this.snapshot,this.snapshot=s.freezeDeep(e.clone(r))}};
+//# sourceMappingURL=ConfigStore.cjs.map

package/dist/cjs/config/ConfigStore.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigStore.cjs","sources":["../../../src/config/ConfigStore.ts"],"sourcesContent":["import { clone } from 'remeda';\nimport { freezeDeep } from '#config/helpers/freezeDeep.ts';\n\nexport class ConfigStore<T extends object> {\n  private snapshot: Readonly<T>;\n\n  public getSnapshot = (): Readonly<T> => this.snapshot;\n\n  constructor(initial: T) {\n    this.snapshot = freezeDeep(clone(initial));\n  }\n}\n"],"names":["constructor","initial","getSnapshot","this","snapshot","freezeDeep","clone"],"mappings":"+FAGO,MAKL,WAAAA,CAAYC,QAFLC,YAAc,IAAmBC,KAAKC,SAG3CD,KAAKC,SAAWC,EAAAA,WAAWC,EAAAA,MAAML,GACnC"}

package/dist/cjs/config/ConfigValidator.cjs

@@ -0,0 +1,2 @@
+"use strict";exports.ConfigValidator=class{constructor(s){this.schema=s}validate(s){return this.schema.parse(s)}};
+//# sourceMappingURL=ConfigValidator.cjs.map

package/dist/cjs/config/ConfigValidator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigValidator.cjs","sources":["../../../src/config/ConfigValidator.ts"],"sourcesContent":["import { type ZodType, type output } from 'zod';\n\nexport class ConfigValidator<T extends ZodType> {\n  private readonly schema: T;\n\n  constructor(schema: T) {\n    this.schema = schema;\n  }\n\n  validate(value: unknown): output<T> {\n    return this.schema.parse(value);\n  }\n}\n"],"names":["constructor","schema","this","validate","value","parse"],"mappings":"qCAEO,MAGL,WAAAA,CAAYC,GACVC,KAAKD,OAASA,CAChB,CAEAE,QAAAA,CAASC,GACP,OAAOF,KAAKD,OAAOI,MAAMD,EAC3B"}

package/dist/cjs/config/ScopedSettingsImplementation.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("./ConfigReader.cjs");exports.ScopedSettingsImplementation=class{constructor(r,t){this.section=r,this.parentPath=t,this.reader=new e.ConfigReader(r)}get(e){return this.reader.read(e)}getAll(){return this.section}getOrThrow(e){const r=this.reader.read(e);if(void 0===r)throw new Error(`Required app setting "${this.parentPath}.${e}" is missing.`);return r}};
+//# sourceMappingURL=ScopedSettingsImplementation.cjs.map

package/dist/cjs/config/ScopedSettingsImplementation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScopedSettingsImplementation.cjs","sources":["../../../src/config/ScopedSettingsImplementation.ts"],"sourcesContent":["import { type Get } from 'type-fest';\nimport { ConfigReader } from '#config/ConfigReader.ts';\nimport { type ScopedSettings } from '#types/AppSettings.types.ts';\nimport { type SettingPath } from '#types/Config.types.ts';\n\nexport class ScopedSettingsImplementation<T extends object> implements ScopedSettings<T> {\n  private readonly reader: ConfigReader<T>;\n  private readonly section: T;\n  private readonly parentPath: string;\n\n  constructor(section: T, parentPath: string) {\n    this.section = section;\n    this.parentPath = parentPath;\n    this.reader = new ConfigReader(section);\n  }\n\n  get<P extends SettingPath<T>>(path: P): Get<T, P> | undefined;\n  get(path: string): unknown {\n    return this.reader.read(path);\n  }\n\n  getAll(): Readonly<T> {\n    return this.section;\n  }\n\n  getOrThrow<P extends SettingPath<T>>(path: P): Get<T, P>;\n  getOrThrow(path: string): unknown {\n    const value = this.reader.read(path);\n\n    if (value === undefined) {\n      throw new Error(`Required app setting \"${this.parentPath}.${path}\" is missing.`);\n    }\n\n    return value;\n  }\n}\n"],"names":["constructor","section","parentPath","this","reader","ConfigReader","get","path","read","getAll","getOrThrow","value","undefined","Error"],"mappings":"sFAKO,MAKL,WAAAA,CAAYC,EAAYC,GACtBC,KAAKF,QAAUA,EACfE,KAAKD,WAAaA,EAClBC,KAAKC,OAAS,IAAIC,EAAAA,aAAaJ,EACjC,CAGAK,GAAAA,CAAIC,GACF,OAAOJ,KAAKC,OAAOI,KAAKD,EAC1B,CAEAE,MAAAA,GACE,OAAON,KAAKF,OACd,CAGAS,UAAAA,CAAWH,GACT,MAAMI,EAAQR,KAAKC,OAAOI,KAAKD,GAE/B,QAAcK,IAAVD,EACF,MAAM,IAAIE,MAAM,yBAAyBV,KAAKD,cAAcK,kBAG9D,OAAOI,CACT"}

package/dist/cjs/config/createAppSettings.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("./ConfigMerger.cjs"),r=require("./ConfigValidator.cjs");exports.createAppSettings=async({defaults:s,schema:t,sources:a=[]})=>{const o=[];for(const e of a)o.push(await e.load());const i=(new e.ConfigMerger).merge(s,...o);return new r.ConfigValidator(t).validate(i)};
+//# sourceMappingURL=createAppSettings.cjs.map

package/dist/cjs/config/createAppSettings.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAppSettings.cjs","sources":["../../../src/config/createAppSettings.ts"],"sourcesContent":["import { type CreateAppSettingsOptions } from '#types/AppSettings.types.ts';\nimport { ConfigMerger } from './ConfigMerger.ts';\nimport { ConfigValidator } from './ConfigValidator.ts';\n\nexport const createAppSettings = async <T extends object>({\n  defaults,\n  schema,\n  sources = [],\n}: CreateAppSettingsOptions<T>): Promise<Readonly<T>> => {\n  const loadedSources: Record<string, unknown>[] = [];\n\n  for (const source of sources) {\n    loadedSources.push(await source.load());\n  }\n\n  const merged = new ConfigMerger().merge(defaults, ...loadedSources);\n  return new ConfigValidator(schema).validate(merged);\n};\n"],"names":["async","defaults","schema","sources","loadedSources","source","push","load","merged","ConfigMerger","merge","ConfigValidator","validate"],"mappings":"8GAIiCA,OAC/BC,WACAC,SACAC,UAAU,OAEV,MAAMC,EAA2C,GAEjD,IAAK,MAAMC,KAAUF,EACnBC,EAAcE,WAAWD,EAAOE,QAGlC,MAAMC,GAAS,IAAIC,EAAAA,cAAeC,MAAMT,KAAaG,GACrD,OAAO,IAAIO,EAAAA,gBAAgBT,GAAQU,SAASJ"}

package/dist/cjs/config/helpers/freezeDeep.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("remeda");const r=t=>{if((e.isPlainObject(t)||Array.isArray(t))&&!Object.isFrozen(t)){const e=Object.values(t);for(const t of e)r(t);Object.freeze(t)}return t};exports.freezeDeep=r;
+//# sourceMappingURL=freezeDeep.cjs.map

package/dist/cjs/config/helpers/freezeDeep.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"freezeDeep.cjs","sources":["../../../../src/config/helpers/freezeDeep.ts"],"sourcesContent":["import { isPlainObject } from 'remeda';\n\nexport const freezeDeep = <T>(value: T): T => {\n  if ((isPlainObject(value) || Array.isArray(value)) && !Object.isFrozen(value)) {\n    const values: unknown[] = Object.values(value);\n\n    for (const entry of values) {\n      freezeDeep(entry);\n    }\n\n    Object.freeze(value);\n  }\n\n  return value;\n};\n"],"names":["freezeDeep","value","isPlainObject","Array","isArray","Object","isFrozen","values","entry","freeze"],"mappings":"qCAEO,MAAMA,EAAiBC,IAC5B,IAAKC,EAAAA,cAAcD,IAAUE,MAAMC,QAAQH,MAAYI,OAAOC,SAASL,GAAQ,CAC7E,MAAMM,EAAoBF,OAAOE,OAAON,GAExC,IAAK,MAAMO,KAASD,EAClBP,EAAWQ,GAGbH,OAAOI,OAAOR,EAChB,CAEA,OAAOA"}

package/dist/cjs/hooks/useAppSetting.cjs

@@ -0,0 +1,2 @@
+"use strict";var t=require("./useAppSettingsContext.cjs");exports.useAppSetting=function(e){return t.useAppSettingsContext().read(e)};
+//# sourceMappingURL=useAppSetting.cjs.map

package/dist/cjs/hooks/useAppSetting.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAppSetting.cjs","sources":["../../../src/hooks/useAppSetting.ts"],"sourcesContent":["import { type Get } from 'type-fest';\nimport { type AppSettingsSchema } from '../index.ts';\nimport { type SettingPath } from '../types/Config.types.ts';\nimport { useAppSettingsContext } from './useAppSettingsContext.ts';\n\nexport function useAppSetting<P extends SettingPath<AppSettingsSchema>>(path: P): Get<AppSettingsSchema, P> | undefined;\nexport function useAppSetting<T extends object, P extends SettingPath<T>>(path: P): Get<T, P> | undefined;\n\n// Required for overloads\n// eslint-disable-next-line prefer-arrow/prefer-arrow-functions\nexport function useAppSetting(path: string): unknown {\n  const settings = useAppSettingsContext();\n  return settings.read(path);\n}\n"],"names":["path","useAppSettingsContext","read"],"mappings":"gFAUO,SAAuBA,GAE5B,OADiBC,EAAAA,wBACDC,KAAKF,EACvB"}

package/dist/cjs/hooks/useAppSettings.cjs

@@ -0,0 +1,2 @@
+"use strict";var t=require("./useAppSettingsContext.cjs");exports.useAppSettings=function(e){return t.useAppSettingsContext().read(e)};
+//# sourceMappingURL=useAppSettings.cjs.map

package/dist/cjs/hooks/useAppSettings.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAppSettings.cjs","sources":["../../../src/hooks/useAppSettings.ts"],"sourcesContent":["import { type Get } from 'type-fest';\nimport { type SettingSectionPath } from '#types/Config.types.ts';\nimport { type AppSettingsSchema } from '../index.ts';\nimport { useAppSettingsContext } from './useAppSettingsContext.ts';\n\nexport function useAppSettings<P extends SettingSectionPath<AppSettingsSchema>>(\n  path: P,\n): Get<AppSettingsSchema, P> | undefined;\n\nexport function useAppSettings<T extends object, P extends SettingSectionPath<T>>(path: P): Get<T, P> | undefined;\n\n// Required for overloads\n// eslint-disable-next-line prefer-arrow/prefer-arrow-functions\nexport function useAppSettings(path: string): unknown {\n  const settings = useAppSettingsContext();\n  return settings.read(path);\n}\n"],"names":["path","useAppSettingsContext","read"],"mappings":"iFAaO,SAAwBA,GAE7B,OADiBC,EAAAA,wBACDC,KAAKF,EACvB"}

package/dist/cjs/hooks/useAppSettingsContext.cjs

@@ -0,0 +1,2 @@
+"use strict";var t=require("react");const e=t.createContext(void 0);exports.AppSettingsContext=e,exports.useAppSettingsContext=()=>{const r=t.use(e);if(!r||"object"!=typeof r)throw new Error("useAppSettingsContext must be used within an <AppSettingsProvider>.");return r};
+//# sourceMappingURL=useAppSettingsContext.cjs.map

package/dist/cjs/hooks/useAppSettingsContext.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAppSettingsContext.cjs","sources":["../../../src/hooks/useAppSettingsContext.ts"],"sourcesContent":["import { createContext, use } from 'react';\nimport { type InternalAppSettings } from '#types/AppSettings.types.ts';\nimport { type AppSettingsSchema } from '../index.ts';\n\nexport const AppSettingsContext = createContext<unknown>(undefined);\n\nexport const useAppSettingsContext = <T extends object = AppSettingsSchema>(): InternalAppSettings<T> => {\n  const settings = use(AppSettingsContext);\n\n  if (!settings || typeof settings !== 'object') {\n    throw new Error('useAppSettingsContext must be used within an <AppSettingsProvider>.');\n  }\n\n  // Context is untyped because each provider supplies a different schema.\n  // eslint-disable-next-line @typescript-eslint/consistent-type-assertions\n  return settings as InternalAppSettings<T>;\n};\n"],"names":["AppSettingsContext","createContext","undefined","settings","use","Error"],"mappings":"oCAIO,MAAMA,EAAqBC,EAAAA,mBAAuBC,8DAEpB,KACnC,MAAMC,EAAWC,EAAAA,IAAIJ,GAErB,IAAKG,GAAgC,iBAAbA,EACtB,MAAM,IAAIE,MAAM,uEAKlB,OAAOF"}

package/dist/cjs/index.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("./components/AppSettingsProvider.cjs"),t=require("./components/Setting.cjs"),s=require("./hooks/useAppSetting.cjs"),p=require("./hooks/useAppSettings.cjs");exports.AppSettingsProvider=e.AppSettingsProvider,exports.Setting=t.Setting,exports.useAppSetting=s.useAppSetting,exports.useAppSettings=p.useAppSettings;
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/cjs/server.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("./config/createAppSettings.cjs"),r=require("./sources/AppSettingsSource.cjs"),o=require("./sources/EnvironmentSource.cjs"),t=require("./sources/RemoteSource.cjs"),c=require("./sources/MemorySource.cjs");exports.createAppSettings=e.createAppSettings,exports.AppSettingsSource=r.AppSettingsSource,exports.EnvironmentSource=o.EnvironmentSource,exports.RemoteSource=t.RemoteSource,exports.MemorySource=c.MemorySource;
+//# sourceMappingURL=server.cjs.map

package/dist/cjs/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/cjs/sources/AppSettingsSource.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("node:path"),r=require("../config/ConfigMerger.cjs"),s=require("./helpers/loadJson.cjs");exports.AppSettingsSource=class{constructor(e){this.directory=e.directory??process.cwd(),this.environment=e.environment??process.env.NODE_ENV??"development",this.name=e.name??`appsettings:${this.environment}`}async load(){const n=e.resolve(this.directory,"appsettings.json"),t=e.resolve(this.directory,`appsettings.${this.environment}.json`),o=await s.loadJson(n,!1),i=await s.loadJson(t,!0)??{};return(new r.ConfigMerger).merge(o,i)}};
+//# sourceMappingURL=AppSettingsSource.cjs.map

package/dist/cjs/sources/AppSettingsSource.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppSettingsSource.cjs","sources":["../../../src/sources/AppSettingsSource.ts"],"sourcesContent":["import { resolve } from 'node:path';\nimport { ConfigMerger } from '#config/ConfigMerger.ts';\nimport { loadJson } from '#sources/helpers/loadJson.ts';\nimport { type SettingsSource } from '../types/Source.types.ts';\n\nexport interface AppSettingsSourceOptions {\n  directory?: string;\n  environment?: string;\n  name?: string;\n}\n\nexport class AppSettingsSource implements SettingsSource {\n  private directory: string;\n  private environment: string;\n  public name: string;\n\n  public constructor(options: AppSettingsSourceOptions) {\n    this.directory = options.directory ?? process.cwd();\n    this.environment = options.environment ?? process.env.NODE_ENV ?? 'development';\n    this.name = options.name ?? `appsettings:${this.environment}`;\n  }\n\n  async load(): Promise<Record<string, unknown>> {\n    const basePath = resolve(this.directory, 'appsettings.json');\n    const environmentPath = resolve(this.directory, `appsettings.${this.environment}.json`);\n    const base = await loadJson(basePath, false);\n    const override = (await loadJson(environmentPath, true)) ?? {};\n    return new ConfigMerger().merge(base, override);\n  }\n}\n"],"names":["constructor","options","this","directory","process","cwd","environment","env","NODE_ENV","name","load","basePath","resolve","environmentPath","base","loadJson","override","ConfigMerger","merge"],"mappings":"8IAWO,MAKL,WAAAA,CAAmBC,GACjBC,KAAKC,UAAYF,EAAQE,WAAaC,QAAQC,MAC9CH,KAAKI,YAAcL,EAAQK,aAAeF,QAAQG,IAAIC,UAAY,cAClEN,KAAKO,KAAOR,EAAQQ,MAAQ,eAAeP,KAAKI,aAClD,CAEA,UAAMI,GACJ,MAAMC,EAAWC,EAAAA,QAAQV,KAAKC,UAAW,oBACnCU,EAAkBD,UAAQV,KAAKC,UAAW,eAAeD,KAAKI,oBAC9DQ,QAAaC,WAASJ,GAAU,GAChCK,QAAkBD,EAAAA,SAASF,GAAiB,IAAU,CAAA,EAC5D,OAAO,IAAII,EAAAA,cAAeC,MAAMJ,EAAME,EACxC"}

package/dist/cjs/sources/EnvironmentSource.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("remeda");exports.EnvironmentSource=class{constructor(t){this.normalizeSegment=t=>t.toLowerCase().split("_").filter(Boolean).map(t=>e.capitalize(t)).join(""),this.envs=t.envs,this.prefix=t.prefix??"APP_",this.name=t.name??`environment:${this.prefix}`}parseEnvironmentValue(e){return"true"===e||"false"!==e&&(""!==e.trim()&&Number.isFinite(Number(e))?Number(e):e)}load(){const t={};for(const[i,n]of Object.entries(this.envs)){if(void 0===n||!i.startsWith(this.prefix))continue;const r=i.slice(this.prefix.length).split("__").filter(Boolean).map(e=>this.normalizeSegment(e)),s=r.pop();if(!s)continue;let o=t;for(const t of r){const i=o[t];e.isPlainObject(i)||(o[t]={});const n=o[t];e.isPlainObject(n)&&(o=n)}o[s]=this.parseEnvironmentValue(n)}return Promise.resolve(t)}};
+//# sourceMappingURL=EnvironmentSource.cjs.map

package/dist/cjs/sources/EnvironmentSource.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentSource.cjs","sources":["../../../src/sources/EnvironmentSource.ts"],"sourcesContent":["import { capitalize, isPlainObject } from 'remeda';\nimport { type SettingsSource } from '../types/Source.types.ts';\n\nexport interface EnvironmentSourceOptions {\n  envs: Record<string, string | undefined>;\n  name?: string;\n  prefix?: string;\n}\n\nexport class EnvironmentSource implements SettingsSource {\n  private readonly envs: Record<string, string | undefined>;\n  private readonly prefix: string;\n\n  private normalizeSegment = (value: string): string =>\n    value\n      .toLowerCase()\n      .split('_')\n      .filter(Boolean)\n      .map(part => capitalize(part))\n      .join('');\n\n  public readonly name: string;\n\n  public constructor(options: EnvironmentSourceOptions) {\n    this.envs = options.envs;\n    this.prefix = options.prefix ?? 'APP_';\n    this.name = options.name ?? `environment:${this.prefix}`;\n  }\n\n  private parseEnvironmentValue(value: string): unknown {\n    if (value === 'true') {\n      return true;\n    }\n\n    if (value === 'false') {\n      return false;\n    }\n\n    if (value.trim() !== '' && Number.isFinite(Number(value))) {\n      return Number(value);\n    }\n\n    return value;\n  }\n\n  load(): Promise<Record<string, unknown>> {\n    const result: Record<string, unknown> = {};\n\n    for (const [key, value] of Object.entries(this.envs)) {\n      if (value === undefined || !key.startsWith(this.prefix)) {\n        continue;\n      }\n\n      const path = key\n        .slice(this.prefix.length)\n        .split('__')\n        .filter(Boolean)\n        .map(part => this.normalizeSegment(part));\n\n      const leaf = path.pop();\n\n      if (!leaf) {\n        continue;\n      }\n\n      let current = result;\n\n      for (const part of path) {\n        const next = current[part];\n\n        if (!isPlainObject(next)) {\n          current[part] = {};\n        }\n\n        const currentPart = current[part];\n\n        if (isPlainObject(currentPart)) {\n          current = currentPart;\n        }\n      }\n\n      current[leaf] = this.parseEnvironmentValue(value);\n    }\n\n    return Promise.resolve(result);\n  }\n}\n"],"names":["constructor","options","normalizeSegment","value","toLowerCase","split","filter","Boolean","map","part","capitalize","join","this","envs","prefix","name","parseEnvironmentValue","trim","Number","isFinite","load","result","key","Object","entries","undefined","startsWith","path","slice","length","leaf","pop","current","next","isPlainObject","currentPart","Promise","resolve"],"mappings":"+DASO,MAcL,WAAAA,CAAmBC,GAVXC,KAAAA,iBAAoBC,GAC1BA,EACGC,cACAC,MAAM,KACNC,OAAOC,SACPC,IAAIC,GAAQC,EAAAA,WAAWD,IACvBE,KAAK,IAKRC,KAAKC,KAAOZ,EAAQY,KACpBD,KAAKE,OAASb,EAAQa,QAAU,OAChCF,KAAKG,KAAOd,EAAQc,MAAQ,eAAeH,KAAKE,QAClD,CAEQE,qBAAAA,CAAsBb,GAC5B,MAAc,SAAVA,GAIU,UAAVA,IAIiB,KAAjBA,EAAMc,QAAiBC,OAAOC,SAASD,OAAOf,IACzCe,OAAOf,GAGTA,EACT,CAEAiB,IAAAA,GACE,MAAMC,EAAkC,CAAA,EAExC,IAAK,MAAOC,EAAKnB,KAAUoB,OAAOC,QAAQZ,KAAKC,MAAO,CACpD,QAAcY,IAAVtB,IAAwBmB,EAAII,WAAWd,KAAKE,QAC9C,SAGF,MAAMa,EAAOL,EACVM,MAAMhB,KAAKE,OAAOe,QAClBxB,MAAM,MACNC,OAAOC,SACPC,IAAIC,GAAQG,KAAKV,iBAAiBO,IAE/BqB,EAAOH,EAAKI,MAElB,IAAKD,EACH,SAGF,IAAIE,EAAUX,EAEd,IAAK,MAAMZ,KAAQkB,EAAM,CACvB,MAAMM,EAAOD,EAAQvB,GAEhByB,EAAAA,cAAcD,KACjBD,EAAQvB,GAAQ,CAAA,GAGlB,MAAM0B,EAAcH,EAAQvB,GAExByB,EAAAA,cAAcC,KAChBH,EAAUG,EAEd,CAEAH,EAAQF,GAAQlB,KAAKI,sBAAsBb,EAC7C,CAEA,OAAOiC,QAAQC,QAAQhB,EACzB"}

package/dist/cjs/sources/MemorySource.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("remeda");exports.MemorySource=class{constructor(e){this.name=e.name??"memory",this.values=e.values}load(){return Promise.resolve(e.clone(this.values))}};
+//# sourceMappingURL=MemorySource.cjs.map

package/dist/cjs/sources/MemorySource.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemorySource.cjs","sources":["../../../src/sources/MemorySource.ts"],"sourcesContent":["import { clone } from 'remeda';\nimport { type SettingsSource } from '../types/Source.types.ts';\n\nexport interface MemorySourceOptions {\n  name?: string;\n  values: Record<string, unknown>;\n}\n\nexport class MemorySource implements SettingsSource {\n  private readonly values: Record<string, unknown>;\n  public readonly name: string;\n\n  public constructor(options: MemorySourceOptions) {\n    this.name = options.name ?? 'memory';\n    this.values = options.values;\n  }\n\n  load(): Promise<Record<string, unknown>> {\n    return Promise.resolve(clone(this.values));\n  }\n}\n"],"names":["constructor","options","this","name","values","load","Promise","resolve","clone"],"mappings":"0DAQO,MAIL,WAAAA,CAAmBC,GACjBC,KAAKC,KAAOF,EAAQE,MAAQ,SAC5BD,KAAKE,OAASH,EAAQG,MACxB,CAEAC,IAAAA,GACE,OAAOC,QAAQC,QAAQC,EAAAA,MAAMN,KAAKE,QACpC"}

package/dist/cjs/sources/RemoteSource.cjs

@@ -0,0 +1,2 @@
+"use strict";var t=require("remeda");exports.RemoteSource=class{constructor(t){this.fetch=t.fetch,this.url=t.url,this.name=t.name??`remote:${this.url}`,this.responsePath=t.responsePath}async load(){if("function"!=typeof this.fetch)throw new TypeError("RemoteSource requires fetch, which is unavailable in this runtime.");const e=await this.fetch(this.url);if(!e.ok)throw new Error(`Failed to load settings from "${this.url}": ${String(e.status)} ${e.statusText}`);let s=await e.json();if(this.responsePath&&!t.isObjectType(s))throw new Error(`Fetched value must be an object type if response path is provided, but was ${typeof s}.`);if(s=this.responsePath?t.prop(s,...t.stringToPath(this.responsePath)):s,!t.isPlainObject(s))throw new Error(`JSON settings from "${this.url}" must contain an object at the root.`);return s}};
+//# sourceMappingURL=RemoteSource.cjs.map

package/dist/cjs/sources/RemoteSource.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteSource.cjs","sources":["../../../src/sources/RemoteSource.ts"],"sourcesContent":["import { isObjectType, isPlainObject, prop, stringToPath } from 'remeda';\nimport { type SettingsSource } from '#types/Source.types.ts';\n\nexport interface RemoteSourceOptions {\n  fetch: typeof globalThis.fetch;\n  name?: string;\n  responsePath?: string;\n  url: string;\n}\n\nexport class RemoteSource implements SettingsSource {\n  private fetch: typeof globalThis.fetch;\n  private responsePath?: string;\n  private url: string;\n  public name: string;\n\n  public constructor(options: RemoteSourceOptions) {\n    this.fetch = options.fetch;\n    this.url = options.url;\n    this.name = options.name ?? `remote:${this.url}`;\n    this.responsePath = options.responsePath;\n  }\n\n  async load(): Promise<Record<string, unknown>> {\n    if (typeof this.fetch !== 'function') {\n      throw new TypeError('RemoteSource requires fetch, which is unavailable in this runtime.');\n    }\n\n    const response = await this.fetch(this.url);\n\n    if (!response.ok) {\n      throw new Error(`Failed to load settings from \"${this.url}\": ${String(response.status)} ${response.statusText}`);\n    }\n\n    let value: unknown = await response.json();\n\n    if (this.responsePath && !isObjectType(value)) {\n      throw new Error(`Fetched value must be an object type if response path is provided, but was ${typeof value}.`);\n    }\n\n    // @ts-expect-error Unable to statically type string literal\n    value = this.responsePath ? prop(value, ...stringToPath(this.responsePath)) : value;\n\n    if (!isPlainObject(value)) {\n      throw new Error(`JSON settings from \"${this.url}\" must contain an object at the root.`);\n    }\n\n    return value;\n  }\n}\n"],"names":["constructor","options","this","fetch","url","name","responsePath","load","TypeError","response","ok","Error","String","status","statusText","value","json","isObjectType","prop","stringToPath","isPlainObject"],"mappings":"0DAUO,MAML,WAAAA,CAAmBC,GACjBC,KAAKC,MAAQF,EAAQE,MACrBD,KAAKE,IAAMH,EAAQG,IACnBF,KAAKG,KAAOJ,EAAQI,MAAQ,UAAUH,KAAKE,MAC3CF,KAAKI,aAAeL,EAAQK,YAC9B,CAEA,UAAMC,GACJ,GAA0B,mBAAfL,KAAKC,MACd,MAAM,IAAIK,UAAU,sEAGtB,MAAMC,QAAiBP,KAAKC,MAAMD,KAAKE,KAEvC,IAAKK,EAASC,GACZ,MAAM,IAAIC,MAAM,iCAAiCT,KAAKE,SAASQ,OAAOH,EAASI,WAAWJ,EAASK,cAGrG,IAAIC,QAAuBN,EAASO,OAEpC,GAAId,KAAKI,eAAiBW,EAAAA,aAAaF,GACrC,MAAM,IAAIJ,MAAM,qFAAqFI,MAMvG,GAFAA,EAAQb,KAAKI,aAAeY,OAAKH,KAAUI,EAAAA,aAAajB,KAAKI,eAAiBS,GAEzEK,EAAAA,cAAcL,GACjB,MAAM,IAAIJ,MAAM,uBAAuBT,KAAKE,4CAG9C,OAAOW,CACT"}

package/dist/cjs/sources/helpers/loadJson.cjs

@@ -0,0 +1,2 @@
+"use strict";var e=require("node:fs/promises"),t=require("remeda");exports.loadJson=async function(r,o){let n;try{n=await e.readFile(r,"utf8")}catch(e){if(o&&"object"==typeof e&&null!==e&&"code"in e&&"ENOENT"===e.code)return;throw e}const i=JSON.parse(n);if(!t.isPlainObject(i))throw new Error(`JSON settings from "${r}" must contain an object at the root.`);return i};
+//# sourceMappingURL=loadJson.cjs.map

package/dist/cjs/sources/helpers/loadJson.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadJson.cjs","sources":["../../../../src/sources/helpers/loadJson.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { isPlainObject } from 'remeda';\n\nexport function loadJson(path: string, isOptional: false): Promise<Record<string, unknown>>;\nexport function loadJson(path: string, isOptional: true): Promise<Record<string, unknown> | undefined>;\n\n// Required for overloads\n// eslint-disable-next-line prefer-arrow/prefer-arrow-functions\nexport async function loadJson(path: string, isOptional: boolean): Promise<Record<string, unknown> | undefined> {\n  let contents: string;\n\n  try {\n    contents = await readFile(path, 'utf8');\n  } catch (error) {\n    if (isOptional && typeof error === 'object' && error !== null && 'code' in error && error.code === 'ENOENT') {\n      return undefined;\n    }\n\n    throw error;\n  }\n\n  const value: unknown = JSON.parse(contents);\n\n  if (!isPlainObject(value)) {\n    throw new Error(`JSON settings from \"${path}\" must contain an object at the root.`);\n  }\n\n  return value;\n}\n"],"names":["async","path","isOptional","contents","readFile","error","code","value","JSON","parse","isPlainObject","Error"],"mappings":"oFAQOA,eAAwBC,EAAcC,GAC3C,IAAIC,EAEJ,IACEA,QAAiBC,EAAAA,SAASH,EAAM,OAClC,CAAE,MAAOI,GACP,GAAIH,GAA+B,iBAAVG,GAAgC,OAAVA,GAAkB,SAAUA,GAAwB,WAAfA,EAAMC,KACxF,OAGF,MAAMD,CACR,CAEA,MAAME,EAAiBC,KAAKC,MAAMN,GAElC,IAAKO,EAAAA,cAAcH,GACjB,MAAM,IAAII,MAAM,uBAAuBV,0CAGzC,OAAOM,CACT"}

package/dist/esm/cli/command.mjs

@@ -0,0 +1,2 @@
+export{handler}from"./handler.mjs";const e=e=>e.positional("schema",{demandOption:!0,describe:"TypeScript module that exports the inferred settings type.",type:"string"}).positional("output",{default:"appsettings.generated.d.ts",describe:"Declaration file to generate.",type:"string"}).option("type",{default:"AppSettingsConfig",describe:"Exported type name.",type:"string"}).check(({type:e})=>{if(!/^[A-Za-z_$][\w$]*$/u.test(e))throw new Error("--type must be a TypeScript identifier.");return!0}),t="generate-types <schema> <output>",r="Generate a declaration that types appsettings hooks from your schema.";export{e as builder,t as command,r as describe};
+//# sourceMappingURL=command.mjs.map

package/dist/esm/cli/command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.mjs","sources":["../../../src/cli/command.ts"],"sourcesContent":["import { type CommandBuilder } from 'yargs';\nimport { type GenerateTypesArguments } from '#cli/handler.ts';\n\nexport const builder: CommandBuilder<object, GenerateTypesArguments> = yargs =>\n  yargs\n    .positional('schema', {\n      demandOption: true,\n      describe: 'TypeScript module that exports the inferred settings type.',\n      type: 'string',\n    })\n    .positional('output', {\n      default: 'appsettings.generated.d.ts',\n      describe: 'Declaration file to generate.',\n      type: 'string',\n    })\n    .option('type', {\n      default: 'AppSettingsConfig',\n      describe: 'Exported type name.',\n      type: 'string',\n    })\n    .check(({ type }) => {\n      if (!/^[A-Za-z_$][\\w$]*$/u.test(type)) {\n        throw new Error('--type must be a TypeScript identifier.');\n      }\n\n      return true;\n    });\n\nexport const command = 'generate-types <schema> <output>';\n\nexport const describe = 'Generate a declaration that types appsettings hooks from your schema.';\n\nexport { handler } from './handler.ts';\n"],"names":["builder","yargs","positional","demandOption","describe","type","default","option","check","test","Error","command"],"mappings":"yCAGaA,EAA0DC,GACrEA,EACGC,WAAW,SAAU,CACpBC,cAAc,EACdC,SAAU,6DACVC,KAAM,WAEPH,WAAW,SAAU,CACpBI,QAAS,6BACTF,SAAU,gCACVC,KAAM,WAEPE,OAAO,OAAQ,CACdD,QAAS,oBACTF,SAAU,sBACVC,KAAM,WAEPG,MAAM,EAAGH,WACR,IAAK,sBAAsBI,KAAKJ,GAC9B,MAAM,IAAIK,MAAM,2CAGlB,OAAO,IAGAC,EAAU,mCAEVP,EAAW"}

package/dist/esm/cli/handler.mjs

@@ -0,0 +1,2 @@
+import{readFile as t,mkdir as e,writeFile as o}from"node:fs/promises";import{resolve as r,relative as s,dirname as c,sep as p}from"node:path";const i=async({output:i,schema:a,type:n})=>{const d=r(process.cwd(),a),m=r(process.cwd(),i),f=[`import type { ${n} } from '${(t=>{let e=t.split(p).join("/").replace(/\.(?:[cm]?tsx?)$/u,"");return e.startsWith(".")||(e=`./${e}`),e})(s(c(m),d))}';`,"","declare module '@next-box/appsettings' {",`  interface AppSettingsSchema extends ${n} {}`,"}","","export {};",""].join("\n");let u;try{u=await t(m,"utf8")}catch(t){if(!(t=>!!t&&"object"==typeof t&&"code"in t&&"ENOENT"===t.code)(t))throw t}u!==f&&(await e(c(m),{recursive:!0}),await o(m,f,"utf8")),process.stdout.write(`Generated ${s(process.cwd(),m)}\n`)};export{i as handler};
+//# sourceMappingURL=handler.mjs.map

package/dist/esm/cli/handler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.mjs","sources":["../../../src/cli/handler.ts"],"sourcesContent":["import { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { dirname, relative, resolve, sep } from 'node:path';\n\nconst createModuleSpecifier = (path: string): string => {\n  let specifier = path\n    .split(sep)\n    .join('/')\n    .replace(/\\.(?:[cm]?tsx?)$/u, '');\n\n  if (!specifier.startsWith('.')) {\n    specifier = `./${specifier}`;\n  }\n\n  return specifier;\n};\n\nconst isMissingFile = (error: unknown): boolean =>\n  !!error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT';\n\nexport interface GenerateTypesArguments {\n  output: string;\n  schema: string;\n  type: string;\n}\n\nexport const handler = async ({ output, schema, type }: GenerateTypesArguments): Promise<void> => {\n  const schemaPath = resolve(process.cwd(), schema);\n  const outputPath = resolve(process.cwd(), output);\n  const schemaImportPath = createModuleSpecifier(relative(dirname(outputPath), schemaPath));\n\n  const contents = [\n    `import type { ${type} } from '${schemaImportPath}';`,\n    '',\n    \"declare module '@next-box/appsettings' {\",\n    `  interface AppSettingsSchema extends ${type} {}`,\n    '}',\n    '',\n    'export {};',\n    '',\n  ].join('\\n');\n\n  let existingContents: string | undefined;\n\n  try {\n    existingContents = await readFile(outputPath, 'utf8');\n  } catch (error) {\n    if (!isMissingFile(error)) {\n      throw error;\n    }\n  }\n\n  if (existingContents !== contents) {\n    await mkdir(dirname(outputPath), { recursive: true });\n    await writeFile(outputPath, contents, 'utf8');\n  }\n\n  process.stdout.write(`Generated ${relative(process.cwd(), outputPath)}\\n`);\n};\n"],"names":["handler","async","output","schema","type","schemaPath","resolve","process","cwd","outputPath","contents","path","specifier","split","sep","join","replace","startsWith","createModuleSpecifier","relative","dirname","existingContents","readFile","error","code","isMissingFile","mkdir","recursive","writeFile","stdout","write"],"mappings":"8IAGA,MAsBaA,EAAUC,OAASC,SAAQC,SAAQC,WAC9C,MAAMC,EAAaC,EAAQC,QAAQC,MAAOL,GACpCM,EAAaH,EAAQC,QAAQC,MAAON,GAGpCQ,EAAW,CACf,iBAAiBN,aA5BS,CAACO,IAC7B,IAAIC,EAAYD,EACbE,MAAMC,GACNC,KAAK,KACLC,QAAQ,oBAAqB,IAMhC,OAJKJ,EAAUK,WAAW,OACxBL,EAAY,KAAKA,KAGZA,GAekBM,CAAsBC,EAASC,EAAQX,GAAaJ,QAI3E,GACA,2CACA,yCAAyCD,OACzC,IACA,GACA,aACA,IACAW,KAAK,MAEP,IAAIM,EAEJ,IACEA,QAAyBC,EAASb,EAAY,OAChD,CAAE,MAAOc,GACP,IA9BkB,CAACA,KACnBA,GAA0B,iBAAVA,GAAsB,SAAUA,GAAwB,WAAfA,EAAMC,KA6B1DC,CAAcF,GACjB,MAAMA,CAEV,CAEIF,IAAqBX,UACjBgB,EAAMN,EAAQX,GAAa,CAAEkB,WAAW,UACxCC,EAAUnB,EAAYC,EAAU,SAGxCH,QAAQsB,OAAOC,MAAM,aAAaX,EAASZ,QAAQC,MAAOC"}

package/dist/esm/cli.mjs

@@ -0,0 +1,2 @@
+import m from"yargs";import{hideBin as a}from"yargs/helpers";import*as o from"./cli/command.mjs";const r=async()=>{await m(a(process.argv)).scriptName("appsettings").command(o).demandCommand(1,"Choose a command to run.").strict().help().parseAsync()};export{r as runAppsettingsCli};
+//# sourceMappingURL=cli.mjs.map

package/dist/esm/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","sources":["../../src/cli.ts"],"sourcesContent":["import yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\nimport * as generateTypesCommand from './cli/command.ts';\n\nexport const runAppsettingsCli = async (): Promise<void> => {\n  await yargs(hideBin(process.argv))\n    .scriptName('appsettings')\n    .command(generateTypesCommand)\n    .demandCommand(1, 'Choose a command to run.')\n    .strict()\n    .help()\n    .parseAsync();\n};\n"],"names":["runAppsettingsCli","async","yargs","hideBin","process","argv","scriptName","command","generateTypesCommand","demandCommand","strict","help","parseAsync"],"mappings":"uGAIaA,EAAoBC,gBACzBC,EAAMC,EAAQC,QAAQC,OACzBC,WAAW,eACXC,QAAQC,GACRC,cAAc,EAAG,4BACjBC,SACAC,OACAC"}

package/dist/esm/components/AppSettingsProvider.mjs

@@ -0,0 +1,3 @@
+"use client";
+import{jsx as t}from"react/jsx-runtime";import{useMemo as e}from"react";import{AppSettingsImplementation as o}from"../config/AppSettingsImplementation.mjs";import{AppSettingsContext as r}from"../hooks/useAppSettingsContext.mjs";const n=({children:n,settings:m})=>{const i=e(()=>new o(m),[m]);return t(r,{value:i,children:n})};export{n as AppSettingsProvider};
+//# sourceMappingURL=AppSettingsProvider.mjs.map

package/dist/esm/components/AppSettingsProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppSettingsProvider.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/esm/components/Setting.mjs

@@ -0,0 +1,3 @@
+"use client";
+import{useAppSettingsContext as e}from"../hooks/useAppSettingsContext.mjs";function r({children:r,fallback:t,negate:n=!1,path:a,value:o}){const s=e().read(a),i=(Array.isArray(o)?o:[o]).includes(s);return(n?!i:i)?r:t}export{r as Setting};
+//# sourceMappingURL=Setting.mjs.map

package/dist/esm/components/Setting.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Setting.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/esm/config/AppSettingsImplementation.mjs

@@ -0,0 +1,2 @@
+import{isPlainObject as t}from"remeda";import{ScopedSettingsImplementation as e}from"./ScopedSettingsImplementation.mjs";import{ConfigReader as r}from"./ConfigReader.mjs";import{ConfigStore as s}from"./ConfigStore.mjs";class o{constructor(t){this.store=new s(t)}get(t){return this.read(t)}read(t){return new r(this.store.getSnapshot()).read(t)}getAll(){return this.store.getSnapshot()}getOrThrow(t){const e=new r(this.store.getSnapshot()).read(t);if(void 0===e)throw new Error(`Required app setting "${t}" is missing.`);return e}getSection(t){return new r(this.store.getSnapshot()).read(t)}has(t){return new r(this.store.getSnapshot()).has(t)}scope(s){const o=new r(this.store.getSnapshot()).read(s);if(!t(o))throw new Error(`App setting section "${s}" is missing.`);return new e(o,s)}}export{o as AppSettingsImplementation};
+//# sourceMappingURL=AppSettingsImplementation.mjs.map

package/dist/esm/config/AppSettingsImplementation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppSettingsImplementation.mjs","sources":["../../../src/config/AppSettingsImplementation.ts"],"sourcesContent":["import { isPlainObject } from 'remeda';\nimport { type Get } from 'type-fest';\nimport { ScopedSettingsImplementation } from '#config/ScopedSettingsImplementation.ts';\nimport { type InternalAppSettings, type ScopedSettings } from '#types/AppSettings.types.ts';\nimport { type SettingPath, type SettingSectionPath } from '#types/Config.types.ts';\nimport { ConfigReader } from './ConfigReader.ts';\nimport { ConfigStore } from './ConfigStore.ts';\n\nexport class AppSettingsImplementation<T extends object> implements InternalAppSettings<T> {\n  private readonly store: ConfigStore<T>;\n\n  constructor(settings: T) {\n    this.store = new ConfigStore(settings);\n  }\n\n  get<P extends SettingPath<T>>(path: P): Get<T, P> | undefined;\n  get(path: string): unknown {\n    return this.read(path);\n  }\n\n  read(path: string): unknown {\n    return new ConfigReader(this.store.getSnapshot()).read(path);\n  }\n\n  getAll(): Readonly<T> {\n    return this.store.getSnapshot();\n  }\n\n  getOrThrow<P extends SettingPath<T>>(path: P): Get<T, P>;\n  getOrThrow(path: string): unknown {\n    const value = new ConfigReader(this.store.getSnapshot()).read(path);\n\n    if (value === undefined) {\n      throw new Error(`Required app setting \"${path}\" is missing.`);\n    }\n\n    return value;\n  }\n\n  getSection<P extends SettingSectionPath<T>>(path: P): Get<T, P> | undefined;\n  getSection(path: string): unknown {\n    return new ConfigReader(this.store.getSnapshot()).read(path);\n  }\n\n  has(path: SettingPath<T> | SettingSectionPath<T>): boolean;\n  has(path: string): boolean {\n    return new ConfigReader(this.store.getSnapshot()).has(path);\n  }\n\n  scope<P extends SettingSectionPath<T>>(path: P): ScopedSettings<Extract<Get<T, P>, object>>;\n  scope(path: string): ScopedSettings<object> {\n    const reader = new ConfigReader(this.store.getSnapshot());\n    const section = reader.read(path);\n\n    if (!isPlainObject(section)) {\n      throw new Error(`App setting section \"${path}\" is missing.`);\n    }\n\n    return new ScopedSettingsImplementation(section, path);\n  }\n}\n"],"names":["AppSettingsImplementation","constructor","settings","this","store","ConfigStore","get","path","read","ConfigReader","getSnapshot","getAll","getOrThrow","value","undefined","Error","getSection","has","scope","section","isPlainObject","ScopedSettingsImplementation"],"mappings":"2NAQO,MAAMA,EAGX,WAAAC,CAAYC,GACVC,KAAKC,MAAQ,IAAIC,EAAYH,EAC/B,CAGAI,GAAAA,CAAIC,GACF,OAAOJ,KAAKK,KAAKD,EACnB,CAEAC,IAAAA,CAAKD,GACH,OAAO,IAAIE,EAAaN,KAAKC,MAAMM,eAAeF,KAAKD,EACzD,CAEAI,MAAAA,GACE,OAAOR,KAAKC,MAAMM,aACpB,CAGAE,UAAAA,CAAWL,GACT,MAAMM,EAAQ,IAAIJ,EAAaN,KAAKC,MAAMM,eAAeF,KAAKD,GAE9D,QAAcO,IAAVD,EACF,MAAM,IAAIE,MAAM,yBAAyBR,kBAG3C,OAAOM,CACT,CAGAG,UAAAA,CAAWT,GACT,OAAO,IAAIE,EAAaN,KAAKC,MAAMM,eAAeF,KAAKD,EACzD,CAGAU,GAAAA,CAAIV,GACF,OAAO,IAAIE,EAAaN,KAAKC,MAAMM,eAAeO,IAAIV,EACxD,CAGAW,KAAAA,CAAMX,GACJ,MACMY,EADS,IAAIV,EAAaN,KAAKC,MAAMM,eACpBF,KAAKD,GAE5B,IAAKa,EAAcD,GACjB,MAAM,IAAIJ,MAAM,wBAAwBR,kBAG1C,OAAO,IAAIc,EAA6BF,EAASZ,EACnD"}

package/dist/esm/config/ConfigMerger.mjs

@@ -0,0 +1,2 @@
+import{mergeDeep as e}from"remeda";class r{merge(r,...m){return m.reduce((r,m)=>e(r,m),r)}}export{r as ConfigMerger};
+//# sourceMappingURL=ConfigMerger.mjs.map

package/dist/esm/config/ConfigMerger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigMerger.mjs","sources":["../../../src/config/ConfigMerger.ts"],"sourcesContent":["import { mergeDeep } from 'remeda';\n\nexport class ConfigMerger {\n  merge<T extends object>(first: T, ...configs: readonly T[]): T {\n    // TypeScript cannot guarantee that merging arbitrary objects produces T\n    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions\n    return configs.reduce((merged, config) => mergeDeep(merged, config) as T, first);\n  }\n}\n"],"names":["ConfigMerger","merge","first","configs","reduce","merged","config","mergeDeep"],"mappings":"mCAEO,MAAMA,EACXC,KAAAA,CAAwBC,KAAaC,GAGnC,OAAOA,EAAQC,OAAO,CAACC,EAAQC,IAAWC,EAAUF,EAAQC,GAAcJ,EAC5E"}

package/dist/esm/config/ConfigReader.mjs

@@ -0,0 +1,2 @@
+import{isPlainObject as t}from"remeda";import{createConfigReader as r}from"zcb";class e{constructor(t){this.config=t,this.reader=r(t)}getAt(r){return r.split(".").reduce((r,e)=>{if(t(r))return r[e]},this.config)}get(t){return this.reader.read(t)}getSection(t){return this.getAt(t)}has(t){return void 0!==this.getAt(t)}read(t){return this.getAt(t)}scope(t){return this.reader.scope(t)}}export{e as ConfigReader};
+//# sourceMappingURL=ConfigReader.mjs.map

package/dist/esm/config/ConfigReader.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigReader.mjs","sources":["../../../src/config/ConfigReader.ts"],"sourcesContent":["import { isPlainObject } from 'remeda';\nimport { type Get } from 'type-fest';\nimport { type Path, type Scope, type ConfigReader as ZcbConfigReader, createConfigReader } from 'zcb';\n\nexport class ConfigReader<T extends object> {\n  private reader: ZcbConfigReader<T>;\n  private readonly config: T;\n\n  constructor(config: T) {\n    this.config = config;\n    this.reader = createConfigReader(config);\n  }\n\n  private getAt(path: string): unknown {\n    return path.split('.').reduce<unknown>((current, key) => {\n      if (!isPlainObject(current)) {\n        return;\n      }\n\n      return current[key];\n    }, this.config);\n  }\n\n  public get<P extends Path<T>>(path: P): Get<T, P> {\n    return this.reader.read(path);\n  }\n\n  public getSection<P extends Scope<T>>(path: P): Get<T, P> {\n    // Required as underlying getAt needs to be kept permissive\n    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions\n    return this.getAt(path) as Get<T, P>;\n  }\n\n  public has(path: string): boolean {\n    return this.getAt(path) !== undefined;\n  }\n\n  public read(path: string): unknown {\n    return this.getAt(path);\n  }\n\n  public scope<P extends Scope<T>>(path: P): ZcbConfigReader<Get<T, P>> {\n    return this.reader.scope(path);\n  }\n}\n"],"names":["ConfigReader","constructor","config","this","reader","createConfigReader","getAt","path","split","reduce","current","key","isPlainObject","get","read","getSection","has","undefined","scope"],"mappings":"gFAIO,MAAMA,EAIX,WAAAC,CAAYC,GACVC,KAAKD,OAASA,EACdC,KAAKC,OAASC,EAAmBH,EACnC,CAEQI,KAAAA,CAAMC,GACZ,OAAOA,EAAKC,MAAM,KAAKC,OAAgB,CAACC,EAASC,KAC/C,GAAKC,EAAcF,GAInB,OAAOA,EAAQC,IACdR,KAAKD,OACV,CAEOW,GAAAA,CAAuBN,GAC5B,OAAOJ,KAAKC,OAAOU,KAAKP,EAC1B,CAEOQ,UAAAA,CAA+BR,GAGpC,OAAOJ,KAAKG,MAAMC,EACpB,CAEOS,GAAAA,CAAIT,GACT,YAA4BU,IAArBd,KAAKG,MAAMC,EACpB,CAEOO,IAAAA,CAAKP,GACV,OAAOJ,KAAKG,MAAMC,EACpB,CAEOW,KAAAA,CAA0BX,GAC/B,OAAOJ,KAAKC,OAAOc,MAAMX,EAC3B"}

package/dist/esm/config/ConfigStore.mjs

@@ -0,0 +1,2 @@
+import{clone as s}from"remeda";import{freezeDeep as t}from"./helpers/freezeDeep.mjs";class e{constructor(e){this.getSnapshot=()=>this.snapshot,this.snapshot=t(s(e))}}export{e as ConfigStore};
+//# sourceMappingURL=ConfigStore.mjs.map

package/dist/esm/config/ConfigStore.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigStore.mjs","sources":["../../../src/config/ConfigStore.ts"],"sourcesContent":["import { clone } from 'remeda';\nimport { freezeDeep } from '#config/helpers/freezeDeep.ts';\n\nexport class ConfigStore<T extends object> {\n  private snapshot: Readonly<T>;\n\n  public getSnapshot = (): Readonly<T> => this.snapshot;\n\n  constructor(initial: T) {\n    this.snapshot = freezeDeep(clone(initial));\n  }\n}\n"],"names":["ConfigStore","constructor","initial","getSnapshot","this","snapshot","freezeDeep","clone"],"mappings":"qFAGO,MAAMA,EAKX,WAAAC,CAAYC,QAFLC,YAAc,IAAmBC,KAAKC,SAG3CD,KAAKC,SAAWC,EAAWC,EAAML,GACnC"}

package/dist/esm/config/ConfigValidator.mjs

@@ -0,0 +1,2 @@
+class s{constructor(s){this.schema=s}validate(s){return this.schema.parse(s)}}export{s as ConfigValidator};
+//# sourceMappingURL=ConfigValidator.mjs.map