@rdlabo/capacitor-brotherprint 8.2.0 → 8.2.1

package/README.md

@@ -50,6 +50,13 @@ Amazon Affiliate Links: **https://amzn.to/3AiiOFT**
 
 ※1 Due to low Bluetooth version, connection is not possible with iOS. Ref: https://okbizcs.okwave.jp/brother/qa/q9932082.html
 
+## JavaScript helpers
+
+`BrotherPrinterSession` owns a print screen's discovery results, print listeners and
+shutdown. Pure functions provide model/connection choices, and stateless connection
+helpers remain available. None require Angular or Ionic. See
+[connection management](docs/connection-management.md) for usage.
+
 ## API
 
 <docgen-index>

package/dist/esm/index.d.ts

@@ -1,4 +1,6 @@
+import type { BRLMPrinterModelName } from './brother-printer.enum';
 import type { BrotherPrintPlugin } from './definitions';
+import type { BRLMChannelResult, BRLMPrintOptions, BRLMSearchOption, ErrorInfo } from './interfaces';
 declare const BrotherPrint: BrotherPrintPlugin;
 export * from './definitions';
 export * from './web';
@@ -6,3 +8,50 @@ export * from './events.enum';
 export * from './interfaces';
 export * from './brother-printer.enum';
 export { BrotherPrint };
+export * from './printer';
+/** Collect discovery results, waiting for earlier helper calls to finish. */
+export declare function searchBrotherPrinters(options: BRLMSearchOption, model?: BRLMPrinterModelName): Promise<BRLMChannelResult[]>;
+/**
+ * Reuse a matching, available previous channel; otherwise discover printers.
+ * The caller owns storage. USB always discovers again through the native permission flow.
+ * Availability errors propagate; only an unavailable channel triggers discovery.
+ */
+export declare function prepareBrotherPrinters(options: BRLMSearchOption, model: BRLMPrinterModelName, previous?: BRLMChannelResult | null): Promise<BRLMChannelResult[]>;
+/**
+ * Check an explicitly selected address without discovery or fallback to another printer.
+ * Port must be supplied; an address does not identify its transport or printer model.
+ */
+export declare function checkBrotherPrinterChannel(channel: Pick<BRLMChannelResult, 'port' | 'channelInfo'>): Promise<boolean>;
+export interface BrotherPrinterEvents {
+    onPrint?: () => void;
+    onPrintError?: (info: ErrorInfo) => void;
+    onPrintFailedCommunication?: (info: ErrorInfo) => void;
+}
+/** String storage callbacks; both synchronous and asynchronous stores are supported. */
+export interface BrotherPrinterStorage {
+    get(key: string): string | null | undefined | Promise<string | null | undefined>;
+    set(key: string, value: string): unknown;
+    remove(key: string): unknown;
+}
+export interface BrotherPrinterSessionOptions {
+    storage?: BrotherPrinterStorage;
+    /** Defaults to `brotherprint:`. The session appends `last-printer`. */
+    storagePrefix?: string;
+}
+/** One print screen's discovery results and event subscriptions. Create a new session after disposal. */
+export declare class BrotherPrinterSession {
+    #private;
+    constructor(options?: BrotherPrinterSessionOptions);
+    get closed(): boolean;
+    get printers(): readonly BRLMChannelResult[];
+    search(options: BRLMSearchOption, model?: BRLMPrinterModelName): Promise<readonly BRLMChannelResult[]>;
+    prepare(options: BRLMSearchOption, model: BRLMPrinterModelName, previous?: BRLMChannelResult | null): Promise<readonly BRLMChannelResult[]>;
+    /** Forget the remembered connection. Storage removal errors propagate to the caller. */
+    clearSavedPrinter(): Promise<void>;
+    /** Register print notifications once. Callbacks stop immediately when disposed. */
+    listen(events: BrotherPrinterEvents): Promise<void>;
+    /** A closed session cannot start another print. Already started native printing is awaited. */
+    printImage(options: BRLMPrintOptions): Promise<void>;
+    /** Invalidate pending work immediately, then remove this session's print listeners. */
+    dispose(): Promise<void>;
+}

package/dist/esm/index.js

@@ -1,4 +1,19 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _BrotherPrinterSession_instances, _BrotherPrinterSession_closed, _BrotherPrinterSession_printers, _BrotherPrinterSession_listeners, _BrotherPrinterSession_listening, _BrotherPrinterSession_disposal, _BrotherPrinterSession_storage, _BrotherPrinterSession_storageKey, _BrotherPrinterSession_readSavedPrinter, _BrotherPrinterSession_savePrinter, _BrotherPrinterSession_discover;
 import { registerPlugin } from '@capacitor/core';
+import { BRLMPrinterPort } from './brother-printer.enum';
+import { BrotherPrintEventsEnum } from './events.enum';
+import { brotherPrinterModel } from './printer';
 const BrotherPrint = registerPlugin('BrotherPrint', {
     web: () => import('./web').then((m) => new m.BrotherPrintWeb()),
 });
@@ -8,4 +23,173 @@ export * from './events.enum';
 export * from './interfaces';
 export * from './brother-printer.enum';
 export { BrotherPrint };
+export * from './printer';
+// Native discovery events are shared. Keep each helper call's listener scoped to its turn.
+let connectionQueue = Promise.resolve();
+function queueConnection(run) {
+    const result = connectionQueue.then(run);
+    connectionQueue = result.catch(() => undefined);
+    return result;
+}
+/** Collect discovery results, waiting for earlier helper calls to finish. */
+export function searchBrotherPrinters(options, model) {
+    return queueConnection(() => discoverPrinters(options, model));
+}
+/**
+ * Reuse a matching, available previous channel; otherwise discover printers.
+ * The caller owns storage. USB always discovers again through the native permission flow.
+ * Availability errors propagate; only an unavailable channel triggers discovery.
+ */
+export function prepareBrotherPrinters(options, model, previous) {
+    return queueConnection(() => preparePrinters(options, model, previous));
+}
+/**
+ * Check an explicitly selected address without discovery or fallback to another printer.
+ * Port must be supplied; an address does not identify its transport or printer model.
+ */
+export function checkBrotherPrinterChannel(channel) {
+    return queueConnection(async () => {
+        const { result } = await BrotherPrint.isChannelAvailable(Object.assign({ modelName: '', serialNumber: '', macAddress: '', nodeName: '', location: '' }, channel));
+        return result;
+    });
+}
+async function discoverPrinters(options, model, active = () => true) {
+    const printers = [];
+    const listener = await BrotherPrint.addListener(BrotherPrintEventsEnum.onPrinterAvailable, (printer) => {
+        if (printer.port !== options.port)
+            return;
+        if (printer.port !== BRLMPrinterPort.usb && model !== undefined && brotherPrinterModel(printer.modelName) !== model)
+            return;
+        const index = printers.findIndex((current) => current.port === printer.port && current.channelInfo === printer.channelInfo);
+        if (index < 0)
+            printers.push(printer);
+        else
+            printers[index] = printer;
+    });
+    await (active() ? BrotherPrint.search(options) : Promise.resolve()).finally(() => listener.remove());
+    return printers;
+}
+async function preparePrinters(options, model, previous, active = () => true) {
+    if (options.port !== BRLMPrinterPort.usb &&
+        (previous === null || previous === void 0 ? void 0 : previous.port) === options.port &&
+        previous.channelInfo.trim() &&
+        brotherPrinterModel(previous.modelName) === model) {
+        const available = await BrotherPrint.isChannelAvailable(previous);
+        if (available.result)
+            return [previous];
+    }
+    return active() ? discoverPrinters(options, model, active) : [];
+}
+/** One print screen's discovery results and event subscriptions. Create a new session after disposal. */
+export class BrotherPrinterSession {
+    constructor(options = {}) {
+        var _a;
+        _BrotherPrinterSession_instances.add(this);
+        _BrotherPrinterSession_closed.set(this, false);
+        _BrotherPrinterSession_printers.set(this, []);
+        _BrotherPrinterSession_listeners.set(this, []);
+        _BrotherPrinterSession_listening.set(this, void 0);
+        _BrotherPrinterSession_disposal.set(this, void 0);
+        _BrotherPrinterSession_storage.set(this, void 0);
+        _BrotherPrinterSession_storageKey.set(this, void 0);
+        __classPrivateFieldSet(this, _BrotherPrinterSession_storage, options.storage, "f");
+        __classPrivateFieldSet(this, _BrotherPrinterSession_storageKey, `${(_a = options.storagePrefix) !== null && _a !== void 0 ? _a : 'brotherprint:'}last-printer`, "f");
+    }
+    get closed() {
+        return __classPrivateFieldGet(this, _BrotherPrinterSession_closed, "f");
+    }
+    get printers() {
+        return __classPrivateFieldGet(this, _BrotherPrinterSession_printers, "f");
+    }
+    search(options, model) {
+        return __classPrivateFieldGet(this, _BrotherPrinterSession_instances, "m", _BrotherPrinterSession_discover).call(this, () => discoverPrinters(options, model, () => !__classPrivateFieldGet(this, _BrotherPrinterSession_closed, "f")));
+    }
+    prepare(options, model, previous) {
+        return __classPrivateFieldGet(this, _BrotherPrinterSession_instances, "m", _BrotherPrinterSession_discover).call(this, async () => {
+            const saved = previous === undefined ? await __classPrivateFieldGet(this, _BrotherPrinterSession_instances, "m", _BrotherPrinterSession_readSavedPrinter).call(this).catch(() => undefined) : previous;
+            if (__classPrivateFieldGet(this, _BrotherPrinterSession_closed, "f"))
+                return [];
+            return preparePrinters(options, model, saved, () => !__classPrivateFieldGet(this, _BrotherPrinterSession_closed, "f"));
+        });
+    }
+    /** Forget the remembered connection. Storage removal errors propagate to the caller. */
+    async clearSavedPrinter() {
+        var _a;
+        await ((_a = __classPrivateFieldGet(this, _BrotherPrinterSession_storage, "f")) === null || _a === void 0 ? void 0 : _a.remove(__classPrivateFieldGet(this, _BrotherPrinterSession_storageKey, "f")));
+    }
+    /** Register print notifications once. Callbacks stop immediately when disposed. */
+    listen(events) {
+        if (__classPrivateFieldGet(this, _BrotherPrinterSession_closed, "f"))
+            return Promise.resolve();
+        if (!__classPrivateFieldGet(this, _BrotherPrinterSession_listening, "f")) {
+            __classPrivateFieldSet(this, _BrotherPrinterSession_listeners, [
+                BrotherPrint.addListener(BrotherPrintEventsEnum.onPrint, () => {
+                    var _a;
+                    if (!__classPrivateFieldGet(this, _BrotherPrinterSession_closed, "f"))
+                        (_a = events.onPrint) === null || _a === void 0 ? void 0 : _a.call(events);
+                }),
+                BrotherPrint.addListener(BrotherPrintEventsEnum.onPrintError, (info) => {
+                    var _a;
+                    if (!__classPrivateFieldGet(this, _BrotherPrinterSession_closed, "f"))
+                        (_a = events.onPrintError) === null || _a === void 0 ? void 0 : _a.call(events, info);
+                }),
+                BrotherPrint.addListener(BrotherPrintEventsEnum.onPrintFailedCommunication, (info) => {
+                    var _a;
+                    if (!__classPrivateFieldGet(this, _BrotherPrinterSession_closed, "f"))
+                        (_a = events.onPrintFailedCommunication) === null || _a === void 0 ? void 0 : _a.call(events, info);
+                }),
+            ], "f");
+            __classPrivateFieldSet(this, _BrotherPrinterSession_listening, Promise.all(__classPrivateFieldGet(this, _BrotherPrinterSession_listeners, "f")).then(() => undefined), "f");
+        }
+        return __classPrivateFieldGet(this, _BrotherPrinterSession_listening, "f");
+    }
+    /** A closed session cannot start another print. Already started native printing is awaited. */
+    async printImage(options) {
+        if (__classPrivateFieldGet(this, _BrotherPrinterSession_closed, "f"))
+            return;
+        if (__classPrivateFieldGet(this, _BrotherPrinterSession_storage, "f"))
+            await __classPrivateFieldGet(this, _BrotherPrinterSession_instances, "m", _BrotherPrinterSession_savePrinter).call(this, options).catch(() => undefined);
+        if (!__classPrivateFieldGet(this, _BrotherPrinterSession_closed, "f"))
+            await BrotherPrint.printImage(options);
+    }
+    /** Invalidate pending work immediately, then remove this session's print listeners. */
+    dispose() {
+        var _a;
+        __classPrivateFieldSet(this, _BrotherPrinterSession_closed, true, "f");
+        __classPrivateFieldSet(this, _BrotherPrinterSession_printers, [], "f");
+        __classPrivateFieldSet(this, _BrotherPrinterSession_disposal, (_a = __classPrivateFieldGet(this, _BrotherPrinterSession_disposal, "f")) !== null && _a !== void 0 ? _a : Promise.all(__classPrivateFieldGet(this, _BrotherPrinterSession_listeners, "f").map((listener) => listener.then((handle) => handle.remove()))).then(() => undefined), "f");
+        return __classPrivateFieldGet(this, _BrotherPrinterSession_disposal, "f");
+    }
+}
+_BrotherPrinterSession_closed = new WeakMap(), _BrotherPrinterSession_printers = new WeakMap(), _BrotherPrinterSession_listeners = new WeakMap(), _BrotherPrinterSession_listening = new WeakMap(), _BrotherPrinterSession_disposal = new WeakMap(), _BrotherPrinterSession_storage = new WeakMap(), _BrotherPrinterSession_storageKey = new WeakMap(), _BrotherPrinterSession_instances = new WeakSet(), _BrotherPrinterSession_readSavedPrinter = async function _BrotherPrinterSession_readSavedPrinter() {
+    var _a;
+    const value = await ((_a = __classPrivateFieldGet(this, _BrotherPrinterSession_storage, "f")) === null || _a === void 0 ? void 0 : _a.get(__classPrivateFieldGet(this, _BrotherPrinterSession_storageKey, "f")));
+    if (!value)
+        return undefined;
+    const channel = JSON.parse(value);
+    if (channel &&
+        Object.values(BRLMPrinterPort).includes(channel.port) &&
+        ['modelName', 'channelInfo', 'serialNumber', 'macAddress', 'nodeName', 'location'].every((key) => typeof channel[key] === 'string'))
+        return channel;
+    return undefined;
+}, _BrotherPrinterSession_savePrinter = async function _BrotherPrinterSession_savePrinter(options) {
+    var _a;
+    if (!__classPrivateFieldGet(this, _BrotherPrinterSession_storage, "f") || !options.port || !((_a = options.channelInfo) === null || _a === void 0 ? void 0 : _a.trim()))
+        return;
+    const found = __classPrivateFieldGet(this, _BrotherPrinterSession_printers, "f").find((printer) => printer.port === options.port && printer.channelInfo === options.channelInfo);
+    const channel = Object.assign(Object.assign({ serialNumber: '', macAddress: '', nodeName: '', location: '' }, found), { port: options.port, channelInfo: options.channelInfo, modelName: options.modelName });
+    await __classPrivateFieldGet(this, _BrotherPrinterSession_storage, "f").set(__classPrivateFieldGet(this, _BrotherPrinterSession_storageKey, "f"), JSON.stringify(channel));
+}, _BrotherPrinterSession_discover = function _BrotherPrinterSession_discover(run) {
+    return queueConnection(async () => {
+        if (__classPrivateFieldGet(this, _BrotherPrinterSession_closed, "f"))
+            return [];
+        __classPrivateFieldSet(this, _BrotherPrinterSession_printers, [], "f");
+        return run().then((printers) => {
+            if (__classPrivateFieldGet(this, _BrotherPrinterSession_closed, "f"))
+                return [];
+            __classPrivateFieldSet(this, _BrotherPrinterSession_printers, printers, "f");
+            return printers;
+        });
+    });
+};
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,YAAY,GAAG,cAAc,CAAqB,cAAc,EAAE;IACtE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;CAChE,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC;AACtB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { BrotherPrintPlugin } from './definitions';\n\nconst BrotherPrint = registerPlugin<BrotherPrintPlugin>('BrotherPrint', {\n  web: () => import('./web').then((m) => new m.BrotherPrintWeb()),\n});\n\nexport * from './definitions';\nexport * from './web';\nexport * from './events.enum';\nexport * from './interfaces';\nexport * from './brother-printer.enum';\nexport { BrotherPrint };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\nimport { registerPlugin } from '@capacitor/core';\n\nimport type { BRLMPrinterModelName } from './brother-printer.enum';\nimport { BRLMPrinterPort } from './brother-printer.enum';\nimport type { BrotherPrintPlugin } from './definitions';\nimport { BrotherPrintEventsEnum } from './events.enum';\nimport type { BRLMChannelResult, BRLMPrintOptions, BRLMSearchOption, ErrorInfo } from './interfaces';\nimport { brotherPrinterModel } from './printer';\n\nconst BrotherPrint = registerPlugin<BrotherPrintPlugin>('BrotherPrint', {\n  web: () => import('./web').then((m) => new m.BrotherPrintWeb()),\n});\n\nexport * from './definitions';\nexport * from './web';\nexport * from './events.enum';\nexport * from './interfaces';\nexport * from './brother-printer.enum';\nexport { BrotherPrint };\n\nexport * from './printer';\n\n// Native discovery events are shared. Keep each helper call's listener scoped to its turn.\nlet connectionQueue: Promise<unknown> = Promise.resolve();\n\nfunction queueConnection<T>(run: () => Promise<T>): Promise<T> {\n  const result = connectionQueue.then(run);\n  connectionQueue = result.catch(() => undefined);\n  return result;\n}\n\n/** Collect discovery results, waiting for earlier helper calls to finish. */\nexport function searchBrotherPrinters(\n  options: BRLMSearchOption,\n  model?: BRLMPrinterModelName,\n): Promise<BRLMChannelResult[]> {\n  return queueConnection(() => discoverPrinters(options, model));\n}\n\n/**\n * Reuse a matching, available previous channel; otherwise discover printers.\n * The caller owns storage. USB always discovers again through the native permission flow.\n * Availability errors propagate; only an unavailable channel triggers discovery.\n */\nexport function prepareBrotherPrinters(\n  options: BRLMSearchOption,\n  model: BRLMPrinterModelName,\n  previous?: BRLMChannelResult | null,\n): Promise<BRLMChannelResult[]> {\n  return queueConnection(() => preparePrinters(options, model, previous));\n}\n\n/**\n * Check an explicitly selected address without discovery or fallback to another printer.\n * Port must be supplied; an address does not identify its transport or printer model.\n */\nexport function checkBrotherPrinterChannel(channel: Pick<BRLMChannelResult, 'port' | 'channelInfo'>): Promise<boolean> {\n  return queueConnection(async () => {\n    const { result } = await BrotherPrint.isChannelAvailable({\n      modelName: '',\n      serialNumber: '',\n      macAddress: '',\n      nodeName: '',\n      location: '',\n      ...channel,\n    });\n    return result;\n  });\n}\n\nasync function discoverPrinters(\n  options: BRLMSearchOption,\n  model?: BRLMPrinterModelName,\n  active: () => boolean = () => true,\n): Promise<BRLMChannelResult[]> {\n  const printers: BRLMChannelResult[] = [];\n  const listener = await BrotherPrint.addListener(BrotherPrintEventsEnum.onPrinterAvailable, (printer) => {\n    if (printer.port !== options.port) return;\n    if (printer.port !== BRLMPrinterPort.usb && model !== undefined && brotherPrinterModel(printer.modelName) !== model)\n      return;\n    const index = printers.findIndex(\n      (current) => current.port === printer.port && current.channelInfo === printer.channelInfo,\n    );\n    if (index < 0) printers.push(printer);\n    else printers[index] = printer;\n  });\n  await (active() ? BrotherPrint.search(options) : Promise.resolve()).finally(() => listener.remove());\n  return printers;\n}\n\nasync function preparePrinters(\n  options: BRLMSearchOption,\n  model: BRLMPrinterModelName,\n  previous?: BRLMChannelResult | null,\n  active: () => boolean = () => true,\n): Promise<BRLMChannelResult[]> {\n  if (\n    options.port !== BRLMPrinterPort.usb &&\n    previous?.port === options.port &&\n    previous.channelInfo.trim() &&\n    brotherPrinterModel(previous.modelName) === model\n  ) {\n    const available = await BrotherPrint.isChannelAvailable(previous);\n    if (available.result) return [previous];\n  }\n  return active() ? discoverPrinters(options, model, active) : [];\n}\n\nexport interface BrotherPrinterEvents {\n  onPrint?: () => void;\n  onPrintError?: (info: ErrorInfo) => void;\n  onPrintFailedCommunication?: (info: ErrorInfo) => void;\n}\n\n/** String storage callbacks; both synchronous and asynchronous stores are supported. */\nexport interface BrotherPrinterStorage {\n  get(key: string): string | null | undefined | Promise<string | null | undefined>;\n  set(key: string, value: string): unknown;\n  remove(key: string): unknown;\n}\n\nexport interface BrotherPrinterSessionOptions {\n  storage?: BrotherPrinterStorage;\n  /** Defaults to `brotherprint:`. The session appends `last-printer`. */\n  storagePrefix?: string;\n}\n\n/** One print screen's discovery results and event subscriptions. Create a new session after disposal. */\nexport class BrotherPrinterSession {\n  #closed = false;\n  #printers: BRLMChannelResult[] = [];\n  #listeners: Promise<PluginListenerHandle>[] = [];\n  #listening?: Promise<void>;\n  #disposal?: Promise<void>;\n  readonly #storage?: BrotherPrinterStorage;\n  readonly #storageKey: string;\n\n  constructor(options: BrotherPrinterSessionOptions = {}) {\n    this.#storage = options.storage;\n    this.#storageKey = `${options.storagePrefix ?? 'brotherprint:'}last-printer`;\n  }\n\n  get closed(): boolean {\n    return this.#closed;\n  }\n\n  get printers(): readonly BRLMChannelResult[] {\n    return this.#printers;\n  }\n\n  search(options: BRLMSearchOption, model?: BRLMPrinterModelName): Promise<readonly BRLMChannelResult[]> {\n    return this.#discover(() => discoverPrinters(options, model, () => !this.#closed));\n  }\n\n  prepare(\n    options: BRLMSearchOption,\n    model: BRLMPrinterModelName,\n    previous?: BRLMChannelResult | null,\n  ): Promise<readonly BRLMChannelResult[]> {\n    return this.#discover(async () => {\n      const saved = previous === undefined ? await this.#readSavedPrinter().catch(() => undefined) : previous;\n      if (this.#closed) return [];\n      return preparePrinters(options, model, saved, () => !this.#closed);\n    });\n  }\n\n  async #readSavedPrinter(): Promise<BRLMChannelResult | undefined> {\n    const value = await this.#storage?.get(this.#storageKey);\n    if (!value) return undefined;\n    const channel = JSON.parse(value);\n    if (\n      channel &&\n      Object.values(BRLMPrinterPort).includes(channel.port) &&\n      ['modelName', 'channelInfo', 'serialNumber', 'macAddress', 'nodeName', 'location'].every(\n        (key) => typeof channel[key] === 'string',\n      )\n    )\n      return channel;\n    return undefined;\n  }\n\n  /** Forget the remembered connection. Storage removal errors propagate to the caller. */\n  async clearSavedPrinter(): Promise<void> {\n    await this.#storage?.remove(this.#storageKey);\n  }\n\n  async #savePrinter(options: BRLMPrintOptions): Promise<void> {\n    if (!this.#storage || !options.port || !options.channelInfo?.trim()) return;\n    const found = this.#printers.find(\n      (printer) => printer.port === options.port && printer.channelInfo === options.channelInfo,\n    );\n    const channel: BRLMChannelResult = {\n      serialNumber: '',\n      macAddress: '',\n      nodeName: '',\n      location: '',\n      ...found,\n      port: options.port,\n      channelInfo: options.channelInfo,\n      modelName: options.modelName,\n    };\n    await this.#storage.set(this.#storageKey, JSON.stringify(channel));\n  }\n\n  #discover(run: () => Promise<BRLMChannelResult[]>): Promise<readonly BRLMChannelResult[]> {\n    return queueConnection(async () => {\n      if (this.#closed) return [];\n      this.#printers = [];\n      return run().then((printers) => {\n        if (this.#closed) return [];\n        this.#printers = printers;\n        return printers;\n      });\n    });\n  }\n\n  /** Register print notifications once. Callbacks stop immediately when disposed. */\n  listen(events: BrotherPrinterEvents): Promise<void> {\n    if (this.#closed) return Promise.resolve();\n    if (!this.#listening) {\n      this.#listeners = [\n        BrotherPrint.addListener(BrotherPrintEventsEnum.onPrint, () => {\n          if (!this.#closed) events.onPrint?.();\n        }),\n        BrotherPrint.addListener(BrotherPrintEventsEnum.onPrintError, (info) => {\n          if (!this.#closed) events.onPrintError?.(info);\n        }),\n        BrotherPrint.addListener(BrotherPrintEventsEnum.onPrintFailedCommunication, (info) => {\n          if (!this.#closed) events.onPrintFailedCommunication?.(info);\n        }),\n      ];\n      this.#listening = Promise.all(this.#listeners).then(() => undefined);\n    }\n    return this.#listening;\n  }\n\n  /** A closed session cannot start another print. Already started native printing is awaited. */\n  async printImage(options: BRLMPrintOptions): Promise<void> {\n    if (this.#closed) return;\n    if (this.#storage) await this.#savePrinter(options).catch(() => undefined);\n    if (!this.#closed) await BrotherPrint.printImage(options);\n  }\n\n  /** Invalidate pending work immediately, then remove this session's print listeners. */\n  dispose(): Promise<void> {\n    this.#closed = true;\n    this.#printers = [];\n    this.#disposal ??= Promise.all(this.#listeners.map((listener) => listener.then((handle) => handle.remove()))).then(\n      () => undefined,\n    );\n    return this.#disposal;\n  }\n}\n"]}

package/dist/esm/models.d.ts

@@ -0,0 +1,2 @@
+import { BRLMPrinterModelName as Model, BRLMPrinterPort as Port } from './brother-printer.enum';
+export declare const printerPorts: Record<Model, readonly Port[]>;

package/dist/esm/models.js

@@ -0,0 +1,10 @@
+import { BRLMPrinterModelName as Model, BRLMPrinterPort as Port } from './brother-printer.enum';
+export const printerPorts = {
+    [Model.QL_800]: [Port.usb],
+    [Model.QL_810W]: [Port.wifi, Port.usb],
+    [Model.QL_820NWB]: [Port.wifi, Port.bluetooth, Port.usb],
+    [Model.TD_2320D_203]: [Port.wifi, Port.usb],
+    [Model.TD_2030AD]: [Port.usb],
+    [Model.TD_2350D_300]: [Port.wifi, Port.bluetooth, Port.usb, Port.bluetoothLowEnergy],
+};
+//# sourceMappingURL=models.js.map

package/dist/esm/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,IAAI,KAAK,EAAE,eAAe,IAAI,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEhG,MAAM,CAAC,MAAM,YAAY,GAAmC;IAC1D,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;IAC1B,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;IACtC,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC;IACxD,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;IAC3C,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;IAC7B,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,kBAAkB,CAAC;CACrF,CAAC","sourcesContent":["import { BRLMPrinterModelName as Model, BRLMPrinterPort as Port } from './brother-printer.enum';\n\nexport const printerPorts: Record<Model, readonly Port[]> = {\n  [Model.QL_800]: [Port.usb],\n  [Model.QL_810W]: [Port.wifi, Port.usb],\n  [Model.QL_820NWB]: [Port.wifi, Port.bluetooth, Port.usb],\n  [Model.TD_2320D_203]: [Port.wifi, Port.usb],\n  [Model.TD_2030AD]: [Port.usb],\n  [Model.TD_2350D_300]: [Port.wifi, Port.bluetooth, Port.usb, Port.bluetoothLowEnergy],\n};\n"]}

package/dist/esm/printer.d.ts

@@ -0,0 +1,9 @@
+import { BRLMPrinterModelName, BRLMPrinterPort } from './brother-printer.enum';
+/** Common display names for connection transports. */
+export declare function brotherPrinterPortLabel(port: BRLMPrinterPort | undefined): string;
+/** Connection choices for the existing models. USB is Android-only; wifi also covers Ethernet. */
+export declare function brotherPrinterPorts(model: string, isAndroid?: boolean): BRLMPrinterPort[];
+/** Keep a supported saved port; otherwise prefer USB for QL-800/810W on Android. */
+export declare function resolveBrotherPrinterPort(model: string, saved?: BRLMPrinterPort): BRLMPrinterPort | undefined;
+/** Match discovery names to an existing model enum, including documented product aliases. */
+export declare function brotherPrinterModel(name: string): BRLMPrinterModelName | undefined;

package/dist/esm/printer.js

@@ -0,0 +1,46 @@
+import { Capacitor } from '@capacitor/core';
+import { BRLMPrinterModelName, BRLMPrinterPort } from './brother-printer.enum';
+import { printerPorts } from './models';
+/** Common display names for connection transports. */
+export function brotherPrinterPortLabel(port) {
+    switch (port) {
+        case BRLMPrinterPort.wifi:
+            return 'Wi-Fi';
+        case BRLMPrinterPort.bluetooth:
+            return 'Bluetooth';
+        case BRLMPrinterPort.bluetoothLowEnergy:
+            return 'Bluetooth LE';
+        case BRLMPrinterPort.usb:
+            return 'USB';
+        default:
+            return '';
+    }
+}
+/** Connection choices for the existing models. USB is Android-only; wifi also covers Ethernet. */
+export function brotherPrinterPorts(model, isAndroid = Capacitor.getPlatform() === 'android') {
+    if (!Object.values(BRLMPrinterModelName).includes(model))
+        return [];
+    return printerPorts[model].filter((port) => isAndroid || port !== BRLMPrinterPort.usb);
+}
+/** Keep a supported saved port; otherwise prefer USB for QL-800/810W on Android. */
+export function resolveBrotherPrinterPort(model, saved) {
+    const ports = brotherPrinterPorts(model);
+    if (saved && ports.includes(saved))
+        return saved;
+    if (ports.includes(BRLMPrinterPort.usb) &&
+        (model === BRLMPrinterModelName.QL_800 || model === BRLMPrinterModelName.QL_810W))
+        return BRLMPrinterPort.usb;
+    return ports[0];
+}
+/** Match discovery names to an existing model enum, including documented product aliases. */
+export function brotherPrinterModel(name) {
+    const key = name
+        .trim()
+        .toUpperCase()
+        .replace(/^BROTHER\s+/, '')
+        .replace(/[-_ ]/g, '');
+    // Product names omit TD resolution; QL-820NWBc and TD-2030A use the existing enum spellings.
+    const product = key === 'QL820NWBC' ? 'QL820NWB' : key === 'TD2030A' ? 'TD2030AD' : key;
+    return Object.values(BRLMPrinterModelName).find((model) => model.replace(/_/g, '') === product || model.replace(/_(203|300)$/, '').replace(/_/g, '') === product);
+}
+//# sourceMappingURL=printer.js.map

package/dist/esm/printer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"printer.js","sourceRoot":"","sources":["../../src/printer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,sDAAsD;AACtD,MAAM,UAAU,uBAAuB,CAAC,IAAiC;IACvE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,eAAe,CAAC,IAAI;YACvB,OAAO,OAAO,CAAC;QACjB,KAAK,eAAe,CAAC,SAAS;YAC5B,OAAO,WAAW,CAAC;QACrB,KAAK,eAAe,CAAC,kBAAkB;YACrC,OAAO,cAAc,CAAC;QACxB,KAAK,eAAe,CAAC,GAAG;YACtB,OAAO,KAAK,CAAC;QACf;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,KAAK,SAAS;IAEjD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,KAA6B,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5F,OAAO,YAAY,CAAC,KAA6B,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,IAAI,IAAI,KAAK,eAAe,CAAC,GAAG,CAAC,CAAC;AACjH,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,yBAAyB,CAAC,KAAa,EAAE,KAAuB;IAC9E,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACjD,IACE,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC;QACnC,CAAC,KAAK,KAAK,oBAAoB,CAAC,MAAM,IAAI,KAAK,KAAK,oBAAoB,CAAC,OAAO,CAAC;QAEjF,OAAO,eAAe,CAAC,GAAG,CAAC;IAC7B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,GAAG,GAAG,IAAI;SACb,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACzB,6FAA6F;IAC7F,MAAM,OAAO,GAAG,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;IACxF,OAAO,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAC7C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,OAAO,CACjH,CAAC;AACJ,CAAC","sourcesContent":["import { Capacitor } from '@capacitor/core';\n\nimport { BRLMPrinterModelName, BRLMPrinterPort } from './brother-printer.enum';\nimport { printerPorts } from './models';\n\n/** Common display names for connection transports. */\nexport function brotherPrinterPortLabel(port: BRLMPrinterPort | undefined): string {\n  switch (port) {\n    case BRLMPrinterPort.wifi:\n      return 'Wi-Fi';\n    case BRLMPrinterPort.bluetooth:\n      return 'Bluetooth';\n    case BRLMPrinterPort.bluetoothLowEnergy:\n      return 'Bluetooth LE';\n    case BRLMPrinterPort.usb:\n      return 'USB';\n    default:\n      return '';\n  }\n}\n\n/** Connection choices for the existing models. USB is Android-only; wifi also covers Ethernet. */\nexport function brotherPrinterPorts(\n  model: string,\n  isAndroid = Capacitor.getPlatform() === 'android',\n): BRLMPrinterPort[] {\n  if (!Object.values(BRLMPrinterModelName).includes(model as BRLMPrinterModelName)) return [];\n  return printerPorts[model as BRLMPrinterModelName].filter((port) => isAndroid || port !== BRLMPrinterPort.usb);\n}\n\n/** Keep a supported saved port; otherwise prefer USB for QL-800/810W on Android. */\nexport function resolveBrotherPrinterPort(model: string, saved?: BRLMPrinterPort): BRLMPrinterPort | undefined {\n  const ports = brotherPrinterPorts(model);\n  if (saved && ports.includes(saved)) return saved;\n  if (\n    ports.includes(BRLMPrinterPort.usb) &&\n    (model === BRLMPrinterModelName.QL_800 || model === BRLMPrinterModelName.QL_810W)\n  )\n    return BRLMPrinterPort.usb;\n  return ports[0];\n}\n\n/** Match discovery names to an existing model enum, including documented product aliases. */\nexport function brotherPrinterModel(name: string): BRLMPrinterModelName | undefined {\n  const key = name\n    .trim()\n    .toUpperCase()\n    .replace(/^BROTHER\\s+/, '')\n    .replace(/[-_ ]/g, '');\n  // Product names omit TD resolution; QL-820NWBc and TD-2030A use the existing enum spellings.\n  const product = key === 'QL820NWBC' ? 'QL820NWB' : key === 'TD2030A' ? 'TD2030AD' : key;\n  return Object.values(BRLMPrinterModelName).find(\n    (model) => model.replace(/_/g, '') === product || model.replace(/_(203|300)$/, '').replace(/_/g, '') === product,\n  );\n}\n"]}