@hibanacloud/core 0.3.15

package/dist/src/utils/quotaErrorDetection.js

@@ -0,0 +1,114 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export function isApiError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'error' in error &&
+        typeof error.error === 'object' &&
+        'message' in error.error);
+}
+export function isStructuredError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'message' in error &&
+        typeof error.message === 'string');
+}
+export function isProQuotaExceededError(error) {
+    // Check for Pro quota exceeded errors by looking for the specific pattern
+    // This will match patterns like:
+    // - "Quota exceeded for quota metric 'Gemini 2.5 Pro Requests'"
+    // - "Quota exceeded for quota metric 'Gemini 2.5-preview Pro Requests'"
+    // We use string methods instead of regex to avoid ReDoS vulnerabilities
+    const checkMessage = (message) => message.includes("Quota exceeded for quota metric 'Gemini") &&
+        message.includes("Pro Requests'");
+    if (typeof error === 'string') {
+        return checkMessage(error);
+    }
+    if (isStructuredError(error)) {
+        return checkMessage(error.message);
+    }
+    if (isApiError(error)) {
+        return checkMessage(error.error.message);
+    }
+    // Check if it's a Gaxios error with response data
+    if (error && typeof error === 'object' && 'response' in error) {
+        const gaxiosError = error;
+        if (gaxiosError.response && gaxiosError.response.data) {
+            if (typeof gaxiosError.response.data === 'string') {
+                return checkMessage(gaxiosError.response.data);
+            }
+            if (typeof gaxiosError.response.data === 'object' &&
+                gaxiosError.response.data !== null &&
+                'error' in gaxiosError.response.data) {
+                const errorData = gaxiosError.response.data;
+                return checkMessage(errorData.error?.message || '');
+            }
+        }
+    }
+    return false;
+}
+export function isGenericQuotaExceededError(error) {
+    if (typeof error === 'string') {
+        return error.includes('Quota exceeded for quota metric');
+    }
+    if (isStructuredError(error)) {
+        return error.message.includes('Quota exceeded for quota metric');
+    }
+    if (isApiError(error)) {
+        return error.error.message.includes('Quota exceeded for quota metric');
+    }
+    return false;
+}
+export function isQwenQuotaExceededError(error) {
+    // Check for Qwen insufficient quota errors (should not retry)
+    const checkMessage = (message) => {
+        const lowerMessage = message.toLowerCase();
+        return (lowerMessage.includes('insufficient_quota') ||
+            lowerMessage.includes('free allocated quota exceeded') ||
+            (lowerMessage.includes('quota') && lowerMessage.includes('exceeded')));
+    };
+    if (typeof error === 'string') {
+        return checkMessage(error);
+    }
+    if (isStructuredError(error)) {
+        return checkMessage(error.message);
+    }
+    if (isApiError(error)) {
+        return checkMessage(error.error.message);
+    }
+    return false;
+}
+export function isQwenThrottlingError(error) {
+    // Check for Qwen throttling errors (should retry)
+    const checkMessage = (message) => {
+        const lowerMessage = message.toLowerCase();
+        return (lowerMessage.includes('throttling') ||
+            lowerMessage.includes('requests throttling triggered') ||
+            lowerMessage.includes('rate limit') ||
+            lowerMessage.includes('too many requests'));
+    };
+    // Check status code
+    const getStatusCode = (error) => {
+        if (error && typeof error === 'object') {
+            const errorObj = error;
+            return errorObj.status || errorObj.code;
+        }
+        return undefined;
+    };
+    const statusCode = getStatusCode(error);
+    if (typeof error === 'string') {
+        return ((statusCode === 429 && checkMessage(error)) ||
+            error.includes('throttling'));
+    }
+    if (isStructuredError(error)) {
+        return statusCode === 429 && checkMessage(error.message);
+    }
+    if (isApiError(error)) {
+        return error.error.code === 429 && checkMessage(error.error.message);
+    }
+    return false;
+}
+//# sourceMappingURL=quotaErrorDetection.js.map

package/dist/src/utils/quotaErrorDetection.js.map

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

package/dist/src/utils/quotaErrorDetection.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/utils/quotaErrorDetection.test.js

@@ -0,0 +1,153 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { isQwenQuotaExceededError, isQwenThrottlingError, isProQuotaExceededError, isGenericQuotaExceededError, isApiError, isStructuredError, } from './quotaErrorDetection.js';
+describe('quotaErrorDetection', () => {
+    describe('isQwenQuotaExceededError', () => {
+        it('should detect insufficient_quota error message', () => {
+            const error = new Error('insufficient_quota');
+            expect(isQwenQuotaExceededError(error)).toBe(true);
+        });
+        it('should detect free allocated quota exceeded error message', () => {
+            const error = new Error('Free allocated quota exceeded.');
+            expect(isQwenQuotaExceededError(error)).toBe(true);
+        });
+        it('should detect quota exceeded error message', () => {
+            const error = new Error('quota exceeded');
+            expect(isQwenQuotaExceededError(error)).toBe(true);
+        });
+        it('should detect quota exceeded in string error', () => {
+            const error = 'insufficient_quota';
+            expect(isQwenQuotaExceededError(error)).toBe(true);
+        });
+        it('should detect quota exceeded in structured error', () => {
+            const error = { message: 'Free allocated quota exceeded.', status: 429 };
+            expect(isQwenQuotaExceededError(error)).toBe(true);
+        });
+        it('should detect quota exceeded in API error', () => {
+            const error = {
+                error: {
+                    code: 429,
+                    message: 'insufficient_quota',
+                    status: 'RESOURCE_EXHAUSTED',
+                    details: [],
+                },
+            };
+            expect(isQwenQuotaExceededError(error)).toBe(true);
+        });
+        it('should not detect throttling errors as quota exceeded', () => {
+            const error = new Error('requests throttling triggered');
+            expect(isQwenQuotaExceededError(error)).toBe(false);
+        });
+        it('should not detect unrelated errors', () => {
+            const error = new Error('Network error');
+            expect(isQwenQuotaExceededError(error)).toBe(false);
+        });
+    });
+    describe('isQwenThrottlingError', () => {
+        it('should detect throttling error with 429 status', () => {
+            const error = { message: 'throttling', status: 429 };
+            expect(isQwenThrottlingError(error)).toBe(true);
+        });
+        it('should detect requests throttling triggered with 429 status', () => {
+            const error = { message: 'requests throttling triggered', status: 429 };
+            expect(isQwenThrottlingError(error)).toBe(true);
+        });
+        it('should detect rate limit error with 429 status', () => {
+            const error = { message: 'rate limit exceeded', status: 429 };
+            expect(isQwenThrottlingError(error)).toBe(true);
+        });
+        it('should detect too many requests with 429 status', () => {
+            const error = { message: 'too many requests', status: 429 };
+            expect(isQwenThrottlingError(error)).toBe(true);
+        });
+        it('should detect throttling in string error', () => {
+            const error = 'throttling';
+            expect(isQwenThrottlingError(error)).toBe(true);
+        });
+        it('should detect throttling in structured error with 429', () => {
+            const error = { message: 'requests throttling triggered', status: 429 };
+            expect(isQwenThrottlingError(error)).toBe(true);
+        });
+        it('should detect throttling in API error with 429', () => {
+            const error = {
+                error: {
+                    code: 429,
+                    message: 'throttling',
+                    status: 'RESOURCE_EXHAUSTED',
+                    details: [],
+                },
+            };
+            expect(isQwenThrottlingError(error)).toBe(true);
+        });
+        it('should not detect throttling without 429 status in structured error', () => {
+            const error = { message: 'throttling', status: 500 };
+            expect(isQwenThrottlingError(error)).toBe(false);
+        });
+        it('should not detect quota exceeded as throttling', () => {
+            const error = { message: 'insufficient_quota', status: 429 };
+            expect(isQwenThrottlingError(error)).toBe(false);
+        });
+        it('should not detect unrelated errors as throttling', () => {
+            const error = { message: 'Network error', status: 500 };
+            expect(isQwenThrottlingError(error)).toBe(false);
+        });
+    });
+    describe('isProQuotaExceededError', () => {
+        it('should detect Gemini Pro quota exceeded error', () => {
+            const error = new Error("Quota exceeded for quota metric 'Gemini 2.5 Pro Requests'");
+            expect(isProQuotaExceededError(error)).toBe(true);
+        });
+        it('should detect Gemini preview Pro quota exceeded error', () => {
+            const error = new Error("Quota exceeded for quota metric 'Gemini 2.5-preview Pro Requests'");
+            expect(isProQuotaExceededError(error)).toBe(true);
+        });
+        it('should not detect non-Pro quota errors', () => {
+            const error = new Error("Quota exceeded for quota metric 'Gemini 1.5 Flash Requests'");
+            expect(isProQuotaExceededError(error)).toBe(false);
+        });
+    });
+    describe('isGenericQuotaExceededError', () => {
+        it('should detect generic quota exceeded error', () => {
+            const error = new Error('Quota exceeded for quota metric');
+            expect(isGenericQuotaExceededError(error)).toBe(true);
+        });
+        it('should not detect non-quota errors', () => {
+            const error = new Error('Network error');
+            expect(isGenericQuotaExceededError(error)).toBe(false);
+        });
+    });
+    describe('type guards', () => {
+        describe('isApiError', () => {
+            it('should detect valid API error', () => {
+                const error = {
+                    error: {
+                        code: 429,
+                        message: 'test error',
+                        status: 'RESOURCE_EXHAUSTED',
+                        details: [],
+                    },
+                };
+                expect(isApiError(error)).toBe(true);
+            });
+            it('should not detect invalid API error', () => {
+                const error = { message: 'test error' };
+                expect(isApiError(error)).toBe(false);
+            });
+        });
+        describe('isStructuredError', () => {
+            it('should detect valid structured error', () => {
+                const error = { message: 'test error', status: 429 };
+                expect(isStructuredError(error)).toBe(true);
+            });
+            it('should not detect invalid structured error', () => {
+                const error = { code: 429 };
+                expect(isStructuredError(error)).toBe(false);
+            });
+        });
+    });
+});
+//# sourceMappingURL=quotaErrorDetection.test.js.map

package/dist/src/utils/quotaErrorDetection.test.js.map

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

package/dist/src/utils/qwenIgnoreParser.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface HibanaIgnoreFilter {
+    isIgnored(filePath: string): boolean;
+    getPatterns(): string[];
+}
+export declare class HibanaIgnoreParser implements HibanaIgnoreFilter {
+    private projectRoot;
+    private patterns;
+    private ig;
+    constructor(projectRoot: string);
+    private loadPatterns;
+    isIgnored(filePath: string): boolean;
+    getPatterns(): string[];
+}

package/dist/src/utils/qwenIgnoreParser.js

@@ -0,0 +1,69 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import ignore from 'ignore';
+export class HibanaIgnoreParser {
+    projectRoot;
+    patterns = [];
+    ig = ignore();
+    constructor(projectRoot) {
+        this.projectRoot = path.resolve(projectRoot);
+        this.loadPatterns();
+    }
+    loadPatterns() {
+        // Try .hibanaignore first, then fallback to .qwenignore for backward compatibility
+        let patternsFilePath = path.join(this.projectRoot, '.hibanaignore');
+        let content;
+        try {
+            content = fs.readFileSync(patternsFilePath, 'utf-8');
+        }
+        catch (_error) {
+            // Fallback to .qwenignore for backward compatibility
+            try {
+                patternsFilePath = path.join(this.projectRoot, '.qwenignore');
+                content = fs.readFileSync(patternsFilePath, 'utf-8');
+            }
+            catch (_fallbackError) {
+                // ignore file not found
+                return;
+            }
+        }
+        this.patterns = (content ?? '')
+            .split('\n')
+            .map((p) => p.trim())
+            .filter((p) => p !== '' && !p.startsWith('#'));
+        this.ig.add(this.patterns);
+    }
+    isIgnored(filePath) {
+        if (this.patterns.length === 0) {
+            return false;
+        }
+        if (!filePath || typeof filePath !== 'string') {
+            return false;
+        }
+        if (filePath.startsWith('\\') ||
+            filePath === '/' ||
+            filePath.includes('\0')) {
+            return false;
+        }
+        const resolved = path.resolve(this.projectRoot, filePath);
+        const relativePath = path.relative(this.projectRoot, resolved);
+        if (relativePath === '' || relativePath.startsWith('..')) {
+            return false;
+        }
+        // Even in windows, Ignore expects forward slashes.
+        const normalizedPath = relativePath.replace(/\\/g, '/');
+        if (normalizedPath.startsWith('/') || normalizedPath === '') {
+            return false;
+        }
+        return this.ig.ignores(normalizedPath);
+    }
+    getPatterns() {
+        return this.patterns;
+    }
+}
+//# sourceMappingURL=qwenIgnoreParser.js.map

package/dist/src/utils/qwenIgnoreParser.js.map

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

package/dist/src/utils/qwenIgnoreParser.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/utils/qwenIgnoreParser.test.js

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi, describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { HibanaIgnoreParser } from './qwenIgnoreParser.js';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+describe('QwenIgnoreParser', () => {
+    let projectRoot;
+    async function createTestFile(filePath, content = '') {
+        const fullPath = path.join(projectRoot, filePath);
+        await fs.mkdir(path.dirname(fullPath), { recursive: true });
+        await fs.writeFile(fullPath, content);
+    }
+    beforeEach(async () => {
+        projectRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'qwenignore-test-'));
+    });
+    afterEach(async () => {
+        await fs.rm(projectRoot, { recursive: true, force: true });
+        vi.restoreAllMocks();
+    });
+    describe('when .qwenignore exists', () => {
+        beforeEach(async () => {
+            await createTestFile('.qwenignore', 'ignored.txt\n# A comment\n/ignored_dir/\n');
+            await createTestFile('ignored.txt', 'ignored');
+            await createTestFile('not_ignored.txt', 'not ignored');
+            await createTestFile(path.join('ignored_dir', 'file.txt'), 'in ignored dir');
+            await createTestFile(path.join('subdir', 'not_ignored.txt'), 'not ignored');
+        });
+        it('should ignore files specified in .qwenignore', () => {
+            const parser = new HibanaIgnoreParser(projectRoot);
+            expect(parser.getPatterns()).toEqual(['ignored.txt', '/ignored_dir/']);
+            expect(parser.isIgnored('ignored.txt')).toBe(true);
+            expect(parser.isIgnored('not_ignored.txt')).toBe(false);
+            expect(parser.isIgnored(path.join('ignored_dir', 'file.txt'))).toBe(true);
+            expect(parser.isIgnored(path.join('subdir', 'not_ignored.txt'))).toBe(false);
+        });
+    });
+    describe('when .qwenignore does not exist', () => {
+        it('should not load any patterns and not ignore any files', () => {
+            const parser = new HibanaIgnoreParser(projectRoot);
+            expect(parser.getPatterns()).toEqual([]);
+            expect(parser.isIgnored('any_file.txt')).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=qwenIgnoreParser.test.js.map

package/dist/src/utils/qwenIgnoreParser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwenIgnoreParser.test.js","sourceRoot":"","sources":["../../../src/utils/qwenIgnoreParser.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,IAAI,WAAmB,CAAC;IAExB,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,OAAO,GAAG,EAAE;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAClD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,WAAW,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,UAAU,CAAC,KAAK,IAAI,EAAE;YACpB,MAAM,cAAc,CAClB,aAAa,EACb,2CAA2C,CAC5C,CAAC;YACF,MAAM,cAAc,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;YAC/C,MAAM,cAAc,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;YACvD,MAAM,cAAc,CAClB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,EACpC,gBAAgB,CACjB,CAAC;YACF,MAAM,cAAc,CAClB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,EACtC,aAAa,CACd,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC,CAAC;YACvE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1E,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CACnE,KAAK,CACN,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC/C,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAC/D,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACzC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/utils/request-tokenizer/imageTokenizer.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ImageMetadata } from './types.js';
+/**
+ * Image tokenizer for calculating image tokens based on dimensions
+ *
+ * Key rules:
+ * - 28x28 pixels = 1 token
+ * - Minimum: 4 tokens per image
+ * - Maximum: 16384 tokens per image
+ * - Additional: 2 special tokens (vision_bos + vision_eos)
+ * - Supports: PNG, JPEG, WebP, GIF, BMP, TIFF, HEIC formats
+ */
+export declare class ImageTokenizer {
+    /** 28x28 pixels = 1 token */
+    private static readonly PIXELS_PER_TOKEN;
+    /** Minimum tokens per image */
+    private static readonly MIN_TOKENS_PER_IMAGE;
+    /** Maximum tokens per image */
+    private static readonly MAX_TOKENS_PER_IMAGE;
+    /** Special tokens for vision markers */
+    private static readonly VISION_SPECIAL_TOKENS;
+    /**
+     * Extract image metadata from base64 data
+     *
+     * @param base64Data Base64-encoded image data (with or without data URL prefix)
+     * @param mimeType MIME type of the image
+     * @returns Promise resolving to ImageMetadata with dimensions and format info
+     */
+    extractImageMetadata(base64Data: string, mimeType: string): Promise<ImageMetadata>;
+    /**
+     * Extract image dimensions from buffer based on format
+     *
+     * @param buffer Binary image data buffer
+     * @param mimeType MIME type to determine parsing strategy
+     * @returns Promise resolving to width and height dimensions
+     */
+    private extractDimensions;
+    /**
+     * Extract PNG dimensions from IHDR chunk
+     * PNG signature: 89 50 4E 47 0D 0A 1A 0A
+     * Width/height at bytes 16-19 and 20-23 (big-endian)
+     */
+    private extractPngDimensions;
+    /**
+     * Extract JPEG dimensions from SOF (Start of Frame) markers
+     * JPEG starts with FF D8, SOF markers: 0xC0-0xC3, 0xC5-0xC7, 0xC9-0xCB, 0xCD-0xCF
+     * Dimensions at offset +5 (height) and +7 (width) from SOF marker
+     */
+    private extractJpegDimensions;
+    /**
+     * Extract WebP dimensions from RIFF container
+     * Supports VP8, VP8L, and VP8X formats
+     */
+    private extractWebpDimensions;
+    /**
+     * Extract GIF dimensions from header
+     * Supports GIF87a and GIF89a formats
+     */
+    private extractGifDimensions;
+    /**
+     * Calculate tokens for an image based on its metadata
+     *
+     * @param metadata Image metadata containing width, height, and format info
+     * @returns Total token count including base image tokens and special tokens
+     */
+    calculateTokens(metadata: ImageMetadata): number;
+    /**
+     * Calculate tokens with scaling logic
+     *
+     * Steps:
+     * 1. Normalize to 28-pixel multiples
+     * 2. Scale large images down, small images up
+     * 3. Calculate tokens: pixels / 784 + 2 special tokens
+     *
+     * @param width Original image width in pixels
+     * @param height Original image height in pixels
+     * @returns Total token count for the image
+     */
+    private calculateTokensWithScaling;
+    /**
+     * Calculate tokens for multiple images serially
+     *
+     * @param base64DataArray Array of image data with MIME type information
+     * @returns Promise resolving to array of token counts in same order as input
+     */
+    calculateTokensBatch(base64DataArray: Array<{
+        data: string;
+        mimeType: string;
+    }>): Promise<number[]>;
+    /**
+     * Extract BMP dimensions from header
+     * BMP signature: 42 4D (BM)
+     * Width/height at bytes 18-21 and 22-25 (little-endian)
+     */
+    private extractBmpDimensions;
+    /**
+     * Extract TIFF dimensions from IFD (Image File Directory)
+     * TIFF can be little-endian (II) or big-endian (MM)
+     * Width/height are stored in IFD entries with tags 0x0100 and 0x0101
+     */
+    private extractTiffDimensions;
+    /**
+     * Extract HEIC dimensions from meta box
+     * HEIC is based on ISO Base Media File Format
+     * This is a simplified implementation that looks for 'ispe' (Image Spatial Extents) box
+     */
+    private extractHeicDimensions;
+}