dsh-lh-data 0.1.0

package/lib/tooling.d.ts

@@ -0,0 +1,267 @@
+/**
+ * 工具定义适配器 —— 设计文档 §2.2 的**方案 B**（零 dsh 运行时依赖）。
+ *
+ * 与 `dsh-lh-judge` 保持一致：运行时不 import 任何 dsh 框架包，手写
+ * `ToolDefinition` 字面量 + 自持参数校验。切换方案 A（`@deepseek-ai/dsh-tools`
+ * 的 `defineTool`）时只改本文件：其余模块只依赖这里导出的
+ * `ToolSpec` / `ValueSchemaSpec` / `ToolExec` 三个契约。
+ *
+ * 类型层刻意与 dsh-tools 的 `ParameterSchemaSpec` / `ValueSchemaSpec` 同构：
+ * - 参数根对象是隐式开放对象，必填用属性级 `required: true` 标注；
+ * - 显式 object 节点必须写 `additionalProperties: true | false`；
+ * - 编译产物是 dsh-tools `json-schema.ts` 的受支持子集（否则 `register()` 会抛
+ *   `UNSUPPORTED_SCHEMA`）。
+ */
+/** 插件标识：回注消息与后台任务的 `source.plugin` 字段。 */
+export declare const PLUGIN_NAME = "dsh-lh-data";
+/**
+ * 视图分页排查用的临时后台日志（走 stdout），定位完成后删除本函数及其全部调用点。
+ */
+export declare function debugLog(scope: string, payload: unknown): void;
+export type JsonScalar = string | number | boolean | null;
+export type JsonValue = JsonScalar | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+/** 模型可见内容块（本插件只产出文本）。 */
+export interface TextContentBlock {
+    type: 'text';
+    text: string;
+}
+export type ContentBlock = TextContentBlock;
+/** 所有节点共享的注解关键字。 */
+export interface ValueSchemaAnnotations {
+    description?: string;
+    title?: string;
+}
+export interface StringValueSchemaSpec extends ValueSchemaAnnotations {
+    type: 'string';
+    enum?: readonly string[];
+}
+export interface NumberValueSchemaSpec extends ValueSchemaAnnotations {
+    type: 'number';
+}
+export interface IntegerValueSchemaSpec extends ValueSchemaAnnotations {
+    type: 'integer';
+}
+export interface BooleanValueSchemaSpec extends ValueSchemaAnnotations {
+    type: 'boolean';
+}
+export interface NullValueSchemaSpec extends ValueSchemaAnnotations {
+    type: 'null';
+}
+export interface ArrayValueSchemaSpec extends ValueSchemaAnnotations {
+    type: 'array';
+    items?: ValueSchemaSpec;
+}
+/** 显式对象节点；开放性是必填字段，避免拿到 JSON Schema 的意外默认值。 */
+export interface ObjectValueSchemaSpec extends ValueSchemaAnnotations {
+    type: 'object';
+    properties?: {
+        [key: string]: ValueSchemaSpec;
+    };
+    additionalProperties: boolean;
+}
+/** 作者侧「任意无损 JSON」节点；编译后是注解-only schema。 */
+export interface JsonValueSchemaSpec extends ValueSchemaAnnotations {
+    type: 'json';
+}
+export interface OneOfValueSchemaSpec extends ValueSchemaAnnotations {
+    oneOf: readonly [ValueSchemaSpec, ValueSchemaSpec, ...ValueSchemaSpec[]];
+}
+export type ValueSchemaSpec = StringValueSchemaSpec | NumberValueSchemaSpec | IntegerValueSchemaSpec | BooleanValueSchemaSpec | NullValueSchemaSpec | ArrayValueSchemaSpec | ObjectValueSchemaSpec | JsonValueSchemaSpec | OneOfValueSchemaSpec;
+/** 隐式参数根对象的一个属性；`required: true` 表示必填。 */
+export type ParameterPropertySpec = ValueSchemaSpec & {
+    required?: true;
+};
+export type ParameterSchemaSpec = {
+    [key: string]: ParameterPropertySpec;
+};
+/** 拍平交叉类型，便于 hover 阅读。 */
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** 标记为必填的属性名。 */
+type RequiredKeys<S> = {
+    [K in keyof S]: S[K] extends {
+        required: true;
+    } ? K : never;
+}[keyof S];
+/** 显式对象节点的推导（含声明的开放性）。 */
+type InferObject<S extends {
+    additionalProperties: boolean;
+}> = S extends {
+    properties: infer P;
+} ? S['additionalProperties'] extends true ? {
+    [K in keyof P]: InferValue<P[K]>;
+} & JsonObject : {
+    [K in keyof P]: InferValue<P[K]>;
+} : S['additionalProperties'] extends true ? JsonObject : Record<string, never>;
+/** 一个节点接受的 TypeScript 值。 */
+export type InferValue<S> = S extends {
+    type: 'string';
+} ? S extends {
+    enum: readonly (infer E)[];
+} ? E : string : S extends {
+    type: 'number' | 'integer';
+} ? S extends {
+    enum: readonly (infer E)[];
+} ? E : number : S extends {
+    type: 'boolean';
+} ? boolean : S extends {
+    type: 'null';
+} ? null : S extends {
+    type: 'array';
+} ? S extends {
+    items: infer I;
+} ? InferValue<I>[] : JsonValue[] : S extends {
+    type: 'object';
+    additionalProperties: boolean;
+} ? Simplify<InferObject<S>> : S extends {
+    type: 'json';
+} ? JsonValue : S extends {
+    oneOf: readonly (infer B)[];
+} ? InferValue<B> : never;
+/** 一个隐式参数 map 推导出的 args 对象类型。 */
+export type InferArgs<S extends ParameterSchemaSpec> = Simplify<{
+    [K in RequiredKeys<S>]: InferValue<S[K]>;
+} & {
+    [K in Exclude<keyof S, RequiredKeys<S>>]?: InferValue<S[K]>;
+}>;
+export type JsonSchemaScalar = string | number | boolean | null;
+export type JsonSchemaType = 'object' | 'array' | 'string' | 'number' | 'integer' | 'boolean' | 'null';
+export interface JsonSchemaNode {
+    type?: JsonSchemaType;
+    oneOf?: JsonSchemaNode[];
+    properties?: Record<string, JsonSchemaNode>;
+    required?: string[];
+    additionalProperties?: boolean;
+    items?: JsonSchemaNode;
+    enum?: JsonSchemaScalar[];
+    description?: string;
+    title?: string;
+}
+/** 工具定义的作者错误（schema 写错）：让插件加载即报错，而不是运行时才发现。 */
+export declare class ToolSchemaError extends Error {
+    constructor(message: string);
+}
+/** 工具通用错误；`code` 便于门禁与日志归类。 */
+export declare class ToolError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+/** 模型生成的参数不合法（对应 dsh-tools 的 `ToolArgsError` / `INVALID_ARGS`）。 */
+export declare class ToolArgsError extends ToolError {
+    readonly violations: string[];
+    constructor(violations: string[]);
+}
+/** 判断一个值是否为无损 JSON（用于 `json` 节点）。 */
+export declare function isJsonValue(value: unknown, depth?: number): boolean;
+/** 编译参数 map（隐式开放对象根）。 */
+export declare function compileParameters(spec: ParameterSchemaSpec): JsonSchemaNode;
+/** 编译输出 schema（任意 JSON 根）。 */
+export declare function compileOutputSchema(spec: ValueSchemaSpec): JsonSchemaNode;
+/** 校验一个值是否匹配已编译节点；返回空数组表示通过。 */
+export declare function validateValue(node: JsonSchemaNode, value: unknown, path?: string): string[];
+/** 调用方 agent 的最小视图（duck-typed，不 import dsh 运行时）。 */
+export interface AgentLike {
+    /**
+     * 真实 dsh：`Agent.session` 是 `Session`，工作目录挂在它的 `header.cwd`
+     * （`SessionHeader`）；扁平的 `cwd` / `id` 只是 headless 与自测的兼容位。
+     */
+    session?: {
+        header?: {
+            cwd?: string;
+            id?: string;
+        };
+        cwd?: string;
+        id?: string;
+    };
+    inject?(message: unknown): void;
+}
+/** `defineTool` 交给 execute 的上下文（`ToolRunContext` 的最小视图）。 */
+export interface ToolExec {
+    readonly name: string;
+    readonly arguments: unknown;
+    readonly agent?: AgentLike;
+    readonly signal: AbortSignal;
+    deferContext?(message: unknown): void;
+}
+/** UI 渲染意图：本插件只用 generic 卡片。 */
+export interface GenericCallView {
+    card: 'generic';
+    title: string;
+    kind?: 'read' | 'write' | 'search' | 'edit' | 'run';
+    content?: string;
+    rawInput?: string;
+    locations?: {
+        path: string;
+        line?: number;
+    }[];
+}
+export type ToolCallView = GenericCallView;
+/** 注册到 `ctx.tools` 的原始工具定义。 */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    output: {
+        schema: Record<string, unknown>;
+        render(args: unknown, value: unknown): ContentBlock[];
+        /** 可选：只给前端的展示元数据（模型不可见）。 */
+        presentationMeta?(args: unknown, value: unknown): JsonValue;
+    };
+    execute(args: unknown, exec: ToolExec): Promise<unknown>;
+    presentCall?(args: unknown): ToolCallView | undefined;
+}
+/** `ctx.tools` 服务的最小视图。 */
+export interface ToolRegistry {
+    register(definition: ToolDefinition): () => void;
+    guard?(guard: (exec: ToolExec) => string | undefined): () => void;
+}
+/** `tools/pre-execute` 的决策（与 dsh-tools 的 `PreToolDecision` 同构）。 */
+export type PreToolDecision = {
+    kind: 'allow';
+} | {
+    kind: 'deny';
+    reason: string;
+} | {
+    kind: 'ask';
+    reason?: string;
+};
+export declare const ALLOW_DECISION: PreToolDecision;
+export interface ToolOutputSpec<P extends ParameterSchemaSpec, V> {
+    /** 规范输出 schema；execute 的返回值会被强制校验。 */
+    schema: ValueSchemaSpec;
+    /**
+     * 把规范值渲染成模型可见内容（纯函数，不做 I/O）。
+     * 调用处请显式标注 value 的类型（与 execute 的返回类型一致），
+     * 以保证 render 内部拿到精确类型。
+     */
+    render(args: InferArgs<P>, value: V): ContentBlock[];
+    /**
+     * 只给 UI 的展示元数据（模型不可见）。平台只对顶层调用计算一次，
+     * 因此它必须是 (args, value) 的**纯函数**：任何需要交给前端的东西都要随规范值携带。
+     */
+    presentationMeta?(args: InferArgs<P>, value: V): JsonValue;
+}
+export interface ToolSpec<P extends ParameterSchemaSpec, V> {
+    name: string;
+    /** 模型唯一可见的说明。 */
+    description: string;
+    parameters: P;
+    output: ToolOutputSpec<P, V>;
+    /** pending 卡片；参数不合法时由适配器返回 undefined（渲染永不抛错）。 */
+    presentCall?(args: InferArgs<P>): ToolCallView | undefined;
+    execute(args: InferArgs<P>, exec: ToolExec): Promise<V>;
+}
+/**
+ * 把作者侧定义编译成注册表可接受的 `ToolDefinition`：
+ * - 编译期校验作者 schema（违反受支持子集直接抛错，fail-loud）；
+ * - `execute` 前校验模型入参，违规抛 `ToolArgsError`（→ `INVALID_ARGS`）；
+ * - `presentCall` 软校验，任何异常回落到通用卡片。
+ */
+export declare function toolDef<const P extends ParameterSchemaSpec, V>(spec: ToolSpec<P, V>): ToolDefinition;
+export {};

package/lib/tools/datasource.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `datasource_*`：数据源的列表 / 连通性测试 / 远端表浏览 / 导入。
+ *
+ * 与 `dataset_*` 的关系：数据源只是**数据来源**的另一种形态——导入完成后的数据集
+ * 与 Excel 导入的完全同权，之后一律用 `dataset_*` 工具操作。
+ *
+ * 脱敏红线：四个工具的返回值与渲染文本里都不出现密码、连接串与本地物理表名。
+ */
+import type { DataServices } from '../store';
+import { type ToolDefinition } from '../tooling';
+export declare function createSourceListTool(services: DataServices): ToolDefinition;
+export declare function createSourceTestTool(services: DataServices): ToolDefinition;
+export declare function createSourceTablesTool(services: DataServices): ToolDefinition;
+export declare function createSourceImportTool(services: DataServices): ToolDefinition;
+/** 供 registry 聚合。 */
+export declare function createDataSourceTools(services: DataServices): ToolDefinition[];

package/lib/tools/import.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `dataset_import`：解析工作区 Excel/CSV → 建表 → 批量插入 → 登记元数据。
+ *
+ * 大文件（≥ `backgroundThresholdRows`，或显式 `background: true`）走后台分支：
+ * 立即返回 `{ status: 'running', jobId }`，插入在 `ctx.jobs` 任务里跑完后回注通知
+ * （设计文档 §5.2）。任何失败都会删掉半截的物理表并把元数据标记为 `failed`。
+ */
+import { type ColumnInfo } from '../parse';
+import { type DataServices } from '../store';
+import { type ToolDefinition } from '../tooling';
+export declare const IMPORT_JOB_KIND = "dataset-import";
+export interface ImportOutput {
+    datasetId: string;
+    name: string;
+    rowCount: number;
+    columnCount: number;
+    status: string;
+    jobId?: string;
+    columns: ColumnInfo[];
+}
+export declare function createImportTool(services: DataServices): ToolDefinition;

package/lib/tools/read.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 只读工具：`dataset_list` / `dataset_schema` / `dataset_query`。
+ *
+ * 三个工具都不修改数据，因此走 `allow`（不触发审批）；返回值只出现 datasetId 与登记名，
+ * 物理表名留在 `store.ts` 内部（设计文档 §7.1）。
+ */
+import type { ColumnInfo } from '../parse';
+import type { Row } from '../db';
+import { type DataServices } from '../store';
+import { type ColumnSummary } from '../preview';
+import { type ToolDefinition } from '../tooling';
+export interface DatasetSummary {
+    datasetId: string;
+    name: string;
+    rowCount: number;
+    columnCount: number;
+    status: string;
+    sourcePath: string | null;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface ListOutput {
+    count: number;
+    datasets: DatasetSummary[];
+}
+export interface SchemaOutput {
+    datasetId: string;
+    name: string;
+    description: string | null;
+    rowCount: number;
+    status: string;
+    columns: ColumnInfo[];
+}
+/** 结果视图的定位信息（设计文档 §5.1 / §5.4）。 */
+export interface QueryViewInfo {
+    viewId: string;
+    endpoint: string;
+    pageSize: number;
+    maxPageSize: number;
+    /** 排序是否稳定（false 时前端只展示首页）。 */
+    stable: boolean;
+    /** 允许前端排序的列名白名单。 */
+    sortable: string[];
+}
+export interface QueryOutput {
+    datasetId: string;
+    name: string;
+    columns: {
+        name: string;
+        type: string;
+    }[];
+    /** 实际命中的行数（不受上限收敛影响）。 */
+    matchedRows: number;
+    /** 本次可服务的行数（已按 maxQueryRows / maxViewRows 收敛）。 */
+    totalRows: number;
+    preview: {
+        rows: Row[];
+        columns: string[];
+        /** 头段行数（`gap` 为真时其后是尾段）。 */
+        headCount: number;
+        gap: boolean;
+        skipped: number;
+        cellTruncated: boolean;
+        columnTruncated: boolean;
+        hiddenColumns: number;
+    };
+    summary: ColumnSummary[];
+    limit: number;
+    offset: number;
+    /** 预览只是结果的一部分。 */
+    truncated: boolean;
+    /** 存在前端视图（完整结果由前端分页拉取）。 */
+    view?: QueryViewInfo;
+}
+export declare function createListTool(services: DataServices): ToolDefinition;
+export declare function createSchemaTool(services: DataServices): ToolDefinition;
+export declare function createQueryTool(services: DataServices): ToolDefinition;

package/lib/tools/registry.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 八个工具的聚合导出（设计文档 §5.1）。
+ */
+import type { DataServices } from '../store';
+import type { ToolDefinition } from '../tooling';
+/** 数据源工具（`datasourceEnabled=false` 时整体不注册）。 */
+export declare const DATA_SOURCE_TOOLS: ReadonlySet<string>;
+/** 本插件注册的全部工具名。 */
+export declare const DATASET_TOOLS: ReadonlySet<string>;
+/** 破坏性工具：写类，默认走 `ctx.approval` 人工确认（fail-closed）。 */
+export declare const WRITE_TOOLS: ReadonlySet<string>;
+export declare function createToolDefinitions(services: DataServices): ToolDefinition[];

package/lib/tools/write.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 写工具：`dataset_insert` / `dataset_update` / `dataset_delete` / `dataset_drop`。
+ *
+ * 四个工具都是破坏性的，默认由 `src/index.ts` 的 `tools/pre-execute` 监听器返回
+ * `{ kind: 'ask' }` 交给 `ctx.approval` 人工确认（无审批通道即拒绝，fail-closed）。
+ * 这里再兜一层 `readOnly` 检查，避免门禁被绕过时的静默写入。
+ */
+import { type DataServices } from '../store';
+import { type ToolDefinition } from '../tooling';
+export interface InsertOutput {
+    datasetId: string;
+    name: string;
+    inserted: number;
+    rowCount: number;
+}
+export interface UpdateOutput {
+    datasetId: string;
+    rowId: number;
+    updated: boolean;
+    changedColumns: string[];
+    rowCount: number;
+}
+export interface DeleteOutput {
+    datasetId: string;
+    rowId: number;
+    deleted: boolean;
+    rowCount: number;
+}
+export interface DropOutput {
+    datasetId: string;
+    name: string;
+    dropped: boolean;
+}
+export declare function createInsertTool(services: DataServices): ToolDefinition;
+export declare function createUpdateTool(services: DataServices): ToolDefinition;
+export declare function createDeleteTool(services: DataServices): ToolDefinition;
+export declare function createDropTool(services: DataServices): ToolDefinition;

package/lib/view.d.ts

@@ -0,0 +1,138 @@
+/**
+ * 查询结果视图注册中心 —— 设计文档 §6。
+ *
+ * 视图是**主机侧的句柄**：`viewId` 之外的一切（物理表名、count/page 语句）都留在这里，
+ * 既不出现在模型上下文里，也不出现在 HTTP 响应里。前端只能拿 `viewId` + 分页参数换页。
+ *
+ * 生命周期：视图元数据持久化到数据库表（`lh_views`，与 `datasets` 同库同 scope），
+ * 进程重启 / 插件重载 / 热更新后仍能继续翻页查看，永不过期、不被容量淘汰。
+ * 翻页行数据始终实时查询原始数据表，因此底层数据可能被并发写入改变
+ * （前端卡片常驻软警告「数据可能已发生变化」）。
+ *
+ * 内部仍保留 `Map` 作为热缓存，`get()` / `page()` / `revoke()` 同步操作缓存（翻页 O(1)），
+ * 仅 `create` / `revoke` 会写库，启动时 `loadAll()` 从各库预载一次。
+ */
+import type { Database } from './db';
+import type { ScopeRegistry } from './scope-registry';
+/** 视图能看到的列（列名保持原始表头，含中文）。 */
+export interface ViewColumn {
+    name: string;
+    type: string;
+}
+/** 派生分页语句所需的三件套，排序可按前端请求重排。 */
+export interface ViewSqlParts {
+    /** 已校验、无 LIMIT/OFFSET 的基础语句。 */
+    baseSql: string;
+    /** 模型（或结构化参数）给出的排序项，已引号化。 */
+    baseOrder?: string;
+    /** 兜底排序键（通常 `_row_id`）；拿不到时为空，此时不保证翻页稳定。 */
+    tie?: string;
+}
+export interface CreateViewInput extends ViewSqlParts {
+    scopeKey: string;
+    datasetId: string;
+    name: string;
+    /** 物理表名：只在本模块内部持有，绝不外发。 */
+    tableName: string;
+    columns: ViewColumn[];
+    countSql: string;
+    totalRows: number;
+    /** 该视图最多可翻到的行数（已与 maxQueryRows 取小）。 */
+    rowCap: number;
+    /** 允许前端排序的列名（已登记列的白名单）。 */
+    sortable: string[];
+    stable: boolean;
+}
+/** 注册后的视图（内部形态）。 */
+export interface RegisteredView extends CreateViewInput {
+    viewId: string;
+    createdAt: number;
+}
+/** 交给前端的描述符（`output.presentationMeta` 的载荷）。 */
+export interface ViewDescriptor {
+    kind: 'dataset-view';
+    viewId: string;
+    endpoint: string;
+    datasetId: string;
+    name: string;
+    columns: ViewColumn[];
+    totalRows: number;
+    pageSize: number;
+    maxPageSize: number;
+    stable: boolean;
+    sortable: string[];
+}
+export interface ViewOptions {
+    /** HTTP 路由前缀，用于拼 `endpoint`。 */
+    routePrefix: string;
+    defaultPageSize: number;
+    maxPageSize: number;
+    /** 视图可服务行数的硬上限。 */
+    maxViewRows: number;
+}
+/** 持久化所需的外部依赖（以回调注入，避免与 store 形成值循环依赖）。 */
+export interface ViewDeps {
+    /** 已登记工作区枚举（`loadAll` 遍历用）。 */
+    scopes: ScopeRegistry;
+    /** 按 scope 取得对应业务库连接。 */
+    database: (scopeKey: string) => Promise<Database>;
+}
+export type SortOrder = 'asc' | 'desc';
+export interface PageRequest {
+    page?: number;
+    pageSize?: number;
+    sort?: string;
+    order?: SortOrder;
+}
+/** 一次分页查询的 SQL 与参数（执行仍由调用方持库连接完成）。 */
+export interface PageStatement {
+    sql: string;
+    params: [number, number];
+    page: number;
+    pageSize: number;
+    totalRows: number;
+    totalPages: number;
+    stable: boolean;
+}
+export declare class ViewError extends Error {
+    readonly code: 'VIEW_NOT_FOUND' | 'BAD_REQUEST';
+    readonly status: 400 | 404;
+    constructor(code: 'VIEW_NOT_FOUND' | 'BAD_REQUEST', status: 400 | 404, message: string);
+}
+/** 拼排序子句：前端排序 > 模型排序 > 兜底键。 */
+export declare function composeOrderBy(parts: ViewSqlParts, sort?: {
+    column: string;
+    order: SortOrder;
+}): string;
+export declare class ViewRegistry {
+    private readonly views;
+    private readonly options;
+    private readonly deps;
+    constructor(options: ViewOptions, deps: ViewDeps);
+    /** 当前存活视图数（测试与日志用）。 */
+    get size(): number;
+    /** 确保某 scope 的业务库已存在视图表（幂等），返回库连接。 */
+    private ensureTable;
+    /** 把一行 DB 记录还原成内部视图对象。 */
+    private static fromRow;
+    /** 注册一个视图：双写内存缓存与数据库表，返回给前端的描述符。 */
+    create(input: CreateViewInput): Promise<ViewDescriptor>;
+    /** 取一个已注册的视图（同步读内存缓存；启动已 loadAll 预载）。 */
+    get(viewId: string): RegisteredView | undefined;
+    /** 主动释放（前端卸载卡片 / DELETE）。双删：内存缓存 + 数据库行。 */
+    revoke(viewId: string): Promise<boolean>;
+    /** 仅清空内存热缓存（不删库表，否则持久化失效）。 */
+    clear(): void;
+    /**
+     * 启动时预载：遍历所有已登记 scope，把各库 `lh_views` 表读进内存。
+     * 必须在注册路由前完成，避免早期请求漏命中。
+     */
+    loadAll(): Promise<void>;
+    /**
+     * 解析分页参数并产出可直接执行的语句。
+     * 排序只接受视图创建时登记的白名单列，越界一律 `BAD_REQUEST`。
+     */
+    page(viewId: string, request?: PageRequest): PageStatement;
+}
+/** 视图注册中心的构造入口（`DataServices.views`）。 */
+export declare function createViewRegistry(options: ViewOptions, deps: ViewDeps): ViewRegistry;

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "dsh-lh-data",
+  "version": "0.1.0",
+  "description": "dsh 插件：把工作区 Excel/CSV 导入本地 Turso（libSQL），并以句柄化的 dataset_* 工具做增删改查。",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./src/client/index.ts",
+      "default": "./lib/client.js"
+    }
+  },
+  "files": [
+    "lib/",
+    "src/",
+    "cordis.patch.yml"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "external": [
+        "react"
+      ]
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "@libsql/client": "^0.17.4",
+    "mysql2": "^3.24.3",
+    "papaparse": "^5.7.0",
+    "pg": "^8.23.0",
+    "xlsx": "^0.18.5"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@types/node": "^24.0.0",
+    "@types/papaparse": "^5.5.2",
+    "@types/react": "^18.3.31",
+    "tsdown": "^0.4.0",
+    "typescript": "^5.5.4"
+  },
+  "scripts": {
+    "prebuild": "node -e \"require('node:fs').rmSync('lib', { recursive: true, force: true })\"",
+    "build": "tsdown",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.client.json --noEmit",
+    "typecheck:host": "tsc -p tsconfig.json --noEmit",
+    "typecheck:client": "tsc -p tsconfig.client.json --noEmit",
+    "import": "node examples/run-import.mjs",
+    "view": "node examples/run-view.mjs",
+    "admin": "node examples/run-admin.mjs",
+    "datasource": "node examples/run-datasource.mjs"
+  }
+}