@glubean/grpc 0.1.4 → 0.2.1

package/dist/contract/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * gRPC contract surface for @glubean/grpc 0.2.0.
+ *
+ * This module makes `@glubean/grpc` a single-package owner of both:
+ *   - Transport / test-plugin layer (existing `../index.ts`, unchanged)
+ *   - Contract adapter layer (this directory)
+ *
+ * Design rationale: "contract is a first-class citizen, not an afterthought
+ * to the transport plugin." See
+ * `internal/00-product/positioning-v3.md` §12.0 resolved
+ * and `internal/40-discovery/proposals/contract-grpc-graphql-expansion.md` §5.1.
+ *
+ * Side-effect on import:
+ *   1. Register grpcAdapter so `contract.register("grpc", grpcAdapter)` wires
+ *      the dispatcher (contract.grpc becomes the generic dispatcher).
+ *   2. Wrap dispatcher with createGrpcRoot so `contract.grpc.with(name, ...)`
+ *      is available (parallel to HTTP's bootstrap in packages/sdk/src/index.ts
+ *      lines 1618-1624).
+ *
+ * After this module loads, users can:
+ *
+ *   import "@glubean/grpc"; // side-effect: registers grpc contract adapter
+ *   import { contract } from "@glubean/sdk";
+ *
+ *   const paymentContracts = contract.grpc.with("payment", { client });
+ *   export const completePayment = paymentContracts("complete-payment", {
+ *     target: "PaymentService/Complete",
+ *     cases: { ok: { description: "...", expect: { statusCode: 0 } } },
+ *   });
+ */
+export { grpcAdapter } from "./adapter.js";
+export { createGrpcFactory, createGrpcRoot } from "./factory.js";
+export type { GrpcContractCase, GrpcContractDefaults, GrpcContractExample, GrpcContractExpect, GrpcContractFactory, GrpcContractMeta, GrpcContractRoot, GrpcContractSafeMeta, GrpcContractSpec, GrpcCaseResult, GrpcFlowCaseOutput, GrpcPayloadSchemas, GrpcSafeSchemas, InferGrpcRequest, InferGrpcResponse, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/contract/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAwBH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACjE,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/contract/index.js

@@ -0,0 +1,50 @@
+/**
+ * gRPC contract surface for @glubean/grpc 0.2.0.
+ *
+ * This module makes `@glubean/grpc` a single-package owner of both:
+ *   - Transport / test-plugin layer (existing `../index.ts`, unchanged)
+ *   - Contract adapter layer (this directory)
+ *
+ * Design rationale: "contract is a first-class citizen, not an afterthought
+ * to the transport plugin." See
+ * `internal/00-product/positioning-v3.md` §12.0 resolved
+ * and `internal/40-discovery/proposals/contract-grpc-graphql-expansion.md` §5.1.
+ *
+ * Side-effect on import:
+ *   1. Register grpcAdapter so `contract.register("grpc", grpcAdapter)` wires
+ *      the dispatcher (contract.grpc becomes the generic dispatcher).
+ *   2. Wrap dispatcher with createGrpcRoot so `contract.grpc.with(name, ...)`
+ *      is available (parallel to HTTP's bootstrap in packages/sdk/src/index.ts
+ *      lines 1618-1624).
+ *
+ * After this module loads, users can:
+ *
+ *   import "@glubean/grpc"; // side-effect: registers grpc contract adapter
+ *   import { contract } from "@glubean/sdk";
+ *
+ *   const paymentContracts = contract.grpc.with("payment", { client });
+ *   export const completePayment = paymentContracts("complete-payment", {
+ *     target: "PaymentService/Complete",
+ *     cases: { ok: { description: "...", expect: { statusCode: 0 } } },
+ *   });
+ */
+import { contract } from "@glubean/sdk";
+import { grpcAdapter } from "./adapter.js";
+import { createGrpcRoot } from "./factory.js";
+import { registerGrpcMatchers } from "./matchers.js";
+// Step 1: register the adapter. After this, `contract.grpc` exists as the
+// generic dispatcher attached by `contract.register()`.
+contract.register("grpc", grpcAdapter);
+// Step 2: wrap dispatcher with the scoped-defaults factory so
+// `contract.grpc.with(name, defaults)` UX works.
+{
+    const dispatcher = contract.grpc;
+    contract.grpc = createGrpcRoot(dispatcher);
+}
+// Step 3: register gRPC custom matchers so
+// `ctx.expect(res).toHaveGrpcStatus(0)` works out of the box.
+registerGrpcMatchers();
+// Re-exports for type consumers who import from the package directly.
+export { grpcAdapter } from "./adapter.js";
+export { createGrpcFactory, createGrpcRoot } from "./factory.js";
+//# sourceMappingURL=index.js.map

package/dist/contract/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGrD,0EAA0E;AAC1E,wDAAwD;AACxD,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEvC,8DAA8D;AAC9D,iDAAiD;AACjD,CAAC;IACC,MAAM,UAAU,GAAI,QAAgB,CAAC,IAA4C,CAAC;IACjF,QAAkD,CAAC,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;AACxF,CAAC;AAED,2CAA2C;AAC3C,8DAA8D;AAC9D,oBAAoB,EAAE,CAAC;AAEvB,sEAAsE;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/contract/matchers.d.ts

@@ -0,0 +1,68 @@
+/**
+ * gRPC custom matchers for `ctx.expect()`.
+ *
+ * Registered as a side effect of `import "@glubean/grpc"` (see `./index.ts`).
+ * No extra import or configure step required — the matchers become available
+ * on every `ctx.expect(res)` call and are fully typed via the
+ * `CustomMatchers<T>` declaration merging block below.
+ *
+ * Matchers work on any object that carries gRPC response shape, including:
+ *   - `GrpcCallResult` from `@glubean/grpc` transport (direct client.call)
+ *   - `GrpcCaseResult` from the contract adapter (verify callback / flow
+ *     `out` lens input)
+ *
+ * The canonical shape both produce:
+ *   {
+ *     message: T,
+ *     status: { code: number, details: string },
+ *     responseMetadata: Record<string, string>,
+ *     duration: number,
+ *   }
+ *
+ * See `packages/sdk/src/expect.ts` for the underlying `MatcherResult` /
+ * `Expectation.extend` / `CustomMatchers<T>` contracts.
+ */
+declare module "@glubean/sdk/expect" {
+    interface CustomMatchers<T> {
+        /**
+         * Assert the gRPC status code on a `GrpcCallResult` / `GrpcCaseResult`.
+         *
+         * @param code Expected gRPC status code (`0` = OK, `5` = NOT_FOUND, etc.)
+         * @param message Optional context prepended to the assertion message
+         *
+         * @example ctx.expect(res).toHaveGrpcStatus(0);
+         * @example ctx.expect(res).toHaveGrpcStatus(5, "user lookup");
+         */
+        toHaveGrpcStatus(code: number, message?: string): Expectation<T>;
+        /**
+         * Convenience: assert status code is `0` (OK).
+         * Equivalent to `toHaveGrpcStatus(0)` but reads better in test bodies.
+         *
+         * @example ctx.expect(res).toHaveGrpcOk();
+         */
+        toHaveGrpcOk(message?: string): Expectation<T>;
+        /**
+         * Assert presence (and optionally value) of a key in response metadata.
+         *
+         * @param key Metadata key (case-insensitive per gRPC spec; compared as lowercased)
+         * @param value Optional exact expected value; when omitted, only presence is checked
+         * @param message Optional context prepended to the assertion message
+         *
+         * @example ctx.expect(res).toHaveGrpcMetadata("x-request-id");
+         * @example ctx.expect(res).toHaveGrpcMetadata("x-tenant", "acme");
+         */
+        toHaveGrpcMetadata(key: string, value?: string, message?: string): Expectation<T>;
+    }
+}
+/**
+ * Register gRPC matchers onto the shared `Expectation` prototype. Called
+ * from `./index.ts` during the same side-effect block that registers the
+ * contract adapter; users get matchers + adapter from a single
+ * `import "@glubean/grpc"`.
+ *
+ * Idempotent: catches the "matcher already exists" error thrown by
+ * `Expectation.extend` when the module is evaluated more than once
+ * (duplicate imports, Vitest isolation boundaries, etc.).
+ */
+export declare function registerGrpcMatchers(): void;
+//# sourceMappingURL=matchers.d.ts.map

package/dist/contract/matchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../../src/contract/matchers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAQH,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,cAAc,CAAC,CAAC;QACxB;;;;;;;;WAQG;QACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAEjE;;;;;WAKG;QACH,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAE/C;;;;;;;;;WASG;QACH,kBAAkB,CAChB,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,GACf,WAAW,CAAC,CAAC,CAAC,CAAC;KACnB;CACF;AAgJD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAc3C"}

package/dist/contract/matchers.js

@@ -0,0 +1,155 @@
+/**
+ * gRPC custom matchers for `ctx.expect()`.
+ *
+ * Registered as a side effect of `import "@glubean/grpc"` (see `./index.ts`).
+ * No extra import or configure step required — the matchers become available
+ * on every `ctx.expect(res)` call and are fully typed via the
+ * `CustomMatchers<T>` declaration merging block below.
+ *
+ * Matchers work on any object that carries gRPC response shape, including:
+ *   - `GrpcCallResult` from `@glubean/grpc` transport (direct client.call)
+ *   - `GrpcCaseResult` from the contract adapter (verify callback / flow
+ *     `out` lens input)
+ *
+ * The canonical shape both produce:
+ *   {
+ *     message: T,
+ *     status: { code: number, details: string },
+ *     responseMetadata: Record<string, string>,
+ *     duration: number,
+ *   }
+ *
+ * See `packages/sdk/src/expect.ts` for the underlying `MatcherResult` /
+ * `Expectation.extend` / `CustomMatchers<T>` contracts.
+ */
+import { Expectation, inspect } from "@glubean/sdk/expect";
+function readStatusCode(actual) {
+    const s = actual?.status;
+    return typeof s?.code === "number" ? s.code : undefined;
+}
+function readStatusDetails(actual) {
+    const s = actual?.status;
+    return typeof s?.details === "string" ? s.details : undefined;
+}
+function readMetadata(actual) {
+    const md = actual?.responseMetadata;
+    return md && typeof md === "object" ? md : undefined;
+}
+function findMetadataEntry(md, key) {
+    const lower = key.toLowerCase();
+    for (const [k, v] of Object.entries(md)) {
+        if (k.toLowerCase() === lower)
+            return [k, v];
+    }
+    return undefined;
+}
+// =============================================================================
+// Matcher implementations
+// =============================================================================
+const toHaveGrpcStatus = (actual, ...args) => {
+    const code = args[0];
+    const actualCode = readStatusCode(actual);
+    const details = readStatusDetails(actual);
+    if (actualCode === undefined) {
+        return {
+            passed: false,
+            message: `to have gRPC status ${code} — actual has no \`.status.code\` (got ${inspect(actual)})`,
+            actual,
+            expected: code,
+        };
+    }
+    return {
+        passed: actualCode === code,
+        message: details
+            ? `to have gRPC status ${code} (got ${actualCode}: ${details})`
+            : `to have gRPC status ${code}`,
+        actual: actualCode,
+        expected: code,
+    };
+};
+const toHaveGrpcOk = (actual) => {
+    const actualCode = readStatusCode(actual);
+    const details = readStatusDetails(actual);
+    if (actualCode === undefined) {
+        return {
+            passed: false,
+            message: `to have gRPC status OK (0) — actual has no \`.status.code\``,
+            actual,
+            expected: 0,
+        };
+    }
+    return {
+        passed: actualCode === 0,
+        message: details
+            ? `to have gRPC status OK (0) (got ${actualCode}: ${details})`
+            : `to have gRPC status OK (0)`,
+        actual: actualCode,
+        expected: 0,
+    };
+};
+const toHaveGrpcMetadata = (actual, ...args) => {
+    const key = args[0];
+    const expectedValue = args[1];
+    const md = readMetadata(actual);
+    if (!md) {
+        return {
+            passed: false,
+            message: `to have gRPC metadata \`${key}\` — actual has no \`.responseMetadata\``,
+            actual,
+            expected: expectedValue !== undefined ? { [key]: expectedValue } : key,
+        };
+    }
+    const entry = findMetadataEntry(md, key);
+    if (!entry) {
+        return {
+            passed: false,
+            message: `to have gRPC metadata \`${key}\``,
+            actual: md,
+            expected: expectedValue !== undefined ? { [key]: expectedValue } : key,
+        };
+    }
+    if (expectedValue === undefined) {
+        return {
+            passed: true,
+            message: `to have gRPC metadata \`${key}\``,
+            actual: entry[1],
+            expected: key,
+        };
+    }
+    return {
+        passed: entry[1] === expectedValue,
+        message: `to have gRPC metadata \`${key}\` = ${inspect(expectedValue)}`,
+        actual: entry[1],
+        expected: expectedValue,
+    };
+};
+// =============================================================================
+// Registration — side effect
+// =============================================================================
+/**
+ * Register gRPC matchers onto the shared `Expectation` prototype. Called
+ * from `./index.ts` during the same side-effect block that registers the
+ * contract adapter; users get matchers + adapter from a single
+ * `import "@glubean/grpc"`.
+ *
+ * Idempotent: catches the "matcher already exists" error thrown by
+ * `Expectation.extend` when the module is evaluated more than once
+ * (duplicate imports, Vitest isolation boundaries, etc.).
+ */
+export function registerGrpcMatchers() {
+    try {
+        Expectation.extend({
+            toHaveGrpcStatus,
+            toHaveGrpcOk,
+            toHaveGrpcMetadata,
+        });
+    }
+    catch (err) {
+        if (err instanceof Error && /already exists/.test(err.message)) {
+            // Idempotent — re-import in a second harness instance is fine.
+            return;
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=matchers.js.map

package/dist/contract/matchers.js.map

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

package/dist/contract/types.d.ts

@@ -0,0 +1,238 @@
+/**
+ * gRPC contract types.
+ *
+ * User-facing authoring types + adapter-level payload types for the
+ * gRPC contract adapter (single-package model — see
+ * `internal/40-discovery/proposals/contract-grpc-graphql-expansion.md` §5.1).
+ *
+ * Structure mirrors `packages/sdk/src/contract-http/types.ts` where
+ * applicable, with gRPC-specific semantics:
+ *   - Target is "Service/Method" (wire format); renderTarget → "Service.Method"
+ *   - Status codes are gRPC 0-16 (not HTTP 4xx/5xx)
+ *   - Metadata replaces HTTP headers (metadata carries both ingress + egress)
+ *   - Deadlines replace HTTP timeouts (ms)
+ *   - Phase 1 scope: unary RPCs only (no streaming)
+ */
+import type { SchemaLike, TestContext } from "@glubean/sdk";
+import type { CaseDefaultRun, CaseRequires, CaseSeverity, Extensions } from "@glubean/sdk";
+import type { GrpcClient } from "../index.js";
+/**
+ * Defaults for a gRPC contract instance (contract.grpc.with("name", {...})).
+ *
+ * Note: connection-level settings (address, TLS, proto path) are owned by
+ * the transport plugin (configure({grpc: grpc({proto, address, ...})})).
+ * The contract-layer instance only captures content defaults that apply
+ * across contracts authored under this instance.
+ */
+export interface GrpcContractDefaults {
+    /** Default gRPC client for all contracts in this instance. */
+    client?: GrpcClient;
+    /** Tags inherited by all contracts in this instance. */
+    tags?: string[];
+    /** Default feature grouping key. */
+    feature?: string;
+    /** Default metadata for all contracts (merged per-case). */
+    metadata?: Record<string, string>;
+    /** Default deadline in ms for all contracts in this instance. */
+    deadlineMs?: number;
+    /** OpenAPI-style extensions (x-* keys). Inherited by all contracts. */
+    extensions?: Extensions;
+}
+export interface GrpcContractExample<T = unknown> {
+    value: T;
+    summary?: string;
+    description?: string;
+}
+/**
+ * Response expectations for a gRPC case.
+ *
+ * `statusCode` is the gRPC canonical status (0 = OK, 3 = INVALID_ARGUMENT,
+ * 5 = NOT_FOUND, 7 = PERMISSION_DENIED, 14 = UNAVAILABLE, 16 = UNAUTHENTICATED,
+ * etc.). Phase 1 default: `0` (OK) when not specified.
+ */
+export interface GrpcContractExpect<T = unknown> {
+    /** Expected gRPC status code (0 = OK). Default: 0 when omitted. */
+    statusCode?: number;
+    /** Zod/Valibot schema for response message (when statusCode === 0). */
+    schema?: SchemaLike<T>;
+    /** Partial expected message shape (object — `toMatchObject` semantics). */
+    message?: Partial<T>;
+    /** Schema for response metadata (trailing). */
+    metadata?: SchemaLike<Record<string, string>>;
+    /** Partial expected response metadata. */
+    metadataMatch?: Record<string, string>;
+    /** Single response example (for docs / projection). */
+    example?: T;
+    /** Named response examples. */
+    examples?: Record<string, GrpcContractExample<T>>;
+}
+/**
+ * One case on a gRPC contract.
+ *
+ * Function-valued fields (`request`, `metadata`) reference case-local setup
+ * state. In flow mode these are rejected by `validateCaseForFlow` (same
+ * discipline as HTTP's function-valued body/params/query/headers).
+ */
+export interface GrpcContractCase<Req = unknown, Res = unknown, S = void> {
+    /** Per-case gRPC client override. */
+    client?: GrpcClient;
+    /** Why this case exists — required. */
+    description: string;
+    /** Expected response. */
+    expect?: GrpcContractExpect<Res>;
+    /**
+     * Request message. Object shorthand or a function of setup state.
+     * Merged deep-style over contract `defaults.request`.
+     */
+    request?: Req | ((state: S) => Req);
+    /** Per-call metadata (merged with instance + contract defaults). */
+    metadata?: Record<string, string> | ((state: S) => Record<string, string>);
+    /** Per-call deadline in ms (overrides instance / contract defaults). */
+    deadlineMs?: number;
+    /** Setup runs before the call. Return value flows to request/metadata fn + teardown. */
+    setup?: (ctx: TestContext) => Promise<S>;
+    /** Teardown runs after verify, even on failure. */
+    teardown?: (ctx: TestContext, state: S) => Promise<void>;
+    /** Business-logic verify — runs after status + schema + message match. */
+    verify?: (ctx: TestContext, res: GrpcCaseResult<Res>) => void | Promise<void>;
+    /** Not yet executable; reason shown in skip message. */
+    deferred?: string;
+    /** Deprecated; value is the reason. */
+    deprecated?: string;
+    /** Additional tags (merged with contract-level tags). */
+    tags?: string[];
+    severity?: CaseSeverity;
+    requires?: CaseRequires;
+    defaultRun?: CaseDefaultRun;
+    /** Per-case extensions. */
+    extensions?: Extensions;
+}
+/**
+ * Result of running a single case. This is also the `CaseOutput` shape that
+ * flow `step.out(state, res)` lens receives.
+ *
+ * Mirrors `@glubean/grpc`'s `GrpcCallResult<T>` but nested under a contract-
+ * layer shape so adapter-layer additions (e.g. assertion diagnostics) can
+ * grow independently.
+ */
+export interface GrpcCaseResult<Res = unknown> {
+    /** Decoded response message. */
+    message: Res;
+    /** gRPC status. `code` is 0 for OK. */
+    status: {
+        code: number;
+        details: string;
+    };
+    /** Response (trailing) metadata. */
+    responseMetadata: Record<string, string>;
+    /** Duration in ms. */
+    duration: number;
+}
+/**
+ * User-facing gRPC contract specification.
+ *
+ * `target` is the wire-format "Service/Method" string (e.g. "PaymentService/
+ * Complete"). `renderTarget` will display as "PaymentService.Complete" in
+ * UI but wire format stays as source of truth.
+ *
+ * Contract identity = contract id (string) + case key. Target is a display
+ * hint, NOT an identity — proposal §5.3.
+ */
+export interface GrpcContractSpec<Req = unknown, Res = unknown, Cases extends Record<string, GrpcContractCase<Req, Res, any>> = Record<string, GrpcContractCase<Req, Res>>> {
+    /** Wire-format target: "ServiceName/MethodName". */
+    target: string;
+    /** Default gRPC client for all cases. */
+    client?: GrpcClient;
+    description?: string;
+    feature?: string;
+    /** Contract-level request schema (OpenAPI-style docs + possible runtime validation). */
+    requestSchema?: SchemaLike<Req>;
+    /** Contract-level default request (merged under each case's request). */
+    defaultRequest?: Partial<Req>;
+    /** Contract-level default metadata (merged under each case's metadata). */
+    defaultMetadata?: Record<string, string>;
+    /** Contract-level default deadline (ms). */
+    deadlineMs?: number;
+    tags?: string[];
+    deprecated?: string;
+    extensions?: Extensions;
+    /** Named spec cases. */
+    cases: Cases;
+}
+/**
+ * Runtime (live) payload shape for the gRPC adapter. Contains SchemaLike
+ * references. Converted to GrpcSafeSchemas by adapter.normalize.
+ */
+export interface GrpcPayloadSchemas {
+    request?: SchemaLike<unknown>;
+    response?: SchemaLike<unknown>;
+    metadata?: SchemaLike<Record<string, string>>;
+    /** Request examples (for docs / projection). */
+    requestExample?: unknown;
+    requestExamples?: Record<string, GrpcContractExample<unknown>>;
+}
+/**
+ * JSON-safe payload shape. Produced by adapter.normalize.
+ * SchemaLike references are converted to JSON Schema fragments.
+ */
+export interface GrpcSafeSchemas {
+    request?: Record<string, unknown>;
+    response?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    requestExample?: unknown;
+    requestExamples?: Record<string, GrpcContractExample<unknown>>;
+}
+/**
+ * Runtime contract-level meta. Carried on the projection so scanner / MCP /
+ * Cloud can surface structural info without needing the live spec.
+ *
+ * Note: `.proto` file path is intentionally NOT stored here (execution log
+ * OQ-2 decision 2026-04-20). The proto path is a runtime transport concern
+ * owned by `configure({grpc: grpc({proto: ...})})`, not by the contract.
+ * Contract is protocol-idea-level, transport config is deployment-level.
+ */
+export interface GrpcContractMeta {
+    /** Raw target "Service/Method". */
+    target: string;
+    /** Parsed service name ("PaymentService"). */
+    service: string;
+    /** Parsed method name ("Complete"). */
+    method: string;
+    /** Contract-level default metadata (for projection display). */
+    defaultMetadata?: Record<string, string>;
+    /** Contract-level deadline (for projection display). */
+    deadlineMs?: number;
+    /** Contract instance name (contract.grpc.with("name")). */
+    instanceName?: string;
+}
+/**
+ * JSON-safe meta. Same as runtime meta (no live references).
+ */
+export type GrpcContractSafeMeta = GrpcContractMeta;
+/**
+ * What `executeCaseInFlow` returns, and what flow `step.out(state, res)`
+ * receives in its `res` parameter. Mirrors `GrpcCaseResult` — kept as a
+ * distinct export to make the flow-output contract explicit (parallel to
+ * HTTP's `HttpFlowCaseOutput` convention).
+ */
+export type GrpcFlowCaseOutput<Res = unknown> = GrpcCaseResult<Res>;
+/**
+ * Signature of `contract.grpc.with("name", defaults)`. Returns a contract
+ * factory that creates contracts under this instance's defaults.
+ *
+ * Actual implementation in `./factory.ts` (CG-4).
+ */
+export type GrpcContractRoot = {
+    with: (instanceName: string, defaults?: GrpcContractDefaults) => GrpcContractFactory;
+};
+export type GrpcContractFactory = <Req, Res, Cases extends Record<string, GrpcContractCase<Req, Res, any>>>(id: string, spec: GrpcContractSpec<Req, Res, Cases>) => unknown;
+/**
+ * Infer request type from a GrpcContractCase. Placeholder for future
+ * ergonomic inference helpers parallel to HTTP's InferHttpInputs.
+ */
+export type InferGrpcRequest<C> = C extends GrpcContractCase<infer Req, any, any> ? Req : never;
+/**
+ * Infer response type from a GrpcContractCase.
+ */
+export type InferGrpcResponse<C> = C extends GrpcContractCase<any, infer Res, any> ? Res : never;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/contract/types.js

@@ -0,0 +1,17 @@
+/**
+ * gRPC contract types.
+ *
+ * User-facing authoring types + adapter-level payload types for the
+ * gRPC contract adapter (single-package model — see
+ * `internal/40-discovery/proposals/contract-grpc-graphql-expansion.md` §5.1).
+ *
+ * Structure mirrors `packages/sdk/src/contract-http/types.ts` where
+ * applicable, with gRPC-specific semantics:
+ *   - Target is "Service/Method" (wire format); renderTarget → "Service.Method"
+ *   - Status codes are gRPC 0-16 (not HTTP 4xx/5xx)
+ *   - Metadata replaces HTTP headers (metadata carries both ingress + egress)
+ *   - Deadlines replace HTTP timeouts (ms)
+ *   - Phase 1 scope: unary RPCs only (no streaming)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/contract/types.js.map

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

package/dist/index.d.ts

@@ -1,8 +1,17 @@
 /**
- * gRPC plugin for Glubean tests.
+ * @glubean/grpc 0.2.0 — single-package owner of both:
+ *   - Transport / test-plugin layer (this file — unchanged from 0.1.x)
+ *   - Contract adapter layer (`./contract/`, registered via side-effect import)
  *
- * Provides a thin wrapper over `@grpc/grpc-js` that simplifies
- * unary gRPC calls with auto-tracing via Glubean events.
+ * Importing this package (side-effect) registers the gRPC contract adapter:
+ *   `contract.register("grpc", grpcAdapter)` → `contract.grpc.with(...)` UX.
+ *
+ * See `./contract/index.ts` for the registration logic. See
+ * `internal/40-discovery/proposals/contract-grpc-graphql-expansion.md` §5.1
+ * for the single-package rationale ("contract is a first-class citizen").
+ *
+ * Transport (this file) — provides a thin wrapper over `@grpc/grpc-js` that
+ * simplifies unary gRPC calls with auto-tracing via Glubean events.
  *
  * ## Usage
  *
@@ -201,4 +210,7 @@ export declare const GRPC_REDACTION_SCOPES: ({
     handler: "json";
     rules?: undefined;
 })[];
+import "./contract/index.js";
+export { grpcAdapter, createGrpcFactory, createGrpcRoot, } from "./contract/index.js";
+export type { GrpcContractCase, GrpcContractDefaults, GrpcContractExample, GrpcContractExpect, GrpcContractFactory, GrpcContractMeta, GrpcContractRoot, GrpcContractSafeMeta, GrpcContractSpec, GrpcCaseResult, GrpcFlowCaseOutput, GrpcPayloadSchemas, GrpcSafeSchemas, InferGrpcRequest, InferGrpcResponse, } from "./contract/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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