Skip to content

feat(age-signals): add DECLARED status, ageRangeDeclaration, and SDK_VERSION_OUTDATED error #811

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
robingenz merged 8 commits into from
May 12, 2026
Merged

feat(age-signals): add DECLARED status, ageRangeDeclaration, and SDK_VERSION_OUTDATED error #811

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
cd49ee9
feat(age-signals): add `DECLARED` status, `ageRangeDeclaration`, and …
robingenz Mar 28, 2026
69b073e
Add changeset
robingenz Mar 28, 2026
fe26f77
wip
robingenz Mar 28, 2026
50739cd
Merge remote-tracking branch 'origin/main' into feat/age-signals-decl…
robingenz Apr 24, 2026
bf07f47
feat(age-signals): add remaining `AgeRangeDeclaration` values
robingenz Apr 24, 2026
99bdaf2
feat(age-signals): collapse `AgeRangeDeclaration` to `CONFIRMED`
robingenz Apr 29, 2026
1a0f170
wip
robingenz May 12, 2026
1d5cbd4
Resolve comments
robingenz May 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/neat-bugs-move.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
'@capawesome/capacitor-age-signals': minor
---

feat!: add `DECLARED` status, `ageRangeDeclaration`, and `SDK_VERSION_OUTDATED` error
Comment thread
robingenz marked this conversation as resolved.
7 changes: 7 additions & 0 deletions packages/age-signals/BREAKING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,15 @@ This is a comprehensive list of the breaking changes introduced in the major ver

## Versions

- [Version 0.4.x](#version-04x)
- [Version 0.3.x](#version-03x)

## Version 0.4.x

### Variables

- On Android, the `androidPlayAgeSignalsVersion` variable has been updated to `0.0.3`.

## Version 0.3.x

### Capacitor 8
Expand Down
32 changes: 22 additions & 10 deletions packages/age-signals/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ npx cap sync

If needed, you can define the following project variable in your app's `variables.gradle` file to change the default version of the dependency:

- `$androidPlayAgeSignalsVersion` version of `com.google.android.play:age-signals` (default: `0.0.2`)
- `$androidPlayAgeSignalsVersion` version of `com.google.android.play:age-signals` (default: `0.0.3`)

This can be useful if you encounter dependency conflicts with other plugins in your project.

Expand Down Expand Up @@ -316,13 +316,14 @@ Only available on Android.

#### CheckAgeSignalsResult

| Prop | Type | Description | Since |
| ---------------------------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
| **`userStatus`** | <code><a href="#userstatus">UserStatus</a></code> | The user's verification status. | 0.0.1 |
| **`ageLower`** | <code>number</code> | The (inclusive) lower bound of a supervised user's age range. Only available when `userStatus` is `SUPERVISED`, `SUPERVISED_APPROVAL_PENDING`, or `SUPERVISED_APPROVAL_DENIED`. | 0.0.1 |
| **`ageUpper`** | <code>number</code> | The (inclusive) upper bound of a supervised user's age range. Only available when `userStatus` is `SUPERVISED`, `SUPERVISED_APPROVAL_PENDING`, or `SUPERVISED_APPROVAL_DENIED` and the user's age is under 18. | 0.0.1 |
| **`mostRecentApprovalDate`** | <code>string</code> | The effective from date of the most recent significant change that was approved. When an app is installed, the date of the most recent significant change prior to install is used. Only available when `userStatus` is `SUPERVISED_APPROVAL_PENDING` or `SUPERVISED_APPROVAL_DENIED`. Only available on Android. | 0.0.1 |
| **`installId`** | <code>string</code> | An ID assigned to supervised user installs by Google Play, used for the purposes of notifying you of revoked app approval. Only available when `userStatus` is `SUPERVISED`, `SUPERVISED_APPROVAL_PENDING`, or `SUPERVISED_APPROVAL_DENIED`. Only available on Android. | 0.0.1 |
| Prop | Type | Description | Since |
| ---------------------------- | ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
| **`userStatus`** | <code><a href="#userstatus">UserStatus</a></code> | The user's verification status. | 0.0.1 |
| **`ageLower`** | <code>number</code> | The (inclusive) lower bound of a supervised user's age range. Only available when `userStatus` is `SUPERVISED`, `SUPERVISED_APPROVAL_PENDING`, or `SUPERVISED_APPROVAL_DENIED`. | 0.0.1 |
| **`ageUpper`** | <code>number</code> | The (inclusive) upper bound of a supervised user's age range. Only available when `userStatus` is `SUPERVISED`, `SUPERVISED_APPROVAL_PENDING`, or `SUPERVISED_APPROVAL_DENIED` and the user's age is under 18. | 0.0.1 |
| **`mostRecentApprovalDate`** | <code>string</code> | The effective from date of the most recent significant change that was approved. When an app is installed, the date of the most recent significant change prior to install is used. Only available when `userStatus` is `SUPERVISED_APPROVAL_PENDING` or `SUPERVISED_APPROVAL_DENIED`. Only available on Android. | 0.0.1 |
| **`installId`** | <code>string</code> | An ID assigned to supervised user installs by Google Play, used for the purposes of notifying you of revoked app approval. Only available when `userStatus` is `SUPERVISED`, `SUPERVISED_APPROVAL_PENDING`, or `SUPERVISED_APPROVAL_DENIED`. Only available on Android. | 0.0.1 |
| **`ageRangeDeclaration`** | <code><a href="#agerangedeclaration">AgeRangeDeclaration</a></code> | The age range declaration type. Only available on iOS (26.2+). | 0.4.0 |


#### CheckAgeSignalsOptions
Expand Down Expand Up @@ -375,8 +376,18 @@ Only available on Android.
| **`Supervised`** | <code>'SUPERVISED'</code> | The user has a supervised Google Account managed by a parent who sets their age. Use `ageLower` and `ageUpper` to determine the user's age range. | 0.0.1 |
| **`SupervisedApprovalPending`** | <code>'SUPERVISED_APPROVAL_PENDING'</code> | The user has a supervised Google Account, and their supervising parent has not yet approved one or more pending significant changes. Use `ageLower` and `ageUpper` to determine the user's age range. Use `mostRecentApprovalDate` to determine the last significant change that was approved. | 0.0.1 |
| **`SupervisedApprovalDenied`** | <code>'SUPERVISED_APPROVAL_DENIED'</code> | The user has a supervised Google Account, and their supervising parent denied approval for one or more significant changes. Use `ageLower` and `ageUpper` to determine the user's age range. Use `mostRecentApprovalDate` to determine the last significant change that was approved. | 0.0.1 |
| **`Unknown`** | <code>'UNKNOWN'</code> | The user is not verified or supervised in applicable jurisdictions and regions. These users could be over or under 18. To obtain an age signal from Google Play, ask the user to visit the Play Store to resolve their status. | 0.0.1 |
| **`Empty`** | <code>'EMPTY'</code> | All other users return this value. | 0.0.1 |
| **`Unknown`** | <code>'UNKNOWN'</code> | The user's age is unknown and the user is in an applicable jurisdiction or region. To obtain an age signal from Google Play, ask the user to visit the Play Store to resolve their status. | 0.0.1 |
| **`Declared`** | <code>'DECLARED'</code> | The user has self-declared or guardian-declared their age. Only available on Android. | 0.4.0 |
| **`Empty`** | <code>'EMPTY'</code> | The user is either not in an applicable jurisdiction or region, or the user does not share their age with apps. | 0.0.1 |


#### AgeRangeDeclaration

| Members | Value | Description | Since |
| ---------------------- | -------------------------------- | -------------------------------------------------------------------------------------- | ----- |
| **`SelfDeclared`** | <code>'SELF_DECLARED'</code> | The age range was self-declared by the user without external verification. | 0.4.0 |
| **`GuardianDeclared`** | <code>'GUARDIAN_DECLARED'</code> | The age range was declared by a guardian without external verification. | 0.4.0 |
| **`Confirmed`** | <code>'CONFIRMED'</code> | The age range was set using a scrutinized method, like a credit card or government ID. | 0.4.0 |


#### ErrorCode
Expand All @@ -393,6 +404,7 @@ Only available on Android.
| **`ClientTransientError`** | <code>'CLIENT_TRANSIENT_ERROR'</code> | There was a transient error in the client device. | 0.0.1 |
| **`AppNotOwned`** | <code>'APP_NOT_OWNED'</code> | The app was not installed by Google Play. | 0.0.1 |
| **`InternalError`** | <code>'INTERNAL_ERROR'</code> | Unknown internal error. | 0.0.1 |
| **`SdkVersionOutdated`** | <code>'SDK_VERSION_OUTDATED'</code> | The Age Signals SDK version is outdated. Only available on Android. | 0.4.0 |

</docgen-api>

Expand Down
2 changes: 1 addition & 1 deletion packages/age-signals/android/build.gradle
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ ext {
androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.1'
androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.3.0'
androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
androidPlayAgeSignalsVersion = project.hasProperty('androidPlayAgeSignalsVersion') ? rootProject.ext.androidPlayAgeSignalsVersion : '0.0.2'
androidPlayAgeSignalsVersion = project.hasProperty('androidPlayAgeSignalsVersion') ? rootProject.ext.androidPlayAgeSignalsVersion : '0.0.3'
}

buildscript {
Expand Down
2 changes: 2 additions & 0 deletions ...ignals/android/src/main/java/io/capawesome/capacitorjs/plugins/agesignals/AgeSignals.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -125,6 +125,8 @@ private Exception mapErrorCodeToException(@NonNull Exception exception) {
return CustomExceptions.APP_NOT_OWNED;
case 25009:
return CustomExceptions.INTERNAL_ERROR;
case 25010:
return CustomExceptions.SDK_VERSION_OUTDATED;
default:
return exception;
}
Expand Down
4 changes: 4 additions & 0 deletions .../src/main/java/io/capawesome/capacitorjs/plugins/agesignals/classes/CustomExceptions.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,10 @@ public class CustomExceptions {
);
public static final CustomException APP_NOT_OWNED = new CustomException("APP_NOT_OWNED", "The app was not installed by Google Play.");
public static final CustomException INTERNAL_ERROR = new CustomException("INTERNAL_ERROR", "Unknown internal error.");
public static final CustomException SDK_VERSION_OUTDATED = new CustomException(
"SDK_VERSION_OUTDATED",
"The Age Signals SDK version is outdated."
);
public static final CustomException USER_STATUS_MISSING = new CustomException(null, "userStatus must be provided.");
public static final CustomException FAKE_MANAGER_NOT_ENABLED = new CustomException(null, "Fake manager is not enabled.");
}
2 changes: 2 additions & 0 deletions ...ome/capacitorjs/plugins/agesignals/classes/options/SetNextAgeSignalsExceptionOptions.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,8 @@ private int mapErrorCodeToAgeSignalsErrorCode(@NonNull String errorCode) throws
return AgeSignalsErrorCode.APP_NOT_OWNED;
case "INTERNAL_ERROR":
return AgeSignalsErrorCode.INTERNAL_ERROR;
case "SDK_VERSION_OUTDATED":
return AgeSignalsErrorCode.SDK_VERSION_OUTDATED;
default:
throw new Exception("Invalid errorCode: " + errorCode);
}
Expand Down
7 changes: 5 additions & 2 deletions ...wesome/capacitorjs/plugins/agesignals/classes/options/SetNextAgeSignalsResultOptions.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,7 @@ private static UserStatus getUserStatusFromCall(@NonNull PluginCall call) throws
}
}

@NonNull
@Nullable
private Integer mapUserStatusToVerificationStatus(@NonNull UserStatus userStatus) {
switch (userStatus) {
case VERIFIED:
Expand All @@ -88,8 +88,11 @@ private Integer mapUserStatusToVerificationStatus(@NonNull UserStatus userStatus
return AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED;
case UNKNOWN:
return AgeSignalsVerificationStatus.UNKNOWN;
case DECLARED:
return AgeSignalsVerificationStatus.DECLARED;
case EMPTY:
default:
return AgeSignalsVerificationStatus.UNKNOWN;
return null;
}
Comment thread
robingenz marked this conversation as resolved.
}

Expand Down
22 changes: 16 additions & 6 deletions ...a/io/capawesome/capacitorjs/plugins/agesignals/classes/results/CheckAgeSignalsResult.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
import androidx.annotation.Nullable;
import com.getcapacitor.JSObject;
import com.google.android.play.agesignals.AgeSignalsResult;
import com.google.android.play.agesignals.model.AgeSignalsVerificationStatus;
import io.capawesome.capacitorjs.plugins.agesignals.enums.UserStatus;
import io.capawesome.capacitorjs.plugins.agesignals.interfaces.Result;

Expand Down Expand Up @@ -59,12 +60,21 @@ private UserStatus mapUserStatus(@Nullable Integer status) {
return UserStatus.EMPTY;
}

UserStatus[] values = UserStatus.values();

if (status < 0 || status >= values.length) {
throw new IllegalArgumentException("Invalid UserStatus: " + status);
switch (status) {
case AgeSignalsVerificationStatus.VERIFIED:
return UserStatus.VERIFIED;
case AgeSignalsVerificationStatus.SUPERVISED:
return UserStatus.SUPERVISED;
Comment thread
robingenz marked this conversation as resolved.
case AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING:
return UserStatus.SUPERVISED_APPROVAL_PENDING;
case AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED:
return UserStatus.SUPERVISED_APPROVAL_DENIED;
case AgeSignalsVerificationStatus.UNKNOWN:
return UserStatus.UNKNOWN;
case AgeSignalsVerificationStatus.DECLARED:
return UserStatus.DECLARED;
default:
throw new IllegalArgumentException("Invalid UserStatus: " + status);
Comment thread
robingenz marked this conversation as resolved.
}

return values[status];
}
}
1 change: 1 addition & 0 deletions .../android/src/main/java/io/capawesome/capacitorjs/plugins/agesignals/enums/UserStatus.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,6 @@ public enum UserStatus {
SUPERVISED_APPROVAL_PENDING,
SUPERVISED_APPROVAL_DENIED,
UNKNOWN,
DECLARED,
EMPTY
}
4 changes: 4 additions & 0 deletions packages/age-signals/ios/Plugin.xcodeproj/project.pbxproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@
7C2FC3452ED3795D000FC952 /* Result.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7C2FC3442ED3795A000FC952 /* Result.swift */; };
7C2FC3472ED3799B000FC952 /* UserStatus.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7C2FC3462ED37997000FC952 /* UserStatus.swift */; };
7C2FC34C2ED37E89000FC952 /* CheckAgeSignalsOptions.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7C2FC34B2ED37E83000FC952 /* CheckAgeSignalsOptions.swift */; };
7C2FC3502ED4A000000FC952 /* AgeRangeDeclaration.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7C2FC34F2ED4A000000FC952 /* AgeRangeDeclaration.swift */; };
/* End PBXBuildFile section */

/* Begin PBXContainerItemProxy section */
Expand Down Expand Up @@ -49,6 +50,7 @@
7C2FC3442ED3795A000FC952 /* Result.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Result.swift; sourceTree = "<group>"; };
7C2FC3462ED37997000FC952 /* UserStatus.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = UserStatus.swift; sourceTree = "<group>"; };
7C2FC34B2ED37E83000FC952 /* CheckAgeSignalsOptions.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CheckAgeSignalsOptions.swift; sourceTree = "<group>"; };
7C2FC34F2ED4A000000FC952 /* AgeRangeDeclaration.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AgeRangeDeclaration.swift; sourceTree = "<group>"; };
91781294A431A2A7CC6EB714 /* Pods-Plugin.release.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; name = "Pods-Plugin.release.xcconfig"; path = "Pods/Target Support Files/Pods-Plugin/Pods-Plugin.release.xcconfig"; sourceTree = "<group>"; };
96ED1B6440D6672E406C8D19 /* Pods-PluginTests.debug.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; name = "Pods-PluginTests.debug.xcconfig"; path = "Pods/Target Support Files/Pods-PluginTests/Pods-PluginTests.debug.xcconfig"; sourceTree = "<group>"; };
F65BB2953ECE002E1EF3E424 /* Pods-PluginTests.release.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; name = "Pods-PluginTests.release.xcconfig"; path = "Pods/Target Support Files/Pods-PluginTests/Pods-PluginTests.release.xcconfig"; sourceTree = "<group>"; };
Expand Down Expand Up @@ -122,6 +124,7 @@
7C2FC33C2ED36FC5000FC952 /* Enums */ = {
isa = PBXGroup;
children = (
7C2FC34F2ED4A000000FC952 /* AgeRangeDeclaration.swift */,
7C2FC3462ED37997000FC952 /* UserStatus.swift */,
7C2FC33D2ED36FCB000FC952 /* CustomError.swift */,
);
Expand Down Expand Up @@ -365,6 +368,7 @@
7C2FC3472ED3799B000FC952 /* UserStatus.swift in Sources */,
7C2FC34C2ED37E89000FC952 /* CheckAgeSignalsOptions.swift in Sources */,
7C2FC33E2ED36FCF000FC952 /* CustomError.swift in Sources */,
7C2FC3502ED4A000000FC952 /* AgeRangeDeclaration.swift in Sources */,
);
runOnlyForDeploymentPostprocessing = 0;
};
Expand Down
Loading
Loading