@quatrain/storage-supabase 1.1.17 → 1.1.19

package/LICENSE.md

@@ -0,0 +1,15 @@
+# LICENSE UPDATE NOTICE
+
+As of 01/01/2026, Quatrain Core is licensed under the **GNU Affero General Public License v3.0 (AGPL v3)**.
+Previous versions remain under the MIT License.
+
+## Why AGPL?
+
+We believe in open collaboration for the development ecosystem. The AGPL ensures that any modification or deployment of this BaaS stack, including over a network, benefits the entire community.
+
+## Commercial Services & Enterprise Usage
+
+We provide official deployment services, technical training, and certification for Quatrain Core.
+For organizations requiring a non-copyleft license (commercial license) or custom proprietary integrations, please contact the copyright holder: **Quatrain Technologies**.
+
+Copyright © 2024-2026 Quatrain Technologies. All Rights Reserved.

package/lib/SupabaseStorageAdapter.js

@@ -26,7 +26,7 @@ class SupabaseStorageAdapter extends storage_1.AbstractStorageAdapter {
             apikey: params.config.secret,
             Authorization: `Bearer ${params.config.secret}`,
         });
-        storage_1.Storage.log(`[SSA] Supabase Storage Adapter initialized`);
+        storage_1.Storage.info(`[SSA] Supabase Storage Adapter initialized`);
     }
     getDriver() {
         return this._client;
@@ -80,7 +80,7 @@ class SupabaseStorageAdapter extends storage_1.AbstractStorageAdapter {
                     contentType: file.contentType,
                 });
                 if (error !== null) {
-                    console.log(error);
+                    storage_1.Storage.error(error);
                     storage_1.Storage.error(`Unable to upload ${file.ref} to ${file.bucket}`);
                     throw new Error(`Unable to upload ${file.ref} to ${file.bucket}`);
                 }

package/package.json

@@ -1,41 +1,39 @@
 {
-  "name": "@quatrain/storage-supabase",
-  "version": "1.1.17",
-  "description": "Storage adapter for Supabase Storage",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
-  "files": [
-    "lib/",
-    "README.md"
-  ],
-  "author": "Quatrain Développement SAS <developers@quatrain.com>",
-  "license": "MIT",
-  "devDependencies": {
-    "@tsconfig/recommended": "^1.0.1",
-    "@types/jest": "^27.0.3",
-    "@types/node": "^22.10.1",
-    "jest": "^30.2.0",
-    "jest-node-exports-resolver": "^1.1.6",
-    "trace-unhandled": "^2.0.1",
-    "ts-jest": "^27.1.2",
-    "ts-node": "^10.4.0",
-    "typescript": "^5.1.5"
-  },
-  "dependencies": {
-    "@quatrain/core": "^1.1.24",
-    "@quatrain/storage": "^1.1.23",
-    "@supabase/storage-js": "^2.7.2",
-    "@supabase/supabase-js": "^2.87.3"
-  },
-  "scripts": {
-    "test-ci": "jest --runInBand",
-    "build": "tsc",
-    "wbuild": "tsc --watch",
-    "bump-to": "yarn version",
-    "hash": "node ../../bin/hashFolder.js",
-    "hash:persist": "yarn hash  > .hash_latest.txt",
-    "hash:compare": "yarn hash > .hash_newest.txt && cmp -s .hash_latest.txt .hash_newest.txt",
-    "publish": "yarn hash:compare || yarn publish:process",
-    "publish:process": "yarn version patch && yarn build && yarn npm publish --access public && yarn hash:persist"
-  }
-}
+   "name": "@quatrain/storage-supabase",
+   "version": "1.1.19",
+   "description": "Storage adapter for Supabase Storage",
+   "main": "lib/index.js",
+   "types": "lib/index.d.ts",
+   "bun": "src/index.ts",
+   "files": [
+      "LICENSE.md",
+      "src/",
+      "lib/",
+      "README.md"
+   ],
+   "author": "Quatrain Développement SAS <developers@quatrain.com>",
+   "license": "AGPL-3.0-only",
+   "devDependencies": {
+      "@tsconfig/recommended": "^1.0.1",
+      "@types/jest": "^27.0.3",
+      "@types/node": "^22.10.1",
+      "jest": "^30.2.0",
+      "jest-node-exports-resolver": "^1.1.6",
+      "trace-unhandled": "^2.0.1",
+      "ts-jest": "^27.1.2",
+      "ts-node": "^10.4.0",
+      "typescript": "^5.1.5"
+   },
+   "dependencies": {
+      "@quatrain/core": "^1.1.43",
+      "@quatrain/storage": "^1.1.24",
+      "@supabase/storage-js": "^2.7.2",
+      "@supabase/supabase-js": "^2.87.3"
+   },
+   "scripts": {
+      "test-ci": "jest --runInBand",
+      "build": "tsc",
+      "wbuild": "tsc --watch",
+      "bump-to": "yarn version"
+   }
+}

package/src/SupabaseStorageAdapter.ts

@@ -0,0 +1,250 @@
+import {
+   Storage,
+   AbstractStorageAdapter,
+   FileType,
+   FileResponseLinkType,
+   StorageParameters,
+   DownloadFileMetaType,
+} from '@quatrain/storage'
+import { Readable, Stream } from 'stream'
+import { StorageClient } from '@supabase/storage-js'
+import { tmpdir } from 'os'
+import { join } from 'path'
+import fs from 'node:fs'
+
+export class SupabaseStorageAdapter extends AbstractStorageAdapter {
+   protected _client: StorageClient
+
+   constructor(params: StorageParameters) {
+      super(params)
+      this._client = new StorageClient(params.config.endpoint, {
+         apikey: params.config.secret,
+         Authorization: `Bearer ${params.config.secret}`,
+      })
+
+      Storage.info(`[SSA] Supabase Storage Adapter initialized`)
+   }
+
+   getDriver() {
+      return this._client
+   }
+
+   getMetaData(file: FileType): Promise<FileType> {
+      return new Promise(() => file)
+   }
+
+   async test(): Promise<boolean> {
+      try {
+         const { data, error } = await this._client.listBuckets()
+
+         if (error !== null) {
+            Storage.error(`Unable to get buckets list`)
+            throw new Error(`Unable to get buckets list: ${error.message}`)
+         }
+
+         // Storage.info(`S3 Buckets: ${JSON.stringify(data)}`)
+
+         return true
+      } catch (err) {
+         Storage.error(
+            `Failed to connect to storage: ${(err as Error).message}`
+         )
+         return false
+      }
+   }
+
+   async streamToBuffer(stream: Stream): Promise<Buffer> {
+      return new Promise<Buffer>((resolve, reject) => {
+         const _buf: any[] = []
+
+         stream.on('data', (chunk) => _buf.push(chunk))
+         stream.on('end', () => resolve(Buffer.concat(_buf)))
+         stream.on('error', (err) => reject(err))
+      })
+   }
+
+   toArrayBuffer(buffer: Buffer): ArrayBuffer {
+      const arrayBuffer = new ArrayBuffer(buffer.length)
+      const view = new Uint8Array(arrayBuffer)
+      for (let i = 0; i < buffer.length; ++i) {
+         view[i] = buffer[i]
+      }
+      return arrayBuffer
+   }
+
+   async create(file: FileType, stream: Readable | string): Promise<FileType> {
+      Storage.info(`[SSA] Uploading ${file.ref} to ${file.bucket}`)
+
+      if (typeof stream === 'string') {
+         const { error } = await this._client
+            .from(file.bucket)
+            .upload(file.ref, new Blob([fs.readFileSync(stream)]), {
+               upsert: true,
+               contentType: file.contentType,
+            })
+         if (error !== null) {
+            Storage.error(error)
+            Storage.error(`Unable to upload ${file.ref} to ${file.bucket}`)
+            throw new Error(`Unable to upload ${file.ref} to ${file.bucket}`)
+         }
+      } else {
+         const content = new Blob([
+            this.toArrayBuffer(await this.streamToBuffer(stream)),
+         ])
+         const { error } = await this._client
+            .from(file.bucket)
+            .upload(file.ref, content, {
+               //   cacheControl: '3600',
+               upsert: false,
+               contentType: file.contentType,
+            })
+         if (error !== null) {
+            console.log(error)
+            Storage.error(`Unable to upload ${file.ref} to ${file.bucket}`)
+            throw new Error(`Unable to upload ${file.ref} to ${file.bucket}`)
+         }
+      }
+
+      return file
+   }
+
+   async copy(file: FileType, destFile: FileType) {
+      try {
+         const response = await this._client
+            .from(file.bucket)
+            .copy(file.ref, destFile.ref, {
+               destinationBucket: destFile.bucket,
+            })
+      } catch (err) {
+         console.error(err)
+      }
+   }
+
+   async move(file: FileType, destFile: FileType) {
+      Storage.info(
+         `Moving file ${file.ref} to ${destFile.ref} in same bucket ${file.bucket}`
+      )
+      const { error } = await this._client
+         .from(file.bucket)
+         .move(file.ref, destFile.ref)
+
+      if (error !== null) {
+         Storage.error(
+            `Unable to move ${file.ref} to ${destFile.ref}: ${error.message}`
+         )
+         throw new Error(`Unable to move ${file.ref} to ${destFile.ref}`)
+      }
+
+      return destFile
+   }
+
+   async getUrl(file: FileType, expiresIn = 3600) {
+      Storage.debug(
+         `Getting signed url for file ${file.ref} in bucket ${file.bucket}`
+      )
+      const { data, error } = await this._client
+         .from(file.bucket)
+         .createSignedUrl(file.ref, expiresIn, { download: true })
+
+      if (error !== null) {
+         throw new Error(`Unable to get signed url: ${error}`)
+      }
+
+      return { url: data?.signedUrl, expiresIn }
+   }
+
+   async delete(file: FileType) {
+      Storage.info(`Deleting file ${file.ref} in bucket ${file.bucket}`)
+      const { error } = await this._client.from(file.bucket).remove([file.ref])
+
+      if (error !== null) {
+         throw new Error(`Unable to delete ${file.ref}`)
+      }
+
+      Storage.info(`Object ${file.ref} successfully deleted`)
+
+      return true
+   }
+
+   async getReadable(file: FileType): Promise<Readable> {
+      Storage.debug(`GET Readable : ${file.ref}`)
+
+      const path = join(tmpdir(), String(Date.now()))
+      const item = await this.download(file, { path, onlyContent: true })
+      const buffer = Buffer.from(item.toString(), 'base64')
+      const readable = new Readable()
+      readable.push(buffer)
+      readable.push(null)
+
+      return readable
+   }
+
+   async stream(file: FileType, res: any) {
+      Storage.debug(`GET Stream : ${file.ref}`)
+
+      const path = join(tmpdir(), String(Date.now()))
+      const item = await this.download(file, { path, onlyContent: true })
+      const buffer = Buffer.from(item.toString(), 'base64')
+      const readable = new Readable()
+      readable.push(buffer)
+      readable.push(null)
+
+      return readable.pipe(res)
+   }
+
+   async download(
+      file: FileType,
+      meta: DownloadFileMetaType
+   ): Promise<string | Blob> {
+      const { data, error } = await this._client
+         .from(file.bucket)
+         .download(file.ref)
+
+      if (error !== null) {
+         console.log(error)
+         throw new Error(`Unable to download ${file.ref}`)
+      }
+
+      if (meta.onlyContent) {
+         return data
+      }
+
+      // Write the downloaded data to the specified path
+      const buffer = await data.arrayBuffer()
+      fs.writeFileSync(meta.path, Buffer.from(buffer))
+
+      return meta.path
+   }
+
+   /**
+    * Get signed upload url for file
+    * Careful, on docker the time to live for JWT signature is defaulted to 60 sec
+    * Add SIGNED_UPLOAD_URL_EXPIRATION_TIME env variable to fix TTL
+    * @param file FileType
+    * @param _expiresIn actually ignored
+    * @returns
+    */
+   async getUploadUrl(
+      file: FileType,
+      _expiresIn = 7200
+   ): Promise<FileResponseLinkType> {
+      const { data, error } = await this._client
+         .from(file.bucket)
+         .createSignedUploadUrl(file.ref, { upsert: true })
+
+      if (error !== null) {
+         throw new Error(`Unable to get signed upload url: ${error}`)
+      }
+
+      Storage.info(
+         `Upload URL for ${file.ref} in bucket ${file.bucket} is ${data?.signedUrl}`
+      )
+
+      return {
+         url: data?.signedUrl,
+         method: 'PUT',
+         accept: file.contentType || 'application/octet-stream',
+         expiresIn: 7200, // fixed value in Supabase
+      }
+   }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+import { SupabaseStorageAdapter } from './SupabaseStorageAdapter'
+
+export { SupabaseStorageAdapter }