@jackwener/opencli 1.6.1 → 1.6.3

package/dist/clis/1688/store.js

@@ -0,0 +1,226 @@
+import { CommandExecutionError, EmptyResultError } from '../../src/errors.js';
+import { cli, Strategy } from '../../src/registry.js';
+import { FACTORY_BADGE_PATTERNS, SERVICE_BADGE_PATTERNS, assertAuthenticatedState, buildDetailUrl, buildProvenance, canonicalizeSellerUrl, canonicalizeStoreUrl, cleanMultilineText, cleanText, extractAddress, extractBadges, extractMemberId, extractMetric, extractOfferId, extractShopId, extractYearsOnPlatform, gotoAndReadState, guessTopCategories, resolveStoreUrl, uniqueNonEmpty, } from './shared.js';
+function normalizeStorePayload(input) {
+    const storePayload = input.storePayload;
+    const contactPayload = input.contactPayload;
+    const seed = input.seed;
+    const contactText = cleanMultilineText(contactPayload?.bodyText);
+    const storeText = cleanMultilineText(storePayload?.bodyText);
+    const seedText = cleanMultilineText(seed?.bodyText);
+    const combinedText = [contactText, storeText, seedText].filter(Boolean).join('\n');
+    const sellerUrlRaw = cleanText(seed?.seller?.winportUrl
+        ?? seed?.seller?.sellerWinportUrlMap?.defaultUrl
+        ?? storePayload?.href
+        ?? input.resolvedUrl);
+    const storeUrl = safeCanonicalStoreUrl(sellerUrlRaw || input.resolvedUrl) ?? input.resolvedUrl;
+    const sellerUrl = canonicalizeSellerUrl(sellerUrlRaw) ?? storeUrl;
+    const companyUrl = pickCompanyUrl(contactPayload?.href, storeUrl);
+    const memberId = cleanText(seed?.seller?.memberId)
+        || input.explicitMemberId
+        || extractMemberId(input.resolvedUrl)
+        || extractMemberId(storePayload?.href ?? '')
+        || null;
+    const shopId = extractShopId(sellerUrl) ?? extractShopId(storeUrl);
+    const companyName = cleanText(seed?.seller?.companyName)
+        || firstNamedLine(contactText)
+        || firstNamedLine(storeText)
+        || null;
+    const serviceBadges = uniqueNonEmpty([
+        ...extractBadges(combinedText, SERVICE_BADGE_PATTERNS),
+        ...((seed?.services ?? []).map((service) => cleanText(service.serviceName))),
+    ]);
+    const factoryBadges = extractBadges(combinedText, FACTORY_BADGE_PATTERNS);
+    return {
+        member_id: memberId,
+        shop_id: shopId,
+        store_name: companyName,
+        store_url: storeUrl,
+        company_name: companyName,
+        company_url: companyUrl,
+        business_model_text: firstMetric(combinedText, ['经营模式', '生产加工', '主营产品']),
+        years_on_platform_text: extractYearsOnPlatform(combinedText),
+        location: extractAddress(contactText) ?? extractAddress(storeText),
+        staff_size_text: firstMetric(combinedText, ['员工人数', '员工总数']),
+        factory_badges: factoryBadges,
+        service_badges: serviceBadges,
+        response_rate_text: firstMetric(combinedText, ['响应率', '回复率', '响应速度']),
+        return_rate_text: extractReturnRate(combinedText),
+        top_categories: guessTopCategories(combinedText),
+        phone_text: extractMetric(contactText, '电话'),
+        mobile_text: extractMetric(contactText, '手机'),
+        ...buildProvenance(cleanText(contactPayload?.href) || cleanText(storePayload?.href) || input.resolvedUrl),
+    };
+}
+function safeCanonicalStoreUrl(url) {
+    try {
+        return canonicalizeStoreUrl(url);
+    }
+    catch {
+        return null;
+    }
+}
+function pickCompanyUrl(contactHref, storeUrl) {
+    const fromPage = cleanText(contactHref);
+    if (fromPage) {
+        const normalized = buildContactUrl(fromPage);
+        if (normalized)
+            return normalized;
+    }
+    return buildContactUrl(storeUrl);
+}
+function buildContactUrl(storeUrl) {
+    try {
+        const parsed = new URL(storeUrl);
+        if (!parsed.hostname.endsWith('.1688.com'))
+            return null;
+        return `${parsed.protocol}//${parsed.hostname}/page/contactinfo.html`;
+    }
+    catch {
+        return null;
+    }
+}
+function firstNamedLine(text) {
+    return text
+        .split('\n')
+        .map((line) => cleanText(line))
+        .find((line) => line.includes('有限公司') || line.includes('商行') || line.includes('工厂'))
+        ?? null;
+}
+function firstMetric(text, labels) {
+    for (const label of labels) {
+        const value = extractMetric(text, label);
+        if (value)
+            return value;
+    }
+    return null;
+}
+function extractReturnRate(text) {
+    const inline = text.match(/回头率\s*([0-9.]+%)/);
+    if (inline)
+        return cleanText(inline[0]);
+    const multiline = text.match(/回头率\s*\n\s*([0-9.]+%)/);
+    if (!multiline)
+        return null;
+    return `回头率${cleanText(multiline[1])}`;
+}
+function firstOfferId(links) {
+    for (const link of links) {
+        const offerId = extractOfferId(link);
+        if (offerId)
+            return offerId;
+    }
+    return null;
+}
+function firstContactUrl(links) {
+    for (const link of links) {
+        const url = buildContactUrl(link);
+        if (url)
+            return url;
+    }
+    return null;
+}
+async function readStorePayload(page, url, action) {
+    const state = await gotoAndReadState(page, url, 2500, action);
+    assertAuthenticatedState(state, action);
+    return await page.evaluate(`
+    (() => ({
+      href: window.location.href,
+      title: document.title || '',
+      bodyText: document.body ? document.body.innerText || '' : '',
+      offerLinks: Array.from(document.querySelectorAll('a[href*="detail.1688.com/offer/"], a[href*="offerId="]'))
+        .map((anchor) => anchor.href)
+        .filter(Boolean),
+      contactLinks: Array.from(document.querySelectorAll('a[href*="contactinfo"]'))
+        .map((anchor) => anchor.href)
+        .filter(Boolean),
+    }))()
+  `);
+}
+async function readItemSeed(page, offerId) {
+    const itemUrl = buildDetailUrl(offerId);
+    const state = await gotoAndReadState(page, itemUrl, 2500, 'store seed item');
+    assertAuthenticatedState(state, 'store seed item');
+    const seed = await page.evaluate(`
+    (() => {
+      const model = window.context?.result?.global?.globalData?.model ?? null;
+      const toJson = (value) => JSON.parse(JSON.stringify(value ?? null));
+      return {
+        href: window.location.href,
+        bodyText: document.body ? document.body.innerText || '' : '',
+        seller: toJson(model?.sellerModel),
+        services: toJson(model?.shippingServices?.fields?.buyerProtectionModel ?? []),
+      };
+    })()
+  `);
+    const hasSellerContext = !!cleanText(seed?.seller?.memberId) || !!cleanText(seed?.seller?.winportUrl);
+    if (!hasSellerContext) {
+        throw new CommandExecutionError('1688 store seed item did not expose seller context', '当前 tab 非商品详情上下文，请切到 detail.1688.com 商品页并重试');
+    }
+    return seed;
+}
+function hasAnyEvidence(storePayload, contactPayload, seed) {
+    return !!cleanText(storePayload?.bodyText)
+        || !!cleanText(contactPayload?.bodyText)
+        || !!cleanText(seed?.bodyText);
+}
+cli({
+    site: '1688',
+    name: 'store',
+    description: '1688 店铺/供应商公开信息（联系方式、主营、入驻年限、公开服务信号）',
+    domain: 'www.1688.com',
+    strategy: Strategy.COOKIE,
+    navigateBefore: false,
+    args: [
+        {
+            name: 'input',
+            required: true,
+            positional: true,
+            help: '1688 店铺 URL 或 member ID（如 b2b-22154705262941f196）',
+        },
+    ],
+    columns: ['store_name', 'years_on_platform_text', 'location', 'return_rate_text'],
+    func: async (page, kwargs) => {
+        const rawInput = String(kwargs.input ?? '');
+        const resolvedUrl = resolveStoreUrl(rawInput);
+        const explicitMemberId = extractMemberId(rawInput);
+        const storePayload = await readStorePayload(page, resolvedUrl, 'store');
+        const contactUrl = firstContactUrl(storePayload.contactLinks ?? []) || buildContactUrl(storePayload.href || resolvedUrl);
+        const contactPayload = contactUrl ? await readStorePayload(page, contactUrl, 'store contact') : null;
+        const offerId = extractOfferId(rawInput)
+            || firstOfferId(storePayload.offerLinks ?? [])
+            || firstOfferId(contactPayload?.offerLinks ?? []);
+        let seed = null;
+        if (offerId) {
+            try {
+                seed = await readItemSeed(page, offerId);
+            }
+            catch (error) {
+                if (!(error instanceof CommandExecutionError))
+                    throw error;
+            }
+        }
+        if (!hasAnyEvidence(storePayload, contactPayload, seed)) {
+            throw new EmptyResultError('1688 store', 'Store page is reachable but no visible fields were extracted. Open the store page in Chrome and retry.');
+        }
+        return [
+            normalizeStorePayload({
+                resolvedUrl,
+                storePayload,
+                contactPayload,
+                seed,
+                explicitMemberId,
+            }),
+        ];
+    },
+});
+export const __test__ = {
+    normalizeStorePayload,
+    safeCanonicalStoreUrl,
+    buildContactUrl,
+    firstNamedLine,
+    firstMetric,
+    extractReturnRate,
+    firstOfferId,
+    firstContactUrl,
+};

package/dist/clis/1688/store.test.js

@@ -0,0 +1,62 @@
+import { describe, expect, it } from 'vitest';
+import { __test__ } from './store.js';
+describe('1688 store normalization', () => {
+    it('merges store contact text with seller seed data', () => {
+        const result = __test__.normalizeStorePayload({
+            resolvedUrl: 'https://yinuoweierfushi.1688.com/?offerId=887904326744',
+            explicitMemberId: null,
+            storePayload: {
+                href: 'https://yinuoweierfushi.1688.com/page/index.html',
+                bodyText: `
+          青岛沁澜衣品服装有限公司
+          联系方式
+          地址：山东省青岛市即墨区环秀街道办事处湘江二路97号甲
+        `,
+                offerLinks: ['https://detail.1688.com/offer/887904326744.html'],
+            },
+            contactPayload: {
+                href: 'https://yinuoweierfushi.1688.com/page/contactinfo.html',
+                bodyText: `
+          青岛沁澜衣品服装有限公司
+          电话：86 0532 86655366
+          手机：15963238678
+          地址：山东省青岛市即墨区环秀街道办事处湘江二路97号甲
+        `,
+            },
+            seed: {
+                bodyText: `
+          入驻13年
+          主营：大码女装
+          店铺回头率
+          87%
+          延期必赔
+          品质保障
+        `,
+                seller: {
+                    companyName: '青岛沁澜衣品服装有限公司',
+                    memberId: 'b2b-1641351767',
+                    winportUrl: 'https://yinuoweierfushi.1688.com/page/index.html?spm=abc',
+                },
+                services: [{ serviceName: '延期必赔' }, { serviceName: '品质保障' }],
+            },
+        });
+        expect(result.member_id).toBe('b2b-1641351767');
+        expect(result.store_url).toBe('https://yinuoweierfushi.1688.com');
+        expect(result.company_url).toBe('https://yinuoweierfushi.1688.com/page/contactinfo.html');
+        expect(result.years_on_platform_text).toBe('入驻13年');
+        expect(result.location).toBe('山东省青岛市即墨区环秀街道办事处湘江二路97号甲');
+        expect(result.return_rate_text).toContain('87%');
+        expect(result.top_categories).toEqual(['大码女装']);
+        expect(result.service_badges).toEqual(['延期必赔', '品质保障']);
+    });
+    it('builds contact urls and extracts offer ids', () => {
+        expect(__test__.safeCanonicalStoreUrl('https://yinuoweierfushi.1688.com/page/index.html?spm=foo')).toBe('https://yinuoweierfushi.1688.com');
+        expect(__test__.buildContactUrl('https://yinuoweierfushi.1688.com')).toBe('https://yinuoweierfushi.1688.com/page/contactinfo.html');
+        expect(__test__.firstOfferId([
+            'https://detail.1688.com/offer/887904326744.html',
+        ])).toBe('887904326744');
+        expect(__test__.firstContactUrl([
+            'https://yinuoweierfushi.1688.com/page/contactinfo.html?spm=1',
+        ])).toBe('https://yinuoweierfushi.1688.com/page/contactinfo.html');
+    });
+});

package/dist/clis/36kr/article.js

@@ -3,8 +3,8 @@
  *
  * Fetches the full content of a 36kr article given its ID or URL.
  */
-import { cli, Strategy } from '../../registry.js';
-import { CliError } from '../../errors.js';
+import { cli, Strategy } from '../../src/registry.js';
+import { CliError } from '../../src/errors.js';
 /** Extract article ID from a full URL or a bare numeric ID string */
 function parseArticleId(input) {
     const m = input.match(/\/p\/(\d+)/);

package/dist/clis/36kr/hot.js

@@ -1,11 +1,11 @@
 /**
- * 36kr hot-list — INTERCEPT strategy.
+ * 36kr hot-list — DOM scraping.
  *
  * Navigates to the 36kr hot-list page and scrapes rendered article links.
  * Supports category types: renqi (人气), zonghe (综合), shoucang (收藏), catalog (综合热门).
  */
-import { cli, Strategy } from '../../registry.js';
-import { CliError } from '../../errors.js';
+import { cli, Strategy } from '../../src/registry.js';
+import { CliError } from '../../src/errors.js';
 const TYPE_MAP = {
     renqi: '人气榜',
     zonghe: '综合榜',
@@ -28,7 +28,8 @@ cli({
     name: 'hot',
     description: '36氪热榜 — trending articles (renqi/zonghe/shoucang/catalog)',
     domain: 'www.36kr.com',
-    strategy: Strategy.INTERCEPT,
+    strategy: Strategy.PUBLIC,
+    browser: true,
     args: [
         { name: 'limit', type: 'int', default: 20, help: 'Number of items (max 50)' },
         {
@@ -46,9 +47,14 @@ cli({
             throw new CliError('INVALID_ARGUMENT', `Unknown type "${listType}". Valid types: ${Object.keys(TYPE_MAP).join(', ')}`);
         }
         const url = buildHotListUrl(listType);
-        await page.installInterceptor('36kr.com/api');
         await page.goto(url);
-        await page.waitForCapture(6);
+        // Poll DOM until article links appear (36kr renders client-side)
+        const deadline = Date.now() + 5000;
+        while (Date.now() < deadline) {
+            if (await page.evaluate('document.querySelectorAll("a[href*=\\"/p/\\"]").length'))
+                break;
+            await new Promise(r => setTimeout(r, 300));
+        }
         // Scrape rendered article links from DOM (deduplicated)
         const domItems = await page.evaluate(`
       (() => {

package/dist/clis/36kr/news.js

@@ -1,7 +1,7 @@
 /**
  * 36kr latest news — public RSS feed, no browser needed.
  */
-import { cli, Strategy } from '../../registry.js';
+import { cli, Strategy } from '../../src/registry.js';
 cli({
     site: '36kr',
     name: 'news',

package/dist/clis/36kr/search.js

@@ -1,16 +1,17 @@
 /**
- * 36kr article search — INTERCEPT strategy.
+ * 36kr article search — DOM scraping.
  *
  * Navigates to the 36kr search results page and scrapes rendered articles.
  */
-import { cli, Strategy } from '../../registry.js';
-import { CliError } from '../../errors.js';
+import { cli, Strategy } from '../../src/registry.js';
+import { CliError } from '../../src/errors.js';
 cli({
     site: '36kr',
     name: 'search',
     description: '搜索36氪文章',
     domain: 'www.36kr.com',
-    strategy: Strategy.INTERCEPT,
+    strategy: Strategy.PUBLIC,
+    browser: true,
     args: [
         { name: 'query', positional: true, required: true, help: 'Search keyword (e.g. "AI", "OpenAI")' },
         { name: 'limit', type: 'int', default: 20, help: 'Number of results (max 50)' },
@@ -19,9 +20,14 @@ cli({
     func: async (page, args) => {
         const count = Math.min(Number(args.limit) || 20, 50);
         const query = encodeURIComponent(String(args.query ?? ''));
-        await page.installInterceptor('36kr.com/api');
         await page.goto(`https://www.36kr.com/search/articles/${query}`);
-        await page.waitForCapture(6);
+        // Poll DOM until article links appear (36kr renders client-side)
+        const deadline = Date.now() + 5000;
+        while (Date.now() < deadline) {
+            if (await page.evaluate('document.querySelectorAll("a[href*=\\"/p/\\"]").length'))
+                break;
+            await new Promise(r => setTimeout(r, 300));
+        }
         const domItems = await page.evaluate(`
       (() => {
         const seen = new Set();

package/dist/clis/_shared/desktop-commands.d.ts

@@ -3,20 +3,20 @@
  * Eliminates duplicate screenshot/status/new/dump implementations
  * across cursor, codex, chatwise, etc.
  */
-import type { CliOptions } from '../../registry.js';
+import type { CliOptions } from '../../src/registry.js';
 /**
  * Factory: capture DOM HTML + accessibility snapshot.
  */
-export declare function makeScreenshotCommand(site: string, displayName?: string, extra?: Partial<CliOptions>): import("../../registry.js").CliCommand;
+export declare function makeScreenshotCommand(site: string, displayName?: string, extra?: Partial<CliOptions>): import("../../src/registry.js").CliCommand;
 /**
  * Factory: check CDP connection status.
  */
-export declare function makeStatusCommand(site: string, displayName?: string, extra?: Partial<CliOptions>): import("../../registry.js").CliCommand;
+export declare function makeStatusCommand(site: string, displayName?: string, extra?: Partial<CliOptions>): import("../../src/registry.js").CliCommand;
 /**
  * Factory: start a new session via Cmd/Ctrl+N.
  */
-export declare function makeNewCommand(site: string, displayName?: string, extra?: Partial<CliOptions>): import("../../registry.js").CliCommand;
+export declare function makeNewCommand(site: string, displayName?: string, extra?: Partial<CliOptions>): import("../../src/registry.js").CliCommand;
 /**
  * Factory: dump DOM + snapshot for reverse-engineering.
  */
-export declare function makeDumpCommand(site: string): import("../../registry.js").CliCommand;
+export declare function makeDumpCommand(site: string): import("../../src/registry.js").CliCommand;

package/dist/clis/_shared/desktop-commands.js

@@ -4,7 +4,7 @@
  * across cursor, codex, chatwise, etc.
  */
 import * as fs from 'node:fs';
-import { cli, Strategy } from '../../registry.js';
+import { cli, Strategy } from '../../src/registry.js';
 /**
  * Factory: capture DOM HTML + accessibility snapshot.
  */

package/dist/clis/amazon/bestsellers.d.ts

@@ -1,21 +1 @@
-interface BestsellersPagePayload {
-    href?: string;
-    title?: string;
-    list_title?: string;
-    cards?: Array<{
-        rank_text?: string | null;
-        asin?: string | null;
-        title?: string | null;
-        href?: string | null;
-        price_text?: string | null;
-        rating_text?: string | null;
-        review_count_text?: string | null;
-        card_text?: string | null;
-    }>;
-    page_links?: string[];
-}
-declare function normalizeBestsellerCandidate(candidate: NonNullable<BestsellersPagePayload['cards']>[number], rank: number, listTitle: string | null, sourceUrl: string): Record<string, unknown>;
-export declare const __test__: {
-    normalizeBestsellerCandidate: typeof normalizeBestsellerCandidate;
-};
 export {};

package/dist/clis/amazon/bestsellers.js

@@ -1,130 +1,7 @@
-import { CommandExecutionError } from '../../errors.js';
-import { cli, Strategy } from '../../registry.js';
-import { buildProvenance, cleanText, extractAsin, extractReviewCountFromCardText, firstMeaningfulLine, normalizeProductUrl, parsePriceText, parseRatingValue, parseReviewCount, resolveBestsellersUrl, uniqueNonEmpty, assertUsableState, gotoAndReadState, } from './shared.js';
-function normalizeBestsellerCandidate(candidate, rank, listTitle, sourceUrl) {
-    const productUrl = normalizeProductUrl(candidate.href);
-    const asin = extractAsin(candidate.asin ?? '') ?? extractAsin(productUrl ?? '') ?? null;
-    const title = cleanText(candidate.title) || firstMeaningfulLine(candidate.card_text);
-    const price = parsePriceText(cleanText(candidate.price_text) || candidate.card_text);
-    const ratingText = cleanText(candidate.rating_text) || null;
-    const reviewCountText = cleanText(candidate.review_count_text)
-        || extractReviewCountFromCardText(candidate.card_text)
-        || null;
-    const provenance = buildProvenance(sourceUrl);
-    return {
-        rank,
-        asin,
-        title: title || null,
-        product_url: productUrl,
-        list_title: listTitle,
-        ...provenance,
-        price_text: price.price_text,
-        price_value: price.price_value,
-        currency: price.currency,
-        rating_text: ratingText,
-        rating_value: parseRatingValue(ratingText),
-        review_count_text: reviewCountText,
-        review_count: parseReviewCount(reviewCountText),
-    };
-}
-async function readBestsellersPage(page, url) {
-    const state = await gotoAndReadState(page, url, 2500, 'bestsellers');
-    assertUsableState(state, 'bestsellers');
-    return await page.evaluate(`
-    (() => ({
-      href: window.location.href,
-      title: document.title || '',
-      list_title:
-        document.querySelector('#zg_banner_text')?.textContent
-        || document.querySelector('h1')?.textContent
-        || '',
-      cards: Array.from(document.querySelectorAll('.p13n-sc-uncoverable-faceout'))
-        .map((card) => ({
-          rank_text:
-            card.querySelector('.zg-bdg-text')?.textContent
-            || card.querySelector('[class*="rank"]')?.textContent
-            || '',
-          asin: card.id || '',
-          title:
-            card.querySelector('[class*="line-clamp"]')?.textContent
-            || card.querySelector('img')?.getAttribute('alt')
-            || '',
-          href: card.querySelector('a[href*="/dp/"]')?.href || '',
-          price_text: card.querySelector('.a-price .a-offscreen')?.textContent || '',
-          rating_text: card.querySelector('[aria-label*="out of 5 stars"]')?.getAttribute('aria-label') || '',
-          review_count_text:
-            card.querySelector('a[href*="#customerReviews"]')?.textContent
-            || card.querySelector('.a-size-small')?.textContent
-            || '',
-          card_text: card.innerText || '',
-        })),
-      page_links: Array.from(document.querySelectorAll('li.a-normal a, li.a-selected a'))
-        .map((anchor) => anchor.href || '')
-        .filter((href) => /\\/zgbs\\//.test(href) && /(?:[?&]pg=|ref=zg_bs_pg_)/.test(href)),
-    }))()
-  `);
-}
-cli({
-    site: 'amazon',
-    name: 'bestsellers',
+import { cli } from '../../src/registry.js';
+import { createRankingCliOptions } from './rankings.js';
+cli(createRankingCliOptions({
+    commandName: 'bestsellers',
+    listType: 'bestsellers',
     description: 'Amazon Best Sellers pages for category candidate discovery',
-    domain: 'amazon.com',
-    strategy: Strategy.COOKIE,
-    navigateBefore: false,
-    args: [
-        {
-            name: 'input',
-            positional: true,
-            help: 'Best sellers URL or /zgbs path. Omit to use the root Best Sellers page.',
-        },
-        {
-            name: 'limit',
-            type: 'int',
-            default: 100,
-            help: 'Maximum number of ranked items to return (default 100)',
-        },
-    ],
-    columns: ['rank', 'asin', 'title', 'price_text', 'rating_value', 'review_count'],
-    func: async (page, kwargs) => {
-        const limit = Math.max(1, Number(kwargs.limit) || 100);
-        const initialUrl = resolveBestsellersUrl(typeof kwargs.input === 'string' ? kwargs.input : undefined);
-        const queue = [initialUrl];
-        const visited = new Set();
-        const seenAsins = new Set();
-        const results = [];
-        let listTitle = null;
-        while (queue.length > 0 && results.length < limit) {
-            const nextUrl = queue.shift();
-            if (visited.has(nextUrl))
-                continue;
-            visited.add(nextUrl);
-            const payload = await readBestsellersPage(page, nextUrl);
-            const sourceUrl = cleanText(payload.href) || nextUrl;
-            listTitle = cleanText(payload.list_title) || cleanText(payload.title) || listTitle;
-            const cards = payload.cards ?? [];
-            for (const card of cards) {
-                const normalized = normalizeBestsellerCandidate(card, results.length + 1, listTitle, sourceUrl);
-                const asin = cleanText(String(normalized.asin ?? ''));
-                if (!asin || seenAsins.has(asin))
-                    continue;
-                seenAsins.add(asin);
-                results.push(normalized);
-                if (results.length >= limit)
-                    break;
-            }
-            const pageLinks = uniqueNonEmpty(payload.page_links ?? []);
-            for (const href of pageLinks) {
-                if (!visited.has(href) && !queue.includes(href)) {
-                    queue.push(href);
-                }
-            }
-        }
-        if (results.length === 0) {
-            throw new CommandExecutionError('amazon bestsellers did not expose any ranked items', 'Open the same best sellers page in Chrome, verify it is a real Amazon ranking page, and retry.');
-        }
-        return results.slice(0, limit);
-    },
-});
-export const __test__ = {
-    normalizeBestsellerCandidate,
-};
+}));

package/dist/clis/amazon/bestsellers.test.js

@@ -1,8 +1,8 @@
 import { describe, expect, it } from 'vitest';
-import { __test__ } from './bestsellers.js';
+import { __test__ } from './rankings.js';
 describe('amazon bestsellers normalization', () => {
     it('normalizes bestseller cards and infers review counts from card text', () => {
-        const result = __test__.normalizeBestsellerCandidate({
+        const result = __test__.normalizeRankingCandidate({
             asin: 'B0DR31GC3D',
             title: '',
             href: 'https://www.amazon.com/NUTIKAS-Shelves-Desktop-Orgnizer-Shlef/dp/B0DR31GC3D/ref=zg_bs',
@@ -10,7 +10,16 @@ describe('amazon bestsellers normalization', () => {
             rating_text: '4.3 out of 5 stars',
             review_count_text: '',
             card_text: 'Desk Shelves Desktop Organizer Shlef\n4.3 out of 5 stars\n435\n$25.92',
-        }, 2, 'Amazon Best Sellers: Best Desktop & Off-Surface Shelves', 'https://www.amazon.com/example');
+        }, {
+            listType: 'bestsellers',
+            rankFallback: 2,
+            listTitle: 'Amazon Best Sellers: Best Desktop & Off-Surface Shelves',
+            sourceUrl: 'https://www.amazon.com/example',
+            categoryTitle: null,
+            categoryUrl: 'https://www.amazon.com/example',
+            categoryPath: [],
+            visibleCategoryLinks: [],
+        });
         expect(result.rank).toBe(2);
         expect(result.asin).toBe('B0DR31GC3D');
         expect(result.title).toBe('Desk Shelves Desktop Organizer Shlef');

package/dist/clis/amazon/discussion.js

@@ -1,5 +1,5 @@
-import { CommandExecutionError } from '../../errors.js';
-import { cli, Strategy } from '../../registry.js';
+import { CommandExecutionError } from '../../src/errors.js';
+import { cli, Strategy } from '../../src/registry.js';
 import { buildDiscussionUrl, buildProvenance, cleanText, extractAsin, normalizeProductUrl, parseRatingValue, parseReviewCount, trimRatingPrefix, uniqueNonEmpty, assertUsableState, gotoAndReadState, } from './shared.js';
 function normalizeDiscussionPayload(payload) {
     const sourceUrl = cleanText(payload.href) || buildDiscussionUrl(payload.href ?? '');

package/dist/clis/amazon/movers-shakers.js

@@ -0,0 +1,7 @@
+import { cli } from '../../src/registry.js';
+import { createRankingCliOptions } from './rankings.js';
+cli(createRankingCliOptions({
+    commandName: 'movers-shakers',
+    listType: 'movers_shakers',
+    description: 'Amazon Movers & Shakers pages for short-term growth signals',
+}));

package/dist/clis/amazon/new-releases.js

@@ -0,0 +1,7 @@
+import { cli } from '../../src/registry.js';
+import { createRankingCliOptions } from './rankings.js';
+cli(createRankingCliOptions({
+    commandName: 'new-releases',
+    listType: 'new_releases',
+    description: 'Amazon New Releases pages for early momentum discovery',
+}));

package/dist/clis/amazon/offer.js

@@ -1,5 +1,5 @@
-import { CommandExecutionError } from '../../errors.js';
-import { cli, Strategy } from '../../registry.js';
+import { CommandExecutionError } from '../../src/errors.js';
+import { cli, Strategy } from '../../src/registry.js';
 import { buildProductUrl, buildProvenance, cleanText, extractAsin, isAmazonEntity, normalizeProductUrl, PRIMARY_PRICE_SELECTORS, parsePriceText, assertUsableState, gotoAndReadState, } from './shared.js';
 const OFFER_FACT_SELECTOR = [
     '#sellerProfileTriggerId',

package/dist/clis/amazon/product.js

@@ -1,5 +1,5 @@
-import { CommandExecutionError } from '../../errors.js';
-import { cli, Strategy } from '../../registry.js';
+import { CommandExecutionError } from '../../src/errors.js';
+import { cli, Strategy } from '../../src/registry.js';
 import { buildProductUrl, buildProvenance, cleanText, extractAsin, PRIMARY_PRICE_SELECTORS, parsePriceText, parseRatingValue, parseReviewCount, normalizeProductUrl, uniqueNonEmpty, assertUsableState, gotoAndReadState, } from './shared.js';
 const PRODUCT_TITLE_SELECTOR = '#productTitle, #title span, [data-feature-name="title"] h1 span';
 const BYLINE_SELECTOR = '#bylineInfo, [data-feature-name="bylineInfo"] #bylineInfo';