mcard-js 2.1.12 → 2.1.13

package/dist/ptr/node/network/HttpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../../../src/ptr/node/network/HttpClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAc,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEjI,OAAO,EAAE,WAAW,EAAE,YAAY,EAAc,MAAM,4BAA4B,CAAC;AAEnF,qBAAa,UAAU;IACnB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,KAAK,CAAe;gBAEhB,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY;IAKnD,OAAO,CACT,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,QAAQ,GAAG,SAAS,EAC1B,MAAM,EAAE;QACJ,KAAK,CAAC,EAAE,WAAW,CAAC;QACpB,KAAK,CAAC,EAAE,WAAW,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,YAAY,CAAA;KAC9B,GACF,OAAO,CAAC,mBAAmB,GAAG,iBAAiB,CAAC;CAyJtD"}

package/dist/ptr/node/network/HttpClient.js

@@ -0,0 +1,139 @@
+import { MCard } from '../../../model/MCard.js';
+import { NetworkCache, RetryUtils } from './NetworkInfrastructure.js';
+export class HttpClient {
+    rateLimiter;
+    cache;
+    constructor(rateLimiter, cache) {
+        this.rateLimiter = rateLimiter;
+        this.cache = cache;
+    }
+    async request(url, method, headers, body, config) {
+        const startTime = Date.now();
+        const fetchUrl = new URL(url);
+        // 1. Check cache first (only for GET requests)
+        const cacheConfig = config.cache;
+        const cacheKey = NetworkCache.generateKey(method, fetchUrl.toString(), typeof body === 'string' ? body : undefined);
+        if (cacheConfig?.enabled && method === 'GET') {
+            const cachedResponse = this.cache.get(cacheKey);
+            if (cachedResponse) {
+                console.log(`[Network] Cache hit for ${url}`);
+                return { ...cachedResponse, cached: true };
+            }
+        }
+        // 2. Rate limiting
+        const domain = fetchUrl.hostname;
+        await this.rateLimiter.waitFor(domain);
+        // 3. Retry configuration
+        const retryConfig = config.retry || {
+            max_attempts: 1,
+            backoff: 'exponential',
+            base_delay: 1000,
+            max_delay: 30000
+        };
+        let lastError = null;
+        let lastStatus = null;
+        let retriesAttempted = 0;
+        for (let attempt = 1; attempt <= retryConfig.max_attempts; attempt++) {
+            const timeout = config.timeout || 30000;
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), timeout);
+            try {
+                const ttfbStart = Date.now();
+                const response = await fetch(fetchUrl.toString(), {
+                    method,
+                    headers,
+                    body,
+                    signal: controller.signal
+                });
+                clearTimeout(timeoutId);
+                // Check if we should retry based on status
+                if (!response.ok && RetryUtils.shouldRetryStatus(response.status, retryConfig.retry_on)) {
+                    lastStatus = response.status;
+                    if (attempt < retryConfig.max_attempts) {
+                        retriesAttempted++;
+                        const delay = RetryUtils.calculateBackoffDelay(attempt, retryConfig.backoff, retryConfig.base_delay, retryConfig.max_delay);
+                        console.log(`[Network] Retry ${attempt}/${retryConfig.max_attempts} for ${url} (status: ${response.status}, delay: ${delay}ms)`);
+                        await new Promise(resolve => setTimeout(resolve, delay));
+                        continue;
+                    }
+                }
+                // Process Response
+                const ttfbTime = Date.now() - ttfbStart;
+                let responseBody;
+                const responseType = config.responseType || 'json';
+                if (responseType === 'json') {
+                    try {
+                        responseBody = await response.json();
+                    }
+                    catch {
+                        responseBody = await response.text(); // Fallback
+                    }
+                }
+                else if (responseType === 'text') {
+                    responseBody = await response.text();
+                }
+                else if (responseType === 'binary') {
+                    const arrayBuffer = await response.arrayBuffer();
+                    responseBody = Buffer.from(arrayBuffer).toString('base64');
+                }
+                else {
+                    responseBody = await response.text();
+                }
+                const totalTime = Date.now() - startTime;
+                // Calculate mcard_hash for content-addressed response
+                let mcard_hash;
+                try {
+                    const bodyStr = typeof responseBody === 'string' ? responseBody : JSON.stringify(responseBody);
+                    const responseCard = await MCard.create(bodyStr);
+                    mcard_hash = responseCard.hash;
+                }
+                catch {
+                    // Non-critical: skip hash if creation fails
+                }
+                const timing = {
+                    dns: 0,
+                    connect: 0,
+                    ttfb: ttfbTime,
+                    total: totalTime
+                };
+                const result = {
+                    success: true,
+                    status: response.status,
+                    headers: Object.fromEntries(response.headers.entries()),
+                    body: responseBody,
+                    timing,
+                    mcard_hash
+                };
+                // Cache successful GET responses
+                if (cacheConfig?.enabled && method === 'GET' && response.ok) {
+                    await this.cache.set(cacheKey, result, cacheConfig.ttl, cacheConfig.storage === 'mcard');
+                }
+                return result;
+            }
+            catch (error) {
+                clearTimeout(timeoutId);
+                lastError = error;
+                // Only retry on network errors or timeouts
+                if (attempt < retryConfig.max_attempts) {
+                    retriesAttempted++;
+                    const delay = RetryUtils.calculateBackoffDelay(attempt, retryConfig.backoff, retryConfig.base_delay, retryConfig.max_delay);
+                    console.log(`[Network] Retry ${attempt}/${retryConfig.max_attempts} for ${url} (error: ${lastError.message}, delay: ${delay}ms)`);
+                    await new Promise(resolve => setTimeout(resolve, delay));
+                    continue;
+                }
+            }
+        }
+        // All retries exhausted
+        const err = lastError;
+        return {
+            success: false,
+            error: {
+                code: err?.name === 'AbortError' ? 'TIMEOUT' : 'HTTP_ERROR',
+                message: err?.message || 'Request failed after retries',
+                status: lastStatus,
+                retries_attempted: retriesAttempted
+            }
+        };
+    }
+}
+//# sourceMappingURL=HttpClient.js.map

package/dist/ptr/node/network/HttpClient.js.map

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

package/dist/ptr/node/network/MCardSerialization.d.ts

@@ -0,0 +1,19 @@
+import { MCard } from '../../../model/MCard.js';
+import { MCardPayload } from '../NetworkConfig.js';
+export declare class MCardSerialization {
+    /**
+     * Serialize an MCard to a JSON-safe payload for network transfer
+     */
+    static serialize(card: MCard): MCardPayload;
+    /**
+     * Deserialize a JSON payload back to an MCard
+     * Uses fromData if hash/g_time provided (preserves identity)
+     * Otherwise creates new MCard (generates new hash/g_time)
+     */
+    static deserialize(json: Partial<MCardPayload>): Promise<MCard>;
+    /**
+     * Verify hash matches content (optional strict mode)
+     */
+    static verifyHash(card: MCard, expectedHash: string): boolean;
+}
+//# sourceMappingURL=MCardSerialization.d.ts.map

package/dist/ptr/node/network/MCardSerialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MCardSerialization.d.ts","sourceRoot":"","sources":["../../../../src/ptr/node/network/MCardSerialization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,qBAAa,kBAAkB;IAC3B;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,GAAG,YAAY;IAU3C;;;;OAIG;WACU,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IAYrE;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;CAOhE"}

package/dist/ptr/node/network/MCardSerialization.js

@@ -0,0 +1,41 @@
+import { MCard } from '../../../model/MCard.js';
+export class MCardSerialization {
+    /**
+     * Serialize an MCard to a JSON-safe payload for network transfer
+     */
+    static serialize(card) {
+        return {
+            hash: card.hash,
+            content: Buffer.from(card.content).toString('base64'),
+            g_time: card.g_time,
+            contentType: card.contentType,
+            hashFunction: card.hashFunction
+        };
+    }
+    /**
+     * Deserialize a JSON payload back to an MCard
+     * Uses fromData if hash/g_time provided (preserves identity)
+     * Otherwise creates new MCard (generates new hash/g_time)
+     */
+    static async deserialize(json) {
+        if (!json.content) {
+            throw new Error('Missing content in MCard payload');
+        }
+        const content = Buffer.from(json.content, 'base64');
+        if (json.hash && json.g_time) {
+            return MCard.fromData(content, json.hash, json.g_time);
+        }
+        return MCard.create(content);
+    }
+    /**
+     * Verify hash matches content (optional strict mode)
+     */
+    static verifyHash(card, expectedHash) {
+        if (card.hash !== expectedHash) {
+            console.warn(`[Network] Hash mismatch. Expected: ${expectedHash}, Got: ${card.hash}`);
+            return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=MCardSerialization.js.map

package/dist/ptr/node/network/MCardSerialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MCardSerialization.js","sourceRoot":"","sources":["../../../../src/ptr/node/network/MCardSerialization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAGhD,MAAM,OAAO,kBAAkB;IAC3B;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAW;QACxB,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACrD,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;SAClC,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAA2B;QAChD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEpD,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAW,EAAE,YAAoB;QAC/C,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,sCAAsC,YAAY,UAAU,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACtF,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ"}

package/dist/ptr/node/network/NetworkInfrastructure.d.ts

@@ -0,0 +1,37 @@
+import { CardCollection } from '../../../model/CardCollection.js';
+import { HttpSuccessResponse, BackoffStrategy } from '../NetworkConfig.js';
+export declare class RateLimiter {
+    private limits;
+    private defaultLimit;
+    constructor(tokensPerSecond?: number, maxBurst?: number);
+    /**
+     * Check if request allowed. Consumes a token if allowed.
+     */
+    check(domain: string): boolean;
+    /**
+     * Wait until rate limit allows request
+     */
+    waitFor(domain: string): Promise<void>;
+}
+export declare class NetworkCache {
+    private memoryCache;
+    private collection?;
+    constructor(collection?: CardCollection);
+    /**
+     * Generate cache key from request config
+     */
+    static generateKey(method: string, url: string, body?: string): string;
+    /**
+     * Get cached response if valid
+     */
+    get(cacheKey: string): HttpSuccessResponse | null;
+    /**
+     * Cache a response with TTL
+     */
+    set(cacheKey: string, response: HttpSuccessResponse, ttlSeconds: number, persist?: boolean): Promise<void>;
+}
+export declare class RetryUtils {
+    static calculateBackoffDelay(attempt: number, strategy: BackoffStrategy, baseDelay: number, maxDelay?: number): number;
+    static shouldRetryStatus(status: number, retryOn?: number[]): boolean;
+}
+//# sourceMappingURL=NetworkInfrastructure.d.ts.map

package/dist/ptr/node/network/NetworkInfrastructure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkInfrastructure.d.ts","sourceRoot":"","sources":["../../../../src/ptr/node/network/NetworkInfrastructure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAElE,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAI3E,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAsD;IACpE,OAAO,CAAC,YAAY,CAAgD;gBAExD,eAAe,GAAE,MAAW,EAAE,QAAQ,GAAE,MAAW;IAK/D;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAuB9B;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK/C;AAID,qBAAa,YAAY;IACrB,OAAO,CAAC,WAAW,CAAoE;IACvF,OAAO,CAAC,UAAU,CAAC,CAAiB;gBAExB,UAAU,CAAC,EAAE,cAAc;IAKvC;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAYtE;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAWjD;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAiB1H;AAID,qBAAa,UAAU;IACnB,MAAM,CAAC,qBAAqB,CACxB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAClB,MAAM;IAkBT,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO;CAKxE"}

package/dist/ptr/node/network/NetworkInfrastructure.js

@@ -0,0 +1,121 @@
+import { MCard } from '../../../model/MCard.js';
+// ============ Rate Limiting ============
+export class RateLimiter {
+    limits;
+    defaultLimit;
+    constructor(tokensPerSecond = 10, maxBurst = 20) {
+        this.limits = new Map();
+        this.defaultLimit = { tokensPerSecond, maxBurst };
+    }
+    /**
+     * Check if request allowed. Consumes a token if allowed.
+     */
+    check(domain) {
+        const now = Date.now();
+        const bucket = this.limits.get(domain) || {
+            tokens: this.defaultLimit.maxBurst,
+            lastRefill: now
+        };
+        // Refill tokens based on time elapsed
+        const elapsed = (now - bucket.lastRefill) / 1000;
+        const refill = elapsed * this.defaultLimit.tokensPerSecond;
+        bucket.tokens = Math.min(this.defaultLimit.maxBurst, bucket.tokens + refill);
+        bucket.lastRefill = now;
+        if (bucket.tokens >= 1) {
+            bucket.tokens -= 1;
+            this.limits.set(domain, bucket);
+            return true;
+        }
+        this.limits.set(domain, bucket);
+        return false;
+    }
+    /**
+     * Wait until rate limit allows request
+     */
+    async waitFor(domain) {
+        while (!this.check(domain)) {
+            await new Promise(resolve => setTimeout(resolve, 100));
+        }
+    }
+}
+// ============ Response Caching ============
+export class NetworkCache {
+    memoryCache;
+    collection;
+    constructor(collection) {
+        this.memoryCache = new Map();
+        this.collection = collection;
+    }
+    /**
+     * Generate cache key from request config
+     */
+    static generateKey(method, url, body) {
+        const keyData = `${method}:${url}:${body || ''}`;
+        // Simple hash for cache key
+        let hash = 0;
+        for (let i = 0; i < keyData.length; i++) {
+            const char = keyData.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash;
+        }
+        return `cache_${Math.abs(hash).toString(36)}`;
+    }
+    /**
+     * Get cached response if valid
+     */
+    get(cacheKey) {
+        const cached = this.memoryCache.get(cacheKey);
+        if (cached && cached.expiresAt > Date.now()) {
+            return { ...cached.response, timing: { ...cached.response.timing, total: 0 } };
+        }
+        if (cached) {
+            this.memoryCache.delete(cacheKey);
+        }
+        return null;
+    }
+    /**
+     * Cache a response with TTL
+     */
+    async set(cacheKey, response, ttlSeconds, persist = false) {
+        this.memoryCache.set(cacheKey, {
+            response,
+            expiresAt: Date.now() + (ttlSeconds * 1000)
+        });
+        if (persist && this.collection) {
+            const cacheEntry = {
+                key: cacheKey,
+                response,
+                expiresAt: Date.now() + (ttlSeconds * 1000),
+                cachedAt: new Date().toISOString()
+            };
+            const card = await MCard.create(JSON.stringify(cacheEntry));
+            await this.collection.add(card);
+        }
+    }
+}
+// ============ Retry Logic Helper ============
+export class RetryUtils {
+    static calculateBackoffDelay(attempt, strategy, baseDelay, maxDelay) {
+        let delay;
+        switch (strategy) {
+            case 'exponential':
+                delay = baseDelay * Math.pow(2, attempt - 1);
+                break;
+            case 'linear':
+                delay = baseDelay * attempt;
+                break;
+            case 'constant':
+            default:
+                delay = baseDelay;
+        }
+        const jitter = delay * 0.1 * (Math.random() * 2 - 1);
+        delay = Math.round(delay + jitter);
+        return maxDelay ? Math.min(delay, maxDelay) : delay;
+    }
+    static shouldRetryStatus(status, retryOn) {
+        const defaultRetryStatuses = [408, 429, 500, 502, 503, 504];
+        const retryStatuses = retryOn || defaultRetryStatuses;
+        return retryStatuses.includes(status);
+    }
+}
+//# sourceMappingURL=NetworkInfrastructure.js.map

package/dist/ptr/node/network/NetworkInfrastructure.js.map

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

package/dist/ptr/node/network/NetworkSecurity.d.ts

@@ -0,0 +1,24 @@
+import { NetworkSecurityConfig } from '../NetworkConfig.js';
+export declare class NetworkSecurity {
+    private config;
+    constructor(config?: NetworkSecurityConfig);
+    /**
+     * Load security configuration from environment variables
+     */
+    private loadSecurityConfigFromEnv;
+    /**
+     * Validate URL against security policy
+     * Throws SecurityViolationError if URL is not allowed
+     */
+    validateUrl(urlString: string): void;
+    /**
+     * Match hostname against domain pattern (supports wildcards like *.example.com)
+     */
+    private matchDomainPattern;
+    /**
+     * Check if hostname is a private IP address
+     */
+    private isPrivateIP;
+    private createSecurityError;
+}
+//# sourceMappingURL=NetworkSecurity.d.ts.map

package/dist/ptr/node/network/NetworkSecurity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkSecurity.d.ts","sourceRoot":"","sources":["../../../../src/ptr/node/network/NetworkSecurity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAA0B,MAAM,qBAAqB,CAAC;AAEpF,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,CAAC,EAAE,qBAAqB;IAI1C;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAejC;;;OAGG;IACI,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAyD3C;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,mBAAmB;CAK9B"}

package/dist/ptr/node/network/NetworkSecurity.js

@@ -0,0 +1,104 @@
+export class NetworkSecurity {
+    config;
+    constructor(config) {
+        this.config = config || this.loadSecurityConfigFromEnv();
+    }
+    /**
+     * Load security configuration from environment variables
+     */
+    loadSecurityConfigFromEnv() {
+        const parseList = (value) => {
+            if (!value)
+                return undefined;
+            return value.split(',').map(s => s.trim()).filter(s => s.length > 0);
+        };
+        return {
+            allowed_domains: parseList(process.env.CLM_ALLOWED_DOMAINS),
+            blocked_domains: parseList(process.env.CLM_BLOCKED_DOMAINS),
+            allowed_protocols: parseList(process.env.CLM_ALLOWED_PROTOCOLS),
+            block_private_ips: process.env.CLM_BLOCK_PRIVATE_IPS === 'true',
+            block_localhost: process.env.CLM_BLOCK_LOCALHOST === 'true'
+        };
+    }
+    /**
+     * Validate URL against security policy
+     * Throws SecurityViolationError if URL is not allowed
+     */
+    validateUrl(urlString) {
+        let url;
+        try {
+            url = new URL(urlString);
+        }
+        catch {
+            throw this.createSecurityError('DOMAIN_BLOCKED', `Invalid URL: ${urlString}`, urlString);
+        }
+        const hostname = url.hostname.toLowerCase();
+        const protocol = url.protocol.replace(':', '');
+        // 1. Check blocked domains (takes precedence)
+        if (this.config.blocked_domains) {
+            for (const pattern of this.config.blocked_domains) {
+                if (this.matchDomainPattern(hostname, pattern)) {
+                    throw this.createSecurityError('DOMAIN_BLOCKED', `Domain '${hostname}' is blocked by security policy`, urlString);
+                }
+            }
+        }
+        // 2. Check allowed domains (if configured, only these are allowed)
+        if (this.config.allowed_domains && this.config.allowed_domains.length > 0) {
+            const isAllowed = this.config.allowed_domains.some(pattern => this.matchDomainPattern(hostname, pattern));
+            if (!isAllowed) {
+                throw this.createSecurityError('DOMAIN_NOT_ALLOWED', `Domain '${hostname}' is not in the allowed list`, urlString);
+            }
+        }
+        // 3. Check allowed protocols
+        if (this.config.allowed_protocols && this.config.allowed_protocols.length > 0) {
+            if (!this.config.allowed_protocols.includes(protocol)) {
+                throw this.createSecurityError('PROTOCOL_NOT_ALLOWED', `Protocol '${protocol}' is not allowed. Allowed: ${this.config.allowed_protocols.join(', ')}`, urlString);
+            }
+        }
+        // 4. Check localhost blocking
+        if (this.config.block_localhost) {
+            if (hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '::1') {
+                throw this.createSecurityError('LOCALHOST_BLOCKED', 'Localhost access is blocked by security policy', urlString);
+            }
+        }
+        // 5. Check private IP blocking
+        if (this.config.block_private_ips) {
+            if (this.isPrivateIP(hostname)) {
+                throw this.createSecurityError('PRIVATE_IP_BLOCKED', `Private IP '${hostname}' is blocked by security policy`, urlString);
+            }
+        }
+    }
+    /**
+     * Match hostname against domain pattern (supports wildcards like *.example.com)
+     */
+    matchDomainPattern(hostname, pattern) {
+        const patternLower = pattern.toLowerCase();
+        if (patternLower.startsWith('*.')) {
+            // Wildcard pattern: *.example.com matches sub.example.com, a.b.example.com
+            const suffix = patternLower.slice(1); // .example.com
+            return hostname.endsWith(suffix) || hostname === patternLower.slice(2);
+        }
+        return hostname === patternLower;
+    }
+    /**
+     * Check if hostname is a private IP address
+     */
+    isPrivateIP(hostname) {
+        // Simple regex checks for common private IP ranges
+        const privatePatterns = [
+            /^10\.\d+\.\d+\.\d+$/, // 10.x.x.x
+            /^192\.168\.\d+\.\d+$/, // 192.168.x.x
+            /^172\.(1[6-9]|2\d|3[01])\.\d+\.\d+$/, // 172.16-31.x.x
+            /^169\.254\.\d+\.\d+$/, // Link-local
+            /^fc00:/i, // IPv6 private
+            /^fd00:/i, // IPv6 private
+        ];
+        return privatePatterns.some(pattern => pattern.test(hostname));
+    }
+    createSecurityError(code, message, url) {
+        const error = new Error(message);
+        error.securityViolation = { code, message, url };
+        return error;
+    }
+}
+//# sourceMappingURL=NetworkSecurity.js.map

package/dist/ptr/node/network/NetworkSecurity.js.map

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

package/dist/ptr/node/runtimes/base.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Base types and utilities for runtime executors.
+ */
+import * as child_process from 'child_process';
+import type { CardCollection } from '../../../model/CardCollection.js';
+export declare const execFile: typeof child_process.execFile.__promisify__;
+/**
+ * Runtime interface - all runtimes must implement this.
+ */
+export interface Runtime {
+    execute(codeOrPath: string, context: unknown, config: any, chapterDir?: string): Promise<unknown>;
+}
+/**
+ * Options for runtime creation.
+ */
+export interface RuntimeOptions {
+    collection?: CardCollection;
+}
+/**
+ * Supported runtime types.
+ */
+export type RuntimeType = 'javascript' | 'python' | 'rust' | 'c' | 'wasm' | 'lean' | 'llm' | 'loader' | 'collection_loader' | 'lambda' | 'network';
+/**
+ * Check if a command is available on the system.
+ */
+export declare function checkCommand(cmd: string, args?: string[]): Promise<boolean>;
+/**
+ * Parse subprocess output as JSON or return raw string.
+ */
+export declare function parseOutput(stdout: string): unknown;
+//# sourceMappingURL=base.d.ts.map

package/dist/ptr/node/runtimes/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/ptr/node/runtimes/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,aAAa,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE,eAAO,MAAM,QAAQ,6CAAyC,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,OAAO;IACpB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrG;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,UAAU,CAAC,EAAE,cAAc,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACjB,YAAY,GACZ,QAAQ,GACR,MAAM,GACN,GAAG,GACH,MAAM,GACN,MAAM,GACN,KAAK,GACL,QAAQ,GACR,mBAAmB,GACnB,QAAQ,GACR,SAAS,CAAC;AAEhB;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAOhG;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CASnD"}

package/dist/ptr/node/runtimes/base.js

@@ -0,0 +1,33 @@
+/**
+ * Base types and utilities for runtime executors.
+ */
+import * as util from 'util';
+import * as child_process from 'child_process';
+export const execFile = util.promisify(child_process.execFile);
+/**
+ * Check if a command is available on the system.
+ */
+export async function checkCommand(cmd, args = ['--version']) {
+    try {
+        await execFile(cmd, args);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Parse subprocess output as JSON or return raw string.
+ */
+export function parseOutput(stdout) {
+    const trimmed = stdout.trim();
+    if (!trimmed)
+        return undefined;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return trimmed;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/ptr/node/runtimes/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/ptr/node/runtimes/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,aAAa,MAAM,eAAe,CAAC;AAG/C,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;AAgC/D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,OAAiB,CAAC,WAAW,CAAC;IAC1E,IAAI,CAAC;QACD,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,OAAO,CAAC;IACnB,CAAC;AACL,CAAC"}

package/dist/ptr/node/runtimes/binary.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Binary runtime executor.
+ *
+ * Executes compiled binaries (Rust, C) via subprocess.
+ */
+import { Runtime } from './base.js';
+export declare class BinaryRuntime implements Runtime {
+    execute(binaryPath: string, context: unknown, config: any, chapterDir: string): Promise<unknown>;
+}
+//# sourceMappingURL=binary.d.ts.map

package/dist/ptr/node/runtimes/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../../../src/ptr/node/runtimes/binary.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,EAAyB,MAAM,WAAW,CAAC;AAE3D,qBAAa,aAAc,YAAW,OAAO;IACnC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAOzG"}

package/dist/ptr/node/runtimes/binary.js

@@ -0,0 +1,16 @@
+/**
+ * Binary runtime executor.
+ *
+ * Executes compiled binaries (Rust, C) via subprocess.
+ */
+import * as path from 'path';
+import { execFile, parseOutput } from './base.js';
+export class BinaryRuntime {
+    async execute(binaryPath, context, config, chapterDir) {
+        const fullPath = path.resolve(chapterDir, binaryPath);
+        const contextStr = typeof context === 'string' ? context : JSON.stringify(context);
+        const { stdout } = await execFile(fullPath, [contextStr]);
+        return parseOutput(stdout);
+    }
+}
+//# sourceMappingURL=binary.js.map