@atomm-developer/generator-sdk 1.0.5 → 1.0.6

package/README.md

@@ -4,16 +4,25 @@
 
 The Atomm Generator Open Platform SDK provides core capabilities for third-party generator developers, including authentication, cloud storage, history, credits, billing, export, and template protocols.
 
+For a standardized host layout with built-in login, template actions, and floating export entry, use the companion package `@atomm-developer/generator-workbench`.
+
 ## Installation
 
 ```bash
 # Via npm/pnpm/yarn
 pnpm add @atomm-developer/generator-sdk
+pnpm add @atomm-developer/generator-workbench
 
 # Via CDN (for plain HTML)
 # <script src="https://static-res.atomm.com/scripts/js/generator-sdk/index.umd.js"></script>
+# <script src="https://static-res.atomm.com/scripts/js/generator-sdk/generator-workbench/index.umd.js"></script>
 ```
 
+## Package Roles
+
+- `@atomm-developer/generator-sdk`: platform capability layer such as auth, export, template, billing, and history.
+- `@atomm-developer/generator-workbench`: official host shell that mounts the runtime canvas and parameter panel into a unified layout.
+
 ## Quick Start
 
 ### Initialization
@@ -25,6 +34,9 @@ const sdk = GeneratorSDK.init({
   appKey: 'your_app_key', // Get from developer console
   env: 'prod',            // 'dev' | 'test' | 'pre' | 'prod'
 });
+
+console.log(sdk.getAppKey());
+console.log(GeneratorSDK.getAppKey());
 ```
 
 ### Core Modules
@@ -84,6 +96,27 @@ await sdk.export.openInStudio();
 
 For detailed API references and integration guides, please visit our [Documentation Portal](https://github.com/atomm-inc/generator-sdk/tree/main/docs).
 
+## Repository Build
+
+This repository now builds both the SDK bundle and the `generator-workbench` UMD asset through the root build chain:
+
+```bash
+pnpm build
+pnpm type-check
+pnpm test:workbench
+```
+
+`pnpm deploy:cdn` uploads both `generator-sdk` and `generator-workbench` CDN assets to `static-res.atomm.com`.
+
+If you need to publish both packages from the repository root, use:
+
+```bash
+pnpm deploy
+pnpm deploy:workbench
+# or
+pnpm deploy:all
+```
+
 ## License
 
 MIT

package/dist/{index-Ba3cYeMp.js → index-6H3DQX8m.js}

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-import { t as toUtf8, f as fromUtf8 } from "./index-BtfWZLb7.js";
+import { t as toUtf8, f as fromUtf8 } from "./index-DP-Q2Dkh.js";
 class EventStreamSerde {
   constructor({ marshaller, serializer, deserializer, serdeContext, defaultContentType }) {
     __publicField(this, "marshaller");

package/dist/{index-BtfWZLb7.js → index-DP-Q2Dkh.js}

@@ -10002,6 +10002,25 @@ class AuthModule {
   getToken() {
     return getToken(this.appKey);
   }
+  /**
+   * 外部传入 token，同步到本地缓存并刷新登录状态
+   */
+  async syncToken(token) {
+    const normalizedToken = token.trim();
+    if (!normalizedToken) {
+      throw new Error("Token is required");
+    }
+    try {
+      setToken(this.appKey, normalizedToken);
+      this.passportClient.token = normalizedToken;
+      const userInfo = await this._fetchUserInfo(normalizedToken);
+      this._setLoginStatus(userInfo);
+      return this.getStatus();
+    } catch (error) {
+      this._clearLoginStatus();
+      throw error;
+    }
+  }
   /**
    * 弹出登录弹窗
    * 登录成功后 resolve UserInfo，用户取消则 reject
@@ -12265,7 +12284,7 @@ class HttpProtocol extends SerdeContext {
     });
   }
   async loadEventStreamCapability() {
-    const { EventStreamSerde } = await import("./index-Ba3cYeMp.js");
+    const { EventStreamSerde } = await import("./index-6H3DQX8m.js");
     return new EventStreamSerde({
       marshaller: this.getEventStreamMarshaller(),
       serializer: this.serializer,
@@ -81267,7 +81286,7 @@ class TemplateModule {
   }
 }
 const instanceCache = /* @__PURE__ */ new Map();
-class GeneratorSDK {
+const _GeneratorSDK = class _GeneratorSDK {
   constructor(options) {
     /** 登录/退出/用户信息 */
     __publicField(this, "auth");
@@ -81299,6 +81318,12 @@ class GeneratorSDK {
     this.export = new ExportModule(appKey, env, http);
     this.template = new TemplateModule();
   }
+  /**
+   * 返回当前 SDK 实例绑定的 appKey
+   */
+  getAppKey() {
+    return this.appKey;
+  }
   // ─────────────────────────────────────────────
   // 静态工厂方法
   // ─────────────────────────────────────────────
@@ -81318,23 +81343,34 @@ class GeneratorSDK {
     }
     const env = options.env ?? "prod";
     const cacheKey = `${options.appKey}::${env}`;
+    _GeneratorSDK.lastInitializedAppKey = options.appKey;
     if (instanceCache.has(cacheKey)) {
       return instanceCache.get(cacheKey);
     }
-    const instance = new GeneratorSDK({ appKey: options.appKey, env });
+    const instance = new _GeneratorSDK({ appKey: options.appKey, env });
     instanceCache.set(cacheKey, instance);
     console.info(
       `[GeneratorSDK] initialized (appKey: ${options.appKey}, env: ${env})`
     );
     return instance;
   }
+  /**
+   * 返回最近一次初始化使用的 appKey
+   */
+  static getAppKey() {
+    return _GeneratorSDK.lastInitializedAppKey;
+  }
   /**
    * 清除实例缓存（测试场景使用）
    */
   static _clearCache() {
     instanceCache.clear();
+    _GeneratorSDK.lastInitializedAppKey = null;
   }
-}
+};
+/** 最近一次初始化使用的 appKey，供全局场景读取 */
+__publicField(_GeneratorSDK, "lastInitializedAppKey", null);
+let GeneratorSDK = _GeneratorSDK;
 const withBilling = async (billing, action5, options) => {
   var _a2;
   const check = billing.check();

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export declare type AuthChangeCallback = (status: AuthStatus) => void;
 
 /**
  * Auth 模块
- * 对外暴露：getStatus / login / logout / onChange / getToken
+ * 对外暴露：getStatus / login / logout / onChange / getToken / syncToken
  */
 declare class AuthModule {
     private readonly appKey;
@@ -23,6 +23,10 @@ declare class AuthModule {
      * 未登录时返回空字符串
      */
     getToken(): string;
+    /**
+     * 外部传入 token，同步到本地缓存并刷新登录状态
+     */
+    syncToken(token: string): Promise<AuthStatus>;
     /**
      * 弹出登录弹窗
      * 登录成功后 resolve UserInfo，用户取消则 reject
@@ -477,6 +481,8 @@ export declare interface ExportProvider {
 export declare type ExportPurpose = 'download' | 'studio' | 'cover';
 
 export declare class GeneratorSDK {
+    /** 最近一次初始化使用的 appKey，供全局场景读取 */
+    private static lastInitializedAppKey;
     /** 登录/退出/用户信息 */
     readonly auth: AuthModule;
     /** 云保存/恢复/删除 */
@@ -494,6 +500,10 @@ export declare class GeneratorSDK {
     private readonly appKey;
     private readonly env;
     private constructor();
+    /**
+     * 返回当前 SDK 实例绑定的 appKey
+     */
+    getAppKey(): string;
     /**
      * 初始化 SDK，返回 SDK 实例
      *
@@ -505,6 +515,10 @@ export declare class GeneratorSDK {
      * ```
      */
     static init(options: SdkInitOptions): GeneratorSDK;
+    /**
+     * 返回最近一次初始化使用的 appKey
+     */
+    static getAppKey(): string | null;
     /**
      * 清除实例缓存（测试场景使用）
      */

package/dist/index.es.js

@@ -1,4 +1,4 @@
-import { G, S, T, w } from "./index-BtfWZLb7.js";
+import { G, S, T, w } from "./index-DP-Q2Dkh.js";
 export {
   G as GeneratorSDK,
   S as SdkError,