@unisource/sdk 0.8.0 → 1.1.0-beta.0

package/src/fileRecords.ts

@@ -1,108 +0,0 @@
-import { z } from 'zod';
-import {
-  nonEmptyString,
-  nonNegativeInt,
-  positiveInt,
-  uploadDestinationSchema,
-  FILES_DEFAULT_LIMIT,
-  FILES_MAX_LIMIT,
-} from './primitives';
-
-// ─── User-facing file record ──────────────────────────────────────────────────
-
-/**
- * A confirmed file record owned by a user.
- * Internal fields (storage_key, bucket) are intentionally excluded from the public API.
- */
-export const fileRecordSchema = z.object({
-  id: nonEmptyString,
-  service_id: nonEmptyString,
-  user_id: nonEmptyString,
-  folder_id: nonEmptyString.nullable(),
-  upload_id: nonEmptyString.nullable(),
-  filename: nonEmptyString,
-  /** SDK6: zero-byte uploads are valid (e.g. placeholders). */
-  size: nonNegativeInt,
-  mime_type: nonEmptyString,
-  storage_destination: uploadDestinationSchema,
-  is_trashed: z.boolean(),
-  trashed_at: positiveInt.nullable(),
-  created_at: positiveInt,
-  updated_at: positiveInt,
-});
-export type FileRecord = z.infer<typeof fileRecordSchema>;
-
-// ─── List ─────────────────────────────────────────────────────────────────────
-
-export { FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT };
-
-
-export const fileRecordsListQuerySchema = z.object({
-  folder_id: nonEmptyString.nullable().optional(),
-  is_trashed: z.boolean().optional(),
-  cursor: nonEmptyString.optional(),
-  limit: z.number().int().min(1).max(FILES_MAX_LIMIT).optional(),
-});
-export type FileRecordsListQuery = z.infer<typeof fileRecordsListQuerySchema>;
-
-export const fileRecordsListResponseSchema = z.object({
-  items: z.array(fileRecordSchema),
-  next_cursor: z.string().nullable(),
-  limit: positiveInt,
-});
-export type FileRecordsListResponse = z.infer<typeof fileRecordsListResponseSchema>;
-
-// ─── Single file detail ───────────────────────────────────────────────────────
-
-export const fileRecordDetailResponseSchema = z.object({
-  file: fileRecordSchema,
-});
-export type FileRecordDetailResponse = z.infer<typeof fileRecordDetailResponseSchema>;
-
-// ─── Move ────────────────────────────────────────────────────────────────────
-
-export const fileMoveRequestSchema = z.object({
-  /** null = move to root, undefined = keep unchanged */
-  folder_id: nonEmptyString.nullable().optional(),
-});
-export type FileMoveRequest = z.infer<typeof fileMoveRequestSchema>;
-
-// ─── Download URL ─────────────────────────────────────────────────────────────
-
-export const fileDownloadUrlResponseSchema = z.object({
-  upload_id: nonEmptyString,
-  destination: uploadDestinationSchema,
-  download_url: z.string().url(),
-  expires_at: positiveInt,
-});
-export type FileDownloadUrlResponse = z.infer<typeof fileDownloadUrlResponseSchema>;
-
-// ─── Delete ───────────────────────────────────────────────────────────────────
-
-export const fileDeleteResponseSchema = z.object({
-  success: z.literal(true),
-  id: nonEmptyString,
-  permanent: z.boolean(),
-});
-export type FileDeleteResponse = z.infer<typeof fileDeleteResponseSchema>;
-
-// ─── Restore ──────────────────────────────────────────────────────────────────
-
-export const fileRestoreResponseSchema = z.object({
-  success: z.literal(true),
-  id: nonEmptyString,
-});
-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: z.string().trim().min(1).max(255),
-});
-export type FileUpdateRequest = z.infer<typeof fileUpdateRequestSchema>;
-
-export const fileUpdateResponseSchema = z.object({
-  file: fileRecordSchema,
-});
-export type FileUpdateResponse = z.infer<typeof fileUpdateResponseSchema>;

package/src/folders.ts

@@ -1,97 +0,0 @@
-import { z } from 'zod';
-import { nonEmptyString, positiveInt, FILES_MAX_LIMIT } from './primitives';
-
-// ─── Folder record ────────────────────────────────────────────────────────────
-
-export const folderSchema = z.object({
-  id: nonEmptyString,
-  service_id: nonEmptyString,
-  user_id: nonEmptyString,
-  parent_id: nonEmptyString.nullable(),
-  name: nonEmptyString,
-  color_tag: z.string().nullable(),
-  is_trashed: z.boolean(),
-  trashed_at: positiveInt.nullable(),
-  created_at: positiveInt,
-  updated_at: positiveInt,
-});
-export type Folder = z.infer<typeof folderSchema>;
-
-// ─── List ─────────────────────────────────────────────────────────────────────
-
-export const folderListQuerySchema = z
-  .object({
-    parent_id: nonEmptyString.nullable().optional(),
-    trashed: z.boolean().optional(),
-    is_trashed: z.boolean().optional(),
-    cursor: nonEmptyString.optional(),
-    limit: z.number().int().min(1).max(FILES_MAX_LIMIT).optional(),
-  })
-  .refine(
-    (v) => !(v.trashed !== undefined && v.is_trashed !== undefined),
-    { message: 'Use either trashed or is_trashed, not both' }
-  );
-export type FolderListQuery = z.infer<typeof folderListQuerySchema>;
-
-export const folderListResponseSchema = z.object({
-  items: z.array(folderSchema),
-  next_cursor: z.string().nullable(),
-  limit: positiveInt,
-});
-export type FolderListResponse = z.infer<typeof folderListResponseSchema>;
-
-// ─── Create ───────────────────────────────────────────────────────────────────
-
-export const folderCreateRequestSchema = z.object({
-  name: nonEmptyString,
-  parent_id: nonEmptyString.optional(),
-  color_tag: z.string().optional(),
-});
-export type FolderCreateRequest = z.infer<typeof folderCreateRequestSchema>;
-
-export const folderCreateResponseSchema = z.object({
-  folder: folderSchema,
-});
-export type FolderCreateResponse = z.infer<typeof folderCreateResponseSchema>;
-
-// ─── Update ───────────────────────────────────────────────────────────────────
-
-export const folderUpdateRequestSchema = z
-  .object({
-    name: nonEmptyString.optional(),
-    color_tag: z.string().nullable().optional(),
-  })
-  .refine((v) => v.name !== undefined || v.color_tag !== undefined, {
-    message: 'At least one of name or color_tag must be provided',
-  });
-export type FolderUpdateRequest = z.infer<typeof folderUpdateRequestSchema>;
-
-export const folderUpdateResponseSchema = z.object({
-  folder: folderSchema,
-});
-export type FolderUpdateResponse = z.infer<typeof folderUpdateResponseSchema>;
-
-// ─── Delete ───────────────────────────────────────────────────────────────────
-
-export const folderDeleteResponseSchema = z.object({
-  success: z.literal(true),
-  id: nonEmptyString,
-  permanent: z.boolean(),
-  folders_deleted: z.number().int().nonnegative().optional(),
-});
-export type FolderDeleteResponse = z.infer<typeof folderDeleteResponseSchema>;
-
-// ─── Single folder detail ─────────────────────────────────────────────────────
-
-export const folderDetailResponseSchema = z.object({
-  folder: folderSchema,
-});
-export type FolderDetailResponse = z.infer<typeof folderDetailResponseSchema>;
-
-// ─── Restore ──────────────────────────────────────────────────────────────────
-
-export const folderRestoreResponseSchema = z.object({
-  success: z.literal(true),
-  id: nonEmptyString,
-});
-export type FolderRestoreResponse = z.infer<typeof folderRestoreResponseSchema>;

package/src/index.ts

@@ -1,289 +0,0 @@
-// ─── Primitives ───────────────────────────────────────────────────────────────
-export {
-  nonEmptyString,
-  positiveInt,
-  nonNegativeInt,
-  unixTimestamp,
-  uploadDestinationSchema,
-  recommendedUploadDestinationSchema,
-  uploadStatusSchema,
-  apiErrorSchema,
-  FILES_DEFAULT_LIMIT,
-  FILES_MAX_LIMIT,
-} from './primitives';
-export type {
-  UploadDestination,
-  RecommendedUploadDestination,
-  UploadStatus,
-  ApiError,
-} from './primitives';
-
-
-// ─── Upload ───────────────────────────────────────────────────────────────────
-export {
-  uploadR2InitRequestSchema,
-  uploadR2InitResponseSchema,
-  uploadAppwriteInitRequestSchema,
-  uploadAppwriteInitResponseSchema,
-  uploadLifecycleRequestSchema,
-  uploadCompleteResponseSchema,
-  uploadFailResponseSchema,
-  uploadRecordSchema,
-  uploadsListResponseSchema,
-  uploadRecordDetailResponseSchema,
-  uploadTypeSchema,
-  multipartCreateRequestSchema,
-  multipartCreateResponseSchema,
-  multipartSignPartQuerySchema,
-  multipartSignPartResponseSchema,
-  multipartListPartsQuerySchema,
-  multipartListPartsResponseSchema,
-  multipartPartSchema,
-  multipartCompleteRequestSchema,
-  multipartCompleteResponseSchema,
-  multipartAbortRequestSchema,
-  multipartAbortResponseSchema,
-} from './uploads';
-export type {
-  UploadR2InitRequest,
-  UploadR2InitResponse,
-  UploadAppwriteInitRequest,
-  UploadAppwriteInitResponse,
-  UploadLifecycleRequest,
-  UploadCompleteResponse,
-  UploadFailResponse,
-  UploadRecord,
-  UploadsListResponse,
-  UploadRecordDetailResponse,
-  UploadType,
-  MultipartCreateRequest,
-  MultipartCreateResponse,
-  MultipartSignPartQuery,
-  MultipartSignPartResponse,
-  MultipartListPartsQuery,
-  MultipartListPartsResponse,
-  MultipartPart,
-  MultipartCompleteRequest,
-  MultipartCompleteResponse,
-  MultipartAbortRequest,
-  MultipartAbortResponse,
-} from './uploads';
-
-// ─── File Records ─────────────────────────────────────────────────────────────
-export {
-  fileRecordSchema,
-  fileRecordsListQuerySchema,
-  fileRecordsListResponseSchema,
-  fileRecordDetailResponseSchema,
-  fileMoveRequestSchema,
-  fileDownloadUrlResponseSchema,
-  fileDeleteResponseSchema,
-  fileRestoreResponseSchema,
-  fileUpdateRequestSchema,
-  fileUpdateResponseSchema,
-} from './fileRecords';
-export type {
-  FileRecord,
-  FileRecordsListQuery,
-  FileRecordsListResponse,
-  FileRecordDetailResponse,
-  FileMoveRequest,
-  FileDownloadUrlResponse,
-  FileDeleteResponse,
-  FileRestoreResponse,
-  FileUpdateRequest,
-  FileUpdateResponse,
-} from './fileRecords';
-
-// ─── Folders ─────────────────────────────────────────────────────────────────
-export {
-  folderSchema,
-  folderListQuerySchema,
-  folderListResponseSchema,
-  folderDetailResponseSchema,
-  folderCreateRequestSchema,
-  folderCreateResponseSchema,
-  folderUpdateRequestSchema,
-  folderUpdateResponseSchema,
-  folderDeleteResponseSchema,
-  folderRestoreResponseSchema,
-} from './folders';
-export type {
-  Folder,
-  FolderListQuery,
-  FolderListResponse,
-  FolderDetailResponse,
-  FolderCreateRequest,
-  FolderCreateResponse,
-  FolderUpdateRequest,
-  FolderUpdateResponse,
-  FolderDeleteResponse,
-  FolderRestoreResponse,
-} from './folders';
-
-// ─── Services & Audit ─────────────────────────────────────────────────────────
-export {
-  serviceSchema,
-  serviceDetailResponseSchema,
-  adminServiceUpdateRequestSchema,
-  adminServiceUpdateResponseSchema,
-  adminServiceSettingsRequestSchema,
-  adminServiceSettingsResponseSchema,
-  serviceUsageResponseSchema,
-  auditEventActionSchema,
-  auditEventSchema,
-  auditLogListQuerySchema,
-  auditLogListResponseSchema,
-  adminUserSchema,
-  adminUserListResponseSchema,
-  adminUserUpdateRequestSchema,
-  adminUserUpdateResponseSchema,
-  adminUserPasswordResetRequestSchema,
-  adminUserPasswordResetResponseSchema,
-  adminUserRoleUpdateRequestSchema,
-  adminUserStorageLimitUpdateRequestSchema,
-} from './services';
-export type {
-  Service,
-  ServiceDetailResponse,
-  AdminServiceUpdateRequest,
-  AdminServiceUpdateResponse,
-  AdminServiceSettingsRequest,
-  AdminServiceSettingsResponse,
-  ServiceUsageResponse,
-  AuditEventAction,
-  AuditEvent,
-  AuditLogListQuery,
-  AuditLogListResponse,
-  AdminUser,
-  AdminUserListResponse,
-  AdminUserUpdateRequest,
-  AdminUserUpdateResponse,
-  AdminUserPasswordResetRequest,
-  AdminUserPasswordResetResponse,
-  AdminUserRoleUpdateRequest,
-  AdminUserStorageLimitUpdateRequest,
-} from './services';
-
-// ─── Main Storage ─────────────────────────────────────────────────────────────
-export * from './mainStorage';
-
-// ─── Releases ───────────────────────────────────────────────────────────────
-export {
-  releaseDTOSchema,
-  releaseUploadInitRequestSchema,
-  releaseUploadInitResponseSchema,
-  releaseUploadCompleteRequestSchema,
-  releaseUploadCompleteResponseSchema,
-  releaseUploadFailResponseSchema,
-  releasesListQuerySchema,
-  releasesListResponseSchema,
-  releaseUpdateRequestSchema,
-  releaseDeleteResponseSchema,
-  releaseSyncManifestSchema,
-  releaseSyncRequestSchema,
-  releaseSyncResultSchema,
-  releaseSyncResponseSchema,
-  releaseMultipartCreateRequestSchema,
-  releaseMultipartCreateResponseSchema,
-  releaseMultipartSignPartQuerySchema,
-  releaseMultipartSignPartResponseSchema,
-  releaseMultipartListPartsQuerySchema,
-  releaseMultipartListPartsResponseSchema,
-  releaseMultipartPartSchema,
-  releaseMultipartCompleteRequestSchema,
-  releaseMultipartCompleteResponseSchema,
-  releaseMultipartAbortRequestSchema,
-  releaseMultipartAbortResponseSchema,
-  appReleaseLatestQuerySchema,
-  appReleaseLatestResponseSchema,
-} from './releases';
-export type {
-  ReleaseDTO,
-  ReleaseUploadInitRequest,
-  ReleaseUploadInitResponse,
-  ReleaseUploadCompleteRequest,
-  ReleaseUploadCompleteResponse,
-  ReleaseUploadFailResponse,
-  ReleasesListQuery,
-  ReleasesListResponse,
-  ReleaseUpdateRequest,
-  ReleaseDeleteResponse,
-  ReleaseSyncManifest,
-  ReleaseSyncRequest,
-  ReleaseSyncResult,
-  ReleaseSyncResponse,
-  ReleaseMultipartCreateRequest,
-  ReleaseMultipartCreateResponse,
-  ReleaseMultipartSignPartQuery,
-  ReleaseMultipartSignPartResponse,
-  ReleaseMultipartListPartsQuery,
-  ReleaseMultipartListPartsResponse,
-  ReleaseMultipartPart,
-  ReleaseMultipartCompleteRequest,
-  ReleaseMultipartCompleteResponse,
-  ReleaseMultipartAbortRequest,
-  ReleaseMultipartAbortResponse,
-  AppReleaseLatestQuery,
-  AppReleaseLatestResponse,
-} from './releases';
-
-// ─── Share Links ─────────────────────────────────────────────────────────────
-export {
-  shareLinkSchema,
-  shareLinkCreateRequestSchema,
-  shareLinkUpdateRequestSchema,
-  shareLinkListResponseSchema,
-  shareLinkCreateResponseSchema,
-  shareLinkUpdateResponseSchema,
-  shareLinkDeleteResponseSchema,
-  shareLinkDetailResponseSchema,
-  sharesCreateRequestSchema,
-  publicFileAccessResponseSchema,
-  publicFileLockedResponseSchema,
-} from './shareLinks';
-export type {
-  ShareLink,
-  ShareLinkCreateRequest,
-  ShareLinkUpdateRequest,
-  ShareLinkListResponse,
-  ShareLinkCreateResponse,
-  ShareLinkUpdateResponse,
-  ShareLinkDeleteResponse,
-  ShareLinkDetailResponse,
-  SharesCreateRequest,
-  PublicFileAccessResponse,
-  PublicFileLockedResponse,
-} from './shareLinks';
-
-// ─── HTTP Client ─────────────────────────────────────────────────────────────
-export {
-  UnisourceClient,
-  UnisourceError,
-  UnisourceNetworkError,
-  getPublicFileInfo,
-  unlockPublicFile,
-} from './client';
-export type { UnisourceClientConfig } from './client';
-
-// ─── V2 API ───────────────────────────────────────────────────────────────────
-export {
-  fileRecordsListV2QuerySchema,
-  bulkFileIdsSchema,
-  bulkFileMoveRequestSchema,
-  bulkOperationResponseSchema,
-  folderListV2QuerySchema,
-  bulkFolderIdsSchema,
-  bulkFolderMoveRequestSchema,
-  folderBreadcrumbsResponseSchema,
-} from './v2';
-export type {
-  FileRecordsListV2Query,
-  BulkFileIds,
-  BulkFileMoveRequest,
-  BulkOperationResponse,
-  FolderListV2Query,
-  BulkFolderIds,
-  BulkFolderMoveRequest,
-  FolderBreadcrumbsResponse,
-} from './v2';

package/src/mainStorage.ts

@@ -1,51 +0,0 @@
-import { z } from 'zod';
-import { FILES_MAX_LIMIT, nonEmptyString } from './primitives';
-import { fileRecordSchema } from './fileRecords';
-
-// ─── List ──────────────────────────────────────────────────────────────────────
-
-export const mainStorageListQuerySchema = z.object({
-  limit: z.number().int().min(1).max(FILES_MAX_LIMIT).optional(),
-  cursor: nonEmptyString.optional(),
-});
-export type MainStorageListQuery = z.infer<typeof mainStorageListQuerySchema>;
-
-export const mainStorageFileSchema = fileRecordSchema;
-export type MainStorageFile = z.infer<typeof mainStorageFileSchema>;
-
-export const mainStorageListResponseSchema = z.object({
-  items: z.array(mainStorageFileSchema),
-  next_cursor: z.string().nullable(),
-});
-export type MainStorageListResponse = z.infer<typeof mainStorageListResponseSchema>;
-
-export const mainStorageDetailResponseSchema = mainStorageFileSchema;
-export type MainStorageDetailResponse = z.infer<typeof mainStorageDetailResponseSchema>;
-
-// ─── Rename ────────────────────────────────────────────────────────────────────
-
-export const mainStorageRenameRequestSchema = z.object({
-  filename: nonEmptyString.max(255),
-});
-export type MainStorageRenameRequest = z.infer<typeof mainStorageRenameRequestSchema>;
-
-export const mainStorageRenameResponseSchema = z.object({
-  file: mainStorageFileSchema,
-});
-export type MainStorageRenameResponse = z.infer<typeof mainStorageRenameResponseSchema>;
-
-// ─── Delete ────────────────────────────────────────────────────────────────────
-
-export const mainStorageDeleteResponseSchema = z.object({
-  success: z.boolean(),
-  file_id: nonEmptyString,
-});
-export type MainStorageDeleteResponse = z.infer<typeof mainStorageDeleteResponseSchema>;
-
-// ─── Restore ───────────────────────────────────────────────────────────────────
-
-export const mainStorageRestoreResponseSchema = z.object({
-  success: z.boolean(),
-  file_id: nonEmptyString,
-});
-export type MainStorageRestoreResponse = z.infer<typeof mainStorageRestoreResponseSchema>;

package/src/primitives.ts

@@ -1,43 +0,0 @@
-import { z } from 'zod';
-
-// ─── Primitives ─────────────────────────────────────────────────────────────
-
-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 ─────────────────────────────────────────────────────
-
-export const FILES_DEFAULT_LIMIT = 25;
-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']);
-export type UploadStatus = z.infer<typeof uploadStatusSchema>;
-
-// ─── API Error ────────────────────────────────────────────────────────────────
-
-export const apiErrorSchema = z.object({
-  error: nonEmptyString,
-  message: nonEmptyString,
-});
-export type ApiError = z.infer<typeof apiErrorSchema>;