@involvex/ext-cli 1.0.1

package/src/search.ts

@@ -0,0 +1,115 @@
+// src/search.ts
+
+export interface SearchResult {
+  name: string;
+  id: string;
+  store: "chrome" | "edge";
+}
+
+/**
+ * Search the Chrome Web Store for extensions matching a query.
+ */
+export async function searchChromeWebStore(query: string): Promise<SearchResult[]> {
+  const url = `https://chromewebstore.google.com/search/${encodeURIComponent(query)}`;
+
+  const response = await fetch(url, {
+    headers: {
+      "User-Agent":
+        "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
+    },
+  });
+
+  if (!response.ok) {
+    throw new Error(
+      `Chrome Web Store search failed: HTTP ${response.status} ${response.statusText}`,
+    );
+  }
+
+  const html = await response.text();
+
+  // Extract extension IDs and names from the search results
+  const regex = /detail\/([^/"']+)\/([a-z]{32})/g;
+  const results: SearchResult[] = [];
+  // eslint-disable-next-line no-constant-condition
+  while (true) {
+    const match = regex.exec(html);
+    if (!match) break;
+    const slug = match[1];
+    const id = match[2];
+
+    // Try to find a better name near this match
+    const start = Math.max(0, match.index - 500);
+    const end = Math.min(html.length, match.index + 500);
+    const snippet = html.substring(start, end);
+
+    // Look for aria-label or title with the name
+    const nameMatch = snippet.match(/aria-label="([^"]+)"/);
+    const name = nameMatch ? nameMatch[1] : slug;
+
+    // Avoid duplicates
+    if (!results.find((r) => r.id === id)) {
+      results.push({ name, id, store: "chrome" });
+    }
+  }
+
+  return results;
+}
+
+/**
+ * Search the Edge Add-ons store for extensions matching a query.
+ */
+export async function searchEdgeAddons(query: string): Promise<SearchResult[]> {
+  const url = `https://microsoftedge.microsoft.com/addons/search/${encodeURIComponent(query)}`;
+
+  const response = await fetch(url, {
+    headers: {
+      "User-Agent":
+        "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
+    },
+  });
+
+  if (!response.ok) {
+    throw new Error(`Edge Add-ons search failed: HTTP ${response.status} ${response.statusText}`);
+  }
+
+  const html = await response.text();
+
+  // Extract extension IDs and names from the search results
+  const regex = /addons\/detail\/([^/"']+)\/([a-z0-9]+)/g;
+  const results: SearchResult[] = [];
+  // eslint-disable-next-line no-constant-condition
+  while (true) {
+    const match = regex.exec(html);
+    if (!match) break;
+    const slug = match[1];
+    const id = match[2];
+
+    // Try to find a better name near this match
+    const start = Math.max(0, match.index - 500);
+    const end = Math.min(html.length, match.index + 500);
+    const snippet = html.substring(start, end);
+
+    // Look for aria-label or title with the name
+    const nameMatch = snippet.match(/aria-label="([^"]+)"/);
+    const name = nameMatch ? nameMatch[1] : slug;
+
+    // Avoid duplicates
+    if (!results.find((r) => r.id === id)) {
+      results.push({ name, id, store: "edge" });
+    }
+  }
+
+  return results;
+}
+
+/**
+ * Search both Chrome Web Store and Edge Add-ons for extensions matching a query.
+ */
+export async function searchExtensions(query: string): Promise<SearchResult[]> {
+  const [chromeResults, edgeResults] = await Promise.all([
+    searchChromeWebStore(query).catch(() => []),
+    searchEdgeAddons(query).catch(() => []),
+  ]);
+
+  return [...chromeResults, ...edgeResults];
+}

package/src/url-parser.ts

@@ -0,0 +1,33 @@
+export interface StoreInfo {
+  id: string;
+  store: "chrome" | "edge";
+}
+
+const CHROME_URL_RE = /chromewebstore\.google\.com\/(?:webstore\/)?detail\/[^/]+\/([a-z0-9]+)/i;
+const EDGE_URL_RE = /microsoftedge\.microsoft\.com\/addons\/detail\/[^/]+\/([a-z0-9]+)/i;
+const BARE_ID_RE = /^[a-z0-9]+$/i;
+
+export function parseStoreUrl(input: string): StoreInfo {
+  const trimmed = input.trim();
+
+  // Try Chrome Web Store URL
+  const chromeMatch = trimmed.match(CHROME_URL_RE);
+  if (chromeMatch) {
+    return { id: chromeMatch[1].toLowerCase(), store: "chrome" };
+  }
+
+  // Try Edge Add-ons URL
+  const edgeMatch = trimmed.match(EDGE_URL_RE);
+  if (edgeMatch) {
+    return { id: edgeMatch[1].toLowerCase(), store: "edge" };
+  }
+
+  // Try bare extension ID (32 lowercase letters)
+  if (BARE_ID_RE.test(trimmed)) {
+    return { id: trimmed.toLowerCase(), store: "chrome" };
+  }
+
+  throw new Error(
+    `Invalid extension URL or ID: "${input}". Expected a Chrome Web Store URL, Edge Add-ons URL, or a 32-character extension ID.`,
+  );
+}

package/test/crx-parser.test.ts

@@ -0,0 +1,48 @@
+// test/crx-parser.test.ts
+import { describe, expect, test } from "bun:test";
+import { extractZipFromCrx, parseCrxHeader } from "../src/crx-parser";
+
+describe("CRX Parser", () => {
+  test("parseCrxHeader reads CRX3 header", () => {
+    const header = Buffer.alloc(16);
+    header.write("Cr24", 0);
+    header.writeUInt32LE(3, 4);
+    header.writeUInt32LE(4, 8);
+    header.writeUInt32LE(0, 12);
+
+    const info = parseCrxHeader(header);
+    expect(info.version).toBe(3);
+    expect(info.headerLength).toBe(4);
+    expect(info.zipOffset).toBe(16);
+  });
+
+  test("parseCrxHeader reads CRX2 header", () => {
+    const header = Buffer.alloc(16);
+    header.write("Cr24", 0);
+    header.writeUInt32LE(2, 4);
+    header.writeUInt32LE(4, 8);
+
+    const info = parseCrxHeader(header);
+    expect(info.version).toBe(2);
+  });
+
+  test("parseCrxHeader throws on invalid magic", () => {
+    const bad = Buffer.from("NOTACRX");
+    expect(() => parseCrxHeader(bad)).toThrow("Not a CRX file");
+  });
+
+  test("extractZipFromCrx returns zip bytes after header", () => {
+    const fixed = Buffer.alloc(12);
+    fixed.write("Cr24", 0);
+    fixed.writeUInt32LE(3, 4);
+    fixed.writeUInt32LE(4, 8);
+
+    const protoHeader = Buffer.alloc(4);
+    const zipData = Buffer.from("PKZIP_DATA_HERE");
+
+    const crx = Buffer.concat([fixed, protoHeader, zipData]);
+    const zip = extractZipFromCrx(crx);
+
+    expect(zip.equals(zipData)).toBe(true);
+  });
+});

package/test/extractor.test.ts

@@ -0,0 +1,49 @@
+// test/extractor.test.ts
+import { afterEach, beforeEach, expect, test } from "bun:test";
+import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { extractCrx } from "../src/extractor";
+
+const TEST_DIR = join(import.meta.dir, "__test_extract__");
+
+beforeEach(() => {
+  mkdirSync(TEST_DIR, { recursive: true });
+});
+
+afterEach(() => {
+  rmSync(TEST_DIR, { recursive: true, force: true });
+});
+
+test("extractCrx extracts a CRX file to directory", async () => {
+  const zipPath = join(TEST_DIR, "test.zip");
+
+  const extDir = join(TEST_DIR, "ext_src");
+  mkdirSync(extDir, { recursive: true });
+  writeFileSync(join(extDir, "manifest.json"), JSON.stringify({ name: "test", version: "1.0" }));
+
+  const proc = Bun.spawn([
+    "powershell",
+    "-Command",
+    `Compress-Archive -Path '${extDir}\\*' -DestinationPath '${zipPath}' -Force`,
+  ]);
+  await proc.exited;
+
+  const zipBuf = Bun.file(zipPath);
+  const zipBytes = Buffer.from(await zipBuf.arrayBuffer());
+
+  const crxHeader = Buffer.alloc(12);
+  crxHeader.write("Cr24", 0);
+  crxHeader.writeUInt32LE(3, 4);
+  crxHeader.writeUInt32LE(4, 8);
+
+  const dummyProto = Buffer.alloc(4);
+  const crxBuffer = Buffer.concat([crxHeader, dummyProto, zipBytes]);
+
+  const crxPath = join(TEST_DIR, "test.crx");
+  writeFileSync(crxPath, crxBuffer);
+
+  const outputDir = join(TEST_DIR, "extracted");
+  const result = await extractCrx(crxPath, outputDir);
+
+  expect(existsSync(join(result, "manifest.json"))).toBe(true);
+});

package/test/packer.test.ts

@@ -0,0 +1,44 @@
+import { afterEach, beforeEach, expect, test } from "bun:test";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { packCrx } from "../src/packer";
+
+const TEST_DIR = join(import.meta.dir, "__test_pack__");
+
+beforeEach(() => {
+  mkdirSync(TEST_DIR, { recursive: true });
+});
+
+afterEach(() => {
+  rmSync(TEST_DIR, { recursive: true, force: true });
+});
+
+test("packCrx creates a CRX file from directory", async () => {
+  const extDir = join(TEST_DIR, "my-ext");
+  mkdirSync(extDir, { recursive: true });
+  writeFileSync(
+    join(extDir, "manifest.json"),
+    JSON.stringify({ manifest_version: 3, name: "Test Ext", version: "1.0" }),
+  );
+
+  const crxPath = join(TEST_DIR, "output.crx");
+  const result = await packCrx(extDir, crxPath);
+
+  expect(existsSync(result)).toBe(true);
+
+  const buf = readFileSync(result);
+  expect(buf.toString("ascii", 0, 4)).toBe("Cr24");
+  expect(buf.readUInt32LE(4)).toBe(3);
+});
+
+test("packCrx generates .pem key if none exists", async () => {
+  const extDir = join(TEST_DIR, "my-ext2");
+  mkdirSync(extDir, { recursive: true });
+  writeFileSync(
+    join(extDir, "manifest.json"),
+    JSON.stringify({ manifest_version: 3, name: "Test", version: "1.0" }),
+  );
+
+  await packCrx(extDir, join(TEST_DIR, "out.crx"));
+  expect(existsSync(join(extDir, "key.pem"))).toBe(true);
+});

package/test/url-parser.test.ts

@@ -0,0 +1,44 @@
+import { describe, expect, test } from "bun:test";
+import { parseStoreUrl } from "../src/url-parser";
+
+describe("parseStoreUrl", () => {
+  test("parses Chrome Web Store URL", () => {
+    const result = parseStoreUrl(
+      "https://chromewebstore.google.com/webstore/detail/ublock-origin/cjpalhdlnbpafiamejdnhcphjbkeiagm",
+    );
+    expect(result).toEqual({
+      id: "cjpalhdlnbpafiamejdnhcphjbkeiagm",
+      store: "chrome",
+    });
+  });
+
+  test("parses Chrome URL with query params", () => {
+    const result = parseStoreUrl(
+      "https://chromewebstore.google.com/detail/ext-name/abcdef1234567890abcdef12?hl=en",
+    );
+    expect(result).toEqual({ id: "abcdef1234567890abcdef12", store: "chrome" });
+  });
+
+  test("parses Edge Add-ons URL", () => {
+    const result = parseStoreUrl(
+      "https://microsoftedge.microsoft.com/addons/detail/ublock-origin/odfafepnkmbhccpbejgmiehpchacaeak",
+    );
+    expect(result).toEqual({
+      id: "odfafepnkmbhccpbejgmiehpchacaeak",
+      store: "edge",
+    });
+  });
+
+  test("parses bare 32-char extension ID as chrome", () => {
+    const result = parseStoreUrl("cjpalhdlnbpafiamejdnhcphjbkeiagm");
+    expect(result).toEqual({
+      id: "cjpalhdlnbpafiamejdnhcphjbkeiagm",
+      store: "chrome",
+    });
+  });
+
+  test("throws on invalid input", () => {
+    expect(() => parseStoreUrl("")).toThrow();
+    expect(() => parseStoreUrl("not-a-valid-id!")).toThrow();
+  });
+});

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "resolveJsonModule": true,
+    "types": ["bun-types"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "test"]
+}