@hop-top/xrr 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/adapters/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/adapters/exec.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAUD,qBAAa,WAAY,YAAW,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC;IACpE,QAAQ,CAAC,EAAE,UAAU;IAEf,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAOpD,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO;IAIvC,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO;IAI1C,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW;IAI1C,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY;CAG7C"}

package/dist/adapters/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/adapters/exec.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAgBzC,SAAS,UAAU,CAAC,GAA4B;IAC9C,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;SACb,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,WAAW;IACb,EAAE,GAAG,MAAM,CAAC;IAErB,KAAK,CAAC,WAAW,CAAC,GAAgB;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAC9B,UAAU,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CACvD,CAAC;QACF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,YAAY,CAAC,GAAgB;QAC3B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,aAAa,CAAC,IAAkB;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc,CAAC,IAAa;QAC1B,OAAO,IAAmB,CAAC;IAC7B,CAAC;IAED,eAAe,CAAC,IAAa;QAC3B,OAAO,IAAoB,CAAC;IAC9B,CAAC;CACF"}

package/dist/adapters/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/adapters/fs.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,MAAM,IAAI,GACZ,OAAO,GACP,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,OAAO,GACP,SAAS,GACT,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAUD,qBAAa,SAAU,YAAW,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC;IAC9D,QAAQ,CAAC,EAAE,QAAQ;IAEb,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAmClD,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO;IAIrC,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAIxC,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS;IAIxC,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU;CAG3C"}

package/dist/adapters/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/adapters/fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAiCzC,SAAS,UAAU,CAAC,GAA4B;IAC9C,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;SACb,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,SAAS;IACX,EAAE,GAAG,IAAI,CAAC;IAEnB,KAAK,CAAC,WAAW,CAAC,GAAc;QAC9B,MAAM,MAAM,GAA4B;YACtC,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC;QACF,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;YAC9C,MAAM,CAAC,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC;iBACtC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC;iBACxB,MAAM,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;QACD,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACzB,CAAC;QACD,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;QACvB,CAAC;QACD,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;QACvB,CAAC;QACD,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACzB,CAAC;QACD,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACzB,CAAC;QACD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QAC3B,CAAC;QACD,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC3B,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACrD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,YAAY,CAAC,GAAc;QACzB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,aAAa,CAAC,IAAgB;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc,CAAC,IAAa;QAC1B,OAAO,IAAiB,CAAC;IAC3B,CAAC;IAED,eAAe,CAAC,IAAa;QAC3B,OAAO,IAAkB,CAAC;IAC5B,CAAC;CACF"}

package/dist/adapters/grpc.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Streaming gRPC adapter — records and replays server-, client-, and
+ * bidi-streamed RPCs through a @grpc/grpc-js client interceptor, on top of
+ * the core stream session API. See spec/cassette-format-streaming.md (gRPC
+ * Adapter Mapping) for the normative semantics.
+ *
+ * This is a recording seam, not a gRPC implementation. grpc-js composes
+ * client interceptors into a chain whose bottom link owns the channel; an
+ * interceptor returns an `InterceptingCall` wrapping the next link. The
+ * adapter dispatches on session mode at that seam:
+ *
+ *   - passthrough: return the next call untouched.
+ *   - record: wrap the next call, teeing every observed event (send frame,
+ *     recv frame, half-close, terminal) into a StreamRecording.
+ *   - replay: return an InterceptingCall over a synthetic bottom call that
+ *     never touches the channel — frames and the terminal are served from
+ *     the cassette, so no connection is attempted.
+ *
+ * Messages cross the interceptor boundary as *deserialized* objects:
+ * grpc-js serializes below the interceptor chain. Frames must hold
+ * protobuf wire bytes (spec: message_b64), so the adapter converts at the
+ * seam using the method's own codec — `requestSerialize` for sends (present
+ * on the interceptor's method_definition) and the service definition's
+ * `responseSerialize` / `responseDeserialize` for recvs. The runtime
+ * method_definition carries only the client half of the codec, which is why
+ * the adapter is constructed with the service definitions it records.
+ */
+import type { ReqStream, StreamType, StreamedInteraction } from "../stream.js";
+import type { FileSession } from "../session.js";
+/** grpc-js `StatusObject`. */
+export interface GrpcStatus {
+    code: number;
+    details: string;
+    metadata?: unknown;
+}
+/** grpc-js `InterceptingListener` (partial, as the bottom call sees it). */
+export interface GrpcListener {
+    onReceiveMetadata?: (metadata: unknown) => void;
+    onReceiveMessage?: (message: unknown) => void;
+    onReceiveStatus?: (status: GrpcStatus) => void;
+}
+/** grpc-js `InterceptingCallInterface` — the bottom-call contract. */
+export interface GrpcCall {
+    start(metadata: unknown, listener?: GrpcListener): void;
+    sendMessage(message: unknown): void;
+    sendMessageWithContext(context: unknown, message: unknown): void;
+    startRead(): void;
+    halfClose(): void;
+    cancelWithStatus(code: number, details: string): void;
+    getPeer(): string;
+    getAuthContext(): unknown;
+}
+/** The client half of a grpc-js `MethodDefinition`, as interceptors see it. */
+export interface GrpcMethodDefinition {
+    path: string;
+    requestStream: boolean;
+    responseStream: boolean;
+    requestSerialize(value: unknown): Buffer;
+    responseDeserialize(bytes: Buffer): unknown;
+    /** Present on full service definitions; absent on the interceptor's copy. */
+    responseSerialize?(value: unknown): Buffer;
+}
+/** grpc-js `InterceptorOptions`. */
+export interface GrpcInterceptorOptions {
+    method_definition: GrpcMethodDefinition;
+    [key: string]: unknown;
+}
+export type GrpcNextCall = (options: GrpcInterceptorOptions) => GrpcCall;
+/** grpc-js `Interceptor`. */
+export type GrpcInterceptor = (options: GrpcInterceptorOptions, nextCall: GrpcNextCall) => GrpcCall;
+/**
+ * The pieces of `@grpc/grpc-js` the adapter needs handed in: the
+ * `InterceptingCall` constructor (the library composes interceptor chains
+ * out of it) and the `Metadata` constructor (replay synthesizes empty
+ * metadata — the format records none).
+ */
+export interface GrpcRuntime {
+    InterceptingCall: new (nextCall: GrpcCall, requester?: unknown) => GrpcCall;
+    Metadata: new () => unknown;
+}
+/** A grpc-js `ServiceDefinition`: method name → full method definition. */
+export type GrpcServiceDefinition = Record<string, GrpcMethodDefinition>;
+/** A streamed cassette addressed by a request the recording never saw. */
+export declare class GrpcAdapterError extends Error {
+    constructor(message: string);
+}
+/** Splits "/pkg.Service/Method" into its service and method identifiers. */
+export declare function splitFullMethod(full: string): {
+    service: string;
+    method: string;
+};
+/**
+ * Maps grpc-js request/response stream flags to the spec's stream types.
+ * Unary-shaped methods (neither flag) are rejected: unary RPCs keep the v1
+ * unary format and never migrate to the stream path.
+ */
+export declare function streamTypeOf(md: GrpcMethodDefinition): StreamType;
+/**
+ * Builds the recording interceptor for a session.
+ *
+ * `services` supplies the full method definitions (including
+ * `responseSerialize`) keyed by their `path`, because the interceptor's own
+ * `method_definition` carries only the client half of the codec while recv
+ * frames must be persisted as wire bytes. Pass the `service` property of
+ * every generated client the session records (or any package definition
+ * entry); the constructor indexes them by path.
+ */
+export declare class GrpcStreamAdapter {
+    private readonly session;
+    private readonly runtime;
+    readonly id = "grpc";
+    private readonly byPath;
+    constructor(session: FileSession, runtime: GrpcRuntime, services?: GrpcServiceDefinition[]);
+    /** Indexes one service definition's methods by their full path. */
+    registerService(service: GrpcServiceDefinition): this;
+    /**
+     * The grpc-js client interceptor. Pass it as `{ interceptors: [...] }` in
+     * client options (or per call). Streamed RPCs are recorded, replayed, or
+     * passed through per session mode; unary RPCs are rejected loudly rather
+     * than silently bypassed, so a misrouted call cannot look recorded.
+     */
+    interceptor(): GrpcInterceptor;
+    /**
+     * Resolves the codec for a method: the interceptor's own definition for
+     * the request half, the registered service definition for the response
+     * half. A recv-carrying method with no registered service definition
+     * fails loudly — silently skipping recv frames would write a cassette
+     * that replays as a truncated stream.
+     */
+    private codec;
+}
+/**
+ * Internal drain hook: resolves once every queued record/replay step has
+ * settled. grpc-js's call surface is synchronous while cassette IO is not,
+ * so the adapter serializes its work on an internal chain; tests that drive
+ * a call directly (rather than through a real client's IO) await this to
+ * observe a settled call. Not part of the public API.
+ */
+export declare const drainCall: unique symbol;
+/** Awaits a call's internal chain when it exposes the drain hook. */
+export declare function drain(call: unknown): Promise<void>;
+export type { ReqStream, StreamedInteraction };
+//# sourceMappingURL=grpc.d.ts.map

package/dist/adapters/grpc.d.ts.map

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