@aerostack/sdk-node 0.6.14 → 0.7.2

package/src/sdk/realtime.ts

@@ -1,320 +0,0 @@
-/**
- * Aerostack Realtime Client for Node.js SDK
- * Production-hardened WebSocket client for server-side usage.
- */
-
-export type RealtimeEvent = 'INSERT' | 'UPDATE' | 'DELETE' | '*';
-
-export interface RealtimeMessage {
-    type: string;
-    topic: string;
-    [key: string]: any;
-}
-
-export interface RealtimeSubscriptionOptions {
-    event?: RealtimeEvent;
-    filter?: Record<string, any>;
-}
-
-export type RealtimeCallback<T = any> = (payload: RealtimePayload<T>) => void;
-
-export interface RealtimePayload<T = any> {
-    type: 'db_change' | 'chat_message';
-    topic: string;
-    operation: RealtimeEvent;
-    data: T;
-    old?: T;
-    timestamp?: string;
-    [key: string]: any;
-}
-
-export interface NodeRealtimeOptions {
-    serverUrl: string;
-    projectId: string;
-    apiKey?: string | undefined;
-    userId?: string | undefined;
-    token?: string | undefined;
-    maxReconnectAttempts?: number;
-}
-
-const BASE_RECONNECT_MS = 1000;
-const MAX_RECONNECT_MS = 30000;
-const JITTER_FACTOR = 0.3;
-
-export class RealtimeSubscription<T = any> {
-    private client: NodeRealtimeClient;
-    private topic: string;
-    private options: RealtimeSubscriptionOptions;
-    private callbacks: Map<RealtimeEvent, Set<RealtimeCallback<T>>> = new Map();
-    private _isSubscribed: boolean = false;
-
-    constructor(client: NodeRealtimeClient, topic: string, options: RealtimeSubscriptionOptions = {}) {
-        this.client = client;
-        this.topic = topic;
-        this.options = options;
-    }
-
-    on(event: RealtimeEvent, callback: RealtimeCallback<T>): this {
-        if (!this.callbacks.has(event)) {
-            this.callbacks.set(event, new Set());
-        }
-        this.callbacks.get(event)!.add(callback);
-        return this;
-    }
-
-    subscribe(): this {
-        if (this._isSubscribed) return this;
-        this.client._send({
-            type: 'subscribe',
-            topic: this.topic,
-            filter: this.options.filter
-        });
-        this._isSubscribed = true;
-        return this;
-    }
-
-    unsubscribe(): void {
-        if (!this._isSubscribed) return;
-        this.client._send({
-            type: 'unsubscribe',
-            topic: this.topic
-        });
-        this._isSubscribed = false;
-        this.callbacks.clear();
-    }
-
-    get isSubscribed() { return this._isSubscribed; }
-
-    /** @internal */
-    _emit(payload: RealtimePayload<T>): void {
-        const event = payload.operation as RealtimeEvent;
-        this.callbacks.get(event)?.forEach(cb => {
-            try { cb(payload); } catch (e) { console.error('Realtime callback error:', e); }
-        });
-        this.callbacks.get('*')?.forEach(cb => {
-            try { cb(payload); } catch (e) { console.error('Realtime callback error:', e); }
-        });
-    }
-}
-
-export type RealtimeStatus = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'disconnected';
-
-export class NodeRealtimeClient {
-    private wsUrl: string;
-    private projectId: string;
-    private apiKey: string | undefined;
-    private userId: string | undefined;
-    private token: string | undefined;
-    private ws: any = null;
-    private subscriptions: Map<string, RealtimeSubscription> = new Map();
-    private reconnectTimer: any = null;
-    private heartbeatTimer: any = null;
-    private reconnectAttempts: number = 0;
-    private _sendQueue: any[] = [];
-    private _connectingPromise: Promise<void> | null = null;
-    private _status: RealtimeStatus = 'idle';
-    private _statusListeners: Set<(s: RealtimeStatus) => void> = new Set();
-    private _lastPong: number = 0;
-    private _maxReconnectAttempts: number;
-    private _maxRetriesListeners: Set<() => void> = new Set();
-
-    constructor(options: NodeRealtimeOptions) {
-        const base = options.serverUrl.replace(/\/v1\/?$/, '').replace(/^http/, 'ws');
-        this.wsUrl = `${base}/api/realtime`;
-        this.projectId = options.projectId;
-        this.apiKey = options.apiKey;
-        this.userId = options.userId;
-        this.token = options.token;
-        this._maxReconnectAttempts = options.maxReconnectAttempts ?? Infinity;
-    }
-
-    get status(): RealtimeStatus { return this._status; }
-    get connected(): boolean { return this._status === 'connected'; }
-
-    onStatusChange(cb: (status: RealtimeStatus) => void): () => void {
-        this._statusListeners.add(cb);
-        return () => this._statusListeners.delete(cb);
-    }
-
-    onMaxRetriesExceeded(cb: () => void): () => void {
-        this._maxRetriesListeners.add(cb);
-        return () => this._maxRetriesListeners.delete(cb);
-    }
-
-    private _setStatus(s: RealtimeStatus) {
-        this._status = s;
-        this._statusListeners.forEach(cb => cb(s));
-    }
-
-    setToken(newToken: string): void {
-        this.token = newToken;
-        this._send({ type: 'auth', token: newToken });
-    }
-
-    async connect(): Promise<void> {
-        if (this.ws && this._status === 'connected') return;
-        if (this._connectingPromise) return this._connectingPromise;
-        this._connectingPromise = this._doConnect().finally(() => {
-            this._connectingPromise = null;
-        });
-        return this._connectingPromise;
-    }
-
-    private async _doConnect(): Promise<void> {
-        this._setStatus('connecting');
-        const url = new URL(this.wsUrl);
-        if (this.apiKey) {
-            url.searchParams.set('apiKey', this.apiKey);
-        } else {
-            url.searchParams.set('projectId', this.projectId);
-        }
-        if (this.userId) url.searchParams.set('userId', this.userId);
-        if (this.token) url.searchParams.set('token', this.token);
-
-        return new Promise(async (resolve, reject) => {
-            try {
-                let WsClass: any;
-                if (typeof globalThis.WebSocket !== 'undefined') {
-                    WsClass = globalThis.WebSocket;
-                } else {
-                    try {
-                        const ws = await import('ws');
-                        WsClass = ws.default || ws;
-                    } catch {
-                        throw new Error('WebSocket not available. Install "ws" package.');
-                    }
-                }
-
-                this.ws = new WsClass(url.toString());
-
-                this.ws.onopen = () => {
-                    this._setStatus('connected');
-                    this.reconnectAttempts = 0;
-                    this._lastPong = Date.now();
-                    this.startHeartbeat();
-                    while (this._sendQueue.length > 0) {
-                        this.ws.send(JSON.stringify(this._sendQueue.shift()));
-                    }
-                    for (const sub of this.subscriptions.values()) {
-                        if (sub.isSubscribed) sub.subscribe();
-                    }
-                    resolve();
-                };
-
-                this.ws.onmessage = (event: any) => {
-                    try {
-                        const raw = typeof event === 'string' ? event : event.data;
-                        const data: RealtimeMessage = JSON.parse(raw);
-                        this.handleMessage(data);
-                    } catch (e) {
-                        console.error('Realtime message parse error:', e);
-                    }
-                };
-
-                this.ws.onclose = () => {
-                    this._setStatus('reconnecting');
-                    this.stopHeartbeat();
-                    this.ws = null;
-                    this.scheduleReconnect();
-                };
-
-                this.ws.onerror = (err: any) => {
-                    console.error('Realtime connection error:', err);
-                    this._setStatus('disconnected');
-                    reject(err);
-                };
-            } catch (e) {
-                this._setStatus('disconnected');
-                reject(e);
-            }
-        });
-    }
-
-    disconnect(): void {
-        this._setStatus('disconnected');
-        this.stopReconnect();
-        this.stopHeartbeat();
-        if (this.ws) {
-            this.ws.close();
-            this.ws = null;
-        }
-        this._sendQueue = [];
-    }
-
-    channel<T = any>(topic: string, options: RealtimeSubscriptionOptions = {}): RealtimeSubscription<T> {
-        const fullTopic = topic.includes('/') ? topic : `table/${topic}/${this.projectId}`;
-        let sub = this.subscriptions.get(fullTopic);
-        if (!sub) {
-            sub = new RealtimeSubscription<T>(this, fullTopic, options);
-            this.subscriptions.set(fullTopic, sub);
-        }
-        return sub as RealtimeSubscription<T>;
-    }
-
-    sendChat(roomId: string, text: string): void {
-        this._send({ type: 'chat', roomId, text });
-    }
-
-    chatRoom(roomId: string): RealtimeSubscription {
-        return this.channel(`chat/${roomId}/${this.projectId}`);
-    }
-
-    /** @internal */
-    _send(data: any): void {
-        if (this.ws && this._status === 'connected') {
-            this.ws.send(JSON.stringify(data));
-        } else {
-            this._sendQueue.push(data);
-        }
-    }
-
-    private handleMessage(data: RealtimeMessage): void {
-        if (data.type === 'pong') {
-            this._lastPong = Date.now();
-            return;
-        }
-        if (data.type === 'db_change' || data.type === 'chat_message') {
-            const sub = this.subscriptions.get(data.topic);
-            if (sub) sub._emit(data as any);
-        }
-    }
-
-    private startHeartbeat(): void {
-        this.heartbeatTimer = setInterval(() => {
-            this._send({ type: 'ping' });
-            if (this._lastPong > 0 && Date.now() - this._lastPong > 70000) {
-                console.warn('Realtime: no pong received, forcing reconnect');
-                this.ws?.close();
-            }
-        }, 30000);
-    }
-
-    private stopHeartbeat(): void {
-        if (this.heartbeatTimer) {
-            clearInterval(this.heartbeatTimer);
-            this.heartbeatTimer = null;
-        }
-    }
-
-    private scheduleReconnect(): void {
-        this.stopReconnect();
-        if (this.reconnectAttempts >= this._maxReconnectAttempts) {
-            this._setStatus('disconnected');
-            this._maxRetriesListeners.forEach(cb => cb());
-            return;
-        }
-        const delay = Math.min(BASE_RECONNECT_MS * Math.pow(2, this.reconnectAttempts), MAX_RECONNECT_MS);
-        const jitter = delay * JITTER_FACTOR * Math.random();
-        this.reconnectAttempts++;
-        this.reconnectTimer = setTimeout(() => {
-            this.connect().catch(() => { });
-        }, delay + jitter);
-    }
-
-    private stopReconnect(): void {
-        if (this.reconnectTimer) {
-            clearTimeout(this.reconnectTimer);
-            this.reconnectTimer = null;
-        }
-    }
-}

package/src/sdk/sdk.ts

@@ -1,55 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { ClientSDK } from "../lib/sdks.js";
-import { Ai } from "./ai.js";
-import { Authentication } from "./authentication.js";
-import { Cache } from "./cache.js";
-import { Database } from "./database.js";
-import { Gateway } from "./gateway.js";
-import { Queue } from "./queue.js";
-import { Services } from "./services.js";
-import { Storage } from "./storage.js";
-
-export class SDK extends ClientSDK {
-  private _database?: Database;
-  get database(): Database {
-    return (this._database ??= new Database(this._options));
-  }
-
-  private _authentication?: Authentication;
-  get authentication(): Authentication {
-    return (this._authentication ??= new Authentication(this._options));
-  }
-
-  private _cache?: Cache;
-  get cache(): Cache {
-    return (this._cache ??= new Cache(this._options));
-  }
-
-  private _queue?: Queue;
-  get queue(): Queue {
-    return (this._queue ??= new Queue(this._options));
-  }
-
-  private _storage?: Storage;
-  get storage(): Storage {
-    return (this._storage ??= new Storage(this._options));
-  }
-
-  private _ai?: Ai;
-  get ai(): Ai {
-    return (this._ai ??= new Ai(this._options));
-  }
-
-  private _services?: Services;
-  get services(): Services {
-    return (this._services ??= new Services(this._options));
-  }
-
-  private _gateway?: Gateway;
-  get gateway(): Gateway {
-    return (this._gateway ??= new Gateway(this._options));
-  }
-}

package/src/sdk/search.ts

@@ -1,97 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { aiSearchConfigure } from "../funcs/aiSearchConfigure.js";
-import { aiSearchDelete } from "../funcs/aiSearchDelete.js";
-import { aiSearchDeleteByType } from "../funcs/aiSearchDeleteByType.js";
-import { aiSearchIngest } from "../funcs/aiSearchIngest.js";
-import { aiSearchListTypes } from "../funcs/aiSearchListTypes.js";
-import { aiSearchQuery } from "../funcs/aiSearchQuery.js";
-import { ClientSDK, RequestOptions } from "../lib/sdks.js";
-import * as operations from "./models/operations/index.js";
-import { unwrapAsync } from "./types/fp.js";
-
-export class Search extends ClientSDK {
-  /**
-   * Ingest content into managed search index
-   */
-  async ingest(
-    request: operations.IngestRequestBody,
-    options?: RequestOptions,
-  ): Promise<operations.IngestResponseBody> {
-    return unwrapAsync(aiSearchIngest(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Search managed index
-   */
-  async query(
-    request: operations.QueryRequestBody,
-    options?: RequestOptions,
-  ): Promise<operations.QueryResponseBody> {
-    return unwrapAsync(aiSearchQuery(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Delete item by ID
-   */
-  async delete(
-    request: operations.DeleteRequestBody,
-    options?: RequestOptions,
-  ): Promise<operations.DeleteResponseBody> {
-    return unwrapAsync(aiSearchDelete(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * Delete all items of a type
-   */
-  async deleteByType(
-    request: operations.DeleteByTypeRequestBody,
-    options?: RequestOptions,
-  ): Promise<operations.DeleteByTypeResponseBody> {
-    return unwrapAsync(aiSearchDeleteByType(
-      this,
-      request,
-      options,
-    ));
-  }
-
-  /**
-   * List distinct types and counts
-   */
-  async listTypes(
-    options?: RequestOptions,
-  ): Promise<operations.ListTypesResponseBody> {
-    return unwrapAsync(aiSearchListTypes(
-      this,
-      options,
-    ));
-  }
-
-  /**
-   * Update search configuration
-   */
-  async configure(
-    request: operations.ConfigureRequestBody,
-    options?: RequestOptions,
-  ): Promise<operations.ConfigureResponseBody> {
-    return unwrapAsync(aiSearchConfigure(
-      this,
-      request,
-      options,
-    ));
-  }
-}

package/src/sdk/services.ts

@@ -1,24 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { servicesServicesInvoke } from "../funcs/servicesServicesInvoke.js";
-import { ClientSDK, RequestOptions } from "../lib/sdks.js";
-import * as operations from "./models/operations/index.js";
-import { unwrapAsync } from "./types/fp.js";
-
-export class Services extends ClientSDK {
-  /**
-   * Invoke another service
-   */
-  async servicesInvoke(
-    request: operations.ServicesInvokeRequestBody,
-    options?: RequestOptions,
-  ): Promise<operations.ServicesInvokeResponseBody> {
-    return unwrapAsync(servicesServicesInvoke(
-      this,
-      request,
-      options,
-    ));
-  }
-}

package/src/sdk/storage.ts

@@ -1,24 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { storageStorageUpload } from "../funcs/storageStorageUpload.js";
-import { ClientSDK, RequestOptions } from "../lib/sdks.js";
-import * as operations from "./models/operations/index.js";
-import { unwrapAsync } from "./types/fp.js";
-
-export class Storage extends ClientSDK {
-  /**
-   * Upload file to storage
-   */
-  async storageUpload(
-    request: operations.StorageUploadRequestBody,
-    options?: RequestOptions,
-  ): Promise<operations.StorageUploadResponseBody> {
-    return unwrapAsync(storageStorageUpload(
-      this,
-      request,
-      options,
-    ));
-  }
-}

package/src/sdk/types/async.ts

@@ -1,68 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-export type APICall =
-  | {
-      status: "complete";
-      request: Request;
-      response: Response;
-    }
-  | {
-      status: "request-error";
-      request: Request;
-      response?: undefined;
-    }
-  | {
-      status: "invalid";
-      request?: undefined;
-      response?: undefined;
-    };
-
-export class APIPromise<T> implements Promise<T> {
-  readonly #promise: Promise<[T, APICall]>;
-  readonly #unwrapped: Promise<T>;
-
-  readonly [Symbol.toStringTag] = "APIPromise";
-
-  constructor(p: [T, APICall] | Promise<[T, APICall]>) {
-    this.#promise = p instanceof Promise ? p : Promise.resolve(p);
-    this.#unwrapped =
-      p instanceof Promise
-        ? this.#promise.then(([value]) => value)
-        : Promise.resolve(p[0]);
-  }
-
-  then<TResult1 = T, TResult2 = never>(
-    onfulfilled?:
-      | ((value: T) => TResult1 | PromiseLike<TResult1>)
-      | null
-      | undefined,
-    onrejected?:
-      | ((reason: any) => TResult2 | PromiseLike<TResult2>)
-      | null
-      | undefined,
-  ): Promise<TResult1 | TResult2> {
-    return this.#promise.then(
-      onfulfilled ? ([value]) => onfulfilled(value) : void 0,
-      onrejected,
-    );
-  }
-
-  catch<TResult = never>(
-    onrejected?:
-      | ((reason: any) => TResult | PromiseLike<TResult>)
-      | null
-      | undefined,
-  ): Promise<T | TResult> {
-    return this.#unwrapped.catch(onrejected);
-  }
-
-  finally(onfinally?: (() => void) | null | undefined): Promise<T> {
-    return this.#unwrapped.finally(onfinally);
-  }
-
-  $inspect(): Promise<[T, APICall]> {
-    return this.#promise;
-  }
-}

package/src/sdk/types/blobs.ts

@@ -1,32 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import * as z from "zod/v3";
-
-export const blobLikeSchema: z.ZodType<Blob, z.ZodTypeDef, Blob> = z.custom<
-  Blob
->(isBlobLike, {
-  message: "expected a Blob, File or Blob-like object",
-  fatal: true,
-});
-
-export function isBlobLike(val: unknown): val is Blob {
-  if (val instanceof Blob) {
-    return true;
-  }
-
-  if (typeof val !== "object" || val == null || !(Symbol.toStringTag in val)) {
-    return false;
-  }
-
-  const name = val[Symbol.toStringTag];
-  if (typeof name !== "string") {
-    return false;
-  }
-  if (name !== "Blob" && name !== "File") {
-    return false;
-  }
-
-  return "stream" in val && typeof val.stream === "function";
-}

package/src/sdk/types/constdatetime.ts

@@ -1,15 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import * as z from "zod/v3";
-
-export function constDateTime(
-  val: string,
-): z.ZodType<string, z.ZodTypeDef, unknown> {
-  return z.custom<string>((v) => {
-    return (
-      typeof v === "string" && new Date(v).getTime() === new Date(val).getTime()
-    );
-  }, `Value must be equivalent to ${val}`);
-}

package/src/sdk/types/enums.ts

@@ -1,45 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import * as z from "zod/v3";
-import { Unrecognized, unrecognized } from "./unrecognized.js";
-
-export type ClosedEnum<T extends Readonly<Record<string, string | number>>> =
-  T[keyof T];
-export type OpenEnum<T extends Readonly<Record<string, string | number>>> =
-  | T[keyof T]
-  | Unrecognized<T[keyof T] extends number ? number : string>;
-
-export function inboundSchema<T extends Record<string, string>>(
-  enumObj: T,
-): z.ZodType<OpenEnum<T>, z.ZodTypeDef, unknown> {
-  const options = Object.values(enumObj);
-  return z.union([
-    ...options.map(x => z.literal(x)),
-    z.string().transform(x => unrecognized(x)),
-  ] as any);
-}
-
-export function inboundSchemaInt<T extends Record<string, number | string>>(
-  enumObj: T,
-): z.ZodType<OpenEnum<T>, z.ZodTypeDef, unknown> {
-  // For numeric enums, Object.values returns both numbers and string keys
-  const options = Object.values(enumObj).filter(v => typeof v === "number");
-  return z.union([
-    ...options.map(x => z.literal(x)),
-    z.number().int().transform(x => unrecognized(x)),
-  ] as any);
-}
-
-export function outboundSchema<T extends Record<string, string>>(
-  _: T,
-): z.ZodType<string, z.ZodTypeDef, OpenEnum<T>> {
-  return z.string() as any;
-}
-
-export function outboundSchemaInt<T extends Record<string, number | string>>(
-  _: T,
-): z.ZodType<number, z.ZodTypeDef, OpenEnum<T>> {
-  return z.number().int() as any;
-}