sydear 0.1.0

package/dist/client.js

@@ -0,0 +1,326 @@
+/**
+ * Main Sydear client.
+ */
+import { AuthenticationError, APIError, InsufficientSPUError, InvalidRequestError, RateLimitError, SydearError, } from "./errors.js";
+const DEFAULT_BASE_URL = "https://api.sydear.space/v1";
+const DEFAULT_TIMEOUT = 60_000; // 60s
+export class Sydear {
+    apiKey;
+    baseURL;
+    timeout;
+    maxRetries;
+    defaultSignal;
+    // Resource namespaces
+    chat;
+    audio;
+    images;
+    music;
+    videos;
+    models;
+    usage;
+    constructor(apiKey, options = {}) {
+        this.apiKey = apiKey ?? process.env.SYDEAR_API_KEY ?? "";
+        if (!this.apiKey) {
+            throw new AuthenticationError("No API key. Pass apiKey=... or set SYDEAR_API_KEY env var.");
+        }
+        this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
+        this.maxRetries = options.maxRetries ?? 0;
+        this.defaultSignal = options.signal;
+        this.chat = new ChatNamespace(this);
+        this.audio = new AudioNamespace(this);
+        this.images = new ImagesNamespace(this);
+        this.music = new MusicNamespace(this);
+        this.videos = new VideosNamespace(this);
+        this.models = new ModelsNamespace(this);
+        this.usage = new UsageNamespace(this);
+    }
+    /** Internal: perform request with retry + error mapping. */
+    async _request(method, path, init = {}) {
+        const url = `${this.baseURL}${path}`;
+        const headers = new Headers(init.headers);
+        headers.set("Authorization", `Bearer ${this.apiKey}`);
+        if (init.body && typeof init.body === "string") {
+            headers.set("Content-Type", "application/json");
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        const signal = init.signal ?? this.defaultSignal;
+        if (signal) {
+            signal.addEventListener("abort", () => controller.abort());
+        }
+        let attempt = 0;
+        while (true) {
+            try {
+                const res = await fetch(url, { ...init, headers, signal: controller.signal });
+                clearTimeout(timer);
+                if (this._shouldRetry(res.status, attempt)) {
+                    attempt++;
+                    await sleep(this._backoffMs(attempt));
+                    continue;
+                }
+                this._raiseForStatus(res);
+                return res;
+            }
+            catch (err) {
+                clearTimeout(timer);
+                if (err instanceof SydearError)
+                    throw err;
+                if (attempt < this.maxRetries) {
+                    attempt++;
+                    await sleep(this._backoffMs(attempt));
+                    continue;
+                }
+                throw new APIError(err.message ?? "Network error", 0);
+            }
+        }
+    }
+    _shouldRetry(status, attempt) {
+        if (attempt >= this.maxRetries)
+            return false;
+        return status === 429 || status === 503 || status === 504;
+    }
+    _backoffMs(attempt) {
+        return Math.min(500 * 2 ** (attempt - 1), 4000);
+    }
+    async _raiseForStatusAsync(res) {
+        if (res.ok)
+            return;
+        const text = await res.text();
+        let body;
+        try {
+            body = JSON.parse(text);
+        }
+        catch { }
+        const msg = body?.error?.message ?? text ?? `HTTP ${res.status}`;
+        if (res.status === 401 || res.status === 403)
+            throw new AuthenticationError(msg);
+        if (res.status === 400)
+            throw new InvalidRequestError(msg);
+        if (res.status === 402)
+            throw new InsufficientSPUError(msg);
+        if (res.status === 429) {
+            const ra = res.headers.get("retry-after");
+            throw new RateLimitError(msg, ra ? Number(ra) : undefined);
+        }
+        throw new APIError(msg, res.status, text);
+    }
+    /** Sync-style raiseForStatus — only call after reading body. */
+    _raiseForStatus(res) {
+        if (res.ok)
+            return;
+        // For sync case, must read body before throwing
+        res.text().then((text) => {
+            // Not awaited here; the caller must use _raiseForStatusAsync
+            // for full error info. This is a fallback that only triggers
+            // for ok=false (which our retry loop catches for retryable codes).
+        });
+    }
+    // (Same async method exposed publicly)
+    async raiseIfNotOK(res) {
+        return this._raiseForStatusAsync(res);
+    }
+}
+// -------- Resource namespaces --------
+class ChatNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async create(req) {
+        const body = { ...req, stream: false };
+        const res = await this.client._request("POST", "/chat/completions", {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        await this.client.raiseIfNotOK(res);
+        return res.json();
+    }
+    /** Async iterable over SSE chunks. */
+    async *stream(req) {
+        const body = { ...req, stream: true };
+        const res = await this.client._request("POST", "/chat/completions", {
+            method: "POST",
+            body: JSON.stringify(body),
+            headers: { Accept: "text/event-stream" },
+        });
+        await this.client.raiseIfNotOK(res);
+        if (!res.body)
+            throw new Error("No response body");
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buf = "";
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buf += decoder.decode(value, { stream: true });
+            const lines = buf.split("\n");
+            buf = lines.pop() ?? "";
+            for (const line of lines) {
+                const t = line.trim();
+                if (!t.startsWith("data:"))
+                    continue;
+                const payload = t.slice(5).trim();
+                if (payload === "[DONE]")
+                    return;
+                try {
+                    yield JSON.parse(payload);
+                }
+                catch { /* skip */ }
+            }
+        }
+    }
+}
+class AudioNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async speech(req) {
+        const body = {
+            model: req.model ?? "sydear-echo",
+            input: req.input,
+            voice: req.voice ?? "default",
+            response_format: req.response_format ?? "mp3",
+        };
+        const res = await this.client._request("POST", "/audio/speech", {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        await this.client.raiseIfNotOK(res);
+        const buf = await res.arrayBuffer();
+        return new Uint8Array(buf);
+    }
+    async transcriptions(req) {
+        const fileBuf = toBuffer(req.file);
+        const filename = req.filename ?? (typeof req.file === "string" ? basename(req.file) : "audio.mp3");
+        const fd = new FormData();
+        fd.append("model", req.model ?? "sydear-stt-1");
+        if (req.language)
+            fd.append("language", req.language);
+        if (req.response_format)
+            fd.append("response_format", req.response_format);
+        const res = await this.client._request("POST", "/audio/transcriptions", {
+            method: "POST",
+            body: fd,
+        });
+        await this.client.raiseIfNotOK(res);
+        if (req.response_format === "text")
+            return res.text();
+        return res.json();
+    }
+}
+class ImagesNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async generate(req) {
+        const body = {
+            model: req.model ?? "sydear-galaxy",
+            prompt: req.prompt,
+            n: req.n ?? 1,
+            size: req.size ?? "1024x1024",
+        };
+        const res = await this.client._request("POST", "/images/generations", {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        await this.client.raiseIfNotOK(res);
+        return res.json();
+    }
+    async edit(req) {
+        const fd = new FormData();
+        const body = { model: req.model ?? "sydear-galaxy", prompt: req.prompt };
+        fd.append("image", new Blob([new Uint8Array(toBuffer(req.image))]), "image.png");
+        if (req.mask)
+            fd.append("mask", new Blob([new Uint8Array(toBuffer(req.mask))]), "mask.png");
+        // prompt already added via body
+        fd.append("model", req.model ?? "sydear-galaxy");
+        const res = await this.client._request("POST", "/images/edits", {
+            method: "POST",
+            body: fd,
+        });
+        await this.client.raiseIfNotOK(res);
+        return res.json();
+    }
+}
+class MusicNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async generate(req) {
+        const body = {
+            model: req.model ?? "sydear-supernova",
+            prompt: req.prompt,
+            ...(req.lyrics ? { lyrics: req.lyrics } : {}),
+        };
+        const res = await this.client._request("POST", "/music/generations", {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        await this.client.raiseIfNotOK(res);
+        return res.json();
+    }
+}
+class VideosNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async generate(req) {
+        const body = { model: req.model ?? "sydear-video-v1", prompt: req.prompt };
+        const res = await this.client._request("POST", "/videos/generations", {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        await this.client.raiseIfNotOK(res);
+        return res.json();
+    }
+}
+class ModelsNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async list() {
+        const res = await this.client._request("GET", "/models");
+        await this.client.raiseIfNotOK(res);
+        return res.json();
+    }
+}
+class UsageNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async credits() {
+        const res = await this.client._request("GET", "/credits");
+        await this.client.raiseIfNotOK(res);
+        return res.json();
+    }
+    async today() {
+        const res = await this.client._request("GET", "/usage/today");
+        await this.client.raiseIfNotOK(res);
+        return res.json();
+    }
+}
+// -------- Helpers --------
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+function toBuffer(x) {
+    if (typeof x === "string") {
+        // Assume it's a file path — caller should pre-load via fs.
+        // We throw because Node.js fetch can't take a path in body.
+        throw new InvalidRequestError("Pass file as Buffer/Uint8Array, not file path. Read it with fs.readFileSync() first.");
+    }
+    return x;
+}
+function basename(path) {
+    const parts = path.split(/[\\/]/);
+    return parts[parts.length - 1] || "file";
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.mjs

@@ -0,0 +1,326 @@
+/**
+ * Main Sydear client.
+ */
+import { AuthenticationError, APIError, InsufficientSPUError, InvalidRequestError, RateLimitError, SydearError, } from "./errors.js";
+const DEFAULT_BASE_URL = "https://api.sydear.space/v1";
+const DEFAULT_TIMEOUT = 60_000; // 60s
+export class Sydear {
+    apiKey;
+    baseURL;
+    timeout;
+    maxRetries;
+    defaultSignal;
+    // Resource namespaces
+    chat;
+    audio;
+    images;
+    music;
+    videos;
+    models;
+    usage;
+    constructor(apiKey, options = {}) {
+        this.apiKey = apiKey ?? process.env.SYDEAR_API_KEY ?? "";
+        if (!this.apiKey) {
+            throw new AuthenticationError("No API key. Pass apiKey=... or set SYDEAR_API_KEY env var.");
+        }
+        this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
+        this.maxRetries = options.maxRetries ?? 0;
+        this.defaultSignal = options.signal;
+        this.chat = new ChatNamespace(this);
+        this.audio = new AudioNamespace(this);
+        this.images = new ImagesNamespace(this);
+        this.music = new MusicNamespace(this);
+        this.videos = new VideosNamespace(this);
+        this.models = new ModelsNamespace(this);
+        this.usage = new UsageNamespace(this);
+    }
+    /** Internal: perform request with retry + error mapping. */
+    async _request(method, path, init = {}) {
+        const url = `${this.baseURL}${path}`;
+        const headers = new Headers(init.headers);
+        headers.set("Authorization", `Bearer ${this.apiKey}`);
+        if (init.body && typeof init.body === "string") {
+            headers.set("Content-Type", "application/json");
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        const signal = init.signal ?? this.defaultSignal;
+        if (signal) {
+            signal.addEventListener("abort", () => controller.abort());
+        }
+        let attempt = 0;
+        while (true) {
+            try {
+                const res = await fetch(url, { ...init, headers, signal: controller.signal });
+                clearTimeout(timer);
+                if (this._shouldRetry(res.status, attempt)) {
+                    attempt++;
+                    await sleep(this._backoffMs(attempt));
+                    continue;
+                }
+                this._raiseForStatus(res);
+                return res;
+            }
+            catch (err) {
+                clearTimeout(timer);
+                if (err instanceof SydearError)
+                    throw err;
+                if (attempt < this.maxRetries) {
+                    attempt++;
+                    await sleep(this._backoffMs(attempt));
+                    continue;
+                }
+                throw new APIError(err.message ?? "Network error", 0);
+            }
+        }
+    }
+    _shouldRetry(status, attempt) {
+        if (attempt >= this.maxRetries)
+            return false;
+        return status === 429 || status === 503 || status === 504;
+    }
+    _backoffMs(attempt) {
+        return Math.min(500 * 2 ** (attempt - 1), 4000);
+    }
+    async _raiseForStatusAsync(res) {
+        if (res.ok)
+            return;
+        const text = await res.text();
+        let body;
+        try {
+            body = JSON.parse(text);
+        }
+        catch { }
+        const msg = body?.error?.message ?? text ?? `HTTP ${res.status}`;
+        if (res.status === 401 || res.status === 403)
+            throw new AuthenticationError(msg);
+        if (res.status === 400)
+            throw new InvalidRequestError(msg);
+        if (res.status === 402)
+            throw new InsufficientSPUError(msg);
+        if (res.status === 429) {
+            const ra = res.headers.get("retry-after");
+            throw new RateLimitError(msg, ra ? Number(ra) : undefined);
+        }
+        throw new APIError(msg, res.status, text);
+    }
+    /** Sync-style raiseForStatus — only call after reading body. */
+    _raiseForStatus(res) {
+        if (res.ok)
+            return;
+        // For sync case, must read body before throwing
+        res.text().then((text) => {
+            // Not awaited here; the caller must use _raiseForStatusAsync
+            // for full error info. This is a fallback that only triggers
+            // for ok=false (which our retry loop catches for retryable codes).
+        });
+    }
+    // (Same async method exposed publicly)
+    async raiseIfNotOK(res) {
+        return this._raiseForStatusAsync(res);
+    }
+}
+// -------- Resource namespaces --------
+class ChatNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async create(req) {
+        const body = { ...req, stream: false };
+        const res = await this.client._request("POST", "/chat/completions", {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        await this.client.raiseIfNotOK(res);
+        return res.json();
+    }
+    /** Async iterable over SSE chunks. */
+    async *stream(req) {
+        const body = { ...req, stream: true };
+        const res = await this.client._request("POST", "/chat/completions", {
+            method: "POST",
+            body: JSON.stringify(body),
+            headers: { Accept: "text/event-stream" },
+        });
+        await this.client.raiseIfNotOK(res);
+        if (!res.body)
+            throw new Error("No response body");
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buf = "";
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buf += decoder.decode(value, { stream: true });
+            const lines = buf.split("\n");
+            buf = lines.pop() ?? "";
+            for (const line of lines) {
+                const t = line.trim();
+                if (!t.startsWith("data:"))
+                    continue;
+                const payload = t.slice(5).trim();
+                if (payload === "[DONE]")
+                    return;
+                try {
+                    yield JSON.parse(payload);
+                }
+                catch { /* skip */ }
+            }
+        }
+    }
+}
+class AudioNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async speech(req) {
+        const body = {
+            model: req.model ?? "sydear-echo",
+            input: req.input,
+            voice: req.voice ?? "default",
+            response_format: req.response_format ?? "mp3",
+        };
+        const res = await this.client._request("POST", "/audio/speech", {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        await this.client.raiseIfNotOK(res);
+        const buf = await res.arrayBuffer();
+        return new Uint8Array(buf);
+    }
+    async transcriptions(req) {
+        const fileBuf = toBuffer(req.file);
+        const filename = req.filename ?? (typeof req.file === "string" ? basename(req.file) : "audio.mp3");
+        const fd = new FormData();
+        fd.append("model", req.model ?? "sydear-stt-1");
+        if (req.language)
+            fd.append("language", req.language);
+        if (req.response_format)
+            fd.append("response_format", req.response_format);
+        const res = await this.client._request("POST", "/audio/transcriptions", {
+            method: "POST",
+            body: fd,
+        });
+        await this.client.raiseIfNotOK(res);
+        if (req.response_format === "text")
+            return res.text();
+        return res.json();
+    }
+}
+class ImagesNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async generate(req) {
+        const body = {
+            model: req.model ?? "sydear-galaxy",
+            prompt: req.prompt,
+            n: req.n ?? 1,
+            size: req.size ?? "1024x1024",
+        };
+        const res = await this.client._request("POST", "/images/generations", {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        await this.client.raiseIfNotOK(res);
+        return res.json();
+    }
+    async edit(req) {
+        const fd = new FormData();
+        const body = { model: req.model ?? "sydear-galaxy", prompt: req.prompt };
+        fd.append("image", new Blob([new Uint8Array(toBuffer(req.image))]), "image.png");
+        if (req.mask)
+            fd.append("mask", new Blob([new Uint8Array(toBuffer(req.mask))]), "mask.png");
+        // prompt already added via body
+        fd.append("model", req.model ?? "sydear-galaxy");
+        const res = await this.client._request("POST", "/images/edits", {
+            method: "POST",
+            body: fd,
+        });
+        await this.client.raiseIfNotOK(res);
+        return res.json();
+    }
+}
+class MusicNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async generate(req) {
+        const body = {
+            model: req.model ?? "sydear-supernova",
+            prompt: req.prompt,
+            ...(req.lyrics ? { lyrics: req.lyrics } : {}),
+        };
+        const res = await this.client._request("POST", "/music/generations", {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        await this.client.raiseIfNotOK(res);
+        return res.json();
+    }
+}
+class VideosNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async generate(req) {
+        const body = { model: req.model ?? "sydear-video-v1", prompt: req.prompt };
+        const res = await this.client._request("POST", "/videos/generations", {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        await this.client.raiseIfNotOK(res);
+        return res.json();
+    }
+}
+class ModelsNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async list() {
+        const res = await this.client._request("GET", "/models");
+        await this.client.raiseIfNotOK(res);
+        return res.json();
+    }
+}
+class UsageNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async credits() {
+        const res = await this.client._request("GET", "/credits");
+        await this.client.raiseIfNotOK(res);
+        return res.json();
+    }
+    async today() {
+        const res = await this.client._request("GET", "/usage/today");
+        await this.client.raiseIfNotOK(res);
+        return res.json();
+    }
+}
+// -------- Helpers --------
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+function toBuffer(x) {
+    if (typeof x === "string") {
+        // Assume it's a file path — caller should pre-load via fs.
+        // We throw because Node.js fetch can't take a path in body.
+        throw new InvalidRequestError("Pass file as Buffer/Uint8Array, not file path. Read it with fs.readFileSync() first.");
+    }
+    return x;
+}
+function basename(path) {
+    const parts = path.split(/[\\/]/);
+    return parts[parts.length - 1] || "file";
+}
+//# sourceMappingURL=client.js.map