@unisource/sdk 0.3.0 → 0.3.1

package/dist/index.d.mts

@@ -455,6 +455,8 @@ declare const auditEventSchema: z.ZodObject<{
   resource_id: z.ZodString;
   metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   ip_address: z.ZodNullable<z.ZodString>;
+  actor_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  target_user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   created_at: z.ZodNumber;
 }, z.core.$strip>;
 type AuditEvent = z.infer<typeof auditEventSchema>;
@@ -498,6 +500,8 @@ declare const auditLogListResponseSchema: z.ZodObject<{
     resource_id: z.ZodString;
     metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     ip_address: z.ZodNullable<z.ZodString>;
+    actor_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    target_user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     created_at: z.ZodNumber;
   }, z.core.$strip>>;
   next_cursor: z.ZodNullable<z.ZodString>;
@@ -585,6 +589,25 @@ declare const mainStorageListQuerySchema: z.ZodObject<{
   cursor: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type MainStorageListQuery = z.infer<typeof mainStorageListQuerySchema>;
+declare const mainStorageFileSchema: z.ZodObject<{
+  id: z.ZodString;
+  service_id: z.ZodString;
+  user_id: z.ZodString;
+  folder_id: z.ZodNullable<z.ZodString>;
+  upload_id: z.ZodNullable<z.ZodString>;
+  filename: z.ZodString;
+  size: z.ZodNumber;
+  mime_type: z.ZodString;
+  storage_destination: z.ZodEnum<{
+    appwrite: "appwrite";
+    r2: "r2";
+  }>;
+  is_trashed: z.ZodBoolean;
+  trashed_at: z.ZodNullable<z.ZodNumber>;
+  created_at: z.ZodNumber;
+  updated_at: z.ZodNumber;
+}, z.core.$strip>;
+type MainStorageFile = z.infer<typeof mainStorageFileSchema>;
 declare const mainStorageListResponseSchema: z.ZodObject<{
   items: z.ZodArray<z.ZodObject<{
     id: z.ZodString;
@@ -607,10 +630,50 @@ declare const mainStorageListResponseSchema: z.ZodObject<{
   next_cursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 type MainStorageListResponse = z.infer<typeof mainStorageListResponseSchema>;
+declare const mainStorageDetailResponseSchema: z.ZodObject<{
+  id: z.ZodString;
+  service_id: z.ZodString;
+  user_id: z.ZodString;
+  folder_id: z.ZodNullable<z.ZodString>;
+  upload_id: z.ZodNullable<z.ZodString>;
+  filename: z.ZodString;
+  size: z.ZodNumber;
+  mime_type: z.ZodString;
+  storage_destination: z.ZodEnum<{
+    appwrite: "appwrite";
+    r2: "r2";
+  }>;
+  is_trashed: z.ZodBoolean;
+  trashed_at: z.ZodNullable<z.ZodNumber>;
+  created_at: z.ZodNumber;
+  updated_at: z.ZodNumber;
+}, z.core.$strip>;
+type MainStorageDetailResponse = z.infer<typeof mainStorageDetailResponseSchema>;
 declare const mainStorageRenameRequestSchema: z.ZodObject<{
   filename: z.ZodString;
 }, z.core.$strip>;
 type MainStorageRenameRequest = z.infer<typeof mainStorageRenameRequestSchema>;
+declare const mainStorageRenameResponseSchema: z.ZodObject<{
+  file: z.ZodObject<{
+    id: z.ZodString;
+    service_id: z.ZodString;
+    user_id: z.ZodString;
+    folder_id: z.ZodNullable<z.ZodString>;
+    upload_id: z.ZodNullable<z.ZodString>;
+    filename: z.ZodString;
+    size: z.ZodNumber;
+    mime_type: z.ZodString;
+    storage_destination: z.ZodEnum<{
+      appwrite: "appwrite";
+      r2: "r2";
+    }>;
+    is_trashed: z.ZodBoolean;
+    trashed_at: z.ZodNullable<z.ZodNumber>;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+type MainStorageRenameResponse = z.infer<typeof mainStorageRenameResponseSchema>;
 declare const mainStorageDeleteResponseSchema: z.ZodObject<{
   success: z.ZodBoolean;
   file_id: z.ZodString;
@@ -961,8 +1024,8 @@ declare class UnisourceClient {
   };
   readonly mainStorage: {
     /** List files in the main storage pool */list: (query?: MainStorageListQuery) => Promise<MainStorageListResponse>; /** Get a single main-storage file record */
-    get: (fileId: string) => Promise<FileRecord>; /** Rename a main-storage file */
-    rename: (fileId: string, filename: string) => Promise<FileRecord>; /** Delete a main-storage file (soft by default; pass permanent=true for hard delete) */
+    get: (fileId: string) => Promise<MainStorageDetailResponse>; /** Rename a main-storage file */
+    rename: (fileId: string, filename: string) => Promise<MainStorageRenameResponse>; /** Delete a main-storage file (soft by default; pass permanent=true for hard delete) */
     delete: (fileId: string, permanent?: boolean) => Promise<MainStorageDeleteResponse>; /** Restore a soft-deleted main-storage file */
     restore: (fileId: string) => Promise<MainStorageRestoreResponse>;
     upload: {
@@ -1014,4 +1077,4 @@ declare class UnisourceClient {
   };
 }
 //#endregion
-export { type AdminServiceUpdateRequest, type AdminServiceUpdateResponse, type AdminUser, type AdminUserListResponse, type AdminUserPasswordResetRequest, type AdminUserPasswordResetResponse, 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, MainStorageListQuery, MainStorageListResponse, MainStorageRenameRequest, MainStorageRestoreResponse, 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 ShareLinkListResponse, type ShareLinkUpdateRequest, type ShareLinkUpdateResponse, 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 UploadsListResponse, adminServiceUpdateRequestSchema, adminServiceUpdateResponseSchema, adminUserListResponseSchema, adminUserPasswordResetRequestSchema, adminUserPasswordResetResponseSchema, adminUserSchema, 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, mainStorageListQuerySchema, mainStorageListResponseSchema, mainStorageRenameRequestSchema, mainStorageRestoreResponseSchema, nonEmptyString, positiveInt, publicFileAccessResponseSchema, publicFileLockedResponseSchema, releaseDTOSchema, releaseDeleteResponseSchema, releaseSyncManifestSchema, releaseSyncRequestSchema, releaseSyncResponseSchema, releaseSyncResultSchema, releaseUpdateRequestSchema, releaseUploadCompleteRequestSchema, releaseUploadCompleteResponseSchema, releaseUploadFailResponseSchema, releaseUploadInitRequestSchema, releaseUploadInitResponseSchema, releasesListQuerySchema, releasesListResponseSchema, serviceDetailResponseSchema, serviceSchema, serviceUsageResponseSchema, shareLinkCreateRequestSchema, shareLinkCreateResponseSchema, shareLinkDeleteResponseSchema, shareLinkListResponseSchema, shareLinkSchema, shareLinkUpdateRequestSchema, shareLinkUpdateResponseSchema, unixTimestamp, unlockPublicFile, uploadAppwriteInitRequestSchema, uploadAppwriteInitResponseSchema, uploadCompleteResponseSchema, uploadDestinationSchema, uploadFailResponseSchema, uploadLifecycleRequestSchema, uploadR2InitRequestSchema, uploadR2InitResponseSchema, uploadRecordDetailResponseSchema, uploadRecordSchema, uploadStatusSchema, uploadsListResponseSchema };
+export { type AdminServiceUpdateRequest, type AdminServiceUpdateResponse, type AdminUser, type AdminUserListResponse, type AdminUserPasswordResetRequest, type AdminUserPasswordResetResponse, 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 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 ShareLinkListResponse, type ShareLinkUpdateRequest, type ShareLinkUpdateResponse, 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 UploadsListResponse, adminServiceUpdateRequestSchema, adminServiceUpdateResponseSchema, adminUserListResponseSchema, adminUserPasswordResetRequestSchema, adminUserPasswordResetResponseSchema, adminUserSchema, 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, nonEmptyString, positiveInt, publicFileAccessResponseSchema, publicFileLockedResponseSchema, releaseDTOSchema, releaseDeleteResponseSchema, releaseSyncManifestSchema, releaseSyncRequestSchema, releaseSyncResponseSchema, releaseSyncResultSchema, releaseUpdateRequestSchema, releaseUploadCompleteRequestSchema, releaseUploadCompleteResponseSchema, releaseUploadFailResponseSchema, releaseUploadInitRequestSchema, releaseUploadInitResponseSchema, releasesListQuerySchema, releasesListResponseSchema, serviceDetailResponseSchema, serviceSchema, serviceUsageResponseSchema, shareLinkCreateRequestSchema, shareLinkCreateResponseSchema, shareLinkDeleteResponseSchema, shareLinkListResponseSchema, shareLinkSchema, shareLinkUpdateRequestSchema, shareLinkUpdateResponseSchema, unixTimestamp, unlockPublicFile, uploadAppwriteInitRequestSchema, uploadAppwriteInitResponseSchema, uploadCompleteResponseSchema, uploadDestinationSchema, uploadFailResponseSchema, uploadLifecycleRequestSchema, uploadR2InitRequestSchema, uploadR2InitResponseSchema, uploadRecordDetailResponseSchema, uploadRecordSchema, uploadStatusSchema, uploadsListResponseSchema };

package/dist/index.mjs

@@ -225,6 +225,8 @@ const auditEventSchema = z.object({
 	resource_id: nonEmptyString,
 	metadata: z.record(z.string(), z.unknown()).nullable(),
 	ip_address: z.string().nullable(),
+	actor_id: z.string().nullable().optional(),
+	target_user_id: z.string().nullable().optional(),
 	created_at: unixTimestamp
 });
 const auditLogListQuerySchema = z.object({
@@ -284,14 +286,17 @@ const adminUserPasswordResetResponseSchema = z.object({
 //#endregion
 //#region src/mainStorage.ts
 const mainStorageListQuerySchema = z.object({
-	limit: z.number().int().positive().optional(),
+	limit: z.number().int().min(1).max(100).optional(),
 	cursor: nonEmptyString.optional()
 });
+const mainStorageFileSchema = fileRecordSchema;
 const mainStorageListResponseSchema = z.object({
-	items: z.array(fileRecordSchema),
+	items: z.array(mainStorageFileSchema),
 	next_cursor: z.string().nullable()
 });
-const mainStorageRenameRequestSchema = z.object({ filename: nonEmptyString });
+const mainStorageDetailResponseSchema = mainStorageFileSchema;
+const mainStorageRenameRequestSchema = z.object({ filename: nonEmptyString.max(255) });
+const mainStorageRenameResponseSchema = z.object({ file: mainStorageFileSchema });
 const mainStorageDeleteResponseSchema = z.object({
 	success: z.boolean(),
 	file_id: nonEmptyString
@@ -613,7 +618,7 @@ var UnisourceClient = class {
 		list: (query) => this.request("GET", "/main", { query }),
 		get: (fileId) => this.request("GET", `/main/${fileId}`),
 		rename: (fileId, filename) => this.request("PATCH", `/main/${fileId}`, { body: { filename } }),
-		delete: (fileId, permanent = false) => this.request("DELETE", `/main/${fileId}${permanent ? "?permanent=true" : ""}`),
+		delete: (fileId, permanent = false) => this.request("DELETE", `/main/${fileId}`, { query: { permanent: permanent || void 0 } }),
 		restore: (fileId) => this.request("POST", `/main/${fileId}/restore`),
 		upload: {
 			r2Init: (input) => this.request("POST", "/upload/r2/init", { body: {
@@ -707,4 +712,4 @@ var UnisourceClient = class {
 	};
 };
 //#endregion
-export { FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT, UnisourceClient, UnisourceError, UnisourceNetworkError, adminServiceUpdateRequestSchema, adminServiceUpdateResponseSchema, adminUserListResponseSchema, adminUserPasswordResetRequestSchema, adminUserPasswordResetResponseSchema, adminUserSchema, 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, mainStorageListQuerySchema, mainStorageListResponseSchema, mainStorageRenameRequestSchema, mainStorageRestoreResponseSchema, nonEmptyString, positiveInt, publicFileAccessResponseSchema, publicFileLockedResponseSchema, releaseDTOSchema, releaseDeleteResponseSchema, releaseSyncManifestSchema, releaseSyncRequestSchema, releaseSyncResponseSchema, releaseSyncResultSchema, releaseUpdateRequestSchema, releaseUploadCompleteRequestSchema, releaseUploadCompleteResponseSchema, releaseUploadFailResponseSchema, releaseUploadInitRequestSchema, releaseUploadInitResponseSchema, releasesListQuerySchema, releasesListResponseSchema, serviceDetailResponseSchema, serviceSchema, serviceUsageResponseSchema, shareLinkCreateRequestSchema, shareLinkCreateResponseSchema, shareLinkDeleteResponseSchema, shareLinkListResponseSchema, shareLinkSchema, shareLinkUpdateRequestSchema, shareLinkUpdateResponseSchema, unixTimestamp, unlockPublicFile, uploadAppwriteInitRequestSchema, uploadAppwriteInitResponseSchema, uploadCompleteResponseSchema, uploadDestinationSchema, uploadFailResponseSchema, uploadLifecycleRequestSchema, uploadR2InitRequestSchema, uploadR2InitResponseSchema, uploadRecordDetailResponseSchema, uploadRecordSchema, uploadStatusSchema, uploadsListResponseSchema };
+export { FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT, UnisourceClient, UnisourceError, UnisourceNetworkError, adminServiceUpdateRequestSchema, adminServiceUpdateResponseSchema, adminUserListResponseSchema, adminUserPasswordResetRequestSchema, adminUserPasswordResetResponseSchema, adminUserSchema, 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, nonEmptyString, positiveInt, publicFileAccessResponseSchema, publicFileLockedResponseSchema, releaseDTOSchema, releaseDeleteResponseSchema, releaseSyncManifestSchema, releaseSyncRequestSchema, releaseSyncResponseSchema, releaseSyncResultSchema, releaseUpdateRequestSchema, releaseUploadCompleteRequestSchema, releaseUploadCompleteResponseSchema, releaseUploadFailResponseSchema, releaseUploadInitRequestSchema, releaseUploadInitResponseSchema, releasesListQuerySchema, releasesListResponseSchema, serviceDetailResponseSchema, serviceSchema, serviceUsageResponseSchema, shareLinkCreateRequestSchema, shareLinkCreateResponseSchema, shareLinkDeleteResponseSchema, shareLinkListResponseSchema, shareLinkSchema, shareLinkUpdateRequestSchema, shareLinkUpdateResponseSchema, unixTimestamp, unlockPublicFile, uploadAppwriteInitRequestSchema, uploadAppwriteInitResponseSchema, uploadCompleteResponseSchema, uploadDestinationSchema, uploadFailResponseSchema, uploadLifecycleRequestSchema, uploadR2InitRequestSchema, uploadR2InitResponseSchema, uploadRecordDetailResponseSchema, uploadRecordSchema, uploadStatusSchema, uploadsListResponseSchema };

package/package.json

@@ -2,7 +2,7 @@
   "name": "@unisource/sdk",
   "private": false,
   "type": "module",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Wspolne kontrakty danych dla backendu i frontendu UniSource.",
   "license": "MIT",
   "publishConfig": {

package/src/client.ts

@@ -57,8 +57,10 @@ import type {
   ShareLinkDeleteResponse,
 } from './shareLinks';
 import type {
+  MainStorageDetailResponse,
   MainStorageListQuery,
   MainStorageListResponse,
+  MainStorageRenameResponse,
   MainStorageDeleteResponse,
   MainStorageRestoreResponse,
 } from './mainStorage';
@@ -316,16 +318,16 @@ export class UnisourceClient {
       this.request('GET', '/main', { query }),
 
     /** Get a single main-storage file record */
-    get: (fileId: string): Promise<FileRecord> =>
+    get: (fileId: string): Promise<MainStorageDetailResponse> =>
       this.request('GET', `/main/${fileId}`),
 
     /** Rename a main-storage file */
-    rename: (fileId: string, filename: string): Promise<FileRecord> =>
+    rename: (fileId: string, filename: string): Promise<MainStorageRenameResponse> =>
       this.request('PATCH', `/main/${fileId}`, { body: { filename } }),
 
     /** Delete a main-storage file (soft by default; pass permanent=true for hard delete) */
     delete: (fileId: string, permanent = false): Promise<MainStorageDeleteResponse> =>
-      this.request('DELETE', `/main/${fileId}${permanent ? '?permanent=true' : ''}`),
+      this.request('DELETE', `/main/${fileId}`, { query: { permanent: permanent || undefined } }),
 
     /** Restore a soft-deleted main-storage file */
     restore: (fileId: string): Promise<MainStorageRestoreResponse> =>

package/src/mainStorage.ts

@@ -1,28 +1,39 @@
 import { z } from 'zod';
-import { nonEmptyString } from './primitives';
+import { FILES_MAX_LIMIT, nonEmptyString } from './primitives';
 import { fileRecordSchema } from './fileRecords';
 
 // ─── List ──────────────────────────────────────────────────────────────────────
 
 export const mainStorageListQuerySchema = z.object({
-  limit: z.number().int().positive().optional(),
+  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(fileRecordSchema),
+  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,
+  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({

package/src/services.ts

@@ -64,6 +64,8 @@ export const auditEventSchema = z.object({
   resource_id: nonEmptyString,
   metadata: z.record(z.string(), z.unknown()).nullable(),
   ip_address: z.string().nullable(),
+  actor_id: z.string().nullable().optional(),
+  target_user_id: z.string().nullable().optional(),
   created_at: unixTimestamp,
 });
 export type AuditEvent = z.infer<typeof auditEventSchema>;