@growthub/cli 0.7.9 → 0.8.1

package/assets/worker-kits/growthub-agency-portal-starter-v1/apps/agency-portal/app/page.jsx

@@ -0,0 +1,165 @@
+import { describeAuthAdapter } from "@/lib/adapters/auth";
+import { readAdapterConfig } from "@/lib/adapters/env";
+import { describePaymentAdapter } from "@/lib/adapters/payments";
+import { describePersistenceAdapter } from "@/lib/adapters/persistence";
+import { portalCapabilities } from "@/lib/domain/portal";
+import Link from "next/link";
+const nav = [
+  ...portalCapabilities.map((item) => ({ href: `#${item.id}`, label: item.label })),
+  { href: "/settings/integrations", label: "Integrations" }
+];
+const quickActions = [
+  "Client onboarding",
+  "Publish report",
+  "Sync Windsor data",
+  "Review open tasks"
+];
+function Home() {
+  const config = readAdapterConfig();
+  const persistence = describePersistenceAdapter();
+  const auth = describeAuthAdapter();
+  const payments = describePaymentAdapter();
+  return <main className="shell">
+      <aside className="sidebar">
+        <div className="brand">
+          <span className="brand-mark">GH</span>
+          <span>Agency Portal</span>
+        </div>
+        <nav className="nav">
+          {nav.map((item, index) => <Link className={index === 0 ? "active" : ""} href={item.href} key={item.href}>{item.label}</Link>)}
+        </nav>
+        <div className="sidebar-footer">
+          <span className="status-dot" />
+          Governed worker kit
+        </div>
+      </aside>
+
+      <section className="main">
+        <div className="utility-bar">
+          <div>
+            <strong>Production workspace</strong>
+            <span>Local customization, Vercel deployment, bridge-ready integrations.</span>
+          </div>
+          <div className="utility-actions">
+            <Link href="/settings/integrations">Integrations</Link>
+            <span className="pill">v1 kit</span>
+          </div>
+        </div>
+
+        <div className="page-heading">
+          <div>
+            <p className="eyebrow">Growthub Local + Vercel</p>
+            <h1>Composable Agency Workspace</h1>
+            <p>
+              A production starter for agency portals with local-first Vite operation, Vercel
+              deployment, thin adapter contracts, Windsor data pipelines, and Growthub MCP
+              connection authority.
+            </p>
+          </div>
+          <span className="badge">deploy: {config.deployTarget}</span>
+        </div>
+
+        <section className="hero-grid" id="dashboard">
+          <article className="hero-card wide">
+            <p className="card-label">Monthly Revenue</p>
+            <strong>$0</strong>
+            <div className="progress"><span style={{ width: "0%" }} /></div>
+            <p className="muted">Connect persistence to populate invoices, retainers, and margin reporting.</p>
+          </article>
+          <article className="hero-card">
+            <p className="card-label">MCP Connections</p>
+            <strong>{config.integrationAdapter}</strong>
+            <p className="muted">Growthub bridge and BYO API key paths normalize into one object model.</p>
+          </article>
+          <article className="hero-card">
+            <p className="card-label">Client Results</p>
+            <strong>Windsor</strong>
+            <p className="muted">First-class Windsor AI and Google Sheets blended data pipeline support.</p>
+          </article>
+        </section>
+
+        <section className="ops-strip" aria-label="Setup paths">
+          <article>
+            <span>01</span>
+            <strong>Local Vite shell</strong>
+            <p>Use the same portal frame for agent-led local customization.</p>
+          </article>
+          <article>
+            <span>02</span>
+            <strong>Vercel app</strong>
+            <p>Deploy the Next app without binding persistence to a single provider.</p>
+          </article>
+          <article>
+            <span>03</span>
+            <strong>Growthub bridge</strong>
+            <p>Resolve hosted MCP accounts when the user connects Growthub authority.</p>
+          </article>
+          <article>
+            <span>04</span>
+            <strong>BYO keys</strong>
+            <p>Support Windsor and external provider keys through the same object contract.</p>
+          </article>
+        </section>
+
+        <section className="grid compact-grid">
+          {portalCapabilities.map((capability) => <article className="card" id={capability.id} key={capability.id}>
+              <h3>{capability.label}</h3>
+              <div className="metric">{capability.metric}</div>
+              <p>{capability.description}</p>
+            </article>)}
+        </section>
+
+        <section className="adapter" aria-label="Adapter contracts">
+          <article className="card">
+            <h3>Persistence</h3>
+            <p><strong>{persistence.label}</strong></p>
+            <p>Postgres, Qstash KV, or provider-managed.</p>
+          </article>
+          <article className="card">
+            <h3>Auth</h3>
+            <p><strong>{auth.id}</strong></p>
+            <p>{auth.requiredEnv.length ? auth.requiredEnv.join(", ") : "provider-defined"}</p>
+          </article>
+          <article className="card">
+            <h3>Payments</h3>
+            <p><strong>{payments.id}</strong></p>
+            <p>{payments.enabled ? "enabled" : "disabled"}</p>
+          </article>
+          <article className="card">
+            <h3>Integrations</h3>
+            <p><strong>{config.integrationAdapter}</strong></p>
+            <p><Link href="/settings/integrations">Open setup surface</Link></p>
+          </article>
+          <article className="card">
+            <h3>Worker API</h3>
+            <p><code>GET /api/workspace</code></p>
+            <p>Adapter and capability metadata for agents.</p>
+          </article>
+        </section>
+
+        <section className="results-panel" id="client-results">
+          <div>
+            <p className="eyebrow">Client Results</p>
+            <h2>Windsor AI + blended data ready</h2>
+            <p>
+              Windsor is a data pipeline object, not a database choice. Google Sheets blended
+              exports, GA4, Shopify, and Meta data stay composable through the integrations surface.
+            </p>
+          </div>
+          <div className="results-metrics">
+            <span>Meta</span>
+            <span>Shopify</span>
+            <span>GA4</span>
+            <span>Sheets</span>
+          </div>
+        </section>
+      </section>
+
+      <aside className="quick-actions" aria-label="Quick actions">
+        {quickActions.map((action) => <button type="button" key={action}>{action}</button>)}
+      </aside>
+    </main>;
+}
+export {
+  Home as default
+};

package/assets/worker-kits/growthub-agency-portal-starter-v1/apps/agency-portal/app/settings/integrations/page.jsx

@@ -0,0 +1,134 @@
+import { describeIntegrationAdapter, listAgencyPortalIntegrations } from "@/lib/adapters/integrations";
+import { portalCapabilities } from "@/lib/domain/portal";
+import { groupIntegrationsByLane } from "@/lib/domain/integrations";
+import Link from "next/link";
+const nav = [
+  ...portalCapabilities.map((item) => ({ href: `/#${item.id}`, label: item.label })),
+  { href: "/settings/integrations", label: "Integrations" }
+];
+async function IntegrationsSettingsPage() {
+  const adapter = describeIntegrationAdapter();
+  const grouped = groupIntegrationsByLane(await listAgencyPortalIntegrations());
+  const allIntegrations = [...grouped.dataSources, ...grouped.workspaceIntegrations];
+  const connectedCount = allIntegrations.filter((item) => item.isConnected).length;
+  return <main className="shell">
+      <aside className="sidebar">
+        <div className="brand">
+          <span className="brand-mark">GH</span>
+          <span>Agency Portal</span>
+        </div>
+        <nav className="nav">
+          {nav.map((item) => <Link className={item.href === "/settings/integrations" ? "active" : ""} key={item.href} href={item.href}>
+              {item.label}
+            </Link>)}
+        </nav>
+        <div className="sidebar-footer">
+          <span className="status-dot" />
+          {connectedCount} connected
+        </div>
+      </aside>
+
+      <section className="main">
+        <div className="utility-bar">
+          <div>
+            <strong>Integration setup</strong>
+            <span>Growthub bridge, BYO API keys, and Windsor data pipelines normalize into one worker-kit object model.</span>
+          </div>
+          <div className="utility-actions">
+            <span className="pill">{adapter.authority}</span>
+            <span className="pill">{adapter.source}</span>
+          </div>
+        </div>
+
+        <div className="page-heading">
+          <span className="eyebrow">Settings</span>
+          <h1>Integrations</h1>
+          <p>
+            Configure the portal through the hosted Growthub auth bridge or through explicit bring-your-own credentials.
+            Data pipeline objects stay separate from workspace integrations while sharing one normalized surface.
+          </p>
+          <span className="badge">{adapter.label}</span>
+        </div>
+
+        <section className="setup-grid" aria-label="Integration setup paths">
+          <article className="setup-card">
+            <span>01</span>
+            <strong>Growthub Bridge</strong>
+            <p>Uses the authenticated Growthub account to resolve already-connected MCP accounts for this portal.</p>
+            <code>GROWTHUB_BRIDGE_ACCESS_TOKEN</code>
+          </article>
+          <article className="setup-card">
+            <span>02</span>
+            <strong>BYO API Key</strong>
+            <p>Supports direct provider keys without binding the kit to a database, vendor, or hosted account.</p>
+            <code>AGENCY_PORTAL_BYO_CONNECTIONS_JSON</code>
+          </article>
+          <article className="setup-card">
+            <span>03</span>
+            <strong>Windsor Data</strong>
+            <p>First-class reporting pipeline for blended Meta, Shopify, GA4, and Google Sheets data sources.</p>
+            <code>WINDSOR_API_KEY</code>
+          </article>
+        </section>
+
+        <section className="integration-board">
+          <div className="integration-toolbar">
+            <div>
+              <strong>Connection authority</strong>
+              <p>{adapter.description}</p>
+            </div>
+            <code>GET /api/settings/integrations</code>
+          </div>
+
+          <IntegrationPanel
+    title="Data pipeline objects"
+    intro="Meta, Shopify, GA4, Windsor AI, and Google Sheets blended data feed reporting and analytics workflows."
+    items={grouped.dataSources}
+  />
+          <IntegrationPanel
+    title="MCP connection integrations"
+    intro="Asana, Slack, GHL, Google Drive, and Notion are operational integrations resolved through MCP connection authority or explicit BYO setup."
+    items={grouped.workspaceIntegrations}
+  />
+        </section>
+      </section>
+    </main>;
+}
+function IntegrationPanel({
+  title,
+  intro,
+  items
+}) {
+  const connected = items.filter((item) => item.isConnected).length;
+  return <article className="integration-section">
+      <div className="section-heading">
+        <div>
+          <h2>{title}</h2>
+          <p className="panel-copy">{intro}</p>
+        </div>
+        <span className="badge">{connected}/{items.length} connected</span>
+      </div>
+      <div className="integration-list">
+        {items.map((item) => <article className="integration-card" key={item.id}>
+            <div className="integration-card-top">
+              <div className="provider-mark">{item.label.slice(0, 1)}</div>
+              <div>
+                <strong>{item.label}</strong>
+                <p>{item.description}</p>
+              </div>
+              <span className={`status ${item.status}`}>{item.status}</span>
+            </div>
+            <div className="integration-card-meta">
+              <span>{item.provider}</span>
+              <span>{item.objectType}</span>
+              <span>{item.authPath}</span>
+              <span>{item.setupMode}</span>
+              {item.secretEnvName ? <span>{item.secretEnvName}</span> : null}
+            </div>
+          </article>)}
+      </div>
+    </article>;
+}
+export {
+  IntegrationsSettingsPage as default
+};

package/assets/worker-kits/growthub-agency-portal-starter-v1/apps/agency-portal/lib/adapters/auth/index.js

@@ -0,0 +1,21 @@
+import { readAdapterConfig } from "../env";
+function describeAuthAdapter() {
+  const { authAdapter } = readAdapterConfig();
+  if (authAdapter === "oidc") {
+    return {
+      id: "oidc",
+      requiredEnv: ["AUTH_SECRET", "AUTH_ISSUER", "AUTH_CLIENT_ID", "AUTH_CLIENT_SECRET"],
+      notes: ["Default portable auth contract for Vercel and local serverless use."]
+    };
+  }
+  if (authAdapter === "clerk") {
+    return { id: "clerk", requiredEnv: [], notes: ["Configure Clerk-specific env in the deployment target."] };
+  }
+  if (authAdapter === "authjs") {
+    return { id: "authjs", requiredEnv: ["AUTH_SECRET"], notes: ["Use Auth.js provider configuration in app code."] };
+  }
+  return { id: "provider-managed", requiredEnv: [], notes: ["Auth is managed outside the kit contract."] };
+}
+export {
+  describeAuthAdapter
+};

package/assets/worker-kits/growthub-agency-portal-starter-v1/apps/agency-portal/lib/adapters/env.js

@@ -0,0 +1,28 @@
+function readAdapterConfig() {
+  return {
+    deployTarget: "vercel",
+    dataAdapter: readEnum("AGENCY_PORTAL_DATA_ADAPTER", ["postgres", "qstash-kv", "provider-managed"], "provider-managed"),
+    authAdapter: readEnum("AGENCY_PORTAL_AUTH_ADAPTER", ["oidc", "clerk", "authjs", "provider-managed"], "provider-managed"),
+    paymentAdapter: readEnum("AGENCY_PORTAL_PAYMENT_ADAPTER", ["none", "stripe", "polar"], "none"),
+    integrationAdapter: readEnum("AGENCY_PORTAL_INTEGRATION_ADAPTER", ["growthub-bridge", "byo-api-key", "static"], "static"),
+    reportingAdapter: process.env.AGENCY_PORTAL_REPORTING_ADAPTER || void 0,
+    growthubBridge: {
+      baseUrl: process.env.GROWTHUB_BRIDGE_BASE_URL || void 0,
+      integrationsPath: process.env.GROWTHUB_BRIDGE_INTEGRATIONS_PATH || "/api/mcp/accounts",
+      userId: process.env.GROWTHUB_BRIDGE_USER_ID || void 0,
+      hasAccessToken: Boolean(process.env.GROWTHUB_BRIDGE_ACCESS_TOKEN)
+    },
+    dataSources: {
+      hasWindsorApiKey: Boolean(process.env.WINDSOR_API_KEY)
+    }
+  };
+}
+function readEnum(key, allowed, fallback) {
+  const value = process.env[key];
+  if (!value) return fallback;
+  if (allowed.includes(value)) return value;
+  throw new Error(`${key} must be one of: ${allowed.join(", ")}`);
+}
+export {
+  readAdapterConfig
+};

package/assets/worker-kits/growthub-agency-portal-starter-v1/apps/agency-portal/lib/adapters/integrations/growthub-connection-normalizer.js

@@ -0,0 +1,95 @@
+const providerAliases = {
+  ga4: "google-analytics",
+  google_analytics: "google-analytics",
+  google_drive: "google-drive",
+  ghl: "go-high-level",
+  gohighlevel: "go-high-level",
+  meta: "meta-ads",
+  meta_ads: "meta-ads"
+};
+function normalizeProviderId(provider) {
+  const normalized = provider.trim().toLowerCase().replaceAll("_", "-");
+  return providerAliases[normalized] || normalized;
+}
+function isHostedRecord(row) {
+  return "provider" in row && ("ready" in row || "connectedAt" in row || "scopes" in row || "handle" in row);
+}
+function normalizeHostedIntegration(row) {
+  const provider = normalizeProviderId(row.provider);
+  const ready = row.ready !== false;
+  return {
+    id: provider,
+    provider,
+    label: row.label,
+    name: row.label,
+    status: ready ? "connected" : "needs-connection",
+    isConnected: ready,
+    isActive: ready,
+    authPath: "growthub-mcp-bridge",
+    setupMode: "hosted-authority",
+    connectionMetadata: {
+      source: "growthub-cli-profile",
+      connectedAt: row.connectedAt,
+      scopes: row.scopes,
+      handle: row.handle
+    }
+  };
+}
+function normalizeMcpAccount(account) {
+  const provider = normalizeProviderId(account.provider);
+  const isActive = account.isActive === true;
+  const isVerified = account.isVerified === true;
+  const isConnected = isActive;
+  return {
+    id: provider,
+    provider,
+    label: account.connectionName || void 0,
+    name: account.connectionName || void 0,
+    authType: normalizeConnectionType(account.connectionType),
+    status: isConnected ? "connected" : "needs-connection",
+    isConnected,
+    isActive,
+    connectionId: account.id,
+    authPath: "growthub-mcp-bridge",
+    setupMode: "hosted-authority",
+    connectionMetadata: {
+      source: "growthub-mcp-accounts",
+      accountId: account.id,
+      connectionName: account.connectionName,
+      connectionType: account.connectionType,
+      isVerified,
+      appSlug: account.appSlug,
+      createdAt: account.createdAt,
+      updatedAt: account.updatedAt,
+      metadata: account.metadata || void 0
+    }
+  };
+}
+function normalizeConnectionType(connectionType) {
+  if (connectionType === "api_token" || connectionType === "api_key") return "api_token";
+  if (connectionType === "webhook") return "webhook";
+  return "oauth_first_party";
+}
+function normalizeBridgeRow(row) {
+  if (isHostedRecord(row)) return normalizeHostedIntegration(row);
+  const provider = normalizeProviderId(row.provider || row.id || "");
+  return {
+    ...row,
+    id: row.id || provider,
+    provider
+  };
+}
+function normalizeGrowthubBridgePayload(payload) {
+  if (Array.isArray(payload)) {
+    return payload.map(normalizeBridgeRow);
+  }
+  return [
+    ...(payload.integrations || []).map(normalizeBridgeRow),
+    ...(payload.accounts || []).map(normalizeMcpAccount),
+    ...(payload.dataSources || []).map(normalizeBridgeRow),
+    ...(payload.workspaceIntegrations || []).map(normalizeBridgeRow)
+  ];
+}
+export {
+  normalizeGrowthubBridgePayload
+};

package/assets/worker-kits/growthub-agency-portal-starter-v1/apps/agency-portal/lib/adapters/integrations/index.js

@@ -0,0 +1,178 @@
+import { readAdapterConfig } from "@/lib/adapters/env";
+import {
+  agencyPortalIntegrationCatalog
+} from "@/lib/domain/integrations";
+import {
+  normalizeGrowthubBridgePayload
+} from "./growthub-connection-normalizer";
+function describeIntegrationAdapter() {
+  const config = readAdapterConfig();
+  if (config.integrationAdapter === "growthub-bridge") {
+    return {
+      id: "growthub-bridge",
+      label: "Growthub MCP bridge",
+      requiredEnv: ["GROWTHUB_BRIDGE_BASE_URL", "GROWTHUB_BRIDGE_ACCESS_TOKEN"],
+      authority: "growthub-gh-app"
+    };
+  }
+  if (config.integrationAdapter === "byo-api-key") {
+    return {
+      id: "byo-api-key",
+      label: "Bring your own API key",
+      requiredEnv: ["AGENCY_PORTAL_BYO_CONNECTIONS_JSON"],
+      authority: "workspace-env"
+    };
+  }
+  return {
+    id: "static",
+    label: "Static starter catalog",
+    requiredEnv: [],
+    authority: "local-catalog"
+  };
+}
+async function listAgencyPortalIntegrations() {
+  const config = readAdapterConfig();
+  if (config.integrationAdapter !== "growthub-bridge") {
+    if (config.integrationAdapter === "byo-api-key") {
+      return mergeBringYourOwnRows(readBringYourOwnRows());
+    }
+    return agencyPortalIntegrationCatalog;
+  }
+  if (!config.growthubBridge.baseUrl || !process.env.GROWTHUB_BRIDGE_ACCESS_TOKEN) {
+    return agencyPortalIntegrationCatalog;
+  }
+  const url = new URL(config.growthubBridge.integrationsPath, config.growthubBridge.baseUrl);
+  const headers = {
+    accept: "application/json",
+    authorization: `Bearer ${process.env.GROWTHUB_BRIDGE_ACCESS_TOKEN}`
+  };
+  if (config.growthubBridge.userId) {
+    headers["x-user-id"] = config.growthubBridge.userId;
+  }
+  const response = await fetch(url, {
+    headers,
+    next: { revalidate: 30 }
+  });
+  if (!response.ok) {
+    return agencyPortalIntegrationCatalog;
+  }
+  const payload = await response.json();
+  return mergeBridgeRows(normalizeGrowthubBridgePayload(payload));
+}
+function readBringYourOwnRows() {
+  const raw = process.env.AGENCY_PORTAL_BYO_CONNECTIONS_JSON;
+  const rows = [];
+  if (process.env.WINDSOR_API_KEY) {
+    rows.push({
+      id: "windsor-ai",
+      provider: "windsor-ai",
+      name: "Windsor AI",
+      label: "Windsor AI",
+      category: "api_key",
+      authType: "api_token",
+      status: "connected",
+      isConnected: true,
+      isActive: true,
+      authPath: "byo-api-key",
+      setupMode: "bring-your-own-key",
+      secretEnvName: "WINDSOR_API_KEY",
+      connectionMetadata: {
+        source: "workspace-env",
+        secretEnvName: "WINDSOR_API_KEY"
+      }
+    });
+  }
+  if (!raw) return rows;
+  try {
+    const parsed = JSON.parse(raw);
+    return [...rows, ...normalizeGrowthubBridgePayload(parsed)];
+  } catch {
+    return rows;
+  }
+}
+function mergeBringYourOwnRows(rows) {
+  const merged = mergeBridgeRows(rows);
+  return merged.map((item) => {
+    const row = rows.find((candidate) => {
+      const provider = candidate.provider || candidate.id;
+      return provider === item.provider || candidate.id === item.id;
+    });
+    if (!row) return item;
+    return {
+      ...item,
+      authPath: "byo-api-key",
+      setupMode: "bring-your-own-key",
+      secretEnvName: typeof row.secretEnvName === "string" ? row.secretEnvName : void 0,
+      status: row.status || "connected"
+    };
+  });
+}
+function mergeBridgeRows(rows) {
+  const seenProviders = /* @__PURE__ */ new Set();
+  const merged = agencyPortalIntegrationCatalog.map((catalogItem) => {
+    const row = rows.find((item) => {
+      const provider = item.provider || item.id;
+      return provider === catalogItem.provider || item.id === catalogItem.id;
+    });
+    if (!row) return catalogItem;
+    seenProviders.add(row.provider || row.id || catalogItem.provider);
+    return {
+      ...catalogItem,
+      label: row.label || row.name || catalogItem.label,
+      name: row.name || row.label || catalogItem.name,
+      icon: row.icon || catalogItem.icon,
+      description: row.description || catalogItem.description,
+      category: row.category || catalogItem.category,
+      authType: row.authType || catalogItem.authType,
+      isConnected: row.isConnected ?? (row.status === "connected" ? true : catalogItem.isConnected),
+      isActive: row.isActive ?? (row.status === "connected" ? true : catalogItem.isActive),
+      authPath: row.authPath || catalogItem.authPath,
+      setupMode: row.setupMode || catalogItem.setupMode,
+      status: row.status || (row.isConnected || row.isActive ? "connected" : catalogItem.status),
+      connectionId: row.connectionId,
+      accountId: row.accountId,
+      secretEnvName: row.secretEnvName,
+      connectionMetadata: row.connectionMetadata || row.metadata,
+      metadata: row.metadata || row.connectionMetadata
+    };
+  });
+  const discoveredRows = rows.filter((row) => {
+    const provider = row.provider || row.id;
+    if (!provider) return false;
+    if (seenProviders.has(provider)) return false;
+    return !agencyPortalIntegrationCatalog.some((item) => item.provider === provider || item.id === row.id);
+  });
+  return [...merged, ...discoveredRows.map(toDiscoveredIntegration)];
+}
+function toDiscoveredIntegration(row) {
+  const provider = row.provider || row.id || "unknown-provider";
+  const label = row.label || row.name || provider;
+  const isDataPipeline = ["windsor-ai", "google-sheets", "google-analytics", "shopify", "meta-ads"].includes(provider);
+  const isConnected = row.isConnected ?? row.status === "connected";
+  return {
+    id: row.id || provider,
+    label,
+    name: row.name || label,
+    icon: row.icon || label.slice(0, 1).toUpperCase(),
+    provider,
+    description: row.description || "Connected through the Growthub account bridge.",
+    category: row.category || "mcp_connector",
+    authType: row.authType || "oauth_first_party",
+    isConnected,
+    isActive: row.isActive ?? isConnected,
+    lane: isDataPipeline ? "data-source" : "workspace-integration",
+    objectType: isDataPipeline ? "data-pipeline" : "mcp-connection",
+    status: row.status || (isConnected ? "connected" : "needs-connection"),
+    authPath: row.authPath || "growthub-mcp-bridge",
+    setupMode: row.setupMode || "hosted-authority",
+    connectionId: row.connectionId,
+    accountId: row.accountId,
+    secretEnvName: row.secretEnvName,
+    connectionMetadata: row.connectionMetadata || row.metadata,
+    metadata: row.metadata || row.connectionMetadata
+  };
+}
+export {
+  describeIntegrationAdapter,
+  listAgencyPortalIntegrations
+};

package/assets/worker-kits/growthub-agency-portal-starter-v1/apps/agency-portal/lib/adapters/payments/index.js

@@ -0,0 +1,13 @@
+import { readAdapterConfig } from "../env";
+function describePaymentAdapter() {
+  const { paymentAdapter } = readAdapterConfig();
+  if (paymentAdapter === "none") return { id: "none", requiredEnv: [], enabled: false };
+  return {
+    id: paymentAdapter,
+    requiredEnv: ["PAYMENT_SECRET_KEY", "PAYMENT_WEBHOOK_SECRET"],
+    enabled: true
+  };
+}
+export {
+  describePaymentAdapter
+};

package/assets/worker-kits/growthub-agency-portal-starter-v1/apps/agency-portal/lib/adapters/persistence/index.js

@@ -0,0 +1,13 @@
+import { readAdapterConfig } from "../env";
+import { describePostgresAdapter } from "./postgres";
+import { describeProviderManagedAdapter } from "./provider-managed";
+import { describeQstashKvAdapter } from "./qstash-kv";
+function describePersistenceAdapter() {
+  const config = readAdapterConfig();
+  if (config.dataAdapter === "postgres") return describePostgresAdapter();
+  if (config.dataAdapter === "qstash-kv") return describeQstashKvAdapter();
+  return describeProviderManagedAdapter();
+}
+export {
+  describePersistenceAdapter
+};

package/assets/worker-kits/growthub-agency-portal-starter-v1/apps/agency-portal/lib/adapters/persistence/postgres.js

@@ -0,0 +1,16 @@
+function describePostgresAdapter() {
+  return {
+    id: "postgres",
+    label: "Postgres",
+    requiredEnv: ["DATABASE_URL"],
+    mode: "sql",
+    notes: [
+      "Use any Postgres-compatible provider.",
+      "Keep provider-specific pooling, SSL, and migration tooling outside the kit contract.",
+      "Application repositories should depend on this descriptor, not a provider SDK directly."
+    ]
+  };
+}
+export {
+  describePostgresAdapter
+};