@ragable/sdk 0.6.18 → 0.6.20

package/dist/index.d.mts

@@ -590,7 +590,18 @@ declare class AuthBroadcastChannel {
 }
 
 type AuthChangeEvent = "INITIAL_SESSION" | "SIGNED_IN" | "SIGNED_OUT" | "TOKEN_REFRESHED" | "USER_UPDATED";
-interface AuthSession<U extends Record<string, unknown> = Record<string, unknown>> {
+type AuthUserMetadata = Record<string, unknown>;
+interface DefaultAuthUser<Metadata extends AuthUserMetadata = AuthUserMetadata> {
+    id: string;
+    email: string;
+    name: string | null;
+    status: "active" | "disabled" | (string & {});
+    metadata: Metadata;
+    createdAt?: string;
+    updatedAt?: string;
+    lastSignInAt?: string | null;
+}
+interface AuthSession<U extends object = DefaultAuthUser> {
     access_token: string;
     refresh_token: string;
     expires_in: number;
@@ -612,12 +623,31 @@ interface RagableAuthConfig {
     headers?: HeadersInit;
     auth?: AuthOptions;
 }
-type AuthListener<U extends Record<string, unknown>> = (event: AuthChangeEvent, session: AuthSession<U> | null) => void;
+type AuthSignUpCredentials<Metadata extends AuthUserMetadata = AuthUserMetadata> = {
+    email: string;
+    password: string;
+    options?: {
+        data?: Partial<Metadata> & {
+            name?: string | null;
+        };
+    };
+};
+type AuthUpdateUserAttributes<Metadata extends AuthUserMetadata = AuthUserMetadata> = {
+    email?: string;
+    password?: string;
+    data?: Partial<Metadata> & {
+        name?: string | null;
+    };
+};
+type MetadataForUser<U extends object> = U extends {
+    metadata: infer Metadata;
+} ? Metadata extends AuthUserMetadata ? Metadata : AuthUserMetadata : AuthUserMetadata;
+type AuthListener<U extends object> = (event: AuthChangeEvent, session: AuthSession<U> | null) => void;
 interface Subscription {
     id: string;
     unsubscribe: () => void;
 }
-declare class RagableAuth<U extends Record<string, unknown> = Record<string, unknown>> {
+declare class RagableAuth<U extends object = DefaultAuthUser> {
     private readonly fetchImpl;
     private readonly baseUrl;
     private readonly authGroupId;
@@ -638,13 +668,7 @@ declare class RagableAuth<U extends Record<string, unknown> = Record<string, unk
     constructor(config: RagableAuthConfig);
     private log;
     initialize(): Promise<AuthSession<U> | null>;
-    signUp(credentials: {
-        email: string;
-        password: string;
-        options?: {
-            data?: Record<string, unknown>;
-        };
-    }): Promise<PostgrestResult<{
+    signUp(credentials: AuthSignUpCredentials<MetadataForUser<U>>): Promise<PostgrestResult<{
         user: U;
         session: AuthSession<U>;
     }>>;
@@ -680,9 +704,9 @@ declare class RagableAuth<U extends Record<string, unknown> = Record<string, unk
     updateUser(attributes: {
         email?: string;
         password?: string;
-        data?: {
+        data?: (Partial<MetadataForUser<U>> & {
             name?: string | null;
-        };
+        });
     }): Promise<PostgrestResult<{
         user: U;
     }>>;
@@ -692,11 +716,15 @@ declare class RagableAuth<U extends Record<string, unknown> = Record<string, unk
         };
     };
     getAccessToken(): string | null;
+    getValidAccessToken(): Promise<string | null>;
     getCurrentSession(): AuthSession<U> | null;
     register(body: {
         email: string;
         password: string;
         name?: string;
+        data?: Partial<MetadataForUser<U>> & {
+            name?: string | null;
+        };
     }): Promise<{
         user: U;
         accessToken: string;
@@ -723,8 +751,12 @@ declare class RagableAuth<U extends Record<string, unknown> = Record<string, unk
         user: U;
     }>;
     updateMe(body: {
+        email?: string;
         name?: string | null;
         password?: string;
+        data?: Partial<MetadataForUser<U>> & {
+            name?: string | null;
+        };
     }): Promise<{
         user: U;
     }>;
@@ -817,7 +849,7 @@ interface RagableBrowserClientOptions {
     auth?: AuthOptions;
     transport?: Partial<TransportOptions>;
 }
-interface BrowserAuthSession<AuthUser extends Record<string, unknown> = Record<string, unknown>> {
+interface BrowserAuthSession<AuthUser extends object = DefaultAuthUser> {
     user: AuthUser;
     accessToken: string;
     refreshToken: string;
@@ -828,7 +860,7 @@ interface BrowserAuthTokens {
     refreshToken: string;
     expiresIn: string;
 }
-interface SupabaseCompatSession<AuthUser extends Record<string, unknown> = Record<string, unknown>> {
+interface SupabaseCompatSession<AuthUser extends object = DefaultAuthUser> {
     access_token: string;
     refresh_token: string;
     expires_in: number;
@@ -836,17 +868,13 @@ interface SupabaseCompatSession<AuthUser extends Record<string, unknown> = Recor
     user: AuthUser;
 }
 
-declare class RagableBrowserAuthClient<AuthUser extends Record<string, unknown> = Record<string, unknown>> {
+declare class RagableBrowserAuthClient<AuthUser extends object = DefaultAuthUser> {
     private readonly ragableAuth;
     constructor(_options: RagableBrowserClientOptions, ragableAuth?: RagableAuth<AuthUser> | null);
     private get auth();
-    signUp(credentials: {
-        email: string;
-        password: string;
-        options?: {
-            data?: Record<string, unknown>;
-        };
-    }): Promise<PostgrestResult<{
+    signUp(credentials: AuthSignUpCredentials<AuthUser extends {
+        metadata: infer Metadata;
+    } ? Metadata extends AuthUserMetadata ? Metadata : AuthUserMetadata : AuthUserMetadata>): Promise<PostgrestResult<{
         user: AuthUser;
         session: SupabaseCompatSession<AuthUser>;
     }>>;
@@ -864,13 +892,9 @@ declare class RagableBrowserAuthClient<AuthUser extends Record<string, unknown>
     getUser(): Promise<PostgrestResult<{
         user: AuthUser;
     }>>;
-    updateUser(attributes: {
-        email?: string;
-        password?: string;
-        data?: {
-            name?: string | null;
-        };
-    }): Promise<PostgrestResult<{
+    updateUser(attributes: AuthUpdateUserAttributes<AuthUser extends {
+        metadata: infer Metadata;
+    } ? Metadata extends AuthUserMetadata ? Metadata : AuthUserMetadata : AuthUserMetadata>): Promise<PostgrestResult<{
         user: AuthUser;
     }>>;
     signOut(_options?: {
@@ -882,6 +906,11 @@ declare class RagableBrowserAuthClient<AuthUser extends Record<string, unknown>
         email: string;
         password: string;
         name?: string;
+        data?: AuthUser extends {
+            metadata: infer Metadata;
+        } ? Metadata extends AuthUserMetadata ? Partial<Metadata> & {
+            name?: string | null;
+        } : Record<string, unknown> : Record<string, unknown>;
     }): Promise<BrowserAuthSession<AuthUser>>;
     login(body: {
         email: string;
@@ -894,8 +923,14 @@ declare class RagableBrowserAuthClient<AuthUser extends Record<string, unknown>
         user: AuthUser;
     }>;
     updateMe(body: {
+        email?: string;
         name?: string | null;
         password?: string;
+        data?: AuthUser extends {
+            metadata: infer Metadata;
+        } ? Metadata extends AuthUserMetadata ? Partial<Metadata> & {
+            name?: string | null;
+        } : Record<string, unknown> : Record<string, unknown>;
     }): Promise<{
         user: AuthUser;
     }>;
@@ -926,11 +961,29 @@ interface BrowserSqlQueryResult<Row extends Record<string, unknown> = Record<str
     rows: Row[];
 }
 interface BrowserCollectionRecord<Row extends Record<string, unknown> = Record<string, unknown>> {
+    [key: string]: unknown;
     id: string;
     data: Row;
     createdAt: string;
     updatedAt: string;
 }
+/**
+ * Collection APIs return record envelopes, but user schema `Row` types should be
+ * the JSON row inside `record.data`. If generated app types accidentally use the
+ * envelope as `Row`, unwrap it so consumers still get `record.data.<field>`.
+ */
+type BrowserCollectionRowData<Row extends Record<string, unknown> = Record<string, unknown>> = Row extends {
+    id: string;
+    data: infer Data;
+    createdAt: string;
+    updatedAt: string;
+} ? Data extends Record<string, unknown> ? Data : Row : Row;
+type BrowserCollectionInsertData<Row extends Record<string, unknown>, Insert extends Record<string, unknown>> = BrowserCollectionRowData<Row> extends Row ? Insert : Insert extends {
+    data: infer Data;
+} ? Data extends Record<string, unknown> ? Data : BrowserCollectionRowData<Row> : BrowserCollectionRowData<Row>;
+type BrowserCollectionUpdateData<Row extends Record<string, unknown>, Update extends Record<string, unknown>> = BrowserCollectionRowData<Row> extends Row ? Update : Update extends {
+    data?: infer Data;
+} ? Data extends Record<string, unknown> ? Partial<Data> : Partial<BrowserCollectionRowData<Row>> : Partial<BrowserCollectionRowData<Row>>;
 interface BrowserCollectionDefinition {
     id: string;
     name: string;
@@ -963,16 +1016,16 @@ declare class BrowserCollectionApi<Row extends Record<string, unknown> = Record<
     private readonly name;
     private readonly databaseInstanceId?;
     constructor(database: RagableBrowserDatabaseClient<any>, name: string, databaseInstanceId?: string | undefined);
-    find: (whereOrParams?: CollectionWhere<Row> | BrowserCollectionFindParams<Row>) => Promise<PostgrestResult<BrowserCollectionRecord<Row>[]>>;
-    insert: (data: Insert) => Promise<PostgrestResult<BrowserCollectionRecord<Row>>>;
-    update: (where: CollectionWhere<Row>, patch: Update, options?: {
+    find: (whereOrParams?: CollectionWhere<BrowserCollectionRowData<Row>> | BrowserCollectionFindParams<BrowserCollectionRowData<Row>>) => Promise<PostgrestResult<BrowserCollectionRecord<BrowserCollectionRowData<Row>>[]>>;
+    insert: (data: BrowserCollectionInsertData<Row, Insert>) => Promise<PostgrestResult<BrowserCollectionRecord<BrowserCollectionRowData<Row>>>>;
+    update: (where: CollectionWhere<BrowserCollectionRowData<Row>>, patch: BrowserCollectionUpdateData<Row, Update>, options?: {
         limit?: number;
-    }) => Promise<PostgrestResult<BrowserCollectionRecord<Row>[]>>;
-    delete: (where: CollectionWhere<Row>, options?: {
+    }) => Promise<PostgrestResult<BrowserCollectionRecord<BrowserCollectionRowData<Row>>[]>>;
+    delete: (where: CollectionWhere<BrowserCollectionRowData<Row>>, options?: {
         limit?: number;
     }) => Promise<PostgrestResult<{
         deleted: number;
-        records: BrowserCollectionRecord<Row>[];
+        records: BrowserCollectionRecord<BrowserCollectionRowData<Row>>[];
     }>>;
 }
 type BrowserCollections<Database extends RagableDatabase = DefaultRagableDatabase> = [keyof Database["public"]["Tables"]] extends [never] ? Record<string, BrowserCollectionApi<Record<string, unknown>>> : {
@@ -1099,7 +1152,7 @@ interface AgentPublicChatParams extends AgentChatParams {
     triggerSubtype?: string;
     triggerNodeId?: string;
 }
-declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends Record<string, unknown> = Record<string, unknown>> {
+declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser> {
     readonly agents: RagableBrowserAgentsClient;
     readonly auth: RagableBrowserAuthClient<AuthUser>;
     readonly database: RagableBrowserDatabaseClient<Database>;
@@ -1111,7 +1164,7 @@ declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDa
     from: <TableName extends RagableTableNames<Database>>(table: TableName, databaseInstanceId?: string) => PostgrestTableApi<Database, TableName>;
     destroy(): void;
 }
-declare function createBrowserClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends Record<string, unknown> = Record<string, unknown>>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
+declare function createBrowserClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
 declare const createRagableBrowserClient: typeof createBrowserClient;
 
 /**
@@ -1186,7 +1239,7 @@ declare class Ragable {
     constructor(options: RagableClientOptions);
 }
 declare function createClient(options: RagableClientOptions): Ragable;
-declare function createClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends Record<string, unknown> = Record<string, unknown>>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
+declare function createClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
 declare function createRagableServerClient(options: RagableClientOptions): Ragable;
 
-export { type AgentChatMessage, type AgentChatParams, type AgentChatResult, type AgentPublicChatParams, type AgentStreamEvent, type AgentSummary, AgentsClient, AuthBroadcastChannel, type AuthBroadcastMessage, type AuthChangeEvent, type AuthOptions, type AuthSession, type BrowserAuthSession, type BrowserAuthTokens, BrowserCollectionApi, type BrowserCollectionDefinition, type BrowserCollectionFactory, type BrowserCollectionFindParams, type BrowserCollectionRecord, type BrowserCollections, type BrowserDataAuthMode, type BrowserRealtimeNotification, type BrowserRealtimeStatus, type BrowserRealtimeSubscribeParams, type BrowserRealtimeSubscription, type BrowserSqlExecParams, type BrowserSqlExecResult, type BrowserSqlQueryParams, type BrowserSqlQueryResult, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, type DefaultRagableDatabase, type FormatContextOptions, type HttpMethod, type Json, LocalStorageAdapter, MemoryStorageAdapter, type PostgRESTFetch, type PostgRESTFetchParams, PostgrestDeleteReturningBuilder, PostgrestDeleteRootBuilder, PostgrestInsertReturningBuilder, PostgrestInsertRootBuilder, PostgrestInsertSdkErrorReturning, PostgrestInsertSdkErrorRoot, type PostgrestResult, PostgrestSelectBuilder, PostgrestTableApi, PostgrestUpdateReturningBuilder, PostgrestUpdateRootBuilder, type PostgrestUpsertOptions, PostgrestUpsertReturningBuilder, PostgrestUpsertRootBuilder, type RagClientForPipeline, type RagPipeline, type RagPipelineOptions, Ragable, RagableAbortError, RagableAuth, type RagableAuthConfig, RagableBrowser, RagableBrowserAgentsClient, RagableBrowserAuthClient, type RagableBrowserClientOptions, RagableBrowserDatabaseClient, type RagableClientOptions, type RagableDatabase, RagableError, RagableNetworkError, RagableRequestClient, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetrieveParams, type RetryOptions, type RunQuery, type SessionStorage, SessionStorageAdapter, type ShiftAddDocumentParams, ShiftClient, type ShiftCreateIndexParams, type ShiftEntry, type ShiftIndex, type ShiftIngestResponse, type ShiftListEntriesParams, type ShiftListEntriesResponse, type ShiftSearchParams, type ShiftSearchResult, type ShiftUpdateIndexParams, type ShiftUploadFileParams, type ShiftUploadableFile, type SseJsonEvent, type SupabaseCompatSession, type TableInsertRow, type TableRow, type TableUpdatePatch, type Tables, type TablesInsert, type TablesUpdate, Transport, type TransportOptions, type TransportRequest, asPostgrestResponse, bindFetch, createBrowserClient, createClient, createRagPipeline, createRagableBrowserClient, createRagableServerClient, detectStorage, effectiveDataAuth, extractErrorMessage, formatPostgrestError, formatRetrievalContext, formatSdkError, generateIdempotencyKey, normalizeBrowserApiBase, parseSseDataLine, parseTransportResponse, readSseStream };
+export { type AgentChatMessage, type AgentChatParams, type AgentChatResult, type AgentPublicChatParams, type AgentStreamEvent, type AgentSummary, AgentsClient, AuthBroadcastChannel, type AuthBroadcastMessage, type AuthChangeEvent, type AuthOptions, type AuthSession, type AuthSignUpCredentials, type AuthUpdateUserAttributes, type AuthUserMetadata, type BrowserAuthSession, type BrowserAuthTokens, BrowserCollectionApi, type BrowserCollectionDefinition, type BrowserCollectionFactory, type BrowserCollectionFindParams, type BrowserCollectionRecord, type BrowserCollections, type BrowserDataAuthMode, type BrowserRealtimeNotification, type BrowserRealtimeStatus, type BrowserRealtimeSubscribeParams, type BrowserRealtimeSubscription, type BrowserSqlExecParams, type BrowserSqlExecResult, type BrowserSqlQueryParams, type BrowserSqlQueryResult, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, type DefaultAuthUser, type DefaultRagableDatabase, type FormatContextOptions, type HttpMethod, type Json, LocalStorageAdapter, MemoryStorageAdapter, type PostgRESTFetch, type PostgRESTFetchParams, PostgrestDeleteReturningBuilder, PostgrestDeleteRootBuilder, PostgrestInsertReturningBuilder, PostgrestInsertRootBuilder, PostgrestInsertSdkErrorReturning, PostgrestInsertSdkErrorRoot, type PostgrestResult, PostgrestSelectBuilder, PostgrestTableApi, PostgrestUpdateReturningBuilder, PostgrestUpdateRootBuilder, type PostgrestUpsertOptions, PostgrestUpsertReturningBuilder, PostgrestUpsertRootBuilder, type RagClientForPipeline, type RagPipeline, type RagPipelineOptions, Ragable, RagableAbortError, RagableAuth, type RagableAuthConfig, RagableBrowser, RagableBrowserAgentsClient, RagableBrowserAuthClient, type RagableBrowserClientOptions, RagableBrowserDatabaseClient, type RagableClientOptions, type RagableDatabase, RagableError, RagableNetworkError, RagableRequestClient, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetrieveParams, type RetryOptions, type RunQuery, type SessionStorage, SessionStorageAdapter, type ShiftAddDocumentParams, ShiftClient, type ShiftCreateIndexParams, type ShiftEntry, type ShiftIndex, type ShiftIngestResponse, type ShiftListEntriesParams, type ShiftListEntriesResponse, type ShiftSearchParams, type ShiftSearchResult, type ShiftUpdateIndexParams, type ShiftUploadFileParams, type ShiftUploadableFile, type SseJsonEvent, type SupabaseCompatSession, type TableInsertRow, type TableRow, type TableUpdatePatch, type Tables, type TablesInsert, type TablesUpdate, Transport, type TransportOptions, type TransportRequest, asPostgrestResponse, bindFetch, createBrowserClient, createClient, createRagPipeline, createRagableBrowserClient, createRagableServerClient, detectStorage, effectiveDataAuth, extractErrorMessage, formatPostgrestError, formatRetrievalContext, formatSdkError, generateIdempotencyKey, normalizeBrowserApiBase, parseSseDataLine, parseTransportResponse, readSseStream };

package/dist/index.d.ts

@@ -590,7 +590,18 @@ declare class AuthBroadcastChannel {
 }
 
 type AuthChangeEvent = "INITIAL_SESSION" | "SIGNED_IN" | "SIGNED_OUT" | "TOKEN_REFRESHED" | "USER_UPDATED";
-interface AuthSession<U extends Record<string, unknown> = Record<string, unknown>> {
+type AuthUserMetadata = Record<string, unknown>;
+interface DefaultAuthUser<Metadata extends AuthUserMetadata = AuthUserMetadata> {
+    id: string;
+    email: string;
+    name: string | null;
+    status: "active" | "disabled" | (string & {});
+    metadata: Metadata;
+    createdAt?: string;
+    updatedAt?: string;
+    lastSignInAt?: string | null;
+}
+interface AuthSession<U extends object = DefaultAuthUser> {
     access_token: string;
     refresh_token: string;
     expires_in: number;
@@ -612,12 +623,31 @@ interface RagableAuthConfig {
     headers?: HeadersInit;
     auth?: AuthOptions;
 }
-type AuthListener<U extends Record<string, unknown>> = (event: AuthChangeEvent, session: AuthSession<U> | null) => void;
+type AuthSignUpCredentials<Metadata extends AuthUserMetadata = AuthUserMetadata> = {
+    email: string;
+    password: string;
+    options?: {
+        data?: Partial<Metadata> & {
+            name?: string | null;
+        };
+    };
+};
+type AuthUpdateUserAttributes<Metadata extends AuthUserMetadata = AuthUserMetadata> = {
+    email?: string;
+    password?: string;
+    data?: Partial<Metadata> & {
+        name?: string | null;
+    };
+};
+type MetadataForUser<U extends object> = U extends {
+    metadata: infer Metadata;
+} ? Metadata extends AuthUserMetadata ? Metadata : AuthUserMetadata : AuthUserMetadata;
+type AuthListener<U extends object> = (event: AuthChangeEvent, session: AuthSession<U> | null) => void;
 interface Subscription {
     id: string;
     unsubscribe: () => void;
 }
-declare class RagableAuth<U extends Record<string, unknown> = Record<string, unknown>> {
+declare class RagableAuth<U extends object = DefaultAuthUser> {
     private readonly fetchImpl;
     private readonly baseUrl;
     private readonly authGroupId;
@@ -638,13 +668,7 @@ declare class RagableAuth<U extends Record<string, unknown> = Record<string, unk
     constructor(config: RagableAuthConfig);
     private log;
     initialize(): Promise<AuthSession<U> | null>;
-    signUp(credentials: {
-        email: string;
-        password: string;
-        options?: {
-            data?: Record<string, unknown>;
-        };
-    }): Promise<PostgrestResult<{
+    signUp(credentials: AuthSignUpCredentials<MetadataForUser<U>>): Promise<PostgrestResult<{
         user: U;
         session: AuthSession<U>;
     }>>;
@@ -680,9 +704,9 @@ declare class RagableAuth<U extends Record<string, unknown> = Record<string, unk
     updateUser(attributes: {
         email?: string;
         password?: string;
-        data?: {
+        data?: (Partial<MetadataForUser<U>> & {
             name?: string | null;
-        };
+        });
     }): Promise<PostgrestResult<{
         user: U;
     }>>;
@@ -692,11 +716,15 @@ declare class RagableAuth<U extends Record<string, unknown> = Record<string, unk
         };
     };
     getAccessToken(): string | null;
+    getValidAccessToken(): Promise<string | null>;
     getCurrentSession(): AuthSession<U> | null;
     register(body: {
         email: string;
         password: string;
         name?: string;
+        data?: Partial<MetadataForUser<U>> & {
+            name?: string | null;
+        };
     }): Promise<{
         user: U;
         accessToken: string;
@@ -723,8 +751,12 @@ declare class RagableAuth<U extends Record<string, unknown> = Record<string, unk
         user: U;
     }>;
     updateMe(body: {
+        email?: string;
         name?: string | null;
         password?: string;
+        data?: Partial<MetadataForUser<U>> & {
+            name?: string | null;
+        };
     }): Promise<{
         user: U;
     }>;
@@ -817,7 +849,7 @@ interface RagableBrowserClientOptions {
     auth?: AuthOptions;
     transport?: Partial<TransportOptions>;
 }
-interface BrowserAuthSession<AuthUser extends Record<string, unknown> = Record<string, unknown>> {
+interface BrowserAuthSession<AuthUser extends object = DefaultAuthUser> {
     user: AuthUser;
     accessToken: string;
     refreshToken: string;
@@ -828,7 +860,7 @@ interface BrowserAuthTokens {
     refreshToken: string;
     expiresIn: string;
 }
-interface SupabaseCompatSession<AuthUser extends Record<string, unknown> = Record<string, unknown>> {
+interface SupabaseCompatSession<AuthUser extends object = DefaultAuthUser> {
     access_token: string;
     refresh_token: string;
     expires_in: number;
@@ -836,17 +868,13 @@ interface SupabaseCompatSession<AuthUser extends Record<string, unknown> = Recor
     user: AuthUser;
 }
 
-declare class RagableBrowserAuthClient<AuthUser extends Record<string, unknown> = Record<string, unknown>> {
+declare class RagableBrowserAuthClient<AuthUser extends object = DefaultAuthUser> {
     private readonly ragableAuth;
     constructor(_options: RagableBrowserClientOptions, ragableAuth?: RagableAuth<AuthUser> | null);
     private get auth();
-    signUp(credentials: {
-        email: string;
-        password: string;
-        options?: {
-            data?: Record<string, unknown>;
-        };
-    }): Promise<PostgrestResult<{
+    signUp(credentials: AuthSignUpCredentials<AuthUser extends {
+        metadata: infer Metadata;
+    } ? Metadata extends AuthUserMetadata ? Metadata : AuthUserMetadata : AuthUserMetadata>): Promise<PostgrestResult<{
         user: AuthUser;
         session: SupabaseCompatSession<AuthUser>;
     }>>;
@@ -864,13 +892,9 @@ declare class RagableBrowserAuthClient<AuthUser extends Record<string, unknown>
     getUser(): Promise<PostgrestResult<{
         user: AuthUser;
     }>>;
-    updateUser(attributes: {
-        email?: string;
-        password?: string;
-        data?: {
-            name?: string | null;
-        };
-    }): Promise<PostgrestResult<{
+    updateUser(attributes: AuthUpdateUserAttributes<AuthUser extends {
+        metadata: infer Metadata;
+    } ? Metadata extends AuthUserMetadata ? Metadata : AuthUserMetadata : AuthUserMetadata>): Promise<PostgrestResult<{
         user: AuthUser;
     }>>;
     signOut(_options?: {
@@ -882,6 +906,11 @@ declare class RagableBrowserAuthClient<AuthUser extends Record<string, unknown>
         email: string;
         password: string;
         name?: string;
+        data?: AuthUser extends {
+            metadata: infer Metadata;
+        } ? Metadata extends AuthUserMetadata ? Partial<Metadata> & {
+            name?: string | null;
+        } : Record<string, unknown> : Record<string, unknown>;
     }): Promise<BrowserAuthSession<AuthUser>>;
     login(body: {
         email: string;
@@ -894,8 +923,14 @@ declare class RagableBrowserAuthClient<AuthUser extends Record<string, unknown>
         user: AuthUser;
     }>;
     updateMe(body: {
+        email?: string;
         name?: string | null;
         password?: string;
+        data?: AuthUser extends {
+            metadata: infer Metadata;
+        } ? Metadata extends AuthUserMetadata ? Partial<Metadata> & {
+            name?: string | null;
+        } : Record<string, unknown> : Record<string, unknown>;
     }): Promise<{
         user: AuthUser;
     }>;
@@ -926,11 +961,29 @@ interface BrowserSqlQueryResult<Row extends Record<string, unknown> = Record<str
     rows: Row[];
 }
 interface BrowserCollectionRecord<Row extends Record<string, unknown> = Record<string, unknown>> {
+    [key: string]: unknown;
     id: string;
     data: Row;
     createdAt: string;
     updatedAt: string;
 }
+/**
+ * Collection APIs return record envelopes, but user schema `Row` types should be
+ * the JSON row inside `record.data`. If generated app types accidentally use the
+ * envelope as `Row`, unwrap it so consumers still get `record.data.<field>`.
+ */
+type BrowserCollectionRowData<Row extends Record<string, unknown> = Record<string, unknown>> = Row extends {
+    id: string;
+    data: infer Data;
+    createdAt: string;
+    updatedAt: string;
+} ? Data extends Record<string, unknown> ? Data : Row : Row;
+type BrowserCollectionInsertData<Row extends Record<string, unknown>, Insert extends Record<string, unknown>> = BrowserCollectionRowData<Row> extends Row ? Insert : Insert extends {
+    data: infer Data;
+} ? Data extends Record<string, unknown> ? Data : BrowserCollectionRowData<Row> : BrowserCollectionRowData<Row>;
+type BrowserCollectionUpdateData<Row extends Record<string, unknown>, Update extends Record<string, unknown>> = BrowserCollectionRowData<Row> extends Row ? Update : Update extends {
+    data?: infer Data;
+} ? Data extends Record<string, unknown> ? Partial<Data> : Partial<BrowserCollectionRowData<Row>> : Partial<BrowserCollectionRowData<Row>>;
 interface BrowserCollectionDefinition {
     id: string;
     name: string;
@@ -963,16 +1016,16 @@ declare class BrowserCollectionApi<Row extends Record<string, unknown> = Record<
     private readonly name;
     private readonly databaseInstanceId?;
     constructor(database: RagableBrowserDatabaseClient<any>, name: string, databaseInstanceId?: string | undefined);
-    find: (whereOrParams?: CollectionWhere<Row> | BrowserCollectionFindParams<Row>) => Promise<PostgrestResult<BrowserCollectionRecord<Row>[]>>;
-    insert: (data: Insert) => Promise<PostgrestResult<BrowserCollectionRecord<Row>>>;
-    update: (where: CollectionWhere<Row>, patch: Update, options?: {
+    find: (whereOrParams?: CollectionWhere<BrowserCollectionRowData<Row>> | BrowserCollectionFindParams<BrowserCollectionRowData<Row>>) => Promise<PostgrestResult<BrowserCollectionRecord<BrowserCollectionRowData<Row>>[]>>;
+    insert: (data: BrowserCollectionInsertData<Row, Insert>) => Promise<PostgrestResult<BrowserCollectionRecord<BrowserCollectionRowData<Row>>>>;
+    update: (where: CollectionWhere<BrowserCollectionRowData<Row>>, patch: BrowserCollectionUpdateData<Row, Update>, options?: {
         limit?: number;
-    }) => Promise<PostgrestResult<BrowserCollectionRecord<Row>[]>>;
-    delete: (where: CollectionWhere<Row>, options?: {
+    }) => Promise<PostgrestResult<BrowserCollectionRecord<BrowserCollectionRowData<Row>>[]>>;
+    delete: (where: CollectionWhere<BrowserCollectionRowData<Row>>, options?: {
         limit?: number;
     }) => Promise<PostgrestResult<{
         deleted: number;
-        records: BrowserCollectionRecord<Row>[];
+        records: BrowserCollectionRecord<BrowserCollectionRowData<Row>>[];
     }>>;
 }
 type BrowserCollections<Database extends RagableDatabase = DefaultRagableDatabase> = [keyof Database["public"]["Tables"]] extends [never] ? Record<string, BrowserCollectionApi<Record<string, unknown>>> : {
@@ -1099,7 +1152,7 @@ interface AgentPublicChatParams extends AgentChatParams {
     triggerSubtype?: string;
     triggerNodeId?: string;
 }
-declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends Record<string, unknown> = Record<string, unknown>> {
+declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser> {
     readonly agents: RagableBrowserAgentsClient;
     readonly auth: RagableBrowserAuthClient<AuthUser>;
     readonly database: RagableBrowserDatabaseClient<Database>;
@@ -1111,7 +1164,7 @@ declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDa
     from: <TableName extends RagableTableNames<Database>>(table: TableName, databaseInstanceId?: string) => PostgrestTableApi<Database, TableName>;
     destroy(): void;
 }
-declare function createBrowserClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends Record<string, unknown> = Record<string, unknown>>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
+declare function createBrowserClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
 declare const createRagableBrowserClient: typeof createBrowserClient;
 
 /**
@@ -1186,7 +1239,7 @@ declare class Ragable {
     constructor(options: RagableClientOptions);
 }
 declare function createClient(options: RagableClientOptions): Ragable;
-declare function createClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends Record<string, unknown> = Record<string, unknown>>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
+declare function createClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
 declare function createRagableServerClient(options: RagableClientOptions): Ragable;
 
-export { type AgentChatMessage, type AgentChatParams, type AgentChatResult, type AgentPublicChatParams, type AgentStreamEvent, type AgentSummary, AgentsClient, AuthBroadcastChannel, type AuthBroadcastMessage, type AuthChangeEvent, type AuthOptions, type AuthSession, type BrowserAuthSession, type BrowserAuthTokens, BrowserCollectionApi, type BrowserCollectionDefinition, type BrowserCollectionFactory, type BrowserCollectionFindParams, type BrowserCollectionRecord, type BrowserCollections, type BrowserDataAuthMode, type BrowserRealtimeNotification, type BrowserRealtimeStatus, type BrowserRealtimeSubscribeParams, type BrowserRealtimeSubscription, type BrowserSqlExecParams, type BrowserSqlExecResult, type BrowserSqlQueryParams, type BrowserSqlQueryResult, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, type DefaultRagableDatabase, type FormatContextOptions, type HttpMethod, type Json, LocalStorageAdapter, MemoryStorageAdapter, type PostgRESTFetch, type PostgRESTFetchParams, PostgrestDeleteReturningBuilder, PostgrestDeleteRootBuilder, PostgrestInsertReturningBuilder, PostgrestInsertRootBuilder, PostgrestInsertSdkErrorReturning, PostgrestInsertSdkErrorRoot, type PostgrestResult, PostgrestSelectBuilder, PostgrestTableApi, PostgrestUpdateReturningBuilder, PostgrestUpdateRootBuilder, type PostgrestUpsertOptions, PostgrestUpsertReturningBuilder, PostgrestUpsertRootBuilder, type RagClientForPipeline, type RagPipeline, type RagPipelineOptions, Ragable, RagableAbortError, RagableAuth, type RagableAuthConfig, RagableBrowser, RagableBrowserAgentsClient, RagableBrowserAuthClient, type RagableBrowserClientOptions, RagableBrowserDatabaseClient, type RagableClientOptions, type RagableDatabase, RagableError, RagableNetworkError, RagableRequestClient, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetrieveParams, type RetryOptions, type RunQuery, type SessionStorage, SessionStorageAdapter, type ShiftAddDocumentParams, ShiftClient, type ShiftCreateIndexParams, type ShiftEntry, type ShiftIndex, type ShiftIngestResponse, type ShiftListEntriesParams, type ShiftListEntriesResponse, type ShiftSearchParams, type ShiftSearchResult, type ShiftUpdateIndexParams, type ShiftUploadFileParams, type ShiftUploadableFile, type SseJsonEvent, type SupabaseCompatSession, type TableInsertRow, type TableRow, type TableUpdatePatch, type Tables, type TablesInsert, type TablesUpdate, Transport, type TransportOptions, type TransportRequest, asPostgrestResponse, bindFetch, createBrowserClient, createClient, createRagPipeline, createRagableBrowserClient, createRagableServerClient, detectStorage, effectiveDataAuth, extractErrorMessage, formatPostgrestError, formatRetrievalContext, formatSdkError, generateIdempotencyKey, normalizeBrowserApiBase, parseSseDataLine, parseTransportResponse, readSseStream };
+export { type AgentChatMessage, type AgentChatParams, type AgentChatResult, type AgentPublicChatParams, type AgentStreamEvent, type AgentSummary, AgentsClient, AuthBroadcastChannel, type AuthBroadcastMessage, type AuthChangeEvent, type AuthOptions, type AuthSession, type AuthSignUpCredentials, type AuthUpdateUserAttributes, type AuthUserMetadata, type BrowserAuthSession, type BrowserAuthTokens, BrowserCollectionApi, type BrowserCollectionDefinition, type BrowserCollectionFactory, type BrowserCollectionFindParams, type BrowserCollectionRecord, type BrowserCollections, type BrowserDataAuthMode, type BrowserRealtimeNotification, type BrowserRealtimeStatus, type BrowserRealtimeSubscribeParams, type BrowserRealtimeSubscription, type BrowserSqlExecParams, type BrowserSqlExecResult, type BrowserSqlQueryParams, type BrowserSqlQueryResult, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, type DefaultAuthUser, type DefaultRagableDatabase, type FormatContextOptions, type HttpMethod, type Json, LocalStorageAdapter, MemoryStorageAdapter, type PostgRESTFetch, type PostgRESTFetchParams, PostgrestDeleteReturningBuilder, PostgrestDeleteRootBuilder, PostgrestInsertReturningBuilder, PostgrestInsertRootBuilder, PostgrestInsertSdkErrorReturning, PostgrestInsertSdkErrorRoot, type PostgrestResult, PostgrestSelectBuilder, PostgrestTableApi, PostgrestUpdateReturningBuilder, PostgrestUpdateRootBuilder, type PostgrestUpsertOptions, PostgrestUpsertReturningBuilder, PostgrestUpsertRootBuilder, type RagClientForPipeline, type RagPipeline, type RagPipelineOptions, Ragable, RagableAbortError, RagableAuth, type RagableAuthConfig, RagableBrowser, RagableBrowserAgentsClient, RagableBrowserAuthClient, type RagableBrowserClientOptions, RagableBrowserDatabaseClient, type RagableClientOptions, type RagableDatabase, RagableError, RagableNetworkError, RagableRequestClient, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetrieveParams, type RetryOptions, type RunQuery, type SessionStorage, SessionStorageAdapter, type ShiftAddDocumentParams, ShiftClient, type ShiftCreateIndexParams, type ShiftEntry, type ShiftIndex, type ShiftIngestResponse, type ShiftListEntriesParams, type ShiftListEntriesResponse, type ShiftSearchParams, type ShiftSearchResult, type ShiftUpdateIndexParams, type ShiftUploadFileParams, type ShiftUploadableFile, type SseJsonEvent, type SupabaseCompatSession, type TableInsertRow, type TableRow, type TableUpdatePatch, type Tables, type TablesInsert, type TablesUpdate, Transport, type TransportOptions, type TransportRequest, asPostgrestResponse, bindFetch, createBrowserClient, createClient, createRagPipeline, createRagableBrowserClient, createRagableServerClient, detectStorage, effectiveDataAuth, extractErrorMessage, formatPostgrestError, formatRetrievalContext, formatSdkError, generateIdempotencyKey, normalizeBrowserApiBase, parseSseDataLine, parseTransportResponse, readSseStream };

package/dist/index.js

@@ -1820,6 +1820,8 @@ var RagableAuth = class {
             const refreshed = await this._doRefresh(session.refresh_token);
             if (refreshed) {
               this.currentSession = refreshed;
+            } else {
+              await this.storage.removeItem(this.storageKey);
             }
           }
         }
@@ -1837,7 +1839,8 @@ var RagableAuth = class {
       const raw = await this.fetchAuth("/register", "POST", {
         email: credentials.email,
         password: credentials.password,
-        ...name !== void 0 ? { name } : {}
+        ...name !== void 0 ? { name } : {},
+        ...credentials.options?.data !== void 0 ? { data: credentials.options.data } : {}
       });
       const session = this.rawToSession(raw);
       await this.setSessionInternal(session, "SIGNED_IN");
@@ -1907,7 +1910,9 @@ var RagableAuth = class {
       const token = this.currentSession?.access_token;
       if (!token) throw new RagableError("Not authenticated", 401, null);
       const result = await this.fetchAuthWithBearer("/me", "PATCH", token, {
+        ...attributes.email !== void 0 ? { email: attributes.email } : {},
         ...attributes.password !== void 0 ? { password: attributes.password } : {},
+        ...attributes.data !== void 0 ? { data: attributes.data } : {},
         ...attributes.data?.name !== void 0 ? { name: attributes.data.name } : {}
       });
       if (this.currentSession) {
@@ -1932,6 +1937,17 @@ var RagableAuth = class {
   getAccessToken() {
     return this.currentSession?.access_token ?? null;
   }
+  async getValidAccessToken() {
+    if (!this.initialized) await this.initialize();
+    const session = this.currentSession;
+    if (!session) return null;
+    const secondsUntilExpiry = session.expires_at - nowSeconds();
+    if (secondsUntilExpiry <= this.refreshSkewSeconds) {
+      const refreshed = await this.singleFlightRefresh(session.refresh_token);
+      return refreshed?.access_token ?? null;
+    }
+    return session.access_token;
+  }
   getCurrentSession() {
     return this.currentSession;
   }
@@ -2145,7 +2161,7 @@ function requireAuthGroupId(options) {
 }
 async function requireAccessToken(options, ragableAuth) {
   if (ragableAuth) {
-    const token = ragableAuth.getAccessToken();
+    const token = await ragableAuth.getValidAccessToken();
     if (token) return token;
   }
   const getter = options.getAccessToken;
@@ -2764,10 +2780,7 @@ var RagableBrowser = class {
       });
       this.transport.setRefreshHandler(async () => {
         if (effectiveDataAuth(options) !== "user") return null;
-        const session = await this._ragableAuth.singleFlightRefresh(
-          this._ragableAuth.getCurrentSession()?.refresh_token ?? ""
-        );
-        return session?.access_token ?? null;
+        return this._ragableAuth.getValidAccessToken();
       });
       if (!options.getAccessToken && effectiveDataAuth(options) === "user") {
         this._ragableAuth.initialize().catch(() => {