@oasis-path/gamma-sdk 1.0.3 → 1.0.5

package/README.md

@@ -136,14 +136,26 @@ console.log('Expires at:', result.expiresAt);
 
 ### View File by Token
 
-Access a file using a presigned token (no API key required):
+Access a file using a presigned token (no API key required). Returns the file data along with response headers including caching information:
 
 ```typescript
-const fileData = await client.viewFileByToken('presigned-token-here');
+const result = await client.viewFileByToken('presigned-token-here');
 
-// Handle the file data as needed
-const buffer = Buffer.from(fileData);
+// Access file data
+const buffer = Buffer.from(result.data);
 fs.writeFileSync('./viewed-file.pdf', buffer);
+
+// Access cache headers for optimization
+console.log('Content Type:', result.headers.contentType);
+console.log('File Size:', result.headers.contentLength);
+console.log('ETag:', result.headers.etag); // For cache validation
+console.log('Cache Control:', result.headers.cacheControl);
+console.log('Cloudflare Cache Tag:', result.headers.cfCacheTag); // File ID for consistent caching
+
+// In browser, use the headers to implement client-side caching
+if (result.headers.etag) {
+  localStorage.setItem(`file-etag-${result.headers.cfCacheTag}`, result.headers.etag);
+}
 ```
 
 ## API Reference
@@ -232,14 +244,22 @@ Generate a presigned URL for temporary file access.
 
 **API Key Permissions Required:** `read`, `write`, or `admin`
 
-##### `viewFileByToken(token: string): Promise<ArrayBuffer>`
+##### `viewFileByToken(token: string): Promise<ViewFileByTokenResult>`
 
-Access a file using a presigned token (no API key required).
+Access a file using a presigned token (no API key required). Returns file data along with response headers including caching information.
 
 **Parameters:**
 - `token` - Presigned token from `generatePresignedUrl`
 
-**Returns:** File data as ArrayBuffer
+**Returns:** Object containing:
+- `data` - File data as ArrayBuffer
+- `headers` - Response headers including:
+  - `contentType` - MIME type of the file
+  - `contentLength` - Size of the file in bytes
+  - `contentDisposition` - Content disposition header (inline)
+  - `etag` - Entity tag for cache validation (based on file ID)
+  - `cacheControl` - Cache control directives (1 year immutable)
+  - `cfCacheTag` - Cloudflare cache tag (file ID for consistent caching across tokens)
 
 **API Key Permissions Required:** None (uses token authentication)
 
@@ -260,6 +280,7 @@ import {
   PresignedUrlOptions,
   PresignedUrlResponse,
   DownloadFileResult,
+  ViewFileByTokenResult,
   ApiErrorResponse
 } from '@gamma/files-sdk';
 ```

package/dist/client.d.ts

@@ -1,49 +1,14 @@
-import { GammaFilesClientConfig, UploadFileOptions, UploadFileResponse, ListFilesResponse, FileMetadataResponse, DeleteFileResponse, PresignedUrlOptions, PresignedUrlResponse } from './types';
+import { GammaFilesClientConfig, UploadFileOptions, UploadFileResponse, ListFilesResponse, FileMetadataResponse, DeleteFileResponse, PresignedUrlOptions, PresignedUrlResponse, ViewFileByTokenResult } from './types';
 export declare class GammaFilesClient {
     private baseUrl;
     private apiKey;
     constructor(config: GammaFilesClientConfig);
-    /**
-     * Upload a file to a folder
-     * @param options Upload options including file buffer/blob, filename, and optional folderId
-     * @returns Upload response with file metadata
-     */
     uploadFile(options: UploadFileOptions): Promise<UploadFileResponse>;
-    /**
-     * Download a file by ID
-     * @param fileId File ID to download
-     * @returns File metadata and data buffer
-     */
     downloadFile(fileId: string): Promise<ArrayBuffer>;
-    /**
-     * List all files in a folder
-     * @param folderId Folder ID to list files from
-     * @returns List of files in the folder
-     */
     listFiles(folderId: string): Promise<ListFilesResponse>;
-    /**
-     * Delete a file by ID
-     * @param fileId File ID to delete
-     * @returns Deletion confirmation
-     */
     deleteFile(fileId: string): Promise<DeleteFileResponse>;
-    /**
-     * Get file metadata by ID
-     * @param fileId File ID to get metadata for
-     * @returns File metadata
-     */
     getFileMetadata(fileId: string): Promise<FileMetadataResponse>;
-    /**
-     * Generate a presigned URL for temporary file access
-     * @param options Options including fileId and optional expiresIn (seconds)
-     * @returns Presigned URL token and expiration info
-     */
     generatePresignedUrl(options: PresignedUrlOptions): Promise<PresignedUrlResponse>;
-    /**
-     * Access a file using a presigned token (no API key required)
-     * @param token Presigned token
-     * @returns File data as ArrayBuffer
-     */
-    viewFileByToken(token: string): Promise<ArrayBuffer>;
+    viewFileByToken(token: string): Promise<ViewFileByTokenResult>;
     private request;
 }

package/dist/client.js

@@ -1,239 +1,42 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GammaFilesClient = void 0;
-const https = __importStar(require("https"));
-const http = __importStar(require("http"));
-const url_1 = require("url");
-const form_data_1 = __importDefault(require("form-data"));
+const uploadFile_1 = require("./methods/uploadFile");
+const downloadFile_1 = require("./methods/downloadFile");
+const listFiles_1 = require("./methods/listFiles");
+const deleteFile_1 = require("./methods/deleteFile");
+const getFileMetadata_1 = require("./methods/getFileMetadata");
+const generatePresignedUrl_1 = require("./methods/generatePresignedUrl");
+const viewFileByToken_1 = require("./methods/viewFileByToken");
+const request_1 = require("./methods/request");
 class GammaFilesClient {
     constructor(config) {
-        this.baseUrl = config.baseUrl.replace(/\/$/, ''); // Remove trailing slash
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
         this.apiKey = config.apiKey;
     }
-    /**
-     * Upload a file to a folder
-     * @param options Upload options including file buffer/blob, filename, and optional folderId
-     * @returns Upload response with file metadata
-     */
     async uploadFile(options) {
-        const { file, filename, mimeType, folderId } = options;
-        const form = new form_data_1.default();
-        // Handle different file types
-        let fileBuffer;
-        let contentType = mimeType || 'application/octet-stream';
-        if (Buffer.isBuffer(file)) {
-            fileBuffer = file;
-        }
-        else if (typeof Blob !== 'undefined' && file instanceof Blob) {
-            // Browser environment
-            const arrayBuffer = await file.arrayBuffer();
-            fileBuffer = Buffer.from(arrayBuffer);
-            contentType = mimeType || file.type || 'application/octet-stream';
-        }
-        else if (typeof File !== 'undefined' && file instanceof File) {
-            // Browser File object
-            const arrayBuffer = await file.arrayBuffer();
-            fileBuffer = Buffer.from(arrayBuffer);
-            contentType = mimeType || file.type || 'application/octet-stream';
-        }
-        else {
-            throw new Error('Unsupported file type');
-        }
-        form.append('file', fileBuffer, {
-            filename,
-            contentType,
-        });
-        const url = folderId
-            ? `/api/files/upload/${folderId}`
-            : '/api/files/upload';
-        return this.request('POST', url, {
-            body: form,
-            headers: form.getHeaders(),
-        });
+        return (0, uploadFile_1.uploadFile)(this.baseUrl, this.apiKey, options, this.request.bind(this));
     }
-    /**
-     * Download a file by ID
-     * @param fileId File ID to download
-     * @returns File metadata and data buffer
-     */
     async downloadFile(fileId) {
-        const url = `/api/files/download/${fileId}`;
-        return this.request('GET', url, { binary: true });
+        return (0, downloadFile_1.downloadFile)(fileId, this.request.bind(this));
     }
-    /**
-     * List all files in a folder
-     * @param folderId Folder ID to list files from
-     * @returns List of files in the folder
-     */
     async listFiles(folderId) {
-        const url = `/api/files/list/${folderId}`;
-        return this.request('GET', url);
+        return (0, listFiles_1.listFiles)(folderId, this.request.bind(this));
     }
-    /**
-     * Delete a file by ID
-     * @param fileId File ID to delete
-     * @returns Deletion confirmation
-     */
     async deleteFile(fileId) {
-        const url = `/api/files/${fileId}`;
-        return this.request('DELETE', url);
+        return (0, deleteFile_1.deleteFile)(fileId, this.request.bind(this));
     }
-    /**
-     * Get file metadata by ID
-     * @param fileId File ID to get metadata for
-     * @returns File metadata
-     */
     async getFileMetadata(fileId) {
-        const url = `/api/files/${fileId}/metadata`;
-        return this.request('GET', url);
+        return (0, getFileMetadata_1.getFileMetadata)(fileId, this.request.bind(this));
     }
-    /**
-     * Generate a presigned URL for temporary file access
-     * @param options Options including fileId and optional expiresIn (seconds)
-     * @returns Presigned URL token and expiration info
-     */
     async generatePresignedUrl(options) {
-        const url = '/api/files/presigned-url';
-        return this.request('POST', url, {
-            body: JSON.stringify(options),
-            headers: {
-                'Content-Type': 'application/json',
-            },
-        });
+        return (0, generatePresignedUrl_1.generatePresignedUrl)(options, this.request.bind(this));
     }
-    /**
-     * Access a file using a presigned token (no API key required)
-     * @param token Presigned token
-     * @returns File data as ArrayBuffer
-     */
     async viewFileByToken(token) {
-        const url = `/api/files/view/${token}`;
-        return this.request('GET', url, {
-            binary: true,
-            skipAuth: true
-        });
+        return (0, viewFileByToken_1.viewFileByToken)(token, this.request.bind(this));
     }
-    async request(method, path, options = {}) {
-        const url = new url_1.URL(path, this.baseUrl);
-        const isHttps = url.protocol === 'https:';
-        const lib = isHttps ? https : http;
-        return new Promise((resolve, reject) => {
-            const headers = {
-                ...options.headers,
-            };
-            if (!options.skipAuth) {
-                headers['Authorization'] = `Bearer ${this.apiKey}`;
-            }
-            // If body is not FormData, set content-length
-            if (options.body && !(options.body instanceof form_data_1.default)) {
-                if (typeof options.body === 'string') {
-                    headers['Content-Length'] = Buffer.byteLength(options.body).toString();
-                }
-            }
-            const reqOptions = {
-                method,
-                headers,
-            };
-            const req = lib.request(url, reqOptions, (res) => {
-                const chunks = [];
-                res.on('data', (chunk) => {
-                    chunks.push(chunk);
-                });
-                res.on('end', () => {
-                    const buffer = Buffer.concat(chunks);
-                    const responseText = buffer.toString();
-                    if (res.statusCode && res.statusCode >= 400) {
-                        let errorMessage = `HTTP ${res.statusCode}`;
-                        let errorDetails = '';
-                        try {
-                            const errorBody = JSON.parse(responseText);
-                            errorMessage = errorBody.error || errorBody.message || errorMessage;
-                            errorDetails = errorBody.details ? `\nDetails: ${JSON.stringify(errorBody.details)}` : '';
-                            // Create a more descriptive error
-                            const fullError = new Error(`API Error (${res.statusCode}): ${errorMessage}${errorDetails}\nEndpoint: ${method} ${url.pathname}`);
-                            fullError.statusCode = res.statusCode;
-                            fullError.responseBody = errorBody;
-                            reject(fullError);
-                        }
-                        catch {
-                            // If response is not JSON, use raw text
-                            const fullError = new Error(`API Error (${res.statusCode}): ${responseText || errorMessage}\nEndpoint: ${method} ${url.pathname}`);
-                            fullError.statusCode = res.statusCode;
-                            fullError.responseBody = responseText;
-                            reject(fullError);
-                        }
-                        return;
-                    }
-                    if (options.binary) {
-                        resolve(buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength));
-                    }
-                    else {
-                        try {
-                            const data = JSON.parse(responseText);
-                            resolve(data);
-                        }
-                        catch (err) {
-                            const parseError = new Error(`Failed to parse response JSON from ${method} ${url.pathname}\nResponse: ${responseText.substring(0, 200)}${responseText.length > 200 ? '...' : ''}`);
-                            parseError.responseText = responseText;
-                            reject(parseError);
-                        }
-                    }
-                });
-            });
-            req.on('error', (err) => {
-                const networkError = new Error(`Network error for ${method} ${url.pathname}: ${err.message}`);
-                networkError.originalError = err;
-                reject(networkError);
-            });
-            if (options.body) {
-                if (options.body instanceof form_data_1.default) {
-                    options.body.pipe(req);
-                }
-                else {
-                    req.write(options.body);
-                    req.end();
-                }
-            }
-            else {
-                req.end();
-            }
-        });
+    async request(method, path, options) {
+        return (0, request_1.makeRequest)(method, path, this.baseUrl, this.apiKey, options);
     }
 }
 exports.GammaFilesClient = GammaFilesClient;

package/dist/methods/deleteFile.d.ts

@@ -0,0 +1,2 @@
+import { DeleteFileResponse } from '../types';
+export declare function deleteFile(fileId: string, request: <T>(method: string, path: string, options?: any) => Promise<T>): Promise<DeleteFileResponse>;

package/dist/methods/deleteFile.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteFile = deleteFile;
+async function deleteFile(fileId, request) {
+    const url = `/api/files/${fileId}`;
+    return request('DELETE', url);
+}

package/dist/methods/downloadFile.d.ts

@@ -0,0 +1 @@
+export declare function downloadFile(fileId: string, request: <T>(method: string, path: string, options?: any) => Promise<T>): Promise<ArrayBuffer>;

package/dist/methods/downloadFile.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadFile = downloadFile;
+async function downloadFile(fileId, request) {
+    const url = `/api/files/download/${fileId}`;
+    return request('GET', url, { binary: true });
+}

package/dist/methods/generatePresignedUrl.d.ts

@@ -0,0 +1,2 @@
+import { PresignedUrlOptions, PresignedUrlResponse } from '../types';
+export declare function generatePresignedUrl(options: PresignedUrlOptions, request: <T>(method: string, path: string, options?: any) => Promise<T>): Promise<PresignedUrlResponse>;

package/dist/methods/generatePresignedUrl.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generatePresignedUrl = generatePresignedUrl;
+async function generatePresignedUrl(options, request) {
+    const url = '/api/files/presigned-url';
+    const payload = {
+        ...options,
+        maxUsageCount: options.maxUsageCount ?? 1
+    };
+    return request('POST', url, {
+        body: JSON.stringify(payload),
+        headers: {
+            'Content-Type': 'application/json',
+        },
+    });
+}

package/dist/methods/getFileMetadata.d.ts

@@ -0,0 +1,2 @@
+import { FileMetadataResponse } from '../types';
+export declare function getFileMetadata(fileId: string, request: <T>(method: string, path: string, options?: any) => Promise<T>): Promise<FileMetadataResponse>;

package/dist/methods/getFileMetadata.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFileMetadata = getFileMetadata;
+async function getFileMetadata(fileId, request) {
+    const url = `/api/files/${fileId}/metadata`;
+    return request('GET', url);
+}

package/dist/methods/listFiles.d.ts

@@ -0,0 +1,2 @@
+import { ListFilesResponse } from '../types';
+export declare function listFiles(folderId: string, request: <T>(method: string, path: string, options?: any) => Promise<T>): Promise<ListFilesResponse>;

package/dist/methods/listFiles.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listFiles = listFiles;
+async function listFiles(folderId, request) {
+    const url = `/api/files/list/${folderId}`;
+    return request('GET', url);
+}

package/dist/methods/request.d.ts

@@ -0,0 +1,7 @@
+export declare function makeRequest<T>(method: string, path: string, baseUrl: string, apiKey: string, options?: {
+    body?: any;
+    headers?: Record<string, string>;
+    binary?: boolean;
+    skipAuth?: boolean;
+    includeHeaders?: boolean;
+}): Promise<T>;

package/dist/methods/request.js

@@ -0,0 +1,122 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeRequest = makeRequest;
+const https = __importStar(require("https"));
+const http = __importStar(require("http"));
+const url_1 = require("url");
+const form_data_1 = __importDefault(require("form-data"));
+async function makeRequest(method, path, baseUrl, apiKey, options = {}) {
+    const url = new url_1.URL(path, baseUrl);
+    const isHttps = url.protocol === 'https:';
+    const lib = isHttps ? https : http;
+    return new Promise((resolve, reject) => {
+        const headers = {
+            ...options.headers,
+        };
+        if (!options.skipAuth) {
+            headers['Authorization'] = `Bearer ${apiKey}`;
+        }
+        if (options.body && !(options.body instanceof form_data_1.default)) {
+            if (typeof options.body === 'string') {
+                headers['Content-Length'] = Buffer.byteLength(options.body).toString();
+            }
+        }
+        const reqOptions = {
+            method,
+            headers,
+        };
+        const req = lib.request(url, reqOptions, (res) => {
+            const chunks = [];
+            res.on('data', (chunk) => {
+                chunks.push(chunk);
+            });
+            res.on('end', () => {
+                const buffer = Buffer.concat(chunks);
+                const responseText = buffer.toString();
+                if (res.statusCode && res.statusCode >= 400) {
+                    const errorBody = JSON.parse(responseText);
+                    const fullError = new Error(errorBody.error || errorBody.message || `HTTP ${res.statusCode}`);
+                    fullError.statusCode = res.statusCode;
+                    fullError.responseBody = errorBody;
+                    reject(fullError);
+                    return;
+                }
+                if (options.binary) {
+                    const arrayBuffer = buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+                    if (options.includeHeaders) {
+                        const result = {
+                            data: arrayBuffer,
+                            headers: {
+                                contentType: res.headers['content-type'] || '',
+                                contentLength: parseInt(res.headers['content-length'] || '0', 10),
+                                contentDisposition: res.headers['content-disposition'] || '',
+                                etag: res.headers['etag'],
+                                cacheControl: res.headers['cache-control'],
+                                cfCacheTag: res.headers['cf-cache-tag'],
+                            }
+                        };
+                        resolve(result);
+                    }
+                    else {
+                        resolve(arrayBuffer);
+                    }
+                }
+                else {
+                    const data = JSON.parse(responseText);
+                    resolve(data);
+                }
+            });
+        });
+        req.on('error', (err) => {
+            reject(err);
+        });
+        if (options.body) {
+            if (options.body instanceof form_data_1.default) {
+                options.body.pipe(req);
+            }
+            else {
+                req.write(options.body);
+                req.end();
+            }
+        }
+        else {
+            req.end();
+        }
+    });
+}

package/dist/methods/uploadFile.d.ts

@@ -0,0 +1,2 @@
+import { UploadFileOptions, UploadFileResponse } from '../types';
+export declare function uploadFile(baseUrl: string, apiKey: string, options: UploadFileOptions, request: <T>(method: string, path: string, options?: any) => Promise<T>): Promise<UploadFileResponse>;

package/dist/methods/uploadFile.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadFile = uploadFile;
+const form_data_1 = __importDefault(require("form-data"));
+async function uploadFile(baseUrl, apiKey, options, request) {
+    const { file, filename, mimeType, folderId } = options;
+    const form = new form_data_1.default();
+    let fileBuffer;
+    let contentType = mimeType || 'application/octet-stream';
+    if (Buffer.isBuffer(file)) {
+        fileBuffer = file;
+    }
+    else if (typeof file === 'string') {
+        // Handle base64 string
+        fileBuffer = Buffer.from(file, 'base64');
+    }
+    else if (typeof Blob !== 'undefined' && file instanceof Blob) {
+        const arrayBuffer = await file.arrayBuffer();
+        fileBuffer = Buffer.from(arrayBuffer);
+        contentType = mimeType || file.type || 'application/octet-stream';
+    }
+    else if (typeof File !== 'undefined' && file instanceof File) {
+        const arrayBuffer = await file.arrayBuffer();
+        fileBuffer = Buffer.from(arrayBuffer);
+        contentType = mimeType || file.type || 'application/octet-stream';
+    }
+    else {
+        throw new Error('Unsupported file type');
+    }
+    form.append('file', fileBuffer, {
+        filename,
+        contentType,
+    });
+    const url = folderId
+        ? `/api/files/upload/${folderId}`
+        : '/api/files/upload';
+    return request('POST', url, {
+        body: form,
+        headers: form.getHeaders(),
+    });
+}

package/dist/methods/viewFileByToken.d.ts

@@ -0,0 +1,2 @@
+import { ViewFileByTokenResult } from '../types';
+export declare function viewFileByToken(token: string, request: <T>(method: string, path: string, options?: any) => Promise<T>): Promise<ViewFileByTokenResult>;

package/dist/methods/viewFileByToken.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.viewFileByToken = viewFileByToken;
+async function viewFileByToken(token, request) {
+    const url = `/api/files/view/${token}`;
+    return request('GET', url, {
+        binary: true,
+        skipAuth: true,
+        includeHeaders: true
+    });
+}

package/dist/types.d.ts

@@ -13,7 +13,7 @@ export interface FileMetadata {
     createdAt: string;
 }
 export interface UploadFileOptions {
-    file: Buffer | Blob | File;
+    file: Buffer | Blob | File | string;
     filename: string;
     mimeType?: string;
     folderId?: string;
@@ -37,6 +37,7 @@ export interface DeleteFileResponse {
 export interface PresignedUrlOptions {
     fileId: string;
     expiresIn?: number;
+    maxUsageCount?: number;
 }
 export interface PresignedUrlResponse {
     success: true;
@@ -48,6 +49,17 @@ export interface DownloadFileResult {
     file: FileMetadata;
     data: ArrayBuffer;
 }
+export interface ViewFileByTokenResult {
+    data: ArrayBuffer;
+    headers: {
+        contentType: string;
+        contentLength: number;
+        contentDisposition: string;
+        etag?: string;
+        cacheControl?: string;
+        cfCacheTag?: string;
+    };
+}
 export interface ApiErrorResponse {
     success: false;
     error: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oasis-path/gamma-sdk",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "TypeScript SDK for Gamma Files API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",