cbs-4px-merchant-cli 0.0.7 → 0.0.8

package/dist/types/index.d.ts

@@ -760,3 +760,297 @@ export interface NotifyTypeItem {
 export interface NotifyTypeListResp {
     list: NotifyTypeItem[];
 }
+export interface SellerAccountItem {
+    id: string | null;
+    accountType: string | null;
+    accountName: string | null;
+    merchantId: string | null;
+    amazonMarketplaceId: string | null;
+    site: string | null;
+    status: string | null;
+}
+export interface SellerAccountListResp {
+    pageNum: number;
+    pageSize: number;
+    total: number;
+    list: SellerAccountItem[];
+}
+export interface PlatformOrderSyncResp {
+    success: boolean | null;
+    message: string | null;
+}
+export interface SyncOrderRecordItem {
+    id: string | null;
+    sellerAccount: string | null;
+    syncStartTime: string | null;
+    syncEndTime: string | null;
+    status: string | null;
+    totalQuantity: number | null;
+    actualSaveQuantity: number | null;
+    message: string | null;
+}
+export interface SyncOrderRecordListResp {
+    pageNum: number;
+    pageSize: number;
+    total: number;
+    list: SyncOrderRecordItem[];
+}
+export interface PlatformOrderItem {
+    id: string | null;
+    platformOrderNo: string | null;
+    customerOrderNo: string | null;
+    sellerAccount: string | null;
+    receiverName: string | null;
+    receiverCountryName: string | null;
+    productName: string | null;
+    totalPrice: string | null;
+    currency: string | null;
+    createdTime: string | null;
+    pushTime: string | null;
+}
+export interface PlatformOrderListResp {
+    pageNum: number;
+    pageSize: number;
+    total: number;
+    list: PlatformOrderItem[];
+}
+export interface PlatformOrderItemDetail {
+    itemTitle: string | null;
+    sku: string | null;
+    quantity: number | null;
+    price: string | null;
+    weight: string | null;
+    currency: string | null;
+    hsCode: string | null;
+}
+export interface PlatformOrderDetailResp {
+    id: string | null;
+    platformOrderNo: string | null;
+    customerOrderNo: string | null;
+    platform: string | null;
+    sellerAccountName: string | null;
+    exportStatus: string | null;
+    receiverName: string | null;
+    receiverCountryName: string | null;
+    city: string | null;
+    stateOrProvince: string | null;
+    postalCode: string | null;
+    phoneNumber: string | null;
+    productName: string | null;
+    productCode: string | null;
+    totalPrice: string | null;
+    currency: string | null;
+    weight: string | null;
+    trackingNo: string | null;
+    buyerId: string | null;
+    buyerNote: string | null;
+    createdTime: string | null;
+    items: PlatformOrderItemDetail[] | null;
+}
+export interface IndivAuthRequest {
+    name: string;
+    certNumber: string;
+    mobile: string;
+    /** 0=手机号验证，1=银行卡验证 */
+    authType: string;
+    /** authType=1 时必填 */
+    bankCard?: string;
+    /** 企业认证中的经办人实名认证传 true */
+    isAgent?: boolean;
+}
+export interface CheckAuthCodeRequest {
+    authCode: string;
+    authType?: string;
+    /** start_indiv_real_name_auth 返回的流程 ID */
+    flowId: string;
+    isAgent?: boolean;
+}
+export interface OrganAuthRequest {
+    name: string;
+    certNumber: string;
+    certType?: number;
+    agentAccountId?: string;
+}
+export interface OpenBrandRequest {
+    serviceCode: string;
+    customerType?: number;
+    country: string;
+    address: string;
+    state?: string;
+    city?: string;
+    county?: string;
+    customerName: string;
+    contactName: string;
+    mobile: string;
+    email: string;
+    /** 企业客户必填 */
+    cLegalName?: string;
+}
+export interface GATAuthRequest {
+    /** 1=港澳台，2=海外 */
+    customerProfile: string;
+    /** 1=个人，2=企业。字段名沿用后端拼写（enitity），不要改成 entity */
+    enitity: string;
+    name: string;
+    mobile: string;
+    email: string;
+    contactName?: string;
+    legalPerson?: string;
+    certNumber?: string;
+    country?: string;
+    countryCode?: string;
+    alpha2Code?: string;
+    state?: string;
+    stateCode?: string;
+    city?: string;
+    cityCode?: string;
+    county?: string;
+    countyCode?: string;
+    address?: string;
+}
+export interface OnboardingProgressResp {
+    certification: boolean | null;
+    contractApply: boolean | null;
+    contractSign: boolean | null;
+    /** 当前所处节点：certification | contractApply | contractSign | brandSuccess */
+    currentNode: string | null;
+    /** 0=中国大陆、1=港澳台、2=海外 */
+    customerProfile: string | null;
+    /** 经济主体：1=个人、2=企业 */
+    entity: string | null;
+}
+export interface AuthScheduleResp {
+    /** 0=未开始、1=进行中、2=已完成、3=认证失败、4=待对公打款验证 */
+    authStatus: number | null;
+    /** 0=大陆、1=港澳台、2=海外 */
+    customerType: string | null;
+    /** 0=个人认证、1=企业认证 */
+    authType: number | null;
+}
+export interface CustomerTypeItem {
+    customerName: string | null;
+    customerCode: string | null;
+    /** 1 表示当前客户所属类型 */
+    isValid: string | null;
+}
+export interface BrandAuthOption {
+    authName: string | null;
+    authCode: string | null;
+    disable: boolean | null;
+}
+export interface BrandAndAuthItem {
+    brandName: string | null;
+    brandCode: string | null;
+    disable: boolean | null;
+    info: string | null;
+    authList: BrandAuthOption[] | null;
+}
+/** ContractDTO 字段极多，这里只声明 CLI 会渲染的部分。 */
+export interface ContractItem {
+    code: string | null;
+    name: string | null;
+    type: number | null;
+    status: number | null;
+    serviceName: string | null;
+    customerName: string | null;
+    effectiveStartTime: string | null;
+    effectiveEndTime: string | null;
+    applyTime: string | null;
+    signFinishTime: string | null;
+}
+export interface ContractListResp {
+    pageNum: number;
+    pageSize: number;
+    pages: number;
+    total: number;
+    data: ContractItem[];
+}
+/**
+ * `order create` / `order edit` 是唯二使用 JSON body 的接口（后端以
+ * `@Body` 绑定）；客户端其他 POST 均为 form-urlencoded。以下类型逐字段
+ * 对齐后端 DTO，避免未知字段在后端被静默丢弃后造成难以发现的错误。
+ */
+export interface OrderSenderInfo {
+    name?: string;
+    company?: string;
+    phone?: string;
+    address?: string;
+    country?: string;
+    postcode?: string;
+    city?: string;
+    province?: string;
+}
+export interface OrderReceiverInfo {
+    name?: string;
+    company?: string;
+    phone?: string;
+    mobile?: string;
+    address?: string;
+    city?: string;
+    province?: string;
+    postcode?: string;
+    country?: string;
+    email?: string;
+}
+export interface OrderParcelInfo {
+    weight?: number;
+    length?: number;
+    width?: number;
+    height?: number;
+    dutyPayMode?: string;
+}
+export interface OrderDeclareItemInfo {
+    ename?: string;
+    cname?: string;
+    qty?: number;
+    unitPrice?: number;
+    currency?: string;
+    weight?: number;
+    hsCode?: string;
+}
+/** `P` = 预报（直接提交），`D` = 草稿（保存不提交）。后端默认 `P`。 */
+export type OrderWriteStatus = 'P' | 'D';
+export interface CreateOrderRequest {
+    productCode: string;
+    destinationCountry: string;
+    originCountry?: string;
+    status?: OrderWriteStatus;
+    customerOrderNo?: string;
+    sender?: OrderSenderInfo;
+    receiver?: OrderReceiverInfo;
+    parcel?: OrderParcelInfo;
+    declareItems?: OrderDeclareItemInfo[];
+}
+export interface CreateOrderResp {
+    orderId: number | null;
+    orderNo: string | null;
+    status: string | null;
+    customerOrderNo: string | null;
+}
+export interface EditOrderRequest extends Partial<Omit<CreateOrderRequest, 'status'>> {
+    orderId: number;
+    status?: OrderWriteStatus;
+}
+export interface EditOrderResp {
+    orderId: number | null;
+    orderNo: string | null;
+    status: string | null;
+    updateSuccess: boolean | null;
+}
+export interface ForecastOrderResp {
+    successCount: number | null;
+    failCount: number | null;
+    failDetails: string | null;
+}
+export interface CancelOrderResp {
+    success: boolean | null;
+    message: string | null;
+}
+export interface InterceptOrderResult {
+    orderId: string | null;
+    success: boolean | null;
+    failReason: string | null;
+}
+export interface InterceptOrderResp {
+    results: InterceptOrderResult[] | null;
+}

package/dist/utils/confirm.d.ts

@@ -0,0 +1,18 @@
+import type { GlobalOptions } from '../types/index.js';
+export interface WriteOptions extends GlobalOptions {
+    yes?: boolean;
+}
+/**
+ * Decide whether a write command may proceed. Returns false when the caller
+ * must abort — and has already told the user why.
+ *
+ * `--dry-run` passes through: ApiClient prints the request and throws
+ * DryRunSignal before anything leaves the machine, so there is nothing to
+ * confirm.
+ *
+ * Non-interactive callers (pipes, CI, AI agents) are refused rather than
+ * waved through. `update` waves them through, but nothing it does is
+ * irreversible; submitting an identity document is, so silence must not read
+ * as consent here.
+ */
+export declare function confirmWrite(opts: WriteOptions, summary: string): Promise<boolean>;

package/dist/utils/confirm.js

@@ -0,0 +1,50 @@
+/**
+ * Confirmation gate for write operations.
+ *
+ * Every other command in this CLI is a read: the worst a wrong flag can do is
+ * return the wrong rows. The `platform` push/sync and `onboarding` auth/brand
+ * commands are not — they submit real-name material, open brands and hand
+ * orders to carriers. So they ask first.
+ */
+import chalk from 'chalk';
+import { createInterface } from 'node:readline';
+import * as logger from './logger.js';
+/**
+ * Decide whether a write command may proceed. Returns false when the caller
+ * must abort — and has already told the user why.
+ *
+ * `--dry-run` passes through: ApiClient prints the request and throws
+ * DryRunSignal before anything leaves the machine, so there is nothing to
+ * confirm.
+ *
+ * Non-interactive callers (pipes, CI, AI agents) are refused rather than
+ * waved through. `update` waves them through, but nothing it does is
+ * irreversible; submitting an identity document is, so silence must not read
+ * as consent here.
+ */
+export async function confirmWrite(opts, summary) {
+    if (opts.dryRun)
+        return true;
+    if (opts.yes)
+        return true;
+    if (!process.stdin.isTTY) {
+        logger.error('该命令会提交写操作，非交互环境下必须显式加 -y 确认');
+        logger.info('或先用 --dry-run 查看将要发送的请求');
+        process.exitCode = 1;
+        return false;
+    }
+    const ok = await ask(`${summary} ?`);
+    if (!ok)
+        logger.warn('已取消');
+    return ok;
+}
+function ask(question) {
+    return new Promise((resolve) => {
+        const rl = createInterface({ input: process.stdin, output: process.stderr });
+        rl.question(`${chalk.yellow('?')} ${question} [y/N] `, (answer) => {
+            rl.close();
+            resolve(/^y(es)?$/i.test(answer.trim()));
+        });
+    });
+}
+//# sourceMappingURL=confirm.js.map

package/dist/utils/confirm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../../src/utils/confirm.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAOtC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAkB,EAAE,OAAe;IACpE,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAE1B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACvC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,GAAG,CAAC,QAAgB;IAC3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7E,EAAE,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,QAAQ,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;YAChE,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/run-command.d.ts

@@ -0,0 +1,24 @@
+import { ApiClient } from '../services/api-client.js';
+import type { GlobalOptions } from '../types/index.js';
+export interface RunCommandConfig<TData> {
+    /** Spinner text shown during execution */
+    spinner: string;
+    /** The API call to execute */
+    exec: (client: ApiClient) => Promise<TData | null | undefined>;
+    /** Render data in human-readable text format (TTY mode) */
+    render: (data: TData) => void;
+    /** Message shown when API returns null/empty data (default: '暂无数据') */
+    emptyMessage?: string;
+}
+/**
+ * Low-level shell: manages the spinner lifecycle, builds the ApiClient, and
+ * centralizes error handling. The spinner is stopped right after `fetch`
+ * resolves and before `consume` runs — matching the hand-written commands,
+ * which always stop the spinner before writing output.
+ *
+ * Use this when a command's output logic does not fit the standard
+ * `runCommand` shape (e.g. always-JSON output, custom empty checks, or no
+ * empty branch at all): `consume` owns every output decision.
+ */
+export declare function withClient<TData>(globalOptions: GlobalOptions, spinnerText: string, fetch: (client: ApiClient) => Promise<TData>, consume: (data: TData) => void): Promise<void>;
+export declare function runCommand<TData>(globalOptions: GlobalOptions, config: RunCommandConfig<TData>): Promise<void>;

package/dist/utils/run-command.js

@@ -0,0 +1,58 @@
+/**
+ * Unified command execution shell.
+ *
+ * Eliminates the repeated spinner → ApiClient → try/catch → json/text branch
+ * pattern found across all command files (~50 occurrences).
+ *
+ * Usage:
+ *   await runCommand(opts, {
+ *     spinner: '正在查询...',
+ *     exec: (client) => client.getTrackDetail(orderNo),
+ *     render: printTrackDetail,
+ *   });
+ */
+import chalk from 'chalk';
+import { createSpinner } from './logger.js';
+import { ConfigManager } from '../services/config-manager.js';
+import { ApiClient } from '../services/api-client.js';
+import { handleError } from '../commands/error-handler.js';
+/**
+ * Low-level shell: manages the spinner lifecycle, builds the ApiClient, and
+ * centralizes error handling. The spinner is stopped right after `fetch`
+ * resolves and before `consume` runs — matching the hand-written commands,
+ * which always stop the spinner before writing output.
+ *
+ * Use this when a command's output logic does not fit the standard
+ * `runCommand` shape (e.g. always-JSON output, custom empty checks, or no
+ * empty branch at all): `consume` owns every output decision.
+ */
+export async function withClient(globalOptions, spinnerText, fetch, consume) {
+    const spinner = createSpinner(spinnerText);
+    try {
+        spinner.start();
+        const client = new ApiClient(new ConfigManager(), globalOptions);
+        const data = await fetch(client);
+        spinner.stop();
+        consume(data);
+    }
+    catch (error) {
+        spinner.stop();
+        handleError(error);
+    }
+}
+export async function runCommand(globalOptions, config) {
+    await withClient(globalOptions, config.spinner, (client) => config.exec(client), (data) => {
+        if (globalOptions.output === 'json') {
+            console.log(JSON.stringify(data ?? null, null, 2));
+            return;
+        }
+        if (!data) {
+            console.log('');
+            console.log(chalk.yellow(`  ${config.emptyMessage ?? '暂无数据'}`));
+            console.log('');
+            return;
+        }
+        config.render(data);
+    });
+}
+//# sourceMappingURL=run-command.js.map

package/dist/utils/run-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.js","sourceRoot":"","sources":["../../src/utils/run-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAc3D;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,aAA4B,EAC5B,WAAmB,EACnB,KAA4C,EAC5C,OAA8B;IAE9B,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACjC,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,WAAW,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,aAA4B,EAC5B,MAA+B;IAE/B,MAAM,UAAU,CACd,aAAa,EACb,MAAM,CAAC,OAAO,EACd,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAC/B,CAAC,IAAI,EAAE,EAAE;QACP,IAAI,aAAa,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,YAAY,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cbs-4px-merchant-cli",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "Cbs merchant CLI tool",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,6 +25,7 @@
     "build:4px:pre": "SITE=4px ENV=pre npm run build",
     "build:cainiao:test": "SITE=cainiao ENV=test npm run build",
     "build:cainiao:pre": "SITE=cainiao ENV=pre npm run build",
+    "package:role-skills": "bash scripts/package-role-skills.sh",
     "dev:4px:test": "SITE=4px ENV=test npm run build && node dist/index.js skill install",
     "dev:4px:pre": "SITE=4px ENV=pre npm run build && node dist/index.js skill install",
     "dev:cainiao:test": "SITE=cainiao ENV=test npm run build && node dist/index.js skill install",

package/scripts/postinstall.js

@@ -8,7 +8,7 @@
  * versions that still run install scripts get the skill without a second step.
  *
  * It deliberately owns no logic of its own, because it cannot be relied upon:
- * npm 11 blocks dependency install scripts by default and *still exits 0*, so
+ * npm 12 blocks dependency install scripts by default and *still exits 0*, so
  * anything that must happen cannot live here. When the hook is skipped, the
  * install docs' second step (`<bin> skill install`) covers it.
  *