@zenalexa/unicli 0.219.0 → 0.220.1

package/src/adapters/dockerhub/registry.ts

@@ -0,0 +1,223 @@
+/**
+ * @owner   src/adapters/dockerhub/registry.ts
+ * @does    Register agent-facing Docker Hub search and image metadata commands.
+ * @needs   Public Docker Hub API, TypeScript adapter loader, bounded argument parsing.
+ * @feeds   surface coverage ledger, container registry command surface, agent-readable image rows.
+ * @breaks  Docker Hub API envelope drift, weak image parsing, or silent empty results hide registry lookup failures.
+ */
+
+import { cli, Strategy } from "../../registry.js";
+
+const HUB_BASE = "https://hub.docker.com/v2";
+
+interface DockerHubSearchItem {
+  repo_owner?: unknown;
+  repo_name?: unknown;
+  is_official?: unknown;
+  star_count?: unknown;
+  pull_count?: unknown;
+  short_description?: unknown;
+}
+
+interface DockerHubImageBody {
+  namespace?: unknown;
+  name?: unknown;
+  star_count?: unknown;
+  pull_count?: unknown;
+  description?: unknown;
+  last_updated?: unknown;
+  last_modified?: unknown;
+  date_registered?: unknown;
+  status_description?: unknown;
+}
+
+function stringField(value: unknown): string {
+  return typeof value === "string" ? value : "";
+}
+
+function numberField(value: unknown): number | null {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+
+export function requireDockerHubString(value: unknown, name: string): string {
+  const text = String(value ?? "").trim();
+  if (!text) throw new Error(`${name} is required.`);
+  return text;
+}
+
+export function requireDockerHubLimit(
+  value: unknown,
+  fallback: number,
+): number {
+  if (value === undefined || value === null || value === "") return fallback;
+  const n = Number(value);
+  if (!Number.isInteger(n) || n < 1 || n > 100) {
+    throw new Error(
+      `limit must be an integer in [1, 100]. Got: ${String(value)}`,
+    );
+  }
+  return n;
+}
+
+export function parseDockerHubImage(value: unknown): {
+  owner: string;
+  name: string;
+} {
+  const raw = requireDockerHubString(value, "image");
+  const parts = raw.split("/").filter(Boolean);
+  if (parts.length === 1) return { owner: "library", name: parts[0] };
+  if (parts.length === 2) return { owner: parts[0], name: parts[1] };
+  throw new Error(
+    "image must be a Docker Hub image name like nginx or bitnami/redis.",
+  );
+}
+
+function trimDate(value: unknown): string | null {
+  const text = stringField(value).trim();
+  if (!text) return null;
+  const noFraction = text.replace(/\.\d+/, "");
+  return noFraction.endsWith("Z") ? noFraction : `${noFraction}Z`;
+}
+
+async function fetchDockerHubJson(url: string): Promise<unknown> {
+  const response = await fetch(url, {
+    headers: { Accept: "application/json" },
+  });
+  if (!response.ok) {
+    throw new Error(`Docker Hub request failed: HTTP ${response.status}`);
+  }
+  return response.json();
+}
+
+export function mapDockerHubSearchRows(
+  items: DockerHubSearchItem[],
+  limit: number,
+): Array<Record<string, unknown>> {
+  return items.slice(0, limit).map((item, index) => {
+    const owner = stringField(item.repo_owner).trim();
+    const name = stringField(item.repo_name).trim();
+    const official = Boolean(item.is_official);
+    const image = owner
+      ? `${owner}/${name}`
+      : official
+        ? `library/${name}`
+        : name;
+    return {
+      rank: index + 1,
+      image,
+      official,
+      stars: numberField(item.star_count),
+      pulls: numberField(item.pull_count),
+      description: stringField(item.short_description).trim(),
+      url: image ? `https://hub.docker.com/r/${image}` : "",
+    };
+  });
+}
+
+export function mapDockerHubImageRow(
+  body: DockerHubImageBody,
+  fallbackOwner: string,
+  fallbackName: string,
+): Record<string, unknown> {
+  const namespace = stringField(body.namespace).trim() || fallbackOwner;
+  const name = stringField(body.name).trim() || fallbackName;
+  if (!name) throw new Error("Docker Hub returned no image metadata.");
+  const official = namespace === "library" || namespace === "_";
+  const image = official ? `library/${name}` : `${namespace}/${name}`;
+  return {
+    image,
+    official,
+    stars: numberField(body.star_count),
+    pulls: numberField(body.pull_count),
+    description: stringField(body.description).trim(),
+    lastUpdated: trimDate(body.last_updated),
+    lastModified: trimDate(body.last_modified),
+    registered: trimDate(body.date_registered),
+    status: stringField(body.status_description).trim(),
+    url: `https://hub.docker.com/r/${image}`,
+  };
+}
+
+cli({
+  site: "dockerhub",
+  name: "search",
+  description: "Search Docker Hub repositories by keyword",
+  domain: "hub.docker.com",
+  strategy: Strategy.PUBLIC,
+  args: [
+    {
+      name: "query",
+      type: "str",
+      required: true,
+      positional: true,
+      description: "Search keyword",
+    },
+    {
+      name: "limit",
+      type: "int",
+      default: 25,
+      description: "Max repositories",
+    },
+  ],
+  columns: [
+    "rank",
+    "image",
+    "official",
+    "stars",
+    "pulls",
+    "description",
+    "url",
+  ],
+  func: async (_page, kwargs) => {
+    const query = requireDockerHubString(kwargs.query, "query");
+    const limit = requireDockerHubLimit(kwargs.limit, 25);
+    const url = `${HUB_BASE}/search/repositories/?query=${encodeURIComponent(query)}&page_size=${limit}`;
+    const body = (await fetchDockerHubJson(url)) as {
+      results?: DockerHubSearchItem[];
+    };
+    const rows = mapDockerHubSearchRows(
+      Array.isArray(body.results) ? body.results : [],
+      limit,
+    );
+    if (rows.length === 0) {
+      throw new Error(`No Docker Hub repositories matched "${query}".`);
+    }
+    return rows;
+  },
+});
+
+cli({
+  site: "dockerhub",
+  name: "image",
+  description: "Fetch a Docker Hub repository's public metadata",
+  domain: "hub.docker.com",
+  strategy: Strategy.PUBLIC,
+  args: [
+    {
+      name: "image",
+      type: "str",
+      required: true,
+      positional: true,
+      description: "Image name, e.g. nginx or bitnami/redis",
+    },
+  ],
+  columns: [
+    "image",
+    "official",
+    "stars",
+    "pulls",
+    "description",
+    "lastUpdated",
+    "lastModified",
+    "registered",
+    "status",
+    "url",
+  ],
+  func: async (_page, kwargs) => {
+    const { owner, name } = parseDockerHubImage(kwargs.image);
+    const body = (await fetchDockerHubJson(
+      `${HUB_BASE}/repositories/${encodeURIComponent(owner)}/${encodeURIComponent(name)}/`,
+    )) as DockerHubImageBody;
+    return [mapDockerHubImageRow(body, owner, name)];
+  },
+});

package/src/adapters/ehentai/web.test.ts

@@ -0,0 +1,157 @@
+import { describe, expect, it } from "vitest";
+import { resolveCommand } from "../../registry.js";
+import {
+  buildEhentaiSearchQuery,
+  decodeEhentaiHtml,
+  ehentaiCategoryMask,
+  ehentaiSearchUrl,
+  mapEhentaiTorrents,
+  parseEhentaiGallery,
+  parseEhentaiGalleryPages,
+  parseEhentaiSearchHtml,
+  requireEhentaiLimit,
+} from "./web.js";
+
+describe("ehentai public gallery commands", () => {
+  it("registers search, tag, artist, gallery, pages, and torrents", () => {
+    expect(
+      Object.keys(resolveCommand("ehentai", "search")!.adapter.commands),
+    ).toEqual(
+      expect.arrayContaining([
+        "search",
+        "tag",
+        "artist",
+        "gallery",
+        "pages",
+        "torrents",
+      ]),
+    );
+  });
+
+  it("builds accurate structured search URLs for category and tag filters", () => {
+    expect(ehentaiCategoryMask("artistcg")).toBe(1015);
+    expect(ehentaiCategoryMask("cg")).toBe(999);
+    expect(ehentaiCategoryMask("manga,doujinshi")).toBe(1017);
+    expect(
+      buildEhentaiSearchQuery({
+        artist: "Tony Taka",
+        language: "chinese",
+        other: "full color",
+      }),
+    ).toBe("artist:tony_taka$ language:chinese$ other:full_color$");
+    expect(
+      buildEhentaiSearchQuery({
+        tags: "artist:Tony Taka,language:chinese",
+        exact_tags: false,
+      }),
+    ).toBe("artist:tony_taka language:chinese");
+    expect(() => buildEhentaiSearchQuery({ tags: "tony taka" })).toThrow(
+      "namespaced",
+    );
+    expect(
+      ehentaiSearchUrl({
+        query: "artist:tony_taka$",
+        page: 0,
+        cursor: "",
+        categoryMask: 1015,
+        requireTorrent: true,
+        includeExpunged: false,
+        minPages: "",
+        maxPages: "",
+        minRating: "",
+      }),
+    ).toBe(
+      "https://e-hentai.org/?f_search=artist%3Atony_taka%24&f_cats=1015&advsearch=1&f_sto=on",
+    );
+  });
+
+  it("validates gallery identity and limits", () => {
+    expect(parseEhentaiGallery("3316027/8c4fbe8822")).toEqual({
+      gid: 3316027,
+      token: "8c4fbe8822",
+      url: "https://e-hentai.org/g/3316027/8c4fbe8822/",
+    });
+    expect(
+      parseEhentaiGallery("https://e-hentai.org/g/3316027/8c4fbe8822/"),
+    ).toEqual({
+      gid: 3316027,
+      token: "8c4fbe8822",
+      url: "https://e-hentai.org/g/3316027/8c4fbe8822/",
+    });
+    expect(() =>
+      parseEhentaiGallery("https://example.com/g/1/abcdef1234/"),
+    ).toThrow("e-hentai.org");
+    expect(requireEhentaiLimit(undefined)).toBe(20);
+    expect(() => requireEhentaiLimit(101)).toThrow("integer");
+    expect(decodeEhentaiHtml("A & B ' C")).toBe("A & B ' C");
+  });
+
+  it("parses search rows from compact gallery table markup", () => {
+    const rows = parseEhentaiSearchHtml(
+      `<table><tr><td class="gl1c glcat"><div class="cn ct9">Non-H</div></td>
+        <td class="gl2c"><div><div id="posted_3316027">2025-04-15 08:13</div>
+        <div>8 pages</div><a href="https://e-hentai.org/gallerytorrents.php?gid=3316027&amp;t=8c4fbe8822">T</a></div>
+        <img alt="thumb" data-src="https://ehgt.org/thumb.webp" /></td>
+        <td class="gl3c glname"><a href="https://e-hentai.org/g/3316027/8c4fbe8822/">
+        <div class="glink">Copyright free landscape</div><div><div class="gt" title="language:english">english</div></div></a></td>
+        <td class="gl4c glhide"><div><a>7qweij</a></div><div>8 pages</div></td></tr></table>`,
+      10,
+    );
+    expect(rows).toEqual([
+      {
+        rank: 1,
+        gid: 3316027,
+        token: "8c4fbe8822",
+        title: "Copyright free landscape",
+        category: "Non-H",
+        published: "2025-04-15 08:13",
+        pages: "8 pages",
+        uploader: "7qweij",
+        thumb: "https://ehgt.org/thumb.webp",
+        torrent_available: true,
+        tags: "language:english",
+        url: "https://e-hentai.org/g/3316027/8c4fbe8822/",
+      },
+    ]);
+  });
+
+  it("maps torrent metadata and gallery pages", () => {
+    expect(
+      mapEhentaiTorrents({
+        gid: 3316027,
+        title: "Gallery",
+        torrents: [
+          { hash: "abc", added: "1", name: "g.zip", tsize: "2", fsize: "3" },
+        ],
+      }),
+    ).toEqual([
+      {
+        rank: 1,
+        gid: 3316027,
+        title: "Gallery",
+        hash: "abc",
+        added: "1",
+        name: "g.zip",
+        tsize: "2",
+        fsize: "3",
+      },
+    ]);
+    expect(
+      parseEhentaiGalleryPages(
+        `<h1 id="gn">Gallery</h1><div id="gdt"><a href="https://e-hentai.org/s/f7ee85eea1/3316027-1"><div title="Page 1: 123.png" style="background:transparent url(https://thumb.webp) -0px 0 no-repeat"></div></a></div>`,
+        parseEhentaiGallery("3316027/8c4fbe8822"),
+        5,
+      ),
+    ).toEqual([
+      {
+        page: 1,
+        gid: 3316027,
+        title: "Gallery",
+        filename: "123.png",
+        page_url: "https://e-hentai.org/s/f7ee85eea1/3316027-1",
+        thumb_sprite_url: "https://thumb.webp",
+        gallery_url: "https://e-hentai.org/g/3316027/8c4fbe8822/",
+      },
+    ]);
+  });
+});