@docupace/ihub-config 1.1.17 → 1.1.18

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

@@ -75,7 +75,15 @@ declare class ConfigService {
     getDirectConfig(configPath: string, context: any, values?: any, processProviders?: boolean): Promise<any>;
     listDirectConfigs(configPath: string): Promise<any[]>;
     updateConfig(configPath: string, config: any, context: any): Promise<any>;
-    getPageConfig(pagePath: string, context: any, processConfig?: boolean): Promise<any>;
+    private normalizePathForMatching;
+    private applyFieldRuleToElement;
+    private applyOverridesToConfig;
+    private resolveQuerySelectOptions;
+    private inlineQuerySelectOptions;
+    private stripNulls;
+    private applyFieldRuleOverrides;
+    getRuleGroups(rulesContext: any, context: any): Promise<any[]>;
+    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;

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

@@ -1,7 +1,7 @@
 import path from 'node:path';
 import { promises as fsPromises } from 'node:fs';
 import { simpleGit } from 'simple-git';
-import { _logger as log } from './globals.js';
+import { _logger as log, cliOptions } from './globals.js';
 import { GraphQLError } from 'graphql';
 import { fileExists } from './lib/file-system.js';
 import replaceDotsOutsideExpressions from './lib/replace-dots-outside-expressions.js';
@@ -10,6 +10,7 @@ import { injectConfigValue, } from './injector-resolvers/config-injector.js';
 import { builtInProviders } from './providers/index.js';
 import { deepMergeResolvers, } from './resolvers/index.js';
 import { dump, load } from 'js-yaml';
+import { buildQuery } from '@docupace/ihub-core/query';
 const FULL_OBJECT_EXPRESSION_PATTERN = /^\${(.*?)}$/;
 const INLINE_OBJECT_EXPRESSION_PATTERN = /\${(.*?)}/g;
 export class ConfigFileStore {
@@ -261,9 +262,19 @@ class ConfigService {
             const builtInQueryResolvers = {
                 pages: () => ({
                     getPageConfig: async (obj, context) => {
-                        const pageConfig = await this.getPageConfig(obj.path, context, true);
+                        const pageConfig = await this.getPageConfig(obj.path, context, true, obj.context);
                         return pageConfig;
                     },
+                    getAIConfig: async (obj, context) => {
+                        const pageConfig = await this.getPageConfig(obj.path, context, true, obj.context);
+                        const inlined = await this.inlineQuerySelectOptions(pageConfig, context);
+                        return this.stripNulls(inlined) ?? null;
+                    },
+                }),
+                rules: () => ({
+                    getRuleGroups: async (obj, context) => {
+                        return await this.getRuleGroups(obj.context, context);
+                    },
                 }),
                 widgets: () => ({
                     list: async (obj, context) => {
@@ -545,10 +556,193 @@ class ConfigService {
         await this.configStores[0].updateConfig(globalPath, config);
         return await this.getConfig(configPath, context, null, true);
     }
-    async getPageConfig(pagePath, context, processConfig) {
-        const config = await this.getConfig(path.join('pages', pagePath), context, null, processConfig);
+    normalizePathForMatching(fieldPath) {
+        return fieldPath
+            .split('.')
+            .filter((segment) => !segment.startsWith('@'))
+            .join('.');
+    }
+    applyFieldRuleToElement(element, fieldRule) {
+        const result = { ...element };
+        const applyIfUndefined = (fieldKey, ruleKey = fieldKey) => {
+            if ((result[fieldKey] === undefined || result[fieldKey] === null) &&
+                fieldRule[ruleKey] !== undefined) {
+                result[fieldKey] = fieldRule[ruleKey];
+            }
+        };
+        applyIfUndefined('required');
+        applyIfUndefined('readonly');
+        applyIfUndefined('defaultValue');
+        applyIfUndefined('messageLabel');
+        applyIfUndefined('requiredCondition');
+        applyIfUndefined('visibilityCondition', 'availabilityCondition');
+        applyIfUndefined('maxLength');
+        applyIfUndefined('minLength');
+        applyIfUndefined('validation');
+        applyIfUndefined('minDate');
+        applyIfUndefined('maxDate');
+        return result;
+    }
+    applyOverridesToConfig(config, fieldRuleMap) {
+        if (!config || typeof config !== 'object') {
+            return config;
+        }
+        if (Array.isArray(config)) {
+            return config.map((item) => this.applyOverridesToConfig(item, fieldRuleMap));
+        }
+        let result = { ...config };
+        if (typeof result.path === 'string') {
+            const normalizedPath = this.normalizePathForMatching(result.path);
+            const fieldRule = fieldRuleMap.get(normalizedPath);
+            if (fieldRule) {
+                result = this.applyFieldRuleToElement(result, fieldRule);
+            }
+        }
+        for (const key of Object.keys(result)) {
+            if (result[key] && typeof result[key] === 'object') {
+                result[key] = this.applyOverridesToConfig(result[key], fieldRuleMap);
+            }
+        }
+        return result;
+    }
+    async resolveQuerySelectOptions(selectOptions, context) {
+        // Skip dynamic queries that require runtime form state or search-as-you-type
+        if (!this.model ||
+            selectOptions.queryOnTyping ||
+            selectOptions.variablesExpressions) {
+            return selectOptions;
+        }
+        try {
+            // When apiLevel is '2', list endpoints wrap results in { items: [...] }.
+            // buildQueryStructFromInput does not check cliOptions itself, so we must
+            // pass pathPrefix explicitly to get `items { fields }` in the query.
+            const effectivePathPrefix = selectOptions.responsePathPrefix ??
+                (cliOptions.apiLevel === '2' ? 'items' : undefined);
+            const query = buildQuery({
+                queryName: selectOptions.queryName,
+                operationName: selectOptions.operationName || 'AIConfigQuery',
+                paths: selectOptions.paths || [],
+                variableDefinitions: selectOptions.variableDefinitions,
+                pathPrefix: effectivePathPrefix,
+            });
+            const result = await this.model.executeOperation({ query, variables: selectOptions.variables ?? {} }, context);
+            if (result.errors?.length > 0) {
+                log.warn({ errors: result.errors }, 'QuerySelectOptions resolution failed');
+                return selectOptions;
+            }
+            const navPath = effectivePathPrefix
+                ? `${selectOptions.queryName}.${effectivePathPrefix}`
+                : selectOptions.queryName;
+            let data = result.data;
+            for (const part of navPath.split('.')) {
+                data = data?.[part];
+            }
+            if (Array.isArray(data)) {
+                return data;
+            }
+            return data == null ? [] : [data];
+        }
+        catch (error) {
+            log.warn({ error }, 'Failed to resolve QuerySelectOptions');
+            return selectOptions;
+        }
+    }
+    async inlineQuerySelectOptions(config, context) {
+        if (config === null || config === undefined) {
+            return config;
+        }
+        if (Array.isArray(config)) {
+            return Promise.all(config.map((item) => this.inlineQuerySelectOptions(item, context)));
+        }
+        if (typeof config === 'object') {
+            if (config.__typename === 'QuerySelectOptions') {
+                return this.resolveQuerySelectOptions(config, context);
+            }
+            const entries = Object.entries(config);
+            const processedValues = await Promise.all(entries.map(([, value]) => this.inlineQuerySelectOptions(value, context)));
+            return Object.fromEntries(entries.map(([key], index) => [key, processedValues[index]]));
+        }
         return config;
     }
+    stripNulls(obj) {
+        if (obj === null || obj === undefined) {
+            return undefined;
+        }
+        if (Array.isArray(obj)) {
+            return obj
+                .map((item) => this.stripNulls(item))
+                .filter((item) => item !== undefined);
+        }
+        if (typeof obj === 'object') {
+            const result = {};
+            for (const [key, value] of Object.entries(obj)) {
+                const stripped = this.stripNulls(value);
+                if (stripped !== undefined) {
+                    result[key] = stripped;
+                }
+            }
+            return result;
+        }
+        return obj;
+    }
+    applyFieldRuleOverrides(config, matchingRuleGroups) {
+        // Sort ascending by priority so higher priority value overwrites lower
+        const sorted = [...matchingRuleGroups].sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
+        const fieldRuleMap = new Map();
+        for (const ruleGroup of sorted) {
+            for (const fieldRule of ruleGroup.fieldRules ?? []) {
+                if (!fieldRule.path) {
+                    continue;
+                }
+                const normalizedPath = this.normalizePathForMatching(fieldRule.path);
+                const existing = fieldRuleMap.get(normalizedPath);
+                fieldRuleMap.set(normalizedPath, existing ? { ...existing, ...fieldRule } : { ...fieldRule });
+            }
+        }
+        if (fieldRuleMap.size === 0) {
+            return config;
+        }
+        return this.applyOverridesToConfig(config, fieldRuleMap);
+    }
+    async getRuleGroups(rulesContext, context) {
+        const ruleFiles = await this.listDirectConfigs('global/rules');
+        const allRuleGroups = [];
+        for (const ruleFile of ruleFiles) {
+            try {
+                const ruleGroups = await this.getDirectConfig(path.join('global', 'rules', ruleFile), context, null, false);
+                if (Array.isArray(ruleGroups)) {
+                    allRuleGroups.push(...ruleGroups);
+                }
+            }
+            catch {
+                // skip unloadable rule files
+            }
+        }
+        return allRuleGroups.filter((ruleGroup) => {
+            if (!ruleGroup.condition) {
+                return true;
+            }
+            if (!rulesContext) {
+                return false;
+            }
+            try {
+                const keys = Object.keys(rulesContext);
+                const values = Object.values(rulesContext);
+                return new Function(...keys, `return ${ruleGroup.condition};`)(...values);
+            }
+            catch {
+                return false;
+            }
+        });
+    }
+    async getPageConfig(pagePath, context, processConfig, rulesContext) {
+        const globalPath = path.join('global', 'pages', pagePath);
+        const obj = await this.getConfigFromStore(globalPath);
+        const fullObj = await this.processObject(globalPath, obj, context, null);
+        const matchingRuleGroups = await this.getRuleGroups(rulesContext, context);
+        const configToProcess = this.applyFieldRuleOverrides(fullObj, matchingRuleGroups);
+        return await this.processConfig(configToProcess, context, processConfig);
+    }
     async init() {
         return Promise.all(this.configStores.map((configStore) => configStore.init()));
     }