@scalix-world/sdk 0.0.1 → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Scalix World Private Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1 +1,155 @@
-# @scalix-world/sdk
+# Scalix SDK — TypeScript
+
+One SDK, one API key. `scalix.completions` gives you full OpenAI-compatible chat (tools, vision, streaming). The rest of the SDK gives you Research, RAG, DocGen, Audio, Images, Text — services that only Scalix has.
+
+## Installation
+
+```bash
+npm install @scalix-world/sdk openai
+```
+
+## Quick Start
+
+```typescript
+import { Scalix } from '@scalix-world/sdk';
+
+const scalix = new Scalix('sk_scalix_...');
+
+// Chat completions — full OpenAI-compatible (tools, vision, streaming)
+const response = await scalix.completions.create({
+  model: 'scalix-world-ai',
+  messages: [{ role: 'user', content: 'Hello!' }],
+});
+
+// Streaming
+const stream = await scalix.completions.create({
+  model: 'scalix-world-ai',
+  messages: [{ role: 'user', content: 'Tell me a story' }],
+  stream: true,
+});
+for await (const chunk of stream) {
+  process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
+}
+```
+
+## Platform Services
+
+These are Scalix-only services — no other SDK can reach them.
+
+### Research — web search and deep research
+
+```typescript
+const results = await scalix.research.search('quantum computing');
+const report = await scalix.research.deep('AI trends 2026');
+const answer = await scalix.research.research('What is GraphQL?');
+```
+
+### Text — sentiment, summarization, translation, grammar, autocomplete
+
+```typescript
+const sentiment = await scalix.text.sentiment('I love this product!');
+const summary = await scalix.text.summarize(longArticle);
+const translated = await scalix.text.translate('Hello', 'es');
+const grammar = await scalix.text.grammar('Me and him goes to store');
+const completion = await scalix.text.autocomplete('The quick brown');
+```
+
+### Audio — transcription and text-to-speech
+
+```typescript
+const transcript = await scalix.audio.transcribe(audioBlob);
+const audio = await scalix.audio.speak('Hello world', { voice: 'af_heart' });
+const voices = await scalix.audio.voices();
+const languages = await scalix.audio.languages();
+```
+
+### Images — generation with sync and async modes
+
+```typescript
+const image = await scalix.images.generate('A sunset over mountains');
+const job = await scalix.images.generateAsync('A detailed cityscape');
+const status = await scalix.images.getJob(job.job_id);
+const models = await scalix.images.models();
+```
+
+### Document Generation — PDF, DOCX, CSV, XLSX
+
+```typescript
+const doc = await scalix.docgen.create({ prompt: 'Q1 report', format: 'pdf' });
+const history = await scalix.docgen.history();
+const formats = await scalix.docgen.formats();
+const templates = await scalix.docgen.templates();
+await scalix.docgen.share(doc.doc_id, 'colleague@company.com');
+```
+
+### RAG — upload and query documents
+
+```typescript
+const doc = await scalix.rag.upload(pdfBlob, { filename: 'report.pdf' });
+const answer = await scalix.rag.query('revenue growth');
+const docs = await scalix.rag.documents();
+await scalix.rag.deleteDocument(docId);
+```
+
+### Storage — presigned upload URLs
+
+```typescript
+const { uploadUrl } = await scalix.storage.getUploadUrl('application/pdf');
+```
+
+### Account — health, info, budget, usage
+
+```typescript
+const health = await scalix.account.health();
+const info = await scalix.account.info();     // email, plan
+const budget = await scalix.account.budget(); // credits remaining
+const usage = await scalix.account.usage();   // usage stats
+```
+
+### Models — list available models
+
+```typescript
+const models = await scalix.models.list();
+// Each model includes: id, context_window, max_output_tokens, plan_required
+```
+
+## Configuration
+
+```typescript
+const scalix = new Scalix('sk_scalix_...', {
+  baseURL: 'https://api.scalix.world', // default
+  maxRetries: 2,                        // auto-retry with exponential backoff
+  timeout: 60000,                       // request timeout in ms
+});
+```
+
+## Available Models
+
+| Model | Description | Best For |
+|-------|-------------|----------|
+| `scalix-world-ai` | Default model — fast, balanced | General use, chat, quick tasks |
+| `scalix-world-advanced` | Most capable — deep reasoning | Complex analysis, coding, agents |
+
+Plus 12 more models — run `scalix.models.list()` to see all available for your plan.
+
+## Error Handling
+
+```typescript
+import { Scalix, ScalixError, AuthenticationError, RateLimitError } from '@scalix-world/sdk';
+
+try {
+  await scalix.research.search('...');
+} catch (error) {
+  if (error instanceof AuthenticationError) {
+    console.error('Invalid API key');
+  } else if (error instanceof RateLimitError) {
+    console.error('Rate limited — SDK retries automatically');
+  } else if (error instanceof ScalixError) {
+    console.error('API error:', error.message);
+  }
+}
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE) for details.

package/dist/client.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Scalix — unified client for the Scalix platform.
+ *
+ * Chat completions delegate to the OpenAI SDK (Scalix's API is OpenAI-compatible).
+ * Platform services (research, RAG, database, etc.) use a native HTTP client.
+ *
+ * @example
+ * ```typescript
+ * import { Scalix } from '@scalix-world/sdk';
+ *
+ * const scalix = new Scalix('sk_scalix_...');
+ *
+ * // Chat — full OpenAI-compatible (tools, vision, streaming)
+ * const response = await scalix.completions.create({
+ *   model: 'scalix-world-ai',
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ * });
+ *
+ * // Platform services
+ * const results = await scalix.research.search('AI trends');
+ * ```
+ */
+import OpenAI from 'openai';
+import { AccountService } from './services/account.js';
+import { AudioService } from './services/audio.js';
+import { DocGenService } from './services/docgen.js';
+import { ImagesService } from './services/images.js';
+import { ModelsService } from './services/models.js';
+import { RAGService } from './services/rag.js';
+import { ResearchService } from './services/research.js';
+import { StorageService } from './services/storage.js';
+import { TextService } from './services/text.js';
+export interface ScalixOptions {
+    baseURL?: string;
+    maxRetries?: number;
+    timeout?: number;
+}
+export declare class Scalix {
+    /** OpenAI-compatible chat completions — full tool calling, vision, streaming */
+    readonly completions: OpenAI['chat']['completions'];
+    /** Pre-configured OpenAI client for advanced usage (embeddings, raw access, etc.) */
+    readonly openai: OpenAI;
+    readonly account: AccountService;
+    readonly audio: AudioService;
+    readonly docgen: DocGenService;
+    readonly images: ImagesService;
+    readonly models: ModelsService;
+    readonly rag: RAGService;
+    readonly research: ResearchService;
+    readonly storage: StorageService;
+    readonly text: TextService;
+    constructor(apiKey: string, options?: ScalixOptions);
+}
+/** @deprecated Use `Scalix` instead */
+export declare const ScalixClient: typeof Scalix;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,MAAM;IACjB,gFAAgF;IAChF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;IAEpD,qFAAqF;IACrF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;gBAEf,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;CAwBpD;AAED,uCAAuC;AACvC,eAAO,MAAM,YAAY,eAAS,CAAC"}

package/dist/client.js

@@ -0,0 +1,71 @@
+/**
+ * Scalix — unified client for the Scalix platform.
+ *
+ * Chat completions delegate to the OpenAI SDK (Scalix's API is OpenAI-compatible).
+ * Platform services (research, RAG, database, etc.) use a native HTTP client.
+ *
+ * @example
+ * ```typescript
+ * import { Scalix } from '@scalix-world/sdk';
+ *
+ * const scalix = new Scalix('sk_scalix_...');
+ *
+ * // Chat — full OpenAI-compatible (tools, vision, streaming)
+ * const response = await scalix.completions.create({
+ *   model: 'scalix-world-ai',
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ * });
+ *
+ * // Platform services
+ * const results = await scalix.research.search('AI trends');
+ * ```
+ */
+import OpenAI from 'openai';
+import { AccountService } from './services/account.js';
+import { AudioService } from './services/audio.js';
+import { DocGenService } from './services/docgen.js';
+import { ImagesService } from './services/images.js';
+import { ModelsService } from './services/models.js';
+import { RAGService } from './services/rag.js';
+import { ResearchService } from './services/research.js';
+import { StorageService } from './services/storage.js';
+import { TextService } from './services/text.js';
+export class Scalix {
+    /** OpenAI-compatible chat completions — full tool calling, vision, streaming */
+    completions;
+    /** Pre-configured OpenAI client for advanced usage (embeddings, raw access, etc.) */
+    openai;
+    account;
+    audio;
+    docgen;
+    images;
+    models;
+    rag;
+    research;
+    storage;
+    text;
+    constructor(apiKey, options) {
+        const base = options?.baseURL ?? 'https://api.scalix.world';
+        const baseURL = base.endsWith('/v1') ? base : `${base}/v1`;
+        const baseUrl = baseURL.replace(/\/v1$/, '');
+        const config = { apiKey, baseUrl, maxRetries: options?.maxRetries, timeout: options?.timeout };
+        this.openai = new OpenAI({
+            baseURL,
+            apiKey,
+            defaultHeaders: { 'User-Agent': 'Scalix-SDK/2.0' },
+        });
+        this.completions = this.openai.chat.completions;
+        this.account = new AccountService(config);
+        this.audio = new AudioService(config);
+        this.docgen = new DocGenService(config);
+        this.images = new ImagesService(config);
+        this.models = new ModelsService(config);
+        this.rag = new RAGService(config);
+        this.research = new ResearchService(config);
+        this.storage = new StorageService(config);
+        this.text = new TextService(config);
+    }
+}
+/** @deprecated Use `Scalix` instead */
+export const ScalixClient = Scalix;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQjD,MAAM,OAAO,MAAM;IACjB,gFAAgF;IACvE,WAAW,CAAgC;IAEpD,qFAAqF;IAC5E,MAAM,CAAS;IAEf,OAAO,CAAiB;IACxB,KAAK,CAAe;IACpB,MAAM,CAAgB;IACtB,MAAM,CAAgB;IACtB,MAAM,CAAgB;IACtB,GAAG,CAAa;IAChB,QAAQ,CAAkB;IAC1B,OAAO,CAAiB;IACxB,IAAI,CAAc;IAE3B,YAAY,MAAc,EAAE,OAAuB;QACjD,MAAM,IAAI,GAAG,OAAO,EAAE,OAAO,IAAI,0BAA0B,CAAC;QAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC;QAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAE7C,MAAM,MAAM,GAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAE7G,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC;YACvB,OAAO;YACP,MAAM;YACN,cAAc,EAAE,EAAE,YAAY,EAAE,gBAAgB,EAAE;SACnD,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;QAEhD,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;CACF;AAED,uCAAuC;AACvC,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+export interface ScalixConfig {
+    apiKey: string;
+    baseUrl: string;
+    maxRetries?: number;
+    timeout?: number;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,35 @@
+export declare class ScalixError extends Error {
+    code?: string;
+    status?: number;
+    requestId?: string;
+    constructor(message: string, options?: {
+        code?: string;
+        status?: number;
+        requestId?: string;
+    });
+}
+export declare class AuthenticationError extends ScalixError {
+    constructor(message: string, requestId?: string);
+}
+export declare class BadRequestError extends ScalixError {
+    constructor(message: string, requestId?: string);
+}
+export declare class PermissionDeniedError extends ScalixError {
+    constructor(message: string, requestId?: string);
+}
+export declare class NotFoundError extends ScalixError {
+    constructor(message: string, requestId?: string);
+}
+export declare class ConflictError extends ScalixError {
+    constructor(message: string, requestId?: string);
+}
+export declare class UnprocessableEntityError extends ScalixError {
+    constructor(message: string, requestId?: string);
+}
+export declare class RateLimitError extends ScalixError {
+    constructor(message: string, requestId?: string);
+}
+export declare class InternalServerError extends ScalixError {
+    constructor(message: string, requestId?: 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,qBAAa,WAAY,SAAQ,KAAK;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEP,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;CAO9F;AAED,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAED,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAED,qBAAa,qBAAsB,SAAQ,WAAW;gBACxC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAED,qBAAa,aAAc,SAAQ,WAAW;gBAChC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAED,qBAAa,aAAc,SAAQ,WAAW;gBAChC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAED,qBAAa,wBAAyB,SAAQ,WAAW;gBAC3C,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAED,qBAAa,cAAe,SAAQ,WAAW;gBACjC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAED,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD"}

package/dist/errors.js

@@ -0,0 +1,61 @@
+export class ScalixError extends Error {
+    code;
+    status;
+    requestId;
+    constructor(message, options) {
+        super(message);
+        this.name = 'ScalixError';
+        this.code = options?.code;
+        this.status = options?.status;
+        this.requestId = options?.requestId;
+    }
+}
+export class AuthenticationError extends ScalixError {
+    constructor(message, requestId) {
+        super(message, { code: 'AUTHENTICATION_ERROR', status: 401, requestId });
+        this.name = 'AuthenticationError';
+    }
+}
+export class BadRequestError extends ScalixError {
+    constructor(message, requestId) {
+        super(message, { code: 'BAD_REQUEST', status: 400, requestId });
+        this.name = 'BadRequestError';
+    }
+}
+export class PermissionDeniedError extends ScalixError {
+    constructor(message, requestId) {
+        super(message, { code: 'PERMISSION_DENIED', status: 403, requestId });
+        this.name = 'PermissionDeniedError';
+    }
+}
+export class NotFoundError extends ScalixError {
+    constructor(message, requestId) {
+        super(message, { code: 'NOT_FOUND', status: 404, requestId });
+        this.name = 'NotFoundError';
+    }
+}
+export class ConflictError extends ScalixError {
+    constructor(message, requestId) {
+        super(message, { code: 'CONFLICT', status: 409, requestId });
+        this.name = 'ConflictError';
+    }
+}
+export class UnprocessableEntityError extends ScalixError {
+    constructor(message, requestId) {
+        super(message, { code: 'UNPROCESSABLE_ENTITY', status: 422, requestId });
+        this.name = 'UnprocessableEntityError';
+    }
+}
+export class RateLimitError extends ScalixError {
+    constructor(message, requestId) {
+        super(message, { code: 'RATE_LIMIT_ERROR', status: 429, requestId });
+        this.name = 'RateLimitError';
+    }
+}
+export class InternalServerError extends ScalixError {
+    constructor(message, requestId) {
+        super(message, { code: 'INTERNAL_SERVER_ERROR', status: 500, requestId });
+        this.name = 'InternalServerError';
+    }
+}
+//# 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,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,IAAI,CAAU;IACd,MAAM,CAAU;IAChB,SAAS,CAAU;IAEnB,YAAY,OAAe,EAAE,OAAgE;QAC3F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,OAAe,EAAE,SAAkB;QAC7C,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,YAAY,OAAe,EAAE,SAAkB;QAC7C,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IACpD,YAAY,OAAe,EAAE,SAAkB;QAC7C,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C,YAAY,OAAe,EAAE,SAAkB;QAC7C,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C,YAAY,OAAe,EAAE,SAAkB;QAC7C,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,WAAW;IACvD,YAAY,OAAe,EAAE,SAAkB;QAC7C,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,WAAW;IAC7C,YAAY,OAAe,EAAE,SAAkB;QAC7C,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,OAAe,EAAE,SAAkB;QAC7C,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Scalix SDK — unified client for the Scalix platform.
+ *
+ * Chat completions delegate to the OpenAI SDK (Scalix's API is OpenAI-compatible).
+ * Platform services (research, RAG, database, etc.) use a native HTTP client.
+ *
+ * @example
+ * ```typescript
+ * import { Scalix } from '@scalix-world/sdk';
+ *
+ * const scalix = new Scalix('sk_scalix_...');
+ *
+ * // Chat — full OpenAI-compatible (tools, vision, streaming)
+ * const response = await scalix.completions.create({
+ *   model: 'scalix-world-ai',
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ * });
+ *
+ * // Platform services
+ * const results = await scalix.research.search('AI trends');
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { Scalix, ScalixClient } from './client.js';
+export type { ScalixOptions } from './client.js';
+export type { ScalixConfig } from './config.js';
+export { ScalixError, AuthenticationError, BadRequestError, PermissionDeniedError, NotFoundError, ConflictError, UnprocessableEntityError, RateLimitError, InternalServerError, } from './errors.js';
+export { AccountService, AudioService, DocGenService, ImagesService, ModelsService, RAGService, ResearchService, StorageService, TextService, } from './services/index.js';
+export type { UserInfo, UserBudget, UserUsage, ScalixModel, DocFormat, DocStyle, DocGenOptions, DocGenResult, DocTemplate, DocFormatInfo, ImageGenerateOptions, ImageResult, ImageJobStatus, RAGDocument, RAGQueryResult, RAGUploadResult, SentimentResult, SummaryResult, TranslationResult, GrammarResult, AutocompleteResult, VectorSearchResult, UploadUrlResult, TranscriptionResult, SpeechOptions, SearchResult, ResearchResult, } from './services/index.js';
+//# 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;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,wBAAwB,EACxB,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,eAAe,EACf,cAAc,EACd,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,cAAc,GACf,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+/**
+ * Scalix SDK — unified client for the Scalix platform.
+ *
+ * Chat completions delegate to the OpenAI SDK (Scalix's API is OpenAI-compatible).
+ * Platform services (research, RAG, database, etc.) use a native HTTP client.
+ *
+ * @example
+ * ```typescript
+ * import { Scalix } from '@scalix-world/sdk';
+ *
+ * const scalix = new Scalix('sk_scalix_...');
+ *
+ * // Chat — full OpenAI-compatible (tools, vision, streaming)
+ * const response = await scalix.completions.create({
+ *   model: 'scalix-world-ai',
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ * });
+ *
+ * // Platform services
+ * const results = await scalix.research.search('AI trends');
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { Scalix, ScalixClient } from './client.js';
+export { ScalixError, AuthenticationError, BadRequestError, PermissionDeniedError, NotFoundError, ConflictError, UnprocessableEntityError, RateLimitError, InternalServerError, } from './errors.js';
+export { AccountService, AudioService, DocGenService, ImagesService, ModelsService, RAGService, ResearchService, StorageService, TextService, } from './services/index.js';
+//# 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;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,wBAAwB,EACxB,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,eAAe,EACf,cAAc,EACd,WAAW,GACZ,MAAM,qBAAqB,CAAC"}

package/dist/services/account.d.ts

@@ -0,0 +1,27 @@
+import { BaseService } from './base.js';
+export interface UserInfo {
+    id: string;
+    email: string;
+    name?: string;
+    plan: string;
+    createdAt?: string;
+}
+export interface UserBudget {
+    creditsUsed: number;
+    creditsLimit: number;
+    creditsRemaining: number;
+    resetDate?: string;
+}
+export interface UserUsage {
+    month: string;
+    totalRequests: number;
+    totalTokens: number;
+    breakdown: Record<string, unknown>;
+}
+export declare class AccountService extends BaseService {
+    health(): Promise<Record<string, unknown>>;
+    info(): Promise<UserInfo>;
+    budget(): Promise<UserBudget>;
+    usage(): Promise<UserUsage>;
+}
+//# sourceMappingURL=account.d.ts.map

package/dist/services/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/services/account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,qBAAa,cAAe,SAAQ,WAAW;IAEvC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI1C,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC;IAIzB,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC;IAI7B,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC;CAGlC"}

package/dist/services/account.js

@@ -0,0 +1,16 @@
+import { BaseService } from './base.js';
+export class AccountService extends BaseService {
+    async health() {
+        return this.request('GET', '/health');
+    }
+    async info() {
+        return this.request('GET', '/v1/user/info');
+    }
+    async budget() {
+        return this.request('GET', '/v1/user/budget');
+    }
+    async usage() {
+        return this.request('GET', '/v1/user/stats');
+    }
+}
+//# sourceMappingURL=account.js.map

package/dist/services/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../src/services/account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAwBxC,MAAM,OAAO,cAAe,SAAQ,WAAW;IAE7C,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,OAAO,CAAW,KAAK,EAAE,eAAe,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,OAAO,CAAa,KAAK,EAAE,iBAAiB,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,OAAO,CAAY,KAAK,EAAE,gBAAgB,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/services/audio.d.ts

@@ -0,0 +1,27 @@
+import { BaseService } from './base.js';
+export interface TranscriptionResult {
+    text: string;
+    language?: string;
+    duration?: number;
+}
+export interface SpeechOptions {
+    voice?: string;
+    format?: string;
+    speed?: number;
+}
+export declare class AudioService extends BaseService {
+    transcribe(file: Blob, options?: {
+        language?: string;
+    }): Promise<TranscriptionResult>;
+    speak(text: string, options?: SpeechOptions): Promise<Response>;
+    voices(): Promise<{
+        voices: Array<{
+            id: string;
+            name: string;
+        }>;
+    }>;
+    languages(): Promise<{
+        languages: string[];
+    }>;
+}
+//# sourceMappingURL=audio.d.ts.map

package/dist/services/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/services/audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,YAAa,SAAQ,WAAW;IACrC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAOrF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ/D,MAAM,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAIlE,SAAS,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAGpD"}

package/dist/services/audio.js

@@ -0,0 +1,27 @@
+import { BaseService } from './base.js';
+export class AudioService extends BaseService {
+    async transcribe(file, options) {
+        const formData = new FormData();
+        formData.append('file', file);
+        if (options?.language)
+            formData.append('language', options.language);
+        return this.requestMultipart('/v1/audio/transcribe', formData);
+    }
+    async speak(text, options) {
+        const params = new URLSearchParams({ text });
+        if (options?.voice)
+            params.set('voice', options.voice);
+        if (options?.format)
+            params.set('format', options.format);
+        if (options?.speed != null)
+            params.set('speed', String(options.speed));
+        return this.requestRaw('POST', `/v1/audio/speak/kokoro?${params}`);
+    }
+    async voices() {
+        return this.request('GET', '/v1/audio/kokoro/voices');
+    }
+    async languages() {
+        return this.request('GET', '/v1/audio/kokoro/languages');
+    }
+}
+//# sourceMappingURL=audio.js.map

package/dist/services/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../../src/services/audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAcxC,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C,KAAK,CAAC,UAAU,CAAC,IAAU,EAAE,OAA+B;QAC1D,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC9B,IAAI,OAAO,EAAE,QAAQ;YAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,gBAAgB,CAAsB,sBAAsB,EAAE,QAAQ,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,OAAuB;QAC/C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,IAAI,OAAO,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,OAAO,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,OAAO,EAAE,KAAK,IAAI,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,0BAA0B,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/services/base.d.ts

@@ -0,0 +1,17 @@
+import type { ScalixConfig } from '../config.js';
+export declare class BaseService {
+    protected config: ScalixConfig;
+    constructor(config: ScalixConfig);
+    private get maxRetries();
+    private get timeout();
+    protected request<T>(method: string, path: string, options?: {
+        body?: unknown;
+        headers?: Record<string, string>;
+    }): Promise<T>;
+    protected requestRaw(method: string, path: string, options?: {
+        body?: unknown;
+        headers?: Record<string, string>;
+    }): Promise<Response>;
+    protected requestMultipart<T>(path: string, formData: FormData): Promise<T>;
+}
+//# sourceMappingURL=base.d.ts.map