feat(api): 实现控制面/数据面分离的双层API架构

typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flexmodel/sdk",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "Flexmodel TypeScript SDK — Fluent query builder for data CRUD with API Key auth",
   "type": "module",
   "main": "./dist/index.cjs",

typescript/src/admin-namespaces.ts

@@ -0,0 +1,170 @@
+// ============================================================
+// Flexmodel SDK — Admin Namespaces
+//
+// Thin namespaces for admin API operations (project/user/apikey management).
+// Only available on FlexmodelAdminClient.
+// ============================================================
+
+import type {HttpTransport} from './http.js'
+
+// ---- Types ----
+
+export interface Project {
+    id: string
+    name: string
+    databaseName?: string
+
+    [key: string]: unknown
+}
+
+export interface CreateProjectRequest {
+    name: string
+
+    [key: string]: unknown
+}
+
+export interface User {
+    id: string
+    username?: string
+
+    [key: string]: unknown
+}
+
+export interface ApiKey {
+    id: string
+    name: string
+    keyPrefix: string
+    scope: 'admin' | 'open'
+    projectIds?: string
+    readOnly: boolean
+    expiresAt?: string | null
+    lastUsedAt?: string | null
+    createdAt?: string
+    key?: string | null
+}
+
+export interface CreateApiKeyRequest {
+    name: string
+    scope?: string
+    projectIds?: string
+    readOnly?: boolean
+}
+
+export interface AdminFunction {
+    id: string
+    name: string
+
+    [key: string]: unknown
+}
+
+export interface DeployFunctionRequest {
+    sourceFiles: Record<string, string>
+
+    [key: string]: unknown
+}
+
+// ---- ProjectsNamespace ----
+
+export class ProjectsNamespace {
+    private readonly http: HttpTransport
+
+    constructor(http: HttpTransport) {
+        this.http = http
+    }
+
+    async list(): Promise<Project[]> {
+        return this.http.request<Project[]>('GET', '/api/projects')
+    }
+
+    async create(data: CreateProjectRequest): Promise<Project> {
+        return this.http.request<Project>('POST', '/api/projects', {body: data})
+    }
+
+    async get(id: string): Promise<Project> {
+        return this.http.request<Project>('GET', `/api/projects/${id}`)
+    }
+
+    async update(id: string, data: Partial<Project>): Promise<Project> {
+        return this.http.request<Project>('PUT', `/api/projects/${id}`, {body: data})
+    }
+
+    async delete(id: string): Promise<void> {
+        await this.http.request<void>('DELETE', `/api/projects/${id}`)
+    }
+}
+
+// ---- UsersNamespace ----
+
+export class UsersNamespace {
+    private readonly http: HttpTransport
+
+    constructor(http: HttpTransport) {
+        this.http = http
+    }
+
+    async list(): Promise<User[]> {
+        return this.http.request<User[]>('GET', '/api/users')
+    }
+
+    async create(data: Record<string, unknown>): Promise<User> {
+        return this.http.request<User>('POST', '/api/users', {body: data})
+    }
+
+    async delete(id: string): Promise<void> {
+        await this.http.request<void>('DELETE', `/api/users/${id}`)
+    }
+}
+
+// ---- ApiKeysNamespace ----
+
+export class ApiKeysNamespace {
+    private readonly http: HttpTransport
+
+    constructor(http: HttpTransport) {
+        this.http = http
+    }
+
+    async list(): Promise<ApiKey[]> {
+        return this.http.request<ApiKey[]>('GET', '/api/api-keys')
+    }
+
+    async create(data: CreateApiKeyRequest): Promise<ApiKey> {
+        return this.http.request<ApiKey>('POST', '/api/api-keys', {body: data})
+    }
+
+    async regenerate(id: string): Promise<ApiKey> {
+        return this.http.request<ApiKey>('POST', `/api/api-keys/${id}/regenerate`)
+    }
+
+    async delete(id: string): Promise<void> {
+        await this.http.request<void>('DELETE', `/api/api-keys/${id}`)
+    }
+}
+
+// ---- AdminFunctionsNamespace ----
+
+export class AdminFunctionsNamespace {
+    private readonly http: HttpTransport
+
+    constructor(http: HttpTransport) {
+        this.http = http
+    }
+
+    async list(projectId: string): Promise<AdminFunction[]> {
+        return this.http.request<AdminFunction[]>('GET', `/api/projects/${projectId}/functions`)
+    }
+
+    async get(projectId: string, name: string): Promise<AdminFunction> {
+        return this.http.request<AdminFunction>('GET', `/api/projects/${projectId}/functions/${name}`)
+    }
+
+    async deploy(projectId: string, name: string, sourceFiles: Record<string, string>): Promise<AdminFunction> {
+        return this.http.request<AdminFunction>('POST', `/api/projects/${projectId}/functions/${name}/deploy`, {
+            body: {sourceFiles},
+        })
+    }
+
+    async delete(projectId: string, name: string): Promise<void> {
+        await this.http.request<void>('DELETE', `/api/projects/${projectId}/functions/${name}`)
+    }
+}