@risleylima/escpos 0.2.0 → 1.0.0

package/dist/adapter/index.d.ts

@@ -0,0 +1,29 @@
+import { EventEmitter } from 'events';
+export type AdapterState = 'DISCONNECTED' | 'CONNECTING' | 'CONNECTED' | 'OPENING' | 'READY' | 'BUSY' | 'CLOSING';
+export declare abstract class Adapter extends EventEmitter {
+    protected state: AdapterState;
+    private lockPromise;
+    /**
+     * Serializes all IO operations at the adapter level to prevent data interleaving
+     * and race conditions across multiple printer instances sharing the same adapter.
+     */
+    protected synchronized<T>(task: () => Promise<T>): Promise<T>;
+    getState(): AdapterState;
+    abstract connect(...args: unknown[]): Promise<boolean>;
+    abstract open(): Promise<boolean>;
+    abstract write(data: Buffer): Promise<boolean>;
+    abstract read(): Promise<Buffer>;
+    abstract close(options?: {
+        timeout?: number;
+    }): Promise<boolean>;
+    abstract disconnect(): Promise<boolean>;
+}
+export type AdapterLike = {
+    write(data: Buffer): Promise<boolean>;
+    read(): Promise<Buffer>;
+    close(options?: {
+        timeout?: number;
+    }): Promise<boolean>;
+    getState?(): string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/adapter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAElH,8BAAsB,OAAQ,SAAQ,YAAY;IAChD,SAAS,CAAC,KAAK,EAAE,YAAY,CAAkB;IAC/C,OAAO,CAAC,WAAW,CAAoC;IAEvD;;;OAGG;cACa,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAMnE,QAAQ,IAAI,YAAY;IAIxB,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IACtD,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAC9C,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAChE,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;CACxC;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,QAAQ,CAAC,IAAI,MAAM,CAAC;CACrB,CAAC"}

package/dist/adapter/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Adapter = void 0;
+const events_1 = require("events");
+class Adapter extends events_1.EventEmitter {
+    constructor() {
+        super(...arguments);
+        this.state = 'DISCONNECTED';
+        this.lockPromise = Promise.resolve();
+    }
+    /**
+     * Serializes all IO operations at the adapter level to prevent data interleaving
+     * and race conditions across multiple printer instances sharing the same adapter.
+     */
+    async synchronized(task) {
+        const run = this.lockPromise.then(task, task);
+        this.lockPromise = run.then(() => undefined, () => undefined);
+        return run;
+    }
+    getState() {
+        return this.state;
+    }
+}
+exports.Adapter = Adapter;
+//# sourceMappingURL=index.js.map

package/dist/adapter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":";;;AAAA,mCAAsC;AAItC,MAAsB,OAAQ,SAAQ,qBAAY;IAAlD;;QACY,UAAK,GAAiB,cAAc,CAAC;QACvC,gBAAW,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAsBzD,CAAC;IApBC;;;OAGG;IACO,KAAK,CAAC,YAAY,CAAI,IAAsB;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC9D,OAAO,GAAG,CAAC;IACb,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CAQF;AAxBD,0BAwBC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { Adapter } from './adapter';
+import { Serial } from './serial-adapter';
+import { USB } from './usb-adapter';
+import { Network } from './network-adapter';
+import { Printer } from './printer';
+import { Image } from './printer/image';
+export { Adapter, Serial, USB, Network, Printer, Image };
+export type { AdapterLike } from './adapter';
+export type { NetworkConnectOptions } from './network-adapter';
+export type { PrinterOptions, RowColumn, LineItemOptions, TotalOptions, PresentTicketOptions } from './printer';
+export type { PixelsObject, ImageProcessingOptions } from './printer/image';
+export { getProfile, registerProfile, createProfileRegistry, getCommandsForProfile, listProfiles, defaultProfile, customVkp80iiiProfile, bematechMp4200thProfile, } from './printer/profiles';
+export type { PrinterProfile, CommandSet, CommandSetOverride, PaperWidthCommandFn, TicketPresentationOptions, BarcodeOptions, QrCodeOptions, BarcodeBuildContext, QrCodeBuildContext, Vkp80iiiTicketPresentationOptions, ProfileRegistry, } from './printer/profiles';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAChH,YAAY,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EACL,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,iCAAiC,EACjC,eAAe,GAChB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bematechMp4200thProfile = exports.customVkp80iiiProfile = exports.defaultProfile = exports.listProfiles = exports.getCommandsForProfile = exports.createProfileRegistry = exports.registerProfile = exports.getProfile = exports.Image = exports.Printer = exports.Network = exports.USB = exports.Serial = exports.Adapter = void 0;
+const adapter_1 = require("./adapter");
+Object.defineProperty(exports, "Adapter", { enumerable: true, get: function () { return adapter_1.Adapter; } });
+const serial_adapter_1 = require("./serial-adapter");
+Object.defineProperty(exports, "Serial", { enumerable: true, get: function () { return serial_adapter_1.Serial; } });
+const usb_adapter_1 = require("./usb-adapter");
+Object.defineProperty(exports, "USB", { enumerable: true, get: function () { return usb_adapter_1.USB; } });
+const network_adapter_1 = require("./network-adapter");
+Object.defineProperty(exports, "Network", { enumerable: true, get: function () { return network_adapter_1.Network; } });
+const printer_1 = require("./printer");
+Object.defineProperty(exports, "Printer", { enumerable: true, get: function () { return printer_1.Printer; } });
+const image_1 = require("./printer/image");
+Object.defineProperty(exports, "Image", { enumerable: true, get: function () { return image_1.Image; } });
+var profiles_1 = require("./printer/profiles");
+Object.defineProperty(exports, "getProfile", { enumerable: true, get: function () { return profiles_1.getProfile; } });
+Object.defineProperty(exports, "registerProfile", { enumerable: true, get: function () { return profiles_1.registerProfile; } });
+Object.defineProperty(exports, "createProfileRegistry", { enumerable: true, get: function () { return profiles_1.createProfileRegistry; } });
+Object.defineProperty(exports, "getCommandsForProfile", { enumerable: true, get: function () { return profiles_1.getCommandsForProfile; } });
+Object.defineProperty(exports, "listProfiles", { enumerable: true, get: function () { return profiles_1.listProfiles; } });
+Object.defineProperty(exports, "defaultProfile", { enumerable: true, get: function () { return profiles_1.defaultProfile; } });
+Object.defineProperty(exports, "customVkp80iiiProfile", { enumerable: true, get: function () { return profiles_1.customVkp80iiiProfile; } });
+Object.defineProperty(exports, "bematechMp4200thProfile", { enumerable: true, get: function () { return profiles_1.bematechMp4200thProfile; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAAoC;AAO3B,wFAPA,iBAAO,OAOA;AANhB,qDAA0C;AAMxB,uFANT,uBAAM,OAMS;AALxB,+CAAoC;AAKV,oFALjB,iBAAG,OAKiB;AAJ7B,uDAA4C;AAIb,wFAJtB,yBAAO,OAIsB;AAHtC,uCAAoC;AAGI,wFAH/B,iBAAO,OAG+B;AAF/C,2CAAwC;AAES,sFAFxC,aAAK,OAEwC;AAKtD,+CAS4B;AAR1B,sGAAA,UAAU,OAAA;AACV,2GAAA,eAAe,OAAA;AACf,iHAAA,qBAAqB,OAAA;AACrB,iHAAA,qBAAqB,OAAA;AACrB,wGAAA,YAAY,OAAA;AACZ,0GAAA,cAAc,OAAA;AACd,iHAAA,qBAAqB,OAAA;AACrB,mHAAA,uBAAuB,OAAA"}

package/dist/network-adapter/index.d.ts

@@ -0,0 +1,24 @@
+import { Adapter } from '../adapter';
+export interface NetworkConnectOptions {
+    host: string;
+    port: number;
+    timeout?: number;
+}
+export declare class Network extends Adapter {
+    private socket;
+    private options;
+    connect(hostOrOptions: string | NetworkConnectOptions, portOrNothing?: number, options?: {
+        timeout?: number;
+    }): Promise<boolean>;
+    open(): Promise<boolean>;
+    write(data: Buffer): Promise<boolean>;
+    private writeChunk;
+    read(): Promise<Buffer>;
+    close(options?: {
+        timeout?: number;
+    }): Promise<boolean>;
+    disconnect(options?: {
+        timeout?: number;
+    }): Promise<boolean>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/network-adapter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/network-adapter/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAIrC,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAQD,qBAAa,OAAQ,SAAQ,OAAO;IAClC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAAsC;IAE/C,OAAO,CACX,aAAa,EAAE,MAAM,GAAG,qBAAqB,EAC7C,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7B,OAAO,CAAC,OAAO,CAAC;IA2Bb,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAsDxB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB3C,OAAO,CAAC,UAAU;IAmDZ,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IA4BvB,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BvD,UAAU,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAGnE"}

package/dist/network-adapter/index.js

@@ -0,0 +1,263 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Network = void 0;
+const net = __importStar(require("net"));
+const adapter_1 = require("../adapter");
+const debug = require('debug')('escpos:network-adapter');
+const NOT_CONNECTED_MSG = 'Not connected. Call connect(host, port) first.';
+const DEFAULT_CONNECT_TIMEOUT_MS = 10000;
+const DEFAULT_CLOSE_TIMEOUT_MS = 2000;
+const DEFAULT_IO_TIMEOUT_MS = 30000;
+const CHUNK_SIZE = 8192; // 8KB chunks for industrial flow control
+class Network extends adapter_1.Adapter {
+    constructor() {
+        super(...arguments);
+        this.socket = null;
+        this.options = null;
+    }
+    async connect(hostOrOptions, portOrNothing, options) {
+        return this.synchronized(async () => {
+            const previous = this.options;
+            if (typeof hostOrOptions === 'object' && hostOrOptions !== null && 'host' in hostOrOptions) {
+                this.options = {
+                    host: hostOrOptions.host,
+                    port: hostOrOptions.port,
+                    timeout: hostOrOptions.timeout ?? DEFAULT_CONNECT_TIMEOUT_MS,
+                };
+            }
+            else {
+                this.options = {
+                    host: hostOrOptions,
+                    port: portOrNothing ?? 9100,
+                    timeout: options?.timeout ?? DEFAULT_CONNECT_TIMEOUT_MS,
+                };
+            }
+            if (this.socket && !this.socket.destroyed && previous && (previous.host !== this.options.host || previous.port !== this.options.port)) {
+                await this.close();
+            }
+            this.state = 'CONNECTED';
+            debug('Network adapter configured for %s:%d', this.options.host, this.options.port);
+            return true;
+        });
+    }
+    async open() {
+        return this.synchronized(async () => {
+            if (!this.options)
+                throw new Error(NOT_CONNECTED_MSG);
+            if (this.socket && !this.socket.destroyed)
+                return true;
+            this.state = 'OPENING';
+            return new Promise((resolve, reject) => {
+                let settled = false;
+                const { host, port, timeout } = this.options;
+                const socket = net.createConnection({ host, port }, () => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    socket.setTimeout(0);
+                    socket.removeAllListeners('error');
+                    socket.removeAllListeners('timeout');
+                    this.socket = socket;
+                    this.state = 'READY';
+                    debug('Connected to %s:%d', host, port);
+                    this.emit('connect', socket);
+                    resolve(true);
+                });
+                socket.setTimeout(timeout ?? DEFAULT_CONNECT_TIMEOUT_MS);
+                socket.on('timeout', () => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    this.state = 'DISCONNECTED';
+                    socket.destroy();
+                    reject(new Error('Connection timeout'));
+                });
+                socket.on('error', (err) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    this.state = 'DISCONNECTED';
+                    socket.destroy();
+                    debug('Socket error: %s', err.message);
+                    reject(err);
+                });
+                socket.on('close', () => {
+                    if (this.socket === socket) {
+                        this.socket = null;
+                        this.state = 'DISCONNECTED';
+                        this.emit('close');
+                        this.emit('disconnect');
+                    }
+                });
+            });
+        });
+    }
+    async write(data) {
+        return this.synchronized(async () => {
+            if (!this.socket || this.socket.destroyed)
+                throw new Error(NOT_CONNECTED_MSG);
+            const prevState = this.state;
+            this.state = 'BUSY';
+            try {
+                // Industrial Chunking Implementation
+                for (let i = 0; i < data.length; i += CHUNK_SIZE) {
+                    const chunk = data.subarray(i, i + CHUNK_SIZE);
+                    await this.writeChunk(chunk);
+                }
+                return true;
+            }
+            finally {
+                this.state = prevState === 'BUSY' ? 'READY' : prevState;
+            }
+        });
+    }
+    writeChunk(chunk) {
+        return new Promise((resolve, reject) => {
+            const socket = this.socket;
+            let settled = false;
+            const fail = (err) => {
+                if (settled)
+                    return;
+                settled = true;
+                socket.removeListener('error', onError);
+                socket.removeListener('drain', onDrain);
+                reject(err);
+            };
+            const onError = (err) => fail(err);
+            const onDrain = () => {
+                if (settled)
+                    return;
+                settled = true;
+                socket.removeListener('error', onError);
+                resolve();
+            };
+            const drainTimeout = setTimeout(() => {
+                fail(new Error('Write timeout: socket drain event never fired.'));
+            }, DEFAULT_IO_TIMEOUT_MS);
+            if (drainTimeout.unref)
+                drainTimeout.unref();
+            let success = true;
+            const needsDrain = !socket.write(chunk, (err) => {
+                if (err) {
+                    clearTimeout(drainTimeout);
+                    return fail(err);
+                }
+                if (success) {
+                    if (settled)
+                        return;
+                    settled = true;
+                    clearTimeout(drainTimeout);
+                    socket.removeListener('error', onError);
+                    resolve();
+                }
+            });
+            success = !needsDrain;
+            if (needsDrain) {
+                socket.once('drain', onDrain);
+                socket.once('error', onError);
+            }
+            else {
+                socket.once('error', onError);
+            }
+        });
+    }
+    async read() {
+        return this.synchronized(async () => {
+            if (!this.socket || this.socket.destroyed)
+                throw new Error(NOT_CONNECTED_MSG);
+            return new Promise((resolve, reject) => {
+                const socket = this.socket;
+                let settled = false;
+                const done = (err, data) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    clearTimeout(timer);
+                    socket.removeListener('data', onData);
+                    socket.removeListener('error', onError);
+                    socket.removeListener('close', onClose);
+                    if (err)
+                        reject(err);
+                    else
+                        resolve(data);
+                };
+                const onData = (data) => done(undefined, data);
+                const onError = (err) => done(err);
+                const onClose = () => done(new Error('Socket closed while waiting for data.'));
+                const timer = setTimeout(() => done(new Error('Read timeout')), DEFAULT_IO_TIMEOUT_MS);
+                if (timer.unref)
+                    timer.unref();
+                socket.once('data', onData);
+                socket.once('error', onError);
+                socket.once('close', onClose);
+            });
+        });
+    }
+    async close(options) {
+        return this.synchronized(async () => {
+            if (!this.socket)
+                return true;
+            this.state = 'CLOSING';
+            const socket = this.socket;
+            this.socket = null;
+            const timeoutMs = Math.max(0, options?.timeout ?? DEFAULT_CLOSE_TIMEOUT_MS);
+            return new Promise((resolve) => {
+                let completed = false;
+                const done = () => {
+                    if (completed)
+                        return;
+                    completed = true;
+                    socket.removeAllListeners();
+                    this.state = 'DISCONNECTED';
+                    this.emit('close');
+                    resolve(true);
+                };
+                socket.once('close', done);
+                socket.once('error', () => done());
+                socket.end();
+                const t = setTimeout(() => { if (!socket.destroyed)
+                    socket.destroy(); done(); }, timeoutMs);
+                if (t.unref)
+                    t.unref();
+            });
+        });
+    }
+    async disconnect(options) {
+        return this.close(options);
+    }
+}
+exports.Network = Network;
+//# sourceMappingURL=index.js.map

package/dist/network-adapter/index.js.map

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

package/dist/printer/commands-types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Strong types for the ESC/POS command set.
+ * Used by Printer to avoid weak casts (as unknown as Record<string, Buffer>).
+ */
+import type { commands } from './commands';
+/** Command set shape (inferred from commands). */
+export type CommandSet = typeof commands;
+export declare const FEED_CONTROL_KEYS: readonly ["CTL_LF", "CTL_GLF", "CTL_FF", "CTL_CR", "CTL_HT", "CTL_VT"];
+export type FeedControlKey = (typeof FEED_CONTROL_KEYS)[number];
+export declare const ALIGN_KEYS: readonly ["TXT_ALIGN_LT", "TXT_ALIGN_CT", "TXT_ALIGN_RT"];
+export type AlignKey = (typeof ALIGN_KEYS)[number];
+export declare const FONT_KEYS: readonly ["TXT_FONT_A", "TXT_FONT_B", "TXT_FONT_C"];
+export type FontKey = (typeof FONT_KEYS)[number];
+export declare const HARDWARE_KEYS: readonly ["HW_INIT", "HW_SELECT", "HW_RESET"];
+export type HardwareKey = (typeof HARDWARE_KEYS)[number];
+export declare const BITMAP_DENSITY_KEYS: readonly ["BITMAP_S8", "BITMAP_D8", "BITMAP_S24", "BITMAP_D24"];
+export type BitmapDensityKey = (typeof BITMAP_DENSITY_KEYS)[number];
+export declare const GSV0_MODE_KEYS: readonly ["GSV0_NORMAL", "GSV0_DW", "GSV0_DH", "GSV0_DWDH"];
+export type Gsv0ModeKey = (typeof GSV0_MODE_KEYS)[number];
+export declare const CASH_DRAWER_KEYS: readonly ["CD_KICK_2", "CD_KICK_5"];
+export type CashDrawerKey = (typeof CASH_DRAWER_KEYS)[number];
+export type BarcodeWidthIndex = 1 | 2 | 3 | 4 | 5;
+/** Narrow FEED_CONTROL_SEQUENCES key from string. Returns undefined if invalid. */
+export declare function getFeedControlKey(ctrl: string): FeedControlKey | undefined;
+/** Narrow TEXT_FORMAT alignment key from string. */
+export declare function getAlignKey(align: string): AlignKey | undefined;
+/** Narrow TEXT_FORMAT font key from string. */
+export declare function getFontKey(family: string): FontKey | undefined;
+/** Narrow HARDWARE key from string. */
+export declare function getHardwareKey(hw: string): HardwareKey | undefined;
+/** Narrow BITMAP_FORMAT key from density string. */
+export declare function getBitmapDensityKey(density: string): BitmapDensityKey | undefined;
+/** Narrow GSV0_FORMAT key from mode string. */
+export declare function getGsv0ModeKey(mode: string): Gsv0ModeKey | undefined;
+/** Cash drawer key from pin. */
+export declare function getCashDrawerKey(pin: 2 | 5): CashDrawerKey;
+//# sourceMappingURL=commands-types.d.ts.map

package/dist/printer/commands-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-types.d.ts","sourceRoot":"","sources":["../../src/printer/commands-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAAG,OAAO,QAAQ,CAAC;AAGzC,eAAO,MAAM,iBAAiB,wEAAyE,CAAC;AACxG,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAGhE,eAAO,MAAM,UAAU,2DAA4D,CAAC;AACpF,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAGnD,eAAO,MAAM,SAAS,qDAAsD,CAAC;AAC7E,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAGjD,eAAO,MAAM,aAAa,+CAAgD,CAAC;AAC3E,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAGzD,eAAO,MAAM,mBAAmB,iEAAkE,CAAC;AACnG,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAGpE,eAAO,MAAM,cAAc,6DAA8D,CAAC;AAC1F,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAG1D,eAAO,MAAM,gBAAgB,qCAAsC,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAG9D,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAElD,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAG1E;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAG/D;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAG9D;AAED,uCAAuC;AACvC,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGlE;AAED,oDAAoD;AACpD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAGjF;AAED,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGpE;AAED,gCAAgC;AAChC,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,aAAa,CAE1D"}

package/dist/printer/commands-types.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Strong types for the ESC/POS command set.
+ * Used by Printer to avoid weak casts (as unknown as Record<string, Buffer>).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CASH_DRAWER_KEYS = exports.GSV0_MODE_KEYS = exports.BITMAP_DENSITY_KEYS = exports.HARDWARE_KEYS = exports.FONT_KEYS = exports.ALIGN_KEYS = exports.FEED_CONTROL_KEYS = void 0;
+exports.getFeedControlKey = getFeedControlKey;
+exports.getAlignKey = getAlignKey;
+exports.getFontKey = getFontKey;
+exports.getHardwareKey = getHardwareKey;
+exports.getBitmapDensityKey = getBitmapDensityKey;
+exports.getGsv0ModeKey = getGsv0ModeKey;
+exports.getCashDrawerKey = getCashDrawerKey;
+// ─── Feed control sequences (control()) ─────────────────────────────────────
+exports.FEED_CONTROL_KEYS = ['CTL_LF', 'CTL_GLF', 'CTL_FF', 'CTL_CR', 'CTL_HT', 'CTL_VT'];
+// ─── Text format – alignment (align()) ──────────────────────────────────────
+exports.ALIGN_KEYS = ['TXT_ALIGN_LT', 'TXT_ALIGN_CT', 'TXT_ALIGN_RT'];
+// ─── Text format – font (font()) ───────────────────────────────────────────
+exports.FONT_KEYS = ['TXT_FONT_A', 'TXT_FONT_B', 'TXT_FONT_C'];
+// ─── Hardware (hardware()) ─────────────────────────────────────────────────
+exports.HARDWARE_KEYS = ['HW_INIT', 'HW_SELECT', 'HW_RESET'];
+// ─── Bitmap density (image()) ───────────────────────────────────────────────
+exports.BITMAP_DENSITY_KEYS = ['BITMAP_S8', 'BITMAP_D8', 'BITMAP_S24', 'BITMAP_D24'];
+// ─── Raster mode (raster()) ─────────────────────────────────────────────────
+exports.GSV0_MODE_KEYS = ['GSV0_NORMAL', 'GSV0_DW', 'GSV0_DH', 'GSV0_DWDH'];
+// ─── Cash drawer (cashdraw()) ──────────────────────────────────────────────
+exports.CASH_DRAWER_KEYS = ['CD_KICK_2', 'CD_KICK_5'];
+/** Narrow FEED_CONTROL_SEQUENCES key from string. Returns undefined if invalid. */
+function getFeedControlKey(ctrl) {
+    const key = 'CTL_' + ctrl.toUpperCase();
+    return exports.FEED_CONTROL_KEYS.includes(key) ? key : undefined;
+}
+/** Narrow TEXT_FORMAT alignment key from string. */
+function getAlignKey(align) {
+    const key = 'TXT_ALIGN_' + align.toUpperCase();
+    return exports.ALIGN_KEYS.includes(key) ? key : undefined;
+}
+/** Narrow TEXT_FORMAT font key from string. */
+function getFontKey(family) {
+    const key = 'TXT_FONT_' + family.toUpperCase();
+    return exports.FONT_KEYS.includes(key) ? key : undefined;
+}
+/** Narrow HARDWARE key from string. */
+function getHardwareKey(hw) {
+    const key = 'HW_' + hw.toUpperCase();
+    return exports.HARDWARE_KEYS.includes(key) ? key : undefined;
+}
+/** Narrow BITMAP_FORMAT key from density string. */
+function getBitmapDensityKey(density) {
+    const key = 'BITMAP_' + density.toUpperCase();
+    return exports.BITMAP_DENSITY_KEYS.includes(key) ? key : undefined;
+}
+/** Narrow GSV0_FORMAT key from mode string. */
+function getGsv0ModeKey(mode) {
+    const key = 'GSV0_' + mode.toUpperCase();
+    return exports.GSV0_MODE_KEYS.includes(key) ? key : undefined;
+}
+/** Cash drawer key from pin. */
+function getCashDrawerKey(pin) {
+    return pin === 2 ? 'CD_KICK_2' : 'CD_KICK_5';
+}
+//# sourceMappingURL=commands-types.js.map

package/dist/printer/commands-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-types.js","sourceRoot":"","sources":["../../src/printer/commands-types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAuCH,8CAGC;AAGD,kCAGC;AAGD,gCAGC;AAGD,wCAGC;AAGD,kDAGC;AAGD,wCAGC;AAGD,4CAEC;AAtED,+EAA+E;AAClE,QAAA,iBAAiB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAGxG,+EAA+E;AAClE,QAAA,UAAU,GAAG,CAAC,cAAc,EAAE,cAAc,EAAE,cAAc,CAAU,CAAC;AAGpF,8EAA8E;AACjE,QAAA,SAAS,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,CAAU,CAAC;AAG7E,8EAA8E;AACjE,QAAA,aAAa,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,CAAU,CAAC;AAG3E,+EAA+E;AAClE,QAAA,mBAAmB,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,CAAU,CAAC;AAGnG,+EAA+E;AAClE,QAAA,cAAc,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,CAAU,CAAC;AAG1F,8EAA8E;AACjE,QAAA,gBAAgB,GAAG,CAAC,WAAW,EAAE,WAAW,CAAU,CAAC;AAMpE,mFAAmF;AACnF,SAAgB,iBAAiB,CAAC,IAAY;IAC5C,MAAM,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACxC,OAAO,yBAAiB,CAAC,QAAQ,CAAC,GAAqB,CAAC,CAAC,CAAC,CAAE,GAAsB,CAAC,CAAC,CAAC,SAAS,CAAC;AACjG,CAAC;AAED,oDAAoD;AACpD,SAAgB,WAAW,CAAC,KAAa;IACvC,MAAM,GAAG,GAAG,YAAY,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC/C,OAAO,kBAAU,CAAC,QAAQ,CAAC,GAAe,CAAC,CAAC,CAAC,CAAE,GAAgB,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC;AAED,+CAA+C;AAC/C,SAAgB,UAAU,CAAC,MAAc;IACvC,MAAM,GAAG,GAAG,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAC/C,OAAO,iBAAS,CAAC,QAAQ,CAAC,GAAc,CAAC,CAAC,CAAC,CAAE,GAAe,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED,uCAAuC;AACvC,SAAgB,cAAc,CAAC,EAAU;IACvC,MAAM,GAAG,GAAG,KAAK,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,qBAAa,CAAC,QAAQ,CAAC,GAAkB,CAAC,CAAC,CAAC,CAAE,GAAmB,CAAC,CAAC,CAAC,SAAS,CAAC;AACvF,CAAC;AAED,oDAAoD;AACpD,SAAgB,mBAAmB,CAAC,OAAe;IACjD,MAAM,GAAG,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,2BAAmB,CAAC,QAAQ,CAAC,GAAuB,CAAC,CAAC,CAAC,CAAE,GAAwB,CAAC,CAAC,CAAC,SAAS,CAAC;AACvG,CAAC;AAED,+CAA+C;AAC/C,SAAgB,cAAc,CAAC,IAAY;IACzC,MAAM,GAAG,GAAG,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,sBAAc,CAAC,QAAQ,CAAC,GAAkB,CAAC,CAAC,CAAC,CAAE,GAAmB,CAAC,CAAC,CAAC,SAAS,CAAC;AACxF,CAAC;AAED,gCAAgC;AAChC,SAAgB,gBAAgB,CAAC,GAAU;IACzC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC;AAC/C,CAAC"}