@uniformdev/assets 20.72.3-alpha.2 → 20.72.3-alpha.23

package/dist/index.d.mts

@@ -764,9 +764,11 @@ interface components$1 {
             versionId: string;
             /** @description The timestamp when the version was created in epoch milliseconds */
             timestamp: number;
-            /** @description The name (full name) of the user who created the version */
+            /** @description The name (full name) of the user who created the version, or "Unknown user" if the author can no longer be resolved */
             authorName: string;
             authorIsApiKey: boolean;
+            /** @description The identity who created the version; absent on old history entries. */
+            authorSubject?: string;
             /** @description The state of the entity when the history entry was made */
             state: number;
         };
@@ -1001,6 +1003,58 @@ interface paths {
             path?: never;
             cookie?: never;
         };
+        /**
+         * @description In addition to the named parameters below, this endpoint accepts the
+         *     following query parameter convention which is pattern-validated and
+         *     therefore not declared as named parameters:
+         *
+         *     * `filters.<field>[<op>]` — content filtering (documented below).
+         *
+         *     #### Content filtering (`filters.*`)
+         *
+         *     Filtering narrows list results to assets matching field values. The
+         *     allowed field names are project-specific — they come from the project's
+         *     asset definitions — which is why `filters.*` parameters are
+         *     pattern-validated rather than declared as named parameters.
+         *
+         *     Syntax: `filters.<field>[<operator>]=<value>`. `<field>` is one of:
+         *
+         *     * A system field such as `name`, `type`, `created`, `modified`,
+         *       `entityId`, `creator`, `creatorSubject`, `author`, `authorSubject`,
+         *       `categoryId`, `labels`, `labelGroups`, or `uiStatus`.
+         *     * An asset field, addressed as `fields.<fieldId>`. Unlike entries and
+         *       compositions, asset field filters do not require a single-type
+         *       filter — but if the same field ID has differing types across asset
+         *       types, HTTP 400 is returned and a single asset type must be
+         *       filtered.
+         *
+         *     | Operator | Effect |
+         *     |---|---|
+         *     | `[eq]` / `[neq]` | Exact equality / inequality. |
+         *     | `[match]` | Contains (text search) match; text-like fields only. |
+         *     | `[starts]` | Prefix match. Value limited to letters, numbers, `_`, `.`, `-`, and spaces. |
+         *     | `[lt]` / `[lte]` / `[gt]` / `[gte]` | Comparisons for number, date, and datetime fields (including `created` / `modified`). |
+         *     | `[in]` / `[nin]` | Comma-separated list; matches any (OR) / none of the values. |
+         *     | `[all]` | Comma-separated list; list-valued fields (e.g. `labels`, multi-selects) must contain every value (AND). |
+         *     | `[def]` | `true` or `false`; whether the field has a value at all. |
+         *
+         *     Behavior:
+         *
+         *     * Values are single strings, or comma-separated lists for `[in]`,
+         *       `[nin]`, and `[all]`. Dates accept `YYYY-MM-DD` or a full datetime
+         *       string. An empty value is rejected — use `[def]` to test presence.
+         *     * Not every operator is valid for every field; the allowed set depends
+         *       on the field's type. An unsupported combination returns HTTP 400
+         *       with the supported operators listed.
+         *     * Malformed keys, unknown operators, and unknown field names return
+         *       HTTP 400.
+         *
+         *     Examples:
+         *
+         *     * `filters.type[eq]=productImage` — only assets of type `productImage`.
+         *     * `filters.modified[gte]=2026-01-01` — modified this year.
+         *     * `filters.fields.altText[def]=false` — assets missing alt text.
+         */
         get: {
             parameters: {
                 query: {
@@ -1757,9 +1811,20 @@ declare class AssetClient extends ApiClient {
     get(options: WithoutProjectId<AssetGetRequestList> & {
         filters?: Record<string, unknown>;
     }): Promise<AssetGetResponseList>;
+    /**
+     * Fetches a list of assets
+     */
+    list(options?: WithoutProjectId<AssetGetRequestList> & {
+        filters?: Record<string, unknown>;
+    }): Promise<AssetGetResponseList>;
+    save(options: WithoutProjectId<AssetUpsertRequest>): Promise<void>;
+    /** @deprecated Use {@link save} instead. */
     upsert(options: WithoutProjectId<AssetUpsertRequest>): Promise<void>;
+    remove(options: WithoutProjectId<AssetDeleteRequest>): Promise<void>;
+    /** @deprecated Use {@link remove} instead. */
     delete(options: WithoutProjectId<AssetDeleteRequest>): Promise<void>;
 }
+/** @deprecated Pass `bypassCache: true` to {@link AssetClient} instead. */
 declare class UncachedAssetClient extends AssetClient {
     constructor(options: Omit<ClientOptions & {
         projectId: NonNullable<ClientOptions['projectId']>;

package/dist/index.d.ts

@@ -764,9 +764,11 @@ interface components$1 {
             versionId: string;
             /** @description The timestamp when the version was created in epoch milliseconds */
             timestamp: number;
-            /** @description The name (full name) of the user who created the version */
+            /** @description The name (full name) of the user who created the version, or "Unknown user" if the author can no longer be resolved */
             authorName: string;
             authorIsApiKey: boolean;
+            /** @description The identity who created the version; absent on old history entries. */
+            authorSubject?: string;
             /** @description The state of the entity when the history entry was made */
             state: number;
         };
@@ -1001,6 +1003,58 @@ interface paths {
             path?: never;
             cookie?: never;
         };
+        /**
+         * @description In addition to the named parameters below, this endpoint accepts the
+         *     following query parameter convention which is pattern-validated and
+         *     therefore not declared as named parameters:
+         *
+         *     * `filters.<field>[<op>]` — content filtering (documented below).
+         *
+         *     #### Content filtering (`filters.*`)
+         *
+         *     Filtering narrows list results to assets matching field values. The
+         *     allowed field names are project-specific — they come from the project's
+         *     asset definitions — which is why `filters.*` parameters are
+         *     pattern-validated rather than declared as named parameters.
+         *
+         *     Syntax: `filters.<field>[<operator>]=<value>`. `<field>` is one of:
+         *
+         *     * A system field such as `name`, `type`, `created`, `modified`,
+         *       `entityId`, `creator`, `creatorSubject`, `author`, `authorSubject`,
+         *       `categoryId`, `labels`, `labelGroups`, or `uiStatus`.
+         *     * An asset field, addressed as `fields.<fieldId>`. Unlike entries and
+         *       compositions, asset field filters do not require a single-type
+         *       filter — but if the same field ID has differing types across asset
+         *       types, HTTP 400 is returned and a single asset type must be
+         *       filtered.
+         *
+         *     | Operator | Effect |
+         *     |---|---|
+         *     | `[eq]` / `[neq]` | Exact equality / inequality. |
+         *     | `[match]` | Contains (text search) match; text-like fields only. |
+         *     | `[starts]` | Prefix match. Value limited to letters, numbers, `_`, `.`, `-`, and spaces. |
+         *     | `[lt]` / `[lte]` / `[gt]` / `[gte]` | Comparisons for number, date, and datetime fields (including `created` / `modified`). |
+         *     | `[in]` / `[nin]` | Comma-separated list; matches any (OR) / none of the values. |
+         *     | `[all]` | Comma-separated list; list-valued fields (e.g. `labels`, multi-selects) must contain every value (AND). |
+         *     | `[def]` | `true` or `false`; whether the field has a value at all. |
+         *
+         *     Behavior:
+         *
+         *     * Values are single strings, or comma-separated lists for `[in]`,
+         *       `[nin]`, and `[all]`. Dates accept `YYYY-MM-DD` or a full datetime
+         *       string. An empty value is rejected — use `[def]` to test presence.
+         *     * Not every operator is valid for every field; the allowed set depends
+         *       on the field's type. An unsupported combination returns HTTP 400
+         *       with the supported operators listed.
+         *     * Malformed keys, unknown operators, and unknown field names return
+         *       HTTP 400.
+         *
+         *     Examples:
+         *
+         *     * `filters.type[eq]=productImage` — only assets of type `productImage`.
+         *     * `filters.modified[gte]=2026-01-01` — modified this year.
+         *     * `filters.fields.altText[def]=false` — assets missing alt text.
+         */
         get: {
             parameters: {
                 query: {
@@ -1757,9 +1811,20 @@ declare class AssetClient extends ApiClient {
     get(options: WithoutProjectId<AssetGetRequestList> & {
         filters?: Record<string, unknown>;
     }): Promise<AssetGetResponseList>;
+    /**
+     * Fetches a list of assets
+     */
+    list(options?: WithoutProjectId<AssetGetRequestList> & {
+        filters?: Record<string, unknown>;
+    }): Promise<AssetGetResponseList>;
+    save(options: WithoutProjectId<AssetUpsertRequest>): Promise<void>;
+    /** @deprecated Use {@link save} instead. */
     upsert(options: WithoutProjectId<AssetUpsertRequest>): Promise<void>;
+    remove(options: WithoutProjectId<AssetDeleteRequest>): Promise<void>;
+    /** @deprecated Use {@link remove} instead. */
     delete(options: WithoutProjectId<AssetDeleteRequest>): Promise<void>;
 }
+/** @deprecated Pass `bypassCache: true` to {@link AssetClient} instead. */
 declare class UncachedAssetClient extends AssetClient {
     constructor(options: Omit<ClientOptions & {
         projectId: NonNullable<ClientOptions['projectId']>;

package/dist/index.esm.js

@@ -16,7 +16,21 @@ var AssetClient = class extends ApiClient {
     });
     return this.apiClient(fetchUri);
   }
-  async upsert(options) {
+  /**
+   * Fetches a list of assets
+   */
+  async list(options = {}) {
+    const { projectId } = this.options;
+    const { filters, ...params } = options;
+    const rewrittenFilters = rewriteFiltersForApi(filters);
+    const fetchUri = this.createUrl(ASSET_BASE_PATH, {
+      ...params,
+      projectId,
+      ...rewrittenFilters
+    });
+    return this.apiClient(fetchUri);
+  }
+  async save(options) {
     const { projectId } = this.options;
     const fetchUri = this.createUrl(ASSET_BASE_PATH);
     await this.apiClient(fetchUri, {
@@ -25,7 +39,11 @@ var AssetClient = class extends ApiClient {
       expectNoContent: true
     });
   }
-  async delete(options) {
+  /** @deprecated Use {@link save} instead. */
+  async upsert(options) {
+    return this.save(options);
+  }
+  async remove(options) {
     const { projectId } = this.options;
     const fetchUri = this.createUrl(ASSET_BASE_PATH);
     await this.apiClient(fetchUri, {
@@ -34,6 +52,10 @@ var AssetClient = class extends ApiClient {
       expectNoContent: true
     });
   }
+  /** @deprecated Use {@link remove} instead. */
+  async delete(options) {
+    return this.remove(options);
+  }
 };
 var UncachedAssetClient = class extends AssetClient {
   constructor(options) {

package/dist/index.js

@@ -47,7 +47,21 @@ var AssetClient = class extends import_api.ApiClient {
     });
     return this.apiClient(fetchUri);
   }
-  async upsert(options) {
+  /**
+   * Fetches a list of assets
+   */
+  async list(options = {}) {
+    const { projectId } = this.options;
+    const { filters, ...params } = options;
+    const rewrittenFilters = (0, import_api.rewriteFiltersForApi)(filters);
+    const fetchUri = this.createUrl(ASSET_BASE_PATH, {
+      ...params,
+      projectId,
+      ...rewrittenFilters
+    });
+    return this.apiClient(fetchUri);
+  }
+  async save(options) {
     const { projectId } = this.options;
     const fetchUri = this.createUrl(ASSET_BASE_PATH);
     await this.apiClient(fetchUri, {
@@ -56,7 +70,11 @@ var AssetClient = class extends import_api.ApiClient {
       expectNoContent: true
     });
   }
-  async delete(options) {
+  /** @deprecated Use {@link save} instead. */
+  async upsert(options) {
+    return this.save(options);
+  }
+  async remove(options) {
     const { projectId } = this.options;
     const fetchUri = this.createUrl(ASSET_BASE_PATH);
     await this.apiClient(fetchUri, {
@@ -65,6 +83,10 @@ var AssetClient = class extends import_api.ApiClient {
       expectNoContent: true
     });
   }
+  /** @deprecated Use {@link remove} instead. */
+  async delete(options) {
+    return this.remove(options);
+  }
 };
 var UncachedAssetClient = class extends AssetClient {
   constructor(options) {

package/dist/index.mjs

@@ -16,7 +16,21 @@ var AssetClient = class extends ApiClient {
     });
     return this.apiClient(fetchUri);
   }
-  async upsert(options) {
+  /**
+   * Fetches a list of assets
+   */
+  async list(options = {}) {
+    const { projectId } = this.options;
+    const { filters, ...params } = options;
+    const rewrittenFilters = rewriteFiltersForApi(filters);
+    const fetchUri = this.createUrl(ASSET_BASE_PATH, {
+      ...params,
+      projectId,
+      ...rewrittenFilters
+    });
+    return this.apiClient(fetchUri);
+  }
+  async save(options) {
     const { projectId } = this.options;
     const fetchUri = this.createUrl(ASSET_BASE_PATH);
     await this.apiClient(fetchUri, {
@@ -25,7 +39,11 @@ var AssetClient = class extends ApiClient {
       expectNoContent: true
     });
   }
-  async delete(options) {
+  /** @deprecated Use {@link save} instead. */
+  async upsert(options) {
+    return this.save(options);
+  }
+  async remove(options) {
     const { projectId } = this.options;
     const fetchUri = this.createUrl(ASSET_BASE_PATH);
     await this.apiClient(fetchUri, {
@@ -34,6 +52,10 @@ var AssetClient = class extends ApiClient {
       expectNoContent: true
     });
   }
+  /** @deprecated Use {@link remove} instead. */
+  async delete(options) {
+    return this.remove(options);
+  }
 };
 var UncachedAssetClient = class extends AssetClient {
   constructor(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/assets",
-  "version": "20.72.3-alpha.2+36e92d30ab",
+  "version": "20.72.3-alpha.23+cbe06f1e8a",
   "description": "Uniform Assets",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -37,11 +37,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@uniformdev/context": "20.72.3-alpha.2+36e92d30ab",
-    "@uniformdev/files": "20.72.3-alpha.2+36e92d30ab"
+    "@uniformdev/context": "20.72.3-alpha.23+cbe06f1e8a",
+    "@uniformdev/files": "20.72.3-alpha.23+cbe06f1e8a"
   },
   "devDependencies": {
     "ts-xor": "^1.3.0"
   },
-  "gitHead": "36e92d30ab1b97fc68cf16fc22c6f7865ac8ba97"
+  "gitHead": "cbe06f1e8a5bb93b0e3cae6b1c8774f21c10506e"
 }