mcard-js 2.1.2 → 2.1.5

package/dist/ptr/node/NetworkRuntime.d.ts

@@ -0,0 +1,125 @@
+import { Runtime } from './RuntimeInterface.js';
+import { CardCollection } from '../../model/CardCollection.js';
+/**
+ * Network Runtime for handling declarative network operations.
+ *
+ * Supports builtins:
+ * - http_request (general)
+ * - http_get
+ * - http_post
+ * - load_url (enhanced)
+ * - mcard_send (send MCard to remote)
+ * - listen_http (receive MCards)
+ * - mcard_sync (synchronize collection)
+ * - listen_sync (listen for sync requests)
+ *
+ * Security:
+ * Configure via environment variables:
+ * - CLM_ALLOWED_DOMAINS: Comma-separated allowed domains (e.g., "api.example.com,*.trusted.com")
+ * - CLM_BLOCKED_DOMAINS: Comma-separated blocked domains (takes precedence)
+ * - CLM_BLOCK_LOCALHOST: Set to "true" to block localhost
+ * - CLM_BLOCK_PRIVATE_IPS: Set to "true" to block private IP ranges
+ */
+export declare class NetworkRuntime implements Runtime {
+    private collection?;
+    private securityConfig;
+    private responseCache;
+    private rateLimiter;
+    private sessions;
+    private readonly defaultRateLimit;
+    constructor(collection?: CardCollection);
+    /**
+     * Load security configuration from environment variables
+     */
+    private loadSecurityConfigFromEnv;
+    /**
+     * Validate URL against security policy
+     * Throws SecurityViolationError if URL is not allowed
+     */
+    private validateUrlSecurity;
+    /**
+     * Match hostname against domain pattern (supports wildcards like *.example.com)
+     */
+    private matchDomainPattern;
+    /**
+     * Check if hostname is a private IP address
+     */
+    private isPrivateIP;
+    private createSecurityError;
+    /**
+     * Serialize an MCard to a JSON-safe payload for network transfer
+     */
+    private serializeMCard;
+    /**
+     * 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)
+     */
+    private deserializeMCard;
+    /**
+     * Verify hash matches content (optional strict mode)
+     */
+    private verifyMCardHash;
+    /**
+     * Calculate delay for retry attempt based on backoff strategy
+     */
+    private calculateBackoffDelay;
+    /**
+     * Check if HTTP status code should trigger a retry
+     */
+    private shouldRetryStatus;
+    /**
+     * Sleep for a given duration
+     */
+    private sleep;
+    /**
+     * Generate cache key from request config
+     */
+    private generateCacheKey;
+    /**
+     * Get cached response if valid
+     */
+    private getCachedResponse;
+    /**
+     * Cache a response with TTL
+     */
+    private cacheResponse;
+    /**
+     * Store response in MCard collection for persistent caching
+     */
+    private cacheToPersistentStorage;
+    /**
+     * Token bucket rate limiter
+     * Returns true if request should proceed, false if rate limited
+     */
+    private checkRateLimit;
+    /**
+     * Wait until rate limit allows request
+     */
+    private waitForRateLimit;
+    execute(_code: string, context: unknown, config: any, _chapterDir: string): Promise<unknown>;
+    private handleHttpGet;
+    private handleHttpPost;
+    private handleHttpRequest;
+    private handleLoadUrl;
+    private handleMCardSend;
+    private handleListenHttp;
+    private handleMCardSync;
+    private getPeerConnectionClass;
+    private handleWebRTCConnect;
+    private _setupP2PProtocol;
+    private handleWebRTCListen;
+    private handleListenSync;
+    /**
+     * Simple variable interpolation: ${key} or ${input.key} or ${secrets.KEY}
+     * context = { input: ..., secrets: ..., ... }
+     */
+    private interpolate;
+    private interpolateHeaders;
+    private handleSessionRecord;
+    private handleMCardRead;
+    handleRunCommand(config: {
+        command: string;
+    }, context: any): Promise<any>;
+}
+//# sourceMappingURL=NetworkRuntime.d.ts.map

package/dist/ptr/node/NetworkRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkRuntime.d.ts","sourceRoot":"","sources":["../../../src/ptr/node/NetworkRuntime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAoB/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,cAAe,YAAW,OAAO;IAC1C,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,aAAa,CAAoE;IACzF,OAAO,CAAC,WAAW,CAAsD;IACzE,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyC;gBAE9D,UAAU,CAAC,EAAE,cAAc;IAQvC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAejC;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAyD3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;;;OAIG;YACW,gBAAgB;IAY9B;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,KAAK;IAMb;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;YACW,wBAAwB;IAgBtC;;;OAGG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;YACW,gBAAgB;IAMxB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAuCpF,aAAa;YAKb,cAAc;YAUd,iBAAiB;YA0LjB,aAAa;YA0Bb,eAAe;YAyBf,gBAAgB;YA6DhB,eAAe;IA6H7B,OAAO,CAAC,sBAAsB;YAShB,mBAAmB;IA6GjC,OAAO,CAAC,iBAAiB;YA6DX,kBAAkB;YAsClB,gBAAgB;IA+F9B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,kBAAkB;YAUZ,mBAAmB;YA+FnB,eAAe;IA2BvB,gBAAgB,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;CAwBlF"}