@lemoncloud/chatic-sockets-lib 0.3.1 → 0.3.3

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/dist/lib/join/contracts.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `lib/join/contracts.ts`
+ * - client-safe join domain contracts.
+ * - keep this file free from server-only runtime dependencies.
+ */
+export declare type JoinNotify = '' | 'all' | 'mention' | 'none';
+/**
+ * client-safe join view shared across websocket client/server contracts.
+ * - mirrors the v1 (demo) JoinModel projection; the server `modelAsView` output is assignable to it.
+ * - socials responses are a superset and are injected as a concrete view by the consumer where needed.
+ * - kept free of `modules/*` imports so the published client `.d.ts` carries no server models.
+ */
+export interface JoinView {
+    id?: string;
+    channelId?: string;
+    ownerId?: string;
+    stereo?: string;
+    chatNo?: number;
+    joined?: boolean;
+    updatedAt?: number;
+}
+/** `join.get` request input — composite join id, client-supplied. */
+export interface JoinGetRequestBody {
+    id: string;
+}
+/** `join.update` request input — edit join metadata (nick/notify). */
+export interface JoinUpdateRequestBody {
+    id: string;
+    nick?: string;
+    notify?: JoinNotify;
+    role?: 'owner' | 'admin' | 'member' | string;
+}

package/dist/lib/join/contracts.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * `lib/join/contracts.ts`
+ * - client-safe join domain contracts.
+ * - keep this file free from server-only runtime dependencies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,31 @@
+import type { InferSocketError, InferSocketRequest, InferSocketResponse, SocketErrorMessage, SocketRequestMessage, SocketResponseMessage } from '../types';
+import type { JoinView, JoinGetRequestBody, JoinUpdateRequestBody } from './contracts';
+declare module '../types' {
+    interface SocketPacketRegistry {
+        'join.get': {
+            request: JoinGetRequestBody;
+            response: JoinView;
+            error: null;
+        };
+        'join.update': {
+            request: JoinUpdateRequestBody;
+            response: JoinView;
+            error: null;
+        };
+    }
+}
+export declare type JoinGetType = 'join.get';
+export declare type JoinGetResponseData = InferSocketResponse<JoinGetType>;
+export declare type JoinGetErrorData = InferSocketError<JoinGetType>;
+export declare type JoinGetInput = InferSocketRequest<JoinGetType>;
+export declare type JoinGetRequestMessage = SocketRequestMessage<JoinGetType>;
+export declare type JoinGetResponseMessage = SocketResponseMessage<JoinGetType>;
+export declare type JoinGetErrorMessage = SocketErrorMessage<JoinGetType>;
+export declare type JoinUpdateType = 'join.update';
+export declare type JoinUpdateResponseData = InferSocketResponse<JoinUpdateType>;
+export declare type JoinUpdateErrorData = InferSocketError<JoinUpdateType>;
+export declare type JoinUpdateInput = InferSocketRequest<JoinUpdateType>;
+export declare type JoinUpdateRequestMessage = SocketRequestMessage<JoinUpdateType>;
+export declare type JoinUpdateResponseMessage = SocketResponseMessage<JoinUpdateType>;
+export declare type JoinUpdateErrorMessage = SocketErrorMessage<JoinUpdateType>;
+export type { JoinView };

package/dist/lib/join/types.js

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

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

@@ -36,6 +36,8 @@ export declare const SocketActionTypeLUT: {
         readonly profile: "profile";
         /** cloud - cloud profile operations */
         readonly cloud: "cloud";
+        /** join - channel join/membership operations */
+        readonly join: "join";
     };
     /**
      * SystemActionType
@@ -188,6 +190,17 @@ export declare const SocketActionTypeLUT: {
         /** sync - synchronize site multi-profiles (delta since cursor) */
         readonly sync: "sync";
     };
+    /**
+     * JoinActionType
+     * - join 도메인 액션
+     */
+    readonly JoinActionType: {
+        readonly '': "";
+        /** get - get join record by composite id */
+        readonly get: "get";
+        /** update - update caller's join metadata (nick/notify) */
+        readonly update: "update";
+    };
     /**
      * CloudActionType
      * - cloud 도메인 액션
@@ -250,10 +263,14 @@ export declare type SocketProfileActionType = SocketActionKeyOf<typeof SocketAct
  * type: `SocketCloudActionType`
  */
 export declare type SocketCloudActionType = SocketActionKeyOf<typeof SocketActionTypeLUT.CloudActionType>;
+/**
+ * type: `SocketJoinActionType`
+ */
+export declare type SocketJoinActionType = SocketActionKeyOf<typeof SocketActionTypeLUT.JoinActionType>;
 /**
  * type: `SocketActionType`
  */
-export declare type SocketActionType = SocketSystemActionType | SocketSocketsActionType | SocketDeviceActionType | SocketAuthActionType | SocketChannelActionType | SocketChatActionType | SocketUserActionType | SocketPlaceActionType | SocketProfileActionType | SocketCloudActionType;
+export declare type SocketActionType = SocketSystemActionType | SocketSocketsActionType | SocketDeviceActionType | SocketAuthActionType | SocketChannelActionType | SocketChatActionType | SocketUserActionType | SocketPlaceActionType | SocketProfileActionType | SocketCloudActionType | SocketJoinActionType;
 /**
  * interface: `SocketActionTypeMap`
  * - domain to action type map
@@ -269,6 +286,7 @@ export interface SocketActionTypeMap {
     place: SocketPlaceActionType;
     profile: SocketProfileActionType;
     cloud: SocketCloudActionType;
+    join: SocketJoinActionType;
 }
 /**
  * type: `SocketSupportedDomainType`

package/dist/lib/socket-actions.js

@@ -39,6 +39,8 @@ exports.SocketActionTypeLUT = {
         profile: 'profile',
         /** cloud - cloud profile operations */
         cloud: 'cloud',
+        /** join - channel join/membership operations */
+        join: 'join',
     },
     /**
      * SystemActionType
@@ -191,6 +193,17 @@ exports.SocketActionTypeLUT = {
         /** sync - synchronize site multi-profiles (delta since cursor) */
         sync: 'sync',
     },
+    /**
+     * JoinActionType
+     * - join 도메인 액션
+     */
+    JoinActionType: {
+        '': '',
+        /** get - get join record by composite id */
+        get: 'get',
+        /** update - update caller's join metadata (nick/notify) */
+        update: 'update',
+    },
     /**
      * CloudActionType
      * - cloud 도메인 액션

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

@@ -13,3 +13,4 @@ export type { PlaceCreateInput, PlaceDeleteInput, PlaceGetInput, PlaceUpdateInpu
 export type { ProfileGetInput, ProfileGetMineInput, ProfileSetInput, ProfileSyncInput } from './profile/types';
 export type { CloudCreateInput, CloudDeleteInput, CloudGetInput, CloudUpdateInput, UpdateCloudInput, } from './cloud/types';
 export type { UserGetSiteProfileInput, UserInviteBatchInput, UserInviteInput, UserMakeSiteInput, UserMySiteInput, UserSetSiteProfileInput, UserUpdateProfileInput, UserUpdateSiteInput, } from './user/types';
+export type { JoinGetInput, JoinUpdateInput as JoinDomainUpdateInput } from './join/types';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lemoncloud/chatic-sockets-lib",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "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;