@lemoncloud/chatic-sockets-lib 0.2.1 → 0.3.1

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

@@ -32,7 +32,7 @@ export interface ChannelGateway {
     sync<T = unknown>(data?: ChannelSyncInput | null): Promise<T>;
     /** $socials.ChannelUsersSyncView */
     syncUsers<T = unknown>(data?: ChannelSyncUsersInput | null): Promise<T>;
-    /** $socials.SiteProfileSyncView */
+    /** @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/cloud-gateway.d.ts

@@ -1,4 +1,4 @@
-import type { CloudUpdateInput } from '../../lib/cloud/types';
+import type { CloudCreateInput, CloudDeleteInput, CloudGetInput, CloudUpdateInput } from '../../lib/cloud/types';
 import type { ClientSocketV2 } from '../types';
 /**
  * cloud 도메인 게이트웨이.
@@ -6,7 +6,13 @@ import type { ClientSocketV2 } from '../types';
  * - 미주입 시 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

@@ -5,7 +5,10 @@ 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

@@ -6,21 +6,33 @@ import type { ClientSocketV2 } from '../types';
  * - 미주입 시 unknown. 각 메서드 주석의 $socials/$backend.<View> 가 실제 응답 타입(서버가 unknown으로 둔 것은 표기 생략).
  */
 export interface UserGateway {
-    /** $socials.ProfileView */
-    getSiteProfile<T = unknown>(data?: UserGetSiteProfileInput | null): Promise<T>;
+    /** $socials.UserView */
+    update<T = unknown>(data: UserUpdateProfileInput): Promise<T>;
     /** ListResult<$backend.MySiteView> */
     mySite<T = unknown>(data?: UserMySiteInput | null): Promise<T>;
-    /** $backend.MySiteView */
-    makeSite<T = unknown>(data: UserMakeSiteInput): Promise<T>;
     /** $backend.MyInviteView */
     invite<T = unknown>(data: UserInviteInput): Promise<T>;
     /** ListResult<$backend.MyInviteView> */
     inviteBatch<T = unknown>(data: UserInviteBatchInput): Promise<T>;
-    /** $socials.UserView */
-    updateProfile<T = unknown>(data: UserUpdateProfileInput): Promise<T>;
-    /** $backend.MySiteView */
+    /**
+     * $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 */
+    /**
+     * $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

@@ -10,7 +10,7 @@ const createUserGateway = (client) => {
         makeSite: (data) => gateway.request('make-site', data),
         invite: (data) => gateway.request('invite', data),
         inviteBatch: (data) => gateway.request('invite-batch', data),
-        updateProfile: (data) => gateway.request('update-profile', data),
+        update: (data) => gateway.request('update-profile', data),
         updateSite: (data) => gateway.request('update-site', data),
         setSiteProfile: (data) => gateway.request('set-site-profile', data),
     };

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

@@ -17,6 +17,9 @@ 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';
@@ -24,6 +27,8 @@ 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';

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

@@ -35,6 +35,9 @@ __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);
@@ -42,6 +45,8 @@ __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);

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;

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

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

package/dist/client-socket-v2/plans/profile-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.ProfileSyncPlan = void 0;
+/** Single-profile sync: polls `profile.get`, applies on `updatedAt` change, re-pulls on a `profile.sync` nudge. */
+class ProfileSyncPlan {
+    constructor(options = {}) {
+        var _a;
+        this.options = options;
+        this.domain = 'profile';
+        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; };
+        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 };
+            // profile.get 응답은 socials 소유(registry response=unknown) → ProfileView 로 단언
+            const view = (yield ctx.client.request('profile.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.ProfileSyncPlan = ProfileSyncPlan;

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

@@ -1,7 +1,8 @@
 import { AutoReconnectController } from './reconnect-controller';
 import { ConnectionRotationController } from './connection-rotation-controller';
 import { KeepAliveLoop } from './keep-alive-loop';
-import type { ClientSocketRuntime, ClientSocketV2, DomainSyncPlan, KeepAliveLoopControl, ReconnectController, SharedTimerScheduler, SyncScheduler, SyncTargetDescriptor } from './types';
+import { type SyncBackoffOptions } from './sync-scheduler';
+import type { ClientSocketRuntime, ClientSocketV2, DomainSyncPlan, KeepAliveLoopControl, ReconnectController, SharedTimerScheduler, SyncFailurePolicy, SyncScheduler, SyncTargetDescriptor } from './types';
 export interface ClientSocketRuntimeOptions {
     client: ClientSocketV2;
     scheduler?: SyncScheduler;
@@ -10,6 +11,9 @@ export interface ClientSocketRuntimeOptions {
     rotation?: ConnectionRotationController;
     timerScheduler?: SharedTimerScheduler;
     syncPlans?: DomainSyncPlan<any>[];
+    syncBackoff?: SyncBackoffOptions;
+    syncIdleBackoff?: SyncBackoffOptions;
+    failurePolicy?: SyncFailurePolicy;
     keepAliveOptions?: Omit<ConstructorParameters<typeof KeepAliveLoop>[0], 'client' | 'timerScheduler'>;
     reconnectOptions?: Omit<ConstructorParameters<typeof AutoReconnectController>[0], 'client'>;
     rotationOptions?: Omit<ConstructorParameters<typeof ConnectionRotationController>[0], 'client' | 'reconnect'>;

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

@@ -34,12 +34,16 @@ class SocketRuntime {
         this.stopAllSync = () => this.scheduler.stopAll();
         this.listSyncTargets = () => this.scheduler.list();
         this.updateLocalSnapshot = (target, snapshot) => this.scheduler.updateLocalSnapshot(target, snapshot);
-        this.timerScheduler = (_b = (_a = options.timerScheduler) !== null && _a !== void 0 ? _a : options.client.timerScheduler) !== null && _b !== void 0 ? _b : new shared_timer_scheduler_1.InMemorySharedTimerScheduler();
+        this.timerScheduler =
+            (_b = (_a = options.timerScheduler) !== null && _a !== void 0 ? _a : options.client.timerScheduler) !== null && _b !== void 0 ? _b : new shared_timer_scheduler_1.InMemorySharedTimerScheduler();
         this.scheduler =
             (_c = options.scheduler) !== null && _c !== void 0 ? _c : new sync_scheduler_1.DomainSyncScheduler({
                 client: options.client,
                 plans: (_d = options.syncPlans) !== null && _d !== void 0 ? _d : [],
                 timerScheduler: this.timerScheduler,
+                backoff: options.syncBackoff,
+                idleBackoff: options.syncIdleBackoff,
+                failurePolicy: options.failurePolicy,
             });
         this.keepAlive =
             (_e = options.keepAlive) !== null && _e !== void 0 ? _e : (options.keepAliveOptions