@docupace/ihub-config 1.1.29 → 1.1.30

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-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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"}

package/dist/config-service.js

@@ -160,19 +160,28 @@ function expandRefOverrideElements(value, refRoot) {
 // *ordered* array of layers per jsonPath
 // (broadest to narrowest — see `ConfigurationOverrideResult.subPaths`), not
 // a single already-resolved value. The overlay uses only the narrowest
-// (last) layer, same approximation as before cascading existed: a catalog
-// like `$.predefinedColumns`/`$.predefinedFilters` is always saved as a full
-// replacement at a single scope in practice (never a partial patch spread
-// across tiers), so the narrowest present layer already *is* effectively
-// the whole value — exactly what this overlay used before this function
-// took an array at all.
+// (last) layer — folded onto `config`'s own base value for that key, not
+// substituted outright. That layer is a snapshot from whenever the catalog
+// (e.g. `$.predefinedColumns`) was last fully replaced; a catalog entry
+// added to the template afterward exists on `config` but not in the
+// snapshot, so a plain substitution left any `$ref` into it unresolvable —
+// dropped silently, same as a `$ref` to an actually-deleted entry. Folding
+// gives it the same base fallback `$.predefinedColumns`'s own resolution
+// already gets via `mergeSubPathOverrideValue`.
 function buildRefResolutionRoot(config, subPathPatch) {
     const overlay = {};
     for (const [jsonPath, layers] of Object.entries(subPathPatch)) {
         const topLevelMatch = /^\$\.([^.[]+)$/.exec(jsonPath);
-        if (topLevelMatch && layers.length) {
-            overlay[topLevelMatch[1]] = layers[layers.length - 1];
+        if (!topLevelMatch || !layers.length) {
+            continue;
         }
+        const key = topLevelMatch[1];
+        const narrowestLayer = layers.at(-1);
+        const baseValue = config[key];
+        overlay[key] =
+            isNamedObjectArray(baseValue) && isNamedObjectArray(narrowestLayer)
+                ? mergeNamedObjectArray(baseValue, narrowestLayer, isSelfContainedOverrideElement)
+                : narrowestLayer;
     }
     return { ...config, ...overlay };
 }
@@ -510,7 +519,7 @@ class ConfigService {
     appendTestConfigPaths(tests, basePath) {
         return tests.map((test) => ({
             ...test,
-            configPath: path.join(basePath, test.configPath),
+            configPath: path.posix.join(basePath, test.configPath),
         }));
     }
     mapDataRecords(config) {
@@ -646,38 +655,38 @@ class ConfigService {
                         ]);
                     },
                     get: async (_obj, context) => {
-                        return await this.getConfig(path.join('widgets/widgetA', 'widgets'), context, null, true);
+                        return await this.getConfig(path.posix.join('widgets/widgetA', 'widgets'), context, null, true);
                     },
                 }),
                 tests: () => ({
                     list: async (obj, context) => {
-                        const tests = await this.getConfig(path.join('tests', obj.path), context, null, true);
+                        const tests = await this.getConfig(path.posix.join('tests', obj.path), context, null, true);
                         const filteredTests = this.filterConfigsBySearch(tests, obj.search, ['name', 'description']);
                         const processedTests = this.appendTestConfigPaths(filteredTests, obj.path);
                         return { items: processedTests };
                     },
                     getConfig: async (obj, context) => {
-                        return await this.getConfig(path.join('tests', obj.path), context, null, true);
+                        return await this.getConfig(path.posix.join('tests', obj.path), context, null, true);
                     },
                 }),
                 themes: () => ({
                     get: async (obj, context) => {
-                        return await this.getConfig(path.join('themes', obj.path), context, null, true);
+                        return await this.getConfig(path.posix.join('themes', obj.path), context, null, true);
                     },
                 }),
                 data: () => ({
                     list: async (obj) => {
-                        return await this.listDirectConfigs(path.join('data', obj.path));
+                        return await this.listDirectConfigs(path.posix.join('data', obj.path));
                     },
                     get: async (obj, context) => {
-                        const config = await this.getDirectConfig(path.join('data', obj.path), context, null, true);
+                        const config = await this.getDirectConfig(path.posix.join('data', obj.path), context, null, true);
                         if (!Array.isArray(config)) {
                             return null;
                         }
                         return this.mapDataRecords(config);
                     },
                     getSeedConfig: async (obj, context) => {
-                        return await this.getDirectConfig(path.join('data', obj.path), context, null, true);
+                        return await this.getDirectConfig(path.posix.join('data', obj.path), context, null, true);
                     },
                 }),
             };
@@ -695,7 +704,7 @@ class ConfigService {
                 },
                 pages: () => ({
                     updateDashboard: async (obj, context) => {
-                        const configPath = path.join('pages', 'dashboard');
+                        const configPath = path.posix.join('pages', 'dashboard');
                         return await this.updateConfig(configPath, {
                             __typename: 'DashboardPage',
                             ...obj.input,
@@ -990,7 +999,7 @@ class ConfigService {
         return (await Promise.all(this.configStores.map((configStore) => configStore.hasConfig(configPath)))).some(Boolean);
     }
     async getConfig(configPath, context, values, processProviders) {
-        const globalPath = path.join('global', configPath);
+        const globalPath = path.posix.join('global', configPath);
         return this.getDirectConfig(globalPath, context, values, processProviders);
     }
     async getDirectConfig(configPath, context, values, processProviders) {
@@ -1034,7 +1043,7 @@ class ConfigService {
         return [...new Set(configs.flat())];
     }
     async updateConfig(configPath, config, context) {
-        const globalPath = path.join('global', configPath);
+        const globalPath = path.posix.join('global', configPath);
         await this.configStores[0].updateConfig(globalPath, config);
         return await this.getConfig(configPath, context, null, true);
     }
@@ -1354,7 +1363,7 @@ class ConfigService {
         const allRuleGroups = [];
         for (const ruleFile of ruleFiles) {
             try {
-                const ruleGroups = await this.getDirectConfig(path.join('global', 'rules', ruleFile), context, null, false);
+                const ruleGroups = await this.getDirectConfig(path.posix.join('global', 'rules', ruleFile), context, null, false);
                 if (Array.isArray(ruleGroups)) {
                     allRuleGroups.push(...ruleGroups);
                 }
@@ -1376,7 +1385,7 @@ class ConfigService {
         });
     }
     async getPageConfig(pagePath, context, processConfig, rulesContext) {
-        const globalPath = path.join('global', 'pages', pagePath);
+        const globalPath = path.posix.join('global', 'pages', pagePath);
         const { config: obj, subPathOverrides, whole, } = await this.getConfigFromStore(globalPath, context);
         const fullObj = await this.processObject(globalPath, obj, context, null);
         const matchingRuleGroups = await this.getRuleGroups(rulesContext, context);