@docupace/ihub-config 1.1.21 → 1.1.22-admin.1

package/README.md

@@ -1,182 +1,182 @@
-# @docupace/ihub-config
-
-Reusable GraphQL config extension and standalone server extracted from the
-Docupace GraphQL server.
-
-## Run locally
-
-```bash
-pnpm install
-```
-
-To run the package as a standalone GraphQL server, copy
-`.env.example` to `.env`, fill in the required values, and start the dev
-server:
-
-```bash
-cp .env.example .env
-pnpm start:dev
-```
-
-The standalone server listens on `http://localhost:4000/api/graphql`.
-
-## Use as an extension in another server
-
-```ts
-import { getConfigExtension } from '@docupace/ihub-config';
-```
-
-Then add the returned extension to the host server's extensions array:
-
-```ts
-const configExtension = await getConfigExtension();
-
-const serverInfo: ServerConfig = {
-  instanceConfig: instanceConfig,
-  extensions: [docupaceExtension, configExtension],
-  port: 4000,
-  createContext,
-};
-```
-
-Extend the config extension with domain-specific providers, resolvers, etc.
-
-```ts
-import { getConfigExtension } from '@docupace/ihub-config';
-import {
-  DashboardPageConfigProvider,
-  TablePageConfigProvider,
-  AnyPageConfigProvider,
-  DetailsPageConfigProvider,
-} from './your-host-config-providers.js';
-import { configResolvers } from './your-host-config-resolvers.js';
-
-const APPLICATION_PREFERENCE_PREFIX = 'applicationPreference';
-
-const applicationPreferenceResolver = async (keys, context) => {
-  const data = await loadApplicationPreferences(keys, context);
-
-  const result: Record<string, string | undefined> = {};
-  keys.forEach((key) => (result[key] = undefined));
-  data.records.forEach((record: { name: string; value: string }) => {
-    result[record.name] = record.value;
-  });
-
-  return result;
-};
-
-const configExtension = await getConfigExtension({
-  configInjectorResolvers: {
-    [APPLICATION_PREFERENCE_PREFIX]: applicationPreferenceResolver,
-  },
-  providers: {
-    DashboardPage: DashboardPageConfigProvider,
-    TablePage: TablePageConfigProvider,
-    AnyPage: AnyPageConfigProvider,
-    DetailsPage: DetailsPageConfigProvider,
-  },
-  resolvers: configResolvers,
-});
-```
-
-### `configInjectorResolvers`
-
-Use `configInjectorResolvers` to resolve template expressions embedded in config
-values, for example:
-
-```ts
-$${applicationPreference:timezone}
-```
-
-Each key in `configInjectorResolvers` is a template prefix, and each value is an
-async resolver function with this shape:
-
-```ts
-type ResolverFunction = (
-  keys: string[],
-  context: any,
-) => Promise<Record<string, any>>;
-```
-
-When config processing encounters `$${prefix:key}`, it looks up the resolver for
-that `prefix`, batches the requested keys, and replaces the template with the
-resolved value. This is the right place to connect host-specific data sources
-such as application preferences, tenant settings, or user-scoped values.
-
-### `providers`
-
-Use `providers` to register config processors by `__typename`. A provider runs
-after nested config values have been loaded and template expressions have been
-resolved, and can reshape or enrich the final config object before it is
-returned.
-
-```ts
-providers: {
-  DashboardPage: DashboardPageConfigProvider,
-  TablePage: TablePageConfigProvider,
-  AnyPage: AnyPageConfigProvider,
-  DetailsPage: DetailsPageConfigProvider,
-}
-```
-
-Each provider must be a class with a `processConfig` method:
-
-```ts
-interface ConfigProvider {
-  processConfig(config: any, configService: ConfigService, context: any): any;
-}
-```
-
-This is useful for page-specific post-processing such as normalizing fragments,
-rewriting references, or deriving extra fields for a particular page type.
-Built-in providers are preserved and host providers are merged in on top.
-
-### `resolvers`
-
-Use `resolvers` to extend the GraphQL API exposed by the config extension.
-Resolvers are provided as factories so they can receive the initialized
-`configService` instance:
-
-```ts
-const configResolvers = {
-  query: ({ configService }) => ({
-    pages: () => ({
-      myCustomPage: async (obj: { path: string }, context: any) => {
-        return await configService.getDirectConfig(obj.path, context);
-      },
-    }),
-  }),
-  mutation: ({ configService }) => ({
-    pages: () => ({
-      refreshCustomConfig: async () => {
-        await configService.init();
-        return true;
-      },
-    }),
-  }),
-};
-```
-
-Host query and mutation resolvers are deep-merged with the built-in config
-resolvers, so you can add new fields without re-declaring the entire resolver
-tree. If the same field exists in both places, the host resolver wins.
-
-If you want to pass config stores programmatically instead of through
-environment variables, `getConfigExtension` also accepts `configStores` (usually used for tests only).
-
-## Environment variables
-
-Config stores are discovered from environment variables grouped by prefix such
-as `STANDARD` or `SITE`:
-
-- `<PREFIX>_CONFIG_LOCAL_PATH`
-- `<PREFIX>_CONFIG_REMOTE_PATH`
-- `<PREFIX>_CONFIG_REMOTE_BRANCH`
-- `<PREFIX>_CONFIG_PRIORITY`
-- `<PREFIX>_CONFIG_NAME`
-
-`<PREFIX>_CONFIG_PRIORITY` is required for every configured store.
-
-`CONFIG_LOCAL_PATH_ROOT` can be used as a fallback base path when
-`<PREFIX>_CONFIG_LOCAL_PATH` is omitted, but the store still needs enough
-configuration to be discovered.
+# @docupace/ihub-config
+
+Reusable GraphQL config extension and standalone server extracted from the
+Docupace GraphQL server.
+
+## Run locally
+
+```bash
+pnpm install
+```
+
+To run the package as a standalone GraphQL server, copy
+`.env.example` to `.env`, fill in the required values, and start the dev
+server:
+
+```bash
+cp .env.example .env
+pnpm start:dev
+```
+
+The standalone server listens on `http://localhost:4000/api/graphql`.
+
+## Use as an extension in another server
+
+```ts
+import { getConfigExtension } from '@docupace/ihub-config';
+```
+
+Then add the returned extension to the host server's extensions array:
+
+```ts
+const configExtension = await getConfigExtension();
+
+const serverInfo: ServerConfig = {
+  instanceConfig: instanceConfig,
+  extensions: [docupaceExtension, configExtension],
+  port: 4000,
+  createContext,
+};
+```
+
+Extend the config extension with domain-specific providers, resolvers, etc.
+
+```ts
+import { getConfigExtension } from '@docupace/ihub-config';
+import {
+  DashboardPageConfigProvider,
+  TablePageConfigProvider,
+  AnyPageConfigProvider,
+  DetailsPageConfigProvider,
+} from './your-host-config-providers.js';
+import { configResolvers } from './your-host-config-resolvers.js';
+
+const APPLICATION_PREFERENCE_PREFIX = 'applicationPreference';
+
+const applicationPreferenceResolver = async (keys, context) => {
+  const data = await loadApplicationPreferences(keys, context);
+
+  const result: Record<string, string | undefined> = {};
+  keys.forEach((key) => (result[key] = undefined));
+  data.records.forEach((record: { name: string; value: string }) => {
+    result[record.name] = record.value;
+  });
+
+  return result;
+};
+
+const configExtension = await getConfigExtension({
+  configInjectorResolvers: {
+    [APPLICATION_PREFERENCE_PREFIX]: applicationPreferenceResolver,
+  },
+  providers: {
+    DashboardPage: DashboardPageConfigProvider,
+    TablePage: TablePageConfigProvider,
+    AnyPage: AnyPageConfigProvider,
+    DetailsPage: DetailsPageConfigProvider,
+  },
+  resolvers: configResolvers,
+});
+```
+
+### `configInjectorResolvers`
+
+Use `configInjectorResolvers` to resolve template expressions embedded in config
+values, for example:
+
+```ts
+$${applicationPreference:timezone}
+```
+
+Each key in `configInjectorResolvers` is a template prefix, and each value is an
+async resolver function with this shape:
+
+```ts
+type ResolverFunction = (
+  keys: string[],
+  context: any,
+) => Promise<Record<string, any>>;
+```
+
+When config processing encounters `$${prefix:key}`, it looks up the resolver for
+that `prefix`, batches the requested keys, and replaces the template with the
+resolved value. This is the right place to connect host-specific data sources
+such as application preferences, tenant settings, or user-scoped values.
+
+### `providers`
+
+Use `providers` to register config processors by `__typename`. A provider runs
+after nested config values have been loaded and template expressions have been
+resolved, and can reshape or enrich the final config object before it is
+returned.
+
+```ts
+providers: {
+  DashboardPage: DashboardPageConfigProvider,
+  TablePage: TablePageConfigProvider,
+  AnyPage: AnyPageConfigProvider,
+  DetailsPage: DetailsPageConfigProvider,
+}
+```
+
+Each provider must be a class with a `processConfig` method:
+
+```ts
+interface ConfigProvider {
+  processConfig(config: any, configService: ConfigService, context: any): any;
+}
+```
+
+This is useful for page-specific post-processing such as normalizing fragments,
+rewriting references, or deriving extra fields for a particular page type.
+Built-in providers are preserved and host providers are merged in on top.
+
+### `resolvers`
+
+Use `resolvers` to extend the GraphQL API exposed by the config extension.
+Resolvers are provided as factories so they can receive the initialized
+`configService` instance:
+
+```ts
+const configResolvers = {
+  query: ({ configService }) => ({
+    pages: () => ({
+      myCustomPage: async (obj: { path: string }, context: any) => {
+        return await configService.getDirectConfig(obj.path, context);
+      },
+    }),
+  }),
+  mutation: ({ configService }) => ({
+    pages: () => ({
+      refreshCustomConfig: async () => {
+        await configService.init();
+        return true;
+      },
+    }),
+  }),
+};
+```
+
+Host query and mutation resolvers are deep-merged with the built-in config
+resolvers, so you can add new fields without re-declaring the entire resolver
+tree. If the same field exists in both places, the host resolver wins.
+
+If you want to pass config stores programmatically instead of through
+environment variables, `getConfigExtension` also accepts `configStores` (usually used for tests only).
+
+## Environment variables
+
+Config stores are discovered from environment variables grouped by prefix such
+as `STANDARD` or `SITE`:
+
+- `<PREFIX>_CONFIG_LOCAL_PATH`
+- `<PREFIX>_CONFIG_REMOTE_PATH`
+- `<PREFIX>_CONFIG_REMOTE_BRANCH`
+- `<PREFIX>_CONFIG_PRIORITY`
+- `<PREFIX>_CONFIG_NAME`
+
+`<PREFIX>_CONFIG_PRIORITY` is required for every configured store.
+
+`CONFIG_LOCAL_PATH_ROOT` can be used as a fallback base path when
+`<PREFIX>_CONFIG_LOCAL_PATH` is omitted, but the store still needs enough
+configuration to be discovered.

package/dist/config-extension.d.ts

@@ -3,11 +3,34 @@ import { ConfigStoreParams } from './config-service.js';
 import type { ConfigInjectorResolvers } from './injector-resolvers/config-injector.js';
 import type { ConfigProviders } from './providers/index.js';
 import type { ConfigResolversConfig } from './resolvers/index.js';
+export interface ConfigurationOverride {
+    value: string;
+    contentType?: string | null;
+}
+export interface ConfigurationOverrideResult {
+    /** The whole-object override for `configPath`, if one is set. */
+    whole: ConfigurationOverride | null;
+    /**
+     * One winning value per distinct JSONPath found for `configPath` (e.g.
+     * `{ '$.columns': [...] }`), scope-resolved for the current identity.
+     * `null` when there are no sub-path override rows for `configPath` at all.
+     */
+    subPaths: Record<string, unknown> | null;
+}
+export interface ConfigurationOverrideProvider {
+    /**
+     * Resolves both the whole-object override and any sub-path overrides for
+     * `configPath` in a single lookup, since both are drawn from the same set
+     * of override rows.
+     */
+    resolve(configPath: string, context: any): Promise<ConfigurationOverrideResult>;
+}
 export interface ConfigExtensionOptions {
     configInjectorResolvers?: ConfigInjectorResolvers;
     providers?: ConfigProviders;
     resolvers?: ConfigResolversConfig;
     configStores?: ConfigStoreParams[];
+    configurationOverrideProvider?: ConfigurationOverrideProvider;
 }
 export declare const getConfigExtension: (options?: ConfigExtensionOptions) => Promise<ExtensionConfig>;
 //# sourceMappingURL=config-extension.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config-extension.d.ts","sourceRoot":"","sources":["../src/config-extension.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAwB,MAAM,qBAAqB,CAAC;AAE9E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAEvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,MAAM,WAAW,sBAAsB;IACrC,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAClD,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACpC;AA8BD,eAAO,MAAM,kBAAkB,GAC7B,UAAS,sBAA2B,KACnC,OAAO,CAAC,eAAe,CA2BzB,CAAC"}
+{"version":3,"file":"config-extension.d.ts","sourceRoot":"","sources":["../src/config-extension.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAwB,MAAM,qBAAqB,CAAC;AAE9E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAEvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,iEAAiE;IACjE,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACpC;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,GAAG,GACX,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAClD,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACnC,6BAA6B,CAAC,EAAE,6BAA6B,CAAC;CAC/D;AA+BD,eAAO,MAAM,kBAAkB,GAC7B,UAAS,sBAA2B,KACnC,OAAO,CAAC,eAAe,CA4BzB,CAAC"}

package/dist/config-extension.js

@@ -25,6 +25,7 @@ const initializeConfigStores = async (configStores) => {
         configInjectorResolvers: undefined,
         providers: undefined,
         resolvers: undefined,
+        configurationOverrideProvider: undefined,
     });
     await configService.init();
 };
@@ -37,6 +38,7 @@ export const getConfigExtension = async (options = {}) => {
         providers: options.providers,
         resolvers: options.resolvers,
         configStores,
+        configurationOverrideProvider: options.configurationOverrideProvider,
     });
     return {
         name: 'config',

package/dist/config-extension.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-extension.js","sourceRoot":"","sources":["../src/config-extension.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAqB,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAGrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AASrD,MAAM,qBAAqB,GAAG,CAAC,YAAiC,EAAE,EAAE;IAClE,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACxC,GAAG,EAAE,WAAW,CAAC,GAAG;QACpB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,SAAS,EAAE,WAAW,CAAC,SAAS;QAChC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC;QACvD,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,YAAY,EAAE,WAAW,CAAC,YAAY;KACvC,CAAC,CAAC,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,KAAK,EAAE,YAAiC,EAAE,EAAE;IACzE,GAAG,CAAC,IAAI,CAAC;QACP,YAAY,EAAE,qBAAqB,CAAC,YAAY,CAAC;KAClD,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,oBAAoB,CAAC;QACzC,KAAK,EAAE,SAAS;QAChB,YAAY;QACZ,uBAAuB,EAAE,SAAS;QAClC,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;KACrB,CAAC,CAAC;IAEH,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,UAAkC,EAAE,EACV,EAAE;IAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,eAAe,EAAE,CAAC;IAE/D,MAAM,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAE3C,MAAM,gBAAgB,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CACxD,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAC7C,CAAC;IAEF,MAAM,WAAW,GAAG,uBAAuB,CAAC;QAC1C,uBAAuB,EAAE,OAAO,CAAC,uBAAuB;QACxD,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,YAAY;KACb,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,CAAC,mBAAmB,EAAE,EAAE,GAAG,gBAAgB,CAAC;QACxD,OAAO,EAAE;YACP;gBACE,WAAW;aACZ;SACF;QACD,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"config-extension.js","sourceRoot":"","sources":["../src/config-extension.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAqB,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAGrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAsCrD,MAAM,qBAAqB,GAAG,CAAC,YAAiC,EAAE,EAAE;IAClE,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACxC,GAAG,EAAE,WAAW,CAAC,GAAG;QACpB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,SAAS,EAAE,WAAW,CAAC,SAAS;QAChC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC;QACvD,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,YAAY,EAAE,WAAW,CAAC,YAAY;KACvC,CAAC,CAAC,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,KAAK,EAAE,YAAiC,EAAE,EAAE;IACzE,GAAG,CAAC,IAAI,CAAC;QACP,YAAY,EAAE,qBAAqB,CAAC,YAAY,CAAC;KAClD,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,oBAAoB,CAAC;QACzC,KAAK,EAAE,SAAS;QAChB,YAAY;QACZ,uBAAuB,EAAE,SAAS;QAClC,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;QACpB,6BAA6B,EAAE,SAAS;KACzC,CAAC,CAAC;IAEH,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,UAAkC,EAAE,EACV,EAAE;IAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,eAAe,EAAE,CAAC;IAE/D,MAAM,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAE3C,MAAM,gBAAgB,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CACxD,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAC7C,CAAC;IAEF,MAAM,WAAW,GAAG,uBAAuB,CAAC;QAC1C,uBAAuB,EAAE,OAAO,CAAC,uBAAuB;QACxD,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,YAAY;QACZ,6BAA6B,EAAE,OAAO,CAAC,6BAA6B;KACrE,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,CAAC,mBAAmB,EAAE,EAAE,GAAG,gBAAgB,CAAC;QACxD,OAAO,EAAE;YACP;gBACE,WAAW;aACZ;SACF;QACD,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC,CAAC"}

package/dist/config-service.d.ts

@@ -23,6 +23,7 @@ export interface DefaultConfigServiceParams {
     configInjectorResolvers: ConfigExtensionOptions['configInjectorResolvers'];
     providers: ConfigExtensionOptions['providers'];
     resolvers: ConfigExtensionOptions['resolvers'];
+    configurationOverrideProvider: ConfigExtensionOptions['configurationOverrideProvider'];
 }
 export declare class ConfigFileStore implements ConfigStore {
     private readonly localPath;
@@ -48,6 +49,7 @@ declare class ConfigService {
     private readonly configInjectorResolvers;
     private readonly providers;
     private readonly resolvers;
+    private readonly configurationOverrideProvider;
     constructor(model: Model | undefined, configStores: ConfigStore[], extensionOptions?: ConfigExtensionOptions);
     private filterConfigsBySearch;
     private appendTestConfigPaths;
@@ -58,10 +60,14 @@ declare class ConfigService {
     private processObjectArray;
     private processObjectProperties;
     private applyReferenceOverrides;
+    private applyReferenceExtensions;
     private processReferencedObject;
     private injectConfigValue;
     generateResolvers(): void;
-    processConfig(config: any, context: any, processProviders?: boolean): Promise<any>;
+    processConfig(config: any, context: any, processProviders?: boolean, rootSubPathOverrides?: Record<string, unknown> | null): Promise<any>;
+    private processConfigTree;
+    private applyConfigPathOverride;
+    private applyTypenameProvider;
     getRefConfig(configPath: string, refConfigPath: string, context: any, values?: any): Promise<any>;
     updatePathValues(obj: any, inputPath: string): any;
     flattenArray(arr: any[]): any[];
@@ -69,7 +75,10 @@ declare class ConfigService {
     private processImageReference;
     processObject(configPath: string, obj: any, context: any, values?: any): Promise<any>;
     private getFileMimeType;
-    getConfigFromStore(path: string): Promise<any>;
+    getConfigFromStore(configPath: string, context?: any): Promise<{
+        config: any;
+        subPathOverrides: Record<string, unknown> | null;
+    }>;
     hasConfig(configPath: string): Promise<boolean>;
     getConfig(configPath: string, context: any, values?: any, processProviders?: boolean): Promise<any>;
     getDirectConfig(configPath: string, context: any, values?: any, processProviders?: boolean): Promise<any>;
@@ -98,6 +107,6 @@ declare class ConfigService {
     getPageConfig(pagePath: string, context: any, processConfig?: boolean, rulesContext?: any): Promise<any>;
     init(): Promise<void[]>;
 }
-export declare const defaultConfigService: ({ model, configStores, configInjectorResolvers, providers, resolvers, }: DefaultConfigServiceParams) => ConfigService;
+export declare const defaultConfigService: ({ model, configStores, configInjectorResolvers, providers, resolvers, configurationOverrideProvider, }: DefaultConfigServiceParams) => ConfigService;
 export default ConfigService;
 //# sourceMappingURL=config-service.d.ts.map

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

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