staging PR

CHANGELOG.md

@@ -1,3 +1,11 @@
+### Version: 4.10.4
+#### Date: Dec-08-2025
+Feat: Improved error messages
+
+### Version: 4.10.3
+#### Date: Nov-12-2025
+fix: reverts the endpoints helper method integration
+
 ### Version: 4.10.2
 #### Date: Nov-12-2025
 Enhancement: Added logHandler interceptors for request and response logging

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentstack/delivery-sdk",
-  "version": "4.10.2",
+  "version": "4.10.4",
   "type": "module",
   "license": "MIT",
   "main": "./dist/legacy/index.cjs",

src/index.ts

@@ -11,5 +11,6 @@ export type { ImageTransform } from './lib/image-transform';
 export type { AssetQuery } from './lib/asset-query';
 export type { TaxonomyQuery } from './lib/taxonomy-query';
 export type { ContentTypeQuery } from './lib/contenttype-query';
+export { ErrorMessages, ErrorCode } from './lib/error-messages';
 
 export default contentstack;

src/lib/asset-query.ts

@@ -61,14 +61,14 @@ export class AssetQuery extends BaseQuery {
 
   /**
    * @method includeMetadata
-   * @memberof Entries
-   * @description Include the metadata for getting metadata content for the entry.
-   * @returns {Entries}
+   * @memberof AssetQuery
+   * @description Include the metadata for getting metadata content for the asset.
+   * @returns {AssetQuery}
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
    *
    * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
-   * const result = await stack.asset().includeMetadata().fetch();
+   * const result = await stack.asset().includeMetadata().find();
    */
   includeMetadata(): AssetQuery {
     this._queryParams.include_metadata = 'true';
@@ -128,14 +128,14 @@ export class AssetQuery extends BaseQuery {
   }
   /**
    * @method query
-   * @memberof Query
+   * @memberof AssetQuery
    * @description Fetches the asset data on the basis of the query
    * @returns {Query}
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
    *
    * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
-   * const result = await stack.asset().query().where('fieldUid', queryOperators, 'value').find();
+   * const result = await stack.asset().query().where('fieldUid', QueryOperation.EQUALS, 'value').find();
    */
   query() {
     return new Query(this._client, this._parameters, this._queryParams);

src/lib/asset.ts

@@ -29,9 +29,9 @@ export class Asset {
 
   /**
    * @method includeMetadata
-   * @memberof Entries
-   * @description Include the metadata for getting metadata content for the entry.
-   * @returns {Entries}
+   * @memberof Asset
+   * @description Include the metadata for getting metadata content for the asset.
+   * @returns {Asset}
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
    *
@@ -115,7 +115,7 @@ export class Asset {
   /**
    * @method locale
    * @memberof Asset
-   * @description The assets published in the locale will be fetched
+   * @description The asset published in the locale will be fetched
    * @returns {Asset}
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
@@ -133,7 +133,7 @@ export class Asset {
    * @method fetch
    * @memberof Asset
    * @description Fetches the asset data on the basis of the asset uid
-   * @returns {Asset}
+   * @returns {Promise<T>} Promise that resolves to the asset data
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
    *

src/lib/base-query.ts

@@ -51,7 +51,7 @@ export class BaseQuery extends Pagination {
    * const query = stack.contentType("contentTypeUid").entry().query();
    * const result = await query.orderByAscending("field_uid").find()
    * // OR
-   * const asset = await stack.asset().orderByAscending().find()
+   * const asset = await stack.asset().orderByAscending("field_uid").find()
    *
    * @returns {Query}
    */
@@ -72,7 +72,7 @@ export class BaseQuery extends Pagination {
    * const query = stack.contentType("contentTypeUid").entry().query();
    * const result = await query.orderByDescending("field_uid").find()
    * // OR
-   * const asset = await stack.asset().orderByDescending().find()
+   * const asset = await stack.asset().orderByDescending("field_uid").find()
    *
    * @returns {Query}
    */
@@ -91,7 +91,7 @@ export class BaseQuery extends Pagination {
    *
    * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
    * const query = stack.contentType("contentTypeUid").entry().query();
-   * const result = await query.limit("limit_value").find()
+   * const result = await query.limit(10).find()
    * // OR
    * const asset = await stack.asset().limit(5).find()
    *
@@ -112,7 +112,7 @@ export class BaseQuery extends Pagination {
    *
    * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
    * const query = stack.contentType("contentTypeUid").entry().query();
-   * const result = await query.skip("skip_value").find()
+   * const result = await query.skip(10).find()
    * // OR
    * const asset = await stack.asset().skip(5).find()
    *
@@ -191,9 +191,10 @@ export class BaseQuery extends Pagination {
 
   /**
    * @method find
-   * @memberof AssetQuery
-   * @description The assets of the stack will be fetched
-   * @returns {Collection}
+   * @memberof BaseQuery
+   * @description Fetches the data based on the query parameters
+   * @param {boolean} encode - Whether to encode query parameters
+   * @returns {Promise<FindResponse<T>>} Promise that resolves to the find response
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
    *
@@ -208,7 +209,7 @@ export class BaseQuery extends Pagination {
    * import contentstack from '@contentstack/delivery-sdk'
    *
    * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
-   * const result = await stack.asset(asset_uid).fetch();
+   * const result = await stack.contentType("contentTypeUid").entry().query().find();
    */
 
   async find<T>(encode: boolean = false): Promise<FindResponse<T>> {

src/lib/cache.ts

@@ -39,6 +39,16 @@ function generateEnhancedCacheKey(originalKey: string, contentTypeUid?: string,
   return cacheKey;
 }
 
+/**
+ * Handles cache requests based on the cache policy
+ * @param {CacheOptions} cacheOptions - Cache configuration options
+ * @param {string} apiKey - API key for cache key generation
+ * @param {Function} defaultAdapter - Default axios adapter function
+ * @param {Function} resolve - Promise resolve function
+ * @param {Function} reject - Promise reject function
+ * @param {object} config - Request configuration object
+ * @returns {Promise} Resolves or rejects based on cache policy and API response
+ */
 export async function handleRequest(
   cacheOptions: CacheOptions,
   apiKey: string,

src/lib/content-type.ts

@@ -21,13 +21,16 @@ export class ContentType {
   /**
    * @method entry
    * @memberof ContentType
-   * @description Creates entry object of the passed entry uid.
-   * @returns {Entry}
+   * @description Creates entry object of the passed entry uid, or entries query object if no uid is provided.
+   * @param {string} [uid] - Optional entry UID. If provided, returns a single Entry instance. If omitted, returns Entries query object.
+   * @returns {Entry | Entries} Entry instance if uid is provided, otherwise Entries query object
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
    *
    * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
    * const entry = stack.contentType("contentTypeUid").entry("entryUid");
+   * // OR
+   * const entries = stack.contentType("contentTypeUid").entry();
    */
   entry(uid: string): Entry;
   entry(): Entries;
@@ -41,7 +44,7 @@ export class ContentType {
    * @method fetch
    * @memberof ContentType
    * @description Fetches the contentType data on the basis of the contentType uid
-   * @returns {ContentType}
+   * @returns {Promise<T>} Promise that resolves to the content type data
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
    *

src/lib/contentstack.ts

@@ -14,7 +14,7 @@ let version = '{{VERSION}}';
  * @memberof Contentstack
  * @description Creates a stack instance
  * @param {StackConfig} config - config object for stack with apiKey, deliveryToken and environment as required fields
- *
+ * @returns {StackClass} Stack instance
  * @example
  * import contentstack from '@contentstack/delivery-sdk'
  * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
@@ -30,7 +30,7 @@ let version = '{{VERSION}}';
  *    policy: Policy.CACHE_THEN_NETWORK,
  *    storeType: 'localStorage'
  *   }
- * }
+ * });
  */
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export function stack(config: StackConfig): StackClass {

src/lib/contenttype-query.ts

@@ -13,7 +13,7 @@ export class ContentTypeQuery {
   /**
    * @method includeGlobalFieldSchema
    * @memberof ContentTypeQuery
-   * @description The assets published in the locale will be fetched
+   * @description Includes the global field schema in the content type response
    * @returns {ContentTypeQuery}
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
@@ -31,7 +31,7 @@ export class ContentTypeQuery {
    * @method find
    * @memberof ContentTypeQuery
    * @description Fetches all contentTypes of the stack
-   * @returns {ContentTypeQuery}
+   * @returns {Promise<FindResponse<T>>} Promise that resolves to the find response containing content types
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
    *

src/lib/entries.ts

@@ -3,6 +3,7 @@ import { Query } from './query';
 import { BaseQuery } from './base-query';
 import { FindResponse } from './types';
 import { encodeQueryParams } from './utils';
+import { ErrorMessages } from './error-messages';
 
 export class Entries extends BaseQuery {
   private _contentTypeUid: string;
@@ -62,13 +63,13 @@ export class Entries extends BaseQuery {
   /**
    * @method includeContentType
    * @memberof Entries
-   * @description IInclude the details of the content type along with the entries details
+   * @description Include the details of the content type along with the entries details
    * @returns {Entries}
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
    *
    * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
-   * const result = await stack.contentType(contentType_uid).entry().includeContentType().fetch();
+   * const result = await stack.contentType(contentType_uid).entry().includeContentType().find();
    */
   includeContentType(): Entries {
     this._queryParams.include_content_type = 'true';
@@ -85,7 +86,7 @@ export class Entries extends BaseQuery {
    * import contentstack from '@contentstack/delivery-sdk'
    *
    * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
-   * const result = await stack.contentType(contentType_uid).entry().includeEmbeddedItems().fetch();
+   * const result = await stack.contentType(contentType_uid).entry().includeEmbeddedItems().find();
    */
   includeEmbeddedItems(): Entries {
     this._queryParams['include_embedded_items[]'] = 'BASE';
@@ -134,9 +135,11 @@ export class Entries extends BaseQuery {
    * you need to use the include[] parameter and specify the UID of the reference field as value.
    * This function sets the include parameter to a reference field UID in the API request.
    * @example
-   * const stack = contentstack.stack("apiKey", "deliveryKey", "environment");
-   * const query = stack.contentType("contentTypeUid").entry().includeReference("brand")
-   * const res = await query.find()
+   * import contentstack from '@contentstack/delivery-sdk'
+   *
+   * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
+   * const entries = stack.contentType("contentTypeUid").entry().includeReference("brand")
+   * const result = await entries.find()
    *
    * @param {string} referenceFieldUid - UID of the reference field to include.
    * @returns {Entries} - Returns the Entries instance for chaining.
@@ -150,7 +153,7 @@ export class Entries extends BaseQuery {
         (this._queryParams['include[]'] as string[]).push(...(Array.isArray(value) ? value : [value]));
       });
     } else {
-      console.error("Argument should be a String or an Array.");
+      console.error(ErrorMessages.INVALID_ARGUMENT_STRING_OR_ARRAY);
     }
     return this;
   }
@@ -160,9 +163,11 @@ export class Entries extends BaseQuery {
    * @memberof Entries
    * @description This method also includes the content type UIDs of the referenced entries returned in the response.
    * @example
-   * const stack = contentstack.stack("apiKey", "deliveryKey", "environment");
-   * const query = stack.contentType("contentTypeUid").entry().includeReferenceContentTypeUID()
-   * const res = await query.find()
+   * import contentstack from '@contentstack/delivery-sdk'
+   *
+   * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
+   * const entries = stack.contentType("contentTypeUid").entry().includeReferenceContentTypeUID()
+   * const result = await entries.find()
    *
    * @returns {Entries} - Returns the Entries instance for chaining.
    */
@@ -175,11 +180,13 @@ export class Entries extends BaseQuery {
   /**
    * @method includeSchema
    * @memberof Entries
-   * @description This method also includes the content type UIDs of the referenced entries returned in the response.
+   * @description Includes the schema of the content type along with the entries details.
    * @example
-   * const stack = contentstack.stack("apiKey", "deliveryKey", "environment");
-   * const query = stack.contentType("contentTypeUid").entry().includeSchema()
-   * const res = await query.find()
+   * import contentstack from '@contentstack/delivery-sdk'
+   *
+   * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
+   * const entries = stack.contentType("contentTypeUid").entry().includeSchema()
+   * const result = await entries.find()
    *
    * @returns {Entries} - Returns the Entries instance for chaining.
    */
@@ -191,9 +198,9 @@ export class Entries extends BaseQuery {
 
   /**
    * @method locale
-   * @memberof Entry
-   * @description The assets published in the locale will be fetched
-   * @returns {Entry}
+   * @memberof Entries
+   * @description The entries published in the locale will be fetched
+   * @returns {Entries}
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
    *
@@ -235,13 +242,14 @@ export class Entries extends BaseQuery {
   /**
    * @method query
    * @memberof Entries
-   * @description Fetches the Entry data on the basis of the asset uid
-   * @returns {Collection}
+   * @description Creates a query object for filtering entries
+   * @param {object} queryObj - Optional query object to initialize the query
+   * @returns {Query} Query instance for chaining query methods
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
    *
    * const stack = contentstack.stack({ apiKey: "apiKey", deliveryToken: "deliveryToken", environment: "environment" });
-   * const result = await stack.contentType("contentTypeUid").entry().query();
+   * const query = stack.contentType("contentTypeUid").entry().query();
    */
   query(queryObj?: { [key: string]: any }) {
     if (queryObj) return new Query(this._client, this._parameters, this._queryParams, this._variants, this._contentTypeUid, queryObj);
@@ -251,9 +259,9 @@ export class Entries extends BaseQuery {
 
   /**
    * @method variants
-   * @memberof Entry
+   * @memberof Entries
    * @description The variant header will be added to axios client
-   * @returns {Entry}
+   * @returns {Entries}
    * @example
    * import contentstack from '@contentstack/delivery-sdk'
    *