@elice/material-shared-utils 1.230220.2 → 1.230306.0

package/cjs/index.js

@@ -9,7 +9,7 @@ var useMaterialConfig = require('./material-config/useMaterialConfig.js');
 var useMaterialConfigApiClientUpdate = require('./material-config/useMaterialConfigApiClientUpdate.js');
 var utils = require('./material-config/utils.js');
 var useMaterialFetch = require('./material-fetch/useMaterialFetch.js');
-var useMaterialInitFetch = require('./material-fetch/useMaterialInitFetch.js');
+var useMaterialFetchRaw = require('./material-fetch/useMaterialFetchRaw.js');
 var withMaterial = require('./material-hoc/withMaterial.js');
 
 
@@ -21,6 +21,6 @@ exports.useMaterialConfig = useMaterialConfig.useMaterialConfig;
 exports.useMaterialConfigApiClientUpdate = useMaterialConfigApiClientUpdate.useMaterialConfigApiClientUpdate;
 exports.updateMaterialConfigSessionKey = utils.updateMaterialConfigSessionKey;
 exports.useMaterialFetch = useMaterialFetch.useMaterialFetch;
-exports.useMaterialInitFetch = useMaterialInitFetch.useMaterialInitFetch;
+exports.useMaterialFetchRaw = useMaterialFetchRaw.useMaterialFetchRaw;
 exports.withForwardRefMaterial = withMaterial.withForwardRefMaterial;
 exports.withMaterial = withMaterial.withMaterial;

package/cjs/material-fetch/index.d.ts

@@ -1,2 +1,2 @@
 export * from './useMaterialFetch';
-export * from './useMaterialInitFetch';
+export * from './useMaterialFetchRaw';

package/cjs/material-fetch/useMaterialFetch.d.ts

@@ -1,21 +1,70 @@
-import type { EliceApiResponse } from '@elice/api-client';
-import type { APIStatus } from '@elice/material-shared-types';
-declare type FetchFn<R> = (signal: AbortSignal) => Promise<EliceApiResponse<R>>;
+import type { EliceApiClientConfigs, EliceApiResponse } from '@elice/api-client';
+import type { enums } from '@elice/types';
+import type { FetchKeyMap } from './useMaterialFetchRaw';
+declare type FetchClientInitializer = (config: EliceApiClientConfigs) => void;
 /**
  * Init api client and fetch material for contaner.
  *
- * @param fn API client wrapped with `React.useCallback` to fetch material.
- * @param isReady Is ready to fetch material.
- *
  * @example
- * const [materialPdf, materialPdfStatus] =
- *   useMaterialFetch<GetOrgMaterialPdfGetResponses>(
+ * const { materialPdf, materialLecturePage, status ] =
+ *   useMaterialFetch(
+ *     enums.LectureMaterialType.PDF,
  *     React.useCallback(
- *       signal => getOrgMaterialPdfGet({ materialPdfId }, { signal }),
+ *       signal =>
+ *         getOrgMaterialPdfGet<GetOrgMaterialPdfGetResponses>(
+ *           { materialPdfId },
+ *           { signal }
+ *         ),
  *       [materialPdfId]
  *     ),
- *     isReady // boolean
+ *     eliceApiClientConfigs.init
  *   );
  */
-export declare const useMaterialFetch: <R = any>(fn: FetchFn<R>, isReady?: boolean) => [R | null, APIStatus];
+export declare const useMaterialFetch: <MT extends enums.LectureMaterialType, R extends Record<FetchKeyMap[MT], Record<string, any>> = Record<FetchKeyMap[MT], Record<string, any>>>(materialType: MT, materialFetchFn: (signal?: AbortSignal | undefined) => Promise<EliceApiResponse<R>>, init: FetchClientInitializer) => Record<FetchKeyMap[MT], R[FetchKeyMap[MT]] | null> & {
+    materialLecturePage: {
+        certificateDescription: string | null;
+        certificateFileUrl: string | null;
+        certificateTitle: string | null;
+        closeDatetime: number | null;
+        closeScheduleDatetime: number | null;
+        courseId: number;
+        createdDatetime: number;
+        id: number;
+        isCertificateEnabled: boolean;
+        isCompleted: boolean;
+        isEnrolledStudentResponded: boolean;
+        isForStats: boolean;
+        isGraded: boolean;
+        isLibraryInstance: boolean;
+        isOpened: boolean;
+        isResponded: boolean;
+        lectureGroupType: enums.LectureGroupType | null;
+        lectureId: number;
+        mainOrderNo: number;
+        materialId: number;
+        materialKey: string;
+        materialType: enums.LectureMaterialType;
+        modifiedDatetime: number;
+        openScheduleDatetime: number | null;
+        originCourse: {
+            id: number;
+            title: string;
+            organization: {
+                id: number;
+                name: string;
+                nameShort: string;
+            };
+        } | null;
+        originLecturePageId: number | null;
+        point: number;
+        score: number;
+        subLecturePageIds: number[];
+        subOrderNo: number | null;
+        taglist: string[];
+        title: string;
+    } | null;
+} & {
+    status: import("@elice/material-shared-types").APIStatus;
+    refetch: (signal?: AbortSignal | undefined) => Promise<void>;
+};
 export {};

package/cjs/material-fetch/useMaterialFetch.js

@@ -2,50 +2,36 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var React = require('react');
+require('react');
+require('../material-config/MaterialConfigContext.js');
+var useMaterialConfigApiClientUpdate = require('../material-config/useMaterialConfigApiClientUpdate.js');
+var useMaterialFetchRaw = require('./useMaterialFetchRaw.js');
+
+//
+//
 
 /**
  * Init api client and fetch material for contaner.
  *
- * @param fn API client wrapped with `React.useCallback` to fetch material.
- * @param isReady Is ready to fetch material.
- *
  * @example
- * const [materialPdf, materialPdfStatus] =
- *   useMaterialFetch<GetOrgMaterialPdfGetResponses>(
+ * const { materialPdf, materialLecturePage, status ] =
+ *   useMaterialFetch(
+ *     enums.LectureMaterialType.PDF,
  *     React.useCallback(
- *       signal => getOrgMaterialPdfGet({ materialPdfId }, { signal }),
+ *       signal =>
+ *         getOrgMaterialPdfGet<GetOrgMaterialPdfGetResponses>(
+ *           { materialPdfId },
+ *           { signal }
+ *         ),
  *       [materialPdfId]
  *     ),
- *     isReady // boolean
+ *     eliceApiClientConfigs.init
  *   );
  */
 
-const useMaterialFetch = (fn, isReady = true) => {
-  const [material, setMaterial] = React.useState(null);
-  const [materialStatus, setMaterialStatus] = React.useState('idle');
-  React.useEffect(() => {
-    if (!isReady) {
-      return;
-    }
-
-    setMaterial(null);
-    setMaterialStatus('pending');
-    const abortCtrl = new AbortController();
-    fn(abortCtrl.signal).then(res => {
-      setMaterial(res);
-      setMaterialStatus('resolved');
-    }).catch(err => {
-      if (err.name !== 'AbortError') {
-        setMaterial(null);
-        setMaterialStatus('rejected');
-      }
-    });
-    return () => {
-      abortCtrl.abort();
-    };
-  }, [isReady, fn]);
-  return [material, materialStatus];
+const useMaterialFetch = (materialType, materialFetchFn, init) => {
+  const isReady = useMaterialConfigApiClientUpdate.useMaterialConfigApiClientUpdate(init);
+  return useMaterialFetchRaw.useMaterialFetchRaw(materialType, materialFetchFn, isReady);
 };
 
 exports.useMaterialFetch = useMaterialFetch;

package/cjs/material-fetch/useMaterialFetchRaw.d.ts

@@ -0,0 +1,43 @@
+import { enums } from '@elice/types';
+import type { EliceApiResponse } from '@elice/api-client';
+import type { APIStatus } from '@elice/material-shared-types';
+import type { GetOrgLecturePageGetResponses } from '@elice/types';
+export interface FetchKeyMap {
+    [enums.LectureMaterialType.Nothing]: 'materialNothing';
+    [enums.LectureMaterialType.Note]: 'materialNote';
+    [enums.LectureMaterialType.Video]: 'materialVideo';
+    [enums.LectureMaterialType.PDF]: 'materialPdf';
+    [enums.LectureMaterialType.Exercise]: 'materialExercise';
+    [enums.LectureMaterialType.Quiz]: 'materialQuiz';
+    [enums.LectureMaterialType.Runbox]: 'materialRunbox';
+    [enums.LectureMaterialType.VideoFile]: 'materialVideoFile';
+    [enums.LectureMaterialType.Live]: 'materialLive';
+    [enums.LectureMaterialType.Assignment]: 'materialAssignment';
+    [enums.LectureMaterialType.LMSPublicContent]: 'materialLmsPublicContent';
+    [enums.LectureMaterialType.External]: 'materialExternal';
+    [enums.LectureMaterialType.Survey]: 'materialSurvey';
+}
+/**
+ * Init api client and fetch material for contaner.
+ *
+ * @example
+ * const { materialPdf, materialLecturePage, status ] =
+ *   useMaterialFetchRaw(
+ *     enums.LectureMaterialType.PDF,
+ *     React.useCallback(
+ *       signal =>
+ *         getOrgMaterialPdfGet<GetOrgMaterialPdfGetResponses>(
+ *           { materialPdfId },
+ *           { signal }
+ *         ),
+ *       [materialPdfId]
+ *     ),
+ *     isReady // boolean
+ *   );
+ */
+export declare const useMaterialFetchRaw: <MT extends enums.LectureMaterialType, R extends Record<FetchKeyMap[MT], Record<string, any>> = Record<FetchKeyMap[MT], Record<string, any>>>(materialType: MT, materialFetchFn: (signal?: AbortSignal | undefined) => Promise<EliceApiResponse<R>>, isReady?: boolean) => Record<FetchKeyMap[MT], R[FetchKeyMap[MT]] | null> & {
+    materialLecturePage: GetOrgLecturePageGetResponses['lecturePage'] | null;
+} & {
+    status: APIStatus;
+    refetch: (signal?: AbortSignal | undefined) => Promise<void>;
+};

package/cjs/material-fetch/useMaterialFetchRaw.js

@@ -0,0 +1,112 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var React = require('react');
+var apiClient = require('@elice/api-client');
+var types = require('@elice/types');
+
+const MATERIAL_FETCH_KEY_MAP = Object.freeze({
+  [types.enums.LectureMaterialType.Nothing]: 'materialNothing',
+  [types.enums.LectureMaterialType.Note]: 'materialNote',
+  [types.enums.LectureMaterialType.Video]: 'materialVideo',
+  [types.enums.LectureMaterialType.PDF]: 'materialPdf',
+  [types.enums.LectureMaterialType.Exercise]: 'materialExercise',
+  [types.enums.LectureMaterialType.Quiz]: 'materialQuiz',
+  [types.enums.LectureMaterialType.Runbox]: 'materialRunbox',
+  [types.enums.LectureMaterialType.VideoFile]: 'materialVideoFile',
+  [types.enums.LectureMaterialType.Live]: 'materialLive',
+  [types.enums.LectureMaterialType.Assignment]: 'materialAssignment',
+  [types.enums.LectureMaterialType.LMSPublicContent]: 'materialLmsPublicContent',
+  [types.enums.LectureMaterialType.External]: 'materialExternal',
+  [types.enums.LectureMaterialType.Survey]: 'materialSurvey'
+}); //
+//
+//
+
+/**
+ * Init api client and fetch material for contaner.
+ *
+ * @example
+ * const { materialPdf, materialLecturePage, status ] =
+ *   useMaterialFetchRaw(
+ *     enums.LectureMaterialType.PDF,
+ *     React.useCallback(
+ *       signal =>
+ *         getOrgMaterialPdfGet<GetOrgMaterialPdfGetResponses>(
+ *           { materialPdfId },
+ *           { signal }
+ *         ),
+ *       [materialPdfId]
+ *     ),
+ *     isReady // boolean
+ *   );
+ */
+
+const useMaterialFetchRaw = (materialType, materialFetchFn, isReady = true) => {
+  const _return = React.useRef({});
+
+  const materialKey = MATERIAL_FETCH_KEY_MAP[materialType];
+
+  const _createEmptyFetchRes = () => ({
+    [materialKey]: null,
+    materialLecturePage: null
+  });
+
+  const [matFetchRes, setMatFetchRes] = React.useState(_createEmptyFetchRes);
+  const [matFetchStatus, setMatFetchStatus] = React.useState('idle');
+  /**
+   * fetch material and lecture page
+   */
+
+  const fetch = React.useCallback(async signal => {
+    setMatFetchStatus('pending');
+    return materialFetchFn(signal).then(resMaterialGet => resMaterialGet[materialKey]).then(material => Promise.all([material, apiClient.getOrgLecturePageResolve({
+      materialId: material.id,
+      materialType
+    }, {
+      signal: signal
+    }).then(resLecturePageResolve => apiClient.getOrgLecturePageGet({
+      lecturePageId: resLecturePageResolve.lecturePageId
+    }, {
+      signal: signal
+    })).then(resLecturePageGet => resLecturePageGet.lecturePage)])).then(([material, materialLecturePage]) => {
+      setMatFetchRes({
+        [materialKey]: material,
+        materialLecturePage
+      });
+      setMatFetchStatus('resolved');
+    }).catch(err => {
+      if (err.name !== 'AbortError') {
+        setMatFetchRes(_createEmptyFetchRes);
+        setMatFetchStatus('rejected');
+      }
+    });
+  }, // eslint-disable-next-line react-hooks/exhaustive-deps
+  [materialKey, materialFetchFn]); //
+  // emit `fetch` when `isReady` is changed
+  //
+
+  React.useEffect(() => {
+    if (!isReady) {
+      return;
+    }
+
+    const abortCtrl = new AbortController();
+    fetch(abortCtrl.signal).catch(() => void 0);
+    return () => {
+      abortCtrl.abort();
+    };
+  }, // eslint-disable-next-line react-hooks/exhaustive-deps
+  [isReady, fetch]); //
+  //
+  //
+
+  _return.current[materialKey] = matFetchRes[materialKey];
+  _return.current.materialLecturePage = matFetchRes.materialLecturePage;
+  _return.current.status = matFetchStatus;
+  _return.current.refetch = fetch;
+  return _return.current;
+};
+
+exports.useMaterialFetchRaw = useMaterialFetchRaw;

package/es/index.js

@@ -5,5 +5,5 @@ export { useMaterialConfig } from './material-config/useMaterialConfig.js';
 export { useMaterialConfigApiClientUpdate } from './material-config/useMaterialConfigApiClientUpdate.js';
 export { updateMaterialConfigSessionKey } from './material-config/utils.js';
 export { useMaterialFetch } from './material-fetch/useMaterialFetch.js';
-export { useMaterialInitFetch } from './material-fetch/useMaterialInitFetch.js';
+export { useMaterialFetchRaw } from './material-fetch/useMaterialFetchRaw.js';
 export { withForwardRefMaterial, withMaterial } from './material-hoc/withMaterial.js';

package/es/material-fetch/index.d.ts

@@ -1,2 +1,2 @@
 export * from './useMaterialFetch';
-export * from './useMaterialInitFetch';
+export * from './useMaterialFetchRaw';

package/es/material-fetch/useMaterialFetch.d.ts

@@ -1,21 +1,70 @@
-import type { EliceApiResponse } from '@elice/api-client';
-import type { APIStatus } from '@elice/material-shared-types';
-declare type FetchFn<R> = (signal: AbortSignal) => Promise<EliceApiResponse<R>>;
+import type { EliceApiClientConfigs, EliceApiResponse } from '@elice/api-client';
+import type { enums } from '@elice/types';
+import type { FetchKeyMap } from './useMaterialFetchRaw';
+declare type FetchClientInitializer = (config: EliceApiClientConfigs) => void;
 /**
  * Init api client and fetch material for contaner.
  *
- * @param fn API client wrapped with `React.useCallback` to fetch material.
- * @param isReady Is ready to fetch material.
- *
  * @example
- * const [materialPdf, materialPdfStatus] =
- *   useMaterialFetch<GetOrgMaterialPdfGetResponses>(
+ * const { materialPdf, materialLecturePage, status ] =
+ *   useMaterialFetch(
+ *     enums.LectureMaterialType.PDF,
  *     React.useCallback(
- *       signal => getOrgMaterialPdfGet({ materialPdfId }, { signal }),
+ *       signal =>
+ *         getOrgMaterialPdfGet<GetOrgMaterialPdfGetResponses>(
+ *           { materialPdfId },
+ *           { signal }
+ *         ),
  *       [materialPdfId]
  *     ),
- *     isReady // boolean
+ *     eliceApiClientConfigs.init
  *   );
  */
-export declare const useMaterialFetch: <R = any>(fn: FetchFn<R>, isReady?: boolean) => [R | null, APIStatus];
+export declare const useMaterialFetch: <MT extends enums.LectureMaterialType, R extends Record<FetchKeyMap[MT], Record<string, any>> = Record<FetchKeyMap[MT], Record<string, any>>>(materialType: MT, materialFetchFn: (signal?: AbortSignal | undefined) => Promise<EliceApiResponse<R>>, init: FetchClientInitializer) => Record<FetchKeyMap[MT], R[FetchKeyMap[MT]] | null> & {
+    materialLecturePage: {
+        certificateDescription: string | null;
+        certificateFileUrl: string | null;
+        certificateTitle: string | null;
+        closeDatetime: number | null;
+        closeScheduleDatetime: number | null;
+        courseId: number;
+        createdDatetime: number;
+        id: number;
+        isCertificateEnabled: boolean;
+        isCompleted: boolean;
+        isEnrolledStudentResponded: boolean;
+        isForStats: boolean;
+        isGraded: boolean;
+        isLibraryInstance: boolean;
+        isOpened: boolean;
+        isResponded: boolean;
+        lectureGroupType: enums.LectureGroupType | null;
+        lectureId: number;
+        mainOrderNo: number;
+        materialId: number;
+        materialKey: string;
+        materialType: enums.LectureMaterialType;
+        modifiedDatetime: number;
+        openScheduleDatetime: number | null;
+        originCourse: {
+            id: number;
+            title: string;
+            organization: {
+                id: number;
+                name: string;
+                nameShort: string;
+            };
+        } | null;
+        originLecturePageId: number | null;
+        point: number;
+        score: number;
+        subLecturePageIds: number[];
+        subOrderNo: number | null;
+        taglist: string[];
+        title: string;
+    } | null;
+} & {
+    status: import("@elice/material-shared-types").APIStatus;
+    refetch: (signal?: AbortSignal | undefined) => Promise<void>;
+};
 export {};

package/es/material-fetch/useMaterialFetch.js

@@ -1,47 +1,33 @@
-import { useState, useEffect } from 'react';
+import 'react';
+import '../material-config/MaterialConfigContext.js';
+import { useMaterialConfigApiClientUpdate } from '../material-config/useMaterialConfigApiClientUpdate.js';
+import { useMaterialFetchRaw } from './useMaterialFetchRaw.js';
+
+//
+//
 
 /**
  * Init api client and fetch material for contaner.
  *
- * @param fn API client wrapped with `React.useCallback` to fetch material.
- * @param isReady Is ready to fetch material.
- *
  * @example
- * const [materialPdf, materialPdfStatus] =
- *   useMaterialFetch<GetOrgMaterialPdfGetResponses>(
+ * const { materialPdf, materialLecturePage, status ] =
+ *   useMaterialFetch(
+ *     enums.LectureMaterialType.PDF,
  *     React.useCallback(
- *       signal => getOrgMaterialPdfGet({ materialPdfId }, { signal }),
+ *       signal =>
+ *         getOrgMaterialPdfGet<GetOrgMaterialPdfGetResponses>(
+ *           { materialPdfId },
+ *           { signal }
+ *         ),
  *       [materialPdfId]
  *     ),
- *     isReady // boolean
+ *     eliceApiClientConfigs.init
  *   );
  */
 
-const useMaterialFetch = (fn, isReady = true) => {
-  const [material, setMaterial] = useState(null);
-  const [materialStatus, setMaterialStatus] = useState('idle');
-  useEffect(() => {
-    if (!isReady) {
-      return;
-    }
-
-    setMaterial(null);
-    setMaterialStatus('pending');
-    const abortCtrl = new AbortController();
-    fn(abortCtrl.signal).then(res => {
-      setMaterial(res);
-      setMaterialStatus('resolved');
-    }).catch(err => {
-      if (err.name !== 'AbortError') {
-        setMaterial(null);
-        setMaterialStatus('rejected');
-      }
-    });
-    return () => {
-      abortCtrl.abort();
-    };
-  }, [isReady, fn]);
-  return [material, materialStatus];
+const useMaterialFetch = (materialType, materialFetchFn, init) => {
+  const isReady = useMaterialConfigApiClientUpdate(init);
+  return useMaterialFetchRaw(materialType, materialFetchFn, isReady);
 };
 
 export { useMaterialFetch };

package/es/material-fetch/useMaterialFetchRaw.d.ts

@@ -0,0 +1,43 @@
+import { enums } from '@elice/types';
+import type { EliceApiResponse } from '@elice/api-client';
+import type { APIStatus } from '@elice/material-shared-types';
+import type { GetOrgLecturePageGetResponses } from '@elice/types';
+export interface FetchKeyMap {
+    [enums.LectureMaterialType.Nothing]: 'materialNothing';
+    [enums.LectureMaterialType.Note]: 'materialNote';
+    [enums.LectureMaterialType.Video]: 'materialVideo';
+    [enums.LectureMaterialType.PDF]: 'materialPdf';
+    [enums.LectureMaterialType.Exercise]: 'materialExercise';
+    [enums.LectureMaterialType.Quiz]: 'materialQuiz';
+    [enums.LectureMaterialType.Runbox]: 'materialRunbox';
+    [enums.LectureMaterialType.VideoFile]: 'materialVideoFile';
+    [enums.LectureMaterialType.Live]: 'materialLive';
+    [enums.LectureMaterialType.Assignment]: 'materialAssignment';
+    [enums.LectureMaterialType.LMSPublicContent]: 'materialLmsPublicContent';
+    [enums.LectureMaterialType.External]: 'materialExternal';
+    [enums.LectureMaterialType.Survey]: 'materialSurvey';
+}
+/**
+ * Init api client and fetch material for contaner.
+ *
+ * @example
+ * const { materialPdf, materialLecturePage, status ] =
+ *   useMaterialFetchRaw(
+ *     enums.LectureMaterialType.PDF,
+ *     React.useCallback(
+ *       signal =>
+ *         getOrgMaterialPdfGet<GetOrgMaterialPdfGetResponses>(
+ *           { materialPdfId },
+ *           { signal }
+ *         ),
+ *       [materialPdfId]
+ *     ),
+ *     isReady // boolean
+ *   );
+ */
+export declare const useMaterialFetchRaw: <MT extends enums.LectureMaterialType, R extends Record<FetchKeyMap[MT], Record<string, any>> = Record<FetchKeyMap[MT], Record<string, any>>>(materialType: MT, materialFetchFn: (signal?: AbortSignal | undefined) => Promise<EliceApiResponse<R>>, isReady?: boolean) => Record<FetchKeyMap[MT], R[FetchKeyMap[MT]] | null> & {
+    materialLecturePage: GetOrgLecturePageGetResponses['lecturePage'] | null;
+} & {
+    status: APIStatus;
+    refetch: (signal?: AbortSignal | undefined) => Promise<void>;
+};

package/es/material-fetch/useMaterialFetchRaw.js

@@ -0,0 +1,108 @@
+import { useRef, useState, useCallback, useEffect } from 'react';
+import { getOrgLecturePageResolve, getOrgLecturePageGet } from '@elice/api-client';
+import { enums } from '@elice/types';
+
+const MATERIAL_FETCH_KEY_MAP = Object.freeze({
+  [enums.LectureMaterialType.Nothing]: 'materialNothing',
+  [enums.LectureMaterialType.Note]: 'materialNote',
+  [enums.LectureMaterialType.Video]: 'materialVideo',
+  [enums.LectureMaterialType.PDF]: 'materialPdf',
+  [enums.LectureMaterialType.Exercise]: 'materialExercise',
+  [enums.LectureMaterialType.Quiz]: 'materialQuiz',
+  [enums.LectureMaterialType.Runbox]: 'materialRunbox',
+  [enums.LectureMaterialType.VideoFile]: 'materialVideoFile',
+  [enums.LectureMaterialType.Live]: 'materialLive',
+  [enums.LectureMaterialType.Assignment]: 'materialAssignment',
+  [enums.LectureMaterialType.LMSPublicContent]: 'materialLmsPublicContent',
+  [enums.LectureMaterialType.External]: 'materialExternal',
+  [enums.LectureMaterialType.Survey]: 'materialSurvey'
+}); //
+//
+//
+
+/**
+ * Init api client and fetch material for contaner.
+ *
+ * @example
+ * const { materialPdf, materialLecturePage, status ] =
+ *   useMaterialFetchRaw(
+ *     enums.LectureMaterialType.PDF,
+ *     React.useCallback(
+ *       signal =>
+ *         getOrgMaterialPdfGet<GetOrgMaterialPdfGetResponses>(
+ *           { materialPdfId },
+ *           { signal }
+ *         ),
+ *       [materialPdfId]
+ *     ),
+ *     isReady // boolean
+ *   );
+ */
+
+const useMaterialFetchRaw = (materialType, materialFetchFn, isReady = true) => {
+  const _return = useRef({});
+
+  const materialKey = MATERIAL_FETCH_KEY_MAP[materialType];
+
+  const _createEmptyFetchRes = () => ({
+    [materialKey]: null,
+    materialLecturePage: null
+  });
+
+  const [matFetchRes, setMatFetchRes] = useState(_createEmptyFetchRes);
+  const [matFetchStatus, setMatFetchStatus] = useState('idle');
+  /**
+   * fetch material and lecture page
+   */
+
+  const fetch = useCallback(async signal => {
+    setMatFetchStatus('pending');
+    return materialFetchFn(signal).then(resMaterialGet => resMaterialGet[materialKey]).then(material => Promise.all([material, getOrgLecturePageResolve({
+      materialId: material.id,
+      materialType
+    }, {
+      signal: signal
+    }).then(resLecturePageResolve => getOrgLecturePageGet({
+      lecturePageId: resLecturePageResolve.lecturePageId
+    }, {
+      signal: signal
+    })).then(resLecturePageGet => resLecturePageGet.lecturePage)])).then(([material, materialLecturePage]) => {
+      setMatFetchRes({
+        [materialKey]: material,
+        materialLecturePage
+      });
+      setMatFetchStatus('resolved');
+    }).catch(err => {
+      if (err.name !== 'AbortError') {
+        setMatFetchRes(_createEmptyFetchRes);
+        setMatFetchStatus('rejected');
+      }
+    });
+  }, // eslint-disable-next-line react-hooks/exhaustive-deps
+  [materialKey, materialFetchFn]); //
+  // emit `fetch` when `isReady` is changed
+  //
+
+  useEffect(() => {
+    if (!isReady) {
+      return;
+    }
+
+    const abortCtrl = new AbortController();
+    fetch(abortCtrl.signal).catch(() => void 0);
+    return () => {
+      abortCtrl.abort();
+    };
+  }, // eslint-disable-next-line react-hooks/exhaustive-deps
+  [isReady, fetch]); //
+  //
+  //
+
+  _return.current[materialKey] = matFetchRes[materialKey];
+  _return.current.materialLecturePage = matFetchRes.materialLecturePage;
+  _return.current.status = matFetchStatus;
+  _return.current.refetch = fetch;
+  return _return.current;
+};
+
+export { useMaterialFetchRaw };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elice/material-shared-utils",
-  "version": "1.230220.2",
+  "version": "1.230306.0",
   "description": "Shared typings for elice material projects",
   "repository": "https://git.elicer.io/elice/frontend/library/elice-material",
   "license": "UNLICENSED",
@@ -29,7 +29,7 @@
     "clean": "del-cli \"es/*\" \"cjs/*\" \"dist/*\""
   },
   "peerDependencies": {
-    "@elice/api-client": "1.230215.1",
+    "@elice/api-client": "^1.230306.0",
     "@elice/material-shared-types": "22.7.2-1",
     "react": "^16.8.0  || ^17.0.0 || ^18.0.0",
     "react-use": "^17.0.0",
@@ -39,11 +39,11 @@
     "tslib": "^2.3.1"
   },
   "devDependencies": {
-    "@elice/api-client": "1.230215.1",
-    "@elice/material-shared-types": "1.230220.2",
-    "@elice/types": "1.230215.1",
+    "@elice/api-client": "^1.230306.0",
+    "@elice/material-shared-types": "1.230306.0",
+    "@elice/types": "^1.230306.0",
     "@types/react": "~17.0.9",
     "react-use": "^17.2.4"
   },
-  "gitHead": "f49499e86ce2ccbea6a1b83e070649a3167f8074"
+  "gitHead": "2ba30b7324d9fd782970a0343a6573827159b737"
 }

package/cjs/material-fetch/useMaterialInitFetch.d.ts

@@ -1,22 +0,0 @@
-import type { EliceApiClientConfigs, EliceApiResponse } from '@elice/api-client';
-import type { APIStatus } from '@elice/material-shared-types';
-declare type ApiInitFn = (config: EliceApiClientConfigs) => void;
-declare type FetchFn<R> = (signal: AbortSignal) => Promise<EliceApiResponse<R>>;
-/**
- * Init api client and fetch material for contaner.
- *
- * @param init Init api client.
- * @param fn API client wrapped with `React.useCallback` to fetch material.
- *
- * @example
- * const [materialPdf, materialPdfStatus] =
- *   useMaterialInitFetch<GetOrgMaterialPdfGetResponses>(
- *     eliceApiClientConfigs.init,
- *     React.useCallback(
- *       signal => getOrgMaterialPdfGet({ materialPdfId }, { signal }),
- *       [materialPdfId]
- *     ),
- *   );
- */
-export declare const useMaterialInitFetch: <R = any>(init: ApiInitFn, fn: FetchFn<R>) => [R | null, APIStatus];
-export {};

package/cjs/material-fetch/useMaterialInitFetch.js

@@ -1,54 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var React = require('react');
-require('../material-config/MaterialConfigContext.js');
-var useMaterialConfigApiClientUpdate = require('../material-config/useMaterialConfigApiClientUpdate.js');
-
-/**
- * Init api client and fetch material for contaner.
- *
- * @param init Init api client.
- * @param fn API client wrapped with `React.useCallback` to fetch material.
- *
- * @example
- * const [materialPdf, materialPdfStatus] =
- *   useMaterialInitFetch<GetOrgMaterialPdfGetResponses>(
- *     eliceApiClientConfigs.init,
- *     React.useCallback(
- *       signal => getOrgMaterialPdfGet({ materialPdfId }, { signal }),
- *       [materialPdfId]
- *     ),
- *   );
- */
-
-const useMaterialInitFetch = (init, fn) => {
-  const [material, setMaterial] = React.useState(null);
-  const [materialStatus, setMaterialStatus] = React.useState('idle');
-  const isReady = useMaterialConfigApiClientUpdate.useMaterialConfigApiClientUpdate(init);
-  React.useEffect(() => {
-    if (!isReady) {
-      return;
-    }
-
-    setMaterial(null);
-    setMaterialStatus('pending');
-    const abortCtrl = new AbortController();
-    fn(abortCtrl.signal).then(res => {
-      setMaterial(res);
-      setMaterialStatus('resolved');
-    }).catch(err => {
-      if (err.name !== 'AbortError') {
-        setMaterial(null);
-        setMaterialStatus('rejected');
-      }
-    });
-    return () => {
-      abortCtrl.abort();
-    };
-  }, [isReady, fn]);
-  return [material, materialStatus];
-};
-
-exports.useMaterialInitFetch = useMaterialInitFetch;

package/es/material-fetch/useMaterialInitFetch.d.ts

@@ -1,22 +0,0 @@
-import type { EliceApiClientConfigs, EliceApiResponse } from '@elice/api-client';
-import type { APIStatus } from '@elice/material-shared-types';
-declare type ApiInitFn = (config: EliceApiClientConfigs) => void;
-declare type FetchFn<R> = (signal: AbortSignal) => Promise<EliceApiResponse<R>>;
-/**
- * Init api client and fetch material for contaner.
- *
- * @param init Init api client.
- * @param fn API client wrapped with `React.useCallback` to fetch material.
- *
- * @example
- * const [materialPdf, materialPdfStatus] =
- *   useMaterialInitFetch<GetOrgMaterialPdfGetResponses>(
- *     eliceApiClientConfigs.init,
- *     React.useCallback(
- *       signal => getOrgMaterialPdfGet({ materialPdfId }, { signal }),
- *       [materialPdfId]
- *     ),
- *   );
- */
-export declare const useMaterialInitFetch: <R = any>(init: ApiInitFn, fn: FetchFn<R>) => [R | null, APIStatus];
-export {};

package/es/material-fetch/useMaterialInitFetch.js

@@ -1,50 +0,0 @@
-import { useState, useEffect } from 'react';
-import '../material-config/MaterialConfigContext.js';
-import { useMaterialConfigApiClientUpdate } from '../material-config/useMaterialConfigApiClientUpdate.js';
-
-/**
- * Init api client and fetch material for contaner.
- *
- * @param init Init api client.
- * @param fn API client wrapped with `React.useCallback` to fetch material.
- *
- * @example
- * const [materialPdf, materialPdfStatus] =
- *   useMaterialInitFetch<GetOrgMaterialPdfGetResponses>(
- *     eliceApiClientConfigs.init,
- *     React.useCallback(
- *       signal => getOrgMaterialPdfGet({ materialPdfId }, { signal }),
- *       [materialPdfId]
- *     ),
- *   );
- */
-
-const useMaterialInitFetch = (init, fn) => {
-  const [material, setMaterial] = useState(null);
-  const [materialStatus, setMaterialStatus] = useState('idle');
-  const isReady = useMaterialConfigApiClientUpdate(init);
-  useEffect(() => {
-    if (!isReady) {
-      return;
-    }
-
-    setMaterial(null);
-    setMaterialStatus('pending');
-    const abortCtrl = new AbortController();
-    fn(abortCtrl.signal).then(res => {
-      setMaterial(res);
-      setMaterialStatus('resolved');
-    }).catch(err => {
-      if (err.name !== 'AbortError') {
-        setMaterial(null);
-        setMaterialStatus('rejected');
-      }
-    });
-    return () => {
-      abortCtrl.abort();
-    };
-  }, [isReady, fn]);
-  return [material, materialStatus];
-};
-
-export { useMaterialInitFetch };