@lhremote/core 0.0.0 → 0.2.0

package/dist/types/instance.test.js

@@ -0,0 +1,59 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { describe, expect, it } from "vitest";
+describe("Instance types", () => {
+    it("should allow constructing StartInstanceParams", () => {
+        const params = {
+            linkedInAccount: { id: 1, liId: 100 },
+            accountData: { id: 1, liId: 100 },
+            instanceId: 42,
+            proxy: null,
+            license: null,
+            userId: null,
+            frontendSettings: {},
+            lhAccount: {},
+            zoomDefault: 1,
+            shouldBringToFront: false,
+            shouldStartRunningCampaigns: false,
+        };
+        expect(params.instanceId).toBe(42);
+        expect(params.linkedInAccount.liId).toBe(100);
+        expect(params.proxy).toBeNull();
+    });
+    it("should allow a successful StartInstanceResult", () => {
+        const result = { success: true };
+        expect(result.success).toBe(true);
+        expect(result.error).toBeUndefined();
+    });
+    it("should allow a failed StartInstanceResult", () => {
+        const result = {
+            success: false,
+            error: "account is already running",
+        };
+        expect(result.success).toBe(false);
+        expect(result.error).toBe("account is already running");
+    });
+    it("should constrain InstanceStatus to known values", () => {
+        const statuses = [
+            "stopped",
+            "starting",
+            "running",
+            "stopping",
+        ];
+        expect(statuses).toHaveLength(4);
+    });
+    it("should allow InstanceInfo with optional debuggerPort", () => {
+        const stopped = {
+            instanceId: 1,
+            status: "stopped",
+        };
+        expect(stopped.debuggerPort).toBeUndefined();
+        const running = {
+            instanceId: 2,
+            status: "running",
+            debuggerPort: 9223,
+        };
+        expect(running.debuggerPort).toBe(9223);
+    });
+});
+//# sourceMappingURL=instance.test.js.map

package/dist/types/instance.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.test.js","sourceRoot":"","sources":["../../src/types/instance.test.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAQ9C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,MAAM,GAAwB;YAClC,eAAe,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE;YACrC,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE;YACjC,UAAU,EAAE,EAAE;YACd,KAAK,EAAE,IAAI;YACX,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI;YACZ,gBAAgB,EAAE,EAAE;YACpB,SAAS,EAAE,EAAE;YACb,WAAW,EAAE,CAAC;YACd,kBAAkB,EAAE,KAAK;YACzB,2BAA2B,EAAE,KAAK;SACnC,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,MAAM,GAAwB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,MAAM,GAAwB;YAClC,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,4BAA4B;SACpC,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,QAAQ,GAAqB;YACjC,SAAS;YACT,UAAU;YACV,SAAS;YACT,UAAU;SACX,CAAC;QACF,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,OAAO,GAAiB;YAC5B,UAAU,EAAE,CAAC;YACb,MAAM,EAAE,SAAS;SAClB,CAAC;QACF,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,aAAa,EAAE,CAAC;QAE7C,MAAM,OAAO,GAAiB;YAC5B,UAAU,EAAE,CAAC;YACb,MAAM,EAAE,SAAS;YACjB,YAAY,EAAE,IAAI;SACnB,CAAC;QACF,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/types/messaging.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Messaging types derived from LinkedHelper's SQLite schema.
+ *
+ * Root entity: `chats` table (M:N with people via `chat_participants`,
+ * M:N with messages via `participant_messages`).
+ */
+export interface ChatParticipant {
+    personId: number;
+    firstName: string;
+    lastName: string | null;
+}
+export interface MessageSummary {
+    text: string;
+    sendAt: string;
+}
+export interface Chat {
+    id: number;
+    type: string;
+    platform: string;
+    participants: ChatParticipant[];
+    messageCount: number;
+    lastMessage: MessageSummary | null;
+}
+export interface Message {
+    id: number;
+    type: string;
+    text: string;
+    subject: string | null;
+    sendAt: string;
+    attachmentsCount: number;
+    senderPersonId: number;
+    senderFirstName: string;
+    senderLastName: string | null;
+}
+export interface ConversationThread {
+    chat: Chat;
+    messages: Message[];
+}
+export interface MessageStats {
+    totalMessages: number;
+    totalChats: number;
+    earliestMessage: string | null;
+    latestMessage: string | null;
+}
+export interface ConversationMessages {
+    chatId: number;
+    personId: number;
+    personName: string;
+    messages: Message[];
+}
+//# sourceMappingURL=messaging.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/types/messaging.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,cAAc,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB"}

package/dist/types/messaging.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+export {};
+//# sourceMappingURL=messaging.js.map

package/dist/types/messaging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.js","sourceRoot":"","sources":["../../src/types/messaging.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC"}

package/dist/types/profile.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Core people/profile types derived from LinkedHelper's SQLite schema.
+ *
+ * Root entity: `people` table (1:1 with mini-profile, 1:N with positions,
+ * education, skills, emails, external IDs).
+ */
+export interface MiniProfile {
+    firstName: string;
+    lastName: string | null;
+    headline: string | null;
+    avatar: string | null;
+}
+export type ExternalIdTypeGroup = "member" | "public" | "hash" | "avatar";
+export interface ExternalId {
+    externalId: string;
+    typeGroup: ExternalIdTypeGroup;
+    isMemberId: boolean;
+}
+export interface Position {
+    company: string | null;
+    title: string | null;
+    startDate: string | null;
+    endDate: string | null;
+    isCurrent: boolean;
+}
+export interface CurrentPosition {
+    company: string | null;
+    title: string | null;
+}
+export interface Education {
+    school: string | null;
+    degree: string | null;
+    field: string | null;
+    startDate: string | null;
+    endDate: string | null;
+}
+export interface Skill {
+    name: string;
+}
+export interface Profile {
+    id: number;
+    miniProfile: MiniProfile;
+    externalIds: ExternalId[];
+    currentPosition: CurrentPosition | null;
+    positions: Position[];
+    education: Education[];
+    skills: Skill[];
+    emails: string[];
+}
+/**
+ * Options for searching profiles in the local database.
+ */
+export interface ProfileSearchOptions {
+    /** Match against first_name, last_name, headline */
+    query?: string;
+    /** Match against current position company */
+    company?: string;
+    /** Maximum number of results (default 20) */
+    limit?: number;
+    /** Pagination offset (default 0) */
+    offset?: number;
+}
+/**
+ * Summary of a profile for search results.
+ */
+export interface ProfileSummary {
+    id: number;
+    firstName: string;
+    lastName: string | null;
+    headline: string | null;
+    company: string | null;
+    title: string | null;
+}
+/**
+ * Result of a profile search operation.
+ */
+export interface ProfileSearchResult {
+    profiles: ProfileSummary[];
+    total: number;
+}
+//# sourceMappingURL=profile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/types/profile.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1E,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types/profile.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+export {};
+//# sourceMappingURL=profile.js.map

package/dist/types/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/types/profile.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC"}

package/dist/types/profile.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=profile.test.d.ts.map

package/dist/types/profile.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.test.d.ts","sourceRoot":"","sources":["../../src/types/profile.test.ts"],"names":[],"mappings":""}

package/dist/types/profile.test.js

@@ -0,0 +1,105 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { describe, expect, it } from "vitest";
+describe("Profile types", () => {
+    it("should allow constructing a full Profile", () => {
+        const profile = {
+            id: 1,
+            miniProfile: {
+                firstName: "Jane",
+                lastName: "Doe",
+                headline: "Software Engineer",
+                avatar: "https://example.com/avatar.jpg",
+            },
+            externalIds: [
+                { externalId: "123456", typeGroup: "member", isMemberId: true },
+                { externalId: "jane-doe", typeGroup: "public", isMemberId: false },
+            ],
+            currentPosition: { company: "Acme Corp", title: "Senior Engineer" },
+            positions: [
+                {
+                    company: "Acme Corp",
+                    title: "Senior Engineer",
+                    startDate: "2023-01",
+                    endDate: null,
+                    isCurrent: true,
+                },
+            ],
+            education: [
+                {
+                    school: "MIT",
+                    degree: "BS",
+                    field: "Computer Science",
+                    startDate: "2015",
+                    endDate: "2019",
+                },
+            ],
+            skills: [{ name: "TypeScript" }],
+            emails: ["jane@example.com"],
+        };
+        expect(profile.id).toBe(1);
+        expect(profile.miniProfile.firstName).toBe("Jane");
+        expect(profile.externalIds).toHaveLength(2);
+        expect(profile.currentPosition?.company).toBe("Acme Corp");
+        expect(profile.positions[0]?.isCurrent).toBe(true);
+        expect(profile.education[0]?.school).toBe("MIT");
+        expect(profile.skills[0]?.name).toBe("TypeScript");
+        expect(profile.emails[0]).toBe("jane@example.com");
+    });
+    it("should allow nullable fields", () => {
+        const mini = {
+            firstName: "John",
+            lastName: null,
+            headline: null,
+            avatar: null,
+        };
+        expect(mini.lastName).toBeNull();
+        const position = {
+            company: null,
+            title: null,
+            startDate: null,
+            endDate: null,
+            isCurrent: false,
+        };
+        expect(position.company).toBeNull();
+        const education = {
+            school: null,
+            degree: null,
+            field: null,
+            startDate: null,
+            endDate: null,
+        };
+        expect(education.school).toBeNull();
+        const profile = {
+            id: 2,
+            miniProfile: mini,
+            externalIds: [],
+            currentPosition: null,
+            positions: [],
+            education: [],
+            skills: [],
+            emails: [],
+        };
+        expect(profile.currentPosition).toBeNull();
+    });
+    it("should constrain ExternalId typeGroup to known values", () => {
+        const ids = [
+            { externalId: "1", typeGroup: "member", isMemberId: true },
+            { externalId: "2", typeGroup: "public", isMemberId: false },
+            { externalId: "3", typeGroup: "hash", isMemberId: false },
+            { externalId: "4", typeGroup: "avatar", isMemberId: false },
+        ];
+        const groups = ids.map((id) => id.typeGroup);
+        expect(groups).toEqual(["member", "public", "hash", "avatar"]);
+    });
+    it("should allow CurrentPosition with nullable fields", () => {
+        const cp = { company: null, title: null };
+        expect(cp.company).toBeNull();
+        expect(cp.title).toBeNull();
+    });
+    it("should allow Skill with name only", () => {
+        const skill = { name: "JavaScript" };
+        expect(skill.name).toBe("JavaScript");
+    });
+});
+//# sourceMappingURL=profile.test.js.map

package/dist/types/profile.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.test.js","sourceRoot":"","sources":["../../src/types/profile.test.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAW9C,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,OAAO,GAAY;YACvB,EAAE,EAAE,CAAC;YACL,WAAW,EAAE;gBACX,SAAS,EAAE,MAAM;gBACjB,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,mBAAmB;gBAC7B,MAAM,EAAE,gCAAgC;aACzC;YACD,WAAW,EAAE;gBACX,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE;gBAC/D,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE;aACnE;YACD,eAAe,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,iBAAiB,EAAE;YACnE,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,WAAW;oBACpB,KAAK,EAAE,iBAAiB;oBACxB,SAAS,EAAE,SAAS;oBACpB,OAAO,EAAE,IAAI;oBACb,SAAS,EAAE,IAAI;iBAChB;aACF;YACD,SAAS,EAAE;gBACT;oBACE,MAAM,EAAE,KAAK;oBACb,MAAM,EAAE,IAAI;oBACZ,KAAK,EAAE,kBAAkB;oBACzB,SAAS,EAAE,MAAM;oBACjB,OAAO,EAAE,MAAM;iBAChB;aACF;YACD,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;YAChC,MAAM,EAAE,CAAC,kBAAkB,CAAC;SAC7B,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3D,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,IAAI,GAAgB;YACxB,SAAS,EAAE,MAAM;YACjB,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI;SACb,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;QAEjC,MAAM,QAAQ,GAAa;YACzB,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,IAAI;YACX,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,KAAK;SACjB,CAAC;QACF,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;QAEpC,MAAM,SAAS,GAAc;YAC3B,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,IAAI;YACX,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,IAAI;SACd,CAAC;QACF,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAEpC,MAAM,OAAO,GAAY;YACvB,EAAE,EAAE,CAAC;YACL,WAAW,EAAE,IAAI;YACjB,WAAW,EAAE,EAAE;YACf,eAAe,EAAE,IAAI;YACrB,SAAS,EAAE,EAAE;YACb,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE;SACX,CAAC;QACF,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,GAAG,GAAiB;YACxB,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE;YAC1D,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE;YAC3D,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE;YACzD,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE;SAC5D,CAAC;QACF,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,EAAE,GAAoB,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC3D,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,KAAK,GAAU,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/cdp-port.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Check whether a port exposes a CDP `/json/list` endpoint.
+ */
+export declare function isCdpPort(port: number): Promise<boolean>;
+//# sourceMappingURL=cdp-port.d.ts.map

package/dist/utils/cdp-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-port.d.ts","sourceRoot":"","sources":["../../src/utils/cdp-port.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAS9D"}

package/dist/utils/cdp-port.js

@@ -0,0 +1,15 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * Check whether a port exposes a CDP `/json/list` endpoint.
+ */
+export async function isCdpPort(port) {
+    try {
+        const response = await fetch(`http://127.0.0.1:${String(port)}/json/list`);
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=cdp-port.js.map

package/dist/utils/cdp-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-port.js","sourceRoot":"","sources":["../../src/utils/cdp-port.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,oBAAoB,MAAM,CAAC,IAAI,CAAC,YAAY,CAC7C,CAAC;QACF,OAAO,QAAQ,CAAC,EAAE,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/utils/cdp-port.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cdp-port.test.d.ts.map

package/dist/utils/cdp-port.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-port.test.d.ts","sourceRoot":"","sources":["../../src/utils/cdp-port.test.ts"],"names":[],"mappings":""}

package/dist/utils/cdp-port.test.js

@@ -0,0 +1,23 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { isCdpPort } from "./cdp-port.js";
+describe("isCdpPort", () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("should return true when the port responds with ok", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: true }));
+        expect(await isCdpPort(9222)).toBe(true);
+        expect(fetch).toHaveBeenCalledWith("http://127.0.0.1:9222/json/list");
+    });
+    it("should return false when the port responds with non-ok", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: false }));
+        expect(await isCdpPort(9222)).toBe(false);
+    });
+    it("should return false when fetch throws", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockRejectedValue(new Error("ECONNREFUSED")));
+        expect(await isCdpPort(9222)).toBe(false);
+    });
+});
+//# sourceMappingURL=cdp-port.test.js.map

package/dist/utils/cdp-port.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-port.test.js","sourceRoot":"","sources":["../../src/utils/cdp-port.test.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,EAAE,CAAC,UAAU,CACX,OAAO,EACP,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CACxC,CAAC;QAEF,MAAM,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAAC,iCAAiC,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,EAAE,CAAC,UAAU,CACX,OAAO,EACP,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CACzC,CAAC;QAEF,MAAM,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,EAAE,CAAC,UAAU,CACX,OAAO,EACP,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC,CACrD,CAAC;QAEF,MAAM,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/delay.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Return a promise that resolves after the given number of milliseconds.
+ */
+export declare function delay(ms: number): Promise<void>;
+//# sourceMappingURL=delay.d.ts.map

package/dist/utils/delay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.d.ts","sourceRoot":"","sources":["../../src/utils/delay.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/utils/delay.js

@@ -0,0 +1,9 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * Return a promise that resolves after the given number of milliseconds.
+ */
+export function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=delay.js.map

package/dist/utils/delay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.js","sourceRoot":"","sources":["../../src/utils/delay.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/utils/delay.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=delay.test.d.ts.map

package/dist/utils/delay.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.test.d.ts","sourceRoot":"","sources":["../../src/utils/delay.test.ts"],"names":[],"mappings":""}

package/dist/utils/delay.test.js

@@ -0,0 +1,17 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { describe, expect, it } from "vitest";
+import { delay } from "./delay.js";
+describe("delay", () => {
+    it("should resolve after the given time", async () => {
+        const start = Date.now();
+        await delay(50);
+        const elapsed = Date.now() - start;
+        expect(elapsed).toBeGreaterThanOrEqual(40);
+    });
+    it("should return a promise that resolves to undefined", async () => {
+        const result = await delay(0);
+        expect(result).toBeUndefined();
+    });
+});
+//# sourceMappingURL=delay.test.js.map

package/dist/utils/delay.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.test.js","sourceRoot":"","sources":["../../src/utils/delay.test.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACrB,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACnC,MAAM,CAAC,OAAO,CAAC,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/error-message.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Extract a human-readable message from an unknown caught value.
+ */
+export declare function errorMessage(error: unknown): string;
+//# sourceMappingURL=error-message.d.ts.map

package/dist/utils/error-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-message.d.ts","sourceRoot":"","sources":["../../src/utils/error-message.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD"}

package/dist/utils/error-message.js

@@ -0,0 +1,9 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * Extract a human-readable message from an unknown caught value.
+ */
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=error-message.js.map

package/dist/utils/error-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-message.js","sourceRoot":"","sources":["../../src/utils/error-message.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/utils/error-message.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=error-message.test.d.ts.map

package/dist/utils/error-message.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-message.test.d.ts","sourceRoot":"","sources":["../../src/utils/error-message.test.ts"],"names":[],"mappings":""}

package/dist/utils/error-message.test.js

@@ -0,0 +1,28 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { describe, expect, it } from "vitest";
+import { errorMessage } from "./error-message.js";
+describe("errorMessage", () => {
+    it("should extract message from Error instances", () => {
+        expect(errorMessage(new Error("something failed"))).toBe("something failed");
+    });
+    it("should extract message from Error subclasses", () => {
+        expect(errorMessage(new TypeError("bad type"))).toBe("bad type");
+    });
+    it("should convert strings via String()", () => {
+        expect(errorMessage("plain string")).toBe("plain string");
+    });
+    it("should convert numbers via String()", () => {
+        expect(errorMessage(42)).toBe("42");
+    });
+    it("should convert null via String()", () => {
+        expect(errorMessage(null)).toBe("null");
+    });
+    it("should convert undefined via String()", () => {
+        expect(errorMessage(undefined)).toBe("undefined");
+    });
+    it("should convert objects via String()", () => {
+        expect(errorMessage({ toString: () => "custom" })).toBe("custom");
+    });
+});
+//# sourceMappingURL=error-message.test.js.map

package/dist/utils/error-message.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-message.test.js","sourceRoot":"","sources":["../../src/utils/error-message.test.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,CACtD,kBAAkB,CACnB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+export { isCdpPort } from "./cdp-port.js";
+export { delay } from "./delay.js";
+export { errorMessage } from "./error-message.js";
+export { isLoopbackAddress } from "./loopback.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+export { isCdpPort } from "./cdp-port.js";
+export { delay } from "./delay.js";
+export { errorMessage } from "./error-message.js";
+export { isLoopbackAddress } from "./loopback.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/utils/loopback.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Check whether a host string is a loopback address.
+ *
+ * Recognised loopback patterns:
+ * - `localhost` (with or without trailing dot)
+ * - IPv4 `127.x.x.x` block
+ * - IPv6 `::1` (full, compressed, and bracketed forms)
+ */
+export declare function isLoopbackAddress(host: string): boolean;
+//# sourceMappingURL=loopback.d.ts.map

package/dist/utils/loopback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopback.d.ts","sourceRoot":"","sources":["../../src/utils/loopback.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAoBvD"}

package/dist/utils/loopback.js

@@ -0,0 +1,28 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * Check whether a host string is a loopback address.
+ *
+ * Recognised loopback patterns:
+ * - `localhost` (with or without trailing dot)
+ * - IPv4 `127.x.x.x` block
+ * - IPv6 `::1` (full, compressed, and bracketed forms)
+ */
+export function isLoopbackAddress(host) {
+    const h = host.toLowerCase();
+    // localhost (including "localhost.")
+    if (h === "localhost" || h === "localhost.") {
+        return true;
+    }
+    // IPv4 loopback: 127.0.0.0/8
+    if (h.startsWith("127.")) {
+        return true;
+    }
+    // IPv6 loopback — strip optional brackets
+    const bare = h.startsWith("[") && h.endsWith("]") ? h.slice(1, -1) : h;
+    if (bare === "::1" || bare === "0:0:0:0:0:0:0:1") {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=loopback.js.map

package/dist/utils/loopback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopback.js","sourceRoot":"","sources":["../../src/utils/loopback.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAE7B,qCAAqC;IACrC,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,YAAY,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6BAA6B;IAC7B,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0CAA0C;IAC1C,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/loopback.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=loopback.test.d.ts.map

package/dist/utils/loopback.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopback.test.d.ts","sourceRoot":"","sources":["../../src/utils/loopback.test.ts"],"names":[],"mappings":""}