ollama-models 0.2.0

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, [fullname]
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.ko.md

@@ -0,0 +1,76 @@
+# ollama-models
+
+[Ollama](https://ollama.com) 레지스트리에서 모델을 검색하고 나열하는 TypeScript/JavaScript 클라이언트.
+
+English | **한국어**
+
+## 설치
+
+```bash
+npm install ollama-models
+# 또는
+pnpm add ollama-models
+```
+
+## 사용법
+
+```typescript
+import { OllamaModelsClient } from 'ollama-models';
+
+// 기본 URL 불필요 — 공식 호스팅 인스턴스 사용
+const client = new OllamaModelsClient();
+
+// 자체 호스팅 API를 사용하는 경우에만 baseUrl 전달
+// const client = new OllamaModelsClient('https://your-own-instance.workers.dev');
+
+// 모델 검색
+const result = await client.search('qwen3', 1);
+result.pages.forEach(p => console.log(p.http_url));
+
+// 모델의 모든 태그 조회
+const model = await client.getModel('qwen3');
+console.log(model.default_tag); // qwen3:latest
+model.tags.forEach(t => console.log(t));
+```
+
+## API
+
+### `new OllamaModelsClient(baseUrl?)`
+
+| 파라미터 | 타입 | 기본값 | 설명 |
+|-----------|------|---------|-------------|
+| `baseUrl` | `string` | `https://ollama.devcomfort.me/api` | ollama-models Workers API의 Base URL |
+
+### `client.search(keyword?, page?): Promise<SearchResult>`
+
+| 파라미터 | 타입 | 기본값 | 설명 |
+|-----------|------|---------|-------------|
+| `keyword` | `string` | `""` | 검색어 |
+| `page` | `number` | `1` | 페이지 번호 (1부터 시작) |
+
+### `client.getModel(name): Promise<ModelTags>`
+
+| 파라미터 | 타입 | 설명 |
+|-----------|------|-------------|
+| `name` | `string` | 모델 식별자 (`qwen3`, `library/qwen3`, `User/model`, 또는 전체 URL) |
+
+## 타입
+
+```typescript
+interface SearchResult {
+  pages: ModelPage[];
+  page_id: number;
+  keyword: string;
+}
+
+interface ModelTags {
+  page_url: string;
+  id: string;           // 예: "library/qwen3"
+  tags: string[];       // 예: ["qwen3:latest", "qwen3:4b"]
+  default_tag: string | null;
+}
+
+interface ModelPage {
+  http_url: string;
+}
+```

package/README.md

@@ -0,0 +1,74 @@
+# ollama-models
+
+TypeScript/JavaScript client for searching and listing models from the [Ollama](https://ollama.com) registry.
+
+## Installation
+
+```bash
+npm install ollama-models
+# or
+pnpm add ollama-models
+```
+
+## Usage
+
+```typescript
+import { OllamaModelsClient } from 'ollama-models';
+
+// No base URL needed — defaults to the official hosted instance
+const client = new OllamaModelsClient();
+
+// Pass a base URL only if you self-host the API
+// const client = new OllamaModelsClient('https://your-own-instance.workers.dev');
+
+// Search models
+const result = await client.search('qwen3', 1);
+result.pages.forEach(p => console.log(p.http_url));
+
+// Get all tags for a model
+const model = await client.getModel('qwen3');
+console.log(model.default_tag); // qwen3:latest
+model.tags.forEach(t => console.log(t));
+```
+
+## API
+
+### `new OllamaModelsClient(baseUrl?)`
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `baseUrl` | `string` | `https://ollama.devcomfort.me/api` | Base URL of the ollama-models Workers API |
+
+### `client.search(keyword?, page?): Promise<SearchResult>`
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `keyword` | `string` | `""` | Search term |
+| `page` | `number` | `1` | Page number (1-based) |
+
+### `client.getModel(name): Promise<ModelTags>`
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `name` | `string` | Model identifier (`qwen3`, `library/qwen3`, `User/model`, or full URL) |
+
+## Types
+
+```typescript
+interface SearchResult {
+  pages: ModelPage[];
+  page_id: number;
+  keyword: string;
+}
+
+interface ModelTags {
+  page_url: string;
+  id: string;           // e.g. "library/qwen3"
+  tags: string[];       // e.g. ["qwen3:latest", "qwen3:4b"]
+  default_tag: string | null;
+}
+
+interface ModelPage {
+  http_url: string;
+}
+```

package/dist/index.cjs

@@ -0,0 +1,188 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let es_toolkit_util = require("es-toolkit/util");
+//#region src/schemas.ts
+function isObject(val) {
+	return typeof val === "object" && val !== null && !Array.isArray(val);
+}
+/**
+* Asserts that `data` conforms to the {@link ModelPage} shape.
+*
+* @param data - Unknown value to validate.
+* @param context - Label used in error messages (defaults to `"ModelPage"`).
+* @throws When any field is missing or has the wrong type.
+*/
+function assertModelPage(data, context = "ModelPage") {
+	(0, es_toolkit_util.assert)(isObject(data), `${context}: expected object`);
+	(0, es_toolkit_util.assert)(typeof data["http_url"] === "string", `${context}.http_url: expected string`);
+	(0, es_toolkit_util.assert)(typeof data["model_id"] === "string", `${context}.model_id: expected string`);
+}
+/**
+* Asserts that `data` conforms to the {@link SearchResult} shape.
+*
+* @param data - Unknown value to validate.
+* @throws When any field is missing or has the wrong type.
+*/
+function assertSearchResult(data) {
+	(0, es_toolkit_util.assert)(isObject(data), "SearchResult: expected object");
+	(0, es_toolkit_util.assert)(Array.isArray(data["pages"]), "SearchResult.pages: expected array");
+	data["pages"].forEach((p, i) => assertModelPage(p, `SearchResult.pages[${i}]`));
+	const pr = data["page_range"];
+	(0, es_toolkit_util.assert)(typeof pr === "number" || isObject(pr) && typeof pr["from"] === "number" && typeof pr["to"] === "number", "SearchResult.page_range: expected number or { from: number; to: number }");
+	(0, es_toolkit_util.assert)(typeof data["keyword"] === "string", "SearchResult.keyword: expected string");
+}
+/**
+* Asserts that `data` conforms to the {@link ModelTags} shape.
+*
+* @param data - Unknown value to validate.
+* @throws When any field is missing or has the wrong type.
+*/
+function assertModelTags(data) {
+	(0, es_toolkit_util.assert)(isObject(data), "ModelTags: expected object");
+	(0, es_toolkit_util.assert)(typeof data["page_url"] === "string", "ModelTags.page_url: expected string");
+	(0, es_toolkit_util.assert)(typeof data["id"] === "string", "ModelTags.id: expected string");
+	(0, es_toolkit_util.assert)(Array.isArray(data["tags"]), "ModelTags.tags: expected array");
+	data["tags"].forEach((t, i) => (0, es_toolkit_util.assert)(typeof t === "string", `ModelTags.tags[${i}]: expected string`));
+	(0, es_toolkit_util.assert)(data["default_tag"] === null || typeof data["default_tag"] === "string", "ModelTags.default_tag: expected string or null");
+}
+/**
+* Asserts that `data` conforms to the {@link CheckResult} shape.
+*
+* @param data - Unknown value to validate.
+* @param context - Label used in error messages (defaults to `"CheckResult"`).
+* @throws When any field is missing or has the wrong type.
+*/
+function assertCheckResult(data, context = "CheckResult") {
+	(0, es_toolkit_util.assert)(isObject(data), `${context}: expected object`);
+	(0, es_toolkit_util.assert)(typeof data["ok"] === "boolean", `${context}.ok: expected boolean`);
+	if ("count" in data) (0, es_toolkit_util.assert)(typeof data["count"] === "number", `${context}.count: expected number`);
+	if ("error" in data) (0, es_toolkit_util.assert)(typeof data["error"] === "string", `${context}.error: expected string`);
+}
+/**
+* Asserts that `data` conforms to the {@link HealthStatus} shape.
+*
+* @param data - Unknown value to validate.
+* @throws When any field is missing or has the wrong type.
+*/
+function assertHealthStatus(data) {
+	(0, es_toolkit_util.assert)(isObject(data), "HealthStatus: expected object");
+	(0, es_toolkit_util.assert)(typeof data["ok"] === "boolean", "HealthStatus.ok: expected boolean");
+	(0, es_toolkit_util.assert)(typeof data["timestamp"] === "string", "HealthStatus.timestamp: expected string");
+	(0, es_toolkit_util.assert)(isObject(data["checks"]), "HealthStatus.checks: expected object");
+	assertCheckResult(data["checks"]["search"], "HealthStatus.checks.search");
+	assertCheckResult(data["checks"]["model"], "HealthStatus.checks.model");
+}
+//#endregion
+//#region src/client.ts
+/**
+* Base URL of the officially hosted ollama-models Workers API.
+*
+* Pass a different URL to {@link OllamaModelsClient} when self-hosting.
+*/
+const DEFAULT_BASE_URL = "https://ollama.devcomfort.me/api";
+/**
+* HTTP client for the ollama-models Workers API.
+*
+* Provides a typed, promise-based interface over the `GET /search` and
+* `GET /model` endpoints. Create one instance per application and reuse it.
+*
+* @example
+* ```typescript
+* const client = new OllamaModelsClient();
+*
+* // Search for models
+* const { pages } = await client.search('qwen3');
+* console.log(pages[0].http_url);
+*
+* // Get all available tags
+* const { tags, default_tag } = await client.getModel('library/qwen3');
+* console.log(default_tag); // 'qwen3:latest'
+* ```
+*/
+var OllamaModelsClient = class {
+	baseUrl;
+	/**
+	* @param baseUrl - Base URL of the deployed ollama-models Workers API.
+	*   Defaults to {@link DEFAULT_BASE_URL} (the official hosted instance).
+	*   Trailing slashes are stripped automatically.
+	*/
+	constructor(baseUrl = DEFAULT_BASE_URL) {
+		this.baseUrl = baseUrl.replace(/\/$/, "");
+	}
+	/**
+	* Search for models on Ollama.
+	*
+	* @param keyword - Search term. Pass an empty string to list all models.
+	* @param page - 1-based page number. Defaults to `1`.
+	* @returns A {@link SearchResult} containing matching model pages and
+	*   metadata about the requested page.
+	* @throws {Error} When the API returns a non-2xx HTTP status.
+	* @example
+	* ```typescript
+	* const { pages, page_range, keyword } = await client.search('qwen3', 1);
+	* const firstUrl = pages[0].http_url;
+	* ```
+	*/
+	async search(keyword = "", page = 1) {
+		const url = new URL(`${this.baseUrl}/search`);
+		if (keyword) url.searchParams.set("q", keyword);
+		url.searchParams.set("page", String(page));
+		const res = await fetch(url.toString());
+		if (!res.ok) throw new Error(`Search failed: HTTP ${res.status}`);
+		const data = await res.json();
+		assertSearchResult(data);
+		return data;
+	}
+	/**
+	* Retrieve all available tags (weights) for a model.
+	*
+	* @param name - Model identifier in `{profile}/{name}` format, e.g.:
+	*   - `"library/qwen3"` — official Ollama library model
+	*   - `"RogerBen/qwen3.5-35b-opus-distill"` — community model
+	*   - `"https://ollama.com/library/qwen3"` — full URL
+	* @returns A {@link ModelTags} with all available weights.
+	*   `default_tag` is `null` when the model has no `latest` tag.
+	* @throws {Error} When the API returns a non-2xx HTTP status.
+	* @example
+	* ```typescript
+	* const { tags, default_tag } = await client.getModel('library/qwen3');
+	* // Pull the default weight: 'qwen3:latest'
+	* ```
+	*/
+	async getModel(name) {
+		const url = new URL(`${this.baseUrl}/model`);
+		url.searchParams.set("name", name);
+		const res = await fetch(url.toString());
+		if (!res.ok) throw new Error(`Model fetch failed: HTTP ${res.status}`);
+		const data = await res.json();
+		assertModelTags(data);
+		return data;
+	}
+	/**
+	* Run a live health check against both scrapers.
+	*
+	* @returns A {@link HealthStatus} with per-scraper probe results and an
+	*   aggregate `ok` flag.
+	* @throws {Error} When the API returns a non-2xx HTTP status.
+	* @example
+	* ```typescript
+	* const { ok, checks } = await client.health();
+	* if (!ok) console.error('search error:', checks.search.error);
+	* ```
+	*/
+	async health() {
+		const res = await fetch(`${this.baseUrl}/health`);
+		if (!res.ok) throw new Error(`Health check failed: HTTP ${res.status}`);
+		const data = await res.json();
+		assertHealthStatus(data);
+		return data;
+	}
+};
+//#endregion
+exports.OllamaModelsClient = OllamaModelsClient;
+exports.assertCheckResult = assertCheckResult;
+exports.assertHealthStatus = assertHealthStatus;
+exports.assertModelPage = assertModelPage;
+exports.assertModelTags = assertModelTags;
+exports.assertSearchResult = assertSearchResult;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/schemas.ts","../src/client.ts"],"sourcesContent":["import { assert } from 'es-toolkit/util';\nimport type { ModelTags, ModelPage, SearchResult, CheckResult, HealthStatus } from './types';\n\n// === helpers ===\n\nfunction isObject(val: unknown): val is Record<string, unknown> {\n  return typeof val === 'object' && val !== null && !Array.isArray(val);\n}\n\n// === per-type assertions ===\n\n/**\n * Asserts that `data` conforms to the {@link ModelPage} shape.\n *\n * @param data - Unknown value to validate.\n * @param context - Label used in error messages (defaults to `\"ModelPage\"`).\n * @throws When any field is missing or has the wrong type.\n */\nexport function assertModelPage(\n  data: unknown,\n  context = 'ModelPage',\n): asserts data is ModelPage {\n  assert(isObject(data), `${context}: expected object`);\n  assert(typeof data['http_url'] === 'string', `${context}.http_url: expected string`);\n  assert(typeof data['model_id'] === 'string', `${context}.model_id: expected string`);\n}\n\n/**\n * Asserts that `data` conforms to the {@link SearchResult} shape.\n *\n * @param data - Unknown value to validate.\n * @throws When any field is missing or has the wrong type.\n */\nexport function assertSearchResult(data: unknown): asserts data is SearchResult {\n  assert(isObject(data), 'SearchResult: expected object');\n  assert(Array.isArray(data['pages']), 'SearchResult.pages: expected array');\n  (data['pages'] as unknown[]).forEach((p, i) =>\n    assertModelPage(p, `SearchResult.pages[${i}]`),\n  );\n  const pr = data['page_range'];\n  assert(\n    typeof pr === 'number' ||\n      (isObject(pr) && typeof pr['from'] === 'number' && typeof pr['to'] === 'number'),\n    'SearchResult.page_range: expected number or { from: number; to: number }',\n  );\n  assert(typeof data['keyword'] === 'string', 'SearchResult.keyword: expected string');\n}\n\n/**\n * Asserts that `data` conforms to the {@link ModelTags} shape.\n *\n * @param data - Unknown value to validate.\n * @throws When any field is missing or has the wrong type.\n */\nexport function assertModelTags(data: unknown): asserts data is ModelTags {\n  assert(isObject(data), 'ModelTags: expected object');\n  assert(typeof data['page_url'] === 'string', 'ModelTags.page_url: expected string');\n  assert(typeof data['id'] === 'string', 'ModelTags.id: expected string');\n  assert(Array.isArray(data['tags']), 'ModelTags.tags: expected array');\n  (data['tags'] as unknown[]).forEach((t, i) =>\n    assert(typeof t === 'string', `ModelTags.tags[${i}]: expected string`),\n  );\n  assert(\n    data['default_tag'] === null || typeof data['default_tag'] === 'string',\n    'ModelTags.default_tag: expected string or null',\n  );\n}\n\n/**\n * Asserts that `data` conforms to the {@link CheckResult} shape.\n *\n * @param data - Unknown value to validate.\n * @param context - Label used in error messages (defaults to `\"CheckResult\"`).\n * @throws When any field is missing or has the wrong type.\n */\nexport function assertCheckResult(\n  data: unknown,\n  context = 'CheckResult',\n): asserts data is CheckResult {\n  assert(isObject(data), `${context}: expected object`);\n  assert(typeof data['ok'] === 'boolean', `${context}.ok: expected boolean`);\n  if ('count' in data) {\n    assert(typeof data['count'] === 'number', `${context}.count: expected number`);\n  }\n  if ('error' in data) {\n    assert(typeof data['error'] === 'string', `${context}.error: expected string`);\n  }\n}\n\n/**\n * Asserts that `data` conforms to the {@link HealthStatus} shape.\n *\n * @param data - Unknown value to validate.\n * @throws When any field is missing or has the wrong type.\n */\nexport function assertHealthStatus(data: unknown): asserts data is HealthStatus {\n  assert(isObject(data), 'HealthStatus: expected object');\n  assert(typeof data['ok'] === 'boolean', 'HealthStatus.ok: expected boolean');\n  assert(typeof data['timestamp'] === 'string', 'HealthStatus.timestamp: expected string');\n  assert(isObject(data['checks']), 'HealthStatus.checks: expected object');\n  assertCheckResult(data['checks']['search'], 'HealthStatus.checks.search');\n  assertCheckResult(data['checks']['model'], 'HealthStatus.checks.model');\n}\n","import type { SearchResult, ModelTags, HealthStatus } from './types';\nimport { assertModelTags, assertSearchResult, assertHealthStatus } from './schemas';\n\n/**\n * Base URL of the officially hosted ollama-models Workers API.\n *\n * Pass a different URL to {@link OllamaModelsClient} when self-hosting.\n */\nexport const DEFAULT_BASE_URL = 'https://ollama.devcomfort.me/api';\n\n/**\n * HTTP client for the ollama-models Workers API.\n *\n * Provides a typed, promise-based interface over the `GET /search` and\n * `GET /model` endpoints. Create one instance per application and reuse it.\n *\n * @example\n * ```typescript\n * const client = new OllamaModelsClient();\n *\n * // Search for models\n * const { pages } = await client.search('qwen3');\n * console.log(pages[0].http_url);\n *\n * // Get all available tags\n * const { tags, default_tag } = await client.getModel('library/qwen3');\n * console.log(default_tag); // 'qwen3:latest'\n * ```\n */\nexport class OllamaModelsClient {\n  private readonly baseUrl: string;\n\n  /**\n   * @param baseUrl - Base URL of the deployed ollama-models Workers API.\n   *   Defaults to {@link DEFAULT_BASE_URL} (the official hosted instance).\n   *   Trailing slashes are stripped automatically.\n   */\n  constructor(baseUrl: string = DEFAULT_BASE_URL) {\n    this.baseUrl = baseUrl.replace(/\\/$/, '');\n  }\n\n  /**\n   * Search for models on Ollama.\n   *\n   * @param keyword - Search term. Pass an empty string to list all models.\n   * @param page - 1-based page number. Defaults to `1`.\n   * @returns A {@link SearchResult} containing matching model pages and\n   *   metadata about the requested page.\n   * @throws {Error} When the API returns a non-2xx HTTP status.\n   * @example\n   * ```typescript\n   * const { pages, page_range, keyword } = await client.search('qwen3', 1);\n   * const firstUrl = pages[0].http_url;\n   * ```\n   */\n  async search(keyword = '', page = 1): Promise<SearchResult> {\n    const url = new URL(`${this.baseUrl}/search`);\n    if (keyword) url.searchParams.set('q', keyword);\n    url.searchParams.set('page', String(page));\n\n    const res = await fetch(url.toString());\n    if (!res.ok) throw new Error(`Search failed: HTTP ${res.status}`);\n    const data: unknown = await res.json();\n    assertSearchResult(data);\n    return data;\n  }\n\n  /**\n   * Retrieve all available tags (weights) for a model.\n   *\n   * @param name - Model identifier in `{profile}/{name}` format, e.g.:\n   *   - `\"library/qwen3\"` — official Ollama library model\n   *   - `\"RogerBen/qwen3.5-35b-opus-distill\"` — community model\n   *   - `\"https://ollama.com/library/qwen3\"` — full URL\n   * @returns A {@link ModelTags} with all available weights.\n   *   `default_tag` is `null` when the model has no `latest` tag.\n   * @throws {Error} When the API returns a non-2xx HTTP status.\n   * @example\n   * ```typescript\n   * const { tags, default_tag } = await client.getModel('library/qwen3');\n   * // Pull the default weight: 'qwen3:latest'\n   * ```\n   */\n  async getModel(name: string): Promise<ModelTags> {\n    const url = new URL(`${this.baseUrl}/model`);\n    url.searchParams.set('name', name);\n\n    const res = await fetch(url.toString());\n    if (!res.ok) throw new Error(`Model fetch failed: HTTP ${res.status}`);\n    const data: unknown = await res.json();\n    assertModelTags(data);\n    return data;\n  }\n\n  /**\n   * Run a live health check against both scrapers.\n   *\n   * @returns A {@link HealthStatus} with per-scraper probe results and an\n   *   aggregate `ok` flag.\n   * @throws {Error} When the API returns a non-2xx HTTP status.\n   * @example\n   * ```typescript\n   * const { ok, checks } = await client.health();\n   * if (!ok) console.error('search error:', checks.search.error);\n   * ```\n   */\n  async health(): Promise<HealthStatus> {\n    const res = await fetch(`${this.baseUrl}/health`);\n    if (!res.ok) throw new Error(`Health check failed: HTTP ${res.status}`);\n    const data: unknown = await res.json();\n    assertHealthStatus(data);\n    return data;\n  }\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,262 @@
+//#region src/types.d.ts
+/** A single 1-based page number, or an inclusive `{ from, to }` page range. */
+type PageRange = number | {
+  from: number;
+  to: number;
+};
+/**
+ * A model page discovered from the Ollama search results.
+ *
+ * `model_id` is the full `{profile}/{name}` path. Ollama uses `library` as the
+ * fixed profile name for all officially maintained models, so a `library/`
+ * prefix always means an official model (e.g. `library/qwen3`). Any other
+ * prefix is a community publisher's username (e.g. `alibayram/smollm3`).
+ *
+ * @example
+ * ```typescript
+ * // Official library model — `library/` prefix identifies it as official.
+ * const official: ModelPage = {
+ *   http_url: 'https://ollama.com/library/qwen3',
+ *   model_id: 'library/qwen3',
+ * };
+ *
+ * // Community model — prefix is the publisher's username.
+ * const community: ModelPage = {
+ *   http_url: 'https://ollama.com/alibayram/smollm3',
+ *   model_id: 'alibayram/smollm3',
+ * };
+ * ```
+ */
+interface ModelPage {
+  /** Absolute URL of the Ollama model page. */
+  http_url: string;
+  /**
+   * Full model path in `{profile}/{name}` form.
+   * `library/` as the profile means an officially maintained Ollama model;
+   * any other value is a community publisher's username.
+   */
+  model_id: string;
+}
+/**
+ * Response payload returned by the `GET /search` endpoint.
+ *
+ * @example
+ * ```typescript
+ * const result: SearchResult = {
+ *   pages: [{ http_url: 'https://ollama.com/library/qwen3', model_id: 'library/qwen3' }],
+ *   page_range: 1,
+ *   keyword: 'qwen3',
+ * };
+ *
+ * // Multi-page result
+ * const multi: SearchResult = {
+ *   pages: [...],
+ *   page_range: { from: 1, to: 3 },
+ *   keyword: 'qwen3',
+ * };
+ * ```
+ */
+interface SearchResult {
+  /** Model pages found on the requested search results page. */
+  pages: ModelPage[];
+  /** The page or range of pages that was requested. */
+  page_range: PageRange;
+  /** Search keyword used for the request. */
+  keyword: string;
+}
+/**
+ * Response payload returned by the `GET /model` endpoint.
+ *
+ * All tags belong to the same model page (`page_url`). The `id` is the
+ * full `{profile}/{name}` path without a tag (e.g. `library/qwen3`). To build
+ * an Ollama-compatible pull identifier, combine `id` and a tag:
+ * `${id}:${tag}`.
+ *
+ * `default_tag` is `"latest"` when that tag exists on the page, otherwise
+ * `null` — in which case the caller must pick an explicit tag from `tags`.
+ *
+ * @example
+ * ```typescript
+ * const list: ModelTags = {
+ *   page_url: 'https://ollama.com/library/qwen3',
+ *   id: 'library/qwen3',
+ *   tags: ['qwen3:latest', 'qwen3:4b', 'qwen3:8b'],
+ *   default_tag: 'qwen3:latest',
+ * };
+ *
+ * // Tags are already pull-ready — use directly:
+ * // ollama pull qwen3:latest
+ * ```
+ */
+interface ModelTags {
+  /** Absolute URL of the Ollama model page. */
+  page_url: string;
+  /**
+   * Full model path in `{profile}/{name}` form, without a tag.
+   * `library/` as the profile means an officially maintained Ollama model.
+   */
+  id: string;
+  /**
+   * Pull-ready identifiers for all available weights, e.g.
+   * `['qwen3:latest', 'qwen3:4b']`.
+   * Pass any entry directly to `ollama pull`.
+   */
+  tags: string[];
+  /**
+   * The pull-ready identifier whose tag is `latest`, e.g. `'qwen3:latest'`.
+   * `null` when the model has no `latest` tag — the caller must pick from `tags`.
+   */
+  default_tag: string | null;
+}
+/** Result of a single scraper probe returned inside {@link HealthStatus}. */
+interface CheckResult {
+  /** `true` when the probe returned at least one result without throwing. */
+  ok: boolean;
+  /** Number of results returned by the probe when the check passed. */
+  count?: number;
+  /** Stringified error message when the check failed. */
+  error?: string;
+}
+/**
+ * Response payload returned by the `GET /health` endpoint.
+ *
+ * @example
+ * ```typescript
+ * const status: HealthStatus = {
+ *   ok: true,
+ *   timestamp: '2025-01-01T00:00:00.000Z',
+ *   checks: {
+ *     search: { ok: true, count: 20 },
+ *     model: { ok: true, count: 15 },
+ *   },
+ * };
+ * ```
+ */
+interface HealthStatus {
+  /** `true` only when every individual check passed. */
+  ok: boolean;
+  /** ISO 8601 timestamp of when the health check was run. */
+  timestamp: string;
+  /** Per-scraper probe results. */
+  checks: {
+    search: CheckResult;
+    model: CheckResult;
+  };
+}
+//#endregion
+//#region src/client.d.ts
+/**
+ * HTTP client for the ollama-models Workers API.
+ *
+ * Provides a typed, promise-based interface over the `GET /search` and
+ * `GET /model` endpoints. Create one instance per application and reuse it.
+ *
+ * @example
+ * ```typescript
+ * const client = new OllamaModelsClient();
+ *
+ * // Search for models
+ * const { pages } = await client.search('qwen3');
+ * console.log(pages[0].http_url);
+ *
+ * // Get all available tags
+ * const { tags, default_tag } = await client.getModel('library/qwen3');
+ * console.log(default_tag); // 'qwen3:latest'
+ * ```
+ */
+declare class OllamaModelsClient {
+  private readonly baseUrl;
+  /**
+   * @param baseUrl - Base URL of the deployed ollama-models Workers API.
+   *   Defaults to {@link DEFAULT_BASE_URL} (the official hosted instance).
+   *   Trailing slashes are stripped automatically.
+   */
+  constructor(baseUrl?: string);
+  /**
+   * Search for models on Ollama.
+   *
+   * @param keyword - Search term. Pass an empty string to list all models.
+   * @param page - 1-based page number. Defaults to `1`.
+   * @returns A {@link SearchResult} containing matching model pages and
+   *   metadata about the requested page.
+   * @throws {Error} When the API returns a non-2xx HTTP status.
+   * @example
+   * ```typescript
+   * const { pages, page_range, keyword } = await client.search('qwen3', 1);
+   * const firstUrl = pages[0].http_url;
+   * ```
+   */
+  search(keyword?: string, page?: number): Promise<SearchResult>;
+  /**
+   * Retrieve all available tags (weights) for a model.
+   *
+   * @param name - Model identifier in `{profile}/{name}` format, e.g.:
+   *   - `"library/qwen3"` — official Ollama library model
+   *   - `"RogerBen/qwen3.5-35b-opus-distill"` — community model
+   *   - `"https://ollama.com/library/qwen3"` — full URL
+   * @returns A {@link ModelTags} with all available weights.
+   *   `default_tag` is `null` when the model has no `latest` tag.
+   * @throws {Error} When the API returns a non-2xx HTTP status.
+   * @example
+   * ```typescript
+   * const { tags, default_tag } = await client.getModel('library/qwen3');
+   * // Pull the default weight: 'qwen3:latest'
+   * ```
+   */
+  getModel(name: string): Promise<ModelTags>;
+  /**
+   * Run a live health check against both scrapers.
+   *
+   * @returns A {@link HealthStatus} with per-scraper probe results and an
+   *   aggregate `ok` flag.
+   * @throws {Error} When the API returns a non-2xx HTTP status.
+   * @example
+   * ```typescript
+   * const { ok, checks } = await client.health();
+   * if (!ok) console.error('search error:', checks.search.error);
+   * ```
+   */
+  health(): Promise<HealthStatus>;
+}
+//#endregion
+//#region src/schemas.d.ts
+/**
+ * Asserts that `data` conforms to the {@link ModelPage} shape.
+ *
+ * @param data - Unknown value to validate.
+ * @param context - Label used in error messages (defaults to `"ModelPage"`).
+ * @throws When any field is missing or has the wrong type.
+ */
+declare function assertModelPage(data: unknown, context?: string): asserts data is ModelPage;
+/**
+ * Asserts that `data` conforms to the {@link SearchResult} shape.
+ *
+ * @param data - Unknown value to validate.
+ * @throws When any field is missing or has the wrong type.
+ */
+declare function assertSearchResult(data: unknown): asserts data is SearchResult;
+/**
+ * Asserts that `data` conforms to the {@link ModelTags} shape.
+ *
+ * @param data - Unknown value to validate.
+ * @throws When any field is missing or has the wrong type.
+ */
+declare function assertModelTags(data: unknown): asserts data is ModelTags;
+/**
+ * Asserts that `data` conforms to the {@link CheckResult} shape.
+ *
+ * @param data - Unknown value to validate.
+ * @param context - Label used in error messages (defaults to `"CheckResult"`).
+ * @throws When any field is missing or has the wrong type.
+ */
+declare function assertCheckResult(data: unknown, context?: string): asserts data is CheckResult;
+/**
+ * Asserts that `data` conforms to the {@link HealthStatus} shape.
+ *
+ * @param data - Unknown value to validate.
+ * @throws When any field is missing or has the wrong type.
+ */
+declare function assertHealthStatus(data: unknown): asserts data is HealthStatus;
+//#endregion
+export { type CheckResult, type HealthStatus, type ModelPage, type ModelTags, OllamaModelsClient, type PageRange, type SearchResult, assertCheckResult, assertHealthStatus, assertModelPage, assertModelTags, assertSearchResult };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -0,0 +1,262 @@
+//#region src/types.d.ts
+/** A single 1-based page number, or an inclusive `{ from, to }` page range. */
+type PageRange = number | {
+  from: number;
+  to: number;
+};
+/**
+ * A model page discovered from the Ollama search results.
+ *
+ * `model_id` is the full `{profile}/{name}` path. Ollama uses `library` as the
+ * fixed profile name for all officially maintained models, so a `library/`
+ * prefix always means an official model (e.g. `library/qwen3`). Any other
+ * prefix is a community publisher's username (e.g. `alibayram/smollm3`).
+ *
+ * @example
+ * ```typescript
+ * // Official library model — `library/` prefix identifies it as official.
+ * const official: ModelPage = {
+ *   http_url: 'https://ollama.com/library/qwen3',
+ *   model_id: 'library/qwen3',
+ * };
+ *
+ * // Community model — prefix is the publisher's username.
+ * const community: ModelPage = {
+ *   http_url: 'https://ollama.com/alibayram/smollm3',
+ *   model_id: 'alibayram/smollm3',
+ * };
+ * ```
+ */
+interface ModelPage {
+  /** Absolute URL of the Ollama model page. */
+  http_url: string;
+  /**
+   * Full model path in `{profile}/{name}` form.
+   * `library/` as the profile means an officially maintained Ollama model;
+   * any other value is a community publisher's username.
+   */
+  model_id: string;
+}
+/**
+ * Response payload returned by the `GET /search` endpoint.
+ *
+ * @example
+ * ```typescript
+ * const result: SearchResult = {
+ *   pages: [{ http_url: 'https://ollama.com/library/qwen3', model_id: 'library/qwen3' }],
+ *   page_range: 1,
+ *   keyword: 'qwen3',
+ * };
+ *
+ * // Multi-page result
+ * const multi: SearchResult = {
+ *   pages: [...],
+ *   page_range: { from: 1, to: 3 },
+ *   keyword: 'qwen3',
+ * };
+ * ```
+ */
+interface SearchResult {
+  /** Model pages found on the requested search results page. */
+  pages: ModelPage[];
+  /** The page or range of pages that was requested. */
+  page_range: PageRange;
+  /** Search keyword used for the request. */
+  keyword: string;
+}
+/**
+ * Response payload returned by the `GET /model` endpoint.
+ *
+ * All tags belong to the same model page (`page_url`). The `id` is the
+ * full `{profile}/{name}` path without a tag (e.g. `library/qwen3`). To build
+ * an Ollama-compatible pull identifier, combine `id` and a tag:
+ * `${id}:${tag}`.
+ *
+ * `default_tag` is `"latest"` when that tag exists on the page, otherwise
+ * `null` — in which case the caller must pick an explicit tag from `tags`.
+ *
+ * @example
+ * ```typescript
+ * const list: ModelTags = {
+ *   page_url: 'https://ollama.com/library/qwen3',
+ *   id: 'library/qwen3',
+ *   tags: ['qwen3:latest', 'qwen3:4b', 'qwen3:8b'],
+ *   default_tag: 'qwen3:latest',
+ * };
+ *
+ * // Tags are already pull-ready — use directly:
+ * // ollama pull qwen3:latest
+ * ```
+ */
+interface ModelTags {
+  /** Absolute URL of the Ollama model page. */
+  page_url: string;
+  /**
+   * Full model path in `{profile}/{name}` form, without a tag.
+   * `library/` as the profile means an officially maintained Ollama model.
+   */
+  id: string;
+  /**
+   * Pull-ready identifiers for all available weights, e.g.
+   * `['qwen3:latest', 'qwen3:4b']`.
+   * Pass any entry directly to `ollama pull`.
+   */
+  tags: string[];
+  /**
+   * The pull-ready identifier whose tag is `latest`, e.g. `'qwen3:latest'`.
+   * `null` when the model has no `latest` tag — the caller must pick from `tags`.
+   */
+  default_tag: string | null;
+}
+/** Result of a single scraper probe returned inside {@link HealthStatus}. */
+interface CheckResult {
+  /** `true` when the probe returned at least one result without throwing. */
+  ok: boolean;
+  /** Number of results returned by the probe when the check passed. */
+  count?: number;
+  /** Stringified error message when the check failed. */
+  error?: string;
+}
+/**
+ * Response payload returned by the `GET /health` endpoint.
+ *
+ * @example
+ * ```typescript
+ * const status: HealthStatus = {
+ *   ok: true,
+ *   timestamp: '2025-01-01T00:00:00.000Z',
+ *   checks: {
+ *     search: { ok: true, count: 20 },
+ *     model: { ok: true, count: 15 },
+ *   },
+ * };
+ * ```
+ */
+interface HealthStatus {
+  /** `true` only when every individual check passed. */
+  ok: boolean;
+  /** ISO 8601 timestamp of when the health check was run. */
+  timestamp: string;
+  /** Per-scraper probe results. */
+  checks: {
+    search: CheckResult;
+    model: CheckResult;
+  };
+}
+//#endregion
+//#region src/client.d.ts
+/**
+ * HTTP client for the ollama-models Workers API.
+ *
+ * Provides a typed, promise-based interface over the `GET /search` and
+ * `GET /model` endpoints. Create one instance per application and reuse it.
+ *
+ * @example
+ * ```typescript
+ * const client = new OllamaModelsClient();
+ *
+ * // Search for models
+ * const { pages } = await client.search('qwen3');
+ * console.log(pages[0].http_url);
+ *
+ * // Get all available tags
+ * const { tags, default_tag } = await client.getModel('library/qwen3');
+ * console.log(default_tag); // 'qwen3:latest'
+ * ```
+ */
+declare class OllamaModelsClient {
+  private readonly baseUrl;
+  /**
+   * @param baseUrl - Base URL of the deployed ollama-models Workers API.
+   *   Defaults to {@link DEFAULT_BASE_URL} (the official hosted instance).
+   *   Trailing slashes are stripped automatically.
+   */
+  constructor(baseUrl?: string);
+  /**
+   * Search for models on Ollama.
+   *
+   * @param keyword - Search term. Pass an empty string to list all models.
+   * @param page - 1-based page number. Defaults to `1`.
+   * @returns A {@link SearchResult} containing matching model pages and
+   *   metadata about the requested page.
+   * @throws {Error} When the API returns a non-2xx HTTP status.
+   * @example
+   * ```typescript
+   * const { pages, page_range, keyword } = await client.search('qwen3', 1);
+   * const firstUrl = pages[0].http_url;
+   * ```
+   */
+  search(keyword?: string, page?: number): Promise<SearchResult>;
+  /**
+   * Retrieve all available tags (weights) for a model.
+   *
+   * @param name - Model identifier in `{profile}/{name}` format, e.g.:
+   *   - `"library/qwen3"` — official Ollama library model
+   *   - `"RogerBen/qwen3.5-35b-opus-distill"` — community model
+   *   - `"https://ollama.com/library/qwen3"` — full URL
+   * @returns A {@link ModelTags} with all available weights.
+   *   `default_tag` is `null` when the model has no `latest` tag.
+   * @throws {Error} When the API returns a non-2xx HTTP status.
+   * @example
+   * ```typescript
+   * const { tags, default_tag } = await client.getModel('library/qwen3');
+   * // Pull the default weight: 'qwen3:latest'
+   * ```
+   */
+  getModel(name: string): Promise<ModelTags>;
+  /**
+   * Run a live health check against both scrapers.
+   *
+   * @returns A {@link HealthStatus} with per-scraper probe results and an
+   *   aggregate `ok` flag.
+   * @throws {Error} When the API returns a non-2xx HTTP status.
+   * @example
+   * ```typescript
+   * const { ok, checks } = await client.health();
+   * if (!ok) console.error('search error:', checks.search.error);
+   * ```
+   */
+  health(): Promise<HealthStatus>;
+}
+//#endregion
+//#region src/schemas.d.ts
+/**
+ * Asserts that `data` conforms to the {@link ModelPage} shape.
+ *
+ * @param data - Unknown value to validate.
+ * @param context - Label used in error messages (defaults to `"ModelPage"`).
+ * @throws When any field is missing or has the wrong type.
+ */
+declare function assertModelPage(data: unknown, context?: string): asserts data is ModelPage;
+/**
+ * Asserts that `data` conforms to the {@link SearchResult} shape.
+ *
+ * @param data - Unknown value to validate.
+ * @throws When any field is missing or has the wrong type.
+ */
+declare function assertSearchResult(data: unknown): asserts data is SearchResult;
+/**
+ * Asserts that `data` conforms to the {@link ModelTags} shape.
+ *
+ * @param data - Unknown value to validate.
+ * @throws When any field is missing or has the wrong type.
+ */
+declare function assertModelTags(data: unknown): asserts data is ModelTags;
+/**
+ * Asserts that `data` conforms to the {@link CheckResult} shape.
+ *
+ * @param data - Unknown value to validate.
+ * @param context - Label used in error messages (defaults to `"CheckResult"`).
+ * @throws When any field is missing or has the wrong type.
+ */
+declare function assertCheckResult(data: unknown, context?: string): asserts data is CheckResult;
+/**
+ * Asserts that `data` conforms to the {@link HealthStatus} shape.
+ *
+ * @param data - Unknown value to validate.
+ * @throws When any field is missing or has the wrong type.
+ */
+declare function assertHealthStatus(data: unknown): asserts data is HealthStatus;
+//#endregion
+export { type CheckResult, type HealthStatus, type ModelPage, type ModelTags, OllamaModelsClient, type PageRange, type SearchResult, assertCheckResult, assertHealthStatus, assertModelPage, assertModelTags, assertSearchResult };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,182 @@
+import { assert } from "es-toolkit/util";
+//#region src/schemas.ts
+function isObject(val) {
+	return typeof val === "object" && val !== null && !Array.isArray(val);
+}
+/**
+* Asserts that `data` conforms to the {@link ModelPage} shape.
+*
+* @param data - Unknown value to validate.
+* @param context - Label used in error messages (defaults to `"ModelPage"`).
+* @throws When any field is missing or has the wrong type.
+*/
+function assertModelPage(data, context = "ModelPage") {
+	assert(isObject(data), `${context}: expected object`);
+	assert(typeof data["http_url"] === "string", `${context}.http_url: expected string`);
+	assert(typeof data["model_id"] === "string", `${context}.model_id: expected string`);
+}
+/**
+* Asserts that `data` conforms to the {@link SearchResult} shape.
+*
+* @param data - Unknown value to validate.
+* @throws When any field is missing or has the wrong type.
+*/
+function assertSearchResult(data) {
+	assert(isObject(data), "SearchResult: expected object");
+	assert(Array.isArray(data["pages"]), "SearchResult.pages: expected array");
+	data["pages"].forEach((p, i) => assertModelPage(p, `SearchResult.pages[${i}]`));
+	const pr = data["page_range"];
+	assert(typeof pr === "number" || isObject(pr) && typeof pr["from"] === "number" && typeof pr["to"] === "number", "SearchResult.page_range: expected number or { from: number; to: number }");
+	assert(typeof data["keyword"] === "string", "SearchResult.keyword: expected string");
+}
+/**
+* Asserts that `data` conforms to the {@link ModelTags} shape.
+*
+* @param data - Unknown value to validate.
+* @throws When any field is missing or has the wrong type.
+*/
+function assertModelTags(data) {
+	assert(isObject(data), "ModelTags: expected object");
+	assert(typeof data["page_url"] === "string", "ModelTags.page_url: expected string");
+	assert(typeof data["id"] === "string", "ModelTags.id: expected string");
+	assert(Array.isArray(data["tags"]), "ModelTags.tags: expected array");
+	data["tags"].forEach((t, i) => assert(typeof t === "string", `ModelTags.tags[${i}]: expected string`));
+	assert(data["default_tag"] === null || typeof data["default_tag"] === "string", "ModelTags.default_tag: expected string or null");
+}
+/**
+* Asserts that `data` conforms to the {@link CheckResult} shape.
+*
+* @param data - Unknown value to validate.
+* @param context - Label used in error messages (defaults to `"CheckResult"`).
+* @throws When any field is missing or has the wrong type.
+*/
+function assertCheckResult(data, context = "CheckResult") {
+	assert(isObject(data), `${context}: expected object`);
+	assert(typeof data["ok"] === "boolean", `${context}.ok: expected boolean`);
+	if ("count" in data) assert(typeof data["count"] === "number", `${context}.count: expected number`);
+	if ("error" in data) assert(typeof data["error"] === "string", `${context}.error: expected string`);
+}
+/**
+* Asserts that `data` conforms to the {@link HealthStatus} shape.
+*
+* @param data - Unknown value to validate.
+* @throws When any field is missing or has the wrong type.
+*/
+function assertHealthStatus(data) {
+	assert(isObject(data), "HealthStatus: expected object");
+	assert(typeof data["ok"] === "boolean", "HealthStatus.ok: expected boolean");
+	assert(typeof data["timestamp"] === "string", "HealthStatus.timestamp: expected string");
+	assert(isObject(data["checks"]), "HealthStatus.checks: expected object");
+	assertCheckResult(data["checks"]["search"], "HealthStatus.checks.search");
+	assertCheckResult(data["checks"]["model"], "HealthStatus.checks.model");
+}
+//#endregion
+//#region src/client.ts
+/**
+* Base URL of the officially hosted ollama-models Workers API.
+*
+* Pass a different URL to {@link OllamaModelsClient} when self-hosting.
+*/
+const DEFAULT_BASE_URL = "https://ollama.devcomfort.me/api";
+/**
+* HTTP client for the ollama-models Workers API.
+*
+* Provides a typed, promise-based interface over the `GET /search` and
+* `GET /model` endpoints. Create one instance per application and reuse it.
+*
+* @example
+* ```typescript
+* const client = new OllamaModelsClient();
+*
+* // Search for models
+* const { pages } = await client.search('qwen3');
+* console.log(pages[0].http_url);
+*
+* // Get all available tags
+* const { tags, default_tag } = await client.getModel('library/qwen3');
+* console.log(default_tag); // 'qwen3:latest'
+* ```
+*/
+var OllamaModelsClient = class {
+	baseUrl;
+	/**
+	* @param baseUrl - Base URL of the deployed ollama-models Workers API.
+	*   Defaults to {@link DEFAULT_BASE_URL} (the official hosted instance).
+	*   Trailing slashes are stripped automatically.
+	*/
+	constructor(baseUrl = DEFAULT_BASE_URL) {
+		this.baseUrl = baseUrl.replace(/\/$/, "");
+	}
+	/**
+	* Search for models on Ollama.
+	*
+	* @param keyword - Search term. Pass an empty string to list all models.
+	* @param page - 1-based page number. Defaults to `1`.
+	* @returns A {@link SearchResult} containing matching model pages and
+	*   metadata about the requested page.
+	* @throws {Error} When the API returns a non-2xx HTTP status.
+	* @example
+	* ```typescript
+	* const { pages, page_range, keyword } = await client.search('qwen3', 1);
+	* const firstUrl = pages[0].http_url;
+	* ```
+	*/
+	async search(keyword = "", page = 1) {
+		const url = new URL(`${this.baseUrl}/search`);
+		if (keyword) url.searchParams.set("q", keyword);
+		url.searchParams.set("page", String(page));
+		const res = await fetch(url.toString());
+		if (!res.ok) throw new Error(`Search failed: HTTP ${res.status}`);
+		const data = await res.json();
+		assertSearchResult(data);
+		return data;
+	}
+	/**
+	* Retrieve all available tags (weights) for a model.
+	*
+	* @param name - Model identifier in `{profile}/{name}` format, e.g.:
+	*   - `"library/qwen3"` — official Ollama library model
+	*   - `"RogerBen/qwen3.5-35b-opus-distill"` — community model
+	*   - `"https://ollama.com/library/qwen3"` — full URL
+	* @returns A {@link ModelTags} with all available weights.
+	*   `default_tag` is `null` when the model has no `latest` tag.
+	* @throws {Error} When the API returns a non-2xx HTTP status.
+	* @example
+	* ```typescript
+	* const { tags, default_tag } = await client.getModel('library/qwen3');
+	* // Pull the default weight: 'qwen3:latest'
+	* ```
+	*/
+	async getModel(name) {
+		const url = new URL(`${this.baseUrl}/model`);
+		url.searchParams.set("name", name);
+		const res = await fetch(url.toString());
+		if (!res.ok) throw new Error(`Model fetch failed: HTTP ${res.status}`);
+		const data = await res.json();
+		assertModelTags(data);
+		return data;
+	}
+	/**
+	* Run a live health check against both scrapers.
+	*
+	* @returns A {@link HealthStatus} with per-scraper probe results and an
+	*   aggregate `ok` flag.
+	* @throws {Error} When the API returns a non-2xx HTTP status.
+	* @example
+	* ```typescript
+	* const { ok, checks } = await client.health();
+	* if (!ok) console.error('search error:', checks.search.error);
+	* ```
+	*/
+	async health() {
+		const res = await fetch(`${this.baseUrl}/health`);
+		if (!res.ok) throw new Error(`Health check failed: HTTP ${res.status}`);
+		const data = await res.json();
+		assertHealthStatus(data);
+		return data;
+	}
+};
+//#endregion
+export { OllamaModelsClient, assertCheckResult, assertHealthStatus, assertModelPage, assertModelTags, assertSearchResult };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/schemas.ts","../src/client.ts"],"sourcesContent":["import { assert } from 'es-toolkit/util';\nimport type { ModelTags, ModelPage, SearchResult, CheckResult, HealthStatus } from './types';\n\n// === helpers ===\n\nfunction isObject(val: unknown): val is Record<string, unknown> {\n  return typeof val === 'object' && val !== null && !Array.isArray(val);\n}\n\n// === per-type assertions ===\n\n/**\n * Asserts that `data` conforms to the {@link ModelPage} shape.\n *\n * @param data - Unknown value to validate.\n * @param context - Label used in error messages (defaults to `\"ModelPage\"`).\n * @throws When any field is missing or has the wrong type.\n */\nexport function assertModelPage(\n  data: unknown,\n  context = 'ModelPage',\n): asserts data is ModelPage {\n  assert(isObject(data), `${context}: expected object`);\n  assert(typeof data['http_url'] === 'string', `${context}.http_url: expected string`);\n  assert(typeof data['model_id'] === 'string', `${context}.model_id: expected string`);\n}\n\n/**\n * Asserts that `data` conforms to the {@link SearchResult} shape.\n *\n * @param data - Unknown value to validate.\n * @throws When any field is missing or has the wrong type.\n */\nexport function assertSearchResult(data: unknown): asserts data is SearchResult {\n  assert(isObject(data), 'SearchResult: expected object');\n  assert(Array.isArray(data['pages']), 'SearchResult.pages: expected array');\n  (data['pages'] as unknown[]).forEach((p, i) =>\n    assertModelPage(p, `SearchResult.pages[${i}]`),\n  );\n  const pr = data['page_range'];\n  assert(\n    typeof pr === 'number' ||\n      (isObject(pr) && typeof pr['from'] === 'number' && typeof pr['to'] === 'number'),\n    'SearchResult.page_range: expected number or { from: number; to: number }',\n  );\n  assert(typeof data['keyword'] === 'string', 'SearchResult.keyword: expected string');\n}\n\n/**\n * Asserts that `data` conforms to the {@link ModelTags} shape.\n *\n * @param data - Unknown value to validate.\n * @throws When any field is missing or has the wrong type.\n */\nexport function assertModelTags(data: unknown): asserts data is ModelTags {\n  assert(isObject(data), 'ModelTags: expected object');\n  assert(typeof data['page_url'] === 'string', 'ModelTags.page_url: expected string');\n  assert(typeof data['id'] === 'string', 'ModelTags.id: expected string');\n  assert(Array.isArray(data['tags']), 'ModelTags.tags: expected array');\n  (data['tags'] as unknown[]).forEach((t, i) =>\n    assert(typeof t === 'string', `ModelTags.tags[${i}]: expected string`),\n  );\n  assert(\n    data['default_tag'] === null || typeof data['default_tag'] === 'string',\n    'ModelTags.default_tag: expected string or null',\n  );\n}\n\n/**\n * Asserts that `data` conforms to the {@link CheckResult} shape.\n *\n * @param data - Unknown value to validate.\n * @param context - Label used in error messages (defaults to `\"CheckResult\"`).\n * @throws When any field is missing or has the wrong type.\n */\nexport function assertCheckResult(\n  data: unknown,\n  context = 'CheckResult',\n): asserts data is CheckResult {\n  assert(isObject(data), `${context}: expected object`);\n  assert(typeof data['ok'] === 'boolean', `${context}.ok: expected boolean`);\n  if ('count' in data) {\n    assert(typeof data['count'] === 'number', `${context}.count: expected number`);\n  }\n  if ('error' in data) {\n    assert(typeof data['error'] === 'string', `${context}.error: expected string`);\n  }\n}\n\n/**\n * Asserts that `data` conforms to the {@link HealthStatus} shape.\n *\n * @param data - Unknown value to validate.\n * @throws When any field is missing or has the wrong type.\n */\nexport function assertHealthStatus(data: unknown): asserts data is HealthStatus {\n  assert(isObject(data), 'HealthStatus: expected object');\n  assert(typeof data['ok'] === 'boolean', 'HealthStatus.ok: expected boolean');\n  assert(typeof data['timestamp'] === 'string', 'HealthStatus.timestamp: expected string');\n  assert(isObject(data['checks']), 'HealthStatus.checks: expected object');\n  assertCheckResult(data['checks']['search'], 'HealthStatus.checks.search');\n  assertCheckResult(data['checks']['model'], 'HealthStatus.checks.model');\n}\n","import type { SearchResult, ModelTags, HealthStatus } from './types';\nimport { assertModelTags, assertSearchResult, assertHealthStatus } from './schemas';\n\n/**\n * Base URL of the officially hosted ollama-models Workers API.\n *\n * Pass a different URL to {@link OllamaModelsClient} when self-hosting.\n */\nexport const DEFAULT_BASE_URL = 'https://ollama.devcomfort.me/api';\n\n/**\n * HTTP client for the ollama-models Workers API.\n *\n * Provides a typed, promise-based interface over the `GET /search` and\n * `GET /model` endpoints. Create one instance per application and reuse it.\n *\n * @example\n * ```typescript\n * const client = new OllamaModelsClient();\n *\n * // Search for models\n * const { pages } = await client.search('qwen3');\n * console.log(pages[0].http_url);\n *\n * // Get all available tags\n * const { tags, default_tag } = await client.getModel('library/qwen3');\n * console.log(default_tag); // 'qwen3:latest'\n * ```\n */\nexport class OllamaModelsClient {\n  private readonly baseUrl: string;\n\n  /**\n   * @param baseUrl - Base URL of the deployed ollama-models Workers API.\n   *   Defaults to {@link DEFAULT_BASE_URL} (the official hosted instance).\n   *   Trailing slashes are stripped automatically.\n   */\n  constructor(baseUrl: string = DEFAULT_BASE_URL) {\n    this.baseUrl = baseUrl.replace(/\\/$/, '');\n  }\n\n  /**\n   * Search for models on Ollama.\n   *\n   * @param keyword - Search term. Pass an empty string to list all models.\n   * @param page - 1-based page number. Defaults to `1`.\n   * @returns A {@link SearchResult} containing matching model pages and\n   *   metadata about the requested page.\n   * @throws {Error} When the API returns a non-2xx HTTP status.\n   * @example\n   * ```typescript\n   * const { pages, page_range, keyword } = await client.search('qwen3', 1);\n   * const firstUrl = pages[0].http_url;\n   * ```\n   */\n  async search(keyword = '', page = 1): Promise<SearchResult> {\n    const url = new URL(`${this.baseUrl}/search`);\n    if (keyword) url.searchParams.set('q', keyword);\n    url.searchParams.set('page', String(page));\n\n    const res = await fetch(url.toString());\n    if (!res.ok) throw new Error(`Search failed: HTTP ${res.status}`);\n    const data: unknown = await res.json();\n    assertSearchResult(data);\n    return data;\n  }\n\n  /**\n   * Retrieve all available tags (weights) for a model.\n   *\n   * @param name - Model identifier in `{profile}/{name}` format, e.g.:\n   *   - `\"library/qwen3\"` — official Ollama library model\n   *   - `\"RogerBen/qwen3.5-35b-opus-distill\"` — community model\n   *   - `\"https://ollama.com/library/qwen3\"` — full URL\n   * @returns A {@link ModelTags} with all available weights.\n   *   `default_tag` is `null` when the model has no `latest` tag.\n   * @throws {Error} When the API returns a non-2xx HTTP status.\n   * @example\n   * ```typescript\n   * const { tags, default_tag } = await client.getModel('library/qwen3');\n   * // Pull the default weight: 'qwen3:latest'\n   * ```\n   */\n  async getModel(name: string): Promise<ModelTags> {\n    const url = new URL(`${this.baseUrl}/model`);\n    url.searchParams.set('name', name);\n\n    const res = await fetch(url.toString());\n    if (!res.ok) throw new Error(`Model fetch failed: HTTP ${res.status}`);\n    const data: unknown = await res.json();\n    assertModelTags(data);\n    return data;\n  }\n\n  /**\n   * Run a live health check against both scrapers.\n   *\n   * @returns A {@link HealthStatus} with per-scraper probe results and an\n   *   aggregate `ok` flag.\n   * @throws {Error} When the API returns a non-2xx HTTP status.\n   * @example\n   * ```typescript\n   * const { ok, checks } = await client.health();\n   * if (!ok) console.error('search error:', checks.search.error);\n   * ```\n   */\n  async health(): Promise<HealthStatus> {\n    const res = await fetch(`${this.baseUrl}/health`);\n    if (!res.ok) throw new Error(`Health check failed: HTTP ${res.status}`);\n    const data: unknown = await res.json();\n    assertHealthStatus(data);\n    return data;\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "ollama-models",
+  "version": "0.2.0",
+  "description": "TypeScript/JavaScript client for searching and listing Ollama model weights",
+  "keywords": [
+    "ollama",
+    "llm",
+    "models",
+    "search",
+    "registry"
+  ],
+  "license": "MIT",
+  "author": "devcomfort <im@devcomfort.me>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/devcomfort/ollama-models"
+  },
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.cts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.cts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsdown": "^0.21.10",
+    "typescript": "^5.0.0",
+    "vitest": "^4.1.9"
+  },
+  "dependencies": {
+    "es-toolkit": "^1.45.1"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}