@clivly/core 0.10.3 → 0.10.4

package/dist/integration-state.cjs

@@ -31,6 +31,32 @@ const STEP_PREREQUISITES = {
 function stepIndex(id) {
 	return INTEGRATION_STEPS.indexOf(id);
 }
+const UNREACHABLE_STATUSES = /* @__PURE__ */ new Set([
+	502,
+	503,
+	504,
+	520,
+	521,
+	522,
+	523,
+	524,
+	525,
+	526,
+	527,
+	530
+]);
+/**
+* Did the last trigger attempt fail to reach the app at all?
+*
+* Deliberately narrow. A signature rejection (401) or a handler error (500)
+* both prove the trigger works — the request arrived. Only a total failure to
+* get an answer un-ticks the rung, so this cannot demote setup progress for
+* faults that live somewhere else.
+*/
+function triggerUnreachable(facts) {
+	const status = facts.lastRun?.status;
+	return facts.lastRun?.ok === false && status !== void 0 && UNREACHABLE_STATUSES.has(status);
+}
 function formatAge(ms) {
 	if (ms < 6e4) return `${Math.max(1, Math.round(ms / 1e3))}s ago`;
 	if (ms < 36e5) return `${Math.round(ms / 6e4)}m ago`;
@@ -144,7 +170,7 @@ function isSatisfied(id, facts) {
 		case "application": return facts.everConnected || age !== null;
 		case "schema": return facts.discoveredTableCount > 0;
 		case "mapping": return facts.mappedEntityCount > 0;
-		case "trigger": return facts.triggerConfigured;
+		case "trigger": return facts.triggerConfigured && !triggerUnreachable(facts);
 		case "sync": return facts.lastRun?.ok === true;
 		default: return facts.widgetInstalled;
 	}
@@ -154,11 +180,16 @@ function evidenceFor(id, facts) {
 	if (id === "application" && age !== null) return `heartbeat ${formatAge(age)}`;
 	if (id === "schema" && facts.discoveredTableCount > 0) return `found ${facts.discoveredTableCount} tables`;
 	if (id === "mapping" && facts.mappedEntityCount > 0) return `${facts.mappedEntityCount} entity mapped`;
-	if (id === "trigger" && facts.triggerConfigured) return "trigger URL and secret set";
+	if (id === "trigger" && facts.triggerConfigured) return triggerUnreachable(facts) ? "set, but the last attempt could not reach your app" : "trigger URL and secret set";
 	if (id === "sync" && facts.lastRun) return `last run ${formatAge(facts.now - facts.lastRun.at)}`;
 	return null;
 }
 function problemFor(id, facts) {
+	if (id === "trigger" && triggerUnreachable(facts)) return {
+		code: "trigger_unreachable",
+		message: "The trigger URL is set, but Clivly could not reach your app there.",
+		fix: "Check the app is running and serving that URL. A dev tunnel URL changes every session — `clivly dev` keeps it registered for you."
+	};
 	if (id === "sync" && facts.lastRun && !facts.lastRun.ok) return {
 		code: "sync_failed",
 		message: facts.lastRun.message ?? "The last sync run failed.",

package/dist/integration-state.d.cts

@@ -18,6 +18,14 @@ interface RunFact {
   at: number;
   message?: string;
   ok: boolean;
+  /**
+   * The HTTP status the host answered with, when there was one.
+   *
+   * Absent for a run that failed before any response existed, and for callers
+   * that do not track it — so every read must treat `undefined` as "unknown",
+   * never as "fine".
+   */
+  status?: number;
 }
 /**
  * Where the reporting app is running, as the app itself understands it.

package/dist/integration-state.d.mts

@@ -18,6 +18,14 @@ interface RunFact {
   at: number;
   message?: string;
   ok: boolean;
+  /**
+   * The HTTP status the host answered with, when there was one.
+   *
+   * Absent for a run that failed before any response existed, and for callers
+   * that do not track it — so every read must treat `undefined` as "unknown",
+   * never as "fine".
+   */
+  status?: number;
 }
 /**
  * Where the reporting app is running, as the app itself understands it.

package/dist/integration-state.mjs

@@ -30,6 +30,32 @@ const STEP_PREREQUISITES = {
 function stepIndex(id) {
 	return INTEGRATION_STEPS.indexOf(id);
 }
+const UNREACHABLE_STATUSES = /* @__PURE__ */ new Set([
+	502,
+	503,
+	504,
+	520,
+	521,
+	522,
+	523,
+	524,
+	525,
+	526,
+	527,
+	530
+]);
+/**
+* Did the last trigger attempt fail to reach the app at all?
+*
+* Deliberately narrow. A signature rejection (401) or a handler error (500)
+* both prove the trigger works — the request arrived. Only a total failure to
+* get an answer un-ticks the rung, so this cannot demote setup progress for
+* faults that live somewhere else.
+*/
+function triggerUnreachable(facts) {
+	const status = facts.lastRun?.status;
+	return facts.lastRun?.ok === false && status !== void 0 && UNREACHABLE_STATUSES.has(status);
+}
 function formatAge(ms) {
 	if (ms < 6e4) return `${Math.max(1, Math.round(ms / 1e3))}s ago`;
 	if (ms < 36e5) return `${Math.round(ms / 6e4)}m ago`;
@@ -143,7 +169,7 @@ function isSatisfied(id, facts) {
 		case "application": return facts.everConnected || age !== null;
 		case "schema": return facts.discoveredTableCount > 0;
 		case "mapping": return facts.mappedEntityCount > 0;
-		case "trigger": return facts.triggerConfigured;
+		case "trigger": return facts.triggerConfigured && !triggerUnreachable(facts);
 		case "sync": return facts.lastRun?.ok === true;
 		default: return facts.widgetInstalled;
 	}
@@ -153,11 +179,16 @@ function evidenceFor(id, facts) {
 	if (id === "application" && age !== null) return `heartbeat ${formatAge(age)}`;
 	if (id === "schema" && facts.discoveredTableCount > 0) return `found ${facts.discoveredTableCount} tables`;
 	if (id === "mapping" && facts.mappedEntityCount > 0) return `${facts.mappedEntityCount} entity mapped`;
-	if (id === "trigger" && facts.triggerConfigured) return "trigger URL and secret set";
+	if (id === "trigger" && facts.triggerConfigured) return triggerUnreachable(facts) ? "set, but the last attempt could not reach your app" : "trigger URL and secret set";
 	if (id === "sync" && facts.lastRun) return `last run ${formatAge(facts.now - facts.lastRun.at)}`;
 	return null;
 }
 function problemFor(id, facts) {
+	if (id === "trigger" && triggerUnreachable(facts)) return {
+		code: "trigger_unreachable",
+		message: "The trigger URL is set, but Clivly could not reach your app there.",
+		fix: "Check the app is running and serving that URL. A dev tunnel URL changes every session — `clivly dev` keeps it registered for you."
+	};
 	if (id === "sync" && facts.lastRun && !facts.lastRun.ok) return {
 		code: "sync_failed",
 		message: facts.lastRun.message ?? "The last sync run failed.",

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@clivly/core",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "private": false,
-  "type": "module",
   "description": "ORM/auth-agnostic CRM adapter contracts and shared domain types for Clivly.",
   "license": "MIT",
   "sideEffects": false,
+  "type": "module",
   "exports": {
     ".": {
       "import": {
@@ -161,12 +161,15 @@
   "files": [
     "dist"
   ],
-  "publishConfig": {
-    "access": "public"
-  },
   "dependencies": {
     "zod": "^4.1.13"
   },
+  "devDependencies": {
+    "drizzle-orm": "^0.45.1",
+    "tsdown": "^0.22.14",
+    "typescript": "^6",
+    "vitest": "3.2.7"
+  },
   "peerDependencies": {
     "drizzle-orm": ">=0.30 || >=1.0.0-rc.0"
   },
@@ -175,21 +178,18 @@
       "optional": true
     }
   },
-  "devDependencies": {
-    "drizzle-orm": "^0.45.1",
-    "tsdown": "^0.22.14",
-    "typescript": "^6",
-    "vitest": "3.2.7"
-  },
   "engines": {
     "node": ">=22"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsdown",
     "check-types": "tsc --noEmit",
     "test": "vitest run"
   },
   "main": "./dist/index.cjs",
-  "types": "./dist/index.d.cts",
-  "module": "./dist/index.mjs"
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts"
 }