tezign-ai-appstore-sdk 0.1.4 → 0.2.0-beta.2

package/README.md

@@ -1,152 +1,84 @@
 # tezign-ai-appstore-sdk
 
-AI 应用商店 SDK：提供文件上传和结构化数据存储功能。
+AI 应用商店 SDK：提供开放接口、文件上传和结构化数据存储。
 
-## 安装
+## 文档索引
 
-```bash
-npm install tezign-ai-appstore-sdk
-```
+本包按能力拆分为多篇专文，关系如下：
 
-## 快速开始
+- **Open API**
+  - [Open API / TS API](./docs/open-api-ts-api.md) — 第三方在代码中显式传 key 调用开放接口。
+  - [Open API CLI](./docs/open-api-cli.md) — 命令与程序化 CLI API 的完整参考（环境、绑定、自动打包、认证等）。
+  - [Open API CLI 使用 SOP](./docs/open-api-cli-sop.md) — 按场景的操作步骤，细节与参数以 CLI 专文为准。
+- **其他能力**
+  - [OSS 上传](./docs/oss-upload.md)
+  - [Storage v2](./docs/storage-v2.md) — 客户端、Schema、类型化增删改查、错误与示例（**主技术文档**）。
+  - [SCHEMA.md](./docs/SCHEMA.md) — 在 Storage v2 之上侧重建模、校验、注册表与工程化实践，与上篇有分工。
+  - [STORAGE_V2_LLM_REFERENCE.md](./docs/STORAGE_V2_LLM_REFERENCE.md) — 给 LLM/Agent 的约定与易错点，与实现冲突时以代码为准。
 
-### 文件上传
+专文细节不在此重复；下方「快速开始」仅提供最短可运行提示。
 
-```ts
-import { createOssUploadClient } from 'tezign-ai-appstore-sdk'
+## 如何选择
 
-const client = createOssUploadClient({
-  baseUrl: 'https://platform.example.com',
-  projectId: 'your-project-id',
-  getAccessToken: async () => 'your-token',
-})
+- 接第三方应用或服务端直调开放接口 → [Open API / TS API](./docs/open-api-ts-api.md)
+- 终端里授权与部署 → [SOP](./docs/open-api-cli-sop.md) + [Open API CLI](./docs/open-api-cli.md)
+- 本地上传业务文件 → [OSS 上传](./docs/oss-upload.md)
+- 结构化存储与 Schema → 先 [Storage v2](./docs/storage-v2.md)，需要建模深度说明再读 [SCHEMA.md](./docs/SCHEMA.md)
 
-const result = await client.upload({
-  file,
-  onProgress: (p) => console.log(`${p.loaded}/${p.total}`),
-})
+## 安装
 
-console.log(result.publicUrl)
+```bash
+npm install tezign-ai-appstore-sdk
 ```
 
-### 结构化数据存储
+## 快速开始
 
-```ts
-import { createSchemaClient, createSchema } from 'tezign-ai-appstore-sdk'
+各能力有独立专文，避免在此重复展开；下面仅作最小可运行提示。
 
-// 定义数据模型
-const postSchema = createSchema('posts')
-  .string('title', { required: true, filterable: true })
-  .string('content', { required: true })
-  .string('status', { enum: ['draft', 'published'], filterable: true })
-  .setVersion(1)
-  .build()
+### Open API（TypeScript 客户端）
 
-// 创建客户端（同步返回，自动初始化 + 自动迁移）
-const db = createSchemaClient({ posts: postSchema }, storageClient)
+```ts
+import { createOpenApiClient } from 'tezign-ai-appstore-sdk'
 
-// 数据操作（类型完全推导，自动等待初始化完成）
-const post = await db.posts.create('post-1', {
-  title: 'Hello',
-  content: 'World',
-  status: 'published',
+const client = createOpenApiClient({
+  baseUrl: 'https://platform.example.com',
+  apiKey: process.env.TEZIGN_OPEN_API_KEY,
 })
 ```
 
-## 核心概念
+密钥解析顺序、全部方法与错误类型见 [Open API / TS API](./docs/open-api-ts-api.md)。
 
-**统一入口**：所有数据建模和操作通过 `createSchemaClient` 完成。
+### Open API CLI
 
-1. **定义 Schema** - 使用 `createSchema` 定义数据模型
-2. **创建客户端** - 使用 `createSchemaClient` 自动完成初始化、迁移和客户端创建
-3. **数据操作** - 通过返回的客户端进行类型安全的数据操作
+终端用户推荐用 `tezign-ai-appstore` 管理环境、授权与项目。最常用命令与说明见 [Open API CLI](./docs/open-api-cli.md)；分步操作见 [CLI 使用 SOP](./docs/open-api-cli-sop.md)。
 
-## Schema 定义
-
-```ts
-const postSchema = createSchema('posts')
-  .string('title', { required: true, filterable: true })
-  .string('content', { required: true })
-  .number('viewCount', { default: 0 })
-  .setVersion(1)
-  .setPolicy({
-    createSubjectsByScope: {
-      members: ['project:member'],
-    },
-  })
-  .build()
+```bash
+tezign-ai-appstore env add --env test --baseUrl https://test.example.com
+tezign-ai-appstore auth login --env test
+tezign-ai-appstore project init
 ```
 
-**字段类型**：`.string()` `.number()` `.boolean()` `.datetime()` `.json()`
+### OSS 上传
 
-**字段选项**：
-- `required` - 是否必填
-- `default` - 默认值
-- `filterable` - 是否可过滤
-- `sortable` - 是否可排序
-- `previousName` - 声明之前的字段名（用于字段更名）
+见 [OSS 上传](./docs/oss-upload.md)。
 
-## 自动迁移
+### Storage v2（结构化数据）
 
-`createSchemaClient` 自动检测并应用 Schema 变更：
+底层客户端、Schema、`createSchemaClient` 的完整 API 与类型见 [Storage v2](./docs/storage-v2.md)。数据建模、验证、多 Schema 管理见 [SCHEMA.md](./docs/SCHEMA.md)。面向 LLM/代码生成的补遗与边角行为见 [STORAGE_V2_LLM_REFERENCE.md](./docs/STORAGE_V2_LLM_REFERENCE.md)。
 
 ```ts
-// 字段更名
-const postSchemaV2 = createSchema('posts')
-  .string('title', { required: true })
-  .string('authorId', { 
-    filterable: true, 
-    previousName: 'author'  // 声明更名
-  })
-  .setVersion(2)
-  .build()
-
-const db = createSchemaClient({ posts: postSchemaV2 }, storageClient)
-```
-
-**预览变更**：
-
-```ts
-const db = createSchemaClient({ posts: postSchema }, storageClient, {
-  migrateOptions: {
-    dryRun: true,
-    onChangesDetected: (namespace, changes) => {
-      console.log(changes)
-    }
-  }
-})
-```
-
-## 数据操作
-
-```ts
-// 创建
-const post = await db.posts.create('post-1', { title: 'Hello' })
-
-// 获取
-const post = await db.posts.get('post-1')
+import { createStorageClient, createSchema, createSchemaClient } from 'tezign-ai-appstore-sdk'
 
-// 更新
-await db.posts.update('post-1', { title: 'Updated' }, post.version)
-
-// 删除
-await db.posts.delete('post-1')
-
-// 查询
-const result = await db.posts.findMany({
-  filter: { field: 'status', op: 'eq', value: 'published' },
-  sort: { field: '__sys.createdAt', direction: 'desc' },
-  limit: 20,
+const storageClient = createStorageClient({
+  baseUrl: 'https://platform.example.com',
+  getAccessToken: async () => 'your-token',
 })
 
-// 计数
-const count = await db.posts.count()
-```
-
-## 完整文档
-
-见 [API.md](./API.md)。
-
-## License
+const postSchema = createSchema('posts')
+  .string('title', { required: true })
+  .setVersion(1)
+  .build()
 
-MIT
+const db = createSchemaClient({ posts: postSchema }, storageClient)
+await db.posts.create('post-1', { title: 'Hello' })
+```

package/dist/cli/open-api.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=open-api.d.ts.map

package/dist/cli/open-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-api.d.ts","sourceRoot":"","sources":["../../src/cli/open-api.ts"],"names":[],"mappings":""}

package/dist/cli/open-api.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runOpenApiCli } from '../open-api/cli.js';
+await runOpenApiCli();
+//# sourceMappingURL=open-api.js.map

package/dist/cli/open-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-api.js","sourceRoot":"","sources":["../../src/cli/open-api.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,MAAM,aAAa,EAAE,CAAA"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { createStorageClient, StorageClient, StorageError } from './storage/storage.js';
 export type { StorageItem, Filter, Sort, StorageIndexDefinition, NamespacePolicy, PermissionResource, PermissionAction, CheckPermissionRequest, CheckPermissionResponse, } from './storage/storage-types.js';
-export { createSchema, SchemaBuilder, OWNER_ID, subject, buildAclConfig, } from './storage/schema.js';
+export { createSchema, SchemaBuilder, SchemaRegistry, SchemaValidator, OWNER_ID, subject, buildAclConfig, } from './storage/schema.js';
 export type { FieldDef, FieldPermission, StringFieldDef, NumberFieldDef, BooleanFieldDef, DateTimeFieldDef, JsonFieldDef, FieldsDefinition, SchemaDefinition, IndexConfig, AccessConfig, InferSchemaType, CreateSchemaType, UpdateSchemaType, SchemaAclConfig, AclConfig, } from './storage/schema.js';
 export type { TypedStorageClient } from './storage/typed-storage.js';
 export { createTypedStorage } from './storage/typed-storage.js';
@@ -10,4 +10,14 @@ export { createSchemaClient, defineSchemas, PermissionError, UserCancelledError,
 export type { SchemaDefinitions, InferSchemaTypes, CreateSchemaClientOptions, MigrateOptions, MigrationChange, MigrationResult, ConfirmDialogOptions, ConfirmDialogResult, ConfirmDialogFunction, } from './storage/schema-client.js';
 export { createOssUploadClient } from './uploader/index.js';
 export type { CreateOssUploadClientOptions, CompleteUploadResult, UploadListItem, UploadListResult, } from './uploader/index.js';
+export { createOpenApiClient, OpenApiError } from './open-api/client.js';
+export { createBrowserOpenApiKeyStore, DEFAULT_OPEN_API_STORAGE_KEY, } from './open-api/browser-key-store.js';
+export type { CreateBrowserOpenApiKeyStoreOptions } from './open-api/browser-key-store.js';
+export type { BrowserOpenApiKeyStore } from './open-api/types.js';
+export { DEFAULT_OPEN_API_ENV_KEY, readOpenApiRuntimeKey, writeOpenApiRuntimeKey, } from './open-api/runtime-key.js';
+export type { OpenApiRuntimeKeyOptions } from './open-api/runtime-key.js';
+export { createOpenApiCliClient, ensureOpenApiCliKey, runOpenApiCli, } from './open-api/cli.js';
+export type { OpenApiCliOptions, OpenApiCliIO } from './open-api/cli.js';
+export type { OpenApiCliAutoProvisionOptions } from './open-api/auto-provision.js';
+export type { CreateOpenApiClientOptions, CreateOpenApiProjectInput, UpdateOpenApiProjectInput, DeployOpenApiProjectInput, UploadOpenApiProjectSourceInput, OpenApiAppType, OpenApiProject, OpenApiDeployment, OpenApiProjectSourcePackage, OpenApiErrorPayload, OpenApiResponseEnvelope, OpenApiResponseMeta, } from './open-api/types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACvF,YAAY,EACV,WAAW,EACX,MAAM,EACN,IAAI,EACJ,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,OAAO,EACP,cAAc,GACf,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,QAAQ,EACR,eAAe,EACf,cAAc,EACd,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,SAAS,GACV,MAAM,qBAAqB,CAAA;AAE5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAE/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAA;AAC5E,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AAEjG,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,YAAY,GACb,MAAM,4BAA4B,CAAA;AACnC,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,YAAY,EACV,4BAA4B,EAC5B,oBAAoB,EACpB,cAAc,EACd,gBAAgB,GACjB,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACvF,YAAY,EACV,WAAW,EACX,MAAM,EACN,IAAI,EACJ,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,QAAQ,EACR,OAAO,EACP,cAAc,GACf,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,QAAQ,EACR,eAAe,EACf,cAAc,EACd,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,SAAS,GACV,MAAM,qBAAqB,CAAA;AAE5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAE/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAA;AAC5E,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AAEjG,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,YAAY,GACb,MAAM,4BAA4B,CAAA;AACnC,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,YAAY,EACV,4BAA4B,EAC5B,oBAAoB,EACpB,cAAc,EACd,gBAAgB,GACjB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxE,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,iCAAiC,CAAA;AACxC,YAAY,EAAE,mCAAmC,EAAE,MAAM,iCAAiC,CAAA;AAC1F,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,2BAA2B,CAAA;AAClC,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACzE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,GACd,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACxE,YAAY,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAA;AAClF,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,+BAA+B,EAC/B,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -1,7 +1,11 @@
 export { createStorageClient, StorageClient, StorageError } from './storage/storage.js';
-export { createSchema, SchemaBuilder, OWNER_ID, subject, buildAclConfig, } from './storage/schema.js';
+export { createSchema, SchemaBuilder, SchemaRegistry, SchemaValidator, OWNER_ID, subject, buildAclConfig, } from './storage/schema.js';
 export { createTypedStorage } from './storage/typed-storage.js';
 export { createFieldPermissionChecker } from './storage/field-permission.js';
 export { createSchemaClient, defineSchemas, PermissionError, UserCancelledError, SchemaClient, } from './storage/schema-client.js';
 export { createOssUploadClient } from './uploader/index.js';
+export { createOpenApiClient, OpenApiError } from './open-api/client.js';
+export { createBrowserOpenApiKeyStore, DEFAULT_OPEN_API_STORAGE_KEY, } from './open-api/browser-key-store.js';
+export { DEFAULT_OPEN_API_ENV_KEY, readOpenApiRuntimeKey, writeOpenApiRuntimeKey, } from './open-api/runtime-key.js';
+export { createOpenApiCliClient, ensureOpenApiCliKey, runOpenApiCli, } from './open-api/cli.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAavF,OAAO,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,OAAO,EACP,cAAc,GACf,MAAM,qBAAqB,CAAA;AAqB5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAE/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAA;AAG5E,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,YAAY,GACb,MAAM,4BAA4B,CAAA;AAanC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAavF,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,QAAQ,EACR,OAAO,EACP,cAAc,GACf,MAAM,qBAAqB,CAAA;AAqB5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAE/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAA;AAG5E,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,YAAY,GACb,MAAM,4BAA4B,CAAA;AAanC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAQ3D,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxE,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,iCAAiC,CAAA;AAGxC,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,GACd,MAAM,mBAAmB,CAAA"}

package/dist/open-api/auto-provision.d.ts

@@ -0,0 +1,23 @@
+export declare const OPEN_API_PROVISION_MESSAGE_TYPE = "tezign:open-api-key:provisioned";
+export interface OpenApiCliAutoProvisionOptions {
+    enabled?: boolean;
+    openApiPagePath?: string;
+    requestTimeoutMs?: number;
+    keyName?: string;
+    scopes?: string[];
+    openUrl?: (url: string) => void | Promise<void>;
+}
+interface EnsureAutoProvisionedOpenApiKeyOptions {
+    baseUrl: string;
+    envKey?: string;
+    storageKey?: string;
+    autoProvision?: boolean | OpenApiCliAutoProvisionOptions;
+}
+interface CliOpenCommandConfig {
+    command: string;
+    args: string[];
+}
+export declare function getCliProvisionOpenCommandConfig(platform: string, url: string): CliOpenCommandConfig;
+export declare function ensureAutoProvisionedOpenApiKey(options: EnsureAutoProvisionedOpenApiKeyOptions): Promise<string | null>;
+export {};
+//# sourceMappingURL=auto-provision.d.ts.map

package/dist/open-api/auto-provision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-provision.d.ts","sourceRoot":"","sources":["../../src/open-api/auto-provision.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,+BAA+B,oCAAoC,CAAA;AAehF,MAAM,WAAW,8BAA8B;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChD;AAED,UAAU,sCAAsC;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,OAAO,GAAG,8BAA8B,CAAA;CACzD;AA0BD,UAAU,oBAAoB;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAsUD,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACV,oBAAoB,CAatB;AAmDD,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,sCAAsC,GAC9C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgCxB"}

package/dist/open-api/auto-provision.js

@@ -0,0 +1,345 @@
+import { DEFAULT_OPEN_API_STORAGE_KEY } from './browser-key-store.js';
+import { DEFAULT_OPEN_API_ENV_KEY, readOpenApiRuntimeKey, writeOpenApiRuntimeKey } from './runtime-key.js';
+export const OPEN_API_PROVISION_MESSAGE_TYPE = 'tezign:open-api-key:provisioned';
+const DEFAULT_OPEN_API_PAGE_PATH = '/apps/open-api';
+const DEFAULT_OPEN_API_SCOPES = [
+    'project:read',
+    'project:create',
+    'project:update',
+    'project:deploy',
+    'deployment:read',
+];
+const DEFAULT_REQUEST_TIMEOUT_MS = 120000;
+const CLI_CALLBACK_PATH = '/__tezign_open_api_callback__';
+let pendingProvisionPromise = null;
+function isBrowserEnvironment() {
+    return typeof window !== 'undefined' && typeof document !== 'undefined';
+}
+function isNodeEnvironment() {
+    return typeof process !== 'undefined' && Boolean(process.versions?.node);
+}
+function importNodeModule(specifier) {
+    return import(/* @vite-ignore */ specifier);
+}
+function createRequestId() {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    return `open-api-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+}
+function buildDefaultKeyName() {
+    if (typeof window !== 'undefined') {
+        return `AI AppStore SDK / ${window.location.host}`.slice(0, 60);
+    }
+    const scriptName = typeof process !== 'undefined'
+        ? process.argv?.[1]?.split(/[\\/]/).pop() || process.title || 'cli'
+        : 'cli';
+    return `AI AppStore SDK / ${scriptName}`.slice(0, 60);
+}
+function normalizeAutoProvisionOptions(baseUrl, options) {
+    const rawOptions = typeof options === 'object' && options !== null
+        ? options
+        : {};
+    const enabled = options !== false && rawOptions.enabled !== false;
+    const appOrigin = typeof window !== 'undefined' ? window.location.origin : baseUrl;
+    const pageUrl = new URL(rawOptions.openApiPagePath || DEFAULT_OPEN_API_PAGE_PATH, baseUrl || appOrigin);
+    const keyName = (rawOptions.keyName || buildDefaultKeyName()).trim() || buildDefaultKeyName();
+    const scopes = Array.isArray(rawOptions.scopes)
+        ? Array.from(new Set(rawOptions.scopes
+            .filter((scope) => typeof scope === 'string')
+            .map((scope) => scope.trim())
+            .filter(Boolean)))
+        : [];
+    return {
+        enabled,
+        pageUrl,
+        requestTimeoutMs: typeof rawOptions.requestTimeoutMs === 'number' && rawOptions.requestTimeoutMs > 0
+            ? rawOptions.requestTimeoutMs
+            : DEFAULT_REQUEST_TIMEOUT_MS,
+        keyName: keyName.slice(0, 60),
+        scopes: scopes.length > 0 ? scopes : DEFAULT_OPEN_API_SCOPES,
+        targetOrigin: appOrigin,
+        openUrl: rawOptions.openUrl,
+    };
+}
+function buildProvisionPageUrl(config, requestId, extraParams) {
+    const pageUrl = new URL(config.pageUrl.toString());
+    pageUrl.searchParams.set('sdkAutoCreate', '1');
+    pageUrl.searchParams.set('sdkRequestId', requestId);
+    pageUrl.searchParams.set('sdkScopes', config.scopes.join(','));
+    pageUrl.searchParams.set('sdkKeyName', config.keyName);
+    for (const [key, value] of Object.entries(extraParams)) {
+        pageUrl.searchParams.set(key, value);
+    }
+    return pageUrl;
+}
+async function ensureBrowserOpenApiKey(options, config) {
+    const envKey = options.envKey || DEFAULT_OPEN_API_ENV_KEY;
+    const storageKey = options.storageKey || DEFAULT_OPEN_API_STORAGE_KEY;
+    if (!document.body) {
+        throw new Error('Document body is not ready for Open API auto provisioning');
+    }
+    return new Promise((resolve, reject) => {
+        const requestId = createRequestId();
+        const iframe = document.createElement('iframe');
+        const frameUrl = buildProvisionPageUrl(config, requestId, {
+            sdkTargetOrigin: config.targetOrigin,
+        });
+        const timeoutId = window.setTimeout(() => {
+            cleanup();
+            reject(new Error('Open API Key 自动创建超时，请稍后重试'));
+        }, config.requestTimeoutMs);
+        const cleanup = () => {
+            window.clearTimeout(timeoutId);
+            window.removeEventListener('message', handleMessage);
+            iframe.removeEventListener('error', handleError);
+            iframe.remove();
+        };
+        const handleError = () => {
+            cleanup();
+            reject(new Error('Open API 授权页加载失败'));
+        };
+        const handleMessage = (event) => {
+            if (event.origin !== config.pageUrl.origin)
+                return;
+            if (event.source !== iframe.contentWindow)
+                return;
+            const payload = event.data;
+            if (!payload || payload.type !== OPEN_API_PROVISION_MESSAGE_TYPE)
+                return;
+            if (payload.requestId !== requestId)
+                return;
+            cleanup();
+            if (!payload.success || typeof payload.apiKey !== 'string') {
+                reject(new Error(payload.error || 'Open API Key 自动创建失败'));
+                return;
+            }
+            const apiKey = writeOpenApiRuntimeKey(payload.apiKey, { envKey, storageKey });
+            resolve(apiKey);
+        };
+        window.addEventListener('message', handleMessage);
+        iframe.addEventListener('error', handleError);
+        iframe.style.display = 'none';
+        iframe.setAttribute('aria-hidden', 'true');
+        iframe.setAttribute('tabindex', '-1');
+        iframe.setAttribute('sandbox', 'allow-scripts allow-same-origin allow-forms');
+        iframe.src = frameUrl.toString();
+        document.body.appendChild(iframe);
+    });
+}
+async function readUrlEncodedBody(request) {
+    let body = '';
+    const textDecoder = new TextDecoder();
+    for await (const chunk of request) {
+        body += typeof chunk === 'string' ? chunk : textDecoder.decode(chunk, { stream: true });
+    }
+    body += textDecoder.decode();
+    return new URLSearchParams(body);
+}
+function renderCliCallbackHtml(title, message) {
+    return `<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>${title}</title>
+    <style>
+      body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; margin: 0; background: #f8fafc; color: #0f172a; }
+      main { max-width: 560px; margin: 64px auto; padding: 32px; background: white; border-radius: 24px; box-shadow: 0 20px 60px rgba(15, 23, 42, 0.08); }
+      h1 { margin: 0 0 12px; font-size: 24px; }
+      p { margin: 0; line-height: 1.7; color: #475569; }
+    </style>
+  </head>
+  <body>
+    <main>
+      <h1>${title}</h1>
+      <p>${message}</p>
+    </main>
+    <script>window.close()</script>
+  </body>
+</html>`;
+}
+function respondWithHtml(response, statusCode, title, message) {
+    response.statusCode = statusCode;
+    response.setHeader('Content-Type', 'text/html; charset=utf-8');
+    response.end(renderCliCallbackHtml(title, message));
+}
+async function createCliProvisionBridge(requestId, requestTimeoutMs) {
+    const { createServer } = await importNodeModule('node:http');
+    const state = createRequestId();
+    let server = null;
+    let isSettled = false;
+    let timeoutId = null;
+    let resolveResult;
+    let rejectResult;
+    const result = new Promise((resolve, reject) => {
+        resolveResult = resolve;
+        rejectResult = reject;
+    });
+    const dispose = () => {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            timeoutId = null;
+        }
+        if (server) {
+            server.close();
+            server = null;
+        }
+    };
+    const settle = (resolver) => {
+        if (isSettled)
+            return;
+        isSettled = true;
+        dispose();
+        resolver();
+    };
+    server = createServer(async (request, response) => {
+        const requestUrl = new URL(request.url || '/', 'http://127.0.0.1');
+        if (requestUrl.pathname !== CLI_CALLBACK_PATH) {
+            response.statusCode = 404;
+            response.end('Not Found');
+            return;
+        }
+        if (requestUrl.searchParams.get('state') !== state) {
+            respondWithHtml(response, 400, '请求无效', '回调状态校验失败，请重新发起 Open API 授权。');
+            return;
+        }
+        let payload;
+        if (request.method === 'POST') {
+            payload = await readUrlEncodedBody(request);
+        }
+        else if (request.method === 'GET') {
+            payload = requestUrl.searchParams;
+        }
+        else {
+            response.statusCode = 405;
+            response.end('Method Not Allowed');
+            return;
+        }
+        if (payload.get('requestId') !== requestId) {
+            respondWithHtml(response, 400, '请求无效', '授权请求标识不匹配，请重新发起 Open API 授权。');
+            return;
+        }
+        const status = payload.get('status');
+        if (status === 'success') {
+            const apiKey = payload.get('apiKey')?.trim();
+            if (!apiKey) {
+                respondWithHtml(response, 400, '回传失败', '页面没有返回可用的 Open API Key。');
+                return;
+            }
+            response.statusCode = 200;
+            response.setHeader('Content-Type', 'text/html; charset=utf-8');
+            response.end(renderCliCallbackHtml('授权完成', 'Open API Key 已回传给 CLI，当前终端会继续执行原始命令。你现在可以关闭这个页面。'), () => {
+                settle(() => resolveResult(apiKey));
+            });
+            return;
+        }
+        const errorMessage = payload.get('error')?.trim() || 'Open API Key 自动创建失败';
+        response.statusCode = 200;
+        response.setHeader('Content-Type', 'text/html; charset=utf-8');
+        response.end(renderCliCallbackHtml('授权失败', errorMessage), () => {
+            settle(() => rejectResult(new Error(errorMessage)));
+        });
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(0, '127.0.0.1', () => resolve());
+    });
+    const address = server.address();
+    const port = typeof address === 'object' && address ? address.port : null;
+    if (!port) {
+        dispose();
+        throw new Error('无法为 Open API CLI 授权分配本地回调端口');
+    }
+    timeoutId = setTimeout(() => {
+        settle(() => rejectResult(new Error('Open API Key 自动创建超时，请稍后重试')));
+    }, requestTimeoutMs);
+    const callbackUrl = new URL(CLI_CALLBACK_PATH, `http://127.0.0.1:${String(port)}`);
+    callbackUrl.searchParams.set('state', state);
+    return {
+        callbackUrl: callbackUrl.toString(),
+        dispose,
+        result,
+    };
+}
+export function getCliProvisionOpenCommandConfig(platform, url) {
+    if (platform === 'win32') {
+        return {
+            command: 'rundll32.exe',
+            args: ['url.dll,FileProtocolHandler', url],
+        };
+    }
+    if (platform === 'darwin') {
+        return { command: 'open', args: [url] };
+    }
+    return { command: 'xdg-open', args: [url] };
+}
+async function openCliProvisionUrl(url, openUrl) {
+    if (openUrl) {
+        await openUrl(url);
+        return;
+    }
+    const { spawn } = await importNodeModule('node:child_process');
+    const platform = typeof process !== 'undefined' ? process.platform : 'unknown';
+    const commandConfig = getCliProvisionOpenCommandConfig(platform, url);
+    await new Promise((resolve, reject) => {
+        const child = spawn(commandConfig.command, commandConfig.args, {
+            detached: true,
+            stdio: 'ignore',
+        });
+        child.once('error', reject);
+        child.once('spawn', () => {
+            child.unref();
+            resolve();
+        });
+    }).catch((error) => {
+        const message = error instanceof Error ? error.message : 'unknown error';
+        throw new Error(`无法自动打开浏览器，请手动访问此链接完成 Open API 授权：${url}（${message}）`);
+    });
+}
+async function ensureCliOpenApiKey(config) {
+    const requestId = createRequestId();
+    const bridge = await createCliProvisionBridge(requestId, config.requestTimeoutMs);
+    const pageUrl = buildProvisionPageUrl(config, requestId, {
+        sdkMode: 'cli',
+        sdkCallback: bridge.callbackUrl,
+    });
+    try {
+        await openCliProvisionUrl(pageUrl.toString(), config.openUrl);
+    }
+    catch (error) {
+        bridge.dispose();
+        throw error;
+    }
+    const apiKey = await bridge.result;
+    return apiKey;
+}
+export async function ensureAutoProvisionedOpenApiKey(options) {
+    const storageKey = options.storageKey || DEFAULT_OPEN_API_STORAGE_KEY;
+    if (isBrowserEnvironment()) {
+        const envKey = options.envKey || DEFAULT_OPEN_API_ENV_KEY;
+        const existingKey = readOpenApiRuntimeKey({ envKey, storageKey });
+        if (existingKey)
+            return existingKey;
+    }
+    const config = normalizeAutoProvisionOptions(options.baseUrl, options.autoProvision);
+    if (!config.enabled)
+        return null;
+    if (pendingProvisionPromise) {
+        return pendingProvisionPromise;
+    }
+    if (isBrowserEnvironment()) {
+        pendingProvisionPromise = ensureBrowserOpenApiKey(options, config).finally(() => {
+            pendingProvisionPromise = null;
+        });
+        return pendingProvisionPromise;
+    }
+    if (isNodeEnvironment()) {
+        pendingProvisionPromise = ensureCliOpenApiKey(config).finally(() => {
+            pendingProvisionPromise = null;
+        });
+        return pendingProvisionPromise;
+    }
+    return null;
+}
+//# sourceMappingURL=auto-provision.js.map