@heycatch/sdk 0.7.0-dev.43 → 0.7.0-dev.59

package/dist/{shared-B8y8fJCD.d.cts → shared-X3O5yyhh.d.cts}

@@ -113,15 +113,38 @@ interface ServerTrackOptions extends TrackOptions {
  */
 declare const STAGE: "dev" | "prod";
 declare const SDK_VERSION: string;
+/** Stamped when the installer could not determine a value. */
+declare const UNKNOWN_INSTALL_VALUE: "unknown";
 /**
- * Frameworks the install guides can detect. Kept as a type alias, not a
- * runtime array: `apps/landing-web/tests/agent-install-guides.spec.ts`
- * reads this source text and asserts the set matches the guides' tables,
- * so docs, types, and reported values cannot drift.
+ * Frameworks the install guides can detect. **Written out as a union, not
+ * derived from the array below**, because
+ * `apps/landing-web/tests/agent-install-guides.spec.ts` matches this
+ * declaration as source text to assert the set agrees with the guide's
+ * detection table. Collapsing it to `(typeof …)[number]` leaves that guard
+ * matching nothing.
+ *
+ * For the same reason, do not restate the declaration's opening line anywhere
+ * above it - including in a comment. The guard takes the FIRST match in the
+ * file, so a prose copy of it wins and yields zero ids. (Written here after
+ * doing exactly that; the spec's vacuity check is what caught it.)
  */
 type KnownFramework = 'nextjs' | 'vite-react' | 'react' | 'vue' | 'svelte' | 'astro' | 'angular' | 'react-native' | 'web';
 /** Coding agents that run the install. `other` is the catch-all. */
 type KnownInstallAgent = 'lovable' | 'bolt' | 'v0' | 'replit' | 'cursor' | 'claude-code' | 'codex' | 'windsurf' | 'other';
+/**
+ * The same two sets at RUNTIME, for code that has to ask "is this reported
+ * value one we recognise?" - a question a type union cannot answer, because
+ * `install.framework` is deliberately `KnownFramework | (string & {})` so an
+ * unlisted framework still installs cleanly.
+ *
+ * The consumer is the internal stats page, which flags an unrecognised or
+ * missing value rather than silently rendering it as though it were expected.
+ *
+ * Drift between each array and its union is a **compile error** (see the
+ * assertions below), so this is a second spelling, not a second source.
+ */
+declare const KNOWN_FRAMEWORKS: readonly ["nextjs", "vite-react", "react", "vue", "svelte", "astro", "angular", "react-native", "web"];
+declare const KNOWN_INSTALL_AGENTS: readonly ["lovable", "bolt", "v0", "replit", "cursor", "claude-code", "codex", "windsurf", "other"];
 /**
  * Who installed the SDK and into what. Stamped as super-properties on
  * every event - the dashboard reads them off the event stream, so there
@@ -154,4 +177,4 @@ interface HeyCatchConfig {
     tracingHosts?: string[];
 }
 
-export { type HeyCatchConfig as H, type PersonPropertyUpdate as P, SDK_VERSION as S, type TrackOptions as T, type HeyCatchPersonProperties as a, type HeyCatchProperties as b, STAGE as c, type ServerTrackOptions as d };
+export { type HeyCatchConfig as H, KNOWN_FRAMEWORKS as K, type PersonPropertyUpdate as P, SDK_VERSION as S, type TrackOptions as T, UNKNOWN_INSTALL_VALUE as U, type HeyCatchPersonProperties as a, type HeyCatchProperties as b, KNOWN_INSTALL_AGENTS as c, STAGE as d, type ServerTrackOptions as e };

package/dist/{shared-B8y8fJCD.d.ts → shared-X3O5yyhh.d.ts}

@@ -113,15 +113,38 @@ interface ServerTrackOptions extends TrackOptions {
  */
 declare const STAGE: "dev" | "prod";
 declare const SDK_VERSION: string;
+/** Stamped when the installer could not determine a value. */
+declare const UNKNOWN_INSTALL_VALUE: "unknown";
 /**
- * Frameworks the install guides can detect. Kept as a type alias, not a
- * runtime array: `apps/landing-web/tests/agent-install-guides.spec.ts`
- * reads this source text and asserts the set matches the guides' tables,
- * so docs, types, and reported values cannot drift.
+ * Frameworks the install guides can detect. **Written out as a union, not
+ * derived from the array below**, because
+ * `apps/landing-web/tests/agent-install-guides.spec.ts` matches this
+ * declaration as source text to assert the set agrees with the guide's
+ * detection table. Collapsing it to `(typeof …)[number]` leaves that guard
+ * matching nothing.
+ *
+ * For the same reason, do not restate the declaration's opening line anywhere
+ * above it - including in a comment. The guard takes the FIRST match in the
+ * file, so a prose copy of it wins and yields zero ids. (Written here after
+ * doing exactly that; the spec's vacuity check is what caught it.)
  */
 type KnownFramework = 'nextjs' | 'vite-react' | 'react' | 'vue' | 'svelte' | 'astro' | 'angular' | 'react-native' | 'web';
 /** Coding agents that run the install. `other` is the catch-all. */
 type KnownInstallAgent = 'lovable' | 'bolt' | 'v0' | 'replit' | 'cursor' | 'claude-code' | 'codex' | 'windsurf' | 'other';
+/**
+ * The same two sets at RUNTIME, for code that has to ask "is this reported
+ * value one we recognise?" - a question a type union cannot answer, because
+ * `install.framework` is deliberately `KnownFramework | (string & {})` so an
+ * unlisted framework still installs cleanly.
+ *
+ * The consumer is the internal stats page, which flags an unrecognised or
+ * missing value rather than silently rendering it as though it were expected.
+ *
+ * Drift between each array and its union is a **compile error** (see the
+ * assertions below), so this is a second spelling, not a second source.
+ */
+declare const KNOWN_FRAMEWORKS: readonly ["nextjs", "vite-react", "react", "vue", "svelte", "astro", "angular", "react-native", "web"];
+declare const KNOWN_INSTALL_AGENTS: readonly ["lovable", "bolt", "v0", "replit", "cursor", "claude-code", "codex", "windsurf", "other"];
 /**
  * Who installed the SDK and into what. Stamped as super-properties on
  * every event - the dashboard reads them off the event stream, so there
@@ -154,4 +177,4 @@ interface HeyCatchConfig {
     tracingHosts?: string[];
 }
 
-export { type HeyCatchConfig as H, type PersonPropertyUpdate as P, SDK_VERSION as S, type TrackOptions as T, type HeyCatchPersonProperties as a, type HeyCatchProperties as b, STAGE as c, type ServerTrackOptions as d };
+export { type HeyCatchConfig as H, KNOWN_FRAMEWORKS as K, type PersonPropertyUpdate as P, SDK_VERSION as S, type TrackOptions as T, UNKNOWN_INSTALL_VALUE as U, type HeyCatchPersonProperties as a, type HeyCatchProperties as b, KNOWN_INSTALL_AGENTS as c, STAGE as d, type ServerTrackOptions as e };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heycatch/sdk",
-  "version": "0.7.0-dev.43",
+  "version": "0.7.0-dev.59",
   "description": "HeyCatch SDK",
   "keywords": [
     "analytics",