@rsc-kit/core 0.24.0 → 0.24.2

package/dist/conformance.d.ts

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+type Schema = Record<string, unknown>;
+/** A host-call client: the real one in a run, the test host's in core's own test. */
+export type ConformanceCall = (name: string, ...args: unknown[]) => Promise<unknown>;
+export interface ConformanceOptions {
+    /** The adapter's host-call endpoint, e.g. http://127.0.0.1:8080/__rsc/host-call. */
+    endpoint: string;
+    /** The secret the adapter checks. */
+    secret: string;
+    /** The adapter's rsc-host.json, parsed or as a path: its types are checked against what arrives. */
+    manifest?: string | {
+        functions?: string[];
+        types?: Record<string, {
+            result?: Schema;
+        }>;
+        defs?: Record<string, Schema>;
+    };
+    /** For a test: the fetch the client uses. */
+    fetch?: typeof fetch;
+}
+export interface ConformanceResult {
+    case: string;
+    ok: boolean;
+    /** What went wrong, when it did. */
+    detail?: string;
+}
+/**
+ * What the adapter registers, and what each must do. Names are fixed; how
+ * they are written is the adapter's - the point is that they are written the
+ * way an app's would be, with the adapter's ordinary API.
+ */
+export declare const CASES: {
+    readonly 'Conformance.echo': 'Return its one argument unchanged: any JSON value, nested.';
+    readonly 'Conformance.emptyList': 'Return an empty list of objects, the way the language makes "no rows" (Go: a nil slice).';
+    readonly 'Conformance.time': "Return the instant 2026-01-02T03:04:05Z as the language's own time value.";
+    readonly 'Conformance.noTime': "Return an absent time: a nil pointer, a null Carbon, typed as a time or nothing.";
+    readonly 'Conformance.unauthenticated': 'Refuse as not signed in, the way the framework does.';
+    readonly 'Conformance.unauthorized': 'Refuse as signed in but not allowed.';
+    readonly 'Conformance.notFound': "Refuse as not found (404), the way the framework does: Go's Refuse(404), Laravel's abort(404).";
+    readonly 'Conformance.refuse': 'Refuse with status 429 and the message "Slow down."';
+    readonly 'Conformance.invalid': 'Refuse the input: a validation error on the field "name".';
+    readonly 'Conformance.redirect': 'Send the visitor to /login.';
+    readonly 'Conformance.revalidate': 'Mark the region "orders" stale, and return "ok".';
+    readonly 'Conformance.fail': 'Fail unexpectedly: an ordinary error, not a refusal.';
+    readonly 'Conformance.authorization': "Return the request's Authorization header, as the renderer forwarded it.";
+    readonly '__rsc.middleware': 'Guards: "conformance-allow" passes; "conformance-deny" refuses; a name with no guard refuses.';
+};
+/**
+ * Run the suite against a client. Every case runs; none stops another.
+ *
+ * `revalidated` is where the client records what each call marked stale -
+ * its onRevalidate - so the revalidation case can read it.
+ */
+export declare function conformance(call: ConformanceCall, options: {
+    revalidated: string[][];
+    manifest?: ConformanceOptions['manifest'];
+    wrongSecret?: ConformanceCall;
+}): Promise<ConformanceResult[]>;
+/** Run the suite against an adapter's endpoint. */
+export declare function runConformance(options: ConformanceOptions): Promise<ConformanceResult[]>;
+/**
+ * Whether a value fits the JSON Schema subset the manifest uses. Null when it
+ * does; otherwise where and why it does not.
+ */
+export declare function conformsTo(value: unknown, schema: Schema, defs: Record<string, Schema>, at: string): string | null;
+/** Print a result table, and say whether the adapter conforms. */
+export declare function report(results: ConformanceResult[]): boolean;
+export {};

package/dist/conformance.js

@@ -0,0 +1,309 @@
+#!/usr/bin/env node
+// The contract every backend adapter keeps, as a suite it runs against itself.
+//
+// A backend answers rpc(), actions and guards over one endpoint, and every
+// difference between how it and the engine read that wire is a bug in an
+// app that nobody wrote: a nil slice arriving as null where the type said a
+// list, a timestamp the type called unknown, a refusal that did not come out
+// as the error a page checks for. Each was found by an app, one at a time.
+// This finds them before an adapter ships.
+//
+// The adapter registers the Conformance.* functions described in CASES, in
+// its own language, the way an app would write them; this calls them through
+// the real client and checks what arrives. Where the adapter's manifest types
+// a function, every value it sends is checked against that type too.
+//
+//     rsc-kit-conformance --endpoint http://127.0.0.1:8080/__rsc/host-call \
+//       --secret test-secret --manifest rsc-host.json
+//
+// The test host's hostReply passes the same suite (conformance.test.ts), so
+// a page test faking the backend fakes what a real adapter does.
+import { readFileSync } from 'node:fs';
+import { argv, exit, stderr, stdout } from 'node:process';
+import { pathToFileURL } from 'node:url';
+import { httpHostCalls } from './hostCalls.js';
+import { isNotFoundSignal } from './notFound.js';
+import { withRedirect } from './redirect.js';
+import { withRequest } from './request.js';
+import { ServerAuthenticationError, ServerAuthorizationError } from './js/errors.js';
+/**
+ * What the adapter registers, and what each must do. Names are fixed; how
+ * they are written is the adapter's - the point is that they are written the
+ * way an app's would be, with the adapter's ordinary API.
+ */
+export const CASES = {
+    'Conformance.echo': 'Return its one argument unchanged: any JSON value, nested.',
+    'Conformance.emptyList': 'Return an empty list of objects, the way the language makes "no rows" (Go: a nil slice).',
+    'Conformance.time': "Return the instant 2026-01-02T03:04:05Z as the language's own time value.",
+    'Conformance.noTime': "Return an absent time: a nil pointer, a null Carbon, typed as a time or nothing.",
+    'Conformance.unauthenticated': 'Refuse as not signed in, the way the framework does.',
+    'Conformance.unauthorized': 'Refuse as signed in but not allowed.',
+    'Conformance.notFound': "Refuse as not found (404), the way the framework does: Go's Refuse(404), Laravel's abort(404).",
+    'Conformance.refuse': 'Refuse with status 429 and the message "Slow down."',
+    'Conformance.invalid': 'Refuse the input: a validation error on the field "name".',
+    'Conformance.redirect': 'Send the visitor to /login.',
+    'Conformance.revalidate': 'Mark the region "orders" stale, and return "ok".',
+    'Conformance.fail': 'Fail unexpectedly: an ordinary error, not a refusal.',
+    'Conformance.authorization': "Return the request's Authorization header, as the renderer forwarded it.",
+    '__rsc.middleware': 'Guards: "conformance-allow" passes; "conformance-deny" refuses; a name with no guard refuses.',
+};
+const INSTANT = Date.parse('2026-01-02T03:04:05Z');
+const ECHOES = [null, 0, -1.5, 'héllo ✓ "quoted"', [1, 'a', null], { a: { b: [true, false] }, c: '' }];
+/**
+ * Run the suite against a client. Every case runs; none stops another.
+ *
+ * `revalidated` is where the client records what each call marked stale -
+ * its onRevalidate - so the revalidation case can read it.
+ */
+export async function conformance(call, options) {
+    const { revalidated, manifest, wrongSecret } = options;
+    const results = [];
+    const types = typeof manifest === 'string' ? JSON.parse(readFileSync(manifest, 'utf-8')) : manifest;
+    const check = async (name, run) => {
+        try {
+            await run();
+            results.push({ case: name, ok: true });
+        }
+        catch (error) {
+            results.push({ case: name, ok: false, detail: error instanceof Error ? error.message : String(error) });
+        }
+    };
+    const expect = (ok, detail) => {
+        if (!ok)
+            throw new Error(detail);
+    };
+    const rejection = async (run) => {
+        try {
+            const value = await run();
+            throw new Error('answered ' + JSON.stringify(value) + ' instead of refusing');
+        }
+        catch (error) {
+            return error;
+        }
+    };
+    /** The value against the type the adapter's manifest declares, when it declares one. */
+    const typed = (name, value) => {
+        const schema = types?.types?.[name]?.result;
+        if (!schema)
+            return;
+        const problem = conformsTo(value, schema, types?.defs ?? {}, 'result');
+        expect(problem === null, `the manifest types ${name}'s result, and what arrived does not fit it: ${problem}`);
+    };
+    await check('the manifest lists every Conformance function', async () => {
+        if (!types)
+            return;
+        const missing = Object.keys(CASES).filter((n) => !n.startsWith('__') && !types.functions?.includes(n));
+        expect(missing.length === 0, 'not in functions: ' + missing.join(', '));
+    });
+    await check('a value of any JSON shape comes back unchanged', async () => {
+        for (const value of ECHOES) {
+            const back = await call('Conformance.echo', value);
+            expect(JSON.stringify(back) === JSON.stringify(value), `sent ${JSON.stringify(value)}, got ${JSON.stringify(back)}`);
+        }
+    });
+    await check('"no rows" is an empty list, never null', async () => {
+        const value = await call('Conformance.emptyList');
+        expect(Array.isArray(value) && value.length === 0, 'got ' + JSON.stringify(value));
+        typed('Conformance.emptyList', value);
+    });
+    await check('a time is an ISO 8601 string of the same instant', async () => {
+        const value = await call('Conformance.time');
+        expect(typeof value === 'string' && Date.parse(value) === INSTANT, 'got ' + JSON.stringify(value));
+        typed('Conformance.time', value);
+    });
+    await check('an absent time is null', async () => {
+        const value = await call('Conformance.noTime');
+        expect(value === null, 'got ' + JSON.stringify(value));
+        typed('Conformance.noTime', value);
+    });
+    await check('not signed in is the engine\'s ServerAuthenticationError', async () => {
+        const error = await rejection(() => call('Conformance.unauthenticated'));
+        expect(error instanceof ServerAuthenticationError, 'got ' + String(error));
+    });
+    await check('not allowed is the engine\'s ServerAuthorizationError', async () => {
+        const error = await rejection(() => call('Conformance.unauthorized'));
+        expect(error instanceof ServerAuthorizationError, 'got ' + String(error));
+    });
+    await check('not found is the engine\'s notFound()', async () => {
+        const error = await rejection(() => call('Conformance.notFound'));
+        expect(isNotFoundSignal(error), 'got ' + String(error));
+    });
+    await check('a refusal keeps its status and its message', async () => {
+        const error = (await rejection(() => call('Conformance.refuse')));
+        expect(error.refusalStatus === 429, 'status ' + String(error.refusalStatus));
+        expect(String(error.message).includes('Slow down.'), 'message ' + JSON.stringify(error.message));
+    });
+    await check('refused input names its field', async () => {
+        const error = (await rejection(() => call('Conformance.invalid')));
+        expect(Array.isArray(error.errors?.name) && error.errors.name.length > 0, 'errors ' + JSON.stringify(error.errors));
+    });
+    await check('a redirect is the engine\'s redirect, to where it said', async () => {
+        const taken = await withRedirect(async (seen) => {
+            await rejection(() => call('Conformance.redirect'));
+            return seen();
+        });
+        expect(taken?.location === '/login', 'redirect ' + JSON.stringify(taken));
+        expect(taken.status >= 300 && taken.status < 400, 'status ' + taken?.status);
+    });
+    await check('a revalidation rides with the result', async () => {
+        const value = await call('Conformance.revalidate');
+        expect(value === 'ok', 'got ' + JSON.stringify(value));
+        expect(revalidated.some((r) => r.includes('orders')), 'revalidated ' + JSON.stringify(revalidated));
+    });
+    await check('an unexpected failure is an error, not a refusal', async () => {
+        const error = (await rejection(() => call('Conformance.fail')));
+        expect(error instanceof Error && !(error instanceof ServerAuthenticationError) && !(error instanceof ServerAuthorizationError) && !error.refusalStatus && !isNotFoundSignal(error), 'got ' + String(error));
+    });
+    await check('the visitor\'s Authorization header is forwarded', async () => {
+        const value = await withRequest(new Request('https://app.test/', { headers: { authorization: 'Bearer conformance' } }), () => call('Conformance.authorization'));
+        expect(value === 'Bearer conformance', 'got ' + JSON.stringify(value));
+    });
+    await check('calls in one batch are each answered, a refusal only its own', async () => {
+        const [a, b, c] = await Promise.allSettled([
+            call('Conformance.echo', 1),
+            call('Conformance.unauthenticated'),
+            call('Conformance.echo', 2),
+        ]);
+        expect(a.status === 'fulfilled' && a.value === 1, 'first ' + JSON.stringify(a));
+        expect(b.status === 'rejected' && b.reason instanceof ServerAuthenticationError, 'second ' + String(b.reason));
+        expect(c.status === 'fulfilled' && c.value === 2, 'third ' + JSON.stringify(c));
+    });
+    await check('a guard that passes answers true', async () => {
+        const value = await call('__rsc.middleware', ['conformance-allow']);
+        expect(value === true, 'got ' + JSON.stringify(value));
+    });
+    await check('a guard that refuses refuses', async () => {
+        const value = await call('__rsc.middleware', ['conformance-deny']).catch((e) => e);
+        expect(value !== true, 'it answered true');
+    });
+    await check('a guard nobody registered refuses: fail closed', async () => {
+        const value = await call('__rsc.middleware', ['conformance-nobody-registered-this']).catch((e) => e);
+        expect(value !== true, 'it answered true');
+    });
+    if (wrongSecret) {
+        await check('a call with the wrong secret is refused', async () => {
+            const value = await wrongSecret('Conformance.echo', 'should not run').catch((e) => e);
+            expect(value !== 'should not run', 'it ran');
+        });
+    }
+    return results;
+}
+/** Run the suite against an adapter's endpoint. */
+export async function runConformance(options) {
+    const revalidated = [];
+    const client = (secret) => httpHostCalls({
+        endpoint: options.endpoint,
+        secret,
+        fetch: options.fetch,
+        onRevalidate: (targets) => revalidated.push(targets),
+    });
+    return await conformance(client(options.secret), {
+        revalidated,
+        manifest: options.manifest,
+        wrongSecret: client(options.secret + '-wrong'),
+    });
+}
+/**
+ * Whether a value fits the JSON Schema subset the manifest uses. Null when it
+ * does; otherwise where and why it does not.
+ */
+export function conformsTo(value, schema, defs, at) {
+    if (!schema || Object.keys(schema).length === 0)
+        return null;
+    const ref = schema.$ref;
+    if (typeof ref === 'string' && ref.startsWith('#/defs/')) {
+        const target = defs[ref.slice(7)];
+        return target ? conformsTo(value, target, defs, at) : `${at}: ${ref} is not in defs`;
+    }
+    if (Array.isArray(schema.anyOf)) {
+        const fits = schema.anyOf.some((s) => conformsTo(value, s, defs, at) === null);
+        return fits ? null : `${at}: ${JSON.stringify(value)} is none of ${JSON.stringify(schema.anyOf)}`;
+    }
+    if (Array.isArray(schema.enum)) {
+        return schema.enum.includes(value) ? null : `${at}: ${JSON.stringify(value)} is not one of ${JSON.stringify(schema.enum)}`;
+    }
+    const kind = Array.isArray(value) ? 'array' : value === null ? 'null' : typeof value;
+    switch (schema.type) {
+        case 'string':
+            if (kind !== 'string')
+                return `${at}: expected a string, got ${JSON.stringify(value)}`;
+            if (schema.format === 'date-time' && Number.isNaN(Date.parse(value)))
+                return `${at}: ${JSON.stringify(value)} is not a date-time`;
+            return null;
+        case 'integer':
+            return Number.isInteger(value) ? null : `${at}: expected an integer, got ${JSON.stringify(value)}`;
+        case 'number':
+            return kind === 'number' ? null : `${at}: expected a number, got ${JSON.stringify(value)}`;
+        case 'boolean':
+            return kind === 'boolean' ? null : `${at}: expected a boolean, got ${JSON.stringify(value)}`;
+        case 'null':
+            return value === null ? null : `${at}: expected null, got ${JSON.stringify(value)}`;
+        case 'array': {
+            if (kind !== 'array')
+                return `${at}: expected an array, got ${JSON.stringify(value)}`;
+            for (const [i, item] of value.entries()) {
+                const problem = conformsTo(item, schema.items, defs, `${at}[${i}]`);
+                if (problem)
+                    return problem;
+            }
+            return null;
+        }
+        case 'object': {
+            if (kind !== 'object')
+                return `${at}: expected an object, got ${JSON.stringify(value)}`;
+            const object = value;
+            const properties = (schema.properties ?? {});
+            for (const name of schema.required ?? []) {
+                if (!(name in object))
+                    return `${at}.${name}: required, and missing`;
+            }
+            for (const [name, s] of Object.entries(properties)) {
+                if (name in object) {
+                    const problem = conformsTo(object[name], s, defs, `${at}.${name}`);
+                    if (problem)
+                        return problem;
+                }
+            }
+            const extra = schema.additionalProperties;
+            if (extra && !schema.properties) {
+                for (const [name, item] of Object.entries(object)) {
+                    const problem = conformsTo(item, extra, defs, `${at}.${name}`);
+                    if (problem)
+                        return problem;
+                }
+            }
+            return null;
+        }
+        default:
+            return null;
+    }
+}
+/** Print a result table, and say whether the adapter conforms. */
+export function report(results) {
+    for (const r of results) {
+        stdout.write(`  ${r.ok ? '✓' : '✗'}  ${r.case}${r.ok ? '' : '\n       ' + r.detail}\n`);
+    }
+    const failed = results.filter((r) => !r.ok).length;
+    stdout.write(failed === 0 ? `\n  conforms: ${results.length} cases\n` : `\n  ${failed} of ${results.length} cases failed\n`);
+    return failed === 0;
+}
+// Run as a command, not when imported.
+if (import.meta.url === pathToFileURL(argv[1] ?? '').href || argv[1]?.endsWith('rsc-kit-conformance')) {
+    const flag = (name) => {
+        const at = argv.indexOf('--' + name);
+        return at === -1 ? undefined : argv[at + 1];
+    };
+    const endpoint = flag('endpoint');
+    const secret = flag('secret');
+    if (!endpoint || !secret) {
+        stderr.write('usage: rsc-kit-conformance --endpoint <url> --secret <secret> [--manifest rsc-host.json]\n');
+        exit(2);
+    }
+    runConformance({ endpoint, secret, manifest: flag('manifest') })
+        .then((results) => exit(report(results) ? 0 : 1))
+        .catch((error) => {
+        stderr.write('rsc-kit-conformance: ' + (error instanceof Error ? error.message : String(error)) + '\n');
+        exit(1);
+    });
+}
+//# sourceMappingURL=conformance.js.map

package/dist/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../src/conformance.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n// The contract every backend adapter keeps, as a suite it runs against itself.\n//\n// A backend answers rpc(), actions and guards over one endpoint, and every\n// difference between how it and the engine read that wire is a bug in an\n// app that nobody wrote: a nil slice arriving as null where the type said a\n// list, a timestamp the type called unknown, a refusal that did not come out\n// as the error a page checks for. Each was found by an app, one at a time.\n// This finds them before an adapter ships.\n//\n// The adapter registers the Conformance.* functions described in CASES, in\n// its own language, the way an app would write them; this calls them through\n// the real client and checks what arrives. Where the adapter's manifest types\n// a function, every value it sends is checked against that type too.\n//\n//     rsc-kit-conformance --endpoint http://127.0.0.1:8080/__rsc/host-call \\\n//       --secret test-secret --manifest rsc-host.json\n//\n// The test host's hostReply passes the same suite (conformance.test.ts), so\n// a page test faking the backend fakes what a real adapter does.\n\nimport { readFileSync } from 'node:fs'\nimport { argv, exit, stderr, stdout } from 'node:process'\nimport { pathToFileURL } from 'node:url'\nimport { httpHostCalls } from './hostCalls.js'\nimport { isNotFoundSignal } from './notFound.js'\nimport { withRedirect } from './redirect.js'\nimport { withRequest } from './request.js'\nimport { ServerAuthenticationError, ServerAuthorizationError } from './js/errors.js'\n\ntype Schema = Record<string, unknown>\n\n/** A host-call client: the real one in a run, the test host's in core's own test. */\nexport type ConformanceCall = (name: string, ...args: unknown[]) => Promise<unknown>\n\nexport interface ConformanceOptions {\n  /** The adapter's host-call endpoint, e.g. http://127.0.0.1:8080/__rsc/host-call. */\n  endpoint: string\n  /** The secret the adapter checks. */\n  secret: string\n  /** The adapter's rsc-host.json, parsed or as a path: its types are checked against what arrives. */\n  manifest?: string | { functions?: string[]; types?: Record<string, { result?: Schema }>; defs?: Record<string, Schema> }\n  /** For a test: the fetch the client uses. */\n  fetch?: typeof fetch\n}\n\nexport interface ConformanceResult {\n  case: string\n  ok: boolean\n  /** What went wrong, when it did. */\n  detail?: string\n}\n\n/**\n * What the adapter registers, and what each must do. Names are fixed; how\n * they are written is the adapter's - the point is that they are written the\n * way an app's would be, with the adapter's ordinary API.\n */\nexport const CASES = {\n  'Conformance.echo': 'Return its one argument unchanged: any JSON value, nested.',\n  'Conformance.emptyList': 'Return an empty list of objects, the way the language makes \"no rows\" (Go: a nil slice).',\n  'Conformance.time': \"Return the instant 2026-01-02T03:04:05Z as the language's own time value.\",\n  'Conformance.noTime': \"Return an absent time: a nil pointer, a null Carbon, typed as a time or nothing.\",\n  'Conformance.unauthenticated': 'Refuse as not signed in, the way the framework does.',\n  'Conformance.unauthorized': 'Refuse as signed in but not allowed.',\n  'Conformance.notFound': \"Refuse as not found (404), the way the framework does: Go's Refuse(404), Laravel's abort(404).\",\n  'Conformance.refuse': 'Refuse with status 429 and the message \"Slow down.\"',\n  'Conformance.invalid': 'Refuse the input: a validation error on the field \"name\".',\n  'Conformance.redirect': 'Send the visitor to /login.',\n  'Conformance.revalidate': 'Mark the region \"orders\" stale, and return \"ok\".',\n  'Conformance.fail': 'Fail unexpectedly: an ordinary error, not a refusal.',\n  'Conformance.authorization': \"Return the request's Authorization header, as the renderer forwarded it.\",\n  '__rsc.middleware': 'Guards: \"conformance-allow\" passes; \"conformance-deny\" refuses; a name with no guard refuses.',\n} as const\n\nconst INSTANT = Date.parse('2026-01-02T03:04:05Z')\n\nconst ECHOES: unknown[] = [null, 0, -1.5, 'héllo ✓ \"quoted\"', [1, 'a', null], { a: { b: [true, false] }, c: '' }]\n\n/**\n * Run the suite against a client. Every case runs; none stops another.\n *\n * `revalidated` is where the client records what each call marked stale -\n * its onRevalidate - so the revalidation case can read it.\n */\nexport async function conformance(\n  call: ConformanceCall,\n  options: { revalidated: string[][]; manifest?: ConformanceOptions['manifest']; wrongSecret?: ConformanceCall },\n): Promise<ConformanceResult[]> {\n  const { revalidated, manifest, wrongSecret } = options\n  const results: ConformanceResult[] = []\n  const types = typeof manifest === 'string' ? JSON.parse(readFileSync(manifest, 'utf-8')) : manifest\n\n  const check = async (name: string, run: () => Promise<void>) => {\n    try {\n      await run()\n      results.push({ case: name, ok: true })\n    } catch (error) {\n      results.push({ case: name, ok: false, detail: error instanceof Error ? error.message : String(error) })\n    }\n  }\n\n  const expect = (ok: boolean, detail: string) => {\n    if (!ok) throw new Error(detail)\n  }\n\n  const rejection = async (run: () => Promise<unknown>): Promise<unknown> => {\n    try {\n      const value = await run()\n\n      throw new Error('answered ' + JSON.stringify(value) + ' instead of refusing')\n    } catch (error) {\n      return error\n    }\n  }\n\n  /** The value against the type the adapter's manifest declares, when it declares one. */\n  const typed = (name: string, value: unknown) => {\n    const schema = types?.types?.[name]?.result\n\n    if (!schema) return\n\n    const problem = conformsTo(value, schema, types?.defs ?? {}, 'result')\n\n    expect(problem === null, `the manifest types ${name}'s result, and what arrived does not fit it: ${problem}`)\n  }\n\n  await check('the manifest lists every Conformance function', async () => {\n    if (!types) return\n\n    const missing = Object.keys(CASES).filter((n) => !n.startsWith('__') && !types.functions?.includes(n))\n\n    expect(missing.length === 0, 'not in functions: ' + missing.join(', '))\n  })\n\n  await check('a value of any JSON shape comes back unchanged', async () => {\n    for (const value of ECHOES) {\n      const back = await call('Conformance.echo', value)\n\n      expect(JSON.stringify(back) === JSON.stringify(value), `sent ${JSON.stringify(value)}, got ${JSON.stringify(back)}`)\n    }\n  })\n\n  await check('\"no rows\" is an empty list, never null', async () => {\n    const value = await call('Conformance.emptyList')\n\n    expect(Array.isArray(value) && value.length === 0, 'got ' + JSON.stringify(value))\n    typed('Conformance.emptyList', value)\n  })\n\n  await check('a time is an ISO 8601 string of the same instant', async () => {\n    const value = await call('Conformance.time')\n\n    expect(typeof value === 'string' && Date.parse(value) === INSTANT, 'got ' + JSON.stringify(value))\n    typed('Conformance.time', value)\n  })\n\n  await check('an absent time is null', async () => {\n    const value = await call('Conformance.noTime')\n\n    expect(value === null, 'got ' + JSON.stringify(value))\n    typed('Conformance.noTime', value)\n  })\n\n  await check('not signed in is the engine\\'s ServerAuthenticationError', async () => {\n    const error = await rejection(() => call('Conformance.unauthenticated'))\n\n    expect(error instanceof ServerAuthenticationError, 'got ' + String(error))\n  })\n\n  await check('not allowed is the engine\\'s ServerAuthorizationError', async () => {\n    const error = await rejection(() => call('Conformance.unauthorized'))\n\n    expect(error instanceof ServerAuthorizationError, 'got ' + String(error))\n  })\n\n  await check('not found is the engine\\'s notFound()', async () => {\n    const error = await rejection(() => call('Conformance.notFound'))\n\n    expect(isNotFoundSignal(error), 'got ' + String(error))\n  })\n\n  await check('a refusal keeps its status and its message', async () => {\n    const error = (await rejection(() => call('Conformance.refuse'))) as Error & { refusalStatus?: number }\n\n    expect(error.refusalStatus === 429, 'status ' + String(error.refusalStatus))\n    expect(String(error.message).includes('Slow down.'), 'message ' + JSON.stringify(error.message))\n  })\n\n  await check('refused input names its field', async () => {\n    const error = (await rejection(() => call('Conformance.invalid'))) as { errors?: Record<string, string[]> }\n\n    expect(Array.isArray(error.errors?.name) && error.errors.name.length > 0, 'errors ' + JSON.stringify(error.errors))\n  })\n\n  await check('a redirect is the engine\\'s redirect, to where it said', async () => {\n    const taken = await withRedirect(async (seen) => {\n      await rejection(() => call('Conformance.redirect'))\n\n      return seen()\n    })\n\n    expect(taken?.location === '/login', 'redirect ' + JSON.stringify(taken))\n    expect(taken!.status >= 300 && taken!.status < 400, 'status ' + taken?.status)\n  })\n\n  await check('a revalidation rides with the result', async () => {\n    const value = await call('Conformance.revalidate')\n\n    expect(value === 'ok', 'got ' + JSON.stringify(value))\n    expect(revalidated.some((r) => r.includes('orders')), 'revalidated ' + JSON.stringify(revalidated))\n  })\n\n  await check('an unexpected failure is an error, not a refusal', async () => {\n    const error = (await rejection(() => call('Conformance.fail'))) as Error & { refusalStatus?: number }\n\n    expect(\n      error instanceof Error && !(error instanceof ServerAuthenticationError) && !(error instanceof ServerAuthorizationError) && !error.refusalStatus && !isNotFoundSignal(error),\n      'got ' + String(error),\n    )\n  })\n\n  await check('the visitor\\'s Authorization header is forwarded', async () => {\n    const value = await withRequest(new Request('https://app.test/', { headers: { authorization: 'Bearer conformance' } }), () =>\n      call('Conformance.authorization'),\n    )\n\n    expect(value === 'Bearer conformance', 'got ' + JSON.stringify(value))\n  })\n\n  await check('calls in one batch are each answered, a refusal only its own', async () => {\n    const [a, b, c] = await Promise.allSettled([\n      call('Conformance.echo', 1),\n      call('Conformance.unauthenticated'),\n      call('Conformance.echo', 2),\n    ])\n\n    expect(a.status === 'fulfilled' && a.value === 1, 'first ' + JSON.stringify(a))\n    expect(b.status === 'rejected' && b.reason instanceof ServerAuthenticationError, 'second ' + String((b as PromiseRejectedResult).reason))\n    expect(c.status === 'fulfilled' && c.value === 2, 'third ' + JSON.stringify(c))\n  })\n\n  await check('a guard that passes answers true', async () => {\n    const value = await call('__rsc.middleware', ['conformance-allow'])\n\n    expect(value === true, 'got ' + JSON.stringify(value))\n  })\n\n  await check('a guard that refuses refuses', async () => {\n    const value = await call('__rsc.middleware', ['conformance-deny']).catch((e: unknown) => e)\n\n    expect(value !== true, 'it answered true')\n  })\n\n  await check('a guard nobody registered refuses: fail closed', async () => {\n    const value = await call('__rsc.middleware', ['conformance-nobody-registered-this']).catch((e: unknown) => e)\n\n    expect(value !== true, 'it answered true')\n  })\n\n  if (wrongSecret) {\n    await check('a call with the wrong secret is refused', async () => {\n      const value = await wrongSecret('Conformance.echo', 'should not run').catch((e: unknown) => e)\n\n      expect(value !== 'should not run', 'it ran')\n    })\n  }\n\n  return results\n}\n\n/** Run the suite against an adapter's endpoint. */\nexport async function runConformance(options: ConformanceOptions): Promise<ConformanceResult[]> {\n  const revalidated: string[][] = []\n  const client = (secret: string) =>\n    httpHostCalls({\n      endpoint: options.endpoint,\n      secret,\n      fetch: options.fetch,\n      onRevalidate: (targets) => revalidated.push(targets),\n    })\n\n  return await conformance(client(options.secret), {\n    revalidated,\n    manifest: options.manifest,\n    wrongSecret: client(options.secret + '-wrong'),\n  })\n}\n\n/**\n * Whether a value fits the JSON Schema subset the manifest uses. Null when it\n * does; otherwise where and why it does not.\n */\nexport function conformsTo(value: unknown, schema: Schema, defs: Record<string, Schema>, at: string): string | null {\n  if (!schema || Object.keys(schema).length === 0) return null\n\n  const ref = schema.$ref\n\n  if (typeof ref === 'string' && ref.startsWith('#/defs/')) {\n    const target = defs[ref.slice(7)]\n\n    return target ? conformsTo(value, target, defs, at) : `${at}: ${ref} is not in defs`\n  }\n\n  if (Array.isArray(schema.anyOf)) {\n    const fits = (schema.anyOf as Schema[]).some((s) => conformsTo(value, s, defs, at) === null)\n\n    return fits ? null : `${at}: ${JSON.stringify(value)} is none of ${JSON.stringify(schema.anyOf)}`\n  }\n\n  if (Array.isArray(schema.enum)) {\n    return (schema.enum as unknown[]).includes(value) ? null : `${at}: ${JSON.stringify(value)} is not one of ${JSON.stringify(schema.enum)}`\n  }\n\n  const kind = Array.isArray(value) ? 'array' : value === null ? 'null' : typeof value\n\n  switch (schema.type) {\n    case 'string':\n      if (kind !== 'string') return `${at}: expected a string, got ${JSON.stringify(value)}`\n      if (schema.format === 'date-time' && Number.isNaN(Date.parse(value as string))) return `${at}: ${JSON.stringify(value)} is not a date-time`\n      return null\n    case 'integer':\n      return Number.isInteger(value) ? null : `${at}: expected an integer, got ${JSON.stringify(value)}`\n    case 'number':\n      return kind === 'number' ? null : `${at}: expected a number, got ${JSON.stringify(value)}`\n    case 'boolean':\n      return kind === 'boolean' ? null : `${at}: expected a boolean, got ${JSON.stringify(value)}`\n    case 'null':\n      return value === null ? null : `${at}: expected null, got ${JSON.stringify(value)}`\n    case 'array': {\n      if (kind !== 'array') return `${at}: expected an array, got ${JSON.stringify(value)}`\n      for (const [i, item] of (value as unknown[]).entries()) {\n        const problem = conformsTo(item, schema.items as Schema, defs, `${at}[${i}]`)\n        if (problem) return problem\n      }\n      return null\n    }\n    case 'object': {\n      if (kind !== 'object') return `${at}: expected an object, got ${JSON.stringify(value)}`\n      const object = value as Record<string, unknown>\n      const properties = (schema.properties ?? {}) as Record<string, Schema>\n      for (const name of (schema.required as string[] | undefined) ?? []) {\n        if (!(name in object)) return `${at}.${name}: required, and missing`\n      }\n      for (const [name, s] of Object.entries(properties)) {\n        if (name in object) {\n          const problem = conformsTo(object[name], s, defs, `${at}.${name}`)\n          if (problem) return problem\n        }\n      }\n      const extra = schema.additionalProperties as Schema | undefined\n      if (extra && !schema.properties) {\n        for (const [name, item] of Object.entries(object)) {\n          const problem = conformsTo(item, extra, defs, `${at}.${name}`)\n          if (problem) return problem\n        }\n      }\n      return null\n    }\n    default:\n      return null\n  }\n}\n\n/** Print a result table, and say whether the adapter conforms. */\nexport function report(results: ConformanceResult[]): boolean {\n  for (const r of results) {\n    stdout.write(`  ${r.ok ? '✓' : '✗'}  ${r.case}${r.ok ? '' : '\\n       ' + r.detail}\\n`)\n  }\n\n  const failed = results.filter((r) => !r.ok).length\n\n  stdout.write(failed === 0 ? `\\n  conforms: ${results.length} cases\\n` : `\\n  ${failed} of ${results.length} cases failed\\n`)\n\n  return failed === 0\n}\n\n// Run as a command, not when imported.\nif (import.meta.url === pathToFileURL(argv[1] ?? '').href || argv[1]?.endsWith('rsc-kit-conformance')) {\n  const flag = (name: string) => {\n    const at = argv.indexOf('--' + name)\n\n    return at === -1 ? undefined : argv[at + 1]\n  }\n\n  const endpoint = flag('endpoint')\n  const secret = flag('secret')\n\n  if (!endpoint || !secret) {\n    stderr.write('usage: rsc-kit-conformance --endpoint <url> --secret <secret> [--manifest rsc-host.json]\\n')\n    exit(2)\n  }\n\n  runConformance({ endpoint, secret, manifest: flag('manifest') })\n    .then((results) => exit(report(results) ? 0 : 1))\n    .catch((error: unknown) => {\n      stderr.write('rsc-kit-conformance: ' + (error instanceof Error ? error.message : String(error)) + '\\n')\n      exit(1)\n    })\n}\n"]}

package/dist/hostCalls.d.ts

@@ -74,6 +74,16 @@ export interface HostCallReply {
      * function's result.
      */
     redirect?: string;
+    /**
+     * Where an unexpected failure happened in the backend, sent only in
+     * development (Laravel's app.debug, Go's CallbackHandler.Debug): the
+     * thrown type, its message, and frames newest first.
+     */
+    debug?: {
+        type?: string;
+        message?: string;
+        trace?: string[];
+    };
     /** The status to redirect with. Defaults to 307, which preserves the method. */
     redirectStatus?: number;
     /**
@@ -121,7 +131,4 @@ export type HostCallBatchLine = HostCallReply & {
     index: number;
     status?: number;
 };
-/**
- * The function to hand to `installHostFn`, or to `hostCalls` on the JS host.
- */
 export declare function httpHostCalls(options: HttpHostCallsOptions): (name: string, ...args: unknown[]) => Promise<unknown>;

package/dist/hostCalls.js

@@ -27,6 +27,23 @@ const nextTick = typeof setImmediate === 'function' ? (fn) => setImmediate(fn) :
 /**
  * The function to hand to `installHostFn`, or to `hostCalls` on the JS host.
  */
+/**
+ * The backend's trace, on the error the render sees.
+ *
+ * As its cause - an Error named for the backend's type, whose stack is the
+ * backend's frames - so Node, Bun and the dev overlay print it under the
+ * renderer's own stack; and appended to that stack, for whatever prints only
+ * the one. Before this a failed rpc() pointed at a line of JavaScript, and the
+ * PHP or Go that failed was a separate search through another log.
+ */
+function withBackendTrace(failure, debug) {
+    const frames = (debug.trace ?? []).map((frame) => '    at ' + frame).join('\n');
+    const cause = new Error(debug.message ?? '');
+    cause.name = 'Backend ' + (debug.type ?? 'Error');
+    cause.stack = cause.name + ': ' + (debug.message ?? '') + (frames ? '\n' + frames : '');
+    failure.cause = cause;
+    failure.stack = (failure.stack ?? String(failure)) + '\nCaused in the backend by ' + cause.stack;
+}
 export function httpHostCalls(options) {
     const { endpoint, secret, forwardHeaders = DEFAULT_FORWARDED, timeoutMs = 30_000, fetch: fetchImpl, onRevalidate, batch = true, } = options;
     if (!secret) {
@@ -305,6 +322,8 @@ export function httpHostCalls(options) {
                 ;
                 failure.refusalStatus = reply.refusalStatus;
             }
+            if (reply.debug)
+                withBackendTrace(failure, reply.debug);
             throw failure;
         }
         if (status >= 400) {