@arbidocs/react 0.5.111 → 0.5.112

package/dist/documents/index.js

@@ -0,0 +1,266 @@
+import {
+  useDocuments,
+  useDocument,
+  useSimilarDocuments,
+  refreshDocuments,
+  useRefreshDocuments,
+  adjustTagCounts,
+  SIMILARITY_THRESHOLD,
+  FINISHED_DOCUMENT_STATUSES
+} from "./documents-data.js";
+import {
+  resolveDocumentStatus,
+  isStaleTaskUpdate,
+  isRowNewer,
+  settledByRows,
+  IN_FLIGHT_DOCUMENT_STATUSES
+} from "./processing-order.js";
+import { subscribeDocumentReads } from "./processing-settle.js";
+import { useWorkspaceProcessing, applyTaskEvent } from "./processing-live.js";
+import {
+  useDocumentsLoading,
+  isDocumentsLoading,
+  stopDocumentsLoading,
+  DOCUMENTS_FIRST_PAGE_SIZE,
+  DOCUMENTS_PAGE_SIZE,
+  DOCUMENTS_FIRST_PAGE_MEASURE
+} from "./documents-loader.js";
+import {
+  patchDocuments,
+  upsertDocuments,
+  getCachedDocuments,
+  setCachedDocument,
+  patchCachedDocument,
+  dropTagFromCachedDocuments,
+  forgetDocuments,
+  subscribeDocumentRows
+} from "./documents-cache.js";
+import {
+  useMarkDocumentShared,
+  useUpdateDocuments,
+  useDeleteDocuments,
+  useUploadDocuments,
+  useUploadUrls,
+  useAssignDocTags,
+  useRemoveDocTags,
+  useUpdateDocTag,
+  useGenerateDocTags,
+  useFinaliseTranslation,
+  useRenameFolder,
+  applyOptimisticDocumentEdit,
+  rollbackOptimisticDocumentEdit
+} from "./documents-writes.js";
+import {
+  useDocumentsSupport,
+  useProcessingTasks,
+  useProcessingTask,
+  useDocumentHostActions,
+  useOpenViewerDocumentId
+} from "./support.js";
+import {
+  isDocumentAddableToConversation,
+  getDocumentDate,
+  formatDocDate,
+  getDocumentNature,
+  getDocumentAuthor,
+  getDocumentSubject,
+  DEFAULT_METADATA_TAGS,
+  canonicalFolderPath,
+  buildFolderTree,
+  formatFolderLabel,
+  COLUMN_LABEL_FALLBACKS
+} from "./document-fields.js";
+import { archiveName, buildDocumentMetadataRows, fallbackFileName } from "./document-download.js";
+import { useDownloadDocuments } from "./useDownloadDocuments.js";
+import { useDocumentThumbnails } from "./useDocumentThumbnails.js";
+import { DocumentReview } from "./DocumentReview.js";
+import {
+  useAudioRecorder
+} from "./useAudioRecorder.js";
+import {
+  DEFAULT_SEGMENTER_CONFIG,
+  INITIAL_SEGMENTER_STATE,
+  flushSegmenter,
+  levelFromRms,
+  stepSegmenter
+} from "./audio-segmenter.js";
+import {
+  AUDIO_MIME_PREFERENCE,
+  VIDEO_MIME_PREFERENCE,
+  createChunkedRecorder,
+  pickRecorderMimeType
+} from "./chunked-recorder.js";
+import { MicWaveformIndicator } from "./MicWaveformIndicator.js";
+import { MicRecordingOverlay } from "./MicRecordingOverlay.js";
+import { VoiceNoteRecorder } from "./VoiceNoteRecorder.js";
+import { DraftTitleControls } from "./DraftTitleControls.js";
+import { InlineMicButton } from "./InlineMicButton.js";
+import { formatElapsed } from "./format-elapsed.js";
+import { useCameraStream } from "./useCameraStream.js";
+import {
+  useVideoRecorder
+} from "./useVideoRecorder.js";
+import { captureFrameAsBlob } from "./capture-frame.js";
+import { classifyMediaError } from "./media-error.js";
+import { PhotoCapture } from "./PhotoCapture.js";
+import { VideoCapture } from "./VideoCapture.js";
+import { hasVideoTrack } from "./has-video-track.js";
+import {
+  UPLOAD_ACCEPT,
+  UPLOAD_MAX_FILE_SIZE,
+  extractZipFile,
+  filesFromDrop,
+  isZipFile,
+  prepareUploadFiles,
+  uploadFolderOf,
+  withRelativePath
+} from "./upload-files.js";
+import {
+  useUploadFiles,
+  uploadedDocumentFolder,
+  forgetUploadedDocumentFolder
+} from "./useUploadFiles.js";
+import {
+  useUploadFromUrls
+} from "./useUploadFromUrls.js";
+import {
+  useRelatedDocuments,
+  getRelatedTotal,
+  getRelatedLabels
+} from "./related-documents.js";
+import {
+  usePendingSyncItems,
+  usePendingSyncCounts,
+  useDocumentPendingSync,
+  useCancelManyPendingSync,
+  buildPendingSyncItem,
+  PENDING_SYNC_PREDICATE
+} from "./pending-sync.js";
+import {
+  useOfflineDocumentIds,
+  useKeepDocumentsOffline,
+  useRemoveDocumentsOffline,
+  loadOfflineDocument,
+  getOfflineDocument,
+  wipeOfflineDocuments,
+  requestPersistentStorage
+} from "./offline-documents.js";
+export {
+  AUDIO_MIME_PREFERENCE,
+  COLUMN_LABEL_FALLBACKS,
+  DEFAULT_METADATA_TAGS,
+  DEFAULT_SEGMENTER_CONFIG,
+  DOCUMENTS_FIRST_PAGE_MEASURE,
+  DOCUMENTS_FIRST_PAGE_SIZE,
+  DOCUMENTS_PAGE_SIZE,
+  DocumentReview,
+  DraftTitleControls,
+  FINISHED_DOCUMENT_STATUSES,
+  INITIAL_SEGMENTER_STATE,
+  IN_FLIGHT_DOCUMENT_STATUSES,
+  InlineMicButton,
+  MicRecordingOverlay,
+  MicWaveformIndicator,
+  PENDING_SYNC_PREDICATE,
+  PhotoCapture,
+  SIMILARITY_THRESHOLD,
+  UPLOAD_ACCEPT,
+  UPLOAD_MAX_FILE_SIZE,
+  VIDEO_MIME_PREFERENCE,
+  VideoCapture,
+  VoiceNoteRecorder,
+  adjustTagCounts,
+  applyOptimisticDocumentEdit,
+  applyTaskEvent,
+  archiveName,
+  buildDocumentMetadataRows,
+  buildFolderTree,
+  buildPendingSyncItem,
+  canonicalFolderPath,
+  captureFrameAsBlob,
+  classifyMediaError,
+  createChunkedRecorder,
+  dropTagFromCachedDocuments,
+  extractZipFile,
+  fallbackFileName,
+  filesFromDrop,
+  flushSegmenter,
+  forgetDocuments,
+  forgetUploadedDocumentFolder,
+  formatDocDate,
+  formatElapsed,
+  formatFolderLabel,
+  getCachedDocuments,
+  getDocumentAuthor,
+  getDocumentDate,
+  getDocumentNature,
+  getDocumentSubject,
+  getOfflineDocument,
+  getRelatedLabels,
+  getRelatedTotal,
+  hasVideoTrack,
+  isDocumentAddableToConversation,
+  isDocumentsLoading,
+  isRowNewer,
+  isStaleTaskUpdate,
+  isZipFile,
+  levelFromRms,
+  loadOfflineDocument,
+  patchCachedDocument,
+  patchDocuments,
+  pickRecorderMimeType,
+  prepareUploadFiles,
+  refreshDocuments,
+  requestPersistentStorage,
+  resolveDocumentStatus,
+  rollbackOptimisticDocumentEdit,
+  setCachedDocument,
+  settledByRows,
+  stepSegmenter,
+  stopDocumentsLoading,
+  subscribeDocumentReads,
+  subscribeDocumentRows,
+  uploadFolderOf,
+  uploadedDocumentFolder,
+  upsertDocuments,
+  useAssignDocTags,
+  useAudioRecorder,
+  useCameraStream,
+  useCancelManyPendingSync,
+  useDeleteDocuments,
+  useDocument,
+  useDocumentHostActions,
+  useDocumentPendingSync,
+  useDocumentThumbnails,
+  useDocuments,
+  useDocumentsLoading,
+  useDocumentsSupport,
+  useDownloadDocuments,
+  useFinaliseTranslation,
+  useGenerateDocTags,
+  useKeepDocumentsOffline,
+  useMarkDocumentShared,
+  useOfflineDocumentIds,
+  useOpenViewerDocumentId,
+  usePendingSyncCounts,
+  usePendingSyncItems,
+  useProcessingTask,
+  useProcessingTasks,
+  useRefreshDocuments,
+  useRelatedDocuments,
+  useRemoveDocTags,
+  useRemoveDocumentsOffline,
+  useRenameFolder,
+  useSimilarDocuments,
+  useUpdateDocTag,
+  useUpdateDocuments,
+  useUploadDocuments,
+  useUploadFiles,
+  useUploadFromUrls,
+  useUploadUrls,
+  useVideoRecorder,
+  useWorkspaceProcessing,
+  wipeOfflineDocuments,
+  withRelativePath
+};
+//# sourceMappingURL=index.js.map

package/dist/documents/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/documents/index.ts"],
+  "sourcesContent": ["// The documents of a workspace: reading (progressive), the cache every write patches, the writes\n// (offline-aware), and what a host adds (its live processing state)\nexport {\n  useDocuments,\n  useDocument,\n  useSimilarDocuments,\n  refreshDocuments,\n  useRefreshDocuments,\n  adjustTagCounts,\n  SIMILARITY_THRESHOLD,\n  FINISHED_DOCUMENT_STATUSES,\n} from './documents-data'\nexport {\n  resolveDocumentStatus,\n  isStaleTaskUpdate,\n  isRowNewer,\n  settledByRows,\n  IN_FLIGHT_DOCUMENT_STATUSES,\n  type SequencedTask,\n  type SequencedRow,\n} from './processing-order'\nexport { subscribeDocumentReads } from './processing-settle'\nexport { useWorkspaceProcessing, applyTaskEvent, type WorkspaceProcessing } from './processing-live'\nexport {\n  useDocumentsLoading,\n  isDocumentsLoading,\n  stopDocumentsLoading,\n  DOCUMENTS_FIRST_PAGE_SIZE,\n  DOCUMENTS_PAGE_SIZE,\n  DOCUMENTS_FIRST_PAGE_MEASURE,\n} from './documents-loader'\nexport {\n  patchDocuments,\n  upsertDocuments,\n  getCachedDocuments,\n  setCachedDocument,\n  patchCachedDocument,\n  dropTagFromCachedDocuments,\n  forgetDocuments,\n  subscribeDocumentRows,\n  type WorkspaceDocument,\n  type DocumentRowChange,\n} from './documents-cache'\nexport {\n  useMarkDocumentShared,\n  useUpdateDocuments,\n  useDeleteDocuments,\n  useUploadDocuments,\n  useUploadUrls,\n  useAssignDocTags,\n  useRemoveDocTags,\n  useUpdateDocTag,\n  useGenerateDocTags,\n  useFinaliseTranslation,\n  useRenameFolder,\n  applyOptimisticDocumentEdit,\n  rollbackOptimisticDocumentEdit,\n  type OptimisticDocumentEdit,\n  type UpdateDocumentsInput,\n  type UploadDocumentsInput,\n  type UploadUrlsInput,\n  type AssignDocTagsInput,\n  type RemoveDocTagsInput,\n  type UpdateDocTagInput,\n  type GenerateDocTagsInput,\n} from './documents-writes'\nexport {\n  useDocumentsSupport,\n  useProcessingTasks,\n  useProcessingTask,\n  type DocumentsSupport,\n  type ProcessingTask,\n  useDocumentHostActions,\n  useOpenViewerDocumentId,\n  type DocumentHostActions,\n  type DocumentPerson,\n  type DocumentStartItem,\n} from './support'\nexport {\n  isDocumentAddableToConversation,\n  getDocumentDate,\n  formatDocDate,\n  getDocumentNature,\n  getDocumentAuthor,\n  getDocumentSubject,\n  DEFAULT_METADATA_TAGS,\n  canonicalFolderPath,\n  buildFolderTree,\n  formatFolderLabel,\n  COLUMN_LABEL_FALLBACKS,\n  type FolderTreeNode,\n} from './document-fields'\nexport { archiveName, buildDocumentMetadataRows, fallbackFileName } from './document-download'\nexport { useDownloadDocuments, type UseDownloadDocumentsOptions } from './useDownloadDocuments'\nexport { useDocumentThumbnails } from './useDocumentThumbnails'\n\nexport { DocumentReview, type DocumentReviewProps } from './DocumentReview'\nexport type {\n  ParsedDocument,\n  ParsedChunk,\n  ParsedChunkMetadata,\n  ParsedDocumentMetadata,\n} from './parsed-types'\n\n// Audio recording \u2014 capture engine, shared waveform visual, and a\n// toggle-style recorder built on both. All props-in/callback-out: no store\n// coupling, so a host app can wire persistence however it likes.\nexport {\n  useAudioRecorder,\n  type AudioRecorderState,\n  type AudioSegment,\n  type UseAudioRecorderOptions,\n  type UseAudioRecorderResult,\n} from './useAudioRecorder'\nexport {\n  DEFAULT_SEGMENTER_CONFIG,\n  INITIAL_SEGMENTER_STATE,\n  flushSegmenter,\n  levelFromRms,\n  stepSegmenter,\n  type SegmenterConfig,\n  type SegmenterEvent,\n  type SegmenterState,\n} from './audio-segmenter'\nexport {\n  AUDIO_MIME_PREFERENCE,\n  VIDEO_MIME_PREFERENCE,\n  createChunkedRecorder,\n  pickRecorderMimeType,\n  type ChunkedRecorder,\n  type ChunkedRecorderOptions,\n  type RecordedChunk,\n} from './chunked-recorder'\nexport { MicWaveformIndicator, type MicWaveformIndicatorProps } from './MicWaveformIndicator'\nexport { MicRecordingOverlay, type MicRecordingOverlayProps } from './MicRecordingOverlay'\nexport { VoiceNoteRecorder, type VoiceNoteRecorderProps } from './VoiceNoteRecorder'\nexport { DraftTitleControls, type DraftTitleControlsProps } from './DraftTitleControls'\nexport { InlineMicButton, type InlineMicButtonProps } from './InlineMicButton'\nexport { formatElapsed } from './format-elapsed'\n\n// Camera capture \u2014 the photo/video counterparts to the audio recording\n// engine above. useCameraStream is the shared getUserMedia lifecycle;\n// useVideoRecorder layers MediaRecorder on top of its stream; PhotoCapture/\n// VideoCapture are the props-in/callback-out capture UIs (same shape as\n// VoiceNoteRecorder).\nexport { useCameraStream, type UseCameraStreamResult } from './useCameraStream'\nexport {\n  useVideoRecorder,\n  type UseVideoRecorderResult,\n  type VideoRecorderState,\n} from './useVideoRecorder'\nexport { captureFrameAsBlob } from './capture-frame'\nexport { classifyMediaError } from './media-error'\nexport { PhotoCapture, type PhotoCaptureProps } from './PhotoCapture'\nexport { VideoCapture, type VideoCaptureProps } from './VideoCapture'\n\n// Content-based audio/video classification for containers (like .webm) whose\n// extension alone doesn't say which one they are.\nexport { hasVideoTrack } from './has-video-track'\n// Uploading: choosing files (folders, zip archives, refusals), the upload with progress, and adding\n// from web addresses\nexport {\n  UPLOAD_ACCEPT,\n  UPLOAD_MAX_FILE_SIZE,\n  extractZipFile,\n  filesFromDrop,\n  isZipFile,\n  prepareUploadFiles,\n  uploadFolderOf,\n  withRelativePath,\n  type ExtractedZip,\n  type RefusedUploadFile,\n  type UploadRefusal,\n  type ZipExtractor,\n} from './upload-files'\nexport {\n  useUploadFiles,\n  uploadedDocumentFolder,\n  forgetUploadedDocumentFolder,\n  type UploadFilesInput,\n  type UploadFilesProgress,\n  type UploadFilesResult,\n} from './useUploadFiles'\nexport {\n  useUploadFromUrls,\n  type UploadFromUrlsInput,\n  type UploadFromUrlsResult,\n} from './useUploadFromUrls'\n// How documents relate: email family, made from / copies, duplicates, near-duplicates\nexport {\n  useRelatedDocuments,\n  getRelatedTotal,\n  getRelatedLabels,\n  type RelatedDocs,\n  type RelatedDocsMap,\n} from './related-documents'\n\n// Offline changes waiting to sync: what changed, how many, per document, and undo\nexport {\n  usePendingSyncItems,\n  usePendingSyncCounts,\n  useDocumentPendingSync,\n  useCancelManyPendingSync,\n  buildPendingSyncItem,\n  PENDING_SYNC_PREDICATE,\n  type PendingSyncItem,\n  type RawPending,\n} from './pending-sync'\n\n// Documents kept on this device for offline use\nexport {\n  useOfflineDocumentIds,\n  useKeepDocumentsOffline,\n  useRemoveDocumentsOffline,\n  loadOfflineDocument,\n  getOfflineDocument,\n  wipeOfflineDocuments,\n  requestPersistentStorage,\n  type OfflineDocumentRecord,\n} from './offline-documents'\n"],
+  "mappings": "AAEA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,8BAA8B;AACvC,SAAS,wBAAwB,sBAAgD;AACjF;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OASK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EAGA;AAAA,EACA;AAAA,OAIK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,aAAa,2BAA2B,wBAAwB;AACzE,SAAS,4BAA8D;AACvE,SAAS,6BAA6B;AAEtC,SAAS,sBAAgD;AAWzD;AAAA,EACE;AAAA,OAKK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,SAAS,4BAA4D;AACrE,SAAS,2BAA0D;AACnE,SAAS,yBAAsD;AAC/D,SAAS,0BAAwD;AACjE,SAAS,uBAAkD;AAC3D,SAAS,qBAAqB;AAO9B,SAAS,uBAAmD;AAC5D;AAAA,EACE;AAAA,OAGK;AACP,SAAS,0BAA0B;AACnC,SAAS,0BAA0B;AACnC,SAAS,oBAA4C;AACrD,SAAS,oBAA4C;AAIrD,SAAS,qBAAqB;AAG9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAKK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP;AAAA,EACE;AAAA,OAGK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;",
+  "names": []
+}

package/dist/documents/media-error.js

@@ -0,0 +1,18 @@
+function classifyMediaError(err, kind) {
+  const label = kind === "camera" ? "Camera" : "Microphone";
+  const name = err instanceof DOMException ? err.name : void 0;
+  if (name === "NotAllowedError" || name === "SecurityError") {
+    return `${label} access is blocked. Allow ${kind} permission in your browser settings to use this feature.`;
+  }
+  if (name === "NotFoundError" || name === "DevicesNotFoundError") {
+    return `No ${kind} found on this device.`;
+  }
+  if (!navigator.mediaDevices?.getUserMedia) {
+    return `${kind === "camera" ? "Camera" : "Voice"} input is not supported in this browser.`;
+  }
+  return `Could not access the ${kind}. Please try again.`;
+}
+export {
+  classifyMediaError
+};
+//# sourceMappingURL=media-error.js.map

package/dist/documents/media-error.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/documents/media-error.ts"],
+  "sourcesContent": ["/**\n * Shared getUserMedia error classification \u2014 used by both `useAudioRecorder`\n * (microphone) and `useCameraStream` (camera), so \"permission denied\" /\n * \"device not found\" / \"not supported\" read as the same message shape\n * regardless of which device was requested, without duplicating the\n * DOMException-name matching in every recorder hook.\n */\nexport type MediaDeviceKind = 'microphone' | 'camera'\n\nexport function classifyMediaError(err: unknown, kind: MediaDeviceKind): string {\n  const label = kind === 'camera' ? 'Camera' : 'Microphone'\n  const name = err instanceof DOMException ? err.name : undefined\n  if (name === 'NotAllowedError' || name === 'SecurityError') {\n    return `${label} access is blocked. Allow ${kind} permission in your browser settings to use this feature.`\n  }\n  if (name === 'NotFoundError' || name === 'DevicesNotFoundError') {\n    return `No ${kind} found on this device.`\n  }\n  if (!navigator.mediaDevices?.getUserMedia) {\n    return `${kind === 'camera' ? 'Camera' : 'Voice'} input is not supported in this browser.`\n  }\n  return `Could not access the ${kind}. Please try again.`\n}\n"],
+  "mappings": "AASO,SAAS,mBAAmB,KAAc,MAA+B;AAC9E,QAAM,QAAQ,SAAS,WAAW,WAAW;AAC7C,QAAM,OAAO,eAAe,eAAe,IAAI,OAAO;AACtD,MAAI,SAAS,qBAAqB,SAAS,iBAAiB;AAC1D,WAAO,GAAG,KAAK,6BAA6B,IAAI;AAAA,EAClD;AACA,MAAI,SAAS,mBAAmB,SAAS,wBAAwB;AAC/D,WAAO,MAAM,IAAI;AAAA,EACnB;AACA,MAAI,CAAC,UAAU,cAAc,cAAc;AACzC,WAAO,GAAG,SAAS,WAAW,WAAW,OAAO;AAAA,EAClD;AACA,SAAO,wBAAwB,IAAI;AACrC;",
+  "names": []
+}

package/dist/documents/offline-documents.js

@@ -0,0 +1,160 @@
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import {
+  base64ToBytes,
+  bytesToBase64,
+  getUserEncryptionKeypair,
+  sealedBoxDecrypt,
+  sealedBoxEncrypt
+} from "@arbidocs/client";
+import { arbiQueryKeys } from "../query-keys.js";
+import { notify } from "../notifications/notify-store.js";
+import { getDocumentTitle } from "../entities/index.js";
+import { usesOriginalBytesForViewer } from "../entities/media-type.js";
+import { useArbi } from "../useArbi.js";
+import { fetchDocumentFile, fetchDocumentPdf } from "../document-tools/document-pdf.js";
+import { setCachedDocument } from "./documents-cache.js";
+import { useDocumentsSupport } from "./support.js";
+const DB_NAME = "arbi-offline-docs";
+const DB_VERSION = 1;
+const STORE = "documents";
+let dbInstance = null;
+async function openDB() {
+  if (dbInstance) return dbInstance;
+  return new Promise((resolve, reject) => {
+    const request = indexedDB.open(DB_NAME, DB_VERSION);
+    request.onerror = () => reject(request.error);
+    request.onsuccess = () => {
+      const db = request.result;
+      db.onversionchange = () => {
+        db.close();
+        if (dbInstance === db) dbInstance = null;
+      };
+      dbInstance = db;
+      resolve(db);
+    };
+    request.onupgradeneeded = (event) => {
+      const db = event.target.result;
+      if (!db.objectStoreNames.contains(STORE)) {
+        db.createObjectStore(STORE, { keyPath: "docExtId" });
+      }
+    };
+  });
+}
+function promisify(request) {
+  return new Promise((resolve, reject) => {
+    request.onsuccess = () => resolve(request.result);
+    request.onerror = () => reject(request.error);
+  });
+}
+async function withStore(mode, run) {
+  const db = await openDB();
+  const store = db.transaction(STORE, mode).objectStore(STORE);
+  return promisify(run(store));
+}
+async function putOfflineDocument(record) {
+  await withStore("readwrite", (store) => store.put(record));
+}
+async function getOfflineDocument(docExtId) {
+  const record = await withStore("readonly", (store) => store.get(docExtId));
+  return record;
+}
+async function deleteOfflineDocument(docExtId) {
+  await withStore("readwrite", (store) => store.delete(docExtId));
+}
+async function listOfflineDocumentIds() {
+  const keys = await withStore("readonly", (store) => store.getAllKeys());
+  return keys;
+}
+async function requestPersistentStorage() {
+  try {
+    if (!navigator.storage?.persist || !navigator.storage.persisted) return false;
+    if (await navigator.storage.persisted()) return true;
+    return await navigator.storage.persist();
+  } catch {
+    return false;
+  }
+}
+async function wipeOfflineDocuments() {
+  dbInstance?.close();
+  dbInstance = null;
+  await new Promise((resolve) => {
+    const request = indexedDB.deleteDatabase(DB_NAME);
+    request.onsuccess = request.onerror = request.onblocked = () => resolve();
+  });
+}
+async function loadOfflineDocument(docId) {
+  const record = await getOfflineDocument(docId);
+  if (!record) return void 0;
+  const keypair = await getUserEncryptionKeypair();
+  if (!keypair) throw new Error("Cannot open the offline copy: no personal key in this session");
+  const bytes = sealedBoxDecrypt(bytesToBase64(record.data), keypair.secretKey);
+  return new Blob([bytes], { type: record.contentType });
+}
+async function keepDocumentsOffline(client, docs) {
+  await requestPersistentStorage();
+  const keypair = await getUserEncryptionKeypair();
+  if (!keypair) throw new Error("Could not derive an encryption key for the offline copy.");
+  for (const doc of docs) {
+    const original = usesOriginalBytesForViewer(doc.file_name);
+    const blob = original ? await fetchDocumentFile(client, doc.external_id) : await fetchDocumentPdf(client, doc.external_id);
+    const plain = new Uint8Array(await blob.arrayBuffer());
+    await putOfflineDocument({
+      docExtId: doc.external_id,
+      fileName: getDocumentTitle(doc, "document"),
+      kind: original ? "original" : "pdf",
+      data: base64ToBytes(sealedBoxEncrypt(plain, keypair.publicKey)),
+      contentType: blob.type,
+      savedAt: Date.now()
+    });
+  }
+}
+function useOfflineDocumentIds() {
+  const { data } = useQuery({
+    queryKey: arbiQueryKeys.offlineDocuments(),
+    queryFn: async () => new Set(await listOfflineDocumentIds()),
+    staleTime: Infinity,
+    // Offline the default network mode would hold this local read back, and a cold start
+    // offline would lose every "available offline" badge.
+    networkMode: "always"
+  });
+  return data ?? EMPTY;
+}
+const EMPTY = /* @__PURE__ */ new Set();
+function useKeepDocumentsOffline() {
+  const queryClient = useQueryClient();
+  const arbi = useArbi();
+  const { onKeptOffline } = useDocumentsSupport();
+  return useMutation({
+    mutationFn: async (docs) => {
+      await keepDocumentsOffline(arbi.getClient().fetch, docs);
+      for (const doc of docs) setCachedDocument(queryClient, doc);
+      await onKeptOffline?.();
+      return docs.length;
+    },
+    onSettled: () => queryClient.invalidateQueries({ queryKey: arbiQueryKeys.offlineDocuments() }),
+    onSuccess: (count) => notify.success(`${count} document${count === 1 ? "" : "s"} available offline`),
+    onError: () => notify.error("Could not save documents for offline use")
+  });
+}
+function useRemoveDocumentsOffline() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: async (docIds) => {
+      for (const id of docIds) await deleteOfflineDocument(id);
+      return docIds.length;
+    },
+    onSettled: () => queryClient.invalidateQueries({ queryKey: arbiQueryKeys.offlineDocuments() }),
+    onSuccess: (count) => notify.success(`Removed ${count} offline ${count === 1 ? "copy" : "copies"}`),
+    onError: () => notify.error("Could not remove offline copy")
+  });
+}
+export {
+  getOfflineDocument,
+  loadOfflineDocument,
+  requestPersistentStorage,
+  useKeepDocumentsOffline,
+  useOfflineDocumentIds,
+  useRemoveDocumentsOffline,
+  wipeOfflineDocuments
+};
+//# sourceMappingURL=offline-documents.js.map

package/dist/documents/offline-documents.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/documents/offline-documents.ts"],
+  "sourcesContent": ["/**\n * Documents kept on this device (\"available offline\"): the bytes a viewer shows (the PDF, or for\n * media the stored file), so a pinned document opens with no network, and can be attached to an\n * email offline. A deliberate, user-pinned cache in IndexedDB: entries live until the user removes\n * them or signs out (`wipeOfflineDocuments`).\n *\n * The bytes are always ciphertext, sealed to the user's own key (the cache is private to one user\n * on one device). The store persists a raw `Uint8Array` (it structured-clones everywhere, unlike a\n * `Blob`); sealing and opening happen in `keepDocumentsOffline` / `loadOfflineDocument`.\n */\n\nimport { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'\nimport {\n  base64ToBytes,\n  bytesToBase64,\n  getUserEncryptionKeypair,\n  sealedBoxDecrypt,\n  sealedBoxEncrypt,\n} from '@arbidocs/client'\nimport { arbiQueryKeys } from '../query-keys'\nimport { notify } from '../notifications/notify-store'\nimport { getDocumentTitle } from '../entities'\nimport { usesOriginalBytesForViewer } from '../entities/media-type'\nimport { useArbi } from '../useArbi'\nimport { fetchDocumentFile, fetchDocumentPdf } from '../document-tools/document-pdf'\nimport type { DocumentToolsClient } from '../document-tools/environment'\nimport { setCachedDocument, type WorkspaceDocument } from './documents-cache'\nimport { useDocumentsSupport } from './support'\n\nconst DB_NAME = 'arbi-offline-docs'\nconst DB_VERSION = 1\nconst STORE = 'documents'\n\nexport interface OfflineDocumentRecord {\n  /** Document external id (the primary key). */\n  docExtId: string\n  /** Display name, captured at save time so the offline list can render without metadata. */\n  fileName: string\n  /**\n   * Which bytes were cached: 'pdf' = the server-generated PDF preview (`/view`),\n   * 'original' = the source file (`/download`, used for image/audio/video).\n   */\n  kind: 'pdf' | 'original'\n  /** Sealed-box ciphertext (the user's personal key); decrypted on read. */\n  data: Uint8Array\n  /** MIME type, used to rebuild the Blob on read. */\n  contentType: string\n  /** Epoch ms when cached. */\n  savedAt: number\n}\n\nlet dbInstance: IDBDatabase | null = null\n\nasync function openDB(): Promise<IDBDatabase> {\n  if (dbInstance) return dbInstance\n\n  return new Promise((resolve, reject) => {\n    const request = indexedDB.open(DB_NAME, DB_VERSION)\n    request.onerror = () => reject(request.error)\n    request.onsuccess = () => {\n      const db = request.result\n      // Another tab deleting the database (a sign-out) must not be blocked by this handle.\n      db.onversionchange = () => {\n        db.close()\n        if (dbInstance === db) dbInstance = null\n      }\n      dbInstance = db\n      resolve(db)\n    }\n    request.onupgradeneeded = (event) => {\n      const db = (event.target as IDBOpenDBRequest).result\n      if (!db.objectStoreNames.contains(STORE)) {\n        db.createObjectStore(STORE, { keyPath: 'docExtId' })\n      }\n    }\n  })\n}\n\nfunction promisify<T>(request: IDBRequest<T>): Promise<T> {\n  return new Promise((resolve, reject) => {\n    request.onsuccess = () => resolve(request.result)\n    request.onerror = () => reject(request.error)\n  })\n}\n\n/**\n * Open a fresh transaction and run the request creator synchronously.\n *\n * The DB handle is awaited first, then the transaction is created and the\n * request issued in the same microtask \u2014 never awaiting *between* opening the\n * transaction and using it, which would let it auto-close.\n */\nasync function withStore<T>(\n  mode: IDBTransactionMode,\n  run: (store: IDBObjectStore) => IDBRequest<T>\n): Promise<T> {\n  const db = await openDB()\n  const store = db.transaction(STORE, mode).objectStore(STORE)\n  return promisify(run(store))\n}\n\nasync function putOfflineDocument(record: OfflineDocumentRecord): Promise<void> {\n  await withStore('readwrite', (store) => store.put(record))\n}\n\nexport async function getOfflineDocument(\n  docExtId: string\n): Promise<OfflineDocumentRecord | undefined> {\n  const record = await withStore('readonly', (store) => store.get(docExtId))\n  return record as OfflineDocumentRecord | undefined\n}\n\nasync function deleteOfflineDocument(docExtId: string): Promise<void> {\n  await withStore('readwrite', (store) => store.delete(docExtId))\n}\n\nasync function listOfflineDocumentIds(): Promise<string[]> {\n  const keys = await withStore('readonly', (store) => store.getAllKeys())\n  return keys as string[]\n}\n\n/**\n * Ask the browser to mark this origin's storage as persistent, so the offline\n * cache isn't evicted under disk pressure (without this, IndexedDB is\n * \"best-effort\" and can be cleared). Best-effort + idempotent; returns whether\n * storage is persisted afterwards.\n */\nexport async function requestPersistentStorage(): Promise<boolean> {\n  try {\n    if (!navigator.storage?.persist || !navigator.storage.persisted) return false\n    if (await navigator.storage.persisted()) return true\n    return await navigator.storage.persist()\n  } catch {\n    return false\n  }\n}\n\n/** Drop every document kept on this device (signing out: nothing stays behind). */\nexport async function wipeOfflineDocuments(): Promise<void> {\n  dbInstance?.close()\n  dbInstance = null\n  await new Promise<void>((resolve) => {\n    const request = indexedDB.deleteDatabase(DB_NAME)\n    request.onsuccess = request.onerror = request.onblocked = () => resolve()\n  })\n}\n\n/** Open a kept document's bytes (`undefined` when it is not kept on this device). */\nexport async function loadOfflineDocument(docId: string): Promise<Blob | undefined> {\n  const record = await getOfflineDocument(docId)\n  if (!record) return undefined\n  const keypair = await getUserEncryptionKeypair()\n  if (!keypair) throw new Error('Cannot open the offline copy: no personal key in this session')\n  const bytes = sealedBoxDecrypt(bytesToBase64(record.data), keypair.secretKey)\n  return new Blob([bytes as BlobPart], { type: record.contentType })\n}\n\n/**\n * Keep documents on this device: fetch what the viewer shows (the PDF, or for media the stored\n * file), seal it to the user's key and store it. One at a time; a failure stops the rest.\n */\nasync function keepDocumentsOffline(\n  client: DocumentToolsClient,\n  docs: WorkspaceDocument[]\n): Promise<void> {\n  // Ask for durable storage so the pinned copies are not evicted later.\n  await requestPersistentStorage()\n  const keypair = await getUserEncryptionKeypair()\n  if (!keypair) throw new Error('Could not derive an encryption key for the offline copy.')\n  for (const doc of docs) {\n    const original = usesOriginalBytesForViewer(doc.file_name)\n    const blob = original\n      ? await fetchDocumentFile(client, doc.external_id)\n      : await fetchDocumentPdf(client, doc.external_id)\n    const plain = new Uint8Array(await blob.arrayBuffer())\n    await putOfflineDocument({\n      docExtId: doc.external_id,\n      fileName: getDocumentTitle(doc, 'document'),\n      kind: original ? 'original' : 'pdf',\n      data: base64ToBytes(sealedBoxEncrypt(plain, keypair.publicKey)),\n      contentType: blob.type,\n      savedAt: Date.now(),\n    })\n  }\n}\n\n/** The documents kept on this device (a local read: it runs offline too). */\nexport function useOfflineDocumentIds(): ReadonlySet<string> {\n  const { data } = useQuery({\n    queryKey: arbiQueryKeys.offlineDocuments(),\n    queryFn: async () => new Set(await listOfflineDocumentIds()),\n    staleTime: Infinity,\n    // Offline the default network mode would hold this local read back, and a cold start\n    // offline would lose every \"available offline\" badge.\n    networkMode: 'always',\n  })\n  return data ?? EMPTY\n}\nconst EMPTY: ReadonlySet<string> = new Set()\n\n/**\n * Keep documents on this device. Their metadata goes into the cache too (the persister keeps it),\n * so a pinned document never opened online still has it offline; the host may then warm its\n * viewer code (`documents.onKeptOffline`) so it opens offline as well.\n */\nexport function useKeepDocumentsOffline() {\n  const queryClient = useQueryClient()\n  const arbi = useArbi()\n  const { onKeptOffline } = useDocumentsSupport()\n  return useMutation({\n    mutationFn: async (docs: WorkspaceDocument[]) => {\n      await keepDocumentsOffline(arbi.getClient().fetch, docs)\n      for (const doc of docs) setCachedDocument(queryClient, doc)\n      await onKeptOffline?.()\n      return docs.length\n    },\n    onSettled: () => queryClient.invalidateQueries({ queryKey: arbiQueryKeys.offlineDocuments() }),\n    onSuccess: (count) =>\n      notify.success(`${count} document${count === 1 ? '' : 's'} available offline`),\n    onError: () => notify.error('Could not save documents for offline use'),\n  })\n}\n\n/** Stop keeping documents on this device. */\nexport function useRemoveDocumentsOffline() {\n  const queryClient = useQueryClient()\n  return useMutation({\n    mutationFn: async (docIds: string[]) => {\n      for (const id of docIds) await deleteOfflineDocument(id)\n      return docIds.length\n    },\n    onSettled: () => queryClient.invalidateQueries({ queryKey: arbiQueryKeys.offlineDocuments() }),\n    onSuccess: (count) =>\n      notify.success(`Removed ${count} offline ${count === 1 ? 'copy' : 'copies'}`),\n    onError: () => notify.error('Could not remove offline copy'),\n  })\n}\n"],
+  "mappings": "AAWA,SAAS,aAAa,UAAU,sBAAsB;AACtD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,qBAAqB;AAC9B,SAAS,cAAc;AACvB,SAAS,wBAAwB;AACjC,SAAS,kCAAkC;AAC3C,SAAS,eAAe;AACxB,SAAS,mBAAmB,wBAAwB;AAEpD,SAAS,yBAAiD;AAC1D,SAAS,2BAA2B;AAEpC,MAAM,UAAU;AAChB,MAAM,aAAa;AACnB,MAAM,QAAQ;AAoBd,IAAI,aAAiC;AAErC,eAAe,SAA+B;AAC5C,MAAI,WAAY,QAAO;AAEvB,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,UAAU,UAAU,KAAK,SAAS,UAAU;AAClD,YAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAC5C,YAAQ,YAAY,MAAM;AACxB,YAAM,KAAK,QAAQ;AAEnB,SAAG,kBAAkB,MAAM;AACzB,WAAG,MAAM;AACT,YAAI,eAAe,GAAI,cAAa;AAAA,MACtC;AACA,mBAAa;AACb,cAAQ,EAAE;AAAA,IACZ;AACA,YAAQ,kBAAkB,CAAC,UAAU;AACnC,YAAM,KAAM,MAAM,OAA4B;AAC9C,UAAI,CAAC,GAAG,iBAAiB,SAAS,KAAK,GAAG;AACxC,WAAG,kBAAkB,OAAO,EAAE,SAAS,WAAW,CAAC;AAAA,MACrD;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAEA,SAAS,UAAa,SAAoC;AACxD,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,YAAQ,YAAY,MAAM,QAAQ,QAAQ,MAAM;AAChD,YAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,EAC9C,CAAC;AACH;AASA,eAAe,UACb,MACA,KACY;AACZ,QAAM,KAAK,MAAM,OAAO;AACxB,QAAM,QAAQ,GAAG,YAAY,OAAO,IAAI,EAAE,YAAY,KAAK;AAC3D,SAAO,UAAU,IAAI,KAAK,CAAC;AAC7B;AAEA,eAAe,mBAAmB,QAA8C;AAC9E,QAAM,UAAU,aAAa,CAAC,UAAU,MAAM,IAAI,MAAM,CAAC;AAC3D;AAEA,eAAsB,mBACpB,UAC4C;AAC5C,QAAM,SAAS,MAAM,UAAU,YAAY,CAAC,UAAU,MAAM,IAAI,QAAQ,CAAC;AACzE,SAAO;AACT;AAEA,eAAe,sBAAsB,UAAiC;AACpE,QAAM,UAAU,aAAa,CAAC,UAAU,MAAM,OAAO,QAAQ,CAAC;AAChE;AAEA,eAAe,yBAA4C;AACzD,QAAM,OAAO,MAAM,UAAU,YAAY,CAAC,UAAU,MAAM,WAAW,CAAC;AACtE,SAAO;AACT;AAQA,eAAsB,2BAA6C;AACjE,MAAI;AACF,QAAI,CAAC,UAAU,SAAS,WAAW,CAAC,UAAU,QAAQ,UAAW,QAAO;AACxE,QAAI,MAAM,UAAU,QAAQ,UAAU,EAAG,QAAO;AAChD,WAAO,MAAM,UAAU,QAAQ,QAAQ;AAAA,EACzC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,eAAsB,uBAAsC;AAC1D,cAAY,MAAM;AAClB,eAAa;AACb,QAAM,IAAI,QAAc,CAAC,YAAY;AACnC,UAAM,UAAU,UAAU,eAAe,OAAO;AAChD,YAAQ,YAAY,QAAQ,UAAU,QAAQ,YAAY,MAAM,QAAQ;AAAA,EAC1E,CAAC;AACH;AAGA,eAAsB,oBAAoB,OAA0C;AAClF,QAAM,SAAS,MAAM,mBAAmB,KAAK;AAC7C,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,UAAU,MAAM,yBAAyB;AAC/C,MAAI,CAAC,QAAS,OAAM,IAAI,MAAM,+DAA+D;AAC7F,QAAM,QAAQ,iBAAiB,cAAc,OAAO,IAAI,GAAG,QAAQ,SAAS;AAC5E,SAAO,IAAI,KAAK,CAAC,KAAiB,GAAG,EAAE,MAAM,OAAO,YAAY,CAAC;AACnE;AAMA,eAAe,qBACb,QACA,MACe;AAEf,QAAM,yBAAyB;AAC/B,QAAM,UAAU,MAAM,yBAAyB;AAC/C,MAAI,CAAC,QAAS,OAAM,IAAI,MAAM,0DAA0D;AACxF,aAAW,OAAO,MAAM;AACtB,UAAM,WAAW,2BAA2B,IAAI,SAAS;AACzD,UAAM,OAAO,WACT,MAAM,kBAAkB,QAAQ,IAAI,WAAW,IAC/C,MAAM,iBAAiB,QAAQ,IAAI,WAAW;AAClD,UAAM,QAAQ,IAAI,WAAW,MAAM,KAAK,YAAY,CAAC;AACrD,UAAM,mBAAmB;AAAA,MACvB,UAAU,IAAI;AAAA,MACd,UAAU,iBAAiB,KAAK,UAAU;AAAA,MAC1C,MAAM,WAAW,aAAa;AAAA,MAC9B,MAAM,cAAc,iBAAiB,OAAO,QAAQ,SAAS,CAAC;AAAA,MAC9D,aAAa,KAAK;AAAA,MAClB,SAAS,KAAK,IAAI;AAAA,IACpB,CAAC;AAAA,EACH;AACF;AAGO,SAAS,wBAA6C;AAC3D,QAAM,EAAE,KAAK,IAAI,SAAS;AAAA,IACxB,UAAU,cAAc,iBAAiB;AAAA,IACzC,SAAS,YAAY,IAAI,IAAI,MAAM,uBAAuB,CAAC;AAAA,IAC3D,WAAW;AAAA;AAAA;AAAA,IAGX,aAAa;AAAA,EACf,CAAC;AACD,SAAO,QAAQ;AACjB;AACA,MAAM,QAA6B,oBAAI,IAAI;AAOpC,SAAS,0BAA0B;AACxC,QAAM,cAAc,eAAe;AACnC,QAAM,OAAO,QAAQ;AACrB,QAAM,EAAE,cAAc,IAAI,oBAAoB;AAC9C,SAAO,YAAY;AAAA,IACjB,YAAY,OAAO,SAA8B;AAC/C,YAAM,qBAAqB,KAAK,UAAU,EAAE,OAAO,IAAI;AACvD,iBAAW,OAAO,KAAM,mBAAkB,aAAa,GAAG;AAC1D,YAAM,gBAAgB;AACtB,aAAO,KAAK;AAAA,IACd;AAAA,IACA,WAAW,MAAM,YAAY,kBAAkB,EAAE,UAAU,cAAc,iBAAiB,EAAE,CAAC;AAAA,IAC7F,WAAW,CAAC,UACV,OAAO,QAAQ,GAAG,KAAK,YAAY,UAAU,IAAI,KAAK,GAAG,oBAAoB;AAAA,IAC/E,SAAS,MAAM,OAAO,MAAM,0CAA0C;AAAA,EACxE,CAAC;AACH;AAGO,SAAS,4BAA4B;AAC1C,QAAM,cAAc,eAAe;AACnC,SAAO,YAAY;AAAA,IACjB,YAAY,OAAO,WAAqB;AACtC,iBAAW,MAAM,OAAQ,OAAM,sBAAsB,EAAE;AACvD,aAAO,OAAO;AAAA,IAChB;AAAA,IACA,WAAW,MAAM,YAAY,kBAAkB,EAAE,UAAU,cAAc,iBAAiB,EAAE,CAAC;AAAA,IAC7F,WAAW,CAAC,UACV,OAAO,QAAQ,WAAW,KAAK,YAAY,UAAU,IAAI,SAAS,QAAQ,EAAE;AAAA,IAC9E,SAAS,MAAM,OAAO,MAAM,+BAA+B;AAAA,EAC7D,CAAC;AACH;",
+  "names": []
+}