tale-js-sdk 0.1.2 → 0.1.4

package/dist/auth.js

@@ -1,461 +0,0 @@
-import { ApiError, ConfigurationError, NetworkError } from './errors.js';
-/**
- * Authenticates a user with username and password.
- *
- * @param credentials - User login credentials
- * @param options - Optional configuration for the login request
- * @returns Promise resolving to login response with user info and token
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When authentication fails or returns invalid response
- * @throws {NetworkError} When network request fails
- *
- * @example
- * ```typescript
- * import { login } from '@tale/client';
- *
- * try {
- *   const result = await login({
- *     username: 'johndoe',
- *     password: 'secure_password_123'
- *   });
- *   console.log('Login successful:', result.user.username);
- *   console.log('User token:', result.token.token);
- * } catch (error) {
- *   console.error('Login failed:', error.message);
- * }
- * ```
- */
-export async function login(credentials, options) {
-    // Validate required fields
-    if (!credentials.username || credentials.username.trim() === '') {
-        throw new ApiError('username is required', 400, '9400');
-    }
-    if (!credentials.password || credentials.password.trim() === '') {
-        throw new ApiError('password is required', 400, '9400');
-    }
-    // Determine base URL
-    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
-    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
-    if (!base) {
-        throw new ConfigurationError('Missing required environment variable: TALE_BASE_URL');
-    }
-    // Determine app key
-    const appKey = credentials.app_key ?? options?.appKey ?? env?.TALE_APP_KEY ?? undefined;
-    if (!appKey) {
-        throw new ConfigurationError('Missing required app_key or TALE_APP_KEY');
-    }
-    const url = String(base).replace(/\/+$/, '') + '/auth/v1/login/username-password';
-    // Build request body
-    const requestBody = {
-        username: credentials.username.trim(),
-        password: credentials.password,
-        app_key: appKey,
-        device_name: options?.device_name,
-        device_fingerprint: options?.device_fingerprint,
-        scope: options?.scope || ''
-    };
-    let response;
-    try {
-        response = await globalThis.fetch(url, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify(requestBody),
-        });
-    }
-    catch (error) {
-        throw new NetworkError(`Failed to authenticate user: ${error instanceof Error ? error.message : 'Unknown error'}`);
-    }
-    let json;
-    try {
-        const responseJson = await response.json();
-        json = responseJson;
-    }
-    catch (error) {
-        throw new ApiError(`Failed to parse login response: ${error instanceof Error ? error.message : 'Invalid JSON'}`, response.status);
-    }
-    // Handle authentication errors based on response status
-    if (response.status === 400) {
-        const errorMsg = typeof json === 'object' && json !== null && 'message' in json ?
-            String(json.message) : 'Authentication failed';
-        throw new ApiError(errorMsg, response.status, '9400');
-    }
-    if (response.status === 403) {
-        throw new ApiError('Account is frozen or access forbidden', response.status, '9403');
-    }
-    if (response.status === 401) {
-        throw new ApiError('Invalid app_key or authentication failed', response.status, '9401');
-    }
-    if (!response.ok) {
-        const errorMsg = typeof json === 'object' && json !== null && 'message' in json ?
-            String(json.message) : 'Authentication failed';
-        throw new ApiError(errorMsg, response.status);
-    }
-    // Validate response structure
-    if (!json || !json.user || !json.token) {
-        throw new ApiError('Invalid login response: missing required data', response.status);
-    }
-    // Build standard response structure
-    const loginResponse = {
-        app: json.app,
-        user: json.user,
-        token: json.token,
-        user_roles: json.user_roles || [],
-        user_privileges: json.user_privileges || [],
-        user_groups: json.user_groups || [],
-        user_login_methods: json.user_login_methods || []
-    };
-    return loginResponse;
-}
-/**
- * Validates a user token.
- *
- * @param token - User token to validate
- * @param options - Optional configuration for validation
- * @returns Promise resolving to validation result
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When validation fails
- * @throws {NetworkError} When network request fails
- *
- * @example
- * ```typescript
- * import { validateToken } from '@tale/client';
- *
- * try {
- *   const result = await validateToken('tu_user_token_here');
- *   console.log('Token is valid');
- * } catch (error) {
- *   console.error('Token validation failed:', error.message);
- * }
- * ```
- */
-export async function validateToken(token, options) {
-    // Validate required fields
-    if (!token || token.trim() === '') {
-        throw new ApiError('token is required', 400, '9400');
-    }
-    // Determine base URL
-    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
-    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
-    if (!base) {
-        throw new ConfigurationError('Missing required environment variable: TALE_BASE_URL');
-    }
-    const url = new URL(String(base).replace(/\/+$/, '') + '/auth/v1/assert_token');
-    url.searchParams.append('token', token.trim());
-    if (options?.scope) {
-        url.searchParams.append('scope', options.scope);
-    }
-    let response;
-    try {
-        response = await globalThis.fetch(url.toString(), {
-            method: 'GET',
-            headers: {
-                'Content-Type': 'application/json',
-            },
-        });
-    }
-    catch (error) {
-        throw new NetworkError(`Failed to validate token: ${error instanceof Error ? error.message : 'Unknown error'}`);
-    }
-    // Token is valid if we get a 200 response
-    return response.ok;
-}
-/**
- * Sends SMS verification code for login or registration.
- *
- * @param phone - Phone number for sending SMS
- * @param options - Optional configuration for the request
- * @returns Promise resolving to SMS sending response
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When SMS sending fails or returns invalid response
- * @throws {NetworkError} When network request fails
- *
- * @example
- * ```typescript
- * import { sendSmsVerification } from '@tale/client';
- *
- * try {
- *   const result = await sendSmsVerification('+8613800138000');
- *   console.log('SMS sent:', result.sms_id);
- *   console.log('Type:', result.type); // 'login' or 'register'
- * } catch (error) {
- *   console.error('SMS sending failed:', error.message);
- * }
- * ```
- */
-export async function sendSmsVerification(phone, options) {
-    // Validate required fields
-    if (!phone || phone.trim() === '') {
-        throw new ApiError('phone number is required', 400, '9400');
-    }
-    // Determine base URL
-    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
-    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
-    if (!base) {
-        throw new ConfigurationError('Missing required environment variable: TALE_BASE_URL');
-    }
-    // Determine app key
-    const appKey = options?.appKey ?? env?.TALE_APP_KEY ?? undefined;
-    if (!appKey) {
-        throw new ConfigurationError('Missing required app_key or TALE_APP_KEY');
-    }
-    const url = new URL(String(base).replace(/\/+$/, '') + '/auth/v1/sms/login_or_register');
-    url.searchParams.append('phone', phone.trim());
-    let response;
-    try {
-        response = await globalThis.fetch(url.toString(), {
-            method: 'GET',
-            headers: {
-                'Authorization': `Bearer ${appKey}`,
-                'Content-Type': 'application/json',
-            },
-        });
-    }
-    catch (error) {
-        throw new NetworkError(`Failed to send SMS verification: ${error instanceof Error ? error.message : 'Unknown error'}`);
-    }
-    let json;
-    try {
-        const responseJson = await response.json();
-        json = responseJson;
-    }
-    catch (error) {
-        throw new ApiError(`Failed to parse SMS response: ${error instanceof Error ? error.message : 'Invalid JSON'}`, response.status);
-    }
-    // Handle API errors
-    if (response.status === 400) {
-        const errorMsg = typeof json === 'object' && json !== null && 'message' in json ?
-            String(json.message) : 'Invalid phone number format';
-        throw new ApiError(errorMsg, response.status, '9400');
-    }
-    if (response.status === 429) {
-        throw new ApiError('SMS sending rate limit exceeded', response.status, '9705');
-    }
-    if (!response.ok) {
-        const errorMsg = typeof json === 'object' && json !== null && 'message' in json ?
-            String(json.message) : 'SMS sending failed';
-        throw new ApiError(errorMsg, response.status);
-    }
-    // Validate response structure
-    if (!json || !json.sms_id || !json.type) {
-        throw new ApiError('Invalid SMS response: missing required data', response.status);
-    }
-    return {
-        app_key: json.app_key,
-        phone: json.phone,
-        type: json.type,
-        sms_id: json.sms_id,
-        expired_at: json.expired_at
-    };
-}
-/**
- * Verifies SMS code and authenticates user (login or register).
- *
- * @param request - SMS verification request with sms_id, code, and optional user data
- * @param options - Optional configuration for the request
- * @returns Promise resolving to login response with user info and token
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When verification fails or returns invalid response
- * @throws {NetworkError} When network request fails
- *
- * @example
- * ```typescript
- * import { verifySmsCode } from '@tale/client';
- *
- * try {
- *   const result = await verifySmsCode({
- *     sms_id: 'uuid-here',
- *     sms_type: 'login',
- *     verification_code: '123456'
- *   });
- *   console.log('Login successful:', result.user.user_id);
- *   console.log('User token:', result.token.token);
- * } catch (error) {
- *   console.error('SMS verification failed:', error.message);
- * }
- * ```
- */
-export async function verifySmsCode(request, options) {
-    // Validate required fields
-    if (!request.sms_id || request.sms_id.trim() === '') {
-        throw new ApiError('sms_id is required', 400, '9400');
-    }
-    if (!request.sms_type || !['login', 'register'].includes(request.sms_type)) {
-        throw new ApiError('sms_type must be "login" or "register"', 400, '9400');
-    }
-    if (!request.verification_code || request.verification_code.trim() === '') {
-        throw new ApiError('verification_code is required', 400, '9400');
-    }
-    // Determine base URL
-    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
-    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
-    if (!base) {
-        throw new ConfigurationError('Missing required environment variable: TALE_BASE_URL');
-    }
-    // Determine app key
-    const appKey = options?.appKey ?? env?.TALE_APP_KEY ?? undefined;
-    if (!appKey) {
-        throw new ConfigurationError('Missing required app_key or TALE_APP_KEY');
-    }
-    const url = new URL(String(base).replace(/\/+$/, '') + '/auth/v1/sms/verify');
-    url.searchParams.append('sms_id', request.sms_id.trim());
-    url.searchParams.append('sms_type', request.sms_type);
-    url.searchParams.append('verification_code', request.verification_code.trim());
-    let response;
-    try {
-        response = await globalThis.fetch(url.toString(), {
-            method: 'GET',
-            headers: {
-                'Authorization': `Bearer ${appKey}`,
-                'Content-Type': 'application/json',
-            },
-        });
-    }
-    catch (error) {
-        throw new NetworkError(`Failed to verify SMS code: ${error instanceof Error ? error.message : 'Unknown error'}`);
-    }
-    let json;
-    try {
-        const responseJson = await response.json();
-        json = responseJson;
-    }
-    catch (error) {
-        throw new ApiError(`Failed to parse SMS verification response: ${error instanceof Error ? error.message : 'Invalid JSON'}`, response.status);
-    }
-    // Handle verification errors
-    if (response.status === 400) {
-        const errorMsg = typeof json === 'object' && json !== null && 'message' in json ?
-            String(json.message) : 'SMS verification failed';
-        throw new ApiError(errorMsg, response.status, '9739');
-    }
-    if (response.status === 403) {
-        throw new ApiError('Account is frozen or access forbidden', response.status, '9403');
-    }
-    if (!response.ok) {
-        const errorMsg = typeof json === 'object' && json !== null && 'message' in json ?
-            String(json.message) : 'SMS verification failed';
-        throw new ApiError(errorMsg, response.status);
-    }
-    // Validate response structure
-    if (!json || !json.user || !json.token) {
-        throw new ApiError('Invalid SMS verification response: missing required data', response.status);
-    }
-    // Build standard response structure
-    const smsLoginResponse = {
-        app: json.app,
-        user: json.user,
-        token: json.token,
-        user_roles: json.user_roles || [],
-        user_privileges: json.user_privileges || [],
-        user_groups: json.user_groups || [],
-        user_login_methods: json.user_login_methods || []
-    };
-    return smsLoginResponse;
-}
-/**
- * Registers a new user with SMS verification and optional additional information.
- *
- * @param request - Registration request with SMS verification and optional user data
- * @param options - Optional configuration for the request
- * @returns Promise resolving to registration response with user info and token
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When registration fails or returns invalid response
- * @throws {NetworkError} When network request fails
- *
- * @example
- * ```typescript
- * import { registerWithSms } from '@tale/client';
- *
- * try {
- *   const result = await registerWithSms({
- *     sms_id: 'uuid-here',
- *     sms_type: 'register',
- *     verification_code: '123456',
- *     username: 'newuser',
- *     password_encrypted: 'encrypted_password'
- *   });
- *   console.log('Registration successful:', result.user.user_id);
- *   console.log('User token:', result.token.token);
- * } catch (error) {
- *   console.error('Registration failed:', error.message);
- * }
- * ```
- */
-export async function registerWithSms(request, options) {
-    // Validate required fields for registration
-    if (request.sms_type !== 'register') {
-        throw new ApiError('sms_type must be "register" for registration', 400, '9400');
-    }
-    // Determine base URL
-    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
-    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
-    if (!base) {
-        throw new ConfigurationError('Missing required environment variable: TALE_BASE_URL');
-    }
-    // Determine app key
-    const appKey = options?.appKey ?? env?.TALE_APP_KEY ?? undefined;
-    if (!appKey) {
-        throw new ConfigurationError('Missing required app_key or TALE_APP_KEY');
-    }
-    const url = String(base).replace(/\/+$/, '') + '/auth/v1/sms/register/verify';
-    // Build request body
-    const requestBody = {
-        sms_id: request.sms_id.trim(),
-        sms_type: request.sms_type,
-        verification_code: request.verification_code.trim(),
-        username: request.username?.trim(),
-        password_encrypted: request.password_encrypted
-    };
-    let response;
-    try {
-        response = await globalThis.fetch(url, {
-            method: 'POST',
-            headers: {
-                'Authorization': `Bearer ${appKey}`,
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify(requestBody),
-        });
-    }
-    catch (error) {
-        throw new NetworkError(`Failed to register with SMS: ${error instanceof Error ? error.message : 'Unknown error'}`);
-    }
-    let json;
-    try {
-        const responseJson = await response.json();
-        json = responseJson;
-    }
-    catch (error) {
-        throw new ApiError(`Failed to parse registration response: ${error instanceof Error ? error.message : 'Invalid JSON'}`, response.status);
-    }
-    // Handle registration errors
-    if (response.status === 400) {
-        const errorMsg = typeof json === 'object' && json !== null && 'message' in json ?
-            String(json.message) : 'SMS registration failed';
-        throw new ApiError(errorMsg, response.status, '9739');
-    }
-    if (response.status === 403) {
-        throw new ApiError('Account is frozen or access forbidden', response.status, '9403');
-    }
-    if (!response.ok) {
-        const errorMsg = typeof json === 'object' && json !== null && 'message' in json ?
-            String(json.message) : 'SMS registration failed';
-        throw new ApiError(errorMsg, response.status);
-    }
-    // Validate response structure
-    if (!json || !json.user || !json.token) {
-        throw new ApiError('Invalid registration response: missing required data', response.status);
-    }
-    // Build standard response structure
-    const registrationResponse = {
-        app: json.app,
-        user: json.user,
-        token: json.token,
-        user_roles: json.user_roles || [],
-        user_privileges: json.user_privileges || [],
-        user_groups: json.user_groups || [],
-        user_login_methods: json.user_login_methods || []
-    };
-    return registrationResponse;
-}

package/dist/client.d.ts

@@ -1,20 +0,0 @@
-export type TaleClientOptions = {
-    baseUrl?: string;
-    appKey?: string;
-    appSecret?: string;
-};
-export declare class TaleClient {
-    baseUrl: string;
-    appKey: string;
-    appSecret: string;
-    constructor(opts?: TaleClientOptions);
-    request<T>(method: string, path: string, body?: unknown): Promise<T>;
-    get<T>(path: string): Promise<T>;
-    post<T>(path: string, data: unknown): Promise<T>;
-    put<T>(path: string, data: unknown): Promise<T>;
-    delete<T>(path: string): Promise<T>;
-    health(): Promise<{
-        status: string;
-    }>;
-}
-export declare function createClient(opts?: TaleClientOptions): TaleClient;

package/dist/client.js

@@ -1,62 +0,0 @@
-function readEnv() {
-    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
-    return {
-        baseUrl: env?.TALE_BASE_URL ?? undefined,
-        appKey: env?.TALE_APP_KEY ?? undefined,
-        appSecret: env?.TALE_APP_SECRET ?? undefined,
-    };
-}
-export class TaleClient {
-    constructor(opts = {}) {
-        const env = readEnv();
-        const baseUrl = opts.baseUrl ?? env.baseUrl;
-        const appKey = opts.appKey ?? env.appKey;
-        const appSecret = opts.appSecret ?? env.appSecret;
-        if (!baseUrl || !appKey || !appSecret) {
-            throw new Error("Missing required environment variables: TALE_BASE_URL, TALE_APP_KEY, TALE_APP_SECRET");
-        }
-        this.baseUrl = baseUrl;
-        this.appKey = appKey;
-        this.appSecret = appSecret;
-    }
-    async request(method, path, body) {
-        const url = new URL(path, this.baseUrl).toString();
-        const headers = {
-            "X-Tale-App-Key": this.appKey,
-            "X-Tale-App-Secret": this.appSecret,
-        };
-        const init = { method, headers };
-        if (body !== undefined) {
-            headers["Content-Type"] = "application/json";
-            init.body = JSON.stringify(body);
-        }
-        const res = await fetch(url, init);
-        if (!res.ok) {
-            const text = await res.text();
-            throw new Error(`HTTP ${res.status} ${res.statusText}: ${text}`);
-        }
-        const ct = res.headers.get("content-type") || "";
-        if (ct.includes("application/json")) {
-            return (await res.json());
-        }
-        return (await res.text());
-    }
-    get(path) {
-        return this.request("GET", path);
-    }
-    post(path, data) {
-        return this.request("POST", path, data);
-    }
-    put(path, data) {
-        return this.request("PUT", path, data);
-    }
-    delete(path) {
-        return this.request("DELETE", path);
-    }
-    health() {
-        return this.get("/health");
-    }
-}
-export function createClient(opts = {}) {
-    return new TaleClient(opts);
-}

package/dist/info.d.ts

@@ -1,9 +0,0 @@
-export type SdkStatus = {
-    name: string;
-    version: string;
-    description: string;
-    taleBaseUrl: string;
-    taleAppKey: string;
-    taleAppSecret: string;
-};
-export declare function getSdkStatus(): SdkStatus;

package/dist/info.js

@@ -1,18 +0,0 @@
-import pkg from "../package.json" with { type: "json" };
-export function getSdkStatus() {
-    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
-    const taleBaseUrl = env?.TALE_BASE_URL ?? undefined;
-    const taleAppKey = env?.TALE_APP_KEY ?? undefined;
-    const taleAppSecret = env?.TALE_APP_SECRET ?? undefined;
-    if (!taleBaseUrl || !taleAppKey || !taleAppSecret) {
-        throw new Error("Missing required environment variables: TALE_BASE_URL, TALE_APP_KEY, TALE_APP_SECRET");
-    }
-    return {
-        name: pkg.name,
-        version: pkg.version,
-        description: pkg.description,
-        taleBaseUrl,
-        taleAppKey,
-        taleAppSecret,
-    };
-}

package/dist/package.json

@@ -1,36 +0,0 @@
-{
-    "name": "@tale/client",
-    "version": "0.1.0",
-    "description": "Official TypeScript SDK for Tale backend services",
-    "keywords": [
-        "tale",
-        "sdk",
-        "client",
-        "api",
-        "backend",
-        "typescript"
-    ],
-    "homepage": "https://github.com/turinhub/tale-js-sdk#readme",
-    "bugs": {
-        "url": "https://github.com/turinhub/tale-js-sdk/issues"
-    },
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/turinhub/tale-js-sdk.git"
-    },
-    "license": "MIT",
-    "author": "Turinhub <dev@turinhub.com>",
-    "type": "module",
-    "main": "dist/index.js",
-    "scripts": {
-        "test": "jest",
-        "build": "tsc -p tsconfig.json",
-        "typecheck": "tsc -p tsconfig.json --noEmit"
-    },
-    "devDependencies": {
-        "@types/jest": "^30.0.0",
-        "jest": "^30.2.0",
-        "typescript": "^5.9.3"
-    },
-    "types": "dist/index.d.ts"
-}

package/dist/src/index.d.ts

@@ -1 +0,0 @@
-export * from './info.js';

package/dist/src/index.js

@@ -1 +0,0 @@
-export * from './info.js';

package/dist/src/info.d.ts

@@ -1,6 +0,0 @@
-export type SdkInfo = {
-    name: string;
-    version: string;
-    description?: string;
-};
-export declare function getSdkInfo(): SdkInfo;

package/dist/src/info.js

@@ -1,4 +0,0 @@
-import pkg from '../package.json' with { type: 'json' };
-export function getSdkInfo() {
-    return { name: pkg.name, version: pkg.version, description: pkg.description };
-}