@happenv/print-agent-sdk 0.1.0 → 0.1.1

package/README.md

@@ -14,7 +14,7 @@ npm install @happenv/print-agent-sdk
 ```ts
 import { PrintAgent } from "@happenv/print-agent-sdk";
 
-const agent = new PrintAgent({ port: 45123 }); // wss://localhost:45123/ws
+const agent = new PrintAgent({ port: 45123, lang: "en" }); // wss://localhost:45123/ws
 
 agent.onStatusChange((s) => console.log("status:", s));
 
@@ -34,7 +34,8 @@ agent.disconnect();
 
 ## API
 
-- `new PrintAgent(options)` — `{ host?, port?, url?, autoReconnect?, requestTimeoutMs?, WebSocket? }`
+- `new PrintAgent(options)` — `{ host?, port?, url?, autoReconnect?, requestTimeoutMs?, WebSocket?, lang? }`
+  - `lang` — language of SDK error messages: `"en"` (default) or `"pl"`.
 - `connect()` / `disconnect()`
 - `status` / `isConnected()` / `onStatusChange(cb)` — status: `connecting | open | closed`
 - `getPrinters()` → `{ name, default }[]`
@@ -44,6 +45,20 @@ agent.disconnect();
 
 Errors: `NotConnectedError`, `TimeoutError`, `AgentError`.
 
+### Localization
+
+SDK-generated error messages are localized. Pass `lang` to pick the catalog
+(default `"en"`):
+
+```ts
+const agent = new PrintAgent({ port: 45123, lang: "pl" });
+```
+
+Catalogs live in `src/locales/` (`en.ts`, `pl.ts`) and are exported for
+inspection or reuse: `import { locales, getMessages, type Lang, type Messages } from "@happenv/print-agent-sdk"`.
+Note: error text returned by the agent itself (`AgentError`) is passed through
+as-is and is not translated by the SDK.
+
 ## Notes
 
 - The SDK connects over `wss` using a certificate signed by the product's local

package/dist/index.cjs

@@ -23,30 +23,64 @@ __export(index_exports, {
   AgentError: () => AgentError,
   NotConnectedError: () => NotConnectedError,
   PrintAgent: () => PrintAgent,
-  TimeoutError: () => TimeoutError
+  TimeoutError: () => TimeoutError,
+  getMessages: () => getMessages,
+  locales: () => locales
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/types.ts
 var NotConnectedError = class extends Error {
-  constructor(message = "brak po\u0142\u0105czenia z agentem") {
+  constructor(message = "no connection to the agent") {
     super(message);
     this.name = "NotConnectedError";
   }
 };
 var TimeoutError = class extends Error {
-  constructor(message = "przekroczono czas oczekiwania na odpowied\u017A agenta") {
+  constructor(message = "timed out waiting for the agent") {
     super(message);
     this.name = "TimeoutError";
   }
 };
 var AgentError = class extends Error {
-  constructor(message = "b\u0142\u0105d agenta") {
+  constructor(message = "agent error") {
     super(message);
     this.name = "AgentError";
   }
 };
 
+// src/locales/en.ts
+var en = {
+  notConnected: "no connection to the agent",
+  connectionClosed: "connection closed",
+  connectFailed: "could not connect to the agent",
+  timeout: "timed out waiting for the agent's response",
+  connectTimeout: "timed out connecting to the agent",
+  agentError: "agent error",
+  noWebSocket: "no WebSocket implementation (pass the WebSocket option)",
+  printNoPrinter: "print: printer name is required (printer)",
+  printSource: "print: provide exactly one source \u2014 url or base64"
+};
+
+// src/locales/pl.ts
+var pl = {
+  notConnected: "brak po\u0142\u0105czenia z agentem",
+  connectionClosed: "po\u0142\u0105czenie zamkni\u0119te",
+  connectFailed: "nie uda\u0142o si\u0119 po\u0142\u0105czy\u0107 z agentem",
+  timeout: "przekroczono czas oczekiwania na odpowied\u017A agenta",
+  connectTimeout: "przekroczono czas \u0142\u0105czenia z agentem",
+  agentError: "b\u0142\u0105d agenta",
+  noWebSocket: "brak implementacji WebSocket (przeka\u017C opcj\u0119 WebSocket)",
+  printNoPrinter: "print: wymagana nazwa drukarki (printer)",
+  printSource: "print: podaj dok\u0142adnie jedno \u017Ar\xF3d\u0142o \u2014 url albo base64"
+};
+
+// src/locales/index.ts
+var locales = { en, pl };
+function getMessages(lang = "en") {
+  return locales[lang] ?? en;
+}
+
 // src/client.ts
 var RECONNECT_BACKOFF_MS = [1e3, 2e3, 5e3, 1e4];
 var PrintAgent = class {
@@ -57,6 +91,7 @@ var PrintAgent = class {
     this.idCounter = 0;
     this.wantConnected = false;
     this.reconnectAttempt = 0;
+    this.t = getMessages(opts.lang);
     const host = opts.host ?? "localhost";
     const port = opts.port ?? 45123;
     this.url = opts.url ?? `wss://${host}:${port}/ws`;
@@ -64,7 +99,7 @@ var PrintAgent = class {
     this.requestTimeoutMs = opts.requestTimeoutMs ?? 1e4;
     const ctor = opts.WebSocket ?? globalThis.WebSocket;
     if (!ctor) {
-      throw new Error("brak implementacji WebSocket (przeka\u017C opcj\u0119 WebSocket)");
+      throw new Error(this.t.noWebSocket);
     }
     this.WS = ctor;
   }
@@ -74,13 +109,13 @@ var PrintAgent = class {
   isConnected() {
     return this._status === "open";
   }
-  /** Rejestruje nasłuch zmian statusu; zwraca funkcję wyrejestrowującą. */
+  /** Registers a status-change listener; returns an unsubscribe function. */
   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. */
+  /** Connects to the agent; resolves on open, rejects on timeout/failure.
+   *  Idempotent when the connection is already open. */
   connect() {
     this.wantConnected = true;
     if (this._status === "open") {
@@ -90,7 +125,7 @@ var PrintAgent = class {
       this.openSocket(resolve, reject);
     });
   }
-  /** Zamyka połączenie i wyłącza auto-reconnect. */
+  /** Closes the connection and disables auto-reconnect. */
   disconnect() {
     this.wantConnected = false;
     if (this.reconnectTimer) {
@@ -101,25 +136,25 @@ var PrintAgent = class {
       this.ws.close();
     }
   }
-  /** Lista drukarek zainstalowanych w systemie klienta. */
+  /** List of printers installed on the client's system. */
   async getPrinters() {
     const r = await this.request({ type: "listPrinters" });
     return r.printers ?? [];
   }
-  /** Wersja i brand agenta. */
+  /** Agent brand and version. */
   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. */
+  /** Sends a PDF print job; resolves once the agent confirms. */
   async print(opts) {
     if (!opts || !opts.printer) {
-      throw new Error("print: wymagana nazwa drukarki (printer)");
+      throw new Error(this.t.printNoPrinter);
     }
     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");
+      throw new Error(this.t.printSource);
     }
     const pdf = hasUrl ? { url: opts.url } : { base64: opts.base64 };
     await this.request({
@@ -129,7 +164,7 @@ var PrintAgent = class {
       copies: opts.copies
     });
   }
-  // --- wewnętrzne ---
+  // --- internal ---
   openSocket(onOpen, onFail) {
     this.setStatus("connecting");
     let settled = false;
@@ -142,7 +177,7 @@ var PrintAgent = class {
           ws.close();
         } catch {
         }
-        onFail?.(new TimeoutError("przekroczono czas \u0142\u0105czenia z agentem"));
+        onFail?.(new TimeoutError(this.t.connectTimeout));
       }
     }, this.requestTimeoutMs);
     ws.onopen = () => {
@@ -159,10 +194,10 @@ var PrintAgent = class {
       clearTimeout(connectTimer);
       this.ws = void 0;
       this.setStatus("closed");
-      this.rejectAllPending(new NotConnectedError("po\u0142\u0105czenie zamkni\u0119te"));
+      this.rejectAllPending(new NotConnectedError(this.t.connectionClosed));
       if (!settled) {
         settled = true;
-        onFail?.(new NotConnectedError("nie uda\u0142o si\u0119 po\u0142\u0105czy\u0107 z agentem"));
+        onFail?.(new NotConnectedError(this.t.connectFailed));
       }
       if (this.wantConnected && this.autoReconnect) {
         this.scheduleReconnect();
@@ -195,19 +230,19 @@ var PrintAgent = class {
     if (msg.ok) {
       p.resolve(msg);
     } else {
-      p.reject(new AgentError(msg.error || "b\u0142\u0105d agenta"));
+      p.reject(new AgentError(msg.error || this.t.agentError));
     }
   }
   request(payload) {
     if (!this.isConnected() || !this.ws) {
-      return Promise.reject(new NotConnectedError());
+      return Promise.reject(new NotConnectedError(this.t.notConnected));
     }
     const id = String(++this.idCounter);
     const ws = this.ws;
     return new Promise((resolve, reject) => {
       const timer = setTimeout(() => {
         this.pending.delete(id);
-        reject(new TimeoutError());
+        reject(new TimeoutError(this.t.timeout));
       }, this.requestTimeoutMs);
       this.pending.set(id, { resolve, reject, timer });
       try {
@@ -239,6 +274,8 @@ var PrintAgent = class {
   AgentError,
   NotConnectedError,
   PrintAgent,
-  TimeoutError
+  TimeoutError,
+  getMessages,
+  locales
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +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":[]}
+{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/locales/en.ts","../src/locales/pl.ts","../src/locales/index.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\";\nexport { locales, getMessages, type Lang, type Messages } from \"./locales\";\n","import type { Lang } from \"./locales\";\n\n/** Connection status with the local agent. */\nexport type ConnectionStatus = \"connecting\" | \"open\" | \"closed\";\n\n/** A printer returned by the agent. */\nexport interface Printer {\n  name: string;\n  default: boolean;\n}\n\n/** Agent version. */\nexport interface AgentVersion {\n  brand: string;\n  version: string;\n}\n\n/** Print job parameters. Provide exactly one source: url or base64. */\nexport interface PrintOptions {\n  printer: string;\n  url?: string;\n  base64?: string;\n  copies?: number;\n}\n\n/** PrintAgent constructor options. */\nexport interface PrintAgentOptions {\n  host?: string;\n  port?: number;\n  url?: string;\n  autoReconnect?: boolean;\n  requestTimeoutMs?: number;\n  WebSocket?: WebSocketCtor;\n  /** Language of SDK error messages; defaults to \"en\". */\n  lang?: Lang;\n}\n\n/** Minimal WebSocket interface used by the SDK (compatible with the browser and the ws package). */\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/** No active connection to the agent. (Message is localized by the client.) */\nexport class NotConnectedError extends Error {\n  constructor(message = \"no connection to the agent\") {\n    super(message);\n    this.name = \"NotConnectedError\";\n  }\n}\n\n/** Timed out waiting for the agent. (Message is localized by the client.) */\nexport class TimeoutError extends Error {\n  constructor(message = \"timed out waiting for the agent\") {\n    super(message);\n    this.name = \"TimeoutError\";\n  }\n}\n\n/** The agent responded with an error (ok:false). */\nexport class AgentError extends Error {\n  constructor(message = \"agent error\") {\n    super(message);\n    this.name = \"AgentError\";\n  }\n}\n","import type { Messages } from \"./types\";\n\n/** English message catalog (default). */\nexport const en: Messages = {\n  notConnected: \"no connection to the agent\",\n  connectionClosed: \"connection closed\",\n  connectFailed: \"could not connect to the agent\",\n  timeout: \"timed out waiting for the agent's response\",\n  connectTimeout: \"timed out connecting to the agent\",\n  agentError: \"agent error\",\n  noWebSocket: \"no WebSocket implementation (pass the WebSocket option)\",\n  printNoPrinter: \"print: printer name is required (printer)\",\n  printSource: \"print: provide exactly one source — url or base64\",\n};\n","import type { Messages } from \"./types\";\n\n/** Polish message catalog. */\nexport const pl: Messages = {\n  notConnected: \"brak połączenia z agentem\",\n  connectionClosed: \"połączenie zamknięte\",\n  connectFailed: \"nie udało się połączyć z agentem\",\n  timeout: \"przekroczono czas oczekiwania na odpowiedź agenta\",\n  connectTimeout: \"przekroczono czas łączenia z agentem\",\n  agentError: \"błąd agenta\",\n  noWebSocket: \"brak implementacji WebSocket (przekaż opcję WebSocket)\",\n  printNoPrinter: \"print: wymagana nazwa drukarki (printer)\",\n  printSource: \"print: podaj dokładnie jedno źródło — url albo base64\",\n};\n","import { en } from \"./en\";\nimport { pl } from \"./pl\";\nimport type { Lang, Messages } from \"./types\";\n\nexport type { Lang, Messages };\n\n/** All available message catalogs keyed by language. */\nexport const locales: Record<Lang, Messages> = { en, pl };\n\n/** Returns the message catalog for the given language (defaults to English). */\nexport function getMessages(lang: Lang = \"en\"): Messages {\n  return locales[lang] ?? en;\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\";\nimport { getMessages, type Messages } from \"./locales\";\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/** Client for the local print agent. */\nexport class PrintAgent {\n  private readonly url: string;\n  private readonly autoReconnect: boolean;\n  private readonly requestTimeoutMs: number;\n  private readonly WS: WebSocketCtor;\n  private readonly t: Messages;\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    this.t = getMessages(opts.lang);\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(this.t.noWebSocket);\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  /** Registers a status-change listener; returns an unsubscribe function. */\n  onStatusChange(cb: (s: ConnectionStatus) => void): () => void {\n    this.statusListeners.add(cb);\n    return () => this.statusListeners.delete(cb);\n  }\n\n  /** Connects to the agent; resolves on open, rejects on timeout/failure.\n   *  Idempotent when the connection is already open. */\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  /** Closes the connection and disables 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  /** List of printers installed on the client's system. */\n  async getPrinters(): Promise<Printer[]> {\n    const r = await this.request({ type: \"listPrinters\" });\n    return r.printers ?? [];\n  }\n\n  /** Agent brand and version. */\n  async getVersion(): Promise<AgentVersion> {\n    const r = await this.request({ type: \"version\" });\n    return { brand: r.brand ?? \"\", version: r.version ?? \"\" };\n  }\n\n  /** Sends a PDF print job; resolves once the agent confirms. */\n  async print(opts: PrintOptions): Promise<void> {\n    if (!opts || !opts.printer) {\n      throw new Error(this.t.printNoPrinter);\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(this.t.printSource);\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  // --- internal ---\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(this.t.connectTimeout));\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      /* onclose will follow the error */\n    };\n    ws.onclose = () => {\n      clearTimeout(connectTimer);\n      this.ws = undefined;\n      this.setStatus(\"closed\");\n      this.rejectAllPending(new NotConnectedError(this.t.connectionClosed));\n      if (!settled) {\n        settled = true;\n        onFail?.(new NotConnectedError(this.t.connectFailed));\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 || this.t.agentError));\n    }\n  }\n\n  private request(payload: Record<string, unknown>): Promise<AgentResponse> {\n    if (!this.isConnected() || !this.ws) {\n      return Promise.reject(new NotConnectedError(this.t.notConnected));\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(this.t.timeout));\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

@@ -1,23 +1,52 @@
-/** Status połączenia z lokalnym agentem. */
+/** Supported SDK languages for user-facing messages. */
+type Lang = "en" | "pl";
+/** Message catalog used for SDK-generated error messages. */
+interface Messages {
+    /** No active connection to the agent. */
+    notConnected: string;
+    /** The connection was closed. */
+    connectionClosed: string;
+    /** Initial connection attempt failed. */
+    connectFailed: string;
+    /** Request timed out waiting for a response. */
+    timeout: string;
+    /** Connection attempt timed out. */
+    connectTimeout: string;
+    /** Fallback when the agent returns an error without text. */
+    agentError: string;
+    /** No WebSocket implementation available. */
+    noWebSocket: string;
+    /** print(): printer name missing. */
+    printNoPrinter: string;
+    /** print(): wrong number of PDF sources. */
+    printSource: string;
+}
+
+/** All available message catalogs keyed by language. */
+declare const locales: Record<Lang, Messages>;
+/** Returns the message catalog for the given language (defaults to English). */
+declare function getMessages(lang?: Lang): Messages;
+
+/** Connection status with the local agent. */
 type ConnectionStatus = "connecting" | "open" | "closed";
-/** Drukarka zwrócona przez agenta. */
+/** A printer returned by the agent. */
 interface Printer {
     name: string;
     default: boolean;
 }
-/** Wersja agenta. */
+/** Agent version. */
 interface AgentVersion {
     brand: string;
     version: string;
 }
-/** Parametry zadania druku. Dokładnie jedno ze źródeł: url albo base64. */
+/** Print job parameters. Provide exactly one source: url or base64. */
 interface PrintOptions {
     printer: string;
     url?: string;
     base64?: string;
     copies?: number;
 }
-/** Opcje konstruktora PrintAgent. */
+/** PrintAgent constructor options. */
 interface PrintAgentOptions {
     host?: string;
     port?: number;
@@ -25,8 +54,10 @@ interface PrintAgentOptions {
     autoReconnect?: boolean;
     requestTimeoutMs?: number;
     WebSocket?: WebSocketCtor;
+    /** Language of SDK error messages; defaults to "en". */
+    lang?: Lang;
 }
-/** Minimalny interfejs WebSocket używany przez SDK (zgodny z przeglądarką i pakietem ws). */
+/** Minimal WebSocket interface used by the SDK (compatible with the browser and the ws package). */
 interface WebSocketLike {
     send(data: string): void;
     close(): void;
@@ -40,25 +71,26 @@ interface WebSocketLike {
 interface WebSocketCtor {
     new (url: string): WebSocketLike;
 }
-/** Brak aktywnego połączenia z agentem. */
+/** No active connection to the agent. (Message is localized by the client.) */
 declare class NotConnectedError extends Error {
     constructor(message?: string);
 }
-/** Przekroczono czas oczekiwania na odpowiedź agenta. */
+/** Timed out waiting for the agent. (Message is localized by the client.) */
 declare class TimeoutError extends Error {
     constructor(message?: string);
 }
-/** Agent odpowiedział błędem (ok:false). */
+/** The agent responded with an error (ok:false). */
 declare class AgentError extends Error {
     constructor(message?: string);
 }
 
-/** Klient lokalnego agenta druku. */
+/** Client for the local print agent. */
 declare class PrintAgent {
     private readonly url;
     private readonly autoReconnect;
     private readonly requestTimeoutMs;
     private readonly WS;
+    private readonly t;
     private ws?;
     private _status;
     private statusListeners;
@@ -70,18 +102,18 @@ declare class PrintAgent {
     constructor(opts?: PrintAgentOptions);
     get status(): ConnectionStatus;
     isConnected(): boolean;
-    /** Rejestruje nasłuch zmian statusu; zwraca funkcję wyrejestrowującą. */
+    /** Registers a status-change listener; returns an unsubscribe function. */
     onStatusChange(cb: (s: ConnectionStatus) => void): () => void;
-    /** Łączy z agentem; resolve po otwarciu, reject przy timeoucie/zerwaniu.
-     *  Idempotentne, gdy połączenie jest już otwarte. */
+    /** Connects to the agent; resolves on open, rejects on timeout/failure.
+     *  Idempotent when the connection is already open. */
     connect(): Promise<void>;
-    /** Zamyka połączenie i wyłącza auto-reconnect. */
+    /** Closes the connection and disables auto-reconnect. */
     disconnect(): void;
-    /** Lista drukarek zainstalowanych w systemie klienta. */
+    /** List of printers installed on the client's system. */
     getPrinters(): Promise<Printer[]>;
-    /** Wersja i brand agenta. */
+    /** Agent brand and version. */
     getVersion(): Promise<AgentVersion>;
-    /** Wysyła zadanie druku PDF; resolve po potwierdzeniu agenta. */
+    /** Sends a PDF print job; resolves once the agent confirms. */
     print(opts: PrintOptions): Promise<void>;
     private openSocket;
     private scheduleReconnect;
@@ -91,4 +123,4 @@ declare class PrintAgent {
     private setStatus;
 }
 
-export { AgentError, type AgentVersion, type ConnectionStatus, NotConnectedError, PrintAgent, type PrintAgentOptions, type PrintOptions, type Printer, TimeoutError, type WebSocketCtor, type WebSocketLike };
+export { AgentError, type AgentVersion, type ConnectionStatus, type Lang, type Messages, NotConnectedError, PrintAgent, type PrintAgentOptions, type PrintOptions, type Printer, TimeoutError, type WebSocketCtor, type WebSocketLike, getMessages, locales };

package/dist/index.d.ts

@@ -1,23 +1,52 @@
-/** Status połączenia z lokalnym agentem. */
+/** Supported SDK languages for user-facing messages. */
+type Lang = "en" | "pl";
+/** Message catalog used for SDK-generated error messages. */
+interface Messages {
+    /** No active connection to the agent. */
+    notConnected: string;
+    /** The connection was closed. */
+    connectionClosed: string;
+    /** Initial connection attempt failed. */
+    connectFailed: string;
+    /** Request timed out waiting for a response. */
+    timeout: string;
+    /** Connection attempt timed out. */
+    connectTimeout: string;
+    /** Fallback when the agent returns an error without text. */
+    agentError: string;
+    /** No WebSocket implementation available. */
+    noWebSocket: string;
+    /** print(): printer name missing. */
+    printNoPrinter: string;
+    /** print(): wrong number of PDF sources. */
+    printSource: string;
+}
+
+/** All available message catalogs keyed by language. */
+declare const locales: Record<Lang, Messages>;
+/** Returns the message catalog for the given language (defaults to English). */
+declare function getMessages(lang?: Lang): Messages;
+
+/** Connection status with the local agent. */
 type ConnectionStatus = "connecting" | "open" | "closed";
-/** Drukarka zwrócona przez agenta. */
+/** A printer returned by the agent. */
 interface Printer {
     name: string;
     default: boolean;
 }
-/** Wersja agenta. */
+/** Agent version. */
 interface AgentVersion {
     brand: string;
     version: string;
 }
-/** Parametry zadania druku. Dokładnie jedno ze źródeł: url albo base64. */
+/** Print job parameters. Provide exactly one source: url or base64. */
 interface PrintOptions {
     printer: string;
     url?: string;
     base64?: string;
     copies?: number;
 }
-/** Opcje konstruktora PrintAgent. */
+/** PrintAgent constructor options. */
 interface PrintAgentOptions {
     host?: string;
     port?: number;
@@ -25,8 +54,10 @@ interface PrintAgentOptions {
     autoReconnect?: boolean;
     requestTimeoutMs?: number;
     WebSocket?: WebSocketCtor;
+    /** Language of SDK error messages; defaults to "en". */
+    lang?: Lang;
 }
-/** Minimalny interfejs WebSocket używany przez SDK (zgodny z przeglądarką i pakietem ws). */
+/** Minimal WebSocket interface used by the SDK (compatible with the browser and the ws package). */
 interface WebSocketLike {
     send(data: string): void;
     close(): void;
@@ -40,25 +71,26 @@ interface WebSocketLike {
 interface WebSocketCtor {
     new (url: string): WebSocketLike;
 }
-/** Brak aktywnego połączenia z agentem. */
+/** No active connection to the agent. (Message is localized by the client.) */
 declare class NotConnectedError extends Error {
     constructor(message?: string);
 }
-/** Przekroczono czas oczekiwania na odpowiedź agenta. */
+/** Timed out waiting for the agent. (Message is localized by the client.) */
 declare class TimeoutError extends Error {
     constructor(message?: string);
 }
-/** Agent odpowiedział błędem (ok:false). */
+/** The agent responded with an error (ok:false). */
 declare class AgentError extends Error {
     constructor(message?: string);
 }
 
-/** Klient lokalnego agenta druku. */
+/** Client for the local print agent. */
 declare class PrintAgent {
     private readonly url;
     private readonly autoReconnect;
     private readonly requestTimeoutMs;
     private readonly WS;
+    private readonly t;
     private ws?;
     private _status;
     private statusListeners;
@@ -70,18 +102,18 @@ declare class PrintAgent {
     constructor(opts?: PrintAgentOptions);
     get status(): ConnectionStatus;
     isConnected(): boolean;
-    /** Rejestruje nasłuch zmian statusu; zwraca funkcję wyrejestrowującą. */
+    /** Registers a status-change listener; returns an unsubscribe function. */
     onStatusChange(cb: (s: ConnectionStatus) => void): () => void;
-    /** Łączy z agentem; resolve po otwarciu, reject przy timeoucie/zerwaniu.
-     *  Idempotentne, gdy połączenie jest już otwarte. */
+    /** Connects to the agent; resolves on open, rejects on timeout/failure.
+     *  Idempotent when the connection is already open. */
     connect(): Promise<void>;
-    /** Zamyka połączenie i wyłącza auto-reconnect. */
+    /** Closes the connection and disables auto-reconnect. */
     disconnect(): void;
-    /** Lista drukarek zainstalowanych w systemie klienta. */
+    /** List of printers installed on the client's system. */
     getPrinters(): Promise<Printer[]>;
-    /** Wersja i brand agenta. */
+    /** Agent brand and version. */
     getVersion(): Promise<AgentVersion>;
-    /** Wysyła zadanie druku PDF; resolve po potwierdzeniu agenta. */
+    /** Sends a PDF print job; resolves once the agent confirms. */
     print(opts: PrintOptions): Promise<void>;
     private openSocket;
     private scheduleReconnect;
@@ -91,4 +123,4 @@ declare class PrintAgent {
     private setStatus;
 }
 
-export { AgentError, type AgentVersion, type ConnectionStatus, NotConnectedError, PrintAgent, type PrintAgentOptions, type PrintOptions, type Printer, TimeoutError, type WebSocketCtor, type WebSocketLike };
+export { AgentError, type AgentVersion, type ConnectionStatus, type Lang, type Messages, NotConnectedError, PrintAgent, type PrintAgentOptions, type PrintOptions, type Printer, TimeoutError, type WebSocketCtor, type WebSocketLike, getMessages, locales };

package/dist/index.js

@@ -1,23 +1,55 @@
 // src/types.ts
 var NotConnectedError = class extends Error {
-  constructor(message = "brak po\u0142\u0105czenia z agentem") {
+  constructor(message = "no connection to the agent") {
     super(message);
     this.name = "NotConnectedError";
   }
 };
 var TimeoutError = class extends Error {
-  constructor(message = "przekroczono czas oczekiwania na odpowied\u017A agenta") {
+  constructor(message = "timed out waiting for the agent") {
     super(message);
     this.name = "TimeoutError";
   }
 };
 var AgentError = class extends Error {
-  constructor(message = "b\u0142\u0105d agenta") {
+  constructor(message = "agent error") {
     super(message);
     this.name = "AgentError";
   }
 };
 
+// src/locales/en.ts
+var en = {
+  notConnected: "no connection to the agent",
+  connectionClosed: "connection closed",
+  connectFailed: "could not connect to the agent",
+  timeout: "timed out waiting for the agent's response",
+  connectTimeout: "timed out connecting to the agent",
+  agentError: "agent error",
+  noWebSocket: "no WebSocket implementation (pass the WebSocket option)",
+  printNoPrinter: "print: printer name is required (printer)",
+  printSource: "print: provide exactly one source \u2014 url or base64"
+};
+
+// src/locales/pl.ts
+var pl = {
+  notConnected: "brak po\u0142\u0105czenia z agentem",
+  connectionClosed: "po\u0142\u0105czenie zamkni\u0119te",
+  connectFailed: "nie uda\u0142o si\u0119 po\u0142\u0105czy\u0107 z agentem",
+  timeout: "przekroczono czas oczekiwania na odpowied\u017A agenta",
+  connectTimeout: "przekroczono czas \u0142\u0105czenia z agentem",
+  agentError: "b\u0142\u0105d agenta",
+  noWebSocket: "brak implementacji WebSocket (przeka\u017C opcj\u0119 WebSocket)",
+  printNoPrinter: "print: wymagana nazwa drukarki (printer)",
+  printSource: "print: podaj dok\u0142adnie jedno \u017Ar\xF3d\u0142o \u2014 url albo base64"
+};
+
+// src/locales/index.ts
+var locales = { en, pl };
+function getMessages(lang = "en") {
+  return locales[lang] ?? en;
+}
+
 // src/client.ts
 var RECONNECT_BACKOFF_MS = [1e3, 2e3, 5e3, 1e4];
 var PrintAgent = class {
@@ -28,6 +60,7 @@ var PrintAgent = class {
     this.idCounter = 0;
     this.wantConnected = false;
     this.reconnectAttempt = 0;
+    this.t = getMessages(opts.lang);
     const host = opts.host ?? "localhost";
     const port = opts.port ?? 45123;
     this.url = opts.url ?? `wss://${host}:${port}/ws`;
@@ -35,7 +68,7 @@ var PrintAgent = class {
     this.requestTimeoutMs = opts.requestTimeoutMs ?? 1e4;
     const ctor = opts.WebSocket ?? globalThis.WebSocket;
     if (!ctor) {
-      throw new Error("brak implementacji WebSocket (przeka\u017C opcj\u0119 WebSocket)");
+      throw new Error(this.t.noWebSocket);
     }
     this.WS = ctor;
   }
@@ -45,13 +78,13 @@ var PrintAgent = class {
   isConnected() {
     return this._status === "open";
   }
-  /** Rejestruje nasłuch zmian statusu; zwraca funkcję wyrejestrowującą. */
+  /** Registers a status-change listener; returns an unsubscribe function. */
   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. */
+  /** Connects to the agent; resolves on open, rejects on timeout/failure.
+   *  Idempotent when the connection is already open. */
   connect() {
     this.wantConnected = true;
     if (this._status === "open") {
@@ -61,7 +94,7 @@ var PrintAgent = class {
       this.openSocket(resolve, reject);
     });
   }
-  /** Zamyka połączenie i wyłącza auto-reconnect. */
+  /** Closes the connection and disables auto-reconnect. */
   disconnect() {
     this.wantConnected = false;
     if (this.reconnectTimer) {
@@ -72,25 +105,25 @@ var PrintAgent = class {
       this.ws.close();
     }
   }
-  /** Lista drukarek zainstalowanych w systemie klienta. */
+  /** List of printers installed on the client's system. */
   async getPrinters() {
     const r = await this.request({ type: "listPrinters" });
     return r.printers ?? [];
   }
-  /** Wersja i brand agenta. */
+  /** Agent brand and version. */
   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. */
+  /** Sends a PDF print job; resolves once the agent confirms. */
   async print(opts) {
     if (!opts || !opts.printer) {
-      throw new Error("print: wymagana nazwa drukarki (printer)");
+      throw new Error(this.t.printNoPrinter);
     }
     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");
+      throw new Error(this.t.printSource);
     }
     const pdf = hasUrl ? { url: opts.url } : { base64: opts.base64 };
     await this.request({
@@ -100,7 +133,7 @@ var PrintAgent = class {
       copies: opts.copies
     });
   }
-  // --- wewnętrzne ---
+  // --- internal ---
   openSocket(onOpen, onFail) {
     this.setStatus("connecting");
     let settled = false;
@@ -113,7 +146,7 @@ var PrintAgent = class {
           ws.close();
         } catch {
         }
-        onFail?.(new TimeoutError("przekroczono czas \u0142\u0105czenia z agentem"));
+        onFail?.(new TimeoutError(this.t.connectTimeout));
       }
     }, this.requestTimeoutMs);
     ws.onopen = () => {
@@ -130,10 +163,10 @@ var PrintAgent = class {
       clearTimeout(connectTimer);
       this.ws = void 0;
       this.setStatus("closed");
-      this.rejectAllPending(new NotConnectedError("po\u0142\u0105czenie zamkni\u0119te"));
+      this.rejectAllPending(new NotConnectedError(this.t.connectionClosed));
       if (!settled) {
         settled = true;
-        onFail?.(new NotConnectedError("nie uda\u0142o si\u0119 po\u0142\u0105czy\u0107 z agentem"));
+        onFail?.(new NotConnectedError(this.t.connectFailed));
       }
       if (this.wantConnected && this.autoReconnect) {
         this.scheduleReconnect();
@@ -166,19 +199,19 @@ var PrintAgent = class {
     if (msg.ok) {
       p.resolve(msg);
     } else {
-      p.reject(new AgentError(msg.error || "b\u0142\u0105d agenta"));
+      p.reject(new AgentError(msg.error || this.t.agentError));
     }
   }
   request(payload) {
     if (!this.isConnected() || !this.ws) {
-      return Promise.reject(new NotConnectedError());
+      return Promise.reject(new NotConnectedError(this.t.notConnected));
     }
     const id = String(++this.idCounter);
     const ws = this.ws;
     return new Promise((resolve, reject) => {
       const timer = setTimeout(() => {
         this.pending.delete(id);
-        reject(new TimeoutError());
+        reject(new TimeoutError(this.t.timeout));
       }, this.requestTimeoutMs);
       this.pending.set(id, { resolve, reject, timer });
       try {
@@ -209,6 +242,8 @@ export {
   AgentError,
   NotConnectedError,
   PrintAgent,
-  TimeoutError
+  TimeoutError,
+  getMessages,
+  locales
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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":[]}
+{"version":3,"sources":["../src/types.ts","../src/locales/en.ts","../src/locales/pl.ts","../src/locales/index.ts","../src/client.ts"],"sourcesContent":["import type { Lang } from \"./locales\";\n\n/** Connection status with the local agent. */\nexport type ConnectionStatus = \"connecting\" | \"open\" | \"closed\";\n\n/** A printer returned by the agent. */\nexport interface Printer {\n  name: string;\n  default: boolean;\n}\n\n/** Agent version. */\nexport interface AgentVersion {\n  brand: string;\n  version: string;\n}\n\n/** Print job parameters. Provide exactly one source: url or base64. */\nexport interface PrintOptions {\n  printer: string;\n  url?: string;\n  base64?: string;\n  copies?: number;\n}\n\n/** PrintAgent constructor options. */\nexport interface PrintAgentOptions {\n  host?: string;\n  port?: number;\n  url?: string;\n  autoReconnect?: boolean;\n  requestTimeoutMs?: number;\n  WebSocket?: WebSocketCtor;\n  /** Language of SDK error messages; defaults to \"en\". */\n  lang?: Lang;\n}\n\n/** Minimal WebSocket interface used by the SDK (compatible with the browser and the ws package). */\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/** No active connection to the agent. (Message is localized by the client.) */\nexport class NotConnectedError extends Error {\n  constructor(message = \"no connection to the agent\") {\n    super(message);\n    this.name = \"NotConnectedError\";\n  }\n}\n\n/** Timed out waiting for the agent. (Message is localized by the client.) */\nexport class TimeoutError extends Error {\n  constructor(message = \"timed out waiting for the agent\") {\n    super(message);\n    this.name = \"TimeoutError\";\n  }\n}\n\n/** The agent responded with an error (ok:false). */\nexport class AgentError extends Error {\n  constructor(message = \"agent error\") {\n    super(message);\n    this.name = \"AgentError\";\n  }\n}\n","import type { Messages } from \"./types\";\n\n/** English message catalog (default). */\nexport const en: Messages = {\n  notConnected: \"no connection to the agent\",\n  connectionClosed: \"connection closed\",\n  connectFailed: \"could not connect to the agent\",\n  timeout: \"timed out waiting for the agent's response\",\n  connectTimeout: \"timed out connecting to the agent\",\n  agentError: \"agent error\",\n  noWebSocket: \"no WebSocket implementation (pass the WebSocket option)\",\n  printNoPrinter: \"print: printer name is required (printer)\",\n  printSource: \"print: provide exactly one source — url or base64\",\n};\n","import type { Messages } from \"./types\";\n\n/** Polish message catalog. */\nexport const pl: Messages = {\n  notConnected: \"brak połączenia z agentem\",\n  connectionClosed: \"połączenie zamknięte\",\n  connectFailed: \"nie udało się połączyć z agentem\",\n  timeout: \"przekroczono czas oczekiwania na odpowiedź agenta\",\n  connectTimeout: \"przekroczono czas łączenia z agentem\",\n  agentError: \"błąd agenta\",\n  noWebSocket: \"brak implementacji WebSocket (przekaż opcję WebSocket)\",\n  printNoPrinter: \"print: wymagana nazwa drukarki (printer)\",\n  printSource: \"print: podaj dokładnie jedno źródło — url albo base64\",\n};\n","import { en } from \"./en\";\nimport { pl } from \"./pl\";\nimport type { Lang, Messages } from \"./types\";\n\nexport type { Lang, Messages };\n\n/** All available message catalogs keyed by language. */\nexport const locales: Record<Lang, Messages> = { en, pl };\n\n/** Returns the message catalog for the given language (defaults to English). */\nexport function getMessages(lang: Lang = \"en\"): Messages {\n  return locales[lang] ?? en;\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\";\nimport { getMessages, type Messages } from \"./locales\";\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/** Client for the local print agent. */\nexport class PrintAgent {\n  private readonly url: string;\n  private readonly autoReconnect: boolean;\n  private readonly requestTimeoutMs: number;\n  private readonly WS: WebSocketCtor;\n  private readonly t: Messages;\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    this.t = getMessages(opts.lang);\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(this.t.noWebSocket);\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  /** Registers a status-change listener; returns an unsubscribe function. */\n  onStatusChange(cb: (s: ConnectionStatus) => void): () => void {\n    this.statusListeners.add(cb);\n    return () => this.statusListeners.delete(cb);\n  }\n\n  /** Connects to the agent; resolves on open, rejects on timeout/failure.\n   *  Idempotent when the connection is already open. */\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  /** Closes the connection and disables 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  /** List of printers installed on the client's system. */\n  async getPrinters(): Promise<Printer[]> {\n    const r = await this.request({ type: \"listPrinters\" });\n    return r.printers ?? [];\n  }\n\n  /** Agent brand and version. */\n  async getVersion(): Promise<AgentVersion> {\n    const r = await this.request({ type: \"version\" });\n    return { brand: r.brand ?? \"\", version: r.version ?? \"\" };\n  }\n\n  /** Sends a PDF print job; resolves once the agent confirms. */\n  async print(opts: PrintOptions): Promise<void> {\n    if (!opts || !opts.printer) {\n      throw new Error(this.t.printNoPrinter);\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(this.t.printSource);\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  // --- internal ---\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(this.t.connectTimeout));\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      /* onclose will follow the error */\n    };\n    ws.onclose = () => {\n      clearTimeout(connectTimer);\n      this.ws = undefined;\n      this.setStatus(\"closed\");\n      this.rejectAllPending(new NotConnectedError(this.t.connectionClosed));\n      if (!settled) {\n        settled = true;\n        onFail?.(new NotConnectedError(this.t.connectFailed));\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 || this.t.agentError));\n    }\n  }\n\n  private request(payload: Record<string, unknown>): Promise<AgentResponse> {\n    if (!this.isConnected() || !this.ws) {\n      return Promise.reject(new NotConnectedError(this.t.notConnected));\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(this.t.timeout));\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

@@ -1,10 +1,10 @@
 {
   "name": "@happenv/print-agent-sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "publishConfig": {
     "access": "public"
   },
-  "description": "Prosty SDK do lokalnego agenta druku (WebSocket): drukarki, druk PDF, status.",
+  "description": "Simple SDK for the local print agent (WebSocket): printers, PDF printing, status.",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -21,14 +21,22 @@
       }
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "sideEffects": false,
   "scripts": {
     "build": "tsup",
     "test": "vitest run",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "release": "npm version patch && npm publish"
   },
-  "keywords": ["printing", "websocket", "pdf", "print-agent"],
+  "keywords": [
+    "printing",
+    "websocket",
+    "pdf",
+    "print-agent"
+  ],
   "license": "MIT",
   "devDependencies": {
     "@types/ws": "^8.5.10",