@cloudizero/sdk 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,120 @@
-# Temporary Holding Version
+# @cloudizero/sdk
 
-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.
+> Official TypeScript SDK for the **Cloudizero** Zero-Egress Digital Asset Management & Media Delivery Platform.
+
+Seamlessly upload, manage, and deliver media files 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";
+
+const cz = new Cloudizero({
+  apiKey: process.env.CLOUDIZERO_API_KEY!, // e.g. "cz_live_9f8a..."
+  baseUrl: "https://cloudizero.wismannur.pro", // your Cloudizero deployment
+  cdnUrl: "https://cdn-cloudizero.wismannur.pro", // optional public CDN domain
+});
+```
+
+---
+
+## 📂 Usage Examples
+
+### 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: "profiles", // optional virtual folder
+  mimeType: "image/png",
+});
+
+console.log("Uploaded successfully!");
+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);
+};
+```
+
+---
+
+### List Project Media & Folders
+
+```typescript
+const contents = await cz.storage.listContents({
+  projectId: "your-project-id",
+  folderId: "profiles", // or omit for root
+});
+
+console.log("Folders:", contents.folders);
+console.log("Files:", contents.files);
+```
+
+---
+
+### Delete Asset Permanently
+
+```typescript
+await cz.storage.deleteFile("file-id-here");
+console.log("File permanently removed from R2 & DB");
+```
+
+---
+
+## 🔒 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 a specific project to follow the principle of least privilege.
+
+---
+
+## 📄 License
+
+MIT © [Wisman Nur](https://wismannur.pro)

package/dist/client.d.ts

@@ -0,0 +1,10 @@
+import { CloudizeroConfig } from "./types.js";
+import { StorageClient } from "./storage.js";
+export declare class Cloudizero {
+    /**
+     * Media Storage & Ingestion methods
+     */
+    readonly storage: StorageClient;
+    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;AAE7C,qBAAa,UAAU;IACrB;;OAEG;IACH,SAAgB,OAAO,EAAE,aAAa,CAAC;gBAE3B,MAAM,EAAE,gBAAgB;CAGrC"}

package/dist/client.js

@@ -0,0 +1,11 @@
+import { StorageClient } from "./storage.js";
+export class Cloudizero {
+    /**
+     * Media Storage & Ingestion methods
+     */
+    storage;
+    constructor(config) {
+        this.storage = new StorageClient(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;AAE7C,MAAM,OAAO,UAAU;IACrB;;OAEG;IACa,OAAO,CAAgB;IAEvC,YAAY,MAAwB;QAClC,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,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,5 @@
+export { Cloudizero } from "./client.js";
+export { StorageClient } from "./storage.js";
+export { CloudizeroError } from "./errors.js";
+export type { CloudizeroConfig, UploadOptions, UploadedFile, StorageContents, UploadPayload, } 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,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { Cloudizero } from "./client.js";
+export { StorageClient } from "./storage.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,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/storage.d.ts

@@ -0,0 +1,35 @@
+import { CloudizeroConfig, UploadOptions, UploadedFile, StorageContents } from "./types.js";
+export declare class StorageClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly cdnUrl?;
+    constructor(config: CloudizeroConfig);
+    /**
+     * Uploads a file directly to Cloudflare R2 via presigned PUT URL and records metadata.
+     */
+    upload(options: UploadOptions): Promise<UploadedFile>;
+    /**
+     * Gets file details and generates a presigned private download URL
+     */
+    getFile(fileId: string): Promise<{
+        file: UploadedFile;
+        downloadUrl: string;
+    }>;
+    /**
+     * Deletes a file permanently from Cloudflare R2 and Neon DB
+     */
+    deleteFile(fileId: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * 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,YAAY,EACZ,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,EAAE,gBAAgB;IASpC;;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;IAwBnF;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAoBhF;;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,187 @@
+import { CloudizeroError } from "./errors.js";
+export class StorageClient {
+    apiKey;
+    baseUrl;
+    cdnUrl;
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new CloudizeroError("Cloudizero API key is required");
+        }
+        this.apiKey = config.apiKey;
+        this.baseUrl = (config.baseUrl || "http://localhost:7010").replace(/\/+$/, "");
+        this.cdnUrl = config.cdnUrl ? config.cdnUrl.replace(/\/+$/, "") : undefined;
+    }
+    /**
+     * 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;
+    }
+    /**
+     * Gets file details and generates a presigned private download URL
+     */
+    async getFile(fileId) {
+        const res = await fetch(`${this.baseUrl}/api/storage/files?fileId=${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;
+    }
+    /**
+     * Deletes a file permanently from Cloudflare R2 and Neon DB
+     */
+    async deleteFile(fileId) {
+        const res = await fetch(`${this.baseUrl}/api/storage/files?fileId=${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();
+    }
+    /**
+     * 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=${projectId}&folderId=${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,96 @@
+export interface CloudizeroConfig {
+    /**
+     * Cloudizero API Key starting with `cz_live_`
+     */
+    apiKey: string;
+    /**
+     * The base URL of your Cloudizero deployment.
+     * Defaults to `https://cloudizero.com` (or current app URL).
+     */
+    baseUrl?: string;
+    /**
+     * The public CDN URL for serving assets (e.g. `https://cdn.wismannur.pro`).
+     * Optional; if provided, will be attached to uploaded file results as `url`.
+     */
+    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 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;
+    createdAt: string;
+    updatedAt: string;
+    /**
+     * Resolved public CDN URL
+     */
+    url?: string;
+}
+export interface StorageContents {
+    project: {
+        id: string;
+        name: string;
+    };
+    isRoot: boolean;
+    breadcrumbs: {
+        id: string;
+        name: string;
+    }[];
+    folders: {
+        id: string;
+        name: string;
+        path: string;
+        createdAt: string;
+    }[];
+    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":"AAAA,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GACrB,IAAI,GACJ,IAAI,GACJ,UAAU,GACV,WAAW,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE/B,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACrF;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;IACJ,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,EAAE,CAAC;IACJ,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB"}

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,46 @@
 {
   "name": "@cloudizero/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.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"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wismannur/cloudizero.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://cloudizero.wismannur.pro",
+  "keywords": [
+    "cloudizero",
+    "dam",
+    "zero-egress",
+    "cloudflare-r2",
+    "media-upload",
+    "sdk"
+  ],
+  "author": "Wisman Nur",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}
+