@stacksjs/browser 0.70.293 → 0.70.296

package/dist/composables/useAuth.d.ts

@@ -1,4 +1,21 @@
 import type { AuthComposable } from '../types/dashboard';
+/**
+ * Refresh the session, collapsing concurrent callers onto one exchange.
+ *
+ * Never rejects: an exchange that could not be attempted resolves `false`
+ * without clearing state, so a caller can tell "signed out" from "could not
+ * reach the server" by checking whether `token.value` survived.
+ */
+export declare function refreshSession(): Promise<boolean>;
+/**
+ * `fetch` with the access token attached, retrying once through a refresh on a
+ * 401.
+ *
+ * The retry is attempted only when a refresh token exists and the first
+ * response was a 401 — a 403 is an authorization decision, not an expiry, and
+ * refreshing would not change it.
+ */
+export declare function authFetch(input: string, init?: RequestInit): Promise<Response>;
 export declare function useAuth(): AuthComposable;
 // Strict auth guard middleware
 // Usage: call in setup() of page/component, or in router beforeEach

package/dist/composables/useAuth.js

@@ -1 +1 @@
-import{useStorage}from"@stacksjs/composables";import{ref}from"@stacksjs/stx";import{withCsrfHeader}from"./csrf";const token=useStorage("token",""),stacksConfig=globalThis.__STACKS_CONFIG__||{},baseUrl=stacksConfig.API_URL||(typeof window<"u"?window.location.origin:""),user=ref(null),isAuthenticated=ref(!1);export function useAuth(){async function fetchAuthUser(){try{if(!token.value){isAuthenticated.value=!1;user.value=null;return null}const response=await fetch(`${baseUrl}/me`,{headers:{Authorization:`Bearer ${token.value}`,Accept:"application/json"}});if(!response.ok){token.value="";isAuthenticated.value=!1;user.value=null;return null}const data=await response.json();user.value=data;isAuthenticated.value=!0;return data}catch(error){console.error("Error fetching user:",error);token.value="";isAuthenticated.value=!1;user.value=null;return null}}async function checkAuthentication(){try{return await fetchAuthUser()!==null}catch(error){console.error("Error checking authentication:",error);return!1}}async function register(user){const url=`${baseUrl}/register`,data=await(await fetch(url,{method:"POST",credentials:"same-origin",headers:withCsrfHeader({"Content-Type":"application/json"}),body:JSON.stringify(user)})).json();if(isRegisterError(data))return data;if(isRegisterResponse(data)){token.value=data.token;return data}return data}function isRegisterError(data){return"errors"in data}function isRegisterResponse(data){return"token"in data&&"user"in data}async function login(user){try{const url=`${baseUrl}/login`,response=await fetch(url,{method:"POST",credentials:"same-origin",headers:withCsrfHeader({"Content-Type":"application/json"}),body:JSON.stringify(user)});if(!response.ok){const errorData=await response.json();throw Error(errorData.message||`HTTP error! status: ${response.status}`)}const data=await response.json();token.value=data.token;await fetchAuthUser();return data}catch(error){return error}}async function logout(){try{const currentToken=token.value;if(currentToken)await fetch(`${baseUrl}/logout`,{method:"POST",headers:{Authorization:`Bearer ${currentToken}`,Accept:"application/json"}})}catch(error){console.error("Error during logout:",error)}finally{token.value="";user.value=null;isAuthenticated.value=!1}}return{user,isAuthenticated,token,getToken:()=>token.value,register,login,logout,fetchAuthUser,checkAuthentication}}export function authGuard(options={}){const guest=options.guest??!1,{isAuthenticated}=useAuth();if(guest){if(isAuthenticated.value)window.location.replace("/");return}if(!isAuthenticated.value)window.location.replace("/login")}
+import{readSessionHandoff,stripSessionHandoff,useStorage}from"@stacksjs/composables";import{ref}from"@stacksjs/stx";import{withCsrfHeader}from"./csrf";const token=useStorage("token",""),refreshToken=useStorage("refresh_token",""),stacksConfig=globalThis.__STACKS_CONFIG__||{},baseUrl=stacksConfig.API_URL||(typeof window<"u"?window.location.origin:""),ME_PATH=stacksConfig.AUTH_ME_PATH||"/api/me",REFRESH_PATH=stacksConfig.AUTH_REFRESH_PATH||"/auth/refresh",user=ref(null),isAuthenticated=ref(!1);let inFlightRefresh=null;function applySessionHandoff(pack){const resolved=pack??(typeof window<"u"?readSessionHandoff(window.location.hash):null);if(!resolved)return!1;token.value=resolved.token;if(resolved.refreshToken)refreshToken.value=resolved.refreshToken;if(resolved.user!==void 0&&resolved.user!==null)user.value=resolved.user;isAuthenticated.value=!0;if(typeof window<"u"&&!pack){const rest=stripSessionHandoff(window.location.hash);window.history.replaceState(null,"",`${window.location.pathname}${window.location.search}${rest}`)}return!0}function clearSession(){token.value="";refreshToken.value="";user.value=null;isAuthenticated.value=!1}async function performRefresh(){if(!refreshToken.value)return!1;const response=await fetch(`${baseUrl}${REFRESH_PATH}`,{method:"POST",credentials:"same-origin",headers:withCsrfHeader({"Content-Type":"application/json",Accept:"application/json"}),body:JSON.stringify({refresh_token:refreshToken.value})});if(!response.ok){clearSession();return!1}const data=await response.json(),nextAccess=data.access_token??data.token;if(!nextAccess){clearSession();return!1}token.value=nextAccess;if(data.refresh_token)refreshToken.value=data.refresh_token;return!0}export async function refreshSession(){if(inFlightRefresh)return inFlightRefresh;inFlightRefresh=performRefresh().catch(()=>{return!1}).finally(()=>{inFlightRefresh=null});return inFlightRefresh}export async function authFetch(input,init={}){const send=()=>fetch(input.startsWith("http")?input:`${baseUrl}${input}`,{...init,headers:{...init.headers,...token.value?{Authorization:`Bearer ${token.value}`}:{},Accept:"application/json"}}),response=await send();if(response.status!==401||!refreshToken.value)return response;if(!await refreshSession())return response;return await send()}export function useAuth(){async function fetchAuthUser(){try{if(!token.value){isAuthenticated.value=!1;user.value=null;return null}const response=await authFetch(ME_PATH);if(!response.ok){clearSession();return null}const data=await response.json();user.value=data;isAuthenticated.value=!0;return data}catch(error){console.error("Error fetching user:",error);isAuthenticated.value=!1;user.value=null;return null}}async function checkAuthentication(){try{return await fetchAuthUser()!==null}catch(error){console.error("Error checking authentication:",error);return!1}}async function register(user){const url=`${baseUrl}/register`,data=await(await fetch(url,{method:"POST",credentials:"same-origin",headers:withCsrfHeader({"Content-Type":"application/json"}),body:JSON.stringify(user)})).json();if(isRegisterError(data))return data;if(isRegisterResponse(data)){token.value=data.token;const refreshed=data.refresh_token;if(refreshed)refreshToken.value=refreshed;return data}return data}function isRegisterError(data){return"errors"in data}function isRegisterResponse(data){return"token"in data&&"user"in data}async function login(user){try{const url=`${baseUrl}/login`,response=await fetch(url,{method:"POST",credentials:"same-origin",headers:withCsrfHeader({"Content-Type":"application/json"}),body:JSON.stringify(user)});if(!response.ok){const errorData=await response.json();throw Error(errorData.message||`HTTP error! status: ${response.status}`)}const data=await response.json();token.value=data.token;const refreshed=data.refresh_token;if(refreshed)refreshToken.value=refreshed;await fetchAuthUser();return data}catch(error){return error}}async function logout(){try{const currentToken=token.value;if(currentToken)await fetch(`${baseUrl}/logout`,{method:"POST",headers:{Authorization:`Bearer ${currentToken}`,Accept:"application/json"}})}catch(error){console.error("Error during logout:",error)}finally{clearSession()}}async function completeSocialLogin(pack){const applied=applySessionHandoff(pack),confirmed=await fetchAuthUser();if(confirmed||applied)return confirmed;return null}return{user,isAuthenticated,token,getToken:()=>token.value,register,login,logout,fetchAuthUser,completeSocialLogin,checkAuthentication,refreshToken,getRefreshToken:()=>refreshToken.value,refreshSession,authFetch}}export function authGuard(options={}){const guest=options.guest??!1,{isAuthenticated}=useAuth();if(guest){if(isAuthenticated.value)window.location.replace("/");return}if(!isAuthenticated.value)window.location.replace("/login")}

package/dist/types/dashboard.d.ts

@@ -1,4 +1,5 @@
 import type { Ref } from '@stacksjs/stx';
+import type { SessionHandoffPack } from '@stacksjs/composables';
 export declare function isGeneralError(error: ResponseError): error is { error: string };
 export declare interface ValidationError {
   [key: string]: {
@@ -57,10 +58,15 @@ export declare interface AuthComposable {
   login: (user: AuthUser) => Promise<LoginResponse | LoginError>
   register: (user: AuthUser) => Promise<RegisterResponse | RegisterError>
   fetchAuthUser: () => Promise<UserData | null>
+  completeSocialLogin: (pack?: SessionHandoffPack | null) => Promise<UserData | null>
   checkAuthentication: () => Promise<boolean>
   logout: () => void
   getToken: () => string | null
   token: Ref<string | null>
+  refreshToken: Ref<string | null>
+  getRefreshToken: () => string | null
+  refreshSession: () => Promise<boolean>
+  authFetch: (input: string, init?: RequestInit) => Promise<globalThis.Response>
 }
 export type ResponseError = {
   error: string

package/dist/utils/vendors.d.ts

@@ -16,9 +16,18 @@ export {
   useDark,
   useDateFormat,
   useFetch,
+  // Reachable from a client script at last (stacksjs/stacks#1940, stx#1843).
+  // It shipped with per-field validation, `inputProps()` carrying
+  // aria-invalid / aria-describedby, isSubmitting, touched/dirty and
+  // setErrors for 422 mapping — and appeared in neither auto-import surface,
+  // so there was no way to find it without already knowing the package path.
+  // Two production apps hand-rolled N signals plus manual error flags and
+  // manual focus per form rather than use it.
+  useForm,
   useNow,
   useOnline,
   usePreferredDark,
+  useScrollLock,
   useStorage,
   useToggle,
 } from '@stacksjs/composables';

package/dist/utils/vendors.js

@@ -1 +1 @@
-export{useDark,useDateFormat,useFetch,useNow,useOnline,usePreferredDark,useStorage,useToggle}from"@stacksjs/composables";export{useHead as createHead,useHead as Head,renderHead as renderHeadToString}from"@stacksjs/stx";const DECIMAL_UNITS=["B","KB","MB","GB","TB","PB","EB","ZB","YB"],BINARY_UNITS=["B","KiB","MiB","GiB","TiB","PiB","EiB","ZiB","YiB"];export function readableSize(bytes,options={}){const{precision=1,binary=!1,space=!0,locale="en-US",minimumFractionDigits=0,maximumFractionDigits=precision}=options;if(!Number.isFinite(bytes))throw TypeError(`Expected a finite number, got ${typeof bytes}: ${bytes}`);const isNegative=bytes<0,prefix=isNegative?"-":"";if(isNegative)bytes=-bytes;if(bytes<1){const numberString=bytes.toLocaleString(locale,{minimumFractionDigits,maximumFractionDigits});return`${prefix}${numberString}${space?" ":""}B`}const base=binary?1024:1000,units=binary?BINARY_UNITS:DECIMAL_UNITS,exponent=Math.min(Math.floor(Math.log(bytes)/Math.log(base)),units.length-1),numberString=(bytes/base**exponent).toLocaleString(locale,{minimumFractionDigits,maximumFractionDigits});return`${prefix}${numberString}${space?" ":""}${units[exponent]}`}
+export{useDark,useDateFormat,useFetch,useForm,useNow,useOnline,usePreferredDark,useScrollLock,useStorage,useToggle}from"@stacksjs/composables";export{useHead as createHead,useHead as Head,renderHead as renderHeadToString}from"@stacksjs/stx";const DECIMAL_UNITS=["B","KB","MB","GB","TB","PB","EB","ZB","YB"],BINARY_UNITS=["B","KiB","MiB","GiB","TiB","PiB","EiB","ZiB","YiB"];export function readableSize(bytes,options={}){const{precision=1,binary=!1,space=!0,locale="en-US",minimumFractionDigits=0,maximumFractionDigits=precision}=options;if(!Number.isFinite(bytes))throw TypeError(`Expected a finite number, got ${typeof bytes}: ${bytes}`);const isNegative=bytes<0,prefix=isNegative?"-":"";if(isNegative)bytes=-bytes;if(bytes<1){const numberString=bytes.toLocaleString(locale,{minimumFractionDigits,maximumFractionDigits});return`${prefix}${numberString}${space?" ":""}B`}const base=binary?1024:1000,units=binary?BINARY_UNITS:DECIMAL_UNITS,exponent=Math.min(Math.floor(Math.log(bytes)/Math.log(base)),units.length-1),numberString=(bytes/base**exponent).toLocaleString(locale,{minimumFractionDigits,maximumFractionDigits});return`${prefix}${numberString}${space?" ":""}${units[exponent]}`}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/browser",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.293",
+  "version": "0.70.296",
   "description": "Stacks core frontend/browser functionalities.",
   "author": "Chris Breuer",
   "contributors": [
@@ -63,7 +63,7 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/composables": "0.70.293",
+    "@stacksjs/composables": "0.70.296",
     "@stacksjs/stx": "^0.2.148",
     "bun-query-builder": "^0.2.22"
   },
@@ -77,7 +77,7 @@
   },
   "devDependencies": {
     "better-dx": "^0.2.17",
-    "@stacksjs/utils": "0.70.293",
+    "@stacksjs/utils": "0.70.296",
     "@stripe/stripe-js": "^9.10.0"
   }
 }