@acedatacloud/sdk 2026.727.0 → 2026.727.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acedatacloud/sdk",
-  "version": "2026.727.0",
+  "version": "2026.727.2",
   "description": "Official TypeScript SDK for AceDataCloud — AI-powered data services",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/resources/providers/producer.ts

@@ -24,7 +24,7 @@ export interface ProducerUploadOptions {
   [key: string]: unknown;
 }
 
-export interface ProducerGenerateOptions {
+export interface ProducerVideosOptions {
   /** Reference audio ID. */
   audioId: string;
   callbackUrl?: string;
@@ -40,7 +40,7 @@ export interface ProducerWavOptions {
   [key: string]: unknown;
 }
 
-export interface ProducerProducerAudiosOptions {
+export interface ProducerGenerateOptions {
   /** Lyrics content for generating audio. */
   lyric: string;
   /** Types of audio generation operations. Supported values include `generate` (generate based on prompts), `cover` (cover song), `extend` (continue writing), `variation` (variant), `swap_vocals` (replace vocals), `swap_instrumentals` (replace instrumentals), `replace_section` (replace section), `stems` (separate tracks). */
@@ -108,7 +108,7 @@ export class Producer {
   }
 
   /** AceData Producer MP4 retrieval API. Pass an audio_id to receive an MP4 video download link with cover art. */
-  async generate(options: ProducerGenerateOptions): Promise<Record<string, unknown>> {
+  async videos(options: ProducerVideosOptions): Promise<Record<string, unknown>> {
     const body: Record<string, unknown> = {};
     body["audio_id"] = options.audioId;
     for (const [key, value] of Object.entries(options)) {
@@ -134,7 +134,7 @@ export class Producer {
   }
 
   /** Producer AI music generation API, generates 1 song per request. */
-  async producer_audios(options: ProducerProducerAudiosOptions): Promise<TaskHandle> {
+  async generate(options: ProducerGenerateOptions): Promise<TaskHandle> {
     const body: Record<string, unknown> = {};
     body["lyric"] = options.lyric;
     body["action"] = options.action;

package/src/runtime/tasks.ts

@@ -184,16 +184,32 @@ export class TaskHandle {
     return taskProgress(this._result);
   }
 
+  /**
+   * Fetch current task state, remembering it once terminal.
+   *
+   * A caller that drives its own poll loop — checking status between polls so it
+   * can report progress — only ever calls this. Without recording here, urls()
+   * and result() stay empty after the task has plainly finished.
+   */
   async get(): Promise<Record<string, unknown>> {
-    return this.transport.request('POST', this.pollEndpoint, {
+    const state = await this.transport.request('POST', this.pollEndpoint, {
       json: { id: this.id, action: 'retrieve' },
     });
+    this.accept(state);
+    return state;
+  }
+
+  private accept(state: Record<string, unknown>): void {
+    const status = taskStatus(state);
+    if (status === 'succeeded' || status === 'failed') {
+      this._result = state;
+    }
   }
 
   async isCompleted(): Promise<boolean> {
     if (this.done) return true;
-    const status = taskStatus(await this.get());
-    return status === 'succeeded' || status === 'failed';
+    await this.get(); // records a terminal state as a side effect
+    return this.done;
   }
 
   async wait(opts: TaskHandleOptions = {}): Promise<Record<string, unknown>> {
@@ -205,12 +221,7 @@ export class TaskHandle {
 
     while (Date.now() - start < maxWait) {
       const state = await this.get();
-      const status = taskStatus(state);
-
-      if (status === 'succeeded' || status === 'failed') {
-        this._result = state;
-        return state;
-      }
+      if (this.done) return state;
       await new Promise((resolve) => setTimeout(resolve, pollInterval));
     }
     throw new Error(`Task ${this.id} did not complete within ${maxWait}ms`);