@jackwener/opencli 1.6.1 → 1.6.2

package/dist/cli.d.ts

@@ -4,4 +4,6 @@
  * Built-in commands are registered inline here (list, validate, explore, etc.).
  * Dynamic adapter commands are registered via commanderAdapter.ts.
  */
+import { Command } from 'commander';
+export declare function createProgram(BUILTIN_CLIS: string, USER_CLIS: string): Command;
 export declare function runCli(BUILTIN_CLIS: string, USER_CLIS: string): void;

package/dist/cli.js

@@ -22,7 +22,11 @@ async function getOperatePage() {
     const bridge = new BrowserBridge();
     return bridge.connect({ timeout: 30, workspace: 'operate:default' });
 }
-export function runCli(BUILTIN_CLIS, USER_CLIS) {
+function applyVerbose(opts) {
+    if (opts.verbose)
+        process.env.OPENCLI_VERBOSE = '1';
+}
+export function createProgram(BUILTIN_CLIS, USER_CLIS) {
     const program = new Command();
     // enablePositionalOptions: prevents parent from consuming flags meant for subcommands;
     // prerequisite for passThroughOptions to forward --help/--version to external binaries
@@ -130,7 +134,9 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
         .option('--wait <s>', '', '3')
         .option('--auto', 'Enable interactive fuzzing')
         .option('--click <labels>', 'Comma-separated labels to click before fuzzing')
+        .option('-v, --verbose', 'Debug output')
         .action(async (url, opts) => {
+        applyVerbose(opts);
         const { exploreUrl, renderExploreSummary } = await import('./explore.js');
         const clickLabels = opts.click
             ? opts.click.split(',').map((s) => s.trim())
@@ -152,7 +158,9 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
         .description('Synthesize CLIs from explore')
         .argument('<target>')
         .option('--top <n>', '', '3')
+        .option('-v, --verbose', 'Debug output')
         .action(async (target, opts) => {
+        applyVerbose(opts);
         const { synthesizeFromExplore, renderSynthesizeSummary } = await import('./synthesize.js');
         console.log(renderSynthesizeSummary(synthesizeFromExplore(target, { top: parseInt(opts.top) })));
     });
@@ -162,7 +170,9 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
         .argument('<url>')
         .option('--goal <text>')
         .option('--site <name>')
+        .option('-v, --verbose', 'Debug output')
         .action(async (url, opts) => {
+        applyVerbose(opts);
         const { generateCliFromUrl, renderGenerateSummary } = await import('./generate.js');
         const workspace = `generate:${inferHost(url, opts.site)}`;
         const r = await generateCliFromUrl({
@@ -184,7 +194,9 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
         .option('--out <dir>', 'Output directory for candidates')
         .option('--poll <ms>', 'Poll interval in milliseconds', '2000')
         .option('--timeout <ms>', 'Auto-stop after N milliseconds (default: 60000)', '60000')
+        .option('-v, --verbose', 'Debug output')
         .action(async (url, opts) => {
+        applyVerbose(opts);
         const { recordSession, renderRecordSummary } = await import('./record.js');
         const result = await recordSession({
             BrowserFactory: getBrowserFactory(),
@@ -202,7 +214,9 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
         .description('Strategy cascade: find simplest working strategy')
         .argument('<url>')
         .option('--site <name>')
+        .option('-v, --verbose', 'Debug output')
         .action(async (url, opts) => {
+        applyVerbose(opts);
         const { cascadeProbe, renderCascadeResult } = await import('./cascade.js');
         const workspace = `cascade:${inferHost(url, opts.site)}`;
         const result = await browserSession(getBrowserFactory(), async (page) => {
@@ -279,7 +293,7 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
     // ── Inspect ──
     operate.command('state').description('Page state: URL, title, interactive elements with [N] indices')
         .action(operateAction(async (page) => {
-        const snapshot = await page.snapshot({ viewportExpand: 800 });
+        const snapshot = await page.snapshot({ viewportExpand: 2000 });
         const url = await page.getCurrentUrl?.() ?? '';
         console.log(`URL: ${url}\n`);
         console.log(typeof snapshot === 'string' ? snapshot : JSON.stringify(snapshot, null, 2));
@@ -338,7 +352,24 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
         await page.click(index);
         await page.wait(0.3);
         await page.typeText(index, text);
-        console.log(`Typed "${text}" into element [${index}]`);
+        // Detect autocomplete/combobox fields and wait for dropdown suggestions
+        const isAutocomplete = await page.evaluate(`
+        (() => {
+          const el = document.querySelector('[data-opencli-ref="${index}"]');
+          if (!el) return false;
+          const role = el.getAttribute('role');
+          const ac = el.getAttribute('aria-autocomplete');
+          const list = el.getAttribute('list');
+          return role === 'combobox' || ac === 'list' || ac === 'both' || !!list;
+        })()
+      `);
+        if (isAutocomplete) {
+            await page.wait(0.4);
+            console.log(`Typed "${text}" into autocomplete [${index}] — use state to see suggestions`);
+        }
+        else {
+            console.log(`Typed "${text}" into element [${index}]`);
+        }
     }));
     operate.command('select').argument('<index>', 'Element index of <select>').argument('<option>', 'Option text')
         .description('Select dropdown option')
@@ -569,20 +600,25 @@ cli({
             }
             console.log(`🔍 Verifying ${name}...\n`);
             console.log(`  Loading: ${filePath}`);
+            // Read adapter to check if it defines a 'limit' arg
+            const adapterSrc = fs.readFileSync(filePath, 'utf-8');
+            const hasLimitArg = /['"]limit['"]/.test(adapterSrc);
+            const limitFlag = hasLimitArg ? ' --limit 3' : '';
+            const verifyCmd = `node dist/main.js ${site} ${command}${limitFlag}`;
             try {
-                const output = execSync(`node dist/main.js ${site} ${command} --limit 3`, {
+                const output = execSync(verifyCmd, {
                     cwd: path.join(path.dirname(import.meta.url.replace('file://', '')), '..'),
                     timeout: 30000,
                     encoding: 'utf-8',
                     env: process.env,
                     stdio: ['pipe', 'pipe', 'pipe'],
                 });
-                console.log(`  Executing: opencli ${site} ${command} --limit 3\n`);
+                console.log(`  Executing: opencli ${site} ${command}${limitFlag}\n`);
                 console.log(output);
                 console.log(`\n  ✓ Adapter works!`);
             }
             catch (err) {
-                console.log(`  Executing: opencli ${site} ${command} --limit 3\n`);
+                console.log(`  Executing: opencli ${site} ${command}${limitFlag}\n`);
                 if (err.stdout)
                     console.log(err.stdout);
                 if (err.stderr)
@@ -608,7 +644,9 @@ cli({
         .description('Diagnose opencli browser bridge connectivity')
         .option('--no-live', 'Skip live browser connectivity test')
         .option('--sessions', 'Show active automation sessions', false)
+        .option('-v, --verbose', 'Debug output')
         .action(async (opts) => {
+        applyVerbose(opts);
         const { runBrowserDoctor, renderBrowserDoctorReport } = await import('./doctor.js');
         const report = await runBrowserDoctor({ live: opts.live, sessions: opts.sessions, cliVersion: PKG_VERSION });
         console.log(renderBrowserDoctorReport(report));
@@ -896,7 +934,10 @@ cli({
         program.outputHelp();
         process.exitCode = EXIT_CODES.USAGE_ERROR;
     });
-    program.parse();
+    return program;
+}
+export function runCli(BUILTIN_CLIS, USER_CLIS) {
+    createProgram(BUILTIN_CLIS, USER_CLIS).parse();
 }
 // ── Helpers ─────────────────────────────────────────────────────────────────
 /** Infer a workspace-friendly hostname from a URL, with site override. */

package/dist/cli.test.d.ts

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

package/dist/cli.test.js

@@ -0,0 +1,88 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { mockExploreUrl, mockRenderExploreSummary, mockGenerateCliFromUrl, mockRenderGenerateSummary, mockRecordSession, mockRenderRecordSummary, mockCascadeProbe, mockRenderCascadeResult, mockGetBrowserFactory, mockBrowserSession, } = vi.hoisted(() => ({
+    mockExploreUrl: vi.fn(),
+    mockRenderExploreSummary: vi.fn(),
+    mockGenerateCliFromUrl: vi.fn(),
+    mockRenderGenerateSummary: vi.fn(),
+    mockRecordSession: vi.fn(),
+    mockRenderRecordSummary: vi.fn(),
+    mockCascadeProbe: vi.fn(),
+    mockRenderCascadeResult: vi.fn(),
+    mockGetBrowserFactory: vi.fn(() => ({ name: 'BrowserFactory' })),
+    mockBrowserSession: vi.fn(),
+}));
+vi.mock('./explore.js', () => ({
+    exploreUrl: mockExploreUrl,
+    renderExploreSummary: mockRenderExploreSummary,
+}));
+vi.mock('./generate.js', () => ({
+    generateCliFromUrl: mockGenerateCliFromUrl,
+    renderGenerateSummary: mockRenderGenerateSummary,
+}));
+vi.mock('./record.js', () => ({
+    recordSession: mockRecordSession,
+    renderRecordSummary: mockRenderRecordSummary,
+}));
+vi.mock('./cascade.js', () => ({
+    cascadeProbe: mockCascadeProbe,
+    renderCascadeResult: mockRenderCascadeResult,
+}));
+vi.mock('./runtime.js', () => ({
+    getBrowserFactory: mockGetBrowserFactory,
+    browserSession: mockBrowserSession,
+}));
+import { createProgram } from './cli.js';
+describe('built-in browser commands verbose wiring', () => {
+    const consoleLogSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+    beforeEach(() => {
+        delete process.env.OPENCLI_VERBOSE;
+        process.exitCode = undefined;
+        mockExploreUrl.mockReset().mockResolvedValue({ ok: true });
+        mockRenderExploreSummary.mockReset().mockReturnValue('explore-summary');
+        mockGenerateCliFromUrl.mockReset().mockResolvedValue({ ok: true });
+        mockRenderGenerateSummary.mockReset().mockReturnValue('generate-summary');
+        mockRecordSession.mockReset().mockResolvedValue({ candidateCount: 1 });
+        mockRenderRecordSummary.mockReset().mockReturnValue('record-summary');
+        mockCascadeProbe.mockReset().mockResolvedValue({ ok: true });
+        mockRenderCascadeResult.mockReset().mockReturnValue('cascade-summary');
+        mockGetBrowserFactory.mockClear();
+        mockBrowserSession.mockReset().mockImplementation(async (_factory, fn) => {
+            const page = {
+                goto: vi.fn(),
+                wait: vi.fn(),
+            };
+            return fn(page);
+        });
+    });
+    it('enables OPENCLI_VERBOSE for explore via the real CLI command', async () => {
+        const program = createProgram('', '');
+        await program.parseAsync(['node', 'opencli', 'explore', 'https://example.com', '-v']);
+        expect(process.env.OPENCLI_VERBOSE).toBe('1');
+        expect(mockExploreUrl).toHaveBeenCalledWith('https://example.com', expect.objectContaining({ workspace: 'explore:example.com' }));
+    });
+    it('enables OPENCLI_VERBOSE for generate via the real CLI command', async () => {
+        const program = createProgram('', '');
+        await program.parseAsync(['node', 'opencli', 'generate', 'https://example.com', '-v']);
+        expect(process.env.OPENCLI_VERBOSE).toBe('1');
+        expect(mockGenerateCliFromUrl).toHaveBeenCalledWith(expect.objectContaining({ url: 'https://example.com', workspace: 'generate:example.com' }));
+    });
+    it('enables OPENCLI_VERBOSE for record via the real CLI command', async () => {
+        const program = createProgram('', '');
+        await program.parseAsync(['node', 'opencli', 'record', 'https://example.com', '-v']);
+        expect(process.env.OPENCLI_VERBOSE).toBe('1');
+        expect(mockRecordSession).toHaveBeenCalledWith(expect.objectContaining({ url: 'https://example.com' }));
+    });
+    it('enables OPENCLI_VERBOSE for cascade via the real CLI command', async () => {
+        const program = createProgram('', '');
+        await program.parseAsync(['node', 'opencli', 'cascade', 'https://example.com', '-v']);
+        expect(process.env.OPENCLI_VERBOSE).toBe('1');
+        expect(mockBrowserSession).toHaveBeenCalled();
+        expect(mockCascadeProbe).toHaveBeenCalledWith(expect.any(Object), 'https://example.com');
+    });
+    it('leaves OPENCLI_VERBOSE unset when verbose is omitted', async () => {
+        const program = createProgram('', '');
+        await program.parseAsync(['node', 'opencli', 'explore', 'https://example.com']);
+        expect(process.env.OPENCLI_VERBOSE).toBeUndefined();
+    });
+    consoleLogSpy.mockClear();
+});

package/dist/clis/1688/item.d.ts

@@ -0,0 +1,70 @@
+interface BuyerProtectionModel {
+    serviceName?: string;
+    shortBuyerDesc?: string;
+    packageBuyerDesc?: string;
+    textDesc?: string;
+    agreeDeliveryHours?: number;
+}
+interface ItemBrowserPayload {
+    href?: string;
+    title?: string;
+    bodyText?: string;
+    offerTitle?: string;
+    offerId?: string | number;
+    seller?: {
+        companyName?: string;
+        memberId?: string;
+        winportUrl?: string;
+        sellerWinportUrlMap?: Record<string, string>;
+    };
+    trade?: {
+        beginAmount?: string | number;
+        priceDisplay?: string;
+        unit?: string;
+        saleCount?: string | number;
+        offerIDatacenterSellInfo?: Record<string, unknown>;
+        offerPriceModel?: {
+            currentPrices?: Array<{
+                beginAmount?: string | number;
+                price?: string | number;
+            }>;
+        };
+    };
+    gallery?: {
+        mainImage?: string[];
+        offerImgList?: string[];
+        wlImageInfos?: Array<{
+            fullPathImageURI?: string;
+        }>;
+    };
+    shipping?: {
+        deliveryLimitText?: string;
+        logisticsText?: string;
+        protectionInfos?: BuyerProtectionModel[];
+        buyerProtectionModel?: BuyerProtectionModel[];
+    };
+    services?: BuyerProtectionModel[];
+}
+interface VisibleAttribute {
+    key: string;
+    value: string;
+}
+declare function normalizeItemPayload(payload: ItemBrowserPayload): Record<string, unknown>;
+declare function normalizeVisibleAttributes(raw: unknown): VisibleAttribute[];
+declare function stripAlibabaSuffix(title: string | undefined): string;
+declare function extractMoqText(bodyText: string, beginAmount: string | number | undefined, unit: string): string;
+declare function extractDeliveryDaysText(bodyText: string, services: BuyerProtectionModel[], shipping: ItemBrowserPayload['shipping']): string | null;
+declare function extractKeywordLine(bodyText: string, keywords: string[]): string | null;
+declare function extractSalesText(bodyText: string): string | null;
+declare function extractStockQuantity(bodyText: string): number | null;
+export declare const __test__: {
+    normalizeItemPayload: typeof normalizeItemPayload;
+    normalizeVisibleAttributes: typeof normalizeVisibleAttributes;
+    stripAlibabaSuffix: typeof stripAlibabaSuffix;
+    extractMoqText: typeof extractMoqText;
+    extractDeliveryDaysText: typeof extractDeliveryDaysText;
+    extractKeywordLine: typeof extractKeywordLine;
+    extractSalesText: typeof extractSalesText;
+    extractStockQuantity: typeof extractStockQuantity;
+};
+export {};

package/dist/clis/1688/item.js

@@ -0,0 +1,187 @@
+import { CommandExecutionError } from '../../errors.js';
+import { cli, Strategy } from '../../registry.js';
+import { isRecord } from '../../utils.js';
+import { assertAuthenticatedState, buildDetailUrl, buildProvenance, canonicalizeSellerUrl, cleanMultilineText, cleanText, extractLocation, extractMemberId, extractOfferId, extractShopId, gotoAndReadState, normalizePriceTiers, parseMoqText, parsePriceText, toNumber, uniqueNonEmpty, } from './shared.js';
+function normalizeItemPayload(payload) {
+    const href = cleanText(payload.href);
+    const bodyText = cleanMultilineText(payload.bodyText);
+    const sellerName = cleanText(payload.seller?.companyName);
+    const sellerUrlRaw = cleanText(payload.seller?.winportUrl
+        ?? payload.seller?.sellerWinportUrlMap?.defaultUrl
+        ?? payload.seller?.sellerWinportUrlMap?.indexUrl);
+    const sellerUrl = canonicalizeSellerUrl(sellerUrlRaw);
+    const offerId = cleanText(String(payload.offerId ?? '')) || extractOfferId(href) || null;
+    const memberId = cleanText(payload.seller?.memberId) || extractMemberId(sellerUrlRaw || href) || null;
+    const shopId = extractShopId(sellerUrl ?? href);
+    const unit = cleanText(payload.trade?.unit);
+    const priceDisplay = cleanText(payload.trade?.priceDisplay);
+    const priceRange = parsePriceText(priceDisplay ? `¥${priceDisplay}` : bodyText);
+    const moqText = extractMoqText(bodyText, payload.trade?.beginAmount, unit);
+    const moq = parseMoqText(moqText);
+    const services = uniqueServices(payload);
+    const serviceBadges = uniqueNonEmpty(services.map((service) => cleanText(service.serviceName)));
+    const attributes = normalizeVisibleAttributes(payload.trade?.offerIDatacenterSellInfo);
+    const priceTiers = normalizePriceTiers(payload.trade?.offerPriceModel?.currentPrices ?? [], unit || null);
+    const images = uniqueNonEmpty([
+        ...(payload.gallery?.mainImage ?? []),
+        ...(payload.gallery?.offerImgList ?? []),
+        ...((payload.gallery?.wlImageInfos ?? []).map((item) => item.fullPathImageURI ?? '')),
+    ]);
+    const detailUrl = offerId ? buildDetailUrl(offerId) : href;
+    const provenance = buildProvenance(href || detailUrl);
+    return {
+        offer_id: offerId,
+        member_id: memberId,
+        shop_id: shopId,
+        title: cleanText(payload.offerTitle) || stripAlibabaSuffix(payload.title) || firstNonEmptyLine(bodyText) || null,
+        item_url: detailUrl,
+        main_images: images,
+        price_text: priceRange.price_text || null,
+        price_tiers: priceTiers,
+        currency: priceRange.currency,
+        moq_text: moq.moq_text || null,
+        moq_value: moq.moq_value,
+        seller_name: sellerName || null,
+        seller_url: sellerUrl,
+        shop_name: sellerName || null,
+        origin_place: extractLocation(bodyText),
+        delivery_days_text: extractDeliveryDaysText(bodyText, services, payload.shipping),
+        customization_text: extractKeywordLine(bodyText, ['来样定制', '来图定制', '支持定制', '可定制', '定制']),
+        private_label_text: extractKeywordLine(bodyText, ['贴牌', '贴标', '定制logo', '打logo', 'OEM', 'ODM']),
+        visible_attributes: attributes,
+        sales_text: extractSalesText(bodyText),
+        service_badges: serviceBadges,
+        stock_quantity: extractStockQuantity(bodyText),
+        ...provenance,
+    };
+}
+function normalizeVisibleAttributes(raw) {
+    if (!isRecord(raw))
+        return [];
+    return Object.entries(raw)
+        .filter(([key, value]) => key !== 'sellPointModel' && cleanText(key) && cleanText(String(value)))
+        .map(([key, value]) => ({ key: cleanText(key), value: cleanText(String(value)) }));
+}
+function uniqueServices(payload) {
+    const combined = [
+        ...(Array.isArray(payload.services) ? payload.services : []),
+        ...(Array.isArray(payload.shipping?.protectionInfos) ? payload.shipping.protectionInfos : []),
+        ...(Array.isArray(payload.shipping?.buyerProtectionModel) ? payload.shipping.buyerProtectionModel : []),
+    ];
+    const seen = new Set();
+    const result = [];
+    for (const service of combined) {
+        const key = cleanText(service.serviceName);
+        if (!key || seen.has(key))
+            continue;
+        seen.add(key);
+        result.push(service);
+    }
+    return result;
+}
+function stripAlibabaSuffix(title) {
+    return cleanText(title).replace(/\s*-\s*阿里巴巴$/, '').trim();
+}
+function firstNonEmptyLine(text) {
+    return text.split('\n').map((line) => cleanText(line)).find(Boolean) ?? '';
+}
+function extractMoqText(bodyText, beginAmount, unit) {
+    const lineMatch = bodyText.match(/\d+(?:\.\d+)?\s*(件|个|套|箱|包|双|台|把|只)\s*起批/);
+    if (lineMatch)
+        return lineMatch[0];
+    const moqValue = toNumber(beginAmount);
+    if (moqValue !== null) {
+        return `${moqValue}${unit || ''}起批`;
+    }
+    return '';
+}
+function extractDeliveryDaysText(bodyText, services, shipping) {
+    const shippingText = cleanText(shipping?.deliveryLimitText) || cleanText(shipping?.logisticsText);
+    if (shippingText)
+        return shippingText;
+    const textMatch = bodyText.match(/\d+\s*(?:小时|天)(?:内)?发货/);
+    if (textMatch)
+        return textMatch[0];
+    const hourMatch = services.find((service) => typeof service.agreeDeliveryHours === 'number');
+    if (hourMatch && typeof hourMatch.agreeDeliveryHours === 'number') {
+        return `${hourMatch.agreeDeliveryHours}小时内发货`;
+    }
+    return null;
+}
+function extractKeywordLine(bodyText, keywords) {
+    const lines = bodyText.split('\n').map((line) => cleanText(line)).filter(Boolean);
+    for (const line of lines) {
+        if (keywords.some((keyword) => line.includes(keyword))) {
+            return line;
+        }
+    }
+    return null;
+}
+function extractSalesText(bodyText) {
+    const match = bodyText.match(/(?:全网销量|已售)\s*\d+(?:\.\d+)?\+?\s*[件套个单]?/);
+    return match ? cleanText(match[0]) : null;
+}
+function extractStockQuantity(bodyText) {
+    const match = bodyText.match(/库存\s*(\d+)/);
+    return match ? Number.parseInt(match[1], 10) : null;
+}
+async function readItemPayload(page, itemUrl) {
+    const state = await gotoAndReadState(page, itemUrl, 2500, 'item');
+    assertAuthenticatedState(state, 'item');
+    const payload = await page.evaluate(`
+    (() => {
+      const root = window.context ?? {};
+      const model = root.result?.global?.globalData?.model ?? null;
+      const toJson = (value) => JSON.parse(JSON.stringify(value ?? null));
+      return {
+        href: window.location.href,
+        title: document.title || '',
+        bodyText: document.body ? document.body.innerText || '' : '',
+        offerTitle: model?.offerTitleModel?.subject ?? '',
+        offerId: model?.tradeModel?.offerId ?? '',
+        seller: toJson(model?.sellerModel),
+        trade: toJson(model?.tradeModel),
+        gallery: toJson(root.result?.data?.gallery?.fields ?? null),
+        shipping: toJson(root.result?.data?.shippingServices?.fields ?? null),
+        services: toJson(root.result?.data?.shippingServices?.fields?.protectionInfos ?? []),
+      };
+    })()
+  `);
+    const resolvedOfferId = cleanText(String(payload.offerId ?? '')) || extractOfferId(cleanText(payload.href));
+    if (!resolvedOfferId) {
+        throw new CommandExecutionError('1688 item page did not expose product context', '当前 tab 非商品详情上下文，请切到 detail.1688.com 商品页并重试');
+    }
+    return payload;
+}
+cli({
+    site: '1688',
+    name: 'item',
+    description: '1688 商品详情（公开商品字段、价格阶梯、卖家基础信息）',
+    domain: 'www.1688.com',
+    strategy: Strategy.COOKIE,
+    navigateBefore: false,
+    args: [
+        {
+            name: 'input',
+            required: true,
+            positional: true,
+            help: '1688 商品 URL 或 offer ID（如 887904326744）',
+        },
+    ],
+    columns: ['offer_id', 'title', 'price_text', 'moq_text', 'seller_name', 'origin_place'],
+    func: async (page, kwargs) => {
+        const itemUrl = buildDetailUrl(String(kwargs.input ?? ''));
+        const payload = await readItemPayload(page, itemUrl);
+        return [normalizeItemPayload(payload)];
+    },
+});
+export const __test__ = {
+    normalizeItemPayload,
+    normalizeVisibleAttributes,
+    stripAlibabaSuffix,
+    extractMoqText,
+    extractDeliveryDaysText,
+    extractKeywordLine,
+    extractSalesText,
+    extractStockQuantity,
+};

package/dist/clis/1688/item.test.d.ts

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

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

@@ -0,0 +1,67 @@
+import { describe, expect, it } from 'vitest';
+import { __test__ } from './item.js';
+describe('1688 item normalization', () => {
+    it('normalizes public item payload into contract fields', () => {
+        const result = __test__.normalizeItemPayload({
+            href: 'https://detail.1688.com/offer/887904326744.html',
+            title: '法式春季长袖开衫连衣裙女新款大码女装碎花吊带裙套装142077 - 阿里巴巴',
+            bodyText: `
+        青岛沁澜衣品服装有限公司
+        入驻13年
+        主营：大码女装
+        店铺回头率
+        87%
+        山东青岛
+        3套起批
+        已售1600+套
+        支持定制logo
+      `,
+            offerTitle: '法式春季长袖开衫连衣裙女新款大码女装碎花吊带裙套装142077',
+            offerId: 887904326744,
+            seller: {
+                companyName: '青岛沁澜衣品服装有限公司',
+                memberId: 'b2b-1641351767',
+                winportUrl: 'https://yinuoweierfushi.1688.com/page/index.html?spm=a1',
+            },
+            trade: {
+                beginAmount: 3,
+                priceDisplay: '96.00-98.00',
+                unit: '套',
+                saleCount: 1655,
+                offerIDatacenterSellInfo: {
+                    面料名称: '莫代尔',
+                    主面料成分: '莫代尔纤维',
+                    sellPointModel: '{"ignore":true}',
+                },
+                offerPriceModel: {
+                    currentPrices: [
+                        { beginAmount: 3, price: '98.00' },
+                        { beginAmount: 50, price: '97.00' },
+                    ],
+                },
+            },
+            gallery: {
+                mainImage: ['https://example.com/1.jpg'],
+                offerImgList: ['https://example.com/2.jpg'],
+                wlImageInfos: [{ fullPathImageURI: 'https://example.com/3.jpg' }],
+            },
+            services: [
+                { serviceName: '延期必赔', agreeDeliveryHours: 360 },
+                { serviceName: '品质保障' },
+            ],
+        });
+        expect(result.offer_id).toBe('887904326744');
+        expect(result.member_id).toBe('b2b-1641351767');
+        expect(result.shop_id).toBe('yinuoweierfushi');
+        expect(result.seller_url).toBe('https://yinuoweierfushi.1688.com');
+        expect(result.price_text).toBe('¥96.00-98.00');
+        expect(result.moq_text).toBe('3套起批');
+        expect(result.origin_place).toBe('山东青岛');
+        expect(result.delivery_days_text).toBe('360小时内发货');
+        expect(result.private_label_text).toBe('支持定制logo');
+        expect(result.visible_attributes).toEqual([
+            { key: '面料名称', value: '莫代尔' },
+            { key: '主面料成分', value: '莫代尔纤维' },
+        ]);
+    });
+});

package/dist/clis/1688/search.d.ts

@@ -0,0 +1,56 @@
+interface SearchPayload {
+    href?: string;
+    title?: string;
+    bodyText?: string;
+    next_url?: string;
+    candidates?: Array<{
+        item_url?: string;
+        title?: string;
+        container_text?: string;
+        desc_rows?: string[];
+        price_text?: string | null;
+        sales_text?: string | null;
+        hover_price_text?: string | null;
+        moq_text?: string | null;
+        tag_items?: string[];
+        hover_items?: string[];
+        seller_name?: string | null;
+        seller_url?: string | null;
+    }>;
+}
+interface SearchRow {
+    rank: number;
+    offer_id: string | null;
+    member_id: string | null;
+    shop_id: string | null;
+    title: string | null;
+    item_url: string | null;
+    seller_name: string | null;
+    seller_url: string | null;
+    price_text: string | null;
+    price_min: number | null;
+    price_max: number | null;
+    currency: string | null;
+    moq_text: string | null;
+    moq_value: number | null;
+    location: string | null;
+    badges: string[];
+    sales_text: string | null;
+    return_rate_text: string | null;
+    source_url: string;
+    fetched_at: string;
+    strategy: string;
+}
+declare function normalizeSearchCandidate(candidate: NonNullable<SearchPayload['candidates']>[number], sourceUrl: string): SearchRow;
+declare function extractMoqText(text: string | null | undefined): string;
+declare function extractSalesText(text: string | null | undefined): string;
+declare function firstWord(text: string): string;
+declare function buildDedupeKey(row: Pick<SearchRow, 'offer_id' | 'item_url'>): string | null;
+export declare const __test__: {
+    normalizeSearchCandidate: typeof normalizeSearchCandidate;
+    extractMoqText: typeof extractMoqText;
+    extractSalesText: typeof extractSalesText;
+    firstWord: typeof firstWord;
+    buildDedupeKey: typeof buildDedupeKey;
+};
+export {};