@youdotcom-oss/api 0.2.2 → 0.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youdotcom-oss/api",
-  "version": "0.2.2",
+  "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'
 
@@ -42,6 +43,31 @@ export const fetchSearchResults = async ({
       throw new Error('Rate limited by You.com API. Please try again later.')
     } else if (errorCode === 403) {
       throw new Error('Forbidden. Please check your You.com API key.')
+    } else if (errorCode === 402) {
+      let errorMessage = 'Free tier limit exceeded. Please upgrade to continue.'
+      let upgradeUrl = 'https://you.com/platform'
+
+      try {
+        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
+      }
+
+      throw new Error(`${errorMessage} Upgrade at: ${upgradeUrl}`)
     }
 
     throw new Error(`Failed to perform search. Error code: ${errorCode}`)

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>

package/src/shared/api.constants.ts

@@ -5,6 +5,6 @@
  * Exported for use in tests and external packages.
  */
 
-export const SEARCH_API_URL = 'https://ydc-index.io/v1/search'
-export const DEEP_SEARCH_API_URL = 'https://api.you.com/v1/deep_search'
-export const CONTENTS_API_URL = 'https://ydc-index.io/v1/contents'
+export const SEARCH_API_URL = process.env.YDC_SEARCH_API_URL || 'https://ydc-index.io/v1/search'
+export const DEEP_SEARCH_API_URL = process.env.YDC_DEEP_SEARCH_API_URL || 'https://api.you.com/v1/deep_search'
+export const CONTENTS_API_URL = process.env.YDC_CONTENTS_API_URL || 'https://ydc-index.io/v1/contents'