@lemoncloud/chatic-sockets-lib 0.3.1 → 0.3.2

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

@@ -18,6 +18,8 @@ export * from './socket-runtime';
 export * from './create-device-runtime';
 export * from './plans/device-sync-plan';
 export * from './plans/channel-sync-plan';
+export * from './plans/chat-sync-plan';
+export type { ChatSyncType, ChatSyncData, ChatSyncMessage } from '../lib/chat/types';
 export * from './plans/place-sync-plan';
 export * from './plans/profile-sync-plan';
 export * from './gateways/create-domain-gateway';

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

@@ -36,6 +36,7 @@ __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/chat-sync-plan"), exports);
 __exportStar(require("./plans/place-sync-plan"), exports);
 __exportStar(require("./plans/profile-sync-plan"), exports);
 __exportStar(require("./gateways/create-domain-gateway"), exports);

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

@@ -1,4 +1,4 @@
-import type { ChannelView } from '../../modules/chat/views';
+import type { ChannelView } from '../../lib/chat/views';
 import type { SocketMessage } from '../../lib/types';
 import type { DomainSyncContext, DomainSyncPlan, SyncBackoffOptions, SyncFailureInfo, SyncTargetDescriptor } from '../types';
 export interface ChannelSyncTarget extends SyncTargetDescriptor {

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

@@ -0,0 +1,54 @@
+import type { ChatView } from '../../lib/chat/views';
+import type { SocketMessage } from '../../lib/types';
+import type { DomainSyncContext, DomainSyncPlan, SyncBackoffOptions, SyncFailureInfo, SyncTargetDescriptor } from '../types';
+/** Sync target for one channel's chat messages. */
+export interface ChatSyncTarget extends SyncTargetDescriptor {
+    type: 'chat';
+}
+/** Applied message window. `lastNo` is the top (next expected is `lastNo + 1`); messages older than `minNo` are left for the app to lazy-load. */
+export interface ChatSyncSnapshot {
+    id: string;
+    lastNo: number;
+    minNo: number;
+    messages: ChatView[];
+}
+export interface ChatSyncPlanOptions {
+    /** Max messages fetched in one catch-up; anything older is left for the app to lazy-load. Default 50. */
+    cap?: number;
+    /** Max messages kept in the snapshot window to bound memory; the app holds full history via `onApply`. Default 500. */
+    maxMessages?: number;
+    idleBackoff?: SyncBackoffOptions;
+    /** Called after messages are applied, with the applied delta (ascending) and the new snapshot. */
+    onApply?: (target: ChatSyncTarget, applied: ChatView[], snapshot: ChatSyncSnapshot) => void;
+    /** Called when the engine stops the target. */
+    onRemove?: (target: ChatSyncTarget, previous?: ChatSyncSnapshot) => void;
+}
+/**
+ * Per-channel chat message sync (append-only events).
+ * - `onTrigger` (chat.sync): applies the message payload directly, with no read round-trip on the normal path.
+ * - `onConnected`: catches up from `lastNo` to `channel.chatNo` (bounded by `cap`) after a reconnect.
+ * - `run`: no-op (event-driven, no polling).
+ */
+export declare class ChatSyncPlan implements DomainSyncPlan<ChatSyncTarget> {
+    private readonly options;
+    readonly domain = "chat";
+    readonly idleBackoff: SyncBackoffOptions;
+    private readonly chains;
+    constructor(options?: ChatSyncPlanOptions);
+    supports: (target: SyncTargetDescriptor) => target is ChatSyncTarget;
+    getKey: (target: ChatSyncTarget) => string;
+    run: () => Promise<void>;
+    onConnected: (target: ChatSyncTarget, ctx: DomainSyncContext) => Promise<void>;
+    onTrigger: (target: ChatSyncTarget, message: SocketMessage<any>, ctx: DomainSyncContext) => Promise<void>;
+    onStopped: (target: ChatSyncTarget, _info: SyncFailureInfo, ctx: DomainSyncContext) => void;
+    updateLocalState: (target: ChatSyncTarget, snapshot: unknown, ctx: DomainSyncContext) => void;
+    /** Serialize read-modify-write per channel; the scheduler does not serialize onTrigger. */
+    private serialize;
+    private readSnap;
+    /** Append the contiguous `lastNo + 1 ..` run to the top of the window; gaps and duplicates are skipped. */
+    private appendContiguous;
+    /** Trim the window to `maxMessages`, dropping the oldest and advancing `minNo`. */
+    private clampWindow;
+    /** Reconnect/gap fill: collect newest-first, bound by `cap`, apply ascending, then set `lastNo` to `total`. */
+    private catchUp;
+}

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

@@ -0,0 +1,166 @@
+"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.ChatSyncPlan = void 0;
+const num = (v, d = 0) => (typeof v === 'number' && Number.isFinite(v) ? v : d);
+/**
+ * Per-channel chat message sync (append-only events).
+ * - `onTrigger` (chat.sync): applies the message payload directly, with no read round-trip on the normal path.
+ * - `onConnected`: catches up from `lastNo` to `channel.chatNo` (bounded by `cap`) after a reconnect.
+ * - `run`: no-op (event-driven, no polling).
+ */
+class ChatSyncPlan {
+    constructor(options = {}) {
+        var _a;
+        this.options = options;
+        this.domain = 'chat';
+        this.chains = new Map();
+        this.supports = (target) => (target === null || target === void 0 ? void 0 : target.type) === 'chat';
+        this.getKey = (target) => { var _a; return `chat:${(_a = target === null || target === void 0 ? void 0 : target.id) !== null && _a !== void 0 ? _a : ''}`; };
+        this.run = () => __awaiter(this, void 0, void 0, function* () { return undefined; });
+        this.onConnected = (target, ctx) => __awaiter(this, void 0, void 0, function* () {
+            if (!target.id)
+                return;
+            // Swallow errors so one channel's catch-up failure cannot break the scheduler's reconnect loop; recovered on the next message or reconnect.
+            yield this.serialize(target.id, () => this.catchUp(target, ctx)).catch(() => undefined);
+        });
+        this.onTrigger = (target, message, ctx) => __awaiter(this, void 0, void 0, function* () {
+            var _b;
+            if (!target.id)
+                return;
+            const data = ((message === null || message === void 0 ? void 0 : message.data) || {});
+            const channelId = `${(_b = data === null || data === void 0 ? void 0 : data.channelId) !== null && _b !== void 0 ? _b : ''}`;
+            if (!channelId || channelId !== target.id)
+                return; // ignore other channels
+            const no = num(data === null || data === void 0 ? void 0 : data.chatNo, 0);
+            if (no <= 0)
+                return;
+            yield this.serialize(target.id, () => __awaiter(this, void 0, void 0, function* () {
+                const snap = this.readSnap(target, ctx);
+                if (no <= snap.lastNo)
+                    return; // duplicate or old
+                if (no === snap.lastNo + 1) {
+                    this.appendContiguous(target, ctx, snap, [data]); // apply payload directly, no feed
+                }
+                else {
+                    yield this.catchUp(target, ctx, snap); // gap: fill from the server
+                }
+            }));
+        });
+        this.onStopped = (target, _info, ctx) => {
+            var _a, _b;
+            const prev = ctx.readSnapshot(target);
+            if (target.id)
+                this.chains.delete(target.id);
+            (_b = (_a = this.options).onRemove) === null || _b === void 0 ? void 0 : _b.call(_a, target, prev);
+        };
+        this.updateLocalState = (target, snapshot, ctx) => {
+            const prev = this.readSnap(target, ctx);
+            const patch = (snapshot || {});
+            ctx.writeSnapshot(target, Object.assign(Object.assign({}, prev), patch));
+        };
+        /** Reconnect/gap fill: collect newest-first, bound by `cap`, apply ascending, then set `lastNo` to `total`. */
+        this.catchUp = (target, ctx, snapIn) => __awaiter(this, void 0, void 0, function* () {
+            var _c, _d, _e;
+            if (!target.id)
+                return;
+            const snap = snapIn !== null && snapIn !== void 0 ? snapIn : this.readSnap(target, ctx);
+            const input = { id: target.id };
+            const channel = yield ctx.client.request('channel.get', input);
+            const total = num(channel === null || channel === void 0 ? void 0 : channel.chatNo, 0);
+            if (total <= snap.lastNo)
+                return; // already latest
+            const cap = num(this.options.cap, 50) || 50;
+            const floor = Math.max(snap.lastNo, total - cap); // below this is left for lazy-load
+            const acc = [];
+            let cursor;
+            for (let page = 0; page < 64; page += 1) {
+                const res = (yield ctx.client.request('chat.feed', Object.assign({ channelId: target.id }, (cursor ? { cursorNo: cursor } : {}))));
+                const list = ((_c = res === null || res === void 0 ? void 0 : res.list) !== null && _c !== void 0 ? _c : []);
+                let stop = false;
+                for (const m of list) {
+                    const mno = num(m.chatNo, 0);
+                    if (mno <= floor) {
+                        stop = true;
+                        break;
+                    }
+                    acc.push(m);
+                }
+                const cn = num(res === null || res === void 0 ? void 0 : res.cursorNo, 0);
+                if (stop || cn <= 0 || !list.length)
+                    break;
+                cursor = cn;
+            }
+            acc.sort((a, b) => num(a.chatNo, 0) - num(b.chatNo, 0));
+            if (floor === snap.lastNo) {
+                this.appendContiguous(target, ctx, snap, acc); // gap within cap: contiguous extend
+            }
+            else {
+                // Large gap: reset to the newest window and set lastNo to total, which avoids a re-fetch loop.
+                const win = this.clampWindow(acc, floor + 1);
+                const next = { id: snap.id, lastNo: total, minNo: win.minNo, messages: win.messages };
+                ctx.writeSnapshot(target, next);
+                (_e = (_d = this.options).onApply) === null || _e === void 0 ? void 0 : _e.call(_d, target, acc, next);
+            }
+        });
+        this.idleBackoff = (_a = options.idleBackoff) !== null && _a !== void 0 ? _a : { factor: 2, maxMs: 60000 };
+    }
+    // --- internals ---
+    /** Serialize read-modify-write per channel; the scheduler does not serialize onTrigger. */
+    serialize(key, task) {
+        var _a;
+        const prev = (_a = this.chains.get(key)) !== null && _a !== void 0 ? _a : Promise.resolve();
+        const next = prev.then(task, task);
+        this.chains.set(key, next.then(() => undefined, () => undefined));
+        return next;
+    }
+    readSnap(target, ctx) {
+        var _a;
+        const prev = ctx.readSnapshot(target);
+        if (prev)
+            return prev;
+        return { id: `${(_a = target.id) !== null && _a !== void 0 ? _a : ''}`, lastNo: 0, minNo: 0, messages: [] };
+    }
+    /** Append the contiguous `lastNo + 1 ..` run to the top of the window; gaps and duplicates are skipped. */
+    appendContiguous(target, ctx, snap, ascending) {
+        var _a, _b;
+        const applied = [];
+        const messages = snap.messages.slice();
+        let lastNo = snap.lastNo;
+        let minNo = snap.minNo;
+        for (const m of ascending) {
+            const mno = num(m.chatNo, 0);
+            if (mno !== lastNo + 1)
+                continue;
+            messages.push(m);
+            lastNo = mno;
+            if (minNo === 0)
+                minNo = mno;
+            applied.push(m);
+        }
+        if (!applied.length)
+            return;
+        const win = this.clampWindow(messages, minNo);
+        const next = { id: snap.id, lastNo, minNo: win.minNo, messages: win.messages };
+        ctx.writeSnapshot(target, next);
+        (_b = (_a = this.options).onApply) === null || _b === void 0 ? void 0 : _b.call(_a, target, applied, next);
+    }
+    /** Trim the window to `maxMessages`, dropping the oldest and advancing `minNo`. */
+    clampWindow(messages, minNo) {
+        var _a;
+        const max = num(this.options.maxMessages, 500) || 500;
+        if (messages.length <= max)
+            return { messages, minNo };
+        const trimmed = messages.slice(messages.length - max);
+        return { messages: trimmed, minNo: num((_a = trimmed[0]) === null || _a === void 0 ? void 0 : _a.chatNo, minNo) };
+    }
+}
+exports.ChatSyncPlan = ChatSyncPlan;

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

@@ -1,6 +1,5 @@
 import type { InferSocketRequest, SocketRequestMessage } from '../types';
-import type { ChannelStereo } from '../../modules/chat/types';
-import type { ChannelView } from '../../modules/chat/views';
+import type { ChannelStereo, ChannelView } from '../chat/views';
 export interface ChannelCreateRequestData {
     stereo: ChannelStereo;
     name?: string;

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

@@ -1,4 +1,5 @@
-import type { InferSocketRequest, SocketRequestMessage } from '../types';
+import type { InferSocketRequest, SocketMessage, SocketRequestMessage } from '../types';
+import type { ChatView } from './views';
 export interface ChatSendRequestData {
     channelId: string;
     content: string;
@@ -77,3 +78,7 @@ export declare type ChatDeleteRequestMessage = SocketRequestMessage<ChatDeleteTy
 export declare type ChatGetType = 'chat.get';
 export declare type ChatGetInput = InferSocketRequest<ChatGetType>;
 export declare type ChatGetRequestMessage = SocketRequestMessage<ChatGetType>;
+/** chat.sync — 서버→클라 push(broadcast). data 자체가 append된 메시지(fat payload). nudge 아님. */
+export declare type ChatSyncType = 'chat.sync';
+export declare type ChatSyncData = ChatView;
+export declare type ChatSyncMessage = SocketMessage<ChatSyncData>;

package/dist/lib/chat/views.d.ts

@@ -0,0 +1,62 @@
+/**
+ * `lib/chat/views.ts`
+ * - client-safe shared chat-domain views (channel/chat/join).
+ * - keep this file free from server-only deps (`modules/*`, `cores`) so the published
+ *   client SDK declaration build does not pull the chat model graph into its `.d.ts`.
+ * - mirrors the model-decoupled `DeviceView` pattern in `lib/device/contracts.ts`.
+ */
+import type { DeviceView } from '../device/contracts';
+export declare type ChannelStereo = '' | 'dm' | 'self' | 'public' | 'private';
+export declare type ChatStereo = 'text' | 'join' | 'leave' | 'system';
+export declare type JoinStereo = '';
+/** chat room state shared across websocket client/server contracts. */
+export interface ChannelView {
+    id?: string;
+    name?: string;
+    stereo?: ChannelStereo;
+    desc?: string;
+    ownerId?: string;
+    /** last chat sequence in this channel */
+    chatNo?: number;
+    /** joined device ids */
+    memberIds?: string[];
+    createdAt?: number;
+    updatedAt?: number;
+    deletedAt?: number;
+    /** (linked) owner info */
+    readonly owner$?: DeviceView;
+    /** (linked) last chat info */
+    readonly lastChat$?: ChatView;
+    /** (linked) device's channel connection view */
+    readonly $join?: JoinView;
+}
+/** message or channel event. */
+export interface ChatView {
+    /** id = `${channelId}:${chatNo}` */
+    id?: string;
+    stereo?: ChatStereo;
+    /** channel-local sequence */
+    chatNo?: number;
+    content?: string;
+    contentType?: string;
+    channelId?: string;
+    ownerId?: string;
+    createdAt?: number;
+    updatedAt?: number;
+    deletedAt?: number;
+}
+/** channel membership and read cursor. */
+export interface JoinView {
+    /** id = `${channelId}:${ownerId}` */
+    id?: string;
+    stereo?: JoinStereo;
+    channelId?: string;
+    ownerId?: string;
+    /** last read chat sequence */
+    chatNo?: number;
+    /** current joined state for API/view consumers. */
+    readonly joined?: boolean;
+    createdAt?: number;
+    updatedAt?: number;
+    deletedAt?: number;
+}

package/dist/lib/chat/views.js

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

package/package.json

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

package/dist/modules/chat/model.d.ts

@@ -1,107 +0,0 @@
-/**
- * `model.ts`
- * - model definitions for chat module.
- */
-import { CoreModel } from 'lemon-model';
-import $LUT, { ChannelStereo, ChatStereo, JoinStereo } from './types';
-/**
- * type: `ModelType`
- */
-export declare type ModelType = keyof typeof $LUT.ModelType;
-/**
- * type: `Model`: common model
- */
-export declare type Model = CoreModel<ModelType>;
-/**
- * interface: `ChannelHead`
- */
-export interface ChannelHead {
-    /** id of channel */
-    id?: string;
-    /** name of channel */
-    name?: string;
-}
-/**
- * interface: `ChannelModel`
- * - chat room state.
- */
-export interface ChannelModel extends Model, ChannelHead {
-    /** id of model */
-    id?: string;
-    /** name of channel */
-    name?: string;
-    /** channel stereo */
-    stereo?: ChannelStereo;
-    /** optional description */
-    desc?: string;
-    /** owner id (P1 uses deviceId) */
-    ownerId?: string;
-    /** last chat sequence in this channel */
-    chatNo?: number;
-    /** joined device ids */
-    memberIds?: string[];
-}
-/**
- * interface: `ChatModel`
- * - message or channel event.
- */
-export interface ChatModel extends Model {
-    /** id = `${channelId}:${chatNo}` */
-    id?: string;
-    /** chat event kind */
-    stereo?: ChatStereo;
-    /** channel-local sequence */
-    chatNo?: number;
-    /** message content */
-    content?: string;
-    /** message content type. v1 only uses text. */
-    contentType?: string;
-    /** parent channel id */
-    channelId?: string;
-    /** owner id. v1 uses deviceId. */
-    ownerId?: string;
-}
-/**
- * interface: `JoinModel`
- * - channel membership and read cursor.
- */
-export interface JoinModel extends Model {
-    /** id = `${channelId}:${ownerId}` */
-    id?: string;
-    /** join stereo. v1 only uses empty string. */
-    stereo?: JoinStereo;
-    /** joined channel id */
-    channelId?: string;
-    /** owner id. v1 uses deviceId. */
-    ownerId?: string;
-    /** last read chat sequence */
-    chatNo?: number;
-    /** current joined state. 1 = joined, 0 = left. */
-    joined?: number;
-}
-/**
- * extract field names from models
- * - only fields start with lowercase, or all upper.
- */
-export declare const filterFields: (fields: string[], base?: string[]) => string[];
-/** field names from head */
-export declare const $HEAD: {
-    channel: string[];
-};
-export declare const $FIELD: {
-    channel: string[];
-    chat: string[];
-    join: string[];
-};
-/** must export default as below */
-declare const _default: {
-    $HEAD: {
-        channel: string[];
-    };
-    $FIELD: {
-        channel: string[];
-        chat: string[];
-        join: string[];
-    };
-};
-export default _default;

package/dist/modules/chat/model.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.$FIELD = exports.$HEAD = exports.filterFields = void 0;
-const field_registry_1 = require("../../generated/field-registry");
-/**
- * extract field names from models
- * - only fields start with lowercase, or all upper.
- */
-const filterFields = (fields, base = []) => fields
-    .filter(field => field !== '_id' && /^[a-z_][a-zA-Z_]+/.test(field))
-    .reduce((L, k) => {
-    if (k && !L.includes(k))
-        L.push(k);
-    return L;
-}, [...base]);
-exports.filterFields = filterFields;
-/** field names from head */
-exports.$HEAD = {
-    channel: (0, exports.filterFields)(field_registry_1.fieldKeys.channelHead()),
-};
-// extract field names from models
-exports.$FIELD = {
-    channel: (0, exports.filterFields)(field_registry_1.fieldKeys.channelModel(), ['meta']),
-    chat: (0, exports.filterFields)(field_registry_1.fieldKeys.chatModel(), ['meta']),
-    join: (0, exports.filterFields)(field_registry_1.fieldKeys.joinModel(), ['meta']),
-};
-/** must export default as below */
-exports.default = { $HEAD: exports.$HEAD, $FIELD: exports.$FIELD };

package/dist/modules/chat/types.d.ts

@@ -1,65 +0,0 @@
-/**
- * `types.ts`
- * - basic types for chat module.
- */
-/**
- * Lookup Table
- *
- * WARN! DO NOT EXPORT AS `$LUT`. use default export instead.
- */
-declare const $LUT: {
-    /**
-     * Possible type of model.
-     */
-    ModelType: {
-        /** channel model */
-        channel: string;
-        /** chat model */
-        chat: string;
-        /** join model */
-        join: string;
-    };
-    /**
-     * ChannelStereo
-     */
-    ChannelStereo: {
-        '': string;
-        /** direct message (1:1) */
-        dm: string;
-        /** self memo channel */
-        self: string;
-        /** open channel */
-        public: string;
-        /** invite-only channel */
-        private: string;
-    };
-    /**
-     * ChatStereo
-     */
-    ChatStereo: {
-        text: string;
-        join: string;
-        leave: string;
-        system: string;
-    };
-    /**
-     * JoinStereo
-     */
-    JoinStereo: {
-        '': string;
-    };
-};
-/**
- * type: `ChannelStereo`
- */
-export declare type ChannelStereo = keyof typeof $LUT.ChannelStereo;
-/**
- * type: `ChatStereo`
- */
-export declare type ChatStereo = keyof typeof $LUT.ChatStereo;
-/**
- * type: `JoinStereo`
- */
-export declare type JoinStereo = keyof typeof $LUT.JoinStereo;
-/** must export $LUT as default */
-export default $LUT;

package/dist/modules/chat/types.js

@@ -1,55 +0,0 @@
-"use strict";
-/**
- * `types.ts`
- * - basic types for chat module.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Lookup Table
- *
- * WARN! DO NOT EXPORT AS `$LUT`. use default export instead.
- */
-const $LUT = {
-    /**
-     * Possible type of model.
-     */
-    ModelType: {
-        /** channel model */
-        channel: 'channel',
-        /** chat model */
-        chat: 'chat',
-        /** join model */
-        join: 'join',
-    },
-    /**
-     * ChannelStereo
-     */
-    ChannelStereo: {
-        '': '',
-        /** direct message (1:1) */
-        dm: 'dm',
-        /** self memo channel */
-        self: 'self',
-        /** open channel */
-        public: 'public',
-        /** invite-only channel */
-        private: 'private',
-    },
-    /**
-     * ChatStereo
-     */
-    ChatStereo: {
-        text: 'text',
-        join: 'join',
-        leave: 'leave',
-        system: 'system',
-    },
-    /**
-     * JoinStereo
-     */
-    JoinStereo: {
-        '': '',
-    },
-};
-/** must export $LUT as default */
-exports.default = $LUT;

package/dist/modules/chat/views.d.ts

@@ -1,50 +0,0 @@
-/**
- * `views.ts`
- * - type of views used in chat module.
- */
-import { View, Body } from 'lemon-model';
-import { ChannelModel, ChatModel, JoinModel } from './model';
-import $LUT from './types';
-import type { DeviceView } from '../sockets/views';
-export * from './types';
-export default $LUT;
-/**
- * type: `ChannelView`
- */
-export interface ChannelView extends View, Partial<ChannelModel> {
-    /** (linked) owner info */
-    readonly owner$?: DeviceView;
-    /** (linked) last chat info */
-    readonly lastChat$?: ChatView;
-    /** (readonly) device's channel connection view */
-    readonly $join?: JoinView;
-}
-/**
- * Type `ChannelBody`
- */
-export interface ChannelBody extends Body, Partial<ChannelView> {
-}
-/**
- * type: `ChatView`
- */
-export interface ChatView extends View, Partial<ChatModel> {
-}
-/**
- * Type `ChatBody`
- */
-export interface ChatBody extends Body, Partial<ChatView> {
-}
-/**
- * type: `JoinView`
- */
-export interface JoinView extends Omit<View, 'joined'>, Omit<Partial<JoinModel>, 'joined'> {
-    /**
-     * current joined state for API/view consumers.
-     */
-    readonly joined?: boolean;
-}
-/**
- * Type `JoinBody`
- */
-export interface JoinBody extends Body, Partial<JoinView> {
-}

package/dist/modules/chat/views.js

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

package/dist/modules/sockets/model.d.ts

@@ -1,206 +0,0 @@
-/**
- * `model.ts`
- * - model definitions per account data
- *
- * @author      Steve <steve@lemoncloud.io>
- * @date        2022-08-29 initial version.
- * @author      Aiden <aiden@lemocloud.io>
- * @date        2025-07-23 refactored for sockets service
- *
- * Copyright (C) 2022 LemonCloud Co Ltd. - All Rights Reserved.
- */
-import { CoreModel } from 'lemon-model';
-import $LUT, { DevicePlatform, DeviceStatus, ViewingType } from './types';
-import type { ChannelHead } from '../chat/model';
-/**
- * type: `ModelType`
- */
-export declare type ModelType = keyof typeof $LUT.ModelType;
-/**
- * type: `Model`: common model
- */
-export declare type Model = CoreModel<ModelType>;
-/**
- * interface: `SocketModel`
- */
-export interface SocketModel extends Model {
-    /** id of model */
-    id?: string;
-    /** name of model */
-    name?: string;
-}
-/**
- * interface: `ConnectionModel`
- * - a model for each connection to websocket.
- * - 웹소켓 연결 정보를 저장하는 모델
- */
-export interface ConnectionModel extends Model {
-    /**
-     * as `conn-id`
-     */
-    id?: string;
-    /**
-     * stereo type as initial `role`.
-     */
-    stereo?: string;
-    /**
-     * (required) The deployment stage of the API (e.g., 'dev', 'prod').
-     */
-    stage?: string;
-    /**
-     * (required) The domain name of the WebSocket API.
-     */
-    domain?: string;
-    /**
-     * (required) The API Gateway ID for Management API endpoint.
-     */
-    apiId?: string;
-    /**
-     * (required) The unique identifier for the WebSocket connection.
-     */
-    connectionId?: string;
-    /** (optional) if it has valid session infor. */
-    hasSession?: number;
-    /** (internal) Timestamp when the connection was established. */
-    connectedAt?: number;
-    /** (internal) Timestamp when the connection was terminated. */
-    disConnectedAt?: number;
-    /** (internal) version no */
-    versionNo?: number;
-    /** (internal) tracking no */
-    no?: number;
-    /**
-     * (extended) The origin of the request.
-     */
-    origin?: string;
-    /**
-     * (extended) The remote IP address of the client.
-     */
-    remote?: string;
-    /**
-     * (extended) The User-Agent string of the client.
-     */
-    agent?: string;
-    /**
-     * (extended) The reason for disconnection, if applicable.
-     */
-    reason?: string;
-    /**
-     * (extended) The code of disconnection.
-     */
-    disconnectCode?: number;
-    /**
-     * (extended) TTL for auto-deletion (ts)
-     */
-    ttl?: number;
-    /**
-     * (internal) ping-pong count
-     */
-    readonly count?: number;
-    /**
-     * (linked) 현재 연결이 구독 중인 채널(토픽) ID 목록
-     *
-     * @deprecated no more supported (see `chatic-socials-api`)
-     */
-    channels?: string[];
-    /**
-     * @deprecated  no longer in use (Channel management has been delegated to chatic-socials-api)
-     */
-    channel$$?: ChannelHead[];
-    /**
-     * (linked) device id for state sync
-     * NOTE it must be 1:1 matching with device.
-     * - `Device` has the major one connection.
-     * - `Connection` is belong to single `Device`.
-     */
-    deviceId?: string;
-    /** (internal) identity-id */
-    identityId?: string;
-    /** (internal) verified roles */
-    roles?: string[];
-    /** (internal) delegator-id — 소셜 로그인 시 게스트유저 uid */
-    did?: string;
-    /**
-     * (internal) connected device-info
-     */
-    readonly $device?: DeviceModel;
-}
-/**
- * interface: `DeviceHead`
- */
-export interface DeviceHead {
-    /** id of model */
-    id?: string;
-    /** name of model */
-    name?: string;
-}
-/**
- * interface: `DeviceModel` (종단 기기)ㅊ
- * - 디바이스 정보 관리 모델
- * - 그럼, 여기에서는 ENDPOINT 간의 상태 동기화
- *
- * ex) 브라우저 창, 네이티브 앱, 노드기반 클라이언트.
- */
-export interface DeviceModel extends Model, DeviceHead {
-    /** device-id (클라이언트에서 생성된 UUID) */
-    id?: string;
-    /** name of model */
-    name?: string;
-    /** device platform */
-    platform?: DevicePlatform;
-    /** status of device (for sync) */
-    status?: DeviceStatus;
-    /** tick count (for sync) */
-    tick?: number;
-    /** x position (for sync) */
-    posX?: number;
-    /** y position (for sync) */
-    posY?: number;
-    /** 현재 보고 있는 대상 종류 (예: 'channel') */
-    viewingType?: ViewingType;
-    /** 현재 보고 있는 대상 id */
-    viewingId?: string;
-    /** 현재 대상 진입 시각(ms) */
-    viewingSince?: number;
-    /** last activity timestamp */
-    lastActiveAt?: number;
-    /** connection start timestamp */
-    connectedAt?: number;
-    /** last disconnection timestamp */
-    disconnectedAt?: number;
-    /** (internal) connection-id */
-    connId?: string;
-    /** joined channel ids */
-    channelIds?: string[];
-    /**
-     * (internal) owner user-id
-     * - 푸시 전송 시, 타겟 유저 ID 매핑을 위해 이용됨.
-     * */
-    readonly userId?: string;
-}
-/**
- * extract field names from models
- * - only fields start with lowercase, or all upper.
- */
-export declare const filterFields: (fields: string[], base?: string[]) => string[];
-/** field names from head */
-export declare const $HEAD: {
-    device: string[];
-};
-export declare const $FIELD: {
-    socket: string[];
-    connection: string[];
-    device: string[];
-};
-/** must export default as below */
-declare const _default: {
-    $HEAD: {
-        device: string[];
-    };
-    $FIELD: {
-        socket: string[];
-        connection: string[];
-        device: string[];
-    };
-};
-export default _default;

package/dist/modules/sockets/model.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.$FIELD = exports.$HEAD = exports.filterFields = void 0;
-const field_registry_1 = require("../../generated/field-registry");
-/**
- * extract field names from models
- * - only fields start with lowercase, or all upper.
- */
-const filterFields = (fields, base = []) => fields
-    .filter(field => field !== '_id' && /^[a-z_][a-zA-Z_]+/.test(field))
-    .reduce((L, k) => {
-    if (k && !L.includes(k))
-        L.push(k);
-    return L;
-}, [...base]);
-exports.filterFields = filterFields;
-/** field names from head */
-exports.$HEAD = {
-    device: (0, exports.filterFields)(field_registry_1.fieldKeys.deviceHead()),
-};
-// extract field names from models
-exports.$FIELD = {
-    socket: (0, exports.filterFields)(field_registry_1.fieldKeys.socketModel(), ['meta']),
-    connection: (0, exports.filterFields)(field_registry_1.fieldKeys.connectionModel(), ['meta']),
-    device: (0, exports.filterFields)(field_registry_1.fieldKeys.deviceModel(), ['meta']),
-};
-/** must export default as below */
-exports.default = { $HEAD: exports.$HEAD, $FIELD: exports.$FIELD };

package/dist/modules/sockets/types.d.ts

@@ -1,100 +0,0 @@
-/**
- * `types.ts`
- * - 기본 types used in `backend-proxy`
- *
- * **[중요! exports 순서]**
- * 1. define data type in `types.ts` w/ internal types.
- * 2. define Model in `model.ts`
- * 3. define View/Body in `view.ts`, and external types.
- *
- * @author      Steve <steve@lemoncloud.io>
- * @date        2022-08-29 initial version.
- * @author      Aiden <aiden@lemocloud.io>
- * @date        2025-07-23 refactored for sockets service
- *
- * Copyright (C) 2022 LemonCloud Co Ltd. - All Rights Reserved.
- */
-/**
- * Lookup Table
- *
- * WARN! DO NOT EXPORT AS `$LUT`. use default export instead.
- */
-declare const $LUT: {
-    /**
-     * Possible type of model.
-     */
-    ModelType: {
-        /** socket model */
-        socket: string;
-        /** connection model */
-        connection: string;
-        /** device model */
-        device: string;
-    };
-    /**
-     * DeviceStatus
-     */
-    DeviceStatus: {
-        '': string;
-        /** green - online */
-        green: string;
-        /** red - offline */
-        red: string;
-        /** yellow - away/idle */
-        yellow: string;
-    };
-    /**
-     * DeviceEventType
-     */
-    DeviceEventType: {
-        '': string;
-        /** ping - heartbeat */
-        ping: string;
-        /** status - status change */
-        status: string;
-    };
-    /**
-     * ViewingType — 현재 보고 있는 대상 종류
-     */
-    ViewingType: {
-        '': string;
-        /** channel */
-        channel: string;
-    };
-    /**
-     * DevicePlatform
-     */
-    DevicePlatform: {
-        '': string;
-        /** iOS */
-        ios: string;
-        /** Android */
-        android: string;
-        /** Web browser */
-        web: string;
-        /** macOS */
-        macos: string;
-        /** Windows */
-        windows: string;
-        /** Linux */
-        linux: string;
-    };
-};
-/**
- * type: `DeviceStatus`
- */
-export declare type DeviceStatus = keyof typeof $LUT.DeviceStatus;
-/**
- * type: `DeviceEventType`
- */
-export declare type DeviceEventType = keyof typeof $LUT.DeviceEventType;
-/**
- * type: `ViewingType`
- */
-export declare type ViewingType = keyof typeof $LUT.ViewingType;
-/**
- * type: `DevicePlatform`
- */
-export declare type DevicePlatform = keyof typeof $LUT.DevicePlatform;
-/** must export $LUT as default */
-export default $LUT;

package/dist/modules/sockets/types.js

@@ -1,86 +0,0 @@
-"use strict";
-/**
- * `types.ts`
- * - 기본 types used in `backend-proxy`
- *
- * **[중요! exports 순서]**
- * 1. define data type in `types.ts` w/ internal types.
- * 2. define Model in `model.ts`
- * 3. define View/Body in `view.ts`, and external types.
- *
- * @author      Steve <steve@lemoncloud.io>
- * @date        2022-08-29 initial version.
- * @author      Aiden <aiden@lemocloud.io>
- * @date        2025-07-23 refactored for sockets service
- *
- * Copyright (C) 2022 LemonCloud Co Ltd. - All Rights Reserved.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Lookup Table
- *
- * WARN! DO NOT EXPORT AS `$LUT`. use default export instead.
- */
-const $LUT = {
-    /**
-     * Possible type of model.
-     */
-    ModelType: {
-        /** socket model */
-        socket: 'socket',
-        /** connection model */
-        connection: 'connection',
-        /** device model */
-        device: 'device',
-    },
-    /**
-     * DeviceStatus
-     */
-    DeviceStatus: {
-        '': '',
-        /** green - online */
-        green: 'green',
-        /** red - offline */
-        red: 'red',
-        /** yellow - away/idle */
-        yellow: 'yellow',
-    },
-    /**
-     * DeviceEventType
-     */
-    DeviceEventType: {
-        '': '',
-        /** ping - heartbeat */
-        ping: 'ping',
-        /** status - status change */
-        status: 'status',
-    },
-    /**
-     * ViewingType — 현재 보고 있는 대상 종류
-     */
-    ViewingType: {
-        '': '',
-        /** channel */
-        channel: 'channel',
-    },
-    /**
-     * DevicePlatform
-     */
-    DevicePlatform: {
-        '': '',
-        /** iOS */
-        ios: 'ios',
-        /** Android */
-        android: 'android',
-        /** Web browser */
-        web: 'web',
-        /** macOS */
-        macos: 'macos',
-        /** Windows */
-        windows: 'windows',
-        /** Linux */
-        linux: 'linux',
-    },
-};
-/** must export $LUT as default */
-exports.default = $LUT;

package/dist/modules/sockets/views.d.ts

@@ -1,67 +0,0 @@
-/**
- * `views.ts`
- * - type of views used in `backend-proxy`
- *
- * @author      Steve <steve@lemoncloud.io>
- * @date        2022-08-29 initial version.
- * @author      Aiden <aiden@lemoncloud.io>
- * @date        2024-07-23 refactored for sockets service
- *
- * Copyright (C) 2022 LemonCloud Co Ltd. - All Rights Reserved.
- */
-import { View, Body } from 'lemon-model';
-import { ConnectionModel, DeviceModel, SocketModel } from './model';
-import $LUT from './types';
-export * from './types';
-export default $LUT;
-/**!SECTION */
-/**
- * type: `SocketView`
- * - usually same as post's body.
- */
-export interface SocketView extends View, Partial<SocketModel> {
-}
-/**
- * Type `SocketBody`
- */
-export interface SocketBody extends Body, Partial<SocketView> {
-}
-/**
- * type: `ConnectionView`
- * - usually same as post's body.
- */
-export interface ConnectionView extends View, Omit<Partial<ConnectionModel>, '$device'> {
-    /** (internal) connected device info */
-    readonly $device?: DeviceView;
-}
-/**
- * Type `ConnectionBody`
- */
-export interface ConnectionBody extends Body, Partial<ConnectionView> {
-}
-/**
- * type: `DeviceView`
- */
-export interface DeviceView extends View, Partial<DeviceModel> {
-}
-/**
- * Type `DeviceBody`
- */
-export interface DeviceBody extends Body, Partial<DeviceView> {
-}
-/**
- * type: `ServerPingResultView`
- * - 서버에서 커넥션 ping 테스트 결과
- */
-export interface ServerPingResultView {
-    /** 대상 connectionId */
-    connId: string;
-    /** ping 시도 시간 (timestamp) */
-    pingedAt: number;
-    /** 최종 활성 상태 */
-    isActive: boolean;
-    /** cleanup 수행 여부 */
-    isCleaned?: boolean;
-    /** 현재 connection 상태 */
-    $conn?: ConnectionView;
-}

package/dist/modules/sockets/views.js

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