@ima-jin/config 0.7.0 → 0.8.0

package/src/services.ts

@@ -62,6 +62,9 @@ export const SERVICES: readonly ServiceDefinition[] = [
   { name: 'github',      label: 'GitHub',      icon: '🐙', description: 'Source code',                                       devPort: 3000, prodPort: 7000, schema: "public",      tier: 'core',   visibility: 'public',        category: 'meta', externalUrl: 'https://github.com/ima-jin/imajin-ai' },
   { name: 'docs',        label: 'Docs',        icon: '📄', description: 'API documentation',                                 devPort: 3000, prodPort: 7000, schema: "public",      tier: 'core',   visibility: 'public',        category: 'meta', wwwPath: '/developer-guide' },
 
+  // Daemon processes — not web apps, no HTTP port exposed
+  { name: 'broker-agent', label: 'Broker Agent', icon: '🤖', description: 'Telegram broker agent — conversational surface for social coordination (#1101)', devPort: 0, prodPort: 0, schema: null, tier: 'core', visibility: 'internal', category: 'infrastructure' },
+
   // Connected apps (separate repos) will use the plugin architecture (#249).
   // Not included here — they authenticate via delegated sessions, not the monorepo manifest.
 ] as const satisfies readonly ServiceDefinition[];
@@ -76,7 +79,8 @@ export function getService(name: string): ServiceDefinition | undefined {
 /** Get the port for a service in a given environment */
 export function getPort(name: string, env: "dev" | "prod" = "dev"): number | undefined {
   const svc = getService(name);
-  return svc ? (env === "prod" ? svc.prodPort : svc.devPort) : undefined;
+  if (!svc) return undefined;
+  return env === "prod" ? svc.prodPort : svc.devPort;
 }
 
 /** Get internal URL for a service (server-side calls) */
@@ -115,7 +119,7 @@ export function getPublicUrl(
 
   // Single-domain mode: prefix contains dots (e.g. "dev-jin.imajin.ai/")
   // Build https://{prefix}{name} instead of https://{prefix}-{name}.{domain}
-  if (prefix && prefix.includes(".")) {
+  if (prefix?.includes(".")) {
     const base = prefix.endsWith("/") ? prefix.slice(0, -1) : prefix;
     // "www" or "kernel" = root of the node, no suffix
     if (name === "www" || name === "kernel") return `https://${base}`;
@@ -147,8 +151,8 @@ export function buildPublicUrl(
     if (explicit) return explicit;
   }
 
-  const p = servicePrefix ?? (typeof process !== "undefined" ? process.env.NEXT_PUBLIC_SERVICE_PREFIX : undefined) ?? "https://";
-  const d = domain ?? (typeof process !== "undefined" ? process.env.NEXT_PUBLIC_DOMAIN : undefined) ?? "imajin.ai";
+  const p = servicePrefix ?? (typeof process === "undefined"  ? undefined : process.env.NEXT_PUBLIC_SERVICE_PREFIX) ?? "https://";
+  const d = domain ?? (typeof process === "undefined"  ? undefined : process.env.NEXT_PUBLIC_DOMAIN) ?? "imajin.ai";
 
   // Localhost detection
   if (p.includes("localhost") || d.includes("localhost")) {
@@ -168,6 +172,45 @@ export function buildPublicUrl(
   return getPublicUrl(name, { prefix: match, domain: d });
 }
 
+/**
+ * Build an ABSOLUTE public URL for a service — for use OUTSIDE the browser
+ * origin: email links, Stripe/webhook return/success URLs, externally shared
+ * links, and cross-node links. Unlike buildPublicUrl(), this never returns a
+ * relative path.
+ *
+ * Resolution order:
+ *   1. explicit NEXT_PUBLIC_{NAME}_URL env var (only if already absolute)
+ *   2. localhost dev → http://localhost:{devPort} from the canonical port map
+ *   3. otherwise an absolute https URL derived from NEXT_PUBLIC_SERVICE_PREFIX
+ *      + NEXT_PUBLIC_DOMAIN via getPublicUrl()
+ *
+ * @example
+ *   buildPublicUrlAbsolute('chat')   → https://jin.imajin.ai/chat (single-domain)
+ *   buildPublicUrlAbsolute('kernel') → https://jin.imajin.ai (node root)
+ */
+export function buildPublicUrlAbsolute(name: string): string {
+  // 1. Explicit per-service override wins if it is already absolute.
+  if (typeof process !== "undefined") {
+    const explicit = process.env[`NEXT_PUBLIC_${name.toUpperCase()}_URL`];
+    if (explicit && /^https?:\/\//.test(explicit)) return explicit;
+  }
+
+  const prefix =
+    (typeof process === "undefined" ? undefined : process.env.NEXT_PUBLIC_SERVICE_PREFIX) ?? "https://";
+  const domain =
+    (typeof process === "undefined" ? undefined : process.env.NEXT_PUBLIC_DOMAIN) ?? "imajin.ai";
+
+  // 2. Localhost dev → canonical dev port.
+  if (prefix.includes("localhost") || domain.includes("localhost")) {
+    const port = getPort(name, "dev");
+    return port ? `http://localhost:${port}` : "http://localhost:3000";
+  }
+
+  // 3. Force absolute construction (getPublicUrl never returns a relative path).
+  const match = prefix.replace(/^https?:\/\//, "").replace(/-$/, "") || undefined;
+  return getPublicUrl(name, { prefix: match, domain });
+}
+
 /** All service names */
 export const SERVICE_NAMES = SERVICES.map((s) => s.name);