@juki-team/commons 0.1.31

package/dist/helpers/object.js

@@ -0,0 +1,32 @@
+function sizeOfObject(obj) {
+    const objClass = Object.prototype.toString.call(obj).slice(8, -1);
+    if (objClass !== 'Object' && objClass !== 'Array') {
+        return obj.toString().length * 2;
+    }
+    let bytes = 0;
+    for (const key in obj) {
+        if (!Object.hasOwn(obj, key))
+            continue;
+        bytes += key.length * 2 + sizeOf(obj[key]);
+    }
+    return bytes;
+}
+function sizeOf(obj) {
+    if (obj === null || obj === undefined)
+        return 0;
+    switch (typeof obj) {
+        case 'number':
+            return 8;
+        case 'string':
+            return obj.length * 2;
+        case 'boolean':
+            return 4;
+        case 'object':
+            return sizeOfObject(obj);
+        default:
+            return 0;
+    }
+}
+export function memorySizeOf(obj) {
+    return sizeOf(obj);
+}

package/dist/helpers/responses.d.ts

@@ -0,0 +1,8 @@
+import { JkError } from '../prototypes/index.js';
+import { type ContentResponse, type ContentsMeta, type ContentsResponse, type ErrorResponse } from '../types/index.js';
+export declare function toJkError(err: unknown): JkError;
+export declare function errorsResponse(message: string, ...errors: JkError[]): ErrorResponse;
+export declare function contentResponse<T>(message: string, content: T): ContentResponse<T>;
+export declare function contentsResponse<T>(message: string, contents: T[], meta: ContentsMeta): ContentsResponse<T>;
+export declare const cleanRequest: <T extends ContentResponse<unknown> | ContentsResponse<unknown>>(responseText: string) => ErrorResponse | T;
+export declare const getDefaultMeta: (contents: unknown[], sort?: ContentsMeta["sort"]) => ContentsMeta;

package/dist/helpers/responses.js

@@ -0,0 +1,78 @@
+import { getErrorMessage } from '../constants/index.js';
+import { JkError } from '../prototypes/index.js';
+import { ErrorCode, } from '../types/index.js';
+import { consoleError, isStringJson } from './commons.js';
+export function toJkError(err) {
+    const error = new Error();
+    let code = err?.code;
+    if (!Object.values(ErrorCode).includes(code)) {
+        code = ErrorCode.INTERNAL_SERVER_ERROR;
+    }
+    return new JkError(code, {
+        message: err?.message || error.message,
+        stack: err?.stack || error.stack,
+        data: err?.data || null,
+    });
+}
+export function errorsResponse(message, ...errors) {
+    return {
+        success: false,
+        message: message,
+        errors: errors.map((error) => ({
+            code: error.code,
+            message: error.message,
+            detail: error.stack || new Error().stack || '',
+            data: error.data,
+        })),
+    };
+}
+export function contentResponse(message, content) {
+    return {
+        success: true,
+        message,
+        content,
+    };
+}
+export function contentsResponse(message, contents, meta) {
+    return {
+        success: true,
+        message,
+        contents,
+        meta,
+    };
+}
+function parseSuccessJson(responseJson) {
+    if (responseJson.success === true && typeof responseJson.message === 'string') {
+        if (responseJson.content) {
+            return { success: true, message: responseJson.message, content: responseJson.content };
+        }
+        if (Array.isArray(responseJson.contents) && responseJson.meta) {
+            return { success: true, message: responseJson.message, contents: responseJson.contents, meta: responseJson.meta };
+        }
+    }
+    return null;
+}
+export const cleanRequest = (responseText) => {
+    if (!isStringJson(responseText)) {
+        const response = errorsResponse(getErrorMessage(ErrorCode.SERVICE_NOT_FOUND), new JkError(ErrorCode.SERVICE_NOT_FOUND));
+        consoleError({ message: 'response is not string json, success false on cleaning request', responseText, response });
+        return response;
+    }
+    const responseJson = JSON.parse(responseText);
+    if (typeof responseJson.success === 'boolean') {
+        const success = parseSuccessJson(responseJson);
+        if (success)
+            return success;
+        if (responseJson.success === false && typeof responseJson.message === 'string' && Array.isArray(responseJson.errors)) {
+            const response = { success: false, message: responseJson.message, errors: responseJson.errors };
+            consoleError({ message: 'success false on cleaning request', responseText, response });
+            return response;
+        }
+    }
+    const response = errorsResponse(getErrorMessage(ErrorCode.ERROR_ON_RESPONSE), new JkError(ErrorCode.ERROR_ON_RESPONSE));
+    consoleError({ message: 'success false on cleaning request', responseText, response });
+    return response;
+};
+export const getDefaultMeta = (contents, sort) => {
+    return { sort: sort ?? [], page: 1, size: contents.length, total: contents.length, filter: {} };
+};

package/dist/helpers/socket.d.ts

@@ -0,0 +1,45 @@
+import type { ChatCompletionsWebSocketEventDTO, ClientTrackDeviceWebSocketEventDTO, ClientTrackLocationWebSocketEventDTO, ClientTrackScreenshotWebSocketEventDTO, ClientTrackWebSocketResponseEventDTO, CodeRunStatusWebSocketResponseEventDTO, ContestChangesWebSocketResponseEventDTO, PingWebSocketEventDTO, PongWebSocketResponseEventDTO, ProblemCrawledWebSocketResponseEventDTO, SendDataChatCompletionsWebSocketResponseEventDTO, SendDataClientTrackWebSocketResponseEventDTO, SendDataEc2InstancesListWebSocketResponseEventDTO, SendDataEcsTaskDefinitionListWebSocketResponseEventDTO, SendDataEcsTasksListWebSocketResponseEventDTO, SendDataRunCommandWebSocketResponseEventDTO, SendDataSsmSessionsListWebSocketResponseEventDTO, SendDataWebSocketResponseEventDTO, SubmissionRunStatusWebSocketResponseEventDTO, SubmissionsCrawlWebSocketResponseEventDTO, SubscribeClientTrackWebSocketEventDTO, SubscribeCodeRunStatusWebSocketEventDTO, SubscribeContestChangesWebSocketEventDTO, SubscribeGetDataWebSocketEventDTO, SubscribeProblemCrawledWebSocketEventDTO, SubscribeSubmissionRunStatusWebSocketEventDTO, SubscribeSubmissionsCrawlWebSocketEventDTO, SubscribeUserNotificationWebsocketEventDTO, UnsubscribeClientTrackWebSocketEventDTO, UnsubscribeCodeRunStatusWebSocketEventDTO, UnsubscribeContestChangesWebSocketEventDTO, UnsubscribeGetDataWebSocketEventDTO, UnsubscribeProblemCrawledWebSocketEventDTO, UnsubscribeSubmissionRunStatusWebSocketEventDTO, UnsubscribeSubmissionsCrawlWebSocketEventDTO, UnsubscribeUserNotificationWebSocketEventDTO, UserMessageWebSocketResponseEventDTO, UserNotificationContestClarificationWebSocketResponseEventDTO, UserNotificationSubmissionWebSocketResponseEventDTO, UserNotificationWebSocketResponseEventDTO, WebSocketMessageEventDTO, WebSocketResponseEventDTO, WebSocketSubscribeEventDTO, WebSocketUnsubscribeEventDTO } from '../dto/index.js';
+import { type ClientId, WebSocketResponseEvent, type WebSocketResponseEventKey } from '../types/index.js';
+export declare const isWebsocketSubscription: (event: unknown) => event is WebSocketSubscribeEventDTO | WebSocketUnsubscribeEventDTO | WebSocketMessageEventDTO;
+export declare const isPingWebSocketEventDTO: (event: unknown) => event is PingWebSocketEventDTO;
+export declare const isClientTrackLocationWebSocketEventDTO: (event: unknown) => event is ClientTrackLocationWebSocketEventDTO;
+export declare const isClientTrackScreenshotWebSocketEventDTO: (event: unknown) => event is ClientTrackScreenshotWebSocketEventDTO;
+export declare const isClientTrackDeviceWebSocketEventDTO: (event: unknown) => event is ClientTrackDeviceWebSocketEventDTO;
+export declare const isChatCompletionsWebSocketEventDTO: (event: unknown) => event is ChatCompletionsWebSocketEventDTO;
+export declare const isSubscribeCodeRunStatusWebSocketEventDTO: (event: unknown) => event is SubscribeCodeRunStatusWebSocketEventDTO;
+export declare const isUnsubscribeCodeRunStatusWebSocketEventDTO: (event: unknown) => event is UnsubscribeCodeRunStatusWebSocketEventDTO;
+export declare const isSubscribeSubmissionRunStatusWebSocketEventDTO: (event: unknown) => event is SubscribeSubmissionRunStatusWebSocketEventDTO;
+export declare const isUnsubscribeSubmissionRunStatusWebSocketEventDTO: (event: unknown) => event is UnsubscribeSubmissionRunStatusWebSocketEventDTO;
+export declare const isSubscribeGetDataWebSocketEventDTO: (event: unknown) => event is SubscribeGetDataWebSocketEventDTO;
+export declare const isUnsubscribeGetDataWebSocketEventDTO: (event: unknown) => event is UnsubscribeGetDataWebSocketEventDTO;
+export declare const isSubscribeProblemCrawledWebSocketEventDTO: (event: unknown) => event is SubscribeProblemCrawledWebSocketEventDTO;
+export declare const isUnsubscribeProblemCrawledWebSocketEventDTO: (event: unknown) => event is UnsubscribeProblemCrawledWebSocketEventDTO;
+export declare const isSubscribeSubmissionsCrawlWebSocketEventDTO: (event: unknown) => event is SubscribeSubmissionsCrawlWebSocketEventDTO;
+export declare const isUnsubscribeSubmissionsCrawlWebSocketEventDTO: (event: unknown) => event is UnsubscribeSubmissionsCrawlWebSocketEventDTO;
+export declare const isSubscribeContestChangesWebSocketEventDTO: (event: unknown) => event is SubscribeContestChangesWebSocketEventDTO;
+export declare const isUnsubscribeContestChangesWebSocketEventDTO: (event: unknown) => event is UnsubscribeContestChangesWebSocketEventDTO;
+export declare const isSubscribeClientTrackWebSocketEventDTO: (event: unknown) => event is SubscribeClientTrackWebSocketEventDTO;
+export declare const isUnsubscribeClientTrackWebSocketEventDTO: (event: unknown) => event is UnsubscribeClientTrackWebSocketEventDTO;
+export declare const isSubscribeUserNotificationWebSocketEventDTO: (event: unknown) => event is SubscribeUserNotificationWebsocketEventDTO;
+export declare const isUnsubscribeUserNotificationWebSocketEventDTO: (event: unknown) => event is UnsubscribeUserNotificationWebSocketEventDTO;
+export declare const isWebSocketResponseEventDTO: (event: unknown) => event is WebSocketResponseEventDTO;
+export declare const isPongWebSocketResponseEventDTO: (event: unknown) => event is PongWebSocketResponseEventDTO;
+export declare const isCodeRunStatusMessageWebSocketResponseEventDTO: (event: unknown) => event is CodeRunStatusWebSocketResponseEventDTO;
+export declare const isSubmissionRunStatusMessageWebSocketResponseEventDTO: (event: unknown) => event is SubmissionRunStatusWebSocketResponseEventDTO;
+export declare const isUserMessageWebSocketResponseEventDTO: (event: unknown) => event is UserMessageWebSocketResponseEventDTO;
+export declare const isSendDataWebSocketResponseEventDTO: (event: unknown) => event is SendDataWebSocketResponseEventDTO;
+export declare const isSendDataEcsTaskDefinitionListWebSocketResponseEventDTO: (event: unknown) => event is SendDataEcsTaskDefinitionListWebSocketResponseEventDTO;
+export declare const isSendDataEc2InstancesListWebSocketResponseEventDTO: (event: unknown) => event is SendDataEc2InstancesListWebSocketResponseEventDTO;
+export declare const isSendDataEcsTasksListWebSocketResponseEventDTO: (event: unknown) => event is SendDataEcsTasksListWebSocketResponseEventDTO;
+export declare const isSendDataSsmSessionsListWebSocketResponseEventDTO: (event: unknown) => event is SendDataSsmSessionsListWebSocketResponseEventDTO;
+export declare const isSendDataRunCommandWebSocketResponseEventDTO: (event: unknown) => event is SendDataRunCommandWebSocketResponseEventDTO;
+export declare const isSendDataClientTrackWebSocketResponseEventDTO: (event: unknown) => event is SendDataClientTrackWebSocketResponseEventDTO;
+export declare const isSenDataChatCompletionsWebSocketResponseEventDTO: (event: unknown) => event is SendDataChatCompletionsWebSocketResponseEventDTO;
+export declare const isProblemCrawledWebSocketResponseEventDTO: (event: unknown) => event is ProblemCrawledWebSocketResponseEventDTO;
+export declare const isSubmissionsCrawlWebSocketResponseEventDTO: (event: unknown) => event is SubmissionsCrawlWebSocketResponseEventDTO;
+export declare const isContestChangesWebSocketResponseEventDTO: (event: unknown) => event is ContestChangesWebSocketResponseEventDTO;
+export declare const isClientTrackWebSocketResponseEventDTO: (event: unknown) => event is ClientTrackWebSocketResponseEventDTO;
+export declare const isUserNotificationWebSocketResponseEventDTO: (event: unknown) => event is UserNotificationWebSocketResponseEventDTO;
+export declare const isUserNotificationSubmissionWebSocketResponseEventDTO: (event: unknown) => event is UserNotificationSubmissionWebSocketResponseEventDTO;
+export declare const isUserNotificationContestClarificationWebSocketResponseEventDTO: (event: unknown) => event is UserNotificationContestClarificationWebSocketResponseEventDTO;
+export declare const getWebSocketResponseEventKey: (event: WebSocketResponseEvent, clientId: ClientId, id: string) => WebSocketResponseEventKey;

package/dist/helpers/socket.js

@@ -0,0 +1,238 @@
+import { ProblemVerdict, SubmissionRunStatus } from '../prisma/enums/index.js';
+import { WebSocketMessageEvent, WebSocketResponseEvent, WebSocketSubscriptionEvent, } from '../types/index.js';
+export const isWebsocketSubscription = (event) => {
+    if (typeof event !== 'object' || event === null)
+        return false;
+    const v = event;
+    return ((Object.values(WebSocketSubscriptionEvent).includes(v.event) ||
+        Object.values(WebSocketMessageEvent).includes(v.event)) &&
+        typeof v.clientId === 'string' &&
+        !!v.clientId);
+};
+// Custom CHANNEL_PUBLISH_MESSAGES
+export const isPingWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketMessageEvent.PING;
+};
+export const isClientTrackLocationWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketMessageEvent.CLIENT_TRACK_LOCATION;
+};
+export const isClientTrackScreenshotWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketMessageEvent.CLIENT_TRACK_SCREENSHOT;
+};
+export const isClientTrackDeviceWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketMessageEvent.CLIENT_TRACK_DEVICE;
+};
+export const isChatCompletionsWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketMessageEvent.CHAT_COMPLETIONS;
+};
+// CHANNEL_PUBLISH_SUBSCRIPTIONS
+export const isSubscribeCodeRunStatusWebSocketEventDTO = (event) => {
+    if (!isWebsocketSubscription(event))
+        return false;
+    const v = event;
+    return event.event === WebSocketSubscriptionEvent.SUBSCRIBE_CODE_RUN_STATUS && typeof v.runId === 'string' && !!v.runId;
+};
+export const isUnsubscribeCodeRunStatusWebSocketEventDTO = (event) => {
+    if (!isWebsocketSubscription(event))
+        return false;
+    const v = event;
+    return event.event === WebSocketSubscriptionEvent.UNSUBSCRIBE_CODE_RUN_STATUS && typeof v.runId === 'string' && !!v.runId;
+};
+export const isSubscribeSubmissionRunStatusWebSocketEventDTO = (event) => {
+    if (!isWebsocketSubscription(event))
+        return false;
+    const v = event;
+    return (event.event === WebSocketSubscriptionEvent.SUBSCRIBE_SUBMISSION_RUN_STATUS && typeof v.submitId === 'string' && !!v.submitId);
+};
+export const isUnsubscribeSubmissionRunStatusWebSocketEventDTO = (event) => {
+    if (!isWebsocketSubscription(event))
+        return false;
+    const v = event;
+    return (event.event === WebSocketSubscriptionEvent.UNSUBSCRIBE_SUBMISSION_RUN_STATUS &&
+        typeof v.submitId === 'string' &&
+        !!v.submitId);
+};
+export const isSubscribeGetDataWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketSubscriptionEvent.SUBSCRIBE_GET_DATA;
+};
+export const isUnsubscribeGetDataWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketSubscriptionEvent.UNSUBSCRIBE_GET_DATA;
+};
+export const isSubscribeProblemCrawledWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketSubscriptionEvent.SUBSCRIBE_PROBLEM_CRAWLED;
+};
+export const isUnsubscribeProblemCrawledWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketSubscriptionEvent.UNSUBSCRIBE_PROBLEM_CRAWLED;
+};
+export const isSubscribeSubmissionsCrawlWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketSubscriptionEvent.SUBSCRIBE_SUBMISSIONS_CRAWL;
+};
+export const isUnsubscribeSubmissionsCrawlWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketSubscriptionEvent.UNSUBSCRIBE_SUBMISSIONS_CRAWL;
+};
+export const isSubscribeContestChangesWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketSubscriptionEvent.SUBSCRIBE_CONTEST_CHANGES;
+};
+export const isUnsubscribeContestChangesWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketSubscriptionEvent.UNSUBSCRIBE_CONTEST_CHANGES;
+};
+export const isSubscribeClientTrackWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketSubscriptionEvent.SUBSCRIBE_CLIENT_TRACK;
+};
+export const isUnsubscribeClientTrackWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketSubscriptionEvent.UNSUBSCRIBE_CLIENT_TRACK;
+};
+export const isSubscribeUserNotificationWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketSubscriptionEvent.SUBSCRIBE_USER_NOTIFICATION;
+};
+export const isUnsubscribeUserNotificationWebSocketEventDTO = (event) => {
+    return isWebsocketSubscription(event) && event.event === WebSocketSubscriptionEvent.UNSUBSCRIBE_USER_NOTIFICATION;
+};
+// is WebSocketResponseEventDTO, CHANNEL_SUBSCRIBE_CLIENT
+export const isWebSocketResponseEventDTO = (event) => {
+    if (typeof event !== 'object' || event === null)
+        return false;
+    const v = event;
+    return (Object.values(WebSocketResponseEvent).includes(v.event) &&
+        typeof v.key === 'string' &&
+        typeof v.connectionId === 'string' &&
+        typeof v.messageTimestamp === 'number' &&
+        !!v.messageTimestamp);
+};
+export const isPongWebSocketResponseEventDTO = (event) => {
+    if (!isWebSocketResponseEventDTO(event))
+        return false;
+    const v = event;
+    return event.event === WebSocketResponseEvent.PONG && !!v.data;
+};
+export const isCodeRunStatusMessageWebSocketResponseEventDTO = (event) => {
+    if (!isWebSocketResponseEventDTO(event))
+        return false;
+    const v = event;
+    return (event.event === WebSocketResponseEvent.CODE_RUN_STATUS &&
+        typeof v.runId === 'string' &&
+        !!v.runId &&
+        v.status in SubmissionRunStatus);
+};
+export const isSubmissionRunStatusMessageWebSocketResponseEventDTO = (event) => {
+    if (!isWebSocketResponseEventDTO(event))
+        return false;
+    const v = event;
+    return (event.event === WebSocketResponseEvent.SUBMISSION_RUN_STATUS &&
+        typeof v.submitId === 'string' &&
+        !!v.submitId &&
+        v.status in SubmissionRunStatus &&
+        v.verdict in ProblemVerdict &&
+        typeof v.points === 'number');
+};
+export const isUserMessageWebSocketResponseEventDTO = (event) => {
+    if (!isWebSocketResponseEventDTO(event))
+        return false;
+    const v = event;
+    const user = v.user;
+    const company = user?.company;
+    return (event.event === WebSocketResponseEvent.USER_MESSAGE &&
+        typeof user?.nickname === 'string' &&
+        !!user.nickname &&
+        typeof user?.imageUrl === 'string' &&
+        !!user.imageUrl &&
+        typeof company?.key === 'string' &&
+        !!company.key &&
+        !!v.content);
+};
+export const isSendDataWebSocketResponseEventDTO = (event) => {
+    if (typeof event !== 'object' || event === null)
+        return false;
+    const v = event;
+    return ([
+        WebSocketResponseEvent.SEND_DATA_ECS_TASK_DEFINITIONS_LIST,
+        WebSocketResponseEvent.SEND_DATA_EC2_INSTANCES_LIST,
+        WebSocketResponseEvent.SEND_DATA_ECS_TASKS_LIST,
+        WebSocketResponseEvent.SEND_DATA_SSM_SESSIONS_LIST,
+        WebSocketResponseEvent.SEND_DATA_RUN_COMMAND,
+        WebSocketResponseEvent.SEND_DATA_CLIENT_TRACK,
+        WebSocketResponseEvent.SEND_DATA_CHAT_COMPLETIONS,
+    ].includes(v.event) &&
+        typeof v.dataId === 'string' &&
+        !!v.dataId &&
+        !!v.content);
+};
+export const isSendDataEcsTaskDefinitionListWebSocketResponseEventDTO = (event) => {
+    return (isWebSocketResponseEventDTO(event) &&
+        isSendDataWebSocketResponseEventDTO(event) &&
+        event.event === WebSocketResponseEvent.SEND_DATA_ECS_TASK_DEFINITIONS_LIST);
+};
+export const isSendDataEc2InstancesListWebSocketResponseEventDTO = (event) => {
+    return (isWebSocketResponseEventDTO(event) &&
+        isSendDataWebSocketResponseEventDTO(event) &&
+        event.event === WebSocketResponseEvent.SEND_DATA_EC2_INSTANCES_LIST);
+};
+export const isSendDataEcsTasksListWebSocketResponseEventDTO = (event) => {
+    return (isWebSocketResponseEventDTO(event) &&
+        isSendDataWebSocketResponseEventDTO(event) &&
+        event.event === WebSocketResponseEvent.SEND_DATA_ECS_TASKS_LIST);
+};
+export const isSendDataSsmSessionsListWebSocketResponseEventDTO = (event) => {
+    return (isWebSocketResponseEventDTO(event) &&
+        isSendDataWebSocketResponseEventDTO(event) &&
+        event.event === WebSocketResponseEvent.SEND_DATA_SSM_SESSIONS_LIST);
+};
+export const isSendDataRunCommandWebSocketResponseEventDTO = (event) => {
+    return (isWebSocketResponseEventDTO(event) &&
+        isSendDataWebSocketResponseEventDTO(event) &&
+        event.event === WebSocketResponseEvent.SEND_DATA_RUN_COMMAND);
+};
+export const isSendDataClientTrackWebSocketResponseEventDTO = (event) => {
+    return (isWebSocketResponseEventDTO(event) &&
+        isSendDataWebSocketResponseEventDTO(event) &&
+        event.event === WebSocketResponseEvent.SEND_DATA_CLIENT_TRACK);
+};
+export const isSenDataChatCompletionsWebSocketResponseEventDTO = (event) => {
+    return (isWebSocketResponseEventDTO(event) &&
+        isSendDataWebSocketResponseEventDTO(event) &&
+        event.event === WebSocketResponseEvent.SEND_DATA_CHAT_COMPLETIONS);
+};
+export const isProblemCrawledWebSocketResponseEventDTO = (event) => {
+    if (!isWebSocketResponseEventDTO(event))
+        return false;
+    const v = event;
+    return event.event === WebSocketResponseEvent.PROBLEM_CRAWLED && !!v.content;
+};
+export const isSubmissionsCrawlWebSocketResponseEventDTO = (event) => {
+    if (!isWebSocketResponseEventDTO(event))
+        return false;
+    const v = event;
+    return event.event === WebSocketResponseEvent.SUBMISSIONS_CRAWL && !!v.content;
+};
+export const isContestChangesWebSocketResponseEventDTO = (event) => {
+    if (!isWebSocketResponseEventDTO(event))
+        return false;
+    const v = event;
+    return event.event === WebSocketResponseEvent.CONTEST_CHANGES && !!v.content;
+};
+export const isClientTrackWebSocketResponseEventDTO = (event) => {
+    return isWebSocketResponseEventDTO(event) && event.event === WebSocketResponseEvent.CLIENT_TRACK;
+};
+export const isUserNotificationWebSocketResponseEventDTO = (event) => {
+    if (typeof event !== 'object' || event === null)
+        return false;
+    const v = event;
+    return ([
+        WebSocketResponseEvent.USER_NOTIFICATION_SUBMISSION,
+        WebSocketResponseEvent.USER_NOTIFICATION_CONTEST_CLARIFICATION,
+    ].includes(v.event) && !!v.content);
+};
+export const isUserNotificationSubmissionWebSocketResponseEventDTO = (event) => {
+    return (isWebSocketResponseEventDTO(event) &&
+        isUserNotificationWebSocketResponseEventDTO(event) &&
+        event.event === WebSocketResponseEvent.USER_NOTIFICATION_SUBMISSION);
+};
+export const isUserNotificationContestClarificationWebSocketResponseEventDTO = (event) => {
+    return (isWebSocketResponseEventDTO(event) &&
+        isUserNotificationWebSocketResponseEventDTO(event) &&
+        event.event === WebSocketResponseEvent.USER_NOTIFICATION_CONTEST_CLARIFICATION);
+};
+// generic
+export const getWebSocketResponseEventKey = (event, clientId, id) => {
+    return `${event}-${clientId}-${id}`;
+};

package/dist/helpers/time.d.ts

@@ -0,0 +1,13 @@
+import type { SplitTime } from '../types/index.js';
+export declare function splitTime(timeRemaining: number): [SplitTime, SplitTime, SplitTime, SplitTime, SplitTime, SplitTime];
+export declare function normalizeToLocalStartOfDay(timestamp: number | Date): Date;
+export declare function normalizeToLocalStartOfHour(timestamp: number | Date): Date;
+export declare function normalizeToLocalStartOfMinutes(timestamp: number | Date): Date;
+export declare function normalizeToLocalStartOfSeconds(timestamp: number | Date): Date;
+export declare const getYears: (d: Date) => number;
+export declare const getMonths: (d: Date) => number;
+export declare const getDays: (d: Date) => number;
+export declare const getHours: (d: Date) => number;
+export declare const getMinutes: (d: Date) => number;
+export declare const getSeconds: (d: Date) => number;
+export declare const getMilliseconds: (d: Date) => number;

package/dist/helpers/time.js

@@ -0,0 +1,101 @@
+import { ONE_DAY, ONE_HOUR, ONE_MINUTE } from '../constants/index.js';
+export function splitTime(timeRemaining) {
+    const remaining = [];
+    // const aYearMilliseconds = 1000 * 60 * 60 * 24 * 365;
+    // const remainingYears = Math.floor(timeRemaining / aYearMilliseconds);
+    // remaining.push({ remaining: remainingYears, label: 'years', milliseconds: aYearMilliseconds });
+    // const aWeekMilliseconds = 1000 * 60 * 60 * 24 * 7;
+    // const remainingWeeks = Math.floor((timeRemaining % aYearMilliseconds) / aWeekMilliseconds);
+    // remaining.push({ remaining: remainingWeeks, label: 'weeks', milliseconds: aWeekMilliseconds });
+    const aSecondMilliseconds = 1000;
+    const aMinuteMilliseconds = aSecondMilliseconds * 60;
+    const aHourMilliseconds = aMinuteMilliseconds * 60;
+    const aDayMilliseconds = aHourMilliseconds * 24;
+    const aWeekMilliseconds = aDayMilliseconds * 7;
+    const remainingWeeks = Math.floor(timeRemaining / aWeekMilliseconds);
+    remaining.push({
+        remaining: remainingWeeks,
+        label: remainingWeeks === 1 ? 'week' : 'weeks',
+        abbreviatedLabel: 'w',
+        milliseconds: aWeekMilliseconds,
+        digits: 2,
+    });
+    const remainingDays = Math.floor((timeRemaining % aWeekMilliseconds) / aDayMilliseconds);
+    remaining.push({
+        remaining: remainingDays,
+        label: remainingDays === 1 ? 'day' : 'days',
+        abbreviatedLabel: 'd',
+        milliseconds: aDayMilliseconds,
+        digits: 2,
+    });
+    const remainingHours = Math.floor((timeRemaining % aDayMilliseconds) / aHourMilliseconds);
+    remaining.push({
+        remaining: remainingHours,
+        label: remainingHours === 1 ? 'hour' : 'hours',
+        abbreviatedLabel: 'h',
+        milliseconds: aHourMilliseconds,
+        digits: 2,
+    });
+    const remainingMinutes = Math.floor((timeRemaining % aHourMilliseconds) / aMinuteMilliseconds);
+    remaining.push({
+        remaining: remainingMinutes,
+        label: remainingMinutes === 1 ? 'minute' : 'minutes',
+        abbreviatedLabel: 'm',
+        milliseconds: aMinuteMilliseconds,
+        digits: 2,
+    });
+    const remainingSeconds = Math.floor((timeRemaining % aMinuteMilliseconds) / aSecondMilliseconds);
+    remaining.push({
+        remaining: remainingSeconds,
+        label: remainingSeconds === 1 ? 'second' : 'seconds',
+        abbreviatedLabel: 's',
+        milliseconds: aSecondMilliseconds,
+        digits: 2,
+    });
+    const remainingMilliseconds = Math.floor(timeRemaining % aSecondMilliseconds);
+    remaining.push({
+        remaining: remainingMilliseconds,
+        label: remainingMilliseconds === 1 ? 'millisecond' : 'milliseconds',
+        abbreviatedLabel: 'ms',
+        milliseconds: 1,
+        digits: 3,
+    });
+    // while (remaining[0].remaining <= 0) {
+    //   remaining.shift();
+    //   if (remaining.length === 3) {
+    //     break;
+    //   }
+    // }
+    return remaining;
+}
+export function normalizeToLocalStartOfDay(timestamp) {
+    const date = new Date(timestamp);
+    return new Date(date.getFullYear(), date.getMonth(), date.getDate());
+}
+export function normalizeToLocalStartOfHour(timestamp) {
+    const date = new Date(timestamp);
+    return new Date(date.getFullYear(), date.getMonth(), date.getDate(), date.getHours());
+}
+export function normalizeToLocalStartOfMinutes(timestamp) {
+    const date = new Date(timestamp);
+    return new Date(date.getFullYear(), date.getMonth(), date.getDate(), date.getHours(), date.getMinutes());
+}
+export function normalizeToLocalStartOfSeconds(timestamp) {
+    const date = new Date(timestamp);
+    return new Date(date.getFullYear(), date.getMonth(), date.getDate(), date.getHours(), date.getMinutes());
+}
+export const getYears = (d) => d.getFullYear();
+export const getMonths = (d) => d.getFullYear() * 12 + d.getMonth();
+export const getDays = (d) => {
+    return Math.floor(normalizeToLocalStartOfDay(d).getTime() / ONE_DAY);
+};
+export const getHours = (d) => {
+    return Math.floor(normalizeToLocalStartOfHour(d).getTime() / ONE_HOUR);
+};
+export const getMinutes = (d) => {
+    return Math.floor(normalizeToLocalStartOfMinutes(d).getTime() / ONE_MINUTE);
+};
+export const getSeconds = (d) => {
+    return Math.floor(normalizeToLocalStartOfSeconds(d).getTime() / 1000);
+};
+export const getMilliseconds = (d) => d.getTime();

package/dist/helpers/user.d.ts

@@ -0,0 +1,11 @@
+import type { ClientId, RecordId } from '../types/index.js';
+export declare const getUserKey: (userNickname: string, userCompanyKey: string) => string;
+export declare const getParamsOfUserKey: (userKey: string) => {
+    userNickname: string;
+    userCompanyKey: string;
+};
+export declare const getClientId: (sessionId: RecordId, uiId: string) => ClientId;
+export declare const getParamsOfClientId: (clientId: ClientId) => {
+    sessionId: RecordId;
+    uiId: string;
+};

package/dist/helpers/user.js

@@ -0,0 +1,14 @@
+export const getUserKey = (userNickname, userCompanyKey) => {
+    return `${userNickname}|${userCompanyKey}`;
+};
+export const getParamsOfUserKey = (userKey) => {
+    const [userNickname, userCompanyKey] = userKey.split('|');
+    return { userNickname, userCompanyKey };
+};
+export const getClientId = (sessionId, uiId) => {
+    return `${sessionId}|${uiId}`;
+};
+export const getParamsOfClientId = (clientId) => {
+    const [sessionId, uiId] = clientId.split('|');
+    return { sessionId, uiId };
+};

package/dist/helpers/worksheet.d.ts

@@ -0,0 +1,10 @@
+import { type BasicWorksheet, type BodyWorksheet, type CodeEditorSheet, type JkmdSheet, type QuizOptionsSheet, type QuizProblemSheet, type QuizTextSheet, type SummaryWorksheetsInPages, type WorksheetsInPages } from '../types/index.js';
+export declare const getWorksheetsInPages: (initialSheets: BodyWorksheet[]) => WorksheetsInPages;
+export declare const getSummaryWorksheetsInPages: (initialSheets: BodyWorksheet[]) => SummaryWorksheetsInPages;
+export declare const getTotalExercisesOfSummaryWorksheetsInPages: (content: SummaryWorksheetsInPages) => number;
+export declare const isBasicWorksheet: (value: unknown) => value is BasicWorksheet;
+export declare const isJkmdSheet: (value: unknown) => value is JkmdSheet;
+export declare const isCodeEditorSheet: (value: unknown) => value is CodeEditorSheet;
+export declare const isQuizProblemSheet: (value: unknown) => value is QuizProblemSheet;
+export declare const isQuizOptionsSheet: (value: unknown) => value is QuizOptionsSheet;
+export declare const isQuizTextSheet: (value: unknown) => value is QuizTextSheet;