@v587d/capital-generation 0.0.0-stage → 2.6.1

package/lib/sources/security-code.d.ts

@@ -0,0 +1,27 @@
+export type SecurityMarket = 'SH' | 'SZ' | 'BJ';
+export interface SecurityCode {
+    digits: string;
+    market: SecurityMarket;
+    canonical: string;
+    tencentSymbol: string;
+    isIndex: boolean;
+}
+/**
+ * Parse an A-share/ETF/index code without dropping exchange information.
+ * Bare 000xxx codes are rejected because they are ambiguous (e.g. 000001).
+ */
+export declare function parseSecurityCode(value: unknown, name?: string): SecurityCode;
+/**
+ * 检索面的代码口径：只回答"把这串写法归一成 6 位数字"。
+ *
+ * 与 `parseSecurityCode` 的分工是刻意的：数据面必须消歧（裸 `000001` 在指数与个股之间
+ * 有歧义），而**具名来源自己会回答"这台机器上有没有这只票"**——cninfo 只覆盖深市、
+ * sseinfo 只覆盖沪市，越界返回 0 条并带 note 是真事实，不能在这一层把它拒掉。
+ * 所以裸 `000001`（平安银行）在这里合法，`SH600519` / `600519.SH` 也合法（东财研报库
+ * 实测只认纯数字，带前缀返回 0 条，因此归一化属于工具职责而不是模型的记性）。
+ */
+export declare function bareAshareDigits(value: unknown, name?: string): string;
+/** Normalize a list while preserving first-seen order and rejecting duplicates after normalization. */
+export declare function normalizeSecurityCodes(value: unknown, name?: string, maximum?: number): SecurityCode[];
+export declare function requireTencentSecurity(code: SecurityCode, name?: string): SecurityCode;
+export declare function isLikelyIndex(code: SecurityCode): boolean;

package/lib/sources/security-code.js

@@ -0,0 +1,104 @@
+const CODE_PATTERN = /^(?:(sh|sz|bj)(\d{6})|(\d{6})(?:\.(sh|sz|bj|xshg|xshe))?)$/i;
+const JOINQUANT_MARKETS = { xshg: 'SH', xshe: 'SZ' };
+const SH_INDEX_CODES = new Set(['000001', '000010', '000016', '000300', '000688', '000852', '000905']);
+function naturalMarket(digits) {
+    if (digits.startsWith('92') || digits.startsWith('4') || digits.startsWith('8'))
+        return 'BJ';
+    if (digits[0] === '5' || digits[0] === '6' || digits[0] === '9')
+        return 'SH';
+    return 'SZ';
+}
+function explicitMarket(prefix, suffix) {
+    const raw = (prefix ?? suffix ?? '').toLowerCase();
+    if (!raw)
+        return undefined;
+    return (JOINQUANT_MARKETS[raw] ?? raw.toUpperCase());
+}
+function isMarket(value) {
+    return value === 'SH' || value === 'SZ' || value === 'BJ';
+}
+/**
+ * Parse an A-share/ETF/index code without dropping exchange information.
+ * Bare 000xxx codes are rejected because they are ambiguous (e.g. 000001).
+ */
+export function parseSecurityCode(value, name = 'code') {
+    if (typeof value !== 'string' || value.trim().length === 0)
+        throw new Error(`parameter ${name} must be a security code`);
+    const raw = value.trim();
+    const match = CODE_PATTERN.exec(raw);
+    if (!match) {
+        throw new Error(`parameter ${name} must be a six-digit code with an exchange (for example 600519.SH, SH600519, or 600519.XSHG)`);
+    }
+    const digits = match[2] ?? match[3];
+    const market = explicitMarket(match[1], match[4]);
+    if (market !== undefined && !isMarket(market))
+        throw new Error(`parameter ${name} has an unsupported exchange in ${JSON.stringify(raw)}`);
+    if (market === undefined && digits.startsWith('000')) {
+        throw new Error(`parameter ${name} requires an explicit exchange for ambiguous 000xxx code ${digits} (use ${digits}.SH for an index or ${digits}.SZ for a stock)`);
+    }
+    const resolved = market ?? naturalMarket(digits);
+    if (digits.startsWith('000')) {
+        if (resolved === 'BJ')
+            throw new Error(`parameter ${name} has an invalid BJ exchange for 000xxx code ${digits}`);
+    }
+    else if (resolved !== naturalMarket(digits)) {
+        throw new Error(`parameter ${name} exchange conflicts with code ${digits}: expected ${naturalMarket(digits)}`);
+    }
+    const isIndex = (resolved === 'SH' && SH_INDEX_CODES.has(digits)) || (resolved === 'SZ' && digits.startsWith('399'));
+    return {
+        digits,
+        market: resolved,
+        canonical: `${digits}.${resolved}`,
+        tencentSymbol: `${resolved.toLowerCase()}${digits}`,
+        isIndex,
+    };
+}
+/**
+ * 检索面的代码口径：只回答"把这串写法归一成 6 位数字"。
+ *
+ * 与 `parseSecurityCode` 的分工是刻意的：数据面必须消歧（裸 `000001` 在指数与个股之间
+ * 有歧义），而**具名来源自己会回答"这台机器上有没有这只票"**——cninfo 只覆盖深市、
+ * sseinfo 只覆盖沪市，越界返回 0 条并带 note 是真事实，不能在这一层把它拒掉。
+ * 所以裸 `000001`（平安银行）在这里合法，`SH600519` / `600519.SH` 也合法（东财研报库
+ * 实测只认纯数字，带前缀返回 0 条，因此归一化属于工具职责而不是模型的记性）。
+ */
+export function bareAshareDigits(value, name = 'code') {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new Error(`parameter ${name} must be a six-digit A-share code (600519 / SH600519 / 600519.SH)`);
+    }
+    const match = CODE_PATTERN.exec(value.trim());
+    if (match === null) {
+        throw new Error(`parameter ${name} must be a six-digit A-share code (接受 600519 / SH600519 / 600519.SH，收到 ${JSON.stringify(value)})`);
+    }
+    return match[2] ?? match[3];
+}
+/** Normalize a list while preserving first-seen order and rejecting duplicates after normalization. */
+export function normalizeSecurityCodes(value, name = 'codes', maximum = 50) {
+    const rawValues = Array.isArray(value)
+        ? value
+        : typeof value === 'string'
+            ? value.split(',').map((item) => item.trim()).filter(Boolean)
+            : undefined;
+    if (!rawValues || rawValues.length === 0)
+        throw new Error(`parameter ${name} must contain at least one security code`);
+    if (rawValues.length > maximum)
+        throw new Error(`parameter ${name} accepts at most ${maximum} codes`);
+    const seen = new Set();
+    const result = [];
+    for (const item of rawValues) {
+        const code = parseSecurityCode(item, name);
+        if (!seen.has(code.canonical)) {
+            seen.add(code.canonical);
+            result.push(code);
+        }
+    }
+    return result;
+}
+export function requireTencentSecurity(code, name = 'code') {
+    if (code.market === 'BJ')
+        throw new Error(`parameter ${name} is a BJ code; Tencent public market endpoints currently support SH/SZ only`);
+    return code;
+}
+export function isLikelyIndex(code) {
+    return code.isIndex;
+}

package/lib/sources/security-identity.d.ts

@@ -0,0 +1,24 @@
+export type EastmoneyMarket = 'SH' | 'SZ' | 'BJ';
+export interface EastmoneySecurityIdentity {
+    thscode: string;
+    ticker: string;
+    eastmoney_code: string;
+    eastmoney_market: EastmoneyMarket;
+}
+/**
+ * Resolve Eastmoney's provider identifiers without guessing a market from digits.
+ * `market` is mandatory for a bare SECURITY_CODE; `secid` carries its own market.
+ */
+export declare function normalizeEastmoneySecurityIdentity(input: {
+    secucode?: unknown;
+    security_code?: unknown;
+    market?: unknown;
+    secid?: unknown;
+}): EastmoneySecurityIdentity;
+export declare function normalizeEastmoneyAshareIdentity(value: unknown): EastmoneySecurityIdentity;
+export interface EastmoneyBoardIdentity {
+    board_code: string;
+    board_name: string;
+    board_type: 'industry' | 'concept' | 'region';
+}
+export declare function normalizeEastmoneyBoardIdentity(codeValue: unknown, nameValue: unknown, boardType: EastmoneyBoardIdentity['board_type']): EastmoneyBoardIdentity;

package/lib/sources/security-identity.js

@@ -0,0 +1,89 @@
+import { parseSecurityCode } from './security-code.js';
+/**
+ * secid 市场码（实测于 2026-09-24，`push2.eastmoney.com/api/qt/stock/get`）：
+ * `1.` = 沪；`0.` = **深市与北交所共用**（`0.920982`、`0.430047` 返回 rc=0，`2.*` 一律 rc=100）。
+ * 因此 `0.` 的 BJ/SZ 由数字前缀区分（4/8/92 为北交所），与 `normalizeEastmoneyAshareIdentity`
+ * 共用 `marketFromAshareDigits` 的同一份规则（§9.7：一条知识一个实现）。
+ */
+const SECID_MARKET_BY_PREFIX = { '1': 'SH', '0': 'SZ_OR_BJ' };
+function marketFromAshareDigits(digits) {
+    if (/^(?:4|8|92)/u.test(digits))
+        return 'BJ';
+    if (/^(?:6|9)/u.test(digits))
+        return 'SH';
+    return 'SZ';
+}
+function text(value, name) {
+    if (typeof value !== 'string' || value.trim().length === 0)
+        throw new Error(`${name} must be a non-empty string`);
+    return value.trim();
+}
+function market(value, name = 'market') {
+    const raw = text(value, name).toUpperCase();
+    if (raw === 'SH' || raw === 'SSE' || raw === '1')
+        return 'SH';
+    if (raw === 'SZ' || raw === 'SZSE' || raw === '0')
+        return 'SZ';
+    if (raw === 'BJ' || raw === 'BSE' || raw === '2')
+        return 'BJ';
+    throw new Error(`${name} must be SH, SZ, or BJ`);
+}
+function code(value, name) {
+    const raw = text(value, name).toUpperCase();
+    if (/^\d{6}\.(?:SH|SZ|BJ)$/.test(raw))
+        return raw;
+    if (/^(?:SH|SZ|BJ)\d{6}$/.test(raw))
+        return `${raw.slice(2)}.${raw.slice(0, 2)}`;
+    if (/^\d{6}$/.test(raw))
+        return raw;
+    throw new Error(`${name} must be a six-digit code, SECUCODE, or market-prefixed code`);
+}
+/**
+ * Resolve Eastmoney's provider identifiers without guessing a market from digits.
+ * `market` is mandatory for a bare SECURITY_CODE; `secid` carries its own market.
+ */
+export function normalizeEastmoneySecurityIdentity(input) {
+    const explicit = input.secucode ?? input.security_code;
+    if (explicit !== undefined) {
+        const normalized = code(explicit, 'security_code');
+        const parsed = normalized.includes('.') ? parseSecurityCode(normalized, 'security_code') : undefined;
+        if (!parsed && input.market === undefined)
+            throw new Error('security_code requires an explicit market');
+        const resolvedMarket = parsed?.market ?? market(input.market);
+        const digits = parsed?.digits ?? normalized;
+        if (parsed && input.market !== undefined && resolvedMarket !== market(input.market))
+            throw new Error('security_code conflicts with market');
+        return {
+            thscode: `${digits}.${resolvedMarket}`,
+            ticker: digits,
+            eastmoney_code: digits,
+            eastmoney_market: resolvedMarket,
+        };
+    }
+    const rawSecid = text(input.secid, 'secid');
+    const match = /^(0|1)\.(\d{6})$/.exec(rawSecid);
+    if (!match)
+        throw new Error('secid must have the form 0.000001 or 1.600519 (北交所同为 0.)');
+    const digits = match[2];
+    const resolvedMarket = SECID_MARKET_BY_PREFIX[match[1]] === 'SH' ? 'SH' : marketFromAshareDigits(digits);
+    return {
+        thscode: `${digits}.${resolvedMarket}`,
+        ticker: digits,
+        eastmoney_code: digits,
+        eastmoney_market: resolvedMarket,
+    };
+}
+export function normalizeEastmoneyAshareIdentity(value) {
+    const raw = text(value, 'security_code').toUpperCase();
+    const digits = raw.includes('.') ? raw.slice(0, 6) : raw;
+    if (!/^\d{6}$/.test(digits))
+        throw new Error('security_code must be a six-digit A-share code');
+    const resolvedMarket = marketFromAshareDigits(digits);
+    return { thscode: `${digits}.${resolvedMarket}`, ticker: digits, eastmoney_code: digits, eastmoney_market: resolvedMarket };
+}
+export function normalizeEastmoneyBoardIdentity(codeValue, nameValue, boardType) {
+    const board_code = text(codeValue, 'board_code').toUpperCase();
+    if (!/^BK\d{4}$/.test(board_code))
+        throw new Error(`board_code must be BK followed by four digits (received ${JSON.stringify(board_code)})`);
+    return { board_code, board_name: text(nameValue, 'board_name'), board_type: boardType };
+}

package/lib/sources/tencent-http.d.ts

@@ -0,0 +1,2 @@
+import type { DataSource } from '../data-collector/hub.js';
+export declare function createTencentSources(): DataSource[];