osra 0.6.6 → 0.6.7

package/build/revivables/identity.d.ts

@@ -9,24 +9,26 @@ export type Messages = {
 };
 export declare const Messages: Messages;
 declare const IDENTITY_MARKER: unique symbol;
-type IdentityWrapper<T = unknown> = {
+/** Phantom shape. A tracked value carries no marker of its own, the mark lives in a WeakMap, so
+ *  this is what `isType` declares instead: matching it at the type level would widen `Capable` to
+ *  every object, and nothing a user writes structurally matches this. */
+type IdentityMarked = {
     readonly [IDENTITY_MARKER]: true;
-    readonly value: T;
 };
 export type BoxedIdentity<T extends Capable = Capable> = BoxBaseType<typeof type> & {
     id: string;
     inner?: Capable;
     [UnderlyingType]: T;
 };
-/** Wrap a value so osra preserves reference identity across the RPC
- *  boundary. Idempotent; primitives pass through unchanged. Lies at the
- *  type level - runtime value is an IdentityWrapper<T> typed as T. */
+/** Mark a value so osra preserves its reference identity across the boundary. The peer's revived
+ *  value stands for this one, and handing it back - to you, or onward to a further context and back
+ *  again - resolves to this very reference. The mark sticks to the value, so only the side that
+ *  owns it has to opt in. Idempotent, and primitives pass through unchanged. */
 export declare const identity: <T>(value: T) => T;
-export declare const isType: (value: unknown) => value is IdentityWrapper;
-export declare const box: <T extends Capable, TContext extends RevivableContext>(wrapper: IdentityWrapper<T>, context: TContext) => BoxedIdentity<T>;
-/** Identity-box a referenceable value with a caller-supplied inner box,
- *  bypassing the recursive-box step. Used by revivables (symbol with
- *  description=undefined) where recursing back through their own box
+export declare const isType: (value: unknown) => value is IdentityMarked;
+export declare const box: <T extends Capable, TContext extends RevivableContext>(value: T, context: TContext) => BoxedIdentity<T>;
+/** Identity-box a referenceable value with a caller-supplied inner box, bypassing the walker. Used
+ *  by revivables (symbol with description=undefined) where recursing back through their own box
  *  would loop into this module again. */
 export declare const boxByReference: <T extends WeakKey, TContext extends RevivableContext>(value: T, innerBox: Capable, context: TContext) => BoxedIdentity;
 export declare const revive: <T extends BoxedIdentity, TContext extends RevivableContext>(value: T, context: TContext) => T[UnderlyingType];

package/build/revivables/index.d.ts

@@ -71,4 +71,11 @@ export declare const defaultRevivableModules: readonly [typeof transfer, typeof
 export type DefaultRevivableModules = typeof defaultRevivableModules;
 export type DefaultRevivableModule = DefaultRevivableModules[number];
 export declare const recursiveBox: <T extends Capable, TModules extends readonly RevivableModule[]>(value: T, context: RevivableContext<TModules>) => DeepReplaceWithBox<T, TModules[number]>;
+/** Box a value your own module claimed in place: every other module gets its turn and children are
+ *  walked as usual, but `claimedBy` is skipped, and the cycle guard the caller's `recursiveBox`
+ *  frame already holds for this value is not re-entered.
+ *  A module needs this when its `isType` matches a bare value rather than a wrapper around one, the
+ *  way `identity()` marks a reference in place: `recursiveBox` on that same value would come
+ *  straight back to the module, and the guard would report it as a cycle. */
+export declare const boxClaimedValue: <T extends Capable, TModules extends readonly RevivableModule[]>(value: T, context: RevivableContext<TModules>, claimedBy: string) => DeepReplaceWithBox<T, TModules[number]>;
 export declare const recursiveRevive: <T extends Capable, TModules extends readonly RevivableModule[]>(value: T, context: RevivableContext<TModules>) => DeepReplaceWithRevive<T, TModules[number]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "osra",
-  "version": "0.6.6",
+  "version": "0.6.7",
   "description": "Easy communication between workers",
   "homepage": "https://github.com/Banou26/osra#readme",
   "bugs": {