@downcity/city 0.2.17

package/bin/service/ai/openai-compatible-provider.js

@@ -0,0 +1,175 @@
+/**
+ * OpenAI-compatible Provider 构造工具。
+ *
+ * 负责把 OpenAI 兼容上游包装成 Downcity 的 SDK 通路：
+ * - text   → 返回 AI SDK `UIMessage`
+ * - stream → 返回 AI SDK `UIMessageStreamResponse`
+ *
+ * 关键说明（中文）
+ * - `/chat/completions` 仍由 AIService 的自动透传处理
+ * - 这里专门补齐 UserClient.ai.text() / stream() 所需的 server 侧 action
+ * - 不在请求热路径里做动态导入，减少首请求和冷启动额外开销
+ */
+import { convertToModelMessages, generateText, jsonSchema, streamText, tool } from "ai";
+import { Provider } from "./provider.js";
+/**
+ * 创建 OpenAI-compatible Provider。
+ */
+export function createOpenAICompatibleProvider(options, createClient) {
+    return new Provider(options.id, {
+        env: { [options.envKey]: `${options.id} API Key` },
+        baseURL: options.baseURL,
+        envKey: options.envKey,
+        passthroughModel: options.defaultModelId,
+        text: createTextAction(options, createClient),
+        stream: createStreamAction(options, createClient),
+    });
+}
+/**
+ * 读取必填 API Key。
+ */
+function readApiKey(ctx, key) {
+    const value = ctx.env(key);
+    if (!value)
+        throw new Error(`${key} is required`);
+    return value;
+}
+/**
+ * 从 input 中提取 prompt 文本。
+ */
+function extractPrompt(input) {
+    if (typeof input.prompt === "string")
+        return input.prompt;
+    const messages = input.messages;
+    return messages
+        ?.find((message) => message.role === "user")
+        ?.parts?.find((part) => part.type === "text")
+        ?.text ?? "";
+}
+/**
+ * OpenAI function tools → ai-sdk ToolSet。
+ */
+function buildToolSet(items) {
+    if (!items?.length)
+        return undefined;
+    return Object.fromEntries(items
+        .filter((item) => item.type === "function" && typeof item.function?.name === "string")
+        .map((item) => [
+        item.function.name,
+        tool({
+            description: item.function.description ?? "",
+            inputSchema: jsonSchema(item.function.parameters ?? {}),
+        }),
+    ]));
+}
+/**
+ * 将输入解析成 prompt 或 tools+messages，供 text / stream 共用。
+ */
+async function resolveActionInput(input) {
+    const tools = buildToolSet(input.tools);
+    if (!tools) {
+        return { prompt: extractPrompt(input) };
+    }
+    return {
+        tools,
+        messages: await convertToModelMessages(input.messages ?? [], { tools }),
+    };
+}
+/**
+ * 创建当前请求的 chat model。
+ *
+ * 关键说明（中文）
+ * - client 工厂本身在模块加载时就已静态绑定
+ * - 这里只按当前 env 读取 API Key，避免 key 轮换后继续复用旧值
+ */
+function createChatModel(ctx, options, createClient) {
+    return createClient({
+        apiKey: readApiKey(ctx, options.envKey),
+        baseURL: options.baseURL,
+        name: options.id,
+    }).chat(options.defaultModelId);
+}
+/**
+ * generateText 结果 → UIMessage。
+ */
+function buildMessage(text, ctx, result) {
+    const parts = [{ type: "text", text }];
+    if (result.toolCalls) {
+        for (const toolCall of result.toolCalls) {
+            const part = {
+                type: "dynamic-tool",
+                toolCallId: toolCall.toolCallId,
+                toolName: toolCall.toolName,
+                state: "input-available",
+                input: toolCall.input,
+            };
+            parts.push(part);
+        }
+    }
+    return {
+        id: `msg_${crypto.randomUUID()}`,
+        role: "assistant",
+        parts,
+        metadata: {
+            model: ctx.variant?.id,
+            studio_id: ctx.studio?.studio_id,
+            user_id: ctx.user?.user_id,
+            finishReason: result.finishReason,
+            usage: result.usage,
+        },
+    };
+}
+/**
+ * 构造 text action。
+ */
+function createTextAction(options, createClient) {
+    return async (ctx) => {
+        const input = ctx.input;
+        const resolvedInput = await resolveActionInput(input);
+        const model = createChatModel(ctx, options, createClient);
+        if ("tools" in resolvedInput) {
+            const result = await generateText({
+                model,
+                messages: resolvedInput.messages,
+                tools: resolvedInput.tools,
+            });
+            return buildMessage(result.text, ctx, {
+                finishReason: result.finishReason,
+                usage: result.usage,
+                toolCalls: result.toolCalls,
+            });
+        }
+        const result = await generateText({
+            model,
+            prompt: resolvedInput.prompt,
+            temperature: 1,
+        });
+        return buildMessage(result.text, ctx, {
+            finishReason: result.finishReason,
+            usage: result.usage,
+        });
+    };
+}
+/**
+ * 构造 stream action。
+ */
+function createStreamAction(options, createClient) {
+    return async (ctx) => {
+        const input = ctx.input;
+        const resolvedInput = await resolveActionInput(input);
+        const model = createChatModel(ctx, options, createClient);
+        if ("tools" in resolvedInput) {
+            return streamText({
+                model,
+                messages: resolvedInput.messages,
+                tools: resolvedInput.tools,
+            }).toUIMessageStreamResponse();
+        }
+        return streamText({
+            model,
+            prompt: resolvedInput.prompt,
+            temperature: 1,
+        }).toUIMessageStreamResponse();
+    };
+}
+//# sourceMappingURL=openai-compatible-provider.js.map

package/bin/service/ai/openai-compatible-provider.js.map

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

package/bin/service/ai/provider.d.ts

@@ -0,0 +1,43 @@
+/**
+ * AI Provider 模块。
+ *
+ * Provider 封装第三方 AI 提供商的 action 实现、环境变量声明和连接信息。
+ * 通过 model() 方法生成模型配置，可直接传给 AIService.use() 完成注册。
+ *
+ * 两条独立通路：
+ * - SDK 通路：text / stream — 给 UserClient 用
+ * - OpenAI 兼容通路：openai — 给 /chat/completions 端点用
+ *   - 未提供 openai action → AIService 自动透传（需 baseURL + envKey）
+ *   - 提供了 openai action → 按自定义逻辑处理
+ */
+import type { ActionFn } from "../action.js";
+import type { ModelConfig } from "./types.js";
+export interface ProviderOptions {
+    env?: Record<string, string>;
+    baseURL?: string;
+    envKey?: string;
+    passthroughModel?: string;
+    text: ActionFn;
+    stream: ActionFn;
+    image?: ActionFn;
+    video?: ActionFn;
+    openai?: ActionFn;
+}
+export declare class Provider {
+    readonly id: string;
+    readonly env?: Record<string, string>;
+    readonly baseURL?: string;
+    readonly envKey?: string;
+    readonly passthroughModel?: string;
+    private readonly actions;
+    constructor(id: string, opts: ProviderOptions);
+    model(spec: {
+        id: string;
+        name: string;
+        description?: string;
+        tags?: string[];
+        meta?: Record<string, unknown>;
+        default?: boolean | string[];
+    }): ModelConfig;
+}
+//# sourceMappingURL=provider.d.ts.map

package/bin/service/ai/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/service/ai/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAED,qBAAa,QAAQ;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAE3B,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe;IAe7C,KAAK,CAAC,IAAI,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;KAC9B,GAAG,WAAW;CAehB"}

package/bin/service/ai/provider.js

@@ -0,0 +1,50 @@
+/**
+ * AI Provider 模块。
+ *
+ * Provider 封装第三方 AI 提供商的 action 实现、环境变量声明和连接信息。
+ * 通过 model() 方法生成模型配置，可直接传给 AIService.use() 完成注册。
+ *
+ * 两条独立通路：
+ * - SDK 通路：text / stream — 给 UserClient 用
+ * - OpenAI 兼容通路：openai — 给 /chat/completions 端点用
+ *   - 未提供 openai action → AIService 自动透传（需 baseURL + envKey）
+ *   - 提供了 openai action → 按自定义逻辑处理
+ */
+export class Provider {
+    id;
+    env;
+    baseURL;
+    envKey;
+    passthroughModel;
+    actions;
+    constructor(id, opts) {
+        this.id = id;
+        this.env = opts.env;
+        this.baseURL = opts.baseURL;
+        this.envKey = opts.envKey;
+        this.passthroughModel = opts.passthroughModel;
+        this.actions = {
+            text: opts.text,
+            stream: opts.stream,
+            image: opts.image,
+            video: opts.video,
+            openai: opts.openai,
+        };
+    }
+    model(spec) {
+        return {
+            id: spec.id,
+            name: spec.name,
+            description: spec.description,
+            tags: spec.tags,
+            meta: spec.meta,
+            default: spec.default,
+            env: this.env,
+            baseURL: this.baseURL,
+            envKey: this.envKey,
+            passthroughModel: this.passthroughModel,
+            actions: this.actions,
+        };
+    }
+}
+//# sourceMappingURL=provider.js.map

package/bin/service/ai/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/service/ai/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiBH,MAAM,OAAO,QAAQ;IACV,EAAE,CAAS;IACX,GAAG,CAA0B;IAC7B,OAAO,CAAU;IACjB,MAAM,CAAU;IAChB,gBAAgB,CAAU;IAClB,OAAO,CAAe;IAEvC,YAAY,EAAU,EAAE,IAAqB;QAC3C,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC9C,IAAI,CAAC,OAAO,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAOL;QACC,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,94 @@
+/**
+ * AI Service 类型模块。
+ *
+ * 包含模型配置、action 映射、运行时模型和执行上下文类型。
+ */
+import type { ActionFn } from "../action.js";
+/**
+ * 模型 action 映射，key 为通路名称。
+ *
+ * 两条独立通路：
+ * - SDK 通路：text / stream / image / video / tts / asr — 给 UserClient 用
+ * - OpenAI 兼容通路：openai — 给 /chat/completions 端点用
+ *
+ * 每个 action 接收 Context，返回对应通路的结果。
+ * Provider 在构造时提供这些 action，通过 model() 方法绑定到模型配置。
+ */
+export interface ModelActions {
+    /** 文本生成 action */
+    text?: ActionFn;
+    /** 流式生成 action */
+    stream?: ActionFn;
+    /** 图片生成 action */
+    image?: ActionFn;
+    /** 视频生成 action */
+    video?: ActionFn;
+    /** 语音合成 action */
+    tts?: ActionFn;
+    /** 语音识别 action */
+    asr?: ActionFn;
+    /** OpenAI 兼容 /chat/completions action。未提供时 AIService 自动透传 */
+    openai?: ActionFn;
+    /** 扩展 modality action */
+    [modality: string]: ActionFn | undefined;
+}
+/**
+ * 模型配置（Provider.model() 的返回值）。
+ */
+export interface ModelConfig {
+    /** 模型唯一 ID */
+    id: string;
+    /** 模型展示名称 */
+    name: string;
+    /** 模型描述 */
+    description?: string;
+    /** 模型标签 */
+    tags?: string[];
+    /** 模型元数据 */
+    meta?: Record<string, unknown>;
+    /** 是否为默认模型 */
+    default?: boolean | string[];
+    /** 模型所需环境变量 */
+    env?: Record<string, string>;
+    /** Provider 的 baseURL（用于自动透传） */
+    baseURL?: string;
+    /** Provider 的环境变量 key */
+    envKey?: string;
+    /** 上游 API 实际模型 ID（自动透传时替换 body.model） */
+    passthroughModel?: string;
+    /** 各通路 action 绑定 */
+    actions: ModelActions;
+}
+export interface PublicModel {
+    /** 模型 ID */
+    id: string;
+    /** 模型展示名称 */
+    name: string;
+    /** 模型描述 */
+    description: string;
+    /** 模型支持的 modality 列表 */
+    modalities: string[];
+    /** 模型标签 */
+    tags: string[];
+    /** 模型元数据 */
+    meta: Record<string, unknown>;
+    /** 模型依赖的环境变量需求（通常仅在 admin 身份下返回） */
+    env_requirements?: AIModelEnvRequirement[];
+    /** 模型默认负责的 modality 列表（通常仅在 admin 身份下返回） */
+    default_modes?: string[];
+}
+/**
+ * AI 模型环境变量需求。
+ *
+ * 用于 admin 视角展示某个模型依赖哪些运行时 key，
+ * 以及这些 key 当前是否已经配置完成。
+ */
+export interface AIModelEnvRequirement {
+    /** 环境变量 key，例如 `DEEPSEEK_API_KEY` */
+    key: string;
+    /** 给管理员展示的说明文本 */
+    description: string;
+    /** 当前是否必须提供该 key 才能调用模型 */
+    required: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/service/ai/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAM7C;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,kBAAkB;IAClB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,kBAAkB;IAClB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,kBAAkB;IAClB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,kBAAkB;IAClB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,kBAAkB;IAClB,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,kBAAkB;IAClB,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,6DAA6D;IAC7D,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,yBAAyB;IACzB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,cAAc;IACd,EAAE,EAAE,MAAM,CAAC;IACX,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,cAAc;IACd,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IAC7B,eAAe;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB;IACpB,OAAO,EAAE,YAAY,CAAC;CACvB;AAMD,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW;IACX,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC3C,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/bin/service/ai/types.js

@@ -0,0 +1,7 @@
+/**
+ * AI Service 类型模块。
+ *
+ * 包含模型配置、action 映射、运行时模型和执行上下文类型。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/bin/service/ai/types.js.map

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

package/bin/service/env/env-service.d.ts

@@ -0,0 +1,12 @@
+/**
+ * env 内置服务。
+ *
+ * 关键说明（中文）
+ * - City 默认注册该 service。
+ * - EnvProvider 由 City 初始化并注入，不需要产品手动传入。
+ */
+import { Service } from "../service.js";
+export declare class EnvService extends Service {
+    constructor();
+}
+//# sourceMappingURL=env-service.d.ts.map

package/bin/service/env/env-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-service.d.ts","sourceRoot":"","sources":["../../../src/service/env/env-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,qBAAa,UAAW,SAAQ,OAAO;;CAiCtC"}

package/bin/service/env/env-service.js

@@ -0,0 +1,39 @@
+/**
+ * env 内置服务。
+ *
+ * 关键说明（中文）
+ * - City 默认注册该 service。
+ * - EnvProvider 由 City 初始化并注入，不需要产品手动传入。
+ */
+import { Service } from "../service.js";
+export class EnvService extends Service {
+    constructor() {
+        super({ id: "env", name: "Env" });
+        this.instruction = [
+            "管理 City 运行时环境变量。",
+            "适用于导入、列出、更新和删除 City 内部使用的 env 配置。",
+            "不要把真实密钥暴露给产品前端；应只在可信管理端调用这些接口。",
+        ].join("\n");
+        this.action("list", async (ctx) => {
+            const list = await this._env.list();
+            const items = Array.isArray(list) ? list : [];
+            return { items };
+        }, { method: "GET", auth: ["admin"] });
+        this.action("upsert", async (ctx) => {
+            const entry = await this._env.upsert({
+                key: String(ctx.input.key ?? ""),
+                value: String(ctx.input.value ?? ""),
+            });
+            return { success: true, key: entry.key };
+        }, { auth: ["admin"] });
+        this.action("remove", async (ctx) => {
+            await this._env.remove(String(ctx.input.key ?? ""));
+            return { success: true, key: String(ctx.input.key ?? "") };
+        }, { auth: ["admin"] });
+        this.action("import", async (ctx) => {
+            const entries = await this._env.import(ctx.input.raw);
+            return { success: true, count: entries.length, keys: entries.map((e) => e.key) };
+        }, { auth: ["admin"] });
+    }
+}
+//# sourceMappingURL=env-service.js.map

package/bin/service/env/env-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-service.js","sourceRoot":"","sources":["../../../src/service/env/env-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,OAAO,UAAW,SAAQ,OAAO;IACrC;QACE,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG;YACjB,kBAAkB;YAClB,mCAAmC;YACnC,gCAAgC;SACjC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAChC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAK,CAAC,IAAI,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAEvC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAClC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAK,CAAC,MAAM,CAAC;gBACpC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;gBAChC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;aACrC,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;QAC3C,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAExB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAClC,MAAM,IAAI,CAAC,IAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;YACrD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;QAC7D,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAExB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAClC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACvD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QACnF,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/bin/service/env/env-store.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Env 数据存储。
+ *
+ * 基于 CityTableApi，不直接依赖 Drizzle。
+ */
+import type { CityTableApi } from "../../store/table-api.js";
+import type { EnvEntry, EnvUpsertInput } from "./types.js";
+export declare class EnvStore {
+    private table;
+    constructor(table: CityTableApi<EnvEntry>);
+    list(): Promise<EnvEntry[]>;
+    upsert(input: EnvUpsertInput): Promise<EnvEntry>;
+    remove(key: string): Promise<void>;
+}
+//# sourceMappingURL=env-store.d.ts.map

package/bin/service/env/env-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-store.d.ts","sourceRoot":"","sources":["../../../src/service/env/env-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE3D,qBAAa,QAAQ;IACP,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC;IAE3C,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAI3B,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAkBhD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGzC"}

package/bin/service/env/env-store.js

@@ -0,0 +1,35 @@
+/**
+ * Env 数据存储。
+ *
+ * 基于 CityTableApi，不直接依赖 Drizzle。
+ */
+import { normalizeEnvKey } from "../../utils/helpers.js";
+export class EnvStore {
+    table;
+    constructor(table) {
+        this.table = table;
+    }
+    async list() {
+        return this.table.select();
+    }
+    async upsert(input) {
+        const key = normalizeEnvKey(input.key);
+        const value = String(input.value ?? "");
+        const rows = await this.table.select({ key });
+        if (rows.length > 0) {
+            await this.table.update({
+                where: { key },
+                values: { value, updated_at: new Date().toISOString() },
+            });
+        }
+        else {
+            const now = new Date().toISOString();
+            await this.table.insert({ key, value, source: "database", created_at: now, updated_at: now });
+        }
+        return { key, value, source: "database" };
+    }
+    async remove(key) {
+        await this.table.delete({ key: normalizeEnvKey(key) });
+    }
+}
+//# sourceMappingURL=env-store.js.map

package/bin/service/env/env-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-store.js","sourceRoot":"","sources":["../../../src/service/env/env-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAIzD,MAAM,OAAO,QAAQ;IACC;IAApB,YAAoB,KAA6B;QAA7B,UAAK,GAAL,KAAK,CAAwB;IAAG,CAAC;IAErD,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAqB;QAChC,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,EAAuB,CAAC,CAAC;QAEnE,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;gBACtB,KAAK,EAAE,EAAE,GAAG,EAAuB;gBACnC,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAuB;aAC7E,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAc,CAAC,CAAC;QAC5G,CAAC;QAED,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,GAAG,CAAC,EAAuB,CAAC,CAAC;IAC9E,CAAC;CACF"}