feat: improve HackerNews client

Author: transitive-bullshit

examples/playground/bin/scratch.ts

@@ -144,8 +144,17 @@ async function main() {
   // const res = await zoomInfo.searchContacts({
   //   fullName: 'Kevin Raheja'
   // })
-  const gravatar = new stdlib.GravatarClient()
-  const res = await gravatar.getProfileByIdentifier('[email protected]')
+  // const gravatar = new stdlib.GravatarClient()
+  // const res = await gravatar.getProfileByIdentifier('[email protected]')
+
+  const hn = new stdlib.HackerNewsClient()
+  // const res = await hn.getSearchItem('43201417')
+  const res = await hn.searchItems({
+    query: 'OpenAI',
+    tags: ['story'],
+    sortBy: 'recency',
+    numericFilters: ['points>1000']
+  })
 
   console.log(JSON.stringify(res, null, 2))
 }

packages/core/src/utils.ts

@@ -198,7 +198,12 @@ export function sanitizeSearchParams(
         string | number | boolean | string[] | number[] | boolean[] | undefined
       >
     | object,
-  { csv = false }: { csv?: boolean } = {}
+  {
+    csv = false
+  }: {
+    /** Whether or not to use comma-separated-values for arrays or multiple entries (the default) */
+    csv?: boolean
+  } = {}
 ): URLSearchParams {
   const entries = Object.entries(searchParams).flatMap(([key, value]) => {
     if (key === undefined || value === undefined) {

packages/gravatar/src/gravatar-client.ts

@@ -51,7 +51,7 @@ export namespace gravatar {
     /** The name of the company where the user is employed. */
     company: string
     /** An array of verified accounts the user has added to their profile. The number of verified accounts displayed is limited to a maximum of 4 in unauthenticated requests. */
-    verified_accounts: Account[]
+    verified_accounts: VerifiedAccount[]
     /** A phonetic guide to pronouncing the user’s name. */
     pronunciation: string
     /** The pronouns the user prefers to use. */
@@ -60,9 +60,9 @@ export namespace gravatar {
     is_organization?: boolean
     links?: Link[]
     interests?: any[]
-    gallery?: Image[]
+    gallery?: GalleryImage[]
     payments?: {
-      links?: any[]
+      links?: Link[]
       crypto_wallets?: CryptoWallet[]
     }
 
@@ -78,7 +78,7 @@ export namespace gravatar {
     contact_info?: ContactInfo
   }
 
-  export interface Account {
+  export interface VerifiedAccount {
     service_type: string
     service_label: string
     service_icon: string
@@ -91,7 +91,7 @@ export namespace gravatar {
     url: string
   }
 
-  export interface Image {
+  export interface GalleryImage {
     url: string
     alt_text: string
   }