@happenv/print-agent-sdk 0.1.0

package/README.md

@@ -0,0 +1,57 @@
+# @happenv/print-agent-sdk
+
+A simple SDK for the local print agent (WebSocket): connect, status, printer
+list, version, and PDF printing. No runtime dependencies.
+
+## Installation
+
+```bash
+npm install @happenv/print-agent-sdk
+```
+
+## Usage
+
+```ts
+import { PrintAgent } from "@happenv/print-agent-sdk";
+
+const agent = new PrintAgent({ port: 45123 }); // wss://localhost:45123/ws
+
+agent.onStatusChange((s) => console.log("status:", s));
+
+await agent.connect();
+
+const printers = await agent.getPrinters();
+console.log(printers); // [{ name, default }]
+
+await agent.print({
+  printer: printers[0].name,
+  url: "https://example.com/document.pdf", // or base64: "<...>"
+  copies: 1,
+});
+
+agent.disconnect();
+```
+
+## API
+
+- `new PrintAgent(options)` — `{ host?, port?, url?, autoReconnect?, requestTimeoutMs?, WebSocket? }`
+- `connect()` / `disconnect()`
+- `status` / `isConnected()` / `onStatusChange(cb)` — status: `connecting | open | closed`
+- `getPrinters()` → `{ name, default }[]`
+- `getVersion()` → `{ brand, version }`
+- `print({ printer, url? | base64?, copies? })` — resolves once the agent confirms;
+  rejects with `AgentError` on an agent-side error
+
+Errors: `NotConnectedError`, `TimeoutError`, `AgentError`.
+
+## Notes
+
+- The SDK connects over `wss` using a certificate signed by the product's local
+  Root CA — it only works from pages on the agent's **origin allowlist** and on a
+  machine where the **Root CA is trusted** (installed by the agent's installer).
+- **Print cancellation is not supported**: once a job is handed to the system
+  spooler it cannot be reliably revoked.
+- In Node, pass a WebSocket implementation: `new PrintAgent({ WebSocket })`.
+- **Auto-reconnect** is enabled by default. If `connect()` rejects (e.g. on
+  timeout), the SDK still keeps retrying in the background with backoff — call
+  `disconnect()` to stop it.

package/dist/index.cjs

@@ -0,0 +1,244 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AgentError: () => AgentError,
+  NotConnectedError: () => NotConnectedError,
+  PrintAgent: () => PrintAgent,
+  TimeoutError: () => TimeoutError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/types.ts
+var NotConnectedError = class extends Error {
+  constructor(message = "brak po\u0142\u0105czenia z agentem") {
+    super(message);
+    this.name = "NotConnectedError";
+  }
+};
+var TimeoutError = class extends Error {
+  constructor(message = "przekroczono czas oczekiwania na odpowied\u017A agenta") {
+    super(message);
+    this.name = "TimeoutError";
+  }
+};
+var AgentError = class extends Error {
+  constructor(message = "b\u0142\u0105d agenta") {
+    super(message);
+    this.name = "AgentError";
+  }
+};
+
+// src/client.ts
+var RECONNECT_BACKOFF_MS = [1e3, 2e3, 5e3, 1e4];
+var PrintAgent = class {
+  constructor(opts = {}) {
+    this._status = "closed";
+    this.statusListeners = /* @__PURE__ */ new Set();
+    this.pending = /* @__PURE__ */ new Map();
+    this.idCounter = 0;
+    this.wantConnected = false;
+    this.reconnectAttempt = 0;
+    const host = opts.host ?? "localhost";
+    const port = opts.port ?? 45123;
+    this.url = opts.url ?? `wss://${host}:${port}/ws`;
+    this.autoReconnect = opts.autoReconnect ?? true;
+    this.requestTimeoutMs = opts.requestTimeoutMs ?? 1e4;
+    const ctor = opts.WebSocket ?? globalThis.WebSocket;
+    if (!ctor) {
+      throw new Error("brak implementacji WebSocket (przeka\u017C opcj\u0119 WebSocket)");
+    }
+    this.WS = ctor;
+  }
+  get status() {
+    return this._status;
+  }
+  isConnected() {
+    return this._status === "open";
+  }
+  /** Rejestruje nasłuch zmian statusu; zwraca funkcję wyrejestrowującą. */
+  onStatusChange(cb) {
+    this.statusListeners.add(cb);
+    return () => this.statusListeners.delete(cb);
+  }
+  /** Łączy z agentem; resolve po otwarciu, reject przy timeoucie/zerwaniu.
+   *  Idempotentne, gdy połączenie jest już otwarte. */
+  connect() {
+    this.wantConnected = true;
+    if (this._status === "open") {
+      return Promise.resolve();
+    }
+    return new Promise((resolve, reject) => {
+      this.openSocket(resolve, reject);
+    });
+  }
+  /** Zamyka połączenie i wyłącza auto-reconnect. */
+  disconnect() {
+    this.wantConnected = false;
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = void 0;
+    }
+    if (this.ws) {
+      this.ws.close();
+    }
+  }
+  /** Lista drukarek zainstalowanych w systemie klienta. */
+  async getPrinters() {
+    const r = await this.request({ type: "listPrinters" });
+    return r.printers ?? [];
+  }
+  /** Wersja i brand agenta. */
+  async getVersion() {
+    const r = await this.request({ type: "version" });
+    return { brand: r.brand ?? "", version: r.version ?? "" };
+  }
+  /** Wysyła zadanie druku PDF; resolve po potwierdzeniu agenta. */
+  async print(opts) {
+    if (!opts || !opts.printer) {
+      throw new Error("print: wymagana nazwa drukarki (printer)");
+    }
+    const hasUrl = typeof opts.url === "string" && opts.url.length > 0;
+    const hasB64 = typeof opts.base64 === "string" && opts.base64.length > 0;
+    if (hasUrl === hasB64) {
+      throw new Error("print: podaj dok\u0142adnie jedno \u017Ar\xF3d\u0142o \u2014 url albo base64");
+    }
+    const pdf = hasUrl ? { url: opts.url } : { base64: opts.base64 };
+    await this.request({
+      type: "printPDF",
+      printer: opts.printer,
+      pdf,
+      copies: opts.copies
+    });
+  }
+  // --- wewnętrzne ---
+  openSocket(onOpen, onFail) {
+    this.setStatus("connecting");
+    let settled = false;
+    const ws = new this.WS(this.url);
+    this.ws = ws;
+    const connectTimer = setTimeout(() => {
+      if (!settled) {
+        settled = true;
+        try {
+          ws.close();
+        } catch {
+        }
+        onFail?.(new TimeoutError("przekroczono czas \u0142\u0105czenia z agentem"));
+      }
+    }, this.requestTimeoutMs);
+    ws.onopen = () => {
+      settled = true;
+      clearTimeout(connectTimer);
+      this.reconnectAttempt = 0;
+      this.setStatus("open");
+      onOpen?.();
+    };
+    ws.onmessage = (ev) => this.handleMessage(ev.data);
+    ws.onerror = () => {
+    };
+    ws.onclose = () => {
+      clearTimeout(connectTimer);
+      this.ws = void 0;
+      this.setStatus("closed");
+      this.rejectAllPending(new NotConnectedError("po\u0142\u0105czenie zamkni\u0119te"));
+      if (!settled) {
+        settled = true;
+        onFail?.(new NotConnectedError("nie uda\u0142o si\u0119 po\u0142\u0105czy\u0107 z agentem"));
+      }
+      if (this.wantConnected && this.autoReconnect) {
+        this.scheduleReconnect();
+      }
+    };
+  }
+  scheduleReconnect() {
+    const delay = RECONNECT_BACKOFF_MS[Math.min(this.reconnectAttempt, RECONNECT_BACKOFF_MS.length - 1)];
+    this.reconnectAttempt++;
+    this.reconnectTimer = setTimeout(() => {
+      if (this.wantConnected) {
+        this.openSocket();
+      }
+    }, delay);
+  }
+  handleMessage(data) {
+    const text = typeof data === "string" ? data : String(data);
+    let msg;
+    try {
+      msg = JSON.parse(text);
+    } catch {
+      return;
+    }
+    const id = msg.id;
+    if (!id) return;
+    const p = this.pending.get(id);
+    if (!p) return;
+    clearTimeout(p.timer);
+    this.pending.delete(id);
+    if (msg.ok) {
+      p.resolve(msg);
+    } else {
+      p.reject(new AgentError(msg.error || "b\u0142\u0105d agenta"));
+    }
+  }
+  request(payload) {
+    if (!this.isConnected() || !this.ws) {
+      return Promise.reject(new NotConnectedError());
+    }
+    const id = String(++this.idCounter);
+    const ws = this.ws;
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this.pending.delete(id);
+        reject(new TimeoutError());
+      }, this.requestTimeoutMs);
+      this.pending.set(id, { resolve, reject, timer });
+      try {
+        ws.send(JSON.stringify({ ...payload, id }));
+      } catch (e) {
+        clearTimeout(timer);
+        this.pending.delete(id);
+        reject(e instanceof Error ? e : new Error(String(e)));
+      }
+    });
+  }
+  rejectAllPending(err) {
+    for (const [, p] of this.pending) {
+      clearTimeout(p.timer);
+      p.reject(err);
+    }
+    this.pending.clear();
+  }
+  setStatus(s) {
+    if (this._status === s) return;
+    this._status = s;
+    for (const cb of this.statusListeners) {
+      cb(s);
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentError,
+  NotConnectedError,
+  PrintAgent,
+  TimeoutError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/client.ts"],"sourcesContent":["export { PrintAgent } from \"./client\";\nexport {\n  AgentError,\n  NotConnectedError,\n  TimeoutError,\n  type AgentVersion,\n  type ConnectionStatus,\n  type Printer,\n  type PrintAgentOptions,\n  type PrintOptions,\n  type WebSocketCtor,\n  type WebSocketLike,\n} from \"./types\";\n","/** Status połączenia z lokalnym agentem. */\nexport type ConnectionStatus = \"connecting\" | \"open\" | \"closed\";\n\n/** Drukarka zwrócona przez agenta. */\nexport interface Printer {\n  name: string;\n  default: boolean;\n}\n\n/** Wersja agenta. */\nexport interface AgentVersion {\n  brand: string;\n  version: string;\n}\n\n/** Parametry zadania druku. Dokładnie jedno ze źródeł: url albo base64. */\nexport interface PrintOptions {\n  printer: string;\n  url?: string;\n  base64?: string;\n  copies?: number;\n}\n\n/** Opcje konstruktora PrintAgent. */\nexport interface PrintAgentOptions {\n  host?: string;\n  port?: number;\n  url?: string;\n  autoReconnect?: boolean;\n  requestTimeoutMs?: number;\n  WebSocket?: WebSocketCtor;\n}\n\n/** Minimalny interfejs WebSocket używany przez SDK (zgodny z przeglądarką i pakietem ws). */\nexport interface WebSocketLike {\n  send(data: string): void;\n  close(): void;\n  onopen: ((ev: unknown) => void) | null;\n  onmessage: ((ev: { data: unknown }) => void) | null;\n  onclose: ((ev: unknown) => void) | null;\n  onerror: ((ev: unknown) => void) | null;\n}\n\nexport interface WebSocketCtor {\n  new (url: string): WebSocketLike;\n}\n\n/** Brak aktywnego połączenia z agentem. */\nexport class NotConnectedError extends Error {\n  constructor(message = \"brak połączenia z agentem\") {\n    super(message);\n    this.name = \"NotConnectedError\";\n  }\n}\n\n/** Przekroczono czas oczekiwania na odpowiedź agenta. */\nexport class TimeoutError extends Error {\n  constructor(message = \"przekroczono czas oczekiwania na odpowiedź agenta\") {\n    super(message);\n    this.name = \"TimeoutError\";\n  }\n}\n\n/** Agent odpowiedział błędem (ok:false). */\nexport class AgentError extends Error {\n  constructor(message = \"błąd agenta\") {\n    super(message);\n    this.name = \"AgentError\";\n  }\n}\n","import {\n  AgentError,\n  NotConnectedError,\n  TimeoutError,\n  type AgentVersion,\n  type ConnectionStatus,\n  type PrintAgentOptions,\n  type PrintOptions,\n  type Printer,\n  type WebSocketCtor,\n  type WebSocketLike,\n} from \"./types\";\n\ninterface AgentResponse {\n  type: string;\n  id?: string;\n  ok: boolean;\n  error?: string;\n  printers?: Printer[];\n  brand?: string;\n  version?: string;\n}\n\ninterface Pending {\n  resolve: (r: AgentResponse) => void;\n  reject: (e: Error) => void;\n  timer: ReturnType<typeof setTimeout>;\n}\n\nconst RECONNECT_BACKOFF_MS = [1000, 2000, 5000, 10000];\n\n/** Klient lokalnego agenta druku. */\nexport class PrintAgent {\n  private readonly url: string;\n  private readonly autoReconnect: boolean;\n  private readonly requestTimeoutMs: number;\n  private readonly WS: WebSocketCtor;\n\n  private ws?: WebSocketLike;\n  private _status: ConnectionStatus = \"closed\";\n  private statusListeners = new Set<(s: ConnectionStatus) => void>();\n  private pending = new Map<string, Pending>();\n  private idCounter = 0;\n  private wantConnected = false;\n  private reconnectAttempt = 0;\n  private reconnectTimer?: ReturnType<typeof setTimeout>;\n\n  constructor(opts: PrintAgentOptions = {}) {\n    const host = opts.host ?? \"localhost\";\n    const port = opts.port ?? 45123;\n    this.url = opts.url ?? `wss://${host}:${port}/ws`;\n    this.autoReconnect = opts.autoReconnect ?? true;\n    this.requestTimeoutMs = opts.requestTimeoutMs ?? 10000;\n    const ctor = opts.WebSocket ?? (globalThis as { WebSocket?: WebSocketCtor }).WebSocket;\n    if (!ctor) {\n      throw new Error(\"brak implementacji WebSocket (przekaż opcję WebSocket)\");\n    }\n    this.WS = ctor;\n  }\n\n  get status(): ConnectionStatus {\n    return this._status;\n  }\n\n  isConnected(): boolean {\n    return this._status === \"open\";\n  }\n\n  /** Rejestruje nasłuch zmian statusu; zwraca funkcję wyrejestrowującą. */\n  onStatusChange(cb: (s: ConnectionStatus) => void): () => void {\n    this.statusListeners.add(cb);\n    return () => this.statusListeners.delete(cb);\n  }\n\n  /** Łączy z agentem; resolve po otwarciu, reject przy timeoucie/zerwaniu.\n   *  Idempotentne, gdy połączenie jest już otwarte. */\n  connect(): Promise<void> {\n    this.wantConnected = true;\n    if (this._status === \"open\") {\n      return Promise.resolve();\n    }\n    return new Promise<void>((resolve, reject) => {\n      this.openSocket(resolve, reject);\n    });\n  }\n\n  /** Zamyka połączenie i wyłącza auto-reconnect. */\n  disconnect(): void {\n    this.wantConnected = false;\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = undefined;\n    }\n    if (this.ws) {\n      this.ws.close();\n    }\n  }\n\n  /** Lista drukarek zainstalowanych w systemie klienta. */\n  async getPrinters(): Promise<Printer[]> {\n    const r = await this.request({ type: \"listPrinters\" });\n    return r.printers ?? [];\n  }\n\n  /** Wersja i brand agenta. */\n  async getVersion(): Promise<AgentVersion> {\n    const r = await this.request({ type: \"version\" });\n    return { brand: r.brand ?? \"\", version: r.version ?? \"\" };\n  }\n\n  /** Wysyła zadanie druku PDF; resolve po potwierdzeniu agenta. */\n  async print(opts: PrintOptions): Promise<void> {\n    if (!opts || !opts.printer) {\n      throw new Error(\"print: wymagana nazwa drukarki (printer)\");\n    }\n    const hasUrl = typeof opts.url === \"string\" && opts.url.length > 0;\n    const hasB64 = typeof opts.base64 === \"string\" && opts.base64.length > 0;\n    if (hasUrl === hasB64) {\n      throw new Error(\"print: podaj dokładnie jedno źródło — url albo base64\");\n    }\n    const pdf = hasUrl ? { url: opts.url } : { base64: opts.base64 };\n    await this.request({\n      type: \"printPDF\",\n      printer: opts.printer,\n      pdf,\n      copies: opts.copies,\n    });\n  }\n\n  // --- wewnętrzne ---\n\n  private openSocket(\n    onOpen?: () => void,\n    onFail?: (e: Error) => void\n  ): void {\n    this.setStatus(\"connecting\");\n    let settled = false;\n    const ws = new this.WS(this.url);\n    this.ws = ws;\n\n    const connectTimer = setTimeout(() => {\n      if (!settled) {\n        settled = true;\n        try {\n          ws.close();\n        } catch {\n          /* ignore */\n        }\n        onFail?.(new TimeoutError(\"przekroczono czas łączenia z agentem\"));\n      }\n    }, this.requestTimeoutMs);\n\n    ws.onopen = () => {\n      settled = true;\n      clearTimeout(connectTimer);\n      this.reconnectAttempt = 0;\n      this.setStatus(\"open\");\n      onOpen?.();\n    };\n    ws.onmessage = (ev) => this.handleMessage(ev.data);\n    ws.onerror = () => {\n      /* po błędzie nastąpi onclose */\n    };\n    ws.onclose = () => {\n      clearTimeout(connectTimer);\n      this.ws = undefined;\n      this.setStatus(\"closed\");\n      this.rejectAllPending(new NotConnectedError(\"połączenie zamknięte\"));\n      if (!settled) {\n        settled = true;\n        onFail?.(new NotConnectedError(\"nie udało się połączyć z agentem\"));\n      }\n      if (this.wantConnected && this.autoReconnect) {\n        this.scheduleReconnect();\n      }\n    };\n  }\n\n  private scheduleReconnect(): void {\n    const delay =\n      RECONNECT_BACKOFF_MS[Math.min(this.reconnectAttempt, RECONNECT_BACKOFF_MS.length - 1)];\n    this.reconnectAttempt++;\n    this.reconnectTimer = setTimeout(() => {\n      if (this.wantConnected) {\n        this.openSocket();\n      }\n    }, delay);\n  }\n\n  private handleMessage(data: unknown): void {\n    const text = typeof data === \"string\" ? data : String(data);\n    let msg: AgentResponse;\n    try {\n      msg = JSON.parse(text);\n    } catch {\n      return;\n    }\n    const id = msg.id;\n    if (!id) return;\n    const p = this.pending.get(id);\n    if (!p) return;\n    clearTimeout(p.timer);\n    this.pending.delete(id);\n    if (msg.ok) {\n      p.resolve(msg);\n    } else {\n      p.reject(new AgentError(msg.error || \"błąd agenta\"));\n    }\n  }\n\n  private request(payload: Record<string, unknown>): Promise<AgentResponse> {\n    if (!this.isConnected() || !this.ws) {\n      return Promise.reject(new NotConnectedError());\n    }\n    const id = String(++this.idCounter);\n    const ws = this.ws;\n    return new Promise<AgentResponse>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        this.pending.delete(id);\n        reject(new TimeoutError());\n      }, this.requestTimeoutMs);\n      this.pending.set(id, { resolve, reject, timer });\n      try {\n        ws.send(JSON.stringify({ ...payload, id }));\n      } catch (e) {\n        clearTimeout(timer);\n        this.pending.delete(id);\n        reject(e instanceof Error ? e : new Error(String(e)));\n      }\n    });\n  }\n\n  private rejectAllPending(err: Error): void {\n    for (const [, p] of this.pending) {\n      clearTimeout(p.timer);\n      p.reject(err);\n    }\n    this.pending.clear();\n  }\n\n  private setStatus(s: ConnectionStatus): void {\n    if (this._status === s) return;\n    this._status = s;\n    for (const cb of this.statusListeners) {\n      cb(s);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,94 @@
+/** Status połączenia z lokalnym agentem. */
+type ConnectionStatus = "connecting" | "open" | "closed";
+/** Drukarka zwrócona przez agenta. */
+interface Printer {
+    name: string;
+    default: boolean;
+}
+/** Wersja agenta. */
+interface AgentVersion {
+    brand: string;
+    version: string;
+}
+/** Parametry zadania druku. Dokładnie jedno ze źródeł: url albo base64. */
+interface PrintOptions {
+    printer: string;
+    url?: string;
+    base64?: string;
+    copies?: number;
+}
+/** Opcje konstruktora PrintAgent. */
+interface PrintAgentOptions {
+    host?: string;
+    port?: number;
+    url?: string;
+    autoReconnect?: boolean;
+    requestTimeoutMs?: number;
+    WebSocket?: WebSocketCtor;
+}
+/** Minimalny interfejs WebSocket używany przez SDK (zgodny z przeglądarką i pakietem ws). */
+interface WebSocketLike {
+    send(data: string): void;
+    close(): void;
+    onopen: ((ev: unknown) => void) | null;
+    onmessage: ((ev: {
+        data: unknown;
+    }) => void) | null;
+    onclose: ((ev: unknown) => void) | null;
+    onerror: ((ev: unknown) => void) | null;
+}
+interface WebSocketCtor {
+    new (url: string): WebSocketLike;
+}
+/** Brak aktywnego połączenia z agentem. */
+declare class NotConnectedError extends Error {
+    constructor(message?: string);
+}
+/** Przekroczono czas oczekiwania na odpowiedź agenta. */
+declare class TimeoutError extends Error {
+    constructor(message?: string);
+}
+/** Agent odpowiedział błędem (ok:false). */
+declare class AgentError extends Error {
+    constructor(message?: string);
+}
+
+/** Klient lokalnego agenta druku. */
+declare class PrintAgent {
+    private readonly url;
+    private readonly autoReconnect;
+    private readonly requestTimeoutMs;
+    private readonly WS;
+    private ws?;
+    private _status;
+    private statusListeners;
+    private pending;
+    private idCounter;
+    private wantConnected;
+    private reconnectAttempt;
+    private reconnectTimer?;
+    constructor(opts?: PrintAgentOptions);
+    get status(): ConnectionStatus;
+    isConnected(): boolean;
+    /** Rejestruje nasłuch zmian statusu; zwraca funkcję wyrejestrowującą. */
+    onStatusChange(cb: (s: ConnectionStatus) => void): () => void;
+    /** Łączy z agentem; resolve po otwarciu, reject przy timeoucie/zerwaniu.
+     *  Idempotentne, gdy połączenie jest już otwarte. */
+    connect(): Promise<void>;
+    /** Zamyka połączenie i wyłącza auto-reconnect. */
+    disconnect(): void;
+    /** Lista drukarek zainstalowanych w systemie klienta. */
+    getPrinters(): Promise<Printer[]>;
+    /** Wersja i brand agenta. */
+    getVersion(): Promise<AgentVersion>;
+    /** Wysyła zadanie druku PDF; resolve po potwierdzeniu agenta. */
+    print(opts: PrintOptions): Promise<void>;
+    private openSocket;
+    private scheduleReconnect;
+    private handleMessage;
+    private request;
+    private rejectAllPending;
+    private setStatus;
+}
+
+export { AgentError, type AgentVersion, type ConnectionStatus, NotConnectedError, PrintAgent, type PrintAgentOptions, type PrintOptions, type Printer, TimeoutError, type WebSocketCtor, type WebSocketLike };

package/dist/index.d.ts

@@ -0,0 +1,94 @@
+/** Status połączenia z lokalnym agentem. */
+type ConnectionStatus = "connecting" | "open" | "closed";
+/** Drukarka zwrócona przez agenta. */
+interface Printer {
+    name: string;
+    default: boolean;
+}
+/** Wersja agenta. */
+interface AgentVersion {
+    brand: string;
+    version: string;
+}
+/** Parametry zadania druku. Dokładnie jedno ze źródeł: url albo base64. */
+interface PrintOptions {
+    printer: string;
+    url?: string;
+    base64?: string;
+    copies?: number;
+}
+/** Opcje konstruktora PrintAgent. */
+interface PrintAgentOptions {
+    host?: string;
+    port?: number;
+    url?: string;
+    autoReconnect?: boolean;
+    requestTimeoutMs?: number;
+    WebSocket?: WebSocketCtor;
+}
+/** Minimalny interfejs WebSocket używany przez SDK (zgodny z przeglądarką i pakietem ws). */
+interface WebSocketLike {
+    send(data: string): void;
+    close(): void;
+    onopen: ((ev: unknown) => void) | null;
+    onmessage: ((ev: {
+        data: unknown;
+    }) => void) | null;
+    onclose: ((ev: unknown) => void) | null;
+    onerror: ((ev: unknown) => void) | null;
+}
+interface WebSocketCtor {
+    new (url: string): WebSocketLike;
+}
+/** Brak aktywnego połączenia z agentem. */
+declare class NotConnectedError extends Error {
+    constructor(message?: string);
+}
+/** Przekroczono czas oczekiwania na odpowiedź agenta. */
+declare class TimeoutError extends Error {
+    constructor(message?: string);
+}
+/** Agent odpowiedział błędem (ok:false). */
+declare class AgentError extends Error {
+    constructor(message?: string);
+}
+
+/** Klient lokalnego agenta druku. */
+declare class PrintAgent {
+    private readonly url;
+    private readonly autoReconnect;
+    private readonly requestTimeoutMs;
+    private readonly WS;
+    private ws?;
+    private _status;
+    private statusListeners;
+    private pending;
+    private idCounter;
+    private wantConnected;
+    private reconnectAttempt;
+    private reconnectTimer?;
+    constructor(opts?: PrintAgentOptions);
+    get status(): ConnectionStatus;
+    isConnected(): boolean;
+    /** Rejestruje nasłuch zmian statusu; zwraca funkcję wyrejestrowującą. */
+    onStatusChange(cb: (s: ConnectionStatus) => void): () => void;
+    /** Łączy z agentem; resolve po otwarciu, reject przy timeoucie/zerwaniu.
+     *  Idempotentne, gdy połączenie jest już otwarte. */
+    connect(): Promise<void>;
+    /** Zamyka połączenie i wyłącza auto-reconnect. */
+    disconnect(): void;
+    /** Lista drukarek zainstalowanych w systemie klienta. */
+    getPrinters(): Promise<Printer[]>;
+    /** Wersja i brand agenta. */
+    getVersion(): Promise<AgentVersion>;
+    /** Wysyła zadanie druku PDF; resolve po potwierdzeniu agenta. */
+    print(opts: PrintOptions): Promise<void>;
+    private openSocket;
+    private scheduleReconnect;
+    private handleMessage;
+    private request;
+    private rejectAllPending;
+    private setStatus;
+}
+
+export { AgentError, type AgentVersion, type ConnectionStatus, NotConnectedError, PrintAgent, type PrintAgentOptions, type PrintOptions, type Printer, TimeoutError, type WebSocketCtor, type WebSocketLike };

package/dist/index.js

@@ -0,0 +1,214 @@
+// src/types.ts
+var NotConnectedError = class extends Error {
+  constructor(message = "brak po\u0142\u0105czenia z agentem") {
+    super(message);
+    this.name = "NotConnectedError";
+  }
+};
+var TimeoutError = class extends Error {
+  constructor(message = "przekroczono czas oczekiwania na odpowied\u017A agenta") {
+    super(message);
+    this.name = "TimeoutError";
+  }
+};
+var AgentError = class extends Error {
+  constructor(message = "b\u0142\u0105d agenta") {
+    super(message);
+    this.name = "AgentError";
+  }
+};
+
+// src/client.ts
+var RECONNECT_BACKOFF_MS = [1e3, 2e3, 5e3, 1e4];
+var PrintAgent = class {
+  constructor(opts = {}) {
+    this._status = "closed";
+    this.statusListeners = /* @__PURE__ */ new Set();
+    this.pending = /* @__PURE__ */ new Map();
+    this.idCounter = 0;
+    this.wantConnected = false;
+    this.reconnectAttempt = 0;
+    const host = opts.host ?? "localhost";
+    const port = opts.port ?? 45123;
+    this.url = opts.url ?? `wss://${host}:${port}/ws`;
+    this.autoReconnect = opts.autoReconnect ?? true;
+    this.requestTimeoutMs = opts.requestTimeoutMs ?? 1e4;
+    const ctor = opts.WebSocket ?? globalThis.WebSocket;
+    if (!ctor) {
+      throw new Error("brak implementacji WebSocket (przeka\u017C opcj\u0119 WebSocket)");
+    }
+    this.WS = ctor;
+  }
+  get status() {
+    return this._status;
+  }
+  isConnected() {
+    return this._status === "open";
+  }
+  /** Rejestruje nasłuch zmian statusu; zwraca funkcję wyrejestrowującą. */
+  onStatusChange(cb) {
+    this.statusListeners.add(cb);
+    return () => this.statusListeners.delete(cb);
+  }
+  /** Łączy z agentem; resolve po otwarciu, reject przy timeoucie/zerwaniu.
+   *  Idempotentne, gdy połączenie jest już otwarte. */
+  connect() {
+    this.wantConnected = true;
+    if (this._status === "open") {
+      return Promise.resolve();
+    }
+    return new Promise((resolve, reject) => {
+      this.openSocket(resolve, reject);
+    });
+  }
+  /** Zamyka połączenie i wyłącza auto-reconnect. */
+  disconnect() {
+    this.wantConnected = false;
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = void 0;
+    }
+    if (this.ws) {
+      this.ws.close();
+    }
+  }
+  /** Lista drukarek zainstalowanych w systemie klienta. */
+  async getPrinters() {
+    const r = await this.request({ type: "listPrinters" });
+    return r.printers ?? [];
+  }
+  /** Wersja i brand agenta. */
+  async getVersion() {
+    const r = await this.request({ type: "version" });
+    return { brand: r.brand ?? "", version: r.version ?? "" };
+  }
+  /** Wysyła zadanie druku PDF; resolve po potwierdzeniu agenta. */
+  async print(opts) {
+    if (!opts || !opts.printer) {
+      throw new Error("print: wymagana nazwa drukarki (printer)");
+    }
+    const hasUrl = typeof opts.url === "string" && opts.url.length > 0;
+    const hasB64 = typeof opts.base64 === "string" && opts.base64.length > 0;
+    if (hasUrl === hasB64) {
+      throw new Error("print: podaj dok\u0142adnie jedno \u017Ar\xF3d\u0142o \u2014 url albo base64");
+    }
+    const pdf = hasUrl ? { url: opts.url } : { base64: opts.base64 };
+    await this.request({
+      type: "printPDF",
+      printer: opts.printer,
+      pdf,
+      copies: opts.copies
+    });
+  }
+  // --- wewnętrzne ---
+  openSocket(onOpen, onFail) {
+    this.setStatus("connecting");
+    let settled = false;
+    const ws = new this.WS(this.url);
+    this.ws = ws;
+    const connectTimer = setTimeout(() => {
+      if (!settled) {
+        settled = true;
+        try {
+          ws.close();
+        } catch {
+        }
+        onFail?.(new TimeoutError("przekroczono czas \u0142\u0105czenia z agentem"));
+      }
+    }, this.requestTimeoutMs);
+    ws.onopen = () => {
+      settled = true;
+      clearTimeout(connectTimer);
+      this.reconnectAttempt = 0;
+      this.setStatus("open");
+      onOpen?.();
+    };
+    ws.onmessage = (ev) => this.handleMessage(ev.data);
+    ws.onerror = () => {
+    };
+    ws.onclose = () => {
+      clearTimeout(connectTimer);
+      this.ws = void 0;
+      this.setStatus("closed");
+      this.rejectAllPending(new NotConnectedError("po\u0142\u0105czenie zamkni\u0119te"));
+      if (!settled) {
+        settled = true;
+        onFail?.(new NotConnectedError("nie uda\u0142o si\u0119 po\u0142\u0105czy\u0107 z agentem"));
+      }
+      if (this.wantConnected && this.autoReconnect) {
+        this.scheduleReconnect();
+      }
+    };
+  }
+  scheduleReconnect() {
+    const delay = RECONNECT_BACKOFF_MS[Math.min(this.reconnectAttempt, RECONNECT_BACKOFF_MS.length - 1)];
+    this.reconnectAttempt++;
+    this.reconnectTimer = setTimeout(() => {
+      if (this.wantConnected) {
+        this.openSocket();
+      }
+    }, delay);
+  }
+  handleMessage(data) {
+    const text = typeof data === "string" ? data : String(data);
+    let msg;
+    try {
+      msg = JSON.parse(text);
+    } catch {
+      return;
+    }
+    const id = msg.id;
+    if (!id) return;
+    const p = this.pending.get(id);
+    if (!p) return;
+    clearTimeout(p.timer);
+    this.pending.delete(id);
+    if (msg.ok) {
+      p.resolve(msg);
+    } else {
+      p.reject(new AgentError(msg.error || "b\u0142\u0105d agenta"));
+    }
+  }
+  request(payload) {
+    if (!this.isConnected() || !this.ws) {
+      return Promise.reject(new NotConnectedError());
+    }
+    const id = String(++this.idCounter);
+    const ws = this.ws;
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this.pending.delete(id);
+        reject(new TimeoutError());
+      }, this.requestTimeoutMs);
+      this.pending.set(id, { resolve, reject, timer });
+      try {
+        ws.send(JSON.stringify({ ...payload, id }));
+      } catch (e) {
+        clearTimeout(timer);
+        this.pending.delete(id);
+        reject(e instanceof Error ? e : new Error(String(e)));
+      }
+    });
+  }
+  rejectAllPending(err) {
+    for (const [, p] of this.pending) {
+      clearTimeout(p.timer);
+      p.reject(err);
+    }
+    this.pending.clear();
+  }
+  setStatus(s) {
+    if (this._status === s) return;
+    this._status = s;
+    for (const cb of this.statusListeners) {
+      cb(s);
+    }
+  }
+};
+export {
+  AgentError,
+  NotConnectedError,
+  PrintAgent,
+  TimeoutError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/client.ts"],"sourcesContent":["/** Status połączenia z lokalnym agentem. */\nexport type ConnectionStatus = \"connecting\" | \"open\" | \"closed\";\n\n/** Drukarka zwrócona przez agenta. */\nexport interface Printer {\n  name: string;\n  default: boolean;\n}\n\n/** Wersja agenta. */\nexport interface AgentVersion {\n  brand: string;\n  version: string;\n}\n\n/** Parametry zadania druku. Dokładnie jedno ze źródeł: url albo base64. */\nexport interface PrintOptions {\n  printer: string;\n  url?: string;\n  base64?: string;\n  copies?: number;\n}\n\n/** Opcje konstruktora PrintAgent. */\nexport interface PrintAgentOptions {\n  host?: string;\n  port?: number;\n  url?: string;\n  autoReconnect?: boolean;\n  requestTimeoutMs?: number;\n  WebSocket?: WebSocketCtor;\n}\n\n/** Minimalny interfejs WebSocket używany przez SDK (zgodny z przeglądarką i pakietem ws). */\nexport interface WebSocketLike {\n  send(data: string): void;\n  close(): void;\n  onopen: ((ev: unknown) => void) | null;\n  onmessage: ((ev: { data: unknown }) => void) | null;\n  onclose: ((ev: unknown) => void) | null;\n  onerror: ((ev: unknown) => void) | null;\n}\n\nexport interface WebSocketCtor {\n  new (url: string): WebSocketLike;\n}\n\n/** Brak aktywnego połączenia z agentem. */\nexport class NotConnectedError extends Error {\n  constructor(message = \"brak połączenia z agentem\") {\n    super(message);\n    this.name = \"NotConnectedError\";\n  }\n}\n\n/** Przekroczono czas oczekiwania na odpowiedź agenta. */\nexport class TimeoutError extends Error {\n  constructor(message = \"przekroczono czas oczekiwania na odpowiedź agenta\") {\n    super(message);\n    this.name = \"TimeoutError\";\n  }\n}\n\n/** Agent odpowiedział błędem (ok:false). */\nexport class AgentError extends Error {\n  constructor(message = \"błąd agenta\") {\n    super(message);\n    this.name = \"AgentError\";\n  }\n}\n","import {\n  AgentError,\n  NotConnectedError,\n  TimeoutError,\n  type AgentVersion,\n  type ConnectionStatus,\n  type PrintAgentOptions,\n  type PrintOptions,\n  type Printer,\n  type WebSocketCtor,\n  type WebSocketLike,\n} from \"./types\";\n\ninterface AgentResponse {\n  type: string;\n  id?: string;\n  ok: boolean;\n  error?: string;\n  printers?: Printer[];\n  brand?: string;\n  version?: string;\n}\n\ninterface Pending {\n  resolve: (r: AgentResponse) => void;\n  reject: (e: Error) => void;\n  timer: ReturnType<typeof setTimeout>;\n}\n\nconst RECONNECT_BACKOFF_MS = [1000, 2000, 5000, 10000];\n\n/** Klient lokalnego agenta druku. */\nexport class PrintAgent {\n  private readonly url: string;\n  private readonly autoReconnect: boolean;\n  private readonly requestTimeoutMs: number;\n  private readonly WS: WebSocketCtor;\n\n  private ws?: WebSocketLike;\n  private _status: ConnectionStatus = \"closed\";\n  private statusListeners = new Set<(s: ConnectionStatus) => void>();\n  private pending = new Map<string, Pending>();\n  private idCounter = 0;\n  private wantConnected = false;\n  private reconnectAttempt = 0;\n  private reconnectTimer?: ReturnType<typeof setTimeout>;\n\n  constructor(opts: PrintAgentOptions = {}) {\n    const host = opts.host ?? \"localhost\";\n    const port = opts.port ?? 45123;\n    this.url = opts.url ?? `wss://${host}:${port}/ws`;\n    this.autoReconnect = opts.autoReconnect ?? true;\n    this.requestTimeoutMs = opts.requestTimeoutMs ?? 10000;\n    const ctor = opts.WebSocket ?? (globalThis as { WebSocket?: WebSocketCtor }).WebSocket;\n    if (!ctor) {\n      throw new Error(\"brak implementacji WebSocket (przekaż opcję WebSocket)\");\n    }\n    this.WS = ctor;\n  }\n\n  get status(): ConnectionStatus {\n    return this._status;\n  }\n\n  isConnected(): boolean {\n    return this._status === \"open\";\n  }\n\n  /** Rejestruje nasłuch zmian statusu; zwraca funkcję wyrejestrowującą. */\n  onStatusChange(cb: (s: ConnectionStatus) => void): () => void {\n    this.statusListeners.add(cb);\n    return () => this.statusListeners.delete(cb);\n  }\n\n  /** Łączy z agentem; resolve po otwarciu, reject przy timeoucie/zerwaniu.\n   *  Idempotentne, gdy połączenie jest już otwarte. */\n  connect(): Promise<void> {\n    this.wantConnected = true;\n    if (this._status === \"open\") {\n      return Promise.resolve();\n    }\n    return new Promise<void>((resolve, reject) => {\n      this.openSocket(resolve, reject);\n    });\n  }\n\n  /** Zamyka połączenie i wyłącza auto-reconnect. */\n  disconnect(): void {\n    this.wantConnected = false;\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = undefined;\n    }\n    if (this.ws) {\n      this.ws.close();\n    }\n  }\n\n  /** Lista drukarek zainstalowanych w systemie klienta. */\n  async getPrinters(): Promise<Printer[]> {\n    const r = await this.request({ type: \"listPrinters\" });\n    return r.printers ?? [];\n  }\n\n  /** Wersja i brand agenta. */\n  async getVersion(): Promise<AgentVersion> {\n    const r = await this.request({ type: \"version\" });\n    return { brand: r.brand ?? \"\", version: r.version ?? \"\" };\n  }\n\n  /** Wysyła zadanie druku PDF; resolve po potwierdzeniu agenta. */\n  async print(opts: PrintOptions): Promise<void> {\n    if (!opts || !opts.printer) {\n      throw new Error(\"print: wymagana nazwa drukarki (printer)\");\n    }\n    const hasUrl = typeof opts.url === \"string\" && opts.url.length > 0;\n    const hasB64 = typeof opts.base64 === \"string\" && opts.base64.length > 0;\n    if (hasUrl === hasB64) {\n      throw new Error(\"print: podaj dokładnie jedno źródło — url albo base64\");\n    }\n    const pdf = hasUrl ? { url: opts.url } : { base64: opts.base64 };\n    await this.request({\n      type: \"printPDF\",\n      printer: opts.printer,\n      pdf,\n      copies: opts.copies,\n    });\n  }\n\n  // --- wewnętrzne ---\n\n  private openSocket(\n    onOpen?: () => void,\n    onFail?: (e: Error) => void\n  ): void {\n    this.setStatus(\"connecting\");\n    let settled = false;\n    const ws = new this.WS(this.url);\n    this.ws = ws;\n\n    const connectTimer = setTimeout(() => {\n      if (!settled) {\n        settled = true;\n        try {\n          ws.close();\n        } catch {\n          /* ignore */\n        }\n        onFail?.(new TimeoutError(\"przekroczono czas łączenia z agentem\"));\n      }\n    }, this.requestTimeoutMs);\n\n    ws.onopen = () => {\n      settled = true;\n      clearTimeout(connectTimer);\n      this.reconnectAttempt = 0;\n      this.setStatus(\"open\");\n      onOpen?.();\n    };\n    ws.onmessage = (ev) => this.handleMessage(ev.data);\n    ws.onerror = () => {\n      /* po błędzie nastąpi onclose */\n    };\n    ws.onclose = () => {\n      clearTimeout(connectTimer);\n      this.ws = undefined;\n      this.setStatus(\"closed\");\n      this.rejectAllPending(new NotConnectedError(\"połączenie zamknięte\"));\n      if (!settled) {\n        settled = true;\n        onFail?.(new NotConnectedError(\"nie udało się połączyć z agentem\"));\n      }\n      if (this.wantConnected && this.autoReconnect) {\n        this.scheduleReconnect();\n      }\n    };\n  }\n\n  private scheduleReconnect(): void {\n    const delay =\n      RECONNECT_BACKOFF_MS[Math.min(this.reconnectAttempt, RECONNECT_BACKOFF_MS.length - 1)];\n    this.reconnectAttempt++;\n    this.reconnectTimer = setTimeout(() => {\n      if (this.wantConnected) {\n        this.openSocket();\n      }\n    }, delay);\n  }\n\n  private handleMessage(data: unknown): void {\n    const text = typeof data === \"string\" ? data : String(data);\n    let msg: AgentResponse;\n    try {\n      msg = JSON.parse(text);\n    } catch {\n      return;\n    }\n    const id = msg.id;\n    if (!id) return;\n    const p = this.pending.get(id);\n    if (!p) return;\n    clearTimeout(p.timer);\n    this.pending.delete(id);\n    if (msg.ok) {\n      p.resolve(msg);\n    } else {\n      p.reject(new AgentError(msg.error || \"błąd agenta\"));\n    }\n  }\n\n  private request(payload: Record<string, unknown>): Promise<AgentResponse> {\n    if (!this.isConnected() || !this.ws) {\n      return Promise.reject(new NotConnectedError());\n    }\n    const id = String(++this.idCounter);\n    const ws = this.ws;\n    return new Promise<AgentResponse>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        this.pending.delete(id);\n        reject(new TimeoutError());\n      }, this.requestTimeoutMs);\n      this.pending.set(id, { resolve, reject, timer });\n      try {\n        ws.send(JSON.stringify({ ...payload, id }));\n      } catch (e) {\n        clearTimeout(timer);\n        this.pending.delete(id);\n        reject(e instanceof Error ? e : new Error(String(e)));\n      }\n    });\n  }\n\n  private rejectAllPending(err: Error): void {\n    for (const [, p] of this.pending) {\n      clearTimeout(p.timer);\n      p.reject(err);\n    }\n    this.pending.clear();\n  }\n\n  private setStatus(s: ConnectionStatus): void {\n    if (this._status === s) return;\n    this._status = s;\n    for (const cb of this.statusListeners) {\n      cb(s);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@happenv/print-agent-sdk",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Prosty SDK do lokalnego agenta druku (WebSocket): drukarki, druk PDF, status.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": ["dist"],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["printing", "websocket", "pdf", "print-agent"],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/ws": "^8.5.10",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0",
+    "ws": "^8.16.0"
+  }
+}