@unisource/sdk 0.3.1 → 0.4.0

package/dist/index.d.mts

@@ -31,7 +31,7 @@ declare const uploadR2InitRequestSchema: z.ZodObject<{
   folder_id: z.ZodOptional<z.ZodString>;
   is_main_storage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
-type UploadR2InitRequest = z.infer<typeof uploadR2InitRequestSchema>;
+type UploadR2InitRequest = z.input<typeof uploadR2InitRequestSchema>;
 declare const uploadR2InitResponseSchema: z.ZodObject<{
   upload_id: z.ZodString;
   destination: z.ZodLiteral<"r2">;
@@ -48,7 +48,7 @@ declare const uploadAppwriteInitRequestSchema: z.ZodObject<{
   folder_id: z.ZodOptional<z.ZodString>;
   is_main_storage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
-type UploadAppwriteInitRequest = z.infer<typeof uploadAppwriteInitRequestSchema>;
+type UploadAppwriteInitRequest = z.input<typeof uploadAppwriteInitRequestSchema>;
 declare const uploadAppwriteInitResponseSchema: z.ZodObject<{
   upload_id: z.ZodString;
   destination: z.ZodLiteral<"appwrite">;
@@ -57,13 +57,14 @@ declare const uploadAppwriteInitResponseSchema: z.ZodObject<{
   appwrite_bucket_id: z.ZodString;
   file_id: z.ZodString;
   expires_at: z.ZodNumber;
+  jwt: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type UploadAppwriteInitResponse = z.infer<typeof uploadAppwriteInitResponseSchema>;
 declare const uploadLifecycleRequestSchema: z.ZodObject<{
   upload_id: z.ZodString;
   is_main_storage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
-type UploadLifecycleRequest = z.infer<typeof uploadLifecycleRequestSchema>;
+type UploadLifecycleRequest = z.input<typeof uploadLifecycleRequestSchema>;
 declare const uploadCompleteResponseSchema: z.ZodObject<{
   success: z.ZodLiteral<true>;
   upload_id: z.ZodString;
@@ -76,6 +77,79 @@ declare const uploadFailResponseSchema: z.ZodObject<{
   status: z.ZodLiteral<"failed">;
 }, z.core.$strip>;
 type UploadFailResponse = z.infer<typeof uploadFailResponseSchema>;
+declare const multipartCreateRequestSchema: z.ZodObject<{
+  filename: z.ZodString;
+  size: z.ZodNumber;
+  mime_type: z.ZodString;
+  folder_id: z.ZodOptional<z.ZodString>;
+  is_main_storage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+type MultipartCreateRequest = z.input<typeof multipartCreateRequestSchema>;
+declare const multipartCreateResponseSchema: z.ZodObject<{
+  upload_id: z.ZodString;
+  r2_upload_id: z.ZodString;
+  key: z.ZodString;
+  bucket: z.ZodString;
+  expires_at: z.ZodNumber;
+}, z.core.$strip>;
+type MultipartCreateResponse = z.infer<typeof multipartCreateResponseSchema>;
+declare const multipartSignPartQuerySchema: z.ZodObject<{
+  upload_id: z.ZodString;
+  part_number: z.ZodCoercedNumber<unknown>;
+}, z.core.$strip>;
+type MultipartSignPartQuery = z.input<typeof multipartSignPartQuerySchema>;
+declare const multipartSignPartResponseSchema: z.ZodObject<{
+  url: z.ZodString;
+  expires_at: z.ZodNumber;
+}, z.core.$strip>;
+type MultipartSignPartResponse = z.infer<typeof multipartSignPartResponseSchema>;
+declare const multipartListPartsQuerySchema: z.ZodObject<{
+  upload_id: z.ZodString;
+}, z.core.$strip>;
+type MultipartListPartsQuery = z.input<typeof multipartListPartsQuerySchema>;
+declare const multipartPartSchema: z.ZodObject<{
+  PartNumber: z.ZodNumber;
+  ETag: z.ZodString;
+  Size: z.ZodNumber;
+}, z.core.$strip>;
+type MultipartPart = z.infer<typeof multipartPartSchema>;
+declare const multipartListPartsResponseSchema: z.ZodObject<{
+  parts: z.ZodArray<z.ZodObject<{
+    PartNumber: z.ZodNumber;
+    ETag: z.ZodString;
+    Size: z.ZodNumber;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type MultipartListPartsResponse = z.infer<typeof multipartListPartsResponseSchema>;
+declare const multipartCompleteRequestSchema: z.ZodObject<{
+  upload_id: z.ZodString;
+  parts: z.ZodArray<z.ZodObject<{
+    PartNumber: z.ZodNumber;
+    ETag: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type MultipartCompleteRequest = z.input<typeof multipartCompleteRequestSchema>;
+declare const multipartCompleteResponseSchema: z.ZodObject<{
+  success: z.ZodLiteral<true>;
+  upload_id: z.ZodString;
+  status: z.ZodLiteral<"completed">;
+}, z.core.$strip>;
+type MultipartCompleteResponse = z.infer<typeof multipartCompleteResponseSchema>;
+declare const multipartAbortRequestSchema: z.ZodObject<{
+  upload_id: z.ZodString;
+}, z.core.$strip>;
+type MultipartAbortRequest = z.input<typeof multipartAbortRequestSchema>;
+declare const multipartAbortResponseSchema: z.ZodObject<{
+  success: z.ZodLiteral<true>;
+  upload_id: z.ZodString;
+  status: z.ZodLiteral<"failed">;
+}, z.core.$strip>;
+type MultipartAbortResponse = z.infer<typeof multipartAbortResponseSchema>;
+declare const uploadTypeSchema: z.ZodEnum<{
+  multipart: "multipart";
+  single: "single";
+}>;
+type UploadType = z.infer<typeof uploadTypeSchema>;
 /** Raw upload record — returned by admin `/files` endpoints. */
 declare const uploadRecordSchema: z.ZodObject<{
   id: z.ZodString;
@@ -93,6 +167,10 @@ declare const uploadRecordSchema: z.ZodObject<{
     failed: "failed";
     pending: "pending";
   }>;
+  upload_type: z.ZodOptional<z.ZodEnum<{
+    multipart: "multipart";
+    single: "single";
+  }>>;
   expires_at: z.ZodNumber;
   created_at: z.ZodNumber;
   updated_at: z.ZodNumber;
@@ -115,6 +193,10 @@ declare const uploadsListResponseSchema: z.ZodObject<{
       failed: "failed";
       pending: "pending";
     }>;
+    upload_type: z.ZodOptional<z.ZodEnum<{
+      multipart: "multipart";
+      single: "single";
+    }>>;
     expires_at: z.ZodNumber;
     created_at: z.ZodNumber;
     updated_at: z.ZodNumber;
@@ -140,6 +222,10 @@ declare const uploadRecordDetailResponseSchema: z.ZodObject<{
       failed: "failed";
       pending: "pending";
     }>;
+    upload_type: z.ZodOptional<z.ZodEnum<{
+      multipart: "multipart";
+      single: "single";
+    }>>;
     expires_at: z.ZodNumber;
     created_at: z.ZodNumber;
     updated_at: z.ZodNumber;
@@ -389,6 +475,10 @@ declare const serviceSchema: z.ZodObject<{
   max_storage_bytes: z.ZodNumber;
   current_used_bytes: z.ZodNumber;
   max_file_size_bytes: z.ZodNumber;
+  recommended_upload_destination: z.ZodOptional<z.ZodEnum<{
+    appwrite: "appwrite";
+    r2: "r2";
+  }>>;
   created_at: z.ZodNumber;
 }, z.core.$strip>;
 type Service = z.infer<typeof serviceSchema>;
@@ -399,6 +489,10 @@ declare const serviceDetailResponseSchema: z.ZodObject<{
     max_storage_bytes: z.ZodNumber;
     current_used_bytes: z.ZodNumber;
     max_file_size_bytes: z.ZodNumber;
+    recommended_upload_destination: z.ZodOptional<z.ZodEnum<{
+      appwrite: "appwrite";
+      r2: "r2";
+    }>>;
     created_at: z.ZodNumber;
   }, z.core.$strip>;
 }, z.core.$strip>;
@@ -415,10 +509,41 @@ declare const adminServiceUpdateResponseSchema: z.ZodObject<{
     max_storage_bytes: z.ZodNumber;
     current_used_bytes: z.ZodNumber;
     max_file_size_bytes: z.ZodNumber;
+    recommended_upload_destination: z.ZodOptional<z.ZodEnum<{
+      appwrite: "appwrite";
+      r2: "r2";
+    }>>;
     created_at: z.ZodNumber;
   }, z.core.$strip>;
 }, z.core.$strip>;
 type AdminServiceUpdateResponse = z.infer<typeof adminServiceUpdateResponseSchema>;
+/**
+ * Separate settings endpoint driven by the Split-Button upload UI. Clients
+ * can flip the recommended default upload destination per service without
+ * disturbing quota-related fields.
+ */
+declare const adminServiceSettingsRequestSchema: z.ZodObject<{
+  recommended_upload_destination: z.ZodOptional<z.ZodEnum<{
+    appwrite: "appwrite";
+    r2: "r2";
+  }>>;
+}, z.core.$strip>;
+type AdminServiceSettingsRequest = z.infer<typeof adminServiceSettingsRequestSchema>;
+declare const adminServiceSettingsResponseSchema: z.ZodObject<{
+  service: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    max_storage_bytes: z.ZodNumber;
+    current_used_bytes: z.ZodNumber;
+    max_file_size_bytes: z.ZodNumber;
+    recommended_upload_destination: z.ZodOptional<z.ZodEnum<{
+      appwrite: "appwrite";
+      r2: "r2";
+    }>>;
+    created_at: z.ZodNumber;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+type AdminServiceSettingsResponse = z.infer<typeof adminServiceSettingsResponseSchema>;
 declare const serviceUsageResponseSchema: z.ZodObject<{
   service_id: z.ZodString;
   max_storage_bytes: z.ZodNumber;
@@ -582,6 +707,18 @@ declare const adminUserPasswordResetResponseSchema: z.ZodObject<{
   user_id: z.ZodString;
 }, z.core.$strip>;
 type AdminUserPasswordResetResponse = z.infer<typeof adminUserPasswordResetResponseSchema>;
+declare const adminUserRoleUpdateRequestSchema: z.ZodObject<{
+  role: z.ZodEnum<{
+    admin: "admin";
+    plus: "plus";
+    user: "user";
+  }>;
+}, z.core.$strip>;
+type AdminUserRoleUpdateRequest = z.infer<typeof adminUserRoleUpdateRequestSchema>;
+declare const adminUserStorageLimitUpdateRequestSchema: z.ZodObject<{
+  limit_bytes: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+type AdminUserStorageLimitUpdateRequest = z.infer<typeof adminUserStorageLimitUpdateRequestSchema>;
 //#endregion
 //#region src/mainStorage.d.ts
 declare const mainStorageListQuerySchema: z.ZodObject<{
@@ -932,6 +1069,32 @@ declare const shareLinkDeleteResponseSchema: z.ZodObject<{
   id: z.ZodString;
 }, z.core.$strip>;
 type ShareLinkDeleteResponse = z.infer<typeof shareLinkDeleteResponseSchema>;
+declare const shareLinkDetailResponseSchema: z.ZodObject<{
+  link: z.ZodObject<{
+    id: z.ZodString;
+    service_id: z.ZodString;
+    file_id: z.ZodString;
+    user_id: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodNullable<z.ZodString>;
+    has_password: z.ZodBoolean;
+    expires_at: z.ZodNullable<z.ZodNumber>;
+    download_count: z.ZodNumber;
+    max_downloads: z.ZodNullable<z.ZodNumber>;
+    is_active: z.ZodBoolean;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+type ShareLinkDetailResponse = z.infer<typeof shareLinkDetailResponseSchema>;
+declare const sharesCreateRequestSchema: z.ZodObject<{
+  file_id: z.ZodString;
+  name: z.ZodOptional<z.ZodString>;
+  expires_at: z.ZodOptional<z.ZodNumber>;
+  max_downloads: z.ZodOptional<z.ZodNumber>;
+  password: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type SharesCreateRequest = z.infer<typeof sharesCreateRequestSchema>;
 //#endregion
 //#region src/client.d.ts
 declare class UnisourceError extends Error {
@@ -965,7 +1128,14 @@ declare class UnisourceClient {
     /** Initiate an R2 upload — returns a presigned PUT URL */r2Init: (body: UploadR2InitRequest, signal?: AbortSignal) => Promise<UploadR2InitResponse>; /** Initiate an Appwrite upload — returns credentials for direct SDK upload */
     appwriteInit: (body: UploadAppwriteInitRequest, signal?: AbortSignal) => Promise<UploadAppwriteInitResponse>; /** Confirm that the file was successfully uploaded to storage */
     complete: (body: UploadLifecycleRequest, signal?: AbortSignal) => Promise<UploadCompleteResponse>; /** Mark an upload as failed and release reserved quota */
-    fail: (body: UploadLifecycleRequest, signal?: AbortSignal) => Promise<UploadFailResponse>;
+    fail: (body: UploadLifecycleRequest, signal?: AbortSignal) => Promise<UploadFailResponse>; /** Multipart upload helpers — direct browser → R2 via S3 presigned URLs */
+    multipart: {
+      /** Create a multipart upload — returns UploadId + storage key */create: (body: MultipartCreateRequest, signal?: AbortSignal) => Promise<MultipartCreateResponse>; /** Short-lived presigned PUT URL for a single part */
+      signPart: (uploadId: string, partNumber: number, signal?: AbortSignal) => Promise<MultipartSignPartResponse>; /** List parts already uploaded — feeds Golden Retriever's resume logic */
+      listParts: (uploadId: string, signal?: AbortSignal) => Promise<MultipartListPartsResponse>; /** Finalize the multipart upload. Parts must include PartNumber + ETag. */
+      complete: (body: MultipartCompleteRequest, signal?: AbortSignal) => Promise<MultipartCompleteResponse>; /** Abort the multipart upload and release reserved quota */
+      abort: (uploadId: string, signal?: AbortSignal) => Promise<MultipartAbortResponse>;
+    };
   };
   readonly myFiles: {
     /** List files owned by the authenticated user */list: (query?: FileRecordsListQuery, signal?: AbortSignal, options?: {
@@ -1050,7 +1220,8 @@ declare class UnisourceClient {
   };
   readonly admin: {
     /** Get service info and quota limits */serviceDetail: (signal?: AbortSignal) => Promise<ServiceDetailResponse>; /** Update custom service-wide limits */
-    updateService: (body: AdminServiceUpdateRequest, signal?: AbortSignal) => Promise<AdminServiceUpdateResponse>; /** Get real-time storage usage for the service */
+    updateService: (body: AdminServiceUpdateRequest, signal?: AbortSignal) => Promise<AdminServiceUpdateResponse>; /** Update service-wide settings (e.g. recommended upload destination) */
+    updateServiceSettings: (body: AdminServiceSettingsRequest, signal?: AbortSignal) => Promise<AdminServiceSettingsResponse>; /** Get real-time storage usage for the service */
     usage: (signal?: AbortSignal) => Promise<ServiceUsageResponse>; /** List all uploads (pending/completed/failed) for this service */
     listUploads: (query?: {
       status?: UploadStatus;
@@ -1067,7 +1238,9 @@ declare class UnisourceClient {
       limit?: number;
     }, signal?: AbortSignal) => Promise<AdminUserListResponse>; /** Update Appwrite user properties and service-specific quota/role */
     updateUser: (userId: string, body: AdminUserUpdateRequest, signal?: AbortSignal) => Promise<AdminUserUpdateResponse>; /** Overwrite a user's password and revoke active sessions */
-    resetUserPassword: (userId: string, body: AdminUserPasswordResetRequest, signal?: AbortSignal) => Promise<AdminUserPasswordResetResponse>;
+    resetUserPassword: (userId: string, body: AdminUserPasswordResetRequest, signal?: AbortSignal) => Promise<AdminUserPasswordResetResponse>; /** Update a user's role */
+    updateUserRole: (userId: string, body: AdminUserRoleUpdateRequest, signal?: AbortSignal) => Promise<AdminUserUpdateResponse>; /** Update a user's storage limit */
+    updateUserStorageLimit: (userId: string, body: AdminUserStorageLimitUpdateRequest, signal?: AbortSignal) => Promise<AdminUserUpdateResponse>;
   };
   readonly shareLinks: {
     /** Create a public share link for a file */create: (fileId: string, body: ShareLinkCreateRequest, signal?: AbortSignal) => Promise<ShareLinkCreateResponse>; /** List all share links for a file */
@@ -1075,6 +1248,31 @@ declare class UnisourceClient {
     update: (linkId: string, body: ShareLinkUpdateRequest, signal?: AbortSignal) => Promise<ShareLinkUpdateResponse>; /** Permanently delete a share link */
     delete: (linkId: string, signal?: AbortSignal) => Promise<ShareLinkDeleteResponse>;
   };
+  readonly files: {
+    /** Get a single file record */get: (id: string, signal?: AbortSignal, options?: {
+      asUser?: string;
+    }) => Promise<FileRecordDetailResponse>; /** Rename or update a file */
+    update: (id: string, body: FileUpdateRequest, signal?: AbortSignal, options?: {
+      asUser?: string;
+    }) => Promise<FileUpdateResponse>; /** Soft-delete or permanently delete a file */
+    delete: (id: string, query?: {
+      permanent?: boolean;
+    }, signal?: AbortSignal, options?: {
+      asUser?: string;
+    }) => Promise<FileDeleteResponse>; /** Restore a file from trash */
+    restore: (id: string, signal?: AbortSignal, options?: {
+      asUser?: string;
+    }) => Promise<FileRestoreResponse>; /** Get a time-limited download URL */
+    downloadUrl: (id: string, signal?: AbortSignal, options?: {
+      asUser?: string;
+    }) => Promise<FileDownloadUrlResponse>;
+  };
+  readonly shares: {
+    /** List all share links for the authenticated user */list: (signal?: AbortSignal) => Promise<ShareLinkListResponse>; /** Create a share link (file_id in body) */
+    create: (body: SharesCreateRequest, signal?: AbortSignal) => Promise<ShareLinkCreateResponse>; /** Get a single share link by ID */
+    get: (id: string, signal?: AbortSignal) => Promise<ShareLinkDetailResponse>; /** Delete a share link */
+    delete: (id: string, signal?: AbortSignal) => Promise<ShareLinkDeleteResponse>;
+  };
 }
 //#endregion
-export { type AdminServiceUpdateRequest, type AdminServiceUpdateResponse, type AdminUser, type AdminUserListResponse, type AdminUserPasswordResetRequest, type AdminUserPasswordResetResponse, type AdminUserUpdateRequest, type AdminUserUpdateResponse, type ApiError, type AuditEvent, type AuditEventAction, type AuditLogListQuery, type AuditLogListResponse, FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT, type FileDeleteResponse, type FileDownloadUrlResponse, type FileMoveRequest, type FileRecord, type FileRecordDetailResponse, type FileRecordsListQuery, type FileRecordsListResponse, type FileRestoreResponse, type FileUpdateRequest, type FileUpdateResponse, type Folder, type FolderCreateRequest, type FolderCreateResponse, type FolderDeleteResponse, type FolderDetailResponse, type FolderListQuery, type FolderListResponse, type FolderRestoreResponse, type FolderUpdateRequest, type FolderUpdateResponse, MainStorageDeleteResponse, MainStorageDetailResponse, MainStorageFile, MainStorageListQuery, MainStorageListResponse, MainStorageRenameRequest, MainStorageRenameResponse, MainStorageRestoreResponse, type PublicFileAccessResponse, type PublicFileLockedResponse, type ReleaseDTO, type ReleaseDeleteResponse, type ReleaseSyncManifest, type ReleaseSyncRequest, type ReleaseSyncResponse, type ReleaseSyncResult, type ReleaseUpdateRequest, type ReleaseUploadCompleteRequest, type ReleaseUploadCompleteResponse, type ReleaseUploadFailResponse, type ReleaseUploadInitRequest, type ReleaseUploadInitResponse, type ReleasesListQuery, type ReleasesListResponse, type Service, type ServiceDetailResponse, type ServiceUsageResponse, type ShareLink, type ShareLinkCreateRequest, type ShareLinkCreateResponse, type ShareLinkDeleteResponse, type ShareLinkListResponse, type ShareLinkUpdateRequest, type ShareLinkUpdateResponse, UnisourceClient, type UnisourceClientConfig, UnisourceError, UnisourceNetworkError, type UploadAppwriteInitRequest, type UploadAppwriteInitResponse, type UploadCompleteResponse, type UploadDestination, type UploadFailResponse, type UploadLifecycleRequest, type UploadR2InitRequest, type UploadR2InitResponse, type UploadRecord, type UploadRecordDetailResponse, type UploadStatus, type UploadsListResponse, adminServiceUpdateRequestSchema, adminServiceUpdateResponseSchema, adminUserListResponseSchema, adminUserPasswordResetRequestSchema, adminUserPasswordResetResponseSchema, adminUserSchema, adminUserUpdateRequestSchema, adminUserUpdateResponseSchema, apiErrorSchema, auditEventActionSchema, auditEventSchema, auditLogListQuerySchema, auditLogListResponseSchema, fileDeleteResponseSchema, fileDownloadUrlResponseSchema, fileMoveRequestSchema, fileRecordDetailResponseSchema, fileRecordSchema, fileRecordsListQuerySchema, fileRecordsListResponseSchema, fileRestoreResponseSchema, fileUpdateRequestSchema, fileUpdateResponseSchema, folderCreateRequestSchema, folderCreateResponseSchema, folderDeleteResponseSchema, folderDetailResponseSchema, folderListQuerySchema, folderListResponseSchema, folderRestoreResponseSchema, folderSchema, folderUpdateRequestSchema, folderUpdateResponseSchema, getPublicFileInfo, mainStorageDeleteResponseSchema, mainStorageDetailResponseSchema, mainStorageFileSchema, mainStorageListQuerySchema, mainStorageListResponseSchema, mainStorageRenameRequestSchema, mainStorageRenameResponseSchema, mainStorageRestoreResponseSchema, nonEmptyString, positiveInt, publicFileAccessResponseSchema, publicFileLockedResponseSchema, releaseDTOSchema, releaseDeleteResponseSchema, releaseSyncManifestSchema, releaseSyncRequestSchema, releaseSyncResponseSchema, releaseSyncResultSchema, releaseUpdateRequestSchema, releaseUploadCompleteRequestSchema, releaseUploadCompleteResponseSchema, releaseUploadFailResponseSchema, releaseUploadInitRequestSchema, releaseUploadInitResponseSchema, releasesListQuerySchema, releasesListResponseSchema, serviceDetailResponseSchema, serviceSchema, serviceUsageResponseSchema, shareLinkCreateRequestSchema, shareLinkCreateResponseSchema, shareLinkDeleteResponseSchema, shareLinkListResponseSchema, shareLinkSchema, shareLinkUpdateRequestSchema, shareLinkUpdateResponseSchema, unixTimestamp, unlockPublicFile, uploadAppwriteInitRequestSchema, uploadAppwriteInitResponseSchema, uploadCompleteResponseSchema, uploadDestinationSchema, uploadFailResponseSchema, uploadLifecycleRequestSchema, uploadR2InitRequestSchema, uploadR2InitResponseSchema, uploadRecordDetailResponseSchema, uploadRecordSchema, uploadStatusSchema, uploadsListResponseSchema };
+export { type AdminServiceSettingsRequest, type AdminServiceSettingsResponse, type AdminServiceUpdateRequest, type AdminServiceUpdateResponse, type AdminUser, type AdminUserListResponse, type AdminUserPasswordResetRequest, type AdminUserPasswordResetResponse, type AdminUserRoleUpdateRequest, type AdminUserStorageLimitUpdateRequest, type AdminUserUpdateRequest, type AdminUserUpdateResponse, type ApiError, type AuditEvent, type AuditEventAction, type AuditLogListQuery, type AuditLogListResponse, FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT, type FileDeleteResponse, type FileDownloadUrlResponse, type FileMoveRequest, type FileRecord, type FileRecordDetailResponse, type FileRecordsListQuery, type FileRecordsListResponse, type FileRestoreResponse, type FileUpdateRequest, type FileUpdateResponse, type Folder, type FolderCreateRequest, type FolderCreateResponse, type FolderDeleteResponse, type FolderDetailResponse, type FolderListQuery, type FolderListResponse, type FolderRestoreResponse, type FolderUpdateRequest, type FolderUpdateResponse, MainStorageDeleteResponse, MainStorageDetailResponse, MainStorageFile, MainStorageListQuery, MainStorageListResponse, MainStorageRenameRequest, MainStorageRenameResponse, MainStorageRestoreResponse, type MultipartAbortRequest, type MultipartAbortResponse, type MultipartCompleteRequest, type MultipartCompleteResponse, type MultipartCreateRequest, type MultipartCreateResponse, type MultipartListPartsQuery, type MultipartListPartsResponse, type MultipartPart, type MultipartSignPartQuery, type MultipartSignPartResponse, type PublicFileAccessResponse, type PublicFileLockedResponse, type ReleaseDTO, type ReleaseDeleteResponse, type ReleaseSyncManifest, type ReleaseSyncRequest, type ReleaseSyncResponse, type ReleaseSyncResult, type ReleaseUpdateRequest, type ReleaseUploadCompleteRequest, type ReleaseUploadCompleteResponse, type ReleaseUploadFailResponse, type ReleaseUploadInitRequest, type ReleaseUploadInitResponse, type ReleasesListQuery, type ReleasesListResponse, type Service, type ServiceDetailResponse, type ServiceUsageResponse, type ShareLink, type ShareLinkCreateRequest, type ShareLinkCreateResponse, type ShareLinkDeleteResponse, type ShareLinkDetailResponse, type ShareLinkListResponse, type ShareLinkUpdateRequest, type ShareLinkUpdateResponse, type SharesCreateRequest, UnisourceClient, type UnisourceClientConfig, UnisourceError, UnisourceNetworkError, type UploadAppwriteInitRequest, type UploadAppwriteInitResponse, type UploadCompleteResponse, type UploadDestination, type UploadFailResponse, type UploadLifecycleRequest, type UploadR2InitRequest, type UploadR2InitResponse, type UploadRecord, type UploadRecordDetailResponse, type UploadStatus, type UploadType, type UploadsListResponse, adminServiceSettingsRequestSchema, adminServiceSettingsResponseSchema, adminServiceUpdateRequestSchema, adminServiceUpdateResponseSchema, adminUserListResponseSchema, adminUserPasswordResetRequestSchema, adminUserPasswordResetResponseSchema, adminUserRoleUpdateRequestSchema, adminUserSchema, adminUserStorageLimitUpdateRequestSchema, adminUserUpdateRequestSchema, adminUserUpdateResponseSchema, apiErrorSchema, auditEventActionSchema, auditEventSchema, auditLogListQuerySchema, auditLogListResponseSchema, fileDeleteResponseSchema, fileDownloadUrlResponseSchema, fileMoveRequestSchema, fileRecordDetailResponseSchema, fileRecordSchema, fileRecordsListQuerySchema, fileRecordsListResponseSchema, fileRestoreResponseSchema, fileUpdateRequestSchema, fileUpdateResponseSchema, folderCreateRequestSchema, folderCreateResponseSchema, folderDeleteResponseSchema, folderDetailResponseSchema, folderListQuerySchema, folderListResponseSchema, folderRestoreResponseSchema, folderSchema, folderUpdateRequestSchema, folderUpdateResponseSchema, getPublicFileInfo, mainStorageDeleteResponseSchema, mainStorageDetailResponseSchema, mainStorageFileSchema, mainStorageListQuerySchema, mainStorageListResponseSchema, mainStorageRenameRequestSchema, mainStorageRenameResponseSchema, mainStorageRestoreResponseSchema, multipartAbortRequestSchema, multipartAbortResponseSchema, multipartCompleteRequestSchema, multipartCompleteResponseSchema, multipartCreateRequestSchema, multipartCreateResponseSchema, multipartListPartsQuerySchema, multipartListPartsResponseSchema, multipartPartSchema, multipartSignPartQuerySchema, multipartSignPartResponseSchema, nonEmptyString, positiveInt, publicFileAccessResponseSchema, publicFileLockedResponseSchema, releaseDTOSchema, releaseDeleteResponseSchema, releaseSyncManifestSchema, releaseSyncRequestSchema, releaseSyncResponseSchema, releaseSyncResultSchema, releaseUpdateRequestSchema, releaseUploadCompleteRequestSchema, releaseUploadCompleteResponseSchema, releaseUploadFailResponseSchema, releaseUploadInitRequestSchema, releaseUploadInitResponseSchema, releasesListQuerySchema, releasesListResponseSchema, serviceDetailResponseSchema, serviceSchema, serviceUsageResponseSchema, shareLinkCreateRequestSchema, shareLinkCreateResponseSchema, shareLinkDeleteResponseSchema, shareLinkDetailResponseSchema, shareLinkListResponseSchema, shareLinkSchema, shareLinkUpdateRequestSchema, shareLinkUpdateResponseSchema, sharesCreateRequestSchema, unixTimestamp, unlockPublicFile, uploadAppwriteInitRequestSchema, uploadAppwriteInitResponseSchema, uploadCompleteResponseSchema, uploadDestinationSchema, uploadFailResponseSchema, uploadLifecycleRequestSchema, uploadR2InitRequestSchema, uploadR2InitResponseSchema, uploadRecordDetailResponseSchema, uploadRecordSchema, uploadStatusSchema, uploadTypeSchema, uploadsListResponseSchema };

package/dist/index.mjs

@@ -46,7 +46,8 @@ const uploadAppwriteInitResponseSchema = z.object({
 	appwrite_project_id: nonEmptyString,
 	appwrite_bucket_id: nonEmptyString,
 	file_id: nonEmptyString,
-	expires_at: positiveInt
+	expires_at: positiveInt,
+	jwt: nonEmptyString.optional()
 });
 const uploadLifecycleRequestSchema = z.object({
 	upload_id: nonEmptyString,
@@ -62,6 +63,46 @@ const uploadFailResponseSchema = z.object({
 	upload_id: nonEmptyString,
 	status: z.literal("failed")
 });
+const multipartCreateRequestSchema = z.object({
+	filename: nonEmptyString,
+	size: positiveInt,
+	mime_type: nonEmptyString,
+	folder_id: nonEmptyString.optional(),
+	is_main_storage: z.boolean().optional().default(false)
+});
+const multipartCreateResponseSchema = z.object({
+	upload_id: nonEmptyString,
+	r2_upload_id: nonEmptyString,
+	key: nonEmptyString,
+	bucket: nonEmptyString,
+	expires_at: positiveInt
+});
+const multipartSignPartQuerySchema = z.object({
+	upload_id: nonEmptyString,
+	part_number: z.coerce.number().int().min(1).max(1e4)
+});
+const multipartSignPartResponseSchema = z.object({
+	url: z.string().url(),
+	expires_at: positiveInt
+});
+const multipartListPartsQuerySchema = z.object({ upload_id: nonEmptyString });
+const multipartPartSchema = z.object({
+	PartNumber: z.number().int().min(1).max(1e4),
+	ETag: nonEmptyString,
+	Size: z.number().int().nonnegative()
+});
+const multipartListPartsResponseSchema = z.object({ parts: z.array(multipartPartSchema) });
+const multipartCompleteRequestSchema = z.object({
+	upload_id: nonEmptyString,
+	parts: z.array(z.object({
+		PartNumber: z.number().int().min(1).max(1e4),
+		ETag: nonEmptyString
+	})).min(1)
+});
+const multipartCompleteResponseSchema = uploadCompleteResponseSchema;
+const multipartAbortRequestSchema = z.object({ upload_id: nonEmptyString });
+const multipartAbortResponseSchema = uploadFailResponseSchema;
+const uploadTypeSchema = z.enum(["single", "multipart"]);
 /** Raw upload record — returned by admin `/files` endpoints. */
 const uploadRecordSchema = z.object({
 	id: nonEmptyString,
@@ -72,6 +113,7 @@ const uploadRecordSchema = z.object({
 	mime_type: nonEmptyString,
 	destination: uploadDestinationSchema,
 	status: uploadStatusSchema,
+	upload_type: uploadTypeSchema.optional(),
 	expires_at: positiveInt,
 	created_at: positiveInt,
 	updated_at: positiveInt
@@ -190,6 +232,7 @@ const serviceSchema = z.object({
 	max_storage_bytes: positiveInt,
 	current_used_bytes: z.number().int().nonnegative(),
 	max_file_size_bytes: positiveInt,
+	recommended_upload_destination: uploadDestinationSchema.optional(),
 	created_at: unixTimestamp
 });
 const serviceDetailResponseSchema = z.object({ service: serviceSchema });
@@ -198,6 +241,13 @@ const adminServiceUpdateRequestSchema = z.object({
 	max_file_size_bytes: positiveInt.optional()
 }).refine((v) => v.max_storage_bytes !== void 0 || v.max_file_size_bytes !== void 0, { message: "At least one of max_storage_bytes or max_file_size_bytes must be provided" });
 const adminServiceUpdateResponseSchema = serviceDetailResponseSchema;
+/**
+* Separate settings endpoint driven by the Split-Button upload UI. Clients
+* can flip the recommended default upload destination per service without
+* disturbing quota-related fields.
+*/
+const adminServiceSettingsRequestSchema = z.object({ recommended_upload_destination: uploadDestinationSchema.optional() }).refine((v) => v.recommended_upload_destination !== void 0, { message: "At least one setting must be provided" });
+const adminServiceSettingsResponseSchema = serviceDetailResponseSchema;
 const serviceUsageResponseSchema = z.object({
 	service_id: nonEmptyString,
 	max_storage_bytes: positiveInt,
@@ -283,6 +333,12 @@ const adminUserPasswordResetResponseSchema = z.object({
 	success: z.literal(true),
 	user_id: nonEmptyString
 });
+const adminUserRoleUpdateRequestSchema = z.object({ role: z.enum([
+	"user",
+	"plus",
+	"admin"
+]) });
+const adminUserStorageLimitUpdateRequestSchema = z.object({ limit_bytes: positiveInt.nullable() });
 //#endregion
 //#region src/mainStorage.ts
 const mainStorageListQuerySchema = z.object({
@@ -446,6 +502,14 @@ const shareLinkDeleteResponseSchema = z.object({
 	success: z.literal(true),
 	id: nonEmptyString
 });
+const shareLinkDetailResponseSchema = z.object({ link: shareLinkSchema });
+const sharesCreateRequestSchema = z.object({
+	file_id: nonEmptyString,
+	name: z.string().trim().max(128).optional(),
+	expires_at: positiveInt.optional(),
+	max_downloads: positiveInt.optional(),
+	password: z.string().min(1).optional()
+});
 //#endregion
 //#region src/client.ts
 var UnisourceError = class extends Error {
@@ -543,7 +607,32 @@ var UnisourceClient = class {
 		fail: (body, signal) => apiRequest(this.config, "POST", "/upload/fail", {
 			body,
 			signal
-		})
+		}),
+		multipart: {
+			create: (body, signal) => apiRequest(this.config, "POST", "/upload/r2/multipart/create", {
+				body,
+				signal
+			}),
+			signPart: (uploadId, partNumber, signal) => apiRequest(this.config, "GET", "/upload/r2/multipart/sign-part", {
+				query: {
+					upload_id: uploadId,
+					part_number: partNumber
+				},
+				signal
+			}),
+			listParts: (uploadId, signal) => apiRequest(this.config, "GET", "/upload/r2/multipart/list-parts", {
+				query: { upload_id: uploadId },
+				signal
+			}),
+			complete: (body, signal) => apiRequest(this.config, "POST", "/upload/r2/multipart/complete", {
+				body,
+				signal
+			}),
+			abort: (uploadId, signal) => apiRequest(this.config, "DELETE", "/upload/r2/multipart/abort", {
+				body: { upload_id: uploadId },
+				signal
+			})
+		}
 	};
 	myFiles = {
 		list: (query, signal, options) => apiRequest(this.config, "GET", "/my-files", {
@@ -673,14 +762,18 @@ var UnisourceClient = class {
 			body,
 			signal
 		}),
+		updateServiceSettings: (body, signal) => apiRequest(this.config, "PATCH", "/admin/service/settings", {
+			body,
+			signal
+		}),
 		usage: (signal) => apiRequest(this.config, "GET", "/admin/service/usage", { signal }),
-		listUploads: (query, signal) => apiRequest(this.config, "GET", "/files", {
+		listUploads: (query, signal) => apiRequest(this.config, "GET", "/admin/files", {
 			query,
 			signal
 		}),
-		getUpload: (id, signal) => apiRequest(this.config, "GET", `/files/${id}`, { signal }),
-		downloadUploadUrl: (id, signal) => apiRequest(this.config, "GET", `/files/${id}/download-url`, { signal }),
-		deleteUpload: (id, signal) => apiRequest(this.config, "DELETE", `/files/${id}`, { signal }),
+		getUpload: (id, signal) => apiRequest(this.config, "GET", `/admin/files/${id}`, { signal }),
+		downloadUploadUrl: (id, signal) => apiRequest(this.config, "GET", `/admin/files/${id}/download-url`, { signal }),
+		deleteUpload: (id, signal) => apiRequest(this.config, "DELETE", `/admin/files/${id}`, { signal }),
 		auditLog: (query, signal) => apiRequest(this.config, "GET", "/admin/audit-log", {
 			query,
 			signal
@@ -696,6 +789,14 @@ var UnisourceClient = class {
 		resetUserPassword: (userId, body, signal) => apiRequest(this.config, "POST", `/admin/users/${userId}/password`, {
 			body,
 			signal
+		}),
+		updateUserRole: (userId, body, signal) => apiRequest(this.config, "PATCH", `/admin/users/${userId}/role`, {
+			body,
+			signal
+		}),
+		updateUserStorageLimit: (userId, body, signal) => apiRequest(this.config, "PATCH", `/admin/users/${userId}/storage-limit`, {
+			body,
+			signal
 		})
 	};
 	shareLinks = {
@@ -710,6 +811,39 @@ var UnisourceClient = class {
 		}),
 		delete: (linkId, signal) => apiRequest(this.config, "DELETE", `/share-links/${linkId}`, { signal })
 	};
+	files = {
+		get: (id, signal, options) => apiRequest(this.config, "GET", `/files/${id}`, {
+			signal,
+			extraHeaders: this.withAsUser(options)
+		}),
+		update: (id, body, signal, options) => apiRequest(this.config, "PATCH", `/files/${id}`, {
+			body,
+			signal,
+			extraHeaders: this.withAsUser(options)
+		}),
+		delete: (id, query, signal, options) => apiRequest(this.config, "DELETE", `/files/${id}`, {
+			query,
+			signal,
+			extraHeaders: this.withAsUser(options)
+		}),
+		restore: (id, signal, options) => apiRequest(this.config, "POST", `/files/${id}/restore`, {
+			signal,
+			extraHeaders: this.withAsUser(options)
+		}),
+		downloadUrl: (id, signal, options) => apiRequest(this.config, "GET", `/files/${id}/download-url`, {
+			signal,
+			extraHeaders: this.withAsUser(options)
+		})
+	};
+	shares = {
+		list: (signal) => apiRequest(this.config, "GET", "/shares", { signal }),
+		create: (body, signal) => apiRequest(this.config, "POST", "/shares", {
+			body,
+			signal
+		}),
+		get: (id, signal) => apiRequest(this.config, "GET", `/shares/${id}`, { signal }),
+		delete: (id, signal) => apiRequest(this.config, "DELETE", `/shares/${id}`, { signal })
+	};
 };
 //#endregion
-export { FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT, UnisourceClient, UnisourceError, UnisourceNetworkError, adminServiceUpdateRequestSchema, adminServiceUpdateResponseSchema, adminUserListResponseSchema, adminUserPasswordResetRequestSchema, adminUserPasswordResetResponseSchema, adminUserSchema, adminUserUpdateRequestSchema, adminUserUpdateResponseSchema, apiErrorSchema, auditEventActionSchema, auditEventSchema, auditLogListQuerySchema, auditLogListResponseSchema, fileDeleteResponseSchema, fileDownloadUrlResponseSchema, fileMoveRequestSchema, fileRecordDetailResponseSchema, fileRecordSchema, fileRecordsListQuerySchema, fileRecordsListResponseSchema, fileRestoreResponseSchema, fileUpdateRequestSchema, fileUpdateResponseSchema, folderCreateRequestSchema, folderCreateResponseSchema, folderDeleteResponseSchema, folderDetailResponseSchema, folderListQuerySchema, folderListResponseSchema, folderRestoreResponseSchema, folderSchema, folderUpdateRequestSchema, folderUpdateResponseSchema, getPublicFileInfo, mainStorageDeleteResponseSchema, mainStorageDetailResponseSchema, mainStorageFileSchema, mainStorageListQuerySchema, mainStorageListResponseSchema, mainStorageRenameRequestSchema, mainStorageRenameResponseSchema, mainStorageRestoreResponseSchema, nonEmptyString, positiveInt, publicFileAccessResponseSchema, publicFileLockedResponseSchema, releaseDTOSchema, releaseDeleteResponseSchema, releaseSyncManifestSchema, releaseSyncRequestSchema, releaseSyncResponseSchema, releaseSyncResultSchema, releaseUpdateRequestSchema, releaseUploadCompleteRequestSchema, releaseUploadCompleteResponseSchema, releaseUploadFailResponseSchema, releaseUploadInitRequestSchema, releaseUploadInitResponseSchema, releasesListQuerySchema, releasesListResponseSchema, serviceDetailResponseSchema, serviceSchema, serviceUsageResponseSchema, shareLinkCreateRequestSchema, shareLinkCreateResponseSchema, shareLinkDeleteResponseSchema, shareLinkListResponseSchema, shareLinkSchema, shareLinkUpdateRequestSchema, shareLinkUpdateResponseSchema, unixTimestamp, unlockPublicFile, uploadAppwriteInitRequestSchema, uploadAppwriteInitResponseSchema, uploadCompleteResponseSchema, uploadDestinationSchema, uploadFailResponseSchema, uploadLifecycleRequestSchema, uploadR2InitRequestSchema, uploadR2InitResponseSchema, uploadRecordDetailResponseSchema, uploadRecordSchema, uploadStatusSchema, uploadsListResponseSchema };
+export { FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT, UnisourceClient, UnisourceError, UnisourceNetworkError, adminServiceSettingsRequestSchema, adminServiceSettingsResponseSchema, adminServiceUpdateRequestSchema, adminServiceUpdateResponseSchema, adminUserListResponseSchema, adminUserPasswordResetRequestSchema, adminUserPasswordResetResponseSchema, adminUserRoleUpdateRequestSchema, adminUserSchema, adminUserStorageLimitUpdateRequestSchema, adminUserUpdateRequestSchema, adminUserUpdateResponseSchema, apiErrorSchema, auditEventActionSchema, auditEventSchema, auditLogListQuerySchema, auditLogListResponseSchema, fileDeleteResponseSchema, fileDownloadUrlResponseSchema, fileMoveRequestSchema, fileRecordDetailResponseSchema, fileRecordSchema, fileRecordsListQuerySchema, fileRecordsListResponseSchema, fileRestoreResponseSchema, fileUpdateRequestSchema, fileUpdateResponseSchema, folderCreateRequestSchema, folderCreateResponseSchema, folderDeleteResponseSchema, folderDetailResponseSchema, folderListQuerySchema, folderListResponseSchema, folderRestoreResponseSchema, folderSchema, folderUpdateRequestSchema, folderUpdateResponseSchema, getPublicFileInfo, mainStorageDeleteResponseSchema, mainStorageDetailResponseSchema, mainStorageFileSchema, mainStorageListQuerySchema, mainStorageListResponseSchema, mainStorageRenameRequestSchema, mainStorageRenameResponseSchema, mainStorageRestoreResponseSchema, multipartAbortRequestSchema, multipartAbortResponseSchema, multipartCompleteRequestSchema, multipartCompleteResponseSchema, multipartCreateRequestSchema, multipartCreateResponseSchema, multipartListPartsQuerySchema, multipartListPartsResponseSchema, multipartPartSchema, multipartSignPartQuerySchema, multipartSignPartResponseSchema, nonEmptyString, positiveInt, publicFileAccessResponseSchema, publicFileLockedResponseSchema, releaseDTOSchema, releaseDeleteResponseSchema, releaseSyncManifestSchema, releaseSyncRequestSchema, releaseSyncResponseSchema, releaseSyncResultSchema, releaseUpdateRequestSchema, releaseUploadCompleteRequestSchema, releaseUploadCompleteResponseSchema, releaseUploadFailResponseSchema, releaseUploadInitRequestSchema, releaseUploadInitResponseSchema, releasesListQuerySchema, releasesListResponseSchema, serviceDetailResponseSchema, serviceSchema, serviceUsageResponseSchema, shareLinkCreateRequestSchema, shareLinkCreateResponseSchema, shareLinkDeleteResponseSchema, shareLinkDetailResponseSchema, shareLinkListResponseSchema, shareLinkSchema, shareLinkUpdateRequestSchema, shareLinkUpdateResponseSchema, sharesCreateRequestSchema, unixTimestamp, unlockPublicFile, uploadAppwriteInitRequestSchema, uploadAppwriteInitResponseSchema, uploadCompleteResponseSchema, uploadDestinationSchema, uploadFailResponseSchema, uploadLifecycleRequestSchema, uploadR2InitRequestSchema, uploadR2InitResponseSchema, uploadRecordDetailResponseSchema, uploadRecordSchema, uploadStatusSchema, uploadTypeSchema, uploadsListResponseSchema };

package/package.json

@@ -2,7 +2,7 @@
   "name": "@unisource/sdk",
   "private": false,
   "type": "module",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Wspolne kontrakty danych dla backendu i frontendu UniSource.",
   "license": "MIT",
   "publishConfig": {

package/src/client.ts

@@ -9,6 +9,13 @@ import type {
   UploadFailResponse,
   UploadsListResponse,
   UploadRecordDetailResponse,
+  MultipartCreateRequest,
+  MultipartCreateResponse,
+  MultipartSignPartResponse,
+  MultipartListPartsResponse,
+  MultipartCompleteRequest,
+  MultipartCompleteResponse,
+  MultipartAbortResponse,
 } from './uploads';
 import type {
   FileRecord,
@@ -38,6 +45,8 @@ import type {
   ServiceUsageResponse,
   AdminServiceUpdateRequest,
   AdminServiceUpdateResponse,
+  AdminServiceSettingsRequest,
+  AdminServiceSettingsResponse,
   AuditLogListQuery,
   AuditLogListResponse,
   AdminUserListResponse,
@@ -45,11 +54,15 @@ import type {
   AdminUserUpdateResponse,
   AdminUserPasswordResetRequest,
   AdminUserPasswordResetResponse,
+  AdminUserRoleUpdateRequest,
+  AdminUserStorageLimitUpdateRequest,
 } from './services';
 import type {
   ShareLinkCreateRequest,
   ShareLinkCreateResponse,
   ShareLinkListResponse,
+  ShareLinkDetailResponse,
+  SharesCreateRequest,
   PublicFileAccessResponse,
   PublicFileLockedResponse,
   ShareLinkUpdateRequest,
@@ -244,6 +257,38 @@ export class UnisourceClient {
     /** Mark an upload as failed and release reserved quota */
     fail: (body: UploadLifecycleRequest, signal?: AbortSignal): Promise<UploadFailResponse> =>
       apiRequest(this.config, 'POST', '/upload/fail', { body, signal }),
+
+    /** Multipart upload helpers — direct browser → R2 via S3 presigned URLs */
+    multipart: {
+      /** Create a multipart upload — returns UploadId + storage key */
+      create: (body: MultipartCreateRequest, signal?: AbortSignal): Promise<MultipartCreateResponse> =>
+        apiRequest(this.config, 'POST', '/upload/r2/multipart/create', { body, signal }),
+
+      /** Short-lived presigned PUT URL for a single part */
+      signPart: (uploadId: string, partNumber: number, signal?: AbortSignal): Promise<MultipartSignPartResponse> =>
+        apiRequest(this.config, 'GET', '/upload/r2/multipart/sign-part', {
+          query: { upload_id: uploadId, part_number: partNumber },
+          signal,
+        }),
+
+      /** List parts already uploaded — feeds Golden Retriever's resume logic */
+      listParts: (uploadId: string, signal?: AbortSignal): Promise<MultipartListPartsResponse> =>
+        apiRequest(this.config, 'GET', '/upload/r2/multipart/list-parts', {
+          query: { upload_id: uploadId },
+          signal,
+        }),
+
+      /** Finalize the multipart upload. Parts must include PartNumber + ETag. */
+      complete: (body: MultipartCompleteRequest, signal?: AbortSignal): Promise<MultipartCompleteResponse> =>
+        apiRequest(this.config, 'POST', '/upload/r2/multipart/complete', { body, signal }),
+
+      /** Abort the multipart upload and release reserved quota */
+      abort: (uploadId: string, signal?: AbortSignal): Promise<MultipartAbortResponse> =>
+        apiRequest(this.config, 'DELETE', '/upload/r2/multipart/abort', {
+          body: { upload_id: uploadId },
+          signal,
+        }),
+    },
   };
 
   // ─── My Files ─────────────────────────────────────────────────────────────
@@ -405,25 +450,32 @@ export class UnisourceClient {
     updateService: (body: AdminServiceUpdateRequest, signal?: AbortSignal): Promise<AdminServiceUpdateResponse> =>
       apiRequest(this.config, 'PATCH', '/admin/service', { body, signal }),
 
+    /** Update service-wide settings (e.g. recommended upload destination) */
+    updateServiceSettings: (
+      body: AdminServiceSettingsRequest,
+      signal?: AbortSignal
+    ): Promise<AdminServiceSettingsResponse> =>
+      apiRequest(this.config, 'PATCH', '/admin/service/settings', { body, signal }),
+
     /** Get real-time storage usage for the service */
     usage: (signal?: AbortSignal): Promise<ServiceUsageResponse> =>
       apiRequest(this.config, 'GET', '/admin/service/usage', { signal }),
 
     /** List all uploads (pending/completed/failed) for this service */
     listUploads: (query?: { status?: UploadStatus; cursor?: string; limit?: number }, signal?: AbortSignal): Promise<UploadsListResponse> =>
-      apiRequest(this.config, 'GET', '/files', { query, signal }),
+      apiRequest(this.config, 'GET', '/admin/files', { query, signal }),
 
     /** Get a single upload for this service */
     getUpload: (id: string, signal?: AbortSignal): Promise<UploadRecordDetailResponse> =>
-      apiRequest(this.config, 'GET', `/files/${id}`, { signal }),
+      apiRequest(this.config, 'GET', `/admin/files/${id}`, { signal }),
 
     /** Get a time-limited download URL for an upload owned by this service */
     downloadUploadUrl: (id: string, signal?: AbortSignal): Promise<FileDownloadUrlResponse> =>
-      apiRequest(this.config, 'GET', `/files/${id}/download-url`, { signal }),
+      apiRequest(this.config, 'GET', `/admin/files/${id}/download-url`, { signal }),
 
     /** Permanently delete an upload owned by this service */
     deleteUpload: (id: string, signal?: AbortSignal): Promise<FileDeleteResponse> =>
-      apiRequest(this.config, 'DELETE', `/files/${id}`, { signal }),
+      apiRequest(this.config, 'DELETE', `/admin/files/${id}`, { signal }),
 
     /** List audit log events for this service */
     auditLog: (query?: AuditLogListQuery, signal?: AbortSignal): Promise<AuditLogListResponse> =>
@@ -450,9 +502,25 @@ export class UnisourceClient {
       signal?: AbortSignal
     ): Promise<AdminUserPasswordResetResponse> =>
       apiRequest(this.config, 'POST', `/admin/users/${userId}/password`, { body, signal }),
+
+    /** Update a user's role */
+    updateUserRole: (
+      userId: string,
+      body: AdminUserRoleUpdateRequest,
+      signal?: AbortSignal
+    ): Promise<AdminUserUpdateResponse> =>
+      apiRequest(this.config, 'PATCH', `/admin/users/${userId}/role`, { body, signal }),
+
+    /** Update a user's storage limit */
+    updateUserStorageLimit: (
+      userId: string,
+      body: AdminUserStorageLimitUpdateRequest,
+      signal?: AbortSignal
+    ): Promise<AdminUserUpdateResponse> =>
+      apiRequest(this.config, 'PATCH', `/admin/users/${userId}/storage-limit`, { body, signal }),
   };
 
-  // ─── Share Links ──────────────────────────────────────────────────────────────
+  // ─── Share Links (legacy — per-file endpoints) ────────────────────────────────
 
   readonly shareLinks = {
     /** Create a public share link for a file */
@@ -471,4 +539,48 @@ export class UnisourceClient {
     delete: (linkId: string, signal?: AbortSignal): Promise<ShareLinkDeleteResponse> =>
       apiRequest(this.config, 'DELETE', `/share-links/${linkId}`, { signal }),
   };
+
+  // ─── Files (Plan 2 contract — /files/:id) ────────────────────────────────────
+
+  readonly files = {
+    /** Get a single file record */
+    get: (id: string, signal?: AbortSignal, options?: { asUser?: string }): Promise<FileRecordDetailResponse> =>
+      apiRequest(this.config, 'GET', `/files/${id}`, { signal, extraHeaders: this.withAsUser(options) }),
+
+    /** Rename or update a file */
+    update: (id: string, body: FileUpdateRequest, signal?: AbortSignal, options?: { asUser?: string }): Promise<FileUpdateResponse> =>
+      apiRequest(this.config, 'PATCH', `/files/${id}`, { body, signal, extraHeaders: this.withAsUser(options) }),
+
+    /** Soft-delete or permanently delete a file */
+    delete: (id: string, query?: { permanent?: boolean }, signal?: AbortSignal, options?: { asUser?: string }): Promise<FileDeleteResponse> =>
+      apiRequest(this.config, 'DELETE', `/files/${id}`, { query, signal, extraHeaders: this.withAsUser(options) }),
+
+    /** Restore a file from trash */
+    restore: (id: string, signal?: AbortSignal, options?: { asUser?: string }): Promise<FileRestoreResponse> =>
+      apiRequest(this.config, 'POST', `/files/${id}/restore`, { signal, extraHeaders: this.withAsUser(options) }),
+
+    /** Get a time-limited download URL */
+    downloadUrl: (id: string, signal?: AbortSignal, options?: { asUser?: string }): Promise<FileDownloadUrlResponse> =>
+      apiRequest(this.config, 'GET', `/files/${id}/download-url`, { signal, extraHeaders: this.withAsUser(options) }),
+  };
+
+  // ─── Shares (Plan 2 contract — /shares) ──────────────────────────────────────
+
+  readonly shares = {
+    /** List all share links for the authenticated user */
+    list: (signal?: AbortSignal): Promise<ShareLinkListResponse> =>
+      apiRequest(this.config, 'GET', '/shares', { signal }),
+
+    /** Create a share link (file_id in body) */
+    create: (body: SharesCreateRequest, signal?: AbortSignal): Promise<ShareLinkCreateResponse> =>
+      apiRequest(this.config, 'POST', '/shares', { body, signal }),
+
+    /** Get a single share link by ID */
+    get: (id: string, signal?: AbortSignal): Promise<ShareLinkDetailResponse> =>
+      apiRequest(this.config, 'GET', `/shares/${id}`, { signal }),
+
+    /** Delete a share link */
+    delete: (id: string, signal?: AbortSignal): Promise<ShareLinkDeleteResponse> =>
+      apiRequest(this.config, 'DELETE', `/shares/${id}`, { signal }),
+  };
 }

package/src/index.ts

@@ -24,6 +24,18 @@ export {
   uploadRecordSchema,
   uploadsListResponseSchema,
   uploadRecordDetailResponseSchema,
+  uploadTypeSchema,
+  multipartCreateRequestSchema,
+  multipartCreateResponseSchema,
+  multipartSignPartQuerySchema,
+  multipartSignPartResponseSchema,
+  multipartListPartsQuerySchema,
+  multipartListPartsResponseSchema,
+  multipartPartSchema,
+  multipartCompleteRequestSchema,
+  multipartCompleteResponseSchema,
+  multipartAbortRequestSchema,
+  multipartAbortResponseSchema,
 } from './uploads';
 export type {
   UploadR2InitRequest,
@@ -36,6 +48,18 @@ export type {
   UploadRecord,
   UploadsListResponse,
   UploadRecordDetailResponse,
+  UploadType,
+  MultipartCreateRequest,
+  MultipartCreateResponse,
+  MultipartSignPartQuery,
+  MultipartSignPartResponse,
+  MultipartListPartsQuery,
+  MultipartListPartsResponse,
+  MultipartPart,
+  MultipartCompleteRequest,
+  MultipartCompleteResponse,
+  MultipartAbortRequest,
+  MultipartAbortResponse,
 } from './uploads';
 
 // ─── File Records ─────────────────────────────────────────────────────────────
@@ -96,6 +120,8 @@ export {
   serviceDetailResponseSchema,
   adminServiceUpdateRequestSchema,
   adminServiceUpdateResponseSchema,
+  adminServiceSettingsRequestSchema,
+  adminServiceSettingsResponseSchema,
   serviceUsageResponseSchema,
   auditEventActionSchema,
   auditEventSchema,
@@ -107,12 +133,16 @@ export {
   adminUserUpdateResponseSchema,
   adminUserPasswordResetRequestSchema,
   adminUserPasswordResetResponseSchema,
+  adminUserRoleUpdateRequestSchema,
+  adminUserStorageLimitUpdateRequestSchema,
 } from './services';
 export type {
   Service,
   ServiceDetailResponse,
   AdminServiceUpdateRequest,
   AdminServiceUpdateResponse,
+  AdminServiceSettingsRequest,
+  AdminServiceSettingsResponse,
   ServiceUsageResponse,
   AuditEventAction,
   AuditEvent,
@@ -124,6 +154,8 @@ export type {
   AdminUserUpdateResponse,
   AdminUserPasswordResetRequest,
   AdminUserPasswordResetResponse,
+  AdminUserRoleUpdateRequest,
+  AdminUserStorageLimitUpdateRequest,
 } from './services';
 
 // ─── Main Storage ─────────────────────────────────────────────────────────────
@@ -172,6 +204,8 @@ export {
   shareLinkCreateResponseSchema,
   shareLinkUpdateResponseSchema,
   shareLinkDeleteResponseSchema,
+  shareLinkDetailResponseSchema,
+  sharesCreateRequestSchema,
   publicFileAccessResponseSchema,
   publicFileLockedResponseSchema,
 } from './shareLinks';
@@ -183,6 +217,8 @@ export type {
   ShareLinkCreateResponse,
   ShareLinkUpdateResponse,
   ShareLinkDeleteResponse,
+  ShareLinkDetailResponse,
+  SharesCreateRequest,
   PublicFileAccessResponse,
   PublicFileLockedResponse,
 } from './shareLinks';

package/src/services.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { nonEmptyString, positiveInt, unixTimestamp } from './primitives';
+import { nonEmptyString, positiveInt, unixTimestamp, uploadDestinationSchema } from './primitives';
 
 // ─── Service record ───────────────────────────────────────────────────────────
 
@@ -10,6 +10,7 @@ export const serviceSchema = z.object({
   max_storage_bytes: positiveInt,
   current_used_bytes: z.number().int().nonnegative(),
   max_file_size_bytes: positiveInt,
+  recommended_upload_destination: uploadDestinationSchema.optional(),
   created_at: unixTimestamp,
 });
 export type Service = z.infer<typeof serviceSchema>;
@@ -33,6 +34,25 @@ export type AdminServiceUpdateRequest = z.infer<typeof adminServiceUpdateRequest
 export const adminServiceUpdateResponseSchema = serviceDetailResponseSchema;
 export type AdminServiceUpdateResponse = z.infer<typeof adminServiceUpdateResponseSchema>;
 
+// ─── Admin: Service Settings (split from limits) ──────────────────────────────
+
+/**
+ * Separate settings endpoint driven by the Split-Button upload UI. Clients
+ * can flip the recommended default upload destination per service without
+ * disturbing quota-related fields.
+ */
+export const adminServiceSettingsRequestSchema = z
+  .object({
+    recommended_upload_destination: uploadDestinationSchema.optional(),
+  })
+  .refine((v) => v.recommended_upload_destination !== undefined, {
+    message: 'At least one setting must be provided',
+  });
+export type AdminServiceSettingsRequest = z.infer<typeof adminServiceSettingsRequestSchema>;
+
+export const adminServiceSettingsResponseSchema = serviceDetailResponseSchema;
+export type AdminServiceSettingsResponse = z.infer<typeof adminServiceSettingsResponseSchema>;
+
 // ─── Service usage summary ────────────────────────────────────────────────────
 
 export const serviceUsageResponseSchema = z.object({
@@ -135,3 +155,15 @@ export const adminUserPasswordResetResponseSchema = z.object({
   user_id: nonEmptyString,
 });
 export type AdminUserPasswordResetResponse = z.infer<typeof adminUserPasswordResetResponseSchema>;
+
+// ─── Separate role/storage-limit update endpoints ─────────────────────────────
+
+export const adminUserRoleUpdateRequestSchema = z.object({
+  role: z.enum(['user', 'plus', 'admin']),
+});
+export type AdminUserRoleUpdateRequest = z.infer<typeof adminUserRoleUpdateRequestSchema>;
+
+export const adminUserStorageLimitUpdateRequestSchema = z.object({
+  limit_bytes: positiveInt.nullable(),
+});
+export type AdminUserStorageLimitUpdateRequest = z.infer<typeof adminUserStorageLimitUpdateRequestSchema>;

package/src/shareLinks.ts

@@ -91,3 +91,19 @@ export const shareLinkDeleteResponseSchema = z.object({
   id: nonEmptyString,
 });
 export type ShareLinkDeleteResponse = z.infer<typeof shareLinkDeleteResponseSchema>;
+
+// ─── Get single share link ────────────────────────────────────────────────────
+export const shareLinkDetailResponseSchema = z.object({
+  link: shareLinkSchema,
+});
+export type ShareLinkDetailResponse = z.infer<typeof shareLinkDetailResponseSchema>;
+
+// ─── Create via /shares (file_id in body) ────────────────────────────────────
+export const sharesCreateRequestSchema = z.object({
+  file_id: nonEmptyString,
+  name: z.string().trim().max(128).optional(),
+  expires_at: positiveInt.optional(),
+  max_downloads: positiveInt.optional(),
+  password: z.string().min(1).optional(),
+});
+export type SharesCreateRequest = z.infer<typeof sharesCreateRequestSchema>;

package/src/uploads.ts

@@ -10,7 +10,7 @@ export const uploadR2InitRequestSchema = z.object({
   folder_id: nonEmptyString.optional(),
   is_main_storage: z.boolean().optional().default(false),
 });
-export type UploadR2InitRequest = z.infer<typeof uploadR2InitRequestSchema>;
+export type UploadR2InitRequest = z.input<typeof uploadR2InitRequestSchema>;
 
 export const uploadR2InitResponseSchema = z.object({
   upload_id: nonEmptyString,
@@ -31,7 +31,7 @@ export const uploadAppwriteInitRequestSchema = z.object({
   folder_id: nonEmptyString.optional(),
   is_main_storage: z.boolean().optional().default(false),
 });
-export type UploadAppwriteInitRequest = z.infer<typeof uploadAppwriteInitRequestSchema>;
+export type UploadAppwriteInitRequest = z.input<typeof uploadAppwriteInitRequestSchema>;
 
 export const uploadAppwriteInitResponseSchema = z.object({
   upload_id: nonEmptyString,
@@ -41,6 +41,8 @@ export const uploadAppwriteInitResponseSchema = z.object({
   appwrite_bucket_id: nonEmptyString,
   file_id: nonEmptyString,
   expires_at: positiveInt,
+  /** Appwrite JWT to authenticate the client-side SDK upload. Only present for JWT-authenticated requests. */
+  jwt: nonEmptyString.optional(),
 });
 export type UploadAppwriteInitResponse = z.infer<typeof uploadAppwriteInitResponseSchema>;
 
@@ -50,7 +52,7 @@ export const uploadLifecycleRequestSchema = z.object({
   upload_id: nonEmptyString,
   is_main_storage: z.boolean().optional().default(false),
 });
-export type UploadLifecycleRequest = z.infer<typeof uploadLifecycleRequestSchema>;
+export type UploadLifecycleRequest = z.input<typeof uploadLifecycleRequestSchema>;
 
 export const uploadCompleteResponseSchema = z.object({
   success: z.literal(true),
@@ -66,10 +68,97 @@ export const uploadFailResponseSchema = z.object({
 });
 export type UploadFailResponse = z.infer<typeof uploadFailResponseSchema>;
 
+// ─── Multipart: Create ────────────────────────────────────────────────────────
+
+export const multipartCreateRequestSchema = z.object({
+  filename: nonEmptyString,
+  size: positiveInt,
+  mime_type: nonEmptyString,
+  folder_id: nonEmptyString.optional(),
+  is_main_storage: z.boolean().optional().default(false),
+});
+export type MultipartCreateRequest = z.input<typeof multipartCreateRequestSchema>;
+
+export const multipartCreateResponseSchema = z.object({
+  /** Internal UniSource upload record id. */
+  upload_id: nonEmptyString,
+  /** S3 (R2) multipart UploadId — required for every sign/complete/abort call. */
+  r2_upload_id: nonEmptyString,
+  /** R2 object key that the parts are being uploaded to. */
+  key: nonEmptyString,
+  bucket: nonEmptyString,
+  expires_at: positiveInt,
+});
+export type MultipartCreateResponse = z.infer<typeof multipartCreateResponseSchema>;
+
+// ─── Multipart: Sign Part ─────────────────────────────────────────────────────
+
+export const multipartSignPartQuerySchema = z.object({
+  upload_id: nonEmptyString,
+  part_number: z.coerce.number().int().min(1).max(10_000),
+});
+export type MultipartSignPartQuery = z.input<typeof multipartSignPartQuerySchema>;
+
+export const multipartSignPartResponseSchema = z.object({
+  url: z.string().url(),
+  expires_at: positiveInt,
+});
+export type MultipartSignPartResponse = z.infer<typeof multipartSignPartResponseSchema>;
+
+// ─── Multipart: List Parts ────────────────────────────────────────────────────
+
+export const multipartListPartsQuerySchema = z.object({
+  upload_id: nonEmptyString,
+});
+export type MultipartListPartsQuery = z.input<typeof multipartListPartsQuerySchema>;
+
+export const multipartPartSchema = z.object({
+  PartNumber: z.number().int().min(1).max(10_000),
+  ETag: nonEmptyString,
+  Size: z.number().int().nonnegative(),
+});
+export type MultipartPart = z.infer<typeof multipartPartSchema>;
+
+export const multipartListPartsResponseSchema = z.object({
+  parts: z.array(multipartPartSchema),
+});
+export type MultipartListPartsResponse = z.infer<typeof multipartListPartsResponseSchema>;
+
+// ─── Multipart: Complete ──────────────────────────────────────────────────────
+
+export const multipartCompleteRequestSchema = z.object({
+  upload_id: nonEmptyString,
+  parts: z
+    .array(
+      z.object({
+        PartNumber: z.number().int().min(1).max(10_000),
+        ETag: nonEmptyString,
+      })
+    )
+    .min(1),
+});
+export type MultipartCompleteRequest = z.input<typeof multipartCompleteRequestSchema>;
+
+export const multipartCompleteResponseSchema = uploadCompleteResponseSchema;
+export type MultipartCompleteResponse = z.infer<typeof multipartCompleteResponseSchema>;
+
+// ─── Multipart: Abort ─────────────────────────────────────────────────────────
+
+export const multipartAbortRequestSchema = z.object({
+  upload_id: nonEmptyString,
+});
+export type MultipartAbortRequest = z.input<typeof multipartAbortRequestSchema>;
+
+export const multipartAbortResponseSchema = uploadFailResponseSchema;
+export type MultipartAbortResponse = z.infer<typeof multipartAbortResponseSchema>;
+
 // ─── Admin: list uploads ──────────────────────────────────────────────────────
 
 export { FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT };
 
+export const uploadTypeSchema = z.enum(['single', 'multipart']);
+export type UploadType = z.infer<typeof uploadTypeSchema>;
+
 /** Raw upload record — returned by admin `/files` endpoints. */
 export const uploadRecordSchema = z.object({
   id: nonEmptyString,
@@ -80,6 +169,7 @@ export const uploadRecordSchema = z.object({
   mime_type: nonEmptyString,
   destination: uploadDestinationSchema,
   status: uploadStatusSchema,
+  upload_type: uploadTypeSchema.optional(),
   expires_at: positiveInt,
   created_at: positiveInt,
   updated_at: positiveInt,