/** Opaque runtime identity. The wire codec, never ordinary package state, owns
 * the raw ID. These handles do not themselves confer authority or a lease. */
const identities = new WeakMap<object, string>();
declare const referenceBrand: unique symbol;
export interface QxObjectRef<Identity extends string = string> {
  readonly [referenceBrand]: { readonly [K in Identity]: true };
  equals(other: QxObjectRef<string>): boolean;
}
class Reference {
  constructor(id: string) {
    identities.set(this, id);
    Object.freeze(this);
  }
  equals(other: unknown) {
    return isObjectReference(other) && identities.get(this) === identities.get(other);
  }
  toJSON(): never {
    throw new Error("Object references cannot be serialized into ordinary data");
  }
  toString(): never {
    throw new Error("Object references cannot be coerced to strings");
  }
  [Symbol.toPrimitive](): never {
    throw new Error("Object references cannot be coerced to scalar values");
  }
}
export const isObjectReference = (value: unknown): value is QxObjectRef =>
  typeof value === "object" && value !== null && identities.has(value);

/** Internal transport boundary; intentionally not exported from the SDK entry. */
export const referenceFromWire = (id: string): QxObjectRef => {
  if (typeof id !== "string" || !id) throw new Error("Missing object reference identity");
  return new Reference(id) as unknown as QxObjectRef;
};
export const referenceToWire = (value: unknown): string => {
  if (!isObjectReference(value)) throw new Error("Expected an opaque object reference, not a raw ID");
  return identities.get(value)!;
};
export const assertReferenceFree = (value: unknown, seen = new Set<object>()): void => {
  if (!value || typeof value !== "object") return;
  if (isObjectReference(value))
    throw new Error(
      "Managed references belong in declared RPC references or graph relationships, not ordinary state/messages",
    );
  if (seen.has(value)) throw new Error("Cyclic ordinary data");
  seen.add(value);
  if (!(value instanceof Uint8Array)) for (const child of Object.values(value)) assertReferenceFree(child, seen);
  seen.delete(value);
};