@aitlabs/namkwong 0.0.92

package/dist/dynamic-env/db.schemas.d.ts

@@ -0,0 +1,182 @@
+/**
+ * 动态环境变量 Select Schema
+ */
+export declare const dynamicEnvSelectSchema: import("drizzle-typebox").BuildSchema<"select", {
+    createdAt: import("drizzle-orm/pg-core").PgColumn<{
+        name: "created_at";
+        tableName: "dynamic_env";
+        dataType: "date";
+        columnType: "PgTimestamp";
+        data: Date;
+        driverParam: string;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+        name: "updated_at";
+        tableName: "dynamic_env";
+        dataType: "date";
+        columnType: "PgTimestamp";
+        data: Date;
+        driverParam: string;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    key: import("drizzle-orm/pg-core").PgColumn<{
+        name: "key";
+        tableName: "dynamic_env";
+        dataType: "string";
+        columnType: "PgText";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: true;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    value: import("drizzle-orm/pg-core").PgColumn<{
+        name: "value";
+        tableName: "dynamic_env";
+        dataType: "string";
+        columnType: "PgText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    description: import("drizzle-orm/pg-core").PgColumn<{
+        name: "description";
+        tableName: "dynamic_env";
+        dataType: "string";
+        columnType: "PgText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+}, undefined>;
+export type DynamicEnvSelectSchemaType = typeof dynamicEnvSelectSchema.static;
+/**
+ * 动态环境变量 Insert Schema
+ */
+export declare const dynamicEnvInsertSchema: import("drizzle-typebox").BuildSchema<"insert", {
+    createdAt: import("drizzle-orm/pg-core").PgColumn<{
+        name: "created_at";
+        tableName: "dynamic_env";
+        dataType: "date";
+        columnType: "PgTimestamp";
+        data: Date;
+        driverParam: string;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+        name: "updated_at";
+        tableName: "dynamic_env";
+        dataType: "date";
+        columnType: "PgTimestamp";
+        data: Date;
+        driverParam: string;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    key: import("drizzle-orm/pg-core").PgColumn<{
+        name: "key";
+        tableName: "dynamic_env";
+        dataType: "string";
+        columnType: "PgText";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: true;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    value: import("drizzle-orm/pg-core").PgColumn<{
+        name: "value";
+        tableName: "dynamic_env";
+        dataType: "string";
+        columnType: "PgText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    description: import("drizzle-orm/pg-core").PgColumn<{
+        name: "description";
+        tableName: "dynamic_env";
+        dataType: "string";
+        columnType: "PgText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+}, undefined>;
+export type DynamicEnvInsertSchemaType = typeof dynamicEnvInsertSchema.static;

package/dist/dynamic-env/dto.schema.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 动态环境变量 Schema（使用 TypeBox）
+ * 集成：类型定义 + 验证规则 + 默认值
+ */
+export declare const dynamicEnvSchema: import("@sinclair/typebox").TObject<{
+    /** 万能验证码（6位数字，用于运营快速登录） */
+    FIXED_OTP_CODE: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /** 维护模式开关 */
+    MAINTENANCE_MODE: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"true">, import("@sinclair/typebox").TLiteral<"false">]>>;
+}>;
+export type DynamicEnvSchemaType = typeof dynamicEnvSchema.static;
+export type DynamicEnvKey = keyof DynamicEnvSchemaType;
+export declare const dynamicEnvSchemaDefaults: Required<DynamicEnvSchemaType>;
+/**
+ * 验证配置值
+ */
+export declare function validateDynamicEnvValue(key: DynamicEnvKey, value: unknown): boolean;

package/dist/dynamic-env/errors/index.d.ts

@@ -0,0 +1,11 @@
+export * from './locales/zh';
+export declare const DynamicEnvErrorCodes: {
+    readonly DYNAMIC_ENV_KEY_REQUIRED: 'DYNAMIC_ENV_KEY_REQUIRED';
+    readonly DYNAMIC_ENV_VALUE_INVALID: 'DYNAMIC_ENV_VALUE_INVALID';
+};
+type DynamicEnvErrorCodesType = typeof DynamicEnvErrorCodes;
+export type DynamicEnvErrorCode = keyof DynamicEnvErrorCodesType;
+declare module '../../error/errorcode' {
+    interface ErrorCodeRegistry extends DynamicEnvErrorCodesType {
+    }
+}

package/dist/dynamic-env/errors/locales/zh.d.ts

@@ -0,0 +1,10 @@
+export declare const zh: {
+    DYNAMIC_ENV_KEY_REQUIRED: string;
+    DYNAMIC_ENV_VALUE_INVALID: string;
+};
+type ZHType = typeof zh;
+declare module '../../../error/messages' {
+    interface ErrorMessageRegistry extends ZHType {
+    }
+}
+export {};

package/dist/dynamic-env/index.d.ts

@@ -0,0 +1,3 @@
+export { dynamicEnv } from './cache';
+export * from './dto.schema';
+export * from './service';

package/dist/dynamic-env/schema.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 动态环境变量表
+ * 用于存储运行时可修改的配置项
+ */
+export declare const dynamicEnv: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "dynamic_env";
+    schema: undefined;
+    columns: {
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "dynamic_env";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "dynamic_env";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        key: import("drizzle-orm/pg-core").PgColumn<{
+            name: "key";
+            tableName: "dynamic_env";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        value: import("drizzle-orm/pg-core").PgColumn<{
+            name: "value";
+            tableName: "dynamic_env";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        description: import("drizzle-orm/pg-core").PgColumn<{
+            name: "description";
+            tableName: "dynamic_env";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: 'pg';
+}>;

package/dist/dynamic-env/service.d.ts

@@ -0,0 +1,93 @@
+import type { DynamicEnvKey } from './dto.schema';
+/**
+ * 动态环境变量基础服务（抽象类）
+ * 提供共享的验证方法
+ */
+declare abstract class BaseDynamicEnvService {
+    protected static validateKey(key: string): void;
+}
+/**
+ * 管理员侧动态环境变量服务
+ * 管理员可以查看、更新、删除所有配置
+ * Service 层统一管理 DB + Cache，自动同步
+ */
+export declare abstract class AdminDynamicEnvService extends BaseDynamicEnvService {
+    /**
+     * 获取所有配置
+     */
+    static getAllConfigs(): Promise<{
+        createdAt: Date;
+        updatedAt: Date;
+        key: string;
+        value: string | null;
+        description: string | null;
+    }[]>;
+    /**
+     * 获取单个配置
+     */
+    static getConfig(key: DynamicEnvKey): Promise<{
+        key: "FIXED_OTP_CODE" | "MAINTENANCE_MODE";
+        value: string | null | undefined;
+    }>;
+    /**
+     * 更新配置
+     * 自动刷新缓存
+     */
+    static updateConfig(key: DynamicEnvKey, value: string): Promise<{
+        success: boolean;
+        key: "FIXED_OTP_CODE" | "MAINTENANCE_MODE";
+        value: string;
+    }>;
+    /**
+     * 删除配置
+     * 自动刷新缓存
+     */
+    static deleteConfig(key: DynamicEnvKey): Promise<{
+        success: boolean;
+        key: "FIXED_OTP_CODE" | "MAINTENANCE_MODE";
+    }>;
+    /**
+     * 重新生成万能验证码
+     * 自动刷新缓存
+     */
+    static regenerateOTP(): Promise<{
+        success: boolean;
+        otpCode: string;
+    }>;
+    /**
+     * 手动刷新缓存
+     */
+    static reloadCache(): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+}
+/**
+ * 内部服务（供其他模块调用）
+ * 无权限控制，仅供内部使用
+ */
+export declare abstract class InternalDynamicEnvService extends BaseDynamicEnvService {
+    /**
+     * 获取配置值（仅数据库值，不含默认值）
+     * 用于判断配置是否被显式设置
+     * 首次访问会自动加载配置
+     */
+    static get(key: DynamicEnvKey): Promise<string | undefined>;
+    /**
+     * 获取配置值或默认值（推荐）
+     * 优先返回数据库值，不存在时返回 schema 默认值
+     * 首次访问会自动加载配置
+     */
+    static getOrDefault(key: DynamicEnvKey): Promise<string | undefined>;
+    /**
+     * 获取所有配置（从数据库读取）
+     */
+    static getAll(): Promise<{
+        createdAt: Date;
+        updatedAt: Date;
+        key: string;
+        value: string | null;
+        description: string | null;
+    }[]>;
+}
+export {};

package/dist/email/index.d.ts

@@ -0,0 +1,2 @@
+import type { SendMailOptions } from 'nodemailer';
+export declare function sendEmail(opts: SendMailOptions): Promise<import("nodemailer/lib/smtp-transport").SentMessageInfo>;

package/dist/env/client.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/dist/env/index.d.ts

@@ -0,0 +1,2 @@
+export { default as envClient } from './client';
+export { default as envServer } from './server';

package/dist/env/server.d.ts

@@ -0,0 +1,45 @@
+declare const _default: {
+    POSTGRES_USER: string;
+    POSTGRES_PASSWORD: string;
+    POSTGRES_DB: string;
+    POSTGRES_HOST: string;
+    POSTGRES_PORT: number;
+    TZ?: string | undefined;
+    PGTZ?: string | undefined;
+    DEBUG: boolean;
+    NODE_ENV: "development" | "production" | "test";
+    LOG_LEVEL?: "debug" | "error" | "info" | "warn" | undefined;
+    ASSET_PRICE_RETENTION_MONTHS?: number | undefined;
+    HTTP_ACCESS_LOG?: boolean | undefined;
+    ALLOWED_ORIGINS?: string[] | undefined;
+    FEATURE_FLAGS?: string[] | undefined;
+    API_PORT: number;
+    BETTER_AUTH_SECRETS: string;
+    BETTER_AUTH_URL: string;
+    BETTER_AUTH_TRUSTED_ORIGINS: string;
+    BETTER_AUTH_CROSS_SUB_DOMAIN_COOKIES_ENABLED: boolean;
+    BETTER_AUTH_CROSS_SUB_DOMAIN_COOKIES_DOMAIN: string;
+    SMTP_HOST: string;
+    SMTP_PORT: number;
+    SMTP_USER: string;
+    SMTP_PASS: string;
+    SUPER_ADMIN_USERNAME: string;
+    SUPER_ADMIN_NAME: string;
+    SUPER_ADMIN_EMAIL: string;
+    SUPER_ADMIN_PASSWORD: string;
+    S3_PRIVATE_ACCESS_KEY_ID: string;
+    S3_PRIVATE_SECRET_ACCESS_KEY: string;
+    S3_PRIVATE_REGION: string;
+    S3_PRIVATE_BUCKET: string;
+    S3_PRIVATE_ENDPOINT?: string | undefined;
+    S3_PRIVATE_SESSION_TOKEN?: string | undefined;
+    S3_PUBLIC_ACCESS_KEY_ID: string;
+    S3_PUBLIC_SECRET_ACCESS_KEY: string;
+    S3_PUBLIC_REGION: string;
+    S3_PUBLIC_BUCKET: string;
+    S3_PUBLIC_ENDPOINT?: string | undefined;
+    S3_PUBLIC_SESSION_TOKEN?: string | undefined;
+    FIXED_OTP_CODE?: string | undefined;
+    EXTERNAL_API_KEY: string;
+};
+export default _default;

package/dist/env/typebox-env.d.ts

@@ -0,0 +1,7 @@
+import { type Static, type TObject } from '@sinclair/typebox';
+type TypeboxEnvOptions<TSchemaType extends TObject> = {
+    env?: Record<string, string | undefined>;
+    arraySeparator?: string;
+};
+export declare function typeboxEnv<TSchemaType extends TObject>(schema: TSchemaType, options?: TypeboxEnvOptions<TSchemaType>): Static<TSchemaType>;
+export {};

package/dist/error/errorcode.d.ts

@@ -0,0 +1,9 @@
+export type ErrorCodeType = Record<string, string>;
+export interface ErrorCodeRegistry {
+}
+export declare const ErrorCodeEnum: ErrorCodeRegistry;
+export type ErrorCodeKeys = keyof ErrorCodeRegistry;
+/**
+ * 注册错误码
+ */
+export declare function registerErrorCodes(ErrorCodes: ErrorCodeType): void;

package/dist/error/index.d.ts

@@ -0,0 +1,120 @@
+import Elysia from 'elysia';
+import { type ErrorCodeKeys } from './errorcode';
+import { type SupportedLanguages } from './messages';
+interface ErrorOptions {
+    context?: any;
+    lang?: SupportedLanguages;
+}
+/**
+ * 创建业务错误对象
+ *
+ * ## 使用规范
+ *
+ * ### Service 层：统一使用 throw
+ * ```typescript
+ * // ✅ 正确：业务错误应该 throw
+ * if (!record) {
+ *   throw createError(ErrorCodeEnum.RESOURCE_NOT_FOUND);
+ * }
+ *
+ * // ❌ 错误：不要 return
+ * if (!record) {
+ *   return createError(ErrorCodeEnum.RESOURCE_NOT_FOUND);
+ * }
+ * ```
+ *
+ * ### 为什么使用 throw？
+ * 1. **一致性** - 所有业务错误统一处理方式
+ * 2. **事务友好** - 自动触发数据库事务回滚
+ * 3. **审计友好** - 保留完整调用栈上下文
+ * 4. **类型安全** - 不需要调整函数返回类型
+ *
+ * ### 适用场景（Service 层必须 throw）
+ * - 资源不存在（产品/用户/订单等）
+ * - 业务规则违反（状态错误/数量超限/权限不足）
+ * - 数据一致性错误（余额不足/重复提交）
+ * - 事务中的任何错误
+ *
+ * ### Router 层行为
+ * Router 层无需 try-catch，Elysia 会自动捕获并转换为 HTTP 错误响应
+ *
+ * @param code - 错误码（来自 ErrorCodeEnum）
+ * @param options - 错误选项（/context/lang）
+ * @returns 错误响应对象（配合 throw 使用）
+ */
+export declare function createError(code: ErrorCodeKeys, options?: ErrorOptions): import("elysia").ElysiaCustomStatusResponse<418, {
+    readonly code: keyof import("./errorcode").ErrorCodeRegistry;
+    readonly message: string;
+    readonly context: any;
+    readonly originalMessage: string;
+    readonly lang: "zh" | "zh-CN";
+}, 418>;
+export declare const errorMessagesRouter: Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    error_messages: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: {
+                    zh: import("./messages").ErrorMessageRegistry;
+                    'zh-CN': import("./messages").ErrorMessageRegistry;
+                };
+            };
+        };
+    };
+} & {
+    error_messages: {
+        ":lang": {
+            get: {
+                body: unknown;
+                params: {
+                    lang: "zh" | "zh-CN";
+                };
+                query: unknown;
+                headers: unknown;
+                response: {
+                    200: import("./messages").ErrorMessageRegistry;
+                    422: {
+                        type: 'validation';
+                        on: string;
+                        summary?: string;
+                        message?: string;
+                        found?: unknown;
+                        property?: string;
+                        expected?: string;
+                    };
+                };
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
+export {};

package/dist/error/locales/zh.d.ts

@@ -0,0 +1,2 @@
+import type { ErrorMessageRegistry } from '../messages';
+export declare const zh: ErrorMessageRegistry;

package/dist/error/messages.d.ts

@@ -0,0 +1,10 @@
+import type { ErrorCodeKeys } from './errorcode';
+export interface ErrorMessageRegistry extends Record<ErrorCodeKeys, string> {
+}
+export declare const ErrorMessages: {
+    zh: ErrorMessageRegistry;
+    'zh-CN': ErrorMessageRegistry;
+};
+export declare const supportedLanguages: Array<keyof typeof ErrorMessages>;
+export type SupportedLanguages = keyof typeof ErrorMessages;
+export declare function registerErrorMessages(lang: SupportedLanguages, messages: Record<string, string>): void;