raffel 1.0.6 → 1.0.7

package/dist/inspect/contracts.d.ts

@@ -0,0 +1,47 @@
+import type { RuntimeInspectionDiagnostic, RuntimeInspectionGraph, RuntimeInspectionTransportBinding } from './types.js';
+export type RuntimeContractTestCaseKind = 'authorized' | 'unauthorized' | 'invalid-input' | 'cross-transport';
+export interface RuntimeContractRequestTemplate {
+    headers?: Record<string, string>;
+    metadata?: Record<string, string>;
+    params?: Record<string, string>;
+    query?: Record<string, unknown>;
+    body?: unknown;
+    document?: string;
+}
+export interface RuntimeContractBindingTarget {
+    bindingId: string;
+    protocol: RuntimeInspectionTransportBinding['protocol'];
+    mode: RuntimeInspectionTransportBinding['mode'];
+    label: string;
+}
+export interface RuntimeContractTestCase {
+    id: string;
+    kind: RuntimeContractTestCaseKind;
+    title: string;
+    operationId?: string;
+    channelId?: string;
+    targets: RuntimeContractBindingTarget[];
+    request?: RuntimeContractRequestTemplate;
+    expectations: {
+        authRequired?: boolean;
+        rejectsUnauthorized?: boolean;
+        rejectsInvalidInput?: boolean;
+        alignedAcrossTransports?: boolean;
+        requestIdPropagation?: boolean;
+    };
+}
+export interface RuntimeContractTestSuite {
+    generatedAt: string;
+    summary: {
+        total: number;
+        authorized: number;
+        unauthorized: number;
+        invalidInput: number;
+        crossTransport: number;
+    };
+    checks: RuntimeContractTestCase[];
+    diagnostics: RuntimeInspectionDiagnostic[];
+}
+export declare function buildRuntimeContractTestSuite(graph: RuntimeInspectionGraph): RuntimeContractTestSuite;
+export declare function formatRuntimeContractTestSuite(suite: RuntimeContractTestSuite): string;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/inspect/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/inspect/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,2BAA2B,EAC3B,sBAAsB,EAEtB,iCAAiC,EAClC,MAAM,YAAY,CAAA;AAUnB,MAAM,MAAM,2BAA2B,GACnC,YAAY,GACZ,cAAc,GACd,eAAe,GACf,iBAAiB,CAAA;AAErB,MAAM,WAAW,8BAA8B;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,iCAAiC,CAAC,UAAU,CAAC,CAAA;IACvD,IAAI,EAAE,iCAAiC,CAAC,MAAM,CAAC,CAAA;IAC/C,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,2BAA2B,CAAA;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,4BAA4B,EAAE,CAAA;IACvC,OAAO,CAAC,EAAE,8BAA8B,CAAA;IACxC,YAAY,EAAE;QACZ,YAAY,CAAC,EAAE,OAAO,CAAA;QACtB,mBAAmB,CAAC,EAAE,OAAO,CAAA;QAC7B,mBAAmB,CAAC,EAAE,OAAO,CAAA;QAC7B,uBAAuB,CAAC,EAAE,OAAO,CAAA;QACjC,oBAAoB,CAAC,EAAE,OAAO,CAAA;KAC/B,CAAA;CACF;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAA;QACb,UAAU,EAAE,MAAM,CAAA;QAClB,YAAY,EAAE,MAAM,CAAA;QACpB,YAAY,EAAE,MAAM,CAAA;QACpB,cAAc,EAAE,MAAM,CAAA;KACvB,CAAA;IACD,MAAM,EAAE,uBAAuB,EAAE,CAAA;IACjC,WAAW,EAAE,2BAA2B,EAAE,CAAA;CAC3C;AAiPD,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,sBAAsB,GAC5B,wBAAwB,CAuB1B;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAmBtF"}

package/dist/inspect/contracts.js

@@ -0,0 +1,237 @@
+import { formatBindingLabel } from './format-utils.js';
+import { buildGraphQLDocument, createSchemaExample, createSchemaInvalidExample, extractPathParameters, getSchemaObjectExample, } from './schema-samples.js';
+function createTarget(binding) {
+    return {
+        bindingId: binding.id,
+        protocol: binding.protocol,
+        mode: binding.mode,
+        label: formatBindingLabel(binding),
+    };
+}
+function supportsInteractiveChecks(binding) {
+    return (binding.protocol === 'http'
+        || binding.protocol === 'jsonrpc'
+        || binding.protocol === 'graphql'
+        || binding.protocol === 'grpc'
+        || binding.protocol === 'websocket');
+}
+function buildRequestTemplate(operation, binding) {
+    const bodyExample = createSchemaExample(operation.schema.input);
+    const inputObject = getSchemaObjectExample(operation.schema.input);
+    const headers = {};
+    if (binding.protocol === 'http') {
+        if (binding.method && binding.method !== 'GET') {
+            headers['content-type'] = 'application/json';
+        }
+        const params = Object.fromEntries(extractPathParameters(binding.path).map((name) => [name, `example-${name}`]));
+        const query = binding.method === 'GET'
+            ? Object.fromEntries(Object.entries(inputObject).filter(([key]) => !(key in params)))
+            : {};
+        return {
+            headers,
+            params,
+            query,
+            body: binding.method === 'GET' ? undefined : bodyExample,
+        };
+    }
+    if (binding.protocol === 'jsonrpc') {
+        return {
+            headers: { 'content-type': 'application/json' },
+            metadata: {},
+            body: bodyExample,
+        };
+    }
+    if (binding.protocol === 'graphql') {
+        return {
+            headers: { 'content-type': 'application/json' },
+            document: buildGraphQLDocument(operation, binding.field ?? operation.name, binding.mode === 'query' ? 'query' : 'mutation'),
+            body: inputObject,
+        };
+    }
+    if (binding.protocol === 'grpc') {
+        return {
+            metadata: {},
+            body: bodyExample,
+        };
+    }
+    if (binding.protocol === 'websocket') {
+        return {
+            metadata: {},
+            body: bodyExample,
+        };
+    }
+    return {
+        body: bodyExample,
+    };
+}
+function buildInvalidRequestTemplate(operation, binding) {
+    const invalid = createSchemaInvalidExample(operation.schema.input);
+    const template = buildRequestTemplate(operation, binding);
+    return {
+        ...template,
+        body: invalid,
+        query: binding.protocol === 'http' && binding.method === 'GET'
+            ? { invalid }
+            : template.query,
+    };
+}
+function addOperationChecks(checks, operation) {
+    const supportedBindings = operation.transports.filter(supportsInteractiveChecks);
+    if (supportedBindings.length === 0) {
+        return;
+    }
+    const requiresAuth = !!operation.policies.effective?.auth;
+    for (const binding of supportedBindings) {
+        if (requiresAuth) {
+            checks.push({
+                id: `${operation.id}:${binding.id}:unauthorized`,
+                kind: 'unauthorized',
+                title: `${operation.name} rejects unauthorized ${binding.protocol.toUpperCase()} access`,
+                operationId: operation.id,
+                targets: [createTarget(binding)],
+                request: buildRequestTemplate(operation, binding),
+                expectations: {
+                    authRequired: true,
+                    rejectsUnauthorized: true,
+                    requestIdPropagation: true,
+                },
+            });
+            checks.push({
+                id: `${operation.id}:${binding.id}:authorized`,
+                kind: 'authorized',
+                title: `${operation.name} accepts authorized ${binding.protocol.toUpperCase()} access`,
+                operationId: operation.id,
+                targets: [createTarget(binding)],
+                request: {
+                    ...buildRequestTemplate(operation, binding),
+                    headers: {
+                        authorization: 'Bearer devx-test-token',
+                        ...(buildRequestTemplate(operation, binding).headers ?? {}),
+                    },
+                    metadata: {
+                        authorization: 'Bearer devx-test-token',
+                        ...(buildRequestTemplate(operation, binding).metadata ?? {}),
+                    },
+                },
+                expectations: {
+                    authRequired: true,
+                    requestIdPropagation: true,
+                },
+            });
+        }
+        if (operation.schema.input.present) {
+            checks.push({
+                id: `${operation.id}:${binding.id}:invalid-input`,
+                kind: 'invalid-input',
+                title: `${operation.name} rejects invalid input over ${binding.protocol.toUpperCase()}`,
+                operationId: operation.id,
+                targets: [createTarget(binding)],
+                request: buildInvalidRequestTemplate(operation, binding),
+                expectations: {
+                    rejectsInvalidInput: true,
+                    requestIdPropagation: true,
+                },
+            });
+        }
+    }
+    if (supportedBindings.length > 1) {
+        checks.push({
+            id: `${operation.id}:cross-transport`,
+            kind: 'cross-transport',
+            title: `${operation.name} stays aligned across transports`,
+            operationId: operation.id,
+            targets: supportedBindings.map(createTarget),
+            request: buildRequestTemplate(operation, supportedBindings[0]),
+            expectations: {
+                alignedAcrossTransports: true,
+                requestIdPropagation: true,
+                authRequired: requiresAuth || undefined,
+            },
+        });
+    }
+}
+function addChannelChecks(checks, channel) {
+    if (channel.auth === 'required') {
+        checks.push({
+            id: `${channel.id}:unauthorized`,
+            kind: 'unauthorized',
+            title: `${channel.name} rejects unauthorized channel access`,
+            channelId: channel.id,
+            targets: [createTarget(channel.transport)],
+            request: {
+                metadata: {},
+                body: {
+                    id: 'channel-subscribe',
+                    type: 'subscribe',
+                    channel: channel.name,
+                },
+            },
+            expectations: {
+                authRequired: true,
+                rejectsUnauthorized: true,
+            },
+        });
+        checks.push({
+            id: `${channel.id}:authorized`,
+            kind: 'authorized',
+            title: `${channel.name} accepts authorized channel access`,
+            channelId: channel.id,
+            targets: [createTarget(channel.transport)],
+            request: {
+                metadata: {
+                    authorization: 'Bearer devx-test-token',
+                },
+                body: {
+                    id: 'channel-subscribe',
+                    type: 'subscribe',
+                    channel: channel.name,
+                    metadata: {
+                        authorization: 'Bearer devx-test-token',
+                    },
+                },
+            },
+            expectations: {
+                authRequired: true,
+            },
+        });
+    }
+}
+export function buildRuntimeContractTestSuite(graph) {
+    const checks = [];
+    for (const operation of graph.operations) {
+        addOperationChecks(checks, operation);
+    }
+    for (const channel of graph.channels) {
+        addChannelChecks(checks, channel);
+    }
+    return {
+        generatedAt: new Date().toISOString(),
+        summary: {
+            total: checks.length,
+            authorized: checks.filter((check) => check.kind === 'authorized').length,
+            unauthorized: checks.filter((check) => check.kind === 'unauthorized').length,
+            invalidInput: checks.filter((check) => check.kind === 'invalid-input').length,
+            crossTransport: checks.filter((check) => check.kind === 'cross-transport').length,
+        },
+        checks,
+        diagnostics: [...graph.diagnostics],
+    };
+}
+export function formatRuntimeContractTestSuite(suite) {
+    const lines = [
+        'Raffel Contract Tests',
+        `Summary: ${suite.summary.authorized} authorized, ${suite.summary.unauthorized} unauthorized, ${suite.summary.invalidInput} invalid-input, ${suite.summary.crossTransport} cross-transport (${suite.summary.total} total)`,
+        '',
+        'Checks',
+    ];
+    if (suite.checks.length === 0) {
+        lines.push('- none');
+        return lines.join('\n');
+    }
+    for (const check of suite.checks) {
+        lines.push(`- [${check.kind}] ${check.title}`);
+        lines.push(`  targets: ${check.targets.map((target) => `${target.protocol}:${target.label}`).join(' | ')}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=contracts.js.map

package/dist/inspect/contracts.js.map

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

package/dist/inspect/format-utils.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Inspect — Shared formatting utilities
+ *
+ * Used by reports.ts, contracts.ts, and playground.ts.
+ */
+import type { RuntimeInspectionTransportBinding } from './types.js';
+/**
+ * Format a binding into a compact, readable label.
+ * E.g. "GET /users/:id", "service.Method", "query usersList"
+ */
+export declare function formatBindingLabel(binding: RuntimeInspectionTransportBinding): string;
+/**
+ * Format a binding with protocol prefix and mode suffix.
+ * E.g. "HTTP GET /users/:id [rest]", "gRPC service.Method [unary]"
+ * Used by reports.ts for verbose output.
+ */
+export declare function formatBindingFull(binding: RuntimeInspectionTransportBinding): string;
+//# sourceMappingURL=format-utils.d.ts.map

package/dist/inspect/format-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-utils.d.ts","sourceRoot":"","sources":["../../src/inspect/format-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,YAAY,CAAA;AAEnE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iCAAiC,GAAG,MAAM,CAmBrF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iCAAiC,GAAG,MAAM,CAmBpF"}

package/dist/inspect/format-utils.js

@@ -0,0 +1,55 @@
+/**
+ * Inspect — Shared formatting utilities
+ *
+ * Used by reports.ts, contracts.ts, and playground.ts.
+ */
+/**
+ * Format a binding into a compact, readable label.
+ * E.g. "GET /users/:id", "service.Method", "query usersList"
+ */
+export function formatBindingLabel(binding) {
+    switch (binding.protocol) {
+        case 'http':
+            return `${binding.method ?? 'GET'} ${binding.path ?? binding.id}`;
+        case 'grpc':
+            return `${binding.service ?? 'service'}.${binding.operation ?? binding.id}`;
+        case 'graphql':
+            return `${binding.mode} ${binding.field ?? binding.procedure ?? binding.id}`;
+        case 'jsonrpc':
+            return binding.procedure ?? binding.id;
+        case 'websocket':
+            return `${binding.mode} ${binding.path ?? '/'}`;
+        case 'tcp':
+            return binding.procedure ?? binding.id;
+        case 'udp':
+            return binding.procedure ?? binding.id;
+        default:
+            return binding.id;
+    }
+}
+/**
+ * Format a binding with protocol prefix and mode suffix.
+ * E.g. "HTTP GET /users/:id [rest]", "gRPC service.Method [unary]"
+ * Used by reports.ts for verbose output.
+ */
+export function formatBindingFull(binding) {
+    switch (binding.protocol) {
+        case 'http':
+            return `${binding.protocol.toUpperCase()} ${binding.method ?? 'GET'} ${binding.path ?? binding.id} [${binding.mode}]`;
+        case 'grpc':
+            return `gRPC ${binding.service ?? 'service'}.${binding.operation ?? binding.id} [${binding.mode}]`;
+        case 'graphql':
+            return `GraphQL ${binding.mode} ${binding.field ?? binding.procedure ?? binding.id}`;
+        case 'jsonrpc':
+            return `JSON-RPC ${binding.procedure ?? binding.id} [${binding.mode}]`;
+        case 'websocket':
+            return `WebSocket ${binding.path ?? '/'} [${binding.mode}]`;
+        case 'tcp':
+            return `TCP ${binding.procedure ?? binding.id} [${binding.mode}]`;
+        case 'udp':
+            return `UDP ${binding.procedure ?? binding.id} [${binding.mode}]`;
+        default:
+            return `${binding.protocol} ${binding.id}`;
+    }
+}
+//# sourceMappingURL=format-utils.js.map

package/dist/inspect/format-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-utils.js","sourceRoot":"","sources":["../../src/inspect/format-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA0C;IAC3E,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,MAAM;YACT,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE,EAAE,CAAA;QACnE,KAAK,MAAM;YACT,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,SAAS,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,EAAE,CAAA;QAC7E,KAAK,SAAS;YACZ,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,EAAE,CAAA;QAC9E,KAAK,SAAS;YACZ,OAAO,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,CAAA;QACxC,KAAK,WAAW;YACd,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,IAAI,GAAG,EAAE,CAAA;QACjD,KAAK,KAAK;YACR,OAAO,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,CAAA;QACxC,KAAK,KAAK;YACR,OAAO,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,CAAA;QACxC;YACE,OAAO,OAAO,CAAC,EAAE,CAAA;IACrB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA0C;IAC1E,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,MAAM;YACT,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,GAAG,CAAA;QACvH,KAAK,MAAM;YACT,OAAO,QAAQ,OAAO,CAAC,OAAO,IAAI,SAAS,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,GAAG,CAAA;QACpG,KAAK,SAAS;YACZ,OAAO,WAAW,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,EAAE,CAAA;QACtF,KAAK,SAAS;YACZ,OAAO,YAAY,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,GAAG,CAAA;QACxE,KAAK,WAAW;YACd,OAAO,aAAa,OAAO,CAAC,IAAI,IAAI,GAAG,KAAK,OAAO,CAAC,IAAI,GAAG,CAAA;QAC7D,KAAK,KAAK;YACR,OAAO,OAAO,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,GAAG,CAAA;QACnE,KAAK,KAAK;YACR,OAAO,OAAO,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,GAAG,CAAA;QACnE;YACE,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,EAAE,EAAE,CAAA;IAC9C,CAAC;AACH,CAAC"}

package/dist/inspect/index.d.ts

@@ -0,0 +1,13 @@
+export { buildRuntimeInspectionGraph, serializeRuntimeInspectionGraph, serializeRuntimeInspectionService, serializeRuntimeInspectionOperation, serializeRuntimeInspectionTransport, serializeRuntimeInspectionSchema, serializeRuntimeInspectionPolicies, serializeRuntimeInspectionChannel, serializeRuntimeInspectionDiagnostic, } from './runtime-graph.js';
+export { DEFAULT_INSPECTION_ENTRYPOINTS, resolveInspectionEntrypoint, loadRuntimeInspectionPreview, } from './loader.js';
+export { createSchemaExample, createSchemaInvalidExample, buildGraphQLDocument, extractPathParameters, } from './schema-samples.js';
+export { explainRuntimeInspectionSubject, buildRuntimeInspectionDoctorReport, shouldFailDoctorReport, formatRuntimeInspectionGraph, formatRuntimeInspectionExplanation, formatRuntimeInspectionDoctorReport, } from './reports.js';
+export { buildRuntimeContractTestSuite, formatRuntimeContractTestSuite, } from './contracts.js';
+export { createRuntimePlaygroundSnapshot, createRuntimePlaygroundServer, startRuntimePlayground, } from './playground.js';
+export type { RuntimeInspectionLoadOptions, LoadedRuntimeInspectionPreview, } from './loader.js';
+export type { RuntimeInspectionSourceKind, RuntimeInspectionSource, RuntimeInspectionGrpcHint, RuntimeInspectionOperationRegistration, RuntimeInspectionSchema, RuntimeInspectionPolicySummary, RuntimeInspectionTransport, RuntimeInspectionTransportBinding, RuntimeInspectionOperation, RuntimeInspectionChannelEvent, RuntimeInspectionChannel, RuntimeInspectionTransportHandler, RuntimeInspectionService, RuntimeInspectionDiagnosticSeverity, RuntimeInspectionDiagnostic, RuntimeInspectionGraph, } from './types.js';
+export type { RuntimeInspectionDoctorReport, RuntimeInspectionExplanation, } from './reports.js';
+export type { RuntimeContractTestCaseKind, RuntimeContractRequestTemplate, RuntimeContractBindingTarget, RuntimeContractTestCase, RuntimeContractTestSuite, } from './contracts.js';
+export type { RuntimePlaygroundEntry, RuntimePlaygroundSnapshot, RuntimePlaygroundInvokeRequest, RuntimePlaygroundSessionView, RuntimePlaygroundServerOptions, RuntimePlaygroundServer, } from './playground.js';
+export { RUNTIME_INSPECTION_GRAPH_VERSION, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inspect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,EAC/B,iCAAiC,EACjC,mCAAmC,EACnC,mCAAmC,EACnC,gCAAgC,EAChC,kCAAkC,EAClC,iCAAiC,EACjC,oCAAoC,GACrC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,+BAA+B,EAC/B,kCAAkC,EAClC,sBAAsB,EACtB,4BAA4B,EAC5B,kCAAkC,EAClC,mCAAmC,GACpC,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,+BAA+B,EAC/B,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,iBAAiB,CAAA;AAExB,YAAY,EACV,4BAA4B,EAC5B,8BAA8B,GAC/B,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,2BAA2B,EAC3B,uBAAuB,EACvB,yBAAyB,EACzB,sCAAsC,EACtC,uBAAuB,EACvB,8BAA8B,EAC9B,0BAA0B,EAC1B,iCAAiC,EACjC,0BAA0B,EAC1B,6BAA6B,EAC7B,wBAAwB,EACxB,iCAAiC,EACjC,wBAAwB,EACxB,mCAAmC,EACnC,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,2BAA2B,EAC3B,8BAA8B,EAC9B,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,sBAAsB,EACtB,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,EAC5B,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,gCAAgC,GACjC,MAAM,YAAY,CAAA"}

package/dist/inspect/index.js

@@ -0,0 +1,8 @@
+export { buildRuntimeInspectionGraph, serializeRuntimeInspectionGraph, serializeRuntimeInspectionService, serializeRuntimeInspectionOperation, serializeRuntimeInspectionTransport, serializeRuntimeInspectionSchema, serializeRuntimeInspectionPolicies, serializeRuntimeInspectionChannel, serializeRuntimeInspectionDiagnostic, } from './runtime-graph.js';
+export { DEFAULT_INSPECTION_ENTRYPOINTS, resolveInspectionEntrypoint, loadRuntimeInspectionPreview, } from './loader.js';
+export { createSchemaExample, createSchemaInvalidExample, buildGraphQLDocument, extractPathParameters, } from './schema-samples.js';
+export { explainRuntimeInspectionSubject, buildRuntimeInspectionDoctorReport, shouldFailDoctorReport, formatRuntimeInspectionGraph, formatRuntimeInspectionExplanation, formatRuntimeInspectionDoctorReport, } from './reports.js';
+export { buildRuntimeContractTestSuite, formatRuntimeContractTestSuite, } from './contracts.js';
+export { createRuntimePlaygroundSnapshot, createRuntimePlaygroundServer, startRuntimePlayground, } from './playground.js';
+export { RUNTIME_INSPECTION_GRAPH_VERSION, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/inspect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/inspect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,EAC/B,iCAAiC,EACjC,mCAAmC,EACnC,mCAAmC,EACnC,gCAAgC,EAChC,kCAAkC,EAClC,iCAAiC,EACjC,oCAAoC,GACrC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,+BAA+B,EAC/B,kCAAkC,EAClC,sBAAsB,EACtB,4BAA4B,EAC5B,kCAAkC,EAClC,mCAAmC,GACpC,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,+BAA+B,EAC/B,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,iBAAiB,CAAA;AA4CxB,OAAO,EACL,gCAAgC,GACjC,MAAM,YAAY,CAAA"}

package/dist/inspect/loader.d.ts

@@ -0,0 +1,13 @@
+import type { RuntimeInspectionGraph } from './types.js';
+export declare const DEFAULT_INSPECTION_ENTRYPOINTS: readonly ["raffel.preview.ts", "raffel.preview.mts", "raffel.preview.js", "raffel.preview.mjs", "src/server.ts", "src/server.mts", "src/server.js", "src/server.mjs", "src/index.ts", "src/index.mts", "src/index.js", "src/index.mjs", "server.ts", "server.mts", "server.js", "server.mjs"];
+export interface RuntimeInspectionLoadOptions {
+    entry?: string;
+    cwd?: string;
+}
+export interface LoadedRuntimeInspectionPreview {
+    entrypoint: string;
+    graph: RuntimeInspectionGraph;
+}
+export declare function resolveInspectionEntrypoint(options?: RuntimeInspectionLoadOptions): string;
+export declare function loadRuntimeInspectionPreview(options?: RuntimeInspectionLoadOptions): Promise<LoadedRuntimeInspectionPreview>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/inspect/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/inspect/loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAIxD,eAAO,MAAM,8BAA8B,+RAiBjC,CAAA;AAEV,MAAM,WAAW,4BAA4B;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,8BAA8B;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,sBAAsB,CAAA;CAC9B;AA0ED,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,4BAAiC,GACzC,MAAM,CAqBR;AAED,wBAAsB,4BAA4B,CAChD,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,8BAA8B,CAAC,CA2BzC"}

package/dist/inspect/loader.js

@@ -0,0 +1,115 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { serializeRuntimeInspectionGraph } from './runtime-graph.js';
+const TS_ENTRY_EXTENSIONS = new Set(['.ts', '.tsx', '.mts', '.cts']);
+export const DEFAULT_INSPECTION_ENTRYPOINTS = [
+    'raffel.preview.ts',
+    'raffel.preview.mts',
+    'raffel.preview.js',
+    'raffel.preview.mjs',
+    'src/server.ts',
+    'src/server.mts',
+    'src/server.js',
+    'src/server.mjs',
+    'src/index.ts',
+    'src/index.mts',
+    'src/index.js',
+    'src/index.mjs',
+    'server.ts',
+    'server.mts',
+    'server.js',
+    'server.mjs',
+];
+function isObject(value) {
+    return value !== null && typeof value === 'object';
+}
+function isPromiseLike(value) {
+    return isObject(value) && typeof value.then === 'function';
+}
+function isRuntimeInspectionGraph(value) {
+    return (isObject(value)
+        && typeof value.version === 'number'
+        && typeof value.generatedAt === 'string'
+        && Array.isArray(value.operations)
+        && Array.isArray(value.services)
+        && Array.isArray(value.diagnostics));
+}
+function hasPreviewMethod(value) {
+    return isObject(value) && typeof value.preview === 'function';
+}
+async function importEntrypointModule(entrypoint) {
+    const extension = path.extname(entrypoint).toLowerCase();
+    if (TS_ENTRY_EXTENSIONS.has(extension)) {
+        const { tsImport } = await import('tsx/esm/api');
+        return tsImport(entrypoint, import.meta.url);
+    }
+    return import(pathToFileURL(entrypoint).href);
+}
+async function unwrapPreviewCandidate(value, label, depth = 0) {
+    if (depth > 6 || value === undefined || value === null) {
+        return null;
+    }
+    const resolved = isPromiseLike(value) ? await value : value;
+    if (isRuntimeInspectionGraph(resolved)) {
+        return serializeRuntimeInspectionGraph(resolved);
+    }
+    if (hasPreviewMethod(resolved)) {
+        return unwrapPreviewCandidate(resolved.preview(), `${label}.preview()`, depth + 1);
+    }
+    if (typeof resolved === 'function') {
+        return unwrapPreviewCandidate(resolved(), `${label}()`, depth + 1);
+    }
+    if (!isObject(resolved)) {
+        return null;
+    }
+    for (const key of ['graph', 'preview', 'createPreview', 'server', 'app', 'default']) {
+        if (!(key in resolved))
+            continue;
+        const next = await unwrapPreviewCandidate(resolved[key], `${label}.${key}`, depth + 1);
+        if (next) {
+            return next;
+        }
+    }
+    return null;
+}
+export function resolveInspectionEntrypoint(options = {}) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    if (options.entry) {
+        const entrypoint = path.resolve(cwd, options.entry);
+        if (!existsSync(entrypoint)) {
+            throw new Error(`Inspection entrypoint not found: ${entrypoint}`);
+        }
+        return entrypoint;
+    }
+    for (const candidate of DEFAULT_INSPECTION_ENTRYPOINTS) {
+        const entrypoint = path.resolve(cwd, candidate);
+        if (existsSync(entrypoint)) {
+            return entrypoint;
+        }
+    }
+    throw new Error(`No preview entrypoint found in ${cwd}. Checked: ${DEFAULT_INSPECTION_ENTRYPOINTS.join(', ')}`);
+}
+export async function loadRuntimeInspectionPreview(options = {}) {
+    const entrypoint = resolveInspectionEntrypoint(options);
+    const moduleExports = await importEntrypointModule(entrypoint);
+    const preview = await unwrapPreviewCandidate(moduleExports.preview, 'module.preview')
+        ?? await unwrapPreviewCandidate(moduleExports.createPreview, 'module.createPreview')
+        ?? await unwrapPreviewCandidate(moduleExports.server, 'module.server')
+        ?? await unwrapPreviewCandidate(moduleExports.default, 'module.default')
+        ?? await unwrapPreviewCandidate(moduleExports, 'module');
+    if (!preview) {
+        throw new Error([
+            `No previewable export found in ${entrypoint}.`,
+            'Export one of the following:',
+            '- `export default server` where `server.preview()` exists',
+            '- `export const server = createServer(...)`',
+            '- `export const preview = () => server.preview()`',
+        ].join('\n'));
+    }
+    return {
+        entrypoint,
+        graph: preview,
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/inspect/loader.js.map

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

package/dist/inspect/playground-html.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Inspect — Playground HTML renderer
+ *
+ * Self-contained HTML template for the browser-based playground UI.
+ */
+import type { RuntimePlaygroundSnapshot } from './playground.js';
+export declare function renderPlaygroundHtml(snapshot: RuntimePlaygroundSnapshot, entrypoint: string): string;
+//# sourceMappingURL=playground-html.d.ts.map

package/dist/inspect/playground-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground-html.d.ts","sourceRoot":"","sources":["../../src/inspect/playground-html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAA;AAiBhE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,yBAAyB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAyWpG"}