>izddlmZddlmZmZddlmZddlmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)erZddl*m+Z+ddlm,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;mZ>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGmHZHmIZImJZJmKZKmLZLmMZMmNZNmOZOmPZPddlQmRZRGdd ZSy ) ) annotations) TYPE_CHECKINGOptional)Command)"ClearCookiesParamsClearDataForOriginParamsClearDataForStorageKeyParamsClearSharedStorageEntriesParamsClearTrustTokensParamsDeleteSharedStorageEntryParamsDeleteStorageBucketParams0GetAffectedUrlsForThirdPartyCookieMetadataParamsGetCookiesParamsGetInterestGroupDetailsParamsGetSharedStorageEntriesParamsGetSharedStorageMetadataParamsGetStorageKeyForFrameParamsGetUsageAndQuotaParamsOverrideQuotaForOriginParamsResetSharedStorageBudgetParams-SetAttributionReportingLocalTestingModeParams%SetAttributionReportingTrackingParamsSetCookiesParams%SetInterestGroupAuctionTrackingParamsSetInterestGroupTrackingParams$SetProtectedAudienceKAnonymityParamsSetSharedStorageEntryParamsSetSharedStorageTrackingParamsSetStorageBucketTrackingParams StorageMethod TrackCacheStorageForOriginParams$TrackCacheStorageForStorageKeyParamsTrackIndexedDBForOriginParams!TrackIndexedDBForStorageKeyParams"UntrackCacheStorageForOriginParams&UntrackCacheStorageForStorageKeyParamsUntrackIndexedDBForOriginParams#UntrackIndexedDBForStorageKeyParams) CookieParam)%ClearCookiesCommandClearDataForOriginCommandClearDataForStorageKeyCommand ClearSharedStorageEntriesCommandClearTrustTokensCommandDeleteSharedStorageEntryCommandDeleteStorageBucketCommand1GetAffectedUrlsForThirdPartyCookieMetadataCommandGetCookiesCommandGetInterestGroupDetailsCommandGetRelatedWebsiteSetsCommandGetSharedStorageEntriesCommandGetSharedStorageMetadataCommandGetStorageKeyForFrameCommandGetTrustTokensCommandGetUsageAndQuotaCommandOverrideQuotaForOriginCommandResetSharedStorageBudgetCommand#RunBounceTrackingMitigationsCommand$SendPendingAttributionReportsCommand.SetAttributionReportingLocalTestingModeCommand&SetAttributionReportingTrackingCommandSetCookiesCommand&SetInterestGroupAuctionTrackingCommandSetInterestGroupTrackingCommand%SetProtectedAudienceKAnonymityCommandSetSharedStorageEntryCommandSetSharedStorageTrackingCommandSetStorageBucketTrackingCommand!TrackCacheStorageForOriginCommand%TrackCacheStorageForStorageKeyCommandTrackIndexedDBForOriginCommand"TrackIndexedDBForStorageKeyCommand#UntrackCacheStorageForOriginCommand'UntrackCacheStorageForStorageKeyCommand UntrackIndexedDBForOriginCommand$UntrackIndexedDBForStorageKeyCommand) StorageBucketc4eZdZdZed(d)dZed*dZe d+dZed(d,dZed-dZ ed.dZ e d( d/d Z e d0d Z ed1d Z e d2d Zed3d Zed4dZed5dZe d6dZed7dZe d8dZed9dZed:dZed;dZeddZed?dZed@dZedAdZedBdZe d( dCdZedDdZ edEdZ!edFd Z"e dGd!Z#edHd"Z$edId#Z%edJd$Z&e d( dKd%Z'edLd&Z(e dMd'Z)y)NStorageCommandsa A class for interacting with browser storage using Chrome DevTools Protocol (CDP). The Storage domain of CDP allows managing various types of browser storage, including: - Cookies - Cache Storage - IndexedDB - Web Storage (localStorage/sessionStorage) - Shared Storage - Storage Buckets - Trust Tokens - Interest Groups - Attribution Reporting This class provides static methods that generate CDP commands to manage these types of storage without the need for traditional webdrivers. NcZt}|||d<ttj|S)aV Generates a command to clear all browser cookies. Args: browser_context_id: Browser context ID (optional). Useful when working with multiple contexts (e.g., multiple windows or tabs). Returns: ClearCookiesCommand: The CDP command to clear all cookies. browserContextIdmethodparams)rrr CLEAR_COOKIESbrowser_context_idrVs f/var/www/python/tenders/Scrapper/venv/lib/python3.12/site-packages/pydoll/commands/storage_commands.py clear_cookieszStorageCommands.clear_cookiesjs0$%  ));F% &m99&IIcRt||}ttj|S)a Generates a command to clear storage data for a specific origin. Args: origin: The security origin (e.g., "https://example.com"). storage_types: Comma-separated list of storage types to clear. Possible values include: "cookies", "local_storage", "indexeddb", "cache_storage", etc. Use "all" to clear all types. Returns: ClearDataForOriginCommand: The CDP command to clear data for the specified origin. )origin storageTypesrT)rrr CLEAR_DATA_FOR_ORIGIN)r^ storage_typesrVs rZclear_data_for_originz%StorageCommands.clear_data_for_origin{s#*mTmAA&QQr\cRt||}ttj|S)a Generates a command to clear data for a specific storage key. Args: storage_key: The storage key for which to clear data. Unlike origin, a storage key is a more specific identifier that may include partition isolation. storage_types: Comma-separated list of storage types to clear. Possible values include: "cookies", "local_storage", "indexeddb", "cache_storage", etc. Use "all" to clear all types. Returns: ClearDataForStorageKeyCommand: The CDP command to clear data for the specified storage key. ) storageKeyr_rT)r rr CLEAR_DATA_FOR_STORAGE_KEY) storage_keyrarVs rZclear_data_for_storage_keyz*StorageCommands.clear_data_for_storage_keys$&.S`amFFvVVr\cZt}|||d<ttj|S)a Generates a command to get all browser cookies. Args: browser_context_id: Browser context ID (optional). Useful when working with multiple contexts (e.g., multiple windows or tabs). Returns: GetCookiesCommand: The CDP command to get all cookies, which will return an array of Cookie objects. rSrT)rrr GET_COOKIESrXs rZ get_cookieszStorageCommands.get_cookiess0"#  ));F% &m77GGr\cPt|}ttj|S)a Generates a command to get the storage key for a specific frame. Storage keys are used to isolate data between different origins or partitions in the browser. Args: frame_id: The ID of the frame for which to get the storage key. Returns: GetStorageKeyForFrameCommand: The CDP command to get the storage key for the specified frame. )frameIdrT)rrr GET_STORAGE_KEY_FOR_FRAME)frame_idrVs rZget_storage_key_for_framez)StorageCommands.get_storage_key_for_frames!-X>mEEfUUr\cPt|}ttj|S)ag Generates a command to get storage usage and quota information for an origin. Useful for monitoring or debugging storage consumption of a site. Args: origin: The security origin (e.g., "https://example.com") for which to get information. Returns: GetUsageAndQuotaCommand: The CDP command that will return: - usage: Storage usage in bytes - quota: Storage quota in bytes - usageBreakdown: Breakdown of usage by storage type - overrideActive: Whether there is an active quota override r^rT)rrr GET_USAGE_AND_QUOTAr^rVs rZget_usage_and_quotaz#StorageCommands.get_usage_and_quotas!"(v6m??OOr\c^t|}|||d<ttj|S)a Generates a command to set browser cookies. Args: cookies: list of Cookie objects to set. browser_context_id: Browser context ID (optional). Useful when working with multiple contexts (e.g., multiple windows or tabs). Returns: SetCookiesCommand: The CDP command to set the specified cookies. )cookiesrSrT)rrr SET_COOKIES)rvrYrVs rZ set_cookieszStorageCommands.set_cookiess2"'2  ));F% &m77GGr\cTt|||}ttj|S)a$ Generates a command to set K-anonymity for protected audience. This command is used to configure anonymity in privacy-preserving advertising systems (part of Google's Privacy Sandbox). Args: owner: Owner of the K-anonymity configuration. name: Name of the K-anonymity configuration. hashes: list of hashes for the configuration. Returns: SetProtectedAudienceKAnonymityCommand: The CDP command to set protected audience K-anonymity. )ownernamehashesrT)rrr "SET_PROTECTED_AUDIENCE_K_ANONYMITY)rzr{r|rVs rZ"set_protected_audience_k_anonymityz2StorageCommands.set_protected_audience_k_anonymitys'&6EU[\mNNW]^^r\cPt|}ttj|S)a Generates a command to register an origin to receive notifications about changes to its Cache Storage. Cache Storage is primarily used by Service Workers to store resources for offline use. Args: origin: The security origin (e.g., "https://example.com") to monitor. Returns: TrackCacheStorageForOriginCommand: The CDP command to register monitoring of the origin's Cache Storage. rqrT)r!rr TRACK_CACHE_STORAGE_FOR_ORIGINrss rZtrack_cache_storage_for_originz.StorageCommands.track_cache_storage_for_origins"2@mJJSYZZr\cPt|}ttj|S)a Generates a command to register a storage key to receive notifications about changes to its Cache Storage. Similar to track_cache_storage_for_origin, but uses the storage key for more precise isolation. Args: storage_key: The storage key to monitor. Returns: TrackCacheStorageForStorageKeyCommand: The CDP command to register monitoring of the key's Cache Storage. rdrT)r"rr #TRACK_CACHE_STORAGE_FOR_STORAGE_KEYrfrVs rZ#track_cache_storage_for_storage_keyz3StorageCommands.track_cache_storage_for_storage_keys"$6MmOOX^__r\cPt|}ttj|S)a Generates a command to register an origin to receive notifications about changes to its IndexedDB. IndexedDB is a NoSQL database system in the browser for storing large amounts of structured data. Args: origin: The security origin (e.g., "https://example.com") to monitor. Returns: TrackIndexedDBForOriginCommand: The CDP command to register monitoring of the origin's IndexedDB. rqrT)r#rr TRACK_INDEXED_DB_FOR_ORIGINrss rZtrack_indexed_db_for_originz+StorageCommands.track_indexed_db_for_origin+s" /f=mGGPVWWr\cPt|}ttj|S)a Generates a command to register a storage key to receive notifications about changes to its IndexedDB. Similar to track_indexed_db_for_origin, but uses the storage key for more precise isolation. Args: storage_key: The storage key to monitor. Returns: TrackIndexedDBForStorageKeyCommand: The CDP command to register monitoring of the key's IndexedDB. rrT)r$rr TRACK_INDEXED_DB_FOR_STORAGE_KEYrs rZ track_indexed_db_for_storage_keyz0StorageCommands.track_indexed_db_for_storage_key>s" 3kJmLLU[\\r\cPt|}ttj|S)a Generates a command to unregister an origin from receiving notifications about changes to its Cache Storage. Use this method to stop monitoring Cache Storage after using track_cache_storage_for_origin. Args: origin: The security origin (e.g., "https://example.com") to stop monitoring. Returns: UntrackCacheStorageForOriginCommand: The CDP command to cancel monitoring of the origin's Cache Storage. rqrT)r%rr UNTRACK_CACHE_STORAGE_FOR_ORIGINrss rZ untrack_cache_storage_for_originz0StorageCommands.untrack_cache_storage_for_originQs"46BmLLU[\\r\cPt|}ttj|S)a Generates a command to unregister a storage key from receiving notifications about changes to its Cache Storage. Use this method to stop monitoring Cache Storage after using track_cache_storage_for_storage_key. Args: storage_key: The storage key to stop monitoring. Returns: UntrackCacheStorageForStorageKeyCommand: The CDP command to cancel monitoring of the key's Cache Storage. rrT)r&rr %UNTRACK_CACHE_STORAGE_FOR_STORAGE_KEYrs rZ%untrack_cache_storage_for_storage_keyz5StorageCommands.untrack_cache_storage_for_storage_keycs"$8;OmQQZ`aar\cPt|}ttj|S)a Generates a command to unregister an origin from receiving notifications about changes to its IndexedDB. Use this method to stop monitoring IndexedDB after using track_indexed_db_for_origin. Args: origin: The security origin (e.g., "https://example.com") to stop monitoring. Returns: UntrackIndexedDBForOriginCommand: The CDP command to cancel monitoring of the origin's IndexedDB. rqrT)r'rr UNTRACK_INDEXED_DB_FOR_ORIGINrss rZuntrack_indexed_db_for_originz-StorageCommands.untrack_indexed_db_for_originxs"1?mIIRXYYr\cPt|}ttj|S)a Generates a command to unregister a storage key from receiving notifications about changes to its IndexedDB. Use this method to stop monitoring IndexedDB after using track_indexed_db_for_storage_key. Args: storage_key: The storage key to stop monitoring. Returns: UntrackIndexedDBForStorageKeyCommand: The CDP command to cancel monitoring of the key's IndexedDB. rrT)r(rr "UNTRACK_INDEXED_DB_FOR_STORAGE_KEYrs rZ"untrack_indexed_db_for_storage_keyz2StorageCommands.untrack_indexed_db_for_storage_keys""5 LmNNW]^^r\cPt|}ttj|S)a Generates a command to clear all Shared Storage entries for a specific origin. Shared Storage is an experimental API that allows cross-origin shared storage with privacy protections. Args: owner_origin: The owner origin of the Shared Storage to clear. Returns: ClearSharedStorageEntriesCommand: The CDP command to clear the Shared Storage entries.  ownerOriginrT)r rr CLEAR_SHARED_STORAGE_ENTRIES owner_originrVs rZclear_shared_storage_entriesz,StorageCommands.clear_shared_storage_entriess"1\JmHHQWXXr\cPt|}ttj|S)aE Generates a command to remove all Trust Tokens issued by the specified origin. Trust Tokens are an experimental API for combating fraud while preserving user privacy. This command keeps other stored data, including the issuer's redemption records, intact. Args: issuer_origin: The issuer origin of the tokens to remove. Returns: ClearTrustTokensCommand: The CDP command to clear Trust Tokens, which will return: - didDeleteTokens: True if any tokens were deleted, False otherwise. ) issuerOriginrT)r rr CLEAR_TRUST_TOKENS) issuer_originrVs rZclear_trust_tokensz"StorageCommands.clear_trust_tokenss! (]Cm>>vNNr\cRt||}ttj|S)aE Generates a command to delete a specific Shared Storage entry. Args: owner_origin: The owner origin of the Shared Storage. key: The key of the entry to delete. Returns: DeleteSharedStorageEntryCommand: The CDP command to delete the Shared Storage entry. )rkeyrT)r rr DELETE_SHARED_STORAGE_ENTRY)rrrVs rZdelete_shared_storage_entryz+StorageCommands.delete_shared_storage_entrys$0LcRmGGPVWWr\cPt|}ttj|S)a Generates a command to delete a Storage Bucket with the specified key and name. Storage Buckets are an experimental API for managing storage data with greater granularity and expiration control. Args: bucket: A StorageBucket object containing the storageKey and name of the bucket to delete. Returns: DeleteStorageBucketCommand: The CDP command to delete the Storage Bucket. )bucketrT)r rr DELETE_STORAGE_BUCKET)rrVs rZdelete_storage_bucketz%StorageCommands.delete_storage_buckets!+&9mAA&QQr\cRt||}ttj|S)a Generates a command to get the list of URLs from a page and its embedded resources that match existing grace period URL pattern rules. This command is useful for monitoring which URLs would be affected by the Privacy Sandbox's third-party cookie policies. Args: first_party_url: The URL of the page being visited (first-party). third_party_urls: Optional list of embedded third-party resource URLs. Returns: GetAffectedUrlsForThirdPartyCookieMetadataCommand: The CDP command to get URLs affected by third-party cookie metadata. ) firstPartyUrlthirdPartyUrlsrT)rrr 1GET_AFFECTED_URLS_FOR_THIRD_PARTY_COOKIE_METADATA)first_party_urlthird_party_urlsrVs rZ1get_affected_urls_for_third_party_cookie_metadatazAStorageCommands.get_affected_urls_for_third_party_cookie_metadatas0&B):J  RR[a  r\cRt||}ttj|S)a Generates a command to get details of a specific interest group. Interest Groups are part of the FLEDGE/Protected Audience API for privacy-preserving advertising, enabling in-browser ad auctions. Args: owner_origin: The owner origin of the interest group. name: The name of the interest group. Returns: GetInterestGroupDetailsCommand: The CDP command to get interest group details. )rr{rT)rrr GET_INTEREST_GROUP_DETAILS)rr{rVs rZget_interest_group_detailsz*StorageCommands.get_interest_group_detailss#/mGGPVWWr\cbt|||}|||d<ttj|S)a Generates a command to set an entry in Shared Storage. Args: owner_origin: The owner origin of the Shared Storage. key: The key of the entry to set. value: The value of the entry to set. ignore_if_present: If True, won't replace an existing entry with the same key. Returns: SetSharedStorageEntryCommand: The CDP command to set a Shared Storage entry. )rrvalueignoreIfPresentrT)rrr SET_SHARED_STORAGE_ENTRY)rrrignore_if_presentrVs rZset_shared_storage_entryz(StorageCommands.set_shared_storage_entrys7 -3V[\  ((9F$ %mDDVTTr\cPt|}ttj|S)ab Generates a command to enable or disable Shared Storage tracking. When enabled, events related to Shared Storage usage will be emitted. Args: enable: True to enable tracking, False to disable it. Returns: SetSharedStorageTrackingCommand: The CDP command to set Shared Storage tracking. rrT)rrr SET_SHARED_STORAGE_TRACKINGrs rZset_shared_storage_trackingz+StorageCommands.set_shared_storage_trackings"0v>mGGPVWWr\cRt||}ttj|S)a Generates a command to enable or disable Storage Bucket tracking. When enabled, events related to changes in storage buckets will be emitted. Args: storage_key: The storage key for which to set tracking. enable: True to enable tracking, False to disable it. Returns: SetStorageBucketTrackingCommand: The CDP command to set Storage Bucket tracking. )rdrrT)rrr SET_STORAGE_BUCKET_TRACKING)rfrrVs rZset_storage_bucket_trackingz+StorageCommands.set_storage_bucket_trackings$ 0;vVmGGPVWWr\)N)rY Optional[str]returnr*)r^strrarrr+)rfrrarrr,)rYrrr2)rnrrr7)r^rrr9)rvzlist[CookieParam]rYrrr@)rzrr{rr| list[str]rrC)r^rrrG)rfrrrH)r^rrrI)rfrrrJ)r^rrrK)rfrrrL)r^rrrM)rfrrrN)rrrr-)rrrr.)rrrrrr/)rrOrr0)rrrrrr1)rrr{rrr3)rr4)rrrr5)rrrr6)rr8)r^rrzOptional[float]rr:)rrrr;)rr<)rr=)rboolrr>)rrrr?)rrrrA)rrrrB) rrrrrrrzOptional[bool]rrD)rrrrE)rfrrrrrF)*__name__ __module__ __qualname____doc__ staticmethodr[rbrgrjrortrxr~rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr\rZrQrQWsU$JJ RR WW),W &WW*HH"VV"PP&HLH"H8EH HH&___'0_ .__*[["`` .``(XX$]]$]]"bb 0bb(ZZ"__ -__&YY OO$ X XRR"  09 :  2WW" F F W W X XII37VV!0V &VV,XX  X X Y Y  7  * _ _``" X XUYUU #U,/UDRU %UU( X XXX"&X (XXr\rQN)T __future__rtypingrrpydoll.protocol.baserpydoll.protocol.storage.methodsrrr r r r r rrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(pydoll.protocol.network.typesr)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNpydoll.protocol.storage.typesrOrQrr\rZrs"*(#########J9&&&&&&&&&&N<n Xn Xr\