make code more typescripty

Author: MQ37

src/types.ts

@@ -3,6 +3,13 @@ import type { CheerioCrawlerOptions, PlaywrightCrawlerOptions } from 'crawlee';
 
 import type { ContentCrawlerTypes } from './const';
 
+/**
+ * Utility type to make specific properties of T optional.
+ * @template T - The type to make properties optional
+ * @template K - The keys of T to make optional
+ */
+type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+
 export type OutputFormats = 'text' | 'markdown' | 'html';
 export type SERPProxyGroup = 'GOOGLE_SERP' | 'SHADER';
 export type ScrapingTool = 'browser-playwright' | 'raw-http';
@@ -95,6 +102,12 @@ export type SearchCrawlerUserData = {
     totalPages: number;
 };
 
+/**
+ * Type for createSearchRequest function parameters.
+ * Makes pagination fields optional while keeping required fields mandatory.
+ */
+export type CreateSearchRequestUserData = Optional<SearchCrawlerUserData, 'timeMeasures' | 'collectedResults' | 'currentPage' | 'totalPages'>;
+
 export type ContentCrawlerUserData = {
     query: string;
     responseId: string;

src/utils.ts

@@ -7,6 +7,7 @@ import { log } from 'crawlee';
 import inputSchema from '../.actor/input_schema.json' with { type: 'json' };
 import type { ContentCrawlerUserData,
     ContentScraperSettings,
+    CreateSearchRequestUserData,
     Input,
     OrganicResult, OutputFormats,
     SearchCrawlerUserData,
@@ -87,13 +88,7 @@ export function randomId() {
  * We add +1 to the calculated totalPages to account for pages that return fewer than 10 results.
  */
 export function createSearchRequest(
-    userData: Partial<SearchCrawlerUserData> & {
-        query: string;
-        responseId: string;
-        maxResults: number;
-        contentCrawlerKey: string;
-        contentScraperSettings: ContentScraperSettings;
-    },
+    userData: CreateSearchRequestUserData,
     proxyConfiguration: ProxyConfiguration | undefined,
     startOffset = 0,
 ): RequestOptions<SearchCrawlerUserData> {