osra 0.6.4 → 0.6.6

package/build/revivables/transfer.d.ts

@@ -16,6 +16,19 @@ export type BoxedTransfer<T extends Capable = Capable> = BoxBaseType<typeof type
  *  copy when the platform/transport can't transfer the given type. Lies at
  *  the type level - runtime value is a TransferWrapper<T> typed as T. */
 export declare const transfer: <T>(value: T) => T;
+/** Whether boxing is happening inside a transfer() wrapper's extent. Streams read
+ *  this at box time so transfer(stream) propagates move semantics to their chunks. */
+export declare const isInTransfer: () => boolean;
+/** Internal chunk marker: unlike the public transfer(), wraps containers too, so
+ *  transferables nested anywhere inside a chunk move. Not part of the public API. */
+export declare const forceTransfer: <T>(value: T) => T;
+/** Runs fn with the ambient transfer extent suspended. Boxing at independent walk
+ *  entry points (protocol ports, revived-function calls) can fire synchronously
+ *  inside someone else's transfer() extent - an EventPort.start() flush during
+ *  boxing, or user code (a getter) calling a revived function mid-walk. Those
+ *  values are not part of the wrapper's graph, so their move semantics must come
+ *  from a wrapper in their own data, never from the ambient counter. */
+export declare const outsideTransfer: <T>(fn: () => T) => T;
 export declare const isType: (value: unknown) => value is TransferWrapper;
 export declare const box: <T extends Capable, TContext extends RevivableContext>(wrapper: TransferWrapper<T>, context: TContext) => BoxedTransfer<T>;
 export declare const revive: <T extends BoxedTransfer, TContext extends RevivableContext>(value: T, context: TContext) => T[UnderlyingType];

package/build/revivables/writable-stream.d.ts

@@ -21,6 +21,7 @@ export type WriteAck = {
 export type Msg = WriteContext | WriteAck;
 export type BoxedWritableStream<T extends WritableStream = WritableStream> = BoxBaseType<typeof type> & {
     port: BoxedMessagePort<Msg>;
+    transferChunks?: true;
 } & {
     [UnderlyingType]: T;
 };

package/build/types.d.ts

@@ -9,9 +9,7 @@ export type Uuid = `${string}-${string}-${string}-${string}-${string}`;
 export type Jsonable = boolean | null | number | string | {
     [key: string]: Jsonable;
 } | ReadonlyArray<Jsonable>;
-export type Structurable = Jsonable
-/** not really structureable but here for convenience */
- | void | undefined | bigint | Date | RegExp | Blob | File | FileList | ArrayBuffer | ArrayBufferView | ImageBitmap | ImageData | {
+export type Structurable = Jsonable | void | undefined | bigint | Date | RegExp | Blob | File | FileList | ArrayBuffer | ArrayBufferView | ImageBitmap | ImageData | {
     [key: string]: Structurable;
 } | ReadonlyArray<Structurable> | Map<Structurable, Structurable> | Set<Structurable>;
 /** lib.dom declares some `Transferable` members as EMPTY interfaces

package/build/utils/teardown.d.ts

@@ -1,7 +1,6 @@
-/** Per-connection teardown registry. Revivables register cleanup for state
- *  tied to a connection (pending RPC settlements, port routing, caches);
- *  the connection layer runs it on protocol close or unregisterSignal abort.
- *  Registering against an already-torn-down scope runs the callback
- *  immediately so late registrations fail fast instead of leaking. */
 export declare const onTeardown: (scope: WeakKey, fn: () => void) => (() => void);
+/** Whether a scope's teardown has already run. Callers use this to REFUSE work rather than start it:
+ *  `onTeardown` against a dead scope runs the callback immediately, which is a footgun inside an
+ *  initializer, and anything registered afterwards is state no teardown will ever visit again. */
+export declare const isTornDown: (scope: WeakKey) => boolean;
 export declare const runTeardown: (scope: WeakKey) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "osra",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "description": "Easy communication between workers",
   "homepage": "https://github.com/Banou26/osra#readme",
   "bugs": {
@@ -57,19 +57,19 @@
     "docs-dev": "npm run dev -w docs",
     "docs-build": "npm run build -w docs",
     "docs-preview": "npm run preview -w docs",
+    "docs-gen-reference": "npm run gen:reference -w docs",
+    "docs-check-links": "npm run check-links -w docs",
     "docs-check-twoslash": "npm run check-twoslash -w docs"
   },
-  "dependencies": {
-    "@types/webextension-polyfill": "^0.12.4"
-  },
   "devDependencies": {
     "@istanbuljs/nyc-config-typescript": "^1.0.2",
     "@playwright/test": "1.58.2",
     "@types/chai": "^5.2.3",
     "@types/chai-as-promised": "^8.0.2",
-    "@types/chrome": "^0.1.27",
+    "@types/chrome": "^0.1.43",
     "@types/firefox-webext-browser": "^143.0.0",
     "@types/node": "^25.0.2",
+    "@types/webextension-polyfill": "^0.12.5",
     "chai": "^5.3.3",
     "chai-as-promised": "^8.0.1",
     "concurrently": "^9.1.0",