@marinoscar/platform-api 0.0.0-stage → 0.1.0-next.11

package/dist/settings/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/settings/ports.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,uDAAuD;AACvD,gFAAgF;AAChF,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,4EAA4E;AAC5E,4EAA4E;AAC5E,mDAAmD;AACnD,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,2CAA2C;AAC3C,EAAE;AACF,2EAA2E;AAC3E,gFAAgF;;;AAMhF,qFAAqF;AAErF;;;;;;;;;;;;GAYG;AACU,QAAA,aAAa,GAAkB,MAAM,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;AAoB7F,qFAAqF;AAErF;;;;;;;GAOG;AACU,QAAA,uBAAuB,GAAkB,MAAM,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC"}

package/dist/settings/registry/assemble.d.ts

@@ -0,0 +1,195 @@
+import { type SystemSettingsNamespace } from './system-settings-namespace';
+import { type SystemSettingsNamespaceExtension, type UserSettingsNamespaceExtension } from './extend';
+import type { UserSettingsNamespace } from './user-settings-namespace';
+/**
+ * A change to the DEFAULTS of a registered system namespace: a partial value
+ * merged (objects deeply, everything else replaced) onto the namespace's
+ * defaults. The shape, the merge and every schema stay as the namespace
+ * declared them.
+ *
+ * @stability experimental
+ */
+export interface SettingsDefaultsOverride {
+    /** The system namespace whose defaults change. */
+    readonly key: string;
+    /** The partial defaults; every path must exist in the stored schema and the result must satisfy it. */
+    readonly defaults: Readonly<Record<string, unknown>>;
+}
+/**
+ * A {@link SettingsDefaultsOverride} as the registry holds it, with the unique
+ * id the registry keys it by (`<namespace>:<call number>`).
+ *
+ * @stability experimental
+ */
+export interface RegisteredSettingsDefaultsOverride extends SettingsDefaultsOverride {
+    /** The registry id. */
+    readonly id: string;
+}
+/**
+ * The defaults overrides registered with {@link overrideSettingsNamespaceDefaults},
+ * in call order. Read by the manifests through {@link assembleSystemSettingsNamespaces}.
+ *
+ * @stability experimental
+ */
+export declare const settingsDefaultsOverrideRegistry: import("../../core/index").Registry<RegisteredSettingsDefaultsOverride>;
+/**
+ * Changes the defaults of a registered system namespace, from the app or from a
+ * package's side-effect import. Call it at import time, before the app's
+ * manifest runs. The change is checked when the manifest assembles the
+ * namespaces: every path must exist in the namespace's stored schema and the
+ * resulting defaults must satisfy it, so a typo or a wrong type fails the
+ * boot naming the namespace. Only the defaults change; the shape, the merge
+ * and the org layer stay the namespace's.
+ *
+ * Several overrides of one namespace apply in call order, later over earlier.
+ * User namespaces have no defaults (absent means "use the client's built-in
+ * default"), so there is nothing to override for them.
+ *
+ * @param key - the system namespace key.
+ * @param defaults - the partial defaults to apply.
+ * @throws RegistryError when the key or the value is malformed or the registry is frozen.
+ *
+ * @example
+ * ```ts
+ * overrideSettingsNamespaceDefaults('retention', { jobs: { succeededDays: 14 } });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function overrideSettingsNamespaceDefaults(key: string, defaults: Readonly<Record<string, unknown>>): void;
+/**
+ * `namespaces` with each override applied to its namespace's defaults.
+ *
+ * @param namespaces - the folded declarations.
+ * @param overrides - the overrides, in the order to apply.
+ * @returns the declarations; those without an override are the same objects.
+ * @throws Error naming the namespace when it is unknown, a path does not exist
+ *   in its stored schema, or the resulting defaults fail the schema.
+ *
+ * @stability experimental
+ */
+export declare function applySettingsDefaultsOverrides(namespaces: readonly SystemSettingsNamespace[], overrides: readonly SettingsDefaultsOverride[]): SystemSettingsNamespace[];
+/**
+ * What a package contributes to the settings registries from a side-effect
+ * import. Everything is optional.
+ *
+ * @stability experimental
+ */
+export interface SettingsContribution {
+    /**
+     * Who contributes (the package name, `@acme/billing-settings`). Unique;
+     * named in every error the contribution causes.
+     */
+    readonly id: string;
+    /** System namespaces the package owns. */
+    readonly system?: readonly SystemSettingsNamespace[];
+    /** Optional user namespaces the package owns. */
+    readonly user?: readonly UserSettingsNamespace[];
+    /** Fields the package adds inside namespaces that already exist (the platform's, the app's, another contribution's). */
+    readonly extensions?: {
+        /** Inside system namespaces. */
+        readonly system?: readonly SystemSettingsNamespaceExtension[];
+        /** Inside user namespaces. */
+        readonly user?: readonly UserSettingsNamespaceExtension[];
+    };
+}
+/**
+ * The contributions collected so far, in import order. Frozen when the
+ * application bootstraps, like every static registry.
+ *
+ * @stability experimental
+ */
+export declare const settingsContributionRegistry: import("../../core/index").Registry<SettingsContribution>;
+/**
+ * Contributes settings namespaces and extensions from a package. Call it at
+ * import time from the package's entry module: the app imports the package for
+ * its side effect (`app-registrations/settings-contributions.ts`) and its
+ * manifest folds what was collected, in import order, between the platform's
+ * namespaces and the app's own. The app lists nothing by hand.
+ *
+ * Nothing is validated beyond the shape here: the namespaces go through the
+ * registry's usual checks (duplicate and reserved keys, secret-named fields,
+ * defaults against the schema) when the manifest registers them, and an
+ * extension of a namespace that does not exist fails the boot naming the key.
+ *
+ * @param contribution - what the package contributes.
+ * @throws RegistryError when the id is taken (a package imported twice through
+ *   two paths) or the registry is frozen (imported after the application bootstrapped).
+ *
+ * @example
+ * ```ts
+ * // @acme/billing-settings/src/index.ts
+ * registerSettingsContribution({ id: '@acme/billing-settings', system: [BILLING_SYSTEM_SETTINGS] });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function registerSettingsContribution(contribution: SettingsContribution): void;
+/**
+ * What {@link assembleSystemSettingsNamespaces} takes.
+ *
+ * @stability experimental
+ */
+export interface SystemSettingsAssembly {
+    /** The platform's namespaces, in the order the app registers them. */
+    readonly platform: readonly SystemSettingsNamespace[];
+    /** The app's own namespaces. */
+    readonly app?: readonly SystemSettingsNamespace[];
+    /** The app's extensions of existing namespaces. */
+    readonly appExtensions?: readonly SystemSettingsNamespaceExtension[];
+    /** The app's defaults overrides, applied after every `overrideSettingsNamespaceDefaults` call. */
+    readonly appDefaults?: readonly SettingsDefaultsOverride[];
+    /** The contributions to fold; default: every one collected by {@link registerSettingsContribution}. */
+    readonly contributions?: readonly SettingsContribution[];
+}
+/**
+ * The final, ordered list of system namespaces for the app's manifest to
+ * register: platform, contributions (import order), app; extensions folded in
+ * (contributions first, then the app's); defaults overrides applied.
+ *
+ * @param input - see {@link SystemSettingsAssembly}.
+ * @returns the declarations in registration order.
+ * @throws Error naming the owner (a contribution id, `the platform`, `the app`)
+ *   when two declare one key, an extension names a missing namespace, or a
+ *   defaults override is invalid.
+ *
+ * @example
+ * ```ts
+ * registerSystemSettingsNamespaces(
+ *   assembleSystemSettingsNamespaces({ platform: PLATFORM_NAMESPACES, app: APP_SYSTEM_SETTINGS_NAMESPACES, appExtensions: APP_SYSTEM_SETTINGS_EXTENSIONS }),
+ * );
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function assembleSystemSettingsNamespaces(input: SystemSettingsAssembly): SystemSettingsNamespace[];
+/**
+ * What {@link assembleUserSettingsNamespaces} takes.
+ *
+ * @stability experimental
+ */
+export interface UserSettingsAssembly {
+    /** The platform's namespaces, in the order the app registers them. */
+    readonly platform: readonly UserSettingsNamespace[];
+    /** The app's own namespaces. */
+    readonly app?: readonly UserSettingsNamespace[];
+    /** The app's extensions of existing namespaces. */
+    readonly appExtensions?: readonly UserSettingsNamespaceExtension[];
+    /** The contributions to fold; default: every one collected by {@link registerSettingsContribution}. */
+    readonly contributions?: readonly SettingsContribution[];
+}
+/**
+ * The final, ordered list of user namespaces for the app's manifest to
+ * register; the order and the folding are those of
+ * {@link assembleSystemSettingsNamespaces}.
+ *
+ * @param input - see {@link UserSettingsAssembly}.
+ * @returns the declarations in registration order.
+ * @throws Error naming the owner when two declare one key or an extension names a missing namespace.
+ *
+ * @stability experimental
+ */
+export declare function assembleUserSettingsNamespaces(input: UserSettingsAssembly): UserSettingsNamespace[];
+//# sourceMappingURL=assemble.d.ts.map

package/dist/settings/registry/assemble.d.ts.map

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

package/dist/settings/registry/assemble.js

@@ -0,0 +1,283 @@
+"use strict";
+// =============================================================================
+// Assembling the namespace lists: contributions, extensions, defaults (PP-14.21)
+// =============================================================================
+//
+// The app's manifests used to register "the platform's namespaces, then the
+// app's". A separately installed package (an `@acme/billing-settings`) could
+// not contribute a namespace without the app listing it by hand. Three things
+// change that, all resolved BEFORE anything is registered so the registry only
+// ever holds the final declarations:
+//
+//   - `registerSettingsContribution` is a pre-bootstrap collector: a package's
+//     side-effect import calls it, and the manifest folds what it collected.
+//   - `overrideSettingsNamespaceDefaults` changes the DEFAULTS of a namespace
+//     (never its shape or its merge), validated against the schema.
+//   - the assemblers (`assembleSystemSettingsNamespaces`,
+//     `assembleUserSettingsNamespaces`) apply them all in ONE documented order.
+//
+// THE ORDER (registration order is the stored JSON's key order and the OpenAPI
+// document's, so it is a contract):
+//
+//   1. the platform's namespaces, in the order the app lists them
+//   2. the contributions' namespaces, in import order
+//   3. the app's own namespaces
+//
+//   then, over the whole list:
+//   4. extensions: the contributions' (import order), then the app's
+//   5. defaults overrides (system only): `overrideSettingsNamespaceDefaults`
+//      calls in call order, then the app's list
+//
+// Framework-free: zod and the registry primitive only.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.settingsContributionRegistry = exports.settingsDefaultsOverrideRegistry = void 0;
+exports.overrideSettingsNamespaceDefaults = overrideSettingsNamespaceDefaults;
+exports.applySettingsDefaultsOverrides = applySettingsDefaultsOverrides;
+exports.registerSettingsContribution = registerSettingsContribution;
+exports.assembleSystemSettingsNamespaces = assembleSystemSettingsNamespaces;
+exports.assembleUserSettingsNamespaces = assembleUserSettingsNamespaces;
+const index_1 = require("../../core/index");
+const system_settings_namespace_1 = require("./system-settings-namespace");
+const extend_1 = require("./extend");
+const nested_1 = require("./nested");
+let overrideSequence = 0;
+/**
+ * The defaults overrides registered with {@link overrideSettingsNamespaceDefaults},
+ * in call order. Read by the manifests through {@link assembleSystemSettingsNamespaces}.
+ *
+ * @stability experimental
+ */
+exports.settingsDefaultsOverrideRegistry = (0, index_1.defineRegistry)({
+    name: 'settings-defaults-overrides',
+    idOf: (override) => override.id,
+    validate: (override) => {
+        if (!system_settings_namespace_1.SETTINGS_NAMESPACE_KEY_PATTERN.test(override.key)) {
+            throw new Error(`"${override.key}" is not a settings namespace key`);
+        }
+        if (!isPlainObject(override.defaults) || Object.keys(override.defaults).length === 0) {
+            throw new Error('defaults must be a non-empty object of the values to change');
+        }
+    },
+});
+/**
+ * Changes the defaults of a registered system namespace, from the app or from a
+ * package's side-effect import. Call it at import time, before the app's
+ * manifest runs. The change is checked when the manifest assembles the
+ * namespaces: every path must exist in the namespace's stored schema and the
+ * resulting defaults must satisfy it, so a typo or a wrong type fails the
+ * boot naming the namespace. Only the defaults change; the shape, the merge
+ * and the org layer stay the namespace's.
+ *
+ * Several overrides of one namespace apply in call order, later over earlier.
+ * User namespaces have no defaults (absent means "use the client's built-in
+ * default"), so there is nothing to override for them.
+ *
+ * @param key - the system namespace key.
+ * @param defaults - the partial defaults to apply.
+ * @throws RegistryError when the key or the value is malformed or the registry is frozen.
+ *
+ * @example
+ * ```ts
+ * overrideSettingsNamespaceDefaults('retention', { jobs: { succeededDays: 14 } });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+function overrideSettingsNamespaceDefaults(key, defaults) {
+    if (!system_settings_namespace_1.SETTINGS_NAMESPACE_KEY_PATTERN.test(key))
+        throw new Error(`"${key}" is not a settings namespace key`);
+    overrideSequence += 1;
+    exports.settingsDefaultsOverrideRegistry.register({ id: `${key}:${overrideSequence}`, key, defaults });
+}
+function isPlainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/** `patch` merged onto `base`: plain objects deeply, anything else replaced. */
+function mergeDefaults(base, patch) {
+    const out = isPlainObject(base) ? structuredClone(base) : {};
+    for (const [key, value] of Object.entries(patch)) {
+        if (key === '__proto__')
+            throw new Error('"__proto__" is not a settings field');
+        out[key] = isPlainObject(value) && isPlainObject(out[key]) ? mergeDefaults(out[key], value) : structuredClone(value);
+    }
+    return out;
+}
+/** Every leaf-or-record path of `patch`, as segment arrays. */
+function pathsOf(patch, prefix = []) {
+    const paths = [];
+    for (const [key, value] of Object.entries(patch)) {
+        const here = [...prefix, key];
+        if (isPlainObject(value) && Object.keys(value).length > 0)
+            paths.push(here, ...pathsOf(value, here));
+        else
+            paths.push(here);
+    }
+    return paths;
+}
+/**
+ * `namespaces` with each override applied to its namespace's defaults.
+ *
+ * @param namespaces - the folded declarations.
+ * @param overrides - the overrides, in the order to apply.
+ * @returns the declarations; those without an override are the same objects.
+ * @throws Error naming the namespace when it is unknown, a path does not exist
+ *   in its stored schema, or the resulting defaults fail the schema.
+ *
+ * @stability experimental
+ */
+function applySettingsDefaultsOverrides(namespaces, overrides) {
+    const known = namespaces.map((ns) => ns.key);
+    const result = [...namespaces];
+    for (const override of overrides) {
+        const index = result.findIndex((ns) => ns.key === override.key);
+        const ns = result[index];
+        if (index < 0 || ns === undefined) {
+            throw new Error(`Cannot override the defaults of system settings namespace "${override.key}": no such namespace. Known: ${known.join(', ')}.`);
+        }
+        for (const path of pathsOf(override.defaults)) {
+            // Only an object step can be checked for a misspelt field; a record or a free-form
+            // value takes any key, and the schema parse below still judges its contents.
+            const parent = (0, nested_1.unwrapToObject)((0, nested_1.schemaAt)(ns.storedSchema, path.slice(0, -1)));
+            const last = path[path.length - 1];
+            if (parent !== undefined && !(last in parent.shape)) {
+                throw new Error(`Cannot override the defaults of system settings namespace "${override.key}": ${path.join('.')} is not a field of its stored schema.`);
+            }
+        }
+        const defaults = mergeDefaults(ns.defaults, override.defaults);
+        const parsed = ns.storedSchema.safeParse(defaults);
+        if (!parsed.success) {
+            throw new Error(`Cannot override the defaults of system settings namespace "${override.key}": the result does not satisfy its stored schema: ${parsed.error.issues
+                .map((issue) => `${issue.path.join('.') || '(root)'}: ${issue.message}`)
+                .join('; ')}`);
+        }
+        result[index] = { ...ns, defaults };
+    }
+    return result;
+}
+/**
+ * The contributions collected so far, in import order. Frozen when the
+ * application bootstraps, like every static registry.
+ *
+ * @stability experimental
+ */
+exports.settingsContributionRegistry = (0, index_1.defineRegistry)({
+    name: 'settings-contributions',
+    idOf: (contribution) => contribution.id,
+    // A package name (`@acme/billing-settings`) starts with `@`.
+    idPattern: /^[@A-Za-z0-9][A-Za-z0-9._:/@-]*$/,
+    describeDuplicate: (_existing, incoming) => `Settings contribution "${incoming.id}" is already registered: the package was imported twice (two copies of it installed, or two import paths).`,
+    validate: (contribution) => {
+        for (const part of ['system', 'user']) {
+            const list = contribution[part];
+            if (list !== undefined && !Array.isArray(list))
+                throw new Error(`${part} must be an array of namespace declarations`);
+        }
+        for (const part of ['system', 'user']) {
+            const list = contribution.extensions?.[part];
+            if (list !== undefined && !Array.isArray(list))
+                throw new Error(`extensions.${part} must be an array of extensions`);
+        }
+    },
+});
+/**
+ * Contributes settings namespaces and extensions from a package. Call it at
+ * import time from the package's entry module: the app imports the package for
+ * its side effect (`app-registrations/settings-contributions.ts`) and its
+ * manifest folds what was collected, in import order, between the platform's
+ * namespaces and the app's own. The app lists nothing by hand.
+ *
+ * Nothing is validated beyond the shape here: the namespaces go through the
+ * registry's usual checks (duplicate and reserved keys, secret-named fields,
+ * defaults against the schema) when the manifest registers them, and an
+ * extension of a namespace that does not exist fails the boot naming the key.
+ *
+ * @param contribution - what the package contributes.
+ * @throws RegistryError when the id is taken (a package imported twice through
+ *   two paths) or the registry is frozen (imported after the application bootstrapped).
+ *
+ * @example
+ * ```ts
+ * // @acme/billing-settings/src/index.ts
+ * registerSettingsContribution({ id: '@acme/billing-settings', system: [BILLING_SYSTEM_SETTINGS] });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+function registerSettingsContribution(contribution) {
+    exports.settingsContributionRegistry.register(contribution);
+}
+// -----------------------------------------------------------------------------
+// The assemblers
+// -----------------------------------------------------------------------------
+function assertNoDuplicateKeys(groups, scope) {
+    const seen = new Map();
+    for (const { owner, namespaces } of groups) {
+        for (const ns of namespaces) {
+            const first = seen.get(ns.key);
+            if (first !== undefined) {
+                throw new Error(`${scope === 'system' ? 'System' : 'User'} settings namespace "${ns.key}" is already registered: ${owner} declares it, but ${first} already does. ` +
+                    `Extend it with ${scope === 'system' ? 'extendSystemSettingsNamespace' : 'extendUserSettingsNamespace'} instead of declaring it twice.`);
+            }
+            seen.set(ns.key, owner);
+        }
+    }
+}
+/**
+ * The final, ordered list of system namespaces for the app's manifest to
+ * register: platform, contributions (import order), app; extensions folded in
+ * (contributions first, then the app's); defaults overrides applied.
+ *
+ * @param input - see {@link SystemSettingsAssembly}.
+ * @returns the declarations in registration order.
+ * @throws Error naming the owner (a contribution id, `the platform`, `the app`)
+ *   when two declare one key, an extension names a missing namespace, or a
+ *   defaults override is invalid.
+ *
+ * @example
+ * ```ts
+ * registerSystemSettingsNamespaces(
+ *   assembleSystemSettingsNamespaces({ platform: PLATFORM_NAMESPACES, app: APP_SYSTEM_SETTINGS_NAMESPACES, appExtensions: APP_SYSTEM_SETTINGS_EXTENSIONS }),
+ * );
+ * ```
+ *
+ * @stability experimental
+ */
+function assembleSystemSettingsNamespaces(input) {
+    const contributions = input.contributions ?? exports.settingsContributionRegistry.list();
+    const groups = [
+        { owner: 'the platform', namespaces: input.platform },
+        ...contributions.map((c) => ({ owner: `settings contribution "${c.id}"`, namespaces: c.system ?? [] })),
+        { owner: 'the app', namespaces: input.app ?? [] },
+    ];
+    assertNoDuplicateKeys(groups, 'system');
+    const extensions = [...contributions.flatMap((c) => c.extensions?.system ?? []), ...(input.appExtensions ?? [])];
+    const { platform, app } = (0, extend_1.foldSettingsExtensions)({ platform: groups.slice(0, -1).flatMap((g) => g.namespaces), app: groups[groups.length - 1]?.namespaces ?? [] }, extensions, extend_1.extendSystemSettingsNamespace, 'system settings');
+    return applySettingsDefaultsOverrides([...platform, ...app], [...exports.settingsDefaultsOverrideRegistry.list(), ...(input.appDefaults ?? [])]);
+}
+/**
+ * The final, ordered list of user namespaces for the app's manifest to
+ * register; the order and the folding are those of
+ * {@link assembleSystemSettingsNamespaces}.
+ *
+ * @param input - see {@link UserSettingsAssembly}.
+ * @returns the declarations in registration order.
+ * @throws Error naming the owner when two declare one key or an extension names a missing namespace.
+ *
+ * @stability experimental
+ */
+function assembleUserSettingsNamespaces(input) {
+    const contributions = input.contributions ?? exports.settingsContributionRegistry.list();
+    const groups = [
+        { owner: 'the platform', namespaces: input.platform },
+        ...contributions.map((c) => ({ owner: `settings contribution "${c.id}"`, namespaces: c.user ?? [] })),
+        { owner: 'the app', namespaces: input.app ?? [] },
+    ];
+    assertNoDuplicateKeys(groups, 'user');
+    const extensions = [...contributions.flatMap((c) => c.extensions?.user ?? []), ...(input.appExtensions ?? [])];
+    const { platform, app } = (0, extend_1.foldSettingsExtensions)({ platform: groups.slice(0, -1).flatMap((g) => g.namespaces), app: groups[groups.length - 1]?.namespaces ?? [] }, extensions, extend_1.extendUserSettingsNamespace, 'user settings');
+    return [...platform, ...app];
+}
+//# sourceMappingURL=assemble.js.map

package/dist/settings/registry/assemble.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assemble.js","sourceRoot":"","sources":["../../../src/settings/registry/assemble.ts"],"names":[],"mappings":"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"}

package/dist/settings/registry/catalog.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The catalog file's exact contents: the composed defaults of every
+ * registered system namespace as 2-space JSON with a trailing newline, key
+ * order preserved (it is the stored JSON's key order). Composed from the
+ * registry as it is NOW, so a namespace a test adds with
+ * `withTemporaryEntries` is included.
+ *
+ * @returns the file contents.
+ *
+ * @stability experimental
+ */
+export declare function renderSystemSettingsCatalog(): string;
+/**
+ * Compares a catalog file's contents (`undefined` when the file is missing)
+ * with what the registry renders now.
+ *
+ * @param contents - the committed file, or `undefined`.
+ * @param staleMessage - what to return when it is stale (the app's fix command).
+ * @returns `null` when current, else `staleMessage`.
+ *
+ * @stability experimental
+ */
+export declare function checkSystemSettingsCatalog(contents: string | undefined, staleMessage: string): string | null;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/settings/registry/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/settings/registry/catalog.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE5G"}

package/dist/settings/registry/catalog.js

@@ -0,0 +1,43 @@
+"use strict";
+// =============================================================================
+// The system settings defaults catalog (issue #677, moved by #733)
+// =============================================================================
+//
+// An app's seed cannot import its namespace declarations (the seed runs from
+// `prisma/` without `src/`), so it reads a COMMITTED, GENERATED copy of the
+// composed defaults. These two functions render that file and check it; the
+// app owns the file's path, its generator script and the fix command its
+// staleness message names.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderSystemSettingsCatalog = renderSystemSettingsCatalog;
+exports.checkSystemSettingsCatalog = checkSystemSettingsCatalog;
+const compose_1 = require("./compose");
+/**
+ * The catalog file's exact contents: the composed defaults of every
+ * registered system namespace as 2-space JSON with a trailing newline, key
+ * order preserved (it is the stored JSON's key order). Composed from the
+ * registry as it is NOW, so a namespace a test adds with
+ * `withTemporaryEntries` is included.
+ *
+ * @returns the file contents.
+ *
+ * @stability experimental
+ */
+function renderSystemSettingsCatalog() {
+    return `${JSON.stringify((0, compose_1.composeDefaultSystemSettings)(), null, 2)}\n`;
+}
+/**
+ * Compares a catalog file's contents (`undefined` when the file is missing)
+ * with what the registry renders now.
+ *
+ * @param contents - the committed file, or `undefined`.
+ * @param staleMessage - what to return when it is stale (the app's fix command).
+ * @returns `null` when current, else `staleMessage`.
+ *
+ * @stability experimental
+ */
+function checkSystemSettingsCatalog(contents, staleMessage) {
+    return contents === renderSystemSettingsCatalog() ? null : staleMessage;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/settings/registry/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/settings/registry/catalog.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,mEAAmE;AACnE,gFAAgF;AAChF,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,4EAA4E;AAC5E,yEAAyE;AACzE,2BAA2B;AAC3B,gFAAgF;;AAehF,kEAEC;AAYD,gEAEC;AA7BD,uCAAyD;AAEzD;;;;;;;;;;GAUG;AACH,SAAgB,2BAA2B;IACzC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAA,sCAA4B,GAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AACxE,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,0BAA0B,CAAC,QAA4B,EAAE,YAAoB;IAC3F,OAAO,QAAQ,KAAK,2BAA2B,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;AAC1E,CAAC"}