@youdotcom-oss/api 0.3.0 → 0.3.2

package/package.json

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

package/src/contents/contents.schemas.ts

@@ -6,7 +6,21 @@ import * as z from 'zod'
  */
 export const ContentsQuerySchema = z.object({
   urls: z
-    .array(z.string().url())
+    .array(
+      // Use .refine() instead of .url() to ensure JSON schema includes "type": "string"
+      // This is required for OpenAI function calling schema validation
+      z.string().refine(
+        (val) => {
+          try {
+            new URL(val)
+            return true
+          } catch {
+            return false
+          }
+        },
+        { message: 'Invalid URL format' },
+      ),
+    )
     .min(1)
     .describe('Array of webpage URLs to extract content from (e.g., ["https://example.com"])'),
   formats: z

package/src/contents/tests/contents.schema-validation.spec.ts

@@ -24,6 +24,7 @@ describe('ContentsQuerySchema OpenAPI validation', () => {
       {}, // Missing urls
       { urls: [] }, // Empty urls array
       { urls: ['not-a-url'] }, // Invalid URL
+      { urls: [''] }, // Empty URL string
       { urls: ['https://example.com'], formats: ['invalid'] }, // Invalid format
       { urls: ['https://example.com'], crawl_timeout: 0 }, // Timeout too low
       { urls: ['https://example.com'], crawl_timeout: 61 }, // Timeout too high

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,34 @@
+import { z } from 'zod'
+
+/**
+ * Schema for API error response body (402 Payment Required)
+ *
+ * @public
+ */
+export const ApiErrorResponseSchema = z.object({
+  message: z.string().optional(),
+  // Use .refine() instead of .url() to ensure JSON schema includes "type": "string"
+  // This is required for OpenAI function calling schema validation
+  upgrade_url: z
+    .string()
+    .refine(
+      (val) => {
+        try {
+          new URL(val)
+          return true
+        } catch {
+          return false
+        }
+      },
+      { message: 'Invalid URL format' },
+    )
+    .optional(),
+  reset_at: z.string().optional(),
+})
+
+/**
+ * Type for API error response
+ *
+ * @public
+ */
+export type ApiErrorResponse = z.infer<typeof ApiErrorResponseSchema>