@aerostack/sdk-node 0.8.8 → 0.8.9

package/src/sdk.ts

@@ -1,317 +0,0 @@
-import * as gen from './_generated/index.js';
-import { NodeRealtimeClient } from './realtime.js';
-import { AerostackClient } from '@aerostack/core';
-
-export interface SDKOptions {
-    /** 
-     * Aerostack API Key. 
-     * Use a Secret Key for server-side environments.
-     */
-    apiKey?: string;
-    /** Alias for apiKey for backward compatibility */
-    apiKeyAuth?: string;
-    serverUrl?: string;
-    /** Alias for serverUrl for backward compatibility */
-    serverURL?: string;
-    maxReconnectAttempts?: number;
-    projectId?: string;
-}
-
-/**
- * Ergonomic wrapper for Cache API — exposes clean method names
- * (get/set/delete) instead of the verbose OpenAPI names (cacheGet/cacheSet).
- * Covers all 11 cache operations supported by the Aerostack RPC API.
- */
-class CacheFacade {
-    constructor(private api: gen.CacheApi) { }
-
-    /** Get a cached value by key. Returns null if not found. */
-    async get<T = any>(key: string): Promise<T | null> {
-        const res = await this.api.cacheGet({ cacheGetRequest: { key } });
-        // _exists is the TS property name for the JSON `exists` field (codegen convention).
-        // Fall back to value presence in case the API omits the exists field on a hit.
-        const hit = res._exists ?? (res.value !== null && res.value !== undefined);
-        return hit ? (res.value as T) : null;
-    }
-
-    /** Set a cached value. Optional ttl in seconds. */
-    async set(key: string, value: any, ttl?: number): Promise<void> {
-        await this.api.cacheSet({ cacheSetRequest: { key, value, ...(ttl !== undefined && { ttl }) } });
-    }
-
-    /** Delete a cached key. */
-    async delete(key: string): Promise<void> {
-        await this.api.cacheDelete({ cacheGetRequest: { key } });
-    }
-
-    /** Check if a key exists without fetching its value. */
-    async exists(key: string): Promise<boolean> {
-        const res = await this.api.cacheGet({ cacheGetRequest: { key } });
-        // Explicit false wins. If _exists is undefined, fall back to value presence.
-        if (res._exists === false) return false;
-        if (res._exists === true) return true;
-        return res.value !== null && res.value !== undefined;
-    }
-
-    /** List cache keys with optional prefix (paginated). */
-    async list(prefix?: string, limit?: number, cursor?: string) {
-        return this.api.cacheList({ cacheListRequest: { prefix, limit, cursor } });
-    }
-
-    /** Get all keys matching prefix (auto-paginates, hard cap 10k). */
-    async keys(prefix?: string): Promise<string[]> {
-        const res = await this.api.cacheKeys({ cacheKeysRequest: { prefix } });
-        return res.keys ?? [];
-    }
-
-    /** Fetch up to 100 keys in a single call. */
-    async getMany(keys: string[]) {
-        const res = await this.api.cacheGetMany({ cacheGetManyRequest: { keys } });
-        return res.results ?? [];
-    }
-
-    /** Store up to 100 key-value pairs in a single call. */
-    async setMany(entries: Array<{ key: string; value: any; ttl?: number }>) {
-        return this.api.cacheSetMany({ cacheSetManyRequest: { entries } });
-    }
-
-    /** Delete up to 500 keys in a single call. */
-    async deleteMany(keys: string[]) {
-        return this.api.cacheDeleteMany({ cacheDeleteManyRequest: { keys } });
-    }
-
-    /** Delete all keys matching prefix (or all project keys). Hard cap 10k. */
-    async flush(prefix?: string) {
-        return this.api.cacheFlush({ cacheFlushRequest: { prefix } });
-    }
-
-    /** Update TTL of an existing key (get-then-put, not atomic). */
-    async expire(key: string, ttl: number) {
-        return this.api.cacheExpire({ cacheExpireRequest: { key, ttl } });
-    }
-
-    /** Increment a numeric counter. Initializes to initialValue (default 0) if key doesn't exist. */
-    async increment(key: string, amount?: number, initialValue?: number, ttl?: number): Promise<number | undefined> {
-        const res = await this.api.cacheIncrement({ cacheIncrementRequest: { key, amount, initialValue, ttl } });
-        return res.value;
-    }
-}
-
-/**
- * Compatibility wrapper for Database API.
- *
- * IMPORTANT: DDL statements (CREATE TABLE, ALTER TABLE, DROP TABLE, etc.)
- * are NOT supported via the SDK — the RPC API blocks all DDL for security.
- * Use Wrangler migrations for schema changes:
- *   wrangler d1 migrations apply <db-name> [--local]
- */
-class DatabaseFacade {
-    constructor(private api: gen.DatabaseApi) { }
-
-    /**
-     * Run a SQL query against your project database
-     */
-    async dbQuery(params: {
-        dbQueryRequest?: gen.DbQueryRequest,
-        requestBody?: gen.DbQueryRequest,
-        xSDKVersion?: string,
-        xRequestID?: string
-    }) {
-        return this.api.dbQuery({
-            dbQueryRequest: params.dbQueryRequest || params.requestBody!,
-            xSDKVersion: params.xSDKVersion,
-            xRequestID: params.xRequestID
-        });
-    }
-}
-
-/**
- * Aerostack SDK Facade for Node.js.
- * Provides a clean, ergonomic API for all Aerostack services.
- *
- * `sdk.cache` exposes all 11 cache operations with clean names (get/set/delete/etc).
- * `sdk.rpc` exposes the full enterprise client for db.batch, queue.getJob, ai.search.update, etc.
- */
-export class SDK {
-    public readonly database: DatabaseFacade;
-    public readonly auth: gen.AuthenticationApi;
-    public readonly cache: CacheFacade;
-    public readonly queue: gen.QueueApi;
-    public readonly storage: gen.StorageApi;
-    public readonly ai: gen.AIApi;
-    public readonly services: gen.ServicesApi;
-    public readonly gateway: gen.GatewayApi;
-    public readonly realtime: NodeRealtimeClient;
-    /**
-     * Full enterprise RPC client — exposes all new methods:
-     * cache.list/keys/getMany/setMany/deleteMany/flush/expire/increment
-     * storage.get/getUrl/list/delete/exists/getMetadata/copy/move
-     * db.batch, queue.getJob/listJobs/cancelJob
-     * ai.search.update/get/count
-     */
-    public readonly rpc: AerostackClient;
-
-    private config: gen.Configuration;
-
-    constructor(options: SDKOptions = {}) {
-        const serverUrl = options.serverUrl || options.serverURL || 'https://api.aerostack.dev/v1';
-        const apiKey = options.apiKey || options.apiKeyAuth;
-
-        this.config = new gen.Configuration({
-            basePath: serverUrl,
-            headers: apiKey ? { 'X-Aerostack-Key': apiKey } : {},
-            apiKey: apiKey,
-        });
-
-        this.database = new DatabaseFacade(new gen.DatabaseApi(this.config));
-        this.auth = new gen.AuthenticationApi(this.config);
-        this.cache = new CacheFacade(new gen.CacheApi(this.config));
-        this.queue = new gen.QueueApi(this.config);
-        this.storage = new gen.StorageApi(this.config);
-        this.ai = new gen.AIApi(this.config);
-        this.services = new gen.ServicesApi(this.config);
-        this.gateway = new gen.GatewayApi(this.config);
-
-        // Enterprise client — full API surface
-        this.rpc = new AerostackClient({
-            baseUrl: serverUrl,
-            apiKey,
-            projectId: options.projectId,
-        });
-
-        this.realtime = new NodeRealtimeClient({
-            serverUrl,
-            apiKey: apiKey,
-            projectId: options.projectId,
-            maxReconnectAttempts: options.maxReconnectAttempts
-        });
-    }
-
-    /**
-     * Stream a gateway chat completion with token-by-token callbacks.
-     *
-     * @example
-     * await sdk.streamGateway({
-     *   apiSlug: 'my-chatbot',
-     *   messages: [{ role: 'user', content: 'Hello' }],
-     *   consumerKey: 'ask_live_...',
-     *   onToken: (delta) => process.stdout.write(delta),
-     * });
-     */
-    async streamGateway(opts: {
-        apiSlug: string;
-        messages: Array<{ role: 'user' | 'assistant' | 'system'; content: string }>;
-        consumerKey?: string;
-        token?: string;
-        systemPrompt?: string;
-        onToken?: (delta: string) => void;
-        onDone?: (usage: { tokensUsed: number }) => void;
-        onError?: (error: Error) => void;
-        signal?: AbortSignal;
-    }): Promise<{ text: string; tokensUsed: number }> {
-        const baseUrl = this.config.basePath.replace(/\/v1\/?$/, '');
-        const endpoint = `${baseUrl}/api/gateway/${opts.apiSlug}/v1/chat/completions`;
-
-        const headers: Record<string, string> = { 'Content-Type': 'application/json' };
-        if (opts.consumerKey) {
-            headers['Authorization'] = `Bearer ${opts.consumerKey}`;
-        } else if (opts.token) {
-            headers['Authorization'] = `Bearer ${opts.token}`;
-        }
-
-        const messages = opts.systemPrompt
-            ? [{ role: 'system' as const, content: opts.systemPrompt }, ...opts.messages]
-            : opts.messages;
-
-        let text = '';
-        let totalTokens = 0;
-        let estimatedTokens = 0;
-
-        try {
-            const response = await fetch(endpoint, {
-                method: 'POST',
-                headers,
-                body: JSON.stringify({ messages, stream: true, stream_options: { include_usage: true } }),
-                signal: opts.signal,
-            });
-
-            if (!response.ok) {
-                const err = await response.json().catch(() => ({ error: 'Request failed' }));
-                throw new Error((err as any).error || `HTTP ${response.status}`);
-            }
-            if (!response.body) throw new Error('No response body');
-
-            const reader = response.body.getReader();
-            const decoder = new TextDecoder();
-            let buffer = '';
-
-            while (true) {
-                const { done, value } = await reader.read();
-                if (done) break;
-                buffer += decoder.decode(value, { stream: true });
-                const lines = buffer.split('\n');
-                buffer = lines.pop() || '';
-
-                for (const line of lines) {
-                    if (!line.startsWith('data: ')) continue;
-                    const payload = line.slice(6).trim();
-                    if (payload === '[DONE]') {
-                        reader.cancel();
-                        const result = { text, tokensUsed: totalTokens || estimatedTokens };
-                        opts.onDone?.(result);
-                        return result;
-                    }
-                    try {
-                        const parsed = JSON.parse(payload);
-                        const delta = parsed.choices?.[0]?.delta?.content;
-                        if (delta) {
-                            text += delta;
-                            opts.onToken?.(delta);
-                            estimatedTokens += Math.ceil(delta.length / 4);
-                        }
-                        if (parsed.usage?.total_tokens) totalTokens = parsed.usage.total_tokens;
-                        else if (parsed.usage?.completion_tokens) totalTokens = parsed.usage.completion_tokens;
-                    } catch { /* skip malformed frames */ }
-                }
-            }
-
-            const result = { text, tokensUsed: totalTokens || estimatedTokens };
-            opts.onDone?.(result);
-            return result;
-        } catch (err: any) {
-            if (err.name === 'AbortError') return { text, tokensUsed: totalTokens || estimatedTokens };
-            const error = err instanceof Error ? err : new Error(String(err));
-            opts.onError?.(error);
-            throw error;
-        }
-    }
-
-    /**
-     * Update the API key for subsequent requests.
-     */
-    setApiKey(apiKey: string): void {
-        this.config = new gen.Configuration({
-            ...this.config,
-            headers: { ...this.config.headers, 'X-Aerostack-Key': apiKey },
-            apiKey,
-        });
-        (this as any).database = new DatabaseFacade(new gen.DatabaseApi(this.config));
-        (this as any).auth = new gen.AuthenticationApi(this.config);
-        (this as any).cache = new CacheFacade(new gen.CacheApi(this.config));
-        (this as any).queue = new gen.QueueApi(this.config);
-        (this as any).storage = new gen.StorageApi(this.config);
-        (this as any).ai = new gen.AIApi(this.config);
-        (this as any).services = new gen.ServicesApi(this.config);
-        (this as any).gateway = new gen.GatewayApi(this.config);
-        (this as any).rpc = new AerostackClient({
-            baseUrl: this.config.basePath,
-            apiKey,
-        });
-    }
-}
-
-/** @deprecated Use SDK instead */
-export const Aerostack = SDK;
-
-// Export a default instance factory or just the class
-export const createClient = (options: SDKOptions) => new SDK(options);

package/test_sdk.ts

@@ -1,19 +0,0 @@
-import { SDK } from "./src/sdk/sdk";
-
-async function main() {
-    const sdk = new SDK({
-        bearerAuth: "test-token"
-    });
-
-    console.log("SDK.ai methods:", Object.keys(Object.getPrototypeOf(sdk.ai)));
-    console.log("SDK.ai.search methods:", Object.keys(Object.getPrototypeOf(sdk.ai.search)));
-
-    // Check if ingest exists
-    if (typeof sdk.ai.search.ingest === 'function') {
-        console.log("✅ search.ingest found");
-    } else {
-        console.log("❌ search.ingest NOT found");
-    }
-}
-
-main().catch(console.error);

package/tsconfig.json

@@ -1,43 +0,0 @@
-{
-  "compilerOptions": {
-    "incremental": false,
-    "target": "ES2020",
-    "lib": [
-      "ES2022",
-      "DOM",
-      "DOM.Iterable"
-    ],
-    "jsx": "react-jsx",
-    "module": "Node16",
-    "moduleResolution": "Node16",
-    "allowJs": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "outDir": ".",
-    // https://github.com/tsconfig/bases/blob/a1bf7c0fa2e094b068ca3e1448ca2ece4157977e/bases/strictest.json
-    "strict": true,
-    "allowUnusedLabels": false,
-    "allowUnreachableCode": false,
-    "exactOptionalPropertyTypes": false,
-    "useUnknownInCatchVariables": true,
-    "noFallthroughCasesInSwitch": true,
-    "noImplicitOverride": false,
-    "noImplicitReturns": true,
-    "noPropertyAccessFromIndexSignature": true,
-    "noUncheckedIndexedAccess": true,
-    "noUnusedLocals": false,
-    "noUnusedParameters": false,
-    "isolatedModules": true,
-    "checkJs": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": [
-    "src"
-  ],
-  "exclude": [
-    "node_modules"
-  ]
-}