@downcity/services 0.1.6

package/README.md

@@ -0,0 +1,47 @@
+# @downcity/services
+
+Downcity 官方服务聚合包。
+
+这个包统一提供账号、余额、usage 与 Stripe 支付四类官方服务，避免业务侧分别安装多个 `service-*` 包。
+
+## 安装
+
+```bash
+pnpm add @downcity/services
+```
+
+## 使用
+
+```ts
+import {
+  accountsService,
+  balanceService,
+  paymentService,
+  stripePaymentMethod,
+  stripePaymentService,
+  usageService,
+  type StripePaymentServiceBalanceBridge,
+} from "@downcity/services";
+```
+
+产品侧通常先这样读取支付方式：
+
+```ts
+const methods = await guest.service("payment").get("methods");
+```
+
+再根据返回结果调用具体支付方式，例如：
+
+```ts
+const checkout = await user.service("payment.stripe").action("checkout/create").invoke({
+  topup_id: "topup_demo",
+});
+```
+
+## 包含的服务
+
+- `accountsService()`：注册、登录、邮箱验证、GitHub/Google OAuth 与 `user_token` 签发
+- `balanceService()`：全局余额账户、流水、充值单与兑换码
+- `paymentService()`：统一暴露当前 InfraRuntime 可用的支付方式列表
+- `usageService()`：记录真实用户侧 service 调用事件
+- `stripePaymentService()`：把 Stripe 一次性支付同步成 balance topup 到账

package/bin/accounts/db.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Accounts 服务数据库辅助模块。
+ *
+ * 兼容 D1 与 better-sqlite3 两种 statement 形态，
+ * 给服务内部统一提供 first / all / run 能力。
+ */
+/**
+ * 读取单行结果。
+ */
+export declare function readPreparedFirst(statement: any, params: unknown[]): Promise<Record<string, unknown> | null>;
+/**
+ * 读取多行结果。
+ */
+export declare function readPreparedAll(statement: any, params: unknown[]): Promise<Record<string, unknown>[]>;
+/**
+ * 执行写操作。
+ */
+export declare function runPrepared(statement: any, params: unknown[]): Promise<void>;
+//# sourceMappingURL=db.d.ts.map

package/bin/accounts/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/accounts/db.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,GAAG,EACd,MAAM,EAAE,OAAO,EAAE,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAmBzC;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,GAAG,EACd,MAAM,EAAE,OAAO,EAAE,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAiBpC;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAelF"}

package/bin/accounts/db.js

@@ -0,0 +1,68 @@
+/**
+ * Accounts 服务数据库辅助模块。
+ *
+ * 兼容 D1 与 better-sqlite3 两种 statement 形态，
+ * 给服务内部统一提供 first / all / run 能力。
+ */
+/**
+ * 读取单行结果。
+ */
+export async function readPreparedFirst(statement, params) {
+    if (typeof statement.bind === "function") {
+        const bound = statement.bind(...params);
+        if (typeof bound.first === "function") {
+            return await bound.first();
+        }
+        if (typeof bound.get === "function") {
+            return await bound.get();
+        }
+    }
+    if (typeof statement.first === "function") {
+        return await statement.first(...params);
+    }
+    if (typeof statement.get === "function") {
+        return await statement.get(...params);
+    }
+    throw new Error("Unsupported database statement for first()");
+}
+/**
+ * 读取多行结果。
+ */
+export async function readPreparedAll(statement, params) {
+    if (typeof statement.bind === "function") {
+        const bound = statement.bind(...params);
+        if (typeof bound.all === "function") {
+            const result = await bound.all();
+            if (Array.isArray(result))
+                return result;
+            if (Array.isArray(result?.results))
+                return result.results;
+        }
+    }
+    if (typeof statement.all === "function") {
+        const result = await statement.all(...params);
+        if (Array.isArray(result))
+            return result;
+        if (Array.isArray(result?.results))
+            return result.results;
+    }
+    throw new Error("Unsupported database statement for all()");
+}
+/**
+ * 执行写操作。
+ */
+export async function runPrepared(statement, params) {
+    if (typeof statement.bind === "function") {
+        const bound = statement.bind(...params);
+        if (typeof bound.run === "function") {
+            await bound.run();
+            return;
+        }
+    }
+    if (typeof statement.run === "function") {
+        await statement.run(...params);
+        return;
+    }
+    throw new Error("Unsupported database statement for run()");
+}
+//# sourceMappingURL=db.js.map

package/bin/accounts/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/accounts/db.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAc,EACd,MAAiB;IAEjB,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QACxC,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACtC,OAAO,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7B,CAAC;QACD,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;YACpC,OAAO,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAC1C,OAAO,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,OAAO,SAAS,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QACxC,OAAO,MAAM,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAc,EACd,MAAiB;IAEjB,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QACxC,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAmC,CAAC;YACtE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;gBAAE,OAAO,MAAM,CAAC,OAAoC,CAAC;QACzF,CAAC;IACH,CAAC;IAED,IAAI,OAAO,SAAS,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;QAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,MAAmC,CAAC;QACtE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;YAAE,OAAO,MAAM,CAAC,OAAoC,CAAC;IACzF,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,SAAc,EAAE,MAAiB;IACjE,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QACxC,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;YACpC,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;IACH,CAAC;IAED,IAAI,OAAO,SAAS,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QACxC,MAAM,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;AAC9D,CAAC"}

package/bin/accounts/index.d.ts

@@ -0,0 +1,348 @@
+/**
+ * Downcity 官方 Accounts 服务。
+ *
+ * 设计边界：
+ * - better-auth 作为认证事实源，统一落到 `auth_users/auth_accounts/auth_sessions/auth_verifications`
+ * - 服务自己只维护 `auth_profiles`
+ * - OAuth 为兼容当前 CLI 轮询交互，保留自定义 callback 外壳
+ */
+import { InstallableService } from "@downcity/infra";
+import type { ServiceInstallContext } from "@downcity/infra";
+/**
+ * Accounts 服务配置。
+ */
+export interface AccountsServiceOptions {
+    /**
+     * 登录、验证邮箱或 OAuth 完成后签发的 InfraRuntime user_token 有效期。
+     */
+    token_ttl?: string;
+    /**
+     * 自定义验证邮件发送函数。
+     */
+    sendEmail?: (params: {
+        to: string;
+        subject: string;
+        text: string;
+    }) => Promise<void>;
+}
+export declare class AccountsService extends InstallableService {
+    private readonly options;
+    readonly id = "accounts";
+    readonly name = "Accounts";
+    readonly version = "0.4.0";
+    readonly schema: {
+        profile: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+            name: "auth_profiles";
+            schema: undefined;
+            columns: {
+                user_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "user_id";
+                    tableName: "auth_profiles";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: true;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                email: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "email";
+                    tableName: "auth_profiles";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                display_name: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "display_name";
+                    tableName: "auth_profiles";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                avatar_url: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "avatar_url";
+                    tableName: "auth_profiles";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                bio: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "bio";
+                    tableName: "auth_profiles";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                created_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "created_at";
+                    tableName: "auth_profiles";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                updated_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "updated_at";
+                    tableName: "auth_profiles";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+            };
+            dialect: "sqlite";
+        }>;
+        oauth_states: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+            name: "service_accounts_oauth_states";
+            schema: undefined;
+            columns: {
+                state: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "state";
+                    tableName: "service_accounts_oauth_states";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: true;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                product_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "product_id";
+                    tableName: "service_accounts_oauth_states";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                provider: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "provider";
+                    tableName: "service_accounts_oauth_states";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                user_token: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "user_token";
+                    tableName: "service_accounts_oauth_states";
+                    dataType: "string";
+                    columnType: "SQLiteText";
+                    data: string;
+                    driverParam: string;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: [string, ...string[]];
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {
+                    length: number | undefined;
+                }>;
+                created_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "created_at";
+                    tableName: "service_accounts_oauth_states";
+                    dataType: "number";
+                    columnType: "SQLiteInteger";
+                    data: number;
+                    driverParam: number;
+                    notNull: true;
+                    hasDefault: false;
+                    isPrimaryKey: false;
+                    isAutoincrement: false;
+                    hasRuntimeDefault: false;
+                    enumValues: undefined;
+                    baseColumn: never;
+                    identity: undefined;
+                    generated: undefined;
+                }, {}, {}>;
+            };
+            dialect: "sqlite";
+        }>;
+    };
+    private auth;
+    constructor(options: AccountsServiceOptions);
+    _onInit(): Promise<void>;
+    install(ctx: ServiceInstallContext): void;
+    /**
+     * 获取 better-auth 的 HTTP handler。
+     */
+    getAuthHandler(): (request: Request) => Promise<Response>;
+    /**
+     * OAuth 回调处理。
+     */
+    handleOAuthCallback(request: Request): Promise<Response>;
+    /**
+     * 列出可用登录方式。
+     */
+    private listProviders;
+    /**
+     * 获取 provider 配置。
+     */
+    private getOAuthProviderConfig;
+    /**
+     * 当前请求环境下的 OAuth callback URL。
+     */
+    private getOAuthCallbackURL;
+    /**
+     * 确保 OAuth 用户落库到 better-auth 认证表，并同步 `auth_profiles`。
+     */
+    private ensureOAuthAuthUser;
+    /**
+     * 创建 OAuth state。
+     */
+    private createOAuthState;
+    /**
+     * 读取 OAuth state。
+     */
+    private readOAuthState;
+    /**
+     * 回填 OAuth state 的 InfraRuntime token。
+     */
+    private resolveOAuthState;
+    /**
+     * 按 ID 读取认证用户。
+     */
+    private findAuthUserById;
+    /**
+     * 按邮箱读取认证用户。
+     */
+    private findAuthUserByEmail;
+    /**
+     * 读取一条 user profile。
+     */
+    private readProfile;
+    /**
+     * upsert user profile。
+     */
+    private upsertProfile;
+    /**
+     * 管理侧用户列表。
+     */
+    private listUsers;
+    /**
+     * 管理侧 session 列表。
+     */
+    private listSessions;
+    /**
+     * 创建原始 statement。
+     */
+    private rawPrepare;
+}
+/**
+ * 创建 Accounts 服务实例。
+ */
+export declare function accountsService(options?: AccountsServiceOptions): InstallableService;
+//# sourceMappingURL=index.d.ts.map

package/bin/accounts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/accounts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AA+B7D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtF;AAuFD,qBAAa,eAAgB,SAAQ,kBAAkB;IAWzC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAVpC,QAAQ,CAAC,EAAE,cAAc;IACzB,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAGb;IAEF,OAAO,CAAC,IAAI,CAAiC;gBAEhB,OAAO,EAAE,sBAAsB;IAkBtD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAuC9B,OAAO,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI;IA2OzC;;OAEG;IACH,cAAc;IAId;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiD9D;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;YACW,mBAAmB;IA8FjC;;OAEG;YACW,gBAAgB;IAO9B;;OAEG;YACW,cAAc;IAa5B;;OAEG;YACW,iBAAiB;IAO/B;;OAEG;YACW,gBAAgB;IAO9B;;OAEG;YACW,mBAAmB;IAOjC;;OAEG;YACW,WAAW;IAOzB;;OAEG;YACW,aAAa;IA4B3B;;OAEG;YACW,SAAS;IAyBvB;;OAEG;YACW,YAAY;IAW1B;;OAEG;IACH,OAAO,CAAC,UAAU;CAGnB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,kBAAkB,CAExF"}