Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
34 commits
Select commit Hold shift + click to select a range
65a3411
notes on investigation
lawrence-forooghian Mar 20, 2026
3ebfeba
Further notes
lawrence-forooghian Mar 20, 2026
21d5a99
Add thoughts on storage availability
lawrence-forooghian Apr 13, 2026
6ff2720
Further thoughts from conversation with Claude
lawrence-forooghian Apr 13, 2026
005f507
Update investigation doc with direction A vs B analysis
lawrence-forooghian Apr 15, 2026
9a93330
Update investigation doc: RSH3a2a analysis and direction C
lawrence-forooghian Apr 15, 2026
28478e9
Add push state machine persistence archaeology document
lawrence-forooghian Apr 15, 2026
cb62505
Update investigation doc: storage inventory, directions, RSH3a2a
lawrence-forooghian Apr 15, 2026
6c44adf
Document spec assumptions about storage
lawrence-forooghian Apr 15, 2026
742f0f2
Document what should be stored atomically
lawrence-forooghian Apr 15, 2026
e4ba011
Add testing plan for migration and recovery
lawrence-forooghian Apr 15, 2026
e144f43
Add empty app for reproducing LocalDevice storage bug
lawrence-forooghian Apr 15, 2026
153140e
Add Ably to example app
lawrence-forooghian Apr 15, 2026
ec4f542
Set up event logging in example app
lawrence-forooghian Apr 15, 2026
c5d7a8f
Add VoIP push registration and send script
lawrence-forooghian Apr 16, 2026
f0ea9b3
Extract Event type for structured event logging
lawrence-forooghian Apr 16, 2026
ed219b2
Rename log event case to ablyLog
lawrence-forooghian Apr 16, 2026
04a189b
Update README with VoIP push details and send script usage
lawrence-forooghian Apr 16, 2026
c68ca6c
Add push activation and channel subscription UI
lawrence-forooghian Apr 16, 2026
fa719b1
Add settings for automatic push activation on launch
lawrence-forooghian Apr 16, 2026
7a6ee45
Document channel persistence and increase history limit
lawrence-forooghian Apr 16, 2026
43c797b
Document push-test channel rule setup
lawrence-forooghian Apr 16, 2026
5c6b595
Add appInstallationID to event payloads
lawrence-forooghian Apr 16, 2026
4a7548a
Add appLaunched event and protected data tracking
lawrence-forooghian Apr 16, 2026
4022904
Include local device snapshot in push activate result
lawrence-forooghian Apr 16, 2026
ea9f3d3
Set clientId to appInstallation ID on both Ably clients
lawrence-forooghian Apr 16, 2026
41efc2d
Log installation and launch IDs in send-voip-push script
lawrence-forooghian Apr 16, 2026
f000761
Document known iPad reproduction issue
lawrence-forooghian Apr 16, 2026
a9bc6a6
Log UserDefaults file protection level at launch
lawrence-forooghian Apr 16, 2026
bb929be
Dump UserDefaults contents at launch and after activation
lawrence-forooghian Apr 16, 2026
1071a0d
Import Ably.Private in demo app
lawrence-forooghian Apr 17, 2026
66ea891
Opt the demo app into new test options
lawrence-forooghian Apr 17, 2026
87d6027
Describe how before-first-unlock VoIP behaves a bit weirdly
lawrence-forooghian Apr 17, 2026
d25a26a
Mark testing plans as outdated in investigation doc
lawrence-forooghian Apr 17, 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

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

1 change: 1 addition & 0 deletions Examples/LocalDeviceStorageBugTest/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
/LocalDeviceStorageBugTest/Secrets.swift
Original file line number Diff line number Diff line change
@@ -0,0 +1,379 @@
// !$*UTF8*$!
{
archiveVersion = 1;
classes = {
};
objectVersion = 77;
objects = {

/* Begin PBXBuildFile section */
2157A51E2F90250E00C526F5 /* Ably in Frameworks */ = {isa = PBXBuildFile; productRef = 2157A51D2F90250E00C526F5 /* Ably */; };
/* End PBXBuildFile section */

/* Begin PBXFileReference section */
2157A50E2F90238800C526F5 /* LocalDeviceStorageBugTest.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = LocalDeviceStorageBugTest.app; sourceTree = BUILT_PRODUCTS_DIR; };
/* End PBXFileReference section */

/* Begin PBXFileSystemSynchronizedBuildFileExceptionSet section */
21B9EEBB2F902D060021591A /* Exceptions for "LocalDeviceStorageBugTest" folder in "LocalDeviceStorageBugTest" target */ = {
isa = PBXFileSystemSynchronizedBuildFileExceptionSet;
membershipExceptions = (
Info.plist,
);
target = 2157A50D2F90238800C526F5 /* LocalDeviceStorageBugTest */;
};
/* End PBXFileSystemSynchronizedBuildFileExceptionSet section */

/* Begin PBXFileSystemSynchronizedRootGroup section */
2157A5102F90238800C526F5 /* LocalDeviceStorageBugTest */ = {
isa = PBXFileSystemSynchronizedRootGroup;
exceptions = (
21B9EEBB2F902D060021591A /* Exceptions for "LocalDeviceStorageBugTest" folder in "LocalDeviceStorageBugTest" target */,
);
path = LocalDeviceStorageBugTest;
sourceTree = "<group>";
};
/* End PBXFileSystemSynchronizedRootGroup section */

/* Begin PBXFrameworksBuildPhase section */
2157A50B2F90238800C526F5 /* Frameworks */ = {
isa = PBXFrameworksBuildPhase;
buildActionMask = 2147483647;
files = (
2157A51E2F90250E00C526F5 /* Ably in Frameworks */,
);
runOnlyForDeploymentPostprocessing = 0;
};
/* End PBXFrameworksBuildPhase section */

/* Begin PBXGroup section */
2157A5052F90238800C526F5 = {
isa = PBXGroup;
children = (
2157A5102F90238800C526F5 /* LocalDeviceStorageBugTest */,
2157A50F2F90238800C526F5 /* Products */,
);
sourceTree = "<group>";
};
2157A50F2F90238800C526F5 /* Products */ = {
isa = PBXGroup;
children = (
2157A50E2F90238800C526F5 /* LocalDeviceStorageBugTest.app */,
);
name = Products;
sourceTree = "<group>";
};
/* End PBXGroup section */

/* Begin PBXNativeTarget section */
2157A50D2F90238800C526F5 /* LocalDeviceStorageBugTest */ = {
isa = PBXNativeTarget;
buildConfigurationList = 2157A5192F90238900C526F5 /* Build configuration list for PBXNativeTarget "LocalDeviceStorageBugTest" */;
buildPhases = (
2157A50A2F90238800C526F5 /* Sources */,
2157A50B2F90238800C526F5 /* Frameworks */,
2157A50C2F90238800C526F5 /* Resources */,
);
buildRules = (
);
dependencies = (
);
fileSystemSynchronizedGroups = (
2157A5102F90238800C526F5 /* LocalDeviceStorageBugTest */,
);
name = LocalDeviceStorageBugTest;
packageProductDependencies = (
2157A51D2F90250E00C526F5 /* Ably */,
);
productName = LocalDeviceStorageBugTest;
productReference = 2157A50E2F90238800C526F5 /* LocalDeviceStorageBugTest.app */;
productType = "com.apple.product-type.application";
};
/* End PBXNativeTarget section */

/* Begin PBXProject section */
2157A5062F90238800C526F5 /* Project object */ = {
isa = PBXProject;
attributes = {
BuildIndependentTargetsInParallel = 1;
LastSwiftUpdateCheck = 2630;
LastUpgradeCheck = 2630;
TargetAttributes = {
2157A50D2F90238800C526F5 = {
CreatedOnToolsVersion = 26.3;
};
};
};
buildConfigurationList = 2157A5092F90238800C526F5 /* Build configuration list for PBXProject "LocalDeviceStorageBugTest" */;
developmentRegion = en;
hasScannedForEncodings = 0;
knownRegions = (
en,
Base,
);
mainGroup = 2157A5052F90238800C526F5;
minimizedProjectReferenceProxies = 1;
packageReferences = (
2157A51C2F90250E00C526F5 /* XCLocalSwiftPackageReference "../../../ably-cocoa" */,
);
preferredProjectObjectVersion = 77;
productRefGroup = 2157A50F2F90238800C526F5 /* Products */;
projectDirPath = "";
projectRoot = "";
targets = (
2157A50D2F90238800C526F5 /* LocalDeviceStorageBugTest */,
);
};
/* End PBXProject section */

/* Begin PBXResourcesBuildPhase section */
2157A50C2F90238800C526F5 /* Resources */ = {
isa = PBXResourcesBuildPhase;
buildActionMask = 2147483647;
files = (
);
runOnlyForDeploymentPostprocessing = 0;
};
/* End PBXResourcesBuildPhase section */

/* Begin PBXSourcesBuildPhase section */
2157A50A2F90238800C526F5 /* Sources */ = {
isa = PBXSourcesBuildPhase;
buildActionMask = 2147483647;
files = (
);
runOnlyForDeploymentPostprocessing = 0;
};
/* End PBXSourcesBuildPhase section */

/* Begin XCBuildConfiguration section */
2157A5172F90238900C526F5 /* Debug */ = {
isa = XCBuildConfiguration;
buildSettings = {
ALWAYS_SEARCH_USER_PATHS = NO;
ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
CLANG_ANALYZER_NONNULL = YES;
CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
CLANG_CXX_LANGUAGE_STANDARD = "gnu++20";
CLANG_ENABLE_MODULES = YES;
CLANG_ENABLE_OBJC_ARC = YES;
CLANG_ENABLE_OBJC_WEAK = YES;
CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
CLANG_WARN_BOOL_CONVERSION = YES;
CLANG_WARN_COMMA = YES;
CLANG_WARN_CONSTANT_CONVERSION = YES;
CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
CLANG_WARN_EMPTY_BODY = YES;
CLANG_WARN_ENUM_CONVERSION = YES;
CLANG_WARN_INFINITE_RECURSION = YES;
CLANG_WARN_INT_CONVERSION = YES;
CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES;
CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
CLANG_WARN_STRICT_PROTOTYPES = YES;
CLANG_WARN_SUSPICIOUS_MOVE = YES;
CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
CLANG_WARN_UNREACHABLE_CODE = YES;
CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
COPY_PHASE_STRIP = NO;
DEBUG_INFORMATION_FORMAT = dwarf;
DEVELOPMENT_TEAM = XXY98AVDR6;
ENABLE_STRICT_OBJC_MSGSEND = YES;
ENABLE_TESTABILITY = YES;
ENABLE_USER_SCRIPT_SANDBOXING = YES;
GCC_C_LANGUAGE_STANDARD = gnu17;
GCC_DYNAMIC_NO_PIC = NO;
GCC_NO_COMMON_BLOCKS = YES;
GCC_OPTIMIZATION_LEVEL = 0;
GCC_PREPROCESSOR_DEFINITIONS = (
"DEBUG=1",
"$(inherited)",
);
GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
GCC_WARN_UNDECLARED_SELECTOR = YES;
GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
GCC_WARN_UNUSED_FUNCTION = YES;
GCC_WARN_UNUSED_VARIABLE = YES;
IPHONEOS_DEPLOYMENT_TARGET = 26.2;
LOCALIZATION_PREFERS_STRING_CATALOGS = YES;
MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
MTL_FAST_MATH = YES;
ONLY_ACTIVE_ARCH = YES;
SDKROOT = iphoneos;
SWIFT_ACTIVE_COMPILATION_CONDITIONS = "DEBUG $(inherited)";
SWIFT_OPTIMIZATION_LEVEL = "-Onone";
};
name = Debug;
};
2157A5182F90238900C526F5 /* Release */ = {
isa = XCBuildConfiguration;
buildSettings = {
ALWAYS_SEARCH_USER_PATHS = NO;
ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
CLANG_ANALYZER_NONNULL = YES;
CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
CLANG_CXX_LANGUAGE_STANDARD = "gnu++20";
CLANG_ENABLE_MODULES = YES;
CLANG_ENABLE_OBJC_ARC = YES;
CLANG_ENABLE_OBJC_WEAK = YES;
CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
CLANG_WARN_BOOL_CONVERSION = YES;
CLANG_WARN_COMMA = YES;
CLANG_WARN_CONSTANT_CONVERSION = YES;
CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
CLANG_WARN_EMPTY_BODY = YES;
CLANG_WARN_ENUM_CONVERSION = YES;
CLANG_WARN_INFINITE_RECURSION = YES;
CLANG_WARN_INT_CONVERSION = YES;
CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES;
CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
CLANG_WARN_STRICT_PROTOTYPES = YES;
CLANG_WARN_SUSPICIOUS_MOVE = YES;
CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
CLANG_WARN_UNREACHABLE_CODE = YES;
CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
COPY_PHASE_STRIP = NO;
DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
DEVELOPMENT_TEAM = XXY98AVDR6;
ENABLE_NS_ASSERTIONS = NO;
ENABLE_STRICT_OBJC_MSGSEND = YES;
ENABLE_USER_SCRIPT_SANDBOXING = YES;
GCC_C_LANGUAGE_STANDARD = gnu17;
GCC_NO_COMMON_BLOCKS = YES;
GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
GCC_WARN_UNDECLARED_SELECTOR = YES;
GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
GCC_WARN_UNUSED_FUNCTION = YES;
GCC_WARN_UNUSED_VARIABLE = YES;
IPHONEOS_DEPLOYMENT_TARGET = 26.2;
LOCALIZATION_PREFERS_STRING_CATALOGS = YES;
MTL_ENABLE_DEBUG_INFO = NO;
MTL_FAST_MATH = YES;
SDKROOT = iphoneos;
SWIFT_COMPILATION_MODE = wholemodule;
VALIDATE_PRODUCT = YES;
};
name = Release;
};
2157A51A2F90238900C526F5 /* Debug */ = {
isa = XCBuildConfiguration;
buildSettings = {
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
CODE_SIGN_ENTITLEMENTS = LocalDeviceStorageBugTest/LocalDeviceStorageBugTest.entitlements;
CODE_SIGN_STYLE = Automatic;
CURRENT_PROJECT_VERSION = 1;
DEVELOPMENT_TEAM = XXY98AVDR6;
ENABLE_PREVIEWS = YES;
GENERATE_INFOPLIST_FILE = YES;
INFOPLIST_FILE = LocalDeviceStorageBugTest/Info.plist;
INFOPLIST_KEY_NSVoIPUsageDescription = "This app uses VoIP to deterministically test what happens when the app is launched before first unlock.";
INFOPLIST_KEY_UIApplicationSceneManifest_Generation = YES;
INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES;
INFOPLIST_KEY_UILaunchScreen_Generation = YES;
INFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = "UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
INFOPLIST_KEY_UISupportedInterfaceOrientations_iPhone = "UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
LD_RUNPATH_SEARCH_PATHS = (
"$(inherited)",
"@executable_path/Frameworks",
);
MARKETING_VERSION = 1.0;
PRODUCT_BUNDLE_IDENTIFIER = com.ably.LocalDeviceStorageBugTest;
PRODUCT_NAME = "$(TARGET_NAME)";
STRING_CATALOG_GENERATE_SYMBOLS = YES;
SWIFT_APPROACHABLE_CONCURRENCY = YES;
SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor;
SWIFT_EMIT_LOC_STRINGS = YES;
SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
SWIFT_VERSION = 5.0;
TARGETED_DEVICE_FAMILY = "1,2";
};
name = Debug;
};
2157A51B2F90238900C526F5 /* Release */ = {
isa = XCBuildConfiguration;
buildSettings = {
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
CODE_SIGN_ENTITLEMENTS = LocalDeviceStorageBugTest/LocalDeviceStorageBugTest.entitlements;
CODE_SIGN_STYLE = Automatic;
CURRENT_PROJECT_VERSION = 1;
DEVELOPMENT_TEAM = XXY98AVDR6;
ENABLE_PREVIEWS = YES;
GENERATE_INFOPLIST_FILE = YES;
INFOPLIST_FILE = LocalDeviceStorageBugTest/Info.plist;
INFOPLIST_KEY_NSVoIPUsageDescription = "This app uses VoIP to deterministically test what happens when the app is launched before first unlock.";
INFOPLIST_KEY_UIApplicationSceneManifest_Generation = YES;
INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES;
INFOPLIST_KEY_UILaunchScreen_Generation = YES;
INFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = "UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
INFOPLIST_KEY_UISupportedInterfaceOrientations_iPhone = "UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
LD_RUNPATH_SEARCH_PATHS = (
"$(inherited)",
"@executable_path/Frameworks",
);
MARKETING_VERSION = 1.0;
PRODUCT_BUNDLE_IDENTIFIER = com.ably.LocalDeviceStorageBugTest;
PRODUCT_NAME = "$(TARGET_NAME)";
STRING_CATALOG_GENERATE_SYMBOLS = YES;
SWIFT_APPROACHABLE_CONCURRENCY = YES;
SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor;
SWIFT_EMIT_LOC_STRINGS = YES;
SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
SWIFT_VERSION = 5.0;
TARGETED_DEVICE_FAMILY = "1,2";
};
name = Release;
};
/* End XCBuildConfiguration section */

/* Begin XCConfigurationList section */
2157A5092F90238800C526F5 /* Build configuration list for PBXProject "LocalDeviceStorageBugTest" */ = {
isa = XCConfigurationList;
buildConfigurations = (
2157A5172F90238900C526F5 /* Debug */,
2157A5182F90238900C526F5 /* Release */,
);
defaultConfigurationIsVisible = 0;
defaultConfigurationName = Release;
};
2157A5192F90238900C526F5 /* Build configuration list for PBXNativeTarget "LocalDeviceStorageBugTest" */ = {
isa = XCConfigurationList;
buildConfigurations = (
2157A51A2F90238900C526F5 /* Debug */,
2157A51B2F90238900C526F5 /* Release */,
);
defaultConfigurationIsVisible = 0;
defaultConfigurationName = Release;
};
/* End XCConfigurationList section */

/* Begin XCLocalSwiftPackageReference section */
2157A51C2F90250E00C526F5 /* XCLocalSwiftPackageReference "../../../ably-cocoa" */ = {
isa = XCLocalSwiftPackageReference;
relativePath = "../../../ably-cocoa";
};
/* End XCLocalSwiftPackageReference section */

/* Begin XCSwiftPackageProductDependency section */
2157A51D2F90250E00C526F5 /* Ably */ = {
isa = XCSwiftPackageProductDependency;
productName = Ably;
};
/* End XCSwiftPackageProductDependency section */
};
rootObject = 2157A5062F90238800C526F5 /* Project object */;
}

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading
Loading