clivly 0.3.0-next.2 → 0.3.0-next.3

package/{namespace-probe-BtS0nXcr.d.cts → namespace-probe-CcYne5Je.d.cts}

@@ -64,6 +64,12 @@ interface ClivlySDKConfig {
    * `contactEntity`.
    */
   entities?: ClivlyEntitiesConfig;
+  /**
+   * Environment to read platform variables from when discovering the public
+   * trigger URL. Defaults to `process.env`. Injectable so tests and non-Node
+   * runtimes can supply their own.
+   */
+  env?: Record<string, string | undefined>;
   /**
    * 🚧 Not implemented in 0.1.x. Reserved options for tunnel mode and CRM
    * write-back — they have NO effect yet and land with the Cloudflare
@@ -140,8 +146,19 @@ interface ClivlySDKConfig {
      * Public URL of the route where `createClivlyHandler()` is mounted, e.g.
      * `https://app.example.com/api/clivly/tick`. Reported to Clivly on each
      * heartbeat; a URL set in the dashboard overrides it.
+     *
+     * Optional — leave it unset and the SDK discovers the URL itself, from the
+     * hosting platform's environment or from the first request the route
+     * serves. Set it only to pin an address the SDK can't infer.
      */
     url?: string;
+    /**
+     * Path where `createClivlyHandler()` is mounted, e.g. `/api/clivly/tick`.
+     * Written by `clivly init`. Combined with the origin detected from the
+     * hosting platform so the SDK can report a trigger URL on its very first
+     * heartbeat, before any request has arrived to observe.
+     */
+    path?: string;
     /**
      * Signing secret (`whsec_…`) issued by Clivly under Integrations → Remote
      * sync. When set, `createClivlyHandler()` rejects any request that isn't

package/{namespace-probe-CYMie-BI.d.mts → namespace-probe-DjWzU9gG.d.mts}

@@ -64,6 +64,12 @@ interface ClivlySDKConfig {
    * `contactEntity`.
    */
   entities?: ClivlyEntitiesConfig;
+  /**
+   * Environment to read platform variables from when discovering the public
+   * trigger URL. Defaults to `process.env`. Injectable so tests and non-Node
+   * runtimes can supply their own.
+   */
+  env?: Record<string, string | undefined>;
   /**
    * 🚧 Not implemented in 0.1.x. Reserved options for tunnel mode and CRM
    * write-back — they have NO effect yet and land with the Cloudflare
@@ -140,8 +146,19 @@ interface ClivlySDKConfig {
      * Public URL of the route where `createClivlyHandler()` is mounted, e.g.
      * `https://app.example.com/api/clivly/tick`. Reported to Clivly on each
      * heartbeat; a URL set in the dashboard overrides it.
+     *
+     * Optional — leave it unset and the SDK discovers the URL itself, from the
+     * hosting platform's environment or from the first request the route
+     * serves. Set it only to pin an address the SDK can't infer.
      */
     url?: string;
+    /**
+     * Path where `createClivlyHandler()` is mounted, e.g. `/api/clivly/tick`.
+     * Written by `clivly init`. Combined with the origin detected from the
+     * hosting platform so the SDK can report a trigger URL on its very first
+     * heartbeat, before any request has arrived to observe.
+     */
+    path?: string;
     /**
      * Signing secret (`whsec_…`) issued by Clivly under Integrations → Remote
      * sync. When set, `createClivlyHandler()` rejects any request that isn't

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clivly",
-  "version": "0.3.0-next.2",
+  "version": "0.3.0-next.3",
   "private": false,
   "type": "module",
   "description": "Clivly CLI — scaffold a CRM into your app (clivly init).",

package/{sdk-vu_uej2q.mjs → sdk-DtFmeuwl.mjs}

@@ -1,4 +1,41 @@
-import { t as DRIZZLE_META } from "./drizzle-meta-1z6Apnt-.mjs";
+import { t as DRIZZLE_META } from "./drizzle-meta-DpMKataU.mjs";
+//#region ../sdk/src/custom-slug.ts
+const NON_ALNUM = /[^a-z0-9]+/g;
+const EDGE_HYPHENS = /(^-|-$)/g;
+function slugify(value) {
+	return value.toLowerCase().trim().replace(NON_ALNUM, "-").replace(EDGE_HYPHENS, "");
+}
+function checkCustomObjectSlugs(config) {
+	const custom = config.source?.custom ?? [];
+	if (custom.length === 0) return {
+		name: "Custom object slugs",
+		ok: false,
+		skipped: true,
+		detail: "No custom objects configured."
+	};
+	const problems = [];
+	const seen = /* @__PURE__ */ new Map();
+	for (const source of custom) {
+		const declared = source.objectType;
+		const canonical = slugify(declared);
+		if (canonical === "") problems.push(`"${source.entity}" has an empty objectType.`);
+		else if (canonical !== declared) problems.push(`"${declared}" is not a slug — the dashboard would store it as "${canonical}".`);
+		const prior = seen.get(canonical);
+		if (prior && canonical !== "") problems.push(`duplicate slug "${canonical}" declared by "${prior}" and "${source.entity}".`);
+		else seen.set(canonical, source.entity);
+	}
+	if (problems.length > 0) return {
+		name: "Custom object slugs",
+		ok: false,
+		detail: problems.join(" ")
+	};
+	return {
+		name: "Custom object slugs",
+		ok: true,
+		detail: `Ensure these object types exist in Clivly: ${custom.map((source) => source.objectType).join(", ")}.`
+	};
+}
+//#endregion
 //#region ../sdk/src/namespace-probe.ts
 /**
 * Verify the tables the integration depends on are genuinely reachable:
@@ -159,6 +196,7 @@ async function runDoctor(args) {
 		ok: result.ok,
 		detail: result.ok ? `Reached Clivly — org "${result.org?.name ?? "(unnamed)"}".` : `Could not connect (${result.reason}).`
 	});
+	checks.push(checkCustomObjectSlugs(config));
 	checks.push(await namespaceCheck(config));
 	return {
 		ok: checks.every((check) => check.skipped || check.ok),
@@ -257,6 +295,85 @@ async function fullSyncSource(args) {
 	};
 }
 //#endregion
+//#region ../sdk/src/trigger-url.ts
+const SCHEME_REGEX = /^https?:\/\//;
+const INVALID_HOST_CHARS_REGEX = /[/\\@?#\s]/;
+const PLATFORM_ORIGIN_SOURCES = [
+	{
+		key: "VERCEL_URL",
+		toOrigin: (value) => withScheme(value)
+	},
+	{
+		key: "CF_PAGES_URL",
+		toOrigin: (value) => withScheme(value)
+	},
+	{
+		key: "RAILWAY_PUBLIC_DOMAIN",
+		toOrigin: (value) => withScheme(value)
+	},
+	{
+		key: "RENDER_EXTERNAL_URL",
+		toOrigin: (value) => withScheme(value)
+	},
+	{
+		key: "FLY_APP_NAME",
+		toOrigin: (value) => `https://${value}.fly.dev`
+	}
+];
+function withScheme(value) {
+	return SCHEME_REGEX.test(value) ? value : `https://${value}`;
+}
+function stripTrailingSlash(value) {
+	return value.endsWith("/") ? value.slice(0, -1) : value;
+}
+/**
+* Derive the app's public origin from known platform environment variables.
+* Returns an origin with no trailing slash, or undefined when nothing matches.
+*/
+function originFromPlatformEnv(env) {
+	for (const source of PLATFORM_ORIGIN_SOURCES) {
+		const raw = env[source.key]?.trim();
+		if (raw) return stripTrailingSlash(source.toOrigin(raw));
+	}
+}
+function observedTriggerUrl(req) {
+	const host = (req.headers.get("x-forwarded-host") ?? req.headers.get("host"))?.trim();
+	if (!host) return;
+	if (INVALID_HOST_CHARS_REGEX.test(host)) return;
+	const forwardedProto = req.headers.get("x-forwarded-proto")?.split(",")[0]?.trim();
+	let requestUrl;
+	try {
+		requestUrl = new URL(req.url);
+	} catch {
+		return;
+	}
+	const proto = forwardedProto || requestUrl.protocol.replace(":", "");
+	try {
+		return new URL(`${proto}://${host}${requestUrl.pathname}`).toString();
+	} catch {
+		return;
+	}
+}
+/**
+* Decide which trigger URL to report, in precedence order:
+*
+*   1. `configuredUrl` — an explicit `syncTrigger.url`. Someone typed this on
+*      purpose, so it beats anything inferred.
+*   2. platform env origin + `configuredPath` — available at boot, before any
+*      request has arrived. Needs the path because platform variables only give
+*      an origin.
+*   3. `observedUrl` — accurate but only after the route has served a request.
+*
+* A URL set in the Clivly dashboard overrides all of these server-side; the SDK
+* doesn't need to know about it.
+*/
+function resolveTriggerUrl(args) {
+	if (args.configuredUrl) return args.configuredUrl;
+	const origin = originFromPlatformEnv(args.env);
+	if (origin && args.configuredPath) return `${origin}${args.configuredPath.startsWith("/") ? args.configuredPath : `/${args.configuredPath}`}`;
+	return args.observedUrl;
+}
+//#endregion
 //#region ../sdk/src/errors.ts
 var ClivlyError = class ClivlyError extends Error {
 	/** HTTP status, or null when the request never completed (network error). */
@@ -547,6 +664,7 @@ function createClivlySDK(config) {
 	const cursorStore = config.cursorStore ?? createMemoryCursorStore();
 	const fetcher = createFetcher(config.retry);
 	let warnedUnsignedTrigger = false;
+	let observedUrl;
 	let lastPushFailure = null;
 	const createPush = (runId) => async (path, body) => {
 		const response = await fetcher(`${apiUrl}${path}`, {
@@ -631,7 +749,15 @@ function createClivlySDK(config) {
 			contactEntity: resolveContactEntity(config),
 			namespaceReady: config.namespaceReady ?? false,
 			schema: buildSchema(config),
-			...config.syncTrigger?.url ? { syncTrigger: { url: config.syncTrigger.url } } : {}
+			...(() => {
+				const url = resolveTriggerUrl({
+					configuredUrl: config.syncTrigger?.url,
+					configuredPath: config.syncTrigger?.path,
+					env: config.env ?? process.env,
+					observedUrl
+				});
+				return url ? { syncTrigger: { url } } : {};
+			})()
 		})
 	});
 	const heartbeat = async () => {
@@ -685,6 +811,7 @@ function createClivlySDK(config) {
 		}
 	};
 	const createClivlyHandler = () => async (req) => {
+		observedUrl = observedTriggerUrl(req) ?? observedUrl;
 		const rawBody = await req.text().catch(() => "");
 		if (!await triggerRequestAllowed(req, rawBody)) return jsonResponse({
 			ok: false,

package/{sdk-BNdK3KgW.cjs → sdk-r4khXzoH.cjs}

@@ -1,4 +1,41 @@
-const require_drizzle_meta = require("./drizzle-meta-CM5M73Z4.cjs");
+const require_drizzle_meta = require("./drizzle-meta-BVR1qiyu.cjs");
+//#region ../sdk/src/custom-slug.ts
+const NON_ALNUM = /[^a-z0-9]+/g;
+const EDGE_HYPHENS = /(^-|-$)/g;
+function slugify(value) {
+	return value.toLowerCase().trim().replace(NON_ALNUM, "-").replace(EDGE_HYPHENS, "");
+}
+function checkCustomObjectSlugs(config) {
+	const custom = config.source?.custom ?? [];
+	if (custom.length === 0) return {
+		name: "Custom object slugs",
+		ok: false,
+		skipped: true,
+		detail: "No custom objects configured."
+	};
+	const problems = [];
+	const seen = /* @__PURE__ */ new Map();
+	for (const source of custom) {
+		const declared = source.objectType;
+		const canonical = slugify(declared);
+		if (canonical === "") problems.push(`"${source.entity}" has an empty objectType.`);
+		else if (canonical !== declared) problems.push(`"${declared}" is not a slug — the dashboard would store it as "${canonical}".`);
+		const prior = seen.get(canonical);
+		if (prior && canonical !== "") problems.push(`duplicate slug "${canonical}" declared by "${prior}" and "${source.entity}".`);
+		else seen.set(canonical, source.entity);
+	}
+	if (problems.length > 0) return {
+		name: "Custom object slugs",
+		ok: false,
+		detail: problems.join(" ")
+	};
+	return {
+		name: "Custom object slugs",
+		ok: true,
+		detail: `Ensure these object types exist in Clivly: ${custom.map((source) => source.objectType).join(", ")}.`
+	};
+}
+//#endregion
 //#region ../sdk/src/namespace-probe.ts
 /**
 * Verify the tables the integration depends on are genuinely reachable:
@@ -159,6 +196,7 @@ async function runDoctor(args) {
 		ok: result.ok,
 		detail: result.ok ? `Reached Clivly — org "${result.org?.name ?? "(unnamed)"}".` : `Could not connect (${result.reason}).`
 	});
+	checks.push(checkCustomObjectSlugs(config));
 	checks.push(await namespaceCheck(config));
 	return {
 		ok: checks.every((check) => check.skipped || check.ok),
@@ -257,6 +295,85 @@ async function fullSyncSource(args) {
 	};
 }
 //#endregion
+//#region ../sdk/src/trigger-url.ts
+const SCHEME_REGEX = /^https?:\/\//;
+const INVALID_HOST_CHARS_REGEX = /[/\\@?#\s]/;
+const PLATFORM_ORIGIN_SOURCES = [
+	{
+		key: "VERCEL_URL",
+		toOrigin: (value) => withScheme(value)
+	},
+	{
+		key: "CF_PAGES_URL",
+		toOrigin: (value) => withScheme(value)
+	},
+	{
+		key: "RAILWAY_PUBLIC_DOMAIN",
+		toOrigin: (value) => withScheme(value)
+	},
+	{
+		key: "RENDER_EXTERNAL_URL",
+		toOrigin: (value) => withScheme(value)
+	},
+	{
+		key: "FLY_APP_NAME",
+		toOrigin: (value) => `https://${value}.fly.dev`
+	}
+];
+function withScheme(value) {
+	return SCHEME_REGEX.test(value) ? value : `https://${value}`;
+}
+function stripTrailingSlash(value) {
+	return value.endsWith("/") ? value.slice(0, -1) : value;
+}
+/**
+* Derive the app's public origin from known platform environment variables.
+* Returns an origin with no trailing slash, or undefined when nothing matches.
+*/
+function originFromPlatformEnv(env) {
+	for (const source of PLATFORM_ORIGIN_SOURCES) {
+		const raw = env[source.key]?.trim();
+		if (raw) return stripTrailingSlash(source.toOrigin(raw));
+	}
+}
+function observedTriggerUrl(req) {
+	const host = (req.headers.get("x-forwarded-host") ?? req.headers.get("host"))?.trim();
+	if (!host) return;
+	if (INVALID_HOST_CHARS_REGEX.test(host)) return;
+	const forwardedProto = req.headers.get("x-forwarded-proto")?.split(",")[0]?.trim();
+	let requestUrl;
+	try {
+		requestUrl = new URL(req.url);
+	} catch {
+		return;
+	}
+	const proto = forwardedProto || requestUrl.protocol.replace(":", "");
+	try {
+		return new URL(`${proto}://${host}${requestUrl.pathname}`).toString();
+	} catch {
+		return;
+	}
+}
+/**
+* Decide which trigger URL to report, in precedence order:
+*
+*   1. `configuredUrl` — an explicit `syncTrigger.url`. Someone typed this on
+*      purpose, so it beats anything inferred.
+*   2. platform env origin + `configuredPath` — available at boot, before any
+*      request has arrived. Needs the path because platform variables only give
+*      an origin.
+*   3. `observedUrl` — accurate but only after the route has served a request.
+*
+* A URL set in the Clivly dashboard overrides all of these server-side; the SDK
+* doesn't need to know about it.
+*/
+function resolveTriggerUrl(args) {
+	if (args.configuredUrl) return args.configuredUrl;
+	const origin = originFromPlatformEnv(args.env);
+	if (origin && args.configuredPath) return `${origin}${args.configuredPath.startsWith("/") ? args.configuredPath : `/${args.configuredPath}`}`;
+	return args.observedUrl;
+}
+//#endregion
 //#region ../sdk/src/errors.ts
 var ClivlyError = class ClivlyError extends Error {
 	/** HTTP status, or null when the request never completed (network error). */
@@ -547,6 +664,7 @@ function createClivlySDK(config) {
 	const cursorStore = config.cursorStore ?? createMemoryCursorStore();
 	const fetcher = createFetcher(config.retry);
 	let warnedUnsignedTrigger = false;
+	let observedUrl;
 	let lastPushFailure = null;
 	const createPush = (runId) => async (path, body) => {
 		const response = await fetcher(`${apiUrl}${path}`, {
@@ -631,7 +749,15 @@ function createClivlySDK(config) {
 			contactEntity: resolveContactEntity(config),
 			namespaceReady: config.namespaceReady ?? false,
 			schema: buildSchema(config),
-			...config.syncTrigger?.url ? { syncTrigger: { url: config.syncTrigger.url } } : {}
+			...(() => {
+				const url = resolveTriggerUrl({
+					configuredUrl: config.syncTrigger?.url,
+					configuredPath: config.syncTrigger?.path,
+					env: config.env ?? process.env,
+					observedUrl
+				});
+				return url ? { syncTrigger: { url } } : {};
+			})()
 		})
 	});
 	const heartbeat = async () => {
@@ -685,6 +811,7 @@ function createClivlySDK(config) {
 		}
 	};
 	const createClivlyHandler = () => async (req) => {
+		observedUrl = observedTriggerUrl(req) ?? observedUrl;
 		const rawBody = await req.text().catch(() => "");
 		if (!await triggerRequestAllowed(req, rawBody)) return jsonResponse({
 			ok: false,

package/sdk.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sdk = require("./sdk-BNdK3KgW.cjs");
+const require_sdk = require("./sdk-r4khXzoH.cjs");
 exports.ClivlyAuthError = require_sdk.ClivlyAuthError;
 exports.ClivlyError = require_sdk.ClivlyError;
 exports.ClivlyNetworkError = require_sdk.ClivlyNetworkError;

package/sdk.d.cts

@@ -1,4 +1,4 @@
-import { a as ClivlySDKConfig, c as DiscoveredTable, i as ClivlySDK, l as DoctorCheck, n as ClivlyConnectReason, o as ClivlyUser, r as ClivlyConnectResult, s as CursorStore, u as DoctorReport } from "./namespace-probe-BtS0nXcr.cjs";
+import { a as ClivlySDKConfig, c as DiscoveredTable, i as ClivlySDK, l as DoctorCheck, n as ClivlyConnectReason, o as ClivlyUser, r as ClivlyConnectResult, s as CursorStore, u as DoctorReport } from "./namespace-probe-CcYne5Je.cjs";
 
 //#region ../sdk/src/errors.d.ts
 declare class ClivlyError extends Error {

package/sdk.d.mts

@@ -1,4 +1,4 @@
-import { a as ClivlySDKConfig, c as DiscoveredTable, i as ClivlySDK, l as DoctorCheck, n as ClivlyConnectReason, o as ClivlyUser, r as ClivlyConnectResult, s as CursorStore, u as DoctorReport } from "./namespace-probe-CYMie-BI.mjs";
+import { a as ClivlySDKConfig, c as DiscoveredTable, i as ClivlySDK, l as DoctorCheck, n as ClivlyConnectReason, o as ClivlyUser, r as ClivlyConnectResult, s as CursorStore, u as DoctorReport } from "./namespace-probe-DjWzU9gG.mjs";
 
 //#region ../sdk/src/errors.d.ts
 declare class ClivlyError extends Error {

package/sdk.mjs

@@ -1,2 +1,2 @@
-import { a as ClivlyRateLimitError, i as ClivlyNetworkError, n as ClivlyAuthError, r as ClivlyError, t as createClivlySDK } from "./sdk-vu_uej2q.mjs";
+import { a as ClivlyRateLimitError, i as ClivlyNetworkError, n as ClivlyAuthError, r as ClivlyError, t as createClivlySDK } from "./sdk-DtFmeuwl.mjs";
 export { ClivlyAuthError, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, createClivlySDK };

package/vite.d.cts

@@ -1,4 +1,4 @@
-import { i as ClivlySDK } from "./namespace-probe-BtS0nXcr.cjs";
+import { i as ClivlySDK } from "./namespace-probe-CcYne5Je.cjs";
 import { Plugin } from "vite";
 
 //#region ../sdk/src/vite.d.ts

package/vite.d.mts

@@ -1,4 +1,4 @@
-import { i as ClivlySDK } from "./namespace-probe-CYMie-BI.mjs";
+import { i as ClivlySDK } from "./namespace-probe-DjWzU9gG.mjs";
 import { Plugin } from "vite";
 
 //#region ../sdk/src/vite.d.ts