@sogni-ai/sogni-client-wrapper 1.0.0

package/dist/index.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = exports.formatDuration = exports.formatBytes = exports.retry = exports.sleep = exports.validateProjectConfig = exports.validateClientConfig = exports.generateAppId = exports.SogniNetworkError = exports.SogniModelNotFoundError = exports.SogniConfigurationError = exports.SogniValidationError = exports.SogniBalanceError = exports.SogniTimeoutError = exports.SogniProjectError = exports.SogniAuthenticationError = exports.SogniConnectionError = exports.SogniError = exports.ClientEvent = exports.SogniClientWrapper = void 0;
+var SogniClientWrapper_1 = require("./client/SogniClientWrapper");
+Object.defineProperty(exports, "SogniClientWrapper", { enumerable: true, get: function () { return SogniClientWrapper_1.SogniClientWrapper; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "ClientEvent", { enumerable: true, get: function () { return types_1.ClientEvent; } });
+var errors_1 = require("./utils/errors");
+Object.defineProperty(exports, "SogniError", { enumerable: true, get: function () { return errors_1.SogniError; } });
+Object.defineProperty(exports, "SogniConnectionError", { enumerable: true, get: function () { return errors_1.SogniConnectionError; } });
+Object.defineProperty(exports, "SogniAuthenticationError", { enumerable: true, get: function () { return errors_1.SogniAuthenticationError; } });
+Object.defineProperty(exports, "SogniProjectError", { enumerable: true, get: function () { return errors_1.SogniProjectError; } });
+Object.defineProperty(exports, "SogniTimeoutError", { enumerable: true, get: function () { return errors_1.SogniTimeoutError; } });
+Object.defineProperty(exports, "SogniBalanceError", { enumerable: true, get: function () { return errors_1.SogniBalanceError; } });
+Object.defineProperty(exports, "SogniValidationError", { enumerable: true, get: function () { return errors_1.SogniValidationError; } });
+Object.defineProperty(exports, "SogniConfigurationError", { enumerable: true, get: function () { return errors_1.SogniConfigurationError; } });
+Object.defineProperty(exports, "SogniModelNotFoundError", { enumerable: true, get: function () { return errors_1.SogniModelNotFoundError; } });
+Object.defineProperty(exports, "SogniNetworkError", { enumerable: true, get: function () { return errors_1.SogniNetworkError; } });
+var helpers_1 = require("./utils/helpers");
+Object.defineProperty(exports, "generateAppId", { enumerable: true, get: function () { return helpers_1.generateAppId; } });
+Object.defineProperty(exports, "validateClientConfig", { enumerable: true, get: function () { return helpers_1.validateClientConfig; } });
+Object.defineProperty(exports, "validateProjectConfig", { enumerable: true, get: function () { return helpers_1.validateProjectConfig; } });
+Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return helpers_1.sleep; } });
+Object.defineProperty(exports, "retry", { enumerable: true, get: function () { return helpers_1.retry; } });
+Object.defineProperty(exports, "formatBytes", { enumerable: true, get: function () { return helpers_1.formatBytes; } });
+Object.defineProperty(exports, "formatDuration", { enumerable: true, get: function () { return helpers_1.formatDuration; } });
+var SogniClientWrapper_2 = require("./client/SogniClientWrapper");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return SogniClientWrapper_2.SogniClientWrapper; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAMA,kEAAiE;AAAxD,wHAAA,kBAAkB,OAAA;AA+B3B,iCAAsC;AAA7B,oGAAA,WAAW,OAAA;AAGpB,yCAWwB;AAVtB,oGAAA,UAAU,OAAA;AACV,8GAAA,oBAAoB,OAAA;AACpB,kHAAA,wBAAwB,OAAA;AACxB,2GAAA,iBAAiB,OAAA;AACjB,2GAAA,iBAAiB,OAAA;AACjB,2GAAA,iBAAiB,OAAA;AACjB,8GAAA,oBAAoB,OAAA;AACpB,iHAAA,uBAAuB,OAAA;AACvB,iHAAA,uBAAuB,OAAA;AACvB,2GAAA,iBAAiB,OAAA;AAInB,2CAQyB;AAPvB,wGAAA,aAAa,OAAA;AACb,+GAAA,oBAAoB,OAAA;AACpB,gHAAA,qBAAqB,OAAA;AACrB,gGAAA,KAAK,OAAA;AACL,gGAAA,KAAK,OAAA;AACL,sGAAA,WAAW,OAAA;AACX,yGAAA,cAAc,OAAA;AAIhB,kEAA4E;AAAnE,6GAAA,kBAAkB,OAAW"}

package/dist/types/index.d.ts

@@ -0,0 +1,120 @@
+import type { Project, Job, AvailableModel, ProjectParams as SogniProjectParams, SupernetType, TokenType, OutputFormat, Scheduler, TimeStepSpacing } from '@sogni-ai/sogni-client';
+import type { ControlNetParams, ControlNetName, ControlNetMode } from '@sogni-ai/sogni-client/dist/Projects/types/ControlNetParams';
+export type { Project, Job, AvailableModel, SupernetType, TokenType, OutputFormat, Scheduler, TimeStepSpacing, ControlNetParams, ControlNetName, ControlNetMode, };
+export interface SogniClientConfig {
+    username: string;
+    password: string;
+    appId?: string;
+    network?: SupernetType;
+    autoConnect?: boolean;
+    reconnect?: boolean;
+    reconnectInterval?: number;
+    timeout?: number;
+    debug?: boolean;
+}
+export interface ProjectConfig extends Omit<SogniProjectParams, 'modelId' | 'negativePrompt' | 'stylePrompt'> {
+    modelId: string;
+    negativePrompt?: string;
+    stylePrompt?: string;
+    waitForCompletion?: boolean;
+    timeout?: number;
+    onProgress?: (progress: ProjectProgress) => void;
+    onJobCompleted?: (job: Job) => void;
+    onJobFailed?: (job: Job) => void;
+}
+export interface ProjectResult {
+    project: Project;
+    imageUrls?: string[];
+    jobs?: Job[];
+    completed: boolean;
+    error?: ErrorData;
+}
+export interface ProjectProgress {
+    projectId: string;
+    percentage: number;
+    completedJobs: number;
+    totalJobs: number;
+    estimatedTimeRemaining?: number;
+}
+export interface ErrorData {
+    code: string;
+    message: string;
+    statusCode?: number;
+    details?: any;
+    originalError?: Error;
+}
+export declare enum ConnectionStatus {
+    DISCONNECTED = "disconnected",
+    CONNECTING = "connecting",
+    CONNECTED = "connected",
+    RECONNECTING = "reconnecting",
+    FAILED = "failed"
+}
+export interface ConnectionState {
+    status: ConnectionStatus;
+    isConnected: boolean;
+    isConnecting: boolean;
+    reconnectAttempts: number;
+    lastError?: ErrorData;
+    connectedAt?: Date;
+}
+export interface SizePreset {
+    id: string;
+    label: string;
+    width: number;
+    height: number;
+    ratio: string;
+    aspect: string;
+}
+export interface ModelInfo extends AvailableModel {
+    isAvailable: boolean;
+    recommendedSettings?: {
+        steps?: number;
+        guidance?: number;
+        scheduler?: Scheduler;
+    };
+}
+export interface BalanceInfo {
+    sogni: number;
+    spark: number;
+    usdEquivalent?: number;
+    lastUpdated: Date;
+}
+export declare const ClientEvent: {
+    readonly CONNECTED: "connected";
+    readonly DISCONNECTED: "disconnected";
+    readonly RECONNECTING: "reconnecting";
+    readonly RECONNECTED: "reconnected";
+    readonly ERROR: "error";
+    readonly MODELS_UPDATED: "modelsUpdated";
+    readonly BALANCE_UPDATED: "balanceUpdated";
+    readonly PROJECT_CREATED: "projectCreated";
+    readonly PROJECT_PROGRESS: "projectProgress";
+    readonly PROJECT_COMPLETED: "projectCompleted";
+    readonly PROJECT_FAILED: "projectFailed";
+};
+export type ClientEvent = typeof ClientEvent[keyof typeof ClientEvent];
+export interface ClientEventCallbacks {
+    [ClientEvent.CONNECTED]: () => void;
+    [ClientEvent.DISCONNECTED]: () => void;
+    [ClientEvent.RECONNECTING]: (attempt: number) => void;
+    [ClientEvent.RECONNECTED]: () => void;
+    [ClientEvent.ERROR]: (error: ErrorData) => void;
+    [ClientEvent.MODELS_UPDATED]: (models: ModelInfo[]) => void;
+    [ClientEvent.BALANCE_UPDATED]: (balance: BalanceInfo) => void;
+    [ClientEvent.PROJECT_CREATED]: (project: Project) => void;
+    [ClientEvent.PROJECT_PROGRESS]: (progress: ProjectProgress) => void;
+    [ClientEvent.PROJECT_COMPLETED]: (result: ProjectResult) => void;
+    [ClientEvent.PROJECT_FAILED]: (error: ErrorData) => void;
+}
+export interface GetModelsOptions {
+    network?: SupernetType;
+    minWorkers?: number;
+    sortByWorkers?: boolean;
+}
+export interface CreateProjectOptions extends ProjectConfig {
+    retry?: boolean;
+    retryAttempts?: number;
+    retryDelay?: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientEvent = exports.ConnectionStatus = void 0;
+var ConnectionStatus;
+(function (ConnectionStatus) {
+    ConnectionStatus["DISCONNECTED"] = "disconnected";
+    ConnectionStatus["CONNECTING"] = "connecting";
+    ConnectionStatus["CONNECTED"] = "connected";
+    ConnectionStatus["RECONNECTING"] = "reconnecting";
+    ConnectionStatus["FAILED"] = "failed";
+})(ConnectionStatus || (exports.ConnectionStatus = ConnectionStatus = {}));
+exports.ClientEvent = {
+    CONNECTED: 'connected',
+    DISCONNECTED: 'disconnected',
+    RECONNECTING: 'reconnecting',
+    RECONNECTED: 'reconnected',
+    ERROR: 'error',
+    MODELS_UPDATED: 'modelsUpdated',
+    BALANCE_UPDATED: 'balanceUpdated',
+    PROJECT_CREATED: 'projectCreated',
+    PROJECT_PROGRESS: 'projectProgress',
+    PROJECT_COMPLETED: 'projectCompleted',
+    PROJECT_FAILED: 'projectFailed',
+};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;AAiKA,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,iDAA6B,CAAA;IAC7B,6CAAyB,CAAA;IACzB,2CAAuB,CAAA;IACvB,iDAA6B,CAAA;IAC7B,qCAAiB,CAAA;AACnB,CAAC,EANW,gBAAgB,gCAAhB,gBAAgB,QAM3B;AAmFY,QAAA,WAAW,GAAG;IACzB,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,KAAK,EAAE,OAAO;IACd,cAAc,EAAE,eAAe;IAC/B,eAAe,EAAE,gBAAgB;IACjC,eAAe,EAAE,gBAAgB;IACjC,gBAAgB,EAAE,iBAAiB;IACnC,iBAAiB,EAAE,kBAAkB;IACrC,cAAc,EAAE,eAAe;CACvB,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,38 @@
+import type { ErrorData } from '../types';
+export declare class SogniError extends Error {
+    readonly code: string;
+    readonly statusCode?: number;
+    readonly details?: any;
+    readonly originalError?: Error;
+    constructor(message: string, code: string, statusCode?: number, details?: any, originalError?: Error);
+    toErrorData(): ErrorData;
+    static fromError(error: unknown, code?: string): SogniError;
+}
+export declare class SogniConnectionError extends SogniError {
+    constructor(message: string, details?: any, originalError?: Error);
+}
+export declare class SogniAuthenticationError extends SogniError {
+    constructor(message: string, details?: any, originalError?: Error);
+}
+export declare class SogniProjectError extends SogniError {
+    constructor(message: string, details?: any, originalError?: Error);
+}
+export declare class SogniTimeoutError extends SogniError {
+    constructor(message: string, timeoutMs: number, details?: any);
+}
+export declare class SogniBalanceError extends SogniError {
+    constructor(message: string, details?: any);
+}
+export declare class SogniValidationError extends SogniError {
+    constructor(message: string, details?: any);
+}
+export declare class SogniConfigurationError extends SogniError {
+    constructor(message: string, details?: any);
+}
+export declare class SogniModelNotFoundError extends SogniError {
+    constructor(modelId: string);
+}
+export declare class SogniNetworkError extends SogniError {
+    constructor(message: string, details?: any, originalError?: Error);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAK1C,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,OAAO,CAAC,EAAE,GAAG,CAAC;IAC9B,SAAgB,aAAa,CAAC,EAAE,KAAK,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,KAAK;IAiBpG,WAAW,IAAI,SAAS;IAaxB,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,MAAwB,GAAG,UAAU;CAW7E;AAKD,qBAAa,oBAAqB,SAAQ,UAAU;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,KAAK;CAIlE;AAKD,qBAAa,wBAAyB,SAAQ,UAAU;gBAC1C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,KAAK;CAIlE;AAKD,qBAAa,iBAAkB,SAAQ,UAAU;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,KAAK;CAIlE;AAKD,qBAAa,iBAAkB,SAAQ,UAAU;gBACnC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI9D;AAKD,qBAAa,iBAAkB,SAAQ,UAAU;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAKD,qBAAa,oBAAqB,SAAQ,UAAU;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAKD,qBAAa,uBAAwB,SAAQ,UAAU;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAKD,qBAAa,uBAAwB,SAAQ,UAAU;gBACzC,OAAO,EAAE,MAAM;CAI5B;AAKD,qBAAa,iBAAkB,SAAQ,UAAU;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,KAAK;CAIlE"}

package/dist/utils/errors.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SogniNetworkError = exports.SogniModelNotFoundError = exports.SogniConfigurationError = exports.SogniValidationError = exports.SogniBalanceError = exports.SogniTimeoutError = exports.SogniProjectError = exports.SogniAuthenticationError = exports.SogniConnectionError = exports.SogniError = void 0;
+class SogniError extends Error {
+    constructor(message, code, statusCode, details, originalError) {
+        super(message);
+        this.name = 'SogniError';
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+        this.originalError = originalError;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    toErrorData() {
+        return {
+            code: this.code,
+            message: this.message,
+            statusCode: this.statusCode,
+            details: this.details,
+            originalError: this.originalError,
+        };
+    }
+    static fromError(error, code = 'UNKNOWN_ERROR') {
+        if (error instanceof SogniError) {
+            return error;
+        }
+        if (error instanceof Error) {
+            return new SogniError(error.message, code, undefined, undefined, error);
+        }
+        return new SogniError(String(error), code);
+    }
+}
+exports.SogniError = SogniError;
+class SogniConnectionError extends SogniError {
+    constructor(message, details, originalError) {
+        super(message, 'CONNECTION_ERROR', undefined, details, originalError);
+        this.name = 'SogniConnectionError';
+    }
+}
+exports.SogniConnectionError = SogniConnectionError;
+class SogniAuthenticationError extends SogniError {
+    constructor(message, details, originalError) {
+        super(message, 'AUTHENTICATION_ERROR', 401, details, originalError);
+        this.name = 'SogniAuthenticationError';
+    }
+}
+exports.SogniAuthenticationError = SogniAuthenticationError;
+class SogniProjectError extends SogniError {
+    constructor(message, details, originalError) {
+        super(message, 'PROJECT_ERROR', undefined, details, originalError);
+        this.name = 'SogniProjectError';
+    }
+}
+exports.SogniProjectError = SogniProjectError;
+class SogniTimeoutError extends SogniError {
+    constructor(message, timeoutMs, details) {
+        super(message, 'TIMEOUT_ERROR', 408, { ...details, timeoutMs }, undefined);
+        this.name = 'SogniTimeoutError';
+    }
+}
+exports.SogniTimeoutError = SogniTimeoutError;
+class SogniBalanceError extends SogniError {
+    constructor(message, details) {
+        super(message, 'INSUFFICIENT_BALANCE', 402, details, undefined);
+        this.name = 'SogniBalanceError';
+    }
+}
+exports.SogniBalanceError = SogniBalanceError;
+class SogniValidationError extends SogniError {
+    constructor(message, details) {
+        super(message, 'VALIDATION_ERROR', 400, details, undefined);
+        this.name = 'SogniValidationError';
+    }
+}
+exports.SogniValidationError = SogniValidationError;
+class SogniConfigurationError extends SogniError {
+    constructor(message, details) {
+        super(message, 'CONFIGURATION_ERROR', undefined, details, undefined);
+        this.name = 'SogniConfigurationError';
+    }
+}
+exports.SogniConfigurationError = SogniConfigurationError;
+class SogniModelNotFoundError extends SogniError {
+    constructor(modelId) {
+        super(`Model not found: ${modelId}`, 'MODEL_NOT_FOUND', 404, { modelId }, undefined);
+        this.name = 'SogniModelNotFoundError';
+    }
+}
+exports.SogniModelNotFoundError = SogniModelNotFoundError;
+class SogniNetworkError extends SogniError {
+    constructor(message, details, originalError) {
+        super(message, 'NETWORK_ERROR', undefined, details, originalError);
+        this.name = 'SogniNetworkError';
+    }
+}
+exports.SogniNetworkError = SogniNetworkError;
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/helpers.d.ts

@@ -0,0 +1,27 @@
+import type { ProjectConfig, SogniClientConfig } from '../types';
+export declare function generateAppId(): string;
+export declare function validateClientConfig(config: SogniClientConfig): void;
+export declare function validateProjectConfig(config: ProjectConfig): void;
+export declare function createTimeoutPromise<T>(timeoutMs: number, errorMessage?: string): Promise<T>;
+export declare function waitFor(condition: () => boolean | Promise<boolean>, options?: {
+    timeout?: number;
+    interval?: number;
+    timeoutMessage?: string;
+}): Promise<void>;
+export declare function sleep(ms: number): Promise<void>;
+export declare function retry<T>(fn: () => Promise<T>, options?: {
+    maxAttempts?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    backoffFactor?: number;
+    onRetry?: (attempt: number, error: Error) => void;
+}): Promise<T>;
+export declare function formatBytes(bytes: number, decimals?: number): string;
+export declare function formatDuration(ms: number): string;
+export declare function deepClone<T>(obj: T): T;
+export declare function isPlainObject(value: any): value is Record<string, any>;
+export declare function deepMerge<T extends Record<string, any>>(target: T, ...sources: Partial<T>[]): T;
+export declare function sanitizeForLog(str: string, keysToHide?: string[]): string;
+export declare function debounce<T extends (...args: any[]) => any>(func: T, waitMs: number): (...args: Parameters<T>) => void;
+export declare function throttle<T extends (...args: any[]) => any>(func: T, limitMs: number): (...args: Parameters<T>) => void;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAMjE,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAKD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAoBpE;AAKD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CA8CjE;AAKD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAE,MAA8B,GAAG,OAAO,CAAC,CAAC,CAAC,CAMnH;AAKD,wBAAsB,OAAO,CAC3B,SAAS,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAC3C,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,GACL,OAAO,CAAC,IAAI,CAAC,CAiBf;AAKD,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAKD,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC9C,GACL,OAAO,CAAC,CAAC,CAAC,CAgCZ;AAKD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAUvE;AAKD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAYjD;AAKD,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAEtC;AAKD,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAEtE;AAKD,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAkB/F;AAKD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,EAAoC,GAAG,MAAM,CAS1G;AAKD,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,MAAM,GACb,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAYlC;AAKD,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,MAAM,GACd,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAYlC"}

package/dist/utils/helpers.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAppId = generateAppId;
+exports.validateClientConfig = validateClientConfig;
+exports.validateProjectConfig = validateProjectConfig;
+exports.createTimeoutPromise = createTimeoutPromise;
+exports.waitFor = waitFor;
+exports.sleep = sleep;
+exports.retry = retry;
+exports.formatBytes = formatBytes;
+exports.formatDuration = formatDuration;
+exports.deepClone = deepClone;
+exports.isPlainObject = isPlainObject;
+exports.deepMerge = deepMerge;
+exports.sanitizeForLog = sanitizeForLog;
+exports.debounce = debounce;
+exports.throttle = throttle;
+const crypto_1 = require("crypto");
+const errors_1 = require("./errors");
+function generateAppId() {
+    return (0, crypto_1.randomUUID)();
+}
+function validateClientConfig(config) {
+    if (!config.username || typeof config.username !== 'string') {
+        throw new errors_1.SogniValidationError('Username is required and must be a string');
+    }
+    if (!config.password || typeof config.password !== 'string') {
+        throw new errors_1.SogniValidationError('Password is required and must be a string');
+    }
+    if (config.network && !['fast', 'relaxed'].includes(config.network)) {
+        throw new errors_1.SogniValidationError('Network must be either "fast" or "relaxed"');
+    }
+    if (config.timeout !== undefined && (typeof config.timeout !== 'number' || config.timeout <= 0)) {
+        throw new errors_1.SogniValidationError('Timeout must be a positive number');
+    }
+    if (config.reconnectInterval !== undefined && (typeof config.reconnectInterval !== 'number' || config.reconnectInterval <= 0)) {
+        throw new errors_1.SogniValidationError('Reconnect interval must be a positive number');
+    }
+}
+function validateProjectConfig(config) {
+    if (!config.modelId || typeof config.modelId !== 'string') {
+        throw new errors_1.SogniValidationError('Model ID is required and must be a string');
+    }
+    if (!config.positivePrompt || typeof config.positivePrompt !== 'string') {
+        throw new errors_1.SogniValidationError('Positive prompt is required and must be a string');
+    }
+    if (config.numberOfImages !== undefined) {
+        if (typeof config.numberOfImages !== 'number' || config.numberOfImages < 1 || config.numberOfImages > 10) {
+            throw new errors_1.SogniValidationError('Number of images must be between 1 and 10');
+        }
+    }
+    if (config.steps !== undefined) {
+        if (typeof config.steps !== 'number' || config.steps < 1 || config.steps > 100) {
+            throw new errors_1.SogniValidationError('Steps must be between 1 and 100');
+        }
+    }
+    if (config.guidance !== undefined) {
+        if (typeof config.guidance !== 'number' || config.guidance < 0 || config.guidance > 30) {
+            throw new errors_1.SogniValidationError('Guidance must be between 0 and 30');
+        }
+    }
+    if (config.width !== undefined) {
+        if (typeof config.width !== 'number' || config.width < 256 || config.width > 2048) {
+            throw new errors_1.SogniValidationError('Width must be between 256 and 2048');
+        }
+    }
+    if (config.height !== undefined) {
+        if (typeof config.height !== 'number' || config.height < 256 || config.height > 2048) {
+            throw new errors_1.SogniValidationError('Height must be between 256 and 2048');
+        }
+    }
+    if (config.tokenType && !['sogni', 'spark'].includes(config.tokenType)) {
+        throw new errors_1.SogniValidationError('Token type must be either "sogni" or "spark"');
+    }
+    if (config.outputFormat && !['png', 'jpg'].includes(config.outputFormat)) {
+        throw new errors_1.SogniValidationError('Output format must be either "png" or "jpg"');
+    }
+}
+function createTimeoutPromise(timeoutMs, errorMessage = 'Operation timed out') {
+    return new Promise((_, reject) => {
+        setTimeout(() => {
+            reject(new Error(errorMessage));
+        }, timeoutMs);
+    });
+}
+async function waitFor(condition, options = {}) {
+    const { timeout = 30000, interval = 100, timeoutMessage = 'Wait condition timed out' } = options;
+    const startTime = Date.now();
+    while (true) {
+        const result = await Promise.resolve(condition());
+        if (result) {
+            return;
+        }
+        if (Date.now() - startTime >= timeout) {
+            throw new Error(timeoutMessage);
+        }
+        await sleep(interval);
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function retry(fn, options = {}) {
+    const { maxAttempts = 3, initialDelay = 1000, maxDelay = 10000, backoffFactor = 2, onRetry, } = options;
+    let lastError;
+    let delay = initialDelay;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt === maxAttempts) {
+                throw lastError;
+            }
+            if (onRetry) {
+                onRetry(attempt, lastError);
+            }
+            await sleep(delay);
+            delay = Math.min(delay * backoffFactor, maxDelay);
+        }
+    }
+    throw lastError;
+}
+function formatBytes(bytes, decimals = 2) {
+    if (bytes === 0)
+        return '0 Bytes';
+    const k = 1024;
+    const dm = decimals < 0 ? 0 : decimals;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return parseFloat((bytes / Math.pow(k, i)).toFixed(dm)) + ' ' + sizes[i];
+}
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    if (hours > 0) {
+        return `${hours}h ${minutes % 60}m`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${seconds % 60}s`;
+    }
+    return `${seconds}s`;
+}
+function deepClone(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+function isPlainObject(value) {
+    return value !== null && typeof value === 'object' && value.constructor === Object;
+}
+function deepMerge(target, ...sources) {
+    if (!sources.length)
+        return target;
+    const source = sources.shift();
+    if (!source)
+        return target;
+    if (isPlainObject(target) && isPlainObject(source)) {
+        for (const key in source) {
+            if (isPlainObject(source[key])) {
+                if (!target[key])
+                    Object.assign(target, { [key]: {} });
+                deepMerge(target[key], source[key]);
+            }
+            else {
+                Object.assign(target, { [key]: source[key] });
+            }
+        }
+    }
+    return deepMerge(target, ...sources);
+}
+function sanitizeForLog(str, keysToHide = ['password', 'apiKey', 'token']) {
+    let sanitized = str;
+    keysToHide.forEach(key => {
+        const regex = new RegExp(`(${key}["\']?\\s*[:=]\\s*["\']?)([^"',}\\s]+)`, 'gi');
+        sanitized = sanitized.replace(regex, '$1***');
+    });
+    return sanitized;
+}
+function debounce(func, waitMs) {
+    let timeoutId = null;
+    return function (...args) {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+        }
+        timeoutId = setTimeout(() => {
+            func.apply(this, args);
+        }, waitMs);
+    };
+}
+function throttle(func, limitMs) {
+    let inThrottle = false;
+    return function (...args) {
+        if (!inThrottle) {
+            func.apply(this, args);
+            inThrottle = true;
+            setTimeout(() => {
+                inThrottle = false;
+            }, limitMs);
+        }
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/utils/helpers.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@sogni-ai/sogni-client-wrapper",
+  "version": "1.0.0",
+  "description": "Enhanced Node.js wrapper for Sogni AI SDK with n8n compatibility and improved developer experience",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build",
+    "test": "tsx test/basic-tests.ts",
+    "test:e2e": "tsx test/e2e-test.ts",
+    "test:all": "npm run test && npm run test:e2e"
+  },
+  "keywords": [
+    "sogni",
+    "ai",
+    "image-generation",
+    "n8n",
+    "workflow",
+    "automation",
+    "depin",
+    "stable-diffusion",
+    "flux"
+  ],
+  "author": "Sogni AI",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sogni-ai/sogni-client-wrapper.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sogni-ai/sogni-client-wrapper/issues"
+  },
+  "homepage": "https://github.com/sogni-ai/sogni-client-wrapper#readme",
+  "dependencies": {
+    "@sogni-ai/sogni-client": "latest"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "dotenv": "^17.2.3",
+    "tsx": "^4.20.6",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ]
+}