@ai-ecoverse/slicc-kernel 1.26.6 → 1.27.0

package/dist/testing.js

@@ -0,0 +1,27 @@
+// src/kernel/net/uplink.ts
+function answerOf(result) {
+  const answer = Array.isArray(result) ? { addresses: result } : result;
+  const addresses = Array.isArray(answer?.addresses) ? answer.addresses.filter((a) => typeof a === "string") : [];
+  return {
+    addresses,
+    ...typeof answer?.ttl === "number" && answer.ttl >= 0 ? { ttl: answer.ttl } : {}
+  };
+}
+
+// src/testing.ts
+function fakeUplink(options = {}) {
+  const asked = [];
+  return {
+    traits: { tcp: true, udp: false, ipv6: options.ipv6 === true },
+    ...options.routes ? { routes: options.routes } : {},
+    asked,
+    resolve: async (name, family) => {
+      asked.push({ name, family });
+      return answerOf(options.names?.[name] ?? []);
+    }
+  };
+}
+export {
+  fakeUplink
+};
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/kernel/net/uplink.ts", "../src/testing.ts"],
+  "sourcesContent": ["import type { RouteTable } from './routes.ts';\n\nexport interface UplinkTraits {\n  tcp: true;\n  udp: false;\n  ipv6: boolean;\n}\n\nexport type ResolveFamily = 0 | 4 | 6;\n\nexport interface ResolveAnswer {\n  addresses: string[];\n  ttl?: number;\n}\n\nexport interface NetworkUplink {\n  readonly traits: UplinkTraits;\n  readonly routes?: RouteTable;\n  resolve(\n    name: string,\n    family: ResolveFamily,\n    signal?: AbortSignal\n  ): Promise<string[] | ResolveAnswer>;\n}\n\nexport type UplinkCall =\n  | { uplink: 'resolve'; uid: number; name: string; family: ResolveFamily }\n  | { uplink: 'cancel'; uid: number };\n\nexport type UplinkReply =\n  | { uplink: 'resolved'; uid: number; addresses: string[]; ttl?: number }\n  | { uplink: 'error'; uid: number; message: string; code?: string };\n\nexport interface UplinkPeer {\n  postMessage(message: UplinkReply): void;\n}\n\nexport interface UplinkPort {\n  postMessage(message: UplinkCall): void;\n}\n\nexport function answerOf(result: string[] | ResolveAnswer): ResolveAnswer {\n  const answer = Array.isArray(result) ? { addresses: result } : result;\n  const addresses = Array.isArray(answer?.addresses)\n    ? answer.addresses.filter((a): a is string => typeof a === 'string')\n    : [];\n  return {\n    addresses,\n    ...(typeof answer?.ttl === 'number' && answer.ttl >= 0 ? { ttl: answer.ttl } : {}),\n  };\n}\n\nfunction failure(uid: number, e: unknown): UplinkReply {\n  const code = (e as { code?: unknown } | null)?.code;\n  return {\n    uplink: 'error',\n    uid,\n    message: e instanceof Error ? e.message : String(e),\n    ...(typeof code === 'string' ? { code } : {}),\n  };\n}\n\nexport interface UplinkServer {\n  answer(call: UplinkCall): void;\n  close(): void;\n}\n\nexport function serveUplink(peer: UplinkPeer, uplink: NetworkUplink): UplinkServer {\n  const pending = new Map<number, AbortController>();\n  const answer = (call: UplinkCall) => {\n    if (call.uplink === 'cancel') return pending.get(call.uid)?.abort();\n    const abort = new AbortController();\n    pending.set(call.uid, abort);\n    void (async () => {\n      try {\n        const answer = answerOf(await uplink.resolve(call.name, call.family, abort.signal));\n        peer.postMessage({ uplink: 'resolved', uid: call.uid, ...answer });\n      } catch (e) {\n        peer.postMessage(failure(call.uid, e));\n      } finally {\n        pending.delete(call.uid);\n      }\n    })();\n  };\n  return {\n    answer,\n    close: () => {\n      for (const abort of pending.values()) abort.abort();\n    },\n  };\n}\n\nexport class RemoteUplink implements NetworkUplink {\n  readonly traits: UplinkTraits;\n  readonly routes: RouteTable | undefined;\n  private readonly port: UplinkPort;\n  private readonly waiting = new Map<number, PromiseWithResolvers<ResolveAnswer>>();\n  private nextId = 0;\n\n  constructor(port: UplinkPort, traits: UplinkTraits, routes?: RouteTable) {\n    this.port = port;\n    this.traits = traits;\n    this.routes = routes;\n  }\n\n  receive(reply: UplinkReply): void {\n    const waiter = this.waiting.get(reply.uid);\n    if (!waiter) return;\n    this.waiting.delete(reply.uid);\n    if (reply.uplink === 'error') {\n      waiter.reject(Object.assign(new Error(reply.message), { code: reply.code }));\n    } else waiter.resolve(answerOf(reply));\n  }\n\n  resolve(name: string, family: ResolveFamily, signal?: AbortSignal): Promise<ResolveAnswer> {\n    const uid = ++this.nextId;\n    const waiter = Promise.withResolvers<ResolveAnswer>();\n    this.waiting.set(uid, waiter);\n    const abort = () => {\n      this.waiting.delete(uid);\n      this.port.postMessage({ uplink: 'cancel', uid });\n      waiter.reject(signal?.reason);\n    };\n    signal?.addEventListener('abort', abort, { once: true });\n    const settled = () => signal?.removeEventListener('abort', abort);\n    waiter.promise.then(settled, settled);\n    this.port.postMessage({ uplink: 'resolve', uid, name, family });\n    return waiter.promise;\n  }\n}\n", "import type { RouteTable } from './kernel/net/routes.ts';\nimport {\n  answerOf,\n  type NetworkUplink,\n  type ResolveAnswer,\n  type ResolveFamily,\n} from './kernel/net/uplink.ts';\n\nexport type { NetworkUplink, ResolveAnswer, ResolveFamily, RouteTable };\n\nexport interface FakeUplinkOptions {\n  names?: Readonly<Record<string, string[] | ResolveAnswer>>;\n  routes?: RouteTable;\n  ipv6?: boolean;\n}\n\nexport interface FakeUplink extends NetworkUplink {\n  readonly asked: Array<{ name: string; family: ResolveFamily }>;\n}\n\nexport function fakeUplink(options: FakeUplinkOptions = {}): FakeUplink {\n  const asked: FakeUplink['asked'] = [];\n  return {\n    traits: { tcp: true, udp: false, ipv6: options.ipv6 === true },\n    ...(options.routes ? { routes: options.routes } : {}),\n    asked,\n    resolve: async (name, family) => {\n      asked.push({ name, family });\n      return answerOf(options.names?.[name] ?? []);\n    },\n  };\n}\n"],
+  "mappings": ";AAyCO,SAAS,SAAS,QAAiD;AACxE,QAAM,SAAS,MAAM,QAAQ,MAAM,IAAI,EAAE,WAAW,OAAO,IAAI;AAC/D,QAAM,YAAY,MAAM,QAAQ,QAAQ,SAAS,IAC7C,OAAO,UAAU,OAAO,CAAC,MAAmB,OAAO,MAAM,QAAQ,IACjE,CAAC;AACL,SAAO;AAAA,IACL;AAAA,IACA,GAAI,OAAO,QAAQ,QAAQ,YAAY,OAAO,OAAO,IAAI,EAAE,KAAK,OAAO,IAAI,IAAI,CAAC;AAAA,EAClF;AACF;;;AC9BO,SAAS,WAAW,UAA6B,CAAC,GAAe;AACtE,QAAM,QAA6B,CAAC;AACpC,SAAO;AAAA,IACL,QAAQ,EAAE,KAAK,MAAM,KAAK,OAAO,MAAM,QAAQ,SAAS,KAAK;AAAA,IAC7D,GAAI,QAAQ,SAAS,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;AAAA,IACnD;AAAA,IACA,SAAS,OAAO,MAAM,WAAW;AAC/B,YAAM,KAAK,EAAE,MAAM,OAAO,CAAC;AAC3B,aAAO,SAAS,QAAQ,QAAQ,IAAI,KAAK,CAAC,CAAC;AAAA,IAC7C;AAAA,EACF;AACF;",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-kernel",
-  "version": "1.26.6",
+  "version": "1.27.0",
   "description": "SLICC's wasm-realm kernel: run Emscripten programs in the browser against OPFS, with fork, spawn, pipes and waitpid",
   "type": "module",
   "license": "Apache-2.0",
@@ -24,7 +24,8 @@
   "exports": {
     ".": "./dist/index.js",
     "./node": "./dist/node.js",
-    "./driver": "./dist/driver.js"
+    "./driver": "./dist/driver.js",
+    "./testing": "./dist/testing.js"
   },
   "files": [
     "dist"
@@ -39,7 +40,7 @@
     "start": "npm run build && node test/integration/chrome.mjs",
     "pretest": "npm run build && playwright-core install --no-shell chromium",
     "test": "node --test --test-timeout=180000 --test-global-setup=node_modules/@ai-ecoverse/slicc-shared-web/harness/global.mjs 'test/integration/*.test.mjs'",
-    "test:unit": "NODE_NO_WARNINGS=1 mcr -c node_modules/@ai-ecoverse/slicc-shared-web/mcr.config.mjs node --import fake-indexeddb/auto --test --test-concurrency=4 'test/unit/**/*.test.mjs'",
+    "test:unit": "tools/heavy.sh env NODE_NO_WARNINGS=1 mcr -c node_modules/@ai-ecoverse/slicc-shared-web/mcr.config.mjs node --import fake-indexeddb/auto --test --test-concurrency=4 'test/unit/**/*.test.mjs'",
     "typecheck": "tsc && tsc -p tsconfig.node.json",
     "lint": "slicc-lint",
     "format": "biome check --write ."