@selvajs/compute 4.0.0-beta.4 → 4.0.0-beta.6

package/dist/core.d.cts

@@ -1,219 +1,2 @@
-import { C as ComputeConfig } from './handle-files-DMK9bCOW.cjs';
-export { a as ComputeError, D as DefinitionRef, E as ErrorCode, b as ErrorCodes, F as FileBaseInfo, c as FileData, P as ProcessedFile, R as RetryPolicy, S as ServerErrorCodeMap, d as ServerTiming, e as SolveDefinition, f as downloadFileData, g as extractFilesFromComputeResponse, i as isDefinitionRef } from './handle-files-DMK9bCOW.cjs';
-
-/**
- * Generic Rhino Compute fetch function.
- * Sends a POST request to any Compute endpoint with pre-prepared arguments.
- *
- * Use this for advanced, low-level control over compute requests. For most use cases, prefer higher-level APIs.
- *
- * The transport is response-type-agnostic: it does not know which response a
- * given endpoint returns. Callers supply the response type via `R` (defaulting
- * to `unknown`, which forces an explicit narrowing before use).
- *
- * Timeout semantics: `config.timeoutMs` is a PER-ATTEMPT timeout, re-armed for
- * every retry. With `retry: { attempts: N }` the worst-case wall clock is
- * `(N + 1) × timeoutMs` plus backoff sleeps (and a server `Retry-After` can
- * stretch a single sleep up to 60s). For a hard overall deadline, pass
- * `config.signal` (e.g. `AbortSignal.timeout(totalMs)`) — a caller abort wins
- * immediately, including during backoff.
- *
- * Retry caveats: requests are POSTs, so a retry after a mid-flight connection
- * loss may re-execute a request the server already ran (see {@link RetryPolicy}).
- * A 2xx response that declares a non-JSON `Content-Type` (captive portal,
- * proxy login page) fails immediately with `INVALID_RESPONSE` and is never
- * retried; a body that fails to parse under a JSON content-type is treated as
- * a truncated stream and is retried.
- *
- * @typeParam R - The expected response shape. The caller names it at the call site.
- * @param endpoint - The Compute API endpoint (e.g., 'grasshopper', 'io', 'mesh').
- * @param args - Pre-prepared arguments for the request body.
- * @param config - Compute configuration (server URL, API key, timeout, debug, retry, signal).
- * @returns The parsed JSON response from the server, typed as `R`.
- *
- * @example
- * // Basic usage for the Grasshopper endpoint:
- * const response = await fetchCompute(
- *   'grasshopper',
- *   { ... },
- *   {
- *     serverUrl: 'https://my-server.com',
- *     debug: true,
- *     timeoutMs: 30_000,
- *     retry: { attempts: 2 },
- *     signal: controller.signal,
- *   }
- * );
- */
-declare function fetchCompute<R = unknown>(endpoint: string, args: Record<string, any>, config: ComputeConfig): Promise<R>;
-
-/**
- * Side-channel carrying a response's wire size (its JSON text length) alongside
- * the parsed object, so downstream caches can budget by bytes without
- * re-serializing (audit C2/C3 — the response tree can be hundreds of MB, and
- * every extra `JSON.stringify` pass over it is a real cost).
- *
- * A `WeakMap` rather than a property on the response: the response type is the
- * server's schema, and an extra enumerable field would leak into every
- * `JSON.stringify(response)` on the way back out to clients. Derived copies
- * (e.g. the `algo`-stripped shallow copy in `runSolve`) must re-register — the
- * hint follows object identity, not content.
- *
- * The size is `text.length` (UTF-16 code units), not strict UTF-8 bytes —
- * compute responses are ASCII-dominated JSON (base64 + numerals), so the two
- * are interchangeable for budgeting purposes and `.length` is free.
- */
-/** Record `response`'s wire size. No-op for non-object/null values. */
-declare function setResponseWireSize(response: unknown, size: number): void;
-/** The wire size recorded for `response`, or undefined when never registered. */
-declare function getResponseWireSize(response: unknown): number | undefined;
-
-/**
- * Logger interface for structured logging
- *
- * @public Implement this interface to provide custom logging behavior.
- */
-interface Logger {
-    debug(message: string, ...args: unknown[]): void;
-    info(message: string, ...args: unknown[]): void;
-    warn(message: string, ...args: unknown[]): void;
-    error(message: string, ...args: unknown[]): void;
-}
-/**
- * Get the current logger instance
- *
- * @returns The current logger instance
- */
-declare function getLogger(): Logger;
-/**
- * Set a custom logger instance
- *
- * @public Use this to configure custom logging behavior.
- *
- * @param logger - Custom logger implementation or null to disable logging
- * @throws {ComputeError} `INVALID_CONFIG` if the logger is missing any of
- *   the four required methods — failing here beats a confusing
- *   "getLogger().debug is not a function" at some later, unrelated call site.
- *
- * @example
- * ```typescript
- * import { setLogger } from '@selvajs/compute/core';
- *
- * // Enable console logging
- * setLogger(console);
- *
- * // Use a custom logger
- * setLogger({
- *   debug: (msg, ...args) => myLogger.debug(msg, ...args),
- *   info: (msg, ...args) => myLogger.info(msg, ...args),
- *   warn: (msg, ...args) => myLogger.warn(msg, ...args),
- *   error: (msg, ...args) => myLogger.error(msg, ...args)
- * });
- *
- * // Disable logging
- * setLogger(null);
- * ```
- */
-declare function setLogger(logger: Logger | Console | null): void;
-/**
- * Enable debug logging to console
- *
- * @public Convenience method to enable console logging.
- *
- * @example
- * ```typescript
- * import { enableDebugLogging } from '@selvajs/compute/core';
- *
- * enableDebugLogging();
- * ```
- */
-declare function enableDebugLogging(): void;
-
-/**
- * Case-insensitive single-key reader for wire payloads.
- *
- * The Rhino Compute family serializes the same logical field with different
- * casing depending on the server branch:
- *
- * - mcneel 8.x / 9.x: the IO schema is PascalCase (`ParamType`, `Default`,
- *   `InnerTree`, …) because those C# classes carry no `[JsonProperty]`.
- * - VektorNode Compute8: the IO schema is camelCase (`paramType`, `default`,
- *   …) because the fork added `[JsonProperty("camelCase")]`, BUT the nested
- *   `default` DataTree wrapper stays PascalCase (`ParamName` / `InnerTree`)
- *   since `Resthopper.IO.DataTree` is an external type the fork can't attribute.
- *
- * So a single response can mix casings, and which casing a given field uses
- * depends on the server branch. Rather than deep-camelCasing the whole payload
- * (the old `camelcaseKeys` approach — which corrupted user-authored value-list
- * label keys and item `data` JSON), read the specific fields we care about
- * case-insensitively and leave everything else verbatim.
- *
- * Prefers an exact-case match when present, then falls back to the first
- * case-insensitive match. Returns `undefined` when no key matches.
- *
- * @param obj - The source object (any non-object input yields `undefined`).
- * @param name - The logical field name, in any casing.
- */
-declare function readField<T = unknown>(obj: unknown, name: string): T | undefined;
-/**
- * True when `obj` has a key matching `name` (case-insensitively). Distinguishes
- * "field present but value is null/undefined" from "field absent" — needed where
- * presence itself carries meaning (e.g. an `innerTree` that exists but is empty).
- */
-declare function hasField(obj: unknown, name: string): boolean;
-
-/**
- * Decodes a base64 string to binary data (Uint8Array).
- * Normalizes and validates input per WHATWG forgiving-base64 so both runtimes fail consistently.
- *
- * @param base64File - Base64 encoded string
- * @returns Decoded binary data as Uint8Array
- * @throws {ComputeError} `ENCODING_ERROR` if invalid, or `INVALID_STATE` if decoder unavailable
- */
-declare function decodeBase64ToBinary(base64File: string): Uint8Array;
-
-/**
- * The public McNeel endpoint's host — the default blocked host; users must point at
- * their own server. Compared against the parsed hostname lowercased and with any
- * trailing dot stripped, so the FQDN form (`compute.rhino3d.com.`) can't bypass it.
- * Known limitation: the endpoint's raw IP is not blocked — it sits behind a load
- * balancer with no single stable, verifiable address to pin.
- */
-declare const DEFAULT_BLOCKED_HOST = "compute.rhino3d.com";
-interface ValidateServerUrlOptions {
-    /**
-     * Hostnames rejected as a `serverUrl` — a backend's shared public endpoint,
-     * which callers must not point at. Defaults to `[DEFAULT_BLOCKED_HOST]`; pass
-     * `[]` to block nothing. Compared lowercased with any trailing dot stripped.
-     */
-    blockedHosts?: readonly string[];
-}
-/**
- * Validate and normalize a compute `serverUrl`.
- *
- * This is the single source of truth for "is this a usable server URL?" — both
- * `GrasshopperClient` (via `normalizeComputeConfig`) and the standalone-exported
- * `ComputeServerStats` constructor delegate here, so a given URL is accepted or
- * rejected identically no matter which entry point a caller uses.
- *
- * Rules (all enforced, on the *trimmed* input — the trimmed form is what's
- * returned, so no stray whitespace survives into later `fetch` calls):
- * - non-empty (after trim)
- * - `http://` or `https://` scheme (case-insensitive, per RFC 3986)
- * - parseable by `new URL()`
- * - no embedded credentials (`http://user:pass@host`) — `fetch`/`new Request`
- *   reject credentialed URLs at runtime, so they must fail here instead
- * - no query string or fragment — endpoint paths are appended to this URL
- *   (`${serverUrl}/version`), which a `?…` or `#…` suffix would corrupt
- * - not a blocked host (by default the public McNeel endpoint) — compared by
- *   parsed hostname (lowercased, trailing dot stripped), so scheme, casing, port,
- *   path, trailing-slash, or FQDN-dot variants can't slip past the block
- *
- * @param raw - The candidate server URL.
- * @param options - Override the blocked-host list for a non-Rhino backend.
- * @returns The trimmed, normalized URL with any trailing slashes removed.
- * @throws {ComputeError} `INVALID_CONFIG` if any rule fails.
- */
-declare function validateServerUrl(raw: string, options?: ValidateServerUrlOptions): string;
-
-export { ComputeConfig, DEFAULT_BLOCKED_HOST, type Logger, type ValidateServerUrlOptions, decodeBase64ToBinary, enableDebugLogging, fetchCompute, getLogger, getResponseWireSize, hasField, readField, setLogger, setResponseWireSize, validateServerUrl };
+import { C as RetryPolicy, D as ErrorCode, E as ComputeError, O as ErrorCodes, S as ComputeConfig, T as ServerTiming, _ as getLogger, a as ProcessedFile, b as setResponseWireSize, c as validateServerUrl, d as isDefinitionRef, f as decodeBase64ToBinary, g as enableDebugLogging, h as Logger, i as FileData, l as DefinitionRef, m as readField, n as extractFilesFromComputeResponse, o as DEFAULT_BLOCKED_HOST, p as hasField, r as FileBaseInfo, s as ValidateServerUrlOptions, t as downloadFileData, u as SolveDefinition, v as setLogger, w as ServerErrorCodeMap, x as fetchCompute, y as getResponseWireSize } from "./index-BNsid0_9.cjs";
+export { type ComputeConfig, ComputeError, DEFAULT_BLOCKED_HOST, type DefinitionRef, type ErrorCode, ErrorCodes, type FileBaseInfo, type FileData, type Logger, type ProcessedFile, type RetryPolicy, type ServerErrorCodeMap, type ServerTiming, type SolveDefinition, type ValidateServerUrlOptions, decodeBase64ToBinary, downloadFileData, enableDebugLogging, extractFilesFromComputeResponse, fetchCompute, getLogger, getResponseWireSize, hasField, isDefinitionRef, readField, setLogger, setResponseWireSize, validateServerUrl };

package/dist/core.d.ts

@@ -1,219 +1,2 @@
-import { C as ComputeConfig } from './handle-files-DMK9bCOW.js';
-export { a as ComputeError, D as DefinitionRef, E as ErrorCode, b as ErrorCodes, F as FileBaseInfo, c as FileData, P as ProcessedFile, R as RetryPolicy, S as ServerErrorCodeMap, d as ServerTiming, e as SolveDefinition, f as downloadFileData, g as extractFilesFromComputeResponse, i as isDefinitionRef } from './handle-files-DMK9bCOW.js';
-
-/**
- * Generic Rhino Compute fetch function.
- * Sends a POST request to any Compute endpoint with pre-prepared arguments.
- *
- * Use this for advanced, low-level control over compute requests. For most use cases, prefer higher-level APIs.
- *
- * The transport is response-type-agnostic: it does not know which response a
- * given endpoint returns. Callers supply the response type via `R` (defaulting
- * to `unknown`, which forces an explicit narrowing before use).
- *
- * Timeout semantics: `config.timeoutMs` is a PER-ATTEMPT timeout, re-armed for
- * every retry. With `retry: { attempts: N }` the worst-case wall clock is
- * `(N + 1) × timeoutMs` plus backoff sleeps (and a server `Retry-After` can
- * stretch a single sleep up to 60s). For a hard overall deadline, pass
- * `config.signal` (e.g. `AbortSignal.timeout(totalMs)`) — a caller abort wins
- * immediately, including during backoff.
- *
- * Retry caveats: requests are POSTs, so a retry after a mid-flight connection
- * loss may re-execute a request the server already ran (see {@link RetryPolicy}).
- * A 2xx response that declares a non-JSON `Content-Type` (captive portal,
- * proxy login page) fails immediately with `INVALID_RESPONSE` and is never
- * retried; a body that fails to parse under a JSON content-type is treated as
- * a truncated stream and is retried.
- *
- * @typeParam R - The expected response shape. The caller names it at the call site.
- * @param endpoint - The Compute API endpoint (e.g., 'grasshopper', 'io', 'mesh').
- * @param args - Pre-prepared arguments for the request body.
- * @param config - Compute configuration (server URL, API key, timeout, debug, retry, signal).
- * @returns The parsed JSON response from the server, typed as `R`.
- *
- * @example
- * // Basic usage for the Grasshopper endpoint:
- * const response = await fetchCompute(
- *   'grasshopper',
- *   { ... },
- *   {
- *     serverUrl: 'https://my-server.com',
- *     debug: true,
- *     timeoutMs: 30_000,
- *     retry: { attempts: 2 },
- *     signal: controller.signal,
- *   }
- * );
- */
-declare function fetchCompute<R = unknown>(endpoint: string, args: Record<string, any>, config: ComputeConfig): Promise<R>;
-
-/**
- * Side-channel carrying a response's wire size (its JSON text length) alongside
- * the parsed object, so downstream caches can budget by bytes without
- * re-serializing (audit C2/C3 — the response tree can be hundreds of MB, and
- * every extra `JSON.stringify` pass over it is a real cost).
- *
- * A `WeakMap` rather than a property on the response: the response type is the
- * server's schema, and an extra enumerable field would leak into every
- * `JSON.stringify(response)` on the way back out to clients. Derived copies
- * (e.g. the `algo`-stripped shallow copy in `runSolve`) must re-register — the
- * hint follows object identity, not content.
- *
- * The size is `text.length` (UTF-16 code units), not strict UTF-8 bytes —
- * compute responses are ASCII-dominated JSON (base64 + numerals), so the two
- * are interchangeable for budgeting purposes and `.length` is free.
- */
-/** Record `response`'s wire size. No-op for non-object/null values. */
-declare function setResponseWireSize(response: unknown, size: number): void;
-/** The wire size recorded for `response`, or undefined when never registered. */
-declare function getResponseWireSize(response: unknown): number | undefined;
-
-/**
- * Logger interface for structured logging
- *
- * @public Implement this interface to provide custom logging behavior.
- */
-interface Logger {
-    debug(message: string, ...args: unknown[]): void;
-    info(message: string, ...args: unknown[]): void;
-    warn(message: string, ...args: unknown[]): void;
-    error(message: string, ...args: unknown[]): void;
-}
-/**
- * Get the current logger instance
- *
- * @returns The current logger instance
- */
-declare function getLogger(): Logger;
-/**
- * Set a custom logger instance
- *
- * @public Use this to configure custom logging behavior.
- *
- * @param logger - Custom logger implementation or null to disable logging
- * @throws {ComputeError} `INVALID_CONFIG` if the logger is missing any of
- *   the four required methods — failing here beats a confusing
- *   "getLogger().debug is not a function" at some later, unrelated call site.
- *
- * @example
- * ```typescript
- * import { setLogger } from '@selvajs/compute/core';
- *
- * // Enable console logging
- * setLogger(console);
- *
- * // Use a custom logger
- * setLogger({
- *   debug: (msg, ...args) => myLogger.debug(msg, ...args),
- *   info: (msg, ...args) => myLogger.info(msg, ...args),
- *   warn: (msg, ...args) => myLogger.warn(msg, ...args),
- *   error: (msg, ...args) => myLogger.error(msg, ...args)
- * });
- *
- * // Disable logging
- * setLogger(null);
- * ```
- */
-declare function setLogger(logger: Logger | Console | null): void;
-/**
- * Enable debug logging to console
- *
- * @public Convenience method to enable console logging.
- *
- * @example
- * ```typescript
- * import { enableDebugLogging } from '@selvajs/compute/core';
- *
- * enableDebugLogging();
- * ```
- */
-declare function enableDebugLogging(): void;
-
-/**
- * Case-insensitive single-key reader for wire payloads.
- *
- * The Rhino Compute family serializes the same logical field with different
- * casing depending on the server branch:
- *
- * - mcneel 8.x / 9.x: the IO schema is PascalCase (`ParamType`, `Default`,
- *   `InnerTree`, …) because those C# classes carry no `[JsonProperty]`.
- * - VektorNode Compute8: the IO schema is camelCase (`paramType`, `default`,
- *   …) because the fork added `[JsonProperty("camelCase")]`, BUT the nested
- *   `default` DataTree wrapper stays PascalCase (`ParamName` / `InnerTree`)
- *   since `Resthopper.IO.DataTree` is an external type the fork can't attribute.
- *
- * So a single response can mix casings, and which casing a given field uses
- * depends on the server branch. Rather than deep-camelCasing the whole payload
- * (the old `camelcaseKeys` approach — which corrupted user-authored value-list
- * label keys and item `data` JSON), read the specific fields we care about
- * case-insensitively and leave everything else verbatim.
- *
- * Prefers an exact-case match when present, then falls back to the first
- * case-insensitive match. Returns `undefined` when no key matches.
- *
- * @param obj - The source object (any non-object input yields `undefined`).
- * @param name - The logical field name, in any casing.
- */
-declare function readField<T = unknown>(obj: unknown, name: string): T | undefined;
-/**
- * True when `obj` has a key matching `name` (case-insensitively). Distinguishes
- * "field present but value is null/undefined" from "field absent" — needed where
- * presence itself carries meaning (e.g. an `innerTree` that exists but is empty).
- */
-declare function hasField(obj: unknown, name: string): boolean;
-
-/**
- * Decodes a base64 string to binary data (Uint8Array).
- * Normalizes and validates input per WHATWG forgiving-base64 so both runtimes fail consistently.
- *
- * @param base64File - Base64 encoded string
- * @returns Decoded binary data as Uint8Array
- * @throws {ComputeError} `ENCODING_ERROR` if invalid, or `INVALID_STATE` if decoder unavailable
- */
-declare function decodeBase64ToBinary(base64File: string): Uint8Array;
-
-/**
- * The public McNeel endpoint's host — the default blocked host; users must point at
- * their own server. Compared against the parsed hostname lowercased and with any
- * trailing dot stripped, so the FQDN form (`compute.rhino3d.com.`) can't bypass it.
- * Known limitation: the endpoint's raw IP is not blocked — it sits behind a load
- * balancer with no single stable, verifiable address to pin.
- */
-declare const DEFAULT_BLOCKED_HOST = "compute.rhino3d.com";
-interface ValidateServerUrlOptions {
-    /**
-     * Hostnames rejected as a `serverUrl` — a backend's shared public endpoint,
-     * which callers must not point at. Defaults to `[DEFAULT_BLOCKED_HOST]`; pass
-     * `[]` to block nothing. Compared lowercased with any trailing dot stripped.
-     */
-    blockedHosts?: readonly string[];
-}
-/**
- * Validate and normalize a compute `serverUrl`.
- *
- * This is the single source of truth for "is this a usable server URL?" — both
- * `GrasshopperClient` (via `normalizeComputeConfig`) and the standalone-exported
- * `ComputeServerStats` constructor delegate here, so a given URL is accepted or
- * rejected identically no matter which entry point a caller uses.
- *
- * Rules (all enforced, on the *trimmed* input — the trimmed form is what's
- * returned, so no stray whitespace survives into later `fetch` calls):
- * - non-empty (after trim)
- * - `http://` or `https://` scheme (case-insensitive, per RFC 3986)
- * - parseable by `new URL()`
- * - no embedded credentials (`http://user:pass@host`) — `fetch`/`new Request`
- *   reject credentialed URLs at runtime, so they must fail here instead
- * - no query string or fragment — endpoint paths are appended to this URL
- *   (`${serverUrl}/version`), which a `?…` or `#…` suffix would corrupt
- * - not a blocked host (by default the public McNeel endpoint) — compared by
- *   parsed hostname (lowercased, trailing dot stripped), so scheme, casing, port,
- *   path, trailing-slash, or FQDN-dot variants can't slip past the block
- *
- * @param raw - The candidate server URL.
- * @param options - Override the blocked-host list for a non-Rhino backend.
- * @returns The trimmed, normalized URL with any trailing slashes removed.
- * @throws {ComputeError} `INVALID_CONFIG` if any rule fails.
- */
-declare function validateServerUrl(raw: string, options?: ValidateServerUrlOptions): string;
-
-export { ComputeConfig, DEFAULT_BLOCKED_HOST, type Logger, type ValidateServerUrlOptions, decodeBase64ToBinary, enableDebugLogging, fetchCompute, getLogger, getResponseWireSize, hasField, readField, setLogger, setResponseWireSize, validateServerUrl };
+import { C as RetryPolicy, D as ErrorCode, E as ComputeError, O as ErrorCodes, S as ComputeConfig, T as ServerTiming, _ as getLogger, a as ProcessedFile, b as setResponseWireSize, c as validateServerUrl, d as isDefinitionRef, f as decodeBase64ToBinary, g as enableDebugLogging, h as Logger, i as FileData, l as DefinitionRef, m as readField, n as extractFilesFromComputeResponse, o as DEFAULT_BLOCKED_HOST, p as hasField, r as FileBaseInfo, s as ValidateServerUrlOptions, t as downloadFileData, u as SolveDefinition, v as setLogger, w as ServerErrorCodeMap, x as fetchCompute, y as getResponseWireSize } from "./index-BNsid0_9.js";
+export { type ComputeConfig, ComputeError, DEFAULT_BLOCKED_HOST, type DefinitionRef, type ErrorCode, ErrorCodes, type FileBaseInfo, type FileData, type Logger, type ProcessedFile, type RetryPolicy, type ServerErrorCodeMap, type ServerTiming, type SolveDefinition, type ValidateServerUrlOptions, decodeBase64ToBinary, downloadFileData, enableDebugLogging, extractFilesFromComputeResponse, fetchCompute, getLogger, getResponseWireSize, hasField, isDefinitionRef, readField, setLogger, setResponseWireSize, validateServerUrl };

package/dist/core.js

@@ -1,2 +1 @@
-import{b as a,c as b,d as c,e as d,f as e,g as f,h as g,i as h,j as i,m as j,o as k,p as l,q as m,r as n,s as o,t as p}from"./chunk-AYH5O3VG.js";export{b as ComputeError,h as DEFAULT_BLOCKED_HOST,a as ErrorCodes,j as decodeBase64ToBinary,p as downloadFileData,e as enableDebugLogging,o as extractFilesFromComputeResponse,m as fetchCompute,c as getLogger,l as getResponseWireSize,g as hasField,n as isDefinitionRef,f as readField,d as setLogger,k as setResponseWireSize,i as validateServerUrl};
-//# sourceMappingURL=core.js.map
+import{_ as e,a as t,c as n,d as r,f as i,g as a,h as o,i as s,m as c,n as l,o as u,p as d,r as f,t as p,v as m,y as h}from"./core-DONB46aK.js";export{m as ComputeError,r as DEFAULT_BLOCKED_HOST,h as ErrorCodes,n as decodeBase64ToBinary,p as downloadFileData,o as enableDebugLogging,l as extractFilesFromComputeResponse,s as fetchCompute,a as getLogger,t as getResponseWireSize,d as hasField,f as isDefinitionRef,c as readField,e as setLogger,u as setResponseWireSize,i as validateServerUrl};