@basictech/react 0.8.0-beta.1 → 0.8.0-beta.3

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @basictech/react@0.7.0 build
+> @basictech/react@0.8.0-beta.1 build
 > tsup
 
 CLI Building entry: src/index.ts
@@ -11,14 +11,14 @@
 CLI Cleaning output folder
 CJS Build start
 ESM Build start
-ESM dist/index.mjs     60.82 KB
-ESM dist/index.mjs.map 128.64 KB
-ESM ⚡️ Build success in 30ms
-CJS dist/index.js     63.30 KB
-CJS dist/index.js.map 128.74 KB
-CJS ⚡️ Build success in 30ms
+CJS dist/index.js     97.02 KB
+CJS dist/index.js.map 187.81 KB
+CJS ⚡️ Build success in 36ms
+ESM dist/index.mjs     93.09 KB
+ESM dist/index.mjs.map 187.75 KB
+ESM ⚡️ Build success in 37ms
 DTS Build start
-DTS ⚡️ Build success in 908ms
-DTS dist/index.d.ts  11.15 KB
-DTS dist/index.d.mts 11.15 KB
+DTS ⚡️ Build success in 1091ms
+DTS dist/index.d.ts  12.66 KB
+DTS dist/index.d.mts 12.66 KB
 ⠙

package/changelog.md

@@ -1,5 +1,17 @@
 # 1.3.4
 
+## 0.8.0-beta.3
+
+### Patch Changes
+
+- Fix PWA/mobile logout issues: harden auth for offline resilience, prevent spurious logouts on transient server errors, proactive token refresh on app resume, and fix potential deadlock in token refresh flow
+
+## 0.8.0-beta.2
+
+### Minor Changes
+
+- added debug bar
+
 ## 0.8.0-beta.1
 
 ### Minor Changes

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import React from 'react';
+import react from 'react';
 export { useLiveQuery as useQuery } from 'dexie-react-hooks';
 
 /**
@@ -265,35 +265,6 @@ type GetTokenOptions = {
     forceRefresh?: boolean;
 };
 
-type AuthConfig = {
-    scopes?: string | string[];
-    /** @deprecated Use pds_url instead */
-    server_url?: string;
-    /** PDS URL for auth and data (default: https://pds.basic.id) */
-    pds_url?: string;
-    /** Admin server URL for connect reporting (default: https://api.basic.tech) */
-    admin_url?: string;
-    ws_url?: string;
-};
-type BasicProviderProps = {
-    children: React.ReactNode;
-    /**
-     * @deprecated Project ID is now extracted from schema.project_id.
-     * This prop is kept for backward compatibility but can be omitted.
-     */
-    project_id?: string;
-    /** The Basic schema object containing project_id and table definitions */
-    schema?: any;
-    debug?: boolean;
-    storage?: BasicStorage;
-    auth?: AuthConfig;
-    /**
-     * Database mode - determines which implementation is used
-     * - 'sync': Uses Dexie + WebSocket for local-first sync (default)
-     * - 'remote': Uses REST API calls directly to server
-     */
-    dbMode?: DBMode;
-};
 declare enum DBStatus {
     LOADING = "LOADING",
     OFFLINE = "OFFLINE",
@@ -301,11 +272,18 @@ declare enum DBStatus {
     ONLINE = "ONLINE",
     SYNCING = "SYNCING",
     ERROR = "ERROR",
-    /** Sync reported an error but will retry (e.g. expired token). Used for status code 4 from dexie-syncable. */
     ERROR_WILL_RETRY = "ERROR_WILL_RETRY",
-    /** Token expired; the SDK is refreshing and will reconnect automatically. */
     ERROR_TOKEN_EXPIRED = "ERROR_TOKEN_EXPIRED"
 }
+/** Snapshot of local schema vs server (for dev toolbar and debugging). */
+type BasicSchemaDevInfo = {
+    projectId: string | null;
+    localVersion: number | undefined;
+    status: string;
+    valid: boolean;
+    lastCheckedAt: number;
+    error?: string;
+};
 /**
  * Context type for useBasic hook
  */
@@ -313,13 +291,9 @@ type BasicContextType = {
     isReady: boolean;
     isSignedIn: boolean;
     user: User | null;
-    /** The user's DID (Decentralized Identifier), extracted from the access token `sub` claim */
     did: string | null;
-    /** Space-separated scope string from the access token */
     scope: string | null;
-    /** Check if a specific scope is granted (e.g., hasScope('profile')) */
     hasScope: (scope: string) => boolean;
-    /** Returns scopes that were requested but not granted in the current token */
     missingScopes: () => string[];
     signIn: () => Promise<void>;
     signInWithHandle: (handle: string) => Promise<void>;
@@ -330,20 +304,62 @@ type BasicContextType = {
     db: BasicDB;
     dbStatus: DBStatus;
     dbMode: DBMode;
-    /** @deprecated Use isReady instead */
+    /** Local schema vs server status; null if no schema on the provider. */
+    devInfo: BasicSchemaDevInfo | null;
+    /** Re-run remote schema check (dev toolbar). */
+    refreshSchemaStatus: () => Promise<void>;
     isAuthReady: boolean;
-    /** @deprecated Use signIn instead */
     signin: () => Promise<void>;
-    /** @deprecated Use signOut instead */
     signout: () => Promise<void>;
-    /** @deprecated Use signInWithCode instead */
     signinWithCode: (code: string, state?: string) => Promise<AuthResult>;
-    /** @deprecated Use getSignInUrl instead */
     getSignInLink: (redirectUri?: string) => Promise<string>;
 };
-declare function BasicProvider({ children, project_id: project_id_prop, schema, debug, storage, auth, dbMode }: BasicProviderProps): react_jsx_runtime.JSX.Element;
 declare function useBasic(): BasicContextType;
 
+type AuthConfig = {
+    scopes?: string | string[];
+    /** @deprecated Use pds_url instead */
+    server_url?: string;
+    /** PDS URL for auth and data (default: https://pds.basic.id) */
+    pds_url?: string;
+    /** Admin server URL for connect reporting (default: https://api.basic.tech) */
+    admin_url?: string;
+    ws_url?: string;
+};
+type BasicProviderProps = {
+    children: react.ReactNode;
+    /**
+     * @deprecated Project ID is now extracted from schema.project_id.
+     * This prop is kept for backward compatibility but can be omitted.
+     */
+    project_id?: string;
+    /** The Basic schema object containing project_id and table definitions */
+    schema?: any;
+    debug?: boolean;
+    storage?: BasicStorage;
+    auth?: AuthConfig;
+    /**
+     * Database mode - determines which implementation is used
+     * - 'sync': Uses Dexie + WebSocket for local-first sync (default)
+     * - 'remote': Uses REST API calls directly to server
+     */
+    dbMode?: DBMode;
+    /** Show floating dev toolbar (localhost, NODE_ENV=development, or debug=true). */
+    devToolbar?: boolean;
+};
+declare function BasicProvider({ children, project_id: project_id_prop, schema, debug, storage, auth, dbMode, devToolbar, }: BasicProviderProps): react_jsx_runtime.JSX.Element;
+
+type BasicDevToolbarProps = {
+    /** When false, toolbar does not render. Defaults to true when used standalone. */
+    enabled?: boolean;
+    /** Same as BasicProvider `debug` — when true, toolbar shows even off localhost. */
+    debug?: boolean;
+};
+/**
+ * Floating dev-only toolbar: auth, DB/sync, and schema status. Requires `BasicProvider` with `debug` or localhost / NODE_ENV=development for visibility unless `enabled` is forced.
+ */
+declare function BasicDevToolbar({ enabled, debug }: BasicDevToolbarProps): react_jsx_runtime.JSX.Element | null;
+
 type ResolvedDid = {
     did: string;
     handle?: string;
@@ -371,4 +387,4 @@ declare function resolveDid(did: string): Promise<ResolvedDid>;
  */
 declare function resolveHandle(handle: string): Promise<ResolvedDid>;
 
-export { type AuthConfig, type AuthError, type AuthResult, type BasicContextType, type BasicDB, BasicProvider, type BasicProviderProps, type BasicStorage, type Collection, type DBMode, DBStatus, type GetTokenOptions$1 as GetTokenOptions, LocalStorageAdapter, NotAuthenticatedError, RemoteCollection, RemoteDB, type RemoteDBConfig, RemoteDBError, type ResolvedDid, STORAGE_KEYS, resolveDid, resolveDidWebUrl, resolveHandle, useBasic };
+export { type AuthConfig, type AuthError, type AuthResult, type BasicContextType, type BasicDB, BasicDevToolbar, type BasicDevToolbarProps, BasicProvider, type BasicProviderProps, type BasicSchemaDevInfo, type BasicStorage, type Collection, type DBMode, DBStatus, type GetTokenOptions$1 as GetTokenOptions, LocalStorageAdapter, NotAuthenticatedError, RemoteCollection, RemoteDB, type RemoteDBConfig, RemoteDBError, type ResolvedDid, STORAGE_KEYS, resolveDid, resolveDidWebUrl, resolveHandle, useBasic };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import React from 'react';
+import react from 'react';
 export { useLiveQuery as useQuery } from 'dexie-react-hooks';
 
 /**
@@ -265,35 +265,6 @@ type GetTokenOptions = {
     forceRefresh?: boolean;
 };
 
-type AuthConfig = {
-    scopes?: string | string[];
-    /** @deprecated Use pds_url instead */
-    server_url?: string;
-    /** PDS URL for auth and data (default: https://pds.basic.id) */
-    pds_url?: string;
-    /** Admin server URL for connect reporting (default: https://api.basic.tech) */
-    admin_url?: string;
-    ws_url?: string;
-};
-type BasicProviderProps = {
-    children: React.ReactNode;
-    /**
-     * @deprecated Project ID is now extracted from schema.project_id.
-     * This prop is kept for backward compatibility but can be omitted.
-     */
-    project_id?: string;
-    /** The Basic schema object containing project_id and table definitions */
-    schema?: any;
-    debug?: boolean;
-    storage?: BasicStorage;
-    auth?: AuthConfig;
-    /**
-     * Database mode - determines which implementation is used
-     * - 'sync': Uses Dexie + WebSocket for local-first sync (default)
-     * - 'remote': Uses REST API calls directly to server
-     */
-    dbMode?: DBMode;
-};
 declare enum DBStatus {
     LOADING = "LOADING",
     OFFLINE = "OFFLINE",
@@ -301,11 +272,18 @@ declare enum DBStatus {
     ONLINE = "ONLINE",
     SYNCING = "SYNCING",
     ERROR = "ERROR",
-    /** Sync reported an error but will retry (e.g. expired token). Used for status code 4 from dexie-syncable. */
     ERROR_WILL_RETRY = "ERROR_WILL_RETRY",
-    /** Token expired; the SDK is refreshing and will reconnect automatically. */
     ERROR_TOKEN_EXPIRED = "ERROR_TOKEN_EXPIRED"
 }
+/** Snapshot of local schema vs server (for dev toolbar and debugging). */
+type BasicSchemaDevInfo = {
+    projectId: string | null;
+    localVersion: number | undefined;
+    status: string;
+    valid: boolean;
+    lastCheckedAt: number;
+    error?: string;
+};
 /**
  * Context type for useBasic hook
  */
@@ -313,13 +291,9 @@ type BasicContextType = {
     isReady: boolean;
     isSignedIn: boolean;
     user: User | null;
-    /** The user's DID (Decentralized Identifier), extracted from the access token `sub` claim */
     did: string | null;
-    /** Space-separated scope string from the access token */
     scope: string | null;
-    /** Check if a specific scope is granted (e.g., hasScope('profile')) */
     hasScope: (scope: string) => boolean;
-    /** Returns scopes that were requested but not granted in the current token */
     missingScopes: () => string[];
     signIn: () => Promise<void>;
     signInWithHandle: (handle: string) => Promise<void>;
@@ -330,20 +304,62 @@ type BasicContextType = {
     db: BasicDB;
     dbStatus: DBStatus;
     dbMode: DBMode;
-    /** @deprecated Use isReady instead */
+    /** Local schema vs server status; null if no schema on the provider. */
+    devInfo: BasicSchemaDevInfo | null;
+    /** Re-run remote schema check (dev toolbar). */
+    refreshSchemaStatus: () => Promise<void>;
     isAuthReady: boolean;
-    /** @deprecated Use signIn instead */
     signin: () => Promise<void>;
-    /** @deprecated Use signOut instead */
     signout: () => Promise<void>;
-    /** @deprecated Use signInWithCode instead */
     signinWithCode: (code: string, state?: string) => Promise<AuthResult>;
-    /** @deprecated Use getSignInUrl instead */
     getSignInLink: (redirectUri?: string) => Promise<string>;
 };
-declare function BasicProvider({ children, project_id: project_id_prop, schema, debug, storage, auth, dbMode }: BasicProviderProps): react_jsx_runtime.JSX.Element;
 declare function useBasic(): BasicContextType;
 
+type AuthConfig = {
+    scopes?: string | string[];
+    /** @deprecated Use pds_url instead */
+    server_url?: string;
+    /** PDS URL for auth and data (default: https://pds.basic.id) */
+    pds_url?: string;
+    /** Admin server URL for connect reporting (default: https://api.basic.tech) */
+    admin_url?: string;
+    ws_url?: string;
+};
+type BasicProviderProps = {
+    children: react.ReactNode;
+    /**
+     * @deprecated Project ID is now extracted from schema.project_id.
+     * This prop is kept for backward compatibility but can be omitted.
+     */
+    project_id?: string;
+    /** The Basic schema object containing project_id and table definitions */
+    schema?: any;
+    debug?: boolean;
+    storage?: BasicStorage;
+    auth?: AuthConfig;
+    /**
+     * Database mode - determines which implementation is used
+     * - 'sync': Uses Dexie + WebSocket for local-first sync (default)
+     * - 'remote': Uses REST API calls directly to server
+     */
+    dbMode?: DBMode;
+    /** Show floating dev toolbar (localhost, NODE_ENV=development, or debug=true). */
+    devToolbar?: boolean;
+};
+declare function BasicProvider({ children, project_id: project_id_prop, schema, debug, storage, auth, dbMode, devToolbar, }: BasicProviderProps): react_jsx_runtime.JSX.Element;
+
+type BasicDevToolbarProps = {
+    /** When false, toolbar does not render. Defaults to true when used standalone. */
+    enabled?: boolean;
+    /** Same as BasicProvider `debug` — when true, toolbar shows even off localhost. */
+    debug?: boolean;
+};
+/**
+ * Floating dev-only toolbar: auth, DB/sync, and schema status. Requires `BasicProvider` with `debug` or localhost / NODE_ENV=development for visibility unless `enabled` is forced.
+ */
+declare function BasicDevToolbar({ enabled, debug }: BasicDevToolbarProps): react_jsx_runtime.JSX.Element | null;
+
 type ResolvedDid = {
     did: string;
     handle?: string;
@@ -371,4 +387,4 @@ declare function resolveDid(did: string): Promise<ResolvedDid>;
  */
 declare function resolveHandle(handle: string): Promise<ResolvedDid>;
 
-export { type AuthConfig, type AuthError, type AuthResult, type BasicContextType, type BasicDB, BasicProvider, type BasicProviderProps, type BasicStorage, type Collection, type DBMode, DBStatus, type GetTokenOptions$1 as GetTokenOptions, LocalStorageAdapter, NotAuthenticatedError, RemoteCollection, RemoteDB, type RemoteDBConfig, RemoteDBError, type ResolvedDid, STORAGE_KEYS, resolveDid, resolveDidWebUrl, resolveHandle, useBasic };
+export { type AuthConfig, type AuthError, type AuthResult, type BasicContextType, type BasicDB, BasicDevToolbar, type BasicDevToolbarProps, BasicProvider, type BasicProviderProps, type BasicSchemaDevInfo, type BasicStorage, type Collection, type DBMode, DBStatus, type GetTokenOptions$1 as GetTokenOptions, LocalStorageAdapter, NotAuthenticatedError, RemoteCollection, RemoteDB, type RemoteDBConfig, RemoteDBError, type ResolvedDid, STORAGE_KEYS, resolveDid, resolveDidWebUrl, resolveHandle, useBasic };