@unisource/sdk 0.4.0 → 0.7.0

package/dist/index.d.mts

@@ -3,14 +3,30 @@ import { z } from "zod";
 //#region src/primitives.d.ts
 declare const nonEmptyString: z.ZodString;
 declare const positiveInt: z.ZodNumber;
+declare const nonNegativeInt: z.ZodNumber;
 declare const unixTimestamp: z.ZodNumber;
 declare const FILES_DEFAULT_LIMIT = 25;
 declare const FILES_MAX_LIMIT = 100;
+/**
+ * Storage backend a file lives on.
+ * - 'r2'      — Cloudflare R2 via presigned PUT / multipart
+ * - 'appwrite' — Appwrite Storage via direct browser SDK upload
+ *
+ * `recommendedUploadDestinationSchema` adds the meta-value 'hybrid' which is
+ * only valid as a service-wide setting (the upload manager picks r2/appwrite
+ * per-file based on size).
+ */
 declare const uploadDestinationSchema: z.ZodEnum<{
   appwrite: "appwrite";
   r2: "r2";
 }>;
 type UploadDestination = z.infer<typeof uploadDestinationSchema>;
+declare const recommendedUploadDestinationSchema: z.ZodEnum<{
+  appwrite: "appwrite";
+  hybrid: "hybrid";
+  r2: "r2";
+}>;
+type RecommendedUploadDestination = z.infer<typeof recommendedUploadDestinationSchema>;
 declare const uploadStatusSchema: z.ZodEnum<{
   completed: "completed";
   failed: "failed";
@@ -333,6 +349,7 @@ declare const fileRestoreResponseSchema: z.ZodObject<{
   id: z.ZodString;
 }, z.core.$strip>;
 type FileRestoreResponse = z.infer<typeof fileRestoreResponseSchema>;
+/** SDK4: filename hard-capped to 255 to match backend Zod validation. */
 declare const fileUpdateRequestSchema: z.ZodObject<{
   filename: z.ZodString;
 }, z.core.$strip>;
@@ -477,6 +494,7 @@ declare const serviceSchema: z.ZodObject<{
   max_file_size_bytes: z.ZodNumber;
   recommended_upload_destination: z.ZodOptional<z.ZodEnum<{
     appwrite: "appwrite";
+    hybrid: "hybrid";
     r2: "r2";
   }>>;
   created_at: z.ZodNumber;
@@ -491,6 +509,7 @@ declare const serviceDetailResponseSchema: z.ZodObject<{
     max_file_size_bytes: z.ZodNumber;
     recommended_upload_destination: z.ZodOptional<z.ZodEnum<{
       appwrite: "appwrite";
+      hybrid: "hybrid";
       r2: "r2";
     }>>;
     created_at: z.ZodNumber;
@@ -511,6 +530,7 @@ declare const adminServiceUpdateResponseSchema: z.ZodObject<{
     max_file_size_bytes: z.ZodNumber;
     recommended_upload_destination: z.ZodOptional<z.ZodEnum<{
       appwrite: "appwrite";
+      hybrid: "hybrid";
       r2: "r2";
     }>>;
     created_at: z.ZodNumber;
@@ -525,6 +545,7 @@ type AdminServiceUpdateResponse = z.infer<typeof adminServiceUpdateResponseSchem
 declare const adminServiceSettingsRequestSchema: z.ZodObject<{
   recommended_upload_destination: z.ZodOptional<z.ZodEnum<{
     appwrite: "appwrite";
+    hybrid: "hybrid";
     r2: "r2";
   }>>;
 }, z.core.$strip>;
@@ -538,6 +559,7 @@ declare const adminServiceSettingsResponseSchema: z.ZodObject<{
     max_file_size_bytes: z.ZodNumber;
     recommended_upload_destination: z.ZodOptional<z.ZodEnum<{
       appwrite: "appwrite";
+      hybrid: "hybrid";
       r2: "r2";
     }>>;
     created_at: z.ZodNumber;
@@ -873,6 +895,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>;
@@ -956,6 +1047,28 @@ declare const releaseSyncResponseSchema: z.ZodObject<{
   }, z.core.$strip>>;
 }, z.core.$strip>;
 type ReleaseSyncResponse = z.infer<typeof releaseSyncResponseSchema>;
+/**
+ * Response of `GET /app/releases/latest?channel=...` — used by client apps to
+ * discover the most recent completed release for a given distribution channel
+ * (e.g. `stable`, `beta`). Includes a short-lived presigned download URL.
+ */
+declare const appReleaseLatestQuerySchema: z.ZodObject<{
+  channel: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+type AppReleaseLatestQuery = z.input<typeof appReleaseLatestQuerySchema>;
+declare const appReleaseLatestResponseSchema: z.ZodObject<{
+  id: z.ZodString;
+  name: z.ZodString;
+  size: z.ZodNumber;
+  r2_key: z.ZodString;
+  tags: z.ZodArray<z.ZodString>;
+  notes: z.ZodNullable<z.ZodString>;
+  force_update: z.ZodBoolean;
+  created_at: z.ZodString;
+  download_url: z.ZodString;
+  download_url_expires_at: z.ZodNumber;
+}, z.core.$strip>;
+type AppReleaseLatestResponse = z.infer<typeof appReleaseLatestResponseSchema>;
 //#endregion
 //#region src/shareLinks.d.ts
 declare const shareLinkSchema: z.ZodObject<{
@@ -1209,7 +1322,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 */
@@ -1224,6 +1344,7 @@ declare class UnisourceClient {
     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?: {
+      destination?: UploadDestination;
       status?: UploadStatus;
       cursor?: string;
       limit?: number;
@@ -1273,6 +1394,16 @@ declare class UnisourceClient {
     get: (id: string, signal?: AbortSignal) => Promise<ShareLinkDetailResponse>; /** Delete a share link */
     delete: (id: string, signal?: AbortSignal) => Promise<ShareLinkDeleteResponse>;
   };
+  readonly app: {
+    releases: {
+      /**
+       * Get the latest completed release for a channel (e.g. `stable`, `beta`).
+       * Backed by `GET /app/releases/latest`. Returns the release metadata plus
+       * a short-lived presigned download URL.
+       */
+      latest: (channel?: string, signal?: AbortSignal) => Promise<AppReleaseLatestResponse>;
+    };
+  };
 }
 //#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 AppReleaseLatestQuery, type AppReleaseLatestResponse, 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 RecommendedUploadDestination, 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, appReleaseLatestQuerySchema, appReleaseLatestResponseSchema, 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, nonNegativeInt, positiveInt, publicFileAccessResponseSchema, publicFileLockedResponseSchema, recommendedUploadDestinationSchema, 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

@@ -2,10 +2,25 @@ import { z } from "zod";
 //#region src/primitives.ts
 const nonEmptyString = z.string().trim().min(1);
 const positiveInt = z.number().int().positive();
+const nonNegativeInt = z.number().int().nonnegative();
 const unixTimestamp = z.number().int().nonnegative();
 const FILES_DEFAULT_LIMIT = 25;
 const FILES_MAX_LIMIT = 100;
+/**
+* Storage backend a file lives on.
+* - 'r2'      — Cloudflare R2 via presigned PUT / multipart
+* - 'appwrite' — Appwrite Storage via direct browser SDK upload
+*
+* `recommendedUploadDestinationSchema` adds the meta-value 'hybrid' which is
+* only valid as a service-wide setting (the upload manager picks r2/appwrite
+* per-file based on size).
+*/
 const uploadDestinationSchema = z.enum(["r2", "appwrite"]);
+const recommendedUploadDestinationSchema = z.enum([
+	"r2",
+	"appwrite",
+	"hybrid"
+]);
 const uploadStatusSchema = z.enum([
 	"pending",
 	"completed",
@@ -137,7 +152,7 @@ const fileRecordSchema = z.object({
 	folder_id: nonEmptyString.nullable(),
 	upload_id: nonEmptyString.nullable(),
 	filename: nonEmptyString,
-	size: positiveInt,
+	size: nonNegativeInt,
 	mime_type: nonEmptyString,
 	storage_destination: uploadDestinationSchema,
 	is_trashed: z.boolean(),
@@ -173,7 +188,8 @@ const fileRestoreResponseSchema = z.object({
 	success: z.literal(true),
 	id: nonEmptyString
 });
-const fileUpdateRequestSchema = z.object({ filename: nonEmptyString });
+/** SDK4: filename hard-capped to 255 to match backend Zod validation. */
+const fileUpdateRequestSchema = z.object({ filename: z.string().trim().min(1).max(255) });
 const fileUpdateResponseSchema = z.object({ file: fileRecordSchema });
 //#endregion
 //#region src/folders.ts
@@ -232,7 +248,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(),
+	recommended_upload_destination: recommendedUploadDestinationSchema.optional(),
 	created_at: unixTimestamp
 });
 const serviceDetailResponseSchema = z.object({ service: serviceSchema });
@@ -246,7 +262,7 @@ const adminServiceUpdateResponseSchema = serviceDetailResponseSchema;
 * 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 adminServiceSettingsRequestSchema = z.object({ recommended_upload_destination: recommendedUploadDestinationSchema.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,
@@ -409,6 +425,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()
@@ -446,6 +502,24 @@ const releaseSyncResponseSchema = z.object({
 	synced: z.number().int().nonnegative(),
 	results: z.array(releaseSyncResultSchema)
 });
+/**
+* Response of `GET /app/releases/latest?channel=...` — used by client apps to
+* discover the most recent completed release for a given distribution channel
+* (e.g. `stable`, `beta`). Includes a short-lived presigned download URL.
+*/
+const appReleaseLatestQuerySchema = z.object({ channel: nonEmptyString.optional().default("stable") });
+const appReleaseLatestResponseSchema = z.object({
+	id: nonEmptyString,
+	name: nonEmptyString,
+	size: z.number().int().nonnegative(),
+	r2_key: nonEmptyString,
+	tags: z.array(nonEmptyString),
+	notes: z.string().nullable(),
+	force_update: z.boolean(),
+	created_at: nonEmptyString,
+	download_url: z.string().url(),
+	download_url_expires_at: positiveInt
+});
 //#endregion
 //#region src/shareLinks.ts
 const shareLinkSchema = z.object({
@@ -738,7 +812,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,
@@ -844,6 +943,10 @@ var UnisourceClient = class {
 		get: (id, signal) => apiRequest(this.config, "GET", `/shares/${id}`, { signal }),
 		delete: (id, signal) => apiRequest(this.config, "DELETE", `/shares/${id}`, { signal })
 	};
+	app = { releases: { latest: (channel = "stable", signal) => apiRequest(this.config, "GET", "/app/releases/latest", {
+		query: { channel },
+		signal
+	}) } };
 };
 //#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, appReleaseLatestQuerySchema, appReleaseLatestResponseSchema, 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, nonNegativeInt, positiveInt, publicFileAccessResponseSchema, publicFileLockedResponseSchema, recommendedUploadDestinationSchema, 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.7.0",
   "description": "Wspolne kontrakty danych dla backendu i frontendu UniSource.",
   "license": "MIT",
   "publishConfig": {

package/src/client.ts

@@ -1,4 +1,4 @@
-import type { ApiError, UploadStatus } from './primitives';
+import type { ApiError, UploadDestination, UploadStatus } from './primitives';
 import type {
   UploadR2InitRequest,
   UploadR2InitResponse,
@@ -90,6 +90,14 @@ import type {
   ReleaseDeleteResponse,
   ReleaseSyncRequest,
   ReleaseSyncResponse,
+  ReleaseMultipartCreateRequest,
+  ReleaseMultipartCreateResponse,
+  ReleaseMultipartSignPartResponse,
+  ReleaseMultipartListPartsResponse,
+  ReleaseMultipartCompleteRequest,
+  ReleaseMultipartCompleteResponse,
+  ReleaseMultipartAbortResponse,
+  AppReleaseLatestResponse,
 } from './releases';
 
 // ─── SDK Error classes ────────────────────────────────────────────────────────
@@ -412,6 +420,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 */
@@ -462,7 +502,10 @@ export class UnisourceClient {
       apiRequest(this.config, 'GET', '/admin/service/usage', { signal }),
 
     /** List all uploads (pending/completed/failed) for this service */
-    listUploads: (query?: { status?: UploadStatus; cursor?: string; limit?: number }, signal?: AbortSignal): Promise<UploadsListResponse> =>
+    listUploads: (
+      query?: { destination?: UploadDestination; status?: UploadStatus; cursor?: string; limit?: number },
+      signal?: AbortSignal
+    ): Promise<UploadsListResponse> =>
       apiRequest(this.config, 'GET', '/admin/files', { query, signal }),
 
     /** Get a single upload for this service */
@@ -583,4 +626,21 @@ export class UnisourceClient {
     delete: (id: string, signal?: AbortSignal): Promise<ShareLinkDeleteResponse> =>
       apiRequest(this.config, 'DELETE', `/shares/${id}`, { signal }),
   };
+
+  // ─── App-facing endpoints (/app/*) — public release distribution ──────────────
+
+  readonly app = {
+    releases: {
+      /**
+       * Get the latest completed release for a channel (e.g. `stable`, `beta`).
+       * Backed by `GET /app/releases/latest`. Returns the release metadata plus
+       * a short-lived presigned download URL.
+       */
+      latest: (
+        channel: string = 'stable',
+        signal?: AbortSignal
+      ): Promise<AppReleaseLatestResponse> =>
+        apiRequest(this.config, 'GET', '/app/releases/latest', { query: { channel }, signal }),
+    },
+  };
 }

package/src/fileRecords.ts

@@ -1,5 +1,12 @@
 import { z } from 'zod';
-import { nonEmptyString, positiveInt, uploadDestinationSchema, FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT } from './primitives';
+import {
+  nonEmptyString,
+  nonNegativeInt,
+  positiveInt,
+  uploadDestinationSchema,
+  FILES_DEFAULT_LIMIT,
+  FILES_MAX_LIMIT,
+} from './primitives';
 
 // ─── User-facing file record ──────────────────────────────────────────────────
 
@@ -14,7 +21,8 @@ export const fileRecordSchema = z.object({
   folder_id: nonEmptyString.nullable(),
   upload_id: nonEmptyString.nullable(),
   filename: nonEmptyString,
-  size: positiveInt,
+  /** SDK6: zero-byte uploads are valid (e.g. placeholders). */
+  size: nonNegativeInt,
   mime_type: nonEmptyString,
   storage_destination: uploadDestinationSchema,
   is_trashed: z.boolean(),
@@ -88,8 +96,9 @@ export type FileRestoreResponse = z.infer<typeof fileRestoreResponseSchema>;
 
 // ─── Update (rename) ──────────────────────────────────────────────────────────
 
+/** SDK4: filename hard-capped to 255 to match backend Zod validation. */
 export const fileUpdateRequestSchema = z.object({
-  filename: nonEmptyString,
+  filename: z.string().trim().min(1).max(255),
 });
 export type FileUpdateRequest = z.infer<typeof fileUpdateRequestSchema>;
 

package/src/index.ts

@@ -2,14 +2,21 @@
 export {
   nonEmptyString,
   positiveInt,
+  nonNegativeInt,
   unixTimestamp,
   uploadDestinationSchema,
+  recommendedUploadDestinationSchema,
   uploadStatusSchema,
   apiErrorSchema,
   FILES_DEFAULT_LIMIT,
   FILES_MAX_LIMIT,
 } from './primitives';
-export type { UploadDestination, UploadStatus, ApiError } from './primitives';
+export type {
+  UploadDestination,
+  RecommendedUploadDestination,
+  UploadStatus,
+  ApiError,
+} from './primitives';
 
 
 // ─── Upload ───────────────────────────────────────────────────────────────────
@@ -177,6 +184,19 @@ export {
   releaseSyncRequestSchema,
   releaseSyncResultSchema,
   releaseSyncResponseSchema,
+  releaseMultipartCreateRequestSchema,
+  releaseMultipartCreateResponseSchema,
+  releaseMultipartSignPartQuerySchema,
+  releaseMultipartSignPartResponseSchema,
+  releaseMultipartListPartsQuerySchema,
+  releaseMultipartListPartsResponseSchema,
+  releaseMultipartPartSchema,
+  releaseMultipartCompleteRequestSchema,
+  releaseMultipartCompleteResponseSchema,
+  releaseMultipartAbortRequestSchema,
+  releaseMultipartAbortResponseSchema,
+  appReleaseLatestQuerySchema,
+  appReleaseLatestResponseSchema,
 } from './releases';
 export type {
   ReleaseDTO,
@@ -193,6 +213,19 @@ export type {
   ReleaseSyncRequest,
   ReleaseSyncResult,
   ReleaseSyncResponse,
+  ReleaseMultipartCreateRequest,
+  ReleaseMultipartCreateResponse,
+  ReleaseMultipartSignPartQuery,
+  ReleaseMultipartSignPartResponse,
+  ReleaseMultipartListPartsQuery,
+  ReleaseMultipartListPartsResponse,
+  ReleaseMultipartPart,
+  ReleaseMultipartCompleteRequest,
+  ReleaseMultipartCompleteResponse,
+  ReleaseMultipartAbortRequest,
+  ReleaseMultipartAbortResponse,
+  AppReleaseLatestQuery,
+  AppReleaseLatestResponse,
 } from './releases';
 
 // ─── Share Links ─────────────────────────────────────────────────────────────

package/src/primitives.ts

@@ -4,6 +4,7 @@ import { z } from 'zod';
 
 export const nonEmptyString = z.string().trim().min(1);
 export const positiveInt = z.number().int().positive();
+export const nonNegativeInt = z.number().int().nonnegative();
 export const unixTimestamp = z.number().int().nonnegative();
 
 // ─── Pagination constants ─────────────────────────────────────────────────────
@@ -13,9 +14,21 @@ export const FILES_MAX_LIMIT = 100;
 
 // ─── Upload Destination ──────────────────────────────────────────────────────
 
+/**
+ * Storage backend a file lives on.
+ * - 'r2'      — Cloudflare R2 via presigned PUT / multipart
+ * - 'appwrite' — Appwrite Storage via direct browser SDK upload
+ *
+ * `recommendedUploadDestinationSchema` adds the meta-value 'hybrid' which is
+ * only valid as a service-wide setting (the upload manager picks r2/appwrite
+ * per-file based on size).
+ */
 export const uploadDestinationSchema = z.enum(['r2', 'appwrite']);
 export type UploadDestination = z.infer<typeof uploadDestinationSchema>;
 
+export const recommendedUploadDestinationSchema = z.enum(['r2', 'appwrite', 'hybrid']);
+export type RecommendedUploadDestination = z.infer<typeof recommendedUploadDestinationSchema>;
+
 // ─── Upload Status ────────────────────────────────────────────────────────────
 
 export const uploadStatusSchema = z.enum(['pending', 'completed', 'failed']);

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({
@@ -130,3 +208,29 @@ export const releaseSyncResponseSchema = z.object({
   results: z.array(releaseSyncResultSchema),
 });
 export type ReleaseSyncResponse = z.infer<typeof releaseSyncResponseSchema>;
+
+// ─── App-facing /app/releases/latest ─────────────────────────────────────────
+
+/**
+ * Response of `GET /app/releases/latest?channel=...` — used by client apps to
+ * discover the most recent completed release for a given distribution channel
+ * (e.g. `stable`, `beta`). Includes a short-lived presigned download URL.
+ */
+export const appReleaseLatestQuerySchema = z.object({
+  channel: nonEmptyString.optional().default('stable'),
+});
+export type AppReleaseLatestQuery = z.input<typeof appReleaseLatestQuerySchema>;
+
+export const appReleaseLatestResponseSchema = z.object({
+  id: nonEmptyString,
+  name: nonEmptyString,
+  size: z.number().int().nonnegative(),
+  r2_key: nonEmptyString,
+  tags: z.array(nonEmptyString),
+  notes: z.string().nullable(),
+  force_update: z.boolean(),
+  created_at: nonEmptyString,
+  download_url: z.string().url(),
+  download_url_expires_at: positiveInt,
+});
+export type AppReleaseLatestResponse = z.infer<typeof appReleaseLatestResponseSchema>;

package/src/services.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { nonEmptyString, positiveInt, unixTimestamp, uploadDestinationSchema } from './primitives';
+import { nonEmptyString, positiveInt, recommendedUploadDestinationSchema, unixTimestamp } from './primitives';
 
 // ─── Service record ───────────────────────────────────────────────────────────
 
@@ -10,7 +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(),
+  recommended_upload_destination: recommendedUploadDestinationSchema.optional(),
   created_at: unixTimestamp,
 });
 export type Service = z.infer<typeof serviceSchema>;
@@ -43,7 +43,7 @@ export type AdminServiceUpdateResponse = z.infer<typeof adminServiceUpdateRespon
  */
 export const adminServiceSettingsRequestSchema = z
   .object({
-    recommended_upload_destination: uploadDestinationSchema.optional(),
+    recommended_upload_destination: recommendedUploadDestinationSchema.optional(),
   })
   .refine((v) => v.recommended_upload_destination !== undefined, {
     message: 'At least one setting must be provided',