@caldik/client 0.0.6 → 0.0.8

package/README.md

@@ -22,9 +22,3 @@ const caldik = new CaldikClient({
   apiKey: process.env.CALDIK_PRIVATE_API_KEY,
 })
 ```
-
-## Canonical contracts
-
-```ts
-const { events, catalogVersion } = await caldik.webhooks.events()
-```

package/dist/index.d.mts

@@ -326,7 +326,7 @@ declare class WebhooksApi {
 //#endregion
 //#region src/index.d.ts
 interface CaldikClientOptions {
-  /** Store ID for external servers. Hosted Workers receive it automatically. */
+  /** Store ID override for external servers or local browser development. */
   storeId?: string;
   /** Private API key for external server integrations. Never use in browsers. */
   apiKey?: string;

package/dist/index.mjs

@@ -1,8 +1,32 @@
+//#region src/internal/environment.ts
+function firstValue(...values) {
+	for (const value of values) {
+		const normalized = value?.trim();
+		if (normalized) return normalized;
+	}
+}
+function importMetaEnvironment() {
+	return import.meta.env;
+}
+/** Public context exposed by Next/Vinext, Vite, or Astro during `caldik dev`. */
+function browserBuildStoreId() {
+	const environment = importMetaEnvironment();
+	return firstValue(typeof process === "undefined" ? void 0 : process.env.NEXT_PUBLIC_CALDIK_STORE_ID, environment?.VITE_CALDIK_STORE_ID, environment?.PUBLIC_CALDIK_STORE_ID);
+}
+function environmentApiUrl(browser) {
+	const environment = importMetaEnvironment();
+	if (browser) return firstValue(typeof process === "undefined" ? void 0 : process.env.NEXT_PUBLIC_CALDIK_API_URL, environment?.VITE_CALDIK_API_URL, environment?.PUBLIC_CALDIK_API_URL);
+	return firstValue(typeof process === "undefined" ? void 0 : process.env.CALDIK_API_URL);
+}
+//#endregion
 //#region src/config.ts
-const defaultApiUrl = typeof API_URL !== "undefined" ? API_URL : "https://api.caldik.com";
+function defaultApiUrl(browser) {
+	return environmentApiUrl(browser) || (typeof API_URL !== "undefined" ? API_URL : "https://api.caldik.com");
+}
 //#endregion
 //#region src/internal/client.ts
 const STORE_ID_PATTERN = /^STORE_[a-f0-9]{32}$/i;
+const STOREFRONT_STORE_ID_ATTRIBUTE = "data-caldik-store-id";
 function isBrowserRuntime() {
 	return typeof window !== "undefined" && typeof document !== "undefined";
 }
@@ -11,19 +35,15 @@ function boundRuntimeStoreId() {
 	return storeId && STORE_ID_PATTERN.test(storeId) ? storeId : null;
 }
 function browserRuntimeStoreId() {
-	const cookies = typeof document.cookie === "string" ? document.cookie : "";
-	for (const item of cookies.split(";")) {
-		const separator = item.indexOf("=");
-		if (separator < 1) continue;
-		if (item.slice(0, separator).trim() !== "__Host-caldik-store-id") continue;
-		try {
-			const value = decodeURIComponent(item.slice(separator + 1).trim());
-			return STORE_ID_PATTERN.test(value) ? value : null;
-		} catch {
-			return null;
-		}
-	}
-	return null;
+	const documentStoreId = document.documentElement?.getAttribute(STOREFRONT_STORE_ID_ATTRIBUTE)?.trim();
+	if (documentStoreId && STORE_ID_PATTERN.test(documentStoreId)) return documentStoreId;
+	const buildStoreId = browserBuildStoreId();
+	return buildStoreId && STORE_ID_PATTERN.test(buildStoreId) ? buildStoreId : null;
+}
+function isLocalBrowserRuntime() {
+	if (!isBrowserRuntime() || typeof location === "undefined") return false;
+	const hostname = location.hostname.toLowerCase();
+	return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1" || hostname === "[::1]";
 }
 var CaldikHttpClient = class {
 	apiKey;
@@ -31,15 +51,16 @@ var CaldikHttpClient = class {
 	storeId;
 	constructor(options = {}) {
 		this.apiKey = options.apiKey?.trim() || void 0;
-		this.apiUrl = options.apiUrl || defaultApiUrl;
-		this.storeId = options.storeId?.trim() || void 0;
+		this.apiUrl = options.apiUrl || defaultApiUrl(isBrowserRuntime());
+		const configuredStoreId = options.storeId?.trim() || void 0;
 		if (this.apiKey && !this.apiKey.startsWith("sk_")) throw new Error("Caldik external integrations require a private sk_ API key");
-		if (this.storeId && !STORE_ID_PATTERN.test(this.storeId)) throw new Error("Caldik storeId is invalid");
+		if (configuredStoreId && !STORE_ID_PATTERN.test(configuredStoreId)) throw new Error("Caldik storeId is invalid");
 		if (isBrowserRuntime() && this.apiKey) throw new Error("Caldik private API keys cannot be used in browser code");
+		this.storeId = configuredStoreId || (isBrowserRuntime() ? browserRuntimeStoreId() || void 0 : void 0);
 	}
 	baseUrl() {
 		if (isBrowserRuntime()) {
-			const storeId = this.storeId || browserRuntimeStoreId();
+			const storeId = this.storeId;
 			if (!storeId) throw new Error("Caldik storefront context is unavailable. Hosted storefronts receive it automatically; local or externally hosted browsers must provide storeId.");
 			return `${this.apiUrl.replace(/\/+$/, "")}/v1/stores/${encodeURIComponent(storeId)}`;
 		}
@@ -56,7 +77,7 @@ var CaldikHttpClient = class {
 		const headers = {};
 		if (!isBrowserRuntime()) headers["User-Agent"] = "CaldikClient/0.0.2";
 		if (this.apiKey) headers.Authorization = `Bearer ${this.apiKey}`;
-		else if (options?.access === "public" && !isBrowserRuntime()) headers["X-Caldik-Public-Request"] = "1";
+		else if (options?.access === "public" && (!isBrowserRuntime() || isLocalBrowserRuntime())) headers["X-Caldik-Public-Request"] = "1";
 		if (input !== void 0) headers["Content-Type"] = "application/json";
 		if (options?.edgeCache) headers["X-Cache-Policy"] = "public";
 		const response = await fetch(url, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caldik/client",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "type": "module",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",