tanksync 1.0.0 → 1.0.2

package/dist/payload-worker.js

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * TankSync Payload Worker
+ * Manages child process lifecycle and IPC communication
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PayloadWorker = void 0;
+const child_process_1 = require("child_process");
+const protocol_1 = require("./protocol");
+const errors_1 = require("./errors");
+class PayloadWorker {
+    constructor(logger, payloadPath, requestTimeout) {
+        this.process = null;
+        this.isReady = false;
+        this.pendingRequests = new Map();
+        this.lineBuffer = '';
+        this.logger = logger;
+        this.payloadPath = payloadPath;
+        this.requestTimeout = requestTimeout;
+    }
+    /**
+     * Start worker process and wait for ready signal
+     */
+    async start(handshakeTimeout = 5000) {
+        this.logger.info('Starting payload worker process');
+        return new Promise((resolve, reject) => {
+            try {
+                this.process = (0, child_process_1.spawn)('node', [this.payloadPath], {
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                    timeout: handshakeTimeout,
+                });
+                if (!this.process) {
+                    throw new errors_1.WorkerStartupError('Failed to spawn child process');
+                }
+                const handshakeTimer = setTimeout(() => {
+                    this.process?.kill();
+                    this.process = null;
+                    reject(new errors_1.WorkerHandshakeTimeoutError(handshakeTimeout));
+                }, handshakeTimeout);
+                this.setupProcessHandlers();
+                // Listen for ready signal
+                this.process.stdout.once('data', (data) => {
+                    this.lineBuffer = data.toString();
+                    try {
+                        const message = protocol_1.Protocol.parse(this.lineBuffer);
+                        if (protocol_1.Protocol.isReady(message)) {
+                            clearTimeout(handshakeTimer);
+                            this.isReady = true;
+                            this.logger.info('Worker ready, version:', message.version);
+                            resolve();
+                        }
+                    }
+                    catch (error) {
+                        clearTimeout(handshakeTimer);
+                        reject(new errors_1.WorkerStartupError(`Failed to parse ready signal: ${error}`));
+                    }
+                });
+            }
+            catch (error) {
+                reject(new errors_1.WorkerStartupError(`Failed to start worker: ${error}`));
+            }
+        });
+    }
+    /**
+     * Send purchase request to worker
+     */
+    async purchaseItem(request) {
+        if (!this.isReady || !this.process) {
+            throw new errors_1.WorkerUnavailableError('Worker is not ready');
+        }
+        const ipcRequest = protocol_1.Protocol.createPurchaseRequest(request);
+        return this.sendRequest(ipcRequest);
+    }
+    /**
+     * Send generic request to worker
+     */
+    async sendRequest(request) {
+        if (!this.isReady || !this.process) {
+            throw new errors_1.WorkerUnavailableError('Worker is not ready');
+        }
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.pendingRequests.delete(request.id);
+                reject(new errors_1.RequestTimeoutError(request.id, this.requestTimeout));
+            }, this.requestTimeout);
+            this.pendingRequests.set(request.id, {
+                resolve,
+                reject,
+                timeout,
+                timestamp: Date.now(),
+            });
+            try {
+                const message = protocol_1.Protocol.serialize(request);
+                this.process.stdin.write(message + '\n');
+                this.logger.debug('Request sent:', request.id);
+            }
+            catch (error) {
+                this.pendingRequests.delete(request.id);
+                clearTimeout(timeout);
+                reject(new Error(`Failed to send request: ${error}`));
+            }
+        });
+    }
+    /**
+     * Setup process event handlers
+     */
+    setupProcessHandlers() {
+        if (!this.process)
+            return;
+        // Handle stdout (regular messages)
+        this.process.stdout.on('data', (data) => {
+            this.lineBuffer += data.toString();
+            const lines = this.lineBuffer.split('\n');
+            this.lineBuffer = lines.pop() || ''; // Keep incomplete line
+            for (const line of lines) {
+                if (line.trim()) {
+                    try {
+                        const message = protocol_1.Protocol.parse(line);
+                        this.handleMessage(message);
+                    }
+                    catch (error) {
+                        this.logger.error('Failed to parse message:', error);
+                    }
+                }
+            }
+        });
+        // Handle stderr (logging/errors)
+        this.process.stderr.on('data', (data) => {
+            this.logger.warn('Worker stderr:', data.toString());
+        });
+        // Handle process exit
+        this.process.on('exit', (code, signal) => {
+            this.logger.warn('Worker process exited', { code, signal });
+            this.isReady = false;
+            this.process = null;
+            // Reject all pending requests
+            this.pendingRequests.forEach(({ reject, timeout }) => {
+                clearTimeout(timeout);
+                reject(new errors_1.WorkerCrashError(code, signal));
+            });
+            this.pendingRequests.clear();
+        });
+        // Handle process error
+        this.process.on('error', (error) => {
+            this.logger.error('Worker process error:', error);
+            this.isReady = false;
+            // Reject all pending requests
+            this.pendingRequests.forEach(({ reject, timeout }) => {
+                clearTimeout(timeout);
+                reject(error);
+            });
+            this.pendingRequests.clear();
+        });
+    }
+    /**
+     * Handle message from worker
+     */
+    handleMessage(message) {
+        if (!message.id) {
+            this.logger.warn('Received message without ID');
+            return;
+        }
+        const pending = this.pendingRequests.get(message.id);
+        if (!pending) {
+            this.logger.debug('Received message for unknown request:', message.id);
+            return;
+        }
+        this.pendingRequests.delete(message.id);
+        clearTimeout(pending.timeout);
+        if (protocol_1.Protocol.isSuccess(message)) {
+            this.logger.debug('Request succeeded:', message.id);
+            pending.resolve(message.result);
+        }
+        else {
+            const errorMessage = protocol_1.Protocol.getErrorMessage(message);
+            this.logger.debug(`Request failed: ${message.id} - ${errorMessage}`);
+            pending.reject(new Error(errorMessage));
+        }
+    }
+    /**
+     * Gracefully shutdown worker
+     */
+    async shutdown(timeout = 5000) {
+        if (!this.process) {
+            return;
+        }
+        const process = this.process;
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.logger.warn('Worker shutdown timeout, forcefully killing');
+                process.kill('SIGKILL');
+            }, timeout);
+            process.on('exit', () => {
+                clearTimeout(timer);
+                resolve();
+            });
+            this.logger.info('Shutting down worker gracefully');
+            process.kill('SIGTERM');
+        });
+    }
+    /**
+     * Check if worker is ready
+     */
+    getStatus() {
+        return {
+            isReady: this.isReady,
+            isAlive: !!this.process && !this.process.killed,
+            pendingRequests: this.pendingRequests.size,
+        };
+    }
+}
+exports.PayloadWorker = PayloadWorker;
+//# sourceMappingURL=payload-worker.js.map

package/dist/payload-worker.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,44 @@
+/**
+ * TankSync IPC Protocol
+ * JSON-based communication between parent and child process
+ */
+import { IPCMessage, IPCRequest, IPCResponse, IPCReadyMessage, PurchaseRequest } from './types';
+export declare class Protocol {
+    /**
+     * Create a purchase request message
+     */
+    static createPurchaseRequest(params: PurchaseRequest): IPCRequest;
+    /**
+     * Create a generic IPC request
+     */
+    static createRequest(method: string, params: unknown): IPCRequest;
+    /**
+     * Serialize message to JSON string
+     */
+    static serialize(message: IPCMessage): string;
+    /**
+     * Parse message from JSON string
+     */
+    static parse(data: string): IPCMessage;
+    /**
+     * Validate IPC message structure
+     */
+    private static validate;
+    /**
+     * Check if message is a ready signal
+     */
+    static isReady(message: IPCMessage): message is IPCReadyMessage;
+    /**
+     * Check if message is a response
+     */
+    static isResponse(message: IPCMessage): message is IPCResponse;
+    /**
+     * Check if response indicates success
+     */
+    static isSuccess(message: IPCMessage): boolean;
+    /**
+     * Extract error message from response
+     */
+    static getErrorMessage(message: IPCMessage): string;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,UAAU,EACV,UAAU,EACV,WAAW,EACX,eAAe,EACf,eAAe,EAChB,MAAM,SAAS,CAAC;AAGjB,qBAAa,QAAQ;IACnB;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,UAAU;IASjE;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,UAAU;IASjE;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM;IAQ7C;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAatC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;IA2BvB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,IAAI,eAAe;IAI/D;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,IAAI,WAAW;IAI9D;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO;IAI9C;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM;CASpD"}

package/dist/protocol.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * TankSync IPC Protocol
+ * JSON-based communication between parent and child process
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Protocol = void 0;
+const uuid_1 = require("uuid");
+const errors_1 = require("./errors");
+class Protocol {
+    /**
+     * Create a purchase request message
+     */
+    static createPurchaseRequest(params) {
+        return {
+            id: (0, uuid_1.v4)(),
+            method: 'purchaseItem',
+            params,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Create a generic IPC request
+     */
+    static createRequest(method, params) {
+        return {
+            id: (0, uuid_1.v4)(),
+            method,
+            params,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Serialize message to JSON string
+     */
+    static serialize(message) {
+        try {
+            return JSON.stringify(message);
+        }
+        catch (error) {
+            throw new Error(`Failed to serialize IPC message: ${error}`);
+        }
+    }
+    /**
+     * Parse message from JSON string
+     */
+    static parse(data) {
+        try {
+            const message = JSON.parse(data);
+            this.validate(message);
+            return message;
+        }
+        catch (error) {
+            if (error instanceof errors_1.MalformedResponseError) {
+                throw error;
+            }
+            throw new errors_1.MalformedResponseError(`Failed to parse JSON: ${error}`);
+        }
+    }
+    /**
+     * Validate IPC message structure
+     */
+    static validate(message) {
+        if (!message || typeof message !== 'object') {
+            throw new errors_1.MalformedResponseError('Message must be a JSON object');
+        }
+        const msg = message;
+        // Check for required fields based on message type
+        if (!msg.id || typeof msg.id !== 'string') {
+            throw new errors_1.MalformedResponseError('Message must have string id field');
+        }
+        // Ready message
+        if (msg.type === 'ready') {
+            if (!msg.version || typeof msg.version !== 'string') {
+                throw new errors_1.MalformedResponseError('Ready message must have string version');
+            }
+        }
+        // Response message
+        if (msg.success !== undefined) {
+            if (typeof msg.success !== 'boolean') {
+                throw new errors_1.MalformedResponseError('success field must be boolean');
+            }
+        }
+    }
+    /**
+     * Check if message is a ready signal
+     */
+    static isReady(message) {
+        return message.type === 'ready';
+    }
+    /**
+     * Check if message is a response
+     */
+    static isResponse(message) {
+        return message.success !== undefined;
+    }
+    /**
+     * Check if response indicates success
+     */
+    static isSuccess(message) {
+        return message.success === true;
+    }
+    /**
+     * Extract error message from response
+     */
+    static getErrorMessage(message) {
+        if (typeof message.error === 'string') {
+            return message.error;
+        }
+        if (typeof message.message === 'string') {
+            return message.message;
+        }
+        return 'Unknown error';
+    }
+}
+exports.Protocol = Protocol;
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,77 @@
+/**
+ * TankSync Type Definitions
+ */
+export interface ClientConfig {
+    payloadUrl?: string;
+    payloadVersion?: string;
+    payloadSignature?: string;
+    cacheDir?: string;
+    downloadTimeout?: number;
+    requestTimeout?: number;
+    maxPayloadSize?: number;
+    logLevel?: LogLevel;
+}
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface PurchaseRequest {
+    playerId: string;
+    itemId: string;
+    quantity: number;
+    requestId: string;
+}
+export interface PurchaseResult {
+    success: boolean;
+    transactionId?: string;
+    itemId?: string;
+    quantity?: number;
+    playerId?: string;
+    error?: string;
+    message?: string;
+}
+export interface IPCMessage {
+    id: string;
+    method?: string;
+    type?: string;
+    params?: unknown;
+    timestamp?: number;
+    success?: boolean;
+    result?: unknown;
+    error?: string;
+    message?: string;
+    version?: string;
+}
+export interface IPCRequest extends IPCMessage {
+    id: string;
+    method: string;
+    params: unknown;
+    timestamp: number;
+}
+export interface IPCResponse extends IPCMessage {
+    id: string;
+    success: boolean;
+    result?: unknown;
+    error?: string;
+}
+export interface IPCReadyMessage extends IPCMessage {
+    type: 'ready';
+    version: string;
+}
+export interface PayloadMetadata {
+    version: string;
+    signature: string;
+    downloadedAt: number;
+    verifiedAt: number;
+}
+export interface PayloadInfo {
+    path: string;
+    version: string;
+    signature: string;
+    metadata: PayloadMetadata;
+}
+export interface PendingRequest {
+    resolve: (value: any) => void;
+    reject: (reason?: any) => void;
+    timeout: NodeJS.Timeout;
+    timestamp: number;
+}
+export type RequestMap = Map<string, PendingRequest>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAG3D,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAGD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAC9B,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * TankSync Type Definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tanksync",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Production-ready Node.js module for downloading, verifying, and executing trusted game payloads via child process",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -48,6 +48,7 @@
   "devDependencies": {
     "@types/jest": "^29.5.0",
     "@types/node": "^20.0.0",
+    "@types/uuid": "^9.0.0",
     "@typescript-eslint/eslint-plugin": "^6.0.0",
     "@typescript-eslint/parser": "^6.0.0",
     "eslint": "^8.0.0",
@@ -56,6 +57,9 @@
     "typescript": "^5.0.0"
   },
   "dependencies": {
-    "uuid": "^9.0.0"
+    "uuid": "^11.1.1"
+  },
+  "overrides": {
+    "minimatch": "^9.0.7"
   }
 }