@visulima/storage 1.0.8 → 1.0.10

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

@@ -1,4 +1,4 @@
-import { F as File, k as MetaStorageOptions, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, H as HttpError, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-CEM1upWM.js";
+import { F as File, k as MetaStorageOptions, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, H as HttpError, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DIav_lF1.js";
 import 'node:stream';
 import { RetryConfig } from 'gaxios';
 import { GoogleAuthOptions, GoogleAuth } from 'google-auth-library';
@@ -25,31 +25,31 @@ interface ClientError extends Error {
 }
 interface GCStorageOptions extends BaseStorageOptions, Omit<GoogleAuthOptions, "authClient" | "projectId">, StorageSettings {
   /**
-  * Google Cloud Storage bucket
-  */
+   * Google Cloud Storage bucket
+   */
   bucket?: string;
   /**
-  * Force compatible client upload directly to GCS
-  */
+   * Force compatible client upload directly to GCS
+   */
   clientDirectUpload?: boolean;
   /**
-  * Configure metafiles storage
-  * @example
-  * ```ts
-  * Using local metafiles
-  * const storage = new GCStorage({
-  *   bucket: 'upload',
-  *   metaStorageConfig: { directory: '/tmp/upload-metafiles' }
-  * })
-  * ```
-  * Using a separate bucket for metafiles
-  * ```ts
-  * const storage = new GCStorage({
-  *   bucket: 'upload',
-  *   metaStorageConfig: { bucket: 'upload-metafiles' }
-  * })
-  * ```
-  */
+   * Configure metafiles storage
+   * @example
+   * ```ts
+   * Using local metafiles
+   * const storage = new GCStorage({
+   *   bucket: 'upload',
+   *   metaStorageConfig: { directory: '/tmp/upload-metafiles' }
+   * })
+   * ```
+   * Using a separate bucket for metafiles
+   * ```ts
+   * const storage = new GCStorage({
+   *   bucket: 'upload',
+   *   metaStorageConfig: { bucket: 'upload-metafiles' }
+   * })
+   * ```
+   */
   metaStorageConfig?: GCSMetaStorageOptions | LocalMetaStorageOptions;
 }
 interface GCSMetaStorageOptions extends MetaStorageOptions, Omit<GoogleAuthOptions, "authClient" | "projectId">, StorageSettings {
@@ -71,36 +71,36 @@ declare class GCSMetaStorage<T extends File = File> extends MetaStorage<T> {
   override touch(id: string, file: T): Promise<T>;
   private accessCheck;
   /**
-  * Returns metafile URL path for the given upload ID.
-  * @param id Upload ID to get metafile path for
-  * @returns Full URL path to the metafile in GCS
-  */
+   * Returns metafile URL path for the given upload ID.
+   * @param id Upload ID to get metafile path for
+   * @returns Full URL path to the metafile in GCS
+   */
   private getMetaPath;
   private makeRequest;
 }
 /**
-* Google cloud storage based backend.
-* @example
-* ```ts
-*  const storage = new GCStorage({
-*    bucket: <YOUR_BUCKET>,
-*    keyFile: <PATH_TO_KEY_FILE>,
-*    metaStorage: new MetaStorage(),
-*    clientDirectUpload: true,
-*    maxUploadSize: '15GB',
-*    allowMIME: ['video/*', 'image/*'],
-*    filename: file => file.originalName
-*  });
-* ```
-* @remarks
-* ## Supported Operations
-* - ✅ create, write, delete, get, list, update, copy, move
-* - ✅ Batch operations: deleteBatch, copyBatch, moveBatch (inherited from BaseStorage)
-* - ✅ exists: Implemented (checks metadata and GCS object)
-* - ❌ getStream: Not implemented (use get() for file retrieval)
-* - ❌ getUrl: Not implemented (GCS public URLs not supported)
-* - ❌ getUploadUrl: Not implemented (resumable upload URLs handled internally)
-*/
+ * Google cloud storage based backend.
+ * @example
+ * ```ts
+ *  const storage = new GCStorage({
+ *    bucket: <YOUR_BUCKET>,
+ *    keyFile: <PATH_TO_KEY_FILE>,
+ *    metaStorage: new MetaStorage(),
+ *    clientDirectUpload: true,
+ *    maxUploadSize: '15GB',
+ *    allowMIME: ['video/*', 'image/*'],
+ *    filename: file => file.originalName
+ *  });
+ * ```
+ * @remarks
+ * ## Supported Operations
+ * - ✅ create, write, delete, get, list, update, copy, move
+ * - ✅ Batch operations: deleteBatch, copyBatch, moveBatch (inherited from BaseStorage)
+ * - ✅ exists: Implemented (checks metadata and GCS object)
+ * - ❌ getStream: Not implemented (use get() for file retrieval)
+ * - ❌ getUrl: Not implemented (GCS public URLs not supported)
+ * - ❌ getUploadUrl: Not implemented (resumable upload URLs handled internally)
+ */
 declare class GCStorage extends BaseStorage<GCSFile> {
   static override readonly name: string;
   override checksumTypes: string[];
@@ -120,58 +120,52 @@ declare class GCStorage extends BaseStorage<GCSFile> {
   create(config: FileInit, options?: OperationOptions): Promise<GCSFile>;
   write(part: FilePart | FileQuery | GCSFile, options?: OperationOptions): Promise<GCSFile>;
   /**
-  * Deletes an upload and its metadata.
-  * @param query File query containing the file ID to delete.
-  * @param query.id File ID to delete.
-  * @returns Promise resolving to the deleted file object with status: "deleted".
-  * @throws {UploadError} If the file metadata cannot be found.
-  */
-  delete({
-    id
-  }: FileQuery, options?: OperationOptions): Promise<GCSFile>;
+   * Deletes an upload and its metadata.
+   * @param query File query containing the file ID to delete.
+   * @param query.id File ID to delete.
+   * @returns Promise resolving to the deleted file object with status: "deleted".
+   * @throws {UploadError} If the file metadata cannot be found.
+   */
+  delete({ id }: FileQuery, options?: OperationOptions): Promise<GCSFile>;
   /**
-  * Copies an upload file to a new location.
-  * @param name Source file name/ID.
-  * @param destination Destination file name/ID.
-  * @returns Promise resolving to the copied file object.
-  * @throws {UploadError} If the source file cannot be found.
-  */
+   * Copies an upload file to a new location.
+   * @param name Source file name/ID.
+   * @param destination Destination file name/ID.
+   * @returns Promise resolving to the copied file object.
+   * @throws {UploadError} If the source file cannot be found.
+   */
   copy(name: string, destination: string, options?: OperationOptions & {
     storageClass?: string;
   }): Promise<GCSFile>;
   /**
-  * Moves an upload file to a new location.
-  * @param name Source file name/ID.
-  * @param destination Destination file name/ID.
-  * @returns Promise resolving to the moved file object.
-  * @throws {UploadError} If the source file cannot be found.
-  */
+   * Moves an upload file to a new location.
+   * @param name Source file name/ID.
+   * @param destination Destination file name/ID.
+   * @returns Promise resolving to the moved file object.
+   * @throws {UploadError} If the source file cannot be found.
+   */
   move(name: string, destination: string, options?: OperationOptions): Promise<GCSFile>;
   /**
-  * Gets an uploaded file by ID with content buffer.
-  * @param query File query object containing the file ID.
-  * @param query.id Unique identifier of the file to retrieve.
-  * @returns Promise resolving to file object with content buffer.
-  * @throws {UploadError} If the file cannot be found (ERRORS.FILE_NOT_FOUND) or has expired (ERRORS.GONE).
-  */
-  get({
-    id
-  }: FileQuery, options?: OperationOptions): Promise<FileReturn>;
+   * Gets an uploaded file by ID with content buffer.
+   * @param query File query object containing the file ID.
+   * @param query.id Unique identifier of the file to retrieve.
+   * @returns Promise resolving to file object with content buffer.
+   * @throws {UploadError} If the file cannot be found (ERRORS.FILE_NOT_FOUND) or has expired (ERRORS.GONE).
+   */
+  get({ id }: FileQuery, options?: OperationOptions): Promise<FileReturn>;
   /**
-  * Checks if a file exists by verifying both metadata and the actual GCS object.
-  * Returns true only if both the metadata and the GCS object exist.
-  * @param query File query containing the file ID to check.
-  * @returns Promise resolving to true if both metadata and GCS object exist, false otherwise.
-  */
-  override exists({
-    id
-  }: FileQuery, options?: OperationOptions): Promise<boolean>;
+   * Checks if a file exists by verifying both metadata and the actual GCS object.
+   * Returns true only if both the metadata and the GCS object exist.
+   * @param query File query containing the file ID to check.
+   * @returns Promise resolving to true if both metadata and GCS object exist, false otherwise.
+   */
+  override exists({ id }: FileQuery, options?: OperationOptions): Promise<boolean>;
   override list(limit?: number, options?: OperationOptions): Promise<GCSFile[]>;
   /**
-  * Directory-style listing via the GCS JSON API's native `delimiter`/`prefix` — the API returns
-  * the direct child objects in `items` and the common prefixes ("subdirectories") in `prefixes`,
-  * so the subtree is never fully walked. Pages until exhausted or `limit` files are collected.
-  */
+   * Directory-style listing via the GCS JSON API's native `delimiter`/`prefix` — the API returns
+   * the direct child objects in `items` and the common prefixes ("subdirectories") in `prefixes`,
+   * so the subtree is never fully walked. Pages until exhausted or `limit` files are collected.
+   */
   override listDirectory(options?: OperationOptions & {
     delimiter: string;
     limit?: number;
@@ -183,11 +177,11 @@ declare class GCStorage extends BaseStorage<GCSFile> {
   protected internalWrite(part: GCSFile & Partial<FilePart>, callOptions?: OperationOptions): Promise<number>;
   private internalOnComplete;
   /**
-  * Merge a body-level abort signal with the caller's per-operation
-  * `options.signal` so gaxios cancels the in-flight request on either.
-  * `options.timeout` is handed to gaxios' native `timeout` instead of a
-  * second `AbortSignal.timeout` to avoid two competing deadlines.
-  */
+   * Merge a body-level abort signal with the caller's per-operation
+   * `options.signal` so gaxios cancels the in-flight request on either.
+   * `options.timeout` is handed to gaxios' native `timeout` instead of a
+   * second `AbortSignal.timeout` to avoid two competing deadlines.
+   */
   private static buildCallSignal;
   private makeRequest;
   private accessCheck;

package/dist/storage/gcs/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/GCSConfig-BQ0OpVhe.js";import{default as t}from"../../packem_shared/GCSFile-Cero7qZN.js";import{v as C}from"../../packem_shared/gcs-meta-storage-DpkPEXso.js";import{default as l}from"../../packem_shared/GCStorage-DE-XFSBe.js";export{a as GCSConfig,t as GCSFile,C as GCSMetaStorage,l as GCStorage};
+import{default as a}from"../../packem_shared/GCSConfig-BQ0OpVhe.js";import{default as t}from"../../packem_shared/GCSFile-Cero7qZN.js";import{v as C}from"../../packem_shared/gcs-meta-storage-DQGu_cHq.js";import{default as l}from"../../packem_shared/GCStorage-ChqEpgqR.js";export{a as GCSConfig,t as GCSFile,C as GCSMetaStorage,l as GCStorage};

package/dist/storage/google-drive/index.d.ts

@@ -1,6 +1,6 @@
-import { F as File, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-CEM1upWM.js";
+import { F as File, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DIav_lF1.js";
 import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-D9PBfkn6.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-DuTEzyii.js";
 import { drive_v3 } from '@googleapis/drive';
 import 'node:crypto';
 import 'node:http';
@@ -15,98 +15,98 @@ declare class GoogleDriveMetaStorage extends LocalMetaStorage<GoogleDriveFile> {
 }
 interface GoogleDriveStorageOptions extends BaseStorageOptions {
   /**
-  * Pre-built `@googleapis/drive` v3 client. Escape hatch for callers that
-  * have already wired auth (workload identity, ADC, etc.). When set, the
-  * adapter uses it directly and `getUploadUrl()` will throw because there's
-  * no stable way to recover the underlying auth handle.
-  */
+   * Pre-built `@googleapis/drive` v3 client. Escape hatch for callers that
+   * have already wired auth (workload identity, ADC, etc.). When set, the
+   * adapter uses it directly and `getUploadUrl()` will throw because there's
+   * no stable way to recover the underlying auth handle.
+   */
   client?: drive_v3.Drive;
   /**
-  * Inline service-account credentials. Mints a `JWT` auth client with
-  * `https://www.googleapis.com/auth/drive` scope. Mutually exclusive with
-  * the other auth shapes.
-  */
+   * Inline service-account credentials. Mints a `JWT` auth client with
+   * `https://www.googleapis.com/auth/drive` scope. Mutually exclusive with
+   * the other auth shapes.
+   */
   credentials?: {
     client_email: string;
     private_key: string;
   };
   /**
-  * Shared Drive id. **Strongly recommended for service-account auth** —
-  * service accounts have a 15 GB personal quota; production workloads
-  * should target a Shared Drive with the service account added as a member.
-  */
+   * Shared Drive id. **Strongly recommended for service-account auth** —
+   * service accounts have a 15 GB personal quota; production workloads
+   * should target a Shared Drive with the service account added as a member.
+   */
   driveId?: string;
   /**
-  * LRU capacity for the in-memory virtual-key → fileId cache. Drive has
-  * no native key field; every read after the first round-trips a
-  * `files.list` to resolve the id, which the cache amortizes. Defaults to
-  * 1024.
-  */
+   * LRU capacity for the in-memory virtual-key → fileId cache. Drive has
+   * no native key field; every read after the first round-trips a
+   * `files.list` to resolve the id, which the cache amortizes. Defaults to
+   * 1024.
+   */
   fileIdCacheSize?: number;
   /**
-  * Path to a service-account JSON file. Mutually exclusive with the other
-  * auth shapes.
-  */
+   * Path to a service-account JSON file. Mutually exclusive with the other
+   * auth shapes.
+   */
   keyFilename?: string;
   /**
-  * Configure metafiles storage. Defaults to local tmp directory.
-  */
+   * Configure metafiles storage. Defaults to local tmp directory.
+   */
   metaStorageConfig?: LocalMetaStorageOptions;
   /**
-  * OAuth refresh token (3-legged OAuth, end-user Drive). The adapter mints
-  * fresh access tokens against `clientId`/`clientSecret`. Mutually
-  * exclusive with the other auth shapes.
-  */
+   * OAuth refresh token (3-legged OAuth, end-user Drive). The adapter mints
+   * fresh access tokens against `clientId`/`clientSecret`. Mutually
+   * exclusive with the other auth shapes.
+   */
   oauth?: {
     clientId: string;
     clientSecret: string;
     refreshToken: string;
   };
   /**
-  * When `true`, `write()` also creates an "anyone with link, reader"
-  * permission and `getReadUrl()` returns the Drive public download URL.
-  * When `false` (default), `getReadUrl()` throws — Drive has no signed-URL
-  * primitive.
-  */
+   * When `true`, `write()` also creates an "anyone with link, reader"
+   * permission and `getReadUrl()` returns the Drive public download URL.
+   * When `false` (default), `getReadUrl()` throws — Drive has no signed-URL
+   * primitive.
+   */
   publicByDefault?: boolean;
   /**
-  * Logical "bucket root" — virtual keys live under this folder. Defaults
-  * to `"root"` (My Drive root) or, when `driveId` is set, the Shared
-  * Drive root id should be used here.
-  */
+   * Logical "bucket root" — virtual keys live under this folder. Defaults
+   * to `"root"` (My Drive root) or, when `driveId` is set, the Shared
+   * Drive root id should be used here.
+   */
   rootFolderId?: string;
   /**
-  * Domain-wide delegation subject (the user to impersonate). Only honored
-  * with `credentials` or `keyFilename`.
-  */
+   * Domain-wide delegation subject (the user to impersonate). Only honored
+   * with `credentials` or `keyFilename`.
+   */
   subject?: string;
 }
 /**
-* Google Drive storage backend.
-*
-* Drive is **not** a key-value store — it organizes files by `fileId`, and a
-* single virtual key (e.g. `"docs/report.pdf"`) can map to multiple Drive
-* files. The adapter routes by `appProperties.fsdkKey`, which it sets on
-* every upload and resolves via `files.list` on every read. An LRU cache
-* amortizes the resolve cost.
-*
-* **Auth precedence**:
-* 1. `client` (pre-built `drive_v3.Drive`)
-* 2. `credentials` (inline service account)
-* 3. `keyFilename` (service-account JSON path)
-* 4. `oauth` (refresh token + clientId/clientSecret)
-* 5. Env fallback: `GOOGLE_DRIVE_CLIENT_EMAIL` + `GOOGLE_DRIVE_PRIVATE_KEY`, or
-*    `GOOGLE_DRIVE_KEY_FILE` (optional: `GOOGLE_DRIVE_SUBJECT` for DWD).
-*
-* **Limitations**:
-* - `getReadUrl()` only works with `publicByDefault: true` — Drive has no
-*   signed-URL primitive.
-* - `responseContentDisposition` is not supported.
-* - `getUploadUrl()` requires explicit `credentials`/`keyFilename`/`oauth`
-*   (not a pre-built `client`) so we can mint access tokens for the
-*   resumable session.
-* - ⚠️ Per-operation `signal`/`timeout` are best-effort: the underlying SDK does not support request cancellation, so an in-flight call may complete server-side even after abort. `retries` is honored.
-*/
+ * Google Drive storage backend.
+ *
+ * Drive is **not** a key-value store — it organizes files by `fileId`, and a
+ * single virtual key (e.g. `"docs/report.pdf"`) can map to multiple Drive
+ * files. The adapter routes by `appProperties.fsdkKey`, which it sets on
+ * every upload and resolves via `files.list` on every read. An LRU cache
+ * amortizes the resolve cost.
+ *
+ * **Auth precedence**:
+ * 1. `client` (pre-built `drive_v3.Drive`)
+ * 2. `credentials` (inline service account)
+ * 3. `keyFilename` (service-account JSON path)
+ * 4. `oauth` (refresh token + clientId/clientSecret)
+ * 5. Env fallback: `GOOGLE_DRIVE_CLIENT_EMAIL` + `GOOGLE_DRIVE_PRIVATE_KEY`, or
+ *    `GOOGLE_DRIVE_KEY_FILE` (optional: `GOOGLE_DRIVE_SUBJECT` for DWD).
+ *
+ * **Limitations**:
+ * - `getReadUrl()` only works with `publicByDefault: true` — Drive has no
+ *   signed-URL primitive.
+ * - `responseContentDisposition` is not supported.
+ * - `getUploadUrl()` requires explicit `credentials`/`keyFilename`/`oauth`
+ *   (not a pre-built `client`) so we can mint access tokens for the
+ *   resumable session.
+ * - ⚠️ Per-operation `signal`/`timeout` are best-effort: the underlying SDK does not support request cancellation, so an in-flight call may complete server-side even after abort. `retries` is honored.
+ */
 declare class GoogleDriveStorage extends BaseStorage<GoogleDriveFile> {
   static override readonly name: string;
   override checksumTypes: string[];
@@ -121,12 +121,8 @@ declare class GoogleDriveStorage extends BaseStorage<GoogleDriveFile> {
   override get raw(): drive_v3.Drive;
   create(config: FileInit, _options?: OperationOptions): Promise<GoogleDriveFile>;
   write(part: FilePart | FileQuery | GoogleDriveFile, options?: OperationOptions): Promise<GoogleDriveFile>;
-  delete({
-    id
-  }: FileQuery, options?: OperationOptions): Promise<GoogleDriveFile>;
-  get({
-    id
-  }: FileQuery, options?: OperationOptions): Promise<FileReturn>;
+  delete({ id }: FileQuery, options?: OperationOptions): Promise<GoogleDriveFile>;
+  get({ id }: FileQuery, options?: OperationOptions): Promise<FileReturn>;
   copy(name: string, destination: string, options?: OperationOptions & {
     storageClass?: string;
   }): Promise<GoogleDriveFile>;

package/dist/storage/google-drive/index.js

@@ -1 +1 @@
-import{default as r}from"../../packem_shared/GoogleDriveFile-DHpLhzg9.js";import{default as t}from"../../packem_shared/GoogleDriveMetaStorage-Cbwa1CHV.js";import{default as f}from"../../packem_shared/GoogleDriveStorage-Bklsz7Bh.js";export{r as GoogleDriveFile,t as GoogleDriveMetaStorage,f as GoogleDriveStorage};
+import{default as r}from"../../packem_shared/GoogleDriveFile-DHpLhzg9.js";import{default as t}from"../../packem_shared/GoogleDriveMetaStorage-xlHfKwmR.js";import{default as f}from"../../packem_shared/GoogleDriveStorage-v1glykjd.js";export{r as GoogleDriveFile,t as GoogleDriveMetaStorage,f as GoogleDriveStorage};

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

@@ -1,6 +1,6 @@
-export { D as DiskStorage, a as DiskStorageWithChecksum } from "../../packem_shared/disk-storage-with-checksum.d-B-VGEsfl.js";
-export { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-D9PBfkn6.js";
-export type { L as LocalMetaStorageOptions } from "../../packem_shared/storage.d-CEM1upWM.js";
+export { D as DiskStorage, a as DiskStorageWithChecksum } from "../../packem_shared/disk-storage-with-checksum.d-CQucFacO.js";
+export { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-DuTEzyii.js";
+export type { L as LocalMetaStorageOptions } from "../../packem_shared/storage.d-DIav_lF1.js";
 import 'node:stream';
 import 'node:crypto';
 import 'node:http';

package/dist/storage/local/index.js

@@ -1 +1 @@
-import{F as e}from"../../packem_shared/disk-storage-CsQcYW3s.js";import{default as t}from"../../packem_shared/DiskStorageWithChecksum-vFCubS6K.js";import{y as f}from"../../packem_shared/local-meta-storage-iuJnu90B.js";export{e as DiskStorage,t as DiskStorageWithChecksum,f as LocalMetaStorage};
+import{F as e}from"../../packem_shared/disk-storage-BwPk2IRa.js";import{default as t}from"../../packem_shared/DiskStorageWithChecksum-UnCtyEvs.js";import{y as f}from"../../packem_shared/local-meta-storage-DJDcuxf1.js";export{e as DiskStorage,t as DiskStorageWithChecksum,f as LocalMetaStorage};

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

@@ -1,6 +1,6 @@
-export { M as MemoryMetaStorage, a as MemoryStorage, type b as MemoryStorageOptions, a as default } from "../../packem_shared/memory-storage.d-4EU1cMt1.js";
+export { M as MemoryMetaStorage, a as MemoryStorage, type b as MemoryStorageOptions, a as default } from "../../packem_shared/memory-storage.d-BRdTiY8y.js";
 import 'node:stream';
-import "../../packem_shared/storage.d-CEM1upWM.js";
+import "../../packem_shared/storage.d-DIav_lF1.js";
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';