@huyuan-ai/cli 1.0.0 → 1.0.2

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

@@ -0,0 +1,72 @@
+/**
+ * 36kr article search — INTERCEPT strategy.
+ *
+ * Navigates to the 36kr search results page and scrapes rendered articles.
+ */
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+cli({
+    site: '36kr',
+    name: 'search',
+    description: '搜索36氪文章',
+    domain: 'www.36kr.com',
+    strategy: Strategy.INTERCEPT,
+    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)' },
+    ],
+    columns: ['rank', 'title', 'date', 'url'],
+    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);
+        const domItems = await page.evaluate(`
+      (() => {
+        const seen = new Set();
+        const results = [];
+        // article-item-title contains the clickable title link
+        const titleEls = document.querySelectorAll('.article-item-title a[href*="/p/"], .article-item-title[href*="/p/"]');
+        for (const el of titleEls) {
+          const href = el.getAttribute('href') || '';
+          const title = el.textContent?.trim() || '';
+          if (!title || seen.has(href)) continue;
+          seen.add(href);
+          // Look for date near the article item
+          const item = el.closest('[class*="article-item"]') || el.parentElement;
+          const dateEl = item?.querySelector('[class*="time"], [class*="date"], time');
+          const date = dateEl?.textContent?.trim() || '';
+          results.push({
+            title,
+            url: href.startsWith('http') ? href : 'https://36kr.com' + href,
+            date,
+          });
+        }
+        // Fallback: generic /p/ links with meaningful text
+        if (results.length === 0) {
+          const links = document.querySelectorAll('a[href*="/p/"]');
+          for (const el of links) {
+            const href = el.getAttribute('href') || '';
+            const title = el.textContent?.trim() || '';
+            if (!title || title.length < 8 || seen.has(href) || seen.has(title)) continue;
+            seen.add(href);
+            seen.add(title);
+            results.push({ title, url: href.startsWith('http') ? href : 'https://36kr.com' + href, date: '' });
+          }
+        }
+        return results;
+      })()
+    `);
+        const items = Array.isArray(domItems) ? domItems : [];
+        if (items.length === 0) {
+            throw new CliError('NO_DATA', 'No results found', `Try a different query or check your keyword`);
+        }
+        return items.slice(0, count).map((item, i) => ({
+            rank: i + 1,
+            title: item.title,
+            date: item.date,
+            url: item.url,
+        }));
+    },
+});

package/vendor/opencli/dist/clis/_shared/common.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared utilities for CLI adapters.
+ */
+/**
+ * Clamp a numeric value to [min, max].
+ * Matches the signature of lodash.clamp and Rust's clamp.
+ */
+export declare function clamp(value: number, min: number, max: number): number;

package/vendor/opencli/dist/clis/_shared/common.js

@@ -0,0 +1,10 @@
+/**
+ * Shared utilities for CLI adapters.
+ */
+/**
+ * Clamp a numeric value to [min, max].
+ * Matches the signature of lodash.clamp and Rust's clamp.
+ */
+export function clamp(value, min, max) {
+    return Math.max(min, Math.min(value, max));
+}

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

@@ -0,0 +1,22 @@
+/**
+ * Shared command factories for Electron/desktop app adapters.
+ * Eliminates duplicate screenshot/status/new/dump implementations
+ * across cursor, codex, chatwise, etc.
+ */
+import type { CliOptions } from '../../registry.js';
+/**
+ * Factory: capture DOM HTML + accessibility snapshot.
+ */
+export declare function makeScreenshotCommand(site: string, displayName?: string, extra?: Partial<CliOptions>): import("../../registry.js").CliCommand;
+/**
+ * Factory: check CDP connection status.
+ */
+export declare function makeStatusCommand(site: string, displayName?: string, extra?: Partial<CliOptions>): import("../../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;
+/**
+ * Factory: dump DOM + snapshot for reverse-engineering.
+ */
+export declare function makeDumpCommand(site: string): import("../../registry.js").CliCommand;

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

@@ -0,0 +1,108 @@
+/**
+ * Shared command factories for Electron/desktop app adapters.
+ * Eliminates duplicate screenshot/status/new/dump implementations
+ * across cursor, codex, chatwise, etc.
+ */
+import * as fs from 'node:fs';
+import { cli, Strategy } from '../../registry.js';
+/**
+ * Factory: capture DOM HTML + accessibility snapshot.
+ */
+export function makeScreenshotCommand(site, displayName, extra = {}) {
+    const label = displayName ?? site;
+    return cli({
+        ...extra,
+        site,
+        name: 'screenshot',
+        description: `Capture a snapshot of the current ${label} window (DOM + Accessibility tree)`,
+        domain: 'localhost',
+        strategy: Strategy.UI,
+        browser: true,
+        args: [
+            { name: 'output', required: false, help: `Output file path (default: /tmp/${site}-snapshot.txt)` },
+        ],
+        columns: ['Status', 'File'],
+        func: async (page, kwargs) => {
+            const outputPath = kwargs.output || `/tmp/${site}-snapshot.txt`;
+            const snap = await page.snapshot({ compact: true });
+            const html = await page.evaluate('document.documentElement.outerHTML');
+            const htmlPath = outputPath.replace(/\.\w+$/, '') + '-dom.html';
+            const snapPath = outputPath.replace(/\.\w+$/, '') + '-a11y.txt';
+            fs.writeFileSync(htmlPath, html);
+            fs.writeFileSync(snapPath, typeof snap === 'string' ? snap : JSON.stringify(snap, null, 2));
+            return [
+                { Status: 'Success', File: htmlPath },
+                { Status: 'Success', File: snapPath },
+            ];
+        },
+    });
+}
+/**
+ * Factory: check CDP connection status.
+ */
+export function makeStatusCommand(site, displayName, extra = {}) {
+    const label = displayName ?? site;
+    return cli({
+        ...extra,
+        site,
+        name: 'status',
+        description: `Check active CDP connection to ${label}`,
+        domain: 'localhost',
+        strategy: Strategy.UI,
+        browser: true,
+        columns: ['Status', 'Url', 'Title'],
+        func: async (page) => {
+            const url = await page.evaluate('window.location.href');
+            const title = await page.evaluate('document.title');
+            return [{ Status: 'Connected', Url: url, Title: title }];
+        },
+    });
+}
+/**
+ * Factory: start a new session via Cmd/Ctrl+N.
+ */
+export function makeNewCommand(site, displayName, extra = {}) {
+    const label = displayName ?? site;
+    return cli({
+        ...extra,
+        site,
+        name: 'new',
+        description: `Start a new ${label} session`,
+        domain: 'localhost',
+        strategy: Strategy.UI,
+        browser: true,
+        columns: ['Status'],
+        func: async (page) => {
+            const isMac = process.platform === 'darwin';
+            await page.pressKey(isMac ? 'Meta+N' : 'Control+N');
+            await page.wait(1);
+            return [{ Status: 'Success' }];
+        },
+    });
+}
+/**
+ * Factory: dump DOM + snapshot for reverse-engineering.
+ */
+export function makeDumpCommand(site) {
+    return cli({
+        site,
+        name: 'dump',
+        description: `Dump the DOM and Accessibility tree of ${site} for reverse-engineering`,
+        domain: 'localhost',
+        strategy: Strategy.UI,
+        browser: true,
+        columns: ['action', 'files'],
+        func: async (page) => {
+            const dom = await page.evaluate('document.body.innerHTML');
+            fs.writeFileSync(`/tmp/${site}-dom.html`, dom);
+            const snap = await page.snapshot({ interactive: false });
+            fs.writeFileSync(`/tmp/${site}-snapshot.json`, JSON.stringify(snap, null, 2));
+            return [
+                {
+                    action: 'Dom extraction finished',
+                    files: `/tmp/${site}-dom.html, /tmp/${site}-snapshot.json`,
+                },
+            ];
+        },
+    });
+}

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

@@ -0,0 +1 @@
+export {};

package/vendor/opencli/dist/clis/amazon/bestsellers.js

@@ -0,0 +1,7 @@
+import { cli } from '../../registry.js';
+import { createRankingCliOptions } from './rankings.js';
+cli(createRankingCliOptions({
+    commandName: 'bestsellers',
+    listType: 'bestsellers',
+    description: 'Amazon Best Sellers pages for category candidate discovery',
+}));

package/vendor/opencli/dist/clis/amazon/bestsellers.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,29 @@
+import { describe, expect, it } from 'vitest';
+import { __test__ } from './rankings.js';
+describe('amazon bestsellers normalization', () => {
+    it('normalizes bestseller cards and infers review counts from card text', () => {
+        const result = __test__.normalizeRankingCandidate({
+            asin: 'B0DR31GC3D',
+            title: '',
+            href: 'https://www.amazon.com/NUTIKAS-Shelves-Desktop-Orgnizer-Shlef/dp/B0DR31GC3D/ref=zg_bs',
+            price_text: '$25.92',
+            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',
+        }, {
+            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');
+        expect(result.review_count).toBe(435);
+        expect(result.list_title).toBe('Amazon Best Sellers: Best Desktop & Off-Surface Shelves');
+    });
+});

package/vendor/opencli/dist/clis/amazon/discussion.d.ts

@@ -0,0 +1,20 @@
+interface DiscussionPayload {
+    href?: string;
+    title?: string;
+    average_rating_text?: string | null;
+    total_review_count_text?: string | null;
+    qa_links?: string[];
+    review_samples?: Array<{
+        title?: string | null;
+        rating_text?: string | null;
+        author?: string | null;
+        date_text?: string | null;
+        body?: string | null;
+        verified?: boolean;
+    }>;
+}
+declare function normalizeDiscussionPayload(payload: DiscussionPayload): Record<string, unknown>;
+export declare const __test__: {
+    normalizeDiscussionPayload: typeof normalizeDiscussionPayload;
+};
+export {};

package/vendor/opencli/dist/clis/amazon/discussion.js

@@ -0,0 +1,91 @@
+import { CommandExecutionError } from '../../errors.js';
+import { cli, Strategy } from '../../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 ?? '');
+    const asin = extractAsin(payload.href ?? '') ?? null;
+    const averageRatingText = cleanText(payload.average_rating_text) || null;
+    const totalReviewCountText = cleanText(payload.total_review_count_text) || null;
+    const provenance = buildProvenance(sourceUrl);
+    return {
+        asin,
+        product_url: asin ? normalizeProductUrl(asin) : null,
+        discussion_url: sourceUrl,
+        ...provenance,
+        average_rating_text: averageRatingText,
+        average_rating_value: parseRatingValue(averageRatingText),
+        total_review_count_text: totalReviewCountText,
+        total_review_count: parseReviewCount(totalReviewCountText),
+        qa_urls: uniqueNonEmpty(payload.qa_links ?? []),
+        review_samples: (payload.review_samples ?? []).map((sample) => ({
+            title: trimRatingPrefix(sample.title) || null,
+            rating_text: cleanText(sample.rating_text) || null,
+            rating_value: parseRatingValue(sample.rating_text),
+            author: cleanText(sample.author) || null,
+            date_text: cleanText(sample.date_text) || null,
+            body: cleanText(sample.body) || null,
+            verified_purchase: sample.verified === true,
+        })),
+    };
+}
+async function readDiscussionPayload(page, input, limit) {
+    const url = buildDiscussionUrl(input);
+    const state = await gotoAndReadState(page, url, 2500, 'discussion');
+    assertUsableState(state, 'discussion');
+    return await page.evaluate(`
+    (() => ({
+      href: window.location.href,
+      title: document.title || '',
+      average_rating_text: document.querySelector('[data-hook="rating-out-of-text"]')?.textContent || '',
+      total_review_count_text: document.querySelector('[data-hook="total-review-count"]')?.textContent || '',
+      qa_links: Array.from(document.querySelectorAll('a[href*="ask/questions"]')).map((anchor) => anchor.href || ''),
+      review_samples: Array.from(document.querySelectorAll('[data-hook="review"]')).slice(0, ${limit}).map((card) => ({
+        title: card.querySelector('[data-hook="review-title"]')?.textContent || '',
+        rating_text:
+          card.querySelector('[data-hook="review-star-rating"]')?.textContent
+          || card.querySelector('[data-hook="cmps-review-star-rating"]')?.textContent
+          || '',
+        author: card.querySelector('.a-profile-name')?.textContent || '',
+        date_text: card.querySelector('[data-hook="review-date"]')?.textContent || '',
+        body: card.querySelector('[data-hook="review-body"]')?.textContent || '',
+        verified: !!card.querySelector('[data-hook="avp-badge"]'),
+      })),
+    }))()
+  `);
+}
+cli({
+    site: 'amazon',
+    name: 'discussion',
+    description: 'Amazon review summary and sample customer discussion from product review pages',
+    domain: 'amazon.com',
+    strategy: Strategy.COOKIE,
+    navigateBefore: false,
+    args: [
+        {
+            name: 'input',
+            required: true,
+            positional: true,
+            help: 'ASIN or product URL, for example B0FJS72893',
+        },
+        {
+            name: 'limit',
+            type: 'int',
+            default: 10,
+            help: 'Maximum number of review samples to return (default 10)',
+        },
+    ],
+    columns: ['asin', 'average_rating_value', 'total_review_count'],
+    func: async (page, kwargs) => {
+        const input = String(kwargs.input ?? '');
+        const limit = Math.max(1, Number(kwargs.limit) || 10);
+        const payload = await readDiscussionPayload(page, input, limit);
+        const normalized = normalizeDiscussionPayload(payload);
+        if (!normalized.average_rating_text && !normalized.total_review_count_text) {
+            throw new CommandExecutionError('amazon discussion page did not expose review summary', 'The review page may have changed or hit a robot check. Open the review page in Chrome and retry.');
+        }
+        return [normalized];
+    },
+});
+export const __test__ = {
+    normalizeDiscussionPayload,
+};

package/vendor/opencli/dist/clis/amazon/discussion.test.d.ts

@@ -0,0 +1 @@
+export {};

package/vendor/opencli/dist/clis/amazon/discussion.test.js

@@ -0,0 +1,36 @@
+import { describe, expect, it } from 'vitest';
+import { __test__ } from './discussion.js';
+describe('amazon discussion normalization', () => {
+    it('normalizes review summary and sample reviews', () => {
+        const result = __test__.normalizeDiscussionPayload({
+            href: 'https://www.amazon.com/product-reviews/B0FJS72893',
+            average_rating_text: '3.9 out of 5',
+            total_review_count_text: '27 global ratings',
+            qa_links: [],
+            review_samples: [
+                {
+                    title: '5.0 out of 5 stars Great value and quality',
+                    rating_text: '5.0 out of 5 stars',
+                    author: 'GTreader2',
+                    date_text: 'Reviewed in the United States on February 21, 2026',
+                    body: 'Small but mighty.',
+                    verified: true,
+                },
+            ],
+        });
+        expect(result.asin).toBe('B0FJS72893');
+        expect(result.average_rating_value).toBe(3.9);
+        expect(result.total_review_count).toBe(27);
+        expect(result.review_samples).toEqual([
+            {
+                title: 'Great value and quality',
+                rating_text: '5.0 out of 5 stars',
+                rating_value: 5,
+                author: 'GTreader2',
+                date_text: 'Reviewed in the United States on February 21, 2026',
+                body: 'Small but mighty.',
+                verified_purchase: true,
+            },
+        ]);
+    });
+});

package/vendor/opencli/dist/clis/amazon/movers-shakers.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,7 @@
+import { cli } from '../../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/vendor/opencli/dist/clis/amazon/new-releases.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,7 @@
+import { cli } from '../../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/vendor/opencli/dist/clis/amazon/offer.d.ts

@@ -0,0 +1,23 @@
+interface OfferPayload {
+    href?: string;
+    title?: string;
+    price_text?: string | null;
+    merchant_info?: string | null;
+    sold_by?: string | null;
+    ships_from_text?: string | null;
+    offer_link?: string | null;
+    review_url?: string | null;
+    qa_url?: string | null;
+    buybox_text?: string | null;
+}
+declare function extractShipsFrom(text: string): string | null;
+declare function extractSoldBy(text: string): string | null;
+declare function isDeliveryLocationBlocked(text: string | null | undefined): boolean;
+declare function normalizeOfferPayload(payload: OfferPayload): Record<string, unknown>;
+export declare const __test__: {
+    extractShipsFrom: typeof extractShipsFrom;
+    extractSoldBy: typeof extractSoldBy;
+    isDeliveryLocationBlocked: typeof isDeliveryLocationBlocked;
+    normalizeOfferPayload: typeof normalizeOfferPayload;
+};
+export {};

package/vendor/opencli/dist/clis/amazon/offer.js

@@ -0,0 +1,140 @@
+import { CommandExecutionError } from '../../errors.js';
+import { cli, Strategy } from '../../registry.js';
+import { buildProductUrl, buildProvenance, cleanText, extractAsin, isAmazonEntity, normalizeProductUrl, PRIMARY_PRICE_SELECTORS, parsePriceText, assertUsableState, gotoAndReadState, } from './shared.js';
+const OFFER_FACT_SELECTOR = [
+    '#sellerProfileTriggerId',
+    '#shipsFromSoldByInsideBuyBox_feature_div',
+    '#fulfillerInfoFeature_feature_div',
+    '#merchantInfoFeature_feature_div',
+    '#tabular-buybox-container',
+    '#merchant-info',
+].join(', ');
+function collapseAdjacentWords(text) {
+    const parts = cleanText(text).split(' ').filter(Boolean);
+    const deduped = [];
+    for (const part of parts) {
+        if (deduped[deduped.length - 1] === part)
+            continue;
+        deduped.push(part);
+    }
+    return deduped.join(' ');
+}
+function extractShipsFrom(text) {
+    const normalized = cleanText(text);
+    const match = normalized.match(/Ships from\s+(.+?)(?=Sold by|and Fulfilled by|$)/i);
+    return match ? collapseAdjacentWords(match[1].replace(/Ships from/ig, '')) : null;
+}
+function extractSoldBy(text) {
+    const normalized = cleanText(text);
+    const match = normalized.match(/Sold by\s+(.+?)(?=and Fulfilled by|Ships from|$)/i);
+    return match ? collapseAdjacentWords(match[1]) : null;
+}
+function isDeliveryLocationBlocked(text) {
+    const normalized = cleanText(text).toLowerCase();
+    return normalized.includes('cannot be shipped to your selected delivery location')
+        || normalized.includes('similar items shipping to')
+        || normalized.includes('deliver to hong kong');
+}
+function normalizeOfferPayload(payload) {
+    const asin = extractAsin(payload.href ?? '') ?? null;
+    const sourceUrl = cleanText(payload.href) || buildProductUrl(payload.href ?? '');
+    const price = parsePriceText(payload.price_text);
+    const merchantInfo = cleanText(payload.merchant_info) || null;
+    const soldBy = cleanText(payload.sold_by)
+        || extractSoldBy(payload.ships_from_text ?? '')
+        || extractSoldBy(merchantInfo ?? '')
+        || null;
+    const shipsFrom = extractShipsFrom(payload.ships_from_text ?? '')
+        || extractShipsFrom(merchantInfo ?? '')
+        || cleanText(payload.ships_from_text)
+        || null;
+    const provenance = buildProvenance(sourceUrl);
+    return {
+        asin,
+        product_url: normalizeProductUrl(payload.href),
+        ...provenance,
+        price_text: price.price_text,
+        price_value: price.price_value,
+        currency: price.currency,
+        merchant_info_text: merchantInfo,
+        sold_by: soldBy,
+        ships_from: shipsFrom,
+        offer_listing_url: cleanText(payload.offer_link) || null,
+        review_url: cleanText(payload.review_url) || null,
+        qa_url: cleanText(payload.qa_url) || null,
+        is_amazon_sold: isAmazonEntity(soldBy),
+        is_amazon_fulfilled: isAmazonEntity(shipsFrom) || /fulfilled by amazon/i.test(merchantInfo ?? ''),
+    };
+}
+async function readOfferPayload(page, input) {
+    const url = buildProductUrl(input);
+    const state = await gotoAndReadState(page, url, 2500, 'offer');
+    assertUsableState(state, 'offer');
+    // Reconnecting to an existing Amazon target can surface the product page
+    // before the buy-box / merchant blocks are reattached to the DOM.
+    await page.wait({ selector: OFFER_FACT_SELECTOR, timeout: 6 }).catch(() => { });
+    return await page.evaluate(`
+    (() => ({
+      href: window.location.href,
+      title: document.title || '',
+      price_text: (() => {
+        const selectors = ${JSON.stringify(PRIMARY_PRICE_SELECTORS)};
+        for (const selector of selectors) {
+          const text = document.querySelector(selector)?.textContent || '';
+          if (text.trim()) return text;
+        }
+        return '';
+      })(),
+      merchant_info: document.querySelector('#merchant-info')?.textContent || '',
+      sold_by: document.querySelector('#sellerProfileTriggerId')?.textContent || '',
+      ships_from_text:
+        document.querySelector('#shipsFromSoldByInsideBuyBox_feature_div')?.textContent
+        || document.querySelector('#fulfillerInfoFeature_feature_div')?.textContent
+        || document.querySelector('#merchantInfoFeature_feature_div')?.textContent
+        || document.querySelector('#tabular-buybox-container')?.textContent
+        || '',
+      offer_link: document.querySelector('a[href*="/gp/offer-listing/"]')?.href || '',
+      review_url: document.querySelector('a[href*="#customerReviews"]')?.href || '',
+      qa_url: document.querySelector('a[href*="ask/questions"]')?.href || '',
+      buybox_text:
+        document.querySelector('#desktop_qualifiedBuyBox')?.textContent
+        || document.querySelector('#buybox')?.textContent
+        || '',
+    }))()
+  `);
+}
+cli({
+    site: 'amazon',
+    name: 'offer',
+    description: 'Amazon seller, buy box, and fulfillment facts from the product page',
+    domain: 'amazon.com',
+    strategy: Strategy.COOKIE,
+    navigateBefore: false,
+    args: [
+        {
+            name: 'input',
+            required: true,
+            positional: true,
+            help: 'ASIN or product URL, for example B0FJS72893',
+        },
+    ],
+    columns: ['asin', 'price_text', 'sold_by', 'ships_from', 'is_amazon_sold', 'is_amazon_fulfilled'],
+    func: async (page, kwargs) => {
+        const input = String(kwargs.input ?? '');
+        const payload = await readOfferPayload(page, input);
+        const normalized = normalizeOfferPayload(payload);
+        if (!normalized.sold_by && !normalized.ships_from && !normalized.merchant_info_text) {
+            if (isDeliveryLocationBlocked(payload.buybox_text)) {
+                throw new CommandExecutionError('amazon offer buy box is blocked by the current delivery location', 'The shared Chrome profile is not set to the target US delivery address. Switch Amazon delivery location to the requested US destination, reopen the product page, and retry.');
+            }
+            throw new CommandExecutionError('amazon offer surface did not expose seller or fulfillment facts', 'The product page may have changed. Open the product page in Chrome, make sure the buy box is visible, and retry.');
+        }
+        return [normalized];
+    },
+});
+export const __test__ = {
+    extractShipsFrom,
+    extractSoldBy,
+    isDeliveryLocationBlocked,
+    normalizeOfferPayload,
+};

package/vendor/opencli/dist/clis/amazon/offer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/vendor/opencli/dist/clis/amazon/offer.test.js

@@ -0,0 +1,29 @@
+import { describe, expect, it } from 'vitest';
+import { __test__ } from './offer.js';
+describe('amazon offer normalization', () => {
+    it('extracts sold-by and fulfillment facts from product offer text', () => {
+        const result = __test__.normalizeOfferPayload({
+            href: 'https://www.amazon.com/dp/B0FJS72893',
+            price_text: '$15.99',
+            merchant_info: '',
+            sold_by: 'KUATUDIRECT',
+            ships_from_text: 'Ships from Amazon',
+            offer_link: null,
+            review_url: 'https://www.amazon.com/dp/B0FJS72893#customerReviews',
+            qa_url: null,
+        });
+        expect(result.asin).toBe('B0FJS72893');
+        expect(result.sold_by).toBe('KUATUDIRECT');
+        expect(result.ships_from).toBe('Amazon');
+        expect(result.is_amazon_sold).toBe(false);
+        expect(result.is_amazon_fulfilled).toBe(true);
+    });
+    it('parses merchant info fallback text', () => {
+        expect(__test__.extractSoldBy('Sold by Example Seller and Fulfilled by Amazon.')).toBe('Example Seller');
+        expect(__test__.extractShipsFrom('Ships from Amazon')).toBe('Amazon');
+    });
+    it('detects delivery-location blocking in the buy box text', () => {
+        expect(__test__.isDeliveryLocationBlocked('This item cannot be shipped to your selected delivery location. Similar items shipping to Hong Kong')).toBe(true);
+        expect(__test__.isDeliveryLocationBlocked('Ships from Amazon')).toBe(false);
+    });
+});