@growth-operations/ui-shared 1.6.17 → 1.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growth-operations/ui-shared",
-  "version": "1.6.17",
+  "version": "1.8.0",
   "description": "Shared HubSpot UI-extension modules (Home, Billing) for Growth Operations apps.",
   "license": "MIT",
   "private": false,

package/src/forms/OptionSelect.jsx

@@ -27,7 +27,12 @@ const SOURCES = {
     return results.map((f) => ({ label: f.name, value: f.id }));
   },
   lists: async (context, token, opts) => {
-    const { lists = [] } = await getLists(context, token, opts?.query ?? "");
+    const { lists = [] } = await getLists(
+      context,
+      token,
+      opts?.query ?? "",
+      opts?.objectTypeId ?? null
+    );
     return lists.map((l) => ({ label: l.name, value: String(l.listId) }));
   },
   pipelines: async (context, token, opts) => {
@@ -61,7 +66,7 @@ export function OptionSelect({
   // url is null/absent the link is skipped, so callers can pass an "Edit" action
   // gated on a selected value.
   actions = [],
-  // Extra source args (pipelineId/objectType for pipelineStages, query for lists)
+  // Extra source args (pipelineId/objectType for pipelineStages, query/objectTypeId for lists)
   ...opts
 }) {
   const [options, setOptions] = useState([]);
@@ -75,6 +80,7 @@ export function OptionSelect({
     pipelineId: opts.pipelineId,
     objectType: opts.objectType,
     query: opts.query,
+    objectTypeId: opts.objectTypeId,
   });
 
   useStrictModeEffect(

package/src/index.js

@@ -78,6 +78,7 @@ export {
   HubSpotApiError,
   getObjectProperties,
   getProperties,
+  getPropertyOptions,
   updateProperties,
   getForms,
   getLists,

package/src/sdk/hubspot/lists.js

@@ -1,11 +1,14 @@
-// HubSpot contact-list fetcher (for list-selection pickers).
+// HubSpot list fetcher (for list-selection pickers).
 //
 // Paginates crm/v3/lists/search until all DYNAMIC lists are collected. The POST
 // body is a plain OBJECT — callHubSpotApi sends it as-is (NEVER JSON.stringify).
 import { buildHubSpotUrl, callHubSpotApi } from "./base";
 
 // context is accepted for signature consistency. query: optional name filter.
-export async function getLists(context, token, query = "") {
+// objectTypeId: optional HubSpot object type id (e.g. "0-1" for contacts, or a
+// custom object's numeric type id) to scope results to lists built on that
+// object — omit to search across all objects, as before.
+export async function getLists(context, token, query = "", objectTypeId = null) {
   const url = buildHubSpotUrl("crm/v3/lists/search");
   const allLists = [];
   let offset = 0;
@@ -18,6 +21,7 @@ export async function getLists(context, token, query = "") {
       count: count,
       offset: offset,
       processingTypes: ["DYNAMIC"],
+      ...(objectTypeId ? { objectTypeId } : {}),
     };
 
     const response = await callHubSpotApi(url, token, "POST", payload);

package/src/sdk/hubspot/properties.js

@@ -4,6 +4,7 @@
 // rules apply (object body, Authorization-only header). The PATCH body is passed
 // as a plain object (NOT JSON.stringify'd).
 import { buildHubSpotUrl, callHubSpotApi } from "./base";
+import { buildPropertyName } from "../../lib/urls";
 
 // List the writable properties for a HubSpot object type, shaped for a mapping
 // picker: [{ name, label, type }] sorted by label. Excludes hidden, archived,
@@ -48,3 +49,22 @@ export async function updateProperties(context, token, properties) {
   // properties is wrapped in a plain object — callHubSpotApi sends it as-is.
   return callHubSpotApi(url, token, "PATCH", { properties });
 }
+
+// The enumeration options for a single property, shaped for a
+// Select/MultiSelect/checkbox-list picker: [{ label, value }]. Returns [] if
+// the property doesn't exist or isn't an enumeration (no `options` array).
+//
+// App-object properties defined in a *-hsmeta.json (e.g. an app-object's
+// `status`) are integrator-defined and land PREFIXED (a{app_id}_status), not
+// bare, once installed — pass appPrefix (from context.extension.appId) and
+// this checks the prefixed name first, falling back to bare for properties
+// that aren't app-namespaced. Omit appPrefix for object types with no app
+// prefix at all (e.g. standard objects like contacts).
+export async function getPropertyOptions(context, token, objectType, propertyName, appPrefix) {
+  const response = await getProperties(context, token, objectType);
+  const prefixedName = appPrefix ? buildPropertyName(appPrefix, propertyName) : null;
+  const prop = (response.results || []).find(
+    (p) => (prefixedName && p.name === prefixedName) || p.name === propertyName
+  );
+  return (prop?.options || []).map((o) => ({ label: o.label, value: o.value }));
+}

package/src/sdk/index.js

@@ -18,6 +18,7 @@ export { callHubSpotApi, buildHubSpotUrl, HubSpotApiError } from "./hubspot/base
 export {
   getObjectProperties,
   getProperties,
+  getPropertyOptions,
   updateProperties,
 } from "./hubspot/properties";
 export { getForms } from "./hubspot/forms";