@plyaz/api 1.6.5 → 1.6.7

package/dist/api/endpoints/files.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Files endpoints configuration
+ * Endpoints for file upload, download, and document generation via @plyaz/storage
+ *
+ * NOTE: Uses :id (UUID) as path param since files are stored in media table.
+ * Will integrate with db service and media repository for CRUD operations.
+ */
+export declare const filesEndpoints: {
+    readonly uploadFile: {
+        readonly url: "/upload";
+        readonly method: "POST";
+    };
+    readonly uploadFiles: {
+        readonly url: "/upload/bulk";
+        readonly method: "POST";
+    };
+    readonly generateDocument: {
+        readonly url: "/generate-document";
+        readonly method: "POST";
+    };
+    readonly downloadFile: {
+        readonly url: "/files/:id/download";
+        readonly method: "GET";
+    };
+    readonly getSignedUrl: {
+        readonly url: "/files/:id/signed-url";
+        readonly method: "GET";
+    };
+    readonly getFile: {
+        readonly url: "/files/:id";
+        readonly method: "GET";
+    };
+    readonly deleteFile: {
+        readonly url: "/files/:id";
+        readonly method: "DELETE";
+    };
+};
+//# sourceMappingURL=files.d.ts.map

package/dist/api/endpoints/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../src/api/endpoints/files.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCjB,CAAC"}

package/dist/api/endpoints/index.d.ts

@@ -131,6 +131,34 @@ export declare const endpoints: {
         readonly url: "/resources/:resourceId/reserve";
         readonly method: "POST";
     };
+    readonly uploadFile: {
+        readonly url: "/upload";
+        readonly method: "POST";
+    };
+    readonly uploadFiles: {
+        readonly url: "/upload/bulk";
+        readonly method: "POST";
+    };
+    readonly generateDocument: {
+        readonly url: "/generate-document";
+        readonly method: "POST";
+    };
+    readonly downloadFile: {
+        readonly url: "/files/:id/download";
+        readonly method: "GET";
+    };
+    readonly getSignedUrl: {
+        readonly url: "/files/:id/signed-url";
+        readonly method: "GET";
+    };
+    readonly getFile: {
+        readonly url: "/files/:id";
+        readonly method: "GET";
+    };
+    readonly deleteFile: {
+        readonly url: "/files/:id";
+        readonly method: "DELETE";
+    };
     readonly evaluateFeatureFlag: {
         readonly url: "/feature-flags/:key/evaluate";
         readonly method: "POST";
@@ -218,6 +246,7 @@ export type EndpointsList = typeof endpoints;
  */
 export { campaignEndpoints } from './campaigns';
 export { featureFlagEndpoints } from './featureFlags';
+export { filesEndpoints } from './files';
 export { pollingEndpoints } from './polling';
 export { infobipEndpoints, infobipEmailEndpoints } from './infobip';
 export { virusTotalEndpoints } from './virustotal';

package/dist/api/endpoints/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/endpoints/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcZ,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,SAAS,CAAC;AAE7C;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAEhG;;GAEG;AACH,OAAO,EAEL,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,QAAQ,EACR,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAEL,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,GACnB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/endpoints/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBZ,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,SAAS,CAAC;AAE7C;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAEhG;;GAEG;AACH,OAAO,EAEL,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,QAAQ,EACR,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAEL,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/api/services/files/DELETE/deleteFile.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Delete File Service
+ * Deletes a file from storage by ID
+ */
+import type { DeleteFileRequest, ServiceOptions } from '@plyaz/types/api';
+import type { EndpointsList } from '@/api/endpoints';
+import type { FetchResponse } from 'fetchff';
+/**
+ * Delete a file from storage
+ * Uses endpoint: DELETE /files/:id
+ *
+ * @param request - Request with file ID
+ * @param options - Optional service options (client override, config overrides)
+ * @returns Promise<DeleteFileResponse>
+ *
+ * @example
+ * ```typescript
+ * // Delete a file by ID
+ * const result = await deleteFile({ id: '550e8400-e29b-41d4-a716-446655440000' });
+ * if (result.success) {
+ *   console.log('File deleted successfully');
+ * }
+ * ```
+ *
+ * @throws {ApiPackageError} When the file is not found or deletion fails
+ */
+export declare function deleteFile<TEndpoints = EndpointsList>(request: DeleteFileRequest, options?: ServiceOptions<TEndpoints>): Promise<FetchResponse>;
+//# sourceMappingURL=deleteFile.d.ts.map

package/dist/api/services/files/DELETE/deleteFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteFile.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/DELETE/deleteFile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,UAAU,CAAC,UAAU,GAAG,aAAa,EACzD,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,GACnC,OAAO,CAAC,aAAa,CAAC,CA2BxB"}

package/dist/api/services/files/DELETE/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Files DELETE Operations
+ * Exports all DELETE services and hooks for file operations
+ */
+export { deleteFile } from './deleteFile';
+export { useDeleteFile } from './useDeleteFile';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/services/files/DELETE/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/DELETE/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/api/services/files/DELETE/useDeleteFile.d.ts

@@ -0,0 +1,33 @@
+/**
+ * React Query Mutation Hook for Deleting Files
+ * Provides mutation state and cache invalidation
+ */
+import { createApiMutation } from '../../../hooks/factories';
+import type { DeleteFileRequest, DeleteFileResponse, ServiceOptions } from '@plyaz/types/api';
+import type { ErrorResponse } from '@plyaz/types/errors';
+import type { EndpointsList } from '@/api/endpoints';
+/**
+ * Hook for deleting files
+ *
+ * @param serviceOptions - Service options (apiClient, apiConfig, updateConfigOptions)
+ * @param mutationOptions - React Query mutation options
+ * @returns React Query mutation result
+ *
+ * @example
+ * ```typescript
+ * const { mutate, isPending } = useDeleteFile();
+ *
+ * const handleDelete = (fileId: string) => {
+ *   mutate({ id: fileId }, {
+ *     onSuccess: () => {
+ *       toast.success('File deleted');
+ *     },
+ *     onError: (error) => {
+ *       toast.error(`Failed to delete: ${error.message}`);
+ *     }
+ *   });
+ * };
+ * ```
+ */
+export declare function useDeleteFile<TEndpoints = EndpointsList>(serviceOptions?: ServiceOptions<TEndpoints>, mutationOptions?: Parameters<ReturnType<typeof createApiMutation<DeleteFileResponse, ErrorResponse, DeleteFileRequest, unknown, TEndpoints>>>[1]): ReturnType<ReturnType<typeof createApiMutation<DeleteFileResponse, ErrorResponse, DeleteFileRequest, unknown, TEndpoints>>>;
+//# sourceMappingURL=useDeleteFile.d.ts.map

package/dist/api/services/files/DELETE/useDeleteFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeleteFile.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/DELETE/useDeleteFile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,UAAU,GAAG,aAAa,EACtD,cAAc,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,EAC3C,eAAe,CAAC,EAAE,UAAU,CAC1B,UAAU,CACR,OAAO,iBAAiB,CACtB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,OAAO,EACP,UAAU,CACX,CACF,CACF,CAAC,CAAC,CAAC,GACH,UAAU,CACX,UAAU,CACR,OAAO,iBAAiB,CACtB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,OAAO,EACP,UAAU,CACX,CACF,CACF,CA4BA"}

package/dist/api/services/files/GET/downloadFile.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Download File Service
+ * Downloads a file from storage by ID
+ */
+import type { DownloadFileRequest, ServiceOptions } from '@plyaz/types/api';
+import type { EndpointsList } from '@/api/endpoints';
+import type { FetchResponse } from 'fetchff';
+/**
+ * Download a file from storage
+ * Uses endpoint: GET /files/:id/download
+ *
+ * @param request - Request with file ID
+ * @param options - Optional service options (client override, config overrides)
+ * @returns Promise<DownloadFileResponse>
+ *
+ * @example
+ * ```typescript
+ * // Download a file by ID
+ * const result = await downloadFile({ id: '550e8400-e29b-41d4-a716-446655440000' });
+ *
+ * // The result.buffer is base64 encoded
+ * const blob = new Blob([
+ *   Uint8Array.from(atob(result.buffer), c => c.charCodeAt(0))
+ * ], { type: result.mimeType });
+ *
+ * // Create download link
+ * const url = URL.createObjectURL(blob);
+ * const a = document.createElement('a');
+ * a.href = url;
+ * a.download = result.filename || 'download';
+ * a.click();
+ * ```
+ *
+ * @throws {ApiPackageError} When the file is not found or download fails
+ */
+export declare function downloadFile<TEndpoints = EndpointsList>(request: DownloadFileRequest, options?: ServiceOptions<TEndpoints>): Promise<FetchResponse>;
+//# sourceMappingURL=downloadFile.d.ts.map

package/dist/api/services/files/GET/downloadFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloadFile.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/GET/downloadFile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,YAAY,CAAC,UAAU,GAAG,aAAa,EAC3D,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,GACnC,OAAO,CAAC,aAAa,CAAC,CA8BxB"}

package/dist/api/services/files/GET/getFile.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Get File Service
+ * Gets file metadata by ID
+ */
+import type { GetFileRequest, ServiceOptions } from '@plyaz/types/api';
+import type { EndpointsList } from '@/api/endpoints';
+import type { FetchResponse } from 'fetchff';
+/**
+ * Get file metadata by ID
+ * Uses endpoint: GET /files/:id
+ *
+ * @param request - Request with file ID
+ * @param options - Optional service options (client override, config overrides)
+ * @returns Promise<GetFileResponse>
+ *
+ * @example
+ * ```typescript
+ * // Get file metadata
+ * const file = await getFile({ id: '550e8400-e29b-41d4-a716-446655440000' });
+ * console.log(file.filename, file.mimeType, file.size);
+ * ```
+ *
+ * @throws {ApiPackageError} When the file is not found
+ */
+export declare function getFile<TEndpoints = EndpointsList>(request: GetFileRequest, options?: ServiceOptions<TEndpoints>): Promise<FetchResponse>;
+//# sourceMappingURL=getFile.d.ts.map

package/dist/api/services/files/GET/getFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFile.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/GET/getFile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,OAAO,CAAC,UAAU,GAAG,aAAa,EACtD,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,GACnC,OAAO,CAAC,aAAa,CAAC,CA2BxB"}

package/dist/api/services/files/GET/getSignedUrl.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Get Signed URL Service
+ * Gets a temporary signed URL for file access
+ */
+import type { GetSignedUrlRequest, ServiceOptions } from '@plyaz/types/api';
+import type { EndpointsList } from '@/api/endpoints';
+import type { FetchResponse } from 'fetchff';
+/**
+ * Get a signed URL for temporary file access
+ * Uses endpoint: GET /files/:id/signed-url
+ *
+ * @param request - Request with file ID and optional expiration
+ * @param options - Optional service options (client override, config overrides)
+ * @returns Promise<GetSignedUrlResponse>
+ *
+ * @example
+ * ```typescript
+ * // Get a signed URL (default expiration)
+ * const { url, expiresAt } = await getSignedUrl({ id: '550e8400-e29b-41d4-a716-446655440000' });
+ *
+ * // Get a signed URL with custom expiration
+ * const { url } = await getSignedUrl({
+ *   id: '550e8400-e29b-41d4-a716-446655440000',
+ *   query: { expiresIn: 3600 } // 1 hour
+ * });
+ *
+ * // Use the signed URL
+ * window.open(url);
+ * ```
+ *
+ * @throws {ApiPackageError} When the file is not found
+ */
+export declare function getSignedUrl<TEndpoints = EndpointsList>(request: GetSignedUrlRequest, options?: ServiceOptions<TEndpoints>): Promise<FetchResponse>;
+//# sourceMappingURL=getSignedUrl.d.ts.map

package/dist/api/services/files/GET/getSignedUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSignedUrl.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/GET/getSignedUrl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,wBAAsB,YAAY,CAAC,UAAU,GAAG,aAAa,EAC3D,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,GACnC,OAAO,CAAC,aAAa,CAAC,CA4BxB"}

package/dist/api/services/files/GET/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Files GET Operations
+ * Exports all GET services and hooks for file operations
+ */
+export { getFile } from './getFile';
+export { downloadFile } from './downloadFile';
+export { getSignedUrl } from './getSignedUrl';
+export { useGetFile } from './useGetFile';
+export { useDownloadFile } from './useDownloadFile';
+export { useGetSignedUrl } from './useGetSignedUrl';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/services/files/GET/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/GET/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/api/services/files/GET/useDownloadFile.d.ts

@@ -0,0 +1,41 @@
+/**
+ * React Query Hook for Downloading Files
+ * Provides caching and state management for file downloads
+ */
+import type { DownloadFileRequest, DownloadFileResponse, ServiceOptions, QueryKey, UseQueryResult, ApiQueryOptions } from '@plyaz/types/api';
+import type { ErrorResponse } from '@plyaz/types/errors';
+import type { EndpointsList } from '@/api/endpoints';
+/**
+ * Hook for downloading a file
+ *
+ * @param queryKey - React Query cache key
+ * @param request - Request with file ID
+ * @param serviceOptions - Optional service options (apiClient override, apiConfig override)
+ * @param queryOptions - Optional React Query options (enabled, staleTime, etc.)
+ * @returns React Query result with download data
+ *
+ * @example
+ * ```typescript
+ * function FileViewer({ fileId }: Props) {
+ *   const { data, isLoading, error } = useDownloadFile(
+ *     ['file', fileId],
+ *     { id: fileId },
+ *     undefined,
+ *     { enabled: !!fileId }
+ *   );
+ *
+ *   if (isLoading) return <Spinner />;
+ *   if (error) return <ErrorMessage error={error} />;
+ *
+ *   // Convert base64 to blob URL
+ *   const blob = new Blob([
+ *     Uint8Array.from(atob(data.buffer), c => c.charCodeAt(0))
+ *   ], { type: data.mimeType });
+ *   const blobUrl = URL.createObjectURL(blob);
+ *
+ *   return <iframe src={blobUrl} />;
+ * }
+ * ```
+ */
+export declare function useDownloadFile<TEndpoints = EndpointsList>(queryKey: QueryKey, request: DownloadFileRequest, serviceOptions?: ServiceOptions<TEndpoints>, queryOptions?: Omit<ApiQueryOptions<DownloadFileResponse, ErrorResponse>, 'apiClient' | 'apiConfig'>): UseQueryResult<DownloadFileResponse, ErrorResponse>;
+//# sourceMappingURL=useDownloadFile.d.ts.map

package/dist/api/services/files/GET/useDownloadFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDownloadFile.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/GET/useDownloadFile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,cAAc,EACd,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,eAAe,CAAC,UAAU,GAAG,aAAa,EACxD,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,mBAAmB,EAC5B,cAAc,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,EAC3C,YAAY,CAAC,EAAE,IAAI,CACjB,eAAe,CAAC,oBAAoB,EAAE,aAAa,CAAC,EACpD,WAAW,GAAG,WAAW,CAC1B,GACA,cAAc,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAarD"}

package/dist/api/services/files/GET/useGetFile.d.ts

@@ -0,0 +1,31 @@
+/**
+ * React Query Hook for Getting File Metadata
+ * Provides query state and caching
+ */
+import type { GetFileRequest, GetFileResponse, ServiceOptions, QueryKey, UseQueryResult, ApiQueryOptions } from '@plyaz/types/api';
+import type { ErrorResponse } from '@plyaz/types/errors';
+import type { EndpointsList } from '@/api/endpoints';
+/**
+ * Hook for getting file metadata
+ *
+ * @param queryKey - React Query cache key
+ * @param request - Request with file ID
+ * @param serviceOptions - Service options (apiClient, apiConfig, updateConfigOptions)
+ * @param queryOptions - React Query options
+ * @returns React Query result
+ *
+ * @example
+ * ```typescript
+ * const { data: file, isLoading } = useGetFile(
+ *   ['file', fileId],
+ *   { id: fileId },
+ *   undefined,
+ *   { enabled: !!fileId }
+ * );
+ *
+ * if (isLoading) return <Spinner />;
+ * return <div>{file.filename} - {file.size} bytes</div>;
+ * ```
+ */
+export declare function useGetFile<TEndpoints = EndpointsList>(queryKey: QueryKey, request: GetFileRequest, serviceOptions?: ServiceOptions<TEndpoints>, queryOptions?: Omit<ApiQueryOptions<GetFileResponse, ErrorResponse>, 'apiClient' | 'apiConfig'>): UseQueryResult<GetFileResponse, ErrorResponse>;
+//# sourceMappingURL=useGetFile.d.ts.map

package/dist/api/services/files/GET/useGetFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGetFile.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/GET/useGetFile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,QAAQ,EACR,cAAc,EACd,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CAAC,UAAU,GAAG,aAAa,EACnD,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,cAAc,EACvB,cAAc,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,EAC3C,YAAY,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,eAAe,EAAE,aAAa,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC,GAC9F,cAAc,CAAC,eAAe,EAAE,aAAa,CAAC,CAahD"}

package/dist/api/services/files/GET/useGetSignedUrl.d.ts

@@ -0,0 +1,40 @@
+/**
+ * React Query Hook for Getting Signed URLs
+ * Provides caching and state management for signed URL generation
+ */
+import type { GetSignedUrlRequest, GetSignedUrlResponse, ServiceOptions, QueryKey, UseQueryResult, ApiQueryOptions } from '@plyaz/types/api';
+import type { ErrorResponse } from '@plyaz/types/errors';
+import type { EndpointsList } from '@/api/endpoints';
+/**
+ * Hook for getting signed URLs
+ *
+ * Note: Signed URLs expire, so consider short staleTime values
+ * or refetch on window focus for security-sensitive scenarios.
+ *
+ * @param queryKey - React Query cache key
+ * @param request - Request with file ID and optional expiration
+ * @param serviceOptions - Optional service options (apiClient override, apiConfig override)
+ * @param queryOptions - Optional React Query options (enabled, staleTime, etc.)
+ * @returns React Query result with signed URL data
+ *
+ * @example
+ * ```typescript
+ * function FileLink({ fileId }: Props) {
+ *   const { data, isLoading } = useGetSignedUrl(
+ *     ['signedUrl', fileId],
+ *     { id: fileId, query: { expiresIn: 300 } }, // 5 minutes
+ *     undefined,
+ *     {
+ *       enabled: !!fileId,
+ *       staleTime: 4 * 60 * 1000, // Refetch 1 minute before expiry
+ *     }
+ *   );
+ *
+ *   if (isLoading) return <Spinner />;
+ *
+ *   return <a href={data?.url}>Download File</a>;
+ * }
+ * ```
+ */
+export declare function useGetSignedUrl<TEndpoints = EndpointsList>(queryKey: QueryKey, request: GetSignedUrlRequest, serviceOptions?: ServiceOptions<TEndpoints>, queryOptions?: Omit<ApiQueryOptions<GetSignedUrlResponse, ErrorResponse>, 'apiClient' | 'apiConfig'>): UseQueryResult<GetSignedUrlResponse, ErrorResponse>;
+//# sourceMappingURL=useGetSignedUrl.d.ts.map

package/dist/api/services/files/GET/useGetSignedUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGetSignedUrl.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/GET/useGetSignedUrl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,cAAc,EACd,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,eAAe,CAAC,UAAU,GAAG,aAAa,EACxD,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,mBAAmB,EAC5B,cAAc,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,EAC3C,YAAY,CAAC,EAAE,IAAI,CACjB,eAAe,CAAC,oBAAoB,EAAE,aAAa,CAAC,EACpD,WAAW,GAAG,WAAW,CAC1B,GACA,cAAc,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAarD"}

package/dist/api/services/files/POST/generateDocument.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Generate Document Service
+ * Generates a document from a template without uploading
+ */
+import type { GenerateDocumentRequest } from '@plyaz/types/api';
+import type { ServiceOptions } from '@plyaz/types/api';
+import type { EndpointsList } from '@/api/endpoints';
+import type { FetchResponse } from 'fetchff';
+/**
+ * Generate a document from a template
+ * Uses endpoint: POST /generate-document
+ *
+ * Returns the generated document as a base64-encoded buffer without uploading.
+ * Useful for preview or direct download scenarios.
+ *
+ * @param data - Document generation request data
+ * @param options - Optional service options (client override, config overrides)
+ * @returns Promise<GenerateDocumentResponse>
+ *
+ * @example
+ * ```typescript
+ * // Generate a PDF invoice
+ * const result = await generateDocument({
+ *   templateId: 'invoices/standard-invoice',
+ *   templateData: {
+ *     invoiceNumber: 'INV-001',
+ *     customerName: 'John Doe',
+ *     items: [{ description: 'Product', quantity: 2, unitPrice: 50 }],
+ *   },
+ *   outputFormat: 'pdf',
+ * });
+ *
+ * // The result.buffer is base64 encoded
+ * const pdfBlob = new Blob([
+ *   Uint8Array.from(atob(result.buffer), c => c.charCodeAt(0))
+ * ], { type: 'application/pdf' });
+ * ```
+ *
+ * @throws {ApiPackageError} When document generation fails
+ */
+export declare function generateDocument<TEndpoints = EndpointsList>(data: GenerateDocumentRequest, options?: ServiceOptions<TEndpoints>): Promise<FetchResponse>;
+//# sourceMappingURL=generateDocument.d.ts.map

package/dist/api/services/files/POST/generateDocument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateDocument.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/POST/generateDocument.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,GAAG,aAAa,EAC/D,IAAI,EAAE,uBAAuB,EAC7B,OAAO,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,GACnC,OAAO,CAAC,aAAa,CAAC,CAqBxB"}

package/dist/api/services/files/POST/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Files POST Operations
+ * Exports all POST services and hooks for file operations
+ */
+export { uploadFile } from './uploadFile';
+export { uploadFiles } from './uploadFiles';
+export { generateDocument } from './generateDocument';
+export { useUploadFile } from './useUploadFile';
+export { useUploadFiles } from './useUploadFiles';
+export { useGenerateDocument } from './useGenerateDocument';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/services/files/POST/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/POST/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/api/services/files/POST/uploadFile.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Upload File Service
+ * Uploads a file to storage with optional template-based generation
+ */
+import type { UploadFileRequest } from '@plyaz/types/api';
+import type { ServiceOptions } from '@plyaz/types/api';
+import type { EndpointsList } from '@/api/endpoints';
+import type { FetchResponse } from 'fetchff';
+/**
+ * Upload a file to storage
+ * Uses endpoint: POST /upload
+ *
+ * Supports:
+ * - Direct file upload (with metadata)
+ * - Template-based document generation (when templateId is provided)
+ *
+ * @param data - Upload request data
+ * @param options - Optional service options (client override, config overrides)
+ * @returns Promise<UploadFileResponse>
+ *
+ * @example
+ * ```typescript
+ * // Template-based generation with upload
+ * const result = await uploadFile({
+ *   templateId: 'invoices/standard-invoice',
+ *   templateData: { invoiceNumber: 'INV-001', total: 100 },
+ *   filename: 'invoice.pdf',
+ *   outputFormat: 'pdf',
+ * });
+ *
+ * // With custom timeout for large files
+ * const result = await uploadFile(data, {
+ *   apiConfig: { timeout: 120000 }
+ * });
+ * ```
+ *
+ * @throws {ApiPackageError} When the upload fails
+ */
+export declare function uploadFile<TEndpoints = EndpointsList>(data: UploadFileRequest, options?: ServiceOptions<TEndpoints>): Promise<FetchResponse>;
+//# sourceMappingURL=uploadFile.d.ts.map

package/dist/api/services/files/POST/uploadFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadFile.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/POST/uploadFile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,UAAU,CAAC,UAAU,GAAG,aAAa,EACzD,IAAI,EAAE,iBAAiB,EACvB,OAAO,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,GACnC,OAAO,CAAC,aAAa,CAAC,CAqBxB"}

package/dist/api/services/files/POST/uploadFiles.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Upload Files (Bulk) Service
+ * Uploads multiple files to storage with concurrency control
+ */
+import type { UploadFilesRequest } from '@plyaz/types/api';
+import type { ServiceOptions } from '@plyaz/types/api';
+import type { EndpointsList } from '@/api/endpoints';
+import type { FetchResponse } from 'fetchff';
+/**
+ * Upload multiple files to storage
+ * Uses endpoint: POST /upload/bulk
+ *
+ * Supports:
+ * - Parallel uploads with concurrency control
+ * - Continue on error (partial success)
+ * - Queue mode for background processing
+ *
+ * @param data - Bulk upload request data (files array + options)
+ * @param options - Optional service options (client override, config overrides)
+ * @returns Promise<UploadFilesResponse>
+ *
+ * @example
+ * ```typescript
+ * // Upload multiple files with default concurrency
+ * const result = await uploadFiles({
+ *   files: [
+ *     { base64: '...', mimeType: 'image/png', category: 'images', entityType: 'user', entityId: 'user-1' },
+ *     { base64: '...', mimeType: 'image/jpeg', category: 'images', entityType: 'user', entityId: 'user-1' },
+ *   ]
+ * });
+ *
+ * // With concurrency control and continue on error
+ * const result = await uploadFiles({
+ *   files: [...],
+ *   options: {
+ *     concurrency: 3,
+ *     continueOnError: true
+ *   }
+ * });
+ *
+ * // Check results
+ * console.log(result.summary); // { total: 5, succeeded: 4, failed: 1 }
+ * console.log(result.allSucceeded); // false
+ * ```
+ *
+ * @throws {ApiPackageError} When all uploads fail (unless continueOnError is true)
+ */
+export declare function uploadFiles<TEndpoints = EndpointsList>(data: UploadFilesRequest, options?: ServiceOptions<TEndpoints>): Promise<FetchResponse>;
+//# sourceMappingURL=uploadFiles.d.ts.map

package/dist/api/services/files/POST/uploadFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadFiles.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/POST/uploadFiles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,WAAW,CAAC,UAAU,GAAG,aAAa,EAC1D,IAAI,EAAE,kBAAkB,EACxB,OAAO,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,GACnC,OAAO,CAAC,aAAa,CAAC,CAqBxB"}

package/dist/api/services/files/POST/useGenerateDocument.d.ts

@@ -0,0 +1,39 @@
+/**
+ * React Query Mutation Hook for Generating Documents
+ * Provides mutation state for document generation
+ */
+import { createApiMutation } from '../../../hooks/factories';
+import type { GenerateDocumentRequest, GenerateDocumentResponse, ServiceOptions } from '@plyaz/types/api';
+import type { ErrorResponse } from '@plyaz/types/errors';
+import type { EndpointsList } from '@/api/endpoints';
+/**
+ * Hook for generating documents
+ *
+ * @param serviceOptions - Service options (apiClient, apiConfig, updateConfigOptions)
+ * @param mutationOptions - React Query mutation options
+ * @returns React Query mutation result
+ *
+ * @example
+ * ```typescript
+ * const { mutate, isPending, data } = useGenerateDocument();
+ *
+ * const handleGenerate = () => {
+ *   mutate({
+ *     templateId: 'invoices/standard',
+ *     templateData: { invoiceNumber: 'INV-001', total: 100 },
+ *     outputFormat: 'pdf',
+ *   }, {
+ *     onSuccess: (result) => {
+ *       // Convert base64 to blob and download
+ *       const blob = new Blob([
+ *         Uint8Array.from(atob(result.buffer), c => c.charCodeAt(0))
+ *       ], { type: 'application/pdf' });
+ *       const url = URL.createObjectURL(blob);
+ *       window.open(url);
+ *     }
+ *   });
+ * };
+ * ```
+ */
+export declare function useGenerateDocument<TEndpoints = EndpointsList>(serviceOptions?: ServiceOptions<TEndpoints>, mutationOptions?: Parameters<ReturnType<typeof createApiMutation<GenerateDocumentResponse, ErrorResponse, GenerateDocumentRequest, unknown, TEndpoints>>>[1]): ReturnType<ReturnType<typeof createApiMutation<GenerateDocumentResponse, ErrorResponse, GenerateDocumentRequest, unknown, TEndpoints>>>;
+//# sourceMappingURL=useGenerateDocument.d.ts.map

package/dist/api/services/files/POST/useGenerateDocument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGenerateDocument.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/POST/useGenerateDocument.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,GAAG,aAAa,EAC5D,cAAc,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,EAC3C,eAAe,CAAC,EAAE,UAAU,CAC1B,UAAU,CACR,OAAO,iBAAiB,CACtB,wBAAwB,EACxB,aAAa,EACb,uBAAuB,EACvB,OAAO,EACP,UAAU,CACX,CACF,CACF,CAAC,CAAC,CAAC,GACH,UAAU,CACX,UAAU,CACR,OAAO,iBAAiB,CACtB,wBAAwB,EACxB,aAAa,EACb,uBAAuB,EACvB,OAAO,EACP,UAAU,CACX,CACF,CACF,CAWA"}