@dcd-sdk/storage-client 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,101 @@
-# Temporary Holding Version
+# @dcd-sdk/storage-client
 
-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 Node.js & TypeScript Client SDK for DevCloudDesk Storage Engine.
+
+High-performance, Cloudinary-style on-the-fly media transformations and ultra-fast direct asset delivery backed by your DevCloudDesk storage clusters.
+
+[![npm version](https://img.shields.io/npm/v/@dcd-sdk/storage-client?color=blue)](https://www.npmjs.com/package/@dcd-sdk/storage-client)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## 📦 Installation
+
+```bash
+# npm
+npm install @dcd-sdk/storage-client
+
+# pnpm
+pnpm add @dcd-sdk/storage-client
+
+# yarn
+yarn add @dcd-sdk/storage-client
+```
+
+---
+
+## 🚀 Quickstart
+
+### 1. Initialize the Client
+
+```typescript
+import { createBucketClient } from '@dcd-sdk/storage-client';
+
+const bucket = createBucketClient({
+  endpoint: 'http://YOUR_SERVER_IP:7100', // or your custom domain https://storage.yourdomain.com
+  apiKey: process.env.STORAGE_API_KEY,    // API Key from DevCloudDesk Dashboard
+});
+```
+
+### 2. Uploading Files (Node.js or Browser)
+
+```typescript
+// Upload from Buffer, File, or local file path
+const asset = await bucket.upload(fileBuffer, {
+  folder: 'avatars',
+  filename: 'user-profile.png',
+  onProgress: (percent) => {
+    console.log(`Upload progress: ${percent}%`);
+  },
+});
+
+console.log('Public ID:', asset.publicId);
+console.log('CDN URL:', asset.url);
+```
+
+### 3. Dynamic On-The-Fly Transformations
+
+Generate real-time optimized WebP/AVIF images with automatic resizing:
+
+```typescript
+const avatarUrl = bucket
+  .url(asset.publicId)
+  .resize({ width: 400, height: 400, crop: 'cover' })
+  .format('webp')
+  .quality(80)
+  .build();
+
+// Output: http://YOUR_SERVER_IP:7100/v1/image/w_400,h_400,c_cover,f_webp,q_80/avatars/user-profile.png
+```
+
+### 4. Client-Side Uploads via Signed Tokens (Zero Secret Exposure)
+
+Keep your master API keys safely on your backend server. Generate short-lived, tamper-proof signed upload tokens for your frontend React/Next.js/Mobile apps:
+
+```typescript
+// Backend endpoint:
+app.post('/api/get-upload-token', async (req, res) => {
+  const tokenData = await bucket.createSignedUploadToken({
+    folder: 'user-uploads',
+    expiresInSeconds: 300, // 5 minutes
+    maxBytes: 10 * 1024 * 1024, // 10 MB limit
+  });
+  res.json(tokenData);
+});
+
+// Frontend client:
+const { token } = await res.json();
+await bucket.uploadWithToken(file, token);
+```
+
+### 5. Deleting Files
+
+```typescript
+await bucket.delete(asset.publicId);
+```
+
+---
+
+## 📄 License
+
+MIT © [DevCloudDesk](https://devclouddesk.com)

package/dist/builder.d.ts

@@ -0,0 +1,31 @@
+import type { CropMode, OutputFormat } from './types.js';
+export declare class TransformationBuilder {
+    private endpoint;
+    private publicId;
+    private options;
+    constructor(endpoint: string, publicId: string);
+    width(w: number): this;
+    height(h: number): this;
+    resize(params: {
+        width?: number;
+        height?: number;
+        crop?: CropMode;
+    }): this;
+    crop(mode: CropMode): this;
+    format(fmt: OutputFormat): this;
+    quality(q: number | 'auto'): this;
+    blur(sigma?: number): this;
+    grayscale(enable?: boolean): this;
+    sharpen(enable?: boolean): this;
+    rotation(rot: number | 'auto'): this;
+    /**
+     * Builds the formatted transformation string (e.g. w_400,h_300,c_fill,f_auto)
+     */
+    toParamsString(): string;
+    /**
+     * Returns the final full URL string
+     */
+    build(): string;
+    toString(): string;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAyB,MAAM,YAAY,CAAC;AAEhF,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAA6B;gBAEhC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAK9C,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKtB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKvB,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,IAAI;IAO1E,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAK1B,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI;IAK/B,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKjC,IAAI,CAAC,KAAK,SAAI,GAAG,IAAI;IAKrB,SAAS,CAAC,MAAM,UAAO,GAAG,IAAI;IAK9B,OAAO,CAAC,MAAM,UAAO,GAAG,IAAI;IAK5B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKpC;;OAEG;IACH,cAAc,IAAI,MAAM;IAgBxB;;OAEG;IACH,KAAK,IAAI,MAAM;IAQf,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/builder.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransformationBuilder = void 0;
+class TransformationBuilder {
+    constructor(endpoint, publicId) {
+        this.options = {};
+        this.endpoint = endpoint.replace(/\/+$/, '');
+        this.publicId = publicId.replace(/^\/+/, '');
+    }
+    width(w) {
+        this.options.width = Math.round(w);
+        return this;
+    }
+    height(h) {
+        this.options.height = Math.round(h);
+        return this;
+    }
+    resize(params) {
+        if (params.width)
+            this.options.width = Math.round(params.width);
+        if (params.height)
+            this.options.height = Math.round(params.height);
+        if (params.crop)
+            this.options.crop = params.crop;
+        return this;
+    }
+    crop(mode) {
+        this.options.crop = mode;
+        return this;
+    }
+    format(fmt) {
+        this.options.format = fmt;
+        return this;
+    }
+    quality(q) {
+        this.options.quality = q;
+        return this;
+    }
+    blur(sigma = 5) {
+        this.options.blur = sigma;
+        return this;
+    }
+    grayscale(enable = true) {
+        this.options.grayscale = enable;
+        return this;
+    }
+    sharpen(enable = true) {
+        this.options.sharpen = enable;
+        return this;
+    }
+    rotation(rot) {
+        this.options.rotation = rot;
+        return this;
+    }
+    /**
+     * Builds the formatted transformation string (e.g. w_400,h_300,c_fill,f_auto)
+     */
+    toParamsString() {
+        const parts = [];
+        if (this.options.width)
+            parts.push(`w_${this.options.width}`);
+        if (this.options.height)
+            parts.push(`h_${this.options.height}`);
+        if (this.options.crop)
+            parts.push(`c_${this.options.crop}`);
+        if (this.options.format)
+            parts.push(`f_${this.options.format}`);
+        if (this.options.quality)
+            parts.push(`q_${this.options.quality}`);
+        if (this.options.blur)
+            parts.push(`e_blur_${this.options.blur}`);
+        if (this.options.grayscale)
+            parts.push('e_gray');
+        if (this.options.sharpen)
+            parts.push('e_sharp');
+        if (this.options.rotation)
+            parts.push(`r_${this.options.rotation}`);
+        return parts.length > 0 ? parts.join(',') : 'original';
+    }
+    /**
+     * Returns the final full URL string
+     */
+    build() {
+        const params = this.toParamsString();
+        if (params === 'original') {
+            return `${this.endpoint}/v1/image/${this.publicId}`;
+        }
+        return `${this.endpoint}/v1/image/${params}/${this.publicId}`;
+    }
+    toString() {
+        return this.build();
+    }
+}
+exports.TransformationBuilder = TransformationBuilder;

package/dist/client.d.ts

@@ -0,0 +1,38 @@
+import { TransformationBuilder } from './builder.js';
+import type { AssetResult, SignedUploadResult, SignUploadOptions, StorageClientConfig, UploadOptions } from './types.js';
+export declare class StorageClient {
+    private endpoint;
+    private apiKey;
+    constructor(config: StorageClientConfig);
+    /**
+     * Initializes a fluent URL builder for the specified asset public ID
+     */
+    url(publicId: string): TransformationBuilder;
+    /**
+     * Generates a short-lived cryptographically signed upload token for safe client-side browser/mobile uploads.
+     * Keeps master API keys strictly on backend servers.
+     */
+    createSignedUploadToken(options?: SignUploadOptions): Promise<SignedUploadResult>;
+    /**
+     * Directly uploads a file to the storage server.
+     * Supports File/Blob in browser environments and Buffer/ReadStream in Node.js environments.
+     * Supports both Master API Key and Client Signed Upload Tokens (dcd_sig_...).
+     */
+    upload(file: any, options?: UploadOptions): Promise<AssetResult>;
+    /**
+     * Helper method for frontend clients to upload using only a signed upload token (zero API key)
+     */
+    uploadWithToken(file: any, token: string, options?: Omit<UploadOptions, 'token'>): Promise<AssetResult>;
+    /**
+     * Permanently deletes a storage asset (requires API key with delete role)
+     */
+    delete(publicId: string): Promise<boolean>;
+}
+export declare function createStorageClient(config: StorageClientConfig): StorageClient;
+export declare const BucketClient: typeof StorageClient;
+export type BucketClient = StorageClient;
+export declare const createBucketClient: typeof createStorageClient;
+export declare const MediaClient: typeof StorageClient;
+export type MediaClient = StorageClient;
+export declare const createMediaClient: typeof createStorageClient;
+//# 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,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,mBAAmB;IAQvC;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB;IAI5C;;;OAGG;IACG,uBAAuB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuB3F;;;;OAIG;IACG,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IAqG1E;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIjH;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAajD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAE9E;AAGD,eAAO,MAAM,YAAY,sBAAgB,CAAC;AAC1C,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC;AACzC,eAAO,MAAM,kBAAkB,4BAAsB,CAAC;AAGtD,eAAO,MAAM,WAAW,sBAAgB,CAAC;AACzC,MAAM,MAAM,WAAW,GAAG,aAAa,CAAC;AACxC,eAAO,MAAM,iBAAiB,4BAAsB,CAAC"}

package/dist/client.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMediaClient = exports.MediaClient = exports.createBucketClient = exports.BucketClient = exports.StorageClient = void 0;
+exports.createStorageClient = createStorageClient;
+const builder_js_1 = require("./builder.js");
+class StorageClient {
+    constructor(config) {
+        if (!config.endpoint) {
+            throw new Error('StorageClient: endpoint is required');
+        }
+        this.endpoint = config.endpoint.replace(/\/+$/, '');
+        this.apiKey = (config.apiKey || '').trim();
+    }
+    /**
+     * Initializes a fluent URL builder for the specified asset public ID
+     */
+    url(publicId) {
+        return new builder_js_1.TransformationBuilder(this.endpoint, publicId);
+    }
+    /**
+     * Generates a short-lived cryptographically signed upload token for safe client-side browser/mobile uploads.
+     * Keeps master API keys strictly on backend servers.
+     */
+    async createSignedUploadToken(options = {}) {
+        if (!this.apiKey) {
+            throw new Error('StorageClient: API key is required on backend to generate signed upload tokens.');
+        }
+        const signUrl = `${this.endpoint}/v1/upload/sign`;
+        const response = await fetch(signUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify(options),
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            throw new Error(data.error?.message || `Failed to generate signed upload token with status ${response.status}`);
+        }
+        return data;
+    }
+    /**
+     * Directly uploads a file to the storage server.
+     * Supports File/Blob in browser environments and Buffer/ReadStream in Node.js environments.
+     * Supports both Master API Key and Client Signed Upload Tokens (dcd_sig_...).
+     */
+    async upload(file, options = {}) {
+        const uploadUrl = `${this.endpoint}/v1/upload`;
+        const formData = new FormData();
+        let fileToAppend = file;
+        let filename = options.filename;
+        if (typeof file === 'string') {
+            if (typeof process !== 'undefined' && process.versions?.node) {
+                try {
+                    const fs = await import('node:fs');
+                    const path = await import('node:path');
+                    if (fs.existsSync(file)) {
+                        const buf = fs.readFileSync(file);
+                        filename = filename || path.basename(file);
+                        fileToAppend = new Blob([new Uint8Array(buf)]);
+                    }
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }
+        else if (typeof Buffer !== 'undefined' && Buffer.isBuffer(file)) {
+            fileToAppend = new Blob([new Uint8Array(file)]);
+            filename = filename || 'upload.bin';
+        }
+        if (filename) {
+            formData.append('file', fileToAppend, filename);
+        }
+        else {
+            formData.append('file', fileToAppend);
+        }
+        if (options.folder)
+            formData.append('folder', options.folder);
+        if (options.publicId)
+            formData.append('public_id', options.publicId);
+        if (options.overwrite !== undefined)
+            formData.append('overwrite', String(options.overwrite));
+        if (options.uniqueFilename !== undefined)
+            formData.append('unique_filename', String(options.uniqueFilename));
+        // Determine auth header: Use options.token if provided, otherwise this.apiKey
+        const headers = {};
+        if (options.token) {
+            headers['X-Upload-Token'] = options.token;
+        }
+        else if (this.apiKey) {
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        }
+        else {
+            throw new Error('StorageClient: Either apiKey or a signed upload token must be provided to upload.');
+        }
+        // Browser upload with progress tracking via XMLHttpRequest
+        if (typeof XMLHttpRequest !== 'undefined' && options.onProgress) {
+            return new Promise((resolve, reject) => {
+                const xhr = new XMLHttpRequest();
+                xhr.open('POST', uploadUrl, true);
+                for (const [k, v] of Object.entries(headers)) {
+                    xhr.setRequestHeader(k, v);
+                }
+                xhr.upload.onprogress = (e) => {
+                    if (e.lengthComputable && options.onProgress) {
+                        const percent = Math.round((e.loaded / e.total) * 100);
+                        options.onProgress(percent);
+                    }
+                };
+                xhr.onload = () => {
+                    if (xhr.status >= 200 && xhr.status < 300) {
+                        try {
+                            const res = JSON.parse(xhr.responseText);
+                            resolve(res.asset);
+                        }
+                        catch {
+                            reject(new Error('Invalid response from storage server'));
+                        }
+                    }
+                    else {
+                        try {
+                            const errData = JSON.parse(xhr.responseText);
+                            reject(new Error(errData.error?.message || `Upload failed with status ${xhr.status}`));
+                        }
+                        catch {
+                            reject(new Error(`Upload failed with status ${xhr.status}`));
+                        }
+                    }
+                };
+                xhr.onerror = () => reject(new Error('Network error during file upload'));
+                xhr.send(formData);
+            });
+        }
+        // Standard fetch upload (Browser or Node.js)
+        const response = await fetch(uploadUrl, {
+            method: 'POST',
+            headers,
+            body: formData,
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            throw new Error(data.error?.message || `Upload failed with status ${response.status}`);
+        }
+        return data.asset;
+    }
+    /**
+     * Helper method for frontend clients to upload using only a signed upload token (zero API key)
+     */
+    async uploadWithToken(file, token, options = {}) {
+        return this.upload(file, { ...options, token });
+    }
+    /**
+     * Permanently deletes a storage asset (requires API key with delete role)
+     */
+    async delete(publicId) {
+        const cleanPublicId = publicId.replace(/^\/+/, '');
+        const deleteUrl = `${this.endpoint}/v1/admin/files/${cleanPublicId}`;
+        const response = await fetch(deleteUrl, {
+            method: 'DELETE',
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+        });
+        return response.ok;
+    }
+}
+exports.StorageClient = StorageClient;
+function createStorageClient(config) {
+    return new StorageClient(config);
+}
+// Bucket modern API aliases
+exports.BucketClient = StorageClient;
+exports.createBucketClient = createStorageClient;
+// Backward compatibility aliases
+exports.MediaClient = StorageClient;
+exports.createMediaClient = createStorageClient;

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { TransformationBuilder } from './builder.js';
+export { StorageClient, createStorageClient, BucketClient, createBucketClient, MediaClient, createMediaClient, } from './client.js';
+export type { AssetResult, StorageAssetResult, BucketAssetResult, CropMode, OutputFormat, StorageClientConfig, BucketClientConfig, MediaClientConfig, TransformationOptions, UploadOptions, } 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,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMediaClient = exports.MediaClient = exports.createBucketClient = exports.BucketClient = exports.createStorageClient = exports.StorageClient = exports.TransformationBuilder = void 0;
+var builder_js_1 = require("./builder.js");
+Object.defineProperty(exports, "TransformationBuilder", { enumerable: true, get: function () { return builder_js_1.TransformationBuilder; } });
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "StorageClient", { enumerable: true, get: function () { return client_js_1.StorageClient; } });
+Object.defineProperty(exports, "createStorageClient", { enumerable: true, get: function () { return client_js_1.createStorageClient; } });
+Object.defineProperty(exports, "BucketClient", { enumerable: true, get: function () { return client_js_1.BucketClient; } });
+Object.defineProperty(exports, "createBucketClient", { enumerable: true, get: function () { return client_js_1.createBucketClient; } });
+Object.defineProperty(exports, "MediaClient", { enumerable: true, get: function () { return client_js_1.MediaClient; } });
+Object.defineProperty(exports, "createMediaClient", { enumerable: true, get: function () { return client_js_1.createMediaClient; } });

package/dist/types.d.ts

@@ -0,0 +1,67 @@
+export type CropMode = 'fill' | 'fit' | 'crop' | 'scale';
+export type OutputFormat = 'auto' | 'webp' | 'avif' | 'jpeg' | 'png';
+export interface StorageClientConfig {
+    /** The base URL of the storage engine cluster (e.g. 'https://storage.mycoolapp.com' or 'http://192.168.1.50:7100') */
+    endpoint: string;
+    /** Public API key (dcd_pk_...), Secret key (dcd_sk_...), or Live key */
+    apiKey?: string;
+}
+export type MediaClientConfig = StorageClientConfig;
+export type BucketClientConfig = StorageClientConfig;
+export interface TransformationOptions {
+    width?: number;
+    height?: number;
+    crop?: CropMode;
+    format?: OutputFormat;
+    quality?: number | 'auto';
+    blur?: number;
+    grayscale?: boolean;
+    sharpen?: boolean;
+    rotation?: number | 'auto';
+}
+export interface UploadOptions {
+    folder?: string;
+    publicId?: string;
+    filename?: string;
+    overwrite?: boolean;
+    uniqueFilename?: boolean;
+    /** Optional client signed upload token (dcd_sig_...) to upload without API key */
+    token?: string;
+    tags?: string[];
+    onProgress?: (percent: number) => void;
+}
+export interface SignUploadOptions {
+    folder?: string;
+    maxBytes?: number;
+    expiresInSeconds?: number;
+}
+export interface SignedUploadResult {
+    success: boolean;
+    token: string;
+    uploadUrl: string;
+    expiresInSeconds: number;
+    folder?: string | null;
+    maxBytes?: number | null;
+}
+export interface AssetResult {
+    public_id: string;
+    publicId: string;
+    filename: string;
+    format: string;
+    resource_type?: string;
+    resourceType?: string;
+    width?: number;
+    height?: number;
+    bytes: number;
+    storageDriver: string;
+    etag: string;
+    url: string;
+    secure_url: string;
+    secureUrl: string;
+    rawUrl?: string;
+    created_at: number;
+    createdAt: number;
+}
+export type StorageAssetResult = AssetResult;
+export type BucketAssetResult = AssetResult;
+//# 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,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AACzD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAClC,sHAAsH;IACtH,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AACpD,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAC7C,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@dcd-sdk/storage-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Official Node.js & TypeScript client SDK for DevCloudDesk Storage Engine",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.19",
+    "typescript": "^5.7.3",
+    "vitest": "^5.0.5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/devclouddesk/dcd-sdk.git",
+    "directory": "packages/storage-client"
+  },
+  "homepage": "https://devclouddesk.com",
+  "license": "MIT"
+}