@daeda/mcp-pro 0.1.5 → 0.1.7

package/dist/index.js

@@ -4224,11 +4224,13 @@ operationType MUST match the HubSpot property type:
 - MULTISTRING \u2192 for string properties (firstname, lastname, email, city, company, etc.). Operators: IS_EQUAL_TO, IS_NOT_EQUAL_TO, CONTAINS, DOES_NOT_CONTAIN, STARTS_WITH, ENDS_WITH.
 - NUMBER \u2192 for number properties. Operators: IS_EQUAL_TO, IS_NOT_EQUAL_TO, IS_BETWEEN, IS_GREATER_THAN, IS_LESS_THAN.
 - BOOL \u2192 for boolean properties. Operators: IS_EQUAL_TO, IS_NOT_EQUAL_TO.
-- TIME_POINT \u2192 for date/datetime properties (single point comparison).
-- TIME_RANGED \u2192 for date/datetime properties (range with lowerBoundTimePoint / upperBoundTimePoint).
-- ALL_PROPERTY \u2192 any property type, for IS_KNOWN / IS_NOT_KNOWN checks.
+- TIME_POINT \u2192 for date/datetime properties (single point comparison). Operators: IS_AFTER, IS_BEFORE.
+- TIME_RANGED \u2192 for date/datetime properties (range). Operators: IS_BETWEEN. REQUIRED fields in the operation: lowerBoundEndpointBehavior ("INCLUSIVE"), upperBoundEndpointBehavior ("INCLUSIVE"), lowerBoundTimePoint, upperBoundTimePoint. Offset format uses individual fields: { days: -90 } (NOT { unit: "DAY", amount: -90 }). Full TIME_RANGED example: { operationType: "TIME_RANGED", operator: "IS_BETWEEN", lowerBoundEndpointBehavior: "INCLUSIVE", upperBoundEndpointBehavior: "INCLUSIVE", lowerBoundTimePoint: { timeType: "INDEXED", timezoneSource: "CUSTOM", zoneId: "US/Eastern", indexReference: { referenceType: "TODAY" }, offset: { days: -90 } }, upperBoundTimePoint: { timeType: "INDEXED", timezoneSource: "CUSTOM", zoneId: "US/Eastern", indexReference: { referenceType: "TODAY" }, offset: { days: 0 } } }.
+- ALL_PROPERTY \u2192 any property type. Operators: IS_KNOWN, IS_UNKNOWN, IS_BLANK, IS_NOT_BLANK. WARNING: IS_NOT_KNOWN is NOT valid \u2014 use IS_UNKNOWN instead.
 Enum filter example: { filterType: "PROPERTY", property: "lifecyclestage", operation: { operationType: "ENUMERATION", operator: "IS_ANY_OF", values: ["lead"] } }
 
+IMPORTANT: Some HubSpot properties are hidden and CANNOT be used in list filters. Hidden properties will cause an API error. Common hidden properties include hs_last_sales_activity_date \u2014 use hs_last_sales_activity_timestamp instead. If unsure whether a property is hidden, prefer well-known visible properties.
+
 ASSOCIATION branches filter by associated records and MUST include these required fields:
 - filterBranchType: "ASSOCIATION"
 - objectTypeId: the associated object type ID (e.g. "0-3" for deals)
@@ -7116,6 +7118,35 @@ var collectPropertyFilters = (branches, parentObjectTypeId) => {
   }
   return refs;
 };
+var collectTimeRangeIssues = (branches, index) => {
+  const issues = [];
+  for (const branch of branches) {
+    const filters = branch.filters;
+    if (filters) {
+      for (const f of filters) {
+        const op = f.operation;
+        if (op?.operationType === "TIME_RANGED") {
+          const missing = [];
+          if (op.lowerBoundEndpointBehavior == null) missing.push("lowerBoundEndpointBehavior");
+          if (op.upperBoundEndpointBehavior == null) missing.push("upperBoundEndpointBehavior");
+          if (missing.length > 0) {
+            issues.push({
+              severity: "error",
+              operation_index: index,
+              code: "INVALID_TIME_RANGE_ENDPOINT",
+              message: `TIME_RANGED filter on '${f.property ?? "unknown"}' is missing required field(s): ${missing.join(", ")}. Both must be set to "INCLUSIVE".`
+            });
+          }
+        }
+      }
+    }
+    const nested = branch.filterBranches;
+    if (nested?.length) {
+      issues.push(...collectTimeRangeIssues(nested, index));
+    }
+  }
+  return issues;
+};
 var collectAssociationIssues = (branches, index) => {
   const issues = [];
   for (const branch of branches) {
@@ -7200,6 +7231,7 @@ var createListHandler = {
         }
         if (branches?.length) {
           issues.push(...collectAssociationIssues(branches, index));
+          issues.push(...collectTimeRangeIssues(branches, index));
         }
       }
     }
@@ -7245,28 +7277,37 @@ var createListHandler = {
           )
         ),
         Effect53.map((results) => {
-          const propTypeByObject = /* @__PURE__ */ new Map();
+          const propInfoByObject = /* @__PURE__ */ new Map();
           for (const [ot, defs] of results) {
             const m = /* @__PURE__ */ new Map();
-            for (const d of defs) m.set(d.name, d.type);
-            propTypeByObject.set(ot, m);
+            for (const d of defs) m.set(d.name, { type: d.type, hidden: d.hidden });
+            propInfoByObject.set(ot, m);
           }
           const issues = [];
           for (const ref of filterRefs) {
-            const propMap = propTypeByObject.get(ref.objectTypeId);
+            const propMap = propInfoByObject.get(ref.objectTypeId);
             if (!propMap) continue;
-            const propType = propMap.get(ref.property);
-            if (!propType) continue;
-            const expected = OPERATION_TYPE_FOR_PROPERTY_TYPE[propType];
+            const propInfo = propMap.get(ref.property);
+            if (!propInfo) continue;
+            if (propInfo.hidden) {
+              issues.push({
+                severity: "error",
+                operation_index: index,
+                code: "HIDDEN_PROPERTY_IN_FILTER",
+                message: `Property '${ref.property}' is hidden and cannot be used in list filters. Use an alternative visible property instead.`
+              });
+              continue;
+            }
+            const expected = OPERATION_TYPE_FOR_PROPERTY_TYPE[propInfo.type];
             if (!expected) continue;
             if (ref.operationType === expected) continue;
             if (ref.operationType === "ALL_PROPERTY") continue;
-            if (ref.operationType === "TIME_RANGED" && (propType === "date" || propType === "datetime")) continue;
+            if (ref.operationType === "TIME_RANGED" && (propInfo.type === "date" || propInfo.type === "datetime")) continue;
             issues.push({
               severity: "error",
               operation_index: index,
               code: "INVALID_OPERATION_TYPE",
-              message: `Property '${ref.property}' has type '${propType}' but filter uses operationType '${ref.operationType}'. Use '${expected}' instead.${propType === "enumeration" ? " For enumeration properties use operators like IS_ANY_OF, IS_NONE_OF (not IS_EQUAL_TO)." : ""}`
+              message: `Property '${ref.property}' has type '${propInfo.type}' but filter uses operationType '${ref.operationType}'. Use '${expected}' instead.${propInfo.type === "enumeration" ? " For enumeration properties use operators like IS_ANY_OF, IS_NONE_OF (not IS_EQUAL_TO)." : ""}`
             });
           }
           return issues;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daeda/mcp-pro",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "MCP server for HubSpot CRM — sync, query, and manage your portal data",
   "type": "module",
   "bin": {