@ricsam/isolate-console 0.0.1 → 0.1.2

package/README.md

@@ -1,45 +1,69 @@
 # @ricsam/isolate-console
 
-## ⚠️ IMPORTANT NOTICE ⚠️
-
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@ricsam/isolate-console`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**
+Console API with logging, timing, counting, and grouping.
+
+```typescript
+import { setupConsole } from "@ricsam/isolate-console";
+
+const handle = await setupConsole(context, {
+  onLog: (level, ...args) => {
+    console.log(`[${level}]`, ...args);
+  },
+  onTime: (label, duration) => {
+    console.log(`${label}: ${duration}ms`);
+  },
+  onCount: (label, count) => {
+    console.log(`${label}: ${count}`);
+  },
+});
+```
+
+**Injected Globals:**
+- `console.log`, `console.warn`, `console.error`, `console.debug`, `console.info`
+- `console.trace`, `console.dir`, `console.table`
+- `console.time`, `console.timeEnd`, `console.timeLog`
+- `console.count`, `console.countReset`
+- `console.group`, `console.groupCollapsed`, `console.groupEnd`
+- `console.assert`, `console.clear`
+
+**Usage in Isolate:**
+
+```javascript
+// Basic logging
+console.log("Hello", { name: "World" });
+console.warn("Warning message");
+console.error("Error occurred");
+
+// Timing
+console.time("operation");
+// ... do work ...
+console.timeLog("operation", "checkpoint");
+// ... more work ...
+console.timeEnd("operation"); // Logs: "operation: 123ms"
+
+// Counting
+console.count("clicks");     // clicks: 1
+console.count("clicks");     // clicks: 2
+console.countReset("clicks");
+console.count("clicks");     // clicks: 1
+
+// Grouping
+console.group("User Info");
+console.log("Name: John");
+console.log("Age: 30");
+console.groupEnd();
+```
+
+**Event Handlers:**
+
+| Handler | Description |
+|---------|-------------|
+| `onLog` | Called for log, warn, error, debug, info, trace, dir, table |
+| `onTime` | Called when `console.timeEnd` completes a timer |
+| `onTimeLog` | Called when `console.timeLog` logs without ending |
+| `onCount` | Called when `console.count` increments |
+| `onCountReset` | Called when `console.countReset` resets a counter |
+| `onGroup` | Called when `console.group` or `groupCollapsed` is invoked |
+| `onGroupEnd` | Called when `console.groupEnd` is invoked |
+| `onAssert` | Called when `console.assert` fails |
+| `onClear` | Called when `console.clear` is invoked |

package/dist/cjs/index.cjs

@@ -0,0 +1,173 @@
+// @bun @bun-cjs
+(function(exports, require, module, __filename, __dirname) {var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// packages/console/src/index.ts
+var exports_src = {};
+__export(exports_src, {
+  setupConsole: () => setupConsole
+});
+module.exports = __toCommonJS(exports_src);
+var import_isolated_vm = __toESM(require("isolated-vm"));
+async function setupConsole(context, options) {
+  const opts = options ?? {};
+  const timers = new Map;
+  const counters = new Map;
+  let groupDepth = 0;
+  const global = context.global;
+  const logLevels = [
+    "log",
+    "warn",
+    "error",
+    "debug",
+    "info",
+    "trace",
+    "dir",
+    "table"
+  ];
+  for (const level of logLevels) {
+    global.setSync(`__console_${level}`, new import_isolated_vm.default.Callback((...args) => {
+      opts.onLog?.(level, ...args);
+    }));
+  }
+  global.setSync("__console_time", new import_isolated_vm.default.Callback((label) => {
+    const l = label ?? "default";
+    timers.set(l, performance.now());
+  }));
+  global.setSync("__console_timeEnd", new import_isolated_vm.default.Callback((label) => {
+    const l = label ?? "default";
+    const start = timers.get(l);
+    if (start !== undefined) {
+      const duration = performance.now() - start;
+      timers.delete(l);
+      opts.onTime?.(l, duration);
+    }
+  }));
+  global.setSync("__console_timeLog", new import_isolated_vm.default.Callback((label, ...args) => {
+    const l = label ?? "default";
+    const start = timers.get(l);
+    if (start !== undefined) {
+      const duration = performance.now() - start;
+      opts.onTimeLog?.(l, duration, ...args);
+    }
+  }));
+  global.setSync("__console_count", new import_isolated_vm.default.Callback((label) => {
+    const l = label ?? "default";
+    const count = (counters.get(l) ?? 0) + 1;
+    counters.set(l, count);
+    opts.onCount?.(l, count);
+  }));
+  global.setSync("__console_countReset", new import_isolated_vm.default.Callback((label) => {
+    const l = label ?? "default";
+    counters.delete(l);
+    opts.onCountReset?.(l);
+  }));
+  global.setSync("__console_group", new import_isolated_vm.default.Callback((label) => {
+    const l = label ?? "default";
+    groupDepth++;
+    opts.onGroup?.(l, false);
+  }));
+  global.setSync("__console_groupCollapsed", new import_isolated_vm.default.Callback((label) => {
+    const l = label ?? "default";
+    groupDepth++;
+    opts.onGroup?.(l, true);
+  }));
+  global.setSync("__console_groupEnd", new import_isolated_vm.default.Callback(() => {
+    if (groupDepth > 0) {
+      groupDepth--;
+    }
+    opts.onGroupEnd?.();
+  }));
+  global.setSync("__console_clear", new import_isolated_vm.default.Callback(() => {
+    opts.onClear?.();
+  }));
+  global.setSync("__console_assert", new import_isolated_vm.default.Callback((condition, ...args) => {
+    if (!condition) {
+      opts.onAssert?.(condition, ...args);
+    }
+  }));
+  context.evalSync(`
+    globalThis.console = {
+      log: __console_log,
+      warn: __console_warn,
+      error: __console_error,
+      debug: __console_debug,
+      info: __console_info,
+      trace: __console_trace,
+      dir: __console_dir,
+      table: __console_table,
+      time: __console_time,
+      timeEnd: __console_timeEnd,
+      timeLog: __console_timeLog,
+      count: __console_count,
+      countReset: __console_countReset,
+      group: __console_group,
+      groupCollapsed: __console_groupCollapsed,
+      groupEnd: __console_groupEnd,
+      clear: __console_clear,
+      assert: __console_assert,
+    };
+  `);
+  return {
+    dispose() {
+      timers.clear();
+      counters.clear();
+      groupDepth = 0;
+    },
+    reset() {
+      timers.clear();
+      counters.clear();
+      groupDepth = 0;
+    },
+    getTimers() {
+      return new Map(timers);
+    },
+    getCounters() {
+      return new Map(counters);
+    },
+    getGroupDepth() {
+      return groupDepth;
+    }
+  };
+}
+})
+
+//# debugId=4D8B064A0F23B8BC64756E2164756E21

package/dist/cjs/index.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.ts"],
+  "sourcesContent": [
+    "import ivm from \"isolated-vm\";\n\nexport interface ConsoleOptions {\n  onLog?: (level: string, ...args: unknown[]) => void;\n  onTime?: (label: string, duration: number) => void;\n  onTimeLog?: (label: string, duration: number, ...args: unknown[]) => void;\n  onCount?: (label: string, count: number) => void;\n  onCountReset?: (label: string) => void;\n  onGroup?: (label: string, collapsed: boolean) => void;\n  onGroupEnd?: () => void;\n  onClear?: () => void;\n  onAssert?: (condition: boolean, ...args: unknown[]) => void;\n}\n\nexport interface ConsoleHandle {\n  dispose(): void;\n  reset(): void;\n  getTimers(): Map<string, number>;\n  getCounters(): Map<string, number>;\n  getGroupDepth(): number;\n}\n\n/**\n * Setup console API in an isolated-vm context\n *\n * Injects console.log, console.warn, console.error, console.info, console.debug,\n * console.trace, console.dir, console.table, console.time, console.timeEnd,\n * console.timeLog, console.count, console.countReset, console.group,\n * console.groupCollapsed, console.groupEnd, console.clear, console.assert\n *\n * @example\n * const handle = await setupConsole(context, {\n *   onLog: (level, ...args) => console.log(`[${level}]`, ...args)\n * });\n */\nexport async function setupConsole(\n  context: ivm.Context,\n  options?: ConsoleOptions\n): Promise<ConsoleHandle> {\n  const opts = options ?? {};\n\n  // State management\n  const timers = new Map<string, number>();\n  const counters = new Map<string, number>();\n  let groupDepth = 0;\n\n  const global = context.global;\n\n  // Log-level methods\n  const logLevels = [\n    \"log\",\n    \"warn\",\n    \"error\",\n    \"debug\",\n    \"info\",\n    \"trace\",\n    \"dir\",\n    \"table\",\n  ];\n\n  for (const level of logLevels) {\n    global.setSync(\n      `__console_${level}`,\n      new ivm.Callback((...args: unknown[]) => {\n        opts.onLog?.(level, ...args);\n      })\n    );\n  }\n\n  // Timing methods\n  global.setSync(\n    \"__console_time\",\n    new ivm.Callback((label?: string) => {\n      const l = label ?? \"default\";\n      timers.set(l, performance.now());\n    })\n  );\n\n  global.setSync(\n    \"__console_timeEnd\",\n    new ivm.Callback((label?: string) => {\n      const l = label ?? \"default\";\n      const start = timers.get(l);\n      if (start !== undefined) {\n        const duration = performance.now() - start;\n        timers.delete(l);\n        opts.onTime?.(l, duration);\n      }\n    })\n  );\n\n  global.setSync(\n    \"__console_timeLog\",\n    new ivm.Callback((label?: string, ...args: unknown[]) => {\n      const l = label ?? \"default\";\n      const start = timers.get(l);\n      if (start !== undefined) {\n        const duration = performance.now() - start;\n        opts.onTimeLog?.(l, duration, ...args);\n      }\n    })\n  );\n\n  // Counting methods\n  global.setSync(\n    \"__console_count\",\n    new ivm.Callback((label?: string) => {\n      const l = label ?? \"default\";\n      const count = (counters.get(l) ?? 0) + 1;\n      counters.set(l, count);\n      opts.onCount?.(l, count);\n    })\n  );\n\n  global.setSync(\n    \"__console_countReset\",\n    new ivm.Callback((label?: string) => {\n      const l = label ?? \"default\";\n      counters.delete(l);\n      opts.onCountReset?.(l);\n    })\n  );\n\n  // Grouping methods\n  global.setSync(\n    \"__console_group\",\n    new ivm.Callback((label?: string) => {\n      const l = label ?? \"default\";\n      groupDepth++;\n      opts.onGroup?.(l, false);\n    })\n  );\n\n  global.setSync(\n    \"__console_groupCollapsed\",\n    new ivm.Callback((label?: string) => {\n      const l = label ?? \"default\";\n      groupDepth++;\n      opts.onGroup?.(l, true);\n    })\n  );\n\n  global.setSync(\n    \"__console_groupEnd\",\n    new ivm.Callback(() => {\n      if (groupDepth > 0) {\n        groupDepth--;\n      }\n      opts.onGroupEnd?.();\n    })\n  );\n\n  // Other methods\n  global.setSync(\n    \"__console_clear\",\n    new ivm.Callback(() => {\n      opts.onClear?.();\n    })\n  );\n\n  global.setSync(\n    \"__console_assert\",\n    new ivm.Callback((condition: boolean, ...args: unknown[]) => {\n      if (!condition) {\n        opts.onAssert?.(condition, ...args);\n      }\n    })\n  );\n\n  // Inject console object\n  context.evalSync(`\n    globalThis.console = {\n      log: __console_log,\n      warn: __console_warn,\n      error: __console_error,\n      debug: __console_debug,\n      info: __console_info,\n      trace: __console_trace,\n      dir: __console_dir,\n      table: __console_table,\n      time: __console_time,\n      timeEnd: __console_timeEnd,\n      timeLog: __console_timeLog,\n      count: __console_count,\n      countReset: __console_countReset,\n      group: __console_group,\n      groupCollapsed: __console_groupCollapsed,\n      groupEnd: __console_groupEnd,\n      clear: __console_clear,\n      assert: __console_assert,\n    };\n  `);\n\n  return {\n    dispose() {\n      timers.clear();\n      counters.clear();\n      groupDepth = 0;\n    },\n    reset() {\n      timers.clear();\n      counters.clear();\n      groupDepth = 0;\n    },\n    getTimers() {\n      return new Map(timers);\n    },\n    getCounters() {\n      return new Map(counters);\n    },\n    getGroupDepth() {\n      return groupDepth;\n    },\n  };\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "4D8B064A0F23B8BC64756E2164756E21",
+  "names": []
+}

package/dist/cjs/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "@ricsam/isolate-console",
+  "version": "0.1.2",
+  "type": "commonjs"
+}

package/dist/mjs/index.mjs

@@ -0,0 +1,129 @@
+// @bun
+// packages/console/src/index.ts
+import ivm from "isolated-vm";
+async function setupConsole(context, options) {
+  const opts = options ?? {};
+  const timers = new Map;
+  const counters = new Map;
+  let groupDepth = 0;
+  const global = context.global;
+  const logLevels = [
+    "log",
+    "warn",
+    "error",
+    "debug",
+    "info",
+    "trace",
+    "dir",
+    "table"
+  ];
+  for (const level of logLevels) {
+    global.setSync(`__console_${level}`, new ivm.Callback((...args) => {
+      opts.onLog?.(level, ...args);
+    }));
+  }
+  global.setSync("__console_time", new ivm.Callback((label) => {
+    const l = label ?? "default";
+    timers.set(l, performance.now());
+  }));
+  global.setSync("__console_timeEnd", new ivm.Callback((label) => {
+    const l = label ?? "default";
+    const start = timers.get(l);
+    if (start !== undefined) {
+      const duration = performance.now() - start;
+      timers.delete(l);
+      opts.onTime?.(l, duration);
+    }
+  }));
+  global.setSync("__console_timeLog", new ivm.Callback((label, ...args) => {
+    const l = label ?? "default";
+    const start = timers.get(l);
+    if (start !== undefined) {
+      const duration = performance.now() - start;
+      opts.onTimeLog?.(l, duration, ...args);
+    }
+  }));
+  global.setSync("__console_count", new ivm.Callback((label) => {
+    const l = label ?? "default";
+    const count = (counters.get(l) ?? 0) + 1;
+    counters.set(l, count);
+    opts.onCount?.(l, count);
+  }));
+  global.setSync("__console_countReset", new ivm.Callback((label) => {
+    const l = label ?? "default";
+    counters.delete(l);
+    opts.onCountReset?.(l);
+  }));
+  global.setSync("__console_group", new ivm.Callback((label) => {
+    const l = label ?? "default";
+    groupDepth++;
+    opts.onGroup?.(l, false);
+  }));
+  global.setSync("__console_groupCollapsed", new ivm.Callback((label) => {
+    const l = label ?? "default";
+    groupDepth++;
+    opts.onGroup?.(l, true);
+  }));
+  global.setSync("__console_groupEnd", new ivm.Callback(() => {
+    if (groupDepth > 0) {
+      groupDepth--;
+    }
+    opts.onGroupEnd?.();
+  }));
+  global.setSync("__console_clear", new ivm.Callback(() => {
+    opts.onClear?.();
+  }));
+  global.setSync("__console_assert", new ivm.Callback((condition, ...args) => {
+    if (!condition) {
+      opts.onAssert?.(condition, ...args);
+    }
+  }));
+  context.evalSync(`
+    globalThis.console = {
+      log: __console_log,
+      warn: __console_warn,
+      error: __console_error,
+      debug: __console_debug,
+      info: __console_info,
+      trace: __console_trace,
+      dir: __console_dir,
+      table: __console_table,
+      time: __console_time,
+      timeEnd: __console_timeEnd,
+      timeLog: __console_timeLog,
+      count: __console_count,
+      countReset: __console_countReset,
+      group: __console_group,
+      groupCollapsed: __console_groupCollapsed,
+      groupEnd: __console_groupEnd,
+      clear: __console_clear,
+      assert: __console_assert,
+    };
+  `);
+  return {
+    dispose() {
+      timers.clear();
+      counters.clear();
+      groupDepth = 0;
+    },
+    reset() {
+      timers.clear();
+      counters.clear();
+      groupDepth = 0;
+    },
+    getTimers() {
+      return new Map(timers);
+    },
+    getCounters() {
+      return new Map(counters);
+    },
+    getGroupDepth() {
+      return groupDepth;
+    }
+  };
+}
+export {
+  setupConsole
+};
+
+//# debugId=5ED37B6ACE7B494E64756E2164756E21

package/dist/mjs/index.mjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.ts"],
+  "sourcesContent": [
+    "import ivm from \"isolated-vm\";\n\nexport interface ConsoleOptions {\n  onLog?: (level: string, ...args: unknown[]) => void;\n  onTime?: (label: string, duration: number) => void;\n  onTimeLog?: (label: string, duration: number, ...args: unknown[]) => void;\n  onCount?: (label: string, count: number) => void;\n  onCountReset?: (label: string) => void;\n  onGroup?: (label: string, collapsed: boolean) => void;\n  onGroupEnd?: () => void;\n  onClear?: () => void;\n  onAssert?: (condition: boolean, ...args: unknown[]) => void;\n}\n\nexport interface ConsoleHandle {\n  dispose(): void;\n  reset(): void;\n  getTimers(): Map<string, number>;\n  getCounters(): Map<string, number>;\n  getGroupDepth(): number;\n}\n\n/**\n * Setup console API in an isolated-vm context\n *\n * Injects console.log, console.warn, console.error, console.info, console.debug,\n * console.trace, console.dir, console.table, console.time, console.timeEnd,\n * console.timeLog, console.count, console.countReset, console.group,\n * console.groupCollapsed, console.groupEnd, console.clear, console.assert\n *\n * @example\n * const handle = await setupConsole(context, {\n *   onLog: (level, ...args) => console.log(`[${level}]`, ...args)\n * });\n */\nexport async function setupConsole(\n  context: ivm.Context,\n  options?: ConsoleOptions\n): Promise<ConsoleHandle> {\n  const opts = options ?? {};\n\n  // State management\n  const timers = new Map<string, number>();\n  const counters = new Map<string, number>();\n  let groupDepth = 0;\n\n  const global = context.global;\n\n  // Log-level methods\n  const logLevels = [\n    \"log\",\n    \"warn\",\n    \"error\",\n    \"debug\",\n    \"info\",\n    \"trace\",\n    \"dir\",\n    \"table\",\n  ];\n\n  for (const level of logLevels) {\n    global.setSync(\n      `__console_${level}`,\n      new ivm.Callback((...args: unknown[]) => {\n        opts.onLog?.(level, ...args);\n      })\n    );\n  }\n\n  // Timing methods\n  global.setSync(\n    \"__console_time\",\n    new ivm.Callback((label?: string) => {\n      const l = label ?? \"default\";\n      timers.set(l, performance.now());\n    })\n  );\n\n  global.setSync(\n    \"__console_timeEnd\",\n    new ivm.Callback((label?: string) => {\n      const l = label ?? \"default\";\n      const start = timers.get(l);\n      if (start !== undefined) {\n        const duration = performance.now() - start;\n        timers.delete(l);\n        opts.onTime?.(l, duration);\n      }\n    })\n  );\n\n  global.setSync(\n    \"__console_timeLog\",\n    new ivm.Callback((label?: string, ...args: unknown[]) => {\n      const l = label ?? \"default\";\n      const start = timers.get(l);\n      if (start !== undefined) {\n        const duration = performance.now() - start;\n        opts.onTimeLog?.(l, duration, ...args);\n      }\n    })\n  );\n\n  // Counting methods\n  global.setSync(\n    \"__console_count\",\n    new ivm.Callback((label?: string) => {\n      const l = label ?? \"default\";\n      const count = (counters.get(l) ?? 0) + 1;\n      counters.set(l, count);\n      opts.onCount?.(l, count);\n    })\n  );\n\n  global.setSync(\n    \"__console_countReset\",\n    new ivm.Callback((label?: string) => {\n      const l = label ?? \"default\";\n      counters.delete(l);\n      opts.onCountReset?.(l);\n    })\n  );\n\n  // Grouping methods\n  global.setSync(\n    \"__console_group\",\n    new ivm.Callback((label?: string) => {\n      const l = label ?? \"default\";\n      groupDepth++;\n      opts.onGroup?.(l, false);\n    })\n  );\n\n  global.setSync(\n    \"__console_groupCollapsed\",\n    new ivm.Callback((label?: string) => {\n      const l = label ?? \"default\";\n      groupDepth++;\n      opts.onGroup?.(l, true);\n    })\n  );\n\n  global.setSync(\n    \"__console_groupEnd\",\n    new ivm.Callback(() => {\n      if (groupDepth > 0) {\n        groupDepth--;\n      }\n      opts.onGroupEnd?.();\n    })\n  );\n\n  // Other methods\n  global.setSync(\n    \"__console_clear\",\n    new ivm.Callback(() => {\n      opts.onClear?.();\n    })\n  );\n\n  global.setSync(\n    \"__console_assert\",\n    new ivm.Callback((condition: boolean, ...args: unknown[]) => {\n      if (!condition) {\n        opts.onAssert?.(condition, ...args);\n      }\n    })\n  );\n\n  // Inject console object\n  context.evalSync(`\n    globalThis.console = {\n      log: __console_log,\n      warn: __console_warn,\n      error: __console_error,\n      debug: __console_debug,\n      info: __console_info,\n      trace: __console_trace,\n      dir: __console_dir,\n      table: __console_table,\n      time: __console_time,\n      timeEnd: __console_timeEnd,\n      timeLog: __console_timeLog,\n      count: __console_count,\n      countReset: __console_countReset,\n      group: __console_group,\n      groupCollapsed: __console_groupCollapsed,\n      groupEnd: __console_groupEnd,\n      clear: __console_clear,\n      assert: __console_assert,\n    };\n  `);\n\n  return {\n    dispose() {\n      timers.clear();\n      counters.clear();\n      groupDepth = 0;\n    },\n    reset() {\n      timers.clear();\n      counters.clear();\n      groupDepth = 0;\n    },\n    getTimers() {\n      return new Map(timers);\n    },\n    getCounters() {\n      return new Map(counters);\n    },\n    getGroupDepth() {\n      return groupDepth;\n    },\n  };\n}\n"
+  ],
+  "mappings": ";;AAAA;AAmCA,eAAsB,YAAY,CAChC,SACA,SACwB;AAAA,EACxB,MAAM,OAAO,WAAW,CAAC;AAAA,EAGzB,MAAM,SAAS,IAAI;AAAA,EACnB,MAAM,WAAW,IAAI;AAAA,EACrB,IAAI,aAAa;AAAA,EAEjB,MAAM,SAAS,QAAQ;AAAA,EAGvB,MAAM,YAAY;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EAEA,WAAW,SAAS,WAAW;AAAA,IAC7B,OAAO,QACL,aAAa,SACb,IAAI,IAAI,SAAS,IAAI,SAAoB;AAAA,MACvC,KAAK,QAAQ,OAAO,GAAG,IAAI;AAAA,KAC5B,CACH;AAAA,EACF;AAAA,EAGA,OAAO,QACL,kBACA,IAAI,IAAI,SAAS,CAAC,UAAmB;AAAA,IACnC,MAAM,IAAI,SAAS;AAAA,IACnB,OAAO,IAAI,GAAG,YAAY,IAAI,CAAC;AAAA,GAChC,CACH;AAAA,EAEA,OAAO,QACL,qBACA,IAAI,IAAI,SAAS,CAAC,UAAmB;AAAA,IACnC,MAAM,IAAI,SAAS;AAAA,IACnB,MAAM,QAAQ,OAAO,IAAI,CAAC;AAAA,IAC1B,IAAI,UAAU,WAAW;AAAA,MACvB,MAAM,WAAW,YAAY,IAAI,IAAI;AAAA,MACrC,OAAO,OAAO,CAAC;AAAA,MACf,KAAK,SAAS,GAAG,QAAQ;AAAA,IAC3B;AAAA,GACD,CACH;AAAA,EAEA,OAAO,QACL,qBACA,IAAI,IAAI,SAAS,CAAC,UAAmB,SAAoB;AAAA,IACvD,MAAM,IAAI,SAAS;AAAA,IACnB,MAAM,QAAQ,OAAO,IAAI,CAAC;AAAA,IAC1B,IAAI,UAAU,WAAW;AAAA,MACvB,MAAM,WAAW,YAAY,IAAI,IAAI;AAAA,MACrC,KAAK,YAAY,GAAG,UAAU,GAAG,IAAI;AAAA,IACvC;AAAA,GACD,CACH;AAAA,EAGA,OAAO,QACL,mBACA,IAAI,IAAI,SAAS,CAAC,UAAmB;AAAA,IACnC,MAAM,IAAI,SAAS;AAAA,IACnB,MAAM,SAAS,SAAS,IAAI,CAAC,KAAK,KAAK;AAAA,IACvC,SAAS,IAAI,GAAG,KAAK;AAAA,IACrB,KAAK,UAAU,GAAG,KAAK;AAAA,GACxB,CACH;AAAA,EAEA,OAAO,QACL,wBACA,IAAI,IAAI,SAAS,CAAC,UAAmB;AAAA,IACnC,MAAM,IAAI,SAAS;AAAA,IACnB,SAAS,OAAO,CAAC;AAAA,IACjB,KAAK,eAAe,CAAC;AAAA,GACtB,CACH;AAAA,EAGA,OAAO,QACL,mBACA,IAAI,IAAI,SAAS,CAAC,UAAmB;AAAA,IACnC,MAAM,IAAI,SAAS;AAAA,IACnB;AAAA,IACA,KAAK,UAAU,GAAG,KAAK;AAAA,GACxB,CACH;AAAA,EAEA,OAAO,QACL,4BACA,IAAI,IAAI,SAAS,CAAC,UAAmB;AAAA,IACnC,MAAM,IAAI,SAAS;AAAA,IACnB;AAAA,IACA,KAAK,UAAU,GAAG,IAAI;AAAA,GACvB,CACH;AAAA,EAEA,OAAO,QACL,sBACA,IAAI,IAAI,SAAS,MAAM;AAAA,IACrB,IAAI,aAAa,GAAG;AAAA,MAClB;AAAA,IACF;AAAA,IACA,KAAK,aAAa;AAAA,GACnB,CACH;AAAA,EAGA,OAAO,QACL,mBACA,IAAI,IAAI,SAAS,MAAM;AAAA,IACrB,KAAK,UAAU;AAAA,GAChB,CACH;AAAA,EAEA,OAAO,QACL,oBACA,IAAI,IAAI,SAAS,CAAC,cAAuB,SAAoB;AAAA,IAC3D,IAAI,CAAC,WAAW;AAAA,MACd,KAAK,WAAW,WAAW,GAAG,IAAI;AAAA,IACpC;AAAA,GACD,CACH;AAAA,EAGA,QAAQ,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,GAqBhB;AAAA,EAED,OAAO;AAAA,IACL,OAAO,GAAG;AAAA,MACR,OAAO,MAAM;AAAA,MACb,SAAS,MAAM;AAAA,MACf,aAAa;AAAA;AAAA,IAEf,KAAK,GAAG;AAAA,MACN,OAAO,MAAM;AAAA,MACb,SAAS,MAAM;AAAA,MACf,aAAa;AAAA;AAAA,IAEf,SAAS,GAAG;AAAA,MACV,OAAO,IAAI,IAAI,MAAM;AAAA;AAAA,IAEvB,WAAW,GAAG;AAAA,MACZ,OAAO,IAAI,IAAI,QAAQ;AAAA;AAAA,IAEzB,aAAa,GAAG;AAAA,MACd,OAAO;AAAA;AAAA,EAEX;AAAA;",
+  "debugId": "5ED37B6ACE7B494E64756E2164756E21",
+  "names": []
+}

package/dist/mjs/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "@ricsam/isolate-console",
+  "version": "0.1.2",
+  "type": "module"
+}

package/dist/types/index.d.ts

@@ -0,0 +1,33 @@
+import ivm from "isolated-vm";
+export interface ConsoleOptions {
+    onLog?: (level: string, ...args: unknown[]) => void;
+    onTime?: (label: string, duration: number) => void;
+    onTimeLog?: (label: string, duration: number, ...args: unknown[]) => void;
+    onCount?: (label: string, count: number) => void;
+    onCountReset?: (label: string) => void;
+    onGroup?: (label: string, collapsed: boolean) => void;
+    onGroupEnd?: () => void;
+    onClear?: () => void;
+    onAssert?: (condition: boolean, ...args: unknown[]) => void;
+}
+export interface ConsoleHandle {
+    dispose(): void;
+    reset(): void;
+    getTimers(): Map<string, number>;
+    getCounters(): Map<string, number>;
+    getGroupDepth(): number;
+}
+/**
+ * Setup console API in an isolated-vm context
+ *
+ * Injects console.log, console.warn, console.error, console.info, console.debug,
+ * console.trace, console.dir, console.table, console.time, console.timeEnd,
+ * console.timeLog, console.count, console.countReset, console.group,
+ * console.groupCollapsed, console.groupEnd, console.clear, console.assert
+ *
+ * @example
+ * const handle = await setupConsole(context, {
+ *   onLog: (level, ...args) => console.log(`[${level}]`, ...args)
+ * });
+ */
+export declare function setupConsole(context: ivm.Context, options?: ConsoleOptions): Promise<ConsoleHandle>;

package/dist/types/isolate.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Global Type Definitions for @ricsam/isolate-console
+ *
+ * These types define the globals injected by setupConsole() into an isolated-vm context.
+ * Use these types to typecheck user code that will run inside the V8 isolate.
+ */
+
+export {};
+
+declare global {
+  /**
+   * Console interface for logging and debugging.
+   * @see https://developer.mozilla.org/en-US/docs/Web/API/Console
+   */
+  interface Console {
+    /**
+     * Log a message to the console.
+     * @param data - Values to log
+     */
+    log(...data: unknown[]): void;
+
+    /**
+     * Log a warning message.
+     * @param data - Values to log
+     */
+    warn(...data: unknown[]): void;
+
+    /**
+     * Log an error message.
+     * @param data - Values to log
+     */
+    error(...data: unknown[]): void;
+
+    /**
+     * Log a debug message.
+     * @param data - Values to log
+     */
+    debug(...data: unknown[]): void;
+
+    /**
+     * Log an info message.
+     * @param data - Values to log
+     */
+    info(...data: unknown[]): void;
+
+    /**
+     * Log a stack trace.
+     * @param data - Values to log with the trace
+     */
+    trace(...data: unknown[]): void;
+
+    /**
+     * Display an object in a formatted way.
+     * @param item - Object to display
+     * @param options - Display options
+     */
+    dir(item: unknown, options?: object): void;
+
+    /**
+     * Display tabular data.
+     * @param tabularData - Data to display as a table
+     * @param properties - Optional array of property names to include
+     */
+    table(tabularData: unknown, properties?: string[]): void;
+
+    /**
+     * Start a timer.
+     * @param label - Timer label (default: "default")
+     */
+    time(label?: string): void;
+
+    /**
+     * End a timer and log the elapsed time.
+     * @param label - Timer label (default: "default")
+     */
+    timeEnd(label?: string): void;
+
+    /**
+     * Log the elapsed time of a timer without ending it.
+     * @param label - Timer label (default: "default")
+     * @param data - Additional values to log
+     */
+    timeLog(label?: string, ...data: unknown[]): void;
+
+    /**
+     * Log an error if the assertion is false.
+     * @param condition - Condition to test
+     * @param data - Values to log if assertion fails
+     */
+    assert(condition?: boolean, ...data: unknown[]): void;
+
+    /**
+     * Increment and log a counter.
+     * @param label - Counter label (default: "default")
+     */
+    count(label?: string): void;
+
+    /**
+     * Reset a counter.
+     * @param label - Counter label (default: "default")
+     */
+    countReset(label?: string): void;
+
+    /**
+     * Clear the console.
+     */
+    clear(): void;
+
+    /**
+     * Start an inline group.
+     * @param data - Group label
+     */
+    group(...data: unknown[]): void;
+
+    /**
+     * Start a collapsed inline group.
+     * @param data - Group label
+     */
+    groupCollapsed(...data: unknown[]): void;
+
+    /**
+     * End the current inline group.
+     */
+    groupEnd(): void;
+  }
+
+  /**
+   * Console object for logging and debugging.
+   */
+  const console: Console;
+}

package/package.json

@@ -1,10 +1,58 @@
 {
   "name": "@ricsam/isolate-console",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @ricsam/isolate-console",
+  "version": "0.1.2",
+  "main": "./dist/cjs/index.cjs",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "require": "./dist/cjs/index.cjs",
+      "import": "./dist/mjs/index.mjs"
+    },
+    "./isolate": {
+      "types": "./dist/types/isolate.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test --experimental-strip-types 'src/**/*.test.ts'",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@ricsam/isolate-core": "*",
+    "isolated-vm": "^6"
+  },
+  "peerDependencies": {
+    "isolated-vm": "^6"
+  },
+  "author": "Richard Samuelsson",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ricsam/isolate.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ricsam/isolate/issues"
+  },
+  "homepage": "https://github.com/ricsam/isolate#readme",
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
+    "isolated-vm",
+    "sandbox",
+    "javascript",
+    "runtime",
+    "fetch",
+    "filesystem",
+    "streams",
+    "v8",
+    "isolate"
+  ],
+  "description": "Console API implementation for isolated-vm V8 sandbox",
+  "module": "./dist/mjs/index.mjs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
   ]
-}
+}