@insforge/sdk 0.0.1

package/dist/index.d.mts

@@ -0,0 +1,230 @@
+import { UserSchema, CreateUserRequest, CreateSessionRequest, GetCurrentSessionResponse } from '@insforge/shared-schemas';
+export { AuthErrorResponse, CreateSessionRequest, CreateUserRequest, UserSchema } from '@insforge/shared-schemas';
+
+/**
+ * InsForge SDK Types - only SDK-specific types here
+ * Use @insforge/shared-schemas directly for API types
+ */
+
+interface InsForgeConfig {
+    /**
+     * The URL of the InsForge backend API
+     * @default "http://localhost:7130"
+     */
+    url?: string;
+    /**
+     * API key (optional)
+     * Can be used for server-side operations or specific use cases
+     */
+    apiKey?: string;
+    /**
+     * Custom fetch implementation (useful for Node.js environments)
+     */
+    fetch?: typeof fetch;
+    /**
+     * Storage adapter for persisting tokens
+     */
+    storage?: TokenStorage;
+    /**
+     * Whether to automatically refresh tokens before they expire
+     * @default true
+     */
+    autoRefreshToken?: boolean;
+    /**
+     * Whether to persist session in storage
+     * @default true
+     */
+    persistSession?: boolean;
+    /**
+     * Custom headers to include with every request
+     */
+    headers?: Record<string, string>;
+}
+interface TokenStorage {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+    removeItem(key: string): void | Promise<void>;
+}
+interface AuthSession {
+    user: UserSchema;
+    accessToken: string;
+    expiresAt?: Date;
+}
+interface ApiError {
+    error: string;
+    message: string;
+    statusCode: number;
+    nextActions?: string;
+}
+declare class InsForgeError extends Error {
+    statusCode: number;
+    error: string;
+    nextActions?: string;
+    constructor(message: string, statusCode: number, error: string, nextActions?: string);
+    static fromApiError(apiError: ApiError): InsForgeError;
+}
+
+interface RequestOptions extends RequestInit {
+    params?: Record<string, string>;
+}
+declare class HttpClient {
+    private baseUrl;
+    private fetch;
+    private defaultHeaders;
+    constructor(config: InsForgeConfig);
+    private buildUrl;
+    request<T>(method: string, path: string, options?: RequestOptions): Promise<T>;
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, body?: any, options?: RequestOptions): Promise<T>;
+    put<T>(path: string, body?: any, options?: RequestOptions): Promise<T>;
+    patch<T>(path: string, body?: any, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+    setAuthToken(token: string | null): void;
+}
+
+declare class TokenManager {
+    private storage;
+    constructor(storage?: TokenStorage);
+    saveSession(session: AuthSession): void;
+    getSession(): AuthSession | null;
+    getAccessToken(): string | null;
+    clearSession(): void;
+}
+
+/**
+ * Auth module for InsForge SDK
+ * Uses shared schemas for type safety
+ */
+
+declare class Auth {
+    private http;
+    private tokenManager;
+    constructor(http: HttpClient, tokenManager: TokenManager);
+    /**
+     * Sign up a new user
+     */
+    signUp(request: CreateUserRequest): Promise<{
+        data: {
+            user: UserSchema | null;
+            session: AuthSession | null;
+        };
+        error: InsForgeError | null;
+    }>;
+    /**
+     * Sign in with email and password
+     */
+    signInWithPassword(request: CreateSessionRequest): Promise<{
+        data: {
+            user: UserSchema | null;
+            session: AuthSession | null;
+        };
+        error: InsForgeError | null;
+    }>;
+    /**
+     * Sign in with OAuth provider
+     */
+    signInWithOAuth(options: {
+        provider: 'google' | 'github';
+        redirectTo?: string;
+        skipBrowserRedirect?: boolean;
+    }): Promise<{
+        data: {
+            url?: string;
+            provider?: string;
+        };
+        error: InsForgeError | null;
+    }>;
+    /**
+     * Sign out the current user
+     */
+    signOut(): Promise<{
+        error: InsForgeError | null;
+    }>;
+    /**
+     * Get the current user from the API
+     * Returns exactly what the backend returns: {id, email, role}
+     */
+    getCurrentUser(): Promise<{
+        data: GetCurrentSessionResponse | null;
+        error: InsForgeError | null;
+    }>;
+    /**
+     * Get the stored session (no API call)
+     */
+    getSession(): Promise<{
+        data: {
+            session: AuthSession | null;
+        };
+        error: InsForgeError | null;
+    }>;
+}
+
+/**
+ * Main InsForge SDK Client
+ *
+ * @example
+ * ```typescript
+ * import { InsForgeClient } from '@insforge/sdk';
+ *
+ * const client = new InsForgeClient({
+ *   baseUrl: 'http://localhost:7130'
+ * });
+ *
+ * // Register a new user
+ * const session = await client.auth.register({
+ *   email: 'user@example.com',
+ *   password: 'password123',
+ *   name: 'John Doe'
+ * });
+ *
+ * // Or login
+ * const session = await client.auth.login({
+ *   email: 'user@example.com',
+ *   password: 'password123'
+ * });
+ *
+ * // Get current user
+ * const user = await client.auth.getCurrentUser();
+ * ```
+ */
+declare class InsForgeClient {
+    private http;
+    private tokenManager;
+    /**
+     * Authentication module
+     */
+    readonly auth: Auth;
+    constructor(config?: InsForgeConfig);
+    /**
+     * Set a custom API key for authentication
+     * This is useful for server-to-server communication
+     *
+     * @param apiKey - The API key (should start with 'ik_')
+     *
+     * @example
+     * ```typescript
+     * client.setApiKey('ik_your_api_key_here');
+     * ```
+     */
+    setApiKey(apiKey: string): void;
+    /**
+     * Get the underlying HTTP client for custom requests
+     *
+     * @example
+     * ```typescript
+     * const httpClient = client.getHttpClient();
+     * const customData = await httpClient.get('/api/custom-endpoint');
+     * ```
+     */
+    getHttpClient(): HttpClient;
+}
+
+/**
+ * @insforge/sdk - TypeScript SDK for InsForge Backend-as-a-Service
+ *
+ * @packageDocumentation
+ */
+
+declare function createClient(config: InsForgeConfig): InsForgeClient;
+
+export { type ApiError, Auth, type AuthSession, type InsForgeConfig as ClientOptions, HttpClient, InsForgeClient, type InsForgeConfig, InsForgeError, TokenManager, type TokenStorage, createClient, InsForgeClient as default };

package/dist/index.d.ts

@@ -0,0 +1,230 @@
+import { UserSchema, CreateUserRequest, CreateSessionRequest, GetCurrentSessionResponse } from '@insforge/shared-schemas';
+export { AuthErrorResponse, CreateSessionRequest, CreateUserRequest, UserSchema } from '@insforge/shared-schemas';
+
+/**
+ * InsForge SDK Types - only SDK-specific types here
+ * Use @insforge/shared-schemas directly for API types
+ */
+
+interface InsForgeConfig {
+    /**
+     * The URL of the InsForge backend API
+     * @default "http://localhost:7130"
+     */
+    url?: string;
+    /**
+     * API key (optional)
+     * Can be used for server-side operations or specific use cases
+     */
+    apiKey?: string;
+    /**
+     * Custom fetch implementation (useful for Node.js environments)
+     */
+    fetch?: typeof fetch;
+    /**
+     * Storage adapter for persisting tokens
+     */
+    storage?: TokenStorage;
+    /**
+     * Whether to automatically refresh tokens before they expire
+     * @default true
+     */
+    autoRefreshToken?: boolean;
+    /**
+     * Whether to persist session in storage
+     * @default true
+     */
+    persistSession?: boolean;
+    /**
+     * Custom headers to include with every request
+     */
+    headers?: Record<string, string>;
+}
+interface TokenStorage {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+    removeItem(key: string): void | Promise<void>;
+}
+interface AuthSession {
+    user: UserSchema;
+    accessToken: string;
+    expiresAt?: Date;
+}
+interface ApiError {
+    error: string;
+    message: string;
+    statusCode: number;
+    nextActions?: string;
+}
+declare class InsForgeError extends Error {
+    statusCode: number;
+    error: string;
+    nextActions?: string;
+    constructor(message: string, statusCode: number, error: string, nextActions?: string);
+    static fromApiError(apiError: ApiError): InsForgeError;
+}
+
+interface RequestOptions extends RequestInit {
+    params?: Record<string, string>;
+}
+declare class HttpClient {
+    private baseUrl;
+    private fetch;
+    private defaultHeaders;
+    constructor(config: InsForgeConfig);
+    private buildUrl;
+    request<T>(method: string, path: string, options?: RequestOptions): Promise<T>;
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, body?: any, options?: RequestOptions): Promise<T>;
+    put<T>(path: string, body?: any, options?: RequestOptions): Promise<T>;
+    patch<T>(path: string, body?: any, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+    setAuthToken(token: string | null): void;
+}
+
+declare class TokenManager {
+    private storage;
+    constructor(storage?: TokenStorage);
+    saveSession(session: AuthSession): void;
+    getSession(): AuthSession | null;
+    getAccessToken(): string | null;
+    clearSession(): void;
+}
+
+/**
+ * Auth module for InsForge SDK
+ * Uses shared schemas for type safety
+ */
+
+declare class Auth {
+    private http;
+    private tokenManager;
+    constructor(http: HttpClient, tokenManager: TokenManager);
+    /**
+     * Sign up a new user
+     */
+    signUp(request: CreateUserRequest): Promise<{
+        data: {
+            user: UserSchema | null;
+            session: AuthSession | null;
+        };
+        error: InsForgeError | null;
+    }>;
+    /**
+     * Sign in with email and password
+     */
+    signInWithPassword(request: CreateSessionRequest): Promise<{
+        data: {
+            user: UserSchema | null;
+            session: AuthSession | null;
+        };
+        error: InsForgeError | null;
+    }>;
+    /**
+     * Sign in with OAuth provider
+     */
+    signInWithOAuth(options: {
+        provider: 'google' | 'github';
+        redirectTo?: string;
+        skipBrowserRedirect?: boolean;
+    }): Promise<{
+        data: {
+            url?: string;
+            provider?: string;
+        };
+        error: InsForgeError | null;
+    }>;
+    /**
+     * Sign out the current user
+     */
+    signOut(): Promise<{
+        error: InsForgeError | null;
+    }>;
+    /**
+     * Get the current user from the API
+     * Returns exactly what the backend returns: {id, email, role}
+     */
+    getCurrentUser(): Promise<{
+        data: GetCurrentSessionResponse | null;
+        error: InsForgeError | null;
+    }>;
+    /**
+     * Get the stored session (no API call)
+     */
+    getSession(): Promise<{
+        data: {
+            session: AuthSession | null;
+        };
+        error: InsForgeError | null;
+    }>;
+}
+
+/**
+ * Main InsForge SDK Client
+ *
+ * @example
+ * ```typescript
+ * import { InsForgeClient } from '@insforge/sdk';
+ *
+ * const client = new InsForgeClient({
+ *   baseUrl: 'http://localhost:7130'
+ * });
+ *
+ * // Register a new user
+ * const session = await client.auth.register({
+ *   email: 'user@example.com',
+ *   password: 'password123',
+ *   name: 'John Doe'
+ * });
+ *
+ * // Or login
+ * const session = await client.auth.login({
+ *   email: 'user@example.com',
+ *   password: 'password123'
+ * });
+ *
+ * // Get current user
+ * const user = await client.auth.getCurrentUser();
+ * ```
+ */
+declare class InsForgeClient {
+    private http;
+    private tokenManager;
+    /**
+     * Authentication module
+     */
+    readonly auth: Auth;
+    constructor(config?: InsForgeConfig);
+    /**
+     * Set a custom API key for authentication
+     * This is useful for server-to-server communication
+     *
+     * @param apiKey - The API key (should start with 'ik_')
+     *
+     * @example
+     * ```typescript
+     * client.setApiKey('ik_your_api_key_here');
+     * ```
+     */
+    setApiKey(apiKey: string): void;
+    /**
+     * Get the underlying HTTP client for custom requests
+     *
+     * @example
+     * ```typescript
+     * const httpClient = client.getHttpClient();
+     * const customData = await httpClient.get('/api/custom-endpoint');
+     * ```
+     */
+    getHttpClient(): HttpClient;
+}
+
+/**
+ * @insforge/sdk - TypeScript SDK for InsForge Backend-as-a-Service
+ *
+ * @packageDocumentation
+ */
+
+declare function createClient(config: InsForgeConfig): InsForgeClient;
+
+export { type ApiError, Auth, type AuthSession, type InsForgeConfig as ClientOptions, HttpClient, InsForgeClient, type InsForgeConfig, InsForgeError, TokenManager, type TokenStorage, createClient, InsForgeClient as default };