@ricsam/quickjs-runtime 0.0.1 → 0.2.0

package/README.md

@@ -1,45 +1,23 @@
 # @ricsam/quickjs-runtime
 
-## ⚠️ 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/quickjs-runtime`
-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**
+Umbrella package that combines all APIs.
+
+```typescript
+import { setupRuntime } from "@ricsam/quickjs-runtime";
+
+const handle = setupRuntime(context, {
+  fetch: {
+    onFetch: async (req) => fetch(req),
+  },
+  fs: {
+    getDirectory: async (path) => createNodeDirectoryHandle(`./sandbox${path}`),
+  },
+});
+
+// Access individual handles
+handle.core;   // CoreHandle
+handle.fetch;  // FetchHandle
+handle.fs;     // FsHandle
+
+handle.dispose(); // Cleanup all
+```

package/dist/cjs/index.cjs

@@ -0,0 +1,89 @@
+// @bun @bun-cjs
+(function(exports, require, module, __filename, __dirname) {var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __reExport = (target, mod, secondTarget) => {
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(target, key) && key !== "default")
+      __defProp(target, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  if (secondTarget) {
+    for (let key of __getOwnPropNames(mod))
+      if (!__hasOwnProp.call(secondTarget, key) && key !== "default")
+        __defProp(secondTarget, key, {
+          get: () => mod[key],
+          enumerable: true
+        });
+    return secondTarget;
+  }
+};
+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/runtime/src/index.ts
+var exports_src = {};
+__export(exports_src, {
+  setupRuntime: () => setupRuntime
+});
+module.exports = __toCommonJS(exports_src);
+__reExport(exports_src, require("@ricsam/quickjs-core"), module.exports);
+__reExport(exports_src, require("@ricsam/quickjs-fetch"), module.exports);
+__reExport(exports_src, require("@ricsam/quickjs-fs"), module.exports);
+var import_quickjs_core = require("@ricsam/quickjs-core");
+var import_quickjs_fetch = require("@ricsam/quickjs-fetch");
+var import_quickjs_fs = require("@ricsam/quickjs-fs");
+function setupRuntime(context, options = {}) {
+  const stateMap = import_quickjs_core.createStateMap();
+  const core = import_quickjs_core.setupCore(context, { stateMap });
+  let fetch;
+  let fs;
+  if (options.fetch) {
+    const fetchOptions = options.fetch === true ? { stateMap, coreHandle: core } : { ...options.fetch, stateMap, coreHandle: core };
+    fetch = import_quickjs_fetch.setupFetch(context, fetchOptions);
+  }
+  if (options.fs) {
+    fs = import_quickjs_fs.setupFs(context, {
+      ...options.fs,
+      stateMap,
+      coreHandle: core
+    });
+  }
+  return {
+    core,
+    fetch,
+    fs,
+    stateMap,
+    dispose() {
+      fs?.dispose();
+      fetch?.dispose();
+      core.dispose();
+    }
+  };
+}
+})
+
+//# debugId=17426326EF41B9C964756E2164756E21

package/dist/cjs/index.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.ts"],
+  "sourcesContent": [
+    "// Re-export everything from sub-packages\nexport * from \"@ricsam/quickjs-core\";\nexport * from \"@ricsam/quickjs-fetch\";\nexport * from \"@ricsam/quickjs-fs\";\n\nimport type { QuickJSContext } from \"quickjs-emscripten\";\nimport {\n  setupCore,\n  createStateMap,\n  type StateMap,\n  type CoreHandle,\n} from \"@ricsam/quickjs-core\";\nimport {\n  setupFetch,\n  type SetupFetchOptions,\n  type FetchHandle,\n} from \"@ricsam/quickjs-fetch\";\nimport {\n  setupFs,\n  type SetupFsOptions,\n  type FsHandle,\n} from \"@ricsam/quickjs-fs\";\n\n/**\n * Options for setting up the runtime\n */\nexport interface SetupRuntimeOptions {\n  /**\n   * Fetch API options\n   * Pass `true` to enable with defaults\n   * Pass `false` or omit to disable\n   */\n  fetch?: SetupFetchOptions | boolean;\n\n  /**\n   * File system options\n   * Pass options object to enable\n   * Pass `false` or omit to disable\n   */\n  fs?: SetupFsOptions | false;\n}\n\n/**\n * Handle returned from setupRuntime\n */\nexport interface RuntimeHandle {\n  /** Core handle (always present) */\n  core: CoreHandle;\n\n  /** Fetch handle (if enabled) */\n  fetch?: FetchHandle;\n\n  /** File system handle (if enabled) */\n  fs?: FsHandle;\n\n  /** Shared state map */\n  readonly stateMap: StateMap;\n\n  /** Dispose all handles and cleanup */\n  dispose(): void;\n}\n\n/**\n * Setup multiple APIs in a QuickJS context\n *\n * @example\n * const handle = setupRuntime(context, {\n *   fetch: {\n *     onFetch: async (req) => fetch(req),\n *   },\n *   fs: {\n *     getDirectory: async (path) => createNodeDirectoryHandle(`/sandbox${path}`),\n *   },\n * });\n *\n * // Use the context...\n *\n * handle.dispose();\n */\nexport function setupRuntime(\n  context: QuickJSContext,\n  options: SetupRuntimeOptions = {}\n): RuntimeHandle {\n  const stateMap = createStateMap();\n\n  // Always setup core\n  const core = setupCore(context, { stateMap });\n\n  let fetch: FetchHandle | undefined;\n  let fs: FsHandle | undefined;\n\n  // Setup fetch if enabled\n  if (options.fetch) {\n    const fetchOptions: SetupFetchOptions =\n      options.fetch === true\n        ? { stateMap, coreHandle: core }\n        : { ...options.fetch, stateMap, coreHandle: core };\n\n    fetch = setupFetch(context, fetchOptions);\n  }\n\n  // Setup fs if provided\n  if (options.fs) {\n    fs = setupFs(context, {\n      ...options.fs,\n      stateMap,\n      coreHandle: core,\n    });\n  }\n\n  return {\n    core,\n    fetch,\n    fs,\n    stateMap,\n    dispose() {\n      fs?.dispose();\n      fetch?.dispose();\n      core.dispose();\n    },\n  };\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA;AACA;AACA;AAQO,IALP;AAUO,IAJP;AASO,IAJP;AA8DO,SAAS,YAAY,CAC1B,SACA,UAA+B,CAAC,GACjB;AAAA,EACf,MAAM,WAAW,mCAAe;AAAA,EAGhC,MAAM,OAAO,8BAAU,SAAS,EAAE,SAAS,CAAC;AAAA,EAE5C,IAAI;AAAA,EACJ,IAAI;AAAA,EAGJ,IAAI,QAAQ,OAAO;AAAA,IACjB,MAAM,eACJ,QAAQ,UAAU,OACd,EAAE,UAAU,YAAY,KAAK,IAC7B,KAAK,QAAQ,OAAO,UAAU,YAAY,KAAK;AAAA,IAErD,QAAQ,gCAAW,SAAS,YAAY;AAAA,EAC1C;AAAA,EAGA,IAAI,QAAQ,IAAI;AAAA,IACd,KAAK,0BAAQ,SAAS;AAAA,SACjB,QAAQ;AAAA,MACX;AAAA,MACA,YAAY;AAAA,IACd,CAAC;AAAA,EACH;AAAA,EAEA,OAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,OAAO,GAAG;AAAA,MACR,IAAI,QAAQ;AAAA,MACZ,OAAO,QAAQ;AAAA,MACf,KAAK,QAAQ;AAAA;AAAA,EAEjB;AAAA;",
+  "debugId": "17426326EF41B9C964756E2164756E21",
+  "names": []
+}

package/dist/cjs/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "@ricsam/quickjs-runtime",
+  "version": "0.2.0",
+  "type": "commonjs"
+}

package/dist/mjs/index.mjs

@@ -0,0 +1,48 @@
+// @bun
+// packages/runtime/src/index.ts
+export * from "@ricsam/quickjs-core";
+export * from "@ricsam/quickjs-fetch";
+export * from "@ricsam/quickjs-fs";
+import {
+  setupCore,
+  createStateMap
+} from "@ricsam/quickjs-core";
+import {
+  setupFetch
+} from "@ricsam/quickjs-fetch";
+import {
+  setupFs
+} from "@ricsam/quickjs-fs";
+function setupRuntime(context, options = {}) {
+  const stateMap = createStateMap();
+  const core = setupCore(context, { stateMap });
+  let fetch;
+  let fs;
+  if (options.fetch) {
+    const fetchOptions = options.fetch === true ? { stateMap, coreHandle: core } : { ...options.fetch, stateMap, coreHandle: core };
+    fetch = setupFetch(context, fetchOptions);
+  }
+  if (options.fs) {
+    fs = setupFs(context, {
+      ...options.fs,
+      stateMap,
+      coreHandle: core
+    });
+  }
+  return {
+    core,
+    fetch,
+    fs,
+    stateMap,
+    dispose() {
+      fs?.dispose();
+      fetch?.dispose();
+      core.dispose();
+    }
+  };
+}
+export {
+  setupRuntime
+};
+
+//# debugId=323EC9DA1EDD873164756E2164756E21

package/dist/mjs/index.mjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.ts"],
+  "sourcesContent": [
+    "// Re-export everything from sub-packages\nexport * from \"@ricsam/quickjs-core\";\nexport * from \"@ricsam/quickjs-fetch\";\nexport * from \"@ricsam/quickjs-fs\";\n\nimport type { QuickJSContext } from \"quickjs-emscripten\";\nimport {\n  setupCore,\n  createStateMap,\n  type StateMap,\n  type CoreHandle,\n} from \"@ricsam/quickjs-core\";\nimport {\n  setupFetch,\n  type SetupFetchOptions,\n  type FetchHandle,\n} from \"@ricsam/quickjs-fetch\";\nimport {\n  setupFs,\n  type SetupFsOptions,\n  type FsHandle,\n} from \"@ricsam/quickjs-fs\";\n\n/**\n * Options for setting up the runtime\n */\nexport interface SetupRuntimeOptions {\n  /**\n   * Fetch API options\n   * Pass `true` to enable with defaults\n   * Pass `false` or omit to disable\n   */\n  fetch?: SetupFetchOptions | boolean;\n\n  /**\n   * File system options\n   * Pass options object to enable\n   * Pass `false` or omit to disable\n   */\n  fs?: SetupFsOptions | false;\n}\n\n/**\n * Handle returned from setupRuntime\n */\nexport interface RuntimeHandle {\n  /** Core handle (always present) */\n  core: CoreHandle;\n\n  /** Fetch handle (if enabled) */\n  fetch?: FetchHandle;\n\n  /** File system handle (if enabled) */\n  fs?: FsHandle;\n\n  /** Shared state map */\n  readonly stateMap: StateMap;\n\n  /** Dispose all handles and cleanup */\n  dispose(): void;\n}\n\n/**\n * Setup multiple APIs in a QuickJS context\n *\n * @example\n * const handle = setupRuntime(context, {\n *   fetch: {\n *     onFetch: async (req) => fetch(req),\n *   },\n *   fs: {\n *     getDirectory: async (path) => createNodeDirectoryHandle(`/sandbox${path}`),\n *   },\n * });\n *\n * // Use the context...\n *\n * handle.dispose();\n */\nexport function setupRuntime(\n  context: QuickJSContext,\n  options: SetupRuntimeOptions = {}\n): RuntimeHandle {\n  const stateMap = createStateMap();\n\n  // Always setup core\n  const core = setupCore(context, { stateMap });\n\n  let fetch: FetchHandle | undefined;\n  let fs: FsHandle | undefined;\n\n  // Setup fetch if enabled\n  if (options.fetch) {\n    const fetchOptions: SetupFetchOptions =\n      options.fetch === true\n        ? { stateMap, coreHandle: core }\n        : { ...options.fetch, stateMap, coreHandle: core };\n\n    fetch = setupFetch(context, fetchOptions);\n  }\n\n  // Setup fs if provided\n  if (options.fs) {\n    fs = setupFs(context, {\n      ...options.fs,\n      stateMap,\n      coreHandle: core,\n    });\n  }\n\n  return {\n    core,\n    fetch,\n    fs,\n    stateMap,\n    dispose() {\n      fs?.dispose();\n      fetch?.dispose();\n      core.dispose();\n    },\n  };\n}\n"
+  ],
+  "mappings": ";;AACA;AACA;AACA;AAGA;AAAA;AAAA;AAAA;AAMA;AAAA;AAAA;AAKA;AAAA;AAAA;AA8DO,SAAS,YAAY,CAC1B,SACA,UAA+B,CAAC,GACjB;AAAA,EACf,MAAM,WAAW,eAAe;AAAA,EAGhC,MAAM,OAAO,UAAU,SAAS,EAAE,SAAS,CAAC;AAAA,EAE5C,IAAI;AAAA,EACJ,IAAI;AAAA,EAGJ,IAAI,QAAQ,OAAO;AAAA,IACjB,MAAM,eACJ,QAAQ,UAAU,OACd,EAAE,UAAU,YAAY,KAAK,IAC7B,KAAK,QAAQ,OAAO,UAAU,YAAY,KAAK;AAAA,IAErD,QAAQ,WAAW,SAAS,YAAY;AAAA,EAC1C;AAAA,EAGA,IAAI,QAAQ,IAAI;AAAA,IACd,KAAK,QAAQ,SAAS;AAAA,SACjB,QAAQ;AAAA,MACX;AAAA,MACA,YAAY;AAAA,IACd,CAAC;AAAA,EACH;AAAA,EAEA,OAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,OAAO,GAAG;AAAA,MACR,IAAI,QAAQ;AAAA,MACZ,OAAO,QAAQ;AAAA,MACf,KAAK,QAAQ;AAAA;AAAA,EAEjB;AAAA;",
+  "debugId": "323EC9DA1EDD873164756E2164756E21",
+  "names": []
+}

package/dist/mjs/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "@ricsam/quickjs-runtime",
+  "version": "0.2.0",
+  "type": "module"
+}

package/dist/types/index.d.ts

@@ -0,0 +1,57 @@
+export * from "@ricsam/quickjs-core";
+export * from "@ricsam/quickjs-fetch";
+export * from "@ricsam/quickjs-fs";
+import type { QuickJSContext } from "quickjs-emscripten";
+import { type StateMap, type CoreHandle } from "@ricsam/quickjs-core";
+import { type SetupFetchOptions, type FetchHandle } from "@ricsam/quickjs-fetch";
+import { type SetupFsOptions, type FsHandle } from "@ricsam/quickjs-fs";
+/**
+ * Options for setting up the runtime
+ */
+export interface SetupRuntimeOptions {
+    /**
+     * Fetch API options
+     * Pass `true` to enable with defaults
+     * Pass `false` or omit to disable
+     */
+    fetch?: SetupFetchOptions | boolean;
+    /**
+     * File system options
+     * Pass options object to enable
+     * Pass `false` or omit to disable
+     */
+    fs?: SetupFsOptions | false;
+}
+/**
+ * Handle returned from setupRuntime
+ */
+export interface RuntimeHandle {
+    /** Core handle (always present) */
+    core: CoreHandle;
+    /** Fetch handle (if enabled) */
+    fetch?: FetchHandle;
+    /** File system handle (if enabled) */
+    fs?: FsHandle;
+    /** Shared state map */
+    readonly stateMap: StateMap;
+    /** Dispose all handles and cleanup */
+    dispose(): void;
+}
+/**
+ * Setup multiple APIs in a QuickJS context
+ *
+ * @example
+ * const handle = setupRuntime(context, {
+ *   fetch: {
+ *     onFetch: async (req) => fetch(req),
+ *   },
+ *   fs: {
+ *     getDirectory: async (path) => createNodeDirectoryHandle(`/sandbox${path}`),
+ *   },
+ * });
+ *
+ * // Use the context...
+ *
+ * handle.dispose();
+ */
+export declare function setupRuntime(context: QuickJSContext, options?: SetupRuntimeOptions): RuntimeHandle;

package/package.json

@@ -1,10 +1,57 @@
 {
   "name": "@ricsam/quickjs-runtime",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @ricsam/quickjs-runtime",
+  "version": "0.2.0",
+  "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"
+    }
+  },
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@ricsam/quickjs-core": "^0.2.0",
+    "@ricsam/quickjs-fetch": "^0.2.0",
+    "@ricsam/quickjs-fs": "^0.2.0",
+    "quickjs-emscripten": "^0.31.0"
+  },
+  "peerDependencies": {
+    "quickjs-emscripten": "^0.31.0"
+  },
+  "author": "Richard Samuelsson",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ricsam/richie-qjs.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ricsam/richie-qjs/issues"
+  },
+  "homepage": "https://github.com/ricsam/richie-qjs#readme",
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
+    "quickjs",
+    "sandbox",
+    "javascript",
+    "runtime",
+    "fetch",
+    "filesystem",
+    "streams",
+    "wasm",
+    "emscripten"
+  ],
+  "description": "Complete QuickJS runtime with fetch, fs, and core bindings",
+  "module": "./dist/mjs/index.mjs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
   ]
-}
+}