@studious-lms/server 1.7.0 → 1.8.0

package/dist/services/file.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.js","sources":["services/file.ts"],"sourceRoot":"/","sourcesContent":["/**\n * File service – signed URLs, move, rename, delete. Handles permission checks\n * for assignment, submission, announcement, folder, and user-owned files.\n */\nimport { TRPCError } from \"@trpc/server\";\nimport { getSignedUrl, deleteFile } from \"../lib/googleCloudStorage.js\";\nimport { logger } from \"../utils/logger.js\";\nimport {\n  findFileById,\n  findFileWithFolder,\n  findFileWithFolderAndThumbnail,\n  findFolderById,\n  updateFileFolder,\n  updateFileName,\n  deleteFileById,\n} from \"../models/file.js\";\nimport { findConversationMembership } from \"../models/message.js\";\n\nfunction isSchoolAdminForClass(classData: any, userId: string) {\n  return Boolean(\n    classData?.school?.memberships?.some(\n      (membership: { userId: string }) => membership.userId === userId\n    ) ||\n      classData?.school?.users?.some((admin: { id: string }) => admin.id === userId)\n  );\n}\n\n/** Generate a signed URL for file download. Validates user has access. */\nexport async function getFileSignedUrl(userId: string, fileId: string) {\n  const file = await findFileById(fileId);\n  if (!file) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"File does not exist\",\n    });\n  }\n\n  let hasAccess = false;\n\n  if (file.assignment?.class) {\n    const isTeacher = file.assignment.class.teachers.some(\n      (t) => t.id === userId\n    );\n    const isStudent = file.assignment.class.students.some(\n      (s) => s.id === userId\n    );\n    const isSchoolAdmin = isSchoolAdminForClass(file.assignment.class, userId);\n    logger.info(\n      `Assignment file access check - userId: ${userId}, isTeacher: ${isTeacher}, isStudent: ${isStudent}, isSchoolAdmin: ${isSchoolAdmin}`\n    );\n    hasAccess = isTeacher || isStudent || isSchoolAdmin;\n  }\n\n  if ((file as any).announcement?.class) {\n    const ann = (file as any).announcement;\n    const isTeacher = ann.class.teachers.some((t: any) => t.id === userId);\n    const isStudent = ann.class.students.some((s: any) => s.id === userId);\n    const isSchoolAdmin = isSchoolAdminForClass(ann.class, userId);\n    hasAccess = hasAccess || isTeacher || isStudent || isSchoolAdmin;\n  }\n\n  if (file.submission?.assignment?.classId) {\n    hasAccess =\n      hasAccess ||\n      file.submission.studentId === userId ||\n      file.submission.assignment.class.teachers.some((t) => t.id === userId) ||\n      isSchoolAdminForClass(file.submission.assignment.class, userId);\n  }\n\n  if (file.annotations?.assignment?.classId) {\n    hasAccess =\n      hasAccess ||\n      file.annotations.studentId === userId ||\n      file.annotations.assignment.class.teachers.some((t) => t.id === userId) ||\n      isSchoolAdminForClass(file.annotations.assignment.class, userId);\n  }\n\n  if (file.userId === userId) {\n    hasAccess = true;\n  }\n\n  if (file.conversationId) {\n    const membership = await findConversationMembership(file.conversationId, userId);\n    hasAccess = hasAccess || Boolean(membership);\n  }\n\n  if (file.folder?.class) {\n    const isTeacher = file.folder.class.teachers.some((t) => t.id === userId);\n    const isStudent = file.folder.class.students.some((s) => s.id === userId);\n    const isSchoolAdmin = isSchoolAdminForClass(file.folder.class, userId);\n    hasAccess = hasAccess || isTeacher || isStudent || isSchoolAdmin;\n  }\n\n  if (!hasAccess) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You do not have access to this file\",\n    });\n  }\n\n  try {\n    const signedUrl = await getSignedUrl(file.path);\n    return { url: signedUrl };\n  } catch (error) {\n    logger.error(\"Error generating signed URL:\", error as Record<string, unknown>);\n    throw new TRPCError({\n      code: \"INTERNAL_SERVER_ERROR\",\n      message: \"Failed to generate download URL\",\n    });\n  }\n}\n\nexport async function moveFile(\n  fileId: string,\n  targetFolderId: string\n) {\n  const file = await findFileWithFolder(fileId);\n  if (!file) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"File not found\",\n    });\n  }\n\n  const targetFolder = await findFolderById(targetFolderId);\n  if (!targetFolder) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Target folder not found\",\n    });\n  }\n\n  return updateFileFolder(fileId, targetFolderId);\n}\n\nexport async function renameFile(\n  fileId: string,\n  newName: string\n) {\n  const file = await findFileWithFolder(fileId);\n  if (!file) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"File not found\",\n    });\n  }\n\n  if (!newName.trim()) {\n    throw new TRPCError({\n      code: \"BAD_REQUEST\",\n      message: \"File name cannot be empty\",\n    });\n  }\n\n  return updateFileName(fileId, newName.trim());\n}\n\nexport async function deleteFileRecord(fileId: string, classId: string) {\n  const file = await findFileWithFolderAndThumbnail(fileId);\n  if (!file) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"File not found\",\n    });\n  }\n\n  if (file.folder?.classId !== classId) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"File does not belong to this class\",\n    });\n  }\n\n  try {\n    if (file.uploadStatus === \"COMPLETED\") {\n      await deleteFile(file.path);\n      if (file.thumbnail) {\n        await deleteFile(file.thumbnail.path);\n      }\n    }\n  } catch (error) {\n    logger.warn(`Failed to delete file ${file.path}:`, error as Record<string, unknown>);\n  }\n\n  await deleteFileById(fileId);\n  return { success: true };\n}\n"],"names":[],"mappings":"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","debug_id":"4ce26498-ba77-5a67-910b-428e64d7047b"}
+{"version":3,"file":"file.js","sources":["services/file.ts"],"sourceRoot":"/","sourcesContent":["/**\n * File service – signed URLs, move, rename, delete. Handles permission checks\n * for assignment, submission, announcement, folder, and user-owned files.\n *\n * The class files page calls the legacy class-scoped helpers; the unified\n * cloud-storage page calls the `*Scoped` / `*Generic` helpers below, which\n * derive permissions from the parent folder's CloudScope so the same endpoint\n * can serve class, school, and personal storage.\n */\nimport { TRPCError } from \"@trpc/server\";\nimport { getSignedUrl, deleteFile } from \"../lib/googleCloudStorage.js\";\nimport { logger } from \"../utils/logger.js\";\nimport {\n  findFileById,\n  findFileWithFolder,\n  findFileWithFolderAndThumbnail,\n  findFolderById,\n  updateFileFolder,\n  updateFileName,\n  deleteFileById,\n} from \"../models/file.js\";\nimport { findConversationMembership } from \"../models/message.js\";\nimport { prisma } from \"../lib/prisma.js\";\nimport { resolveFolderScope } from \"../models/cloudStorage.js\";\nimport { requireFolderAccess } from \"./folder.js\";\n\nfunction isSchoolAdminForClass(classData: any, userId: string) {\n  return Boolean(\n    classData?.school?.memberships?.some(\n      (membership: { userId: string }) => membership.userId === userId\n    ) ||\n      classData?.school?.users?.some((admin: { id: string }) => admin.id === userId)\n  );\n}\n\n/** Generate a signed URL for file download. Validates user has access. */\nexport async function getFileSignedUrl(userId: string, fileId: string) {\n  const file = await findFileById(fileId);\n  if (!file) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"File does not exist\",\n    });\n  }\n\n  let hasAccess = false;\n\n  if (file.assignment?.class) {\n    const isTeacher = file.assignment.class.teachers.some(\n      (t) => t.id === userId\n    );\n    const isStudent = file.assignment.class.students.some(\n      (s) => s.id === userId\n    );\n    const isSchoolAdmin = isSchoolAdminForClass(file.assignment.class, userId);\n    logger.info(\n      `Assignment file access check - userId: ${userId}, isTeacher: ${isTeacher}, isStudent: ${isStudent}, isSchoolAdmin: ${isSchoolAdmin}`\n    );\n    hasAccess = isTeacher || isStudent || isSchoolAdmin;\n  }\n\n  if ((file as any).announcement?.class) {\n    const ann = (file as any).announcement;\n    const isTeacher = ann.class.teachers.some((t: any) => t.id === userId);\n    const isStudent = ann.class.students.some((s: any) => s.id === userId);\n    const isSchoolAdmin = isSchoolAdminForClass(ann.class, userId);\n    hasAccess = hasAccess || isTeacher || isStudent || isSchoolAdmin;\n  }\n\n  if (file.submission?.assignment?.classId) {\n    hasAccess =\n      hasAccess ||\n      file.submission.studentId === userId ||\n      file.submission.assignment.class.teachers.some((t) => t.id === userId) ||\n      isSchoolAdminForClass(file.submission.assignment.class, userId);\n  }\n\n  if (file.annotations?.assignment?.classId) {\n    hasAccess =\n      hasAccess ||\n      file.annotations.studentId === userId ||\n      file.annotations.assignment.class.teachers.some((t) => t.id === userId) ||\n      isSchoolAdminForClass(file.annotations.assignment.class, userId);\n  }\n\n  if (file.userId === userId) {\n    hasAccess = true;\n  }\n\n  if (file.conversationId) {\n    const membership = await findConversationMembership(file.conversationId, userId);\n    hasAccess = hasAccess || Boolean(membership);\n  }\n\n  if (file.folder?.class) {\n    const isTeacher = file.folder.class.teachers.some((t) => t.id === userId);\n    const isStudent = file.folder.class.students.some((s) => s.id === userId);\n    const isSchoolAdmin = isSchoolAdminForClass(file.folder.class, userId);\n    hasAccess = hasAccess || isTeacher || isStudent || isSchoolAdmin;\n  }\n\n  if (!hasAccess) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You do not have access to this file\",\n    });\n  }\n\n  try {\n    const signedUrl = await getSignedUrl(file.path);\n    return { url: signedUrl };\n  } catch (error) {\n    logger.error(\"Error generating signed URL:\", error as Record<string, unknown>);\n    throw new TRPCError({\n      code: \"INTERNAL_SERVER_ERROR\",\n      message: \"Failed to generate download URL\",\n    });\n  }\n}\n\nexport async function moveFile(\n  fileId: string,\n  targetFolderId: string\n) {\n  const file = await findFileWithFolder(fileId);\n  if (!file) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"File not found\",\n    });\n  }\n\n  const targetFolder = await findFolderById(targetFolderId);\n  if (!targetFolder) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Target folder not found\",\n    });\n  }\n\n  return updateFileFolder(fileId, targetFolderId);\n}\n\nexport async function renameFile(\n  fileId: string,\n  newName: string\n) {\n  const file = await findFileWithFolder(fileId);\n  if (!file) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"File not found\",\n    });\n  }\n\n  if (!newName.trim()) {\n    throw new TRPCError({\n      code: \"BAD_REQUEST\",\n      message: \"File name cannot be empty\",\n    });\n  }\n\n  return updateFileName(fileId, newName.trim());\n}\n\nexport async function deleteFileRecord(fileId: string, classId: string) {\n  const file = await findFileWithFolderAndThumbnail(fileId);\n  if (!file) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"File not found\",\n    });\n  }\n\n  if (file.folder?.classId !== classId) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"File does not belong to this class\",\n    });\n  }\n\n  try {\n    if (file.uploadStatus === \"COMPLETED\") {\n      await deleteFile(file.path);\n      if (file.thumbnail) {\n        await deleteFile(file.thumbnail.path);\n      }\n    }\n  } catch (error) {\n    logger.warn(`Failed to delete file ${file.path}:`, error as Record<string, unknown>);\n  }\n\n  await deleteFileById(fileId);\n  return { success: true };\n}\n\n/**\n * Scope-aware move: works for class, school, and personal storage. Source\n * and target must live in the same scope (no cross-scope moves).\n */\nexport async function moveFileScoped(\n  userId: string,\n  input: { fileId: string; targetFolderId: string }\n) {\n  const file = await findFileWithFolder(input.fileId);\n  if (!file?.folderId) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"File not found\" });\n  }\n  const [sourceScope, targetScope] = await Promise.all([\n    resolveFolderScope(file.folderId),\n    resolveFolderScope(input.targetFolderId),\n  ]);\n  if (!sourceScope || !targetScope) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"Folder not found\" });\n  }\n  if (JSON.stringify(sourceScope) !== JSON.stringify(targetScope)) {\n    throw new TRPCError({\n      code: \"BAD_REQUEST\",\n      message: \"Cannot move files between scopes\",\n    });\n  }\n  await requireFolderAccess(userId, file.folderId, \"WRITE\");\n  await requireFolderAccess(userId, input.targetFolderId, \"WRITE\");\n  return updateFileFolder(input.fileId, input.targetFolderId);\n}\n\n/** Scope-aware rename. */\nexport async function renameFileScoped(\n  userId: string,\n  input: { fileId: string; newName: string }\n) {\n  const trimmed = input.newName.trim();\n  if (!trimmed) {\n    throw new TRPCError({\n      code: \"BAD_REQUEST\",\n      message: \"File name cannot be empty\",\n    });\n  }\n  const file = await findFileWithFolder(input.fileId);\n  if (!file) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"File not found\" });\n  }\n  if (file.folderId) {\n    await requireFolderAccess(userId, file.folderId, \"WRITE\");\n  } else if (file.userId !== userId) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You don't own this file\",\n    });\n  }\n  return updateFileName(input.fileId, trimmed);\n}\n\n/**\n * Generic delete that works across class / school / personal storage by\n * deriving permissions from the parent folder's CloudScope (or owning user\n * for unfiled files).\n */\nexport async function deleteFileGeneric(userId: string, fileId: string) {\n  const file = await findFileWithFolderAndThumbnail(fileId);\n  if (!file) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"File not found\" });\n  }\n  if (file.folderId) {\n    await requireFolderAccess(userId, file.folderId, \"WRITE\");\n  } else if (file.userId !== userId) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You don't own this file\",\n    });\n  }\n  try {\n    if (file.uploadStatus === \"COMPLETED\") {\n      await deleteFile(file.path);\n      if (file.thumbnail) {\n        await deleteFile(file.thumbnail.path);\n      }\n    }\n  } catch (error) {\n    logger.warn(\n      `Failed to delete file ${file.path}:`,\n      error as Record<string, unknown>\n    );\n  }\n  await deleteFileById(fileId);\n  return { success: true };\n}\n"],"names":[],"mappings":"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","debug_id":"461807a5-9bef-532d-8edf-7763337de98b"}

package/dist/services/folder.d.ts

@@ -1,40 +1,63 @@
-/** Create a folder in a class. Teacher-only. */
-export declare function createFolderRecord(userId: string, input: {
-    classId: string;
-    name: string;
-    parentFolderId?: string | null;
-    color?: string;
+import { CloudScope } from "../models/cloudStorage.js";
+import { type DirectFileData } from "../lib/fileUpload.js";
+type AccessLevel = "READ" | "WRITE";
+interface AccessResult {
+    scope: CloudScope;
+    canWrite: boolean;
+}
+export declare function requireFolderAccess(userId: string, folderId: string, level: AccessLevel): Promise<AccessResult>;
+/** Browse a folder. Pass `folderId` to drill into a specific folder, or a `scope` to land on its root. */
+export declare function browseFolder(userId: string, input: {
+    folderId: string;
+} | {
+    scope: CloudScope;
 }): Promise<{
-    files: {
-        type: string;
-        name: string;
-        id: string;
-        user: {
+    folder: {
+        files: {
+            path: string;
+            type: string;
+            name: string;
+            id: string;
+            user: {
+                id: string;
+                username: string;
+            } | null;
+            size: number | null;
+            uploadedAt: Date | null;
+        }[];
+        childFolders: {
+            name: string;
+            id: string;
+            color: string | null;
+            _count: {
+                files: number;
+                childFolders: number;
+            };
+        }[];
+        parentFolder: {
+            name: string;
             id: string;
-            username: string;
         } | null;
-        size: number | null;
-        uploadedAt: Date | null;
-    }[];
-    childFolders: {
+    } & {
         name: string;
         id: string;
         color: string | null;
-        _count: {
-            files: number;
-            childFolders: number;
-        };
+        classId: string | null;
+        schoolStorageId: string | null;
+        personalOwnerId: string | null;
+        scope: import(".prisma/client").$Enums.FolderScope;
+        parentFolderId: string | null;
+    };
+    breadcrumbs: {
+        id: string;
+        name: string;
     }[];
-} & {
-    name: string;
-    id: string;
-    color: string | null;
-    classId: string | null;
-    parentFolderId: string | null;
+    canWrite: boolean;
+    scope: CloudScope;
 }>;
-/** Get folder with its contents (subfolders and files). */
-export declare function getFolder(folderId: string): Promise<{
+export declare function getRootFolder(userId: string, scope: CloudScope): Promise<{
     files: {
+        path: string;
         type: string;
         name: string;
         id: string;
@@ -63,10 +86,14 @@ export declare function getFolder(folderId: string): Promise<{
     id: string;
     color: string | null;
     classId: string | null;
+    schoolStorageId: string | null;
+    personalOwnerId: string | null;
+    scope: import(".prisma/client").$Enums.FolderScope;
     parentFolderId: string | null;
 }>;
-export declare function getChildFolders(classId: string): Promise<({
+export declare function getFolder(userId: string, folderId: string): Promise<{
     files: {
+        path: string;
         type: string;
         name: string;
         id: string;
@@ -86,154 +113,103 @@ export declare function getChildFolders(classId: string): Promise<({
             childFolders: number;
         };
     }[];
+    parentFolder: {
+        name: string;
+        id: string;
+    } | null;
 } & {
     name: string;
     id: string;
     color: string | null;
     classId: string | null;
+    schoolStorageId: string | null;
+    personalOwnerId: string | null;
+    scope: import(".prisma/client").$Enums.FolderScope;
     parentFolderId: string | null;
-})[]>;
-export declare function getFolderChildren(folderId: string, classId: string): Promise<({
-    files: {
-        type: string;
-        name: string;
-        id: string;
-        user: {
-            id: string;
-            username: string;
-        } | null;
-        size: number | null;
-        uploadedAt: Date | null;
-    }[];
-    childFolders: {
-        name: string;
-        id: string;
-        color: string | null;
-        _count: {
-            files: number;
-            childFolders: number;
-        };
-    }[];
-} & {
+}>;
+export declare function getFolderBreadcrumbs(userId: string, folderId: string): Promise<{
+    id: string;
+    name: string;
+}[]>;
+export declare function getFolderParents(userId: string, folderId: string): Promise<({
     name: string;
     id: string;
     color: string | null;
     classId: string | null;
+    schoolStorageId: string | null;
+    personalOwnerId: string | null;
+    scope: import(".prisma/client").$Enums.FolderScope;
     parentFolderId: string | null;
-})[]>;
-export declare function getRootFolder(classId: string): Promise<{
-    files: {
-        type: string;
-        name: string;
-        id: string;
-        user: {
-            id: string;
-            username: string;
-        } | null;
-        size: number | null;
-        uploadedAt: Date | null;
-    }[];
-    childFolders: {
-        name: string;
-        id: string;
-        color: string | null;
-        _count: {
-            files: number;
-            childFolders: number;
-        };
-        files: {
-            id: string;
-        }[];
-        childFolders: {
-            id: string;
-        }[];
-    }[];
-} & {
+} | null)[]>;
+export declare function createFolderRecord(userId: string, input: {
+    name: string;
+    parentFolderId?: string | null;
+    color?: string;
+    scope?: CloudScope;
+}): Promise<{
     name: string;
     id: string;
     color: string | null;
     classId: string | null;
+    schoolStorageId: string | null;
+    personalOwnerId: string | null;
+    scope: import(".prisma/client").$Enums.FolderScope;
     parentFolderId: string | null;
 }>;
-export declare function uploadFilesToFolder(userId: string, classId: string, folderId: string, files: {
-    name: string;
-    type: string;
-    size: number;
-}[]): Promise<{
-    success: boolean;
-    uploadedCount: number;
-}>;
-export declare function deleteFolderRecord(userId: string, classId: string, folderId: string): Promise<{
-    success: boolean;
-    deletedFiles: number;
-    deletedFolders: number;
-}>;
-export declare function moveFolder(userId: string, folderId: string, targetParentFolderId: string, classId: string): Promise<{
-    files: {
-        type: string;
-        name: string;
-        id: string;
-        user: {
-            id: string;
-            username: string;
-        } | null;
-        size: number | null;
-        uploadedAt: Date | null;
-    }[];
-    childFolders: {
-        name: string;
-        id: string;
-        color: string | null;
-        _count: {
-            files: number;
-            childFolders: number;
-        };
-    }[];
-} & {
+export declare function updateFolderRecord(userId: string, input: {
+    folderId: string;
+    name?: string;
+    color?: string;
+}): Promise<{
     name: string;
     id: string;
     color: string | null;
     classId: string | null;
+    schoolStorageId: string | null;
+    personalOwnerId: string | null;
+    scope: import(".prisma/client").$Enums.FolderScope;
     parentFolderId: string | null;
 }>;
-export declare function updateFolderRecord(folderId: string, name: string, color: string | undefined, classId: string): Promise<{
-    files: {
-        type: string;
-        name: string;
+export declare function deleteFolder(userId: string, folderId: string): Promise<{
+    success: boolean;
+}>;
+export declare function moveFolder(userId: string, input: {
+    folderId: string;
+    targetParentFolderId: string;
+}): Promise<{
+    success: boolean;
+}>;
+export declare function getFolderUploadUrls(userId: string, input: {
+    folderId: string;
+    files: DirectFileData[];
+}): Promise<import("../lib/fileUpload.js").DirectUploadFile[]>;
+export declare function confirmFolderUpload(_userId: string, input: {
+    fileId: string;
+    uploadSuccess: boolean;
+    errorMessage?: string;
+}): Promise<{
+    success: boolean;
+}>;
+/** What scopes can this user pick from in cloud-storage UIs? */
+export declare function listUserScopes(userId: string): Promise<{
+    personal: {
+        kind: "PERSONAL";
+        userId: string;
+    };
+    schools: {
         id: string;
-        user: {
-            id: string;
-            username: string;
-        } | null;
-        size: number | null;
-        uploadedAt: Date | null;
+        name: string;
+        logoId: string | null;
+        role: import(".prisma/client").$Enums.SchoolMembershipRole;
     }[];
-    childFolders: {
+    classes: {
         name: string;
         id: string;
+        schoolId: string | null;
+        subject: string;
         color: string | null;
-        _count: {
-            files: number;
-            childFolders: number;
-        };
+        section: string;
     }[];
-} & {
-    name: string;
-    id: string;
-    color: string | null;
-    classId: string | null;
-    parentFolderId: string | null;
 }>;
-export declare function getFolderParents(folderId: string): Promise<({
-    name: string;
-    id: string;
-    color: string | null;
-    classId: string | null;
-    parentFolderId: string | null;
-} | null)[]>;
-export declare function getFolderUploadUrls(userId: string, classId: string, folderId: string, files: {
-    name: string;
-    type: string;
-    size: number;
-}[]): Promise<import("../lib/fileUpload.js").DirectUploadFile[]>;
+export {};
 //# sourceMappingURL=folder.d.ts.map

package/dist/services/folder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"folder.d.ts","sourceRoot":"/","sources":["services/folder.ts"],"names":[],"mappings":"AAoBA,gDAAgD;AAChD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IACL,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BF;AAED,2DAA2D;AAC3D,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAS/C;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;MAGpD;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;MAExE;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAUlD;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE;;;GAuBtD;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM;;;;GA2CjB;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,oBAAoB,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDhB;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqBhB;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM;;;;;;aAYtD;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,8DAwCtD"}
+{"version":3,"file":"folder.d.ts","sourceRoot":"/","sources":["services/folder.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,UAAU,EASX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,sBAAsB,CAAC;AAE9B,KAAK,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpC,UAAU,YAAY;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAoFD,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,WAAW,yBAOnB;AAcD,0GAA0G;AAC1G,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCpD;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAGpE;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAG/D;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;;;KAG1E;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;;;;;;;;;aAQtE;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IACL,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;;;;;;;;;GAqBF;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;GAkB3D;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;;GAclE;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE;;GA4C1D;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,cAAc,EAAE,CAAA;CAAE,8DAIrD;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE;;GAWzE;AAED,gEAAgE;AAChE,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;GAwClD"}