@timbenniks/contentstack-platform-sdk 0.1.0

package/dist/react/provider/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/react/provider/index.ts","../../../src/react/provider/ContentstackProvider.tsx","../../../src/react/provider/context.ts"],"sourcesContent":["export { ContentstackProvider, type ContentstackProviderProps } from \"./ContentstackProvider\"\nexport {\n  useContentstackContext,\n  type ContentstackContextValue,\n} from \"./context\"\n","\"use client\"\n\nimport { useMemo } from \"react\"\nimport type { ContentstackRegion } from \"../../index.js\"\nimport { ContentstackContext, type ContentstackContextValue } from \"./context\"\n\nexport interface ContentstackProviderProps {\n  region: ContentstackRegion\n  proxyBasePath?: string\n  apiKey?: string\n  organizationUid?: string\n  brandKitUid?: string\n  launchProxyBasePath?: string\n  brandKitProxyBasePath?: string\n  children: React.ReactNode\n}\n\nexport function ContentstackProvider({\n  region,\n  proxyBasePath = \"/api/cma\",\n  apiKey,\n  organizationUid,\n  brandKitUid,\n  launchProxyBasePath = \"/api/launch\",\n  brandKitProxyBasePath = \"/api/brandkit\",\n  children,\n}: ContentstackProviderProps): React.JSX.Element {\n  const value = useMemo<ContentstackContextValue>(\n    () => ({\n      region,\n      proxyBasePath,\n      apiKey,\n      organizationUid,\n      brandKitUid,\n      launchProxyBasePath,\n      brandKitProxyBasePath,\n    }),\n    [\n      region,\n      proxyBasePath,\n      apiKey,\n      organizationUid,\n      brandKitUid,\n      launchProxyBasePath,\n      brandKitProxyBasePath,\n    ],\n  )\n\n  return <ContentstackContext.Provider value={value}>{children}</ContentstackContext.Provider>\n}\n","\"use client\"\n\nimport { createContext, useContext } from \"react\"\nimport type { ContentstackRegion } from \"../../index.js\"\n\nexport interface ContentstackContextValue {\n  region: ContentstackRegion\n  proxyBasePath: string\n  apiKey?: string\n  organizationUid?: string\n  brandKitUid?: string\n  launchProxyBasePath?: string\n  brandKitProxyBasePath?: string\n}\n\nexport const ContentstackContext = createContext<ContentstackContextValue | null>(null)\n\n/**\n * Hook to access the Contentstack context.\n * Throws a clear error if used outside of ContentstackProvider.\n */\nexport function useContentstackContext(): ContentstackContextValue {\n  const ctx = useContext(ContentstackContext)\n  if (!ctx) {\n    throw new Error(\n      \"useContentstackContext must be used within a <ContentstackProvider>. \" +\n        'Wrap your app with <ContentstackProvider region=\"...\" proxyBasePath=\"/api/cma\">.',\n    )\n  }\n  return ctx\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,IAAAA,gBAAwB;;;ACAxB,mBAA0C;AAanC,IAAM,0BAAsB,4BAA+C,IAAI;AAM/E,SAAS,yBAAmD;AACjE,QAAM,UAAM,yBAAW,mBAAmB;AAC1C,MAAI,CAAC,KAAK;AACR,UAAM,IAAI;AAAA,MACR;AAAA,IAEF;AAAA,EACF;AACA,SAAO;AACT;;;ADkBS;AA/BF,SAAS,qBAAqB;AAAA,EACnC;AAAA,EACA,gBAAgB;AAAA,EAChB;AAAA,EACA;AAAA,EACA;AAAA,EACA,sBAAsB;AAAA,EACtB,wBAAwB;AAAA,EACxB;AACF,GAAiD;AAC/C,QAAM,YAAQ;AAAA,IACZ,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,SAAO,4CAAC,oBAAoB,UAApB,EAA6B,OAAe,UAAS;AAC/D;","names":["import_react"]}

package/dist/react/provider/index.d.cts

@@ -0,0 +1,30 @@
+import { ContentstackRegion } from '../../regions/index.cjs';
+
+interface ContentstackProviderProps {
+    region: ContentstackRegion;
+    proxyBasePath?: string;
+    apiKey?: string;
+    organizationUid?: string;
+    brandKitUid?: string;
+    launchProxyBasePath?: string;
+    brandKitProxyBasePath?: string;
+    children: React.ReactNode;
+}
+declare function ContentstackProvider({ region, proxyBasePath, apiKey, organizationUid, brandKitUid, launchProxyBasePath, brandKitProxyBasePath, children, }: ContentstackProviderProps): React.JSX.Element;
+
+interface ContentstackContextValue {
+    region: ContentstackRegion;
+    proxyBasePath: string;
+    apiKey?: string;
+    organizationUid?: string;
+    brandKitUid?: string;
+    launchProxyBasePath?: string;
+    brandKitProxyBasePath?: string;
+}
+/**
+ * Hook to access the Contentstack context.
+ * Throws a clear error if used outside of ContentstackProvider.
+ */
+declare function useContentstackContext(): ContentstackContextValue;
+
+export { type ContentstackContextValue, ContentstackProvider, type ContentstackProviderProps, useContentstackContext };

package/dist/react/provider/index.d.ts

@@ -0,0 +1,30 @@
+import { ContentstackRegion } from '../../regions/index.js';
+
+interface ContentstackProviderProps {
+    region: ContentstackRegion;
+    proxyBasePath?: string;
+    apiKey?: string;
+    organizationUid?: string;
+    brandKitUid?: string;
+    launchProxyBasePath?: string;
+    brandKitProxyBasePath?: string;
+    children: React.ReactNode;
+}
+declare function ContentstackProvider({ region, proxyBasePath, apiKey, organizationUid, brandKitUid, launchProxyBasePath, brandKitProxyBasePath, children, }: ContentstackProviderProps): React.JSX.Element;
+
+interface ContentstackContextValue {
+    region: ContentstackRegion;
+    proxyBasePath: string;
+    apiKey?: string;
+    organizationUid?: string;
+    brandKitUid?: string;
+    launchProxyBasePath?: string;
+    brandKitProxyBasePath?: string;
+}
+/**
+ * Hook to access the Contentstack context.
+ * Throws a clear error if used outside of ContentstackProvider.
+ */
+declare function useContentstackContext(): ContentstackContextValue;
+
+export { type ContentstackContextValue, ContentstackProvider, type ContentstackProviderProps, useContentstackContext };

package/dist/react/provider/index.mjs

@@ -0,0 +1,11 @@
+import {
+  ContentstackProvider
+} from "../../chunk-ARPJDW3A.mjs";
+import {
+  useContentstackContext
+} from "../../chunk-K76DKSHJ.mjs";
+export {
+  ContentstackProvider,
+  useContentstackContext
+};
+//# sourceMappingURL=index.mjs.map

package/dist/react/provider/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/regions/index.cjs

@@ -0,0 +1,171 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/regions/index.ts
+var regions_exports = {};
+__export(regions_exports, {
+  normalizeRegion: () => normalizeRegion,
+  resolveEndpoints: () => resolveEndpoints,
+  resolveHosts: () => resolveHosts
+});
+module.exports = __toCommonJS(regions_exports);
+
+// src/http/errors.ts
+var ContentstackError = class extends Error {
+  name = "ContentstackError";
+  status;
+  errorCode;
+  errors;
+  requestPath;
+  constructor(message, options) {
+    super(message, options?.cause ? { cause: options.cause } : void 0);
+    this.status = options?.status;
+    this.errorCode = options?.errorCode;
+    this.errors = options?.errors;
+    this.requestPath = options?.requestPath;
+  }
+};
+var ContentstackConfigError = class extends ContentstackError {
+  name = "ContentstackConfigError";
+};
+
+// src/regions/endpoints.ts
+var import_contentstack_endpoints = require("@timbenniks/contentstack-endpoints");
+var BRAND_KIT_URLS = {
+  us: {
+    brandKit: "https://brand-kits-api.contentstack.com",
+    brandKitAI: "https://ai.contentstack.com/brand-kits"
+  },
+  eu: {
+    brandKit: "https://eu-brand-kits-api.contentstack.com",
+    brandKitAI: "https://eu-ai.contentstack.com/brand-kits"
+  },
+  au: {
+    brandKit: "https://au-brand-kits-api.contentstack.com",
+    brandKitAI: "https://au-ai.contentstack.com/brand-kits"
+  },
+  "azure-na": {
+    brandKit: "https://azure-na-brand-kits-api.contentstack.com",
+    brandKitAI: "https://azure-na-ai.contentstack.com/brand-kits"
+  },
+  "azure-eu": {
+    brandKit: "https://azure-eu-brand-kits-api.contentstack.com",
+    brandKitAI: "https://azure-eu-ai.contentstack.com/brand-kits"
+  },
+  "gcp-na": {
+    brandKit: "https://gcp-na-brand-kits-api.contentstack.com",
+    brandKitAI: "https://gcp-na-ai.contentstack.com/brand-kits"
+  },
+  "gcp-eu": {
+    brandKit: "https://gcp-eu-brand-kits-api.contentstack.com",
+    brandKitAI: "https://gcp-eu-ai.contentstack.com/brand-kits"
+  }
+};
+function mapEndpoints(upstream, region, hostsOnly) {
+  const bk = BRAND_KIT_URLS[region];
+  const stripProtocol = (url) => url.replace(/^https?:\/\//, "");
+  return Object.freeze({
+    cma: upstream.contentManagement ?? "",
+    cda: upstream.contentDelivery ?? "",
+    graphql: upstream.graphqlDelivery ?? "",
+    images: upstream.images ?? "",
+    app: upstream.application ?? "",
+    preview: upstream.preview ?? "",
+    graphqlPreview: upstream.graphqlPreview ?? "",
+    launch: upstream.launch ?? "",
+    personalizeEdge: upstream.personalizeEdge ?? "",
+    brandKit: hostsOnly ? stripProtocol(bk.brandKit) : bk.brandKit,
+    brandKitAI: hostsOnly ? stripProtocol(bk.brandKitAI) : bk.brandKitAI
+  });
+}
+var ALL_REGIONS = [
+  "us",
+  "eu",
+  "au",
+  "azure-na",
+  "azure-eu",
+  "gcp-na",
+  "gcp-eu"
+];
+function buildEndpointMap() {
+  const map = {};
+  for (const region of ALL_REGIONS) {
+    map[region] = mapEndpoints((0, import_contentstack_endpoints.getContentstackEndpoints)(region), region, false);
+  }
+  return Object.freeze(map);
+}
+function buildHostMap() {
+  const map = {};
+  for (const region of ALL_REGIONS) {
+    map[region] = mapEndpoints((0, import_contentstack_endpoints.getContentstackEndpoints)(region, true), region, true);
+  }
+  return Object.freeze(map);
+}
+var ENDPOINT_MAP = buildEndpointMap();
+var HOST_MAP = buildHostMap();
+function isValidRegion(input) {
+  return (0, import_contentstack_endpoints.getRegionForString)(input) !== void 0;
+}
+var EXTRA_ALIASES = {
+  "north-america": "us",
+  europe: "eu",
+  australia: "au"
+};
+
+// src/regions/resolver.ts
+var VALID_REGIONS = new Set(Object.keys(ENDPOINT_MAP));
+function resolveEndpoints(region) {
+  return ENDPOINT_MAP[region];
+}
+function resolveHosts(region) {
+  return HOST_MAP[region];
+}
+function normalizeRegion(input) {
+  const lower = input.toLowerCase().trim();
+  if (VALID_REGIONS.has(lower)) {
+    return lower;
+  }
+  const extraAlias = EXTRA_ALIASES[lower];
+  if (extraAlias) {
+    return extraAlias;
+  }
+  if (isValidRegion(lower)) {
+    if (lower === "na" || lower === "aws-na" || lower === "aws_na") return "us";
+    if (lower === "aws-eu" || lower === "aws_eu") return "eu";
+    if (lower === "aws-au" || lower === "aws_au") return "au";
+    if (lower === "azure_na") return "azure-na";
+    if (lower === "azure_eu") return "azure-eu";
+    if (lower === "gcp_na") return "gcp-na";
+    if (lower === "gcp_eu") return "gcp-eu";
+  }
+  const validRegions = [...VALID_REGIONS].join(", ");
+  const validAliases = [...Object.keys(EXTRA_ALIASES), "na", "aws-na", "aws-eu", "aws-au"].join(
+    ", "
+  );
+  throw new ContentstackConfigError(
+    `Unknown region "${input}". Valid regions: ${validRegions}. Aliases: ${validAliases}.`
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  normalizeRegion,
+  resolveEndpoints,
+  resolveHosts
+});
+//# sourceMappingURL=index.cjs.map

package/dist/regions/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/regions/index.ts","../../src/http/errors.ts","../../src/regions/endpoints.ts","../../src/regions/resolver.ts"],"sourcesContent":["export type { ContentstackRegion, ContentstackEndpoints } from \"./resolver.js\"\nexport { resolveEndpoints, resolveHosts, normalizeRegion } from \"./resolver.js\"\n","/**\n * Base error class for all Contentstack SDK errors.\n * Every error includes an actionable message and relevant context.\n */\nexport class ContentstackError extends Error {\n  override readonly name: string = \"ContentstackError\"\n  readonly status?: number\n  readonly errorCode?: number\n  readonly errors?: Record<string, string[]>\n  readonly requestPath?: string\n\n  constructor(\n    message: string,\n    options?: {\n      status?: number\n      errorCode?: number\n      errors?: Record<string, string[]>\n      requestPath?: string\n      cause?: Error\n    },\n  ) {\n    super(message, options?.cause ? { cause: options.cause } : undefined)\n    this.status = options?.status\n    this.errorCode = options?.errorCode\n    this.errors = options?.errors\n    this.requestPath = options?.requestPath\n  }\n}\n\nexport class ContentstackAuthError extends ContentstackError {\n  override readonly name = \"ContentstackAuthError\"\n  override readonly status = 401\n}\n\nexport class ContentstackForbiddenError extends ContentstackError {\n  override readonly name = \"ContentstackForbiddenError\"\n  override readonly status = 403\n}\n\nexport class ContentstackNotFoundError extends ContentstackError {\n  override readonly name = \"ContentstackNotFoundError\"\n  override readonly status = 404\n}\n\nexport class ContentstackValidationError extends ContentstackError {\n  override readonly name = \"ContentstackValidationError\"\n  override readonly status: number\n\n  constructor(\n    message: string,\n    options?: {\n      status?: number\n      errorCode?: number\n      errors?: Record<string, string[]>\n      requestPath?: string\n      cause?: Error\n    },\n  ) {\n    super(message, options)\n    this.status = options?.status ?? 400\n  }\n}\n\nexport class ContentstackInvalidApiKeyError extends ContentstackError {\n  override readonly name = \"ContentstackInvalidApiKeyError\"\n  override readonly status = 412\n}\n\nexport class ContentstackRateLimitError extends ContentstackError {\n  override readonly name = \"ContentstackRateLimitError\"\n  override readonly status = 429\n  readonly retryAfter?: number\n\n  constructor(\n    message: string,\n    options?: {\n      errorCode?: number\n      errors?: Record<string, string[]>\n      requestPath?: string\n      cause?: Error\n      retryAfter?: number\n    },\n  ) {\n    super(message, { ...options, status: 429 })\n    this.retryAfter = options?.retryAfter\n  }\n}\n\nexport class ContentstackServerError extends ContentstackError {\n  override readonly name = \"ContentstackServerError\"\n}\n\nexport class ContentstackConfigError extends ContentstackError {\n  override readonly name = \"ContentstackConfigError\"\n}\n","import {\n  type ContentstackEndpoints as UpstreamEndpoints,\n  getContentstackEndpoints,\n  getRegionForString,\n} from \"@timbenniks/contentstack-endpoints\"\nimport type { ContentstackEndpoints, ContentstackRegion } from \"./resolver.js\"\n\n/** Brand Kit endpoints not available in upstream package — maintained locally */\nconst BRAND_KIT_URLS: Record<ContentstackRegion, { brandKit: string; brandKitAI: string }> = {\n  us: {\n    brandKit: \"https://brand-kits-api.contentstack.com\",\n    brandKitAI: \"https://ai.contentstack.com/brand-kits\",\n  },\n  eu: {\n    brandKit: \"https://eu-brand-kits-api.contentstack.com\",\n    brandKitAI: \"https://eu-ai.contentstack.com/brand-kits\",\n  },\n  au: {\n    brandKit: \"https://au-brand-kits-api.contentstack.com\",\n    brandKitAI: \"https://au-ai.contentstack.com/brand-kits\",\n  },\n  \"azure-na\": {\n    brandKit: \"https://azure-na-brand-kits-api.contentstack.com\",\n    brandKitAI: \"https://azure-na-ai.contentstack.com/brand-kits\",\n  },\n  \"azure-eu\": {\n    brandKit: \"https://azure-eu-brand-kits-api.contentstack.com\",\n    brandKitAI: \"https://azure-eu-ai.contentstack.com/brand-kits\",\n  },\n  \"gcp-na\": {\n    brandKit: \"https://gcp-na-brand-kits-api.contentstack.com\",\n    brandKitAI: \"https://gcp-na-ai.contentstack.com/brand-kits\",\n  },\n  \"gcp-eu\": {\n    brandKit: \"https://gcp-eu-brand-kits-api.contentstack.com\",\n    brandKitAI: \"https://gcp-eu-ai.contentstack.com/brand-kits\",\n  },\n}\n\nfunction mapEndpoints(\n  upstream: UpstreamEndpoints,\n  region: ContentstackRegion,\n  hostsOnly: boolean,\n): ContentstackEndpoints {\n  const bk = BRAND_KIT_URLS[region]\n  const stripProtocol = (url: string) => url.replace(/^https?:\\/\\//, \"\")\n\n  return Object.freeze({\n    cma: upstream.contentManagement ?? \"\",\n    cda: upstream.contentDelivery ?? \"\",\n    graphql: upstream.graphqlDelivery ?? \"\",\n    images: upstream.images ?? \"\",\n    app: upstream.application ?? \"\",\n    preview: upstream.preview ?? \"\",\n    graphqlPreview: upstream.graphqlPreview ?? \"\",\n    launch: upstream.launch ?? \"\",\n    personalizeEdge: upstream.personalizeEdge ?? \"\",\n    brandKit: hostsOnly ? stripProtocol(bk.brandKit) : bk.brandKit,\n    brandKitAI: hostsOnly ? stripProtocol(bk.brandKitAI) : bk.brandKitAI,\n  })\n}\n\nconst ALL_REGIONS: ContentstackRegion[] = [\n  \"us\",\n  \"eu\",\n  \"au\",\n  \"azure-na\",\n  \"azure-eu\",\n  \"gcp-na\",\n  \"gcp-eu\",\n]\n\nfunction buildEndpointMap(): Record<ContentstackRegion, ContentstackEndpoints> {\n  const map = {} as Record<ContentstackRegion, ContentstackEndpoints>\n  for (const region of ALL_REGIONS) {\n    map[region] = mapEndpoints(getContentstackEndpoints(region), region, false)\n  }\n  return Object.freeze(map)\n}\n\nfunction buildHostMap(): Record<ContentstackRegion, ContentstackEndpoints> {\n  const map = {} as Record<ContentstackRegion, ContentstackEndpoints>\n  for (const region of ALL_REGIONS) {\n    map[region] = mapEndpoints(getContentstackEndpoints(region, true), region, true)\n  }\n  return Object.freeze(map)\n}\n\nexport const ENDPOINT_MAP = buildEndpointMap()\nexport const HOST_MAP = buildHostMap()\n\n/** Check if a string is a valid region via the upstream package */\nexport function isValidRegion(input: string): boolean {\n  return getRegionForString(input) !== undefined\n}\n\n/** Map of extra aliases our SDK supports beyond what the upstream package handles */\nexport const EXTRA_ALIASES: Record<string, ContentstackRegion> = {\n  \"north-america\": \"us\",\n  europe: \"eu\",\n  australia: \"au\",\n}\n","import { ContentstackConfigError } from \"../http/errors.js\"\nimport { ENDPOINT_MAP, EXTRA_ALIASES, HOST_MAP, isValidRegion } from \"./endpoints.js\"\n\n/** All 7 Contentstack regions */\nexport type ContentstackRegion = \"us\" | \"eu\" | \"au\" | \"azure-na\" | \"azure-eu\" | \"gcp-na\" | \"gcp-eu\"\n\n/** Resolved endpoint URLs for a region */\nexport interface ContentstackEndpoints {\n  /** CMA base URL, e.g. \"https://api.contentstack.io\" */\n  cma: string\n  /** CDA REST base URL, e.g. \"https://cdn.contentstack.io\" */\n  cda: string\n  /** GraphQL CDA endpoint */\n  graphql: string\n  /** Asset/image delivery base URL */\n  images: string\n  /** Application URL (for OAuth), e.g. \"https://app.contentstack.com\" */\n  app: string\n  /** Preview API base URL */\n  preview: string\n  /** GraphQL preview endpoint */\n  graphqlPreview: string\n  /** Launch API base URL */\n  launch: string\n  /** Personalize edge endpoint */\n  personalizeEdge: string\n  /** Brand Kit Management API base URL */\n  brandKit: string\n  /** Brand Kit GenAI and Knowledge Vault base URL */\n  brandKitAI: string\n}\n\nconst VALID_REGIONS = new Set<string>(Object.keys(ENDPOINT_MAP))\n\n/**\n * Resolve all API endpoints for a Contentstack region.\n *\n * @example\n * ```ts\n * const endpoints = resolveEndpoints(\"eu\");\n * // endpoints.cma === \"https://eu-api.contentstack.com\"\n * // endpoints.app === \"https://eu-app.contentstack.com\"\n * ```\n */\nexport function resolveEndpoints(region: ContentstackRegion): ContentstackEndpoints {\n  return ENDPOINT_MAP[region]\n}\n\n/**\n * Resolve endpoints with https:// stripped (for SDK host parameters).\n *\n * @example\n * ```ts\n * const hosts = resolveHosts(\"eu\");\n * // hosts.cda === \"eu-cdn.contentstack.com\"\n * ```\n */\nexport function resolveHosts(region: ContentstackRegion): ContentstackEndpoints {\n  return HOST_MAP[region]\n}\n\n/**\n * Normalize region aliases: \"na\" → \"us\", \"NA\" → \"us\", etc.\n * Case-insensitive. Throws ContentstackConfigError for unknown regions.\n */\nexport function normalizeRegion(input: string): ContentstackRegion {\n  const lower = input.toLowerCase().trim()\n\n  if (VALID_REGIONS.has(lower)) {\n    return lower as ContentstackRegion\n  }\n\n  // Check extra aliases our SDK supports (north-america, europe, australia)\n  const extraAlias = EXTRA_ALIASES[lower]\n  if (extraAlias) {\n    return extraAlias\n  }\n\n  // Check aliases handled by the upstream package (na, us, aws-na, etc.)\n  if (isValidRegion(lower)) {\n    // The upstream package recognized it — map back to our canonical region\n    // \"na\" and \"us\" both map to the NA region which we call \"us\"\n    if (lower === \"na\" || lower === \"aws-na\" || lower === \"aws_na\") return \"us\"\n    if (lower === \"aws-eu\" || lower === \"aws_eu\") return \"eu\"\n    if (lower === \"aws-au\" || lower === \"aws_au\") return \"au\"\n    if (lower === \"azure_na\") return \"azure-na\"\n    if (lower === \"azure_eu\") return \"azure-eu\"\n    if (lower === \"gcp_na\") return \"gcp-na\"\n    if (lower === \"gcp_eu\") return \"gcp-eu\"\n  }\n\n  const validRegions = [...VALID_REGIONS].join(\", \")\n  const validAliases = [...Object.keys(EXTRA_ALIASES), \"na\", \"aws-na\", \"aws-eu\", \"aws-au\"].join(\n    \", \",\n  )\n  throw new ContentstackConfigError(\n    `Unknown region \"${input}\". Valid regions: ${validRegions}. Aliases: ${validAliases}.`,\n  )\n}\n\nexport { ContentstackConfigError }\n"],"mappings":"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","names":[]}

package/dist/regions/index.d.cts

@@ -0,0 +1,55 @@
+/** All 7 Contentstack regions */
+type ContentstackRegion = "us" | "eu" | "au" | "azure-na" | "azure-eu" | "gcp-na" | "gcp-eu";
+/** Resolved endpoint URLs for a region */
+interface ContentstackEndpoints {
+    /** CMA base URL, e.g. "https://api.contentstack.io" */
+    cma: string;
+    /** CDA REST base URL, e.g. "https://cdn.contentstack.io" */
+    cda: string;
+    /** GraphQL CDA endpoint */
+    graphql: string;
+    /** Asset/image delivery base URL */
+    images: string;
+    /** Application URL (for OAuth), e.g. "https://app.contentstack.com" */
+    app: string;
+    /** Preview API base URL */
+    preview: string;
+    /** GraphQL preview endpoint */
+    graphqlPreview: string;
+    /** Launch API base URL */
+    launch: string;
+    /** Personalize edge endpoint */
+    personalizeEdge: string;
+    /** Brand Kit Management API base URL */
+    brandKit: string;
+    /** Brand Kit GenAI and Knowledge Vault base URL */
+    brandKitAI: string;
+}
+/**
+ * Resolve all API endpoints for a Contentstack region.
+ *
+ * @example
+ * ```ts
+ * const endpoints = resolveEndpoints("eu");
+ * // endpoints.cma === "https://eu-api.contentstack.com"
+ * // endpoints.app === "https://eu-app.contentstack.com"
+ * ```
+ */
+declare function resolveEndpoints(region: ContentstackRegion): ContentstackEndpoints;
+/**
+ * Resolve endpoints with https:// stripped (for SDK host parameters).
+ *
+ * @example
+ * ```ts
+ * const hosts = resolveHosts("eu");
+ * // hosts.cda === "eu-cdn.contentstack.com"
+ * ```
+ */
+declare function resolveHosts(region: ContentstackRegion): ContentstackEndpoints;
+/**
+ * Normalize region aliases: "na" → "us", "NA" → "us", etc.
+ * Case-insensitive. Throws ContentstackConfigError for unknown regions.
+ */
+declare function normalizeRegion(input: string): ContentstackRegion;
+
+export { type ContentstackEndpoints, type ContentstackRegion, normalizeRegion, resolveEndpoints, resolveHosts };

package/dist/regions/index.d.ts

@@ -0,0 +1,55 @@
+/** All 7 Contentstack regions */
+type ContentstackRegion = "us" | "eu" | "au" | "azure-na" | "azure-eu" | "gcp-na" | "gcp-eu";
+/** Resolved endpoint URLs for a region */
+interface ContentstackEndpoints {
+    /** CMA base URL, e.g. "https://api.contentstack.io" */
+    cma: string;
+    /** CDA REST base URL, e.g. "https://cdn.contentstack.io" */
+    cda: string;
+    /** GraphQL CDA endpoint */
+    graphql: string;
+    /** Asset/image delivery base URL */
+    images: string;
+    /** Application URL (for OAuth), e.g. "https://app.contentstack.com" */
+    app: string;
+    /** Preview API base URL */
+    preview: string;
+    /** GraphQL preview endpoint */
+    graphqlPreview: string;
+    /** Launch API base URL */
+    launch: string;
+    /** Personalize edge endpoint */
+    personalizeEdge: string;
+    /** Brand Kit Management API base URL */
+    brandKit: string;
+    /** Brand Kit GenAI and Knowledge Vault base URL */
+    brandKitAI: string;
+}
+/**
+ * Resolve all API endpoints for a Contentstack region.
+ *
+ * @example
+ * ```ts
+ * const endpoints = resolveEndpoints("eu");
+ * // endpoints.cma === "https://eu-api.contentstack.com"
+ * // endpoints.app === "https://eu-app.contentstack.com"
+ * ```
+ */
+declare function resolveEndpoints(region: ContentstackRegion): ContentstackEndpoints;
+/**
+ * Resolve endpoints with https:// stripped (for SDK host parameters).
+ *
+ * @example
+ * ```ts
+ * const hosts = resolveHosts("eu");
+ * // hosts.cda === "eu-cdn.contentstack.com"
+ * ```
+ */
+declare function resolveHosts(region: ContentstackRegion): ContentstackEndpoints;
+/**
+ * Normalize region aliases: "na" → "us", "NA" → "us", etc.
+ * Case-insensitive. Throws ContentstackConfigError for unknown regions.
+ */
+declare function normalizeRegion(input: string): ContentstackRegion;
+
+export { type ContentstackEndpoints, type ContentstackRegion, normalizeRegion, resolveEndpoints, resolveHosts };

package/dist/regions/index.mjs

@@ -0,0 +1,13 @@
+import "../chunk-DJQLN4TR.mjs";
+import {
+  normalizeRegion,
+  resolveEndpoints,
+  resolveHosts
+} from "../chunk-BK2IBTQS.mjs";
+import "../chunk-DMERADWM.mjs";
+export {
+  normalizeRegion,
+  resolveEndpoints,
+  resolveHosts
+};
+//# sourceMappingURL=index.mjs.map

package/dist/regions/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}