@dikolab/kbdb 0.1.0 → 0.1.2

package/src/shared/dir-resolver/index.ts

@@ -4,4 +4,8 @@ export {
 } from './functions/resolve-base-dir.function.ts';
 export { resolveWorkerScript } from './functions/resolve-worker-script.function.ts';
 export { resolveWasmDir } from './functions/resolve-wasm-dir.function.ts';
+export {
+   isRemoteUrl,
+   joinPath,
+} from './functions/join-path.function.ts';
 export type { BaseDir } from './typings/base-dir.interface.ts';

package/src/shared/worker-daemon/functions/create-host-imports.function.ts

@@ -130,7 +130,8 @@ export function createHostImports(
       if (!memoryRef.memory) {
          throw new Error('WASM memory not initialized');
       }
-      return memoryRef.memory.buffer;
+      // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion
+      return memoryRef.memory.buffer as ArrayBuffer;
    }
 
    function readPathArg(ptr: number, len: number): string {

package/src/shared/worker-daemon/functions/load-wasm-modules.function.ts

@@ -1,5 +1,5 @@
 import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
+
 import type { DaemonConfig } from '../typings/daemon-config.interface.ts';
 import type { WasmModules } from '../typings/wasm-modules.interface.ts';
 import { createHostImports } from './create-host-imports.function.ts';
@@ -7,23 +7,8 @@ import type {
    AllocatorRef,
    MemoryRef,
 } from './create-host-imports.function.ts';
+import { isRemoteUrl, joinPath } from '../../dir-resolver/index.ts';
 
-/**
- * Loads and instantiates the `kb-worker` WASM module.
- *
- * `kb-worker.wasm` statically links the `fs-database` and
- * `query-parser` crates, so only one module needs to be
- * instantiated.  The module exports its own linear memory;
- * host I/O imports read it through a deferred `MemoryRef`
- * that is wired up immediately after instantiation.
- *
- * @param config - daemon configuration, used to supply the context
- *   path to the host I/O imports
- * @param wasmDir - absolute path to the directory containing the
- *   compiled WASM subdirectories (`query-parser/`, `fs-database/`,
- *   `kb-worker/`)
- * @throws when the WASM file cannot be read or instantiated
- */
 export async function loadWasmModules(
    config: DaemonConfig,
    wasmDir: string,
@@ -38,8 +23,8 @@ export async function loadWasmModules(
       allocator,
    );
 
-   const wkPath = join(wasmDir, 'kb-worker', 'kbdb_worker_bg.wasm');
-   const wkBytes = readWasmFileOrThrow(wkPath, 'kb-worker');
+   const wkPath = joinPath(wasmDir, 'kb-worker', 'kbdb_worker_bg.wasm');
+   const wkBytes = await readWasmFile(wkPath, 'kb-worker');
 
    let wkModule: WebAssembly.Module;
    try {
@@ -71,8 +56,20 @@ export async function loadWasmModules(
    return { memory, kbWorker };
 }
 
-function readWasmFileOrThrow(path: string, label: string): ArrayBuffer {
+async function readWasmFile(
+   path: string,
+   label: string,
+): Promise<ArrayBuffer> {
    try {
+      if (isRemoteUrl(path)) {
+         const response = await fetch(path);
+         if (!response.ok) {
+            throw new Error(
+               `HTTP ${String(response.status)} ${response.statusText}`,
+            );
+         }
+         return await response.arrayBuffer();
+      }
       const buf = readFileSync(path);
       return buf.buffer.slice(
          buf.byteOffset,

package/dist/chunk-QCCN7OZH.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/shared/runtime/functions/detect-runtime.ts", "../src/shared/runtime/functions/get-args.ts", "../src/shared/dir-resolver/functions/resolve-base-dir.function.ts", "../src/shared/dir-resolver/functions/resolve-worker-script.function.ts", "../src/shared/dir-resolver/functions/resolve-wasm-dir.function.ts", "../src/shared/hash/functions/compute-sha256.ts", "../src/shared/platform/functions/get-ipc-path.function.ts", "../src/shared/platform/functions/get-tmpdir.function.ts"],
-  "sourcesContent": ["import type { Runtime } from '../typings/runtime.ts';\n\n/**\n * Detects the current JavaScript runtime environment.\n *\n * Returns `'deno'` when the global `Deno` object is present,\n * otherwise returns `'node'`.\n */\nexport function detectRuntime(): Runtime {\n   if (typeof globalThis !== 'undefined' && 'Deno' in globalThis) {\n      return 'deno';\n   }\n   return 'node';\n}\n", "import { detectRuntime } from './detect-runtime.ts';\n\n/**\n * Returns the command-line arguments for the current runtime.\n *\n * In Deno, reads `Deno.args`; in Node.js, slices `process.argv`\n * past the interpreter and script entries.\n */\nexport function getArgs(): string[] {\n   if (detectRuntime() === 'deno') {\n      const g = globalThis as Record<string, unknown>;\n      const deno = g['Deno'] as { args: string[] } | undefined;\n      return deno?.args ?? [];\n   }\n   return process.argv.slice(2);\n}\n", "import { dirname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { BaseDir } from '../typings/base-dir.interface.ts';\n\nexport function resolveScriptDir(\n   entryUrl: string,\n   entryDirname?: string,\n): string {\n   if (entryDirname) return entryDirname;\n   if (entryUrl.startsWith('file:'))\n      return dirname(fileURLToPath(entryUrl));\n   return dirname(entryUrl);\n}\n\nexport function resolveBaseDir(\n   entryUrl: string,\n   entryDirname?: string,\n): BaseDir {\n   const scriptDir =\n      typeof __dirname !== 'undefined'\n         ? __dirname\n         : resolveScriptDir(entryUrl, entryDirname);\n   return { scriptDir, cwd: process.cwd() };\n}\n", "import { join } from 'node:path';\n\nimport type { Runtime } from '../../runtime/typings/runtime.ts';\n\nexport function resolveWorkerScript(\n   scriptDir: string,\n   runtime: Runtime,\n): string {\n   if (runtime === 'deno') {\n      return join(scriptDir, 'worker.ts');\n   }\n   return join(scriptDir, 'kbdb-worker.cjs');\n}\n", "import { join } from 'node:path';\n\nexport function resolveWasmDir(scriptDir: string): string {\n   return join(scriptDir, 'wasm');\n}\n", "/**\n * Computes the SHA-256 hash of a UTF-8 string.\n *\n * Uses the Web Crypto API (`crypto.subtle`), which is available\n * in both Deno and Node.js >= 20 without additional imports.\n *\n * @param input - the string to hash\n * @returns lowercase hex-encoded SHA-256 digest (64 characters)\n */\nexport async function computeSha256(input: string): Promise<string> {\n   const data = new TextEncoder().encode(input);\n   const hash = await crypto.subtle.digest('SHA-256', data);\n   const bytes = new Uint8Array(hash);\n   return Array.from(bytes)\n      .map((b) => b.toString(16).padStart(2, '0'))\n      .join('');\n}\n", "import { join } from 'node:path';\nimport { getTmpdir } from './get-tmpdir.function.ts';\n\n/**\n * Returns the platform-appropriate IPC socket path for a given\n * context identifier.\n *\n * On Windows, returns a named pipe path (`\\\\.\\pipe\\kbdb-<ctx>`).\n * On POSIX systems, returns a Unix domain socket path under the\n * system temp directory (`<tmpdir>/kbdb-<ctx>.sock`).\n *\n * @param ctx - unique context identifier embedded in the path\n */\nexport function getIpcPath(ctx: string): string {\n   if (process.platform === 'win32') {\n      return `\\\\\\\\.\\\\pipe\\\\kbdb-${ctx}`;\n   }\n   return join(getTmpdir(), `kbdb-${ctx}.sock`);\n}\n", "import { tmpdir } from 'node:os';\n\n/**\n * Returns the operating system's default temporary directory path.\n */\nexport function getTmpdir(): string {\n   return tmpdir();\n}\n"],
-  "mappings": ";AAQO,SAAS,gBAAyB;AACtC,MAAI,OAAO,eAAe,eAAe,UAAU,YAAY;AAC5D,WAAO;AAAA,EACV;AACA,SAAO;AACV;;;ACLO,SAAS,UAAoB;AACjC,MAAI,cAAc,MAAM,QAAQ;AAC7B,UAAM,IAAI;AACV,UAAM,OAAO,EAAE,MAAM;AACrB,WAAO,MAAM,QAAQ,CAAC;AAAA,EACzB;AACA,SAAO,QAAQ,KAAK,MAAM,CAAC;AAC9B;;;ACfA,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAIvB,SAAS,iBACb,UACA,cACO;AACP,MAAI,aAAc,QAAO;AACzB,MAAI,SAAS,WAAW,OAAO;AAC5B,WAAO,QAAQ,cAAc,QAAQ,CAAC;AACzC,SAAO,QAAQ,QAAQ;AAC1B;AAEO,SAAS,eACb,UACA,cACQ;AACR,QAAM,YACH,OAAO,cAAc,cAChB,YACA,iBAAiB,UAAU,YAAY;AAC/C,SAAO,EAAE,WAAW,KAAK,QAAQ,IAAI,EAAE;AAC1C;;;ACxBA,SAAS,YAAY;AAId,SAAS,oBACb,WACA,SACO;AACP,MAAI,YAAY,QAAQ;AACrB,WAAO,KAAK,WAAW,WAAW;AAAA,EACrC;AACA,SAAO,KAAK,WAAW,iBAAiB;AAC3C;;;ACZA,SAAS,QAAAA,aAAY;AAEd,SAAS,eAAe,WAA2B;AACvD,SAAOA,MAAK,WAAW,MAAM;AAChC;;;ACKA,eAAsB,cAAc,OAAgC;AACjE,QAAM,OAAO,IAAI,YAAY,EAAE,OAAO,KAAK;AAC3C,QAAM,OAAO,MAAM,OAAO,OAAO,OAAO,WAAW,IAAI;AACvD,QAAM,QAAQ,IAAI,WAAW,IAAI;AACjC,SAAO,MAAM,KAAK,KAAK,EACnB,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EAC1C,KAAK,EAAE;AACd;;;AChBA,SAAS,QAAAC,aAAY;;;ACArB,SAAS,cAAc;AAKhB,SAAS,YAAoB;AACjC,SAAO,OAAO;AACjB;;;ADMO,SAAS,WAAW,KAAqB;AAC7C,MAAI,QAAQ,aAAa,SAAS;AAC/B,WAAO,qBAAqB,GAAG;AAAA,EAClC;AACA,SAAOC,MAAK,UAAU,GAAG,QAAQ,GAAG,OAAO;AAC9C;",
-  "names": ["join", "join", "join"]
-}