@corpus-core/colibri-tor 1.1.22

package/node_modules/tor-js/README.md

@@ -0,0 +1,166 @@
+# tor-js
+
+Make HTTP requests through Tor from JavaScript. Works in browsers and Node.js.
+
+Uses [Arti](https://gitlab.torproject.org/tpo/core/arti) (the Tor Project's Rust implementation) compiled to WebAssembly.
+
+**[Live Demo](https://voltrevo.github.io/arti/)**
+
+## Quick start
+
+```
+npm install tor-js
+```
+
+```javascript
+import { TorClient } from 'tor-js';
+
+const client = new TorClient({
+  gateway: 'https://tor-js-gateway.voltrevo.com',
+});
+
+const response = await client.fetch('https://check.torproject.org/api/ip');
+console.log(await response.json()); // { IsTor: true, IP: "..." }
+
+client.close();
+```
+
+In Node.js, the gateway is optional (connects via direct TCP):
+
+```javascript
+const client = new TorClient();
+```
+
+## Entry points
+
+The package offers three ways to load the WASM binary. All export the same API.
+
+| Import | WASM loading | Size (gzip) | Best for |
+|---|---|---|---|
+| `tor-js` | Fetched from CDN, cached locally | 16 kB | Production web apps |
+| `tor-js/wasm-base64` | Embedded in the JS bundle | 2.3 MB | Single-file deploys |
+| `tor-js/wasm-file` | Loaded from `tor_js_bg.wasm` next to the module | 15 kB + 1.7 MB | Self-hosted, server-side |
+
+Each also has a `/singleton` variant (see [Singleton](#singleton) below).
+
+## API
+
+### `new TorClient(options)`
+
+Creates a Tor client and begins bootstrapping immediately.
+
+```typescript
+type TorClientOptions = {
+  gateway?: string;       // Gateway URL (required in browsers, optional in Node.js/Deno)
+  log?: Log;              // Logger instance (default: silent)
+  storage?: TorStorage;   // Persistent storage (default: auto-detected)
+  logLevel?: LogLevel;    // 'trace' | 'debug' | 'info' | 'warn' | 'error'
+};
+```
+
+In browsers, the gateway proxies relay connections via WebRTC or WebSocket. In Node.js/Deno, connections go via direct TCP and the gateway is only used for fast bootstrap (optional).
+
+### `client.fetch(url, init?)`
+
+Make an HTTP request through Tor. Returns a standard `Response` object.
+
+Waits for the client to be fully ready before sending the request.
+
+```typescript
+const res = await client.fetch('https://example.com', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({ key: 'value' }),
+  signal: AbortSignal.timeout(30_000),
+});
+```
+
+### `client.ready()`
+
+Wait for the client to be ready for traffic (guard connected, usable consensus, sufficient microdescs). Called automatically by `fetch()`, but useful to call early if you want to measure bootstrap time or show a loading state.
+
+```typescript
+const client = new TorClient({ ... });
+await client.ready();
+console.log('Bootstrap complete');
+```
+
+### `client.setLogLevel(level)`
+
+Change the log level at runtime. Accepts `'trace'`, `'debug'`, `'info'`, `'warn'`, or `'error'`.
+
+### `client.close()`
+
+Close the client and release resources. Also available as `Symbol.dispose` for use with `using`:
+
+```typescript
+{
+  using client = new TorClient({ ... });
+  await client.fetch('https://example.com');
+} // automatically closed
+```
+
+## Singleton
+
+For simple use cases, import the singleton wrapper:
+
+```javascript
+import { tor } from 'tor-js/singleton';
+
+const response = await tor.fetch('https://check.torproject.org/api/ip');
+```
+
+The singleton auto-opens on first `fetch()`. Use `tor.configure(options)` to change settings, or `tor.close()` to shut down.
+
+## Storage
+
+By default, `TorClient` auto-detects the best storage for the environment:
+
+- **Browser**: IndexedDB
+- **Node.js**: `~/.local/share/tor-js/`
+
+Cached consensus and microdescriptors are persisted, so subsequent connections bootstrap faster.
+
+You can provide your own storage:
+
+```javascript
+import { TorClient, storage } from 'tor-js';
+
+// Explicit IndexedDB
+const client = new TorClient({
+  storage: new storage.IndexedDBStorage('my-app'),
+  // ...
+});
+
+// In-memory (no persistence)
+const client = new TorClient({
+  storage: new storage.MemoryStorage(),
+  // ...
+});
+```
+
+## Logging
+
+Pass a `Log` instance to see bootstrap progress and debug info:
+
+```javascript
+import { TorClient, Log } from 'tor-js';
+
+const client = new TorClient({
+  log: new Log(),       // logs to console with timestamps
+  logLevel: 'info',     // minimum level (default: 'debug')
+  // ...
+});
+```
+
+Custom log sink:
+
+```javascript
+const log = new Log({
+  rawLog: (level, ...args) => myLogger[level](...args),
+});
+```
+
+## License
+
+MIT OR Apache-2.0

package/node_modules/tor-js/dist/Log.d.ts

@@ -0,0 +1,24 @@
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error';
+interface LogConstructorParams {
+    rawLog?: (level: LogLevel, ...args: unknown[]) => void;
+    parentStartTime?: number;
+    namePrefix?: string;
+}
+export declare class Log {
+    private rawLog;
+    private parentStartTime;
+    private namePrefix;
+    constructor(params?: LogConstructorParams);
+    child(name: string): Log;
+    trace(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    /** @internal Create a callback for WASM setLogCallback */
+    _makeWasmCallback(): (level: string, target: string, message: string) => void;
+    private log;
+    private defaultRawLog;
+}
+export {};
+//# sourceMappingURL=Log.d.ts.map

package/node_modules/tor-js/dist/Log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Log.d.ts","sourceRoot":"","sources":["../src/Log.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAErE,UAAU,oBAAoB;IAC5B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,GAAG;IACd,OAAO,CAAC,MAAM,CAAgD;IAC9D,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,GAAE,oBAAyB;IAM7C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG;IASxB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/B,0DAA0D;IAC1D,iBAAiB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI;IAW7E,OAAO,CAAC,GAAG;IAUX,OAAO,CAAC,aAAa;CAGtB"}

package/node_modules/tor-js/dist/TorClient.d.ts

@@ -0,0 +1,37 @@
+import type { TorClientOptions, FetchInit, LogLevel } from './types.js';
+export declare class TorClient {
+    private log;
+    private clientPromise;
+    private removeLogListener;
+    private wasmCallback;
+    private closed;
+    private readyPromise;
+    private socketProvider;
+    constructor(options?: TorClientOptions);
+    private bootstrap;
+    /**
+     * Make an HTTP fetch request through Tor.
+     * Returns a standard browser Response object.
+     */
+    fetch(url: string, init?: FetchInit): Promise<Response>;
+    /**
+     * Wait for the Tor client to be ready for traffic
+     * (guard connected, usable consensus, and sufficient microdescs).
+     *
+     * Parallel callers share the same underlying promise — a single WS
+     * connection failure rejects all waiters. The cached promise is cleared
+     * on settle so the next call creates a fresh attempt.
+     */
+    ready(): Promise<void>;
+    /**
+     * Change the log level for this client's listener.
+     * Also re-syncs the global WASM filter to the broadest level across all clients.
+     */
+    setLogLevel(level: LogLevel): void;
+    /**
+     * Close the TorClient and release resources.
+     */
+    close(): void;
+    [Symbol.dispose](): void;
+}
+//# sourceMappingURL=TorClient.d.ts.map

package/node_modules/tor-js/dist/TorClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TorClient.d.ts","sourceRoot":"","sources":["../src/TorClient.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKxE,qBAAa,SAAS;IACpB,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,YAAY,CAA2E;IAC/F,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,cAAc,CAAmC;gBAE7C,OAAO,GAAE,gBAAqB;YAK5B,SAAS;IA0CvB;;;OAGG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ7D;;;;;;;OAOG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAMlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAWb,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGzB"}

package/node_modules/tor-js/dist/commonExports.d.ts

@@ -0,0 +1,6 @@
+export type { TorClientOptions, FetchInit, TorStorage } from './types.js';
+export { Log, type LogLevel } from './Log.js';
+export * as storage from './storage/index.js';
+export { setWasmUrl } from './wasm.js';
+export { ArtiSocketProvider, ArtiSocket, type ArtiSocketProviderOptions } from './socketProvider.js';
+//# sourceMappingURL=commonExports.d.ts.map

package/node_modules/tor-js/dist/commonExports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonExports.d.ts","sourceRoot":"","sources":["../src/commonExports.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,GAAG,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,KAAK,yBAAyB,EAAE,MAAM,qBAAqB,CAAC"}

package/node_modules/tor-js/dist/entryPoints/wasm-base64/index.d.ts

@@ -0,0 +1,3 @@
+export { TorClient } from '../../TorClient.js';
+export * from '../../commonExports.js';
+//# sourceMappingURL=index.d.ts.map

package/node_modules/tor-js/dist/entryPoints/wasm-base64/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/entryPoints/wasm-base64/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,cAAc,wBAAwB,CAAC"}