@glubean/grpc 0.1.4 → 0.2.1

package/dist/contract/adapter.js

@@ -0,0 +1,503 @@
+/**
+ * Built-in gRPC contract adapter for @glubean/grpc 0.2.0.
+ *
+ * Shipped alongside the transport plugin in @glubean/grpc (single-package
+ * model — "contract is a first-class citizen"). Registered via
+ * `contract.register("grpc", grpcAdapter)` on import — see ./index.ts.
+ *
+ * Responsibilities (same interface as HTTP adapter):
+ *   - execute: run a case's setup → request → expect → verify → teardown
+ *   - executeCaseInFlow: deep-merge resolvedInputs, run case in flow mode
+ *   - validateCaseForFlow: reject function-valued request/metadata fields
+ *   - project: runtime ContractProjection<GrpcPayloadSchemas>
+ *   - normalize: runtime → JSON-safe ExtractedContractProjection
+ *   - classifyFailure: gRPC status 0-16 → FailureKind
+ *   - renderTarget: "Service/Method" → "Service.Method" (display-only)
+ *   - toMarkdown: case list
+ *   - describePayload: high-level summary for index views
+ *
+ * Phase 1 scope: unary RPCs only. Streaming deferred to Phase 2.
+ */
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Split "Service/Method" wire target into parsed parts.
+ * Returns `undefined` for malformed targets rather than throwing, so
+ * normalize + projection can tolerate hand-authored data in scanner output.
+ */
+export function parseTarget(target) {
+    const slashIdx = target.indexOf("/");
+    if (slashIdx <= 0 || slashIdx === target.length - 1)
+        return undefined;
+    return {
+        service: target.slice(0, slashIdx),
+        method: target.slice(slashIdx + 1),
+    };
+}
+/** Convert a SchemaLike to a JSON Schema fragment if possible (best-effort). */
+export function schemaToJsonSchema(schema) {
+    if (!schema || typeof schema !== "object")
+        return null;
+    // Zod v4 / Valibot pattern: `toJSONSchema` instance method.
+    const maybe = schema.toJSONSchema;
+    if (typeof maybe === "function") {
+        try {
+            const out = maybe.call(schema);
+            if (out && typeof out === "object")
+                return out;
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+/** Deep-merge two plain objects (right wins). Handles nested objects; skips arrays. */
+function deepMerge(base, override) {
+    if (!base && !override)
+        return {};
+    if (!base)
+        return { ...override };
+    if (!override)
+        return { ...base };
+    const out = { ...base };
+    for (const [k, v] of Object.entries(override)) {
+        const baseVal = base[k];
+        if (v != null &&
+            typeof v === "object" &&
+            !Array.isArray(v) &&
+            baseVal != null &&
+            typeof baseVal === "object" &&
+            !Array.isArray(baseVal)) {
+            out[k] = deepMerge(baseVal, v);
+        }
+        else {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+/** Resolve the effective gRPC client with case > spec > instance fallback. */
+function resolveClient(caseSpec, spec) {
+    const client = caseSpec.client ?? spec.client;
+    if (!client) {
+        throw new Error(`No gRPC client provided for case. Set "client" on the case or contract spec (e.g. via contract.grpc.with("name", { client: grpcPlugin })).`);
+    }
+    return client;
+}
+/** Merge metadata: instance defaults < contract defaults < case. */
+function resolveMetadata(spec, caseSpec, state) {
+    const caseMd = typeof caseSpec.metadata === "function"
+        ? caseSpec.metadata(state)
+        : caseSpec.metadata;
+    const specMd = spec.defaultMetadata;
+    if (!caseMd && !specMd)
+        return undefined;
+    return { ...(specMd ?? {}), ...(caseMd ?? {}) };
+}
+/** Resolve request with deep-merge: contract.defaultRequest < case.request. */
+function resolveRequest(spec, caseSpec, state) {
+    const caseReq = typeof caseSpec.request === "function"
+        ? caseSpec.request(state)
+        : caseSpec.request;
+    const merged = deepMerge(spec.defaultRequest, caseReq);
+    return merged;
+}
+/** Resolve deadline: case > spec > undefined. */
+function resolveDeadline(spec, caseSpec) {
+    return caseSpec.deadlineMs ?? spec.deadlineMs;
+}
+// =============================================================================
+// executeCase — standard (non-flow) case execution
+// =============================================================================
+/**
+ * Execute one gRPC contract case: setup → call → expect → verify → teardown.
+ *
+ * Teardown runs in finally even if setup returned undefined (HTTP
+ * convention — so teardown can still do cleanup that doesn't depend on
+ * setup state). See contract-flow.md Rule 1.
+ */
+async function executeCase(ctx, caseSpec, spec) {
+    const parsedTarget = parseTarget(spec.target);
+    if (!parsedTarget) {
+        throw new Error(`gRPC contract: invalid target "${spec.target}". Expected "ServiceName/MethodName".`);
+    }
+    const state = caseSpec.setup
+        ? await caseSpec.setup(ctx)
+        : undefined;
+    try {
+        const client = resolveClient(caseSpec, spec);
+        const request = resolveRequest(spec, caseSpec, state);
+        const metadata = resolveMetadata(spec, caseSpec, state);
+        const deadlineMs = resolveDeadline(spec, caseSpec);
+        const callResult = await client.call(parsedTarget.method, request, {
+            ...(metadata ? { metadata } : {}),
+            ...(deadlineMs !== undefined ? { deadlineMs } : {}),
+        });
+        const result = {
+            message: callResult.message,
+            status: callResult.status,
+            responseMetadata: callResult.responseMetadata,
+            duration: callResult.duration,
+        };
+        // Assertions
+        const expect = caseSpec.expect ?? {};
+        const expectedStatus = expect.statusCode ?? 0;
+        if (result.status.code !== expectedStatus) {
+            ctx.assert(false, `Expected gRPC status code ${expectedStatus} but got ${result.status.code} (${result.status.details})`, { actual: result.status.code, expected: expectedStatus });
+        }
+        if (expectedStatus === 0) {
+            if (expect.schema) {
+                ctx.validate(result.message, expect.schema, `response message`);
+            }
+            if (expect.message) {
+                ctx.expect(result.message).toMatchObject(expect.message);
+            }
+        }
+        if (expect.metadataMatch) {
+            ctx.expect(result.responseMetadata).toMatchObject(expect.metadataMatch);
+        }
+        if (expect.metadata) {
+            ctx.validate(result.responseMetadata, expect.metadata, `response metadata`);
+        }
+        if (caseSpec.verify) {
+            await caseSpec.verify(ctx, result);
+        }
+    }
+    finally {
+        if (caseSpec.teardown) {
+            await caseSpec.teardown(ctx, state);
+        }
+    }
+}
+// =============================================================================
+// project — runtime ContractProjection
+// =============================================================================
+function projectGrpc(spec) {
+    const parsed = parseTarget(spec.target);
+    const meta = {
+        target: spec.target,
+        service: parsed?.service ?? "",
+        method: parsed?.method ?? "",
+        defaultMetadata: spec.defaultMetadata,
+        deadlineMs: spec.deadlineMs,
+    };
+    const cases = Object.entries(spec.cases).map(([key, c]) => {
+        const casted = c;
+        const lifecycle = casted.deprecated
+            ? "deprecated"
+            : casted.deferred
+                ? "deferred"
+                : "active";
+        const schemas = {
+            request: spec.requestSchema,
+            response: casted.expect?.schema,
+            metadata: casted.expect?.metadata,
+        };
+        return {
+            key,
+            description: casted.description,
+            lifecycle,
+            severity: casted.severity ?? "warning",
+            deferredReason: casted.deferred,
+            deprecatedReason: casted.deprecated,
+            schemas,
+            tags: casted.tags,
+            extensions: casted.extensions,
+            requires: casted.requires,
+            defaultRun: casted.defaultRun,
+        };
+    });
+    return {
+        protocol: "grpc",
+        target: spec.target,
+        description: spec.description,
+        feature: spec.feature,
+        tags: spec.tags,
+        extensions: spec.extensions,
+        deprecated: spec.deprecated,
+        cases,
+        schemas: {},
+        meta,
+    };
+}
+// =============================================================================
+// normalize — runtime → JSON-safe Extracted
+// =============================================================================
+function normalizeGrpc(projection) {
+    const safeCases = projection.cases.map((c) => {
+        const s = c.schemas ?? {};
+        const safe = {
+            request: schemaToJsonSchema(s.request) ?? undefined,
+            response: schemaToJsonSchema(s.response) ?? undefined,
+            metadata: schemaToJsonSchema(s.metadata) ?? undefined,
+        };
+        return { ...c, schemas: safe };
+    });
+    return {
+        id: projection.id,
+        protocol: projection.protocol,
+        target: projection.target,
+        description: projection.description,
+        feature: projection.feature,
+        instanceName: projection.instanceName,
+        tags: projection.tags,
+        extensions: projection.extensions,
+        deprecated: projection.deprecated,
+        cases: safeCases,
+        schemas: {},
+        meta: projection.meta,
+    };
+}
+// =============================================================================
+// executeCaseInFlow — flow-mode execution
+// =============================================================================
+/**
+ * Flow-mode case execution. Called by core's FlowBuilder.step() dispatch.
+ *
+ * Core has already:
+ *   1. Computed `resolvedInputs` via `step.bindings.in(state)` (may be partial)
+ *   2. Prepared current flow state
+ *   3. Passed the live ProtocolContract (access merged scoped-factory state
+ *      via `contract._spec`)
+ *
+ * Adapter responsibilities:
+ *   1. Merge resolvedInputs (shape: { request?, metadata?, deadlineMs? })
+ *      over case static spec
+ *   2. Run case setup / call / expect / verify (Rule 1: case teardown runs in
+ *      step-local finally — contract-flow §7.3)
+ *   3. Return GrpcFlowCaseOutput (= GrpcCaseResult<Res>) for `step.out` lens
+ */
+async function executeCaseInFlowGrpc(input) {
+    const { ctx, contract: c, caseKey, resolvedInputs } = input;
+    const spec = c._spec;
+    const caseSpec = spec.cases[caseKey];
+    if (!caseSpec) {
+        throw new Error(`gRPC contract: unknown case key "${caseKey}".`);
+    }
+    const parsed = parseTarget(spec.target);
+    if (!parsed) {
+        throw new Error(`gRPC contract: invalid target "${spec.target}". Expected "ServiceName/MethodName".`);
+    }
+    // In flow mode, setup is allowed but typically unused; state type is void.
+    const state = caseSpec.setup ? await caseSpec.setup(ctx) : undefined;
+    try {
+        const client = resolveClient(caseSpec, spec);
+        // Resolve static inputs from case (reject function fields — CG-3 validate
+        // handles that; we guard here too for direct callers).
+        const staticReq = typeof caseSpec.request === "function"
+            ? undefined
+            : caseSpec.request;
+        const staticMd = typeof caseSpec.metadata === "function"
+            ? undefined
+            : caseSpec.metadata;
+        const lensInput = (resolvedInputs ?? {});
+        // Deep-merge lens request over case static + contract default
+        const mergedRequest = deepMerge(deepMerge(spec.defaultRequest, staticReq), lensInput.request);
+        const mergedMetadata = {
+            ...(spec.defaultMetadata ?? {}),
+            ...(staticMd ?? {}),
+            ...(lensInput.metadata ?? {}),
+        };
+        const deadlineMs = lensInput.deadlineMs ?? caseSpec.deadlineMs ?? spec.deadlineMs;
+        const callResult = await client.call(parsed.method, mergedRequest, {
+            ...(Object.keys(mergedMetadata).length > 0 ? { metadata: mergedMetadata } : {}),
+            ...(deadlineMs !== undefined ? { deadlineMs } : {}),
+        });
+        const result = {
+            message: callResult.message,
+            status: callResult.status,
+            responseMetadata: callResult.responseMetadata,
+            duration: callResult.duration,
+        };
+        // Assertions (same as executeCase, except allow tolerant behavior
+        // under the caller's flow orchestration)
+        const expect = caseSpec.expect ?? {};
+        const expectedStatus = expect.statusCode ?? 0;
+        if (result.status.code !== expectedStatus) {
+            ctx.assert(false, `Expected gRPC status code ${expectedStatus} but got ${result.status.code} (${result.status.details})`, { actual: result.status.code, expected: expectedStatus });
+        }
+        if (expectedStatus === 0) {
+            if (expect.schema) {
+                ctx.validate(result.message, expect.schema, `response message`);
+            }
+            if (expect.message) {
+                ctx.expect(result.message).toMatchObject(expect.message);
+            }
+        }
+        if (expect.metadataMatch) {
+            ctx.expect(result.responseMetadata).toMatchObject(expect.metadataMatch);
+        }
+        if (expect.metadata) {
+            ctx.validate(result.responseMetadata, expect.metadata, `response metadata`);
+        }
+        if (caseSpec.verify) {
+            await caseSpec.verify(ctx, result);
+        }
+        return result;
+    }
+    finally {
+        if (caseSpec.teardown) {
+            await caseSpec.teardown(ctx, state);
+        }
+    }
+}
+// =============================================================================
+// validateCaseForFlow — reject function-valued fields in flow mode
+// =============================================================================
+/**
+ * Reject cases that reference case-local setup state via function-valued
+ * `request` or `metadata` fields when used in a flow. Flow mode can't
+ * supply per-case setup state (state belongs to flow orchestration).
+ *
+ * Parallels HTTP's `validateHttpCaseForFlow` — same discipline as HTTP's
+ * function-valued body/params/query/headers rejection.
+ */
+export function validateGrpcCaseForFlow(spec, caseKey, contractId) {
+    const caseSpec = spec.cases[caseKey];
+    if (!caseSpec) {
+        throw new Error(`contract.grpc(${JSON.stringify(contractId)}).case(${JSON.stringify(caseKey)}): case not found.`);
+    }
+    const functionFields = [];
+    if (typeof caseSpec.request === "function")
+        functionFields.push("request");
+    if (typeof caseSpec.metadata === "function")
+        functionFields.push("metadata");
+    if (functionFields.length > 0) {
+        throw new Error(`contract.grpc(${JSON.stringify(contractId)}).case(${JSON.stringify(caseKey)}): ` +
+            `cannot use function-valued ${functionFields.join(" / ")} in a flow step — ` +
+            `these fields depend on case-local setup state which isn't available in flow mode. ` +
+            `Move the value into flow state and use step.in lens instead.`);
+    }
+}
+// =============================================================================
+// classifyFailure — gRPC status 0-16 → FailureKind
+// =============================================================================
+/**
+ * Classify failures based on gRPC status codes and thrown errors.
+ *
+ * Status code reference:
+ *   0 = OK
+ *   1 = CANCELLED, 4 = DEADLINE_EXCEEDED, 14 = UNAVAILABLE — transient
+ *   3 = INVALID_ARGUMENT, 9 = FAILED_PRECONDITION, 11 = OUT_OF_RANGE — client
+ *   5 = NOT_FOUND, 6 = ALREADY_EXISTS, 10 = ABORTED — semantic
+ *   7 = PERMISSION_DENIED, 16 = UNAUTHENTICATED — auth
+ *   12 = UNIMPLEMENTED, 13 = INTERNAL, 15 = DATA_LOSS, 2 = UNKNOWN, 8 = RESOURCE_EXHAUSTED — server
+ */
+function classifyGrpcFailure(input) {
+    // Look for explicit gRPC status events emitted during execution
+    const statusEvent = input.events.find((e) => e.type === "grpc_status");
+    const code = typeof statusEvent?.data?.code === "number"
+        ? statusEvent.data.code
+        : undefined;
+    if (code === undefined) {
+        // Fall back to error shape (e.g. transport timeout)
+        if (input.error instanceof Error) {
+            const name = input.error.name;
+            if (name === "TimeoutError" || name === "DeadlineExceededError") {
+                return { kind: "transient", source: "trace", retryable: true, message: "deadline exceeded" };
+            }
+            return { kind: "server", source: "trace", message: input.error.message };
+        }
+        return undefined;
+    }
+    return statusToClassification(code);
+}
+function statusToClassification(code) {
+    switch (code) {
+        case 0:
+            return undefined; // OK
+        case 1: // CANCELLED
+        case 4: // DEADLINE_EXCEEDED
+        case 14: // UNAVAILABLE
+        case 8: // RESOURCE_EXHAUSTED — backpressure / quota; retryable with backoff
+            return { kind: "transient", source: "trace", retryable: true, message: `gRPC ${code}` };
+        case 3: // INVALID_ARGUMENT
+        case 9: // FAILED_PRECONDITION
+        case 11: // OUT_OF_RANGE
+            return { kind: "client", source: "trace", message: `gRPC ${code}` };
+        case 5: // NOT_FOUND
+        case 6: // ALREADY_EXISTS
+        case 10: // ABORTED — typically optimistic-concurrency; leave as semantic
+            // but note product-specific interpretations may want transient
+            return { kind: "semantic", source: "trace", message: `gRPC ${code}` };
+        case 7: // PERMISSION_DENIED
+        case 16: // UNAUTHENTICATED
+            return { kind: "auth", source: "trace", message: `gRPC ${code}` };
+        case 2: // UNKNOWN
+        case 12: // UNIMPLEMENTED
+        case 13: // INTERNAL
+        case 15: // DATA_LOSS
+        default:
+            return { kind: "server", source: "trace", message: `gRPC ${code}` };
+    }
+}
+// =============================================================================
+// renderTarget — "Service/Method" → "Service.Method" for display
+// =============================================================================
+function renderGrpcTarget(target) {
+    const parsed = parseTarget(target);
+    if (!parsed)
+        return target;
+    return `${parsed.service}.${parsed.method}`;
+}
+// =============================================================================
+// toMarkdown — case list, no OpenAPI
+// =============================================================================
+function toMarkdownGrpc(projection) {
+    const lines = [];
+    const displayTarget = renderGrpcTarget(projection.target ?? "");
+    lines.push(`### ${projection.id} — ${displayTarget}`);
+    if (projection.description)
+        lines.push(`\n${projection.description}`);
+    if (projection.deprecated)
+        lines.push(`\n**Deprecated:** ${projection.deprecated}`);
+    if (projection.cases.length === 0) {
+        lines.push("\n_(no cases)_");
+        return lines.join("\n");
+    }
+    lines.push("\n**Cases:**\n");
+    for (const c of projection.cases) {
+        const marker = c.lifecycle === "deprecated"
+            ? " ⚠ deprecated"
+            : c.lifecycle === "deferred"
+                ? " ⏸ deferred"
+                : "";
+        lines.push(`- \`${c.key}\`${marker} — ${c.description ?? ""}`);
+        if (c.deprecatedReason)
+            lines.push(`  - deprecated: ${c.deprecatedReason}`);
+        if (c.deferredReason)
+            lines.push(`  - deferred: ${c.deferredReason}`);
+    }
+    return lines.join("\n");
+}
+// =============================================================================
+// describePayload — high-level summary for index views
+// =============================================================================
+function describeGrpcPayload(schemas) {
+    const hasRequest = schemas.request !== undefined;
+    const hasResponse = schemas.response !== undefined;
+    return {
+        hasRequest,
+        hasResponse,
+        protocol: "grpc",
+    };
+}
+// =============================================================================
+// Exported adapter
+// =============================================================================
+export const grpcAdapter = {
+    async execute(ctx, caseSpec, contractSpec) {
+        await executeCase(ctx, caseSpec, contractSpec);
+    },
+    project: projectGrpc,
+    normalize: normalizeGrpc,
+    executeCaseInFlow: executeCaseInFlowGrpc,
+    validateCaseForFlow: validateGrpcCaseForFlow,
+    classifyFailure: classifyGrpcFailure,
+    renderTarget: renderGrpcTarget,
+    toMarkdown: toMarkdownGrpc,
+    describePayload: describeGrpcPayload,
+};
+//# sourceMappingURL=adapter.js.map

package/dist/contract/adapter.js.map

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

package/dist/contract/factory.d.ts

@@ -0,0 +1,32 @@
+/**
+ * contract.grpc factory — scoped-defaults pattern.
+ *
+ * Root `contract.grpc` exposes only `.with(name, defaults)`. Calling
+ * `contract.grpc("id", spec)` directly is forbidden — client injection via
+ * scoped instances is the canonical authoring pattern (same as HTTP).
+ *
+ * The factory wraps the generic dispatcher attached to `contract.grpc` by
+ * `contract.register("grpc", grpcAdapter)`. Calls flow through:
+ *   user code
+ *     → scoped factory(id, spec)
+ *     → merge instance defaults into spec
+ *     → dispatcher(id, mergedSpec)   [generic register() output]
+ *     → adapter.project + per-case registerTest + Test[] with _projection/_spec
+ */
+import type { ProtocolContract } from "@glubean/sdk";
+import type { GrpcContractCase, GrpcContractDefaults, GrpcContractFactory, GrpcContractMeta, GrpcContractRoot, GrpcContractSpec, GrpcPayloadSchemas } from "./types.js";
+type InternalDefaults = GrpcContractDefaults & {
+    _name?: string;
+};
+type GrpcDispatch = <Req, Res, Cases extends Record<string, GrpcContractCase<Req, Res, any>>>(id: string, spec: GrpcContractSpec<Req, Res, Cases>) => ProtocolContract<GrpcContractSpec, GrpcPayloadSchemas, GrpcContractMeta>;
+/**
+ * Build a scoped gRPC factory. `dispatch` is `contract.grpc` attached by the
+ * core's register() call — we wrap it to inject instance defaults.
+ */
+export declare function createGrpcFactory(dispatch: GrpcDispatch, defaults?: InternalDefaults): GrpcContractFactory;
+/**
+ * Root factory — `.with()` only, direct call throws.
+ */
+export declare function createGrpcRoot(dispatch: GrpcDispatch): GrpcContractRoot;
+export {};
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/contract/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAc,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,KAAK,gBAAgB,GAAG,oBAAoB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAElE,KAAK,YAAY,GAAG,CAClB,GAAG,EACH,GAAG,EACH,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAE7D,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,KACpC,gBAAgB,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;AAiD9E;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,mBAAmB,CA4CrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,gBAAgB,CAEvE"}

package/dist/contract/factory.js

@@ -0,0 +1,90 @@
+/**
+ * contract.grpc factory — scoped-defaults pattern.
+ *
+ * Root `contract.grpc` exposes only `.with(name, defaults)`. Calling
+ * `contract.grpc("id", spec)` directly is forbidden — client injection via
+ * scoped instances is the canonical authoring pattern (same as HTTP).
+ *
+ * The factory wraps the generic dispatcher attached to `contract.grpc` by
+ * `contract.register("grpc", grpcAdapter)`. Calls flow through:
+ *   user code
+ *     → scoped factory(id, spec)
+ *     → merge instance defaults into spec
+ *     → dispatcher(id, mergedSpec)   [generic register() output]
+ *     → adapter.project + per-case registerTest + Test[] with _projection/_spec
+ */
+function mergeExtensions(base, override) {
+    if (!base && !override)
+        return undefined;
+    const merged = {
+        ...(base ?? {}),
+        ...(override ?? {}),
+    };
+    return Object.keys(merged).length > 0 ? merged : undefined;
+}
+function mergeGrpcDefaults(defaults, spec) {
+    if (!defaults)
+        return spec;
+    const mergedTags = [...(defaults.tags ?? []), ...(spec.tags ?? [])];
+    const mergedExtensions = mergeExtensions(defaults.extensions, spec.extensions);
+    const mergedMetadata = {
+        ...(defaults.metadata ?? {}),
+        ...(spec.defaultMetadata ?? {}),
+    };
+    return {
+        ...spec,
+        client: spec.client ?? defaults.client,
+        feature: spec.feature ?? defaults.feature,
+        tags: mergedTags.length > 0 ? mergedTags : undefined,
+        extensions: mergedExtensions,
+        defaultMetadata: Object.keys(mergedMetadata).length > 0 ? mergedMetadata : undefined,
+        deadlineMs: spec.deadlineMs ?? defaults.deadlineMs,
+    };
+}
+function applyInstanceMetadata(contract, instanceName) {
+    // Mutate _projection to attach instanceName (not otherwise available to
+    // adapter.project since it doesn't know the factory defaults).
+    const proj = contract._projection;
+    proj.instanceName = instanceName;
+}
+/**
+ * Build a scoped gRPC factory. `dispatch` is `contract.grpc` attached by the
+ * core's register() call — we wrap it to inject instance defaults.
+ */
+export function createGrpcFactory(dispatch, defaults) {
+    const factory = (id, spec) => {
+        if (!defaults?._name) {
+            throw new Error(`contract.grpc("${id}", spec) is not supported. ` +
+                `Use contract.grpc.with("name", { client }) first to create a scoped instance, ` +
+                `then call instance("${id}", spec).`);
+        }
+        const merged = mergeGrpcDefaults(defaults, spec);
+        const result = dispatch(id, merged);
+        applyInstanceMetadata(result, defaults._name);
+        return result;
+    };
+    factory.with = (name, more = {}) => {
+        const mergedTags = [...(defaults?.tags ?? []), ...(more.tags ?? [])];
+        const mergedExtensions = mergeExtensions(defaults?.extensions, more.extensions);
+        const mergedMetadata = {
+            ...(defaults?.metadata ?? {}),
+            ...(more.metadata ?? {}),
+        };
+        return createGrpcFactory(dispatch, {
+            ...defaults,
+            ...more,
+            tags: mergedTags.length > 0 ? mergedTags : undefined,
+            extensions: mergedExtensions,
+            metadata: Object.keys(mergedMetadata).length > 0 ? mergedMetadata : undefined,
+            _name: name,
+        });
+    };
+    return factory;
+}
+/**
+ * Root factory — `.with()` only, direct call throws.
+ */
+export function createGrpcRoot(dispatch) {
+    return createGrpcFactory(dispatch);
+}
+//# sourceMappingURL=factory.js.map

package/dist/contract/factory.js.map

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