@lemoncloud/chatic-sockets-lib 0.2.0 → 0.3.0

package/dist/client-socket-v2/create-client-socket-v2.js

@@ -217,8 +217,13 @@ class ClientSocketV2Impl {
             return ((_a = this.aliases[source]) !== null && _a !== void 0 ? _a : source);
         };
         this.handleRawMessage = (raw) => {
+            var _a, _b, _c, _d;
             try {
+                if (((_b = (_a = this.options).shouldHandleRaw) === null || _b === void 0 ? void 0 : _b.call(_a, { raw })) === false)
+                    return;
                 const message = parseMessage(raw);
+                if (((_d = (_c = this.options).shouldHandleMessage) === null || _d === void 0 ? void 0 : _d.call(_c, { raw, message })) === false)
+                    return;
                 const handled = this.pending.settle(message);
                 const event = { message, raw };
                 this.messageListeners.forEach(listener => listener(event));

package/dist/client-socket-v2/gateways/auth-gateway.d.ts

@@ -0,0 +1,6 @@
+import type { AuthUpdateInput, AuthUpdateResponse } from '../../lib/auth/types';
+import type { ClientSocketV2 } from '../types';
+export interface AuthGateway {
+    update(data: AuthUpdateInput): Promise<AuthUpdateResponse>;
+}
+export declare const createAuthGateway: (client: ClientSocketV2) => AuthGateway;

package/dist/client-socket-v2/gateways/auth-gateway.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuthGateway = void 0;
+const create_domain_gateway_1 = require("./create-domain-gateway");
+const createAuthGateway = (client) => {
+    const gateway = (0, create_domain_gateway_1.createDomainGateway)('auth', client);
+    return {
+        update: data => gateway.request('update', data),
+    };
+};
+exports.createAuthGateway = createAuthGateway;

package/dist/client-socket-v2/gateways/channel-gateway.d.ts

@@ -0,0 +1,38 @@
+import type { ChannelCreateInput, ChannelDeleteInput, ChannelGetSelfInput, ChannelInviteInput, ChannelJoinInput, ChannelLeaveInput, ChannelListUserInput, ChannelMineInput, ChannelSyncInput, ChannelSyncProfileInput, ChannelSyncUsersInput, ChannelUnreadsInput, ChannelUpdateInput, ChannelUpdateJoinInput } from '../../lib/channel/types';
+import type { ClientSocketV2 } from '../types';
+/**
+ * channel 도메인 게이트웨이.
+ * - 모든 응답은 @lemoncloud/chatic-socials-api 소유(pass-through)이므로 제네릭 T로 호출부에서 주입한다.
+ * - 미주입 시 unknown(any 아님 — 사용 전 narrowing/캐스팅 강제). 각 메서드 주석의 $socials.<View> 가 실제 응답 타입.
+ */
+export interface ChannelGateway {
+    /** $socials.ChannelView */
+    create<T = unknown>(data: ChannelCreateInput): Promise<T>;
+    /** $socials.ChannelView */
+    update<T = unknown>(data: ChannelUpdateInput): Promise<T>;
+    /** $socials.ChannelView */
+    delete<T = unknown>(data: ChannelDeleteInput): Promise<T>;
+    /** $socials.JoinView */
+    join<T = unknown>(data: ChannelJoinInput): Promise<T>;
+    /** $socials.ChannelView */
+    leave<T = unknown>(data: ChannelLeaveInput): Promise<T>;
+    /** $socials.ChannelView */
+    getSelf<T = unknown>(data?: ChannelGetSelfInput | null): Promise<T>;
+    /** ListResult<$socials.ChannelView> */
+    mine<T = unknown>(data?: ChannelMineInput | null): Promise<T>;
+    /** ListResult<$socials.UserView> */
+    listUser<T = unknown>(data: ChannelListUserInput): Promise<T>;
+    /** $socials.ChannelView */
+    invite<T = unknown>(data: ChannelInviteInput): Promise<T>;
+    /** $socials.JoinView */
+    updateJoin<T = unknown>(data: ChannelUpdateJoinInput): Promise<T>;
+    /** $socials.UnreadsSummaryView */
+    unreads<T = unknown>(data?: ChannelUnreadsInput | null): Promise<T>;
+    /** $socials.ChannelSyncView */
+    sync<T = unknown>(data?: ChannelSyncInput | null): Promise<T>;
+    /** $socials.ChannelUsersSyncView */
+    syncUsers<T = unknown>(data?: ChannelSyncUsersInput | null): Promise<T>;
+    /** @deprecated moved to the profile domain. Use `createProfileGateway(client).sync()`. */
+    syncProfile<T = unknown>(data?: ChannelSyncProfileInput | null): Promise<T>;
+}
+export declare const createChannelGateway: (client: ClientSocketV2) => ChannelGateway;

package/dist/client-socket-v2/gateways/channel-gateway.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createChannelGateway = void 0;
+const create_domain_gateway_1 = require("./create-domain-gateway");
+const createChannelGateway = (client) => {
+    const gateway = (0, create_domain_gateway_1.createDomainGateway)('channel', client);
+    return {
+        create: (data) => gateway.request('create', data),
+        update: (data) => gateway.request('update', data),
+        delete: (data) => gateway.request('delete', data),
+        join: (data) => gateway.request('join', data),
+        leave: (data) => gateway.request('leave', data),
+        getSelf: (data) => gateway.request('get-self', data !== null && data !== void 0 ? data : null),
+        mine: (data) => gateway.request('mine', data !== null && data !== void 0 ? data : null),
+        listUser: (data) => gateway.request('list-user', data),
+        invite: (data) => gateway.request('invite', data),
+        updateJoin: (data) => gateway.request('update-join', data),
+        unreads: (data) => gateway.request('unreads', data !== null && data !== void 0 ? data : null),
+        sync: (data) => gateway.request('sync', data !== null && data !== void 0 ? data : null),
+        syncUsers: (data) => gateway.request('sync-users', data !== null && data !== void 0 ? data : null),
+        syncProfile: (data) => gateway.request('sync-site-profile', data !== null && data !== void 0 ? data : null),
+    };
+};
+exports.createChannelGateway = createChannelGateway;

package/dist/client-socket-v2/gateways/chat-gateway.d.ts

@@ -0,0 +1,22 @@
+import type { ChatFeedInput, ChatReadInput, ChatSendInput, ChatUpdateInput, ChatDeleteInput, ChatGetInput } from '../../lib/chat/types';
+import type { ClientSocketV2 } from '../types';
+/**
+ * chat 도메인 게이트웨이.
+ * - 모든 응답은 @lemoncloud/chatic-socials-api 소유(pass-through)이므로 제네릭 T로 호출부에서 주입한다.
+ * - 미주입 시 unknown. 각 메서드 주석의 $socials.<View> 가 실제 응답 타입.
+ */
+export interface ChatGateway {
+    /** $socials.ChatView */
+    send<T = unknown>(data: ChatSendInput): Promise<T>;
+    /** $socials.ChatView */
+    get<T = unknown>(data: ChatGetInput): Promise<T>;
+    /** $socials.JoinView */
+    read<T = unknown>(data: ChatReadInput): Promise<T>;
+    /** $socials.ChatFeedResult */
+    feed<T = unknown>(data: ChatFeedInput): Promise<T>;
+    /** $socials.ChatView */
+    update<T = unknown>(data: ChatUpdateInput): Promise<T>;
+    /** $socials.ChatView */
+    delete<T = unknown>(data: ChatDeleteInput): Promise<T>;
+}
+export declare const createChatGateway: (client: ClientSocketV2) => ChatGateway;

package/dist/client-socket-v2/gateways/chat-gateway.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createChatGateway = void 0;
+const create_domain_gateway_1 = require("./create-domain-gateway");
+const createChatGateway = (client) => {
+    const gateway = (0, create_domain_gateway_1.createDomainGateway)('chat', client);
+    return {
+        send: (data) => gateway.request('send', data),
+        get: (data) => gateway.request('get', data),
+        read: (data) => gateway.request('read', data),
+        feed: (data) => gateway.request('feed', data),
+        update: (data) => gateway.request('update', data),
+        delete: (data) => gateway.request('delete', data),
+    };
+};
+exports.createChatGateway = createChatGateway;

package/dist/client-socket-v2/gateways/cloud-gateway.d.ts

@@ -0,0 +1,18 @@
+import type { CloudCreateInput, CloudDeleteInput, CloudGetInput, CloudUpdateInput } from '../../lib/cloud/types';
+import type { ClientSocketV2 } from '../types';
+/**
+ * cloud 도메인 게이트웨이.
+ * - 응답은 @lemoncloud/chatic-backend-api 소유(pass-through)이므로 제네릭 T로 호출부에서 주입한다.
+ * - 미주입 시 unknown. 주석의 $backend.<View> 가 실제 응답 타입.
+ */
+export interface CloudGateway {
+    /** $backend.CloudView — 미구현(500 NOT IMPLEMENTED) */
+    create<T = unknown>(data: CloudCreateInput): Promise<T>;
+    /** $backend.CloudView */
+    get<T = unknown>(data: CloudGetInput): Promise<T>;
+    /** $backend.CloudView */
+    update<T = unknown>(data: CloudUpdateInput): Promise<T>;
+    /** $backend.CloudView */
+    delete<T = unknown>(data: CloudDeleteInput): Promise<T>;
+}
+export declare const createCloudGateway: (client: ClientSocketV2) => CloudGateway;

package/dist/client-socket-v2/gateways/cloud-gateway.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCloudGateway = void 0;
+const create_domain_gateway_1 = require("./create-domain-gateway");
+const createCloudGateway = (client) => {
+    const gateway = (0, create_domain_gateway_1.createDomainGateway)('cloud', client);
+    return {
+        create: (data) => gateway.request('create', data),
+        get: (data) => gateway.request('get', data),
+        update: (data) => gateway.request('update', data),
+        delete: (data) => gateway.request('delete', data),
+    };
+};
+exports.createCloudGateway = createCloudGateway;

package/dist/client-socket-v2/gateways/place-gateway.d.ts

@@ -0,0 +1,18 @@
+import type { PlaceCreateInput, PlaceDeleteInput, PlaceGetInput, PlaceUpdateInput } from '../../lib/place/types';
+import type { ClientSocketV2 } from '../types';
+/**
+ * place(site) 도메인 게이트웨이.
+ * - 응답은 @lemoncloud/chatic-backend-api 소유(pass-through)이므로 제네릭 T로 호출부에서 주입한다.
+ * - 미주입 시 unknown. 주석의 $backend.<View> 가 실제 응답 타입.
+ */
+export interface PlaceGateway {
+    /** $backend.MyUserView */
+    create<T = unknown>(data: PlaceCreateInput): Promise<T>;
+    /** $backend.MySiteView */
+    get<T = unknown>(data: PlaceGetInput): Promise<T>;
+    /** $backend.MySiteView */
+    update<T = unknown>(data: PlaceUpdateInput): Promise<T>;
+    /** $backend.MySiteView */
+    delete<T = unknown>(data: PlaceDeleteInput): Promise<T>;
+}
+export declare const createPlaceGateway: (client: ClientSocketV2) => PlaceGateway;

package/dist/client-socket-v2/gateways/place-gateway.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPlaceGateway = void 0;
+const create_domain_gateway_1 = require("./create-domain-gateway");
+const createPlaceGateway = (client) => {
+    const gateway = (0, create_domain_gateway_1.createDomainGateway)('place', client);
+    return {
+        create: (data) => gateway.request('create', data),
+        get: (data) => gateway.request('get', data),
+        update: (data) => gateway.request('update', data),
+        delete: (data) => gateway.request('delete', data),
+    };
+};
+exports.createPlaceGateway = createPlaceGateway;

package/dist/client-socket-v2/gateways/profile-gateway.d.ts

@@ -0,0 +1,18 @@
+import type { ProfileGetInput, ProfileGetMineInput, ProfileSetInput, ProfileSyncInput } from '../../lib/profile/types';
+import type { ClientSocketV2 } from '../types';
+/**
+ * profile(site-profile) 도메인 게이트웨이.
+ * - 응답은 @lemoncloud/chatic-socials-api 소유(pass-through)이므로 제네릭 T로 호출부에서 주입한다.
+ * - 미주입 시 unknown. 주석의 $socials.<View> 가 실제 응답 타입.
+ */
+export interface ProfileGateway {
+    /** $socials.ProfileView — id 기반 단건 조회 */
+    get<T = unknown>(data: ProfileGetInput): Promise<T>;
+    /** $socials.ProfileView — 현재 세션 기반 조회 */
+    getMine<T = unknown>(data?: ProfileGetMineInput | null): Promise<T>;
+    /** $socials.ProfileView */
+    set<T = unknown>(data: ProfileSetInput): Promise<T>;
+    /** $socials.SiteProfileSyncView — 사이트 멀티프로필 delta 동기화 */
+    sync<T = unknown>(data?: ProfileSyncInput | null): Promise<T>;
+}
+export declare const createProfileGateway: (client: ClientSocketV2) => ProfileGateway;

package/dist/client-socket-v2/gateways/profile-gateway.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProfileGateway = void 0;
+const create_domain_gateway_1 = require("./create-domain-gateway");
+const createProfileGateway = (client) => {
+    const gateway = (0, create_domain_gateway_1.createDomainGateway)('profile', client);
+    return {
+        get: (data) => gateway.request('get', data),
+        getMine: (data) => gateway.request('get-mine', data !== null && data !== void 0 ? data : null),
+        set: (data) => gateway.request('set', data),
+        sync: (data) => gateway.request('sync', data !== null && data !== void 0 ? data : null),
+    };
+};
+exports.createProfileGateway = createProfileGateway;

package/dist/client-socket-v2/gateways/user-gateway.d.ts

@@ -0,0 +1,38 @@
+import type { UserGetSiteProfileInput, UserInviteBatchInput, UserInviteInput, UserMakeSiteInput, UserMySiteInput, UserSetSiteProfileInput, UserUpdateProfileInput, UserUpdateSiteInput } from '../../lib/user/types';
+import type { ClientSocketV2 } from '../types';
+/**
+ * user 도메인 게이트웨이.
+ * - 응답은 @lemoncloud/chatic-socials-api / chatic-backend-api 소유(pass-through)이므로 제네릭 T로 호출부에서 주입한다.
+ * - 미주입 시 unknown. 각 메서드 주석의 $socials/$backend.<View> 가 실제 응답 타입(서버가 unknown으로 둔 것은 표기 생략).
+ */
+export interface UserGateway {
+    /** $socials.UserView */
+    update<T = unknown>(data: UserUpdateProfileInput): Promise<T>;
+    /** ListResult<$backend.MySiteView> */
+    mySite<T = unknown>(data?: UserMySiteInput | null): Promise<T>;
+    /** $backend.MyInviteView */
+    invite<T = unknown>(data: UserInviteInput): Promise<T>;
+    /** ListResult<$backend.MyInviteView> */
+    inviteBatch<T = unknown>(data: UserInviteBatchInput): Promise<T>;
+    /**
+     * $backend.MySiteView
+     * @deprecated moved to the place domain. Use `createPlaceGateway(client).create()`.
+     */
+    makeSite<T = unknown>(data: UserMakeSiteInput): Promise<T>;
+    /**
+     * $backend.MySiteView
+     * @deprecated moved to the place domain. Use `createPlaceGateway(client).update()`.
+     */
+    updateSite<T = unknown>(data: UserUpdateSiteInput): Promise<T>;
+    /**
+     * $socials.ProfileView
+     * @deprecated moved to the profile domain. Use `createProfileGateway(client).getMine()`.
+     */
+    getSiteProfile<T = unknown>(data?: UserGetSiteProfileInput | null): Promise<T>;
+    /**
+     * $socials.ProfileView
+     * @deprecated moved to the profile domain. Use `createProfileGateway(client).set()`.
+     */
+    setSiteProfile<T = unknown>(data: UserSetSiteProfileInput): Promise<T>;
+}
+export declare const createUserGateway: (client: ClientSocketV2) => UserGateway;

package/dist/client-socket-v2/gateways/user-gateway.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUserGateway = void 0;
+const create_domain_gateway_1 = require("./create-domain-gateway");
+const createUserGateway = (client) => {
+    const gateway = (0, create_domain_gateway_1.createDomainGateway)('user', client);
+    return {
+        getSiteProfile: (data) => gateway.request('get-site-profile', data !== null && data !== void 0 ? data : null),
+        mySite: (data) => gateway.request('my-site', data !== null && data !== void 0 ? data : null),
+        makeSite: (data) => gateway.request('make-site', data),
+        invite: (data) => gateway.request('invite', data),
+        inviteBatch: (data) => gateway.request('invite-batch', data),
+        update: (data) => gateway.request('update-profile', data),
+        updateSite: (data) => gateway.request('update-site', data),
+        setSiteProfile: (data) => gateway.request('set-site-profile', data),
+    };
+};
+exports.createUserGateway = createUserGateway;

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

@@ -17,9 +17,22 @@ export * from './sync-scheduler';
 export * from './socket-runtime';
 export * from './create-device-runtime';
 export * from './plans/device-sync-plan';
+export * from './plans/channel-sync-plan';
+export * from './plans/place-sync-plan';
+export * from './plans/profile-sync-plan';
 export * from './gateways/create-domain-gateway';
 export * from './gateways/device-gateway';
+export * from './gateways/channel-gateway';
+export * from './gateways/auth-gateway';
+export * from './gateways/chat-gateway';
+export * from './gateways/cloud-gateway';
+export * from './gateways/user-gateway';
+export * from './gateways/place-gateway';
+export * from './gateways/profile-gateway';
 export * from '../lib/types';
 export * from '../lib/device/types';
 export * from '../lib/device/contracts';
 export * from '../lib/auth/types';
+export * from '../lib/socket-actions';
+export * from '../lib/socket-inputs';
+export type { AuthUpdateInput, DeviceGetInput, DeviceSaveInput, DeviceSyncInput } from '../lib/socket-inputs';

package/dist/client-socket-v2/index.js

@@ -35,9 +35,21 @@ __exportStar(require("./sync-scheduler"), exports);
 __exportStar(require("./socket-runtime"), exports);
 __exportStar(require("./create-device-runtime"), exports);
 __exportStar(require("./plans/device-sync-plan"), exports);
+__exportStar(require("./plans/channel-sync-plan"), exports);
+__exportStar(require("./plans/place-sync-plan"), exports);
+__exportStar(require("./plans/profile-sync-plan"), exports);
 __exportStar(require("./gateways/create-domain-gateway"), exports);
 __exportStar(require("./gateways/device-gateway"), exports);
+__exportStar(require("./gateways/channel-gateway"), exports);
+__exportStar(require("./gateways/auth-gateway"), exports);
+__exportStar(require("./gateways/chat-gateway"), exports);
+__exportStar(require("./gateways/cloud-gateway"), exports);
+__exportStar(require("./gateways/user-gateway"), exports);
+__exportStar(require("./gateways/place-gateway"), exports);
+__exportStar(require("./gateways/profile-gateway"), exports);
 __exportStar(require("../lib/types"), exports);
 __exportStar(require("../lib/device/types"), exports);
 __exportStar(require("../lib/device/contracts"), exports);
 __exportStar(require("../lib/auth/types"), exports);
+__exportStar(require("../lib/socket-actions"), exports);
+__exportStar(require("../lib/socket-inputs"), exports);

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

@@ -0,0 +1,33 @@
+import type { ChannelView } from '../../modules/chat/views';
+import type { SocketMessage } from '../../lib/types';
+import type { DomainSyncContext, DomainSyncPlan, SyncBackoffOptions, SyncFailureInfo, SyncTargetDescriptor } from '../types';
+export interface ChannelSyncTarget extends SyncTargetDescriptor {
+    type: 'channel';
+}
+export interface ChannelSyncSnapshot {
+    id?: string;
+    updatedAt?: number;
+    view?: ChannelView;
+}
+export interface ChannelSyncPlanOptions {
+    intervalMs?: number;
+    idleBackoff?: SyncBackoffOptions;
+    resetSnapshotOnConnected?: boolean;
+    onUpdate?: (target: ChannelSyncTarget, view: ChannelView, previous?: ChannelSyncSnapshot) => void;
+    onRemove?: (target: ChannelSyncTarget, previous?: ChannelSyncSnapshot) => void;
+}
+/** Single-channel sync: polls `channel.get`, applies on `updatedAt` change, re-pulls on a `channel.sync` nudge. */
+export declare class ChannelSyncPlan implements DomainSyncPlan<ChannelSyncTarget> {
+    private readonly options;
+    readonly domain = "channel";
+    readonly idleBackoff: SyncBackoffOptions;
+    constructor(options?: ChannelSyncPlanOptions);
+    supports: (target: SyncTargetDescriptor) => target is ChannelSyncTarget;
+    getKey: (target: ChannelSyncTarget) => string;
+    getIntervalMs: (target: ChannelSyncTarget) => number;
+    onConnected: (target: ChannelSyncTarget, ctx: DomainSyncContext) => void;
+    run: (target: ChannelSyncTarget, ctx: DomainSyncContext) => Promise<void>;
+    onTrigger: (target: ChannelSyncTarget, message: SocketMessage<any>, ctx: DomainSyncContext) => Promise<void>;
+    onStopped: (target: ChannelSyncTarget, _info: SyncFailureInfo, ctx: DomainSyncContext) => void;
+    updateLocalState: (target: ChannelSyncTarget, snapshot: unknown, ctx: DomainSyncContext) => void;
+}

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

@@ -0,0 +1,66 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChannelSyncPlan = void 0;
+/** Single-channel sync: polls `channel.get`, applies on `updatedAt` change, re-pulls on a `channel.sync` nudge. */
+class ChannelSyncPlan {
+    constructor(options = {}) {
+        var _a;
+        this.options = options;
+        this.domain = 'channel';
+        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; };
+        this.onConnected = (target, ctx) => {
+            if (this.options.resetSnapshotOnConnected === false)
+                return;
+            ctx.writeSnapshot(target, undefined);
+        };
+        this.run = (target, ctx) => __awaiter(this, void 0, void 0, function* () {
+            var _b, _c, _d, _e;
+            if (!target.id)
+                return;
+            const prev = ctx.readSnapshot(target);
+            const input = { id: target.id };
+            const view = yield ctx.client.request('channel.get', input);
+            const nextUpdatedAt = typeof (view === null || view === void 0 ? void 0 : view.updatedAt) === 'number' ? view.updatedAt : undefined;
+            const prevUpdatedAt = typeof (prev === null || prev === void 0 ? void 0 : prev.updatedAt) === 'number' ? prev.updatedAt : undefined;
+            if (prevUpdatedAt === nextUpdatedAt && (prev === null || prev === void 0 ? void 0 : prev.view))
+                return;
+            const next = {
+                id: `${(_c = (_b = view === null || view === void 0 ? void 0 : view.id) !== null && _b !== void 0 ? _b : target.id) !== null && _c !== void 0 ? _c : ''}` || undefined,
+                updatedAt: nextUpdatedAt,
+                view,
+            };
+            ctx.writeSnapshot(target, next);
+            (_e = (_d = this.options).onUpdate) === null || _e === void 0 ? void 0 : _e.call(_d, target, view, prev);
+        });
+        this.onTrigger = (target, message, ctx) => __awaiter(this, void 0, void 0, function* () {
+            const data = ((message === null || message === void 0 ? void 0 : message.data) || {});
+            if (target.id && (data === null || data === void 0 ? void 0 : data.id) && target.id !== data.id)
+                return;
+            yield this.run(target, ctx);
+        });
+        this.onStopped = (target, _info, ctx) => {
+            var _a, _b;
+            const prev = ctx.readSnapshot(target);
+            (_b = (_a = this.options).onRemove) === null || _b === void 0 ? void 0 : _b.call(_a, target, prev);
+        };
+        this.updateLocalState = (target, snapshot, ctx) => {
+            var _a, _b;
+            const prev = ctx.readSnapshot(target);
+            const patch = (snapshot || {});
+            ctx.writeSnapshot(target, Object.assign(Object.assign(Object.assign({}, prev), patch), { view: (_a = patch.view) !== null && _a !== void 0 ? _a : prev === null || prev === void 0 ? void 0 : prev.view, updatedAt: (_b = patch.updatedAt) !== null && _b !== void 0 ? _b : prev === null || prev === void 0 ? void 0 : prev.updatedAt }));
+        };
+        this.idleBackoff = (_a = options.idleBackoff) !== null && _a !== void 0 ? _a : { factor: 2, maxMs: 60000 };
+    }
+}
+exports.ChannelSyncPlan = ChannelSyncPlan;

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

@@ -1,6 +1,6 @@
 import type { DeviceGetResponseData } from '../../lib/device/types';
 import type { SocketMessage } from '../../lib/types';
-import type { DomainSyncContext, DomainSyncPlan, SyncTargetDescriptor } from '../types';
+import type { DomainSyncContext, DomainSyncPlan, SyncBackoffOptions, SyncFailurePolicy, SyncTargetDescriptor } from '../types';
 export interface DeviceSyncTarget extends SyncTargetDescriptor {
     type: 'device';
 }
@@ -14,11 +14,15 @@ export interface DeviceSyncPlanOptions {
     intervalMs?: number;
     sendSyncHint?: boolean;
     resetSnapshotOnConnected?: boolean;
+    failurePolicy?: SyncFailurePolicy;
+    idleBackoff?: SyncBackoffOptions;
     onUpdate?: (target: DeviceSyncTarget, view: DeviceGetResponseData, previous?: DeviceSyncSnapshot) => void;
 }
 export declare class DeviceSyncPlan implements DomainSyncPlan<DeviceSyncTarget> {
     private readonly options;
     readonly domain = "device";
+    readonly failurePolicy: SyncFailurePolicy;
+    readonly idleBackoff: SyncBackoffOptions;
     constructor(options?: DeviceSyncPlanOptions);
     supports: (target: SyncTargetDescriptor) => target is DeviceSyncTarget;
     getKey: (target: DeviceSyncTarget) => string;

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

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeviceSyncPlan = void 0;
 class DeviceSyncPlan {
     constructor(options = {}) {
+        var _a, _b;
         this.options = options;
         this.domain = 'device';
         this.supports = (target) => (target === null || target === void 0 ? void 0 : target.type) === 'device';
@@ -23,7 +24,7 @@ class DeviceSyncPlan {
             ctx.writeSnapshot(target, undefined);
         };
         this.run = (target, ctx) => __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d;
+            var _c, _d, _e, _f;
             const prev = ctx.readSnapshot(target);
             if (this.options.sendSyncHint !== false) {
                 const syncData = Object.assign(Object.assign({}, (target.id ? { id: target.id } : {})), (typeof (prev === null || prev === void 0 ? void 0 : prev.tick) === 'number' ? { tick: prev.tick } : {}));
@@ -39,13 +40,13 @@ class DeviceSyncPlan {
             if (prevTick === nextTick && (prev === null || prev === void 0 ? void 0 : prev.view))
                 return;
             const next = {
-                id: `${(_b = (_a = view === null || view === void 0 ? void 0 : view.id) !== null && _a !== void 0 ? _a : target.id) !== null && _b !== void 0 ? _b : ''}` || undefined,
+                id: `${(_d = (_c = view === null || view === void 0 ? void 0 : view.id) !== null && _c !== void 0 ? _c : target.id) !== null && _d !== void 0 ? _d : ''}` || undefined,
                 tick: nextTick,
                 lastAppliedTick: nextTick,
                 view,
             };
             ctx.writeSnapshot(target, next);
-            (_d = (_c = this.options).onUpdate) === null || _d === void 0 ? void 0 : _d.call(_c, target, view, prev);
+            (_f = (_e = this.options).onUpdate) === null || _f === void 0 ? void 0 : _f.call(_e, target, view, prev);
         });
         this.onTrigger = (target, message, ctx) => __awaiter(this, void 0, void 0, function* () {
             const data = ((message === null || message === void 0 ? void 0 : message.data) || {});
@@ -59,6 +60,8 @@ class DeviceSyncPlan {
             const patch = (snapshot || {});
             ctx.writeSnapshot(target, Object.assign(Object.assign(Object.assign({}, prev), patch), { view: (_a = patch.view) !== null && _a !== void 0 ? _a : prev === null || prev === void 0 ? void 0 : prev.view, tick: (_b = patch.tick) !== null && _b !== void 0 ? _b : prev === null || prev === void 0 ? void 0 : prev.tick, lastAppliedTick: (_c = patch.lastAppliedTick) !== null && _c !== void 0 ? _c : prev === null || prev === void 0 ? void 0 : prev.lastAppliedTick }));
         };
+        this.failurePolicy = (_a = options.failurePolicy) !== null && _a !== void 0 ? _a : { decide: () => 'retry' };
+        this.idleBackoff = (_b = options.idleBackoff) !== null && _b !== void 0 ? _b : { factor: 2, maxMs: 30000 };
     }
 }
 exports.DeviceSyncPlan = DeviceSyncPlan;

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

@@ -0,0 +1,33 @@
+import type * as $backend from '@lemoncloud/chatic-backend-api';
+import type { SocketMessage } from '../../lib/types';
+import type { DomainSyncContext, DomainSyncPlan, SyncBackoffOptions, SyncFailureInfo, SyncTargetDescriptor } from '../types';
+export interface PlaceSyncTarget extends SyncTargetDescriptor {
+    type: 'place';
+}
+export interface PlaceSyncSnapshot {
+    id?: string;
+    updatedAt?: number;
+    view?: $backend.MySiteView;
+}
+export interface PlaceSyncPlanOptions {
+    intervalMs?: number;
+    idleBackoff?: SyncBackoffOptions;
+    resetSnapshotOnConnected?: boolean;
+    onUpdate?: (target: PlaceSyncTarget, view: $backend.MySiteView, previous?: PlaceSyncSnapshot) => void;
+    onRemove?: (target: PlaceSyncTarget, previous?: PlaceSyncSnapshot) => void;
+}
+/** Single-place sync: polls `place.get`, applies on `updatedAt` change, re-pulls on a `place.sync` nudge. */
+export declare class PlaceSyncPlan implements DomainSyncPlan<PlaceSyncTarget> {
+    private readonly options;
+    readonly domain = "place";
+    readonly idleBackoff: SyncBackoffOptions;
+    constructor(options?: PlaceSyncPlanOptions);
+    supports: (target: SyncTargetDescriptor) => target is PlaceSyncTarget;
+    getKey: (target: PlaceSyncTarget) => string;
+    getIntervalMs: (target: PlaceSyncTarget) => number;
+    onConnected: (target: PlaceSyncTarget, ctx: DomainSyncContext) => void;
+    run: (target: PlaceSyncTarget, ctx: DomainSyncContext) => Promise<void>;
+    onTrigger: (target: PlaceSyncTarget, message: SocketMessage<any>, ctx: DomainSyncContext) => Promise<void>;
+    onStopped: (target: PlaceSyncTarget, _info: SyncFailureInfo, ctx: DomainSyncContext) => void;
+    updateLocalState: (target: PlaceSyncTarget, snapshot: unknown, ctx: DomainSyncContext) => void;
+}

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

@@ -0,0 +1,67 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlaceSyncPlan = void 0;
+/** Single-place sync: polls `place.get`, applies on `updatedAt` change, re-pulls on a `place.sync` nudge. */
+class PlaceSyncPlan {
+    constructor(options = {}) {
+        var _a;
+        this.options = options;
+        this.domain = 'place';
+        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; };
+        this.onConnected = (target, ctx) => {
+            if (this.options.resetSnapshotOnConnected === false)
+                return;
+            ctx.writeSnapshot(target, undefined);
+        };
+        this.run = (target, ctx) => __awaiter(this, void 0, void 0, function* () {
+            var _b, _c, _d, _e;
+            if (!target.id)
+                return;
+            const prev = ctx.readSnapshot(target);
+            const input = { id: target.id };
+            // place.get 응답은 backend 소유(registry response=unknown) → MySiteView 로 단언
+            const view = (yield ctx.client.request('place.get', input));
+            const nextUpdatedAt = typeof (view === null || view === void 0 ? void 0 : view.updatedAt) === 'number' ? view.updatedAt : undefined;
+            const prevUpdatedAt = typeof (prev === null || prev === void 0 ? void 0 : prev.updatedAt) === 'number' ? prev.updatedAt : undefined;
+            if (prevUpdatedAt === nextUpdatedAt && (prev === null || prev === void 0 ? void 0 : prev.view))
+                return;
+            const next = {
+                id: `${(_c = (_b = view === null || view === void 0 ? void 0 : view.id) !== null && _b !== void 0 ? _b : target.id) !== null && _c !== void 0 ? _c : ''}` || undefined,
+                updatedAt: nextUpdatedAt,
+                view,
+            };
+            ctx.writeSnapshot(target, next);
+            (_e = (_d = this.options).onUpdate) === null || _e === void 0 ? void 0 : _e.call(_d, target, view, prev);
+        });
+        this.onTrigger = (target, message, ctx) => __awaiter(this, void 0, void 0, function* () {
+            const data = ((message === null || message === void 0 ? void 0 : message.data) || {});
+            if (target.id && (data === null || data === void 0 ? void 0 : data.id) && target.id !== data.id)
+                return;
+            yield this.run(target, ctx);
+        });
+        this.onStopped = (target, _info, ctx) => {
+            var _a, _b;
+            const prev = ctx.readSnapshot(target);
+            (_b = (_a = this.options).onRemove) === null || _b === void 0 ? void 0 : _b.call(_a, target, prev);
+        };
+        this.updateLocalState = (target, snapshot, ctx) => {
+            var _a, _b;
+            const prev = ctx.readSnapshot(target);
+            const patch = (snapshot || {});
+            ctx.writeSnapshot(target, Object.assign(Object.assign(Object.assign({}, prev), patch), { view: (_a = patch.view) !== null && _a !== void 0 ? _a : prev === null || prev === void 0 ? void 0 : prev.view, updatedAt: (_b = patch.updatedAt) !== null && _b !== void 0 ? _b : prev === null || prev === void 0 ? void 0 : prev.updatedAt }));
+        };
+        this.idleBackoff = (_a = options.idleBackoff) !== null && _a !== void 0 ? _a : { factor: 2, maxMs: 60000 };
+    }
+}
+exports.PlaceSyncPlan = PlaceSyncPlan;