Filza 27.2 worse_query: public and developer builds

WQFilzaIntegration.h

@@ -0,0 +1,54 @@
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// Boots the worse_query integration. Grants every path family the primitive
+/// supports, publishes a symlinked control folder inside Filza's virtual root,
+/// registers Favorites entries, and prewarms app-container discovery.
+FOUNDATION_EXPORT void WQFilzaStart(void);
+
+/// YES once at least one worse_query sandbox extension was consumed.
+FOUNDATION_EXPORT BOOL WQIsActive(void);
+
+/// Canonical /private/var paths that currently have a live extension.
+FOUNDATION_EXPORT NSArray<NSString *> *WQAccessibleRoots(void);
+
+/// "…/Documents/Device Storage/worse_query", the browsing hub for the granted
+/// roots. Kept stable so Favorites entries can point at it.
+FOUNDATION_EXPORT NSString *WQVirtualRootFolder(void);
+
+/// App records built from accessible data containers and their
+/// .com.apple.mobile_container_manager.metadata.plist files.
+/// Keys: bundleID, dataPath, name, version, bundlePath (optional),
+/// iconPath (optional).
+FOUNDATION_EXPORT NSArray<NSDictionary *> *WQInstalledApplications(void);
+
+FOUNDATION_EXPORT NSString *_Nullable WQBundlePathForIdentifier(NSString *bundleID);
+FOUNDATION_EXPORT NSString *_Nullable WQDataPathForIdentifier(NSString *bundleID);
+FOUNDATION_EXPORT NSString *_Nullable WQBestAppGroup(void);
+
+/// Minimal stand-in for LSApplicationProxy used when LaunchServices hides an
+/// app but its data container is still discoverable.
+@interface WQApplicationProxy : NSObject
+@property (nonatomic, copy) NSString *applicationIdentifier;
+@property (nonatomic, copy) NSString *bundleIdentifier;
+@property (nonatomic, copy) NSString *localizedName;
+@property (nonatomic, copy) NSString *bundleVersion;
+@property (nonatomic, copy) NSString *shortVersionString;
+@property (nonatomic, copy) NSString *applicationType;
+@property (nonatomic, copy) NSString *vendorName;
+@property (nonatomic, strong, nullable) NSURL *bundleURL;
+@property (nonatomic, strong, nullable) NSURL *dataContainerURL;
+- (instancetype)initWithAppInfo:(NSDictionary *)info;
+@end
+
+NS_ASSUME_NONNULL_END
+
+/// Extra commands used by the sbx_* terminal helpers.
+FOUNDATION_EXPORT BOOL WQGrantExtraPath(NSString * _Nonnull path, BOOL createIfMissing);
+FOUNDATION_EXPORT void WQReleaseGrantHandle(NSNumber * _Nonnull handle);
+FOUNDATION_EXPORT void WQReleaseAllGrants(void);
+FOUNDATION_EXPORT void WQRefreshDiscovery(void);
+FOUNDATION_EXPORT NSArray<NSString *> * _Nonnull WQChildrenForRoot(NSString * _Nonnull root);
+FOUNDATION_EXPORT NSString *_Nullable WQIdentifyContainerPath(NSString * _Nonnull path);
+FOUNDATION_EXPORT NSArray<NSNumber *> * _Nonnull WQActiveGrantHandles(void);