refactor: reorganize file structure and enhance caching functionality

- Updated file paths in .talismanrc to reflect new directory structure.
- Introduced new classes for asset management and image transformation in the src/assets directory.
- Added caching utilities and error messages to improve cache handling.
- Enhanced README with updated instructions for cache policies and persistence store usage.
- Updated CHANGELOG to reflect changes in caching and file structure adjustments.

Author: nadeem-cs

.talismanrc

@@ -1,10 +1,10 @@
 fileignoreconfig:
 - filename: README.md
   checksum: b40240271f930e1c0db9bbcf78a55bf0d52d6caf0eb265eae94d1a2aecf442c5
-- filename: src/lib/types.ts
-  checksum: 0466775043773ec966f10bac2eeed812274748fc275a1017ad51295dff5c58ca
 - filename: test/unit/error-messages.spec.ts
-  checksum: abe5acafad0aa0464e36b2cc3576a3200e96d7292984a93cce5f24e14a2a6366
+  checksum: 186390727b2488317c49f22955ade58b454d4c00c6b850bbb0617c30c59f8255
+- filename: src/common/types.ts
+  checksum: 0466775043773ec966f10bac2eeed812274748fc275a1017ad51295dff5c58ca
 - filename: test/unit/contentstack.spec.ts
   checksum: 8f560efd9fba6e04682899eff3cc448d22c38019eac0a5ffcab35ba59f81da2c
 - filename: test/unit/cache.spec.ts
@@ -27,11 +27,11 @@ fileignoreconfig:
   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: src/lib/query.ts
+- filename: src/query/query.ts
   checksum: 073c47e46755eb79d1d7e9fcaf2864296a218bf650888dd37c42480cce7df379
 - filename: test/api/retry-integration.spec.ts
   checksum: dc07b0a8111fd8e155b99f56c31ccdddd4f46c86f1b162b17d73e15dfed8e3c8
@@ -40,19 +40,19 @@ fileignoreconfig:
 - filename: package-lock.json
   checksum: 993afd503e9f5d399fac30ae230cb47538cec2c61c5364e88be72726fb723dda
   ignore_detectors: [ base64, filecontent ]
-- filename: src/lib/global-field.ts
+- filename: src/global-field/global-field.ts
   checksum: 70b9652bcba16ddc4d853ac212ad909a8ecfc76f491c55a05e4e3cdf9ce476b5
-- filename: src/lib/content-type.ts
+- filename: src/content-type/content-type.ts
   checksum: 1dc0fa53ae209efb67d68a01493822e9dec560799f8309329213dae69459655f
-- filename: src/lib/stack.ts
+- filename: src/stack/stack.ts
   checksum: 145dd6add876a771a9a6ba024f57ef2c4b46a911fe1bf3885a69cf1f6c9dd72d
-- filename: src/lib/entry.ts
+- filename: src/entries/entry.ts
   checksum: 1c64ccf19226873d068d6896028bfb74546c1cfd993779515bccfcc747180ca0
-- filename: src/lib/error-messages.ts
+- filename: src/common/error-messages.ts
   checksum: 3b960af19f3ba302522e912616b147b11d63dfe3f7ad2e0cf2de807815ee236a
-- filename: src/lib/global-field-query.ts
+- filename: src/query/global-field-query.ts
   checksum: 824c54061b80236380e776640e7f52f45164230bcc0ee88de302b30e9f83297f
-- filename: src/lib/base-query.ts
+- filename: src/query/base-query.ts
   checksum: 8d67435121581d43ba9c5f544daf30a0579b7faa7c8661000d8d37ddfc172112
 - filename: test/unit/base-query.spec.ts
   checksum: ceaceb1d65965b151edc9fc11d5a226460328b1913319994df51ca1b453cd6af

CHANGELOG.md

@@ -1,7 +1,7 @@
 ### Version: 5.0.0
-#### Date: Jan-30-2026
-Breaking: Cache persistence is now a separate plugin. When using a cache policy other than `IGNORE_CACHE`, you must pass `cacheOptions.persistanceStore`. Install `@contentstack/delivery-sdk-persistence` and use `new PersistanceStore({ ... })` as the store. The SDK no longer bundles persistence code or accepts `storeType` in `cacheOptions`.
-Enhancement: SDK defines only the `PersistanceStore` interface (getItem/setItem); full implementation lives in the plugin for a lighter core package.
+#### 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.
 
 ### Version: 4.11.0
 #### Date: Jan-19-2026

README.md

@@ -191,28 +191,28 @@ 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.persistanceStore`. Install the optional persistence plugin and pass a `PersistanceStore` instance:
+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/delivery-sdk-persistence
+npm install @contentstack/persistence-plugin
 ```
 
 ```typescript
 import contentstack, { Policy } from '@contentstack/delivery-sdk';
-import { PersistanceStore } from '@contentstack/delivery-sdk-persistence';
+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,
-    persistanceStore: new PersistanceStore({ storeType: 'localStorage', maxAge: 86400000 }),
+    persistenceStore: new PersistenceStore({ storeType: 'localStorage', maxAge: 86400000 }),
   },
 });
 ```
 
-See [@contentstack/delivery-sdk-persistence](https://www.npmjs.com/package/@contentstack/delivery-sdk-persistence) for options (`storeType`, `maxAge`, custom storage).
+See [@contentstack/persistence-plugin](https://www.npmjs.com/package/@contentstack/persistence-plugin) for options (`storeType`, `maxAge`, custom storage).
 
 ### Development
 
@@ -226,7 +226,7 @@ When contributing or running tests from the repository, run `npm run build` befo
 
 ### 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:
 

package-lock.json

@@ -9,8 +9,11 @@
  * Usage: node scripts/validate-browser-safe.js
  */
 
-const fs = require('fs');
-const path = require('path');
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 // ANSI color codes for pretty output
 const colors = {

scripts/validate-browser-safe.js

@@ -1,5 +1,4 @@
 /* eslint-disable @cspell/spellchecker */
-import './string-extensions';
 import {
   CanvasBy,
   CropBy,
@@ -10,7 +9,7 @@ import {
   OverlayRepeat,
   ResizeFilter,
   TransformData,
-} from './types';
+} from '../common/types';
 
 export class ImageTransform {
   obj: TransformData = {};

src/lib/asset.ts src/assets/asset.tssrc/lib/asset.ts renamed to src/assets/asset.ts

@@ -0,0 +1,2 @@
+export { Asset } from './asset';
+export { ImageTransform } from './image-transform';

src/lib/image-transform.ts src/assets/image-transform.tssrc/lib/image-transform.ts renamed to src/assets/image-transform.ts

@@ -1,5 +1,5 @@
-import { CacheOptions, Policy } from './types';
-import { ErrorMessages } from './error-messages';
+import { CacheOptions, Policy } from '../common/types';
+import { ErrorMessages } from '../common/error-messages';
 
 /**
  * Extracts entry UID from request URL if available
@@ -55,10 +55,10 @@ export async function handleRequest(
   reject: any,
   config: any
 ) {
-  if (!cacheOptions.persistanceStore) {
-    throw new Error(ErrorMessages.MISSING_PERSISTANCE_STORE);
+  if (!cacheOptions.persistenceStore) {
+    throw new Error(ErrorMessages.MISSING_PERSISTENCE_STORE);
   }
-  const cacheStore = cacheOptions.persistanceStore;
+  const cacheStore = cacheOptions.persistenceStore;
 
   // Extract entry UID from URL or config
   const entryUid = config.entryUid || extractEntryUidFromUrl(config);
@@ -133,4 +133,4 @@ export async function handleRequest(
       }
     }
   }
-}
+}

src/assets/index.ts

@@ -15,8 +15,8 @@ export const ErrorMessages = {
   INVALID_ARGUMENT_STRING_OR_ARRAY: 'Invalid argument. Provide a string or an array and try again.',
 
   // Cache persistence errors
-  MISSING_PERSISTANCE_STORE:
-    'Cache policy requires cacheOptions.persistanceStore (storage). Install @contentstack/delivery-sdk-persistence and pass a PersistanceStore instance and try again.',
+  MISSING_PERSISTENCE_STORE:
+    'Cache policy requires cacheOptions.persistenceStore (storage). Install @contentstack/persistence-plugin and pass a PersistenceStore instance and try again.',
 
   // Regex validation errors
   INVALID_REGEX_PATTERN: 'Invalid regexPattern: Must be a valid regular expression',
@@ -41,4 +41,3 @@ export enum ErrorCode {
   INVALID_REGEX = 'INVALID_REGEX',
   SLACK_ERROR = 'SLACK_ERROR',
 }
-