@usehercules/sdk 1.13.0 → 1.14.0

package/resources/files.d.mts

@@ -0,0 +1,133 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { CursorIDPage, type CursorIDPageParams, PagePromise } from "../core/pagination.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+/**
+ * Upload, retrieve, and list files and media associated with a website.
+ * Upload is a two-step process: first create an upload to get a presigned URL,
+ * then complete the upload after putting the file content to the presigned URL.
+ */
+export declare class Files extends APIResource {
+    /**
+     * Retrieves a paginated list of files uploaded to the website. Supports filtering
+     * by MIME type, folder path, creation date, and filename search.
+     */
+    list(query?: FileListParams | null | undefined, options?: RequestOptions): PagePromise<FilesCursorIDPage, File>;
+    /**
+     * Retrieves a file by its ID, including its CDN URL and metadata.
+     */
+    get(fileID: string, options?: RequestOptions): APIPromise<File>;
+}
+export type FilesCursorIDPage = CursorIDPage<File>;
+/**
+ * A file uploaded to CDN storage, linked to a website.
+ */
+export interface File {
+    /**
+     * Unique identifier for the file
+     */
+    id: string;
+    /**
+     * Timestamp when the file was created
+     */
+    created: string;
+    /**
+     * Original filename
+     */
+    filename: string;
+    /**
+     * MIME type (e.g., 'image/jpeg', 'application/pdf')
+     */
+    mime_type: string;
+    /**
+     * File size in bytes
+     */
+    size: number;
+    /**
+     * Timestamp when the file was last updated
+     */
+    updated: string;
+    /**
+     * Public CDN URL to access the file
+     */
+    url: string;
+    /**
+     * SHA256 hash of the file content
+     */
+    content_hash?: string | null;
+    /**
+     * Additional file metadata
+     */
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Folder path within the website (e.g., '/images/blog')
+     */
+    path?: string | null;
+}
+/**
+ * Response containing a presigned upload URL. PUT the file content to upload_url
+ * with the provided headers, then call complete to finalize.
+ */
+export interface Upload {
+    /**
+     * File ID to use when completing the upload
+     */
+    id: string;
+    /**
+     * Headers to include with the PUT request
+     */
+    upload_headers: {
+        [key: string]: string;
+    };
+    /**
+     * Presigned URL to PUT the file content to
+     */
+    upload_url: string;
+}
+export interface FileListParams extends CursorIDPageParams {
+    /**
+     * Filter by creation date
+     */
+    created?: FileListParams.Created;
+    /**
+     * Filter by MIME type (supports wildcards like 'image/\*')
+     */
+    mime_type?: string;
+    /**
+     * Filter by folder path
+     */
+    path?: string;
+    /**
+     * Search in filename
+     */
+    query?: string;
+}
+export declare namespace FileListParams {
+    /**
+     * Filter by creation date
+     */
+    interface Created {
+        /**
+         * Greater than (Unix timestamp in seconds)
+         */
+        gt?: number;
+        /**
+         * Greater than or equal (Unix timestamp in seconds)
+         */
+        gte?: number;
+        /**
+         * Less than (Unix timestamp in seconds)
+         */
+        lt?: number;
+        /**
+         * Less than or equal (Unix timestamp in seconds)
+         */
+        lte?: number;
+    }
+}
+export declare namespace Files {
+    export { type File as File, type Upload as Upload, type FilesCursorIDPage as FilesCursorIDPage, type FileListParams as FileListParams, };
+}
+//# sourceMappingURL=files.d.mts.map

package/resources/files.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.mts","sourceRoot":"","sources":["../src/resources/files.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE;OACtD,EAAE,cAAc,EAAE;AAGzB;;;;GAIG;AACH,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;OAGG;IACH,IAAI,CACF,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,iBAAiB,EAAE,IAAI,CAAC;IAIvC;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAGhE;AAED,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAE7C;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,cAAc,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAE1C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC;IAEjC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yBAAiB,cAAc,CAAC;IAC9B;;OAEG;IACH,UAAiB,OAAO;QACtB;;WAEG;QACH,EAAE,CAAC,EAAE,MAAM,CAAC;QAEZ;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,EAAE,CAAC,EAAE,MAAM,CAAC;QAEZ;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;KACd;CACF;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,IAAI,IAAI,IAAI,EACjB,KAAK,MAAM,IAAI,MAAM,EACrB,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}

package/resources/files.d.ts

@@ -0,0 +1,133 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { CursorIDPage, type CursorIDPageParams, PagePromise } from "../core/pagination.js";
+import { RequestOptions } from "../internal/request-options.js";
+/**
+ * Upload, retrieve, and list files and media associated with a website.
+ * Upload is a two-step process: first create an upload to get a presigned URL,
+ * then complete the upload after putting the file content to the presigned URL.
+ */
+export declare class Files extends APIResource {
+    /**
+     * Retrieves a paginated list of files uploaded to the website. Supports filtering
+     * by MIME type, folder path, creation date, and filename search.
+     */
+    list(query?: FileListParams | null | undefined, options?: RequestOptions): PagePromise<FilesCursorIDPage, File>;
+    /**
+     * Retrieves a file by its ID, including its CDN URL and metadata.
+     */
+    get(fileID: string, options?: RequestOptions): APIPromise<File>;
+}
+export type FilesCursorIDPage = CursorIDPage<File>;
+/**
+ * A file uploaded to CDN storage, linked to a website.
+ */
+export interface File {
+    /**
+     * Unique identifier for the file
+     */
+    id: string;
+    /**
+     * Timestamp when the file was created
+     */
+    created: string;
+    /**
+     * Original filename
+     */
+    filename: string;
+    /**
+     * MIME type (e.g., 'image/jpeg', 'application/pdf')
+     */
+    mime_type: string;
+    /**
+     * File size in bytes
+     */
+    size: number;
+    /**
+     * Timestamp when the file was last updated
+     */
+    updated: string;
+    /**
+     * Public CDN URL to access the file
+     */
+    url: string;
+    /**
+     * SHA256 hash of the file content
+     */
+    content_hash?: string | null;
+    /**
+     * Additional file metadata
+     */
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Folder path within the website (e.g., '/images/blog')
+     */
+    path?: string | null;
+}
+/**
+ * Response containing a presigned upload URL. PUT the file content to upload_url
+ * with the provided headers, then call complete to finalize.
+ */
+export interface Upload {
+    /**
+     * File ID to use when completing the upload
+     */
+    id: string;
+    /**
+     * Headers to include with the PUT request
+     */
+    upload_headers: {
+        [key: string]: string;
+    };
+    /**
+     * Presigned URL to PUT the file content to
+     */
+    upload_url: string;
+}
+export interface FileListParams extends CursorIDPageParams {
+    /**
+     * Filter by creation date
+     */
+    created?: FileListParams.Created;
+    /**
+     * Filter by MIME type (supports wildcards like 'image/\*')
+     */
+    mime_type?: string;
+    /**
+     * Filter by folder path
+     */
+    path?: string;
+    /**
+     * Search in filename
+     */
+    query?: string;
+}
+export declare namespace FileListParams {
+    /**
+     * Filter by creation date
+     */
+    interface Created {
+        /**
+         * Greater than (Unix timestamp in seconds)
+         */
+        gt?: number;
+        /**
+         * Greater than or equal (Unix timestamp in seconds)
+         */
+        gte?: number;
+        /**
+         * Less than (Unix timestamp in seconds)
+         */
+        lt?: number;
+        /**
+         * Less than or equal (Unix timestamp in seconds)
+         */
+        lte?: number;
+    }
+}
+export declare namespace Files {
+    export { type File as File, type Upload as Upload, type FilesCursorIDPage as FilesCursorIDPage, type FileListParams as FileListParams, };
+}
+//# sourceMappingURL=files.d.ts.map

package/resources/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/resources/files.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE;OACtD,EAAE,cAAc,EAAE;AAGzB;;;;GAIG;AACH,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;OAGG;IACH,IAAI,CACF,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,iBAAiB,EAAE,IAAI,CAAC;IAIvC;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAGhE;AAED,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAE7C;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,cAAc,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAE1C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC;IAEjC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yBAAiB,cAAc,CAAC;IAC9B;;OAEG;IACH,UAAiB,OAAO;QACtB;;WAEG;QACH,EAAE,CAAC,EAAE,MAAM,CAAC;QAEZ;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,EAAE,CAAC,EAAE,MAAM,CAAC;QAEZ;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;KACd;CACF;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,IAAI,IAAI,IAAI,EACjB,KAAK,MAAM,IAAI,MAAM,EACrB,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}

package/resources/files.js

@@ -0,0 +1,29 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Files = void 0;
+const resource_1 = require("../core/resource.js");
+const pagination_1 = require("../core/pagination.js");
+const path_1 = require("../internal/utils/path.js");
+/**
+ * Upload, retrieve, and list files and media associated with a website.
+ * Upload is a two-step process: first create an upload to get a presigned URL,
+ * then complete the upload after putting the file content to the presigned URL.
+ */
+class Files extends resource_1.APIResource {
+    /**
+     * Retrieves a paginated list of files uploaded to the website. Supports filtering
+     * by MIME type, folder path, creation date, and filename search.
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/files', (pagination_1.CursorIDPage), { query, ...options });
+    }
+    /**
+     * Retrieves a file by its ID, including its CDN URL and metadata.
+     */
+    get(fileID, options) {
+        return this._client.get((0, path_1.path) `/v1/files/${fileID}`, options);
+    }
+}
+exports.Files = Files;
+//# sourceMappingURL=files.js.map

package/resources/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../src/resources/files.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,sDAAwF;AAExF,oDAA8C;AAE9C;;;;GAIG;AACH,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;OAGG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA,yBAAkB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,MAAc,EAAE,OAAwB;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;CACF;AAlBD,sBAkBC"}

package/resources/files.mjs

@@ -0,0 +1,25 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { CursorIDPage } from "../core/pagination.mjs";
+import { path } from "../internal/utils/path.mjs";
+/**
+ * Upload, retrieve, and list files and media associated with a website.
+ * Upload is a two-step process: first create an upload to get a presigned URL,
+ * then complete the upload after putting the file content to the presigned URL.
+ */
+export class Files extends APIResource {
+    /**
+     * Retrieves a paginated list of files uploaded to the website. Supports filtering
+     * by MIME type, folder path, creation date, and filename search.
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/files', (CursorIDPage), { query, ...options });
+    }
+    /**
+     * Retrieves a file by its ID, including its CDN URL and metadata.
+     */
+    get(fileID, options) {
+        return this._client.get(path `/v1/files/${fileID}`, options);
+    }
+}
+//# sourceMappingURL=files.mjs.map

package/resources/files.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.mjs","sourceRoot":"","sources":["../src/resources/files.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,YAAY,EAAwC;OAEtD,EAAE,IAAI,EAAE;AAEf;;;;GAIG;AACH,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;OAGG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA,YAAkB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,MAAc,EAAE,OAAwB;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/resources/index.d.mts

@@ -1,4 +1,5 @@
-export { Commerce, type CommerceCancelResponse, type CommerceCheckResponse, type CommerceCheckoutResponse, type CommerceCancelParams, type CommerceCheckParams, type CommerceCheckoutParams, } from "./commerce/commerce.mjs";
+export { Commerce, type Currency, type CommerceCancelResponse, type CommerceCheckResponse, type CommerceCheckoutResponse, type CommerceCancelParams, type CommerceCheckParams, type CommerceCheckoutParams, } from "./commerce/commerce.mjs";
 export { Content } from "./content/content.mjs";
+export { Files, type File, type Upload, type FileListParams, type FilesCursorIDPage } from "./files.mjs";
 export { PushNotifications, type PushNotificationEnableResponse, type PushNotificationIdentifyResponse, type PushNotificationSendResponse, type PushNotificationSubscribeResponse, type PushNotificationUnsubscribeResponse, type PushNotificationIdentifyParams, type PushNotificationSendParams, type PushNotificationSubscribeParams, type PushNotificationUnsubscribeParams, } from "./push-notifications/push-notifications.mjs";
 //# sourceMappingURL=index.d.mts.map

package/resources/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,QAAQ,EACR,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B;OACM,EAAE,OAAO,EAAE;OACX,EACL,iBAAiB,EACjB,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,EACjC,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACxC,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,EACpC,KAAK,iCAAiC,GACvC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B;OACM,EAAE,OAAO,EAAE;OACX,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,KAAK,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE;OAC9E,EACL,iBAAiB,EACjB,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,EACjC,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACxC,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,EACpC,KAAK,iCAAiC,GACvC"}

package/resources/index.d.ts

@@ -1,4 +1,5 @@
-export { Commerce, type CommerceCancelResponse, type CommerceCheckResponse, type CommerceCheckoutResponse, type CommerceCancelParams, type CommerceCheckParams, type CommerceCheckoutParams, } from "./commerce/commerce.js";
+export { Commerce, type Currency, type CommerceCancelResponse, type CommerceCheckResponse, type CommerceCheckoutResponse, type CommerceCancelParams, type CommerceCheckParams, type CommerceCheckoutParams, } from "./commerce/commerce.js";
 export { Content } from "./content/content.js";
+export { Files, type File, type Upload, type FileListParams, type FilesCursorIDPage } from "./files.js";
 export { PushNotifications, type PushNotificationEnableResponse, type PushNotificationIdentifyResponse, type PushNotificationSendResponse, type PushNotificationSubscribeResponse, type PushNotificationUnsubscribeResponse, type PushNotificationIdentifyParams, type PushNotificationSendParams, type PushNotificationSubscribeParams, type PushNotificationUnsubscribeParams, } from "./push-notifications/push-notifications.js";
 //# sourceMappingURL=index.d.ts.map

package/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,QAAQ,EACR,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B;OACM,EAAE,OAAO,EAAE;OACX,EACL,iBAAiB,EACjB,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,EACjC,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACxC,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,EACpC,KAAK,iCAAiC,GACvC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B;OACM,EAAE,OAAO,EAAE;OACX,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,KAAK,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE;OAC9E,EACL,iBAAiB,EACjB,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,EACjC,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACxC,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,EACpC,KAAK,iCAAiC,GACvC"}

package/resources/index.js

@@ -1,11 +1,13 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PushNotifications = exports.Content = exports.Commerce = void 0;
+exports.PushNotifications = exports.Files = exports.Content = exports.Commerce = void 0;
 var commerce_1 = require("./commerce/commerce.js");
 Object.defineProperty(exports, "Commerce", { enumerable: true, get: function () { return commerce_1.Commerce; } });
 var content_1 = require("./content/content.js");
 Object.defineProperty(exports, "Content", { enumerable: true, get: function () { return content_1.Content; } });
+var files_1 = require("./files.js");
+Object.defineProperty(exports, "Files", { enumerable: true, get: function () { return files_1.Files; } });
 var push_notifications_1 = require("./push-notifications/push-notifications.js");
 Object.defineProperty(exports, "PushNotifications", { enumerable: true, get: function () { return push_notifications_1.PushNotifications; } });
 //# sourceMappingURL=index.js.map

package/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,mDAQ6B;AAP3B,oGAAA,QAAQ,OAAA;AAQV,gDAA4C;AAAnC,kGAAA,OAAO,OAAA;AAChB,iFAWiD;AAV/C,uHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,mDAS6B;AAR3B,oGAAA,QAAQ,OAAA;AASV,gDAA4C;AAAnC,kGAAA,OAAO,OAAA;AAChB,oCAAqG;AAA5F,8FAAA,KAAK,OAAA;AACd,iFAWiD;AAV/C,uHAAA,iBAAiB,OAAA"}

package/resources/index.mjs

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 export { Commerce, } from "./commerce/commerce.mjs";
 export { Content } from "./content/content.mjs";
+export { Files } from "./files.mjs";
 export { PushNotifications, } from "./push-notifications/push-notifications.mjs";
 //# sourceMappingURL=index.mjs.map

package/resources/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,QAAQ,GAOT;OACM,EAAE,OAAO,EAAE;OACX,EACL,iBAAiB,GAUlB"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,QAAQ,GAQT;OACM,EAAE,OAAO,EAAE;OACX,EAAE,KAAK,EAAuE;OAC9E,EACL,iBAAiB,GAUlB"}

package/src/client.ts

@@ -19,6 +19,7 @@ import { AbstractPage, type CursorIDPageParams, CursorIDPageResponse } from './c
 import * as Uploads from './core/uploads';
 import * as API from './resources/index';
 import { APIPromise } from './core/api-promise';
+import { File, FileListParams, Files, FilesCursorIDPage, Upload } from './resources/files';
 import {
   Commerce,
   CommerceCancelParams,
@@ -27,6 +28,7 @@ import {
   CommerceCheckResponse,
   CommerceCheckoutParams,
   CommerceCheckoutResponse,
+  Currency,
 } from './resources/commerce/commerce';
 import { Content } from './resources/content/content';
 import {
@@ -767,11 +769,18 @@ export class Hercules {
    * Content APIs are currently in beta.
    */
   content: API.Content = new API.Content(this);
+  /**
+   * Upload, retrieve, and list files and media associated with a website.
+   * Upload is a two-step process: first create an upload to get a presigned URL,
+   * then complete the upload after putting the file content to the presigned URL.
+   */
+  files: API.Files = new API.Files(this);
   pushNotifications: API.PushNotifications = new API.PushNotifications(this);
 }
 
 Hercules.Commerce = Commerce;
 Hercules.Content = Content;
+Hercules.Files = Files;
 Hercules.PushNotifications = PushNotifications;
 
 export declare namespace Hercules {
@@ -782,6 +791,7 @@ export declare namespace Hercules {
 
   export {
     Commerce as Commerce,
+    type Currency as Currency,
     type CommerceCancelResponse as CommerceCancelResponse,
     type CommerceCheckResponse as CommerceCheckResponse,
     type CommerceCheckoutResponse as CommerceCheckoutResponse,
@@ -792,6 +802,14 @@ export declare namespace Hercules {
 
   export { Content as Content };
 
+  export {
+    Files as Files,
+    type File as File,
+    type Upload as Upload,
+    type FilesCursorIDPage as FilesCursorIDPage,
+    type FileListParams as FileListParams,
+  };
+
   export {
     PushNotifications as PushNotifications,
     type PushNotificationEnableResponse as PushNotificationEnableResponse,

package/src/resources/commerce/commerce.ts

@@ -108,6 +108,155 @@ export class Commerce extends APIResource {
   }
 }
 
+/**
+ * Three-letter ISO currency code.
+ *
+ * Supported currencies: USD, AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN,
+ * BAM, BBD, BDT, BIF, BMD, BND, BOB, BRL, BSD, BWP, BYN, BZD, CAD, CDF, CHF, CLP,
+ * CNY, COP, CRC, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ETB, EUR, FJD, FKP, GBP, GEL,
+ * GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HTG, HUF, IDR, ILS, INR, ISK, JMD, JPY, KES,
+ * KGS, KHR, KMF, KRW, KYD, KZT, LAK, LBP, LKR, LRD, LSL, MAD, MDL, MGA, MKD, MMK,
+ * MNT, MOP, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, PAB, PEN,
+ * PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHP,
+ * SLE, SOS, SRD, STD, SZL, THB, TJS, TOP, TRY, TTD, TWD, TZS, UAH, UGX, UYU, UZS,
+ * VND, VUV, WST, XAF, XCD, XCG, XOF, XPF, YER, ZAR, ZMW.
+ */
+export type Currency =
+  | 'USD'
+  | 'AED'
+  | 'AFN'
+  | 'ALL'
+  | 'AMD'
+  | 'ANG'
+  | 'AOA'
+  | 'ARS'
+  | 'AUD'
+  | 'AWG'
+  | 'AZN'
+  | 'BAM'
+  | 'BBD'
+  | 'BDT'
+  | 'BIF'
+  | 'BMD'
+  | 'BND'
+  | 'BOB'
+  | 'BRL'
+  | 'BSD'
+  | 'BWP'
+  | 'BYN'
+  | 'BZD'
+  | 'CAD'
+  | 'CDF'
+  | 'CHF'
+  | 'CLP'
+  | 'CNY'
+  | 'COP'
+  | 'CRC'
+  | 'CVE'
+  | 'CZK'
+  | 'DJF'
+  | 'DKK'
+  | 'DOP'
+  | 'DZD'
+  | 'EGP'
+  | 'ETB'
+  | 'EUR'
+  | 'FJD'
+  | 'FKP'
+  | 'GBP'
+  | 'GEL'
+  | 'GIP'
+  | 'GMD'
+  | 'GNF'
+  | 'GTQ'
+  | 'GYD'
+  | 'HKD'
+  | 'HNL'
+  | 'HTG'
+  | 'HUF'
+  | 'IDR'
+  | 'ILS'
+  | 'INR'
+  | 'ISK'
+  | 'JMD'
+  | 'JPY'
+  | 'KES'
+  | 'KGS'
+  | 'KHR'
+  | 'KMF'
+  | 'KRW'
+  | 'KYD'
+  | 'KZT'
+  | 'LAK'
+  | 'LBP'
+  | 'LKR'
+  | 'LRD'
+  | 'LSL'
+  | 'MAD'
+  | 'MDL'
+  | 'MGA'
+  | 'MKD'
+  | 'MMK'
+  | 'MNT'
+  | 'MOP'
+  | 'MUR'
+  | 'MVR'
+  | 'MWK'
+  | 'MXN'
+  | 'MYR'
+  | 'MZN'
+  | 'NAD'
+  | 'NGN'
+  | 'NIO'
+  | 'NOK'
+  | 'NPR'
+  | 'NZD'
+  | 'PAB'
+  | 'PEN'
+  | 'PGK'
+  | 'PHP'
+  | 'PKR'
+  | 'PLN'
+  | 'PYG'
+  | 'QAR'
+  | 'RON'
+  | 'RSD'
+  | 'RUB'
+  | 'RWF'
+  | 'SAR'
+  | 'SBD'
+  | 'SCR'
+  | 'SEK'
+  | 'SGD'
+  | 'SHP'
+  | 'SLE'
+  | 'SOS'
+  | 'SRD'
+  | 'STD'
+  | 'SZL'
+  | 'THB'
+  | 'TJS'
+  | 'TOP'
+  | 'TRY'
+  | 'TTD'
+  | 'TWD'
+  | 'TZS'
+  | 'UAH'
+  | 'UGX'
+  | 'UYU'
+  | 'UZS'
+  | 'VND'
+  | 'VUV'
+  | 'WST'
+  | 'XAF'
+  | 'XCD'
+  | 'XCG'
+  | 'XOF'
+  | 'XPF'
+  | 'YER'
+  | 'ZAR'
+  | 'ZMW';
+
 /**
  * Cancel subscription response
  */
@@ -312,6 +461,7 @@ Commerce.Features = Features;
 
 export declare namespace Commerce {
   export {
+    type Currency as Currency,
     type CommerceCancelResponse as CommerceCancelResponse,
     type CommerceCheckResponse as CommerceCheckResponse,
     type CommerceCheckoutResponse as CommerceCheckoutResponse,

package/src/resources/commerce/coupons.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as CommerceAPI from './commerce';
 import { APIPromise } from '../../core/api-promise';
 import { CursorIDPage, type CursorIDPageParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
@@ -170,10 +171,19 @@ export interface CouponCreateParams {
   amount_off?: number;
 
   /**
-   * Three-letter ISO currency code for amount_off discounts. Supported: usd, eur,
-   * gbp, jpy, cad, aud
-   */
-  currency?: 'usd' | 'eur' | 'gbp' | 'jpy' | 'cad' | 'aud';
+   * Three-letter ISO currency code.
+   *
+   * Supported currencies: USD, AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN,
+   * BAM, BBD, BDT, BIF, BMD, BND, BOB, BRL, BSD, BWP, BYN, BZD, CAD, CDF, CHF, CLP,
+   * CNY, COP, CRC, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ETB, EUR, FJD, FKP, GBP, GEL,
+   * GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HTG, HUF, IDR, ILS, INR, ISK, JMD, JPY, KES,
+   * KGS, KHR, KMF, KRW, KYD, KZT, LAK, LBP, LKR, LRD, LSL, MAD, MDL, MGA, MKD, MMK,
+   * MNT, MOP, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, PAB, PEN,
+   * PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHP,
+   * SLE, SOS, SRD, STD, SZL, THB, TJS, TOP, TRY, TTD, TWD, TZS, UAH, UGX, UYU, UZS,
+   * VND, VUV, WST, XAF, XCD, XCG, XOF, XPF, YER, ZAR, ZMW.
+   */
+  currency?: CommerceAPI.Currency;
 
   /**
    * How long the discount applies: once (first payment only), repeating (for

package/src/resources/commerce/customers.ts

@@ -83,8 +83,7 @@ export class Customers extends APIResource {
 
   /**
    * Retrieves a customer by ID. Returns the customer object including contact
-   * information, billing address, active subscriptions, recent invoices, and saved
-   * payment methods.
+   * information and billing address.
    *
    * @example
    * ```ts