@unisource/sdk 0.3.2 → 0.6.0

package/dist/index.d.mts

@@ -57,6 +57,7 @@ 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<{
@@ -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;
@@ -748,6 +873,75 @@ declare const releaseUploadFailResponseSchema: z.ZodObject<{
   status: z.ZodLiteral<"failed">;
 }, z.core.$strip>;
 type ReleaseUploadFailResponse = z.infer<typeof releaseUploadFailResponseSchema>;
+declare const releaseMultipartCreateRequestSchema: z.ZodObject<{
+  name: z.ZodString;
+  filename: z.ZodString;
+  mime_type: z.ZodOptional<z.ZodString>;
+  tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+  notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  force_update: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+type ReleaseMultipartCreateRequest = z.input<typeof releaseMultipartCreateRequestSchema>;
+declare const releaseMultipartCreateResponseSchema: 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 ReleaseMultipartCreateResponse = z.infer<typeof releaseMultipartCreateResponseSchema>;
+declare const releaseMultipartSignPartQuerySchema: z.ZodObject<{
+  upload_id: z.ZodString;
+  part_number: z.ZodCoercedNumber<unknown>;
+}, z.core.$strip>;
+type ReleaseMultipartSignPartQuery = z.input<typeof releaseMultipartSignPartQuerySchema>;
+declare const releaseMultipartSignPartResponseSchema: z.ZodObject<{
+  url: z.ZodString;
+  expires_at: z.ZodNumber;
+}, z.core.$strip>;
+type ReleaseMultipartSignPartResponse = z.infer<typeof releaseMultipartSignPartResponseSchema>;
+declare const releaseMultipartListPartsQuerySchema: z.ZodObject<{
+  upload_id: z.ZodString;
+}, z.core.$strip>;
+type ReleaseMultipartListPartsQuery = z.input<typeof releaseMultipartListPartsQuerySchema>;
+declare const releaseMultipartPartSchema: z.ZodObject<{
+  PartNumber: z.ZodNumber;
+  ETag: z.ZodString;
+  Size: z.ZodNumber;
+}, z.core.$strip>;
+type ReleaseMultipartPart = z.infer<typeof releaseMultipartPartSchema>;
+declare const releaseMultipartListPartsResponseSchema: z.ZodObject<{
+  parts: z.ZodArray<z.ZodObject<{
+    PartNumber: z.ZodNumber;
+    ETag: z.ZodString;
+    Size: z.ZodNumber;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type ReleaseMultipartListPartsResponse = z.infer<typeof releaseMultipartListPartsResponseSchema>;
+declare const releaseMultipartCompleteRequestSchema: z.ZodObject<{
+  upload_id: z.ZodString;
+  parts: z.ZodArray<z.ZodObject<{
+    PartNumber: z.ZodNumber;
+    ETag: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type ReleaseMultipartCompleteRequest = z.input<typeof releaseMultipartCompleteRequestSchema>;
+declare const releaseMultipartCompleteResponseSchema: z.ZodObject<{
+  success: z.ZodLiteral<true>;
+  release_id: z.ZodString;
+  status: z.ZodLiteral<"completed">;
+}, z.core.$strip>;
+type ReleaseMultipartCompleteResponse = z.infer<typeof releaseMultipartCompleteResponseSchema>;
+declare const releaseMultipartAbortRequestSchema: z.ZodObject<{
+  upload_id: z.ZodString;
+}, z.core.$strip>;
+type ReleaseMultipartAbortRequest = z.input<typeof releaseMultipartAbortRequestSchema>;
+declare const releaseMultipartAbortResponseSchema: z.ZodObject<{
+  success: z.ZodLiteral<true>;
+  release_id: z.ZodString;
+  status: z.ZodLiteral<"failed">;
+}, z.core.$strip>;
+type ReleaseMultipartAbortResponse = z.infer<typeof releaseMultipartAbortResponseSchema>;
 declare const releasesListQuerySchema: z.ZodObject<{
   limit: z.ZodOptional<z.ZodNumber>;
   cursor: z.ZodOptional<z.ZodString>;
@@ -1003,7 +1197,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?: {
@@ -1077,7 +1278,14 @@ declare class UnisourceClient {
     upload: {
       /** Initiate a release upload — returns a presigned PUT URL */init: (body: ReleaseUploadInitRequest, signal?: AbortSignal) => Promise<ReleaseUploadInitResponse>; /** Confirm that a release object was successfully uploaded */
       complete: (body: ReleaseUploadCompleteRequest, signal?: AbortSignal) => Promise<ReleaseUploadCompleteResponse>; /** Mark a release upload as failed */
-      fail: (releaseId: string, signal?: AbortSignal) => Promise<ReleaseUploadFailResponse>;
+      fail: (releaseId: string, signal?: AbortSignal) => Promise<ReleaseUploadFailResponse>; /** Multipart upload helpers — direct browser → R2 via S3 presigned URLs */
+      multipart: {
+        /** Create a multipart release upload — returns the R2 UploadId + storage key */create: (body: ReleaseMultipartCreateRequest, signal?: AbortSignal) => Promise<ReleaseMultipartCreateResponse>; /** Short-lived presigned PUT URL for a single part */
+        signPart: (uploadId: string, partNumber: number, signal?: AbortSignal) => Promise<ReleaseMultipartSignPartResponse>; /** List parts already uploaded — feeds Golden Retriever's resume logic */
+        listParts: (uploadId: string, signal?: AbortSignal) => Promise<ReleaseMultipartListPartsResponse>; /** Finalize the multipart upload — backend reads object size from R2 (no client size). */
+        complete: (body: ReleaseMultipartCompleteRequest, signal?: AbortSignal) => Promise<ReleaseMultipartCompleteResponse>; /** Abort an in-flight multipart upload and mark the release as failed */
+        abort: (uploadId: string, signal?: AbortSignal) => Promise<ReleaseMultipartAbortResponse>;
+      };
     }; /** List releases for the configured service */
     list: (query?: ReleasesListQuery, signal?: AbortSignal) => Promise<ReleasesListResponse>; /** Get a single release */
     get: (releaseId: string, signal?: AbortSignal) => Promise<ReleaseDTO>; /** Get the latest completed release */
@@ -1088,7 +1296,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;
@@ -1142,4 +1351,4 @@ declare class UnisourceClient {
   };
 }
 //#endregion
-export { 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 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 UploadsListResponse, 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, 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, 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 ReleaseMultipartAbortRequest, type ReleaseMultipartAbortResponse, type ReleaseMultipartCompleteRequest, type ReleaseMultipartCompleteResponse, type ReleaseMultipartCreateRequest, type ReleaseMultipartCreateResponse, type ReleaseMultipartListPartsQuery, type ReleaseMultipartListPartsResponse, type ReleaseMultipartPart, type ReleaseMultipartSignPartQuery, type ReleaseMultipartSignPartResponse, 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, releaseMultipartAbortRequestSchema, releaseMultipartAbortResponseSchema, releaseMultipartCompleteRequestSchema, releaseMultipartCompleteResponseSchema, releaseMultipartCreateRequestSchema, releaseMultipartCreateResponseSchema, releaseMultipartListPartsQuerySchema, releaseMultipartListPartsResponseSchema, releaseMultipartPartSchema, releaseMultipartSignPartQuerySchema, releaseMultipartSignPartResponseSchema, 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,
@@ -359,6 +409,46 @@ const releaseUploadFailResponseSchema = z.object({
 	release_id: nonEmptyString,
 	status: z.literal("failed")
 });
+const releaseMultipartCreateRequestSchema = z.object({
+	name: releaseNameSchema,
+	filename: releaseFilenameSchema,
+	mime_type: nonEmptyString.optional(),
+	tags: releaseTagsSchema.optional().default([]),
+	notes: releaseNotesSchema,
+	force_update: z.boolean().optional().default(false)
+});
+const releaseMultipartCreateResponseSchema = z.object({
+	upload_id: nonEmptyString,
+	r2_upload_id: nonEmptyString,
+	key: nonEmptyString,
+	bucket: nonEmptyString,
+	expires_at: positiveInt
+});
+const releaseMultipartSignPartQuerySchema = z.object({
+	upload_id: releaseIdSchema,
+	part_number: z.coerce.number().int().min(1).max(1e4)
+});
+const releaseMultipartSignPartResponseSchema = z.object({
+	url: z.string().url(),
+	expires_at: positiveInt
+});
+const releaseMultipartListPartsQuerySchema = z.object({ upload_id: releaseIdSchema });
+const releaseMultipartPartSchema = z.object({
+	PartNumber: z.number().int().min(1).max(1e4),
+	ETag: nonEmptyString,
+	Size: z.number().int().nonnegative()
+});
+const releaseMultipartListPartsResponseSchema = z.object({ parts: z.array(releaseMultipartPartSchema) });
+const releaseMultipartCompleteRequestSchema = z.object({
+	upload_id: releaseIdSchema,
+	parts: z.array(z.object({
+		PartNumber: z.number().int().min(1).max(1e4),
+		ETag: nonEmptyString
+	})).min(1)
+});
+const releaseMultipartCompleteResponseSchema = releaseUploadCompleteResponseSchema;
+const releaseMultipartAbortRequestSchema = z.object({ upload_id: releaseIdSchema });
+const releaseMultipartAbortResponseSchema = releaseUploadFailResponseSchema;
 const releasesListQuerySchema = z.object({
 	limit: z.number().int().positive().max(100).optional(),
 	cursor: nonEmptyString.optional()
@@ -557,7 +647,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", {
@@ -663,7 +778,32 @@ var UnisourceClient = class {
 			fail: (releaseId, signal) => apiRequest(this.config, "POST", "/releases/upload/fail", {
 				body: { release_id: releaseId },
 				signal
-			})
+			}),
+			multipart: {
+				create: (body, signal) => apiRequest(this.config, "POST", "/releases/upload/multipart/create", {
+					body,
+					signal
+				}),
+				signPart: (uploadId, partNumber, signal) => apiRequest(this.config, "GET", "/releases/upload/multipart/sign-part", {
+					query: {
+						upload_id: uploadId,
+						part_number: partNumber
+					},
+					signal
+				}),
+				listParts: (uploadId, signal) => apiRequest(this.config, "GET", "/releases/upload/multipart/list-parts", {
+					query: { upload_id: uploadId },
+					signal
+				}),
+				complete: (body, signal) => apiRequest(this.config, "POST", "/releases/upload/multipart/complete", {
+					body,
+					signal
+				}),
+				abort: (uploadId, signal) => apiRequest(this.config, "DELETE", "/releases/upload/multipart/abort", {
+					body: { upload_id: uploadId },
+					signal
+				})
+			}
 		},
 		list: (query, signal) => apiRequest(this.config, "GET", "/releases", {
 			query,
@@ -687,6 +827,10 @@ 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", "/admin/files", {
 			query,
@@ -767,4 +911,4 @@ var UnisourceClient = class {
 	};
 };
 //#endregion
-export { FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT, UnisourceClient, UnisourceError, UnisourceNetworkError, 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, 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, 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, releaseMultipartAbortRequestSchema, releaseMultipartAbortResponseSchema, releaseMultipartCompleteRequestSchema, releaseMultipartCompleteResponseSchema, releaseMultipartCreateRequestSchema, releaseMultipartCreateResponseSchema, releaseMultipartListPartsQuerySchema, releaseMultipartListPartsResponseSchema, releaseMultipartPartSchema, releaseMultipartSignPartQuerySchema, releaseMultipartSignPartResponseSchema, 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.2",
+  "version": "0.6.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,
@@ -81,6 +90,13 @@ import type {
   ReleaseDeleteResponse,
   ReleaseSyncRequest,
   ReleaseSyncResponse,
+  ReleaseMultipartCreateRequest,
+  ReleaseMultipartCreateResponse,
+  ReleaseMultipartSignPartResponse,
+  ReleaseMultipartListPartsResponse,
+  ReleaseMultipartCompleteRequest,
+  ReleaseMultipartCompleteResponse,
+  ReleaseMultipartAbortResponse,
 } from './releases';
 
 // ─── SDK Error classes ────────────────────────────────────────────────────────
@@ -248,6 +264,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 ─────────────────────────────────────────────────────────────
@@ -371,6 +419,38 @@ export class UnisourceClient {
       /** Mark a release upload as failed */
       fail: (releaseId: string, signal?: AbortSignal): Promise<ReleaseUploadFailResponse> =>
         apiRequest(this.config, 'POST', '/releases/upload/fail', { body: { release_id: releaseId }, signal }),
+
+      /** Multipart upload helpers — direct browser → R2 via S3 presigned URLs */
+      multipart: {
+        /** Create a multipart release upload — returns the R2 UploadId + storage key */
+        create: (body: ReleaseMultipartCreateRequest, signal?: AbortSignal): Promise<ReleaseMultipartCreateResponse> =>
+          apiRequest(this.config, 'POST', '/releases/upload/multipart/create', { body, signal }),
+
+        /** Short-lived presigned PUT URL for a single part */
+        signPart: (uploadId: string, partNumber: number, signal?: AbortSignal): Promise<ReleaseMultipartSignPartResponse> =>
+          apiRequest(this.config, 'GET', '/releases/upload/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<ReleaseMultipartListPartsResponse> =>
+          apiRequest(this.config, 'GET', '/releases/upload/multipart/list-parts', {
+            query: { upload_id: uploadId },
+            signal,
+          }),
+
+        /** Finalize the multipart upload — backend reads object size from R2 (no client size). */
+        complete: (body: ReleaseMultipartCompleteRequest, signal?: AbortSignal): Promise<ReleaseMultipartCompleteResponse> =>
+          apiRequest(this.config, 'POST', '/releases/upload/multipart/complete', { body, signal }),
+
+        /** Abort an in-flight multipart upload and mark the release as failed */
+        abort: (uploadId: string, signal?: AbortSignal): Promise<ReleaseMultipartAbortResponse> =>
+          apiRequest(this.config, 'DELETE', '/releases/upload/multipart/abort', {
+            body: { upload_id: uploadId },
+            signal,
+          }),
+      },
     },
 
     /** List releases for the configured service */
@@ -409,6 +489,13 @@ 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 }),

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,
@@ -115,6 +141,8 @@ export type {
   ServiceDetailResponse,
   AdminServiceUpdateRequest,
   AdminServiceUpdateResponse,
+  AdminServiceSettingsRequest,
+  AdminServiceSettingsResponse,
   ServiceUsageResponse,
   AuditEventAction,
   AuditEvent,
@@ -149,6 +177,17 @@ export {
   releaseSyncRequestSchema,
   releaseSyncResultSchema,
   releaseSyncResponseSchema,
+  releaseMultipartCreateRequestSchema,
+  releaseMultipartCreateResponseSchema,
+  releaseMultipartSignPartQuerySchema,
+  releaseMultipartSignPartResponseSchema,
+  releaseMultipartListPartsQuerySchema,
+  releaseMultipartListPartsResponseSchema,
+  releaseMultipartPartSchema,
+  releaseMultipartCompleteRequestSchema,
+  releaseMultipartCompleteResponseSchema,
+  releaseMultipartAbortRequestSchema,
+  releaseMultipartAbortResponseSchema,
 } from './releases';
 export type {
   ReleaseDTO,
@@ -165,6 +204,17 @@ export type {
   ReleaseSyncRequest,
   ReleaseSyncResult,
   ReleaseSyncResponse,
+  ReleaseMultipartCreateRequest,
+  ReleaseMultipartCreateResponse,
+  ReleaseMultipartSignPartQuery,
+  ReleaseMultipartSignPartResponse,
+  ReleaseMultipartListPartsQuery,
+  ReleaseMultipartListPartsResponse,
+  ReleaseMultipartPart,
+  ReleaseMultipartCompleteRequest,
+  ReleaseMultipartCompleteResponse,
+  ReleaseMultipartAbortRequest,
+  ReleaseMultipartAbortResponse,
 } from './releases';
 
 // ─── Share Links ─────────────────────────────────────────────────────────────

package/src/releases.ts

@@ -64,6 +64,84 @@ export const releaseUploadFailResponseSchema = z.object({
 });
 export type ReleaseUploadFailResponse = z.infer<typeof releaseUploadFailResponseSchema>;
 
+// ─── Multipart Upload Lifecycle ──────────────────────────────────────────────
+
+export const releaseMultipartCreateRequestSchema = z.object({
+  name: releaseNameSchema,
+  filename: releaseFilenameSchema,
+  /** Defaults server-side to `application/octet-stream` when omitted. */
+  mime_type: nonEmptyString.optional(),
+  tags: releaseTagsSchema.optional().default([]),
+  notes: releaseNotesSchema,
+  force_update: z.boolean().optional().default(false),
+});
+export type ReleaseMultipartCreateRequest = z.input<typeof releaseMultipartCreateRequestSchema>;
+
+export const releaseMultipartCreateResponseSchema = z.object({
+  /** UniSource release id — the same id is used for sign/list/complete/abort. */
+  upload_id: nonEmptyString,
+  /** S3 (R2) multipart UploadId returned by CreateMultipartUpload. */
+  r2_upload_id: nonEmptyString,
+  /** R2 object key the parts are being uploaded against. */
+  key: nonEmptyString,
+  bucket: nonEmptyString,
+  expires_at: positiveInt,
+});
+export type ReleaseMultipartCreateResponse = z.infer<typeof releaseMultipartCreateResponseSchema>;
+
+export const releaseMultipartSignPartQuerySchema = z.object({
+  upload_id: releaseIdSchema,
+  part_number: z.coerce.number().int().min(1).max(10_000),
+});
+export type ReleaseMultipartSignPartQuery = z.input<typeof releaseMultipartSignPartQuerySchema>;
+
+export const releaseMultipartSignPartResponseSchema = z.object({
+  url: z.string().url(),
+  expires_at: positiveInt,
+});
+export type ReleaseMultipartSignPartResponse = z.infer<typeof releaseMultipartSignPartResponseSchema>;
+
+export const releaseMultipartListPartsQuerySchema = z.object({
+  upload_id: releaseIdSchema,
+});
+export type ReleaseMultipartListPartsQuery = z.input<typeof releaseMultipartListPartsQuerySchema>;
+
+export const releaseMultipartPartSchema = z.object({
+  PartNumber: z.number().int().min(1).max(10_000),
+  ETag: nonEmptyString,
+  Size: z.number().int().nonnegative(),
+});
+export type ReleaseMultipartPart = z.infer<typeof releaseMultipartPartSchema>;
+
+export const releaseMultipartListPartsResponseSchema = z.object({
+  parts: z.array(releaseMultipartPartSchema),
+});
+export type ReleaseMultipartListPartsResponse = z.infer<typeof releaseMultipartListPartsResponseSchema>;
+
+export const releaseMultipartCompleteRequestSchema = z.object({
+  upload_id: releaseIdSchema,
+  parts: z
+    .array(
+      z.object({
+        PartNumber: z.number().int().min(1).max(10_000),
+        ETag: nonEmptyString,
+      })
+    )
+    .min(1),
+});
+export type ReleaseMultipartCompleteRequest = z.input<typeof releaseMultipartCompleteRequestSchema>;
+
+export const releaseMultipartCompleteResponseSchema = releaseUploadCompleteResponseSchema;
+export type ReleaseMultipartCompleteResponse = z.infer<typeof releaseMultipartCompleteResponseSchema>;
+
+export const releaseMultipartAbortRequestSchema = z.object({
+  upload_id: releaseIdSchema,
+});
+export type ReleaseMultipartAbortRequest = z.input<typeof releaseMultipartAbortRequestSchema>;
+
+export const releaseMultipartAbortResponseSchema = releaseUploadFailResponseSchema;
+export type ReleaseMultipartAbortResponse = z.infer<typeof releaseMultipartAbortResponseSchema>;
+
 // ─── List ───────────────────────────────────────────────────────────────────
 
 export const releasesListQuerySchema = z.object({

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({

package/src/uploads.ts

@@ -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>;
 
@@ -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,