@harperfast/harper 5.0.30 → 5.1.0-beta.2

package/dist/components/deploymentRecorder.js

@@ -0,0 +1,425 @@
+'use strict';
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeploymentRecorder = void 0;
+exports.getActiveEmitter = getActiveEmitter;
+exports.awaitDeploymentRow = awaitDeploymentRow;
+// DeploymentRecorder — lifecycle owner for one row in system.hdb_deployment.
+//
+// Creates the pending row at deploy start, persists the upload payload into the row's
+// payload_blob (with sha256 + size), and writes the terminal status at the end.
+// Subscribes to a ProgressEmitter so phase transitions and install lines land in
+// event_log as they happen — making the deploy observable by Studio polling
+// get_deployment without an attached CLI. The persisted payload_blob will also serve
+// as the rollback source when that operation lands.
+const node_crypto_1 = require("node:crypto");
+const node_crypto_2 = require("node:crypto");
+const databases_ts_1 = require("../resources/databases.js");
+const blob_ts_1 = require("../resources/blob.js");
+const terms = __importStar(require("../utility/hdbTerms.js"));
+const hdbError_ts_1 = require("../utility/errors/hdbError.js");
+const node_os_1 = require("node:os");
+// Bound the event_log so a pathologically chatty install can't grow a row without limit.
+// 200 entries comfortably covers a real deploy with headroom (phase events plus install
+// line summaries). When we exceed the cap, drop the middle rather than the front — the
+// lifecycle spine (prepare → load → replicate → success) is the most valuable context
+// for debugging, and naive front-truncation loses it under a chatty `npm install`.
+const EVENT_LOG_MAX = 200;
+const EVENT_LOG_HEAD_KEEP = 20;
+// In-memory registry of live emitters, keyed by deployment_id. Populated for the lifetime
+// of an in-progress deploy on the origin node; get_deployment SSE looks here to tail live
+// events after replaying event_log. Per-node, not replicated — peers don't see another
+// node's in-progress emitters. Cross-node tailing is a later concern.
+const activeEmitters = new Map();
+function getActiveEmitter(deploymentId) {
+    return activeEmitters.get(deploymentId);
+}
+// Interim cap: ingestPayload currently buffers the entire payload in memory before
+// computing the hash and persisting. This cap prevents an OOM on accidentally-huge
+// uploads. A follow-up will swap this for a true streaming-hash + blob-source pattern
+// that lifts the limit back to whatever the replication path supports.
+const PAYLOAD_BUFFER_CAP_BYTES = 200 * 1024 * 1024;
+class DeploymentRecorder {
+    deploymentId;
+    record;
+    hash = null;
+    byteCount = 0;
+    finished = false;
+    unsubscribe = null;
+    pendingPut = null;
+    dirty = false;
+    sealed = false;
+    constructor(deploymentId, initial) {
+        this.deploymentId = deploymentId;
+        this.record = initial;
+    }
+    static async create(options) {
+        const deploymentId = (0, node_crypto_1.randomUUID)();
+        const startedAt = Date.now();
+        const record = {
+            deployment_id: deploymentId,
+            project: options.project ?? null,
+            package_identifier: options.package_identifier ?? null,
+            payload_hash: null,
+            payload_size: null,
+            payload_blob: null,
+            status: 'pending',
+            phase: 'pending',
+            event_log: [],
+            peer_results: [],
+            origin_node: (0, node_os_1.hostname)(),
+            restart_mode: options.restart_mode ?? null,
+            started_at: startedAt,
+            completed_at: null,
+            user: options.user ?? null,
+            rollback_of: options.rollback_of ?? null,
+            error: null,
+        };
+        const recorder = new DeploymentRecorder(deploymentId, record);
+        await recorder.put();
+        if (options.emitter) {
+            recorder.subscribeTo(options.emitter);
+            activeEmitters.set(deploymentId, options.emitter);
+        }
+        return recorder;
+    }
+    /**
+     * Subscribe to a ProgressEmitter. Each event is appended (bounded) to event_log; phase
+     * events also update the row's `status` and `phase` fields. Writes coalesce: a put is
+     * always pending after the first event in a burst, so chatty install output collapses
+     * to one row update per ~100ms instead of one per line.
+     */
+    subscribeTo(emitter) {
+        this.unsubscribe = emitter.subscribe((event) => {
+            this.appendEvent(event.event, event.data);
+        });
+    }
+    appendEvent(event, data) {
+        if (this.finished)
+            return;
+        const log = this.record.event_log;
+        log.push({ t: Date.now(), event, data });
+        // Keep the head (lifecycle spine) and tail (most-recent activity); drop the middle.
+        if (log.length > EVENT_LOG_MAX) {
+            const tailKeep = EVENT_LOG_MAX - EVENT_LOG_HEAD_KEEP - 1; // -1 for the truncation marker
+            const removedCount = log.length - EVENT_LOG_HEAD_KEEP - tailKeep;
+            log.splice(EVENT_LOG_HEAD_KEEP, log.length - EVENT_LOG_HEAD_KEEP - tailKeep, {
+                t: Date.now(),
+                event: 'truncated',
+                data: { dropped_events: removedCount },
+            });
+        }
+        // Phase events drive the canonical status/phase fields used by list_deployments.
+        if (event === 'phase' && data && typeof data === 'object') {
+            const p = data;
+            if (p.phase)
+                this.record.phase = p.phase;
+            if (p.status === 'start') {
+                const mapped = startStatusFor(p.phase);
+                if (mapped)
+                    this.record.status = mapped;
+            }
+        }
+        this.scheduleFlush();
+    }
+    // Coalesce writes: at most one in-flight put at a time. While a put is running, mark
+    // the record dirty; the chained continuation issues a follow-up put once the prior one
+    // settles. This keeps event_log writes O(1) puts per burst rather than O(N) per event.
+    scheduleFlush() {
+        if (this.sealed) {
+            // Sealed: accumulate state in memory but don't write. finish() does the single
+            // terminal write. See seal() for why. The emitter still emits live SSE events.
+            this.dirty = true;
+            return;
+        }
+        if (this.pendingPut) {
+            this.dirty = true;
+            return;
+        }
+        this.pendingPut = this.put().finally(() => {
+            this.pendingPut = null;
+            if (this.dirty) {
+                this.dirty = false;
+                this.scheduleFlush();
+            }
+        });
+    }
+    /**
+     * Drain a payload source (Buffer or Readable) into the row's payload_blob attribute,
+     * computing sha256 and byte count alongside. After this resolves the row has been
+     * committed once with the final hash and size, and `this.row.payload_blob.stream()`
+     * yields a fresh Readable that callers can pass to extraction.
+     *
+     * Buffers the payload in memory (subject to PAYLOAD_BUFFER_CAP_BYTES) so the
+     * hash/size are known synchronously before we commit and so the blob's `saveBlob`
+     * lifecycle doesn't race with our digest() call. A streaming variant is a planned
+     * follow-up that uses the unused `hash`/`byteCount` instance fields below.
+     */
+    async ingestPayload(source) {
+        const hash = (0, node_crypto_2.createHash)('sha256');
+        let byteCount = 0;
+        let buffer;
+        if (Buffer.isBuffer(source)) {
+            buffer = source;
+        }
+        else if (typeof source === 'string') {
+            // Legacy CBOR/JSON path: payload arrives as a base64-encoded string.
+            buffer = Buffer.from(source, 'base64');
+        }
+        else {
+            const chunks = [];
+            let collected = 0;
+            for await (const chunk of source) {
+                const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+                collected += buf.length;
+                if (collected > PAYLOAD_BUFFER_CAP_BYTES) {
+                    source.destroy?.();
+                    throw new hdbError_ts_1.ClientError(`Deploy payload exceeds the ${PAYLOAD_BUFFER_CAP_BYTES} byte buffer cap. ` +
+                        `Use a package identifier (npm:/file:/git:) for larger components.`);
+                }
+                chunks.push(buf);
+            }
+            buffer = Buffer.concat(chunks);
+        }
+        if (buffer.length > PAYLOAD_BUFFER_CAP_BYTES) {
+            throw new hdbError_ts_1.ClientError(`Deploy payload (${buffer.length} bytes) exceeds the ${PAYLOAD_BUFFER_CAP_BYTES} byte buffer cap. ` +
+                `Use a package identifier (npm:/file:/git:) for larger components.`);
+        }
+        hash.update(buffer);
+        byteCount = buffer.length;
+        this.record.payload_blob = (0, blob_ts_1.createBlob)(buffer, { type: 'application/gzip' });
+        this.record.payload_hash = hash.digest('hex');
+        this.record.payload_size = byteCount;
+        // Touch the unused private fields so the type system stays happy when a streaming
+        // variant lands that uses them.
+        this.hash = hash;
+        this.byteCount = byteCount;
+        await this.put();
+    }
+    async transitionPhase(phase, status) {
+        this.record.phase = phase;
+        if (status)
+            this.record.status = status;
+        await this.put();
+    }
+    /**
+     * Upsert a single peer outcome by node name. Called per-peer as each replication
+     * target settles, so the row reflects in-flight progress rather than only the
+     * final aggregate. Routes through `scheduleFlush()` so the write coalesces with
+     * the emitter-driven puts and the latest in-memory state always wins.
+     *
+     * Tolerates unknown shapes — anything we can't interpret becomes a plain
+     * stringified entry so the audit trail at least records that a peer was contacted.
+     */
+    recordPeer(result) {
+        if (this.finished)
+            return;
+        const normalized = normalizePeerResult(result);
+        // Defensive: rows freshly created via create() always have peer_results=[], but if
+        // a replicated row was loaded back where the attribute is absent or null we want
+        // to initialize lazily rather than throw on `.findIndex`.
+        if (!Array.isArray(this.record.peer_results))
+            this.record.peer_results = [];
+        const list = this.record.peer_results;
+        // Upsert by node name when present; otherwise append (we can't dedupe without an id).
+        const nodeName = normalized.node;
+        const idx = nodeName ? list.findIndex((entry) => entry.node === nodeName) : -1;
+        if (idx >= 0) {
+            list[idx] = normalized;
+        }
+        else {
+            list.push(normalized);
+        }
+        this.scheduleFlush();
+    }
+    /**
+     * Bulk-record a final aggregate of peer outcomes. Equivalent to calling recordPeer()
+     * for each entry. Useful for replication layers that surface results all-at-once
+     * via Promise.allSettled rather than via a per-peer callback.
+     */
+    recordPeers(results) {
+        if (this.finished)
+            return;
+        if (!Array.isArray(results))
+            return;
+        for (const result of results)
+            this.recordPeer(result);
+    }
+    /**
+     * Stop persisting intermediate row updates; accumulate them in memory so finish() writes
+     * the terminal state in a single put. Called before the replicate phase, where the row
+     * otherwise receives a tight burst of puts (replicate phase + per-peer + finish) within
+     * a few ms. That burst can commit out of order on a loaded peer, where an older full
+     * update reverts the terminal `success` write — the row stays stuck at `replicating` and
+     * never converges (harperdb/harper#1170). Collapsing to one terminal write isolates it
+     * from any concurrent same-key write so the receiver converges.
+     *
+     * Tradeoff: the origin's get_deployment *polling* view skips the transient `replicating`
+     * status and incremental peer_results during the final phase; live SSE tailing is
+     * unaffected (the emitter still emits in real time). Once #1170 lands this seal can be
+     * removed to restore incremental peer_results persistence.
+     */
+    seal() {
+        this.sealed = true;
+    }
+    async finish(status, error) {
+        if (this.finished)
+            return;
+        // Send a terminal sentinel through the emitter (if any) BEFORE we unsubscribe and
+        // remove it from the registry, so any SSE tail subscribers can resolve their wait
+        // even on a code path that doesn't emit an explicit `error` event.
+        const emitter = activeEmitters.get(this.deploymentId);
+        emitter?.emit('_recorder_finished', { status });
+        this.finished = true;
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+        activeEmitters.delete(this.deploymentId);
+        // Drain the ENTIRE coalesced-flush chain before mutating + persisting the terminal
+        // state. Just awaiting `this.pendingPut` once isn't enough: its `.finally` may
+        // re-schedule another put (when `dirty` was set during the in-flight put), and
+        // that re-scheduled put captures a pre-mutation snapshot of the record. Without
+        // this loop, the re-scheduled put can complete AFTER our terminal put and
+        // overwrite status=success with stale state.
+        while (this.pendingPut) {
+            try {
+                await this.pendingPut;
+            }
+            catch {
+                /* the next put surfaces the error */
+            }
+        }
+        this.record.status = status;
+        this.record.completed_at = Date.now();
+        if (error) {
+            const e = error;
+            this.record.error = {
+                message: e?.message ?? String(error),
+                code: e?.code,
+                phase: this.record.phase,
+            };
+        }
+        await this.put();
+    }
+    get row() {
+        return this.record;
+    }
+    async put() {
+        const table = databases_ts_1.databases.system?.[terms.SYSTEM_TABLE_NAMES.DEPLOYMENT_TABLE_NAME];
+        if (!table) {
+            // Table missing means the upgrade directive hasn't run yet (or the table got dropped).
+            // We tolerate this — tracking is observability; the deploy itself must still succeed.
+            return;
+        }
+        await table.put(this.record);
+    }
+}
+exports.DeploymentRecorder = DeploymentRecorder;
+/**
+ * Peer-side helper — wait for the hdb_deployment row to arrive via table replication,
+ * then return it. The row is committed on origin before `replicateOperation` is
+ * called, so peers normally find it immediately; this polling loop is for the rare
+ * case where the operation arrives faster than the table-replication channel.
+ *
+ * The payload_blob's chunks may still be in flight after the row arrives — that's
+ * fine, the Blob's `stream()` / `bytes()` API blocks on incomplete writes
+ * (resources/blob.ts).
+ */
+async function awaitDeploymentRow(deploymentId, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    const maxIntervalMs = options.pollIntervalMs ?? 100;
+    // Start fast (5ms) so the common case — replication has already caught up — sees no
+    // human-noticeable latency, then back off exponentially up to maxIntervalMs for the
+    // rare case where the row is genuinely still replicating.
+    let intervalMs = options.initialPollIntervalMs ?? 5;
+    const table = databases_ts_1.databases.system?.[terms.SYSTEM_TABLE_NAMES.DEPLOYMENT_TABLE_NAME];
+    if (!table) {
+        throw new Error(`Deployment tracking is not initialized on this node (system.${terms.SYSTEM_TABLE_NAMES.DEPLOYMENT_TABLE_NAME} missing).`);
+    }
+    const deadline = Date.now() + timeoutMs;
+    let lastError;
+    while (Date.now() < deadline) {
+        try {
+            const row = await table.get(deploymentId);
+            if (row && row.payload_blob != null)
+                return row;
+        }
+        catch (err) {
+            lastError = err;
+        }
+        await new Promise((resolve) => setTimeout(resolve, intervalMs));
+        intervalMs = Math.min(intervalMs * 2, maxIntervalMs);
+    }
+    throw new Error(`Timed out after ${timeoutMs}ms waiting for hdb_deployment row '${deploymentId}' to replicate` +
+        (lastError ? ` (last error: ${lastError.message ?? lastError})` : ''));
+}
+function normalizePeerResult(raw) {
+    if (!raw || typeof raw !== 'object') {
+        // Replication layer returned a primitive — preserve as a stringified marker so the
+        // audit row at least records that something came back from a peer.
+        return { node: null, status: 'unknown', raw: String(raw) };
+    }
+    const r = raw;
+    const err = r.error;
+    const hasError = err != null && (typeof err === 'string' ? err.length > 0 : typeof err === 'object' || typeof err === 'number');
+    return {
+        node: r.node ?? r.name ?? r.hostname ?? null,
+        status: hasError ? 'failed' : (r.status ?? 'success'),
+        error: hasError
+            ? {
+                message: typeof err === 'object' ? (err.message ?? String(err)) : String(err),
+                code: typeof err === 'object' ? err.code : undefined,
+            }
+            : null,
+        started_at: r.started_at ?? null,
+        completed_at: r.completed_at ?? null,
+    };
+}
+function startStatusFor(phase) {
+    switch (phase) {
+        case 'extract':
+            return 'extracting';
+        case 'install':
+            return 'installing';
+        case 'load':
+            return 'loading';
+        case 'replicate':
+            return 'replicating';
+        case 'restart':
+            return 'restarting';
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=deploymentRecorder.js.map

package/dist/components/deploymentRecorder.js.map

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

package/dist/components/deriveURLPath.d.ts

@@ -1,3 +1,3 @@
-import type { Component } from './Component.js';
-import type { ComponentV1 } from './ComponentV1.js';
+import type { Component } from './Component.ts';
+import type { ComponentV1 } from './ComponentV1.ts';
 export declare function deriveURLPath(component: Component | ComponentV1, path: string, type: 'file' | 'directory'): string;

package/dist/components/deriveURLPath.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deriveURLPath = deriveURLPath;
-const node_path_1 = require("node:path");
 function pathStartsWithBase(base, path) {
     const re = new RegExp(`^${base}(/|$)`);
     return re.test(path);
 }
 function deriveURLPath(component, path, type) {
+    path = path.replace(/\\/g, '/'); // converting from potential windows path to URL paths
     if (path.startsWith('./')) {
         path = path.slice(2); // remove leading './'
     }
@@ -50,6 +50,6 @@ function deriveURLPath(component, path, type) {
             }
         }
     }
-    return (0, node_path_1.join)(component.baseURLPath, path);
+    return component.baseURLPath + path; // note, do NOT use join here, this is not a file system path, this is a URL path
 }
 //# sourceMappingURL=deriveURLPath.js.map

package/dist/components/deriveURLPath.js.map

@@ -1 +1 @@
-{"version":3,"file":"deriveURLPath.js","sourceRoot":"","sources":["../../components/deriveURLPath.ts"],"names":[],"mappings":";;AASA,sCA+CC;AAxDD,yCAAiC;AAIjC,SAAS,kBAAkB,CAAC,IAAY,EAAE,IAAY;IACrD,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,SAAgB,aAAa,CAAC,SAAkC,EAAE,IAAY,EAAE,IAA0B;IACzG,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB;IAC7C,CAAC;IAED,KAAK,IAAI,IAAI,IAAI,SAAS,CAAC,YAAY,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB;QAC7C,CAAC;QAED,IAAI,IAAI,KAAK,EAAE;YAAE,SAAS;QAE1B,QAAQ;QACR,uBAAuB;QACvB,uCAAuC;QACvC,oCAAoC;QACpC,+CAA+C;QAC/C,6DAA6D;QAC7D,kDAAkD;QAClD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACrB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC9B,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gCAAgC;gBAChE,MAAM;YACP,CAAC;iBAAM,IAAI,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC3C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iCAAiC;gBACrE,MAAM;YACP,CAAC;QACF,CAAC;QAED,cAAc;QACd,uBAAuB;QACvB,gBAAgB;QAChB,8BAA8B;QAC9B,4BAA4B;QAC5B,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAC1B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBACnB,IAAI,GAAG,EAAE,CAAC;gBACV,MAAM,CAAC,mBAAmB;YAC3B,CAAC;iBAAM,IAAI,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC3C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iCAAiC;gBACrE,MAAM;YACP,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,IAAA,gBAAI,EAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"deriveURLPath.js","sourceRoot":"","sources":["../../components/deriveURLPath.ts"],"names":[],"mappings":";;AAQA,sCAgDC;AArDD,SAAS,kBAAkB,CAAC,IAAY,EAAE,IAAY;IACrD,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,SAAgB,aAAa,CAAC,SAAkC,EAAE,IAAY,EAAE,IAA0B;IACzG,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,sDAAsD;IACvF,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB;IAC7C,CAAC;IAED,KAAK,IAAI,IAAI,IAAI,SAAS,CAAC,YAAY,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB;QAC7C,CAAC;QAED,IAAI,IAAI,KAAK,EAAE;YAAE,SAAS;QAE1B,QAAQ;QACR,uBAAuB;QACvB,uCAAuC;QACvC,oCAAoC;QACpC,+CAA+C;QAC/C,6DAA6D;QAC7D,kDAAkD;QAClD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACrB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC9B,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gCAAgC;gBAChE,MAAM;YACP,CAAC;iBAAM,IAAI,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC3C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iCAAiC;gBACrE,MAAM;YACP,CAAC;QACF,CAAC;QAED,cAAc;QACd,uBAAuB;QACvB,gBAAgB;QAChB,8BAA8B;QAC9B,4BAA4B;QAC5B,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAC1B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBACnB,IAAI,GAAG,EAAE,CAAC;gBACV,MAAM,CAAC,mBAAmB;YAC3B,CAAC;iBAAM,IAAI,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC3C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iCAAiC;gBACrE,MAAM;YACP,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,iFAAiF;AACvH,CAAC"}

package/dist/components/mcp/adapters/fastify.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Fastify adapter for the MCP transport core (operations port, #614).
+ *
+ * Maps Fastify's `(request, reply)` ↔ the transport's normalized
+ * Request/Response shape. The route is registered with the
+ * `authAndEnsureUserOnRequest` preValidation hook, so the authenticated
+ * user lands on `request.hdb_user` before this handler runs.
+ *
+ * Fastify auto-parses JSON request bodies; we re-stringify so the core's
+ * `parseMessage` sees the raw envelope it expects. The round-trip is
+ * cheap for the small JSON-RPC frames in the MCP wire format and keeps
+ * the core framework-agnostic.
+ */
+import { type McpProfile } from '../transport.ts';
+interface FastifyLikeRequest {
+    method: string;
+    headers: Record<string, string | string[] | undefined>;
+    body: unknown;
+    /**
+     * `authAndEnsureUserOnRequest` sets the full user (incl. role + permission
+     * tree) on `req.hdb_user`. Used for session binding (`username`) and
+     * forwarded as the transport's `userObject` for resource/tool RBAC.
+     */
+    hdb_user?: {
+        username?: string;
+        role?: unknown;
+    } | null;
+}
+interface FastifyLikeReply {
+    code: (status: number) => FastifyLikeReply;
+    header: (name: string, value: string) => FastifyLikeReply;
+    send: (body?: unknown) => unknown;
+}
+export declare function createFastifyHandler(profile: McpProfile): (request: FastifyLikeRequest, reply: FastifyLikeReply) => Promise<void>;
+export {};

package/dist/components/mcp/adapters/fastify.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFastifyHandler = createFastifyHandler;
+/**
+ * Fastify adapter for the MCP transport core (operations port, #614).
+ *
+ * Maps Fastify's `(request, reply)` ↔ the transport's normalized
+ * Request/Response shape. The route is registered with the
+ * `authAndEnsureUserOnRequest` preValidation hook, so the authenticated
+ * user lands on `request.hdb_user` before this handler runs.
+ *
+ * Fastify auto-parses JSON request bodies; we re-stringify so the core's
+ * `parseMessage` sees the raw envelope it expects. The round-trip is
+ * cheap for the small JSON-RPC frames in the MCP wire format and keeps
+ * the core framework-agnostic.
+ */
+const transport_ts_1 = require("../transport.js");
+function createFastifyHandler(profile) {
+    return async function mcpFastifyHandler(request, reply) {
+        const norm = {
+            method: request.method,
+            headers: normalizeHeaders(request.headers),
+            // Fastify has already parsed the JSON body into an object via its
+            // preParsing pipeline. Pass it through directly — the transport
+            // core's parseMessage accepts both strings and parsed values, so we
+            // avoid an unnecessary stringify/re-parse round trip on the hot path.
+            body: request.body,
+            user: request.hdb_user?.username ?? '',
+            userObject: (request.hdb_user ?? undefined),
+            profile,
+        };
+        const res = await (0, transport_ts_1.handleMcpRequest)(norm);
+        reply.code(res.status);
+        for (const [name, value] of Object.entries(res.headers)) {
+            reply.header(name, value);
+        }
+        if (res.jsonBody !== undefined) {
+            if (!res.headers['Content-Type'] && !res.headers['content-type']) {
+                reply.header('Content-Type', 'application/json');
+            }
+            reply.send(res.jsonBody);
+            return;
+        }
+        if (res.sseIterable !== undefined) {
+            // Reserved for #619 (server-push GET stream). Fastify will iterate
+            // the async iterable and write SSE frames via the contentTypes
+            // serializer at `server/serverHelpers/contentTypes.ts:128-162`.
+            if (!res.headers['Content-Type'] && !res.headers['content-type']) {
+                reply.header('Content-Type', 'text/event-stream');
+            }
+            reply.header('Cache-Control', 'no-store');
+            reply.send(res.sseIterable);
+            return;
+        }
+        // 202/204/4xx with empty body.
+        reply.send();
+    };
+}
+function normalizeHeaders(headers) {
+    const out = {};
+    for (const [name, value] of Object.entries(headers)) {
+        out[name.toLowerCase()] = Array.isArray(value) ? value[0] : value;
+    }
+    return out;
+}
+//# sourceMappingURL=fastify.js.map

package/dist/components/mcp/adapters/fastify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify.js","sourceRoot":"","sources":["../../../../components/mcp/adapters/fastify.ts"],"names":[],"mappings":";;AAiCA,oDA6CC;AA9ED;;;;;;;;;;;;GAYG;AACH,kDAAsF;AAoBtF,SAAgB,oBAAoB,CAAC,OAAmB;IACvD,OAAO,KAAK,UAAU,iBAAiB,CAAC,OAA2B,EAAE,KAAuB;QAC3F,MAAM,IAAI,GAAgB;YACzB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC;YAC1C,kEAAkE;YAClE,gEAAgE;YAChE,oEAAoE;YACpE,sEAAsE;YACtE,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,IAAI,EAAE;YACtC,UAAU,EAAE,CAAC,OAAO,CAAC,QAAQ,IAAI,SAAS,CAA8B;YACxE,OAAO;SACP,CAAC;QAEF,MAAM,GAAG,GAAG,MAAM,IAAA,+BAAgB,EAAC,IAAI,CAAC,CAAC;QAEzC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACzD,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;gBAClE,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;YAClD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACzB,OAAO;QACR,CAAC;QAED,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACnC,mEAAmE;YACnE,+DAA+D;YAC/D,gEAAgE;YAChE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;gBAClE,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;YACnD,CAAC;YACD,KAAK,CAAC,MAAM,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAC5B,OAAO;QACR,CAAC;QAED,+BAA+B;QAC/B,KAAK,CAAC,IAAI,EAAE,CAAC;IACd,CAAC,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAsD;IAC/E,MAAM,GAAG,GAAuC,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACnE,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/components/mcp/adapters/harperHttp.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Harper-HTTP adapter for the MCP transport core (application port, #614).
+ *
+ * Maps Harper's HTTP handler signature `(request, nextHandler) => { status,
+ * headers, body }` to/from the transport's normalized Request/Response.
+ * Auth runs upstream via `{ after: 'authentication' }` on the registration,
+ * so `request.user` is already populated when this handler fires.
+ *
+ * SSE responses (reserved for #619) are returned as `{ body: iterable,
+ * headers: { 'content-type': 'text/event-stream' } }`. Harper's serializer
+ * at `server/serverHelpers/contentTypes.ts:128-162` picks the SSE writer
+ * automatically and pipes the iterable to the wire.
+ */
+import { type McpProfile } from '../transport.ts';
+interface HarperHttpRequest {
+    method: string;
+    headers: Iterable<[string, string | string[]]> & {
+        get?: (name: string) => string | undefined;
+    };
+    body?: AsyncIterable<Buffer | string>;
+    /**
+     * Full user object as Harper's auth pipeline attaches it (includes role +
+     * permission tree). Transport reads `username` for session binding and
+     * forwards the full object as `userObject` for resource/tool RBAC.
+     */
+    user?: {
+        username?: string;
+        role?: unknown;
+    };
+    isWebSocket?: boolean;
+}
+interface HarperHttpResponse {
+    status: number;
+    headers: Record<string, string>;
+    body?: unknown;
+}
+export declare function createHarperHttpHandler(profile: McpProfile): (request: HarperHttpRequest, nextHandler: (req: HarperHttpRequest) => unknown) => Promise<HarperHttpResponse | unknown>;
+export {};