@lhremote/core 0.0.0 → 0.1.0

package/dist/db/testing/create-fixture.js

@@ -0,0 +1,286 @@
+/**
+ * Generates a test fixture SQLite database with the real LinkedHelper
+ * schema populated with synthetic (non-personal) mock data.
+ *
+ * Run: npx tsx src/db/testing/create-fixture.ts
+ */
+import { writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import Database from "better-sqlite3";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const FIXTURE_PATH = join(__dirname, "fixture.db");
+const db = new Database("");
+// ── Schema (matches real LinkedHelper DDL) ──────────────────────────
+db.exec(`
+  CREATE TABLE disabled_triggers(
+    id INTEGER PRIMARY KEY,
+    trigger_name TEXT,
+    UNIQUE (trigger_name)
+  );
+
+  CREATE TABLE people(
+    id INTEGER PRIMARY KEY,
+    original_id INTEGER,
+    created_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    updated_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW'))
+  );
+  CREATE INDEX people_original_id_idx ON people(original_id);
+
+  CREATE TABLE person_mini_profile(
+    id INTEGER PRIMARY KEY,
+    person_id INTEGER NOT NULL,
+    first_name TEXT NOT NULL,
+    first_name_uppercase TEXT,
+    last_name TEXT,
+    last_name_uppercase TEXT,
+    headline TEXT,
+    headline_uppercase TEXT,
+    avatar TEXT,
+    first_mutual_full_name TEXT,
+    second_mutual_full_name TEXT,
+    created_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    updated_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    UNIQUE (person_id),
+    FOREIGN KEY(person_id) REFERENCES people(id)
+  );
+
+  CREATE TABLE person_external_ids(
+    id INTEGER PRIMARY KEY,
+    person_id INTEGER NOT NULL,
+    external_id TEXT NOT NULL,
+    external_id_uppercase TEXT NOT NULL,
+    type_group TEXT NOT NULL CHECK(type_group IN ('member', 'public', 'hash', 'avatar')),
+    is_member_id INTEGER,
+    created_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    updated_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    UNIQUE(external_id, type_group),
+    FOREIGN KEY(person_id) REFERENCES people(id)
+  );
+  CREATE INDEX person_external_ids_person_idx ON person_external_ids(person_id);
+
+  CREATE TABLE person_current_position(
+    id INTEGER PRIMARY KEY,
+    person_id INTEGER NOT NULL,
+    company TEXT,
+    company_uppercase TEXT,
+    position TEXT,
+    position_uppercase TEXT,
+    created_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    updated_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    UNIQUE(person_id),
+    FOREIGN KEY(person_id) REFERENCES people(id)
+  );
+
+  CREATE TABLE person_positions(
+    id INTEGER PRIMARY KEY,
+    person_id INTEGER NOT NULL,
+    title TEXT NOT NULL,
+    company_name TEXT NOT NULL,
+    company_id TEXT,
+    start DATETIME,
+    start_year INTEGER,
+    start_month INTEGER,
+    "end" DATETIME,
+    end_year INTEGER,
+    end_month INTEGER,
+    location_name TEXT,
+    description TEXT,
+    is_default INTEGER,
+    created_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    updated_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    sent_at_to_pas DATETIME,
+    actual_at DATETIME NOT NULL,
+    UNIQUE(person_id, is_default),
+    FOREIGN KEY(person_id) REFERENCES people(id),
+    CHECK(is_default IS NULL OR (is_default IS NOT NULL AND "end" IS NULL))
+  );
+
+  CREATE TABLE person_education(
+    id INTEGER PRIMARY KEY,
+    person_id INTEGER NOT NULL,
+    school_name TEXT NOT NULL,
+    degree_name TEXT,
+    field_of_study TEXT,
+    description TEXT,
+    start_year INTEGER,
+    start_month INTEGER,
+    end_year INTEGER,
+    end_month INTEGER,
+    created_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    updated_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    sent_at_to_pas DATETIME,
+    actual_at DATETIME NOT NULL,
+    FOREIGN KEY(person_id) REFERENCES people(id)
+  );
+  CREATE INDEX person_education_person_idx ON person_education(person_id);
+
+  CREATE TABLE skills(
+    id INTEGER PRIMARY KEY,
+    name TEXT NOT NULL CHECK (length(name) > 0),
+    created_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    updated_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    UNIQUE (name)
+  );
+
+  CREATE TABLE person_skill(
+    id INTEGER PRIMARY KEY,
+    person_id INTEGER NOT NULL,
+    skill_id INTEGER NOT NULL,
+    endorsements_count INTEGER CHECK (endorsements_count IS NULL OR typeof(endorsements_count) = 'integer' AND endorsements_count >= 0),
+    created_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    updated_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    sent_at_to_pas DATETIME,
+    actual_at DATETIME NOT NULL,
+    UNIQUE (person_id, skill_id),
+    FOREIGN KEY(person_id) REFERENCES people(id),
+    FOREIGN KEY(skill_id) REFERENCES skills(id)
+  );
+
+  CREATE TABLE person_email(
+    id INTEGER PRIMARY KEY,
+    person_id INTEGER NOT NULL,
+    email TEXT NOT NULL,
+    type TEXT NOT NULL CHECK (type IN ('personal', 'business')),
+    created_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    updated_at DATETIME DEFAULT (STRFTIME('%Y-%m-%dT%H:%M:%fZ', 'NOW')),
+    sent_at_to_pas DATETIME,
+    actual_at DATETIME NOT NULL,
+    UNIQUE (person_id, email),
+    FOREIGN KEY(person_id) REFERENCES people(id)
+  );
+`);
+// ── Mock Data (obviously synthetic, no real PII) ────────────────────
+const NOW = "2025-01-15T12:00:00.000Z";
+// Person 1: full profile with all fields populated
+db.exec(`
+  INSERT INTO people (id, original_id, created_at, updated_at)
+  VALUES (1, 1, '${NOW}', '${NOW}');
+
+  INSERT INTO person_mini_profile
+    (person_id, first_name, first_name_uppercase, last_name, last_name_uppercase,
+     headline, headline_uppercase, avatar)
+  VALUES
+    (1, 'Ada', 'ADA', 'Lovelace', 'LOVELACE',
+     'Principal Analytical Engine Programmer',
+     'PRINCIPAL ANALYTICAL ENGINE PROGRAMMER',
+     'https://example.test/avatars/ada.jpg');
+
+  INSERT INTO person_external_ids
+    (person_id, external_id, external_id_uppercase, type_group, is_member_id)
+  VALUES
+    (1, 'ada-lovelace-test', 'ADA-LOVELACE-TEST', 'public', NULL),
+    (1, '100000001', '100000001', 'member', 1),
+    (1, 'h4sh-ada-001', 'H4SH-ADA-001', 'hash', NULL);
+
+  INSERT INTO person_current_position
+    (person_id, company, company_uppercase, position, position_uppercase)
+  VALUES
+    (1, 'Babbage Industries', 'BABBAGE INDUSTRIES',
+     'Lead Programmer', 'LEAD PROGRAMMER');
+
+  INSERT INTO person_positions
+    (person_id, title, company_name, company_id, start_year, start_month,
+     is_default, actual_at)
+  VALUES
+    (1, 'Lead Programmer', 'Babbage Industries', 'C001',
+     2020, 3, 1, '${NOW}');
+
+  INSERT INTO person_positions
+    (person_id, title, company_name, company_id, start_year, start_month,
+     end_year, end_month, actual_at)
+  VALUES
+    (1, 'Junior Analyst', 'Difference Engine Co', 'C002',
+     2015, 9, 2019, 12, '${NOW}');
+
+  INSERT INTO person_education
+    (person_id, school_name, degree_name, field_of_study,
+     start_year, end_year, actual_at)
+  VALUES
+    (1, 'University of Mathematica', 'BSc', 'Mathematics',
+     2011, 2015, '${NOW}');
+
+  INSERT INTO person_education
+    (person_id, school_name, degree_name, field_of_study,
+     start_year, end_year, actual_at)
+  VALUES
+    (1, 'Royal Polytechnic', 'MSc', 'Computational Logic',
+     2015, 2017, '${NOW}');
+
+  INSERT INTO skills (id, name) VALUES (1, 'Algorithm Design');
+  INSERT INTO skills (id, name) VALUES (2, 'Mechanical Computing');
+  INSERT INTO skills (id, name) VALUES (3, 'Technical Writing');
+
+  INSERT INTO person_skill (person_id, skill_id, endorsements_count, actual_at)
+  VALUES (1, 1, 42, '${NOW}');
+  INSERT INTO person_skill (person_id, skill_id, endorsements_count, actual_at)
+  VALUES (1, 2, 17, '${NOW}');
+
+  INSERT INTO person_email (person_id, email, type, actual_at)
+  VALUES (1, 'ada@example.test', 'business', '${NOW}');
+`);
+// Person 2: minimal profile (only required fields)
+db.exec(`
+  INSERT INTO people (id, original_id, created_at, updated_at)
+  VALUES (2, 2, '${NOW}', '${NOW}');
+
+  INSERT INTO person_mini_profile
+    (person_id, first_name, first_name_uppercase)
+  VALUES (2, 'Charlie', 'CHARLIE');
+
+  INSERT INTO person_external_ids
+    (person_id, external_id, external_id_uppercase, type_group)
+  VALUES (2, 'charlie-test', 'CHARLIE-TEST', 'public');
+`);
+// Person 3: another full profile for variety
+db.exec(`
+  INSERT INTO people (id, original_id, created_at, updated_at)
+  VALUES (3, 3, '${NOW}', '${NOW}');
+
+  INSERT INTO person_mini_profile
+    (person_id, first_name, first_name_uppercase, last_name, last_name_uppercase,
+     headline, headline_uppercase)
+  VALUES
+    (3, 'Grace', 'GRACE', 'Hopper', 'HOPPER',
+     'Compiler Pioneer at COBOL Systems',
+     'COMPILER PIONEER AT COBOL SYSTEMS');
+
+  INSERT INTO person_external_ids
+    (person_id, external_id, external_id_uppercase, type_group, is_member_id)
+  VALUES
+    (3, 'grace-hopper-test', 'GRACE-HOPPER-TEST', 'public', NULL),
+    (3, '100000003', '100000003', 'member', 1);
+
+  INSERT INTO person_current_position
+    (person_id, company, company_uppercase, position, position_uppercase)
+  VALUES
+    (3, 'COBOL Systems Inc', 'COBOL SYSTEMS INC',
+     'Distinguished Engineer', 'DISTINGUISHED ENGINEER');
+
+  INSERT INTO person_positions
+    (person_id, title, company_name, start_year, start_month,
+     is_default, actual_at)
+  VALUES
+    (3, 'Distinguished Engineer', 'COBOL Systems Inc',
+     2018, 1, 1, '${NOW}');
+
+  INSERT INTO person_education
+    (person_id, school_name, degree_name, field_of_study,
+     start_year, end_year, actual_at)
+  VALUES
+    (3, 'Vassar College', 'BA', 'Mathematics and Physics',
+     1924, 1928, '${NOW}');
+
+  INSERT INTO person_skill (person_id, skill_id, endorsements_count, actual_at)
+  VALUES (3, 3, 99, '${NOW}');
+
+  INSERT INTO person_email (person_id, email, type, actual_at)
+  VALUES (3, 'grace@example.test', 'business', '${NOW}');
+  INSERT INTO person_email (person_id, email, type, actual_at)
+  VALUES (3, 'grace.personal@example.test', 'personal', '${NOW}');
+`);
+// ── Write to disk ───────────────────────────────────────────────────
+writeFileSync(FIXTURE_PATH, db.serialize());
+db.close();
+console.log(`Fixture written to ${FIXTURE_PATH}`);
+//# sourceMappingURL=create-fixture.js.map

package/dist/db/testing/create-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-fixture.js","sourceRoot":"","sources":["../../../src/db/testing/create-fixture.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAEnD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;AAE5B,uEAAuE;AAEvE,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyIP,CAAC,CAAC;AAEH,uEAAuE;AAEvE,MAAM,GAAG,GAAG,0BAA0B,CAAC;AAEvC,mDAAmD;AACnD,EAAE,CAAC,IAAI,CAAC;;mBAEW,GAAG,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA6BZ,GAAG;;;;;;;2BAOI,GAAG;;;;;;;oBAOV,GAAG;;;;;;;oBAOH,GAAG;;;;;;;uBAOA,GAAG;;uBAEH,GAAG;;;gDAGsB,GAAG;CAClD,CAAC,CAAC;AAEH,mDAAmD;AACnD,EAAE,CAAC,IAAI,CAAC;;mBAEW,GAAG,OAAO,GAAG;;;;;;;;;CAS/B,CAAC,CAAC;AAEH,6CAA6C;AAC7C,EAAE,CAAC,IAAI,CAAC;;mBAEW,GAAG,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA2BZ,GAAG;;;;;;;oBAOH,GAAG;;;uBAGA,GAAG;;;kDAGwB,GAAG;;2DAEM,GAAG;CAC7D,CAAC,CAAC;AAEH,uEAAuE;AAEvE,aAAa,CAAC,YAAY,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;AAC5C,EAAE,CAAC,KAAK,EAAE,CAAC;AAEX,OAAO,CAAC,GAAG,CAAC,sBAAsB,YAAY,EAAE,CAAC,CAAC"}

package/dist/db/testing/open-fixture.d.ts

@@ -0,0 +1,14 @@
+import Database from "better-sqlite3";
+/** Absolute path to the test fixture database file. */
+export declare const FIXTURE_PATH: string;
+/**
+ * Opens the fixture database as a writable in-memory copy.
+ *
+ * Each call returns an independent database instance so tests cannot
+ * interfere with each other.  The real LinkedHelper schema (tables,
+ * indexes, CHECK constraints) and synthetic mock data are included.
+ *
+ * Call `.close()` when done.
+ */
+export declare function openFixture(): Database.Database;
+//# sourceMappingURL=open-fixture.d.ts.map

package/dist/db/testing/open-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-fixture.d.ts","sourceRoot":"","sources":["../../../src/db/testing/open-fixture.ts"],"names":[],"mappings":"AAGA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAItC,uDAAuD;AACvD,eAAO,MAAM,YAAY,QAAgC,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAG/C"}

package/dist/db/testing/open-fixture.js

@@ -0,0 +1,21 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import Database from "better-sqlite3";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** Absolute path to the test fixture database file. */
+export const FIXTURE_PATH = join(__dirname, "fixture.db");
+/**
+ * Opens the fixture database as a writable in-memory copy.
+ *
+ * Each call returns an independent database instance so tests cannot
+ * interfere with each other.  The real LinkedHelper schema (tables,
+ * indexes, CHECK constraints) and synthetic mock data are included.
+ *
+ * Call `.close()` when done.
+ */
+export function openFixture() {
+    const buffer = readFileSync(FIXTURE_PATH);
+    return new Database(buffer);
+}
+//# sourceMappingURL=open-fixture.js.map

package/dist/db/testing/open-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-fixture.js","sourceRoot":"","sources":["../../../src/db/testing/open-fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,uDAAuD;AACvD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAE1D;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC1C,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,6 @@
-export {};
+export type { Account, CurrentPosition, Education, ExternalId, ExternalIdTypeGroup, InstanceInfo, InstanceStatus, MiniProfile, Position, Profile, Skill, StartInstanceParams, StartInstanceResult, } from "./types/index.js";
+export { AppLaunchError, AppNotFoundError, AppService, type AppServiceOptions, ExtractionTimeoutError, extractSlug, InstanceNotRunningError, InstanceService, LauncherService, LinkedHelperNotRunningError, ProfileService, ServiceError, StartInstanceError, startInstanceWithRecovery, type StartInstanceOutcome, type VisitAndExtractOptions, checkStatus, type AccountInstanceStatus, type DatabaseStatus, type LauncherStatus, type StatusReport, waitForInstancePort, } from "./services/index.js";
+export { DatabaseClient, discoverAllDatabases, discoverDatabase, ProfileRepository, } from "./db/index.js";
+export { DatabaseError, DatabaseNotFoundError, ProfileNotFoundError, } from "./db/index.js";
+export { CDPConnectionError, CDPError, CDPEvaluationError, CDPTimeoutError, discoverInstancePort, } from "./cdp/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,OAAO,EACP,eAAe,EACf,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,QAAQ,EACR,OAAO,EACP,KAAK,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,KAAK,iBAAiB,EACtB,sBAAsB,EACtB,WAAW,EACX,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,2BAA2B,EAC3B,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,yBAAyB,EACzB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,WAAW,EACX,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,kBAAkB,EAClB,QAAQ,EACR,kBAAkB,EAClB,eAAe,EACf,oBAAoB,GACrB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,2 +1,8 @@
-export {};
+// Services
+export { AppLaunchError, AppNotFoundError, AppService, ExtractionTimeoutError, extractSlug, InstanceNotRunningError, InstanceService, LauncherService, LinkedHelperNotRunningError, ProfileService, ServiceError, StartInstanceError, startInstanceWithRecovery, checkStatus, waitForInstancePort, } from "./services/index.js";
+// Data access
+export { DatabaseClient, discoverAllDatabases, discoverDatabase, ProfileRepository, } from "./db/index.js";
+// Errors (DB + CDP errors can propagate through the service layer)
+export { DatabaseError, DatabaseNotFoundError, ProfileNotFoundError, } from "./db/index.js";
+export { CDPConnectionError, CDPError, CDPEvaluationError, CDPTimeoutError, discoverInstancePort, } from "./cdp/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,WAAW;AACX,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,UAAU,EAEV,sBAAsB,EACtB,WAAW,EACX,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,2BAA2B,EAC3B,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,yBAAyB,EAGzB,WAAW,EAKX,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,cAAc;AACd,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,mEAAmE;AACnE,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,kBAAkB,EAClB,QAAQ,EACR,kBAAkB,EAClB,eAAe,EACf,oBAAoB,GACrB,MAAM,gBAAgB,CAAC"}

package/dist/services/app.d.ts

@@ -0,0 +1,62 @@
+export interface AppServiceOptions {
+    /** Delay in ms after spawn before checking if the app is reachable (default 3000). */
+    launchProbeDelay?: number;
+}
+/**
+ * Manages the LinkedHelper application process lifecycle.
+ *
+ * Provides methods to launch, quit, and probe the LinkedHelper
+ * Electron application.  When no explicit CDP port is provided,
+ * a free port is selected automatically at launch time.
+ */
+export declare class AppService {
+    private assignedPort;
+    private childProcess;
+    private readonly launchProbeDelay;
+    /**
+     * @param cdpPort - Explicit CDP port.  When omitted, `launch()` will
+     *   select a free port automatically via `get-port`.
+     * @param options - Additional configuration options.
+     */
+    constructor(cdpPort?: number, options?: AppServiceOptions);
+    /**
+     * The CDP port currently in use.
+     *
+     * @throws {Error} if neither an explicit port was provided nor
+     *   `launch()` has been called yet.
+     */
+    get cdpPort(): number;
+    /**
+     * Launch the LinkedHelper application with CDP enabled.
+     *
+     * If no CDP port was specified in the constructor, a free port
+     * is selected automatically.
+     *
+     * @throws {AppNotFoundError} if the binary cannot be found.
+     * @throws {AppLaunchError} if the process fails to start.
+     */
+    launch(): Promise<void>;
+    /**
+     * Quit the LinkedHelper application.
+     *
+     * When a child process handle is available, sends `SIGTERM` and waits
+     * for the process to exit.  If it does not exit within
+     * {@link QUIT_GRACEFUL_TIMEOUT}, escalates to `SIGKILL`.
+     *
+     * When no child process handle is available (app was launched
+     * externally), attempts to close via CDP.
+     */
+    quit(): Promise<void>;
+    /**
+     * Check whether LinkedHelper is running by probing its CDP endpoint.
+     */
+    isRunning(): Promise<boolean>;
+    /**
+     * Locate the LinkedHelper binary for the current platform.
+     *
+     * @throws {AppNotFoundError} if the binary does not exist at the
+     *   expected location.
+     */
+    static findBinary(): string;
+}
+//# sourceMappingURL=app.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/services/app.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,iBAAiB;IAChC,sFAAsF;IACtF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C;;;;OAIG;gBACS,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB;IAKzD;;;;;OAKG;IACH,IAAI,OAAO,IAAI,MAAM,CAKpB;IAED;;;;;;;;OAQG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA0C7B;;;;;;;;;OASG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC3B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAYnC;;;;;OAKG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM;CAW5B"}

package/dist/services/app.js

@@ -0,0 +1,198 @@
+import { spawn } from "node:child_process";
+import { accessSync, constants } from "node:fs";
+import { join } from "node:path";
+import getPort from "get-port";
+import { discoverTargets } from "../cdp/index.js";
+import { AppLaunchError, AppNotFoundError } from "./errors.js";
+/** Default delay after spawn before checking if the app is reachable (ms). */
+const DEFAULT_LAUNCH_PROBE_DELAY = 3000;
+/** Maximum time to wait for the process to exit after SIGTERM (ms). */
+const QUIT_GRACEFUL_TIMEOUT = 10_000;
+/** Maximum time to wait for the process to exit after SIGKILL (ms). */
+const QUIT_FORCE_TIMEOUT = 5_000;
+/**
+ * Manages the LinkedHelper application process lifecycle.
+ *
+ * Provides methods to launch, quit, and probe the LinkedHelper
+ * Electron application.  When no explicit CDP port is provided,
+ * a free port is selected automatically at launch time.
+ */
+export class AppService {
+    assignedPort;
+    childProcess = null;
+    launchProbeDelay;
+    /**
+     * @param cdpPort - Explicit CDP port.  When omitted, `launch()` will
+     *   select a free port automatically via `get-port`.
+     * @param options - Additional configuration options.
+     */
+    constructor(cdpPort, options) {
+        this.assignedPort = cdpPort ?? null;
+        this.launchProbeDelay = options?.launchProbeDelay ?? DEFAULT_LAUNCH_PROBE_DELAY;
+    }
+    /**
+     * The CDP port currently in use.
+     *
+     * @throws {Error} if neither an explicit port was provided nor
+     *   `launch()` has been called yet.
+     */
+    get cdpPort() {
+        if (this.assignedPort === null) {
+            throw new Error("CDP port not yet assigned — call launch() first or provide a port to the constructor");
+        }
+        return this.assignedPort;
+    }
+    /**
+     * Launch the LinkedHelper application with CDP enabled.
+     *
+     * If no CDP port was specified in the constructor, a free port
+     * is selected automatically.
+     *
+     * @throws {AppNotFoundError} if the binary cannot be found.
+     * @throws {AppLaunchError} if the process fails to start.
+     */
+    async launch() {
+        if (this.assignedPort !== null && await this.isRunning()) {
+            return;
+        }
+        if (this.assignedPort === null) {
+            this.assignedPort = await getPort();
+        }
+        const binary = AppService.findBinary();
+        const args = [`--remote-debugging-port=${String(this.assignedPort)}`];
+        const child = spawn(binary, args, {
+            detached: true,
+            stdio: "ignore",
+        });
+        child.unref();
+        // Wait for an early error (e.g. ENOENT from spawn) before probing
+        await new Promise((resolve, reject) => {
+            const onError = (err) => {
+                cleanup();
+                reject(new AppLaunchError(`Failed to launch LinkedHelper: ${err.message}`, { cause: err }));
+            };
+            const timer = setTimeout(() => {
+                cleanup();
+                resolve();
+            }, this.launchProbeDelay);
+            function cleanup() {
+                child.removeListener("error", onError);
+                clearTimeout(timer);
+            }
+            child.on("error", onError);
+        });
+        this.childProcess = child;
+    }
+    /**
+     * Quit the LinkedHelper application.
+     *
+     * When a child process handle is available, sends `SIGTERM` and waits
+     * for the process to exit.  If it does not exit within
+     * {@link QUIT_GRACEFUL_TIMEOUT}, escalates to `SIGKILL`.
+     *
+     * When no child process handle is available (app was launched
+     * externally), attempts to close via CDP.
+     */
+    async quit() {
+        if (this.childProcess) {
+            const child = this.childProcess;
+            this.childProcess = null;
+            child.kill("SIGTERM");
+            const exited = await waitForExit(child, QUIT_GRACEFUL_TIMEOUT);
+            if (!exited) {
+                child.kill("SIGKILL");
+                await waitForExit(child, QUIT_FORCE_TIMEOUT);
+            }
+            return;
+        }
+        if (this.assignedPort === null) {
+            return;
+        }
+        // Fallback: close via CDP Browser.close
+        try {
+            const targets = await discoverTargets(this.assignedPort);
+            const first = targets[0];
+            if (first) {
+                await fetch(`http://127.0.0.1:${String(this.assignedPort)}/json/close/${first.id}`);
+            }
+        }
+        catch {
+            // App may already be closed
+        }
+    }
+    /**
+     * Check whether LinkedHelper is running by probing its CDP endpoint.
+     */
+    async isRunning() {
+        if (this.assignedPort === null) {
+            return false;
+        }
+        try {
+            await discoverTargets(this.assignedPort);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Locate the LinkedHelper binary for the current platform.
+     *
+     * @throws {AppNotFoundError} if the binary does not exist at the
+     *   expected location.
+     */
+    static findBinary() {
+        const envPath = process.env["LINKEDHELPER_PATH"];
+        if (envPath) {
+            assertFileExists(envPath);
+            return envPath;
+        }
+        const path = getDefaultBinaryPath();
+        assertFileExists(path);
+        return path;
+    }
+}
+function getDefaultBinaryPath() {
+    switch (process.platform) {
+        case "darwin":
+            return "/Applications/linked-helper.app/Contents/MacOS/linked-helper";
+        case "win32":
+            return join(process.env["LOCALAPPDATA"] ?? join(process.env["USERPROFILE"] ?? "C:\\Users\\Default", "AppData", "Local"), "Programs", "linked-helper", "linked-helper.exe");
+        default:
+            return "/opt/linked-helper/linked-helper";
+    }
+}
+/**
+ * Wait for a child process to exit, with a timeout.
+ *
+ * @returns `true` if the process exited within the timeout, `false` otherwise.
+ */
+function waitForExit(child, timeout) {
+    if (child.exitCode !== null) {
+        return Promise.resolve(true);
+    }
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            cleanup();
+            resolve(false);
+        }, timeout);
+        const onExit = () => {
+            cleanup();
+            resolve(true);
+        };
+        function cleanup() {
+            child.removeListener("exit", onExit);
+            clearTimeout(timer);
+        }
+        child.on("exit", onExit);
+    });
+}
+function assertFileExists(path) {
+    try {
+        accessSync(path, constants.X_OK);
+    }
+    catch {
+        throw new AppNotFoundError(`LinkedHelper binary not found at ${path}. Set LINKEDHELPER_PATH to override.`);
+    }
+}
+//# sourceMappingURL=app.js.map

package/dist/services/app.js.map

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

package/dist/services/app.test.d.ts

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

package/dist/services/app.test.d.ts.map

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