whale-code 6.5.6 → 6.5.7

package/dist/server/handlers/crm.test.js

@@ -0,0 +1,179 @@
+// crm.test.ts — Tests for handleCustomers and handleOrders handlers
+
+import { describe, it, expect, vi, beforeAll, beforeEach, afterEach } from "vitest";
+import { HAS_TEST_DB, getTestClient, seedTracked, cleanup, TEST_STORE, RUN_PREFIX } from "./__test-utils__/test-db.js";
+import { randomUUID } from "node:crypto";
+// Mock the sanitizeFilterValue utility
+vi.mock("../lib/utils.js", () => ({
+  sanitizeFilterValue: vi.fn(v => v)
+}));
+import { handleCustomers, handleOrders } from "./crm.js";
+const sb = getTestClient();
+describe.skipIf(!HAS_TEST_DB)("handleCustomers", () => {
+  beforeAll(async () => {
+    // Ensure a creations row exists for TEST_STORE (user_creation_relationships FK requires it)
+    await sb.from("creations").upsert({
+      id: TEST_STORE,
+      creation_type: "store",
+      name: "Test Store Creation",
+      slug: "test-store-creation",
+      store_id: TEST_STORE,
+      status: "published"
+    }, {
+      onConflict: "id"
+    });
+  });
+  beforeEach(() => {
+    vi.restoreAllMocks();
+  });
+  afterEach(async () => {
+    vi.restoreAllMocks();
+    await cleanup();
+  });
+
+  // ========================================================================
+  // FIND
+  // ========================================================================
+
+  describe("action: find", () => {
+    it("returns customers for the store", async () => {
+      // Use handleCustomers create action to properly create test customers
+      // This avoids FK issues with user_creation_relationships
+      const r1 = await handleCustomers(sb, {
+        action: "create",
+        first_name: `${RUN_PREFIX} Jane`,
+        last_name: "Doe",
+        email: `${RUN_PREFIX}-jane-${Date.now()}@test.com`
+      }, TEST_STORE);
+      const r2 = await handleCustomers(sb, {
+        action: "create",
+        first_name: `${RUN_PREFIX} John`,
+        last_name: "Smith",
+        email: `${RUN_PREFIX}-john-${Date.now()}@test.com`
+      }, TEST_STORE);
+      const result = await handleCustomers(sb, {
+        action: "find"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    });
+  });
+
+  // ========================================================================
+  // CREATE
+  // ========================================================================
+
+  describe("action: create", () => {
+    it("creates a new customer", async () => {
+      const result = await handleCustomers(sb, {
+        action: "create",
+        first_name: `${RUN_PREFIX} New`,
+        last_name: "Customer",
+        email: `${RUN_PREFIX}-new-${Date.now()}@test.com`
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    });
+    it("returns error when name is missing", async () => {
+      const result = await handleCustomers(sb, {
+        action: "create",
+        email: `${RUN_PREFIX}-no-name@test.com`
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("required");
+    });
+  });
+
+  // ========================================================================
+  // ADD_NOTE VALIDATION
+  // ========================================================================
+
+  describe("add_note validation", () => {
+    it("requires customer_id for add_note", async () => {
+      const result = await handleCustomers(sb, {
+        action: "add_note",
+        note: "Orphan note with no customer"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+    });
+  });
+
+  // ========================================================================
+  // UNKNOWN ACTION
+  // ========================================================================
+
+  describe("unknown action", () => {
+    it("returns error for unrecognized action", async () => {
+      const result = await handleCustomers(sb, {
+        action: "destroy_all"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("Unknown customers action");
+    });
+  });
+});
+
+// ============================================================================
+// handleOrders
+// ============================================================================
+
+describe.skipIf(!HAS_TEST_DB)("handleOrders", () => {
+  afterEach(async () => {
+    await cleanup();
+  });
+  describe("action: find", () => {
+    it("returns orders for the store", async () => {
+      await seedTracked("orders", [{
+        id: randomUUID(),
+        store_id: TEST_STORE,
+        order_number: `${RUN_PREFIX}-1001`,
+        status: "completed",
+        total_amount: 50
+      }]);
+      const result = await handleOrders(sb, {
+        action: "find"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    }, 15000);
+  });
+  describe("action: get", () => {
+    it("returns a single order with details", async () => {
+      const orderId = randomUUID();
+      await seedTracked("orders", [{
+        id: orderId,
+        store_id: TEST_STORE,
+        order_number: `${RUN_PREFIX}-1001`,
+        total_amount: 100
+      }]);
+      const result = await handleOrders(sb, {
+        action: "get",
+        order_id: orderId
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    });
+    it("returns error when order not found", async () => {
+      const result = await handleOrders(sb, {
+        action: "get",
+        order_id: randomUUID()
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+    });
+    it("returns error when order_id missing", async () => {
+      const result = await handleOrders(sb, {
+        action: "get"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+    });
+  });
+
+  // ========================================================================
+  // UNKNOWN ACTION
+  // ========================================================================
+
+  describe("unknown action", () => {
+    it("returns error for unrecognized action", async () => {
+      const result = await handleOrders(sb, {
+        action: "refund_everything"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+    });
+  });
+});

package/dist/server/handlers/discovery-advertise.d.ts

@@ -0,0 +1,18 @@
+export declare function advertiseService(name: string, type: string, port: number, txt?: Record<string, string>): {
+    success: boolean;
+    error?: string;
+};
+export declare function stopAdvertise(name: string): {
+    success: boolean;
+    error?: string;
+};
+export declare function listAdvertised(): {
+    success: boolean;
+    data: Array<{
+        name: string;
+        type: string;
+        port: number;
+        host: string;
+        txt?: unknown;
+    }>;
+};

package/dist/server/handlers/discovery-advertise.js

@@ -0,0 +1,101 @@
+// server/handlers/discovery-advertise.ts — mDNS service advertising
+// Extracted from discovery.ts.
+
+import Bonjour from "bonjour-service";
+
+// ============================================================================
+// MODULE-LEVEL STATE
+// ============================================================================
+
+/** Single Bonjour instance shared across advertise operations */
+let bonjourInstance = null;
+
+/** Map of advertised service name -> Service instance for stop/list */
+const advertisedServices = new Map();
+function getBonjour() {
+  if (!bonjourInstance) {
+    bonjourInstance = new Bonjour();
+  }
+  return bonjourInstance;
+}
+
+// ============================================================================
+// ADVERTISE
+// ============================================================================
+
+export function advertiseService(name, type, port, txt) {
+  if (advertisedServices.has(name)) {
+    return {
+      success: false,
+      error: `Service "${name}" is already being advertised. Stop it first with stop_advertise.`
+    };
+  }
+
+  // Strip protocol suffix from type for bonjour-service
+  let cleanType = type;
+  if (cleanType.startsWith("_")) cleanType = cleanType.slice(1);
+  if (cleanType.endsWith("._tcp")) cleanType = cleanType.slice(0, -5);
+  if (cleanType.endsWith("._udp")) cleanType = cleanType.slice(0, -5);
+  try {
+    const bonjour = getBonjour();
+    const service = bonjour.publish({
+      name,
+      type: cleanType,
+      port,
+      txt: txt
+    });
+    advertisedServices.set(name, service);
+    return {
+      success: true
+    };
+  } catch (err) {
+    return {
+      success: false,
+      error: `Failed to advertise service: ${err instanceof Error ? err.message : String(err)}`
+    };
+  }
+}
+
+// ============================================================================
+// STOP ADVERTISE
+// ============================================================================
+
+export function stopAdvertise(name) {
+  const service = advertisedServices.get(name);
+  if (!service) {
+    return {
+      success: false,
+      error: `No advertised service found with name "${name}". Currently advertised: ${advertisedServices.size === 0 ? "none" : Array.from(advertisedServices.keys()).join(", ")}`
+    };
+  }
+  try {
+    if (service.stop) {
+      service.stop();
+    }
+  } catch {
+    // Best-effort cleanup
+  }
+  advertisedServices.delete(name);
+  return {
+    success: true
+  };
+}
+
+// ============================================================================
+// LIST ADVERTISED
+// ============================================================================
+
+export function listAdvertised() {
+  const list = Array.from(advertisedServices.entries()).map(([name, svc]) => ({
+    name,
+    type: svc.type,
+    port: svc.port,
+    host: svc.host,
+    txt: svc.txt
+  }));
+  return {
+    success: true,
+    data: list
+  };
+}
+//# sourceMappingURL=discovery-advertise.js.map

package/dist/server/handlers/discovery-advertise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-advertise.js","names":["Bonjour","bonjourInstance","advertisedServices","Map","getBonjour","advertiseService","name","type","port","txt","has","success","error","cleanType","startsWith","slice","endsWith","bonjour","service","publish","set","err","Error","message","String","stopAdvertise","get","size","Array","from","keys","join","stop","delete","listAdvertised","list","entries","map","svc","host","data"],"sources":["../../../src/server/handlers/discovery-advertise.ts"],"sourcesContent":["// server/handlers/discovery-advertise.ts — mDNS service advertising\n// Extracted from discovery.ts.\n\nimport Bonjour, { type Service } from \"bonjour-service\";\n\n// ============================================================================\n// MODULE-LEVEL STATE\n// ============================================================================\n\n/** Single Bonjour instance shared across advertise operations */\nlet bonjourInstance: Bonjour | null = null;\n\n/** Map of advertised service name -> Service instance for stop/list */\nconst advertisedServices = new Map<string, Service>();\n\nfunction getBonjour(): Bonjour {\n  if (!bonjourInstance) {\n    bonjourInstance = new Bonjour();\n  }\n  return bonjourInstance;\n}\n\n// ============================================================================\n// ADVERTISE\n// ============================================================================\n\nexport function advertiseService(\n  name: string,\n  type: string,\n  port: number,\n  txt?: Record<string, string>\n): { success: boolean; error?: string } {\n  if (advertisedServices.has(name)) {\n    return {\n      success: false,\n      error: `Service \"${name}\" is already being advertised. Stop it first with stop_advertise.`,\n    };\n  }\n\n  // Strip protocol suffix from type for bonjour-service\n  let cleanType = type;\n  if (cleanType.startsWith(\"_\")) cleanType = cleanType.slice(1);\n  if (cleanType.endsWith(\"._tcp\")) cleanType = cleanType.slice(0, -5);\n  if (cleanType.endsWith(\"._udp\")) cleanType = cleanType.slice(0, -5);\n\n  try {\n    const bonjour = getBonjour();\n    const service = bonjour.publish({\n      name,\n      type: cleanType,\n      port,\n      txt: txt as Record<string, string> | undefined,\n    });\n    advertisedServices.set(name, service);\n    return { success: true };\n  } catch (err) {\n    return {\n      success: false,\n      error: `Failed to advertise service: ${err instanceof Error ? err.message : String(err)}`,\n    };\n  }\n}\n\n// ============================================================================\n// STOP ADVERTISE\n// ============================================================================\n\nexport function stopAdvertise(name: string): { success: boolean; error?: string } {\n  const service = advertisedServices.get(name);\n  if (!service) {\n    return {\n      success: false,\n      error: `No advertised service found with name \"${name}\". Currently advertised: ${advertisedServices.size === 0 ? \"none\" : Array.from(advertisedServices.keys()).join(\", \")}`,\n    };\n  }\n\n  try {\n    if (service.stop) {\n      service.stop();\n    }\n  } catch {\n    // Best-effort cleanup\n  }\n  advertisedServices.delete(name);\n  return { success: true };\n}\n\n// ============================================================================\n// LIST ADVERTISED\n// ============================================================================\n\nexport function listAdvertised(): {\n  success: boolean;\n  data: Array<{ name: string; type: string; port: number; host: string; txt?: unknown }>;\n} {\n  const list = Array.from(advertisedServices.entries()).map(([name, svc]) => ({\n    name,\n    type: svc.type,\n    port: svc.port,\n    host: svc.host,\n    txt: svc.txt,\n  }));\n  return { success: true, data: list };\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/server/handlers/discovery-advertise.test.js

@@ -0,0 +1,185 @@
+// discovery-advertise.test.ts — Tests for handleDiscovery advertise/stop/list actions
+
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { HAS_TEST_DB, getTestClient, cleanup, TEST_STORE } from "./__test-utils__/test-db.js";
+
+// ---------------------------------------------------------------------------
+// Mock bonjour-service — vi.hoisted for hoist-safe references
+// ---------------------------------------------------------------------------
+
+const {
+  mockBrowser,
+  mockPublishedService,
+  mockBonjour
+} = vi.hoisted(() => {
+  const _mockBrowser = {
+    on: vi.fn(),
+    stop: vi.fn()
+  };
+  const _mockPublishedService = {
+    name: "TestService",
+    type: "http",
+    port: 3000,
+    host: "test-host.local",
+    txt: {
+      version: "1.0"
+    },
+    addresses: ["192.168.1.10"],
+    stop: vi.fn()
+  };
+  const _mockBonjour = {
+    find: vi.fn().mockReturnValue(_mockBrowser),
+    publish: vi.fn().mockReturnValue(_mockPublishedService),
+    destroy: vi.fn()
+  };
+  return {
+    mockBrowser: _mockBrowser,
+    mockPublishedService: _mockPublishedService,
+    mockBonjour: _mockBonjour
+  };
+});
+vi.mock("bonjour-service", () => {
+  class MockBonjour {
+    find = mockBonjour.find;
+    publish = mockBonjour.publish;
+    destroy = mockBonjour.destroy;
+  }
+  return {
+    default: MockBonjour
+  };
+});
+import { handleDiscovery } from "./discovery.js";
+const sb = getTestClient();
+describe.skipIf(!HAS_TEST_DB)("handleDiscovery — advertise", () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+    vi.clearAllMocks();
+    mockBrowser.on.mockImplementation(() => {});
+    mockBrowser.stop.mockImplementation(() => {});
+    mockBonjour.find.mockReturnValue(mockBrowser);
+    mockBonjour.publish.mockReturnValue(mockPublishedService);
+    mockBonjour.destroy.mockImplementation(() => {});
+    mockPublishedService.stop.mockImplementation(() => {});
+  });
+  afterEach(async () => {
+    vi.useRealTimers();
+    await cleanup();
+  });
+
+  // ========================================================================
+  // ADVERTISE
+  // ========================================================================
+
+  describe("action: advertise", () => {
+    it("advertises a service successfully", async () => {
+      const result = await handleDiscovery(sb, {
+        action: "advertise",
+        name: "MyPOS",
+        type: "_http._tcp",
+        port: 8080,
+        txt: {
+          version: "2.0"
+        }
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      const data = result.data;
+      expect(data.name).toBe("MyPOS");
+      expect(data.port).toBe(8080);
+      expect(data.message).toContain("now being advertised");
+    });
+    it("returns error when name is missing", async () => {
+      const result = await handleDiscovery(sb, {
+        action: "advertise",
+        type: "_http._tcp",
+        port: 8080
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toBe("name is required for advertise");
+    });
+    it("returns error when type is missing", async () => {
+      const result = await handleDiscovery(sb, {
+        action: "advertise",
+        name: "MyPOS",
+        port: 8080
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toBe("type is required for advertise (e.g. _http._tcp)");
+    });
+    it("returns error when port is missing", async () => {
+      const result = await handleDiscovery(sb, {
+        action: "advertise",
+        name: "MyPOS",
+        type: "_http._tcp"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("port is required");
+    });
+    it("returns error when port is not a number", async () => {
+      const result = await handleDiscovery(sb, {
+        action: "advertise",
+        name: "MyPOS",
+        type: "_http._tcp",
+        port: "abc"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("port is required");
+    });
+  });
+
+  // ========================================================================
+  // STOP ADVERTISE
+  // ========================================================================
+
+  describe("action: stop_advertise", () => {
+    it("returns error when name is missing", async () => {
+      const result = await handleDiscovery(sb, {
+        action: "stop_advertise"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toBe("name is required for stop_advertise");
+    });
+    it("returns error when service is not being advertised", async () => {
+      const result = await handleDiscovery(sb, {
+        action: "stop_advertise",
+        name: "NonExistent"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("No advertised service found");
+      expect(result.error).toContain("NonExistent");
+    });
+    it("stops a previously advertised service", async () => {
+      // First advertise
+      await handleDiscovery(sb, {
+        action: "advertise",
+        name: "Stoppable",
+        type: "_http._tcp",
+        port: 9090
+      }, TEST_STORE);
+
+      // Then stop it
+      const result = await handleDiscovery(sb, {
+        action: "stop_advertise",
+        name: "Stoppable"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      const data = result.data;
+      expect(data.message).toContain("Stopped advertising");
+    });
+  });
+
+  // ========================================================================
+  // LIST ADVERTISED
+  // ========================================================================
+
+  describe("action: list_advertised", () => {
+    it("returns list of advertised services", async () => {
+      const result = await handleDiscovery(sb, {
+        action: "list_advertised"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      const data = result.data;
+      expect(data.count).toBeDefined();
+      expect(data.services).toBeDefined();
+    });
+  });
+});

package/dist/server/handlers/discovery-scan.d.ts

@@ -0,0 +1,19 @@
+export interface DiscoveredService {
+    name: string;
+    type: string;
+    host: string;
+    port: number;
+    addresses: string[] | undefined;
+    txt: Record<string, unknown> | undefined;
+}
+/** Common service types to scan when doing a broad discovery */
+export declare const COMMON_SERVICE_TYPES: string[];
+/**
+ * Scan the local network for mDNS services.
+ * Creates a short-lived Bonjour instance per scan to avoid memory leaks.
+ */
+export declare function scanServices(serviceType: string, timeoutMs: number): Promise<DiscoveredService[]>;
+/**
+ * Multi-type scan: run parallel scans for common service types.
+ */
+export declare function scanAllCommonTypes(timeoutMs: number): Promise<DiscoveredService[]>;

package/dist/server/handlers/discovery-scan.js

@@ -0,0 +1,107 @@
+// server/handlers/discovery-scan.ts — mDNS scanning and service discovery
+// Extracted from discovery.ts.
+
+import Bonjour from "bonjour-service";
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+/** Common service types to scan when doing a broad discovery */
+export const COMMON_SERVICE_TYPES = ["http", "https", "printer", "ipp", "pos", "airplay", "raop", "smb", "ftp", "ssh", "mqtt"];
+
+// ============================================================================
+// SCAN
+// ============================================================================
+
+/**
+ * Scan the local network for mDNS services.
+ * Creates a short-lived Bonjour instance per scan to avoid memory leaks.
+ */
+export async function scanServices(serviceType, timeoutMs) {
+  return new Promise((resolve, reject) => {
+    let bonjour;
+    try {
+      bonjour = new Bonjour();
+    } catch (err) {
+      reject(new Error(`mDNS not available on this host. This typically happens in Docker/cloud environments without multicast support. (${err instanceof Error ? err.message : String(err)})`));
+      return;
+    }
+    const services = [];
+    const seen = new Set();
+
+    // Strip leading underscore and trailing protocol if user passed full form
+    // e.g. "_http._tcp" -> "http"
+    let type = serviceType;
+    if (type.startsWith("_")) type = type.slice(1);
+    if (type.endsWith("._tcp")) type = type.slice(0, -5);
+    if (type.endsWith("._udp")) type = type.slice(0, -5);
+    let browser;
+    try {
+      browser = bonjour.find({
+        type
+      });
+    } catch (err) {
+      bonjour.destroy();
+      reject(new Error(`Failed to start mDNS browser: ${err instanceof Error ? err.message : String(err)}`));
+      return;
+    }
+    browser.on("up", service => {
+      const key = `${service.name}::${service.type}::${service.port}`;
+      if (!seen.has(key)) {
+        seen.add(key);
+        services.push({
+          name: service.name,
+          type: service.type,
+          host: service.host,
+          port: service.port,
+          addresses: service.addresses,
+          txt: service.txt
+        });
+      }
+    });
+    const timer = setTimeout(() => {
+      try {
+        browser.stop();
+        bonjour.destroy();
+      } catch {
+        // Ignore cleanup errors
+      }
+      resolve(services);
+    }, timeoutMs);
+
+    // Safety: if the browser errors out, resolve with whatever we have
+    browser.on("error", () => {
+      clearTimeout(timer);
+      try {
+        browser.stop();
+        bonjour.destroy();
+      } catch {
+        // Ignore cleanup errors
+      }
+      resolve(services);
+    });
+  });
+}
+
+/**
+ * Multi-type scan: run parallel scans for common service types.
+ */
+export async function scanAllCommonTypes(timeoutMs) {
+  const results = await Promise.allSettled(COMMON_SERVICE_TYPES.map(type => scanServices(type, timeoutMs)));
+  const allServices = [];
+  const seen = new Set();
+  for (const result of results) {
+    if (result.status === "fulfilled") {
+      for (const svc of result.value) {
+        const key = `${svc.name}::${svc.type}::${svc.port}`;
+        if (!seen.has(key)) {
+          seen.add(key);
+          allServices.push(svc);
+        }
+      }
+    }
+  }
+  return allServices;
+}
+//# sourceMappingURL=discovery-scan.js.map

package/dist/server/handlers/discovery-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-scan.js","names":["Bonjour","COMMON_SERVICE_TYPES","scanServices","serviceType","timeoutMs","Promise","resolve","reject","bonjour","err","Error","message","String","services","seen","Set","type","startsWith","slice","endsWith","browser","find","destroy","on","service","key","name","port","has","add","push","host","addresses","txt","timer","setTimeout","stop","clearTimeout","scanAllCommonTypes","results","allSettled","map","allServices","result","status","svc","value"],"sources":["../../../src/server/handlers/discovery-scan.ts"],"sourcesContent":["// server/handlers/discovery-scan.ts — mDNS scanning and service discovery\n// Extracted from discovery.ts.\n\nimport Bonjour, { type Service } from \"bonjour-service\";\n\n// ============================================================================\n// TYPES\n// ============================================================================\n\nexport interface DiscoveredService {\n  name: string;\n  type: string;\n  host: string;\n  port: number;\n  addresses: string[] | undefined;\n  txt: Record<string, unknown> | undefined;\n}\n\n/** Common service types to scan when doing a broad discovery */\nexport const COMMON_SERVICE_TYPES = [\n  \"http\",\n  \"https\",\n  \"printer\",\n  \"ipp\",\n  \"pos\",\n  \"airplay\",\n  \"raop\",\n  \"smb\",\n  \"ftp\",\n  \"ssh\",\n  \"mqtt\",\n];\n\n// ============================================================================\n// SCAN\n// ============================================================================\n\n/**\n * Scan the local network for mDNS services.\n * Creates a short-lived Bonjour instance per scan to avoid memory leaks.\n */\nexport async function scanServices(\n  serviceType: string,\n  timeoutMs: number\n): Promise<DiscoveredService[]> {\n  return new Promise((resolve, reject) => {\n    let bonjour: Bonjour;\n    try {\n      bonjour = new Bonjour();\n    } catch (err) {\n      reject(\n        new Error(\n          `mDNS not available on this host. This typically happens in Docker/cloud environments without multicast support. (${err instanceof Error ? err.message : String(err)})`\n        )\n      );\n      return;\n    }\n\n    const services: DiscoveredService[] = [];\n    const seen = new Set<string>();\n\n    // Strip leading underscore and trailing protocol if user passed full form\n    // e.g. \"_http._tcp\" -> \"http\"\n    let type = serviceType;\n    if (type.startsWith(\"_\")) type = type.slice(1);\n    if (type.endsWith(\"._tcp\")) type = type.slice(0, -5);\n    if (type.endsWith(\"._udp\")) type = type.slice(0, -5);\n\n    let browser: ReturnType<typeof bonjour.find>;\n    try {\n      browser = bonjour.find({ type });\n    } catch (err) {\n      bonjour.destroy();\n      reject(\n        new Error(\n          `Failed to start mDNS browser: ${err instanceof Error ? err.message : String(err)}`\n        )\n      );\n      return;\n    }\n\n    browser.on(\"up\", (service: Service) => {\n      const key = `${service.name}::${service.type}::${service.port}`;\n      if (!seen.has(key)) {\n        seen.add(key);\n        services.push({\n          name: service.name,\n          type: service.type,\n          host: service.host,\n          port: service.port,\n          addresses: service.addresses,\n          txt: service.txt as Record<string, unknown> | undefined,\n        });\n      }\n    });\n\n    const timer = setTimeout(() => {\n      try {\n        browser.stop();\n        bonjour.destroy();\n      } catch {\n        // Ignore cleanup errors\n      }\n      resolve(services);\n    }, timeoutMs);\n\n    // Safety: if the browser errors out, resolve with whatever we have\n    browser.on(\"error\", () => {\n      clearTimeout(timer);\n      try {\n        browser.stop();\n        bonjour.destroy();\n      } catch {\n        // Ignore cleanup errors\n      }\n      resolve(services);\n    });\n  });\n}\n\n/**\n * Multi-type scan: run parallel scans for common service types.\n */\nexport async function scanAllCommonTypes(\n  timeoutMs: number\n): Promise<DiscoveredService[]> {\n  const results = await Promise.allSettled(\n    COMMON_SERVICE_TYPES.map((type) => scanServices(type, timeoutMs))\n  );\n\n  const allServices: DiscoveredService[] = [];\n  const seen = new Set<string>();\n\n  for (const result of results) {\n    if (result.status === \"fulfilled\") {\n      for (const svc of result.value) {\n        const key = `${svc.name}::${svc.type}::${svc.port}`;\n        if (!seen.has(key)) {\n          seen.add(key);\n          allServices.push(svc);\n        }\n      }\n    }\n  }\n\n  return allServices;\n}\n"],"mappings":"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","ignoreList":[]}