@wener/common 1.0.5 → 2.0.2

package/src/cn/ChineseResidentIdNo.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod/v4';
+import { SexType, SexTypeSchema } from '../foundation/schema';
+import { Mod11 } from './Mod11';
+
+export const ChineseResidentIdNoRegex =
+	/^(?<division>[1-9]\d{5})(?<year>(18|19|20)\d{2})(?<month>0[1-9]|1[0-2])(?<day>0[1-9]|[12]\d|3[01])(?<sequence>\d{3})(?<checkDigit>[0-9Xx])$/;
+
+export type ParsedChineseResidentIdNo = z.infer<typeof ParsedChineseResidentIdNoSchema>;
+export const ParsedChineseResidentIdNoSchema = z
+	.object({
+		raw: z.string().regex(ChineseResidentIdNoRegex, '无效的18位身份证号码格式').describe('身份证号码'),
+		addressCode: z.string().length(6).describe('地址码 '),
+		birthDate: z.iso.date().describe('出生日期'),
+		sequence: z.int().max(999).min(0).describe('顺序码'),
+		checkDigit: z.int().min(0).max(10).describe('校验码'),
+		sex: SexTypeSchema.describe('性别'),
+		age: z.number().optional(),
+		valid: z.boolean().optional().describe('是否有效'),
+	})
+	.describe('居民身份证号码解析内容');
+
+export function parseChineseResidentIdNo(idNo: string): ParsedChineseResidentIdNo | undefined {
+	const reg = ChineseResidentIdNoRegex;
+	const match = idNo.match(reg);
+	if (!match || !match.groups) {
+		return undefined;
+	}
+	const { division, year, month, day, sequence, checkDigit } = match.groups;
+	let seq = parseInt(sequence, 10);
+	return {
+		raw: idNo,
+		addressCode: division,
+		birthDate: `${year}-${month}-${day}`,
+		sequence: seq,
+		checkDigit: checkDigit.toUpperCase() === 'X' ? 10 : parseInt(checkDigit),
+		sex: seq % 2 === 0 ? SexType.Male : SexType.Female,
+		age: new Date().getFullYear() - parseInt(year, 10),
+		valid: Mod11.validate(idNo),
+	};
+}
+
+export function formatChineseResidentIdNo({
+	addressCode,
+	birthDate,
+	sequence,
+	checkDigit,
+}: {
+	addressCode: string;
+	birthDate: string | Date;
+	sequence: number | string;
+	checkDigit?: string | number;
+}): string {
+	const date =
+		typeof birthDate === 'string'
+			? birthDate.replace(/-/g, '')
+			: `${birthDate.getFullYear()}${String(birthDate.getMonth() + 1).padStart(2, '0')}${String(birthDate.getDate()).padStart(2, '0')}`;
+	const seq = String(sequence).padStart(3, '0');
+	const major = `${addressCode}${date}${seq}`;
+	const check =
+		typeof checkDigit === 'number'
+			? checkDigit === 10
+				? 'X'
+				: String(checkDigit)
+			: checkDigit?.toUpperCase() || Mod11.compute(major);
+	return `${major}${check}`;
+}

package/src/cn/DivisionCode.mod.ts

@@ -0,0 +1,7 @@
+export {
+	DivisionCodeRegex as regex,
+	type ParsedDivisionCode as Result,
+	ParsedDivisionCodeSchema as ResultSchema,
+	parseDivisionCode as parse,
+	formatDivisionCode as format,
+} from './DivisionCode';

package/src/cn/DivisionCode.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { DivisionCode } from './DivisionCode';
+import { DivisionCode } from './mod';
 
 describe('DivisionCode', () => {
 	it('should parse', () => {
@@ -7,27 +7,17 @@ describe('DivisionCode', () => {
 			[
 				'441900003001',
 				{
-					province: '44',
-					city: '19',
-					county: '00',
-					town: '003',
-					village: '001',
 					codes: ['44', '19', '00', '003', '001'],
 				},
 			],
 			[
 				441900003001,
 				{
-					province: '44',
-					city: '19',
-					county: '00',
-					town: '003',
-					village: '001',
 					codes: ['44', '19', '00', '003', '001'],
 				},
 			],
-			[441900, { province: '44', city: '19', county: '00' }],
-			['31', { province: '31' }],
+			[441900, { codes: ['44', '19', '00'] }],
+			['31', { codes: ['31'] }],
 			['4', undefined],
 			['', undefined],
 			[null, undefined],

package/src/cn/DivisionCode.ts

@@ -1,209 +1,146 @@
-const DivisionCodeLevels: Array<{ level: number; code: string; length: number; size: number; label: string }> = [
-	{ level: 1, code: 'Province', length: 2, size: 2, label: '省' },
-	{ level: 2, code: 'City', length: 4, size: 2, label: '市' },
-	{ level: 3, code: 'County', length: 6, size: 2, label: '区县' },
-	{ level: 4, code: 'Town', length: 9, size: 3, label: '乡镇' },
-	{ level: 5, code: 'Village', length: 12, size: 3, label: '村' },
-] as const;
-
-// String(Number.MAX_SAFE_INTEGER).length=16
-// 12 is safe int
+import z from 'zod/v4';
+import type { EnumValues } from '../resource/schema';
+
+export const DivisionLevel = Object.freeze({
+	__proto__: null,
+	Province: 'Province',
+	City: 'City',
+	County: 'County',
+	Town: 'Town',
+	Village: 'Village',
+});
+const DivisionLevels = [
+	DivisionLevel.Province,
+	DivisionLevel.City,
+	DivisionLevel.County,
+	DivisionLevel.Town, // 3
+	DivisionLevel.Village, // 3
+];
+export type DivisionLevel = EnumValues<typeof DivisionLevel>;
+export const DivisionLevelSchema = z
+	.union([
+		z.literal(DivisionLevel.Province).describe('省级').meta({ ordinal: 1 }),
+		z.literal(DivisionLevel.City).describe('地级').meta({ ordinal: 2 }),
+		z.literal(DivisionLevel.County).describe('县级').meta({ ordinal: 3 }),
+		z.literal(DivisionLevel.Town).describe('乡镇级').meta({ ordinal: 4 }),
+		z.literal(DivisionLevel.Village).describe('村级').meta({ ordinal: 5 }),
+	])
+	.describe('行政区划级别');
+
+export type ParsedDivisionCode = z.infer<typeof ParsedDivisionCodeSchema>;
+export const ParsedDivisionCodeSchema = z.object({
+	code: z.string().describe('行政区划代码'),
+	name: z.string().describe('行政区划名称'),
+	level: DivisionLevelSchema,
+	codes: z.string().array(),
+	names: z.string().array(),
+	latitude: z.number().optional().describe('纬度'),
+	longitude: z.number().optional().describe('经度'),
+});
+
+interface CodeName {
+	value: string;
+	name: string;
+	children?: Array<CodeName>;
+}
 
-/**
- * Codes for the administrative divisions of the People's Republic of China
- *
- * @see https://zh.wikipedia.org/wiki/GB/T_2260 中华人民共和国行政区划代码
- */
-export namespace DivisionCode {
-	enum DivisionCodeLevel {
-		Province = 1,
-		City = 2,
-		County = 3,
-		Town = 4,
-		Village = 5,
+export const DivisionCodeRegex =
+	/^(?<province>\d{2})(?<city>\d{2})?(?<county>\d{2})?(?<town>\d{3})?(?<village>\d{3})?$/;
+
+const CodeNames: CodeName[] = [
+	{ value: '11', name: '北京市' },
+	{ value: '12', name: '天津市' },
+	{ value: '13', name: '河北省' },
+	{ value: '14', name: '山西省' },
+	{ value: '15', name: '内蒙古自治区' },
+	{ value: '21', name: '辽宁省' },
+	{ value: '22', name: '吉林省' },
+	{ value: '23', name: '黑龙江省' },
+	{ value: '31', name: '上海市' },
+	{ value: '32', name: '江苏省' },
+	{ value: '33', name: '浙江省' },
+	{ value: '34', name: '安徽省' },
+	{ value: '35', name: '福建省' },
+	{ value: '36', name: '江西省' },
+	{ value: '37', name: '山东省' },
+	{ value: '41', name: '河南省' },
+	{ value: '42', name: '湖北省' },
+	{ value: '43', name: '湖南省' },
+	{ value: '44', name: '广东省' },
+	{ value: '45', name: '广西壮族自治区' },
+	{ value: '46', name: '海南省' },
+	{ value: '50', name: '重庆市' },
+	{ value: '51', name: '四川省' },
+	{ value: '52', name: '贵州省' },
+	{ value: '53', name: '云南省' },
+	{ value: '54', name: '西藏自治区' },
+	{ value: '61', name: '陕西省' },
+	{ value: '62', name: '甘肃省' },
+	{ value: '63', name: '青海省' },
+	{ value: '64', name: '宁夏回族自治区' },
+	{ value: '65', name: '新疆维吾尔自治区' },
+	{ value: '71', name: '台湾省' },
+	{ value: '81', name: '香港特别行政区' },
+	{ value: '82', name: '澳门特别行政区' },
+	// 9 国外
+];
+
+export function parseDivisionCode(code: string): ParsedDivisionCode | undefined {
+	const match = DivisionCodeRegex.exec(code);
+	if (!match) {
+		return undefined;
+	}
+	const { province, city, county, town, village } = match.groups ?? {};
+	if (!province) {
+		return undefined;
 	}
 
-	export const levels = DivisionCodeLevels;
-
-	export const regex = /^(?<province>\d{2})(?<city>\d{2})?(?<county>\d{2})?(?<town>\d{3})?(?<village>\d{3})?$/;
-
-	const root: CodeValue[] = [
-		{ value: '11', label: '北京市' },
-		{ value: '12', label: '天津市' },
-		{ value: '13', label: '河北省' },
-		{ value: '14', label: '山西省' },
-		{ value: '15', label: '内蒙古自治区' },
-		{ value: '21', label: '辽宁省' },
-		{ value: '22', label: '吉林省' },
-		{ value: '23', label: '黑龙江省' },
-		{ value: '31', label: '上海市' },
-		{ value: '32', label: '江苏省' },
-		{ value: '33', label: '浙江省' },
-		{ value: '34', label: '安徽省' },
-		{ value: '35', label: '福建省' },
-		{ value: '36', label: '江西省' },
-		{ value: '37', label: '山东省' },
-		{ value: '41', label: '河南省' },
-		{ value: '42', label: '湖北省' },
-		{ value: '43', label: '湖南省' },
-		{ value: '44', label: '广东省' },
-		{ value: '45', label: '广西壮族自治区' },
-		{ value: '46', label: '海南省' },
-		{ value: '50', label: '重庆市' },
-		{ value: '51', label: '四川省' },
-		{ value: '52', label: '贵州省' },
-		{ value: '53', label: '云南省' },
-		{ value: '54', label: '西藏自治区' },
-		{ value: '61', label: '陕西省' },
-		{ value: '62', label: '甘肃省' },
-		{ value: '63', label: '青海省' },
-		{ value: '64', label: '宁夏回族自治区' },
-		{ value: '65', label: '新疆维吾尔自治区' },
-		{ value: '71', label: '台湾省' },
-		{ value: '81', label: '香港特别行政区' },
-		{ value: '82', label: '澳门特别行政区' },
-		// 9 国外
-	];
-
-	export type ParsedCode = {
-		province: string;
-		city?: string;
-		county?: string;
-		town?: string;
-		village?: string;
-		codes: string[];
-		level: DivisionCodeLevel;
-		labels: string[];
-	};
-
-	export function parse(code: string | undefined | null | number): ParsedCode | undefined {
-		if (!code) return;
-		code = String(code);
-		const match = regex.exec(code);
-		if (!match) return;
-		const { province, city, county, town, village } = match.groups ?? {};
-		if (!province) return;
-
-		let codes = [province, city, county, town, village].filter(Boolean);
-		return { province, city, county, town, village, codes: codes, level: codes.length as DivisionCodeLevel };
+	const codes = [province, city, county, town, village].filter(Boolean);
+	const names: string[] = [];
+	{
+		let name = CodeNames.find((cn) => cn.value === province);
+		if (name) {
+			names.push(name.name);
+		}
 	}
+	let level: DivisionLevel = DivisionLevels[codes.length - 1];
+	return {
+		code,
+		name: names.join(''),
+		level,
+		codes,
+		names,
+	};
+}
 
-	export function format({
-		province,
-		city,
-		county,
-		town,
-		village,
-	}: {
-		province: string | number;
-		city?: string | number;
-		county?: string | number;
-		town?: string | number;
-		village?: string | number;
-	}): string {
-		const codes: string[] = [];
+export function formatDivisionCode({
+	province,
+	city,
+	county,
+	town,
+	village,
+	codes = [],
+}: {
+	province?: string | number;
+	city?: string | number;
+	county?: string | number;
+	town?: string | number;
+	village?: string | number;
+	codes?: string[];
+}): string {
+	if (!codes.length) {
 		for (let i = 0; i < [province, city, county, town, village].length; i++) {
 			let x = [province, city, county, town, village][i];
 			if (x === undefined || x === null || x === '') {
 				break;
 			}
-			let len = levels[i].size;
-			codes.push(String(x).padStart(len, '0').slice(0, len));
-		}
-		return codes.join('');
-	}
-
-	// export function random(level: DivisionCodeLevel = 'County'): string {
-	//   const l = DivisionCodeLevels.find((v) => v.code === level) || DivisionCodeLevels[2];
-	//   const l1 = randomPick(provinces);
-	//   if (l.level === 1) {
-	//     return String(l1[0]);
-	//   }
-	//   return l1 + String(Math.floor(Math.random() * parseFloat(`1e${l.length - 2}`) - 1));
-	// }
-}
-
-interface DivisionTreeNode {
-	sub: string; // sub code
-	children?: Record<string, DivisionTreeNode>;
-
-	code: string; // full code
-	name?: string; // name of division
-}
-
-// export type DivisionCodeLevel = 'Village' | 'Town' | 'County' | 'City' | 'Province';
-
-// export interface ParsedDivisionCode {
-//   level: DivisionCodeLevel;
-//   code: string;
-//   name?: string;
-//   fullName?: string;
-//   names: string[];
-//   // 村级（村委会、居委会）
-//   // 12 位
-//   village?: CodeName;
-//   // 乡级（乡镇、街道）
-//   // 9 位
-//   town?: CodeName;
-//   // 县级（区县）
-//   // 6 位 - 常用 - 2985 个
-//   county?: CodeName;
-//   // 地级（城市）
-//   // 4 位 - 343 个
-//   city?: CodeName;
-//   // 省级（省份、直辖市、自治区）
-//   // 2 位 - 32 个
-//   province: CodeName;
-//
-//   children?: Array<{ code: string; name?: string }>;
-// }
-
-// export interface CodeName {
-//   code: string;
-//   name: string;
-// }
-
-// export function getSimpleProvinceLabel(value: string) {
-//   if (!value) {
-//     return;
-//   }
-//   let label = value;
-//   if (/[0-9]/.test(label)) {
-//     label = label.slice(0, 2);
-//     label = options.find((v) => v.value === label)?.label || label;
-//   }
-//   return label.replace(/省|市|(回族|维吾尔|壮族)?自治区|特别行政区$/, '');
-// }
-
-export function randomPick<T>(s: T[]) {
-	return s[Math.floor(Math.random() * s.length)];
-}
-
-function lookup(opts: { values: string[]; root: CodeValue[] }): { found: CodeValue[] } {
-	const { values, root } = opts;
-	const found: CodeValue[] = [];
-	let currentLevel = root;
-
-	for (const v of values) {
-		const node = currentLevel.find((n) => n.value === v);
-		if (!node) {
-			break;
-		}
-
-		found.push(node);
-
-		if (node.children) {
-			currentLevel = node.children;
-		} else {
-			break;
+			let size = 2;
+			if (i > 2) {
+				size = 3;
+			}
+			codes.push(String(x).padStart(size, '0').slice(0, size));
 		}
 	}
 
-	return { found };
-}
-
-interface CodeValue {
-	value: string;
-	label: string;
-	children?: Array<CodeValue>;
+	return codes.join('');
 }

package/src/cn/{Mod11Checksum.ts → Mod11.ts}

@@ -2,7 +2,7 @@
  * ISO 7064:1983, MOD 11-2.
  */
 export class Mod11Checksum {
-	weights = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2, 1];
+	protected weights = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2, 1];
 
 	validate(s: string) {
 		return s.at(-1) === this.compute(s.slice(0, s.length - 1));
@@ -22,3 +22,5 @@ export class Mod11Checksum {
 		}
 	}
 }
+
+export const Mod11 = new Mod11Checksum();

package/src/cn/{Mod31Checksum.ts → Mod31.ts}

@@ -34,3 +34,5 @@ export class Mod31Checksum {
 		return this.toChar(31 - (sum % 31));
 	}
 }
+
+export const Mod31 = new Mod31Checksum();

package/src/cn/UnifiedSocialCreditCode.mod.ts

@@ -0,0 +1,7 @@
+export {
+	type ParsedUnifiedSocialCreditCode as Result,
+	UnifiedSocialCreditCodeRegex as regex,
+	ParsedUnifiedSocialCreditCodeSchema as ResultSchema,
+	parseUnifiedSocialCreditCode as parse,
+	formatUnifiedSocialCreditCode as format,
+} from './UnifiedSocialCreditCode';

package/src/cn/UnifiedSocialCreditCode.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { UnifiedSocialCreditCode } from './UnifiedSocialCreditCode';
+import { UnifiedSocialCreditCode } from './mod';
 
 describe('UnifiedSocialCreditCode', () => {
 	it('should parse', () => {
@@ -9,7 +9,7 @@ describe('UnifiedSocialCreditCode', () => {
 			'91330106MA2CFLDG4R',
 		]) {
 			let out = UnifiedSocialCreditCode.parse(a);
-			expect(UnifiedSocialCreditCode.format(out)).toBe(a);
+			expect(UnifiedSocialCreditCode.format(out!)).toBe(a);
 			expect(out).toMatchSnapshot();
 		}
 	});