memobirdsdk 1.0.0

package/dist/client.js

@@ -0,0 +1,250 @@
+import got, {} from 'got';
+import { RetryStrategy } from './utils/retry.js';
+import { formatTextContent, formatImageContent } from './utils/content-formatter.js';
+import { bindUser } from './api/bind.js';
+import { printPaper, printFromUrl, printFromHtml } from './api/print.js';
+import { getPrintStatus } from './api/status.js';
+import { convertToMonochrome } from './api/image.js';
+import { BASE_URL, DEFAULT_TIMEOUT, DEFAULT_RETRY_CONFIG } from './constants.js';
+/**
+ * Main Memobird SDK client for interacting with the Memobird API
+ *
+ * This class provides a convenient interface for all Memobird operations including
+ * user binding, printing text/images, checking print status, and converting images.
+ *
+ * @example
+ * ```typescript
+ * const client = new MemobirdClient({
+ *   ak: 'your-access-key-from-open.memobird.cn'
+ * });
+ *
+ * // Bind user to device
+ * const bindResult = await client.bindUser('device-id', 'user-123');
+ *
+ * // Print text (auto-converts to GBK)
+ * await client.printText('Hello World!', 'device-id', bindResult.showapi_userid!);
+ * ```
+ */
+export class MemobirdClient {
+    config;
+    httpClient;
+    retryStrategy;
+    /**
+     * Creates a new MemobirdClient instance
+     *
+     * @param config - SDK configuration options
+     * @param config.ak - Access Key from open.memobird.cn (required)
+     * @param config.baseUrl - Base URL for API (default: 'http://open.memobird.cn/home')
+     * @param config.timeout - Request timeout in ms (default: 30000)
+     * @param config.retry - Retry configuration
+     * @param config.httpOptions - Additional got HTTP client options
+     *
+     * @example
+     * ```typescript
+     * const client = new MemobirdClient({
+     *   ak: 'your-access-key',
+     *   timeout: 60000,
+     *   retry: {
+     *     maxRetries: 5,
+     *     initialDelay: 2000
+     *   }
+     * });
+     * ```
+     */
+    constructor(config) {
+        this.config = {
+            baseUrl: BASE_URL,
+            timeout: DEFAULT_TIMEOUT,
+            retry: DEFAULT_RETRY_CONFIG,
+            ...config,
+        };
+        // Initialize HTTP client with got
+        const timeout = this.config.timeout !== undefined ? this.config.timeout : DEFAULT_TIMEOUT;
+        const baseUrl = this.config.baseUrl !== undefined ? this.config.baseUrl : BASE_URL;
+        this.httpClient = got.extend({
+            prefixUrl: baseUrl,
+            timeout: {
+                request: timeout,
+            },
+            responseType: 'json',
+            throwHttpErrors: false, // Handle errors manually
+            retry: { limit: 0 }, // Use our custom retry logic
+            ...(this.config.httpOptions || {}),
+        });
+        // Initialize retry strategy
+        this.retryStrategy = new RetryStrategy(this.config.retry);
+    }
+    /**
+     * Binds a user identifier to a Memobird device
+     *
+     * This creates an association between your user ID and a physical device.
+     * The device ID can be obtained by double-clicking the physical device,
+     * which will print out the device ID.
+     *
+     * @param memobirdID - Device ID from the physical device
+     * @param useridentifying - Your unique user identifier
+     * @returns Promise resolving to binding response with showapi_userid
+     *
+     * @example
+     * ```typescript
+     * const response = await client.bindUser('fb93bfff504c020a', 'user-123');
+     * console.log('User ID:', response.showapi_userid);
+     * ```
+     */
+    async bindUser(memobirdID, useridentifying) {
+        return this.retryStrategy.execute(() => bindUser(this.httpClient, this.config.ak, memobirdID, useridentifying));
+    }
+    /**
+     * Prints text content to a Memobird device
+     *
+     * Text is automatically converted from UTF-8 to GBK Base64 encoding as required by the API.
+     * Supports Chinese characters and other multi-byte text.
+     *
+     * @param text - Text content to print
+     * @param memobirdID - Device ID
+     * @param userID - User ID from binding response
+     * @returns Promise resolving to print response with printcontentid
+     *
+     * @example
+     * ```typescript
+     * const response = await client.printText(
+     *   '你好世界！Hello World!',
+     *   'device-id',
+     *   123
+     * );
+     * console.log('Print ID:', response.printcontentid);
+     * ```
+     */
+    async printText(text, memobirdID, userID) {
+        const printcontent = formatTextContent(text);
+        return this.retryStrategy.execute(() => printPaper(this.httpClient, this.config.ak, printcontent, memobirdID, userID));
+    }
+    /**
+     * Prints image content to a Memobird device
+     *
+     * The image must be in monochrome bitmap format. Use {@link convertImageToMonochrome}
+     * to convert JPG/PNG images to the required format first.
+     *
+     * @param base64Image - Monochrome bitmap Base64 string
+     * @param memobirdID - Device ID
+     * @param userID - User ID from binding response
+     * @returns Promise resolving to print response
+     *
+     * @example
+     * ```typescript
+     * // First convert image
+     * const converted = await client.convertImageToMonochrome(jpgBase64);
+     *
+     * // Then print
+     * const response = await client.printImage(
+     *   converted.result!,
+     *   'device-id',
+     *   123
+     * );
+     * ```
+     */
+    async printImage(base64Image, memobirdID, userID) {
+        const printcontent = formatImageContent(base64Image);
+        return this.retryStrategy.execute(() => printPaper(this.httpClient, this.config.ak, printcontent, memobirdID, userID));
+    }
+    /**
+     * Prints content from a web URL
+     *
+     * Note: This works best with static or server-rendered pages. Pages rendered
+     * with AJAX may not work properly. Images must use complete URLs and CSS should
+     * be inline for best results.
+     *
+     * @param url - URL of the web page to print
+     * @param memobirdID - Device ID
+     * @param userID - User ID from binding response
+     * @returns Promise resolving to print response
+     *
+     * @example
+     * ```typescript
+     * const response = await client.printFromUrl(
+     *   'https://example.com/page',
+     *   'device-id',
+     *   123
+     * );
+     * ```
+     */
+    async printFromUrl(url, memobirdID, userID) {
+        return this.retryStrategy.execute(() => printFromUrl(this.httpClient, this.config.ak, url, memobirdID, userID));
+    }
+    /**
+     * Prints content from HTML source
+     *
+     * The HTML is automatically converted to GBK Base64 and URL encoded.
+     * For best results:
+     * - Use inline CSS (no external stylesheets)
+     * - Use complete URLs for images (not relative paths)
+     * - Keep content size reasonable
+     *
+     * @param html - HTML source code
+     * @param memobirdID - Device ID
+     * @param userID - User ID from binding response
+     * @returns Promise resolving to print response
+     *
+     * @example
+     * ```typescript
+   * const html = `
+     *   <html>
+     *     <body style="font-family: sans-serif;">
+     *       <h1>Hello World</h1>
+     *       <p>This is a test.</p>
+     *     </body>
+     *   </html>
+     * `;
+     * const response = await client.printFromHtml(html, 'device-id', 123);
+     * ```
+     */
+    async printFromHtml(html, memobirdID, userID) {
+        return this.retryStrategy.execute(() => printFromHtml(this.httpClient, this.config.ak, html, memobirdID, userID));
+    }
+    /**
+     * Gets the print status of a submitted print job
+     *
+     * @param printcontentid - Print content ID from print response (can be string or number)
+     * @returns Promise resolving to print status response
+     *
+     * @example
+     * ```typescript
+     * const printResponse = await client.printText('Hello', 'device-id', 123);
+     * const status = await client.getPrintStatus(printResponse.printcontentid!);
+     *
+     * if (status.printflag === 1) {
+     *   console.log('Print completed successfully');
+     * } else {
+     *   console.log('Print pending or failed');
+     * }
+     * ```
+     */
+    async getPrintStatus(printcontentid) {
+        const contentId = String(printcontentid);
+        return this.retryStrategy.execute(() => getPrintStatus(this.httpClient, this.config.ak, contentId));
+    }
+    /**
+     * Converts a JPG or PNG image to monochrome bitmap format
+     *
+     * The Memobird printer requires images in monochrome bitmap format.
+     * Use this method to convert standard images before printing.
+     * For best results, images should be 384px wide (the printer paper width).
+     *
+     * @param base64Image - JPG or PNG image as Base64 string
+     * @returns Promise resolving to converted image response with monochrome bitmap
+     *
+     * @example
+     * ```typescript
+     * const jpgBase64 = '...'; // Your JPG image
+     * const response = await client.convertImageToMonochrome(jpgBase64);
+     * const monochromeBase64 = response.result!;
+     *
+     * // Now print the converted image
+     * await client.printImage(monochromeBase64, 'device-id', 123);
+     * ```
+     */
+    async convertImageToMonochrome(base64Image) {
+        return this.retryStrategy.execute(() => convertToMonochrome(this.httpClient, this.config.ak, base64Image));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,18 @@
+import type { RetryConfig } from './types/index.js';
+/**
+ * Base URL for Memobird API
+ */
+export declare const BASE_URL = "http://open.memobird.cn/home";
+/**
+ * Default HTTP request timeout in milliseconds
+ */
+export declare const DEFAULT_TIMEOUT = 30000;
+/**
+ * Default retry configuration
+ */
+export declare const DEFAULT_RETRY_CONFIG: Required<RetryConfig>;
+/**
+ * API success code
+ */
+export declare const API_SUCCESS_CODE = 1;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,QAAQ,iCAAiC,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,WAAW,CAMtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC"}

package/dist/constants.js

@@ -0,0 +1,23 @@
+/**
+ * Base URL for Memobird API
+ */
+export const BASE_URL = 'http://open.memobird.cn/home';
+/**
+ * Default HTTP request timeout in milliseconds
+ */
+export const DEFAULT_TIMEOUT = 30000;
+/**
+ * Default retry configuration
+ */
+export const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialDelay: 1000,
+    backoffMultiplier: 2,
+    maxDelay: 10000,
+    retryStatusCodes: [408, 429, 500, 502, 503, 504],
+};
+/**
+ * API success code
+ */
+export const API_SUCCESS_CODE = 1;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,8BAA8B,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA0B;IACzD,UAAU,EAAE,CAAC;IACb,YAAY,EAAE,IAAI;IAClB,iBAAiB,EAAE,CAAC;IACpB,QAAQ,EAAE,KAAK;IACf,gBAAgB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;CACjD,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC"}

package/dist/errors/APIError.d.ts

@@ -0,0 +1,16 @@
+import { MemobirdError } from './MemobirdError.js';
+/**
+ * Error thrown when API returns a non-success response (showapi_res_code !== 1)
+ */
+export declare class APIError extends MemobirdError {
+    resCode: number;
+    resError: string;
+    /**
+     * Creates a new APIError
+     * @param message - Error message
+     * @param resCode - The showapi_res_code from API response
+     * @param resError - The showapi_res_error from API response
+     */
+    constructor(message: string, resCode: number, resError: string);
+}
+//# sourceMappingURL=APIError.d.ts.map

package/dist/errors/APIError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"APIError.d.ts","sourceRoot":"","sources":["../../src/errors/APIError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,qBAAa,QAAS,SAAQ,aAAa;IAShC,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,MAAM;IATzB;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACR,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM;CAK1B"}

package/dist/errors/APIError.js

@@ -0,0 +1,21 @@
+import { MemobirdError } from './MemobirdError.js';
+/**
+ * Error thrown when API returns a non-success response (showapi_res_code !== 1)
+ */
+export class APIError extends MemobirdError {
+    resCode;
+    resError;
+    /**
+     * Creates a new APIError
+     * @param message - Error message
+     * @param resCode - The showapi_res_code from API response
+     * @param resError - The showapi_res_error from API response
+     */
+    constructor(message, resCode, resError) {
+        super(message, 'API_ERROR');
+        this.resCode = resCode;
+        this.resError = resError;
+        this.name = 'APIError';
+    }
+}
+//# sourceMappingURL=APIError.js.map

package/dist/errors/APIError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"APIError.js","sourceRoot":"","sources":["../../src/errors/APIError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,aAAa;IAShC;IACA;IATT;;;;;OAKG;IACH,YACE,OAAe,EACR,OAAe,EACf,QAAgB;QAEvB,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAHrB,YAAO,GAAP,OAAO,CAAQ;QACf,aAAQ,GAAR,QAAQ,CAAQ;QAGvB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/errors/MemobirdError.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Base error class for all Memobird SDK errors
+ */
+export declare class MemobirdError extends Error {
+    code?: string | undefined;
+    /**
+     * Creates a new MemobirdError
+     * @param message - Error message
+     * @param code - Optional error code
+     */
+    constructor(message: string, code?: string | undefined);
+}
+//# sourceMappingURL=MemobirdError.d.ts.map

package/dist/errors/MemobirdError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemobirdError.d.ts","sourceRoot":"","sources":["../../src/errors/MemobirdError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAQ7B,IAAI,CAAC;IAPd;;;;OAIG;gBAED,OAAO,EAAE,MAAM,EACR,IAAI,CAAC,oBAAQ;CAMvB"}

package/dist/errors/MemobirdError.js

@@ -0,0 +1,18 @@
+/**
+ * Base error class for all Memobird SDK errors
+ */
+export class MemobirdError extends Error {
+    code;
+    /**
+     * Creates a new MemobirdError
+     * @param message - Error message
+     * @param code - Optional error code
+     */
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'MemobirdError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+//# sourceMappingURL=MemobirdError.js.map

package/dist/errors/MemobirdError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemobirdError.js","sourceRoot":"","sources":["../../src/errors/MemobirdError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAQ7B;IAPT;;;;OAIG;IACH,YACE,OAAe,EACR,IAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFR,SAAI,GAAJ,IAAI,CAAS;QAGpB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/errors/NetworkError.d.ts

@@ -0,0 +1,14 @@
+import { MemobirdError } from './MemobirdError.js';
+/**
+ * Error thrown when network request fails
+ */
+export declare class NetworkError extends MemobirdError {
+    originalError?: Error | undefined;
+    /**
+     * Creates a new NetworkError
+     * @param message - Error message
+     * @param originalError - The original error that caused this failure
+     */
+    constructor(message: string, originalError?: Error | undefined);
+}
+//# sourceMappingURL=NetworkError.d.ts.map

package/dist/errors/NetworkError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkError.d.ts","sourceRoot":"","sources":["../../src/errors/NetworkError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,qBAAa,YAAa,SAAQ,aAAa;IAQpC,aAAa,CAAC;IAPvB;;;;OAIG;gBAED,OAAO,EAAE,MAAM,EACR,aAAa,CAAC,mBAAO;CAK/B"}

package/dist/errors/NetworkError.js

@@ -0,0 +1,18 @@
+import { MemobirdError } from './MemobirdError.js';
+/**
+ * Error thrown when network request fails
+ */
+export class NetworkError extends MemobirdError {
+    originalError;
+    /**
+     * Creates a new NetworkError
+     * @param message - Error message
+     * @param originalError - The original error that caused this failure
+     */
+    constructor(message, originalError) {
+        super(message, 'NETWORK_ERROR');
+        this.originalError = originalError;
+        this.name = 'NetworkError';
+    }
+}
+//# sourceMappingURL=NetworkError.js.map

package/dist/errors/NetworkError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkError.js","sourceRoot":"","sources":["../../src/errors/NetworkError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,aAAa;IAQpC;IAPT;;;;OAIG;IACH,YACE,OAAe,EACR,aAAqB;QAE5B,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAFzB,kBAAa,GAAb,aAAa,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/errors/ValidationError.d.ts

@@ -0,0 +1,14 @@
+import { MemobirdError } from './MemobirdError.js';
+/**
+ * Error thrown when input validation fails
+ */
+export declare class ValidationError extends MemobirdError {
+    field?: string | undefined;
+    /**
+     * Creates a new ValidationError
+     * @param message - Error message
+     * @param field - The field that failed validation
+     */
+    constructor(message: string, field?: string | undefined);
+}
+//# sourceMappingURL=ValidationError.d.ts.map

package/dist/errors/ValidationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationError.d.ts","sourceRoot":"","sources":["../../src/errors/ValidationError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;IAQvC,KAAK,CAAC;IAPf;;;;OAIG;gBAED,OAAO,EAAE,MAAM,EACR,KAAK,CAAC,oBAAQ;CAKxB"}

package/dist/errors/ValidationError.js

@@ -0,0 +1,18 @@
+import { MemobirdError } from './MemobirdError.js';
+/**
+ * Error thrown when input validation fails
+ */
+export class ValidationError extends MemobirdError {
+    field;
+    /**
+     * Creates a new ValidationError
+     * @param message - Error message
+     * @param field - The field that failed validation
+     */
+    constructor(message, field) {
+        super(message, 'VALIDATION_ERROR');
+        this.field = field;
+        this.name = 'ValidationError';
+    }
+}
+//# sourceMappingURL=ValidationError.js.map

package/dist/errors/ValidationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationError.js","sourceRoot":"","sources":["../../src/errors/ValidationError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAQvC;IAPT;;;;OAIG;IACH,YACE,OAAe,EACR,KAAc;QAErB,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QAF5B,UAAK,GAAL,KAAK,CAAS;QAGrB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/errors/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Error classes for Memobird SDK
+ * @module errors
+ */
+export { MemobirdError } from './MemobirdError.js';
+export { APIError } from './APIError.js';
+export { NetworkError } from './NetworkError.js';
+export { ValidationError } from './ValidationError.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,9 @@
+/**
+ * Error classes for Memobird SDK
+ * @module errors
+ */
+export { MemobirdError } from './MemobirdError.js';
+export { APIError } from './APIError.js';
+export { NetworkError } from './NetworkError.js';
+export { ValidationError } from './ValidationError.js';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Memobird SDK - TypeScript SDK for Memobird (咕咕机) thermal printer API
+ *
+ * @example
+ * ```typescript
+ * import { MemobirdClient } from 'memobirdsdk';
+ *
+ * const client = new MemobirdClient({ ak: 'your-access-key' });
+ * const bindResult = await client.bindUser('device-id', 'user-123');
+ * await client.printText('Hello World!', 'device-id', bindResult.showapi_userid!);
+ * ```
+ *
+ * @module memobirdsdk
+ */
+export { MemobirdClient } from './client.js';
+export type * from './types/index.js';
+export { textToGBKBase64, gbkBase64ToText, generateTimestamp, isValidTimestamp, formatTextContent, formatImageContent, formatMixedContent, isValidBase64Image, stripDataUrlPrefix, imageFileToBase64, RetryStrategy, } from './utils/index.js';
+export { MemobirdError, APIError, NetworkError, ValidationError } from './errors/index.js';
+export { BASE_URL, DEFAULT_TIMEOUT, DEFAULT_RETRY_CONFIG, API_SUCCESS_CODE } from './constants.js';
+export { MemobirdClient as default } from './client.js';
+//# 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;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,mBAAmB,kBAAkB,CAAC;AAGtC,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAG3F,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGnG,OAAO,EAAE,cAAc,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * Memobird SDK - TypeScript SDK for Memobird (咕咕机) thermal printer API
+ *
+ * @example
+ * ```typescript
+ * import { MemobirdClient } from 'memobirdsdk';
+ *
+ * const client = new MemobirdClient({ ak: 'your-access-key' });
+ * const bindResult = await client.bindUser('device-id', 'user-123');
+ * await client.printText('Hello World!', 'device-id', bindResult.showapi_userid!);
+ * ```
+ *
+ * @module memobirdsdk
+ */
+// Main client
+export { MemobirdClient } from './client.js';
+// Utilities
+export { textToGBKBase64, gbkBase64ToText, generateTimestamp, isValidTimestamp, formatTextContent, formatImageContent, formatMixedContent, isValidBase64Image, stripDataUrlPrefix, imageFileToBase64, RetryStrategy, } from './utils/index.js';
+// Errors
+export { MemobirdError, APIError, NetworkError, ValidationError } from './errors/index.js';
+// Constants
+export { BASE_URL, DEFAULT_TIMEOUT, DEFAULT_RETRY_CONFIG, API_SUCCESS_CODE } from './constants.js';
+// Default export
+export { MemobirdClient as default } from './client.js';
+//# 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;;;;;;;;;;;;;GAaG;AAEH,cAAc;AACd,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK7C,YAAY;AACZ,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE3F,YAAY;AACZ,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEnG,iBAAiB;AACjB,OAAO,EAAE,cAAc,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC"}