@contember/react-client 0.7.0-alpha.20

package/dist/production/upload/fileUploadReducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileUploadReducer.js","sources":["../../../src/upload/fileUploadReducer.ts"],"sourcesContent":["import { FileUploadError } from '@contember/client'\nimport { assertNever } from '../utils'\nimport type { FileId } from './FileId'\nimport type { FileUploadAction } from './FileUploadAction'\nimport type { FileUploadMultiTemporalState } from './FileUploadMultiTemporalState'\nimport { toFileId } from './toFileId'\n\nexport const initializeFileUploadState = <Result = unknown, Metadata = undefined>(): FileUploadMultiTemporalState<\n\tResult,\n\tMetadata\n> => ({\n\tlastUpdateTime: 0,\n\tfileIdByFile: new WeakMap<File, FileId>(),\n\tliveState: new Map(),\n\tpublicState: new Map(),\n\tisLiveStateDirty: false,\n})\n\nexport const fileUploadReducer = <Result = unknown, Metadata = undefined>(\n\tpreviousState: FileUploadMultiTemporalState<Result, Metadata>,\n\taction: FileUploadAction<Result, Metadata>,\n): FileUploadMultiTemporalState<Result, Metadata> => {\n\tconst publishNewState = (): FileUploadMultiTemporalState<Result, Metadata> => ({\n\t\tpublicState: previousState.liveState,\n\t\tfileIdByFile: previousState.fileIdByFile,\n\t\tlastUpdateTime: previousState.lastUpdateTime,\n\t\tisLiveStateDirty: false,\n\n\t\t// Immediately make the live state referentially unequal so that this doesn't have to happen during each action\n\t\t// several times between two publishes.\n\t\tliveState: new Map(previousState.liveState),\n\t})\n\tconst getNewDirtyState = (): FileUploadMultiTemporalState<Result, Metadata> => ({\n\t\tfileIdByFile: previousState.fileIdByFile,\n\t\tliveState: previousState.liveState,\n\t\tpublicState: previousState.publicState,\n\t\tisLiveStateDirty: true,\n\t\tlastUpdateTime: Date.now(),\n\t})\n\tswitch (action.type) {\n\t\tcase 'publishNewestState': {\n\t\t\treturn publishNewState()\n\t\t}\n\t\tcase 'initialize': {\n\t\t\tfor (const [fileId, metadata] of action.files) {\n\t\t\t\t// Deliberately allowing starting a new upload with the same id\n\n\t\t\t\tpreviousState.liveState.set(fileId, {\n\t\t\t\t\treadyState: 'initializing',\n\t\t\t\t\tabortController: metadata.abortController,\n\t\t\t\t\tpreviewUrl: metadata.previewUrl,\n\t\t\t\t\tfile: metadata.file,\n\t\t\t\t})\n\t\t\t\tpreviousState.fileIdByFile.set(metadata.file, fileId)\n\t\t\t}\n\t\t\treturn publishNewState() /* Making the feedback about new files immediate*/\n\t\t}\n\t\tcase 'startUploading': {\n\t\t\tfor (const [fileOrId, metadata] of action.files) {\n\t\t\t\tconst fileId = toFileId(previousState, fileOrId)\n\t\t\t\tconst fileState = previousState.liveState.get(fileId)\n\n\t\t\t\tif (fileState === undefined || fileState.readyState !== 'initializing') {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\n\t\t\t\tpreviousState.liveState.set(fileId, {\n\t\t\t\t\treadyState: 'uploading',\n\t\t\t\t\tabortController: fileState.abortController,\n\t\t\t\t\tfile: fileState.file,\n\t\t\t\t\tmetadata: metadata.metadata!, // If the user didn't supply the metadata, then that's on them.\n\t\t\t\t\tpreviewUrl: fileState.previewUrl,\n\t\t\t\t\tprogress: undefined,\n\t\t\t\t\tuploader: metadata.uploader,\n\t\t\t\t})\n\t\t\t}\n\t\t\treturn publishNewState() /* Making the feedback about started upload immediate*/\n\t\t}\n\t\tcase 'finishSuccessfully': {\n\t\t\tfor (const [fileOrId, result] of action.result) {\n\t\t\t\tconst fileId = toFileId(previousState, fileOrId)\n\t\t\t\tconst previousFileState = previousState.liveState.get(fileId)\n\t\t\t\tif (previousFileState === undefined || previousFileState.readyState !== 'uploading') {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tpreviousState.liveState.set(fileId, {\n\t\t\t\t\treadyState: 'success',\n\t\t\t\t\tfile: previousFileState.file,\n\t\t\t\t\tmetadata: previousFileState.metadata,\n\t\t\t\t\tpreviewUrl: previousFileState.previewUrl,\n\t\t\t\t\tresult,\n\t\t\t\t\tuploader: previousFileState.uploader,\n\t\t\t\t})\n\t\t\t}\n\t\t\t// return publishNewState() // Making the feedback about successful upload immediate.\n\t\t\treturn getNewDirtyState()\n\t\t}\n\t\tcase 'finishWithError': {\n\t\t\tfor (const errorSpec of action.error) {\n\t\t\t\tlet fileOrId: File | FileId\n\t\t\t\tlet rawError: unknown\n\n\t\t\t\tif (Array.isArray(errorSpec)) {\n\t\t\t\t\t[fileOrId, rawError] = errorSpec\n\t\t\t\t} else {\n\t\t\t\t\tfileOrId = errorSpec\n\t\t\t\t\trawError = undefined\n\t\t\t\t}\n\n\t\t\t\tconst errors: FileUploadError[] = []\n\n\t\t\t\tif (rawError instanceof FileUploadError) {\n\t\t\t\t\terrors.push(rawError)\n\t\t\t\t} else if (Array.isArray(rawError)) {\n\t\t\t\t\tfor (const error of rawError) {\n\t\t\t\t\t\tif (error instanceof FileUploadError) {\n\t\t\t\t\t\t\terrors.push(error)\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tconst fileId = toFileId(previousState, fileOrId)\n\t\t\t\tconst previousFileState = previousState.liveState.get(fileId)\n\t\t\t\tif (\n\t\t\t\t\tpreviousFileState === undefined ||\n\t\t\t\t\t(previousFileState.readyState !== 'initializing' && previousFileState.readyState !== 'uploading')\n\t\t\t\t) {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tconst uploader = previousFileState.readyState === 'uploading' ? previousFileState.uploader : undefined\n\t\t\t\tconst metadata = previousFileState.readyState === 'uploading' ? previousFileState.metadata : undefined\n\t\t\t\tpreviousState.liveState.set(fileId, {\n\t\t\t\t\treadyState: 'error',\n\t\t\t\t\terrors: errors.length ? errors : undefined,\n\t\t\t\t\trawError,\n\t\t\t\t\tfile: previousFileState.file,\n\t\t\t\t\tmetadata,\n\t\t\t\t\tpreviewUrl: previousFileState.previewUrl,\n\t\t\t\t\tuploader,\n\t\t\t\t})\n\t\t\t}\n\t\t\treturn getNewDirtyState() // Bad news can wait.\n\t\t}\n\t\tcase 'purge': {\n\t\t\tlet atLeastOnePurged = false\n\t\t\tfor (const fileOrId of action.files) {\n\t\t\t\tconst fileId = toFileId(previousState, fileOrId)\n\t\t\t\tconst fileState = previousState.liveState.get(fileId)\n\n\t\t\t\tif (fileState === undefined) {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tatLeastOnePurged = true\n\t\t\t\tif (fileState.readyState === 'initializing' || fileState.readyState === 'uploading') {\n\t\t\t\t\tfileState.abortController.abort() // This is a bit naughty… We shouldn't do this from here.\n\t\t\t\t}\n\t\t\t\tpreviousState.liveState.delete(fileId)\n\t\t\t}\n\t\t\tif (atLeastOnePurged) {\n\t\t\t\treturn getNewDirtyState()\n\t\t\t}\n\t\t\treturn previousState\n\t\t}\n\t\tcase 'updateUploadProgress': {\n\t\t\tfor (const [fileOrId, { progress }] of action.progress) {\n\t\t\t\tconst fileId = toFileId(previousState, fileOrId)\n\t\t\t\tconst previousFileState = previousState.liveState.get(fileId)\n\t\t\t\tif (progress === undefined || previousFileState === undefined || previousFileState.readyState !== 'uploading') {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tpreviousState.liveState.set(fileId, {\n\t\t\t\t\treadyState: 'uploading',\n\t\t\t\t\tfile: previousFileState.file,\n\t\t\t\t\tuploader: previousFileState.uploader,\n\t\t\t\t\tabortController: previousFileState.abortController,\n\t\t\t\t\tpreviewUrl: previousFileState.previewUrl,\n\t\t\t\t\tmetadata: previousFileState.metadata,\n\t\t\t\t\tprogress,\n\t\t\t\t})\n\t\t\t}\n\t\t\treturn getNewDirtyState()\n\t\t}\n\t}\n\tassertNever(action)\n}\n"],"names":[],"mappings":"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"}

package/dist/production/upload/toFileId.js

@@ -0,0 +1,8 @@
+const toFileId = (state, fileOrId) => {
+  if (fileOrId instanceof File) {
+    return state.fileIdByFile.get(fileOrId);
+  }
+  return fileOrId;
+};
+export { toFileId };
+//# sourceMappingURL=toFileId.js.map

package/dist/production/upload/toFileId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toFileId.js","sources":["../../../src/upload/toFileId.ts"],"sourcesContent":["import type { FileId } from './FileId'\nimport type { FileUploadMultiTemporalState } from './FileUploadMultiTemporalState'\n\nexport const toFileId = <Result = unknown, Metadata = undefined>(\n\tstate: FileUploadMultiTemporalState<Result, Metadata>,\n\tfileOrId: File | FileId,\n) => {\n\tif (fileOrId instanceof File) {\n\t\treturn state.fileIdByFile.get(fileOrId)! // Should we throw instead of the yolo \"!\"?\n\t}\n\treturn fileOrId\n}\n"],"names":[],"mappings":"MAGa,WAAW,CACvB,OACA,aACI;MACA,oBAAoB,MAAM;WACtB,MAAM,aAAa,IAAI;AAAA;SAExB;AAAA;;"}

package/dist/production/upload/useFileUpload.js

@@ -0,0 +1,190 @@
+import { S3FileUploader } from "@contember/client";
+import { useRef, useReducer, useMemo, useEffect, useCallback } from "react";
+import { fileUploadReducer, initializeFileUploadState } from "./fileUploadReducer.js";
+import { toFileId } from "./toFileId.js";
+import { useCurrentContentGraphQlClient } from "../content/useCurrentContentGraphQlClient.js";
+const useFileUpload = (options) => {
+  const maxUpdateFrequency = options?.maxUpdateFrequency ?? 100;
+  const contentApiClient = useCurrentContentGraphQlClient();
+  const updateTimeoutRef = useRef(void 0);
+  const isFirstRenderRef = useRef(true);
+  const fileIdSeedRef = useRef(1);
+  const [multiTemporalState, dispatch] = useReducer(fileUploadReducer, void 0, initializeFileUploadState);
+  const multiTemporalStateRef = useRef(multiTemporalState);
+  const defaultUploader = useMemo(() => new S3FileUploader(), []);
+  useEffect(() => {
+    multiTemporalStateRef.current = multiTemporalState;
+  });
+  const purgeUpload = useCallback((files) => {
+    dispatch({
+      type: "purge",
+      files
+    });
+  }, []);
+  const failUpload = useCallback((error) => {
+    dispatch({
+      type: "finishWithError",
+      error
+    });
+  }, []);
+  const initializeUpload = useCallback((files) => {
+    const newFileIds = new Set();
+    const fileWithMetadataByFileConfig = new Map();
+    for (const fileMaybeWithId of files) {
+      const abortController = new AbortController();
+      let fileId;
+      let file;
+      if (fileMaybeWithId instanceof File) {
+        fileId = `__contember__file-${fileIdSeedRef.current++}`;
+        file = fileMaybeWithId;
+      } else {
+        fileId = fileMaybeWithId[0];
+        file = fileMaybeWithId[1];
+      }
+      abortController.signal.addEventListener("abort", () => {
+        purgeUpload([fileId]);
+      });
+      fileWithMetadataByFileConfig.set(fileId, {
+        previewUrl: URL.createObjectURL(file),
+        abortController,
+        file,
+        fileId
+      });
+      newFileIds.add(fileId);
+    }
+    if (fileWithMetadataByFileConfig.size === 0) {
+      return fileWithMetadataByFileConfig;
+    }
+    if (newFileIds.size) {
+      dispatch({
+        type: "purge",
+        files: newFileIds
+      });
+    }
+    dispatch({
+      type: "initialize",
+      files: fileWithMetadataByFileConfig
+    });
+    return fileWithMetadataByFileConfig;
+  }, [purgeUpload]);
+  const startUpload = useCallback((files) => {
+    const filesById = new Map();
+    const groupedByUploader = new Map();
+    const currentState = multiTemporalStateRef.current;
+    for (const fileOrIdMaybeWithOptions of files) {
+      let fileOrId;
+      let options2;
+      if (Array.isArray(fileOrIdMaybeWithOptions)) {
+        fileOrId = fileOrIdMaybeWithOptions[0];
+        options2 = fileOrIdMaybeWithOptions[1];
+      } else {
+        fileOrId = fileOrIdMaybeWithOptions;
+        options2 = {};
+      }
+      const { uploader = defaultUploader, metadata } = options2;
+      const fileId = toFileId(currentState, fileOrId);
+      const fileState = currentState.liveState.get(fileId);
+      if (fileState === void 0 || fileState.readyState !== "initializing") {
+        throw new Error(`Trying to startUpload a file that hasn't been previously initialized. This will be possible in future, but isn't yet.`);
+      }
+      filesById.set(fileId, {
+        uploader,
+        metadata
+      });
+      let filesWithSameUploader = groupedByUploader.get(uploader);
+      if (filesWithSameUploader === void 0) {
+        groupedByUploader.set(uploader, filesWithSameUploader = new Map());
+      }
+      filesWithSameUploader.set(fileState.file, {
+        abortSignal: fileState.abortController.signal
+      });
+    }
+    dispatch({
+      type: "startUploading",
+      files: filesById
+    });
+    for (const [uploader, filesForUpload] of groupedByUploader) {
+      try {
+        uploader.upload(filesForUpload, {
+          onProgress: (progress) => {
+            dispatch({
+              type: "updateUploadProgress",
+              progress
+            });
+          },
+          onSuccess: (result) => {
+            dispatch({
+              type: "finishSuccessfully",
+              result
+            });
+          },
+          onError: (error) => {
+            dispatch({
+              type: "finishWithError",
+              error
+            });
+          },
+          contentApiClient
+        });
+      } catch (error) {
+        dispatch({
+          type: "finishWithError",
+          error: Array.from(filesForUpload).map(([file]) => [file, error])
+        });
+      }
+    }
+  }, [contentApiClient, defaultUploader]);
+  const operations = useMemo(() => ({
+    failUpload,
+    initializeUpload,
+    purgeUpload,
+    startUpload
+  }), [failUpload, initializeUpload, purgeUpload, startUpload]);
+  useEffect(() => {
+    if (isFirstRenderRef.current) {
+      return;
+    }
+    if (multiTemporalState.isLiveStateDirty) {
+      const now = Date.now();
+      const timeDelta = Math.max(now - multiTemporalState.lastUpdateTime, 0);
+      if (timeDelta > maxUpdateFrequency) {
+        if (updateTimeoutRef.current !== void 0) {
+          clearTimeout(updateTimeoutRef.current);
+        }
+        dispatch({
+          type: "publishNewestState"
+        });
+      } else {
+        if (updateTimeoutRef.current !== void 0) {
+          return;
+        }
+        updateTimeoutRef.current = window.setTimeout(() => {
+          dispatch({
+            type: "publishNewestState"
+          });
+          updateTimeoutRef.current = void 0;
+        }, maxUpdateFrequency - timeDelta);
+      }
+    }
+  }, [
+    multiTemporalState.isLiveStateDirty,
+    multiTemporalState.lastUpdateTime,
+    multiTemporalState.liveState,
+    multiTemporalState.publicState,
+    maxUpdateFrequency
+  ]);
+  useEffect(() => () => {
+    for (const [, state] of multiTemporalStateRef.current.liveState) {
+      URL.revokeObjectURL(state.previewUrl);
+    }
+    for (const [, state] of multiTemporalStateRef.current.publicState) {
+      URL.revokeObjectURL(state.previewUrl);
+    }
+  }, []);
+  useEffect(() => {
+    isFirstRenderRef.current = false;
+  }, []);
+  return [multiTemporalState.publicState, operations];
+};
+export { useFileUpload };
+//# sourceMappingURL=useFileUpload.js.map

package/dist/production/upload/useFileUpload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFileUpload.js","sources":["../../../src/upload/useFileUpload.ts"],"sourcesContent":["import { FileUploader, S3FileUploader, UploadedFileMetadata } from '@contember/client'\nimport { Reducer, useCallback, useEffect, useMemo, useReducer, useRef } from 'react'\nimport { useCurrentContentGraphQlClient } from '../content'\nimport type { FileId } from './FileId'\nimport type { FileUploadAction } from './FileUploadAction'\nimport type { FileUploadCompoundState } from './FileUploadCompoundState'\nimport type { FileUploadMetadata } from './FileUploadMetadata'\nimport type { FileUploadMultiTemporalState } from './FileUploadMultiTemporalState'\nimport type {\n\tPurgeUpload,\n\tFileUploadOperations,\n\tInitializeUpload,\n\tStartUpload,\n\tStartUploadFileOptions,\n\tFailUpload,\n} from './FileUploadOperations'\nimport { fileUploadReducer, initializeFileUploadState } from './fileUploadReducer'\nimport type { FileWithMetadata } from './FileWithMetadata'\nimport { toFileId } from './toFileId'\n\nexport type FileUpload<Result = unknown, Metadata = undefined> = [\n\tFileUploadCompoundState<Result, Metadata>,\n\tFileUploadOperations<Metadata>,\n]\n\nexport interface FileUploadOptions {\n\tmaxUpdateFrequency?: number // This does NOT apply to all kinds of updates.\n}\n\nexport const useFileUpload = <Result = unknown, Metadata = undefined>(\n\toptions?: FileUploadOptions,\n): FileUpload<Result, Metadata> => {\n\tconst maxUpdateFrequency = options?.maxUpdateFrequency ?? 100\n\n\tconst contentApiClient = useCurrentContentGraphQlClient()\n\n\tconst updateTimeoutRef = useRef<number | undefined>(undefined)\n\tconst isFirstRenderRef = useRef(true)\n\tconst fileIdSeedRef = useRef(1)\n\n\tconst [multiTemporalState, dispatch] = useReducer<\n\t\tReducer<FileUploadMultiTemporalState<Result, Metadata>, FileUploadAction<Result, Metadata>>,\n\t\tundefined\n\t>(fileUploadReducer, undefined, initializeFileUploadState)\n\tconst multiTemporalStateRef = useRef(multiTemporalState)\n\n\tconst defaultUploader = useMemo(() => new S3FileUploader(), [])\n\n\tuseEffect(() => {\n\t\tmultiTemporalStateRef.current = multiTemporalState\n\t})\n\n\tconst purgeUpload = useCallback<PurgeUpload>(files => {\n\t\tdispatch({\n\t\t\ttype: 'purge',\n\t\t\tfiles,\n\t\t})\n\t}, [])\n\tconst failUpload = useCallback<FailUpload>(error => {\n\t\tdispatch({\n\t\t\ttype: 'finishWithError',\n\t\t\terror,\n\t\t})\n\t}, [])\n\tconst initializeUpload = useCallback<InitializeUpload>(\n\t\tfiles => {\n\t\t\tconst newFileIds = new Set<FileId>()\n\t\t\tconst fileWithMetadataByFileConfig = new Map<FileId, FileWithMetadata>()\n\n\t\t\tfor (const fileMaybeWithId of files) {\n\t\t\t\tconst abortController = new AbortController()\n\n\t\t\t\tlet fileId: FileId\n\t\t\t\tlet file: File\n\n\t\t\t\tif (fileMaybeWithId instanceof File) {\n\t\t\t\t\tfileId = `__contember__file-${fileIdSeedRef.current++}`\n\t\t\t\t\tfile = fileMaybeWithId\n\t\t\t\t} else {\n\t\t\t\t\tfileId = fileMaybeWithId[0]\n\t\t\t\t\tfile = fileMaybeWithId[1]\n\t\t\t\t}\n\n\t\t\t\tabortController.signal.addEventListener('abort', () => {\n\t\t\t\t\tpurgeUpload([fileId])\n\t\t\t\t})\n\n\t\t\t\tfileWithMetadataByFileConfig.set(fileId, {\n\t\t\t\t\tpreviewUrl: URL.createObjectURL(file),\n\t\t\t\t\tabortController,\n\t\t\t\t\tfile,\n\t\t\t\t\tfileId,\n\t\t\t\t})\n\n\t\t\t\tnewFileIds.add(fileId)\n\t\t\t}\n\t\t\tif (fileWithMetadataByFileConfig.size === 0) {\n\t\t\t\treturn fileWithMetadataByFileConfig\n\t\t\t}\n\n\t\t\tif (newFileIds.size) {\n\t\t\t\tdispatch({\n\t\t\t\t\ttype: 'purge',\n\t\t\t\t\tfiles: newFileIds,\n\t\t\t\t})\n\t\t\t}\n\n\t\t\tdispatch({\n\t\t\t\ttype: 'initialize',\n\t\t\t\tfiles: fileWithMetadataByFileConfig,\n\t\t\t})\n\n\t\t\treturn fileWithMetadataByFileConfig\n\t\t},\n\t\t[purgeUpload],\n\t)\n\tconst startUpload = useCallback<StartUpload<Metadata>>(\n\t\tfiles => {\n\t\t\tconst filesById = new Map<FileId, FileUploadMetadata<Metadata>>()\n\t\t\tconst groupedByUploader: Map<FileUploader, Map<File, UploadedFileMetadata>> = new Map()\n\n\t\t\tconst currentState = multiTemporalStateRef.current\n\n\t\t\tfor (const fileOrIdMaybeWithOptions of files) {\n\t\t\t\tlet fileOrId: File | FileId\n\t\t\t\tlet options: StartUploadFileOptions<Metadata>\n\n\t\t\t\tif (Array.isArray(fileOrIdMaybeWithOptions)) {\n\t\t\t\t\tfileOrId = fileOrIdMaybeWithOptions[0]\n\t\t\t\t\toptions = fileOrIdMaybeWithOptions[1]\n\t\t\t\t} else {\n\t\t\t\t\tfileOrId = fileOrIdMaybeWithOptions\n\t\t\t\t\toptions = {}\n\t\t\t\t}\n\t\t\t\tconst { uploader = defaultUploader, metadata } = options\n\n\t\t\t\tconst fileId = toFileId(currentState, fileOrId)\n\t\t\t\tconst fileState = currentState.liveState.get(fileId)\n\n\t\t\t\tif (fileState === undefined || fileState.readyState !== 'initializing') {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`Trying to startUpload a file that hasn't been previously initialized. ` +\n\t\t\t\t\t\t\t`This will be possible in future, but isn't yet.`,\n\t\t\t\t\t)\n\t\t\t\t}\n\n\t\t\t\tfilesById.set(fileId, {\n\t\t\t\t\tuploader,\n\t\t\t\t\tmetadata,\n\t\t\t\t})\n\n\t\t\t\tlet filesWithSameUploader = groupedByUploader.get(uploader)\n\t\t\t\tif (filesWithSameUploader === undefined) {\n\t\t\t\t\tgroupedByUploader.set(uploader, (filesWithSameUploader = new Map()))\n\t\t\t\t}\n\t\t\t\tfilesWithSameUploader.set(fileState.file, {\n\t\t\t\t\tabortSignal: fileState.abortController.signal,\n\t\t\t\t})\n\t\t\t}\n\n\t\t\tdispatch({\n\t\t\t\ttype: 'startUploading',\n\t\t\t\tfiles: filesById,\n\t\t\t})\n\n\t\t\tfor (const [uploader, filesForUpload] of groupedByUploader) {\n\t\t\t\ttry {\n\t\t\t\t\tuploader.upload(filesForUpload, {\n\t\t\t\t\t\tonProgress: progress => {\n\t\t\t\t\t\t\tdispatch({\n\t\t\t\t\t\t\t\ttype: 'updateUploadProgress',\n\t\t\t\t\t\t\t\tprogress,\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t},\n\t\t\t\t\t\tonSuccess: result => {\n\t\t\t\t\t\t\tdispatch({\n\t\t\t\t\t\t\t\ttype: 'finishSuccessfully',\n\t\t\t\t\t\t\t\tresult,\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t},\n\t\t\t\t\t\tonError: error => {\n\t\t\t\t\t\t\tdispatch({\n\t\t\t\t\t\t\t\ttype: 'finishWithError',\n\t\t\t\t\t\t\t\terror,\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t},\n\t\t\t\t\t\tcontentApiClient,\n\t\t\t\t\t})\n\t\t\t\t} catch (error) {\n\t\t\t\t\tdispatch({\n\t\t\t\t\t\ttype: 'finishWithError',\n\t\t\t\t\t\terror: Array.from(filesForUpload).map(([file]) => [file, error]),\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t[contentApiClient, defaultUploader],\n\t)\n\n\tconst operations = useMemo<FileUploadOperations<Metadata>>(\n\t\t() => ({\n\t\t\tfailUpload,\n\t\t\tinitializeUpload,\n\t\t\tpurgeUpload,\n\t\t\tstartUpload,\n\t\t}),\n\t\t[failUpload, initializeUpload, purgeUpload, startUpload],\n\t)\n\n\tuseEffect(() => {\n\t\tif (isFirstRenderRef.current) {\n\t\t\treturn\n\t\t}\n\t\tif (multiTemporalState.isLiveStateDirty) {\n\t\t\tconst now = Date.now()\n\t\t\tconst timeDelta = Math.max(now - multiTemporalState.lastUpdateTime, 0) // The max is just a sanity check\n\t\t\tif (timeDelta > maxUpdateFrequency) {\n\t\t\t\tif (updateTimeoutRef.current !== undefined) {\n\t\t\t\t\tclearTimeout(updateTimeoutRef.current)\n\t\t\t\t}\n\t\t\t\tdispatch({\n\t\t\t\t\ttype: 'publishNewestState',\n\t\t\t\t})\n\t\t\t} else {\n\t\t\t\tif (updateTimeoutRef.current !== undefined) {\n\t\t\t\t\treturn\n\t\t\t\t}\n\t\t\t\tupdateTimeoutRef.current = window.setTimeout(() => {\n\t\t\t\t\tdispatch({\n\t\t\t\t\t\ttype: 'publishNewestState',\n\t\t\t\t\t})\n\t\t\t\t\tupdateTimeoutRef.current = undefined\n\t\t\t\t}, maxUpdateFrequency - timeDelta)\n\t\t\t}\n\t\t}\n\t}, [\n\t\tmultiTemporalState.isLiveStateDirty,\n\t\tmultiTemporalState.lastUpdateTime,\n\t\tmultiTemporalState.liveState,\n\t\tmultiTemporalState.publicState,\n\t\tmaxUpdateFrequency,\n\t])\n\n\tuseEffect(\n\t\t() => () => {\n\t\t\tfor (const [, state] of multiTemporalStateRef.current.liveState) {\n\t\t\t\tURL.revokeObjectURL(state.previewUrl)\n\t\t\t}\n\t\t\tfor (const [, state] of multiTemporalStateRef.current.publicState) {\n\t\t\t\tURL.revokeObjectURL(state.previewUrl)\n\t\t\t}\n\t\t},\n\t\t[],\n\t)\n\n\t// For this to work, this effect must be the last one to run.\n\tuseEffect(() => {\n\t\tisFirstRenderRef.current = false\n\t}, [])\n\n\treturn [multiTemporalState.publicState, operations]\n}\n"],"names":[],"mappings":"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"}

package/dist/production/useGraphQlClient.js

@@ -0,0 +1,11 @@
+import { GraphQlClient } from "@contember/client";
+import { useMemo } from "react";
+import { useApiBaseUrl } from "./config/useApiBaseUrl.js";
+import { useSessionToken } from "./auth/useSessionToken.js";
+const useGraphQlClient = (path) => {
+  const apiBaseUrl = useApiBaseUrl();
+  const sessionToken = useSessionToken();
+  return useMemo(() => new GraphQlClient(`${apiBaseUrl}${path}`, sessionToken), [apiBaseUrl, path, sessionToken]);
+};
+export { useGraphQlClient };
+//# sourceMappingURL=useGraphQlClient.js.map

package/dist/production/useGraphQlClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGraphQlClient.js","sources":["../../src/useGraphQlClient.ts"],"sourcesContent":["import { GraphQlClient } from '@contember/client'\nimport { useMemo } from 'react'\nimport { useSessionToken } from './auth'\nimport { useApiBaseUrl } from './config'\n\nexport const useGraphQlClient = (path: string): GraphQlClient => {\n\tconst apiBaseUrl = useApiBaseUrl()\n\tconst sessionToken = useSessionToken()\n\treturn useMemo(() => new GraphQlClient(`${apiBaseUrl}${path}`, sessionToken), [apiBaseUrl, path, sessionToken])\n}\n"],"names":[],"mappings":";;;;MAKa,mBAAmB,CAAC,SAAgC;QAC1D,aAAa;QACb,eAAe;SACd,QAAQ,MAAM,IAAI,cAAc,GAAG,aAAa,QAAQ,eAAe,CAAC,YAAY,MAAM;AAAA;;"}

package/dist/production/utils/assertNever.js

@@ -0,0 +1,5 @@
+function assertNever(_) {
+  throw new Error();
+}
+export { assertNever };
+//# sourceMappingURL=assertNever.js.map

package/dist/production/utils/assertNever.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertNever.js","sources":["../../../src/utils/assertNever.ts"],"sourcesContent":["export function assertNever(_: never): asserts _ is never {\n\tthrow new Error()\n}\n"],"names":[],"mappings":"qBAA4B,GAA8B;QACnD,IAAI;AAAA;;"}

package/dist/react-client.d.ts

@@ -0,0 +1,370 @@
+/// <reference types="react" />
+
+import type { ComponentType } from 'react';
+import { Context } from 'react';
+import { DiffQueryResponse } from '@contember/client';
+import type { FileUploader } from '@contember/client';
+import type { FileUploadError } from '@contember/client';
+import { GraphQlClient } from '@contember/client';
+import type { GraphQlClientFailedRequestMetadata } from '@contember/client';
+import type { GraphQlClientRequestOptions } from '@contember/client';
+import type { GraphQlClientVariables } from '@contember/client';
+import { LoginMutationResponse } from '@contember/client';
+import { NamedExoticComponent } from 'react';
+import { ReactElement } from 'react';
+import type { ReactNode } from 'react';
+import { ReleaseTreeMutationResponse } from '@contember/client';
+import { TreeFilter } from '@contember/client';
+
+export declare const ApiBaseUrlContext: Context<string | undefined>;
+
+export declare type ApiRequestAction<SuccessData> = {
+    type: 'uninitialize';
+} | {
+    type: 'initialize';
+} | {
+    type: 'resolveSuccessfully';
+    data: SuccessData;
+} | {
+    type: 'resolveWithError';
+    error: GraphQlClientFailedRequestMetadata;
+};
+
+export declare type ApiRequestReducer<SuccessData> = (previousState: ApiRequestState<SuccessData>, action: ApiRequestAction<SuccessData>) => ApiRequestState<SuccessData>;
+
+export declare const apiRequestReducer: <SuccessData>(previousState: ApiRequestState<SuccessData>, action: ApiRequestAction<SuccessData>) => ApiRequestState<SuccessData>;
+
+export declare type ApiRequestState<SuccessData> = {
+    isLoading: false;
+    isFinished: false;
+    readyState: 'uninitialized';
+} | {
+    isLoading: true;
+    isFinished: false;
+    readyState: 'pending';
+} | {
+    isLoading: false;
+    isFinished: true;
+    readyState: 'networkSuccess';
+    data: SuccessData;
+} | {
+    isLoading: false;
+    isFinished: true;
+    readyState: 'networkError';
+    data: GraphQlClientFailedRequestMetadata;
+};
+
+export declare type BuiltinElements<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> = RichTextAnchorElement<CustomElements, CustomLeaves> | RichTextHeadingElement<CustomElements, CustomLeaves> | RichTextHorizontalRuleElement<CustomElements, CustomLeaves> | RichTextListItemElement<CustomElements, CustomLeaves> | RichTextOrderedListElement<CustomElements, CustomLeaves> | RichTextParagraphElement<CustomElements, CustomLeaves> | RichTextReferenceElement<CustomElements, CustomLeaves> | RichTextScrollTargetElement<CustomElements, CustomLeaves> | RichTextTableCellElement<CustomElements, CustomLeaves> | RichTextTableElement<CustomElements, CustomLeaves> | RichTextTableRowElement<CustomElements, CustomLeaves> | RichTextUnorderedListElement<CustomElements, CustomLeaves>;
+
+export declare type BuiltinLeaves = RichTextBoldLeaf & RichTextCodeLeaf & RichTextHighlightLeaf & RichTextItalicLeaf & RichTextStrikeThroughLeaf & RichTextUnderlineLeaf;
+
+export declare class ClientError extends Error {
+}
+
+export declare const ContemberClient: NamedExoticComponent<ContemberClientProps & {
+children: React.ReactNode;
+}>;
+
+export declare interface ContemberClientProps {
+    apiBaseUrl: string;
+    sessionToken?: string;
+    loginToken?: string;
+    project?: string;
+    stage?: string;
+}
+
+export declare type FailUpload = (files: Iterable<FileId | File | [FileId | File, any]>) => void;
+
+export declare type FileId = string | number;
+
+export declare type FileUpload<Result = unknown, Metadata = undefined> = [
+FileUploadCompoundState<Result, Metadata>,
+FileUploadOperations<Metadata>
+];
+
+export declare type FileUploadCompoundState<Result = unknown, Metadata = undefined> = Map<FileId, SingleFileUploadState<Result, Metadata>>;
+
+export declare interface FileUploadMetadata<Metadata = undefined> {
+    uploader: FileUploader;
+    metadata: Metadata | undefined;
+}
+
+export declare interface FileUploadOperations<Metadata = undefined> {
+    initializeUpload: InitializeUpload;
+    startUpload: StartUpload<Metadata>;
+    purgeUpload: PurgeUpload;
+    failUpload: FailUpload;
+}
+
+export declare interface FileUploadOptions {
+    maxUpdateFrequency?: number;
+}
+
+export declare interface FileWithMetadata {
+    file: File;
+    fileId: FileId;
+    abortController: AbortController;
+    previewUrl: string;
+}
+
+export declare type InitializeUpload = (files: Iterable<[FileId, File] | File>) => Map<FileId, FileWithMetadata>;
+
+export declare const LoginTokenContext: Context<string | undefined>;
+
+export declare const ProjectSlugContext: Context<string | undefined>;
+
+export declare type PurgeUpload = (files: Iterable<FileId | File>) => void;
+
+export declare type ReferenceRenderer<Reference extends RichTextReference = RichTextReference, CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> = (props: ReferenceRendererProps<Reference, CustomElements, CustomLeaves>) => ReactNode;
+
+export declare type ReferenceRendererProps<Reference extends RichTextReference = RichTextReference, CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> = {
+    element: CustomElements | BuiltinElements<CustomElements, CustomLeaves>;
+    children: ReactElement;
+} & {
+    [Prop in keyof RichTextElementMetadata<CustomElements, CustomLeaves, Reference>]: Exclude<RichTextElementMetadata<CustomElements, CustomLeaves, Reference>[Prop], undefined>;
+};
+
+export declare interface RenderChildrenOptions<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> {
+    renderElement?: RenderElement<CustomElements, CustomLeaves>;
+    renderLeaf?: RenderLeaf<CustomLeaves>;
+    attributeNamePrefix?: string;
+}
+
+export declare type RenderElement<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never, Reference extends RichTextReference = RichTextReference> = ComponentType<{
+    element: CustomElements | BuiltinElements<CustomElements, CustomLeaves>;
+    children: ReactElement;
+    fallback: ReactElement;
+    renderChildren: (children: CustomElements | BuiltinElements<CustomElements, CustomLeaves> | CustomLeaves | BuiltinLeaves | Array<CustomElements | BuiltinElements<CustomElements, CustomLeaves> | CustomLeaves | BuiltinLeaves>, options: RenderChildrenOptions<CustomElements, CustomLeaves>) => ReactElement;
+    renderChildrenOptions: RenderChildrenOptions<CustomElements, CustomLeaves>;
+} & RichTextElementMetadata<CustomElements, CustomLeaves, Reference>>;
+
+export declare type RenderLeaf<CustomLeaves extends RichTextLeaf> = ComponentType<{
+    leaf: CustomLeaves | BuiltinLeaves;
+    fallback: ReactElement;
+} & RichTextLeafMetadata>;
+
+export declare interface RichTextAnchorElement<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> extends RichTextElement<CustomElements, CustomLeaves> {
+    type: 'anchor';
+    href: string;
+}
+
+export declare type RichTextBlock = Record<string, unknown>;
+
+export declare interface RichTextBoldLeaf extends RichTextLeaf {
+    isBold?: boolean;
+}
+
+export declare interface RichTextCodeLeaf extends RichTextLeaf {
+    isCode?: boolean;
+}
+
+export declare interface RichTextElement<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> {
+    type: string;
+    children: RichTextElement<CustomElements, CustomLeaves>[] | Array<CustomLeaves | RichTextLeaf>;
+    referenceId?: string;
+}
+
+export declare interface RichTextElementMetadata<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never, Reference extends RichTextReference = RichTextReference> {
+    formatVersion: number;
+    reference: Reference | undefined;
+    referenceType: string | undefined;
+    referenceRenderer: ReferenceRenderer<Reference, CustomElements, CustomLeaves> | undefined;
+}
+
+export declare interface RichTextHeadingElement<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> extends RichTextElement<CustomElements, CustomLeaves> {
+    type: 'heading';
+    level: 1 | 2 | 3 | 4 | 5 | 6;
+    isNumbered?: boolean;
+}
+
+export declare interface RichTextHighlightLeaf extends RichTextLeaf {
+    isHighlighted?: boolean;
+}
+
+export declare interface RichTextHorizontalRuleElement<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> extends RichTextElement<CustomElements, CustomLeaves> {
+    type: 'horizontalRule';
+}
+
+export declare interface RichTextItalicLeaf extends RichTextLeaf {
+    isItalic?: boolean;
+}
+
+export declare interface RichTextLeaf {
+    text: string;
+}
+
+export declare interface RichTextLeafMetadata {
+    formatVersion: number;
+}
+
+export declare interface RichTextListItemElement<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> extends RichTextElement<CustomElements, CustomLeaves> {
+    type: 'listItem';
+}
+
+export declare interface RichTextOrderedListElement<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> extends RichTextElement<CustomElements, CustomLeaves> {
+    type: 'orderedList';
+}
+
+export declare interface RichTextParagraphElement<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> extends RichTextElement<CustomElements, CustomLeaves> {
+    type: 'paragraph';
+    isNumbered?: boolean;
+}
+
+export declare interface RichTextReference {
+    id: string;
+}
+
+export declare interface RichTextReferenceElement<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> extends RichTextElement<CustomElements, CustomLeaves> {
+    type: 'reference';
+    referenceId: string;
+}
+
+export declare const RichTextRenderer: <CustomElements extends RichTextElement<never, never> = never, CustomLeaves extends RichTextLeaf = never>(props: RichTextRendererProps<CustomElements, CustomLeaves>) => ReactElement;
+
+export declare interface RichTextRendererBlockProps<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> {
+    blocks: RichTextBlock[];
+    referenceRenderers?: Record<string, ReferenceRenderer<any, CustomElements, CustomLeaves>>;
+    sourceField?: string;
+    referencesField?: string;
+    referenceDiscriminationField?: string;
+}
+
+export declare class RichTextRendererError extends Error {
+}
+
+export declare interface RichTextRendererFieldProps {
+    source: string | null;
+}
+
+export declare type RichTextRendererProps<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> = {
+    deserialize?: (source: string) => RootEditorNode<CustomElements, CustomLeaves>;
+    renderElement?: RenderElement<CustomElements, CustomLeaves>;
+    renderLeaf?: RenderLeaf<CustomLeaves>;
+    attributeNamePrefix?: string;
+} & (RichTextRendererFieldProps | RichTextRendererBlockProps<CustomElements, CustomLeaves>);
+
+export declare interface RichTextScrollTargetElement<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> extends RichTextElement<CustomElements, CustomLeaves> {
+    type: 'scrollTarget';
+    identifier: string;
+}
+
+export declare interface RichTextStrikeThroughLeaf extends RichTextLeaf {
+    isStruckThrough?: boolean;
+}
+
+export declare interface RichTextTableCellElement<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> extends RichTextElement<CustomElements, CustomLeaves> {
+    type: 'tableCell';
+    headerScope?: 'row';
+    justify?: 'start' | 'center' | 'end';
+}
+
+export declare interface RichTextTableElement<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> extends RichTextElement<CustomElements, CustomLeaves> {
+    type: 'table';
+}
+
+export declare interface RichTextTableRowElement<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> extends RichTextElement<CustomElements, CustomLeaves> {
+    type: 'tableRow';
+    headerScope?: 'table';
+}
+
+export declare interface RichTextUnderlineLeaf extends RichTextLeaf {
+    isUnderlined?: boolean;
+}
+
+export declare interface RichTextUnorderedListElement<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> extends RichTextElement<CustomElements, CustomLeaves> {
+    type: 'unorderedList';
+}
+
+export declare interface RootEditorNode<CustomElements extends RichTextElement = never, CustomLeaves extends RichTextLeaf = never> {
+    formatVersion: number;
+    children: Array<BuiltinElements<CustomElements, CustomLeaves> | CustomElements | BuiltinLeaves | CustomLeaves>;
+}
+
+export declare const SessionTokenContext: Context<string | undefined>;
+
+export declare type SingleFileUploadState<Result = unknown, Metadata = undefined> = {
+    readyState: 'initializing';
+    abortController: AbortController;
+    file: File;
+    previewUrl: string;
+} | {
+    readyState: 'uploading';
+    abortController: AbortController;
+    file: File;
+    metadata: Metadata;
+    previewUrl: string;
+    progress: number | undefined;
+    uploader: FileUploader;
+} | {
+    readyState: 'success';
+    file: File;
+    metadata: Metadata;
+    previewUrl: string;
+    result: Result;
+    uploader: FileUploader;
+} | {
+    readyState: 'error';
+    errors: FileUploadError[] | undefined;
+    rawError: any;
+    file: File;
+    metadata: Metadata | undefined;
+    previewUrl: string;
+    uploader: FileUploader | undefined;
+};
+
+export declare const StageSlugContext: Context<string | undefined>;
+
+export declare type StartUpload<Metadata = undefined> = (files: Iterable<FileId | File | [FileId | File, StartUploadFileOptions<Metadata>]>) => void;
+
+export declare interface StartUploadFileOptions<Metadata = undefined> {
+    metadata?: Metadata;
+    uploader?: FileUploader;
+}
+
+export declare const useApiBaseUrl: () => string | undefined;
+
+export declare const useApiRequest: <SuccessData>(client: GraphQlClient) => UseApiRequestResult<SuccessData>;
+
+export declare type UseApiRequestResult<SuccessData> = [
+ApiRequestState<SuccessData>,
+(query: string, variables?: GraphQlClientVariables, options?: Omit<GraphQlClientRequestOptions, 'variables'>) => Promise<SuccessData>
+];
+
+export declare const useContentApiRequest: <SuccessData>() => UseApiRequestResult<SuccessData>;
+
+export declare const useContentGraphQlClient: (projectSlug: string, stageSlug: string) => GraphQlClient;
+
+export declare const useCurrentContentGraphQlClient: () => GraphQlClient;
+
+export declare const useCurrentSystemGraphQlClient: () => GraphQlClient;
+
+export declare const useDiffQuery: () => [ApiRequestState<DiffQueryResponse>, (treeFilter: TreeFilter[]) => Promise<DiffQueryResponse>];
+
+export declare const useFileUpload: <Result = unknown, Metadata = undefined>(options?: FileUploadOptions | undefined) => FileUpload<Result, Metadata>;
+
+export declare const useGraphQlClient: (path: string) => GraphQlClient;
+
+export declare const useLoginRequest: () => [ApiRequestState<LoginMutationResponse>, (email: string, password: string) => Promise<LoginMutationResponse>];
+
+export declare const useLoginToken: () => string | undefined;
+
+export declare const useProjectSlug: () => string | undefined;
+
+export declare const useReleaseTreeMutation: () => [ApiRequestState<ReleaseTreeMutationResponse>, (treeFilter: TreeFilter[]) => Promise<ReleaseTreeMutationResponse>];
+
+export declare const useSessionToken: () => string | undefined;
+
+export declare const useStageSlug: () => string | undefined;
+
+export declare const useSystemApiRequest: <SuccessData>() => UseApiRequestResult<SuccessData>;
+
+export declare const useSystemGraphQlClient: (projectSlug: string) => GraphQlClient;
+
+export declare const useTenantApiRequest: <SuccessData>() => UseApiRequestResult<SuccessData>;
+
+export declare const useTenantGraphQlClient: () => GraphQlClient;
+
+
+export * from "@contember/client";
+
+export { }