Merge branch 'development' into feat/taxonomy-publishing

Author: harshitha-cstk

.gitignore

@@ -12,6 +12,39 @@ tap-html.html
 coverage
 .env
 .dccache
-dist/*
+dist/
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.cache
+test-results/
+
+# Build artifacts (should only be in dist/)
+src/**/*.js
+src/**/*.js.map
+
+# Compiled test artifacts (use .ts source only)
+test/api/**/*.js
+test/api/**/*.js.map
+
+# Browser test bundle (generated)
+test/e2e/sdk-browser-bundle.js
+test/e2e/sdk-browser-bundle.js.map
+docs
+reports
+
+# Bundler test artifacts (regenerated on test run)
+test/bundlers/**/.next/
+test/bundlers/**/dist/
+test/bundlers/**/node_modules/
+test/bundlers/**/package-lock.json
+
+# Temporary internal scripts
+test/docs/*.js
+test/docs/*.mjs
+test/docs/sanity-report*
 *.log
-.nx/
+.nx/
+delivery-sdk-persistence/

.talismanrc

@@ -1,22 +1,67 @@
 fileignoreconfig:
-- filename: package-lock.json
-  checksum: cb21e1b4fc8240b8ee33c6f974a9d1cf25d96afb9161c85633cbb061f069bbc4
+- filename: README.md
+  checksum: b40240271f930e1c0db9bbcf78a55bf0d52d6caf0eb265eae94d1a2aecf442c5
+- filename: test/unit/error-messages.spec.ts
+  checksum: 186390727b2488317c49f22955ade58b454d4c00c6b850bbb0617c30c59f8255
+- filename: src/common/types.ts
+  checksum: 0466775043773ec966f10bac2eeed812274748fc275a1017ad51295dff5c58ca
 - filename: test/unit/contentstack.spec.ts
-  checksum: d5b99c01459ab8bc597baaa9e6cc4aa91ac6d9bf78af08e1d0220d0c5db3d0b3
+  checksum: 8f560efd9fba6e04682899eff3cc448d22c38019eac0a5ffcab35ba59f81da2c
+- filename: test/unit/cache.spec.ts
+  checksum: a9bf179485c09e3821d78588a6bd2a57a70b68dd05948f7187c73d05b846b651
+- filename: test/browser/import.spec.ts
+  checksum: 2e9a157e28b0ce71c4b6422c6b457996a2e6785a1ef591c8bb35276b3471a5d0
+- filename: scripts/test-bundlers.js
+  checksum: 4a85cdc2f456d2f9d64d96eedaeddd34f192f243f352132957b1a9c0e979d635
+- filename: test/browser/helpers/browser-stack-instance.ts
+  checksum: 333fdbd1229022736e6e3262c7f275cb22534ec149d4e9a8270f0745b60d8661
+- filename: scripts/validate-browser-safe.js
+  checksum: 769b95cf55a6cf8455d057a662a8071286faf62a75862e3317d79367fe1ed5b4
+- filename: test/browser/initialization.spec.ts
+  checksum: 4054847ebfcc980299240a27d0aa30c1f43a9482e6ba39ac0af6126e7db9e04a
+- filename: test/e2e/browser-integration.spec.ts
+  checksum: 6646595d48bfaec3d9de111b22b36cf0925b33e18df55b068181c0bb81c1862b
+- filename: test/browser/real-api-calls.spec.ts
+  checksum: 514930cdde28cdc8b37ab054031260d5703dc8bdf777906dd5f9baa270ab7c3a
 - filename: test/unit/utils.spec.ts
-  checksum: 79ce5bd78376db37a34df82c0fea19031e995b66a5a246e73f8262fa05d65a9c
+  checksum: a491df0a19c336ff5b18450fb23e26676a1798222100c946150e7a1b6504d953
 - filename: test/unit/query-optimization-comprehensive.spec.ts
   checksum: f5aaf6c784d7c101a05ca513c584bbd6e95f963d1e42779f2596050d9bcbac96
-- filename: src/lib/entries.ts
+- filename: src/entries/entries.ts
   checksum: f6a19da15baed75062ad0cc599573ed08926e28fffe3f6e4890a0efb4d58c910
-- filename: src/lib/cache.ts
+- filename: src/cache/cache.ts
   checksum: d8d32089b8a4b247e4ba71c22b56cbb0a54440ebf35b102af222eb8032919f02
-- filename: test/unit/cache.spec.ts
-  checksum: e96f913a466a1f4d55a422e7032fc2c06eeed5fea86cdcc86a05fbe3eba29b7a
-- filename: src/lib/query.ts
+- filename: src/query/query.ts
   checksum: 073c47e46755eb79d1d7e9fcaf2864296a218bf650888dd37c42480cce7df379
 - filename: test/api/retry-integration.spec.ts
   checksum: dc07b0a8111fd8e155b99f56c31ccdddd4f46c86f1b162b17d73e15dfed8e3c8
 - filename: test/unit/retry-configuration.spec.ts
   checksum: 359c8601c6205a65f3395cc209a93b278dfe7f5bb547c91b2eeab250b2c85aa3
-version: ""
+- filename: package-lock.json
+  checksum: 993afd503e9f5d399fac30ae230cb47538cec2c61c5364e88be72726fb723dda
+  ignore_detectors: [ base64, filecontent ]
+- filename: src/global-field/global-field.ts
+  checksum: 70b9652bcba16ddc4d853ac212ad909a8ecfc76f491c55a05e4e3cdf9ce476b5
+- filename: src/content-type/content-type.ts
+  checksum: 1dc0fa53ae209efb67d68a01493822e9dec560799f8309329213dae69459655f
+- filename: src/stack/stack.ts
+  checksum: 145dd6add876a771a9a6ba024f57ef2c4b46a911fe1bf3885a69cf1f6c9dd72d
+- filename: src/entries/entry.ts
+  checksum: 1c64ccf19226873d068d6896028bfb74546c1cfd993779515bccfcc747180ca0
+- filename: src/common/error-messages.ts
+  checksum: 3b960af19f3ba302522e912616b147b11d63dfe3f7ad2e0cf2de807815ee236a
+- filename: src/query/global-field-query.ts
+  checksum: 824c54061b80236380e776640e7f52f45164230bcc0ee88de302b30e9f83297f
+- filename: src/query/base-query.ts
+  checksum: 8d67435121581d43ba9c5f544daf30a0579b7faa7c8661000d8d37ddfc172112
+- filename: test/unit/base-query.spec.ts
+  checksum: ceaceb1d65965b151edc9fc11d5a226460328b1913319994df51ca1b453cd6af
+- filename: test/api/modular-blocks.spec.ts
+  checksum: 1e536b0409f05f2d5c1d6e87b0ec4bda2c3fde9bc4ff331406f33464a26cff55
+- filename: test/unit/centralized-error-handling.spec.ts
+  checksum: 66a5eb520414bd71da331338bfb4faa2fc9f233eadf0eb18ddd7915db6849238
+- filename: test/api/base-query-casting.specs.ts
+  checksum: 9185df498914e2966d78d9d216acaaa910d43cd7ac9a5e9a26e7241ac9edc9b5
+- filename: test/reporting/generate-unified-report.js
+  checksum: 9e7a4696561b790cb93f3be8406a70ec6fdc90a3f8bbb9739504495690158fe3
+version: "1.0"

CHANGELOG.md

@@ -1,3 +1,38 @@
+### Version: 5.1.1
+#### Date: Mar-09-2026
+Fix: Added support of special symbols in regex method with safe pattern.
+
+### Version: 5.1.0
+#### Date: Mar-02-2026
+Fix: Added support of asset fields in assets & entries class.
+
+### Version: 5.0.1
+#### Date: feb-23-2026
+Fix: Added support of special symbols in regex method with safe pattern.
+
+### Version: 5.0.0
+#### Date: Feb-16-2026
+Breaking: Cache persistence is now a separate plugin. When using a cache policy other than `IGNORE_CACHE`, you must pass `cacheOptions.persistenceStore`. Install `@contentstack/persistence-plugin` and use `new PersistenceStore({ ... })` as the store. The SDK no longer bundles persistence code or accepts `storeType` in `cacheOptions`.
+Enhancement: SDK defines only the `PersistenceStore` interface (getItem/setItem); full implementation lives in the plugin for a lighter core package.
+Fix: Sync API returns non-Axios response causing undefined data and recursive sync failure
+
+### Version: 4.11.2
+#### Date: feb-11-2026
+Fix: JS core & axios version bump
+
+
+### Version: 4.11.2
+#### Date: feb-11-2026
+Fix: JS core & axios version bump
+
+### Version: 4.11.1
+#### Date: Feb-09-2026
+Fix: Fix security issues
+
+### Version: 4.11.0
+#### Date: Jan-19-2026
+Enhancement: Integrated getContentstackEndpoint method of Utils SDK for endpoint selection
+
 ### Version: 4.10.5
 #### Date: Jan-05-2026
 Fix: update esm export path to include .js extension (upgrade contentstack-js-core dependency)

README.md

@@ -9,7 +9,7 @@ The Typescript SDK can also be used to create Node.js and React native applicati
 
 ### Prerequisite
 
-You need Node.js version 4.4.7 or later installed to use the Contentstack JavaScript SDK.
+You need Node.js version 18 or later installed to use the Contentstack TypeScript SDK.
 
 ### Setup and Installation
 
@@ -66,6 +66,63 @@ You will need to specify the API key, Delivery Token, and Environment Name of yo
 
 Once you have initialized the SDK, you can start getting content in your app.
 
+#### Region and Host Configuration
+
+The SDK supports region and custom host configuration to connect to different Contentstack data centers or custom endpoints.
+
+**Region Support**
+
+You can specify a region to connect to the appropriate Contentstack data center. Available regions are:
+- `US` (default) - Uses `cdn.contentstack.io`
+- `EU` - Uses `eu-cdn.contentstack.com`
+- `AU` - Uses `au-cdn.contentstack.com`
+- `AZURE_NA` - Uses `azure-na-cdn.contentstack.com`
+- `AZURE_EU` - Uses `azure-eu-cdn.contentstack.com`
+- `GCP_NA` - Uses `gcp-na-cdn.contentstack.com`
+- `GCP_EU` - Uses `gcp-eu-cdn.contentstack.com`
+
+```typescript
+import contentstack, { Region } from '@contentstack/delivery-sdk'
+
+// Using region enum
+const stack = contentstack.stack({
+  apiKey: "apiKey",
+  deliveryToken: "deliveryToken",
+  environment: "environment",
+  region: Region.EU
+});
+
+// Using region string
+const stack = contentstack.stack({
+  apiKey: "apiKey",
+  deliveryToken: "deliveryToken",
+  environment: "environment",
+  region: "eu"
+});
+```
+
+**Custom Host Support**
+
+You can specify a custom host to connect to a custom endpoint. If a custom host is provided, it takes priority over the region-based host.
+
+```typescript
+const stack = contentstack.stack({
+  apiKey: "apiKey",
+  deliveryToken: "deliveryToken",
+  environment: "environment",
+  host: "custom-cdn.example.com"
+});
+
+// Custom host with region (host takes priority)
+const stack = contentstack.stack({
+  apiKey: "apiKey",
+  deliveryToken: "deliveryToken",
+  environment: "environment",
+  region: Region.EU,
+  host: "custom-cdn.example.com"
+});
+```
+
 #### Querying content from your stack
 
 To get a single entry, you need to specify the content type as well as the ID of the entry.
@@ -132,6 +189,35 @@ const pagedResult = await query
 
 ```
 
+### Caching
+
+To use cache policies (`CACHE_THEN_NETWORK`, `CACHE_ELSE_NETWORK`, `NETWORK_ELSE_CACHE`), you must provide a persistence store via `cacheOptions.persistenceStore`. Install the optional persistence plugin and pass a `PersistenceStore` instance:
+
+```bash
+npm install @contentstack/persistence-plugin
+```
+
+```typescript
+import contentstack, { Policy } from '@contentstack/delivery-sdk';
+import { PersistenceStore } from '@contentstack/persistence-plugin';
+
+const stack = contentstack.stack({
+  apiKey: 'your-api-key',
+  deliveryToken: 'your-delivery-token',
+  environment: 'your-environment',
+  cacheOptions: {
+    policy: Policy.CACHE_THEN_NETWORK,
+    persistenceStore: new PersistenceStore({ storeType: 'localStorage', maxAge: 86400000 }),
+  },
+});
+```
+
+See [@contentstack/persistence-plugin](https://www.npmjs.com/package/@contentstack/persistence-plugin) for options (`storeType`, `maxAge`, custom storage).
+
+### Development
+
+When contributing or running tests from the repository, run `npm run build` before running tests. The published package includes a pre-built `dist/` directory.
+
 ### Helpful Links
 
 - [Contentstack Website](https://www.contentstack.com)
@@ -140,7 +226,7 @@ const pagedResult = await query
 
 ### The MIT License (MIT)
 
-Copyright © 2012-2025 [Contentstack](https://www.contentstack.com). All Rights Reserved
+Copyright © 2012-2026 [Contentstack](https://www.contentstack.com). All Rights Reserved
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

config/tsconfig.cjs.json

@@ -0,0 +1,13 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "declaration": true,
+    "emitDeclarationOnly": true,
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "outDir": "../dist/modern",
+    "rootDir": "../src"
+  },
+  "include": ["../src/**/*.ts"],
+  "exclude": ["node_modules", "**/*.test.ts", "**/__test__"]
+}