@kumwe/studio-testkit 0.1.0-alpha.10

package/dist/host-testbed.d.ts

@@ -0,0 +1,71 @@
+import { HostPortFailure, type HostAdapter, type HostErrorCategory, type HostPortError, type HostPortResult, type HostRequestContext, type JsonObject, type MediaAsset, type MediaUploadAcceptedAsset, type PreviewRenderPayload, type PreviewRenderedPayload, type QualifiedName, type ResourceSearchHit, type Revision, type StableId, type StudioArtifact, type StudioWireProtocolVersion, type TelemetryEvent } from '@kumwe/studio-protocol';
+export type TestbedPortName = 'artifact' | 'localization' | 'media' | 'model' | 'permission' | 'preview' | 'recovery' | 'resource' | 'telemetry';
+export interface TestbedHostOptions {
+    /**
+     * Permits the fixture-only `studio.test/operation` wildcard used by broad
+     * unit tests. Defaults to false and MUST remain false for conformance replay.
+     */
+    allowTestOperationId?: boolean;
+    documents?: StudioArtifact[];
+    initialClockMilliseconds?: number;
+    mediaAssets?: MediaAsset[];
+    messages?: Record<string, Record<QualifiedName, string>>;
+    permissions?: QualifiedName[];
+    rateLimits?: TestbedRateLimitPolicy[];
+    render?: (payload: PreviewRenderPayload) => PreviewRenderedPayload | Promise<PreviewRenderedPayload>;
+    resources?: ResourceSearchHit[];
+    /** Exact live generation to seed before the first portable request. */
+    sessionGeneration?: Revision;
+}
+/** A deterministic fixed-window policy used by portable sequence replays. */
+export interface TestbedRateLimitPolicy {
+    maximumRequests: number;
+    operationId: QualifiedName;
+    windowMilliseconds: number;
+}
+export interface TestbedControls {
+    advanceClock(milliseconds: number): void;
+    artifactStatus(id: StableId): StudioArtifact['status'] | undefined;
+    disconnect(): void;
+    failNext(portName: TestbedPortName, operation: string, category: HostErrorCategory): void;
+    /**
+     * Standalone external-import drill. The wire protocol's media port does not
+     * yet carry the media contract's explicit external-import operation, so the
+     * testbed exercises the canonical external-URL policy here, under the same
+     * request guards as the wire ports (`failNext` targets port `media`,
+     * operation `import-external`). A candidate that fails the default policy
+     * rejects with a `validation-failed` host error that names the stable
+     * rejection reason but never echoes the candidate URL. An accepted
+     * candidate mints a deterministic asset identity in `processing` state that
+     * the media port can then serve.
+     */
+    importExternalMedia(candidate: string, context: HostRequestContext): Promise<HostPortResult<MediaUploadAcceptedAsset>>;
+    reconnect(): void;
+    recoveryEnvelope(resourceContextKey: StableId): JsonObject | undefined;
+    revisionOf(id: StableId): Revision | undefined;
+    readonly pendingPreviewRenders: number;
+    readonly previewDeliveries: readonly string[];
+    readonly sessionGeneration: Revision;
+    setPermissions(permissions: QualifiedName[]): void;
+    readonly telemetryEvents: readonly TelemetryEvent[];
+}
+export interface TestbedHost {
+    controls: TestbedControls;
+    host: HostAdapter;
+}
+export interface HostRequestContextFixtureOptions {
+    expectedRevision?: Revision;
+    idempotencyKey?: StableId;
+    locale?: string;
+    operationId?: QualifiedName;
+    protocolVersion?: StudioWireProtocolVersion;
+    requestId?: StableId;
+    resourceContextKey?: StableId;
+    sessionGeneration?: Revision;
+}
+export declare class TestbedHostError extends HostPortFailure {
+    constructor(error: HostPortError);
+}
+export declare function createHostRequestContextFixture(options?: HostRequestContextFixtureOptions): HostRequestContext;
+export declare function createTestbedHost(options?: TestbedHostOptions): TestbedHost;
+//# sourceMappingURL=host-testbed.d.ts.map

package/dist/host-testbed.d.ts.map

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