hunter-mate 0.1.6 → 0.1.8

package/dist/assets/server/governance/governance.controller.d.ts

@@ -0,0 +1,14 @@
+import { GovernanceService, RecordActionDto } from './governance.service';
+import { GovernanceActionType } from './action-audit.entity';
+export declare class GovernanceController {
+    private readonly service;
+    constructor(service: GovernanceService);
+    record(dto: RecordActionDto): Promise<import("./action-audit.entity").ActionAudit>;
+    check(body: {
+        site: string;
+        accountType: string;
+        actionType: GovernanceActionType;
+        harnessPath?: string;
+    }): Promise<import("./governance.service").GovernanceCheckResult>;
+    status(site: string, accountType: string, harnessPath?: string): Promise<import("./governance.service").GovernanceStatusResult>;
+}

package/dist/assets/server/governance/governance.controller.js

@@ -0,0 +1,77 @@
+"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); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GovernanceController = void 0;
+const common_1 = require("@nestjs/common");
+const governance_service_1 = require("./governance.service");
+const ACTION_TYPES = ['profile_view', 'search_run', 'invite', 'page_scroll'];
+let GovernanceController = class GovernanceController {
+    service;
+    constructor(service) {
+        this.service = service;
+    }
+    async record(dto) {
+        if (!dto?.site || !dto?.accountType || !dto?.sessionId) {
+            throw new common_1.BadRequestException('site/accountType/sessionId required');
+        }
+        if (!ACTION_TYPES.includes(dto.actionType)) {
+            throw new common_1.BadRequestException(`actionType 必须是 ${ACTION_TYPES.join('/')} 之一`);
+        }
+        return this.service.record(dto);
+    }
+    check(body) {
+        if (!body?.site || !body?.accountType || !body?.actionType) {
+            throw new common_1.BadRequestException('site/accountType/actionType required');
+        }
+        if (!ACTION_TYPES.includes(body.actionType)) {
+            throw new common_1.BadRequestException(`actionType 必须是 ${ACTION_TYPES.join('/')} 之一`);
+        }
+        return this.service.check(body.site, body.accountType, body.actionType, body.harnessPath);
+    }
+    status(site, accountType, harnessPath) {
+        if (!site || !accountType) {
+            throw new common_1.BadRequestException('site/accountType query required');
+        }
+        return this.service.status(site, accountType, harnessPath);
+    }
+};
+exports.GovernanceController = GovernanceController;
+__decorate([
+    (0, common_1.Post)('record'),
+    __param(0, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], GovernanceController.prototype, "record", null);
+__decorate([
+    (0, common_1.Post)('check'),
+    __param(0, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], GovernanceController.prototype, "check", null);
+__decorate([
+    (0, common_1.Get)('status'),
+    __param(0, (0, common_1.Query)('site')),
+    __param(1, (0, common_1.Query)('accountType')),
+    __param(2, (0, common_1.Query)('harnessPath')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String]),
+    __metadata("design:returntype", void 0)
+], GovernanceController.prototype, "status", null);
+exports.GovernanceController = GovernanceController = __decorate([
+    (0, common_1.Controller)('governance'),
+    __metadata("design:paramtypes", [governance_service_1.GovernanceService])
+], GovernanceController);
+//# sourceMappingURL=governance.controller.js.map

package/dist/assets/server/governance/governance.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.controller.js","sourceRoot":"","sources":["../../src/governance/governance.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAyF;AACzF,6DAG8B;AAG9B,MAAM,YAAY,GAA2B,CAAC,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AAU9F,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IACF;IAA7B,YAA6B,OAA0B;QAA1B,YAAO,GAAP,OAAO,CAAmB;IAAG,CAAC;IAGrD,AAAN,KAAK,CAAC,MAAM,CAAS,GAAoB;QACvC,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC;YACvD,MAAM,IAAI,4BAAmB,CAAC,qCAAqC,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,4BAAmB,CAAC,kBAAkB,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAGD,KAAK,CAEH,IAAmG;QAEnG,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC;YAC3D,MAAM,IAAI,4BAAmB,CAAC,sCAAsC,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,4BAAmB,CAAC,kBAAkB,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5F,CAAC;IAGD,MAAM,CACW,IAAY,EACL,WAAmB,EACnB,WAAoB;QAE1C,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1B,MAAM,IAAI,4BAAmB,CAAC,iCAAiC,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IAC7D,CAAC;CACF,CAAA;AAvCY,oDAAoB;AAIzB;IADL,IAAA,aAAI,EAAC,QAAQ,CAAC;IACD,WAAA,IAAA,aAAI,GAAE,CAAA;;;;kDAQnB;AAGD;IADC,IAAA,aAAI,EAAC,OAAO,CAAC;IAEX,WAAA,IAAA,aAAI,GAAE,CAAA;;;;iDAUR;AAGD;IADC,IAAA,YAAG,EAAC,QAAQ,CAAC;IAEX,WAAA,IAAA,cAAK,EAAC,MAAM,CAAC,CAAA;IACb,WAAA,IAAA,cAAK,EAAC,aAAa,CAAC,CAAA;IACpB,WAAA,IAAA,cAAK,EAAC,aAAa,CAAC,CAAA;;;;kDAMtB;+BAtCU,oBAAoB;IADhC,IAAA,mBAAU,EAAC,YAAY,CAAC;qCAEe,sCAAiB;GAD5C,oBAAoB,CAuChC"}

package/dist/assets/server/governance/governance.ingester.d.ts

@@ -0,0 +1,20 @@
+import { OnModuleInit } from '@nestjs/common';
+import { Repository } from 'typeorm';
+import { RecordingEventBus } from '../recording/recording-event-bus.service';
+import { RecordingEvent } from '../recording/entities/recording-event.entity';
+import { ActionAudit } from './action-audit.entity';
+import { GovernanceService } from './governance.service';
+export interface RecordingEventsPersistedEvent {
+    entities: RecordingEvent[];
+}
+export declare class GovernanceIngester implements OnModuleInit {
+    private readonly eventBus;
+    private readonly governanceService;
+    private readonly auditRepo;
+    private readonly logger;
+    private lastUrlBySession;
+    constructor(eventBus: RecordingEventBus, governanceService: GovernanceService, auditRepo: Repository<ActionAudit>);
+    onModuleInit(): void;
+    ingest(events: RecordingEvent[]): Promise<number>;
+    private setLastUrl;
+}

package/dist/assets/server/governance/governance.ingester.js

@@ -0,0 +1,114 @@
+"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 GovernanceIngester_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GovernanceIngester = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const typeorm_2 = require("typeorm");
+const recording_event_bus_service_1 = require("../recording/recording-event-bus.service");
+const action_audit_entity_1 = require("./action-audit.entity");
+const governance_service_1 = require("./governance.service");
+const DERIVABLE_ACTIONS = new Set([
+    'profile_view',
+    'search_run',
+    'invite',
+    'note_invite',
+    'page_scroll',
+]);
+const MAX_SESSION_MEMORY = 5000;
+let GovernanceIngester = GovernanceIngester_1 = class GovernanceIngester {
+    eventBus;
+    governanceService;
+    auditRepo;
+    logger = new common_1.Logger(GovernanceIngester_1.name);
+    lastUrlBySession = new Map();
+    constructor(eventBus, governanceService, auditRepo) {
+        this.eventBus = eventBus;
+        this.governanceService = governanceService;
+        this.auditRepo = auditRepo;
+    }
+    onModuleInit() {
+        this.eventBus.on('recording.events.persisted', (evt) => {
+            this.ingest(evt.entities).catch((err) => {
+                this.logger.warn(`governance ingest 失败: ${err?.message || err}`);
+            });
+        });
+    }
+    async ingest(events) {
+        let derived = 0;
+        for (const e of events) {
+            if (!e.sourceUrl)
+                continue;
+            const last = this.lastUrlBySession.get(e.sessionId);
+            if (last === e.sourceUrl)
+                continue;
+            this.setLastUrl(e.sessionId, e.sourceUrl);
+            let url;
+            try {
+                url = new URL(e.sourceUrl);
+            }
+            catch {
+                continue;
+            }
+            const host = url.hostname.toLowerCase();
+            const profile = this.governanceService.loadProfile(host);
+            if (!profile?.account_type)
+                continue;
+            const rules = this.governanceService.loadActionDerivation(host);
+            if (!rules)
+                continue;
+            const target = `${url.pathname}${url.search}`;
+            for (const rule of rules) {
+                if (!DERIVABLE_ACTIONS.has(rule.action))
+                    continue;
+                let re;
+                try {
+                    re = new RegExp(rule.path_pattern);
+                }
+                catch {
+                    this.logger.warn(`非法 path_pattern 跳过: ${rule.path_pattern}`);
+                    continue;
+                }
+                if (!re.test(target))
+                    continue;
+                await this.auditRepo.save(this.auditRepo.create({
+                    site: profile.site,
+                    accountType: profile.account_type,
+                    actionType: rule.action,
+                    sessionId: e.sessionId,
+                    tabId: e.tabId != null ? String(e.tabId) : null,
+                    detail: JSON.stringify({ derivedFrom: 'recording', url: e.sourceUrl }),
+                }));
+                derived++;
+                break;
+            }
+        }
+        return derived;
+    }
+    setLastUrl(sessionId, url) {
+        if (this.lastUrlBySession.size >= MAX_SESSION_MEMORY)
+            this.lastUrlBySession.clear();
+        this.lastUrlBySession.set(sessionId, url);
+    }
+};
+exports.GovernanceIngester = GovernanceIngester;
+exports.GovernanceIngester = GovernanceIngester = GovernanceIngester_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(2, (0, typeorm_1.InjectRepository)(action_audit_entity_1.ActionAudit)),
+    __metadata("design:paramtypes", [recording_event_bus_service_1.RecordingEventBus,
+        governance_service_1.GovernanceService,
+        typeorm_2.Repository])
+], GovernanceIngester);
+//# sourceMappingURL=governance.ingester.js.map

package/dist/assets/server/governance/governance.ingester.js.map

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

package/dist/assets/server/governance/governance.module.d.ts

@@ -0,0 +1,2 @@
+export declare class GovernanceModule {
+}

package/dist/assets/server/governance/governance.module.js

@@ -0,0 +1,26 @@
+"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.GovernanceModule = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const action_audit_entity_1 = require("./action-audit.entity");
+const governance_service_1 = require("./governance.service");
+const governance_controller_1 = require("./governance.controller");
+let GovernanceModule = class GovernanceModule {
+};
+exports.GovernanceModule = GovernanceModule;
+exports.GovernanceModule = GovernanceModule = __decorate([
+    (0, common_1.Module)({
+        imports: [typeorm_1.TypeOrmModule.forFeature([action_audit_entity_1.ActionAudit])],
+        controllers: [governance_controller_1.GovernanceController],
+        providers: [governance_service_1.GovernanceService],
+        exports: [governance_service_1.GovernanceService],
+    })
+], GovernanceModule);
+//# sourceMappingURL=governance.module.js.map

package/dist/assets/server/governance/governance.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.module.js","sourceRoot":"","sources":["../../src/governance/governance.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,6CAAgD;AAChD,+DAAoD;AACpD,6DAAyD;AACzD,mEAA+D;AAQxD,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAAG,CAAA;AAAnB,4CAAgB;2BAAhB,gBAAgB;IAN5B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,uBAAa,CAAC,UAAU,CAAC,CAAC,iCAAW,CAAC,CAAC,CAAC;QAClD,WAAW,EAAE,CAAC,4CAAoB,CAAC;QACnC,SAAS,EAAE,CAAC,sCAAiB,CAAC;QAC9B,OAAO,EAAE,CAAC,sCAAiB,CAAC;KAC7B,CAAC;GACW,gBAAgB,CAAG"}

package/dist/assets/server/governance/governance.service.d.ts

@@ -0,0 +1,114 @@
+import { Repository } from 'typeorm';
+import { ActionAudit, GovernanceActionType } from './action-audit.entity';
+export interface RiskQuotaLimit {
+    per_hour?: number;
+    per_day?: number;
+    per_week?: number;
+    per_month?: number;
+    source?: string;
+    confidence?: string;
+}
+export interface RiskSchedule {
+    work_hours_local: [number, number];
+    off_hours_multiplier: number;
+    marathon_session_min: number;
+    advisory_escalation: number;
+}
+export interface RiskPacing {
+    min_action_gap_ms: [number, number];
+    scroll_per_screen_ms: [number, number];
+    page_turn_gap_ms: [number, number];
+}
+export interface RiskHardRules {
+    forbid_api_interception: boolean;
+    forbid_cdp_navigation: boolean;
+    forbid_headless: boolean;
+    captcha_manual_only: boolean;
+}
+export interface RiskStopCode {
+    code: string;
+    dom_signals?: string[];
+    response_signals?: string[];
+    action?: string;
+}
+export interface RiskProfile {
+    site: string;
+    version?: string;
+    account_type?: string;
+    account_quotas: Record<string, Record<string, RiskQuotaLimit>>;
+    schedule: RiskSchedule;
+    pacing: RiskPacing;
+    hard_rules: RiskHardRules;
+    stop_codes?: RiskStopCode[];
+}
+export interface ActionDerivationRule {
+    action: string;
+    path_pattern: string;
+}
+export interface RecordActionDto {
+    site: string;
+    accountType: string;
+    actionType: GovernanceActionType;
+    sessionId: string;
+    tabId?: string | null;
+    detail?: unknown;
+    stopCode?: string | null;
+}
+export interface UsageWindow {
+    window: 'hour' | 'day' | 'week' | 'month';
+    used: number;
+    limit: number | null;
+}
+export interface GovernanceAdvisory {
+    offHours: boolean;
+    marathonMinutes: number;
+    gapMs: number;
+}
+export interface GovernanceCheckResult {
+    allowed: boolean;
+    reason?: string;
+    nextAllowedAt?: string;
+    usage: UsageWindow[];
+    advisory?: GovernanceAdvisory;
+}
+export interface GovernanceStatusResult {
+    available: boolean;
+    reason?: string;
+    site: string;
+    accountType: string;
+    actions: Array<{
+        actionType: string;
+        usage: UsageWindow[];
+        basis?: {
+            source?: string;
+            confidence?: string;
+        };
+    }>;
+    advisory: GovernanceAdvisory;
+}
+export declare const RISK_PROFILE_UNAVAILABLE = "risk_profile_unavailable";
+export declare class GovernanceService {
+    private readonly auditRepo;
+    private readonly logger;
+    private readonly profileCache;
+    private readonly derivationCache;
+    constructor(auditRepo: Repository<ActionAudit>);
+    record(dto: RecordActionDto): Promise<ActionAudit>;
+    check(site: string, accountType: string, actionType: GovernanceActionType, harnessPath?: string): Promise<GovernanceCheckResult>;
+    status(site: string, accountType: string, harnessPath?: string): Promise<GovernanceStatusResult>;
+    private windowUsage;
+    private countSince;
+    private buildAdvisory;
+    private marathonMinutesSince;
+    sampleGap(profile: RiskProfile, offHours: boolean, marathonMinutes?: number): number;
+    resolveHarnessPath(harnessPath?: string): string | null;
+    loadProfile(site: string, harnessPath?: string): RiskProfile | null;
+    loadActionDerivation(site: string, harnessPath?: string): ActionDerivationRule[] | null;
+    private resolveRiskProfileRef;
+    clearProfileCache(): void;
+}
+export declare function assertHardRules(profile: RiskProfile, site: string): void;
+export declare function startOfHour(d: Date): Date;
+export declare function startOfDay(d: Date): Date;
+export declare function startOfWeek(d: Date): Date;
+export declare function startOfMonth(d: Date): Date;