@unisource/sdk 0.4.0 → 0.6.0

package/dist/index.d.mts

@@ -873,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>;
@@ -1209,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 */
@@ -1275,4 +1351,4 @@ declare class UnisourceClient {
   };
 }
 //#endregion
-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 };
+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

@@ -409,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()
@@ -738,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,
@@ -846,4 +911,4 @@ var UnisourceClient = class {
 	};
 };
 //#endregion
-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 };
+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.4.0",
+  "version": "0.6.0",
   "description": "Wspolne kontrakty danych dla backendu i frontendu UniSource.",
   "license": "MIT",
   "publishConfig": {

package/src/client.ts

@@ -90,6 +90,13 @@ import type {
   ReleaseDeleteResponse,
   ReleaseSyncRequest,
   ReleaseSyncResponse,
+  ReleaseMultipartCreateRequest,
+  ReleaseMultipartCreateResponse,
+  ReleaseMultipartSignPartResponse,
+  ReleaseMultipartListPartsResponse,
+  ReleaseMultipartCompleteRequest,
+  ReleaseMultipartCompleteResponse,
+  ReleaseMultipartAbortResponse,
 } from './releases';
 
 // ─── SDK Error classes ────────────────────────────────────────────────────────
@@ -412,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 */

package/src/index.ts

@@ -177,6 +177,17 @@ export {
   releaseSyncRequestSchema,
   releaseSyncResultSchema,
   releaseSyncResponseSchema,
+  releaseMultipartCreateRequestSchema,
+  releaseMultipartCreateResponseSchema,
+  releaseMultipartSignPartQuerySchema,
+  releaseMultipartSignPartResponseSchema,
+  releaseMultipartListPartsQuerySchema,
+  releaseMultipartListPartsResponseSchema,
+  releaseMultipartPartSchema,
+  releaseMultipartCompleteRequestSchema,
+  releaseMultipartCompleteResponseSchema,
+  releaseMultipartAbortRequestSchema,
+  releaseMultipartAbortResponseSchema,
 } from './releases';
 export type {
   ReleaseDTO,
@@ -193,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({