@visulima/storage 1.0.9 → 1.0.11

package/dist/storage/aws/index.d.ts

@@ -1,8 +1,9 @@
-import { F as File, k as MetaStorageOptions, l as BaseStorageOptions, L as LocalMetaStorageOptions, M as MetaStorage, H as HttpError, f as FileQuery, O as OperationOptions, d as FileInit } from "../../packem_shared/storage.d-CEM1upWM.js";
+import { F as File, k as MetaStorageOptions, l as BaseStorageOptions, L as LocalMetaStorageOptions, M as MetaStorage, H as HttpError, f as FileQuery, O as OperationOptions, d as FileInit } from "../../packem_shared/storage.d-DwdJrArF.js";
 import { Readable } from 'node:stream';
-import { P as Part, S as S3CallOptions, a as S3ApiOperations, b as S3BaseStorage } from "../../packem_shared/s3-base-storage.d-BQgP5B-t.js";
+import { P as Part, S as S3CallOptions, a as S3ApiOperations, b as S3BaseStorage } from "../../packem_shared/s3-base-storage.d-ks99NSs-.js";
 import { S3ClientConfig, ObjectCannedACL, S3Client } from '@aws-sdk/client-s3';
 import { ResponseMetadata } from '@aws-sdk/types';
+import 'node:timers';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
@@ -19,53 +20,53 @@ type S3MetaStorageOptions = MetaStorageOptions & S3ClientConfig & {
 };
 type S3StorageOptions = BaseStorageOptions & S3ClientConfig & {
   /**
-  * Specifying access rules for uploaded files.
-  */
+   * Specifying access rules for uploaded files.
+   */
   acl?: ObjectCannedACL;
   /**
-  * S3 bucket name.
-  * @default 'node-Upload'
-  */
+   * S3 bucket name.
+   * @default 'node-Upload'
+   */
   bucket?: string;
   /**
-  * Force compatible client upload directly to S3 storage
-  */
+   * Force compatible client upload directly to S3 storage
+   */
   clientDirectUpload?: boolean;
   /**
-  * @deprecated Use standard auth providers
-  */
+   * @deprecated Use standard auth providers
+   */
   keyFile?: string;
   /**
-  * Configure metafiles storage
-  * @example
-  * Using local metafiles
-  * ```ts
-  * const storage = new S3Storage({
-  *   bucket: 'upload',
-  *   region: 'eu-west-3',
-  *   metaStorageConfig: { directory: '/tmp/upload-metafiles' }
-  * })
-  * ```
-  * Using a separate bucket for metafiles
-  * ```ts
-  * const storage = new S3Storage({
-  *   bucket: 'upload',
-  *   region: 'eu-west-3',
-  *   metaStorageConfig: { bucket: 'upload-metafiles' }
-  * })
-  * ```
-  */
+   * Configure metafiles storage
+   * @example
+   * Using local metafiles
+   * ```ts
+   * const storage = new S3Storage({
+   *   bucket: 'upload',
+   *   region: 'eu-west-3',
+   *   metaStorageConfig: { directory: '/tmp/upload-metafiles' }
+   * })
+   * ```
+   * Using a separate bucket for metafiles
+   * ```ts
+   * const storage = new S3Storage({
+   *   bucket: 'upload',
+   *   region: 'eu-west-3',
+   *   metaStorageConfig: { bucket: 'upload-metafiles' }
+   * })
+   * ```
+   */
   metaStorageConfig?: LocalMetaStorageOptions | S3MetaStorageOptions;
   /**
-  * The parts size that the client should use for presigned multipart unloading.
-  * @default '16MB'
-  */
+   * The parts size that the client should use for presigned multipart unloading.
+   * @default '16MB'
+   */
   partSize?: number | string;
 };
 /**
-* SDK V3
-* A structure containing information about a service or networking error.
-*/
+ * SDK V3
+ * A structure containing information about a service or networking error.
+ */
 interface AwsError extends Error {
   $fault?: "client" | "server";
   $metadata: ResponseMetadata;
@@ -74,53 +75,53 @@ interface AwsError extends Error {
   Type?: string;
 }
 /**
-* SDK V2
-* A structure containing information about a service or networking error.
-*/
+ * SDK V2
+ * A structure containing information about a service or networking error.
+ */
 interface AWSErrorV2 extends Error {
   /**
-  * CloudFront request ID associated with the response.
-  */
+   * CloudFront request ID associated with the response.
+   */
   cfId: string;
   /**
-  * A unique short code representing the error that was emitted.
-  */
+   * A unique short code representing the error that was emitted.
+   */
   code: string;
   /**
-  * Second request ID associated with the response from S3.
-  */
+   * Second request ID associated with the response from S3.
+   */
   extendedRequestId: string;
   /**
-  * Set when a networking error occurs to easily identify the endpoint of the request.
-  */
+   * Set when a networking error occurs to easily identify the endpoint of the request.
+   */
   hostname: string;
   /**
-  * A longer human readable error message.
-  */
+   * A longer human readable error message.
+   */
   message: string;
   /**
-  * Set when a networking error occurs to easily identify the region of the request.
-  */
+   * Set when a networking error occurs to easily identify the region of the request.
+   */
   region: string;
   /**
-  * The unique request ID associated with the response.
-  */
+   * The unique request ID associated with the response.
+   */
   requestId: string;
   /**
-  * Whether the error message is retryable.
-  */
+   * Whether the error message is retryable.
+   */
   retryable: boolean;
   /**
-  * Amount of time (in seconds) that the request waited before being resent.
-  */
+   * Amount of time (in seconds) that the request waited before being resent.
+   */
   retryDelay: number;
   /**
-  * In the case of a request that reached the service, this value contains the response status code.
-  */
+   * In the case of a request that reached the service, this value contains the response status code.
+   */
   statusCode: number;
   /**
-  * The date time object when the error occurred.
-  */
+   * The date time object when the error occurred.
+   */
   time: Date;
 }
 declare class S3MetaStorage<T extends File = File> extends MetaStorage<T> {
@@ -136,8 +137,8 @@ declare class S3MetaStorage<T extends File = File> extends MetaStorage<T> {
 }
 type ReadableStream = globalThis.ReadableStream;
 /**
-* Adapter that wraps AWS SDK S3Client to implement S3ApiOperations interface.
-*/
+ * Adapter that wraps AWS SDK S3Client to implement S3ApiOperations interface.
+ */
 declare class S3ClientAdapter implements S3ApiOperations {
   private readonly client;
   constructor(client: S3Client, _bucket: string);
@@ -247,63 +248,59 @@ declare class S3ClientAdapter implements S3ApiOperations {
   }): Promise<void>;
 }
 /**
-* Amazon S3 storage implementation.
-* @example
-* ```ts
-* const storage = new S3Storage({
-*  bucket: <YOUR_BUCKET>,
-*  endpoint: <YOUR_ENDPOINT>,
-*  region: <YOUR_REGION>,
-*  credentials: {
-*    accessKeyId: <YOUR_ACCESS_KEY_ID>,
-*    secretAccessKey: <YOUR_SECRET_ACCESS_KEY>
-*  },
-*  metaStorageConfig: { directory: '/tmp/upload-metafiles' }
-* });
-* ```
-* @remarks
-* ## Error Handling
-* - S3 API errors are normalized with AWS-specific context
-* - Errors include S3 error codes and metadata for debugging
-* - Batch operations handle individual failures gracefully
-*
-* ## Retry Behavior
-* - All S3 API calls are wrapped with configurable retry logic via `retryConfig` option
-* - Default retryable status codes: 408 (Request Timeout), 429 (Too Many Requests),
-* 500 (Internal Server Error), 502 (Bad Gateway), 503 (Service Unavailable), 504 (Gateway Timeout)
-* - Retries server-side faults ($fault === "server") automatically
-* - Custom `shouldRetry` function can be provided for advanced retry logic
-* - Default retry configuration: maxRetries: 3, initialDelay: 1000ms, maxDelay: 30000ms, backoffMultiplier: 2 (exponential backoff)
-* - Retry wrapper handles transient network errors and rate limiting
-*
-* ## Multipart Uploads
-* - Large files are automatically split into multipart uploads
-* - Maximum 10,000 parts per upload (S3 limitation)
-* - Part size is configurable (default: 16MB, minimum: 5MB)
-* - Failed multipart uploads are automatically aborted
-*
-* ## Supported Operations
-* - ✅ create, write, delete, get, getStream, list, update, copy, move
-* - ✅ Batch operations: deleteBatch, copyBatch, moveBatch (inherited from BaseStorage)
-* - ✅ exists: Implemented (checks metadata and S3 object)
-* - ❌ getUrl: Not implemented (presigned URLs available via buildPresigned for clientDirectUpload)
-* - ❌ getUploadUrl: Not implemented (presigned URLs available via buildPresigned for clientDirectUpload)
-*/
+ * Amazon S3 storage implementation.
+ * @example
+ * ```ts
+ * const storage = new S3Storage({
+ *  bucket: <YOUR_BUCKET>,
+ *  endpoint: <YOUR_ENDPOINT>,
+ *  region: <YOUR_REGION>,
+ *  credentials: {
+ *    accessKeyId: <YOUR_ACCESS_KEY_ID>,
+ *    secretAccessKey: <YOUR_SECRET_ACCESS_KEY>
+ *  },
+ *  metaStorageConfig: { directory: '/tmp/upload-metafiles' }
+ * });
+ * ```
+ * @remarks
+ * ## Error Handling
+ * - S3 API errors are normalized with AWS-specific context
+ * - Errors include S3 error codes and metadata for debugging
+ * - Batch operations handle individual failures gracefully
+ *
+ * ## Retry Behavior
+ * - All S3 API calls are wrapped with configurable retry logic via `retryConfig` option
+ * - Default retryable status codes: 408 (Request Timeout), 429 (Too Many Requests),
+ * 500 (Internal Server Error), 502 (Bad Gateway), 503 (Service Unavailable), 504 (Gateway Timeout)
+ * - Retries server-side faults ($fault === "server") automatically
+ * - Custom `shouldRetry` function can be provided for advanced retry logic
+ * - Default retry configuration: maxRetries: 3, initialDelay: 1000ms, maxDelay: 30000ms, backoffMultiplier: 2 (exponential backoff)
+ * - Retry wrapper handles transient network errors and rate limiting
+ *
+ * ## Multipart Uploads
+ * - Large files are automatically split into multipart uploads
+ * - Maximum 10,000 parts per upload (S3 limitation)
+ * - Part size is configurable (default: 16MB, minimum: 5MB)
+ * - Failed multipart uploads are automatically aborted
+ *
+ * ## Supported Operations
+ * - ✅ create, write, delete, get, getStream, list, update, copy, move
+ * - ✅ Batch operations: deleteBatch, copyBatch, moveBatch (inherited from BaseStorage)
+ * - ✅ exists: Implemented (checks metadata and S3 object)
+ * - ❌ getUrl: Not implemented (presigned URLs available via buildPresigned for clientDirectUpload)
+ * - ❌ getUploadUrl: Not implemented (presigned URLs available via buildPresigned for clientDirectUpload)
+ */
 declare class S3Storage extends S3BaseStorage {
   static override readonly name: string;
   private s3Api;
   private rawClient;
   constructor(config: S3StorageOptions);
   /**
-  * Normalizes AWS S3 errors with S3-specific context.
-  */
+   * Normalizes AWS S3 errors with S3-specific context.
+   */
   override normalizeError(error: AwsError): HttpError;
-  override update({
-    id
-  }: FileQuery, metadata: Partial<S3File>): Promise<S3File>;
-  override getStream({
-    id
-  }: FileQuery, options?: OperationOptions & {
+  override update({ id }: FileQuery, metadata: Partial<S3File>): Promise<S3File>;
+  override getStream({ id }: FileQuery, options?: OperationOptions & {
     range?: {
       end?: number;
       start: number;

package/dist/storage/aws/index.js

@@ -1 +1 @@
-import{default as t}from"../../packem_shared/S3File-CpZrubaV.js";import{default as r}from"../../packem_shared/S3MetaStorage-CMonflzp.js";import{default as S}from"../../packem_shared/S3Storage-YGeNk3Tt.js";export{t as S3File,r as S3MetaStorage,S as S3Storage};
+import{default as t}from"../../packem_shared/S3File-CpZrubaV.js";import{default as r}from"../../packem_shared/S3MetaStorage-CMonflzp.js";import{default as S}from"../../packem_shared/S3Storage-CTe_BMDl.js";export{t as S3File,r as S3MetaStorage,S as S3Storage};

package/dist/storage/aws-light/index.d.ts

@@ -1,7 +1,8 @@
-import { P as Part, S as S3CallOptions, a as S3ApiOperations, b as S3BaseStorage } from "../../packem_shared/s3-base-storage.d-BQgP5B-t.js";
-import { F as File, k as MetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, H as HttpError, f as FileQuery, O as OperationOptions, d as FileInit } from "../../packem_shared/storage.d-CEM1upWM.js";
+import { P as Part, S as S3CallOptions, a as S3ApiOperations, b as S3BaseStorage } from "../../packem_shared/s3-base-storage.d-ks99NSs-.js";
+import { F as File, k as MetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, H as HttpError, f as FileQuery, O as OperationOptions, d as FileInit } from "../../packem_shared/storage.d-DwdJrArF.js";
 import { Readable } from 'node:stream';
 import { AwsClient } from 'aws4fetch';
+import 'node:timers';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
@@ -25,21 +26,21 @@ type AwsLightMetaStorageOptions = AwsLightClientConfig & MetaStorageOptions & {
 };
 type AwsLightStorageOptions = AwsLightClientConfig & BaseStorageOptions & {
   /**
-  * S3 bucket name.
-  */
+   * S3 bucket name.
+   */
   bucket?: string;
   /**
-  * Force compatible client upload directly to S3 storage
-  */
+   * Force compatible client upload directly to S3 storage
+   */
   clientDirectUpload?: boolean;
   /**
-  * Configure metafiles storage
-  */
+   * Configure metafiles storage
+   */
   metaStorageConfig?: AwsLightMetaStorageOptions;
   /**
-  * The parts size that the client should use for presigned multipart unloading.
-  * @default '16MB'
-  */
+   * The parts size that the client should use for presigned multipart unloading.
+   * @default '16MB'
+   */
   partSize?: number | string;
 };
 interface AwsLightError extends Error {
@@ -48,10 +49,10 @@ interface AwsLightError extends Error {
   statusCode?: number;
 }
 /**
-* AWS Light meta storage implementation using aws4fetch.
-* Stores metadata in S3 object metadata headers (x-amz-meta-*).
-* Optimized for worker environments (Cloudflare Workers, Web Workers, etc.).
-*/
+ * AWS Light meta storage implementation using aws4fetch.
+ * Stores metadata in S3 object metadata headers (x-amz-meta-*).
+ * Optimized for worker environments (Cloudflare Workers, Web Workers, etc.).
+ */
 declare class AwsLightMetaStorage<T extends File = File> extends MetaStorage<T> {
   config: AwsLightMetaStorageOptions;
   private readonly adapter;
@@ -63,8 +64,8 @@ declare class AwsLightMetaStorage<T extends File = File> extends MetaStorage<T>
   override save(id: string, file: T): Promise<T>;
 }
 /**
-* Adapter that uses aws4fetch to implement S3ApiOperations interface.
-*/
+ * Adapter that uses aws4fetch to implement S3ApiOperations interface.
+ */
 declare class AwsLightApiAdapter implements S3ApiOperations {
   aws: AwsClient;
   private readonly bucket;
@@ -185,67 +186,63 @@ declare class AwsLightApiAdapter implements S3ApiOperations {
     Bucket: string;
   }): Promise<void>;
   /**
-  * Builds S3 API URL.
-  */
+   * Builds S3 API URL.
+   */
   private buildUrl;
   /**
-  * Converts ReadableStream to Readable for Node.js compatibility.
-  */
+   * Converts ReadableStream to Readable for Node.js compatibility.
+   */
   private streamToReadable;
 }
 /**
-* AWS Light storage implementation using aws4fetch.
-* Optimized for worker environments (Cloudflare Workers, Web Workers, etc.).
-* @example
-* ```ts
-* const storage = new AwsLightStorage({
-*  bucket: <YOUR_BUCKET>,
-*  region: <YOUR_REGION>,
-*  accessKeyId: <YOUR_ACCESS_KEY_ID>,
-*  secretAccessKey: <YOUR_SECRET_ACCESS_KEY>
-* });
-* ```
-* @remarks
-* ## Worker Compatibility
-* - Uses aws4fetch for AWS request signing (works in workers)
-* - No Node.js-specific dependencies
-* - Compatible with Cloudflare Workers, Web Workers, and edge runtimes
-*
-* ## Error Handling
-* - S3 API errors are normalized with AWS-specific context
-* - Errors include S3 error codes and status codes for debugging
-*
-* ## Retry Behavior
-* - All S3 API calls are wrapped with configurable retry logic via `retryConfig` option
-* - Default retryable status codes: 408, 429, 500, 502, 503, 504
-* - Custom `shouldRetry` function can be provided for advanced retry logic
-*
-* ## Multipart Uploads
-* - Large files are automatically split into multipart uploads
-* - Maximum 10,000 parts per upload (S3 limitation)
-* - Part size is configurable (default: 16MB, minimum: 5MB)
-* - Failed multipart uploads are automatically aborted
-*
-* ## Supported Operations
-* - ✅ create, write, delete, get, getStream, list, update, copy, move
-* - ✅ Batch operations: deleteBatch, copyBatch, moveBatch (inherited from BaseStorage)
-* - ✅ exists: Implemented (checks metadata and S3 object)
-* - ⚠️ getUrl/getUploadUrl: Limited presigned URL support (uses aws4fetch signing)
-*/
+ * AWS Light storage implementation using aws4fetch.
+ * Optimized for worker environments (Cloudflare Workers, Web Workers, etc.).
+ * @example
+ * ```ts
+ * const storage = new AwsLightStorage({
+ *  bucket: <YOUR_BUCKET>,
+ *  region: <YOUR_REGION>,
+ *  accessKeyId: <YOUR_ACCESS_KEY_ID>,
+ *  secretAccessKey: <YOUR_SECRET_ACCESS_KEY>
+ * });
+ * ```
+ * @remarks
+ * ## Worker Compatibility
+ * - Uses aws4fetch for AWS request signing (works in workers)
+ * - No Node.js-specific dependencies
+ * - Compatible with Cloudflare Workers, Web Workers, and edge runtimes
+ *
+ * ## Error Handling
+ * - S3 API errors are normalized with AWS-specific context
+ * - Errors include S3 error codes and status codes for debugging
+ *
+ * ## Retry Behavior
+ * - All S3 API calls are wrapped with configurable retry logic via `retryConfig` option
+ * - Default retryable status codes: 408, 429, 500, 502, 503, 504
+ * - Custom `shouldRetry` function can be provided for advanced retry logic
+ *
+ * ## Multipart Uploads
+ * - Large files are automatically split into multipart uploads
+ * - Maximum 10,000 parts per upload (S3 limitation)
+ * - Part size is configurable (default: 16MB, minimum: 5MB)
+ * - Failed multipart uploads are automatically aborted
+ *
+ * ## Supported Operations
+ * - ✅ create, write, delete, get, getStream, list, update, copy, move
+ * - ✅ Batch operations: deleteBatch, copyBatch, moveBatch (inherited from BaseStorage)
+ * - ✅ exists: Implemented (checks metadata and S3 object)
+ * - ⚠️ getUrl/getUploadUrl: Limited presigned URL support (uses aws4fetch signing)
+ */
 declare class AwsLightStorage extends S3BaseStorage {
   static override readonly name: string;
   private s3Api;
   constructor(config: AwsLightStorageOptions);
   /**
-  * Normalizes AWS S3 errors with S3-specific context.
-  */
+   * Normalizes AWS S3 errors with S3-specific context.
+   */
   override normalizeError(error: AwsLightError | Error): HttpError;
-  override update({
-    id
-  }: FileQuery, metadata: Partial<AwsLightFile>): Promise<AwsLightFile>;
-  override getStream({
-    id
-  }: FileQuery, options?: OperationOptions): Promise<{
+  override update({ id }: FileQuery, metadata: Partial<AwsLightFile>): Promise<AwsLightFile>;
+  override getStream({ id }: FileQuery, options?: OperationOptions): Promise<{
     headers?: Record<string, string>;
     size?: number;
     stream: Readable;

package/dist/storage/aws-light/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/AwsLightFile-CpZrubaV.js";import{p as r}from"../../packem_shared/aws-light-meta-storage-DGrn72VJ.js";import{default as f}from"../../packem_shared/AwsLightStorage-BK-WPL0h.js";export{a as AwsLightFile,r as AwsLightMetaStorage,f as AwsLightStorage};
+import{default as a}from"../../packem_shared/AwsLightFile-CpZrubaV.js";import{p as r}from"../../packem_shared/aws-light-meta-storage-DGrn72VJ.js";import{default as f}from"../../packem_shared/AwsLightStorage-DGSPFUqr.js";export{a as AwsLightFile,r as AwsLightMetaStorage,f as AwsLightStorage};