@unisource/sdk 0.1.2

package/README.md

@@ -0,0 +1,23 @@
+# tsdown-starter
+
+A starter for creating a TypeScript package.
+
+## Development
+
+- Install dependencies:
+
+```bash
+npm install
+```
+
+- Run the unit tests:
+
+```bash
+npm run test
+```
+
+- Build the library:
+
+```bash
+npm run build
+```

package/dist/index.d.mts

@@ -0,0 +1,174 @@
+import { z } from "zod";
+
+//#region src/index.d.ts
+declare const FILES_DEFAULT_LIMIT = 25;
+declare const FILES_MAX_LIMIT = 100;
+declare const uploadDestinationSchema: z.ZodEnum<{
+  appwrite: "appwrite";
+  r2: "r2";
+}>;
+type UploadDestination = z.infer<typeof uploadDestinationSchema>;
+declare const uploadStatusSchema: z.ZodEnum<{
+  completed: "completed";
+  failed: "failed";
+  pending: "pending";
+}>;
+type UploadStatus = z.infer<typeof uploadStatusSchema>;
+declare const apiErrorSchema: z.ZodObject<{
+  error: z.ZodString;
+  message: z.ZodString;
+}, z.core.$strip>;
+type ApiError = z.infer<typeof apiErrorSchema>;
+declare const uploadR2InitRequestSchema: z.ZodObject<{
+  filename: z.ZodString;
+  size: z.ZodNumber;
+  mime_type: z.ZodString;
+  bucket: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type UploadR2InitRequest = z.infer<typeof uploadR2InitRequestSchema>;
+declare const uploadR2InitResponseSchema: z.ZodObject<{
+  upload_id: z.ZodString;
+  destination: z.ZodLiteral<"r2">;
+  presigned_url: z.ZodString;
+  storage_key: z.ZodString;
+  bucket: z.ZodString;
+  expires_at: z.ZodNumber;
+}, z.core.$strip>;
+type UploadR2InitResponse = z.infer<typeof uploadR2InitResponseSchema>;
+declare const uploadAppwriteInitRequestSchema: z.ZodObject<{
+  filename: z.ZodString;
+  size: z.ZodNumber;
+  mime_type: z.ZodString;
+}, z.core.$strip>;
+type UploadAppwriteInitRequest = z.infer<typeof uploadAppwriteInitRequestSchema>;
+declare const uploadAppwriteInitResponseSchema: z.ZodObject<{
+  upload_id: z.ZodString;
+  destination: z.ZodLiteral<"appwrite">;
+  appwrite_endpoint: z.ZodString;
+  appwrite_project_id: z.ZodString;
+  appwrite_bucket_id: z.ZodString;
+  file_id: z.ZodString;
+  expires_at: z.ZodNumber;
+}, z.core.$strip>;
+type UploadAppwriteInitResponse = z.infer<typeof uploadAppwriteInitResponseSchema>;
+declare const uploadLifecycleRequestSchema: z.ZodObject<{
+  upload_id: z.ZodString;
+}, z.core.$strip>;
+type UploadLifecycleRequest = z.infer<typeof uploadLifecycleRequestSchema>;
+declare const uploadCompleteResponseSchema: z.ZodObject<{
+  success: z.ZodLiteral<true>;
+  upload_id: z.ZodString;
+  status: z.ZodLiteral<"completed">;
+}, z.core.$strip>;
+type UploadCompleteResponse = z.infer<typeof uploadCompleteResponseSchema>;
+declare const uploadFailResponseSchema: z.ZodObject<{
+  success: z.ZodLiteral<true>;
+  upload_id: z.ZodString;
+  status: z.ZodLiteral<"failed">;
+}, z.core.$strip>;
+type UploadFailResponse = z.infer<typeof uploadFailResponseSchema>;
+declare const fileRecordSchema: z.ZodObject<{
+  id: z.ZodString;
+  filename: z.ZodString;
+  size: z.ZodNumber;
+  mime_type: z.ZodString;
+  destination: z.ZodEnum<{
+    appwrite: "appwrite";
+    r2: "r2";
+  }>;
+  storage_key: z.ZodString;
+  bucket: z.ZodString;
+  status: z.ZodEnum<{
+    completed: "completed";
+    failed: "failed";
+    pending: "pending";
+  }>;
+  expires_at: z.ZodNumber;
+  created_at: z.ZodNumber;
+  updated_at: z.ZodNumber;
+}, z.core.$strip>;
+type FileRecord = z.infer<typeof fileRecordSchema>;
+declare const filesListQuerySchema: z.ZodObject<{
+  limit: z.ZodOptional<z.ZodNumber>;
+  cursor: z.ZodOptional<z.ZodString>;
+  destination: z.ZodOptional<z.ZodEnum<{
+    appwrite: "appwrite";
+    r2: "r2";
+  }>>;
+  status: z.ZodOptional<z.ZodEnum<{
+    completed: "completed";
+    failed: "failed";
+    pending: "pending";
+  }>>;
+}, z.core.$strip>;
+type FilesListQuery = z.infer<typeof filesListQuerySchema>;
+declare const filesListResponseSchema: z.ZodObject<{
+  items: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    filename: z.ZodString;
+    size: z.ZodNumber;
+    mime_type: z.ZodString;
+    destination: z.ZodEnum<{
+      appwrite: "appwrite";
+      r2: "r2";
+    }>;
+    storage_key: z.ZodString;
+    bucket: z.ZodString;
+    status: z.ZodEnum<{
+      completed: "completed";
+      failed: "failed";
+      pending: "pending";
+    }>;
+    expires_at: z.ZodNumber;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+  }, z.core.$strip>>;
+  next_cursor: z.ZodNullable<z.ZodString>;
+  limit: z.ZodNumber;
+}, z.core.$strip>;
+type FilesListResponse = z.infer<typeof filesListResponseSchema>;
+declare const fileDetailsResponseSchema: z.ZodObject<{
+  file: z.ZodObject<{
+    id: z.ZodString;
+    filename: z.ZodString;
+    size: z.ZodNumber;
+    mime_type: z.ZodString;
+    destination: z.ZodEnum<{
+      appwrite: "appwrite";
+      r2: "r2";
+    }>;
+    storage_key: z.ZodString;
+    bucket: z.ZodString;
+    status: z.ZodEnum<{
+      completed: "completed";
+      failed: "failed";
+      pending: "pending";
+    }>;
+    expires_at: z.ZodNumber;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+type FileDetailsResponse = z.infer<typeof fileDetailsResponseSchema>;
+declare const fileDownloadUrlResponseSchema: z.ZodObject<{
+  upload_id: z.ZodString;
+  destination: z.ZodEnum<{
+    appwrite: "appwrite";
+    r2: "r2";
+  }>;
+  download_url: z.ZodString;
+  expires_at: z.ZodNumber;
+}, z.core.$strip>;
+type FileDownloadUrlResponse = z.infer<typeof fileDownloadUrlResponseSchema>;
+declare const fileDeleteResponseSchema: z.ZodObject<{
+  success: z.ZodLiteral<true>;
+  upload_id: z.ZodString;
+  destination: z.ZodEnum<{
+    appwrite: "appwrite";
+    r2: "r2";
+  }>;
+  storage_not_found: z.ZodBoolean;
+}, z.core.$strip>;
+type FileDeleteResponse = z.infer<typeof fileDeleteResponseSchema>;
+//#endregion
+export { ApiError, FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT, FileDeleteResponse, FileDetailsResponse, FileDownloadUrlResponse, FileRecord, FilesListQuery, FilesListResponse, UploadAppwriteInitRequest, UploadAppwriteInitResponse, UploadCompleteResponse, UploadDestination, UploadFailResponse, UploadLifecycleRequest, UploadR2InitRequest, UploadR2InitResponse, UploadStatus, apiErrorSchema, fileDeleteResponseSchema, fileDetailsResponseSchema, fileDownloadUrlResponseSchema, fileRecordSchema, filesListQuerySchema, filesListResponseSchema, uploadAppwriteInitRequestSchema, uploadAppwriteInitResponseSchema, uploadCompleteResponseSchema, uploadDestinationSchema, uploadFailResponseSchema, uploadLifecycleRequestSchema, uploadR2InitRequestSchema, uploadR2InitResponseSchema, uploadStatusSchema };

package/dist/index.d.ts

@@ -0,0 +1,174 @@
+import { z } from "zod";
+
+//#region src/index.d.ts
+declare const FILES_DEFAULT_LIMIT = 25;
+declare const FILES_MAX_LIMIT = 100;
+declare const uploadDestinationSchema: z.ZodEnum<{
+  appwrite: "appwrite";
+  r2: "r2";
+}>;
+type UploadDestination = z.infer<typeof uploadDestinationSchema>;
+declare const uploadStatusSchema: z.ZodEnum<{
+  completed: "completed";
+  failed: "failed";
+  pending: "pending";
+}>;
+type UploadStatus = z.infer<typeof uploadStatusSchema>;
+declare const apiErrorSchema: z.ZodObject<{
+  error: z.ZodString;
+  message: z.ZodString;
+}, z.core.$strip>;
+type ApiError = z.infer<typeof apiErrorSchema>;
+declare const uploadR2InitRequestSchema: z.ZodObject<{
+  filename: z.ZodString;
+  size: z.ZodNumber;
+  mime_type: z.ZodString;
+  bucket: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type UploadR2InitRequest = z.infer<typeof uploadR2InitRequestSchema>;
+declare const uploadR2InitResponseSchema: z.ZodObject<{
+  upload_id: z.ZodString;
+  destination: z.ZodLiteral<"r2">;
+  presigned_url: z.ZodString;
+  storage_key: z.ZodString;
+  bucket: z.ZodString;
+  expires_at: z.ZodNumber;
+}, z.core.$strip>;
+type UploadR2InitResponse = z.infer<typeof uploadR2InitResponseSchema>;
+declare const uploadAppwriteInitRequestSchema: z.ZodObject<{
+  filename: z.ZodString;
+  size: z.ZodNumber;
+  mime_type: z.ZodString;
+}, z.core.$strip>;
+type UploadAppwriteInitRequest = z.infer<typeof uploadAppwriteInitRequestSchema>;
+declare const uploadAppwriteInitResponseSchema: z.ZodObject<{
+  upload_id: z.ZodString;
+  destination: z.ZodLiteral<"appwrite">;
+  appwrite_endpoint: z.ZodString;
+  appwrite_project_id: z.ZodString;
+  appwrite_bucket_id: z.ZodString;
+  file_id: z.ZodString;
+  expires_at: z.ZodNumber;
+}, z.core.$strip>;
+type UploadAppwriteInitResponse = z.infer<typeof uploadAppwriteInitResponseSchema>;
+declare const uploadLifecycleRequestSchema: z.ZodObject<{
+  upload_id: z.ZodString;
+}, z.core.$strip>;
+type UploadLifecycleRequest = z.infer<typeof uploadLifecycleRequestSchema>;
+declare const uploadCompleteResponseSchema: z.ZodObject<{
+  success: z.ZodLiteral<true>;
+  upload_id: z.ZodString;
+  status: z.ZodLiteral<"completed">;
+}, z.core.$strip>;
+type UploadCompleteResponse = z.infer<typeof uploadCompleteResponseSchema>;
+declare const uploadFailResponseSchema: z.ZodObject<{
+  success: z.ZodLiteral<true>;
+  upload_id: z.ZodString;
+  status: z.ZodLiteral<"failed">;
+}, z.core.$strip>;
+type UploadFailResponse = z.infer<typeof uploadFailResponseSchema>;
+declare const fileRecordSchema: z.ZodObject<{
+  id: z.ZodString;
+  filename: z.ZodString;
+  size: z.ZodNumber;
+  mime_type: z.ZodString;
+  destination: z.ZodEnum<{
+    appwrite: "appwrite";
+    r2: "r2";
+  }>;
+  storage_key: z.ZodString;
+  bucket: z.ZodString;
+  status: z.ZodEnum<{
+    completed: "completed";
+    failed: "failed";
+    pending: "pending";
+  }>;
+  expires_at: z.ZodNumber;
+  created_at: z.ZodNumber;
+  updated_at: z.ZodNumber;
+}, z.core.$strip>;
+type FileRecord = z.infer<typeof fileRecordSchema>;
+declare const filesListQuerySchema: z.ZodObject<{
+  limit: z.ZodOptional<z.ZodNumber>;
+  cursor: z.ZodOptional<z.ZodString>;
+  destination: z.ZodOptional<z.ZodEnum<{
+    appwrite: "appwrite";
+    r2: "r2";
+  }>>;
+  status: z.ZodOptional<z.ZodEnum<{
+    completed: "completed";
+    failed: "failed";
+    pending: "pending";
+  }>>;
+}, z.core.$strip>;
+type FilesListQuery = z.infer<typeof filesListQuerySchema>;
+declare const filesListResponseSchema: z.ZodObject<{
+  items: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    filename: z.ZodString;
+    size: z.ZodNumber;
+    mime_type: z.ZodString;
+    destination: z.ZodEnum<{
+      appwrite: "appwrite";
+      r2: "r2";
+    }>;
+    storage_key: z.ZodString;
+    bucket: z.ZodString;
+    status: z.ZodEnum<{
+      completed: "completed";
+      failed: "failed";
+      pending: "pending";
+    }>;
+    expires_at: z.ZodNumber;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+  }, z.core.$strip>>;
+  next_cursor: z.ZodNullable<z.ZodString>;
+  limit: z.ZodNumber;
+}, z.core.$strip>;
+type FilesListResponse = z.infer<typeof filesListResponseSchema>;
+declare const fileDetailsResponseSchema: z.ZodObject<{
+  file: z.ZodObject<{
+    id: z.ZodString;
+    filename: z.ZodString;
+    size: z.ZodNumber;
+    mime_type: z.ZodString;
+    destination: z.ZodEnum<{
+      appwrite: "appwrite";
+      r2: "r2";
+    }>;
+    storage_key: z.ZodString;
+    bucket: z.ZodString;
+    status: z.ZodEnum<{
+      completed: "completed";
+      failed: "failed";
+      pending: "pending";
+    }>;
+    expires_at: z.ZodNumber;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+type FileDetailsResponse = z.infer<typeof fileDetailsResponseSchema>;
+declare const fileDownloadUrlResponseSchema: z.ZodObject<{
+  upload_id: z.ZodString;
+  destination: z.ZodEnum<{
+    appwrite: "appwrite";
+    r2: "r2";
+  }>;
+  download_url: z.ZodString;
+  expires_at: z.ZodNumber;
+}, z.core.$strip>;
+type FileDownloadUrlResponse = z.infer<typeof fileDownloadUrlResponseSchema>;
+declare const fileDeleteResponseSchema: z.ZodObject<{
+  success: z.ZodLiteral<true>;
+  upload_id: z.ZodString;
+  destination: z.ZodEnum<{
+    appwrite: "appwrite";
+    r2: "r2";
+  }>;
+  storage_not_found: z.ZodBoolean;
+}, z.core.$strip>;
+type FileDeleteResponse = z.infer<typeof fileDeleteResponseSchema>;
+//#endregion
+export { ApiError, FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT, FileDeleteResponse, FileDetailsResponse, FileDownloadUrlResponse, FileRecord, FilesListQuery, FilesListResponse, UploadAppwriteInitRequest, UploadAppwriteInitResponse, UploadCompleteResponse, UploadDestination, UploadFailResponse, UploadLifecycleRequest, UploadR2InitRequest, UploadR2InitResponse, UploadStatus, apiErrorSchema, fileDeleteResponseSchema, fileDetailsResponseSchema, fileDownloadUrlResponseSchema, fileRecordSchema, filesListQuerySchema, filesListResponseSchema, uploadAppwriteInitRequestSchema, uploadAppwriteInitResponseSchema, uploadCompleteResponseSchema, uploadDestinationSchema, uploadFailResponseSchema, uploadLifecycleRequestSchema, uploadR2InitRequestSchema, uploadR2InitResponseSchema, uploadStatusSchema };

package/dist/index.mjs

@@ -0,0 +1,94 @@
+import { z } from "zod";
+//#region src/index.ts
+const FILES_DEFAULT_LIMIT = 25;
+const FILES_MAX_LIMIT = 100;
+const nonEmptyStringSchema = z.string().trim().min(1);
+const positiveIntegerSchema = z.number().int().positive();
+const uploadDestinationSchema = z.enum(["r2", "appwrite"]);
+const uploadStatusSchema = z.enum([
+	"pending",
+	"completed",
+	"failed"
+]);
+const apiErrorSchema = z.object({
+	error: nonEmptyStringSchema,
+	message: nonEmptyStringSchema
+});
+const uploadR2InitRequestSchema = z.object({
+	filename: nonEmptyStringSchema,
+	size: positiveIntegerSchema,
+	mime_type: nonEmptyStringSchema,
+	bucket: nonEmptyStringSchema.optional()
+});
+const uploadR2InitResponseSchema = z.object({
+	upload_id: nonEmptyStringSchema,
+	destination: z.literal("r2"),
+	presigned_url: z.string().url(),
+	storage_key: nonEmptyStringSchema,
+	bucket: nonEmptyStringSchema,
+	expires_at: positiveIntegerSchema
+});
+const uploadAppwriteInitRequestSchema = z.object({
+	filename: nonEmptyStringSchema,
+	size: positiveIntegerSchema,
+	mime_type: nonEmptyStringSchema
+});
+const uploadAppwriteInitResponseSchema = z.object({
+	upload_id: nonEmptyStringSchema,
+	destination: z.literal("appwrite"),
+	appwrite_endpoint: z.string().url(),
+	appwrite_project_id: nonEmptyStringSchema,
+	appwrite_bucket_id: nonEmptyStringSchema,
+	file_id: nonEmptyStringSchema,
+	expires_at: positiveIntegerSchema
+});
+const uploadLifecycleRequestSchema = z.object({ upload_id: nonEmptyStringSchema });
+const uploadCompleteResponseSchema = z.object({
+	success: z.literal(true),
+	upload_id: nonEmptyStringSchema,
+	status: z.literal("completed")
+});
+const uploadFailResponseSchema = z.object({
+	success: z.literal(true),
+	upload_id: nonEmptyStringSchema,
+	status: z.literal("failed")
+});
+const fileRecordSchema = z.object({
+	id: nonEmptyStringSchema,
+	filename: nonEmptyStringSchema,
+	size: positiveIntegerSchema,
+	mime_type: nonEmptyStringSchema,
+	destination: uploadDestinationSchema,
+	storage_key: nonEmptyStringSchema,
+	bucket: nonEmptyStringSchema,
+	status: uploadStatusSchema,
+	expires_at: positiveIntegerSchema,
+	created_at: positiveIntegerSchema,
+	updated_at: positiveIntegerSchema
+});
+const filesListQuerySchema = z.object({
+	limit: z.number().int().min(1).max(100).optional(),
+	cursor: nonEmptyStringSchema.optional(),
+	destination: uploadDestinationSchema.optional(),
+	status: uploadStatusSchema.optional()
+});
+const filesListResponseSchema = z.object({
+	items: z.array(fileRecordSchema),
+	next_cursor: z.string().nullable(),
+	limit: z.number().int().min(1).max(100)
+});
+const fileDetailsResponseSchema = z.object({ file: fileRecordSchema });
+const fileDownloadUrlResponseSchema = z.object({
+	upload_id: nonEmptyStringSchema,
+	destination: uploadDestinationSchema,
+	download_url: z.string().url(),
+	expires_at: positiveIntegerSchema
+});
+const fileDeleteResponseSchema = z.object({
+	success: z.literal(true),
+	upload_id: nonEmptyStringSchema,
+	destination: uploadDestinationSchema,
+	storage_not_found: z.boolean()
+});
+//#endregion
+export { FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT, apiErrorSchema, fileDeleteResponseSchema, fileDetailsResponseSchema, fileDownloadUrlResponseSchema, fileRecordSchema, filesListQuerySchema, filesListResponseSchema, uploadAppwriteInitRequestSchema, uploadAppwriteInitResponseSchema, uploadCompleteResponseSchema, uploadDestinationSchema, uploadFailResponseSchema, uploadLifecycleRequestSchema, uploadR2InitRequestSchema, uploadR2InitResponseSchema, uploadStatusSchema };

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@unisource/sdk",
+  "private": false,
+  "type": "module",
+  "version": "0.1.2",
+  "description": "Wspolne kontrakty danych dla backendu i frontendu UniSource.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "types": "./src/index.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@typescript/native-preview": "7.0.0-dev.20260328.1",
+    "tsdown": "^0.21.7",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  },
+  "dependencies": {
+    "zod": "^4.3.6"
+  },
+  "scripts": {
+    "build": "tsdown && node -e \"const fs=require('node:fs'); if (fs.existsSync('dist/index.d.mts')) fs.copyFileSync('dist/index.d.mts','dist/index.d.ts');\"",
+    "dev": "tsdown --watch",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/index.ts

@@ -0,0 +1,125 @@
+import { z } from 'zod';
+
+export const FILES_DEFAULT_LIMIT = 25;
+export const FILES_MAX_LIMIT = 100;
+
+const nonEmptyStringSchema = z.string().trim().min(1);
+const positiveIntegerSchema = z.number().int().positive();
+
+export const uploadDestinationSchema = z.enum(['r2', 'appwrite']);
+export type UploadDestination = z.infer<typeof uploadDestinationSchema>;
+
+export const uploadStatusSchema = z.enum(['pending', 'completed', 'failed']);
+export type UploadStatus = z.infer<typeof uploadStatusSchema>;
+
+export const apiErrorSchema = z.object({
+  error: nonEmptyStringSchema,
+  message: nonEmptyStringSchema,
+});
+export type ApiError = z.infer<typeof apiErrorSchema>;
+
+export const uploadR2InitRequestSchema = z.object({
+  filename: nonEmptyStringSchema,
+  size: positiveIntegerSchema,
+  mime_type: nonEmptyStringSchema,
+  bucket: nonEmptyStringSchema.optional(),
+});
+export type UploadR2InitRequest = z.infer<typeof uploadR2InitRequestSchema>;
+
+export const uploadR2InitResponseSchema = z.object({
+  upload_id: nonEmptyStringSchema,
+  destination: z.literal('r2'),
+  presigned_url: z.string().url(),
+  storage_key: nonEmptyStringSchema,
+  bucket: nonEmptyStringSchema,
+  expires_at: positiveIntegerSchema,
+});
+export type UploadR2InitResponse = z.infer<typeof uploadR2InitResponseSchema>;
+
+export const uploadAppwriteInitRequestSchema = z.object({
+  filename: nonEmptyStringSchema,
+  size: positiveIntegerSchema,
+  mime_type: nonEmptyStringSchema,
+});
+export type UploadAppwriteInitRequest = z.infer<typeof uploadAppwriteInitRequestSchema>;
+
+export const uploadAppwriteInitResponseSchema = z.object({
+  upload_id: nonEmptyStringSchema,
+  destination: z.literal('appwrite'),
+  appwrite_endpoint: z.string().url(),
+  appwrite_project_id: nonEmptyStringSchema,
+  appwrite_bucket_id: nonEmptyStringSchema,
+  file_id: nonEmptyStringSchema,
+  expires_at: positiveIntegerSchema,
+});
+export type UploadAppwriteInitResponse = z.infer<typeof uploadAppwriteInitResponseSchema>;
+
+export const uploadLifecycleRequestSchema = z.object({
+  upload_id: nonEmptyStringSchema,
+});
+export type UploadLifecycleRequest = z.infer<typeof uploadLifecycleRequestSchema>;
+
+export const uploadCompleteResponseSchema = z.object({
+  success: z.literal(true),
+  upload_id: nonEmptyStringSchema,
+  status: z.literal('completed'),
+});
+export type UploadCompleteResponse = z.infer<typeof uploadCompleteResponseSchema>;
+
+export const uploadFailResponseSchema = z.object({
+  success: z.literal(true),
+  upload_id: nonEmptyStringSchema,
+  status: z.literal('failed'),
+});
+export type UploadFailResponse = z.infer<typeof uploadFailResponseSchema>;
+
+export const fileRecordSchema = z.object({
+  id: nonEmptyStringSchema,
+  filename: nonEmptyStringSchema,
+  size: positiveIntegerSchema,
+  mime_type: nonEmptyStringSchema,
+  destination: uploadDestinationSchema,
+  storage_key: nonEmptyStringSchema,
+  bucket: nonEmptyStringSchema,
+  status: uploadStatusSchema,
+  expires_at: positiveIntegerSchema,
+  created_at: positiveIntegerSchema,
+  updated_at: positiveIntegerSchema,
+});
+export type FileRecord = z.infer<typeof fileRecordSchema>;
+
+export const filesListQuerySchema = z.object({
+  limit: z.number().int().min(1).max(FILES_MAX_LIMIT).optional(),
+  cursor: nonEmptyStringSchema.optional(),
+  destination: uploadDestinationSchema.optional(),
+  status: uploadStatusSchema.optional(),
+});
+export type FilesListQuery = z.infer<typeof filesListQuerySchema>;
+
+export const filesListResponseSchema = z.object({
+  items: z.array(fileRecordSchema),
+  next_cursor: z.string().nullable(),
+  limit: z.number().int().min(1).max(FILES_MAX_LIMIT),
+});
+export type FilesListResponse = z.infer<typeof filesListResponseSchema>;
+
+export const fileDetailsResponseSchema = z.object({
+  file: fileRecordSchema,
+});
+export type FileDetailsResponse = z.infer<typeof fileDetailsResponseSchema>;
+
+export const fileDownloadUrlResponseSchema = z.object({
+  upload_id: nonEmptyStringSchema,
+  destination: uploadDestinationSchema,
+  download_url: z.string().url(),
+  expires_at: positiveIntegerSchema,
+});
+export type FileDownloadUrlResponse = z.infer<typeof fileDownloadUrlResponseSchema>;
+
+export const fileDeleteResponseSchema = z.object({
+  success: z.literal(true),
+  upload_id: nonEmptyStringSchema,
+  destination: uploadDestinationSchema,
+  storage_not_found: z.boolean(),
+});
+export type FileDeleteResponse = z.infer<typeof fileDeleteResponseSchema>;