@cloudizero/sdk 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,208 @@
-# Temporary Holding Version
+# @cloudizero/sdk
+
+> Official TypeScript SDK for the **Cloudizero** Zero-Egress Digital Asset Management & Media Delivery Platform.
+
+Seamlessly upload, manage, and deliver media files and virtual folders directly to Cloudflare R2 storage with zero bandwidth egress penalties and instant relational indexing.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @cloudizero/sdk
+# or
+pnpm add @cloudizero/sdk
+# or
+yarn add @cloudizero/sdk
+```
+
+---
+
+## 🚀 Quick Start
+
+### 1. Initialize Client
+
+Generate an API Key in your Cloudizero dashboard (`/api-keys`), then initialize the SDK:
+
+```typescript
+import { Cloudizero } from "@cloudizero/sdk";
+
+// 1. Zero-config (reads CLOUDIZERO_API_KEY from environment, defaults to https://api-cloudizero.wismannur.pro)
+const cz = new Cloudizero();
+
+// 2. Or explicit configuration (overriding baseUrl / cdnUrl if needed):
+const czCustom = new Cloudizero({
+  apiKey: process.env.CLOUDIZERO_API_KEY!, // e.g. "cz_live_9f8a..."
+  baseUrl: "https://api-cloudizero.wismannur.pro", // default
+  cdnUrl: "https://cdn-cloudizero.wismannur.pro", // default
+});
+```
+
+---
+
+## 📂 File CRUD Operations
+
+### 1. Create / Upload File (`upload`)
+
+#### Direct File Upload (Node.js / Next.js / Express)
+Upload buffers, byte arrays, or streams directly from your backend services:
+
+```typescript
+import fs from "fs";
+
+const fileBuffer = fs.readFileSync("./avatar.png");
+
+const uploaded = await cz.storage.upload({
+  file: fileBuffer,
+  fileName: "avatar.png",
+  projectId: "ca2454ff-7f1e-421b-b134-4c800f6d58de",
+  folderId: "3b9c1e2a-...", // optional target Folder ID (or omit for root)
+  mimeType: "image/png",
+});
+
+console.log("Uploaded successfully!");
+console.log("File ID:", uploaded.id);
+console.log("R2 Key:", uploaded.r2Key);
+console.log("Public URL:", uploaded.url);
+```
+
+#### Browser Upload with Real-time Progress (React / Vue / Vanilla JS)
+```typescript
+const handleFileInput = async (event: React.ChangeEvent<HTMLInputElement>) => {
+  const file = event.target.files?.[0];
+  if (!file) return;
+
+  const result = await cz.storage.upload({
+    file,
+    fileName: file.name,
+    projectId: "your-project-id",
+    mimeType: file.type,
+    onProgress: ({ loaded, total, percent }) => {
+      console.log(`Upload progress: ${percent}% (${loaded}/${total} bytes)`);
+    },
+  });
+
+  console.log("Public CDN link:", result.url);
+};
+```
+
+### 2. Read File Details (`getFile`)
+
+Retrieve file metadata along with a temporary presigned download URL:
+
+```typescript
+const { file, downloadUrl } = await cz.storage.getFile("file-id-here");
+console.log("File metadata:", file);
+console.log("Presigned download URL:", downloadUrl);
+```
+
+### 3. Update File Metadata or Replace Binary (`updateFile` & `replaceFile`)
+
+#### Update Metadata (Rename / Move Folder / Trash)
+Renaming a file or moving it to another folder automatically moves the underlying object in Cloudflare R2 so the human-readable `r2Key` and CDN URL stay synchronized:
+
+```typescript
+const updated = await cz.storage.updateFile({
+  fileId: "file-id-here",
+  name: "new-avatar-name.png",
+  folderId: "target-folder-id", // or null / "root" to move to project root
+});
+
+console.log("Updated R2 Key:", updated.r2Key);
+console.log("Updated CDN URL:", updated.url);
+```
+
+#### Replace File Binary In-Place (`replaceFile`)
+Overwrite an existing file's binary content while preserving its `fileId` (and optionally updating its filename or MIME type):
+
+```typescript
+const newBuffer = fs.readFileSync("./avatar-v2.webp");
+
+const replaced = await cz.storage.replaceFile({
+  fileId: "file-id-here",
+  file: newBuffer,
+  fileName: "avatar-v2.webp", // optional: omit to keep existing filename & R2 key
+  mimeType: "image/webp",
+});
+
+console.log("Replaced file URL:", replaced.url);
+```
+
+### 4. Delete File (`deleteFile`)
+
+Permanently delete a file from both Cloudflare R2 and Neon PostgreSQL:
+
+```typescript
+await cz.storage.deleteFile("file-id-here");
+console.log("File permanently removed from R2 & DB");
+```
+
+---
+
+## 📁 Folder CRUD Operations
+
+### 1. Create Folder (`createFolder`)
+
+```typescript
+const folder = await cz.storage.createFolder({
+  projectId: "your-project-id",
+  name: "Marketing Banners",
+  parentId: null, // optional parent folder ID for nested folders
+});
+
+console.log("Created folder:", folder.id, folder.path); // e.g. "/marketing-banners"
+```
+
+### 2. Read & List Folders (`getFolder`, `listFolders`, `listContents`)
+
+```typescript
+// Get a single folder by ID
+const folderInfo = await cz.storage.getFolder("folder-id-here");
+
+// List folders in project root (or pass parentId for subfolders)
+const folders = await cz.storage.listFolders({
+  projectId: "your-project-id",
+  parentId: "root",
+});
+
+// List both folders, files, and breadcrumbs in a directory
+const contents = await cz.storage.listContents({
+  projectId: "your-project-id",
+  folderId: folder.id, // or omit for root
+});
+```
+
+### 3. Update Folder (`updateFolder`)
+
+Rename a folder or move it under a new parent folder. All nested subfolder paths and underlying Cloudflare R2 keys for files inside the folder tree are updated automatically:
+
+```typescript
+const updatedFolder = await cz.storage.updateFolder({
+  folderId: "folder-id-here",
+  name: "Q4 Campaigns",
+  parentId: "parent-folder-id", // or null / "root"
+});
+```
+
+### 4. Delete Folder (`deleteFolder`)
+
+Recursively deletes a folder, all its subfolders, and permanently removes all contained files from Cloudflare R2 and Neon DB:
+
+```typescript
+const result = await cz.storage.deleteFolder("folder-id-here");
+console.log(`Deleted ${result.deletedFoldersCount} folders and ${result.deletedFilesCount} files`);
+```
+
+---
+
+## 🔒 Security Best Practice
+
+* **Secret API Key (`cz_live_...`)**: Keep in server-side environment variables (`process.env.CLOUDIZERO_API_KEY`).
+* **Project Restrictions**: When generating an API key, you can restrict it to specific projects to follow the principle of least privilege.
+
+---
+
+## 📄 License
+
+MIT © [Wisman Nur](https://wismannur.pro)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/dist/client.d.ts

@@ -0,0 +1,15 @@
+import { CloudizeroConfig } from "./types.js";
+import { StorageClient } from "./storage.js";
+import { ProjectsClient } from "./projects.js";
+export declare class Cloudizero {
+    /**
+     * Media Storage & Ingestion methods
+     */
+    readonly storage: StorageClient;
+    /**
+     * Project Management methods
+     */
+    readonly projects: ProjectsClient;
+    constructor(config?: CloudizeroConfig);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,qBAAa,UAAU;IACrB;;OAEG;IACH,SAAgB,OAAO,EAAE,aAAa,CAAC;IAEvC;;OAEG;IACH,SAAgB,QAAQ,EAAE,cAAc,CAAC;gBAE7B,MAAM,GAAE,gBAAqB;CAI1C"}

package/dist/client.js

@@ -0,0 +1,17 @@
+import { StorageClient } from "./storage.js";
+import { ProjectsClient } from "./projects.js";
+export class Cloudizero {
+    /**
+     * Media Storage & Ingestion methods
+     */
+    storage;
+    /**
+     * Project Management methods
+     */
+    projects;
+    constructor(config = {}) {
+        this.storage = new StorageClient(config);
+        this.projects = new ProjectsClient(config);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,OAAO,UAAU;IACrB;;OAEG;IACa,OAAO,CAAgB;IAEvC;;OAEG;IACa,QAAQ,CAAiB;IAEzC,YAAY,SAA2B,EAAE;QACvC,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,6 @@
+export declare class CloudizeroError extends Error {
+    readonly status?: number;
+    readonly details?: unknown;
+    constructor(message: string, status?: number, details?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAOhE"}

package/dist/errors.js

@@ -0,0 +1,12 @@
+export class CloudizeroError extends Error {
+    status;
+    details;
+    constructor(message, status, details) {
+        super(message);
+        this.name = "CloudizeroError";
+        this.status = status;
+        this.details = details;
+        Object.setPrototypeOf(this, CloudizeroError.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxB,MAAM,CAAU;IAChB,OAAO,CAAW;IAElC,YAAY,OAAe,EAAE,MAAe,EAAE,OAAiB;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { Cloudizero } from "./client.js";
+export { StorageClient } from "./storage.js";
+export { ProjectsClient } from "./projects.js";
+export { CloudizeroError } from "./errors.js";
+export type { CloudizeroConfig, UploadOptions, UpdateFileOptions, ReplaceFileOptions, UploadedFile, StorageFolder, CreateFolderOptions, ListFoldersOptions, UpdateFolderOptions, DeleteFolderResult, StorageContents, UploadPayload, Project, CreateProjectOptions, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,OAAO,EACP,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { Cloudizero } from "./client.js";
+export { StorageClient } from "./storage.js";
+export { ProjectsClient } from "./projects.js";
+export { CloudizeroError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/projects.d.ts

@@ -0,0 +1,17 @@
+import { CloudizeroConfig, Project, CreateProjectOptions } from "./types.js";
+export declare class ProjectsClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(config?: CloudizeroConfig);
+    /**
+     * [READ] Lists all accessible projects for the authenticated API key.
+     * If the API key is scoped to specific projects, only scoped projects are returned.
+     */
+    list(): Promise<Project[]>;
+    /**
+     * [CREATE] Creates a new project.
+     * Requires an API key with Full Workspace Access (not scoped to specific projects).
+     */
+    create(options: CreateProjectOptions): Promise<Project>;
+}
+//# sourceMappingURL=projects.d.ts.map

package/dist/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../src/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAG7E,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,GAAE,gBAAqB;IAuBzC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAmBhC;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;CAqB9D"}

package/dist/projects.js

@@ -0,0 +1,56 @@
+import { CloudizeroError } from "./errors.js";
+export class ProjectsClient {
+    apiKey;
+    baseUrl;
+    constructor(config = {}) {
+        const resolvedApiKey = config.apiKey ||
+            (typeof process !== "undefined" && process.env?.CLOUDIZERO_API_KEY
+                ? process.env.CLOUDIZERO_API_KEY
+                : "");
+        if (!resolvedApiKey) {
+            throw new CloudizeroError("Cloudizero API key is required. Pass it via config { apiKey: 'cz_live_...' } or define CLOUDIZERO_API_KEY in your environment.");
+        }
+        const resolvedBaseUrl = config.baseUrl ||
+            (typeof process !== "undefined" && process.env?.CLOUDIZERO_BASE_URL
+                ? process.env.CLOUDIZERO_BASE_URL
+                : "https://api-cloudizero.wismannur.pro");
+        this.apiKey = resolvedApiKey;
+        this.baseUrl = resolvedBaseUrl.replace(/\/+$/, "");
+    }
+    /**
+     * [READ] Lists all accessible projects for the authenticated API key.
+     * If the API key is scoped to specific projects, only scoped projects are returned.
+     */
+    async list() {
+        const res = await fetch(`${this.baseUrl}/api/projects`, {
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new CloudizeroError(err.error || `Failed to list projects (${res.status})`, res.status, err);
+        }
+        return res.json();
+    }
+    /**
+     * [CREATE] Creates a new project.
+     * Requires an API key with Full Workspace Access (not scoped to specific projects).
+     */
+    async create(options) {
+        const res = await fetch(`${this.baseUrl}/api/projects`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify(options),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new CloudizeroError(err.error || `Failed to create project (${res.status})`, res.status, err);
+        }
+        return res.json();
+    }
+}
+//# sourceMappingURL=projects.js.map

package/dist/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../src/projects.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,OAAO,cAAc;IACR,MAAM,CAAS;IACf,OAAO,CAAS;IAEjC,YAAY,SAA2B,EAAE;QACvC,MAAM,cAAc,GAClB,MAAM,CAAC,MAAM;YACb,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,kBAAkB;gBAChE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB;gBAChC,CAAC,CAAC,EAAE,CAAC,CAAC;QAEV,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,eAAe,CACvB,gIAAgI,CACjI,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GACnB,MAAM,CAAC,OAAO;YACd,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,mBAAmB;gBACjE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB;gBACjC,CAAC,CAAC,sCAAsC,CAAC,CAAC;QAE9C,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,eAAe,EAAE;YACtD,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACvC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/C,MAAM,IAAI,eAAe,CACvB,GAAG,CAAC,KAAK,IAAI,4BAA4B,GAAG,CAAC,MAAM,GAAG,EACtD,GAAG,CAAC,MAAM,EACV,GAAG,CACJ,CAAC;QACJ,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,OAA6B;QACxC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,eAAe,EAAE;YACtD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACvC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/C,MAAM,IAAI,eAAe,CACvB,GAAG,CAAC,KAAK,IAAI,6BAA6B,GAAG,CAAC,MAAM,GAAG,EACvD,GAAG,CAAC,MAAM,EACV,GAAG,CACJ,CAAC;QACJ,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/storage.d.ts

@@ -0,0 +1,65 @@
+import { CloudizeroConfig, UploadOptions, UpdateFileOptions, ReplaceFileOptions, UploadedFile, StorageFolder, CreateFolderOptions, ListFoldersOptions, UpdateFolderOptions, DeleteFolderResult, StorageContents } from "./types.js";
+export declare class StorageClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly cdnUrl?;
+    constructor(config?: CloudizeroConfig);
+    /**
+     * [CREATE] Uploads a file directly to Cloudflare R2 via presigned PUT URL and records metadata.
+     */
+    upload(options: UploadOptions): Promise<UploadedFile>;
+    /**
+     * [READ] Gets file details and generates a presigned private download URL
+     */
+    getFile(fileId: string): Promise<{
+        file: UploadedFile;
+        downloadUrl: string;
+    }>;
+    /**
+     * [UPDATE] Updates file metadata (rename, move folder, trash toggle) and/or replaces its binary content in R2.
+     * When renaming or moving folders, the underlying R2 object key is automatically moved to stay in sync.
+     */
+    updateFile(options: UpdateFileOptions): Promise<UploadedFile>;
+    /**
+     * [UPDATE - BINARY REPLACE] Replaces the binary content of an existing file while preserving its fileId.
+     * Optionally updates the file name, folder, MIME type, or dimensions.
+     */
+    replaceFile(options: ReplaceFileOptions): Promise<UploadedFile>;
+    /**
+     * [DELETE] Deletes a file permanently from Cloudflare R2 and Neon DB
+     */
+    deleteFile(fileId: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * [CREATE] Creates a new virtual folder within a project
+     */
+    createFolder(options: CreateFolderOptions): Promise<StorageFolder>;
+    /**
+     * [READ] Gets a single folder by its ID
+     */
+    getFolder(folderId: string): Promise<StorageFolder>;
+    /**
+     * [READ] Lists folders within a project (or inside a specific parent folder)
+     */
+    listFolders(options: ListFoldersOptions): Promise<StorageFolder[]>;
+    /**
+     * [UPDATE] Renames or moves a folder, recursively updating paths and R2 object keys for all nested files
+     */
+    updateFolder(options: UpdateFolderOptions): Promise<StorageFolder>;
+    /**
+     * [DELETE] Deletes a folder and recursively removes all nested subfolders and files from R2 and Neon DB
+     */
+    deleteFolder(folderId: string): Promise<DeleteFolderResult>;
+    /**
+     * Lists folders and files in a directory
+     */
+    listContents(params: {
+        projectId: string;
+        folderId?: string;
+    }): Promise<StorageContents>;
+    private getByteLength;
+    private uploadBinary;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EAChB,MAAM,YAAY,CAAC;AAGpB,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAErB,MAAM,GAAE,gBAAqB;IAkCzC;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAkF3D;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IA2BnF;;;OAGG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAgEnE;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAarE;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA2BhF;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IA6BxE;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAsBzD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAyBxE;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IA8BxE;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA2BjE;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,eAAe,CAAC;IA+B5B,OAAO,CAAC,aAAa;YAeP,YAAY;CA+D3B"}

package/dist/storage.js

@@ -0,0 +1,362 @@
+import { CloudizeroError } from "./errors.js";
+export class StorageClient {
+    apiKey;
+    baseUrl;
+    cdnUrl;
+    constructor(config = {}) {
+        const resolvedApiKey = config.apiKey ||
+            (typeof process !== "undefined" && process.env?.CLOUDIZERO_API_KEY
+                ? process.env.CLOUDIZERO_API_KEY
+                : "");
+        if (!resolvedApiKey) {
+            throw new CloudizeroError("Cloudizero API key is required. Pass it via config { apiKey: 'cz_live_...' } or define CLOUDIZERO_API_KEY in your environment.");
+        }
+        const resolvedBaseUrl = config.baseUrl ||
+            (typeof process !== "undefined" && process.env?.CLOUDIZERO_BASE_URL
+                ? process.env.CLOUDIZERO_BASE_URL
+                : "https://api-cloudizero.wismannur.pro");
+        const resolvedCdnUrl = config.cdnUrl ||
+            (typeof process !== "undefined" && process.env?.CLOUDIZERO_CDN_URL
+                ? process.env.CLOUDIZERO_CDN_URL
+                : "https://cdn-cloudizero.wismannur.pro");
+        this.apiKey = resolvedApiKey;
+        this.baseUrl = resolvedBaseUrl.replace(/\/+$/, "");
+        this.cdnUrl = resolvedCdnUrl ? resolvedCdnUrl.replace(/\/+$/, "") : undefined;
+    }
+    // ==========================================
+    // FILE CRUD OPERATIONS
+    // ==========================================
+    /**
+     * [CREATE] Uploads a file directly to Cloudflare R2 via presigned PUT URL and records metadata.
+     */
+    async upload(options) {
+        const { file, fileName, projectId, folderId, mimeType = "application/octet-stream", width, height, onProgress, } = options;
+        const fileSize = this.getByteLength(file);
+        // 1. Request Presigned Upload Ticket
+        const presignRes = await fetch(`${this.baseUrl}/api/storage/presign`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                projectId,
+                folderId: folderId && folderId !== "root" ? folderId : null,
+                fileName,
+                mimeType,
+                fileSize,
+            }),
+        });
+        if (!presignRes.ok) {
+            const err = await presignRes.json().catch(() => ({}));
+            throw new CloudizeroError(err.error || `Presign failed with status ${presignRes.status}`, presignRes.status, err);
+        }
+        const { uploadUrl, r2Key, fileId, finalFileName } = await presignRes.json();
+        // 2. Direct S3 PUT Upload to Cloudflare R2
+        await this.uploadBinary(uploadUrl, file, mimeType, onProgress);
+        // 3. Record Metadata in Cloudizero
+        const completeRes = await fetch(`${this.baseUrl}/api/storage/complete`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                fileId,
+                projectId,
+                folderId: folderId && folderId !== "root" ? folderId : null,
+                name: finalFileName || fileName,
+                mimeType,
+                size: fileSize,
+                width: width || null,
+                height: height || null,
+                r2Key,
+            }),
+        });
+        if (!completeRes.ok) {
+            const err = await completeRes.json().catch(() => ({}));
+            throw new CloudizeroError(err.error || `Recording file metadata failed with status ${completeRes.status}`, completeRes.status, err);
+        }
+        const recordedFile = await completeRes.json();
+        if (this.cdnUrl) {
+            recordedFile.url = `${this.cdnUrl}/${recordedFile.r2Key}`;
+        }
+        return recordedFile;
+    }
+    /**
+     * [READ] Gets file details and generates a presigned private download URL
+     */
+    async getFile(fileId) {
+        const res = await fetch(`${this.baseUrl}/api/storage/files?fileId=${encodeURIComponent(fileId)}`, {
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new CloudizeroError(err.error || `Failed to get file (${res.status})`, res.status, err);
+        }
+        const data = await res.json();
+        if (this.cdnUrl && data.file) {
+            data.file.url = `${this.cdnUrl}/${data.file.r2Key}`;
+        }
+        return data;
+    }
+    /**
+     * [UPDATE] Updates file metadata (rename, move folder, trash toggle) and/or replaces its binary content in R2.
+     * When renaming or moving folders, the underlying R2 object key is automatically moved to stay in sync.
+     */
+    async updateFile(options) {
+        const { fileId, name, folderId, isTrash, file, mimeType, width, height, onProgress, } = options;
+        const isReplacingBinary = file !== undefined;
+        const size = isReplacingBinary ? this.getByteLength(file) : undefined;
+        const res = await fetch(`${this.baseUrl}/api/storage/files`, {
+            method: "PATCH",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                fileId,
+                ...(name !== undefined ? { name } : {}),
+                ...(folderId !== undefined
+                    ? { folderId: folderId && folderId !== "root" ? folderId : null }
+                    : {}),
+                ...(isTrash !== undefined ? { isTrash } : {}),
+                ...(mimeType !== undefined ? { mimeType } : {}),
+                ...(size !== undefined ? { size } : {}),
+                ...(width !== undefined ? { width } : {}),
+                ...(height !== undefined ? { height } : {}),
+                ...(isReplacingBinary ? { requestReplaceUploadUrl: true } : {}),
+            }),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new CloudizeroError(err.error || `Failed to update file (${res.status})`, res.status, err);
+        }
+        const data = await res.json();
+        if (isReplacingBinary && data.uploadUrl) {
+            await this.uploadBinary(data.uploadUrl, file, mimeType || data.file.mimeType || "application/octet-stream", onProgress);
+        }
+        if (this.cdnUrl && data.file) {
+            data.file.url = `${this.cdnUrl}/${data.file.r2Key}`;
+        }
+        return data.file;
+    }
+    /**
+     * [UPDATE - BINARY REPLACE] Replaces the binary content of an existing file while preserving its fileId.
+     * Optionally updates the file name, folder, MIME type, or dimensions.
+     */
+    async replaceFile(options) {
+        return this.updateFile({
+            fileId: options.fileId,
+            file: options.file,
+            name: options.fileName,
+            folderId: options.folderId,
+            mimeType: options.mimeType,
+            width: options.width,
+            height: options.height,
+            onProgress: options.onProgress,
+        });
+    }
+    /**
+     * [DELETE] Deletes a file permanently from Cloudflare R2 and Neon DB
+     */
+    async deleteFile(fileId) {
+        const res = await fetch(`${this.baseUrl}/api/storage/files?fileId=${encodeURIComponent(fileId)}`, {
+            method: "DELETE",
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new CloudizeroError(err.error || `Failed to delete file (${res.status})`, res.status, err);
+        }
+        return res.json();
+    }
+    // ==========================================
+    // FOLDER CRUD OPERATIONS
+    // ==========================================
+    /**
+     * [CREATE] Creates a new virtual folder within a project
+     */
+    async createFolder(options) {
+        const { projectId, name, parentId, path } = options;
+        const res = await fetch(`${this.baseUrl}/api/storage/folders`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                projectId,
+                name,
+                parentId: parentId && parentId !== "root" ? parentId : null,
+                ...(path ? { path } : {}),
+            }),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new CloudizeroError(err.error || `Failed to create folder (${res.status})`, res.status, err);
+        }
+        return res.json();
+    }
+    /**
+     * [READ] Gets a single folder by its ID
+     */
+    async getFolder(folderId) {
+        const res = await fetch(`${this.baseUrl}/api/storage/folders?folderId=${encodeURIComponent(folderId)}`, {
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new CloudizeroError(err.error || `Failed to get folder (${res.status})`, res.status, err);
+        }
+        return res.json();
+    }
+    /**
+     * [READ] Lists folders within a project (or inside a specific parent folder)
+     */
+    async listFolders(options) {
+        const { projectId, parentId = "root" } = options;
+        const targetParent = parentId || "root";
+        const res = await fetch(`${this.baseUrl}/api/storage/folders?projectId=${encodeURIComponent(projectId)}&parentId=${encodeURIComponent(targetParent)}`, {
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new CloudizeroError(err.error || `Failed to list folders (${res.status})`, res.status, err);
+        }
+        return res.json();
+    }
+    /**
+     * [UPDATE] Renames or moves a folder, recursively updating paths and R2 object keys for all nested files
+     */
+    async updateFolder(options) {
+        const { folderId, name, parentId } = options;
+        const res = await fetch(`${this.baseUrl}/api/storage/folders`, {
+            method: "PATCH",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                folderId,
+                ...(name !== undefined ? { name } : {}),
+                ...(parentId !== undefined
+                    ? { parentId: parentId && parentId !== "root" ? parentId : null }
+                    : {}),
+            }),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new CloudizeroError(err.error || `Failed to update folder (${res.status})`, res.status, err);
+        }
+        return res.json();
+    }
+    /**
+     * [DELETE] Deletes a folder and recursively removes all nested subfolders and files from R2 and Neon DB
+     */
+    async deleteFolder(folderId) {
+        const res = await fetch(`${this.baseUrl}/api/storage/folders?folderId=${encodeURIComponent(folderId)}`, {
+            method: "DELETE",
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new CloudizeroError(err.error || `Failed to delete folder (${res.status})`, res.status, err);
+        }
+        return res.json();
+    }
+    // ==========================================
+    // DIRECTORY BROWSING
+    // ==========================================
+    /**
+     * Lists folders and files in a directory
+     */
+    async listContents(params) {
+        const { projectId, folderId = "root" } = params;
+        const res = await fetch(`${this.baseUrl}/api/storage/contents?projectId=${encodeURIComponent(projectId)}&folderId=${encodeURIComponent(folderId)}`, {
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new CloudizeroError(err.error || `Failed to list contents (${res.status})`, res.status, err);
+        }
+        const data = await res.json();
+        if (this.cdnUrl && data.files) {
+            data.files = data.files.map((f) => ({
+                ...f,
+                url: `${this.cdnUrl}/${f.r2Key}`,
+            }));
+        }
+        return data;
+    }
+    getByteLength(file) {
+        if (typeof file === "object" && file !== null) {
+            if ("size" in file && typeof file.size === "number") {
+                return file.size;
+            }
+            if ("byteLength" in file && typeof file.byteLength === "number") {
+                return file.byteLength;
+            }
+            if ("length" in file && typeof file.length === "number") {
+                return file.length;
+            }
+        }
+        return 0;
+    }
+    async uploadBinary(uploadUrl, file, mimeType, onProgress) {
+        // Browser environment with XMLHttpRequest (supports accurate progress events)
+        if (typeof window !== "undefined" && typeof XMLHttpRequest !== "undefined") {
+            return new Promise((resolve, reject) => {
+                const xhr = new XMLHttpRequest();
+                xhr.open("PUT", uploadUrl, true);
+                xhr.setRequestHeader("Content-Type", mimeType);
+                if (onProgress) {
+                    xhr.upload.onprogress = (e) => {
+                        if (e.lengthComputable) {
+                            const percent = Math.round((e.loaded / e.total) * 100);
+                            onProgress({ loaded: e.loaded, total: e.total, percent });
+                        }
+                    };
+                }
+                xhr.onload = () => {
+                    if (xhr.status >= 200 && xhr.status < 300) {
+                        resolve();
+                    }
+                    else {
+                        reject(new CloudizeroError(`R2 upload failed with HTTP status ${xhr.status}`, xhr.status));
+                    }
+                };
+                xhr.onerror = () => reject(new CloudizeroError("Network error occurred during direct R2 upload"));
+                xhr.send(file);
+            });
+        }
+        // Node.js or non-browser environments using native fetch
+        const res = await fetch(uploadUrl, {
+            method: "PUT",
+            headers: {
+                "Content-Type": mimeType,
+            },
+            body: file,
+        });
+        if (!res.ok) {
+            throw new CloudizeroError(`R2 upload failed with HTTP status ${res.status}`, res.status);
+        }
+        if (onProgress) {
+            const size = this.getByteLength(file);
+            onProgress({ loaded: size, total: size, percent: 100 });
+        }
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,248 @@
+export interface CloudizeroConfig {
+    /**
+     * Cloudizero API Key starting with `cz_live_`.
+     * If omitted, falls back to `process.env.CLOUDIZERO_API_KEY`.
+     */
+    apiKey?: string;
+    /**
+     * The base URL of your Cloudizero API deployment.
+     * Defaults to `process.env.CLOUDIZERO_BASE_URL` or `https://api-cloudizero.wismannur.pro`.
+     */
+    baseUrl?: string;
+    /**
+     * The public CDN URL for serving assets (e.g. `https://cdn-cloudizero.wismannur.pro`).
+     * Defaults to `process.env.CLOUDIZERO_CDN_URL` or `https://cdn-cloudizero.wismannur.pro`.
+     */
+    cdnUrl?: string;
+}
+export type UploadPayload = File | Blob | Uint8Array | ArrayBuffer | {
+    [key: string]: unknown;
+};
+export interface UploadOptions {
+    /**
+     * File data to upload.
+     * Supports browser `File`/`Blob` and Node.js `Buffer`/`Uint8Array`.
+     */
+    file: UploadPayload;
+    /**
+     * The name of the file (e.g. `avatar.png` or `report.pdf`)
+     */
+    fileName: string;
+    /**
+     * The target Project ID
+     */
+    projectId: string;
+    /**
+     * Optional target Folder ID within the project
+     */
+    folderId?: string | null;
+    /**
+     * The MIME type of the file (e.g. `image/png`, `video/mp4`).
+     * If omitted, will default to `application/octet-stream`.
+     */
+    mimeType?: string;
+    /**
+     * Image width (optional metadata)
+     */
+    width?: number | null;
+    /**
+     * Image height (optional metadata)
+     */
+    height?: number | null;
+    /**
+     * Upload progress callback
+     */
+    onProgress?: (progress: {
+        loaded: number;
+        total: number;
+        percent: number;
+    }) => void;
+}
+export interface UpdateFileOptions {
+    /**
+     * The ID of the file to update
+     */
+    fileId: string;
+    /**
+     * Optional new file name (e.g. `hero-banner.webp`).
+     * Automatically moves/renames the underlying object in Cloudflare R2.
+     */
+    name?: string;
+    /**
+     * Optional target Folder ID to move the file into (`null` or `"root"` moves to root).
+     * Automatically moves the underlying object in Cloudflare R2.
+     */
+    folderId?: string | null;
+    /**
+     * Optional soft-delete trash status
+     */
+    isTrash?: boolean;
+    /**
+     * Optional binary payload to replace the file content in-place.
+     * If provided, the SDK will upload the new binary to R2 and update metadata.
+     */
+    file?: UploadPayload;
+    /**
+     * Optional MIME type when replacing file content
+     */
+    mimeType?: string;
+    /**
+     * Optional updated image width
+     */
+    width?: number | null;
+    /**
+     * Optional updated image height
+     */
+    height?: number | null;
+    /**
+     * Upload progress callback (used when `file` binary payload is provided)
+     */
+    onProgress?: (progress: {
+        loaded: number;
+        total: number;
+        percent: number;
+    }) => void;
+}
+export interface ReplaceFileOptions {
+    /**
+     * The ID of the existing file to replace
+     */
+    fileId: string;
+    /**
+     * New binary file payload
+     */
+    file: UploadPayload;
+    /**
+     * Optional new file name (if omitted, keeps existing file name)
+     */
+    fileName?: string;
+    /**
+     * Optional new target Folder ID (if omitted, keeps existing folder)
+     */
+    folderId?: string | null;
+    /**
+     * Optional MIME type of the new file
+     */
+    mimeType?: string;
+    /**
+     * Optional new width
+     */
+    width?: number | null;
+    /**
+     * Optional new height
+     */
+    height?: number | null;
+    /**
+     * Upload progress callback
+     */
+    onProgress?: (progress: {
+        loaded: number;
+        total: number;
+        percent: number;
+    }) => void;
+}
+export interface UploadedFile {
+    id: string;
+    projectId: string;
+    folderId: string | null;
+    name: string;
+    mimeType: string;
+    size: number;
+    width: number | null;
+    height: number | null;
+    r2Key: string;
+    etag: string | null;
+    isTrash?: boolean;
+    createdAt: string;
+    updatedAt: string;
+    /**
+     * Resolved public CDN URL
+     */
+    url?: string;
+}
+export interface StorageFolder {
+    id: string;
+    projectId: string;
+    parentId: string | null;
+    name: string;
+    path: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateFolderOptions {
+    /**
+     * Target Project ID
+     */
+    projectId: string;
+    /**
+     * Folder display name (e.g. `avatars` or `Marketing Banners`)
+     */
+    name: string;
+    /**
+     * Optional parent Folder ID (`null` or `"root"` for project root)
+     */
+    parentId?: string | null;
+    /**
+     * Optional custom virtual path (auto-generated from parent path + slugified name if omitted)
+     */
+    path?: string;
+}
+export interface ListFoldersOptions {
+    /**
+     * Target Project ID
+     */
+    projectId: string;
+    /**
+     * Optional parent Folder ID (`null` or `"root"` lists root-level folders)
+     */
+    parentId?: string | null;
+}
+export interface UpdateFolderOptions {
+    /**
+     * The ID of the folder to update
+     */
+    folderId: string;
+    /**
+     * Optional new folder name.
+     * Automatically updates paths and moves underlying R2 objects for all nested files.
+     */
+    name?: string;
+    /**
+     * Optional new parent Folder ID (`null` or `"root"` moves folder to project root).
+     * Automatically updates paths and moves underlying R2 objects for all nested files.
+     */
+    parentId?: string | null;
+}
+export interface DeleteFolderResult {
+    success: boolean;
+    message: string;
+    deletedFoldersCount: number;
+    deletedFilesCount: number;
+}
+export interface Project {
+    id: string;
+    userId: string;
+    name: string;
+    description?: string | null;
+    sortOrder: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateProjectOptions {
+    name: string;
+    description?: string;
+}
+export interface StorageContents {
+    project: {
+        id: string;
+        name: string;
+    };
+    isRoot: boolean;
+    breadcrumbs: {
+        id: string;
+        name: string;
+    }[];
+    folders: StorageFolder[];
+    files: UploadedFile[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@cloudizero/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "type": "module",
+  "description": "Official TypeScript SDK for Cloudizero Zero-Egress Media Platform",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://cloudizero.wismannur.pro/docs",
+  "keywords": [
+    "cloudizero",
+    "dam",
+    "zero-egress",
+    "cloudflare-r2",
+    "media-upload",
+    "sdk"
+  ],
+  "author": "Wisman Nur",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}
+