@hed-hog/core 0.0.390 → 0.0.393

package/dist/pairing/pairing.controller.js

@@ -0,0 +1,296 @@
+"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 __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PairingController = void 0;
+const api_1 = require("@hed-hog/api");
+const api_locale_1 = require("@hed-hog/api-locale");
+const common_1 = require("@nestjs/common");
+const throttler_1 = require("@nestjs/throttler");
+const token_service_1 = require("../token/token.service");
+const approve_reverse_pairing_dto_1 = require("./dto/approve-reverse-pairing.dto");
+const claim_pairing_dto_1 = require("./dto/claim-pairing.dto");
+const confirm_pairing_dto_1 = require("./dto/confirm-pairing.dto");
+const poll_reverse_pairing_dto_1 = require("./dto/poll-reverse-pairing.dto");
+const start_pairing_dto_1 = require("./dto/start-pairing.dto");
+const start_reverse_pairing_dto_1 = require("./dto/start-reverse-pairing.dto");
+const pairing_service_1 = require("./pairing.service");
+/**
+ * Pareamento por QR code. Fica em `/auth` ao lado de `/auth/authorize/*` porque
+ * é a mesma família: transferir uma sessão para outro cliente sem manipular
+ * senha.
+ *
+ * Quem chama o quê:
+ * - direção A: o NAVEGADOR abre, acompanha e confirma (rotas autenticadas); o
+ *   CELULAR reivindica e resgata (rotas públicas — ele ainda não tem sessão);
+ * - direção B: o NAVEGADOR abre e faz poll (rotas públicas — pode ser um
+ *   computador onde ninguém está logado); o CELULAR inspeciona e aprova (rotas
+ *   autenticadas).
+ */
+let PairingController = class PairingController {
+    constructor(service, token) {
+        this.service = service;
+        this.token = token;
+    }
+    /* ---------------------------- Direção A ---------------------------- */
+    async start({ id }, body, ipAddress, userAgent) {
+        return this.service.start({
+            userId: id,
+            authTokenHash: body.auth_token_hash,
+            clientId: body.client_id,
+            ipAddress,
+            userAgent,
+        });
+    }
+    /** Poll do navegador enquanto o QR está na tela. Limite alto por isso. */
+    async status({ id: userId }, id) {
+        return this.service.status(userId, id);
+    }
+    async confirm({ id: userId }, id, body) {
+        return this.service.confirm({ userId, id, payloadEnc: body.payload_enc });
+    }
+    async cancel({ id: userId }, id) {
+        return this.service.cancel(userId, id);
+    }
+    /**
+     * Público por definição: quem chama é o aparelho que acabou de ler o QR e
+     * ainda não tem sessão nenhuma. Quem autentica é a posse do token que saiu do
+     * fragmento.
+     */
+    async claim(body, ipAddress, userAgent) {
+        return this.service.claim({
+            authToken: body.auth_token,
+            clientId: body.client_id,
+            ipAddress,
+            userAgent,
+        });
+    }
+    /**
+     * Sem `@Res()` e sem cookie `rt`: quem resgata aqui é um app nativo, para quem
+     * um Set-Cookie é ruído. O refreshToken vai no corpo, como em `/auth/token`.
+     */
+    async redeem(body, locale, ipAddress, userAgent) {
+        return this.service.redeem({
+            authToken: body.auth_token,
+            clientId: body.client_id,
+            locale,
+            ipAddress,
+            userAgent,
+        });
+    }
+    /* ---------------------------- Direção B ---------------------------- */
+    async startReverse(body, ipAddress, userAgent) {
+        var _a;
+        return this.service.startReverse({
+            pollHash: body.poll_hash,
+            ephPublicKey: body.eph_public_key,
+            wantSession: (_a = body.want_session) !== null && _a !== void 0 ? _a : true,
+            clientId: body.client_id,
+            ipAddress,
+            userAgent,
+        });
+    }
+    /**
+     * O `k` é a pública efêmera lida do QR, e serve de prova de que quem pergunta
+     * esteve na frente da tela. Ela é pública — pode aparecer no log de acesso sem
+     * problema —, e sem ela o `id` sequencial permitiria varrer os pareamentos
+     * alheios.
+     */
+    async reverseRequest(id, ephPublicKey) {
+        return this.service.getReverseRequest(id, ephPublicKey !== null && ephPublicKey !== void 0 ? ephPublicKey : '');
+    }
+    async approveReverse({ id: userId }, id, body) {
+        return this.service.approveReverse({
+            userId,
+            id,
+            ephPublicKey: body.eph_public_key,
+            payloadEnc: body.payload_enc,
+        });
+    }
+    async rejectReverse({ id: userId }, id, body) {
+        var _a;
+        return this.service.rejectReverse({
+            userId,
+            id,
+            ephPublicKey: (_a = body === null || body === void 0 ? void 0 : body.eph_public_key) !== null && _a !== void 0 ? _a : '',
+        });
+    }
+    /**
+     * Aqui o cookie `rt` FAZ sentido, ao contrário do redeem: quem resgata é um
+     * navegador, e é o mesmo formato de sessão que o login normal entrega.
+     */
+    async pollReverse(body, locale, res) {
+        const result = await this.service.pollReverse({
+            pollToken: body.poll_token,
+            locale,
+        });
+        if ('session' in result && result.session && result.refreshToken) {
+            await this.token.setRefreshTokenCookie(locale, res, result.refreshToken, result.session.expires_at);
+        }
+        // A sessão inteira não volta para o cliente: ele precisa dos tokens, não do
+        // registro do banco.
+        const _a = result, { session } = _a, payload = __rest(_a, ["session"]);
+        return payload;
+    }
+};
+exports.PairingController = PairingController;
+__decorate([
+    (0, api_1.NoRole)(),
+    (0, common_1.UseGuards)(throttler_1.ThrottlerGuard),
+    (0, throttler_1.Throttle)({ default: { limit: 5, ttl: 60000 } }),
+    (0, common_1.Post)('pairing'),
+    __param(0, (0, api_1.User)()),
+    __param(1, (0, common_1.Body)()),
+    __param(2, (0, common_1.Ip)()),
+    __param(3, (0, common_1.Headers)('user-agent')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, start_pairing_dto_1.StartPairingDTO, String, String]),
+    __metadata("design:returntype", Promise)
+], PairingController.prototype, "start", null);
+__decorate([
+    (0, api_1.NoRole)(),
+    (0, common_1.UseGuards)(throttler_1.ThrottlerGuard),
+    (0, throttler_1.Throttle)({ default: { limit: 120, ttl: 60000 } }),
+    (0, common_1.Get)('pairing/:id'),
+    __param(0, (0, api_1.User)()),
+    __param(1, (0, common_1.Param)('id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", Promise)
+], PairingController.prototype, "status", null);
+__decorate([
+    (0, api_1.NoRole)(),
+    (0, common_1.UseGuards)(throttler_1.ThrottlerGuard),
+    (0, throttler_1.Throttle)({ default: { limit: 10, ttl: 60000 } }),
+    (0, common_1.Post)('pairing/:id/confirm'),
+    __param(0, (0, api_1.User)()),
+    __param(1, (0, common_1.Param)('id')),
+    __param(2, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, confirm_pairing_dto_1.ConfirmPairingDTO]),
+    __metadata("design:returntype", Promise)
+], PairingController.prototype, "confirm", null);
+__decorate([
+    (0, api_1.NoRole)(),
+    (0, common_1.UseGuards)(throttler_1.ThrottlerGuard),
+    (0, throttler_1.Throttle)({ default: { limit: 20, ttl: 60000 } }),
+    (0, common_1.Delete)('pairing/:id'),
+    __param(0, (0, api_1.User)()),
+    __param(1, (0, common_1.Param)('id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", Promise)
+], PairingController.prototype, "cancel", null);
+__decorate([
+    (0, api_1.Public)(),
+    (0, common_1.UseGuards)(throttler_1.ThrottlerGuard),
+    (0, throttler_1.Throttle)({ default: { limit: 10, ttl: 60000 } }),
+    (0, common_1.Post)('pairing/claim'),
+    __param(0, (0, common_1.Body)()),
+    __param(1, (0, common_1.Ip)()),
+    __param(2, (0, common_1.Headers)('user-agent')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [claim_pairing_dto_1.ClaimPairingDTO, String, String]),
+    __metadata("design:returntype", Promise)
+], PairingController.prototype, "claim", null);
+__decorate([
+    (0, api_1.Public)(),
+    (0, common_1.UseGuards)(throttler_1.ThrottlerGuard),
+    (0, throttler_1.Throttle)({ default: { limit: 60, ttl: 60000 } }),
+    (0, common_1.Post)('pairing/redeem'),
+    __param(0, (0, common_1.Body)()),
+    __param(1, (0, api_locale_1.Locale)()),
+    __param(2, (0, common_1.Ip)()),
+    __param(3, (0, common_1.Headers)('user-agent')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [claim_pairing_dto_1.ClaimPairingDTO, String, String, String]),
+    __metadata("design:returntype", Promise)
+], PairingController.prototype, "redeem", null);
+__decorate([
+    (0, api_1.Public)(),
+    (0, common_1.UseGuards)(throttler_1.ThrottlerGuard),
+    (0, throttler_1.Throttle)({ default: { limit: 10, ttl: 60000 } }),
+    (0, common_1.Post)('pairing/reverse'),
+    __param(0, (0, common_1.Body)()),
+    __param(1, (0, common_1.Ip)()),
+    __param(2, (0, common_1.Headers)('user-agent')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [start_reverse_pairing_dto_1.StartReversePairingDTO, String, String]),
+    __metadata("design:returntype", Promise)
+], PairingController.prototype, "startReverse", null);
+__decorate([
+    (0, api_1.NoRole)(),
+    (0, common_1.UseGuards)(throttler_1.ThrottlerGuard),
+    (0, throttler_1.Throttle)({ default: { limit: 30, ttl: 60000 } }),
+    (0, common_1.Get)('pairing/reverse/:id'),
+    __param(0, (0, common_1.Param)('id')),
+    __param(1, (0, common_1.Query)('k')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String]),
+    __metadata("design:returntype", Promise)
+], PairingController.prototype, "reverseRequest", null);
+__decorate([
+    (0, api_1.NoRole)(),
+    (0, common_1.UseGuards)(throttler_1.ThrottlerGuard),
+    (0, throttler_1.Throttle)({ default: { limit: 10, ttl: 60000 } }),
+    (0, common_1.Post)('pairing/reverse/:id/approve'),
+    __param(0, (0, api_1.User)()),
+    __param(1, (0, common_1.Param)('id')),
+    __param(2, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, approve_reverse_pairing_dto_1.ApproveReversePairingDTO]),
+    __metadata("design:returntype", Promise)
+], PairingController.prototype, "approveReverse", null);
+__decorate([
+    (0, api_1.NoRole)(),
+    (0, common_1.UseGuards)(throttler_1.ThrottlerGuard),
+    (0, throttler_1.Throttle)({ default: { limit: 20, ttl: 60000 } }),
+    (0, common_1.Post)('pairing/reverse/:id/reject'),
+    __param(0, (0, api_1.User)()),
+    __param(1, (0, common_1.Param)('id')),
+    __param(2, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, Object]),
+    __metadata("design:returntype", Promise)
+], PairingController.prototype, "rejectReverse", null);
+__decorate([
+    (0, api_1.Public)(),
+    (0, common_1.UseGuards)(throttler_1.ThrottlerGuard),
+    (0, throttler_1.Throttle)({ default: { limit: 60, ttl: 60000 } }),
+    (0, common_1.Post)('pairing/reverse/poll'),
+    __param(0, (0, common_1.Body)()),
+    __param(1, (0, api_locale_1.Locale)()),
+    __param(2, (0, common_1.Res)({ passthrough: true })),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [poll_reverse_pairing_dto_1.PollReversePairingDTO, String, Object]),
+    __metadata("design:returntype", Promise)
+], PairingController.prototype, "pollReverse", null);
+exports.PairingController = PairingController = __decorate([
+    (0, common_1.Controller)('auth'),
+    __param(0, (0, common_1.Inject)((0, common_1.forwardRef)(() => pairing_service_1.PairingService))),
+    __param(1, (0, common_1.Inject)((0, common_1.forwardRef)(() => token_service_1.TokenService))),
+    __metadata("design:paramtypes", [pairing_service_1.PairingService,
+        token_service_1.TokenService])
+], PairingController);
+//# sourceMappingURL=pairing.controller.js.map

package/dist/pairing/pairing.controller.js.map

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

package/dist/pairing/pairing.module.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Separado do AuthorizeModule: lá o HedHog é provedor OAuth para um cliente que
+ * conhece de antemão o servidor; aqui o ponto é justamente o aparelho que ainda
+ * não sabe com quem falar. O que os dois compartilham — token opaco com hash,
+ * TTL curto e consumo atômico — está copiado, não abstraído: uma base comum
+ * amarraria dois fluxos de auth que devem poder divergir.
+ */
+export declare class PairingModule {
+}
+//# sourceMappingURL=pairing.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.module.d.ts","sourceRoot":"","sources":["../../src/pairing/pairing.module.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,qBAWa,aAAa;CAAG"}

package/dist/pairing/pairing.module.js

@@ -0,0 +1,40 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PairingModule = void 0;
+const api_prisma_1 = require("@hed-hog/api-prisma");
+const common_1 = require("@nestjs/common");
+const auth_module_1 = require("../auth/auth.module");
+const security_module_1 = require("../security/security.module");
+const token_module_1 = require("../token/token.module");
+const pairing_controller_1 = require("./pairing.controller");
+const pairing_service_1 = require("./pairing.service");
+/**
+ * Separado do AuthorizeModule: lá o HedHog é provedor OAuth para um cliente que
+ * conhece de antemão o servidor; aqui o ponto é justamente o aparelho que ainda
+ * não sabe com quem falar. O que os dois compartilham — token opaco com hash,
+ * TTL curto e consumo atômico — está copiado, não abstraído: uma base comum
+ * amarraria dois fluxos de auth que devem poder divergir.
+ */
+let PairingModule = class PairingModule {
+};
+exports.PairingModule = PairingModule;
+exports.PairingModule = PairingModule = __decorate([
+    (0, common_1.Module)({
+        imports: [
+            (0, common_1.forwardRef)(() => api_prisma_1.PrismaModule),
+            (0, common_1.forwardRef)(() => security_module_1.SecurityModule),
+            (0, common_1.forwardRef)(() => auth_module_1.AuthModule),
+            (0, common_1.forwardRef)(() => token_module_1.TokenModule),
+        ],
+        controllers: [pairing_controller_1.PairingController],
+        providers: [pairing_service_1.PairingService],
+        exports: [pairing_service_1.PairingService],
+    })
+], PairingModule);
+//# sourceMappingURL=pairing.module.js.map

package/dist/pairing/pairing.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.module.js","sourceRoot":"","sources":["../../src/pairing/pairing.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,oDAAmD;AACnD,2CAAoD;AACpD,qDAAiD;AACjD,iEAA6D;AAC7D,wDAAoD;AACpD,6DAAyD;AACzD,uDAAmD;AAEnD;;;;;;GAMG;AAYI,IAAM,aAAa,GAAnB,MAAM,aAAa;CAAG,CAAA;AAAhB,sCAAa;wBAAb,aAAa;IAXzB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC;YAC9B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,gCAAc,CAAC;YAChC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,wBAAU,CAAC;YAC5B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,0BAAW,CAAC;SAC9B;QACD,WAAW,EAAE,CAAC,sCAAiB,CAAC;QAChC,SAAS,EAAE,CAAC,gCAAc,CAAC;QAC3B,OAAO,EAAE,CAAC,gCAAc,CAAC;KAC1B,CAAC;GACW,aAAa,CAAG"}

package/dist/pairing/pairing.service.d.ts

@@ -0,0 +1,238 @@
+import { PrismaService } from '@hed-hog/api-prisma';
+import { AuthService } from '../auth/auth.service';
+import { SecurityService } from '../security/security.service';
+/**
+ * Pareamento de aparelhos por QR code, nas duas direções.
+ *
+ * Modelado no `AuthorizeService`: token opaco de que só o hash é persistido, TTL
+ * curto, e toda transição de estado decidida pelo banco com
+ * `UPDATE ... WHERE ... IS NULL RETURNING`. Dois requests concorrentes — o caso
+ * de replay — só podem ter um vencedor, e quem decide é o Postgres.
+ *
+ * ## O que este serviço NÃO faz
+ *
+ * Ele nunca decifra `payload_enc`. Aquele blob é AES-256-GCM feito no cliente,
+ * com uma chave que jamais chega até aqui: na direção A ela sai do fragmento do
+ * QR (que o navegador não transmite), na direção B da chave privada efêmera que
+ * vive só na memória da aba. Chamar `security.decrypt` nele não daria erro de
+ * compilação — daria um cofre a menos de zero-knowledge. O spec cobre isso.
+ *
+ * ## Por que a direção A tem duas fases
+ *
+ * Se o navegador subisse o blob junto com o QR, quem fotografasse a tela nos 2
+ * minutos de validade levaria a sessão e as chaves. Com claim → confirm →
+ * redeem, o aparelho que reivindica não recebe nada; o blob só sobe depois que a
+ * pessoa aprovou, olhando o IP e o user-agent de quem pediu. Um QR
+ * fotografado vira um alerta recusável na tela da própria vítima.
+ */
+export declare class PairingService {
+    private readonly prisma;
+    private readonly security;
+    private readonly auth;
+    private readonly logger;
+    /**
+     * Curto de propósito: o QR fica visível numa tela, e o único trabalho dele é
+     * sobreviver ao tempo de pegar o celular e apontar a câmera.
+     */
+    private readonly pairingTtlMs;
+    static readonly BROWSER_TO_DEVICE = "browser-to-device";
+    static readonly DEVICE_TO_BROWSER = "device-to-browser";
+    /**
+     * Uma mensagem só para "não existe", "expirou", "já foi usado" e "está no
+     * estado errado". Distinguir esses casos contaria a um atacante exatamente
+     * onde ele está no fluxo.
+     */
+    private static readonly GENERIC_ERROR;
+    constructor(prisma: PrismaService, security: SecurityService, auth: AuthService);
+    private invalid;
+    private assertClient;
+    private expiresAt;
+    private parseId;
+    /**
+     * Mesma tabela que `UserService.registerUserActivity` escreve. O insert é
+     * direto para não arrastar o UserModule inteiro — com todas as suas
+     * dependências — para dentro de um módulo de auth por causa de uma linha.
+     */
+    private logActivity;
+    /**
+     * Comparação em tempo constante de duas strings base64. Usada na prova de
+     * posse da chave efêmera, que é pública mas cujo desencontro não deve vazar
+     * quantos bytes bateram.
+     */
+    private safeEquals;
+    /** Abre o pareamento. Chamado pelo navegador, que já está autenticado. */
+    start(params: {
+        userId: number;
+        authTokenHash: string;
+        clientId: string;
+        ipAddress: string;
+        userAgent: string;
+    }): Promise<{
+        id: string;
+        expiresAt: string;
+    }>;
+    /** Estado para a tela do navegador, incluindo quem reivindicou. */
+    status(userId: number, id: string): Promise<{
+        status: string;
+        claim: {
+            ip: string;
+            userAgent: string;
+            at: string;
+        };
+        expiresAt: string;
+    }>;
+    private deriveStatus;
+    /**
+     * O aparelho que leu o QR se anuncia. Não recebe nada além de "aguarde": é
+     * este passo que transforma uma foto do QR num alerta na tela da vítima em vez
+     * de um comprometimento silencioso.
+     */
+    claim(params: {
+        authToken: string;
+        clientId: string;
+        ipAddress: string;
+        userAgent: string;
+    }): Promise<{
+        status: string;
+        expiresAt: string;
+    }>;
+    /** O navegador aprova o aparelho e só então entrega o blob cifrado. */
+    confirm(params: {
+        userId: number;
+        id: string;
+        payloadEnc: string;
+    }): Promise<{
+        status: string;
+    }>;
+    /** "Rejeitar", fechar o diálogo, ou regerar o QR. */
+    cancel(userId: number, id: string): Promise<{
+        status: string;
+    }>;
+    /**
+     * O aparelho resgata. Antes de confirmado devolve `pending` SEM consumir — do
+     * contrário o primeiro poll queimaria o registro e a aprovação chegaria tarde
+     * demais.
+     */
+    redeem(params: {
+        authToken: string;
+        clientId: string;
+        locale: string;
+        ipAddress: string;
+        userAgent: string;
+    }): Promise<{
+        status: "pending";
+        accessToken?: undefined;
+        refreshToken?: undefined;
+        tokenType?: undefined;
+        expiresIn?: undefined;
+        payload?: undefined;
+    } | {
+        status: "confirmed";
+        accessToken: string;
+        refreshToken: string;
+        tokenType: string;
+        expiresIn: number;
+        payload: string;
+    }>;
+    /**
+     * O navegador que QUER acesso abre o pareamento. Público: o caso principal é
+     * um computador onde ninguém está logado. O registro nasce sem dono.
+     */
+    startReverse(params: {
+        pollHash: string;
+        ephPublicKey: string;
+        wantSession: boolean;
+        clientId: string;
+        ipAddress: string;
+        userAgent: string;
+    }): Promise<{
+        id: string;
+        expiresAt: string;
+    }>;
+    /**
+     * Metadados do navegador que pediu, para o aparelho decidir se aprova.
+     *
+     * Exige a pública efêmera como prova de que quem pergunta leu mesmo o QR: o
+     * `id` é sequencial, e sem essa prova qualquer usuário autenticado poderia
+     * varrer os ids e descobrir de que IP alguém está tentando entrar.
+     */
+    getReverseRequest(id: string, ephPublicKey: string): Promise<{
+        issuedIp: string;
+        issuedUserAgent: string;
+        ephPublicKey: string;
+        wantSession: boolean;
+        expiresAt: string;
+    }>;
+    /** O aparelho autenticado aprova e entrega o blob cifrado para a efêmera. */
+    approveReverse(params: {
+        userId: number;
+        id: string;
+        ephPublicKey: string;
+        payloadEnc: string;
+    }): Promise<{
+        status: string;
+    }>;
+    rejectReverse(params: {
+        userId: number;
+        id: string;
+        ephPublicKey: string;
+    }): Promise<{
+        status: string;
+    }>;
+    /**
+     * O navegador pergunta se já foi aprovado. Enquanto não, devolve `pending` sem
+     * consumir. A sessão, quando pedida, nasce com o IP e o user-agent do
+     * NAVEGADOR — é ele quem vai usá-la, não o celular que aprovou.
+     */
+    pollReverse(params: {
+        pollToken: string;
+        locale: string;
+    }): Promise<{
+        status: "pending";
+        claimed: boolean;
+        payload?: undefined;
+        accessToken?: undefined;
+        refreshToken?: undefined;
+        session?: undefined;
+        tokenType?: undefined;
+        expiresIn?: undefined;
+    } | {
+        status: "confirmed";
+        payload: string;
+        claimed?: undefined;
+        accessToken?: undefined;
+        refreshToken?: undefined;
+        session?: undefined;
+        tokenType?: undefined;
+        expiresIn?: undefined;
+    } | {
+        status: "confirmed";
+        payload: string;
+        accessToken: string;
+        refreshToken: string;
+        session: {
+            id: number;
+            user_id: number;
+            user_agent: string;
+            created_at: Date;
+            impersonator_user_id: number | null;
+            updated_at: Date;
+            hash: string;
+            ip_address: string;
+            revoked_at: Date | null;
+            expires_at: Date;
+            browser_id: string | null;
+            impersonation_reason: string | null;
+        };
+        tokenType: string;
+        expiresIn: number;
+        claimed?: undefined;
+    }>;
+    /**
+     * Os registros são minúsculos e de vida curta, mas nada os apagava — mesmo
+     * buraco que `oauth_authorization_code` tem. Sem isto, ciphertext aprovado e
+     * nunca resgatado ficaria no banco para sempre.
+     */
+    purgeExpired(): Promise<void>;
+}
+//# sourceMappingURL=pairing.service.d.ts.map

package/dist/pairing/pairing.service.d.ts.map

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