@rcrsr/rill 0.7.2 → 0.8.1

package/dist/ext/fetch/request.js

@@ -0,0 +1,413 @@
+/**
+ * Fetch Request Module
+ * Handles URL building, retry logic, response parsing, and error handling
+ */
+import { RuntimeError } from '../../error-classes.js';
+// ============================================================
+// CONCURRENCY SEMAPHORE
+// ============================================================
+/**
+ * Simple semaphore for limiting concurrent requests.
+ * Queues requests when limit is reached.
+ */
+class Semaphore {
+    permits;
+    queue = [];
+    constructor(permits) {
+        this.permits = permits;
+    }
+    async acquire() {
+        if (this.permits > 0) {
+            this.permits--;
+            return;
+        }
+        return new Promise((resolve) => {
+            this.queue.push(resolve);
+        });
+    }
+    release() {
+        const next = this.queue.shift();
+        if (next) {
+            next();
+        }
+        else {
+            this.permits++;
+        }
+    }
+}
+// ============================================================
+// URL BUILDING
+// ============================================================
+/**
+ * Interpolate path parameters in URL pattern.
+ * Replaces `:param` placeholders with values from pathArgs.
+ *
+ * @param pattern - URL pattern with :param placeholders
+ * @param pathArgs - Map of parameter names to values
+ * @returns Interpolated URL path
+ *
+ * @example
+ * interpolatePathParams('/users/:id/posts/:postId', { id: '123', postId: '456' })
+ * // Returns: '/users/123/posts/456'
+ */
+function interpolatePathParams(pattern, pathArgs) {
+    return pattern.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, (_match, paramName) => {
+        const value = pathArgs.get(paramName);
+        if (value === undefined) {
+            throw new TypeError(`Missing path parameter: ${paramName}`);
+        }
+        return encodeURIComponent(value);
+    });
+}
+/**
+ * Build query string from query arguments.
+ *
+ * @param queryArgs - Map of query parameter names to values
+ * @returns Query string (without leading ?)
+ */
+function buildQueryString(queryArgs) {
+    const params = new URLSearchParams();
+    for (const [key, value] of queryArgs) {
+        params.append(key, value);
+    }
+    return params.toString();
+}
+/**
+ * Build full URL from base, path pattern, and arguments.
+ *
+ * @param baseUrl - Base URL
+ * @param pathPattern - URL path pattern with :param placeholders
+ * @param pathArgs - Path parameter values
+ * @param queryArgs - Query parameter values
+ * @returns Complete URL
+ */
+function buildUrl(baseUrl, pathPattern, pathArgs, queryArgs) {
+    const path = interpolatePathParams(pathPattern, pathArgs);
+    const url = new URL(path, baseUrl);
+    const queryString = buildQueryString(queryArgs);
+    if (queryString) {
+        url.search = queryString;
+    }
+    return url.toString();
+}
+// ============================================================
+// HEADER HANDLING
+// ============================================================
+/**
+ * Flatten multi-value headers to string-to-string dict.
+ * Multiple values joined with `, `.
+ *
+ * @param headers - Headers object from fetch Response
+ * @returns Flattened headers dict
+ */
+function flattenHeaders(headers) {
+    const result = {};
+    headers.forEach((value, key) => {
+        result[key] = value;
+    });
+    return result;
+}
+/**
+ * Resolve dynamic headers (call function if provided).
+ *
+ * @param headers - Static headers or function returning headers
+ * @returns Resolved headers dict
+ */
+function resolveHeaders(headers) {
+    if (!headers)
+        return {};
+    if (typeof headers === 'function')
+        return headers();
+    return headers;
+}
+/**
+ * Merge headers with endpoint headers taking precedence.
+ *
+ * @param globalHeaders - Global extension headers
+ * @param endpointHeaders - Endpoint-specific headers
+ * @returns Merged headers dict
+ */
+function mergeHeaders(globalHeaders, endpointHeaders) {
+    return { ...globalHeaders, ...(endpointHeaders || {}) };
+}
+// ============================================================
+// RESPONSE PARSING
+// ============================================================
+/**
+ * Parse response body as JSON.
+ * Throws RuntimeError on invalid JSON.
+ *
+ * @param response - Fetch Response object
+ * @param namespace - Extension namespace for error messages
+ * @returns Parsed JSON body
+ */
+async function parseJsonResponse(response, namespace) {
+    const text = await response.text();
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new RuntimeError('RILL-R026', `${namespace}: invalid JSON response`);
+    }
+}
+/**
+ * Build full response object with status, headers, and body.
+ *
+ * @param response - Fetch Response object
+ * @param namespace - Extension namespace for error messages
+ * @returns Full response object
+ */
+async function buildFullResponse(response, namespace) {
+    const body = await parseJsonResponse(response, namespace);
+    return {
+        status: response.status,
+        headers: flattenHeaders(response.headers),
+        body,
+    };
+}
+// ============================================================
+// RETRY LOGIC
+// ============================================================
+/**
+ * Check if status code should be retried.
+ * Retry on: 429, 502, 503, 504
+ *
+ * @param status - HTTP status code
+ * @returns true if status should be retried
+ */
+function shouldRetryStatus(status) {
+    return status === 429 || status === 502 || status === 503 || status === 504;
+}
+/**
+ * Extract Retry-After header value in seconds.
+ * Supports both delay-seconds and HTTP-date formats.
+ *
+ * @param response - Fetch Response object
+ * @returns Retry delay in milliseconds, or null if not present
+ */
+function getRetryAfterMs(response) {
+    const retryAfter = response.headers.get('Retry-After');
+    if (!retryAfter)
+        return null;
+    // Try parsing as seconds
+    const seconds = parseInt(retryAfter, 10);
+    if (!isNaN(seconds)) {
+        return seconds * 1000;
+    }
+    // Try parsing as HTTP date
+    const date = new Date(retryAfter);
+    if (!isNaN(date.getTime())) {
+        return Math.max(0, date.getTime() - Date.now());
+    }
+    return null;
+}
+/**
+ * Calculate exponential backoff delay.
+ *
+ * @param baseDelay - Base delay in milliseconds
+ * @param attempt - Attempt number (0-indexed)
+ * @returns Delay in milliseconds
+ */
+function calculateBackoff(baseDelay, attempt) {
+    return baseDelay * Math.pow(2, attempt);
+}
+/**
+ * Sleep for specified duration.
+ *
+ * @param ms - Milliseconds to sleep
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// ============================================================
+// REQUEST EXECUTION
+// ============================================================
+/**
+ * Execute HTTP request with retry logic.
+ * Handles timeouts, network errors, and retries.
+ *
+ * @param url - Request URL
+ * @param options - Fetch options
+ * @param config - Extension configuration
+ * @param namespace - Extension namespace for error messages
+ * @param semaphore - Concurrency semaphore (optional)
+ * @returns Response body or full response
+ */
+export async function executeRequest(url, options, config, namespace, responseShape, semaphore) {
+    const retryLimit = config.retryLimit ?? 3;
+    const retryDelay = config.retryDelay ?? 100;
+    const timeoutMs = config.timeout ?? 30000;
+    let lastError = null;
+    let attempt = 0;
+    while (attempt <= retryLimit) {
+        try {
+            // Acquire semaphore permit if concurrency control enabled
+            if (semaphore) {
+                await semaphore.acquire();
+            }
+            try {
+                // Create abort controller for timeout
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+                try {
+                    // Execute fetch request
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    const response = await fetch(url, {
+                        ...options,
+                        signal: controller.signal,
+                    });
+                    clearTimeout(timeoutId);
+                    // Handle HTTP errors
+                    if (!response.ok) {
+                        const status = response.status;
+                        // 4xx errors (except 429) - no retry
+                        if (status >= 400 && status < 500 && status !== 429) {
+                            const body = await response.text();
+                            throw new RuntimeError('RILL-R022', `${namespace}: HTTP ${status} — ${body}`);
+                        }
+                        // 5xx errors or 429 - retry
+                        if (shouldRetryStatus(status)) {
+                            if (attempt < retryLimit) {
+                                // Calculate retry delay
+                                let delay = calculateBackoff(retryDelay, attempt);
+                                // Respect Retry-After header for 429
+                                if (status === 429) {
+                                    const retryAfterMs = getRetryAfterMs(response);
+                                    if (retryAfterMs !== null) {
+                                        delay = retryAfterMs;
+                                    }
+                                }
+                                await sleep(delay);
+                                attempt++;
+                                continue;
+                            }
+                            else {
+                                // Max retries reached
+                                throw new RuntimeError('RILL-R023', `${namespace}: HTTP ${status} after ${retryLimit} retries`);
+                            }
+                        }
+                    }
+                    // Success - parse response
+                    if (responseShape === 'full') {
+                        return await buildFullResponse(response, namespace);
+                    }
+                    else {
+                        return await parseJsonResponse(response, namespace);
+                    }
+                }
+                finally {
+                    clearTimeout(timeoutId);
+                }
+            }
+            finally {
+                // Release semaphore permit
+                if (semaphore) {
+                    semaphore.release();
+                }
+            }
+        }
+        catch (error) {
+            // Timeout - no retry
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new RuntimeError('RILL-R024', `${namespace}: request timeout (${timeoutMs}ms)`);
+            }
+            // Already formatted error - rethrow immediately
+            if (error instanceof RuntimeError) {
+                throw error;
+            }
+            // Network error - retry logic
+            if (error instanceof TypeError) {
+                if (attempt < retryLimit) {
+                    const delay = calculateBackoff(retryDelay, attempt);
+                    await sleep(delay);
+                    attempt++;
+                    lastError = error;
+                    continue;
+                }
+                else {
+                    throw new RuntimeError('RILL-R025', `${namespace}: network error — ${error.message}`);
+                }
+            }
+            // Unknown error
+            lastError = error;
+            break;
+        }
+    }
+    // Max retries reached for network errors
+    throw new RuntimeError('RILL-R025', `${namespace}: network error — ${lastError?.message ?? 'unknown error'}`);
+}
+// ============================================================
+// PUBLIC API
+// ============================================================
+/**
+ * Create semaphore for concurrency control.
+ *
+ * @param maxConcurrent - Maximum concurrent requests
+ * @returns Semaphore instance or undefined if no limit
+ */
+export function createSemaphore(maxConcurrent) {
+    if (maxConcurrent && maxConcurrent > 0) {
+        return new Semaphore(maxConcurrent);
+    }
+    return undefined;
+}
+/**
+ * Build request from endpoint config and arguments.
+ *
+ * @param config - Extension configuration
+ * @param endpointName - Endpoint name
+ * @param args - Request arguments
+ * @returns Request URL and options
+ */
+export function buildRequest(config, endpointName, args) {
+    const endpoint = config.endpoints[endpointName];
+    if (!endpoint) {
+        throw new TypeError(`Unknown endpoint: ${endpointName}`);
+    }
+    // Categorize arguments by location
+    const pathArgs = new Map();
+    const queryArgs = new Map();
+    const headerArgs = {};
+    let bodyValue = null;
+    for (const [argName, argValue] of Object.entries(args)) {
+        const argDef = endpoint.args?.find((a) => a.name === argName);
+        if (!argDef)
+            continue;
+        const stringValue = typeof argValue === 'string' ? argValue : String(argValue);
+        switch (argDef.location) {
+            case 'path':
+                pathArgs.set(argName, stringValue);
+                break;
+            case 'query':
+                queryArgs.set(argName, stringValue);
+                break;
+            case 'header':
+                headerArgs[argName] = stringValue;
+                break;
+            case 'body':
+                bodyValue = argValue;
+                break;
+        }
+    }
+    // Build URL
+    const url = buildUrl(config.baseUrl, endpoint.path, pathArgs, queryArgs);
+    // Resolve and merge headers
+    const globalHeaders = resolveHeaders(config.headers);
+    const allHeaders = mergeHeaders(globalHeaders, endpoint.headers);
+    const finalHeaders = { ...allHeaders, ...headerArgs };
+    // Build fetch options
+    const options = {
+        method: endpoint.method,
+        headers: finalHeaders,
+    };
+    if (bodyValue !== null) {
+        options.body = JSON.stringify(bodyValue);
+        finalHeaders['Content-Type'] = 'application/json';
+    }
+    return {
+        url,
+        options,
+        responseShape: endpoint.responseShape ?? 'body',
+    };
+}
+//# sourceMappingURL=request.js.map

package/dist/ext/fetch/request.js.map

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

package/dist/ext/fs/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * fs Extension Factory
+ *
+ * Provides sandboxed filesystem operations via mount-based access control.
+ * All 12 functions implement path validation, permission checks, and glob filtering.
+ */
+import type { ExtensionResult } from '../../runtime/ext/extensions.js';
+import { type MountConfig } from './sandbox.js';
+/** Filesystem extension configuration */
+export interface FsConfig {
+    /** Mount definitions keyed by mount name */
+    mounts: Record<string, MountConfig>;
+    /** Global file size limit in bytes (default: 10485760 = 10MB) */
+    maxFileSize?: number | undefined;
+    /** Text encoding for file operations (default: 'utf-8') */
+    encoding?: 'utf-8' | 'utf8' | 'ascii' | undefined;
+}
+export type { MountConfig };
+/**
+ * Create filesystem extension with sandboxed operations.
+ *
+ * Initializes all mounts by resolving paths at creation time.
+ * Returns 12 functions: read, write, append, list, find, exists, remove, stat, mkdir, copy, move, mounts.
+ *
+ * @param config - Mount configuration and defaults
+ * @returns ExtensionResult with 12 filesystem functions
+ * @throws RuntimeError if mount initialization fails
+ *
+ * @example
+ * ```typescript
+ * const fsExt = createFsExtension({
+ *   mounts: {
+ *     workspace: { path: '/home/user/project', mode: 'read-write' }
+ *   }
+ * });
+ * ```
+ */
+export declare function createFsExtension(config: FsConfig): ExtensionResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/ext/fs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ext/fs/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,EACL,KAAK,WAAW,EAIjB,MAAM,cAAc,CAAC;AAMtB,yCAAyC;AACzC,MAAM,WAAW,QAAQ;IACvB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACnD;AAGD,YAAY,EAAE,WAAW,EAAE,CAAC;AAM5B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,GAAG,eAAe,CA8oBnE"}