@develler/remediation-agent 1.0.2

package/dist/services/AstExtractorService.js

@@ -0,0 +1,166 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AstExtractorService = void 0;
+const fs = __importStar(require("fs"));
+const logger_js_1 = require("../logger.js");
+/**
+ * AST-based extractor for TypeScript/JavaScript source files.
+ *
+ * Uses the TypeScript compiler API (the same `typescript` package that's
+ * already present in any TS project) to locate and extract symbol source.
+ * Falls back to a regex-based line scanner when the TS compiler is not
+ * available (plain JS projects or environments without `typescript`).
+ */
+class AstExtractorService {
+    extract(absoluteFilePath, target) {
+        if (!fs.existsSync(absoluteFilePath)) {
+            logger_js_1.logger.warn('AstExtractor: file not found.', { filePath: absoluteFilePath });
+            return null;
+        }
+        try {
+            return this.extractWithTs(absoluteFilePath, target);
+        }
+        catch (err) {
+            logger_js_1.logger.warn('AstExtractor: TS compiler unavailable, falling back to line scanner.', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return this.extractWithLineScan(absoluteFilePath, target);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // TypeScript Compiler API extraction
+    // ---------------------------------------------------------------------------
+    extractWithTs(filePath, target) {
+        // Dynamic require — typescript is a peer/devDep, not a runtime dep.
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const ts = require('typescript');
+        const sourceText = fs.readFileSync(filePath, 'utf8');
+        const sourceFile = ts.createSourceFile(filePath, sourceText, ts.ScriptTarget.Latest, true);
+        const lines = sourceText.split('\n');
+        const found = this.findNode(ts, sourceFile, target);
+        if (!found)
+            return null;
+        const { node, startLine, endLine } = found;
+        const sourceCode = lines.slice(startLine - 1, endLine).join('\n');
+        const docBlock = this.extractDocBlock(sourceText, node, ts, sourceFile);
+        return {
+            filePath,
+            startLine,
+            endLine,
+            sourceCode,
+            symbolName: target.symbolName,
+            symbolType: target.symbolType,
+            docBlock,
+        };
+    }
+    findNode(ts, sourceFile, target) {
+        let result = null;
+        const visit = (node) => {
+            if (result)
+                return;
+            if (target.symbolType === 'function' || target.symbolType === 'method') {
+                if ((ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node) || ts.isArrowFunction(node)) &&
+                    ts.isIdentifier(node.name ?? {}) &&
+                    node.name.text === target.symbolName) {
+                    result = this.nodePosition(ts, sourceFile, node);
+                    return;
+                }
+            }
+            if (target.symbolType === 'class') {
+                if (ts.isClassDeclaration(node) &&
+                    node.name?.text === target.symbolName) {
+                    result = this.nodePosition(ts, sourceFile, node);
+                    return;
+                }
+            }
+            ts.forEachChild(node, visit);
+        };
+        ts.forEachChild(sourceFile, visit);
+        return result;
+    }
+    nodePosition(ts, sourceFile, node) {
+        const start = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
+        const end = sourceFile.getLineAndCharacterOfPosition(node.getEnd());
+        return {
+            node,
+            startLine: start.line + 1,
+            endLine: end.line + 1,
+        };
+    }
+    extractDocBlock(sourceText, node, ts, sourceFile) {
+        const nodeStart = node.getFullStart();
+        const preceding = sourceText.slice(Math.max(0, nodeStart - 500), nodeStart);
+        const match = preceding.match(/\/\*\*[\s\S]*?\*\/\s*$/);
+        return match ? match[0].trim() : null;
+    }
+    // ---------------------------------------------------------------------------
+    // Fallback: line scanner (regex-based, no AST)
+    // ---------------------------------------------------------------------------
+    extractWithLineScan(filePath, target) {
+        const lines = fs.readFileSync(filePath, 'utf8').split('\n');
+        // Find the first line matching the symbol name.
+        const startIdx = lines.findIndex((line) => line.includes(target.symbolName) &&
+            (line.includes('function') || line.includes('class') || line.includes('=>') || line.includes('(')));
+        if (startIdx === -1)
+            return null;
+        // Walk forward to find the closing brace using a simple depth counter.
+        let depth = 0;
+        let endIdx = startIdx;
+        for (let i = startIdx; i < lines.length; i++) {
+            for (const ch of lines[i] ?? '') {
+                if (ch === '{')
+                    depth++;
+                else if (ch === '}')
+                    depth--;
+            }
+            endIdx = i;
+            if (depth === 0 && i > startIdx)
+                break;
+        }
+        const sourceCode = lines.slice(startIdx, endIdx + 1).join('\n');
+        return {
+            filePath,
+            startLine: startIdx + 1,
+            endLine: endIdx + 1,
+            sourceCode,
+            symbolName: target.symbolName,
+            symbolType: target.symbolType,
+            docBlock: null,
+        };
+    }
+}
+exports.AstExtractorService = AstExtractorService;
+//# sourceMappingURL=AstExtractorService.js.map

package/dist/services/AstExtractorService.js.map

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

package/dist/services/CircuitBreakerService.d.ts

@@ -0,0 +1,29 @@
+import type { Redis } from 'ioredis';
+/**
+ * Three-state circuit breaker: CLOSED → OPEN → HALF-OPEN → CLOSED.
+ *
+ * Exact behavioural equivalent of the PHP CircuitBreakerService.
+ * State is stored in Redis with a configurable TTL so it auto-resets.
+ *
+ * Node.js-specific: when Redis itself is unavailable we fall back to a
+ * module-level in-process flag cleared via setTimeout (single-threaded
+ * event loop — no locking needed, unlike PHP-FPM per-request processes).
+ */
+export declare class CircuitBreakerService {
+    private readonly redis;
+    private readonly clientId;
+    private readonly redisKey;
+    private readonly ttlSeconds;
+    private static inProcessOpen;
+    private static resetTimer;
+    constructor(redis: Redis, clientId: string, ttlSeconds: number);
+    /**
+     * Returns true when the breaker is OPEN — all interception must be skipped.
+     * If Redis is down, trips in-process and returns true.
+     */
+    isOpen(): Promise<boolean>;
+    trip(reason: Error): Promise<void>;
+    reset(): Promise<void>;
+    private tripInProcess;
+}
+//# sourceMappingURL=CircuitBreakerService.d.ts.map

package/dist/services/CircuitBreakerService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CircuitBreakerService.d.ts","sourceRoot":"","sources":["../../src/services/CircuitBreakerService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGrC;;;;;;;;;GASG;AACH,qBAAa,qBAAqB;IAS9B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAT3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAGpC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAS;IACrC,OAAO,CAAC,MAAM,CAAC,UAAU,CAA8C;gBAGpD,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM,EACjC,UAAU,EAAE,MAAM;IAMpB;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAa1B,IAAI,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B,OAAO,CAAC,aAAa;CAgBtB"}

package/dist/services/CircuitBreakerService.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreakerService = void 0;
+const logger_js_1 = require("../logger.js");
+/**
+ * Three-state circuit breaker: CLOSED → OPEN → HALF-OPEN → CLOSED.
+ *
+ * Exact behavioural equivalent of the PHP CircuitBreakerService.
+ * State is stored in Redis with a configurable TTL so it auto-resets.
+ *
+ * Node.js-specific: when Redis itself is unavailable we fall back to a
+ * module-level in-process flag cleared via setTimeout (single-threaded
+ * event loop — no locking needed, unlike PHP-FPM per-request processes).
+ */
+class CircuitBreakerService {
+    redis;
+    clientId;
+    redisKey;
+    ttlSeconds;
+    // Module-level state survives across requests in a single Node.js process.
+    static inProcessOpen = false;
+    static resetTimer = null;
+    constructor(redis, clientId, ttlSeconds) {
+        this.redis = redis;
+        this.clientId = clientId;
+        this.redisKey = `remediation:circuit_breaker:${clientId}`;
+        this.ttlSeconds = ttlSeconds;
+    }
+    /**
+     * Returns true when the breaker is OPEN — all interception must be skipped.
+     * If Redis is down, trips in-process and returns true.
+     */
+    async isOpen() {
+        if (CircuitBreakerService.inProcessOpen)
+            return true;
+        try {
+            const exists = await this.redis.exists(this.redisKey);
+            return exists === 1;
+        }
+        catch {
+            // Redis unavailable — open in-process and protect production.
+            this.tripInProcess(new Error('Redis unavailable during isOpen check'));
+            return true;
+        }
+    }
+    async trip(reason) {
+        logger_js_1.logger.error('RemediationEngine circuit breaker tripped.', {
+            reason: reason.message,
+            name: reason.name,
+        });
+        const payload = JSON.stringify({
+            state: 'open',
+            tripped_at: Math.floor(Date.now() / 1000),
+            reason: reason.message,
+        });
+        try {
+            await this.redis.set(this.redisKey, payload, 'EX', this.ttlSeconds);
+        }
+        catch {
+            // Redis is the problem — fall back to in-process.
+            this.tripInProcess(reason);
+        }
+    }
+    async reset() {
+        CircuitBreakerService.inProcessOpen = false;
+        if (CircuitBreakerService.resetTimer !== null) {
+            clearTimeout(CircuitBreakerService.resetTimer);
+            CircuitBreakerService.resetTimer = null;
+        }
+        try {
+            await this.redis.del(this.redisKey);
+        }
+        catch {
+            // Ignore — key will expire on its own.
+        }
+    }
+    // ---------------------------------------------------------------------------
+    tripInProcess(reason) {
+        CircuitBreakerService.inProcessOpen = true;
+        logger_js_1.logger.warn('RemediationEngine: using in-process circuit breaker fallback.', {
+            reason: reason.message,
+        });
+        if (CircuitBreakerService.resetTimer !== null) {
+            clearTimeout(CircuitBreakerService.resetTimer);
+        }
+        CircuitBreakerService.resetTimer = setTimeout(() => {
+            CircuitBreakerService.inProcessOpen = false;
+            CircuitBreakerService.resetTimer = null;
+        }, this.ttlSeconds * 1000);
+    }
+}
+exports.CircuitBreakerService = CircuitBreakerService;
+//# sourceMappingURL=CircuitBreakerService.js.map

package/dist/services/CircuitBreakerService.js.map

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

package/dist/services/InstructionCacheService.d.ts

@@ -0,0 +1,28 @@
+import type { Redis } from 'ioredis';
+import { InstructionCollection, RuntimeInstruction } from '../types/instructions.js';
+/**
+ * Reads and writes RuntimeInstructions from/to Redis.
+ *
+ * Exact equivalent of the PHP InstructionCacheService.
+ * Key strategy: one STRING key per instruction with its own TTL, plus a SET
+ * index so getActive() can SMEMBERS → MGET in two roundtrips.
+ *
+ * Namespace:
+ *   remediation:instruction:{clientId}:{instructionId}  → JSON string
+ *   remediation:active:{clientId}                       → SET of instruction IDs
+ */
+export declare class InstructionCacheService {
+    private readonly redis;
+    private readonly clientId;
+    private readonly indexKey;
+    constructor(redis: Redis, clientId: string);
+    store(instruction: RuntimeInstruction): Promise<void>;
+    /**
+     * Return all currently active instructions.
+     * Two roundtrips: SMEMBERS → MGET. <1ms on a local socket.
+     */
+    getActive(): Promise<InstructionCollection>;
+    evict(instructionId: string): Promise<void>;
+    private instructionKey;
+}
+//# sourceMappingURL=InstructionCacheService.d.ts.map

package/dist/services/InstructionCacheService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstructionCacheService.d.ts","sourceRoot":"","sources":["../../src/services/InstructionCacheService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAErF;;;;;;;;;;GAUG;AACH,qBAAa,uBAAuB;IAIhC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAGf,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM;IAK7B,KAAK,CAAC,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3D;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAqC3C,KAAK,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjD,OAAO,CAAC,cAAc;CAGvB"}

package/dist/services/InstructionCacheService.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstructionCacheService = void 0;
+const instructions_js_1 = require("../types/instructions.js");
+/**
+ * Reads and writes RuntimeInstructions from/to Redis.
+ *
+ * Exact equivalent of the PHP InstructionCacheService.
+ * Key strategy: one STRING key per instruction with its own TTL, plus a SET
+ * index so getActive() can SMEMBERS → MGET in two roundtrips.
+ *
+ * Namespace:
+ *   remediation:instruction:{clientId}:{instructionId}  → JSON string
+ *   remediation:active:{clientId}                       → SET of instruction IDs
+ */
+class InstructionCacheService {
+    redis;
+    clientId;
+    indexKey;
+    constructor(redis, clientId) {
+        this.redis = redis;
+        this.clientId = clientId;
+        this.indexKey = `remediation:active:${clientId}`;
+    }
+    async store(instruction) {
+        const ttl = Math.max(1, instruction.expiresAt - Math.floor(Date.now() / 1000));
+        const key = this.instructionKey(instruction.instructionId);
+        await this.redis.set(key, JSON.stringify(instruction.toJSON()), 'EX', ttl);
+        await this.redis.sadd(this.indexKey, instruction.instructionId);
+        // Extend index TTL to at least match the instruction's TTL.
+        const currentTtl = await this.redis.ttl(this.indexKey);
+        if (currentTtl < ttl) {
+            await this.redis.expire(this.indexKey, ttl + 60);
+        }
+    }
+    /**
+     * Return all currently active instructions.
+     * Two roundtrips: SMEMBERS → MGET. <1ms on a local socket.
+     */
+    async getActive() {
+        const ids = await this.redis.smembers(this.indexKey);
+        if (ids.length === 0)
+            return instructions_js_1.InstructionCollection.empty();
+        const keys = ids.map((id) => this.instructionKey(id));
+        const values = await this.redis.mget(...keys);
+        const instructions = [];
+        const staleIds = [];
+        for (let i = 0; i < ids.length; i++) {
+            const json = values[i];
+            if (json == null) {
+                staleIds.push(ids[i]);
+                continue;
+            }
+            try {
+                const raw = JSON.parse(json);
+                const instruction = instructions_js_1.RuntimeInstruction.fromJSON(raw);
+                if (instruction.isEffective()) {
+                    instructions.push(instruction);
+                }
+            }
+            catch {
+                staleIds.push(ids[i]);
+            }
+        }
+        if (staleIds.length > 0) {
+            await this.redis.srem(this.indexKey, ...staleIds);
+        }
+        return new instructions_js_1.InstructionCollection(instructions);
+    }
+    async evict(instructionId) {
+        await this.redis.del(this.instructionKey(instructionId));
+        await this.redis.srem(this.indexKey, instructionId);
+    }
+    instructionKey(instructionId) {
+        return `remediation:instruction:${this.clientId}:${instructionId}`;
+    }
+}
+exports.InstructionCacheService = InstructionCacheService;
+//# sourceMappingURL=InstructionCacheService.js.map

package/dist/services/InstructionCacheService.js.map

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

package/dist/services/MaskingEngine.d.ts

@@ -0,0 +1,27 @@
+import type { MaskRule } from '../types/instructions.js';
+/**
+ * Pure stateless masking engine — no I/O, no Redis, no logging.
+ * Byte-for-byte logic equivalent of the PHP MaskingEngine.
+ *
+ * Applies PII masking rules via deep recursive traversal of an arbitrary
+ * data structure. All mutations happen on a deep clone (JSON round-trip);
+ * the original is never touched until the full masked copy is ready.
+ *
+ * Supported strategies:
+ *   partial_last4      — keeps last 4 digits, masks the rest (phone numbers)
+ *   email_domain_only  — masks local part, keeps @domain
+ *   last4_only         — keeps last 4 digits only (credit cards)
+ *   full_redact        — replaces value with '[REDACTED]'
+ *   hash_stable        — deterministic SHA-256 truncated to 16 hex chars
+ */
+export declare class MaskingEngine {
+    private static readonly MAX_DEPTH;
+    apply(data: unknown, rules: MaskRule[]): unknown;
+    private traverse;
+    private findMatchingRule;
+    private maskValue;
+    private maskPartialLast4;
+    private maskEmailDomainOnly;
+    private maskLast4Only;
+}
+//# sourceMappingURL=MaskingEngine.d.ts.map

package/dist/services/MaskingEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaskingEngine.d.ts","sourceRoot":"","sources":["../../src/services/MaskingEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGzD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAM;IAEvC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO;IAQhD,OAAO,CAAC,QAAQ;IA0BhB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,aAAa;CAKtB"}

package/dist/services/MaskingEngine.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MaskingEngine = void 0;
+const crypto_1 = require("crypto");
+/**
+ * Pure stateless masking engine — no I/O, no Redis, no logging.
+ * Byte-for-byte logic equivalent of the PHP MaskingEngine.
+ *
+ * Applies PII masking rules via deep recursive traversal of an arbitrary
+ * data structure. All mutations happen on a deep clone (JSON round-trip);
+ * the original is never touched until the full masked copy is ready.
+ *
+ * Supported strategies:
+ *   partial_last4      — keeps last 4 digits, masks the rest (phone numbers)
+ *   email_domain_only  — masks local part, keeps @domain
+ *   last4_only         — keeps last 4 digits only (credit cards)
+ *   full_redact        — replaces value with '[REDACTED]'
+ *   hash_stable        — deterministic SHA-256 truncated to 16 hex chars
+ */
+class MaskingEngine {
+    static MAX_DEPTH = 20;
+    apply(data, rules) {
+        if (rules.length === 0)
+            return data;
+        // Deep clone via JSON round-trip — matches PHP behaviour exactly.
+        const clone = JSON.parse(JSON.stringify(data));
+        return this.traverse(clone, rules, 0);
+    }
+    traverse(data, rules, depth) {
+        if (depth > MaskingEngine.MAX_DEPTH)
+            return data;
+        if (typeof data !== 'object' || data === null || Array.isArray(data)) {
+            // Arrays: recurse into elements without key matching.
+            if (Array.isArray(data)) {
+                return data.map((item) => this.traverse(item, rules, depth + 1));
+            }
+            return data;
+        }
+        const obj = data;
+        for (const key of Object.keys(obj)) {
+            const value = obj[key];
+            const matchedRule = this.findMatchingRule(key, rules);
+            if (matchedRule !== null && value !== null && typeof value !== 'object') {
+                obj[key] = this.maskValue(String(value), matchedRule);
+            }
+            else if (typeof value === 'object' && value !== null) {
+                obj[key] = this.traverse(value, rules, depth + 1);
+            }
+        }
+        return obj;
+    }
+    findMatchingRule(key, rules) {
+        for (const rule of rules) {
+            if (rule.matchesKey(key))
+                return rule;
+        }
+        return null;
+    }
+    maskValue(value, rule) {
+        switch (rule.maskStrategy) {
+            case 'partial_last4': return this.maskPartialLast4(value, rule.maskChar, rule.separator);
+            case 'email_domain_only': return this.maskEmailDomainOnly(value);
+            case 'last4_only': return this.maskLast4Only(value, rule.maskChar);
+            case 'full_redact': return '[REDACTED]';
+            case 'hash_stable': return (0, crypto_1.createHash)('sha256').update(value).digest('hex').slice(0, 16);
+            default: return '[REDACTED]';
+        }
+    }
+    maskPartialLast4(value, maskChar, separator) {
+        const digits = value.replace(/\D/g, '');
+        const last4 = digits.length >= 4 ? digits.slice(-4) : digits.padStart(4, maskChar);
+        return `${maskChar.repeat(4)}${separator}${maskChar.repeat(4)}${separator}${last4}`;
+    }
+    maskEmailDomainOnly(value) {
+        const atIndex = value.indexOf('@');
+        if (atIndex === -1)
+            return '****';
+        return `****${value.slice(atIndex)}`;
+    }
+    maskLast4Only(value, maskChar) {
+        const digits = value.replace(/\D/g, '');
+        if (digits.length <= 4)
+            return digits;
+        return maskChar.repeat(digits.length - 4) + digits.slice(-4);
+    }
+}
+exports.MaskingEngine = MaskingEngine;
+//# sourceMappingURL=MaskingEngine.js.map

package/dist/services/MaskingEngine.js.map

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

package/dist/types/extraction.d.ts

@@ -0,0 +1,27 @@
+export type SymbolType = 'method' | 'function' | 'class' | 'route';
+export interface ExtractionTarget {
+    readonly filePath: string;
+    readonly symbolName: string;
+    readonly symbolType: SymbolType;
+}
+export interface ExtractionResult {
+    readonly filePath: string;
+    readonly startLine: number;
+    readonly endLine: number;
+    readonly sourceCode: string;
+    readonly symbolName: string;
+    readonly symbolType: SymbolType;
+    readonly docBlock: string | null;
+}
+export interface ExtractionRequestPayload {
+    readonly extraction_id: string;
+    readonly extraction_type: string;
+    readonly targets: readonly ExtractionTarget[];
+    readonly callback_url: string;
+    readonly include_ast: boolean;
+    readonly include_docblock: boolean;
+    readonly include_line_numbers: boolean;
+    readonly max_lines_per_symbol: number;
+}
+export declare function parseExtractionRequestPayload(payload: Record<string, unknown>): ExtractionRequestPayload;
+//# sourceMappingURL=extraction.d.ts.map

package/dist/types/extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.d.ts","sourceRoot":"","sources":["../../src/types/extraction.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,wBAAwB,CAWxG"}

package/dist/types/extraction.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseExtractionRequestPayload = parseExtractionRequestPayload;
+function parseExtractionRequestPayload(payload) {
+    return {
+        extraction_id: String(payload['extraction_id'] ?? ''),
+        extraction_type: String(payload['extraction_type'] ?? 'generic'),
+        targets: (Array.isArray(payload['targets']) ? payload['targets'] : []),
+        callback_url: String(payload['callback_url'] ?? ''),
+        include_ast: Boolean(payload['include_ast'] ?? true),
+        include_docblock: Boolean(payload['include_docblock'] ?? true),
+        include_line_numbers: Boolean(payload['include_line_numbers'] ?? true),
+        max_lines_per_symbol: Number(payload['max_lines_per_symbol'] ?? 500),
+    };
+}
+//# sourceMappingURL=extraction.js.map

package/dist/types/extraction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.js","sourceRoot":"","sources":["../../src/types/extraction.ts"],"names":[],"mappings":";;AA6BA,sEAWC;AAXD,SAAgB,6BAA6B,CAAC,OAAgC;IAC5E,OAAO;QACL,aAAa,EAAS,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,IAAW,EAAE,CAAC;QACnE,eAAe,EAAO,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAS,SAAS,CAAC;QAC1E,OAAO,EAAe,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAuB;QACzG,YAAY,EAAU,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,IAAY,EAAE,CAAC;QACnE,WAAW,EAAW,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,IAAY,IAAI,CAAC;QACrE,gBAAgB,EAAM,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAO,IAAI,CAAC;QACrE,oBAAoB,EAAE,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,IAAI,IAAI,CAAC;QACtE,oBAAoB,EAAE,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,IAAI,GAAG,CAAC;KACrE,CAAC;AACJ,CAAC"}