@applica-software-guru/didonato-storage-client 1.0.29

package/README.md

@@ -0,0 +1,66 @@
+# @applica-software-guru/didonato-storage-client
+
+Client TypeScript package for Didonato Storage.
+
+Quick start
+
+Install:
+
+```bash
+npm install @applica-software-guru/didonato-storage-client
+```
+
+Usage (ESM):
+
+```ts
+import DidonatoStorageClient from "@applica-software-guru/didonato-storage-client";
+
+const c = new DidonatoStorageClient({ baseUrl: "https://example.com" });
+console.log(await c.getSignedUrl("path/to/file"));
+```
+
+## Authentication
+
+The client accepts an optional `token` option which can be provided in two ways:
+
+- As a static token string: `new DidonatoStorageClient({ token: 'my-token' })`.
+- As a function that returns a token (sync or async): `new DidonatoStorageClient({ token: () => fetchToken() })`.
+
+Examples
+
+1. Pass a static token:
+
+```ts
+import DidonatoStorageClient from "@applica-software-guru/didonato-storage-client";
+
+const client = new DidonatoStorageClient({ baseUrl: "https://example.com", token: "MY_STATIC_TOKEN" });
+// methods will include `Authorization: Bearer MY_STATIC_TOKEN` when calling the server
+```
+
+2. Pass a token factory (sync or async):
+
+```ts
+import DidonatoStorageClient from '@applica-software-guru/didonato-storage-client';
+
+// sync factory
+const clientSync = new DidonatoStorageClient({ baseUrl: 'https://example.com', token: () => 'token-from-fn' });
+
+// async factory
+const clientAsync = new DidonatoStorageClient({
+	baseUrl: 'https://example.com',
+	token: async () => {
+		// refresh or fetch token from secure storage
+		return await getFreshToken();
+	}
+});
+
+// The library will call your function before requests and attach
+// `Authorization: Bearer <token>` header when present.
+
+Notes
+-----
+- If you need to pass custom headers beyond Authorization, call the low-level endpoints
+	on your server or extend the client.
+- The token option is optional; if omitted, requests are sent without an Authorization header.
+
+```

package/dist/index.d.mts

@@ -0,0 +1,24 @@
+interface DidonatoOptions {
+    baseUrl?: string;
+    bucket?: string;
+    credentials?: Record<string, any>;
+    /**
+     * A static token string (Bearer) or a function that returns a token string (sync or Promise)
+     */
+    token?: string | (() => string | Promise<string>);
+}
+declare class DidonatoStorageClient {
+    options: DidonatoOptions;
+    constructor(opts?: DidonatoOptions);
+    getToken(): Promise<string | undefined>;
+    getSignedUrl(key: string, expiresSec?: number): Promise<string>;
+    createSignedPost(key: string): Promise<{
+        url: string;
+        fields: Record<string, string>;
+    }>;
+    uploadWithSignedPost(url: string, fields: Record<string, string>, body: Buffer | Blob | string): Promise<boolean>;
+    delete(key: string): Promise<boolean>;
+    list(prefix?: string): Promise<string[]>;
+}
+
+export { type DidonatoOptions, DidonatoStorageClient, DidonatoStorageClient as default };

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+interface DidonatoOptions {
+    baseUrl?: string;
+    bucket?: string;
+    credentials?: Record<string, any>;
+    /**
+     * A static token string (Bearer) or a function that returns a token string (sync or Promise)
+     */
+    token?: string | (() => string | Promise<string>);
+}
+declare class DidonatoStorageClient {
+    options: DidonatoOptions;
+    constructor(opts?: DidonatoOptions);
+    getToken(): Promise<string | undefined>;
+    getSignedUrl(key: string, expiresSec?: number): Promise<string>;
+    createSignedPost(key: string): Promise<{
+        url: string;
+        fields: Record<string, string>;
+    }>;
+    uploadWithSignedPost(url: string, fields: Record<string, string>, body: Buffer | Blob | string): Promise<boolean>;
+    delete(key: string): Promise<boolean>;
+    list(prefix?: string): Promise<string[]>;
+}
+
+export { type DidonatoOptions, DidonatoStorageClient, DidonatoStorageClient as default };

package/dist/index.js

@@ -0,0 +1,98 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DidonatoStorageClient: () => DidonatoStorageClient,
+  default: () => DidonatoStorageClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/DidonatoStorageClient.ts
+var import_cross_fetch = __toESM(require("cross-fetch"));
+var DidonatoStorageClient = class {
+  constructor(opts = {}) {
+    this.options = opts;
+  }
+  async getToken() {
+    const t = this.options.token;
+    if (!t) return void 0;
+    if (typeof t === "function") {
+      try {
+        return await t();
+      } catch (err) {
+        return void 0;
+      }
+    }
+    return String(t);
+  }
+  async getSignedUrl(key, expiresSec = 3600) {
+    return `${this.options.baseUrl || "https://storage.example.com"}/signed/${encodeURIComponent(
+      key
+    )}?exp=${expiresSec}`;
+  }
+  async createSignedPost(key) {
+    const url = `${this.options.baseUrl || ""}/signed-post/${encodeURIComponent(key)}`;
+    const res = await (0, import_cross_fetch.default)(url);
+    if (!res.ok) throw new Error("failed to get signed post");
+    const json = await res.json();
+    return json;
+  }
+  async uploadWithSignedPost(url, fields, body) {
+    if (typeof FormData !== "undefined") {
+      const fd = new FormData();
+      for (const k in fields) fd.append(k, fields[k]);
+      fd.append("file", body);
+      const res = await (0, import_cross_fetch.default)(url, { method: "POST", body: fd });
+      return res.ok;
+    }
+    throw new Error("FormData not available; use form-data package in Node tests");
+  }
+  async delete(key) {
+    const url = `${this.options.baseUrl || ""}/objects/${encodeURIComponent(key)}`;
+    const token = await this.getToken();
+    const headers = token ? { Authorization: `Bearer ${token}` } : void 0;
+    const res = await (0, import_cross_fetch.default)(url, { method: "DELETE", headers });
+    return res.ok;
+  }
+  async list(prefix = "") {
+    const url = `${this.options.baseUrl || ""}/objects?prefix=${encodeURIComponent(prefix)}`;
+    const token = await this.getToken();
+    const headers = token ? { Authorization: `Bearer ${token}` } : void 0;
+    const res = await (0, import_cross_fetch.default)(url, { headers });
+    if (!res.ok) return [];
+    const json = await res.json();
+    return Array.isArray(json) ? json : [];
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DidonatoStorageClient
+});

package/dist/index.mjs

@@ -0,0 +1,61 @@
+// src/DidonatoStorageClient.ts
+import fetch from "cross-fetch";
+var DidonatoStorageClient = class {
+  constructor(opts = {}) {
+    this.options = opts;
+  }
+  async getToken() {
+    const t = this.options.token;
+    if (!t) return void 0;
+    if (typeof t === "function") {
+      try {
+        return await t();
+      } catch (err) {
+        return void 0;
+      }
+    }
+    return String(t);
+  }
+  async getSignedUrl(key, expiresSec = 3600) {
+    return `${this.options.baseUrl || "https://storage.example.com"}/signed/${encodeURIComponent(
+      key
+    )}?exp=${expiresSec}`;
+  }
+  async createSignedPost(key) {
+    const url = `${this.options.baseUrl || ""}/signed-post/${encodeURIComponent(key)}`;
+    const res = await fetch(url);
+    if (!res.ok) throw new Error("failed to get signed post");
+    const json = await res.json();
+    return json;
+  }
+  async uploadWithSignedPost(url, fields, body) {
+    if (typeof FormData !== "undefined") {
+      const fd = new FormData();
+      for (const k in fields) fd.append(k, fields[k]);
+      fd.append("file", body);
+      const res = await fetch(url, { method: "POST", body: fd });
+      return res.ok;
+    }
+    throw new Error("FormData not available; use form-data package in Node tests");
+  }
+  async delete(key) {
+    const url = `${this.options.baseUrl || ""}/objects/${encodeURIComponent(key)}`;
+    const token = await this.getToken();
+    const headers = token ? { Authorization: `Bearer ${token}` } : void 0;
+    const res = await fetch(url, { method: "DELETE", headers });
+    return res.ok;
+  }
+  async list(prefix = "") {
+    const url = `${this.options.baseUrl || ""}/objects?prefix=${encodeURIComponent(prefix)}`;
+    const token = await this.getToken();
+    const headers = token ? { Authorization: `Bearer ${token}` } : void 0;
+    const res = await fetch(url, { headers });
+    if (!res.ok) return [];
+    const json = await res.json();
+    return Array.isArray(json) ? json : [];
+  }
+};
+export {
+  DidonatoStorageClient,
+  DidonatoStorageClient as default
+};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@applica-software-guru/didonato-storage-client",
+  "version": "1.0.29",
+  "description": "Client per Didonato Storage (Node + Browser)",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "test": "vitest",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "didonato",
+    "storage",
+    "gcs",
+    "signed-post"
+  ],
+  "author": "applica-software-guru",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "cross-fetch": "^4.1.0",
+    "form-data": "^4.0.5"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16",
+    "@types/node": "^25.0.3"
+  }
+}