@tuteliq/sdk 2.1.0

package/dist/utils/retry.js

@@ -0,0 +1,61 @@
+import { RateLimitError, ServerError, NetworkError, TimeoutError } from '../errors.js';
+const DEFAULT_OPTIONS = {
+    maxRetries: 3,
+    initialDelay: 1000,
+    maxDelay: 30000,
+    backoffMultiplier: 2,
+    isRetryable: defaultIsRetryable,
+};
+function defaultIsRetryable(error) {
+    // Retry on rate limit, server errors, network errors, and timeouts
+    if (error instanceof RateLimitError)
+        return true;
+    if (error instanceof ServerError)
+        return true;
+    if (error instanceof NetworkError)
+        return true;
+    if (error instanceof TimeoutError)
+        return true;
+    // Retry on fetch errors (network issues)
+    if (error instanceof TypeError && error.message.includes('fetch'))
+        return true;
+    return false;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function calculateDelay(attempt, options) {
+    const delay = options.initialDelay * Math.pow(options.backoffMultiplier, attempt);
+    // Add jitter (0-25% of delay)
+    const jitter = delay * Math.random() * 0.25;
+    return Math.min(delay + jitter, options.maxDelay);
+}
+/**
+ * Execute a function with exponential backoff retry
+ */
+export async function withRetry(fn, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    let lastError;
+    for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            // Check if we should retry
+            if (attempt >= opts.maxRetries || !opts.isRetryable(error)) {
+                throw error;
+            }
+            // Handle rate limit with retry-after header
+            if (error instanceof RateLimitError && error.retryAfter) {
+                await sleep(error.retryAfter * 1000);
+            }
+            else {
+                const delay = calculateDelay(attempt, opts);
+                await sleep(delay);
+            }
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAevF,MAAM,eAAe,GAA2B;IAC5C,UAAU,EAAE,CAAC;IACb,YAAY,EAAE,IAAI;IAClB,QAAQ,EAAE,KAAK;IACf,iBAAiB,EAAE,CAAC;IACpB,WAAW,EAAE,kBAAkB;CAClC,CAAC;AAEF,SAAS,kBAAkB,CAAC,KAAc;IACtC,mEAAmE;IACnE,IAAI,KAAK,YAAY,cAAc;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,KAAK,YAAY,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,KAAK,YAAY,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,KAAK,YAAY,YAAY;QAAE,OAAO,IAAI,CAAC;IAE/C,yCAAyC;IACzC,IAAI,KAAK,YAAY,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAE/E,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACrB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,OAA+B;IACpE,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAClF,8BAA8B;IAC9B,MAAM,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC3B,EAAoB,EACpB,UAAiC,EAAE;IAEnC,MAAM,IAAI,GAA2B,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IAExE,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QAC1D,IAAI,CAAC;YACD,OAAO,MAAM,EAAE,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,SAAS,GAAG,KAAK,CAAC;YAElB,2BAA2B;YAC3B,IAAI,OAAO,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzD,MAAM,KAAK,CAAC;YAChB,CAAC;YAED,4CAA4C;YAC5C,IAAI,KAAK,YAAY,cAAc,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACtD,MAAM,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACJ,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC5C,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;QACL,CAAC;IACL,CAAC;IAED,MAAM,SAAS,CAAC;AACpB,CAAC"}

package/dist/voice-stream.d.ts

@@ -0,0 +1,16 @@
+import type { VoiceStreamConfig, VoiceStreamHandlers, VoiceStreamSession } from './types/voice-stream.js';
+/**
+ * Creates a voice streaming session over WebSocket.
+ *
+ * Requires the `ws` package to be installed:
+ * ```bash
+ * npm install ws
+ * ```
+ *
+ * @param apiKey - Tuteliq API key for authentication
+ * @param config - Optional session configuration
+ * @param handlers - Optional event handler callbacks
+ * @returns A VoiceStreamSession for sending audio and controlling the session
+ */
+export declare function createVoiceStream(apiKey: string, config?: VoiceStreamConfig, handlers?: VoiceStreamHandlers): VoiceStreamSession;
+//# sourceMappingURL=voice-stream.d.ts.map

package/dist/voice-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-stream.d.ts","sourceRoot":"","sources":["../src/voice-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAGrB,MAAM,yBAAyB,CAAC;AAKjC;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,iBAAiB,EAC1B,QAAQ,CAAC,EAAE,mBAAmB,GAC/B,kBAAkB,CAqJpB"}

package/dist/voice-stream.js

@@ -0,0 +1,148 @@
+/** WebSocket URL for voice streaming */
+const VOICE_STREAM_URL = 'wss://api.tuteliq.ai/voice/stream';
+/**
+ * Creates a voice streaming session over WebSocket.
+ *
+ * Requires the `ws` package to be installed:
+ * ```bash
+ * npm install ws
+ * ```
+ *
+ * @param apiKey - Tuteliq API key for authentication
+ * @param config - Optional session configuration
+ * @param handlers - Optional event handler callbacks
+ * @returns A VoiceStreamSession for sending audio and controlling the session
+ */
+export function createVoiceStream(apiKey, config, handlers) {
+    let ws = null;
+    let sessionId = null;
+    let active = false;
+    let summaryResolve = null;
+    let summaryReject = null;
+    // Dynamically import ws
+    let WebSocketCtor = null;
+    const init = async () => {
+        try {
+            const wsModule = await import('ws');
+            WebSocketCtor = wsModule.default || wsModule.WebSocket;
+        }
+        catch {
+            throw new Error('The "ws" package is required for voice streaming. ' +
+                'Install it with: npm install ws');
+        }
+        return new Promise((resolve, reject) => {
+            ws = new WebSocketCtor(VOICE_STREAM_URL, {
+                headers: {
+                    'Authorization': `Bearer ${apiKey}`,
+                },
+            });
+            ws.on('open', () => {
+                active = true;
+                // Send initial config if provided
+                if (config) {
+                    const configMsg = {
+                        type: 'config',
+                        interval_seconds: config.intervalSeconds,
+                        analysis_types: config.analysisTypes,
+                        context: config.context,
+                    };
+                    ws.send(JSON.stringify(configMsg));
+                }
+            });
+            ws.on('message', (data) => {
+                try {
+                    const text = data.toString();
+                    const event = JSON.parse(text);
+                    switch (event.type) {
+                        case 'ready':
+                            sessionId = event.session_id;
+                            handlers?.onReady?.(event);
+                            resolve();
+                            break;
+                        case 'transcription':
+                            handlers?.onTranscription?.(event);
+                            break;
+                        case 'alert':
+                            handlers?.onAlert?.(event);
+                            break;
+                        case 'session_summary':
+                            handlers?.onSessionSummary?.(event);
+                            summaryResolve?.(event);
+                            summaryResolve = null;
+                            summaryReject = null;
+                            break;
+                        case 'config_updated':
+                            handlers?.onConfigUpdated?.(event);
+                            break;
+                        case 'error':
+                            handlers?.onError?.(event);
+                            break;
+                    }
+                }
+                catch {
+                    // Ignore non-JSON messages (e.g. pong frames)
+                }
+            });
+            ws.on('close', (code, reason) => {
+                active = false;
+                const reasonStr = reason.toString();
+                handlers?.onClose?.(code, reasonStr);
+                if (summaryReject) {
+                    summaryReject(new Error(`Connection closed before session summary (code: ${code})`));
+                    summaryResolve = null;
+                    summaryReject = null;
+                }
+            });
+            ws.on('error', (err) => {
+                active = false;
+                reject(err);
+            });
+        });
+    };
+    // Start connection immediately
+    const ready = init();
+    const session = {
+        sendAudio(data) {
+            if (!ws || !active) {
+                throw new Error('Voice stream is not connected');
+            }
+            ws.send(data);
+        },
+        updateConfig(newConfig) {
+            if (!ws || !active) {
+                throw new Error('Voice stream is not connected');
+            }
+            const configMsg = {
+                type: 'config',
+                interval_seconds: newConfig.intervalSeconds,
+                analysis_types: newConfig.analysisTypes,
+                context: newConfig.context,
+            };
+            ws.send(JSON.stringify(configMsg));
+        },
+        async end() {
+            await ready;
+            if (!ws || !active) {
+                throw new Error('Voice stream is not connected');
+            }
+            return new Promise((resolve, reject) => {
+                summaryResolve = resolve;
+                summaryReject = reject;
+                ws.send(JSON.stringify({ type: 'end' }));
+            });
+        },
+        close() {
+            active = false;
+            ws?.close();
+            ws = null;
+        },
+        get sessionId() {
+            return sessionId;
+        },
+        get isActive() {
+            return active;
+        },
+    };
+    return session;
+}
+//# sourceMappingURL=voice-stream.js.map

package/dist/voice-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-stream.js","sourceRoot":"","sources":["../src/voice-stream.ts"],"names":[],"mappings":"AAQA,wCAAwC;AACxC,MAAM,gBAAgB,GAAG,mCAAmC,CAAC;AAE7D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAC7B,MAAc,EACd,MAA0B,EAC1B,QAA8B;IAE9B,IAAI,EAAE,GAAkC,IAAI,CAAC;IAC7C,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,cAAc,GAAuD,IAAI,CAAC;IAC9E,IAAI,aAAa,GAAoC,IAAI,CAAC;IAE1D,wBAAwB;IACxB,IAAI,aAAa,GAAyC,IAAI,CAAC;IAE/D,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;QACpB,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YACpC,aAAa,GAAG,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACL,MAAM,IAAI,KAAK,CACX,oDAAoD;gBACpD,iCAAiC,CACpC,CAAC;QACN,CAAC;QAED,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzC,EAAE,GAAG,IAAI,aAAc,CAAC,gBAAgB,EAAE;gBACtC,OAAO,EAAE;oBACL,eAAe,EAAE,UAAU,MAAM,EAAE;iBACtC;aACJ,CAAC,CAAC;YAEH,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;gBACf,MAAM,GAAG,IAAI,CAAC;gBAEd,kCAAkC;gBAClC,IAAI,MAAM,EAAE,CAAC;oBACT,MAAM,SAAS,GAAG;wBACd,IAAI,EAAE,QAAQ;wBACd,gBAAgB,EAAE,MAAM,CAAC,eAAe;wBACxC,cAAc,EAAE,MAAM,CAAC,aAAa;wBACpC,OAAO,EAAE,MAAM,CAAC,OAAO;qBAC1B,CAAC;oBACF,EAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;gBACxC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAqC,EAAE,EAAE;gBACvD,IAAI,CAAC;oBACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAC7B,MAAM,KAAK,GAAqB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAEjD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;wBACjB,KAAK,OAAO;4BACR,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC;4BAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;4BAC3B,OAAO,EAAE,CAAC;4BACV,MAAM;wBACV,KAAK,eAAe;4BAChB,QAAQ,EAAE,eAAe,EAAE,CAAC,KAAK,CAAC,CAAC;4BACnC,MAAM;wBACV,KAAK,OAAO;4BACR,QAAQ,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;4BAC3B,MAAM;wBACV,KAAK,iBAAiB;4BAClB,QAAQ,EAAE,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAC;4BACpC,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC;4BACxB,cAAc,GAAG,IAAI,CAAC;4BACtB,aAAa,GAAG,IAAI,CAAC;4BACrB,MAAM;wBACV,KAAK,gBAAgB;4BACjB,QAAQ,EAAE,eAAe,EAAE,CAAC,KAAK,CAAC,CAAC;4BACnC,MAAM;wBACV,KAAK,OAAO;4BACR,QAAQ,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;4BAC3B,MAAM;oBACd,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACL,8CAA8C;gBAClD,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAY,EAAE,MAAc,EAAE,EAAE;gBAC5C,MAAM,GAAG,KAAK,CAAC;gBACf,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpC,QAAQ,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAErC,IAAI,aAAa,EAAE,CAAC;oBAChB,aAAa,CAAC,IAAI,KAAK,CAAC,mDAAmD,IAAI,GAAG,CAAC,CAAC,CAAC;oBACrF,cAAc,GAAG,IAAI,CAAC;oBACtB,aAAa,GAAG,IAAI,CAAC;gBACzB,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;gBAC1B,MAAM,GAAG,KAAK,CAAC;gBACf,MAAM,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IAEF,+BAA+B;IAC/B,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;IAErB,MAAM,OAAO,GAAuB;QAChC,SAAS,CAAC,IAAyB;YAC/B,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACrD,CAAC;YACD,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QAED,YAAY,CAAC,SAA4B;YACrC,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACrD,CAAC;YACD,MAAM,SAAS,GAAG;gBACd,IAAI,EAAE,QAAQ;gBACd,gBAAgB,EAAE,SAAS,CAAC,eAAe;gBAC3C,cAAc,EAAE,SAAS,CAAC,aAAa;gBACvC,OAAO,EAAE,SAAS,CAAC,OAAO;aAC7B,CAAC;YACF,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,GAAG;YACL,MAAM,KAAK,CAAC;YACZ,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACrD,CAAC;YACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACnC,cAAc,GAAG,OAAO,CAAC;gBACzB,aAAa,GAAG,MAAM,CAAC;gBACvB,EAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAC9C,CAAC,CAAC,CAAC;QACP,CAAC;QAED,KAAK;YACD,MAAM,GAAG,KAAK,CAAC;YACf,EAAE,EAAE,KAAK,EAAE,CAAC;YACZ,EAAE,GAAG,IAAI,CAAC;QACd,CAAC;QAED,IAAI,SAAS;YACT,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,IAAI,QAAQ;YACR,OAAO,MAAM,CAAC;QAClB,CAAC;KACJ,CAAC;IAEF,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@tuteliq/sdk",
+  "version": "2.1.0",
+  "description": "TypeScript SDK for Tuteliq AI child safety API - Detect bullying, grooming, and unsafe content",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./constants": {
+      "import": "./dist/constants.js",
+      "require": "./dist/cjs/constants.js",
+      "types": "./dist/constants.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types/index.js",
+      "require": "./dist/cjs/types/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && tsc -p tsconfig.cjs.json",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "tuteliq",
+    "child-safety",
+    "content-moderation",
+    "bullying-detection",
+    "grooming-detection",
+    "ai",
+    "sdk",
+    "typescript",
+    "parental-control",
+    "online-safety"
+  ],
+  "author": "Tuteliq <hello@tuteliq.ai>",
+  "license": "MIT",
+  "homepage": "https://tuteliq.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Tuteliq/node.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Tuteliq/node/issues",
+    "email": "support@tuteliq.ai"
+  },
+  "peerDependencies": {
+    "ws": ">=8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "ws": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.1",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8",
+    "ws": "^8.18.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}