@venizia/ignis 0.2.0-1 → 0.2.0-3

package/dist/components/auth/authenticate/services/service/signer.service.d.ts

@@ -0,0 +1,46 @@
+import { BaseService } from '@venizia/ignis-kernel';
+import type { IServiceAuthOptions } from '@venizia/ignis-kernel';
+import type { JWK } from 'jose';
+/**
+ * Mints the outgoing assertion, and publishes the public half for callees to verify against.
+ *
+ * Only a service that CALLS OUT needs this. `isEnabled()` is false when the application configured
+ * no keys, and the component then mounts no certs route.
+ */
+export declare class ServiceAssertionSignerService extends BaseService {
+    private readonly options;
+    private readonly requestIdGenerator;
+    private privateKey?;
+    private jwks?;
+    constructor(options: IServiceAuthOptions);
+    isEnabled(): boolean;
+    /** `<name>_<rest path without its slash>`, so a rotated mount changes the kid rather than colliding. */
+    getKeyId(): string;
+    /**
+     * One assertion, bound to this exact call.
+     *
+     * `path` must be the percent-ENCODED pathname - `new URL(target).pathname`. The verifier compares
+     * against the same shape, and a decoded path here would fail every route carrying a space or a
+     * non-ASCII slug.
+     */
+    sign(opts: {
+        method: string;
+        path: string;
+        audience: string;
+    }): Promise<string>;
+    /**
+     * The document `/svc-certs` serves, built from the PUBLIC key only.
+     *
+     * `importSPKI` refuses a private PEM outright, which is what makes the private half unreachable
+     * from here by construction rather than by care. The JWK format is deliberately NOT accepted for
+     * this path: `importJWK` imports whatever it is handed, and a private JWK marked `"ext": true`
+     * round-trips its `d` straight into this document. See `JWKSIssuerTokenService.assertPublicJWK`.
+     */
+    getPublicJWKS(): Promise<{
+        keys: JWK[];
+    }>;
+    private resolvePrivateKey;
+    private readKey;
+    private assertEnabled;
+}
+//# sourceMappingURL=signer.service.d.ts.map

package/dist/components/auth/authenticate/services/service/signer.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.service.d.ts","sourceRoot":"","sources":["../../../../../../src/components/auth/authenticate/services/service/signer.service.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,WAAW,EAAoB,MAAM,uBAAuB,CAAC;AAC/F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAIjE,OAAO,KAAK,EAAa,GAAG,EAAE,MAAM,MAAM,CAAC;AAI3C;;;;;GAKG;AACH,qBAAa,6BAA8B,SAAQ,WAAW;IAU1D,OAAO,CAAC,QAAQ,CAAC,OAAO;IAT1B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAEhC;IAEH,OAAO,CAAC,UAAU,CAAC,CAAY;IAC/B,OAAO,CAAC,IAAI,CAAC,CAAkB;gBAIZ,OAAO,EAAE,mBAAmB;IAK/C,SAAS,IAAI,OAAO;IAIpB,wGAAwG;IACxG,QAAQ,IAAI,MAAM;IAKlB;;;;;;OAMG;IACG,IAAI,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBrF;;;;;;;OAOG;IACG,aAAa,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;YAyBjC,iBAAiB;YAUjB,OAAO;IAiBrB,OAAO,CAAC,aAAa;CAUtB"}

package/dist/components/auth/authenticate/services/service/signer.service.js

@@ -0,0 +1,135 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var ServiceAssertionSignerService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceAssertionSignerService = void 0;
+const metadata_1 = require("../../../../../base/metadata");
+const ignis_kernel_1 = require("@venizia/ignis-kernel");
+const core_1 = require("@venizia/ignis-helpers/core");
+const common_1 = require("@venizia/ignis-helpers/common");
+const jose_1 = require("jose");
+const promises_1 = require("node:fs/promises");
+const ignis_kernel_2 = require("@venizia/ignis-kernel");
+/**
+ * Mints the outgoing assertion, and publishes the public half for callees to verify against.
+ *
+ * Only a service that CALLS OUT needs this. `isEnabled()` is false when the application configured
+ * no keys, and the component then mounts no certs route.
+ */
+let ServiceAssertionSignerService = ServiceAssertionSignerService_1 = class ServiceAssertionSignerService extends ignis_kernel_1.BaseService {
+    constructor(options) {
+        super({ scope: ServiceAssertionSignerService_1.name });
+        this.options = options;
+        this.requestIdGenerator = new core_1.RequestIdGenerator({
+            scope: ServiceAssertionSignerService_1.name,
+        });
+    }
+    isEnabled() {
+        return Boolean(this.options.keys);
+    }
+    /** `<name>_<rest path without its slash>`, so a rotated mount changes the kid rather than colliding. */
+    getKeyId() {
+        const restPath = this.options.rest?.path ?? ignis_kernel_1.ServiceAssertion.DEFAULT_REST_PATH;
+        return this.options.keys?.kid ?? `${this.options.name}_${restPath.replace(/^\//, '')}`;
+    }
+    /**
+     * One assertion, bound to this exact call.
+     *
+     * `path` must be the percent-ENCODED pathname - `new URL(target).pathname`. The verifier compares
+     * against the same shape, and a decoded path here would fail every route carrying a space or a
+     * non-ASCII slug.
+     */
+    async sign(opts) {
+        const { method, path, audience } = opts;
+        this.assertEnabled();
+        const now = Math.floor(Date.now() / 1000);
+        const lifetime = this.options.signLifetimeSeconds ?? ignis_kernel_1.ServiceAssertion.DEFAULT_SIGN_LIFETIME_SECONDS;
+        return new jose_1.SignJWT({ htm: method.toUpperCase(), htu: path })
+            .setProtectedHeader({
+            alg: ignis_kernel_1.ServiceAssertion.ALGORITHM,
+            kid: this.getKeyId(),
+            typ: ignis_kernel_1.ServiceAssertion.TYP,
+        })
+            .setIssuer(this.options.name)
+            .setSubject(this.options.name)
+            .setAudience(audience)
+            .setJti(this.requestIdGenerator.nextId())
+            .setIssuedAt(now)
+            .setExpirationTime(now + lifetime)
+            .sign(await this.resolvePrivateKey());
+    }
+    /**
+     * The document `/svc-certs` serves, built from the PUBLIC key only.
+     *
+     * `importSPKI` refuses a private PEM outright, which is what makes the private half unreachable
+     * from here by construction rather than by care. The JWK format is deliberately NOT accepted for
+     * this path: `importJWK` imports whatever it is handed, and a private JWK marked `"ext": true`
+     * round-trips its `d` straight into this document. See `JWKSIssuerTokenService.assertPublicJWK`.
+     */
+    async getPublicJWKS() {
+        if (this.jwks) {
+            return this.jwks;
+        }
+        this.assertEnabled();
+        const raw = await this.readKey({ source: this.options.keys.public });
+        const publicKey = await (0, jose_1.importSPKI)(raw, ignis_kernel_1.ServiceAssertion.ALGORITHM);
+        const jwk = await (0, jose_1.exportJWK)(publicKey);
+        if (jwk.d !== undefined) {
+            throw (0, core_1.getError)({
+                statusCode: common_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                message: `[${ServiceAssertionSignerService_1.name}] The public key material carries a private exponent | this key would be published at the certs endpoint`,
+            });
+        }
+        this.jwks = {
+            keys: [{ ...jwk, kid: this.getKeyId(), alg: ignis_kernel_1.ServiceAssertion.ALGORITHM, use: 'sig' }],
+        };
+        return this.jwks;
+    }
+    async resolvePrivateKey() {
+        if (this.privateKey) {
+            return this.privateKey;
+        }
+        const raw = await this.readKey({ source: this.options.keys.private });
+        this.privateKey = await (0, jose_1.importPKCS8)(raw, ignis_kernel_1.ServiceAssertion.ALGORITHM);
+        return this.privateKey;
+    }
+    async readKey(opts) {
+        const { format, driver } = this.options.keys;
+        if (format !== ignis_kernel_2.JWKSKeyFormats.PEM) {
+            throw (0, core_1.getError)({
+                statusCode: common_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                message: `[${ServiceAssertionSignerService_1.name}] Only the '${ignis_kernel_2.JWKSKeyFormats.PEM}' key format is supported | got: ${format}`,
+            });
+        }
+        if (driver === ignis_kernel_2.JWKSKeyDrivers.FILE) {
+            return (0, promises_1.readFile)(opts.source, 'utf-8');
+        }
+        return opts.source;
+    }
+    assertEnabled() {
+        if (this.options.keys) {
+            return;
+        }
+        throw (0, core_1.getError)({
+            statusCode: common_1.HTTP.ResultCodes.RS_5.InternalServerError,
+            message: `[${ServiceAssertionSignerService_1.name}] This service has no signing keys | it can verify assertions but not mint them`,
+        });
+    }
+};
+exports.ServiceAssertionSignerService = ServiceAssertionSignerService;
+exports.ServiceAssertionSignerService = ServiceAssertionSignerService = ServiceAssertionSignerService_1 = __decorate([
+    __param(0, (0, metadata_1.inject)({ key: ignis_kernel_1.AuthenticateBindingKeys.SERVICE_OPTIONS })),
+    __metadata("design:paramtypes", [Object])
+], ServiceAssertionSignerService);
+//# sourceMappingURL=signer.service.js.map

package/dist/components/auth/authenticate/services/service/signer.service.js.map

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

package/dist/components/auth/authenticate/services/service/verifier.service.d.ts

@@ -0,0 +1,40 @@
+import { BaseService } from '@venizia/ignis-kernel';
+import type { IServiceAuthOptions } from '@venizia/ignis-kernel';
+/**
+ * Verifies an incoming service assertion against the CALLER's own JWKS.
+ *
+ * What the assertion covers, and nothing else: the HTTP method and the percent-encoded path. It does
+ * NOT cover the query string, any header, or the body. Tenant selectors in particular are usually a
+ * header or a query parameter, so an assertion alone does not authenticate which tenant a call acts
+ * on - the caller allowlist and the application's own scoping have to do that. Stated because the
+ * gap is invisible from the call site.
+ */
+export declare class ServiceAssertionVerifierService extends BaseService {
+    private readonly options;
+    /** One remote key set per caller, kept because `createRemoteJWKSet` owns its own cache. */
+    private readonly keySets;
+    /** Per-caller accepted age, resolved once alongside its key set. */
+    private readonly acceptMaxAges;
+    constructor(options: IServiceAuthOptions);
+    /**
+     * @param path The percent-ENCODED pathname, from `new URL(context.req.url).pathname`. Never
+     * `context.req.path` - Hono decodes that one, and the caller signed the encoded form.
+     */
+    verify(opts: {
+        token: string;
+        method: string;
+        path: string;
+    }): Promise<{
+        issuer: string;
+    }>;
+    /**
+     * Reads `iss` WITHOUT verifying, only to choose which key set checks the signature. The same value
+     * is then enforced as the expected issuer, so a forged `iss` buys nothing beyond selecting the key
+     * set that will reject it.
+     */
+    private readIssuer;
+    private resolveKeySet;
+    private runVerify;
+    private assertRequestBinding;
+}
+//# sourceMappingURL=verifier.service.d.ts.map

package/dist/components/auth/authenticate/services/service/verifier.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.service.d.ts","sourceRoot":"","sources":["../../../../../../src/components/auth/authenticate/services/service/verifier.service.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,WAAW,EAEZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAA2B,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAM1F;;;;;;;;GAQG;AACH,qBAAa,+BAAgC,SAAQ,WAAW;IAS5D,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR1B,2FAA2F;IAC3F,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAE5D,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;gBAIxC,OAAO,EAAE,mBAAmB;IAK/C;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAYhG;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,aAAa;YAyCP,SAAS;IA+CvB,OAAO,CAAC,oBAAoB;CAoB7B"}

package/dist/components/auth/authenticate/services/service/verifier.service.js

@@ -0,0 +1,153 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var ServiceAssertionVerifierService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceAssertionVerifierService = void 0;
+const metadata_1 = require("../../../../../base/metadata");
+const ignis_kernel_1 = require("@venizia/ignis-kernel");
+const core_1 = require("@venizia/ignis-helpers/core");
+const jose_1 = require("jose");
+/**
+ * Verifies an incoming service assertion against the CALLER's own JWKS.
+ *
+ * What the assertion covers, and nothing else: the HTTP method and the percent-encoded path. It does
+ * NOT cover the query string, any header, or the body. Tenant selectors in particular are usually a
+ * header or a query parameter, so an assertion alone does not authenticate which tenant a call acts
+ * on - the caller allowlist and the application's own scoping have to do that. Stated because the
+ * gap is invisible from the call site.
+ */
+let ServiceAssertionVerifierService = ServiceAssertionVerifierService_1 = class ServiceAssertionVerifierService extends ignis_kernel_1.BaseService {
+    constructor(options) {
+        super({ scope: ServiceAssertionVerifierService_1.name });
+        this.options = options;
+        /** One remote key set per caller, kept because `createRemoteJWKSet` owns its own cache. */
+        this.keySets = new Map();
+        /** Per-caller accepted age, resolved once alongside its key set. */
+        this.acceptMaxAges = new Map();
+    }
+    /**
+     * @param path The percent-ENCODED pathname, from `new URL(context.req.url).pathname`. Never
+     * `context.req.path` - Hono decodes that one, and the caller signed the encoded form.
+     */
+    async verify(opts) {
+        const { token, method, path } = opts;
+        const issuer = this.readIssuer({ token });
+        const keySet = this.resolveKeySet({ issuer });
+        const payload = await this.runVerify({ token, issuer, keySet });
+        this.assertRequestBinding({ payload, method, path });
+        return { issuer };
+    }
+    /**
+     * Reads `iss` WITHOUT verifying, only to choose which key set checks the signature. The same value
+     * is then enforced as the expected issuer, so a forged `iss` buys nothing beyond selecting the key
+     * set that will reject it.
+     */
+    readIssuer(opts) {
+        try {
+            const { iss } = (0, jose_1.decodeJwt)(opts.token);
+            // Typed, not merely present: a numeric `iss` would index the caller map by coercion.
+            if (typeof iss !== 'string' || iss.length === 0) {
+                throw new Error('missing or non-string iss');
+            }
+            return iss;
+        }
+        catch (error) {
+            this.logger.for(this.readIssuer.name).warn('Undecodable assertion | error: %s', error);
+            throw (0, core_1.getError)({ error: ignis_kernel_1.AuthenticationErrors.ASSERTION_INVALID });
+        }
+    }
+    resolveKeySet(opts) {
+        const { issuer } = opts;
+        const cached = this.keySets.get(issuer);
+        if (cached) {
+            return cached;
+        }
+        const callers = this.options.callers ?? {};
+        // `Object.hasOwn`, never a truthiness check on the index: the map arrives as a plain object, so
+        // `iss: 'constructor'` would otherwise return `Function` - truthy - walk past this guard, and
+        // reach `new URL(<function>)` as an uncaught TypeError.
+        if (!Object.hasOwn(callers, issuer)) {
+            this.logger
+                .for(this.resolveKeySet.name)
+                .warn('Caller not on the allowlist | iss: %s', issuer);
+            throw (0, core_1.getError)({ error: ignis_kernel_1.AuthenticationErrors.CALLER_NOT_ALLOWED });
+        }
+        const entry = callers[issuer];
+        const jwksUrl = typeof entry === 'string' ? entry : entry.jwksUrl;
+        this.acceptMaxAges.set(issuer, ignis_kernel_1.ServiceAssertion.resolveAcceptMaxAge({
+            callerOverride: typeof entry === 'string' ? undefined : entry.acceptMaxAgeSeconds,
+            serviceDefault: this.options.acceptMaxAgeSeconds,
+        }));
+        const keySet = (0, jose_1.createRemoteJWKSet)(new URL(jwksUrl), {
+            cacheMaxAge: this.options.jwks?.cacheMaxAgeMs ?? ignis_kernel_1.ServiceAssertion.DEFAULT_JWKS_CACHE_MAX_AGE_MS,
+            cooldownDuration: this.options.jwks?.cooldownMs ?? ignis_kernel_1.ServiceAssertion.DEFAULT_JWKS_COOLDOWN_MS,
+        });
+        this.keySets.set(issuer, keySet);
+        return keySet;
+    }
+    async runVerify(opts) {
+        const { token, issuer, keySet } = opts;
+        // Resolved when the key set was, so a per-caller override is already folded in.
+        const maxTokenAge = this.acceptMaxAges.get(issuer) ??
+            ignis_kernel_1.ServiceAssertion.resolveAcceptMaxAge({
+                serviceDefault: this.options.acceptMaxAgeSeconds,
+            });
+        const clockTolerance = this.options.clockToleranceSeconds ?? ignis_kernel_1.ServiceAssertion.DEFAULT_CLOCK_TOLERANCE_SECONDS;
+        try {
+            const { payload } = await (0, jose_1.jwtVerify)(token, keySet, {
+                algorithms: [ignis_kernel_1.ServiceAssertion.ALGORITHM],
+                typ: ignis_kernel_1.ServiceAssertion.TYP,
+                issuer,
+                audience: this.options.name,
+                // NOT redundant with `exp`, though it looks it. An honest caller stamps `exp = iat +
+                // lifetime`, so the two are numerically tied and jose reaches `exp` first - measured.
+                // `maxTokenAge` is the only bound that still holds when the CALLER is the attacker and picks
+                // its own `exp`, which is precisely the case it exists for. Do not delete it as dead config.
+                //
+                // And it is the CALLEE's number, never one the caller may request: a caller that could ask
+                // for a longer window would be choosing its own replay window, which is the whole thing this
+                // is here to deny.
+                maxTokenAge,
+                clockTolerance,
+                requiredClaims: ['htm', 'htu', 'jti'],
+            });
+            return payload;
+        }
+        catch (error) {
+            // One code out, the reason on `cause`: a wrong audience, clock skew and a rotated key are
+            // otherwise the same string to whoever is reading the log at 2am.
+            const reason = error?.cause ?? error;
+            this.logger.for(this.runVerify.name).warn('Rejected | iss: %s | reason: %s', issuer, reason);
+            throw (0, core_1.getError)({ error: ignis_kernel_1.AuthenticationErrors.ASSERTION_INVALID, cause: error });
+        }
+    }
+    assertRequestBinding(opts) {
+        const { payload, method, path } = opts;
+        const signed = `${payload.htm} ${payload.htu}`;
+        const actual = `${method.toUpperCase()} ${path}`;
+        if (signed === actual) {
+            return;
+        }
+        this.logger
+            .for(this.assertRequestBinding.name)
+            .warn('Request binding mismatch | signed: %s | actual: %s', signed, actual);
+        throw (0, core_1.getError)({ error: ignis_kernel_1.AuthenticationErrors.REQUEST_BINDING_MISMATCH });
+    }
+};
+exports.ServiceAssertionVerifierService = ServiceAssertionVerifierService;
+exports.ServiceAssertionVerifierService = ServiceAssertionVerifierService = ServiceAssertionVerifierService_1 = __decorate([
+    __param(0, (0, metadata_1.inject)({ key: ignis_kernel_1.AuthenticateBindingKeys.SERVICE_OPTIONS })),
+    __metadata("design:paramtypes", [Object])
+], ServiceAssertionVerifierService);
+//# sourceMappingURL=verifier.service.js.map

package/dist/components/auth/authenticate/services/service/verifier.service.js.map

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

package/dist/components/auth/authenticate/strategies/index.d.ts

@@ -2,4 +2,5 @@ export * from '@venizia/ignis-kernel';
 export * from './basic.strategy';
 export * from './jws.strategy';
 export * from './jwks.strategy';
+export * from './service.strategy';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/auth/authenticate/strategies/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/auth/authenticate/strategies/index.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/auth/authenticate/strategies/index.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}

package/dist/components/auth/authenticate/strategies/index.js

@@ -19,4 +19,5 @@ __exportStar(require("@venizia/ignis-kernel"), exports);
 __exportStar(require("./basic.strategy"), exports);
 __exportStar(require("./jws.strategy"), exports);
 __exportStar(require("./jwks.strategy"), exports);
+__exportStar(require("./service.strategy"), exports);
 //# sourceMappingURL=index.js.map

package/dist/components/auth/authenticate/strategies/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/components/auth/authenticate/strategies/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iGAAiG;AACjG,wDAAsC;AAEtC,mDAAiC;AACjC,iDAA+B;AAC/B,kDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/components/auth/authenticate/strategies/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iGAAiG;AACjG,wDAAsC;AAEtC,mDAAiC;AACjC,iDAA+B;AAC/B,kDAAgC;AAChC,qDAAmC"}

package/dist/components/auth/authenticate/strategies/service.strategy.d.ts

@@ -0,0 +1,19 @@
+import { BaseHelper } from '@venizia/ignis-helpers/core';
+import type { Env } from 'hono';
+import type { IAuthUser, IAuthenticationStrategy, IServiceAuthOptions, TContext } from '@venizia/ignis-kernel';
+import { ServiceAssertionVerifierService } from '../services/service/verifier.service';
+/**
+ * Proves the CALLING SERVICE, from a per-request Ed25519 assertion verified against that caller's
+ * own JWKS. No identity round trip and no shared password.
+ *
+ * It proves which service called, never which user. `resolvePrincipal` is where the application
+ * turns a caller name into one of its own principals.
+ */
+export declare class ServiceAuthenticationStrategy<E extends Env = Env> extends BaseHelper implements IAuthenticationStrategy<E> {
+    private readonly verifier;
+    private readonly options;
+    name: string;
+    constructor(verifier: ServiceAssertionVerifierService, options: IServiceAuthOptions<E>);
+    authenticate(context: TContext<E, string>): Promise<IAuthUser>;
+}
+//# sourceMappingURL=service.strategy.d.ts.map

package/dist/components/auth/authenticate/strategies/service.strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.strategy.d.ts","sourceRoot":"","sources":["../../../../../src/components/auth/authenticate/strategies/service.strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AAEnE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAShC,OAAO,KAAK,EACV,SAAS,EACT,uBAAuB,EACvB,mBAAmB,EACnB,QAAQ,EACT,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAEvF;;;;;;GAMG;AACH,qBAAa,6BAA6B,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,CAC5D,SAAQ,UACR,YAAW,uBAAuB,CAAC,CAAC,CAAC;IAWnC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX1B,IAAI,SAAmC;gBASpB,QAAQ,EAAE,+BAA+B,EAEzC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAK5C,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;CA8BrE"}

package/dist/components/auth/authenticate/strategies/service.strategy.js

@@ -0,0 +1,73 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var ServiceAuthenticationStrategy_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceAuthenticationStrategy = void 0;
+const core_1 = require("@venizia/ignis-helpers/core");
+const ignis_inversion_1 = require("@venizia/ignis-inversion");
+const ignis_kernel_1 = require("@venizia/ignis-kernel");
+const verifier_service_1 = require("../services/service/verifier.service");
+/**
+ * Proves the CALLING SERVICE, from a per-request Ed25519 assertion verified against that caller's
+ * own JWKS. No identity round trip and no shared password.
+ *
+ * It proves which service called, never which user. `resolvePrincipal` is where the application
+ * turns a caller name into one of its own principals.
+ */
+let ServiceAuthenticationStrategy = ServiceAuthenticationStrategy_1 = class ServiceAuthenticationStrategy extends core_1.BaseHelper {
+    constructor(verifier, options) {
+        super({ scope: ServiceAuthenticationStrategy_1.name });
+        this.verifier = verifier;
+        this.options = options;
+        this.name = ignis_kernel_1.Authentication.STRATEGY_SERVICE;
+    }
+    async authenticate(context) {
+        const token = context.req.header(ignis_kernel_1.ServiceAssertion.HEADER);
+        if (!token) {
+            throw (0, core_1.getError)({ error: ignis_kernel_1.AuthenticationErrors.ASSERTION_MISSING });
+        }
+        // The raw url, NOT `context.req.path`: Hono hands that back percent-DECODED, so a route carrying
+        // a space or a non-ASCII slug would never match the encoded path the caller signed.
+        const { issuer } = await this.verifier.verify({
+            token,
+            method: context.req.method,
+            path: new URL(context.req.url).pathname,
+        });
+        const principal = await this.options.resolvePrincipal({ issuer, context });
+        // Validated rather than trusted. `executeAnyMode` calls `setCurrentUser` unconditionally, so an
+        // application returning a principal without a `userId` would authenticate the request and then
+        // fail at the first write, far from here. `executeAllMode` already refuses it; this closes the
+        // gap between the two modes.
+        if (!principal?.userId) {
+            this.logger
+                .for(this.authenticate.name)
+                .warn('resolvePrincipal returned no usable principal | iss: %s', issuer);
+            throw (0, core_1.getError)({ error: ignis_kernel_1.AuthenticationErrors.PRINCIPAL_UNRESOLVED });
+        }
+        // Which service called is audit-relevant even when the principal is shared across callers.
+        return { ...principal, callerService: issuer };
+    }
+};
+exports.ServiceAuthenticationStrategy = ServiceAuthenticationStrategy;
+exports.ServiceAuthenticationStrategy = ServiceAuthenticationStrategy = ServiceAuthenticationStrategy_1 = __decorate([
+    __param(0, (0, ignis_kernel_1.inject)({
+        key: ignis_inversion_1.BindingKeys.build({
+            namespace: ignis_kernel_1.BindingNamespaces.SERVICE,
+            key: verifier_service_1.ServiceAssertionVerifierService.name,
+        }),
+    })),
+    __param(1, (0, ignis_kernel_1.inject)({ key: ignis_kernel_1.AuthenticateBindingKeys.SERVICE_OPTIONS })),
+    __metadata("design:paramtypes", [verifier_service_1.ServiceAssertionVerifierService, Object])
+], ServiceAuthenticationStrategy);
+//# sourceMappingURL=service.strategy.js.map

package/dist/components/auth/authenticate/strategies/service.strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.strategy.js","sourceRoot":"","sources":["../../../../../src/components/auth/authenticate/strategies/service.strategy.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAmE;AACnE,8DAAuD;AAEvD,wDAO+B;AAO/B,2EAAuF;AAEvF;;;;;;GAMG;AACH,IAAa,6BAA6B,qCAA1C,MAAa,6BACX,SAAQ,iBAAU;IAKlB,YAOE,QAA0D,EAE1D,OAAgD;QAEhD,KAAK,CAAC,EAAE,KAAK,EAAE,+BAA6B,CAAC,IAAI,EAAE,CAAC,CAAC;QAJpC,aAAQ,GAAR,QAAQ,CAAiC;QAEzC,YAAO,GAAP,OAAO,CAAwB;QAXlD,SAAI,GAAG,6BAAc,CAAC,gBAAgB,CAAC;IAcvC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAA4B;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,+BAAgB,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAA,eAAQ,EAAC,EAAE,KAAK,EAAE,mCAAoB,CAAC,iBAAiB,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,iGAAiG;QACjG,oFAAoF;QACpF,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC5C,KAAK;YACL,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM;YAC1B,IAAI,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ;SACxC,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAE3E,gGAAgG;QAChG,+FAA+F;QAC/F,+FAA+F;QAC/F,6BAA6B;QAC7B,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;iBAC3B,IAAI,CAAC,yDAAyD,EAAE,MAAM,CAAC,CAAC;YAC3E,MAAM,IAAA,eAAQ,EAAC,EAAE,KAAK,EAAE,mCAAoB,CAAC,oBAAoB,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,2FAA2F;QAC3F,OAAO,EAAE,GAAG,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;IACjD,CAAC;CACF,CAAA;AAlDY,sEAA6B;wCAA7B,6BAA6B;IAOrC,WAAA,IAAA,qBAAM,EAAC;QACN,GAAG,EAAE,6BAAW,CAAC,KAAK,CAAC;YACrB,SAAS,EAAE,gCAAiB,CAAC,OAAO;YACpC,GAAG,EAAE,kDAA+B,CAAC,IAAI;SAC1C,CAAC;KACH,CAAC,CAAA;IAED,WAAA,IAAA,qBAAM,EAAC,EAAE,GAAG,EAAE,sCAAuB,CAAC,eAAe,EAAE,CAAC,CAAA;qCAD9B,kDAA+B;GAbjD,6BAA6B,CAkDzC"}

package/dist/components/static-asset/controller/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/components/static-asset/controller/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAQ,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAGL,cAAc,EAIf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE3B,OAAO,EAIL,eAAe,EAEf,wBAAwB,EACxB,6BAA6B,EAC7B,uBAAuB,EAGxB,MAAM,WAAW,CAAC;AAGnB,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAChE,OAAO,EAAE,uBAAuB,CAAC;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,OAAO,CAAC,EAAE,wBAAwB,CAAC;CACpC;AAuBD,qBAAa,sBAAuB,SAAQ,UAAU;;IAKpD,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,uBAAuB;;YAkBtD,6FAA6F;2CAC9D;gBAAE,KAAK,EAAE,MAAM,EAAE,CAAA;aAAE,GAAG,IAAI;uBAYrC,cAAc,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAxDiC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6e/E"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/components/static-asset/controller/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAQ,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAGL,cAAc,EAIf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE3B,OAAO,EAIL,eAAe,EAEf,wBAAwB,EACxB,6BAA6B,EAC7B,uBAAuB,EAGxB,MAAM,WAAW,CAAC;AAGnB,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAChE,OAAO,EAAE,uBAAuB,CAAC;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,OAAO,CAAC,EAAE,wBAAwB,CAAC;CACpC;AAuBD,qBAAa,sBAAuB,SAAQ,UAAU;;IAKpD,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,uBAAuB;;YAkBtD,6FAA6F;2CAC9D;gBAAE,KAAK,EAAE,MAAM,EAAE,CAAA;aAAE,GAAG,IAAI;uBAYrC,cAAc,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAxDiC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAif/E"}

package/dist/components/static-asset/controller/factory.js

@@ -270,7 +270,11 @@ class AssetControllerFactory extends core_1.BaseHelper {
                                 results.push({
                                     ...uploadResult,
                                     metaLink: null,
-                                    metaLinkError: error instanceof Error ? error.message : 'Unknown error',
+                                    // A CODE, never the driver text. This handler returns 200, so it bypasses the
+                                    // error middleware and `database.handler` - the two places that strip
+                                    // `detail`/`table`/`constraint` - and shipped raw constraint names to the client.
+                                    // The real error is already logged in full immediately above.
+                                    metaLinkError: 'META_LINK_CREATE_FAILED',
                                 });
                             }
                         }