@unisource/sdk 1.0.0 → 1.1.0-beta.1

package/README.md

@@ -1,88 +1,173 @@
 # @unisource/sdk
 
-Główne, współdzielone biblioteki oraz klient HTTP (SDK) wykorzystywane zarówno przez aplikację `frontend`, jak i `backend` (w ramach repozytorium UniSource).
+Publiczny pakiet TypeScript dla UniSource. Zawiera kontrakty API, schematy Zod oraz klienty HTTP używane przez frontend, backend i integracje zewnętrzne.
 
-## Zawartość pakietu
+## Instalacja
 
-SDK zapewnia pojedyncze źródło prawdy dla kontraktów API i upraszcza komunikację z backendem. Zawiera m.in.:
+```bash
+pnpm add @unisource/sdk
+```
+
+Wersja stabilna jest publikowana pod tagiem `latest`:
+
+```bash
+pnpm add @unisource/sdk@latest
+```
+
+Wersje testowe API v2 są publikowane pod tagiem `beta`:
+
+```bash
+pnpm add @unisource/sdk@beta
+```
+
+Aktualne tagi npm:
 
-- **Zod Schemas & TypeScript Types**: Pełne definicje typów dla wszystkich encji w systemie: Pliki, Foldery, Udostępnienia (Share Links), Upload (w tym Multipart), Magazyn (Main Storage), Usługi (Services), Role Użytkowników oraz Audyty (Audit Logs).
-- **UnisourceClient**: Silnie typowany klient HTTP służący do bezpiecznej komunikacji z API z uwzględnieniem identyfikacji usługi (`X-Service-ID`) oraz autoryzacji (JWT/API Key).
-- **Publiczne Helpery**: Samodzielne metody do obsługi udostępnionych, publicznych linków (bez wymagania logowania) takie jak `getPublicFileInfo()` czy `unlockPublicFile()`.
-- **Obsługa Błędów**: Precyzyjne klasy błędów `UnisourceError` oraz `UnisourceNetworkError`.
+- `latest` - stabilne API v1
+- `beta` - API v2 w fazie beta, z możliwymi zmianami breaking przed stabilizacją
 
-## Użycie (Usage)
+## Co zawiera pakiet
 
-Przykład konfiguracji i pobrania listy plików przypisanych do użytkownika przy wykorzystaniu instancji klienta:
+- Typy TypeScript i schematy Zod dla plików, folderów, uploadów, share linków, storage, usług, użytkowników i audytów.
+- `UnisourceClient` dla stabilnego API v1.
+- `UnisourceV2Client` oraz kontrakty v2 dostępne z `@unisource/sdk/v2`.
+- Helpery publicznych linków: `getPublicFileInfo()` i `unlockPublicFile()`.
+- Klasy błędów dla v1 oraz v2.
+
+## Stabilne API v1
 
 ```ts
 import { UnisourceClient } from '@unisource/sdk';
 
-// 1. Konfiguracja klienta
 const client = new UnisourceClient({
-  baseUrl: 'https://api.usrc.dev',
-  serviceId: 'usrc',
-  getToken: async () => 'twoj-token-jwt-lub-api-key', // Zwróć null dla zapytań publicznych
+  baseUrl: 'https://api.example.com',
+  serviceId: 'default',
+  getToken: async () => 'jwt-or-api-key',
 });
 
-// 2. Zapytanie API (np. lista plików z paginacją)
-const files = await client.myFiles.list({ folder_id: null, limit: 25 });
+const files = await client.myFiles.list({
+  folder_id: null,
+  limit: 25,
+});
 ```
 
-### Obsługa udostępnień publicznych
-Zapytania o zasoby publiczne nie wymagają pełnej inicjalizacji klienta i posiadają dedykowane, lekkie metody:
+### Publiczne linki
 
 ```ts
 import { getPublicFileInfo, unlockPublicFile } from '@unisource/sdk';
 
-// Pobranie metadanych udostępnionego pliku na podstawie slug'a
-const info = await getPublicFileInfo('https://api.usrc.dev', 'moj-unikalny-slug');
+const info = await getPublicFileInfo('https://api.example.com', 'share-slug');
 
-// Odblokowanie dostępu do pliku chronionego hasłem
-const unlocked = await unlockPublicFile('https://api.usrc.dev', 'moj-unikalny-slug', 'tajne-haslo123');
+const unlocked = await unlockPublicFile(
+  'https://api.example.com',
+  'share-slug',
+  'password'
+);
 ```
 
-## Rozwój lokalny (Development)
+## API v2 beta
 
-W ramach monorepo (narzędzie pnpm):
+API v2 jest dostępne w wersjach `@unisource/sdk@beta`. Importuj je z osobnego entrypointu:
 
-```bash
-# Instalacja wszystkich zależności (w roocie)
-pnpm install
+```ts
+import { UnisourceV2Client } from '@unisource/sdk/v2';
 
-# Kompilacja SDK
-pnpm --filter @unisource/sdk build
+const client = new UnisourceV2Client({
+  baseUrl: 'https://api.example.com',
+  serviceId: 'default',
+  getToken: async () => 'jwt-or-api-key',
+  silentBeta: true,
+});
 
-# Sprawdzanie typów
-pnpm --filter @unisource/sdk typecheck
+const files = await client.files.list({
+  folder_id: null,
+  trash: 'active',
+  sort_by: 'updated_at',
+  sort_dir: 'desc',
+  limit: 50,
+});
 
-# Uruchomienie testów
-pnpm --filter @unisource/sdk test
+const folders = await client.folders.list({
+  parent_id: undefined,
+  trash: 'active',
+  sort_by: 'name',
+  sort_dir: 'asc',
+});
+```
+
+### Typy i schematy v2
+
+```ts
+import {
+  UnisourceV2Error,
+  v2FileSchema,
+  v2FolderSchema,
+  v2ListResponseSchema,
+  type V2File,
+  type V2Folder,
+  type V2ListResponse,
+} from '@unisource/sdk/v2';
 ```
 
-Pakiet może być linkowany lokalnie w ramach workspace, wystarczy w innym projekcie monorepo dodać zależność:
-`"@unisource/sdk": "workspace:*"`
+V2 używa odpowiedzi stronicowanych w formacie:
 
-## Wydawanie nowej wersji (Release Workflow)
+```ts
+interface V2ListResponse<T> {
+  items: T[];
+  page: {
+    limit: number;
+    next_cursor: string | null;
+  };
+}
+```
 
-Pakiet `@unisource/sdk` jest pakietem publicznym na rejestrze NPM i korzysta z narzędzia [Changesets](https://github.com/changesets/changesets) do zarządzania wersjami.
+## Błędy
 
-Aby opublikować nową wersję, wykonaj poniższe kroki z głównego katalogu (root) monorepo:
+```ts
+import { UnisourceError, UnisourceNetworkError } from '@unisource/sdk';
+import { UnisourceV2Error } from '@unisource/sdk/v2';
+
+try {
+  await client.myFiles.list();
+} catch (error) {
+  if (error instanceof UnisourceError) {
+    console.error(error.status, error.message);
+  }
+
+  if (error instanceof UnisourceNetworkError) {
+    console.error('Network error', error.cause);
+  }
+}
+```
 
-```bash
-# 1. Dodaj plik z opisem zmian (wybierz paczkę, typ bumpa i napisz komentarz)
-pnpm changeset
+## Rozwój lokalny
 
-# 2. Zatwierdź nową wersję na podstawie plików changeset (aktualizacja package.json oraz CHANGELOG.md)
-pnpm changeset version
+Repozytorium używa pnpm workspaces.
 
-# 3. Zbuduj SDK by upewnić się, że kod wynikowy jest poprawny
+```bash
+pnpm install
+pnpm --filter @unisource/sdk typecheck
+pnpm --filter @unisource/sdk test
 pnpm --filter @unisource/sdk build
+```
 
-# 4. Sprawdź przed publikacją
-pnpm --filter @unisource/sdk publish --dry-run --access public --no-git-checks
+W aplikacjach z tego samego monorepo używaj zależności workspace:
 
-# 5. Opublikuj na rejestr NPM
-pnpm changeset publish
+```json
+{
+  "dependencies": {
+    "@unisource/sdk": "workspace:*"
+  }
+}
 ```
-Pamiętaj o dodaniu nowo powstałych tagów i commitów do głównego repozytorium po opublikowaniu paczki.
+
+## Release
+
+Stable release jest publikowany przez Changesets i workflow `Release SDK` z brancha `main`.
+
+Beta release jest uruchamiany ręcznie z tego samego workflowu:
+
+- branch workflowu: `main`
+- `channel`: `beta`
+- `bump`: `patch`, `minor`, `major` albo `next`
+
+Pierwsza beta dla nowej linii wersji wymaga `patch`, `minor` albo `major`. Kolejne bety tej samej linii publikuj przez `next`.

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+import { a as BulkOperationResponse, c as FolderListV2Query, d as bulkFolderIdsSchema, f as bulkFolderMoveRequestSchema, g as folderListV2QuerySchema, h as folderBreadcrumbsResponseSchema, i as BulkFolderMoveRequest, l as bulkFileIdsSchema, m as fileRecordsListV2QuerySchema, n as BulkFileMoveRequest, o as FileRecordsListV2Query, p as bulkOperationResponseSchema, r as BulkFolderIds, s as FolderBreadcrumbsResponse, t as BulkFileIds, u as bulkFileMoveRequestSchema } from "./legacy-draft-7fqlx-KW.mjs";
 import { z } from "zod";
 
 //#region src/primitives.d.ts
@@ -6,6 +7,9 @@ declare const positiveInt: z.ZodNumber;
 declare const nonNegativeInt: z.ZodNumber;
 declare const unixTimestamp: z.ZodNumber;
 declare const FILES_DEFAULT_LIMIT = 25;
+/** Maximum items per list-page response (used by all v2 list endpoints). */
+declare const LIST_MAX_LIMIT = 100;
+/** @deprecated Use LIST_MAX_LIMIT — semantically applies to all v2 list endpoints, not just files. */
 declare const FILES_MAX_LIMIT = 100;
 /**
  * Storage backend a file lives on.
@@ -1209,87 +1213,6 @@ declare const sharesCreateRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 type SharesCreateRequest = z.infer<typeof sharesCreateRequestSchema>;
 //#endregion
-//#region src/v2.d.ts
-declare const fileRecordsListV2QuerySchema: z.ZodObject<{
-  folder_id: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null | undefined, string | null | undefined>>;
-  is_trashed: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
-    false: "false";
-    true: "true";
-  }>, z.ZodTransform<boolean, "false" | "true">>>;
-  search: z.ZodOptional<z.ZodString>;
-  mime_type: z.ZodOptional<z.ZodString>;
-  sort_by: z.ZodOptional<z.ZodEnum<{
-    created_at: "created_at";
-    name: "name";
-    size: "size";
-  }>>;
-  sort_dir: z.ZodOptional<z.ZodEnum<{
-    asc: "asc";
-    desc: "desc";
-  }>>;
-  cursor: z.ZodOptional<z.ZodString>;
-  limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
-}, z.core.$strip>;
-type FileRecordsListV2Query = z.infer<typeof fileRecordsListV2QuerySchema>;
-declare const bulkFileIdsSchema: z.ZodObject<{
-  ids: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
-type BulkFileIds = z.infer<typeof bulkFileIdsSchema>;
-declare const bulkFileMoveRequestSchema: z.ZodObject<{
-  ids: z.ZodArray<z.ZodString>;
-  folder_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
-type BulkFileMoveRequest = z.infer<typeof bulkFileMoveRequestSchema>;
-declare const bulkOperationResponseSchema: z.ZodObject<{
-  success: z.ZodBoolean;
-  processed_count: z.ZodNumber;
-  failed_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-type BulkOperationResponse = z.infer<typeof bulkOperationResponseSchema>;
-declare const folderListV2QuerySchema: z.ZodObject<{
-  parent_id: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null | undefined, string | null | undefined>>;
-  is_trashed: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
-    false: "false";
-    true: "true";
-  }>, z.ZodTransform<boolean, "false" | "true">>>;
-  search: z.ZodOptional<z.ZodString>;
-  sort_by: z.ZodOptional<z.ZodEnum<{
-    created_at: "created_at";
-    name: "name";
-  }>>;
-  sort_dir: z.ZodOptional<z.ZodEnum<{
-    asc: "asc";
-    desc: "desc";
-  }>>;
-  cursor: z.ZodOptional<z.ZodString>;
-  limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
-}, z.core.$strip>;
-type FolderListV2Query = z.infer<typeof folderListV2QuerySchema>;
-declare const bulkFolderIdsSchema: z.ZodObject<{
-  ids: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
-type BulkFolderIds = z.infer<typeof bulkFolderIdsSchema>;
-declare const bulkFolderMoveRequestSchema: z.ZodObject<{
-  ids: z.ZodArray<z.ZodString>;
-  parent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
-type BulkFolderMoveRequest = z.infer<typeof bulkFolderMoveRequestSchema>;
-declare const folderBreadcrumbsResponseSchema: z.ZodObject<{
-  breadcrumbs: z.ZodArray<z.ZodObject<{
-    id: z.ZodString;
-    service_id: z.ZodString;
-    user_id: z.ZodString;
-    parent_id: z.ZodNullable<z.ZodString>;
-    name: z.ZodString;
-    color_tag: z.ZodNullable<z.ZodString>;
-    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 FolderBreadcrumbsResponse = z.infer<typeof folderBreadcrumbsResponseSchema>;
-//#endregion
 //#region src/client.d.ts
 declare class UnisourceError extends Error {
   readonly status: number;
@@ -1301,7 +1224,7 @@ declare class UnisourceNetworkError extends Error {
   constructor(message: string, cause: unknown);
 }
 interface UnisourceClientConfig {
-  /** Base URL of the UniSource API, e.g. https://api.usrc.dev */
+  /** Base URL of the UniSource API, e.g. https://api.example.com */
   baseUrl: string;
   /** Service identifier — tells the backend which service this client belongs to */
   serviceId: string;
@@ -1475,6 +1398,9 @@ declare class UnisourceClient {
     get: (id: string, signal?: AbortSignal) => Promise<ShareLinkDetailResponse>; /** Delete a share link */
     delete: (id: string, signal?: AbortSignal) => Promise<ShareLinkDeleteResponse>;
   };
+  /**
+   * @deprecated FROZEN — no new methods. Use UnisourceV2Client from '@unisource/sdk/v2' instead.
+   */
   readonly v2: {
     files: {
       /** List files with advanced search, sorting, and filtering capabilities */list: (query?: FileRecordsListV2Query, signal?: AbortSignal, options?: {
@@ -1520,4 +1446,4 @@ declare class UnisourceClient {
   };
 }
 //#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 AppReleaseLatestQuery, type AppReleaseLatestResponse, type AuditEvent, type AuditEventAction, type AuditLogListQuery, type AuditLogListResponse, type BulkFileIds, type BulkFileMoveRequest, type BulkFolderIds, type BulkFolderMoveRequest, type BulkOperationResponse, FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT, type FileDeleteResponse, type FileDownloadUrlResponse, type FileMoveRequest, type FileRecord, type FileRecordDetailResponse, type FileRecordsListQuery, type FileRecordsListResponse, type FileRecordsListV2Query, type FileRestoreResponse, type FileUpdateRequest, type FileUpdateResponse, type Folder, type FolderBreadcrumbsResponse, type FolderCreateRequest, type FolderCreateResponse, type FolderDeleteResponse, type FolderDetailResponse, type FolderListQuery, type FolderListResponse, type FolderListV2Query, 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, bulkFileIdsSchema, bulkFileMoveRequestSchema, bulkFolderIdsSchema, bulkFolderMoveRequestSchema, bulkOperationResponseSchema, fileDeleteResponseSchema, fileDownloadUrlResponseSchema, fileMoveRequestSchema, fileRecordDetailResponseSchema, fileRecordSchema, fileRecordsListQuerySchema, fileRecordsListResponseSchema, fileRecordsListV2QuerySchema, fileRestoreResponseSchema, fileUpdateRequestSchema, fileUpdateResponseSchema, folderBreadcrumbsResponseSchema, folderCreateRequestSchema, folderCreateResponseSchema, folderDeleteResponseSchema, folderDetailResponseSchema, folderListQuerySchema, folderListResponseSchema, folderListV2QuerySchema, 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 };
+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, type BulkFileIds, type BulkFileMoveRequest, type BulkFolderIds, type BulkFolderMoveRequest, type BulkOperationResponse, FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT, type FileDeleteResponse, type FileDownloadUrlResponse, type FileMoveRequest, type FileRecord, type FileRecordDetailResponse, type FileRecordsListQuery, type FileRecordsListResponse, type FileRecordsListV2Query, type FileRestoreResponse, type FileUpdateRequest, type FileUpdateResponse, type Folder, type FolderBreadcrumbsResponse, type FolderCreateRequest, type FolderCreateResponse, type FolderDeleteResponse, type FolderDetailResponse, type FolderListQuery, type FolderListResponse, type FolderListV2Query, type FolderRestoreResponse, type FolderUpdateRequest, type FolderUpdateResponse, LIST_MAX_LIMIT, 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, bulkFileIdsSchema, bulkFileMoveRequestSchema, bulkFolderIdsSchema, bulkFolderMoveRequestSchema, bulkOperationResponseSchema, fileDeleteResponseSchema, fileDownloadUrlResponseSchema, fileMoveRequestSchema, fileRecordDetailResponseSchema, fileRecordSchema, fileRecordsListQuerySchema, fileRecordsListResponseSchema, fileRecordsListV2QuerySchema, fileRestoreResponseSchema, fileUpdateRequestSchema, fileUpdateResponseSchema, folderBreadcrumbsResponseSchema, folderCreateRequestSchema, folderCreateResponseSchema, folderDeleteResponseSchema, folderDetailResponseSchema, folderListQuerySchema, folderListResponseSchema, folderListV2QuerySchema, 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

@@ -1,36 +1,5 @@
+import { C as nonEmptyString, D as unixTimestamp, E as recommendedUploadDestinationSchema, O as uploadDestinationSchema, S as apiErrorSchema, T as positiveInt, _ as folderUpdateRequestSchema, a as bulkOperationResponseSchema, b as FILES_MAX_LIMIT, c as folderListV2QuerySchema, d as folderDeleteResponseSchema, f as folderDetailResponseSchema, g as folderSchema, h as folderRestoreResponseSchema, i as bulkFolderMoveRequestSchema, k as uploadStatusSchema, l as folderCreateRequestSchema, m as folderListResponseSchema, n as bulkFileMoveRequestSchema, o as fileRecordsListV2QuerySchema, p as folderListQuerySchema, r as bulkFolderIdsSchema, s as folderBreadcrumbsResponseSchema, t as bulkFileIdsSchema, u as folderCreateResponseSchema, v as folderUpdateResponseSchema, w as nonNegativeInt, x as LIST_MAX_LIMIT, y as FILES_DEFAULT_LIMIT } from "./legacy-draft-D0hgtTqN.mjs";
 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",
-	"failed"
-]);
-const apiErrorSchema = z.object({
-	error: nonEmptyString,
-	message: nonEmptyString
-});
-//#endregion
 //#region src/uploads.ts
 const uploadR2InitRequestSchema = z.object({
 	filename: nonEmptyString,
@@ -192,54 +161,6 @@ const fileRestoreResponseSchema = z.object({
 const fileUpdateRequestSchema = z.object({ filename: z.string().trim().min(1).max(255) });
 const fileUpdateResponseSchema = z.object({ file: fileRecordSchema });
 //#endregion
-//#region src/folders.ts
-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
-});
-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(100).optional()
-}).refine((v) => !(v.trashed !== void 0 && v.is_trashed !== void 0), { message: "Use either trashed or is_trashed, not both" });
-const folderListResponseSchema = z.object({
-	items: z.array(folderSchema),
-	next_cursor: z.string().nullable(),
-	limit: positiveInt
-});
-const folderCreateRequestSchema = z.object({
-	name: nonEmptyString,
-	parent_id: nonEmptyString.optional(),
-	color_tag: z.string().optional()
-});
-const folderCreateResponseSchema = z.object({ folder: folderSchema });
-const folderUpdateRequestSchema = z.object({
-	name: nonEmptyString.optional(),
-	color_tag: z.string().nullable().optional()
-}).refine((v) => v.name !== void 0 || v.color_tag !== void 0, { message: "At least one of name or color_tag must be provided" });
-const folderUpdateResponseSchema = z.object({ folder: folderSchema });
-const folderDeleteResponseSchema = z.object({
-	success: z.literal(true),
-	id: nonEmptyString,
-	permanent: z.boolean(),
-	folders_deleted: z.number().int().nonnegative().optional()
-});
-const folderDetailResponseSchema = z.object({ folder: folderSchema });
-const folderRestoreResponseSchema = z.object({
-	success: z.literal(true),
-	id: nonEmptyString
-});
-//#endregion
 //#region src/services.ts
 /** Public service info returned to admins. Never exposes secrets. */
 const serviceSchema = z.object({
@@ -943,6 +864,9 @@ var UnisourceClient = class {
 		get: (id, signal) => apiRequest(this.config, "GET", `/shares/${id}`, { signal }),
 		delete: (id, signal) => apiRequest(this.config, "DELETE", `/shares/${id}`, { signal })
 	};
+	/**
+	* @deprecated FROZEN — no new methods. Use UnisourceV2Client from '@unisource/sdk/v2' instead.
+	*/
 	v2 = {
 		files: {
 			list: (query, signal, options) => apiRequest(this.config, "GET", "/v2/files", {
@@ -999,45 +923,4 @@ var UnisourceClient = class {
 	}) } };
 };
 //#endregion
-//#region src/v2.ts
-const fileRecordsListV2QuerySchema = z.object({
-	folder_id: nonEmptyString.nullable().optional().transform((v) => v === "null" ? null : v),
-	is_trashed: z.enum(["true", "false"]).transform((v) => v === "true").optional(),
-	search: z.string().optional(),
-	mime_type: z.string().optional(),
-	sort_by: z.enum([
-		"created_at",
-		"name",
-		"size"
-	]).optional(),
-	sort_dir: z.enum(["asc", "desc"]).optional(),
-	cursor: nonEmptyString.optional(),
-	limit: z.coerce.number().int().min(1).max(100).optional()
-});
-const bulkFileIdsSchema = z.object({ ids: z.array(nonEmptyString).min(1).max(100) });
-const bulkFileMoveRequestSchema = z.object({
-	ids: z.array(nonEmptyString).min(1).max(100),
-	folder_id: nonEmptyString.nullable().optional()
-});
-const bulkOperationResponseSchema = z.object({
-	success: z.boolean(),
-	processed_count: z.number().int().nonnegative(),
-	failed_ids: z.array(nonEmptyString).optional()
-});
-const folderListV2QuerySchema = z.object({
-	parent_id: nonEmptyString.nullable().optional().transform((v) => v === "null" ? null : v),
-	is_trashed: z.enum(["true", "false"]).transform((v) => v === "true").optional(),
-	search: z.string().optional(),
-	sort_by: z.enum(["created_at", "name"]).optional(),
-	sort_dir: z.enum(["asc", "desc"]).optional(),
-	cursor: nonEmptyString.optional(),
-	limit: z.coerce.number().int().min(1).max(100).optional()
-});
-const bulkFolderIdsSchema = z.object({ ids: z.array(nonEmptyString).min(1).max(100) });
-const bulkFolderMoveRequestSchema = z.object({
-	ids: z.array(nonEmptyString).min(1).max(100),
-	parent_id: nonEmptyString.nullable().optional()
-});
-const folderBreadcrumbsResponseSchema = z.object({ breadcrumbs: z.array(folderSchema) });
-//#endregion
-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, bulkFileIdsSchema, bulkFileMoveRequestSchema, bulkFolderIdsSchema, bulkFolderMoveRequestSchema, bulkOperationResponseSchema, fileDeleteResponseSchema, fileDownloadUrlResponseSchema, fileMoveRequestSchema, fileRecordDetailResponseSchema, fileRecordSchema, fileRecordsListQuerySchema, fileRecordsListResponseSchema, fileRecordsListV2QuerySchema, fileRestoreResponseSchema, fileUpdateRequestSchema, fileUpdateResponseSchema, folderBreadcrumbsResponseSchema, folderCreateRequestSchema, folderCreateResponseSchema, folderDeleteResponseSchema, folderDetailResponseSchema, folderListQuerySchema, folderListResponseSchema, folderListV2QuerySchema, 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 };
+export { FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT, LIST_MAX_LIMIT, UnisourceClient, UnisourceError, UnisourceNetworkError, adminServiceSettingsRequestSchema, adminServiceSettingsResponseSchema, adminServiceUpdateRequestSchema, adminServiceUpdateResponseSchema, adminUserListResponseSchema, adminUserPasswordResetRequestSchema, adminUserPasswordResetResponseSchema, adminUserRoleUpdateRequestSchema, adminUserSchema, adminUserStorageLimitUpdateRequestSchema, adminUserUpdateRequestSchema, adminUserUpdateResponseSchema, apiErrorSchema, appReleaseLatestQuerySchema, appReleaseLatestResponseSchema, auditEventActionSchema, auditEventSchema, auditLogListQuerySchema, auditLogListResponseSchema, bulkFileIdsSchema, bulkFileMoveRequestSchema, bulkFolderIdsSchema, bulkFolderMoveRequestSchema, bulkOperationResponseSchema, fileDeleteResponseSchema, fileDownloadUrlResponseSchema, fileMoveRequestSchema, fileRecordDetailResponseSchema, fileRecordSchema, fileRecordsListQuerySchema, fileRecordsListResponseSchema, fileRecordsListV2QuerySchema, fileRestoreResponseSchema, fileUpdateRequestSchema, fileUpdateResponseSchema, folderBreadcrumbsResponseSchema, folderCreateRequestSchema, folderCreateResponseSchema, folderDeleteResponseSchema, folderDetailResponseSchema, folderListQuerySchema, folderListResponseSchema, folderListV2QuerySchema, 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/legacy-draft-7fqlx-KW.d.mts

@@ -0,0 +1,84 @@
+import { z } from "zod";
+
+//#region src/v2/legacy-draft.d.ts
+declare const fileRecordsListV2QuerySchema: z.ZodObject<{
+  folder_id: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null | undefined, string | null | undefined>>;
+  is_trashed: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
+    false: "false";
+    true: "true";
+  }>, z.ZodTransform<boolean, "false" | "true">>>;
+  search: z.ZodOptional<z.ZodString>;
+  mime_type: z.ZodOptional<z.ZodString>;
+  sort_by: z.ZodOptional<z.ZodEnum<{
+    created_at: "created_at";
+    name: "name";
+    size: "size";
+  }>>;
+  sort_dir: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+  cursor: z.ZodOptional<z.ZodString>;
+  limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+type FileRecordsListV2Query = z.infer<typeof fileRecordsListV2QuerySchema>;
+declare const bulkFileIdsSchema: z.ZodObject<{
+  ids: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type BulkFileIds = z.infer<typeof bulkFileIdsSchema>;
+declare const bulkFileMoveRequestSchema: z.ZodObject<{
+  ids: z.ZodArray<z.ZodString>;
+  folder_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type BulkFileMoveRequest = z.infer<typeof bulkFileMoveRequestSchema>;
+declare const bulkOperationResponseSchema: z.ZodObject<{
+  success: z.ZodBoolean;
+  processed_count: z.ZodNumber;
+  failed_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type BulkOperationResponse = z.infer<typeof bulkOperationResponseSchema>;
+declare const folderListV2QuerySchema: z.ZodObject<{
+  parent_id: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null | undefined, string | null | undefined>>;
+  is_trashed: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
+    false: "false";
+    true: "true";
+  }>, z.ZodTransform<boolean, "false" | "true">>>;
+  search: z.ZodOptional<z.ZodString>;
+  sort_by: z.ZodOptional<z.ZodEnum<{
+    created_at: "created_at";
+    name: "name";
+  }>>;
+  sort_dir: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+  cursor: z.ZodOptional<z.ZodString>;
+  limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+type FolderListV2Query = z.infer<typeof folderListV2QuerySchema>;
+declare const bulkFolderIdsSchema: z.ZodObject<{
+  ids: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type BulkFolderIds = z.infer<typeof bulkFolderIdsSchema>;
+declare const bulkFolderMoveRequestSchema: z.ZodObject<{
+  ids: z.ZodArray<z.ZodString>;
+  parent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type BulkFolderMoveRequest = z.infer<typeof bulkFolderMoveRequestSchema>;
+declare const folderBreadcrumbsResponseSchema: z.ZodObject<{
+  breadcrumbs: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    service_id: z.ZodString;
+    user_id: z.ZodString;
+    parent_id: z.ZodNullable<z.ZodString>;
+    name: z.ZodString;
+    color_tag: z.ZodNullable<z.ZodString>;
+    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 FolderBreadcrumbsResponse = z.infer<typeof folderBreadcrumbsResponseSchema>;
+//#endregion
+export { BulkOperationResponse as a, FolderListV2Query as c, bulkFolderIdsSchema as d, bulkFolderMoveRequestSchema as f, folderListV2QuerySchema as g, folderBreadcrumbsResponseSchema as h, BulkFolderMoveRequest as i, bulkFileIdsSchema as l, fileRecordsListV2QuerySchema as m, BulkFileMoveRequest as n, FileRecordsListV2Query as o, bulkOperationResponseSchema as p, BulkFolderIds as r, FolderBreadcrumbsResponse as s, BulkFileIds as t, bulkFileMoveRequestSchema as u };