@chatu-ai/app-sdk 0.7.6 → 0.7.7

package/README.md

@@ -19,6 +19,7 @@ const src = await storage.url('avatars/u1.png', { expiresIn: 3600 })         //
 | --- | --- | --- |
 | `CHATU_DATA_URL` + `CHATU_APP_KEY` (+ `CHATU_DATA_ENV=dev\|prod`) | **platform** — ChatU hosted Data API, metered | set automatically in the Builder preview; copy from the publish panel for your own server |
 | `REDIS_URL` and/or `S3_BUCKET` (+ `S3_ENDPOINT` `S3_REGION` `S3_ACCESS_KEY` `S3_SECRET_KEY` `S3_PREFIX`) | **byo** — your own Redis / S3-compatible bucket (Tencent COS, MinIO, AWS) | install optional deps: `npm i ioredis @aws-sdk/client-s3 @aws-sdk/s3-request-presigner` |
+| `CHATU_DATA_DRIVER=edgeone` (+ optional `CHATU_EDGEONE_KV_STORE` / `CHATU_EDGEONE_STORAGE_STORE`, external access: `EDGEONE_BLOB_PROJECT_ID` + `EDGEONE_BLOB_TOKEN`) | **edgeone** — Tencent EdgeOne Pages Blob for both `kv` (JSON envelope, TTL emulated) and `storage` (presigned PUT via `createUploadUrl`; `storage.url()` returns the in-app proxy path `/_chatu/blob/<key>` served by the template route) | `npm i @edgeone/pages-blob` (preinstalled in the Builder template); credential-free inside Pages Functions. `ai` keeps using `CHATU_DATA_URL` + `CHATU_APP_KEY` |
 | none | **memory** — in-process, lost on restart | local dev / fallback |
 
 ## AI (LLM relay)

package/dist/ai.js

@@ -1,4 +1,4 @@
-import { resolveConfig } from './config.js';
+import { resolveAiConfig } from './config.js';
 import { AppSdkError } from './errors.js';
 const toMessages = (input) => (typeof input === 'string' ? [{ role: 'user', content: input }] : input);
 function buildBody(cfg, messages, opts, stream) {
@@ -130,11 +130,11 @@ function notConfigured() {
 let cached = null;
 /** 按当前配置取 AI 客户端（惰性、缓存；configure() 后自动重建） */
 export function getAi() {
-    const cfg = resolveConfig();
-    const key = cfg.kind === 'platform' ? `platform|${cfg.aiBaseUrl}|${cfg.aiModel ?? ''}|${cfg.apiKey.slice(-4)}` : cfg.kind;
-    const fetchImpl = cfg.kind === 'platform' ? cfg.fetchImpl : undefined;
+    const cfg = resolveAiConfig();
+    const key = cfg ? `platform|${cfg.aiBaseUrl}|${cfg.aiModel ?? ''}|${cfg.apiKey.slice(-4)}` : 'none';
+    const fetchImpl = cfg?.fetchImpl;
     if (!cached || cached.key !== key || cached.fetchImpl !== fetchImpl)
-        cached = { key, fetchImpl, client: cfg.kind === 'platform' ? platformAi(cfg) : notConfigured() };
+        cached = { key, fetchImpl, client: cfg ? platformAi(cfg) : notConfigured() };
     return cached.client;
 }
 /** 便捷单例：`import { ai } from '@chatu-ai/app-sdk'` */

package/dist/config.d.ts

@@ -4,7 +4,7 @@
  * - 都没有 → memory（进程内存，重启即丢；本地开发/无配置降级）
  * 只在服务端使用（Route Handler / Server Component / Server Action）；密钥不得暴露给浏览器。
  */
-export type DriverKind = 'platform' | 'byo' | 'memory';
+export type DriverKind = 'platform' | 'byo' | 'memory' | 'edgeone';
 export interface PlatformConfig {
     kind: 'platform';
     baseUrl: string;
@@ -34,7 +34,21 @@ export interface ByoConfig {
         forcePathStyle: boolean;
     };
 }
-export type ResolvedConfig = PlatformConfig | ByoConfig | MemoryConfig;
+/**
+ * EdgeOne Pages Blob（部署到 EdgeOne 时可选）：kv 与 storage 都落在 Pages Blob（`@edgeone/pages-blob`）
+ * - Pages 函数内免凭据；外部访问（如平台侧只读浏览）需 projectId + API token
+ * - CHATU_DATA_DRIVER=edgeone 启用；store 名可用 CHATU_EDGEONE_KV_STORE / CHATU_EDGEONE_STORAGE_STORE 覆盖
+ */
+export interface EdgeoneConfig {
+    kind: 'edgeone';
+    kvStore: string;
+    storageStore: string;
+    projectId?: string;
+    token?: string;
+    /** 应用内代理读取路由前缀（storage.url() 返回 `${publicPathPrefix}/<key>`；模板内置 /_chatu/blob） */
+    publicPathPrefix: string;
+}
+export type ResolvedConfig = PlatformConfig | ByoConfig | MemoryConfig | EdgeoneConfig;
 export interface ConfigureOptions {
     baseUrl?: string;
     apiKey?: string;
@@ -59,5 +73,10 @@ export declare function describe(): {
     kv?: string;
     storage?: string;
 };
-/** 动态加载可选依赖（ioredis / @aws-sdk/*），不参与打包静态分析；缺失时给出可操作的错误 */
+/**
+ * AI 中继配置与数据驱动解耦：只要有 CHATU_DATA_URL + CHATU_APP_KEY 就可用（数据走 EdgeOne/byo 时 ai 仍走平台）
+ */
+export declare function resolveAiConfig(): PlatformConfig | null;
+/** 测试/打包器场景：预注册可选依赖模块，optionalImport 直接返回（不走动态 import） */
+export declare function registerOptionalModule(name: string, mod: unknown): void;
 export declare function optionalImport<T = any>(name: string, hint: string): Promise<T>;

package/dist/config.js

@@ -11,7 +11,21 @@ export function resolveConfig() {
     const apiKey = override.apiKey ?? env.CHATU_APP_KEY ?? env.CHATU_CUSTOMER_API_KEY;
     const redisUrl = env.REDIS_URL;
     const s3Bucket = env.S3_BUCKET;
-    const driver = override.driver ?? (baseUrl && apiKey ? 'platform' : redisUrl || s3Bucket ? 'byo' : 'memory');
+    const envDriver = (env.CHATU_DATA_DRIVER ?? '').toLowerCase();
+    const driver = override.driver ??
+        (envDriver === 'edgeone' || envDriver === 'byo' || envDriver === 'memory' || envDriver === 'platform'
+            ? envDriver
+            : baseUrl && apiKey ? 'platform' : redisUrl || s3Bucket ? 'byo' : 'memory');
+    if (driver === 'edgeone') {
+        return {
+            kind: 'edgeone',
+            kvStore: env.CHATU_EDGEONE_KV_STORE || 'chatu-kv',
+            storageStore: env.CHATU_EDGEONE_STORAGE_STORE || 'chatu-storage',
+            projectId: env.EDGEONE_BLOB_PROJECT_ID || undefined,
+            token: env.EDGEONE_BLOB_TOKEN || undefined,
+            publicPathPrefix: (env.CHATU_BLOB_PUBLIC_PATH || '/_chatu/blob').replace(/\/+$/, ''),
+        };
+    }
     if (driver === 'byo') {
         return {
             kind: 'byo',
@@ -66,15 +80,48 @@ export function describe() {
         return { driver: 'platform', env: c.env, baseUrl: c.baseUrl };
     if (c.kind === 'byo')
         return { driver: 'byo', kv: c.redisUrl ? 'redis' : 'memory', storage: c.s3 ? 's3' : 'memory' };
+    if (c.kind === 'edgeone')
+        return { driver: 'edgeone', kv: `blob:${c.kvStore}`, storage: `blob:${c.storageStore}` };
     return { driver: 'memory' };
 }
-/** 动态加载可选依赖（ioredis / @aws-sdk/*），不参与打包静态分析；缺失时给出可操作的错误 */
+/**
+ * AI 中继配置与数据驱动解耦：只要有 CHATU_DATA_URL + CHATU_APP_KEY 就可用（数据走 EdgeOne/byo 时 ai 仍走平台）
+ */
+export function resolveAiConfig() {
+    const c = resolveConfig();
+    if (c.kind === 'platform')
+        return c;
+    const proc = globalThis.process;
+    const env = proc?.env ?? {};
+    const baseUrl = override.baseUrl ?? env.CHATU_DATA_URL;
+    const apiKey = override.apiKey ?? env.CHATU_APP_KEY ?? env.CHATU_CUSTOMER_API_KEY;
+    if (!baseUrl || !apiKey)
+        return null;
+    const normalizedBase = baseUrl.replace(/\/+$/, '');
+    return {
+        kind: 'platform',
+        baseUrl: normalizedBase,
+        apiKey,
+        env: (override.env ?? env.CHATU_DATA_ENV ?? 'dev').toLowerCase() === 'prod' ? 'prod' : 'dev',
+        fetchImpl: override.fetchImpl ?? fetch,
+        aiBaseUrl: (override.aiBaseUrl ?? env.CHATU_AI_URL ?? deriveAiBaseUrl(normalizedBase)).replace(/\/+$/, ''),
+        aiModel: override.model ?? env.CHATU_AI_MODEL ?? env.PRIMARY_MODEL,
+    };
+}
+/** 动态加载可选依赖（ioredis / @aws-sdk/* / @edgeone/pages-blob），不参与打包静态分析；缺失时给出可操作的错误 */
+const registeredModules = new Map();
+/** 测试/打包器场景：预注册可选依赖模块，optionalImport 直接返回（不走动态 import） */
+export function registerOptionalModule(name, mod) {
+    registeredModules.set(name, mod);
+}
 export async function optionalImport(name, hint) {
+    if (registeredModules.has(name))
+        return registeredModules.get(name);
     try {
         const dyn = new Function('m', 'return import(m)');
         return await dyn(name);
     }
     catch {
-        throw new Error(`@chatu-ai/app-sdk: byo driver requires "${name}" — ${hint}`);
+        throw new Error(`@chatu-ai/app-sdk: driver requires "${name}" — ${hint}`);
     }
 }

package/dist/edgeone.d.ts

@@ -0,0 +1,8 @@
+import type { EdgeoneConfig } from './config.js';
+import type { KvClient } from './kv.js';
+import type { StorageClient } from './storage.js';
+/** kv 键 → Blob key：逐字符编码保持前缀关系（list(prefix) 可用），'/' 保留为目录分隔 */
+export declare function encodeKvKey(key: string): string;
+export declare function decodeKvKey(key: string): string;
+export declare function edgeoneKv(cfg: EdgeoneConfig): KvClient;
+export declare function edgeoneStorage(cfg: EdgeoneConfig): StorageClient;

package/dist/edgeone.js

@@ -0,0 +1,205 @@
+import { optionalImport } from './config.js';
+import { AppSdkError } from './errors.js';
+const HINT = 'run `npm i @edgeone/pages-blob` (preinstalled in the ChatU Builder template)';
+function storeFactory(cfg) {
+    let modPromise = null;
+    const cache = new Map();
+    return (name) => {
+        let p = cache.get(name);
+        if (!p) {
+            p = (modPromise ??= optionalImport('@edgeone/pages-blob', HINT)).then(m => {
+                const getStore = m.getStore ?? m.default?.getStore;
+                if (typeof getStore !== 'function')
+                    throw new AppSdkError('EDGEONE_SDK', '@edgeone/pages-blob: getStore not found');
+                return cfg.projectId && cfg.token
+                    ? getStore({ name, projectId: cfg.projectId, token: cfg.token, consistency: 'strong' })
+                    : getStore(name);
+            });
+            cache.set(name, p);
+        }
+        return p;
+    };
+}
+/** kv 键 → Blob key：逐字符编码保持前缀关系（list(prefix) 可用），'/' 保留为目录分隔 */
+export function encodeKvKey(key) {
+    return key
+        .split('/')
+        .map(seg => encodeURIComponent(seg).replace(/[!'()*]/g, c => `%${c.charCodeAt(0).toString(16).toUpperCase()}`))
+        .join('/');
+}
+export function decodeKvKey(key) {
+    try {
+        return key.split('/').map(decodeURIComponent).join('/');
+    }
+    catch {
+        return key;
+    }
+}
+function wrapErr(e, what) {
+    if (e instanceof AppSdkError)
+        return e;
+    const code = typeof e?.code === 'string' ? e.code : 'EDGEONE_BLOB';
+    return new AppSdkError(code, `${what}: ${e?.message ?? String(e)}`);
+}
+export function edgeoneKv(cfg) {
+    const getStore = storeFactory(cfg);
+    const store = () => getStore(cfg.kvStore);
+    const readEnv = async (key) => {
+        const s = await store();
+        let raw;
+        try {
+            raw = await s.get(encodeKvKey(key), { type: 'json', consistency: 'strong' });
+        }
+        catch (e) {
+            throw wrapErr(e, 'kv get');
+        }
+        if (raw === null || raw === undefined)
+            return null;
+        const env = raw && typeof raw === 'object' && 'v' in raw ? raw : { v: raw };
+        if (env.exp !== undefined && Date.now() > env.exp) {
+            void s.delete(encodeKvKey(key)).catch(() => undefined);
+            return null;
+        }
+        return env;
+    };
+    const writeEnv = async (key, env) => {
+        const s = await store();
+        try {
+            await s.setJSON(encodeKvKey(key), env);
+        }
+        catch (e) {
+            throw wrapErr(e, 'kv set');
+        }
+    };
+    return {
+        async get(key) { return (await readEnv(key))?.v ?? null; },
+        async set(key, value, opts) { await writeEnv(key, { v: value, exp: opts?.ex ? Date.now() + opts.ex * 1000 : undefined }); },
+        async del(key) {
+            const s = await store();
+            const existed = (await readEnv(key)) !== null;
+            try {
+                await s.delete(encodeKvKey(key));
+            }
+            catch (e) {
+                throw wrapErr(e, 'kv del');
+            }
+            return existed;
+        },
+        async incr(key, by = 1) {
+            const env = await readEnv(key);
+            const cur = Number(env?.v ?? 0);
+            if (!Number.isInteger(cur))
+                throw new AppSdkError('NOT_AN_INTEGER', 'value is not an integer');
+            const next = cur + by;
+            await writeEnv(key, { v: next, exp: env?.exp });
+            return next;
+        },
+        async expire(key, seconds) {
+            const env = await readEnv(key);
+            if (!env)
+                return false;
+            await writeEnv(key, { v: env.v, exp: Date.now() + seconds * 1000 });
+            return true;
+        },
+        async mget(keys) { return Promise.all(keys.map(async (k) => (await readEnv(k))?.v ?? null)); },
+        async list(prefix = '', opts) {
+            const s = await store();
+            let r;
+            try {
+                r = await s.list({ prefix: encodeKvKey(prefix), cursor: opts?.cursor ?? undefined, limit: opts?.limit ?? 100, paginate: false, consistency: 'strong' });
+            }
+            catch (e) {
+                throw wrapErr(e, 'kv list');
+            }
+            return { keys: r.blobs.map(b => decodeKvKey(b.key)), nextCursor: r.cursor ?? null };
+        },
+    };
+}
+export function edgeoneStorage(cfg) {
+    const getStore = storeFactory(cfg);
+    const store = () => getStore(cfg.storageStore);
+    const enc = (key) => key.split('/').map(encodeURIComponent).join('/');
+    const toBlob = async (data, contentType) => {
+        if (data instanceof Blob)
+            return contentType && data.type !== contentType ? new Blob([await data.arrayBuffer()], { type: contentType }) : data;
+        const bytes = typeof data === 'string' ? new TextEncoder().encode(data) : data instanceof Uint8Array ? data : new Uint8Array(data);
+        return new Blob([bytes], { type: contentType ?? 'application/octet-stream' });
+    };
+    const head = async (key) => {
+        const s = await store();
+        let m;
+        try {
+            m = await s.getMetadata(key, { consistency: 'strong' });
+        }
+        catch (e) {
+            throw wrapErr(e, 'storage head');
+        }
+        if (!m)
+            return null;
+        const len = Number(m.headers?.['content-length'] ?? m.headers?.['Content-Length'] ?? 0);
+        const lm = m.headers?.['last-modified'] ?? m.headers?.['Last-Modified'] ?? null;
+        return { key, size: Number.isFinite(len) ? len : 0, lastModified: lm };
+    };
+    return {
+        async put(key, data, opts) {
+            const s = await store();
+            const blob = await toBlob(data, opts?.contentType);
+            try {
+                await s.set(key, blob);
+            }
+            catch (e) {
+                throw wrapErr(e, 'storage put');
+            }
+            return { key, size: blob.size };
+        },
+        async uploadUrl(key, opts) {
+            const s = await store();
+            const expireSeconds = 600;
+            let r;
+            try {
+                r = await s.createUploadUrl(key, { expireSeconds, contentType: opts?.contentType });
+            }
+            catch (e) {
+                throw wrapErr(e, 'storage uploadUrl');
+            }
+            return { url: r.url, method: 'PUT', expiresIn: expireSeconds, headers: opts?.contentType ? { 'content-type': opts.contentType } : undefined };
+        },
+        async get(key) {
+            const s = await store();
+            let buf;
+            try {
+                buf = await s.get(key, { type: 'arrayBuffer', consistency: 'strong' });
+            }
+            catch (e) {
+                throw wrapErr(e, 'storage get');
+            }
+            return buf ? new Uint8Array(buf) : null;
+        },
+        async url(key, opts) {
+            // Pages Blob 无公开读地址：走应用内代理路由（模板内置），下载名通过 query 传给路由
+            const q = opts?.downloadName ? `?download=${encodeURIComponent(opts.downloadName)}` : '';
+            return `${cfg.publicPathPrefix}/${enc(key)}${q}`;
+        },
+        head,
+        async delete(key) {
+            const s = await store();
+            try {
+                await s.delete(key);
+            }
+            catch (e) {
+                throw wrapErr(e, 'storage delete');
+            }
+        },
+        async list(prefix = '', opts) {
+            const s = await store();
+            let r;
+            try {
+                r = await s.list({ prefix, cursor: opts?.cursor ?? undefined, limit: opts?.limit ?? 100, paginate: false, consistency: 'strong' });
+            }
+            catch (e) {
+                throw wrapErr(e, 'storage list');
+            }
+            return { items: r.blobs.map(b => ({ key: b.key, size: 0, lastModified: null })), nextCursor: r.cursor ?? null };
+        },
+    };
+}

package/dist/edgeone.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/edgeone.test.js

@@ -0,0 +1,75 @@
+import { beforeEach, describe as d, expect, it } from 'vitest';
+import { configure, describe, kv, storage, registerOptionalModule, encodeKvKey, decodeKvKey } from './index';
+/** 内存版 Pages Blob store：模拟 @edgeone/pages-blob 的 getStore */
+function fakeBlobModule() {
+    const stores = new Map();
+    const getStore = (arg) => {
+        const name = typeof arg === 'string' ? arg : arg.name;
+        let m = stores.get(name);
+        if (!m) {
+            m = new Map();
+            stores.set(name, m);
+        }
+        const map = m;
+        return {
+            async set(key, value) { map.set(key, { body: value }); },
+            async setJSON(key, value) { map.set(key, { body: JSON.stringify(value), json: value }); },
+            async get(key, opts) {
+                const e = map.get(key);
+                if (!e)
+                    return null;
+                if (opts?.type === 'json')
+                    return e.json ?? JSON.parse(String(e.body));
+                if (opts?.type === 'arrayBuffer')
+                    return e.body instanceof Blob ? await e.body.arrayBuffer() : new TextEncoder().encode(String(e.body)).buffer;
+                return e.body instanceof Blob ? await e.body.text() : String(e.body);
+            },
+            async getMetadata(key) { const e = map.get(key); return e ? { headers: { 'content-length': String(e.body instanceof Blob ? e.body.size : String(e.body).length) } } : null; },
+            async delete(key) { map.delete(key); },
+            async list(opts) {
+                const keys = [...map.keys()].filter(k => k.startsWith(opts?.prefix ?? '')).sort();
+                return { blobs: keys.slice(0, opts?.limit ?? 100).map(key => ({ key, etag: 'x' })) };
+            },
+            async createUploadUrl(key, opts) { return { url: `https://blob.test/${name}/${key}?sig=1`, key, expiresAt: Date.now() + (opts?.expireSeconds ?? 3600) * 1000 }; },
+        };
+    };
+    return { getStore, stores };
+}
+d('edgeone driver (Pages Blob)', () => {
+    beforeEach(() => {
+        registerOptionalModule('@edgeone/pages-blob', fakeBlobModule());
+        configure({ driver: 'edgeone' });
+    });
+    it('kv: envelope, ttl, incr, list with encoded prefix', async () => {
+        expect(describe().driver).toBe('edgeone');
+        await kv.set('todos:1', { a: 1 });
+        expect(await kv.get('todos:1')).toEqual({ a: 1 });
+        expect(await kv.incr('views')).toBe(1);
+        expect(await kv.incr('views', 5)).toBe(6);
+        await kv.set('todos:2', 'x', { ex: -1 }); // 已过期
+        expect(await kv.get('todos:2')).toBeNull();
+        await kv.set('todos:3', 'y');
+        expect((await kv.list('todos:')).keys).toEqual(['todos:1', 'todos:3']);
+        expect(await kv.mget(['todos:1', 'nope'])).toEqual([{ a: 1 }, null]);
+        expect(await kv.del('todos:1')).toBe(true);
+        expect(await kv.del('todos:1')).toBe(false);
+    });
+    it('storage: put/get/head/list/uploadUrl/url', async () => {
+        const r = await storage.put('photos/a.txt', 'hello', { contentType: 'text/plain' });
+        expect(r.size).toBe(5);
+        expect(new TextDecoder().decode((await storage.get('photos/a.txt')))).toBe('hello');
+        expect((await storage.head('photos/a.txt'))?.size).toBe(5);
+        expect((await storage.list('photos/')).items.map(i => i.key)).toEqual(['photos/a.txt']);
+        const up = await storage.uploadUrl('photos/b.png', { contentType: 'image/png' });
+        expect(up.method).toBe('PUT');
+        expect(up.url).toContain('photos/b.png');
+        expect(await storage.url('photos/a.txt', { downloadName: 'x.txt' })).toBe('/_chatu/blob/photos/a.txt?download=x.txt');
+        await storage.delete('photos/a.txt');
+        expect(await storage.get('photos/a.txt')).toBeNull();
+    });
+    it('key encoding keeps prefix order and round-trips', () => {
+        expect(encodeKvKey('todos:1/x y')).toBe('todos%3A1/x%20y');
+        expect(decodeKvKey(encodeKvKey('a:b/c d'))).toBe('a:b/c d');
+        expect(encodeKvKey('todos:12').startsWith(encodeKvKey('todos:1'))).toBe(true);
+    });
+});

package/dist/index.d.ts

@@ -1,9 +1,10 @@
 export { kv, getKv } from './kv.js';
 export type { KvClient, KvSetOptions, KvListResult } from './kv.js';
-export { configure, describe } from './config.js';
+export { configure, describe, registerOptionalModule } from './config.js';
 export type { ConfigureOptions, DriverKind } from './config.js';
 export { AppSdkError } from './errors.js';
 export { storage, getStorage } from './storage.js';
 export type { StorageClient, StorageObject, StorageListResult, UploadUrlResult } from './storage.js';
 export { ai, getAi } from './ai.js';
 export type { AiClient, AiMessage, AiChatOptions, AiChatResult, AiUsage } from './ai.js';
+export { encodeKvKey, decodeKvKey } from './edgeone.js';

package/dist/index.js

@@ -1,5 +1,6 @@
 export { kv, getKv } from './kv.js';
-export { configure, describe } from './config.js';
+export { configure, describe, registerOptionalModule } from './config.js';
 export { AppSdkError } from './errors.js';
 export { storage, getStorage } from './storage.js';
 export { ai, getAi } from './ai.js';
+export { encodeKvKey, decodeKvKey } from './edgeone.js';

package/dist/kv.js

@@ -1,6 +1,7 @@
 import { resolveConfig } from './config.js';
 import { AppSdkError } from './errors.js';
 import { byoKv } from './byo.js';
+import { edgeoneKv } from './edgeone.js';
 // ---------- platform driver ----------
 function platformKv(cfg) {
     const headers = { 'x-api-key': cfg.apiKey, 'x-chatu-env': cfg.env, 'content-type': 'application/json' };
@@ -68,9 +69,9 @@ let cached = null;
 /** 按当前配置取 KV 客户端（惰性、缓存；configure() 后自动重建） */
 export function getKv() {
     const cfg = resolveConfig();
-    const key = cfg.kind === 'platform' ? `platform|${cfg.baseUrl}|${cfg.env}|${cfg.apiKey.slice(-4)}` : cfg.kind === 'byo' ? `byo|${cfg.redisUrl ?? ''}|${cfg.kvPrefix}` : 'memory';
+    const key = cfg.kind === 'platform' ? `platform|${cfg.baseUrl}|${cfg.env}|${cfg.apiKey.slice(-4)}` : cfg.kind === 'byo' ? `byo|${cfg.redisUrl ?? ''}|${cfg.kvPrefix}` : cfg.kind === 'edgeone' ? `edgeone|${cfg.kvStore}|${cfg.projectId ?? ''}` : 'memory';
     if (!cached || cached.key !== key)
-        cached = { key, client: cfg.kind === 'platform' ? platformKv(cfg) : cfg.kind === 'byo' ? byoKv(cfg, memoryKv()) : memoryKv() };
+        cached = { key, client: cfg.kind === 'platform' ? platformKv(cfg) : cfg.kind === 'byo' ? byoKv(cfg, memoryKv()) : cfg.kind === 'edgeone' ? edgeoneKv(cfg) : memoryKv() };
     return cached.client;
 }
 /** 便捷单例：`import { kv } from '@chatu-ai/app-sdk'` */

package/dist/storage.js

@@ -1,4 +1,5 @@
 import { resolveConfig } from './config.js';
+import { edgeoneStorage } from './edgeone.js';
 import { AppSdkError } from './errors.js';
 import { byoStorage } from './byo.js';
 function toBytes(data) {
@@ -97,9 +98,9 @@ function memoryStorage() {
 let cached = null;
 export function getStorage() {
     const cfg = resolveConfig();
-    const key = cfg.kind === 'platform' ? `platform|${cfg.baseUrl}|${cfg.env}|${cfg.apiKey.slice(-4)}` : cfg.kind === 'byo' ? `byo|${cfg.s3?.bucket ?? ''}|${cfg.s3?.prefix ?? ''}` : 'memory';
+    const key = cfg.kind === 'platform' ? `platform|${cfg.baseUrl}|${cfg.env}|${cfg.apiKey.slice(-4)}` : cfg.kind === 'byo' ? `byo|${cfg.s3?.bucket ?? ''}|${cfg.s3?.prefix ?? ''}` : cfg.kind === 'edgeone' ? `edgeone|${cfg.storageStore}|${cfg.projectId ?? ''}` : 'memory';
     if (!cached || cached.key !== key)
-        cached = { key, client: cfg.kind === 'platform' ? platformStorage(cfg) : cfg.kind === 'byo' ? byoStorage(cfg, memoryStorage()) : memoryStorage() };
+        cached = { key, client: cfg.kind === 'platform' ? platformStorage(cfg) : cfg.kind === 'byo' ? byoStorage(cfg, memoryStorage()) : cfg.kind === 'edgeone' ? edgeoneStorage(cfg) : memoryStorage() };
     return cached.client;
 }
 export const storage = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chatu-ai/app-sdk",
-  "version": "0.7.6",
+  "version": "0.7.7",
   "description": "Runtime SDK for apps generated by ChatU Builder: kv, storage and ai (OpenAI-compatible LLM relay) with platform / byo / memory drivers selected by environment variables",
   "license": "MIT",
   "type": "module",