@djangocfg/api 2.1.469 → 2.1.471

package/dist/auth.d.cts

@@ -1059,10 +1059,19 @@ declare const logger: consola.ConsolaInstance;
 declare const authLogger: consola.ConsolaInstance;
 
 /**
- * Analytics stub for @djangocfg/api/auth
- * Provides minimal analytics interface without external dependencies
+ * Auth analytics — a dependency-free SINK, not an implementation.
  *
- * If you need full analytics, install @djangocfg/layouts and use its Analytics module
+ * `@djangocfg/api` cannot depend on `@djangocfg/analytics`: analytics reads auth
+ * state (to attribute events to a signed-in user), so importing it here would
+ * close a dependency cycle. Instead this module owns the *interface* and lets a
+ * real implementation be injected at runtime — `@djangocfg/analytics` calls
+ * `setAnalyticsSink()` when its provider mounts.
+ *
+ * Before this, the object below was a hardcoded stub that console.logged in dev
+ * and did NOTHING in production. Every auth event it "tracked" —
+ * AUTH_LOGIN_SUCCESS, AUTH_OAUTH_FAIL, AUTH_SESSION_EXPIRED — was silently
+ * discarded. The events were fired, the calls looked right, and nothing ever
+ * arrived anywhere.
  */
 declare enum AnalyticsEvent {
     AUTH_OTP_REQUEST = "auth_otp_request",
@@ -1086,19 +1095,23 @@ interface AnalyticsEventParams {
     value?: number;
     [key: string]: any;
 }
+/** What an analytics implementation must provide to receive auth events. */
+interface AnalyticsSink {
+    event(name: string, params?: Record<string, any>): void;
+    setUser(userId: string | null): void;
+}
 /**
- * Minimal analytics implementation
- * Logs to console in development, silent in production
+ * Install the real analytics implementation.
+ *
+ * Called by `@djangocfg/analytics` when its provider mounts. Pass `null` to
+ * uninstall (on unmount), so a torn-down provider does not keep receiving events.
  */
+declare function setAnalyticsSink(next: AnalyticsSink | null): void;
 declare const Analytics: {
-    /**
-     * Track an analytics event
-     */
+    /** Track an auth event. Delivered to the installed sink, if any. */
     event(eventName: AnalyticsEventType, params?: AnalyticsEventParams): void;
-    /**
-     * Set user ID for tracking
-     */
-    setUser(userId: string): void;
+    /** Attach the signed-in user. Pass null on logout. */
+    setUser(userId: string | null): void;
 };
 
-export { AUTH_CONSTANTS, type AccountsContextValue, AccountsProvider, Analytics, AnalyticsCategory, type AnalyticsCategoryType, AnalyticsEvent, type AnalyticsEventType, type AuthConfig, AuthContext, type AuthContextType, type AuthFormAutoSubmit, type AuthFormReturn, type AuthFormState, type AuthFormStateHandlers, type AuthFormSubmitHandlers, type AuthFormValidation, AuthProvider, type AuthProviderProps, type AuthStep, type DeleteAccountResult, type GuardInput, type OTPRequestResult, type PatchedCfgUserUpdateRequest, PatchedCfgUserUpdateRequestSchema, type ProfileCacheOptions, type SessionSnapshot, type SessionStatus, type TwoFactorDevice, type TwoFactorSetupData, type UseAuthFormOptions, type UseAuthFormStateReturn, type UseAutoAuthOptions, type UseDeleteAccountReturn, type UseGithubAuthOptions, type UseGithubAuthReturn, type UseTwoFactorOptions, type UseTwoFactorReturn, type UseTwoFactorSetupOptions, type UseTwoFactorSetupReturn, type UseTwoFactorStatusReturn, type UseTwoFactorVerifyOptions, type UseTwoFactorVerifyReturn, type UserProfile, type WebmailLink, authLogger, clearProfileCache, consumeSavedRedirect, decodeBase64, encodeBase64, formatAuthError, getCacheMetadata, getCachedProfile, hasValidCache, isAllowedAuthPath, logger, normalizePath, peekSavedRedirect, resolveGuardIsAuthenticated, resolveGuardIsLoading, setCachedProfile, shouldRedirectToAuth, useAccountsContext, useAuth, useAuthForm, useAuthFormState, useAuthRedirectManager, useAuthValidation, useAutoAuth, useBase64, useCfgRouter, useDeleteAccount, useGithubAuth, useLocalStorage, useQueryParams, useSession, useSessionStorage, useTwoFactor, useTwoFactorSetup, useTwoFactorStatus, useTwoFactorVerify, validateEmail, validateIdentifier };
+export { AUTH_CONSTANTS, type AccountsContextValue, AccountsProvider, Analytics, AnalyticsCategory, type AnalyticsCategoryType, AnalyticsEvent, type AnalyticsEventType, type AnalyticsSink, type AuthConfig, AuthContext, type AuthContextType, type AuthFormAutoSubmit, type AuthFormReturn, type AuthFormState, type AuthFormStateHandlers, type AuthFormSubmitHandlers, type AuthFormValidation, AuthProvider, type AuthProviderProps, type AuthStep, type DeleteAccountResult, type GuardInput, type OTPRequestResult, type PatchedCfgUserUpdateRequest, PatchedCfgUserUpdateRequestSchema, type ProfileCacheOptions, type SessionSnapshot, type SessionStatus, type TwoFactorDevice, type TwoFactorSetupData, type UseAuthFormOptions, type UseAuthFormStateReturn, type UseAutoAuthOptions, type UseDeleteAccountReturn, type UseGithubAuthOptions, type UseGithubAuthReturn, type UseTwoFactorOptions, type UseTwoFactorReturn, type UseTwoFactorSetupOptions, type UseTwoFactorSetupReturn, type UseTwoFactorStatusReturn, type UseTwoFactorVerifyOptions, type UseTwoFactorVerifyReturn, type UserProfile, type WebmailLink, authLogger, clearProfileCache, consumeSavedRedirect, decodeBase64, encodeBase64, formatAuthError, getCacheMetadata, getCachedProfile, hasValidCache, isAllowedAuthPath, logger, normalizePath, peekSavedRedirect, resolveGuardIsAuthenticated, resolveGuardIsLoading, setAnalyticsSink, setCachedProfile, shouldRedirectToAuth, useAccountsContext, useAuth, useAuthForm, useAuthFormState, useAuthRedirectManager, useAuthValidation, useAutoAuth, useBase64, useCfgRouter, useDeleteAccount, useGithubAuth, useLocalStorage, useQueryParams, useSession, useSessionStorage, useTwoFactor, useTwoFactorSetup, useTwoFactorStatus, useTwoFactorVerify, validateEmail, validateIdentifier };

package/dist/auth.d.ts

@@ -1059,10 +1059,19 @@ declare const logger: consola.ConsolaInstance;
 declare const authLogger: consola.ConsolaInstance;
 
 /**
- * Analytics stub for @djangocfg/api/auth
- * Provides minimal analytics interface without external dependencies
+ * Auth analytics — a dependency-free SINK, not an implementation.
  *
- * If you need full analytics, install @djangocfg/layouts and use its Analytics module
+ * `@djangocfg/api` cannot depend on `@djangocfg/analytics`: analytics reads auth
+ * state (to attribute events to a signed-in user), so importing it here would
+ * close a dependency cycle. Instead this module owns the *interface* and lets a
+ * real implementation be injected at runtime — `@djangocfg/analytics` calls
+ * `setAnalyticsSink()` when its provider mounts.
+ *
+ * Before this, the object below was a hardcoded stub that console.logged in dev
+ * and did NOTHING in production. Every auth event it "tracked" —
+ * AUTH_LOGIN_SUCCESS, AUTH_OAUTH_FAIL, AUTH_SESSION_EXPIRED — was silently
+ * discarded. The events were fired, the calls looked right, and nothing ever
+ * arrived anywhere.
  */
 declare enum AnalyticsEvent {
     AUTH_OTP_REQUEST = "auth_otp_request",
@@ -1086,19 +1095,23 @@ interface AnalyticsEventParams {
     value?: number;
     [key: string]: any;
 }
+/** What an analytics implementation must provide to receive auth events. */
+interface AnalyticsSink {
+    event(name: string, params?: Record<string, any>): void;
+    setUser(userId: string | null): void;
+}
 /**
- * Minimal analytics implementation
- * Logs to console in development, silent in production
+ * Install the real analytics implementation.
+ *
+ * Called by `@djangocfg/analytics` when its provider mounts. Pass `null` to
+ * uninstall (on unmount), so a torn-down provider does not keep receiving events.
  */
+declare function setAnalyticsSink(next: AnalyticsSink | null): void;
 declare const Analytics: {
-    /**
-     * Track an analytics event
-     */
+    /** Track an auth event. Delivered to the installed sink, if any. */
     event(eventName: AnalyticsEventType, params?: AnalyticsEventParams): void;
-    /**
-     * Set user ID for tracking
-     */
-    setUser(userId: string): void;
+    /** Attach the signed-in user. Pass null on logout. */
+    setUser(userId: string | null): void;
 };
 
-export { AUTH_CONSTANTS, type AccountsContextValue, AccountsProvider, Analytics, AnalyticsCategory, type AnalyticsCategoryType, AnalyticsEvent, type AnalyticsEventType, type AuthConfig, AuthContext, type AuthContextType, type AuthFormAutoSubmit, type AuthFormReturn, type AuthFormState, type AuthFormStateHandlers, type AuthFormSubmitHandlers, type AuthFormValidation, AuthProvider, type AuthProviderProps, type AuthStep, type DeleteAccountResult, type GuardInput, type OTPRequestResult, type PatchedCfgUserUpdateRequest, PatchedCfgUserUpdateRequestSchema, type ProfileCacheOptions, type SessionSnapshot, type SessionStatus, type TwoFactorDevice, type TwoFactorSetupData, type UseAuthFormOptions, type UseAuthFormStateReturn, type UseAutoAuthOptions, type UseDeleteAccountReturn, type UseGithubAuthOptions, type UseGithubAuthReturn, type UseTwoFactorOptions, type UseTwoFactorReturn, type UseTwoFactorSetupOptions, type UseTwoFactorSetupReturn, type UseTwoFactorStatusReturn, type UseTwoFactorVerifyOptions, type UseTwoFactorVerifyReturn, type UserProfile, type WebmailLink, authLogger, clearProfileCache, consumeSavedRedirect, decodeBase64, encodeBase64, formatAuthError, getCacheMetadata, getCachedProfile, hasValidCache, isAllowedAuthPath, logger, normalizePath, peekSavedRedirect, resolveGuardIsAuthenticated, resolveGuardIsLoading, setCachedProfile, shouldRedirectToAuth, useAccountsContext, useAuth, useAuthForm, useAuthFormState, useAuthRedirectManager, useAuthValidation, useAutoAuth, useBase64, useCfgRouter, useDeleteAccount, useGithubAuth, useLocalStorage, useQueryParams, useSession, useSessionStorage, useTwoFactor, useTwoFactorSetup, useTwoFactorStatus, useTwoFactorVerify, validateEmail, validateIdentifier };
+export { AUTH_CONSTANTS, type AccountsContextValue, AccountsProvider, Analytics, AnalyticsCategory, type AnalyticsCategoryType, AnalyticsEvent, type AnalyticsEventType, type AnalyticsSink, type AuthConfig, AuthContext, type AuthContextType, type AuthFormAutoSubmit, type AuthFormReturn, type AuthFormState, type AuthFormStateHandlers, type AuthFormSubmitHandlers, type AuthFormValidation, AuthProvider, type AuthProviderProps, type AuthStep, type DeleteAccountResult, type GuardInput, type OTPRequestResult, type PatchedCfgUserUpdateRequest, PatchedCfgUserUpdateRequestSchema, type ProfileCacheOptions, type SessionSnapshot, type SessionStatus, type TwoFactorDevice, type TwoFactorSetupData, type UseAuthFormOptions, type UseAuthFormStateReturn, type UseAutoAuthOptions, type UseDeleteAccountReturn, type UseGithubAuthOptions, type UseGithubAuthReturn, type UseTwoFactorOptions, type UseTwoFactorReturn, type UseTwoFactorSetupOptions, type UseTwoFactorSetupReturn, type UseTwoFactorStatusReturn, type UseTwoFactorVerifyOptions, type UseTwoFactorVerifyReturn, type UserProfile, type WebmailLink, authLogger, clearProfileCache, consumeSavedRedirect, decodeBase64, encodeBase64, formatAuthError, getCacheMetadata, getCachedProfile, hasValidCache, isAllowedAuthPath, logger, normalizePath, peekSavedRedirect, resolveGuardIsAuthenticated, resolveGuardIsLoading, setAnalyticsSink, setCachedProfile, shouldRedirectToAuth, useAccountsContext, useAuth, useAuthForm, useAuthFormState, useAuthRedirectManager, useAuthValidation, useAutoAuth, useBase64, useCfgRouter, useDeleteAccount, useGithubAuth, useLocalStorage, useQueryParams, useSession, useSessionStorage, useTwoFactor, useTwoFactorSetup, useTwoFactorStatus, useTwoFactorVerify, validateEmail, validateIdentifier };

package/dist/auth.mjs

@@ -2388,21 +2388,30 @@ var AnalyticsCategory = /* @__PURE__ */ ((AnalyticsCategory2) => {
   AnalyticsCategory2["AUTH"] = "auth";
   return AnalyticsCategory2;
 })(AnalyticsCategory || {});
+var sink = null;
+function setAnalyticsSink(next) {
+  sink = next;
+}
+__name(setAnalyticsSink, "setAnalyticsSink");
 var Analytics = {
-  /**
-   * Track an analytics event
-   */
+  /** Track an auth event. Delivered to the installed sink, if any. */
   event(eventName, params) {
+    if (sink) {
+      sink.event(eventName, params);
+      return;
+    }
     if (isDev) {
-      console.log("[Analytics]", eventName, params);
+      console.log("[Analytics:no-sink]", eventName, params);
     }
   },
-  /**
-   * Set user ID for tracking
-   */
+  /** Attach the signed-in user. Pass null on logout. */
   setUser(userId) {
+    if (sink) {
+      sink.setUser(userId);
+      return;
+    }
     if (isDev) {
-      console.log("[Analytics] Set user:", userId);
+      console.log("[Analytics:no-sink] Set user:", userId);
     }
   }
 };
@@ -4821,6 +4830,7 @@ export {
   peekSavedRedirect,
   resolveGuardIsAuthenticated,
   resolveGuardIsLoading,
+  setAnalyticsSink,
   setCachedProfile,
   shouldRedirectToAuth,
   useAccountsContext,