From aee87fd9b64709c202057f4696db2dd0c60746df Mon Sep 17 00:00:00 2001
From: static <kmc7468@naver.com>
Date: Mon, 12 Oct 2026 00:04:56 +0900
Subject: [PATCH] =?UTF-8?q?=EC=84=9C=EB=B2=84,=20=ED=81=B4=EB=9D=BC?=
 =?UTF-8?q?=EC=9D=B4=EC=96=B8=ED=8A=B8,=20=EC=84=9C=EB=B9=84=EC=8A=A4=20?=
 =?UTF-8?q?=EC=9B=8C=EC=BB=A4=20=EA=B3=B5=EC=9A=A9=20=EC=BD=94=EB=93=9C?=
 =?UTF-8?q?=EB=A5=BC=20lib/shared=EB=A1=9C=20=EB=B6=84=EB=A6=AC=ED=95=98?=
 =?UTF-8?q?=EA=B3=A0=20=EB=B8=8C=EB=9D=BC=EC=9A=B0=EC=A0=80=20=EC=A0=84?=
 =?UTF-8?q?=EC=9A=A9=20=EB=AA=A8=EB=93=88=EC=9D=84=20lib/client=EB=A1=9C?=
 =?UTF-8?q?=20=EC=9E=AC=EA=B5=AC=EC=84=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 src/hooks.client.ts                           |  6 +-
 .../cache.ts => client/cache/fileCache.ts}    |  4 +-
 src/lib/client/cache/index.ts                 |  2 +
 .../cache/thumbnailCache.ts}                  |  6 +-
 .../crypto/sha.ts => client/crypto/hmac.ts}   | 20 +-----
 src/lib/client/media/exif.ts                  | 27 ++++++++
 .../{modules => client/media}/thumbnail.ts    |  2 +-
 .../client.ts => client/serviceWorker.ts}     |  8 ++-
 .../storage}/indexedDB/cacheIndex.ts          |  0
 .../storage}/indexedDB/filesystem.ts          |  0
 .../{ => client/storage}/indexedDB/index.ts   |  0
 .../storage}/indexedDB/keyStore.ts            |  0
 src/lib/{modules => client/storage}/opfs.ts   |  0
 .../transfer/chunkedUpload.ts}                | 10 +--
 .../transfer}/download.svelte.ts              |  4 +-
 .../file => client/transfer}/index.ts         |  2 -
 .../file => client/transfer}/upload.svelte.ts | 40 ++----------
 .../atoms/buttons/FileThumbnailButton.svelte  |  2 +-
 src/lib/constants/index.ts                    |  2 -
 src/lib/constants/serviceWorker.ts            |  1 -
 src/lib/constants/upload.ts                   |  6 --
 src/lib/modules/filesystem/category.ts        |  2 +-
 src/lib/modules/filesystem/directory.ts       |  2 +-
 src/lib/modules/filesystem/file.ts            |  2 +-
 src/lib/modules/filesystem/internal.svelte.ts |  2 +-
 src/lib/modules/http.ts                       | 14 ----
 src/lib/modules/key.ts                        |  2 +-
 src/lib/server/services/file.ts               | 11 ++--
 src/lib/server/storage/chunks.ts              |  2 +-
 src/lib/server/storage/streams.ts             | 14 ++--
 src/lib/serviceWorker/index.ts                |  2 -
 src/lib/services/auth.ts                      |  2 +-
 src/lib/services/category.ts                  |  2 +-
 src/lib/services/file.ts                      |  8 +--
 src/lib/services/key.ts                       |  6 +-
 src/lib/{modules => shared}/crypto/aes.ts     |  4 +-
 .../utils.ts => shared/crypto/encoding.ts}    |  0
 src/lib/{modules => shared}/crypto/index.ts   |  2 +-
 src/lib/{modules => shared}/crypto/rsa.ts     |  2 +-
 src/lib/shared/crypto/sha.ts                  | 16 +++++
 .../crypto.ts => lib/shared/format/chunk.ts}  | 43 +++++++++----
 src/lib/shared/format/index.ts                |  1 +
 src/lib/shared/http.ts                        | 35 ++++++++++
 .../types.ts => shared/serviceWorker.ts}      |  2 +
 .../(fullscreen)/client/pending/service.ts    |  2 +-
 .../(fullscreen)/file/[id]/+page.svelte       |  4 +-
 .../file/[id]/DownloadStatus.svelte           |  2 +-
 src/routes/(fullscreen)/file/[id]/service.ts  |  4 +-
 .../(fullscreen)/file/downloads/+page.svelte  |  2 +-
 .../(fullscreen)/file/downloads/File.svelte   |  2 +-
 .../(fullscreen)/file/uploads/+page.svelte    |  2 +-
 .../(fullscreen)/file/uploads/File.svelte     |  2 +-
 .../(fullscreen)/key/generate/service.ts      |  4 +-
 src/routes/(fullscreen)/search/File.svelte    |  2 +-
 .../(fullscreen)/settings/cache/+page.svelte  |  4 +-
 .../(fullscreen)/settings/cache/File.svelte   |  2 +-
 .../settings/thumbnail/+page.svelte           |  2 +-
 .../settings/thumbnail/service.ts             |  4 +-
 .../(main)/category/[[id]]/+page.svelte       |  2 +-
 src/routes/(main)/category/[[id]]/File.svelte |  2 +-
 .../(main)/category/[[id]]/service.svelte.ts  |  2 +-
 .../DirectoryEntries/DirectoryEntries.svelte  |  2 +-
 .../[[id]]/DirectoryEntries/File.svelte       |  2 +-
 .../DirectoryEntries/UploadingFile.svelte     |  2 +-
 .../[[id]]/DownloadStatusCard.svelte          |  2 +-
 .../directory/[[id]]/UploadStatusCard.svelte  |  2 +-
 .../(main)/directory/[[id]]/service.svelte.ts | 18 +++---
 src/routes/(main)/favorites/File.svelte       |  2 +-
 src/routes/(main)/home/service.ts             |  2 +-
 src/routes/+layout.svelte                     |  2 +-
 .../download/+server.ts                       |  2 +-
 src/service-worker/constants.ts               |  1 -
 src/service-worker/handlers/decryptFile.ts    | 64 ++++++++++++-------
 src/service-worker/index.ts                   |  7 +-
 src/service-worker/modules/http.ts            |  1 -
 src/service-worker/modules/metadata.ts        |  2 +-
 src/service-worker/modules/opfs.ts            |  1 -
 src/service-worker/stores.ts                  |  2 +-
 src/service-worker/types.ts                   |  1 -
 tests/server/download.test.ts                 | 19 ++++++
 tests/unit/crypto.test.ts                     |  2 +-
 tests/unit/range.test.ts                      | 49 +++++++++++---
 82 files changed, 326 insertions(+), 221 deletions(-)
 rename src/lib/{modules/file/cache.ts => client/cache/fileCache.ts} (91%)
 create mode 100644 src/lib/client/cache/index.ts
 rename src/lib/{modules/file/thumbnail.ts => client/cache/thumbnailCache.ts} (94%)
 rename src/lib/{modules/crypto/sha.ts => client/crypto/hmac.ts} (67%)
 create mode 100644 src/lib/client/media/exif.ts
 rename src/lib/{modules => client/media}/thumbnail.ts (98%)
 rename src/lib/{serviceWorker/client.ts => client/serviceWorker.ts} (90%)
 rename src/lib/{ => client/storage}/indexedDB/cacheIndex.ts (100%)
 rename src/lib/{ => client/storage}/indexedDB/filesystem.ts (100%)
 rename src/lib/{ => client/storage}/indexedDB/index.ts (100%)
 rename src/lib/{ => client/storage}/indexedDB/keyStore.ts (100%)
 rename src/lib/{modules => client/storage}/opfs.ts (100%)
 rename src/lib/{modules/upload.ts => client/transfer/chunkedUpload.ts} (93%)
 rename src/lib/{modules/file => client/transfer}/download.svelte.ts (95%)
 rename src/lib/{modules/file => client/transfer}/index.ts (55%)
 rename src/lib/{modules/file => client/transfer}/upload.svelte.ts (81%)
 delete mode 100644 src/lib/constants/index.ts
 delete mode 100644 src/lib/constants/serviceWorker.ts
 delete mode 100644 src/lib/constants/upload.ts
 delete mode 100644 src/lib/modules/http.ts
 delete mode 100644 src/lib/serviceWorker/index.ts
 rename src/lib/{modules => shared}/crypto/aes.ts (97%)
 rename src/lib/{modules/crypto/utils.ts => shared/crypto/encoding.ts} (100%)
 rename src/lib/{modules => shared}/crypto/index.ts (71%)
 rename src/lib/{modules => shared}/crypto/rsa.ts (99%)
 create mode 100644 src/lib/shared/crypto/sha.ts
 rename src/{service-worker/modules/crypto.ts => lib/shared/format/chunk.ts} (58%)
 create mode 100644 src/lib/shared/format/index.ts
 create mode 100644 src/lib/shared/http.ts
 rename src/lib/{serviceWorker/types.ts => shared/serviceWorker.ts} (90%)
 delete mode 100644 src/service-worker/constants.ts
 delete mode 100644 src/service-worker/modules/http.ts
 delete mode 100644 src/service-worker/modules/opfs.ts
 delete mode 100644 src/service-worker/types.ts

diff --git a/src/hooks.client.ts b/src/hooks.client.ts
index dcd160a..645c890 100644
--- a/src/hooks.client.ts
+++ b/src/hooks.client.ts
@@ -1,12 +1,12 @@
 import type { ClientInit } from "@sveltejs/kit/hooks";
+import { prepareFileCache } from "#lib/client/cache/index.js";
+import { listenForMetadataRequests } from "#lib/client/serviceWorker.js";
 import {
   cleanupDanglingInfos,
   getClientKey,
   getMasterKeys,
   getHmacSecrets,
-} from "#lib/indexedDB/index.js";
-import { prepareFileCache } from "#lib/modules/file/index.js";
-import { listenForMetadataRequests } from "#lib/serviceWorker/index.js";
+} from "#lib/client/storage/indexedDB/index.js";
 import { clientKeyStore, masterKeyStore, hmacSecretStore } from "#lib/stores/index.js";
 
 const requestPersistentStorage = async () => {
diff --git a/src/lib/modules/file/cache.ts b/src/lib/client/cache/fileCache.ts
similarity index 91%
rename from src/lib/modules/file/cache.ts
rename to src/lib/client/cache/fileCache.ts
index 921a770..487baa9 100644
--- a/src/lib/modules/file/cache.ts
+++ b/src/lib/client/cache/fileCache.ts
@@ -3,8 +3,8 @@ import {
   storeFileCacheIndex,
   deleteFileCacheIndex,
   type FileCacheIndex,
-} from "#lib/indexedDB/index.js";
-import { readFile, writeFile, deleteFile } from "#lib/modules/opfs.js";
+} from "#lib/client/storage/indexedDB/index.js";
+import { readFile, writeFile, deleteFile } from "#lib/client/storage/opfs.js";
 
 const fileCacheIndex = new Map<number, FileCacheIndex>();
 
diff --git a/src/lib/client/cache/index.ts b/src/lib/client/cache/index.ts
new file mode 100644
index 0000000..66c72a3
--- /dev/null
+++ b/src/lib/client/cache/index.ts
@@ -0,0 +1,2 @@
+export * from "./fileCache";
+export * from "./thumbnailCache";
diff --git a/src/lib/modules/file/thumbnail.ts b/src/lib/client/cache/thumbnailCache.ts
similarity index 94%
rename from src/lib/modules/file/thumbnail.ts
rename to src/lib/client/cache/thumbnailCache.ts
index ae13ba6..ebdfcd6 100644
--- a/src/lib/modules/file/thumbnail.ts
+++ b/src/lib/client/cache/thumbnailCache.ts
@@ -1,9 +1,9 @@
 import { LRUCache } from "lru-cache";
 import { writable, type Writable } from "svelte/store";
-import { decryptChunk } from "#lib/modules/crypto/index.js";
+import { getThumbnailUrl } from "#lib/client/media/thumbnail.js";
+import { readFile, writeFile, deleteFile, deleteDirectory } from "#lib/client/storage/opfs.js";
 import type { SummarizedFileInfo } from "#lib/modules/filesystem/index.js";
-import { readFile, writeFile, deleteFile, deleteDirectory } from "#lib/modules/opfs.js";
-import { getThumbnailUrl } from "#lib/modules/thumbnail.js";
+import { decryptChunk } from "#lib/shared/crypto/index.js";
 
 const loadedThumbnails = new LRUCache<number, Writable<string>>({ max: 100 });
 const loadingThumbnails = new Map<number, Writable<string | undefined>>();
diff --git a/src/lib/modules/crypto/sha.ts b/src/lib/client/crypto/hmac.ts
similarity index 67%
rename from src/lib/modules/crypto/sha.ts
rename to src/lib/client/crypto/hmac.ts
index aa31280..6df84ef 100644
--- a/src/lib/modules/crypto/sha.ts
+++ b/src/lib/client/crypto/hmac.ts
@@ -1,23 +1,7 @@
-import HmacWorker from "#workers/hmac.js?worker";
 import type { ComputeMessage, ResultMessage } from "#workers/hmac.js";
+import HmacWorker from "#workers/hmac.js?worker";
 
-export const digestMessage = async (message: BufferSource) => {
-  return await crypto.subtle.digest("SHA-256", message);
-};
-
-export const generateHmacSecret = async () => {
-  return {
-    hmacSecret: await crypto.subtle.generateKey(
-      {
-        name: "HMAC",
-        hash: "SHA-256",
-      } satisfies HmacKeyGenParams,
-      true,
-      ["sign", "verify"],
-    ),
-  };
-};
-
+// Computes HMAC of large blobs incrementally in a worker, which WebCrypto doesn't support
 export const signMessageHmac = async (message: Blob, hmacSecret: CryptoKey) => {
   const stream = message.stream();
   const hmacSecretRaw = new Uint8Array(await crypto.subtle.exportKey("raw", hmacSecret));
diff --git a/src/lib/client/media/exif.ts b/src/lib/client/media/exif.ts
new file mode 100644
index 0000000..f6b363f
--- /dev/null
+++ b/src/lib/client/media/exif.ts
@@ -0,0 +1,27 @@
+import ExifReader from "exifreader";
+
+export const extractExifDateTime = (fileBuffer: ArrayBuffer) => {
+  const exif = ExifReader.load(fileBuffer);
+  const dateTimeOriginal = exif["DateTimeOriginal"]?.description;
+  const offsetTimeOriginal = exif["OffsetTimeOriginal"]?.description;
+  if (!dateTimeOriginal) return undefined;
+
+  const [date, time] = dateTimeOriginal.split(" ");
+  if (!date || !time) return undefined;
+
+  const [year, month, day] = date.split(":").map(Number);
+  const [hour, minute, second] = time.split(":").map(Number);
+  if (!year || !month || !day || !hour || !minute || !second) return undefined;
+
+  if (!offsetTimeOriginal) {
+    // No timezone information.. Assume local timezone
+    return new Date(year, month - 1, day, hour, minute, second);
+  }
+
+  const offsetSign = offsetTimeOriginal[0] === "+" ? 1 : -1;
+  const [offsetHour, offsetMinute] = offsetTimeOriginal.slice(1).split(":").map(Number);
+
+  const utcDate = Date.UTC(year, month - 1, day, hour, minute, second);
+  const offsetMs = offsetSign * ((offsetHour ?? 0) * 60 + (offsetMinute ?? 0)) * 60 * 1000;
+  return new Date(utcDate - offsetMs);
+};
diff --git a/src/lib/modules/thumbnail.ts b/src/lib/client/media/thumbnail.ts
similarity index 98%
rename from src/lib/modules/thumbnail.ts
rename to src/lib/client/media/thumbnail.ts
index 6c7d6eb..09cd116 100644
--- a/src/lib/modules/thumbnail.ts
+++ b/src/lib/client/media/thumbnail.ts
@@ -1,4 +1,4 @@
-import { encodeToBase64 } from "#lib/modules/crypto/index.js";
+import { encodeToBase64 } from "#lib/shared/crypto/index.js";
 
 const scaleSize = (width: number, height: number, targetSize: number) => {
   if (width <= targetSize || height <= targetSize) {
diff --git a/src/lib/serviceWorker/client.ts b/src/lib/client/serviceWorker.ts
similarity index 90%
rename from src/lib/serviceWorker/client.ts
rename to src/lib/client/serviceWorker.ts
index 9627d4e..e4b86b6 100644
--- a/src/lib/serviceWorker/client.ts
+++ b/src/lib/client/serviceWorker.ts
@@ -1,5 +1,9 @@
-import { DECRYPTED_FILE_URL_PREFIX } from "#lib/constants/index.js";
-import type { FileMetadata, ServiceWorkerMessage, ServiceWorkerResponse } from "./types";
+import { DECRYPTED_FILE_URL_PREFIX } from "#lib/shared/serviceWorker.js";
+import type {
+  FileMetadata,
+  ServiceWorkerMessage,
+  ServiceWorkerResponse,
+} from "#lib/shared/serviceWorker.js";
 
 const PREPARE_TIMEOUT_MS = 5000;
 
diff --git a/src/lib/indexedDB/cacheIndex.ts b/src/lib/client/storage/indexedDB/cacheIndex.ts
similarity index 100%
rename from src/lib/indexedDB/cacheIndex.ts
rename to src/lib/client/storage/indexedDB/cacheIndex.ts
diff --git a/src/lib/indexedDB/filesystem.ts b/src/lib/client/storage/indexedDB/filesystem.ts
similarity index 100%
rename from src/lib/indexedDB/filesystem.ts
rename to src/lib/client/storage/indexedDB/filesystem.ts
diff --git a/src/lib/indexedDB/index.ts b/src/lib/client/storage/indexedDB/index.ts
similarity index 100%
rename from src/lib/indexedDB/index.ts
rename to src/lib/client/storage/indexedDB/index.ts
diff --git a/src/lib/indexedDB/keyStore.ts b/src/lib/client/storage/indexedDB/keyStore.ts
similarity index 100%
rename from src/lib/indexedDB/keyStore.ts
rename to src/lib/client/storage/indexedDB/keyStore.ts
diff --git a/src/lib/modules/opfs.ts b/src/lib/client/storage/opfs.ts
similarity index 100%
rename from src/lib/modules/opfs.ts
rename to src/lib/client/storage/opfs.ts
diff --git a/src/lib/modules/upload.ts b/src/lib/client/transfer/chunkedUpload.ts
similarity index 93%
rename from src/lib/modules/upload.ts
rename to src/lib/client/transfer/chunkedUpload.ts
index 9bd5e05..8e96360 100644
--- a/src/lib/modules/upload.ts
+++ b/src/lib/client/transfer/chunkedUpload.ts
@@ -1,9 +1,9 @@
 import { sha256 } from "@noble/hashes/sha2.js";
 import axios from "axios";
 import pLimit from "p-limit";
-import { ENCRYPTION_OVERHEAD, CHUNK_SIZE } from "#lib/constants/index.js";
-import { encodeToBase64, encryptChunk } from "#lib/modules/crypto/index.js";
-import { BoundedQueue } from "#lib/utils/index.js";
+import { encodeToBase64, encryptChunk } from "#lib/shared/crypto/index.js";
+import { CHUNK_SIZE, getChunkCount, getEncryptedSize } from "#lib/shared/format/index.js";
+import { BoundedQueue } from "#lib/utils/concurrency/index.js";
 
 interface UploadStats {
   progress: number;
@@ -98,8 +98,8 @@ export const uploadBlob = async (
   const networkConcurrency = options?.concurrency ?? 4;
   const maxQueueSize = 8;
 
-  const totalChunks = Math.ceil(blob.size / CHUNK_SIZE);
-  const totalBytes = blob.size + totalChunks * ENCRYPTION_OVERHEAD;
+  const totalChunks = getChunkCount(blob.size);
+  const totalBytes = getEncryptedSize(blob.size);
 
   const uploadedByChunk = new Array<number>(totalChunks).fill(0);
   const speedMeter = createSpeedMeter(3000, 200);
diff --git a/src/lib/modules/file/download.svelte.ts b/src/lib/client/transfer/download.svelte.ts
similarity index 95%
rename from src/lib/modules/file/download.svelte.ts
rename to src/lib/client/transfer/download.svelte.ts
index 2158647..f5fe935 100644
--- a/src/lib/modules/file/download.svelte.ts
+++ b/src/lib/client/transfer/download.svelte.ts
@@ -1,7 +1,7 @@
 import axios from "axios";
 import { limitFunction } from "p-limit";
-import { ENCRYPTED_CHUNK_SIZE } from "#lib/constants/index.js";
-import { decryptChunk, concatenateBuffers } from "#lib/modules/crypto/index.js";
+import { decryptChunk, concatenateBuffers } from "#lib/shared/crypto/index.js";
+import { ENCRYPTED_CHUNK_SIZE } from "#lib/shared/format/index.js";
 
 export interface FileDownloadState {
   id: number;
diff --git a/src/lib/modules/file/index.ts b/src/lib/client/transfer/index.ts
similarity index 55%
rename from src/lib/modules/file/index.ts
rename to src/lib/client/transfer/index.ts
index 9e9ce0c..a862c01 100644
--- a/src/lib/modules/file/index.ts
+++ b/src/lib/client/transfer/index.ts
@@ -1,4 +1,2 @@
-export * from "./cache";
 export * from "./download.svelte";
-export * from "./thumbnail";
 export * from "./upload.svelte";
diff --git a/src/lib/modules/file/upload.svelte.ts b/src/lib/client/transfer/upload.svelte.ts
similarity index 81%
rename from src/lib/modules/file/upload.svelte.ts
rename to src/lib/client/transfer/upload.svelte.ts
index c514bff..3c23ca8 100644
--- a/src/lib/modules/file/upload.svelte.ts
+++ b/src/lib/client/transfer/upload.svelte.ts
@@ -1,15 +1,15 @@
-import ExifReader from "exifreader";
 import { limitFunction } from "p-limit";
-import { CHUNK_SIZE } from "#lib/constants/index.js";
+import { signMessageHmac } from "#lib/client/crypto/hmac.js";
+import { extractExifDateTime } from "#lib/client/media/exif.js";
+import { generateThumbnail } from "#lib/client/media/thumbnail.js";
+import { uploadBlob } from "#lib/client/transfer/chunkedUpload.js";
 import {
   encodeToBase64,
   generateDataKey,
   wrapDataKey,
   encryptString,
-} from "#lib/modules/crypto/index.js";
-import { signMessageHmac } from "#lib/modules/crypto/index.js";
-import { generateThumbnail } from "#lib/modules/thumbnail.js";
-import { uploadBlob } from "#lib/modules/upload.js";
+} from "#lib/shared/crypto/index.js";
+import { getChunkCount } from "#lib/shared/format/index.js";
 import type { MasterKey, HmacSecret } from "#lib/stores/index.js";
 import { Scheduler } from "#lib/utils/index.js";
 import { trpc } from "#trpc/client.js";
@@ -84,32 +84,6 @@ const getFileType = (file: File) => {
   throw new Error("Unknown file type");
 };
 
-const extractExifDateTime = (fileBuffer: ArrayBuffer) => {
-  const exif = ExifReader.load(fileBuffer);
-  const dateTimeOriginal = exif["DateTimeOriginal"]?.description;
-  const offsetTimeOriginal = exif["OffsetTimeOriginal"]?.description;
-  if (!dateTimeOriginal) return undefined;
-
-  const [date, time] = dateTimeOriginal.split(" ");
-  if (!date || !time) return undefined;
-
-  const [year, month, day] = date.split(":").map(Number);
-  const [hour, minute, second] = time.split(":").map(Number);
-  if (!year || !month || !day || !hour || !minute || !second) return undefined;
-
-  if (!offsetTimeOriginal) {
-    // No timezone information.. Assume local timezone
-    return new Date(year, month - 1, day, hour, minute, second);
-  }
-
-  const offsetSign = offsetTimeOriginal[0] === "+" ? 1 : -1;
-  const [offsetHour, offsetMinute] = offsetTimeOriginal.slice(1).split(":").map(Number);
-
-  const utcDate = Date.UTC(year, month - 1, day, hour, minute, second);
-  const offsetMs = offsetSign * ((offsetHour ?? 0) * 60 + (offsetMinute ?? 0)) * 60 * 1000;
-  return new Date(utcDate - offsetMs);
-};
-
 interface FileMetadata {
   parentId: "root" | number;
   name: string;
@@ -140,7 +114,7 @@ const requestFileMetadataEncryption = limitFunction(
       ]);
 
     const { uploadId } = await trpc.upload.startFileUpload.mutate({
-      chunks: Math.ceil(file.size / CHUNK_SIZE),
+      chunks: getChunkCount(file.size),
       parent: fileMetadata.parentId,
       mekVersion: masterKey.version,
       dek: dataKeyWrapped,
diff --git a/src/lib/components/atoms/buttons/FileThumbnailButton.svelte b/src/lib/components/atoms/buttons/FileThumbnailButton.svelte
index 6b9d2a9..d543446 100644
--- a/src/lib/components/atoms/buttons/FileThumbnailButton.svelte
+++ b/src/lib/components/atoms/buttons/FileThumbnailButton.svelte
@@ -1,5 +1,5 @@
 <script lang="ts">
-  import { getFileThumbnail } from "#lib/modules/file/index.js";
+  import { getFileThumbnail } from "#lib/client/cache/index.js";
   import type { SummarizedFileInfo } from "#lib/modules/filesystem/index.js";
 
   import IconFavorite from "~icons/material-symbols/favorite";
diff --git a/src/lib/constants/index.ts b/src/lib/constants/index.ts
deleted file mode 100644
index 4983846..0000000
--- a/src/lib/constants/index.ts
+++ /dev/null
@@ -1,2 +0,0 @@
-export * from "./serviceWorker";
-export * from "./upload";
diff --git a/src/lib/constants/serviceWorker.ts b/src/lib/constants/serviceWorker.ts
deleted file mode 100644
index abbaa3c..0000000
--- a/src/lib/constants/serviceWorker.ts
+++ /dev/null
@@ -1 +0,0 @@
-export const DECRYPTED_FILE_URL_PREFIX = "/_internal/decryptedFile/";
diff --git a/src/lib/constants/upload.ts b/src/lib/constants/upload.ts
deleted file mode 100644
index 57934d6..0000000
--- a/src/lib/constants/upload.ts
+++ /dev/null
@@ -1,6 +0,0 @@
-export const AES_GCM_IV_SIZE = 12;
-export const AES_GCM_TAG_SIZE = 16;
-export const ENCRYPTION_OVERHEAD = AES_GCM_IV_SIZE + AES_GCM_TAG_SIZE;
-
-export const CHUNK_SIZE = 4 * 1024 * 1024; // 4 MiB
-export const ENCRYPTED_CHUNK_SIZE = CHUNK_SIZE + ENCRYPTION_OVERHEAD;
diff --git a/src/lib/modules/filesystem/category.ts b/src/lib/modules/filesystem/category.ts
index 1a222ab..35ce43b 100644
--- a/src/lib/modules/filesystem/category.ts
+++ b/src/lib/modules/filesystem/category.ts
@@ -1,4 +1,4 @@
-import * as IndexedDB from "#lib/indexedDB/index.js";
+import * as IndexedDB from "#lib/client/storage/indexedDB/index.js";
 import { trpc, isTRPCClientError } from "#trpc/client.js";
 import { FilesystemCache, decryptFileMetadata, decryptCategoryMetadata } from "./internal.svelte";
 import type { CategoryInfo, MaybeCategoryInfo } from "./types";
diff --git a/src/lib/modules/filesystem/directory.ts b/src/lib/modules/filesystem/directory.ts
index cbd447d..ea38bba 100644
--- a/src/lib/modules/filesystem/directory.ts
+++ b/src/lib/modules/filesystem/directory.ts
@@ -1,4 +1,4 @@
-import * as IndexedDB from "#lib/indexedDB/index.js";
+import * as IndexedDB from "#lib/client/storage/indexedDB/index.js";
 import { trpc, isTRPCClientError } from "#trpc/client.js";
 import { FilesystemCache, decryptDirectoryMetadata, decryptFileMetadata } from "./internal.svelte";
 import type { DirectoryInfo, MaybeDirectoryInfo } from "./types";
diff --git a/src/lib/modules/filesystem/file.ts b/src/lib/modules/filesystem/file.ts
index 435e57f..be0fb61 100644
--- a/src/lib/modules/filesystem/file.ts
+++ b/src/lib/modules/filesystem/file.ts
@@ -1,4 +1,4 @@
-import * as IndexedDB from "#lib/indexedDB/index.js";
+import * as IndexedDB from "#lib/client/storage/indexedDB/index.js";
 import { trpc, isTRPCClientError } from "#trpc/client.js";
 import { FilesystemCache, decryptFileMetadata, decryptCategoryMetadata } from "./internal.svelte";
 import type { FileInfo, MaybeFileInfo } from "./types";
diff --git a/src/lib/modules/filesystem/internal.svelte.ts b/src/lib/modules/filesystem/internal.svelte.ts
index c0743a1..4a33f83 100644
--- a/src/lib/modules/filesystem/internal.svelte.ts
+++ b/src/lib/modules/filesystem/internal.svelte.ts
@@ -1,5 +1,5 @@
 import { untrack } from "svelte";
-import { unwrapDataKey, decryptString } from "#lib/modules/crypto/index.js";
+import { unwrapDataKey, decryptString } from "#lib/shared/crypto/index.js";
 
 interface FilesystemCacheOptions<K, V> {
   fetchFromIndexedDB: (key: K) => Promise<V | undefined>;
diff --git a/src/lib/modules/http.ts b/src/lib/modules/http.ts
deleted file mode 100644
index 92e50d0..0000000
--- a/src/lib/modules/http.ts
+++ /dev/null
@@ -1,14 +0,0 @@
-export const parseRangeHeader = (value: string | null) => {
-  if (!value) return undefined;
-
-  const firstRange = value.split(",")[0]!.trim();
-  const parts = firstRange.replace(/bytes=/, "").split("-");
-  return {
-    start: parts[0] ? parseInt(parts[0], 10) : undefined,
-    end: parts[1] ? parseInt(parts[1], 10) : undefined,
-  };
-};
-
-export const getContentRangeHeader = (range?: { start: number; end: number; total: number }) => {
-  return range && { "Content-Range": `bytes ${range.start}-${range.end}/${range.total}` };
-};
diff --git a/src/lib/modules/key.ts b/src/lib/modules/key.ts
index f7bd09e..4e86cfc 100644
--- a/src/lib/modules/key.ts
+++ b/src/lib/modules/key.ts
@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { storeClientKey } from "#lib/indexedDB/index.js";
+import { storeClientKey } from "#lib/client/storage/indexedDB/index.js";
 import type { ClientKeys } from "#lib/stores/index.js";
 
 const SerializedClientKeysSchema = z.intersection(
diff --git a/src/lib/server/services/file.ts b/src/lib/server/services/file.ts
index a95ac3f..fab5447 100644
--- a/src/lib/server/services/file.ts
+++ b/src/lib/server/services/file.ts
@@ -2,10 +2,9 @@ import { FileRepo, MediaRepo } from "#lib/server/db/index.js";
 import type { Ciphertext } from "#lib/server/db/schema/index.js";
 import { AppError } from "#lib/server/errors.js";
 import { createEncContentStream } from "#lib/server/storage/index.js";
+import type { RangeRequest } from "#lib/shared/http.js";
 import { schedulePendingFileDeletions } from "./fileDeletion";
 
-type Range = { start?: number; end?: number };
-
 export const getFile = async (userId: number, fileId: number) => {
   const file = await FileRepo.getFile(userId, fileId);
   if (!file) {
@@ -68,7 +67,7 @@ export const getFileThumbnail = async (userId: number, fileId: number) => {
 
 const decodeIv = (iv: string | null) => (iv ? Buffer.from(iv, "base64") : undefined);
 
-export const getFileStream = async (userId: number, fileId: number, range?: Range) => {
+export const getFileStream = async (userId: number, fileId: number, range?: RangeRequest) => {
   const file = await FileRepo.getFile(userId, fileId);
   if (!file) {
     throw new AppError("NOT_FOUND", "File not found");
@@ -76,7 +75,11 @@ export const getFileStream = async (userId: number, fileId: number, range?: Rang
   return await createEncContentStream(file.path, decodeIv(file.encContentIv), range);
 };
 
-export const getFileThumbnailStream = async (userId: number, fileId: number, range?: Range) => {
+export const getFileThumbnailStream = async (
+  userId: number,
+  fileId: number,
+  range?: RangeRequest,
+) => {
   const thumbnail = await getFileThumbnail(userId, fileId);
   return await createEncContentStream(thumbnail.path, decodeIv(thumbnail.encContentIv), range);
 };
diff --git a/src/lib/server/storage/chunks.ts b/src/lib/server/storage/chunks.ts
index ceebba6..2e4b5cb 100644
--- a/src/lib/server/storage/chunks.ts
+++ b/src/lib/server/storage/chunks.ts
@@ -1,7 +1,7 @@
 import { open } from "fs/promises";
 import type { Readable } from "stream";
-import { ENCRYPTION_OVERHEAD, ENCRYPTED_CHUNK_SIZE } from "#lib/constants/index.js";
 import { AppError } from "#lib/server/errors.js";
+import { ENCRYPTION_OVERHEAD, ENCRYPTED_CHUNK_SIZE } from "#lib/shared/format/index.js";
 
 const invalidChunkSize = () => new AppError("BAD_REQUEST", "Invalid chunk size");
 
diff --git a/src/lib/server/storage/streams.ts b/src/lib/server/storage/streams.ts
index 2accb43..2fd3747 100644
--- a/src/lib/server/storage/streams.ts
+++ b/src/lib/server/storage/streams.ts
@@ -2,22 +2,22 @@ import { createReadStream } from "fs";
 import { stat } from "fs/promises";
 import { Readable } from "stream";
 import { AppError } from "#lib/server/errors.js";
+import { resolveRange, type RangeRequest } from "#lib/shared/http.js";
 
 export const createEncContentStream = async (
   path: string,
   iv?: Buffer,
-  range?: { start?: number; end?: number },
+  rangeRequest?: RangeRequest,
 ) => {
   const { size: fileSize } = await stat(path);
   const ivSize = iv?.byteLength ?? 0;
-  const totalSize = fileSize + ivSize;
 
-  const start = range?.start ?? 0;
-  const end = range?.end ?? totalSize - 1;
-  if (start > end || start < 0 || end >= totalSize) {
+  const range = resolveRange(rangeRequest, fileSize + ivSize);
+  if (!range) {
     throw new AppError("RANGE_NOT_SATISFIABLE", "Invalid range");
   }
 
+  const { start, end } = range;
   return {
     encContentStream: Readable.toWeb(
       Readable.from(
@@ -34,7 +34,7 @@ export const createEncContentStream = async (
         })(),
       ),
     ),
-    range: { start, end, total: totalSize },
-    isRangeRequest: !!range,
+    range,
+    isRangeRequest: !!rangeRequest,
   };
 };
diff --git a/src/lib/serviceWorker/index.ts b/src/lib/serviceWorker/index.ts
deleted file mode 100644
index d2ec230..0000000
--- a/src/lib/serviceWorker/index.ts
+++ /dev/null
@@ -1,2 +0,0 @@
-export * from "./client";
-export * from "./types";
diff --git a/src/lib/services/auth.ts b/src/lib/services/auth.ts
index 47e2546..675dab5 100644
--- a/src/lib/services/auth.ts
+++ b/src/lib/services/auth.ts
@@ -1,4 +1,4 @@
-import { encodeToBase64, decryptChallenge, signMessageRSA } from "#lib/modules/crypto/index.js";
+import { encodeToBase64, decryptChallenge, signMessageRSA } from "#lib/shared/crypto/index.js";
 import { trpc, isTRPCClientError } from "#trpc/client.js";
 
 export const requestSessionUpgrade = async (
diff --git a/src/lib/services/category.ts b/src/lib/services/category.ts
index 5a8cb9c..6d2bdac 100644
--- a/src/lib/services/category.ts
+++ b/src/lib/services/category.ts
@@ -1,4 +1,4 @@
-import { generateDataKey, wrapDataKey, encryptString } from "#lib/modules/crypto/index.js";
+import { generateDataKey, wrapDataKey, encryptString } from "#lib/shared/crypto/index.js";
 import type { MasterKey } from "#lib/stores/index.js";
 import { trpc } from "#trpc/client.js";
 
diff --git a/src/lib/services/file.ts b/src/lib/services/file.ts
index c7a077a..6ffddb5 100644
--- a/src/lib/services/file.ts
+++ b/src/lib/services/file.ts
@@ -1,12 +1,12 @@
-import { getAllFileInfos } from "#lib/indexedDB/filesystem.js";
 import {
   getFileCache,
   storeFileCache,
   deleteFileCache,
-  downloadFile,
   deleteFileThumbnailCache,
-} from "#lib/modules/file/index.js";
-import { uploadBlob } from "#lib/modules/upload.js";
+} from "#lib/client/cache/index.js";
+import { getAllFileInfos } from "#lib/client/storage/indexedDB/filesystem.js";
+import { uploadBlob } from "#lib/client/transfer/chunkedUpload.js";
+import { downloadFile } from "#lib/client/transfer/index.js";
 import { trpc } from "#trpc/client.js";
 
 export const requestFileDownload = async (
diff --git a/src/lib/services/key.ts b/src/lib/services/key.ts
index fbd6b38..463a638 100644
--- a/src/lib/services/key.ts
+++ b/src/lib/services/key.ts
@@ -1,4 +1,5 @@
-import { storeMasterKeys } from "#lib/indexedDB/index.js";
+import { storeMasterKeys } from "#lib/client/storage/indexedDB/index.js";
+import { requestSessionUpgrade } from "#lib/services/auth.js";
 import {
   encodeToBase64,
   exportRSAKeyToBase64,
@@ -7,8 +8,7 @@ import {
   unwrapMasterKey,
   signMasterKeyWrapped,
   verifyMasterKeyWrapped,
-} from "#lib/modules/crypto/index.js";
-import { requestSessionUpgrade } from "#lib/services/auth.js";
+} from "#lib/shared/crypto/index.js";
 import { masterKeyStore, type ClientKeys } from "#lib/stores/index.js";
 import { trpc, isTRPCClientError } from "#trpc/client.js";
 
diff --git a/src/lib/modules/crypto/aes.ts b/src/lib/shared/crypto/aes.ts
similarity index 97%
rename from src/lib/modules/crypto/aes.ts
rename to src/lib/shared/crypto/aes.ts
index 1075764..1f71122 100644
--- a/src/lib/modules/crypto/aes.ts
+++ b/src/lib/shared/crypto/aes.ts
@@ -1,11 +1,11 @@
-import { AES_GCM_IV_SIZE } from "#lib/constants/index.js";
+import { AES_GCM_IV_SIZE } from "#lib/shared/format/index.js";
 import {
   encodeString,
   decodeString,
   encodeToBase64,
   decodeFromBase64,
   concatenateBuffers,
-} from "./utils";
+} from "./encoding";
 
 export const generateMasterKey = async () => {
   return {
diff --git a/src/lib/modules/crypto/utils.ts b/src/lib/shared/crypto/encoding.ts
similarity index 100%
rename from src/lib/modules/crypto/utils.ts
rename to src/lib/shared/crypto/encoding.ts
diff --git a/src/lib/modules/crypto/index.ts b/src/lib/shared/crypto/index.ts
similarity index 71%
rename from src/lib/modules/crypto/index.ts
rename to src/lib/shared/crypto/index.ts
index e3c27a7..623bd57 100644
--- a/src/lib/modules/crypto/index.ts
+++ b/src/lib/shared/crypto/index.ts
@@ -1,4 +1,4 @@
 export * from "./aes";
+export * from "./encoding";
 export * from "./rsa";
 export * from "./sha";
-export * from "./utils";
diff --git a/src/lib/modules/crypto/rsa.ts b/src/lib/shared/crypto/rsa.ts
similarity index 99%
rename from src/lib/modules/crypto/rsa.ts
rename to src/lib/shared/crypto/rsa.ts
index 78e17db..e01ad42 100644
--- a/src/lib/modules/crypto/rsa.ts
+++ b/src/lib/shared/crypto/rsa.ts
@@ -1,4 +1,4 @@
-import { encodeString, encodeToBase64, decodeFromBase64 } from "./utils";
+import { encodeString, encodeToBase64, decodeFromBase64 } from "./encoding";
 
 export const generateEncryptionKeyPair = async () => {
   const keyPair = await crypto.subtle.generateKey(
diff --git a/src/lib/shared/crypto/sha.ts b/src/lib/shared/crypto/sha.ts
new file mode 100644
index 0000000..efb4f20
--- /dev/null
+++ b/src/lib/shared/crypto/sha.ts
@@ -0,0 +1,16 @@
+export const digestMessage = async (message: BufferSource) => {
+  return await crypto.subtle.digest("SHA-256", message);
+};
+
+export const generateHmacSecret = async () => {
+  return {
+    hmacSecret: await crypto.subtle.generateKey(
+      {
+        name: "HMAC",
+        hash: "SHA-256",
+      } satisfies HmacKeyGenParams,
+      true,
+      ["sign", "verify"],
+    ),
+  };
+};
diff --git a/src/service-worker/modules/crypto.ts b/src/lib/shared/format/chunk.ts
similarity index 58%
rename from src/service-worker/modules/crypto.ts
rename to src/lib/shared/format/chunk.ts
index ed35094..650bdb9 100644
--- a/src/service-worker/modules/crypto.ts
+++ b/src/lib/shared/format/chunk.ts
@@ -1,7 +1,34 @@
-import { ENCRYPTION_OVERHEAD, CHUNK_SIZE, ENCRYPTED_CHUNK_SIZE } from "../constants";
+// Files are encrypted in chunks of `CHUNK_SIZE` bytes, each of which is stored as
+// `IV || ciphertext || tag`. Legacy files are encrypted as a single chunk.
 
-export * from "../../lib/modules/crypto";
+export const AES_GCM_IV_SIZE = 12;
+export const AES_GCM_TAG_SIZE = 16;
+export const ENCRYPTION_OVERHEAD = AES_GCM_IV_SIZE + AES_GCM_TAG_SIZE;
 
+export const CHUNK_SIZE = 4 * 1024 * 1024; // 4 MiB
+export const ENCRYPTED_CHUNK_SIZE = CHUNK_SIZE + ENCRYPTION_OVERHEAD;
+
+export const getChunkCount = (size: number) => {
+  return Math.ceil(size / CHUNK_SIZE);
+};
+
+export const getEncryptedSize = (size: number) => {
+  return size + getChunkCount(size) * ENCRYPTION_OVERHEAD;
+};
+
+export const getDecryptedSize = (encryptedSize: number, isLegacy: boolean) => {
+  if (isLegacy) {
+    return encryptedSize - ENCRYPTION_OVERHEAD;
+  }
+
+  const fullChunks = Math.floor(encryptedSize / ENCRYPTED_CHUNK_SIZE);
+  const lastChunkEncSize = encryptedSize % ENCRYPTED_CHUNK_SIZE;
+  return (
+    fullChunks * CHUNK_SIZE + (lastChunkEncSize > 0 ? lastChunkEncSize - ENCRYPTION_OVERHEAD : 0)
+  );
+};
+
+// Maps a range of the plaintext to the range of the encrypted chunks that contain it
 export const getEncryptedRange = (
   start: number,
   end: number,
@@ -26,15 +53,3 @@ export const getEncryptedRange = (
     end: Math.min((lastChunkIndex + 1) * ENCRYPTED_CHUNK_SIZE - 1, totalEncryptedSize - 1),
   };
 };
-
-export const getDecryptedSize = (encryptedSize: number, isLegacy: boolean) => {
-  if (isLegacy) {
-    return encryptedSize - ENCRYPTION_OVERHEAD;
-  }
-
-  const fullChunks = Math.floor(encryptedSize / ENCRYPTED_CHUNK_SIZE);
-  const lastChunkEncSize = encryptedSize % ENCRYPTED_CHUNK_SIZE;
-  return (
-    fullChunks * CHUNK_SIZE + (lastChunkEncSize > 0 ? lastChunkEncSize - ENCRYPTION_OVERHEAD : 0)
-  );
-};
diff --git a/src/lib/shared/format/index.ts b/src/lib/shared/format/index.ts
new file mode 100644
index 0000000..2e71d6c
--- /dev/null
+++ b/src/lib/shared/format/index.ts
@@ -0,0 +1 @@
+export * from "./chunk";
diff --git a/src/lib/shared/http.ts b/src/lib/shared/http.ts
new file mode 100644
index 0000000..d8ef6ed
--- /dev/null
+++ b/src/lib/shared/http.ts
@@ -0,0 +1,35 @@
+export type RangeRequest = { start: number; end?: number } | { suffixLength: number };
+
+export interface ByteRange {
+  start: number;
+  end: number;
+  total: number;
+}
+
+// Only the first range is used if multiple ranges are requested
+export const parseRangeHeader = (value: string | null): RangeRequest | undefined => {
+  const match = value?.match(/^bytes=\s*(\d*)-(\d*)/);
+  if (!match) return undefined;
+
+  const [, start, end] = match;
+  if (start) {
+    return { start: parseInt(start, 10), end: end ? parseInt(end, 10) : undefined };
+  } else if (end) {
+    return { suffixLength: parseInt(end, 10) };
+  }
+};
+
+// Returns `null` if the range is not satisfiable
+export const resolveRange = (range: RangeRequest | undefined, total: number): ByteRange | null => {
+  if (!range) {
+    return { start: 0, end: total - 1, total };
+  }
+
+  const start = "suffixLength" in range ? Math.max(0, total - range.suffixLength) : range.start;
+  const end = "suffixLength" in range ? total - 1 : Math.min(range.end ?? total - 1, total - 1);
+  return start <= end ? { start, end, total } : null;
+};
+
+export const getContentRangeHeader = (range: ByteRange) => {
+  return { "Content-Range": `bytes ${range.start}-${range.end}/${range.total}` };
+};
diff --git a/src/lib/serviceWorker/types.ts b/src/lib/shared/serviceWorker.ts
similarity index 90%
rename from src/lib/serviceWorker/types.ts
rename to src/lib/shared/serviceWorker.ts
index 81bd4a0..4a668de 100644
--- a/src/lib/serviceWorker/types.ts
+++ b/src/lib/shared/serviceWorker.ts
@@ -1,3 +1,5 @@
+export const DECRYPTED_FILE_URL_PREFIX = "/_internal/decryptedFile/";
+
 export interface FileMetadata {
   isLegacy: boolean;
   dataKey: CryptoKey;
diff --git a/src/routes/(fullscreen)/client/pending/service.ts b/src/routes/(fullscreen)/client/pending/service.ts
index aebb9ec..bd5ec94 100644
--- a/src/routes/(fullscreen)/client/pending/service.ts
+++ b/src/routes/(fullscreen)/client/pending/service.ts
@@ -1,4 +1,4 @@
-import { concatenateBuffers, exportRSAKey, digestMessage } from "#lib/modules/crypto/index.js";
+import { concatenateBuffers, exportRSAKey, digestMessage } from "#lib/shared/crypto/index.js";
 
 export { requestMasterKeyDownload } from "#lib/services/key.js";
 
diff --git a/src/routes/(fullscreen)/file/[id]/+page.svelte b/src/routes/(fullscreen)/file/[id]/+page.svelte
index c5b0c82..246ccb7 100644
--- a/src/routes/(fullscreen)/file/[id]/+page.svelte
+++ b/src/routes/(fullscreen)/file/[id]/+page.svelte
@@ -6,8 +6,8 @@
   import { FullscreenDiv } from "#lib/components/atoms/index.js";
   import { Categories, IconEntryButton, TopBar } from "#lib/components/molecules/index.js";
   import { getFileInfo, type MaybeFileInfo } from "#lib/modules/filesystem/index.js";
-  import { captureVideoThumbnail } from "#lib/modules/thumbnail.js";
-  import { getFileDownloadState } from "#lib/modules/file/index.js";
+  import { captureVideoThumbnail } from "#lib/client/media/thumbnail.js";
+  import { getFileDownloadState } from "#lib/client/transfer/index.js";
   import { masterKeyStore } from "#lib/stores/index.js";
   import { HybridPromise } from "#lib/utils/index.js";
   import AddToCategoryBottomSheet from "./AddToCategoryBottomSheet.svelte";
diff --git a/src/routes/(fullscreen)/file/[id]/DownloadStatus.svelte b/src/routes/(fullscreen)/file/[id]/DownloadStatus.svelte
index 57eb237..e33139c 100644
--- a/src/routes/(fullscreen)/file/[id]/DownloadStatus.svelte
+++ b/src/routes/(fullscreen)/file/[id]/DownloadStatus.svelte
@@ -1,5 +1,5 @@
 <script lang="ts">
-  import { isFileDownloading, type FileDownloadState } from "#lib/modules/file/index.js";
+  import { isFileDownloading, type FileDownloadState } from "#lib/client/transfer/index.js";
   import { formatNetworkSpeed } from "#lib/utils/index.js";
 
   interface Props {
diff --git a/src/routes/(fullscreen)/file/[id]/service.ts b/src/routes/(fullscreen)/file/[id]/service.ts
index c4fa2cc..d562940 100644
--- a/src/routes/(fullscreen)/file/[id]/service.ts
+++ b/src/routes/(fullscreen)/file/[id]/service.ts
@@ -1,5 +1,5 @@
-import { storeFileThumbnailCache } from "#lib/modules/file/index.js";
-import { prepareFileDecryption, getDecryptedFileUrl } from "#lib/serviceWorker/index.js";
+import { storeFileThumbnailCache } from "#lib/client/cache/index.js";
+import { prepareFileDecryption, getDecryptedFileUrl } from "#lib/client/serviceWorker.js";
 import { requestFileThumbnailUpload } from "#lib/services/file.js";
 import { trpc } from "#trpc/client.js";
 
diff --git a/src/routes/(fullscreen)/file/downloads/+page.svelte b/src/routes/(fullscreen)/file/downloads/+page.svelte
index d491540..106550d 100644
--- a/src/routes/(fullscreen)/file/downloads/+page.svelte
+++ b/src/routes/(fullscreen)/file/downloads/+page.svelte
@@ -6,7 +6,7 @@
     getDownloadingFiles,
     clearDownloadedFiles,
     type FileDownloadState,
-  } from "#lib/modules/file/index.js";
+  } from "#lib/client/transfer/index.js";
   import { bulkGetFileInfo, type MaybeFileInfo } from "#lib/modules/filesystem/index.js";
   import { masterKeyStore } from "#lib/stores/index.js";
   import File from "./File.svelte";
diff --git a/src/routes/(fullscreen)/file/downloads/File.svelte b/src/routes/(fullscreen)/file/downloads/File.svelte
index accd36c..d8bc3d4 100644
--- a/src/routes/(fullscreen)/file/downloads/File.svelte
+++ b/src/routes/(fullscreen)/file/downloads/File.svelte
@@ -1,5 +1,5 @@
 <script lang="ts">
-  import type { FileDownloadState } from "#lib/modules/file/index.js";
+  import type { FileDownloadState } from "#lib/client/transfer/index.js";
   import type { SummarizedFileInfo } from "#lib/modules/filesystem/index.js";
   import { formatNetworkSpeed } from "#lib/utils/index.js";
 
diff --git a/src/routes/(fullscreen)/file/uploads/+page.svelte b/src/routes/(fullscreen)/file/uploads/+page.svelte
index 75ed841..04810a0 100644
--- a/src/routes/(fullscreen)/file/uploads/+page.svelte
+++ b/src/routes/(fullscreen)/file/uploads/+page.svelte
@@ -1,7 +1,7 @@
 <script lang="ts">
   import { FullscreenDiv } from "#lib/components/atoms/index.js";
   import { TopBar } from "#lib/components/molecules/index.js";
-  import { getUploadingFiles, clearUploadedFiles } from "#lib/modules/file/index.js";
+  import { getUploadingFiles, clearUploadedFiles } from "#lib/client/transfer/index.js";
   import File from "./File.svelte";
 
   const uploadingFiles = getUploadingFiles();
diff --git a/src/routes/(fullscreen)/file/uploads/File.svelte b/src/routes/(fullscreen)/file/uploads/File.svelte
index 06b2707..b345bc3 100644
--- a/src/routes/(fullscreen)/file/uploads/File.svelte
+++ b/src/routes/(fullscreen)/file/uploads/File.svelte
@@ -1,5 +1,5 @@
 <script lang="ts">
-  import type { FileUploadState } from "#lib/modules/file/index.js";
+  import type { FileUploadState } from "#lib/client/transfer/index.js";
   import { formatNetworkSpeed } from "#lib/utils/index.js";
 
   import IconPending from "~icons/material-symbols/pending";
diff --git a/src/routes/(fullscreen)/key/generate/service.ts b/src/routes/(fullscreen)/key/generate/service.ts
index 767e689..7e843ac 100644
--- a/src/routes/(fullscreen)/key/generate/service.ts
+++ b/src/routes/(fullscreen)/key/generate/service.ts
@@ -1,3 +1,4 @@
+import { deserializeClientKeys } from "#lib/modules/key.js";
 import {
   generateEncryptionKeyPair,
   generateSigningKeyPair,
@@ -10,8 +11,7 @@ import {
   makeAESKeyNonextractable,
   wrapHmacSecret,
   generateHmacSecret,
-} from "#lib/modules/crypto/index.js";
-import { deserializeClientKeys } from "#lib/modules/key.js";
+} from "#lib/shared/crypto/index.js";
 import { clientKeyStore } from "#lib/stores/index.js";
 
 export { requestLogout } from "#lib/services/auth.js";
diff --git a/src/routes/(fullscreen)/search/File.svelte b/src/routes/(fullscreen)/search/File.svelte
index fa4c0ae..2cd28fa 100644
--- a/src/routes/(fullscreen)/search/File.svelte
+++ b/src/routes/(fullscreen)/search/File.svelte
@@ -1,7 +1,7 @@
 <script lang="ts">
   import { ActionEntryButton } from "#lib/components/atoms/index.js";
   import { DirectoryEntryLabel } from "#lib/components/molecules/index.js";
-  import { getFileThumbnail } from "#lib/modules/file/index.js";
+  import { getFileThumbnail } from "#lib/client/cache/index.js";
   import type { SummarizedFileInfo } from "#lib/modules/filesystem/index.js";
   import { formatDateTime } from "#lib/utils/index.js";
 
diff --git a/src/routes/(fullscreen)/settings/cache/+page.svelte b/src/routes/(fullscreen)/settings/cache/+page.svelte
index 6d4a10f..021e163 100644
--- a/src/routes/(fullscreen)/settings/cache/+page.svelte
+++ b/src/routes/(fullscreen)/settings/cache/+page.svelte
@@ -2,11 +2,11 @@
   import { onMount } from "svelte";
   import { FullscreenDiv } from "#lib/components/atoms/index.js";
   import { TopBar } from "#lib/components/molecules/index.js";
-  import type { FileCacheIndex } from "#lib/indexedDB/index.js";
+  import type { FileCacheIndex } from "#lib/client/storage/indexedDB/index.js";
   import {
     getFileCacheIndex,
     deleteFileCache as doDeleteFileCache,
-  } from "#lib/modules/file/index.js";
+  } from "#lib/client/cache/index.js";
   import { bulkGetFileInfo, type MaybeFileInfo } from "#lib/modules/filesystem/index.js";
   import { masterKeyStore } from "#lib/stores/index.js";
   import { formatFileSize } from "#lib/utils/index.js";
diff --git a/src/routes/(fullscreen)/settings/cache/File.svelte b/src/routes/(fullscreen)/settings/cache/File.svelte
index a60e08f..1724f5c 100644
--- a/src/routes/(fullscreen)/settings/cache/File.svelte
+++ b/src/routes/(fullscreen)/settings/cache/File.svelte
@@ -1,5 +1,5 @@
 <script lang="ts">
-  import type { FileCacheIndex } from "#lib/indexedDB/index.js";
+  import type { FileCacheIndex } from "#lib/client/storage/indexedDB/index.js";
   import type { MaybeFileInfo } from "#lib/modules/filesystem/index.js";
   import { formatDate, formatFileSize } from "#lib/utils/index.js";
 
diff --git a/src/routes/(fullscreen)/settings/thumbnail/+page.svelte b/src/routes/(fullscreen)/settings/thumbnail/+page.svelte
index 5d7f28b..ab6a26f 100644
--- a/src/routes/(fullscreen)/settings/thumbnail/+page.svelte
+++ b/src/routes/(fullscreen)/settings/thumbnail/+page.svelte
@@ -3,7 +3,7 @@
   import { goto } from "$app/navigation";
   import { BottomDiv, Button, FullscreenDiv } from "#lib/components/atoms/index.js";
   import { IconEntryButton, TopBar } from "#lib/components/molecules/index.js";
-  import { deleteAllFileThumbnailCaches } from "#lib/modules/file/index.js";
+  import { deleteAllFileThumbnailCaches } from "#lib/client/cache/index.js";
   import type { MaybeFileInfo } from "#lib/modules/filesystem/index.js";
   import { masterKeyStore } from "#lib/stores/index.js";
   import { sortEntries } from "#lib/utils/index.js";
diff --git a/src/routes/(fullscreen)/settings/thumbnail/service.ts b/src/routes/(fullscreen)/settings/thumbnail/service.ts
index ff6b403..ae57b23 100644
--- a/src/routes/(fullscreen)/settings/thumbnail/service.ts
+++ b/src/routes/(fullscreen)/settings/thumbnail/service.ts
@@ -1,8 +1,8 @@
 import { limitFunction } from "p-limit";
 import { SvelteMap } from "svelte/reactivity";
-import { storeFileThumbnailCache } from "#lib/modules/file/index.js";
+import { storeFileThumbnailCache } from "#lib/client/cache/index.js";
+import { generateThumbnail } from "#lib/client/media/thumbnail.js";
 import { getFileInfo, type FileInfo } from "#lib/modules/filesystem/index.js";
-import { generateThumbnail } from "#lib/modules/thumbnail.js";
 import { requestFileDownload, requestFileThumbnailUpload } from "#lib/services/file.js";
 import { HybridPromise, Scheduler } from "#lib/utils/index.js";
 import type { RouterOutputs } from "#trpc/router.server.js";
diff --git a/src/routes/(main)/category/[[id]]/+page.svelte b/src/routes/(main)/category/[[id]]/+page.svelte
index e647dd5..cd8caad 100644
--- a/src/routes/(main)/category/[[id]]/+page.svelte
+++ b/src/routes/(main)/category/[[id]]/+page.svelte
@@ -3,7 +3,7 @@
   import { CheckBox, RowVirtualizer } from "#lib/components/atoms/index.js";
   import { SubCategories, TopBar } from "#lib/components/molecules/index.js";
   import { CategoryCreateModal } from "#lib/components/organisms/index.js";
-  import { updateCategoryInfo } from "#lib/indexedDB/index.js";
+  import { updateCategoryInfo } from "#lib/client/storage/indexedDB/index.js";
   import { getCategoryInfo, type MaybeCategoryInfo } from "#lib/modules/filesystem/index.js";
   import { masterKeyStore } from "#lib/stores/index.js";
   import { HybridPromise, sortEntries } from "#lib/utils/index.js";
diff --git a/src/routes/(main)/category/[[id]]/File.svelte b/src/routes/(main)/category/[[id]]/File.svelte
index afb9b42..0f1935b 100644
--- a/src/routes/(main)/category/[[id]]/File.svelte
+++ b/src/routes/(main)/category/[[id]]/File.svelte
@@ -1,7 +1,7 @@
 <script lang="ts">
   import { ActionEntryButton } from "#lib/components/atoms/index.js";
   import { DirectoryEntryLabel } from "#lib/components/molecules/index.js";
-  import { getFileThumbnail } from "#lib/modules/file/index.js";
+  import { getFileThumbnail } from "#lib/client/cache/index.js";
   import type { CategoryFileInfo } from "#lib/modules/filesystem/index.js";
   import { formatDateTime } from "#lib/utils/index.js";
   import type { SelectedFile } from "./service.svelte";
diff --git a/src/routes/(main)/category/[[id]]/service.svelte.ts b/src/routes/(main)/category/[[id]]/service.svelte.ts
index d5d0d14..9a89c4f 100644
--- a/src/routes/(main)/category/[[id]]/service.svelte.ts
+++ b/src/routes/(main)/category/[[id]]/service.svelte.ts
@@ -1,6 +1,6 @@
 import { getContext, setContext } from "svelte";
-import { encryptString } from "#lib/modules/crypto/index.js";
 import type { SelectedCategory } from "#lib/components/molecules/index.js";
+import { encryptString } from "#lib/shared/crypto/index.js";
 import { trpc } from "#trpc/client.js";
 
 export { requestCategoryCreation, requestFileRemovalFromCategory } from "#lib/services/category.js";
diff --git a/src/routes/(main)/directory/[[id]]/DirectoryEntries/DirectoryEntries.svelte b/src/routes/(main)/directory/[[id]]/DirectoryEntries/DirectoryEntries.svelte
index 832a4d1..e27029d 100644
--- a/src/routes/(main)/directory/[[id]]/DirectoryEntries/DirectoryEntries.svelte
+++ b/src/routes/(main)/directory/[[id]]/DirectoryEntries/DirectoryEntries.svelte
@@ -1,7 +1,7 @@
 <script lang="ts">
   import { ActionEntryButton, RowVirtualizer } from "#lib/components/atoms/index.js";
   import { DirectoryEntryLabel } from "#lib/components/molecules/index.js";
-  import { getUploadingFiles, type LiveFileUploadState } from "#lib/modules/file/index.js";
+  import { getUploadingFiles, type LiveFileUploadState } from "#lib/client/transfer/index.js";
   import type { DirectoryInfo } from "#lib/modules/filesystem/index.js";
   import { sortEntries } from "#lib/utils/index.js";
   import File from "./File.svelte";
diff --git a/src/routes/(main)/directory/[[id]]/DirectoryEntries/File.svelte b/src/routes/(main)/directory/[[id]]/DirectoryEntries/File.svelte
index 68d0a8c..d0e7056 100644
--- a/src/routes/(main)/directory/[[id]]/DirectoryEntries/File.svelte
+++ b/src/routes/(main)/directory/[[id]]/DirectoryEntries/File.svelte
@@ -1,7 +1,7 @@
 <script lang="ts">
   import { ActionEntryButton } from "#lib/components/atoms/index.js";
   import { DirectoryEntryLabel } from "#lib/components/molecules/index.js";
-  import { getFileThumbnail } from "#lib/modules/file/index.js";
+  import { getFileThumbnail } from "#lib/client/cache/index.js";
   import type { SummarizedFileInfo } from "#lib/modules/filesystem/index.js";
   import { formatDateTime } from "#lib/utils/index.js";
   import type { SelectedEntry } from "../service.svelte";
diff --git a/src/routes/(main)/directory/[[id]]/DirectoryEntries/UploadingFile.svelte b/src/routes/(main)/directory/[[id]]/DirectoryEntries/UploadingFile.svelte
index a0fa3a1..c2aa834 100644
--- a/src/routes/(main)/directory/[[id]]/DirectoryEntries/UploadingFile.svelte
+++ b/src/routes/(main)/directory/[[id]]/DirectoryEntries/UploadingFile.svelte
@@ -1,5 +1,5 @@
 <script lang="ts">
-  import type { LiveFileUploadState } from "#lib/modules/file/index.js";
+  import type { LiveFileUploadState } from "#lib/client/transfer/index.js";
   import { formatNetworkSpeed } from "#lib/utils/index.js";
 
   import IconDraft from "~icons/material-symbols/draft";
diff --git a/src/routes/(main)/directory/[[id]]/DownloadStatusCard.svelte b/src/routes/(main)/directory/[[id]]/DownloadStatusCard.svelte
index 864509a..85b46ca 100644
--- a/src/routes/(main)/directory/[[id]]/DownloadStatusCard.svelte
+++ b/src/routes/(main)/directory/[[id]]/DownloadStatusCard.svelte
@@ -1,5 +1,5 @@
 <script lang="ts">
-  import { getDownloadingFiles } from "#lib/modules/file/index.js";
+  import { getDownloadingFiles } from "#lib/client/transfer/index.js";
 
   interface Props {
     onclick: () => void;
diff --git a/src/routes/(main)/directory/[[id]]/UploadStatusCard.svelte b/src/routes/(main)/directory/[[id]]/UploadStatusCard.svelte
index d27efca..7794266 100644
--- a/src/routes/(main)/directory/[[id]]/UploadStatusCard.svelte
+++ b/src/routes/(main)/directory/[[id]]/UploadStatusCard.svelte
@@ -1,5 +1,5 @@
 <script lang="ts">
-  import { getUploadingFiles } from "#lib/modules/file/index.js";
+  import { getUploadingFiles } from "#lib/client/transfer/index.js";
 
   interface Props {
     onclick: () => void;
diff --git a/src/routes/(main)/directory/[[id]]/service.svelte.ts b/src/routes/(main)/directory/[[id]]/service.svelte.ts
index a151343..2d5f2e0 100644
--- a/src/routes/(main)/directory/[[id]]/service.svelte.ts
+++ b/src/routes/(main)/directory/[[id]]/service.svelte.ts
@@ -1,19 +1,19 @@
 import { getContext, setContext } from "svelte";
-import { storeHmacSecrets } from "#lib/indexedDB/index.js";
-import {
-  generateDataKey,
-  wrapDataKey,
-  unwrapHmacSecret,
-  encryptString,
-} from "#lib/modules/crypto/index.js";
 import {
   storeFileCache,
   deleteFileCache,
   storeFileThumbnailCache,
   deleteFileThumbnailCache,
-  uploadFile,
-} from "#lib/modules/file/index.js";
+} from "#lib/client/cache/index.js";
+import { storeHmacSecrets } from "#lib/client/storage/indexedDB/index.js";
+import { uploadFile } from "#lib/client/transfer/index.js";
 import type { DataKey } from "#lib/modules/filesystem/index.js";
+import {
+  generateDataKey,
+  wrapDataKey,
+  unwrapHmacSecret,
+  encryptString,
+} from "#lib/shared/crypto/index.js";
 import { hmacSecretStore, type MasterKey, type HmacSecret } from "#lib/stores/index.js";
 import { trpc } from "#trpc/client.js";
 
diff --git a/src/routes/(main)/favorites/File.svelte b/src/routes/(main)/favorites/File.svelte
index 45c0593..d0c56e1 100644
--- a/src/routes/(main)/favorites/File.svelte
+++ b/src/routes/(main)/favorites/File.svelte
@@ -1,7 +1,7 @@
 <script lang="ts">
   import { ActionEntryButton } from "#lib/components/atoms/index.js";
   import { DirectoryEntryLabel } from "#lib/components/molecules/index.js";
-  import { getFileThumbnail } from "#lib/modules/file/index.js";
+  import { getFileThumbnail } from "#lib/client/cache/index.js";
   import type { SummarizedFileInfo } from "#lib/modules/filesystem/index.js";
   import { formatDateTime } from "#lib/utils/index.js";
 
diff --git a/src/routes/(main)/home/service.ts b/src/routes/(main)/home/service.ts
index a7b82e1..48b3fe6 100644
--- a/src/routes/(main)/home/service.ts
+++ b/src/routes/(main)/home/service.ts
@@ -1,4 +1,4 @@
-import { getAllFileInfos } from "#lib/indexedDB/index.js";
+import { getAllFileInfos } from "#lib/client/storage/indexedDB/index.js";
 
 export const requestFreshMediaFilesRetrieval = async (limit = 8) => {
   const files = await getAllFileInfos();
diff --git a/src/routes/+layout.svelte b/src/routes/+layout.svelte
index 23f9059..e04e0ea 100644
--- a/src/routes/+layout.svelte
+++ b/src/routes/+layout.svelte
@@ -1,5 +1,5 @@
 <script lang="ts">
-  import { getDownloadingFiles, getUploadingFiles } from "#lib/modules/file/index.js";
+  import { getDownloadingFiles, getUploadingFiles } from "#lib/client/transfer/index.js";
   import "../app.css";
 
   let { children } = $props();
diff --git a/src/routes/api/file/[id]/[[thumbnail=thumbnail]]/download/+server.ts b/src/routes/api/file/[id]/[[thumbnail=thumbnail]]/download/+server.ts
index 8724ed6..f3a8d2d 100644
--- a/src/routes/api/file/[id]/[[thumbnail=thumbnail]]/download/+server.ts
+++ b/src/routes/api/file/[id]/[[thumbnail=thumbnail]]/download/+server.ts
@@ -1,9 +1,9 @@
 import { error } from "@sveltejs/kit";
 import { z } from "zod";
-import { parseRangeHeader, getContentRangeHeader } from "#lib/modules/http.js";
 import { authorize } from "#lib/server/auth.js";
 import { handleAppErrors } from "#lib/server/http.js";
 import { FileService } from "#lib/server/services/index.js";
+import { parseRangeHeader, getContentRangeHeader } from "#lib/shared/http.js";
 import type { RequestEvent, RequestHandler } from "./$types";
 
 const downloadHandler = async ({ locals, params, request }: RequestEvent) => {
diff --git a/src/service-worker/constants.ts b/src/service-worker/constants.ts
deleted file mode 100644
index 4938d61..0000000
--- a/src/service-worker/constants.ts
+++ /dev/null
@@ -1 +0,0 @@
-export * from "../lib/constants";
diff --git a/src/service-worker/handlers/decryptFile.ts b/src/service-worker/handlers/decryptFile.ts
index d670c3e..96fe636 100644
--- a/src/service-worker/handlers/decryptFile.ts
+++ b/src/service-worker/handlers/decryptFile.ts
@@ -1,14 +1,25 @@
-import { DECRYPTED_FILE_URL_PREFIX, CHUNK_SIZE, ENCRYPTED_CHUNK_SIZE } from "../constants";
-import { decryptChunk, getEncryptedRange, getDecryptedSize } from "../modules/crypto";
-import { parseRangeHeader, getContentRangeHeader } from "../modules/http";
+import { getFile } from "#lib/client/storage/opfs.js";
+import { decryptChunk } from "#lib/shared/crypto/index.js";
+import {
+  CHUNK_SIZE,
+  ENCRYPTED_CHUNK_SIZE,
+  getDecryptedSize,
+  getEncryptedRange,
+} from "#lib/shared/format/index.js";
+import {
+  getContentRangeHeader,
+  parseRangeHeader,
+  resolveRange,
+  type ByteRange,
+  type RangeRequest,
+} from "#lib/shared/http.js";
+import { DECRYPTED_FILE_URL_PREFIX, type FileMetadata } from "#lib/shared/serviceWorker.js";
 import { getFileMetadata } from "../modules/metadata";
-import { getFile } from "../modules/opfs";
-import type { FileMetadata } from "../types";
 
 const createResponse = (
   stream: ReadableStream<Uint8Array>,
   isRangeRequest: boolean,
-  range: { start: number; end: number; total: number },
+  range: ByteRange,
   contentType?: string,
   downloadFilename?: string,
 ) => {
@@ -33,22 +44,28 @@ const createResponse = (
   });
 };
 
+const createRangeNotSatisfiableResponse = (total: number) => {
+  return new Response("Invalid range", {
+    status: 416,
+    headers: { "Content-Range": `bytes */${total}` },
+  });
+};
+
 const streamFromOpfs = async (
   file: File,
   metadata?: FileMetadata,
-  range?: { start?: number; end?: number },
+  rangeRequest?: RangeRequest,
   downloadFilename?: string,
 ) => {
-  const start = range?.start ?? 0;
-  const end = range?.end ?? file.size - 1;
-  if (start > end || start < 0 || end >= file.size) {
-    return new Response("Invalid range", { status: 416 });
+  const range = resolveRange(rangeRequest, file.size);
+  if (!range) {
+    return createRangeNotSatisfiableResponse(file.size);
   }
 
   return createResponse(
-    file.slice(start, end + 1).stream(),
-    !!range,
-    { start, end, total: file.size },
+    file.slice(range.start, range.end + 1).stream(),
+    !!rangeRequest,
+    range,
     metadata?.contentType,
     downloadFilename,
   );
@@ -57,16 +74,16 @@ const streamFromOpfs = async (
 const streamFromServer = async (
   id: number,
   metadata: FileMetadata,
-  range?: { start?: number; end?: number },
+  rangeRequest?: RangeRequest,
   downloadFilename?: string,
 ) => {
   const totalSize = getDecryptedSize(metadata.encContentSize, metadata.isLegacy);
-  const start = range?.start ?? 0;
-  const end = range?.end ?? totalSize - 1;
-  if (start > end || start < 0 || end >= totalSize) {
-    return new Response("Invalid range", { status: 416 });
+  const range = resolveRange(rangeRequest, totalSize);
+  if (!range) {
+    return createRangeNotSatisfiableResponse(totalSize);
   }
 
+  const { start, end } = range;
   const encryptedRange = getEncryptedRange(start, end, metadata.encContentSize, metadata.isLegacy);
   const apiResponse = await fetch(`/api/file/${id}/download`, {
     headers: { Range: `bytes=${encryptedRange.start}-${encryptedRange.end}` },
@@ -85,9 +102,10 @@ const streamFromServer = async (
           controller.close();
         },
       }),
-      !!range,
-      { start, end, total: totalSize },
+      !!rangeRequest,
+      range,
       metadata.contentType,
+      downloadFilename,
     );
   }
 
@@ -124,8 +142,8 @@ const streamFromServer = async (
 
   return createResponse(
     apiResponse.body.pipeThrough(decryptingStream),
-    !!range,
-    { start, end, total: totalSize },
+    !!rangeRequest,
+    range,
     metadata.contentType,
     downloadFilename,
   );
diff --git a/src/service-worker/index.ts b/src/service-worker/index.ts
index b2e6ef6..a6932ba 100644
--- a/src/service-worker/index.ts
+++ b/src/service-worker/index.ts
@@ -1,8 +1,11 @@
 import { self } from "$app/service-worker";
-import { DECRYPTED_FILE_URL_PREFIX } from "./constants";
+import {
+  DECRYPTED_FILE_URL_PREFIX,
+  type ServiceWorkerMessage,
+  type ServiceWorkerResponse,
+} from "#lib/shared/serviceWorker.js";
 import { decryptFile } from "./handlers";
 import { fileMetadataStore } from "./stores";
-import type { ServiceWorkerMessage, ServiceWorkerResponse } from "./types";
 
 self.addEventListener("message", (event) => {
   const message: ServiceWorkerMessage = event.data;
diff --git a/src/service-worker/modules/http.ts b/src/service-worker/modules/http.ts
deleted file mode 100644
index 0d1bf5e..0000000
--- a/src/service-worker/modules/http.ts
+++ /dev/null
@@ -1 +0,0 @@
-export * from "../../lib/modules/http";
diff --git a/src/service-worker/modules/metadata.ts b/src/service-worker/modules/metadata.ts
index 77ddf42..fcc8ad8 100644
--- a/src/service-worker/modules/metadata.ts
+++ b/src/service-worker/modules/metadata.ts
@@ -1,6 +1,6 @@
 import { self } from "$app/service-worker";
+import type { FileMetadata, ServiceWorkerResponse } from "#lib/shared/serviceWorker.js";
 import { fileMetadataStore } from "../stores";
-import type { FileMetadata, ServiceWorkerResponse } from "../types";
 
 const METADATA_REQUEST_TIMEOUT_MS = 3000;
 
diff --git a/src/service-worker/modules/opfs.ts b/src/service-worker/modules/opfs.ts
deleted file mode 100644
index 0ef5769..0000000
--- a/src/service-worker/modules/opfs.ts
+++ /dev/null
@@ -1 +0,0 @@
-export * from "../../lib/modules/opfs";
diff --git a/src/service-worker/stores.ts b/src/service-worker/stores.ts
index 0f75d4a..395a132 100644
--- a/src/service-worker/stores.ts
+++ b/src/service-worker/stores.ts
@@ -1,4 +1,4 @@
-import type { FileMetadata } from "./types";
+import type { FileMetadata } from "#lib/shared/serviceWorker.js";
 
 const MAX_FILE_METADATA_ENTRIES = 32;
 
diff --git a/src/service-worker/types.ts b/src/service-worker/types.ts
deleted file mode 100644
index f04ed39..0000000
--- a/src/service-worker/types.ts
+++ /dev/null
@@ -1 +0,0 @@
-export * from "../lib/serviceWorker/types";
diff --git a/tests/server/download.test.ts b/tests/server/download.test.ts
index 1cffa25..b050538 100644
--- a/tests/server/download.test.ts
+++ b/tests/server/download.test.ts
@@ -39,6 +39,25 @@ describe("createEncContentStream", () => {
     expect(await read(encContentStream)).toBe("2345");
   });
 
+  it("serves suffix ranges", async () => {
+    const path = await createFile("0123456789");
+
+    const { encContentStream, range } = await createEncContentStream(path, undefined, {
+      suffixLength: 3,
+    });
+
+    expect(range).toEqual({ start: 7, end: 9, total: 10 });
+    expect(await read(encContentStream)).toBe("789");
+  });
+
+  it("rejects unsatisfiable ranges", async () => {
+    const path = await createFile("0123456789");
+
+    await expect(createEncContentStream(path, undefined, { start: 10 })).rejects.toMatchObject({
+      code: "RANGE_NOT_SATISFIABLE",
+    });
+  });
+
   it("prepends the legacy IV to the content", async () => {
     const path = await createFile("6789");
 
diff --git a/tests/unit/crypto.test.ts b/tests/unit/crypto.test.ts
index a29e8c6..055fc11 100644
--- a/tests/unit/crypto.test.ts
+++ b/tests/unit/crypto.test.ts
@@ -7,7 +7,7 @@ import {
   encryptChunk,
   encryptString,
   generateDataKey,
-} from "#lib/modules/crypto/index.js";
+} from "#lib/shared/crypto/index.js";
 
 describe("base64", () => {
   it("round-trips large buffers", () => {
diff --git a/tests/unit/range.test.ts b/tests/unit/range.test.ts
index 002220e..e904ef4 100644
--- a/tests/unit/range.test.ts
+++ b/tests/unit/range.test.ts
@@ -1,7 +1,13 @@
 import { describe, expect, it } from "vitest";
-import { CHUNK_SIZE, ENCRYPTED_CHUNK_SIZE, ENCRYPTION_OVERHEAD } from "#lib/constants/index.js";
-import { getContentRangeHeader, parseRangeHeader } from "#lib/modules/http.js";
-import { getDecryptedSize, getEncryptedRange } from "../../src/service-worker/modules/crypto";
+import {
+  CHUNK_SIZE,
+  ENCRYPTED_CHUNK_SIZE,
+  ENCRYPTION_OVERHEAD,
+  getDecryptedSize,
+  getEncryptedRange,
+  getEncryptedSize,
+} from "#lib/shared/format/index.js";
+import { getContentRangeHeader, parseRangeHeader, resolveRange } from "#lib/shared/http.js";
 
 describe("parseRangeHeader", () => {
   it("parses byte ranges", () => {
@@ -9,6 +15,33 @@ describe("parseRangeHeader", () => {
     expect(parseRangeHeader("bytes=0-")).toEqual({ start: 0, end: undefined });
     expect(parseRangeHeader("bytes=10-20")).toEqual({ start: 10, end: 20 });
     expect(parseRangeHeader("bytes=10-20, 30-40")).toEqual({ start: 10, end: 20 });
+    expect(parseRangeHeader("bytes=-500")).toEqual({ suffixLength: 500 });
+  });
+
+  it("ignores invalid ranges", () => {
+    expect(parseRangeHeader("bytes=-")).toBeUndefined();
+    expect(parseRangeHeader("items=0-1")).toBeUndefined();
+  });
+});
+
+describe("resolveRange", () => {
+  it("resolves the whole content without a range", () => {
+    expect(resolveRange(undefined, 100)).toEqual({ start: 0, end: 99, total: 100 });
+  });
+
+  it("clamps the end to the content size", () => {
+    expect(resolveRange({ start: 10, end: 1000 }, 100)).toEqual({ start: 10, end: 99, total: 100 });
+    expect(resolveRange({ start: 10 }, 100)).toEqual({ start: 10, end: 99, total: 100 });
+  });
+
+  it("resolves suffix ranges", () => {
+    expect(resolveRange({ suffixLength: 10 }, 100)).toEqual({ start: 90, end: 99, total: 100 });
+    expect(resolveRange({ suffixLength: 1000 }, 100)).toEqual({ start: 0, end: 99, total: 100 });
+  });
+
+  it("rejects unsatisfiable ranges", () => {
+    expect(resolveRange({ start: 100 }, 100)).toBeNull();
+    expect(resolveRange({ start: 20, end: 10 }, 100)).toBeNull();
   });
 
   it("formats Content-Range", () => {
@@ -19,13 +52,13 @@ describe("parseRangeHeader", () => {
 });
 
 describe("encrypted chunk layout", () => {
-  const encryptedSizeOf = (size: number) =>
-    size + Math.ceil(size / CHUNK_SIZE) * ENCRYPTION_OVERHEAD;
-
   it.each([1, CHUNK_SIZE - 1, CHUNK_SIZE, CHUNK_SIZE + 1, 3 * CHUNK_SIZE + 12345])(
     "computes the decrypted size of %i bytes",
     (size) => {
-      expect(getDecryptedSize(encryptedSizeOf(size), false)).toBe(size);
+      expect(getEncryptedSize(size)).toBe(
+        size + Math.ceil(size / CHUNK_SIZE) * ENCRYPTION_OVERHEAD,
+      );
+      expect(getDecryptedSize(getEncryptedSize(size), false)).toBe(size);
     },
   );
 
@@ -35,7 +68,7 @@ describe("encrypted chunk layout", () => {
 
   it("maps a plaintext range to whole encrypted chunks", () => {
     const totalSize = 3 * CHUNK_SIZE + 100;
-    const totalEncryptedSize = encryptedSizeOf(totalSize);
+    const totalEncryptedSize = getEncryptedSize(totalSize);
 
     expect(getEncryptedRange(0, 10, totalEncryptedSize, false)).toEqual({
       firstChunkIndex: 0,