@standardserver/shared 0.0.2 → 0.0.4

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 declare function toArray<T>(value: T): T extends readonly any[] ? T : Exclude<T, undefined | null>[];
 
 declare const PACKAGE_NAME = "@standardserver/shared";
-declare const PACKAGE_VERSION = "0.0.2";
+declare const PACKAGE_VERSION = "0.0.4";
 /**
  * Generates a unique symbol for the specified name within the package scope.
  * The symbol is globally registered using `Symbol.for` to ensure consistency across modules.
@@ -67,30 +67,15 @@ declare function stringifyJSON<T>(value: T | {
  */
 declare function isTypescriptObject(maybeObject: unknown): maybeObject is object;
 
-/**
- * A ProxyHandler whose `get` trap receives an additional `fallback` function.
- *
- * The `fallback` returns the default property value as if no proxy
- * interception occurred, and automatically binds methods to the target.
- */
-interface EnhancedProxyHandler<T extends object> extends Omit<ProxyHandler<T>, 'get'> {
-    get(target: T, p: PropertyKey, receiver: any, fallback: () => any): any;
+interface GetOrBindOptions {
+    /**
+     * Whether to bind the function to the target before returning it.
+     *
+     * @default true
+     */
+    bind?: boolean;
 }
-/**
- * Creates a Proxy that enhances the standard `get` trap by providing:
- *
- * - A `fallback` function that:
- *   - Reads the property directly from the target
- *   - Automatically binds methods to the target
- *   - Caches bound methods for stable identity
- * - An internal symbol that allows accessing the original target
- */
-declare function createEnhancedProxy<T extends object>(target: T, handler: EnhancedProxyHandler<T>): T;
-/**
- * Returns the underlying target of an enhanced proxy.
- * If the given value is not an enhanced proxy, it is returned as-is.
- */
-declare function getEnhancedProxyTarget<T extends object>(value: T): T;
+declare function getOrBind<T extends object, K extends PropertyKey>(target: T, property: K, { bind }?: GetOrBindOptions): K extends keyof T ? T[K] : unknown;
 
 interface AsyncIdQueueCloseOptions {
     id?: string;
@@ -128,5 +113,5 @@ declare function sleep(ms: number): Promise<void>;
 
 declare function tryDecodeURIComponent(value: string): string;
 
-export { AbortError, AsyncIdQueue, AsyncIteratorClass, PACKAGE_NAME, PACKAGE_VERSION, SequentialIdGenerator, createEnhancedProxy, getEnhancedProxyTarget, getPackageSymbol, isAsyncIteratorObject, isTypescriptObject, parseEmptyableJSON, sequential, sleep, stringifyJSON, toArray, tryDecodeURIComponent };
-export type { AsyncCleanupFn, AsyncIdQueueCloseOptions, AsyncIdQueueOptions, AsyncIteratorClassNextFn, EnhancedProxyHandler };
+export { AbortError, AsyncIdQueue, AsyncIteratorClass, PACKAGE_NAME, PACKAGE_VERSION, SequentialIdGenerator, getOrBind, getPackageSymbol, isAsyncIteratorObject, isTypescriptObject, parseEmptyableJSON, sequential, sleep, stringifyJSON, toArray, tryDecodeURIComponent };
+export type { AsyncCleanupFn, AsyncIdQueueCloseOptions, AsyncIdQueueOptions, AsyncIteratorClassNextFn, GetOrBindOptions };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 declare function toArray<T>(value: T): T extends readonly any[] ? T : Exclude<T, undefined | null>[];
 
 declare const PACKAGE_NAME = "@standardserver/shared";
-declare const PACKAGE_VERSION = "0.0.2";
+declare const PACKAGE_VERSION = "0.0.4";
 /**
  * Generates a unique symbol for the specified name within the package scope.
  * The symbol is globally registered using `Symbol.for` to ensure consistency across modules.
@@ -67,30 +67,15 @@ declare function stringifyJSON<T>(value: T | {
  */
 declare function isTypescriptObject(maybeObject: unknown): maybeObject is object;
 
-/**
- * A ProxyHandler whose `get` trap receives an additional `fallback` function.
- *
- * The `fallback` returns the default property value as if no proxy
- * interception occurred, and automatically binds methods to the target.
- */
-interface EnhancedProxyHandler<T extends object> extends Omit<ProxyHandler<T>, 'get'> {
-    get(target: T, p: PropertyKey, receiver: any, fallback: () => any): any;
+interface GetOrBindOptions {
+    /**
+     * Whether to bind the function to the target before returning it.
+     *
+     * @default true
+     */
+    bind?: boolean;
 }
-/**
- * Creates a Proxy that enhances the standard `get` trap by providing:
- *
- * - A `fallback` function that:
- *   - Reads the property directly from the target
- *   - Automatically binds methods to the target
- *   - Caches bound methods for stable identity
- * - An internal symbol that allows accessing the original target
- */
-declare function createEnhancedProxy<T extends object>(target: T, handler: EnhancedProxyHandler<T>): T;
-/**
- * Returns the underlying target of an enhanced proxy.
- * If the given value is not an enhanced proxy, it is returned as-is.
- */
-declare function getEnhancedProxyTarget<T extends object>(value: T): T;
+declare function getOrBind<T extends object, K extends PropertyKey>(target: T, property: K, { bind }?: GetOrBindOptions): K extends keyof T ? T[K] : unknown;
 
 interface AsyncIdQueueCloseOptions {
     id?: string;
@@ -128,5 +113,5 @@ declare function sleep(ms: number): Promise<void>;
 
 declare function tryDecodeURIComponent(value: string): string;
 
-export { AbortError, AsyncIdQueue, AsyncIteratorClass, PACKAGE_NAME, PACKAGE_VERSION, SequentialIdGenerator, createEnhancedProxy, getEnhancedProxyTarget, getPackageSymbol, isAsyncIteratorObject, isTypescriptObject, parseEmptyableJSON, sequential, sleep, stringifyJSON, toArray, tryDecodeURIComponent };
-export type { AsyncCleanupFn, AsyncIdQueueCloseOptions, AsyncIdQueueOptions, AsyncIteratorClassNextFn, EnhancedProxyHandler };
+export { AbortError, AsyncIdQueue, AsyncIteratorClass, PACKAGE_NAME, PACKAGE_VERSION, SequentialIdGenerator, getOrBind, getPackageSymbol, isAsyncIteratorObject, isTypescriptObject, parseEmptyableJSON, sequential, sleep, stringifyJSON, toArray, tryDecodeURIComponent };
+export type { AsyncCleanupFn, AsyncIdQueueCloseOptions, AsyncIdQueueOptions, AsyncIteratorClassNextFn, GetOrBindOptions };

package/dist/index.mjs

@@ -3,7 +3,7 @@ function toArray(value) {
 }
 
 const PACKAGE_NAME = "@standardserver/shared";
-const PACKAGE_VERSION = "0.0.2";
+const PACKAGE_VERSION = "0.0.4";
 function getPackageSymbol(name) {
   return Symbol.for(`${PACKAGE_NAME}@${PACKAGE_VERSION}/${name}`);
 }
@@ -119,33 +119,21 @@ function isTypescriptObject(maybeObject) {
   return type === "object" || type === "function";
 }
 
-const ENHANCED_PROXY_TARGET_SYMBOL = getPackageSymbol("ENHANCED_PROXY_TARGET");
-function createEnhancedProxy(target, handler) {
-  const boundMethodCache = /* @__PURE__ */ new WeakMap();
-  return new Proxy(target, {
-    ...handler,
-    get(target2, p, receiver) {
-      if (p === ENHANCED_PROXY_TARGET_SYMBOL) {
-        return target2;
-      }
-      return handler.get(target2, p, receiver, () => {
-        const value = Reflect.get(target2, p);
-        if (typeof value !== "function") {
-          return value;
-        }
-        const cached = boundMethodCache.get(value);
-        if (cached) {
-          return cached;
-        }
-        const bound = value.bind(target2);
-        boundMethodCache.set(value, bound);
-        return bound;
-      });
-    }
-  });
-}
-function getEnhancedProxyTarget(value) {
-  return value[ENHANCED_PROXY_TARGET_SYMBOL] ?? value;
+const GET_OR_BIND_CACHE = /* @__PURE__ */ new WeakMap();
+function getOrBind(target, property, { bind = true } = {}) {
+  const value = Reflect.get(target, property);
+  if (!bind || typeof value !== "function") {
+    return value;
+  }
+  let targetCache = GET_OR_BIND_CACHE.get(value);
+  if (!targetCache) {
+    GET_OR_BIND_CACHE.set(value, targetCache = /* @__PURE__ */ new WeakMap());
+  }
+  let bound = targetCache.get(target);
+  if (!bound) {
+    targetCache.set(target, bound = value.bind(target));
+  }
+  return bound;
 }
 
 class AsyncIdQueue {
@@ -250,4 +238,4 @@ function tryDecodeURIComponent(value) {
   }
 }
 
-export { AbortError, AsyncIdQueue, AsyncIteratorClass, PACKAGE_NAME, PACKAGE_VERSION, SequentialIdGenerator, createEnhancedProxy, getEnhancedProxyTarget, getPackageSymbol, isAsyncIteratorObject, isTypescriptObject, parseEmptyableJSON, sequential, sleep, stringifyJSON, toArray, tryDecodeURIComponent };
+export { AbortError, AsyncIdQueue, AsyncIteratorClass, PACKAGE_NAME, PACKAGE_VERSION, SequentialIdGenerator, getOrBind, getPackageSymbol, isAsyncIteratorObject, isTypescriptObject, parseEmptyableJSON, sequential, sleep, stringifyJSON, toArray, tryDecodeURIComponent };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@standardserver/shared",
   "type": "module",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "license": "MIT",
   "homepage": "https://standardserver.dev",
   "repository": {