chatablex-web-sdk 1.0.3 → 1.0.32

package/dist/index.js

@@ -22,6 +22,10 @@ var index_exports = {};
 __export(index_exports, {
   Bridge: () => Bridge,
   ChatableX: () => ChatableX,
+  CloudAuthRequiredError: () => CloudAuthRequiredError,
+  CloudError: () => CloudError,
+  CloudQuotaExceededError: () => CloudQuotaExceededError,
+  CloudSubscriptionRequiredError: () => CloudSubscriptionRequiredError,
   SDK_VERSION: () => SDK_VERSION
 });
 module.exports = __toCommonJS(index_exports);
@@ -299,10 +303,246 @@ function createPlatformModule(bridge) {
   };
 }
 
+// src/modules/auth.ts
+var EXPIRY_SKEW_MS = 5e3;
+function isValid(token, now) {
+  return !!token && typeof token.access_token === "string" && token.access_token.length > 0 && token.expires_at - EXPIRY_SKEW_MS > now;
+}
+var HostAuthProvider = class {
+  constructor(bridge) {
+    this._token = null;
+    /** In-flight refresh, so concurrent callers share one host round-trip. */
+    this._refreshing = null;
+    this._bridge = bridge;
+  }
+  async getToken() {
+    if (isValid(this._token, Date.now())) return this._token;
+    const ok = await this.refresh();
+    return ok ? this._token : null;
+  }
+  async getAuthHeaders() {
+    const token = await this.getToken();
+    if (!token) return {};
+    return { Authorization: `Bearer ${token.access_token}` };
+  }
+  getUserId() {
+    return this._token?.user_id ?? null;
+  }
+  isAuthenticated() {
+    return isValid(this._token, Date.now());
+  }
+  refresh() {
+    if (this._refreshing) return this._refreshing;
+    this._refreshing = this._doRefresh().finally(() => {
+      this._refreshing = null;
+    });
+    return this._refreshing;
+  }
+  async _doRefresh() {
+    try {
+      const raw = await this._bridge.sendMessage("host.getAuthToken");
+      if (raw && typeof raw === "object" && typeof raw.access_token === "string" && raw.access_token.length > 0) {
+        this._token = {
+          access_token: raw.access_token,
+          expires_at: Number(raw.expires_at) || 0,
+          user_id: String(raw.user_id ?? "")
+        };
+        return true;
+      }
+      this._token = null;
+      return false;
+    } catch {
+      this._token = null;
+      return false;
+    }
+  }
+};
+function createAuthModule(bridge) {
+  return new HostAuthProvider(bridge);
+}
+
+// src/modules/cloud.ts
+var CloudError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.name = "CloudError";
+    this.code = code;
+  }
+};
+var CloudAuthRequiredError = class extends CloudError {
+  constructor(message = "cloud storage requires an authenticated session") {
+    super(message, 401);
+    this.name = "CloudAuthRequiredError";
+  }
+};
+var CloudSubscriptionRequiredError = class extends CloudError {
+  constructor(message = "cloud storage requires an active subscription") {
+    super(message, 40302);
+    this.name = "CloudSubscriptionRequiredError";
+  }
+};
+var CloudQuotaExceededError = class extends CloudError {
+  constructor(usedBytes, quotaBytes, message = "storage quota exceeded") {
+    super(message, 40301);
+    this.name = "CloudQuotaExceededError";
+    this.usedBytes = usedBytes;
+    this.quotaBytes = quotaBytes;
+  }
+};
+var DEFAULT_CONTENT_TYPE = "application/octet-stream";
+function normalizeData(data) {
+  if (typeof Blob !== "undefined" && data instanceof Blob) {
+    return { body: data, size: data.size, type: data.type || "" };
+  }
+  if (typeof data === "string") {
+    const blob = new Blob([data]);
+    return { body: blob, size: blob.size, type: "" };
+  }
+  if (data instanceof ArrayBuffer) {
+    return { body: data, size: data.byteLength, type: "" };
+  }
+  if (ArrayBuffer.isView(data)) {
+    return { body: data, size: data.byteLength, type: "" };
+  }
+  throw new CloudError("unsupported upload data type", 400);
+}
+function createCloudModule(bridge, deps) {
+  const { appId, auth } = deps;
+  let resolvedBase = deps.apiBaseUrl ? stripTrailingSlash(deps.apiBaseUrl) : null;
+  function stripTrailingSlash(url) {
+    return url.replace(/\/+$/, "");
+  }
+  async function baseUrl() {
+    if (resolvedBase) return resolvedBase;
+    try {
+      const r = await bridge.sendMessage("host.getApiBaseUrl", {}, 5e3);
+      const url = typeof r === "string" ? r : r && typeof r === "object" && typeof r.base_url === "string" ? r.base_url : "";
+      if (url) {
+        resolvedBase = stripTrailingSlash(url);
+        return resolvedBase;
+      }
+    } catch {
+    }
+    throw new CloudError(
+      "cloud API base URL is not configured; pass apiBaseUrl to ChatableX.init()",
+      0
+    );
+  }
+  async function authedFetch(path, init) {
+    const token = await auth.getToken();
+    if (!token) throw new CloudAuthRequiredError();
+    const base = await baseUrl();
+    const url = `${base}${path}`;
+    const build = async () => ({
+      ...init,
+      headers: { ...init.headers ?? {}, ...await auth.getAuthHeaders() }
+    });
+    let res = await fetch(url, await build());
+    if (res.status === 401 && await auth.refresh()) {
+      res = await fetch(url, await build());
+    }
+    return res;
+  }
+  async function callApi(path, init) {
+    const res = await authedFetch(path, init);
+    let body = null;
+    try {
+      body = await res.json();
+    } catch {
+    }
+    const code = body?.code;
+    const message = body?.message || `HTTP ${res.status}`;
+    if (!res.ok || body?.success === false) {
+      if (code === 40301) {
+        const q = body?.data ?? {};
+        throw new CloudQuotaExceededError(q.used_bytes ?? 0, q.quota_bytes ?? 0, message);
+      }
+      if (code === 40302) throw new CloudSubscriptionRequiredError(message);
+      if (res.status === 401) throw new CloudAuthRequiredError(message);
+      throw new CloudError(message, code ?? res.status);
+    }
+    return body?.data ?? null;
+  }
+  function validateFileKey(fileKey) {
+    if (!fileKey || typeof fileKey !== "string") {
+      throw new CloudError("fileKey is required", 400);
+    }
+  }
+  return {
+    async upload(fileKey, data, options = {}) {
+      validateFileKey(fileKey);
+      const { body, size, type } = normalizeData(data);
+      const contentType = options.contentType || type || DEFAULT_CONTENT_TYPE;
+      const signed = await callApi("/api/storage/upload-url", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          app_id: appId,
+          file_key: fileKey,
+          content_type: contentType,
+          size_bytes: size
+        })
+      });
+      const put = await fetch(signed.upload_url, {
+        method: "PUT",
+        headers: { "Content-Type": contentType },
+        body
+      });
+      if (!put.ok) {
+        throw new CloudError(`OSS upload failed: HTTP ${put.status}`, put.status);
+      }
+      return { fileKey, objectKey: signed.object_key, size, contentType };
+    },
+    async getDownloadUrl(fileKey) {
+      validateFileKey(fileKey);
+      const signed = await callApi("/api/storage/download-url", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ app_id: appId, file_key: fileKey })
+      });
+      return signed.download_url;
+    },
+    async download(fileKey) {
+      const url = await this.getDownloadUrl(fileKey);
+      const res = await fetch(url, { method: "GET" });
+      if (!res.ok) {
+        throw new CloudError(`OSS download failed: HTTP ${res.status}`, res.status);
+      }
+      return res.blob();
+    },
+    async list(options = {}) {
+      const qs = new URLSearchParams({ app_id: appId });
+      if (options.prefix) qs.set("prefix", options.prefix);
+      const data = await callApi(`/api/storage/files?${qs.toString()}`, {
+        method: "GET"
+      });
+      return (data?.files ?? []).map((f) => ({
+        fileKey: f.file_key,
+        size: f.size,
+        lastModified: f.last_modified
+      }));
+    },
+    async delete(fileKey) {
+      validateFileKey(fileKey);
+      const qs = new URLSearchParams({ app_id: appId, file_key: fileKey });
+      await callApi(`/api/storage/files?${qs.toString()}`, { method: "DELETE" });
+    },
+    async usage() {
+      const data = await callApi("/api/storage/usage", { method: "GET" });
+      return {
+        usedBytes: data.used_bytes,
+        quotaBytes: data.quota_bytes,
+        fileCount: data.file_count,
+        reconciledAt: data.reconciled_at
+      };
+    }
+  };
+}
+
 // package.json
 var package_default = {
   name: "chatablex-web-sdk",
-  version: "1.0.3",
+  version: "1.0.32",
   description: "ChatableX Web SDK for AI App WebUI development. Provides bridge communication with the ChatableX Flutter client.",
   main: "dist/index.js",
   module: "dist/index.mjs",
@@ -394,6 +634,7 @@ var ChatableX = {
     }
     const toolModule = createToolModule(bridge, config.appId);
     if (toolConfig) toolModule._setInfo(toolConfig);
+    const authModule = createAuthModule(bridge);
     const sdk = {
       ai: createAIModule(bridge),
       tools: createToolsModule(bridge),
@@ -401,7 +642,13 @@ var ChatableX = {
       events: createEventsModule(bridge),
       storage: createStorageModule(bridge),
       tool: toolModule,
-      platform: createPlatformModule(bridge)
+      platform: createPlatformModule(bridge),
+      auth: authModule,
+      cloud: createCloudModule(bridge, {
+        appId: config.appId,
+        auth: authModule,
+        apiBaseUrl: config.apiBaseUrl
+      })
     };
     window.ChatableX = sdk;
     _instance = sdk;
@@ -424,5 +671,9 @@ var ChatableX = {
 0 && (module.exports = {
   Bridge,
   ChatableX,
+  CloudAuthRequiredError,
+  CloudError,
+  CloudQuotaExceededError,
+  CloudSubscriptionRequiredError,
   SDK_VERSION
 });

package/dist/index.mjs

@@ -271,10 +271,246 @@ function createPlatformModule(bridge) {
   };
 }
 
+// src/modules/auth.ts
+var EXPIRY_SKEW_MS = 5e3;
+function isValid(token, now) {
+  return !!token && typeof token.access_token === "string" && token.access_token.length > 0 && token.expires_at - EXPIRY_SKEW_MS > now;
+}
+var HostAuthProvider = class {
+  constructor(bridge) {
+    this._token = null;
+    /** In-flight refresh, so concurrent callers share one host round-trip. */
+    this._refreshing = null;
+    this._bridge = bridge;
+  }
+  async getToken() {
+    if (isValid(this._token, Date.now())) return this._token;
+    const ok = await this.refresh();
+    return ok ? this._token : null;
+  }
+  async getAuthHeaders() {
+    const token = await this.getToken();
+    if (!token) return {};
+    return { Authorization: `Bearer ${token.access_token}` };
+  }
+  getUserId() {
+    return this._token?.user_id ?? null;
+  }
+  isAuthenticated() {
+    return isValid(this._token, Date.now());
+  }
+  refresh() {
+    if (this._refreshing) return this._refreshing;
+    this._refreshing = this._doRefresh().finally(() => {
+      this._refreshing = null;
+    });
+    return this._refreshing;
+  }
+  async _doRefresh() {
+    try {
+      const raw = await this._bridge.sendMessage("host.getAuthToken");
+      if (raw && typeof raw === "object" && typeof raw.access_token === "string" && raw.access_token.length > 0) {
+        this._token = {
+          access_token: raw.access_token,
+          expires_at: Number(raw.expires_at) || 0,
+          user_id: String(raw.user_id ?? "")
+        };
+        return true;
+      }
+      this._token = null;
+      return false;
+    } catch {
+      this._token = null;
+      return false;
+    }
+  }
+};
+function createAuthModule(bridge) {
+  return new HostAuthProvider(bridge);
+}
+
+// src/modules/cloud.ts
+var CloudError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.name = "CloudError";
+    this.code = code;
+  }
+};
+var CloudAuthRequiredError = class extends CloudError {
+  constructor(message = "cloud storage requires an authenticated session") {
+    super(message, 401);
+    this.name = "CloudAuthRequiredError";
+  }
+};
+var CloudSubscriptionRequiredError = class extends CloudError {
+  constructor(message = "cloud storage requires an active subscription") {
+    super(message, 40302);
+    this.name = "CloudSubscriptionRequiredError";
+  }
+};
+var CloudQuotaExceededError = class extends CloudError {
+  constructor(usedBytes, quotaBytes, message = "storage quota exceeded") {
+    super(message, 40301);
+    this.name = "CloudQuotaExceededError";
+    this.usedBytes = usedBytes;
+    this.quotaBytes = quotaBytes;
+  }
+};
+var DEFAULT_CONTENT_TYPE = "application/octet-stream";
+function normalizeData(data) {
+  if (typeof Blob !== "undefined" && data instanceof Blob) {
+    return { body: data, size: data.size, type: data.type || "" };
+  }
+  if (typeof data === "string") {
+    const blob = new Blob([data]);
+    return { body: blob, size: blob.size, type: "" };
+  }
+  if (data instanceof ArrayBuffer) {
+    return { body: data, size: data.byteLength, type: "" };
+  }
+  if (ArrayBuffer.isView(data)) {
+    return { body: data, size: data.byteLength, type: "" };
+  }
+  throw new CloudError("unsupported upload data type", 400);
+}
+function createCloudModule(bridge, deps) {
+  const { appId, auth } = deps;
+  let resolvedBase = deps.apiBaseUrl ? stripTrailingSlash(deps.apiBaseUrl) : null;
+  function stripTrailingSlash(url) {
+    return url.replace(/\/+$/, "");
+  }
+  async function baseUrl() {
+    if (resolvedBase) return resolvedBase;
+    try {
+      const r = await bridge.sendMessage("host.getApiBaseUrl", {}, 5e3);
+      const url = typeof r === "string" ? r : r && typeof r === "object" && typeof r.base_url === "string" ? r.base_url : "";
+      if (url) {
+        resolvedBase = stripTrailingSlash(url);
+        return resolvedBase;
+      }
+    } catch {
+    }
+    throw new CloudError(
+      "cloud API base URL is not configured; pass apiBaseUrl to ChatableX.init()",
+      0
+    );
+  }
+  async function authedFetch(path, init) {
+    const token = await auth.getToken();
+    if (!token) throw new CloudAuthRequiredError();
+    const base = await baseUrl();
+    const url = `${base}${path}`;
+    const build = async () => ({
+      ...init,
+      headers: { ...init.headers ?? {}, ...await auth.getAuthHeaders() }
+    });
+    let res = await fetch(url, await build());
+    if (res.status === 401 && await auth.refresh()) {
+      res = await fetch(url, await build());
+    }
+    return res;
+  }
+  async function callApi(path, init) {
+    const res = await authedFetch(path, init);
+    let body = null;
+    try {
+      body = await res.json();
+    } catch {
+    }
+    const code = body?.code;
+    const message = body?.message || `HTTP ${res.status}`;
+    if (!res.ok || body?.success === false) {
+      if (code === 40301) {
+        const q = body?.data ?? {};
+        throw new CloudQuotaExceededError(q.used_bytes ?? 0, q.quota_bytes ?? 0, message);
+      }
+      if (code === 40302) throw new CloudSubscriptionRequiredError(message);
+      if (res.status === 401) throw new CloudAuthRequiredError(message);
+      throw new CloudError(message, code ?? res.status);
+    }
+    return body?.data ?? null;
+  }
+  function validateFileKey(fileKey) {
+    if (!fileKey || typeof fileKey !== "string") {
+      throw new CloudError("fileKey is required", 400);
+    }
+  }
+  return {
+    async upload(fileKey, data, options = {}) {
+      validateFileKey(fileKey);
+      const { body, size, type } = normalizeData(data);
+      const contentType = options.contentType || type || DEFAULT_CONTENT_TYPE;
+      const signed = await callApi("/api/storage/upload-url", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          app_id: appId,
+          file_key: fileKey,
+          content_type: contentType,
+          size_bytes: size
+        })
+      });
+      const put = await fetch(signed.upload_url, {
+        method: "PUT",
+        headers: { "Content-Type": contentType },
+        body
+      });
+      if (!put.ok) {
+        throw new CloudError(`OSS upload failed: HTTP ${put.status}`, put.status);
+      }
+      return { fileKey, objectKey: signed.object_key, size, contentType };
+    },
+    async getDownloadUrl(fileKey) {
+      validateFileKey(fileKey);
+      const signed = await callApi("/api/storage/download-url", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ app_id: appId, file_key: fileKey })
+      });
+      return signed.download_url;
+    },
+    async download(fileKey) {
+      const url = await this.getDownloadUrl(fileKey);
+      const res = await fetch(url, { method: "GET" });
+      if (!res.ok) {
+        throw new CloudError(`OSS download failed: HTTP ${res.status}`, res.status);
+      }
+      return res.blob();
+    },
+    async list(options = {}) {
+      const qs = new URLSearchParams({ app_id: appId });
+      if (options.prefix) qs.set("prefix", options.prefix);
+      const data = await callApi(`/api/storage/files?${qs.toString()}`, {
+        method: "GET"
+      });
+      return (data?.files ?? []).map((f) => ({
+        fileKey: f.file_key,
+        size: f.size,
+        lastModified: f.last_modified
+      }));
+    },
+    async delete(fileKey) {
+      validateFileKey(fileKey);
+      const qs = new URLSearchParams({ app_id: appId, file_key: fileKey });
+      await callApi(`/api/storage/files?${qs.toString()}`, { method: "DELETE" });
+    },
+    async usage() {
+      const data = await callApi("/api/storage/usage", { method: "GET" });
+      return {
+        usedBytes: data.used_bytes,
+        quotaBytes: data.quota_bytes,
+        fileCount: data.file_count,
+        reconciledAt: data.reconciled_at
+      };
+    }
+  };
+}
+
 // package.json
 var package_default = {
   name: "chatablex-web-sdk",
-  version: "1.0.3",
+  version: "1.0.32",
   description: "ChatableX Web SDK for AI App WebUI development. Provides bridge communication with the ChatableX Flutter client.",
   main: "dist/index.js",
   module: "dist/index.mjs",
@@ -366,6 +602,7 @@ var ChatableX = {
     }
     const toolModule = createToolModule(bridge, config.appId);
     if (toolConfig) toolModule._setInfo(toolConfig);
+    const authModule = createAuthModule(bridge);
     const sdk = {
       ai: createAIModule(bridge),
       tools: createToolsModule(bridge),
@@ -373,7 +610,13 @@ var ChatableX = {
       events: createEventsModule(bridge),
       storage: createStorageModule(bridge),
       tool: toolModule,
-      platform: createPlatformModule(bridge)
+      platform: createPlatformModule(bridge),
+      auth: authModule,
+      cloud: createCloudModule(bridge, {
+        appId: config.appId,
+        auth: authModule,
+        apiBaseUrl: config.apiBaseUrl
+      })
     };
     window.ChatableX = sdk;
     _instance = sdk;
@@ -395,5 +638,9 @@ var ChatableX = {
 export {
   Bridge,
   ChatableX,
+  CloudAuthRequiredError,
+  CloudError,
+  CloudQuotaExceededError,
+  CloudSubscriptionRequiredError,
   SDK_VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatablex-web-sdk",
-  "version": "1.0.3",
+  "version": "1.0.32",
   "description": "ChatableX Web SDK for AI App WebUI development. Provides bridge communication with the ChatableX Flutter client.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/index.ts

@@ -26,6 +26,8 @@ import { createUIModule } from './modules/ui';
 import { createStorageModule } from './modules/storage';
 import { createToolsModule } from './modules/tools';
 import { createPlatformModule } from './modules/platform';
+import { createAuthModule } from './modules/auth';
+import { createCloudModule } from './modules/cloud';
 import type { ChatableXSDK, ChatableXInitConfig, ToolInfo } from './types';
 import pkg from '../package.json';
 
@@ -78,6 +80,8 @@ export const ChatableX = {
     const toolModule = createToolModule(bridge, config.appId);
     if (toolConfig) toolModule._setInfo(toolConfig);
 
+    const authModule = createAuthModule(bridge);
+
     const sdk: ChatableXSDK = {
       ai: createAIModule(bridge),
       tools: createToolsModule(bridge),
@@ -86,6 +90,12 @@ export const ChatableX = {
       storage: createStorageModule(bridge),
       tool: toolModule,
       platform: createPlatformModule(bridge),
+      auth: authModule,
+      cloud: createCloudModule(bridge, {
+        appId: config.appId,
+        auth: authModule,
+        apiBaseUrl: config.apiBaseUrl,
+      }),
     };
 
     // Expose on window for debugging / Flutter interop
@@ -114,3 +124,9 @@ export const ChatableX = {
 // Re-export all types
 export * from './types';
 export { Bridge } from './bridge';
+export {
+  CloudError,
+  CloudAuthRequiredError,
+  CloudSubscriptionRequiredError,
+  CloudQuotaExceededError,
+} from './modules/cloud';