@docupace/ihub-config 1.1.23 → 1.1.24-admin.0

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

package/dist/config-service.js

@@ -11,8 +11,158 @@ 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';
+import jp from 'jsonpath';
 const FULL_OBJECT_EXPRESSION_PATTERN = /^\${(.*?)}$/;
 const INLINE_OBJECT_EXPRESSION_PATTERN = /\${(.*?)}/g;
+function isNamedObjectArray(value) {
+    return (Array.isArray(value) &&
+        value.every((item) => item !== null &&
+            typeof item === 'object' &&
+            typeof item.name === 'string'));
+}
+// An override element counts as "self-contained" when it carries enough of
+// its own definition to render on its own — a real attribute path (or paths)
+// or a computed expression — as opposed to a thin `{ name, visible }`-style
+// reference that only makes sense resolved against a base/predefined
+// counterpart of the same name.
+function isSelfContainedOverrideElement(item) {
+    const paths = item.paths;
+    return ((Array.isArray(paths) && paths.length > 0) ||
+        (typeof item.expression === 'string' && item.expression.length > 0));
+}
+/**
+ * Merge semantics for a config sub-path override against the value already
+ * at that JSONPath. Generic — used for any typename/sub-path the
+ * configPath/subPath mechanism resolves, not just `Table.columns`.
+ *
+ * When both the current value and the override value are arrays of objects
+ * each carrying a string `name`, override elements are merged onto their
+ * base counterpart by name (override wins per-attribute, everything else
+ * inherited) instead of the override replacing the array wholesale. This is
+ * what makes a saved override non-destructive:
+ * - Reordering falls out of the override array's own element order.
+ * - "Hiding" an element is an attribute override (e.g. `visible: false`) on
+ *   an element that's still present, not a deletion.
+ * - A base element the override never mentions is appended unchanged, so a
+ *   base element added later still surfaces for someone with an existing
+ *   override, instead of being permanently absent from their frozen array.
+ * - An override element naming something not found in the base is kept
+ *   as-is when it's self-contained (has its own path(s)/expression — e.g. a
+ *   hand-authored column), or silently dropped when it's a thin reference
+ *   whose target (e.g. a predefined column) no longer exists — this never
+ *   throws; the stale reference just doesn't round-trip into the next save.
+ *
+ * Any other shape (scalars, plain objects, arrays without a `name` key) is
+ * returned untouched, so the caller's plain whole-value replace applies
+ * exactly as it did before this merge existed.
+ */
+function mergeSubPathOverrideValue(base, override) {
+    if (!isNamedObjectArray(override) || !isNamedObjectArray(base)) {
+        return override;
+    }
+    const baseByName = new Map(base.map((item) => [item.name, item]));
+    const merged = [];
+    const seenNames = new Set();
+    for (const overrideItem of override) {
+        // Guard against a corrupted/hand-edited override array carrying two
+        // elements with the same name — only the first is kept, so the merged
+        // result never has duplicate names.
+        if (seenNames.has(overrideItem.name)) {
+            continue;
+        }
+        seenNames.add(overrideItem.name);
+        const baseItem = baseByName.get(overrideItem.name);
+        if (baseItem) {
+            merged.push({ ...baseItem, ...overrideItem });
+        }
+        else if (isSelfContainedOverrideElement(overrideItem)) {
+            merged.push(overrideItem);
+        }
+        // else: a thin reference to a name that no longer resolves — drop it.
+    }
+    const mergedNames = new Set(merged.map((item) => item.name));
+    const untouchedBaseItems = base.filter((item) => !mergedNames.has(item.name));
+    return [...merged, ...untouchedBaseItems];
+}
+function isRefElement(item) {
+    return (item !== null &&
+        typeof item === 'object' &&
+        typeof item.$ref === 'string');
+}
+// Resolves a config-path override array element's fragment-only `$ref`
+// (e.g. `"#$.predefinedColumns[?(@.name=='email')]"`) against `refRoot` —
+// the config-path's own sibling fields, not another file. This is
+// deliberately narrower than `template`'s YAML `$ref` (processed by
+// `processReferencedObject`/`getRefConfig`, which loads another config
+// file): an override-array `$ref` only ever supports the `#<jsonpath>`
+// self-reference form, resolved with the already-vendored `jsonpath`
+// package (the same one `applyConfigPathOverride` uses for `subPath`
+// strings). A ref that doesn't start with `#`, resolves to nothing, or
+// resolves to a non-object is treated the same as any other unresolved
+// override reference elsewhere in this module — silently dropped rather
+// than thrown, so a stale reference just doesn't round-trip into the next
+// save. Multiple matches take the first, in JSONPath document order.
+//
+// The resolved object keeps the original fragment string under `ref` (not
+// `$ref` — GraphQL field names can't start with `$`) rather than dropping
+// it once resolved. Without this, a client re-saving the array unchanged
+// (e.g. reordering a different column) would have no way to tell this
+// element apart from a plain inline column and would flatten it back into
+// a frozen copy on that save — exactly the staleness problem `$ref` exists
+// to avoid. `Column.ref` (the GraphQL field) surfaces it back to the client
+// so `docupace-ui-main` can keep re-emitting the same `$ref` indefinitely.
+function resolveOverrideElementRef(item, refRoot) {
+    const ref = item.$ref;
+    if (!ref.startsWith('#')) {
+        return undefined;
+    }
+    const [match] = jp.query(refRoot, ref.slice(1));
+    if (match === null || typeof match !== 'object') {
+        return undefined;
+    }
+    const { $ref: _unusedRef, ...localOverrides } = item;
+    return {
+        ...match,
+        ...localOverrides,
+        ref,
+    };
+}
+// Expands any `$ref` elements of a config-path override array into the
+// full object they point at (merged with whatever local attributes the
+// element carries alongside `$ref`, e.g. `visible`) before the array is
+// handed to `mergeSubPathOverrideValue`. Runs first so that a `{ $ref,
+// visible }` stub — which has no `name` of its own — always arrives at the
+// name-keyed merge as a proper named object; `mergeSubPathOverrideValue`
+// itself needs no `$ref` awareness.
+function expandRefOverrideElements(value, refRoot) {
+    if (!Array.isArray(value)) {
+        return value;
+    }
+    return value
+        .map((item) => isRefElement(item) ? resolveOverrideElementRef(item, refRoot) : item)
+        .filter((item) => item !== undefined);
+}
+// Builds the object a config-path override's `$ref` fragments resolve
+// against: the config being overridden, overlaid with the *raw* (not yet
+// merged) override value of every other simple top-level subPath in this
+// same patch (e.g. `$.predefinedColumns`). Using the raw override value
+// rather than depending on loop order elsewhere in
+// `applyConfigPathOverride` means a `$.columns` override's `$ref` into
+// `$.predefinedColumns` resolves correctly regardless of which subPath
+// happens to be processed first. Only single-segment paths (`$.foo`) are
+// overlaid — nested subPaths (`$.filter.criteria`) fall back to whatever
+// value is already on `config`, which is fine since nothing currently
+// needs to `$ref` into a nested subPath.
+function buildRefResolutionRoot(config, subPathPatch) {
+    const overlay = {};
+    for (const [jsonPath, value] of Object.entries(subPathPatch)) {
+        const topLevelMatch = /^\$\.([^.[]+)$/.exec(jsonPath);
+        if (topLevelMatch) {
+            overlay[topLevelMatch[1]] = value;
+        }
+    }
+    return { ...config, ...overlay };
+}
 export class ConfigFileStore {
     localPath;
     remotePath;
@@ -155,6 +305,7 @@ class ConfigService {
     configInjectorResolvers;
     providers;
     resolvers;
+    configurationOverrideProvider;
     constructor(model, configStores, extensionOptions = {}) {
         this.configStores = configStores;
         this.model = model;
@@ -167,6 +318,8 @@ class ConfigService {
         this.resolvers = extensionOptions.resolvers
             ? { ...extensionOptions.resolvers }
             : {};
+        this.configurationOverrideProvider =
+            extensionOptions.configurationOverrideProvider;
         if (this.model) {
             this.generateResolvers();
         }
@@ -232,12 +385,34 @@ class ConfigService {
         }
         return processedData;
     }
+    applyReferenceExtensions(processedData, referenceConfig) {
+        if (typeof referenceConfig?.extend !== 'object') {
+            return processedData;
+        }
+        const { extend } = referenceConfig;
+        for (const key in extend) {
+            const extensionValue = extend[key];
+            if (!Array.isArray(extensionValue)) {
+                throw new GraphQLError(`$ref.extend.${key} must be an array; received ${typeof extensionValue}`);
+            }
+            const baseValue = processedData[key];
+            if (baseValue === undefined) {
+                processedData[key] = extensionValue;
+                continue;
+            }
+            if (!Array.isArray(baseValue)) {
+                throw new GraphQLError(`$ref.extend.${key} can only extend an array property; "${key}" resolved to ${typeof baseValue}`);
+            }
+            processedData[key] = [...baseValue, ...extensionValue];
+        }
+        return processedData;
+    }
     async processReferencedObject(configPath, obj, context, values) {
         const referenceConfig = obj.$ref;
         const refConfigPath = typeof referenceConfig === 'object' && referenceConfig.refPath
             ? referenceConfig.refPath
             : referenceConfig;
-        const imageData = await this.processImageReference(refConfigPath);
+        const imageData = await this.processImageReference(refConfigPath, context);
         if (imageData) {
             return imageData;
         }
@@ -246,6 +421,7 @@ class ConfigService {
             ? this.updatePathValues(referencedData, referenceConfig.path)
             : referencedData;
         processedData = this.applyReferenceOverrides(processedData, referenceConfig);
+        processedData = this.applyReferenceExtensions(processedData, referenceConfig);
         processedData = await this.processObjectExpressions(processedData, values, context);
         return this.processObject(configPath, processedData, context, values);
     }
@@ -262,7 +438,16 @@ class ConfigService {
             const builtInQueryResolvers = {
                 pages: () => ({
                     getPageConfig: async (obj, context) => {
-                        const pageConfig = await this.getPageConfig(obj.path, context, true, obj.context);
+                        // `impersonateRoleId`/`impersonateGeneral` are a plain
+                        // pass-through onto context here — this engine never inspects
+                        // identity itself; the host's resolveCurrentIdentity is what
+                        // interprets them and enforces the admin-only restriction.
+                        const impersonation = obj.impersonateRoleId
+                            ? { impersonateRoleId: obj.impersonateRoleId }
+                            : obj.impersonateGeneral
+                                ? { impersonateGeneral: true }
+                                : null;
+                        const pageConfig = await this.getPageConfig(obj.path, impersonation ? { ...context, ...impersonation } : context, true, obj.context);
                         return pageConfig;
                     },
                     getAIConfig: async (obj, context) => {
@@ -346,29 +531,37 @@ class ConfigService {
             return deepMergeResolvers(builtInMutationResolvers, hostMutationResolvers);
         };
     }
-    async processConfig(config, context, processProviders) {
+    // Applies any stored config-path sub-path overrides across the whole
+    // config tree before processConfig's own recursive walk runs, so that
+    // overridden values (which may introduce new sub-config) still go
+    // through provider injection/__typename dispatch below.
+    //
+    // rootSubPathOverrides lets a caller that already resolved overrides for
+    // the root config (e.g. getConfigFromStore, which fetches the whole-object
+    // and sub-path overrides together in one round trip) hand them in directly
+    // instead of having the root node re-resolved a second time below; nested
+    // nodes discovered deeper in the tree are still resolved individually,
+    // since their configPaths aren't known until the tree has been loaded.
+    async processConfig(config, context, processProviders, rootSubPathOverrides) {
+        const overriddenConfig = await this.applyConfigPathOverride(config, context, processProviders, rootSubPathOverrides);
+        return this.processConfigTree(overriddenConfig, context, processProviders);
+    }
+    async processConfigTree(config, context, processProviders) {
         if (!config) {
             return config;
         }
         // Handle arrays
         if (Array.isArray(config)) {
-            return Promise.all(config.map((item) => this.processConfig(item, context, processProviders)));
+            return Promise.all(config.map((item) => this.processConfigTree(item, context, processProviders)));
         }
         // Handle objects
         if (typeof config === 'object') {
             // Recursively process all properties of config
             let processedConfig = { ...config };
             for (const key in processedConfig) {
-                processedConfig[key] = await this.processConfig(processedConfig[key], context, processProviders);
-            }
-            // First process the current object if it has __typename
-            if (processedConfig?.__typename && processProviders) {
-                const providerClass = this.providers[processedConfig.__typename];
-                if (providerClass) {
-                    const provider = new providerClass();
-                    processedConfig = await provider.processConfig(processedConfig, this, context);
-                }
+                processedConfig[key] = await this.processConfigTree(processedConfig[key], context, processProviders);
             }
+            processedConfig = await this.applyTypenameProvider(processedConfig, context, processProviders);
             return processedConfig;
         }
         if (processProviders) {
@@ -376,6 +569,83 @@ class ConfigService {
         }
         return config;
     }
+    // Walks the whole config tree up front (pre-order) and, for every object
+    // that declares a configPath, deep-sets any stored sub-path overrides
+    // (JSONPath-addressed, e.g. "$.columns" or "$.filter.criteria").
+    //
+    // preFetchedSubPaths is only honored for the root node of the walk (the
+    // one being called with a defined third argument); nested calls always
+    // omit it so their own configPath gets resolved fresh.
+    async applyConfigPathOverride(config, context, processProviders, preFetchedSubPaths) {
+        if (!config) {
+            return config;
+        }
+        if (Array.isArray(config)) {
+            return Promise.all(config.map((item) => this.applyConfigPathOverride(item, context, processProviders)));
+        }
+        if (typeof config !== 'object') {
+            return config;
+        }
+        let result = config;
+        if (processProviders) {
+            const subPathPatch = preFetchedSubPaths !== undefined
+                ? preFetchedSubPaths
+                : result.configPath && this.configurationOverrideProvider
+                    ? (await this.configurationOverrideProvider.resolve(result.configPath, context)).subPaths
+                    : null;
+            if (subPathPatch) {
+                const refRoot = buildRefResolutionRoot(result, subPathPatch);
+                // Deep-clone once, up front — `jp.value` mutates its target in
+                // place, and a shallow `{ ...result }` per jsonPath only protects
+                // the top level. A nested subPath (e.g. `$.filter.criteria`) would
+                // otherwise still mutate `result.filter`, which is the *same*
+                // object reference as the original, potentially-shared config
+                // (e.g. reused across tables via `extend`/fragment composition).
+                // Config values are always plain JSON (from YAML/domain storage),
+                // so a JSON round-trip clone is sufficient and avoids
+                // `structuredClone`'s cross-realm `instanceof` pitfalls (its output
+                // fails `instanceof Object` checks — e.g. inside the `jsonpath`
+                // package — when the calling code runs in a different VM
+                // realm/context, as test sandboxes commonly do).
+                result = JSON.parse(JSON.stringify(result));
+                for (const [jsonPath, value] of Object.entries(subPathPatch)) {
+                    // A single malformed override (an unparseable `$ref` JSONPath, or
+                    // a jsonPath that doesn't resolve to a settable location) must not
+                    // abort resolution of the rest of this config tree — that would
+                    // take down the page for every user over one bad admin-authored
+                    // row. Log and skip just this jsonPath instead.
+                    try {
+                        const currentValue = jp.value(result, jsonPath);
+                        const expandedValue = expandRefOverrideElements(value, refRoot);
+                        const mergedValue = mergeSubPathOverrideValue(currentValue, expandedValue);
+                        const applied = jp.value(result, jsonPath, mergedValue);
+                        if (applied === undefined) {
+                            throw new Error(`does not resolve to a settable location: "${jsonPath}"`);
+                        }
+                    }
+                    catch (error) {
+                        log.warn(`Skipping configuration override for "${result.configPath}" at "${jsonPath}": ${error.message}`);
+                    }
+                }
+            }
+        }
+        const overriddenEntries = await Promise.all(Object.entries(result).map(async ([key, value]) => [
+            key,
+            await this.applyConfigPathOverride(value, context, processProviders),
+        ]));
+        return Object.fromEntries(overriddenEntries);
+    }
+    async applyTypenameProvider(processedConfig, context, processProviders) {
+        if (!processedConfig?.__typename || !processProviders) {
+            return processedConfig;
+        }
+        const providerClass = this.providers[processedConfig.__typename];
+        if (!providerClass) {
+            return processedConfig;
+        }
+        const provider = new providerClass();
+        return await provider.processConfig(processedConfig, this, context);
+    }
     async getRefConfig(configPath, refConfigPath, context, values) {
         let fullPath;
         if (refConfigPath.startsWith('.')) {
@@ -462,13 +732,21 @@ class ConfigService {
         };
         return await processValue(object);
     }
-    async processImageReference(refConfigPath) {
+    async processImageReference(refConfigPath, context) {
         const SUPPORTED_IMAGE_FORMATS = ['.jpg', '.jpeg', '.png', '.svg'];
         // Check if the reference is an image file
         const ext = path.extname(refConfigPath).toLowerCase();
         if (!SUPPORTED_IMAGE_FORMATS.includes(ext)) {
             return null;
         }
+        const override = await this.configurationOverrideProvider?.resolve(refConfigPath, context);
+        if (override?.whole?.contentType) {
+            return {
+                data: override.whole.value,
+                mimeType: override.whole.contentType,
+                hash: createHash('sha256').update(override.whole.value).digest('hex'),
+            };
+        }
         let standardStore;
         for (const store of this.configStores) {
             if (store instanceof ConfigFileStore) {
@@ -520,19 +798,31 @@ class ConfigService {
                 return 'application/octet-stream';
         }
     }
-    async getConfigFromStore(path) {
+    // Resolves the whole-object override and any sub-path overrides for
+    // configPath together, in one provider round trip, instead of fetching
+    // them separately at different points of the processing pipeline. The
+    // sub-path overrides are handed back alongside the config so callers can
+    // thread them into processConfig rather than re-resolving them later.
+    async getConfigFromStore(configPath, context) {
+        const override = await this.configurationOverrideProvider?.resolve(configPath, context);
+        const subPathOverrides = override?.subPaths ?? null;
+        if (override?.whole && !override.whole.contentType) {
+            return { config: load(override.whole.value), subPathOverrides };
+        }
         const exceptions = [];
         for (const [index, configStore] of this.configStores.entries()) {
             try {
-                return await configStore.getConfig(path);
+                const config = await configStore.getConfig(configPath);
+                return { config, subPathOverrides };
             }
             catch (e) {
                 exceptions.push(e);
                 if (index == this.configStores.length - 1) {
-                    throw new GraphQLError(`Config not found in path in any store: ${path}`, { originalError: exceptions });
+                    throw new GraphQLError(`Config not found in path in any store: ${configPath}`, { originalError: exceptions });
                 }
             }
         }
+        return { config: undefined, subPathOverrides };
     }
     async hasConfig(configPath) {
         return (await Promise.all(this.configStores.map((configStore) => configStore.hasConfig(configPath)))).some(Boolean);
@@ -542,9 +832,9 @@ class ConfigService {
         return this.getDirectConfig(globalPath, context, values, processProviders);
     }
     async getDirectConfig(configPath, context, values, processProviders) {
-        const obj = await this.getConfigFromStore(configPath);
+        const { config: obj, subPathOverrides } = await this.getConfigFromStore(configPath, context);
         const fullObj = await this.processObject(configPath, obj, context, values);
-        const processedObj = await this.processConfig(fullObj, context, processProviders);
+        const processedObj = await this.processConfig(fullObj, context, processProviders, subPathOverrides);
         return processedObj;
     }
     async listDirectConfigs(configPath) {
@@ -895,21 +1185,22 @@ class ConfigService {
     }
     async getPageConfig(pagePath, context, processConfig, rulesContext) {
         const globalPath = path.join('global', 'pages', pagePath);
-        const obj = await this.getConfigFromStore(globalPath);
+        const { config: obj, subPathOverrides } = await this.getConfigFromStore(globalPath, context);
         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);
+        return await this.processConfig(configToProcess, context, processConfig, subPathOverrides);
     }
     async init() {
         return Promise.all(this.configStores.map((configStore) => configStore.init()));
     }
 }
-export const defaultConfigService = ({ model, configStores, configInjectorResolvers, providers, resolvers, }) => {
+export const defaultConfigService = ({ model, configStores, configInjectorResolvers, providers, resolvers, configurationOverrideProvider, }) => {
     const extensionOptions = {
         configInjectorResolvers,
         providers,
         resolvers,
+        configurationOverrideProvider,
     };
     return new ConfigService(model, configStores.map((configStore) => new ConfigFileStore(configStore)), extensionOptions);
 };