@ricsam/quickjs-core 0.2.12 → 0.2.14

package/dist/mjs/url.mjs

@@ -1,22 +1,31 @@
 // @bun
 // packages/core/src/url.ts
 import { defineClass } from "./class-builder.mjs";
+function rebuildURLHref(state) {
+  let userinfo = "";
+  if (state.username) {
+    userinfo = state.password ? `${state.username}:${state.password}@` : `${state.username}@`;
+  }
+  state.href = `${state.protocol}//${userinfo}${state.host}${state.pathname}${state.search}${state.hash}`;
+  state.origin = `${state.protocol}//${state.host}`;
+}
 function createURLClass(context, stateMap) {
   return defineClass(context, stateMap, {
     name: "URL",
     construct: (args) => {
-      const urlString = args[0];
+      const urlInput = args[0];
       const base = args[1];
-      if (urlString === undefined) {
+      if (urlInput === undefined) {
         throw new TypeError("Failed to construct 'URL': 1 argument required, but only 0 present.");
       }
+      const urlString = typeof urlInput === "object" && urlInput !== null && "href" in urlInput ? urlInput.href : String(urlInput);
       let parsed;
       try {
         if (base !== undefined) {
           const baseStr = typeof base === "object" && base !== null && "href" in base ? base.href : String(base);
-          parsed = new globalThis.URL(String(urlString), baseStr);
+          parsed = new globalThis.URL(urlString, baseStr);
         } else {
-          parsed = new globalThis.URL(String(urlString));
+          parsed = new globalThis.URL(urlString);
         }
       } catch (e) {
         throw new TypeError(`Failed to construct 'URL': Invalid URL`);
@@ -39,21 +48,56 @@ function createURLClass(context, stateMap) {
       hash: {
         get() {
           return this.hash;
+        },
+        set(value) {
+          this.hash = value.startsWith("#") ? value : `#${value}`;
+          rebuildURLHref(this);
         }
       },
       host: {
         get() {
           return this.host;
+        },
+        set(value) {
+          const colonIndex = value.lastIndexOf(":");
+          if (colonIndex > -1 && !value.includes("]", colonIndex)) {
+            this.hostname = value.slice(0, colonIndex);
+            this.port = value.slice(colonIndex + 1);
+          } else {
+            this.hostname = value;
+            this.port = "";
+          }
+          this.host = value;
+          rebuildURLHref(this);
         }
       },
       hostname: {
         get() {
           return this.hostname;
+        },
+        set(value) {
+          this.hostname = value;
+          this.host = this.port ? `${value}:${this.port}` : value;
+          rebuildURLHref(this);
         }
       },
       href: {
         get() {
           return this.href;
+        },
+        set(value) {
+          const parsed = new globalThis.URL(value);
+          this.hash = parsed.hash;
+          this.host = parsed.host;
+          this.hostname = parsed.hostname;
+          this.href = parsed.href;
+          this.origin = parsed.origin;
+          this.password = parsed.password;
+          this.pathname = parsed.pathname;
+          this.port = parsed.port;
+          this.protocol = parsed.protocol;
+          this.search = parsed.search;
+          this.username = parsed.username;
         }
       },
       origin: {
@@ -64,31 +108,57 @@ function createURLClass(context, stateMap) {
       password: {
         get() {
           return this.password;
+        },
+        set(value) {
+          this.password = value;
+          rebuildURLHref(this);
         }
       },
       pathname: {
         get() {
           return this.pathname;
+        },
+        set(value) {
+          this.pathname = value.startsWith("/") ? value : `/${value}`;
+          rebuildURLHref(this);
         }
       },
       port: {
         get() {
           return this.port;
+        },
+        set(value) {
+          this.port = value;
+          this.host = value ? `${this.hostname}:${value}` : this.hostname;
+          rebuildURLHref(this);
         }
       },
       protocol: {
         get() {
           return this.protocol;
+        },
+        set(value) {
+          this.protocol = value.endsWith(":") ? value : `${value}:`;
+          this.origin = `${this.protocol}//${this.host}`;
+          rebuildURLHref(this);
         }
       },
       search: {
         get() {
           return this.search;
+        },
+        set(value) {
+          this.search = value && !value.startsWith("?") ? `?${value}` : value;
+          rebuildURLHref(this);
         }
       },
       username: {
         get() {
           return this.username;
+        },
+        set(value) {
+          this.username = value;
+          rebuildURLHref(this);
         }
       }
     },
@@ -98,9 +168,6 @@ function createURLClass(context, stateMap) {
       },
       toJSON() {
         return this.href;
-      },
-      __getSearch__() {
-        return this.search;
       }
     },
     staticMethods: {
@@ -119,18 +186,42 @@ function createURLClass(context, stateMap) {
     }
   });
 }
-function addURLSearchParamsGetter(context) {
+function addURLSearchParamsLinkage(context) {
   const result = context.evalCode(`
     (function() {
-      const searchParamsCache = new Map();
-
       Object.defineProperty(URL.prototype, 'searchParams', {
         get: function() {
-          const instanceId = this.__instanceId__;
-          if (!searchParamsCache.has(instanceId)) {
-            searchParamsCache.set(instanceId, new URLSearchParams(this.__getSearch__()));
+          // Cache the URLSearchParams instance on first access
+          if (!this._cachedSearchParams) {
+            const url = this;
+            const params = new URLSearchParams(this.search);
+
+            // Wrap mutating methods to sync back to URL
+            const originalSet = params.set.bind(params);
+            const originalAppend = params.append.bind(params);
+            const originalDelete = params.delete.bind(params);
+            const originalSort = params.sort.bind(params);
+
+            params.set = function(name, value) {
+              originalSet(name, value);
+              url.search = this.toString();
+            };
+            params.append = function(name, value) {
+              originalAppend(name, value);
+              url.search = this.toString();
+            };
+            params.delete = function(name, value) {
+              originalDelete(name, value);
+              url.search = this.toString();
+            };
+            params.sort = function() {
+              originalSort();
+              url.search = this.toString();
+            };
+
+            this._cachedSearchParams = params;
           }
-          return searchParamsCache.get(instanceId);
+          return this._cachedSearchParams;
         },
         enumerable: true,
         configurable: true
@@ -140,13 +231,15 @@ function addURLSearchParamsGetter(context) {
   if (result.error) {
     const err = context.dump(result.error);
     result.error.dispose();
-    throw new Error(`Failed to add searchParams getter: ${JSON.stringify(err)}`);
+    throw new Error(`Failed to setup URL/URLSearchParams linkage: ${JSON.stringify(err)}`);
   }
   result.value.dispose();
 }
+var addURLSearchParamsGetter = addURLSearchParamsLinkage;
 export {
   createURLClass,
+  addURLSearchParamsLinkage,
   addURLSearchParamsGetter
 };
 
-//# debugId=8408820A4441CF3264756E2164756E21
+//# debugId=3CB02D6BB183083C64756E2164756E21

package/dist/mjs/url.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/url.ts"],
   "sourcesContent": [
-    "import type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\nimport type { StateMap } from \"./types.mjs\";\nimport { defineClass } from \"./class-builder.mjs\";\n\n/**\n * Internal state for URL\n */\nexport interface URLState {\n  hash: string;\n  host: string;\n  hostname: string;\n  href: string;\n  origin: string;\n  password: string;\n  pathname: string;\n  port: string;\n  protocol: string;\n  search: string;\n  username: string;\n}\n\n/**\n * Create the URL class for QuickJS\n *\n * Note: The searchParams property is added separately via evalCode\n * after this class is registered, as it needs to return a URLSearchParams instance.\n */\nexport function createURLClass(\n  context: QuickJSContext,\n  stateMap: StateMap\n): QuickJSHandle {\n  return defineClass<URLState>(context, stateMap, {\n    name: \"URL\",\n    construct: (args) => {\n      const urlString = args[0];\n      const base = args[1];\n\n      if (urlString === undefined) {\n        throw new TypeError(\"Failed to construct 'URL': 1 argument required, but only 0 present.\");\n      }\n\n      let parsed: globalThis.URL;\n      try {\n        if (base !== undefined) {\n          // Handle base URL\n          const baseStr = typeof base === \"object\" && base !== null && \"href\" in base\n            ? (base as URLState).href\n            : String(base);\n          parsed = new globalThis.URL(String(urlString), baseStr);\n        } else {\n          parsed = new globalThis.URL(String(urlString));\n        }\n      } catch (e) {\n        throw new TypeError(`Failed to construct 'URL': Invalid URL`);\n      }\n\n      return {\n        hash: parsed.hash,\n        host: parsed.host,\n        hostname: parsed.hostname,\n        href: parsed.href,\n        origin: parsed.origin,\n        password: parsed.password,\n        pathname: parsed.pathname,\n        port: parsed.port,\n        protocol: parsed.protocol,\n        search: parsed.search,\n        username: parsed.username,\n      };\n    },\n    properties: {\n      hash: {\n        get(this: URLState) {\n          return this.hash;\n        },\n      },\n      host: {\n        get(this: URLState) {\n          return this.host;\n        },\n      },\n      hostname: {\n        get(this: URLState) {\n          return this.hostname;\n        },\n      },\n      href: {\n        get(this: URLState) {\n          return this.href;\n        },\n      },\n      origin: {\n        get(this: URLState) {\n          return this.origin;\n        },\n      },\n      password: {\n        get(this: URLState) {\n          return this.password;\n        },\n      },\n      pathname: {\n        get(this: URLState) {\n          return this.pathname;\n        },\n      },\n      port: {\n        get(this: URLState) {\n          return this.port;\n        },\n      },\n      protocol: {\n        get(this: URLState) {\n          return this.protocol;\n        },\n      },\n      search: {\n        get(this: URLState) {\n          return this.search;\n        },\n      },\n      username: {\n        get(this: URLState) {\n          return this.username;\n        },\n      },\n    },\n    methods: {\n      toString(this: URLState): string {\n        return this.href;\n      },\n      toJSON(this: URLState): string {\n        return this.href;\n      },\n      // Private method to get search for URLSearchParams creation\n      __getSearch__(this: URLState): string {\n        return this.search;\n      },\n    },\n    staticMethods: {\n      canParse(url: unknown, base?: unknown): boolean {\n        try {\n          if (base !== undefined) {\n            new globalThis.URL(String(url), String(base));\n          } else {\n            new globalThis.URL(String(url));\n          }\n          return true;\n        } catch {\n          return false;\n        }\n      },\n    },\n  });\n}\n\n/**\n * Add searchParams getter to URL prototype using evalCode\n * This must be called after both URL and URLSearchParams are registered as globals\n */\nexport function addURLSearchParamsGetter(context: QuickJSContext): void {\n  // Use a WeakMap-like pattern with a Map keyed by instance ID\n  // Each URL instance will cache its URLSearchParams\n  const result = context.evalCode(`\n    (function() {\n      const searchParamsCache = new Map();\n\n      Object.defineProperty(URL.prototype, 'searchParams', {\n        get: function() {\n          const instanceId = this.__instanceId__;\n          if (!searchParamsCache.has(instanceId)) {\n            searchParamsCache.set(instanceId, new URLSearchParams(this.__getSearch__()));\n          }\n          return searchParamsCache.get(instanceId);\n        },\n        enumerable: true,\n        configurable: true\n      });\n    })();\n  `);\n\n  if (result.error) {\n    const err = context.dump(result.error);\n    result.error.dispose();\n    throw new Error(`Failed to add searchParams getter: ${JSON.stringify(err)}`);\n  }\n  result.value.dispose();\n}\n"
+    "import type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\nimport type { StateMap } from \"./types.mjs\";\nimport { defineClass } from \"./class-builder.mjs\";\n\n/**\n * Internal state for URL\n */\nexport interface URLState {\n  hash: string;\n  host: string;\n  hostname: string;\n  href: string;\n  origin: string;\n  password: string;\n  pathname: string;\n  port: string;\n  protocol: string;\n  search: string;\n  username: string;\n}\n\n/**\n * Helper to rebuild the href from URL components\n */\nfunction rebuildURLHref(state: URLState): void {\n  // Build userinfo part\n  let userinfo = \"\";\n  if (state.username) {\n    userinfo = state.password\n      ? `${state.username}:${state.password}@`\n      : `${state.username}@`;\n  }\n\n  // Build the href\n  state.href = `${state.protocol}//${userinfo}${state.host}${state.pathname}${state.search}${state.hash}`;\n\n  // Update origin\n  state.origin = `${state.protocol}//${state.host}`;\n}\n\n/**\n * Create the URL class for QuickJS\n *\n * Note: The searchParams property is added separately via evalCode\n * after this class is registered, as it needs to return a URLSearchParams instance.\n */\nexport function createURLClass(\n  context: QuickJSContext,\n  stateMap: StateMap\n): QuickJSHandle {\n  return defineClass<URLState>(context, stateMap, {\n    name: \"URL\",\n    construct: (args) => {\n      const urlInput = args[0];\n      const base = args[1];\n\n      if (urlInput === undefined) {\n        throw new TypeError(\"Failed to construct 'URL': 1 argument required, but only 0 present.\");\n      }\n\n      // Handle URL object as first argument (extract href)\n      const urlString = typeof urlInput === \"object\" && urlInput !== null && \"href\" in urlInput\n        ? (urlInput as URLState).href\n        : String(urlInput);\n\n      let parsed: globalThis.URL;\n      try {\n        if (base !== undefined) {\n          // Handle base URL\n          const baseStr = typeof base === \"object\" && base !== null && \"href\" in base\n            ? (base as URLState).href\n            : String(base);\n          parsed = new globalThis.URL(urlString, baseStr);\n        } else {\n          parsed = new globalThis.URL(urlString);\n        }\n      } catch (e) {\n        throw new TypeError(`Failed to construct 'URL': Invalid URL`);\n      }\n\n      return {\n        hash: parsed.hash,\n        host: parsed.host,\n        hostname: parsed.hostname,\n        href: parsed.href,\n        origin: parsed.origin,\n        password: parsed.password,\n        pathname: parsed.pathname,\n        port: parsed.port,\n        protocol: parsed.protocol,\n        search: parsed.search,\n        username: parsed.username,\n      };\n    },\n    properties: {\n      hash: {\n        get(this: URLState) {\n          return this.hash;\n        },\n        set(this: URLState, value: string) {\n          this.hash = value.startsWith(\"#\") ? value : `#${value}`;\n          rebuildURLHref(this);\n        },\n      },\n      host: {\n        get(this: URLState) {\n          return this.host;\n        },\n        set(this: URLState, value: string) {\n          // Parse host into hostname and port\n          const colonIndex = value.lastIndexOf(\":\");\n          if (colonIndex > -1 && !value.includes(\"]\", colonIndex)) {\n            this.hostname = value.slice(0, colonIndex);\n            this.port = value.slice(colonIndex + 1);\n          } else {\n            this.hostname = value;\n            this.port = \"\";\n          }\n          this.host = value;\n          rebuildURLHref(this);\n        },\n      },\n      hostname: {\n        get(this: URLState) {\n          return this.hostname;\n        },\n        set(this: URLState, value: string) {\n          this.hostname = value;\n          this.host = this.port ? `${value}:${this.port}` : value;\n          rebuildURLHref(this);\n        },\n      },\n      href: {\n        get(this: URLState) {\n          return this.href;\n        },\n        set(this: URLState, value: string) {\n          // Parse the new href and update all properties\n          const parsed = new globalThis.URL(value);\n          this.hash = parsed.hash;\n          this.host = parsed.host;\n          this.hostname = parsed.hostname;\n          this.href = parsed.href;\n          this.origin = parsed.origin;\n          this.password = parsed.password;\n          this.pathname = parsed.pathname;\n          this.port = parsed.port;\n          this.protocol = parsed.protocol;\n          this.search = parsed.search;\n          this.username = parsed.username;\n        },\n      },\n      origin: {\n        get(this: URLState) {\n          return this.origin;\n        },\n        // origin is read-only per spec\n      },\n      password: {\n        get(this: URLState) {\n          return this.password;\n        },\n        set(this: URLState, value: string) {\n          this.password = value;\n          rebuildURLHref(this);\n        },\n      },\n      pathname: {\n        get(this: URLState) {\n          return this.pathname;\n        },\n        set(this: URLState, value: string) {\n          this.pathname = value.startsWith(\"/\") ? value : `/${value}`;\n          rebuildURLHref(this);\n        },\n      },\n      port: {\n        get(this: URLState) {\n          return this.port;\n        },\n        set(this: URLState, value: string) {\n          this.port = value;\n          this.host = value ? `${this.hostname}:${value}` : this.hostname;\n          rebuildURLHref(this);\n        },\n      },\n      protocol: {\n        get(this: URLState) {\n          return this.protocol;\n        },\n        set(this: URLState, value: string) {\n          this.protocol = value.endsWith(\":\") ? value : `${value}:`;\n          // Update origin\n          this.origin = `${this.protocol}//${this.host}`;\n          rebuildURLHref(this);\n        },\n      },\n      search: {\n        get(this: URLState) {\n          return this.search;\n        },\n        set(this: URLState, value: string) {\n          this.search = value && !value.startsWith(\"?\") ? `?${value}` : value;\n          rebuildURLHref(this);\n        },\n      },\n      username: {\n        get(this: URLState) {\n          return this.username;\n        },\n        set(this: URLState, value: string) {\n          this.username = value;\n          rebuildURLHref(this);\n        },\n      },\n    },\n    methods: {\n      toString(this: URLState): string {\n        return this.href;\n      },\n      toJSON(this: URLState): string {\n        return this.href;\n      },\n    },\n    staticMethods: {\n      canParse(url: unknown, base?: unknown): boolean {\n        try {\n          if (base !== undefined) {\n            new globalThis.URL(String(url), String(base));\n          } else {\n            new globalThis.URL(String(url));\n          }\n          return true;\n        } catch {\n          return false;\n        }\n      },\n    },\n  });\n}\n\n/**\n * Add searchParams getter to URL prototype using evalCode\n * This must be called after both URL and URLSearchParams are registered as globals\n *\n * The getter creates a URLSearchParams instance on first access and wraps its\n * mutating methods (set, append, delete, sort) to sync changes back to the URL.\n * This eliminates cross-module coupling by keeping all sync logic in JavaScript.\n */\nexport function addURLSearchParamsLinkage(context: QuickJSContext): void {\n  const result = context.evalCode(`\n    (function() {\n      Object.defineProperty(URL.prototype, 'searchParams', {\n        get: function() {\n          // Cache the URLSearchParams instance on first access\n          if (!this._cachedSearchParams) {\n            const url = this;\n            const params = new URLSearchParams(this.search);\n\n            // Wrap mutating methods to sync back to URL\n            const originalSet = params.set.bind(params);\n            const originalAppend = params.append.bind(params);\n            const originalDelete = params.delete.bind(params);\n            const originalSort = params.sort.bind(params);\n\n            params.set = function(name, value) {\n              originalSet(name, value);\n              url.search = this.toString();\n            };\n            params.append = function(name, value) {\n              originalAppend(name, value);\n              url.search = this.toString();\n            };\n            params.delete = function(name, value) {\n              originalDelete(name, value);\n              url.search = this.toString();\n            };\n            params.sort = function() {\n              originalSort();\n              url.search = this.toString();\n            };\n\n            this._cachedSearchParams = params;\n          }\n          return this._cachedSearchParams;\n        },\n        enumerable: true,\n        configurable: true\n      });\n    })();\n  `);\n\n  if (result.error) {\n    const err = context.dump(result.error);\n    result.error.dispose();\n    throw new Error(`Failed to setup URL/URLSearchParams linkage: ${JSON.stringify(err)}`);\n  }\n  result.value.dispose();\n}\n\n/**\n * @deprecated Use addURLSearchParamsLinkage instead\n */\nexport const addURLSearchParamsGetter = addURLSearchParamsLinkage;\n"
   ],
-  "mappings": "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",
-  "debugId": "8408820A4441CF3264756E2164756E21",
+  "mappings": "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",
+  "debugId": "3CB02D6BB183083C64756E2164756E21",
   "names": []
 }

package/dist/types/class-helpers.d.ts

@@ -43,3 +43,35 @@ export declare function getInstanceId(value: unknown): number | undefined;
  * Get the class name from an unmarshalled value if it's a defineClass instance
  */
 export declare function getClassName(value: unknown): string | undefined;
+/**
+ * Interface for typed class instance with specific class name
+ */
+export interface TypedClassInstance<T extends string> extends DefineClassInstance {
+    __className__: T;
+}
+/**
+ * Create a type guard for a specific class name
+ *
+ * @example
+ * const isRequest = createClassTypeGuard<"Request">("Request");
+ * if (isRequest(value)) {
+ *   // value is TypedClassInstance<"Request">
+ * }
+ */
+export declare function createClassTypeGuard<T extends string>(className: T): (value: unknown) => value is TypedClassInstance<T>;
+/**
+ * Pre-built type guard for Request instances
+ */
+export declare const isUnmarshalledRequest: (value: unknown) => value is TypedClassInstance<"Request">;
+/**
+ * Pre-built type guard for Response instances
+ */
+export declare const isUnmarshalledResponse: (value: unknown) => value is TypedClassInstance<"Response">;
+/**
+ * Pre-built type guard for Headers instances
+ */
+export declare const isUnmarshalledHeaders: (value: unknown) => value is TypedClassInstance<"Headers">;
+/**
+ * Pre-built type guard for FormData instances
+ */
+export declare const isUnmarshalledFormData: (value: unknown) => value is TypedClassInstance<"FormData">;

package/dist/types/coerce.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Coercion system for QuickJS class instances
+ *
+ * Provides a Zod-like API for detecting and extracting values from
+ * class instances, plain objects, and primitive values.
+ *
+ * This enables consistent handling of class instances across the codebase,
+ * reducing duplication and ensuring reliable type detection.
+ */
+/**
+ * Result of a coercion attempt
+ */
+export type CoercionResult<T> = {
+    success: true;
+    value: T;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * A coercer that can transform unknown values into a specific type
+ */
+export interface Coercer<T> {
+    /** The name of this coercer (for error messages) */
+    readonly name: string;
+    /** Attempt to coerce a value, returning a result object */
+    safeParse(value: unknown): CoercionResult<T>;
+    /** Coerce a value, throwing on failure */
+    parse(value: unknown): T;
+    /** Check if a value can be coerced without actually coercing */
+    is(value: unknown): boolean;
+    /** Create a new coercer with a fallback */
+    or<U>(other: Coercer<U>): Coercer<T | U>;
+    /** Transform the coerced value */
+    transform<U>(fn: (value: T) => U): Coercer<U>;
+    /** Make the coercer optional (allows undefined/null) */
+    optional(): Coercer<T | undefined>;
+}
+/**
+ * Create a base coercer from detection and extraction functions
+ */
+export declare function createCoercer<T>(name: string, detect: (value: unknown) => boolean, extract: (value: unknown) => T): Coercer<T>;
+/**
+ * Create a coercer for a QuickJS class instance
+ */
+export declare function classCoercer<TState>(className: string): Coercer<TState>;
+/**
+ * Coerce a value that could be a class instance OR have a specific shape
+ */
+export declare function instanceOrShape<TState, TShape>(className: string, shapeCheck: (value: unknown) => value is TShape, shapeToState: (value: TShape) => TState): Coercer<TState>;
+export interface URLCoerced {
+    href: string;
+    protocol: string;
+    host: string;
+    hostname: string;
+    port: string;
+    pathname: string;
+    search: string;
+    hash: string;
+    origin: string;
+    username: string;
+    password: string;
+}
+/** Coerce a value to URL data */
+export declare const coerceURL: Coercer<URLCoerced>;
+/** Get just the href string from a URL-like value */
+export declare function coerceToURLString(value: unknown): string;
+export interface HeadersCoerced {
+    headers: Map<string, string[]>;
+}
+/** Coerce a value to Headers data */
+export declare const coerceHeaders: Coercer<HeadersCoerced>;
+/** Coerce body to Uint8Array */
+export declare function coerceBody(value: unknown): Uint8Array | null;
+export interface RequestInitCoerced {
+    method?: string;
+    headersState?: HeadersCoerced;
+    body?: Uint8Array | null;
+    cache?: string;
+    credentials?: string;
+    destination?: string;
+    integrity?: string;
+    keepalive?: boolean;
+    mode?: string;
+    redirect?: string;
+    referrer?: string;
+    referrerPolicy?: string;
+    signal?: unknown;
+}
+/** Coerce a value to Request init data (for use as RequestInit second arg) */
+export declare const coerceRequestInit: Coercer<RequestInitCoerced>;
+export interface ResponseInitCoerced {
+    status?: number;
+    statusText?: string;
+    headersState?: HeadersCoerced;
+}
+/** Coerce a value to Response init data */
+export declare const coerceResponseInit: Coercer<ResponseInitCoerced>;

package/dist/types/index.d.ts

@@ -36,8 +36,8 @@ export { marshal, isHandle, getHandleType } from "./marshal.ts";
 export { unmarshal, cleanupUnmarshaledHandles } from "./unmarshal.ts";
 export { defineFunction, defineAsyncFunction } from "./function-builder.ts";
 export { defineClass, createStateMap, getState, setState, getInstanceState, setInstanceState, getInstanceStateById, cleanupInstanceState, clearAllInstanceState, } from "./class-builder.ts";
-export { isDefineClassInstance, isInstanceOf, getClassInstanceState, getInstanceId, getClassName, } from "./class-helpers.ts";
-export type { DefineClassInstance } from "./class-helpers.ts";
+export { isDefineClassInstance, isInstanceOf, getClassInstanceState, getInstanceId, getClassName, createClassTypeGuard, isUnmarshalledRequest, isUnmarshalledResponse, isUnmarshalledHeaders, isUnmarshalledFormData, } from "./class-helpers.ts";
+export type { DefineClassInstance, TypedClassInstance } from "./class-helpers.ts";
 export { nextInstanceId, registerInstance, getInstanceMetadata, getInstanceClassName, cleanupInstanceState as cleanupInstanceStateById, } from "./instance-state.ts";
 export type { InstanceMetadata } from "./instance-state.ts";
 export { createReadableStream, consumeReadableStream, } from "./streams/readable-stream.ts";
@@ -46,5 +46,7 @@ export { createBlob } from "./blob.ts";
 export { createFile } from "./file.ts";
 export { createURLSearchParamsClass } from "./url-search-params.ts";
 export type { URLSearchParamsState } from "./url-search-params.ts";
-export { createURLClass, addURLSearchParamsGetter } from "./url.ts";
+export { createURLClass, addURLSearchParamsLinkage, addURLSearchParamsGetter } from "./url.ts";
 export type { URLState } from "./url.ts";
+export { createCoercer, classCoercer, instanceOrShape, coerceURL, coerceToURLString, coerceHeaders, coerceBody, coerceRequestInit, coerceResponseInit, } from "./coerce.ts";
+export type { Coercer, CoercionResult, URLCoerced, HeadersCoerced, RequestInitCoerced, ResponseInitCoerced, } from "./coerce.ts";

package/dist/types/url.d.ts

@@ -26,5 +26,13 @@ export declare function createURLClass(context: QuickJSContext, stateMap: StateM
 /**
  * Add searchParams getter to URL prototype using evalCode
  * This must be called after both URL and URLSearchParams are registered as globals
+ *
+ * The getter creates a URLSearchParams instance on first access and wraps its
+ * mutating methods (set, append, delete, sort) to sync changes back to the URL.
+ * This eliminates cross-module coupling by keeping all sync logic in JavaScript.
+ */
+export declare function addURLSearchParamsLinkage(context: QuickJSContext): void;
+/**
+ * @deprecated Use addURLSearchParamsLinkage instead
  */
-export declare function addURLSearchParamsGetter(context: QuickJSContext): void;
+export declare const addURLSearchParamsGetter: typeof addURLSearchParamsLinkage;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/quickjs-core",
-  "version": "0.2.12",
+  "version": "0.2.14",
   "main": "./dist/cjs/index.cjs",
   "types": "./dist/types/index.d.ts",
   "exports": {