@fougere/calls 0.5.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fougere contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,31 @@
+# @fougere/calls
+> The dev panel — a bounded log of what this process dispatched
+An optional extension. It **watches** rather than participates: it subscribes to
+`app.observe`, which is passive and swallows an observer's own failure, and the ring
+holds no reference to a body.
+
+```ts
+extensions: [calls({ max: 500, panel: true })],
+```
+
+What it sees that a middleware cannot: a call refused **before** any handler — an unknown
+route, an entity hosted elsewhere, a call arriving while the door drains — and the route
+kind of every call, so a local execution and a hop to another process read the same way.
+Beside the calls it keeps a bounded ring of log lines, of errors, and — when
+`@fougere/adapter-sql` is installed — of the statements each call issued.
+
+No port is opened unless `panel` says so. The ring is served as the `rpc.calls` operation,
+and the reader is `fougere devtools` over `/_fougere/call`, like any other consumer. An app
+that never installed this package answers
+`Unknown rpc operation 'calls'. It serves discover.`
+
+## Installation
+```bash
+pnpm add -D @fougere/calls
+```
+
+---
+
+Part of [Fougere](https://github.com/chok/fougere) — one schema, a gradient from
+monolith to distributed, the same user code.
+Reference documentation: [the site](https://fougere.dev/) (en/fr).

package/dist/CallRing.d.ts

@@ -0,0 +1,45 @@
+import { type CallPage, type CallRecord, type DispatchEvent } from '@fougere/core';
+/**
+ * A bounded log of what this process dispatched.
+ *
+ * The five transitions of one call are folded into one record: `received` opens it,
+ * `resolved` names the route, `completed`/`failed` settle the verdict, `settled` closes
+ * the duration. They are matched by the identity of the `Call`, which is the same frozen
+ * object across all five.
+ */
+export declare class CallRing {
+    private readonly max;
+    private readonly frondOf;
+    private readonly held;
+    private readonly open;
+    private seq;
+    private lost;
+    private readonly watching;
+    constructor(max?: number, frondOf?: (entity: string) => string | undefined);
+    /**
+     * KNOWN LIMIT — a call this process ORIGINATES carries no trace here.
+     *
+     * `trace()` writes the traceparent inside the middleware chain, so inside
+     * `route.execute(call)`; the observer saw the `Call` at `received`, and that object is
+     * frozen. An ARRIVING call is unaffected: its traceparent is already on the invocation
+     * the transport handed over, which is why a hosted frond shows traces and its consumer
+     * does not.
+     *
+     * Closing it means `DispatchEvent` carrying the invocation as it ENDED rather than as it
+     * arrived — a core change, deliberately not smuggled in here. Until then the Traces view
+     * speaks for the side that receives.
+     */
+    record(event: DispatchEvent): void;
+    private opened;
+    /**
+     * Be told when a record settles, and get the unsubscription back.
+     *
+     * A page that polls is a page that is always a little wrong; this is what lets a door
+     * push instead. Told at `settled` and not at `received`, because a record is only
+     * complete then — a reader would otherwise redraw the same line four times.
+     */
+    watch(told: (record: CallRecord) => void): () => void;
+    /** Everything above `cursor`, and what was lost while the reader was away. */
+    since(cursor: number, inFlight?: number): CallPage;
+}
+//# sourceMappingURL=CallRing.d.ts.map

package/dist/CallRing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CallRing.d.ts","sourceRoot":"","sources":["../src/CallRing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAa/F;;;;;;;GAOG;AACH,qBAAa,QAAQ;IAQjB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqC;IAC1D,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IAEpE,YACmB,GAAG,SAAM,EACT,OAAO,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAA2B,EAChF;IAEJ;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CA0BjC;IAED,OAAO,CAAC,MAAM;IAsBd;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI,CAIpD;IAED,8EAA8E;IAC9E,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,QAAQ,CAO5C;CACF"}

package/dist/CallRing.js

@@ -0,0 +1,119 @@
+import { RPC_ENTITY } from '@fougere/core';
+/** The message and the code of a refusal, without the stack that carries a body. */
+function refusalOf(error) {
+    if (error === null || error === undefined)
+        return { message: 'unknown refusal' };
+    const held = error;
+    return {
+        ...(typeof held.code === 'string' ? { code: held.code } : {}),
+        message: typeof held.message === 'string' ? held.message : String(error),
+    };
+}
+/**
+ * A bounded log of what this process dispatched.
+ *
+ * The five transitions of one call are folded into one record: `received` opens it,
+ * `resolved` names the route, `completed`/`failed` settle the verdict, `settled` closes
+ * the duration. They are matched by the identity of the `Call`, which is the same frozen
+ * object across all five.
+ */
+export class CallRing {
+    max;
+    frondOf;
+    held = [];
+    open = new WeakMap();
+    seq = 0;
+    lost = 0;
+    watching = new Set();
+    constructor(max = 500, frondOf = () => undefined) {
+        this.max = max;
+        this.frondOf = frondOf;
+    }
+    /**
+     * KNOWN LIMIT — a call this process ORIGINATES carries no trace here.
+     *
+     * `trace()` writes the traceparent inside the middleware chain, so inside
+     * `route.execute(call)`; the observer saw the `Call` at `received`, and that object is
+     * frozen. An ARRIVING call is unaffected: its traceparent is already on the invocation
+     * the transport handed over, which is why a hosted frond shows traces and its consumer
+     * does not.
+     *
+     * Closing it means `DispatchEvent` carrying the invocation as it ENDED rather than as it
+     * arrived — a core change, deliberately not smuggled in here. Until then the Traces view
+     * speaks for the side that receives.
+     */
+    record(event) {
+        // A reader reaches this ring through `rpc`, so recording that would make the panel
+        // watch itself — one reader, one line, forever.
+        if (event.call.address.entity === RPC_ENTITY)
+            return;
+        if (event.stage === 'received')
+            return this.opened(event);
+        const record = this.open.get(event.call);
+        if (!record)
+            return;
+        if (event.stage === 'resolved' && event.routeKind)
+            record.route = event.routeKind;
+        if (event.stage === 'completed')
+            record.verdict = 'ok';
+        if (event.stage === 'failed') {
+            record.verdict = 'failed';
+            record.refusal = refusalOf(event.error);
+        }
+        if (event.stage === 'settled') {
+            record.ms = Date.now() - record.startedAt;
+            if (event.routeKind)
+                record.route = event.routeKind;
+            this.open.delete(event.call);
+            for (const told of this.watching) {
+                // A watcher's own failure is not the dispatch's problem — the same rule
+                // `DispatchLifecycle` applies to an observer.
+                try {
+                    told(record);
+                }
+                catch { /* observational */ }
+            }
+        }
+    }
+    opened(event) {
+        const { entity, operation, surface } = event.call.address;
+        const frond = this.frondOf(entity);
+        const { trace, caller } = event.call.invocation;
+        const record = {
+            seq: ++this.seq,
+            ...(frond ? { frond } : {}),
+            entity,
+            operation,
+            ...(surface !== undefined ? { surface } : {}),
+            ...(trace ? { trace } : {}),
+            ...(caller ? { caller } : {}),
+            startedAt: Date.now(),
+            verdict: 'running',
+        };
+        this.held.push(record);
+        this.open.set(event.call, record);
+        if (this.held.length > this.max)
+            this.lost += this.held.splice(0, this.held.length - this.max).length;
+    }
+    /**
+     * Be told when a record settles, and get the unsubscription back.
+     *
+     * A page that polls is a page that is always a little wrong; this is what lets a door
+     * push instead. Told at `settled` and not at `received`, because a record is only
+     * complete then — a reader would otherwise redraw the same line four times.
+     */
+    watch(told) {
+        this.watching.add(told);
+        return () => this.watching.delete(told);
+    }
+    /** Everything above `cursor`, and what was lost while the reader was away. */
+    since(cursor, inFlight = 0) {
+        return {
+            calls: this.held.filter((record) => record.seq > cursor),
+            cursor: this.seq,
+            inFlight,
+            dropped: this.lost,
+        };
+    }
+}
+//# sourceMappingURL=CallRing.js.map

package/dist/CallRing.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+import { type Extension } from '@fougere/core';
+import { type PanelOptions } from './panel.js';
+export type { CallPage, CallRecord } from '@fougere/core';
+export { CallRing } from './CallRing.js';
+export { LogRing, QueryRing, ErrorRing } from './rings.js';
+export type { LogLine, QueryLine, ErrorGroup } from './rings.js';
+export { servePanel, type PanelOptions } from './panel.js';
+/** The rpc operation this extension answers under. */
+export declare const CALLS_OP = "calls";
+export interface CallsOptions {
+    /** How many calls the ring keeps. Beyond it, the oldest are dropped and counted. */
+    max?: number;
+    /**
+     * Serve the page too, on its own loopback port. `true` takes a free one.
+     *
+     * Node only — it opens an `http` server, which workerd has not. Without it the extension
+     * stays universal and `fougere devtools` is the reader.
+     */
+    panel?: boolean | number | PanelOptions;
+}
+/**
+ * What this process dispatched, kept in a bounded ring and served as an rpc operation.
+ *
+ * It watches rather than participates: `app.observe` is passive, `DispatchLifecycle`
+ * swallows an observer's own failure, and the ring holds no reference to a body. What it
+ * sees that a middleware cannot: a call refused BEFORE any handler — an unknown route, an
+ * entity hosted elsewhere, a call arriving while the door drains — and the route kind of
+ * every call, so a local execution and a hop to another process read the same way.
+ *
+ * The reader is `fougere devtools`, over `/_fougere/call` like any other consumer. No port
+ * is opened here, and an app that never installed this package answers
+ * `Unknown rpc operation 'calls'. It serves discover.`
+ */
+export declare function calls(options?: CallsOptions): Extension;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,SAAS,EAA0B,MAAM,eAAe,CAAC;AAGxF,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3D,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC3D,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3D,sDAAsD;AACtD,eAAO,MAAM,QAAQ,UAAU,CAAC;AAEhC,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,CAAC;CACzC;AAwGD;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,SAAS,CA+D3D"}

package/dist/index.js

@@ -0,0 +1,179 @@
+import { onLog } from '@fougere/core';
+import { CallRing } from './CallRing.js';
+import { ErrorRing, LogRing, QueryRing } from './rings.js';
+import { servePanel } from './panel.js';
+export { CallRing } from './CallRing.js';
+export { LogRing, QueryRing, ErrorRing } from './rings.js';
+export { servePanel } from './panel.js';
+/** The rpc operation this extension answers under. */
+export const CALLS_OP = 'calls';
+/**
+ * What this process serves, read from the app itself.
+ *
+ * Not a second source: `operationsFor` is the same effective model the façade consumes, so
+ * the page shows what will actually answer — including the ops nobody has called yet, which
+ * is what makes an empty panel useful instead of blank.
+ */
+function servedModel(app) {
+    return {
+        fronds: app.fronds.map((frond) => ({
+            name: frond.name,
+            // What the config SAYS. What the runtime saw is in the ring, under `route` — and the
+            // two disagree exactly when something is misconfigured, which is the whole point of
+            // showing them side by side. `rpc.topology` calls a frond remote because it ANSWERED.
+            declared: app.remotes[frond.name] ? 'remote' : 'local',
+            at: app.remotes[frond.name] ? hostOf(app.remotes[frond.name]) : null,
+            entities: frond.entities.map((entity) => entity.name),
+            operations: frond.handlers.flatMap((handler) => {
+                const ops = app.operationsFor(handler.address);
+                return [...(ops?.values() ?? [])].map((op) => ({
+                    id: op.id,
+                    operation: op.operation,
+                    kind: op.kind,
+                    address: `${op.handler.address}.${op.implementation.method}`,
+                    handler: op.handler.className,
+                    description: op.description ?? null,
+                    input: nameOf(op.input),
+                    output: nameOf(op.output),
+                    cardinality: op.cardinality ?? null,
+                    parameters: op.parameters.map((one) => ({
+                        name: one.name,
+                        type: one.type,
+                        optional: one.optional,
+                        binding: one.binding.source.kind,
+                    })),
+                    surfaces: op.exposure.surfaces,
+                    adapters: op.exposure.adapters,
+                    placement: op.placement.runtime,
+                    file: op.implementation.filePath,
+                }));
+            }),
+        })),
+    };
+}
+/** Host and port only — a declared address may carry credentials, and this answer leaves. */
+function hostOf(address) {
+    try {
+        const url = new URL(address);
+        return `${url.protocol}//${url.host}`;
+    }
+    catch {
+        return address;
+    }
+}
+function nameOf(schema) {
+    const held = schema;
+    if (!held)
+        return null;
+    return typeof held.getName === 'function' ? held.getName() : held.name ?? null;
+}
+/**
+ * `address -> frond`, resolved once at boot: a call's address does not carry its frond.
+ *
+ * Indexed on HANDLERS and not on entities, because a frond may hold no entity at all —
+ * `demos/observability` has two — and then every one of its calls came back unnamed. The
+ * entities are indexed after, and only where a handler left the address free: an entity
+ * with no handler is served by `Crud`, which answers under the same address.
+ */
+function frondIndex(app) {
+    const byAddress = new Map();
+    for (const frond of app.fronds) {
+        for (const entity of frond.entities)
+            byAddress.set(entity.name, frond.name);
+        for (const handler of frond.handlers)
+            byAddress.set(handler.address, frond.name);
+    }
+    return (address) => byAddress.get(address);
+}
+/**
+ * Subscribe to SQL when there is SQL. Absence is an answer, not a blank tab.
+ *
+ * `logQueries` is installed in every Kysely this process builds, so the subscription is all
+ * that is missing — and it is taken here, in `up(app)`, like the other two.
+ */
+async function queriesFrom(queries) {
+    try {
+        const { onQuery } = await import('@fougere/adapter-sql');
+        return onQuery((event) => queries.record(event));
+    }
+    catch {
+        return () => { };
+    }
+}
+function cursorOf(invocation) {
+    const body = invocation.body;
+    const since = Number(body?.since ?? 0);
+    return Number.isFinite(since) && since > 0 ? since : 0;
+}
+/**
+ * What this process dispatched, kept in a bounded ring and served as an rpc operation.
+ *
+ * It watches rather than participates: `app.observe` is passive, `DispatchLifecycle`
+ * swallows an observer's own failure, and the ring holds no reference to a body. What it
+ * sees that a middleware cannot: a call refused BEFORE any handler — an unknown route, an
+ * entity hosted elsewhere, a call arriving while the door drains — and the route kind of
+ * every call, so a local execution and a hop to another process read the same way.
+ *
+ * The reader is `fougere devtools`, over `/_fougere/call` like any other consumer. No port
+ * is opened here, and an app that never installed this package answers
+ * `Unknown rpc operation 'calls'. It serves discover.`
+ */
+export function calls(options = {}) {
+    /**
+     * Per APP, not per extension. A host declares its extensions once, so the same instance
+     * goes up on the new app before the old one is released — one shared ring would mix two
+     * processes' worth of calls, and the older `down` would erase the newer subscription.
+     */
+    const stopping = new WeakMap();
+    return {
+        name: 'calls',
+        async up(app) {
+            const ring = new CallRing(options.max ?? 500, frondIndex(app));
+            const logs = new LogRing();
+            const errors = new ErrorRing();
+            const queries = new QueryRing();
+            const undo = [
+                app.observe((event) => {
+                    ring.record(event);
+                    if (event.stage === 'failed')
+                        errors.fromDispatch(event);
+                }),
+                onLog((line) => {
+                    logs.record(line);
+                    errors.fromLog(line);
+                }),
+                // `@fougere/adapter-sql` is optional — an app on another storage, or none, simply
+                // never resolves it, and the Queries tab says there is none rather than staying
+                // blank. Dynamic on purpose: this package declares no dependency on it.
+                await queriesFrom(queries),
+            ];
+            const stop = () => { for (const one of undo)
+                one(); };
+            app.serveRpc(CALLS_OP, (invocation) => ring.since(cursorOf(invocation), app.inFlight()));
+            if (!options.panel) {
+                stopping.set(app, stop);
+                return;
+            }
+            const asked = typeof options.panel === 'object' ? options.panel : {};
+            const port = typeof options.panel === 'number' ? options.panel : asked.port;
+            const close = await servePanel(ring, {
+                ...asked,
+                ...(port !== undefined ? { port } : {}),
+                title: asked.title ?? app.fronds[0]?.name ?? 'fougere',
+                fronds: app.fronds.map((frond) => frond.name),
+                model: servedModel(app),
+                logs: (cursor) => logs.since(cursor),
+                errors: (cursor) => errors.since(cursor),
+                queries: (cursor) => queries.since(cursor),
+                inFlight: () => app.inFlight(),
+                announce: asked.announce ?? ((url) => console.log(`  calls panel  ${url}`)),
+            });
+            stopping.set(app, async () => { stop(); await close(); });
+        },
+        async down(app) {
+            await stopping.get(app)?.();
+            stopping.delete(app);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/page.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The panel, as one file with no dependency.
+ *
+ * Inline on purpose: this package ships no framework and no build step, and a dev tool that
+ * needs `npm install` before it shows anything is a dev tool nobody opens. The page reads
+ * its own origin — the door that served it also serves its events — so there is no address
+ * to configure and no CORS to arrange.
+ *
+ * FOUR views, and the number is a decision. Six grew one tab at a time, each with its own
+ * empty state and its own caveat, and the result read as noise rather than as an answer.
+ * They fold along what a reader actually asks:
+ *
+ *   Calls     what happened, and did it hold — the screen that IS the argument
+ *   Refused   what did not, from two sources, since one of them is never a call
+ *   Activity  what the process did along the way — logs and statements are one stream,
+ *             both chronological, both uncorrelated to a call; two tabs said that twice
+ *   Served    what it would answer if asked, filled before anything is called
+ *
+ * Traces lost its tab: it spoke for the receiving side only, and a trace already shows in a
+ * call's detail. A tab that half-delivers is worse than a field that says what it knows.
+ */
+export declare function page(title: string): string;
+//# sourceMappingURL=page.d.ts.map

package/dist/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../src/page.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAigB1C"}