@lemoncloud/chatic-sockets-lib 0.1.0 → 0.2.1

package/dist/lib/socket-actions.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * `socket-actions.ts`
+ * - supported wsv2 socket domain/action lookup table.
+ *
+ * Keep this file client-safe. It is used as a public type contract and must not
+ * import server-side modules.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SocketActionTypeLUT = void 0;
+/**
+ * lookup table
+ * - wsv2에서 공개/지원하는 socket action 목록
+ */
+exports.SocketActionTypeLUT = {
+    /**
+     * DomainType
+     * - message domain
+     */
+    DomainType: {
+        '': '',
+        /** system - builtin/system messages */
+        system: 'system',
+        /** sockets - socket connection helpers */
+        sockets: 'sockets',
+        /** device - client device state */
+        device: 'device',
+        /** auth - connection authentication */
+        auth: 'auth',
+        /** channel - chat channel operations */
+        channel: 'channel',
+        /** chat - chat message operations */
+        chat: 'chat',
+        /** user - user/site profile operations */
+        user: 'user',
+        /** cloud - cloud profile operations */
+        cloud: 'cloud',
+    },
+    /**
+     * SystemActionType
+     * - system 도메인 액션
+     */
+    SystemActionType: {
+        '': '',
+        /** ping - keep-alive request */
+        ping: 'ping',
+        /** pong - keep-alive response/event */
+        pong: 'pong',
+        /** info - connection/server information */
+        info: 'info',
+        /** message - generic system message */
+        message: 'message',
+        /** error - generic system error */
+        error: 'error',
+    },
+    /**
+     * SocketsActionType
+     * - sockets 도메인 액션
+     */
+    SocketsActionType: {
+        '': '',
+        /** find-connection - find or create current connection model */
+        'find-connection': 'find-connection',
+    },
+    /**
+     * DeviceActionType
+     * - device 도메인 액션
+     */
+    DeviceActionType: {
+        '': '',
+        /** save - create or update linked device */
+        save: 'save',
+        /** read - read linked or requested device */
+        read: 'read',
+        /** sync - client device state sync hint */
+        sync: 'sync',
+    },
+    /**
+     * AuthActionType
+     * - auth 도메인 액션
+     */
+    AuthActionType: {
+        '': '',
+        /** update - update authentication state for current connection */
+        update: 'update',
+    },
+    /**
+     * ChannelActionType
+     * - channel 도메인 액션
+     */
+    ChannelActionType: {
+        '': '',
+        /** create - create a channel */
+        create: 'create',
+        /** join - join a channel */
+        join: 'join',
+        /** leave - leave or kick from a channel */
+        leave: 'leave',
+        /** get-self - get or create personal channel */
+        'get-self': 'get-self',
+        /** mine - list my channels */
+        mine: 'mine',
+        /** list-user - list channel members */
+        'list-user': 'list-user',
+        /** invite - invite users to a channel */
+        invite: 'invite',
+        /** update - update channel information */
+        update: 'update',
+        /** update-join - update channel participation settings */
+        'update-join': 'update-join',
+        /** delete - delete a channel */
+        delete: 'delete',
+        /** sync - synchronize channel list/state */
+        sync: 'sync',
+        /** sync-users - synchronize channel users */
+        'sync-users': 'sync-users',
+        /** sync-site-profile - synchronize related site profile */
+        'sync-site-profile': 'sync-site-profile',
+        /** unreads - get unread message summary */
+        unreads: 'unreads',
+    },
+    /**
+     * ChatActionType
+     * - chat 도메인 액션
+     */
+    ChatActionType: {
+        '': '',
+        /** send - send chat message */
+        send: 'send',
+        /** read - mark chat message/channel as read */
+        read: 'read',
+        /** feed - get chat feed */
+        feed: 'feed',
+    },
+    /**
+     * UserActionType
+     * - user 도메인 액션
+     */
+    UserActionType: {
+        '': '',
+        /** invite - invite a user */
+        invite: 'invite',
+        /** invite-batch - invite multiple users */
+        'invite-batch': 'invite-batch',
+        /** my-site - list accessible sites */
+        'my-site': 'my-site',
+        /** make-site - create a site */
+        'make-site': 'make-site',
+        /** update-profile - update user profile */
+        'update-profile': 'update-profile',
+        /** update-site - update site profile */
+        'update-site': 'update-site',
+        /** get-site-profile - get site profile */
+        'get-site-profile': 'get-site-profile',
+        /** set-site-profile - set site profile */
+        'set-site-profile': 'set-site-profile',
+    },
+    /**
+     * CloudActionType
+     * - cloud 도메인 액션
+     */
+    CloudActionType: {
+        '': '',
+        /** update - update cloud profile */
+        update: 'update',
+    },
+};

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

@@ -0,0 +1,13 @@
+/**
+ * `socket-inputs.ts`
+ * - public socket message.data input type barrel.
+ *
+ * Keep this file type-only and client-safe.
+ */
+export type { AuthUpdateInput } from './auth/types';
+export type { DeviceGetInput, DeviceReadInput, DeviceSaveInput, DeviceSyncInput } from './device/types';
+export type { FindConnectionModelInput, SocketsFindConnectionInput } from './sockets/types';
+export type { ChatFeedInput, ChatReadInput, ChatSendInput } from './chat/types';
+export type { ChannelCreateInput, ChannelDeleteInput, ChannelGetSelfInput, ChannelInviteInput, ChannelJoinInput, ChannelLeaveInput, ChannelListMyInput, ChannelListUserInput, ChannelMineInput, ChannelSyncInput, ChannelSyncProfileInput, ChannelSyncSiteProfileInput, ChannelSyncUsersInput, ChannelUnreadsInput, ChannelUpdateInput, ChannelUpdateJoinInput, ChatDeleteChannelInput, ChatInviteInput, ChatLeaveInput, ChatMineInput, ChatStartInput, ChatUpdateChannelInput, ChatUpdateJoinInput, ChatUsersInput, JoinUpdateInput, } from './channel/types';
+export type { CloudUpdateInput, UpdateCloudInput } from './cloud/types';
+export type { UserGetSiteProfileInput, UserInviteBatchInput, UserInviteInput, UserMakeSiteInput, UserMySiteInput, UserSetSiteProfileInput, UserUpdateProfileInput, UserUpdateSiteInput, } from './user/types';

package/dist/lib/socket-inputs.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * `socket-inputs.ts`
+ * - public socket message.data input type barrel.
+ *
+ * Keep this file type-only and client-safe.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,27 @@
+export * from './packets';
+export interface FindConnectionModelEvent {
+    id?: string;
+    stage?: string;
+    domain?: string;
+    apiId?: string;
+    connectionId?: string;
+    connectedAt?: number;
+    origin?: string;
+    remote?: string;
+    reason?: string;
+    agent?: string;
+    route?: string;
+    param?: {
+        [key: string]: string;
+    };
+}
+export interface FindConnectionModelInput {
+    event: FindConnectionModelEvent;
+}
+export declare type SocketsFindConnectionInput = FindConnectionModelInput;
+export interface FindConnectionModelOptions {
+    useSession?: boolean;
+    errScope?: string;
+    validate?: boolean;
+    current?: number;
+}

package/dist/lib/sockets/types.js

@@ -0,0 +1,17 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./packets"), exports);

package/dist/lib/types.d.ts

@@ -30,6 +30,8 @@ export interface SocketMessage<T = any, TType extends string = string> {
     meta?: SocketMessageMeta;
     /** optional error message */
     error?: string;
+    /** optional error code (HTTP status base); omitted when unclassified */
+    errorCode?: number;
 }
 /**
  * shared packet registry extension point.

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

@@ -0,0 +1,102 @@
+import type { InferSocketRequest, SocketRequestMessage } from '../types';
+export interface UserMakeSiteRequestData {
+    name: string;
+}
+export interface UserInviteRequestData {
+    channelId?: string;
+    name: string;
+    phone: string;
+}
+export interface UserInviteBatchRequestData {
+    to: string[];
+    channelId?: string;
+    cloudId?: string;
+    cloudName?: string;
+}
+export interface UserUpdateProfileRequestData {
+    name?: string;
+    nick?: string;
+    thumbnail?: string;
+}
+export interface UserUpdateSiteRequestData {
+    sid?: string;
+    name?: string;
+    thumbnail?: string;
+}
+export interface UserSetSiteProfileRequestData {
+    id?: string;
+    userId?: string;
+    siteId?: string;
+    nick?: string;
+    thumbnail?: string;
+    active?: boolean;
+    [key: string]: unknown;
+}
+declare module '../types' {
+    interface SocketPacketRegistry {
+        'user.get-site-profile': {
+            request: Record<string, never>;
+            response: unknown;
+            error: null;
+        };
+        'user.my-site': {
+            request: Record<string, never>;
+            response: unknown;
+            error: null;
+        };
+        'user.make-site': {
+            request: UserMakeSiteRequestData;
+            response: unknown;
+            error: null;
+        };
+        'user.invite': {
+            request: UserInviteRequestData;
+            response: unknown;
+            error: null;
+        };
+        'user.invite-batch': {
+            request: UserInviteBatchRequestData;
+            response: unknown;
+            error: null;
+        };
+        'user.update-profile': {
+            request: UserUpdateProfileRequestData;
+            response: unknown;
+            error: null;
+        };
+        'user.update-site': {
+            request: UserUpdateSiteRequestData;
+            response: unknown;
+            error: null;
+        };
+        'user.set-site-profile': {
+            request: UserSetSiteProfileRequestData;
+            response: unknown;
+            error: null;
+        };
+    }
+}
+export declare type UserGetSiteProfileType = 'user.get-site-profile';
+export declare type UserGetSiteProfileInput = InferSocketRequest<UserGetSiteProfileType>;
+export declare type UserGetSiteProfileRequestMessage = SocketRequestMessage<UserGetSiteProfileType>;
+export declare type UserMySiteType = 'user.my-site';
+export declare type UserMySiteInput = InferSocketRequest<UserMySiteType>;
+export declare type UserMySiteRequestMessage = SocketRequestMessage<UserMySiteType>;
+export declare type UserMakeSiteType = 'user.make-site';
+export declare type UserMakeSiteInput = InferSocketRequest<UserMakeSiteType>;
+export declare type UserMakeSiteRequestMessage = SocketRequestMessage<UserMakeSiteType>;
+export declare type UserInviteType = 'user.invite';
+export declare type UserInviteInput = InferSocketRequest<UserInviteType>;
+export declare type UserInviteRequestMessage = SocketRequestMessage<UserInviteType>;
+export declare type UserInviteBatchType = 'user.invite-batch';
+export declare type UserInviteBatchInput = InferSocketRequest<UserInviteBatchType>;
+export declare type UserInviteBatchRequestMessage = SocketRequestMessage<UserInviteBatchType>;
+export declare type UserUpdateProfileType = 'user.update-profile';
+export declare type UserUpdateProfileInput = InferSocketRequest<UserUpdateProfileType>;
+export declare type UserUpdateProfileRequestMessage = SocketRequestMessage<UserUpdateProfileType>;
+export declare type UserUpdateSiteType = 'user.update-site';
+export declare type UserUpdateSiteInput = InferSocketRequest<UserUpdateSiteType>;
+export declare type UserUpdateSiteRequestMessage = SocketRequestMessage<UserUpdateSiteType>;
+export declare type UserSetSiteProfileType = 'user.set-site-profile';
+export declare type UserSetSiteProfileInput = InferSocketRequest<UserSetSiteProfileType>;
+export declare type UserSetSiteProfileRequestMessage = SocketRequestMessage<UserSetSiteProfileType>;

package/dist/lib/user/types.js

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

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

@@ -0,0 +1,65 @@
+/**
+ * `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

@@ -0,0 +1,55 @@
+"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/package.json

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