tezign-ai-appstore-sdk 0.1.1 → 0.1.2

package/README.md

@@ -1,8 +1,16 @@
 # tezign-ai-appstore-sdk
 
-浏览器端上传 SDK：调用平台的 uploads API 创建文件记录，获取最小权限 STS 临时凭证，然后使用 `ali-oss` 在浏览器侧执行 `multipartUpload` 上传，并返回你们的 CDN 永久公网链接。
+AI 应用商店 SDK：提供文件上传和结构化数据存储功能。
 
-## 使用方式（浏览器）
+## 安装
+
+```bash
+npm install tezign-ai-appstore-sdk
+```
+
+## 快速开始
+
+### 文件上传
 
 ```ts
 import { createOssUploadClient } from 'tezign-ai-appstore-sdk'
@@ -10,20 +18,135 @@ import { createOssUploadClient } from 'tezign-ai-appstore-sdk'
 const client = createOssUploadClient({
   baseUrl: 'https://platform.example.com',
   projectId: 'your-project-id',
-  // 第三方 Supabase：由业务方获取 access_token 后提供给 SDK
-  getAccessToken: async () => supabase.auth.getSession().then((r) => r.data.session?.access_token ?? null),
+  getAccessToken: async () => 'your-token',
 })
 
 const result = await client.upload({
   file,
-  onProgress: (p) => console.log(p.loaded, p.total),
+  onProgress: (p) => console.log(`${p.loaded}/${p.total}`),
+})
+
+console.log(result.publicUrl)
+```
+
+### 结构化数据存储
+
+```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()
+
+// 创建客户端（同步返回，自动初始化 + 自动迁移）
+const db = createSchemaClient({ posts: postSchema }, storageClient)
+
+// 数据操作（类型完全推导，自动等待初始化完成）
+const post = await db.posts.create('post-1', {
+  title: 'Hello',
+  content: 'World',
+  status: 'published',
 })
+```
+
+## 核心概念
+
+**统一入口**：所有数据建模和操作通过 `createSchemaClient` 完成。
+
+1. **定义 Schema** - 使用 `createSchema` 定义数据模型
+2. **创建客户端** - 使用 `createSchemaClient` 自动完成初始化、迁移和客户端创建
+3. **数据操作** - 通过返回的客户端进行类型安全的数据操作
 
-console.log(result.publicUrl) // https://{OSS_CDN_DOMAIN}/{objectKey}
+## 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()
 ```
 
-未提供 `getAccessToken` 时，SDK 默认使用 cookie（`credentials: 'include'`）。
+**字段类型**：`.string()` `.number()` `.boolean()` `.datetime()` `.json()`
+
+**字段选项**：
+- `required` - 是否必填
+- `default` - 默认值
+- `filterable` - 是否可过滤
+- `sortable` - 是否可排序
+- `previousName` - 声明之前的字段名（用于字段更名）
+
+## 自动迁移
+
+`createSchemaClient` 自动检测并应用 Schema 变更：
+
+```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')
+
+// 更新
+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 count = await db.posts.count()
+```
+
+## 完整文档
+
+见 [API.md](./API.md)。
 
-## API 文档
+## License
 
-见 `API.md`。
+MIT

package/dist/index.d.ts

@@ -1,15 +1,13 @@
 export { createStorageClient, StorageClient, StorageError } from './storage/storage.js';
-export type { StorageScope, StorageItem, QueryResult, FilterOp, FilterCondition, Filter, SortDirection, Sort, IndexFieldDef, StorageIndexDefinition, NamespacePolicy, BatchOperation, AclConfig, ReindexJob, ReindexStatus, ShareTokenInfo, ErrorCode, StorageResponse, StorageSuccess, CreateStorageClientOptions, GetOptions, QueryOptions, AdminJob, AdminJobStatus, ExportResult, ImportPreview, } from './storage/storage-types.js';
-export { createSchema, SchemaBuilder, SchemaValidator, SchemaRegistry, } from './storage/schema.js';
-export type { FieldType, FieldDef, FieldPermission, StringFieldDef, NumberFieldDef, BooleanFieldDef, DateTimeFieldDef, JsonFieldDef, FieldsDefinition, SchemaDefinition, IndexConfig, ScopeConfig, InferSchemaType, CreateSchemaType, UpdateSchemaType, ValidationError, ValidationResult, } from './storage/schema.js';
-export { FieldPermissionChecker, createFieldPermissionChecker, } from './storage/field-permission.js';
-export type { FieldPermissionContext, FieldPermissionCheck, } from './storage/field-permission.js';
-export { createTypedStorage, TypedStorageClient, } from './storage/typed-storage.js';
-export type { FieldFilter, TypedFilter, ListOptions, TypedStorageOptions, } from './storage/typed-storage.js';
-export { createSchemaClient, defineSchemas, defineAndCreate, } from './storage/schema-client.js';
-export type { SchemaDefinitions, InferSchemaTypes, } from './storage/schema-client.js';
-export { createMigrator, SchemaMigrator, } from './storage/migration.js';
-export type { MigrationRecord, MigrationAction, } from './storage/migration.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 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';
+export { createFieldPermissionChecker } from './storage/field-permission.js';
+export type { FieldPermissionContext, FieldPermissionCheck } from './storage/field-permission.js';
+export { createSchemaClient, defineSchemas, PermissionError, UserCancelledError, SchemaClient, } from './storage/schema-client.js';
+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, PrepareUploadInput, PrepareUploadResult, CompleteUploadResult, UploadTokenRef, UploadListItem, UploadListResult, } from './uploader/index.js';
+export type { CreateOssUploadClientOptions, CompleteUploadResult, UploadListItem, UploadListResult, } from './uploader/index.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":"AAGA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACvF,YAAY,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,QAAQ,EACR,eAAe,EACf,MAAM,EACN,aAAa,EACb,IAAI,EACJ,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,SAAS,EACT,UAAU,EACV,aAAa,EACb,cAAc,EACd,SAAS,EACT,eAAe,EACf,cAAc,EACd,0BAA0B,EAC1B,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,aAAa,GACd,MAAM,4BAA4B,CAAA;AAGnC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,SAAS,EACT,QAAQ,EACR,eAAe,EACf,cAAc,EACd,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,+BAA+B,CAAA;AACtC,YAAY,EACV,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,+BAA+B,CAAA;AAGtC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,4BAA4B,CAAA;AACnC,YAAY,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,mBAAmB,GACpB,MAAM,4BAA4B,CAAA;AAGnC,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,eAAe,GAChB,MAAM,4BAA4B,CAAA;AACnC,YAAY,EACV,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,4BAA4B,CAAA;AAGnC,OAAO,EACL,cAAc,EACd,cAAc,GACf,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,eAAe,EACf,eAAe,GAChB,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,YAAY,EACV,4BAA4B,EAC5B,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,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,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"}

package/dist/index.js

@@ -1,16 +1,7 @@
-// Storage v2 SDK - 统一入口
-// 基础客户端
 export { createStorageClient, StorageClient, StorageError } from './storage/storage.js';
-// Schema 定义系统
-export { createSchema, SchemaBuilder, SchemaValidator, SchemaRegistry, } from './storage/schema.js';
-// 字段权限控制
-export { FieldPermissionChecker, createFieldPermissionChecker, } from './storage/field-permission.js';
-// 类型安全的 Storage 客户端
-export { createTypedStorage, TypedStorageClient, } from './storage/typed-storage.js';
-// 集中式 Schema 客户端（类似 Prisma）
-export { createSchemaClient, defineSchemas, defineAndCreate, } from './storage/schema-client.js';
-// 迁移和初始化
-export { createMigrator, SchemaMigrator, } from './storage/migration.js';
-// 文件上传 SDK（独立模块）
+export { createSchema, SchemaBuilder, 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';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AAExB,QAAQ;AACR,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AA8BvF,cAAc;AACd,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,qBAAqB,CAAA;AAqB5B,SAAS;AACT,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,+BAA+B,CAAA;AAMtC,oBAAoB;AACpB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,4BAA4B,CAAA;AAQnC,4BAA4B;AAC5B,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,eAAe,GAChB,MAAM,4BAA4B,CAAA;AAMnC,SAAS;AACT,OAAO,EACL,cAAc,EACd,cAAc,GACf,MAAM,wBAAwB,CAAA;AAM/B,iBAAiB;AACjB,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,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"}

package/dist/storage/schema-client.d.ts

@@ -1,114 +1,128 @@
 import type { StorageClient } from './storage.js';
-import type { SchemaDefinition, FieldsDefinition, InferSchemaType, CreateSchemaType, UpdateSchemaType } from './schema.js';
-import { TypedStorageClient, type TypedStorageOptions, type ListOptions } from './typed-storage.js';
+import type { SchemaDefinition, FieldsDefinition } from './schema.js';
+import { TypedStorageClient, type TypedStorageOptions } from './typed-storage.js';
+export type SchemaDefinitions = Record<string, SchemaDefinition<FieldsDefinition>>;
+export type InferSchemaTypes<TDefinitions extends SchemaDefinitions> = {
+    [K in keyof TDefinitions]: TDefinitions[K] extends SchemaDefinition<infer TFields> ? import('./schema.js').InferSchemaType<TFields> : never;
+};
 /**
- * Schema 定义配置对象
- * 用于集中定义多个 Schema
+ * 确认对话框选项
  */
-export type SchemaDefinitions = Record<string, SchemaDefinition<FieldsDefinition>>;
+export interface ConfirmDialogOptions {
+    title?: string;
+    message: string;
+    confirmText?: string;
+    cancelText?: string;
+    type?: 'info' | 'warning' | 'danger';
+}
 /**
- * 从 Schema 定义对象推导出类型映射
+ * 确认对话框结果
  */
-export type InferSchemaTypes<TDefinitions extends SchemaDefinitions> = {
-    [K in keyof TDefinitions]: TDefinitions[K] extends SchemaDefinition<infer TFields> ? InferSchemaType<TFields> : never;
-};
+export interface ConfirmDialogResult {
+    confirmed: boolean;
+    cancelled?: boolean;
+}
 /**
- * 创建类型化的 Schema 客户端集合
- *
- * @param schemas - Schema 定义对象
- * @param client - StorageClient 实例
- * @param options - 可选配置
- * @returns 类型化的客户端集合
- *
- * @example
- * ```typescript
- * // 1. 定义所有 Schema（类似 Prisma schema）
- * const schemas = defineSchemas({
- *   posts: createSchema('posts')
- *     .string('title', { required: true })
- *     .string('content', { required: true })
- *     .build(),
- *
- *   categories: createSchema('categories')
- *     .string('name', { required: true })
- *     .string('slug', { required: true })
- *     .build(),
- *
- *   tags: createSchema('tags')
- *     .string('name', { required: true })
- *     .number('count', { default: 0 })
- *     .build(),
- * })
- *
- * // 2. 创建客户端集合
- * const db = createSchemaClient(schemas, storageClient)
- *
- * // 3. 通过对象访问使用（类似 Prisma Client）
- * const post = await db.posts.create('post-1', {
- *   title: 'Hello',
- *   content: 'World'
- * })
- *
- * const category = await db.categories.create('cat-1', {
- *   name: 'Technology',
- *   slug: 'tech'
- * })
- *
- * // 4. 类型完全推导
- * post.value.title // string 类型
- * category.value.name // string 类型
- * ```
+ * 确认对话框函数类型
  */
-export declare function createSchemaClient<TDefinitions extends SchemaDefinitions>(schemas: TDefinitions, client: StorageClient, options?: TypedStorageOptions): {
-    [K in keyof TDefinitions]: TypedStorageClient<TDefinitions[K] extends SchemaDefinition<infer TFields> ? TFields : never>;
-};
+export type ConfirmDialogFunction = (options: ConfirmDialogOptions) => Promise<ConfirmDialogResult>;
+export interface CreateSchemaClientOptions {
+    typedStorage?: TypedStorageOptions;
+    /**
+     * 自定义确认对话框函数
+     * 如果未提供，使用内置的浏览器 confirm
+     */
+    confirmDialog?: ConfirmDialogFunction;
+    /**
+     * 迁移选项
+     */
+    migrateOptions?: MigrateOptions;
+}
+export interface MigrateOptions {
+    dryRun?: boolean;
+    onChangesDetected?: (namespace: string, changes: MigrationChange[]) => void | Promise<void>;
+    onMigrationApplied?: (namespace: string, result: MigrationResult) => void | Promise<void>;
+}
+export interface MigrationChange {
+    type: 'addField' | 'removeField' | 'renameField' | 'addIndex' | 'removeIndex' | 'updateIndex' | 'updatePolicy' | 'updateAcl' | 'resetItemAcls';
+    field?: string;
+    oldFieldName?: string;
+    newFieldName?: string;
+    description: string;
+    acl?: {
+        readSubjects?: string[];
+        writeSubjects?: string[];
+        deleteSubjects?: string[];
+        allowItemOverride?: boolean;
+    };
+    resetOptions?: {
+        scope: 'all' | 'customOnly' | 'defaultOnly';
+        preserveOwner?: boolean;
+    };
+}
+export interface MigrationResult {
+    namespace: string;
+    hasChanges: boolean;
+    changes: MigrationChange[];
+    applied: boolean;
+    error?: string;
+}
 /**
- * 创建 Schema 定义集合（类型推断辅助函数）
- *
- * 这个函数本身不做任何运行时操作，只是帮助 TypeScript 推断类型
- *
- * @example
- * ```typescript
- * // 定义所有 Schema
- * const schemas = defineSchemas({
- *   posts: createSchema('posts')
- *     .string('title', { required: true })
- *     .build(),
- *   categories: createSchema('categories')
- *     .string('name', { required: true })
- *     .build(),
- * })
- *
- * // schemas 的类型：
- * // {
- * //   posts: SchemaDefinition<{ title: StringFieldDef, ... }>
- * //   categories: SchemaDefinition<{ name: StringFieldDef, ... }>
- * // }
- * ```
+ * 权限错误
  */
-export declare function defineSchemas<T extends SchemaDefinitions>(schemas: T): T;
+export declare class PermissionError extends Error {
+    constructor(message?: string);
+}
 /**
- * 便捷函数：一次性定义 Schema 并创建客户端
- *
- * @example
- * ```typescript
- * // 定义并创建客户端（一行代码）
- * const db = defineAndCreate({
- *   posts: createSchema('posts')
- *     .string('title', { required: true })
- *     .build(),
- *   categories: createSchema('categories')
- *     .string('name', { required: true })
- *     .build(),
- * }, storageClient)
- *
- * // 使用
- * await db.posts.create('post-1', { title: 'Hello' })
- * ```
+ * 用户取消错误
  */
-export declare function defineAndCreate<T extends SchemaDefinitions>(schemas: T, client: StorageClient, options?: TypedStorageOptions): {
-    [K in keyof T]: TypedStorageClient<T[K] extends SchemaDefinition<infer TFields> ? TFields : never>;
+export declare class UserCancelledError extends Error {
+    constructor(message?: string);
+}
+export interface MigrationChange {
+    type: 'addField' | 'removeField' | 'renameField' | 'addIndex' | 'removeIndex' | 'updateIndex' | 'updatePolicy' | 'updateAcl' | 'resetItemAcls';
+    field?: string;
+    oldFieldName?: string;
+    newFieldName?: string;
+    description: string;
+    acl?: {
+        readSubjects?: string[];
+        writeSubjects?: string[];
+        deleteSubjects?: string[];
+        allowItemOverride?: boolean;
+    };
+    resetOptions?: {
+        scope: 'all' | 'customOnly' | 'defaultOnly';
+        preserveOwner?: boolean;
+    };
+}
+export interface MigrationResult {
+    namespace: string;
+    hasChanges: boolean;
+    changes: MigrationChange[];
+    applied: boolean;
+    error?: string;
+}
+type SchemaClientClients<TDefinitions extends SchemaDefinitions> = {
+    [K in keyof TDefinitions]: TypedStorageClient<TDefinitions[K] extends SchemaDefinition<infer TFields> ? TFields : never>;
 };
-export type { SchemaDefinition, FieldsDefinition, InferSchemaType, CreateSchemaType, UpdateSchemaType, TypedStorageOptions, ListOptions, };
+type SchemaClientWithClients<TDefinitions extends SchemaDefinitions> = SchemaClient<TDefinitions> & SchemaClientClients<TDefinitions>;
+declare class SchemaClient<TDefinitions extends SchemaDefinitions> {
+    private schemas;
+    private client;
+    private options;
+    private clientsMap;
+    private initPromise;
+    constructor(schemas: TDefinitions, client: StorageClient, options?: CreateSchemaClientOptions);
+    private initialize;
+    ready(): Promise<void>;
+    get<K extends keyof TDefinitions>(name: K): Promise<SchemaClientClients<TDefinitions>[K]>;
+    getClients(): SchemaClientClients<TDefinitions>;
+    private wrapClient;
+}
+export declare function createSchemaClient<TDefinitions extends SchemaDefinitions>(schemas: TDefinitions, client: StorageClient, options?: CreateSchemaClientOptions): SchemaClientWithClients<TDefinitions>;
+export declare function defineSchemas<T extends SchemaDefinitions>(schemas: T): T;
+export type { TypedStorageOptions };
 export { TypedStorageClient };
+export { SchemaClient };
 //# sourceMappingURL=schema-client.d.ts.map

package/dist/storage/schema-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-client.d.ts","sourceRoot":"","sources":["../../src/storage/schema-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC1H,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEnG;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,CAAA;AAElF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,YAAY,SAAS,iBAAiB,IAAI;KACpE,CAAC,IAAI,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,SAAS,gBAAgB,CAAC,MAAM,OAAO,CAAC,GAC9E,eAAe,CAAC,OAAO,CAAC,GACxB,KAAK;CACV,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,SAAS,iBAAiB,EACvE,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,mBAAmB,GAC5B;KACA,CAAC,IAAI,MAAM,YAAY,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,gBAAgB,CAAC,MAAM,OAAO,CAAC,GAAG,OAAO,GAAG,KAAK,CAAC;CACzH,CAcA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,iBAAiB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAExE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,iBAAiB,EACzD,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,mBAAmB,GAC5B;KACA,CAAC,IAAI,MAAM,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,gBAAgB,CAAC,MAAM,OAAO,CAAC,GAAG,OAAO,GAAG,KAAK,CAAC;CACnG,CAEA;AAMD,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,GACZ,CAAA;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"schema-client.d.ts","sourceRoot":"","sources":["../../src/storage/schema-client.ts"],"names":[],"mappings":"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"}