@youdotcom-oss/api 0.3.0 → 0.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youdotcom-oss/api",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "You.com API client with bundled CLI for agents supporting Agent Skills",
   "license": "MIT",
   "engines": {

package/src/main.ts

@@ -16,8 +16,9 @@ export * from './deep-search/deep-search.utils.ts'
 // Search
 export * from './search/search.schemas.ts'
 export * from './search/search.utils.ts'
-// Shared
 export * from './shared/api.constants.ts'
 export * from './shared/api.types.ts'
+// Shared
+export * from './shared/api-error.schemas.ts'
 export * from './shared/dry-run-utils.ts'
 export * from './shared/generate-error-report-link.ts'

package/src/search/search.utils.ts

@@ -1,5 +1,6 @@
 import { SEARCH_API_URL } from '../shared/api.constants.ts'
 import type { GetUserAgent } from '../shared/api.types.ts'
+import { ApiErrorResponseSchema } from '../shared/api-error.schemas.ts'
 import { checkResponseForErrors } from '../shared/check-response-for-errors.ts'
 import { type SearchQuery, SearchResponseSchema } from './search.schemas.ts'
 
@@ -47,16 +48,20 @@ export const fetchSearchResults = async ({
       let upgradeUrl = 'https://you.com/platform'
 
       try {
-        const errorBody = (await response.json()) as any
-        if (errorBody?.message) {
-          errorMessage = errorBody.message
-        }
-        if (errorBody?.upgrade_url) {
-          upgradeUrl = errorBody.upgrade_url
-        }
-        if (errorBody?.reset_at) {
-          const resetDate = new Date(errorBody.reset_at).toLocaleDateString()
-          errorMessage += ` Limit resets on ${resetDate}.`
+        const json = await response.json()
+        const parseResult = ApiErrorResponseSchema.safeParse(json)
+        if (parseResult.success) {
+          const errorBody = parseResult.data
+          if (errorBody.message) {
+            errorMessage = errorBody.message
+          }
+          if (errorBody.upgrade_url) {
+            upgradeUrl = errorBody.upgrade_url
+          }
+          if (errorBody.reset_at) {
+            const resetDate = new Date(errorBody.reset_at).toLocaleDateString()
+            errorMessage += ` Limit resets on ${resetDate}.`
+          }
         }
       } catch {
         // If parsing fails, use default message

package/src/shared/api-error.schemas.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod'
+
+/**
+ * Schema for API error response body (402 Payment Required)
+ *
+ * @public
+ */
+export const ApiErrorResponseSchema = z.object({
+  message: z.string().optional(),
+  upgrade_url: z.string().url().optional(),
+  reset_at: z.string().optional(),
+})
+
+/**
+ * Type for API error response
+ *
+ * @public
+ */
+export type ApiErrorResponse = z.infer<typeof ApiErrorResponseSchema>