@lemoncloud/chatic-sockets-lib 0.2.1 → 0.3.0

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

@@ -1,10 +1,16 @@
-import type { ClientSocketV2, DomainSyncPlan, SharedTimerScheduler, SyncScheduler, SyncTargetDescriptor } from './types';
+import type { ClientSocketV2, DomainSyncPlan, SharedTimerScheduler, SyncBackoffOptions, SyncFailurePolicy, SyncScheduler, SyncTargetDescriptor } from './types';
+export type { SyncBackoffOptions } from './types';
 export interface SyncSchedulerOptions {
     client: ClientSocketV2;
     plans: DomainSyncPlan<any>[];
     now?: () => number;
     timerScheduler?: SharedTimerScheduler;
     timerPrefix?: string;
+    backoff?: SyncBackoffOptions;
+    idleBackoff?: SyncBackoffOptions;
+    failurePolicy?: SyncFailurePolicy;
+    jitterRatio?: number;
+    random?: () => number;
 }
 export declare class DomainSyncScheduler implements SyncScheduler {
     private readonly options;
@@ -14,6 +20,11 @@ export declare class DomainSyncScheduler implements SyncScheduler {
     private readonly now;
     private readonly timerScheduler?;
     private readonly timerPrefix;
+    private readonly backoff;
+    private readonly idleBackoff?;
+    private readonly failurePolicy;
+    private readonly jitterRatio;
+    private readonly random;
     private readonly unsubs;
     constructor(options: SyncSchedulerOptions);
     start: (target: SyncTargetDescriptor) => void;
@@ -30,7 +41,10 @@ export declare class DomainSyncScheduler implements SyncScheduler {
     private clearTimer;
     private scheduleNow;
     private scheduleNext;
+    private computeInterval;
+    private jitter;
     private toTimerKey;
     private runEntry;
+    private handleRunFailure;
     private handleTrigger;
 }

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

@@ -10,9 +10,16 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DomainSyncScheduler = void 0;
+const defaultClassify = (error) => {
+    var _a;
+    const msg = error instanceof Error ? error.message : `${error !== null && error !== void 0 ? error : ''}`;
+    const code = (_a = /^\s*(\d{3})\b/.exec(msg)) === null || _a === void 0 ? void 0 : _a[1];
+    return code === '403' || code === '404' ? 'gone' : 'transient';
+};
+const DEFAULT_IDLE_BACKOFF = { factor: 2, maxMs: 60000 };
 class DomainSyncScheduler {
     constructor(options) {
-        var _a, _b;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
         this.options = options;
         this.targets = new Map();
         this.snapshots = new Map();
@@ -95,12 +102,17 @@ class DomainSyncScheduler {
                 const key = entry ? entry.plan.getKey(entry.target) : this.resolvePlan(target).getKey(target);
                 yield this.runEntry(key);
             }),
+            stop: target => this.stop(target),
         });
         this.handleConnected = () => __awaiter(this, void 0, void 0, function* () {
-            var _c, _d;
+            var _k, _l;
             const ctx = this.buildContext();
             for (const [key, entry] of this.targets.entries()) {
-                yield ((_d = (_c = entry.plan).onConnected) === null || _d === void 0 ? void 0 : _d.call(_c, entry.target, ctx));
+                // 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);
             }
         });
@@ -133,13 +145,28 @@ class DomainSyncScheduler {
             this.clearTimer(entry);
             if (this.options.client.state !== 'connected')
                 return;
-            const intervalMs = (_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 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);
             if (this.timerScheduler) {
                 this.timerScheduler.schedule(this.toTimerKey(key), intervalMs, () => this.runEntry(key));
                 return;
             }
             entry.timer = setTimeout(() => void this.runEntry(key), intervalMs);
         };
+        this.computeInterval = (entry, baseMs) => {
+            var _a, _b, _c, _d, _e, _f;
+            const failures = (_a = entry.failures) !== null && _a !== void 0 ? _a : 0;
+            if (failures > 0)
+                return this.jitter(Math.min(baseMs * Math.pow(this.backoff.factor, failures), this.backoff.maxMs));
+            const idle = (_c = (_b = entry.plan.idleBackoff) !== null && _b !== void 0 ? _b : this.idleBackoff) !== null && _c !== void 0 ? _c : DEFAULT_IDLE_BACKOFF;
+            const idleFactor = Math.max(1, (_d = idle === null || idle === void 0 ? void 0 : idle.factor) !== null && _d !== void 0 ? _d : 1);
+            const idleStreak = (_e = entry.idleStreak) !== null && _e !== void 0 ? _e : 0;
+            if (idleFactor > 1 && idleStreak > 0) {
+                return this.jitter(Math.min(baseMs * Math.pow(idleFactor, idleStreak), (_f = idle === null || idle === void 0 ? void 0 : idle.maxMs) !== null && _f !== void 0 ? _f : 60000));
+            }
+            return baseMs;
+        };
+        this.jitter = (ms) => this.jitterRatio > 0 ? Math.max(0, Math.round(ms * (1 + (this.random() * 2 - 1) * this.jitterRatio))) : ms;
         this.toTimerKey = (key) => `${this.timerPrefix}${key}`;
         this.runEntry = (key) => __awaiter(this, void 0, void 0, function* () {
             const entry = this.targets.get(key);
@@ -148,33 +175,83 @@ class DomainSyncScheduler {
             if (entry.inFlight)
                 return;
             const ctx = this.buildContext();
-            entry.inFlight = Promise.resolve(entry.plan.run(entry.target, ctx))
-                .catch(() => undefined)
-                .then(() => {
+            // no snapshot write during run = unchanged = idle
+            const before = this.snapshots.get(key);
+            entry.inFlight = Promise.resolve(entry.plan.run(entry.target, ctx)).then(() => {
+                var _a;
                 entry.inFlight = undefined;
+                entry.failures = 0;
+                entry.goneStreak = 0;
+                const changed = this.snapshots.get(key) !== before;
+                entry.idleStreak = changed ? 0 : ((_a = entry.idleStreak) !== null && _a !== void 0 ? _a : 0) + 1;
                 this.scheduleNext(key);
+            }, error => {
+                entry.inFlight = undefined;
+                this.handleRunFailure(key, error, ctx);
             });
             yield entry.inFlight;
         });
+        this.handleRunFailure = (key, error, ctx) => {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+            const entry = this.targets.get(key);
+            if (!entry)
+                return;
+            const plan = (_a = entry.plan.failurePolicy) !== null && _a !== void 0 ? _a : {};
+            const sched = this.failurePolicy;
+            const classify = (_c = (_b = plan.classify) !== null && _b !== void 0 ? _b : sched.classify) !== null && _c !== void 0 ? _c : defaultClassify;
+            const stopAfter = (_e = (_d = plan.stopAfter) !== null && _d !== void 0 ? _d : sched.stopAfter) !== null && _e !== void 0 ? _e : 2;
+            const decide = (_g = (_f = plan.decide) !== null && _f !== void 0 ? _f : sched.decide) !== null && _g !== void 0 ? _g : ((info) => (info.kind === 'gone' && info.goneStreak >= stopAfter ? 'stop' : 'retry'));
+            const kind = classify(error, entry.target);
+            entry.failures = ((_h = entry.failures) !== null && _h !== void 0 ? _h : 0) + 1;
+            entry.goneStreak = kind === 'gone' ? ((_j = entry.goneStreak) !== null && _j !== void 0 ? _j : 0) + 1 : 0;
+            entry.idleStreak = 0;
+            const info = {
+                target: Object.assign({}, entry.target),
+                error,
+                kind,
+                failures: entry.failures,
+                goneStreak: entry.goneStreak,
+            };
+            const decision = decide(info);
+            if (decision === 'stop') {
+                (_l = (_k = entry.plan).onStopped) === null || _l === void 0 ? void 0 : _l.call(_k, entry.target, info, ctx);
+                this.stop(entry.target);
+                return;
+            }
+            if (decision === 'keep') {
+                entry.failures = 0;
+                entry.goneStreak = 0;
+            }
+            this.scheduleNext(key);
+        };
         this.handleTrigger = (message) => __awaiter(this, void 0, void 0, function* () {
-            var _e;
-            const type = `${(_e = message === null || message === void 0 ? void 0 : message.type) !== null && _e !== void 0 ? _e : ''}`;
+            var _m;
+            const type = `${(_m = message === null || message === void 0 ? void 0 : message.type) !== null && _m !== void 0 ? _m : ''}`;
             if (!type.endsWith('.sync'))
                 return;
-            const targets = [...this.targets.values()];
+            const entries = [...this.targets.entries()];
             const ctx = this.buildContext();
-            yield Promise.all(targets.map((entry) => __awaiter(this, void 0, void 0, function* () {
+            yield Promise.all(entries.map(([key, entry]) => __awaiter(this, void 0, void 0, function* () {
                 if (!entry.plan.onTrigger)
                     return;
                 if (!type.startsWith(`${entry.target.type}.`))
                     return;
-                yield entry.plan.onTrigger(entry.target, message, ctx);
+                // nudge resets idle backoff (best-effort)
+                entry.idleStreak = 0;
+                yield entry.plan.onTrigger(entry.target, message, ctx).catch(() => undefined);
+                if (!entry.inFlight)
+                    this.scheduleNext(key);
             })));
         });
         this.plans = [...(options.plans || [])];
         this.now = (_a = options.now) !== null && _a !== void 0 ? _a : (() => Date.now());
         this.timerScheduler = options.timerScheduler;
         this.timerPrefix = (_b = options.timerPrefix) !== null && _b !== void 0 ? _b : 'sync:';
+        this.backoff = { factor: Math.max(1, (_d = (_c = options.backoff) === null || _c === void 0 ? void 0 : _c.factor) !== null && _d !== void 0 ? _d : 2), maxMs: (_f = (_e = options.backoff) === null || _e === void 0 ? void 0 : _e.maxMs) !== null && _f !== void 0 ? _f : 30000 };
+        this.idleBackoff = options.idleBackoff;
+        this.failurePolicy = (_g = options.failurePolicy) !== null && _g !== void 0 ? _g : {};
+        this.jitterRatio = Math.max(0, (_h = options.jitterRatio) !== null && _h !== void 0 ? _h : 0.1);
+        this.random = (_j = options.random) !== null && _j !== void 0 ? _j : Math.random;
         this.unsubs.push(options.client.onState(event => {
             if (event.next === 'connected')
                 void this.handleConnected();

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

@@ -123,21 +123,43 @@ export interface SyncTargetDescriptor {
     intervalMs?: number;
     meta?: Record<string, unknown>;
 }
+export declare type SyncFailureKind = 'gone' | 'transient';
+export declare type SyncFailureDecision = 'stop' | 'keep' | 'retry';
+export interface SyncFailureInfo {
+    target: SyncTargetDescriptor;
+    error: unknown;
+    kind: SyncFailureKind;
+    failures: number;
+    goneStreak: number;
+}
+export interface SyncFailurePolicy {
+    classify?(error: unknown, target: SyncTargetDescriptor): SyncFailureKind;
+    decide?(info: SyncFailureInfo): SyncFailureDecision;
+    stopAfter?: number;
+}
+export interface SyncBackoffOptions {
+    factor?: number;
+    maxMs?: number;
+}
 export interface DomainSyncContext {
     client: ClientSocketV2;
     now(): number;
     readSnapshot<T = unknown>(target: SyncTargetDescriptor): T | undefined;
     writeSnapshot<T = unknown>(target: SyncTargetDescriptor, snapshot: T | undefined): void;
     requestResync(target: SyncTargetDescriptor): Promise<void>;
+    stop(target: SyncTargetDescriptor): void;
 }
 export interface DomainSyncPlan<TTarget extends SyncTargetDescriptor = SyncTargetDescriptor> {
     readonly domain: string;
+    readonly failurePolicy?: SyncFailurePolicy;
+    readonly idleBackoff?: SyncBackoffOptions;
     supports(target: SyncTargetDescriptor): target is TTarget;
     getKey(target: TTarget): string;
     getIntervalMs?(target: TTarget): number;
     onConnected?(target: TTarget, ctx: DomainSyncContext): Promise<void> | void;
     run(target: TTarget, ctx: DomainSyncContext): Promise<void>;
     onTrigger?(target: TTarget, message: SocketMessage<any>, ctx: DomainSyncContext): Promise<void>;
+    onStopped?(target: TTarget, info: SyncFailureInfo, ctx: DomainSyncContext): void;
     updateLocalState?(target: TTarget, snapshot: unknown, ctx: DomainSyncContext): void;
 }
 export interface SyncScheduler {

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

@@ -1,5 +1,6 @@
 import type { InferSocketRequest, SocketRequestMessage } from '../types';
 import type { ChannelStereo } from '../../modules/chat/types';
+import type { ChannelView } from '../../modules/chat/views';
 export interface ChannelCreateRequestData {
     stereo: ChannelStereo;
     name?: string;
@@ -42,6 +43,9 @@ export interface ChannelUpdateJoinRequestData {
 export interface ChannelSyncRequestData {
     since?: number;
 }
+export interface ChannelGetRequestData {
+    id?: string;
+}
 export interface ChannelSyncUsersRequestData {
     channelId: string;
     since?: number;
@@ -50,7 +54,22 @@ declare module '../types' {
     interface SocketPacketRegistry {
         'channel.create': {
             request: ChannelCreateRequestData;
-            response: unknown;
+            response: ChannelView;
+            error: null;
+        };
+        'channel.get': {
+            request: ChannelGetRequestData;
+            response: ChannelView;
+            error: null;
+        };
+        'channel.update': {
+            request: ChannelUpdateRequestData;
+            response: ChannelView;
+            error: null;
+        };
+        'channel.delete': {
+            request: ChannelByIdRequestData;
+            response: ChannelView;
             error: null;
         };
         'channel.join': {
@@ -83,21 +102,11 @@ declare module '../types' {
             response: unknown;
             error: null;
         };
-        'channel.update': {
-            request: ChannelUpdateRequestData;
-            response: unknown;
-            error: null;
-        };
         'channel.update-join': {
             request: ChannelUpdateJoinRequestData;
             response: unknown;
             error: null;
         };
-        'channel.delete': {
-            request: ChannelByIdRequestData;
-            response: unknown;
-            error: null;
-        };
         'channel.sync': {
             request: ChannelSyncRequestData;
             response: unknown;
@@ -155,12 +164,19 @@ export declare type ChannelDeleteRequestMessage = SocketRequestMessage<ChannelDe
 export declare type ChannelSyncType = 'channel.sync';
 export declare type ChannelSyncInput = InferSocketRequest<ChannelSyncType>;
 export declare type ChannelSyncRequestMessage = SocketRequestMessage<ChannelSyncType>;
+export declare type ChannelGetType = 'channel.get';
+export declare type ChannelGetInput = InferSocketRequest<ChannelGetType>;
+export declare type ChannelGetRequestMessage = SocketRequestMessage<ChannelGetType>;
 export declare type ChannelSyncUsersType = 'channel.sync-users';
 export declare type ChannelSyncUsersInput = InferSocketRequest<ChannelSyncUsersType>;
 export declare type ChannelSyncUsersRequestMessage = SocketRequestMessage<ChannelSyncUsersType>;
+/** @deprecated use `profile.sync` (ProfileSyncInput). 하위호환용. */
 export declare type ChannelSyncProfileType = 'channel.sync-site-profile';
+/** @deprecated use `profile.sync` (ProfileSyncInput). 하위호환용. */
 export declare type ChannelSyncProfileInput = InferSocketRequest<ChannelSyncProfileType>;
+/** @deprecated use `profile.sync` (ProfileSyncInput). 하위호환용. */
 export declare type ChannelSyncSiteProfileInput = ChannelSyncProfileInput;
+/** @deprecated use `profile.sync`. 하위호환용. */
 export declare type ChannelSyncProfileRequestMessage = SocketRequestMessage<ChannelSyncProfileType>;
 export declare type ChannelUnreadsType = 'channel.unreads';
 export declare type ChannelUnreadsInput = InferSocketRequest<ChannelUnreadsType>;

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

@@ -1,18 +1,54 @@
 import type { InferSocketRequest, SocketRequestMessage } from '../types';
-export interface CloudUpdateRequestData {
-    cloudId?: string;
+/** cloud 공통 body 필드 — create/update 양쪽에서 동일하게 사용 */
+export interface CloudBodyData {
     name?: string;
 }
+export declare type CloudCreateRequestData = CloudBodyData;
+export interface CloudGetRequestData {
+    id: string;
+}
+export interface CloudUpdateRequestData extends CloudBodyData {
+    id?: string;
+    /** @deprecated use `id` instead. 하위호환용으로만 유지. */
+    cloudId?: string;
+}
+export interface CloudDeleteRequestData {
+    id: string;
+}
 declare module '../types' {
     interface SocketPacketRegistry {
+        'cloud.create': {
+            request: CloudCreateRequestData;
+            response: unknown;
+            error: null;
+        };
+        'cloud.get': {
+            request: CloudGetRequestData;
+            response: unknown;
+            error: null;
+        };
         'cloud.update': {
             request: CloudUpdateRequestData;
             response: unknown;
             error: null;
         };
+        'cloud.delete': {
+            request: CloudDeleteRequestData;
+            response: unknown;
+            error: null;
+        };
     }
 }
+export declare type CloudCreateType = 'cloud.create';
+export declare type CloudCreateInput = InferSocketRequest<CloudCreateType>;
+export declare type CloudCreateRequestMessage = SocketRequestMessage<CloudCreateType>;
+export declare type CloudGetType = 'cloud.get';
+export declare type CloudGetInput = InferSocketRequest<CloudGetType>;
+export declare type CloudGetRequestMessage = SocketRequestMessage<CloudGetType>;
 export declare type CloudUpdateType = 'cloud.update';
 export declare type CloudUpdateInput = InferSocketRequest<CloudUpdateType>;
 export declare type UpdateCloudInput = CloudUpdateInput;
 export declare type CloudUpdateRequestMessage = SocketRequestMessage<CloudUpdateType>;
+export declare type CloudDeleteType = 'cloud.delete';
+export declare type CloudDeleteInput = InferSocketRequest<CloudDeleteType>;
+export declare type CloudDeleteRequestMessage = SocketRequestMessage<CloudDeleteType>;

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

@@ -20,6 +20,8 @@ export interface DeviceView {
     connectedAt?: number;
     disconnectedAt?: number;
     connId?: string;
+    currChannelId?: string;
+    viewingSince?: number;
 }
 /**
  * mutable device body accepted by `device.save`.

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

@@ -0,0 +1,53 @@
+import type { InferSocketRequest, SocketRequestMessage } from '../types';
+/** place(site) 공통 body 필드 — create/update 양쪽에서 동일하게 사용 */
+export interface PlaceBodyData {
+    name?: string;
+    stereo?: string;
+    thumbnail?: string;
+}
+export declare type PlaceCreateRequestData = PlaceBodyData;
+export interface PlaceGetRequestData {
+    id: string;
+}
+export interface PlaceUpdateRequestData extends PlaceBodyData {
+    id?: string;
+}
+export interface PlaceDeleteRequestData {
+    id: string;
+}
+declare module '../types' {
+    interface SocketPacketRegistry {
+        'place.create': {
+            request: PlaceCreateRequestData;
+            response: unknown;
+            error: null;
+        };
+        'place.get': {
+            request: PlaceGetRequestData;
+            response: unknown;
+            error: null;
+        };
+        'place.update': {
+            request: PlaceUpdateRequestData;
+            response: unknown;
+            error: null;
+        };
+        'place.delete': {
+            request: PlaceDeleteRequestData;
+            response: unknown;
+            error: null;
+        };
+    }
+}
+export declare type PlaceCreateType = 'place.create';
+export declare type PlaceCreateInput = InferSocketRequest<PlaceCreateType>;
+export declare type PlaceCreateRequestMessage = SocketRequestMessage<PlaceCreateType>;
+export declare type PlaceGetType = 'place.get';
+export declare type PlaceGetInput = InferSocketRequest<PlaceGetType>;
+export declare type PlaceGetRequestMessage = SocketRequestMessage<PlaceGetType>;
+export declare type PlaceUpdateType = 'place.update';
+export declare type PlaceUpdateInput = InferSocketRequest<PlaceUpdateType>;
+export declare type PlaceUpdateRequestMessage = SocketRequestMessage<PlaceUpdateType>;
+export declare type PlaceDeleteType = 'place.delete';
+export declare type PlaceDeleteInput = InferSocketRequest<PlaceDeleteType>;
+export declare type PlaceDeleteRequestMessage = SocketRequestMessage<PlaceDeleteType>;

package/dist/lib/place/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,55 @@
+import type { InferSocketRequest, SocketRequestMessage } from '../types';
+/** profile 단건 조회 — id 기반 (ProfileView.id = `siteId@userId`) */
+export interface ProfileGetRequestData {
+    id: string;
+}
+/** profile(site-profile) set body 필드 — socials ProfileBody pass-through */
+export interface ProfileSetRequestData {
+    id?: string;
+    userId?: string;
+    siteId?: string;
+    nick?: string;
+    thumbnail?: string;
+    active?: boolean;
+    [key: string]: unknown;
+}
+/** profile 동기화 — 사이트 수준 멀티프로필 delta(since cursor). 누락 시 전체 */
+export interface ProfileSyncRequestData {
+    since?: number;
+}
+declare module '../types' {
+    interface SocketPacketRegistry {
+        'profile.get': {
+            request: ProfileGetRequestData;
+            response: unknown;
+            error: null;
+        };
+        'profile.get-mine': {
+            request: Record<string, never>;
+            response: unknown;
+            error: null;
+        };
+        'profile.set': {
+            request: ProfileSetRequestData;
+            response: unknown;
+            error: null;
+        };
+        'profile.sync': {
+            request: ProfileSyncRequestData;
+            response: unknown;
+            error: null;
+        };
+    }
+}
+export declare type ProfileGetType = 'profile.get';
+export declare type ProfileGetInput = InferSocketRequest<ProfileGetType>;
+export declare type ProfileGetRequestMessage = SocketRequestMessage<ProfileGetType>;
+export declare type ProfileGetMineType = 'profile.get-mine';
+export declare type ProfileGetMineInput = InferSocketRequest<ProfileGetMineType>;
+export declare type ProfileGetMineRequestMessage = SocketRequestMessage<ProfileGetMineType>;
+export declare type ProfileSetType = 'profile.set';
+export declare type ProfileSetInput = InferSocketRequest<ProfileSetType>;
+export declare type ProfileSetRequestMessage = SocketRequestMessage<ProfileSetType>;
+export declare type ProfileSyncType = 'profile.sync';
+export declare type ProfileSyncInput = InferSocketRequest<ProfileSyncType>;
+export declare type ProfileSyncRequestMessage = SocketRequestMessage<ProfileSyncType>;

package/dist/lib/profile/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/socket-actions.d.ts

@@ -30,6 +30,10 @@ export declare const SocketActionTypeLUT: {
         readonly chat: "chat";
         /** user - user/site profile operations */
         readonly user: "user";
+        /** place - place(site) CRUD operations */
+        readonly place: "place";
+        /** profile - site profile operations */
+        readonly profile: "profile";
         /** cloud - cloud profile operations */
         readonly cloud: "cloud";
     };
@@ -109,9 +113,11 @@ export declare const SocketActionTypeLUT: {
         readonly delete: "delete";
         /** sync - synchronize channel list/state */
         readonly sync: "sync";
+        /** read - pull authoritative single-channel item */
+        readonly read: "read";
         /** sync-users - synchronize channel users */
         readonly 'sync-users': "sync-users";
-        /** sync-site-profile - synchronize related site profile */
+        /** @deprecated use `profile.sync`. synchronize related site profile (하위호환) */
         readonly 'sync-site-profile': "sync-site-profile";
         /** unreads - get unread message summary */
         readonly unreads: "unreads";
@@ -152,14 +158,50 @@ export declare const SocketActionTypeLUT: {
         /** set-site-profile - set site profile */
         readonly 'set-site-profile': "set-site-profile";
     };
+    /**
+     * PlaceActionType
+     * - place(site) 도메인 액션
+     */
+    readonly PlaceActionType: {
+        readonly '': "";
+        /** create - create a place(site) */
+        readonly create: "create";
+        /** get - get a place(site) */
+        readonly get: "get";
+        /** update - update a place(site) */
+        readonly update: "update";
+        /** delete - delete a place(site) */
+        readonly delete: "delete";
+    };
+    /**
+     * ProfileActionType
+     * - profile(site-profile) 도메인 액션
+     */
+    readonly ProfileActionType: {
+        readonly '': "";
+        /** get - get site profile by id */
+        readonly get: "get";
+        /** get-mine - get current session's site profile */
+        readonly 'get-mine': "get-mine";
+        /** set - set site profile */
+        readonly set: "set";
+        /** sync - synchronize site multi-profiles (delta since cursor) */
+        readonly sync: "sync";
+    };
     /**
      * CloudActionType
      * - cloud 도메인 액션
      */
     readonly CloudActionType: {
         readonly '': "";
-        /** update - update cloud profile */
+        /** create - create a cloud (미구현/500) */
+        readonly create: "create";
+        /** get - get a cloud */
+        readonly get: "get";
+        /** update - update a cloud */
         readonly update: "update";
+        /** delete - delete a cloud */
+        readonly delete: "delete";
     };
 };
 declare type SocketActionKeyOf<T> = Extract<keyof T, string>;
@@ -196,6 +238,14 @@ export declare type SocketChatActionType = SocketActionKeyOf<typeof SocketAction
  * type: `SocketUserActionType`
  */
 export declare type SocketUserActionType = SocketActionKeyOf<typeof SocketActionTypeLUT.UserActionType>;
+/**
+ * type: `SocketPlaceActionType`
+ */
+export declare type SocketPlaceActionType = SocketActionKeyOf<typeof SocketActionTypeLUT.PlaceActionType>;
+/**
+ * type: `SocketProfileActionType`
+ */
+export declare type SocketProfileActionType = SocketActionKeyOf<typeof SocketActionTypeLUT.ProfileActionType>;
 /**
  * type: `SocketCloudActionType`
  */
@@ -203,7 +253,7 @@ export declare type SocketCloudActionType = SocketActionKeyOf<typeof SocketActio
 /**
  * type: `SocketActionType`
  */
-export declare type SocketActionType = SocketSystemActionType | SocketSocketsActionType | SocketDeviceActionType | SocketAuthActionType | SocketChannelActionType | SocketChatActionType | SocketUserActionType | SocketCloudActionType;
+export declare type SocketActionType = SocketSystemActionType | SocketSocketsActionType | SocketDeviceActionType | SocketAuthActionType | SocketChannelActionType | SocketChatActionType | SocketUserActionType | SocketPlaceActionType | SocketProfileActionType | SocketCloudActionType;
 /**
  * interface: `SocketActionTypeMap`
  * - domain to action type map
@@ -216,6 +266,8 @@ export interface SocketActionTypeMap {
     channel: SocketChannelActionType;
     chat: SocketChatActionType;
     user: SocketUserActionType;
+    place: SocketPlaceActionType;
+    profile: SocketProfileActionType;
     cloud: SocketCloudActionType;
 }
 /**