@fluxbase/sdk 0.0.1-rc.30 → 0.0.1-rc.31

package/dist/index.d.cts

@@ -155,7 +155,7 @@ interface PostgrestResponse<T> {
     status: number;
     statusText: string;
 }
-type FilterOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ilike' | 'is' | 'in' | 'cs' | 'cd' | 'ov' | 'sl' | 'sr' | 'nxr' | 'nxl' | 'fts' | 'plfts' | 'wfts';
+type FilterOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ilike' | 'is' | 'in' | 'cs' | 'cd' | 'ov' | 'sl' | 'sr' | 'nxr' | 'nxl' | 'adj' | 'not' | 'fts' | 'plfts' | 'wfts';
 interface QueryFilter {
     column: string;
     operator: FilterOperator;
@@ -167,6 +167,27 @@ interface OrderBy {
     direction: OrderDirection;
     nulls?: 'first' | 'last';
 }
+/**
+ * Options for upsert operations (Supabase-compatible)
+ */
+interface UpsertOptions {
+    /**
+     * Comma-separated columns to use for conflict resolution
+     * @example 'email'
+     * @example 'user_id,tenant_id'
+     */
+    onConflict?: string;
+    /**
+     * If true, duplicate rows are ignored (not upserted)
+     * @default false
+     */
+    ignoreDuplicates?: boolean;
+    /**
+     * If true, missing columns default to null instead of using existing values
+     * @default false
+     */
+    defaultToNull?: boolean;
+}
 interface RealtimeMessage {
     type: 'subscribe' | 'unsubscribe' | 'heartbeat' | 'broadcast' | 'presence' | 'ack' | 'error';
     channel?: string;
@@ -4226,10 +4247,13 @@ declare class QueryBuilder<T = unknown> implements PromiseLike<PostgrestResponse
     private table;
     private selectQuery;
     private filters;
+    private orFilters;
+    private andFilters;
     private orderBys;
     private limitValue?;
     private offsetValue?;
     private singleRow;
+    private maybeSingleRow;
     private groupByColumns?;
     constructor(fetch: FluxbaseFetch, table: string);
     /**
@@ -4244,9 +4268,11 @@ declare class QueryBuilder<T = unknown> implements PromiseLike<PostgrestResponse
      */
     insert(data: Partial<T> | Array<Partial<T>>): Promise<PostgrestResponse<T>>;
     /**
-     * Upsert (insert or update) rows
+     * Upsert (insert or update) rows (Supabase-compatible)
+     * @param data - Row(s) to upsert
+     * @param options - Upsert options (onConflict, ignoreDuplicates, defaultToNull)
      */
-    upsert(data: Partial<T> | Array<Partial<T>>): Promise<PostgrestResponse<T>>;
+    upsert(data: Partial<T> | Array<Partial<T>>, options?: UpsertOptions): Promise<PostgrestResponse<T>>;
     /**
      * Update rows matching the filters
      */
@@ -4303,6 +4329,48 @@ declare class QueryBuilder<T = unknown> implements PromiseLike<PostgrestResponse
      * Full-text search
      */
     textSearch(column: string, query: string): this;
+    /**
+     * Negate a filter condition (Supabase-compatible)
+     * @example not('status', 'eq', 'deleted')
+     * @example not('completed_at', 'is', null)
+     */
+    not(column: string, operator: FilterOperator, value: unknown): this;
+    /**
+     * Apply OR logic to filters (Supabase-compatible)
+     * @example or('status.eq.active,status.eq.pending')
+     * @example or('id.eq.2,name.eq.Han')
+     */
+    or(filters: string): this;
+    /**
+     * Apply AND logic to filters (Supabase-compatible)
+     * Groups multiple conditions that must all be true
+     * @example and('status.eq.active,verified.eq.true')
+     * @example and('age.gte.18,age.lte.65')
+     */
+    and(filters: string): this;
+    /**
+     * Match multiple columns with exact values (Supabase-compatible)
+     * Shorthand for multiple .eq() calls
+     * @example match({ id: 1, status: 'active', role: 'admin' })
+     */
+    match(conditions: Record<string, unknown>): this;
+    /**
+     * Generic filter method using PostgREST syntax (Supabase-compatible)
+     * @example filter('name', 'in', '("Han","Yoda")')
+     * @example filter('age', 'gte', '18')
+     */
+    filter(column: string, operator: FilterOperator, value: unknown): this;
+    /**
+     * Check if column is contained by value (Supabase-compatible)
+     * For arrays and JSONB
+     * @example containedBy('tags', '["news","update"]')
+     */
+    containedBy(column: string, value: unknown): this;
+    /**
+     * Check if arrays have common elements (Supabase-compatible)
+     * @example overlaps('tags', '["news","sports"]')
+     */
+    overlaps(column: string, value: unknown): this;
     /**
      * Order results
      */
@@ -4320,8 +4388,24 @@ declare class QueryBuilder<T = unknown> implements PromiseLike<PostgrestResponse
     offset(count: number): this;
     /**
      * Return a single row (adds limit(1))
+     * Errors if no rows found
      */
     single(): this;
+    /**
+     * Return a single row or null (adds limit(1))
+     * Does not error if no rows found (Supabase-compatible)
+     * @example
+     * ```typescript
+     * // Returns null instead of erroring when no row exists
+     * const { data, error } = await client
+     *   .from('users')
+     *   .select('*')
+     *   .eq('id', 999)
+     *   .maybeSingle()
+     * // data will be null if no row found
+     * ```
+     */
+    maybeSingle(): this;
     /**
      * Range selection (pagination)
      */
@@ -4538,6 +4622,27 @@ declare class QueryBuilder<T = unknown> implements PromiseLike<PostgrestResponse
      * Execute the query and return results
      */
     execute(): Promise<PostgrestResponse<T>>;
+    /**
+     * Execute the query and throw an error if one occurs (Supabase-compatible)
+     * Returns the data directly instead of { data, error } wrapper
+     *
+     * @throws {Error} If the query fails or returns an error
+     * @example
+     * ```typescript
+     * // Throws error instead of returning { data, error }
+     * try {
+     *   const user = await client
+     *     .from('users')
+     *     .select('*')
+     *     .eq('id', 1)
+     *     .single()
+     *     .throwOnError()
+     * } catch (error) {
+     *   console.error('Query failed:', error)
+     * }
+     * ```
+     */
+    throwOnError(): Promise<T>;
     /**
      * Make QueryBuilder awaitable (implements PromiseLike)
      * This allows using `await client.from('table').select()` without calling `.execute()`
@@ -4767,4 +4872,4 @@ declare class FluxbaseClient<Database = any, _SchemaName extends string & keyof
  */
 declare function createClient<Database = any, SchemaName extends string & keyof Database = any>(fluxbaseUrl: string, fluxbaseKey: string, options?: FluxbaseClientOptions): FluxbaseClient<Database, SchemaName>;
 
-export { type APIKey, APIKeysManager, type AcceptInvitationRequest, type AcceptInvitationResponse, type AdminAuthResponse, type AdminLoginRequest, type AdminMeResponse, type AdminRefreshRequest, type AdminRefreshResponse, type AdminSetupRequest, type AdminSetupStatusResponse, type AdminUser, type AppSettings, AppSettingsManager, type AuthResponse, type AuthResponseData, type AuthSession, type AuthSettings, AuthSettingsManager, type AuthenticationSettings, type BroadcastCallback, type BroadcastMessage, type Column, type CreateAPIKeyRequest, type CreateAPIKeyResponse, type CreateColumnRequest, type CreateFunctionRequest, type CreateInvitationRequest, type CreateInvitationResponse, type CreateOAuthProviderRequest, type CreateOAuthProviderResponse, type CreateSchemaRequest, type CreateSchemaResponse, type CreateTableRequest, type CreateTableResponse, type CreateWebhookRequest, DDLManager, type DataResponse, type DeleteAPIKeyResponse, type DeleteOAuthProviderResponse, type DeleteTableResponse, type DeleteUserResponse, type DeleteWebhookResponse, type EdgeFunction, type EdgeFunctionExecution, type EmailSettings, type EmailTemplate, EmailTemplateManager, type EmailTemplateType, type EnrichedUser, type FeatureSettings, type FileObject, type FilterOperator, FluxbaseAdmin, FluxbaseAuth, type FluxbaseAuthResponse, FluxbaseClient, type FluxbaseClientOptions, type FluxbaseError, FluxbaseFetch, FluxbaseFunctions, FluxbaseManagement, FluxbaseOAuth, FluxbaseRealtime, type FluxbaseResponse, FluxbaseSettings, FluxbaseStorage, type FunctionInvokeOptions, type GetImpersonationResponse, type HttpMethod, type ImpersonateAnonRequest, type ImpersonateServiceRequest, type ImpersonateUserRequest, ImpersonationManager, type ImpersonationSession, type ImpersonationTargetUser, type ImpersonationType, type Invitation, InvitationsManager, type InviteUserRequest, type InviteUserResponse, type ListAPIKeysResponse, type ListEmailTemplatesResponse, type ListImpersonationSessionsOptions, type ListImpersonationSessionsResponse, type ListInvitationsOptions, type ListInvitationsResponse, type ListOAuthProvidersResponse, type ListOptions, type ListSchemasResponse, type ListSystemSettingsResponse, type ListTablesResponse, type ListUsersOptions, type ListUsersResponse, type ListWebhookDeliveriesResponse, type ListWebhooksResponse, type MailgunSettings, type OAuthProvider, OAuthProviderManager, type OrderBy, type OrderDirection, type PostgresChangesConfig, type PostgrestError, type PostgrestResponse, type PresenceCallback, type PresenceState, QueryBuilder, type QueryFilter, type RealtimeBroadcastPayload, type RealtimeCallback, type RealtimeChangePayload, RealtimeChannel, type RealtimeChannelConfig, type RealtimeMessage, type RealtimePostgresChangesPayload, type RealtimePresencePayload, type RequestOptions, type ResetUserPasswordResponse, type RevokeAPIKeyResponse, type RevokeInvitationResponse, type SESSettings, type SMTPSettings, type Schema, type SecuritySettings, type SendGridSettings, type SessionResponse, SettingsClient, type SignInCredentials, type SignInWith2FAResponse, type SignUpCredentials, type SignedUrlOptions, type StartImpersonationResponse, type StopImpersonationResponse, StorageBucket, type StorageObject, type SupabaseAuthResponse, type SupabaseResponse, type SystemSetting, SystemSettingsManager, type Table, type TestEmailTemplateRequest, type TestWebhookResponse, type TwoFactorEnableResponse, type TwoFactorSetupResponse, type TwoFactorStatusResponse, type TwoFactorVerifyRequest, type UpdateAPIKeyRequest, type UpdateAppSettingsRequest, type UpdateAuthSettingsRequest, type UpdateAuthSettingsResponse, type UpdateEmailTemplateRequest, type UpdateFunctionRequest, type UpdateOAuthProviderRequest, type UpdateOAuthProviderResponse, type UpdateSystemSettingRequest, type UpdateUserRoleRequest, type UpdateWebhookRequest, type UploadOptions, type UploadProgress, type User, type UserResponse, type ValidateInvitationResponse, type VoidResponse, type WeakPassword, type Webhook, type WebhookDelivery, WebhooksManager, createClient };
+export { type APIKey, APIKeysManager, type AcceptInvitationRequest, type AcceptInvitationResponse, type AdminAuthResponse, type AdminLoginRequest, type AdminMeResponse, type AdminRefreshRequest, type AdminRefreshResponse, type AdminSetupRequest, type AdminSetupStatusResponse, type AdminUser, type AppSettings, AppSettingsManager, type AuthResponse, type AuthResponseData, type AuthSession, type AuthSettings, AuthSettingsManager, type AuthenticationSettings, type BroadcastCallback, type BroadcastMessage, type Column, type CreateAPIKeyRequest, type CreateAPIKeyResponse, type CreateColumnRequest, type CreateFunctionRequest, type CreateInvitationRequest, type CreateInvitationResponse, type CreateOAuthProviderRequest, type CreateOAuthProviderResponse, type CreateSchemaRequest, type CreateSchemaResponse, type CreateTableRequest, type CreateTableResponse, type CreateWebhookRequest, DDLManager, type DataResponse, type DeleteAPIKeyResponse, type DeleteOAuthProviderResponse, type DeleteTableResponse, type DeleteUserResponse, type DeleteWebhookResponse, type EdgeFunction, type EdgeFunctionExecution, type EmailSettings, type EmailTemplate, EmailTemplateManager, type EmailTemplateType, type EnrichedUser, type FeatureSettings, type FileObject, type FilterOperator, FluxbaseAdmin, FluxbaseAuth, type FluxbaseAuthResponse, FluxbaseClient, type FluxbaseClientOptions, type FluxbaseError, FluxbaseFetch, FluxbaseFunctions, FluxbaseManagement, FluxbaseOAuth, FluxbaseRealtime, type FluxbaseResponse, FluxbaseSettings, FluxbaseStorage, type FunctionInvokeOptions, type GetImpersonationResponse, type HttpMethod, type ImpersonateAnonRequest, type ImpersonateServiceRequest, type ImpersonateUserRequest, ImpersonationManager, type ImpersonationSession, type ImpersonationTargetUser, type ImpersonationType, type Invitation, InvitationsManager, type InviteUserRequest, type InviteUserResponse, type ListAPIKeysResponse, type ListEmailTemplatesResponse, type ListImpersonationSessionsOptions, type ListImpersonationSessionsResponse, type ListInvitationsOptions, type ListInvitationsResponse, type ListOAuthProvidersResponse, type ListOptions, type ListSchemasResponse, type ListSystemSettingsResponse, type ListTablesResponse, type ListUsersOptions, type ListUsersResponse, type ListWebhookDeliveriesResponse, type ListWebhooksResponse, type MailgunSettings, type OAuthProvider, OAuthProviderManager, type OrderBy, type OrderDirection, type PostgresChangesConfig, type PostgrestError, type PostgrestResponse, type PresenceCallback, type PresenceState, QueryBuilder, type QueryFilter, type RealtimeBroadcastPayload, type RealtimeCallback, type RealtimeChangePayload, RealtimeChannel, type RealtimeChannelConfig, type RealtimeMessage, type RealtimePostgresChangesPayload, type RealtimePresencePayload, type RequestOptions, type ResetUserPasswordResponse, type RevokeAPIKeyResponse, type RevokeInvitationResponse, type SESSettings, type SMTPSettings, type Schema, type SecuritySettings, type SendGridSettings, type SessionResponse, SettingsClient, type SignInCredentials, type SignInWith2FAResponse, type SignUpCredentials, type SignedUrlOptions, type StartImpersonationResponse, type StopImpersonationResponse, StorageBucket, type StorageObject, type SupabaseAuthResponse, type SupabaseResponse, type SystemSetting, SystemSettingsManager, type Table, type TestEmailTemplateRequest, type TestWebhookResponse, type TwoFactorEnableResponse, type TwoFactorSetupResponse, type TwoFactorStatusResponse, type TwoFactorVerifyRequest, type UpdateAPIKeyRequest, type UpdateAppSettingsRequest, type UpdateAuthSettingsRequest, type UpdateAuthSettingsResponse, type UpdateEmailTemplateRequest, type UpdateFunctionRequest, type UpdateOAuthProviderRequest, type UpdateOAuthProviderResponse, type UpdateSystemSettingRequest, type UpdateUserRoleRequest, type UpdateWebhookRequest, type UploadOptions, type UploadProgress, type UpsertOptions, type User, type UserResponse, type ValidateInvitationResponse, type VoidResponse, type WeakPassword, type Webhook, type WebhookDelivery, WebhooksManager, createClient };

package/dist/index.d.ts

@@ -155,7 +155,7 @@ interface PostgrestResponse<T> {
     status: number;
     statusText: string;
 }
-type FilterOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ilike' | 'is' | 'in' | 'cs' | 'cd' | 'ov' | 'sl' | 'sr' | 'nxr' | 'nxl' | 'fts' | 'plfts' | 'wfts';
+type FilterOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ilike' | 'is' | 'in' | 'cs' | 'cd' | 'ov' | 'sl' | 'sr' | 'nxr' | 'nxl' | 'adj' | 'not' | 'fts' | 'plfts' | 'wfts';
 interface QueryFilter {
     column: string;
     operator: FilterOperator;
@@ -167,6 +167,27 @@ interface OrderBy {
     direction: OrderDirection;
     nulls?: 'first' | 'last';
 }
+/**
+ * Options for upsert operations (Supabase-compatible)
+ */
+interface UpsertOptions {
+    /**
+     * Comma-separated columns to use for conflict resolution
+     * @example 'email'
+     * @example 'user_id,tenant_id'
+     */
+    onConflict?: string;
+    /**
+     * If true, duplicate rows are ignored (not upserted)
+     * @default false
+     */
+    ignoreDuplicates?: boolean;
+    /**
+     * If true, missing columns default to null instead of using existing values
+     * @default false
+     */
+    defaultToNull?: boolean;
+}
 interface RealtimeMessage {
     type: 'subscribe' | 'unsubscribe' | 'heartbeat' | 'broadcast' | 'presence' | 'ack' | 'error';
     channel?: string;
@@ -4226,10 +4247,13 @@ declare class QueryBuilder<T = unknown> implements PromiseLike<PostgrestResponse
     private table;
     private selectQuery;
     private filters;
+    private orFilters;
+    private andFilters;
     private orderBys;
     private limitValue?;
     private offsetValue?;
     private singleRow;
+    private maybeSingleRow;
     private groupByColumns?;
     constructor(fetch: FluxbaseFetch, table: string);
     /**
@@ -4244,9 +4268,11 @@ declare class QueryBuilder<T = unknown> implements PromiseLike<PostgrestResponse
      */
     insert(data: Partial<T> | Array<Partial<T>>): Promise<PostgrestResponse<T>>;
     /**
-     * Upsert (insert or update) rows
+     * Upsert (insert or update) rows (Supabase-compatible)
+     * @param data - Row(s) to upsert
+     * @param options - Upsert options (onConflict, ignoreDuplicates, defaultToNull)
      */
-    upsert(data: Partial<T> | Array<Partial<T>>): Promise<PostgrestResponse<T>>;
+    upsert(data: Partial<T> | Array<Partial<T>>, options?: UpsertOptions): Promise<PostgrestResponse<T>>;
     /**
      * Update rows matching the filters
      */
@@ -4303,6 +4329,48 @@ declare class QueryBuilder<T = unknown> implements PromiseLike<PostgrestResponse
      * Full-text search
      */
     textSearch(column: string, query: string): this;
+    /**
+     * Negate a filter condition (Supabase-compatible)
+     * @example not('status', 'eq', 'deleted')
+     * @example not('completed_at', 'is', null)
+     */
+    not(column: string, operator: FilterOperator, value: unknown): this;
+    /**
+     * Apply OR logic to filters (Supabase-compatible)
+     * @example or('status.eq.active,status.eq.pending')
+     * @example or('id.eq.2,name.eq.Han')
+     */
+    or(filters: string): this;
+    /**
+     * Apply AND logic to filters (Supabase-compatible)
+     * Groups multiple conditions that must all be true
+     * @example and('status.eq.active,verified.eq.true')
+     * @example and('age.gte.18,age.lte.65')
+     */
+    and(filters: string): this;
+    /**
+     * Match multiple columns with exact values (Supabase-compatible)
+     * Shorthand for multiple .eq() calls
+     * @example match({ id: 1, status: 'active', role: 'admin' })
+     */
+    match(conditions: Record<string, unknown>): this;
+    /**
+     * Generic filter method using PostgREST syntax (Supabase-compatible)
+     * @example filter('name', 'in', '("Han","Yoda")')
+     * @example filter('age', 'gte', '18')
+     */
+    filter(column: string, operator: FilterOperator, value: unknown): this;
+    /**
+     * Check if column is contained by value (Supabase-compatible)
+     * For arrays and JSONB
+     * @example containedBy('tags', '["news","update"]')
+     */
+    containedBy(column: string, value: unknown): this;
+    /**
+     * Check if arrays have common elements (Supabase-compatible)
+     * @example overlaps('tags', '["news","sports"]')
+     */
+    overlaps(column: string, value: unknown): this;
     /**
      * Order results
      */
@@ -4320,8 +4388,24 @@ declare class QueryBuilder<T = unknown> implements PromiseLike<PostgrestResponse
     offset(count: number): this;
     /**
      * Return a single row (adds limit(1))
+     * Errors if no rows found
      */
     single(): this;
+    /**
+     * Return a single row or null (adds limit(1))
+     * Does not error if no rows found (Supabase-compatible)
+     * @example
+     * ```typescript
+     * // Returns null instead of erroring when no row exists
+     * const { data, error } = await client
+     *   .from('users')
+     *   .select('*')
+     *   .eq('id', 999)
+     *   .maybeSingle()
+     * // data will be null if no row found
+     * ```
+     */
+    maybeSingle(): this;
     /**
      * Range selection (pagination)
      */
@@ -4538,6 +4622,27 @@ declare class QueryBuilder<T = unknown> implements PromiseLike<PostgrestResponse
      * Execute the query and return results
      */
     execute(): Promise<PostgrestResponse<T>>;
+    /**
+     * Execute the query and throw an error if one occurs (Supabase-compatible)
+     * Returns the data directly instead of { data, error } wrapper
+     *
+     * @throws {Error} If the query fails or returns an error
+     * @example
+     * ```typescript
+     * // Throws error instead of returning { data, error }
+     * try {
+     *   const user = await client
+     *     .from('users')
+     *     .select('*')
+     *     .eq('id', 1)
+     *     .single()
+     *     .throwOnError()
+     * } catch (error) {
+     *   console.error('Query failed:', error)
+     * }
+     * ```
+     */
+    throwOnError(): Promise<T>;
     /**
      * Make QueryBuilder awaitable (implements PromiseLike)
      * This allows using `await client.from('table').select()` without calling `.execute()`
@@ -4767,4 +4872,4 @@ declare class FluxbaseClient<Database = any, _SchemaName extends string & keyof
  */
 declare function createClient<Database = any, SchemaName extends string & keyof Database = any>(fluxbaseUrl: string, fluxbaseKey: string, options?: FluxbaseClientOptions): FluxbaseClient<Database, SchemaName>;
 
-export { type APIKey, APIKeysManager, type AcceptInvitationRequest, type AcceptInvitationResponse, type AdminAuthResponse, type AdminLoginRequest, type AdminMeResponse, type AdminRefreshRequest, type AdminRefreshResponse, type AdminSetupRequest, type AdminSetupStatusResponse, type AdminUser, type AppSettings, AppSettingsManager, type AuthResponse, type AuthResponseData, type AuthSession, type AuthSettings, AuthSettingsManager, type AuthenticationSettings, type BroadcastCallback, type BroadcastMessage, type Column, type CreateAPIKeyRequest, type CreateAPIKeyResponse, type CreateColumnRequest, type CreateFunctionRequest, type CreateInvitationRequest, type CreateInvitationResponse, type CreateOAuthProviderRequest, type CreateOAuthProviderResponse, type CreateSchemaRequest, type CreateSchemaResponse, type CreateTableRequest, type CreateTableResponse, type CreateWebhookRequest, DDLManager, type DataResponse, type DeleteAPIKeyResponse, type DeleteOAuthProviderResponse, type DeleteTableResponse, type DeleteUserResponse, type DeleteWebhookResponse, type EdgeFunction, type EdgeFunctionExecution, type EmailSettings, type EmailTemplate, EmailTemplateManager, type EmailTemplateType, type EnrichedUser, type FeatureSettings, type FileObject, type FilterOperator, FluxbaseAdmin, FluxbaseAuth, type FluxbaseAuthResponse, FluxbaseClient, type FluxbaseClientOptions, type FluxbaseError, FluxbaseFetch, FluxbaseFunctions, FluxbaseManagement, FluxbaseOAuth, FluxbaseRealtime, type FluxbaseResponse, FluxbaseSettings, FluxbaseStorage, type FunctionInvokeOptions, type GetImpersonationResponse, type HttpMethod, type ImpersonateAnonRequest, type ImpersonateServiceRequest, type ImpersonateUserRequest, ImpersonationManager, type ImpersonationSession, type ImpersonationTargetUser, type ImpersonationType, type Invitation, InvitationsManager, type InviteUserRequest, type InviteUserResponse, type ListAPIKeysResponse, type ListEmailTemplatesResponse, type ListImpersonationSessionsOptions, type ListImpersonationSessionsResponse, type ListInvitationsOptions, type ListInvitationsResponse, type ListOAuthProvidersResponse, type ListOptions, type ListSchemasResponse, type ListSystemSettingsResponse, type ListTablesResponse, type ListUsersOptions, type ListUsersResponse, type ListWebhookDeliveriesResponse, type ListWebhooksResponse, type MailgunSettings, type OAuthProvider, OAuthProviderManager, type OrderBy, type OrderDirection, type PostgresChangesConfig, type PostgrestError, type PostgrestResponse, type PresenceCallback, type PresenceState, QueryBuilder, type QueryFilter, type RealtimeBroadcastPayload, type RealtimeCallback, type RealtimeChangePayload, RealtimeChannel, type RealtimeChannelConfig, type RealtimeMessage, type RealtimePostgresChangesPayload, type RealtimePresencePayload, type RequestOptions, type ResetUserPasswordResponse, type RevokeAPIKeyResponse, type RevokeInvitationResponse, type SESSettings, type SMTPSettings, type Schema, type SecuritySettings, type SendGridSettings, type SessionResponse, SettingsClient, type SignInCredentials, type SignInWith2FAResponse, type SignUpCredentials, type SignedUrlOptions, type StartImpersonationResponse, type StopImpersonationResponse, StorageBucket, type StorageObject, type SupabaseAuthResponse, type SupabaseResponse, type SystemSetting, SystemSettingsManager, type Table, type TestEmailTemplateRequest, type TestWebhookResponse, type TwoFactorEnableResponse, type TwoFactorSetupResponse, type TwoFactorStatusResponse, type TwoFactorVerifyRequest, type UpdateAPIKeyRequest, type UpdateAppSettingsRequest, type UpdateAuthSettingsRequest, type UpdateAuthSettingsResponse, type UpdateEmailTemplateRequest, type UpdateFunctionRequest, type UpdateOAuthProviderRequest, type UpdateOAuthProviderResponse, type UpdateSystemSettingRequest, type UpdateUserRoleRequest, type UpdateWebhookRequest, type UploadOptions, type UploadProgress, type User, type UserResponse, type ValidateInvitationResponse, type VoidResponse, type WeakPassword, type Webhook, type WebhookDelivery, WebhooksManager, createClient };
+export { type APIKey, APIKeysManager, type AcceptInvitationRequest, type AcceptInvitationResponse, type AdminAuthResponse, type AdminLoginRequest, type AdminMeResponse, type AdminRefreshRequest, type AdminRefreshResponse, type AdminSetupRequest, type AdminSetupStatusResponse, type AdminUser, type AppSettings, AppSettingsManager, type AuthResponse, type AuthResponseData, type AuthSession, type AuthSettings, AuthSettingsManager, type AuthenticationSettings, type BroadcastCallback, type BroadcastMessage, type Column, type CreateAPIKeyRequest, type CreateAPIKeyResponse, type CreateColumnRequest, type CreateFunctionRequest, type CreateInvitationRequest, type CreateInvitationResponse, type CreateOAuthProviderRequest, type CreateOAuthProviderResponse, type CreateSchemaRequest, type CreateSchemaResponse, type CreateTableRequest, type CreateTableResponse, type CreateWebhookRequest, DDLManager, type DataResponse, type DeleteAPIKeyResponse, type DeleteOAuthProviderResponse, type DeleteTableResponse, type DeleteUserResponse, type DeleteWebhookResponse, type EdgeFunction, type EdgeFunctionExecution, type EmailSettings, type EmailTemplate, EmailTemplateManager, type EmailTemplateType, type EnrichedUser, type FeatureSettings, type FileObject, type FilterOperator, FluxbaseAdmin, FluxbaseAuth, type FluxbaseAuthResponse, FluxbaseClient, type FluxbaseClientOptions, type FluxbaseError, FluxbaseFetch, FluxbaseFunctions, FluxbaseManagement, FluxbaseOAuth, FluxbaseRealtime, type FluxbaseResponse, FluxbaseSettings, FluxbaseStorage, type FunctionInvokeOptions, type GetImpersonationResponse, type HttpMethod, type ImpersonateAnonRequest, type ImpersonateServiceRequest, type ImpersonateUserRequest, ImpersonationManager, type ImpersonationSession, type ImpersonationTargetUser, type ImpersonationType, type Invitation, InvitationsManager, type InviteUserRequest, type InviteUserResponse, type ListAPIKeysResponse, type ListEmailTemplatesResponse, type ListImpersonationSessionsOptions, type ListImpersonationSessionsResponse, type ListInvitationsOptions, type ListInvitationsResponse, type ListOAuthProvidersResponse, type ListOptions, type ListSchemasResponse, type ListSystemSettingsResponse, type ListTablesResponse, type ListUsersOptions, type ListUsersResponse, type ListWebhookDeliveriesResponse, type ListWebhooksResponse, type MailgunSettings, type OAuthProvider, OAuthProviderManager, type OrderBy, type OrderDirection, type PostgresChangesConfig, type PostgrestError, type PostgrestResponse, type PresenceCallback, type PresenceState, QueryBuilder, type QueryFilter, type RealtimeBroadcastPayload, type RealtimeCallback, type RealtimeChangePayload, RealtimeChannel, type RealtimeChannelConfig, type RealtimeMessage, type RealtimePostgresChangesPayload, type RealtimePresencePayload, type RequestOptions, type ResetUserPasswordResponse, type RevokeAPIKeyResponse, type RevokeInvitationResponse, type SESSettings, type SMTPSettings, type Schema, type SecuritySettings, type SendGridSettings, type SessionResponse, SettingsClient, type SignInCredentials, type SignInWith2FAResponse, type SignUpCredentials, type SignedUrlOptions, type StartImpersonationResponse, type StopImpersonationResponse, StorageBucket, type StorageObject, type SupabaseAuthResponse, type SupabaseResponse, type SystemSetting, SystemSettingsManager, type Table, type TestEmailTemplateRequest, type TestWebhookResponse, type TwoFactorEnableResponse, type TwoFactorSetupResponse, type TwoFactorStatusResponse, type TwoFactorVerifyRequest, type UpdateAPIKeyRequest, type UpdateAppSettingsRequest, type UpdateAuthSettingsRequest, type UpdateAuthSettingsResponse, type UpdateEmailTemplateRequest, type UpdateFunctionRequest, type UpdateOAuthProviderRequest, type UpdateOAuthProviderResponse, type UpdateSystemSettingRequest, type UpdateUserRoleRequest, type UpdateWebhookRequest, type UploadOptions, type UploadProgress, type UpsertOptions, type User, type UserResponse, type ValidateInvitationResponse, type VoidResponse, type WeakPassword, type Webhook, type WebhookDelivery, WebhooksManager, createClient };

package/dist/index.js

@@ -3959,8 +3959,11 @@ var QueryBuilder = class {
   constructor(fetch2, table) {
     this.selectQuery = "*";
     this.filters = [];
+    this.orFilters = [];
+    this.andFilters = [];
     this.orderBys = [];
     this.singleRow = false;
+    this.maybeSingleRow = false;
     this.fetch = fetch2;
     this.table = table;
   }
@@ -3989,15 +3992,29 @@ var QueryBuilder = class {
     };
   }
   /**
-   * Upsert (insert or update) rows
+   * Upsert (insert or update) rows (Supabase-compatible)
+   * @param data - Row(s) to upsert
+   * @param options - Upsert options (onConflict, ignoreDuplicates, defaultToNull)
    */
-  async upsert(data) {
+  async upsert(data, options) {
     const body = Array.isArray(data) ? data : data;
-    const response = await this.fetch.post(`/api/v1/tables/${this.table}`, body, {
-      headers: {
-        Prefer: "resolution=merge-duplicates"
-      }
-    });
+    const preferValues = [];
+    if (options?.ignoreDuplicates) {
+      preferValues.push("resolution=ignore-duplicates");
+    } else {
+      preferValues.push("resolution=merge-duplicates");
+    }
+    if (options?.defaultToNull) {
+      preferValues.push("missing=default");
+    }
+    const headers = {
+      Prefer: preferValues.join(",")
+    };
+    let path = `/api/v1/tables/${this.table}`;
+    if (options?.onConflict) {
+      path += `?on_conflict=${encodeURIComponent(options.onConflict)}`;
+    }
+    const response = await this.fetch.post(path, body, { headers });
     return {
       data: response,
       error: null,
@@ -4120,6 +4137,71 @@ var QueryBuilder = class {
     this.filters.push({ column, operator: "fts", value: query });
     return this;
   }
+  /**
+   * Negate a filter condition (Supabase-compatible)
+   * @example not('status', 'eq', 'deleted')
+   * @example not('completed_at', 'is', null)
+   */
+  not(column, operator, value) {
+    this.filters.push({ column, operator: "not", value: `${operator}.${this.formatValue(value)}` });
+    return this;
+  }
+  /**
+   * Apply OR logic to filters (Supabase-compatible)
+   * @example or('status.eq.active,status.eq.pending')
+   * @example or('id.eq.2,name.eq.Han')
+   */
+  or(filters) {
+    this.orFilters.push(filters);
+    return this;
+  }
+  /**
+   * Apply AND logic to filters (Supabase-compatible)
+   * Groups multiple conditions that must all be true
+   * @example and('status.eq.active,verified.eq.true')
+   * @example and('age.gte.18,age.lte.65')
+   */
+  and(filters) {
+    this.andFilters.push(filters);
+    return this;
+  }
+  /**
+   * Match multiple columns with exact values (Supabase-compatible)
+   * Shorthand for multiple .eq() calls
+   * @example match({ id: 1, status: 'active', role: 'admin' })
+   */
+  match(conditions) {
+    for (const [column, value] of Object.entries(conditions)) {
+      this.eq(column, value);
+    }
+    return this;
+  }
+  /**
+   * Generic filter method using PostgREST syntax (Supabase-compatible)
+   * @example filter('name', 'in', '("Han","Yoda")')
+   * @example filter('age', 'gte', '18')
+   */
+  filter(column, operator, value) {
+    this.filters.push({ column, operator, value });
+    return this;
+  }
+  /**
+   * Check if column is contained by value (Supabase-compatible)
+   * For arrays and JSONB
+   * @example containedBy('tags', '["news","update"]')
+   */
+  containedBy(column, value) {
+    this.filters.push({ column, operator: "cd", value });
+    return this;
+  }
+  /**
+   * Check if arrays have common elements (Supabase-compatible)
+   * @example overlaps('tags', '["news","sports"]')
+   */
+  overlaps(column, value) {
+    this.filters.push({ column, operator: "ov", value });
+    return this;
+  }
   /**
    * Order results
    */
@@ -4147,12 +4229,32 @@ var QueryBuilder = class {
   }
   /**
    * Return a single row (adds limit(1))
+   * Errors if no rows found
    */
   single() {
     this.singleRow = true;
     this.limitValue = 1;
     return this;
   }
+  /**
+   * Return a single row or null (adds limit(1))
+   * Does not error if no rows found (Supabase-compatible)
+   * @example
+   * ```typescript
+   * // Returns null instead of erroring when no row exists
+   * const { data, error } = await client
+   *   .from('users')
+   *   .select('*')
+   *   .eq('id', 999)
+   *   .maybeSingle()
+   * // data will be null if no row found
+   * ```
+   */
+  maybeSingle() {
+    this.maybeSingleRow = true;
+    this.limitValue = 1;
+    return this;
+  }
   /**
    * Range selection (pagination)
    */
@@ -4420,6 +4522,25 @@ var QueryBuilder = class {
           statusText: "OK"
         };
       }
+      if (this.maybeSingleRow) {
+        if (Array.isArray(data) && data.length === 0) {
+          return {
+            data: null,
+            error: null,
+            count: 0,
+            status: 200,
+            statusText: "OK"
+          };
+        }
+        const singleData = Array.isArray(data) ? data[0] : data;
+        return {
+          data: singleData,
+          error: null,
+          count: 1,
+          status: 200,
+          statusText: "OK"
+        };
+      }
       return {
         data,
         error: null,
@@ -4441,6 +4562,37 @@ var QueryBuilder = class {
       };
     }
   }
+  /**
+   * Execute the query and throw an error if one occurs (Supabase-compatible)
+   * Returns the data directly instead of { data, error } wrapper
+   *
+   * @throws {Error} If the query fails or returns an error
+   * @example
+   * ```typescript
+   * // Throws error instead of returning { data, error }
+   * try {
+   *   const user = await client
+   *     .from('users')
+   *     .select('*')
+   *     .eq('id', 1)
+   *     .single()
+   *     .throwOnError()
+   * } catch (error) {
+   *   console.error('Query failed:', error)
+   * }
+   * ```
+   */
+  async throwOnError() {
+    const response = await this.execute();
+    if (response.error) {
+      const error = new Error(response.error.message);
+      if (response.error.code) {
+        error.code = response.error.code;
+      }
+      throw error;
+    }
+    return response.data;
+  }
   /**
    * Make QueryBuilder awaitable (implements PromiseLike)
    * This allows using `await client.from('table').select()` without calling `.execute()`
@@ -4468,6 +4620,12 @@ var QueryBuilder = class {
     for (const filter of this.filters) {
       params.append(filter.column, `${filter.operator}.${this.formatValue(filter.value)}`);
     }
+    for (const orFilter of this.orFilters) {
+      params.append("or", `(${orFilter})`);
+    }
+    for (const andFilter of this.andFilters) {
+      params.append("and", `(${andFilter})`);
+    }
     if (this.groupByColumns && this.groupByColumns.length > 0) {
       params.append("group_by", this.groupByColumns.join(","));
     }