@lemoncloud/chatic-sockets-lib 0.4.0 → 0.4.1

package/dist/client-socket-v2/auth-controller.d.ts

@@ -82,13 +82,13 @@ export declare class AuthControllerImpl implements AuthController {
     constructor(options: AuthControllerOptions);
     get state(): AuthControllerState;
     get token(): string;
-    /** Register token, authId, and sign callback. Idempotent; resumes when 'expired'. */
+    /** Register token, authId, and sign callback. Idempotent; resumes auth when inactive (after logout or expiry). */
     register: (opts: AuthRegisterOptions) => void;
     /** Resolves once authenticated (immediately if already); rejects if auth expires. */
     ready: () => Promise<void>;
     /** Switch to another site. */
     switch: (target: string, handlers?: AuthSwitchHandlers) => Promise<AuthTokenView>;
-    /** Clear local auth state and stop the scheduler. Best-effort server notify (server-side logout is a stub). */
+    /** Clear local auth state and stop the scheduler. Best-effort server notify (revokes the backend session). */
     logout: () => Promise<void>;
     onAuthState: (listener: (state: AuthControllerState) => void) => (() => void);
     onTokenRefresh: (listener: (view: AuthTokenView) => void) => (() => void);

package/dist/client-socket-v2/auth-controller.js

@@ -34,12 +34,12 @@ class AuthControllerImpl {
         this._token = '';
         this.authId = '';
         this.active = false;
-        /** Register token, authId, and sign callback. Idempotent; resumes when 'expired'. */
+        /** Register token, authId, and sign callback. Idempotent; resumes auth when inactive (after logout or expiry). */
         this.register = (opts) => {
             this._token = opts.token;
             this.authId = opts.authId;
             this.signCallback = opts.sign;
-            if (this._state === 'expired') {
+            if (!this.active) {
                 this.failures = 0;
                 this.active = true;
                 this.setState('pending');
@@ -59,9 +59,9 @@ class AuthControllerImpl {
                         off();
                         resolve();
                     }
-                    else if (s === 'expired') {
+                    else if (s === 'expired' || s === '') {
                         off();
-                        reject(new Error(`401 UNAUTHORIZED - auth expired`));
+                        reject(new Error(`401 UNAUTHORIZED - auth ${s === 'expired' ? 'expired' : 'logged out'}`));
                     }
                 });
             });
@@ -115,14 +115,18 @@ class AuthControllerImpl {
                 this.rearmRefreshTimer();
             }
         });
-        /** Clear local auth state and stop the scheduler. Best-effort server notify (server-side logout is a stub). */
+        /** Clear local auth state and stop the scheduler. Best-effort server notify (revokes the backend session). */
         this.logout = () => __awaiter(this, void 0, void 0, function* () {
-            yield this.gateway.logout({}).catch(() => undefined);
+            /** bump epoch so a late in-flight refresh/switch/reauth response can't resurrect auth after logout */
+            this.epoch++;
             this.stop();
             this._token = '';
             this.authId = '';
             this.signCallback = undefined;
             this.setState('');
+            if (this.options.client.state === 'connected') {
+                yield this.gateway.logout({}).catch(() => undefined);
+            }
         });
         this.onAuthState = (listener) => {
             this.stateListeners.add(listener);

package/dist/client-socket-v2/plans/channel-sync-plan.d.ts

@@ -24,6 +24,7 @@ export interface ChannelSyncPlanOptions<TView extends SyncableView = SyncableVie
 export declare class ChannelSyncPlan<TView extends SyncableView = SyncableView> implements DomainSyncPlan<ChannelSyncTarget> {
     private readonly options;
     readonly domain = "channel";
+    readonly requiresAuth = true;
     readonly idleBackoff: SyncBackoffOptions;
     constructor(options?: ChannelSyncPlanOptions<TView>);
     supports: (target: SyncTargetDescriptor) => target is ChannelSyncTarget;

package/dist/client-socket-v2/plans/channel-sync-plan.js

@@ -20,6 +20,7 @@ class ChannelSyncPlan {
         var _a;
         this.options = options;
         this.domain = 'channel';
+        this.requiresAuth = true;
         this.supports = (target) => (target === null || target === void 0 ? void 0 : target.type) === 'channel';
         this.getKey = (target) => { var _a; return `channel:${(_a = target === null || target === void 0 ? void 0 : target.id) !== null && _a !== void 0 ? _a : ''}`; };
         this.getIntervalMs = (target) => { var _a, _b; return (_b = (_a = target.intervalMs) !== null && _a !== void 0 ? _a : this.options.intervalMs) !== null && _b !== void 0 ? _b : 2000; };

package/dist/client-socket-v2/plans/chat-sync-plan.d.ts

@@ -41,6 +41,7 @@ export interface ChatSyncPlanOptions<TMessage extends ChatMessageLike = ChatMess
 export declare class ChatSyncPlan<TMessage extends ChatMessageLike = ChatMessageLike> implements DomainSyncPlan<ChatSyncTarget> {
     private readonly options;
     readonly domain = "chat";
+    readonly requiresAuth = true;
     readonly idleBackoff: SyncBackoffOptions;
     private readonly chains;
     constructor(options?: ChatSyncPlanOptions<TMessage>);

package/dist/client-socket-v2/plans/chat-sync-plan.js

@@ -22,6 +22,7 @@ class ChatSyncPlan {
         var _a;
         this.options = options;
         this.domain = 'chat';
+        this.requiresAuth = true;
         this.chains = new Map();
         this.supports = (target) => (target === null || target === void 0 ? void 0 : target.type) === 'chat';
         this.getKey = (target) => { var _a; return `chat:${(_a = target === null || target === void 0 ? void 0 : target.id) !== null && _a !== void 0 ? _a : ''}`; };

package/dist/client-socket-v2/plans/device-sync-plan.d.ts

@@ -21,6 +21,7 @@ export interface DeviceSyncPlanOptions {
 export declare class DeviceSyncPlan implements DomainSyncPlan<DeviceSyncTarget> {
     private readonly options;
     readonly domain = "device";
+    readonly requiresAuth = false;
     readonly failurePolicy: SyncFailurePolicy;
     readonly idleBackoff: SyncBackoffOptions;
     constructor(options?: DeviceSyncPlanOptions);

package/dist/client-socket-v2/plans/device-sync-plan.js

@@ -15,6 +15,7 @@ class DeviceSyncPlan {
         var _a, _b;
         this.options = options;
         this.domain = 'device';
+        this.requiresAuth = false;
         this.supports = (target) => (target === null || target === void 0 ? void 0 : target.type) === 'device';
         this.getKey = (target) => { var _a; return `device:${(_a = target === null || target === void 0 ? void 0 : target.id) !== null && _a !== void 0 ? _a : 'current'}`; };
         this.getIntervalMs = (target) => { var _a, _b; return (_b = (_a = target.intervalMs) !== null && _a !== void 0 ? _a : this.options.intervalMs) !== null && _b !== void 0 ? _b : 2000; };

package/dist/client-socket-v2/plans/join-sync-plan.d.ts

@@ -24,6 +24,7 @@ export interface JoinSyncPlanOptions<TView extends SyncableView = SyncableView>
 export declare class JoinSyncPlan<TView extends SyncableView = SyncableView> implements DomainSyncPlan<JoinSyncTarget> {
     private readonly options;
     readonly domain = "join";
+    readonly requiresAuth = true;
     readonly idleBackoff: SyncBackoffOptions;
     constructor(options?: JoinSyncPlanOptions<TView>);
     supports: (target: SyncTargetDescriptor) => target is JoinSyncTarget;

package/dist/client-socket-v2/plans/join-sync-plan.js

@@ -20,6 +20,7 @@ class JoinSyncPlan {
         var _a;
         this.options = options;
         this.domain = 'join';
+        this.requiresAuth = true;
         this.supports = (target) => (target === null || target === void 0 ? void 0 : target.type) === 'join';
         this.getKey = (target) => { var _a; return `join:${(_a = target === null || target === void 0 ? void 0 : target.id) !== null && _a !== void 0 ? _a : ''}`; };
         // Default poll interval (10s); the scheduler backs this off x2 up to 60s while idle.

package/dist/client-socket-v2/plans/place-sync-plan.d.ts

@@ -24,6 +24,7 @@ export interface PlaceSyncPlanOptions<TView extends SyncableView = SyncableView>
 export declare class PlaceSyncPlan<TView extends SyncableView = SyncableView> implements DomainSyncPlan<PlaceSyncTarget> {
     private readonly options;
     readonly domain = "place";
+    readonly requiresAuth = true;
     readonly idleBackoff: SyncBackoffOptions;
     constructor(options?: PlaceSyncPlanOptions<TView>);
     supports: (target: SyncTargetDescriptor) => target is PlaceSyncTarget;

package/dist/client-socket-v2/plans/place-sync-plan.js

@@ -20,6 +20,7 @@ class PlaceSyncPlan {
         var _a;
         this.options = options;
         this.domain = 'place';
+        this.requiresAuth = true;
         this.supports = (target) => (target === null || target === void 0 ? void 0 : target.type) === 'place';
         this.getKey = (target) => { var _a; return `place:${(_a = target === null || target === void 0 ? void 0 : target.id) !== null && _a !== void 0 ? _a : ''}`; };
         this.getIntervalMs = (target) => { var _a, _b; return (_b = (_a = target.intervalMs) !== null && _a !== void 0 ? _a : this.options.intervalMs) !== null && _b !== void 0 ? _b : 2000; };

package/dist/client-socket-v2/plans/profile-sync-plan.d.ts

@@ -24,6 +24,7 @@ export interface ProfileSyncPlanOptions<TView extends SyncableView = SyncableVie
 export declare class ProfileSyncPlan<TView extends SyncableView = SyncableView> implements DomainSyncPlan<ProfileSyncTarget> {
     private readonly options;
     readonly domain = "profile";
+    readonly requiresAuth = true;
     readonly idleBackoff: SyncBackoffOptions;
     constructor(options?: ProfileSyncPlanOptions<TView>);
     supports: (target: SyncTargetDescriptor) => target is ProfileSyncTarget;

package/dist/client-socket-v2/plans/profile-sync-plan.js

@@ -20,6 +20,7 @@ class ProfileSyncPlan {
         var _a;
         this.options = options;
         this.domain = 'profile';
+        this.requiresAuth = true;
         this.supports = (target) => (target === null || target === void 0 ? void 0 : target.type) === 'profile';
         this.getKey = (target) => { var _a; return `profile:${(_a = target === null || target === void 0 ? void 0 : target.id) !== null && _a !== void 0 ? _a : ''}`; };
         this.getIntervalMs = (target) => { var _a, _b; return (_b = (_a = target.intervalMs) !== null && _a !== void 0 ? _a : this.options.intervalMs) !== null && _b !== void 0 ? _b : 2000; };

package/dist/client-socket-v2/sync-scheduler.d.ts

@@ -27,6 +27,7 @@ export declare class DomainSyncScheduler implements SyncScheduler {
     private readonly random;
     private readonly unsubs;
     constructor(options: SyncSchedulerOptions);
+    private isEntryAuthReady;
     start: (target: SyncTargetDescriptor) => void;
     stop: (target: SyncTargetDescriptor) => void;
     stopAll: () => void;
@@ -36,7 +37,11 @@ export declare class DomainSyncScheduler implements SyncScheduler {
     private resolvePlan;
     private findEntry;
     private buildContext;
+    /** run the connect-time hook (may poll the server, e.g. chat catch-up) then fresh-start the poll loop. */
+    private activateEntry;
     private handleConnected;
+    private resumeAuthGated;
+    private pauseAuthGated;
     private stopAllTimers;
     private clearTimer;
     private scheduleNow;

package/dist/client-socket-v2/sync-scheduler.js

@@ -24,6 +24,12 @@ class DomainSyncScheduler {
         this.targets = new Map();
         this.snapshots = new Map();
         this.unsubs = [];
+        this.isEntryAuthReady = (entry) => {
+            if (!entry.plan.requiresAuth)
+                return true;
+            const auth = this.options.client.auth;
+            return !!auth && auth.state === 'authenticated';
+        };
         this.start = (target) => {
             const plan = this.resolvePlan(target);
             const key = plan.getKey(target);
@@ -32,8 +38,9 @@ class DomainSyncScheduler {
                 entry.target = Object.assign(Object.assign({}, entry.target), target);
                 return;
             }
-            this.targets.set(key, { target, plan });
-            if (this.options.client.state === 'connected')
+            const created = { target, plan };
+            this.targets.set(key, created);
+            if (this.options.client.state === 'connected' && this.isEntryAuthReady(created))
                 this.scheduleNow(key);
         };
         this.stop = (target) => {
@@ -104,18 +111,40 @@ class DomainSyncScheduler {
             }),
             stop: target => this.stop(target),
         });
-        this.handleConnected = () => __awaiter(this, void 0, void 0, function* () {
+        /** run the connect-time hook (may poll the server, e.g. chat catch-up) then fresh-start the poll loop. */
+        this.activateEntry = (key, entry, ctx) => __awaiter(this, void 0, void 0, function* () {
             var _k, _l;
+            yield ((_l = (_k = entry.plan).onConnected) === null || _l === void 0 ? void 0 : _l.call(_k, entry.target, ctx));
+            entry.failures = 0;
+            entry.goneStreak = 0;
+            entry.idleStreak = 0;
+            this.scheduleNow(key);
+        });
+        this.handleConnected = () => __awaiter(this, void 0, void 0, function* () {
             const ctx = this.buildContext();
             for (const [key, entry] of this.targets.entries()) {
-                // reconnect = fresh start
-                entry.failures = 0;
-                entry.goneStreak = 0;
-                entry.idleStreak = 0;
-                yield ((_l = (_k = entry.plan).onConnected) === null || _l === void 0 ? void 0 : _l.call(_k, entry.target, ctx));
-                this.scheduleNow(key);
+                // gated (requiresAuth) entries activate on `authenticated` instead — see resumeAuthGated.
+                // onConnected itself may poll the server (chat catch-up), so it must be gated too, not just run().
+                if (!this.isEntryAuthReady(entry))
+                    continue;
+                yield this.activateEntry(key, entry, ctx);
             }
         });
+        this.resumeAuthGated = () => __awaiter(this, void 0, void 0, function* () {
+            if (this.options.client.state !== 'connected')
+                return;
+            const ctx = this.buildContext();
+            for (const [key, entry] of this.targets.entries()) {
+                if (entry.plan.requiresAuth)
+                    yield this.activateEntry(key, entry, ctx);
+            }
+        });
+        this.pauseAuthGated = () => {
+            this.targets.forEach(entry => {
+                if (entry.plan.requiresAuth)
+                    this.clearTimer(entry);
+            });
+        };
         this.stopAllTimers = () => {
             this.targets.forEach(entry => this.clearTimer(entry));
         };
@@ -143,7 +172,7 @@ class DomainSyncScheduler {
             if (!entry)
                 return;
             this.clearTimer(entry);
-            if (this.options.client.state !== 'connected')
+            if (this.options.client.state !== 'connected' || !this.isEntryAuthReady(entry))
                 return;
             const baseMs = (_d = (_a = entry.target.intervalMs) !== null && _a !== void 0 ? _a : (_c = (_b = entry.plan).getIntervalMs) === null || _c === void 0 ? void 0 : _c.call(_b, entry.target)) !== null && _d !== void 0 ? _d : 5000;
             const intervalMs = this.computeInterval(entry, baseMs);
@@ -170,7 +199,7 @@ class DomainSyncScheduler {
         this.toTimerKey = (key) => `${this.timerPrefix}${key}`;
         this.runEntry = (key) => __awaiter(this, void 0, void 0, function* () {
             const entry = this.targets.get(key);
-            if (!entry || this.options.client.state !== 'connected')
+            if (!entry || this.options.client.state !== 'connected' || !this.isEntryAuthReady(entry))
                 return;
             if (entry.inFlight)
                 return;
@@ -236,6 +265,8 @@ class DomainSyncScheduler {
                     return;
                 if (!type.startsWith(`${entry.target.type}.`))
                     return;
+                if (!this.isEntryAuthReady(entry))
+                    return;
                 // nudge resets idle backoff (best-effort)
                 entry.idleStreak = 0;
                 yield entry.plan.onTrigger(entry.target, message, ctx).catch(() => undefined);
@@ -261,6 +292,15 @@ class DomainSyncScheduler {
         this.unsubs.push(options.client.onMessage(({ message }) => {
             void this.handleTrigger(message);
         }));
+        const auth = options.client.auth;
+        if (auth) {
+            this.unsubs.push(auth.onAuthState(state => {
+                if (state === 'authenticated')
+                    void this.resumeAuthGated();
+                else
+                    this.pauseAuthGated();
+            }));
+        }
     }
 }
 exports.DomainSyncScheduler = DomainSyncScheduler;

package/dist/client-socket-v2/types.d.ts

@@ -166,6 +166,7 @@ export interface DomainSyncContext {
 }
 export interface DomainSyncPlan<TTarget extends SyncTargetDescriptor = SyncTargetDescriptor> {
     readonly domain: string;
+    readonly requiresAuth?: boolean;
     readonly failurePolicy?: SyncFailurePolicy;
     readonly idleBackoff?: SyncBackoffOptions;
     supports(target: SyncTargetDescriptor): target is TTarget;

package/dist/lib/auth/contracts.d.ts

@@ -52,3 +52,14 @@ export interface AuthTokenView {
     /** cloud id */
     cloudId?: string;
 }
+/** client-safe view of the logout result (curated from backend `UserLogoutResult`). */
+export interface AuthLogoutView {
+    /** logged-out user id */
+    id?: string;
+    /** revoked auth-id */
+    authId?: string;
+    /** revoke flag (1 when revoked) */
+    revoked?: number;
+    /** revoke completion time (epoch ms) */
+    revokedAt?: number;
+}

package/dist/lib/auth/types.d.ts

@@ -32,6 +32,8 @@ export interface AuthSwitchRequestData extends AuthRefreshRequestData {
 export interface AuthLogoutRequestData {
     /** (internal) auth-id */
     authId?: string;
+    /** (internal) userAgent the signature */
+    userAgent?: string;
 }
 declare module '../types' {
     interface SocketPacketRegistry {
@@ -52,7 +54,7 @@ declare module '../types' {
         };
         'auth.logout': {
             request: AuthLogoutRequestData;
-            response: never;
+            response: unknown;
             error: null;
         };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lemoncloud/chatic-sockets-lib",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Client websocket transport and sync runtime for chatic sockets v2",
   "main": "dist/client-socket-v2/index.js",
   "types": "dist/client-socket-v2/index.d.ts",