@unisource/sdk 0.2.0 → 0.3.1

package/src/index.ts

@@ -1,106 +1,198 @@
-// ─── Primitives ───────────────────────────────────────────────────────────────
-export {
-  nonEmptyString,
-  positiveInt,
-  unixTimestamp,
-  uploadDestinationSchema,
-  uploadStatusSchema,
-  apiErrorSchema,
-} from './primitives';
-export type { UploadDestination, UploadStatus, ApiError } from './primitives';
-
-// ─── Upload ───────────────────────────────────────────────────────────────────
-export {
-  FILES_DEFAULT_LIMIT,
-  FILES_MAX_LIMIT,
-  uploadR2InitRequestSchema,
-  uploadR2InitResponseSchema,
-  uploadAppwriteInitRequestSchema,
-  uploadAppwriteInitResponseSchema,
-  uploadLifecycleRequestSchema,
-  uploadCompleteResponseSchema,
-  uploadFailResponseSchema,
-  uploadRecordSchema,
-  uploadsListResponseSchema,
-} from './uploads';
-export type {
-  UploadR2InitRequest,
-  UploadR2InitResponse,
-  UploadAppwriteInitRequest,
-  UploadAppwriteInitResponse,
-  UploadLifecycleRequest,
-  UploadCompleteResponse,
-  UploadFailResponse,
-  UploadRecord,
-  UploadsListResponse,
-} from './uploads';
-
-// ─── File Records ─────────────────────────────────────────────────────────────
-export {
-  fileRecordSchema,
-  fileRecordsListQuerySchema,
-  fileRecordsListResponseSchema,
-  fileRecordDetailResponseSchema,
-  fileMoveRequestSchema,
-  fileDownloadUrlResponseSchema,
-  fileDeleteResponseSchema,
-  fileRestoreResponseSchema,
-} from './fileRecords';
-export type {
-  FileRecord,
-  FileRecordsListQuery,
-  FileRecordsListResponse,
-  FileRecordDetailResponse,
-  FileMoveRequest,
-  FileDownloadUrlResponse,
-  FileDeleteResponse,
-  FileRestoreResponse,
-} from './fileRecords';
-
-// ─── Folders ─────────────────────────────────────────────────────────────────
-export {
-  folderSchema,
-  folderListQuerySchema,
-  folderListResponseSchema,
-  folderCreateRequestSchema,
-  folderCreateResponseSchema,
-  folderUpdateRequestSchema,
-  folderUpdateResponseSchema,
-  folderDeleteResponseSchema,
-  folderRestoreResponseSchema,
-} from './folders';
-export type {
-  Folder,
-  FolderListQuery,
-  FolderListResponse,
-  FolderCreateRequest,
-  FolderCreateResponse,
-  FolderUpdateRequest,
-  FolderUpdateResponse,
-  FolderDeleteResponse,
-  FolderRestoreResponse,
-} from './folders';
-
-// ─── Services & Audit ─────────────────────────────────────────────────────────
-export {
-  serviceSchema,
-  serviceDetailResponseSchema,
-  serviceUsageResponseSchema,
-  auditEventActionSchema,
-  auditEventSchema,
-  auditLogListQuerySchema,
-  auditLogListResponseSchema,
-} from './services';
-export type {
-  Service,
-  ServiceDetailResponse,
-  ServiceUsageResponse,
-  AuditEventAction,
-  AuditEvent,
-  AuditLogListQuery,
-  AuditLogListResponse,
-} from './services';
-
-// ─── HTTP Client ─────────────────────────────────────────────────────────────
-export { UnisourceClient, UnisourceError, UnisourceNetworkError } from './client';
-export type { UnisourceClientConfig } from './client';
+// ─── Primitives ───────────────────────────────────────────────────────────────
+export {
+  nonEmptyString,
+  positiveInt,
+  unixTimestamp,
+  uploadDestinationSchema,
+  uploadStatusSchema,
+  apiErrorSchema,
+  FILES_DEFAULT_LIMIT,
+  FILES_MAX_LIMIT,
+} from './primitives';
+export type { UploadDestination, UploadStatus, ApiError } from './primitives';
+
+
+// ─── Upload ───────────────────────────────────────────────────────────────────
+export {
+  uploadR2InitRequestSchema,
+  uploadR2InitResponseSchema,
+  uploadAppwriteInitRequestSchema,
+  uploadAppwriteInitResponseSchema,
+  uploadLifecycleRequestSchema,
+  uploadCompleteResponseSchema,
+  uploadFailResponseSchema,
+  uploadRecordSchema,
+  uploadsListResponseSchema,
+  uploadRecordDetailResponseSchema,
+} from './uploads';
+export type {
+  UploadR2InitRequest,
+  UploadR2InitResponse,
+  UploadAppwriteInitRequest,
+  UploadAppwriteInitResponse,
+  UploadLifecycleRequest,
+  UploadCompleteResponse,
+  UploadFailResponse,
+  UploadRecord,
+  UploadsListResponse,
+  UploadRecordDetailResponse,
+} 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,
+  serviceUsageResponseSchema,
+  auditEventActionSchema,
+  auditEventSchema,
+  auditLogListQuerySchema,
+  auditLogListResponseSchema,
+  adminUserSchema,
+  adminUserListResponseSchema,
+  adminUserUpdateRequestSchema,
+  adminUserUpdateResponseSchema,
+  adminUserPasswordResetRequestSchema,
+  adminUserPasswordResetResponseSchema,
+} from './services';
+export type {
+  Service,
+  ServiceDetailResponse,
+  AdminServiceUpdateRequest,
+  AdminServiceUpdateResponse,
+  ServiceUsageResponse,
+  AuditEventAction,
+  AuditEvent,
+  AuditLogListQuery,
+  AuditLogListResponse,
+  AdminUser,
+  AdminUserListResponse,
+  AdminUserUpdateRequest,
+  AdminUserUpdateResponse,
+  AdminUserPasswordResetRequest,
+  AdminUserPasswordResetResponse,
+} from './services';
+
+// ─── Main Storage ─────────────────────────────────────────────────────────────
+export * from './mainStorage';
+
+// ─── Releases ───────────────────────────────────────────────────────────────
+export {
+  releaseDTOSchema,
+  releaseUploadInitRequestSchema,
+  releaseUploadInitResponseSchema,
+  releaseUploadCompleteRequestSchema,
+  releaseUploadCompleteResponseSchema,
+  releaseUploadFailResponseSchema,
+  releasesListQuerySchema,
+  releasesListResponseSchema,
+  releaseUpdateRequestSchema,
+  releaseDeleteResponseSchema,
+  releaseSyncManifestSchema,
+  releaseSyncRequestSchema,
+  releaseSyncResultSchema,
+  releaseSyncResponseSchema,
+} from './releases';
+export type {
+  ReleaseDTO,
+  ReleaseUploadInitRequest,
+  ReleaseUploadInitResponse,
+  ReleaseUploadCompleteRequest,
+  ReleaseUploadCompleteResponse,
+  ReleaseUploadFailResponse,
+  ReleasesListQuery,
+  ReleasesListResponse,
+  ReleaseUpdateRequest,
+  ReleaseDeleteResponse,
+  ReleaseSyncManifest,
+  ReleaseSyncRequest,
+  ReleaseSyncResult,
+  ReleaseSyncResponse,
+} from './releases';
+
+// ─── Share Links ─────────────────────────────────────────────────────────────
+export {
+  shareLinkSchema,
+  shareLinkCreateRequestSchema,
+  shareLinkUpdateRequestSchema,
+  shareLinkListResponseSchema,
+  shareLinkCreateResponseSchema,
+  shareLinkUpdateResponseSchema,
+  shareLinkDeleteResponseSchema,
+  publicFileAccessResponseSchema,
+  publicFileLockedResponseSchema,
+} from './shareLinks';
+export type {
+  ShareLink,
+  ShareLinkCreateRequest,
+  ShareLinkUpdateRequest,
+  ShareLinkListResponse,
+  ShareLinkCreateResponse,
+  ShareLinkUpdateResponse,
+  ShareLinkDeleteResponse,
+  PublicFileAccessResponse,
+  PublicFileLockedResponse,
+} from './shareLinks';
+
+// ─── HTTP Client ─────────────────────────────────────────────────────────────
+export {
+  UnisourceClient,
+  UnisourceError,
+  UnisourceNetworkError,
+  getPublicFileInfo,
+  unlockPublicFile,
+} from './client';
+export type { UnisourceClientConfig } from './client';

package/src/mainStorage.ts

@@ -0,0 +1,51 @@
+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,25 +1,30 @@
-import { z } from 'zod';
-
-// ─── Primitives ─────────────────────────────────────────────────────────────
-
-export const nonEmptyString = z.string().trim().min(1);
-export const positiveInt = z.number().int().positive();
-export const unixTimestamp = z.number().int().nonnegative();
-
-// ─── Upload Destination ──────────────────────────────────────────────────────
-
-export const uploadDestinationSchema = z.enum(['r2', 'appwrite']);
-export type UploadDestination = z.infer<typeof uploadDestinationSchema>;
-
-// ─── 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>;
+import { z } from 'zod';
+
+// ─── Primitives ─────────────────────────────────────────────────────────────
+
+export const nonEmptyString = z.string().trim().min(1);
+export const positiveInt = z.number().int().positive();
+export const unixTimestamp = z.number().int().nonnegative();
+
+// ─── Pagination constants ─────────────────────────────────────────────────────
+
+export const FILES_DEFAULT_LIMIT = 25;
+export const FILES_MAX_LIMIT = 100;
+
+// ─── Upload Destination ──────────────────────────────────────────────────────
+
+export const uploadDestinationSchema = z.enum(['r2', 'appwrite']);
+export type UploadDestination = z.infer<typeof uploadDestinationSchema>;
+
+// ─── 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>;

package/src/releases.ts

@@ -0,0 +1,132 @@
+import { z } from 'zod';
+import { nonEmptyString, positiveInt, uploadStatusSchema } from './primitives';
+
+const releaseIdSchema = z.string().trim().min(1).max(128);
+const releaseNameSchema = z.string().trim().min(1).max(256);
+const releaseFilenameSchema = z.string().trim().min(1).max(255);
+const releaseTagsSchema = z.array(z.string().trim().min(1).max(64)).max(32);
+const releaseNotesSchema = z.string().trim().max(10_000).nullable().optional();
+const releaseR2KeySchema = z.string().trim().min(1).max(1024);
+
+// ─── Release DTO ─────────────────────────────────────────────────────────────
+
+export const releaseDTOSchema = z.object({
+  id: nonEmptyString,
+  service_id: nonEmptyString,
+  name: nonEmptyString,
+  size: z.number().int().nonnegative(),
+  r2_key: nonEmptyString,
+  tags: z.array(nonEmptyString),
+  notes: z.string().nullable(),
+  force_update: z.boolean(),
+  uploaded_by: nonEmptyString,
+  upload_status: uploadStatusSchema,
+  created_at: nonEmptyString,
+});
+export type ReleaseDTO = z.infer<typeof releaseDTOSchema>;
+
+// ─── Upload Lifecycle ───────────────────────────────────────────────────────
+
+export const releaseUploadInitRequestSchema = z.object({
+  name: releaseNameSchema,
+  filename: releaseFilenameSchema,
+  tags: releaseTagsSchema.optional().default([]),
+  notes: releaseNotesSchema,
+  force_update: z.boolean().optional().default(false),
+});
+export type ReleaseUploadInitRequest = z.input<typeof releaseUploadInitRequestSchema>;
+
+export const releaseUploadInitResponseSchema = z.object({
+  release_id: nonEmptyString,
+  presigned_url: z.string().url(),
+  r2_key: nonEmptyString,
+  expires_at: positiveInt,
+});
+export type ReleaseUploadInitResponse = z.infer<typeof releaseUploadInitResponseSchema>;
+
+export const releaseUploadCompleteRequestSchema = z.object({
+  release_id: releaseIdSchema,
+  size: z.number().int().nonnegative(),
+});
+export type ReleaseUploadCompleteRequest = z.infer<typeof releaseUploadCompleteRequestSchema>;
+
+export const releaseUploadCompleteResponseSchema = z.object({
+  success: z.literal(true),
+  release_id: nonEmptyString,
+  status: z.literal('completed'),
+});
+export type ReleaseUploadCompleteResponse = z.infer<typeof releaseUploadCompleteResponseSchema>;
+
+export const releaseUploadFailResponseSchema = z.object({
+  success: z.literal(true),
+  release_id: nonEmptyString,
+  status: z.literal('failed'),
+});
+export type ReleaseUploadFailResponse = z.infer<typeof releaseUploadFailResponseSchema>;
+
+// ─── List ───────────────────────────────────────────────────────────────────
+
+export const releasesListQuerySchema = z.object({
+  limit: z.number().int().positive().max(100).optional(),
+  cursor: nonEmptyString.optional(),
+});
+export type ReleasesListQuery = z.infer<typeof releasesListQuerySchema>;
+
+export const releasesListResponseSchema = z.object({
+  items: z.array(releaseDTOSchema),
+  next_cursor: z.string().nullable(),
+});
+export type ReleasesListResponse = z.infer<typeof releasesListResponseSchema>;
+
+// ─── Update ─────────────────────────────────────────────────────────────────
+
+export const releaseUpdateRequestSchema = z
+  .object({
+    name: releaseNameSchema.optional(),
+    tags: releaseTagsSchema.optional(),
+    notes: releaseNotesSchema,
+    force_update: z.boolean().optional(),
+  })
+  .refine((body) => Object.values(body).some((value) => value !== undefined), {
+    message: 'At least one field must be provided',
+  });
+export type ReleaseUpdateRequest = z.infer<typeof releaseUpdateRequestSchema>;
+
+// ─── Delete ─────────────────────────────────────────────────────────────────
+
+export const releaseDeleteResponseSchema = z.object({
+  success: z.literal(true),
+  release_id: nonEmptyString,
+});
+export type ReleaseDeleteResponse = z.infer<typeof releaseDeleteResponseSchema>;
+
+// ─── Sync ───────────────────────────────────────────────────────────────────
+
+export const releaseSyncManifestSchema = z.object({
+  id: releaseIdSchema.optional(),
+  name: releaseNameSchema,
+  r2_key: releaseR2KeySchema,
+  size: z.number().int().nonnegative(),
+  tags: releaseTagsSchema.optional().default([]),
+  notes: releaseNotesSchema,
+  force_update: z.boolean().optional().default(false),
+});
+export type ReleaseSyncManifest = z.input<typeof releaseSyncManifestSchema>;
+
+export const releaseSyncRequestSchema = z.object({
+  releases: z.array(releaseSyncManifestSchema).min(1).max(100),
+});
+export type ReleaseSyncRequest = z.input<typeof releaseSyncRequestSchema>;
+
+export const releaseSyncResultSchema = z.object({
+  release_id: nonEmptyString,
+  success: z.boolean(),
+  status: uploadStatusSchema,
+});
+export type ReleaseSyncResult = z.infer<typeof releaseSyncResultSchema>;
+
+export const releaseSyncResponseSchema = z.object({
+  synced: z.number().int().nonnegative(),
+  results: z.array(releaseSyncResultSchema),
+});
+export type ReleaseSyncResponse = z.infer<typeof releaseSyncResponseSchema>;