@astram/guard 0.12.1 → 0.14.0

package/dist/auth/connections.d.ts

@@ -24,7 +24,8 @@
 import { type OnModuleDestroy } from '@nestjs/common';
 import { type Pool } from 'mariadb';
 import Redis from 'ioredis';
-import { type AppConfig } from '../config/app-config.js';
+import { type AppConfig, type DbTlsConfig } from '../config/app-config.js';
+import { isLoopbackHost } from '../config/loopback-host.js';
 /**
  * Create the ONE live `mariadb` {@link Pool} for the `shield_core` account from
  * {@link AppConfig}. The `connectionLimit` comes from the ADR-0018 budget
@@ -37,6 +38,23 @@ import { type AppConfig } from '../config/app-config.js';
  * documented defaults, so the descriptor is always well-formed.
  */
 export declare function createDbPool(config: AppConfig): Pool;
+export { isLoopbackHost };
+/**
+ * The boot warning for a production pool to a remote MariaDB without TLS (Phase 16), or
+ * `undefined` when none applies. Warns only: production accounts are provisioned `REQUIRE SSL`,
+ * so the server refuses such a login anyway; the warning names the cause before that error.
+ * Names the host and the env var only, never the user or password.
+ */
+export declare function dbTlsBootWarning(config: Pick<AppConfig, 'db'>, env?: NodeJS.ProcessEnv): string | undefined;
+/**
+ * The `mariadb` driver's `ssl` option for {@link DbTlsConfig} (Phase 16): `undefined` when off;
+ * otherwise TLS that always verifies the server, against the CA file when one is configured.
+ * Every framework pool uses this, so `APP_DB_TLS=on` reaches all of them.
+ */
+export declare function mariadbSslOption(tls: DbTlsConfig | undefined): {
+    readonly ca?: string;
+    readonly rejectUnauthorized: true;
+} | undefined;
 /**
  * Create the ONE live `ioredis` client (the hot session tier, ADR-0013) from
  * {@link AppConfig}. `config.redis.url` is the canonical `ioredis`-native form

package/dist/auth/connections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../../src/auth/connections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAgB,EAAE,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,MAAM,SAAS,CAAC;AAC5B,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAE3F;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAcpD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,KAAK,CAgB1D;AAED;;;;;;GAMG;AACH,qBACa,mBAAoB,YAAW,eAAe;IAEvD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK;IAGzB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;CAavC"}
+{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../../src/auth/connections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAgB,EAAE,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,MAAM,SAAS,CAAC;AAC5B,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiBpD;AAMD,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAC7B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CASpB;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,WAAW,GAAG,SAAS,GAC3B;IAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,kBAAkB,EAAE,IAAI,CAAA;CAAE,GAAG,SAAS,CAIzE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,KAAK,CAgB1D;AAED;;;;;;GAMG;AACH,qBACa,mBAAoB,YAAW,eAAe;IAEvD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK;IAGzB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;CAavC"}

package/dist/auth/connections.js

@@ -35,13 +35,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConnectionLifecycle = void 0;
+exports.ConnectionLifecycle = exports.isLoopbackHost = void 0;
 exports.createDbPool = createDbPool;
+exports.dbTlsBootWarning = dbTlsBootWarning;
+exports.mariadbSslOption = mariadbSslOption;
 exports.createRedisClient = createRedisClient;
+const node_fs_1 = require("node:fs");
 const common_1 = require("@nestjs/common");
 const mariadb_1 = __importDefault(require("mariadb"));
 const ioredis_1 = __importDefault(require("ioredis"));
 const app_config_js_1 = require("../config/app-config.js");
+const loopback_host_js_1 = require("../config/loopback-host.js");
+Object.defineProperty(exports, "isLoopbackHost", { enumerable: true, get: function () { return loopback_host_js_1.isLoopbackHost; } });
 /**
  * Create the ONE live `mariadb` {@link Pool} for the `shield_core` account from
  * {@link AppConfig}. The `connectionLimit` comes from the ADR-0018 budget
@@ -55,6 +60,9 @@ const app_config_js_1 = require("../config/app-config.js");
  */
 function createDbPool(config) {
     const { db, pool } = config;
+    const tlsWarning = dbTlsBootWarning(config);
+    if (tlsWarning !== undefined)
+        dbBootLogger.warn(tlsWarning);
     return mariadb_1.default.createPool({
         host: db.host,
         port: db.port,
@@ -66,8 +74,43 @@ function createDbPool(config) {
         connectTimeout: 10_000,
         // All platform timestamps are UTC (parity with the session adapters).
         timezone: 'Z',
+        ...withSsl(mariadbSslOption(db.tls)),
     });
 }
+const dbBootLogger = new common_1.Logger('ShieldAuth');
+/**
+ * The boot warning for a production pool to a remote MariaDB without TLS (Phase 16), or
+ * `undefined` when none applies. Warns only: production accounts are provisioned `REQUIRE SSL`,
+ * so the server refuses such a login anyway; the warning names the cause before that error.
+ * Names the host and the env var only, never the user or password.
+ */
+function dbTlsBootWarning(config, env = process.env) {
+    if (env.NODE_ENV !== 'production')
+        return undefined;
+    if ((config.db.tls?.mode ?? 'off') === 'on')
+        return undefined;
+    if ((0, loopback_host_js_1.isLoopbackHost)(config.db.host))
+        return undefined;
+    return (`APP_DB_TLS is off but APP_DB_HOST '${config.db.host}' is not loopback (NODE_ENV=production): ` +
+        'database traffic, credentials included, is sent in plaintext. Set APP_DB_TLS=on ' +
+        '(and APP_DB_TLS_CA if the server certificate is not publicly trusted).');
+}
+/** `{ ssl }` when TLS is on, `{}` when off (spread into a driver config). */
+function withSsl(ssl) {
+    return ssl === undefined ? {} : { ssl };
+}
+/**
+ * The `mariadb` driver's `ssl` option for {@link DbTlsConfig} (Phase 16): `undefined` when off;
+ * otherwise TLS that always verifies the server, against the CA file when one is configured.
+ * Every framework pool uses this, so `APP_DB_TLS=on` reaches all of them.
+ */
+function mariadbSslOption(tls) {
+    if (tls === undefined || tls.mode === 'off')
+        return undefined;
+    if (tls.caPath === undefined)
+        return { rejectUnauthorized: true };
+    return { ca: (0, node_fs_1.readFileSync)(tls.caPath, 'utf8'), rejectUnauthorized: true };
+}
 /**
  * Create the ONE live `ioredis` client (the hot session tier, ADR-0013) from
  * {@link AppConfig}. `config.redis.url` is the canonical `ioredis`-native form

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

@@ -96,6 +96,21 @@ export interface DbConfig {
     /** ⛔ Secret — resolved from env/secrets-manager; never logged. */
     readonly password: string;
     readonly database: string;
+    /**
+     * TLS to MariaDB (Phase 16, `APP_DB_TLS` / `APP_DB_TLS_CA`). Absent ⇒ off. Production accounts
+     * are provisioned `REQUIRE SSL` (`infra/mariadb/grants/matrix.json`), so production sets `on`.
+     */
+    readonly tls?: DbTlsConfig;
+}
+/**
+ * TLS to MariaDB. `on` always verifies the server: against `caPath` (a PEM file) when set, else
+ * the connector's default verification (MariaDB 11.4's auto-generated certificate is verified
+ * from the password exchange). There is deliberately no unverified mode.
+ */
+export interface DbTlsConfig {
+    readonly mode: 'off' | 'on';
+    /** PEM file of the CA that signed the server certificate (read when a pool is created). */
+    readonly caPath?: string;
 }
 /**
  * The Redis connection descriptor. A single `url` (e.g. `redis://host:6379`) is
@@ -206,6 +221,14 @@ export declare const DEFAULT_REDIS_URL = "redis://localhost:6379";
  * which is a fail-closed security invariant even for unit tests).
  */
 export declare function loadDbConfig(env?: NodeJS.ProcessEnv): DbConfig;
+/**
+ * `APP_DB_TLS` = `off` (default) | `on`; `APP_DB_TLS_CA` = PEM path (only with `on`). Anything
+ * else throws at boot: a typo must not silently fall back to plaintext.
+ */
+export declare function loadDbTlsConfig(env?: NodeJS.ProcessEnv, names?: {
+    readonly mode: string;
+    readonly ca: string;
+}): DbTlsConfig;
 /**
  * Build the {@link RedisConfig} from env. Prefers `REDIS_URL`; falls back
  * to composing `redis://host:port` from `REDIS_HOST`/`REDIS_PORT`, else the
@@ -287,6 +310,49 @@ export declare function loadAppConfig(env?: NodeJS.ProcessEnv): AppConfig;
  * The core resolver (`resolveSecretRefs`) does the work; this is the guard-side boot seam.
  */
 export declare function loadAppConfigAsync(provider?: SecretsProvider, env?: NodeJS.ProcessEnv): Promise<AppConfig>;
+/** The S3-compatible object store descriptor read from `OBJECT_STORAGE_*`. */
+export interface ObjectStorageConfig {
+    /** `https:` URL (or `http:` in development/test, or to a loopback host). Never carries userinfo. */
+    readonly endpoint: string;
+    readonly bucket: string;
+    /** `OBJECT_STORAGE_REGION`, default `us-east-1`. */
+    readonly region: string;
+    readonly accessKeyId: string;
+    readonly secretAccessKey: string;
+    /** Server-side encryption mode. Only SSE-S3 (`AES256`) is accepted now. */
+    readonly sse: 'AES256';
+    /** `OBJECT_STORAGE_MAX_BYTES` (default 10 MiB), at most `FILE_MAX_BYTES_CEILING` (50 MiB). */
+    readonly maxBytes: number;
+}
+/** Options for {@link loadObjectStorageConfig}. */
+export interface LoadObjectStorageConfigOptions {
+    /**
+     * Provenance check for the two credential variables outside development/test (SPEC §5 F: a
+     * literal credential there is a boot error). Returns `true` when the variable's value was
+     * resolved from a `secret-ref:` at boot (`wasResolvedFromSecretRef`). Omitted outside
+     * development/test: fail closed, every credential is treated as a literal and refused (the
+     * value alone cannot tell a literal from a resolved reference).
+     */
+    readonly resolvedFromSecretRef?: (envKey: string, env: Readonly<Record<string, string | undefined>>) => boolean;
+}
+/** Default per-file cap when `OBJECT_STORAGE_MAX_BYTES` is unset (10 MiB, SPEC §10). */
+export declare const DEFAULT_OBJECT_STORAGE_MAX_BYTES: number;
+/**
+ * Read the object-storage config (FILE_STORAGE SPEC §5 F). Returns `undefined` when
+ * `OBJECT_STORAGE_BUCKET` is unset or blank (storage off). Otherwise every bad value is a boot
+ * error that names the variable and never its value (Shield #1, #10):
+ * - endpoint or either credential missing/blank;
+ * - endpoint not a URL, carrying userinfo, or not `https:` outside development/test unless the
+ *   host is loopback (the raw `NODE_ENV`; unset is not dev);
+ * - a credential still holding an unresolved `secret-ref:` value;
+ * - outside development/test, a credential not resolved from a `secret-ref:` per
+ *   `options.resolvedFromSecretRef` (`ShieldModule.forRoot({ storage: 'env' })` passes
+ *   `wasResolvedFromSecretRef`); without the option every credential there is refused;
+ * - `OBJECT_STORAGE_SSE` other than `AES256`;
+ * - `OBJECT_STORAGE_MAX_BYTES` not a plain positive decimal without leading zeros, or above the
+ *   50 MiB ceiling.
+ */
+export declare function loadObjectStorageConfig(env?: NodeJS.ProcessEnv, options?: LoadObjectStorageConfigOptions): ObjectStorageConfig | undefined;
 /** Result of evaluating a {@link PoolBudgetConfig} against the ADR-0018 budget. */
 export interface PoolBudgetEvaluation {
     /** Σ(per-account runtime pool max) for a single worker. */

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

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

package/dist/config/app-config.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_REDIS_URL = exports.DEFAULT_DB_CONFIG = exports.SCHEMA_SVC_POOL_HARD_CAP = exports.DEFAULT_POOL_BUDGET = exports.DEFAULT_REDIS_COMMAND_TIMEOUT_MS = exports.DEFAULT_LOGIN_IP_LIMIT = void 0;
+exports.DEFAULT_OBJECT_STORAGE_MAX_BYTES = exports.DEFAULT_REDIS_URL = exports.DEFAULT_DB_CONFIG = exports.SCHEMA_SVC_POOL_HARD_CAP = exports.DEFAULT_POOL_BUDGET = exports.DEFAULT_REDIS_COMMAND_TIMEOUT_MS = exports.DEFAULT_LOGIN_IP_LIMIT = void 0;
 exports.isDevOrTestNodeEnv = isDevOrTestNodeEnv;
 exports.loadPoolBudget = loadPoolBudget;
 exports.loadDbConfig = loadDbConfig;
+exports.loadDbTlsConfig = loadDbTlsConfig;
 exports.loadRedisConfig = loadRedisConfig;
 exports.loadSessionLifetimes = loadSessionLifetimes;
 exports.loadLoginIpLimit = loadLoginIpLimit;
@@ -12,8 +13,10 @@ exports.loadRefreshHmacKey = loadRefreshHmacKey;
 exports.assertRefreshHmacKey = assertRefreshHmacKey;
 exports.loadAppConfig = loadAppConfig;
 exports.loadAppConfigAsync = loadAppConfigAsync;
+exports.loadObjectStorageConfig = loadObjectStorageConfig;
 exports.evaluatePoolBudget = evaluatePoolBudget;
 const core_1 = require("@astram/core");
+const loopback_host_js_1 = require("./loopback-host.js");
 /** Plan D3 default: 50 failed logins per client IP per 15 minutes. */
 exports.DEFAULT_LOGIN_IP_LIMIT = {
     maxAttempts: 50,
@@ -144,8 +147,27 @@ function loadDbConfig(env = process.env) {
         user: parseString(env.APP_DB_USER, exports.DEFAULT_DB_CONFIG.user),
         password: parseString(env.APP_DB_PASSWORD, ''),
         database: parseString(env.APP_DB_NAME, exports.DEFAULT_DB_CONFIG.database),
+        tls: loadDbTlsConfig(env),
     };
 }
+/**
+ * `APP_DB_TLS` = `off` (default) | `on`; `APP_DB_TLS_CA` = PEM path (only with `on`). Anything
+ * else throws at boot: a typo must not silently fall back to plaintext.
+ */
+function loadDbTlsConfig(env = process.env, names = {
+    mode: 'APP_DB_TLS',
+    ca: 'APP_DB_TLS_CA',
+}) {
+    const raw = parseString(env[names.mode], 'off').toLowerCase();
+    if (raw !== 'off' && raw !== 'on') {
+        throw new Error(`${names.mode} must be 'on' or 'off', got '${env[names.mode]}'.`);
+    }
+    const caPath = parseString(env[names.ca], '');
+    if (caPath !== '' && raw === 'off') {
+        throw new Error(`${names.ca} is set but ${names.mode} is off: set ${names.mode}=on.`);
+    }
+    return raw === 'on' && caPath !== '' ? { mode: 'on', caPath } : { mode: raw };
+}
 /**
  * Build the {@link RedisConfig} from env. Prefers `REDIS_URL`; falls back
  * to composing `redis://host:port` from `REDIS_HOST`/`REDIS_PORT`, else the
@@ -290,6 +312,95 @@ async function loadAppConfigAsync(provider, env = process.env) {
     const resolved = await (0, core_1.resolveSecretRefs)(env, provider);
     return loadAppConfig(resolved);
 }
+/** Default per-file cap when `OBJECT_STORAGE_MAX_BYTES` is unset (10 MiB, SPEC §10). */
+exports.DEFAULT_OBJECT_STORAGE_MAX_BYTES = 10 * 1024 * 1024;
+/**
+ * Read the object-storage config (FILE_STORAGE SPEC §5 F). Returns `undefined` when
+ * `OBJECT_STORAGE_BUCKET` is unset or blank (storage off). Otherwise every bad value is a boot
+ * error that names the variable and never its value (Shield #1, #10):
+ * - endpoint or either credential missing/blank;
+ * - endpoint not a URL, carrying userinfo, or not `https:` outside development/test unless the
+ *   host is loopback (the raw `NODE_ENV`; unset is not dev);
+ * - a credential still holding an unresolved `secret-ref:` value;
+ * - outside development/test, a credential not resolved from a `secret-ref:` per
+ *   `options.resolvedFromSecretRef` (`ShieldModule.forRoot({ storage: 'env' })` passes
+ *   `wasResolvedFromSecretRef`); without the option every credential there is refused;
+ * - `OBJECT_STORAGE_SSE` other than `AES256`;
+ * - `OBJECT_STORAGE_MAX_BYTES` not a plain positive decimal without leading zeros, or above the
+ *   50 MiB ceiling.
+ */
+function loadObjectStorageConfig(env = process.env, options = {}) {
+    const bucket = env.OBJECT_STORAGE_BUCKET?.trim();
+    if (!bucket)
+        return undefined;
+    const devOrTest = isDevOrTestNodeEnv(env.NODE_ENV);
+    const endpoint = requireStorageVar(env, 'OBJECT_STORAGE_ENDPOINT');
+    let url;
+    try {
+        url = new URL(endpoint);
+    }
+    catch {
+        throw new Error('OBJECT_STORAGE_ENDPOINT is not a valid URL');
+    }
+    if (url.protocol !== 'https:' && url.protocol !== 'http:') {
+        throw new Error('OBJECT_STORAGE_ENDPOINT must be an https: (or local http:) URL');
+    }
+    if (url.username !== '' || url.password !== '') {
+        throw new Error('OBJECT_STORAGE_ENDPOINT must not carry credentials (use OBJECT_STORAGE_ACCESS_KEY_ID / ' +
+            'OBJECT_STORAGE_SECRET_ACCESS_KEY)');
+    }
+    if (url.protocol === 'http:' && !devOrTest && !(0, loopback_host_js_1.isLoopbackHost)(url.hostname)) {
+        throw new Error('OBJECT_STORAGE_ENDPOINT must use https: outside NODE_ENV development/test ' +
+            '(plain http: is allowed only to a loopback host)');
+    }
+    const credential = (name) => {
+        const value = requireStorageVar(env, name);
+        // `startsWith` via the core predicate on a widened copy: the predicate is a type guard.
+        if ((0, core_1.isSecretRef)(value)) {
+            throw new Error(`${name} still holds an unresolved secret-ref: value; call resolveBootSecrets() in main.ts ` +
+                'before loading AppModule');
+        }
+        // Fail closed: without a provenance check every credential counts as a literal here.
+        if (!devOrTest && !(options.resolvedFromSecretRef?.(name, env) === true)) {
+            throw new Error(`${name} must be a secret-ref: value outside NODE_ENV development/test ` +
+                '(literal credentials are refused; see ADR-0032)');
+        }
+        return value;
+    };
+    const accessKeyId = credential('OBJECT_STORAGE_ACCESS_KEY_ID');
+    const secretAccessKey = credential('OBJECT_STORAGE_SECRET_ACCESS_KEY');
+    const sse = env.OBJECT_STORAGE_SSE?.trim() || 'AES256';
+    if (sse !== 'AES256') {
+        throw new Error("OBJECT_STORAGE_SSE must be 'AES256' (SSE-S3); other modes are not supported");
+    }
+    return {
+        endpoint,
+        bucket,
+        region: env.OBJECT_STORAGE_REGION?.trim() || 'us-east-1',
+        accessKeyId,
+        secretAccessKey,
+        sse,
+        maxBytes: parseStorageMaxBytes(env.OBJECT_STORAGE_MAX_BYTES),
+    };
+}
+function requireStorageVar(env, name) {
+    const value = env[name]?.trim();
+    if (!value)
+        throw new Error(`${name} must be set when OBJECT_STORAGE_BUCKET is set`);
+    return value;
+}
+function parseStorageMaxBytes(raw) {
+    const value = raw?.trim();
+    if (!value)
+        return exports.DEFAULT_OBJECT_STORAGE_MAX_BYTES;
+    // Plain decimal digits, no sign, exponent, separators or leading zeros.
+    const n = /^[1-9]\d*$/.test(value) ? Number(value) : NaN;
+    if (!Number.isSafeInteger(n) || n <= 0 || n > core_1.FILE_MAX_BYTES_CEILING) {
+        throw new Error(`OBJECT_STORAGE_MAX_BYTES must be a positive decimal integer (no leading zeros) of at most ` +
+            `${core_1.FILE_MAX_BYTES_CEILING} bytes`);
+    }
+    return n;
+}
 /**
  * Evaluate a pool budget. Pure: no throwing, no I/O — the caller decides how to
  * react (the boot assertion throws; tests inspect the fields).

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

@@ -1 +1 @@
-{"version":3,"file":"config.module.d.ts","sourceRoot":"","sources":["../../src/config/config.module.ts"],"names":[],"mappings":"AAGA,mDAAmD;AACnD,eAAO,MAAM,UAAU,eAAuB,CAAC;AAE/C;;;;;;GAMG;AACH,qBAUa,YAAY;CAAG"}
+{"version":3,"file":"config.module.d.ts","sourceRoot":"","sources":["../../src/config/config.module.ts"],"names":[],"mappings":"AAIA,mDAAmD;AACnD,eAAO,MAAM,UAAU,eAAuB,CAAC;AAE/C;;;;;;GAMG;AACH,qBAaa,YAAY;CAAG"}

package/dist/config/config.module.js

@@ -9,6 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConfigModule = exports.APP_CONFIG = void 0;
 const common_1 = require("@nestjs/common");
 const app_config_js_1 = require("./app-config.js");
+const boot_secrets_js_1 = require("../secrets/boot-secrets.js");
 /** DI token for the resolved {@link AppConfig}. */
 exports.APP_CONFIG = Symbol('APP_CONFIG');
 /**
@@ -27,7 +28,10 @@ exports.ConfigModule = ConfigModule = __decorate([
         providers: [
             {
                 provide: exports.APP_CONFIG,
-                useFactory: () => (0, app_config_js_1.loadAppConfig)(),
+                useFactory: () => {
+                    (0, boot_secrets_js_1.assertNoUnresolvedSecretRefs)(process.env);
+                    return (0, app_config_js_1.loadAppConfig)();
+                },
             },
         ],
         exports: [exports.APP_CONFIG],

package/dist/config/loopback-host.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Loopback host predicate, shared by the DB TLS boot warning (`auth/connections.ts`) and the
+ * object-storage endpoint check (`loadObjectStorageConfig`). Kept dependency-free here so
+ * `app-config.ts` can use it without importing the driver-loading connections module (which
+ * itself imports `app-config.ts`).
+ */
+/** `localhost`, `127.0.0.0/8` or `::1` (any case, with or without IPv6 brackets). */
+export declare function isLoopbackHost(host: string): boolean;
+//# sourceMappingURL=loopback-host.d.ts.map

package/dist/config/loopback-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopback-host.d.ts","sourceRoot":"","sources":["../../src/config/loopback-host.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOpD"}

package/dist/config/loopback-host.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Loopback host predicate, shared by the DB TLS boot warning (`auth/connections.ts`) and the
+ * object-storage endpoint check (`loadObjectStorageConfig`). Kept dependency-free here so
+ * `app-config.ts` can use it without importing the driver-loading connections module (which
+ * itself imports `app-config.ts`).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLoopbackHost = isLoopbackHost;
+/** `localhost`, `127.0.0.0/8` or `::1` (any case, with or without IPv6 brackets). */
+function isLoopbackHost(host) {
+    const h = host
+        .trim()
+        .toLowerCase()
+        .replace(/^\[(.*)\]$/, '$1');
+    if (h === 'localhost' || h === '::1' || h === '0:0:0:0:0:0:0:1')
+        return true;
+    return /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(h);
+}

package/dist/encryption/local-kek-crypto.d.ts

@@ -9,6 +9,12 @@ export declare class LocalKekCrypto implements CryptoPort {
     generateDek(): Promise<Dek>;
     wrapDek(dek: Dek, tenantId: string): Promise<WrappedDek>;
     unwrapDek(wrapped: WrappedDek, tenantId: string): Promise<Dek>;
+    /**
+     * Synchronous {@link unwrapDek} (same AEAD, same AAD binding) for boot paths that must fail
+     * closed before any async work runs (`createSecretsProviderFromEnv`). Throws on a wrong KEK,
+     * a wrong AAD or a malformed blob; never includes key material in the error.
+     */
+    unwrapDekSync(wrapped: WrappedDek, tenantId: string): Dek;
     encrypt(plaintext: Uint8Array, dek: Dek, tenantId: string): Promise<Ciphertext>;
     decrypt(ciphertext: Ciphertext, dek: Dek, tenantId: string): Promise<Uint8Array>;
 }

package/dist/encryption/local-kek-crypto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-kek-crypto.d.ts","sourceRoot":"","sources":["../../src/encryption/local-kek-crypto.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAO5E,qBAAa,cAAe,YAAW,UAAU;;IAG/C;;;OAGG;gBACS,GAAG,EAAE,UAAU;IAOrB,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC;IAI3B,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIxD,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAI9D,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI/E,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CA2BvF"}
+{"version":3,"file":"local-kek-crypto.d.ts","sourceRoot":"","sources":["../../src/encryption/local-kek-crypto.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAO5E,qBAAa,cAAe,YAAW,UAAU;;IAG/C;;;OAGG;gBACS,GAAG,EAAE,UAAU;IAOrB,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC;IAI3B,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIxD,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAIpE;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG;IAInD,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI/E,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CA2BvF"}

package/dist/encryption/local-kek-crypto.js

@@ -44,6 +44,14 @@ class LocalKekCrypto {
         return this.#seal(this.#kek, Buffer.from(dek), tenantId);
     }
     async unwrapDek(wrapped, tenantId) {
+        return this.unwrapDekSync(wrapped, tenantId);
+    }
+    /**
+     * Synchronous {@link unwrapDek} (same AEAD, same AAD binding) for boot paths that must fail
+     * closed before any async work runs (`createSecretsProviderFromEnv`). Throws on a wrong KEK,
+     * a wrong AAD or a malformed blob; never includes key material in the error.
+     */
+    unwrapDekSync(wrapped, tenantId) {
         return new Uint8Array(this.#open(this.#kek, Buffer.from(wrapped), tenantId));
     }
     async encrypt(plaintext, dek, tenantId) {

package/dist/identity/identity-actions.d.ts

@@ -1,10 +1,10 @@
 /**
- * The fixed action vocabulary + module key for the framework's @astram/identity objects.
- * Engine ObjectTypes carry no action list, so actions are synthesized here — the ONE source
- * the module-registry bridge derives from. Permission keys are `identity:<typeKey>:<action>`.
- * (Ported from astram3. `cross_tenant_grant` gets its own override — see below — every other
- * type uses the CRUD verbs.)
+ * Module key + action-vocabulary constants for the framework's identity registry. Permission
+ * keys are `identity:<typeKey>:<action>`. A type's vocabulary is declared on its engine
+ * ObjectType (`actions` / `crudActions`, ADR-0038) and read through {@link actionsOf}; the
+ * constants below stay exported as the single literal each identity object declares.
  */
+import type { ObjectType } from '@astram/engine';
 export declare const MODULE_KEY = "identity";
 export declare const IDENTITY_ACTIONS: readonly ["read", "create", "update", "delete"];
 export type IdentityAction = (typeof IDENTITY_ACTIONS)[number];
@@ -33,6 +33,17 @@ export type RecordShareAction = (typeof RECORD_SHARE_ACTIONS)[number];
  */
 export declare const SERVICE_ACCOUNT_ACTIONS: readonly ["read", "create", "update", "delete", "manage_keys"];
 export type ServiceAccountAction = (typeof SERVICE_ACCOUNT_ACTIONS)[number];
-/** The action vocabulary for `typeKey` — the per-type override if one exists, else the default. */
-export declare function actionsFor(typeKey: string): readonly string[];
+/**
+ * The action vocabulary declared on a registration (ADR-0038): the CRUD verbs then the declared
+ * extras, or exactly the declared list when `crudActions === false`. Delegates to engine
+ * `effectiveActions`, so an invalid declaration throws the same `RegistrationError`.
+ */
+export declare function actionsOf(reg: Pick<ObjectType, 'actions' | 'crudActions'>): readonly string[];
+/**
+ * @deprecated Use {@link actionsOf} with the type's registration. The vocabulary now lives on
+ * the object type (ADR-0038), so a typeKey alone cannot name it: this returns the CRUD verbs
+ * ({@link IDENTITY_ACTIONS}) for every type, including `cross_tenant_grant`, `record_share` and
+ * `service_account`. The framework no longer calls it.
+ */
+export declare function actionsFor(_typeKey: string): readonly string[];
 //# sourceMappingURL=identity-actions.d.ts.map

package/dist/identity/identity-actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity-actions.d.ts","sourceRoot":"","sources":["../../src/identity/identity-actions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,aAAa,CAAC;AACrC,eAAO,MAAM,gBAAgB,iDAAkD,CAAC;AAChF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,wCAAyC,CAAC;AACjF,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,4BAA6B,CAAC;AAC/D,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,gEAM1B,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAY5E,mGAAmG;AACnG,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAE7D"}
+{"version":3,"file":"identity-actions.d.ts","sourceRoot":"","sources":["../../src/identity/identity-actions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,eAAO,MAAM,UAAU,aAAa,CAAC;AACrC,eAAO,MAAM,gBAAgB,iDAAkD,CAAC;AAChF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,wCAAyC,CAAC;AACjF,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,4BAA6B,CAAC;AAC/D,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,gEAM1B,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,aAAa,CAAC,GAAG,SAAS,MAAM,EAAE,CAE7F;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAE9D"}

package/dist/identity/identity-actions.js

@@ -1,14 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SERVICE_ACCOUNT_ACTIONS = exports.RECORD_SHARE_ACTIONS = exports.CROSS_TENANT_GRANT_ACTIONS = exports.IDENTITY_ACTIONS = exports.MODULE_KEY = void 0;
+exports.actionsOf = actionsOf;
 exports.actionsFor = actionsFor;
-/**
- * The fixed action vocabulary + module key for the framework's @astram/identity objects.
- * Engine ObjectTypes carry no action list, so actions are synthesized here — the ONE source
- * the module-registry bridge derives from. Permission keys are `identity:<typeKey>:<action>`.
- * (Ported from astram3. `cross_tenant_grant` gets its own override — see below — every other
- * type uses the CRUD verbs.)
- */
+const engine_1 = require("@astram/engine");
 exports.MODULE_KEY = 'identity';
 exports.IDENTITY_ACTIONS = ['read', 'create', 'update', 'delete'];
 /**
@@ -40,15 +35,19 @@ exports.SERVICE_ACCOUNT_ACTIONS = [
     'manage_keys',
 ];
 /**
- * Per-type action-vocabulary override. Every type not listed here defaults to
- * {@link IDENTITY_ACTIONS} (the CRUD verbs).
+ * The action vocabulary declared on a registration (ADR-0038): the CRUD verbs then the declared
+ * extras, or exactly the declared list when `crudActions === false`. Delegates to engine
+ * `effectiveActions`, so an invalid declaration throws the same `RegistrationError`.
+ */
+function actionsOf(reg) {
+    return (0, engine_1.effectiveActions)(reg);
+}
+/**
+ * @deprecated Use {@link actionsOf} with the type's registration. The vocabulary now lives on
+ * the object type (ADR-0038), so a typeKey alone cannot name it: this returns the CRUD verbs
+ * ({@link IDENTITY_ACTIONS}) for every type, including `cross_tenant_grant`, `record_share` and
+ * `service_account`. The framework no longer calls it.
  */
-const ACTIONS_BY_TYPE = {
-    cross_tenant_grant: exports.CROSS_TENANT_GRANT_ACTIONS,
-    record_share: exports.RECORD_SHARE_ACTIONS,
-    service_account: exports.SERVICE_ACCOUNT_ACTIONS,
-};
-/** The action vocabulary for `typeKey` — the per-type override if one exists, else the default. */
-function actionsFor(typeKey) {
-    return ACTIONS_BY_TYPE[typeKey] ?? exports.IDENTITY_ACTIONS;
+function actionsFor(_typeKey) {
+    return exports.IDENTITY_ACTIONS;
 }

package/dist/identity/module-registry.bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-registry.bridge.d.ts","sourceRoot":"","sources":["../../src/identity/module-registry.bridge.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAc,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQlE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,cAAc,CA4B9F"}
+{"version":3,"file":"module-registry.bridge.d.ts","sourceRoot":"","sources":["../../src/identity/module-registry.bridge.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAc,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQlE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,cAAc,CA4B9F"}

package/dist/identity/module-registry.bridge.js

@@ -4,8 +4,10 @@ exports.buildIdentityModuleRegistry = buildIdentityModuleRegistry;
 /**
  * Bridge: engine ObjectTypes → a populated core ModuleRegistry. Ported from astram3 (framework
  * now owns identity). Engine ObjectTypes describe physical tables; core's gates + the
- * permission-facts projection need object types + ACTIONS + tiers + planes. ObjectTypes carry no
- * action list, so we synthesize per-type actions (actionsFor). Every action is `gated` — nothing
+ * permission-facts projection need object types + ACTIONS + tiers + planes. Each type's actions
+ * are its declared vocabulary (`actionsOf` = engine `effectiveActions`, ADR-0038): CRUD plus
+ * extras, or exactly the declared list for `crudActions: false`; an invalid declaration throws
+ * `RegistrationError` here. Every action is `gated` with the type's `access.plane` — nothing
  * open unless reclassified. `register()` throws on duplicate typeKey/permissionKey.
  */
 const core_1 = require("@astram/core");
@@ -30,7 +32,7 @@ function buildIdentityModuleRegistry(inputs) {
             ...(Object.keys(access).length > 0 ? { access } : {}),
         };
     });
-    const actions = regs.flatMap((r) => (0, identity_actions_js_1.actionsFor)(r.typeKey).map((actionKey) => ({
+    const actions = regs.flatMap((r) => (0, identity_actions_js_1.actionsOf)(r).map((actionKey) => ({
         actionKey,
         typeKey: r.typeKey,
         tier: 'gated',

package/dist/index.d.ts

@@ -16,7 +16,7 @@
  */
 export { guardMigrationsDir } from './migrations-dir.js';
 export { buildIdentityModuleRegistry } from './identity/module-registry.bridge.js';
-export { MODULE_KEY, IDENTITY_ACTIONS, actionsFor } from './identity/identity-actions.js';
+export { MODULE_KEY, IDENTITY_ACTIONS, CROSS_TENANT_GRANT_ACTIONS, RECORD_SHARE_ACTIONS, SERVICE_ACCOUNT_ACTIONS, actionsFor, actionsOf, } from './identity/identity-actions.js';
 export { ShieldModule, SHIELD_DECISION_AUTHORITY, SHIELD_RECORD_AUTHORIZATION, type ShieldModuleOptions, type ShieldModuleAsyncOptions, type RecordAuthorizationInputs, } from './module/shield.module.js';
 export { Public, Classified, CLASSIFICATION_METADATA, DEFAULT_CLASSIFIED_ACTION, normalizeClassification, } from './enforcement/classification.decorator.js';
 export type { Classification } from './enforcement/classification.decorator.js';
@@ -35,6 +35,14 @@ export { stubDecisionAuthority, type Effect, type CoreDecisionAuthority, type Co
 export { Argon2idPasswordHasher, argon2idHasherProvider, SHIELD_PASSWORD_HASHER, type Argon2idParams, } from './authentication/argon2id-password-hasher.js';
 export { LocalKekCrypto } from './encryption/local-kek-crypto.js';
 export { EncryptedFileSecretsProvider } from './secrets/encrypted-file-secrets.js';
+export { resolveBootSecrets, createSecretsProviderFromEnv, assertNoUnresolvedSecretRefs, wasResolvedFromSecretRef, type ResolveBootSecretsOptions, } from './secrets/boot-secrets.js';
+export { S3ObjectStore, type S3ObjectStoreConfig, type S3ObjectStoreOptions, } from './storage/s3-object-store.js';
+export { NodeSha256Digest } from './storage/node-sha256-digest.js';
+export { ObjectStoreBootCheck } from './storage/object-store-boot-check.js';
+export { FileIntake, FILE_INTAKE_REQUEST_KEY, FILE_INTAKE_DEFAULT_MAX_BYTES, type FileIntakeOptions, type FileIntakeResult, } from './storage/file-intake.interceptor.js';
+export type { ShieldStorageOption } from './storage/storage.providers.js';
+export { SHIELD_OBJECT_STORE, SHIELD_FILE_INGEST } from './module/shield-tokens.js';
+export { loadObjectStorageConfig, DEFAULT_OBJECT_STORAGE_MAX_BYTES, type ObjectStorageConfig, type LoadObjectStorageConfigOptions, } from './config/app-config.js';
 export { MariaDbSessionRecordStore, SHIELD_SESSION_RECORD_STORE, RedisHotSessionStore, SHIELD_HOT_SESSION_STORE, RedisRecentRotationStore, type RedisRecentRotationStoreOptions, CryptoTokenGenerator, Sha256RefreshTokenHasher, SystemClock, cryptoTokenGeneratorProvider, refreshHasherProvider, systemClockProvider, SHIELD_TOKEN_GENERATOR, SHIELD_REFRESH_HASHER, SHIELD_CLOCK, HotRevokingSessionRecordStore, type SessionHotRevoker, type LineageSessionLookup, SHIELD_SESSION_LIFETIMES, ROTATE_GRACE_MS, accessBindingTtlMs, } from './session/index.js';
 export { MariaDbRecordPermissionRuleAdapter, SHIELD_RECORD_RULE_PORT, type RuleQueryable, } from './authz/mariadb-record-rule-adapter.js';
 export { MariaDbPolicyStore, SHIELD_POLICY_STORE, type RuleQueryable as PolicyStoreQueryable, } from './authz/mariadb-policy-store.js';
@@ -55,7 +63,8 @@ export { MariaDbSessionRestrictionStore, type SessionRestrictionStore, type Sess
 export { buildListScopeFn, type ListScopeFn } from './authz/wire-record-authorization.js';
 export { BootSequence, assertPoolBudget } from './boot/boot-sequence.js';
 export { APP_CONFIG } from './config/config.module.js';
-export { loadAppConfig, loadPoolBudget, evaluatePoolBudget, DEFAULT_POOL_BUDGET, SCHEMA_SVC_POOL_HARD_CAP, type AppConfig, type PoolBudgetConfig, type PoolBudgetEvaluation, type RuntimeAccountPools, loadDbConfig, loadRedisConfig, loadSessionLifetimes, loadRefreshHmacKey, assertRefreshHmacKey, DEFAULT_DB_CONFIG, DEFAULT_REDIS_URL, type DbConfig, type RedisConfig, type SessionLifetimeOverrides, loadLoginIpLimit, loadRefreshReplayWindowMs, DEFAULT_LOGIN_IP_LIMIT, isDevOrTestNodeEnv, type LoginIpLimitConfig, } from './config/app-config.js';
+export { loadAppConfig, loadPoolBudget, evaluatePoolBudget, DEFAULT_POOL_BUDGET, SCHEMA_SVC_POOL_HARD_CAP, type AppConfig, type PoolBudgetConfig, type PoolBudgetEvaluation, type RuntimeAccountPools, loadDbConfig, loadRedisConfig, loadSessionLifetimes, loadRefreshHmacKey, assertRefreshHmacKey, DEFAULT_DB_CONFIG, DEFAULT_REDIS_URL, type DbConfig, type RedisConfig, type SessionLifetimeOverrides, loadLoginIpLimit, loadRefreshReplayWindowMs, DEFAULT_LOGIN_IP_LIMIT, isDevOrTestNodeEnv, type LoginIpLimitConfig, loadDbTlsConfig, type DbTlsConfig, } from './config/app-config.js';
+export { mariadbSslOption } from './auth/connections.js';
 export { SHIELD_REDIS, SHIELD_CREDENTIAL_RESOLVER, SHIELD_PROFILE_RESOLVER, SHIELD_AUTHENTICATOR, SHIELD_SESSION_AUTHORITY, SHIELD_CREDENTIAL_WRITER, SHIELD_RESET_TOKEN_STORE, SHIELD_EMAIL_CHANGE_TOKEN_STORE, SHIELD_EMAIL_SENDER, SHIELD_RECOVERY_CODE_STORE, SHIELD_PROFILE_WRITER, SHIELD_SESSION_SWEEPER, SHIELD_AUDIT_SINK, SHIELD_MFA_DEVICE_STORE, SHIELD_TOTP_VERIFIER_OVERRIDE, } from './auth/tokens.js';
 export { MariaDbCredentialResolver } from './authentication/mariadb-credential-resolver.js';
 export type { SessionView, SessionTokensView, SessionSuccess, LoginRequest, MfaChallengeResponse, LoginResponse, MfaRequest, MfaResponse, RefreshRequest, RefreshResponse, LogoutRequest, LogoutAck, } from './auth/dto.js';