@cossistant/core 0.0.7

package/dist/visitor-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-data.js","names":["WINDOWS_VERSION_MAP: Record<string, string>","version: string | null"],"sources":["../src/visitor-data.ts"],"sourcesContent":["/**\n * Utilities for collecting visitor data including browser, device, and location information\n * Moved from packages/react for better separation of concerns\n */\n/** biome-ignore-all lint/complexity/useOptionalChain: ok */\n\ntype VisitorData = {\n\tbrowser: string | null;\n\tbrowserVersion: string | null;\n\tos: string | null;\n\tosVersion: string | null;\n\tdevice: string | null;\n\tdeviceType: \"desktop\" | \"mobile\" | \"tablet\" | \"unknown\";\n\tlanguage: string | null;\n\ttimezone: string | null;\n\tscreenResolution: string | null;\n\tviewport: string | null;\n\tip: string | null;\n\tcity: string | null;\n\tregion: string | null;\n\tcountry: string | null;\n\tcountryCode: string | null;\n\tlatitude: number | null;\n\tlongitude: number | null;\n};\n\n// Browser detection patterns\nconst EDGE_PATTERN = /Edg\\/([0-9.]+)/;\nconst CHROME_PATTERN = /Chrome\\/([0-9.]+)/;\nconst SAFARI_PATTERN = /Version\\/([0-9.]+).*Safari/;\nconst FIREFOX_PATTERN = /Firefox\\/([0-9.]+)/;\nconst OPERA_PATTERN = /OPR\\/([0-9.]+)/;\n\n/**\n * Parse user agent to extract browser information\n */\nfunction parseBrowser(userAgent: string): {\n\tbrowser: string | null;\n\tversion: string | null;\n} {\n\tconst browsers = [\n\t\t{ name: \"Edge\", pattern: EDGE_PATTERN },\n\t\t{ name: \"Chrome\", pattern: CHROME_PATTERN },\n\t\t{ name: \"Safari\", pattern: SAFARI_PATTERN },\n\t\t{ name: \"Firefox\", pattern: FIREFOX_PATTERN },\n\t\t{ name: \"Opera\", pattern: OPERA_PATTERN },\n\t];\n\n\tfor (const { name, pattern } of browsers) {\n\t\tconst match = userAgent.match(pattern);\n\t\tif (match) {\n\t\t\treturn { browser: name, version: match[1] || null };\n\t\t}\n\t}\n\n\treturn { browser: null, version: null };\n}\n\n// OS detection patterns\nconst WINDOWS_PATTERN = /Windows NT ([0-9.]+)/;\nconst MACOS_PATTERN = /Mac OS X ([0-9_]+)/;\nconst IOS_PATTERN = /OS ([0-9_]+) like Mac OS X/;\nconst ANDROID_PATTERN = /Android ([0-9.]+)/;\nconst LINUX_PATTERN = /Linux/;\n\nconst WINDOWS_VERSION_MAP: Record<string, string> = {\n\t\"10.0\": \"10\",\n\t\"6.3\": \"8.1\",\n\t\"6.2\": \"8\",\n\t\"6.1\": \"7\",\n};\n\n/**\n * Transform version string by replacing underscores with dots\n */\nfunction transformVersion(version: string): string {\n\treturn version.replace(/_/g, \".\");\n}\n\n/**\n * Parse user agent to extract OS information\n */\nfunction parseOS(userAgent: string): {\n\tos: string | null;\n\tversion: string | null;\n} {\n\t// Check Windows\n\tconst windowsMatch = userAgent.match(WINDOWS_PATTERN);\n\tif (windowsMatch) {\n\t\tconst rawVersion = windowsMatch[1];\n\t\tlet version: string | null = null;\n\t\tif (rawVersion) {\n\t\t\tversion = WINDOWS_VERSION_MAP[rawVersion] || rawVersion;\n\t\t}\n\t\treturn { os: \"Windows\", version };\n\t}\n\n\t// Check macOS\n\tconst macMatch = userAgent.match(MACOS_PATTERN);\n\tif (macMatch) {\n\t\tconst version = macMatch[1] ? transformVersion(macMatch[1]) : null;\n\t\treturn { os: \"macOS\", version };\n\t}\n\n\t// Check iOS\n\tconst iosMatch = userAgent.match(IOS_PATTERN);\n\tif (iosMatch) {\n\t\tconst version = iosMatch[1] ? transformVersion(iosMatch[1]) : null;\n\t\treturn { os: \"iOS\", version };\n\t}\n\n\t// Check Android\n\tconst androidMatch = userAgent.match(ANDROID_PATTERN);\n\tif (androidMatch) {\n\t\treturn { os: \"Android\", version: androidMatch[1] || null };\n\t}\n\n\t// Check Linux\n\tif (LINUX_PATTERN.test(userAgent)) {\n\t\treturn { os: \"Linux\", version: null };\n\t}\n\n\treturn { os: null, version: null };\n}\n\n// Device type detection patterns\nconst MOBILE_PATTERN = /Mobile|Android|iPhone|iPod/i;\nconst TABLET_PATTERN = /iPad|Tablet|Tab/i;\n\n// Device name detection patterns\nconst IPHONE_PATTERN = /iPhone/;\nconst IPAD_PATTERN = /iPad/;\nconst IPOD_PATTERN = /iPod/;\nconst ANDROID_MOBILE_PATTERN = /Android.*Mobile/;\nconst ANDROID_TABLET_PATTERN = /Android.*Tablet/;\nconst WINDOWS_PHONE_PATTERN = /Windows Phone/;\nconst MACINTOSH_PATTERN = /Macintosh/;\nconst WINDOWS_PATTERN_DEVICE = /Windows/;\nconst LINUX_PATTERN_DEVICE = /Linux/;\n\n/**\n * Detect device type from user agent\n */\nfunction detectDeviceType(\n\tuserAgent: string\n): \"desktop\" | \"mobile\" | \"tablet\" | \"unknown\" {\n\tconst isMobile = MOBILE_PATTERN.test(userAgent);\n\tconst isTablet = TABLET_PATTERN.test(userAgent);\n\n\tif (isTablet) {\n\t\treturn \"tablet\";\n\t}\n\tif (isMobile) {\n\t\treturn \"mobile\";\n\t}\n\tif (\n\t\tuserAgent.includes(\"Windows\") ||\n\t\tuserAgent.includes(\"Mac\") ||\n\t\tuserAgent.includes(\"Linux\")\n\t) {\n\t\treturn \"desktop\";\n\t}\n\n\treturn \"unknown\";\n}\n\n/**\n * Get device name from user agent\n */\nfunction getDeviceName(userAgent: string): string | null {\n\tconst devices = [\n\t\t{ pattern: IPHONE_PATTERN, name: \"iPhone\" },\n\t\t{ pattern: IPAD_PATTERN, name: \"iPad\" },\n\t\t{ pattern: IPOD_PATTERN, name: \"iPod\" },\n\t\t{ pattern: ANDROID_MOBILE_PATTERN, name: \"Android Phone\" },\n\t\t{ pattern: ANDROID_TABLET_PATTERN, name: \"Android Tablet\" },\n\t\t{ pattern: WINDOWS_PHONE_PATTERN, name: \"Windows Phone\" },\n\t\t{ pattern: MACINTOSH_PATTERN, name: \"Mac\" },\n\t\t{ pattern: WINDOWS_PATTERN_DEVICE, name: \"Windows PC\" },\n\t\t{ pattern: LINUX_PATTERN_DEVICE, name: \"Linux PC\" },\n\t];\n\n\tfor (const { pattern, name } of devices) {\n\t\tif (pattern.test(userAgent)) {\n\t\t\treturn name;\n\t\t}\n\t}\n\n\treturn null;\n}\n\n/**\n * Check if we're running in a browser environment\n */\nfunction isBrowser(): boolean {\n\treturn typeof window !== \"undefined\" && typeof navigator !== \"undefined\";\n}\n\nfunction inferCityFromTimezone(timezone: string | null): string | null {\n\tif (!timezone?.includes(\"/\")) {\n\t\treturn null;\n\t}\n\tconst [, city] = timezone.split(\"/\");\n\treturn city ? city.replace(/_/g, \" \") : null;\n}\n\n/**\n * Collect visitor data from the browser environment\n * Returns null if not in browser environment\n */\nexport async function collectVisitorData(): Promise<VisitorData | null> {\n\tif (!isBrowser()) {\n\t\treturn null;\n\t}\n\n\tconst userAgent = navigator.userAgent || \"\";\n\tconst { browser, version: browserVersion } = parseBrowser(userAgent);\n\tconst { os, version: osVersion } = parseOS(userAgent);\n\tconst language = navigator.language || null;\n\tconst timezone = Intl.DateTimeFormat().resolvedOptions().timeZone || null;\n\tconst inferredCity = inferCityFromTimezone(timezone);\n\n\treturn {\n\t\tbrowser,\n\t\tbrowserVersion,\n\t\tos,\n\t\tosVersion,\n\t\tdevice: getDeviceName(userAgent),\n\t\tdeviceType: detectDeviceType(userAgent),\n\t\tlanguage,\n\t\ttimezone,\n\t\tscreenResolution:\n\t\t\ttypeof window !== \"undefined\" && window.screen\n\t\t\t\t? `${window.screen.width}x${window.screen.height}`\n\t\t\t\t: null,\n\t\tviewport:\n\t\t\ttypeof window !== \"undefined\"\n\t\t\t\t? `${window.innerWidth}x${window.innerHeight}`\n\t\t\t\t: null,\n\t\tip: null,\n\t\tcity: inferredCity,\n\t\tregion: null,\n\t\tcountry: null,\n\t\tcountryCode: null,\n\t\tlatitude: null,\n\t\tlongitude: null,\n\t};\n}\n\n/**\n * Export the interface for use by consumers\n */\nexport type { VisitorData };\n"],"mappings":"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"}

package/dist/visitor-tracker.d.ts

@@ -0,0 +1,31 @@
+//#region src/visitor-tracker.d.ts
+/**
+ * Visitor tracking utilities for managing visitor IDs in localStorage
+ */
+/**
+ * Get visitor ID from localStorage for a specific website
+ */
+declare function getVisitorId(websiteId: string): string | null;
+/**
+ * Set visitor ID in localStorage for a specific website
+ */
+declare function setVisitorId(websiteId: string, visitorId: string): void;
+/**
+ * Clear visitor ID for a specific website
+ */
+declare function clearVisitorId(websiteId: string): void;
+/**
+ * Clear all visitor IDs
+ */
+declare function clearAllVisitorIds(): void;
+/**
+ * Get any existing visitor ID from localStorage by matching the public key
+ * This is useful when we don't yet know the website ID but need to check for existing visitors
+ */
+declare function getExistingVisitorId(publicKey: string): {
+  websiteId: string;
+  visitorId: string;
+} | null;
+//#endregion
+export { clearAllVisitorIds, clearVisitorId, getExistingVisitorId, getVisitorId, setVisitorId };
+//# sourceMappingURL=visitor-tracker.d.ts.map

package/dist/visitor-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-tracker.d.ts","names":[],"sources":["../src/visitor-tracker.ts"],"sourcesContent":[],"mappings":";;AAmCA;AA4BA;AAwBA;AAkBA;AAwBA;iBA9FgB,YAAA;;;;iBA4BA,YAAA;;;;iBAwBA,cAAA;;;;iBAkBA,kBAAA,CAAA;;;;;iBAwBA,oBAAA"}

package/dist/visitor-tracker.js

@@ -0,0 +1,109 @@
+import { isValidULID } from "./utils.js";
+
+//#region src/visitor-tracker.ts
+/**
+* Visitor tracking utilities for managing visitor IDs in localStorage
+*/
+const STORAGE_KEY_PREFIX = "cossistant_visitor";
+/**
+* Get the localStorage key for a specific website
+*/
+function getStorageKey(websiteId) {
+	return `${STORAGE_KEY_PREFIX}_${websiteId}`;
+}
+/**
+* Check if localStorage is available
+*/
+function isLocalStorageAvailable() {
+	try {
+		if (typeof window === "undefined" || !window.localStorage) return false;
+		const testKey = "__cossistant_test__";
+		localStorage.setItem(testKey, "test");
+		localStorage.removeItem(testKey);
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
+* Get visitor ID from localStorage for a specific website
+*/
+function getVisitorId(websiteId) {
+	if (!isLocalStorageAvailable()) return null;
+	try {
+		if (typeof window === "undefined") return null;
+		const data = localStorage.getItem(getStorageKey(websiteId));
+		if (!data) return null;
+		const parsed = JSON.parse(data);
+		if (parsed.visitorId && isValidULID(parsed.visitorId)) return parsed.visitorId;
+		return null;
+	} catch {
+		return null;
+	}
+}
+/**
+* Set visitor ID in localStorage for a specific website
+*/
+function setVisitorId(websiteId, visitorId) {
+	if (!isLocalStorageAvailable()) return;
+	try {
+		const data = {
+			visitorId,
+			timestamp: Date.now(),
+			websiteId
+		};
+		if (typeof window === "undefined") return;
+		const key = getStorageKey(websiteId);
+		localStorage.setItem(key, JSON.stringify(data));
+	} catch {}
+}
+/**
+* Clear visitor ID for a specific website
+*/
+function clearVisitorId(websiteId) {
+	if (!isLocalStorageAvailable()) return;
+	try {
+		if (typeof window === "undefined") return;
+		localStorage.removeItem(getStorageKey(websiteId));
+	} catch {}
+}
+/**
+* Clear all visitor IDs
+*/
+function clearAllVisitorIds() {
+	if (!isLocalStorageAvailable()) return;
+	try {
+		if (typeof window === "undefined") return;
+		const keys = Object.keys(localStorage).filter((key) => key.startsWith(STORAGE_KEY_PREFIX));
+		for (const key of keys) localStorage.removeItem(key);
+	} catch {}
+}
+/**
+* Get any existing visitor ID from localStorage by matching the public key
+* This is useful when we don't yet know the website ID but need to check for existing visitors
+*/
+function getExistingVisitorId(publicKey) {
+	if (!isLocalStorageAvailable()) return null;
+	try {
+		if (typeof window === "undefined") return null;
+		const keys = Object.keys(localStorage).filter((key) => key.startsWith(STORAGE_KEY_PREFIX));
+		for (const key of keys) {
+			const data = typeof window !== "undefined" ? localStorage.getItem(key) : null;
+			if (!data) continue;
+			try {
+				const parsed = JSON.parse(data);
+				if (parsed.visitorId && isValidULID(parsed.visitorId) && parsed.websiteId) return {
+					websiteId: parsed.websiteId,
+					visitorId: parsed.visitorId
+				};
+			} catch {}
+		}
+		return null;
+	} catch {
+		return null;
+	}
+}
+
+//#endregion
+export { clearAllVisitorIds, clearVisitorId, getExistingVisitorId, getVisitorId, setVisitorId };
+//# sourceMappingURL=visitor-tracker.js.map

package/dist/visitor-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-tracker.js","names":[],"sources":["../src/visitor-tracker.ts"],"sourcesContent":["/**\n * Visitor tracking utilities for managing visitor IDs in localStorage\n */\n\nimport { isValidULID } from \"./utils\";\n\nconst STORAGE_KEY_PREFIX = \"cossistant_visitor\";\n\n/**\n * Get the localStorage key for a specific website\n */\nfunction getStorageKey(websiteId: string): string {\n\treturn `${STORAGE_KEY_PREFIX}_${websiteId}`;\n}\n\n/**\n * Check if localStorage is available\n */\nfunction isLocalStorageAvailable(): boolean {\n\ttry {\n\t\tif (typeof window === \"undefined\" || !window.localStorage) {\n\t\t\treturn false;\n\t\t}\n\t\tconst testKey = \"__cossistant_test__\";\n\t\tlocalStorage.setItem(testKey, \"test\");\n\t\tlocalStorage.removeItem(testKey);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Get visitor ID from localStorage for a specific website\n */\nexport function getVisitorId(websiteId: string): string | null {\n\tif (!isLocalStorageAvailable()) {\n\t\treturn null;\n\t}\n\n\ttry {\n\t\tif (typeof window === \"undefined\") {\n\t\t\treturn null;\n\t\t}\n\t\tconst data = localStorage.getItem(getStorageKey(websiteId));\n\t\tif (!data) {\n\t\t\treturn null;\n\t\t}\n\n\t\tconst parsed = JSON.parse(data);\n\t\t// Validate that the visitor ID is a valid ULID (26 characters)\n\t\tif (parsed.visitorId && isValidULID(parsed.visitorId)) {\n\t\t\treturn parsed.visitorId;\n\t\t}\n\t\treturn null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Set visitor ID in localStorage for a specific website\n */\nexport function setVisitorId(websiteId: string, visitorId: string): void {\n\tif (!isLocalStorageAvailable()) {\n\t\treturn;\n\t}\n\n\ttry {\n\t\tconst data = {\n\t\t\tvisitorId,\n\t\t\ttimestamp: Date.now(),\n\t\t\twebsiteId,\n\t\t};\n\t\tif (typeof window === \"undefined\") {\n\t\t\treturn;\n\t\t}\n\t\tconst key = getStorageKey(websiteId);\n\t\tlocalStorage.setItem(key, JSON.stringify(data));\n\t} catch {\n\t\t// Silently fail - visitor tracking is not critical\n\t}\n}\n\n/**\n * Clear visitor ID for a specific website\n */\nexport function clearVisitorId(websiteId: string): void {\n\tif (!isLocalStorageAvailable()) {\n\t\treturn;\n\t}\n\n\ttry {\n\t\tif (typeof window === \"undefined\") {\n\t\t\treturn;\n\t\t}\n\t\tlocalStorage.removeItem(getStorageKey(websiteId));\n\t} catch {\n\t\t// Silently fail - visitor tracking is not critical\n\t}\n}\n\n/**\n * Clear all visitor IDs\n */\nexport function clearAllVisitorIds(): void {\n\tif (!isLocalStorageAvailable()) {\n\t\treturn;\n\t}\n\n\ttry {\n\t\tif (typeof window === \"undefined\") {\n\t\t\treturn;\n\t\t}\n\t\tconst keys = Object.keys(localStorage).filter((key) =>\n\t\t\tkey.startsWith(STORAGE_KEY_PREFIX)\n\t\t);\n\t\tfor (const key of keys) {\n\t\t\tlocalStorage.removeItem(key);\n\t\t}\n\t} catch {\n\t\t// Silently fail - visitor tracking is not critical\n\t}\n}\n\n/**\n * Get any existing visitor ID from localStorage by matching the public key\n * This is useful when we don't yet know the website ID but need to check for existing visitors\n */\nexport function getExistingVisitorId(\n\tpublicKey: string\n): { websiteId: string; visitorId: string } | null {\n\tif (!isLocalStorageAvailable()) {\n\t\treturn null;\n\t}\n\n\ttry {\n\t\tif (typeof window === \"undefined\") {\n\t\t\treturn null;\n\t\t}\n\t\t// Find all visitor keys in localStorage\n\t\tconst keys = Object.keys(localStorage).filter((key) =>\n\t\t\tkey.startsWith(STORAGE_KEY_PREFIX)\n\t\t);\n\n\t\t// Check each one to see if we have a valid visitor ID\n\t\tfor (const key of keys) {\n\t\t\tconst data =\n\t\t\t\ttypeof window !== \"undefined\" ? localStorage.getItem(key) : null;\n\t\t\tif (!data) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tconst parsed = JSON.parse(data);\n\t\t\t\t// Validate that the visitor ID is a valid ULID\n\t\t\t\tif (\n\t\t\t\t\tparsed.visitorId &&\n\t\t\t\t\tisValidULID(parsed.visitorId) &&\n\t\t\t\t\tparsed.websiteId\n\t\t\t\t) {\n\t\t\t\t\t// We found a valid visitor ID - return it\n\t\t\t\t\t// Note: In a multi-website scenario, you might want to match by public key\n\t\t\t\t\t// For now, we'll return the first valid one found\n\t\t\t\t\treturn {\n\t\t\t\t\t\twebsiteId: parsed.websiteId,\n\t\t\t\t\t\tvisitorId: parsed.visitorId,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t} catch {}\n\t\t}\n\n\t\treturn null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n"],"mappings":";;;;;;AAMA,MAAM,qBAAqB;;;;AAK3B,SAAS,cAAc,WAA2B;AACjD,QAAO,GAAG,mBAAmB,GAAG;;;;;AAMjC,SAAS,0BAAmC;AAC3C,KAAI;AACH,MAAI,OAAO,WAAW,eAAe,CAAC,OAAO,aAC5C,QAAO;EAER,MAAM,UAAU;AAChB,eAAa,QAAQ,SAAS,OAAO;AACrC,eAAa,WAAW,QAAQ;AAChC,SAAO;SACA;AACP,SAAO;;;;;;AAOT,SAAgB,aAAa,WAAkC;AAC9D,KAAI,CAAC,yBAAyB,CAC7B,QAAO;AAGR,KAAI;AACH,MAAI,OAAO,WAAW,YACrB,QAAO;EAER,MAAM,OAAO,aAAa,QAAQ,cAAc,UAAU,CAAC;AAC3D,MAAI,CAAC,KACJ,QAAO;EAGR,MAAM,SAAS,KAAK,MAAM,KAAK;AAE/B,MAAI,OAAO,aAAa,YAAY,OAAO,UAAU,CACpD,QAAO,OAAO;AAEf,SAAO;SACA;AACP,SAAO;;;;;;AAOT,SAAgB,aAAa,WAAmB,WAAyB;AACxE,KAAI,CAAC,yBAAyB,CAC7B;AAGD,KAAI;EACH,MAAM,OAAO;GACZ;GACA,WAAW,KAAK,KAAK;GACrB;GACA;AACD,MAAI,OAAO,WAAW,YACrB;EAED,MAAM,MAAM,cAAc,UAAU;AACpC,eAAa,QAAQ,KAAK,KAAK,UAAU,KAAK,CAAC;SACxC;;;;;AAQT,SAAgB,eAAe,WAAyB;AACvD,KAAI,CAAC,yBAAyB,CAC7B;AAGD,KAAI;AACH,MAAI,OAAO,WAAW,YACrB;AAED,eAAa,WAAW,cAAc,UAAU,CAAC;SAC1C;;;;;AAQT,SAAgB,qBAA2B;AAC1C,KAAI,CAAC,yBAAyB,CAC7B;AAGD,KAAI;AACH,MAAI,OAAO,WAAW,YACrB;EAED,MAAM,OAAO,OAAO,KAAK,aAAa,CAAC,QAAQ,QAC9C,IAAI,WAAW,mBAAmB,CAClC;AACD,OAAK,MAAM,OAAO,KACjB,cAAa,WAAW,IAAI;SAEtB;;;;;;AAST,SAAgB,qBACf,WACkD;AAClD,KAAI,CAAC,yBAAyB,CAC7B,QAAO;AAGR,KAAI;AACH,MAAI,OAAO,WAAW,YACrB,QAAO;EAGR,MAAM,OAAO,OAAO,KAAK,aAAa,CAAC,QAAQ,QAC9C,IAAI,WAAW,mBAAmB,CAClC;AAGD,OAAK,MAAM,OAAO,MAAM;GACvB,MAAM,OACL,OAAO,WAAW,cAAc,aAAa,QAAQ,IAAI,GAAG;AAC7D,OAAI,CAAC,KACJ;AAGD,OAAI;IACH,MAAM,SAAS,KAAK,MAAM,KAAK;AAE/B,QACC,OAAO,aACP,YAAY,OAAO,UAAU,IAC7B,OAAO,UAKP,QAAO;KACN,WAAW,OAAO;KAClB,WAAW,OAAO;KAClB;WAEK;;AAGT,SAAO;SACA;AACP,SAAO"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@cossistant/core",
+  "type": "module",
+  "version": "0.0.7",
+  "private": false,
+  "author": "Cossistant Team",
+  "description": "Core library for connecting to Cossistant API and managing data fetching",
+  "keywords": [
+    "api",
+    "websocket",
+    "rest",
+    "core",
+    "typescript",
+    "support-ai"
+  ],
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@cossistant/typescript-config": "workspace:*",
+    "@cossistant/types": "workspace:*"
+  },
+  "dependencies": {
+    "nanoid": "^5.1.5",
+    "ulid": "^3.0.1",
+    "zod": "^4.1.8"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "lint": "biome check .",
+    "check-types": "tsc --noEmit --project tsconfig.json"
+  }
+}