@anythink-cloud/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Anythink Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# @anythink-cloud/sdk
+
+Reusable Typescript SDK for the Anythink platform
+
+## Installation
+
+```bash
+npm install @anythink-cloud/sdk
+# or
+yarn add @anythink-cloud/sdk
+# or
+pnpm add @anythink-cloud/sdk
+```
+
+## Usage
+
+```typescript
+import /* your exports */ from "@anythink-cloud/sdk";
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the package
+npm run build
+
+# Watch mode for development
+npm run dev
+
+# Type checking
+npm run typecheck
+
+# Linting
+npm run lint
+```
+
+## Publishing
+
+```bash
+# Build before publishing
+npm run build
+
+# Publish to npm
+npm publish
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,229 @@
+import * as zustand_middleware from 'zustand/middleware';
+import * as zustand from 'zustand';
+import { AxiosInstance, AxiosRequestConfig } from 'axios';
+
+/**
+ * Token pair structure matching the backend API response
+ */
+interface TokenPair {
+    access_token: string;
+    refresh_token: string;
+    expires_in: number;
+}
+/**
+ * Session structure for internal use
+ */
+interface Session {
+    access_token: string;
+    refresh_token: string;
+    expires_in: number;
+    expires_at: number;
+}
+/**
+ * Configuration for the auth client
+ */
+interface AuthConfig {
+    instanceUrl: string;
+    orgId: number;
+    tokenEndpoint?: string;
+    refreshEndpoint?: string;
+    changePasswordEndpoint?: string;
+    storageKey?: string;
+    onSignOut?: () => void;
+}
+/**
+ * Sign in response
+ */
+interface SignInResponse {
+    data: {
+        session: Session | null;
+    };
+    error: Error | null;
+}
+/**
+ * Refresh response
+ */
+interface RefreshResponse {
+    data: {
+        session: Session | null;
+    };
+    error: Error | null;
+}
+
+interface AuthState {
+    session: Session | null;
+    isLoading: boolean;
+    error: Error | null;
+    setSession: (session: Session | null) => void;
+    signOut: () => void;
+    clearError: () => void;
+    setLoading: (isLoading: boolean) => void;
+    setError: (error: Error | null) => void;
+}
+/**
+ * Creates the auth store with persistence
+ * @param storageKey - Key for localStorage persistence
+ */
+declare const createAuthStore: (storageKey?: string) => zustand.UseBoundStore<Omit<zustand.StoreApi<AuthState>, "setState" | "persist"> & {
+    setState(partial: AuthState | Partial<AuthState> | ((state: AuthState) => AuthState | Partial<AuthState>), replace?: false | undefined): unknown;
+    setState(state: AuthState | ((state: AuthState) => AuthState), replace: true): unknown;
+    persist: {
+        setOptions: (options: Partial<zustand_middleware.PersistOptions<AuthState, unknown, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: AuthState) => void) => () => void;
+        onFinishHydration: (fn: (state: AuthState) => void) => () => void;
+        getOptions: () => Partial<zustand_middleware.PersistOptions<AuthState, unknown, unknown>>;
+    };
+}>;
+
+/**
+ * Auth client for handling authentication with the Anythink API
+ */
+declare class AuthClient {
+    private store;
+    private config;
+    private onSessionChanged?;
+    private axiosClient;
+    constructor(config: AuthConfig & {
+        onSessionChanged?: (session: Session | null) => void;
+    });
+    /**
+     * Set the onSessionChanged handler.
+     * @param handler Callback fired whenever the session changes
+     */
+    setOnSessionChanged(handler: ((session: Session | null) => void) | undefined): void;
+    /**
+     * Internal helper to call the session-changed handler, if present.
+     */
+    private _callSessionChanged;
+    /**
+     * Sign in with email and password
+     * @param email User email
+     * @param password User password
+     * @param orgId Optional organization ID
+     * @returns Session object with tokens
+     */
+    signIn(email: string, password: string, orgId?: number): Promise<SignInResponse>;
+    /**
+     * Register a new user
+     * @param firstName User's first name
+     * @param lastName User's last name
+     * @param email User's email
+     * @param password User's password
+     * @returns Error object or null if successful
+     */
+    register(firstName: string, lastName: string, email: string, password: string): Promise<{
+        error: Error | null;
+    }>;
+    /**
+     * Refresh the access token using the refresh token
+     * @returns Session object with new tokens
+     */
+    refreshSession(): Promise<RefreshResponse>;
+    /**
+     * Get the current session
+     * @returns Session object or null if not authenticated
+     */
+    getSession(): {
+        data: {
+            session: Session | null;
+        };
+    };
+    /**
+     * Set session from tokens (useful for OAuth flows or token exchange)
+     * @param accessToken Access token
+     * @param refreshToken Refresh token
+     * @param expiresIn Expiration time in seconds
+     */
+    setSession({ access_token, refresh_token, expires_in, }: {
+        access_token: string;
+        refresh_token: string;
+        expires_in: number;
+    }): Promise<{
+        error: Error | null;
+    }>;
+    /**
+     * Change the current user's password
+     * @param currentPassword Current password
+     * @param newPassword New password
+     * @returns Error object or null if successful
+     */
+    changePassword(currentPassword: string, newPassword: string): Promise<{
+        error: Error | null;
+    }>;
+    /**
+     * Sign out and clear session
+     */
+    signOut(): Promise<{
+        error: null;
+    }>;
+    /**
+     * Get the current access token
+     */
+    getAccessToken(): string | null;
+    /**
+     * Get the current refresh token
+     */
+    getRefreshToken(): string | null;
+    /**
+     * Check if user is authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Get the Zustand store (for React hooks)
+     */
+    getStore(): ReturnType<typeof createAuthStore>;
+}
+
+/**
+ * Base service class with automatic token injection and refresh handling
+ */
+declare class AuthenticatedBaseService {
+    client: AxiosInstance;
+    private authClient;
+    private instanceUrl;
+    constructor(authClient: AuthClient, instanceUrl: string);
+    /**
+     * Setup request and response interceptors
+     */
+    private setupInterceptors;
+    /**
+     * GET request
+     */
+    protected get<T>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * POST request
+     */
+    protected post<TRequest, TResponse>(url: string, data?: TRequest, config?: AxiosRequestConfig): Promise<TResponse>;
+    /**
+     * POST request with form data
+     */
+    protected postFormData<FormData, TResponse>(url: string, data: FormData): Promise<TResponse>;
+    /**
+     * PUT request
+     */
+    protected put<TRequest, TResponse>(url: string, data?: TRequest, config?: AxiosRequestConfig): Promise<TResponse>;
+    /**
+     * PATCH request
+     */
+    protected patch<TRequest, TResponse>(url: string, data?: TRequest, config?: AxiosRequestConfig): Promise<TResponse>;
+    /**
+     * DELETE request
+     */
+    protected delete<T = void>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Get the underlying Axios instance (for advanced usage)
+     */
+    getClient(): AxiosInstance;
+}
+
+/**
+ * Anythink SDK
+ *
+ * A reusable Typescript SDK for the Anythink platform.
+ */
+declare const version = "0.1.0";
+
+export { AuthClient, type AuthConfig, AuthenticatedBaseService, type RefreshResponse, type Session, type SignInResponse, type TokenPair, createAuthStore, version };

package/dist/index.d.ts

@@ -0,0 +1,229 @@
+import * as zustand_middleware from 'zustand/middleware';
+import * as zustand from 'zustand';
+import { AxiosInstance, AxiosRequestConfig } from 'axios';
+
+/**
+ * Token pair structure matching the backend API response
+ */
+interface TokenPair {
+    access_token: string;
+    refresh_token: string;
+    expires_in: number;
+}
+/**
+ * Session structure for internal use
+ */
+interface Session {
+    access_token: string;
+    refresh_token: string;
+    expires_in: number;
+    expires_at: number;
+}
+/**
+ * Configuration for the auth client
+ */
+interface AuthConfig {
+    instanceUrl: string;
+    orgId: number;
+    tokenEndpoint?: string;
+    refreshEndpoint?: string;
+    changePasswordEndpoint?: string;
+    storageKey?: string;
+    onSignOut?: () => void;
+}
+/**
+ * Sign in response
+ */
+interface SignInResponse {
+    data: {
+        session: Session | null;
+    };
+    error: Error | null;
+}
+/**
+ * Refresh response
+ */
+interface RefreshResponse {
+    data: {
+        session: Session | null;
+    };
+    error: Error | null;
+}
+
+interface AuthState {
+    session: Session | null;
+    isLoading: boolean;
+    error: Error | null;
+    setSession: (session: Session | null) => void;
+    signOut: () => void;
+    clearError: () => void;
+    setLoading: (isLoading: boolean) => void;
+    setError: (error: Error | null) => void;
+}
+/**
+ * Creates the auth store with persistence
+ * @param storageKey - Key for localStorage persistence
+ */
+declare const createAuthStore: (storageKey?: string) => zustand.UseBoundStore<Omit<zustand.StoreApi<AuthState>, "setState" | "persist"> & {
+    setState(partial: AuthState | Partial<AuthState> | ((state: AuthState) => AuthState | Partial<AuthState>), replace?: false | undefined): unknown;
+    setState(state: AuthState | ((state: AuthState) => AuthState), replace: true): unknown;
+    persist: {
+        setOptions: (options: Partial<zustand_middleware.PersistOptions<AuthState, unknown, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: AuthState) => void) => () => void;
+        onFinishHydration: (fn: (state: AuthState) => void) => () => void;
+        getOptions: () => Partial<zustand_middleware.PersistOptions<AuthState, unknown, unknown>>;
+    };
+}>;
+
+/**
+ * Auth client for handling authentication with the Anythink API
+ */
+declare class AuthClient {
+    private store;
+    private config;
+    private onSessionChanged?;
+    private axiosClient;
+    constructor(config: AuthConfig & {
+        onSessionChanged?: (session: Session | null) => void;
+    });
+    /**
+     * Set the onSessionChanged handler.
+     * @param handler Callback fired whenever the session changes
+     */
+    setOnSessionChanged(handler: ((session: Session | null) => void) | undefined): void;
+    /**
+     * Internal helper to call the session-changed handler, if present.
+     */
+    private _callSessionChanged;
+    /**
+     * Sign in with email and password
+     * @param email User email
+     * @param password User password
+     * @param orgId Optional organization ID
+     * @returns Session object with tokens
+     */
+    signIn(email: string, password: string, orgId?: number): Promise<SignInResponse>;
+    /**
+     * Register a new user
+     * @param firstName User's first name
+     * @param lastName User's last name
+     * @param email User's email
+     * @param password User's password
+     * @returns Error object or null if successful
+     */
+    register(firstName: string, lastName: string, email: string, password: string): Promise<{
+        error: Error | null;
+    }>;
+    /**
+     * Refresh the access token using the refresh token
+     * @returns Session object with new tokens
+     */
+    refreshSession(): Promise<RefreshResponse>;
+    /**
+     * Get the current session
+     * @returns Session object or null if not authenticated
+     */
+    getSession(): {
+        data: {
+            session: Session | null;
+        };
+    };
+    /**
+     * Set session from tokens (useful for OAuth flows or token exchange)
+     * @param accessToken Access token
+     * @param refreshToken Refresh token
+     * @param expiresIn Expiration time in seconds
+     */
+    setSession({ access_token, refresh_token, expires_in, }: {
+        access_token: string;
+        refresh_token: string;
+        expires_in: number;
+    }): Promise<{
+        error: Error | null;
+    }>;
+    /**
+     * Change the current user's password
+     * @param currentPassword Current password
+     * @param newPassword New password
+     * @returns Error object or null if successful
+     */
+    changePassword(currentPassword: string, newPassword: string): Promise<{
+        error: Error | null;
+    }>;
+    /**
+     * Sign out and clear session
+     */
+    signOut(): Promise<{
+        error: null;
+    }>;
+    /**
+     * Get the current access token
+     */
+    getAccessToken(): string | null;
+    /**
+     * Get the current refresh token
+     */
+    getRefreshToken(): string | null;
+    /**
+     * Check if user is authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Get the Zustand store (for React hooks)
+     */
+    getStore(): ReturnType<typeof createAuthStore>;
+}
+
+/**
+ * Base service class with automatic token injection and refresh handling
+ */
+declare class AuthenticatedBaseService {
+    client: AxiosInstance;
+    private authClient;
+    private instanceUrl;
+    constructor(authClient: AuthClient, instanceUrl: string);
+    /**
+     * Setup request and response interceptors
+     */
+    private setupInterceptors;
+    /**
+     * GET request
+     */
+    protected get<T>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * POST request
+     */
+    protected post<TRequest, TResponse>(url: string, data?: TRequest, config?: AxiosRequestConfig): Promise<TResponse>;
+    /**
+     * POST request with form data
+     */
+    protected postFormData<FormData, TResponse>(url: string, data: FormData): Promise<TResponse>;
+    /**
+     * PUT request
+     */
+    protected put<TRequest, TResponse>(url: string, data?: TRequest, config?: AxiosRequestConfig): Promise<TResponse>;
+    /**
+     * PATCH request
+     */
+    protected patch<TRequest, TResponse>(url: string, data?: TRequest, config?: AxiosRequestConfig): Promise<TResponse>;
+    /**
+     * DELETE request
+     */
+    protected delete<T = void>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Get the underlying Axios instance (for advanced usage)
+     */
+    getClient(): AxiosInstance;
+}
+
+/**
+ * Anythink SDK
+ *
+ * A reusable Typescript SDK for the Anythink platform.
+ */
+declare const version = "0.1.0";
+
+export { AuthClient, type AuthConfig, AuthenticatedBaseService, type RefreshResponse, type Session, type SignInResponse, type TokenPair, createAuthStore, version };