feat: comprehensive integration test suite with 737 tests

.gitignore

@@ -13,4 +13,6 @@ coverage
 .env
 .dccache
 dist/*
-*.log
+*.log
+docs-internal/
+talisman_report

.talismanrc

@@ -1,40 +1,56 @@
 fileignoreconfig:
-  - filename: index.d.ts
-    checksum: 22c6a7fe4027d6b2c9adf0cbeb9c525ab79b15210b07ec5189693992e6800a66
-  - filename: test/typescript/stack.test.ts
-    checksum: 50b764c0ca6f6f27d7306a4e54327bef9b178e8436c6e3fad0d67d77343d10b3
-  - filename: .github/workflows/secrets-scan.yml
-    checksum: d79ec3f3288964f7d117b9ad319a54c0ebc152e35f69be8fde95522034fdfb2a
-  - filename: package-lock.json
-    checksum: c7c4feda727fae78c6fa03665b1d8f2a6363060631dd57b475f09307991ad305
-  - filename: src/core/modules/assets.js
-    checksum: 00f19d659b830b0f145b4db0ccf3211a4048d9488f30a224fe3c31cacca6dcd2
-  - filename: .husky/pre-commit
-    checksum: 52a664f536cf5d1be0bea19cb6031ca6e8107b45b6314fe7d47b7fad7d800632
-  - filename: src/core/cache.js
-    checksum: 85025b63df8db4a3f94ace5c7f088ea0e4d55eb8324d2265ea4a470b0c610fce
-  - filename: src/core/cache-provider/localstorage.js
-    checksum: 33266a67a003b665957e4a445e821b9295632cff75be0a71baf35b3576c55aa4
-  - filename: src/core/modules/entry.js
-    checksum: 49d6742d014ce111735611ebab16dc8c888ce8d678dfbc99620252257e780ec5
-  - filename: src/core/contentstack.js
-    checksum: 22e723507c1fed8b3175b57791f4249889c9305b79e5348d59d741bdf4f006ba
-  - filename: test/config.js
-    checksum: 4ada746af34f2868c038f53126c08c21d750ddbd037d0a62e88824dd5d9e20be
-  - filename: test/live-preview/live-preview-test.js
-    checksum: d742465789e00a17092a7e9664adda4342a13bc4975553371a26df658f109952
-  - filename: src/core/lib/request.js
-    checksum: 040f4fd184a96c57d0eb9e7134ae6ff65f8e9039c38c852c9a0f00825b4c69f1
-  - filename: test/sync/sync-testcases.js
-    checksum: 391b557a147c658a50256b49dcdd20fd053eb32966e9244d98c93142e4dcbf2e
-  - filename: src/core/modules/taxonomy.js
-    checksum: 115e63b4378809b29a037e2889f51e300edfd18682b3b6c0a4112c270fc32526
-  - filename: src/core/modules/query.js
-    checksum: aa6596a353665867586d00cc64225f0dea7edacc3bcfab60002a5727bd927132
-  - filename: src/core/stack.js
-    checksum: a467e56edcb43858512c47bd82c76dbf8799d57837f03c247e2cebe27ca5eaa8
-  - filename: src/core/lib/utils.js
-    checksum: 7ae53c3be5cdcd1468d66577c9450adc53e9c6aaeaeabc4275e87a47aa709850
-  - filename: src/core/messages.js
-    checksum: 2ea5e1ecac5bc143da22c4e0a675d31f587dc907312c05bcace020cb7f76165c
-version: ""
+- filename: test/integration/EntryTests/SingleEntryFetch.test.js
+  checksum: 54015a61d1c3ceb1c6f3e720164e6aa1d2b21aa796c7ad7f90133b18b69127cd
+- filename: test/integration/GlobalFieldsTests/SEOGlobalField.test.js
+  checksum: c5df5b9fa8756ced5f37879dff17aa0f31f50fd64470195064e0b22450cde29d
+- filename: test/integration/QueryTests/FieldProjection.test.js
+  checksum: 9a15e9a222a18b99881218abbe6b82012bb663137cca179a63858698127e0aba
+- filename: test/integration/LivePreviewTests/LivePreview.test.js
+  checksum: dba41fa432524189234a3d0ec35885a8e5c51904b3114853a41b1ec3899ad4cb
+- filename: test/config.js
+  checksum: b249021c7de18f76039fdb393e8d74ce476acdd3861bac58965500f2b1a42b2e
+- filename: test/integration/GlobalFieldsTests/ContentBlockGlobalField.test.js
+  checksum: 8d2bc8cb6661336b57397649259f7e12786256706019efb644f133b336629d96
+- filename: test/integration/GlobalFieldsTests/NestedGlobalField.test.js
+  checksum: 1ba81e7a400fd02c5d66170bdd5b2419a8932963dd00c5635d754c89ab5daeba
+- filename: test/integration/NetworkResilienceTests/RetryLogic.test.js
+  checksum: 3b5fe23398bdc2327848b3caa95339e51a0aed059c1eb299e78d3dd215ecbd30
+- filename: test/integration/QueryTests/ExistsSearchOperators.test.js
+  checksum: 9b1cec59275ba72fe4b753e956c5b24b237d24d12819434ab65109075cf50f86
+- filename: index.d.ts
+  checksum: 22c6a7fe4027d6b2c9adf0cbeb9c525ab79b15210b07ec5189693992e6800a66
+- filename: test/typescript/stack.test.ts
+  checksum: 50b764c0ca6f6f27d7306a4e54327bef9b178e8436c6e3fad0d67d77343d10b3
+- filename: .github/workflows/secrets-scan.yml
+  checksum: d79ec3f3288964f7d117b9ad319a54c0ebc152e35f69be8fde95522034fdfb2a
+- filename: package-lock.json
+  checksum: 3d18d543ed9c7b87bcfca8f7af99bb3058ffa67b84a1ff888623686a84d06672
+- filename: src/core/modules/assets.js
+  checksum: 00f19d659b830b0f145b4db0ccf3211a4048d9488f30a224fe3c31cacca6dcd2
+- filename: .husky/pre-commit
+  checksum: 52a664f536cf6d1be0bea19cb6031ca6e8107b45b6314fe7d47b7fad7d800632
+- filename: src/core/cache.js
+  checksum: 85025b63df8db4a3f94ace5c7f088ea0e4d55eb8324d2265ea4a470b0c610ce
+- filename: src/core/cache-provider/localstorage.js
+  checksum: 33266a67a003b665957e4a445e821b9295632cff75be0a71baf35b3576c55aa4
+- filename: src/core/modules/entry.js
+  checksum: 49d6742d014ce111735611ebab16dc8c888ce8d678dfbc99620252257e780ec5
+- filename: src/core/contentstack.js
+  checksum: 22e723507c1fed8b3175b57791f4249889c9305b79e5348d59d741bdf4f006ba
+- filename: test/live-preview/live-preview-test.js
+  checksum: d742465789e00a17092a7e9664adda4342a13bc4975553371a26df658f109952
+- filename: src/core/lib/request.js
+  checksum: 775c2e74b4135747600a3f34535f97f7dcbf822e4d2dc68568f5b227d499fdbb
+- filename: test/sync/sync-testcases.js
+  checksum: 391b557a147c658a50256b49dcdd20fd053eb32966e9244d98c93142e4dcbf2e
+- filename: src/core/modules/taxonomy.js
+  checksum: 115e63b4378809b29a037e2889f51e300edfd18682b3b6c0a4112c270fc32526
+- filename: src/core/modules/query.js
+  checksum: aa6596a353665867586d00cc64225f0dea7edacc3bcfab60002a5727bd927132
+- filename: src/core/stack.js
+  checksum: a467e56edcb43858512c47bd82c76dbf8799d57837f03c247e2cebe27ca5eaa8
+- filename: src/core/lib/utils.js
+  checksum: 7ae53c3be5cdcd1468d66577c9450adc53e9c6aaeaeabc4275e87a47aa709850
+- filename: src/core/messages.js
+  checksum: 2ea5e1ecac5bc143da22c4e0a675d31f587dc907312c05bcace020cb7f76165c
+version: "1.0"

jest.js.config.js

@@ -1,11 +1,12 @@
 module.exports = {
   testEnvironment: "node",
-  testMatch: ["**/test/**/*.js"],
+  testMatch: ["**/test/integration/**/*.test.js"],
   testPathIgnorePatterns: [
     "/node_modules/",
     "/test/index.js",
     "/test/config.js",
     "/test/sync_config.js",
+    "/test/helpers/",
     "/test/.*/utils.js",
   ],
   reporters: ["default", ["jest-html-reporters",

test/config.js

@@ -12,10 +12,96 @@ if (missingVars.length > 0) {
 }
 
 module.exports = {
-  stack: { api_key: process.env.API_KEY, delivery_token: process.env.DELIVERY_TOKEN, environment: process.env.ENVIRONMENT },
+  // Stack configuration
+  stack: {
+    api_key: process.env.API_KEY,
+    delivery_token: process.env.DELIVERY_TOKEN,
+    environment: process.env.ENVIRONMENT,
+    branch: process.env.BRANCH_UID || 'main' // Branch is part of Stack config
+  },
   host: process.env.HOST,
+
+  // Additional tokens for comprehensive tests
+  managementToken: process.env.MANAGEMENT_TOKEN,
+  previewToken: process.env.PREVIEW_TOKEN,
+  livePreviewHost: process.env.LIVE_PREVIEW_HOST,
+
+  // Branch configuration (also available separately for reference)
+  branch: process.env.BRANCH_UID || 'main',
+
+  // LEGACY content types (keep for backward compatibility)
   contentTypes: {
     source: 'source',
     numbers_content_type: 'numbers_content_type'
+  },
+
+  // Content Types (UIDs from environment variables)
+  complexContentTypes: {
+    // Complexity level shortcuts
+    complex: process.env.COMPLEX_CONTENT_TYPE_UID,
+    medium: process.env.MEDIUM_CONTENT_TYPE_UID,
+    simple: process.env.SIMPLE_CONTENT_TYPE_UID,
+    selfReferencing: process.env.SELF_REF_CONTENT_TYPE_UID,
+
+    // Generic content type names (all values from env vars, keys are generic)
+    article: process.env.MEDIUM_CONTENT_TYPE_UID,
+    author: process.env.SIMPLE_CONTENT_TYPE_UID,
+    cybersecurity: process.env.COMPLEX_CONTENT_TYPE_UID,
+    section_builder: process.env.SELF_REF_CONTENT_TYPE_UID, // Alias for selfReferencing
+    page_builder: 'page_builder' // Standard content type for modular blocks testing
+  },
+
+  // Test Entry UIDs (all from environment variables)
+  testEntries: {
+    complex: process.env.COMPLEX_ENTRY_UID,
+    medium: process.env.MEDIUM_ENTRY_UID,
+    simple: process.env.SIMPLE_ENTRY_UID,
+    selfReferencing: process.env.SELF_REF_ENTRY_UID,
+    complexBlocks: process.env.COMPLEX_BLOCKS_ENTRY_UID
+  },
+
+  // Variant configuration
+  variants: {
+    variantUID: process.env.VARIANT_UID
+  },
+
+  // Asset configuration
+  assets: {
+    imageUID: process.env.IMAGE_ASSET_UID
+  },
+
+  // Taxonomy configuration (generic country-based taxonomies with terms from .env)
+  taxonomies: {
+    usa: {
+      uid: 'usa',
+      term: process.env.TAX_USA_STATE
+    },
+    india: {
+      uid: 'india',
+      term: process.env.TAX_INDIA_STATE
+    }
+  },
+
+  // Locale configurations (standard/common locale codes)
+  locales: {
+    primary: 'en-us',
+    secondary: 'fr-fr',
+    japanese: 'ja-jp'
+  },
+
+  // Global field UIDs (values from environment variables, keys are descriptive)
+  // Supports both old naming (GLOBAL_FIELD_SIMPLE) and new naming (SIMPLE_GLOBAL_FIELD_UID)
+  globalFields: {
+    seo: process.env.GLOBAL_FIELD_SIMPLE || process.env.GLOBAL_FIELD_UID || process.env.SIMPLE_GLOBAL_FIELD_UID, // Simple global field
+    gallery: process.env.GLOBAL_FIELD_MEDIUM || process.env.MEDIUM_GLOBAL_FIELD_UID, // Medium complexity
+    content_block: process.env.GLOBAL_FIELD_COMPLEX || process.env.COMPLEX_GLOBAL_FIELD_UID, // Complex global field
+    video_experience: process.env.GLOBAL_FIELD_VIDEO, // Video field
+    referenced_data: 'referenced_data', // Generic field name (optional)
+    nested: process.env.NESTED_GLOBAL_FIELD_UID // Nested global field (parent)
+  },
+
+  // Reference field name (generic/common field name)
+  referenceFields: {
+    author: 'author'
   }
 };