orbitdb-relay-pinner 0.8.0 → 0.9.1

package/.env.example

@@ -63,6 +63,16 @@
 # TEST_PRIVATE_KEY=
 # RELAY_PRIV_KEY=
 
+# --- Optional libp2p connectivity debug protocols ---
+# Expose /connectivity-echo/1.0.0 for line-based echo tests.
+# RELAY_CONNECTIVITY_ECHO_ENABLED=false
+# Expose /connectivity-bulk/1.0.0 for framed bulk round-trip tests.
+# RELAY_CONNECTIVITY_BULK_ENABLED=false
+# Optional bulk protocol tuning (defaults: 262144 bytes, 10000ms read, 30000ms idle).
+# RELAY_CONNECTIVITY_BULK_MAX_FRAME_BYTES=262144
+# RELAY_CONNECTIVITY_BULK_READ_TIMEOUT_MS=10000
+# RELAY_CONNECTIVITY_BULK_IDLE_TIMEOUT_MS=30000
+
 # --- TLS (optional) ---
 # disableAutoTLS=
 # STAGING=false

package/README.md

@@ -20,7 +20,7 @@ See `AGENTS.md` for an architecture and feature guide (entrypoints, data flow, e
 Install:
 
 ```bash
-npm i orbitdb-relay-pinner
+npm i -g orbitdb-relay-pinner
 ```
 
 Run:
@@ -29,6 +29,46 @@ Run:
 orbitdb-relay-pinner
 ```
 
+Optional connectivity debug protocols for test tooling are disabled by default in the CLI/runtime. Enable them with env vars before startup:
+
+```bash
+RELAY_CONNECTIVITY_ECHO_ENABLED=1 orbitdb-relay-pinner
+RELAY_CONNECTIVITY_BULK_ENABLED=1 orbitdb-relay-pinner
+```
+
+Bulk tuning is also available through `RELAY_CONNECTIVITY_BULK_MAX_FRAME_BYTES`, `RELAY_CONNECTIVITY_BULK_READ_TIMEOUT_MS`, and `RELAY_CONNECTIVITY_BULK_IDLE_TIMEOUT_MS`.
+
+Default listener ports:
+
+- TCP: `9091` via `RELAY_TCP_PORT`
+- WebSocket: `9092` via `RELAY_WS_PORT`
+- WebRTC-direct: `9093` via `RELAY_WEBRTC_PORT`
+- QUIC: `9094` via `RELAY_QUIC_PORT`
+- Metrics HTTP: `9090` via `METRICS_PORT`
+- Metrics HTTPS: `9443` via `METRICS_HTTPS_PORT` when `METRICS_HTTPS_ENABLED=1`
+
+AutoTLS notes:
+
+- AutoTLS is enabled by default. It is only disabled if `disableAutoTLS` is set in the environment.
+- The default startup logs do not print much AutoTLS-specific output, so it is normal not to see certificate activity unless you enable the relevant debug namespaces.
+- When AutoTLS has provisioned a certificate for the WebSocket listener, the relay should advertise secure WebSocket multiaddrs ending in `/tls/ws`.
+- If you use `VITE_APPEND_ANNOUNCE`, keep the public WebSocket address as plain `/ws` with your real public IP and port. Do not manually change it to `/tls/ws`; AutoTLS/domain mapping adds the secure advertised addresses at runtime.
+- To verify WSS is live, check `GET /multiaddrs` and look for entries containing `/tls/ws`.
+
+Show AutoTLS logs:
+
+```bash
+DEBUG='libp2p:auto-tls,libp2p:auto-tls:*,libp2p:websockets:listener' ENABLE_GENERAL_LOGS=1 orbitdb-relay-pinner
+```
+
+If you also want the relay to expose the metrics routes over HTTPS once AutoTLS has provisioned a certificate:
+
+```bash
+METRICS_HTTPS_ENABLED=1 DEBUG='libp2p:auto-tls,libp2p:auto-tls:*,libp2p:websockets:listener' ENABLE_GENERAL_LOGS=1 orbitdb-relay-pinner
+```
+
+With those flags enabled, you should see AutoTLS messages such as certificate fetch attempts, reasons it is not fetching yet, and WebSocket HTTPS listener updates.
+
 Test mode (deterministic peer id via `TEST_PRIVATE_KEY` or `RELAY_PRIV_KEY`):
 
 ```bash
@@ -41,7 +81,13 @@ The package still exports `startRelay()` as the compatibility wrapper used by th
 
 For a fuller install + integration walkthrough, see `docs/libp2p-service.md`.
 
-It also exports `orbitdbReplicationService()` so the OrbitDB replication + Helia pinning logic can be mounted directly in any libp2p node:
+It also exports reusable building blocks for embedded consumers:
+
+- `orbitdbReplicationService()`
+- `connectivityDebugProtocolsService()` for opt-in test/debug echo + bulk protocols
+- `createPinningHttpRequestHandler()` and `PinningHttpServer` for `/health`, `/multiaddrs`, `/pinning/*`, and `/ipfs/*`
+
+`orbitdbReplicationService()` mounts the OrbitDB replication + Helia pinning logic directly in any libp2p node:
 
 ```ts
 import { createLibp2p } from 'libp2p'

package/dist/http/pinning-http.d.ts

@@ -0,0 +1,53 @@
+import http from 'http';
+import https from 'https';
+import type { PinningHttpHandlers } from '../services/metrics.js';
+export type Libp2pLike = {
+    peerId?: {
+        toString: () => string;
+        toCID?: () => {
+            bytes: Uint8Array;
+        };
+    };
+    getMultiaddrs?: () => Array<{
+        toString: () => string;
+    }>;
+    getConnections?: () => unknown[];
+};
+type HeliaLike = any;
+export type PinningHttpFallbackMode = 'pinned-only' | 'pinned-first-network-fallback';
+export type PinningHttpRequestHandlerOptions = {
+    getLibp2p?: () => Libp2pLike | null;
+    pinning?: PinningHttpHandlers;
+    getHelia?: () => HeliaLike | null;
+    ipfsGateway?: {
+        enabled?: boolean;
+        fallbackMode?: PinningHttpFallbackMode;
+        catTimeoutMs?: number;
+    };
+    cors?: {
+        origin?: '*' | string[];
+        allowHeaders?: string[];
+        maxAgeSeconds?: number;
+    };
+    getMetricsHttpsInfo?: () => Record<string, unknown> | null;
+};
+export type JsonErrorCode = 'bad_request' | 'invalid_json' | 'missing_db_address' | 'database_not_found' | 'sync_failed' | 'invalid_cid' | 'invalid_path_encoding' | 'directory_path_required' | 'ipfs_unavailable' | 'content_not_found' | 'gateway_timeout' | 'internal_error';
+export declare function isManagedPinningHttpPath(pathname: string): boolean;
+export declare function createPinningHttpRequestHandler(options?: PinningHttpRequestHandlerOptions): (req: http.IncomingMessage, res: http.ServerResponse) => Promise<void>;
+export type PinningHttpServerOptions = PinningHttpRequestHandlerOptions & {
+    port?: number;
+    host?: string;
+    tls?: {
+        cert: string | Buffer;
+        key: string | Buffer;
+    } | null;
+};
+export declare class PinningHttpServer {
+    private readonly options;
+    private server;
+    constructor(options?: PinningHttpServerOptions);
+    start(): Promise<http.Server | https.Server>;
+    stop(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=pinning-http.d.ts.map

package/dist/http/pinning-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinning-http.d.ts","sourceRoot":"","sources":["../../src/http/pinning-http.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAEjE,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM;YAAE,KAAK,EAAE,UAAU,CAAA;SAAE,CAAA;KAAE,CAAA;IACxE,aAAa,CAAC,EAAE,MAAM,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;KAAE,CAAC,CAAA;IACvD,cAAc,CAAC,EAAE,MAAM,OAAO,EAAE,CAAA;CACjC,CAAA;AAED,KAAK,SAAS,GAAG,GAAG,CAAA;AAEpB,MAAM,MAAM,uBAAuB,GAAG,aAAa,GAAG,+BAA+B,CAAA;AAErF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,SAAS,CAAC,EAAE,MAAM,UAAU,GAAG,IAAI,CAAA;IACnC,OAAO,CAAC,EAAE,mBAAmB,CAAA;IAC7B,QAAQ,CAAC,EAAE,MAAM,SAAS,GAAG,IAAI,CAAA;IACjC,WAAW,CAAC,EAAE;QACZ,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,YAAY,CAAC,EAAE,uBAAuB,CAAA;QACtC,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,IAAI,CAAC,EAAE;QACL,MAAM,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE,CAAA;QACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;QACvB,aAAa,CAAC,EAAE,MAAM,CAAA;KACvB,CAAA;IACD,mBAAmB,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAC3D,CAAA;AAED,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,cAAc,GACd,oBAAoB,GACpB,oBAAoB,GACpB,aAAa,GACb,aAAa,GACb,uBAAuB,GACvB,yBAAyB,GACzB,kBAAkB,GAClB,mBAAmB,GACnB,iBAAiB,GACjB,gBAAgB,CAAA;AAiMpB,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CASlE;AAED,wBAAgB,+BAA+B,CAAC,OAAO,GAAE,gCAAqC,IAM9E,KAAK,IAAI,CAAC,eAAe,EAAE,KAAK,IAAI,CAAC,cAAc,KAAG,OAAO,CAAC,IAAI,CAAC,CA+JlF;AAED,MAAM,MAAM,wBAAwB,GAAG,gCAAgC,GAAG;IACxE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAC7D,CAAA;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,MAAM,CAA0C;gBAE5C,OAAO,GAAE,wBAA6B;IAI5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAa5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ5B"}

package/dist/http/pinning-http.js

@@ -0,0 +1,379 @@
+import http from 'http';
+import https from 'https';
+import { unixfs } from '@helia/unixfs';
+import { CID } from 'multiformats/cid';
+const MAX_JSON_BODY_BYTES = 16_384;
+const DEFAULT_CAT_TIMEOUT_MS = 120_000;
+function pathnameOnly(urlValue) {
+    return (urlValue ?? '/').split('?')[0] || '/';
+}
+function firstSearchParam(reqUrl, names) {
+    const url = new URL(reqUrl || '/', 'http://pinning.local');
+    for (const name of names) {
+        const value = url.searchParams.get(name);
+        if (value != null && value.trim() !== '')
+            return value.trim();
+    }
+    return '';
+}
+function isPublicAddress(addr) {
+    if (!addr)
+        return false;
+    if (addr.includes('/ip4/127.'))
+        return false;
+    if (addr.includes('/ip4/10.'))
+        return false;
+    if (addr.includes('/ip4/192.168.'))
+        return false;
+    const m = addr.match(/\/ip4\/172\.(\d+)\./);
+    if (m) {
+        const octet = Number(m[1]);
+        if (octet >= 16 && octet <= 31)
+            return false;
+    }
+    if (addr.includes('/ip6/::1'))
+        return false;
+    if (addr.includes('/ip6/fc') || addr.includes('/ip6/fd'))
+        return false;
+    return true;
+}
+function prioritizeAddresses(addrs) {
+    return [...addrs].sort((a, b) => {
+        const aPublic = isPublicAddress(a);
+        const bPublic = isPublicAddress(b);
+        if (aPublic !== bPublic)
+            return aPublic ? -1 : 1;
+        return a.localeCompare(b);
+    });
+}
+function applyCorsHeaders(req, res, config) {
+    const originConfig = config?.origin ?? '*';
+    const requestOrigin = req.headers.origin;
+    let allowOrigin;
+    if (originConfig === '*') {
+        allowOrigin = '*';
+    }
+    else if (requestOrigin && originConfig.includes(requestOrigin)) {
+        allowOrigin = requestOrigin;
+        res.setHeader('Vary', 'Origin');
+    }
+    if (allowOrigin) {
+        res.setHeader('Access-Control-Allow-Origin', allowOrigin);
+    }
+    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS, HEAD');
+    res.setHeader('Access-Control-Allow-Headers', (config?.allowHeaders && config.allowHeaders.length > 0
+        ? config.allowHeaders.join(', ')
+        : 'Content-Type, Authorization'));
+    res.setHeader('Access-Control-Max-Age', String(config?.maxAgeSeconds ?? 86400));
+}
+function sendJson(res, status, body) {
+    res.statusCode = status;
+    res.setHeader('Content-Type', 'application/json');
+    res.end(JSON.stringify(body));
+}
+function sendError(res, status, code, error) {
+    sendJson(res, status, { ok: false, code, error });
+}
+async function readJsonBody(req) {
+    const chunks = [];
+    let total = 0;
+    for await (const chunk of req) {
+        const buf = chunk;
+        total += buf.length;
+        if (total > MAX_JSON_BODY_BYTES) {
+            throw new Error('body too large');
+        }
+        chunks.push(buf);
+    }
+    if (chunks.length === 0)
+        return {};
+    try {
+        return JSON.parse(Buffer.concat(chunks).toString('utf8'));
+    }
+    catch {
+        const error = new Error('Invalid JSON body');
+        error.code = 'invalid_json';
+        throw error;
+    }
+}
+function parseIpfsRequest(req) {
+    if (req.method !== 'GET')
+        return { handled: false };
+    const pathname = pathnameOnly(req.url);
+    if (!pathname.startsWith('/ipfs/'))
+        return { handled: false };
+    let parts;
+    try {
+        parts = pathname
+            .slice('/ipfs/'.length)
+            .split('/')
+            .filter((part) => part.length > 0)
+            .map((part) => decodeURIComponent(part));
+    }
+    catch {
+        return { handled: true, ok: false, status: 400, code: 'invalid_path_encoding', error: 'Invalid path encoding' };
+    }
+    if (parts.length === 0) {
+        return { handled: true, ok: false, status: 400, code: 'bad_request', error: 'Missing CID' };
+    }
+    return {
+        handled: true,
+        ok: true,
+        cidStr: parts[0],
+        pathWithin: parts.length > 1 ? parts.slice(1).join('/') : undefined,
+    };
+}
+async function streamNetworkFallback(res, helia, parsed, timeoutMs) {
+    let cid;
+    try {
+        cid = CID.parse(parsed.cidStr);
+    }
+    catch {
+        sendError(res, 400, 'invalid_cid', 'Invalid CID');
+        return;
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(new Error('gateway timeout')), timeoutMs);
+    const fsApi = unixfs(helia);
+    const opts = {
+        signal: controller.signal,
+        ...(parsed.pathWithin ? { path: parsed.pathWithin } : {}),
+    };
+    try {
+        const stat = await fsApi.stat(cid, opts);
+        if (stat.type === 'directory') {
+            sendError(res, 400, 'directory_path_required', 'Directory download is not supported; specify a file path under the CID');
+            return;
+        }
+        res.statusCode = 200;
+        res.setHeader('Content-Type', 'application/octet-stream');
+        res.setHeader('Cache-Control', 'private, no-store');
+        for await (const chunk of fsApi.cat(cid, opts)) {
+            if (!res.write(chunk)) {
+                await new Promise((resolve, reject) => {
+                    res.once('drain', resolve);
+                    res.once('error', reject);
+                });
+            }
+        }
+        res.end();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.toLowerCase().includes('abort')) {
+            sendError(res, 504, 'gateway_timeout', 'Timed out while fetching CID over libp2p');
+            return;
+        }
+        if (message.includes('ERR_NOT_FOUND') ||
+            message.toLowerCase().includes('not found') ||
+            message.toLowerCase().includes('missing block') ||
+            message.toLowerCase().includes('no links named')) {
+            sendError(res, 404, 'content_not_found', 'Content not found on relay or network');
+            return;
+        }
+        if (!res.headersSent) {
+            sendError(res, 502, 'internal_error', message);
+        }
+        else {
+            try {
+                res.destroy(error instanceof Error ? error : undefined);
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+export function isManagedPinningHttpPath(pathname) {
+    return (pathname === '/health' ||
+        pathname === '/multiaddrs' ||
+        pathname === '/pinning/stats' ||
+        pathname === '/pinning/databases' ||
+        pathname === '/pinning/sync' ||
+        pathname.startsWith('/ipfs/'));
+}
+export function createPinningHttpRequestHandler(options = {}) {
+    const fallbackMode = options.ipfsGateway?.fallbackMode ?? 'pinned-first-network-fallback';
+    const catTimeoutMs = Number.isFinite(options.ipfsGateway?.catTimeoutMs)
+        ? Math.max(1, Math.trunc(options.ipfsGateway?.catTimeoutMs))
+        : DEFAULT_CAT_TIMEOUT_MS;
+    return async (req, res) => {
+        applyCorsHeaders(req, res, options.cors);
+        if (req.method === 'OPTIONS') {
+            res.statusCode = 204;
+            res.end();
+            return;
+        }
+        const pathname = pathnameOnly(req.url);
+        const pinning = options.pinning;
+        if (pathname === '/health' && req.method === 'GET') {
+            const libp2p = options.getLibp2p?.() ?? null;
+            const connections = libp2p?.getConnections?.() || [];
+            const multiaddrs = (libp2p?.getMultiaddrs?.() || []).map((ma) => ma.toString());
+            const metricsHttpsInfo = options.getMetricsHttpsInfo?.() ?? null;
+            sendJson(res, 200, {
+                status: 'ok',
+                peerId: libp2p?.peerId?.toString?.() || null,
+                connections: { active: connections.length },
+                multiaddrs: multiaddrs.length,
+                autoTlsServingZone: metricsHttpsInfo != null && 'autoTlsServingZone' in metricsHttpsInfo
+                    ? metricsHttpsInfo.autoTlsServingZone
+                    : null,
+                metricsHttps: metricsHttpsInfo,
+                timestamp: new Date().toISOString(),
+            });
+            return;
+        }
+        if (pathname === '/multiaddrs' && req.method === 'GET') {
+            const libp2p = options.getLibp2p?.() ?? null;
+            const all = prioritizeAddresses((libp2p?.getMultiaddrs?.() || []).map((ma) => ma.toString()));
+            const byTransport = {
+                webrtc: all.filter((ma) => ma.includes('/webrtc')),
+                tcp: all.filter((ma) => ma.includes('/tcp/') && !ma.includes('/ws')),
+                websocket: all.filter((ma) => ma.includes('/ws')),
+            };
+            const metricsHttpsInfo = options.getMetricsHttpsInfo?.() ?? null;
+            sendJson(res, 200, {
+                peerId: libp2p?.peerId?.toString?.() || null,
+                all,
+                byTransport,
+                best: {
+                    webrtc: byTransport.webrtc[0] || null,
+                    websocket: byTransport.websocket[0] || null,
+                    tcp: byTransport.tcp[0] || null,
+                },
+                autoTlsServingZone: metricsHttpsInfo != null && 'autoTlsServingZone' in metricsHttpsInfo
+                    ? metricsHttpsInfo.autoTlsServingZone
+                    : null,
+                metricsHttps: metricsHttpsInfo,
+                timestamp: new Date().toISOString(),
+            });
+            return;
+        }
+        if (pinning && pathname === '/pinning/stats' && req.method === 'GET') {
+            sendJson(res, 200, pinning.getStats());
+            return;
+        }
+        if (pinning && pathname === '/pinning/databases' && req.method === 'GET') {
+            const filterRaw = firstSearchParam(req.url, ['address', 'dbAddress']);
+            const payload = pinning.getDatabases(filterRaw ? { address: filterRaw } : undefined);
+            if (filterRaw && payload.total === 0) {
+                sendError(res, 404, 'database_not_found', 'Database address not found in relay sync history');
+                return;
+            }
+            sendJson(res, 200, payload);
+            return;
+        }
+        if (pinning && pathname === '/pinning/sync' && req.method === 'POST') {
+            try {
+                const body = (await readJsonBody(req));
+                const fromBody = typeof body?.dbAddress === 'string' ? body.dbAddress.trim() : '';
+                const fromQuery = firstSearchParam(req.url, ['dbAddress', 'address']);
+                const dbAddress = fromBody || fromQuery;
+                if (!dbAddress) {
+                    sendError(res, 400, 'missing_db_address', 'Missing or invalid dbAddress');
+                    return;
+                }
+                const result = await pinning.syncDatabase(dbAddress);
+                if (!result.ok) {
+                    sendError(res, 500, 'sync_failed', result.error || 'sync failed');
+                    return;
+                }
+                sendJson(res, 200, {
+                    ok: true,
+                    dbAddress,
+                    receivedUpdate: result.receivedUpdate ?? false,
+                    fallbackScanUsed: result.fallbackScanUsed ?? false,
+                    extractedMediaCids: result.extractedMediaCids ?? [],
+                    ...(result.coalesced ? { coalesced: true } : {}),
+                });
+            }
+            catch (error) {
+                const code = error?.code === 'invalid_json' ? 'invalid_json' : 'bad_request';
+                sendError(res, 400, code, error?.message || String(error));
+            }
+            return;
+        }
+        const parsed = parseIpfsRequest(req);
+        if (parsed.handled) {
+            if (!parsed.ok) {
+                sendError(res, parsed.status, parsed.code, parsed.error);
+                return;
+            }
+            if (options.ipfsGateway?.enabled === false) {
+                sendError(res, 404, 'content_not_found', 'IPFS gateway is disabled');
+                return;
+            }
+            const pinnedResult = pinning?.streamPinnedCid == null ? null : await pinning.streamPinnedCid(parsed.cidStr, parsed.pathWithin);
+            if (pinnedResult?.ok) {
+                res.statusCode = 200;
+                res.setHeader('Content-Type', pinnedResult.contentType || 'application/octet-stream');
+                res.setHeader('Cache-Control', 'private, no-store');
+                for await (const chunk of pinnedResult.chunks) {
+                    if (!res.write(chunk)) {
+                        await new Promise((resolve, reject) => {
+                            res.once('drain', resolve);
+                            res.once('error', reject);
+                        });
+                    }
+                }
+                res.end();
+                return;
+            }
+            if (fallbackMode === 'pinned-only') {
+                const status = pinnedResult?.status ?? 404;
+                const error = pinnedResult?.error ?? 'Content not pinned locally';
+                const code = status === 503 ? 'ipfs_unavailable' : status === 400 ? 'invalid_cid' : 'content_not_found';
+                sendError(res, status, code, error);
+                return;
+            }
+            if (pinnedResult != null && pinnedResult.status !== 404) {
+                const code = pinnedResult.status === 503 ? 'ipfs_unavailable' : pinnedResult.status === 400 ? 'invalid_cid' : 'internal_error';
+                sendError(res, pinnedResult.status, code, pinnedResult.error);
+                return;
+            }
+            const helia = options.getHelia?.() ?? null;
+            if (helia == null) {
+                sendError(res, 503, 'ipfs_unavailable', 'Helia gateway is not available');
+                return;
+            }
+            await streamNetworkFallback(res, helia, parsed, catTimeoutMs);
+            return;
+        }
+        res.statusCode = 404;
+        res.end('Not found');
+    };
+}
+export class PinningHttpServer {
+    options;
+    server = null;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async start() {
+        if (this.server != null)
+            return this.server;
+        const listener = createPinningHttpRequestHandler(this.options);
+        this.server = this.options.tls
+            ? https.createServer(this.options.tls, listener)
+            : http.createServer(listener);
+        await new Promise((resolve, reject) => {
+            this.server.once('error', reject);
+            this.server.listen(this.options.port ?? 9090, this.options.host ?? '0.0.0.0', () => resolve());
+        });
+        return this.server;
+    }
+    async stop() {
+        if (this.server == null)
+            return;
+        const server = this.server;
+        this.server = null;
+        await new Promise((resolve) => {
+            server.close(() => resolve());
+        });
+    }
+}
+//# sourceMappingURL=pinning-http.js.map

package/dist/http/pinning-http.js.map

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

package/dist/index.d.ts

@@ -2,4 +2,9 @@ export type { RelayOptions, RelayRuntime } from './relay.js';
 export { startRelay } from './relay.js';
 export type { OrbitdbReplicationServiceApi, OrbitdbReplicationServiceInit } from './services/orbitdb-replication-service.js';
 export { orbitdbReplicationService } from './services/orbitdb-replication-service.js';
+export type { PinningHttpHandlers } from './services/metrics.js';
+export type { ConnectivityDebugProtocolsServiceInit } from './services/connectivity-debug-protocols-service.js';
+export { CONNECTIVITY_BULK_PROTOCOL, CONNECTIVITY_ECHO_PROTOCOL, connectivityDebugProtocolsService, } from './services/connectivity-debug-protocols-service.js';
+export type { Libp2pLike as PinningHttpLibp2pLike, PinningHttpFallbackMode, PinningHttpRequestHandlerOptions, PinningHttpServerOptions, } from './http/pinning-http.js';
+export { PinningHttpServer, createPinningHttpRequestHandler, isManagedPinningHttpPath, } from './http/pinning-http.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,YAAY,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAA;AAC5H,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,YAAY,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAA;AAC5H,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAA;AACrF,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChE,YAAY,EAAE,qCAAqC,EAAE,MAAM,oDAAoD,CAAA;AAC/G,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,oDAAoD,CAAA;AAC3D,YAAY,EACV,UAAU,IAAI,qBAAqB,EACnC,uBAAuB,EACvB,gCAAgC,EAChC,wBAAwB,GACzB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,iBAAiB,EACjB,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,wBAAwB,CAAA"}

package/dist/index.js

@@ -1,3 +1,5 @@
 export { startRelay } from './relay.js';
 export { orbitdbReplicationService } from './services/orbitdb-replication-service.js';
+export { CONNECTIVITY_BULK_PROTOCOL, CONNECTIVITY_ECHO_PROTOCOL, connectivityDebugProtocolsService, } from './services/connectivity-debug-protocols-service.js';
+export { PinningHttpServer, createPinningHttpRequestHandler, isManagedPinningHttpPath, } from './http/pinning-http.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAA;AAGrF,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,oDAAoD,CAAA;AAO3D,OAAO,EACL,iBAAiB,EACjB,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,wBAAwB,CAAA"}

package/dist/relay.d.ts

@@ -1,6 +1,13 @@
+import { type ConnectivityDebugProtocolsServiceInit } from './services/connectivity-debug-protocols-service.js';
 export type RelayOptions = {
     testMode?: boolean;
     storageDir?: string;
+    debugProtocols?: ConnectivityDebugProtocolsServiceInit;
+    pinningHttp?: {
+        enabled?: boolean;
+        fallbackMode?: 'pinned-only' | 'pinned-first-network-fallback';
+        catTimeoutMs?: number;
+    };
 };
 export type RelayRuntime = {
     stop: () => Promise<void>;

package/dist/relay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B,CAAA;AAwDD,wBAAsB,UAAU,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAsE/E"}
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"AASA,OAAO,EAAqC,KAAK,qCAAqC,EAAE,MAAM,oDAAoD,CAAA;AAKlJ,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,qCAAqC,CAAA;IACtD,WAAW,CAAC,EAAE;QACZ,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,YAAY,CAAC,EAAE,aAAa,GAAG,+BAA+B,CAAA;QAC9D,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;CACF,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B,CAAA;AA+HD,wBAAsB,UAAU,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAkF/E"}