@growthub/cli 0.9.13 → 0.9.14

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/workspace-data-model.js

@@ -171,9 +171,12 @@ function deriveManualObjectTable(object) {
     id: `manual-object:${object.id || source}`,
     label: object.label || object.name || source,
     source,
+    objectType: object.objectType || "custom",
+    icon: object.icon || null,
     columns,
     rows,
     binding: object.binding || { mode: "manual", source: "Data Model" },
+    relations: Array.isArray(object.relations) ? object.relations : [],
     mutable: true,
     storage: "manual-object",
     objectId: object.id,
@@ -313,6 +316,105 @@ function uniqueObjectId(workspaceConfig, name) {
   return `${base}-${index}`;
 }
 
+/**
+ * Top-level object type presets.
+ * Each entry defines: label, icon (Lucide name), description, default columns, and
+ * any built-in relations.  These are the five first-class types the UI offers when
+ * a user clicks "New object" — they act like schema templates, not hard constraints.
+ *
+ * Relation shape:
+ *   {
+ *     id:              string,   // stable slug within this object
+ *     name:            string,   // display label
+ *     field:           string,   // FK column on THIS object
+ *     targetObjectType:string,   // objectType of the referenced object
+ *     type:            "belongs-to" | "has-many",
+ *     description:     string
+ *   }
+ */
+const OBJECT_TYPE_PRESETS = {
+  "data-source": {
+    label: "Data Source",
+    icon: "Globe",
+    description: "Custom API, webhook, or external feed. References an API Registry record while credentials stay in workspace settings.",
+    columns: ["Name", "registryId", "endpoint", "authRef", "baseUrl", "status", "lastTested", "lastResponse"],
+    relations: [
+      {
+        id: "resolver-binding",
+        name: "Resolver",
+        field: "registryId",
+        targetObjectType: "api-registry",
+        type: "belongs-to",
+        description: "The API Registry entry whose fetchRecords function resolves this source. Set registryId to match the resolver integrationId."
+      }
+    ]
+  },
+  "api-registry": {
+    label: "API Registry",
+    icon: "Code2",
+    description: "HTTP API records with endpoint config, auth references, connection status, and stored test output.",
+    columns: ["integrationId", "authRef", "baseUrl", "endpoint", "method", "status", "lastTested", "lastResponse", "entityTypes", "description"],
+    relations: []
+  },
+  "people": {
+    label: "People",
+    icon: "Users",
+    description: "Contacts, leads, or team members with standard CRM fields.",
+    columns: ["Name", "Email", "Phone", "Company", "Status", "Role"],
+    relations: []
+  },
+  "tasks": {
+    label: "Tasks",
+    icon: "CheckSquare",
+    description: "Action items, to-dos, or work items.",
+    columns: ["Name", "Status", "DueDate", "Assignee", "Priority"],
+    relations: []
+  },
+  "custom": {
+    label: "Custom",
+    icon: "Plus",
+    description: "Start with a blank table — define your own fields and records.",
+    columns: ["Name"],
+    relations: []
+  }
+};
+
+/**
+ * Create a typed business object from a preset template.
+ * Accepts objectType (one of the OBJECT_TYPE_PRESETS keys) and an optional icon override.
+ * The object is stored in dataModel.objects[] alongside manual objects.
+ */
+function createTypedBusinessObject(workspaceConfig, { name, objectType = "custom", icon } = {}) {
+  const label = String(name || "").trim();
+  if (!label) return workspaceConfig;
+  const preset = OBJECT_TYPE_PRESETS[objectType] || OBJECT_TYPE_PRESETS.custom;
+  const columns = [...preset.columns];
+  const dataModel =
+    workspaceConfig.dataModel && typeof workspaceConfig.dataModel === "object" && !Array.isArray(workspaceConfig.dataModel)
+      ? workspaceConfig.dataModel
+      : {};
+  const id = uniqueObjectId(workspaceConfig, label);
+  const object = {
+    id,
+    label,
+    source: label,
+    objectType,
+    icon: icon || preset.icon,
+    columns,
+    rows: [],
+    binding: { mode: "manual", source: "Data Model" },
+    relations: preset.relations ? preset.relations.map((r) => ({ ...r })) : [],
+    fieldSettings: { hidden: [], order: columns }
+  };
+  return {
+    ...workspaceConfig,
+    dataModel: {
+      ...dataModel,
+      objects: [...normalizeManualObjects(workspaceConfig), object]
+    }
+  };
+}
+
 function createManualBusinessObject(workspaceConfig, { name, fields } = {}) {
   const label = String(name || "").trim();
   const columns = Array.from(new Set((Array.isArray(fields) ? fields : String(fields || "").split(","))
@@ -417,10 +519,12 @@ function describeBindingMode(binding) {
 }
 
 export {
+  OBJECT_TYPE_PRESETS,
   addTableField,
   addTableRow,
   appendRowsToTable,
   createManualBusinessObject,
+  createTypedBusinessObject,
   deleteTableRow,
   describeBindingLane,
   describeBindingMode,

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/workspace-schema.js

@@ -152,7 +152,9 @@ const WIDGET_SCHEMA_CONTRACTS = {
     lane: "string optional (when mode === 'integration')",
     entityId: "string optional — stable source object ID (never a token or credential)",
     entityType: "string optional — adapter-provided object type",
-    entityLabel: "string optional — display-only resolved label, not authoritative"
+    entityLabel: "string optional — display-only resolved label, not authoritative",
+    sourceStorage: "'workspace-source-records' optional — marks this binding as live-backed; records are written by POST /api/workspace/refresh-sources and keyed by dataModel.objects[].sourceId",
+    sourceId: "string optional — stable key in growthub.source-records.json; required when sourceStorage === 'workspace-source-records'"
   },
   NormalizedIntegrationEntity: {
     id: "non-empty string — stable source object ID",
@@ -200,19 +202,19 @@ const SAMPLE_DATA_BINDINGS = {
 function defaultConfigFor(kind) {
   switch (kind) {
     case "chart":
-      return { values: [58, 36, 72, 48, 64], binding: SAMPLE_DATA_BINDINGS.reportingJson };
+      return { values: [], binding: { mode: "manual", source: "", rows: [] } };
     case "view":
       return {
         source: "",
         layout: "Table",
         columns: [],
         rows: [],
-        binding: { mode: "manual", source: "Static rows", rows: [] }
+        binding: { mode: "manual", source: "", rows: [] }
       };
     case "iframe":
       return { url: "" };
     case "rich-text":
-      return { text: "", binding: { mode: "manual", source: "Manual text", rows: [] } };
+      return { text: "", binding: { mode: "manual", source: "", rows: [] } };
     default:
       return {};
   }
@@ -396,8 +398,11 @@ function validateStaticDataBinding(binding, path, errors) {
     if (typeof binding.integrationId !== "string" || !binding.integrationId.trim()) {
       errors.push(`${path}.integrationId is required when mode is integration`);
     }
-    if (typeof binding.lane !== "string" || !binding.lane.trim()) {
-      errors.push(`${path}.lane is required when mode is integration`);
+    // lane is not required when sourceStorage delegates routing to a registry resolver
+    if (binding.sourceStorage !== "workspace-source-records") {
+      if (typeof binding.lane !== "string" || !binding.lane.trim()) {
+        errors.push(`${path}.lane is required when mode is integration`);
+      }
     }
   }
   if (binding.source !== undefined && typeof binding.source !== "string") {
@@ -439,6 +444,14 @@ function validateStaticDataBinding(binding, path, errors) {
   if (binding.entityLabel !== undefined && typeof binding.entityLabel !== "string") {
     errors.push(`${path}.entityLabel must be a string`);
   }
+  if (binding.sourceStorage !== undefined) {
+    if (binding.sourceStorage !== "workspace-source-records") {
+      errors.push(`${path}.sourceStorage must be "workspace-source-records" when present`);
+    }
+  }
+  if (binding.sourceId !== undefined && typeof binding.sourceId !== "string") {
+    errors.push(`${path}.sourceId must be a string`);
+  }
 }
 
 function validateFieldSettings(fieldSettings, path, errors) {
@@ -805,6 +818,7 @@ function validateDataModelConfig(dataModel, errors) {
     }
     if (typeof object.label !== "string" || !object.label.trim()) errors.push(`${prefix}.label must be a non-empty string`);
     if (object.source !== undefined && typeof object.source !== "string") errors.push(`${prefix}.source must be a string`);
+    if (object.sourceId !== undefined && typeof object.sourceId !== "string") errors.push(`${prefix}.sourceId must be a string`);
     validateStringArray(object.columns, `${prefix}.columns`, errors);
     if (!Array.isArray(object.rows)) {
       errors.push(`${prefix}.rows must be an array`);
@@ -814,6 +828,9 @@ function validateDataModelConfig(dataModel, errors) {
       });
     }
     validateStaticDataBinding(object.binding, `${prefix}.binding`, errors);
+    if (object.binding?.sourceStorage === "workspace-source-records" && typeof object.sourceId !== "string") {
+      errors.push(`${prefix}.sourceId is required when binding.sourceStorage is "workspace-source-records"`);
+    }
     validateFieldSettings(object.fieldSettings, `${prefix}.fieldSettings`, errors);
   });
 }

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/package.json

@@ -10,6 +10,7 @@
     "lint": "next lint"
   },
   "dependencies": {
+    "@tanstack/react-table": "^8.21.3",
     "lucide-react": "^0.468.0",
     "next": "16.2.4",
     "react": "19.2.4",

package/assets/worker-kits/growthub-custom-workspace-starter-v1/kit.json

@@ -76,6 +76,10 @@
     "apps/workspace/app/workspace-builder.jsx",
     "apps/workspace/app/settings/integrations/page.jsx",
     "apps/workspace/app/api/workspace/route.js",
+    "apps/workspace/app/api/workspace/refresh-sources/route.js",
+    "apps/workspace/app/api/workspace/test-source/route.js",
+    "apps/workspace/app/api/workspace/register-resolver/route.js",
+    "apps/workspace/app/api/workspace/resolvers/route.js",
     "apps/workspace/app/api/settings/integrations/route.js",
     "apps/workspace/lib/workspace-schema.js",
     "apps/workspace/lib/workspace-config.js",
@@ -85,6 +89,9 @@
     "apps/workspace/lib/adapters/auth/index.js",
     "apps/workspace/lib/adapters/integrations/index.js",
     "apps/workspace/lib/adapters/integrations/growthub-connection-normalizer.js",
+    "apps/workspace/lib/adapters/integrations/source-resolver-registry.js",
+    "apps/workspace/lib/adapters/integrations/resolver-loader.js",
+    "apps/workspace/lib/adapters/integrations/resolvers/README.md",
     "apps/workspace/lib/adapters/payments/index.js",
     "apps/workspace/lib/adapters/persistence/index.js",
     "apps/workspace/lib/adapters/persistence/postgres.js",