@acedatacloud/sdk 2026.322.1 → 2026.418.0

package/dist/index.d.mts

@@ -0,0 +1,336 @@
+/** HTTP transport for AceDataCloud SDK. Uses native fetch (Node 18+). */
+interface TransportOptions {
+    apiToken?: string;
+    baseURL?: string;
+    platformBaseURL?: string;
+    timeout?: number;
+    maxRetries?: number;
+    headers?: Record<string, string>;
+}
+declare class Transport {
+    private baseURL;
+    private platformBaseURL;
+    private timeout;
+    private maxRetries;
+    private headers;
+    constructor(opts?: TransportOptions);
+    request(method: string, path: string, opts?: {
+        json?: Record<string, unknown>;
+        params?: Record<string, string>;
+        platform?: boolean;
+        timeout?: number;
+        headers?: Record<string, string>;
+    }): Promise<Record<string, unknown>>;
+    requestStream(method: string, path: string, opts?: {
+        json?: Record<string, unknown>;
+        timeout?: number;
+    }): AsyncGenerator<string, void, unknown>;
+    upload(path: string, fileData: Buffer | Uint8Array, filename: string, opts?: {
+        timeout?: number;
+    }): Promise<Record<string, unknown>>;
+}
+
+/** Chat resources — native provider APIs (Claude Messages). */
+
+declare class Messages {
+    private transport;
+    constructor(transport: Transport);
+    create(opts: {
+        model: string;
+        messages: Array<Record<string, unknown>>;
+        maxTokens?: number;
+        stream?: false;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown>>;
+    create(opts: {
+        model: string;
+        messages: Array<Record<string, unknown>>;
+        maxTokens?: number;
+        stream: true;
+        [key: string]: unknown;
+    }): Promise<AsyncGenerator<Record<string, unknown>>>;
+    private stream;
+    countTokens(opts: {
+        model: string;
+        messages: Array<Record<string, unknown>>;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown>>;
+}
+declare class Chat {
+    readonly messages: Messages;
+    constructor(transport: Transport);
+}
+
+/** Task polling abstraction. */
+
+interface TaskHandleOptions {
+    pollInterval?: number;
+    maxWait?: number;
+}
+declare class TaskHandle {
+    readonly id: string;
+    private pollEndpoint;
+    private transport;
+    private _result;
+    constructor(taskId: string, pollEndpoint: string, transport: Transport);
+    get(): Promise<Record<string, unknown>>;
+    isCompleted(): Promise<boolean>;
+    wait(opts?: TaskHandleOptions): Promise<Record<string, unknown>>;
+    get result(): Record<string, unknown> | null;
+}
+
+/** Image generation resources. */
+
+type ImageProvider = 'nano-banana' | 'midjourney' | 'flux' | 'seedream' | (string & {});
+declare class Images {
+    private transport;
+    constructor(transport: Transport);
+    generate(opts: {
+        prompt: string;
+        provider?: ImageProvider;
+        model?: string;
+        negativePrompt?: string;
+        imageUrl?: string;
+        callbackUrl?: string;
+        wait?: boolean;
+        pollInterval?: number;
+        maxWait?: number;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown> | TaskHandle>;
+}
+
+/** Audio/music generation resources. */
+
+type AudioProvider = 'suno' | 'producer' | (string & {});
+declare class Audio {
+    private transport;
+    constructor(transport: Transport);
+    generate(opts: {
+        prompt: string;
+        provider?: AudioProvider;
+        model?: string;
+        tags?: string;
+        callbackUrl?: string;
+        wait?: boolean;
+        pollInterval?: number;
+        maxWait?: number;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown> | TaskHandle>;
+}
+
+/** Video generation resources. */
+
+type VideoProvider = 'sora' | 'luma' | 'veo' | 'kling' | 'hailuo' | 'seedance' | 'wan' | 'pika' | 'pixverse' | (string & {});
+declare class Video {
+    private transport;
+    constructor(transport: Transport);
+    generate(opts: {
+        prompt: string;
+        provider?: VideoProvider;
+        model?: string;
+        imageUrl?: string;
+        callbackUrl?: string;
+        wait?: boolean;
+        pollInterval?: number;
+        maxWait?: number;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown> | TaskHandle>;
+}
+
+/** Search resources. */
+
+declare class Search {
+    private transport;
+    constructor(transport: Transport);
+    google(opts: {
+        query: string;
+        type?: string;
+        country?: string;
+        language?: string;
+        page?: number;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown>>;
+}
+
+/** Cross-service task retrieval. */
+
+declare class Tasks {
+    private transport;
+    constructor(transport: Transport);
+    get(taskId: string, opts?: {
+        service?: string;
+    }): Promise<Record<string, unknown>>;
+    wait(taskId: string, opts?: {
+        service?: string;
+        pollInterval?: number;
+        maxWait?: number;
+    }): Promise<Record<string, unknown>>;
+}
+
+/** File upload resources. */
+
+declare class Files {
+    private transport;
+    constructor(transport: Transport);
+    upload(file: string | Buffer | Uint8Array, opts?: {
+        filename?: string;
+    }): Promise<Record<string, unknown>>;
+}
+
+/** Management-plane resources. */
+
+declare class Applications {
+    private transport;
+    constructor(transport: Transport);
+    list(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    create(opts: {
+        serviceId: string;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown>>;
+    get(applicationId: string): Promise<Record<string, unknown>>;
+}
+declare class Credentials {
+    private transport;
+    constructor(transport: Transport);
+    list(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    create(opts: {
+        applicationId: string;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown>>;
+    rotate(credentialId: string): Promise<Record<string, unknown>>;
+    delete(credentialId: string): Promise<Record<string, unknown>>;
+}
+declare class Models {
+    private transport;
+    constructor(transport: Transport);
+    list(params?: Record<string, string>): Promise<Record<string, unknown>>;
+}
+declare class Config {
+    private transport;
+    constructor(transport: Transport);
+    get(): Promise<Record<string, unknown>>;
+}
+declare class Platform {
+    readonly applications: Applications;
+    readonly credentials: Credentials;
+    readonly models: Models;
+    readonly config: Config;
+    constructor(transport: Transport);
+}
+
+/** OpenAI-compatible facade resources. */
+
+declare class Completions {
+    private transport;
+    constructor(transport: Transport);
+    create(opts: {
+        model: string;
+        messages: Array<Record<string, unknown>>;
+        stream?: false;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown>>;
+    create(opts: {
+        model: string;
+        messages: Array<Record<string, unknown>>;
+        stream: true;
+        [key: string]: unknown;
+    }): Promise<AsyncGenerator<Record<string, unknown>>>;
+    private streamResponse;
+}
+declare class ChatNamespace {
+    readonly completions: Completions;
+    constructor(transport: Transport);
+}
+declare class Responses {
+    private transport;
+    constructor(transport: Transport);
+    create(opts: {
+        model: string;
+        input: string | Array<Record<string, unknown>>;
+        stream?: false;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown>>;
+    create(opts: {
+        model: string;
+        input: string | Array<Record<string, unknown>>;
+        stream: true;
+        [key: string]: unknown;
+    }): Promise<AsyncGenerator<Record<string, unknown>>>;
+    private streamResponse;
+}
+declare class OpenAI {
+    readonly chat: ChatNamespace;
+    readonly responses: Responses;
+    constructor(transport: Transport);
+}
+
+/** Top-level AceDataCloud client for TypeScript. */
+
+interface AceDataCloudOptions {
+    apiToken?: string;
+    baseURL?: string;
+    platformBaseURL?: string;
+    timeout?: number;
+    maxRetries?: number;
+    headers?: Record<string, string>;
+}
+declare class AceDataCloud {
+    readonly chat: Chat;
+    readonly images: Images;
+    readonly audio: Audio;
+    readonly video: Video;
+    readonly search: Search;
+    readonly tasks: Tasks;
+    readonly files: Files;
+    readonly platform: Platform;
+    readonly openai: OpenAI;
+    private transport;
+    constructor(opts?: AceDataCloudOptions);
+}
+
+/** AceDataCloud SDK errors. */
+declare class AceDataCloudError extends Error {
+    constructor(message: string);
+}
+declare class TransportError extends AceDataCloudError {
+    constructor(message: string);
+}
+declare class APIError extends AceDataCloudError {
+    statusCode: number;
+    code: string;
+    traceId?: string;
+    body: Record<string, unknown>;
+    constructor(opts: {
+        message: string;
+        statusCode: number;
+        code: string;
+        traceId?: string;
+        body?: Record<string, unknown>;
+    });
+}
+declare class AuthenticationError extends APIError {
+    constructor(opts: ConstructorParameters<typeof APIError>[0]);
+}
+declare class TokenMismatchError extends APIError {
+    constructor(opts: ConstructorParameters<typeof APIError>[0]);
+}
+declare class RateLimitError extends APIError {
+    constructor(opts: ConstructorParameters<typeof APIError>[0]);
+}
+declare class ValidationError extends APIError {
+    constructor(opts: ConstructorParameters<typeof APIError>[0]);
+}
+declare class InsufficientBalanceError extends APIError {
+    constructor(opts: ConstructorParameters<typeof APIError>[0]);
+}
+declare class ResourceDisabledError extends APIError {
+    constructor(opts: ConstructorParameters<typeof APIError>[0]);
+}
+declare class ModerationError extends APIError {
+    constructor(opts: ConstructorParameters<typeof APIError>[0]);
+}
+declare class TimeoutError extends APIError {
+    constructor(opts: ConstructorParameters<typeof APIError>[0]);
+}
+
+export { APIError, AceDataCloud, AceDataCloudError, type AceDataCloudOptions, type AudioProvider, AuthenticationError, type ImageProvider, InsufficientBalanceError, ModerationError, RateLimitError, ResourceDisabledError, TaskHandle, type TaskHandleOptions, TimeoutError, TokenMismatchError, TransportError, ValidationError, type VideoProvider };

package/dist/index.d.ts

@@ -1,4 +1,336 @@
-/** @acedatacloud/sdk — Official TypeScript SDK for AceDataCloud. */
-export { AceDataCloud, AceDataCloudOptions } from './client';
-export { AceDataCloudError, APIError, AuthenticationError, InsufficientBalanceError, ModerationError, RateLimitError, ResourceDisabledError, TimeoutError, TokenMismatchError, TransportError, ValidationError, } from './runtime/errors';
-export { TaskHandle, TaskHandleOptions } from './runtime/tasks';
+/** HTTP transport for AceDataCloud SDK. Uses native fetch (Node 18+). */
+interface TransportOptions {
+    apiToken?: string;
+    baseURL?: string;
+    platformBaseURL?: string;
+    timeout?: number;
+    maxRetries?: number;
+    headers?: Record<string, string>;
+}
+declare class Transport {
+    private baseURL;
+    private platformBaseURL;
+    private timeout;
+    private maxRetries;
+    private headers;
+    constructor(opts?: TransportOptions);
+    request(method: string, path: string, opts?: {
+        json?: Record<string, unknown>;
+        params?: Record<string, string>;
+        platform?: boolean;
+        timeout?: number;
+        headers?: Record<string, string>;
+    }): Promise<Record<string, unknown>>;
+    requestStream(method: string, path: string, opts?: {
+        json?: Record<string, unknown>;
+        timeout?: number;
+    }): AsyncGenerator<string, void, unknown>;
+    upload(path: string, fileData: Buffer | Uint8Array, filename: string, opts?: {
+        timeout?: number;
+    }): Promise<Record<string, unknown>>;
+}
+
+/** Chat resources — native provider APIs (Claude Messages). */
+
+declare class Messages {
+    private transport;
+    constructor(transport: Transport);
+    create(opts: {
+        model: string;
+        messages: Array<Record<string, unknown>>;
+        maxTokens?: number;
+        stream?: false;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown>>;
+    create(opts: {
+        model: string;
+        messages: Array<Record<string, unknown>>;
+        maxTokens?: number;
+        stream: true;
+        [key: string]: unknown;
+    }): Promise<AsyncGenerator<Record<string, unknown>>>;
+    private stream;
+    countTokens(opts: {
+        model: string;
+        messages: Array<Record<string, unknown>>;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown>>;
+}
+declare class Chat {
+    readonly messages: Messages;
+    constructor(transport: Transport);
+}
+
+/** Task polling abstraction. */
+
+interface TaskHandleOptions {
+    pollInterval?: number;
+    maxWait?: number;
+}
+declare class TaskHandle {
+    readonly id: string;
+    private pollEndpoint;
+    private transport;
+    private _result;
+    constructor(taskId: string, pollEndpoint: string, transport: Transport);
+    get(): Promise<Record<string, unknown>>;
+    isCompleted(): Promise<boolean>;
+    wait(opts?: TaskHandleOptions): Promise<Record<string, unknown>>;
+    get result(): Record<string, unknown> | null;
+}
+
+/** Image generation resources. */
+
+type ImageProvider = 'nano-banana' | 'midjourney' | 'flux' | 'seedream' | (string & {});
+declare class Images {
+    private transport;
+    constructor(transport: Transport);
+    generate(opts: {
+        prompt: string;
+        provider?: ImageProvider;
+        model?: string;
+        negativePrompt?: string;
+        imageUrl?: string;
+        callbackUrl?: string;
+        wait?: boolean;
+        pollInterval?: number;
+        maxWait?: number;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown> | TaskHandle>;
+}
+
+/** Audio/music generation resources. */
+
+type AudioProvider = 'suno' | 'producer' | (string & {});
+declare class Audio {
+    private transport;
+    constructor(transport: Transport);
+    generate(opts: {
+        prompt: string;
+        provider?: AudioProvider;
+        model?: string;
+        tags?: string;
+        callbackUrl?: string;
+        wait?: boolean;
+        pollInterval?: number;
+        maxWait?: number;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown> | TaskHandle>;
+}
+
+/** Video generation resources. */
+
+type VideoProvider = 'sora' | 'luma' | 'veo' | 'kling' | 'hailuo' | 'seedance' | 'wan' | 'pika' | 'pixverse' | (string & {});
+declare class Video {
+    private transport;
+    constructor(transport: Transport);
+    generate(opts: {
+        prompt: string;
+        provider?: VideoProvider;
+        model?: string;
+        imageUrl?: string;
+        callbackUrl?: string;
+        wait?: boolean;
+        pollInterval?: number;
+        maxWait?: number;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown> | TaskHandle>;
+}
+
+/** Search resources. */
+
+declare class Search {
+    private transport;
+    constructor(transport: Transport);
+    google(opts: {
+        query: string;
+        type?: string;
+        country?: string;
+        language?: string;
+        page?: number;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown>>;
+}
+
+/** Cross-service task retrieval. */
+
+declare class Tasks {
+    private transport;
+    constructor(transport: Transport);
+    get(taskId: string, opts?: {
+        service?: string;
+    }): Promise<Record<string, unknown>>;
+    wait(taskId: string, opts?: {
+        service?: string;
+        pollInterval?: number;
+        maxWait?: number;
+    }): Promise<Record<string, unknown>>;
+}
+
+/** File upload resources. */
+
+declare class Files {
+    private transport;
+    constructor(transport: Transport);
+    upload(file: string | Buffer | Uint8Array, opts?: {
+        filename?: string;
+    }): Promise<Record<string, unknown>>;
+}
+
+/** Management-plane resources. */
+
+declare class Applications {
+    private transport;
+    constructor(transport: Transport);
+    list(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    create(opts: {
+        serviceId: string;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown>>;
+    get(applicationId: string): Promise<Record<string, unknown>>;
+}
+declare class Credentials {
+    private transport;
+    constructor(transport: Transport);
+    list(params?: Record<string, string>): Promise<Record<string, unknown>>;
+    create(opts: {
+        applicationId: string;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown>>;
+    rotate(credentialId: string): Promise<Record<string, unknown>>;
+    delete(credentialId: string): Promise<Record<string, unknown>>;
+}
+declare class Models {
+    private transport;
+    constructor(transport: Transport);
+    list(params?: Record<string, string>): Promise<Record<string, unknown>>;
+}
+declare class Config {
+    private transport;
+    constructor(transport: Transport);
+    get(): Promise<Record<string, unknown>>;
+}
+declare class Platform {
+    readonly applications: Applications;
+    readonly credentials: Credentials;
+    readonly models: Models;
+    readonly config: Config;
+    constructor(transport: Transport);
+}
+
+/** OpenAI-compatible facade resources. */
+
+declare class Completions {
+    private transport;
+    constructor(transport: Transport);
+    create(opts: {
+        model: string;
+        messages: Array<Record<string, unknown>>;
+        stream?: false;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown>>;
+    create(opts: {
+        model: string;
+        messages: Array<Record<string, unknown>>;
+        stream: true;
+        [key: string]: unknown;
+    }): Promise<AsyncGenerator<Record<string, unknown>>>;
+    private streamResponse;
+}
+declare class ChatNamespace {
+    readonly completions: Completions;
+    constructor(transport: Transport);
+}
+declare class Responses {
+    private transport;
+    constructor(transport: Transport);
+    create(opts: {
+        model: string;
+        input: string | Array<Record<string, unknown>>;
+        stream?: false;
+        [key: string]: unknown;
+    }): Promise<Record<string, unknown>>;
+    create(opts: {
+        model: string;
+        input: string | Array<Record<string, unknown>>;
+        stream: true;
+        [key: string]: unknown;
+    }): Promise<AsyncGenerator<Record<string, unknown>>>;
+    private streamResponse;
+}
+declare class OpenAI {
+    readonly chat: ChatNamespace;
+    readonly responses: Responses;
+    constructor(transport: Transport);
+}
+
+/** Top-level AceDataCloud client for TypeScript. */
+
+interface AceDataCloudOptions {
+    apiToken?: string;
+    baseURL?: string;
+    platformBaseURL?: string;
+    timeout?: number;
+    maxRetries?: number;
+    headers?: Record<string, string>;
+}
+declare class AceDataCloud {
+    readonly chat: Chat;
+    readonly images: Images;
+    readonly audio: Audio;
+    readonly video: Video;
+    readonly search: Search;
+    readonly tasks: Tasks;
+    readonly files: Files;
+    readonly platform: Platform;
+    readonly openai: OpenAI;
+    private transport;
+    constructor(opts?: AceDataCloudOptions);
+}
+
+/** AceDataCloud SDK errors. */
+declare class AceDataCloudError extends Error {
+    constructor(message: string);
+}
+declare class TransportError extends AceDataCloudError {
+    constructor(message: string);
+}
+declare class APIError extends AceDataCloudError {
+    statusCode: number;
+    code: string;
+    traceId?: string;
+    body: Record<string, unknown>;
+    constructor(opts: {
+        message: string;
+        statusCode: number;
+        code: string;
+        traceId?: string;
+        body?: Record<string, unknown>;
+    });
+}
+declare class AuthenticationError extends APIError {
+    constructor(opts: ConstructorParameters<typeof APIError>[0]);
+}
+declare class TokenMismatchError extends APIError {
+    constructor(opts: ConstructorParameters<typeof APIError>[0]);
+}
+declare class RateLimitError extends APIError {
+    constructor(opts: ConstructorParameters<typeof APIError>[0]);
+}
+declare class ValidationError extends APIError {
+    constructor(opts: ConstructorParameters<typeof APIError>[0]);
+}
+declare class InsufficientBalanceError extends APIError {
+    constructor(opts: ConstructorParameters<typeof APIError>[0]);
+}
+declare class ResourceDisabledError extends APIError {
+    constructor(opts: ConstructorParameters<typeof APIError>[0]);
+}
+declare class ModerationError extends APIError {
+    constructor(opts: ConstructorParameters<typeof APIError>[0]);
+}
+declare class TimeoutError extends APIError {
+    constructor(opts: ConstructorParameters<typeof APIError>[0]);
+}
+
+export { APIError, AceDataCloud, AceDataCloudError, type AceDataCloudOptions, type AudioProvider, AuthenticationError, type ImageProvider, InsufficientBalanceError, ModerationError, RateLimitError, ResourceDisabledError, TaskHandle, type TaskHandleOptions, TimeoutError, TokenMismatchError, TransportError, ValidationError, type VideoProvider };