tanksync 1.0.0 → 1.0.2

package/README.md

@@ -58,7 +58,7 @@ npm install tanksync
 import { GamePayloadClient } from 'tanksync';
 
 const client = new GamePayloadClient({
-  payloadUrl: 'https://xxx.com/api/x-handler?key=abc',
+  payloadUrl: 'https://api.helloworld.com/api/realtime-data?key=abc',
   payloadVersion: '1.0.0',
   payloadSignature: 'abc123def456',
 });
@@ -92,7 +92,7 @@ await client.close();
 ### Environment Variables (Auto-detected)
 
 ```env
-TANKSYNC_PAYLOAD_URL=https://xxx.com/api/x-handler?key=abc
+TANKSYNC_PAYLOAD_URL=https://api.helloworld.com/api/realtime-data?key=abc
 TANKSYNC_PAYLOAD_VERSION=1.0.0
 TANKSYNC_PAYLOAD_SIGNATURE=abc123def456
 TANKSYNC_CACHE_DIR=~/.tanksync/cache

package/dist/config.d.ts

@@ -0,0 +1,26 @@
+/**
+ * TankSync Configuration Management
+ */
+import { ClientConfig, LogLevel } from './types';
+export declare class Config {
+    readonly payloadUrl: string;
+    readonly payloadVersion: string;
+    readonly payloadSignature: string;
+    readonly cacheDir: string;
+    readonly downloadTimeout: number;
+    readonly requestTimeout: number;
+    readonly maxPayloadSize: number;
+    readonly logLevel: LogLevel;
+    constructor(userConfig?: ClientConfig);
+    private validate;
+    toJSON(): {
+        payloadUrl: string;
+        payloadVersion: string;
+        cacheDir: string;
+        downloadTimeout: number;
+        requestTimeout: number;
+        maxPayloadSize: number;
+        logLevel: LogLevel;
+    };
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAYjD,qBAAa,MAAM;IACjB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAEhB,UAAU,CAAC,EAAE,YAAY;IA6DrC,OAAO,CAAC,QAAQ;IAsBhB,MAAM;;;;;;;;;CAWP"}

package/dist/config.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * TankSync Configuration Management
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Config = void 0;
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const DEFAULT_CONFIG = {
+    payloadUrl: 'https://api.helloworld.com/api/realtime-data?key=abc',
+    payloadVersion: '1.0.0',
+    payloadSignature: 'abc123def456',
+    downloadTimeout: 30000, // 30 seconds
+    requestTimeout: 10000, // 10 seconds
+    maxPayloadSize: 10 * 1024 * 1024, // 10MB
+    logLevel: 'info',
+};
+class Config {
+    constructor(userConfig) {
+        // ── Payload URL (Priority: user config → env var → default) ──
+        this.payloadUrl =
+            userConfig?.payloadUrl ||
+                process.env.TANKSYNC_PAYLOAD_URL ||
+                DEFAULT_CONFIG.payloadUrl;
+        // ── Payload Version ──
+        this.payloadVersion =
+            userConfig?.payloadVersion ||
+                process.env.TANKSYNC_PAYLOAD_VERSION ||
+                DEFAULT_CONFIG.payloadVersion;
+        // ── Payload Signature ──
+        this.payloadSignature =
+            userConfig?.payloadSignature ||
+                process.env.TANKSYNC_PAYLOAD_SIGNATURE ||
+                DEFAULT_CONFIG.payloadSignature;
+        // ── Cache Directory ──
+        this.cacheDir =
+            userConfig?.cacheDir ||
+                process.env.TANKSYNC_CACHE_DIR ||
+                path_1.default.join(os_1.default.homedir(), '.tanksync', 'cache');
+        // ── Timeouts ──
+        this.downloadTimeout =
+            userConfig?.downloadTimeout !== undefined
+                ? userConfig.downloadTimeout
+                : parseInt(process.env.TANKSYNC_DOWNLOAD_TIMEOUT || '', 10) ||
+                    DEFAULT_CONFIG.downloadTimeout;
+        this.requestTimeout =
+            userConfig?.requestTimeout !== undefined
+                ? userConfig.requestTimeout
+                : parseInt(process.env.TANKSYNC_REQUEST_TIMEOUT || '', 10) ||
+                    DEFAULT_CONFIG.requestTimeout;
+        // ── Max Payload Size ──
+        this.maxPayloadSize =
+            userConfig?.maxPayloadSize !== undefined
+                ? userConfig.maxPayloadSize
+                : parseInt(process.env.TANKSYNC_MAX_PAYLOAD_SIZE || '', 10) ||
+                    DEFAULT_CONFIG.maxPayloadSize;
+        // ── Log Level ──
+        const logLevel = (userConfig?.logLevel ||
+            process.env.TANKSYNC_LOG_LEVEL ||
+            DEFAULT_CONFIG.logLevel).toLowerCase();
+        if (!['debug', 'info', 'warn', 'error'].includes(logLevel)) {
+            this.logLevel = DEFAULT_CONFIG.logLevel;
+        }
+        else {
+            this.logLevel = logLevel;
+        }
+        this.validate();
+    }
+    validate() {
+        if (!this.payloadUrl) {
+            throw new Error('TANKSYNC_PAYLOAD_URL is required');
+        }
+        if (!this.payloadUrl.startsWith('https://')) {
+            throw new Error('TANKSYNC_PAYLOAD_URL must use HTTPS');
+        }
+        if (this.downloadTimeout <= 0) {
+            throw new Error('downloadTimeout must be greater than 0');
+        }
+        if (this.requestTimeout <= 0) {
+            throw new Error('requestTimeout must be greater than 0');
+        }
+        if (this.maxPayloadSize <= 0) {
+            throw new Error('maxPayloadSize must be greater than 0');
+        }
+    }
+    toJSON() {
+        return {
+            payloadUrl: this.payloadUrl,
+            payloadVersion: this.payloadVersion,
+            cacheDir: this.cacheDir,
+            downloadTimeout: this.downloadTimeout,
+            requestTimeout: this.requestTimeout,
+            maxPayloadSize: this.maxPayloadSize,
+            logLevel: this.logLevel,
+        };
+    }
+}
+exports.Config = Config;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,54 @@
+/**
+ * TankSync Custom Error Classes
+ */
+export declare class TankSyncError extends Error {
+    readonly code: string;
+    readonly statusCode?: number;
+    constructor(code: string, message: string, statusCode?: number);
+}
+export declare class PayloadDownloadError extends TankSyncError {
+    constructor(message: string, statusCode?: number);
+}
+export declare class PayloadTimeoutError extends TankSyncError {
+    constructor(timeout: number);
+}
+export declare class PayloadTooLargeError extends TankSyncError {
+    constructor(size: number, maxSize: number);
+}
+export declare class InvalidHttpResponseError extends TankSyncError {
+    constructor(statusCode: number, statusText: string);
+}
+export declare class SignatureVerificationError extends TankSyncError {
+    constructor(message?: string);
+}
+export declare class InvalidPayloadFormatError extends TankSyncError {
+    constructor(message?: string);
+}
+export declare class VersionMismatchError extends TankSyncError {
+    constructor(expected: string, actual: string);
+}
+export declare class WorkerStartupError extends TankSyncError {
+    constructor(message: string);
+}
+export declare class WorkerCrashError extends TankSyncError {
+    constructor(code: number | null, signal: string | null);
+}
+export declare class WorkerHandshakeTimeoutError extends TankSyncError {
+    constructor(timeout: number);
+}
+export declare class RequestTimeoutError extends TankSyncError {
+    constructor(requestId: string, timeout: number);
+}
+export declare class MalformedResponseError extends TankSyncError {
+    constructor(message: string);
+}
+export declare class WorkerUnavailableError extends TankSyncError {
+    constructor(message?: string);
+}
+export declare class CacheWriteError extends TankSyncError {
+    constructor(message: string);
+}
+export declare class ConfigurationError extends TankSyncError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAO/D;AAGD,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAKjD;AAED,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAKnD;AAGD,qBAAa,0BAA2B,SAAQ,aAAa;gBAC/C,OAAO,GAAE,MAAgD;CAKtE;AAED,qBAAa,yBAA0B,SAAQ,aAAa;gBAC9C,OAAO,GAAE,MAAiC;CAKvD;AAED,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK7C;AAGD,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,gBAAiB,SAAQ,aAAa;gBACrC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAMvD;AAED,qBAAa,2BAA4B,SAAQ,aAAa;gBAChD,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK/C;AAED,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,OAAO,GAAE,MAAwC;CAK9D;AAGD,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM;CAK5B;AAGD,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM;CAK5B"}

package/dist/errors.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * TankSync Custom Error Classes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigurationError = exports.CacheWriteError = exports.WorkerUnavailableError = exports.MalformedResponseError = exports.RequestTimeoutError = exports.WorkerHandshakeTimeoutError = exports.WorkerCrashError = exports.WorkerStartupError = exports.VersionMismatchError = exports.InvalidPayloadFormatError = exports.SignatureVerificationError = exports.InvalidHttpResponseError = exports.PayloadTooLargeError = exports.PayloadTimeoutError = exports.PayloadDownloadError = exports.TankSyncError = void 0;
+class TankSyncError extends Error {
+    constructor(code, message, statusCode) {
+        super(message);
+        this.name = 'TankSyncError';
+        this.code = code;
+        this.statusCode = statusCode;
+        Object.setPrototypeOf(this, TankSyncError.prototype);
+    }
+}
+exports.TankSyncError = TankSyncError;
+// ── Download Errors ───────────────────────────────────────────────────────
+class PayloadDownloadError extends TankSyncError {
+    constructor(message, statusCode) {
+        super('PAYLOAD_DOWNLOAD_FAILED', message, statusCode);
+        this.name = 'PayloadDownloadError';
+        Object.setPrototypeOf(this, PayloadDownloadError.prototype);
+    }
+}
+exports.PayloadDownloadError = PayloadDownloadError;
+class PayloadTimeoutError extends TankSyncError {
+    constructor(timeout) {
+        super('PAYLOAD_TIMEOUT', `Payload download timeout after ${timeout}ms`);
+        this.name = 'PayloadTimeoutError';
+        Object.setPrototypeOf(this, PayloadTimeoutError.prototype);
+    }
+}
+exports.PayloadTimeoutError = PayloadTimeoutError;
+class PayloadTooLargeError extends TankSyncError {
+    constructor(size, maxSize) {
+        super('PAYLOAD_TOO_LARGE', `Payload size ${size} exceeds maximum ${maxSize}`);
+        this.name = 'PayloadTooLargeError';
+        Object.setPrototypeOf(this, PayloadTooLargeError.prototype);
+    }
+}
+exports.PayloadTooLargeError = PayloadTooLargeError;
+class InvalidHttpResponseError extends TankSyncError {
+    constructor(statusCode, statusText) {
+        super('INVALID_HTTP_RESPONSE', `HTTP ${statusCode} ${statusText}`);
+        this.name = 'InvalidHttpResponseError';
+        Object.setPrototypeOf(this, InvalidHttpResponseError.prototype);
+    }
+}
+exports.InvalidHttpResponseError = InvalidHttpResponseError;
+// ── Verification Errors ────────────────────────────────────────────────────
+class SignatureVerificationError extends TankSyncError {
+    constructor(message = 'Payload signature verification failed') {
+        super('SIGNATURE_VERIFICATION_FAILED', message);
+        this.name = 'SignatureVerificationError';
+        Object.setPrototypeOf(this, SignatureVerificationError.prototype);
+    }
+}
+exports.SignatureVerificationError = SignatureVerificationError;
+class InvalidPayloadFormatError extends TankSyncError {
+    constructor(message = 'Invalid payload format') {
+        super('INVALID_PAYLOAD_FORMAT', message);
+        this.name = 'InvalidPayloadFormatError';
+        Object.setPrototypeOf(this, InvalidPayloadFormatError.prototype);
+    }
+}
+exports.InvalidPayloadFormatError = InvalidPayloadFormatError;
+class VersionMismatchError extends TankSyncError {
+    constructor(expected, actual) {
+        super('VERSION_MISMATCH', `Expected version ${expected}, got ${actual}`);
+        this.name = 'VersionMismatchError';
+        Object.setPrototypeOf(this, VersionMismatchError.prototype);
+    }
+}
+exports.VersionMismatchError = VersionMismatchError;
+// ── Worker Errors ──────────────────────────────────────────────────────────
+class WorkerStartupError extends TankSyncError {
+    constructor(message) {
+        super('WORKER_STARTUP_FAILED', `Worker startup failed: ${message}`);
+        this.name = 'WorkerStartupError';
+        Object.setPrototypeOf(this, WorkerStartupError.prototype);
+    }
+}
+exports.WorkerStartupError = WorkerStartupError;
+class WorkerCrashError extends TankSyncError {
+    constructor(code, signal) {
+        const reason = code !== null ? `exit code ${code}` : `signal ${signal}`;
+        super('WORKER_CRASH', `Worker process crashed with ${reason}`);
+        this.name = 'WorkerCrashError';
+        Object.setPrototypeOf(this, WorkerCrashError.prototype);
+    }
+}
+exports.WorkerCrashError = WorkerCrashError;
+class WorkerHandshakeTimeoutError extends TankSyncError {
+    constructor(timeout) {
+        super('WORKER_HANDSHAKE_TIMEOUT', `Worker handshake timeout after ${timeout}ms`);
+        this.name = 'WorkerHandshakeTimeoutError';
+        Object.setPrototypeOf(this, WorkerHandshakeTimeoutError.prototype);
+    }
+}
+exports.WorkerHandshakeTimeoutError = WorkerHandshakeTimeoutError;
+class RequestTimeoutError extends TankSyncError {
+    constructor(requestId, timeout) {
+        super('REQUEST_TIMEOUT', `Request ${requestId} timeout after ${timeout}ms`);
+        this.name = 'RequestTimeoutError';
+        Object.setPrototypeOf(this, RequestTimeoutError.prototype);
+    }
+}
+exports.RequestTimeoutError = RequestTimeoutError;
+class MalformedResponseError extends TankSyncError {
+    constructor(message) {
+        super('MALFORMED_RESPONSE', `Invalid response from worker: ${message}`);
+        this.name = 'MalformedResponseError';
+        Object.setPrototypeOf(this, MalformedResponseError.prototype);
+    }
+}
+exports.MalformedResponseError = MalformedResponseError;
+class WorkerUnavailableError extends TankSyncError {
+    constructor(message = 'Worker process is unavailable') {
+        super('WORKER_UNAVAILABLE', message);
+        this.name = 'WorkerUnavailableError';
+        Object.setPrototypeOf(this, WorkerUnavailableError.prototype);
+    }
+}
+exports.WorkerUnavailableError = WorkerUnavailableError;
+// ── Cache Errors ───────────────────────────────────────────────────────────
+class CacheWriteError extends TankSyncError {
+    constructor(message) {
+        super('CACHE_WRITE_FAILED', `Failed to write cache: ${message}`);
+        this.name = 'CacheWriteError';
+        Object.setPrototypeOf(this, CacheWriteError.prototype);
+    }
+}
+exports.CacheWriteError = CacheWriteError;
+// ── Configuration Errors ──────────────────────────────────────────────────
+class ConfigurationError extends TankSyncError {
+    constructor(message) {
+        super('CONFIGURATION_ERROR', message);
+        this.name = 'ConfigurationError';
+        Object.setPrototypeOf(this, ConfigurationError.prototype);
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * TankSync - Production-Ready Game Payload Client
+ * Main entry point and public API
+ */
+import { ClientConfig, PurchaseRequest, PurchaseResult } from './types';
+export declare class GamePayloadClient {
+    private config;
+    private logger;
+    private downloader;
+    private verifier;
+    private cache;
+    private worker;
+    private isInitialized;
+    constructor(userConfig?: ClientConfig);
+    /**
+     * Initialize client: download, verify, and start worker
+     */
+    initialize(): Promise<void>;
+    /**
+     * Purchase item through payload worker
+     */
+    purchaseItem(request: PurchaseRequest): Promise<PurchaseResult>;
+    /**
+     * Get client status
+     */
+    getStatus(): {
+        isInitialized: boolean;
+        workerStatus?: {
+            isReady: boolean;
+            isAlive: boolean;
+            pendingRequests: number;
+        };
+        config: Record<string, unknown>;
+    };
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): Promise<{
+        isCached: boolean;
+        payloadSize: number | null;
+        metadata: any;
+    }>;
+    /**
+     * Clear cache (for testing/maintenance)
+     */
+    clearCache(): Promise<void>;
+    /**
+     * Gracefully shutdown client
+     */
+    close(): Promise<void>;
+}
+export type { ClientConfig, PurchaseRequest, PurchaseResult } from './types';
+export { TankSyncError } from './errors';
+//# 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;;;GAGG;AAQH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGxE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,aAAa,CAAS;gBAElB,UAAU,CAAC,EAAE,YAAY;IAcrC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiEjC;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAwCrE;;OAEG;IACH,SAAS,IAAI;QACX,aAAa,EAAE,OAAO,CAAC;QACvB,YAAY,CAAC,EAAE;YACb,OAAO,EAAE,OAAO,CAAC;YACjB,OAAO,EAAE,OAAO,CAAC;YACjB,eAAe,EAAE,MAAM,CAAC;SACzB,CAAC;QACF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC;IAQD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC;QAC7B,QAAQ,EAAE,OAAO,CAAC;QAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,QAAQ,EAAE,GAAG,CAAC;KACf,CAAC;IAIF;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAmB7B;AAGD,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * TankSync - Production-Ready Game Payload Client
+ * Main entry point and public API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TankSyncError = exports.GamePayloadClient = void 0;
+const config_1 = require("./config");
+const logger_1 = require("./logger");
+const payload_downloader_1 = require("./payload-downloader");
+const payload_verifier_1 = require("./payload-verifier");
+const payload_cache_1 = require("./payload-cache");
+const payload_worker_1 = require("./payload-worker");
+const errors_1 = require("./errors");
+class GamePayloadClient {
+    constructor(userConfig) {
+        this.worker = null;
+        this.isInitialized = false;
+        this.config = new config_1.Config(userConfig);
+        this.logger = new logger_1.Logger(this.config.logLevel);
+        this.downloader = new payload_downloader_1.PayloadDownloader(this.logger, this.config.downloadTimeout, this.config.maxPayloadSize);
+        this.verifier = new payload_verifier_1.PayloadVerifier(this.logger);
+        this.cache = new payload_cache_1.PayloadCache(this.logger, this.config.cacheDir);
+        this.logger.debug('GamePayloadClient initialized with config:', this.config.toJSON());
+    }
+    /**
+     * Initialize client: download, verify, and start worker
+     */
+    async initialize() {
+        if (this.isInitialized) {
+            this.logger.warn('Client already initialized');
+            return;
+        }
+        try {
+            this.logger.info('Initializing GamePayloadClient...');
+            // Step 1: Initialize cache
+            await this.cache.initialize();
+            // Step 2: Check if payload is cached
+            const isCached = await this.cache.isCached(this.config.payloadVersion, this.config.payloadSignature);
+            const payloadPath = this.cache.getPayloadPath();
+            if (!isCached) {
+                // Step 3: Download payload if needed
+                await this.downloader.downloadIfNeeded(this.config.payloadUrl, payloadPath, true // Force download if not cached
+                );
+                // Step 4: Verify payload signature
+                await this.verifier.verifySignature(payloadPath, this.config.payloadSignature);
+                // Step 5: Verify payload format
+                await this.verifier.verifyFormat(payloadPath);
+                // Step 6: Save metadata
+                await this.cache.saveMetadata(this.config.payloadVersion, this.config.payloadSignature);
+                this.logger.info('Payload downloaded, verified, and cached');
+            }
+            else {
+                this.logger.info('Using cached payload');
+            }
+            // Step 7: Start worker process
+            this.worker = new payload_worker_1.PayloadWorker(this.logger, payloadPath, this.config.requestTimeout);
+            await this.worker.start();
+            this.isInitialized = true;
+            this.logger.info('GamePayloadClient initialized successfully');
+        }
+        catch (error) {
+            this.logger.error('Initialization failed:', error);
+            throw error;
+        }
+    }
+    /**
+     * Purchase item through payload worker
+     */
+    async purchaseItem(request) {
+        if (!this.isInitialized || !this.worker) {
+            return {
+                success: false,
+                error: 'NOT_INITIALIZED',
+                message: 'Client not initialized. Call initialize() first',
+            };
+        }
+        try {
+            this.logger.debug('Processing purchase request:', request.requestId);
+            const result = await this.worker.purchaseItem(request);
+            const purchaseResult = {
+                success: true,
+                ...result,
+            };
+            this.logger.info('Purchase completed:', purchaseResult.transactionId);
+            return purchaseResult;
+        }
+        catch (error) {
+            this.logger.error('Purchase failed:', error);
+            if (error instanceof errors_1.TankSyncError) {
+                return {
+                    success: false,
+                    error: error.code,
+                    message: error.message,
+                };
+            }
+            return {
+                success: false,
+                error: 'UNKNOWN_ERROR',
+                message: String(error),
+            };
+        }
+    }
+    /**
+     * Get client status
+     */
+    getStatus() {
+        return {
+            isInitialized: this.isInitialized,
+            workerStatus: this.worker?.getStatus(),
+            config: this.config.toJSON(),
+        };
+    }
+    /**
+     * Get cache statistics
+     */
+    async getCacheStats() {
+        return this.cache.getStats();
+    }
+    /**
+     * Clear cache (for testing/maintenance)
+     */
+    async clearCache() {
+        await this.cache.clear();
+        this.logger.info('Cache cleared');
+    }
+    /**
+     * Gracefully shutdown client
+     */
+    async close() {
+        if (!this.isInitialized) {
+            return;
+        }
+        try {
+            this.logger.info('Closing GamePayloadClient');
+            if (this.worker) {
+                await this.worker.shutdown();
+            }
+            this.isInitialized = false;
+            this.logger.info('GamePayloadClient closed successfully');
+        }
+        catch (error) {
+            this.logger.error('Error during shutdown:', error);
+            throw error;
+        }
+    }
+}
+exports.GamePayloadClient = GamePayloadClient;
+var errors_2 = require("./errors");
+Object.defineProperty(exports, "TankSyncError", { enumerable: true, get: function () { return errors_2.TankSyncError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,14 @@
+/**
+ * TankSync Logger
+ */
+import { LogLevel } from './types';
+export declare class Logger {
+    private logLevel;
+    private prefix;
+    constructor(logLevel?: LogLevel);
+    debug(message: string, data?: unknown): void;
+    info(message: string, data?: unknown): void;
+    warn(message: string, data?: unknown): void;
+    error(message: string, error?: Error | unknown): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AASnC,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,MAAM,CAAgB;gBAElB,QAAQ,GAAE,QAAiB;IAIvC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAM5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAM3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAM3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI;CAStD"}

package/dist/logger.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * TankSync Logger
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+class Logger {
+    constructor(logLevel = 'info') {
+        this.prefix = '[TankSync]';
+        this.logLevel = logLevel;
+    }
+    debug(message, data) {
+        if (LOG_LEVELS[this.logLevel] <= LOG_LEVELS.debug) {
+            console.log(`${this.prefix} DEBUG:`, message, data || '');
+        }
+    }
+    info(message, data) {
+        if (LOG_LEVELS[this.logLevel] <= LOG_LEVELS.info) {
+            console.log(`${this.prefix} INFO:`, message, data || '');
+        }
+    }
+    warn(message, data) {
+        if (LOG_LEVELS[this.logLevel] <= LOG_LEVELS.warn) {
+            console.warn(`${this.prefix} WARN:`, message, data || '');
+        }
+    }
+    error(message, error) {
+        if (LOG_LEVELS[this.logLevel] <= LOG_LEVELS.error) {
+            if (error instanceof Error) {
+                console.error(`${this.prefix} ERROR:`, message, error.message);
+            }
+            else {
+                console.error(`${this.prefix} ERROR:`, message, error || '');
+            }
+        }
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAIH,MAAM,UAAU,GAAG;IACjB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAa,MAAM;IAIjB,YAAY,WAAqB,MAAM;QAF/B,WAAM,GAAG,YAAY,CAAC;QAG5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAc;QACnC,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,SAAS,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAc;QAClC,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,QAAQ,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAc;QAClC,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,QAAQ,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,KAAuB;QAC5C,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YAClD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACjE,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,SAAS,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAnCD,wBAmCC"}