@selvajs/server 0.2.0-beta.1

package/dist/compute/solve-pipeline.js

@@ -0,0 +1,195 @@
+/**
+ * Transport-agnostic solve pipeline — the callable core lifted out of the app's
+ * `/api/compute` route (embeddable-server-layer plan, K3).
+ *
+ * Given an already-resolved solve context — the `.gh` bytes, the input params +
+ * user values, and a warm `SolveScheduler` (from `createClientCache`) — this
+ * runs the framework-free half of a solve:
+ *
+ *   input tree build → scheduler.solve (with abort/timeout classification) →
+ *   JSON serialize (size-guarded) → optional gzip → Server-Timing envelope.
+ *
+ * It returns a discriminated {@link SolveOutcome}: `ok` carries the ready-to-send
+ * {@link SolveEnvelope} (body + headers + phase metrics), while the error
+ * variants (`timeout`, `client_abort`, `too_large`, `compute_error`) name a
+ * failure the transport maps to its own status code. Nothing here throws for an
+ * expected failure and nothing here touches auth, the database, share tokens,
+ * rate limits, or metric sinks — those stay app policy in the route.
+ *
+ * The Server-Timing string it emits IS the versioned wire contract (audit D5):
+ * see {@link COMPUTE_CONTRACT_VERSION} and {@link COMPUTE_VERSION_HEADER}.
+ */
+import { TreeBuilder } from '@selvajs/compute';
+import { gzipSync } from 'node:zlib';
+import { transformInputParameter } from './transform-input.js';
+// ============================================================================
+// Wire contract version (audit D5)
+// ============================================================================
+//
+// The /api/compute response shape (JSON body + Server-Timing phases) is now an
+// explicit, versioned artifact rather than ad-hoc route output. The version
+// rides an additive response header so a client can branch on it without any
+// change to the existing body — bump this (and document the change) whenever the
+// envelope's shape changes in a way a consumer could observe.
+/** Current compute-response contract version. Additive header; bump on shape change. */
+export const COMPUTE_CONTRACT_VERSION = 1;
+/** Response header carrying {@link COMPUTE_CONTRACT_VERSION}. */
+export const COMPUTE_VERSION_HEADER = 'X-Selva-Compute-Version';
+// ============================================================================
+// Pipeline
+// ============================================================================
+/**
+ * Run the framework-free half of a solve and produce a typed outcome. See the
+ * module doc for the phase sequence and the app/library boundary.
+ */
+export async function runSolvePipeline(args) {
+    const { client, signal } = args;
+    // --- input tree build ---------------------------------------------------
+    const treeBuildStart = performance.now();
+    const inputTree = TreeBuilder.fromInputParams(args.inputs
+        .filter((input) => input.paramType)
+        .map((input) => transformInputParameter(input, args.values[input.id])));
+    const treeBuildMs = performance.now() - treeBuildStart;
+    // --- solve --------------------------------------------------------------
+    // Reset the per-request telemetry holders so a Selva-cache hit (no compute
+    // call) isn't attributed a stale timing from an earlier request on this warm
+    // client. See the rhinoTiming/solveMeta concurrency caveat in client-cache.
+    client.rhinoTiming.last = null;
+    client.solveMeta.last = null;
+    let result;
+    const solveStart = performance.now();
+    try {
+        result = await client.scheduler.solve(args.definitionSource, inputTree, { signal });
+    }
+    catch (err) {
+        const durationMs = performance.now() - solveStart;
+        // Distinguish timeout (scheduler deadline timer) from client disconnect
+        // (request signal). AbortError with the request signal NOT aborted means
+        // the scheduler's own timeout fired — the solve genuinely timed out.
+        const isAbort = err instanceof Error && err.name === 'AbortError';
+        if (isAbort) {
+            if (signal.aborted)
+                return { kind: 'client_abort', durationMs };
+            return {
+                kind: 'timeout',
+                durationMs,
+                message: `Solve exceeded the ${Math.round(args.maxSolveDurationMs / 1000)}s deadline.`
+            };
+        }
+        return { kind: 'compute_error', durationMs, error: err };
+    }
+    const solveMs = performance.now() - solveStart;
+    // --- serialize (size-guarded) ------------------------------------------
+    const serializeStart = performance.now();
+    let serialized;
+    try {
+        serialized = JSON.stringify(result);
+    }
+    catch (err) {
+        // V8 caps a single string at ~512 MB; an oversized `file` output trips a
+        // RangeError here. Surface it as the same too-large outcome as the byte cap.
+        if (err instanceof RangeError)
+            return { kind: 'too_large' };
+        throw err;
+    }
+    if (serialized.length > args.responseMaxBytes)
+        return { kind: 'too_large' };
+    const serializeMs = performance.now() - serializeStart;
+    // --- gzip ---------------------------------------------------------------
+    // Compress BEFORE the timing snapshot so its cost is a measured phase (`gzip`
+    // in Server-Timing, included in `total`). Buffered (not streamed) so
+    // Content-Length is known and a connection cut mid-transfer fails hard
+    // instead of truncating the JSON.
+    let compressed = null;
+    let gzipMs = 0;
+    if (/\bgzip\b/i.test(args.acceptEncoding) && serialized.length > 1024) {
+        const gzipStart = performance.now();
+        compressed = gzipSync(Buffer.from(serialized));
+        gzipMs = performance.now() - gzipStart;
+    }
+    const serverTotalMs = performance.now() - args.loadStartMs;
+    // --- Server-Timing envelope (the versioned wire contract) ---------------
+    const serverTiming = buildServerTiming({
+        defLoadMs: args.defLoadMs,
+        treeBuildMs,
+        solveMs,
+        serializeMs,
+        gzipMs,
+        serverTotalMs,
+        rhino: client.rhinoTiming.last,
+        settle: client.solveMeta.last,
+        prepMarks: args.prepMarks ?? []
+    });
+    const headers = {
+        'Content-Type': 'application/json',
+        'Server-Timing': serverTiming,
+        [COMPUTE_VERSION_HEADER]: String(COMPUTE_CONTRACT_VERSION),
+        Vary: 'Accept-Encoding'
+    };
+    const metrics = {
+        treeBuildMs,
+        solveMs,
+        serializeMs,
+        gzipMs,
+        serverTotalMs,
+        serializedBytes: serialized.length,
+        compressedBytes: compressed?.byteLength ?? null
+    };
+    let envelope;
+    if (compressed) {
+        // A downstream proxy's `encode gzip` skips already-encoded responses, so
+        // this never double-compresses. Vary is set on both branches.
+        headers['Content-Encoding'] = 'gzip';
+        headers['Content-Length'] = String(compressed.byteLength);
+        envelope = { body: new Uint8Array(compressed), encoding: 'gzip', headers, result, metrics };
+    }
+    else {
+        headers['Content-Length'] = String(Buffer.byteLength(serialized));
+        envelope = { body: serialized, headers, result, metrics };
+    }
+    return {
+        kind: 'ok',
+        envelope,
+        solveMs,
+        errorCount: result.errors?.length ?? 0,
+        warningCount: result.warnings?.length ?? 0
+    };
+}
+/**
+ * Assemble the `Server-Timing` header. The browser reads these to attribute its
+ * round-trip: `total` here == the server's headers-to-out wall time, so browser
+ * `ttfb − total` ≈ network+send latency. When the compute server reported its
+ * own decode/solve/encode (VektorNode fork), `rhino_*` is time ON the compute
+ * server and `compute_link` is everything between (network + queue wait). Prep
+ * sub-phases ride as `p_*`; cache verdicts as 0/1 `selva_cache`/`def_reupload`.
+ */
+function buildServerTiming(parts) {
+    let header = `load;dur=${parts.defLoadMs.toFixed(1)}, ` +
+        `tree;dur=${parts.treeBuildMs.toFixed(1)}, ` +
+        `solve;dur=${parts.solveMs.toFixed(1)}, ` +
+        `serialize;dur=${parts.serializeMs.toFixed(1)}, ` +
+        `gzip;dur=${parts.gzipMs.toFixed(1)}, ` +
+        `total;dur=${parts.serverTotalMs.toFixed(1)}`;
+    const rhino = parts.rhino;
+    if (rhino) {
+        const onRhinoMs = rhino.decode + rhino.solve + rhino.encode;
+        const computeLinkMs = Math.max(0, parts.solveMs - onRhinoMs);
+        header +=
+            `, rhino_decode;dur=${rhino.decode.toFixed(1)}` +
+                `, rhino_solve;dur=${rhino.solve.toFixed(1)}` +
+                `, rhino_encode;dur=${rhino.encode.toFixed(1)}` +
+                `, compute_link;dur=${computeLinkMs.toFixed(1)}`;
+    }
+    for (const [label, ms] of parts.prepMarks) {
+        header += `, p_${label};dur=${ms.toFixed(1)}`;
+    }
+    const settle = parts.settle;
+    if (settle) {
+        header += `, selva_cache;dur=${settle.fromCache ? 1 : 0}`;
+        if (settle.definitionReuploaded !== undefined) {
+            header += `, def_reupload;dur=${settle.definitionReuploaded ? 1 : 0}`;
+        }
+    }
+    return header;
+}
+//# sourceMappingURL=solve-pipeline.js.map

package/dist/compute/solve-pipeline.js.map

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

package/dist/compute/transform-input.d.ts

@@ -0,0 +1,20 @@
+import { type InputParam } from '@selvajs/compute';
+import type { SchemaInput } from '@selvajs/schemas';
+/**
+ * Adapt a persisted `SchemaInput` (plus the user's chosen value) into the package's
+ * raw `InputParamSchema`, then let `@selvajs/compute`'s own `processInput` produce the
+ * typed `InputParam`. The package handles every paramType (Number/Integer/Text/Boolean/
+ * ValueList/Geometry/File/Color), normalizes the lowercase UI paramType to its
+ * PascalCase form, and falls back gracefully on underspecified inputs — so we no longer
+ * maintain a parallel hand-rolled transform that silently coerced valueList/file/color
+ * to Text and drifted from the package (and from the parapet app, which already delegates
+ * here). `values`/`acceptedFormats` are absent on `SchemaInput` (they live on the layout
+ * item's config), so valueList/file inputs fall back to carrying the selected value with
+ * no option list — the same value that reaches Grasshopper.
+ */
+export declare function transformInputParameter(input: SchemaInput & {
+    minimum?: number;
+    maximum?: number;
+    stepSize?: number;
+}, value: unknown): InputParam;
+//# sourceMappingURL=transform-input.d.ts.map

package/dist/compute/transform-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-input.d.ts","sourceRoot":"","sources":["../../src/compute/transform-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAuC,MAAM,kBAAkB,CAAC;AACxF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,WAAW,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9E,KAAK,EAAE,OAAO,GACZ,UAAU,CAiCZ"}

package/dist/compute/transform-input.js

@@ -0,0 +1,47 @@
+import { processInput } from '@selvajs/compute';
+/**
+ * Adapt a persisted `SchemaInput` (plus the user's chosen value) into the package's
+ * raw `InputParamSchema`, then let `@selvajs/compute`'s own `processInput` produce the
+ * typed `InputParam`. The package handles every paramType (Number/Integer/Text/Boolean/
+ * ValueList/Geometry/File/Color), normalizes the lowercase UI paramType to its
+ * PascalCase form, and falls back gracefully on underspecified inputs — so we no longer
+ * maintain a parallel hand-rolled transform that silently coerced valueList/file/color
+ * to Text and drifted from the package (and from the parapet app, which already delegates
+ * here). `values`/`acceptedFormats` are absent on `SchemaInput` (they live on the layout
+ * item's config), so valueList/file inputs fall back to carrying the selected value with
+ * no option list — the same value that reaches Grasshopper.
+ */
+export function transformInputParameter(input, value) {
+    const raw = {
+        id: input.id,
+        name: input.nickname,
+        nickname: input.nickname || null,
+        description: input.description || '',
+        // Dynamic value lists ride the ValueList contract on the wire — the plugin's
+        // GetDynamicValueListParameter deliberately reuses TypeName "ValueList" so the
+        // compute fork's existing ValueList input case assigns it. processInput has no
+        // dynamicValueList handler; without this mapping it falls back to Geometry with
+        // a null default and TreeBuilder DROPS the input, so the user's selection never
+        // reaches the definition (the param then solves on its own stale fallback).
+        paramType: input.paramType === 'dynamicValueList' ? 'valueList' : input.paramType,
+        treeAccess: input.inputStructure === 'tree',
+        minimum: input.minimum ?? null,
+        maximum: input.maximum ?? null,
+        atLeast: 1,
+        atMost: 1,
+        stepSize: input.stepSize,
+        // The user's selection wins; otherwise the schema default.
+        default: value ?? input.default
+    };
+    const processed = processInput(raw);
+    // processInput's default-normalization only understands scalars and innerTree
+    // objects — a plain array default (multi-select widgets, e.g. a dynamic value
+    // list checklist) is dropped as "malformed", which would omit the input from
+    // the solve entirely. Restore it; TreeBuilder.appendFlat handles arrays natively.
+    const effective = value ?? input.default;
+    if (Array.isArray(effective) && processed.default == null) {
+        processed.default = effective;
+    }
+    return processed;
+}
+//# sourceMappingURL=transform-input.js.map

package/dist/compute/transform-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-input.js","sourceRoot":"","sources":["../../src/compute/transform-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGxF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CACtC,KAA8E,EAC9E,KAAc;IAEd,MAAM,GAAG,GAAqB;QAC7B,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,QAAQ;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;QAChC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;QACpC,6EAA6E;QAC7E,+EAA+E;QAC/E,+EAA+E;QAC/E,gFAAgF;QAChF,gFAAgF;QAChF,4EAA4E;QAC5E,SAAS,EAAE,KAAK,CAAC,SAAS,KAAK,kBAAkB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS;QACjF,UAAU,EAAE,KAAK,CAAC,cAAc,KAAK,MAAM;QAC3C,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;QAC9B,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;QAC9B,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,CAAC;QACT,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,2DAA2D;QAC3D,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC,OAAO;KAC/B,CAAC;IAEF,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACpC,8EAA8E;IAC9E,8EAA8E;IAC9E,6EAA6E;IAC7E,kFAAkF;IAClF,MAAM,SAAS,GAAG,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC;IACzC,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;QAC1D,SAAkC,CAAC,OAAO,GAAG,SAAS,CAAC;IACzD,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/dist/definitions/__tests__/load-for-render.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tests for `createDefinitionLoader` (K4) — version resolution, error
+ * classification, and the ADR 0005 schema-staleness behavior: a cached schema
+ * is used only at the app's current format version; anything else re-extracts
+ * from compute and persists back (best-effort, current-version only).
+ */
+export {};
+//# sourceMappingURL=load-for-render.test.d.ts.map

package/dist/definitions/__tests__/load-for-render.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-for-render.test.d.ts","sourceRoot":"","sources":["../../../src/definitions/__tests__/load-for-render.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/definitions/__tests__/load-for-render.test.js

@@ -0,0 +1,196 @@
+/**
+ * Tests for `createDefinitionLoader` (K4) — version resolution, error
+ * classification, and the ADR 0005 schema-staleness behavior: a cached schema
+ * is used only at the app's current format version; anything else re-extracts
+ * from compute and persists back (best-effort, current-version only).
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { UI_SCHEMA_VERSION } from '@selvajs/schemas';
+import { createDefinitionLoader, DefinitionLoadError } from '../load-for-render.js';
+const ctx = { userId: 'user-1' };
+function uiSchema(version, inputs = []) {
+    return {
+        id: 'schema-1',
+        name: 'Test',
+        schemaVersion: version,
+        inputs,
+        outputs: [],
+        layout: { type: 'tabbed', tabs: [] }
+    };
+}
+const record = {
+    guid: 'def-1',
+    projectId: 'proj-1',
+    computeServerId: null,
+    liveVersionId: 'v-live',
+    draftVersionId: 'v-draft'
+};
+function version(overrides = {}) {
+    return {
+        id: 'v-live',
+        definitionId: 'def-1',
+        versionNumber: 1,
+        fileExt: 'gh',
+        fileKey: 'definitions/def-1/versions/v1.gh',
+        uploadedBy: 'user-1',
+        uploadedAt: '2026-07-01T00:00:00Z',
+        ...overrides
+    };
+}
+const computeServer = { id: 'srv-1', serverUrl: 'http://c.example' };
+function makeDeps(overrides = {}) {
+    const getIO = vi.fn(async () => ({ inputs: [{ id: 'a', default: 42 }], outputs: [] }));
+    const deps = {
+        storage: { get: vi.fn(async () => new Uint8Array([1, 2, 3])) },
+        definitions: {
+            getVersion: vi.fn(async () => version()),
+            setVersionSchema: vi.fn(async () => { })
+        },
+        projects: { getProject: vi.fn(async () => ({ id: 'proj-1', orgId: 'org-1' })) },
+        resolveServer: vi.fn(async () => computeServer),
+        getClient: vi.fn(async () => ({ client: { getIO, getRawIO: vi.fn() } })),
+        fetchSchema: vi.fn(async () => uiSchema(UI_SCHEMA_VERSION, [{ id: 'a' }])),
+        onWarn: vi.fn(),
+        ...overrides
+    };
+    return {
+        deps: deps,
+        mocks: deps,
+        getIO
+    };
+}
+async function flushMicrotasks() {
+    await new Promise((resolve) => setTimeout(resolve, 0));
+}
+describe('schema cache staleness (ADR 0005)', () => {
+    it('uses the cached schema when its version matches, without re-extracting or persisting', async () => {
+        const cached = uiSchema(UI_SCHEMA_VERSION, [{ id: 'a' }]);
+        const { deps, mocks } = makeDeps();
+        mocks.definitions.getVersion.mockResolvedValue(version({ schema: cached }));
+        const result = await createDefinitionLoader(deps)(ctx, record, 'live');
+        expect(mocks.fetchSchema).not.toHaveBeenCalled();
+        expect(mocks.definitions.setVersionSchema).not.toHaveBeenCalled();
+        // Compute defaults are merged into the cached schema's inputs.
+        expect(result.schema.inputs[0].default).toBe(42);
+    });
+    it('re-extracts and persists when the cached schema is at an older format version', async () => {
+        const { deps, mocks } = makeDeps();
+        mocks.definitions.getVersion.mockResolvedValue(version({ schema: uiSchema('2.10.0') }));
+        await createDefinitionLoader(deps)(ctx, record, 'live');
+        await flushMicrotasks();
+        expect(mocks.fetchSchema).toHaveBeenCalledTimes(1);
+        expect(mocks.definitions.setVersionSchema).toHaveBeenCalledWith(ctx, 'v-live', expect.objectContaining({ schemaVersion: UI_SCHEMA_VERSION }));
+    });
+    it('re-extracts and persists when no schema is cached (pre-caching row)', async () => {
+        const { deps, mocks } = makeDeps();
+        mocks.definitions.getVersion.mockResolvedValue(version({ schema: undefined }));
+        await createDefinitionLoader(deps)(ctx, record, 'live');
+        await flushMicrotasks();
+        expect(mocks.fetchSchema).toHaveBeenCalledTimes(1);
+        expect(mocks.definitions.setVersionSchema).toHaveBeenCalledTimes(1);
+    });
+    it('does NOT persist a re-extracted schema that is still not at the current version', async () => {
+        // Compute plugin behind the app: re-extraction yields an older format.
+        const { deps, mocks } = makeDeps({
+            fetchSchema: vi.fn(async () => uiSchema('2.10.0'))
+        });
+        mocks.definitions.getVersion.mockResolvedValue(version({ schema: undefined }));
+        const result = await createDefinitionLoader(deps)(ctx, record, 'live');
+        await flushMicrotasks();
+        expect(mocks.definitions.setVersionSchema).not.toHaveBeenCalled();
+        // The older schema still renders (older shapes only lack optional additions).
+        expect(result.schema.schemaVersion).toBe('2.10.0');
+    });
+    it('a failed persist warns but does not fail the render', async () => {
+        const { deps, mocks } = makeDeps();
+        mocks.definitions.getVersion.mockResolvedValue(version({ schema: undefined }));
+        mocks.definitions.setVersionSchema.mockRejectedValue(new Error('RLS: not allowed'));
+        const result = await createDefinitionLoader(deps)(ctx, record, 'live');
+        await flushMicrotasks();
+        expect(result.schema.schemaVersion).toBe(UI_SCHEMA_VERSION);
+        expect(mocks.onWarn).toHaveBeenCalledWith(expect.stringContaining('cache refresh failed'));
+    });
+});
+describe('version resolution', () => {
+    it('resolves the draft pointer for the draft channel', async () => {
+        const { deps, mocks } = makeDeps();
+        mocks.definitions.getVersion.mockResolvedValue(version({ id: 'v-draft' }));
+        await createDefinitionLoader(deps)(ctx, record, 'draft');
+        expect(mocks.definitions.getVersion).toHaveBeenCalledWith(ctx, 'v-draft');
+    });
+    it('an explicit versionId wins over the channel pointer', async () => {
+        const { deps, mocks } = makeDeps();
+        mocks.definitions.getVersion.mockResolvedValue(version({ id: 'v-7' }));
+        await createDefinitionLoader(deps)(ctx, record, 'live', 'v-7');
+        expect(mocks.definitions.getVersion).toHaveBeenCalledWith(ctx, 'v-7');
+    });
+    it("rejects a version that belongs to another definition ('data')", async () => {
+        const { deps, mocks } = makeDeps();
+        mocks.definitions.getVersion.mockResolvedValue(version({ definitionId: 'other-def' }));
+        await expect(createDefinitionLoader(deps)(ctx, record, 'live')).rejects.toMatchObject({
+            name: 'DefinitionLoadError',
+            kind: 'data'
+        });
+    });
+});
+describe('error classification', () => {
+    it("no pointer for the channel → 'data'", async () => {
+        const { deps } = makeDeps();
+        const bare = { ...record, liveVersionId: null };
+        await expect(createDefinitionLoader(deps)(ctx, bare, 'live')).rejects.toMatchObject({
+            kind: 'data'
+        });
+    });
+    it("missing blob → 'data'", async () => {
+        const { deps, mocks } = makeDeps();
+        mocks.storage.get.mockResolvedValue(null);
+        await expect(createDefinitionLoader(deps)(ctx, record, 'live')).rejects.toMatchObject({
+            kind: 'data'
+        });
+    });
+    it("unresolvable compute server → 'missing-config'", async () => {
+        const { deps, mocks } = makeDeps();
+        mocks.resolveServer.mockRejectedValue(new Error('none visible'));
+        await expect(createDefinitionLoader(deps)(ctx, record, 'live')).rejects.toMatchObject({
+            kind: 'missing-config'
+        });
+    });
+    it("client connect failure → 'connect'", async () => {
+        const { deps, mocks } = makeDeps();
+        mocks.getClient.mockRejectedValue(new Error('ECONNREFUSED'));
+        await expect(createDefinitionLoader(deps)(ctx, record, 'live')).rejects.toMatchObject({
+            kind: 'connect'
+        });
+    });
+    it("IO/schema phase failure → 'schema'", async () => {
+        const { deps, mocks } = makeDeps({
+            fetchSchema: vi.fn(async () => {
+                throw new Error('no Schema output');
+            })
+        });
+        mocks.definitions.getVersion.mockResolvedValue(version({ schema: undefined }));
+        const err = await createDefinitionLoader(deps)(ctx, record, 'live').catch((e) => e);
+        expect(err).toBeInstanceOf(DefinitionLoadError);
+        expect(err.kind).toBe('schema');
+    });
+});
+describe('compute default merging', () => {
+    beforeEach(() => vi.clearAllMocks());
+    it('converts Color defaults to hex', async () => {
+        const { deps, mocks } = makeDeps({
+            getClient: vi.fn(async () => ({
+                client: {
+                    getIO: vi.fn(async () => ({
+                        inputs: [{ id: 'col', paramType: 'Color', default: '255,128,0' }],
+                        outputs: []
+                    })),
+                    getRawIO: vi.fn()
+                }
+            }))
+        });
+        mocks.definitions.getVersion.mockResolvedValue(version({ schema: uiSchema(UI_SCHEMA_VERSION, [{ id: 'col' }]) }));
+        const result = await createDefinitionLoader(deps)(ctx, record, 'live');
+        expect(result.schema.inputs[0].default).toBe('#ff8000');
+    });
+});
+//# sourceMappingURL=load-for-render.test.js.map

package/dist/definitions/__tests__/load-for-render.test.js.map

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

package/dist/definitions/__tests__/schema-extraction.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tests for the compute-schema extraction gate (K4 / ADR 0005).
+ *
+ * `fetch` is stubbed per test to script the compute `/grasshopper/schema`
+ * response. The version-compat gate (`assertSupportedSchemaVersion`) is also
+ * exercised directly: newer-than-supported must throw 'unsupported', while
+ * older / missing versions pass (compute's C# migrator emits its own current
+ * version; older shapes only lack optional additions).
+ */
+export {};
+//# sourceMappingURL=schema-extraction.test.d.ts.map

package/dist/definitions/__tests__/schema-extraction.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-extraction.test.d.ts","sourceRoot":"","sources":["../../../src/definitions/__tests__/schema-extraction.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/definitions/__tests__/schema-extraction.test.js

@@ -0,0 +1,115 @@
+/**
+ * Tests for the compute-schema extraction gate (K4 / ADR 0005).
+ *
+ * `fetch` is stubbed per test to script the compute `/grasshopper/schema`
+ * response. The version-compat gate (`assertSupportedSchemaVersion`) is also
+ * exercised directly: newer-than-supported must throw 'unsupported', while
+ * older / missing versions pass (compute's C# migrator emits its own current
+ * version; older shapes only lack optional additions).
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { UI_SCHEMA_VERSION } from '@selvajs/schemas';
+import { fetchSchemaFromCompute, assertSupportedSchemaVersion, SchemaExtractionError } from '../schema-extraction.js';
+function schema(version) {
+    return {
+        id: 'schema-1',
+        name: 'Test',
+        ...(version !== undefined && { schemaVersion: version }),
+        inputs: [],
+        outputs: [],
+        layout: { type: 'tabbed', tabs: [] }
+    };
+}
+function bump(version, part) {
+    const nums = version.split('.').map(Number);
+    nums[part] += 1;
+    return nums.join('.');
+}
+const server = {
+    id: 'srv-1',
+    serverUrl: 'http://compute.example.com',
+    apiKey: 'secret'
+};
+describe('assertSupportedSchemaVersion', () => {
+    it('passes the current version', () => {
+        expect(() => assertSupportedSchemaVersion(schema(UI_SCHEMA_VERSION))).not.toThrow();
+    });
+    it('passes older versions (older shapes only lack optional additions)', () => {
+        expect(() => assertSupportedSchemaVersion(schema('1.0.0'))).not.toThrow();
+        expect(() => assertSupportedSchemaVersion(schema('2.0.0'))).not.toThrow();
+    });
+    it('passes a schema without a version (pre-2.12.0 plugin)', () => {
+        expect(() => assertSupportedSchemaVersion(schema())).not.toThrow();
+    });
+    it.each([
+        ['major', 0],
+        ['minor', 1],
+        ['patch', 2]
+    ])('throws unsupported for a newer %s version', (_label, part) => {
+        const newer = bump(UI_SCHEMA_VERSION, part);
+        try {
+            assertSupportedSchemaVersion(schema(newer));
+            expect.unreachable('should have thrown');
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(SchemaExtractionError);
+            expect(err.kind).toBe('unsupported');
+            expect(err.message).toContain(newer);
+            expect(err.message).toContain(UI_SCHEMA_VERSION);
+        }
+    });
+    it('passes an unparseable version string (fail open — invalid is not "newer")', () => {
+        expect(() => assertSupportedSchemaVersion(schema('abc'))).not.toThrow();
+    });
+});
+describe('fetchSchemaFromCompute', () => {
+    let fetchMock;
+    beforeEach(() => {
+        fetchMock = vi.fn();
+        vi.stubGlobal('fetch', fetchMock);
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+    });
+    function computeResponse(schemas) {
+        // Compute wraps results with PascalCase keys.
+        return new Response(JSON.stringify([{ FileName: 'definition.gh', Schemas: schemas }]), {
+            status: 200,
+            headers: { 'content-type': 'application/json' }
+        });
+    }
+    it('extracts the first schema and sends the API key header', async () => {
+        fetchMock.mockResolvedValue(computeResponse([schema(UI_SCHEMA_VERSION)]));
+        const result = await fetchSchemaFromCompute(new Uint8Array([1]), server);
+        expect(result.id).toBe('schema-1');
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(url).toBe('http://compute.example.com/grasshopper/schema');
+        expect(init.headers['RhinoComputeKey']).toBe('secret');
+    });
+    it('throws unreachable when the network request fails', async () => {
+        fetchMock.mockRejectedValue(new Error('ECONNREFUSED'));
+        await expect(fetchSchemaFromCompute(new Uint8Array([1]), server)).rejects.toMatchObject({
+            name: 'SchemaExtractionError',
+            kind: 'unreachable'
+        });
+    });
+    it('throws unreachable on a non-OK status', async () => {
+        fetchMock.mockResolvedValue(new Response('nope', { status: 500 }));
+        await expect(fetchSchemaFromCompute(new Uint8Array([1]), server)).rejects.toMatchObject({
+            kind: 'unreachable'
+        });
+    });
+    it('throws invalid when the definition yields no schemas', async () => {
+        fetchMock.mockResolvedValue(computeResponse([]));
+        await expect(fetchSchemaFromCompute(new Uint8Array([1]), server)).rejects.toMatchObject({
+            kind: 'invalid'
+        });
+    });
+    it('applies the version gate to the extracted schema', async () => {
+        fetchMock.mockResolvedValue(computeResponse([schema(bump(UI_SCHEMA_VERSION, 1))]));
+        await expect(fetchSchemaFromCompute(new Uint8Array([1]), server)).rejects.toMatchObject({
+            kind: 'unsupported'
+        });
+    });
+});
+//# sourceMappingURL=schema-extraction.test.js.map