@unisource/sdk 0.3.2 → 0.4.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;
@@ -1003,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?: {
@@ -1088,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;
@@ -1142,4 +1275,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 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,
@@ -557,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", {
@@ -687,6 +762,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 +846,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, 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.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,
@@ -248,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 ─────────────────────────────────────────────────────────────
@@ -409,6 +450,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,

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,