@venizia/ignis 0.2.0-4 → 0.2.0-41

package/dist/components/auth/authorize/role-managers/membership.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MembershipRoleManager = void 0;
+const base_1 = require("./base");
+/** `g2` axis (`g2(r.sub, r.dom)`): membership holds when the user joined the request domain or any
+ * ancestor of it, walking the shared per-request domain-hierarchy overlay. Memberships are
+ * per-principal and rebuilt every request, so `clear()` wipes all. */
+class MembershipRoleManager extends base_1.BaseRoleManager {
+    constructor(opts) {
+        super({ scope: MembershipRoleManager.name });
+        this.memberships = new Map();
+        this.overlay = opts.overlay;
+    }
+    async clear() {
+        this.memberships = new Map();
+        this.graphReported = false;
+    }
+    async addLink(user, domain) {
+        const existing = this.memberships.get(user);
+        if (existing) {
+            existing.add(domain);
+        }
+        else {
+            this.memberships.set(user, new Set([domain]));
+        }
+    }
+    async deleteLink(user, domain) {
+        this.memberships.get(user)?.delete(domain);
+    }
+    /** True when `name1` (user) joined `name2` (request domain) itself, or any ancestor of it. Walks UP from the request domain only - walking down from every joined domain would fan out over the whole subtree. */
+    syncedHasLink(name1, name2) {
+        this.reportGraphOnce(() => {
+            const { nodeCount, edgeCount } = MembershipRoleManager.overlayStats(this.overlay);
+            return {
+                message: 'membership role manager initialized | nodes: %d | edges: %d',
+                args: [nodeCount, edgeCount],
+            };
+        });
+        const joined = this.memberships.get(name1);
+        if (!joined || joined.size === 0) {
+            return false;
+        }
+        const ancestors = MembershipRoleManager.collectAncestors({
+            overlay: this.overlay,
+            node: name2,
+        });
+        for (const ancestor of ancestors) {
+            if (joined.has(ancestor)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /** Local membership state only, not the shared graph - correct for hasLink, incomplete for casbin's management API. */
+    async getRoles(name) {
+        return [...(this.memberships.get(name) ?? [])];
+    }
+    async getUsers(name) {
+        const users = [];
+        for (const [user, domains] of this.memberships) {
+            if (domains.has(name)) {
+                users.push(user);
+            }
+        }
+        return users;
+    }
+}
+exports.MembershipRoleManager = MembershipRoleManager;
+//# sourceMappingURL=membership.js.map

package/dist/components/auth/authorize/role-managers/membership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"membership.js","sourceRoot":"","sources":["../../../../../src/components/auth/authorize/role-managers/membership.ts"],"names":[],"mappings":";;;AACA,iCAAyC;AAEzC;;sEAEsE;AACtE,MAAa,qBAAsB,SAAQ,sBAAe;IAUxD,YAAY,IAA4C;QACtD,KAAK,CAAC,EAAE,KAAK,EAAE,qBAAqB,CAAC,IAAI,EAAE,CAAC,CAAC;QANvC,gBAAW,GAAG,IAAI,GAAG,EAG1B,CAAC;QAIF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,EAAuB,CAAC;QAClD,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,MAAc;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,CAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,MAAc;QAC3C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,kNAAkN;IAClN,aAAa,CAAC,KAAa,EAAE,KAAa;QACxC,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE;YACxB,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAClF,OAAO;gBACL,OAAO,EAAE,6DAA6D;gBACtE,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;aAC7B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,SAAS,GAAG,qBAAqB,CAAC,gBAAgB,CAAC;YACvD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzB,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uHAAuH;IACvH,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/C,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AA7ED,sDA6EC"}

package/dist/components/auth/authorize/{enforcers/resource-role-manager.d.ts → role-managers/resource.d.ts}

@@ -1,22 +1,16 @@
-import { BaseHelper } from '@venizia/ignis-helpers/core';
 import type { RoleManager } from 'casbin';
+import { BaseRoleManager } from './base';
 /** Resource-axis (`g4`) role manager: `addMatchingFunc` would set `hasPattern` and disable DefaultRoleManager's O(1) fast path, so prefix ancestors are walked manually; `addLink` must stay idempotent because `buildRoleLinks` re-adds every edge once per request. */
-export declare class ResourceRoleManager extends BaseHelper implements RoleManager {
+export declare class ResourceRoleManager extends BaseRoleManager implements RoleManager {
     private parents;
-    private graphReported;
     constructor();
     clear(): Promise<void>;
     addLink(child: string, parent: string): Promise<void>;
     deleteLink(child: string, parent: string): Promise<void>;
     syncedHasLink(name1: string, name2: string): boolean;
-    hasLink(name1: string, name2: string): Promise<boolean>;
     getRoles(name: string): Promise<string[]>;
     getUsers(name: string): Promise<string[]>;
-    /** casbin calls this after buildRoleLinks purely as a debug hook; the resource graph is not logged. */
-    printRoles(): Promise<void>;
-    getDomains(): Promise<string[]>;
-    getAllDomains(): Promise<string[]>;
     /** All stored prefix ancestors of a dotted code (`a.b.c` -> `a.b` -> `a`), not only the deepest, plus a literal stored `'*'` node - `objectMatch(anything, '*')` is always true, so a `g4` edge whose child is `'*'` must stay reachable from every request object. */
     private collectStoredAncestors;
 }
-//# sourceMappingURL=resource-role-manager.d.ts.map
+//# sourceMappingURL=resource.d.ts.map

package/dist/components/auth/authorize/role-managers/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../../../../src/components/auth/authorize/role-managers/resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEzC,yQAAyQ;AACzQ,qBAAa,mBAAoB,SAAQ,eAAgB,YAAW,WAAW;IAC7E,OAAO,CAAC,OAAO,CAGX;;IAME,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcrD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IA8C9C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIzC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAY/C,uQAAuQ;IACvQ,OAAO,CAAC,sBAAsB;CA0B/B"}

package/dist/components/auth/authorize/{enforcers/resource-role-manager.js → role-managers/resource.js}

@@ -1,13 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ResourceRoleManager = void 0;
-const core_1 = require("@venizia/ignis-helpers/core");
+const base_1 = require("./base");
 /** Resource-axis (`g4`) role manager: `addMatchingFunc` would set `hasPattern` and disable DefaultRoleManager's O(1) fast path, so prefix ancestors are walked manually; `addLink` must stay idempotent because `buildRoleLinks` re-adds every edge once per request. */
-class ResourceRoleManager extends core_1.BaseHelper {
+class ResourceRoleManager extends base_1.BaseRoleManager {
     constructor() {
         super({ scope: ResourceRoleManager.name });
         this.parents = new Map();
-        this.graphReported = false;
     }
     async clear() {
         this.parents = new Map();
@@ -29,14 +28,14 @@ class ResourceRoleManager extends core_1.BaseHelper {
         this.parents.get(child)?.delete(parent);
     }
     syncedHasLink(name1, name2) {
-        if (!this.graphReported) {
-            this.graphReported = true;
+        this.reportGraphOnce(() => {
             const nodeCount = this.parents.size;
             const edgeCount = Array.from(this.parents.values()).reduce((sum, set) => sum + set.size, 0);
-            this.logger
-                .for(this.syncedHasLink.name)
-                .debug('resource-role initialized | nodes: %d | edges: %d', nodeCount, edgeCount);
-        }
+            return {
+                message: 'resource-role initialized | nodes: %d | edges: %d',
+                args: [nodeCount, edgeCount],
+            };
+        });
         if (name1 === name2) {
             return true;
         }
@@ -65,9 +64,6 @@ class ResourceRoleManager extends core_1.BaseHelper {
         }
         return false;
     }
-    async hasLink(name1, name2) {
-        return this.syncedHasLink(name1, name2);
-    }
     async getRoles(name) {
         return [...(this.parents.get(name) ?? [])];
     }
@@ -80,14 +76,6 @@ class ResourceRoleManager extends core_1.BaseHelper {
         }
         return users;
     }
-    /** casbin calls this after buildRoleLinks purely as a debug hook; the resource graph is not logged. */
-    async printRoles() { }
-    async getDomains() {
-        return [];
-    }
-    async getAllDomains() {
-        return [];
-    }
     /** All stored prefix ancestors of a dotted code (`a.b.c` -> `a.b` -> `a`), not only the deepest, plus a literal stored `'*'` node - `objectMatch(anything, '*')` is always true, so a `g4` edge whose child is `'*'` must stay reachable from every request object. */
     collectStoredAncestors(opts) {
         const ancestors = [];
@@ -112,4 +100,4 @@ class ResourceRoleManager extends core_1.BaseHelper {
     }
 }
 exports.ResourceRoleManager = ResourceRoleManager;
-//# sourceMappingURL=resource-role-manager.js.map
+//# sourceMappingURL=resource.js.map

package/dist/components/auth/authorize/role-managers/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../../../../src/components/auth/authorize/role-managers/resource.ts"],"names":[],"mappings":"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"}

package/dist/components/auth/models/entities/policy-definition.model.d.ts

@@ -1,25 +1,60 @@
-import { integer, jsonb, text } from 'drizzle-orm/pg-core';
-export type TPolicyDefinitionOptions = {
+import type { TAuthorizationDecision, TSubsetGrantMetadata } from '@venizia/ignis-kernel';
+import { integer, text } from 'drizzle-orm/pg-core';
+export type TPolicyDefinitionOptions<ExtraVariant extends string = never> = {
     idType?: 'string' | 'number';
+    /**
+     * App-only edge kinds stored in this same table alongside IGNIS's seven (e.g. `merchant_role`).
+     * `ScopedCasbinAdapter` never selects an undeclared variant - it is purely the consumer's data.
+     * Pass as an inline array literal; the `const` type parameter below infers the literal union
+     * from it without needing `as const`.
+     */
+    extraVariants?: ReadonlyArray<ExtraVariant>;
 };
-export type TPolicyDefinitionCommonColumns = {
-    variant: ReturnType<typeof text>;
-    subjectType: ReturnType<typeof text>;
-    targetType: ReturnType<typeof text>;
-    action: ReturnType<typeof text>;
-    effect: ReturnType<typeof text>;
-    domain: ReturnType<typeof text>;
-    metadata: ReturnType<typeof jsonb>;
+/** Extracts the app-declared extra variants from `Opts`, or `never` when none were declared. */
+type TExtraPolicyVariantOf<Opts> = Opts extends {
+    extraVariants?: ReadonlyArray<infer ExtraVariant extends string>;
+} ? ExtraVariant : never;
+/** Column shape is inferred, never hand-declared, so it can never drift from the `$type<>()` narrowing below. */
+declare const buildCommonPolicyDefinitionColumns: <ExtraVariant extends string = never, Metadata extends object = TSubsetGrantMetadata>() => {
+    metadata: import("drizzle-orm").$Type<import("drizzle-orm/pg-core").PgJsonbBuilderInitial<"metadata">, Metadata>;
+    variant: import("drizzle-orm").NotNull<import("drizzle-orm").$Type<import("drizzle-orm/pg-core").PgTextBuilderInitial<"variant", [string, ...string[]]>, "join_domain" | "assign_role" | "grant" | "role_inherits" | "domain_inherits" | "resource_inherits" | "action_inherits" | ExtraVariant>>;
+    subjectType: import("drizzle-orm").NotNull<import("drizzle-orm/pg-core").PgTextBuilderInitial<"subject_type", [string, ...string[]]>>;
+    targetType: import("drizzle-orm").NotNull<import("drizzle-orm/pg-core").PgTextBuilderInitial<"target_type", [string, ...string[]]>>;
+    domainType: import("drizzle-orm/pg-core").PgTextBuilderInitial<"domain_type", [string, ...string[]]>;
+    action: import("drizzle-orm/pg-core").PgTextBuilderInitial<"action", [string, ...string[]]>;
+    effect: import("drizzle-orm").$Type<import("drizzle-orm/pg-core").PgTextBuilderInitial<"effect", [string, ...string[]]>, TAuthorizationDecision>;
 };
-type TPolicyDefinitionColumnDef<Opts extends TPolicyDefinitionOptions | undefined = undefined> = Opts extends {
+export type TPolicyDefinitionCommonColumns<ExtraVariant extends string = never, Metadata extends object = TSubsetGrantMetadata> = ReturnType<typeof buildCommonPolicyDefinitionColumns<ExtraVariant, Metadata>>;
+type TPolicyDefinitionColumnDef<Opts extends TPolicyDefinitionOptions<string> | undefined = undefined, Metadata extends object = TSubsetGrantMetadata> = Opts extends {
     idType: 'string';
-} ? TPolicyDefinitionCommonColumns & {
+} ? TPolicyDefinitionCommonColumns<TExtraPolicyVariantOf<Opts>, Metadata> & {
     subjectId: ReturnType<typeof text>;
     targetId: ReturnType<typeof text>;
-} : TPolicyDefinitionCommonColumns & {
+    domainId: ReturnType<typeof text>;
+} : TPolicyDefinitionCommonColumns<TExtraPolicyVariantOf<Opts>, Metadata> & {
     subjectId: ReturnType<typeof integer>;
     targetId: ReturnType<typeof integer>;
+    domainId: ReturnType<typeof integer>;
 };
-export declare const extraPolicyDefinitionColumns: <Opts extends TPolicyDefinitionOptions | undefined>(opts?: Opts) => TPolicyDefinitionColumnDef<Opts>;
+/**
+ * `Metadata` is a type parameter, not an `opts` field: unlike `extraVariants` there is no runtime
+ * value to infer from, so supplying it means spelling `Opts` too (no partial inference):
+ * `extraPolicyDefinitionColumns<{ idType: 'string' }, IMyMetadata>({ idType: 'string' })`.
+ * Keep `ops` in a custom shape if the app also issues subset grants - `customGrant` writes it.
+ */
+export declare const extraPolicyDefinitionColumns: <const Opts extends TPolicyDefinitionOptions<string> | undefined = undefined, Metadata extends object = TSubsetGrantMetadata>(opts?: Opts) => TPolicyDefinitionColumnDef<Opts, Metadata>;
+/**
+ * The three legal `(domain_type, domain_id)` pairs, as CHECK predicate TEXT for a migration - text,
+ * not a Drizzle `SQL`, because a column ref in a `sql` template renders schema-qualified, which a
+ * table-level CHECK rejects.
+ *
+ * The `IS NOT NULL` guard on the last branch looks redundant next to `NOT IN` and is not: a NULL
+ * `domain_type` makes `NOT IN` evaluate to NULL, and a CHECK rejects only on FALSE - without it an id
+ * with no type passes.
+ */
+export declare const policyDefinitionDomainShapeCheck: (opts?: {
+    domainTypeColumn?: string;
+    domainIdColumn?: string;
+}) => string;
 export {};
 //# sourceMappingURL=policy-definition.model.d.ts.map

package/dist/components/auth/models/entities/policy-definition.model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy-definition.model.d.ts","sourceRoot":"","sources":["../../../../../src/components/auth/models/entities/policy-definition.model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;IACjC,WAAW,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;IACrC,UAAU,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;IACpC,MAAM,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;IAChC,MAAM,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;IAChC,MAAM,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;IAChC,QAAQ,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;CACpC,CAAC;AAEF,KAAK,0BAA0B,CAAC,IAAI,SAAS,wBAAwB,GAAG,SAAS,GAAG,SAAS,IAC3F,IAAI,SAAS;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GAC7B,8BAA8B,GAAG;IAC/B,SAAS,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;IACnC,QAAQ,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;CACnC,GACD,8BAA8B,GAAG;IAC/B,SAAS,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;IACtC,QAAQ,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;CACtC,CAAC;AAER,eAAO,MAAM,4BAA4B,GAAI,IAAI,SAAS,wBAAwB,GAAG,SAAS,EAC5F,OAAO,IAAI,KACV,0BAA0B,CAAC,IAAI,CAoCjC,CAAC"}
+{"version":3,"file":"policy-definition.model.d.ts","sourceRoot":"","sources":["../../../../../src/components/auth/models/entities/policy-definition.model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EAEtB,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,OAAO,EAAS,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,MAAM,wBAAwB,CAAC,YAAY,SAAS,MAAM,GAAG,KAAK,IAAI;IAC1E,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC7B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;CAC7C,CAAC;AAEF,gGAAgG;AAChG,KAAK,qBAAqB,CAAC,IAAI,IAAI,IAAI,SAAS;IAC9C,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,YAAY,SAAS,MAAM,CAAC,CAAC;CAClE,GACG,YAAY,GACZ,KAAK,CAAC;AAEV,iHAAiH;AACjH,QAAA,MAAM,kCAAkC,GACtC,YAAY,SAAS,MAAM,GAAG,KAAK,EACnC,QAAQ,SAAS,MAAM,GAAG,oBAAoB;;;;;;;;CAa9C,CAAC;AAEH,MAAM,MAAM,8BAA8B,CACxC,YAAY,SAAS,MAAM,GAAG,KAAK,EACnC,QAAQ,SAAS,MAAM,GAAG,oBAAoB,IAC5C,UAAU,CAAC,OAAO,kCAAkC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;AAElF,KAAK,0BAA0B,CAC7B,IAAI,SAAS,wBAAwB,CAAC,MAAM,CAAC,GAAG,SAAS,GAAG,SAAS,EACrE,QAAQ,SAAS,MAAM,GAAG,oBAAoB,IAC5C,IAAI,SAAS;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACjC,8BAA8B,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,GAAG;IACtE,SAAS,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;IACnC,QAAQ,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;IAClC,QAAQ,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;CACnC,GACD,8BAA8B,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,GAAG;IACtE,SAAS,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;IACtC,QAAQ,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;IACrC,QAAQ,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;CACtC,CAAC;AAEN;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GACvC,KAAK,CAAC,IAAI,SAAS,wBAAwB,CAAC,MAAM,CAAC,GAAG,SAAS,GAAG,SAAS,EAC3E,QAAQ,SAAS,MAAM,GAAG,oBAAoB,EAE9C,OAAO,IAAI,KACV,0BAA0B,CAAC,IAAI,EAAE,QAAQ,CA4B3C,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,gCAAgC,GAAI,OAAO;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,KAAG,MAaH,CAAC"}

package/dist/components/auth/models/entities/policy-definition.model.js

@@ -1,26 +1,36 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.extraPolicyDefinitionColumns = void 0;
+exports.policyDefinitionDomainShapeCheck = exports.extraPolicyDefinitionColumns = void 0;
 const core_1 = require("@venizia/ignis-helpers/core");
+const ignis_kernel_1 = require("@venizia/ignis-kernel");
 const pg_core_1 = require("drizzle-orm/pg-core");
+/** Column shape is inferred, never hand-declared, so it can never drift from the `$type<>()` narrowing below. */
+const buildCommonPolicyDefinitionColumns = () => ({
+    metadata: (0, pg_core_1.jsonb)('metadata').$type(),
+    variant: (0, pg_core_1.text)('variant').$type().notNull(),
+    subjectType: (0, pg_core_1.text)('subject_type').notNull(),
+    targetType: (0, pg_core_1.text)('target_type').notNull(),
+    // `null` IS `ANY_MEMBER`, not "unknown"; the literal is refused by `policyDefinitionDomainShapeCheck`.
+    domainType: (0, pg_core_1.text)('domain_type'),
+    action: (0, pg_core_1.text)('action'),
+    effect: (0, pg_core_1.text)('effect').$type(),
+});
+/**
+ * `Metadata` is a type parameter, not an `opts` field: unlike `extraVariants` there is no runtime
+ * value to infer from, so supplying it means spelling `Opts` too (no partial inference):
+ * `extraPolicyDefinitionColumns<{ idType: 'string' }, IMyMetadata>({ idType: 'string' })`.
+ * Keep `ops` in a custom shape if the app also issues subset grants - `customGrant` writes it.
+ */
 const extraPolicyDefinitionColumns = (opts) => {
     const { idType = 'number' } = opts ?? {};
-    const common = {
-        variant: (0, pg_core_1.text)('variant').notNull(),
-        subjectType: (0, pg_core_1.text)('subject_type').notNull(),
-        targetType: (0, pg_core_1.text)('target_type').notNull(),
-        action: (0, pg_core_1.text)('action'),
-        effect: (0, pg_core_1.text)('effect'),
-        domain: (0, pg_core_1.text)('domain'),
-        // Nullable: only subset grants populate it, and a consumer may map its own column instead.
-        metadata: (0, pg_core_1.jsonb)('metadata'),
-    };
+    const common = buildCommonPolicyDefinitionColumns();
     switch (idType) {
         case 'number': {
             return {
                 ...common,
                 subjectId: (0, pg_core_1.integer)('subject_id').notNull(),
                 targetId: (0, pg_core_1.integer)('target_id').notNull(),
+                domainId: (0, pg_core_1.integer)('domain_id'),
             };
         }
         case 'string': {
@@ -28,6 +38,7 @@ const extraPolicyDefinitionColumns = (opts) => {
                 ...common,
                 subjectId: (0, pg_core_1.text)('subject_id').notNull(),
                 targetId: (0, pg_core_1.text)('target_id').notNull(),
+                domainId: (0, pg_core_1.text)('domain_id'),
             };
         }
         default: {
@@ -38,4 +49,27 @@ const extraPolicyDefinitionColumns = (opts) => {
     }
 };
 exports.extraPolicyDefinitionColumns = extraPolicyDefinitionColumns;
+/**
+ * The three legal `(domain_type, domain_id)` pairs, as CHECK predicate TEXT for a migration - text,
+ * not a Drizzle `SQL`, because a column ref in a `sql` template renders schema-qualified, which a
+ * table-level CHECK rejects.
+ *
+ * The `IS NOT NULL` guard on the last branch looks redundant next to `NOT IN` and is not: a NULL
+ * `domain_type` makes `NOT IN` evaluate to NULL, and a CHECK rejects only on FALSE - without it an id
+ * with no type passes.
+ */
+const policyDefinitionDomainShapeCheck = (opts) => {
+    const { domainTypeColumn = 'domain_type', domainIdColumn = 'domain_id' } = opts ?? {};
+    const { ANY_MEMBER, SYSTEM_WIDE } = ignis_kernel_1.AuthorizationDomainScopes;
+    return [
+        `(${domainTypeColumn} IS NULL AND ${domainIdColumn} IS NULL)`,
+        `OR (${domainTypeColumn} = '${SYSTEM_WIDE}' AND ${domainIdColumn} IS NULL)`,
+        `OR (
+      ${domainTypeColumn} IS NOT NULL
+      AND ${domainTypeColumn} NOT IN ('${ANY_MEMBER}', '${SYSTEM_WIDE}')
+      AND ${domainIdColumn} IS NOT NULL
+    )`,
+    ].join('\n');
+};
+exports.policyDefinitionDomainShapeCheck = policyDefinitionDomainShapeCheck;
 //# sourceMappingURL=policy-definition.model.js.map

package/dist/components/auth/models/entities/policy-definition.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"policy-definition.model.js","sourceRoot":"","sources":["../../../../../src/components/auth/models/entities/policy-definition.model.ts"],"names":[],"mappings":";;;AAAA,sDAAuD;AACvD,iDAA2D;AA2BpD,MAAM,4BAA4B,GAAG,CAC1C,IAAW,EACuB,EAAE;IACpC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IAEzC,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,IAAA,cAAI,EAAC,SAAS,CAAC,CAAC,OAAO,EAAE;QAClC,WAAW,EAAE,IAAA,cAAI,EAAC,cAAc,CAAC,CAAC,OAAO,EAAE;QAC3C,UAAU,EAAE,IAAA,cAAI,EAAC,aAAa,CAAC,CAAC,OAAO,EAAE;QACzC,MAAM,EAAE,IAAA,cAAI,EAAC,QAAQ,CAAC;QACtB,MAAM,EAAE,IAAA,cAAI,EAAC,QAAQ,CAAC;QACtB,MAAM,EAAE,IAAA,cAAI,EAAC,QAAQ,CAAC;QAEtB,2FAA2F;QAC3F,QAAQ,EAAE,IAAA,eAAK,EAAC,UAAU,CAAC;KAC5B,CAAC;IAEF,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,OAAO;gBACL,GAAG,MAAM;gBACT,SAAS,EAAE,IAAA,iBAAO,EAAC,YAAY,CAAC,CAAC,OAAO,EAAE;gBAC1C,QAAQ,EAAE,IAAA,iBAAO,EAAC,WAAW,CAAC,CAAC,OAAO,EAAE;aACL,CAAC;QACxC,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,OAAO;gBACL,GAAG,MAAM;gBACT,SAAS,EAAE,IAAA,cAAI,EAAC,YAAY,CAAC,CAAC,OAAO,EAAE;gBACvC,QAAQ,EAAE,IAAA,cAAI,EAAC,WAAW,CAAC,CAAC,OAAO,EAAE;aACF,CAAC;QACxC,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,2DAA2D,MAAM,EAAE;aAC7E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAtCW,QAAA,4BAA4B,gCAsCvC"}
+{"version":3,"file":"policy-definition.model.js","sourceRoot":"","sources":["../../../../../src/components/auth/models/entities/policy-definition.model.ts"],"names":[],"mappings":";;;AAAA,sDAAuD;AAMvD,wDAAkE;AAClE,iDAA2D;AAoB3D,iHAAiH;AACjH,MAAM,kCAAkC,GAAG,GAGvC,EAAE,CAAC,CAAC;IACN,QAAQ,EAAE,IAAA,eAAK,EAAC,UAAU,CAAC,CAAC,KAAK,EAAY;IAC7C,OAAO,EAAE,IAAA,cAAI,EAAC,SAAS,CAAC,CAAC,KAAK,EAA8C,CAAC,OAAO,EAAE;IAEtF,WAAW,EAAE,IAAA,cAAI,EAAC,cAAc,CAAC,CAAC,OAAO,EAAE;IAC3C,UAAU,EAAE,IAAA,cAAI,EAAC,aAAa,CAAC,CAAC,OAAO,EAAE;IAEzC,uGAAuG;IACvG,UAAU,EAAE,IAAA,cAAI,EAAC,aAAa,CAAC;IAE/B,MAAM,EAAE,IAAA,cAAI,EAAC,QAAQ,CAAC;IACtB,MAAM,EAAE,IAAA,cAAI,EAAC,QAAQ,CAAC,CAAC,KAAK,EAA0B;CACvD,CAAC,CAAC;AAsBH;;;;;GAKG;AACI,MAAM,4BAA4B,GAAG,CAI1C,IAAW,EACiC,EAAE;IAC9C,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IAEzC,MAAM,MAAM,GAAG,kCAAkC,EAAyC,CAAC;IAE3F,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,OAAO;gBACL,GAAG,MAAM;gBACT,SAAS,EAAE,IAAA,iBAAO,EAAC,YAAY,CAAC,CAAC,OAAO,EAAE;gBAC1C,QAAQ,EAAE,IAAA,iBAAO,EAAC,WAAW,CAAC,CAAC,OAAO,EAAE;gBACxC,QAAQ,EAAE,IAAA,iBAAO,EAAC,WAAW,CAAC;aACe,CAAC;QAClD,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,OAAO;gBACL,GAAG,MAAM;gBACT,SAAS,EAAE,IAAA,cAAI,EAAC,YAAY,CAAC,CAAC,OAAO,EAAE;gBACvC,QAAQ,EAAE,IAAA,cAAI,EAAC,WAAW,CAAC,CAAC,OAAO,EAAE;gBACrC,QAAQ,EAAE,IAAA,cAAI,EAAC,WAAW,CAAC;aACkB,CAAC;QAClD,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,2DAA2D,MAAM,EAAE;aAC7E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAjCW,QAAA,4BAA4B,gCAiCvC;AAEF;;;;;;;;GAQG;AACI,MAAM,gCAAgC,GAAG,CAAC,IAGhD,EAAU,EAAE;IACX,MAAM,EAAE,gBAAgB,GAAG,aAAa,EAAE,cAAc,GAAG,WAAW,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IACtF,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,wCAAyB,CAAC;IAE9D,OAAO;QACL,IAAI,gBAAgB,gBAAgB,cAAc,WAAW;QAC7D,OAAO,gBAAgB,OAAO,WAAW,SAAS,cAAc,WAAW;QAC3E;QACI,gBAAgB;YACZ,gBAAgB,aAAa,UAAU,OAAO,WAAW;YACzD,cAAc;MACpB;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC,CAAC;AAhBW,QAAA,gCAAgC,oCAgB3C"}

package/dist/components/auth/models/entities/user.model.d.ts

@@ -10,7 +10,7 @@ export declare const extraUserColumns: (opts?: {
         name: string;
         dataType: "custom";
         columnType: "PgCustomColumn";
-        data: string;
+        data: string | import("@venizia/ignis-kernel").TIsoTimestamp;
         driverParam: string;
         enumValues: undefined;
     }>;
@@ -18,7 +18,7 @@ export declare const extraUserColumns: (opts?: {
         name: string;
         dataType: "custom";
         columnType: "PgCustomColumn";
-        data: string;
+        data: string | import("@venizia/ignis-kernel").TIsoTimestamp;
         driverParam: string;
         enumValues: undefined;
     }>;

package/dist/components/health-check/common/constants.d.ts

@@ -0,0 +1,5 @@
+export declare class HealthCheckHeaders {
+    /** Where a gated stats request carries its key; lowercase because Hono normalises header names. */
+    static readonly SECRET_KEY = "x-health-key";
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/components/health-check/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/components/health-check/common/constants.ts"],"names":[],"mappings":"AAAA,qBAAa,kBAAkB;IAC7B,mGAAmG;IACnG,MAAM,CAAC,QAAQ,CAAC,UAAU,kBAAkB;CAC7C"}

package/dist/components/health-check/common/constants.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthCheckHeaders = void 0;
+class HealthCheckHeaders {
+    /** Where a gated stats request carries its key; lowercase because Hono normalises header names. */
+    static { this.SECRET_KEY = 'x-health-key'; }
+}
+exports.HealthCheckHeaders = HealthCheckHeaders;
+//# sourceMappingURL=constants.js.map

package/dist/components/health-check/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/components/health-check/common/constants.ts"],"names":[],"mappings":";;;AAAA,MAAa,kBAAkB;IAC7B,mGAAmG;aACnF,eAAU,GAAG,cAAc,CAAC;;AAF9C,gDAGC"}

package/dist/components/health-check/common/index.d.ts

@@ -1,3 +1,4 @@
+export * from './constants';
 export * from './keys';
 export * from './rest-paths';
 export * from './types';

package/dist/components/health-check/common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/health-check/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/health-check/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}

package/dist/components/health-check/common/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./constants"), exports);
 __exportStar(require("./keys"), exports);
 __exportStar(require("./rest-paths"), exports);
 __exportStar(require("./types"), exports);

package/dist/components/health-check/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/health-check/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,+CAA6B;AAC7B,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/health-check/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,yCAAuB;AACvB,+CAA6B;AAC7B,0CAAwB"}

package/dist/components/health-check/common/keys.d.ts

@@ -1,4 +1,6 @@
 export declare class HealthCheckBindingKeys {
     static readonly HEALTH_CHECK_OPTIONS = "@app/health-check/options";
+    /** The component resolves `getAppInfo()` once (it is async) and binds the result for the controller. */
+    static readonly APPLICATION_INFO = "@app/health-check/application-info";
 }
 //# sourceMappingURL=keys.d.ts.map

package/dist/components/health-check/common/keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../../src/components/health-check/common/keys.ts"],"names":[],"mappings":"AAAA,qBAAa,sBAAsB;IACjC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,+BAA+B;CACpE"}
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../../src/components/health-check/common/keys.ts"],"names":[],"mappings":"AAAA,qBAAa,sBAAsB;IACjC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,+BAA+B;IACnE,wGAAwG;IACxG,MAAM,CAAC,QAAQ,CAAC,gBAAgB,wCAAwC;CACzE"}

package/dist/components/health-check/common/keys.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HealthCheckBindingKeys = void 0;
 class HealthCheckBindingKeys {
     static { this.HEALTH_CHECK_OPTIONS = '@app/health-check/options'; }
+    /** The component resolves `getAppInfo()` once (it is async) and binds the result for the controller. */
+    static { this.APPLICATION_INFO = '@app/health-check/application-info'; }
 }
 exports.HealthCheckBindingKeys = HealthCheckBindingKeys;
 //# sourceMappingURL=keys.js.map

package/dist/components/health-check/common/keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../../src/components/health-check/common/keys.ts"],"names":[],"mappings":";;;AAAA,MAAa,sBAAsB;aACjB,yBAAoB,GAAG,2BAA2B,CAAC;;AADrE,wDAEC"}
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../../src/components/health-check/common/keys.ts"],"names":[],"mappings":";;;AAAA,MAAa,sBAAsB;aACjB,yBAAoB,GAAG,2BAA2B,CAAC;IACnE,wGAAwG;aACxF,qBAAgB,GAAG,oCAAoC,CAAC;;AAH1E,wDAIC"}

package/dist/components/health-check/common/rest-paths.d.ts

@@ -1,5 +1,6 @@
 export declare class HealthCheckRestPaths {
     static readonly ROOT = "/";
     static readonly PING = "/ping";
+    static readonly STATS = "/stats";
 }
 //# sourceMappingURL=rest-paths.d.ts.map

package/dist/components/health-check/common/rest-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rest-paths.d.ts","sourceRoot":"","sources":["../../../../src/components/health-check/common/rest-paths.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,QAAQ,CAAC,IAAI,OAAO;IAC3B,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW;CAChC"}
+{"version":3,"file":"rest-paths.d.ts","sourceRoot":"","sources":["../../../../src/components/health-check/common/rest-paths.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,QAAQ,CAAC,IAAI,OAAO;IAC3B,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW;IAC/B,MAAM,CAAC,QAAQ,CAAC,KAAK,YAAY;CAClC"}

package/dist/components/health-check/common/rest-paths.js

@@ -4,6 +4,7 @@ exports.HealthCheckRestPaths = void 0;
 class HealthCheckRestPaths {
     static { this.ROOT = '/'; }
     static { this.PING = '/ping'; }
+    static { this.STATS = '/stats'; }
 }
 exports.HealthCheckRestPaths = HealthCheckRestPaths;
 //# sourceMappingURL=rest-paths.js.map

package/dist/components/health-check/common/rest-paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"rest-paths.js","sourceRoot":"","sources":["../../../../src/components/health-check/common/rest-paths.ts"],"names":[],"mappings":";;;AAAA,MAAa,oBAAoB;aACf,SAAI,GAAG,GAAG,CAAC;aACX,SAAI,GAAG,OAAO,CAAC;;AAFjC,oDAGC"}
+{"version":3,"file":"rest-paths.js","sourceRoot":"","sources":["../../../../src/components/health-check/common/rest-paths.ts"],"names":[],"mappings":";;;AAAA,MAAa,oBAAoB;aACf,SAAI,GAAG,GAAG,CAAC;aACX,SAAI,GAAG,OAAO,CAAC;aACf,UAAK,GAAG,QAAQ,CAAC;;AAHnC,oDAIC"}

package/dist/components/health-check/common/types.d.ts

@@ -1,7 +1,29 @@
+import type { IBuildInfo } from '@venizia/ignis-helpers/core';
 export interface IHealthCheckOptions {
     /** Partially-filled bindings are accepted; every missing field falls back to its default. */
     restOptions?: {
         path?: string;
     };
+    /**
+     * `GET <path>/stats`: build stamp, process and memory. The runtime and version it reports are
+     * exactly what an attacker needs to pick an exploit, so the default is CLOSED on every host that
+     * is not provably a development one.
+     */
+    stats?: {
+        /**
+         * Default: open only when `NODE_ENV` names a development environment
+         * (`Environment.DEVELOPMENT_ENVS`). `staging`, `uat`, `production`, an unrecognised name and an
+         * unset `NODE_ENV` all keep the route closed.
+         */
+        enable?: boolean;
+        /**
+         * When set, the route answers only for a request carrying this value in `X-Health-Key`, and a
+         * refusal is indistinguishable from an unmounted route. A blank value fails closed.
+         * Without the field the route is open to anything that can reach the port.
+         */
+        secretKey?: string;
+        /** Wins over {@link BuildInfoRegistry}; a host that stamps its own build passes it here. */
+        buildInfo?: IBuildInfo;
+    };
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/components/health-check/common/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/health-check/common/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,6FAA6F;IAC7F,WAAW,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/health-check/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,6FAA6F;IAC7F,WAAW,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC;;;;OAIG;IACH,KAAK,CAAC,EAAE;QACN;;;;WAIG;QACH,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB;;;;WAIG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,4FAA4F;QAC5F,SAAS,CAAC,EAAE,UAAU,CAAC;KACxB,CAAC;CACH"}

package/dist/components/health-check/component.d.ts

@@ -1,9 +1,15 @@
 import { BaseApplication } from '../../base/applications';
 import { BaseComponent } from '@venizia/ignis-kernel';
-import { ValueOrPromise } from '@venizia/ignis-helpers/common';
-export declare class HealthCheckComponent extends BaseComponent {
+import { type IHealthCheckOptions } from './common';
+export declare class HealthCheckComponent extends BaseComponent<IHealthCheckOptions> {
     private application;
     constructor(application: BaseApplication);
-    binding(): ValueOrPromise<void>;
+    /**
+     * `application.component(HealthCheckComponent, { options })` lands here. Options given at the
+     * call site are the most explicit statement of intent, so they take the binding over anything
+     * bound earlier; `initDefaultBindings` then finds the key taken and leaves the default aside.
+     */
+    configure(opts?: IHealthCheckOptions): Promise<void>;
+    binding(): Promise<void>;
 }
 //# sourceMappingURL=component.d.ts.map

package/dist/components/health-check/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../src/components/health-check/component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAU/D,qBAAa,oBAAqB,SAAQ,aAAa;IAEC,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,eAAe;IAajF,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC;CAYzC"}
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../src/components/health-check/component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAY5E,qBAAa,oBAAqB,SAAQ,aAAa,CAAC,mBAAmB,CAAC;IAEpB,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,eAAe;IAa1F;;;;OAIG;IACY,SAAS,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBpD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAmCxC"}

package/dist/components/health-check/component.js

@@ -20,6 +20,8 @@ const metadata_1 = require("../../base/metadata");
 const ignis_kernel_2 = require("@venizia/ignis-kernel");
 const common_1 = require("./common");
 const controller_1 = require("./controller");
+const reporter_1 = require("./reporter");
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
 const ignis_kernel_3 = require("@venizia/ignis-kernel");
 const DEFAULT_REST_PATH = '/health';
 const DEFAULT_OPTIONS = {
@@ -38,13 +40,48 @@ let HealthCheckComponent = HealthCheckComponent_1 = class HealthCheckComponent e
         });
         this.application = application;
     }
-    binding() {
+    /**
+     * `application.component(HealthCheckComponent, { options })` lands here. Options given at the
+     * call site are the most explicit statement of intent, so they take the binding over anything
+     * bound earlier; `initDefaultBindings` then finds the key taken and leaves the default aside.
+     */
+    async configure(opts) {
+        // The base short-circuits a second call; binding before that check would swap the options
+        // under routes that were already mounted from the first ones.
+        if (this.isConfigured) {
+            return;
+        }
+        if (opts !== undefined) {
+            this.application
+                .bind({ key: common_1.HealthCheckBindingKeys.HEALTH_CHECK_OPTIONS })
+                .toValue(opts);
+        }
+        await super.configure(opts);
+    }
+    async binding() {
         const healthOptions = this.application.get({
             key: common_1.HealthCheckBindingKeys.HEALTH_CHECK_OPTIONS,
             isOptional: true,
         });
         // A partially filled options binding (env/config driven) must not take the app down at boot.
         const path = healthOptions?.restOptions?.path ?? DEFAULT_REST_PATH;
+        // Legal, occasionally correct, and silent until now: `stats.enable: true` bypasses the
+        // environment gate, so the same code that opened the route for a local run opens it in
+        // production. Warn rather than refuse - only the operator knows whether the port is reachable.
+        if (healthOptions && reporter_1.HealthCheckReporter.isStatsUnguarded({ options: healthOptions })) {
+            this.logger
+                .for(this.binding.name)
+                .warn('GET %s/stats is ENABLED with no secretKey on env "%s" - build stamp, runtime version and memory are readable by anything that reaches this port. Set stats.secretKey, or drop stats.enable and let the environment decide.', path, ignis_helpers_1.Environment.ambient ?? 'unset');
+        }
+        // `getAppInfo()` is async while the container builds the controller synchronously, so the
+        // resolved value is bound here rather than resolved inside the controller.
+        this.application
+            .bind({ key: common_1.HealthCheckBindingKeys.APPLICATION_INFO })
+            .toValue(await this.application.getAppInfo());
+        // The gate and the app identity are per container, but `@controller` writes the PATH onto this
+        // one shared class in the process-wide MetadataRegistry, and `RestComponent` reads it back at
+        // step 8. Two applications booted one after another are safe; two booted CONCURRENTLY with
+        // different `restOptions.path` would race here, and nothing in this component prevents that.
         Reflect.decorate([(0, metadata_1.controller)({ path })], controller_1.HealthCheckController);
         this.application.controller(controller_1.HealthCheckController);
     }