API Reference

IProxyRegistry

Shared in-memory registry that stores target/proxy pairs and lets rs-x move between wrapped and unwrapped references.

Interface: IProxyRegistry

Description

This registry keeps track of original objects and their proxies.

Core services use it to avoid double-wrapping and to recover the original object when needed (for example in deep-clone flows).

Parameters

proxyTargetunknown

Original (non-proxy) object used as registry lookup key.

proxyunknown

Proxy instance associated with proxyTarget.

objectunknown

Value checked by isProxy(...) to determine whether it is a registered proxy.

Return type

getProxy<T> returns the registered proxy as T.

getProxyTarget<T> returns the original target as T.

isProxy returns boolean; register/unregister return void.

Usage notes

Use register(target, proxy) to add or replace a mapping. Use getProxy(target) to read the proxy and getProxyTarget(proxy) to get the original target back.

isProxy(value) checks whether a value is currently registered as a proxy. unregister(target) removes a mapping.

In the default setup, IProxyRegistry resolves to ProxyRegistry as a singleton service in RsXCoreModule. The registry is memory-only and is not persisted.

API

export interface IProxyRegistry {
  getProxyTarget<T>(proxyToFind: unknown): T;
  getProxy<T>(proxyTarget: unknown): T;
  register(proxyTarget: unknown, proxy: unknown): void;
  unregister(proxyTarget: unknown): void;
  isProxy(object: unknown): boolean;
}

Usage example

import {
  InjectionContainer,
  type IProxyRegistry,
  RsXCoreInjectionTokens,
  RsXCoreModule,
} from '@rs-x/core';

await InjectionContainer.load(RsXCoreModule);

const proxyRegistry = InjectionContainer.get(
  RsXCoreInjectionTokens.IProxyRegistry,
) as IProxyRegistry;

const target = { id: 1 };
const proxy = new Proxy(target, {});

proxyRegistry.register(target, proxy);

const proxied = proxyRegistry.getProxy<typeof proxy>(target);
const original = proxyRegistry.getProxyTarget<typeof target>(proxy);
const isRegisteredProxy = proxyRegistry.isProxy(proxy);