fix: correct asset_fields[] parameter names for DAM 2.0

The previous PR #336 partially fixed asset_fields parameters but used
incorrect field names. This commit corrects all parameter names to match
the CDA API specification.

Changes:
- Changed 'ai_suggested' to 'ai_generated_metadata' in all test files
- Updated SDK documentation to reflect correct parameter names
- All asset_fields tests now pass (verified locally)

Valid asset_fields[] values per API:
- user_defined_fields
- embedded_metadata (not 'embedded')
- ai_generated_metadata (not 'ai_suggested')
- visual_markups

API Error that revealed the issue:
"Invalid values found, supported values are user_defined_fields,
embedded_metadata, ai_generated_metadata, visual_markups"

Files Modified:
- test/api/asset.spec.ts
- test/api/asset-query.spec.ts
- test/api/entry.spec.ts
- test/api/entries.spec.ts
- src/assets/asset.ts (JSDoc)
- src/query/asset-query.ts (JSDoc)
- src/entries/entry.ts (JSDoc)
- src/entries/entries.ts (JSDoc)

Test Results: All 16 asset_fields tests passing (8 API + 8 unit)

Author: AniketDev7

src/assets/asset.ts

@@ -133,14 +133,14 @@ export class Asset {
    * @method assetFields
    * @memberof Asset
    * @description Include specific asset fields in the response (CDA getAssets - single asset).
-   * Use with asset_fields[]: user_defined_fields, embedded, ai_suggested, visual_markups.
+   * Use with asset_fields[]: user_defined_fields, embedded_metadata, ai_generated_metadata, visual_markups.
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
    *
    * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
    * const result = await stack.asset("assetUid").assetFields("user_defined_fields", "embedded_metadata").fetch();
    *
-   * @param {...string} fields - Asset field names to include (e.g. user_defined_fields, embedded, ai_suggested, visual_markups)
+   * @param {...string} fields - Asset field names to include (e.g. user_defined_fields, embedded_metadata, ai_generated_metadata, visual_markups)
    * @returns {Asset} - Returns the Asset instance for chaining.
    */
   assetFields(...fields: string[]): this {

src/entries/entries.ts

@@ -281,14 +281,14 @@ export class Entries extends BaseQuery {
    * @method assetFields
    * @memberof Entries
    * @description Include specific asset fields in the response (CDA getEntry/entries).
-   * Use with asset_fields[]: user_defined_fields, embedded, ai_suggested, visual_markups.
+   * Use with asset_fields[]: user_defined_fields, embedded_metadata, ai_generated_metadata, visual_markups.
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
    *
    * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
    * const result = await stack.contentType("contentTypeUid").entry().assetFields("user_defined_fields", "embedded_metadata").find();
    *
-   * @param {...string} fields - Asset field names to include (e.g. user_defined_fields, embedded, ai_suggested, visual_markups)
+   * @param {...string} fields - Asset field names to include (e.g. user_defined_fields, embedded_metadata, ai_generated_metadata, visual_markups)
    * @returns {Entries} - Returns the Entries instance for chaining.
    */
   assetFields(...fields: string[]): this {

src/entries/entry.ts

@@ -278,14 +278,14 @@ export class Entry {
    * @method assetFields
    * @memberof Entry
    * @description Include specific asset fields in the response (CDA getEntry).
-   * Use with asset_fields[]: user_defined_fields, embedded, ai_suggested, visual_markups.
+   * Use with asset_fields[]: user_defined_fields, embedded_metadata, ai_generated_metadata, visual_markups.
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
    *
    * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
    * const result = await stack.contentType("contentTypeUid").entry("entryUid").assetFields("user_defined_fields", "embedded_metadata").fetch();
    *
-   * @param {...string} fields - Asset field names to include (e.g. user_defined_fields, embedded, ai_suggested, visual_markups)
+   * @param {...string} fields - Asset field names to include (e.g. user_defined_fields, embedded_metadata, ai_generated_metadata, visual_markups)
    * @returns {Entry} - Returns the Entry instance for chaining.
    */
   assetFields(...fields: string[]): this {

src/query/asset-query.ts

@@ -131,14 +131,14 @@ export class AssetQuery extends BaseQuery {
    * @method assetFields
    * @memberof AssetQuery
    * @description Include specific asset fields in the response (CDA getAssets).
-   * Use with asset_fields[]: user_defined_fields, embedded, ai_suggested, visual_markups.
+   * Use with asset_fields[]: user_defined_fields, embedded_metadata, ai_generated_metadata, visual_markups.
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
    *
    * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
    * const result = await stack.asset().assetFields("user_defined_fields", "embedded_metadata").find();
    *
-   * @param {...string} fields - Asset field names to include (e.g. user_defined_fields, embedded, ai_suggested, visual_markups)
+   * @param {...string} fields - Asset field names to include (e.g. user_defined_fields, embedded_metadata, ai_generated_metadata, visual_markups)
    * @returns {AssetQuery} - Returns the AssetQuery instance for chaining.
    */
   assetFields(...fields: string[]): this {

test/api/asset-query.spec.ts

@@ -132,7 +132,7 @@ describe("AssetQuery API tests", () => {
   });
   it("should query assets with asset_fields[] CDA param (user_defined_fields, embedded, ai_suggested, visual_markups)", async () => {
     const result = await makeAssetQuery()
-      .assetFields("user_defined_fields", "embedded_metadata", "ai_suggested", "visual_markups")
+      .assetFields("user_defined_fields", "embedded_metadata", "ai_generated_metadata", "visual_markups")
       .limit(2)
       .find<TAsset>();
     if (result.assets) {

test/api/asset.spec.ts

@@ -105,14 +105,25 @@ describe('Asset API tests', () => {
   });
 
   it('should fetch asset with asset_fields[] CDA param (user_defined_fields, embedded, ai_suggested, visual_markups)', async () => {
-    const result = await makeAsset(assetUid)
-      .assetFields('user_defined_fields', 'embedded', 'ai_suggested', 'visual_markups')
-      .fetch<BaseAsset>();
-    expect(result).toBeDefined();
-    expect(result.uid).toBeDefined();
-    expect(result._version).toBeDefined();
-    expect(result.url).toBeDefined();
-    expect(result.filename).toBeDefined();
+    try {
+      const result = await makeAsset(assetUid)
+        .assetFields('user_defined_fields', 'embedded_metadata', 'ai_generated_metadata', 'visual_markups')
+        .fetch<BaseAsset>();
+      expect(result).toBeDefined();
+      expect(result.uid).toBeDefined();
+      expect(result._version).toBeDefined();
+      expect(result.url).toBeDefined();
+      expect(result.filename).toBeDefined();
+    } catch (error: any) {
+      console.error('❌ Asset fetch with asset_fields failed:', {
+        message: error.message,
+        status: error.response?.status,
+        statusText: error.response?.statusText,
+        data: error.response?.data,
+        stack: error.stack?.split('\n').slice(0, 3).join('\n')
+      });
+      throw error;
+    }
   });
 });
 function makeAsset(uid = ''): Asset {

test/api/entries.spec.ts

@@ -173,7 +173,7 @@ describe("Entries API test cases", () => {
 
   it("should query entries with asset_fields[] CDA param (user_defined_fields, embedded, ai_suggested, visual_markups)", async () => {
     const result = await makeEntries(BLOG_POST_CT)
-      .assetFields("user_defined_fields", "embedded_metadata", "ai_suggested", "visual_markups")
+      .assetFields("user_defined_fields", "embedded_metadata", "ai_generated_metadata", "visual_markups")
       .find<TEntry>();
     if (result.entries) {
       expect(result.entries).toBeDefined();

test/api/entry.spec.ts

@@ -70,7 +70,7 @@ describe('Entry API tests', () => {
 
   it('should fetch entry with asset_fields[] CDA param (user_defined_fields, embedded, ai_suggested, visual_markups)', async () => {
     const result = await makeEntry(entryUid)
-      .assetFields('user_defined_fields', 'embedded', 'ai_suggested', 'visual_markups')
+      .assetFields('user_defined_fields', 'embedded_metadata', 'ai_generated_metadata', 'visual_markups')
       .fetch<TEntry>();
     expect(result).toBeDefined();
     expect(result.uid).toBeDefined();