From cc255ad39de4ae5d858dad7b2aa9c66e5f2a3601 Mon Sep 17 00:00:00 2001
From: Matthew Mikolay <mmikolay@knock.app>
Date: Thu, 12 Feb 2026 16:54:13 -0500
Subject: [PATCH 1/4] Improve FetchFeedOptionsForRequest type

---
 packages/client/src/clients/feed/interfaces.ts | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/packages/client/src/clients/feed/interfaces.ts b/packages/client/src/clients/feed/interfaces.ts
index eeb9a3f41..9475ab60f 100644
--- a/packages/client/src/clients/feed/interfaces.ts
+++ b/packages/client/src/clients/feed/interfaces.ts
@@ -65,14 +65,25 @@ export type FetchFeedOptions = {
   __fetchSource?: "socket" | "http";
 } & Omit<FeedClientOptions, "__experimentalCrossBrowserUpdates">;
 
-// The final data shape that is sent to the API
-// Should match types here: https://docs.knock.app/reference#get-feed
+/**
+ * The final data shape that is sent to the the list feed items endpoint of the Knock API.
+ *
+ * @see https://docs.knock.app/api-reference/users/feeds/list_items
+ */
 export type FetchFeedOptionsForRequest = Omit<
   FeedClientOptions,
   "trigger_data"
 > & {
-  // Formatted trigger data into a string
+  /** The trigger data of the feed items (as a JSON string). */
   trigger_data?: string;
+  /** Limits the results to items inserted after or on the given date. */
+  "inserted_at.gte"?: string;
+  /** Limits the results to items inserted before or on the given date. */
+  "inserted_at.lte"?: string;
+  /** Limits the results to items inserted after the given date. */
+  "inserted_at.gt"?: string;
+  /** Limits the results to items inserted before the given date. */
+  "inserted_at.lt"?: string;
   // Unset options that should not be sent to the API
   __loadingType: undefined;
   __fetchSource: undefined;

From f71aef69cbd4a1c27c9823eba3acc2a4940125d7 Mon Sep 17 00:00:00 2001
From: Matthew Mikolay <mmikolay@knock.app>
Date: Thu, 12 Feb 2026 17:02:36 -0500
Subject: [PATCH 2/4] Add changeset

---
 .changeset/shaggy-ideas-matter.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 .changeset/shaggy-ideas-matter.md

diff --git a/.changeset/shaggy-ideas-matter.md b/.changeset/shaggy-ideas-matter.md
new file mode 100644
index 000000000..c8f786108
--- /dev/null
+++ b/.changeset/shaggy-ideas-matter.md
@@ -0,0 +1,5 @@
+---
+"@knocklabs/client": patch
+---
+
+Improve `FetchFeedOptionsForRequest` type

From 82c1e18e2366c64d5542b404c44708547a9fcf1c Mon Sep 17 00:00:00 2001
From: Matthew Mikolay <mmikolay@knock.app>
Date: Thu, 12 Feb 2026 17:15:29 -0500
Subject: [PATCH 3/4] Add DateRangeParams type to mergeDateRangeParams

---
 packages/client/src/clients/feed/utils.ts | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/packages/client/src/clients/feed/utils.ts b/packages/client/src/clients/feed/utils.ts
index 9d764c513..c108a58ed 100644
--- a/packages/client/src/clients/feed/utils.ts
+++ b/packages/client/src/clients/feed/utils.ts
@@ -1,4 +1,8 @@
-import type { FeedClientOptions, FeedItem } from "./interfaces";
+import type {
+  FeedClientOptions,
+  FeedItem,
+  FetchFeedOptionsForRequest,
+} from "./interfaces";
 
 export function deduplicateItems(items: FeedItem[]): FeedItem[] {
   const seen: Record<string, boolean> = {};
@@ -22,6 +26,11 @@ export function sortItems(items: FeedItem[]) {
   });
 }
 
+type DateRangeParams = Pick<
+  FetchFeedOptionsForRequest,
+  "inserted_at.gte" | "inserted_at.lte" | "inserted_at.gt" | "inserted_at.lt"
+>;
+
 export function mergeDateRangeParams(options: FeedClientOptions) {
   const { inserted_at_date_range, ...rest } = options;
 
@@ -29,7 +38,7 @@ export function mergeDateRangeParams(options: FeedClientOptions) {
     return rest;
   }
 
-  const dateRangeParams: Record<string, string> = {};
+  const dateRangeParams: DateRangeParams = {};
 
   // Determine which operators to use based on the inclusive flag
   const isInclusive = inserted_at_date_range.inclusive ?? false;

From 4bd606eb6ce9a539764f6d472868032d0156bda6 Mon Sep 17 00:00:00 2001
From: Matthew Mikolay <mmikolay@knock.app>
Date: Fri, 13 Feb 2026 09:33:48 -0500
Subject: [PATCH 4/4] Add inserted_at_date_range to Omit

---
 packages/client/src/clients/feed/interfaces.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/client/src/clients/feed/interfaces.ts b/packages/client/src/clients/feed/interfaces.ts
index 9475ab60f..37221775f 100644
--- a/packages/client/src/clients/feed/interfaces.ts
+++ b/packages/client/src/clients/feed/interfaces.ts
@@ -72,7 +72,7 @@ export type FetchFeedOptions = {
  */
 export type FetchFeedOptionsForRequest = Omit<
   FeedClientOptions,
-  "trigger_data"
+  "trigger_data" | "inserted_at_date_range"
 > & {
   /** The trigger data of the feed items (as a JSON string). */
   trigger_data?: string;