@clivly/sdk 0.3.0-next.3 → 0.3.0-next.5

package/dist/index.cjs

@@ -12,7 +12,7 @@ function checkCustomObjectSlugs(config) {
 		name: "Custom object slugs",
 		ok: false,
 		skipped: true,
-		detail: "No custom objects configured."
+		detail: "No custom objects in clivly.config. Objects added in the dashboard need a matching source.custom entry here to sync."
 	};
 	const problems = [];
 	const seen = /* @__PURE__ */ new Map();
@@ -37,6 +37,49 @@ function checkCustomObjectSlugs(config) {
 	};
 }
 //#endregion
+//#region src/fetch-error.ts
+/** Deepest `Error` reachable through the `.cause` chain (the original error if none). */
+function rootError(error) {
+	let current = error;
+	const seen = /* @__PURE__ */ new Set();
+	while (current instanceof Error && current.cause !== void 0 && !seen.has(current)) {
+		seen.add(current);
+		current = current.cause;
+	}
+	return current;
+}
+function codeOf(error) {
+	const code = error?.code;
+	return typeof code === "string" ? code : void 0;
+}
+const CODE_HINTS = {
+	ECONNREFUSED: "the database refused the connection — is Postgres running and is your database URL (e.g. DATABASE_URL) pointing at it?",
+	ENOTFOUND: "the database host couldn't be resolved — check the host in your connection string.",
+	ETIMEDOUT: "the database connection timed out — check the host, port, and firewall.",
+	"28P01": "password authentication failed — check the credentials in your connection string.",
+	"28000": "the database rejected the connection role — check the user in your connection string.",
+	"3D000": "that database does not exist — check the database name in your connection string.",
+	"08006": "the database connection was lost — check that Postgres is reachable."
+};
+const NEWLINE = /\r?\n/;
+/** One-line, single-spaced version of an error message (drops the SQL/params blob). */
+function firstLine(message) {
+	const line = message.split(NEWLINE)[0]?.trim() ?? "";
+	return line === "" ? message.trim() : line;
+}
+/**
+* Build the `detail` string for a failed sample fetch of `entity`.
+* Recognised connection errors get a plain-English hint; everything else
+* surfaces the root cause's first line rather than the wrapper's SQL dump.
+*/
+function describeFetchError(entity, error) {
+	const root = rootError(error);
+	const code = codeOf(root) ?? codeOf(error);
+	const hint = code ? CODE_HINTS[code] : void 0;
+	if (hint) return `Couldn't read "${entity}": ${hint}`;
+	return `Couldn't read "${entity}": ${firstLine(root instanceof Error ? root.message : String(root?.message ?? root ?? "unknown error"))}`;
+}
+//#endregion
 //#region src/namespace-probe.ts
 /**
 * Verify the tables the integration depends on are genuinely reachable:
@@ -188,7 +231,7 @@ async function runDoctor(args) {
 		checks.push({
 			name: `Sample fetch (${source.entity})`,
 			ok: false,
-			detail: `"${source.entity}" fetchPage threw: ${error.message}`
+			detail: describeFetchError(source.entity, error)
 		});
 	}
 	const result = await connect();

package/dist/index.mjs

@@ -11,7 +11,7 @@ function checkCustomObjectSlugs(config) {
 		name: "Custom object slugs",
 		ok: false,
 		skipped: true,
-		detail: "No custom objects configured."
+		detail: "No custom objects in clivly.config. Objects added in the dashboard need a matching source.custom entry here to sync."
 	};
 	const problems = [];
 	const seen = /* @__PURE__ */ new Map();
@@ -36,6 +36,49 @@ function checkCustomObjectSlugs(config) {
 	};
 }
 //#endregion
+//#region src/fetch-error.ts
+/** Deepest `Error` reachable through the `.cause` chain (the original error if none). */
+function rootError(error) {
+	let current = error;
+	const seen = /* @__PURE__ */ new Set();
+	while (current instanceof Error && current.cause !== void 0 && !seen.has(current)) {
+		seen.add(current);
+		current = current.cause;
+	}
+	return current;
+}
+function codeOf(error) {
+	const code = error?.code;
+	return typeof code === "string" ? code : void 0;
+}
+const CODE_HINTS = {
+	ECONNREFUSED: "the database refused the connection — is Postgres running and is your database URL (e.g. DATABASE_URL) pointing at it?",
+	ENOTFOUND: "the database host couldn't be resolved — check the host in your connection string.",
+	ETIMEDOUT: "the database connection timed out — check the host, port, and firewall.",
+	"28P01": "password authentication failed — check the credentials in your connection string.",
+	"28000": "the database rejected the connection role — check the user in your connection string.",
+	"3D000": "that database does not exist — check the database name in your connection string.",
+	"08006": "the database connection was lost — check that Postgres is reachable."
+};
+const NEWLINE = /\r?\n/;
+/** One-line, single-spaced version of an error message (drops the SQL/params blob). */
+function firstLine(message) {
+	const line = message.split(NEWLINE)[0]?.trim() ?? "";
+	return line === "" ? message.trim() : line;
+}
+/**
+* Build the `detail` string for a failed sample fetch of `entity`.
+* Recognised connection errors get a plain-English hint; everything else
+* surfaces the root cause's first line rather than the wrapper's SQL dump.
+*/
+function describeFetchError(entity, error) {
+	const root = rootError(error);
+	const code = codeOf(root) ?? codeOf(error);
+	const hint = code ? CODE_HINTS[code] : void 0;
+	if (hint) return `Couldn't read "${entity}": ${hint}`;
+	return `Couldn't read "${entity}": ${firstLine(root instanceof Error ? root.message : String(root?.message ?? root ?? "unknown error"))}`;
+}
+//#endregion
 //#region src/namespace-probe.ts
 /**
 * Verify the tables the integration depends on are genuinely reachable:
@@ -187,7 +230,7 @@ async function runDoctor(args) {
 		checks.push({
 			name: `Sample fetch (${source.entity})`,
 			ok: false,
-			detail: `"${source.entity}" fetchPage threw: ${error.message}`
+			detail: describeFetchError(source.entity, error)
 		});
 	}
 	const result = await connect();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clivly/sdk",
-  "version": "0.3.0-next.3",
+  "version": "0.3.0-next.5",
   "private": false,
   "type": "module",
   "description": "Clivly SDK — connect your app to Clivly Cloud (heartbeat, discovery, auth bridge).",
@@ -45,7 +45,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@clivly/core": "0.3.0-next.3"
+    "@clivly/core": "0.3.0-next.5"
   },
   "peerDependencies": {
     "drizzle-orm": ">=0.30",