afdian-kit 0.1.0 → 0.1.1

package/README.md

@@ -37,10 +37,13 @@ export default defineConfig({
 ```ts
 import {
   price, listPlans, listProducts, getProduct,
-  verify, resolveOrder, buildUrl,
+  priceSync, listPlansSync, listProductsSync, getProductSync,
+  verify, resolveOrder, buildUrl, resolveOrderSync, buildUrlSync,
   configure, defineConfig,
 } from "afdian-kit";
 
+// ── 异步版（Node 场景：首次调用自动发现并加载 afdian.config）──
+
 // 价格（金额单位：分）
 await price("membership", { months: 6 });
 // → { kind:"plan", amount:6768, original:7200, rate:0.06, months:6, name:"忍3作战室会员", ... }
@@ -55,6 +58,15 @@ await listPlans({ from: 6, to: 12 });  // 只要 6、12 两档
 await listProducts();                  // [{ key, plan_id, name, price }]
 await getProduct("starter_pack");      // 未配置 → null
 
+// ── 同步版 *Sync（打包器/Workers 场景：入口 configure(config) 后即可同步调用）──
+// 调用方只给 key/months —— 月单价、折扣、plan_id 全部由 config 绑定，无需复述
+priceSync("membership", { months: 6 });        // React render 里直接用，无 loading 态
+listPlansSync();                               // → 与 listPlans() 同结果
+listProductsSync(); getProductSync("starter_pack");
+buildUrlSync({ entry: "membership", userId, months: 6 });
+resolveOrderSync(order);
+// 未 configure（且从未 await 过异步版）时调用 *Sync → 抛「配置尚未加载」
+
 // 验签（async —— Web Crypto 仅异步 API；不依赖 config）
 await verify(rawBody);                 // → { valid:true, type, order } | { valid:false, reason }
 await verify(rawBody, { publicKey });  // 显式覆盖公钥（轮换/测试）

package/dist/index.d.ts

@@ -129,6 +129,13 @@ export declare function defineConfig(config: AfdianConfig): AfdianConfig;
 export declare function configure(config: AfdianConfig): void;
 /** 重置缓存（测试用） */
 export declare function resetConfig(): void;
+/** 获取配置（内部统一入口）：已配置直接返回，否则自动发现 */
+export declare function getConfig(): Promise<AfdianConfig>;
+/**
+ * 同步获取配置（Sync 系列 API 使用）
+ * 需已 configure(config)（打包器/Workers 入口）或此前任一异步方法完成过自动发现（Node）
+ */
+export declare function getConfigSync(): AfdianConfig;
 //#endregion
 //#region src/pricing.d.ts
 /** 官方可购档位（一次性购买仅此六档，钉死） */
@@ -136,7 +143,7 @@ export declare const MONTH_TIERS: readonly [1, 3, 6, 12, 24, 36];
 /** 官方折扣表（钉死） */
 export declare const DISCOUNTS: Readonly<Record<number, number>>;
 /**
- * 订阅方案价格计算（纯函数）
+ * 订阅方案价格计算（纯函数，底层）
  * 金额 = Math.round(monthly × months × (1 − rate))，单位分
  */
 export declare function calcPlanPrice({ monthly, months, discount }: {
@@ -148,7 +155,7 @@ export declare function calcPlanPrice({ monthly, months, discount }: {
   original: number;
   rate: number;
 };
-/** 计算某方案全部档位价格 */
+/** 计算某方案全部档位价格（纯函数，底层） */
 export declare function calcTiers({ monthly, discount }: {
   monthly: number;
   discount: boolean;
@@ -158,7 +165,7 @@ export declare function calcTiers({ monthly, discount }: {
   rate: number;
   months: 1 | 3 | 6 | 12 | 24 | 36;
 }[];
-/** 订阅方案价格（key 未配置则抛错；product 忽略 months） */
+/** 订阅方案/商品价格（key 未配置则抛错；product 忽略 months） */
 export declare function price(key: string, opts?: {
   months?: number;
 }): Promise<PriceResult>;
@@ -171,6 +178,19 @@ export declare function listPlans(opts?: {
 export declare function listProducts(): Promise<ProductInfo[]>;
 /** 单个固定商品（未配置返回 null） */
 export declare function getProduct(key: string): Promise<ProductInfo | null>;
+/** 同步版 price：需已 configure(config)，否则抛错 */
+export declare function priceSync(key: string, opts?: {
+  months?: number;
+}): PriceResult;
+/** 同步版 listPlans：需已 configure(config)，否则抛错 */
+export declare function listPlansSync(opts?: {
+  from?: number;
+  to?: number;
+}): PlanInfo[];
+/** 同步版 listProducts：需已 configure(config)，否则抛错 */
+export declare function listProductsSync(): ProductInfo[];
+/** 同步版 getProduct：需已 configure(config)，否则抛错 */
+export declare function getProductSync(key: string): ProductInfo | null;
 //#endregion
 //#region src/verify.d.ts
 /**
@@ -211,6 +231,14 @@ export declare function buildUrl(opts: {
   userId: string;
   months?: number;
 }): Promise<string>;
+/** 同步版 resolveOrder */
+export declare function resolveOrderSync(order: Pick<AfdianOrder, "plan_id" | "month">): OrderResolution | null;
+/** 同步版 buildUrl */
+export declare function buildUrlSync(opts: {
+  entry: string;
+  userId: string;
+  months?: number;
+}): string;
 //#endregion
 //#region src/handler.d.ts
 /**

package/dist/index.js

@@ -49,6 +49,14 @@ async function getConfig() {
 	});
 	return loading;
 }
+/**
+* 同步获取配置（Sync 系列 API 使用）
+* 需已 configure(config)（打包器/Workers 入口）或此前任一异步方法完成过自动发现（Node）
+*/
+function getConfigSync() {
+	if (cached) return cached;
+	throw new Error("配置尚未加载：请先在入口调用 configure(config)；Node 下也可先 await 任一异步方法（如 price/listPlans）触发自动发现");
+}
 async function discover() {
 	if (!isNode()) throw new Error("自动发现 afdian.config 仅支持 Node 环境；Workers/打包器环境请先调用 configure(config)");
 	const fs = await importNodeBuiltin("fs");
@@ -92,7 +100,7 @@ const DISCOUNTS = {
 };
 const TIER_HINT = "1/3/6/12/24/36";
 /**
-* 订阅方案价格计算（纯函数）
+* 订阅方案价格计算（纯函数，底层）
 * 金额 = Math.round(monthly × months × (1 − rate))，单位分
 */
 function calcPlanPrice({ monthly, months, discount }) {
@@ -106,7 +114,7 @@ function calcPlanPrice({ monthly, months, discount }) {
 		rate
 	};
 }
-/** 计算某方案全部档位价格 */
+/** 计算某方案全部档位价格（纯函数，底层） */
 function calcTiers({ monthly, discount }) {
 	return MONTH_TIERS.map((months) => ({
 		months,
@@ -117,22 +125,21 @@ function calcTiers({ monthly, discount }) {
 		})
 	}));
 }
-/** 订阅方案价格（key 未配置则抛错；product 忽略 months） */
-async function price(key, opts) {
-	const cfg = await getConfig();
+function priceImpl(cfg, key, opts) {
 	const plan = cfg.plans[key];
 	if (plan) {
+		const entry = plan;
 		const months = opts?.months ?? 1;
 		const { amount, original, rate } = calcPlanPrice({
-			monthly: plan.monthly,
+			monthly: entry.monthly,
 			months,
-			discount: plan.discount
+			discount: entry.discount
 		});
 		return {
 			key,
 			kind: "plan",
-			name: plan.name,
-			plan_id: plan.plan_id,
+			name: entry.name,
+			plan_id: entry.plan_id,
 			months,
 			amount,
 			original,
@@ -140,19 +147,20 @@ async function price(key, opts) {
 		};
 	}
 	const product = cfg.products[key];
-	if (product) return {
-		key,
-		kind: "product",
-		name: product.name,
-		plan_id: product.plan_id,
-		amount: product.price,
-		fixed: true
-	};
+	if (product) {
+		const entry = product;
+		return {
+			key,
+			kind: "product",
+			name: entry.name,
+			plan_id: entry.plan_id,
+			amount: entry.price,
+			fixed: true
+		};
+	}
 	throw new Error(`未找到配置项: ${key}（检查 afdian.config 的 plans/products）`);
 }
-/** 订阅方案列表（含逐档价格表，可按档位区间过滤） */
-async function listPlans(opts) {
-	const cfg = await getConfig();
+function listPlansImpl(cfg, opts) {
 	return Object.entries(cfg.plans).map(([key, plan]) => ({
 		key,
 		plan_id: plan.plan_id,
@@ -162,9 +170,7 @@ async function listPlans(opts) {
 		tiers: calcTiers(plan).filter((t) => (opts?.from === void 0 || t.months >= opts.from) && (opts?.to === void 0 || t.months <= opts.to))
 	}));
 }
-/** 固定商品列表 */
-async function listProducts() {
-	const cfg = await getConfig();
+function listProductsImpl(cfg) {
 	return Object.entries(cfg.products).map(([key, product]) => ({
 		key,
 		plan_id: product.plan_id,
@@ -172,9 +178,8 @@ async function listProducts() {
 		price: product.price
 	}));
 }
-/** 单个固定商品（未配置返回 null） */
-async function getProduct(key) {
-	const product = (await getConfig()).products[key];
+function getProductImpl(cfg, key) {
+	const product = cfg.products[key];
 	if (!product) return null;
 	return {
 		key,
@@ -183,6 +188,38 @@ async function getProduct(key) {
 		price: product.price
 	};
 }
+/** 订阅方案/商品价格（key 未配置则抛错；product 忽略 months） */
+async function price(key, opts) {
+	return priceImpl(await getConfig(), key, opts);
+}
+/** 订阅方案列表（含逐档价格表，可按档位区间过滤） */
+async function listPlans(opts) {
+	return listPlansImpl(await getConfig(), opts);
+}
+/** 固定商品列表 */
+async function listProducts() {
+	return listProductsImpl(await getConfig());
+}
+/** 单个固定商品（未配置返回 null） */
+async function getProduct(key) {
+	return getProductImpl(await getConfig(), key);
+}
+/** 同步版 price：需已 configure(config)，否则抛错 */
+function priceSync(key, opts) {
+	return priceImpl(getConfigSync(), key, opts);
+}
+/** 同步版 listPlans：需已 configure(config)，否则抛错 */
+function listPlansSync(opts) {
+	return listPlansImpl(getConfigSync(), opts);
+}
+/** 同步版 listProducts：需已 configure(config)，否则抛错 */
+function listProductsSync() {
+	return listProductsImpl(getConfigSync());
+}
+/** 同步版 getProduct：需已 configure(config)，否则抛错 */
+function getProductSync(key) {
+	return getProductImpl(getConfigSync(), key);
+}
 //#endregion
 //#region src/verify.ts
 /**
@@ -273,12 +310,7 @@ async function verify(payload, opts) {
 }
 //#endregion
 //#region src/order.ts
-/**
-* 按 order.plan_id 匹配配置并给出该单应收金额（应用做金额核对的辅助）
-* 匹配不到返回 null（应用记 rejected）
-*/
-async function resolveOrder(order) {
-	const cfg = await getConfig();
+function resolveOrderImpl(cfg, order) {
 	const planHit = Object.entries(cfg.plans).find(([, entry]) => entry.plan_id === order.plan_id);
 	if (planHit) {
 		const [key, entry] = planHit;
@@ -311,13 +343,7 @@ async function resolveOrder(order) {
 	}
 	return null;
 }
-/**
-* 生成爱发电下单跳转 URL
-* - plans entry：product_type=0，months 默认 1（非法档位抛错）
-* - products entry：product_type=1，不带 month
-*/
-async function buildUrl(opts) {
-	const cfg = await getConfig();
+function buildUrlImpl(cfg, opts) {
 	const plan = cfg.plans[opts.entry];
 	if (plan) {
 		const months = opts.months ?? 1;
@@ -341,6 +367,29 @@ async function buildUrl(opts) {
 	})}`;
 	throw new Error(`未找到配置项: ${opts.entry}`);
 }
+/**
+* 按 order.plan_id 匹配配置并给出该单应收金额（应用做金额核对的辅助）
+* 匹配不到返回 null（应用记 rejected）
+*/
+async function resolveOrder(order) {
+	return resolveOrderImpl(await getConfig(), order);
+}
+/**
+* 生成爱发电下单跳转 URL
+* - plans entry：product_type=0，months 默认 1（非法档位抛错）
+* - products entry：product_type=1，不带 month
+*/
+async function buildUrl(opts) {
+	return buildUrlImpl(await getConfig(), opts);
+}
+/** 同步版 resolveOrder */
+function resolveOrderSync(order) {
+	return resolveOrderImpl(getConfigSync(), order);
+}
+/** 同步版 buildUrl */
+function buildUrlSync(opts) {
+	return buildUrlImpl(getConfigSync(), opts);
+}
 //#endregion
 //#region src/handler.ts
 /**
@@ -421,4 +470,4 @@ function createWebhookHandler(deps) {
 	};
 }
 //#endregion
-export { AFDIAN_PUBLIC_KEY, DISCOUNTS, MONTH_TIERS, buildSignStr, buildUrl, calcPlanPrice, calcTiers, configure, createWebhookHandler, defineConfig, getProduct, listPlans, listProducts, price, resetConfig, resolveOrder, verify };
+export { AFDIAN_PUBLIC_KEY, DISCOUNTS, MONTH_TIERS, buildSignStr, buildUrl, buildUrlSync, calcPlanPrice, calcTiers, configure, createWebhookHandler, defineConfig, getConfig, getConfigSync, getProduct, getProductSync, listPlans, listPlansSync, listProducts, listProductsSync, price, priceSync, resetConfig, resolveOrder, resolveOrderSync, verify };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "afdian-kit",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "爱发电通用工具库：价格算法 / 验签 / 下单跳转 / 配置查询（零依赖 · 无数据库）",
   "type": "module",
   "exports": {