sydear 0.1.0

package/dist/errors.cjs

@@ -0,0 +1,46 @@
+/**
+ * Exception hierarchy for Sydear SDK.
+ */
+class SydearError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SydearError";
+    }
+}
+class AuthenticationError extends SydearError {
+    constructor(message = "Invalid or missing API key") {
+        super(message);
+        this.name = "AuthenticationError";
+    }
+}
+class InvalidRequestError extends SydearError {
+    constructor(message = "Invalid request") {
+        super(message);
+        this.name = "InvalidRequestError";
+    }
+}
+class InsufficientSPUError extends SydearError {
+    constructor(message = "Insufficient SPU balance") {
+        super(message);
+        this.name = "InsufficientSPUError";
+    }
+}
+class RateLimitError extends SydearError {
+    retryAfter; // seconds
+    constructor(message = "Rate limit exceeded", retryAfter) {
+        super(message);
+        this.name = "RateLimitError";
+        this.retryAfter = retryAfter;
+    }
+}
+class APIError extends SydearError {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.name = "APIError";
+        this.status = status;
+        this.body = body;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Exception hierarchy for Sydear SDK.
+ */
+export declare class SydearError extends Error {
+    constructor(message: string);
+}
+export declare class AuthenticationError extends SydearError {
+    constructor(message?: string);
+}
+export declare class InvalidRequestError extends SydearError {
+    constructor(message?: string);
+}
+export declare class InsufficientSPUError extends SydearError {
+    constructor(message?: string);
+}
+export declare class RateLimitError extends SydearError {
+    retryAfter?: number;
+    constructor(message?: string, retryAfter?: number);
+}
+export declare class APIError extends SydearError {
+    status: number;
+    body?: string;
+    constructor(message: string, status: number, body?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,OAAO,SAA+B;CAInD;AAED,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,OAAO,SAAoB;CAIxC;AAED,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,OAAO,SAA6B;CAIjD;AAED,qBAAa,cAAe,SAAQ,WAAW;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;gBACR,OAAO,SAAwB,EAAE,UAAU,CAAC,EAAE,MAAM;CAKjE;AAED,qBAAa,QAAS,SAAQ,WAAW;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;gBACF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAM3D"}

package/dist/errors.js

@@ -0,0 +1,46 @@
+/**
+ * Exception hierarchy for Sydear SDK.
+ */
+export class SydearError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SydearError";
+    }
+}
+export class AuthenticationError extends SydearError {
+    constructor(message = "Invalid or missing API key") {
+        super(message);
+        this.name = "AuthenticationError";
+    }
+}
+export class InvalidRequestError extends SydearError {
+    constructor(message = "Invalid request") {
+        super(message);
+        this.name = "InvalidRequestError";
+    }
+}
+export class InsufficientSPUError extends SydearError {
+    constructor(message = "Insufficient SPU balance") {
+        super(message);
+        this.name = "InsufficientSPUError";
+    }
+}
+export class RateLimitError extends SydearError {
+    retryAfter; // seconds
+    constructor(message = "Rate limit exceeded", retryAfter) {
+        super(message);
+        this.name = "RateLimitError";
+        this.retryAfter = retryAfter;
+    }
+}
+export class APIError extends SydearError {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.name = "APIError";
+        this.status = status;
+        this.body = body;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,OAAO,GAAG,4BAA4B;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,OAAO,GAAG,iBAAiB;QACrC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD,YAAY,OAAO,GAAG,0BAA0B;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,WAAW;IAC7C,UAAU,CAAU,CAAE,UAAU;IAChC,YAAY,OAAO,GAAG,qBAAqB,EAAE,UAAmB;QAC9D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC,MAAM,CAAS;IACf,IAAI,CAAU;IACd,YAAY,OAAe,EAAE,MAAc,EAAE,IAAa;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/errors.mjs

@@ -0,0 +1,46 @@
+/**
+ * Exception hierarchy for Sydear SDK.
+ */
+export class SydearError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SydearError";
+    }
+}
+export class AuthenticationError extends SydearError {
+    constructor(message = "Invalid or missing API key") {
+        super(message);
+        this.name = "AuthenticationError";
+    }
+}
+export class InvalidRequestError extends SydearError {
+    constructor(message = "Invalid request") {
+        super(message);
+        this.name = "InvalidRequestError";
+    }
+}
+export class InsufficientSPUError extends SydearError {
+    constructor(message = "Insufficient SPU balance") {
+        super(message);
+        this.name = "InsufficientSPUError";
+    }
+}
+export class RateLimitError extends SydearError {
+    retryAfter; // seconds
+    constructor(message = "Rate limit exceeded", retryAfter) {
+        super(message);
+        this.name = "RateLimitError";
+        this.retryAfter = retryAfter;
+    }
+}
+export class APIError extends SydearError {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.name = "APIError";
+        this.status = status;
+        this.body = body;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/index.cjs

@@ -0,0 +1,18 @@
+const _reex___client = require("./client");
+module.exports.Sydear = _reex___client.Sydear;
+const _reex___errors = require("./errors");
+module.exports.APIError = _reex___errors.APIError;
+module.exports.AuthenticationError = _reex___errors.AuthenticationError;
+module.exports.InsufficientSPUError = _reex___errors.InsufficientSPUError;
+module.exports.InvalidRequestError = _reex___errors.InvalidRequestError;
+module.exports.RateLimitError = _reex___errors.RateLimitError;
+module.exports.SydearError = _reex___errors.SydearError;
+/**
+ * sydear — official SDK for the Sydear API.
+ * https://docs.sydear.space
+ */
+
+
+const VERSION = "0.1.0";
+//# sourceMappingURL=index.js.map
+module.exports.VERSION = VERSION;

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * sydear — official SDK for the Sydear API.
+ * https://docs.sydear.space
+ */
+export { Sydear } from "./client.js";
+export type { APIErrorBody, ChatCompletionChunk, ChatCompletionChoice, ChatCompletionRequest, ChatCompletionResponse, ChatMessage, CreditsResponse, ImageEditRequest, ImageGenerationRequest, MusicGenerationRequest, ModelInfo, RequestOptions, SpeechRequest, TranscriptionRequest, UsageResponse, VideoGenerationRequest, } from "./types.js";
+export { APIError, AuthenticationError, InsufficientSPUError, InvalidRequestError, RateLimitError, SydearError, } from "./errors.js";
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,SAAS,EACT,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * sydear — official SDK for the Sydear API.
+ * https://docs.sydear.space
+ */
+export { Sydear } from "./client.js";
+export { APIError, AuthenticationError, InsufficientSPUError, InvalidRequestError, RateLimitError, SydearError, } from "./errors.js";
+export const VERSION = "0.1.0";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAoBrC,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/index.mjs

@@ -0,0 +1,8 @@
+/**
+ * sydear — official SDK for the Sydear API.
+ * https://docs.sydear.space
+ */
+export { Sydear } from "./client.js";
+export { APIError, AuthenticationError, InsufficientSPUError, InvalidRequestError, RateLimitError, SydearError, } from "./errors.js";
+export const VERSION = "0.1.0";
+//# sourceMappingURL=index.js.map

package/dist/types.cjs

@@ -0,0 +1,5 @@
+/**
+ * Shared types for the Sydear SDK.
+ */
+{};
+//# sourceMappingURL=types.js.map

package/dist/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Shared types for the Sydear SDK.
+ */
+export interface ChatMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+export interface ChatCompletionRequest {
+    model: string;
+    messages: ChatMessage[];
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    stop?: string[];
+    stream?: boolean;
+    [key: string]: unknown;
+}
+export interface ChatCompletionChoice {
+    index: number;
+    message: ChatMessage;
+    finish_reason: string;
+}
+export interface ChatCompletionResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: ChatCompletionChoice[];
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+export interface ChatCompletionChunk {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        delta: Partial<ChatMessage>;
+        finish_reason: string | null;
+    }>;
+}
+export interface SpeechRequest {
+    model?: string;
+    input: string;
+    voice?: string;
+    response_format?: "mp3" | "wav" | "opus" | "flac";
+}
+export interface TranscriptionRequest {
+    file: Buffer | Uint8Array | string;
+    filename?: string;
+    model?: string;
+    language?: string;
+    response_format?: "json" | "text" | "srt" | "verbose_json";
+}
+export interface ImageGenerationRequest {
+    prompt: string;
+    model?: string;
+    n?: number;
+    size?: "256x256" | "512x512" | "1024x1024" | "1024x1792" | "1792x1024";
+    [key: string]: unknown;
+}
+export interface ImageEditRequest extends ImageGenerationRequest {
+    image: Buffer | Uint8Array | string;
+    mask?: Buffer | Uint8Array | string;
+}
+export interface MusicGenerationRequest {
+    prompt: string;
+    lyrics?: string;
+    model?: string;
+}
+export interface VideoGenerationRequest {
+    prompt: string;
+    model?: string;
+}
+export interface ModelInfo {
+    id: string;
+    object?: string;
+    created?: number;
+    owned_by?: string;
+    capabilities?: string[];
+    context_window?: number;
+}
+export interface CreditsResponse {
+    unit: "SPU";
+    spu_balance: number;
+    spu_limit?: number;
+    credit_balance?: number;
+    credit_limit?: number;
+}
+export interface UsageResponse {
+    requests_today: number;
+    daily_request_limit: number;
+    rpm_limit: number;
+}
+export interface APIErrorBody {
+    error?: {
+        message?: string;
+        type?: string;
+        code?: string | number;
+    };
+}
+export interface RequestOptions {
+    baseURL?: string;
+    timeout?: number;
+    maxRetries?: number;
+    signal?: AbortSignal;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for the Sydear SDK.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types.mjs

@@ -0,0 +1,5 @@
+/**
+ * Shared types for the Sydear SDK.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "sydear",
+  "version": "0.1.0",
+  "description": "Sydear API \u2014 chat, audio, image, music, video. Thin wrapper for Node.js 18+ and TypeScript.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "build.py"
+  ],
+  "scripts": {
+    "build": "tsc && python3 build.py",
+    "test": "node --test examples/",
+    "lint": "tsc --noEmit"
+  },
+  "keywords": [
+    "sydear",
+    "ai",
+    "llm",
+    "chat",
+    "audio",
+    "image",
+    "video",
+    "tts",
+    "stt"
+  ],
+  "author": "Sydear",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/node": "^20.0.0"
+  },
+  "dependencies": {},
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Techfrontiers/sydear-js.git"
+  },
+  "homepage": "https://sydear.space",
+  "bugs": {
+    "url": "https://github.com/Techfrontiers/sydear-js/issues"
+  }
+}