capacitor-auth-manager 2.4.0 → 2.4.2
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.
- package/CHANGELOG.md +180 -0
- package/CapacitorAuthManager.podspec +10 -18
- package/LICENSE +1 -1
- package/Readme.md +136 -595
- package/android/build.gradle +14 -18
- package/android/src/main/java/com/aoneahsan/capacitor_auth_manager/CapacitorAuthManager.java +44 -16
- package/android/src/main/java/com/aoneahsan/capacitor_auth_manager/CapacitorAuthManagerPlugin.java +24 -3
- package/android/src/main/java/com/aoneahsan/capacitor_auth_manager/GoogleAuthProvider.java +424 -226
- package/android/src/main/java/com/aoneahsan/capacitor_auth_manager/ProviderFactory.java +27 -99
- package/dist/angular.cjs.js +942 -4545
- package/dist/core.cjs.js +913 -4515
- package/dist/esm/angular/auth.guard.js +0 -1
- package/dist/esm/angular/auth.module.js +0 -1
- package/dist/esm/angular/auth.service.js +0 -1
- package/dist/esm/angular/index.d.ts +1 -0
- package/dist/esm/angular/index.js +4 -1
- package/dist/esm/capacitor-plugin.js +0 -1
- package/dist/esm/core/auth-manager.d.ts +6 -0
- package/dist/esm/core/auth-manager.js +25 -4
- package/dist/esm/core/index.js +0 -1
- package/dist/esm/core/platform.js +0 -1
- package/dist/esm/core/provider-manifests.js +0 -1
- package/dist/esm/core/provider-registry.d.ts +7 -0
- package/dist/esm/core/provider-registry.js +55 -53
- package/dist/esm/core/types.js +0 -1
- package/dist/esm/definitions.d.ts +30 -1
- package/dist/esm/definitions.js +8 -1
- package/dist/esm/index.js +0 -1
- package/dist/esm/providers/base-provider.js +0 -1
- package/dist/esm/providers/native/google-native-provider.d.ts +26 -0
- package/dist/esm/providers/native/google-native-provider.js +114 -0
- package/dist/esm/providers/oauth-provider.js +0 -1
- package/dist/esm/providers/provider-factory.d.ts +9 -0
- package/dist/esm/providers/provider-factory.js +20 -57
- package/dist/esm/providers/web/google-provider.d.ts +70 -92
- package/dist/esm/providers/web/google-provider.js +262 -205
- package/dist/esm/providers/web/index.d.ts +0 -14
- package/dist/esm/providers/web/index.js +7 -16
- package/dist/esm/react/hooks.js +0 -1
- package/dist/esm/react/index.d.ts +1 -0
- package/dist/esm/react/index.js +4 -1
- package/dist/esm/react/types.js +0 -1
- package/dist/esm/utils/auth-error.js +0 -1
- package/dist/esm/utils/error-message.js +0 -1
- package/dist/esm/utils/event-emitter.js +0 -1
- package/dist/esm/utils/logger.js +0 -1
- package/dist/esm/utils/pending-verification-store.js +0 -1
- package/dist/esm/utils/storage.js +0 -1
- package/dist/esm/vue/composables.js +0 -1
- package/dist/esm/vue/index.d.ts +1 -0
- package/dist/esm/vue/index.js +4 -1
- package/dist/esm/web.js +0 -1
- package/dist/plugin.cjs.js +435 -4664
- package/dist/plugin.js +435 -4664
- package/dist/react.cjs.js +942 -4545
- package/dist/vue.cjs.js +942 -4545
- package/ios/Plugin/CapacitorAuthManager.swift +12 -21
- package/ios/Plugin/GoogleAuthProvider.swift +213 -105
- package/ios/Plugin/Models.swift +35 -4
- package/ios/Plugin/Plugin.swift +4 -2
- package/package.json +31 -30
- package/android/src/main/java/com/aoneahsan/capacitor_auth_manager/FacebookAuthProvider.java +0 -389
- package/android/src/main/java/com/aoneahsan/capacitor_auth_manager/MicrosoftAuthProvider.java +0 -455
- package/dist/angular.cjs.js.map +0 -1
- package/dist/core.cjs.js.map +0 -1
- package/dist/esm/angular/auth.guard.js.map +0 -1
- package/dist/esm/angular/auth.module.js.map +0 -1
- package/dist/esm/angular/auth.service.js.map +0 -1
- package/dist/esm/angular/index.js.map +0 -1
- package/dist/esm/capacitor-plugin.js.map +0 -1
- package/dist/esm/core/auth-manager.js.map +0 -1
- package/dist/esm/core/index.js.map +0 -1
- package/dist/esm/core/platform.js.map +0 -1
- package/dist/esm/core/provider-manifests.js.map +0 -1
- package/dist/esm/core/provider-registry.js.map +0 -1
- package/dist/esm/core/types.js.map +0 -1
- package/dist/esm/definitions.js.map +0 -1
- package/dist/esm/index.js.map +0 -1
- package/dist/esm/providers/base-provider.js.map +0 -1
- package/dist/esm/providers/oauth-provider.js.map +0 -1
- package/dist/esm/providers/provider-factory.js.map +0 -1
- package/dist/esm/providers/web/apple-provider.d.ts +0 -61
- package/dist/esm/providers/web/apple-provider.js +0 -293
- package/dist/esm/providers/web/apple-provider.js.map +0 -1
- package/dist/esm/providers/web/biometric-provider.d.ts +0 -60
- package/dist/esm/providers/web/biometric-provider.js +0 -374
- package/dist/esm/providers/web/biometric-provider.js.map +0 -1
- package/dist/esm/providers/web/email-code-provider.d.ts +0 -46
- package/dist/esm/providers/web/email-code-provider.js +0 -294
- package/dist/esm/providers/web/email-code-provider.js.map +0 -1
- package/dist/esm/providers/web/email-password-provider.d.ts +0 -52
- package/dist/esm/providers/web/email-password-provider.js +0 -430
- package/dist/esm/providers/web/email-password-provider.js.map +0 -1
- package/dist/esm/providers/web/facebook-provider.d.ts +0 -80
- package/dist/esm/providers/web/facebook-provider.js +0 -249
- package/dist/esm/providers/web/facebook-provider.js.map +0 -1
- package/dist/esm/providers/web/firebase-provider.d.ts +0 -22
- package/dist/esm/providers/web/firebase-provider.js +0 -338
- package/dist/esm/providers/web/firebase-provider.js.map +0 -1
- package/dist/esm/providers/web/github-provider.d.ts +0 -34
- package/dist/esm/providers/web/github-provider.js +0 -325
- package/dist/esm/providers/web/github-provider.js.map +0 -1
- package/dist/esm/providers/web/google-provider.js.map +0 -1
- package/dist/esm/providers/web/index.js.map +0 -1
- package/dist/esm/providers/web/linkedin-provider.d.ts +0 -37
- package/dist/esm/providers/web/linkedin-provider.js +0 -178
- package/dist/esm/providers/web/linkedin-provider.js.map +0 -1
- package/dist/esm/providers/web/magic-link-provider.d.ts +0 -44
- package/dist/esm/providers/web/magic-link-provider.js +0 -311
- package/dist/esm/providers/web/magic-link-provider.js.map +0 -1
- package/dist/esm/providers/web/microsoft-provider.d.ts +0 -23
- package/dist/esm/providers/web/microsoft-provider.js +0 -236
- package/dist/esm/providers/web/microsoft-provider.js.map +0 -1
- package/dist/esm/providers/web/phone-password-provider.d.ts +0 -63
- package/dist/esm/providers/web/phone-password-provider.js +0 -442
- package/dist/esm/providers/web/phone-password-provider.js.map +0 -1
- package/dist/esm/providers/web/slack-provider.d.ts +0 -39
- package/dist/esm/providers/web/slack-provider.js +0 -175
- package/dist/esm/providers/web/slack-provider.js.map +0 -1
- package/dist/esm/providers/web/sms-provider.d.ts +0 -46
- package/dist/esm/providers/web/sms-provider.js +0 -306
- package/dist/esm/providers/web/sms-provider.js.map +0 -1
- package/dist/esm/providers/web/username-password-provider.d.ts +0 -59
- package/dist/esm/providers/web/username-password-provider.js +0 -435
- package/dist/esm/providers/web/username-password-provider.js.map +0 -1
- package/dist/esm/react/hooks.js.map +0 -1
- package/dist/esm/react/index.js.map +0 -1
- package/dist/esm/react/types.js.map +0 -1
- package/dist/esm/utils/auth-error.js.map +0 -1
- package/dist/esm/utils/error-message.js.map +0 -1
- package/dist/esm/utils/event-emitter.js.map +0 -1
- package/dist/esm/utils/logger.js.map +0 -1
- package/dist/esm/utils/pending-verification-store.js.map +0 -1
- package/dist/esm/utils/storage.js.map +0 -1
- package/dist/esm/vue/composables.js.map +0 -1
- package/dist/esm/vue/index.js.map +0 -1
- package/dist/esm/web.js.map +0 -1
- package/dist/plugin.cjs.js.map +0 -1
- package/dist/plugin.js.map +0 -1
- package/dist/react.cjs.js.map +0 -1
- package/dist/vue.cjs.js.map +0 -1
- package/ios/Plugin/AppleAuthProvider.swift +0 -288
- package/ios/Plugin/FacebookAuthProvider.swift +0 -297
- package/ios/Plugin/GitHubAuthProvider.swift +0 -54
- package/ios/Plugin/LinkedInAuthProvider.swift +0 -63
- package/ios/Plugin/MicrosoftAuthProvider.swift +0 -315
- package/ios/Plugin/OAuthWebProvider.swift +0 -415
- package/ios/Plugin/SlackAuthProvider.swift +0 -108
|
@@ -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
|
-
|
|
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';
|
|
@@ -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
|
|
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(
|
|
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
|
package/dist/esm/core/index.js
CHANGED
|
@@ -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
|
-
|
|
34
|
-
|
|
35
|
-
|
|
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
|
|
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
|
-
//
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
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
|
package/dist/esm/core/types.js
CHANGED
|
@@ -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
|
}
|
package/dist/esm/definitions.js
CHANGED
|
@@ -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
|
|
@@ -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
|
+
}
|
|
@@ -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
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
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
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
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
|