wenay-common2 1.0.48 → 1.0.50

package/README.md

@@ -83,7 +83,7 @@ Bidirectional, strongly-typed RPC protocol over sockets (Socket.IO or similar).
 ## 1. Architecture and Limitations
 
 *   **Multiplexing:** A single physical socket hosts independent channels (`socketKey`), each with its own API object.
-*   **Data Types:** Works with JSON-compatible data. `Date`, `Map`, `Set`, `Class` **cannot** be transmitted.
+*   **Data Types:** Works with JSON-compatible data plus `Date`, `Map`, `Set`, `RegExp`, and `BigInt`. Class instances are sent as plain enumerable object data; methods/prototypes are not preserved.
 *   **Security (RpcLimits):** Server is protected from DDoS attacks. Strict limits on: `maxDepth`, `maxKeys`, `maxArrayLen`, `maxStringLen`, `maxCallbacks`. Exceeding throws `PayloadLimitError`.
 
 ---
@@ -137,7 +137,7 @@ export function buildFacade(client) {
     dbRef: noStrict(getProxyDb()),
 
     // 4. Events
-    // Client will receive an object with .callback() and .removeCallback() methods
+    // Client will receive a Listen surface: .on(cb), .once(cb), .close()
     events: { listenEvent },
 
     // 5. Method with callback in arguments
@@ -200,20 +200,20 @@ export const Api = createRpcClientHub(
 Api.onConnect((count) => console.log(`Socket connected (attempt ${count})`));
 
 // Initiate connect. Creates socket, all channels automatically start.
-Api.setToken("USER_SECRET_TOKEN");
+await Api.connect("USER_SECRET_TOKEN");
 
 // Disconnect
-// Api.setToken(null);
+// await Api.connect(null);
 ```
 
 ### 3.3 Call Modes
-Access API channel: `Api.facade.mainAPI`. Hub automatically calls `initStrict()`, so schema loads automatically.
+Access API channel: `Api.facade.mainAPI`. Hub initializes all channels, so schema loads automatically.
 
 ```typescript
 const api = Api.facade.mainAPI;
 
 // Wait for schema (REQUIRED before UI render)
-await api.readyStrict();
+await api.ready();
 
 // --- 1. STRICT (Recommended) ---
 // Safe call. Use `?.` since method may be `null` (closed by roles).
@@ -232,17 +232,34 @@ const data = await api.pipe.dbRef.users.find(1).getName();
 api.space.admin.logAction("clicked");
 ```
 
-### 3.4 Client Subscriptions (Listen)
-Hub automatically wraps methods in `createRpcClientAuto`, providing convenient API for events:
-```typescript
-// Subscribe
-api.events.listenEvent.callback((msg) => {
-  console.log("Push from server:", msg);
-});
-
-// Unsubscribe (sends `___STOP` packet to server)
-api.events.listenEvent.removeCallback();
-```
+### 3.4 Client Subscriptions (Listen)
+`createRpcServerAuto` exposes server `UseListen` values as RPC Listen nodes. New code uses `on`/`once` and keeps the returned `off` handle. For TypeScript, project `client.func` to `DeepSocketListen<ServerFacade>`; this mirrors the runtime shape and keeps event argument types.
+```typescript
+import type { DeepSocketListen } from "wenay-common2";
+
+function webListen<T extends object>(client: { func: unknown }) {
+  return client.func as DeepSocketListen<T>;
+}
+
+const events = webListen<MainFacade>(api).events;
+
+// Subscribe
+const off = events.listenEvent.on((msg) => {
+  console.log("Push from server:", msg);
+});
+
+// Unsubscribe. The handle is callable and also thenable.
+off();
+// await off; // waits until the stream ends
+
+// One event, then automatic unsubscribe
+const done = events.listenEvent.once((msg) => {
+  console.log("First push:", msg);
+});
+await done;
+```
+
+Compatibility names `.callback(cb)`, `.removeCallback()`, and `.unsubscribe()` still exist for old clients, but they are not the recommended API.
 
 
 ### 3.5 Request Management and Debug
@@ -253,16 +270,16 @@ const { api, abortAll, schema } = Api.facade.mainAPI;
 
 // --- 1. Monitoring and Debug ---
 api.pending();          // Current number of pending responses (Promises)
-api.callbacks();        // Current number of live callbacks in memory
+api.callbacks();        // Current number of live callback ids in memory
 api.log(true);          // Enable logging of all incoming/outgoing packets to console
 
 // --- 2. Targeted cleanup (inside .api) ---
 api.clearPromises(true); // Reject (cancel) all current requests
 api.clearCallbacks();    // Force clear all callbacks
-api.remove(myFunc);      // Free memory from specific callback (alias: .end)
+api.remove(myFunc);      // Force-release a specific callback id (alias: .end)
 
 // --- 3. Global facade methods ---
-abortAll("User logout"); // Hard reset: reject all promises with RPC_ABORT error + clear all callbacks
+abortAll("User logout"); // Hard reset: reject all promises with RPC_ABORT error + clear all callback ids
 const map = schema();    // Get raw schema tree (MAP) sent by server
 ```
 
@@ -275,26 +292,25 @@ const map = schema();    // Get raw schema tree (MAP) sent by server
 When using events, the client auto-handler (`mode: "smart"`) by default flexibly adapts arguments. If server sends one argument — it comes as a value, if multiple — as an array.
 If you create a client manually without Hub, you can set a strict mode:
 ```typescript
-// "first" — callback always receives only the first argument
-// "all" — callback always receives all arguments
+// "first" — listener always receives only the first argument
+// "all" — listener always receives all arguments
 // "smart" — (default) auto-detection
-const autoApi = createRpcClientAuto(rpc.func, { mode: "first" });
+const autoApi = createRpcClientAuto(api.func, { mode: "first" });
 ```
 
 
-### 4.2 Manual Callback Termination from Server
-If you passed a callback in function arguments, the server can forcibly terminate it and clear memory on the client before the function completes, by sending a special packet:
-```typescript
-import { rpcEndCallback } from "wenay-common2";
-
-async function myMethod(cb: (data: any) => void) {
-  cb("chunk 1");
-  rpcEndCallback(cb); // Sends "___STOP" to client
-  // Client callback is deleted, subsequent cb() calls won't go anywhere
-}
+### 4.2 Manual Callback Termination from Server
+This is a low-level escape hatch for callbacks passed as ordinary function arguments. For Listen subscriptions prefer `off()`/`.once()`.
+```typescript
+import { endCallback } from "wenay-common2";
+
+async function myMethod(cb: (data: any) => void) {
+  cb("chunk 1");
+  endCallback(cb); // Alias: rpcEndCallback. Sends "___STOP" to client.
+  // Client callback id is deleted, subsequent cb() calls won't go anywhere.
+}
 ```
 
-
 ### 4.3 Call / Apply Support on Client
 The client proxy can transparently handle standard JS `call` and `apply` calls. Server correctly normalizes them ("collapses" the path):
 ```typescript
@@ -306,6 +322,4 @@ await api.func.users.create.apply(null, ["Ivan"]);
 
 ### 4.4 Transparent PIPE Request Transit
 For microservice architecture. If your Node server itself is a client of another RPC node (via `pipe`), it can "pass through" the remainder of the pipe chain further using `__executeRemainingPipe`, without waiting for an intermediate response.
-```
-This covers absolutely all library mechanics (Listen modes, `rpcEndCallback`, `call/apply`, `pipe-transit`), while maintaining readability!
-```
+This covers the important RPC mechanics (Listen `on/once/off`, `endCallback`, `call/apply`, `pipe-transit`) while maintaining readability.

package/lib/Common/ObserveAll2/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./reactive2";
+export * from "./store";

package/lib/Common/ObserveAll2/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./reactive2"), exports);
+__exportStar(require("./store"), exports);

package/lib/Common/ObserveAll2/reactive2.d.ts

@@ -6,27 +6,28 @@ export type Opts = {
     eager?: boolean;
 };
 export declare function reactive<T extends object>(root: T, opts?: Opts): T;
+export declare function isReactive(p: any): boolean;
 export declare function onUpdate(p: any, cb: Fn): () => void;
 export declare function flushReactive(p: any): Promise<void>;
 export declare function listenUpdate(p: any): {
-    func: import("../events/Listen").Listener<[]>;
+    func: import("../events/Listen3").Listener<[]>;
     isRun: () => boolean;
     run: () => void;
     close: () => void;
     eventClose: (cb: () => void) => () => void;
     onClose: (cb: () => void) => () => void;
     removeEventClose: (cb: () => void) => void;
-    addListen: (cb: import("../events/Listen").Listener<[]>, { cbClose, key }?: {
-        cbClose?: (() => void) | undefined;
+    on: import("../events/Listen3").ListenOn<[]>;
+    addListen: (cb: import("../events/Listen3").Listener<[]>, opts?: {
+        cbClose?: () => void;
         key?: string | symbol;
     }) => () => void;
-    removeListen: (k: (string | symbol) | import("../events/Listen").Listener<[]> | null) => void;
-    on: import("../events/Listen").ListenOn<[]>;
-    once: (cb: import("../events/Listen").Listener<[]>, opts?: {
+    removeListen: (k: (string | symbol) | import("../events/Listen3").Listener<[]> | null) => void;
+    once: (cb: import("../events/Listen3").Listener<[]>, opts?: {
         key?: string | symbol;
     }) => () => void;
     count: () => number;
-    readonly getAllKeys: ((string | symbol) | import("../events/Listen").Listener<[]>)[];
+    readonly getAllKeys: (string | symbol)[];
 };
 export type Reactive<T extends object> = T;
 export {};

package/lib/Common/ObserveAll2/reactive2.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.reactive = reactive;
+exports.isReactive = isReactive;
 exports.onUpdate = onUpdate;
 exports.flushReactive = flushReactive;
 exports.listenUpdate = listenUpdate;
@@ -213,6 +214,10 @@ function prewalk(node) {
         }
     }
 }
+function isReactive(p) {
+    const node = p && p[NODE];
+    return !!node && node.active;
+}
 function onUpdate(p, cb) {
     const node = p && p[NODE];
     if (!node)

package/lib/Common/ObserveAll2/store.d.ts

@@ -0,0 +1,98 @@
+import { listenUpdate, reactive } from "./reactive2";
+export type StorePath = readonly PropertyKey[];
+export type StoreDrain = "micro" | "immediate" | number | ((flush: () => void) => void);
+export type StoreSubOpts = {
+    current?: boolean;
+    drain?: StoreDrain;
+    key?: string;
+};
+export type StoreCtx<T = any> = {
+    store: Store<any>;
+    node: StoreNode<T>;
+    path: PropertyKey[];
+    pathString: string;
+    exists: boolean;
+};
+export type StoreMask<T> = true | (NonNullable<T> extends object ? {
+    [K in keyof NonNullable<T>]?: StoreMask<NonNullable<T>[K]>;
+} : true);
+export type StorePick<T, M> = M extends true ? T : NonNullable<T> extends object ? M extends object ? {
+    [K in keyof M & keyof NonNullable<T>]: StorePick<NonNullable<T>[K], NonNullable<M[K]>>;
+} : T : T;
+export type StoreNode<T> = StoreNodeApi<T> & (NonNullable<T> extends object ? {
+    readonly [K in keyof NonNullable<T>]-?: StoreNode<NonNullable<T>[K]>;
+} : {});
+export type StoreNodeApi<T> = {
+    readonly path: PropertyKey[];
+    readonly pathString: string;
+    get(): T;
+    has(): boolean;
+    snapshot(): T;
+    set(value: T): void;
+    replace(value: T): void;
+    on(cb: (value: T, ctx: StoreCtx<T>) => void, opts?: StoreSubOpts): () => void;
+    once(cb: (value: T, ctx: StoreCtx<T>) => void, opts?: StoreSubOpts): () => void;
+    update<M extends StoreMask<T>>(mask: M, opts?: StoreSubOpts): StoreSelection<T, M>;
+    at<K extends PropertyKey>(key: K): StoreNode<any>;
+    count(): number;
+};
+export type StoreSelection<T, M> = {
+    readonly mask: M;
+    readonly paths: PropertyKey[][];
+    get(): StorePick<T, M>;
+    on(cb: (value: StorePick<T, M>, ctx: StoreSelectionCtx<T, M>) => void, opts?: StoreSubOpts): () => void;
+    once(cb: (value: StorePick<T, M>, ctx: StoreSelectionCtx<T, M>) => void, opts?: StoreSubOpts): () => void;
+    onEach(cb: (value: any, ctx: StoreCtx<any>) => void, opts?: StoreSubOpts): () => void;
+};
+export type StoreSelectionCtx<T, M> = {
+    store: Store<any>;
+    node: StoreNode<T>;
+    mask: M;
+    paths: PropertyKey[][];
+};
+export type Store<T extends object> = {
+    readonly state: T;
+    readonly node: StoreNode<T>;
+    get(): T;
+    snapshot(): T;
+    replace(value: T): void;
+    on(cb: (value: T, ctx: StoreCtx<T>) => void, opts?: StoreSubOpts): () => void;
+    once(cb: (value: T, ctx: StoreCtx<T>) => void, opts?: StoreSubOpts): () => void;
+    update<M extends StoreMask<T>>(mask: M, opts?: StoreSubOpts): StoreSelection<T, M>;
+    listen(): ReturnType<typeof listenUpdate>;
+    count(): number;
+};
+type RemoteStore<T extends object> = {
+    get(mask?: any): T | Promise<T>;
+    changed: any;
+};
+export declare function createStore<T extends object>(initial: T, opts?: Parameters<typeof reactive<T>>[1]): Store<T>;
+export declare function exposeStore<T extends object>(store: Store<T>): {
+    get: (mask?: StoreMask<T>) => T extends object ? T | { [K in (string | number | symbol) & keyof T]: T[K] | (NonNullable<T[K]> extends object ? T[K] | { [K_2 in (string | number | symbol) & keyof NonNullable<T[K]>]: NonNullable<T[K]>[K_2] | (NonNullable<NonNullable<T[K]>[K_2]> extends object ? NonNullable<T[K]>[K_2] | { [K_3 in (string | number | symbol) & keyof NonNullable<NonNullable<T[K]>[K_2]>]: NonNullable<NonNullable<T[K]>[K_2]>[K_3] | (NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]> extends object ? NonNullable<NonNullable<T[K]>[K_2]>[K_3] | { [K_4 in (string | number | symbol) & keyof NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>]: NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4] | (NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]> extends object ? NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4] | { [K_5 in (string | number | symbol) & keyof NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>]: NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5] | (NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]> extends object ? NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5] | { [K_6 in (string | number | symbol) & keyof NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>]: NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6] | (NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]> extends object ? NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6] | { [K_7 in (string | number | symbol) & keyof NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>]: NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7] | (NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]> extends object ? NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7] | { [K_8 in (string | number | symbol) & keyof NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>]: NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>[K_8] | (NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>[K_8]> extends object ? NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>[K_8] | { [K_9 in (string | number | symbol) & keyof NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>[K_8]>]: NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>[K_8]>[K_9] | (NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>[K_8]>[K_9]> extends object ? NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>[K_8]>[K_9] | { [K_10 in (string | number | symbol) & keyof NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>[K_8]>[K_9]>]: NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>[K_8]>[K_9]>[K_10] | (NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>[K_8]>[K_9]>[K_10]> extends object ? NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>[K_8]>[K_9]>[K_10] | { [K_11 in (string | number | symbol) & keyof NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>[K_8]>[K_9]>[K_10]>]: NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>[K_8]>[K_9]>[K_10]>[K_11] | any; } : NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>[K_8]>[K_9]>[K_10]); } : NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>[K_8]>[K_9]); } : NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]>[K_8]); } : NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]>[K_7]); } : NonNullable<NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]>[K_6]); } : NonNullable<NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]>[K_5]); } : NonNullable<NonNullable<NonNullable<T[K]>[K_2]>[K_3]>[K_4]); } : NonNullable<NonNullable<T[K]>[K_2]>[K_3]); } : NonNullable<T[K]>[K_2]); } : T[K]); } : T;
+    set: (path: StorePath, value: any) => void;
+    replace: (path: StorePath, value: any) => void;
+    changed: {
+        func: import("../events/Listen3").Listener<[]>;
+        isRun: () => boolean;
+        run: () => void;
+        close: () => void;
+        eventClose: (cb: () => void) => () => void;
+        onClose: (cb: () => void) => () => void;
+        removeEventClose: (cb: () => void) => void;
+        on: import("../events/Listen3").ListenOn<[]>;
+        addListen: (cb: import("../events/Listen3").Listener<[]>, opts?: {
+            cbClose?: () => void;
+            key?: string | symbol;
+        }) => () => void;
+        removeListen: (k: (string | symbol) | import("../events/Listen3").Listener<[]> | null) => void;
+        once: (cb: import("../events/Listen3").Listener<[]>, opts?: {
+            key?: string | symbol;
+        }) => () => void;
+        count: () => number;
+        readonly getAllKeys: (string | symbol)[];
+    };
+};
+export declare function createStoreMirror<T extends object>(remote: RemoteStore<T>, initial?: T, opts?: Parameters<typeof createStore<T>>[1]): Store<T> & {
+    sync: <M extends StoreMask<T>>(mask: M, subOpts?: StoreSubOpts) => Promise<() => void>;
+};
+export {};