@nocobase/app-server 0.11.1-alpha.5 → 2.0.0-beta.1

package/dist/config/app-config.js

@@ -0,0 +1,247 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
+import { Config } from '@nocobase/config';
+import { jsonParser } from '@nocobase/config/parsers/json';
+import { tomlParser } from '@nocobase/config/parsers/toml';
+import { yamlParser } from '@nocobase/config/parsers/yaml';
+import { fileProvider } from '@nocobase/config/providers/file';
+import { environmentProvider, } from '@nocobase/config/providers/env';
+import { AppConfigInvalidError, collectPublicConfig, listPublicPaths, validateConfigSections, } from './validation.js';
+export class AppConfig {
+    sources = [];
+    listeners = new Map();
+    current;
+    defaults = new Config();
+    overrides = new Config();
+    sections = new Map();
+    reloadPromise;
+    logger;
+    loadDurationMs;
+    /** Attach diagnostics after the logging configuration has been resolved. */
+    setLogger(logger) {
+        this.logger = logger;
+        if (this.loadDurationMs !== undefined) {
+            logger.debug({ durationMs: this.loadDurationMs }, 'App configuration loaded');
+            this.loadDurationMs = undefined;
+        }
+    }
+    load(provider, parser, options) {
+        if (this.current) {
+            throw new Error('Config sources cannot be added after loading.');
+        }
+        this.sources.push({ provider, parser, options });
+        return this;
+    }
+    loadFile(filePath, options = {}) {
+        const resolvedPath = resolveConfigFilePath(filePath);
+        const extension = path.extname(resolvedPath).toLowerCase();
+        const parser = extension === '.toml'
+            ? tomlParser()
+            : extension === '.yml' || extension === '.yaml'
+                ? yamlParser()
+                : extension === '.json'
+                    ? jsonParser()
+                    : undefined;
+        if (!parser) {
+            throw new Error(`Unsupported application config file extension "${extension || '(none)'}". Expected .toml, .yml, .yaml, or .json.`);
+        }
+        return this.load(fileProvider(resolvedPath, options), parser);
+    }
+    async loadAll() {
+        const startedAt = Date.now();
+        const next = await this.loadConfig();
+        this.current = next;
+        this.loadDurationMs = Date.now() - startedAt;
+        if (this.logger)
+            this.setLogger(this.logger);
+    }
+    get(key) {
+        return this.requireCurrent().get(key);
+    }
+    mergeDefaults(values) {
+        this.requireCurrent();
+        const defaults = this.defaults.copy();
+        defaults.merge(new Config({}, values));
+        const next = defaults.copy();
+        next.merge(this.overrides);
+        this.defaults = defaults;
+        this.current = next;
+    }
+    /**
+     * Registers the validators and public paths sections declare, as collected by `defaultAppConfigs`. A section
+     * registered twice keeps both sets: every validator runs and the public paths are combined.
+     */
+    defineSections(sections) {
+        for (const [section, rules] of sections) {
+            const existing = this.sections.get(section);
+            this.sections.set(section, existing
+                ? {
+                    validators: [...existing.validators, ...rules.validators],
+                    public: [...new Set([...existing.public, ...rules.public])],
+                    env: { ...existing.env, ...rules.env },
+                }
+                : rules);
+        }
+    }
+    /**
+     * Adds the environment variables sections declare, as one more source above everything already loaded, and
+     * recomputes the configuration. Called once the sections are known, which is after the application's own sources
+     * were loaded; a variable an application also maps itself to the same field is harmless.
+     */
+    async loadSectionEnvironment(environment) {
+        const mappings = {};
+        for (const [section, rules] of this.sections) {
+            for (const [variable, mapping] of Object.entries(rules.env ?? {})) {
+                const absolute = { ...mapping, path: `${section}.${mapping.path}` };
+                const existing = mappings[variable];
+                if (existing && existing.path !== absolute.path) {
+                    throw new Error(`Environment variable ${variable} is declared for both ${existing.path} and ${absolute.path}.`);
+                }
+                mappings[variable] = absolute;
+            }
+        }
+        if (Object.keys(mappings).length === 0)
+            return;
+        this.sources.push({
+            provider: environmentProvider(environment, {
+                name: 'section-environment',
+                mappings,
+            }),
+        });
+        this.current = await this.loadConfig();
+    }
+    /** Every environment variable the sections declare, with the absolute path it sets, such as `{ AUTH_SECRET: 'auth.secret' }`. */
+    sectionEnvironmentVariables() {
+        const paths = {};
+        for (const [variable, mapping] of Object.entries(this.environmentVariableMappings()))
+            paths[variable] = mapping.path;
+        return paths;
+    }
+    /**
+     * Every environment variable the sections declare, with its mapping and the path made absolute, such as
+     * `{ AUTH_SECRET: { path: 'auth.secret', type: 'string', generate: 'secret' } }`.
+     */
+    environmentVariableMappings() {
+        const variables = {};
+        for (const [section, rules] of this.sections) {
+            for (const [variable, mapping] of Object.entries(rules.env ?? {})) {
+                variables[variable] = {
+                    ...mapping,
+                    path: `${section}.${mapping.path}`,
+                };
+            }
+        }
+        return variables;
+    }
+    /** Every issue the declared rules find in the current configuration, warnings included. Throws nothing. */
+    async validate() {
+        if (this.sections.size === 0)
+            return [];
+        return validateConfigSections(this.requireCurrent().raw(), this.overrides.raw(), this.sections);
+    }
+    /** The values sections publish to the browser, nested under their section names. */
+    publicValues() {
+        if (this.sections.size === 0)
+            return {};
+        return collectPublicConfig(this.requireCurrent().raw(), this.sections);
+    }
+    /** Every published path in full, such as `auth.emailAndPassword.disableSignUp`. */
+    publicPaths() {
+        return listPublicPaths(this.sections);
+    }
+    raw() {
+        return this.requireCurrent().raw();
+    }
+    /** The defaults and the values the application's own sources supply, kept apart. See {@link AppConfigLayers}. */
+    layers() {
+        this.requireCurrent();
+        return {
+            defaults: this.defaults.copy().raw(),
+            overrides: this.overrides.copy().raw(),
+        };
+    }
+    subscribe(namespace, listener) {
+        const listeners = this.listeners.get(namespace) ?? new Set();
+        listeners.add(listener);
+        this.listeners.set(namespace, listeners);
+        return () => {
+            listeners.delete(listener);
+        };
+    }
+    reload() {
+        const startedAt = Date.now();
+        this.reloadPromise ??= this.performReload()
+            .then((result) => {
+            this.logger?.debug({
+                changedNamespaces: result.changedNamespaces,
+                durationMs: Date.now() - startedAt,
+            }, 'App configuration reloaded');
+            return result;
+        })
+            .finally(() => {
+            this.reloadPromise = undefined;
+        });
+        return this.reloadPromise;
+    }
+    async performReload() {
+        const previous = this.requireCurrent();
+        const previousOverrides = this.overrides;
+        const next = await this.loadConfig();
+        // A reload that breaks a declared rule is refused and the running configuration stays as it was.
+        const issues = await validateConfigSections(next.raw(), this.overrides.raw(), this.sections);
+        if (issues.some((issue) => issue.level === 'error')) {
+            this.overrides = previousOverrides;
+            throw new AppConfigInvalidError(issues);
+        }
+        const namespaces = new Set([...previous.mapKeys(''), ...next.mapKeys('')]);
+        const changedNamespaces = [...namespaces]
+            .filter((namespace) => !isDeepStrictEqual(previous.get(namespace), next.get(namespace)))
+            .sort();
+        if (changedNamespaces.length === 0) {
+            return { changedNamespaces };
+        }
+        this.current = next;
+        for (const namespace of changedNamespaces) {
+            const listeners = this.listeners.get(namespace);
+            if (!listeners)
+                continue;
+            for (const listener of listeners) {
+                await listener({
+                    previous: previous.get(namespace),
+                    current: next.get(namespace),
+                });
+            }
+        }
+        return { changedNamespaces };
+    }
+    async loadConfig() {
+        const overrides = new Config();
+        for (const source of this.sources) {
+            await overrides.load(source.provider, source.parser, source.options);
+        }
+        const next = this.defaults.copy();
+        next.merge(overrides);
+        this.overrides = overrides;
+        return next;
+    }
+    requireCurrent() {
+        if (!this.current) {
+            throw new Error('Application config has not been initialized.');
+        }
+        return this.current;
+    }
+}
+function resolveConfigFilePath(filePath) {
+    if (path.extname(filePath))
+        return filePath;
+    const candidates = ['.yml', '.yaml', '.toml', '.json'].map((extension) => `${filePath}${extension}`);
+    return candidates.find((candidate) => existsSync(candidate)) ?? candidates[0];
+}
+/** Resolve deployment configuration independently of the compiled code directory. */
+export function resolveDefaultAppConfigFile(paths) {
+    const candidate = path.join(paths.deploymentRootDir, 'config');
+    const resolved = resolveConfigFilePath(candidate);
+    return existsSync(resolved) ? resolved : candidate;
+}
+//# sourceMappingURL=app-config.js.map

package/dist/config/app-config.js.map

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

package/dist/config/context.d.ts

@@ -0,0 +1,3 @@
+import type { ConfigContext, CreateConfigContextOptions } from './types.js';
+export declare function createConfigContext(options: CreateConfigContextOptions): ConfigContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/config/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/config/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE5E,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,aAAa,CAKf"}

package/dist/config/context.js

@@ -0,0 +1,7 @@
+export function createConfigContext(options) {
+    return {
+        environment: options.env,
+        paths: options.paths,
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/config/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/config/context.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CACjC,OAAmC;IAEnC,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,GAAG;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC;AACJ,CAAC"}

package/dist/config/define-app-config.d.ts

@@ -0,0 +1,71 @@
+import type { EnvironmentMapping } from '@nocobase/config/providers/env';
+import type { AppRuntimeContext } from '../runtime/definition.js';
+/** A problem a validator found, with its path relative to the section it validated. */
+export interface ConfigValidationContext {
+    error(path: string, message: string, options?: ConfigIssueOptions): void;
+    warning(path: string, message: string, options?: ConfigIssueOptions): void;
+    /** Whether the value at `path` came from a configuration file or the environment rather than code defaults. */
+    isUserProvided(path: string): boolean;
+}
+export interface ConfigIssueOptions {
+    /** A command or change that resolves the issue, written so it can be applied as is. */
+    readonly fix?: string;
+}
+/**
+ * Checks one section's final value — code defaults merged with the configuration file and the environment.
+ *
+ * It runs at startup, on every reload and in `config check`, so it may read local files but must not reach the
+ * network or write anything. The value is typed as the section, but it came from user input: check it as untrusted.
+ */
+export type ConfigValidator<T> = (value: T, context: ConfigValidationContext) => void | Promise<void>;
+export interface AppConfigDefinition<T extends object> {
+    readonly defaults: T | ((runtime: AppRuntimeContext) => T);
+    readonly validate?: ConfigValidator<T> | readonly ConfigValidator<T>[];
+    /**
+     * Leaf paths, relative to the section, that the browser may read through `config.public`. Anything not listed is
+     * never sent.
+     */
+    readonly public?: readonly string[];
+    /**
+     * Environment variables that set fields of this section, with paths relative to it, such as
+     * `{ AUTH_SECRET: envString('secret') }`. The owner of the section declares them here so that whoever reads a
+     * setting also maps it. `pnpm nocobase config env` lists every declared variable.
+     */
+    readonly env?: Readonly<Record<string, EnvironmentMapping>>;
+}
+/** What a section declares beyond its defaults, as the runtime reads it. */
+export interface AppConfigRules {
+    readonly validators: readonly ConfigValidator<never>[];
+    readonly public: readonly string[];
+    readonly env?: Readonly<Record<string, EnvironmentMapping>>;
+}
+export interface AppConfigFactory<T extends object = object> {
+    (runtime: AppRuntimeContext): T;
+    /** Present on a factory made by `defineAppConfig` with a validator or public paths. */
+    readonly rules?: AppConfigRules;
+    /** Present on a factory made by `defaultAppConfigs`: the rules of each section it combines, by section name. */
+    readonly sections?: ReadonlyMap<string, AppConfigRules>;
+}
+/**
+ * Declares one configuration section.
+ *
+ * A function is the shorthand for `{ defaults }`, so an existing `defineAppConfig((runtime) => ({ ... }))` keeps
+ * working unchanged.
+ */
+export declare function defineAppConfig<T extends object>(definition: AppConfigDefinition<T> | ((runtime: AppRuntimeContext) => T)): AppConfigFactory<T>;
+export declare function defaultAppConfigs<T extends Record<string, AppConfigFactory>>(configs: T): AppConfigFactory<{
+    [K in keyof T]: ReturnType<T[K]>;
+}>;
+export interface AppIdentityConfig {
+    readonly name: string;
+    readonly publicOrigin?: string;
+    readonly publicBasePath: string;
+    readonly internalBasePath: string;
+    readonly publicApiUrl: string;
+    /**
+     * Load sample data on the first start: the seeds declared with `sample: true` and what plugins register on
+     * `sampleDataToken`. Read only while the application's database is being installed; `APP_SAMPLE_DATA` sets it.
+     */
+    readonly sampleData?: boolean;
+}
+//# sourceMappingURL=define-app-config.d.ts.map

package/dist/config/define-app-config.d.ts.map

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

package/dist/config/define-app-config.js

@@ -0,0 +1,48 @@
+/**
+ * Declares one configuration section.
+ *
+ * A function is the shorthand for `{ defaults }`, so an existing `defineAppConfig((runtime) => ({ ... }))` keeps
+ * working unchanged.
+ */
+export function defineAppConfig(definition) {
+    if (typeof definition === 'function') {
+        return (runtime) => definition(runtime);
+    }
+    const { defaults } = definition;
+    // An object is returned as is rather than cloned: defaults may hold functions and instances, such as Better Auth
+    // plugins, and merging into the configuration copies what it keeps.
+    const factory = (runtime) => typeof defaults === 'function' ? defaults(runtime) : defaults;
+    const validators = toArray(definition.validate);
+    const publicPaths = [...(definition.public ?? [])];
+    const env = { ...definition.env };
+    if (validators.length === 0 &&
+        publicPaths.length === 0 &&
+        Object.keys(env).length === 0) {
+        return factory;
+    }
+    return Object.assign(factory, {
+        rules: Object.freeze({
+            validators: Object.freeze(validators),
+            public: Object.freeze(publicPaths),
+            env: Object.freeze(env),
+        }),
+    });
+}
+export function defaultAppConfigs(configs) {
+    const sections = new Map();
+    for (const [key, configure] of Object.entries(configs)) {
+        if (configure.rules)
+            sections.set(key, configure.rules);
+    }
+    const factory = (runtime) => Object.fromEntries(Object.entries(configs).map(([key, configure]) => [
+        key,
+        configure(runtime),
+    ]));
+    return Object.assign(factory, { sections });
+}
+function toArray(value) {
+    if (value === undefined)
+        return [];
+    return Array.isArray(value) ? [...value] : [value];
+}
+//# sourceMappingURL=define-app-config.js.map

package/dist/config/define-app-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-app-config.js","sourceRoot":"","sources":["../../src/config/define-app-config.ts"],"names":[],"mappings":"AA2DA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAwE;IAExE,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;QACrC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC;IAChC,iHAAiH;IACjH,oEAAoE;IACpE,MAAM,OAAO,GAAG,CAAC,OAA0B,EAAK,EAAE,CAChD,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAChE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;IAClC,IACE,UAAU,CAAC,MAAM,KAAK,CAAC;QACvB,WAAW,CAAC,MAAM,KAAK,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,EAC7B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;QAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACnB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;YACrC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;YAClC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;SACxB,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAU;IAEV,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IACnD,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,IAAI,SAAS,CAAC,KAAK;YAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,OAAO,GAAG,CACd,OAA0B,EACY,EAAE,CACxC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC;QAChD,GAAG;QACH,SAAS,CAAC,OAAO,CAAC;KACnB,CAAC,CACqC,CAAC;IAC5C,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,OAAO,CAAI,KAAmC;IACrD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAI,KAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,KAAU,CAAC,CAAC;AAC5E,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,13 @@
+export { AppConfig, resolveDefaultAppConfigFile } from './app-config.js';
+export { envBoolean, envInteger, envString, envStrings, isSecretPath, type EnvironmentMapping, type EnvironmentMetadata, type EnvironmentValueGenerator, } from '@nocobase/config/providers/env';
+export { buildVariablesManifest, isExamplePlaceholder, KNOWN_EXAMPLE_PLACEHOLDERS, requiredOf, type BuildVariablesManifestOptions, type VariablesManifest, type VariablesManifestEntry, } from './variables.js';
+export { defineAppConfig, defaultAppConfigs, type AppConfigDefinition, type AppConfigFactory, type AppConfigRules, type AppIdentityConfig, type ConfigIssueOptions, type ConfigValidationContext, type ConfigValidator, } from './define-app-config.js';
+export { AppConfigInvalidError, findAppConfigInvalid, formatConfigIssues, type ConfigIssue, } from './validation.js';
+export type * from './app-config-types.js';
+export * from './context.js';
+export * from './not-configured.js';
+export * from './placeholder-secret.js';
+export * from './paths.js';
+export { RUNTIME_ENVIRONMENT_VARIABLES, type RuntimeEnvironmentVariable, } from './runtime-environment.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EACL,UAAU,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,0BAA0B,EAC1B,UAAU,EACV,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AACzB,mBAAmB,uBAAuB,CAAC;AAC3C,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,6BAA6B,EAC7B,KAAK,0BAA0B,GAChC,MAAM,0BAA0B,CAAC;AAClC,mBAAmB,YAAY,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,11 @@
+export { AppConfig, resolveDefaultAppConfigFile } from './app-config.js';
+export { envBoolean, envInteger, envString, envStrings, isSecretPath, } from '@nocobase/config/providers/env';
+export { buildVariablesManifest, isExamplePlaceholder, KNOWN_EXAMPLE_PLACEHOLDERS, requiredOf, } from './variables.js';
+export { defineAppConfig, defaultAppConfigs, } from './define-app-config.js';
+export { AppConfigInvalidError, findAppConfigInvalid, formatConfigIssues, } from './validation.js';
+export * from './context.js';
+export * from './not-configured.js';
+export * from './placeholder-secret.js';
+export * from './paths.js';
+export { RUNTIME_ENVIRONMENT_VARIABLES, } from './runtime-environment.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EACL,UAAU,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,YAAY,GAIb,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,0BAA0B,EAC1B,UAAU,GAIX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,eAAe,EACf,iBAAiB,GAQlB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,GAEnB,MAAM,iBAAiB,CAAC;AAEzB,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,6BAA6B,GAE9B,MAAM,0BAA0B,CAAC"}

package/dist/config/not-configured.d.ts

@@ -0,0 +1,23 @@
+export interface ApplicationNotConfiguredDetails {
+    /** The configuration key that is missing, such as `auth.secret`. */
+    readonly key?: string;
+    /** The environment variable that can supply it instead, when the application maps one. */
+    readonly environmentVariable?: string;
+}
+/**
+ * The application has nothing to start with: no configuration supplies what it cannot run without.
+ *
+ * It states what is missing and nothing more. The remedy depends on how the application is run — a standalone start
+ * points at `pnpm nocobase config init`, while an application hosted by a Hub is configured through the Hub — so the entry point
+ * that prints the error adds it, and a Hub showing the same error to an operator does not pass on advice that does not
+ * apply. Recognised by `name` as well as by class, so a second copy of this package in the process is still
+ * recognised.
+ */
+export declare class ApplicationNotConfiguredError extends Error {
+    readonly key?: string;
+    readonly environmentVariable?: string;
+    constructor(message: string, details?: ApplicationNotConfiguredDetails);
+}
+/** Whether `error`, or anything in its cause chain, reports an application that has not been configured. */
+export declare function findApplicationNotConfigured(error: unknown): ApplicationNotConfiguredError | undefined;
+//# sourceMappingURL=not-configured.d.ts.map

package/dist/config/not-configured.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-configured.d.ts","sourceRoot":"","sources":["../../src/config/not-configured.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,+BAA+B;IAC9C,oEAAoE;IACpE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAED;;;;;;;;GAQG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,SAAgB,GAAG,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAgB,mBAAmB,CAAC,EAAE,MAAM,CAAC;gBAG3C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,+BAAoC;CAOhD;AAED,4GAA4G;AAC5G,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,6BAA6B,GAAG,SAAS,CAW3C"}

package/dist/config/not-configured.js

@@ -0,0 +1,31 @@
+/**
+ * The application has nothing to start with: no configuration supplies what it cannot run without.
+ *
+ * It states what is missing and nothing more. The remedy depends on how the application is run — a standalone start
+ * points at `pnpm nocobase config init`, while an application hosted by a Hub is configured through the Hub — so the entry point
+ * that prints the error adds it, and a Hub showing the same error to an operator does not pass on advice that does not
+ * apply. Recognised by `name` as well as by class, so a second copy of this package in the process is still
+ * recognised.
+ */
+export class ApplicationNotConfiguredError extends Error {
+    key;
+    environmentVariable;
+    constructor(message, details = {}) {
+        super(message);
+        this.name = 'ApplicationNotConfiguredError';
+        this.key = details.key;
+        this.environmentVariable = details.environmentVariable;
+    }
+}
+/** Whether `error`, or anything in its cause chain, reports an application that has not been configured. */
+export function findApplicationNotConfigured(error) {
+    let current = error;
+    for (let depth = 0; depth < 5 && current instanceof Error; depth += 1) {
+        if (current instanceof ApplicationNotConfiguredError ||
+            current.name === 'ApplicationNotConfiguredError')
+            return current;
+        current = current.cause;
+    }
+    return undefined;
+}
+//# sourceMappingURL=not-configured.js.map

package/dist/config/not-configured.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-configured.js","sourceRoot":"","sources":["../../src/config/not-configured.ts"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AACH,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IACtC,GAAG,CAAU;IACb,mBAAmB,CAAU;IAE7C,YACE,OAAe,EACf,UAA2C,EAAE;QAE7C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;QAC5C,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IACzD,CAAC;CACF;AAED,4GAA4G;AAC5G,MAAM,UAAU,4BAA4B,CAC1C,KAAc;IAEd,IAAI,OAAO,GAAY,KAAK,CAAC;IAC7B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,IAAI,OAAO,YAAY,KAAK,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACtE,IACE,OAAO,YAAY,6BAA6B;YAChD,OAAO,CAAC,IAAI,KAAK,+BAA+B;YAEhD,OAAO,OAAO,CAAC;QACjB,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/config/paths.d.ts

@@ -0,0 +1,27 @@
+export interface AppPathOptions {
+    readonly rootDir: string;
+    readonly deploymentRootDir?: string;
+    readonly serverDir?: string;
+    readonly databaseDir?: string;
+    readonly clientDir?: string;
+    readonly configDir?: string;
+    readonly storageDir?: string;
+}
+export interface AppPaths {
+    readonly rootDir: string;
+    readonly deploymentRootDir: string;
+    readonly serverDir: string;
+    readonly databaseDir: string;
+    readonly clientDir: string;
+    readonly configDir: string;
+    readonly storageDir: string;
+    root(relativePath?: string): string;
+    server(relativePath?: string): string;
+    database(relativePath?: string): string;
+    client(relativePath?: string): string;
+    config(relativePath?: string): string;
+    storage(relativePath?: string): string;
+}
+/** Resolve directory inputs once; all application consumers share this object. */
+export declare function createAppPaths(options: AppPathOptions): AppPaths;
+//# sourceMappingURL=paths.d.ts.map

package/dist/config/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxC;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,QAAQ,CA6BhE"}

package/dist/config/paths.js

@@ -0,0 +1,27 @@
+import path from 'node:path';
+/** Resolve directory inputs once; all application consumers share this object. */
+export function createAppPaths(options) {
+    const rootDir = path.resolve(options.rootDir);
+    const deploymentRootDir = path.resolve(rootDir, options.deploymentRootDir ?? '.');
+    const serverDir = path.resolve(rootDir, options.serverDir ?? 'server');
+    const databaseDir = path.resolve(rootDir, options.databaseDir ?? 'database');
+    const clientDir = path.resolve(rootDir, options.clientDir ?? 'client');
+    const configDir = path.resolve(serverDir, options.configDir ?? 'config');
+    const storageDir = path.resolve(deploymentRootDir, options.storageDir ?? 'storage');
+    return Object.freeze({
+        rootDir,
+        deploymentRootDir,
+        serverDir,
+        databaseDir,
+        clientDir,
+        configDir,
+        storageDir,
+        root: (relativePath = '') => path.resolve(rootDir, relativePath),
+        server: (relativePath = '') => path.resolve(serverDir, relativePath),
+        database: (relativePath = '') => path.resolve(databaseDir, relativePath),
+        client: (relativePath = '') => path.resolve(clientDir, relativePath),
+        config: (relativePath = '') => path.resolve(configDir, relativePath),
+        storage: (relativePath = '') => path.resolve(storageDir, relativePath),
+    });
+}
+//# sourceMappingURL=paths.js.map

package/dist/config/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AA4B7B,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CACpC,OAAO,EACP,OAAO,CAAC,iBAAiB,IAAI,GAAG,CACjC,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,IAAI,QAAQ,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,IAAI,UAAU,CAAC,CAAC;IAC7E,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,IAAI,QAAQ,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,QAAQ,CAAC,CAAC;IACzE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAC7B,iBAAiB,EACjB,OAAO,CAAC,UAAU,IAAI,SAAS,CAChC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO;QACP,iBAAiB;QACjB,SAAS;QACT,WAAW;QACX,SAAS;QACT,SAAS;QACT,UAAU;QACV,IAAI,EAAE,CAAC,YAAY,GAAG,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC;QAChE,MAAM,EAAE,CAAC,YAAY,GAAG,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC;QACpE,QAAQ,EAAE,CAAC,YAAY,GAAG,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC;QACxE,MAAM,EAAE,CAAC,YAAY,GAAG,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC;QACpE,MAAM,EAAE,CAAC,YAAY,GAAG,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC;QACpE,OAAO,EAAE,CAAC,YAAY,GAAG,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC;KACvE,CAAC,CAAC;AACL,CAAC"}

package/dist/config/placeholder-secret.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The value `config.example.yml` ships for every secret it declares.
+ *
+ * The example carries live keys rather than commented-out ones, so that `@nocobase/create-app` can fill them in by
+ * replacing a value instead of by uncommenting a line. That makes one thing possible that a commented placeholder did
+ * not: a `config.yml` copied from the example by hand starts with a secret that is present, non-empty, identical
+ * across every installation, and published in this repository. Nothing downstream can tell it apart from a real one,
+ * so it is rejected here instead.
+ */
+export declare const PLACEHOLDER_SECRET = "replace-with-a-unique-secret";
+export declare function isPlaceholderSecret(value: string | undefined): boolean;
+/**
+ * Rejects a secret still left at the example's placeholder.
+ *
+ * `key` names the setting as it is written in configuration, such as `auth.secret`, because that is what the reader
+ * has to go and change.
+ */
+export declare function assertSecretIsNotPlaceholder(value: string | undefined, key: string): void;
+//# sourceMappingURL=placeholder-secret.d.ts.map

package/dist/config/placeholder-secret.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-secret.d.ts","sourceRoot":"","sources":["../../src/config/placeholder-secret.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AAEjE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,EAAE,MAAM,GACV,IAAI,CAQN"}

package/dist/config/placeholder-secret.js

@@ -0,0 +1,26 @@
+/**
+ * The value `config.example.yml` ships for every secret it declares.
+ *
+ * The example carries live keys rather than commented-out ones, so that `@nocobase/create-app` can fill them in by
+ * replacing a value instead of by uncommenting a line. That makes one thing possible that a commented placeholder did
+ * not: a `config.yml` copied from the example by hand starts with a secret that is present, non-empty, identical
+ * across every installation, and published in this repository. Nothing downstream can tell it apart from a real one,
+ * so it is rejected here instead.
+ */
+export const PLACEHOLDER_SECRET = 'replace-with-a-unique-secret';
+export function isPlaceholderSecret(value) {
+    return value?.trim() === PLACEHOLDER_SECRET;
+}
+/**
+ * Rejects a secret still left at the example's placeholder.
+ *
+ * `key` names the setting as it is written in configuration, such as `auth.secret`, because that is what the reader
+ * has to go and change.
+ */
+export function assertSecretIsNotPlaceholder(value, key) {
+    if (!isPlaceholderSecret(value)) {
+        return;
+    }
+    throw new Error(`${key} is still set to the placeholder from config.example.yml. Replace it with a unique value, for example one generated with: openssl rand -hex 32`);
+}
+//# sourceMappingURL=placeholder-secret.js.map