@sarangkale66/pixxo-sdk-node 1.0.0

package/README.md

@@ -0,0 +1,107 @@
+# Pixxo Node.js SDK
+
+> Drop-in replacement for the [ImageKit Node.js SDK](https://github.com/imagekit-developer/imagekit-nodejs). Swap `import ImageKit from 'imagekit'` with `import Pixxo from 'pixxo'` — zero refactor required.
+
+## Installation
+
+```bash
+npm install pixxo
+```
+
+## Quick Start
+
+```ts
+import Pixxo from "pixxo";
+import fs from "fs";
+
+const pixxo = new Pixxo({
+  email: "you@example.com",
+  password: "your-password",
+});
+
+const result = await pixxo.upload({
+  file: fs.readFileSync("receipt.pdf"),
+  fileName: "receipt.pdf",
+  folder: "/receipts",
+});
+
+console.log(result.url);    // https://px.pixxo.io/…
+console.log(result.fileId); // MongoDB ObjectId
+console.log(result.name);   // receipt.pdf
+```
+
+## Constructor Options
+
+| Option | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `email` | `string` | ✅ | — | Pixxo account email |
+| `password` | `string` | ✅ | — | Pixxo account password |
+| `baseUrl` | `string` | — | `https://api.pixxo.io` | API base URL |
+| `cdnDomain` | `string` | — | `px.pixxo.io` | CDN domain for returned URLs |
+| `maxRetries` | `number` | — | `2` | Retry attempts for S3 upload failures |
+| `publicKey` | `string` | — | — | *Ignored* (ImageKit compat) |
+| `privateKey` | `string` | — | — | *Ignored* (ImageKit compat) |
+| `urlEndpoint` | `string` | — | — | *Ignored* (ImageKit compat) |
+
+## `upload(options)`
+
+### Options
+
+| Option | Type | Required | Description |
+|---|---|---|---|
+| `file` | `Buffer \| string` | ✅ | Buffer, base64 string, or file path |
+| `fileName` | `string` | ✅ | File name with extension |
+| `folder` | `string` | — | Destination folder (e.g. `"/receipts"`) |
+| `useUniqueFileName` | `boolean` | — | Append unique suffix (default: `true`) |
+
+### Response
+
+```ts
+{
+  url: string;      // CDN URL
+  fileId: string;   // Pixxo asset ID
+  name: string;     // Stored file name
+  fileType: string;  // MIME type
+  size: number;     // Size in bytes
+  folderId: string | null;
+  s3Key: string;
+}
+```
+
+## Migration from ImageKit
+
+```diff
+- import ImageKit from "imagekit";
++ import Pixxo from "pixxo";
+
+- const imagekit = new ImageKit({
+-   publicKey: "...",
+-   privateKey: "...",
+-   urlEndpoint: "...",
+- });
++ const imagekit = new Pixxo({
++   email: "you@example.com",
++   password: "your-password",
++ });
+
+// Everything else stays the same!
+const result = await imagekit.upload({
+  file: buffer,
+  fileName: "photo.jpg",
+  folder: "/products",
+});
+console.log(result.url);
+```
+
+## Features
+
+- **Token caching** — authenticates once, reuses token until expiry
+- **Automatic retry** — exponential back-off for S3 upload failures
+- **Recursive folder creation** — deeply nested paths just work
+- **Multiple file input types** — Buffer, base64, file path
+- **ImageKit-compatible response** — `url`, `fileId`, `name`
+- **Zero dependencies** — uses native `fetch` (Node 18+)
+
+## License
+
+MIT

package/dist/errors.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Custom error class for Pixxo SDK errors.
+ * Provides HTTP status code + API response data when available.
+ */
+export declare class PixxoError extends Error {
+    readonly status: number;
+    readonly data: unknown;
+    constructor(message: string, status?: number, data?: unknown);
+}
+/**
+ * Type guard for PixxoError
+ */
+export declare function isPixxoError(err: unknown): err is PixxoError;
+//# 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;;;GAGG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,OAAO,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,EAAE,IAAI,GAAE,OAAc;CAStE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAE5D"}

package/dist/errors.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PixxoError = void 0;
+exports.isPixxoError = isPixxoError;
+/**
+ * Custom error class for Pixxo SDK errors.
+ * Provides HTTP status code + API response data when available.
+ */
+class PixxoError extends Error {
+    status;
+    data;
+    constructor(message, status = 0, data = null) {
+        super(message);
+        this.name = "PixxoError";
+        this.status = status;
+        this.data = data;
+        // Maintain proper prototype chain (required for `instanceof`)
+        Object.setPrototypeOf(this, PixxoError.prototype);
+    }
+}
+exports.PixxoError = PixxoError;
+/**
+ * Type guard for PixxoError
+ */
+function isPixxoError(err) {
+    return err instanceof PixxoError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAsBA,oCAEC;AAxBD;;;GAGG;AACH,MAAa,UAAW,SAAQ,KAAK;IACnB,MAAM,CAAS;IACf,IAAI,CAAU;IAE9B,YAAY,OAAe,EAAE,SAAiB,CAAC,EAAE,OAAgB,IAAI;QACnE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,8DAA8D;QAC9D,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAbD,gCAaC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,GAAY;IACvC,OAAO,GAAG,YAAY,UAAU,CAAC;AACnC,CAAC"}

package/dist/folder.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Ensures the full folder path exists on the Pixxo backend,
+ * creating any missing segments along the way.
+ *
+ * On 409 (duplicate), it fetches the existing folder instead of failing.
+ *
+ * @returns The MongoDB `_id` of the deepest (leaf) folder.
+ */
+export declare function ensureFolderPath(baseUrl: string, folderPath: string, token: string): Promise<string>;
+//# sourceMappingURL=folder.d.ts.map

package/dist/folder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder.d.ts","sourceRoot":"","sources":["../src/folder.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAgDjB"}

package/dist/folder.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureFolderPath = ensureFolderPath;
+const http_1 = require("./http");
+const errors_1 = require("./errors");
+/**
+ * Ensures the full folder path exists on the Pixxo backend,
+ * creating any missing segments along the way.
+ *
+ * On 409 (duplicate), it fetches the existing folder instead of failing.
+ *
+ * @returns The MongoDB `_id` of the deepest (leaf) folder.
+ */
+async function ensureFolderPath(baseUrl, folderPath, token) {
+    const segments = folderPath
+        .split("/")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    if (segments.length === 0) {
+        throw new errors_1.PixxoError("Folder path cannot be empty");
+    }
+    let parentId = null;
+    for (const name of segments) {
+        try {
+            const data = await (0, http_1.postJSON)(`${baseUrl}/api/folders`, { name, parentId }, token);
+            parentId = data.data.folder._id;
+        }
+        catch (err) {
+            if (err instanceof errors_1.PixxoError && err.status === 409) {
+                // Folder exists – look it up
+                const listData = await (0, http_1.getJSON)(`${baseUrl}/api/folders`, token, parentId ? { parentId } : {});
+                const existing = listData.data.folders.find((f) => f.name.toLowerCase() === name.toLowerCase());
+                if (!existing) {
+                    throw new errors_1.PixxoError(`Folder "${name}" reportedly exists but could not be found in listing`);
+                }
+                parentId = existing._id;
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    return parentId;
+}
+//# sourceMappingURL=folder.js.map

package/dist/folder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder.js","sourceRoot":"","sources":["../src/folder.ts"],"names":[],"mappings":";;AAYA,4CAoDC;AAhED,iCAA2C;AAC3C,qCAAsC;AAGtC;;;;;;;GAOG;AACI,KAAK,UAAU,gBAAgB,CACpC,OAAe,EACf,UAAkB,EAClB,KAAa;IAEb,MAAM,QAAQ,GAAG,UAAU;SACxB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,mBAAU,CAAC,6BAA6B,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,QAAQ,GAAkB,IAAI,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,IAAI,GAAyB,MAAM,IAAA,eAAQ,EAC/C,GAAG,OAAO,cAAc,EACxB,EAAE,IAAI,EAAE,QAAQ,EAAE,EAClB,KAAK,CACN,CAAC;YACF,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,mBAAU,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACpD,6BAA6B;gBAC7B,MAAM,QAAQ,GAAuB,MAAM,IAAA,cAAO,EAChD,GAAG,OAAO,cAAc,EACxB,KAAK,EACL,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAC7B,CAAC;gBAEF,MAAM,QAAQ,GACZ,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CACxB,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CACnE,CAAC;gBAEJ,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,MAAM,IAAI,mBAAU,CAClB,WAAW,IAAI,uDAAuD,CACvE,CAAC;gBACJ,CAAC;gBAED,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAkB,CAAC;AAC5B,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,7 @@
+export declare function postJSON<T>(url: string, body: unknown, token?: string): Promise<T>;
+export declare function getJSON<T>(url: string, token: string, params?: Record<string, string>): Promise<T>;
+/**
+ * Upload a raw buffer to an S3 presigned URL via PUT.
+ */
+export declare function putS3(uploadUrl: string, buffer: Buffer, contentType: string): Promise<void>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAIA,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,CAAC,CAAC,CAuBZ;AAED,wBAAsB,OAAO,CAAC,CAAC,EAC7B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAClC,OAAO,CAAC,CAAC,CAAC,CAmBZ;AAED;;GAEG;AACH,wBAAsB,KAAK,CACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/http.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.postJSON = postJSON;
+exports.getJSON = getJSON;
+exports.putS3 = putS3;
+const errors_1 = require("./errors");
+// ─── Generic JSON helpers ──────────────────────────────────────────────────
+async function postJSON(url, body, token) {
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (token)
+        headers["Authorization"] = `Bearer ${token}`;
+    const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body),
+    });
+    const data = (await res.json());
+    if (!res.ok) {
+        throw new errors_1.PixxoError(data?.error ?? `HTTP ${res.status}`, res.status, data);
+    }
+    return data;
+}
+async function getJSON(url, token, params = {}) {
+    const qs = new URLSearchParams(params).toString();
+    const fullUrl = qs ? `${url}?${qs}` : url;
+    const res = await fetch(fullUrl, {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    const data = (await res.json());
+    if (!res.ok) {
+        throw new errors_1.PixxoError(data?.error ?? `HTTP ${res.status}`, res.status, data);
+    }
+    return data;
+}
+/**
+ * Upload a raw buffer to an S3 presigned URL via PUT.
+ */
+async function putS3(uploadUrl, buffer, contentType) {
+    const res = await fetch(uploadUrl, {
+        method: "PUT",
+        headers: {
+            "Content-Type": contentType,
+            "Content-Length": String(buffer.length),
+        },
+        body: buffer,
+        duplex: "half",
+    });
+    if (!res.ok) {
+        throw new errors_1.PixxoError(`S3 upload failed: ${res.status} ${res.statusText}`, res.status);
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";;AAIA,4BA2BC;AAED,0BAuBC;AAKD,sBAqBC;AAlFD,qCAAsC;AAEtC,8EAA8E;AAEvE,KAAK,UAAU,QAAQ,CAC5B,GAAW,EACX,IAAa,EACb,KAAc;IAEd,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;KACnC,CAAC;IACF,IAAI,KAAK;QAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAC;IAExD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,MAAM,EAAE,MAAM;QACd,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA2B,CAAC;IAE1D,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,mBAAU,CAClB,IAAI,EAAE,KAAK,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,EACnC,GAAG,CAAC,MAAM,EACV,IAAI,CACL,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAEM,KAAK,UAAU,OAAO,CAC3B,GAAW,EACX,KAAa,EACb,SAAiC,EAAE;IAEnC,MAAM,EAAE,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAE1C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE;QAC/B,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE;KAC9C,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA2B,CAAC;IAE1D,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,mBAAU,CAClB,IAAI,EAAE,KAAK,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,EACnC,GAAG,CAAC,MAAM,EACV,IAAI,CACL,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,KAAK,CACzB,SAAiB,EACjB,MAAc,EACd,WAAmB;IAEnB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE;QACjC,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACP,cAAc,EAAE,WAAW;YAC3B,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;SACxC;QACD,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,MAAe;KACT,CAAC,CAAC;IAElB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,mBAAU,CAClB,qBAAqB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,EACnD,GAAG,CAAC,MAAM,CACX,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pixxo Node.js SDK
+ *
+ * Drop‑in replacement for the ImageKit Node.js SDK.
+ *
+ * @example
+ * ```ts
+ * import Pixxo from "pixxo";
+ *
+ * const pixxo = new Pixxo({
+ *   email: "user@example.com",
+ *   password: "secret",
+ * });
+ *
+ * const res = await pixxo.upload({
+ *   file: fs.readFileSync("photo.jpg"),
+ *   fileName: "photo.jpg",
+ *   folder: "/products",
+ * });
+ *
+ * console.log(res.url);   // https://px.pixxo.io/…
+ * console.log(res.fileId); // Mongo ObjectId
+ * ```
+ *
+ * @module pixxo
+ */
+export { default } from "./pixxo";
+export { default as Pixxo } from "./pixxo";
+export type { PixxoConfig, UploadOptions, UploadResponse } from "./types";
+export { PixxoError, isPixxoError } from "./errors";
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC;AAG3C,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Pixxo Node.js SDK
+ *
+ * Drop‑in replacement for the ImageKit Node.js SDK.
+ *
+ * @example
+ * ```ts
+ * import Pixxo from "pixxo";
+ *
+ * const pixxo = new Pixxo({
+ *   email: "user@example.com",
+ *   password: "secret",
+ * });
+ *
+ * const res = await pixxo.upload({
+ *   file: fs.readFileSync("photo.jpg"),
+ *   fileName: "photo.jpg",
+ *   folder: "/products",
+ * });
+ *
+ * console.log(res.url);   // https://px.pixxo.io/…
+ * console.log(res.fileId); // Mongo ObjectId
+ * ```
+ *
+ * @module pixxo
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPixxoError = exports.PixxoError = exports.Pixxo = exports.default = void 0;
+var pixxo_1 = require("./pixxo");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(pixxo_1).default; } });
+var pixxo_2 = require("./pixxo");
+Object.defineProperty(exports, "Pixxo", { enumerable: true, get: function () { return __importDefault(pixxo_2).default; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "PixxoError", { enumerable: true, get: function () { return errors_1.PixxoError; } });
+Object.defineProperty(exports, "isPixxoError", { enumerable: true, get: function () { return errors_1.isPixxoError; } });
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;;;;AAEH,iCAAkC;AAAzB,iHAAA,OAAO,OAAA;AAChB,iCAA2C;AAAlC,+GAAA,OAAO,OAAS;AAIzB,mCAAoD;AAA3C,oGAAA,UAAU,OAAA;AAAE,sGAAA,YAAY,OAAA"}

package/dist/pixxo.d.ts

@@ -0,0 +1,44 @@
+import type { PixxoConfig, UploadOptions, UploadResponse } from "./types";
+declare class Pixxo {
+    private readonly email;
+    private readonly password;
+    private readonly baseUrl;
+    private readonly cdnDomain;
+    private readonly maxRetries;
+    /** Cached JWT token */
+    private token;
+    /** Timestamp (ms) when the cached token expires */
+    private tokenExpiry;
+    constructor(config: PixxoConfig);
+    /**
+     * Get a valid JWT token, re‑authenticating only when needed.
+     */
+    private getToken;
+    /**
+     * Upload a file to Pixxo.
+     *
+     * Drop‑in replacement for `ImageKit.upload()`.
+     *
+     * ```ts
+     * const res = await pixxo.upload({
+     *   file: fs.readFileSync("receipt.pdf"),
+     *   fileName: "receipt.pdf",
+     *   folder: "/receipts",
+     * });
+     * console.log(res.url);
+     * ```
+     */
+    upload(options: UploadOptions): Promise<UploadResponse>;
+    private uploadWithRetry;
+    /**
+     * Replace the CloudFront origin domain with the custom CDN domain.
+     */
+    private rewriteCdnUrl;
+    /**
+     * Build a CDN URL from an S3 key (fallback when the asset response
+     * doesn't provide a CloudFront URL, e.g. on 409).
+     */
+    private buildCdnUrl;
+}
+export default Pixxo;
+//# sourceMappingURL=pixxo.d.ts.map

package/dist/pixxo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixxo.d.ts","sourceRoot":"","sources":["../src/pixxo.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAGV,WAAW,EACX,aAAa,EACb,cAAc,EAEf,MAAM,SAAS,CAAC;AAajB,cAAM,KAAK;IACT,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,uBAAuB;IACvB,OAAO,CAAC,KAAK,CAAuB;IACpC,mDAAmD;IACnD,OAAO,CAAC,WAAW,CAAa;gBAEpB,MAAM,EAAE,WAAW;IAa/B;;OAEG;YACW,QAAQ;IAuBtB;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;YAgF/C,eAAe;IAyB7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;;OAGG;IACH,OAAO,CAAC,WAAW;CAGpB;AAED,eAAe,KAAK,CAAC"}

package/dist/pixxo.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const http_1 = require("./http");
+const errors_1 = require("./errors");
+const folder_1 = require("./folder");
+const utils_1 = require("./utils");
+// ─── Constants ─────────────────────────────────────────────────────────────
+const DEFAULT_BASE_URL = "https://api.pixxo.io";
+const DEFAULT_CDN_DOMAIN = "px.pixxo.io";
+const CLOUDFRONT_ORIGIN = "d10i6f9i6i5qro.cloudfront.net";
+const TOKEN_SAFETY_MARGIN_MS = 5 * 60 * 1000; // refresh 5 min before expiry
+const DEFAULT_TOKEN_LIFETIME_MS = 24 * 60 * 60 * 1000; // assume 24h if unknown
+const DEFAULT_MAX_RETRIES = 2;
+// ─── Pixxo SDK ─────────────────────────────────────────────────────────────
+class Pixxo {
+    email;
+    password;
+    baseUrl;
+    cdnDomain;
+    maxRetries;
+    /** Cached JWT token */
+    token = null;
+    /** Timestamp (ms) when the cached token expires */
+    tokenExpiry = 0;
+    constructor(config) {
+        if (!config.email)
+            throw new errors_1.PixxoError("email is required");
+        if (!config.password)
+            throw new errors_1.PixxoError("password is required");
+        this.email = config.email;
+        this.password = config.password;
+        this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.cdnDomain = config.cdnDomain ?? DEFAULT_CDN_DOMAIN;
+        this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+    }
+    // ── Authentication ─────────────────────────────────────────────────────
+    /**
+     * Get a valid JWT token, re‑authenticating only when needed.
+     */
+    async getToken() {
+        if (this.token && Date.now() < this.tokenExpiry) {
+            return this.token;
+        }
+        const res = await (0, http_1.postJSON)(`${this.baseUrl}/api/auth/login`, { email: this.email, password: this.password });
+        const token = res?.data?.token ?? res?.token;
+        if (!token) {
+            throw new errors_1.PixxoError("Login succeeded but no token was returned");
+        }
+        this.token = token;
+        this.tokenExpiry = Date.now() + DEFAULT_TOKEN_LIFETIME_MS - TOKEN_SAFETY_MARGIN_MS;
+        return token;
+    }
+    // ── Upload ─────────────────────────────────────────────────────────────
+    /**
+     * Upload a file to Pixxo.
+     *
+     * Drop‑in replacement for `ImageKit.upload()`.
+     *
+     * ```ts
+     * const res = await pixxo.upload({
+     *   file: fs.readFileSync("receipt.pdf"),
+     *   fileName: "receipt.pdf",
+     *   folder: "/receipts",
+     * });
+     * console.log(res.url);
+     * ```
+     */
+    async upload(options) {
+        // ── Resolve file ─────────────────────────────────────────────────
+        const buffer = (0, utils_1.resolveFileToBuffer)(options.file);
+        const fileName = options.fileName;
+        const fileType = (0, utils_1.getMimeType)(fileName);
+        const fileSize = buffer.length;
+        // ── Normalise folder ─────────────────────────────────────────────
+        const folderPath = (0, utils_1.normalizeFolderPath)(options.folder);
+        // ── Authenticate ─────────────────────────────────────────────────
+        const token = await this.getToken();
+        // ── Ensure folder + get presigned URL (parallel) ─────────────────
+        const folderPromise = folderPath
+            ? (0, folder_1.ensureFolderPath)(this.baseUrl, folderPath, token)
+            : Promise.resolve(null);
+        const uploadUrlPromise = (0, http_1.postJSON)(`${this.baseUrl}/api/assets/upload-url`, {
+            fileName,
+            fileType,
+            fileSize,
+            folder: folderPath || undefined,
+            customFileName: options.useUniqueFileName === false ? fileName : undefined,
+        }, token);
+        const [folderId, uploadUrlData] = await Promise.all([
+            folderPromise,
+            uploadUrlPromise,
+        ]);
+        const { uploadUrl, s3Key, s3Bucket } = uploadUrlData.data;
+        // ── Upload to S3 with retry ──────────────────────────────────────
+        await this.uploadWithRetry(uploadUrl, buffer, fileType);
+        // ── Register asset in backend ────────────────────────────────────
+        let asset;
+        try {
+            asset = await (0, http_1.postJSON)(`${this.baseUrl}/api/assets`, { fileName, fileType, fileSize, s3Key, s3Bucket, folderId }, token);
+        }
+        catch (err) {
+            // 409 = asset already exists – treat as success for idempotency
+            if (err instanceof errors_1.PixxoError && err.status === 409) {
+                return {
+                    url: this.buildCdnUrl(s3Key),
+                    fileId: "",
+                    name: fileName,
+                    fileType,
+                    size: fileSize,
+                    folderId,
+                    s3Key,
+                };
+            }
+            throw err;
+        }
+        const created = asset.data.asset;
+        return {
+            url: this.rewriteCdnUrl(created.cloudfrontUrl),
+            fileId: created._id,
+            name: created.name,
+            fileType: created.type,
+            size: created.sizeBytes,
+            folderId: created.folderId,
+            s3Key: created.s3Key,
+        };
+    }
+    // ── Retry helper ───────────────────────────────────────────────────────
+    async uploadWithRetry(uploadUrl, buffer, contentType) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            try {
+                await (0, http_1.putS3)(uploadUrl, buffer, contentType);
+                return;
+            }
+            catch (err) {
+                lastError = err;
+                if (attempt < this.maxRetries) {
+                    // Exponential back-off: 500ms, 1s, 2s …
+                    await (0, utils_1.sleep)(500 * Math.pow(2, attempt));
+                }
+            }
+        }
+        throw lastError;
+    }
+    // ── URL helpers ────────────────────────────────────────────────────────
+    /**
+     * Replace the CloudFront origin domain with the custom CDN domain.
+     */
+    rewriteCdnUrl(cloudfrontUrl) {
+        return cloudfrontUrl.replace(CLOUDFRONT_ORIGIN, this.cdnDomain);
+    }
+    /**
+     * Build a CDN URL from an S3 key (fallback when the asset response
+     * doesn't provide a CloudFront URL, e.g. on 409).
+     */
+    buildCdnUrl(s3Key) {
+        return `https://${this.cdnDomain}/${s3Key}`;
+    }
+}
+exports.default = Pixxo;
+//# sourceMappingURL=pixxo.js.map

package/dist/pixxo.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Configuration for the Pixxo SDK.
+ *
+ * `publicKey` and `privateKey` are accepted for ImageKit compatibility
+ * but are NOT used by the Pixxo backend – they are silently ignored.
+ */
+export interface PixxoConfig {
+    email: string;
+    password: string;
+    /** Override API base URL (default: https://api.pixxo.io) */
+    baseUrl?: string;
+    /** Override CDN domain for returned URLs (default: px.pixxo.io) */
+    cdnDomain?: string;
+    /** Max retry attempts for upload failures (default: 2) */
+    maxRetries?: number;
+    publicKey?: string;
+    privateKey?: string;
+    urlEndpoint?: string;
+}
+export interface UploadOptions {
+    /**
+     * The file to upload.
+     * - `Buffer` – raw bytes
+     * - `string` – base64‑encoded data **or** an absolute/relative file path
+     */
+    file: Buffer | string;
+    /** Desired file name including extension */
+    fileName: string;
+    /**
+     * Destination folder path (ImageKit style, with leading slash).
+     * e.g. `"/receipts"` or `"/products/images"`
+     *
+     * Internally normalised to Pixxo format (no leading slash).
+     */
+    folder?: string;
+    /** Whether to append a unique suffix to the file name (default: true) */
+    useUniqueFileName?: boolean;
+    /** Optional tags – accepted for ImageKit compat, currently ignored */
+    tags?: string[];
+    /** Any extra metadata – forwarded if supported */
+    [key: string]: unknown;
+}
+export interface UploadResponse {
+    /** Public CDN URL of the uploaded asset */
+    url: string;
+    /** Pixxo asset ID (maps to ImageKit's `fileId`) */
+    fileId: string;
+    /** File name as stored */
+    name: string;
+    /** MIME type */
+    fileType: string;
+    /** Size in bytes */
+    size: number;
+    /** Folder ID in Pixxo (if any) */
+    folderId: string | null;
+    /** Raw S3 key */
+    s3Key: string;
+}
+export interface LoginResponse {
+    success: boolean;
+    message?: string;
+    data?: {
+        user?: Record<string, unknown>;
+        token?: string;
+    };
+    token?: string;
+}
+export interface FolderDocument {
+    _id: string;
+    name: string;
+    parentId: string | null;
+    path?: string[];
+}
+export interface FolderCreateResponse {
+    success: boolean;
+    data: {
+        folder: FolderDocument;
+    };
+}
+export interface FolderListResponse {
+    success: boolean;
+    data: {
+        folders: FolderDocument[];
+    };
+}
+export interface UploadUrlResponse {
+    success: boolean;
+    data: {
+        uploadUrl: string;
+        s3Key: string;
+        s3Bucket: string;
+        expiresIn: number;
+    };
+}
+export interface AssetDocument {
+    _id: string;
+    name: string;
+    type: string;
+    s3Key: string;
+    s3Bucket: string;
+    folderId: string | null;
+    cloudfrontUrl: string;
+    sizeBytes: number;
+    metadata?: Record<string, unknown>;
+}
+export interface AssetCreateResponse {
+    success: boolean;
+    data: {
+        asset: AssetDocument;
+    };
+}
+//# 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,4 @@
+"use strict";
+// ─── Constructor Config ────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Infer MIME type from file name / extension. Falls back to
+ * `application/octet-stream` for unknown extensions.
+ */
+export declare function getMimeType(fileName: string): string;
+/**
+ * Resolve the `file` parameter from an upload call into a `Buffer`.
+ *
+ * Accepts:
+ * - `Buffer` → returned as-is
+ * - base64 string → decoded
+ * - file path → read from disk
+ */
+export declare function resolveFileToBuffer(file: Buffer | string): Buffer;
+/**
+ * Convert ImageKit‑style folder (`/receipts`) to Pixxo style (`receipts`).
+ * Also trims trailing slashes and collapses duplicate slashes.
+ */
+export declare function normalizeFolderPath(folder?: string): string;
+/**
+ * Simple async sleep.
+ */
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AA8CA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGpD;AAcD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAkBjE;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/utils.js

@@ -0,0 +1,144 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMimeType = getMimeType;
+exports.resolveFileToBuffer = resolveFileToBuffer;
+exports.normalizeFolderPath = normalizeFolderPath;
+exports.sleep = sleep;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ─── MIME type detection (lightweight, no dependencies) ────────────────────
+const MIME_MAP = {
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".png": "image/png",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".avif": "image/avif",
+    ".svg": "image/svg+xml",
+    ".bmp": "image/bmp",
+    ".ico": "image/x-icon",
+    ".tiff": "image/tiff",
+    ".tif": "image/tiff",
+    ".pdf": "application/pdf",
+    ".json": "application/json",
+    ".xml": "application/xml",
+    ".csv": "text/csv",
+    ".txt": "text/plain",
+    ".html": "text/html",
+    ".css": "text/css",
+    ".js": "application/javascript",
+    ".mp4": "video/mp4",
+    ".webm": "video/webm",
+    ".mov": "video/quicktime",
+    ".avi": "video/x-msvideo",
+    ".mp3": "audio/mpeg",
+    ".wav": "audio/wav",
+    ".ogg": "audio/ogg",
+    ".zip": "application/zip",
+    ".gz": "application/gzip",
+    ".tar": "application/x-tar",
+    ".doc": "application/msword",
+    ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    ".xls": "application/vnd.ms-excel",
+    ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    ".ppt": "application/vnd.ms-powerpoint",
+    ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+};
+/**
+ * Infer MIME type from file name / extension. Falls back to
+ * `application/octet-stream` for unknown extensions.
+ */
+function getMimeType(fileName) {
+    const ext = path.extname(fileName).toLowerCase();
+    return MIME_MAP[ext] ?? "application/octet-stream";
+}
+// ─── File resolution ───────────────────────────────────────────────────────
+/**
+ * Determines whether a string looks like base64‑encoded data.
+ * Heuristic: length ≥ 64, matches base64 charset, no path separators.
+ */
+function isBase64(str) {
+    if (str.length < 64)
+        return false;
+    if (str.includes("/") && str.includes("."))
+        return false; // likely a path
+    return /^[A-Za-z0-9+/\r\n]+=*$/.test(str);
+}
+/**
+ * Resolve the `file` parameter from an upload call into a `Buffer`.
+ *
+ * Accepts:
+ * - `Buffer` → returned as-is
+ * - base64 string → decoded
+ * - file path → read from disk
+ */
+function resolveFileToBuffer(file) {
+    if (Buffer.isBuffer(file))
+        return file;
+    if (typeof file === "string") {
+        // Check base64 first
+        if (isBase64(file)) {
+            return Buffer.from(file, "base64");
+        }
+        // Treat as file path
+        const resolved = path.resolve(file);
+        if (!fs.existsSync(resolved)) {
+            throw new Error(`File not found: ${resolved}`);
+        }
+        return fs.readFileSync(resolved);
+    }
+    throw new Error("Invalid file: expected Buffer, base64 string, or file path");
+}
+// ─── Folder path normalisation ─────────────────────────────────────────────
+/**
+ * Convert ImageKit‑style folder (`/receipts`) to Pixxo style (`receipts`).
+ * Also trims trailing slashes and collapses duplicate slashes.
+ */
+function normalizeFolderPath(folder) {
+    if (!folder)
+        return "";
+    return folder
+        .replace(/\/+/g, "/") // collapse duplicates
+        .replace(/^\//, "") // strip leading slash
+        .replace(/\/$/, ""); // strip trailing slash
+}
+/**
+ * Simple async sleep.
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@sarangkale66/pixxo-sdk-node",
+  "version": "1.0.0",
+  "description": "Pixxo Node.js SDK — drop-in replacement for ImageKit SDK",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "pixxo",
+    "imagekit",
+    "image",
+    "upload",
+    "cdn",
+    "asset-management",
+    "s3"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.12.0",
+    "typescript": "^5.4.5"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}