@insforge/sdk 0.0.3 → 0.0.5

package/dist/index.d.mts

@@ -153,6 +153,182 @@ declare class Auth {
     }>;
 }
 
+/**
+ * Database module for InsForge SDK
+ * Supabase-style query builder for PostgREST operations
+ */
+
+interface DatabaseResponse<T> {
+    data: T | null;
+    error: InsForgeError | null;
+    count?: number;
+}
+/**
+ * Query builder for database operations
+ * Uses method chaining like Supabase
+ */
+declare class QueryBuilder<T = any> {
+    private table;
+    private http;
+    private method;
+    private headers;
+    private queryParams;
+    private body?;
+    constructor(table: string, http: HttpClient);
+    /**
+     * Perform a SELECT query
+     * @param columns - Columns to select (default: '*')
+     * @example
+     * .select('*')
+     * .select('id, title, content')
+     * .select('*, user:user_id(name, email)')  // Foreign key expansion
+     */
+    select(columns?: string): this;
+    /**
+     * Perform an INSERT
+     * @param values - Single object or array of objects
+     * @param options - { upsert: true } for upsert behavior
+     * @example
+     * .insert({ title: 'Hello', content: 'World' })
+     * .insert([{ title: 'Post 1' }, { title: 'Post 2' }])
+     */
+    insert(values: Partial<T> | Partial<T>[], options?: {
+        upsert?: boolean;
+    }): this;
+    /**
+     * Perform an UPDATE
+     * @param values - Object with fields to update
+     * @example
+     * .update({ title: 'Updated Title' })
+     */
+    update(values: Partial<T>): this;
+    /**
+     * Perform a DELETE
+     * @example
+     * .delete()
+     */
+    delete(): this;
+    /**
+     * Perform an UPSERT
+     * @param values - Single object or array of objects
+     * @example
+     * .upsert({ id: 1, title: 'Hello' })
+     */
+    upsert(values: Partial<T> | Partial<T>[]): this;
+    /**
+     * Filter by column equal to value
+     * @example .eq('id', 123)
+     */
+    eq(column: string, value: any): this;
+    /**
+     * Filter by column not equal to value
+     * @example .neq('status', 'draft')
+     */
+    neq(column: string, value: any): this;
+    /**
+     * Filter by column greater than value
+     * @example .gt('age', 18)
+     */
+    gt(column: string, value: any): this;
+    /**
+     * Filter by column greater than or equal to value
+     * @example .gte('price', 100)
+     */
+    gte(column: string, value: any): this;
+    /**
+     * Filter by column less than value
+     * @example .lt('stock', 10)
+     */
+    lt(column: string, value: any): this;
+    /**
+     * Filter by column less than or equal to value
+     * @example .lte('discount', 50)
+     */
+    lte(column: string, value: any): this;
+    /**
+     * Filter by pattern matching (case-sensitive)
+     * @example .like('email', '%@gmail.com')
+     */
+    like(column: string, pattern: string): this;
+    /**
+     * Filter by pattern matching (case-insensitive)
+     * @example .ilike('name', '%john%')
+     */
+    ilike(column: string, pattern: string): this;
+    /**
+     * Filter by checking if column is a value
+     * @example .is('deleted_at', null)
+     */
+    is(column: string, value: null | boolean): this;
+    /**
+     * Filter by checking if value is in array
+     * @example .in('status', ['active', 'pending'])
+     */
+    in(column: string, values: any[]): this;
+    /**
+     * Order by column
+     * @example
+     * .order('created_at')  // ascending
+     * .order('created_at', { ascending: false })  // descending
+     */
+    order(column: string, options?: {
+        ascending?: boolean;
+    }): this;
+    /**
+     * Limit the number of rows returned
+     * @example .limit(10)
+     */
+    limit(count: number): this;
+    /**
+     * Return results from an offset
+     * @example .offset(20)
+     */
+    offset(count: number): this;
+    /**
+     * Set a range of rows to return
+     * @example .range(0, 9)  // First 10 rows
+     */
+    range(from: number, to: number): this;
+    /**
+     * Return a single object instead of array
+     * @example .single()
+     */
+    single(): this;
+    /**
+     * Get the total count (use with select)
+     * @example .select('*', { count: 'exact' })
+     */
+    count(algorithm?: 'exact' | 'planned' | 'estimated'): this;
+    /**
+     * Execute the query and return results
+     */
+    execute(): Promise<DatabaseResponse<T>>;
+    /**
+     * Make QueryBuilder thenable for async/await
+     */
+    then<TResult1 = DatabaseResponse<T>, TResult2 = never>(onfulfilled?: ((value: DatabaseResponse<T>) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): Promise<TResult1 | TResult2>;
+}
+/**
+ * Database client for InsForge SDK
+ * Provides Supabase-style interface
+ */
+declare class Database {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Create a query builder for a table
+     * @param table - The table name
+     * @example
+     * const { data, error } = await client.database
+     *   .from('posts')
+     *   .select('*')
+     *   .eq('user_id', userId)
+     *   .order('created_at', { ascending: false })
+     *   .limit(10);
+     */
+    from<T = any>(table: string): QueryBuilder<T>;
+}
+
 /**
  * Main InsForge SDK Client
  *
@@ -164,30 +340,33 @@ declare class Auth {
  *   baseUrl: 'http://localhost:7130'
  * });
  *
- * // Register a new user
+ * // Authentication
  * 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'
- * });
+ * // Database operations
+ * const { data, error } = await client.database
+ *   .from('posts')
+ *   .select('*')
+ *   .eq('user_id', session.user.id)
+ *   .order('created_at', { ascending: false })
+ *   .limit(10);
  *
- * // Get current user
- * const user = await client.auth.getCurrentUser();
+ * // Insert data
+ * const { data: newPost } = await client.database
+ *   .from('posts')
+ *   .insert({ title: 'Hello', content: 'World' })
+ *   .single();
  * ```
  */
 declare class InsForgeClient {
     private http;
     private tokenManager;
-    /**
-     * Authentication module
-     */
     readonly auth: Auth;
+    readonly database: Database;
     constructor(config?: InsForgeConfig);
     /**
      * Set a custom API key for authentication
@@ -221,4 +400,4 @@ declare class InsForgeClient {
 
 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 };
+export { type ApiError, Auth, type AuthSession, type InsForgeConfig as ClientOptions, Database, type DatabaseResponse, HttpClient, InsForgeClient, type InsForgeConfig, InsForgeError, QueryBuilder, TokenManager, type TokenStorage, createClient, InsForgeClient as default };

package/dist/index.d.ts

@@ -153,6 +153,182 @@ declare class Auth {
     }>;
 }
 
+/**
+ * Database module for InsForge SDK
+ * Supabase-style query builder for PostgREST operations
+ */
+
+interface DatabaseResponse<T> {
+    data: T | null;
+    error: InsForgeError | null;
+    count?: number;
+}
+/**
+ * Query builder for database operations
+ * Uses method chaining like Supabase
+ */
+declare class QueryBuilder<T = any> {
+    private table;
+    private http;
+    private method;
+    private headers;
+    private queryParams;
+    private body?;
+    constructor(table: string, http: HttpClient);
+    /**
+     * Perform a SELECT query
+     * @param columns - Columns to select (default: '*')
+     * @example
+     * .select('*')
+     * .select('id, title, content')
+     * .select('*, user:user_id(name, email)')  // Foreign key expansion
+     */
+    select(columns?: string): this;
+    /**
+     * Perform an INSERT
+     * @param values - Single object or array of objects
+     * @param options - { upsert: true } for upsert behavior
+     * @example
+     * .insert({ title: 'Hello', content: 'World' })
+     * .insert([{ title: 'Post 1' }, { title: 'Post 2' }])
+     */
+    insert(values: Partial<T> | Partial<T>[], options?: {
+        upsert?: boolean;
+    }): this;
+    /**
+     * Perform an UPDATE
+     * @param values - Object with fields to update
+     * @example
+     * .update({ title: 'Updated Title' })
+     */
+    update(values: Partial<T>): this;
+    /**
+     * Perform a DELETE
+     * @example
+     * .delete()
+     */
+    delete(): this;
+    /**
+     * Perform an UPSERT
+     * @param values - Single object or array of objects
+     * @example
+     * .upsert({ id: 1, title: 'Hello' })
+     */
+    upsert(values: Partial<T> | Partial<T>[]): this;
+    /**
+     * Filter by column equal to value
+     * @example .eq('id', 123)
+     */
+    eq(column: string, value: any): this;
+    /**
+     * Filter by column not equal to value
+     * @example .neq('status', 'draft')
+     */
+    neq(column: string, value: any): this;
+    /**
+     * Filter by column greater than value
+     * @example .gt('age', 18)
+     */
+    gt(column: string, value: any): this;
+    /**
+     * Filter by column greater than or equal to value
+     * @example .gte('price', 100)
+     */
+    gte(column: string, value: any): this;
+    /**
+     * Filter by column less than value
+     * @example .lt('stock', 10)
+     */
+    lt(column: string, value: any): this;
+    /**
+     * Filter by column less than or equal to value
+     * @example .lte('discount', 50)
+     */
+    lte(column: string, value: any): this;
+    /**
+     * Filter by pattern matching (case-sensitive)
+     * @example .like('email', '%@gmail.com')
+     */
+    like(column: string, pattern: string): this;
+    /**
+     * Filter by pattern matching (case-insensitive)
+     * @example .ilike('name', '%john%')
+     */
+    ilike(column: string, pattern: string): this;
+    /**
+     * Filter by checking if column is a value
+     * @example .is('deleted_at', null)
+     */
+    is(column: string, value: null | boolean): this;
+    /**
+     * Filter by checking if value is in array
+     * @example .in('status', ['active', 'pending'])
+     */
+    in(column: string, values: any[]): this;
+    /**
+     * Order by column
+     * @example
+     * .order('created_at')  // ascending
+     * .order('created_at', { ascending: false })  // descending
+     */
+    order(column: string, options?: {
+        ascending?: boolean;
+    }): this;
+    /**
+     * Limit the number of rows returned
+     * @example .limit(10)
+     */
+    limit(count: number): this;
+    /**
+     * Return results from an offset
+     * @example .offset(20)
+     */
+    offset(count: number): this;
+    /**
+     * Set a range of rows to return
+     * @example .range(0, 9)  // First 10 rows
+     */
+    range(from: number, to: number): this;
+    /**
+     * Return a single object instead of array
+     * @example .single()
+     */
+    single(): this;
+    /**
+     * Get the total count (use with select)
+     * @example .select('*', { count: 'exact' })
+     */
+    count(algorithm?: 'exact' | 'planned' | 'estimated'): this;
+    /**
+     * Execute the query and return results
+     */
+    execute(): Promise<DatabaseResponse<T>>;
+    /**
+     * Make QueryBuilder thenable for async/await
+     */
+    then<TResult1 = DatabaseResponse<T>, TResult2 = never>(onfulfilled?: ((value: DatabaseResponse<T>) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): Promise<TResult1 | TResult2>;
+}
+/**
+ * Database client for InsForge SDK
+ * Provides Supabase-style interface
+ */
+declare class Database {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Create a query builder for a table
+     * @param table - The table name
+     * @example
+     * const { data, error } = await client.database
+     *   .from('posts')
+     *   .select('*')
+     *   .eq('user_id', userId)
+     *   .order('created_at', { ascending: false })
+     *   .limit(10);
+     */
+    from<T = any>(table: string): QueryBuilder<T>;
+}
+
 /**
  * Main InsForge SDK Client
  *
@@ -164,30 +340,33 @@ declare class Auth {
  *   baseUrl: 'http://localhost:7130'
  * });
  *
- * // Register a new user
+ * // Authentication
  * 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'
- * });
+ * // Database operations
+ * const { data, error } = await client.database
+ *   .from('posts')
+ *   .select('*')
+ *   .eq('user_id', session.user.id)
+ *   .order('created_at', { ascending: false })
+ *   .limit(10);
  *
- * // Get current user
- * const user = await client.auth.getCurrentUser();
+ * // Insert data
+ * const { data: newPost } = await client.database
+ *   .from('posts')
+ *   .insert({ title: 'Hello', content: 'World' })
+ *   .single();
  * ```
  */
 declare class InsForgeClient {
     private http;
     private tokenManager;
-    /**
-     * Authentication module
-     */
     readonly auth: Auth;
+    readonly database: Database;
     constructor(config?: InsForgeConfig);
     /**
      * Set a custom API key for authentication
@@ -221,4 +400,4 @@ declare class InsForgeClient {
 
 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 };
+export { type ApiError, Auth, type AuthSession, type InsForgeConfig as ClientOptions, Database, type DatabaseResponse, HttpClient, InsForgeClient, type InsForgeConfig, InsForgeError, QueryBuilder, TokenManager, type TokenStorage, createClient, InsForgeClient as default };