@gigadrive/sdk 0.7.27 → 0.8.0

package/dist/index.js

@@ -43,6 +43,7 @@ __export(src_exports, {
   ApplicationStorageResource: () => ApplicationStorageResource,
   ApplicationsResource: () => ApplicationsResource,
   AuthenticationError: () => AuthenticationError,
+  ConfigurationError: () => ConfigurationError,
   DeploymentsResource: () => DeploymentsResource,
   GigadriveClient: () => GigadriveClient,
   GigadriveError: () => GigadriveError,
@@ -55,6 +56,7 @@ __export(src_exports, {
   StickySessionsResource: () => StickySessionsResource,
   StorageBucketsResource: () => StorageBucketsResource,
   StorageObjectsResource: () => StorageObjectsResource,
+  StorageTrashResource: () => StorageTrashResource,
   StorageUploadSessionsResource: () => StorageUploadSessionsResource,
   UploadError: () => UploadError,
   UploadSessionExpiredError: () => UploadSessionExpiredError,
@@ -77,6 +79,12 @@ var AuthenticationError = class extends GigadriveError {
     this.name = "AuthenticationError";
   }
 };
+var ConfigurationError = class extends GigadriveError {
+  constructor(message) {
+    super(message);
+    this.name = "ConfigurationError";
+  }
+};
 var ApiError = class extends GigadriveError {
   /** The HTTP status code of the failed response (e.g. 404, 500). */
   status;
@@ -1205,230 +1213,283 @@ var toUploadError = (error) => {
   throw new UploadError(error instanceof Error ? error.message : "The upload failed.", error);
 };
 
+// src/resources/storage-context.ts
+var resolveStorageApplicationId = (defaultApplicationId, explicitApplicationId) => {
+  const applicationId = explicitApplicationId ?? defaultApplicationId;
+  if (applicationId) return applicationId;
+  throw new ConfigurationError(
+    "No application context is configured. Pass an application ID to this call, set GigadriveClientConfig.applicationId, or run inside a Gigadrive deployment with GIGADRIVE_APPLICATION_ID."
+  );
+};
+var resolveStorageBucketReference = (input) => {
+  const hasBucket = typeof input.bucket === "string";
+  const hasBucketId = typeof input.bucketId === "string";
+  if (hasBucket === hasBucketId) {
+    throw new ConfigurationError(
+      "Provide exactly one storage bucket reference using `bucket` or deprecated `bucketId`."
+    );
+  }
+  return hasBucket ? input.bucket : input.bucketId;
+};
+var encodeStorageBucketReference = (bucketRef) => encodeURIComponent(bucketRef);
+
 // src/resources/storage-buckets.ts
 var StorageBucketsResource = class extends BaseResource {
-  /**
-   * List all storage buckets for an application.
-   *
-   * @param applicationId - The application ID (UUID).
-   * @param query - Optional pagination parameters.
-   * @returns A paginated list of storage buckets.
-   *
-   * @example
-   * ```ts
-   * const { items, total } = await client.applications.storage.buckets.list('app-id');
-   * console.log(`${total} buckets found`);
-   * ```
-   */
-  async list(applicationId, query) {
+  constructor(httpClient, defaultApplicationId) {
+    super(httpClient);
+    this.defaultApplicationId = defaultApplicationId;
+  }
+  defaultApplicationId;
+  async list(applicationIdOrQuery, legacyQuery) {
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      typeof applicationIdOrQuery === "string" ? applicationIdOrQuery : void 0
+    );
+    const query = typeof applicationIdOrQuery === "string" ? legacyQuery : applicationIdOrQuery;
     return this.httpClient.get(`/applications/${applicationId}/storage/buckets`, {
       query
     });
   }
-  /**
-   * Create a new storage bucket.
-   *
-   * @param applicationId - The application ID (UUID).
-   * @param data - Bucket name, environment, and optional slug/visibility.
-   * @returns The newly created bucket.
-   *
-   * @example
-   * ```ts
-   * const bucket = await client.applications.storage.buckets.create('app-id', {
-   *   name: 'Assets',
-   *   environmentId: 'env-id',
-   *   visibility: 'public',
-   * });
-   * console.log(`Bucket CDN: https://${bucket.cdnHostname}`);
-   * ```
-   */
-  async create(applicationId, data) {
+  async create(applicationIdOrData, legacyData) {
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      typeof applicationIdOrData === "string" ? applicationIdOrData : void 0
+    );
+    const data = typeof applicationIdOrData === "string" ? legacyData : applicationIdOrData;
     return this.httpClient.post(`/applications/${applicationId}/storage/buckets`, data);
   }
-  /**
-   * Get a storage bucket by ID.
-   *
-   * @param applicationId - The application ID (UUID).
-   * @param bucketId - The bucket ID (UUID).
-   * @returns The bucket details.
-   *
-   * @example
-   * ```ts
-   * const bucket = await client.applications.storage.buckets.get('app-id', 'bucket-id');
-   * console.log(`${bucket.name} (${bucket.visibility})`);
-   * ```
-   */
-  async get(applicationId, bucketId) {
-    return this.httpClient.get(`/applications/${applicationId}/storage/buckets/${bucketId}`);
+  async get(applicationIdOrBucketRef, bucketRefOrOptions, legacyOptions) {
+    const explicitApplication = typeof bucketRefOrOptions === "string";
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      explicitApplication ? applicationIdOrBucketRef : void 0
+    );
+    const bucketRef = explicitApplication ? bucketRefOrOptions : applicationIdOrBucketRef;
+    const options = explicitApplication ? legacyOptions : bucketRefOrOptions;
+    return this.httpClient.get(
+      `/applications/${applicationId}/storage/buckets/${encodeStorageBucketReference(bucketRef)}`,
+      {
+        query: { environment: options?.environment }
+      }
+    );
   }
-  /**
-   * Permanently delete a storage bucket and all its objects.
-   *
-   * @param applicationId - The application ID (UUID).
-   * @param bucketId - The bucket ID (UUID).
-   *
-   * @example
-   * ```ts
-   * await client.applications.storage.buckets.delete('app-id', 'bucket-id');
-   * ```
-   */
-  async delete(applicationId, bucketId) {
-    return this.httpClient.delete(`/applications/${applicationId}/storage/buckets/${bucketId}`);
+  async delete(applicationIdOrBucketRef, bucketRefOrOptions, legacyOptions) {
+    const explicitApplication = typeof bucketRefOrOptions === "string";
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      explicitApplication ? applicationIdOrBucketRef : void 0
+    );
+    const bucketRef = explicitApplication ? bucketRefOrOptions : applicationIdOrBucketRef;
+    const options = explicitApplication ? legacyOptions : bucketRefOrOptions;
+    return this.httpClient.delete(
+      `/applications/${applicationId}/storage/buckets/${encodeStorageBucketReference(bucketRef)}`,
+      { query: { environment: options?.environment } }
+    );
   }
 };
 
 // src/resources/storage-objects.ts
 var StorageObjectsResource = class extends BaseResource {
-  /**
-   * List objects in a storage bucket, optionally filtered by key prefix and
-   * grouped into virtual folders by a delimiter.
-   *
-   * @param applicationId - The application ID (UUID).
-   * @param bucketId - The bucket ID (UUID).
-   * @param query - Optional prefix/delimiter/cursor/limit parameters.
-   * @returns A page of objects plus any common (folder) prefixes and a `nextCursor`.
-   *
-   * @example
-   * ```ts
-   * // List the "images/" folder, one level deep
-   * const { items, commonPrefixes, nextCursor } = await client.applications.storage.objects.list(
-   *   'app-id', 'bucket-id', { prefix: 'images/', limit: 100 },
-   * );
-   * ```
-   */
-  async list(applicationId, bucketId, query) {
-    return this.httpClient.get(`/applications/${applicationId}/storage/buckets/${bucketId}/objects`, {
-      query
-    });
+  constructor(httpClient, defaultApplicationId) {
+    super(httpClient);
+    this.defaultApplicationId = defaultApplicationId;
+  }
+  defaultApplicationId;
+  async list(applicationIdOrBucketRef, bucketRefOrQuery, legacyQuery) {
+    const explicitApplication = typeof bucketRefOrQuery === "string";
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      explicitApplication ? applicationIdOrBucketRef : void 0
+    );
+    const bucketRef = explicitApplication ? bucketRefOrQuery : applicationIdOrBucketRef;
+    const query = explicitApplication ? legacyQuery : bucketRefOrQuery;
+    return this.httpClient.get(
+      `/applications/${applicationId}/storage/buckets/${encodeStorageBucketReference(bucketRef)}/objects`,
+      {
+        query
+      }
+    );
   }
-  /**
-   * Get metadata for a specific object by its object ID.
-   *
-   * @param applicationId - The application ID (UUID).
-   * @param bucketId - The bucket ID (UUID).
-   * @param objectId - The object ID (UUID) — not the object key. Use {@link getByKey} to resolve a key.
-   * @returns The object metadata.
-   *
-   * @example
-   * ```ts
-   * const obj = await client.applications.storage.objects.get('app-id', 'bucket-id', 'object-id');
-   * console.log(`${obj.key}: ${obj.contentLength} bytes, type: ${obj.contentType}`);
-   * ```
-   */
-  async get(applicationId, bucketId, objectId) {
-    return this.httpClient.get(`/applications/${applicationId}/storage/buckets/${bucketId}/objects/${objectId}`);
+  async get(applicationIdOrBucketRef, bucketRefOrObjectId, objectIdOrOptions, legacyOptions) {
+    const explicitApplication = typeof objectIdOrOptions === "string";
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      explicitApplication ? applicationIdOrBucketRef : void 0
+    );
+    const bucketRef = explicitApplication ? bucketRefOrObjectId : applicationIdOrBucketRef;
+    const objectId = explicitApplication ? objectIdOrOptions : bucketRefOrObjectId;
+    const options = explicitApplication ? legacyOptions : objectIdOrOptions;
+    return this.httpClient.get(
+      `/applications/${applicationId}/storage/buckets/${encodeStorageBucketReference(bucketRef)}/objects/${objectId}`,
+      { query: { environment: options?.environment } }
+    );
   }
-  /**
-   * Resolve an object by its key (path) instead of its ID. Convenience over
-   * {@link list} — lists with the key as the prefix and returns the exact match,
-   * paging through results until found, or `null` if no object with that key
-   * exists. (The API has no get-by-key endpoint.)
-   *
-   * @param applicationId - The application ID (UUID).
-   * @param bucketId - The bucket ID (UUID).
-   * @param key - The object key/path (e.g. `"images/photo.jpg"`).
-   * @returns The matching object, or `null` if not found.
-   */
-  async getByKey(applicationId, bucketId, key) {
+  async getByKey(applicationIdOrBucketRef, bucketRefOrKey, keyOrOptions, legacyOptions) {
+    const explicitApplication = typeof keyOrOptions === "string";
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      explicitApplication ? applicationIdOrBucketRef : void 0
+    );
+    const bucketRef = explicitApplication ? bucketRefOrKey : applicationIdOrBucketRef;
+    const key = explicitApplication ? keyOrOptions : bucketRefOrKey;
+    const options = explicitApplication ? legacyOptions : keyOrOptions;
     let cursor;
     do {
-      const page = await this.list(applicationId, bucketId, { prefix: key, delimiter: "", cursor });
+      const page = await this.list(applicationId, bucketRef, {
+        environment: options?.environment,
+        prefix: key,
+        cursor
+      });
       const match = page.items.find((object) => object.key === key);
       if (match) return match;
       cursor = page.nextCursor;
     } while (cursor);
     return null;
   }
-  /**
-   * Permanently delete an object from a storage bucket.
-   *
-   * @param applicationId - The application ID (UUID).
-   * @param bucketId - The bucket ID (UUID).
-   * @param objectId - The object ID (UUID) — not the object key.
-   *
-   * @example
-   * ```ts
-   * await client.applications.storage.objects.delete('app-id', 'bucket-id', 'object-id');
-   * ```
-   */
-  async delete(applicationId, bucketId, objectId) {
-    return this.httpClient.delete(`/applications/${applicationId}/storage/buckets/${bucketId}/objects/${objectId}`);
+  async delete(applicationIdOrBucketRef, bucketRefOrObjectId, objectIdOrOptions, legacyOptions) {
+    const explicitApplication = typeof objectIdOrOptions === "string";
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      explicitApplication ? applicationIdOrBucketRef : void 0
+    );
+    const bucketRef = explicitApplication ? bucketRefOrObjectId : applicationIdOrBucketRef;
+    const objectId = explicitApplication ? objectIdOrOptions : bucketRefOrObjectId;
+    const options = explicitApplication ? legacyOptions : objectIdOrOptions;
+    return this.httpClient.delete(
+      `/applications/${applicationId}/storage/buckets/${encodeStorageBucketReference(bucketRef)}/objects/${objectId}`,
+      { query: { environment: options?.environment } }
+    );
   }
-  /**
-   * Get an access URL for a storage object. For objects in public buckets,
-   * returns a stable CDN URL. For private buckets, returns a time-limited
-   * signed URL.
-   *
-   * @param applicationId - The application ID (UUID).
-   * @param bucketId - The bucket ID (UUID).
-   * @param objectId - The object ID (UUID) — not the object key.
-   * @param options - Optional `expiresInSeconds` for signed URLs (60–86400).
-   * @returns The access URL and its type/expiry.
-   *
-   * @example
-   * ```ts
-   * const access = await client.applications.storage.objects.getAccessUrl('app-id', 'bucket-id', 'object-id', {
-   *   expiresInSeconds: 3600,
-   * });
-   * if (access.accessType === 'signed') {
-   *   console.log(`Signed URL expires at ${access.expiresAt}`);
-   * }
-   * console.log(`Download: ${access.url}`);
-   * ```
-   */
-  async getAccessUrl(applicationId, bucketId, objectId, options) {
+  async getAccessUrl(applicationIdOrBucketRef, bucketRefOrObjectId, objectIdOrOptions, legacyOptions) {
+    const explicitApplication = typeof objectIdOrOptions === "string";
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      explicitApplication ? applicationIdOrBucketRef : void 0
+    );
+    const bucketRef = explicitApplication ? bucketRefOrObjectId : applicationIdOrBucketRef;
+    const objectId = explicitApplication ? objectIdOrOptions : bucketRefOrObjectId;
+    const options = explicitApplication ? legacyOptions : objectIdOrOptions;
     return this.httpClient.get(
-      `/applications/${applicationId}/storage/buckets/${bucketId}/objects/${objectId}/access-url`,
-      { query: { expiresInSeconds: options?.expiresInSeconds } }
+      `/applications/${applicationId}/storage/buckets/${encodeStorageBucketReference(bucketRef)}/objects/${objectId}/access-url`,
+      { query: { environment: options?.environment, expiresInSeconds: options?.expiresInSeconds } }
+    );
+  }
+};
+
+// src/resources/storage-trash.ts
+var StorageTrashResource = class extends BaseResource {
+  constructor(httpClient, defaultApplicationId) {
+    super(httpClient);
+    this.defaultApplicationId = defaultApplicationId;
+  }
+  defaultApplicationId;
+  async list(applicationIdOrBucketRef, bucketRefOrQuery, legacyQuery) {
+    const explicitApplication = typeof bucketRefOrQuery === "string";
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      explicitApplication ? applicationIdOrBucketRef : void 0
+    );
+    const bucketRef = explicitApplication ? bucketRefOrQuery : applicationIdOrBucketRef;
+    const query = explicitApplication ? legacyQuery : bucketRefOrQuery;
+    return this.httpClient.get(
+      `/applications/${applicationId}/storage/buckets/${encodeStorageBucketReference(bucketRef)}/trash`,
+      { query }
+    );
+  }
+  async restore(applicationIdOrBucketRef, bucketRefOrObjectId, objectIdOrOptions, legacyOptions) {
+    const explicitApplication = typeof objectIdOrOptions === "string";
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      explicitApplication ? applicationIdOrBucketRef : void 0
+    );
+    const bucketRef = explicitApplication ? bucketRefOrObjectId : applicationIdOrBucketRef;
+    const objectId = explicitApplication ? objectIdOrOptions : bucketRefOrObjectId;
+    const options = explicitApplication ? legacyOptions : objectIdOrOptions;
+    return this.httpClient.post(
+      `/applications/${applicationId}/storage/buckets/${encodeStorageBucketReference(bucketRef)}/trash/${objectId}/restore`,
+      void 0,
+      { query: { environment: options?.environment } }
+    );
+  }
+  async purge(applicationIdOrBucketRef, bucketRefOrObjectId, objectIdOrOptions, legacyOptions) {
+    const explicitApplication = typeof objectIdOrOptions === "string";
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      explicitApplication ? applicationIdOrBucketRef : void 0
+    );
+    const bucketRef = explicitApplication ? bucketRefOrObjectId : applicationIdOrBucketRef;
+    const objectId = explicitApplication ? objectIdOrOptions : bucketRefOrObjectId;
+    const options = explicitApplication ? legacyOptions : objectIdOrOptions;
+    return this.httpClient.delete(
+      `/applications/${applicationId}/storage/buckets/${encodeStorageBucketReference(bucketRef)}/trash/${objectId}`,
+      { query: { environment: options?.environment } }
+    );
+  }
+  async empty(applicationIdOrBucketRef, bucketRefOrOptions, legacyOptions) {
+    const explicitApplication = typeof bucketRefOrOptions === "string";
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      explicitApplication ? applicationIdOrBucketRef : void 0
+    );
+    const bucketRef = explicitApplication ? bucketRefOrOptions : applicationIdOrBucketRef;
+    const options = explicitApplication ? legacyOptions : bucketRefOrOptions;
+    return this.httpClient.delete(
+      `/applications/${applicationId}/storage/buckets/${encodeStorageBucketReference(bucketRef)}/trash`,
+      { query: { environment: options?.environment } }
     );
   }
 };
 
 // src/resources/storage-upload-sessions.ts
 var StorageUploadSessionsResource = class extends BaseResource {
-  constructor(httpClient, transport = tusUploadTransport) {
+  constructor(httpClient, transport = tusUploadTransport, defaultApplicationId) {
     super(httpClient);
     this.transport = transport;
+    this.defaultApplicationId = defaultApplicationId;
   }
   transport;
-  /**
-   * List upload sessions for a bucket.
-   *
-   * @param applicationId - The application ID (UUID).
-   * @param bucketId - The bucket ID (UUID).
-   * @param query - Optional pagination parameters.
-   * @returns A paginated list of upload sessions.
-   */
-  async list(applicationId, bucketId, query) {
-    return this.httpClient.get(`/applications/${applicationId}/storage/buckets/${bucketId}/uploads`, {
-      query
-    });
+  defaultApplicationId;
+  async list(applicationIdOrBucketRef, bucketRefOrQuery, legacyQuery) {
+    const explicitApplication = typeof bucketRefOrQuery === "string";
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      explicitApplication ? applicationIdOrBucketRef : void 0
+    );
+    const bucketRef = explicitApplication ? bucketRefOrQuery : applicationIdOrBucketRef;
+    const query = explicitApplication ? legacyQuery : bucketRefOrQuery;
+    return this.httpClient.get(
+      `/applications/${applicationId}/storage/buckets/${encodeStorageBucketReference(bucketRef)}/uploads`,
+      { query }
+    );
   }
-  /**
-   * Create an upload session. Returns the session metadata and a signed upload
-   * URL for sending file data. This is the low-level method — for most use
-   * cases prefer `client.applications.storage.upload()` which also computes the
-   * required SHA-256 checksum for you.
-   *
-   * @param applicationId - The application ID (UUID).
-   * @param bucketId - The bucket ID (UUID).
-   * @param data - Object key, content length, SHA-256 checksum, and optional content type / extra checksums.
-   * @returns The session and resumable upload instructions (URL, method, headers).
-   */
-  async create(applicationId, bucketId, data) {
-    return this.httpClient.post(`/applications/${applicationId}/storage/buckets/${bucketId}/uploads`, data);
+  async create(applicationIdOrBucketRef, bucketRefOrData, dataOrOptions, legacyOptions) {
+    const explicitApplication = typeof bucketRefOrData === "string";
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      explicitApplication ? applicationIdOrBucketRef : void 0
+    );
+    const bucketRef = explicitApplication ? bucketRefOrData : applicationIdOrBucketRef;
+    const data = explicitApplication ? dataOrOptions : bucketRefOrData;
+    const options = explicitApplication ? legacyOptions : dataOrOptions;
+    return this.httpClient.post(
+      `/applications/${applicationId}/storage/buckets/${encodeStorageBucketReference(bucketRef)}/uploads`,
+      data,
+      { query: { environment: options?.environment } }
+    );
   }
-  /**
-   * Get an upload session by ID. Use this to track server-side processing after
-   * an upload (poll until `state === 'completed'`).
-   *
-   * @param applicationId - The application ID (UUID).
-   * @param bucketId - The bucket ID (UUID).
-   * @param sessionId - The upload session ID (UUID).
-   * @returns The current session state.
-   */
-  async get(applicationId, bucketId, sessionId) {
-    return this.httpClient.get(`/applications/${applicationId}/storage/buckets/${bucketId}/uploads/${sessionId}`);
+  async get(applicationIdOrBucketRef, bucketRefOrSessionId, sessionIdOrOptions, legacyOptions) {
+    const explicitApplication = typeof sessionIdOrOptions === "string";
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      explicitApplication ? applicationIdOrBucketRef : void 0
+    );
+    const bucketRef = explicitApplication ? bucketRefOrSessionId : applicationIdOrBucketRef;
+    const sessionId = explicitApplication ? sessionIdOrOptions : bucketRefOrSessionId;
+    const options = explicitApplication ? legacyOptions : sessionIdOrOptions;
+    return this.httpClient.get(
+      `/applications/${applicationId}/storage/buckets/${encodeStorageBucketReference(bucketRef)}/uploads/${sessionId}`,
+      { query: { environment: options?.environment } }
+    );
   }
   /**
    * Upload bytes directly to a pre-existing signed upload URL — for example, a
@@ -1462,19 +1523,24 @@ var StorageUploadSessionsResource = class extends BaseResource {
 // src/resources/application-storage.ts
 var delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 var ApplicationStorageResource = class {
+  constructor(httpClient, transport = tusUploadTransport, defaultApplicationId) {
+    this.defaultApplicationId = defaultApplicationId;
+    this.transport = transport;
+    this.buckets = new StorageBucketsResource(httpClient, defaultApplicationId);
+    this.objects = new StorageObjectsResource(httpClient, defaultApplicationId);
+    this.uploadSessions = new StorageUploadSessionsResource(httpClient, transport, defaultApplicationId);
+    this.trash = new StorageTrashResource(httpClient, defaultApplicationId);
+  }
+  defaultApplicationId;
   /** Create, list, get, and delete storage buckets. */
   buckets;
   /** List, get, delete objects, and generate access URLs. */
   objects;
   /** Low-level upload sessions and direct-to-URL byte uploads. */
   uploadSessions;
+  /** Lists, restores, and permanently purges soft-deleted objects. */
+  trash;
   transport;
-  constructor(httpClient, transport = tusUploadTransport) {
-    this.transport = transport;
-    this.buckets = new StorageBucketsResource(httpClient);
-    this.objects = new StorageObjectsResource(httpClient);
-    this.uploadSessions = new StorageUploadSessionsResource(httpClient, transport);
-  }
   /**
    * Upload a file to a storage bucket. Handles the full flow: computes the
    * required SHA-256 checksum, creates an upload session, uploads the bytes with
@@ -1492,14 +1558,18 @@ var ApplicationStorageResource = class {
    *
    * @example
    * ```ts
-   * const { session, url, object } = await client.applications.storage.upload({
-   *   applicationId, bucketId, key: 'reports/q1.pdf', path: './q1.pdf',
+   * const { session, url, object } = await client.storage.upload({
+   *   bucket: 'reports', key: 'q1.pdf', path: './q1.pdf',
    *   waitForCompletion: true,
    * });
    * console.log(object?.contentLength, 'bytes available at', url);
    * ```
    */
   async upload(input) {
+    const applicationId = resolveStorageApplicationId(this.defaultApplicationId, input.applicationId);
+    const bucketRef = resolveStorageBucketReference(input);
+    const completionOptions = typeof input.waitForCompletion === "object" ? input.waitForCompletion : void 0;
+    const environment = input.environment ?? completionOptions?.environment;
     const resolved = await resolveUploadSource({
       key: input.key,
       data: input.data,
@@ -1511,14 +1581,19 @@ var ApplicationStorageResource = class {
       checksumSha1: input.checksumSha1,
       checksumMd5: input.checksumMd5
     });
-    const { session, upload } = await this.uploadSessions.create(input.applicationId, input.bucketId, {
-      key: input.key,
-      contentLength: resolved.size,
-      checksumSha256: resolved.checksums.sha256,
-      contentType: resolved.contentType,
-      checksumSha1: resolved.checksums.sha1,
-      checksumMd5: resolved.checksums.md5
-    });
+    const { session, upload } = await this.uploadSessions.create(
+      applicationId,
+      bucketRef,
+      {
+        key: input.key,
+        contentLength: resolved.size,
+        checksumSha256: resolved.checksums.sha256,
+        contentType: resolved.contentType,
+        checksumSha1: resolved.checksums.sha1,
+        checksumMd5: resolved.checksums.md5
+      },
+      { environment }
+    );
     await runResolvedUpload(
       this.transport,
       upload.url,
@@ -1535,9 +1610,12 @@ var ApplicationStorageResource = class {
       { "Tus-Resumable": "1.0.0", ...upload.headers }
     ).catch(toUploadError);
     if (input.waitForCompletion) {
-      const options = typeof input.waitForCompletion === "object" ? input.waitForCompletion : void 0;
-      const completed = await this.waitForCompletion(input.applicationId, input.bucketId, session.id, options);
-      const object = await this.objects.getByKey(input.applicationId, input.bucketId, input.key) ?? void 0;
+      const options = completionOptions ?? {};
+      const completed = await this.waitForCompletion(applicationId, bucketRef, session.id, {
+        ...options,
+        environment
+      });
+      const object = await this.objects.getByKey(applicationId, bucketRef, input.key, { environment }) ?? void 0;
       return { session: completed, url: upload.publicObjectUrl, object };
     }
     return { session, url: upload.publicObjectUrl };
@@ -1553,8 +1631,8 @@ var ApplicationStorageResource = class {
    *
    * @example
    * ```ts
-   * const results = await client.applications.storage.uploadBatch(
-   *   files.map((f) => ({ applicationId, bucketId, key: `uploads/${f.name}`, data: f })),
+   * const results = await client.storage.uploadBatch(
+   *   files.map((f) => ({ bucket: 'uploads', key: f.name, data: f })),
    *   { concurrency: 6, onProgress: (done, total) => console.log(`${done}/${total}`) },
    * );
    * const failed = results.filter((r) => r.error);
@@ -1581,22 +1659,22 @@ var ApplicationStorageResource = class {
     await Promise.all(Array.from({ length: Math.min(concurrency, inputs.length) }, () => worker()));
     return results;
   }
-  /**
-   * Poll an upload session until the object is finalized server-side.
-   *
-   * @param applicationId - The application ID (UUID).
-   * @param bucketId - The bucket ID (UUID).
-   * @param sessionId - The upload session ID (UUID).
-   * @param options - Timeout and polling interval.
-   * @returns The completed session.
-   * @throws {@link UploadError} if the session fails, expires, or the timeout elapses.
-   */
-  async waitForCompletion(applicationId, bucketId, sessionId, options) {
+  async waitForCompletion(applicationIdOrBucketRef, bucketRefOrSessionId, sessionIdOrOptions, legacyOptions) {
+    const explicitApplication = typeof sessionIdOrOptions === "string";
+    const applicationId = resolveStorageApplicationId(
+      this.defaultApplicationId,
+      explicitApplication ? applicationIdOrBucketRef : void 0
+    );
+    const bucketRef = explicitApplication ? bucketRefOrSessionId : applicationIdOrBucketRef;
+    const sessionId = explicitApplication ? sessionIdOrOptions : bucketRefOrSessionId;
+    const options = explicitApplication ? legacyOptions : sessionIdOrOptions;
     const timeoutMs = options?.timeoutMs ?? 6e4;
     const pollIntervalMs = options?.pollIntervalMs ?? 1e3;
     const deadline = Date.now() + timeoutMs;
     for (; ; ) {
-      const session = await this.uploadSessions.get(applicationId, bucketId, sessionId);
+      const session = await this.uploadSessions.get(applicationId, bucketRef, sessionId, {
+        environment: options?.environment
+      });
       if (session.state === "completed") return session;
       if (session.state === "failed" || session.state === "expired") {
         throw new UploadError(`Upload session ${session.state}.`);
@@ -1630,15 +1708,14 @@ var ApplicationsResource = class extends BaseResource {
    * @example
    * ```ts
    * // Upload a file
-   * const { url } = await client.applications.storage.upload({
-   *   applicationId: 'app-id',
-   *   bucketId: 'bucket-id',
+   * const { url } = await client.storage.upload({
+   *   bucket: 'assets',
    *   key: 'images/logo.png',
    *   data: fileData,
    * });
    *
    * // List objects in a bucket
-   * const { items } = await client.applications.storage.objects.list('app-id', 'bucket-id');
+   * const { items } = await client.storage.objects.list('assets');
    * ```
    */
   storage;
@@ -1651,10 +1728,10 @@ var ApplicationsResource = class extends BaseResource {
    * ```
    */
   requests;
-  constructor(...args) {
-    super(...args);
+  constructor(httpClient, defaultApplicationId) {
+    super(httpClient);
     this.envVars = new ApplicationEnvVarsResource(this.httpClient);
-    this.storage = new ApplicationStorageResource(this.httpClient);
+    this.storage = new ApplicationStorageResource(this.httpClient, void 0, defaultApplicationId);
     this.requests = new ApplicationRequestsResource(this.httpClient);
   }
   /**
@@ -2364,6 +2441,15 @@ var GigadriveClient = class {
   organizations;
   /** Application management (list, environment variables, storage). */
   applications;
+  /**
+   * Context-bound file storage operations.
+   *
+   * Deployed workloads receive their application context through
+   * `GIGADRIVE_APPLICATION_ID`; management clients can set
+   * {@link GigadriveClientConfig.applicationId}. This is the same resource as
+   * {@link applications}.storage.
+   */
+  storage;
   /** Deployment lifecycle (create, upload, status, logs). */
   deployments;
   /** AI Gateway — OpenAI-compatible chat completions and model listing. */
@@ -2376,12 +2462,14 @@ var GigadriveClient = class {
   imageOptimization;
   constructor(config = {}) {
     const baseUrl = config.baseUrl ?? readEnv("GIGADRIVE_API_BASE_URL") ?? DEFAULT_BASE_URL2;
+    const applicationId = config.applicationId ?? readEnv("GIGADRIVE_APPLICATION_ID");
     const fetchFn = config.fetch ?? globalThis.fetch.bind(globalThis);
     const credentialProvider = resolveCredentialProvider({ ...config, baseUrl, fetch: fetchFn });
     const tokenManager = new TokenManager(credentialProvider);
     const httpClient = new HttpClient(baseUrl, tokenManager, fetchFn);
     this.organizations = new OrganizationsResource(httpClient);
-    this.applications = new ApplicationsResource(httpClient);
+    this.applications = new ApplicationsResource(httpClient, applicationId);
+    this.storage = this.applications.storage;
     this.deployments = new DeploymentsResource(httpClient);
     this.aiGateway = new AiGatewayResource(httpClient);
     this.apiKeys = new ApiKeysResource(httpClient);
@@ -2416,6 +2504,7 @@ async function* paginate(fetchPage) {
   ApplicationStorageResource,
   ApplicationsResource,
   AuthenticationError,
+  ConfigurationError,
   DeploymentsResource,
   GigadriveClient,
   GigadriveError,
@@ -2428,6 +2517,7 @@ async function* paginate(fetchPage) {
   StickySessionsResource,
   StorageBucketsResource,
   StorageObjectsResource,
+  StorageTrashResource,
   StorageUploadSessionsResource,
   UploadError,
   UploadSessionExpiredError,