@onlineapps/conn-base-storage 1.0.0

package/API.md

@@ -0,0 +1,618 @@
+<a name="module_@onlineapps/conn-base-storage"></a>
+
+## @onlineapps/conn-base-storage
+MinIO storage connector with automatic SHA256 fingerprinting for OA Drive.
+Provides immutable content storage with verification, caching, and presigned URLs.
+
+**See**: [GitHub Repository](https://github.com/onlineapps/oa-drive/tree/main/shared/connector/conn-base-storage)  
+**Since**: 1.0.0  
+**Author**: OA Drive Team  
+**License**: MIT  
+
+* [@onlineapps/conn-base-storage](#module_@onlineapps/conn-base-storage)
+    * _static_
+        * [.VERSION](#module_@onlineapps/conn-base-storage.VERSION) : <code>string</code>
+    * _inner_
+        * [~StorageConnector](#module_@onlineapps/conn-base-storage..StorageConnector)
+            * [new StorageConnector()](#new_module_@onlineapps/conn-base-storage..StorageConnector_new)
+            * [new StorageConnector([config])](#new_module_@onlineapps/conn-base-storage..StorageConnector_new)
+        * [~StorageConnector](#module_@onlineapps/conn-base-storage..StorageConnector)
+            * [new StorageConnector()](#new_module_@onlineapps/conn-base-storage..StorageConnector_new)
+            * [new StorageConnector([config])](#new_module_@onlineapps/conn-base-storage..StorageConnector_new)
+        * [~initialize()](#module_@onlineapps/conn-base-storage..initialize) ⇒ <code>Promise.&lt;boolean&gt;</code>
+        * [~generateFingerprint(content)](#module_@onlineapps/conn-base-storage..generateFingerprint) ⇒ <code>string</code>
+        * [~uploadWithFingerprint(bucket, content, [pathPrefix])](#module_@onlineapps/conn-base-storage..uploadWithFingerprint) ⇒ <code>Promise.&lt;UploadResult&gt;</code> \| <code>string</code> \| <code>string</code> \| <code>string</code> \| <code>string</code> \| <code>boolean</code>
+        * [~downloadWithVerification(bucket, path, expectedFingerprint)](#module_@onlineapps/conn-base-storage..downloadWithVerification) ⇒ <code>Promise.&lt;string&gt;</code>
+        * [~getPresignedUrl(bucket, path, [expiry])](#module_@onlineapps/conn-base-storage..getPresignedUrl) ⇒ <code>Promise.&lt;string&gt;</code>
+        * [~listWithFingerprints(bucket, [prefix])](#module_@onlineapps/conn-base-storage..listWithFingerprints) ⇒ <code>Promise.&lt;Array.&lt;ObjectInfo&gt;&gt;</code>
+        * [~deleteObject(bucket, path)](#module_@onlineapps/conn-base-storage..deleteObject) ⇒ <code>Promise.&lt;boolean&gt;</code>
+        * [~getPublicUrl(bucket, path)](#module_@onlineapps/conn-base-storage..getPublicUrl) ⇒ <code>string</code>
+        * [~ensureBucket(bucketName)](#module_@onlineapps/conn-base-storage..ensureBucket) ⇒ <code>Promise.&lt;boolean&gt;</code>
+        * [~validateBucketName(name)](#module_@onlineapps/conn-base-storage..validateBucketName) ⇒ <code>string</code>
+        * [~getObjectNameWithFingerprint(originalName, fingerprint)](#module_@onlineapps/conn-base-storage..getObjectNameWithFingerprint) ⇒ <code>string</code>
+        * [~extractFingerprintFromName(objectName)](#module_@onlineapps/conn-base-storage..extractFingerprintFromName) ⇒ <code>string</code> \| <code>null</code>
+        * [~clearCache()](#module_@onlineapps/conn-base-storage..clearCache) ⇒ <code>void</code>
+        * [~getInternalUrl(bucket, path)](#module_@onlineapps/conn-base-storage..getInternalUrl) ⇒ <code>string</code>
+        * ~~[~getPublicUrl(bucket, path)](#module_@onlineapps/conn-base-storage..getPublicUrl) ⇒ <code>string</code>~~
+        * [~getPresignedUrl(bucket, objectName, [expiry])](#module_@onlineapps/conn-base-storage..getPresignedUrl) ⇒ <code>Promise.&lt;string&gt;</code>
+        * [~listObjectsWithFingerprints(bucket, [prefix])](#module_@onlineapps/conn-base-storage..listObjectsWithFingerprints) ⇒ <code>Promise.&lt;Array.&lt;Object&gt;&gt;</code>
+        * [~create(config)](#module_@onlineapps/conn-base-storage..create) ⇒ <code>StorageConnector</code>
+        * [~UploadResult](#module_@onlineapps/conn-base-storage..UploadResult) : <code>Object</code>
+        * [~ObjectInfo](#module_@onlineapps/conn-base-storage..ObjectInfo) : <code>Object</code>
+
+<a name="module_@onlineapps/conn-base-storage.VERSION"></a>
+
+### @onlineapps/conn-base-storage.VERSION : <code>string</code>
+Current version
+
+**Kind**: static constant of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+<a name="module_@onlineapps/conn-base-storage..StorageConnector"></a>
+
+### @onlineapps/conn-base-storage~StorageConnector
+**Kind**: inner class of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+
+* [~StorageConnector](#module_@onlineapps/conn-base-storage..StorageConnector)
+    * [new StorageConnector()](#new_module_@onlineapps/conn-base-storage..StorageConnector_new)
+    * [new StorageConnector([config])](#new_module_@onlineapps/conn-base-storage..StorageConnector_new)
+
+<a name="new_module_@onlineapps/conn-base-storage..StorageConnector_new"></a>
+
+#### new StorageConnector()
+Storage connector for MinIO with automatic fingerprinting
+
+**Example** *(Basic Usage)*  
+```js
+const storage = new StorageConnector({
+  endPoint: 'minio.example.com',
+  port: 9000,
+  accessKey: 'minioadmin',
+  secretKey: 'minioadmin'
+});
+
+await storage.initialize();
+const result = await storage.uploadWithFingerprint(
+  'documents',
+  { type: 'invoice', amount: 1500 },
+  'invoices'
+);
+```
+**Example** *(With Caching)*  
+```js
+const storage = new StorageConnector({
+  cacheEnabled: true,
+  maxCacheSize: 200
+});
+```
+<a name="new_module_@onlineapps/conn-base-storage..StorageConnector_new"></a>
+
+#### new StorageConnector([config])
+Creates a new StorageConnector instance
+
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| [config] | <code>Object</code> | <code>{}</code> | Configuration options |
+| [config.endPoint] | <code>string</code> | <code>&quot;&#x27;localhost&#x27;&quot;</code> | MinIO server endpoint |
+| [config.port] | <code>number</code> | <code>9000</code> | MinIO server port |
+| [config.useSSL] | <code>boolean</code> | <code>false</code> | Use SSL/TLS |
+| [config.accessKey] | <code>string</code> | <code>&quot;&#x27;minioadmin&#x27;&quot;</code> | Access key |
+| [config.secretKey] | <code>string</code> | <code>&quot;&#x27;minioadmin&#x27;&quot;</code> | Secret key |
+| [config.defaultBucket] | <code>string</code> | <code>&quot;&#x27;api-storage&#x27;&quot;</code> | Default bucket name |
+| [config.cacheEnabled] | <code>boolean</code> | <code>true</code> | Enable content caching |
+| [config.maxCacheSize] | <code>number</code> | <code>100</code> | Maximum cache entries |
+| [config.logLevel] | <code>string</code> | <code>&quot;&#x27;info&#x27;&quot;</code> | Logging level |
+
+**Example** *(Full Configuration)*  
+```js
+const storage = new StorageConnector({
+  endPoint: 'minio.example.com',
+  port: 9000,
+  useSSL: true,
+  accessKey: 'AKIAIOSFODNN7EXAMPLE',
+  secretKey: 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY',
+  defaultBucket: 'production-storage',
+  cacheEnabled: true,
+  maxCacheSize: 500
+});
+```
+<a name="module_@onlineapps/conn-base-storage..StorageConnector"></a>
+
+### @onlineapps/conn-base-storage~StorageConnector
+**Kind**: inner class of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+
+* [~StorageConnector](#module_@onlineapps/conn-base-storage..StorageConnector)
+    * [new StorageConnector()](#new_module_@onlineapps/conn-base-storage..StorageConnector_new)
+    * [new StorageConnector([config])](#new_module_@onlineapps/conn-base-storage..StorageConnector_new)
+
+<a name="new_module_@onlineapps/conn-base-storage..StorageConnector_new"></a>
+
+#### new StorageConnector()
+Storage connector for MinIO with automatic fingerprinting
+
+**Example** *(Basic Usage)*  
+```js
+const storage = new StorageConnector({
+  endPoint: 'minio.example.com',
+  port: 9000,
+  accessKey: 'minioadmin',
+  secretKey: 'minioadmin'
+});
+
+await storage.initialize();
+const result = await storage.uploadWithFingerprint(
+  'documents',
+  { type: 'invoice', amount: 1500 },
+  'invoices'
+);
+```
+**Example** *(With Caching)*  
+```js
+const storage = new StorageConnector({
+  cacheEnabled: true,
+  maxCacheSize: 200
+});
+```
+<a name="new_module_@onlineapps/conn-base-storage..StorageConnector_new"></a>
+
+#### new StorageConnector([config])
+Creates a new StorageConnector instance
+
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| [config] | <code>Object</code> | <code>{}</code> | Configuration options |
+| [config.endPoint] | <code>string</code> | <code>&quot;&#x27;localhost&#x27;&quot;</code> | MinIO server endpoint |
+| [config.port] | <code>number</code> | <code>9000</code> | MinIO server port |
+| [config.useSSL] | <code>boolean</code> | <code>false</code> | Use SSL/TLS |
+| [config.accessKey] | <code>string</code> | <code>&quot;&#x27;minioadmin&#x27;&quot;</code> | Access key |
+| [config.secretKey] | <code>string</code> | <code>&quot;&#x27;minioadmin&#x27;&quot;</code> | Secret key |
+| [config.defaultBucket] | <code>string</code> | <code>&quot;&#x27;api-storage&#x27;&quot;</code> | Default bucket name |
+| [config.cacheEnabled] | <code>boolean</code> | <code>true</code> | Enable content caching |
+| [config.maxCacheSize] | <code>number</code> | <code>100</code> | Maximum cache entries |
+| [config.logLevel] | <code>string</code> | <code>&quot;&#x27;info&#x27;&quot;</code> | Logging level |
+
+**Example** *(Full Configuration)*  
+```js
+const storage = new StorageConnector({
+  endPoint: 'minio.example.com',
+  port: 9000,
+  useSSL: true,
+  accessKey: 'AKIAIOSFODNN7EXAMPLE',
+  secretKey: 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY',
+  defaultBucket: 'production-storage',
+  cacheEnabled: true,
+  maxCacheSize: 500
+});
+```
+<a name="module_@onlineapps/conn-base-storage..initialize"></a>
+
+### @onlineapps/conn-base-storage~initialize() ⇒ <code>Promise.&lt;boolean&gt;</code>
+Initialize connector and ensure bucket exists
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>Promise.&lt;boolean&gt;</code> - Returns true when initialized  
+**Throws**:
+
+- <code>Error</code> If initialization fails
+
+**Example**  
+```js
+try {
+  await storage.initialize();
+  console.log('Storage ready');
+} catch (error) {
+  console.error('Failed to initialize:', error);
+}
+```
+<a name="module_@onlineapps/conn-base-storage..generateFingerprint"></a>
+
+### @onlineapps/conn-base-storage~generateFingerprint(content) ⇒ <code>string</code>
+Generate SHA256 fingerprint for content
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>string</code> - SHA256 hash in hex format  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| content | <code>string</code> \| <code>Buffer</code> \| <code>Object</code> | Content to fingerprint |
+
+**Example** *(String Content)*  
+```js
+const hash = storage.generateFingerprint('Hello World');
+// Returns: SHA256 hash
+```
+**Example** *(Object Content)*  
+```js
+const hash = storage.generateFingerprint({ name: 'John', age: 30 });
+// Returns consistent hash for the object
+```
+<a name="module_@onlineapps/conn-base-storage..uploadWithFingerprint"></a>
+
+### @onlineapps/conn-base-storage~uploadWithFingerprint(bucket, content, [pathPrefix]) ⇒ <code>Promise.&lt;UploadResult&gt;</code> \| <code>string</code> \| <code>string</code> \| <code>string</code> \| <code>string</code> \| <code>boolean</code>
+Upload content with automatic fingerprinting
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>Promise.&lt;UploadResult&gt;</code> - Upload result with fingerprint<code>string</code> - result.fingerprint - SHA256 fingerprint<code>string</code> - result.bucket - Bucket name<code>string</code> - result.path - Storage path<code>string</code> - result.url - Public URL<code>boolean</code> - result.existed - Whether object already existed  
+**Throws**:
+
+- <code>Error</code> If upload fails
+
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| bucket | <code>string</code> |  | Bucket name |
+| content | <code>string</code> \| <code>Buffer</code> \| <code>Object</code> |  | Content to upload |
+| [pathPrefix] | <code>string</code> | <code>&quot;&#x27;&#x27;&quot;</code> | Path prefix for organization |
+
+**Example** *(Upload JSON Object)*  
+```js
+const result = await storage.uploadWithFingerprint(
+  'invoices',
+  { invoiceId: 'INV-123', amount: 1500 },
+  '2024/01'
+);
+console.log(`Stored at: ${result.url}`);
+console.log(`Fingerprint: ${result.fingerprint}`);
+```
+**Example** *(Upload String Content)*  
+```js
+const result = await storage.uploadWithFingerprint(
+  'documents',
+  'Important document content',
+  'contracts'
+);
+```
+**Example** *(Upload Buffer)*  
+```js
+const buffer = Buffer.from('Binary data');
+const result = await storage.uploadWithFingerprint(
+  'files',
+  buffer
+);
+```
+<a name="module_@onlineapps/conn-base-storage..downloadWithVerification"></a>
+
+### @onlineapps/conn-base-storage~downloadWithVerification(bucket, path, expectedFingerprint) ⇒ <code>Promise.&lt;string&gt;</code>
+Download content and verify fingerprint
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>Promise.&lt;string&gt;</code> - Content as string  
+**Throws**:
+
+- <code>Error</code> If download fails or fingerprint mismatch
+
+
+| Param | Type | Description |
+| --- | --- | --- |
+| bucket | <code>string</code> | Bucket name |
+| path | <code>string</code> | Object path |
+| expectedFingerprint | <code>string</code> | Expected SHA256 fingerprint |
+
+**Example** *(Download with Verification)*  
+```js
+const content = await storage.downloadWithVerification(
+  'invoices',
+  '2024/01/abc123.json',
+  'abc123...'
+);
+const data = JSON.parse(content);
+```
+**Example** *(Handle Verification Failure)*  
+```js
+try {
+  const content = await storage.downloadWithVerification(
+    'documents',
+    'contract.json',
+    expectedHash
+  );
+} catch (error) {
+  if (error.message.includes('Fingerprint mismatch')) {
+    console.error('Content has been tampered!');
+  }
+}
+```
+<a name="module_@onlineapps/conn-base-storage..getPresignedUrl"></a>
+
+### @onlineapps/conn-base-storage~getPresignedUrl(bucket, path, [expiry]) ⇒ <code>Promise.&lt;string&gt;</code>
+Get pre-signed URL for direct access
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>Promise.&lt;string&gt;</code> - Pre-signed URL  
+**Throws**:
+
+- <code>Error</code> If URL generation fails
+
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| bucket | <code>string</code> |  | Bucket name |
+| path | <code>string</code> |  | Object path |
+| [expiry] | <code>number</code> | <code>3600</code> | URL expiry in seconds |
+
+**Example** *(Generate Temporary URL)*  
+```js
+const url = await storage.getPresignedUrl(
+  'invoices',
+  '2024/01/invoice-123.json',
+  7200 // 2 hours
+);
+// Share URL with external service
+```
+**Example** *(Short-lived URL)*  
+```js
+const url = await storage.getPresignedUrl(
+  'temp',
+  'report.pdf',
+  300 // 5 minutes
+);
+```
+<a name="module_@onlineapps/conn-base-storage..listWithFingerprints"></a>
+
+### @onlineapps/conn-base-storage~listWithFingerprints(bucket, [prefix]) ⇒ <code>Promise.&lt;Array.&lt;ObjectInfo&gt;&gt;</code>
+List objects with fingerprint metadata
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>Promise.&lt;Array.&lt;ObjectInfo&gt;&gt;</code> - List of objects with metadata  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| bucket | <code>string</code> |  | Bucket name |
+| [prefix] | <code>string</code> | <code>&quot;&#x27;&#x27;&quot;</code> | Path prefix to filter |
+
+**Example** *(List All Objects)*  
+```js
+const objects = await storage.listWithFingerprints('invoices');
+objects.forEach(obj => {
+  console.log(`${obj.name}: ${obj.fingerprint}`);
+});
+```
+**Example** *(List with Prefix)*  
+```js
+const objects = await storage.listWithFingerprints(
+  'documents',
+  '2024/01/'
+);
+```
+<a name="module_@onlineapps/conn-base-storage..deleteObject"></a>
+
+### @onlineapps/conn-base-storage~deleteObject(bucket, path) ⇒ <code>Promise.&lt;boolean&gt;</code>
+Delete object (use with caution - breaks immutability)
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>Promise.&lt;boolean&gt;</code> - Returns true on successful deletion  
+**Throws**:
+
+- <code>Error</code> If deletion fails
+
+**Warning**: This breaks immutability - use only when necessary  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| bucket | <code>string</code> | Bucket name |
+| path | <code>string</code> | Object path |
+
+**Example**  
+```js
+await storage.deleteObject('temp', 'temporary-file.json');
+```
+<a name="module_@onlineapps/conn-base-storage..getPublicUrl"></a>
+
+### @onlineapps/conn-base-storage~getPublicUrl(bucket, path) ⇒ <code>string</code>
+Get public URL for an object
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>string</code> - Public URL  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| bucket | <code>string</code> | Bucket name |
+| path | <code>string</code> | Object path |
+
+**Example**  
+```js
+const url = storage.getPublicUrl('invoices', '2024/invoice-123.json');
+// Returns: http://localhost:9000/invoices/2024/invoice-123.json
+```
+<a name="module_@onlineapps/conn-base-storage..ensureBucket"></a>
+
+### @onlineapps/conn-base-storage~ensureBucket(bucketName) ⇒ <code>Promise.&lt;boolean&gt;</code>
+Create bucket if not exists
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>Promise.&lt;boolean&gt;</code> - Returns true when bucket exists  
+**Throws**:
+
+- <code>Error</code> If bucket creation fails
+
+
+| Param | Type | Description |
+| --- | --- | --- |
+| bucketName | <code>string</code> | Bucket name to ensure |
+
+**Example**  
+```js
+await storage.ensureBucket('new-bucket');
+```
+<a name="module_@onlineapps/conn-base-storage..validateBucketName"></a>
+
+### @onlineapps/conn-base-storage~validateBucketName(name) ⇒ <code>string</code>
+Validate bucket name according to S3 standards
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>string</code> - Valid bucket name or default  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| name | <code>string</code> | Bucket name to validate |
+
+**Example**  
+```js
+const validName = storage.validateBucketName('My-Bucket');
+// Returns: 'oa-drive-storage' (invalid characters)
+```
+<a name="module_@onlineapps/conn-base-storage..getObjectNameWithFingerprint"></a>
+
+### @onlineapps/conn-base-storage~getObjectNameWithFingerprint(originalName, fingerprint) ⇒ <code>string</code>
+Get object name with fingerprint appended
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>string</code> - Name with fingerprint  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| originalName | <code>string</code> | Original file name |
+| fingerprint | <code>string</code> | SHA256 fingerprint |
+
+**Example**  
+```js
+const name = storage.getObjectNameWithFingerprint('document.pdf', 'abc123...');
+// Returns: 'document-abc123...pdf'
+```
+<a name="module_@onlineapps/conn-base-storage..extractFingerprintFromName"></a>
+
+### @onlineapps/conn-base-storage~extractFingerprintFromName(objectName) ⇒ <code>string</code> \| <code>null</code>
+Extract fingerprint from object name
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>string</code> \| <code>null</code> - Extracted fingerprint or null  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| objectName | <code>string</code> | Object name with fingerprint |
+
+**Example**  
+```js
+const fp = storage.extractFingerprintFromName('document-abc123def456.pdf');
+// Returns: 'abc123def456' if valid format
+```
+<a name="module_@onlineapps/conn-base-storage..clearCache"></a>
+
+### @onlineapps/conn-base-storage~clearCache() ⇒ <code>void</code>
+Clear all caches
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Example**  
+```js
+storage.clearCache();
+// All cached content cleared
+```
+<a name="module_@onlineapps/conn-base-storage..getInternalUrl"></a>
+
+### @onlineapps/conn-base-storage~getInternalUrl(bucket, path) ⇒ <code>string</code>
+Get internal URL for service-to-service communication
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>string</code> - Internal URL with internal:// protocol  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| bucket | <code>string</code> | Bucket name |
+| path | <code>string</code> | Object path |
+
+**Example**  
+```js
+const url = storage.getInternalUrl('invoices', 'invoice-123.json');
+// Returns: 'internal://storage/invoices/invoice-123.json'
+```
+<a name="module_@onlineapps/conn-base-storage..getPublicUrl"></a>
+
+### ~~@onlineapps/conn-base-storage~getPublicUrl(bucket, path) ⇒ <code>string</code>~~
+***Use getInternalUrl() for service-to-service communication***
+
+Get public URL for an object
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>string</code> - Internal URL for backward compatibility  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| bucket | <code>string</code> | Bucket name |
+| path | <code>string</code> | Object path |
+
+<a name="module_@onlineapps/conn-base-storage..getPresignedUrl"></a>
+
+### @onlineapps/conn-base-storage~getPresignedUrl(bucket, objectName, [expiry]) ⇒ <code>Promise.&lt;string&gt;</code>
+Get presigned URL for temporary access
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>Promise.&lt;string&gt;</code> - Pre-signed URL  
+**Throws**:
+
+- <code>Error</code> If URL generation fails
+
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| bucket | <code>string</code> |  | Bucket name |
+| objectName | <code>string</code> |  | Object name |
+| [expiry] | <code>number</code> | <code>86400</code> | URL expiry in seconds (default 24 hours) |
+
+**Example**  
+```js
+const url = await storage.getPresignedUrl('documents', 'contract.pdf', 3600);
+```
+<a name="module_@onlineapps/conn-base-storage..listObjectsWithFingerprints"></a>
+
+### @onlineapps/conn-base-storage~listObjectsWithFingerprints(bucket, [prefix]) ⇒ <code>Promise.&lt;Array.&lt;Object&gt;&gt;</code>
+List objects with extracted fingerprints
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>Promise.&lt;Array.&lt;Object&gt;&gt;</code> - List of objects with fingerprints  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| bucket | <code>string</code> |  | Bucket name |
+| [prefix] | <code>string</code> | <code>&quot;&#x27;&#x27;&quot;</code> | Path prefix to filter |
+
+**Example**  
+```js
+const objects = await storage.listObjectsWithFingerprints('invoices', '2024/');
+```
+<a name="module_@onlineapps/conn-base-storage..create"></a>
+
+### @onlineapps/conn-base-storage~create(config) ⇒ <code>StorageConnector</code>
+Factory function to create storage instance
+
+**Kind**: inner method of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Returns**: <code>StorageConnector</code> - New storage connector instance  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| config | <code>Object</code> | Configuration object |
+
+**Example**  
+```js
+const storage = StorageConnector.create({
+  endPoint: 'minio.example.com',
+  accessKey: 'key',
+  secretKey: 'secret'
+});
+```
+<a name="module_@onlineapps/conn-base-storage..UploadResult"></a>
+
+### @onlineapps/conn-base-storage~UploadResult : <code>Object</code>
+**Kind**: inner typedef of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Properties**
+
+| Name | Type | Description |
+| --- | --- | --- |
+| fingerprint | <code>string</code> | SHA256 fingerprint of content |
+| bucket | <code>string</code> | Bucket name |
+| path | <code>string</code> | Storage path |
+| url | <code>string</code> | Public or internal URL |
+| existed | <code>boolean</code> | Whether object already existed |
+
+<a name="module_@onlineapps/conn-base-storage..ObjectInfo"></a>
+
+### @onlineapps/conn-base-storage~ObjectInfo : <code>Object</code>
+**Kind**: inner typedef of [<code>@onlineapps/conn-base-storage</code>](#module_@onlineapps/conn-base-storage)  
+**Properties**
+
+| Name | Type | Description |
+| --- | --- | --- |
+| name | <code>string</code> | Object name |
+| size | <code>number</code> | Object size in bytes |
+| lastModified | <code>Date</code> | Last modification date |
+| [fingerprint] | <code>string</code> | SHA256 fingerprint if available |
+| [uploadedAt] | <code>string</code> | Upload timestamp |
+