@plyaz/types 1.30.0 → 1.31.1

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

@@ -0,0 +1,89 @@
+/**
+ * Files Endpoint Type Definitions
+ *
+ * Uses fetchff's Endpoint and Req types for type-safe API definitions.
+ *
+ * Req<TResponse, TBody?, TParams?> generic parameters:
+ * - TResponse: The response type returned by the endpoint
+ * - TBody: The request body type (use 'never' for GET/DELETE)
+ * - TParams: URL path parameters type (use 'never' if no path params)
+ */
+import type { Endpoint, Req } from 'fetchff';
+import type { UploadFileRequest, UploadFileResponse, UploadFilesRequest, UploadFilesResponse, GenerateDocumentRequest, GenerateDocumentResponse, GetFileParams, GetFileResponse, DownloadFileParams, DownloadFileResponse, DeleteFileParams, DeleteFileResponse, GetSignedUrlParams, GetSignedUrlQuery, GetSignedUrlResponse } from './schemas';
+/**
+ * Files API endpoint types.
+ * Complete type definitions for file operation endpoints.
+ */
+export interface FilesEndpointTypes {
+    /**
+     * POST /upload - Upload a file
+     * Supports template-based document generation when templateId is provided.
+     *
+     * Req<Response, Body>
+     * - Response: UploadFileResponse
+     * - Body: UploadFileRequest
+     */
+    uploadFile: Endpoint<Req<UploadFileResponse, UploadFileRequest>>;
+    /**
+     * POST /upload/bulk - Upload multiple files
+     * Uses uploadMultipleFiles() with concurrency control.
+     *
+     * Req<Response, Body>
+     * - Response: UploadFilesResponse
+     * - Body: UploadFilesRequest
+     */
+    uploadFiles: Endpoint<Req<UploadFilesResponse, UploadFilesRequest>>;
+    /**
+     * POST /generate-document - Generate document from template
+     * Returns base64 encoded buffer, no upload to storage.
+     *
+     * Req<Response, Body>
+     * - Response: GenerateDocumentResponse
+     * - Body: GenerateDocumentRequest
+     */
+    generateDocument: Endpoint<Req<GenerateDocumentResponse, GenerateDocumentRequest>>;
+    /**
+     * GET /files/:id - Get file metadata
+     *
+     * Req<Response, Body, Query, Params>
+     * - Response: GetFileResponse
+     * - Body: never (GET has no body)
+     * - Query: never (no query params)
+     * - Params: GetFileParams (path params)
+     */
+    getFile: Endpoint<Req<GetFileResponse, never, never, GetFileParams>>;
+    /**
+     * GET /files/:id/download - Download a file
+     *
+     * Req<Response, Body, Query, Params>
+     * - Response: DownloadFileResponse
+     * - Body: never (GET has no body)
+     * - Query: never (no query params)
+     * - Params: DownloadFileParams (path params)
+     */
+    downloadFile: Endpoint<Req<DownloadFileResponse, never, never, DownloadFileParams>>;
+    /**
+     * GET /files/:id/signed-url - Get signed URL for temporary access
+     *
+     * Req<Response, Body, Query, Params>
+     * - Response: GetSignedUrlResponse
+     * - Body: never (GET has no body)
+     * - Query: GetSignedUrlQuery (expiresIn)
+     * - Params: GetSignedUrlParams (path params)
+     */
+    getSignedUrl: Endpoint<Req<GetSignedUrlResponse, never, GetSignedUrlQuery, GetSignedUrlParams>>;
+    /**
+     * DELETE /files/:id - Delete a file
+     *
+     * Req<Response, Body, Query, Params>
+     * - Response: DeleteFileResponse
+     * - Body: never (DELETE typically has no body)
+     * - Query: never (no query params)
+     * - Params: DeleteFileParams (path params)
+     */
+    deleteFile: Endpoint<Req<DeleteFileResponse, never, never, DeleteFileParams>>;
+}
+/**
+ * Type guard for files endpoint keys.
+ */
+export type FilesEndpointKey = keyof FilesEndpointTypes;

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

@@ -0,0 +1,9 @@
+/**
+ * Files API Endpoint Types
+ * Export all file operation types and schemas
+ *
+ * Single source of truth: types are inferred from Zod schemas
+ */
+export type { FilesEndpointTypes, FilesEndpointKey } from './endpoints';
+export { OutputFormatSchema, AccessLevelSchema, PdfOptionsSchema, FileVariantSchema, UploadFileRequestSchema, UploadFileResponseSchema, UploadFileItemSchema, UploadFilesRequestSchema, UploadFileResultSchema, UploadFilesResponseSchema, GenerateDocumentRequestSchema, GenerateDocumentResponseSchema, GetFileParamsSchema, GetFileRequestSchema, GetFileResponseSchema, DownloadFileParamsSchema, DownloadFileRequestSchema, DownloadFileResponseSchema, DeleteFileParamsSchema, DeleteFileRequestSchema, DeleteFileResponseSchema, GetSignedUrlParamsSchema, GetSignedUrlQuerySchema, GetSignedUrlRequestSchema, GetSignedUrlResponseSchema, } from './schemas';
+export type { OutputFormat, AccessLevel, PdfOptions, FileVariant, UploadFileRequest, UploadFileResponse, UploadFileItem, UploadFilesRequest, UploadFileResult, UploadFilesResponse, GenerateDocumentRequest, GenerateDocumentResponse, GetFileParams, GetFileRequest, GetFileResponse, DownloadFileParams, DownloadFileRequest, DownloadFileResponse, DeleteFileParams, DeleteFileRequest, DeleteFileResponse, GetSignedUrlParams, GetSignedUrlQuery, GetSignedUrlRequest, GetSignedUrlResponse, } from './schemas';

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

@@ -0,0 +1,487 @@
+/**
+ * Files API Zod Schemas
+ * @module @plyaz/types/api/endpoints/files/schemas
+ *
+ * Validation schemas and types for file operations API endpoints.
+ * Single source of truth - types are inferred from schemas.
+ */
+import { z } from 'zod';
+/**
+ * Output format for template-based document generation
+ */
+export declare const OutputFormatSchema: z.ZodEnum<{
+    pdf: "pdf";
+    docx: "docx";
+    xlsx: "xlsx";
+    html: "html";
+}>;
+export type OutputFormat = z.infer<typeof OutputFormatSchema>;
+/**
+ * Access level for files
+ */
+export declare const AccessLevelSchema: z.ZodEnum<{
+    public: "public";
+    private: "private";
+    protected: "protected";
+}>;
+export type AccessLevel = z.infer<typeof AccessLevelSchema>;
+/**
+ * PDF render options
+ */
+export declare const PdfOptionsSchema: z.ZodOptional<z.ZodObject<{
+    format: z.ZodOptional<z.ZodEnum<{
+        A4: "A4";
+        Letter: "Letter";
+        Legal: "Legal";
+    }>>;
+    landscape: z.ZodOptional<z.ZodBoolean>;
+    margin: z.ZodOptional<z.ZodObject<{
+        top: z.ZodOptional<z.ZodString>;
+        right: z.ZodOptional<z.ZodString>;
+        bottom: z.ZodOptional<z.ZodString>;
+        left: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    displayHeaderFooter: z.ZodOptional<z.ZodBoolean>;
+    headerTemplate: z.ZodOptional<z.ZodString>;
+    footerTemplate: z.ZodOptional<z.ZodString>;
+    printBackground: z.ZodOptional<z.ZodBoolean>;
+    scale: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+export type PdfOptions = z.infer<typeof PdfOptionsSchema>;
+/**
+ * Upload file request schema
+ *
+ * Supports multiple upload modes:
+ * - Direct upload: base64 + mimeType
+ * - Template generation: templateId + templateData
+ */
+export declare const UploadFileRequestSchema: z.ZodObject<{
+    base64: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    templateId: z.ZodOptional<z.ZodString>;
+    templateData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    outputFormat: z.ZodOptional<z.ZodEnum<{
+        pdf: "pdf";
+        docx: "docx";
+        xlsx: "xlsx";
+        html: "html";
+    }>>;
+    locale: z.ZodOptional<z.ZodString>;
+    pdfOptions: z.ZodOptional<z.ZodObject<{
+        format: z.ZodOptional<z.ZodEnum<{
+            A4: "A4";
+            Letter: "Letter";
+            Legal: "Legal";
+        }>>;
+        landscape: z.ZodOptional<z.ZodBoolean>;
+        margin: z.ZodOptional<z.ZodObject<{
+            top: z.ZodOptional<z.ZodString>;
+            right: z.ZodOptional<z.ZodString>;
+            bottom: z.ZodOptional<z.ZodString>;
+            left: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        displayHeaderFooter: z.ZodOptional<z.ZodBoolean>;
+        headerTemplate: z.ZodOptional<z.ZodString>;
+        footerTemplate: z.ZodOptional<z.ZodString>;
+        printBackground: z.ZodOptional<z.ZodBoolean>;
+        scale: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    category: z.ZodString;
+    entityType: z.ZodString;
+    entityId: z.ZodString;
+    accessLevel: z.ZodOptional<z.ZodEnum<{
+        public: "public";
+        private: "private";
+        protected: "protected";
+    }>>;
+    customMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    customPath: z.ZodOptional<z.ZodString>;
+    ttl: z.ZodOptional<z.ZodNumber>;
+    immutable: z.ZodOptional<z.ZodBoolean>;
+    extractMetadata: z.ZodOptional<z.ZodBoolean>;
+    virusScan: z.ZodOptional<z.ZodBoolean>;
+    processMedia: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type UploadFileRequest = z.input<typeof UploadFileRequestSchema>;
+/**
+ * File variant schema (for generated thumbnails, etc.)
+ */
+export declare const FileVariantSchema: z.ZodObject<{
+    url: z.ZodString;
+    size: z.ZodNumber;
+    mimeType: z.ZodString;
+}, z.core.$strip>;
+export type FileVariant = z.infer<typeof FileVariantSchema>;
+/**
+ * Upload file response schema
+ */
+export declare const UploadFileResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    key: z.ZodString;
+    filename: z.ZodString;
+    mimeType: z.ZodString;
+    size: z.ZodNumber;
+    checksum: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    publicUrl: z.ZodOptional<z.ZodString>;
+    signedUrl: z.ZodOptional<z.ZodString>;
+    bucket: z.ZodString;
+    adapter: z.ZodOptional<z.ZodString>;
+    entityType: z.ZodOptional<z.ZodString>;
+    entityId: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    uploadedAt: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodString>;
+    variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        url: z.ZodString;
+        size: z.ZodNumber;
+        mimeType: z.ZodString;
+    }, z.core.$strip>>>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type UploadFileResponse = z.infer<typeof UploadFileResponseSchema>;
+/**
+ * Single file item for bulk upload (reuses UploadFileRequestSchema fields)
+ */
+export declare const UploadFileItemSchema: z.ZodObject<{
+    base64: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    templateId: z.ZodOptional<z.ZodString>;
+    templateData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    outputFormat: z.ZodOptional<z.ZodEnum<{
+        pdf: "pdf";
+        docx: "docx";
+        xlsx: "xlsx";
+        html: "html";
+    }>>;
+    locale: z.ZodOptional<z.ZodString>;
+    pdfOptions: z.ZodOptional<z.ZodObject<{
+        format: z.ZodOptional<z.ZodEnum<{
+            A4: "A4";
+            Letter: "Letter";
+            Legal: "Legal";
+        }>>;
+        landscape: z.ZodOptional<z.ZodBoolean>;
+        margin: z.ZodOptional<z.ZodObject<{
+            top: z.ZodOptional<z.ZodString>;
+            right: z.ZodOptional<z.ZodString>;
+            bottom: z.ZodOptional<z.ZodString>;
+            left: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        displayHeaderFooter: z.ZodOptional<z.ZodBoolean>;
+        headerTemplate: z.ZodOptional<z.ZodString>;
+        footerTemplate: z.ZodOptional<z.ZodString>;
+        printBackground: z.ZodOptional<z.ZodBoolean>;
+        scale: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    category: z.ZodString;
+    entityType: z.ZodString;
+    entityId: z.ZodString;
+    accessLevel: z.ZodOptional<z.ZodEnum<{
+        public: "public";
+        private: "private";
+        protected: "protected";
+    }>>;
+    customMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    customPath: z.ZodOptional<z.ZodString>;
+    ttl: z.ZodOptional<z.ZodNumber>;
+    immutable: z.ZodOptional<z.ZodBoolean>;
+    extractMetadata: z.ZodOptional<z.ZodBoolean>;
+    virusScan: z.ZodOptional<z.ZodBoolean>;
+    processMedia: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type UploadFileItem = z.input<typeof UploadFileItemSchema>;
+/**
+ * Bulk upload request schema
+ * Wraps an array of files with upload options
+ */
+export declare const UploadFilesRequestSchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        base64: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        filename: z.ZodOptional<z.ZodString>;
+        templateId: z.ZodOptional<z.ZodString>;
+        templateData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        outputFormat: z.ZodOptional<z.ZodEnum<{
+            pdf: "pdf";
+            docx: "docx";
+            xlsx: "xlsx";
+            html: "html";
+        }>>;
+        locale: z.ZodOptional<z.ZodString>;
+        pdfOptions: z.ZodOptional<z.ZodObject<{
+            format: z.ZodOptional<z.ZodEnum<{
+                A4: "A4";
+                Letter: "Letter";
+                Legal: "Legal";
+            }>>;
+            landscape: z.ZodOptional<z.ZodBoolean>;
+            margin: z.ZodOptional<z.ZodObject<{
+                top: z.ZodOptional<z.ZodString>;
+                right: z.ZodOptional<z.ZodString>;
+                bottom: z.ZodOptional<z.ZodString>;
+                left: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            displayHeaderFooter: z.ZodOptional<z.ZodBoolean>;
+            headerTemplate: z.ZodOptional<z.ZodString>;
+            footerTemplate: z.ZodOptional<z.ZodString>;
+            printBackground: z.ZodOptional<z.ZodBoolean>;
+            scale: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        category: z.ZodString;
+        entityType: z.ZodString;
+        entityId: z.ZodString;
+        accessLevel: z.ZodOptional<z.ZodEnum<{
+            public: "public";
+            private: "private";
+            protected: "protected";
+        }>>;
+        customMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        customPath: z.ZodOptional<z.ZodString>;
+        ttl: z.ZodOptional<z.ZodNumber>;
+        immutable: z.ZodOptional<z.ZodBoolean>;
+        extractMetadata: z.ZodOptional<z.ZodBoolean>;
+        virusScan: z.ZodOptional<z.ZodBoolean>;
+        processMedia: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    options: z.ZodOptional<z.ZodObject<{
+        concurrency: z.ZodOptional<z.ZodNumber>;
+        continueOnError: z.ZodOptional<z.ZodBoolean>;
+        useQueue: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type UploadFilesRequest = z.input<typeof UploadFilesRequestSchema>;
+/**
+ * Single file result in bulk upload response
+ */
+export declare const UploadFileResultSchema: z.ZodObject<{
+    index: z.ZodNumber;
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        key: z.ZodString;
+        filename: z.ZodString;
+        mimeType: z.ZodString;
+        size: z.ZodNumber;
+        checksum: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        publicUrl: z.ZodOptional<z.ZodString>;
+        signedUrl: z.ZodOptional<z.ZodString>;
+        bucket: z.ZodString;
+        adapter: z.ZodOptional<z.ZodString>;
+        entityType: z.ZodOptional<z.ZodString>;
+        entityId: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        uploadedAt: z.ZodString;
+        expiresAt: z.ZodOptional<z.ZodString>;
+        variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            url: z.ZodString;
+            size: z.ZodNumber;
+            mimeType: z.ZodString;
+        }, z.core.$strip>>>;
+        warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type UploadFileResult = z.infer<typeof UploadFileResultSchema>;
+/**
+ * Bulk upload response schema
+ */
+export declare const UploadFilesResponseSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        success: z.ZodBoolean;
+        data: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            key: z.ZodString;
+            filename: z.ZodString;
+            mimeType: z.ZodString;
+            size: z.ZodNumber;
+            checksum: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodString>;
+            publicUrl: z.ZodOptional<z.ZodString>;
+            signedUrl: z.ZodOptional<z.ZodString>;
+            bucket: z.ZodString;
+            adapter: z.ZodOptional<z.ZodString>;
+            entityType: z.ZodOptional<z.ZodString>;
+            entityId: z.ZodOptional<z.ZodString>;
+            category: z.ZodOptional<z.ZodString>;
+            uploadedAt: z.ZodString;
+            expiresAt: z.ZodOptional<z.ZodString>;
+            variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                url: z.ZodString;
+                size: z.ZodNumber;
+                mimeType: z.ZodString;
+            }, z.core.$strip>>>;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    summary: z.ZodObject<{
+        total: z.ZodNumber;
+        succeeded: z.ZodNumber;
+        failed: z.ZodNumber;
+    }, z.core.$strip>;
+    allSucceeded: z.ZodBoolean;
+}, z.core.$strip>;
+export type UploadFilesResponse = z.infer<typeof UploadFilesResponseSchema>;
+/**
+ * Generate document request schema
+ */
+export declare const GenerateDocumentRequestSchema: z.ZodObject<{
+    templateId: z.ZodString;
+    templateData: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    outputFormat: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        pdf: "pdf";
+        docx: "docx";
+        xlsx: "xlsx";
+        html: "html";
+    }>>>;
+    locale: z.ZodOptional<z.ZodString>;
+    pdfOptions: z.ZodOptional<z.ZodObject<{
+        format: z.ZodOptional<z.ZodEnum<{
+            A4: "A4";
+            Letter: "Letter";
+            Legal: "Legal";
+        }>>;
+        landscape: z.ZodOptional<z.ZodBoolean>;
+        margin: z.ZodOptional<z.ZodObject<{
+            top: z.ZodOptional<z.ZodString>;
+            right: z.ZodOptional<z.ZodString>;
+            bottom: z.ZodOptional<z.ZodString>;
+            left: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        displayHeaderFooter: z.ZodOptional<z.ZodBoolean>;
+        headerTemplate: z.ZodOptional<z.ZodString>;
+        footerTemplate: z.ZodOptional<z.ZodString>;
+        printBackground: z.ZodOptional<z.ZodBoolean>;
+        scale: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type GenerateDocumentRequest = z.input<typeof GenerateDocumentRequestSchema>;
+/**
+ * Generate document response schema
+ */
+export declare const GenerateDocumentResponseSchema: z.ZodObject<{
+    buffer: z.ZodString;
+    size: z.ZodNumber;
+}, z.core.$strip>;
+export type GenerateDocumentResponse = z.infer<typeof GenerateDocumentResponseSchema>;
+/**
+ * Get file params schema
+ */
+export declare const GetFileParamsSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export type GetFileParams = z.input<typeof GetFileParamsSchema>;
+/**
+ * Get file request schema (for service layer)
+ */
+export declare const GetFileRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export type GetFileRequest = z.input<typeof GetFileRequestSchema>;
+/**
+ * Get file response schema
+ */
+export declare const GetFileResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    key: z.ZodString;
+    filename: z.ZodString;
+    mimeType: z.ZodString;
+    size: z.ZodNumber;
+    checksum: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    publicUrl: z.ZodOptional<z.ZodString>;
+    signedUrl: z.ZodOptional<z.ZodString>;
+    bucket: z.ZodString;
+    entityType: z.ZodOptional<z.ZodString>;
+    entityId: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    uploadedAt: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GetFileResponse = z.infer<typeof GetFileResponseSchema>;
+/**
+ * Download file params schema
+ */
+export declare const DownloadFileParamsSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export type DownloadFileParams = z.input<typeof DownloadFileParamsSchema>;
+/**
+ * Download file request schema (for service layer)
+ */
+export declare const DownloadFileRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export type DownloadFileRequest = z.input<typeof DownloadFileRequestSchema>;
+/**
+ * Download file response schema
+ */
+export declare const DownloadFileResponseSchema: z.ZodObject<{
+    buffer: z.ZodString;
+    size: z.ZodNumber;
+    mimeType: z.ZodString;
+    filename: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DownloadFileResponse = z.infer<typeof DownloadFileResponseSchema>;
+/**
+ * Delete file params schema
+ */
+export declare const DeleteFileParamsSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export type DeleteFileParams = z.input<typeof DeleteFileParamsSchema>;
+/**
+ * Delete file request schema (for service layer)
+ */
+export declare const DeleteFileRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export type DeleteFileRequest = z.input<typeof DeleteFileRequestSchema>;
+/**
+ * Delete file response schema
+ */
+export declare const DeleteFileResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+}, z.core.$strip>;
+export type DeleteFileResponse = z.infer<typeof DeleteFileResponseSchema>;
+/**
+ * Get signed URL params schema
+ */
+export declare const GetSignedUrlParamsSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export type GetSignedUrlParams = z.input<typeof GetSignedUrlParamsSchema>;
+/**
+ * Get signed URL query schema
+ */
+export declare const GetSignedUrlQuerySchema: z.ZodObject<{
+    expiresIn: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type GetSignedUrlQuery = z.input<typeof GetSignedUrlQuerySchema>;
+/**
+ * Get signed URL request schema (for service layer)
+ * Combines path params and optional query params
+ */
+export declare const GetSignedUrlRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    query: z.ZodOptional<z.ZodObject<{
+        expiresIn: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type GetSignedUrlRequest = z.input<typeof GetSignedUrlRequestSchema>;
+/**
+ * Get signed URL response schema
+ */
+export declare const GetSignedUrlResponseSchema: z.ZodObject<{
+    url: z.ZodString;
+    expiresAt: z.ZodString;
+}, z.core.$strip>;
+export type GetSignedUrlResponse = z.infer<typeof GetSignedUrlResponseSchema>;

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

@@ -1,5 +1,6 @@
 export type * from './campaigns';
 export type * from './featureFlags';
+export type * from './files';
 export type * from './health';
 export type * from './infobip';
 export type * from './virustotal';

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

@@ -5,6 +5,7 @@ import type { VirusTotalEndpointTypes } from './virustotal';
 import type { CloudflareEndpointTypes, CloudFrontEndpointTypes, FastlyEndpointTypes } from './cdn';
 import type { FeatureFlagEndpointTypes } from './featureFlags';
 import type { PaymentEndpointTypes } from './payments';
+import type { FilesEndpointTypes } from './files';
 /**
  * Query parameters type - matches fetchff's flexible param handling
  * Supports objects, URLSearchParams, and arrays of name-value pairs
@@ -13,5 +14,5 @@ export type QueryParams = Record<string, string | number | boolean | string[] |
 /**
  * All endpoint types combined
  */
-export interface EndpointTypes extends CampaignEndpointTypes, PaymentEndpointTypes, PollingEndpointTypes, InfobipEndpointTypes, VirusTotalEndpointTypes, CloudflareEndpointTypes, CloudFrontEndpointTypes, FastlyEndpointTypes, FeatureFlagEndpointTypes {
+export interface EndpointTypes extends CampaignEndpointTypes, PaymentEndpointTypes, PollingEndpointTypes, InfobipEndpointTypes, VirusTotalEndpointTypes, CloudflareEndpointTypes, CloudFrontEndpointTypes, FastlyEndpointTypes, FeatureFlagEndpointTypes, FilesEndpointTypes {
 }