capacitor-auth-manager 2.4.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 (138) 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 +942 -4545
  11. package/dist/core.cjs.js +913 -4515
  12. package/dist/esm/angular/auth.guard.js +0 -1
  13. package/dist/esm/angular/auth.module.js +0 -1
  14. package/dist/esm/angular/auth.service.js +0 -1
  15. package/dist/esm/angular/index.d.ts +1 -0
  16. package/dist/esm/angular/index.js +4 -1
  17. package/dist/esm/capacitor-plugin.js +0 -1
  18. package/dist/esm/core/auth-manager.d.ts +6 -0
  19. package/dist/esm/core/auth-manager.js +25 -4
  20. package/dist/esm/core/index.js +0 -1
  21. package/dist/esm/core/platform.js +0 -1
  22. package/dist/esm/core/provider-manifests.js +0 -1
  23. package/dist/esm/core/provider-registry.d.ts +7 -0
  24. package/dist/esm/core/provider-registry.js +55 -53
  25. package/dist/esm/core/types.js +0 -1
  26. package/dist/esm/definitions.d.ts +30 -1
  27. package/dist/esm/definitions.js +8 -1
  28. package/dist/esm/index.js +0 -1
  29. package/dist/esm/providers/base-provider.js +0 -1
  30. package/dist/esm/providers/native/google-native-provider.d.ts +26 -0
  31. package/dist/esm/providers/native/google-native-provider.js +114 -0
  32. package/dist/esm/providers/oauth-provider.js +0 -1
  33. package/dist/esm/providers/provider-factory.d.ts +9 -0
  34. package/dist/esm/providers/provider-factory.js +20 -57
  35. package/dist/esm/providers/web/google-provider.d.ts +70 -92
  36. package/dist/esm/providers/web/google-provider.js +262 -205
  37. package/dist/esm/providers/web/index.d.ts +0 -14
  38. package/dist/esm/providers/web/index.js +7 -16
  39. package/dist/esm/react/hooks.js +0 -1
  40. package/dist/esm/react/index.d.ts +1 -0
  41. package/dist/esm/react/index.js +4 -1
  42. package/dist/esm/react/types.js +0 -1
  43. package/dist/esm/utils/auth-error.js +0 -1
  44. package/dist/esm/utils/error-message.js +0 -1
  45. package/dist/esm/utils/event-emitter.js +0 -1
  46. package/dist/esm/utils/logger.js +0 -1
  47. package/dist/esm/utils/pending-verification-store.js +0 -1
  48. package/dist/esm/utils/storage.js +0 -1
  49. package/dist/esm/vue/composables.js +0 -1
  50. package/dist/esm/vue/index.d.ts +1 -0
  51. package/dist/esm/vue/index.js +4 -1
  52. package/dist/esm/web.js +0 -1
  53. package/dist/plugin.cjs.js +435 -4664
  54. package/dist/plugin.js +435 -4664
  55. package/dist/react.cjs.js +942 -4545
  56. package/dist/vue.cjs.js +942 -4545
  57. package/ios/Plugin/CapacitorAuthManager.swift +6 -6
  58. package/ios/Plugin/GoogleAuthProvider.swift +213 -105
  59. package/ios/Plugin/Models.swift +35 -4
  60. package/package.json +31 -30
  61. package/dist/angular.cjs.js.map +0 -1
  62. package/dist/core.cjs.js.map +0 -1
  63. package/dist/esm/angular/auth.guard.js.map +0 -1
  64. package/dist/esm/angular/auth.module.js.map +0 -1
  65. package/dist/esm/angular/auth.service.js.map +0 -1
  66. package/dist/esm/angular/index.js.map +0 -1
  67. package/dist/esm/capacitor-plugin.js.map +0 -1
  68. package/dist/esm/core/auth-manager.js.map +0 -1
  69. package/dist/esm/core/index.js.map +0 -1
  70. package/dist/esm/core/platform.js.map +0 -1
  71. package/dist/esm/core/provider-manifests.js.map +0 -1
  72. package/dist/esm/core/provider-registry.js.map +0 -1
  73. package/dist/esm/core/types.js.map +0 -1
  74. package/dist/esm/definitions.js.map +0 -1
  75. package/dist/esm/index.js.map +0 -1
  76. package/dist/esm/providers/base-provider.js.map +0 -1
  77. package/dist/esm/providers/oauth-provider.js.map +0 -1
  78. package/dist/esm/providers/provider-factory.js.map +0 -1
  79. package/dist/esm/providers/web/apple-provider.d.ts +0 -61
  80. package/dist/esm/providers/web/apple-provider.js +0 -293
  81. package/dist/esm/providers/web/apple-provider.js.map +0 -1
  82. package/dist/esm/providers/web/biometric-provider.d.ts +0 -60
  83. package/dist/esm/providers/web/biometric-provider.js +0 -374
  84. package/dist/esm/providers/web/biometric-provider.js.map +0 -1
  85. package/dist/esm/providers/web/email-code-provider.d.ts +0 -46
  86. package/dist/esm/providers/web/email-code-provider.js +0 -294
  87. package/dist/esm/providers/web/email-code-provider.js.map +0 -1
  88. package/dist/esm/providers/web/email-password-provider.d.ts +0 -52
  89. package/dist/esm/providers/web/email-password-provider.js +0 -430
  90. package/dist/esm/providers/web/email-password-provider.js.map +0 -1
  91. package/dist/esm/providers/web/facebook-provider.d.ts +0 -80
  92. package/dist/esm/providers/web/facebook-provider.js +0 -249
  93. package/dist/esm/providers/web/facebook-provider.js.map +0 -1
  94. package/dist/esm/providers/web/firebase-provider.d.ts +0 -22
  95. package/dist/esm/providers/web/firebase-provider.js +0 -338
  96. package/dist/esm/providers/web/firebase-provider.js.map +0 -1
  97. package/dist/esm/providers/web/github-provider.d.ts +0 -34
  98. package/dist/esm/providers/web/github-provider.js +0 -325
  99. package/dist/esm/providers/web/github-provider.js.map +0 -1
  100. package/dist/esm/providers/web/google-provider.js.map +0 -1
  101. package/dist/esm/providers/web/index.js.map +0 -1
  102. package/dist/esm/providers/web/linkedin-provider.d.ts +0 -37
  103. package/dist/esm/providers/web/linkedin-provider.js +0 -178
  104. package/dist/esm/providers/web/linkedin-provider.js.map +0 -1
  105. package/dist/esm/providers/web/magic-link-provider.d.ts +0 -44
  106. package/dist/esm/providers/web/magic-link-provider.js +0 -311
  107. package/dist/esm/providers/web/magic-link-provider.js.map +0 -1
  108. package/dist/esm/providers/web/microsoft-provider.d.ts +0 -23
  109. package/dist/esm/providers/web/microsoft-provider.js +0 -236
  110. package/dist/esm/providers/web/microsoft-provider.js.map +0 -1
  111. package/dist/esm/providers/web/phone-password-provider.d.ts +0 -63
  112. package/dist/esm/providers/web/phone-password-provider.js +0 -442
  113. package/dist/esm/providers/web/phone-password-provider.js.map +0 -1
  114. package/dist/esm/providers/web/slack-provider.d.ts +0 -39
  115. package/dist/esm/providers/web/slack-provider.js +0 -175
  116. package/dist/esm/providers/web/slack-provider.js.map +0 -1
  117. package/dist/esm/providers/web/sms-provider.d.ts +0 -46
  118. package/dist/esm/providers/web/sms-provider.js +0 -306
  119. package/dist/esm/providers/web/sms-provider.js.map +0 -1
  120. package/dist/esm/providers/web/username-password-provider.d.ts +0 -59
  121. package/dist/esm/providers/web/username-password-provider.js +0 -435
  122. package/dist/esm/providers/web/username-password-provider.js.map +0 -1
  123. package/dist/esm/react/hooks.js.map +0 -1
  124. package/dist/esm/react/index.js.map +0 -1
  125. package/dist/esm/react/types.js.map +0 -1
  126. package/dist/esm/utils/auth-error.js.map +0 -1
  127. package/dist/esm/utils/error-message.js.map +0 -1
  128. package/dist/esm/utils/event-emitter.js.map +0 -1
  129. package/dist/esm/utils/logger.js.map +0 -1
  130. package/dist/esm/utils/pending-verification-store.js.map +0 -1
  131. package/dist/esm/utils/storage.js.map +0 -1
  132. package/dist/esm/vue/composables.js.map +0 -1
  133. package/dist/esm/vue/index.js.map +0 -1
  134. package/dist/esm/web.js.map +0 -1
  135. package/dist/plugin.cjs.js.map +0 -1
  136. package/dist/plugin.js.map +0 -1
  137. package/dist/react.cjs.js.map +0 -1
  138. 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
@@ -53,4 +53,3 @@ let AuthModule = (() => {
53
53
  return AuthModule = _classThis;
54
54
  })();
55
55
  export { AuthModule };
56
- //# sourceMappingURL=auth.module.js.map
@@ -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
  /**
@@ -150,11 +150,16 @@ class AuthManagerCore {
150
150
  provider: providerName,
151
151
  isLoading: false,
152
152
  });
153
- // 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.
154
159
  await this.storage.set('auth_state', {
155
160
  user: result.user,
156
161
  provider: providerName,
157
- credential: result.credential,
162
+ credential: this.sanitizeCredentialForStorage(result.credential),
158
163
  });
159
164
  // Setup token refresh
160
165
  if (this.config.autoRefreshToken && ((_c = result.credential) === null || _c === void 0 ? void 0 : _c.refreshToken)) {
@@ -231,7 +236,7 @@ class AuthManagerCore {
231
236
  const providerConfig = (_a = this.config.providers) === null || _a === void 0 ? void 0 : _a[targetProvider];
232
237
  const providerInstance = await ProviderRegistry.getProvider(targetProvider, providerConfig, this.getProviderDeps());
233
238
  if (!providerInstance.refreshToken) {
234
- 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`);
235
240
  }
236
241
  const result = await providerInstance.refreshToken();
237
242
  // Update user
@@ -455,6 +460,23 @@ class AuthManagerCore {
455
460
  this.state = Object.assign(Object.assign({}, this.state), partial);
456
461
  this.stateEmitter.emit(this.state);
457
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
+ }
458
480
  async restoreAuthState() {
459
481
  var _a, _b;
460
482
  try {
@@ -556,4 +578,3 @@ class AuthManagerCore {
556
578
  }
557
579
  // Create singleton instance
558
580
  export const auth = new AuthManagerCore();
559
- //# 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
@@ -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,6 +1,7 @@
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';
6
7
  import { getErrorMessage } from '../utils/error-message';
@@ -27,14 +28,18 @@ export class ProviderRegistry {
27
28
  if (existing) {
28
29
  return existing;
29
30
  }
30
- // 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.
31
34
  const loader = this.loaders.get(key);
32
35
  if (!loader) {
33
- const manifest = this.manifests.get(key);
34
- if (manifest) {
35
- 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.`);
36
41
  }
37
- throw new Error(`Unknown provider: ${name}`);
42
+ throw new AuthError(AuthErrorCode.UNSUPPORTED_PROVIDER, `Unknown provider: ${name}`);
38
43
  }
39
44
  // Check platform support
40
45
  const manifest = this.manifests.get(key);
@@ -146,56 +151,53 @@ ProviderRegistry.NAME_ALIASES = {
146
151
  phone_password: 'phone-password',
147
152
  email_code: 'email-code',
148
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
+ ]);
149
177
  (() => {
150
178
  // Register built-in provider manifests (data lives in provider-manifests.ts — F-40).
151
179
  for (const manifest of BUILT_IN_PROVIDER_MANIFESTS) {
152
180
  _a.registerManifest(manifest);
153
181
  }
154
- // Register provider loaders
155
- _a.registerLoader('google', () => import('../providers/web/google-provider').then((m) => ({
156
- default: m.GoogleAuthProviderWeb,
157
- })));
158
- _a.registerLoader('apple', () => import('../providers/web/apple-provider').then((m) => ({
159
- default: m.AppleAuthProviderWeb,
160
- })));
161
- _a.registerLoader('microsoft', () => import('../providers/web/microsoft-provider').then((m) => ({
162
- default: m.MicrosoftAuthProviderWeb,
163
- })));
164
- _a.registerLoader('facebook', () => import('../providers/web/facebook-provider').then((m) => ({
165
- default: m.FacebookAuthProviderWeb,
166
- })));
167
- _a.registerLoader('github', () => import('../providers/web/github-provider').then((m) => ({
168
- default: m.GitHubAuthProviderWeb,
169
- })));
170
- _a.registerLoader('firebase', () => import('../providers/web/firebase-provider').then((m) => ({
171
- default: m.FirebaseAuthProviderWeb,
172
- })));
173
- _a.registerLoader('magic-link', () => import('../providers/web/magic-link-provider').then((m) => ({
174
- default: m.MagicLinkProvider,
175
- })));
176
- _a.registerLoader('sms', () => import('../providers/web/sms-provider').then((m) => ({
177
- default: m.SMSProvider,
178
- })));
179
- _a.registerLoader('email-password', () => import('../providers/web/email-password-provider').then((m) => ({
180
- default: m.EmailPasswordProvider,
181
- })));
182
- _a.registerLoader('biometric', () => import('../providers/web/biometric-provider').then((m) => ({
183
- default: m.BiometricProvider,
184
- })));
185
- _a.registerLoader('slack', () => import('../providers/web/slack-provider').then((m) => ({
186
- default: m.SlackProvider,
187
- })));
188
- _a.registerLoader('linkedin', () => import('../providers/web/linkedin-provider').then((m) => ({
189
- default: m.LinkedInProvider,
190
- })));
191
- _a.registerLoader('username-password', () => import('../providers/web/username-password-provider').then((m) => ({
192
- default: m.UsernamePasswordProvider,
193
- })));
194
- _a.registerLoader('email-code', () => import('../providers/web/email-code-provider').then((m) => ({
195
- default: m.EmailCodeProvider,
196
- })));
197
- _a.registerLoader('phone-password', () => import('../providers/web/phone-password-provider').then((m) => ({
198
- default: m.PhonePasswordProvider,
199
- })));
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.
200
203
  })();
201
- //# 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
  }
@@ -1,64 +1,27 @@
1
1
  import { AuthProvider, } from '../definitions';
2
2
  import { GoogleAuthProviderWeb } from './web/google-provider';
3
- import { AppleAuthProviderWeb } from './web/apple-provider';
4
- import { MicrosoftAuthProviderWeb } from './web/microsoft-provider';
5
- import { FacebookAuthProviderWeb } from './web/facebook-provider';
6
- import { GitHubAuthProviderWeb } from './web/github-provider';
7
- import { SlackProvider } from './web/slack-provider';
8
- import { LinkedInProvider } from './web/linkedin-provider';
9
- import { FirebaseAuthProviderWeb } from './web/firebase-provider';
10
- import { MagicLinkProvider, } from './web/magic-link-provider';
11
- import { SMSProvider } from './web/sms-provider';
12
- import { EmailPasswordProvider, } from './web/email-password-provider';
13
- import { UsernamePasswordProvider, } from './web/username-password-provider';
14
- import { BiometricProvider } from './web/biometric-provider';
15
- import { EmailCodeProvider, } from './web/email-code-provider';
16
- import { PhonePasswordProvider, } from './web/phone-password-provider';
3
+ /**
4
+ * Legacy web-bridge factory (used by `CapacitorAuthManagerWeb` in `src/web.ts`).
5
+ *
6
+ * WIP: as of 2.4.1 only Google is enabled. Every other provider returns `null` here — the web bridge
7
+ * then leaves it unconfigured, and the modern `auth` API reports `AuthErrorCode.PROVIDER_NOT_ENABLED`.
8
+ * Providers are re-added one at a time as each is hardened (see
9
+ * docs/features/google-provider-production-v3). Their implementations still live under `web/` but are
10
+ * excluded from the published build until then.
11
+ */
17
12
  export class ProviderFactory {
18
13
  static async createProvider(config, storage, logger, persistence) {
19
- const providerConfig = {
20
- provider: config.provider,
21
- options: config.options,
22
- storage,
23
- logger,
24
- persistence,
25
- };
26
- switch (config.provider) {
27
- case AuthProvider.GOOGLE:
28
- return new GoogleAuthProviderWeb(providerConfig);
29
- case AuthProvider.APPLE:
30
- return new AppleAuthProviderWeb(providerConfig);
31
- case AuthProvider.MICROSOFT:
32
- return new MicrosoftAuthProviderWeb(providerConfig);
33
- case AuthProvider.FACEBOOK:
34
- return new FacebookAuthProviderWeb(providerConfig);
35
- case AuthProvider.GITHUB:
36
- return new GitHubAuthProviderWeb(providerConfig);
37
- case AuthProvider.SLACK:
38
- return new SlackProvider(providerConfig);
39
- case AuthProvider.LINKEDIN:
40
- return new LinkedInProvider(providerConfig);
41
- case AuthProvider.FIREBASE:
42
- return new FirebaseAuthProviderWeb(providerConfig);
43
- // Standalone providers with their own config types
44
- case AuthProvider.EMAIL_MAGIC_LINK:
45
- return new MagicLinkProvider(config.options);
46
- case AuthProvider.SMS:
47
- return new SMSProvider(config.options);
48
- case AuthProvider.EMAIL_PASSWORD:
49
- return new EmailPasswordProvider(config.options);
50
- case AuthProvider.USERNAME_PASSWORD:
51
- return new UsernamePasswordProvider(config.options);
52
- case AuthProvider.BIOMETRIC:
53
- return new BiometricProvider(config.options);
54
- case AuthProvider.PHONE_PASSWORD:
55
- return new PhonePasswordProvider(config.options);
56
- case AuthProvider.EMAIL_CODE:
57
- return new EmailCodeProvider(config.options);
58
- default:
59
- logger.error(`Unknown provider: ${config.provider}`);
60
- return null;
14
+ if (config.provider === AuthProvider.GOOGLE) {
15
+ return new GoogleAuthProviderWeb({
16
+ provider: config.provider,
17
+ options: config.options,
18
+ storage,
19
+ logger,
20
+ persistence,
21
+ });
61
22
  }
23
+ logger.warn(`Provider '${config.provider}' is not enabled yet — capacitor-auth-manager currently ships a ` +
24
+ `hardened Google provider; the rest are re-enabled one at a time.`);
25
+ return null;
62
26
  }
63
27
  }
64
- //# sourceMappingURL=provider-factory.js.map