enh: replace @timbenniks/contentstack-endpoints with @contentstack/utils

.env.example

@@ -2,5 +2,5 @@ NEXT_PUBLIC_CONTENTSTACK_API_KEY=your_api_key_here
 NEXT_PUBLIC_CONTENTSTACK_DELIVERY_TOKEN=your_delivery_token_here
 NEXT_PUBLIC_CONTENTSTACK_PREVIEW_TOKEN=your_preview_token_here
 NEXT_PUBLIC_CONTENTSTACK_ENVIRONMENT=preview
-NEXT_PUBLIC_CONTENTSTACK_REGION=EU
+NEXT_PUBLIC_CONTENTSTACK_REGION=EU # Options: NA, EU, AU, AZURE-NA, AZURE-EU, GCP-NA, GCP-EU
 NEXT_PUBLIC_CONTENTSTACK_PREVIEW=true 

README.md

@@ -73,6 +73,49 @@ NEXT_PUBLIC_CONTENTSTACK_ENVIRONMENT=preview
 NEXT_PUBLIC_CONTENTSTACK_PREVIEW=true
 ```
 
+
+## Regions and endpoint configuration
+
+Set `NEXT_PUBLIC_CONTENTSTACK_REGION` to the region your Contentstack account is on. The value is case-insensitive.
+
+| Region | Value |
+|---|---|
+| AWS North America | `NA` or `US` |
+| AWS Europe | `EU` |
+| AWS Australia | `AU` |
+| Azure North America | `AZURE-NA` |
+| Azure Europe | `AZURE-EU` |
+| GCP North America | `GCP-NA` |
+| GCP Europe | `GCP-EU` |
+
+> Not sure which region you're on? Check your Contentstack dashboard URL — `eu-app.contentstack.com` means EU, `app.contentstack.com` means NA. Free developer accounts are on EU.
+
+All API endpoints (content delivery, live preview, Visual Builder) are automatically resolved from your region. You do not need to set them manually.
+
+The following endpoint keys are resolved per region and available if you ever need them directly via `getContentstackEndpoint` from `@contentstack/utils`:
+
+| Key | NA value |
+|---|---|
+| `contentDelivery` | `cdn.contentstack.io` |
+| `preview` | `rest-preview.contentstack.com` |
+| `application` | `app.contentstack.com` |
+| `graphqlDelivery` | `graphql.contentstack.com` |
+| `graphqlPreview` | `graphql-preview.contentstack.com` |
+| `images` | `images.contentstack.io` |
+| `assets` | `assets.contentstack.io` |
+| `contentManagement` | `api.contentstack.io` |
+| `auth` | `auth-api.contentstack.com` |
+
+### Custom or dedicated environments
+
+If your Contentstack account runs on a dedicated or private cloud instance, the standard region-based endpoints may not apply. In that case, override each endpoint individually using these environment variables. **Only set these if instructed by Contentstack support — standard accounts should leave them unset.**
+
+```bash
+NEXT_PUBLIC_CONTENTSTACK_CONTENT_DELIVERY=your-custom-cdn.example.com
+NEXT_PUBLIC_CONTENTSTACK_PREVIEW_HOST=your-custom-preview.example.com
+NEXT_PUBLIC_CONTENTSTACK_CONTENT_APPLICATION=your-custom-app.example.com
+```
+
 ## Turn on Live Preview
 
 Go to Settings > Live Preview. Click enable and select the `Preview` environment in the drop down. Hit save.

lib/contentstack.ts

@@ -1,26 +1,25 @@
 import contentstack, { QueryOperation } from "@contentstack/delivery-sdk"
 import ContentstackLivePreview, { IStackSdk } from "@contentstack/live-preview-utils";
 import { Page } from "./types";
-import { getContentstackEndpoints, getRegionForString } from "@timbenniks/contentstack-endpoints";
+import { getContentstackEndpoint, type ContentstackEndpoints } from "@contentstack/utils";
 
-const region = getRegionForString(process.env.NEXT_PUBLIC_CONTENTSTACK_REGION as string)
-const endpoints = getContentstackEndpoints(process.env.NEXT_PUBLIC_CONTENTSTACK_REGION, true)
+const endpoints = getContentstackEndpoint(process.env.NEXT_PUBLIC_CONTENTSTACK_REGION || 'NA', '', true) as ContentstackEndpoints
 
 export const stack = contentstack.stack({
   apiKey: process.env.NEXT_PUBLIC_CONTENTSTACK_API_KEY as string,
   deliveryToken: process.env.NEXT_PUBLIC_CONTENTSTACK_DELIVERY_TOKEN as string,
   environment: process.env.NEXT_PUBLIC_CONTENTSTACK_ENVIRONMENT as string,
-  region: region ? region : process.env.NEXT_PUBLIC_CONTENTSTACK_REGION as any,
+  region: process.env.NEXT_PUBLIC_CONTENTSTACK_REGION as any,
   // Setting the host for content delivery based on the region or environment variables
-  // This is done for internal testing purposes at Contentstack, you can omit this if you have set a region above.
-  host: process.env.NEXT_PUBLIC_CONTENTSTACK_CONTENT_DELIVERY || endpoints && endpoints.contentDelivery,
+  // for custom or dedicated Contentstack environments, override each endpoint individually using environment variables.
+  host: process.env.NEXT_PUBLIC_CONTENTSTACK_CONTENT_DELIVERY || endpoints.contentDelivery as string,
 
   live_preview: {
     enable: process.env.NEXT_PUBLIC_CONTENTSTACK_PREVIEW === 'true',
     preview_token: process.env.NEXT_PUBLIC_CONTENTSTACK_PREVIEW_TOKEN,
     // Setting the host for live preview based on the region
-    // for internal testing purposes at Contentstack we look for a custom host in the env vars, you do not have to do this.
-    host: process.env.NEXT_PUBLIC_CONTENTSTACK_PREVIEW_HOST || endpoints && endpoints.preview
+    // for custom or dedicated Contentstack environments, override each endpoint individually using environment variables.
+    host: process.env.NEXT_PUBLIC_CONTENTSTACK_PREVIEW_HOST || endpoints.preview as string
   }
 });
 
@@ -36,8 +35,8 @@ export function initLivePreview() {
     },
     clientUrlParams: {
       // Setting the client URL parameters for live preview
-      // for internal testing purposes at Contentstack we look for a custom host in the env vars, you do not have to do this.
-      host: process.env.NEXT_PUBLIC_CONTENTSTACK_CONTENT_APPLICATION || endpoints && endpoints.application
+      // for custom or dedicated Contentstack environments, override each endpoint individually using environment variables.
+      host: process.env.NEXT_PUBLIC_CONTENTSTACK_CONTENT_APPLICATION || endpoints.application as string
     },
     editButton: {
       enable: true,