{"_id":"@aizukanne/ihyee","_rev":"3-dfb19b7477d7827759e00139e7239789","name":"@aizukanne/ihyee","dist-tags":{"latest":"1.2.0"},"versions":{"0.1.0":{"name":"@aizukanne/ihyee","version":"0.1.0","keywords":["ihyee","web-intelligence","web-scraping","search","content-extraction","api-client","sdk"],"author":{"name":"Delta Telematics"},"license":"MIT","_id":"@aizukanne/ihyee@0.1.0","maintainers":[{"name":"aizukanne","email":"aizukanne@delta-telematics.ca"}],"homepage":"https://github.com/aizukanne/ihyee-js#readme","bugs":{"url":"https://github.com/aizukanne/ihyee-js/issues"},"dist":{"shasum":"19b605e56cbd91f2e7e6ac83ee2d6dbc8e56aed4","tarball":"https://registry.npmjs.org/@aizukanne/ihyee/-/ihyee-0.1.0.tgz","fileCount":19,"integrity":"sha512-ev2ZCxMSHZEdDfczLWWm4JHIsd/JjbVPY7mYlPMCc3ZCgEUkKmwsj9IJchSWIYVEgKYKAJOixzVu/YMxKKo3dg==","signatures":[{"sig":"MEUCIQDyl8RnnAIdb3Q5lgqjFJGljoneHIEOkt1OK3/gw4yRlgIgPX4bpzKWccLuUvBYJuX6uq202y2kUOr2S4uF1nMFNoQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31913},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"dc898b4b55f1f971fbe25977d1ab12911a06c31f","scripts":{"test":"vitest run","build":"tsc","clean":"rm -rf dist","test:watch":"vitest","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"aizukanne","email":"aizukanne@delta-telematics.ca"},"repository":{"url":"git+https://github.com/aizukanne/ihyee-js.git","type":"git"},"_npmVersion":"11.6.2","description":"JavaScript/TypeScript SDK for the ihyee web intelligence API","directories":{},"_nodeVersion":"24.11.0","_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.1.0","typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/ihyee_0.1.0_1773892990636_0.37185405412607286","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@aizukanne/ihyee","version":"1.1.0","keywords":["ihyee","web-intelligence","web-scraping","search","content-extraction","api-client","sdk"],"author":{"name":"Delta Telematics"},"license":"MIT","_id":"@aizukanne/ihyee@1.1.0","maintainers":[{"name":"aizukanne","email":"aizukanne@delta-telematics.ca"}],"homepage":"https://github.com/aizukanne/ihyee-js#readme","bugs":{"url":"https://github.com/aizukanne/ihyee-js/issues"},"dist":{"shasum":"af5147dc94dc325e0633c0a49bd49d17e35490fe","tarball":"https://registry.npmjs.org/@aizukanne/ihyee/-/ihyee-1.1.0.tgz","fileCount":19,"integrity":"sha512-DC6NzOECoHJI7Agi1usuArcU9Oows6Kt2IsoV+YPTLOhQpcaaEIxLiwylS/rYCvB7ZcW/1/RTTVnGX03sWq+jA==","signatures":[{"sig":"MEYCIQCIrDsQXsciAWkI+opZjQnAs0RJKO+ViTVH5yO+1xNwWAIhAIqEAHHu3SH07OcWhdMNVqGzoaOzw5KVQPdTCB5vS9fE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37098},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"18201647b700bba4a9cf20648055bb5f97efc818","scripts":{"test":"vitest run","build":"tsc","clean":"rm -rf dist","test:watch":"vitest","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"aizukanne","email":"aizukanne@delta-telematics.ca"},"repository":{"url":"git+https://github.com/aizukanne/ihyee-js.git","type":"git"},"_npmVersion":"10.9.4","description":"JavaScript/TypeScript SDK for the ihyee web intelligence API","directories":{},"_nodeVersion":"22.22.0","_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.1.0","typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/ihyee_1.1.0_1773984164383_0.20912322501671698","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@aizukanne/ihyee","version":"1.2.0","description":"JavaScript/TypeScript SDK for the ihyee web intelligence API","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"engines":{"node":">=18"},"scripts":{"build":"tsc","test":"vitest run","test:watch":"vitest","clean":"rm -rf dist","prepublishOnly":"npm run clean && npm run build"},"keywords":["ihyee","web-intelligence","web-scraping","search","content-extraction","api-client","sdk"],"author":{"name":"Delta Telematics"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/aizukanne/ihyee-js.git"},"homepage":"https://github.com/aizukanne/ihyee-js#readme","bugs":{"url":"https://github.com/aizukanne/ihyee-js/issues"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0","vitest":"^3.1.0"},"_id":"@aizukanne/ihyee@1.2.0","gitHead":"18201647b700bba4a9cf20648055bb5f97efc818","_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-DADCvalcGp//GotAzMxu8BDmhDkLWnOu7JD6EBGRhnhxuUupQztdMVSFmsfuSN6nS93UVcyPsNWqyL14yvZJ4w==","shasum":"7312e3352c137d79a35066a2c4ba8b72c048dbdb","tarball":"https://registry.npmjs.org/@aizukanne/ihyee/-/ihyee-1.2.0.tgz","fileCount":19,"unpackedSize":37301,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC6mXQ87S/fm8+OM9VXcEbvz598z4KdQ/SkDFA9nYZr3QIhAMCNjIuffCbYnFJvLLkd8wf6Q8l47ldv5QR1WAnZpMzm"}]},"_npmUser":{"name":"aizukanne","email":"aizukanne@delta-telematics.ca"},"directories":{},"maintainers":[{"name":"aizukanne","email":"aizukanne@delta-telematics.ca"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ihyee_1.2.0_1773988392114_0.0836699960966032"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-19T04:03:10.540Z","modified":"2026-03-20T06:33:12.358Z","0.1.0":"2026-03-19T04:03:10.766Z","1.1.0":"2026-03-20T05:22:44.533Z","1.2.0":"2026-03-20T06:33:12.254Z"},"bugs":{"url":"https://github.com/aizukanne/ihyee-js/issues"},"author":{"name":"Delta Telematics"},"license":"MIT","homepage":"https://github.com/aizukanne/ihyee-js#readme","keywords":["ihyee","web-intelligence","web-scraping","search","content-extraction","api-client","sdk"],"repository":{"type":"git","url":"git+https://github.com/aizukanne/ihyee-js.git"},"description":"JavaScript/TypeScript SDK for the ihyee web intelligence API","maintainers":[{"name":"aizukanne","email":"aizukanne@delta-telematics.ca"}],"readme":"# ihyee\n\n[![npm](https://img.shields.io/npm/v/@aizukanne/ihyee)](https://www.npmjs.com/package/@aizukanne/ihyee)\n[![Node](https://img.shields.io/node/v/@aizukanne/ihyee)](https://www.npmjs.com/package/@aizukanne/ihyee)\n[![License](https://img.shields.io/npm/l/@aizukanne/ihyee)](https://github.com/aizukanne/ihyee-js/blob/main/LICENSE)\n\n**JavaScript/TypeScript SDK for the ihyee web intelligence API** — search, fetch, and understand any web page in one API call.\n\n## Install\n\n```bash\nnpm install @aizukanne/ihyee\n```\n\n## Quick Start\n\n```typescript\nimport { Ihyee } from 'ihyee';\n\nconst client = new Ihyee({ apiKey: 'your_api_key' });\nconst results = await client.search('transformer architecture', { maxResults: 3 });\n\nfor (const item of results.content) {\n  if (item.type === 'text' && item.text) {\n    console.log(item.text.summary);\n  }\n}\n```\n\n## Search\n\nSearch the web via Google and return extracted, summarized content from top results.\n\n```typescript\nconst results = await client.search('latest AI research', {\n  maxResults: 5,\n  contentMode: 'both',       // 'both', 'full_text', or 'summary'\n  before: '2026-01-01',      // date filters\n  mustHave: 'transformer',   // exact phrase required\n});\n\nfor (const item of results.content) {\n  if (item.type === 'text') {\n    console.log(`URL: ${item.url}`);\n    console.log(`Summary: ${item.text?.summary}`);\n    console.log(`Links: ${item.text?.links.length}`);\n  } else if (item.type === 'image_url') {\n    console.log(`Image: ${item.image_url?.url}`);\n  }\n}\n```\n\n## Fetch\n\nFetch and extract content from specific URLs. Automatically uses headless browser rendering for JavaScript-heavy pages.\n\n```typescript\nconst results = await client.fetch(\n  ['https://example.com/article', 'https://spa-app.com/page'],\n  { contentMode: 'full_text' },\n);\n```\n\n## Render\n\nForce full browser rendering with Playwright. Use for SPAs and pages that require JavaScript.\n\n```typescript\nconst results = await client.render('https://spa-app.com/dashboard', {\n  waitFor: 'networkidle',\n  waitSelector: '#content',\n  timeoutMs: 30000,\n});\n```\n\n## Error Handling\n\n```typescript\nimport { Ihyee, AuthError, RateLimitError, IhyeeError } from 'ihyee';\n\ntry {\n  const results = await client.search('query');\n} catch (e) {\n  if (e instanceof AuthError) {\n    console.log('Invalid API key');\n  } else if (e instanceof RateLimitError) {\n    console.log(`Rate limited — retry after ${e.retryAfter}s`);\n  } else if (e instanceof IhyeeError) {\n    console.log(`API error ${e.code}: ${e.message}`);\n  }\n}\n```\n\n## Environment Variable\n\n```bash\n# Set IHYEE_API_KEY in your environment\nexport IHYEE_API_KEY=your_api_key\n```\n\n```typescript\n// Then omit apiKey parameter\nconst client = new Ihyee();\n```\n\n## TypeScript\n\nFull type definitions are included. All response types match the API JSON exactly (snake_case fields). Option parameters use camelCase for idiomatic JS/TS usage.\n\n```typescript\nimport type {\n  SearchResponse,\n  FetchResponse,\n  ContentItem,\n  TextContent,\n  ImageContent,\n  DocumentContent,\n  ExtractedLink,\n  ResponseMeta,\n} from 'ihyee';\n```\n\n## Requirements\n\n- Node.js 18+ (uses native `fetch()`)\n- Zero runtime dependencies\n\n## Documentation\n\nFull API docs: [ihyee.delta-telematics.ca/api-docs](https://ihyee.delta-telematics.ca/api-docs)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}