@ccheever/exact-ibex-runtime 0.1.0

package/src/http-server/index.ts

@@ -0,0 +1,27 @@
+/**
+ * `exact:http` runtime surface for JS adapters and examples.
+ *
+ * The canonical runtime implementation is provided from Rust module loader via
+ * `exact:http`, and this file exposes the same API contract for
+ * TypeScript-aware consumers.
+ */
+
+import { serve as runtimeServe } from './index.js';
+
+export type ServeHandle = {
+  close: (opts?: { force?: boolean }) => Promise<void>;
+  ref: () => void;
+  unref: () => void;
+  address: () => { port: number; family: string; address: string } | string | null;
+};
+
+export type ServeOptions = {
+  fetch: (request: Request) => Promise<Response> | Response;
+  port?: number;
+  hostname?: string;
+};
+
+// Bun resolves this workspace package through the TypeScript facade during
+// development, so the facade must forward the live implementation instead of
+// only carrying types.
+export const serve: (options: ServeOptions) => Promise<ServeHandle> = runtimeServe;

package/src/identity.generated.ts

@@ -0,0 +1,14 @@
+// GENERATED FILE - DO NOT EDIT.
+// Source authority: runtime-identity.json (LLP 0012)
+// Generator: bun packages/ibex-devtools/src/scripts/generate-runtime-identity.ts
+
+export const RUNTIME_NAME = "ibex";
+export const PROCESS_TITLE = "ibex";
+export const USER_AGENT = "Ibex/0.1.0 (Hermes)";
+export const RELEASE_NAME = "node";
+export const RUNTIME_VERSIONS: ReadonlyArray<readonly [string, string]> = [
+  ["ibex", "0.1.0"],
+  ["node", "24.13.1"],
+  ["hermes", "1.0.0"],
+] as const;
+export const BUN_COMPAT_VERSION = "1.2.0";

package/src/index.ts

@@ -0,0 +1,283 @@
+// @ts-nocheck
+// @system @ref LLP 0003#the-bootstrap-sequence — Web-standard runtime globals on Ibex.
+/**
+ * Ibex Runtime
+ *
+ * Web-standard APIs for the Ibex runtime environment.
+ * These APIs are implemented to match browser standards while
+ * running on top of native platform code.
+ */
+
+// =============================================================================
+// Bootstrap - Install all globals
+// =============================================================================
+
+export { installGlobals, areGlobalsInstalled, getRuntimeVersion, runtimeInfo } from "./bootstrap";
+
+// =============================================================================
+// Events & Errors (Phase 0)
+// =============================================================================
+
+export {
+  Event,
+  CustomEvent,
+  EventTarget,
+  DOMException,
+  KeyboardEvent,
+  FocusEvent,
+} from "./events";
+export type {
+  EventInit,
+  CustomEventInit,
+  EventListener,
+  EventListenerObject,
+  EventListenerOrEventListenerObject,
+  AddEventListenerOptions,
+  EventListenerOptions,
+  KeyboardEventInit,
+  FocusEventInit,
+} from "./events";
+
+// =============================================================================
+// Console (Phase 0)
+// =============================================================================
+
+export { Console, console, setConsoleOutput } from "./console";
+export type { LogLevel, ConsoleOutput } from "./console";
+
+// =============================================================================
+// Accessibility / Preferences
+// =============================================================================
+
+export {
+  announceForAccessibility,
+  focusElementForAccessibility,
+  getExactAccessibilitySnapshot,
+  installExactAccessibilityGlobal,
+  refreshExactAccessibility,
+  subscribeExactAccessibilityChanges,
+  type AccessibilityInfoEvent,
+  type AccessibilityInfoKey,
+  type ExactAccessibilitySnapshot,
+} from "./accessibility";
+
+// =============================================================================
+// Timers (Phase 0)
+// =============================================================================
+
+export {
+  setTimeout,
+  clearTimeout,
+  setInterval,
+  clearInterval,
+  queueMicrotask,
+  setImmediate,
+  clearImmediate,
+  setNativeTimerModule,
+} from "./timers";
+export type { TimerModule } from "./timers";
+
+// =============================================================================
+// Encoding (Phase 0)
+// =============================================================================
+
+export { TextEncoder, TextDecoder } from "./encoding";
+export type { TextEncoderEncodeIntoResult, TextDecoderOptions, TextDecodeOptions } from "./encoding";
+
+// =============================================================================
+// Performance (Phase 0)
+// =============================================================================
+
+export {
+  Performance,
+  PerformanceEntry,
+  PerformanceMark,
+  PerformanceMeasure,
+  performance,
+  setNativePerformanceModule,
+} from "./performance";
+export type { PerformanceModule, PerformanceMarkOptions, PerformanceMeasureOptions } from "./performance";
+
+// =============================================================================
+// Base64 (Phase 0)
+// =============================================================================
+
+export { atob, btoa } from "./base64";
+
+// =============================================================================
+// Inspect (Object Pretty-Printing)
+// =============================================================================
+
+export { inspect, type InspectOptions } from "./inspect";
+
+// =============================================================================
+// URL (Phase 1)
+// =============================================================================
+
+export { URL, URLSearchParams, URLPattern } from "./url";
+export type { URLPatternInit, URLPatternInput, URLPatternResult, URLPatternComponentResult } from "./url";
+
+// =============================================================================
+// Abort (Phase 1)
+// =============================================================================
+
+export { AbortController, AbortSignal } from "./abort";
+
+// =============================================================================
+// Crypto (Phase 3)
+// =============================================================================
+
+export { Crypto, SubtleCrypto, crypto } from "./crypto";
+
+// =============================================================================
+// Streams (Web Streams API)
+// =============================================================================
+
+export {
+  ReadableStream,
+  ReadableStreamDefaultReader,
+  ReadableStreamDefaultController,
+  ReadableByteStreamController,
+  WritableStream,
+  WritableStreamDefaultWriter,
+  WritableStreamDefaultController,
+  TransformStream,
+  TransformStreamDefaultController,
+  ByteLengthQueuingStrategy,
+  CountQueuingStrategy,
+} from "./streams";
+
+export type {
+  UnderlyingSource,
+  UnderlyingByteSource,
+  UnderlyingSink,
+  Transformer,
+  QueuingStrategy,
+  StreamPipeOptions,
+  ReadableStreamReadResult,
+  ReadableStreamReadValueResult,
+  ReadableStreamReadDoneResult,
+} from "./streams";
+
+// =============================================================================
+// Web Locks API
+// =============================================================================
+
+export { LockManager } from "./locks";
+export type { Lock, LockMode, LockOptions, LockGrantedCallback, LockManagerSnapshot } from "./locks";
+
+// =============================================================================
+// HTTP Server (exact:http)
+// =============================================================================
+
+export type {
+  ServeHandle,
+  ServeOptions,
+} from "./http-server/index.js";
+
+// =============================================================================
+// EventSource (Server-Sent Events)
+// =============================================================================
+
+export { EventSource } from "./eventsource";
+export type { EventSourceInit } from "./eventsource";
+
+// =============================================================================
+// Native Module Interfaces
+// =============================================================================
+
+export {
+  setNativeCryptoModule,
+  setNativeEncodingModule,
+  setNativeConsoleModule,
+  setNativeFetchModule as setNativeFetchBridge,
+  setNativeWebSocketModule,
+  setNativeStorageModule,
+  setNativeFileSystemModule,
+  getNativeCryptoModule,
+  getNativeEncodingModule,
+  getNativeConsoleModule,
+  getNativeFetchModule,
+  getNativeWebSocketModule,
+  getNativeStorageModule,
+  getNativeFileSystemModule,
+  hasRequiredNativeModules,
+  getMissingNativeModules,
+} from "./native";
+
+export type {
+  NativeTimerModule,
+  NativePerformanceModule,
+  NativeCryptoModule,
+  NativeEncodingModule,
+  NativeConsoleModule,
+  NativeWebSocketModule,
+  NativeStorageModule,
+  NativeFileSystemModule,
+} from "./native";
+
+// =============================================================================
+// Fetch API (Phase 2 - existing implementation)
+// =============================================================================
+
+export {
+  // Main fetch function
+  fetch,
+  fetchPolyfill,
+  setNativeFetchModule,
+  installFetchGlobals,
+
+  // Classes
+  Headers,
+  Request,
+  Response,
+
+  // Errors
+  FetchError,
+  AbortError,
+  NetworkError,
+  URLError,
+  BodyConsumedError,
+
+  // Body utilities
+  bodyToUint8Array,
+  readableStreamToUint8Array,
+  concatUint8Arrays,
+  parseJson,
+  parseText,
+  isBlob,
+  isFormData,
+  isArrayBuffer,
+  isArrayBufferView,
+  isReadableStream,
+} from './fetch/index.js';
+
+export type {
+  // Request types
+  RequestInput,
+  RequestInit,
+  RequestMethod,
+  RequestMode,
+  RequestCredentials,
+  RequestCache,
+  RequestRedirect,
+  ReferrerPolicy,
+  RequestDuplex,
+
+  // Response types
+  ResponseInit,
+  ResponseType,
+
+  // Headers types
+  HeadersInit,
+
+  // Body types
+  BodyInit,
+  BufferSource,
+
+  // Native bridge types
+  NativeRequestInit,
+  NativeResponse,
+  NativeStreamingResponse,
+  NativeFetchModule,
+} from './fetch/index.js';

package/src/indexeddb/IDBCursor.ts

@@ -0,0 +1,188 @@
+/**
+ * IDBCursor - IndexedDB Cursor
+ *
+ * Iterates over records in an object store or index.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/IDBCursor
+ */
+
+import { IDBRequest } from './IDBRequest';
+import { compareKeys } from './IDBKeyRange';
+
+export type IDBCursorDirection = 'next' | 'nextunique' | 'prev' | 'prevunique';
+
+export class IDBCursor {
+  private _source: any;
+  private _direction: IDBCursorDirection;
+  private _records: Array<{ key: any; primaryKey: any; value: any }>;
+  private _position: number;
+  private _request: IDBRequest;
+  private _gotValue: boolean = false;
+
+  constructor(
+    source: any,
+    direction: IDBCursorDirection,
+    records: Array<{ key: any; primaryKey: any; value: any }>,
+    request: IDBRequest,
+  ) {
+    this._source = source;
+    this._direction = direction;
+    this._request = request;
+
+    // Sort records based on direction
+    const sorted = [...records];
+    if (direction === 'prev' || direction === 'prevunique') {
+      sorted.sort((a, b) => compareKeys(b.key, a.key));
+    } else {
+      sorted.sort((a, b) => compareKeys(a.key, b.key));
+    }
+
+    // For unique directions, deduplicate by key
+    if (direction === 'nextunique' || direction === 'prevunique') {
+      const seen = new Set<string>();
+      this._records = sorted.filter(r => {
+        const keyStr = JSON.stringify(r.key);
+        if (seen.has(keyStr)) return false;
+        seen.add(keyStr);
+        return true;
+      });
+    } else {
+      this._records = sorted;
+    }
+
+    this._position = 0;
+    this._gotValue = this._records.length > 0;
+  }
+
+  get source(): any {
+    return this._source;
+  }
+
+  get direction(): IDBCursorDirection {
+    return this._direction;
+  }
+
+  get key(): any {
+    if (!this._gotValue || this._position >= this._records.length) return undefined;
+    return this._records[this._position].key;
+  }
+
+  get primaryKey(): any {
+    if (!this._gotValue || this._position >= this._records.length) return undefined;
+    return this._records[this._position].primaryKey;
+  }
+
+  get request(): IDBRequest {
+    return this._request;
+  }
+
+  /**
+   * Advances the cursor to the next position.
+   */
+  continue(key?: any): void {
+    this._position++;
+    if (key !== undefined) {
+      // Skip to the first record with key >= given key (or <= for prev)
+      while (this._position < this._records.length) {
+        const cmp = compareKeys(this._records[this._position].key, key);
+        if (this._direction === 'prev' || this._direction === 'prevunique') {
+          if (cmp <= 0) break;
+        } else {
+          if (cmp >= 0) break;
+        }
+        this._position++;
+      }
+    }
+
+    if (this._position < this._records.length) {
+      this._gotValue = true;
+      this._request._resolve(this as any);
+    } else {
+      this._gotValue = false;
+      this._request._resolve(null as any);
+    }
+  }
+
+  /**
+   * Advances the cursor by a given number of positions.
+   */
+  advance(count: number): void {
+    if (count <= 0) {
+      throw new TypeError('count must be greater than 0');
+    }
+    this._position += count;
+    if (this._position < this._records.length) {
+      this._gotValue = true;
+      this._request._resolve(this as any);
+    } else {
+      this._gotValue = false;
+      this._request._resolve(null as any);
+    }
+  }
+
+  /**
+   * Updates the value at the current cursor position.
+   */
+  update(value: any): IDBRequest {
+    const request = new IDBRequest();
+    if (!this._gotValue || this._position >= this._records.length) {
+      request._reject(new Error('Cursor is not pointing to a record'));
+      return request;
+    }
+    const record = this._records[this._position];
+    // Update via the source's object store
+    try {
+      const store = this._source._objectStore || this._source;
+      store._putRecord(record.primaryKey, value);
+      record.value = value;
+      request._resolve(record.primaryKey);
+    } catch (e: any) {
+      request._reject(e);
+    }
+    return request;
+  }
+
+  /**
+   * Deletes the record at the current cursor position.
+   */
+  delete(): IDBRequest {
+    const request = new IDBRequest();
+    if (!this._gotValue || this._position >= this._records.length) {
+      request._reject(new Error('Cursor is not pointing to a record'));
+      return request;
+    }
+    const record = this._records[this._position];
+    try {
+      const store = this._source._objectStore || this._source;
+      store._deleteRecord(record.primaryKey);
+      request._resolve(undefined);
+    } catch (e: any) {
+      request._reject(e);
+    }
+    return request;
+  }
+}
+
+/**
+ * IDBCursorWithValue extends IDBCursor with a value property.
+ */
+export class IDBCursorWithValue extends IDBCursor {
+  private _valueRecords: Array<{ key: any; primaryKey: any; value: any }>;
+
+  constructor(
+    source: any,
+    direction: IDBCursorDirection,
+    records: Array<{ key: any; primaryKey: any; value: any }>,
+    request: IDBRequest,
+  ) {
+    super(source, direction, records, request);
+    this._valueRecords = (this as any)._records;
+  }
+
+  get value(): any {
+    const pos = (this as any)._position;
+    const records = (this as any)._records;
+    if (pos >= records.length) return undefined;
+    return records[pos].value;
+  }
+}