@albatrossai/albatross-sdk 0.2.1 → 0.2.3

package/dist/index.cjs

@@ -809,6 +809,15 @@ var FilterConditionSchema = zod.z.object({
         lt: zod.z.number().optional()
       })
     }),
+    zod.z.object({
+      type: zod.z.literal("DatetimeRange"),
+      value: zod.z.object({
+        gte: zod.z.string().optional(),
+        lte: zod.z.string().optional(),
+        gt: zod.z.string().optional(),
+        lt: zod.z.string().optional()
+      })
+    }),
     zod.z.object({
       type: zod.z.literal("GeoRadius"),
       value: zod.z.object({
@@ -1611,6 +1620,44 @@ var FilterBuilder = class {
     else this.must_not.push(condition);
     return this;
   }
+  /**
+   * add datetime range filter condition
+   *
+   * filters items where datetime field falls within specified range.
+   * values should be RFC 3339 formatted strings (e.g., "2025-12-15T00:00:00Z").
+   *
+   * @param field - datetime field name to filter on
+   * @param value - range specification with operators (RFC 3339 strings)
+   * @param value.gte - greater than or equal to
+   * @param value.lte - less than or equal to
+   * @param value.gt - greater than
+   * @param value.lt - less than
+   * @param type - filter type: "must", "should", or "must_not". default: "must"
+   *
+   * @returns this filter builder for method chaining
+   *
+   * @example
+   * ```typescript
+   * // events between two dates
+   * builder.datetimeRange("start_date", {
+   *   gte: "2025-12-15T00:00:00Z",
+   *   lte: "2025-12-31T23:59:59Z"
+   * });
+   *
+   * // events after a specific date
+   * builder.datetimeRange("created_at", { gt: "2025-01-01T00:00:00Z" });
+   * ```
+   */
+  datetimeRange(field, value, type = "must") {
+    const condition = {
+      field,
+      condition: { type: "DatetimeRange", value }
+    };
+    if (type === "must") this.must.push(condition);
+    else if (type === "should") this.should.push(condition);
+    else this.must_not.push(condition);
+    return this;
+  }
   /**
    * add geo-radius filter condition
    *