@pol-studios/db 1.0.37 → 1.0.39

package/dist/UserMetadataContext-yLZQu24J.d.ts

@@ -0,0 +1,33 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { D as Database } from './useSupabase-DSZNeXnF.js';
+
+type UserMetadataRow = Database["core"]["Tables"]["UserMetadata"]["Row"];
+type UserMetadataInsert = Database["core"]["Tables"]["UserMetadata"]["Insert"];
+type UserMetadataUpdate = Database["core"]["Tables"]["UserMetadata"]["Update"];
+interface UserMetadataContextType {
+    metadata: Record<string, string>;
+    isLoading: boolean;
+    error: Error | null;
+    setMetadata: (key: string, value: string) => Promise<void>;
+    getMetadata: (key: string) => string | undefined;
+    removeMetadata: (key: string) => Promise<void>;
+    refreshMetadata: () => Promise<void>;
+}
+declare const userMetadataContext: react.Context<UserMetadataContextType>;
+declare function UserMetadataProvider({ children }: {
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+declare function useUserMetadata(): UserMetadataContextType;
+declare function useUserMetadataValue(key: string): string | undefined;
+declare function useSetUserMetadata(): {
+    setMetadata: (key: string, value: string) => Promise<void>;
+    removeMetadata: (key: string) => Promise<void>;
+};
+declare function useUserMetadataState<T>(key: string, defaultValue: T, options?: {
+    serialize?: (value: T) => string;
+    deserialize?: (value: string) => T;
+}): [T, (value: T) => Promise<void>, boolean];
+
+export { type UserMetadataContextType as U, useUserMetadata as a, useUserMetadataState as b, useUserMetadataValue as c, userMetadataContext as d, type UserMetadataInsert as e, UserMetadataProvider as f, type UserMetadataRow as g, type UserMetadataUpdate as h, useSetUserMetadata as u };

package/dist/auth/context.d.ts

@@ -1,71 +1,17 @@
-export { j as SimpleAuthContextValue, S as SimpleAuthProvider, i as SimpleAuthProviderProps, k as SimpleProfile, P as SimpleProfileStatus, l as SimpleUserAccess, U as UserMetadataContextType, r as UserMetadataInsert, s as UserMetadataProvider, t as UserMetadataRow, v as UserMetadataUpdate, g as getPermissionLevel, h as hasResourceAccess, a as useRequireAuth, b as useResourceAccess, m as useSetUserMetadata, u as useSimpleAuth, e as useSimpleCanDelete, d as useSimpleCanEdit, f as useSimpleCanShare, c as useSimpleCanView, n as useUserMetadata, o as useUserMetadataState, p as useUserMetadataValue, q as userMetadataContext } from '../UserMetadataContext-QLIv-mfF.js';
+export { P as Profile, a as ProfileStatus, S as SetupAuthContext, b as SetupAuthContextProviderProps, s as setupAuthContext } from '../setupAuthContext-B76nbIP6.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { User } from '@supabase/supabase-js';
-export { P as Profile, a as ProfileStatus, S as SetupAuthContext, b as SetupAuthContextProviderProps, s as setupAuthContext } from '../setupAuthContext-B76nbIP6.js';
 import { d as EntityType, b as EntityPermissionCheck, a as EntityAction } from '../EntityPermissions-DwFt4tUd.js';
+export { U as UserMetadataContextType, e as UserMetadataInsert, f as UserMetadataProvider, g as UserMetadataRow, h as UserMetadataUpdate, u as useSetUserMetadata, a as useUserMetadata, b as useUserMetadataState, c as useUserMetadataValue, d as userMetadataContext } from '../UserMetadataContext-yLZQu24J.js';
+import '@supabase/supabase-js';
 import '../useSupabase-DSZNeXnF.js';
 import '@supabase/supabase-js/dist/module/lib/types.js';
 
-interface PowerSyncDB {
-    getAll: <T>(sql: string, params?: any[]) => Promise<T[]>;
-    getOptional: <T>(sql: string, params?: any[]) => Promise<T | null>;
-    watch: (sql: string, params: any[], options: {
-        onResult: (result: any) => void;
-    }, abortOptions?: {
-        signal: AbortSignal;
-    }) => void;
-}
-interface SupabaseClient {
-    auth: {
-        getUser: () => Promise<{
-            data: {
-                user: User | null;
-            };
-            error: any;
-        }>;
-        getSession: () => Promise<{
-            data: {
-                session: {
-                    user: User;
-                } | null;
-            };
-            error: any;
-        }>;
-        signOut: () => Promise<{
-            error: any;
-        }>;
-        onAuthStateChange: (callback: (event: string, session: any) => void) => {
-            data: {
-                subscription: {
-                    unsubscribe: () => void;
-                };
-            };
-        };
-    };
-}
-interface OfflineAuthProviderProps {
-    children: ReactNode;
-    /** PowerSync database instance */
-    db: PowerSyncDB | null;
-    /** Supabase client for auth */
-    supabase: SupabaseClient;
-    /** Whether PowerSync is ready */
-    isDbReady?: boolean;
-}
-declare function OfflineAuthProvider({ children, db, supabase, isDbReady, }: OfflineAuthProviderProps): react_jsx_runtime.JSX.Element;
-
 interface AuthProviderProps {
     children: ReactNode;
-    /**
-     * Enable entity-level permissions system (Project, Client, ProjectDatabase access control).
-     * When enabled, wraps children with PermissionProvider.
-     * @default false
-     */
-    enableEntityPermissions?: boolean;
 }
-declare function AuthProvider({ children, enableEntityPermissions, }: AuthProviderProps): react_jsx_runtime.JSX.Element;
+declare function AuthProvider({ children }: AuthProviderProps): react_jsx_runtime.JSX.Element;
 
 interface EntityIdentifier {
     entityType: EntityType;
@@ -93,4 +39,4 @@ declare function PermissionProvider({ children }: {
 }): react_jsx_runtime.JSX.Element;
 declare function usePermissions(): PermissionContextValue;
 
-export { AuthProvider, type AuthProviderProps, type EntityPermissionContextValue, OfflineAuthProvider, type OfflineAuthProviderProps, type PermissionContextValue, PermissionProvider, entityPermissionContext, permissionContext, usePermissions };
+export { AuthProvider, type AuthProviderProps, type EntityPermissionContextValue, type PermissionContextValue, PermissionProvider, entityPermissionContext, permissionContext, usePermissions };

package/dist/auth/context.js

@@ -1,16 +1,3 @@
-import {
-  OfflineAuthProvider,
-  SimpleAuthProvider,
-  getPermissionLevel,
-  hasResourceAccess,
-  useCanDelete,
-  useCanEdit,
-  useCanShare,
-  useCanView,
-  useRequireAuth,
-  useResourceAccess,
-  useSimpleAuth
-} from "../chunk-5HJLTYRA.js";
 import {
   AuthProvider,
   PermissionProvider,
@@ -24,8 +11,8 @@ import {
   useUserMetadataState,
   useUserMetadataValue,
   userMetadataContext
-} from "../chunk-YQUNORJD.js";
-import "../chunk-UBHORKBS.js";
+} from "../chunk-MZLEDWJF.js";
+import "../chunk-5SJ5O2NQ.js";
 import "../chunk-J4ZVCXZ4.js";
 import "../chunk-YUX6RGLZ.js";
 import "../chunk-AKIRHA4Q.js";
@@ -33,24 +20,13 @@ import "../chunk-DMVUEJG2.js";
 import "../chunk-7D4SUZUM.js";
 export {
   AuthProvider,
-  OfflineAuthProvider,
   PermissionProvider,
-  SimpleAuthProvider,
   UserMetadataProvider,
   entityPermissionContext,
-  getPermissionLevel,
-  hasResourceAccess,
   permissionContext,
   setupAuthContext,
   usePermissions,
-  useRequireAuth,
-  useResourceAccess,
   useSetUserMetadata,
-  useSimpleAuth,
-  useCanDelete as useSimpleCanDelete,
-  useCanEdit as useSimpleCanEdit,
-  useCanShare as useSimpleCanShare,
-  useCanView as useSimpleCanView,
   useUserMetadata,
   useUserMetadataState,
   useUserMetadataValue,

package/dist/auth/hooks.d.ts

@@ -1,116 +1,12 @@
 import { User } from '@supabase/supabase-js';
-import { k as SimpleProfile, l as SimpleUserAccess } from '../UserMetadataContext-QLIv-mfF.js';
-export { m as useSetUserMetadata, n as useUserMetadata, o as useUserMetadataState, p as useUserMetadataValue } from '../UserMetadataContext-QLIv-mfF.js';
 import { S as SetupAuthContext, E as EffectivePermission } from '../setupAuthContext-B76nbIP6.js';
 import { d as EntityType, a as EntityAction, b as EntityPermissionCheck } from '../EntityPermissions-DwFt4tUd.js';
-import 'react/jsx-runtime';
+export { u as useSetUserMetadata, a as useUserMetadata, b as useUserMetadataState, c as useUserMetadataValue } from '../UserMetadataContext-yLZQu24J.js';
 import 'react';
+import 'react/jsx-runtime';
 import '../useSupabase-DSZNeXnF.js';
 import '@supabase/supabase-js/dist/module/lib/types.js';
 
-/**
- * useOfflineAuth - Hook for offline-first authentication
- *
- * Reads Profile and UserAccess from PowerSync (local SQLite).
- * Works 100% offline once data is synced.
- *
- * Usage:
- * ```tsx
- * import { SimpleAuthProvider } from "@pol-studios/db";
- * import { useOfflineAuth } from "@pol-studios/db";
- *
- * function AuthWrapper({ children }) {
- *   const authData = useOfflineAuth();
- *
- *   return (
- *     <SimpleAuthProvider {...authData}>
- *       {children}
- *     </SimpleAuthProvider>
- *   );
- * }
- * ```
- */
-
-interface OfflineAuthData {
-    /** Supabase user from auth session */
-    user: User | null;
-    /** Profile from PowerSync */
-    profile: SimpleProfile | null;
-    /** User access records from PowerSync */
-    userAccess: SimpleUserAccess[] | null;
-    /** Whether auth data is loading */
-    isLoading: boolean;
-    /** Sign out function */
-    onSignOut: () => Promise<void>;
-}
-interface UseOfflineAuthOptions {
-    /** Supabase client for auth operations */
-    supabase: {
-        auth: {
-            getUser: () => Promise<{
-                data: {
-                    user: User | null;
-                };
-                error: any;
-            }>;
-            signOut: () => Promise<{
-                error: any;
-            }>;
-            onAuthStateChange: (callback: (event: string, session: any) => void) => {
-                data: {
-                    subscription: {
-                        unsubscribe: () => void;
-                    };
-                };
-            };
-        };
-    };
-    /** PowerSync database for local queries */
-    db: {
-        getAll: <T>(sql: string, params?: any[]) => Promise<T[]>;
-        getOptional: <T>(sql: string, params?: any[]) => Promise<T | null>;
-    } | null;
-    /** Whether PowerSync is ready */
-    isDbReady?: boolean;
-}
-/**
- * Query keys for React Query integration
- */
-declare const offlineAuthQueryKeys: {
-    profile: (userId: string | undefined) => readonly ["profile", string];
-    userAccess: (userId: string | undefined) => readonly ["userAccess", string];
-};
-/**
- * Query functions for React Query integration.
- * Use these with useQuery from @tanstack/react-query.
- *
- * @example
- * ```tsx
- * import { useQuery } from "@tanstack/react-query";
- * import { offlineAuthQueries, offlineAuthQueryKeys } from "@pol-studios/db";
- *
- * function useProfile(db, userId) {
- *   return useQuery({
- *     queryKey: offlineAuthQueryKeys.profile(userId),
- *     queryFn: () => offlineAuthQueries.fetchProfile(db, userId),
- *     enabled: !!userId && !!db,
- *   });
- * }
- * ```
- */
-declare const offlineAuthQueries: {
-    fetchProfile(db: {
-        getOptional: <T>(sql: string, params?: any[]) => Promise<T | null>;
-    }, userId: string): Promise<SimpleProfile | null>;
-    fetchUserAccess(db: {
-        getAll: <T>(sql: string, params?: any[]) => Promise<T[]>;
-    }, userId: string): Promise<SimpleUserAccess[]>;
-};
-/**
- * Extract access keys from UserAccess records.
- */
-declare function extractAccessKeys(userAccess: SimpleUserAccess[] | null): string[];
-
 /**
  * Hook for authenticated users only.
  * Throws an error if the user is not authenticated.
@@ -414,4 +310,4 @@ declare function useInvalidatePermission(): (entityType: EntityType, entityId: n
  */
 declare function usePermissionLoading(): boolean;
 
-export { EntityAction, EntityPermissionCheck, EntityType, type EntityWithPermission, type OfflineAuthData, type UseOfflineAuthOptions, extractAccessKeys, offlineAuthQueries, offlineAuthQueryKeys, useAuth, useCanCreate, useCanDelete, useCanEdit, useCanShare, useCanView, useInvalidatePermission, usePermission, usePermissionCheck, usePermissionLoading, usePermissionsBatch, useSetupAuth };
+export { EntityAction, EntityPermissionCheck, EntityType, type EntityWithPermission, useAuth, useCanCreate, useCanDelete, useCanEdit, useCanShare, useCanView, useInvalidatePermission, usePermission, usePermissionCheck, usePermissionLoading, usePermissionsBatch, useSetupAuth };

package/dist/auth/hooks.js

@@ -1,7 +1,4 @@
 import {
-  extractAccessKeys,
-  offlineAuthQueries,
-  offlineAuthQueryKeys,
   useAuth,
   useCanCreate,
   useCanDelete,
@@ -14,23 +11,20 @@ import {
   usePermissionLoading,
   usePermissionsBatch,
   useSetupAuth
-} from "../chunk-7NFMEDJW.js";
+} from "../chunk-D7UZEYKO.js";
 import {
   useSetUserMetadata,
   useUserMetadata,
   useUserMetadataState,
   useUserMetadataValue
-} from "../chunk-YQUNORJD.js";
-import "../chunk-UBHORKBS.js";
+} from "../chunk-MZLEDWJF.js";
+import "../chunk-5SJ5O2NQ.js";
 import "../chunk-J4ZVCXZ4.js";
 import "../chunk-YUX6RGLZ.js";
 import "../chunk-AKIRHA4Q.js";
 import "../chunk-DMVUEJG2.js";
 import "../chunk-7D4SUZUM.js";
 export {
-  extractAccessKeys,
-  offlineAuthQueries,
-  offlineAuthQueryKeys,
   useAuth,
   useCanCreate,
   useCanDelete,

package/dist/auth/index.d.ts

@@ -1,11 +1,11 @@
-export { j as SimpleAuthContextValue, S as SimpleAuthProvider, i as SimpleAuthProviderProps, k as SimpleProfile, P as SimpleProfileStatus, l as SimpleUserAccess, U as UserMetadataContextType, r as UserMetadataInsert, s as UserMetadataProvider, t as UserMetadataRow, v as UserMetadataUpdate, g as getPermissionLevel, h as hasResourceAccess, a as useRequireAuth, b as useResourceAccess, m as useSetUserMetadata, u as useSimpleAuth, e as useSimpleCanDelete, d as useSimpleCanEdit, f as useSimpleCanShare, c as useSimpleCanView, n as useUserMetadata, o as useUserMetadataState, p as useUserMetadataValue, q as userMetadataContext } from '../UserMetadataContext-QLIv-mfF.js';
-export { EntityWithPermission, OfflineAuthData, UseOfflineAuthOptions, extractAccessKeys, offlineAuthQueries, offlineAuthQueryKeys, useAuth, useCanCreate, useCanDelete, useCanEdit, useCanShare, useCanView, useInvalidatePermission, usePermission, usePermissionCheck, usePermissionLoading, usePermissionsBatch, useSetupAuth } from './hooks.js';
-export { AuthProvider, AuthProviderProps, EntityPermissionContextValue, OfflineAuthProvider, OfflineAuthProviderProps, PermissionContextValue, PermissionProvider, entityPermissionContext, permissionContext, usePermissions } from './context.js';
+export { EntityWithPermission, useAuth, useCanCreate, useCanDelete, useCanEdit, useCanShare, useCanView, useInvalidatePermission, usePermission, usePermissionCheck, usePermissionLoading, usePermissionsBatch, useSetupAuth } from './hooks.js';
 export { P as Profile, a as ProfileStatus, S as SetupAuthContext, b as SetupAuthContextProviderProps, s as setupAuthContext } from '../setupAuthContext-B76nbIP6.js';
+export { AuthProvider, AuthProviderProps, EntityPermissionContextValue, PermissionContextValue, PermissionProvider, entityPermissionContext, permissionContext, usePermissions } from './context.js';
+export { U as UserMetadataContextType, e as UserMetadataInsert, f as UserMetadataProvider, g as UserMetadataRow, h as UserMetadataUpdate, u as useSetUserMetadata, a as useUserMetadata, b as useUserMetadataState, c as useUserMetadataValue, d as userMetadataContext } from '../UserMetadataContext-yLZQu24J.js';
 export { hasAccess, hasAllAccess, hasAllEntityAccess, hasAnyAccess, hasAnyEntityAccess, hasEntityAccess, isEntityAccessDenied, isPermissionLoaded } from './guards.js';
 export { E as EntityAccessRecord, a as EntityAction, b as EntityPermissionCheck, c as EntityPermissionLevel, d as EntityType, P as PermissionEffect } from '../EntityPermissions-DwFt4tUd.js';
-import 'react/jsx-runtime';
-import 'react';
 import '@supabase/supabase-js';
+import 'react';
+import 'react/jsx-runtime';
 import '../useSupabase-DSZNeXnF.js';
 import '@supabase/supabase-js/dist/module/lib/types.js';

package/dist/auth/index.js

@@ -1,34 +1,18 @@
-import "../chunk-6KN7KLEG.js";
+import "../chunk-NSIAAYW3.js";
 import {
-  OfflineAuthProvider,
-  SimpleAuthProvider,
-  getPermissionLevel,
-  hasResourceAccess,
+  useAuth,
+  useCanCreate,
   useCanDelete,
   useCanEdit,
   useCanShare,
   useCanView,
-  useRequireAuth,
-  useResourceAccess,
-  useSimpleAuth
-} from "../chunk-5HJLTYRA.js";
-import {
-  extractAccessKeys,
-  offlineAuthQueries,
-  offlineAuthQueryKeys,
-  useAuth,
-  useCanCreate,
-  useCanDelete as useCanDelete2,
-  useCanEdit as useCanEdit2,
-  useCanShare as useCanShare2,
-  useCanView as useCanView2,
   useInvalidatePermission,
   usePermission,
   usePermissionCheck,
   usePermissionLoading,
   usePermissionsBatch,
   useSetupAuth
-} from "../chunk-7NFMEDJW.js";
+} from "../chunk-D7UZEYKO.js";
 import {
   AuthProvider,
   PermissionProvider,
@@ -42,8 +26,8 @@ import {
   useUserMetadataState,
   useUserMetadataValue,
   userMetadataContext
-} from "../chunk-YQUNORJD.js";
-import "../chunk-UBHORKBS.js";
+} from "../chunk-MZLEDWJF.js";
+import "../chunk-5SJ5O2NQ.js";
 import {
   hasAccess,
   hasAllAccess,
@@ -61,47 +45,33 @@ import "../chunk-DMVUEJG2.js";
 import "../chunk-7D4SUZUM.js";
 export {
   AuthProvider,
-  OfflineAuthProvider,
   PermissionProvider,
-  SimpleAuthProvider,
   UserMetadataProvider,
   entityPermissionContext,
-  extractAccessKeys,
-  getPermissionLevel,
   hasAccess,
   hasAllAccess,
   hasAllEntityAccess,
   hasAnyAccess,
   hasAnyEntityAccess,
   hasEntityAccess,
-  hasResourceAccess,
   isEntityAccessDenied,
   isPermissionLoaded,
-  offlineAuthQueries,
-  offlineAuthQueryKeys,
   permissionContext,
   setupAuthContext,
   useAuth,
   useCanCreate,
-  useCanDelete2 as useCanDelete,
-  useCanEdit2 as useCanEdit,
-  useCanShare2 as useCanShare,
-  useCanView2 as useCanView,
+  useCanDelete,
+  useCanEdit,
+  useCanShare,
+  useCanView,
   useInvalidatePermission,
   usePermission,
   usePermissionCheck,
   usePermissionLoading,
   usePermissions,
   usePermissionsBatch,
-  useRequireAuth,
-  useResourceAccess,
   useSetUserMetadata,
   useSetupAuth,
-  useSimpleAuth,
-  useCanDelete as useSimpleCanDelete,
-  useCanEdit as useSimpleCanEdit,
-  useCanShare as useSimpleCanShare,
-  useCanView as useSimpleCanView,
   useUserMetadata,
   useUserMetadataState,
   useUserMetadataValue,

package/dist/{chunk-7P2LGZYQ.js → chunk-3UW5K5PL.js}

@@ -3,12 +3,12 @@ import {
   createAdapterRegistry,
   createSupabaseAdapter,
   stripSchemaPrefix
-} from "./chunk-X747EEWD.js";
+} from "./chunk-AQ5JJKIN.js";
 import {
   DataLayerContext,
   DataLayerCoreContext,
   DataLayerStatusContext
-} from "./chunk-UBHORKBS.js";
+} from "./chunk-5SJ5O2NQ.js";
 import {
   QueryExecutor,
   extractRelationNames,
@@ -4952,4 +4952,4 @@ object-assign/index.js:
   @license MIT
   *)
 */
-//# sourceMappingURL=chunk-7P2LGZYQ.js.map
+//# sourceMappingURL=chunk-3UW5K5PL.js.map

package/dist/{chunk-UBHORKBS.js → chunk-5SJ5O2NQ.js}

@@ -199,6 +199,78 @@ function useDbQuery(table, options = {}) {
   };
 }
 
+// src/hooks/useDbQueryById.ts
+import { useCallback as useCallback2, useEffect as useEffect2, useMemo as useMemo2 } from "react";
+import { useQuery as useQuery2 } from "@tanstack/react-query";
+function buildQueryKey2(table, id, select) {
+  return ["v3", "queryById", table, id, select ?? "*"];
+}
+function useDbQueryById(table, id, options = {}) {
+  const {
+    registry
+  } = useDataLayerCore();
+  const {
+    select,
+    enabled = id != null,
+    staleTime = 3e4
+  } = options;
+  const adapter = useMemo2(() => {
+    try {
+      return registry.getAdapter(table);
+    } catch {
+      return null;
+    }
+  }, [registry, table]);
+  const queryKey = useMemo2(() => buildQueryKey2(table, id, select), [table, id, select]);
+  const queryFn = useCallback2(async () => {
+    if (!adapter) {
+      throw new Error(`Adapter not available for table: ${table}`);
+    }
+    if (id == null) {
+      return null;
+    }
+    if (adapter.queryById) {
+      return adapter.queryById(table, String(id), {
+        select
+      });
+    }
+    const result = await adapter.query(table, {
+      select,
+      where: {
+        id
+      },
+      limit: 1
+    });
+    return result.data[0] ?? null;
+  }, [adapter, table, id, select]);
+  const query = useQuery2({
+    queryKey,
+    queryFn,
+    enabled: enabled && adapter !== null && id != null,
+    staleTime
+  });
+  useEffect2(() => {
+    const adapterName = adapter?.name ?? "unknown";
+    if (query.isError && query.error) {
+      devWarn("useDbQueryById", `${table}(${id}) via ${adapterName}: Error - ${query.error.message}`);
+    }
+    if (query.isSuccess && query.data === null) {
+      devLog("useDbQueryById", `${table}(${id}) via ${adapterName}: not found`);
+    }
+  }, [query.isError, query.error, query.isSuccess, query.data, table, id, adapter]);
+  const refetch = useCallback2(async () => {
+    await query.refetch();
+  }, [query]);
+  return {
+    data: query.data,
+    isLoading: query.isLoading,
+    isPending: query.isPending,
+    isFetching: query.isFetching,
+    error: query.error,
+    refetch
+  };
+}
+
 export {
   DataLayerCoreContext,
   DataLayerStatusContext,
@@ -210,6 +282,7 @@ export {
   useDataLayerOptional,
   devLog,
   devWarn,
-  useDbQuery
+  useDbQuery,
+  useDbQueryById
 };
-//# sourceMappingURL=chunk-UBHORKBS.js.map
+//# sourceMappingURL=chunk-5SJ5O2NQ.js.map