@qmuse/appwrite-runtime-sdk 1.0.5-dev.1 → 1.0.5-dev.2

package/README.md

@@ -199,7 +199,7 @@ export function TodoList() {
 
 ## Taro 项目
 
-Taro 项目通过 `createPortableAppwriteClients()` 使用同一套 Runtime API。该方式适用于 Taro H5、支付宝小程序和微信小程序。
+Taro 项目通过 `createQmuseAppwriteRuntime()` 使用同一套 Runtime API，SDK 会在内部创建跨端客户端。该方式适用于 Taro H5、支付宝小程序和微信小程序。
 
 ### 1. 配置跨端环境变量
 
@@ -333,7 +333,6 @@ export const platformStorage = {
 // src/services/appwrite.ts
 import { ID, Permission, Query, Role } from 'appwrite';
 import {
-  createPortableAppwriteClients,
   createQmuseAppwriteRuntime,
   type Models,
 } from '@qmuse/appwrite-runtime-sdk';
@@ -344,16 +343,11 @@ function getQmuseLoginUserId(): string | null {
   return null;
 }
 
-const clients = createPortableAppwriteClients({
-  fetch: platformFetch,
-  storage: platformStorage,
-});
-
 const runtime = createQmuseAppwriteRuntime({
-  ...clients,
   getMuseRuntime: getMuseRuntimeConfig,
   getQmuseLoginUserId,
   fetch: platformFetch,
+  storage: platformStorage,
 });
 
 export const initAppwrite = runtime.init;
@@ -465,7 +459,7 @@ await deleteQmuseRow({
 ## 接入约束
 
 - 每个应用只创建一个 `createQmuseAppwriteRuntime()` 实例。
-- React 应用使用 Appwrite Web SDK 客户端；Taro 应用使用 `createPortableAppwriteClients()`。
+- React 应用向 `createQmuseAppwriteRuntime()` 传入 Appwrite Web SDK 客户端；Taro 应用传入跨端 `fetch` 和 `storage`。
 - H5、支付宝小程序和微信小程序必须使用相同的 `appId`、`env` 和 `domain` 配置来源。
 - React 应用的 `getQmuseLoginUserId()` 只返回有效的用户 ID 或 `null`；Taro 应用固定返回 `null`。
 - 业务代码通过 Runtime 的 CRUD 方法读写数据，不直接拼接 Appwrite HTTP 接口。

package/dist/index.d.ts

@@ -1,3 +1,2 @@
 export { createQmuseAppwriteRuntime } from './runtime';
-export { createPortableAppwriteClients } from './portable';
-export type { AppwriteAccountLike, AppwriteClientLike, AppwriteError, AppwriteRuntimeConfig, AppwriteRuntimeStorage, AppwriteSession, AppwriteTablesDBLike, AppwriteUser, BusinessRowData, CreateRowInput, DeleteRowInput, GetRowInput, ListRowsInput, Models, QmuseAppwriteClients, QmuseAppwriteRuntimeApi, QmuseAppwriteRuntimeOptions, QmuseEnvironment, QmuseRuntimeContext, PortableAppwriteClientsOptions, UpdateRowInput, } from './types';
+export type { AppwriteAccountLike, AppwriteClientLike, AppwriteError, AppwriteRuntimeConfig, AppwriteRuntimeStorage, AppwriteSession, AppwriteTablesDBLike, AppwriteUser, BusinessRowData, CreateRowInput, DeleteRowInput, GetRowInput, ListRowsInput, Models, QmuseAppwriteClients, QmuseAppwriteRuntimeApi, QmuseAppwriteRuntimeOptions, QmuseEnvironment, QmuseRuntimeContext, UpdateRowInput, } from './types';

package/dist/index.js

@@ -1,2 +1 @@
-export { createQmuseAppwriteRuntime } from "./runtime";
-export { createPortableAppwriteClients } from "./portable";
+export { createQmuseAppwriteRuntime } from "./runtime";

package/dist/portable.d.ts

@@ -1,5 +1,5 @@
 import type { AppwriteAccountLike, AppwriteClientLike, AppwriteTablesDBLike, PortableAppwriteClientsOptions } from './types';
-export declare function createPortableAppwriteClients(options: PortableAppwriteClientsOptions): {
+export declare function createPortableAppwriteClientsInternal(options: PortableAppwriteClientsOptions): {
     client: AppwriteClientLike;
     account: AppwriteAccountLike;
     tablesDB: AppwriteTablesDBLike;

package/dist/portable.js

@@ -369,7 +369,7 @@ var PortableTablesDB = /*#__PURE__*/function () {
   }]);
   return PortableTablesDB;
 }();
-export function createPortableAppwriteClients(options) {
+export function createPortableAppwriteClientsInternal(options) {
   var client = new PortableAppwriteClient(options);
   return {
     client: client,

package/dist/runtime/AppwriteSessionCoordinator.d.ts

@@ -1,4 +1,4 @@
-import type { AppwriteUser, QmuseAppwriteRuntimeOptions } from '../types';
+import type { AppwriteUser, ResolvedQmuseAppwriteRuntimeOptions } from '../types';
 export declare class AppwriteSessionCoordinator {
     private readonly options;
     private readonly request;
@@ -6,7 +6,7 @@ export declare class AppwriteSessionCoordinator {
     private initPromise;
     private sessionSyncPromise;
     private refreshPromise;
-    constructor(options: QmuseAppwriteRuntimeOptions, request: typeof globalThis.fetch);
+    constructor(options: ResolvedQmuseAppwriteRuntimeOptions, request: typeof globalThis.fetch);
     init(): Promise<void>;
     getDatabaseId(): Promise<string>;
     getCurrentUser(): Promise<AppwriteUser>;

package/dist/runtime/QmuseAppwriteRuntime.d.ts

@@ -1,4 +1,4 @@
-import type { QmuseAppwriteRuntimeApi, QmuseAppwriteRuntimeOptions } from '../types';
+import type { QmuseAppwriteRuntimeApi, ResolvedQmuseAppwriteRuntimeOptions } from '../types';
 export declare class QmuseAppwriteRuntime implements QmuseAppwriteRuntimeApi {
     private readonly options;
     readonly init: QmuseAppwriteRuntimeApi['init'];
@@ -12,7 +12,7 @@ export declare class QmuseAppwriteRuntime implements QmuseAppwriteRuntimeApi {
     readonly deleteRow: QmuseAppwriteRuntimeApi['deleteRow'];
     private readonly session;
     private readonly auditReporter;
-    constructor(options: QmuseAppwriteRuntimeOptions);
+    constructor(options: ResolvedQmuseAppwriteRuntimeOptions);
     private getClientsInternal;
     private listRowsInternal;
     private getRowInternal;

package/dist/runtime.js

@@ -1,4 +1,17 @@
+import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
 import { QmuseAppwriteRuntime } from "./runtime/QmuseAppwriteRuntime";
+import { createPortableAppwriteClientsInternal } from "./portable";
+function resolveRuntimeOptions(options) {
+  if (options.client && options.account && options.tablesDB) {
+    return options;
+  }
+  var clients = createPortableAppwriteClientsInternal({
+    fetch: options.fetch,
+    storage: options.storage,
+    storageKeyPrefix: options.storageKeyPrefix
+  });
+  return _objectSpread(_objectSpread({}, options), clients);
+}
 export function createQmuseAppwriteRuntime(options) {
-  return new QmuseAppwriteRuntime(options);
+  return new QmuseAppwriteRuntime(resolveRuntimeOptions(options));
 }

package/dist/types.d.ts

@@ -80,12 +80,27 @@ export interface AppwriteTablesDBLike {
         rowId: string;
     }): Promise<unknown>;
 }
-export interface QmuseAppwriteRuntimeOptions {
+interface QmuseAppwriteRuntimeBaseOptions {
+    getMuseRuntime(): QmuseRuntimeContext;
+    getQmuseLoginUserId(): string | null;
+}
+interface QmuseAppwriteInjectedClientsOptions extends QmuseAppwriteRuntimeBaseOptions {
+    client: AppwriteClientLike;
+    account: AppwriteAccountLike;
+    tablesDB: AppwriteTablesDBLike;
+    fetch?: typeof globalThis.fetch;
+    storage?: never;
+}
+interface QmuseAppwritePortableRuntimeOptions extends QmuseAppwriteRuntimeBaseOptions, PortableAppwriteClientsOptions {
+    client?: never;
+    account?: never;
+    tablesDB?: never;
+}
+export type QmuseAppwriteRuntimeOptions = QmuseAppwriteInjectedClientsOptions | QmuseAppwritePortableRuntimeOptions;
+export interface ResolvedQmuseAppwriteRuntimeOptions extends QmuseAppwriteRuntimeBaseOptions {
     client: AppwriteClientLike;
     account: AppwriteAccountLike;
     tablesDB: AppwriteTablesDBLike;
-    getMuseRuntime(): QmuseRuntimeContext;
-    getQmuseLoginUserId(): string | null;
     fetch?: typeof globalThis.fetch;
 }
 export interface QmuseAppwriteClients {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qmuse/appwrite-runtime-sdk",
-  "version": "1.0.5-dev.1",
+  "version": "1.0.5-dev.2",
   "description": "QMuse Appwrite browser runtime SDK",
   "repository": {
     "type": "git",