openclaw-channel-github 0.1.0

package/dist/src/routing/routing.d.ts

@@ -0,0 +1,22 @@
+import type { TriggerConfig, AutoTriggerConfig } from '../config/config';
+import { type NormalizedEvent, type TriggerKindValue } from '../normalizer/normalizer';
+/**
+ * Generate a stable session key for a normalized event.
+ * Format: github:<owner>/<repo>:<threadType>:<number>
+ * For review threads: github:<owner>/<repo>:pull_request:<number>:review-thread:<threadId>
+ */
+export declare function sessionKey(event: NormalizedEvent): string;
+export interface TriggerResult {
+    triggered: boolean;
+    kind: TriggerKindValue;
+    command?: string;
+}
+/** Evaluate whether a normalized event matches the trigger configuration. */
+export declare function evaluateTrigger(cfg: TriggerConfig, event: NormalizedEvent): TriggerResult;
+/** Check if an event qualifies for auto-trigger based on config. */
+export declare function evaluateAutoTrigger(cfg: AutoTriggerConfig | undefined, event: NormalizedEvent): TriggerResult;
+/** Check if sender is a bot that should be ignored. */
+export declare function isBotSender(event: NormalizedEvent, botUsername: string, ignoreBots: boolean): boolean;
+/** Check if the event message contains the outbound marker. */
+export declare function hasOutboundMarker(event: NormalizedEvent, marker: string): boolean;
+//# sourceMappingURL=routing.d.ts.map

package/dist/src/routing/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../../src/routing/routing.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAItB,MAAM,0BAA0B,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAMzD;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,GAAG,aAAa,CAmCzF;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,iBAAiB,GAAG,SAAS,EAClC,KAAK,EAAE,eAAe,GACrB,aAAa,CAmBf;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CACzB,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,OAAO,GAClB,OAAO,CAIT;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAGjF"}

package/dist/src/routing/routing.js

@@ -0,0 +1,97 @@
+"use strict";
+// Package routing provides session key generation and trigger matching.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sessionKey = sessionKey;
+exports.evaluateTrigger = evaluateTrigger;
+exports.evaluateAutoTrigger = evaluateAutoTrigger;
+exports.isBotSender = isBotSender;
+exports.hasOutboundMarker = hasOutboundMarker;
+const normalizer_1 = require("../normalizer/normalizer");
+/**
+ * Generate a stable session key for a normalized event.
+ * Format: github:<owner>/<repo>:<threadType>:<number>
+ * For review threads: github:<owner>/<repo>:pull_request:<number>:review-thread:<threadId>
+ */
+function sessionKey(event) {
+    const base = `github:${event.repository}:${event.thread.type}:${event.thread.number}`;
+    if (event.context?.reviewThreadId) {
+        return `${base}:review-thread:${event.context.reviewThreadId}`;
+    }
+    return base;
+}
+/** Evaluate whether a normalized event matches the trigger configuration. */
+function evaluateTrigger(cfg, event) {
+    const text = event.message.text;
+    // Check @mention
+    if (cfg.requireMention && cfg.botUsername) {
+        const mention = '@' + cfg.botUsername;
+        if (containsIgnoreCase(text, mention)) {
+            return { triggered: true, kind: normalizer_1.TriggerKind.Mention };
+        }
+    }
+    // Check command prefixes
+    for (const cmd of cfg.commands ?? []) {
+        if (hasCommandPrefix(text, cmd)) {
+            return { triggered: true, kind: normalizer_1.TriggerKind.Command, command: cmd };
+        }
+    }
+    // Check label triggers from context
+    if ((cfg.labels?.length ?? 0) > 0 && event.context) {
+        for (const cfgLabel of cfg.labels) {
+            for (const evtLabel of event.context.labels ?? []) {
+                if (cfgLabel.toLowerCase() === evtLabel.toLowerCase()) {
+                    return { triggered: true, kind: normalizer_1.TriggerKind.Label };
+                }
+            }
+        }
+    }
+    // If no trigger requirements set, treat as auto
+    if (!cfg.requireMention && (!cfg.commands || cfg.commands.length === 0) && (!cfg.labels || cfg.labels.length === 0)) {
+        return { triggered: true, kind: normalizer_1.TriggerKind.Auto };
+    }
+    return { triggered: false, kind: normalizer_1.TriggerKind.None };
+}
+/** Check if an event qualifies for auto-trigger based on config. */
+function evaluateAutoTrigger(cfg, event) {
+    if (!cfg)
+        return { triggered: false, kind: normalizer_1.TriggerKind.None };
+    if (cfg.onPROpened &&
+        event.thread.type === normalizer_1.ThreadType.PullRequest &&
+        event.message.type === normalizer_1.MessageType.PRBody) {
+        return { triggered: true, kind: normalizer_1.TriggerKind.Auto };
+    }
+    if (cfg.onIssueOpened &&
+        event.thread.type === normalizer_1.ThreadType.Issue &&
+        event.message.type === normalizer_1.MessageType.IssueBody) {
+        return { triggered: true, kind: normalizer_1.TriggerKind.Auto };
+    }
+    return { triggered: false, kind: normalizer_1.TriggerKind.None };
+}
+/** Check if sender is a bot that should be ignored. */
+function isBotSender(event, botUsername, ignoreBots) {
+    if (ignoreBots && event.sender.isBot)
+        return true;
+    if (botUsername && event.sender.login.toLowerCase() === botUsername.toLowerCase())
+        return true;
+    return false;
+}
+/** Check if the event message contains the outbound marker. */
+function hasOutboundMarker(event, marker) {
+    if (!marker)
+        return false;
+    return event.message.text.includes(marker);
+}
+// --- Helpers ---
+function containsIgnoreCase(s, substr) {
+    return s.toLowerCase().includes(substr.toLowerCase());
+}
+function hasCommandPrefix(text, cmd) {
+    const trimmed = text.trim().toLowerCase();
+    const cmdLower = cmd.toLowerCase();
+    if (trimmed.startsWith(cmdLower)) {
+        const rest = trimmed.slice(cmdLower.length);
+        return rest === '' || rest[0] === ' ' || rest[0] === '\n' || rest[0] === '\t';
+    }
+    return false;
+}
+//# sourceMappingURL=routing.js.map

package/dist/src/routing/routing.js.map

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

package/dist/src/server/server.d.ts

@@ -0,0 +1,20 @@
+import * as http from 'http';
+import type { Config } from '../config/config';
+import { GitHubAuth } from '../auth/auth';
+import { type NormalizedEvent } from '../normalizer/normalizer';
+import { OutboundSender } from '../outbound/outbound';
+import { Store } from '../state/state';
+export type MessageHandler = (sessionKey: string, event: NormalizedEvent) => Promise<string> | string;
+export declare class WebhookHandler {
+    private cfg;
+    private ghAuth;
+    private store;
+    private sender;
+    messageHandler: MessageHandler | null;
+    constructor(cfg: Config, ghAuth: GitHubAuth | null, store: Store, sender: OutboundSender);
+    /** Handle an incoming HTTP request. */
+    handleRequest(req: http.IncomingMessage, res: http.ServerResponse): Promise<void>;
+}
+/** Create an HTTP server with /webhook and /health endpoints. */
+export declare function createServer(handler: WebhookHandler): http.Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/src/server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/server/server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAiF,MAAM,cAAc,CAAC;AAczH,OAAO,EACL,KAAK,eAAe,EAoBrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQtD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAIvC,MAAM,MAAM,cAAc,GAAG,CAC3B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,eAAe,KACnB,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;AAE9B,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAiB;IACxB,cAAc,EAAE,cAAc,GAAG,IAAI,CAAQ;gBAGlD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,UAAU,GAAG,IAAI,EACzB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,cAAc;IAQxB,uCAAuC;IACjC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CA0HxF;AAiGD,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC,MAAM,CAYjE"}

package/dist/src/server/server.js

@@ -0,0 +1,283 @@
+"use strict";
+// Package server provides the HTTP webhook receiver for the OpenClaw GitHub Channel.
+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.WebhookHandler = void 0;
+exports.createServer = createServer;
+const http = __importStar(require("http"));
+const config_1 = require("../config/config");
+const auth_1 = require("../auth/auth");
+const events_1 = require("../events/events");
+const normalizer_1 = require("../normalizer/normalizer");
+const routing_1 = require("../routing/routing");
+const MAX_PAYLOAD_SIZE = 10 * 1024 * 1024; // 10MB
+class WebhookHandler {
+    cfg;
+    ghAuth;
+    store;
+    sender;
+    messageHandler = null;
+    constructor(cfg, ghAuth, store, sender) {
+        this.cfg = cfg;
+        this.ghAuth = ghAuth;
+        this.store = store;
+        this.sender = sender;
+    }
+    /** Handle an incoming HTTP request. */
+    async handleRequest(req, res) {
+        if (req.method !== 'POST') {
+            res.writeHead(405, { 'Content-Type': 'text/plain' });
+            res.end('Method not allowed');
+            return;
+        }
+        // Read body with size limit
+        let body;
+        try {
+            body = await readBody(req, MAX_PAYLOAD_SIZE);
+        }
+        catch {
+            res.writeHead(400, { 'Content-Type': 'text/plain' });
+            res.end('Failed to read body');
+            return;
+        }
+        // Verify webhook signature
+        const headers = req.headers;
+        const signature = (0, auth_1.extractSignature)(headers);
+        if (!(0, auth_1.verifyWebhookSignature)(body, this.cfg.channel.webhookSecret, signature)) {
+            res.writeHead(401, { 'Content-Type': 'text/plain' });
+            res.end('Invalid signature');
+            return;
+        }
+        const deliveryID = (0, auth_1.extractDeliveryID)(headers);
+        const eventType = (0, auth_1.extractEventType)(headers);
+        // Check for duplicate delivery
+        if (this.store.isDuplicate(deliveryID)) {
+            respondJSON(res, 200, { status: 'duplicate' });
+            return;
+        }
+        // Parse the event
+        let parsed;
+        try {
+            parsed = (0, events_1.parseEvent)(eventType, body);
+        }
+        catch {
+            respondJSON(res, 200, { status: 'unsupported_event' });
+            return;
+        }
+        // Normalize the event
+        const normalized = normalizeEvent(eventType, parsed);
+        if (!normalized) {
+            respondJSON(res, 200, { status: 'skipped' });
+            return;
+        }
+        // Check repository allowlist
+        if (!(0, config_1.isRepoAllowed)(this.cfg, normalized.repository)) {
+            respondJSON(res, 200, { status: 'repo_not_allowed' });
+            return;
+        }
+        // Bot loop prevention
+        if ((0, routing_1.isBotSender)(normalized, this.cfg.channel.trigger.botUsername, this.cfg.channel.ignoreBots)) {
+            respondJSON(res, 200, { status: 'bot_ignored' });
+            return;
+        }
+        // Outbound marker detection
+        if ((0, routing_1.hasOutboundMarker)(normalized, this.cfg.channel.outbound?.outboundMarker ?? '')) {
+            respondJSON(res, 200, { status: 'outbound_marker_ignored' });
+            return;
+        }
+        // Evaluate trigger
+        let triggerResult = (0, routing_1.evaluateTrigger)(this.cfg.channel.trigger, normalized);
+        if (!triggerResult.triggered) {
+            triggerResult = (0, routing_1.evaluateAutoTrigger)(this.cfg.channel.autoTrigger, normalized);
+        }
+        if (!triggerResult.triggered) {
+            respondJSON(res, 200, { status: 'no_trigger' });
+            return;
+        }
+        // Set trigger info
+        normalized.trigger = {
+            kind: triggerResult.kind,
+            command: triggerResult.command,
+        };
+        // Generate session key
+        const sessKey = (0, routing_1.sessionKey)(normalized);
+        // Mark delivery as processed
+        this.store.markProcessed(deliveryID);
+        // Invoke message handler
+        if (this.messageHandler) {
+            let reply;
+            try {
+                reply = await this.messageHandler(sessKey, normalized);
+            }
+            catch {
+                res.writeHead(500, { 'Content-Type': 'text/plain' });
+                res.end('Internal processing error');
+                return;
+            }
+            // Send reply back to GitHub if non-empty
+            if (reply) {
+                const token = this.ghAuth?.getInstallationToken() ?? '';
+                if (!token) {
+                    res.writeHead(500, { 'Content-Type': 'text/plain' });
+                    res.end('Authentication error');
+                    return;
+                }
+                try {
+                    await this.sender.sendComment(token, normalized, reply);
+                }
+                catch {
+                    res.writeHead(500, { 'Content-Type': 'text/plain' });
+                    res.end('Failed to send reply');
+                    return;
+                }
+            }
+        }
+        respondJSON(res, 200, { status: 'processed', session_key: sessKey });
+    }
+}
+exports.WebhookHandler = WebhookHandler;
+/** Normalize a parsed GitHub event by event type + action. */
+function normalizeEvent(eventType, parsed) {
+    switch (eventType) {
+        case events_1.EventType.Issues: {
+            const e = parsed;
+            switch (e.action) {
+                case 'opened': return (0, normalizer_1.normalizeIssueOpened)(e);
+                case 'edited': return (0, normalizer_1.normalizeIssueEdited)(e);
+                case 'closed': return (0, normalizer_1.normalizeIssueClosed)(e);
+                case 'reopened': return (0, normalizer_1.normalizeIssueReopened)(e);
+                case 'labeled': return (0, normalizer_1.normalizeIssueLabeled)(e);
+            }
+            break;
+        }
+        case events_1.EventType.IssueComment: {
+            const e = parsed;
+            switch (e.action) {
+                case 'created': return (0, normalizer_1.normalizeIssueComment)(e);
+                case 'edited': return (0, normalizer_1.normalizeIssueCommentEdited)(e);
+            }
+            break;
+        }
+        case events_1.EventType.PullRequest: {
+            const e = parsed;
+            switch (e.action) {
+                case 'opened': return (0, normalizer_1.normalizePullRequestOpened)(e);
+                case 'edited': return (0, normalizer_1.normalizePullRequestEdited)(e);
+                case 'closed': return (0, normalizer_1.normalizePullRequestClosed)(e);
+                case 'synchronize': return (0, normalizer_1.normalizePullRequestSynchronize)(e);
+                case 'labeled': return (0, normalizer_1.normalizePullRequestLabeled)(e);
+            }
+            break;
+        }
+        case events_1.EventType.PullRequestReview: {
+            const e = parsed;
+            if (e.action === 'submitted')
+                return (0, normalizer_1.normalizePullRequestReview)(e);
+            break;
+        }
+        case events_1.EventType.PullRequestReviewComment: {
+            const e = parsed;
+            if (e.action === 'created')
+                return (0, normalizer_1.normalizePullRequestReviewComment)(e);
+            break;
+        }
+        case events_1.EventType.Discussion: {
+            const e = parsed;
+            if (e.action === 'created')
+                return (0, normalizer_1.normalizeDiscussionCreated)(e);
+            break;
+        }
+        case events_1.EventType.DiscussionComment: {
+            const e = parsed;
+            if (e.action === 'created')
+                return (0, normalizer_1.normalizeDiscussionComment)(e);
+            break;
+        }
+        case events_1.EventType.CheckRun: {
+            const e = parsed;
+            if (e.action === 'completed')
+                return (0, normalizer_1.normalizeCheckRun)(e);
+            break;
+        }
+        case events_1.EventType.WorkflowRun: {
+            const e = parsed;
+            if (e.action === 'completed')
+                return (0, normalizer_1.normalizeWorkflowRun)(e);
+            break;
+        }
+    }
+    return null;
+}
+/** Read the request body with a size limit. */
+function readBody(req, maxSize) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        req.on('data', (chunk) => {
+            size += chunk.length;
+            if (size > maxSize) {
+                req.destroy();
+                reject(new Error('Payload too large'));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on('end', () => resolve(Buffer.concat(chunks)));
+        req.on('error', (err) => reject(err));
+    });
+}
+/** Send a JSON response. */
+function respondJSON(res, statusCode, body) {
+    const data = JSON.stringify(body);
+    res.writeHead(statusCode, { 'Content-Type': 'application/json' });
+    res.end(data + '\n');
+}
+/** Create an HTTP server with /webhook and /health endpoints. */
+function createServer(handler) {
+    return http.createServer(async (req, res) => {
+        const url = req.url ?? '/';
+        if (url === '/webhook') {
+            await handler.handleRequest(req, res);
+        }
+        else if (url === '/health') {
+            respondJSON(res, 200, { status: 'ok' });
+        }
+        else {
+            res.writeHead(404, { 'Content-Type': 'text/plain' });
+            res.end('Not found');
+        }
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/src/server/server.js.map

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

package/dist/src/state/state.d.ts

@@ -0,0 +1,17 @@
+export declare class Store {
+    private entries;
+    private ttl;
+    private cleanupTimer?;
+    constructor(ttlMs?: number);
+    /** Check whether the delivery ID has already been processed. */
+    isDuplicate(deliveryID: string): boolean;
+    /** Record a delivery ID as processed. */
+    markProcessed(deliveryID: string): void;
+    /** Remove expired entries. */
+    cleanup(): void;
+    /** Current number of entries. */
+    size(): number;
+    /** Start a background cleanup loop. Returns a stop function. */
+    startCleanupLoop(intervalMs: number): () => void;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/src/state/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/state/state.ts"],"names":[],"mappings":"AAEA,qBAAa,KAAK;IAChB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,YAAY,CAAC,CAAiC;gBAE1C,KAAK,GAAE,MAAiB;IAIpC,gEAAgE;IAChE,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAKxC,yCAAyC;IACzC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKvC,8BAA8B;IAC9B,OAAO,IAAI,IAAI;IASf,iCAAiC;IACjC,IAAI,IAAI,MAAM;IAId,gEAAgE;IAChE,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,IAAI;CASjD"}

package/dist/src/state/state.js

@@ -0,0 +1,49 @@
+"use strict";
+// Package state provides idempotency and deduplication for webhook event processing.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Store = void 0;
+class Store {
+    entries = new Map(); // deliveryID -> timestamp
+    ttl; // milliseconds
+    cleanupTimer;
+    constructor(ttlMs = 3600_000) {
+        this.ttl = ttlMs > 0 ? ttlMs : 3600_000;
+    }
+    /** Check whether the delivery ID has already been processed. */
+    isDuplicate(deliveryID) {
+        if (!deliveryID)
+            return false;
+        return this.entries.has(deliveryID);
+    }
+    /** Record a delivery ID as processed. */
+    markProcessed(deliveryID) {
+        if (!deliveryID)
+            return;
+        this.entries.set(deliveryID, Date.now());
+    }
+    /** Remove expired entries. */
+    cleanup() {
+        const cutoff = Date.now() - this.ttl;
+        for (const [id, ts] of this.entries) {
+            if (ts < cutoff) {
+                this.entries.delete(id);
+            }
+        }
+    }
+    /** Current number of entries. */
+    size() {
+        return this.entries.size;
+    }
+    /** Start a background cleanup loop. Returns a stop function. */
+    startCleanupLoop(intervalMs) {
+        this.cleanupTimer = setInterval(() => this.cleanup(), intervalMs);
+        return () => {
+            if (this.cleanupTimer) {
+                clearInterval(this.cleanupTimer);
+                this.cleanupTimer = undefined;
+            }
+        };
+    }
+}
+exports.Store = Store;
+//# sourceMappingURL=state.js.map

package/dist/src/state/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/state/state.ts"],"names":[],"mappings":";AAAA,qFAAqF;;;AAErF,MAAa,KAAK;IACR,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,0BAA0B;IAC/D,GAAG,CAAS,CAAC,eAAe;IAC5B,YAAY,CAAkC;IAEtD,YAAY,QAAgB,QAAQ;QAClC,IAAI,CAAC,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC1C,CAAC;IAED,gEAAgE;IAChE,WAAW,CAAC,UAAkB;QAC5B,IAAI,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED,yCAAyC;IACzC,aAAa,CAAC,UAAkB;QAC9B,IAAI,CAAC,UAAU;YAAE,OAAO;QACxB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,8BAA8B;IAC9B,OAAO;QACL,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QACrC,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;gBAChB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,gEAAgE;IAChE,gBAAgB,CAAC,UAAkB;QACjC,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;QAClE,OAAO,GAAG,EAAE;YACV,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBACjC,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;YAChC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;CACF;AA9CD,sBA8CC"}