capacitor-auth-manager 2.3.0 → 2.4.1

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 (141) hide show
  1. package/CHANGELOG.md +149 -0
  2. package/CapacitorAuthManager.podspec +1 -1
  3. package/LICENSE +1 -1
  4. package/Readme.md +136 -595
  5. package/android/build.gradle +8 -2
  6. package/android/src/main/java/com/aoneahsan/capacitor_auth_manager/CapacitorAuthManager.java +43 -15
  7. package/android/src/main/java/com/aoneahsan/capacitor_auth_manager/CapacitorAuthManagerPlugin.java +24 -3
  8. package/android/src/main/java/com/aoneahsan/capacitor_auth_manager/GoogleAuthProvider.java +427 -226
  9. package/android/src/main/java/com/aoneahsan/capacitor_auth_manager/ProviderFactory.java +28 -0
  10. package/dist/angular.cjs.js +971 -4542
  11. package/dist/core.cjs.js +944 -4514
  12. package/dist/esm/angular/auth.guard.js +0 -1
  13. package/dist/esm/angular/auth.module.d.ts +2 -1
  14. package/dist/esm/angular/auth.module.js +0 -1
  15. package/dist/esm/angular/auth.service.d.ts +5 -5
  16. package/dist/esm/angular/auth.service.js +0 -1
  17. package/dist/esm/angular/index.d.ts +1 -0
  18. package/dist/esm/angular/index.js +4 -1
  19. package/dist/esm/capacitor-plugin.js +0 -1
  20. package/dist/esm/core/auth-manager.d.ts +6 -0
  21. package/dist/esm/core/auth-manager.js +27 -4
  22. package/dist/esm/core/index.js +0 -1
  23. package/dist/esm/core/platform.js +0 -1
  24. package/dist/esm/core/provider-manifests.js +0 -1
  25. package/dist/esm/core/provider-registry.d.ts +9 -2
  26. package/dist/esm/core/provider-registry.js +63 -57
  27. package/dist/esm/core/types.js +0 -1
  28. package/dist/esm/definitions.d.ts +30 -1
  29. package/dist/esm/definitions.js +8 -1
  30. package/dist/esm/index.js +0 -1
  31. package/dist/esm/providers/base-provider.js +0 -1
  32. package/dist/esm/providers/native/google-native-provider.d.ts +26 -0
  33. package/dist/esm/providers/native/google-native-provider.js +114 -0
  34. package/dist/esm/providers/oauth-provider.js +0 -1
  35. package/dist/esm/providers/provider-factory.d.ts +9 -0
  36. package/dist/esm/providers/provider-factory.js +20 -57
  37. package/dist/esm/providers/web/google-provider.d.ts +70 -92
  38. package/dist/esm/providers/web/google-provider.js +262 -205
  39. package/dist/esm/providers/web/index.d.ts +0 -14
  40. package/dist/esm/providers/web/index.js +7 -16
  41. package/dist/esm/react/hooks.js +0 -1
  42. package/dist/esm/react/index.d.ts +1 -0
  43. package/dist/esm/react/index.js +4 -1
  44. package/dist/esm/react/types.js +0 -1
  45. package/dist/esm/utils/auth-error.js +0 -1
  46. package/dist/esm/utils/error-message.d.ts +8 -0
  47. package/dist/esm/utils/error-message.js +20 -0
  48. package/dist/esm/utils/event-emitter.js +0 -1
  49. package/dist/esm/utils/logger.js +0 -1
  50. package/dist/esm/utils/pending-verification-store.js +0 -1
  51. package/dist/esm/utils/storage.d.ts +11 -6
  52. package/dist/esm/utils/storage.js +3 -2
  53. package/dist/esm/vue/composables.js +0 -1
  54. package/dist/esm/vue/index.d.ts +1 -0
  55. package/dist/esm/vue/index.js +4 -1
  56. package/dist/esm/web.js +0 -1
  57. package/dist/plugin.cjs.js +468 -4663
  58. package/dist/plugin.js +468 -4663
  59. package/dist/react.cjs.js +972 -4543
  60. package/dist/vue.cjs.js +972 -4543
  61. package/ios/Plugin/CapacitorAuthManager.swift +6 -6
  62. package/ios/Plugin/GoogleAuthProvider.swift +213 -105
  63. package/ios/Plugin/Models.swift +35 -4
  64. package/package.json +31 -30
  65. package/dist/angular.cjs.js.map +0 -1
  66. package/dist/core.cjs.js.map +0 -1
  67. package/dist/esm/angular/auth.guard.js.map +0 -1
  68. package/dist/esm/angular/auth.module.js.map +0 -1
  69. package/dist/esm/angular/auth.service.js.map +0 -1
  70. package/dist/esm/angular/index.js.map +0 -1
  71. package/dist/esm/capacitor-plugin.js.map +0 -1
  72. package/dist/esm/core/auth-manager.js.map +0 -1
  73. package/dist/esm/core/index.js.map +0 -1
  74. package/dist/esm/core/platform.js.map +0 -1
  75. package/dist/esm/core/provider-manifests.js.map +0 -1
  76. package/dist/esm/core/provider-registry.js.map +0 -1
  77. package/dist/esm/core/types.js.map +0 -1
  78. package/dist/esm/definitions.js.map +0 -1
  79. package/dist/esm/index.js.map +0 -1
  80. package/dist/esm/providers/base-provider.js.map +0 -1
  81. package/dist/esm/providers/oauth-provider.js.map +0 -1
  82. package/dist/esm/providers/provider-factory.js.map +0 -1
  83. package/dist/esm/providers/web/apple-provider.d.ts +0 -61
  84. package/dist/esm/providers/web/apple-provider.js +0 -293
  85. package/dist/esm/providers/web/apple-provider.js.map +0 -1
  86. package/dist/esm/providers/web/biometric-provider.d.ts +0 -60
  87. package/dist/esm/providers/web/biometric-provider.js +0 -368
  88. package/dist/esm/providers/web/biometric-provider.js.map +0 -1
  89. package/dist/esm/providers/web/email-code-provider.d.ts +0 -46
  90. package/dist/esm/providers/web/email-code-provider.js +0 -294
  91. package/dist/esm/providers/web/email-code-provider.js.map +0 -1
  92. package/dist/esm/providers/web/email-password-provider.d.ts +0 -52
  93. package/dist/esm/providers/web/email-password-provider.js +0 -429
  94. package/dist/esm/providers/web/email-password-provider.js.map +0 -1
  95. package/dist/esm/providers/web/facebook-provider.d.ts +0 -80
  96. package/dist/esm/providers/web/facebook-provider.js +0 -249
  97. package/dist/esm/providers/web/facebook-provider.js.map +0 -1
  98. package/dist/esm/providers/web/firebase-provider.d.ts +0 -22
  99. package/dist/esm/providers/web/firebase-provider.js +0 -338
  100. package/dist/esm/providers/web/firebase-provider.js.map +0 -1
  101. package/dist/esm/providers/web/github-provider.d.ts +0 -34
  102. package/dist/esm/providers/web/github-provider.js +0 -325
  103. package/dist/esm/providers/web/github-provider.js.map +0 -1
  104. package/dist/esm/providers/web/google-provider.js.map +0 -1
  105. package/dist/esm/providers/web/index.js.map +0 -1
  106. package/dist/esm/providers/web/linkedin-provider.d.ts +0 -37
  107. package/dist/esm/providers/web/linkedin-provider.js +0 -178
  108. package/dist/esm/providers/web/linkedin-provider.js.map +0 -1
  109. package/dist/esm/providers/web/magic-link-provider.d.ts +0 -44
  110. package/dist/esm/providers/web/magic-link-provider.js +0 -311
  111. package/dist/esm/providers/web/magic-link-provider.js.map +0 -1
  112. package/dist/esm/providers/web/microsoft-provider.d.ts +0 -23
  113. package/dist/esm/providers/web/microsoft-provider.js +0 -236
  114. package/dist/esm/providers/web/microsoft-provider.js.map +0 -1
  115. package/dist/esm/providers/web/phone-password-provider.d.ts +0 -63
  116. package/dist/esm/providers/web/phone-password-provider.js +0 -440
  117. package/dist/esm/providers/web/phone-password-provider.js.map +0 -1
  118. package/dist/esm/providers/web/slack-provider.d.ts +0 -39
  119. package/dist/esm/providers/web/slack-provider.js +0 -175
  120. package/dist/esm/providers/web/slack-provider.js.map +0 -1
  121. package/dist/esm/providers/web/sms-provider.d.ts +0 -46
  122. package/dist/esm/providers/web/sms-provider.js +0 -306
  123. package/dist/esm/providers/web/sms-provider.js.map +0 -1
  124. package/dist/esm/providers/web/username-password-provider.d.ts +0 -59
  125. package/dist/esm/providers/web/username-password-provider.js +0 -434
  126. package/dist/esm/providers/web/username-password-provider.js.map +0 -1
  127. package/dist/esm/react/hooks.js.map +0 -1
  128. package/dist/esm/react/index.js.map +0 -1
  129. package/dist/esm/react/types.js.map +0 -1
  130. package/dist/esm/utils/auth-error.js.map +0 -1
  131. package/dist/esm/utils/event-emitter.js.map +0 -1
  132. package/dist/esm/utils/logger.js.map +0 -1
  133. package/dist/esm/utils/pending-verification-store.js.map +0 -1
  134. package/dist/esm/utils/storage.js.map +0 -1
  135. package/dist/esm/vue/composables.js.map +0 -1
  136. package/dist/esm/vue/index.js.map +0 -1
  137. package/dist/esm/web.js.map +0 -1
  138. package/dist/plugin.cjs.js.map +0 -1
  139. package/dist/plugin.js.map +0 -1
  140. package/dist/react.cjs.js.map +0 -1
  141. package/dist/vue.cjs.js.map +0 -1
@@ -79,4 +79,3 @@ let NoAuthGuard = (() => {
79
79
  return NoAuthGuard = _classThis;
80
80
  })();
81
81
  export { NoAuthGuard };
82
- //# sourceMappingURL=auth.guard.js.map
@@ -1,6 +1,7 @@
1
1
  import { ModuleWithProviders, InjectionToken } from '@angular/core';
2
+ import type { ProviderOptions } from '../definitions';
2
3
  export interface AuthModuleConfig {
3
- providers?: Record<string, any>;
4
+ providers?: Record<string, ProviderOptions>;
4
5
  persistence?: 'local' | 'session' | 'memory';
5
6
  autoRefreshToken?: boolean;
6
7
  tokenRefreshBuffer?: number;
@@ -53,4 +53,3 @@ let AuthModule = (() => {
53
53
  return AuthModule = _classThis;
54
54
  })();
55
55
  export { AuthModule };
56
- //# sourceMappingURL=auth.module.js.map
@@ -1,6 +1,6 @@
1
1
  import { OnDestroy } from '@angular/core';
2
2
  import { Observable } from 'rxjs';
3
- import type { AuthState } from '../core/types';
3
+ import type { AuthState, AuthManagerConfig } from '../core/types';
4
4
  import type { AuthUser, AuthResult, SignInOptions, SignOutOptions, LinkAccountOptions, UnlinkAccountOptions, GetIdTokenOptions, UpdateProfileOptions, DeleteAccountOptions } from '../definitions';
5
5
  export declare class AuthService implements OnDestroy {
6
6
  private stateSubject;
@@ -15,11 +15,11 @@ export declare class AuthService implements OnDestroy {
15
15
  /**
16
16
  * Configure auth manager
17
17
  */
18
- configure(config: any): void;
18
+ configure(config: AuthManagerConfig): void;
19
19
  /**
20
20
  * Initialize auth manager
21
21
  */
22
- initialize(config?: any): Observable<void>;
22
+ initialize(config?: AuthManagerConfig): Observable<void>;
23
23
  /**
24
24
  * Sign in with a provider
25
25
  */
@@ -94,8 +94,8 @@ export declare class AuthProviderService {
94
94
  isSupported$: Observable<boolean>;
95
95
  isConfigured$: Observable<boolean>;
96
96
  constructor(provider: string, authService: AuthService);
97
- signIn(options?: any): Observable<AuthResult>;
98
- signOut(options?: any): Observable<void>;
97
+ signIn(options?: SignInOptions['options']): Observable<AuthResult>;
98
+ signOut(options?: SignOutOptions): Observable<void>;
99
99
  private checkConfiguration;
100
100
  }
101
101
  /**
@@ -221,4 +221,3 @@ let AuthProviderFactory = (() => {
221
221
  return AuthProviderFactory = _classThis;
222
222
  })();
223
223
  export { AuthProviderFactory };
224
- //# sourceMappingURL=auth.service.js.map
@@ -1,3 +1,4 @@
1
1
  export { AuthService, AuthProviderService, AuthProviderFactory, } from './auth.service';
2
2
  export { AuthModule, AuthModuleConfig, AUTH_CONFIG } from './auth.module';
3
3
  export { AuthGuard, NoAuthGuard } from './auth.guard';
4
+ export { AuthProvider, AuthErrorCode } from '../definitions';
@@ -1,4 +1,7 @@
1
1
  export { AuthService, AuthProviderService, AuthProviderFactory, } from './auth.service';
2
2
  export { AuthModule, AUTH_CONFIG } from './auth.module';
3
3
  export { AuthGuard, NoAuthGuard } from './auth.guard';
4
- //# sourceMappingURL=index.js.map
4
+ // Re-export the AuthProvider enum (+ error codes) so consumers get `authService.signIn(AuthProvider.GOOGLE)`
5
+ // with a single import. Using the enum is the recommended, typo-safe way to name a provider — plain
6
+ // strings like 'google' still work.
7
+ export { AuthProvider, AuthErrorCode } from '../definitions';
@@ -4,4 +4,3 @@ const CapacitorAuthManager = registerPlugin('CapacitorAuthManager', {
4
4
  web: () => import('./web').then((m) => new m.CapacitorAuthManagerWeb()),
5
5
  });
6
6
  export { CapacitorAuthManager };
7
- //# sourceMappingURL=capacitor-plugin.js.map
@@ -75,6 +75,12 @@ declare class AuthManagerCore {
75
75
  */
76
76
  private resolveProvider;
77
77
  private updateState;
78
+ /**
79
+ * Strips secret token material from a credential before it reaches the default (unencrypted)
80
+ * storage. Only non-secret session metadata is kept; tokens are re-derived from the provider's
81
+ * silent restore. See the persist site in {@link signIn} for the rationale.
82
+ */
83
+ private sanitizeCredentialForStorage;
78
84
  private restoreAuthState;
79
85
  private setupTokenRefresh;
80
86
  /**
@@ -140,6 +140,8 @@ class AuthManagerCore {
140
140
  // email/password/phoneNumber/username) AND kept nested under `credentials` for
141
141
  // providers that read them there.
142
142
  this.logger.info(`Signing in with ${providerName}`);
143
+ // The provider reads credentials/options from this merged shape; `provider` is supplied via
144
+ // construction, not here, so we assert to SignInOptions (whose `provider` is required).
143
145
  const result = await provider.signIn(Object.assign(Object.assign(Object.assign({}, signInOptions.options), ((_b = signInOptions.credentials) !== null && _b !== void 0 ? _b : {})), { credentials: signInOptions.credentials }));
144
146
  // Update state
145
147
  this.updateState({
@@ -148,11 +150,16 @@ class AuthManagerCore {
148
150
  provider: providerName,
149
151
  isLoading: false,
150
152
  });
151
- // Store auth state
153
+ // Store a NON-SECRET session snapshot. We deliberately do NOT persist idToken / accessToken /
154
+ // refreshToken / serverAuthCode to the default storage (localStorage on web, Preferences on
155
+ // native — neither hardware-encrypted). Short-lived tokens are re-derived via the provider's
156
+ // silent restore (getCurrentUser) / refreshToken(); persisting them at rest is a needless secret
157
+ // exposure. Consumers who need token persistence can inject a secure storage adapter and read
158
+ // tokens from the live AuthResult.
152
159
  await this.storage.set('auth_state', {
153
160
  user: result.user,
154
161
  provider: providerName,
155
- credential: result.credential,
162
+ credential: this.sanitizeCredentialForStorage(result.credential),
156
163
  });
157
164
  // Setup token refresh
158
165
  if (this.config.autoRefreshToken && ((_c = result.credential) === null || _c === void 0 ? void 0 : _c.refreshToken)) {
@@ -229,7 +236,7 @@ class AuthManagerCore {
229
236
  const providerConfig = (_a = this.config.providers) === null || _a === void 0 ? void 0 : _a[targetProvider];
230
237
  const providerInstance = await ProviderRegistry.getProvider(targetProvider, providerConfig, this.getProviderDeps());
231
238
  if (!providerInstance.refreshToken) {
232
- throw new AuthError('auth/operation-not-supported', `Provider '${targetProvider}' does not support token refresh`);
239
+ throw new AuthError(AuthErrorCode.OPERATION_NOT_SUPPORTED, `Provider '${targetProvider}' does not support token refresh`);
233
240
  }
234
241
  const result = await providerInstance.refreshToken();
235
242
  // Update user
@@ -453,6 +460,23 @@ class AuthManagerCore {
453
460
  this.state = Object.assign(Object.assign({}, this.state), partial);
454
461
  this.stateEmitter.emit(this.state);
455
462
  }
463
+ /**
464
+ * Strips secret token material from a credential before it reaches the default (unencrypted)
465
+ * storage. Only non-secret session metadata is kept; tokens are re-derived from the provider's
466
+ * silent restore. See the persist site in {@link signIn} for the rationale.
467
+ */
468
+ sanitizeCredentialForStorage(credential) {
469
+ if (!credential) {
470
+ return undefined;
471
+ }
472
+ return {
473
+ providerId: credential.providerId,
474
+ signInMethod: credential.signInMethod,
475
+ expiresAt: credential.expiresAt,
476
+ tokenType: credential.tokenType,
477
+ scope: credential.scope,
478
+ };
479
+ }
456
480
  async restoreAuthState() {
457
481
  var _a, _b;
458
482
  try {
@@ -554,4 +578,3 @@ class AuthManagerCore {
554
578
  }
555
579
  // Create singleton instance
556
580
  export const auth = new AuthManagerCore();
557
- //# sourceMappingURL=auth-manager.js.map
@@ -2,4 +2,3 @@ export * from './auth-manager';
2
2
  export * from './types';
3
3
  export * from './platform';
4
4
  export * from './provider-registry';
5
- //# sourceMappingURL=index.js.map
@@ -97,4 +97,3 @@ export class PlatformDetector {
97
97
  }
98
98
  }
99
99
  PlatformDetector.platformInfo = null;
100
- //# sourceMappingURL=platform.js.map
@@ -468,4 +468,3 @@ Note: This provider requires a backend service to handle authentication.
468
468
  },
469
469
  },
470
470
  ];
471
- //# sourceMappingURL=provider-manifests.js.map
@@ -5,9 +5,9 @@ import type { StorageInterface } from '../utils/storage';
5
5
  import { Logger } from '../utils/logger';
6
6
  export interface ProviderLoader {
7
7
  (): Promise<{
8
- default: new (config: any) => AuthProviderInterface;
8
+ default: new (config?: unknown) => AuthProviderInterface;
9
9
  } | {
10
- default: any;
10
+ default: unknown;
11
11
  }>;
12
12
  }
13
13
  /**
@@ -27,6 +27,13 @@ export declare class ProviderRegistry {
27
27
  private static readonly STANDALONE_PROVIDERS;
28
28
  /** Maps AuthProvider enum values (some underscored) to the registered hyphenated loader keys. */
29
29
  private static readonly NAME_ALIASES;
30
+ /**
31
+ * Every provider this package knows about (canonical loader keys). Used to distinguish a
32
+ * recognized-but-not-yet-enabled provider (→ PROVIDER_NOT_ENABLED) from a genuinely unknown one
33
+ * (→ UNSUPPORTED_PROVIDER). As of 2.4.1 only `google` has a registered loader; the rest are
34
+ * re-enabled one at a time (see docs/features/google-provider-production-v3).
35
+ */
36
+ private static readonly RECOGNIZED_PROVIDERS;
30
37
  static registerManifest(manifest: ProviderManifest): void;
31
38
  static registerLoader(name: string, loader: ProviderLoader): void;
32
39
  static getManifest(name: string): ProviderManifest | undefined;
@@ -1,8 +1,10 @@
1
1
  var _a;
2
2
  import { PlatformDetector } from './platform';
3
- import { AuthPersistence } from '../definitions';
3
+ import { AuthPersistence, AuthErrorCode } from '../definitions';
4
+ import { AuthError } from '../utils/auth-error';
4
5
  import { WebStorage } from '../utils/storage';
5
6
  import { Logger } from '../utils/logger';
7
+ import { getErrorMessage } from '../utils/error-message';
6
8
  import { BUILT_IN_PROVIDER_MANIFESTS } from './provider-manifests';
7
9
  export class ProviderRegistry {
8
10
  static registerManifest(manifest) {
@@ -19,21 +21,25 @@ export class ProviderRegistry {
19
21
  return (_b = this.NAME_ALIASES[name]) !== null && _b !== void 0 ? _b : name;
20
22
  }
21
23
  static async getProvider(name, options, deps) {
22
- var _b, _c, _d, _e;
24
+ var _b, _c;
23
25
  const key = this.canonicalName(name);
24
26
  // Check if already loaded
25
27
  const existing = this.providers.get(key);
26
28
  if (existing) {
27
29
  return existing;
28
30
  }
29
- // Check if loader exists
31
+ // Check if loader exists. As of 2.4.1 only Google has a registered loader; a recognized provider
32
+ // without one is "not enabled yet" (distinct from an unknown provider) so consumers can branch on
33
+ // AuthErrorCode.PROVIDER_NOT_ENABLED.
30
34
  const loader = this.loaders.get(key);
31
35
  if (!loader) {
32
- const manifest = this.manifests.get(key);
33
- if (manifest) {
34
- throw new Error(`Provider '${name}' is not loaded.\n\n${manifest.setupInstructions || `Please configure the ${manifest.displayName} provider.`}`);
36
+ if (this.RECOGNIZED_PROVIDERS.has(key)) {
37
+ throw new AuthError(AuthErrorCode.PROVIDER_NOT_ENABLED, `Provider '${name}' is not enabled yet. capacitor-auth-manager currently ships a hardened ` +
38
+ `Google provider; the remaining providers are being re-enabled one at a time. ` +
39
+ `Use AuthProvider.GOOGLE for now, and track progress at ` +
40
+ `https://github.com/aoneahsan/capacitor-auth-manager.`);
35
41
  }
36
- throw new Error(`Unknown provider: ${name}`);
42
+ throw new AuthError(AuthErrorCode.UNSUPPORTED_PROVIDER, `Unknown provider: ${name}`);
37
43
  }
38
44
  // Check platform support
39
45
  const manifest = this.manifests.get(key);
@@ -44,7 +50,9 @@ export class ProviderRegistry {
44
50
  }
45
51
  }
46
52
  try {
47
- // Load the provider class
53
+ // Load the provider class. Every loader resolves to `{ default: <ProviderConstructor> }`
54
+ // (see registerLoader calls above); narrow `default` to that constructor shape so the
55
+ // `new ProviderClass(...)` below type-checks without resorting to `any`.
48
56
  const module = await loader();
49
57
  const ProviderClass = module.default;
50
58
  // Build the constructor argument. BaseAuthProvider subclasses need a full
@@ -77,8 +85,9 @@ export class ProviderRegistry {
77
85
  }
78
86
  catch (error) {
79
87
  // Check if it's a missing dependency error
80
- if (((_d = error.message) === null || _d === void 0 ? void 0 : _d.includes('Cannot find module')) ||
81
- ((_e = error.message) === null || _e === void 0 ? void 0 : _e.includes('Failed to resolve module'))) {
88
+ const message = getErrorMessage(error);
89
+ if ((message === null || message === void 0 ? void 0 : message.includes('Cannot find module')) ||
90
+ (message === null || message === void 0 ? void 0 : message.includes('Failed to resolve module'))) {
82
91
  const manifest = this.manifests.get(this.canonicalName(name));
83
92
  if (manifest === null || manifest === void 0 ? void 0 : manifest.packageName) {
84
93
  throw new Error(`Missing dependency for ${manifest.displayName} provider.\n\n` +
@@ -142,56 +151,53 @@ ProviderRegistry.NAME_ALIASES = {
142
151
  phone_password: 'phone-password',
143
152
  email_code: 'email-code',
144
153
  };
154
+ /**
155
+ * Every provider this package knows about (canonical loader keys). Used to distinguish a
156
+ * recognized-but-not-yet-enabled provider (→ PROVIDER_NOT_ENABLED) from a genuinely unknown one
157
+ * (→ UNSUPPORTED_PROVIDER). As of 2.4.1 only `google` has a registered loader; the rest are
158
+ * re-enabled one at a time (see docs/features/google-provider-production-v3).
159
+ */
160
+ ProviderRegistry.RECOGNIZED_PROVIDERS = new Set([
161
+ 'google',
162
+ 'apple',
163
+ 'microsoft',
164
+ 'facebook',
165
+ 'github',
166
+ 'slack',
167
+ 'linkedin',
168
+ 'firebase',
169
+ 'magic-link',
170
+ 'sms',
171
+ 'email-password',
172
+ 'phone-password',
173
+ 'username-password',
174
+ 'email-code',
175
+ 'biometric',
176
+ ]);
145
177
  (() => {
146
178
  // Register built-in provider manifests (data lives in provider-manifests.ts — F-40).
147
179
  for (const manifest of BUILT_IN_PROVIDER_MANIFESTS) {
148
180
  _a.registerManifest(manifest);
149
181
  }
150
- // Register provider loaders
151
- _a.registerLoader('google', () => import('../providers/web/google-provider').then((m) => ({
152
- default: m.GoogleAuthProviderWeb,
153
- })));
154
- _a.registerLoader('apple', () => import('../providers/web/apple-provider').then((m) => ({
155
- default: m.AppleAuthProviderWeb,
156
- })));
157
- _a.registerLoader('microsoft', () => import('../providers/web/microsoft-provider').then((m) => ({
158
- default: m.MicrosoftAuthProviderWeb,
159
- })));
160
- _a.registerLoader('facebook', () => import('../providers/web/facebook-provider').then((m) => ({
161
- default: m.FacebookAuthProviderWeb,
162
- })));
163
- _a.registerLoader('github', () => import('../providers/web/github-provider').then((m) => ({
164
- default: m.GitHubAuthProviderWeb,
165
- })));
166
- _a.registerLoader('firebase', () => import('../providers/web/firebase-provider').then((m) => ({
167
- default: m.FirebaseAuthProviderWeb,
168
- })));
169
- _a.registerLoader('magic-link', () => import('../providers/web/magic-link-provider').then((m) => ({
170
- default: m.MagicLinkProvider,
171
- })));
172
- _a.registerLoader('sms', () => import('../providers/web/sms-provider').then((m) => ({
173
- default: m.SMSProvider,
174
- })));
175
- _a.registerLoader('email-password', () => import('../providers/web/email-password-provider').then((m) => ({
176
- default: m.EmailPasswordProvider,
177
- })));
178
- _a.registerLoader('biometric', () => import('../providers/web/biometric-provider').then((m) => ({
179
- default: m.BiometricProvider,
180
- })));
181
- _a.registerLoader('slack', () => import('../providers/web/slack-provider').then((m) => ({
182
- default: m.SlackProvider,
183
- })));
184
- _a.registerLoader('linkedin', () => import('../providers/web/linkedin-provider').then((m) => ({
185
- default: m.LinkedInProvider,
186
- })));
187
- _a.registerLoader('username-password', () => import('../providers/web/username-password-provider').then((m) => ({
188
- default: m.UsernamePasswordProvider,
189
- })));
190
- _a.registerLoader('email-code', () => import('../providers/web/email-code-provider').then((m) => ({
191
- default: m.EmailCodeProvider,
192
- })));
193
- _a.registerLoader('phone-password', () => import('../providers/web/phone-password-provider').then((m) => ({
194
- default: m.PhonePasswordProvider,
195
- })));
182
+ // --- Provider loaders -----------------------------------------------------------------
183
+ // WIP: providers are enabled ONE AT A TIME (see docs/features/google-provider-production-v3).
184
+ // As of 2.4.1 only Google is enabled. The Google loader is PLATFORM-AWARE: native (iOS/Android)
185
+ // routes to the native Google SDK through the Capacitor plugin bridge; web/electron uses Google
186
+ // Identity Services in the browser — same `auth.signIn(AuthProvider.GOOGLE)` call on every platform.
187
+ _a.registerLoader('google', () => {
188
+ const { platform } = PlatformDetector.getPlatform();
189
+ return platform === 'ios' || platform === 'android'
190
+ ? import('../providers/native/google-native-provider').then((m) => ({
191
+ default: m.GoogleNativeProvider,
192
+ }))
193
+ : import('../providers/web/google-provider').then((m) => ({
194
+ default: m.GoogleAuthProviderWeb,
195
+ }));
196
+ });
197
+ // The remaining providers (apple, microsoft, facebook, github, slack, linkedin, firebase,
198
+ // magic-link, sms, email-password, phone-password, username-password, email-code, biometric)
199
+ // are intentionally NOT registered yet. Their web implementations still live under
200
+ // src/providers/web/ but are excluded from the published build (tsconfig.build.json). Re-enable
201
+ // each by restoring its loader here (and removing its tsconfig.build exclude) once it has been
202
+ // hardened and verified on device. signIn() for any of them throws PROVIDER_NOT_ENABLED below.
196
203
  })();
197
- //# sourceMappingURL=provider-registry.js.map
@@ -1,2 +1 @@
1
1
  export {};
2
- //# sourceMappingURL=types.js.map
@@ -77,11 +77,22 @@ export declare const AUTH_PROVIDERS: {
77
77
  };
78
78
  export type ProviderOptions = GoogleAuthOptions | AppleAuthOptions | MicrosoftAuthOptions | FacebookAuthOptions | GitHubAuthOptions | SlackAuthOptions | LinkedInAuthOptions | FirebaseAuthOptions | EmailMagicLinkOptions | SmsAuthOptions | EmailPasswordOptions | PhonePasswordOptions | UsernamePasswordOptions | EmailCodeOptions | BiometricAuthOptions;
79
79
  export interface GoogleAuthOptions {
80
+ /**
81
+ * OAuth 2.0 Web client ID. Required on web (GIS) and used as the Credential-Manager `serverClientId`
82
+ * on Android when `serverClientId` is not set separately. This is the value you read the idToken's
83
+ * `aud` against — the same Web client id you register for Firebase Google sign-in.
84
+ */
80
85
  clientId: string;
81
86
  clientSecret?: string;
82
87
  scopes?: string[];
83
88
  hostedDomain?: string;
89
+ /**
90
+ * Web (server) OAuth client ID. **Required on Android** (Credential Manager) to receive an idToken,
91
+ * and used on iOS to request a `serverAuthCode` for offline access. Falls back to `clientId` when omitted.
92
+ */
84
93
  serverClientId?: string;
94
+ /** iOS OAuth client ID (the `GIDClientID`). Falls back to the Info.plist `GIDClientID` when omitted. */
95
+ iosClientId?: string;
85
96
  offlineAccess?: boolean;
86
97
  forceCodeForRefreshToken?: boolean;
87
98
  accountName?: string;
@@ -89,6 +100,15 @@ export interface GoogleAuthOptions {
89
100
  loginHint?: string;
90
101
  requestIdToken?: boolean;
91
102
  requestServerAuthCode?: boolean;
103
+ /**
104
+ * Android Credential Manager: only surface accounts that have previously authorized this app
105
+ * (silent / returning-user UX). Default false so first-time sign-in shows all Google accounts.
106
+ */
107
+ filterByAuthorizedAccounts?: boolean;
108
+ /** Android Credential Manager: auto-select a single previously-used account without a tap. Default false. */
109
+ autoSelectEnabled?: boolean;
110
+ /** GIS web: a per-request nonce (also forwarded to Android). Validated against the returned idToken. */
111
+ nonce?: string;
92
112
  }
93
113
  export interface AppleAuthOptions {
94
114
  clientId: string;
@@ -397,6 +417,13 @@ export interface AuthCredential {
397
417
  tokenType?: string;
398
418
  scope?: string;
399
419
  rawNonce?: string;
420
+ /**
421
+ * One-time server auth code (Google offline access). Exchange it on YOUR backend for a refresh
422
+ * token / long-lived access token — never in the browser. Populated on iOS (and Android via the
423
+ * Authorization API) when `serverClientId` + offline access are requested; not returned by the
424
+ * web GIS id-token flow.
425
+ */
426
+ serverAuthCode?: string;
400
427
  }
401
428
  export interface AdditionalUserInfo {
402
429
  isNewUser: boolean;
@@ -593,5 +620,7 @@ export declare enum AuthErrorCode {
593
620
  NO_STORED_CREDENTIALS = "auth/no-stored-credentials",
594
621
  STORAGE_ERROR = "auth/storage-error",
595
622
  BIOMETRIC_LOCKOUT = "auth/biometric-lockout",
596
- PROVIDER_UNSUPPORTED_OPERATION = "auth/provider-unsupported-operation"
623
+ PROVIDER_UNSUPPORTED_OPERATION = "auth/provider-unsupported-operation",
624
+ OPERATION_NOT_SUPPORTED = "auth/operation-not-supported",
625
+ PROVIDER_NOT_ENABLED = "auth/provider-not-enabled"
597
626
  }
@@ -138,5 +138,12 @@ export var AuthErrorCode;
138
138
  AuthErrorCode["STORAGE_ERROR"] = "auth/storage-error";
139
139
  AuthErrorCode["BIOMETRIC_LOCKOUT"] = "auth/biometric-lockout";
140
140
  AuthErrorCode["PROVIDER_UNSUPPORTED_OPERATION"] = "auth/provider-unsupported-operation";
141
+ // The active provider does not implement an optional capability (e.g. token refresh).
142
+ // Same string the manager previously threw as a bare literal — now an enum member so
143
+ // consumers can switch on `AuthErrorCode.OPERATION_NOT_SUPPORTED` reliably.
144
+ AuthErrorCode["OPERATION_NOT_SUPPORTED"] = "auth/operation-not-supported";
145
+ // The provider is recognized but not yet enabled in this release. As of 2.4.1 the package ships
146
+ // a hardened Google provider and re-enables the remaining providers one at a time. Switch on this
147
+ // to detect a "coming soon" provider distinctly from an unknown one.
148
+ AuthErrorCode["PROVIDER_NOT_ENABLED"] = "auth/provider-not-enabled";
141
149
  })(AuthErrorCode || (AuthErrorCode = {}));
142
- //# sourceMappingURL=definitions.js.map
package/dist/esm/index.js CHANGED
@@ -13,4 +13,3 @@ export { AuthError, isAuthError } from './utils/auth-error';
13
13
  export { Logger, defaultLogger } from './utils/logger';
14
14
  // For backward compatibility with Capacitor plugin interface
15
15
  export { CapacitorAuthManager } from './capacitor-plugin';
16
- //# sourceMappingURL=index.js.map
@@ -164,4 +164,3 @@ export class BaseAuthProvider {
164
164
  this.isInitialized = false;
165
165
  }
166
166
  }
167
- //# sourceMappingURL=base-provider.js.map
@@ -0,0 +1,26 @@
1
+ import { AuthResult, AuthUser, SignInOptions, SignOutOptions, RefreshTokenOptions } from '../../definitions';
2
+ import { BaseAuthProvider } from '../base-provider';
3
+ /**
4
+ * Native Google provider — the implementation the registry loads on **iOS / Android**.
5
+ *
6
+ * It is a thin bridge to the `CapacitorAuthManager` Capacitor plugin, whose native code runs the
7
+ * platform Google SDK (iOS: GoogleSignIn; Android: Credential Manager + Google Identity) and returns
8
+ * a **Firebase-agnostic** credential — `{ idToken, accessToken?, serverAuthCode?, user }`. The same
9
+ * `auth.signIn(AuthProvider.GOOGLE)` call routes here on a device and to `GoogleAuthProviderWeb` in
10
+ * the browser, so app code is identical across platforms. Consumers feed `result.credential.idToken`
11
+ * into their own `signInWithCredential(GoogleAuthProvider.credential(idToken))` (or anything else).
12
+ *
13
+ * This module is only ever dynamically imported on native platforms (see ProviderRegistry's
14
+ * platform-aware Google loader), so its top-level `@capacitor/core` import never reaches a web bundle.
15
+ */
16
+ export declare class GoogleNativeProvider extends BaseAuthProvider {
17
+ constructor(config?: unknown);
18
+ get name(): string;
19
+ initialize(): Promise<void>;
20
+ signIn(options?: SignInOptions): Promise<AuthResult>;
21
+ signOut(_options?: SignOutOptions): Promise<void>;
22
+ refreshToken(_options?: RefreshTokenOptions): Promise<AuthResult>;
23
+ getCurrentUser(): Promise<AuthUser | null>;
24
+ revokeAccess(_token?: string): Promise<void>;
25
+ isSupported(): Promise<boolean>;
26
+ }
@@ -0,0 +1,114 @@
1
+ import { AuthProvider, } from '../../definitions';
2
+ import { BaseAuthProvider, resolveProviderConfig, } from '../base-provider';
3
+ import { AuthError } from '../../utils/auth-error';
4
+ import { CapacitorAuthManager } from '../../capacitor-plugin';
5
+ /**
6
+ * Native Google provider — the implementation the registry loads on **iOS / Android**.
7
+ *
8
+ * It is a thin bridge to the `CapacitorAuthManager` Capacitor plugin, whose native code runs the
9
+ * platform Google SDK (iOS: GoogleSignIn; Android: Credential Manager + Google Identity) and returns
10
+ * a **Firebase-agnostic** credential — `{ idToken, accessToken?, serverAuthCode?, user }`. The same
11
+ * `auth.signIn(AuthProvider.GOOGLE)` call routes here on a device and to `GoogleAuthProviderWeb` in
12
+ * the browser, so app code is identical across platforms. Consumers feed `result.credential.idToken`
13
+ * into their own `signInWithCredential(GoogleAuthProvider.credential(idToken))` (or anything else).
14
+ *
15
+ * This module is only ever dynamically imported on native platforms (see ProviderRegistry's
16
+ * platform-aware Google loader), so its top-level `@capacitor/core` import never reaches a web bundle.
17
+ */
18
+ export class GoogleNativeProvider extends BaseAuthProvider {
19
+ constructor(config) {
20
+ super(resolveProviderConfig(AuthProvider.GOOGLE, config));
21
+ }
22
+ get name() {
23
+ return AuthProvider.GOOGLE;
24
+ }
25
+ async initialize() {
26
+ if (this.isInitialized) {
27
+ return;
28
+ }
29
+ try {
30
+ // Hand the Google config (clientId / serverClientId / iosClientId / scopes) to the native side
31
+ // once; subsequent signIn() calls only pass per-request SignInProviderOptions.
32
+ await CapacitorAuthManager.initialize({
33
+ providers: [
34
+ {
35
+ provider: AuthProvider.GOOGLE,
36
+ options: this.options,
37
+ },
38
+ ],
39
+ });
40
+ await this.loadCurrentUser();
41
+ this.isInitialized = true;
42
+ }
43
+ catch (error) {
44
+ throw AuthError.fromError(error, AuthProvider.GOOGLE);
45
+ }
46
+ }
47
+ async signIn(options) {
48
+ if (!this.isInitialized) {
49
+ await this.initialize();
50
+ }
51
+ try {
52
+ const result = await CapacitorAuthManager.signIn({
53
+ provider: AuthProvider.GOOGLE,
54
+ options: options === null || options === void 0 ? void 0 : options.options,
55
+ });
56
+ await this.setCurrentUser(result.user);
57
+ return result;
58
+ }
59
+ catch (error) {
60
+ throw AuthError.fromError(error, AuthProvider.GOOGLE);
61
+ }
62
+ }
63
+ async signOut(_options) {
64
+ try {
65
+ await CapacitorAuthManager.signOut({ provider: AuthProvider.GOOGLE });
66
+ }
67
+ catch (error) {
68
+ throw AuthError.fromError(error, AuthProvider.GOOGLE);
69
+ }
70
+ finally {
71
+ await this.setCurrentUser(null);
72
+ }
73
+ }
74
+ async refreshToken(_options) {
75
+ try {
76
+ const result = await CapacitorAuthManager.refreshToken({
77
+ provider: AuthProvider.GOOGLE,
78
+ });
79
+ if (result.user) {
80
+ await this.setCurrentUser(result.user);
81
+ }
82
+ return result;
83
+ }
84
+ catch (error) {
85
+ throw AuthError.fromError(error, AuthProvider.GOOGLE);
86
+ }
87
+ }
88
+ async getCurrentUser() {
89
+ try {
90
+ const user = await CapacitorAuthManager.getCurrentUser();
91
+ this.currentUser = user;
92
+ return user;
93
+ }
94
+ catch (_a) {
95
+ // Fall back to the last known user if the bridge call fails (e.g. plugin not yet ready).
96
+ return this.currentUser;
97
+ }
98
+ }
99
+ async revokeAccess(_token) {
100
+ try {
101
+ await CapacitorAuthManager.revokeAccess({ provider: AuthProvider.GOOGLE });
102
+ }
103
+ catch (error) {
104
+ throw AuthError.fromError(error, AuthProvider.GOOGLE);
105
+ }
106
+ finally {
107
+ await this.setCurrentUser(null);
108
+ }
109
+ }
110
+ async isSupported() {
111
+ // Only loaded on native platforms (the registry routes web/electron to GoogleAuthProviderWeb).
112
+ return true;
113
+ }
114
+ }
@@ -376,4 +376,3 @@ export class OAuthProvider extends BaseAuthProvider {
376
376
  }
377
377
  }
378
378
  }
379
- //# sourceMappingURL=oauth-provider.js.map
@@ -4,6 +4,15 @@ import { AuthProviderInterface } from '../core/types';
4
4
  import { StorageInterface } from '../utils/storage';
5
5
  import { Logger } from '../utils/logger';
6
6
  export type AnyAuthProvider = BaseAuthProvider | AuthProviderInterface;
7
+ /**
8
+ * Legacy web-bridge factory (used by `CapacitorAuthManagerWeb` in `src/web.ts`).
9
+ *
10
+ * WIP: as of 2.4.1 only Google is enabled. Every other provider returns `null` here — the web bridge
11
+ * then leaves it unconfigured, and the modern `auth` API reports `AuthErrorCode.PROVIDER_NOT_ENABLED`.
12
+ * Providers are re-added one at a time as each is hardened (see
13
+ * docs/features/google-provider-production-v3). Their implementations still live under `web/` but are
14
+ * excluded from the published build until then.
15
+ */
7
16
  export declare class ProviderFactory {
8
17
  static createProvider(config: AuthProviderConfig, storage: StorageInterface, logger: Logger, persistence: AuthPersistence): Promise<AnyAuthProvider | null>;
9
18
  }