File - Object Storage

import { Tenzro } from '@tenzro/cloud';

const client = new Tenzro({
  apiKey: process.env.TENZRO_API_KEY,
  projectId: 'your-project-id',
});

// Get file bucket by name
const bucket = await client.files.bucket('my-files');

// Upload a file
await bucket.upload('documents/report.pdf', pdfBuffer, {
  contentType: 'application/pdf',
  metadata: { author: 'John Doe' },
});

// Download a file
const data = await bucket.download('documents/report.pdf');

// List files
const { files } = await bucket.list({ prefix: 'documents/' });

// Get temporary signed URL
const url = await bucket.getSignedUrl('documents/report.pdf', 'get', {
  expiresIn: 3600  // 1 hour
});

console.log(url);  // Time-limited download URL

// Get existing bucket by name
const bucket = await client.files.bucket('my-files');

const file = await bucket.upload(
  'products/123/image.jpg',           // Key (path)
  imageBuffer,                        // File data
  {
    contentType: 'image/jpeg',        // Optional
    metadata: { productId: '123' },   // Optional
    cacheControl: 'max-age=3600',     // Optional
  }
);

const data = await bucket.download('products/123/image.jpg');
// Returns: ArrayBuffer

const { files, cursor } = await bucket.list({
  prefix: 'products/',    // Optional: filter by prefix
  maxResults: 100,        // Optional: pagination
  cursor: nextPageToken,  // Optional: next page
});

// Download URL
const url = await bucket.getSignedUrl(
  'products/123/image.jpg',
  'get',
  { expiresIn: 3600 }
);

// Upload URL
const uploadUrl = await bucket.getSignedUrl(
  'products/new.jpg',
  'put',
  { expiresIn: 600, contentType: 'image/jpeg' }
);

// For public buckets
const publicUrl = bucket.getPublicUrl('products/123/image.jpg');

const exists = await bucket.exists('products/123/image.jpg');

await bucket.delete('products/123/image.jpg');

const { deletedCount } = await bucket.deleteMany([
  'products/123/old1.jpg',
  'products/123/old2.jpg',
]);

// Delete all files in a folder
const { deletedCount } = await bucket.deleteByPrefix('products/123/');

const copied = await bucket.copy(
  'products/123/main.jpg',
  'products/123/backup.jpg'
);

const moved = await bucket.move(
  'temp/upload.jpg',
  'products/123/main.jpg'
);

const bucket = await client.files.bucket('uploads');

// Direct upload from browser
async function uploadDocument(file: File) {
  // Convert File to ArrayBuffer
  const buffer = await file.arrayBuffer();

  // Upload to bucket
  await bucket.upload(`documents/${file.name}`, buffer, {
    contentType: file.type,
    metadata: { uploadedBy: userId },
  });

  return { success: true };
}

// Or use signed URL for client-side upload
async function getUploadUrl(fileName: string, contentType: string) {
  const url = await bucket.getSignedUrl(
    `uploads/${fileName}`,
    'put',
    { expiresIn: 600, contentType }
  );

  return { uploadUrl: url };
}

const bucket = await client.files.bucket('ml-models');

// Store ML model
async function saveModel(modelName: string, modelData: ArrayBuffer) {
  await bucket.upload(`models/${modelName}.onnx`, modelData, {
    contentType: 'application/octet-stream',
    metadata: { version: '1.0' },
  });
}

// Load model
async function loadModel(modelName: string) {
  const data = await bucket.download(`models/${modelName}.onnx`);
  return data;
}

const bucket = await client.files.bucket('images');

// List images with temporary URLs
async function getGalleryImages(folder = 'gallery/') {
  const { files } = await bucket.list({
    prefix: folder,
    maxResults: 50,
  });

  // Generate temporary URLs for each image
  const images = await Promise.all(
    files
      .filter(f => f.contentType?.startsWith('image/'))
      .map(async (file) => {
        const url = await bucket.getSignedUrl(file.key, 'get', {
          expiresIn: 3600,
        });
        return {
          key: file.key,
          url,
          size: file.size,
        };
      })
  );

  return images;
}

{
  "cors": [
    {
      "origin": ["https://your-app.com"],
      "method": ["GET", "PUT", "POST"],
      "responseHeader": ["Content-Type"],
      "maxAgeSeconds": 3600
    }
  ]
}