superso-js-sdk 1.0.1

package/dist/realtime/realtime.d.ts

@@ -0,0 +1,65 @@
+import { SupersoClient } from "../core/client";
+export interface RealtimeEvent {
+    id?: string;
+    project_id?: string;
+    channel_id?: string;
+    channel?: string;
+    auth_user_id?: string;
+    auth_method?: string;
+    event_name?: string;
+    event?: string;
+    payload?: any;
+    data?: any;
+    status?: string;
+    timestamp?: any;
+    created_at?: string;
+}
+export interface RealtimeOptions {
+    token?: string;
+    reconnect?: boolean;
+    reconnectInterval?: number;
+    maxRetries?: number;
+    heartbeat?: boolean;
+    heartbeatInterval?: number;
+}
+export declare class SupersoRealtime {
+    private client;
+    private socket;
+    private channel;
+    private handlers;
+    private reconnect;
+    private reconnectInterval;
+    private maxRetries;
+    private retryCount;
+    private token?;
+    private heartbeat;
+    private heartbeatInterval;
+    private heartbeatTimer;
+    constructor(client: SupersoClient);
+    connect(channel: string, options?: RealtimeOptions): void;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private emit;
+    on(event: string, callback: Function): void;
+    off(event: string, callback?: Function): void;
+    send(event: string, data?: any): void;
+    ping(): void;
+    refreshToken(refreshToken: string): void;
+    startTyping(): void;
+    stopTyping(): void;
+    disconnect(): void;
+    getSocket(): WebSocket | null;
+    getChannel(): string;
+    isConnected(): boolean;
+}
+export declare function subscribeCollection(realtime: SupersoRealtime, collection: string, options?: RealtimeOptions): void;
+export declare function liveQuery(realtime: SupersoRealtime, callback: Function): void;
+export declare function subscribeNotifications(realtime: SupersoRealtime, callback?: Function): void;
+export declare function subscribePresence(realtime: SupersoRealtime, callback: Function): void;
+export declare function subscribeTyping(realtime: SupersoRealtime, callback: Function): void;
+export declare function subscribeVerificationRequired(realtime: SupersoRealtime, callback: Function): void;
+export declare function publishEvent(client: SupersoClient, channel: string, event_name: string, payload?: any): Promise<any>;
+export declare function listEvents(client: SupersoClient, channel: string): Promise<any>;
+export declare function replayEvents(client: SupersoClient, channel: string, sequence: number): Promise<any>;
+export declare function replayEventsSince(client: SupersoClient, channel: string, timestamp: string): Promise<any>;
+export declare function getLatestSequence(client: SupersoClient, channel: string): Promise<any>;

package/dist/realtime/realtime.js

@@ -0,0 +1,365 @@
+// =======================================
+// REALTIME CLASS
+// =======================================
+export class SupersoRealtime {
+    constructor(client) {
+        this.socket = null;
+        this.channel = "";
+        this.handlers = {};
+        this.reconnect = true;
+        this.reconnectInterval = 3000;
+        this.maxRetries = 10;
+        this.retryCount = 0;
+        this.heartbeat = true;
+        this.heartbeatInterval = 30000;
+        this.heartbeatTimer = null;
+        this.client = client;
+    }
+    // =======================================
+    // CONNECT
+    // =======================================
+    connect(channel, options) {
+        var _a, _b, _c, _d, _e;
+        if (this.socket &&
+            (this.socket.readyState ===
+                WebSocket.OPEN ||
+                this.socket.readyState ===
+                    WebSocket.CONNECTING) &&
+            this.channel ===
+                channel) {
+            return;
+        }
+        this.channel =
+            channel;
+        this.token =
+            options === null || options === void 0 ? void 0 : options.token;
+        this.reconnect =
+            (_a = options === null || options === void 0 ? void 0 : options.reconnect) !== null && _a !== void 0 ? _a : true;
+        this.reconnectInterval =
+            (_b = options === null || options === void 0 ? void 0 : options.reconnectInterval) !== null && _b !== void 0 ? _b : 3000;
+        this.maxRetries =
+            (_c = options === null || options === void 0 ? void 0 : options.maxRetries) !== null && _c !== void 0 ? _c : 10;
+        this.heartbeat =
+            (_d = options === null || options === void 0 ? void 0 : options.heartbeat) !== null && _d !== void 0 ? _d : true;
+        this.heartbeatInterval =
+            (_e = options === null || options === void 0 ? void 0 : options.heartbeatInterval) !== null && _e !== void 0 ? _e : 30000;
+        const params = new URLSearchParams({
+            key: this.client.apiKey,
+        });
+        if (this.token) {
+            params.append("token", this.token);
+        }
+        const protocol = this.client.baseUrl.startsWith("https")
+            ? "wss"
+            : "ws";
+        const cleanBase = this.client.baseUrl
+            .replace("https://", "")
+            .replace("http://", "");
+        const wsUrl = `${protocol}://${cleanBase}/ws/project/${this.client.projectId}/channel/${channel}?${params}`;
+        this.socket =
+            new WebSocket(wsUrl);
+        // =======================================
+        // OPEN
+        // =======================================
+        this.socket.onopen =
+            () => {
+                this.retryCount = 0;
+                console.log(`Realtime connected: ${channel}`);
+                this.emit("connected", {
+                    channel,
+                });
+                if (this.heartbeat) {
+                    this.startHeartbeat();
+                }
+            };
+        // =======================================
+        // MESSAGE
+        // =======================================
+        this.socket.onmessage =
+            (event) => {
+                try {
+                    const parsed = JSON.parse(event.data);
+                    const eventName = parsed.event_name ||
+                        parsed.event ||
+                        "message";
+                    // internal pong
+                    if (eventName ===
+                        "pong") {
+                        return;
+                    }
+                    // emit event
+                    this.emit(eventName, parsed);
+                    // wildcard
+                    this.emit("*", parsed);
+                }
+                catch (error) {
+                    console.error("Realtime parse error", error);
+                }
+            };
+        // =======================================
+        // CLOSE
+        // =======================================
+        this.socket.onclose =
+            () => {
+                console.log("Realtime disconnected");
+                this.stopHeartbeat();
+                this.emit("disconnected", {
+                    channel: this.channel,
+                });
+                if (this.reconnect &&
+                    this.retryCount <
+                        this.maxRetries) {
+                    this.retryCount += 1;
+                    setTimeout(() => {
+                        this.connect(this.channel, {
+                            token: this.token,
+                            reconnect: this.reconnect,
+                            reconnectInterval: this.reconnectInterval,
+                            maxRetries: this.maxRetries,
+                            heartbeat: this.heartbeat,
+                            heartbeatInterval: this.heartbeatInterval,
+                        });
+                    }, this.reconnectInterval);
+                }
+            };
+        // =======================================
+        // ERROR
+        // =======================================
+        this.socket.onerror =
+            (error) => {
+                console.error("Realtime error", error);
+                this.emit("error", error);
+            };
+    }
+    // =======================================
+    // HEARTBEAT
+    // =======================================
+    startHeartbeat() {
+        this.stopHeartbeat();
+        this.heartbeatTimer =
+            setInterval(() => {
+                this.ping();
+            }, this.heartbeatInterval);
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer =
+                null;
+        }
+    }
+    // =======================================
+    // EMIT
+    // =======================================
+    emit(event, payload) {
+        if (!this.handlers[event]) {
+            return;
+        }
+        this.handlers[event]
+            .forEach((callback) => {
+            callback(payload);
+        });
+    }
+    // =======================================
+    // ON
+    // =======================================
+    on(event, callback) {
+        if (!this.handlers[event]) {
+            this.handlers[event] =
+                [];
+        }
+        this.handlers[event]
+            .push(callback);
+    }
+    // =======================================
+    // OFF
+    // =======================================
+    off(event, callback) {
+        if (!this.handlers[event]) {
+            return;
+        }
+        if (!callback) {
+            delete this.handlers[event];
+            return;
+        }
+        this.handlers[event] =
+            this.handlers[event].filter((cb) => cb !== callback);
+    }
+    // =======================================
+    // SEND
+    // =======================================
+    send(event, data) {
+        if (!this.socket ||
+            this.socket.readyState !==
+                WebSocket.OPEN) {
+            return;
+        }
+        this.socket.send(JSON.stringify({
+            event,
+            data,
+        }));
+    }
+    // =======================================
+    // PING
+    // =======================================
+    ping() {
+        this.send("ping");
+    }
+    // =======================================
+    // TOKEN REFRESH
+    // =======================================
+    refreshToken(refreshToken) {
+        this.send("token_refresh", {
+            refresh_token: refreshToken,
+        });
+    }
+    // =======================================
+    // TYPING
+    // =======================================
+    startTyping() {
+        this.send("typing", {
+            is_typing: true,
+        });
+    }
+    stopTyping() {
+        this.send("typing", {
+            is_typing: false,
+        });
+    }
+    // =======================================
+    // DISCONNECT
+    // =======================================
+    disconnect() {
+        var _a;
+        this.reconnect =
+            false;
+        this.stopHeartbeat();
+        (_a = this.socket) === null || _a === void 0 ? void 0 : _a.close();
+        this.socket = null;
+    }
+    // =======================================
+    // GETTERS
+    // =======================================
+    getSocket() {
+        return this.socket;
+    }
+    getChannel() {
+        return this.channel;
+    }
+    isConnected() {
+        var _a;
+        return (((_a = this.socket) === null || _a === void 0 ? void 0 : _a.readyState) ===
+            WebSocket.OPEN);
+    }
+}
+// =======================================
+// COLLECTION REALTIME
+// =======================================
+export function subscribeCollection(realtime, collection, options) {
+    realtime.connect(`${collection}-realtime`, options);
+}
+// =======================================
+// DATABASE LIVE QUERY
+// =======================================
+export function liveQuery(realtime, callback) {
+    realtime.on("document_created", callback);
+    realtime.on("document_updated", callback);
+    realtime.on("document_deleted", callback);
+}
+// =======================================
+// NOTIFICATIONS
+// =======================================
+export function subscribeNotifications(realtime, callback) {
+    realtime.on("notification", callback ||
+        ((event) => {
+            console.log("Notification:", event);
+        }));
+    realtime.on("notification.received", callback ||
+        ((event) => {
+            console.log("Notification:", event);
+        }));
+}
+// =======================================
+// PRESENCE
+// =======================================
+export function subscribePresence(realtime, callback) {
+    realtime.on("user_presence", callback);
+}
+// =======================================
+// TYPING
+// =======================================
+export function subscribeTyping(realtime, callback) {
+    realtime.on("typing", callback);
+}
+// =======================================
+// VERIFICATION
+// =======================================
+export function subscribeVerificationRequired(realtime, callback) {
+    realtime.on("verification_required", callback);
+}
+// =======================================
+// REST EVENT PUBLISH
+// =======================================
+export async function publishEvent(client, channel, event_name, payload) {
+    const response = await fetch(`${client.baseUrl}/api/project/${client.projectId}/realtime/channels/${channel}/events`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "X-Superso-Project-Key": client.apiKey,
+        },
+        body: JSON.stringify({
+            event_name,
+            payload,
+        }),
+    });
+    const data = await response.json();
+    if (!response.ok) {
+        throw new Error((data === null || data === void 0 ? void 0 : data.message) ||
+            "Publish event failed");
+    }
+    return data;
+}
+// =======================================
+// LIST EVENTS
+// =======================================
+export async function listEvents(client, channel) {
+    const response = await fetch(`${client.baseUrl}/api/project/${client.projectId}/realtime/channels/${channel}/events`, {
+        headers: {
+            "X-Superso-Project-Key": client.apiKey,
+        },
+    });
+    return await response.json();
+}
+// =======================================
+// REPLAY EVENTS
+// =======================================
+export async function replayEvents(client, channel, sequence) {
+    const response = await fetch(`${client.baseUrl}/api/project/${client.projectId}/realtime/channels/${channel}/events/replay?sequence=${sequence}`, {
+        headers: {
+            "X-Superso-Project-Key": client.apiKey,
+        },
+    });
+    return await response.json();
+}
+// =======================================
+// REPLAY SINCE
+// =======================================
+export async function replayEventsSince(client, channel, timestamp) {
+    const response = await fetch(`${client.baseUrl}/api/project/${client.projectId}/realtime/channels/${channel}/events/replay/since?timestamp=${timestamp}`, {
+        headers: {
+            "X-Superso-Project-Key": client.apiKey,
+        },
+    });
+    return await response.json();
+}
+// =======================================
+// LATEST SEQUENCE
+// =======================================
+export async function getLatestSequence(client, channel) {
+    const response = await fetch(`${client.baseUrl}/api/project/${client.projectId}/realtime/channels/${channel}/events/latest-seq`, {
+        headers: {
+            "X-Superso-Project-Key": client.apiKey,
+        },
+    });
+    return await response.json();
+}

package/dist/storage/storage.d.ts

@@ -0,0 +1,69 @@
+import { SupersoClient } from "../core/client";
+export interface UploadOptions {
+    path?: string;
+    alt_text?: string;
+    caption?: string;
+    token?: string;
+    onProgress?: (percent: number) => void;
+}
+export interface StorageAsset {
+    id: string;
+    owner_type?: string;
+    owner_id?: string;
+    project_id?: string;
+    url: string;
+    secure_url: string;
+    public_id: string;
+    file_name: string;
+    mime_type: string;
+    size_bytes: number;
+    width?: number;
+    height?: number;
+    provider?: string;
+    folder?: string;
+    alt_text?: string;
+    caption?: string;
+    metadata?: any;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface StorageUsage {
+    used_bytes: number;
+    used_mb: number;
+    limit_mb: number;
+    limit_bytes: number;
+    percent_used: number;
+    feature_on: boolean;
+    configured: boolean;
+    warning_level: "ok" | "soft" | "strong" | "urgent" | "blocked";
+}
+export declare function uploadFile(client: SupersoClient, file: File, options?: UploadOptions): Promise<unknown>;
+export declare function uploadFiles(client: SupersoClient, files: File[], options?: UploadOptions): Promise<unknown[]>;
+export declare function listAssets(client: SupersoClient, token?: string): Promise<any>;
+export declare function listFiles(client: SupersoClient, token?: string): Promise<any>;
+export declare function getAsset(client: SupersoClient, assetId: string, token?: string): Promise<any>;
+export declare function deleteAsset(client: SupersoClient, assetId: string, token?: string): Promise<any>;
+export declare function deleteFile(client: SupersoClient, assetId: string, token?: string): Promise<any>;
+export declare function removeFile(client: SupersoClient, assetId: string, token?: string): Promise<any>;
+export declare function getStorageUsage(client: SupersoClient, token?: string): Promise<StorageUsage>;
+export declare function getFileExtension(fileName: string): string | undefined;
+export declare function formatBytes(bytes: number, decimals?: number): string;
+export declare function isImage(mimeType: string): boolean;
+export declare function isVideo(mimeType: string): boolean;
+export declare function isAudio(mimeType: string): boolean;
+export declare function isPDF(mimeType: string): mimeType is "application/pdf";
+export declare function isDocument(mimeType: string): boolean;
+export declare function validateFile(file: File): boolean;
+export declare function optimizeImage(url: string): string;
+export declare function convertToWebP(url: string): string;
+export declare function resizeImage(url: string, width: number, height?: number): string;
+export declare function thumbnail(url: string, size?: number): string;
+export declare function cropImage(url: string, width: number, height: number): string;
+export declare function blurImage(url: string): string;
+export declare function grayscaleImage(url: string): string;
+export declare function autoQuality(url: string): string;
+export declare function autoFormat(url: string): string;
+export declare function getSecureUrl(asset: StorageAsset): string;
+export declare function getPublicUrl(asset: StorageAsset): string;
+export declare function buildAuthenticatedUrl(cloudName: string, publicId: string): void;
+export declare function buildPrivateUrl(cloudName: string, publicId: string): void;