@rebasepro/client-postgresql 0.4.0 → 0.6.0

package/dist/client/src/auth.d.ts

@@ -1,178 +0,0 @@
-import { Transport } from "./transport";
-export interface RebaseUser {
-    uid: string;
-    email: string | null;
-    displayName: string | null;
-    photoURL: string | null;
-    emailVerified?: boolean;
-    roles?: string[];
-    providerId: string;
-    isAnonymous: boolean;
-}
-export interface RebaseTokens {
-    accessToken: string;
-    refreshToken: string;
-    accessTokenExpiresAt: number;
-}
-export interface RebaseSession {
-    accessToken: string;
-    refreshToken: string;
-    expiresAt: number;
-    user: RebaseUser;
-}
-export type AuthChangeEvent = "SIGNED_IN" | "SIGNED_OUT" | "TOKEN_REFRESHED" | "USER_UPDATED";
-export interface AuthConfig {
-    needsSetup: boolean;
-    registrationEnabled: boolean;
-    emailServiceEnabled?: boolean;
-    passwordReset?: boolean;
-    emailVerification?: boolean;
-    enabledProviders: string[];
-}
-export interface AuthStorage {
-    getItem: (key: string) => string | null;
-    setItem: (key: string, value: string) => void;
-    removeItem: (key: string) => void;
-}
-export declare function createMemoryStorage(): AuthStorage;
-export interface CreateAuthOptions {
-    storage?: AuthStorage;
-    authPath?: string;
-    autoRefresh?: boolean;
-    persistSession?: boolean;
-}
-export declare function createAuth(transport: Transport, options?: CreateAuthOptions): {
-    signInWithEmail: (email: string, password: string) => Promise<{
-        user: RebaseUser;
-        accessToken: string;
-        refreshToken: string;
-    }>;
-    signUp: (email: string, password: string, displayName?: string) => Promise<{
-        user: RebaseUser;
-        accessToken: string;
-        refreshToken: string;
-    }>;
-    signInWithGoogle: (payload: {
-        idToken: string;
-    } | {
-        accessToken: string;
-    } | {
-        code: string;
-        redirectUri: string;
-    }) => Promise<{
-        user: RebaseUser;
-        accessToken: string;
-        refreshToken: string;
-    }>;
-    signInWithLinkedin: (code: string, redirectUri: string) => Promise<{
-        user: RebaseUser;
-        accessToken: string;
-        refreshToken: string;
-    }>;
-    signInWithOAuth: (providerId: string, payload: Record<string, unknown>) => Promise<{
-        user: RebaseUser;
-        accessToken: string;
-        refreshToken: string;
-    }>;
-    signInWithGitHub: (code: string, redirectUri: string) => Promise<{
-        user: RebaseUser;
-        accessToken: string;
-        refreshToken: string;
-    }>;
-    signInWithMicrosoft: (code: string, redirectUri: string) => Promise<{
-        user: RebaseUser;
-        accessToken: string;
-        refreshToken: string;
-    }>;
-    signInWithApple: (code: string, redirectUri: string, user?: {
-        name?: {
-            firstName?: string;
-            lastName?: string;
-        };
-        email?: string;
-    }) => Promise<{
-        user: RebaseUser;
-        accessToken: string;
-        refreshToken: string;
-    }>;
-    signInWithFacebook: (code: string, redirectUri: string) => Promise<{
-        user: RebaseUser;
-        accessToken: string;
-        refreshToken: string;
-    }>;
-    signInWithTwitter: (code: string, redirectUri: string, codeVerifier: string) => Promise<{
-        user: RebaseUser;
-        accessToken: string;
-        refreshToken: string;
-    }>;
-    signInWithDiscord: (code: string, redirectUri: string) => Promise<{
-        user: RebaseUser;
-        accessToken: string;
-        refreshToken: string;
-    }>;
-    signInWithGitLab: (code: string, redirectUri: string) => Promise<{
-        user: RebaseUser;
-        accessToken: string;
-        refreshToken: string;
-    }>;
-    signInWithBitbucket: (code: string, redirectUri: string) => Promise<{
-        user: RebaseUser;
-        accessToken: string;
-        refreshToken: string;
-    }>;
-    signInWithSlack: (code: string, redirectUri: string) => Promise<{
-        user: RebaseUser;
-        accessToken: string;
-        refreshToken: string;
-    }>;
-    signInWithSpotify: (code: string, redirectUri: string) => Promise<{
-        user: RebaseUser;
-        accessToken: string;
-        refreshToken: string;
-    }>;
-    signOut: () => Promise<void>;
-    refreshSession: () => Promise<RebaseSession>;
-    getUser: () => Promise<RebaseUser>;
-    updateUser: (updates: {
-        displayName?: string;
-        photoURL?: string;
-    }) => Promise<RebaseUser>;
-    resetPasswordForEmail: (email: string) => Promise<{
-        success: boolean;
-        message: string;
-    }>;
-    resetPassword: (token: string, password: string) => Promise<{
-        success: boolean;
-        message: string;
-    }>;
-    changePassword: (oldPassword: string, newPassword: string) => Promise<{
-        success: boolean;
-        message: string;
-    }>;
-    sendVerificationEmail: () => Promise<{
-        success: boolean;
-        message: string;
-    }>;
-    verifyEmail: (token: string) => Promise<{
-        success: boolean;
-        message: string;
-    }>;
-    getSessions: () => Promise<Record<string, unknown>[]>;
-    revokeSession: (sessionId: string) => Promise<{
-        success: boolean;
-    }>;
-    revokeAllSessions: () => Promise<{
-        success: boolean;
-    }>;
-    getAuthConfig: () => Promise<AuthConfig>;
-    getSession: () => RebaseSession | null;
-    onAuthStateChange: (callback: (event: AuthChangeEvent, session: RebaseSession | null) => void) => () => boolean;
-};
-export interface CookieStorageOptions {
-    path?: string;
-    domain?: string;
-    secure?: boolean;
-    sameSite?: "Lax" | "Strict" | "None";
-    maxAge?: number;
-}
-export declare function createCookieStorage(options?: CookieStorageOptions): AuthStorage;

package/dist/client/src/collection.d.ts

@@ -1,21 +0,0 @@
-import { FindParams, Transport } from "./transport";
-import { RebaseWebSocketClient } from "./websocket";
-import { CollectionAccessor, FilterOperator, LogicalCondition, WhereValue } from "@rebasepro/types";
-import { QueryBuilder } from "./query_builder";
-/**
- * CollectionClient extends `CollectionAccessor` from `@rebasepro/types` so that
- * `client.data` can be passed directly to the core Rebase component.
- *
- * Additionally it exposes fluent query builder methods like `.where()`, `.orderBy()`.
- */
-export interface CollectionClient<M extends Record<string, unknown> = Record<string, unknown>> extends CollectionAccessor<M> {
-    where<K extends keyof M & string>(column: K, operator: FilterOperator, value: WhereValue<M[K]>): QueryBuilder<M>;
-    where(logicalCondition: LogicalCondition): QueryBuilder<M>;
-    orderBy(column: keyof M & string, ascending?: "asc" | "desc"): QueryBuilder<M>;
-    limit(count: number): QueryBuilder<M>;
-    offset(count: number): QueryBuilder<M>;
-    search(searchString: string): QueryBuilder<M>;
-    include(...relations: string[]): QueryBuilder<M>;
-    count(params?: FindParams): Promise<number>;
-}
-export declare function createCollectionClient<M extends Record<string, unknown> = Record<string, unknown>>(transport: Transport, slug: string, ws?: RebaseWebSocketClient): CollectionClient<M>;

package/dist/client/src/cron.d.ts

@@ -1,25 +0,0 @@
-import { Transport } from "./transport";
-import type { CronJobStatus, CronJobLogEntry } from "@rebasepro/types";
-export interface CreateCronOptions {
-    cronPath?: string;
-}
-export declare function createCron(transport: Transport, options?: CreateCronOptions): {
-    listJobs: () => Promise<{
-        jobs: CronJobStatus[];
-    }>;
-    getJob: (jobId: string) => Promise<{
-        job: CronJobStatus;
-    }>;
-    triggerJob: (jobId: string) => Promise<{
-        log: CronJobLogEntry;
-        job: CronJobStatus;
-    }>;
-    getJobLogs: (jobId: string, options?: {
-        limit?: number;
-    }) => Promise<{
-        logs: CronJobLogEntry[];
-    }>;
-    toggleJob: (jobId: string, enabled: boolean) => Promise<{
-        job: CronJobStatus;
-    }>;
-};

package/dist/client/src/functions.d.ts

@@ -1,49 +0,0 @@
-import type { Transport } from "./transport";
-/**
- * Client interface for invoking custom backend functions.
- *
- * Custom functions are Hono route files auto-mounted by the Rebase backend
- * at `/api/functions/{name}`.  The `FunctionsClient` wraps the shared
- * transport so callers never need to manually construct URLs or inject
- * auth tokens.
- *
- * @example
- * ```ts
- * const result = await client.functions.invoke<{ job: Job }>('extract-job', {
- *     url: 'https://example.com/posting',
- *     html: htmlContent,
- * });
- * ```
- */
-export interface FunctionsClient {
-    /**
-     * Invoke a custom backend function by name.
-     *
-     * @typeParam T - Expected shape of the response payload.
-     * @param name    - Function name (the filename without extension, e.g. `"extract-job"`).
-     * @param payload - Optional JSON-serialisable body sent as `POST`.
-     * @param options - Optional overrides (HTTP method, sub-path, extra headers).
-     * @returns The parsed JSON response from the function.
-     */
-    invoke<T = unknown>(name: string, payload?: unknown, options?: FunctionInvokeOptions): Promise<T>;
-}
-export interface FunctionInvokeOptions {
-    /** HTTP method — defaults to `"POST"`. */
-    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-    /** Sub-path appended after the function name, e.g. `"status/123"`. */
-    path?: string;
-    /** Extra headers merged into the request (auth is still injected automatically). */
-    headers?: Record<string, string>;
-}
-/**
- * Create a `FunctionsClient` backed by the given transport.
- *
- * The transport already handles:
- * - Base URL resolution
- * - JWT injection via `Authorization: Bearer`
- * - 401 retry / `onUnauthorized` flow
- * - Consistent error throwing via `RebaseApiError`
- *
- * @internal
- */
-export declare function createFunctionsClient(transport: Transport): FunctionsClient;

package/dist/client/src/index.d.ts

@@ -1,48 +0,0 @@
-import { RebaseClientConfig } from "./transport";
-import { createAuth, CreateAuthOptions } from "./auth";
-import { createAdmin, CreateAdminOptions } from "./admin";
-import { createCron, CreateCronOptions } from "./cron";
-import { CollectionClient } from "./collection";
-import type { FunctionsClient } from "./functions";
-export * from "./transport";
-export * from "./auth";
-export * from "./admin";
-export * from "./cron";
-export * from "./collection";
-export * from "./query_builder";
-export * from "./websocket";
-export * from "./storage";
-export * from "./reviver";
-export * from "./functions";
-export interface CreateRebaseClientOptions extends RebaseClientConfig {
-    auth?: CreateAuthOptions;
-    admin?: CreateAdminOptions;
-    cron?: CreateCronOptions;
-}
-import { RebaseWebSocketClient } from "./websocket";
-import { RebaseClient as BaseRebaseClient, RebaseData, StorageSource } from "@rebasepro/types";
-export type { Entity, FindResponse } from "@rebasepro/types";
-type KebabToCamelCase<S extends string> = S extends `${infer T}-${infer U}` ? `${T}${Capitalize<KebabToCamelCase<U>>}` : S;
-export type RebaseClient<DB = Record<string, unknown>> = Omit<BaseRebaseClient<DB>, "data"> & {
-    setToken: (token: string | null) => void;
-    setAuthTokenGetter: (getter: () => Promise<string | null>) => void;
-    setOnUnauthorized: (handler: () => Promise<boolean>) => void;
-    resolveToken: () => Promise<string | null>;
-    auth: ReturnType<typeof createAuth>;
-    admin: ReturnType<typeof createAdmin>;
-    cron: ReturnType<typeof createCron>;
-    functions: FunctionsClient;
-    ws?: RebaseWebSocketClient;
-    storage?: StorageSource;
-    call: <T = unknown>(endpoint: string, payload?: unknown) => Promise<T>;
-    data: {
-        collection<S extends string>(slug: S): CollectionClient<KebabToCamelCase<S> extends keyof DB ? (DB[KebabToCamelCase<S>] extends {
-            Row: infer R extends Record<string, unknown>;
-        } ? R : Record<string, unknown>) : Record<string, unknown>>;
-    } & {
-        [K in keyof DB]: CollectionClient<DB[K] extends {
-            Row: infer R extends Record<string, unknown>;
-        } ? R : Record<string, unknown>>;
-    } & RebaseData;
-};
-export declare function createRebaseClient<DB = Record<string, unknown>>(options: CreateRebaseClientOptions): RebaseClient<DB>;

package/dist/client/src/query_builder.d.ts

@@ -1 +0,0 @@
-export { QueryBuilder, or, and, cond } from "@rebasepro/common";

package/dist/client/src/reviver.d.ts

@@ -1 +0,0 @@
-export declare function rebaseReviver(_key: string, value: unknown): unknown;

package/dist/client/src/storage.d.ts

@@ -1,3 +0,0 @@
-import { StorageSource } from "@rebasepro/types";
-import { Transport } from "./transport";
-export declare function createStorage(transport: Transport): StorageSource;

package/dist/client/src/transport.d.ts

@@ -1,33 +0,0 @@
-import { FindParams as TypesFindParams, FindResponse as TypesFindResponse } from "@rebasepro/types";
-export interface RebaseClientConfig {
-    baseUrl?: string;
-    token?: string;
-    apiPath?: string;
-    fetch?: typeof globalThis.fetch;
-    onUnauthorized?: () => Promise<boolean>;
-    websocketUrl?: string;
-}
-/**
- * Re-export from `@rebasepro/types` for backward compatibility.
- */
-export type FindParams = TypesFindParams;
-export type FindResponse<T> = TypesFindResponse<T extends Record<string, unknown> ? T : Record<string, unknown>>;
-export declare class RebaseApiError extends Error {
-    status: number;
-    code?: string;
-    details?: unknown;
-    constructor(status: number, message: string, code?: string, details?: unknown);
-}
-export declare function buildQueryString(params?: FindParams): string;
-export interface Transport {
-    request: <T = unknown>(path: string, init?: RequestInit) => Promise<T>;
-    setToken: (newToken: string | null) => void;
-    setAuthTokenGetter: (getter: () => Promise<string | null>) => void;
-    setOnUnauthorized: (handler: () => Promise<boolean>) => void;
-    readonly baseUrl: string;
-    readonly apiPath: string;
-    readonly fetchFn: typeof globalThis.fetch;
-    getHeaders: (init?: RequestInit) => Record<string, string>;
-    resolveToken: () => Promise<string | null>;
-}
-export declare function createTransport(config: RebaseClientConfig): Transport;

package/dist/client/src/websocket.d.ts

@@ -1,105 +0,0 @@
-import { DeleteEntityProps, Entity, EntityCollection, FetchCollectionProps, FetchEntityProps, SaveEntityProps, TableMetadata, BranchInfo } from "@rebasepro/types";
-export interface RebaseWebSocketConfig {
-    websocketUrl: string;
-    /** Optional auth token getter for WebSocket authentication */
-    getAuthToken?: () => Promise<string>;
-    /** Optional WebSocket constructor to override globalThis.WebSocket (e.g. for Node environments) */
-    WebSocket?: typeof WebSocket;
-    /** Callback to handle unauthorized requests or token expiration (refreshes auth session) */
-    onUnauthorized?: () => Promise<boolean>;
-}
-export declare class ApiError extends Error {
-    code?: string;
-    error?: string;
-    constructor(message: string, error?: string, code?: string);
-}
-export declare class RebaseWebSocketClient {
-    private websocketUrl;
-    private ws;
-    getAuthToken?: () => Promise<string>;
-    private subscriptions;
-    private listeners;
-    on(event: "connect" | "disconnect" | "reconnect" | "error", cb: (...args: unknown[]) => void): () => boolean;
-    private emit;
-    private collectionSubscriptions;
-    private entitySubscriptions;
-    private backendToCollectionKey;
-    private backendToEntityKey;
-    private pendingRequests;
-    private reconnectAttempts;
-    private maxReconnectAttempts;
-    private isConnected;
-    private messageQueue;
-    private reconnectTimeout;
-    private isAuthenticated;
-    private authPromise;
-    private WebSocketConstructor;
-    onUnauthorized?: () => Promise<boolean>;
-    private refreshInProgress;
-    constructor(config: RebaseWebSocketConfig);
-    /**
-     * Authenticate the WebSocket connection
-     */
-    authenticate(token: string): Promise<void>;
-    /**
-     * Set the auth token getter function
-     */
-    setAuthTokenGetter(getAuthToken: () => Promise<string>): void;
-    disconnect(): void;
-    private initWebSocket;
-    private processMessageQueue;
-    private attemptReconnect;
-    private isAuthError;
-    private handleAuthFailure;
-    private handleWebSocketMessage;
-    private ensureAuthenticated;
-    /**
-     * Force re-authentication (call after token refresh)
-     */
-    reauthenticate(): Promise<void>;
-    private sendMessage;
-    private doSendMessage;
-    fetchCollection<M extends Record<string, unknown>>(props: FetchCollectionProps<M>): Promise<Entity<M>[]>;
-    fetchEntity<M extends Record<string, unknown>>(props: FetchEntityProps<M>): Promise<Entity<M> | undefined>;
-    saveEntity<M extends Record<string, unknown>>(props: SaveEntityProps<M>): Promise<Entity<M>>;
-    deleteEntity<M extends Record<string, unknown>>(props: DeleteEntityProps<M>): Promise<void>;
-    executeSql(sql: string, options?: {
-        database?: string;
-        role?: string;
-    }): Promise<Record<string, unknown>[]>;
-    fetchAvailableDatabases(): Promise<string[]>;
-    fetchAvailableRoles(): Promise<string[]>;
-    fetchCurrentDatabase(): Promise<string | undefined>;
-    checkUniqueField(path: string, name: string, value: unknown, entityId?: string, collection?: EntityCollection): Promise<boolean>;
-    countEntities<M extends Record<string, unknown>>(props: FetchCollectionProps<M>): Promise<number>;
-    fetchUnmappedTables(mappedPaths?: string[]): Promise<string[]>;
-    fetchTableMetadata(tableName: string): Promise<TableMetadata>;
-    createBranch(name: string, options?: {
-        source?: string;
-    }): Promise<BranchInfo>;
-    deleteBranch(name: string): Promise<void>;
-    listBranches(): Promise<BranchInfo[]>;
-    /**
-     * Recursively compare two values for structural equality.
-     * Handles primitives, null, undefined, Date, RegExp, arrays, and plain objects.
-     */
-    private deepEqual;
-    private normalizeForComparison;
-    /**
-     * Merge incoming entities with cached data, preserving cached references
-     * for entities whose values haven't changed. This avoids unnecessary
-     * React re-renders when the server refetches all entities but most
-     * haven't actually changed.
-     */
-    private mergeEntities;
-    listenCollection<M extends Record<string, unknown>>(props: FetchCollectionProps<M>, onUpdate: (entities: Entity[]) => void, onError?: (error: Error) => void): () => void;
-    listenEntity<M extends Record<string, unknown>>(props: FetchEntityProps<M>, onUpdate: (entity: Entity | null) => void, onError?: (error: Error) => void): () => void;
-    /**
-     * Re-send all active subscriptions to the backend after a reconnect.
-     * The server wipes subscription state when a client disconnects, so
-     * we need to re-register everything to resume receiving updates.
-     */
-    private resubscribeAll;
-    private createCollectionSubscriptionKey;
-    private createEntitySubscriptionKey;
-}

package/dist/types/src/controllers/analytics_controller.d.ts

@@ -1,7 +0,0 @@
-export type AnalyticsController = {
-    /**
-     * Callback used to get analytics events from the CMS
-     */
-    onAnalyticsEvent?: (event: AnalyticsEvent, data?: object) => void;
-};
-export type AnalyticsEvent = "entity_click" | "entity_click_from_reference" | "reference_selection_clear" | "reference_selection_toggle" | "reference_selected_single" | "reference_selection_new_entity" | "edit_entity_clicked" | "entity_edited" | "new_entity_click" | "new_entity_saved" | "copy_entity_click" | "entity_copied" | "single_delete_dialog_open" | "multiple_delete_dialog_open" | "single_entity_deleted" | "multiple_entities_deleted" | "drawer_navigate_to_home" | "drawer_navigate_to_collection" | "drawer_navigate_to_view" | "home_navigate_to_collection" | "home_favorite_navigate_to_collection" | "home_navigate_to_view" | "home_navigate_to_admin_view" | "home_favorite_navigate_to_view" | "home_move_card" | "home_move_group" | "home_drop_new_group" | "collection_inline_editing" | "view_mode_changed" | "kanban_card_moved" | "kanban_column_reorder" | "kanban_property_changed" | "kanban_new_entity_in_column" | "kanban_backfill_order" | "card_view_entity_click" | "unmapped_event";

package/dist/types/src/controllers/auth.d.ts

@@ -1,104 +0,0 @@
-import type { User } from "../users";
-/**
- * Capabilities advertised by an auth provider.
- * UI components use this to show/hide features dynamically
- * (e.g. password reset, registration, session management).
- * @group Hooks and utilities
- */
-export interface AuthCapabilities {
-    emailPasswordLogin?: boolean;
-    googleLogin?: boolean;
-    registration?: boolean;
-    passwordReset?: boolean;
-    sessionManagement?: boolean;
-    profileUpdate?: boolean;
-    emailVerification?: boolean;
-    /** List of enabled OAuth provider IDs (e.g. ["google", "github", "discord"]) */
-    enabledProviders?: string[];
-}
-/**
- * Controller for retrieving the logged user or performing auth related operations.
- * Note that if you are implementing your AuthController, you probably will want
- * to do it as the result of a hook.
- * @group Hooks and utilities
- */
-export type AuthController<USER extends User = User, ExtraData = unknown> = {
-    /**
-     * The user currently logged in
-     * The values can be: the user object, null if they skipped login
-     */
-    user: USER | null;
-    /**
-     * Initial loading flag. It is used not to display the login screen
-     * when the app first loads, and it has not been checked whether the user
-     * is logged in or not.
-     */
-    initialLoading?: boolean;
-    /**
-     * Loading flag. It is used to display a loading screen when the user is
-     * logging in or out.
-     */
-    authLoading: boolean;
-    /**
-     * Sign out
-     */
-    signOut: () => Promise<void>;
-    /**
-     * Error initializing the authentication
-     */
-    authError?: unknown;
-    /**
-     * Error dispatched by the auth provider
-     */
-    authProviderError?: unknown;
-    /**
-     * You can use this method to retrieve the auth token for the current user.
-     */
-    getAuthToken: () => Promise<string>;
-    /**
-     * Has the user skipped the login process
-     */
-    loginSkipped: boolean;
-    extra: ExtraData;
-    setExtra: (extra: ExtraData) => void;
-    setUser?(user: USER | null): void;
-    setUserRoles?(roles: string[]): void;
-    /**
-     * Capabilities advertised by the auth provider.
-     * UI components use this to feature-detect what the backend supports.
-     */
-    capabilities?: AuthCapabilities;
-};
-/**
- * Extended auth controller with common optional auth methods.
- * Backend implementations (Rebase backend, Firebase, Supabase, etc.)
- * extend this with their own backend-specific extras.
- * @group Hooks and utilities
- */
-export interface AuthControllerExtended<USER extends User = User, ExtraData = unknown> extends AuthController<USER, ExtraData> {
-    /** Login with email and password */
-    emailPasswordLogin?(email: string, password: string): Promise<void>;
-    /** Login with Google — accepts an ID token, access token, or authorization code payload */
-    googleLogin?: (payload: {
-        idToken: string;
-    } | {
-        accessToken: string;
-    } | {
-        code: string;
-        redirectUri: string;
-    }) => Promise<void>;
-    /** Generic OAuth login — works with any provider. Posts payload to /auth/{providerId}. */
-    oauthLogin?: (providerId: string, payload: Record<string, unknown>) => Promise<void>;
-    /** Register a new user */
-    register?(email: string, password: string, displayName?: string): Promise<void>;
-    /** Skip login (for anonymous access if enabled) */
-    skipLogin?(): void;
-    /** Request password reset email */
-    forgotPassword?(email: string): Promise<void>;
-    /** Reset password using a token */
-    resetPassword?(token: string, password: string): Promise<void>;
-    /** Change password for the authenticated user */
-    changePassword?(oldPassword: string, newPassword: string): Promise<void>;
-    /** Update user profile */
-    updateProfile?(displayName?: string, photoURL?: string): Promise<USER>;
-}