capacitor-auth-manager 2.1.0 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (148) hide show
  1. package/CapacitorAuthManager.podspec +1 -1
  2. package/Readme.md +223 -103
  3. package/android/src/main/java/com/aoneahsan/capacitor_auth_manager/AuthStorage.java +28 -0
  4. package/android/src/main/java/com/aoneahsan/capacitor_auth_manager/CapacitorAuthManager.java +109 -15
  5. package/android/src/main/java/com/aoneahsan/capacitor_auth_manager/FacebookAuthProvider.java +389 -0
  6. package/android/src/main/java/com/aoneahsan/capacitor_auth_manager/GoogleAuthProvider.java +353 -0
  7. package/android/src/main/java/com/aoneahsan/capacitor_auth_manager/MicrosoftAuthProvider.java +455 -0
  8. package/android/src/main/java/com/aoneahsan/capacitor_auth_manager/ProviderFactory.java +180 -0
  9. package/dist/angular.cjs.js +7017 -0
  10. package/dist/angular.cjs.js.map +1 -0
  11. package/dist/core.cjs.js +2155 -444
  12. package/dist/core.cjs.js.map +1 -1
  13. package/dist/esm/angular/auth.guard.d.ts +18 -0
  14. package/dist/esm/angular/auth.guard.js +82 -0
  15. package/dist/esm/angular/auth.guard.js.map +1 -0
  16. package/dist/esm/angular/auth.module.d.ts +18 -0
  17. package/dist/esm/angular/auth.module.js +56 -0
  18. package/dist/esm/angular/auth.module.js.map +1 -0
  19. package/dist/esm/angular/auth.service.d.ts +108 -0
  20. package/dist/esm/angular/auth.service.js +224 -0
  21. package/dist/esm/angular/auth.service.js.map +1 -0
  22. package/dist/esm/angular/index.d.ts +3 -0
  23. package/dist/esm/angular/index.js +4 -0
  24. package/dist/esm/angular/index.js.map +1 -0
  25. package/dist/esm/core/auth-manager.d.ts +61 -1
  26. package/dist/esm/core/auth-manager.js +285 -24
  27. package/dist/esm/core/auth-manager.js.map +1 -1
  28. package/dist/esm/core/platform.d.ts +7 -0
  29. package/dist/esm/core/platform.js +30 -10
  30. package/dist/esm/core/platform.js.map +1 -1
  31. package/dist/esm/core/provider-manifests.d.ts +9 -0
  32. package/dist/esm/core/provider-manifests.js +471 -0
  33. package/dist/esm/core/provider-manifests.js.map +1 -0
  34. package/dist/esm/core/provider-registry.d.ts +19 -1
  35. package/dist/esm/core/provider-registry.js +72 -480
  36. package/dist/esm/core/provider-registry.js.map +1 -1
  37. package/dist/esm/core/types.d.ts +18 -7
  38. package/dist/esm/definitions.d.ts +42 -1
  39. package/dist/esm/definitions.js +28 -0
  40. package/dist/esm/definitions.js.map +1 -1
  41. package/dist/esm/index.d.ts +4 -0
  42. package/dist/esm/index.js +6 -0
  43. package/dist/esm/index.js.map +1 -1
  44. package/dist/esm/providers/base-provider.d.ts +3 -3
  45. package/dist/esm/providers/base-provider.js +26 -1
  46. package/dist/esm/providers/base-provider.js.map +1 -1
  47. package/dist/esm/providers/oauth-provider.d.ts +23 -2
  48. package/dist/esm/providers/oauth-provider.js +134 -17
  49. package/dist/esm/providers/oauth-provider.js.map +1 -1
  50. package/dist/esm/providers/provider-factory.d.ts +3 -1
  51. package/dist/esm/providers/provider-factory.js +29 -41
  52. package/dist/esm/providers/provider-factory.js.map +1 -1
  53. package/dist/esm/providers/web/apple-provider.d.ts +2 -1
  54. package/dist/esm/providers/web/apple-provider.js +25 -9
  55. package/dist/esm/providers/web/apple-provider.js.map +1 -1
  56. package/dist/esm/providers/web/biometric-provider.d.ts +14 -0
  57. package/dist/esm/providers/web/biometric-provider.js +116 -18
  58. package/dist/esm/providers/web/biometric-provider.js.map +1 -1
  59. package/dist/esm/providers/web/email-code-provider.d.ts +48 -0
  60. package/dist/esm/providers/web/email-code-provider.js +295 -0
  61. package/dist/esm/providers/web/email-code-provider.js.map +1 -0
  62. package/dist/esm/providers/web/email-password-provider.js +29 -28
  63. package/dist/esm/providers/web/email-password-provider.js.map +1 -1
  64. package/dist/esm/providers/web/facebook-provider.d.ts +52 -1
  65. package/dist/esm/providers/web/facebook-provider.js +2 -2
  66. package/dist/esm/providers/web/facebook-provider.js.map +1 -1
  67. package/dist/esm/providers/web/firebase-provider.d.ts +5 -3
  68. package/dist/esm/providers/web/firebase-provider.js +74 -42
  69. package/dist/esm/providers/web/firebase-provider.js.map +1 -1
  70. package/dist/esm/providers/web/github-provider.d.ts +9 -0
  71. package/dist/esm/providers/web/github-provider.js +91 -14
  72. package/dist/esm/providers/web/github-provider.js.map +1 -1
  73. package/dist/esm/providers/web/index.d.ts +2 -0
  74. package/dist/esm/providers/web/index.js +2 -0
  75. package/dist/esm/providers/web/index.js.map +1 -1
  76. package/dist/esm/providers/web/linkedin-provider.d.ts +2 -3
  77. package/dist/esm/providers/web/linkedin-provider.js +40 -14
  78. package/dist/esm/providers/web/linkedin-provider.js.map +1 -1
  79. package/dist/esm/providers/web/magic-link-provider.d.ts +3 -3
  80. package/dist/esm/providers/web/magic-link-provider.js +40 -26
  81. package/dist/esm/providers/web/magic-link-provider.js.map +1 -1
  82. package/dist/esm/providers/web/microsoft-provider.d.ts +2 -0
  83. package/dist/esm/providers/web/microsoft-provider.js +45 -20
  84. package/dist/esm/providers/web/microsoft-provider.js.map +1 -1
  85. package/dist/esm/providers/web/phone-password-provider.d.ts +66 -0
  86. package/dist/esm/providers/web/phone-password-provider.js +438 -0
  87. package/dist/esm/providers/web/phone-password-provider.js.map +1 -0
  88. package/dist/esm/providers/web/slack-provider.d.ts +2 -3
  89. package/dist/esm/providers/web/slack-provider.js +38 -14
  90. package/dist/esm/providers/web/slack-provider.js.map +1 -1
  91. package/dist/esm/providers/web/sms-provider.d.ts +3 -3
  92. package/dist/esm/providers/web/sms-provider.js +25 -18
  93. package/dist/esm/providers/web/sms-provider.js.map +1 -1
  94. package/dist/esm/providers/web/username-password-provider.js +23 -22
  95. package/dist/esm/providers/web/username-password-provider.js.map +1 -1
  96. package/dist/esm/react/hooks.d.ts +110 -0
  97. package/dist/esm/react/hooks.js +307 -0
  98. package/dist/esm/react/hooks.js.map +1 -0
  99. package/dist/esm/react/index.d.ts +2 -0
  100. package/dist/esm/react/index.js +3 -0
  101. package/dist/esm/react/index.js.map +1 -0
  102. package/dist/esm/react/types.d.ts +30 -0
  103. package/dist/esm/react/types.js +2 -0
  104. package/dist/esm/react/types.js.map +1 -0
  105. package/dist/esm/utils/auth-error.d.ts +7 -0
  106. package/dist/esm/utils/auth-error.js +31 -5
  107. package/dist/esm/utils/auth-error.js.map +1 -1
  108. package/dist/esm/utils/event-emitter.d.ts +7 -0
  109. package/dist/esm/utils/event-emitter.js +8 -2
  110. package/dist/esm/utils/event-emitter.js.map +1 -1
  111. package/dist/esm/utils/logger.d.ts +28 -1
  112. package/dist/esm/utils/logger.js +115 -1
  113. package/dist/esm/utils/logger.js.map +1 -1
  114. package/dist/esm/utils/pending-verification-store.d.ts +59 -0
  115. package/dist/esm/utils/pending-verification-store.js +103 -0
  116. package/dist/esm/utils/pending-verification-store.js.map +1 -0
  117. package/dist/esm/utils/storage.d.ts +29 -1
  118. package/dist/esm/utils/storage.js +64 -5
  119. package/dist/esm/utils/storage.js.map +1 -1
  120. package/dist/esm/vue/composables.d.ts +124 -0
  121. package/dist/esm/vue/composables.js +290 -0
  122. package/dist/esm/vue/composables.js.map +1 -0
  123. package/dist/esm/vue/index.d.ts +1 -0
  124. package/dist/esm/vue/index.js +2 -0
  125. package/dist/esm/vue/index.js.map +1 -0
  126. package/dist/esm/web.d.ts +32 -7
  127. package/dist/esm/web.js +247 -52
  128. package/dist/esm/web.js.map +1 -1
  129. package/dist/plugin.cjs.js +2606 -670
  130. package/dist/plugin.cjs.js.map +1 -1
  131. package/dist/plugin.js +2606 -670
  132. package/dist/plugin.js.map +1 -1
  133. package/dist/react.cjs.js +6972 -0
  134. package/dist/react.cjs.js.map +1 -0
  135. package/dist/vue.cjs.js +6955 -0
  136. package/dist/vue.cjs.js.map +1 -0
  137. package/ios/Plugin/AppleAuthProvider.swift +288 -0
  138. package/ios/Plugin/AuthStorage.swift +49 -1
  139. package/ios/Plugin/CapacitorAuthManager.swift +45 -23
  140. package/ios/Plugin/FacebookAuthProvider.swift +297 -0
  141. package/ios/Plugin/GitHubAuthProvider.swift +54 -0
  142. package/ios/Plugin/GoogleAuthProvider.swift +265 -0
  143. package/ios/Plugin/LinkedInAuthProvider.swift +63 -0
  144. package/ios/Plugin/MicrosoftAuthProvider.swift +315 -0
  145. package/ios/Plugin/Models.swift +4 -1
  146. package/ios/Plugin/OAuthWebProvider.swift +415 -0
  147. package/ios/Plugin/SlackAuthProvider.swift +108 -0
  148. package/package.json +60 -39
@@ -0,0 +1,307 @@
1
+ import { useEffect, useState, useCallback, useRef } from 'react';
2
+ import { auth } from '../core/auth-manager';
3
+ /**
4
+ * Hook for complete authentication functionality
5
+ * @example
6
+ * ```tsx
7
+ * function LoginComponent() {
8
+ * const { user, signIn, signOut, isLoading } = useAuth();
9
+ *
10
+ * if (isLoading) return <div>Loading...</div>;
11
+ *
12
+ * if (user) {
13
+ * return (
14
+ * <div>
15
+ * <p>Welcome, {user.displayName}!</p>
16
+ * <button onClick={() => signOut()}>Sign Out</button>
17
+ * </div>
18
+ * );
19
+ * }
20
+ *
21
+ * return (
22
+ * <button onClick={() => signIn('google')}>
23
+ * Sign In with Google
24
+ * </button>
25
+ * );
26
+ * }
27
+ * ```
28
+ */
29
+ export function useAuth() {
30
+ const [state, setState] = useState(auth.getAuthState());
31
+ const [error, setError] = useState(null);
32
+ useEffect(() => {
33
+ // Subscribe to auth state changes
34
+ const unsubscribe = auth.onAuthStateChange((newState) => {
35
+ setState(newState);
36
+ });
37
+ return unsubscribe;
38
+ }, []);
39
+ const signIn = useCallback(async (providerOrOptions) => {
40
+ setError(null);
41
+ try {
42
+ return await auth.signIn(providerOrOptions);
43
+ }
44
+ catch (err) {
45
+ setError(err);
46
+ throw err;
47
+ }
48
+ }, []);
49
+ const signOut = useCallback(async (options) => {
50
+ setError(null);
51
+ try {
52
+ await auth.signOut(options);
53
+ }
54
+ catch (err) {
55
+ setError(err);
56
+ throw err;
57
+ }
58
+ }, []);
59
+ const refreshToken = useCallback(async (provider) => {
60
+ setError(null);
61
+ try {
62
+ return await auth.refreshToken(provider);
63
+ }
64
+ catch (err) {
65
+ setError(err);
66
+ throw err;
67
+ }
68
+ }, []);
69
+ const linkAccount = useCallback(async (options) => {
70
+ setError(null);
71
+ try {
72
+ return await auth.linkAccount(options);
73
+ }
74
+ catch (err) {
75
+ setError(err);
76
+ throw err;
77
+ }
78
+ }, []);
79
+ const unlinkAccount = useCallback(async (options) => {
80
+ setError(null);
81
+ try {
82
+ await auth.unlinkAccount(options);
83
+ }
84
+ catch (err) {
85
+ setError(err);
86
+ throw err;
87
+ }
88
+ }, []);
89
+ const revokeAccess = useCallback(async (token, provider) => {
90
+ setError(null);
91
+ try {
92
+ await auth.revokeAccess(token, provider);
93
+ }
94
+ catch (err) {
95
+ setError(err);
96
+ throw err;
97
+ }
98
+ }, []);
99
+ const getIdToken = useCallback(async (options) => {
100
+ setError(null);
101
+ try {
102
+ return await auth.getIdToken(options);
103
+ }
104
+ catch (err) {
105
+ setError(err);
106
+ throw err;
107
+ }
108
+ }, []);
109
+ const updateProfile = useCallback(async (options) => {
110
+ setError(null);
111
+ try {
112
+ return await auth.updateProfile(options);
113
+ }
114
+ catch (err) {
115
+ setError(err);
116
+ throw err;
117
+ }
118
+ }, []);
119
+ const deleteAccount = useCallback(async (options) => {
120
+ setError(null);
121
+ try {
122
+ await auth.deleteAccount(options);
123
+ }
124
+ catch (err) {
125
+ setError(err);
126
+ throw err;
127
+ }
128
+ }, []);
129
+ return {
130
+ user: state.user,
131
+ isLoading: state.isLoading,
132
+ isAuthenticated: state.isAuthenticated,
133
+ provider: state.provider,
134
+ signIn,
135
+ signOut,
136
+ refreshToken,
137
+ linkAccount,
138
+ unlinkAccount,
139
+ revokeAccess,
140
+ getIdToken,
141
+ updateProfile,
142
+ deleteAccount,
143
+ error,
144
+ };
145
+ }
146
+ /**
147
+ * Hook for read-only auth state
148
+ * @example
149
+ * ```tsx
150
+ * function UserProfile() {
151
+ * const { user, isAuthenticated } = useAuthState();
152
+ *
153
+ * if (!isAuthenticated) {
154
+ * return <div>Please log in to view your profile</div>;
155
+ * }
156
+ *
157
+ * return (
158
+ * <div>
159
+ * <img src={user.photoURL} alt={user.displayName} />
160
+ * <h2>{user.displayName}</h2>
161
+ * <p>{user.email}</p>
162
+ * </div>
163
+ * );
164
+ * }
165
+ * ```
166
+ */
167
+ export function useAuthState() {
168
+ const [state, setState] = useState(auth.getAuthState());
169
+ useEffect(() => {
170
+ const unsubscribe = auth.onAuthStateChange((newState) => {
171
+ setState(newState);
172
+ });
173
+ return unsubscribe;
174
+ }, []);
175
+ return {
176
+ user: state.user,
177
+ isLoading: state.isLoading,
178
+ isAuthenticated: state.isAuthenticated,
179
+ provider: state.provider,
180
+ };
181
+ }
182
+ /**
183
+ * Hook for specific auth provider functionality
184
+ * @example
185
+ * ```tsx
186
+ * function GoogleLoginButton() {
187
+ * const { signIn, isSupported, isConfigured } = useAuthProvider('google');
188
+ *
189
+ * if (!isSupported) {
190
+ * return <div>Google Sign-In is not supported on this platform</div>;
191
+ * }
192
+ *
193
+ * if (!isConfigured) {
194
+ * return <div>Google Sign-In is not configured</div>;
195
+ * }
196
+ *
197
+ * return (
198
+ * <button onClick={() => signIn({ scopes: ['email', 'profile'] })}>
199
+ * Sign In with Google
200
+ * </button>
201
+ * );
202
+ * }
203
+ * ```
204
+ */
205
+ export function useAuthProvider(provider) {
206
+ const [isSupported, setIsSupported] = useState(false);
207
+ const [isConfigured, setIsConfigured] = useState(false);
208
+ const [error, setError] = useState(null);
209
+ const mountedRef = useRef(true);
210
+ useEffect(() => {
211
+ mountedRef.current = true;
212
+ const checkProvider = async () => {
213
+ try {
214
+ const supported = await auth.isProviderSupported(provider);
215
+ if (mountedRef.current) {
216
+ setIsSupported(supported);
217
+ }
218
+ // Check if configured (public accessor — no private state peeking)
219
+ if (mountedRef.current) {
220
+ setIsConfigured(auth.isProviderConfigured(provider));
221
+ }
222
+ }
223
+ catch (err) {
224
+ if (mountedRef.current) {
225
+ setError(err);
226
+ }
227
+ }
228
+ };
229
+ checkProvider();
230
+ return () => {
231
+ mountedRef.current = false;
232
+ };
233
+ }, [provider]);
234
+ const signIn = useCallback(async () => {
235
+ setError(null);
236
+ try {
237
+ // Pass provider as string directly, which is supported by our new API
238
+ return await auth.signIn(provider);
239
+ }
240
+ catch (err) {
241
+ setError(err);
242
+ throw err;
243
+ }
244
+ }, [provider]);
245
+ const signOut = useCallback(async (options) => {
246
+ setError(null);
247
+ try {
248
+ await auth.signOut(Object.assign(Object.assign({}, options), {
249
+ // `provider` here is the provider-name string passed to useAuthProvider(); the core
250
+ // signOut treats it as a string key. Cast to satisfy SignOutOptions' enum-typed field.
251
+ provider: provider }));
252
+ }
253
+ catch (err) {
254
+ setError(err);
255
+ throw err;
256
+ }
257
+ }, [provider]);
258
+ return {
259
+ isSupported,
260
+ isConfigured,
261
+ signIn,
262
+ signOut,
263
+ error,
264
+ };
265
+ }
266
+ /**
267
+ * Hook to get the current authenticated user
268
+ * @example
269
+ * ```tsx
270
+ * function Avatar() {
271
+ * const user = useUser();
272
+ *
273
+ * if (!user) return null;
274
+ *
275
+ * return (
276
+ * <img
277
+ * src={user.photoURL || '/default-avatar.png'}
278
+ * alt={user.displayName || 'User'}
279
+ * />
280
+ * );
281
+ * }
282
+ * ```
283
+ */
284
+ export function useUser() {
285
+ const { user } = useAuthState();
286
+ return user;
287
+ }
288
+ /**
289
+ * Hook to check if user is authenticated
290
+ * @example
291
+ * ```tsx
292
+ * function ProtectedRoute({ children }) {
293
+ * const isAuthenticated = useIsAuthenticated();
294
+ *
295
+ * if (!isAuthenticated) {
296
+ * return <Navigate to="/login" />;
297
+ * }
298
+ *
299
+ * return children;
300
+ * }
301
+ * ```
302
+ */
303
+ export function useIsAuthenticated() {
304
+ const { isAuthenticated } = useAuthState();
305
+ return isAuthenticated;
306
+ }
307
+ //# sourceMappingURL=hooks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/react/hooks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export * from './hooks';
2
+ export * from './types';
@@ -0,0 +1,3 @@
1
+ export * from './hooks';
2
+ export * from './types';
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}
@@ -0,0 +1,30 @@
1
+ import type { AuthUser, AuthResult, SignInOptions, SignOutOptions, LinkAccountOptions, UnlinkAccountOptions, GetIdTokenOptions, UpdateProfileOptions, DeleteAccountOptions } from '../definitions';
2
+ export interface UseAuthReturn {
3
+ user: AuthUser | null;
4
+ isLoading: boolean;
5
+ isAuthenticated: boolean;
6
+ provider: string | null;
7
+ signIn: (providerOrOptions: string | SignInOptions) => Promise<AuthResult>;
8
+ signOut: (options?: SignOutOptions) => Promise<void>;
9
+ refreshToken: (provider?: string) => Promise<AuthResult>;
10
+ linkAccount: (options: LinkAccountOptions) => Promise<AuthResult>;
11
+ unlinkAccount: (options: UnlinkAccountOptions) => Promise<void>;
12
+ revokeAccess: (token?: string, provider?: string) => Promise<void>;
13
+ getIdToken: (options?: GetIdTokenOptions) => Promise<string>;
14
+ updateProfile: (options: UpdateProfileOptions) => Promise<AuthUser>;
15
+ deleteAccount: (options?: DeleteAccountOptions) => Promise<void>;
16
+ error: Error | null;
17
+ }
18
+ export interface UseAuthStateReturn {
19
+ user: AuthUser | null;
20
+ isLoading: boolean;
21
+ isAuthenticated: boolean;
22
+ provider: string | null;
23
+ }
24
+ export interface UseAuthProviderReturn {
25
+ isSupported: boolean;
26
+ isConfigured: boolean;
27
+ signIn: () => Promise<AuthResult>;
28
+ signOut: (options?: SignOutOptions) => Promise<void>;
29
+ error: Error | null;
30
+ }
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/react/types.ts"],"names":[],"mappings":""}
@@ -4,6 +4,13 @@ export declare class AuthError extends Error implements IAuthError {
4
4
  details?: Record<string, unknown>;
5
5
  provider?: AuthProvider;
6
6
  constructor(code: string, message: string, provider?: AuthProvider, details?: Record<string, unknown>);
7
+ private static readonly SENSITIVE_KEY;
8
+ /**
9
+ * Produces a safe, shallow `details` object: redacts sensitive keys and keeps only JSON-safe
10
+ * primitives. Prevents tokens/PII embedded in a raw error or token-endpoint response body from
11
+ * being captured into AuthError.details (and thus logged or serialized via toJSON()).
12
+ */
13
+ static sanitizeDetails(input?: unknown): Record<string, unknown> | undefined;
7
14
  static fromError(error: unknown, provider?: AuthProvider): AuthError;
8
15
  toJSON(): {
9
16
  name: string;
@@ -5,19 +5,44 @@ export class AuthError extends Error {
5
5
  this.name = 'AuthError';
6
6
  this.code = code;
7
7
  this.provider = provider;
8
- this.details = details;
9
- // Maintains proper stack trace for where our error was thrown (only available on V8)
10
- if (Error.captureStackTrace) {
11
- Error.captureStackTrace(this, AuthError);
8
+ this.details = AuthError.sanitizeDetails(details);
9
+ // Maintains proper stack trace for where our error was thrown (only available on V8 engines:
10
+ // Node.js and Chromium). Typed locally so the package does not depend on @types/node globals.
11
+ const ErrorCtor = Error;
12
+ if (ErrorCtor.captureStackTrace) {
13
+ ErrorCtor.captureStackTrace(this, AuthError);
12
14
  }
13
15
  }
16
+ /**
17
+ * Produces a safe, shallow `details` object: redacts sensitive keys and keeps only JSON-safe
18
+ * primitives. Prevents tokens/PII embedded in a raw error or token-endpoint response body from
19
+ * being captured into AuthError.details (and thus logged or serialized via toJSON()).
20
+ */
21
+ static sanitizeDetails(input) {
22
+ if (input === null || typeof input !== 'object') {
23
+ return undefined;
24
+ }
25
+ const out = {};
26
+ for (const [key, value] of Object.entries(input)) {
27
+ if (AuthError.SENSITIVE_KEY.test(key)) {
28
+ out[key] = '[redacted]';
29
+ }
30
+ else if (value === null ||
31
+ typeof value === 'string' ||
32
+ typeof value === 'number' ||
33
+ typeof value === 'boolean') {
34
+ out[key] = value;
35
+ }
36
+ }
37
+ return Object.keys(out).length > 0 ? out : undefined;
38
+ }
14
39
  static fromError(error, provider) {
15
40
  if (error instanceof AuthError) {
16
41
  return error;
17
42
  }
18
43
  let code = AuthErrorCode.INTERNAL_ERROR;
19
44
  let message = 'An unknown error occurred';
20
- let details = error;
45
+ const details = error;
21
46
  if (error instanceof Error) {
22
47
  message = error.message;
23
48
  // Try to map common error patterns to specific error codes
@@ -52,6 +77,7 @@ export class AuthError extends Error {
52
77
  };
53
78
  }
54
79
  }
80
+ AuthError.SENSITIVE_KEY = /(token|secret|password|authorization|code_verifier|client_secret|credential|api[-_]?key|cookie)/i;
55
81
  export function isAuthError(error) {
56
82
  return (error instanceof AuthError ||
57
83
  (typeof error === 'object' &&
@@ -1 +1 @@
1
- {"version":3,"file":"auth-error.js","sourceRoot":"","sources":["../../../src/utils/auth-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,GAEd,MAAM,gBAAgB,CAAC;AAExB,MAAM,OAAO,SAAU,SAAQ,KAAK;IAKlC,YACE,IAAY,EACZ,OAAe,EACf,QAAuB,EACvB,OAAiC;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,qFAAqF;QACrF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,KAAc,EAAE,QAAuB;QACtD,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,GAAG,aAAa,CAAC,cAAc,CAAC;QACxC,IAAI,OAAO,GAAG,2BAA2B,CAAC;QAC1C,IAAI,OAAO,GAAwC,KAGlD,CAAC;QAEF,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YAExB,2DAA2D;YAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACtC,IAAI,GAAG,aAAa,CAAC,aAAa,CAAC;YACrC,CAAC;iBAAM,IACL,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACnC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAClC,CAAC;gBACD,IAAI,GAAG,aAAa,CAAC,cAAc,CAAC;YACtC,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7C,IAAI,GAAG,aAAa,CAAC,aAAa,CAAC;YACrC,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,MAAM,QAAQ,GAAG,KAA0B,CAAC;QAC5C,IAAI,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,IAAI,EAAE,CAAC;YACnB,6CAA6C;YAC7C,IACE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAqB,CAAC,EACrE,CAAC;gBACD,IAAI,GAAG,QAAQ,CAAC,IAAqB,CAAC;YACxC,CAAC;QACH,CAAC;QAED,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,KAAK,YAAY,SAAS;QAC1B,CAAC,OAAO,KAAK,KAAK,QAAQ;YACxB,KAAK,KAAK,IAAI;YACb,KAA2B,CAAC,IAAI,KAAK,WAAW;YAChD,KAA2B,CAAC,IAAI,KAAK,SAAS,CAAC,CACnD,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"auth-error.js","sourceRoot":"","sources":["../../../src/utils/auth-error.ts"],"names":[],"mappings":"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"}
@@ -1,7 +1,14 @@
1
+ import { Logger } from './logger';
1
2
  export type EventListener<T = unknown> = (data: T) => void;
2
3
  export type UnsubscribeFn = () => void;
3
4
  export declare class EventEmitter<T = unknown> {
4
5
  private listeners;
6
+ private logger;
7
+ /**
8
+ * @param logger Optional logger for listener errors. Defaults to the shared {@link defaultLogger}
9
+ * so emitter errors honour the package log level instead of writing to `console` directly.
10
+ */
11
+ constructor(logger?: Logger);
5
12
  emit(data: T): void;
6
13
  subscribe(listener: EventListener<T>): UnsubscribeFn;
7
14
  clear(): void;
@@ -1,6 +1,12 @@
1
+ import { defaultLogger } from './logger';
1
2
  export class EventEmitter {
2
- constructor() {
3
+ /**
4
+ * @param logger Optional logger for listener errors. Defaults to the shared {@link defaultLogger}
5
+ * so emitter errors honour the package log level instead of writing to `console` directly.
6
+ */
7
+ constructor(logger = defaultLogger) {
3
8
  this.listeners = new Set();
9
+ this.logger = logger;
4
10
  }
5
11
  emit(data) {
6
12
  this.listeners.forEach((listener) => {
@@ -8,7 +14,7 @@ export class EventEmitter {
8
14
  listener(data);
9
15
  }
10
16
  catch (error) {
11
- console.error('Error in event listener:', error);
17
+ this.logger.error('Error in event listener:', error);
12
18
  }
13
19
  });
14
20
  }
@@ -1 +1 @@
1
- {"version":3,"file":"event-emitter.js","sourceRoot":"","sources":["../../../src/utils/event-emitter.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,YAAY;IAAzB;QACU,cAAS,GAA0B,IAAI,GAAG,EAAE,CAAC;IA2BvD,CAAC;IAzBC,IAAI,CAAC,IAAO;QACV,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAClC,IAAI,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;YACnD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,QAA0B;QAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE7B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;CACF"}
1
+ {"version":3,"file":"event-emitter.js","sourceRoot":"","sources":["../../../src/utils/event-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,aAAa,EAAE,MAAM,UAAU,CAAC;AAKjD,MAAM,OAAO,YAAY;IAIvB;;;OAGG;IACH,YAAY,SAAiB,aAAa;QAPlC,cAAS,GAA0B,IAAI,GAAG,EAAE,CAAC;QAQnD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAI,CAAC,IAAO;QACV,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAClC,IAAI,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;YACvD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,QAA0B;QAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE7B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;CACF"}
@@ -1,4 +1,4 @@
1
- export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
1
+ export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
2
2
  export interface LoggerConfig {
3
3
  enableLogging: boolean;
4
4
  logLevel: LogLevel;
@@ -14,6 +14,33 @@ export declare class Logger {
14
14
  info(message: string, ...args: unknown[]): void;
15
15
  warn(message: string, ...args: unknown[]): void;
16
16
  error(message: string, error?: unknown): void;
17
+ /** Verbose tracing — gated at `debug` level like {@link debug}. */
18
+ trace(message: string, ...args: unknown[]): void;
19
+ /** Tabular output — gated at `debug` level. Falls back to `debug` when `console.table` is absent. */
20
+ table(data: unknown, columns?: string[]): void;
21
+ /** Opens a console group — gated at `debug` level. No-ops if `console.group` is absent. */
22
+ group(label?: string): void;
23
+ /** Closes a console group opened by {@link group}. */
24
+ groupEnd(): void;
25
+ /** Starts a timer — gated at `debug` level. No-ops if `console.time` is absent. */
26
+ time(label: string): void;
27
+ /** Stops a timer started by {@link time} and logs the elapsed duration. */
28
+ timeEnd(label: string): void;
17
29
  setLogLevel(level: LogLevel): void;
30
+ /** Alias for {@link setLogLevel} matching the workspace logger convention. */
31
+ setLevel(level: LogLevel): void;
32
+ getLevel(): LogLevel;
18
33
  setEnabled(enabled: boolean): void;
19
34
  }
35
+ /**
36
+ * Shared default logger instance used by package internals that don't receive a logger via
37
+ * dependency injection (e.g. {@link EventEmitter}, {@link WebStorage} defaults, the biometric
38
+ * provider). Enabled by default at `warn` level so only warnings + errors surface unless the
39
+ * consumer raises the level. Consumers can adjust it programmatically:
40
+ *
41
+ * ```ts
42
+ * import { defaultLogger } from 'capacitor-auth-manager';
43
+ * defaultLogger.setLevel('debug');
44
+ * ```
45
+ */
46
+ export declare const defaultLogger: Logger;