@holokai/holo-test 1.4.2 → 1.5.0

package/dist/conformance/pipeline-tests.js

@@ -0,0 +1,73 @@
+import { expect, it } from 'vitest';
+import { createResponseEnvelope, createWorkerRequest, processProviderEvents } from '@holokai/holo-sdk/provider';
+import { toAsyncIter } from '@holokai/holo-sdk';
+import { v4 as uuidv4 } from 'uuid';
+export function registerPipelineTests(family, plugin, scenario) {
+    if (!scenario.pipeline || !scenario.providerChunks?.length)
+        return;
+    const expectedFailure = scenario.expectedFailure?.pipeline === true;
+    const t = expectedFailure ? it.fails : it;
+    t('pipeline', async () => {
+        const protocol = { id: uuidv4(), name: scenario.protocol, capability: 'chat' };
+        const workerRequest = createWorkerRequest({
+            provider: { id: uuidv4(), name: family },
+            protocol,
+            payload: {},
+            sourceId: uuidv4(),
+            requestId: uuidv4(),
+            organizationId: 'test-org',
+            isStreaming: scenario.streaming === true,
+            httpRequestDetails: { path: '/test', method: 'POST' },
+        });
+        const envelope = createResponseEnvelope(workerRequest, scenario.audit?.access_model ?? 'unknown');
+        const wire = await plugin.createWireAdapter({
+            requestId: workerRequest.requestId,
+            isStreaming: scenario.streaming === true,
+            protocol: scenario.protocol,
+        });
+        const providerEvents = scenario.providerChunks.map((chunk, i) => {
+            const isLast = i === scenario.providerChunks.length - 1;
+            if (isLast) {
+                return {
+                    type: 'done',
+                    requestId: workerRequest.requestId,
+                    seq: i,
+                    message: chunk,
+                    text: scenario.expectedText ?? '',
+                    ts: Date.now(),
+                };
+            }
+            return {
+                type: 'stream_event',
+                requestId: workerRequest.requestId,
+                seq: i,
+                event: chunk,
+                ts: Date.now(),
+            };
+        });
+        const collectedChunks = [];
+        let auditedRecord = null;
+        const publisher = {
+            publishChunk: async (_s, _r, data) => {
+                collectedChunks.push(data);
+            },
+            publishFinal: async (data) => {
+                auditedRecord = data;
+            },
+        };
+        const result = await processProviderEvents(toAsyncIter(providerEvents), wire, workerRequest, envelope, publisher);
+        expect(result.text).toBe(scenario.expectedText ?? '');
+        if (scenario.audit && auditedRecord) {
+            expect(auditedRecord.providerEvent).toBeTruthy();
+        }
+        if (scenario.expectedPipelineChunks) {
+            expect(collectedChunks).toEqual(scenario.expectedPipelineChunks);
+        }
+        else if (scenario.streaming) {
+            expect(collectedChunks.length).toBeGreaterThan(0);
+            const last = collectedChunks[collectedChunks.length - 1];
+            expect(Boolean(last?.done)).toBe(true);
+        }
+    });
+}
+//# sourceMappingURL=pipeline-tests.js.map

package/dist/conformance/pipeline-tests.js.map

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

package/dist/conformance/runner.d.ts

@@ -0,0 +1,2 @@
+export declare function runConformance(): Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/conformance/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/conformance/runner.ts"],"names":[],"mappings":"AAaA,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CA0GpD"}

package/dist/conformance/runner.js

@@ -0,0 +1,102 @@
+import { describe, it } from 'vitest';
+import { discoverDatastorePlugins, discoverPlugins, loadDatastorePlugin, loadPlugin, } from '../services/plugin-loader';
+import { loadDatastoreConfig, loadScenarios, loadSdkAdapter } from './loader';
+import { loadHoloFixtures, loadPluginHoloScenarios } from './holo-fixture-loader';
+import { registerHoloFixtureTests } from './holo-fixture-tests';
+import { registerTranslatorTests } from './translator-tests';
+import { registerWireTests } from './wire-tests';
+import { registerAuditTests } from './audit-tests';
+import { registerPipelineTests } from './pipeline-tests';
+import { registerSdkTests } from './sdk-tests';
+import { registerDatastoreTests } from './datastore-tests';
+export async function runConformance() {
+    let registered = 0;
+    const providerPackages = await discoverPlugins();
+    for (const pkg of providerPackages) {
+        const family = pkg.replace('@holokai/holo-provider-', '');
+        const plugin = await loadPlugin(family);
+        const scenarios = await loadScenarios(family);
+        if (!scenarios.length)
+            continue;
+        const declaredProtocols = new Set(Object.values(plugin.protocols ?? {}));
+        const sdkAdapter = scenarios.some(s => s.sdk) ? await loadSdkAdapter(family) : undefined;
+        describe(family, () => {
+            for (const scenario of scenarios) {
+                if (!declaredProtocols.has(scenario.protocol)) {
+                    throw new Error(`${family}: scenario "${scenario.name}" declares protocol "${scenario.protocol}", which is not in plugin.protocols (${[...declaredProtocols].join(', ')})`);
+                }
+                describe(`${scenario.protocol}/${scenario.name}`, () => {
+                    registerTranslatorTests(plugin.translator, scenario);
+                    registerWireTests(plugin, scenario);
+                    registerAuditTests(plugin, scenario);
+                    registerPipelineTests(family, plugin, scenario);
+                    registerSdkTests(plugin, scenario, sdkAdapter);
+                });
+            }
+        });
+        registered += scenarios.length;
+    }
+    // Holo-fixture conformance: each fixture pins one Holo shape (request, response,
+    // or streaming chunk array); each plugin contributes a native counterpart at
+    // tests/data/holo/. The framework auto-generates per-plugin tests + N×N cross
+    // tests per fixture.
+    const holoFixtures = await loadHoloFixtures();
+    if (holoFixtures.length) {
+        const allFamilies = providerPackages.map(pkg => pkg.replace('@holokai/holo-provider-', ''));
+        const translators = new Map();
+        const scenariosByFamily = new Map();
+        for (const family of allFamilies) {
+            const plugin = await loadPlugin(family);
+            translators.set(family, plugin.translator);
+            const pluginScenarios = await loadPluginHoloScenarios(family);
+            if (pluginScenarios.length)
+                scenariosByFamily.set(family, pluginScenarios);
+        }
+        // Group plugin scenarios by Holo fixture id.
+        const byHoloId = new Map();
+        for (const [family, scenarios] of scenariosByFamily) {
+            for (const scenario of scenarios) {
+                let map = byHoloId.get(scenario.holoId);
+                if (!map) {
+                    map = new Map();
+                    byHoloId.set(scenario.holoId, map);
+                }
+                map.set(family, scenario);
+            }
+        }
+        // Validate every holoId on a plugin scenario maps to an existing fixture.
+        const fixtureIds = new Set(holoFixtures.map(f => f.id));
+        for (const id of byHoloId.keys()) {
+            if (!fixtureIds.has(id)) {
+                throw new Error(`Plugin scenario references holoId "${id}" but no Holo fixture with that id exists in packages/holo-test/holo/.`);
+            }
+        }
+        describe('holo-fixtures', () => {
+            for (const fixture of holoFixtures) {
+                const pluginScenarios = byHoloId.get(fixture.id) ?? new Map();
+                registerHoloFixtureTests(fixture, pluginScenarios, translators);
+            }
+        });
+        registered += holoFixtures.length;
+    }
+    const datastorePackages = await discoverDatastorePlugins();
+    for (const pkg of datastorePackages) {
+        const family = pkg.replace('@holokai/holo-datastore-', '');
+        const config = await loadDatastoreConfig(family);
+        if (!config)
+            continue;
+        const plugin = await loadDatastorePlugin(family);
+        describe(`datastore-${family}`, () => {
+            registerDatastoreTests(plugin, config);
+        });
+        registered += 1;
+    }
+    if (registered === 0) {
+        describe('conformance', () => {
+            it('no scenario data files or datastore configs found under any plugin', () => {
+                // Sentinel to keep vitest happy until something is authored.
+            });
+        });
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/conformance/runner.js.map

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

package/dist/conformance/sdk-tests.d.ts

@@ -0,0 +1,12 @@
+import type { IProviderPlugin } from '@holokai/holo-types/plugin';
+import type { HoloScenario } from './types';
+export interface ScenarioSdkAdapter {
+    family: string;
+    call(scenario: HoloScenario, port: number): Promise<unknown>;
+    routes(scenario: HoloScenario): {
+        method: string;
+        path: string;
+    } | undefined;
+}
+export declare function registerSdkTests(plugin: IProviderPlugin, scenario: HoloScenario, adapter: ScenarioSdkAdapter | undefined): void;
+//# sourceMappingURL=sdk-tests.d.ts.map

package/dist/conformance/sdk-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-tests.d.ts","sourceRoot":"","sources":["../../src/conformance/sdk-tests.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,4BAA4B,CAAC;AAEhE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,SAAS,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,MAAM,CAAC;IAEf,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7D,MAAM,CAAC,QAAQ,EAAE,YAAY,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CAChF;AAED,wBAAgB,gBAAgB,CAC5B,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,kBAAkB,GAAG,SAAS,GACxC,IAAI,CAsBN"}

package/dist/{services/http-fixture-server.js → conformance/sdk-tests.js}

@@ -1,21 +1,44 @@
+import { expect, it } from 'vitest';
 import express from 'express';
-export class HttpFixtureServer {
+export function registerSdkTests(plugin, scenario, adapter) {
+    if (!scenario.sdk || !scenario.providerChunks?.length)
+        return;
+    if (!adapter) {
+        it.todo(`sdk (no sdk-adapter found for plugin)`);
+        return;
+    }
+    const expectedFailure = scenario.expectedFailure?.sdk === true;
+    const t = expectedFailure ? it.fails : it;
+    t('sdk', async () => {
+        const server = new HoloFixtureServer();
+        server.mount(scenario, plugin, adapter);
+        const port = await server.start();
+        try {
+            const result = await adapter.call(scenario, port);
+            assertPartialMatch(result, scenario.sdk.expectedResult);
+        }
+        finally {
+            await server.stop();
+        }
+    });
+}
+class HoloFixtureServer {
     server = null;
     app = express();
     constructor() {
         this.app.use(express.json());
     }
-    mount(fixture, plugin, adapter) {
-        const route = adapter.routes(fixture);
+    mount(scenario, plugin, adapter) {
+        const route = adapter.routes(scenario);
         if (!route)
             return;
         const handler = async (_req, res) => {
             const wire = await plugin.createWireAdapter({
-                requestId: 'roundtrip-req',
-                isStreaming: fixture.streaming,
-                protocol: fixture.protocol,
+                requestId: 'sdk-test',
+                isStreaming: scenario.streaming === true,
+                protocol: scenario.protocol,
             });
-            const events = buildProviderEvents(fixture);
+            const events = buildProviderEvents(scenario);
             let headersSent = false;
             for (const evt of events) {
                 const chunks = await wire.fromProviderEvent(evt);
@@ -45,10 +68,9 @@ export class HttpFixtureServer {
             this.app.get(route.path, handler);
         }
     }
-    async start(options) {
-        const port = options?.port ?? 0;
+    async start() {
         return new Promise((resolve, reject) => {
-            this.server = this.app.listen(port, () => {
+            this.server = this.app.listen(0, () => {
                 const addr = this.server.address();
                 if (typeof addr === 'object' && addr) {
                     resolve(addr.port);
@@ -68,26 +90,43 @@ export class HttpFixtureServer {
         });
     }
 }
-function buildProviderEvents(fixture) {
-    return fixture.providerChunks.map((chunk, i) => {
-        const isLast = i === fixture.providerChunks.length - 1;
+function buildProviderEvents(scenario) {
+    return scenario.providerChunks.map((chunk, i) => {
+        const isLast = i === scenario.providerChunks.length - 1;
         if (isLast) {
             return {
                 type: 'done',
-                requestId: 'roundtrip-req',
+                requestId: 'sdk-test',
                 seq: i,
                 message: chunk,
-                text: fixture.expectedText,
+                text: scenario.expectedText ?? '',
                 ts: Date.now(),
             };
         }
         return {
             type: 'stream_event',
-            requestId: 'roundtrip-req',
+            requestId: 'sdk-test',
             seq: i,
             event: chunk,
             ts: Date.now(),
         };
     });
 }
-//# sourceMappingURL=http-fixture-server.js.map
+function assertPartialMatch(actual, expected, path = 'sdk.result') {
+    if (Array.isArray(expected)) {
+        expect(Array.isArray(actual), `${path} should be array`).toBe(true);
+        const arr = actual;
+        expect(arr.length, `${path}.length`).toBe(expected.length);
+        expected.forEach((item, i) => assertPartialMatch(arr[i], item, `${path}[${i}]`));
+        return;
+    }
+    if (expected && typeof expected === 'object') {
+        expect(actual, path).toBeTypeOf('object');
+        for (const [k, v] of Object.entries(expected)) {
+            assertPartialMatch(actual?.[k], v, `${path}.${k}`);
+        }
+        return;
+    }
+    expect(actual, path).toEqual(expected);
+}
+//# sourceMappingURL=sdk-tests.js.map

package/dist/conformance/sdk-tests.js.map

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

package/dist/conformance/translator-tests.d.ts

@@ -0,0 +1,4 @@
+import type { IProviderTranslator } from '@holokai/holo-types/provider';
+import type { HoloScenario } from './types';
+export declare function registerTranslatorTests(translator: IProviderTranslator, scenario: HoloScenario): void;
+//# sourceMappingURL=translator-tests.d.ts.map

package/dist/conformance/translator-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translator-tests.d.ts","sourceRoot":"","sources":["../../src/conformance/translator-tests.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,8BAA8B,CAAC;AAEtE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,SAAS,CAAC;AAmB1C,wBAAgB,uBAAuB,CACnC,UAAU,EAAE,mBAAmB,EAC/B,QAAQ,EAAE,YAAY,GACvB,IAAI,CA6DN"}

package/dist/conformance/translator-tests.js

@@ -0,0 +1,49 @@
+import { expect, it } from 'vitest';
+function isExpectedFailure(scenario, side, direction) {
+    const flag = scenario.expectedFailure?.[side];
+    if (flag === undefined)
+        return false;
+    if (typeof flag === 'boolean')
+        return flag;
+    return flag[direction] === true;
+}
+function maybeFailing(expectedFailure) {
+    return expectedFailure ? it.fails : it;
+}
+export function registerTranslatorTests(translator, scenario) {
+    if (scenario.request) {
+        const { native, holo } = scenario.request;
+        maybeFailing(isExpectedFailure(scenario, 'request', 'toHolo'))('request: toHolo', async () => {
+            const result = await translator.toHoloRequest(native);
+            expect(result).toEqual(holo);
+        });
+        maybeFailing(isExpectedFailure(scenario, 'request', 'fromHolo'))('request: fromHolo', async () => {
+            const result = await translator.fromHoloRequest(holo);
+            expect(result).toEqual(native);
+        });
+        maybeFailing(isExpectedFailure(scenario, 'request', 'roundTrip'))('request: round-trip (native → Holo → native)', async () => {
+            const intermediate = await translator.toHoloRequest(native);
+            const back = await translator.fromHoloRequest(intermediate);
+            expect(back).toEqual(native);
+        });
+    }
+    if (scenario.response) {
+        const { native, holo } = scenario.response;
+        maybeFailing(isExpectedFailure(scenario, 'response', 'toHolo'))('response: toHolo', async () => {
+            const result = await translator.toHoloResponse(native);
+            expect(result).toEqual(holo);
+        });
+        maybeFailing(isExpectedFailure(scenario, 'response', 'fromHolo'))('response: fromHolo', async () => {
+            const result = await translator.fromHoloResponse(holo);
+            expect(result).toEqual(native);
+        });
+        maybeFailing(isExpectedFailure(scenario, 'response', 'roundTrip'))('response: round-trip (native → Holo → native)', async () => {
+            const intermediate = await translator.toHoloResponse(native);
+            const back = await translator.fromHoloResponse(intermediate);
+            expect(back).toEqual(native);
+        });
+    }
+    // Streaming-translator round-trip is exercised via the holo-fixture
+    // `fromHoloStream` / `toHoloStream` tests in holo-fixture-tests.ts.
+}
+//# sourceMappingURL=translator-tests.js.map

package/dist/conformance/translator-tests.js.map

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

package/dist/conformance/types.d.ts

@@ -0,0 +1,81 @@
+import type { HoloRequest, HoloResponse } from '@holokai/holo-types/holo';
+import type { ProviderResponseStatus } from '@holokai/holo-types/entities';
+export interface HoloScenarioRequest<TNative = unknown> {
+    native: TNative;
+    holo: Partial<HoloRequest>;
+}
+export interface HoloScenarioResponse<TNative = unknown> {
+    native: TNative;
+    holo: Partial<HoloResponse>;
+}
+export interface HoloScenarioWire {
+    expectedStatus: number;
+    expectedHeaders: Record<string, string>;
+    expectedWire: string[];
+}
+export interface HoloScenarioAudit {
+    access_model?: string;
+    input_tokens?: number;
+    output_tokens?: number;
+    status: ProviderResponseStatus;
+    metadata?: Record<string, unknown>;
+}
+export interface HoloScenarioSdk<TRequest = unknown, TResult = unknown> {
+    request: TRequest;
+    expectedResult: TResult;
+}
+type ExpectedFailureFlag<TDirection extends string = string> = boolean | (Partial<Record<TDirection, boolean>>);
+export interface HoloScenario<TNativeRequest = unknown, TNativeResponse = unknown, TNativeChunk = unknown, TSdkRequest = unknown, TSdkResult = unknown> {
+    name: string;
+    protocol: string;
+    /** Request-side translator data. */
+    request?: HoloScenarioRequest<TNativeRequest>;
+    /** Response-side translator data. */
+    response?: HoloScenarioResponse<TNativeResponse>;
+    /**
+     * Streaming mode flag. Used by wire/audit/pipeline/sdk tests to set up the
+     * provider event sequence and the wire adapter's `isStreaming`.
+     */
+    streaming?: boolean;
+    /**
+     * Provider response chunks consumed by wire/audit/pipeline/sdk tests.
+     * For non-streaming, a single-element array. For streaming, the chunk sequence.
+     */
+    providerChunks?: TNativeChunk[];
+    /**
+     * Concatenated text result expected after consuming all chunks.
+     * Used by wire (final `done` event), audit (token accounting), and pipeline (text assertion).
+     */
+    expectedText?: string;
+    /** Wire-conformance assertions (chunk bodies, status, headers). */
+    wire?: HoloScenarioWire;
+    /** Audit-conformance assertions on the produced ProviderResponse. */
+    audit?: HoloScenarioAudit;
+    /** SDK pipeline (real client → fixture HTTP server → assertion). */
+    sdk?: HoloScenarioSdk<TSdkRequest, TSdkResult>;
+    /** Enable the pipeline test path. Reuses providerChunks/expectedText. */
+    pipeline?: boolean;
+    /**
+     * Optional chunk-level shape assertion for pipeline-tests. When provided, the
+     * collected `WireChunk[]` (what `publishChunk` receives during the run) must
+     * match this expected sequence. Inputs are compared after `stripProviderMetadata`
+     * to ignore translator pass-through fields.
+     *
+     * When omitted, pipeline-tests still verifies structural invariants (count > 0,
+     * last chunk carries `done`) and — when the protocol declares one — runs
+     * `assertEventSequence` against the input ProviderEvents.
+     */
+    expectedPipelineChunks?: unknown[];
+    /** Pin known translator/wire/audit losses without polluting CI red. */
+    expectedFailure?: {
+        request?: ExpectedFailureFlag<'toHolo' | 'fromHolo' | 'roundTrip'>;
+        response?: ExpectedFailureFlag<'toHolo' | 'fromHolo' | 'roundTrip'>;
+        wire?: boolean;
+        audit?: boolean;
+        sdk?: boolean;
+        pipeline?: boolean;
+        reason?: string;
+    };
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/conformance/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/conformance/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAE,YAAY,EAAC,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AAEzE,MAAM,WAAW,mBAAmB,CAAC,OAAO,GAAG,OAAO;IAClD,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB,CAAC,OAAO,GAAG,OAAO;IACnD,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAClE,OAAO,EAAE,QAAQ,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;CAC3B;AAED,KAAK,mBAAmB,CAAC,UAAU,SAAS,MAAM,GAAG,MAAM,IACrD,OAAO,GACP,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7C,MAAM,WAAW,YAAY,CACzB,cAAc,GAAG,OAAO,EACxB,eAAe,GAAG,OAAO,EACzB,YAAY,GAAG,OAAO,EACtB,WAAW,GAAG,OAAO,EACrB,UAAU,GAAG,OAAO;IAEpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IAEjB,oCAAoC;IACpC,OAAO,CAAC,EAAE,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAC9C,qCAAqC;IACrC,QAAQ,CAAC,EAAE,oBAAoB,CAAC,eAAe,CAAC,CAAC;IAEjD;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;IAEhC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,mEAAmE;IACnE,IAAI,CAAC,EAAE,gBAAgB,CAAC;IAExB,qEAAqE;IACrE,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAE1B,oEAAoE;IACpE,GAAG,CAAC,EAAE,eAAe,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAE/C,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;;OASG;IACH,sBAAsB,CAAC,EAAE,OAAO,EAAE,CAAC;IAEnC,uEAAuE;IACvE,eAAe,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,mBAAmB,CAAC,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC;QACnE,QAAQ,CAAC,EAAE,mBAAmB,CAAC,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC;QACpE,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACL"}

package/dist/conformance/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/conformance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/conformance/types.ts"],"names":[],"mappings":""}

package/dist/conformance/wire-tests.d.ts

@@ -0,0 +1,4 @@
+import type { IProviderPlugin } from '@holokai/holo-types/plugin';
+import type { HoloScenario } from './types';
+export declare function registerWireTests(plugin: IProviderPlugin, scenario: HoloScenario): void;
+//# sourceMappingURL=wire-tests.d.ts.map

package/dist/conformance/wire-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-tests.d.ts","sourceRoot":"","sources":["../../src/conformance/wire-tests.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,4BAA4B,CAAC;AAEhE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,SAAS,CAAC;AAE1C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAmCvF"}

package/dist/conformance/wire-tests.js

@@ -0,0 +1,52 @@
+import { expect, it } from 'vitest';
+export function registerWireTests(plugin, scenario) {
+    if (!scenario.wire || !scenario.providerChunks?.length)
+        return;
+    const expectedFailure = scenario.expectedFailure?.wire === true;
+    const t = expectedFailure ? it.fails : it;
+    t('wire', async () => {
+        const wire = await plugin.createWireAdapter({
+            requestId: 'test-req',
+            isStreaming: scenario.streaming === true,
+            protocol: scenario.protocol,
+        });
+        const allChunks = [];
+        for (let i = 0; i < scenario.providerChunks.length; i++) {
+            const isLast = i === scenario.providerChunks.length - 1;
+            const event = toProviderEvent(scenario, i, isLast);
+            const chunks = await wire.fromProviderEvent(event);
+            allChunks.push(...chunks);
+        }
+        const firstChunk = allChunks[0];
+        expect(firstChunk, 'wire emitted no chunks').toBeDefined();
+        expect(firstChunk.status).toBe(scenario.wire.expectedStatus);
+        for (const [k, v] of Object.entries(scenario.wire.expectedHeaders)) {
+            expect(firstChunk.headers?.[k], `header ${k}`).toBe(v);
+        }
+        const lastChunk = allChunks[allChunks.length - 1];
+        expect(lastChunk.done, 'last chunk must mark done').toBe(true);
+        const wireBodies = allChunks.map(c => c.body);
+        expect(wireBodies).toEqual(scenario.wire.expectedWire);
+    });
+}
+function toProviderEvent(scenario, index, isLast) {
+    const chunk = scenario.providerChunks[index];
+    if (isLast) {
+        return {
+            type: 'done',
+            requestId: 'test-req',
+            seq: index,
+            message: chunk,
+            text: scenario.expectedText ?? '',
+            ts: Date.now(),
+        };
+    }
+    return {
+        type: 'stream_event',
+        requestId: 'test-req',
+        seq: index,
+        event: chunk,
+        ts: Date.now(),
+    };
+}
+//# sourceMappingURL=wire-tests.js.map

package/dist/conformance/wire-tests.js.map

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

package/dist/fixtures/plugin.d.ts

@@ -0,0 +1,27 @@
+declare const TEST_SCOPE = "@holokai-test";
+declare const TEST_VERSION = "0.1.0";
+export interface TestPluginOpts {
+    name: string;
+    version?: string;
+    type?: 'PROVIDER' | 'DATASTORE';
+    dependencies?: Record<string, string>;
+}
+declare function testFamily(name: string): string;
+declare function testPackageName(name: string): string;
+export declare function createTempDir(prefix?: string): Promise<string>;
+export declare function createTestPlugin(baseDir: string, opts: TestPluginOpts): Promise<{
+    dir: string;
+    packageName: string;
+    family: string;
+    version: string;
+}>;
+export declare function createTestBuiltinPlugin(baseDir: string, opts: TestPluginOpts): Promise<{
+    dir: string;
+    packageName: string;
+    family: string;
+    version: string;
+}>;
+export declare function packPluginFixture(pluginDir: string): Promise<Buffer>;
+export declare function cleanupTempDir(dir: string): Promise<void>;
+export { TEST_SCOPE, TEST_VERSION, testFamily, testPackageName };
+//# sourceMappingURL=plugin.d.ts.map

package/dist/fixtures/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/fixtures/plugin.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,UAAU,kBAAkB,CAAC;AACnC,QAAA,MAAM,YAAY,UAAU,CAAC;AAE7B,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,iBAAS,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,iBAAS,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAsB,aAAa,CAAC,MAAM,SAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1E;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC;IACnF,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC,CA8CD;AAED,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC;IAC1F,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC,CAwCD;AAED,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW1E;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED,OAAO,EAAC,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAC,CAAC"}