@nocloud/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NoneM
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,146 @@
+<div align="center">
+  <img src="https://assets.nonefivem.com/logo/dark-bg.png" alt="NoneM Logo" width="200" />
+  
+  # @nocloud/sdk
+  
+  **Official SDK for NoCloud services**
+  
+  [![npm version](https://img.shields.io/npm/v/@nocloud/sdk?style=for-the-badge)](https://www.npmjs.com/package/@nocloud/sdk)
+  [![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://opensource.org/licenses/MIT)
+  
+</div>
+
+---
+
+## 🚀 Getting Started
+
+### Installation
+
+```bash
+npm install @nocloud/sdk
+# or
+bun add @nocloud/sdk
+# or
+pnpm add @nocloud/sdk
+```
+
+### Quick Start
+
+```typescript
+import { NoCloud } from "@nocloud/sdk";
+
+const cloud = new NoCloud("your-api-key");
+
+// Upload a file
+const file = new File(["hello"], "hello.txt", { type: "text/plain" });
+const { id, url } = await cloud.storage.upload(file);
+
+console.log(`Uploaded: ${url}`);
+
+// Delete a file
+await cloud.storage.delete(id);
+```
+
+---
+
+## 📖 Usage
+
+### Initialize
+
+```typescript
+import { NoCloud } from "@nocloud/sdk";
+
+// Simple
+const cloud = new NoCloud("your-api-key");
+
+// With options
+const cloud = new NoCloud({
+  apiKey: "your-api-key",
+  baseUrl: "https://api.nonefivem.com", // optional
+  retries: 3, // optional
+  retryDelayMs: 1000, // optional
+});
+```
+
+### 📦 Storage
+
+#### Upload a File
+
+```typescript
+// From File/Blob
+const file = new File(["content"], "file.txt", { type: "text/plain" });
+const { id, url } = await cloud.storage.upload(file);
+
+// From ArrayBuffer
+const buffer = new ArrayBuffer(8);
+const { id, url } = await cloud.storage.upload(buffer);
+
+// From base64 string (auto-detects mime type)
+const base64 = "iVBORw0KGgo..."; // PNG base64
+const { id, url } = await cloud.storage.upload(base64);
+
+// With metadata
+const { id, url } = await cloud.storage.upload(file, {
+  userId: "123",
+  category: "avatars",
+});
+```
+
+#### Upload a Stream
+
+```typescript
+const stream = getReadableStream();
+const { id, url } = await cloud.storage.uploadStream(
+  stream,
+  "video/mp4",
+  fileSize,
+);
+```
+
+#### Delete a File
+
+```typescript
+await cloud.storage.delete(mediaId);
+```
+
+---
+
+## 📋 Supported Body Types
+
+| Type          | Description          |
+| ------------- | -------------------- |
+| `File`        | Browser File object  |
+| `Blob`        | Binary data          |
+| `ArrayBuffer` | Raw binary buffer    |
+| `string`      | Base64 or plain text |
+
+Base64 strings with data URLs (`data:image/png;base64,...`) or raw base64 are automatically detected and the mime type is inferred.
+
+---
+
+## ⚠️ Error Handling
+
+```typescript
+import { NoCloud, NoCloudAPIError } from "@nocloud/sdk";
+
+try {
+  await cloud.storage.upload(file);
+} catch (error) {
+  if (error instanceof NoCloudAPIError) {
+    console.error(`API Error: ${error.message} (${error.status})`);
+  }
+}
+```
+
+---
+
+## 🔧 Compatibility
+
+Works in both Node.js (>=18) and browser environments. No Node-specific APIs are used.
+
+---
+
+## 📄 License
+
+[MIT](LICENSE) © [NoneM](https://nonefivem.com)

package/dist/index.cjs

@@ -0,0 +1 @@
+var{defineProperty:u,getOwnPropertyNames:j,getOwnPropertyDescriptor:v}=Object,G=Object.prototype.hasOwnProperty;var U=new WeakMap,M=(r)=>{var x=U.get(r),F;if(x)return x;if(x=u({},"__esModule",{value:!0}),r&&typeof r==="object"||typeof r==="function")j(r).map((f)=>!G.call(x,f)&&u(x,f,{get:()=>r[f],enumerable:!(F=v(r,f))||F.enumerable}));return U.set(r,x),x};var P=(r,x)=>{for(var F in x)u(r,F,{get:x[F],enumerable:!0,configurable:!0,set:(f)=>x[F]=()=>f})};var C={};P(C,{default:()=>w,NoCloudAPIError:()=>h,NoCloud:()=>_});module.exports=M(C);var V="https://api.nonefivem.com";class h extends Error{status;constructor(r,x){super(r);this.status=x;this.name="NoCloudAPIError"}}function k(r){return new Promise((x)=>setTimeout(x,r))}async function W(r,x=3,F=1000){let f;for(let K=0;K<=x;K++)try{return await r()}catch(c){if(f=c,K<x)await k(F)}throw f}var A={iVBORw0KGgo:"image/png","/9j/":"image/jpeg",R0lGOD:"image/gif",UklGR:"image/webp",AAAA:"video/mp4",JVBERi0:"application/pdf",UEsDB:"application/zip",PD94bWw:"application/xml",PHN2Zw:"image/svg+xml"};function X(r){let x=r.match(/^data:([^;,]+)/);if(x?.[1])return x[1];for(let[F,f]of Object.entries(A))if(r.startsWith(F))return f;return null}function Y(r){let x=r.match(/^data:[^;,]+;base64,(.+)$/);if(x?.[1])return x[1];return r}function Z(r){let x=(r.match(/=+$/)||[""])[0].length;return Math.floor(r.length*3/4)-x}class D{baseUrl;apiKey;retryCount;retryDelayMs;constructor(r){if(this.apiKey=r.apiKey,this.baseUrl=r.baseUrl||V,this.retryCount=r.retries??3,this.retryDelayMs=r.retryDelayMs??1000,!this.apiKey)throw Error("API key is required")}buildUrl(r){return`${this.baseUrl}/cloud/${r}`}fetch(r,x={}){let F=this.buildUrl(r);return W(()=>fetch(F,{...x,headers:{Authorization:`Bearer ${this.apiKey}`,...x.headers||{}}}),x.retries??this.retryCount,x.retryDelayMs??this.retryDelayMs)}}async function B(r){if(!r.ok)try{let x=await r.json();throw new h(x.message||"API Error",r.status)}catch(x){throw new h("Unknown error",r.status)}return await r.json()}class H{fetcher;constructor(r){this.fetcher=r}fetch(r,x){return this.fetcher.fetch(r,x)}}class Q extends H{async generateSignedUrl(r,x,F){let f=await this.fetch("storage/signed-url",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({contentType:r,size:x,metadata:F})});return B(f)}getBodyInfo(r){if(typeof Blob<"u"&&r instanceof Blob)return{contentType:r.type||"application/octet-stream",size:r.size};if(typeof ArrayBuffer<"u"&&r instanceof ArrayBuffer)return{contentType:"application/octet-stream",size:r.byteLength};if(typeof r==="string"){let x=X(r);if(x){let F=Y(r),f=Z(F);return{contentType:x,size:f}}return{contentType:"text/plain",size:new TextEncoder().encode(r).length}}throw new h("Unsupported body type",400)}async upload(r,x){let{contentType:F,size:f}=this.getBodyInfo(r),{url:K,mediaUrl:c,mediaId:$}=await this.generateSignedUrl(F,f,x),O=await fetch(K,{method:"PUT",headers:{"Content-Type":F,"Content-Length":f.toString()},body:r});if(!O.ok){let q=await O.text().catch(()=>O.statusText);throw new h(`Failed to upload file to R2: ${q}`,O.status)}return{id:$,url:c}}async uploadStream(r,x,F,f){let{url:K,mediaUrl:c,mediaId:$}=await this.generateSignedUrl(x,F,f),O=await fetch(K,{method:"PUT",headers:{"Content-Type":x,"Content-Length":F.toString()},body:r,duplex:"half"});if(!O.ok){let q=await O.text().catch(()=>O.statusText);throw new h(`Failed to upload stream to R2: ${q}`,O.status)}return{id:$,url:c}}async delete(r){let x=await this.fetch(`storage/${r}`,{method:"DELETE"});return B(x)}}class _{fetcher;constructor(r){if(typeof r==="string")r={apiKey:r};this.fetcher=new D({apiKey:r.apiKey,baseUrl:r.baseUrl,retries:r.retries,retryDelayMs:r.retryDelayMs})}_storage;get storage(){return this._storage??=new Q(this.fetcher)}}var w=_;

package/dist/index.d.ts

@@ -0,0 +1,185 @@
+// Generated by dts-bundle-generator v9.5.1
+
+export interface FetchOptionsBase {
+	retries?: number;
+	retryDelayMs?: number;
+}
+export interface FetcherOptions extends FetchOptionsBase {
+	apiKey: string;
+	baseUrl?: string;
+}
+export type FetchOptions = RequestInit & FetchOptionsBase;
+declare class Fetcher {
+	private readonly baseUrl;
+	private readonly apiKey;
+	private readonly retryCount;
+	private readonly retryDelayMs;
+	constructor(options: FetcherOptions);
+	private buildUrl;
+	fetch(endpoint: string, options?: FetchOptions): Promise<Response>;
+}
+declare class SDKModule {
+	private readonly fetcher;
+	constructor(fetcher: Fetcher);
+	protected fetch(endpoint: string, options: FetchOptions): Promise<Response>;
+}
+/**
+ * Upload body types.
+ *
+ * `File` and `Blob` are streamed.
+ * `ArrayBuffer` and `string` are buffered in memory.
+ *
+ * `string` values (e.g. Base64) are uploaded as-is.
+ */
+export type FileBody = File | Blob | ArrayBuffer | string;
+/**
+ * Metadata associated with a file.
+ */
+export type FileMetadata = Record<string, string | number | boolean>;
+/**
+ * Response returned after a successful file upload.
+ */
+export interface UploadResponse {
+	/**
+	 * The unique identifier for the uploaded file.
+	 */
+	id: string;
+	/**
+	 * The public URL where the uploaded file can be accessed.
+	 */
+	url: string;
+}
+/**
+ * Response returned when requesting a signed URL for uploading media.
+ */
+export interface SignedUrlResponse {
+	/**
+	 * The signed URL for uploading the file.
+	 */
+	url: string;
+	/**
+	 * The expiration time of the signed URL in ISO 8601 format.
+	 */
+	expiresAt: string;
+	/**
+	 * The unique identifier for the media after upload.
+	 */
+	mediaId: string;
+	/**
+	 * The public URL to access the media after upload.
+	 */
+	mediaUrl: string;
+}
+declare class Storage$1 extends SDKModule {
+	/**
+	 * Generates a signed URL for uploading a file.
+	 * @param contentType - The MIME type of the file.
+	 * @param size - The size of the file in bytes.
+	 * @param metadata - Optional metadata associated with the file.
+	 * @returns {Promise<SignedUrlResponse>} An object containing the signed URL and its expiration time.
+	 * @throws {NoCloudAPIError} If the API request fails.
+	 */
+	generateSignedUrl(contentType: string, size: number, metadata?: FileMetadata): Promise<SignedUrlResponse>;
+	/**
+	 * Extracts content type and size from the body.
+	 */
+	private getBodyInfo;
+	/**
+	 * Uploads a file to R2 storage using S3-compatible API.
+	 * @param body The file body to upload. Supports File, Blob, ArrayBuffer, or string.
+	 * @param metadata Optional metadata associated with the file.
+	 * @returns {Promise<UploadResponse>} An object containing the upload ID and URL.
+	 * @throws {NoCloudAPIError} If the upload fails.
+	 */
+	upload(body: FileBody, metadata?: FileMetadata): Promise<UploadResponse>;
+	/**
+	 * Uploads a ReadableStream to R2 storage using S3-compatible API.
+	 * @param stream The ReadableStream to upload.
+	 * @param contentType The MIME type of the content.
+	 * @param contentLength The size of the content in bytes.
+	 * @param metadata Optional metadata associated with the file.
+	 * @returns {Promise<UploadResponse>} An object containing the upload ID and URL.
+	 * @throws {NoCloudAPIError} If the upload fails.
+	 */
+	uploadStream(stream: ReadableStream, contentType: string, contentLength: number, metadata?: FileMetadata): Promise<UploadResponse>;
+	/**
+	 * Deletes a media file from the storage.
+	 * @param mediaId The ID of the media file to be deleted.
+	 * @returns {Promise<void>} A promise that resolves when the deletion is complete.
+	 * @throws {NoCloudAPIError} If the deletion fails.
+	 */
+	delete(mediaId: string): Promise<void>;
+}
+export interface NoCloudOptions {
+	/**
+	 * Your API key for authenticating requests.
+	 */
+	apiKey: string;
+	/**
+	 * Optional base URL for the API.
+	 * @default "https://api.nonefivem.com"
+	 */
+	baseUrl?: string;
+	/**
+	 * Number of retry attempts for failed requests.
+	 * @default 3
+	 */
+	retries?: number;
+	/**
+	 * Delay in milliseconds between retry attempts.
+	 * @default 1000
+	 */
+	retryDelayMs?: number;
+}
+/**
+ * Main SDK class for interacting with NoCloud services.
+ * @example
+ * ```ts
+ * // Using a string API key
+ * const cloud = new NoCloud("your-api-key");
+ *
+ * // Using an options object
+ * const cloud = new NoCloud({
+ *   apiKey: "your-api-key",
+ *   baseUrl: "https://api.nonefivem.com",
+ *   retries: 5,
+ *   retryDelayMs: 2000,
+ * });
+ * ```
+ */
+export declare class NoCloud {
+	private readonly fetcher;
+	/**
+	 * Creates an instance of the NoCloud SDK.
+	 * @param options - Your API key or an options object.
+	 * @example
+	 * ```ts
+	 * // Using a string API key
+	 * const cloud = new NoCloud("your-api-key");
+	 *
+	 * // Using an options object
+	 * const cloud = new NoCloud({
+	 *   apiKey: "your-api-key",
+	 *   baseUrl: "https://api.nonefivem.com",
+	 *   retries: 5,
+	 *   retryDelayMs: 1000,
+	 * });
+	 * ```
+	 */
+	constructor(options: string | NoCloudOptions);
+	private _storage?;
+	/**
+	 * Storage module for handling file storage operations.
+	 */
+	get storage(): Storage$1;
+}
+export declare class NoCloudAPIError extends Error {
+	readonly status: number;
+	constructor(message: string, status: number);
+}
+
+export {
+	NoCloud as default,
+};
+
+export {};

package/dist/index.js

@@ -0,0 +1 @@
+var Q="https://api.nonefivem.com";class h extends Error{status;constructor(r,x){super(r);this.status=x;this.name="NoCloudAPIError"}}function Y(r){return new Promise((x)=>setTimeout(x,r))}async function U(r,x=3,F=1000){let f;for(let K=0;K<=x;K++)try{return await r()}catch(c){if(f=c,K<x)await Y(F)}throw f}var Z={iVBORw0KGgo:"image/png","/9j/":"image/jpeg",R0lGOD:"image/gif",UklGR:"image/webp",AAAA:"video/mp4",JVBERi0:"application/pdf",UEsDB:"application/zip",PD94bWw:"application/xml",PHN2Zw:"image/svg+xml"};function V(r){let x=r.match(/^data:([^;,]+)/);if(x?.[1])return x[1];for(let[F,f]of Object.entries(Z))if(r.startsWith(F))return f;return null}function W(r){let x=r.match(/^data:[^;,]+;base64,(.+)$/);if(x?.[1])return x[1];return r}function X(r){let x=(r.match(/=+$/)||[""])[0].length;return Math.floor(r.length*3/4)-x}class q{baseUrl;apiKey;retryCount;retryDelayMs;constructor(r){if(this.apiKey=r.apiKey,this.baseUrl=r.baseUrl||Q,this.retryCount=r.retries??3,this.retryDelayMs=r.retryDelayMs??1000,!this.apiKey)throw Error("API key is required")}buildUrl(r){return`${this.baseUrl}/cloud/${r}`}fetch(r,x={}){let F=this.buildUrl(r);return U(()=>fetch(F,{...x,headers:{Authorization:`Bearer ${this.apiKey}`,...x.headers||{}}}),x.retries??this.retryCount,x.retryDelayMs??this.retryDelayMs)}}async function u(r){if(!r.ok)try{let x=await r.json();throw new h(x.message||"API Error",r.status)}catch(x){throw new h("Unknown error",r.status)}return await r.json()}class D{fetcher;constructor(r){this.fetcher=r}fetch(r,x){return this.fetcher.fetch(r,x)}}class B extends D{async generateSignedUrl(r,x,F){let f=await this.fetch("storage/signed-url",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({contentType:r,size:x,metadata:F})});return u(f)}getBodyInfo(r){if(typeof Blob<"u"&&r instanceof Blob)return{contentType:r.type||"application/octet-stream",size:r.size};if(typeof ArrayBuffer<"u"&&r instanceof ArrayBuffer)return{contentType:"application/octet-stream",size:r.byteLength};if(typeof r==="string"){let x=V(r);if(x){let F=W(r),f=X(F);return{contentType:x,size:f}}return{contentType:"text/plain",size:new TextEncoder().encode(r).length}}throw new h("Unsupported body type",400)}async upload(r,x){let{contentType:F,size:f}=this.getBodyInfo(r),{url:K,mediaUrl:c,mediaId:_}=await this.generateSignedUrl(F,f,x),O=await fetch(K,{method:"PUT",headers:{"Content-Type":F,"Content-Length":f.toString()},body:r});if(!O.ok){let $=await O.text().catch(()=>O.statusText);throw new h(`Failed to upload file to R2: ${$}`,O.status)}return{id:_,url:c}}async uploadStream(r,x,F,f){let{url:K,mediaUrl:c,mediaId:_}=await this.generateSignedUrl(x,F,f),O=await fetch(K,{method:"PUT",headers:{"Content-Type":x,"Content-Length":F.toString()},body:r,duplex:"half"});if(!O.ok){let $=await O.text().catch(()=>O.statusText);throw new h(`Failed to upload stream to R2: ${$}`,O.status)}return{id:_,url:c}}async delete(r){let x=await this.fetch(`storage/${r}`,{method:"DELETE"});return u(x)}}class H{fetcher;constructor(r){if(typeof r==="string")r={apiKey:r};this.fetcher=new q({apiKey:r.apiKey,baseUrl:r.baseUrl,retries:r.retries,retryDelayMs:r.retryDelayMs})}_storage;get storage(){return this._storage??=new B(this.fetcher)}}var s=H;export{s as default,h as NoCloudAPIError,H as NoCloud};

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@nocloud/sdk",
+  "version": "0.1.0",
+  "description": "Official SDK for NoCloud services - file storage and more",
+  "author": {
+    "name": "sinanovicanes",
+    "email": "anes@nonefivem.com",
+    "url": "https://nonefivem.com"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nonefivem/no-cloud-sdk.git"
+  },
+  "homepage": "https://github.com/nonefivem/no-cloud-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/nonefivem/no-cloud-sdk/issues"
+  },
+  "keywords": [
+    "nocloud",
+    "no-cloud",
+    "nonem",
+    "nonefivem",
+    "sdk",
+    "storage",
+    "r2",
+    "s3",
+    "file-upload",
+    "api"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "bun run clean && bun run build:js && bun run build:types",
+    "build:js": "bun build ./src/index.ts --outfile ./dist/index.js --target browser --format esm --minify && bun build ./src/index.ts --outfile ./dist/index.cjs --target browser --format cjs --minify",
+    "build:types": "bun x dts-bundle-generator -o ./dist/index.d.ts ./src/index.ts --project ./tsconfig.build.json --no-check",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "private": false,
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}