@pkcprotocol/pkc-js 0.0.44 → 0.0.46

package/dist/browser/runtime/node/compile-cache.js

@@ -0,0 +1,29 @@
+// Enables Node's on-disk V8 compile cache (issue #120). Caching the compiled bytecode
+// recovers the parse/compile portion of import time (~29% of the post-lazy-load cost) on
+// every run after the first.
+//
+// V8 only caches modules compiled AFTER the cache is enabled — and Node's ESM loader
+// compiles the entire static import graph before any module body runs. So calling this
+// from inside index.ts would never cover the package's own graph; it must be called from
+// a thin bootstrap entry (index-with-compile-cache.ts) BEFORE the real entry is
+// dynamic-imported.
+//
+// Designed to be a quiet optimization, never fatal:
+// - no-op on Node < 22.8 (enableCompileCache doesn't exist there; engines allows >= 22)
+// - cache dir is Node's default (os.tmpdir()/node-compile-cache), overridable with the
+//   NODE_COMPILE_CACHE env var; consumers can opt out with NODE_DISABLE_COMPILE_CACHE=1
+// - enableCompileCache itself reports failures via its return value instead of throwing,
+//   but we still guard with try/catch in case of exotic runtimes
+// Default import, not a named import: named imports of builtins are validated at link
+// time, so `import { enableCompileCache }` would throw on Node 22.0-22.7.
+import nodeModule from "node:module";
+export function enableNodeCompileCache() {
+    try {
+        if (typeof nodeModule.enableCompileCache === "function")
+            nodeModule.enableCompileCache();
+    }
+    catch {
+        // compile cache is an optimization only — never let it break startup
+    }
+}
+//# sourceMappingURL=compile-cache.js.map

package/dist/browser/runtime/node/compile-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-cache.js","sourceRoot":"","sources":["../../../../src/runtime/browser/compile-cache.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,yFAAyF;AACzF,6BAA6B;AAC7B,EAAE;AACF,qFAAqF;AACrF,uFAAuF;AACvF,yFAAyF;AACzF,gFAAgF;AAChF,oBAAoB;AACpB,EAAE;AACF,oDAAoD;AACpD,wFAAwF;AACxF,uFAAuF;AACvF,wFAAwF;AACxF,yFAAyF;AACzF,iEAAiE;AAEjE,sFAAsF;AACtF,0EAA0E;AAC1E,OAAO,UAAU,MAAM,aAAa,CAAC;AAErC,MAAM,UAAU,sBAAsB;IAClC,IAAI,CAAC;QACD,IAAI,OAAO,UAAU,CAAC,kBAAkB,KAAK,UAAU;YAAE,UAAU,CAAC,kBAAkB,EAAE,CAAC;IAC7F,CAAC;IAAC,MAAM,CAAC;QACL,qEAAqE;IACzE,CAAC;AACL,CAAC"}

package/dist/browser/runtime/node/setup-kubo-http-routers.d.ts

@@ -0,0 +1,2 @@
+import { PKC } from "../../pkc/pkc.js";
+export declare function setupKuboHttpRouters(pkc: PKC): Promise<void>;

package/dist/browser/runtime/node/{setup-kubo-address-rewriter-and-http-router.js → setup-kubo-http-routers.js}

@@ -1,9 +1,7 @@
 import retry from "retry";
-import { AddressesRewriterProxyServer } from "./addresses-rewriter-proxy-server.js";
 import Logger from "../../logger.js";
 import { PKCError } from "../../pkc-error.js";
 import * as remeda from "remeda";
-import tcpPortUsed from "tcp-port-used";
 function _mergeRouterConfigs(existingConfig, newConfig) {
     if (!existingConfig?.Routers)
         return newConfig;
@@ -107,85 +105,21 @@ async function _setHttpRouterOptionsOnKuboNode(kuboClient, routingValue) {
         }
     }
 }
-async function _getStartedProxyUrl(pkc, httpRouterUrl) {
+export async function setupKuboHttpRouters(pkc) {
     if (pkc.destroyed)
-        return undefined;
-    const mappingKeyName = `httprouter_proxy_${httpRouterUrl}`;
-    try {
-        const urlOfProxyOfHttpRouter = await pkc._storage.getItem(mappingKeyName);
-        if (pkc.destroyed)
-            return undefined;
-        if (urlOfProxyOfHttpRouter) {
-            const proxyHttpUrl = new URL(urlOfProxyOfHttpRouter);
-            if (await tcpPortUsed.check(Number(proxyHttpUrl.port), "127.0.0.1"))
-                return urlOfProxyOfHttpRouter;
-            if (pkc.destroyed)
-                return undefined;
-            await pkc._storage.removeItem(mappingKeyName);
-        }
-        return undefined;
-    }
-    catch (error) {
-        if (pkc.destroyed && error instanceof Error && error.message.includes("database connection is not open")) {
-            return undefined;
-        }
-        throw error;
-    }
-}
-export async function setupKuboAddressesRewriterAndHttpRouters(pkc) {
-    if (pkc.destroyed) {
-        return {
-            destroy: async () => { }
-        };
-    }
+        return;
     if (!Array.isArray(pkc.kuboRpcClientsOptions) || pkc.kuboRpcClientsOptions.length <= 0)
         throw Error("need ipfs http client to be defined");
     if (!Array.isArray(pkc.httpRoutersOptions) || pkc.httpRoutersOptions.length <= 0)
         throw Error("Need http router options to defined");
-    const log = Logger("pkc-js:node:setupKuboAddressesRewriterAndHttpRouters");
-    // Set up http proxies first to rewrite addresses
-    const httpRouterProxyUrls = [];
-    const proxyServers = [];
-    let addressesRewriterStartPort = 19575; // use port 19575 as first port, looks like IPRTR (IPFS ROUTER)
-    for (const httpRouter of pkc.httpRoutersOptions) {
-        if (pkc.destroyed)
-            break;
-        const startedProxyUrl = await _getStartedProxyUrl(pkc, httpRouter);
-        if (startedProxyUrl) {
-            httpRouterProxyUrls.push(startedProxyUrl);
-            continue;
-        }
-        // launch the proxy server
-        let port = addressesRewriterStartPort;
-        const hostname = "127.0.0.1";
-        while (await tcpPortUsed.check(port, hostname))
-            // keep increasing port till we find an empty port
-            port++;
-        const addressesRewriterProxyServer = new AddressesRewriterProxyServer({
-            kuboClients: Object.values(pkc.clients.kuboRpcClients).map((kubo) => kubo._client),
-            port,
-            hostname,
-            proxyTargetUrl: httpRouter,
-            pkc
-        });
-        await addressesRewriterProxyServer.listen();
-        if (pkc.destroyed) {
-            await addressesRewriterProxyServer.destroy();
-            break;
-        }
-        proxyServers.push(addressesRewriterProxyServer);
-        // save the proxy urls to use them later
-        const httpRouterProxyUrl = `http://${hostname}:${port}`;
-        httpRouterProxyUrls.push(httpRouterProxyUrl);
-    }
-    httpRouterProxyUrls.sort(); // make sure it's always the same order
-    // Set up http routers to use proxies
+    const httpRouterUrls = [...pkc.httpRoutersOptions].sort(); // make sure it's always the same order
+    // Set up http routers directly on the kubo nodes
     const kuboClients = pkc.clients.kuboRpcClients;
     const httpRoutersConfig = {
         HttpRoutersParallel: { Type: "parallel", Parameters: { Routers: [] } },
         HttpRouterNotSupported: { Type: "http", Parameters: { Endpoint: "http://kubohttprouternotsupported" } }
     };
-    for (const [i, httpRouterUrl] of httpRouterProxyUrls.entries()) {
+    for (const [i, httpRouterUrl] of httpRouterUrls.entries()) {
         const RouterName = `HttpRouter${i + 1}`;
         httpRoutersConfig[RouterName] = {
             Type: "http",
@@ -215,6 +149,10 @@ export async function setupKuboAddressesRewriterAndHttpRouters(pkc) {
     const settingOptionRetryOption = retry.operation({ forever: true, factor: 2 });
     const setHttpRouterOnAllNodes = new Promise((resolve) => {
         settingOptionRetryOption.attempt(async (curAttempt) => {
+            if (pkc.destroyed) {
+                resolve(1);
+                return;
+            }
             for (const kuboClient of Object.values(kuboClients)) {
                 try {
                     await _setHttpRouterOptionsOnKuboNode(kuboClient, routingValue);
@@ -229,12 +167,5 @@ export async function setupKuboAddressesRewriterAndHttpRouters(pkc) {
     });
     await setHttpRouterOnAllNodes;
     settingOptionRetryOption.stop();
-    return {
-        destroy: async () => {
-            for (const proxyServer of proxyServers) {
-                await proxyServer.destroy();
-            }
-        }
-    };
 }
-//# sourceMappingURL=setup-kubo-address-rewriter-and-http-router.js.map
+//# sourceMappingURL=setup-kubo-http-routers.js.map

package/dist/browser/runtime/node/setup-kubo-http-routers.js.map

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