@daeda/mcp-pro 0.1.6 → 0.1.8

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).
+- 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, upperBoundEndpointBehavior, lowerBoundTimePoint, upperBoundTimePoint. Endpoint behaviors: lowerBoundEndpointBehavior is always "INCLUSIVE". upperBoundEndpointBehavior MUST be "EXCLUSIVE" when using referenceType "TODAY", and "INCLUSIVE" only when using referenceType "NOW". Offset format uses individual fields: { days: -90 } (NOT { unit: "DAY", amount: -90 }). For "last N days" ranges, use referenceType "TODAY" for the lower bound and "NOW" for the upper bound. Full TIME_RANGED "last 90 days" 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: "NOW" } } }.
 - 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,51 @@ var collectPropertyFilters = (branches, parentObjectTypeId) => {
   }
   return refs;
 };
+var getUpperBoundRefType = (op) => {
+  const upper = op.upperBoundTimePoint;
+  if (!upper) return void 0;
+  const ref = upper.indexReference;
+  return ref?.referenceType;
+};
+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(", ")}. Set lowerBoundEndpointBehavior to "INCLUSIVE" and upperBoundEndpointBehavior to "EXCLUSIVE" (or "INCLUSIVE" only with referenceType "NOW").`
+            });
+          } else if (op.upperBoundEndpointBehavior === "INCLUSIVE") {
+            const upperRef = getUpperBoundRefType(op);
+            if (upperRef && upperRef !== "NOW") {
+              issues.push({
+                severity: "error",
+                operation_index: index,
+                code: "INVALID_TIME_RANGE_ENDPOINT",
+                message: `TIME_RANGED filter on '${f.property ?? "unknown"}' has upperBoundEndpointBehavior "INCLUSIVE" but upper bound uses referenceType "${upperRef}". HubSpot only accepts "INCLUSIVE" with referenceType "NOW" \u2014 use "EXCLUSIVE" instead, or change the upper bound to referenceType "NOW".`
+              });
+            }
+          }
+        }
+      }
+    }
+    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 +7247,7 @@ var createListHandler = {
         }
         if (branches?.length) {
           issues.push(...collectAssociationIssues(branches, index));
+          issues.push(...collectTimeRangeIssues(branches, index));
         }
       }
     }
@@ -7245,28 +7293,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.6",
+  "version": "0.1.8",
   "description": "MCP server for HubSpot CRM — sync, query, and manage your portal data",
   "type": "module",
   "bin": {