@visiblebase/core 0.2.0

package/bin/service/service.js

@@ -0,0 +1,114 @@
+/**
+ * Service — SDK 核心单元。
+ *
+ * 每个 Service = 路由 + 数据库表 + hook + 自初始化。
+ * 只有一个 Context 类型，所有 handler 共用。
+ * Service 需要的基础设施（DB、Auth、Env）由 Base 直接设为属性。
+ */
+import { Hook } from "./hook.js";
+// ===========================================================================
+// Service
+// ===========================================================================
+export class Service {
+    id;
+    name;
+    hook = new Hook();
+    tables;
+    env;
+    /**
+     * 数据库查询接口（Base 初始化后设置）。
+     */
+    _db;
+    /** 数据库底层连接，用于 DDL（Base 初始化后设置） */
+    _client;
+    /**
+     * 鉴权器（Base 初始化后设置）。
+     */
+    _authenticator;
+    /**
+     * Runtime 环境变量（Base 初始化后设置）。
+     */
+    _env;
+    routes = [];
+    constructor(options) {
+        this.id = options.id;
+        this.name = options.name ?? options.id;
+        this.tables = options.tables;
+        this.env = options.env;
+    }
+    // ========== 生命周期 ==========
+    /**
+     * 初始化回调（可选）。Base 在设置 _database/_client/_authenticator/_env 后调用。
+     * Service 在此创建自己的 Store、种子数据等。默认空实现。
+     */
+    async _onInit() { }
+    // ========== 路由快捷方法 ==========
+    get(path, handler, opts) {
+        return this._add("GET", path, handler, opts);
+    }
+    post(path, handler, opts) {
+        return this._add("POST", path, handler, opts);
+    }
+    put(path, handler, opts) {
+        return this._add("PUT", path, handler, opts);
+    }
+    patch(path, handler, opts) {
+        return this._add("PATCH", path, handler, opts);
+    }
+    delete(path, handler, opts) {
+        return this._add("DELETE", path, handler, opts);
+    }
+    // ========== 内部方法 ==========
+    _listRoutes() {
+        return this.routes;
+    }
+    _add(method, path, handler, opts) {
+        this.routes.push({
+            method,
+            path: normalizeRoutePath(path),
+            auth: opts?.auth ?? "user",
+            handler: wrapHandler(handler, this),
+        });
+        return this;
+    }
+}
+// ===========================================================================
+// wrapHandler
+// ===========================================================================
+function wrapHandler(handler, service) {
+    return async (routeCtx) => {
+        const input = routeCtx.request.method === "GET" ? {} : await routeCtx.json();
+        const db = {};
+        if (service.tables) {
+            for (const name of Object.keys(service.tables)) {
+                db[name] = await routeCtx.table(name);
+            }
+        }
+        const result = await handler({
+            input, db,
+            user: routeCtx.user,
+            product: routeCtx.product,
+            request: routeCtx.request,
+            env: (key) => routeCtx.env(key),
+        });
+        if (result instanceof Response)
+            return result;
+        return routeCtx.jsonResponse(result, 200);
+    };
+}
+// ===========================================================================
+// 工具
+// ===========================================================================
+function normalizeRoutePath(pathname) {
+    const trimmed = pathname.trim();
+    if (!trimmed || trimmed === "/")
+        return "/";
+    return `/${trimmed.replace(/^\/+/, "").replace(/\/+$/, "")}`;
+}
+export function serviceRouteFullPath(serviceId, route) {
+    const prefix = route.auth === "admin"
+        ? `/api/admin/services/${serviceId}`
+        : `/v1/services/${serviceId}`;
+    return route.path === "/" ? prefix : `${prefix}${route.path}`;
+}
+//# sourceMappingURL=service.js.map

package/bin/service/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/service/service.ts"],"names":[],"mappings":"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"}

package/bin/service/types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Service 公共类型。
+ */
+import type { Context } from "./service.js";
+/**
+ * Hook 回调函数。
+ *
+ * before/after 可返回新 Context 替换当前；onError 返回值被忽略。
+ */
+export type HookFn = (ctx: Context) => void | Context | Promise<void | Context>;
+/**
+ * AI 模型 handler。
+ *
+ * 接收 Context（含 model 信息），返回结果或 Response（streaming）。
+ */
+export type ServiceHandler<TResult = unknown> = (ctx: Context) => TResult | Promise<TResult>;
+//# sourceMappingURL=types.d.ts.map

package/bin/service/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/service/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;GAIG;AACH,MAAM,MAAM,MAAM,GAAG,CACnB,GAAG,EAAE,OAAO,KACT,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,OAAO,GAAG,OAAO,IAAI,CAC9C,GAAG,EAAE,OAAO,KACT,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC"}

package/bin/service/types.js

@@ -0,0 +1,5 @@
+/**
+ * Service 公共类型。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/bin/service/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/service/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/bin/store/db.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 数据库连接接口模块。
+ *
+ * 定义 Database / DbClient 抽象接口和 executeDDL 工具函数。
+ * 不包含任何运行时特定的数据库驱动（驱动由 @visiblebase/node 等适配器提供）。
+ */
+import type { SQL } from "drizzle-orm";
+/**
+ * 底层数据库客户端接口。
+ *
+ * SQLite 用 exec()（同步），Postgres 用 unsafe()（异步）。
+ * 适配器只需要提供其中一个方法即可。
+ */
+export interface DbClient {
+    /** SQLite 同步执行 DDL */
+    exec?(sql: string): void;
+    /** Postgres 异步执行 DDL */
+    unsafe?(sql: string, params?: unknown[]): Promise<unknown>;
+    /** 关闭连接（可选） */
+    close?(): void;
+    /** 关闭连接（异步，可选） */
+    end?(): Promise<void>;
+}
+interface Query extends Promise<Record<string, unknown>[]> {
+    where(cond: SQL | undefined): Query;
+    orderBy(...cols: unknown[]): Query;
+    limit(n: number): Query;
+}
+/**
+ * Drizzle select / insert / update / delete 的公共子集。
+ *
+ * 所有 Drizzle 方言实例这 4 个方法签名完全相同，
+ * 只是泛型参数不同。此接口用 unknown 替代泛型参数，
+ * 返回值用具体类型。各 Store 构造时从 DrizzleDB 转一次。
+ */
+export interface Database {
+    select(): {
+        from(t: unknown): Query;
+    };
+    insert(t: unknown): {
+        values(v: Record<string, unknown> | Record<string, unknown>[]): Promise<void>;
+    };
+    update(t: unknown): {
+        set(v: Record<string, unknown>): {
+            where(c: SQL | undefined): Promise<number>;
+        };
+    };
+    delete(t: unknown): {
+        where(c: SQL | undefined): Promise<number>;
+    };
+}
+/**
+ * 执行 DDL 语句。
+ *
+ * 自动适配同步（SQLite exec）和异步（Postgres unsafe）两种驱动。
+ *
+ * @param db - 包含 $client 的数据库实例
+ * @param ddl - 要执行的 DDL SQL 字符串
+ */
+export declare function executeDDL(db: {
+    $client: DbClient;
+}, ddl: string): Promise<void>;
+export {};
+//# sourceMappingURL=db.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/store/db.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAMvC;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,sBAAsB;IACtB,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,wBAAwB;IACxB,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,eAAe;IACf,KAAK,CAAC,IAAI,IAAI,CAAC;IACf,kBAAkB;IAClB,GAAG,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAMD,UAAU,KAAM,SAAQ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACxD,KAAK,CAAC,IAAI,EAAE,GAAG,GAAG,SAAS,GAAG,KAAK,CAAC;IACpC,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IACnC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACzB;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,IAAI;QAAE,IAAI,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;KAAE,CAAC;IACtC,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG;QAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IACtG,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG;QAAE,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;YAAE,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;IACxG,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG;QAAE,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;CACpE;AAMD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAItF"}

package/bin/store/db.js

@@ -0,0 +1,28 @@
+/**
+ * 数据库连接接口模块。
+ *
+ * 定义 Database / DbClient 抽象接口和 executeDDL 工具函数。
+ * 不包含任何运行时特定的数据库驱动（驱动由 @visiblebase/node 等适配器提供）。
+ */
+// ===========================================================================
+// executeDDL
+// ===========================================================================
+/**
+ * 执行 DDL 语句。
+ *
+ * 自动适配同步（SQLite exec）和异步（Postgres unsafe）两种驱动。
+ *
+ * @param db - 包含 $client 的数据库实例
+ * @param ddl - 要执行的 DDL SQL 字符串
+ */
+export async function executeDDL(db, ddl) {
+    const c = db.$client;
+    if (typeof c?.exec === "function") {
+        c.exec(ddl);
+        return;
+    }
+    if (typeof c?.unsafe === "function") {
+        await c.unsafe(ddl);
+    }
+}
+//# sourceMappingURL=db.js.map

package/bin/store/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/store/db.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqDH,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,EAAyB,EAAE,GAAW;IACrE,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC;IACrB,IAAI,OAAO,CAAC,EAAE,IAAI,KAAK,UAAU,EAAE,CAAC;QAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IAC3D,IAAI,OAAO,CAAC,EAAE,MAAM,KAAK,UAAU,EAAE,CAAC;QAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAAC,CAAC;AAC/D,CAAC"}

package/bin/store/table-api.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 通用表操作模块。
+ *
+ * 基于 Drizzle query builder 提供动态用户表的 CRUD。
+ * 构造时做一次 Database 转换，后续方法零类型断言。
+ */
+import type { AnyPgTable } from "drizzle-orm/pg-core";
+import type { AnySQLiteTable } from "drizzle-orm/sqlite-core";
+import type { Database } from "./db.js";
+export interface BaseTableApi<TRow = Record<string, unknown>> {
+    /** 表在数据库中的真实名称 */
+    readonly name: string;
+    /** 原始 Drizzle table 对象 */
+    readonly schema: AnySQLiteTable | AnyPgTable;
+    /** 读取表数据 */
+    select(where?: Partial<TRow>): Promise<TRow[]>;
+    /** 插入一行或多行数据 */
+    insert(values: Partial<TRow> | Partial<TRow>[]): Promise<void>;
+    /** 按 where 等值条件更新数据 */
+    update(input: {
+        where: Partial<TRow>;
+        values: Partial<TRow>;
+    }): Promise<number>;
+    /** 按 where 等值条件删除数据 */
+    delete(where: Partial<TRow>): Promise<number>;
+}
+export declare class TableApi implements BaseTableApi {
+    readonly name: string;
+    readonly schema: AnySQLiteTable | AnyPgTable;
+    private readonly db;
+    constructor(db: Database, schema: AnySQLiteTable | AnyPgTable);
+    select(where?: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    insert(values: Record<string, unknown> | Record<string, unknown>[]): Promise<void>;
+    update(input: {
+        where: Record<string, unknown>;
+        values: Record<string, unknown>;
+    }): Promise<number>;
+    delete(where: Record<string, unknown>): Promise<number>;
+}
+/** 用户表建表 DDL */
+export declare function buildCreateUserTableSQL(table: AnySQLiteTable | AnyPgTable): string;
+//# sourceMappingURL=table-api.d.ts.map

package/bin/store/table-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-api.d.ts","sourceRoot":"","sources":["../../src/store/table-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAQ9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAOxC,MAAM,WAAW,YAAY,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,UAAU,CAAC;IAC7C,YAAY;IACZ,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,gBAAgB;IAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,uBAAuB;IACvB,MAAM,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChF,uBAAuB;IACvB,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/C;AAMD,qBAAa,QAAS,YAAW,YAAY;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,UAAU,CAAC;IAE7C,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;gBAElB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,GAAG,UAAU;IAMvD,MAAM,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAO/E,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlF,MAAM,CAAC,KAAK,EAAE;QAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,GAAG,OAAO,CAAC,MAAM,CAAC;IAWb,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAM9D;AAMD,gBAAgB;AAChB,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,GAAG,MAAM,CA4BlF"}

package/bin/store/table-api.js

@@ -0,0 +1,98 @@
+/**
+ * 通用表操作模块。
+ *
+ * 基于 Drizzle query builder 提供动态用户表的 CRUD。
+ * 构造时做一次 Database 转换，后续方法零类型断言。
+ */
+import { getTableColumns, getTableName, eq, and, } from "drizzle-orm";
+// ===========================================================================
+// TableApi — 动态用户表 CRUD
+// ===========================================================================
+export class TableApi {
+    name;
+    schema;
+    db;
+    constructor(db, schema) {
+        this.db = db;
+        this.schema = schema;
+        this.name = getTableName(schema);
+    }
+    async select(where = {}) {
+        const cond = buildCondition(this.schema, where);
+        const query = this.db.select().from(this.schema);
+        const rows = cond ? await query.where(cond) : await query;
+        return rows.map((row) => ({ ...row }));
+    }
+    async insert(values) {
+        const rows = Array.isArray(values) ? values : [values];
+        if (rows.length === 0)
+            throw new TypeError("insert() values cannot be empty");
+        await this.db.insert(this.schema).values(rows);
+    }
+    async update(input) {
+        if (Object.keys(input.values).length === 0) {
+            throw new TypeError("update() values cannot be empty");
+        }
+        const cond = buildCondition(this.schema, input.where);
+        if (!cond)
+            throw new TypeError("update() where cannot be empty");
+        // Drizzle update 返回类型因方言而异
+        const result = await this.db.update(this.schema).set(input.values).where(cond);
+        return typeof result.changes === "number" ? result.changes : Array.isArray(result) ? result.length : 0;
+    }
+    async delete(where) {
+        const cond = buildCondition(this.schema, where);
+        if (!cond)
+            throw new TypeError("delete() where cannot be empty");
+        const result = await this.db.delete(this.schema).where(cond);
+        return typeof result.changes === "number" ? result.changes : Array.isArray(result) ? result.length : 0;
+    }
+}
+// ===========================================================================
+// DDL 生成（仅在 store init 时使用）
+// ===========================================================================
+/** 用户表建表 DDL */
+export function buildCreateUserTableSQL(table) {
+    const tableName = getTableName(table);
+    const colDefs = [];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    for (const key of Object.keys(table)) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const col = table[key];
+        if (!col || typeof col.name !== "string")
+            continue;
+        const name = String(col.name);
+        const dataType = String(col.dataType ?? "string");
+        const isPrimary = Boolean(col.primary ?? false);
+        const isNotNull = Boolean(col.notNull ?? false);
+        const sqlType = dataType === "number" ? "INTEGER"
+            : dataType === "boolean" ? "INTEGER"
+                : dataType === "json" ? "TEXT"
+                    : "TEXT";
+        const parts = [`"${name}"`, sqlType];
+        if (isPrimary)
+            parts.push("PRIMARY KEY");
+        if (isNotNull && !isPrimary)
+            parts.push("NOT NULL");
+        colDefs.push(parts.join(" "));
+    }
+    if (colDefs.length === 0)
+        return "";
+    return `CREATE TABLE IF NOT EXISTS "${tableName}" (${colDefs.join(", ")})`;
+}
+// ===========================================================================
+// 内部辅助
+// ===========================================================================
+function buildCondition(table, where) {
+    const entries = Object.entries(where);
+    if (entries.length === 0)
+        return undefined;
+    const columns = getTableColumns(table);
+    return and(...entries.map(([key, value]) => {
+        const col = columns[key];
+        if (!col)
+            throw new TypeError(`Unknown column for ${getTableName(table)}: ${key}`);
+        return eq(col, value);
+    }));
+}
+//# sourceMappingURL=table-api.js.map

package/bin/store/table-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-api.js","sourceRoot":"","sources":["../../src/store/table-api.ts"],"names":[],"mappings":"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"}

package/bin/store/types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 数据库 schema 相关类型模块。
+ *
+ * 定义 Base Runtime 和用户业务表的数据库 schema 输入类型。
+ */
+import type { AnyPgTable } from "drizzle-orm/pg-core";
+import type { AnySQLiteTable } from "drizzle-orm/sqlite-core";
+/**
+ * 用户传给 Base 的业务数据库 schema。
+ *
+ * key 是业务表在 `base.table(key)` 中使用的名称，value 是 Drizzle table 对象。
+ */
+export type BaseUserSchemaInput = Record<string, AnySQLiteTable | AnyPgTable>;
+//# sourceMappingURL=types.d.ts.map

package/bin/store/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,UAAU,CAAC,CAAC"}

package/bin/store/types.js

@@ -0,0 +1,7 @@
+/**
+ * 数据库 schema 相关类型模块。
+ *
+ * 定义 Base Runtime 和用户业务表的数据库 schema 输入类型。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/bin/store/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/bin/utils/helpers.d.ts

@@ -0,0 +1,101 @@
+/**
+ * 通用工具模块。
+ *
+ * 提供 HTTP 工具函数、SQL 标识符引用、env key 校验等通用辅助。
+ * 所有错误统一抛 ErrorWithStatus，由 router 顶层的 try/catch 转成 JSON Response。
+ *
+ * 零运行时依赖，使用 Web Crypto API 替代 node:crypto。
+ */
+/**
+ * 带 HTTP 状态码的错误对象。
+ */
+export interface ErrorWithStatus extends Error {
+    /**
+     * 要返回给客户端的 HTTP 状态码。
+     */
+    statusCode?: number;
+}
+/**
+ * 从 Request body 中读取 JSON。
+ */
+export declare function readJSON<T extends object>(request: Request): Promise<T>;
+/**
+ * 从已读取的文本中解析 JSON。
+ */
+export declare function parseJSONText<T extends object>(text: string): T;
+/**
+ * 读取 Bearer token。
+ */
+export declare function bearerToken(request: Request): string | undefined;
+/**
+ * 生成 JSON Response。
+ */
+export declare function json(body: unknown, status?: number): Response;
+/**
+ * 创建带 HTTP 状态码的错误。
+ */
+export declare function httpError(statusCode: number, message: string): ErrorWithStatus;
+/**
+ * 把 unknown 错误统一成 Error。
+ */
+export declare function normalizeCaughtError(error: unknown): ErrorWithStatus;
+/**
+ * SQL 标识符引用（双引号转义）。
+ *
+ * 用于动态拼接 SQL 时安全地引用表名、列名等标识符。
+ */
+export declare function quoteIdent(value: string): string;
+/**
+ * 标准化 env key。
+ *
+ * 规则：转大写、去首尾空格；只允许 A-Z、0-9、_，且不能以数字开头。
+ */
+export declare function normalizeEnvKey(value: unknown): string;
+/**
+ * 解析 .env 文本格式的环境变量（兼容 export 前缀）。
+ *
+ * 纯函数，零依赖，可在任何运行时使用。
+ *
+ * @param raw - .env 文本内容
+ * @returns 解析出的键值对数组
+ */
+export declare function parseDotenvEntries(raw: unknown): {
+    key: string;
+    value: string;
+}[];
+/**
+ * 生成加密级随机字符串（base64url 编码）。
+ *
+ * 使用 Web Crypto API 的 crypto.getRandomValues，
+ * 兼容 Node.js、Cloudflare Workers、Deno、Bun、浏览器等所有现代运行时。
+ *
+ * @param size - 随机字节数，默认 32
+ */
+export declare function randomSecret(size?: number): string;
+/**
+ * 将 Uint8Array 编码为 base64url 字符串。
+ *
+ * 与 Buffer.toString("base64url") 行为一致。
+ */
+export declare function base64UrlEncodeBytes(bytes: Uint8Array): string;
+/**
+ * 将 base64url 字符串解码为 Uint8Array。
+ *
+ * 与 Buffer.from(str, "base64url") 行为一致。
+ */
+export declare function base64UrlDecodeBytes(str: string): Uint8Array;
+/**
+ * 将字符串编码为 base64url。
+ */
+export declare function base64UrlEncode(data: string): string;
+/**
+ * 将 base64url 字符串解码为 UTF-8 字符串。
+ */
+export declare function base64UrlDecode(str: string): string;
+/**
+ * 时间安全的字节比较。
+ *
+ * 替代 node:crypto 的 timingSafeEqual，在所有运行时中行为一致。
+ */
+export declare function timingSafeEqualBytes(a: Uint8Array, b: Uint8Array): boolean;
+//# sourceMappingURL=helpers.d.ts.map

package/bin/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,KAAK;IAC5C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,wBAAsB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAG7E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAK/D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMhE;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,SAAM,GAAG,QAAQ,CAO1D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAI9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAKpE;AAMD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAMD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMtD;AAMD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAsBjF;AAiBD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,SAAK,GAAG,MAAM,CAG9C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAG9D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAI5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAO1E"}