Building 70 Projects ranging from beginner to advanced so anyone can β learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company π
Go aicertificationcloud-engineeringcybercybersecuritycybersecurity-analystcybersecurity-certificationcybersecurity-certificationscybersecurity-educationcybersecurity-jobscybersecurity-portfoliocybersecurity-projectscybersecurity-toolsgrchackinglearningpentestingproject-repositoryprojetcspython
feat(ja3-ja4-tls-fingerprinting): M8 SQLite intel store + M9 detection engine
CarterPerez-dev1bb94b08eb4d
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yamlindex f0ec85af..7d7ab794 100644--- a/.pre-commit-config.yaml+++ b/.pre-commit-config.yaml@@ -406,9 +406,9 @@ repos:- id: check-symlinksexclude: (\.pnpm-store|node_modules)/- id: end-of-file-fixer- exclude: (\.pnpm-store|node_modules)/|^PROJECTS/advanced/hsm-emulator/vendor/+ exclude: (\.pnpm-store|node_modules)/|^PROJECTS/advanced/hsm-emulator/vendor/|^PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/seeds/- id: trailing-whitespace- exclude: (\.pnpm-store|node_modules)/|^PROJECTS/advanced/hsm-emulator/vendor/+ exclude: (\.pnpm-store|node_modules)/|^PROJECTS/advanced/hsm-emulator/vendor/|^PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/seeds/- id: check-illegal-windows-namesexclude: (\.pnpm-store|node_modules)/- id: check-executables-have-shebangsdiff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/.dockerignore b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/.dockerignorenew file mode 100644index 00000000..f593405c--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/.dockerignore@@ -0,0 +1,12 @@+# Β©AngelaMos | 2026+# .dockerignore++target/+**/node_modules/+**/dist/+.git/+docs/+*.db+*.sqlite+.env+.env.developmentdiff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/.env.example b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/.env.examplenew file mode 100644index 00000000..42ebc963--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/.env.example@@ -0,0 +1,37 @@+# Β©AngelaMos | 2026+# .env.example+# Copy to .env (production) and .env.development (development), then fill in.+# Both .env and .env.development are gitignored. Run `just init` to set the+# project name and randomize ports, or `just ports` to re-randomize ports.++# ---------------------------------------------------------------------------+# Identity+# ---------------------------------------------------------------------------+APP_NAME=tlsfp++# Frontend build-time vars (baked into the bundle by Vite)+VITE_APP_TITLE=JA3/JA4 TLS Fingerprinting+VITE_API_URL=/api++# Vite standalone dev proxy target (only used when running pnpm dev outside+# the compose network; inside compose, nginx proxies /api to the backend)+VITE_API_TARGET=http://tlsfp:8080++# ---------------------------------------------------------------------------+# Host ports (randomized per-machine to avoid collisions)+# ---------------------------------------------------------------------------+NGINX_HOST_PORT=11790+FRONTEND_HOST_PORT=39755++# ---------------------------------------------------------------------------+# Backend (Rust)+# ---------------------------------------------------------------------------+# Read by the tlsfp binary via EnvFilter. The dashboard backend service is+# defined under the `backend` compose profile and is not started by default+# until the serve command is implemented.+RUST_LOG=tlsfp=info++# ---------------------------------------------------------------------------+# Cloudflare Tunnel (overlay: cloudflared.compose.yml)+# ---------------------------------------------------------------------------+CLOUDFLARE_TUNNEL_TOKEN=diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/.gitignore b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/.gitignoreindex 50b47180..ea0f5073 100644--- a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/.gitignore+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/.gitignore@@ -7,3 +7,11 @@ target/*.sqlitefuzz/corpus/fuzz/artifacts/++.env+.env.development+node_modules/+**/node_modules/+dist/+**/dist/+.biome_cache/diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/Cargo.lock b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/Cargo.lockindex 4befdd6c..d9779cd7 100644--- a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/Cargo.lock+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/Cargo.lock@@ -330,6 +330,27 @@ dependencies = ["typenum",]+[[package]]+name = "csv"+version = "1.4.0"+source = "registry+https://github.com/rust-lang/crates.io-index"+checksum = "52cd9d68cf7efc6ddfaaee42e7288d3a99d613d4b50f76ce9827ae0c6e14f938"+dependencies = [+ "csv-core",+ "itoa",+ "ryu",+ "serde_core",+]++[[package]]+name = "csv-core"+version = "0.1.13"+source = "registry+https://github.com/rust-lang/crates.io-index"+checksum = "704a3c26996a80471189265814dbc2c257598b96b8a7feae2d31ace646bb9782"+dependencies = [+ "memchr",+]+[[package]]name = "ctr"version = "0.9.2"@@ -1421,13 +1442,13 @@ dependencies = ["flume","pcap","pcap-parser",- "rusqlite","rustix","serde","serde_json","smallvec","thiserror","tlsfp-core",+ "tlsfp-intel","tokio","tower","tower-http",@@ -1454,6 +1475,19 @@ dependencies = ["thiserror",]+[[package]]+name = "tlsfp-intel"+version = "0.1.0"+dependencies = [+ "anyhow",+ "csv",+ "rusqlite",+ "serde",+ "serde_json",+ "tempfile",+ "tlsfp-core",+]+[[package]]name = "tokio"version = "1.52.3"diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/Cargo.toml b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/Cargo.tomlindex 887f6f47..a39c2fda 100644--- a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/Cargo.toml+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/Cargo.toml@@ -3,7 +3,7 @@[workspace]resolver = "3"-members = ["crates/tlsfp-core", "crates/tlsfp"]+members = ["crates/tlsfp-core", "crates/tlsfp-intel", "crates/tlsfp"][workspace.package]version = "0.1.0"@@ -15,6 +15,7 @@ repository = "https://github.com/CarterPerez-dev/Cybersecurity-Projects"[workspace.dependencies]tlsfp-core = { path = "crates/tlsfp-core" }+tlsfp-intel = { path = "crates/tlsfp-intel" }winnow = "0.7"md-5 = "0.10"@@ -35,6 +36,7 @@ flume = "0.11"rustix = { version = "1", features = ["std", "event"] }rusqlite = { version = "0.32", features = ["bundled"] }+csv = "1"axum = "0.8"tower-http = { version = "0.6", features = ["fs", "trace", "cors"] }diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/LICENSE b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/LICENSEindex a615e738..0ad25db4 100644--- a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/LICENSE+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/LICENSE@@ -1,21 +1,661 @@-MIT License--Copyright (c) 2026 Carter Perez--Permission is hereby granted, free of charge, to any person obtaining a copy-of this software and associated documentation files (the "Software"), to deal-in the Software without restriction, including without limitation the rights-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell-copies of the Software, and to permit persons to whom the Software is-furnished to do so, subject to the following conditions:--The above copyright notice and this permission notice shall be included in all-copies or substantial portions of the Software.--THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE-SOFTWARE.+ GNU AFFERO GENERAL PUBLIC LICENSE+ Version 3, 19 November 2007++ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>+ Everyone is permitted to copy and distribute verbatim copies+ of this license document, but changing it is not allowed.++ Preamble++ The GNU Affero General Public License is a free, copyleft license for+software and other kinds of works, specifically designed to ensure+cooperation with the community in the case of network server software.++ The licenses for most software and other practical works are designed+to take away your freedom to share and change the works. By contrast,+our General Public Licenses are intended to guarantee your freedom to+share and change all versions of a program--to make sure it remains free+software for all its users.++ When we speak of free software, we are referring to freedom, not+price. Our General Public Licenses are designed to make sure that you+have the freedom to distribute copies of free software (and charge for+them if you wish), that you receive source code or can get it if you+want it, that you can change the software or use pieces of it in new+free programs, and that you know you can do these things.++ Developers that use our General Public Licenses protect your rights+with two steps: (1) assert copyright on the software, and (2) offer+you this License which gives you legal permission to copy, distribute+and/or modify the software.++ A secondary benefit of defending all users' freedom is that+improvements made in alternate versions of the program, if they+receive widespread use, become available for other developers to+incorporate. Many developers of free software are heartened and+encouraged by the resulting cooperation. However, in the case of+software used on network servers, this result may fail to come about.+The GNU General Public License permits making a modified version and+letting the public access it on a server without ever releasing its+source code to the public.++ The GNU Affero General Public License is designed specifically to+ensure that, in such cases, the modified source code becomes available+to the community. It requires the operator of a network server to+provide the source code of the modified version running there to the+users of that server. Therefore, public use of a modified version, on+a publicly accessible server, gives the public access to the source+code of the modified version.++ An older license, called the Affero General Public License and+published by Affero, was designed to accomplish similar goals. This is+a different license, not a version of the Affero GPL, but Affero has+released a new version of the Affero GPL which permits relicensing under+this license.++ The precise terms and conditions for copying, distribution and+modification follow.++ TERMS AND CONDITIONS++ 0. Definitions.++ "This License" refers to version 3 of the GNU Affero General Public License.++ "Copyright" also means copyright-like laws that apply to other kinds of+works, such as semiconductor masks.++ "The Program" refers to any copyrightable work licensed under this+License. Each licensee is addressed as "you". "Licensees" and+"recipients" may be individuals or organizations.++ To "modify" a work means to copy from or adapt all or part of the work+in a fashion requiring copyright permission, other than the making of an+exact copy. The resulting work is called a "modified version" of the+earlier work or a work "based on" the earlier work.++ A "covered work" means either the unmodified Program or a work based+on the Program.++ To "propagate" a work means to do anything with it that, without+permission, would make you directly or secondarily liable for+infringement under applicable copyright law, except executing it on a+computer or modifying a private copy. Propagation includes copying,+distribution (with or without modification), making available to the+public, and in some countries other activities as well.++ To "convey" a work means any kind of propagation that enables other+parties to make or receive copies. Mere interaction with a user through+a computer network, with no transfer of a copy, is not conveying.++ An interactive user interface displays "Appropriate Legal Notices"+to the extent that it includes a convenient and prominently visible+feature that (1) displays an appropriate copyright notice, and (2)+tells the user that there is no warranty for the work (except to the+extent that warranties are provided), that licensees may convey the+work under this License, and how to view a copy of this License. If+the interface presents a list of user commands or options, such as a+menu, a prominent item in the list meets this criterion.++ 1. Source Code.++ The "source code" for a work means the preferred form of the work+for making modifications to it. "Object code" means any non-source+form of a work.++ A "Standard Interface" means an interface that either is an official+standard defined by a recognized standards body, or, in the case of+interfaces specified for a particular programming language, one that+is widely used among developers working in that language.++ The "System Libraries" of an executable work include anything, other+than the work as a whole, that (a) is included in the normal form of+packaging a Major Component, but which is not part of that Major+Component, and (b) serves only to enable use of the work with that+Major Component, or to implement a Standard Interface for which an+implementation is available to the public in source code form. A+"Major Component", in this context, means a major essential component+(kernel, window system, and so on) of the specific operating system+(if any) on which the executable work runs, or a compiler used to+produce the work, or an object code interpreter used to run it.++ The "Corresponding Source" for a work in object code form means all+the source code needed to generate, install, and (for an executable+work) run the object code and to modify the work, including scripts to+control those activities. However, it does not include the work's+System Libraries, or general-purpose tools or generally available free+programs which are used unmodified in performing those activities but+which are not part of the work. For example, Corresponding Source+includes interface definition files associated with source files for+the work, and the source code for shared libraries and dynamically+linked subprograms that the work is specifically designed to require,+such as by intimate data communication or control flow between those+subprograms and other parts of the work.++ The Corresponding Source need not include anything that users+can regenerate automatically from other parts of the Corresponding+Source.++ The Corresponding Source for a work in source code form is that+same work.++ 2. Basic Permissions.++ All rights granted under this License are granted for the term of+copyright on the Program, and are irrevocable provided the stated+conditions are met. This License explicitly affirms your unlimited+permission to run the unmodified Program. The output from running a+covered work is covered by this License only if the output, given its+content, constitutes a covered work. This License acknowledges your+rights of fair use or other equivalent, as provided by copyright law.++ You may make, run and propagate covered works that you do not+convey, without conditions so long as your license otherwise remains+in force. You may convey covered works to others for the sole purpose+of having them make modifications exclusively for you, or provide you+with facilities for running those works, provided that you comply with+the terms of this License in conveying all material for which you do+not control copyright. Those thus making or running the covered works+for you must do so exclusively on your behalf, under your direction+and control, on terms that prohibit them from making any copies of+your copyrighted material outside their relationship with you.++ Conveying under any other circumstances is permitted solely under+the conditions stated below. Sublicensing is not allowed; section 10+makes it unnecessary.++ 3. Protecting Users' Legal Rights From Anti-Circumvention Law.++ No covered work shall be deemed part of an effective technological+measure under any applicable law fulfilling obligations under article+11 of the WIPO copyright treaty adopted on 20 December 1996, or+similar laws prohibiting or restricting circumvention of such+measures.++ When you convey a covered work, you waive any legal power to forbid+circumvention of technological measures to the extent such circumvention+is effected by exercising rights under this License with respect to+the covered work, and you disclaim any intention to limit operation or+modification of the work as a means of enforcing, against the work's+users, your or third parties' legal rights to forbid circumvention of+technological measures.++ 4. Conveying Verbatim Copies.++ You may convey verbatim copies of the Program's source code as you+receive it, in any medium, provided that you conspicuously and+appropriately publish on each copy an appropriate copyright notice;+keep intact all notices stating that this License and any+non-permissive terms added in accord with section 7 apply to the code;+keep intact all notices of the absence of any warranty; and give all+recipients a copy of this License along with the Program.++ You may charge any price or no price for each copy that you convey,+and you may offer support or warranty protection for a fee.++ 5. Conveying Modified Source Versions.++ You may convey a work based on the Program, or the modifications to+produce it from the Program, in the form of source code under the+terms of section 4, provided that you also meet all of these conditions:++ a) The work must carry prominent notices stating that you modified+ it, and giving a relevant date.++ b) The work must carry prominent notices stating that it is+ released under this License and any conditions added under section+ 7. This requirement modifies the requirement in section 4 to+ "keep intact all notices".++ c) You must license the entire work, as a whole, under this+ License to anyone who comes into possession of a copy. This+ License will therefore apply, along with any applicable section 7+ additional terms, to the whole of the work, and all its parts,+ regardless of how they are packaged. This License gives no+ permission to license the work in any other way, but it does not+ invalidate such permission if you have separately received it.++ d) If the work has interactive user interfaces, each must display+ Appropriate Legal Notices; however, if the Program has interactive+ interfaces that do not display Appropriate Legal Notices, your+ work need not make them do so.++ A compilation of a covered work with other separate and independent+works, which are not by their nature extensions of the covered work,+and which are not combined with it such as to form a larger program,+in or on a volume of a storage or distribution medium, is called an+"aggregate" if the compilation and its resulting copyright are not+used to limit the access or legal rights of the compilation's users+beyond what the individual works permit. Inclusion of a covered work+in an aggregate does not cause this License to apply to the other+parts of the aggregate.++ 6. Conveying Non-Source Forms.++ You may convey a covered work in object code form under the terms+of sections 4 and 5, provided that you also convey the+machine-readable Corresponding Source under the terms of this License,+in one of these ways:++ a) Convey the object code in, or embodied in, a physical product+ (including a physical distribution medium), accompanied by the+ Corresponding Source fixed on a durable physical medium+ customarily used for software interchange.++ b) Convey the object code in, or embodied in, a physical product+ (including a physical distribution medium), accompanied by a+ written offer, valid for at least three years and valid for as+ long as you offer spare parts or customer support for that product+ model, to give anyone who possesses the object code either (1) a+ copy of the Corresponding Source for all the software in the+ product that is covered by this License, on a durable physical+ medium customarily used for software interchange, for a price no+ more than your reasonable cost of physically performing this+ conveying of source, or (2) access to copy the+ Corresponding Source from a network server at no charge.++ c) Convey individual copies of the object code with a copy of the+ written offer to provide the Corresponding Source. This+ alternative is allowed only occasionally and noncommercially, and+ only if you received the object code with such an offer, in accord+ with subsection 6b.++ d) Convey the object code by offering access from a designated+ place (gratis or for a charge), and offer equivalent access to the+ Corresponding Source in the same way through the same place at no+ further charge. You need not require recipients to copy the+ Corresponding Source along with the object code. If the place to+ copy the object code is a network server, the Corresponding Source+ may be on a different server (operated by you or a third party)+ that supports equivalent copying facilities, provided you maintain+ clear directions next to the object code saying where to find the+ Corresponding Source. Regardless of what server hosts the+ Corresponding Source, you remain obligated to ensure that it is+ available for as long as needed to satisfy these requirements.++ e) Convey the object code using peer-to-peer transmission, provided+ you inform other peers where the object code and Corresponding+ Source of the work are being offered to the general public at no+ charge under subsection 6d.++ A separable portion of the object code, whose source code is excluded+from the Corresponding Source as a System Library, need not be+included in conveying the object code work.++ A "User Product" is either (1) a "consumer product", which means any+tangible personal property which is normally used for personal, family,+or household purposes, or (2) anything designed or sold for incorporation+into a dwelling. In determining whether a product is a consumer product,+doubtful cases shall be resolved in favor of coverage. For a particular+product received by a particular user, "normally used" refers to a+typical or common use of that class of product, regardless of the status+of the particular user or of the way in which the particular user+actually uses, or expects or is expected to use, the product. A product+is a consumer product regardless of whether the product has substantial+commercial, industrial or non-consumer uses, unless such uses represent+the only significant mode of use of the product.++ "Installation Information" for a User Product means any methods,+procedures, authorization keys, or other information required to install+and execute modified versions of a covered work in that User Product from+a modified version of its Corresponding Source. The information must+suffice to ensure that the continued functioning of the modified object+code is in no case prevented or interfered with solely because+modification has been made.++ If you convey an object code work under this section in, or with, or+specifically for use in, a User Product, and the conveying occurs as+part of a transaction in which the right of possession and use of the+User Product is transferred to the recipient in perpetuity or for a+fixed term (regardless of how the transaction is characterized), the+Corresponding Source conveyed under this section must be accompanied+by the Installation Information. But this requirement does not apply+if neither you nor any third party retains the ability to install+modified object code on the User Product (for example, the work has+been installed in ROM).++ The requirement to provide Installation Information does not include a+requirement to continue to provide support service, warranty, or updates+for a work that has been modified or installed by the recipient, or for+the User Product in which it has been modified or installed. Access to a+network may be denied when the modification itself materially and+adversely affects the operation of the network or violates the rules and+protocols for communication across the network.++ Corresponding Source conveyed, and Installation Information provided,+in accord with this section must be in a format that is publicly+documented (and with an implementation available to the public in+source code form), and must require no special password or key for+unpacking, reading or copying.++ 7. Additional Terms.++ "Additional permissions" are terms that supplement the terms of this+License by making exceptions from one or more of its conditions.+Additional permissions that are applicable to the entire Program shall+be treated as though they were included in this License, to the extent+that they are valid under applicable law. If additional permissions+apply only to part of the Program, that part may be used separately+under those permissions, but the entire Program remains governed by+this License without regard to the additional permissions.++ When you convey a copy of a covered work, you may at your option+remove any additional permissions from that copy, or from any part of+it. (Additional permissions may be written to require their own+removal in certain cases when you modify the work.) You may place+additional permissions on material, added by you to a covered work,+for which you have or can give appropriate copyright permission.++ Notwithstanding any other provision of this License, for material you+add to a covered work, you may (if authorized by the copyright holders of+that material) supplement the terms of this License with terms:++ a) Disclaiming warranty or limiting liability differently from the+ terms of sections 15 and 16 of this License; or++ b) Requiring preservation of specified reasonable legal notices or+ author attributions in that material or in the Appropriate Legal+ Notices displayed by works containing it; or++ c) Prohibiting misrepresentation of the origin of that material, or+ requiring that modified versions of such material be marked in+ reasonable ways as different from the original version; or++ d) Limiting the use for publicity purposes of names of licensors or+ authors of the material; or++ e) Declining to grant rights under trademark law for use of some+ trade names, trademarks, or service marks; or++ f) Requiring indemnification of licensors and authors of that+ material by anyone who conveys the material (or modified versions of+ it) with contractual assumptions of liability to the recipient, for+ any liability that these contractual assumptions directly impose on+ those licensors and authors.++ All other non-permissive additional terms are considered "further+restrictions" within the meaning of section 10. If the Program as you+received it, or any part of it, contains a notice stating that it is+governed by this License along with a term that is a further+restriction, you may remove that term. If a license document contains+a further restriction but permits relicensing or conveying under this+License, you may add to a covered work material governed by the terms+of that license document, provided that the further restriction does+not survive such relicensing or conveying.++ If you add terms to a covered work in accord with this section, you+must place, in the relevant source files, a statement of the+additional terms that apply to those files, or a notice indicating+where to find the applicable terms.++ Additional terms, permissive or non-permissive, may be stated in the+form of a separately written license, or stated as exceptions;+the above requirements apply either way.++ 8. Termination.++ You may not propagate or modify a covered work except as expressly+provided under this License. Any attempt otherwise to propagate or+modify it is void, and will automatically terminate your rights under+this License (including any patent licenses granted under the third+paragraph of section 11).++ However, if you cease all violation of this License, then your+license from a particular copyright holder is reinstated (a)+provisionally, unless and until the copyright holder explicitly and+finally terminates your license, and (b) permanently, if the copyright+holder fails to notify you of the violation by some reasonable means+prior to 60 days after the cessation.++ Moreover, your license from a particular copyright holder is+reinstated permanently if the copyright holder notifies you of the+violation by some reasonable means, this is the first time you have+received notice of violation of this License (for any work) from that+copyright holder, and you cure the violation prior to 30 days after+your receipt of the notice.++ Termination of your rights under this section does not terminate the+licenses of parties who have received copies or rights from you under+this License. If your rights have been terminated and not permanently+reinstated, you do not qualify to receive new licenses for the same+material under section 10.++ 9. Acceptance Not Required for Having Copies.++ You are not required to accept this License in order to receive or+run a copy of the Program. Ancillary propagation of a covered work+occurring solely as a consequence of using peer-to-peer transmission+to receive a copy likewise does not require acceptance. However,+nothing other than this License grants you permission to propagate or+modify any covered work. These actions infringe copyright if you do+not accept this License. Therefore, by modifying or propagating a+covered work, you indicate your acceptance of this License to do so.++ 10. Automatic Licensing of Downstream Recipients.++ Each time you convey a covered work, the recipient automatically+receives a license from the original licensors, to run, modify and+propagate that work, subject to this License. You are not responsible+for enforcing compliance by third parties with this License.++ An "entity transaction" is a transaction transferring control of an+organization, or substantially all assets of one, or subdividing an+organization, or merging organizations. If propagation of a covered+work results from an entity transaction, each party to that+transaction who receives a copy of the work also receives whatever+licenses to the work the party's predecessor in interest had or could+give under the previous paragraph, plus a right to possession of the+Corresponding Source of the work from the predecessor in interest, if+the predecessor has it or can get it with reasonable efforts.++ You may not impose any further restrictions on the exercise of the+rights granted or affirmed under this License. For example, you may+not impose a license fee, royalty, or other charge for exercise of+rights granted under this License, and you may not initiate litigation+(including a cross-claim or counterclaim in a lawsuit) alleging that+any patent claim is infringed by making, using, selling, offering for+sale, or importing the Program or any portion of it.++ 11. Patents.++ A "contributor" is a copyright holder who authorizes use under this+License of the Program or a work on which the Program is based. The+work thus licensed is called the contributor's "contributor version".++ A contributor's "essential patent claims" are all patent claims+owned or controlled by the contributor, whether already acquired or+hereafter acquired, that would be infringed by some manner, permitted+by this License, of making, using, or selling its contributor version,+but do not include claims that would be infringed only as a+consequence of further modification of the contributor version. For+purposes of this definition, "control" includes the right to grant+patent sublicenses in a manner consistent with the requirements of+this License.++ Each contributor grants you a non-exclusive, worldwide, royalty-free+patent license under the contributor's essential patent claims, to+make, use, sell, offer for sale, import and otherwise run, modify and+propagate the contents of its contributor version.++ In the following three paragraphs, a "patent license" is any express+agreement or commitment, however denominated, not to enforce a patent+(such as an express permission to practice a patent or covenant not to+sue for patent infringement). To "grant" such a patent license to a+party means to make such an agreement or commitment not to enforce a+patent against the party.++ If you convey a covered work, knowingly relying on a patent license,+and the Corresponding Source of the work is not available for anyone+to copy, free of charge and under the terms of this License, through a+publicly available network server or other readily accessible means,+then you must either (1) cause the Corresponding Source to be so+available, or (2) arrange to deprive yourself of the benefit of the+patent license for this particular work, or (3) arrange, in a manner+consistent with the requirements of this License, to extend the patent+license to downstream recipients. "Knowingly relying" means you have+actual knowledge that, but for the patent license, your conveying the+covered work in a country, or your recipient's use of the covered work+in a country, would infringe one or more identifiable patents in that+country that you have reason to believe are valid.++ If, pursuant to or in connection with a single transaction or+arrangement, you convey, or propagate by procuring conveyance of, a+covered work, and grant a patent license to some of the parties+receiving the covered work authorizing them to use, propagate, modify+or convey a specific copy of the covered work, then the patent license+you grant is automatically extended to all recipients of the covered+work and works based on it.++ A patent license is "discriminatory" if it does not include within+the scope of its coverage, prohibits the exercise of, or is+conditioned on the non-exercise of one or more of the rights that are+specifically granted under this License. You may not convey a covered+work if you are a party to an arrangement with a third party that is+in the business of distributing software, under which you make payment+to the third party based on the extent of your activity of conveying+the work, and under which the third party grants, to any of the+parties who would receive the covered work from you, a discriminatory+patent license (a) in connection with copies of the covered work+conveyed by you (or copies made from those copies), or (b) primarily+for and in connection with specific products or compilations that+contain the covered work, unless you entered into that arrangement,+or that patent license was granted, prior to 28 March 2007.++ Nothing in this License shall be construed as excluding or limiting+any implied license or other defenses to infringement that may+otherwise be available to you under applicable patent law.++ 12. No Surrender of Others' Freedom.++ If conditions are imposed on you (whether by court order, agreement or+otherwise) that contradict the conditions of this License, they do not+excuse you from the conditions of this License. If you cannot convey a+covered work so as to satisfy simultaneously your obligations under this+License and any other pertinent obligations, then as a consequence you may+not convey it at all. For example, if you agree to terms that obligate you+to collect a royalty for further conveying from those to whom you convey+the Program, the only way you could satisfy both those terms and this+License would be to refrain entirely from conveying the Program.++ 13. Remote Network Interaction; Use with the GNU General Public License.++ Notwithstanding any other provision of this License, if you modify the+Program, your modified version must prominently offer all users+interacting with it remotely through a computer network (if your version+supports such interaction) an opportunity to receive the Corresponding+Source of your version by providing access to the Corresponding Source+from a network server at no charge, through some standard or customary+means of facilitating copying of software. This Corresponding Source+shall include the Corresponding Source for any work covered by version 3+of the GNU General Public License that is incorporated pursuant to the+following paragraph.++ Notwithstanding any other provision of this License, you have+permission to link or combine any covered work with a work licensed+under version 3 of the GNU General Public License into a single+combined work, and to convey the resulting work. The terms of this+License will continue to apply to the part which is the covered work,+but the work with which it is combined will remain governed by version+3 of the GNU General Public License.++ 14. Revised Versions of this License.++ The Free Software Foundation may publish revised and/or new versions of+the GNU Affero General Public License from time to time. Such new versions+will be similar in spirit to the present version, but may differ in detail to+address new problems or concerns.++ Each version is given a distinguishing version number. If the+Program specifies that a certain numbered version of the GNU Affero General+Public License "or any later version" applies to it, you have the+option of following the terms and conditions either of that numbered+version or of any later version published by the Free Software+Foundation. If the Program does not specify a version number of the+GNU Affero General Public License, you may choose any version ever published+by the Free Software Foundation.++ If the Program specifies that a proxy can decide which future+versions of the GNU Affero General Public License can be used, that proxy's+public statement of acceptance of a version permanently authorizes you+to choose that version for the Program.++ Later license versions may give you additional or different+permissions. However, no additional obligations are imposed on any+author or copyright holder as a result of your choosing to follow a+later version.++ 15. Disclaimer of Warranty.++ THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY+APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR+PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM+IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.++ 16. Limitation of Liability.++ IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF+SUCH DAMAGES.++ 17. Interpretation of Sections 15 and 16.++ If the disclaimer of warranty and limitation of liability provided+above cannot be given local legal effect according to their terms,+reviewing courts shall apply local law that most closely approximates+an absolute waiver of all civil liability in connection with the+Program, unless a warranty or assumption of liability accompanies a+copy of the Program in return for a fee.++ END OF TERMS AND CONDITIONS++ How to Apply These Terms to Your New Programs++ If you develop a new program, and you want it to be of the greatest+possible use to the public, the best way to achieve this is to make it+free software which everyone can redistribute and change under these terms.++ To do so, attach the following notices to the program. It is safest+to attach them to the start of each source file to most effectively+state the exclusion of warranty; and each file should have at least+the "copyright" line and a pointer to where the full notice is found.++ <one line to give the program's name and a brief idea of what it does.>+ Copyright (C) <year> <name of author>++ This program is free software: you can redistribute it and/or modify+ it under the terms of the GNU Affero General Public License as published+ by the Free Software Foundation, either version 3 of the License, or+ (at your option) any later version.++ This program is distributed in the hope that it will be useful,+ but WITHOUT ANY WARRANTY; without even the implied warranty of+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the+ GNU Affero General Public License for more details.++ You should have received a copy of the GNU Affero General Public License+ along with this program. If not, see <https://www.gnu.org/licenses/>.++Also add information on how to contact you by electronic and paper mail.++ If your software can interact with users remotely through a computer+network, you should also make sure that it provides a way for users to+get its source. For example, if your program is a web application, its+interface could display a "Source" link that leads users to an archive+of the code. There are many ways you could offer source, and different+solutions will be better for different programs; see section 13 for the+specific requirements.++ You should also get your employer (if you work as a programmer) or school,+if any, to sign a "copyright disclaimer" for the program, if necessary.+For more information on this, and how to apply and follow the GNU AGPL, see+<https://www.gnu.org/licenses/>.diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/NOTICE.md b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/NOTICE.mdindex 8947fe21..e9d44e22 100644--- a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/NOTICE.md+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/NOTICE.md@@ -6,7 +6,7 @@ applies to what.## Our own code-Everything under `crates/` is original work licensed under the MIT License (see+Everything under `crates/` is original work licensed under the AGPL 3.0 License (see`LICENSE`). No source code from any reference implementation was copied. Thealgorithms were implemented from their published specifications.diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/cloudflared.compose.yml b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/cloudflared.compose.ymlnew file mode 100644index 00000000..076b4642--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/cloudflared.compose.yml@@ -0,0 +1,27 @@+# =============================================================================+# Β©AngelaMos | 2026+# cloudflared.compose.yml+# =============================================================================+# Cloudflare Tunnel for production remote access+# Usage: docker compose -f compose.yml -f cloudflared.compose.yml up -d+# =============================================================================++services:+ cloudflared:+ image: cloudflare/cloudflared:latest+ container_name: ${APP_NAME:-tlsfp}-tunnel+ command: tunnel run --token ${CLOUDFLARE_TUNNEL_TOKEN}+ networks:+ - app+ depends_on:+ nginx:+ condition: service_started+ deploy:+ resources:+ limits:+ cpus: '0.5'+ memory: 128M+ reservations:+ cpus: '0.1'+ memory: 32M+ restart: unless-stoppeddiff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/compose.yml b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/compose.ymlnew file mode 100644index 00000000..819421f1--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/compose.yml@@ -0,0 +1,67 @@+# =============================================================================+# Β©AngelaMos | 2026+# compose.yml+# =============================================================================+# Production compose: nginx serves the built React app and proxies /api to the+# tlsfp backend. The backend lives under the `backend` profile and is not+# started by default until the serve command is implemented.+# docker compose --env-file .env up+# docker compose --env-file .env --profile backend up+# docker compose -f compose.yml -f cloudflared.compose.yml up+# =============================================================================++name: ${APP_NAME:-tlsfp}++services:+ nginx:+ build:+ context: .+ dockerfile: infra/docker/vite.prod+ args:+ - VITE_API_URL=${VITE_API_URL:-/api}+ - VITE_APP_TITLE=${VITE_APP_TITLE:-JA3/JA4 TLS Fingerprinting}+ container_name: ${APP_NAME:-tlsfp}-nginx+ ports:+ - "${NGINX_HOST_PORT:-11790}:80"+ networks:+ - app+ deploy:+ resources:+ limits:+ cpus: '1.0'+ memory: 256M+ reservations:+ cpus: '0.25'+ memory: 64M+ restart: unless-stopped++ tlsfp:+ build:+ context: .+ dockerfile: infra/docker/tlsfp.prod+ container_name: ${APP_NAME:-tlsfp}-backend+ command: ["serve", "0.0.0.0:8080"]+ profiles:+ - backend+ environment:+ - RUST_LOG=${RUST_LOG:-tlsfp=info}+ volumes:+ - tlsfp_data:/data+ networks:+ - app+ deploy:+ resources:+ limits:+ cpus: '1.0'+ memory: 256M+ reservations:+ cpus: '0.25'+ memory: 64M+ restart: unless-stopped++networks:+ app:+ driver: bridge++volumes:+ tlsfp_data:diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-core/src/pipeline/event.rs b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-core/src/pipeline/event.rsindex 70d2c9fe..88d8463f 100644--- a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-core/src/pipeline/event.rs+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-core/src/pipeline/event.rs@@ -36,6 +36,8 @@ pub enum StreamEvent {ja4h: Ja4Family,method: String,host: Option<String>,+ #[serde(skip_serializing_if = "Option::is_none")]+ user_agent: Option<String>,},TcpSyn {ja4t: String,@@ -84,11 +86,19 @@ impl fmt::Display for FingerprintEvent {write!(f, "server_hello ja4s={} ja3s={ja3s}", ja4s.hash)}StreamEvent::Certificate { ja4x } => write!(f, "certificate ja4x={ja4x}"),- StreamEvent::HttpRequest { ja4h, method, host } => {+ StreamEvent::HttpRequest {+ ja4h,+ method,+ host,+ user_agent,+ } => {write!(f, "http_request ja4h={} method={method}", ja4h.hash)?;if let Some(host) = host {write!(f, " host={host}")?;}+ if let Some(user_agent) = user_agent {+ write!(f, " ua={user_agent}")?;+ }Ok(())}StreamEvent::TcpSyn { ja4t } => write!(f, "tcp_syn ja4t={ja4t}"),diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-core/src/pipeline/tls.rs b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-core/src/pipeline/tls.rsindex 9f242408..aa27d104 100644--- a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-core/src/pipeline/tls.rs+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-core/src/pipeline/tls.rs@@ -149,10 +149,16 @@ fn advance_http(proto: &mut StreamProtocol, stream: &[u8], sink: &mut impl FnMut.iter().find(|(name, _)| name.eq_ignore_ascii_case("host")).map(|(_, value)| value.clone());+ let user_agent = request+ .headers+ .iter()+ .find(|(name, _)| name.eq_ignore_ascii_case("user-agent"))+ .map(|(_, value)| value.clone());sink(StreamEvent::HttpRequest {ja4h: ja4h(&request),method: request.method.clone(),host,+ user_agent,});*proto = StreamProtocol::Done;} else {diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/Cargo.toml b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/Cargo.tomlnew file mode 100644index 00000000..d5d0a2e9--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/Cargo.toml@@ -0,0 +1,26 @@+# Β©AngelaMos | 2026+# Cargo.toml++[package]+name = "tlsfp-intel"+description = "Local threat intelligence store and fingerprint matching engine"+version.workspace = true+edition.workspace = true+rust-version.workspace = true+license.workspace = true+authors.workspace = true+repository.workspace = true++[lints]+workspace = true++[dependencies]+tlsfp-core.workspace = true+rusqlite.workspace = true+csv.workspace = true+serde.workspace = true+serde_json.workspace = true+anyhow.workspace = true++[dev-dependencies]+tempfile = "3"diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/seeds/PROVENANCE.md b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/seeds/PROVENANCE.mdnew file mode 100644index 00000000..399e6a04--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/seeds/PROVENANCE.md@@ -0,0 +1,64 @@+<!-- Β©AngelaMos | 2026 -->+<!-- PROVENANCE.md -->++# Seed provenance++These three files are the intelligence the tool ships with. They are compiled+into the binary with `include_str!`, so a freshly built `tlsfp` can seed its+database with no network access. The large external source, ja4db.com, is+fetched at install time instead of bundled, because its license is unspecified+and its records are known to contain dirty entries that the importer validates+and rejects on the way in.++Each row is a fingerprint plus a label. None of these files is edited after+import beyond skipping comment lines and rows whose first field is not a+fingerprint, so the sha256 below is the exact bundled content.++## sslbl-ja3.csv++- Source: https://sslbl.abuse.ch/blacklist/ja3_fingerprints.csv+- Retrieved: 2026-06-14+- Snapshot date in the file header: 2021-08-03 (abuse.ch froze the JA3 list)+- License: CC0 1.0 (public domain dedication), so the snapshot is committable+- Records: 97 malicious JA3 hashes with a family label and first and last seen dates+- sha256: 6974182489b6e5f5f64079454b81a7219a2d82ae950f108567fa371220eb09e9++The abuse.ch SSL Blacklist carries a false positive disclaimer: a JA3 is a hash+of a TLS client library, so a benign program that links the same library lands+on the same hash. That disclaimer is the reason the matching engine scores+prevalence across sources instead of treating any single feed hit as proof.++## salesforce-osx-nix-ja3.csv++- Source: https://raw.githubusercontent.com/salesforce/ja3/master/lists/osx-nix-ja3.csv+- Retrieved: 2026-06-14+- License: BSD 3-Clause, recorded verbatim in the first record of the file+- Records: 157 benign JA3 hashes for common macOS and nix applications+- sha256: 2865b3f73a68e603dd3fa7fb56565dca70a269cda70f460ed5db03f5d724c4e1++The upstream salesforce/ja3 repository was archived on 2025-05-01. The file is+the benign half of the picture: it is what makes a collision visible. Several+hashes in this list also appear in sslbl-ja3.csv under a malware label, which+is the cleanest real demonstration that a JA3 alone cannot decide intent. The+field that names the application is quoted and can hold several comma separated+names, so the loader parses it as RFC 4180 CSV rather than splitting on commas.++Note on licensing: the research notes that seeded this project called this list+MIT. The file header itself says BSD 3-Clause, and the file is the ground truth,+so it is attributed as BSD 3-Clause here.++## curated-c2-intel.csv++- Source: hand curated for this project from named primary sources+- License: same as this repository+- Records: 17 rows covering C2 frameworks, malware families, dual-use tooling,+ and two benign browser baselines, each with a primary source in the reference+ column+- sha256: 202c0a1edc495a5149d7f6161d21adc152b1b71efdde2f5052d4767ebb0f7b66++This file fills the gaps the public feeds leave: server side JA3S for Cobalt+Strike, TrickBot, and Emotet, a JA4 for RedLine Stealer, and JA4 baselines for+Chrome over TCP and QUIC that let the engine recognise a tool that copies a+browser cipher list but not its full extension order. Where a public feed labels+one of these hashes with a different family, the divergence is written into the+reference column rather than silently reconciled.diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/seeds/curated-c2-intel.csv b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/seeds/curated-c2-intel.csvnew file mode 100644index 00000000..9c2a0e34--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/seeds/curated-c2-intel.csv@@ -0,0 +1,28 @@+# Β©AngelaMos | 2026+# curated-c2-intel.csv+#+# Hand-curated fingerprints for C2 frameworks, malware families, and benign+# baselines. Every row is traced to a named primary source in the reference+# column. Categories: c2 and malware are malicious; tool is dual-use offensive+# or privacy tooling that is noteworthy but not conclusive on its own; benign+# is a known-good baseline. Where a public feed labels the same hash with a+# different family name, that divergence is recorded in the reference rather+# than hidden, because a single JA3 can be shared by unrelated software.+fp_kind,value,label,category,reference+ja3,72a589da586844d7f0818ce684948eea,Cobalt Strike,c2,"Cobalt Strike default malleable profile over an IP; the same TLS stack is used by Emotet so this JA3 collides between the two"+ja3,a0e9f5d64349fb13191bc781f81f42e1,Cobalt Strike,c2,"Cobalt Strike default profile over a domain"+ja3,19e29534fd49dd27d09234e639c4057e,Sliver,c2,"Sliver implant; observed during Ivanti gateway exploitation in 2024 (Darktrace)"+ja3,c12f54a3f91dc7bafd92cb59fe009a35,PoshC2,c2,"PoshC2 proxy-aware command and control framework"+ja3,8916410db85077a5460817142dcbc8de,Metasploit,tool,"Metasploit Meterpreter HTTPS stager; abuse.ch SSLBL lists the identical JA3 as TrickBot, a feed label divergence"+ja3,f5e62b5a2ed9467df09fae7a8a54dda6,BazarLoader,malware,"BazarLoader and BazarBackdoor, part of the TrickBot and Conti ecosystem"+ja3,b386946a5a44d1ddcc843bc75336dfce,Dyre,malware,"Dyre and Dyreza banking trojan; the original JA3 pivot that surfaced 112 related samples; abuse.ch SSLBL lists the identical JA3 as Dridex"+ja3,e7d705a3286e19ea42f587b344ee6865,Tor,tool,"Tor client TLS; WannaCry tunnelled its command and control over Tor, but most Tor traffic is legitimate"+ja3,a85be79f7b569f1df5e6087b69deb493,Remcos,malware,"Remcos remote access trojan"+ja3,4d7a28d6f2263ed61de88ca66eb011e3,Emotet,malware,"Emotet loader; abuse.ch SSLBL lists the identical JA3 as Tofsee, a feed label divergence"+ja3,6734f37431670b3ab4292b8f60f29984,TrickBot,malware,"TrickBot banking trojan and loader"+ja3s,b742b407517bac9536a77a7b0fee28e9,Cobalt Strike,c2,"Cobalt Strike team server ServerHello"+ja3s,623de93db17d313345d7ea481e7443cf,TrickBot,c2,"TrickBot command and control server ServerHello"+ja3s,80b3a14bccc8598a1f3bbe83e71f735f,Emotet,c2,"Emotet command and control server ServerHello"+ja4,t10d070600_c50f5591e341_1a3805c3aa63,RedLine Stealer,malware,"RedLine Stealer and SnakeLogger infostealer (VirusTotal 2024)"+ja4,t13d1516h2_8daaf6152771_e5627efa2ab1,Google Chrome,benign,"Chrome over TCP; FoxIO reference fingerprint from the chrome-cloudflare capture"+ja4,q13d0310h3_55b375c5d22e_cd85d2d88918,Google Chrome,benign,"Chrome over QUIC; FoxIO reference fingerprint from the chrome-cloudflare capture"diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/seeds/salesforce-osx-nix-ja3.csv b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/seeds/salesforce-osx-nix-ja3.csvnew file mode 100644index 00000000..a5494c74--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/seeds/salesforce-osx-nix-ja3.csv@@ -0,0 +1,161 @@+"Copyright (c) 2017 salesforce.com inc.+All rights reserved.+Licensed under the BSD 3-Clause license.+For full license text see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause",+61d50e7771aee7f2f4b89a7200b4d45e,"AcroCEF"+49a6cf42956937669a01438f26e7c609,"AIM"+561145462cfc7de1d6a97e93d3264786,"Airmail 3"+f6fd83a21f9f3c5f9ff7b5c63bbc179d,"Alation Compose"+6003b52942a2e1e1ea72d802d153ec08,"Amazon Music"+eb149984fc9c44d85ed7f12c90d818be,"Amazon Music,Dreamweaver,Spotify"+8e3f1bf87bc652a20de63bfd4952b16a,"AnypointStudio"+5507277945374659a5b4572e1b6d9b9f,"apple.geod"+f753495f2eab5155c61b760c838018f8,"apple.geod"+ba40fea2b2638908a3b3b482ac78d729,"apple.geod,parsecd,apple.photomoments"+474e73aea21d1e0910f25c3e6c178535,"apple.WebKit.Networking"+eeeb5e7485f5e10cbc39db4cfb69b264,"apple.WebKit.Networking"+d4693422c5ce1565377aca25940ad80c,"apple.WebKit.Networking,CalendarAgent,Go for Gmail"+63de2b6188d5694e79b678f585b13264,"apple.WebKit.Networking,Chatter,FieldServiceApp,socialstudio"+3e4e87dda5a3162306609b7e330441d2,"apple.WebKit.Networking,itunesstored"+7b343af1092863fdd822d6f10645abfb,"apple.WebKit.Networking,itunesstored"+a312f9162a08eeedf7feb7a13cd7e9bb,"apple.WebKit.Networking,Spotify,WhatsApp,Skype,iTunes"+c5c11e6105c56fd29cc72c3ac7a2b78b,"AT&T Connect"+fa030dbcb2e3c7141d3c2803780ee8db,"Battle.net,Dropbox"+0ef9ca1c10d3f186f5786e1ef3461a46,"bitgo,ShapeShift"+cdec81515ccc75a5aa41eb3db22226e6,"BlueJeans,CEPHtmlEngine"+83e04bc58d402f9633983cbf22724b02,"Charles,Google Play Music Desktop Player,Postman,Slack,and other desktop programs"+424008725394c634a4616b8b1f2828a5,"Charles,java,eclipse"+be9f1360cf52dc1f61ae025252f192a3,"Chromium"+def8761e4bcaaf91d99801a22ac6f6d4,"Chromium"+fc5cb0985a5f5e295163cc8ffff8a6e1,"Chromium"+e7d46c98b078477c4324031e0d3b22f5,"Cisco AnyConnect Secure Mobility Client"+ed36017db541879619c399c95e22067d,"Cisco AnyConnect Secure Mobility Client"+5ee1a653fb824db7182714897fd3b5df,"Citrix Viewer"+a9d17f74e55dd53fcf7c234f8a240919,"Covenant Eyes"+c882d9444412c00e71b643f3f54145ff,"Creative Cloud"+bc0608d33dc64506b42f7f5f87958f37,"cscan"+ccaa60f6ccc701bde536ef409be3cf63,"curl no-SNI"+fe048fe8faf797796e278f2b4f1e9c24,"curl SNI"+4fcd1770545298cc119865aeba81daba,"Deezer"+4c40bf8baa7c301c5dba8a20bc4119e2,"Dynalist,Postman,Google Chrome,Franz,GOG Galaxy"+0411bbb5ff27ad46e1874a7a8beedacb,"eclipse"+4990c9da08f44a01ecd7ddc3837caf25,"eclipse"+fa106fe5beec443af7e211ef8902e7e0,"eclipse"+d74778f454e2b047e030b291b94dd698,"eclipse,java"+187dfde7edc8ceddccd3deeccc21daeb,"eclipse,java,studio,STS"+8c5a50f1e833ed581e9cfc690814719a,"eclipse,JavaApplicationStub,idea"+1fbe5382f9d8430fe921df747c46d95f,"FieldServiceApp,socialstudio"+0a81538cf247c104edb677bdb8902ed5,"firefox"+0b6592fd91d4843c823b75e49b43838d,"firefox"+0ffee3ba8e615ad22535e7f771690a28,"firefox"+1c15aca4a38bad90f9c40678f6aface9,"firefox"+5163bc7c08f57077bc652ec370459c2f,"firefox"+a88f1426c4603f2a8cd8bb41e875cb75,"firefox"+b03910cc6de801d2fcfa0c3b9f397df4,"firefox"+bfcc1a3891601edb4f137ab7ab25b840,"firefox"+ce694315cbb81ce95e6ae4ae8cbafde6,"firefox"+f15797a734d0b4f171a86fd35c9a5e43,"firefox"+07b4162d4db57554961824a21c4a0fde,"firefox,thunderbird"+61d0d709fe7ac199ef4b2c52bc8cef75,"firefox,thunderbird"+8498fe4268764dbf926a38283e9d3d8f,"Franz,Google Chrome,Kiwi,Spotify,nwjs,Slack"+900c1fa84b4ea86537e1d148ee16eae8,"Fuze"+107144b88827da5da9ed42d8776ccdc5,"geod"+c46941d4de99445aef6b497679474cf4,"geod"+002205d0f96c37c5e660b9f041363c11,"Google Chrome"+073eede15b2a5a0302d823ecbd5ad15b,"Google Chrome"+0b61c673ee71fe9ee725bd687c455809,"Google Chrome"+6cd1b944f5885e2cfbe98a840b75eeb8,"Google Chrome"+94c485bca29d5392be53f2b8cf7f4304,"Google Chrome"+b4f4e6164f938870486578536fc1ffce,"Google Chrome"+b8f81673c0e1d29908346f3bab892b9b,"Google Chrome"+baaac9b6bf25ad098115c71c59d29e51,"Google Chrome"+bc6c386f480ee97b9d9e52d472b772d8,"Google Chrome"+da949afd9bd6df820730f8f171584a71,"Google Chrome"+f58966d34ff9488a83797b55c804724d,"Google Chrome"+fd6314b03413399e4f23d1524d206692,"Google Chrome"+0e46737668fe75092919ee047a0b5945,"Google Chrome Helper"+39fa85654105398ee7ef6a3a1c81d685,"Google Chrome Helper"+4ba7b7022f5f5e1e500bb19199d8b1a4,"Google Chrome Helper"+5498cef2cca704eb01cf2041cc1089c1,"Google Chrome,Slack"+d27fb8deca6e3b9739db3fda2b229fe3,"Google Drive File Stream"+ae340571b4fd0755c4a0821b18d8fa93,"Google Earth"+f059212ce3de94b1e8253a7522cb1b44,"Google Photos Backup"+fd10cc8cce9493a966c57249e074755f,"gramblr"+3e860202fc555b939e83e7a7ab518c38,"hola_svc"+56ac3a0bef0824c49e4b569941937088,"hola_svc"+5c1c89f930122bccc7a97d52f73bea2c,"hola_svc"+77310efe11f1943306ee317cf02150b7,"hola_svc"+8bd59c4b7f3193db80fd64318429bcec,"hola_svc"+d1f9f9b224387d2597f02095fcec96d7,"hola_svc"+ff1040ba1e3d235855ef0d7cd9237fdc,"hola_svc"+5af143afdbf58ec11ab3b3d53dd4e5e3,"IDSyncDaemon"+d06acbe8ac31e753f40600a9d6717cba,"Inbox OSX"+093081b45872912be9a1f2a8163fe041,"java"+2080bf56cb87e64303e27fcd781e7efd,"java"+225a24b45f0f1adbc2e245d4624c6e08,"java"+3afe1fb5976d0999abe833b14b7d6485,"java"+3b844830bfbb12eb5d2f8dc281d349a9,"java"+51a7ad14509fd614c7bb3a50c4982b8c,"java"+550628650380ff418de25d3d890e836e,"java"+5b270b309ad8c6478586a15dece20a88,"java"+5d7abe53ae15b4272a34f10431e06bf3,"java"+7c7a68b96d2aab15d678497a12119f4f,"java"+88afa0dea1608e28f50acbad32d7f195,"java"+8ce6933b8c12ce931ca238e9420cc5dd,"java"+a61299f9b501adcf680b9275d79d4ac6,"java"+a9fead344bf3ac09f62df3cd9b22c268,"java"+4056657a50a8a4e5cfac40ba48becfa2,"java,eclipse"+f22bdd57e3a52de86cda40da2d84e83b,"java,eclipse,Cyberduck"+028563cffc7a3a2e32090aee0294d636,"java,eclipse,STS"+5f9b53f0d39dc9d940a3b5568fe5f0bb,"java,JavaApplicationStub"+2db6873021f2a95daa7de0d93a1d1bf2,"java,studio,eclipse"+c376061f96329e1020865a1dc726927d,"JavaApplicationStub"+e516ad69a423f8e0407307aa7bfd6344,"Kindle,stack,nextcloud"+3959d0a1344896e9fb5c0564ca0a2956,"LeagueClientUx"+0fe51fa93812c2ebb50a655222a57bf2,"LINE Messaging"+2e094913d88f0ad8dc69447cb7d2ce65,"LINE Messaging"+193349d34561d1d5d1a270172eb2d97e,"LogMeIn Client"+d732ca39155f38942f90e9fc2b0f97f7,"Maxthon"+c9dbeed362a32f9a50a26f4d9b32bbd8,"Messenger,Jumpshare"+6acb250ada693067812c3335705dae79,"mono-sgen,Syncplicity,Axure RP 8,Amazon Drive"+3ee4aaac7147ff2b80ada31686db660c,"node-webkit,Kindle"+641df9d6dbe7fdb74f70c8ad93def8cc,"node.js"+9811c1bb9f0f6835d5c13a831cca4173,"node.js"+106ecbd3d14b4dc6e413494263720afe,"node.js,Postman,WhatsApp"+49de9b1c7e60bd3b8e1d4f7a49ba362e,"nwjs,Chromium"+38cbe70b308f42da7c9980c0e1c89656,"p4v,owncloud"+62448833d8230241227c03b7d441e31b,"parsecd,apple.geod,apple.photomoments,photoanalysisd,FreedomProxy"+e846898acc767ebeb2b4388e58a968d4,"postbox-bin"+a7823092705a5e91ce2b7f561b6e5b98,"Qsync Client"+c048d9f26a79e11ca7276499ef24daf3,"RescueTime,Plantronics Hub"+d219efd07cbb8fbe547e6a5335843f0f,"ruby"+c36fb08942cf19508c08d96af22d4ffc,"Safari"+844166382cc98d98595e6778c470f5d5,"Salesforce Files"+49a341a21f4fd4ac63b027ff2b1a331f,"Skype"+a5aa6e939e4770e3b8ac38ce414fd0d5,"Slack"+116ffc8889873efad60457cd55eaf543,"Spark"+8db4b0f8e9dd8f2fff38ee7c5a1e4496,"SpotlightNetHelper,Safari"+39cf5b7a13a764494de562add874f016,"Steam OSX"+2d3854d1cbcdceece83eabd85bdcc056,"Tableau"+a585c632a2b49be1256881fb0c16c864,"Tableau"+cd7c06b9459c9cfd4af2dba5696ea930,"Tableau"+df65746370dcabc9b4f370c6e14a8156,"True Key"+84071ea96fc8a60c55fc8a405e214c0f,"Used by many desktop apps,Quip,Spotify,GitHub Desktop"+40fd0a5e81ebdcf0ec82a4710a12dec1,"Used by many programs on OSX,apple.WebKit.Networking"+618ee2509ef52bf0b8216e1564eea909,"Used by many programs on OSX,apple.WebKit.Networking"+799135475da362592a4be9199d258726,"Used by many programs on OSX,apple.WebKit.Networking"+7b530a25af9016a9d12de5abc54d9e74,"Used by many programs on OSX,apple.WebKit.Networking"+7e72698146290dd68239f788a452e7d8,"Used by many programs on OSX,apple.WebKit.Networking"+a9aecaa66ad9c6cfe1c361da31768506,"Used by many programs on OSX,apple.WebKit.Networking"+c05de18b01a054f2f6900ffe96b3da7a,"Used by many programs on OSX,apple.WebKit.Networking"+c07cb55f88702033a8f52c046d23e0b2,"Used by many programs on OSX,apple.WebKit.Networking"+e4d448cdfe06dc1243c1eb026c74ac9a,"Used by many programs on OSX,apple.WebKit.Networking"+f1c5cf087b959cec31bd6285407f689a,"Used by many programs on OSX,apple.WebKit.Networking"+488b6b601cb141b062d4da7f524b4b22,"Used by many programs,Python,PHP,Git,dotnet,Adobe"+f28d34ce9e732f644de2350027d74c3f,"Used by many programs,Quip,Aura,Spotify,Chatty"+190dfb280fe3b541acc6a2e5f00690e6,"Used by many programs,Quip,Spotify,Dropbox,GitHub Desktop,etc"+20dd18bdd3209ea718989030a6f93364,"Used by many programs,Slack,Postman,Spotify,Google Chrome"+e0224fc1c33658f2d3d963bfb0a76a85,"Viber"+01319090aea981dde6fc8d6ae71ead54,"vpnkit"+84607748f3887541dd60fe974a042c71,"wineserver"+c2b4710c6888a5d47befe865c8e6fb19,"ZwiftApp"diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/seeds/sslbl-ja3.csv b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/seeds/sslbl-ja3.csvnew file mode 100644index 00000000..92f98f0e--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/seeds/sslbl-ja3.csv@@ -0,0 +1,108 @@+################################################################+# abuse.ch Suricata JA3 Fingerprint Blacklist (CSV) #+# For Suricata 4.1.0 or newer #+# Last updated: 2021-08-03 14:33:44 UTC #+# #+# Terms Of Use: https://sslbl.abuse.ch/blacklist/ #+# For questions please contact sslbl [at] abuse.ch #+################################################################+#+# ja3_md5,Firstseen,Lastseen,Listingreason+b386946a5a44d1ddcc843bc75336dfce,2017-07-14 18:08:15,2019-07-27 20:42:54,Dridex+8991a387e4cc841740f25d6f5139f92d,2017-07-14 19:02:03,2019-07-28 00:34:38,Adware+cb98a24ee4b9134448ffb5714fd870ac,2017-07-14 19:48:28,2019-05-22 03:22:38,Dridex+1aa7bf8b97e540ca5edd75f7b8384bfa,2017-07-14 20:23:38,2019-07-28 01:38:22,TrickBot+3d89c0dfb1fa44911b8fa7523ef8dedb,2017-07-15 04:23:45,2021-02-01 18:23:25,Adware+bc6c386f480ee97b9d9e52d472b772d8,2017-07-15 10:57:38,2021-03-13 07:33:39,Adware+8f52d1ce303fb4a6515836aec3cc16b1,2017-07-15 19:05:11,2019-07-27 20:00:57,TrickBot+d6f04b5a910115f4b50ecec09d40a1df,2017-07-15 19:42:24,2018-10-14 08:12:51,Dridex+35c0a31c481927f022a3b530255ac080,2017-07-15 19:43:19,2021-04-10 12:54:04,Tofsee+e330bca99c8a5256ae126a55c4c725c5,2017-07-15 19:59:29,2021-01-13 00:29:37,Adware+d551fafc4f40f1dec2bb45980bfa9492,2017-07-15 19:59:29,2020-11-16 13:06:20,Adware+83e04bc58d402f9633983cbf22724b02,2017-07-16 01:32:03,2021-03-02 04:07:43,Adware+b8f81673c0e1d29908346f3bab892b9b,2017-07-16 01:32:03,2021-03-02 04:07:36,Adware+70722097d1fe1d78d8c2164640ab6df4,2017-07-16 02:39:08,2021-05-04 09:52:20,Tofsee+9c2589e1c0e9f533a022c6205f9719e1,2017-07-16 08:37:17,2021-07-25 08:33:18,Adware+849b04bdbd1d2b983f6e8a457e0632a8,2017-07-16 08:37:17,2021-07-25 08:33:18,Adware+16efcf0e00504ddfedde13bfea997952,2017-07-16 19:45:45,2020-12-23 15:10:32,Adware+4d7a28d6f2263ed61de88ca66eb011e3,2017-07-16 21:20:29,2020-12-08 18:10:55,Tofsee+550dce18de1bb143e69d6dd9413b8355,2017-07-16 22:17:20,2018-12-21 07:04:50,Adware+c50f6a8b9173676b47ba6085bd0c6cee,2017-07-16 22:38:41,2019-05-21 09:42:17,TrickBot+590a232d04d56409fab72e752a8a2634,2017-07-18 18:53:24,2020-10-11 20:48:33,Tofsee+51a7ad14509fd614c7bb3a50c4982b8c,2017-07-19 07:28:19,2019-07-14 11:58:32,JBifrost+96eba628dcb2b47607192ba74a3b55ba,2017-07-19 18:53:48,2021-07-31 01:48:32,Tofsee+df5c30e670dba99f9270ed36060cf054,2017-07-20 17:44:07,2018-04-11 15:57:59,Tofsee+098f55e27d8c4b0a590102cbdb3a5f3a,2017-07-21 09:52:01,2019-04-08 01:09:54,Adware+29085f03f8e8a03f0b399c5c7cf0b0b8,2017-07-22 14:07:36,2021-04-11 06:42:45,Adware+46efd49abcca8ea9baa932da68fdb529,2017-07-22 14:07:36,2021-04-11 05:54:57,Adware+d7150af4514b868defb854db0f62a441,2017-07-23 09:39:24,2018-07-24 01:04:58,Tofsee+03e186a7f83285e93341de478334006e,2017-07-24 18:17:14,2021-03-20 07:45:40,Tofsee+3cda52da4ade09f1f781ad2e82dcfa20,2017-07-30 18:41:36,2019-05-21 17:34:18,Quakbot+b13d01846ad7a14a70bf030a16775c78,2017-08-08 07:12:49,2021-04-10 00:03:33,Adware+1543a7c46633acf71e8401baccbd0568,2017-08-08 21:32:28,2021-04-08 19:50:46,Tofsee+1d095e68489d3c535297cd8dffb06cb9,2017-08-12 19:56:28,2020-10-28 11:06:23,Tofsee+698e36219f3979420fa2581b21dac7ec,2017-08-28 12:20:47,2020-12-31 02:06:31,Adware+93d056782d649deb51cda44ecb714bb0,2017-08-28 12:20:47,2019-04-15 23:47:27,Adware+1712287800ac91b34cadd5884ce85568,2017-08-28 16:01:59,2021-07-28 14:16:00,TorrentLocker+5e573c9c9f8ba720ef9b18e9fce2e2f7,2017-08-30 13:44:56,2021-03-13 07:33:38,Adware+f6fd83a21f9f3c5f9ff7b5c63bbc179d,2017-10-20 08:03:21,2018-11-06 06:42:12,Adware+92579701f145605e9edc0b01a901c6d5,2017-10-23 00:10:48,2021-07-25 17:07:34,Adware+a61299f9b501adcf680b9275d79d4ac6,2017-11-04 18:03:59,2020-04-21 17:08:24,Tofsee+b2b61db7b9490a60d270ccb20b462826,2017-11-14 20:12:03,2021-06-06 20:27:10,Adware+7dcce5b76c8b17472d024758970a406b,2017-11-22 12:42:46,2021-03-16 12:53:35,Tofsee+534ce2dbc413c68e908363b5df0ae5e0,2017-12-22 09:36:21,2019-07-27 15:22:33,TrickBot+fb00055a1196aeea8d1bc609885ba953,2018-01-01 22:49:25,2019-04-09 06:58:58,TrickBot+a50a861119aceb0ccc74902e8fddb618,2018-01-02 08:16:23,2018-07-05 02:33:08,Tofsee+e7643725fcff971e3051fe0e47fc2c71,2018-01-31 08:06:13,2020-03-25 16:19:48,Tofsee+7c410ce832e848a3321432c9a82e972b,2018-01-31 20:04:25,2021-08-01 06:13:14,Tofsee+da949afd9bd6df820730f8f171584a71,2018-02-03 05:19:37,2021-03-08 22:10:10,Tofsee+906004246f3ba5e755b043c057254a29,2018-03-11 08:25:38,2018-04-14 00:59:16,Tofsee+fd80fa9c6120cdeea8520510f3c644ac,2018-03-11 09:34:30,2021-08-11 12:34:00,Tofsee+b90bdbe961a648f0427db21aaa6ccb59,2018-03-11 10:37:43,2020-05-29 23:39:01,Tofsee+1fe4c7a3544eb27afec2adfb3a3dbf60,2018-03-11 19:23:08,2021-08-09 11:42:58,Tofsee+c201b92f8b483fa388be174d6689f534,2018-03-12 13:43:52,2021-01-28 06:17:06,Gozi+9f62c4f26b90d3d757bea609e82f2eaf,2018-03-13 06:23:41,2021-05-20 23:01:06,Tofsee+1be3ecebe5aa9d3654e6e703d81f6928,2018-03-13 11:50:02,2021-08-11 13:02:35,Ransomware.Troldesh+e3b2ab1f9a56f2fb4c9248f2f41631fa,2018-03-15 01:06:34,2021-07-02 21:51:49,Tofsee+dff8a0aa1c904aaea76c5bf624e88333,2018-03-18 09:41:15,2020-10-27 09:50:24,Tofsee+17fd49722f8d11f3d76dce84f8e099a7,2018-03-19 23:02:27,2021-08-01 00:40:52,Tofsee+911479ac8a0813ed1241b3686ccdade9,2018-03-19 23:24:59,2020-03-30 04:09:18,Tofsee+c5deb9465d47232dd48772f9c4d14679,2018-03-22 15:42:48,2021-03-23 00:34:25,Tofsee+f22bdd57e3a52de86cda40da2d84e83b,2018-03-27 13:40:19,2019-01-20 14:31:39,Tofsee+d18a4da84af59e1108862a39bae7c9d4,2018-04-03 00:40:51,2021-02-06 01:53:12,Tofsee+2d8794cb7b52b777bee2695e79c15760,2018-04-04 06:56:37,2021-07-26 08:07:00,Ransomware+40adfd923eb82b89d8836ba37a19bca1,2018-04-15 15:49:08,2021-04-11 04:42:47,CoinMiner+1aee0238942d453d679fc1e37a303387,2018-05-13 01:59:49,2021-07-30 12:27:07,Tofsee+2092e1fffb45d7e4a19a57f9bc5e203a,2018-05-16 21:59:36,2018-09-05 01:58:33,Adware+bffa4501966196d3d6e90cee1f88fc89,2018-06-07 15:08:04,2020-03-16 00:03:44,Tofsee+807fca46d9d0cf63adf4e5e80e414bbe,2018-06-07 16:51:03,2021-08-07 03:15:42,Tofsee+fb58831f892190644fe44e25bc830b45,2018-06-08 12:07:59,2021-07-20 01:39:05,Adware+0cc1e84568e471aa1d62ad4158ade6b5,2018-06-24 10:50:47,2021-06-21 02:35:57,Tofsee+d2935c58fe676744fecc8614ee5356c7,2018-08-14 21:48:41,2021-08-11 11:54:42,Adwind+8916410db85077a5460817142dcbc8de,2018-08-21 12:32:28,2021-08-11 15:00:50,TrickBot+c5235d3a8b9934b7fbbd204d50bc058d,2018-08-23 17:36:08,2019-10-13 05:11:09,Gootkit+57f3642b4e37e28f5cbe3020c9331b4c,2018-08-28 15:54:53,2021-08-11 13:05:18,Gozi+e62a5f4d538cbf169c2af71bec2399b4,2018-08-30 15:45:40,2021-08-11 09:48:52,TrickBot+51c64c77e60f3980eea90869b68c58a8,2018-08-30 21:04:57,2021-08-11 08:13:08,Dridex+7691297bcb20a41233fd0a0baa0a3628,2018-09-17 02:50:05,2021-08-11 12:20:33,Adware+7dd50e112cd23734a310b90f6f44a7cd,2018-09-17 17:54:58,2021-08-01 11:28:46,Quakbot+52c7396a501e4fecbdfa99c5408334ac,2018-09-18 00:29:04,2019-12-03 17:24:02,Tofsee+fc54e0d16d9764783542f0146a98b300,2018-09-24 12:33:44,2021-08-11 12:51:10,AsyncRAT+f735bbc6b69723b9df7b0e7ef27872af,2018-10-02 18:04:16,2021-08-11 07:25:14,TrickBot+49ed2ef3f1321e5f044f1e71b0e6fdd5,2018-10-02 18:04:17,2021-08-08 22:08:01,TrickBot+d76ee64fb7273733cbe455ac81c292e6,2018-11-16 13:26:39,2018-11-18 19:19:36,Tofsee+8f6c918dcb585ebbea05e2cc94530e3d,2018-11-16 13:26:41,2020-05-06 15:45:21,Tofsee+34f14a69ad7009ca5863379218af17f3,2018-11-17 05:17:22,2021-01-28 08:19:18,Tofsee+c2b4710c6888a5d47befe865c8e6fb19,2018-11-29 20:46:04,2021-08-03 23:37:22,Tofsee+decfb48a53789ebe081b88aabb58ee34,2018-12-21 09:06:16,2021-06-14 05:27:16,Adwind+08a8a4e85b25ac42e1490bc85cfdb5ce,2019-01-30 02:48:34,2020-10-27 09:50:19,Tofsee+c0220cd64849a629397a9cb68f78a0ea,2019-03-24 00:12:32,2021-07-31 00:26:06,Tofsee+7a29c223fb122ec64d10f0a159e07996,2019-06-09 22:55:29,2020-10-27 09:50:26,None+70a04365be5bbd4653698bebeb43ce68,2019-07-02 06:26:56,2020-05-30 04:19:00,Tofsee+d81d654effb94714a4086734fa0adad9,2019-07-16 23:29:02,2020-10-27 09:50:21,Tofsee+25d74b7b4b779eb1efd4b31d26d651c6,2019-08-03 20:15:33,2020-07-14 21:43:25,Tofsee+fc2299d5b2964cd242c5a2c8c531a5f0,2019-08-09 23:56:32,2021-08-11 02:20:22,Tofsee+32926ca3e59f0413d0b98725454594f5,2019-09-12 06:56:10,2021-04-08 19:50:43,Tofsee+ffefafdb86336d057eda5fdf02b3d5ce,2019-10-26 07:31:49,2020-07-25 00:14:09,Tofsee+8515076cbbca9dce33151b798f782456,2020-12-27 16:53:04,2021-08-11 15:06:36,BitRAT+# END (97) entries\ No newline at end of filediff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/detect.rs b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/detect.rsnew file mode 100644index 00000000..cf7404eb--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/detect.rs@@ -0,0 +1,1012 @@+// Β©AngelaMos | 2026+// detect.rs++//! The detection engine: what turns a stream of fingerprints into alerts.+//!+//! Every fingerprint the capture pipeline produces is recorded as an+//! observation, and then six rules read the history around it. The history is+//! the database itself, not an in memory accumulator, so a rule behaves the+//! same whether it is fed a packet capture all at once or a live link one frame+//! at a time, and a long running sensor keeps its memory across restarts.+//!+//! The rules, in the order they are evaluated:+//!+//! - known bad: the fingerprint matches malicious or suspicious intelligence.+//! - User-Agent mismatch: a request calls itself a browser while the same+//! client's TLS fingerprint is a script or a tool. This is the headline, the+//! lie that a fingerprint catches and a User-Agent string cannot tell.+//! - operating-system mismatch: the operating system a User-Agent claims+//! disagrees with the one the client's TCP SYN reveals.+//! - first seen: this exact fingerprint has never been recorded before.+//! - rotation: one address has presented an unusual number of distinct+//! fingerprints, the tell of a client cycling its identity to evade matching.+//! - monoculture: one fingerprint has appeared from an unusual number of+//! distinct addresses, the tell of a botnet built from one toolkit.+//!+//! The two correlation rules look only backwards, at observations already+//! recorded for the same address, so a pair of flows raises one alert when the+//! second of the pair completes the picture, not two.++use anyhow::Result;+use rusqlite::{Connection, params};+use serde::Serialize;+use tlsfp_core::{FingerprintEvent, StreamEvent};++use crate::matcher::{event_fingerprints, match_one};+use crate::model::{Category, FpKind, MatchReport, Severity, Verdict};+use crate::signal::{+ OsClass, ja4t_os_class, label_is_browser, label_is_non_browser, ua_family, ua_os_class,+};++/// How far back the correlation and diversity rules look, in seconds.+const DEFAULT_WINDOW_SECS: i64 = 3600;++/// How many distinct fingerprints from one address, inside the window, count as+/// rotation rather than ordinary repeat visits.+const DEFAULT_ROTATION_THRESHOLD: i64 = 5;++/// How many distinct addresses presenting one fingerprint, inside the window,+/// count as a monoculture rather than a popular client.+const DEFAULT_MONOCULTURE_THRESHOLD: i64 = 10;++const NANOS_PER_SEC: i64 = 1_000_000_000;++/// The thresholds and window the engine runs with. The defaults suit a quiet+/// link; a busy sensor would raise them, and the tests lower them to trip a+/// rule with a handful of events.+#[derive(Debug, Clone, Copy)]+pub struct DetectConfig {+ pub window_secs: i64,+ pub rotation_threshold: i64,+ pub monoculture_threshold: i64,+}++impl Default for DetectConfig {+ fn default() -> Self {+ Self {+ window_secs: DEFAULT_WINDOW_SECS,+ rotation_threshold: DEFAULT_ROTATION_THRESHOLD,+ monoculture_threshold: DEFAULT_MONOCULTURE_THRESHOLD,+ }+ }+}++/// Which rule raised an alert, the first half of its provenance.+#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize)]+#[serde(rename_all = "snake_case")]+pub enum Rule {+ KnownBad,+ UaMismatch,+ OsMismatch,+ FirstSeen,+ FpRotation,+ Monoculture,+}++impl Rule {+ /// The token stored in the database and printed on the CLI.+ pub const fn as_str(self) -> &'static str {+ match self {+ Rule::KnownBad => "known_bad",+ Rule::UaMismatch => "ua_mismatch",+ Rule::OsMismatch => "os_mismatch",+ Rule::FirstSeen => "first_seen",+ Rule::FpRotation => "fp_rotation",+ Rule::Monoculture => "monoculture",+ }+ }++ /// Parses a stored rule token, falling back to first seen for an+ /// unrecognised value so reading the feed never fails on a stray row.+ pub fn from_token(token: &str) -> Self {+ match token {+ "known_bad" => Rule::KnownBad,+ "ua_mismatch" => Rule::UaMismatch,+ "os_mismatch" => Rule::OsMismatch,+ "fp_rotation" => Rule::FpRotation,+ "monoculture" => Rule::Monoculture,+ _ => Rule::FirstSeen,+ }+ }+}++/// How much a human should care, the urgency carried alongside the rule.+#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Serialize)]+#[serde(rename_all = "snake_case")]+pub enum AlertSeverity {+ Info,+ Low,+ Medium,+ High,+ Critical,+}++impl AlertSeverity {+ /// The token stored in the database and printed on the CLI.+ pub const fn as_str(self) -> &'static str {+ match self {+ AlertSeverity::Info => "info",+ AlertSeverity::Low => "low",+ AlertSeverity::Medium => "medium",+ AlertSeverity::High => "high",+ AlertSeverity::Critical => "critical",+ }+ }++ /// Parses a stored severity token, falling back to info for anything+ /// unrecognised so reading the feed never fails on a stray row.+ pub fn from_token(token: &str) -> Self {+ match token {+ "low" => AlertSeverity::Low,+ "medium" => AlertSeverity::Medium,+ "high" => AlertSeverity::High,+ "critical" => AlertSeverity::Critical,+ _ => AlertSeverity::Info,+ }+ }+}++/// One alert: a rule that fired, where, and the evidence that tripped it. The+/// `detail` field is the second half of the provenance, the human readable+/// reason this rule decided what it did.+#[derive(Debug, Clone, Serialize)]+pub struct Alert {+ pub ts_nanos: i64,+ pub rule: Rule,+ pub severity: AlertSeverity,+ #[serde(skip_serializing_if = "Option::is_none")]+ pub ip: Option<String>,+ #[serde(skip_serializing_if = "Option::is_none")]+ pub fp_kind: Option<FpKind>,+ #[serde(skip_serializing_if = "Option::is_none")]+ pub fp_value: Option<String>,+ pub title: String,+ pub detail: String,+ #[serde(skip_serializing_if = "Option::is_none")]+ pub score: Option<f64>,+}++/// The fingerprint kind and value an event is recorded under, the JA4 family+/// member that names the event.+fn primary_fingerprint(event: &StreamEvent) -> (FpKind, String) {+ match event {+ StreamEvent::ClientHello { ja4, .. } => (FpKind::Ja4, ja4.hash.clone()),+ StreamEvent::ServerHello { ja4s, .. } => (FpKind::Ja4s, ja4s.hash.clone()),+ StreamEvent::Certificate { ja4x } => (FpKind::Ja4x, ja4x.clone()),+ StreamEvent::HttpRequest { ja4h, .. } => (FpKind::Ja4h, ja4h.hash.clone()),+ StreamEvent::TcpSyn { ja4t } => (FpKind::Ja4t, ja4t.clone()),+ StreamEvent::TcpSynAck { ja4ts } => (FpKind::Ja4ts, ja4ts.clone()),+ }+}++/// The context fields an event carries beyond its fingerprint: the server name+/// a TLS client asked for, and the host, User-Agent, and claimed operating+/// system an HTTP request declared.+struct Context {+ sni: Option<String>,+ host: Option<String>,+ user_agent: Option<String>,+ os_claim: Option<String>,+}++fn context_of(event: &StreamEvent) -> Context {+ match event {+ StreamEvent::ClientHello { sni, .. } => Context {+ sni: sni.clone(),+ host: None,+ user_agent: None,+ os_claim: None,+ },+ StreamEvent::HttpRequest {+ host, user_agent, ..+ } => {+ let os_claim = user_agent+ .as_deref()+ .and_then(ua_os_class)+ .map(|class| class.as_str().to_string());+ Context {+ sni: None,+ host: host.clone(),+ user_agent: user_agent.clone(),+ os_claim,+ }+ }+ _ => Context {+ sni: None,+ host: None,+ user_agent: None,+ os_claim: None,+ },+ }+}++/// Records one event and returns every alert it raised, all inside the caller's+/// transaction so the observation and its alerts commit together or not at all.+pub(crate) fn run(+ conn: &Connection,+ event: &FingerprintEvent,+ config: &DetectConfig,+) -> Result<Vec<Alert>> {+ let ts = i64::try_from(event.ts_nanos).unwrap_or(i64::MAX);+ let ip_text = event.src.ip().to_string();+ let (kind, value) = primary_fingerprint(&event.event);+ let context = context_of(&event.event);+ let since = ts.saturating_sub(config.window_secs.saturating_mul(NANOS_PER_SEC));++ let reports = lookups(conn, event)?;+ let summary = Summary::from_reports(&reports);++ let mut alerts = Vec::new();++ let fp_known = fp_seen_anywhere(conn, kind, &value)?;+ let ip_fp_known = ip_fp_seen(conn, &ip_text, kind, &value)?;++ correlate_ua_http(conn, &ip_text, since, &context, &mut alerts)?;+ correlate_ua_tls(+ conn,+ &ip_text,+ since,+ kind,+ &value,+ summary.label.as_deref(),+ summary.category,+ &mut alerts,+ )?;+ correlate_os(conn, &ip_text, since, &context, kind, &value, &mut alerts)?;++ let observation_id = insert_observation(conn, ts, &ip_text, kind, &value, &summary, &context)?;++ if let Some(alert) = known_bad(conn, ts, &ip_text, &reports, kind, &value)? {+ alerts.push(alert);+ }++ if !fp_known {+ alerts.push(first_seen(ts, &ip_text, kind, &value, &summary));+ }++ if !ip_fp_known {+ let distinct = distinct_fp_for_ip(conn, &ip_text, kind, since)?;+ if distinct > config.rotation_threshold {+ alerts.push(rotation(ts, &ip_text, kind, distinct, config.window_secs));+ }+ let addresses = distinct_ip_for_fp(conn, kind, &value, since)?;+ if addresses > config.monoculture_threshold {+ alerts.push(monoculture(ts, kind, &value, addresses, config.window_secs));+ }+ }++ for alert in &mut alerts {+ alert.ts_nanos = ts;+ }+ for alert in &alerts {+ persist(conn, alert, observation_id)?;+ }++ Ok(alerts)+}++/// The intelligence reports for every fingerprint the event carries, keeping+/// only the ones that matched something, so the JA3 the public feeds index on+/// is checked alongside the JA4 the event is recorded under.+fn lookups(conn: &Connection, event: &FingerprintEvent) -> Result<Vec<MatchReport>> {+ let mut reports = Vec::new();+ for (kind, value) in event_fingerprints(event) {+ let report = match_one(conn, kind, &value)?;+ if report.has_hits() {+ reports.push(report);+ }+ }+ Ok(reports)+}++/// The most telling thing intelligence said about an event, distilled to one+/// verdict, label, and category for the observation row.+struct Summary {+ verdict: Option<Verdict>,+ label: Option<String>,+ category: Option<Category>,+}++impl Summary {+ /// Picks the worst hit across every report: the highest severity, breaking+ /// ties on match strength, so a malware label wins over a benign collision+ /// and an exact hit wins over a partial one.+ fn from_reports(reports: &[MatchReport]) -> Self {+ let mut best: Option<(u8, f64, Verdict, &str, Category)> = None;+ for report in reports {+ for hit in &report.hits {+ let rank = severity_rank(hit.category.severity());+ let weight = hit.strength.weight();+ let better = match best {+ Some((best_rank, best_weight, ..)) => (rank, weight) > (best_rank, best_weight),+ None => true,+ };+ if better {+ best = Some((+ rank,+ weight,+ report.verdict,+ hit.label.as_str(),+ hit.category,+ ));+ }+ }+ }+ match best {+ Some((_, _, verdict, label, category)) => Self {+ verdict: Some(verdict),+ label: Some(label.to_string()),+ category: Some(category),+ },+ None => Self {+ verdict: None,+ label: None,+ category: None,+ },+ }+ }+}++fn severity_rank(severity: Severity) -> u8 {+ match severity {+ Severity::Malicious => 3,+ Severity::Suspicious => 2,+ Severity::Benign => 1,+ }+}++/// The known bad rule: if any fingerprint matched malicious or suspicious+/// intelligence, raise one alert citing the strongest report and how rare the+/// fingerprint is in what we have seen.+fn known_bad(+ conn: &Connection,+ ts: i64,+ ip: &str,+ reports: &[MatchReport],+ kind: FpKind,+ value: &str,+) -> Result<Option<Alert>> {+ let Some(report) = worst_report(reports) else {+ return Ok(None);+ };+ let severity = match report.verdict {+ Verdict::Malicious => AlertSeverity::High,+ _ => AlertSeverity::Medium,+ };+ let labels = report+ .hits+ .iter()+ .map(|hit| format!("{} ({})", hit.label, hit.source))+ .collect::<Vec<_>>()+ .join(", ");+ let (seen, total) = fp_prevalence(conn, kind, value)?;+ let detail = format!(+ "{} {} matched {}; threat {:.2} confidence {:.2}; {}",+ report.kind.as_str(),+ report.observed,+ labels,+ report.threat_score,+ report.confidence,+ prevalence_phrase(seen, total),+ );+ Ok(Some(Alert {+ ts_nanos: ts,+ rule: Rule::KnownBad,+ severity,+ ip: Some(ip.to_string()),+ fp_kind: Some(kind),+ fp_value: Some(value.to_string()),+ title: format!("fingerprint matches known {} intelligence", report.verdict),+ detail,+ score: Some(report.threat_score),+ }))+}++/// The most severe report worth alerting on, malicious before suspicious and+/// higher threat first, or nothing if every match was benign.+fn worst_report(reports: &[MatchReport]) -> Option<&MatchReport> {+ reports+ .iter()+ .filter(|report| matches!(report.verdict, Verdict::Malicious | Verdict::Suspicious))+ .max_by(|a, b| {+ verdict_rank(a.verdict)+ .cmp(&verdict_rank(b.verdict))+ .then(a.threat_score.total_cmp(&b.threat_score))+ })+}++fn verdict_rank(verdict: Verdict) -> u8 {+ match verdict {+ Verdict::Malicious => 3,+ Verdict::Suspicious => 2,+ Verdict::Benign => 1,+ Verdict::Unknown => 0,+ }+}++/// The User-Agent mismatch rule, evaluated from whichever side of the pair+/// completes it: an HTTP request claiming a browser checked against the+/// address's earlier TLS tool fingerprints, and a TLS tool fingerprint checked+/// against the address's earlier browser claims.+fn correlate_ua_http(+ conn: &Connection,+ ip: &str,+ since: i64,+ context: &Context,+ alerts: &mut Vec<Alert>,+) -> Result<()> {+ let Some(user_agent) = &context.user_agent else {+ return Ok(());+ };+ let Some(claimed) = ua_family(user_agent) else {+ return Ok(());+ };+ if !claimed.is_browser() {+ return Ok(());+ }+ for (fp_kind, fp_value, label, category) in prior_tls_labels(conn, ip, since)? {+ if label_is_non_browser(&label, category) && !label_is_browser(&label) {+ alerts.push(ua_mismatch_alert(+ ip,+ claimed.as_str(),+ user_agent,+ &fp_kind,+ &fp_value,+ &label,+ category,+ ));+ break;+ }+ }+ Ok(())+}++/// The TLS side of the User-Agent mismatch rule: when the event being recorded+/// is itself a non-browser TLS fingerprint, look back for a browser claim from+/// the same address.+#[allow(clippy::too_many_arguments)]+fn correlate_ua_tls(+ conn: &Connection,+ ip: &str,+ since: i64,+ kind: FpKind,+ value: &str,+ label: Option<&str>,+ category: Option<Category>,+ alerts: &mut Vec<Alert>,+) -> Result<()> {+ if !matches!(kind, FpKind::Ja3 | FpKind::Ja4) {+ return Ok(());+ }+ let (Some(label), Some(category)) = (label, category) else {+ return Ok(());+ };+ if !label_is_non_browser(label, category) || label_is_browser(label) {+ return Ok(());+ }+ for user_agent in prior_browser_uas(conn, ip, since)? {+ if let Some(claimed) = ua_family(&user_agent) {+ if claimed.is_browser() {+ alerts.push(ua_mismatch_alert(+ ip,+ claimed.as_str(),+ &user_agent,+ kind.as_str(),+ value,+ label,+ category,+ ));+ break;+ }+ }+ }+ Ok(())+}++#[allow(clippy::too_many_arguments)]+fn ua_mismatch_alert(+ ip: &str,+ claimed: &str,+ user_agent: &str,+ fp_kind: &str,+ fp_value: &str,+ label: &str,+ category: Category,+) -> Alert {+ Alert {+ ts_nanos: 0,+ rule: Rule::UaMismatch,+ severity: AlertSeverity::High,+ ip: Some(ip.to_string()),+ fp_kind: FpKind::from_token(fp_kind),+ fp_value: Some(fp_value.to_string()),+ title: format!("User-Agent claims {claimed} but the TLS fingerprint is not a browser"),+ detail: format!(+ "address {ip} sent User-Agent '{user_agent}' yet presented {fp_kind} {fp_value}, known as {label} ({}); a real {claimed} does not produce a {label} handshake",+ category.as_str(),+ ),+ score: None,+ }+}++/// The operating-system mismatch rule, evaluated from whichever side completes+/// it: an HTTP claim checked against the address's earlier SYN, and a SYN+/// checked against the address's earlier HTTP claim.+fn correlate_os(+ conn: &Connection,+ ip: &str,+ since: i64,+ context: &Context,+ kind: FpKind,+ value: &str,+ alerts: &mut Vec<Alert>,+) -> Result<()> {+ if let Some(user_agent) = &context.user_agent {+ let Some(claimed) = ua_os_class(user_agent) else {+ return Ok(());+ };+ for ja4t in prior_ja4t(conn, ip, since)? {+ if let Some(observed) = ja4t_os_class(&ja4t) {+ if observed != claimed {+ alerts.push(os_mismatch_alert(+ ip,+ claimed.as_str(),+ observed.as_str(),+ &ja4t,+ user_agent,+ ));+ break;+ }+ }+ }+ return Ok(());+ }++ if matches!(kind, FpKind::Ja4t) {+ if let Some(observed) = ja4t_os_class(value) {+ for (user_agent, os_claim) in prior_os_claims(conn, ip, since)? {+ if let Some(claimed) = OsClass::from_token(&os_claim) {+ if claimed != observed {+ alerts.push(os_mismatch_alert(+ ip,+ claimed.as_str(),+ observed.as_str(),+ value,+ &user_agent,+ ));+ break;+ }+ }+ }+ }+ }+ Ok(())+}++fn os_mismatch_alert(+ ip: &str,+ claimed: &str,+ observed: &str,+ ja4t: &str,+ user_agent: &str,+) -> Alert {+ Alert {+ ts_nanos: 0,+ rule: Rule::OsMismatch,+ severity: AlertSeverity::Medium,+ ip: Some(ip.to_string()),+ fp_kind: Some(FpKind::Ja4t),+ fp_value: Some(ja4t.to_string()),+ title: format!("User-Agent claims {claimed} but the TCP stack looks like {observed}"),+ detail: format!(+ "address {ip} sent User-Agent '{user_agent}' claiming {claimed}, but its SYN fingerprint {ja4t} matches a {observed} TCP stack",+ ),+ score: None,+ }+}++fn first_seen(ts: i64, ip: &str, kind: FpKind, value: &str, summary: &Summary) -> Alert {+ let known = match &summary.label {+ Some(label) => format!(", known as {label}"),+ None => String::new(),+ };+ Alert {+ ts_nanos: ts,+ rule: Rule::FirstSeen,+ severity: AlertSeverity::Info,+ ip: Some(ip.to_string()),+ fp_kind: Some(kind),+ fp_value: Some(value.to_string()),+ title: format!(+ "first time this {} fingerprint has been seen",+ kind.as_str()+ ),+ detail: format!(+ "{} {value} recorded for the first time{known}",+ kind.as_str()+ ),+ score: None,+ }+}++fn rotation(ts: i64, ip: &str, kind: FpKind, distinct: i64, window_secs: i64) -> Alert {+ Alert {+ ts_nanos: ts,+ rule: Rule::FpRotation,+ severity: AlertSeverity::Medium,+ ip: Some(ip.to_string()),+ fp_kind: Some(kind),+ fp_value: None,+ title: format!("address is rotating {} fingerprints", kind.as_str()),+ detail: format!(+ "address {ip} presented {distinct} distinct {} fingerprints within {window_secs}s, more than a single client explains",+ kind.as_str(),+ ),+ score: None,+ }+}++fn monoculture(ts: i64, kind: FpKind, value: &str, addresses: i64, window_secs: i64) -> Alert {+ Alert {+ ts_nanos: ts,+ rule: Rule::Monoculture,+ severity: AlertSeverity::Medium,+ ip: None,+ fp_kind: Some(kind),+ fp_value: Some(value.to_string()),+ title: format!("one {} fingerprint spans many addresses", kind.as_str()),+ detail: format!(+ "{} {value} appeared from {addresses} distinct addresses within {window_secs}s, the shape of a single toolkit run widely",+ kind.as_str(),+ ),+ score: None,+ }+}++fn prevalence_phrase(seen: i64, total: i64) -> String {+ if total <= 0 {+ return "prevalence unknown".to_string();+ }+ let pct = 100.0 * f64_of(seen) / f64_of(total);+ format!("prevalence {pct:.1}% ({seen}/{total} observations)")+}++/// Converts an observation count to a float for the prevalence percentage. A+/// non negative integer is exact in an f64 up to two to the fifty third, far+/// more rows than any observation table holds, so the precision the lint warns+/// about is never actually lost here.+#[allow(clippy::cast_precision_loss)]+fn f64_of(n: i64) -> f64 {+ n.max(0) as f64+}++fn fp_seen_anywhere(conn: &Connection, kind: FpKind, value: &str) -> Result<bool> {+ let exists: i64 = conn.query_row(+ "SELECT EXISTS(SELECT 1 FROM observation WHERE fp_kind = ?1 AND fp_value = ?2)",+ params![kind.as_str(), value],+ |row| row.get(0),+ )?;+ Ok(exists == 1)+}++fn ip_fp_seen(conn: &Connection, ip: &str, kind: FpKind, value: &str) -> Result<bool> {+ let exists: i64 = conn.query_row(+ "SELECT EXISTS(SELECT 1 FROM observation WHERE ip = ?1 AND fp_kind = ?2 AND fp_value = ?3)",+ params![ip, kind.as_str(), value],+ |row| row.get(0),+ )?;+ Ok(exists == 1)+}++fn distinct_fp_for_ip(conn: &Connection, ip: &str, kind: FpKind, since: i64) -> Result<i64> {+ let count: i64 = conn.query_row(+ "SELECT count(DISTINCT fp_value) FROM observation+ WHERE ip = ?1 AND fp_kind = ?2 AND ts >= ?3",+ params![ip, kind.as_str(), since],+ |row| row.get(0),+ )?;+ Ok(count)+}++fn distinct_ip_for_fp(conn: &Connection, kind: FpKind, value: &str, since: i64) -> Result<i64> {+ let count: i64 = conn.query_row(+ "SELECT count(DISTINCT ip) FROM observation+ WHERE fp_kind = ?1 AND fp_value = ?2 AND ts >= ?3",+ params![kind.as_str(), value, since],+ |row| row.get(0),+ )?;+ Ok(count)+}++fn fp_prevalence(conn: &Connection, kind: FpKind, value: &str) -> Result<(i64, i64)> {+ let seen: i64 = conn.query_row(+ "SELECT count(*) FROM observation WHERE fp_kind = ?1 AND fp_value = ?2",+ params![kind.as_str(), value],+ |row| row.get(0),+ )?;+ let total: i64 = conn.query_row("SELECT count(*) FROM observation", [], |row| row.get(0))?;+ Ok((seen, total))+}++fn prior_tls_labels(+ conn: &Connection,+ ip: &str,+ since: i64,+) -> Result<Vec<(String, String, String, Category)>> {+ let mut statement = conn.prepare(+ "SELECT fp_kind, fp_value, label, category FROM observation+ WHERE ip = ?1 AND fp_kind IN ('ja3', 'ja4') AND label IS NOT NULL AND ts >= ?2+ ORDER BY ts DESC",+ )?;+ let rows = statement+ .query_map(params![ip, since], |row| {+ let kind: String = row.get(0)?;+ let value: String = row.get(1)?;+ let label: String = row.get(2)?;+ let category: String = row.get(3)?;+ Ok((kind, value, label, category))+ })?+ .collect::<rusqlite::Result<Vec<_>>>()?;+ Ok(rows+ .into_iter()+ .map(|(kind, value, label, category)| (kind, value, label, Category::from_token(&category)))+ .collect())+}++fn prior_browser_uas(conn: &Connection, ip: &str, since: i64) -> Result<Vec<String>> {+ let mut statement = conn.prepare(+ "SELECT user_agent FROM observation+ WHERE ip = ?1 AND fp_kind = 'ja4h' AND user_agent IS NOT NULL AND ts >= ?2+ ORDER BY ts DESC",+ )?;+ let rows = statement+ .query_map(params![ip, since], |row| row.get::<_, String>(0))?+ .collect::<rusqlite::Result<Vec<_>>>()?;+ Ok(rows)+}++fn prior_ja4t(conn: &Connection, ip: &str, since: i64) -> Result<Vec<String>> {+ let mut statement = conn.prepare(+ "SELECT fp_value FROM observation+ WHERE ip = ?1 AND fp_kind = 'ja4t' AND ts >= ?2+ ORDER BY ts DESC",+ )?;+ let rows = statement+ .query_map(params![ip, since], |row| row.get::<_, String>(0))?+ .collect::<rusqlite::Result<Vec<_>>>()?;+ Ok(rows)+}++fn prior_os_claims(conn: &Connection, ip: &str, since: i64) -> Result<Vec<(String, String)>> {+ let mut statement = conn.prepare(+ "SELECT user_agent, os_claim FROM observation+ WHERE ip = ?1 AND fp_kind = 'ja4h' AND os_claim IS NOT NULL AND ts >= ?2+ ORDER BY ts DESC",+ )?;+ let rows = statement+ .query_map(params![ip, since], |row| {+ let user_agent: Option<String> = row.get(0)?;+ let os_claim: String = row.get(1)?;+ Ok((user_agent.unwrap_or_default(), os_claim))+ })?+ .collect::<rusqlite::Result<Vec<_>>>()?;+ Ok(rows)+}++#[allow(clippy::too_many_arguments)]+fn insert_observation(+ conn: &Connection,+ ts: i64,+ ip: &str,+ kind: FpKind,+ value: &str,+ summary: &Summary,+ context: &Context,+) -> Result<i64> {+ conn.execute(+ "INSERT INTO observation+ (ts, ip, fp_kind, fp_value, verdict, label, category, sni, host, user_agent, os_claim)+ VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9, ?10, ?11)",+ params![+ ts,+ ip,+ kind.as_str(),+ value,+ summary.verdict.map(Verdict::as_str),+ summary.label,+ summary.category.map(Category::as_str),+ context.sni,+ context.host,+ context.user_agent,+ context.os_claim,+ ],+ )?;+ Ok(conn.last_insert_rowid())+}++fn persist(conn: &Connection, alert: &Alert, observation_id: i64) -> Result<()> {+ let observation_id = match alert.rule {+ Rule::Monoculture => None,+ _ => Some(observation_id),+ };+ conn.execute(+ "INSERT INTO alert+ (ts, rule, severity, ip, fp_kind, fp_value, title, detail, score, observation_id)+ VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9, ?10)",+ params![+ alert.ts_nanos,+ alert.rule.as_str(),+ alert.severity.as_str(),+ alert.ip,+ alert.fp_kind.map(FpKind::as_str),+ alert.fp_value,+ alert.title,+ alert.detail,+ alert.score,+ observation_id,+ ],+ )?;+ Ok(())+}++/// The most recent alerts, newest first, for the CLI feed and the dashboard.+pub(crate) fn recent(conn: &Connection, limit: i64) -> Result<Vec<Alert>> {+ let mut statement = conn.prepare(+ "SELECT ts, rule, severity, ip, fp_kind, fp_value, title, detail, score+ FROM alert ORDER BY ts DESC, id DESC LIMIT ?1",+ )?;+ let rows = statement+ .query_map(params![limit], |row| {+ let rule: String = row.get(1)?;+ let severity: String = row.get(2)?;+ let fp_kind: Option<String> = row.get(4)?;+ Ok(Alert {+ ts_nanos: row.get(0)?,+ rule: Rule::from_token(&rule),+ severity: AlertSeverity::from_token(&severity),+ ip: row.get(3)?,+ fp_kind: fp_kind.and_then(|token| FpKind::from_token(&token)),+ fp_value: row.get(5)?,+ title: row.get(6)?,+ detail: row.get(7)?,+ score: row.get(8)?,+ })+ })?+ .collect::<rusqlite::Result<Vec<_>>>()?;+ Ok(rows)+}++/// A small count of alerts per rule, for the stats summary.+pub(crate) fn counts_by_rule(conn: &Connection) -> Result<Vec<(Rule, i64)>> {+ let mut statement =+ conn.prepare("SELECT rule, count(*) FROM alert GROUP BY rule ORDER BY count(*) DESC")?;+ let rows = statement+ .query_map([], |row| {+ let rule: String = row.get(0)?;+ let count: i64 = row.get(1)?;+ Ok((Rule::from_token(&rule), count))+ })?+ .collect::<rusqlite::Result<Vec<_>>>()?;+ Ok(rows)+}++#[cfg(test)]+mod tests {+ use super::{+ AlertSeverity, Rule, Summary, prevalence_phrase, severity_rank, verdict_rank, worst_report,+ };+ use crate::model::{Category, FpKind, IntelHit, MatchReport, MatchStrength, Severity, Verdict};++ fn hit(category: Category, strength: MatchStrength, label: &str) -> IntelHit {+ IntelHit {+ kind: FpKind::Ja4,+ value: "v".into(),+ label: label.into(),+ category,+ source: "feed".into(),+ reference: None,+ strength,+ }+ }++ #[test]+ fn summary_keeps_the_worst_hit() {+ let report = MatchReport::from_hits(+ FpKind::Ja4,+ "x".into(),+ vec![+ hit(Category::Benign, MatchStrength::Exact, "java"),+ hit(Category::Malware, MatchStrength::Exact, "TrickBot"),+ ],+ );+ let summary = Summary::from_reports(&[report]);+ assert_eq!(summary.category, Some(Category::Malware));+ assert_eq!(summary.label.as_deref(), Some("TrickBot"));+ }++ #[test]+ fn summary_of_nothing_is_empty() {+ let summary = Summary::from_reports(&[]);+ assert!(summary.verdict.is_none());+ assert!(summary.label.is_none());+ assert!(summary.category.is_none());+ }++ #[test]+ fn worst_report_ignores_benign_and_prefers_malicious() {+ let benign = MatchReport::from_hits(+ FpKind::Ja4,+ "x".into(),+ vec![hit(Category::Benign, MatchStrength::Exact, "Chrome")],+ );+ assert!(worst_report(std::slice::from_ref(&benign)).is_none());++ let malicious = MatchReport::from_hits(+ FpKind::Ja3,+ "y".into(),+ vec![hit(Category::Malware, MatchStrength::Exact, "Bad")],+ );+ let suspicious = MatchReport::from_hits(+ FpKind::Ja4,+ "z".into(),+ vec![hit(Category::Tool, MatchStrength::Exact, "Tool")],+ );+ let reports = [benign, suspicious, malicious];+ let chosen = worst_report(&reports).unwrap();+ assert_eq!(chosen.verdict, Verdict::Malicious);+ }++ #[test]+ fn prevalence_phrase_handles_empty_and_normal() {+ assert_eq!(prevalence_phrase(0, 0), "prevalence unknown");+ assert_eq!(+ prevalence_phrase(1, 4),+ "prevalence 25.0% (1/4 observations)"+ );+ }++ #[test]+ fn rank_helpers_order_correctly() {+ assert!(severity_rank(Severity::Malicious) > severity_rank(Severity::Suspicious));+ assert!(severity_rank(Severity::Suspicious) > severity_rank(Severity::Benign));+ assert!(verdict_rank(Verdict::Malicious) > verdict_rank(Verdict::Benign));+ assert!(verdict_rank(Verdict::Benign) > verdict_rank(Verdict::Unknown));+ }++ #[test]+ fn alert_severity_is_ordered() {+ assert!(AlertSeverity::Critical > AlertSeverity::High);+ assert!(AlertSeverity::High > AlertSeverity::Medium);+ assert!(AlertSeverity::Medium > AlertSeverity::Low);+ assert!(AlertSeverity::Low > AlertSeverity::Info);+ }++ #[test]+ fn rule_tokens_round_trip() {+ for rule in [+ Rule::KnownBad,+ Rule::UaMismatch,+ Rule::OsMismatch,+ Rule::FirstSeen,+ Rule::FpRotation,+ Rule::Monoculture,+ ] {+ assert_eq!(Rule::from_token(rule.as_str()), rule);+ }+ assert_eq!(Rule::from_token("garbage"), Rule::FirstSeen);+ }++ #[test]+ fn severity_tokens_round_trip() {+ for severity in [+ AlertSeverity::Info,+ AlertSeverity::Low,+ AlertSeverity::Medium,+ AlertSeverity::High,+ AlertSeverity::Critical,+ ] {+ assert_eq!(AlertSeverity::from_token(severity.as_str()), severity);+ }+ assert_eq!(AlertSeverity::from_token("garbage"), AlertSeverity::Info);+ }+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/import.rs b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/import.rsnew file mode 100644index 00000000..50203c5b--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/import.rs@@ -0,0 +1,321 @@+// Β©AngelaMos | 2026+// import.rs++//! Importing the ja4db.com enrichment feed.+//!+//! Unlike the three bundled feeds, ja4db is fetched at install time rather than+//! committed, because its licence is unspecified and the install script is the+//! honest place to pull it. Its records are also known to be dirty: the upstream+//! project tracks an issue where some fingerprint fields hold placeholders or+//! truncated values. So every fingerprint is validated for its kind before it+//! goes in, and the count of rejected rows is reported rather than hidden.+//!+//! The payload is read as untyped JSON rather than a fixed struct. ja4db is a+//! community database whose shape drifts, and a parser that demands an exact+//! schema would reject the whole file the day a field is renamed. Reading each+//! record as a map of optional fields keeps the importer working across those+//! changes and is itself the tolerance the dirty data calls for.+//!+//! ja4db identifies applications, so a record is treated as benign unless its+//! own classification fields name it as malicious. That makes ja4db the benign+//! baseline that the malicious feeds are weighed against, without silently+//! relabelling the handful of malware entries it does carry.++use anyhow::{Context, Result};+use rusqlite::Connection;+use serde_json::Value;++use super::model::{Category, FpKind};+use super::{NewFingerprint, get_or_create_source, insert_fingerprint, refresh_source_count};++const SOURCE_NAME: &str = "ja4db.com";+const SOURCE_URL: &str = "https://ja4db.com/api/read/";++/// The JSON field that carries each fingerprint kind in a ja4db record.+const FIELDS: &[(&str, FpKind)] = &[+ ("ja4_fingerprint", FpKind::Ja4),+ ("ja4s_fingerprint", FpKind::Ja4s),+ ("ja4h_fingerprint", FpKind::Ja4h),+ ("ja4x_fingerprint", FpKind::Ja4x),+ ("ja4t_fingerprint", FpKind::Ja4t),+ ("ja4ts_fingerprint", FpKind::Ja4ts),+];++/// What one import run did.+#[derive(Debug, Clone)]+pub struct ImportSummary {+ pub records: usize,+ pub imported: usize,+ pub skipped: usize,+}++/// Imports a ja4db `/api/read/` JSON array, validating every fingerprint.+pub fn import_ja4db(conn: &mut Connection, json: &str) -> Result<ImportSummary> {+ let payload: Value = serde_json::from_str(json).context("parsing ja4db JSON")?;+ let records = payload+ .as_array()+ .context("ja4db payload is not a JSON array")?;++ let tx = conn.transaction()?;+ let source_id = get_or_create_source(+ &tx,+ SOURCE_NAME,+ Some(SOURCE_URL),+ Some("unspecified"),+ "fetched",+ )?;++ let mut imported = 0;+ let mut skipped = 0;+ for record in records {+ let category = classify(record);+ let label = build_label(record);+ let reference = build_reference(record);+ for (field, kind) in FIELDS {+ let Some(raw) = record.get(field).and_then(Value::as_str) else {+ continue;+ };+ let value = raw.trim();+ if value.is_empty() {+ continue;+ }+ if !valid_fingerprint(*kind, value) {+ skipped += 1;+ continue;+ }+ if insert_fingerprint(+ &tx,+ source_id,+ &NewFingerprint {+ kind: *kind,+ value,+ label: &label,+ category,+ reference: reference.as_deref(),+ first_seen: None,+ },+ )? {+ imported += 1;+ }+ }+ }+ refresh_source_count(&tx, source_id)?;+ tx.commit()?;++ Ok(ImportSummary {+ records: records.len(),+ imported,+ skipped,+ })+}++/// Builds a display label from the application, library, or device, with the+/// operating system in parentheses when ja4db knows it.+fn build_label(record: &Value) -> String {+ let primary = ["application", "library", "device"]+ .into_iter()+ .filter_map(|key| record.get(key).and_then(Value::as_str))+ .map(str::trim)+ .find(|name| !name.is_empty());+ let os = record+ .get("os")+ .and_then(Value::as_str)+ .map(str::trim)+ .filter(|name| !name.is_empty());+ match (primary, os) {+ (Some(name), Some(os)) => format!("{name} ({os})"),+ (Some(name), None) => name.to_string(),+ (None, Some(os)) => os.to_string(),+ (None, None) => "unknown".to_string(),+ }+}++/// Picks a human readable reference for a record, preferring the user agent+/// string and falling back to free form notes.+fn build_reference(record: &Value) -> Option<String> {+ for key in ["user_agent_string", "notes"] {+ if let Some(text) = record.get(key).and_then(Value::as_str) {+ let text = text.trim();+ if !text.is_empty() {+ return Some(text.to_string());+ }+ }+ }+ None+}++/// Classifies a record as benign unless one of its classification fields names+/// it as malicious. Identity fields like the application name are deliberately+/// not scanned, so an app that merely has an alarming name is not relabelled.+fn classify(record: &Value) -> Category {+ const MALICIOUS: &[&str] = &[+ "malware",+ "malicious",+ "trojan",+ "botnet",+ "ransomware",+ "stealer",+ "cobalt strike",+ "backdoor",+ "command and control",+ ];+ let mut text = String::new();+ for key in ["notes", "classification", "comment", "tags", "category"] {+ if let Some(value) = record.get(key).and_then(Value::as_str) {+ text.push_str(&value.to_ascii_lowercase());+ text.push(' ');+ }+ }+ if MALICIOUS.iter().any(|needle| text.contains(needle)) {+ Category::Malware+ } else {+ Category::Benign+ }+}++/// Whether a value has the right shape for its fingerprint kind. The checks are+/// loose enough to admit real data and strict enough to reject the placeholders+/// and truncations that the dirty ja4db rows are made of.+fn valid_fingerprint(kind: FpKind, value: &str) -> bool {+ match kind {+ FpKind::Ja3 | FpKind::Ja3s => is_hex(value, 32),+ FpKind::Ja4 => {+ let parts = value.split('_').collect::<Vec<_>>();+ parts.len() == 3+ && is_prefix(parts[0], 8, 12)+ && is_hex(parts[1], 12)+ && is_hex(parts[2], 12)+ }+ FpKind::Ja4s => {+ let parts = value.split('_').collect::<Vec<_>>();+ parts.len() == 3+ && is_prefix(parts[0], 5, 9)+ && is_hex_between(parts[1], 2, 8)+ && is_hex(parts[2], 12)+ }+ FpKind::Ja4x => {+ let parts = value.split('_').collect::<Vec<_>>();+ parts.len() == 3 && parts.iter().all(|part| is_hex(part, 12))+ }+ FpKind::Ja4t | FpKind::Ja4ts => {+ let parts = value.split('_').collect::<Vec<_>>();+ (2..=4).contains(&parts.len())+ && !parts[0].is_empty()+ && parts[0].bytes().all(|byte| byte.is_ascii_digit())+ }+ FpKind::Ja4h => {+ let parts = value.split('_').collect::<Vec<_>>();+ parts.len() >= 2+ && parts[0].len() >= 8+ && parts[0].bytes().all(|byte| byte.is_ascii_alphanumeric())+ }+ }+}++fn is_hex(value: &str, len: usize) -> bool {+ value.len() == len && value.bytes().all(|byte| byte.is_ascii_hexdigit())+}++fn is_hex_between(value: &str, min: usize, max: usize) -> bool {+ (min..=max).contains(&value.len()) && value.bytes().all(|byte| byte.is_ascii_hexdigit())+}++fn is_prefix(value: &str, min: usize, max: usize) -> bool {+ (min..=max).contains(&value.len())+ && matches!(value.as_bytes().first(), Some(b't' | b'q' | b'd'))+ && value.bytes().all(|byte| byte.is_ascii_alphanumeric())+}++#[cfg(test)]+mod tests {+ use crate::IntelStore;+ use crate::model::{FpKind, Verdict};++ const SAMPLE: &str = r#"[+ {"application":"Chrome","os":"Windows","ja4_fingerprint":"t13d1516h2_8daaf6152771_e5627efa2ab1","user_agent_string":"Mozilla/5.0"},+ {"application":"curl","library":"OpenSSL","ja4_fingerprint":"t13d1234h1_aaaaaaaaaaaa_bbbbbbbbbbbb"},+ {"application":"Loader","notes":"known malware stealer","ja4_fingerprint":"t10d070600_c50f5591e341_1a3805c3aa63"},+ {"application":"Dirty","ja4_fingerprint":"GREASE"},+ {"application":"NoFp","ja4_fingerprint":null},+ {"application":"Server","ja4s_fingerprint":"t130200_1301_234ea6891581"}+ ]"#;++ #[test]+ fn imports_valid_rows_and_counts_dirty_ones() {+ let mut store = IntelStore::open_in_memory().unwrap();+ let summary = store.import_ja4db(SAMPLE).unwrap();+ assert_eq!(summary.records, 6);+ assert_eq!(summary.imported, 4);+ assert_eq!(summary.skipped, 1);+ }++ #[test]+ fn re_importing_adds_nothing_new() {+ let mut store = IntelStore::open_in_memory().unwrap();+ store.import_ja4db(SAMPLE).unwrap();+ let second = store.import_ja4db(SAMPLE).unwrap();+ assert_eq!(second.imported, 0);+ assert_eq!(second.skipped, 1);+ }++ #[test]+ fn classification_field_marks_malware() {+ let mut store = IntelStore::open_in_memory().unwrap();+ store.import_ja4db(SAMPLE).unwrap();+ let report = store+ .match_fingerprint(FpKind::Ja4, "t10d070600_c50f5591e341_1a3805c3aa63")+ .unwrap();+ assert_eq!(report.verdict, Verdict::Malicious);+ }++ #[test]+ fn identified_application_is_benign() {+ let mut store = IntelStore::open_in_memory().unwrap();+ store.import_ja4db(SAMPLE).unwrap();+ let report = store+ .match_fingerprint(FpKind::Ja4, "t13d1516h2_8daaf6152771_e5627efa2ab1")+ .unwrap();+ assert_eq!(report.verdict, Verdict::Benign);+ assert!(+ report+ .hits+ .iter()+ .any(|hit| hit.label == "Chrome (Windows)")+ );+ }++ #[test]+ fn a_non_array_payload_is_an_error() {+ let mut store = IntelStore::open_in_memory().unwrap();+ assert!(store.import_ja4db("{}").is_err());+ assert!(store.import_ja4db("not json").is_err());+ }++ #[test]+ fn an_empty_array_imports_nothing() {+ let mut store = IntelStore::open_in_memory().unwrap();+ let summary = store.import_ja4db("[]").unwrap();+ assert_eq!(summary.records, 0);+ assert_eq!(summary.imported, 0);+ }++ #[test]+ fn validators_reject_placeholders() {+ use super::valid_fingerprint;+ assert!(valid_fingerprint(+ FpKind::Ja4,+ "t13d1516h2_8daaf6152771_e5627efa2ab1"+ ));+ assert!(!valid_fingerprint(FpKind::Ja4, "GREASE"));+ assert!(!valid_fingerprint(+ FpKind::Ja4,+ "t13d1516h2_short_e5627efa2ab1"+ ));+ assert!(!valid_fingerprint(FpKind::Ja4, ""));+ assert!(valid_fingerprint(+ FpKind::Ja3,+ "1aa7bf8b97e540ca5edd75f7b8384bfa"+ ));+ assert!(!valid_fingerprint(FpKind::Ja3, "N/A"));+ }+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/lib.rs b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/lib.rsnew file mode 100644index 00000000..81c851c6--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/lib.rs@@ -0,0 +1,339 @@+// Β©AngelaMos | 2026+// lib.rs++//! The local threat intelligence store.+//!+//! This is the half of the tool that turns a fingerprint into a judgement. It+//! owns a bundled SQLite database, seeds it from three vendored feeds, can pull+//! a fourth feed at install time, and answers the one question the rest of the+//! tool cares about: is this fingerprint known, and is it known to be bad.+//!+//! The store is deliberately synchronous. The capture pipeline that feeds it is+//! a plain loop, and a lookup is a single indexed query, so wrapping it in an+//! async runtime would buy nothing here. The web server, when it arrives, is+//! the place that needs concurrent access, and that is where an async wrapper+//! belongs.++mod detect;+mod import;+mod matcher;+mod model;+mod schema;+mod seed;+mod signal;++use std::path::{Path, PathBuf};+use std::time::{SystemTime, UNIX_EPOCH};++use anyhow::{Context, Result};+use rusqlite::{Connection, params};+use serde::Serialize;+use tlsfp_core::FingerprintEvent;++pub use detect::{Alert, AlertSeverity, DetectConfig, Rule};+pub use import::ImportSummary;+pub use model::{Category, FpKind, IntelHit, MatchReport, MatchStrength, Verdict};+pub use seed::{FeedLoad, SeedSummary};++/// A handle to the open intelligence database.+pub struct IntelStore {+ conn: Connection,+}++impl IntelStore {+ /// Opens or creates the database at `path`, creating any missing parent+ /// directories and bringing the schema up to date.+ pub fn open(path: &Path) -> Result<Self> {+ if let Some(parent) = path.parent() {+ if !parent.as_os_str().is_empty() {+ std::fs::create_dir_all(parent)+ .with_context(|| format!("creating database directory {}", parent.display()))?;+ }+ }+ let conn = Connection::open(path)+ .with_context(|| format!("opening database {}", path.display()))?;+ conn.execute_batch("PRAGMA foreign_keys = ON; PRAGMA journal_mode = WAL;")?;+ Self::migrate(conn)+ }++ /// Opens a private in memory database, used by tests and by commands that+ /// only need a scratch store.+ pub fn open_in_memory() -> Result<Self> {+ let conn = Connection::open_in_memory()?;+ conn.execute_batch("PRAGMA foreign_keys = ON;")?;+ Self::migrate(conn)+ }++ fn migrate(mut conn: Connection) -> Result<Self> {+ schema::apply_migrations(&mut conn).context("applying schema migrations")?;+ Ok(Self { conn })+ }++ /// Loads the three vendored feeds, skipping rows already present so a second+ /// call changes nothing.+ pub fn seed_bundled(&mut self) -> Result<SeedSummary> {+ seed::load_bundled(&mut self.conn)+ }++ /// Imports a ja4db.com `/api/read/` JSON payload, validating each+ /// fingerprint and reporting how many rows were kept and skipped.+ pub fn import_ja4db(&mut self, json: &str) -> Result<ImportSummary> {+ import::import_ja4db(&mut self.conn, json)+ }++ /// Looks up one fingerprint and scores the hits into a verdict.+ pub fn match_fingerprint(&self, kind: FpKind, value: &str) -> Result<MatchReport> {+ matcher::match_one(&self.conn, kind, value)+ }++ /// Looks up every fingerprint carried by one capture event, returning a+ /// report for each kind that found intelligence.+ pub fn match_event(&self, event: &FingerprintEvent) -> Result<Vec<MatchReport>> {+ let mut reports = Vec::new();+ for (kind, value) in matcher::event_fingerprints(event) {+ let report = self.match_fingerprint(kind, &value)?;+ if report.has_hits() {+ reports.push(report);+ }+ }+ Ok(reports)+ }++ /// Records one capture event and returns every alert its detection rules+ /// raised, using the default thresholds.+ pub fn detect(&mut self, event: &FingerprintEvent) -> Result<Vec<Alert>> {+ self.detect_with(event, &DetectConfig::default())+ }++ /// Records one capture event under explicit thresholds. The observation and+ /// any alerts it raises commit together inside one transaction.+ pub fn detect_with(+ &mut self,+ event: &FingerprintEvent,+ config: &DetectConfig,+ ) -> Result<Vec<Alert>> {+ let tx = self.conn.transaction()?;+ let alerts = detect::run(&tx, event, config)?;+ tx.commit()?;+ Ok(alerts)+ }++ /// The most recent alerts, newest first, for the CLI feed and the dashboard.+ pub fn recent_alerts(&self, limit: i64) -> Result<Vec<Alert>> {+ detect::recent(&self.conn, limit)+ }++ /// A count of recorded alerts per rule, for the stats summary.+ pub fn alert_counts(&self) -> Result<Vec<(Rule, i64)>> {+ detect::counts_by_rule(&self.conn)+ }++ /// Summarises what the store holds, by feed and by category.+ pub fn stats(&self) -> Result<Stats> {+ let sources = self+ .conn+ .prepare("SELECT name, kind, license, record_count FROM intel_source ORDER BY name")?+ .query_map([], |row| {+ Ok(SourceStat {+ name: row.get(0)?,+ kind: row.get(1)?,+ license: row.get(2)?,+ records: row.get(3)?,+ })+ })?+ .collect::<rusqlite::Result<Vec<_>>>()?;++ let by_category = self+ .conn+ .prepare(+ "SELECT category, count(*) FROM intel_fingerprint GROUP BY category ORDER BY category",+ )?+ .query_map([], |row| {+ Ok(CategoryStat {+ category: row.get(0)?,+ records: row.get(1)?,+ })+ })?+ .collect::<rusqlite::Result<Vec<_>>>()?;++ let total: i64 =+ self.conn+ .query_row("SELECT count(*) FROM intel_fingerprint", [], |row| {+ row.get(0)+ })?;++ Ok(Stats {+ sources,+ by_category,+ total,+ })+ }+}++/// A per feed row of the stats summary.+#[derive(Debug, Clone, Serialize)]+pub struct SourceStat {+ pub name: String,+ pub kind: String,+ pub license: Option<String>,+ pub records: i64,+}++/// A per category row of the stats summary.+#[derive(Debug, Clone, Serialize)]+pub struct CategoryStat {+ pub category: String,+ pub records: i64,+}++/// What the store currently holds.+#[derive(Debug, Clone, Serialize)]+pub struct Stats {+ pub sources: Vec<SourceStat>,+ pub by_category: Vec<CategoryStat>,+ pub total: i64,+}++/// The default on disk location of the database, under the XDG data directory+/// when one is set and the home directory otherwise.+pub fn default_db_path() -> PathBuf {+ let base = std::env::var_os("XDG_DATA_HOME")+ .map(PathBuf::from)+ .filter(|path| path.is_absolute())+ .or_else(|| {+ std::env::var_os("HOME").map(|home| PathBuf::from(home).join(".local").join("share"))+ })+ .unwrap_or_else(|| PathBuf::from("."));+ base.join("tlsfp").join("intel.db")+}++/// Splits a JA4 client fingerprint into its capability prefix and cipher hash,+/// the two parts the partial matcher indexes on. Returns `None` for a value+/// that is not the expected three underscore separated fields.+pub(crate) fn ja4_parts(value: &str) -> Option<(String, String)> {+ let mut fields = value.split('_');+ let prefix = fields.next()?;+ let cipher = fields.next()?;+ let extensions = fields.next()?;+ if fields.next().is_some() || prefix.is_empty() || cipher.is_empty() || extensions.is_empty() {+ return None;+ }+ Some((prefix.to_string(), cipher.to_string()))+}++/// Inserts a feed by name or updates it if already present, returning its row+/// id. The id is kept stable across re imports so the fingerprints that point+/// at it are never orphaned.+pub(crate) fn get_or_create_source(+ conn: &Connection,+ name: &str,+ url: Option<&str>,+ license: Option<&str>,+ kind: &str,+) -> rusqlite::Result<i64> {+ conn.execute(+ "INSERT INTO intel_source (name, url, license, kind, imported_at)+ VALUES (?1, ?2, ?3, ?4, ?5)+ ON CONFLICT(name) DO UPDATE SET+ url = excluded.url,+ license = excluded.license,+ kind = excluded.kind,+ imported_at = excluded.imported_at",+ params![name, url, license, kind, unix_now()],+ )?;+ conn.query_row(+ "SELECT id FROM intel_source WHERE name = ?1",+ params![name],+ |row| row.get(0),+ )+}++/// One fingerprint about to be written, shared by the seed loader and the+/// ja4db importer so both compute the JA4 partial match columns identically.+pub(crate) struct NewFingerprint<'a> {+ pub kind: FpKind,+ pub value: &'a str,+ pub label: &'a str,+ pub category: Category,+ pub reference: Option<&'a str>,+ pub first_seen: Option<&'a str>,+}++/// Inserts one fingerprint, lowercasing the value, filling the JA4 partial+/// match columns where they apply, and leaving any existing row untouched.+/// Returns whether a new row was written.+pub(crate) fn insert_fingerprint(+ conn: &Connection,+ source_id: i64,+ fingerprint: &NewFingerprint,+) -> rusqlite::Result<bool> {+ let value = fingerprint.value.trim().to_ascii_lowercase();+ let (part_a, part_b) = if fingerprint.kind.supports_partial() {+ match ja4_parts(&value) {+ Some((prefix, cipher)) => (Some(prefix), Some(cipher)),+ None => (None, None),+ }+ } else {+ (None, None)+ };+ let affected = conn.execute(+ "INSERT OR IGNORE INTO intel_fingerprint+ (fp_kind, value, part_a, part_b, label, category, reference, first_seen, source_id)+ VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9)",+ params![+ fingerprint.kind.as_str(),+ value,+ part_a,+ part_b,+ fingerprint.label,+ fingerprint.category.as_str(),+ fingerprint.reference,+ fingerprint.first_seen,+ source_id,+ ],+ )?;+ Ok(affected == 1)+}++/// Recomputes and stores a feed's record count after its rows are inserted.+pub(crate) fn refresh_source_count(conn: &Connection, source_id: i64) -> rusqlite::Result<()> {+ conn.execute(+ "UPDATE intel_source+ SET record_count = (SELECT count(*) FROM intel_fingerprint WHERE source_id = ?1)+ WHERE id = ?1",+ params![source_id],+ )?;+ Ok(())+}++/// The current wall clock time in whole seconds since the Unix epoch, clamped to+/// zero if the clock is set before 1970.+pub(crate) fn unix_now() -> i64 {+ SystemTime::now()+ .duration_since(UNIX_EPOCH)+ .ok()+ .and_then(|d| i64::try_from(d.as_secs()).ok())+ .unwrap_or(0)+}++#[cfg(test)]+mod tests {+ use super::ja4_parts;++ #[test]+ fn ja4_parts_splits_three_fields() {+ let parts = ja4_parts("t13d1516h2_8daaf6152771_e5627efa2ab1");+ assert_eq!(+ parts,+ Some(("t13d1516h2".to_string(), "8daaf6152771".to_string()))+ );+ }++ #[test]+ fn ja4_parts_rejects_wrong_shape() {+ assert_eq!(ja4_parts("nounderscores"), None);+ assert_eq!(ja4_parts("only_two"), None);+ assert_eq!(ja4_parts("a_b_c_d"), None);+ assert_eq!(ja4_parts("a__c"), None);+ }+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/matcher.rs b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/matcher.rsnew file mode 100644index 00000000..ceff2ad5--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/matcher.rs@@ -0,0 +1,258 @@+// Β©AngelaMos | 2026+// matcher.rs++//! Looking a fingerprint up against the store.+//!+//! Every kind supports an exact match. The JA4 client fingerprint also supports+//! two partial tiers, because its value is three fields joined by underscores:+//! a capability prefix, a hash of the cipher list, and a hash of the extension+//! list. A tool that copies a browser's cipher order but not its full set of+//! extensions produces a different whole fingerprint but the same cipher hash,+//! so matching on the cipher hash alone catches the impersonation that an exact+//! match misses. The three tiers query disjoint rows, so a hit is counted once+//! at its true strength with no later de duplication.++use rusqlite::{Connection, Params, Row, params};+use tlsfp_core::{FingerprintEvent, StreamEvent};++use super::ja4_parts;+use super::model::{Category, FpKind, IntelHit, MatchReport, MatchStrength};++const SELECT: &str = "SELECT f.fp_kind, f.value, f.label, f.category, s.name, f.reference+ FROM intel_fingerprint f+ JOIN intel_source s ON s.id = f.source_id";++/// Looks one fingerprint up and scores every hit into a verdict.+pub fn match_one(conn: &Connection, kind: FpKind, value: &str) -> anyhow::Result<MatchReport> {+ let value = value.trim().to_ascii_lowercase();+ let mut hits = collect(+ conn,+ &format!("{SELECT} WHERE f.fp_kind = ?1 AND f.value = ?2"),+ params![kind.as_str(), value],+ MatchStrength::Exact,+ )?;++ if kind.supports_partial() {+ if let Some((prefix, cipher)) = ja4_parts(&value) {+ hits.extend(collect(+ conn,+ &format!(+ "{SELECT} WHERE f.fp_kind = 'ja4' AND f.part_a = ?1 AND f.part_b = ?2 AND f.value != ?3"+ ),+ params![prefix, cipher, value],+ MatchStrength::CipherAndPrefix,+ )?);+ hits.extend(collect(+ conn,+ &format!("{SELECT} WHERE f.fp_kind = 'ja4' AND f.part_b = ?1 AND f.part_a != ?2"),+ params![cipher, prefix],+ MatchStrength::CipherOnly,+ )?);+ }+ }++ Ok(MatchReport::from_hits(kind, value, hits))+}++/// The fingerprints carried by one capture event, paired with their kind.+pub fn event_fingerprints(event: &FingerprintEvent) -> Vec<(FpKind, String)> {+ match &event.event {+ StreamEvent::ClientHello { ja3, ja4, .. } => {+ vec![+ (FpKind::Ja3, ja3.to_string()),+ (FpKind::Ja4, ja4.hash.clone()),+ ]+ }+ StreamEvent::ServerHello { ja3s, ja4s, .. } => {+ vec![+ (FpKind::Ja3s, ja3s.to_string()),+ (FpKind::Ja4s, ja4s.hash.clone()),+ ]+ }+ StreamEvent::Certificate { ja4x } => vec![(FpKind::Ja4x, ja4x.clone())],+ StreamEvent::HttpRequest { ja4h, .. } => vec![(FpKind::Ja4h, ja4h.hash.clone())],+ StreamEvent::TcpSyn { ja4t } => vec![(FpKind::Ja4t, ja4t.clone())],+ StreamEvent::TcpSynAck { ja4ts } => vec![(FpKind::Ja4ts, ja4ts.clone())],+ }+}++fn collect(+ conn: &Connection,+ sql: &str,+ params: impl Params,+ strength: MatchStrength,+) -> rusqlite::Result<Vec<IntelHit>> {+ let mut statement = conn.prepare(sql)?;+ let hits = statement+ .query_map(params, |row| map_row(row, strength))?+ .collect::<rusqlite::Result<Vec<_>>>()?;+ Ok(hits)+}++fn map_row(row: &Row, strength: MatchStrength) -> rusqlite::Result<IntelHit> {+ let kind: String = row.get(0)?;+ let category: String = row.get(3)?;+ Ok(IntelHit {+ kind: FpKind::from_token(&kind).unwrap_or(FpKind::Ja3),+ value: row.get(1)?,+ label: row.get(2)?,+ category: Category::from_token(&category),+ source: row.get(4)?,+ reference: row.get(5)?,+ strength,+ })+}++#[cfg(test)]+mod tests {+ use super::{event_fingerprints, match_one};+ use crate::IntelStore;+ use crate::model::{FpKind, MatchStrength, Verdict};+ use tlsfp_core::fingerprint::{Ja3, Ja4Family};+ use tlsfp_core::{FingerprintEvent, StreamEvent};++ fn seeded() -> IntelStore {+ let mut store = IntelStore::open_in_memory().unwrap();+ store.seed_bundled().unwrap();+ store+ }++ #[test]+ fn known_malicious_ja3_is_malicious() {+ let store = seeded();+ let report = store+ .match_fingerprint(FpKind::Ja3, "1aa7bf8b97e540ca5edd75f7b8384bfa")+ .unwrap();+ assert_eq!(report.verdict, Verdict::Malicious);+ assert!(report.hits.iter().any(|hit| hit.label == "TrickBot"));+ }++ #[test]+ fn known_benign_ja3_is_benign() {+ let store = seeded();+ let report = store+ .match_fingerprint(FpKind::Ja3, "c36fb08942cf19508c08d96af22d4ffc")+ .unwrap();+ assert_eq!(report.verdict, Verdict::Benign);+ assert!(report.hits.iter().any(|hit| hit.label == "Safari"));+ }++ #[test]+ fn cross_feed_collision_is_suspicious() {+ let store = seeded();+ let report = store+ .match_fingerprint(FpKind::Ja3, "51a7ad14509fd614c7bb3a50c4982b8c")+ .unwrap();+ assert_eq!(report.verdict, Verdict::Suspicious);+ assert!(report.hits.len() >= 2);+ assert!((report.threat_score - 0.5).abs() < 1e-9);+ }++ #[test]+ fn unknown_fingerprint_returns_no_hits() {+ let store = seeded();+ let report = store+ .match_fingerprint(FpKind::Ja3, "00000000000000000000000000000000")+ .unwrap();+ assert_eq!(report.verdict, Verdict::Unknown);+ assert!(!report.has_hits());+ }++ #[test]+ fn case_is_normalised_before_lookup() {+ let store = seeded();+ let report = store+ .match_fingerprint(FpKind::Ja3, "1AA7BF8B97E540CA5EDD75F7B8384BFA")+ .unwrap();+ assert_eq!(report.verdict, Verdict::Malicious);+ }++ #[test]+ fn exact_ja4_lookup_hits() {+ let store = seeded();+ let report = store+ .match_fingerprint(FpKind::Ja4, "t10d070600_c50f5591e341_1a3805c3aa63")+ .unwrap();+ assert_eq!(report.verdict, Verdict::Malicious);+ assert_eq!(report.hits[0].strength, MatchStrength::Exact);+ assert!(report.hits.iter().any(|hit| hit.label == "RedLine Stealer"));+ }++ #[test]+ fn ja4_same_ciphers_different_extensions_is_a_partial_hit() {+ let store = seeded();+ let report = match_one(+ &store.conn,+ FpKind::Ja4,+ "t13d1516h2_8daaf6152771_ffffffffffff",+ )+ .unwrap();+ assert!(report.has_hits());+ assert_eq!(report.hits[0].strength, MatchStrength::CipherAndPrefix);+ assert!(report.hits.iter().any(|hit| hit.label == "Google Chrome"));+ }++ #[test]+ fn ja4_same_cipher_list_under_a_different_profile_is_cipher_only() {+ let store = seeded();+ let report = match_one(+ &store.conn,+ FpKind::Ja4,+ "t13d0000h0_8daaf6152771_000000000000",+ )+ .unwrap();+ assert!(report.has_hits());+ assert_eq!(report.hits[0].strength, MatchStrength::CipherOnly);+ }++ #[test]+ fn ja3_does_not_do_partial_matching() {+ let store = seeded();+ let report = store+ .match_fingerprint(FpKind::Ja3, "1aa7bf8b97e540ca5edd75f7b8384bf0")+ .unwrap();+ assert!(!report.has_hits());+ }++ #[test]+ fn event_fingerprints_pulls_both_client_fingerprints() {+ let event = FingerprintEvent {+ ts_nanos: 0,+ src: "10.0.0.1:1000".parse().unwrap(),+ dst: "10.0.0.2:443".parse().unwrap(),+ event: StreamEvent::ClientHello {+ ja3: Ja3::from_digest([0x1a; 16]),+ ja3_raw: "raw".into(),+ ja4: Ja4Family::new("t13d1516h2_8daaf6152771_e5627efa2ab1".into(), "raw".into()),+ sni: None,+ alpn: None,+ },+ };+ let fingerprints = event_fingerprints(&event);+ assert_eq!(fingerprints.len(), 2);+ assert_eq!(fingerprints[0].0, FpKind::Ja3);+ assert_eq!(fingerprints[1].0, FpKind::Ja4);+ assert_eq!(fingerprints[1].1, "t13d1516h2_8daaf6152771_e5627efa2ab1");+ }++ #[test]+ fn match_event_only_reports_kinds_with_intel() {+ let store = seeded();+ let event = FingerprintEvent {+ ts_nanos: 0,+ src: "10.0.0.1:1000".parse().unwrap(),+ dst: "10.0.0.2:443".parse().unwrap(),+ event: StreamEvent::ClientHello {+ ja3: Ja3::from_digest([0x00; 16]),+ ja3_raw: "raw".into(),+ ja4: Ja4Family::new("t13d1516h2_8daaf6152771_e5627efa2ab1".into(), "raw".into()),+ sni: None,+ alpn: None,+ },+ };+ let reports = store.match_event(&event).unwrap();+ assert_eq!(reports.len(), 1);+ assert_eq!(reports[0].kind, FpKind::Ja4);+ assert_eq!(reports[0].verdict, Verdict::Benign);+ }+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/model.rs b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/model.rsnew file mode 100644index 00000000..5fae7d9f--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/model.rs@@ -0,0 +1,461 @@+// Β©AngelaMos | 2026+// model.rs++//! Domain types for the intelligence store.+//!+//! These describe what the store holds (a fingerprint, its kind, and how its+//! label is classified) and what a lookup returns (a set of hits and the+//! verdict they add up to). The scoring lives here too, kept apart from the SQL+//! so it can be unit tested on plain values with no database in the picture.++use std::fmt;++use serde::Serialize;++/// Which fingerprint algorithm a stored value belongs to.+#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize)]+#[serde(rename_all = "snake_case")]+pub enum FpKind {+ Ja3,+ Ja3s,+ Ja4,+ Ja4s,+ Ja4h,+ Ja4x,+ Ja4t,+ Ja4ts,+}++impl FpKind {+ /// The lowercase token used for this kind in the database and on the CLI.+ pub const fn as_str(self) -> &'static str {+ match self {+ FpKind::Ja3 => "ja3",+ FpKind::Ja3s => "ja3s",+ FpKind::Ja4 => "ja4",+ FpKind::Ja4s => "ja4s",+ FpKind::Ja4h => "ja4h",+ FpKind::Ja4x => "ja4x",+ FpKind::Ja4t => "ja4t",+ FpKind::Ja4ts => "ja4ts",+ }+ }++ /// Parses a kind token, returning `None` for anything unrecognised.+ pub fn from_token(token: &str) -> Option<Self> {+ Some(match token {+ "ja3" => FpKind::Ja3,+ "ja3s" => FpKind::Ja3s,+ "ja4" => FpKind::Ja4,+ "ja4s" => FpKind::Ja4s,+ "ja4h" => FpKind::Ja4h,+ "ja4x" => FpKind::Ja4x,+ "ja4t" => FpKind::Ja4t,+ "ja4ts" => FpKind::Ja4ts,+ _ => return None,+ })+ }++ /// Whether partial, structure aware matching applies to this kind.+ ///+ /// Only the JA4 client fingerprint carries a cipher list hash and a+ /// capability prefix that mean something on their own, so it is the only+ /// kind that supports the cipher and prefix match tiers. Everything else is+ /// either an opaque digest (JA3) or a single server side value where a+ /// partial match would not be informative.+ pub const fn supports_partial(self) -> bool {+ matches!(self, FpKind::Ja4)+ }+}++impl fmt::Display for FpKind {+ fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {+ f.write_str(self.as_str())+ }+}++/// The classification carried by a stored label, as read from a seed feed.+#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize)]+#[serde(rename_all = "snake_case")]+pub enum Category {+ Malware,+ C2,+ Tool,+ Benign,+ Os,+ Unknown,+}++impl Category {+ /// The token used for this category in the database and seed files.+ pub const fn as_str(self) -> &'static str {+ match self {+ Category::Malware => "malware",+ Category::C2 => "c2",+ Category::Tool => "tool",+ Category::Benign => "benign",+ Category::Os => "os",+ Category::Unknown => "unknown",+ }+ }++ /// Parses a category token, falling back to `Unknown` for anything else so+ /// that a dirty feed value never aborts an import.+ pub fn from_token(token: &str) -> Self {+ match token.trim().to_ascii_lowercase().as_str() {+ "malware" => Category::Malware,+ "c2" => Category::C2,+ "tool" => Category::Tool,+ "benign" => Category::Benign,+ "os" => Category::Os,+ _ => Category::Unknown,+ }+ }++ /// How a hit in this category weighs on the final verdict.+ ///+ /// Command and control and malware are malicious. Dual use tooling, such as+ /// Metasploit or a Tor client, is suspicious rather than malicious because+ /// its presence is noteworthy but not proof of compromise. Benign and+ /// operating system baselines are benign. An unlabelled entry is treated as+ /// suspicious, since it was put in the store for some reason.+ pub const fn severity(self) -> Severity {+ match self {+ Category::Malware | Category::C2 => Severity::Malicious,+ Category::Tool | Category::Unknown => Severity::Suspicious,+ Category::Benign | Category::Os => Severity::Benign,+ }+ }+}++/// The coarse direction a single hit pushes the verdict.+#[derive(Debug, Clone, Copy, PartialEq, Eq)]+pub enum Severity {+ Malicious,+ Suspicious,+ Benign,+}++/// How closely a stored fingerprint matched the observed one.+#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize)]+#[serde(rename_all = "snake_case")]+pub enum MatchStrength {+ /// Every byte of the fingerprint is identical.+ Exact,+ /// JA4 only: the capability prefix and the cipher hash both match but the+ /// extension hash differs, so the same client stack presented a different+ /// extension set, often just a different server name.+ CipherAndPrefix,+ /// JA4 only: the cipher hash matches but the capability prefix differs, so a+ /// different protocol or version profile is carrying the same cipher list.+ /// This is the tell of a tool that copies a browser cipher order.+ CipherOnly,+}++impl MatchStrength {+ /// The token used for this strength on the CLI and in JSON.+ pub const fn as_str(self) -> &'static str {+ match self {+ MatchStrength::Exact => "exact",+ MatchStrength::CipherAndPrefix => "cipher_and_prefix",+ MatchStrength::CipherOnly => "cipher_only",+ }+ }++ /// A weight in the range zero to one expressing how much trust a match of+ /// this strength earns when scoring.+ pub const fn weight(self) -> f64 {+ match self {+ MatchStrength::Exact => 1.0,+ MatchStrength::CipherAndPrefix => 0.8,+ MatchStrength::CipherOnly => 0.55,+ }+ }+}++/// One stored fingerprint that matched the observed one, with its provenance.+#[derive(Debug, Clone, Serialize)]+pub struct IntelHit {+ pub kind: FpKind,+ pub value: String,+ pub label: String,+ pub category: Category,+ pub source: String,+ #[serde(skip_serializing_if = "Option::is_none")]+ pub reference: Option<String>,+ pub strength: MatchStrength,+}++/// The judgement for an observed fingerprint after weighing every hit.+#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize)]+#[serde(rename_all = "snake_case")]+pub enum Verdict {+ Malicious,+ Suspicious,+ Benign,+ Unknown,+}++impl Verdict {+ pub const fn as_str(self) -> &'static str {+ match self {+ Verdict::Malicious => "malicious",+ Verdict::Suspicious => "suspicious",+ Verdict::Benign => "benign",+ Verdict::Unknown => "unknown",+ }+ }+}++impl fmt::Display for Verdict {+ fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {+ f.write_str(self.as_str())+ }+}++/// The full result of looking up one observed fingerprint.+#[derive(Debug, Clone, Serialize)]+pub struct MatchReport {+ pub kind: FpKind,+ pub observed: String,+ pub verdict: Verdict,+ pub threat_score: f64,+ pub confidence: f64,+ pub hits: Vec<IntelHit>,+}++impl MatchReport {+ /// Whether the lookup found any intelligence at all.+ pub fn has_hits(&self) -> bool {+ !self.hits.is_empty()+ }++ /// Scores a set of hits into a verdict.+ ///+ /// The threat score follows the prevalence idea from public sandboxes: a+ /// fingerprint seen mostly in malicious sources scores high, one seen mostly+ /// in benign sources scores low, and one claimed by both lands in the+ /// middle. Each hit contributes its match strength as weight, so an exact+ /// hash hit counts for more than a partial cipher hit. Suspicious, dual use+ /// hits count as half a malicious vote.+ ///+ /// Confidence is separate from the score: it says how sure the verdict is,+ /// rising with the strength of the best match and with the number of+ /// corroborating hits that agree with the verdict.+ pub fn from_hits(kind: FpKind, observed: String, hits: Vec<IntelHit>) -> Self {+ if hits.is_empty() {+ return Self {+ kind,+ observed,+ verdict: Verdict::Unknown,+ threat_score: 0.0,+ confidence: 0.0,+ hits,+ };+ }++ let mut malicious = 0.0;+ let mut suspicious = 0.0;+ let mut benign = 0.0;+ let mut best = 0.0_f64;+ for hit in &hits {+ let weight = hit.strength.weight();+ best = best.max(weight);+ match hit.category.severity() {+ Severity::Malicious => malicious += weight,+ Severity::Suspicious => suspicious += weight,+ Severity::Benign => benign += weight,+ }+ }+ let total = malicious + suspicious + benign;+ let threat_score = (malicious + 0.5 * suspicious) / total;++ let verdict = if threat_score >= 0.8 {+ Verdict::Malicious+ } else if threat_score <= 0.2 {+ Verdict::Benign+ } else {+ Verdict::Suspicious+ };++ let aligned = hits+ .iter()+ .filter(|hit| verdict_aligns(verdict, hit.category.severity()))+ .count();+ let corroboration = 1.0 - 1.0 / (1.0 + count_to_f64(aligned));+ let confidence = best * (0.6 + 0.4 * corroboration);++ Self {+ kind,+ observed,+ verdict,+ threat_score,+ confidence,+ hits,+ }+ }+}++/// Whether a hit of a given severity supports the chosen verdict, used to count+/// how many hits corroborate the result when scoring confidence.+fn verdict_aligns(verdict: Verdict, severity: Severity) -> bool {+ match verdict {+ Verdict::Malicious => severity == Severity::Malicious,+ Verdict::Benign => severity == Severity::Benign,+ Verdict::Suspicious => true,+ Verdict::Unknown => false,+ }+}++/// Converts a small count to a float without tripping the precision loss lint.+/// Intel hit counts are tiny, so saturating at `u32::MAX` is unreachable.+fn count_to_f64(n: usize) -> f64 {+ f64::from(u32::try_from(n).unwrap_or(u32::MAX))+}++#[cfg(test)]+mod tests {+ use super::{Category, FpKind, IntelHit, MatchReport, MatchStrength, Severity, Verdict};++ fn hit(category: Category, strength: MatchStrength) -> IntelHit {+ IntelHit {+ kind: FpKind::Ja3,+ value: "x".into(),+ label: "x".into(),+ category,+ source: "s".into(),+ reference: None,+ strength,+ }+ }++ #[test]+ fn kind_tokens_round_trip() {+ for kind in [+ FpKind::Ja3,+ FpKind::Ja3s,+ FpKind::Ja4,+ FpKind::Ja4s,+ FpKind::Ja4h,+ FpKind::Ja4x,+ FpKind::Ja4t,+ FpKind::Ja4ts,+ ] {+ assert_eq!(FpKind::from_token(kind.as_str()), Some(kind));+ }+ assert_eq!(FpKind::from_token("nope"), None);+ }++ #[test]+ fn only_ja4_supports_partial() {+ assert!(FpKind::Ja4.supports_partial());+ assert!(!FpKind::Ja3.supports_partial());+ assert!(!FpKind::Ja4s.supports_partial());+ }++ #[test]+ fn category_severity_mapping() {+ assert_eq!(Category::Malware.severity(), Severity::Malicious);+ assert_eq!(Category::C2.severity(), Severity::Malicious);+ assert_eq!(Category::Tool.severity(), Severity::Suspicious);+ assert_eq!(Category::Unknown.severity(), Severity::Suspicious);+ assert_eq!(Category::Benign.severity(), Severity::Benign);+ assert_eq!(Category::Os.severity(), Severity::Benign);+ }++ #[test]+ fn no_hits_is_unknown() {+ let report = MatchReport::from_hits(FpKind::Ja3, "x".into(), vec![]);+ assert_eq!(report.verdict, Verdict::Unknown);+ assert!(report.threat_score.abs() < 1e-9);+ assert!(report.confidence.abs() < 1e-9);+ assert!(!report.has_hits());+ }++ #[test]+ fn single_exact_malware_is_malicious() {+ let report = MatchReport::from_hits(+ FpKind::Ja3,+ "x".into(),+ vec![hit(Category::Malware, MatchStrength::Exact)],+ );+ assert_eq!(report.verdict, Verdict::Malicious);+ assert!((report.threat_score - 1.0).abs() < 1e-9);+ assert!((report.confidence - 0.8).abs() < 1e-9);+ }++ #[test]+ fn single_benign_is_benign() {+ let report = MatchReport::from_hits(+ FpKind::Ja3,+ "x".into(),+ vec![hit(Category::Benign, MatchStrength::Exact)],+ );+ assert_eq!(report.verdict, Verdict::Benign);+ assert!((report.threat_score - 0.0).abs() < 1e-9);+ assert!((report.confidence - 0.8).abs() < 1e-9);+ }++ #[test]+ fn malicious_and_benign_collision_is_suspicious() {+ let report = MatchReport::from_hits(+ FpKind::Ja3,+ "x".into(),+ vec![+ hit(Category::Malware, MatchStrength::Exact),+ hit(Category::Benign, MatchStrength::Exact),+ ],+ );+ assert_eq!(report.verdict, Verdict::Suspicious);+ assert!((report.threat_score - 0.5).abs() < 1e-9);+ let expected = 1.0 * (0.6 + 0.4 * (1.0 - 1.0 / 3.0));+ assert!((report.confidence - expected).abs() < 1e-9);+ }++ #[test]+ fn dual_use_tool_alone_is_suspicious() {+ let report = MatchReport::from_hits(+ FpKind::Ja3,+ "x".into(),+ vec![hit(Category::Tool, MatchStrength::Exact)],+ );+ assert_eq!(report.verdict, Verdict::Suspicious);+ assert!((report.threat_score - 0.5).abs() < 1e-9);+ }++ #[test]+ fn partial_cipher_hit_lowers_confidence() {+ let exact = MatchReport::from_hits(+ FpKind::Ja4,+ "x".into(),+ vec![hit(Category::Malware, MatchStrength::Exact)],+ );+ let partial = MatchReport::from_hits(+ FpKind::Ja4,+ "x".into(),+ vec![hit(Category::Malware, MatchStrength::CipherOnly)],+ );+ assert!(partial.confidence < exact.confidence);+ assert_eq!(partial.verdict, Verdict::Malicious);+ }++ #[test]+ fn corroboration_raises_confidence() {+ let one = MatchReport::from_hits(+ FpKind::Ja3,+ "x".into(),+ vec![hit(Category::Malware, MatchStrength::Exact)],+ );+ let three = MatchReport::from_hits(+ FpKind::Ja3,+ "x".into(),+ vec![+ hit(Category::Malware, MatchStrength::Exact),+ hit(Category::C2, MatchStrength::Exact),+ hit(Category::Malware, MatchStrength::Exact),+ ],+ );+ assert!(three.confidence > one.confidence);+ assert_eq!(three.verdict, Verdict::Malicious);+ }+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/schema.rs b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/schema.rsnew file mode 100644index 00000000..1d699c41--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/schema.rs@@ -0,0 +1,167 @@+// Β©AngelaMos | 2026+// schema.rs++//! The database schema and its migration runner.+//!+//! Versions are tracked in SQLite's own `user_version` header field rather than+//! a side table, so an empty database and a fully migrated one are told apart+//! with a single pragma and no bootstrapping. Each migration is the whole SQL+//! to move from one version to the next, applied inside a transaction so a+//! half applied schema can never be left behind. Running the migrations on an+//! already current database is a no op, which is what lets every command open+//! the store and migrate without checking first.+//!+//! Migration one is the intelligence half: feeds and the fingerprints they+//! carry. Migration two is the detection half: the observations the engine+//! records as it watches traffic and the alerts it raises when a rule fires.+//! Both tables stand on their own, so a detection run needs intelligence loaded+//! only for the rules that consult it.++use rusqlite::Connection;++/// The ordered list of migrations. Index zero moves a fresh database to version+/// one, index one to version two, and so on. Append, never edit in place, or an+/// existing database will silently disagree with a new one.+const MIGRATIONS: &[&str] = &[+ r"+CREATE TABLE intel_source (+ id INTEGER PRIMARY KEY,+ name TEXT NOT NULL UNIQUE,+ url TEXT,+ license TEXT,+ kind TEXT NOT NULL,+ imported_at INTEGER NOT NULL,+ record_count INTEGER NOT NULL DEFAULT 0+);++CREATE TABLE intel_fingerprint (+ id INTEGER PRIMARY KEY,+ fp_kind TEXT NOT NULL,+ value TEXT NOT NULL,+ part_a TEXT,+ part_b TEXT,+ label TEXT NOT NULL,+ category TEXT NOT NULL,+ reference TEXT,+ first_seen TEXT,+ source_id INTEGER NOT NULL REFERENCES intel_source(id) ON DELETE CASCADE,+ UNIQUE(fp_kind, value, source_id)+);++CREATE INDEX idx_fp_kind_value ON intel_fingerprint(fp_kind, value);+CREATE INDEX idx_fp_kind_part_b ON intel_fingerprint(fp_kind, part_b);+CREATE INDEX idx_fp_kind_part_a ON intel_fingerprint(fp_kind, part_a);+",+ r"+CREATE TABLE observation (+ id INTEGER PRIMARY KEY,+ ts INTEGER NOT NULL,+ ip TEXT NOT NULL,+ fp_kind TEXT NOT NULL,+ fp_value TEXT NOT NULL,+ verdict TEXT,+ label TEXT,+ category TEXT,+ sni TEXT,+ host TEXT,+ user_agent TEXT,+ os_claim TEXT+);++CREATE INDEX idx_obs_ip ON observation(ip);+CREATE INDEX idx_obs_ip_kind ON observation(ip, fp_kind);+CREATE INDEX idx_obs_fp ON observation(fp_kind, fp_value);+CREATE INDEX idx_obs_ts ON observation(ts);++CREATE TABLE alert (+ id INTEGER PRIMARY KEY,+ ts INTEGER NOT NULL,+ rule TEXT NOT NULL,+ severity TEXT NOT NULL,+ ip TEXT,+ fp_kind TEXT,+ fp_value TEXT,+ title TEXT NOT NULL,+ detail TEXT NOT NULL,+ score REAL,+ observation_id INTEGER REFERENCES observation(id) ON DELETE SET NULL+);++CREATE INDEX idx_alert_ts ON alert(ts);+CREATE INDEX idx_alert_rule ON alert(rule);+CREATE INDEX idx_alert_ip ON alert(ip);+",+];++/// Brings a connection's schema up to the latest version, applying only the+/// migrations it is missing. Safe to call on every open.+pub fn apply_migrations(conn: &mut Connection) -> rusqlite::Result<()> {+ let mut version: i64 = conn.pragma_query_value(None, "user_version", |row| row.get(0))?;+ while usize::try_from(version).unwrap_or(usize::MAX) < MIGRATIONS.len() {+ let index = usize::try_from(version).unwrap_or(usize::MAX);+ let tx = conn.transaction()?;+ tx.execute_batch(MIGRATIONS[index])?;+ tx.pragma_update(None, "user_version", version + 1)?;+ tx.commit()?;+ version += 1;+ }+ Ok(())+}++/// The schema version a fully migrated database reports, used by the tests to+/// assert the runner reaches the head of the migration list.+#[cfg(test)]+fn latest_version() -> i64 {+ i64::try_from(MIGRATIONS.len()).unwrap_or(i64::MAX)+}++#[cfg(test)]+mod tests {+ use super::{MIGRATIONS, apply_migrations, latest_version};+ use rusqlite::Connection;++ fn user_version(conn: &Connection) -> i64 {+ conn.pragma_query_value(None, "user_version", |row| row.get(0))+ .unwrap()+ }++ #[test]+ fn migrates_a_fresh_database_to_latest() {+ let mut conn = Connection::open_in_memory().unwrap();+ assert_eq!(user_version(&conn), 0);+ apply_migrations(&mut conn).unwrap();+ assert_eq!(user_version(&conn), latest_version());+ }++ #[test]+ fn migrating_twice_is_a_no_op() {+ let mut conn = Connection::open_in_memory().unwrap();+ apply_migrations(&mut conn).unwrap();+ apply_migrations(&mut conn).unwrap();+ assert_eq!(user_version(&conn), latest_version());+ }++ #[test]+ fn expected_tables_exist() {+ let mut conn = Connection::open_in_memory().unwrap();+ apply_migrations(&mut conn).unwrap();+ let count: i64 = conn+ .query_row(+ "SELECT count(*) FROM sqlite_master WHERE type='table' AND name IN ('intel_source','intel_fingerprint','observation','alert')",+ [],+ |row| row.get(0),+ )+ .unwrap();+ assert_eq!(count, 4);+ }++ #[test]+ fn migration_two_is_appended_not_edited() {+ assert!(+ MIGRATIONS.len() >= 2,+ "detection tables live in migration two"+ );+ assert!(MIGRATIONS[0].contains("intel_fingerprint"));+ assert!(MIGRATIONS[1].contains("observation") && MIGRATIONS[1].contains("alert"));+ }+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/seed.rs b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/seed.rsnew file mode 100644index 00000000..8fb4052b--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/seed.rs@@ -0,0 +1,360 @@+// Β©AngelaMos | 2026+// seed.rs++//! Loading the three vendored feeds into the database.+//!+//! The feeds are compiled into the binary, so seeding needs no network. Each+//! feed has its own column layout, so each gets its own small parser, but they+//! share one insert path that computes the JA4 partial match columns and skips+//! rows already present. Parsing uses a real CSV reader rather than splitting on+//! commas, because the salesforce application names are quoted and can contain+//! commas, and its licence header is a quoted field that spans several lines.+//!+//! Every malicious feed row is classified by the feed it came from: abuse.ch+//! SSLBL is a blocklist, so its rows are malware, and the salesforce list is a+//! benign application catalogue, so its rows are benign. The curated file+//! carries an explicit category per row. The point of loading both a malicious+//! and a benign feed is that some hashes appear in both, and the matcher needs+//! to see that disagreement to score it.++use anyhow::Result;+use rusqlite::Connection;++use super::model::{Category, FpKind};+use super::{NewFingerprint, get_or_create_source, insert_fingerprint, refresh_source_count};++const SSLBL: &str = include_str!("../seeds/sslbl-ja3.csv");+const SALESFORCE: &str = include_str!("../seeds/salesforce-osx-nix-ja3.csv");+const CURATED: &str = include_str!("../seeds/curated-c2-intel.csv");++const SSLBL_NAME: &str = "abuse.ch SSLBL";+const SSLBL_URL: &str = "https://sslbl.abuse.ch/blacklist/ja3_fingerprints.csv";+const SALESFORCE_NAME: &str = "salesforce/ja3 osx-nix";+const SALESFORCE_URL: &str = "https://github.com/salesforce/ja3";+const CURATED_NAME: &str = "tlsfp curated";++/// How many rows one feed contributed on a seed run.+#[derive(Debug, Clone)]+pub struct FeedLoad {+ pub name: String,+ pub inserted: usize,+ pub parsed: usize,+}++/// The result of a full seed run across every feed.+#[derive(Debug, Clone)]+pub struct SeedSummary {+ pub feeds: Vec<FeedLoad>,+}++impl SeedSummary {+ /// Rows newly inserted across all feeds, zero on a repeat seed.+ pub fn inserted(&self) -> usize {+ self.feeds.iter().map(|feed| feed.inserted).sum()+ }++ /// Valid rows parsed across all feeds, the same on every seed.+ pub fn parsed(&self) -> usize {+ self.feeds.iter().map(|feed| feed.parsed).sum()+ }+}++/// Loads all three vendored feeds inside a single transaction.+pub fn load_bundled(conn: &mut Connection) -> Result<SeedSummary> {+ let tx = conn.transaction()?;+ let mut feeds = Vec::new();++ let sslbl_id =+ get_or_create_source(&tx, SSLBL_NAME, Some(SSLBL_URL), Some("CC0-1.0"), "bundled")?;+ let (inserted, parsed) = load_sslbl(&tx, sslbl_id)?;+ refresh_source_count(&tx, sslbl_id)?;+ feeds.push(FeedLoad {+ name: SSLBL_NAME.to_string(),+ inserted,+ parsed,+ });++ let sf_id = get_or_create_source(+ &tx,+ SALESFORCE_NAME,+ Some(SALESFORCE_URL),+ Some("BSD-3-Clause"),+ "bundled",+ )?;+ let (inserted, parsed) = load_salesforce(&tx, sf_id)?;+ refresh_source_count(&tx, sf_id)?;+ feeds.push(FeedLoad {+ name: SALESFORCE_NAME.to_string(),+ inserted,+ parsed,+ });++ let curated_id = get_or_create_source(&tx, CURATED_NAME, None, Some("project"), "bundled")?;+ let (inserted, parsed) = load_curated(&tx, curated_id)?;+ refresh_source_count(&tx, curated_id)?;+ feeds.push(FeedLoad {+ name: CURATED_NAME.to_string(),+ inserted,+ parsed,+ });++ tx.commit()?;+ Ok(SeedSummary { feeds })+}++/// abuse.ch SSLBL: `ja3_md5, Firstseen, Lastseen, Listingreason`, every row a+/// known malicious JA3.+fn load_sslbl(conn: &Connection, source_id: i64) -> Result<(usize, usize)> {+ let mut reader = csv::ReaderBuilder::new()+ .has_headers(false)+ .flexible(true)+ .comment(Some(b'#'))+ .from_reader(SSLBL.as_bytes());++ let mut inserted = 0;+ let mut parsed = 0;+ for record in reader.records() {+ let record = record?;+ let value = record.get(0).unwrap_or_default().trim();+ if !is_hex_md5(value) {+ continue;+ }+ let first_seen = record.get(1).map(str::trim).filter(|seen| !seen.is_empty());+ let label = record+ .get(3)+ .map(str::trim)+ .filter(|reason| !reason.is_empty())+ .unwrap_or("unknown");+ parsed += 1;+ if insert_fingerprint(+ conn,+ source_id,+ &NewFingerprint {+ kind: FpKind::Ja3,+ value,+ label,+ category: Category::Malware,+ reference: None,+ first_seen,+ },+ )? {+ inserted += 1;+ }+ }+ Ok((inserted, parsed))+}++/// salesforce osx-nix: `ja3_md5, "application name(s)"`, every row a benign app.+/// The quoted multi line licence header is the first record and is dropped by+/// the hex check, since its first field is prose rather than a hash.+fn load_salesforce(conn: &Connection, source_id: i64) -> Result<(usize, usize)> {+ let mut reader = csv::ReaderBuilder::new()+ .has_headers(false)+ .flexible(true)+ .from_reader(SALESFORCE.as_bytes());++ let mut inserted = 0;+ let mut parsed = 0;+ for record in reader.records() {+ let record = record?;+ let value = record.get(0).unwrap_or_default().trim();+ if !is_hex_md5(value) {+ continue;+ }+ let label = record+ .get(1)+ .map(str::trim)+ .filter(|app| !app.is_empty())+ .unwrap_or("unknown");+ parsed += 1;+ if insert_fingerprint(+ conn,+ source_id,+ &NewFingerprint {+ kind: FpKind::Ja3,+ value,+ label,+ category: Category::Benign,+ reference: None,+ first_seen: None,+ },+ )? {+ inserted += 1;+ }+ }+ Ok((inserted, parsed))+}++/// The curated file: `fp_kind, value, label, category, reference`, each row a+/// hand classified entry from a named source.+fn load_curated(conn: &Connection, source_id: i64) -> Result<(usize, usize)> {+ let mut reader = csv::ReaderBuilder::new()+ .has_headers(true)+ .flexible(true)+ .comment(Some(b'#'))+ .from_reader(CURATED.as_bytes());++ let mut inserted = 0;+ let mut parsed = 0;+ for record in reader.records() {+ let record = record?;+ let Some(kind) = record.get(0).map(str::trim).and_then(FpKind::from_token) else {+ continue;+ };+ let value = record.get(1).unwrap_or_default().trim();+ if value.is_empty() {+ continue;+ }+ let label = record+ .get(2)+ .map(str::trim)+ .filter(|label| !label.is_empty())+ .unwrap_or("unknown");+ let category = record+ .get(3)+ .map_or(Category::Unknown, Category::from_token);+ let reference = record.get(4).map(str::trim).filter(|note| !note.is_empty());+ parsed += 1;+ if insert_fingerprint(+ conn,+ source_id,+ &NewFingerprint {+ kind,+ value,+ label,+ category,+ reference,+ first_seen: None,+ },+ )? {+ inserted += 1;+ }+ }+ Ok((inserted, parsed))+}++/// Whether a string is a lowercase or uppercase 32 character hex digest, the+/// shape of every JA3 value and the test that skips comment and header rows.+fn is_hex_md5(value: &str) -> bool {+ value.len() == 32 && value.bytes().all(|byte| byte.is_ascii_hexdigit())+}++#[cfg(test)]+mod tests {+ use super::{CURATED_NAME, SALESFORCE_NAME, SSLBL_NAME, load_bundled};+ use crate::IntelStore;+ use crate::model::{Category, FpKind};++ fn category_of(store: &IntelStore, value: &str, source: &str) -> Option<String> {+ store+ .conn+ .query_row(+ "SELECT category FROM intel_fingerprint f+ JOIN intel_source s ON s.id = f.source_id+ WHERE f.value = ?1 AND s.name = ?2",+ rusqlite::params![value, source],+ |row| row.get(0),+ )+ .ok()+ }++ #[test]+ fn seeds_every_vendored_row() {+ let mut store = IntelStore::open_in_memory().unwrap();+ let summary = store.seed_bundled().unwrap();+ assert_eq!(summary.parsed(), 97 + 157 + 17);+ assert_eq!(summary.inserted(), summary.parsed());+ }++ #[test]+ fn seeding_twice_inserts_nothing_new() {+ let mut conn = rusqlite::Connection::open_in_memory().unwrap();+ super::super::schema::apply_migrations(&mut conn).unwrap();+ let first = load_bundled(&mut conn).unwrap();+ let second = load_bundled(&mut conn).unwrap();+ assert!(first.inserted() > 0);+ assert_eq!(second.inserted(), 0);+ assert_eq!(second.parsed(), first.parsed());+ }++ #[test]+ fn sslbl_rows_are_malware_salesforce_rows_are_benign() {+ let mut store = IntelStore::open_in_memory().unwrap();+ store.seed_bundled().unwrap();+ assert_eq!(+ category_of(&store, "1aa7bf8b97e540ca5edd75f7b8384bfa", SSLBL_NAME).as_deref(),+ Some("malware"),+ );+ assert_eq!(+ category_of(&store, "c36fb08942cf19508c08d96af22d4ffc", SALESFORCE_NAME).as_deref(),+ Some("benign"),+ );+ }++ #[test]+ fn curated_carries_its_own_categories() {+ let mut store = IntelStore::open_in_memory().unwrap();+ store.seed_bundled().unwrap();+ assert_eq!(+ category_of(&store, "72a589da586844d7f0818ce684948eea", CURATED_NAME).as_deref(),+ Some("c2"),+ );+ assert_eq!(+ category_of(&store, "8916410db85077a5460817142dcbc8de", CURATED_NAME).as_deref(),+ Some("tool"),+ );+ }++ #[test]+ fn the_same_hash_can_be_both_malicious_and_benign() {+ let mut store = IntelStore::open_in_memory().unwrap();+ store.seed_bundled().unwrap();+ let collision = "51a7ad14509fd614c7bb3a50c4982b8c";+ assert_eq!(+ category_of(&store, collision, SSLBL_NAME).as_deref(),+ Some("malware"),+ );+ assert_eq!(+ category_of(&store, collision, SALESFORCE_NAME).as_deref(),+ Some("benign"),+ );+ }++ #[test]+ fn ja4_rows_get_partial_match_columns() {+ let mut store = IntelStore::open_in_memory().unwrap();+ store.seed_bundled().unwrap();+ let parts: (Option<String>, Option<String>) = store+ .conn+ .query_row(+ "SELECT part_a, part_b FROM intel_fingerprint WHERE fp_kind = 'ja4' AND value = ?1",+ rusqlite::params!["t13d1516h2_8daaf6152771_e5627efa2ab1"],+ |row| Ok((row.get(0)?, row.get(1)?)),+ )+ .unwrap();+ assert_eq!(parts.0.as_deref(), Some("t13d1516h2"));+ assert_eq!(parts.1.as_deref(), Some("8daaf6152771"));+ let ja3_parts: (Option<String>, Option<String>) = store+ .conn+ .query_row(+ "SELECT part_a, part_b FROM intel_fingerprint WHERE fp_kind = 'ja3' LIMIT 1",+ [],+ |row| Ok((row.get(0)?, row.get(1)?)),+ )+ .unwrap();+ assert_eq!(ja3_parts, (None, None));+ }++ #[test]+ fn category_tokens_parse() {+ assert_eq!(Category::from_token("malware"), Category::Malware);+ assert_eq!(Category::from_token(" C2 "), Category::C2);+ assert_eq!(Category::from_token("garbage"), Category::Unknown);+ }++ #[test]+ fn fp_kind_tokens_parse() {+ assert_eq!(FpKind::from_token("ja4"), Some(FpKind::Ja4));+ assert_eq!(FpKind::from_token("zz"), None);+ }+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/signal.rs b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/signal.rsnew file mode 100644index 00000000..404b91f8--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/src/signal.rs@@ -0,0 +1,417 @@+// Β©AngelaMos | 2026+// signal.rs++//! The classifiers the detection rules read fingerprints and headers through.+//!+//! These are deliberately pure: a string in, a small verdict out, no database+//! and no state. That keeps the judgement calls, which are the part most likely+//! to be wrong, testable against named example values.+//!+//! Two families of classifier live here. The first maps a fingerprint or a+//! User-Agent to a client family, so a request that calls itself a browser can+//! be checked against what its fingerprint actually is. The second maps a JA4T+//! or a User-Agent to a coarse operating-system class, so the operating system+//! a connection claims can be checked against the one its TCP stack reveals.+//!+//! The operating-system heuristic is intentionally coarse: Windows against+//! everything Unix-like. It rests on one signature that is stable across stack+//! versions and well documented: Microsoft Windows does not send the TCP+//! timestamp option (kind 8) on a SYN, while Unix-like stacks do, and within a+//! stack that sends no timestamp, Windows orders the window-scale option before+//! the SACK-permitted option where Linux without timestamps does the reverse.+//! Anything that does not match a known signature is left unclassified rather+//! than guessed, so the mismatch rule never fires on an ambiguous stack.+//!+//! Sources: the JA4T specification and the FoxIO JA4T write-up+//! (blog.foxio.io/ja4t-tcp-fingerprinting), and the p0f v3 SYN signature+//! database it builds on for the per-operating-system option layouts.++use crate::model::Category;++/// A coarse operating-system class, the resolution the SYN signature can carry+/// without guessing. Finer naming from one packet is not reliable, so the+/// mismatch rule works at this granularity on purpose.+#[derive(Debug, Clone, Copy, PartialEq, Eq)]+pub enum OsClass {+ Windows,+ Unix,+}++impl OsClass {+ /// A short token for the class, used when describing an alert.+ pub const fn as_str(self) -> &'static str {+ match self {+ OsClass::Windows => "windows",+ OsClass::Unix => "unix",+ }+ }++ /// Parses a class token back into a class, the inverse of `as_str`. This+ /// reads the operating system an observation already resolved and stored,+ /// which is not a User-Agent and must not be run back through the loose+ /// User-Agent classifier.+ pub fn from_token(token: &str) -> Option<OsClass> {+ match token {+ "windows" => Some(OsClass::Windows),+ "unix" => Some(OsClass::Unix),+ _ => None,+ }+ }+}++/// The operating system a User-Agent string claims, read from the platform+/// token every mainstream browser places near the front of the string.+///+/// Returns `None` when no platform token is recognised, so an unusual or absent+/// User-Agent never produces a false claim to compare against.+#[must_use]+pub fn ua_os_class(user_agent: &str) -> Option<OsClass> {+ const UNIX_TOKENS: &[&str] = &[+ "android",+ "linux",+ "mac os x",+ "macintosh",+ "iphone",+ "ipad",+ "ipod",+ " cros ",+ "x11",+ "freebsd",+ "openbsd",+ "netbsd",+ ];+ let ua = user_agent.to_ascii_lowercase();+ if ua.contains("windows") {+ return Some(OsClass::Windows);+ }+ if UNIX_TOKENS.iter().any(|token| ua.contains(token)) {+ return Some(OsClass::Unix);+ }+ None+}++/// The operating-system class a JA4T implies from its TCP option layout.+///+/// The JA4T value is `window_options_mss_windowscale`; only the options field,+/// a dash separated list of TCP option kind numbers, is read here. A timestamp+/// option marks a Unix-like stack. Its absence, combined with the window-scale+/// option preceding the SACK-permitted option, marks Windows. Every other+/// layout, including a Unix stack with timestamps disabled, is left+/// unclassified.+#[must_use]+pub fn ja4t_os_class(ja4t: &str) -> Option<OsClass> {+ let options = ja4t.split('_').nth(1)?;+ if options.is_empty() || options == "0" {+ return None;+ }+ let kinds: Vec<&str> = options.split('-').collect();+ if kinds.contains(&"8") {+ return Some(OsClass::Unix);+ }+ let window_scale = kinds.iter().position(|kind| *kind == "3");+ let sack = kinds.iter().position(|kind| *kind == "4");+ if let (Some(window_scale), Some(sack)) = (window_scale, sack) {+ if window_scale < sack {+ return Some(OsClass::Windows);+ }+ }+ None+}++/// A client software family, coarse enough that a fingerprint label and a+/// User-Agent can be compared even when they word the same software+/// differently.+#[derive(Debug, Clone, Copy, PartialEq, Eq)]+pub enum Family {+ Chrome,+ Firefox,+ Safari,+ Edge,+ Opera,+ Brave,+ Curl,+ Wget,+ Python,+ Go,+ OkHttp,+ Java,+ Tor,+}++impl Family {+ /// A short token for the family, used when describing an alert.+ pub const fn as_str(self) -> &'static str {+ match self {+ Family::Chrome => "chrome",+ Family::Firefox => "firefox",+ Family::Safari => "safari",+ Family::Edge => "edge",+ Family::Opera => "opera",+ Family::Brave => "brave",+ Family::Curl => "curl",+ Family::Wget => "wget",+ Family::Python => "python",+ Family::Go => "go-http",+ Family::OkHttp => "okhttp",+ Family::Java => "java",+ Family::Tor => "tor",+ }+ }++ /// Whether this family is a human-driven web browser rather than a script,+ /// library, or command line client. The mismatch rule turns on this line:+ /// a request that claims a browser but fingerprints as one of the others is+ /// the impersonation worth flagging.+ pub const fn is_browser(self) -> bool {+ matches!(+ self,+ Family::Chrome+ | Family::Firefox+ | Family::Safari+ | Family::Edge+ | Family::Opera+ | Family::Brave+ )+ }+}++/// The family a User-Agent string claims to be.+///+/// Browsers are checked before the engines they embed, because a Chromium+/// derivative carries the Chrome and Safari tokens too, and a script that sets+/// a real browser string would otherwise be read as that browser.+#[must_use]+pub fn ua_family(user_agent: &str) -> Option<Family> {+ let ua = user_agent.to_ascii_lowercase();+ if ua.contains("edg/") || ua.contains("edga/") || ua.contains("edgios/") {+ return Some(Family::Edge);+ }+ if ua.contains("opr/") || ua.contains("opera") {+ return Some(Family::Opera);+ }+ if ua.contains("brave") {+ return Some(Family::Brave);+ }+ if ua.contains("firefox") || ua.contains("fxios") {+ return Some(Family::Firefox);+ }+ if ua.contains("chrome") || ua.contains("chromium") || ua.contains("crios") {+ return Some(Family::Chrome);+ }+ if ua.contains("safari") {+ return Some(Family::Safari);+ }+ if ua.contains("curl") {+ return Some(Family::Curl);+ }+ if ua.contains("wget") {+ return Some(Family::Wget);+ }+ if ua.contains("python") || ua.contains("urllib") || ua.contains("aiohttp") {+ return Some(Family::Python);+ }+ if ua.contains("go-http-client") {+ return Some(Family::Go);+ }+ if ua.contains("okhttp") {+ return Some(Family::OkHttp);+ }+ if ua.contains("java") {+ return Some(Family::Java);+ }+ None+}++/// The family an intelligence label names, by keyword.+///+/// This reads the human label a feed attached to a fingerprint, so it+/// recognises the same software the User-Agent classifier does and nothing it+/// cannot name with confidence.+#[must_use]+pub fn label_family(label: &str) -> Option<Family> {+ let label = label.to_ascii_lowercase();+ if label.contains("edge") {+ return Some(Family::Edge);+ }+ if label.contains("opera") {+ return Some(Family::Opera);+ }+ if label.contains("brave") {+ return Some(Family::Brave);+ }+ if label.contains("firefox") {+ return Some(Family::Firefox);+ }+ if label.contains("chrome") || label.contains("chromium") {+ return Some(Family::Chrome);+ }+ if label.contains("safari") {+ return Some(Family::Safari);+ }+ if label.contains("curl") {+ return Some(Family::Curl);+ }+ if label.contains("wget") {+ return Some(Family::Wget);+ }+ if label.contains("python") || label.contains("requests") || label.contains("urllib") {+ return Some(Family::Python);+ }+ if label.contains("go-http") || label.contains("golang") {+ return Some(Family::Go);+ }+ if label.contains("okhttp") {+ return Some(Family::OkHttp);+ }+ if label.contains("java") {+ return Some(Family::Java);+ }+ if label.contains("tor") {+ return Some(Family::Tor);+ }+ None+}++/// Whether an observed fingerprint should be read as a non-browser client.+///+/// A label that names a script or tool says so directly. A category of tool,+/// malware, or command and control says it too, even when the label is just a+/// family name like TrickBot, because none of those are a browser. A benign or+/// unknown category with an unrecognised label is left alone, so the mismatch+/// rule needs a real reason to call something not a browser.+#[must_use]+pub fn label_is_non_browser(label: &str, category: Category) -> bool {+ if label_family(label).is_some_and(|family| !family.is_browser()) {+ return true;+ }+ matches!(category, Category::Tool | Category::Malware | Category::C2)+}++/// Whether an observed fingerprint should be read as a browser, used to suppress+/// the mismatch rule when both sides agree the client is a browser.+#[must_use]+pub fn label_is_browser(label: &str) -> bool {+ label_family(label).is_some_and(Family::is_browser)+}++#[cfg(test)]+mod tests {+ use super::{+ Family, OsClass, ja4t_os_class, label_family, label_is_browser, label_is_non_browser,+ ua_family, ua_os_class,+ };+ use crate::model::Category;++ #[test]+ fn windows_user_agent_is_windows() {+ let ua = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/120.0";+ assert_eq!(ua_os_class(ua), Some(OsClass::Windows));+ }++ #[test]+ fn unix_user_agents_are_unix() {+ for ua in [+ "Mozilla/5.0 (X11; Linux x86_64) Firefox/121.0",+ "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) Safari/605.1",+ "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X)",+ "Mozilla/5.0 (Linux; Android 14) Chrome/120.0",+ ] {+ assert_eq!(ua_os_class(ua), Some(OsClass::Unix), "{ua}");+ }+ }++ #[test]+ fn unknown_platform_is_unclassified() {+ assert_eq!(ua_os_class("curl/8.4.0"), None);+ assert_eq!(ua_os_class(""), None);+ }++ #[test]+ fn ja4t_with_timestamp_is_unix() {+ assert_eq!(ja4t_os_class("29200_2-4-8-1-3_1424_7"), Some(OsClass::Unix));+ assert_eq!(ja4t_os_class("65535_2-4-8-1-3_1460_6"), Some(OsClass::Unix));+ }++ #[test]+ fn ja4t_windows_layout_is_windows() {+ assert_eq!(+ ja4t_os_class("64240_2-1-3-1-1-4_1460_8"),+ Some(OsClass::Windows)+ );+ }++ #[test]+ fn ja4t_ambiguous_layout_is_unclassified() {+ assert_eq!(ja4t_os_class("64240_2-4-1-3_1460_7"), None);+ assert_eq!(ja4t_os_class("64240_0_0_0"), None);+ assert_eq!(ja4t_os_class("nonsense"), None);+ }++ #[test]+ fn windows_scale_byte_is_not_read_as_a_timestamp_option() {+ let windows = ja4t_os_class("64240_2-1-3-1-1-4_1460_8");+ assert_eq!(windows, Some(OsClass::Windows));+ }++ #[test]+ fn os_class_tokens_round_trip() {+ assert_eq!(+ OsClass::from_token(OsClass::Windows.as_str()),+ Some(OsClass::Windows)+ );+ assert_eq!(+ OsClass::from_token(OsClass::Unix.as_str()),+ Some(OsClass::Unix)+ );+ assert_eq!(OsClass::from_token("plan9"), None);+ }++ #[test]+ fn browser_user_agents_classify() {+ assert_eq!(+ ua_family("Mozilla/5.0 (Windows NT 10.0) Gecko Firefox/121.0"),+ Some(Family::Firefox)+ );+ assert_eq!(+ ua_family(+ "Mozilla/5.0 (Macintosh) AppleWebKit/537.36 (KHTML) Chrome/120.0 Safari/537.36"+ ),+ Some(Family::Chrome)+ );+ assert_eq!(+ ua_family("Mozilla/5.0 (Macintosh) AppleWebKit/605.1 Version/17.0 Safari/605.1"),+ Some(Family::Safari)+ );+ }++ #[test]+ fn edge_and_opera_are_not_read_as_chrome() {+ assert_eq!(+ ua_family("Mozilla/5.0 (Windows NT 10.0) Chrome/120.0 Safari/537.36 Edg/120.0"),+ Some(Family::Edge)+ );+ assert_eq!(+ ua_family("Mozilla/5.0 (Windows NT 10.0) Chrome/120.0 Safari/537.36 OPR/106.0"),+ Some(Family::Opera)+ );+ }++ #[test]+ fn tool_user_agents_classify() {+ assert_eq!(ua_family("curl/8.4.0"), Some(Family::Curl));+ assert_eq!(ua_family("python-requests/2.31.0"), Some(Family::Python));+ assert_eq!(ua_family("Go-http-client/2.0"), Some(Family::Go));+ }++ #[test]+ fn labels_classify_and_categories_decide_non_browser() {+ assert_eq!(label_family("Google Chrome"), Some(Family::Chrome));+ assert_eq!(label_family("curl"), Some(Family::Curl));+ assert!(label_is_browser("Google Chrome"));+ assert!(!label_is_browser("curl"));+ assert!(label_is_non_browser("curl", Category::Benign));+ assert!(label_is_non_browser("TrickBot", Category::Malware));+ assert!(!label_is_non_browser("Google Chrome", Category::Benign));+ assert!(!label_is_non_browser("unrecognised", Category::Benign));+ }+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/tests/detect.rs b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/tests/detect.rsnew file mode 100644index 00000000..5143341b--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp-intel/tests/detect.rs@@ -0,0 +1,340 @@+// Β©AngelaMos | 2026+// detect.rs++//! End to end tests for the detection engine.+//!+//! Each test drives a short sequence of hand built fingerprint events through a+//! store and checks that the right rule fires, and just as importantly that the+//! quiet cases stay quiet. The events are synthetic on purpose: the engine+//! consumes events, not packets, so building them directly is the honest seam+//! to test the rules at.++use tlsfp_core::fingerprint::{Ja3, Ja4Family};+use tlsfp_core::{FingerprintEvent, StreamEvent};+use tlsfp_intel::{AlertSeverity, DetectConfig, IntelStore, Rule};++const CURL_JA4: &str = "t13d1234h1_aaaaaaaaaaaa_bbbbbbbbbbbb";+const MALWARE_JA4: &str = "t10d070600_c50f5591e341_1a3805c3aa63";+const CHROME_JA4: &str = "t13d1516h2_8daaf6152771_e5627efa2ab1";+const BROWSER_UA: &str = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0 Safari/537.36";+const CURL_UA: &str = "curl/8.4.0";+const UNIX_JA4T: &str = "29200_2-4-8-1-3_1424_7";+const WINDOWS_JA4T: &str = "64240_2-1-3-1-1-4_1460_8";++const FEED: &str = r#"[+ {"application":"Chrome","os":"Windows","ja4_fingerprint":"t13d1516h2_8daaf6152771_e5627efa2ab1"},+ {"application":"curl","library":"OpenSSL","ja4_fingerprint":"t13d1234h1_aaaaaaaaaaaa_bbbbbbbbbbbb"},+ {"application":"Loader","notes":"known malware stealer","ja4_fingerprint":"t10d070600_c50f5591e341_1a3805c3aa63"}+]"#;++fn store() -> IntelStore {+ let mut store = IntelStore::open_in_memory().unwrap();+ store.import_ja4db(FEED).unwrap();+ store+}++fn cfg() -> DetectConfig {+ DetectConfig {+ window_secs: 86_400,+ rotation_threshold: 2,+ monoculture_threshold: 2,+ }+}++fn client_hello(ip: &str, ts: u64, ja4: &str) -> FingerprintEvent {+ FingerprintEvent {+ ts_nanos: ts,+ src: format!("{ip}:1000").parse().unwrap(),+ dst: "10.0.0.250:443".parse().unwrap(),+ event: StreamEvent::ClientHello {+ ja3: Ja3::from_digest([0u8; 16]),+ ja3_raw: "raw".into(),+ ja4: Ja4Family::new(ja4.into(), "raw".into()),+ sni: None,+ alpn: None,+ },+ }+}++fn http_request(ip: &str, ts: u64, ua: &str) -> FingerprintEvent {+ FingerprintEvent {+ ts_nanos: ts,+ src: format!("{ip}:1000").parse().unwrap(),+ dst: "10.0.0.250:80".parse().unwrap(),+ event: StreamEvent::HttpRequest {+ ja4h: Ja4Family::new(+ "ge20nn000000_000000000000_000000000000".into(),+ "raw".into(),+ ),+ method: "GET".into(),+ host: Some("example.com".into()),+ user_agent: Some(ua.into()),+ },+ }+}++fn tcp_syn(ip: &str, ts: u64, ja4t: &str) -> FingerprintEvent {+ FingerprintEvent {+ ts_nanos: ts,+ src: format!("{ip}:1000").parse().unwrap(),+ dst: "10.0.0.250:443".parse().unwrap(),+ event: StreamEvent::TcpSyn { ja4t: ja4t.into() },+ }+}++fn fires(alerts: &[tlsfp_intel::Alert], rule: Rule) -> bool {+ alerts.iter().any(|alert| alert.rule == rule)+}++#[test]+fn known_bad_fires_on_malicious_fingerprint() {+ let mut store = store();+ let alerts = store+ .detect_with(+ &client_hello("10.0.0.1", 1_000_000_000, MALWARE_JA4),+ &cfg(),+ )+ .unwrap();+ let known_bad = alerts+ .iter()+ .find(|alert| alert.rule == Rule::KnownBad)+ .expect("a malicious fingerprint should raise known_bad");+ assert_eq!(known_bad.severity, AlertSeverity::High);+ assert!(known_bad.detail.contains("Loader"));+ assert!(known_bad.detail.contains("prevalence"));+ assert_eq!(known_bad.score, Some(1.0));+}++#[test]+fn ua_mismatch_browser_claim_over_tool_handshake() {+ let mut store = store();+ let config = cfg();+ store+ .detect_with(&client_hello("10.0.0.2", 1_000_000_000, CURL_JA4), &config)+ .unwrap();+ let alerts = store+ .detect_with(+ &http_request("10.0.0.2", 2_000_000_000, BROWSER_UA),+ &config,+ )+ .unwrap();+ let mismatch = alerts+ .iter()+ .find(|alert| alert.rule == Rule::UaMismatch)+ .expect("a browser User-Agent over a curl handshake is the headline mismatch");+ assert_eq!(mismatch.severity, AlertSeverity::High);+ assert!(mismatch.detail.to_lowercase().contains("curl"));+ assert!(mismatch.title.to_lowercase().contains("chrome"));+}++#[test]+fn ua_mismatch_fires_from_the_tls_side_too() {+ let mut store = store();+ let config = cfg();+ store+ .detect_with(+ &http_request("10.0.0.3", 1_000_000_000, BROWSER_UA),+ &config,+ )+ .unwrap();+ let alerts = store+ .detect_with(&client_hello("10.0.0.3", 2_000_000_000, CURL_JA4), &config)+ .unwrap();+ assert!(fires(&alerts, Rule::UaMismatch));+}++#[test]+fn an_honest_tool_user_agent_does_not_mismatch() {+ let mut store = store();+ let config = cfg();+ store+ .detect_with(&client_hello("10.0.0.4", 1_000_000_000, CURL_JA4), &config)+ .unwrap();+ let alerts = store+ .detect_with(&http_request("10.0.0.4", 2_000_000_000, CURL_UA), &config)+ .unwrap();+ assert!(!fires(&alerts, Rule::UaMismatch));+}++#[test]+fn a_real_browser_does_not_mismatch_its_own_handshake() {+ let mut store = store();+ let config = cfg();+ store+ .detect_with(+ &client_hello("10.0.0.5", 1_000_000_000, CHROME_JA4),+ &config,+ )+ .unwrap();+ let alerts = store+ .detect_with(+ &http_request("10.0.0.5", 2_000_000_000, BROWSER_UA),+ &config,+ )+ .unwrap();+ assert!(!fires(&alerts, Rule::UaMismatch));+}++#[test]+fn os_mismatch_windows_claim_over_unix_stack() {+ let mut store = store();+ let config = cfg();+ store+ .detect_with(&tcp_syn("10.0.0.6", 1_000_000_000, UNIX_JA4T), &config)+ .unwrap();+ let alerts = store+ .detect_with(+ &http_request("10.0.0.6", 2_000_000_000, BROWSER_UA),+ &config,+ )+ .unwrap();+ let mismatch = alerts+ .iter()+ .find(|alert| alert.rule == Rule::OsMismatch)+ .expect("a Windows User-Agent over a Unix SYN should raise os_mismatch");+ assert_eq!(mismatch.severity, AlertSeverity::Medium);+ assert!(mismatch.title.contains("windows"));+ assert!(mismatch.title.contains("unix"));+}++#[test]+fn os_mismatch_fires_from_the_syn_side_too() {+ let mut store = store();+ let config = cfg();+ store+ .detect_with(+ &http_request("10.0.0.7", 1_000_000_000, BROWSER_UA),+ &config,+ )+ .unwrap();+ let alerts = store+ .detect_with(&tcp_syn("10.0.0.7", 2_000_000_000, UNIX_JA4T), &config)+ .unwrap();+ assert!(fires(&alerts, Rule::OsMismatch));+}++#[test]+fn a_consistent_operating_system_does_not_mismatch() {+ let mut store = store();+ let config = cfg();+ store+ .detect_with(&tcp_syn("10.0.0.8", 1_000_000_000, WINDOWS_JA4T), &config)+ .unwrap();+ let alerts = store+ .detect_with(+ &http_request("10.0.0.8", 2_000_000_000, BROWSER_UA),+ &config,+ )+ .unwrap();+ assert!(!fires(&alerts, Rule::OsMismatch));+}++#[test]+fn first_seen_fires_once_per_fingerprint() {+ let mut store = store();+ let config = cfg();+ let first = store+ .detect_with(+ &client_hello("10.0.0.9", 1_000_000_000, CHROME_JA4),+ &config,+ )+ .unwrap();+ assert!(fires(&first, Rule::FirstSeen));+ let again = store+ .detect_with(+ &client_hello("10.0.0.10", 2_000_000_000, CHROME_JA4),+ &config,+ )+ .unwrap();+ assert!(!fires(&again, Rule::FirstSeen));+}++#[test]+fn rotation_fires_when_one_address_cycles_fingerprints() {+ let mut store = store();+ let config = cfg();+ let ip = "10.0.0.11";+ let first = store+ .detect_with(+ &client_hello(ip, 1_000_000_000, "t13d1516h2_111111111111_222222222222"),+ &config,+ )+ .unwrap();+ let second = store+ .detect_with(+ &client_hello(ip, 2_000_000_000, "t13d1516h2_333333333333_444444444444"),+ &config,+ )+ .unwrap();+ let third = store+ .detect_with(+ &client_hello(ip, 3_000_000_000, "t13d1516h2_555555555555_666666666666"),+ &config,+ )+ .unwrap();+ assert!(!fires(&first, Rule::FpRotation));+ assert!(!fires(&second, Rule::FpRotation));+ assert!(fires(&third, Rule::FpRotation));+}++#[test]+fn monoculture_fires_when_one_fingerprint_spans_addresses() {+ let mut store = store();+ let config = cfg();+ let ja4 = "t13d1516h2_777777777777_888888888888";+ let first = store+ .detect_with(&client_hello("10.1.0.1", 1_000_000_000, ja4), &config)+ .unwrap();+ let second = store+ .detect_with(&client_hello("10.1.0.2", 2_000_000_000, ja4), &config)+ .unwrap();+ let third = store+ .detect_with(&client_hello("10.1.0.3", 3_000_000_000, ja4), &config)+ .unwrap();+ assert!(!fires(&first, Rule::Monoculture));+ assert!(!fires(&second, Rule::Monoculture));+ assert!(fires(&third, Rule::Monoculture));+}++#[test]+fn alerts_persist_and_round_trip_through_the_store() {+ let mut store = store();+ store+ .detect_with(+ &client_hello("10.2.0.1", 1_000_000_000, MALWARE_JA4),+ &cfg(),+ )+ .unwrap();+ let recent = store.recent_alerts(10).unwrap();+ assert!(+ recent+ .iter()+ .any(|alert| alert.rule == Rule::KnownBad && alert.severity == AlertSeverity::High)+ );+ let counts = store.alert_counts().unwrap();+ assert!(+ counts+ .iter()+ .any(|(rule, count)| *rule == Rule::KnownBad && *count >= 1)+ );+}++#[test]+fn correlation_respects_the_time_window() {+ let mut store = store();+ let config = DetectConfig {+ window_secs: 1,+ rotation_threshold: 2,+ monoculture_threshold: 2,+ };+ store+ .detect_with(&client_hello("10.3.0.1", 0, CURL_JA4), &config)+ .unwrap();+ let alerts = store+ .detect_with(+ &http_request("10.3.0.1", 10_000_000_000, BROWSER_UA),+ &config,+ )+ .unwrap();+ assert!(!fires(&alerts, Rule::UaMismatch));+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp/Cargo.toml b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp/Cargo.tomlindex b6a77ed3..1c3b35a8 100644--- a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp/Cargo.toml+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp/Cargo.toml@@ -21,6 +21,7 @@ workspace = true[dependencies]tlsfp-core.workspace = true+tlsfp-intel.workspace = trueanyhow.workspace = truetracing.workspace = truetracing-subscriber.workspace = true@@ -28,7 +29,6 @@ pcap-parser.workspace = truepcap.workspace = truetokio.workspace = trueflume.workspace = true-rusqlite.workspace = trueaxum.workspace = truetower-http.workspace = truetower.workspace = truediff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp/src/cli.rs b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp/src/cli.rsindex 5442e42f..904fedbd 100644--- a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp/src/cli.rs+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/crates/tlsfp/src/cli.rs@@ -1,6 +1,9 @@// Β©AngelaMos | 2026// cli.rs+use std::io::Write as _;+use std::path::{Path, PathBuf};+use anyhow::{Context, Result};use clap::{Parser, Subcommand};use tracing_subscriber::EnvFilter;@@ -8,6 +11,11 @@ use tracing_subscriber::EnvFilter;use tlsfp_core::{FingerprintEvent, PcapFileSource, Pipeline, PipelineConfig, SourceError};use crate::live::{DEFAULT_BPF_FILTER, LiveConfig, LiveSource};+use tlsfp_intel::{Alert, FpKind, IntelStore, MatchReport, MatchStrength, default_db_path};++/// How many alerts `intel alerts` shows when no count is given, and the floor a+/// zero or negative count is raised to.+const DEFAULT_ALERT_LIMIT: i64 = 50;/// JA3/JA4 TLS fingerprinting tool.///@@ -30,11 +38,23 @@ pub enum Command {/// Fingerprint every TLS and QUIC handshake in a packet capture file.Pcap {/// Path to a pcap or pcapng file.- path: std::path::PathBuf,+ path: PathBuf,/// Emit one JSON object per event instead of readable lines.#[arg(long)]json: bool,++ /// Match each fingerprint against the intelligence database.+ #[arg(long)]+ intel: bool,++ /// Run the detection rules, recording observations and raising alerts.+ #[arg(long)]+ detect: bool,++ /// Path to the intelligence database, defaulting to the data directory.+ #[arg(long)]+ db: Option<PathBuf>,},/// Capture live from a network interface and fingerprint in real time.@@ -76,6 +96,18 @@ pub enum Command {/// instead of switching it to promiscuous mode.#[arg(long)]no_promisc: bool,++ /// Match each fingerprint against the intelligence database.+ #[arg(long)]+ intel: bool,++ /// Run the detection rules, recording observations and raising alerts.+ #[arg(long)]+ detect: bool,++ /// Path to the intelligence database, defaulting to the data directory.+ #[arg(long)]+ db: Option<PathBuf>,},/// Serve the web dashboard and HTTP API.@@ -84,6 +116,76 @@ pub enum Command {#[arg(default_value = "127.0.0.1:8080")]bind: String,},++ /// Manage the local threat intelligence database.+ Intel {+ #[command(subcommand)]+ action: IntelCommand,+ },+}++/// The subcommands under `tlsfp intel`.+#[derive(Debug, Subcommand)]+pub enum IntelCommand {+ /// Create the database if needed and load the three bundled feeds.+ Seed {+ /// Path to the intelligence database, defaulting to the data directory.+ #[arg(long)]+ db: Option<PathBuf>,+ },++ /// Import a ja4db.com JSON export, validating every record on the way in.+ Import {+ /// Path to the JSON file, or - to read standard input.+ path: PathBuf,++ /// Path to the intelligence database, defaulting to the data directory.+ #[arg(long)]+ db: Option<PathBuf>,+ },++ /// Look up one fingerprint and print its verdict.+ Lookup {+ /// Fingerprint kind: ja3, ja3s, ja4, ja4s, ja4h, ja4x, ja4t, or ja4ts.+ kind: String,++ /// The fingerprint value to look up.+ value: String,++ /// Emit the report as JSON instead of readable lines.+ #[arg(long)]+ json: bool,++ /// Path to the intelligence database, defaulting to the data directory.+ #[arg(long)]+ db: Option<PathBuf>,+ },++ /// Show what the database holds, by feed and by category.+ Stats {+ /// Emit the summary as JSON instead of readable lines.+ #[arg(long)]+ json: bool,++ /// Path to the intelligence database, defaulting to the data directory.+ #[arg(long)]+ db: Option<PathBuf>,+ },++ /// Show the most recent alerts the detection rules have raised.+ Alerts {+ /// Emit the alerts as JSON instead of readable lines.+ #[arg(long)]+ json: bool,++ /// How many alerts to show, newest first.+ #[arg(long, default_value_t = DEFAULT_ALERT_LIMIT)]+ limit: i64,++ /// Path to the intelligence database, defaulting to the data directory.+ #[arg(long)]+ db: Option<PathBuf>,+ },}impl Cli {@@ -102,16 +204,51 @@ impl Cli {pub fn run(self) -> Result<()> {match self.command {- Command::Pcap { path, json } => run_pcap(&path, json),+ Command::Pcap {+ path,+ json,+ intel,+ detect,+ db,+ } => run_pcap(&path, json, intel, detect, db.as_deref()),Command::Live {interface,json,filter,no_promisc,- } => run_live(&interface, json, filter, !no_promisc),+ intel,+ detect,+ db,+ } => run_live(+ &interface,+ json,+ filter,+ !no_promisc,+ intel,+ detect,+ db.as_deref(),+ ),Command::Serve { bind } => {anyhow::bail!("dashboard on {bind} is not wired up yet")}+ Command::Intel { action } => action.run(),+ }+ }+}++impl IntelCommand {+ fn run(self) -> Result<()> {+ match self {+ IntelCommand::Seed { db } => run_intel_seed(db),+ IntelCommand::Import { path, db } => run_intel_import(&path, db),+ IntelCommand::Lookup {+ kind,+ value,+ json,+ db,+ } => run_intel_lookup(&kind, &value, json, db),+ IntelCommand::Stats { json, db } => run_intel_stats(json, db),+ IntelCommand::Alerts { json, limit, db } => run_intel_alerts(json, limit, db),}}}@@ -121,36 +258,33 @@ impl Cli {/// The summary goes to the log rather than stdout so that piping the output/// into a tool sees only events, while a human still learns how much of the/// capture was readable and whether the file was cut short mid packet.-fn run_pcap(path: &std::path::Path, json: bool) -> Result<()> {+fn run_pcap(path: &Path, json: bool, intel: bool, detect: bool, db: Option<&Path>) -> Result<()> {let mut source = PcapFileSource::open(path).with_context(|| format!("cannot open capture {}", path.display()))?;+ let mut store = open_for_run(intel, detect, db)?;let mut pipeline = Pipeline::new(PipelineConfig::default());let stdout = std::io::stdout().lock();let mut out = std::io::BufWriter::new(stdout);- let mut write_failure = None;+ let mut write_failure: Option<std::io::Error> = None;pipeline.run(&mut source, |event| {- use std::io::Write as _;- let result = if json {- serde_json::to_writer(&mut out, &event)- .map_err(anyhow::Error::from)- .and_then(|()| writeln!(out).map_err(anyhow::Error::from))+ if write_failure.is_some() {+ return;+ }+ let reports = if intel {+ enrich(store.as_ref(), &event)} else {- writeln!(out, "{event}").map_err(anyhow::Error::from)+ Vec::new()};- if write_failure.is_none() {- if let Err(error) = result {- write_failure = Some(error);- }+ let alerts = detect_event(store.as_mut(), detect, &event);+ if let Err(error) = write_event(&mut out, &event, reports, alerts, json) {+ write_failure = Some(error);}})?;if let Some(error) = write_failure {- return Err(error.context("writing events to stdout"));- }- {- use std::io::Write as _;- out.flush().context("flushing events to stdout")?;+ return Err(anyhow::Error::from(error).context("writing events to stdout"));}+ out.flush().context("flushing events to stdout")?;let counters = pipeline.counters();tracing::info!(@@ -178,11 +312,21 @@ fn run_pcap(path: &std::path::Path, json: bool) -> Result<()> {/// this function owns the tokio side of the bridge. The runtime is built/// here rather than in main so the file path stays a plain synchronous/// program.-fn run_live(interface: &str, json: bool, filter: String, promiscuous: bool) -> Result<()> {+#[allow(clippy::too_many_arguments, clippy::fn_params_excessive_bools)]+fn run_live(+ interface: &str,+ json: bool,+ filter: String,+ promiscuous: bool,+ intel: bool,+ detect: bool,+ db: Option<&Path>,+) -> Result<()> {let config = LiveConfig {filter,promiscuous,};+ let store = open_for_run(intel, detect, db)?;let source = LiveSource::open(interface, &config)?;tracing::info!(interface, filter = %config.filter, "live capture started");@@ -190,7 +334,7 @@ fn run_live(interface: &str, json: bool, filter: String, promiscuous: bool) -> R.enable_all().build().context("building the async runtime")?;- runtime.block_on(drive_live(source, json))+ runtime.block_on(drive_live(source, json, intel, detect, store))}/// Drains the live source through the same pipeline the file path uses.@@ -201,7 +345,13 @@ fn run_live(interface: &str, json: bool, filter: String, promiscuous: bool) -> R/// exits without ceremony. A closed stdout pipe is a normal way for a/// live session to end, so it stops the capture instead of reporting an/// error.-async fn drive_live(mut source: LiveSource, json: bool) -> Result<()> {+async fn drive_live(+ mut source: LiveSource,+ json: bool,+ intel: bool,+ detect: bool,+ mut store: Option<IntelStore>,+) -> Result<()> {let stop = source.stop_handle();tokio::spawn(async move {if tokio::signal::ctrl_c().await.is_ok() {@@ -226,7 +376,15 @@ async fn drive_live(mut source: LiveSource, json: bool) -> Result<()> {Err(error) => break Some(error),};pipeline.feed(&frame, &mut |event| {- write_live_event(&mut out, &event, json, &mut write_failure);+ write_live_event(+ &mut out,+ &mut store,+ intel,+ detect,+ &event,+ json,+ &mut write_failure,+ );});if write_failure.is_some() {break None;@@ -274,8 +432,12 @@ async fn drive_live(mut source: LiveSource, json: bool) -> Result<()> {/// Writes one event and flushes it immediately, recording the first/// failure instead of panicking inside the pipeline's sink. Later calls/// become no-ops once a write has failed.+#[allow(clippy::too_many_arguments)]fn write_live_event(out: &mut impl std::io::Write,+ store: &mut Option<IntelStore>,+ intel: bool,+ detect: bool,event: &FingerprintEvent,json: bool,failure: &mut Option<std::io::Error>,@@ -283,15 +445,345 @@ fn write_live_event(if failure.is_some() {return;}- let result = if json {- serde_json::to_writer(&mut *out, event)- .map_err(std::io::Error::from)- .and_then(|()| writeln!(out))- .and_then(|()| out.flush())+ let reports = if intel {+ enrich(store.as_ref(), event)} else {- writeln!(out, "{event}").and_then(|()| out.flush())+ Vec::new()};+ let alerts = detect_event(store.as_mut(), detect, event);+ let result = write_event(out, event, reports, alerts, json).and_then(|()| out.flush());if let Err(error) = result {*failure = Some(error);}}++/// One event plus any intelligence that matched it, the shape both the file and+/// the live path serialise. The intel field is omitted when nothing matched, so+/// a run without enrichment produces exactly the same JSON as before.+#[derive(serde::Serialize)]+struct EnrichedEvent<'a> {+ #[serde(flatten)]+ event: &'a FingerprintEvent,+ #[serde(rename = "intel", skip_serializing_if = "Vec::is_empty")]+ reports: Vec<MatchReport>,+ #[serde(rename = "alerts", skip_serializing_if = "Vec::is_empty")]+ alerts: Vec<Alert>,+}++/// Looks every fingerprint in an event up against the store, returning the+/// reports that found intelligence. A lookup error degrades to no enrichment+/// with a warning rather than ending the capture.+fn enrich(store: Option<&IntelStore>, event: &FingerprintEvent) -> Vec<MatchReport> {+ let Some(store) = store else {+ return Vec::new();+ };+ match store.match_event(event) {+ Ok(reports) => reports,+ Err(error) => {+ tracing::warn!(%error, "intelligence lookup failed for an event");+ Vec::new()+ }+ }+}++/// Runs the detection rules for one event when detection is enabled, recording+/// the observation and any alerts. A per-event failure degrades to a warning so+/// one bad record cannot end the capture.+fn detect_event(+ store: Option<&mut IntelStore>,+ detect: bool,+ event: &FingerprintEvent,+) -> Vec<Alert> {+ if !detect {+ return Vec::new();+ }+ let Some(store) = store else {+ return Vec::new();+ };+ match store.detect(event) {+ Ok(alerts) => alerts,+ Err(error) => {+ tracing::warn!(%error, "detection failed for an event");+ Vec::new()+ }+ }+}++/// Writes one event, as JSON or as a readable line, followed by any intel.+fn write_event(+ out: &mut impl std::io::Write,+ event: &FingerprintEvent,+ reports: Vec<MatchReport>,+ alerts: Vec<Alert>,+ json: bool,+) -> std::io::Result<()> {+ if json {+ let enriched = EnrichedEvent {+ event,+ reports,+ alerts,+ };+ serde_json::to_writer(&mut *out, &enriched).map_err(std::io::Error::from)?;+ writeln!(out)+ } else {+ writeln!(out, "{event}")?;+ write_intel_lines(out, &reports)?;+ write_alert_lines(out, &alerts)+ }+}++/// Writes one indented pair of lines per alert beneath its event: the rule and+/// severity that name it, then the evidence that tripped it.+fn write_alert_lines(out: &mut impl std::io::Write, alerts: &[Alert]) -> std::io::Result<()> {+ for alert in alerts {+ writeln!(+ out,+ " alert [{}] {}: {}",+ alert.severity.as_str(),+ alert.rule.as_str(),+ alert.title,+ )?;+ writeln!(out, " {}", alert.detail)?;+ }+ Ok(())+}++/// Writes one indented line per intel report beneath its event.+fn write_intel_lines(+ out: &mut impl std::io::Write,+ reports: &[MatchReport],+) -> std::io::Result<()> {+ for report in reports {+ let labels = report+ .hits+ .iter()+ .map(|hit| {+ if hit.strength == MatchStrength::Exact {+ format!("{} ({})", hit.label, hit.source)+ } else {+ format!("{} ({}, {})", hit.label, hit.source, hit.strength.as_str())+ }+ })+ .collect::<Vec<_>>()+ .join(", ");+ writeln!(+ out,+ " intel {}={} score={:.2} confidence={:.2} {labels}",+ report.kind.as_str(),+ report.verdict.as_str(),+ report.threat_score,+ report.confidence,+ )?;+ }+ Ok(())+}++/// Opens the store for a capture run. Enrichment that finds no database runs+/// without annotation rather than failing. Detection needs somewhere to record+/// observations, so it creates the database, warning that known-bad matching+/// stays dark until the feeds are seeded.+fn open_for_run(intel: bool, detect: bool, db: Option<&Path>) -> Result<Option<IntelStore>> {+ if !intel && !detect {+ return Ok(None);+ }+ let path = db.map_or_else(default_db_path, Path::to_path_buf);+ if !path.exists() {+ if detect {+ tracing::warn!(+ path = %path.display(),+ "no intelligence database found; creating one to record detections, run 'tlsfp intel seed' to enable known-bad matching"+ );+ return Ok(Some(open_or_create(&path)?));+ }+ tracing::warn!(+ path = %path.display(),+ "no intelligence database found; run 'tlsfp intel seed' first, continuing without it"+ );+ return Ok(None);+ }+ Ok(Some(open_or_create(&path)?))+}++/// Resolves the database path from the flag or the default data directory.+fn resolve_db(db: Option<PathBuf>) -> PathBuf {+ db.unwrap_or_else(default_db_path)+}++/// Opens or creates a store at `path`, used by the commands allowed to build+/// the database from scratch.+fn open_or_create(path: &Path) -> Result<IntelStore> {+ IntelStore::open(path)+ .with_context(|| format!("opening intelligence database {}", path.display()))+}++/// Opens a store that is expected to already exist, with a hint to seed first.+fn open_existing(path: &Path) -> Result<IntelStore> {+ if !path.exists() {+ anyhow::bail!(+ "no intelligence database at {}; run 'tlsfp intel seed' first",+ path.display()+ );+ }+ open_or_create(path)+}++fn run_intel_seed(db: Option<PathBuf>) -> Result<()> {+ let path = resolve_db(db);+ let mut store = open_or_create(&path)?;+ let summary = store.seed_bundled()?;+ println!(+ "seeded {} fingerprints into {}",+ summary.parsed(),+ path.display()+ );+ for feed in &summary.feeds {+ println!(+ " {:<24} {} new, {} total",+ feed.name, feed.inserted, feed.parsed+ );+ }+ Ok(())+}++fn run_intel_import(path: &Path, db: Option<PathBuf>) -> Result<()> {+ let json = read_input(path)?;+ let mut store = open_or_create(&resolve_db(db))?;+ let summary = store.import_ja4db(&json)?;+ println!(+ "imported {} fingerprints from {} ja4db records, {} skipped as invalid",+ summary.imported, summary.records, summary.skipped+ );+ Ok(())+}++fn run_intel_lookup(kind: &str, value: &str, json: bool, db: Option<PathBuf>) -> Result<()> {+ let kind = FpKind::from_token(&kind.to_ascii_lowercase()).with_context(|| {+ format!(+ "unknown fingerprint kind '{kind}'; expected ja3, ja3s, ja4, ja4s, ja4h, ja4x, ja4t, or ja4ts"+ )+ })?;+ let store = open_existing(&resolve_db(db))?;+ let report = store.match_fingerprint(kind, value)?;+ if json {+ let stdout = std::io::stdout().lock();+ serde_json::to_writer_pretty(stdout, &report).context("writing report as JSON")?;+ println!();+ } else {+ print_report(&report);+ }+ Ok(())+}++fn run_intel_stats(json: bool, db: Option<PathBuf>) -> Result<()> {+ let store = open_existing(&resolve_db(db))?;+ let stats = store.stats()?;+ if json {+ let stdout = std::io::stdout().lock();+ serde_json::to_writer_pretty(stdout, &stats).context("writing stats as JSON")?;+ println!();+ return Ok(());+ }+ println!("{} fingerprints total", stats.total);+ println!("feeds:");+ for source in &stats.sources {+ println!(+ " {:<24} {:<8} {:<14} {}",+ source.name,+ source.kind,+ source.license.as_deref().unwrap_or("-"),+ source.records,+ );+ }+ println!("by category:");+ for category in &stats.by_category {+ println!(" {:<10} {}", category.category, category.records);+ }+ Ok(())+}++fn run_intel_alerts(json: bool, limit: i64, db: Option<PathBuf>) -> Result<()> {+ let store = open_existing(&resolve_db(db))?;+ let limit = if limit <= 0 {+ DEFAULT_ALERT_LIMIT+ } else {+ limit+ };+ let alerts = store.recent_alerts(limit)?;+ if json {+ let stdout = std::io::stdout().lock();+ serde_json::to_writer_pretty(stdout, &alerts).context("writing alerts as JSON")?;+ println!();+ return Ok(());+ }+ if alerts.is_empty() {+ println!("no alerts recorded; run a capture with --detect first");+ return Ok(());+ }+ for alert in &alerts {+ print_alert(alert);+ }+ let counts = store.alert_counts()?;+ if !counts.is_empty() {+ println!("by rule:");+ for (rule, count) in &counts {+ println!(" {:<14} {count}", rule.as_str());+ }+ }+ Ok(())+}++/// Prints one alert as readable lines: a header naming when, how urgent, which+/// rule, and the subject, then the evidence beneath it.+fn print_alert(alert: &Alert) {+ let secs = alert.ts_nanos / 1_000_000_000;+ let millis = alert.ts_nanos % 1_000_000_000 / 1_000_000;+ let target = alert.ip.as_deref().unwrap_or("-");+ println!(+ "{secs}.{millis:03} [{}] {} {target} {}",+ alert.severity.as_str(),+ alert.rule.as_str(),+ alert.title,+ );+ println!(" {}", alert.detail);+}++/// Prints a lookup report as readable lines.+fn print_report(report: &MatchReport) {+ println!(+ "{} {} => {} (threat {:.2}, confidence {:.2})",+ report.kind.as_str(),+ report.observed,+ report.verdict.as_str(),+ report.threat_score,+ report.confidence,+ );+ if report.hits.is_empty() {+ println!(" no intelligence on this fingerprint");+ return;+ }+ for hit in &report.hits {+ println!(+ " {:<8} {:<18} {:<22} {}",+ hit.category.as_str(),+ hit.strength.as_str(),+ hit.label,+ hit.source,+ );+ if let Some(reference) = &hit.reference {+ println!(" {reference}");+ }+ }+}++/// Reads the importer's input from a file or from standard input for `-`.+fn read_input(path: &Path) -> Result<String> {+ if path.as_os_str() == "-" {+ let mut buffer = String::new();+ std::io::Read::read_to_string(&mut std::io::stdin(), &mut buffer)+ .context("reading ja4db JSON from standard input")?;+ Ok(buffer)+ } else {+ std::fs::read_to_string(path)+ .with_context(|| format!("reading ja4db JSON from {}", path.display()))+ }+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/dev.compose.yml b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/dev.compose.ymlnew file mode 100644index 00000000..342e5917--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/dev.compose.yml@@ -0,0 +1,74 @@+# =============================================================================+# Β©AngelaMos | 2026+# dev.compose.yml+# =============================================================================+# Development compose: nginx fronts the Vite dev server (HMR) and proxies /api+# to the tlsfp backend. The backend lives under the `backend` profile and is+# not started by default until the serve command is implemented.+# docker compose -f dev.compose.yml up+# docker compose -f dev.compose.yml --profile backend up+# Uses .env.development+# =============================================================================++name: ${APP_NAME:-tlsfp}-dev++services:+ nginx:+ image: nginx:1.27-alpine+ container_name: ${APP_NAME:-tlsfp}-nginx-dev+ ports:+ - "${NGINX_HOST_PORT:-48418}:80"+ volumes:+ - ./infra/nginx/nginx.conf:/etc/nginx/nginx.conf:ro+ - ./infra/nginx/dev.nginx:/etc/nginx/conf.d/default.conf:ro+ depends_on:+ frontend:+ condition: service_started+ networks:+ - app+ restart: unless-stopped++ frontend:+ build:+ context: ./frontend+ dockerfile: ../infra/docker/vite.dev+ container_name: ${APP_NAME:-tlsfp}-frontend-dev+ ports:+ - "${FRONTEND_HOST_PORT:-46494}:5173"+ volumes:+ - ./frontend:/app+ - frontend_modules:/app/node_modules+ environment:+ - VITE_API_URL=${VITE_API_URL:-/api}+ - VITE_API_TARGET=${VITE_API_TARGET:-http://tlsfp:8080}+ - VITE_APP_TITLE=${VITE_APP_TITLE:-JA3/JA4 TLS Fingerprinting (Dev)}+ networks:+ - app+ restart: unless-stopped++ tlsfp:+ build:+ context: .+ dockerfile: infra/docker/tlsfp.dev+ container_name: ${APP_NAME:-tlsfp}-backend-dev+ command: ["cargo", "watch", "-x", "run --bin tlsfp -- serve 0.0.0.0:8080"]+ profiles:+ - backend+ environment:+ - RUST_LOG=${RUST_LOG:-tlsfp=debug}+ volumes:+ - .:/workspace+ - tlsfp_target:/workspace/target+ - tlsfp_data:/data+ networks:+ - app+ restart: unless-stopped++networks:+ app:+ driver: bridge++volumes:+ frontend_modules:+ tlsfp_target:+ tlsfp_data:diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/.dockerignore b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/.dockerignorenew file mode 100644index 00000000..a0256ec7--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/.dockerignore@@ -0,0 +1,15 @@+node_modules+build+dist+.git+.gitignore+*.md+.env*+.vscode+.idea+*.log+npm-debug.log*+pnpm-debug.log*+.DS_Store+coverage+.nyc_outputdiff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/.gitignore b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/.gitignorenew file mode 100644index 00000000..61cb0c2e--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/.gitignore@@ -0,0 +1,25 @@+# Logs+logs+*.log+npm-debug.log*+yarn-debug.log*+yarn-error.log*+pnpm-debug.log*+lerna-debug.log*++node_modules+dist+dist-ssr+*.local+.vite++# Editor directories and files+.vscode/*+!.vscode/extensions.json+.idea+.DS_Store+*.suo+*.ntvs*+*.njsproj+*.sln+*.sw?diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/.npmrc b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/.npmrcnew file mode 100644index 00000000..a3eb4719--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/.npmrc@@ -0,0 +1,4 @@+# Β©AngelaMos | 2026+# .npmrc+strict-dep-builds=false+auto-install-peers=truediff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/.stylelintignore b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/.stylelintignorenew file mode 100644index 00000000..37da03e1--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/.stylelintignore@@ -0,0 +1,22 @@+# Β©AngelaMos | 2025+# .stylelintignore++# Dependencies+node_modules/++# Production builds+dist/+build/+out/++# JS/TS files+**/*.js+**/*.jsx+**/*.ts+**/*.tsx++# Generated files+*.min.css++# Error system styles - ignore from linting+src/core/app/_toastStyles.scssdiff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/biome.json b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/biome.jsonnew file mode 100644index 00000000..7f29029a--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/biome.json@@ -0,0 +1,94 @@+{+ "$schema": "https://biomejs.dev/schemas/2.3.8/schema.json",+ "vcs": {+ "enabled": true,+ "clientKind": "git",+ "useIgnoreFile": true+ },+ "files": {+ "includes": ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx", "**/*.json"]+ },+ "formatter": {+ "enabled": true,+ "indentStyle": "space",+ "indentWidth": 2,+ "lineWidth": 82,+ "lineEnding": "lf"+ },+ "javascript": {+ "formatter": {+ "quoteStyle": "single",+ "jsxQuoteStyle": "double",+ "semicolons": "asNeeded",+ "trailingCommas": "es5",+ "arrowParentheses": "always"+ }+ },+ "linter": {+ "enabled": true,+ "rules": {+ "recommended": true,+ "complexity": {+ "noExcessiveCognitiveComplexity": {+ "level": "error",+ "options": { "maxAllowedComplexity": 25 }+ },+ "noForEach": "off",+ "useLiteralKeys": "off"+ },+ "correctness": {+ "noUnusedVariables": "error",+ "noUnusedImports": "error",+ "useExhaustiveDependencies": "warn",+ "useHookAtTopLevel": "error",+ "noUndeclaredVariables": "error"+ },+ "style": {+ "useImportType": "error",+ "useConst": "error",+ "useTemplate": "error",+ "useSelfClosingElements": "error",+ "useFragmentSyntax": "error",+ "noNonNullAssertion": "error",+ "useConsistentArrayType": {+ "level": "error",+ "options": { "syntax": "shorthand" }+ },+ "useNamingConvention": "off"+ },+ "suspicious": {+ "noExplicitAny": "error",+ "noDebugger": "error",+ "noConsole": "warn",+ "noArrayIndexKey": "warn",+ "noAssignInExpressions": "error",+ "noDoubleEquals": "error",+ "noRedeclare": "error",+ "noVar": "error"+ },+ "security": {+ "noDangerouslySetInnerHtml": "error"+ },+ "a11y": {+ "useAltText": "error",+ "useAnchorContent": "error",+ "useKeyWithClickEvents": "error",+ "noStaticElementInteractions": "error",+ "useButtonType": "error",+ "useValidAnchor": "error"+ }+ }+ },+ "overrides": [+ {+ "includes": ["src/main.tsx"],+ "linter": {+ "rules": {+ "style": {+ "noNonNullAssertion": "off"+ }+ }+ }+ }+ ]+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/index.html b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/index.htmlnew file mode 100644index 00000000..a37f09fd--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/index.html@@ -0,0 +1,48 @@+<!doctype html>+<html lang="en">+ <head>+ <!--+ JA3/JA4 TLS Fingerprinting+ Author(s): Β© AngelaMos, CarterPerez-dev+-->+ <meta charset="UTF-8" />+ <link+ rel="icon"+ type="image/x-icon"+ href="/assets/favicon.ico"+ />+ <link+ rel="apple-touch-icon"+ type="image/png"+ href="/assets/apple-touch-icon.png"+ />+ <link+ rel="manifest"+ href="/assets/site.webmanifest"+ />+ <meta+ name="viewport"+ content="width=device-width, initial-scale=1.0"+ />+ <meta+ http-equiv="Content-Security-Policy"+ content="default-src 'self'; script-src 'self' 'unsafe-inline' 'unsafe-eval'; style-src 'self' 'unsafe-inline'; img-src 'self' data: blob:; font-src 'self'; connect-src 'self' github.com api.github.com; form-action 'self' github.com; worker-src 'self' blob:;"+ />+ <title>JA3/JA4 TLS Fingerprinting</title>+ <meta+ name="description"+ content="*Cracked*"+ />+ <meta+ name="author"+ content=" Β©AngelaMos | 2026 | CarterPerez-dev"+ />+ </head>+ <body>+ <div id="root"></div>+ <script+ type="module"+ src="/src/main.tsx"+ ></script>+ </body>+</html>diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/package.json b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/package.jsonnew file mode 100644index 00000000..482f5a8f--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/package.json@@ -0,0 +1,50 @@+{+ "name": "tlsfp",+ "private": true,+ "version": "1.0.0",+ "type": "module",+ "scripts": {+ "dev": "vite",+ "build": "tsc -b && vite build",+ "preview": "vite preview",+ "lint": "biome check .",+ "lint:fix": "biome check --write .",+ "format": "biome format --write .",+ "typecheck": "tsc -b",+ "lint:scss": "stylelint '**/*.scss'",+ "lint:scss:fix": "stylelint '**/*.scss' --fix"+ },+ "dependencies": {+ "@tanstack/react-query": "^5.90.12",+ "axios": "^1.13.0",+ "react": "^19.2.1",+ "react-dom": "^19.2.0",+ "react-error-boundary": "^6.0.0",+ "react-icon": "^1.0.0",+ "react-icons": "^5.5.0",+ "react-router-dom": "^7.1.1",+ "sonner": "^2.0.7",+ "zod": "^4.1.13",+ "zustand": "^5.0.9"+ },+ "devDependencies": {+ "@biomejs/biome": "^2.3.8",+ "@tanstack/react-query-devtools": "^5.91.1",+ "@types/node": "^24.10.2",+ "@types/react": "^19.2.7",+ "@types/react-dom": "^19.2.3",+ "@vitejs/plugin-react": "^5.1.1",+ "sass": "^1.95.0",+ "stylelint": "^16.26.1",+ "stylelint-config-prettier-scss": "^1.0.0",+ "stylelint-config-standard-scss": "^16.0.0",+ "typescript": "~5.9.3",+ "vite": "npm:[email protected]",+ "vite-tsconfig-paths": "^5.1.0"+ },+ "pnpm": {+ "overrides": {+ "vite": "npm:[email protected]"+ }+ }+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/pnpm-lock.yaml b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/pnpm-lock.yamlnew file mode 100644index 00000000..d04a7163--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/pnpm-lock.yaml@@ -0,0 +1,2603 @@+lockfileVersion: '9.0'++settings:+ autoInstallPeers: true+ excludeLinksFromLockfile: false++overrides:+ vite: npm:[email protected]++importers:++ .:+ dependencies:+ '@tanstack/react-query':+ specifier: ^5.90.12+ version: 5.90.12([email protected])+ axios:+ specifier: ^1.13.0+ version: 1.13.2+ react:+ specifier: ^19.2.1+ version: 19.2.1+ react-dom:+ specifier: ^19.2.0+ version: 19.2.1([email protected])+ react-error-boundary:+ specifier: ^6.0.0+ version: 6.0.0([email protected])+ react-icon:+ specifier: ^1.0.0+ version: 1.0.0([email protected])([email protected])+ react-icons:+ specifier: ^5.5.0+ version: 5.5.0([email protected])+ react-router-dom:+ specifier: ^7.1.1+ sonner:+ specifier: ^2.0.7+ zod:+ specifier: ^4.1.13+ version: 4.1.13+ zustand:+ specifier: ^5.0.9+ version: 5.0.9(@types/[email protected])([email protected])+ devDependencies:+ '@biomejs/biome':+ specifier: ^2.3.8+ version: 2.3.8+ '@tanstack/react-query-devtools':+ specifier: ^5.91.1+ '@types/node':+ specifier: ^24.10.2+ version: 24.10.2+ '@types/react':+ specifier: ^19.2.7+ version: 19.2.7+ '@types/react-dom':+ specifier: ^19.2.3+ version: 19.2.3(@types/[email protected])+ '@vitejs/plugin-react':+ specifier: ^5.1.1+ sass:+ specifier: ^1.95.0+ version: 1.95.0+ stylelint:+ specifier: ^16.26.1+ version: 16.26.1([email protected])+ stylelint-config-prettier-scss:+ specifier: ^1.0.0+ version: 1.0.0([email protected]([email protected]))+ stylelint-config-standard-scss:+ specifier: ^16.0.0+ typescript:+ specifier: ~5.9.3+ version: 5.9.3+ vite:+ specifier: npm:[email protected]+ vite-tsconfig-paths:+ specifier: ^5.1.0++packages:++ '@babel/[email protected]':+ resolution: {integrity: sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==}+ engines: {node: '>=6.9.0'}++ '@babel/[email protected]':+ resolution: {integrity: sha512-6uFXyCayocRbqhZOB+6XcuZbkMNimwfVGFji8CTZnCzOHVGvDqzvitu1re2AU5LROliz7eQPhB8CpAMvnx9EjA==}+ engines: {node: '>=6.9.0'}++ '@babel/[email protected]':+ resolution: {integrity: sha512-e7jT4DxYvIDLk1ZHmU/m/mB19rex9sv0c2ftBtjSBv+kVM/902eh0fINUzD7UwLLNR+jU585GxUJ8/EBfAM5fw==}+ engines: {node: '>=6.9.0'}++ '@babel/[email protected]':+ resolution: {integrity: sha512-3EwLFhZ38J4VyIP6WNtt2kUdW9dokXA9Cr4IVIFHuCpZ3H8/YFOl5JjZHisrn1fATPBmKKqXzDFvh9fUwHz6CQ==}+ engines: {node: '>=6.9.0'}++ '@babel/[email protected]':+ resolution: {integrity: sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ==}+ engines: {node: '>=6.9.0'}++ '@babel/[email protected]':+ resolution: {integrity: sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==}+ engines: {node: '>=6.9.0'}++ '@babel/[email protected]':+ resolution: {integrity: sha512-0gSFWUPNXNopqtIPQvlD5WgXYI5GY2kP2cCvoT8kczjbfcfuIljTbcWrulD1CIPIX2gt1wghbDy08yE1p+/r3w==}+ engines: {node: '>=6.9.0'}++ '@babel/[email protected]':+ resolution: {integrity: sha512-gytXUbs8k2sXS9PnQptz5o0QnpLL51SwASIORY6XaBKF88nsOT0Zw9szLqlSGQDP/4TljBAD5y98p2U1fqkdsw==}+ engines: {node: '>=6.9.0'}+ peerDependencies:+ '@babel/core': ^7.0.0++ '@babel/[email protected]':+ resolution: {integrity: sha512-1gn1Up5YXka3YYAHGKpbideQ5Yjf1tDa9qYcgysz+cNCXukyLl6DjPXhD3VRwSb8c0J9tA4b2+rHEZtc6R0tlw==}+ engines: {node: '>=6.9.0'}++ '@babel/[email protected]':+ resolution: {integrity: sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==}+ engines: {node: '>=6.9.0'}++ '@babel/[email protected]':+ resolution: {integrity: sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==}+ engines: {node: '>=6.9.0'}++ '@babel/[email protected]':+ resolution: {integrity: sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==}+ engines: {node: '>=6.9.0'}++ '@babel/[email protected]':+ resolution: {integrity: sha512-HFN59MmQXGHVyYadKLVumYsA9dBFun/ldYxipEjzA4196jpLZd8UjEEBLkbEkvfYreDqJhZxYAWFPtrfhNpj4w==}+ engines: {node: '>=6.9.0'}++ '@babel/[email protected]':+ resolution: {integrity: sha512-KKBU1VGYR7ORr3At5HAtUQ+TV3SzRCXmA/8OdDZiLDBIZxVyzXuztPjfLd3BV1PRAQGCMWWSHYhL0F8d5uHBDQ==}+ engines: {node: '>=6.0.0'}+ hasBin: true++ '@babel/[email protected]':+ resolution: {integrity: sha512-6UzkCs+ejGdZ5mFFC/OCUrv028ab2fp1znZmCZjAOBKiBK2jXD1O+BPSfX8X2qjJ75fZBMSnQn3Rq2mrBJK2mw==}+ engines: {node: '>=6.9.0'}+ peerDependencies:+ '@babel/core': ^7.0.0-0++ '@babel/[email protected]':+ resolution: {integrity: sha512-zbwoTsBruTeKB9hSq73ha66iFeJHuaFkUbwvqElnygoNbj/jHRsSeokowZFN3CZ64IvEqcmmkVe89OPXc7ldAw==}+ engines: {node: '>=6.9.0'}+ peerDependencies:+ '@babel/core': ^7.0.0-0++ '@babel/[email protected]':+ resolution: {integrity: sha512-Q/N6JNWvIvPnLDvjlE1OUBLPQHH6l3CltCEsHIujp45zQUSSh8K+gHnaEX45yAT1nyngnINhvWtzN+Nb9D8RAQ==}+ engines: {node: '>=6.9.0'}++ '@babel/[email protected]':+ resolution: {integrity: sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw==}+ engines: {node: '>=6.9.0'}++ '@babel/[email protected]':+ resolution: {integrity: sha512-TCCj4t55U90khlYkVV/0TfkJkAkUg3jZFA3Neb7unZT8CPok7iiRfaX0F+WnqWqt7OxhOn0uBKXCw4lbL8W0aQ==}+ engines: {node: '>=6.9.0'}++ '@babel/[email protected]':+ resolution: {integrity: sha512-qQ5m48eI/MFLQ5PxQj4PFaprjyCTLI37ElWMmNs0K8Lk3dVeOdNpB3ks8jc7yM5CDmVC73eMVk/trk3fgmrUpA==}+ engines: {node: '>=6.9.0'}++ '@biomejs/[email protected]':+ resolution: {integrity: sha512-Qjsgoe6FEBxWAUzwFGFrB+1+M8y/y5kwmg5CHac+GSVOdmOIqsAiXM5QMVGZJ1eCUCLlPZtq4aFAQ0eawEUuUA==}+ engines: {node: '>=14.21.3'}+ hasBin: true++ '@biomejs/[email protected]':+ resolution: {integrity: sha512-HM4Zg9CGQ3txTPflxD19n8MFPrmUAjaC7PQdLkugeeC0cQ+PiVrd7i09gaBS/11QKsTDBJhVg85CEIK9f50Qww==}+ engines: {node: '>=14.21.3'}+ cpu: [arm64]+ os: [darwin]++ '@biomejs/[email protected]':+ resolution: {integrity: sha512-lUDQ03D7y/qEao7RgdjWVGCu+BLYadhKTm40HkpJIi6kn8LSv5PAwRlew/DmwP4YZ9ke9XXoTIQDO1vAnbRZlA==}+ engines: {node: '>=14.21.3'}+ cpu: [x64]+ os: [darwin]++ '@biomejs/[email protected]':+ resolution: {integrity: sha512-PShR4mM0sjksUMyxbyPNMxoKFPVF48fU8Qe8Sfx6w6F42verbwRLbz+QiKNiDPRJwUoMG1nPM50OBL3aOnTevA==}+ engines: {node: '>=14.21.3'}+ cpu: [arm64]+ os: [linux]++ '@biomejs/[email protected]':+ resolution: {integrity: sha512-Uo1OJnIkJgSgF+USx970fsM/drtPcQ39I+JO+Fjsaa9ZdCN1oysQmy6oAGbyESlouz+rzEckLTF6DS7cWse95g==}+ engines: {node: '>=14.21.3'}+ cpu: [arm64]+ os: [linux]++ '@biomejs/[email protected]':+ resolution: {integrity: sha512-YGLkqU91r1276uwSjiUD/xaVikdxgV1QpsicT0bIA1TaieM6E5ibMZeSyjQ/izBn4tKQthUSsVZacmoJfa3pDA==}+ engines: {node: '>=14.21.3'}+ cpu: [x64]+ os: [linux]++ '@biomejs/[email protected]':+ resolution: {integrity: sha512-QDPMD5bQz6qOVb3kiBui0zKZXASLo0NIQ9JVJio5RveBEFgDgsvJFUvZIbMbUZT3T00M/1wdzwWXk4GIh0KaAw==}+ engines: {node: '>=14.21.3'}+ cpu: [x64]+ os: [linux]++ '@biomejs/[email protected]':+ resolution: {integrity: sha512-H4IoCHvL1fXKDrTALeTKMiE7GGWFAraDwBYFquE/L/5r1927Te0mYIGseXi4F+lrrwhSWbSGt5qPFswNoBaCxg==}+ engines: {node: '>=14.21.3'}+ cpu: [arm64]+ os: [win32]++ '@biomejs/[email protected]':+ resolution: {integrity: sha512-RguzimPoZWtBapfKhKjcWXBVI91tiSprqdBYu7tWhgN8pKRZhw24rFeNZTNf6UiBfjCYCi9eFQs/JzJZIhuK4w==}+ engines: {node: '>=14.21.3'}+ cpu: [x64]+ os: [win32]++ '@cacheable/[email protected]':+ resolution: {integrity: sha512-7e8SScMocHxcAb8YhtkbMhGG+EKLRIficb1F5sjvhSYsWTZGxvg4KIDp8kgxnV2PUJ3ddPe6J9QESjKvBWRDkg==}++ '@cacheable/[email protected]':+ resolution: {integrity: sha512-8kGE2P+HjfY8FglaOiW+y8qxcaQAfAhVML+i66XJR3YX5FtyDqn6Txctr3K2FrbxLKixRRYYBWMbuGciOhYNDg==}++ '@csstools/[email protected]':+ resolution: {integrity: sha512-DaDeUkXZKjdGhgYaHNJTV9pV7Y9B3b644jCLs9Upc3VeNGg6LWARAT6O+Q+/COo+2gg/bM5rhpMAtf70WqfBdQ==}+ engines: {node: '>=18'}+ peerDependencies:+ '@csstools/css-tokenizer': ^3.0.4++ '@csstools/[email protected]':+ resolution: {integrity: sha512-8BHsjXfSciZxjmHQOuVdW2b8WLUPts9a+mfL13/PzEviufUEW2xnvQuOlKs9dRBHgRqJ53SF/DUoK9+MZk72oQ==}+ engines: {node: '>=18'}++ '@csstools/[email protected]':+ resolution: {integrity: sha512-Vd/9EVDiu6PPJt9yAh6roZP6El1xHrdvIVGjyBsHR0RYwNHgL7FJPyIIW4fANJNG6FtyZfvlRPpFI4ZM/lubvw==}+ engines: {node: '>=18'}++ '@csstools/[email protected]':+ resolution: {integrity: sha512-HAYH7d3TLRHDOUQK4mZKf9k9Ph/m8Akstg66ywKR4SFAigjs3yBiUeZtFxywiTm5moZMAp/5W/ZuFnNXXYLuuQ==}+ engines: {node: '>=18'}+ peerDependencies:+ '@csstools/css-parser-algorithms': ^3.0.5+ '@csstools/css-tokenizer': ^3.0.4++ '@csstools/[email protected]':+ resolution: {integrity: sha512-PCqQV3c4CoVm3kdPhyeZ07VmBRdH2EpMFA/pd9OASpOEC3aXNGoqPDAZ80D0cLpMBxnmk0+yNhGsEx31hq7Gtw==}+ engines: {node: '>=18'}+ peerDependencies:+ postcss-selector-parser: ^7.0.0++ '@dual-bundle/[email protected]':+ resolution: {integrity: sha512-id+7YRUgoUX6CgV0DtuhirQWodeeA7Lf4i2x71JS/vtA5pRb/hIGWlw+G6MeXvsM+MXrz0VAydTGElX1rAfgPg==}++ '@emnapi/[email protected]':+ resolution: {integrity: sha512-o1uhUASyo921r2XtHYOHy7gdkGLge8ghBEQHMWmyJFoXlpU58kIrhhN3w26lpQb6dspetweapMn2CSNwQ8I4wg==}++ '@emnapi/[email protected]':+ resolution: {integrity: sha512-PVtJr5CmLwYAU9PZDMITZoR5iAOShYREoR45EyyLrbntV50mdePTgUn4AmOw90Ifcj+x2kRjdzr1HP3RrNiHGA==}++ '@emnapi/[email protected]':+ resolution: {integrity: sha512-WI0DdZ8xFSbgMjR1sFsKABJ/C5OnRrjT06JXbZKexJGrDuPTzZdDYfFlsgcCXCyf+suG5QU2e/y1Wo2V/OapLQ==}++ '@jridgewell/[email protected]':+ resolution: {integrity: sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==}++ '@jridgewell/[email protected]':+ resolution: {integrity: sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==}++ '@jridgewell/[email protected]':+ resolution: {integrity: sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==}+ engines: {node: '>=6.0.0'}++ '@jridgewell/[email protected]':+ resolution: {integrity: sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==}++ '@jridgewell/[email protected]':+ resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==}++ '@keyv/[email protected]':+ resolution: {integrity: sha512-KT01GjzV6AQD5+IYrcpoYLkCu1Jod3nau1Z7EsEuViO3TZGRacSbO9MfHmbJ1WaOXFtWLxPVj169cn2WNKPkIg==}+ engines: {node: '>= 18'}+ peerDependencies:+ keyv: ^5.5.4++ '@keyv/[email protected]':+ resolution: {integrity: sha512-dXn3FZhPv0US+7dtJsIi2R+c7qWYiReoEh5zUntWCf4oSpMNib8FDhSoed6m3QyZdx5hK7iLFkYk3rNxwt8vTA==}++ '@napi-rs/[email protected]':+ resolution: {integrity: sha512-Fq6DJW+Bb5jaWE69/qOE0D1TUN9+6uWhCeZpdnSBk14pjLcCWR7Q8n49PTSPHazM37JqrsdpEthXy2xn6jWWiA==}++ '@nodelib/[email protected]':+ resolution: {integrity: sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==}+ engines: {node: '>= 8'}++ '@nodelib/[email protected]':+ resolution: {integrity: sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==}+ engines: {node: '>= 8'}++ '@nodelib/[email protected]':+ resolution: {integrity: sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==}+ engines: {node: '>= 8'}++ '@oxc-project/[email protected]':+ resolution: {integrity: sha512-yH0zw7z+jEws4dZ4IUKoix5Lh3yhqIJWF9Dc8PWvhpo7U7O+lJrv7ZZL4BeRO0la8LBQFwcCewtLBnVV7hPe/w==}+ engines: {node: ^20.19.0 || >=22.12.0}++ '@oxc-project/[email protected]':+ resolution: {integrity: sha512-lxmZK4xFrdvU0yZiDwgVQTCvh2gHWBJCBk5ALsrtsBWhs0uDIi+FTOnXRQeQfs304imdvTdaakT/lqwQ8hkOXQ==}++ '@parcel/[email protected]':+ resolution: {integrity: sha512-KF8+j9nNbUN8vzOFDpRMsaKBHZ/mcjEjMToVMJOhTozkDonQFFrRcfdLWn6yWKCmJKmdVxSgHiYvTCef4/qcBA==}+ engines: {node: '>= 10.0.0'}+ cpu: [arm64]+ os: [android]++ '@parcel/[email protected]':+ resolution: {integrity: sha512-eAzPv5osDmZyBhou8PoF4i6RQXAfeKL9tjb3QzYuccXFMQU0ruIc/POh30ePnaOyD1UXdlKguHBmsTs53tVoPw==}+ engines: {node: '>= 10.0.0'}+ cpu: [arm64]+ os: [darwin]++ '@parcel/[email protected]':+ resolution: {integrity: sha512-1ZXDthrnNmwv10A0/3AJNZ9JGlzrF82i3gNQcWOzd7nJ8aj+ILyW1MTxVk35Db0u91oD5Nlk9MBiujMlwmeXZg==}+ engines: {node: '>= 10.0.0'}+ cpu: [x64]+ os: [darwin]++ '@parcel/[email protected]':+ resolution: {integrity: sha512-SI4eljM7Flp9yPuKi8W0ird8TI/JK6CSxju3NojVI6BjHsTyK7zxA9urjVjEKJ5MBYC+bLmMcbAWlZ+rFkLpJQ==}+ engines: {node: '>= 10.0.0'}+ cpu: [x64]+ os: [freebsd]++ '@parcel/[email protected]':+ resolution: {integrity: sha512-RCdZlEyTs8geyBkkcnPWvtXLY44BCeZKmGYRtSgtwwnHR4dxfHRG3gR99XdMEdQ7KeiDdasJwwvNSF5jKtDwdA==}+ engines: {node: '>= 10.0.0'}+ cpu: [arm]+ os: [linux]++ '@parcel/[email protected]':+ resolution: {integrity: sha512-6E+m/Mm1t1yhB8X412stiKFG3XykmgdIOqhjWj+VL8oHkKABfu/gjFj8DvLrYVHSBNC+/u5PeNrujiSQ1zwd1Q==}+ engines: {node: '>= 10.0.0'}+ cpu: [arm]+ os: [linux]++ '@parcel/[email protected]':+ resolution: {integrity: sha512-LrGp+f02yU3BN9A+DGuY3v3bmnFUggAITBGriZHUREfNEzZh/GO06FF5u2kx8x+GBEUYfyTGamol4j3m9ANe8w==}+ engines: {node: '>= 10.0.0'}+ cpu: [arm64]+ os: [linux]++ '@parcel/[email protected]':+ resolution: {integrity: sha512-cFOjABi92pMYRXS7AcQv9/M1YuKRw8SZniCDw0ssQb/noPkRzA+HBDkwmyOJYp5wXcsTrhxO0zq1U11cK9jsFg==}+ engines: {node: '>= 10.0.0'}+ cpu: [arm64]+ os: [linux]++ '@parcel/[email protected]':+ resolution: {integrity: sha512-GcESn8NZySmfwlTsIur+49yDqSny2IhPeZfXunQi48DMugKeZ7uy1FX83pO0X22sHntJ4Ub+9k34XQCX+oHt2A==}+ engines: {node: '>= 10.0.0'}+ cpu: [x64]+ os: [linux]++ '@parcel/[email protected]':+ resolution: {integrity: sha512-n0E2EQbatQ3bXhcH2D1XIAANAcTZkQICBPVaxMeaCVBtOpBZpWJuf7LwyWPSBDITb7In8mqQgJ7gH8CILCURXg==}+ engines: {node: '>= 10.0.0'}+ cpu: [x64]+ os: [linux]++ '@parcel/[email protected]':+ resolution: {integrity: sha512-RFzklRvmc3PkjKjry3hLF9wD7ppR4AKcWNzH7kXR7GUe0Igb3Nz8fyPwtZCSquGrhU5HhUNDr/mKBqj7tqA2Vw==}+ engines: {node: '>= 10.0.0'}+ cpu: [arm64]+ os: [win32]++ '@parcel/[email protected]':+ resolution: {integrity: sha512-c2KkcVN+NJmuA7CGlaGD1qJh1cLfDnQsHjE89E60vUEMlqduHGCdCLJCID5geFVM0dOtA3ZiIO8BoEQmzQVfpQ==}+ engines: {node: '>= 10.0.0'}+ cpu: [ia32]+ os: [win32]++ '@parcel/[email protected]':+ resolution: {integrity: sha512-9lHBdJITeNR++EvSQVUcaZoWupyHfXe1jZvGZ06O/5MflPcuPLtEphScIBL+AiCWBO46tDSHzWyD0uDmmZqsgA==}+ engines: {node: '>= 10.0.0'}+ cpu: [x64]+ os: [win32]++ '@parcel/[email protected]':+ resolution: {integrity: sha512-dfUnCxiN9H4ap84DvD2ubjw+3vUNpstxa0TneY/Paat8a3R4uQZDLSvWjmznAY/DoahqTHl9V46HF/Zs3F29pg==}+ engines: {node: '>= 10.0.0'}++ '@rolldown/[email protected]':+ resolution: {integrity: sha512-XlEkrOIHLyGT3avOgzfTFSjG+f+dZMw+/qd+Y3HLN86wlndrB/gSimrJCk4gOhr1XtRtEKfszpadI3Md4Z4/Ag==}+ engines: {node: ^20.19.0 || >=22.12.0}+ cpu: [arm64]+ os: [android]++ '@rolldown/[email protected]':+ resolution: {integrity: sha512-+JRqKJhoFlt5r9q+DecAGPLZ5PxeLva+wCMtAuoFMWPoZzgcYrr599KQ+Ix0jwll4B4HGP43avu9My8KtSOR+w==}+ engines: {node: ^20.19.0 || >=22.12.0}+ cpu: [arm64]+ os: [darwin]++ '@rolldown/[email protected]':+ resolution: {integrity: sha512-fFXDjXnuX7/gQZQm/1FoivVtRcyAzdjSik7Eo+9iwPQ9EgtA5/nB2+jmbzaKtMGG3q+BnZbdKHCtOacmNrkIDA==}+ engines: {node: ^20.19.0 || >=22.12.0}+ cpu: [x64]+ os: [darwin]++ '@rolldown/[email protected]':+ resolution: {integrity: sha512-F1b6vARy49tjmT/hbloplzgJS7GIvwWZqt+tAHEstCh0JIh9sa8FAMVqEmYxDviqKBaAI8iVvUREm/Kh/PD26Q==}+ engines: {node: ^20.19.0 || >=22.12.0}+ cpu: [x64]+ os: [freebsd]++ '@rolldown/[email protected]':+ resolution: {integrity: sha512-U6cR76N8T8M6lHj7EZrQ3xunLPxSvYYxA8vJsBKZiFZkT8YV4kjgCO3KwMJL0NOjQCPGKyiXO07U+KmJzdPGRw==}+ engines: {node: ^20.19.0 || >=22.12.0}+ cpu: [arm]+ os: [linux]++ '@rolldown/[email protected]':+ resolution: {integrity: sha512-ONgyjofCrrE3bnh5GZb8EINSFyR/hmwTzZ7oVuyUB170lboza1VMCnb8jgE6MsyyRgHYmN8Lb59i3NKGrxrYjw==}+ engines: {node: ^20.19.0 || >=22.12.0}+ cpu: [arm64]+ os: [linux]++ '@rolldown/[email protected]':+ resolution: {integrity: sha512-L0zRdH2oDPkmB+wvuTl+dJbXCsx62SkqcEqdM+79LOcB+PxbAxxjzHU14BuZIQdXcAVDzfpMfaHWzZuwhhBTcw==}+ engines: {node: ^20.19.0 || >=22.12.0}+ cpu: [arm64]+ os: [linux]++ '@rolldown/[email protected]':+ resolution: {integrity: sha512-gyoI8o/TGpQd3OzkJnh1M2kxy1Bisg8qJ5Gci0sXm9yLFzEXIFdtc4EAzepxGvrT2ri99ar5rdsmNG0zP0SbIg==}+ engines: {node: ^20.19.0 || >=22.12.0}+ cpu: [x64]+ os: [linux]++ '@rolldown/[email protected]':+ resolution: {integrity: sha512-zti8A7M+xFDpKlghpcCAzyOi+e5nfUl3QhU023ce5NCgUxRG5zGP2GR9LTydQ1rnIPwZUVBWd4o7NjZDaQxaXA==}+ engines: {node: ^20.19.0 || >=22.12.0}+ cpu: [x64]+ os: [linux]++ '@rolldown/[email protected]':+ resolution: {integrity: sha512-eZUssog7qljrrRU9Mi0eqYEPm3Ch0UwB+qlWPMKSUXHNqhm3TvDZarJQdTevGEfu3EHAXJvBIe0YFYr0TPVaMA==}+ engines: {node: ^20.19.0 || >=22.12.0}+ cpu: [arm64]+ os: [openharmony]++ '@rolldown/[email protected]':+ resolution: {integrity: sha512-nmCN0nIdeUnmgeDXiQ+2HU6FT162o+rxnF7WMkBm4M5Ds8qTU7Dzv2Wrf22bo4ftnlrb2hKK6FSwAJSAe2FWLg==}+ engines: {node: '>=14.0.0'}+ cpu: [wasm32]++ '@rolldown/[email protected]':+ resolution: {integrity: sha512-7kcNLi7Ua59JTTLvbe1dYb028QEPaJPJQHqkmSZ5q3tJueUeb6yjRtx8mw4uIqgWZcnQHAR3PrLN4XRJxvgIkA==}+ engines: {node: ^20.19.0 || >=22.12.0}+ cpu: [arm64]+ os: [win32]++ '@rolldown/[email protected]':+ resolution: {integrity: sha512-lL70VTNvSCdSZkDPPVMwWn/M2yQiYvSoXw9hTLgdIWdUfC3g72UaruezusR6ceRuwHCY1Ayu2LtKqXkBO5LIwg==}+ engines: {node: ^20.19.0 || >=22.12.0}+ cpu: [ia32]+ os: [win32]++ '@rolldown/[email protected]':+ resolution: {integrity: sha512-4qU4x5DXWB4JPjyTne/wBNPqkbQU8J45bl21geERBKtEittleonioACBL1R0PsBu0Aq21SwMK5a9zdBkWSlQtQ==}+ engines: {node: ^20.19.0 || >=22.12.0}+ cpu: [x64]+ os: [win32]++ '@rolldown/[email protected]':+ resolution: {integrity: sha512-5e76wQiQVeL1ICOZVUg4LSOVYg9jyhGCin+icYozhsUzM+fHE7kddi1bdiE0jwVqTfkjba3jUFbEkoC9WkdvyA==}++ '@rolldown/[email protected]':+ resolution: {integrity: sha512-vENRlFU4YbrwVqNDZ7fLvy+JR1CRkyr01jhSiDpE1u6py3OMzQfztQU2jxykW3ALNxO4kSlqIDeYyD0Y9RcQeQ==}++ '@tanstack/[email protected]':+ resolution: {integrity: sha512-T1/8t5DhV/SisWjDnaiU2drl6ySvsHj1bHBCWNXd+/T+Hh1cf6JodyEYMd5sgwm+b/mETT4EV3H+zCVczCU5hg==}++ '@tanstack/[email protected]':+ resolution: {integrity: sha512-l8bxjk6BMsCaVQH6NzQEE/bEgFy1hAs5qbgXl0xhzezlaQbPk6Mgz9BqEg2vTLPOHD8N4k+w/gdgCbEzecGyNg==}++ '@tanstack/[email protected]':+ resolution: {integrity: sha512-tRnJYwEbH0kAOuToy8Ew7bJw1lX3AjkkgSlf/vzb+NpnqmHPdWM+lA2DSdGQSLi1SU0PDRrrCI1vnZnci96CsQ==}+ peerDependencies:+ '@tanstack/react-query': ^5.90.10+ react: ^18 || ^19++ '@tanstack/[email protected]':+ resolution: {integrity: sha512-graRZspg7EoEaw0a8faiUASCyJrqjKPdqJ9EwuDRUF9mEYJ1YPczI9H+/agJ0mOJkPCJDk0lsz5QTrLZ/jQ2rg==}+ peerDependencies:+ react: ^18 || ^19++ '@tybys/[email protected]':+ resolution: {integrity: sha512-9tTaPJLSiejZKx+Bmog4uSubteqTvFrVrURwkmHixBo0G4seD0zUxp98E1DzUBJxLQ3NPwXrGKDiVjwx/DpPsg==}++ '@types/[email protected]':+ resolution: {integrity: sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==}++ '@types/[email protected]':+ resolution: {integrity: sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==}++ '@types/[email protected]':+ resolution: {integrity: sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==}++ '@types/[email protected]':+ resolution: {integrity: sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==}++ '@types/[email protected]':+ resolution: {integrity: sha512-WOhQTZ4G8xZ1tjJTvKOpyEVSGgOTvJAfDK3FNFgELyaTpzhdgHVHeqW8V+UJvzF5BT+/B54T/1S2K6gd9c7bbA==}++ '@types/[email protected]':+ resolution: {integrity: sha512-jp2L/eY6fn+KgVVQAOqYItbF0VY/YApe5Mz2F0aykSO8gx31bYCZyvSeYxCHKvzHG5eZjc+zyaS5BrBWya2+kQ==}+ peerDependencies:+ '@types/react': ^19.2.0++ '@types/[email protected]':+ resolution: {integrity: sha512-MWtvHrGZLFttgeEj28VXHxpmwYbor/ATPYbBfSFZEIRK0ecCFLl2Qo55z52Hss+UV9CRN7trSeq1zbgx7YDWWg==}++ '@vitejs/[email protected]':+ resolution: {integrity: sha512-EcA07pHJouywpzsoTUqNh5NwGayl2PPVEJKUSinGGSxFGYn+shYbqMGBg6FXDqgXum9Ou/ecb+411ssw8HImJQ==}+ engines: {node: ^20.19.0 || >=22.12.0}+ peerDependencies:+ vite: ^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0++ resolution: {integrity: sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==}++ resolution: {integrity: sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==}++ resolution: {integrity: sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-Z7tMw1ytTXt5jqMcOP+OQteU1VuNK9Y02uuJtKQ1Sv69jXQKKg5cibLwGJow8yzZP+eAc18EmLGPal0bp36rvQ==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==}++ resolution: {integrity: sha512-VPk9ebNqPcy5lRGuSlKx752IlDatOjT9paPlm8A7yOuW2Fbvp4X3JznJtT4f0GzGLLiWE9W8onz51SqLYwzGaA==}++ resolution: {integrity: sha512-KpgoA8VE/pMmNCrnEeeXqFG24TIH11Z3ZaimIhJWsin8EbfZy3WzFKUTIan10ZIDgRVvi9EkLbruJElJC9dRlg==}++ resolution: {integrity: sha512-1ugUSr8BHXRnK23KfuYS+gVMC3LB8QGH9W1iGtDPsNWoQbgtXSExkBu2aDR4epiGWZOjZsj6lDl/N/AqqTC3UA==}++ resolution: {integrity: sha512-D5vIoztZOq1XM54LUdttJVc96ggEsIfju2JBvht06pSzpckp3C7HReun67Bghzrtdsq9XdMGbSSB3v3GhMNmAA==}+ hasBin: true++ resolution: {integrity: sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-ZC5Bd0LgJXgwGqUknZY/vkUQ04r8NXnJZ3yYi4vDmSiZmC/pdSN0NbNRPxZpbtO4uAfDUAFffO8IZoM3Gj8IkA==}+ engines: {node: ^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7}+ hasBin: true++ resolution: {integrity: sha512-HHiAvOBmlcR2f3SQ7kdlYD8+AUJG+wlFZ/Ze8tl1Vzvz0MdOh8IYA/EFU4ve8t1/sZ0j4MGi7ST5MoTwHessQA==}++ resolution: {integrity: sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==}+ engines: {node: '>= 0.4'}++ resolution: {integrity: sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==}+ engines: {node: '>=6'}++ resolution: {integrity: sha512-Pzfx9fOKoKvevQf8oCXoyNRQ5QyxJj+3O0Rqx2V5oxT61KGx8+n6hV/IUyJeifUci2clnmmKVpvtiqRzgiWjSw==}++ resolution: {integrity: sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA==}+ engines: {node: '>= 14.16.0'}++ resolution: {integrity: sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==}+ engines: {node: '>=7.0.0'}++ resolution: {integrity: sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==}++ resolution: {integrity: sha512-jeC1axXpnb0/2nn/Y1LPuLdgXBLH7aDcHu4KEKfqw3CUhX7ZpfBSlPKyqXE6btIgEzfWtrX3/tyBCaCvXvMkOw==}++ resolution: {integrity: sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==}+ engines: {node: '>= 0.8'}++ resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==}++ resolution: {integrity: sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ==}+ engines: {node: '>=18'}++ resolution: {integrity: sha512-ZiPp9pZlgxpWRu0M+YWbm6+aQ84XEfH1JRXvfOc/fILWI0VKhLC2LX13X1NYq4fULzLMq7Hfh43CSo2/aIaUPA==}+ deprecated: core-js@<3.23.3 is no longer maintained and not recommended for usage due to the number of issues. Because of the V8 engine whims, feature detection in old core-js versions could cause a slowdown up to 100x even if nothing is polyfilled. Some versions have web compatibility issues. Please, upgrade your dependencies to the actual version of core-js.++ resolution: {integrity: sha512-itvL5h8RETACmOTFc4UfIyB2RfEHi71Ax6E/PivVxq9NseKbOWpeyHEOIbmAw1rs8Ak0VursQNww7lf7YtUwzg==}+ engines: {node: '>=14'}+ peerDependencies:+ typescript: '>=4.9.5'+ peerDependenciesMeta:+ typescript:+ optional: true++ resolution: {integrity: sha512-IQOkD3hbR5KrN93MtcYuad6YPuTSUhntLHDuLEbFWE+ff2/XSZNdZG+LcbbIW5AXKg/WFIfYItIzVoHngHXZzA==}+ engines: {node: '>=12 || >=16'}++ resolution: {integrity: sha512-0eW44TGN5SQXU1mWSkKwFstI/22X2bG1nYzZTYMAWjylYURhse752YgbE4Cx46AC+bAvI+/dYTPRk1LqSUnu6w==}+ engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0}++ resolution: {integrity: sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==}+ engines: {node: '>=4'}+ hasBin: true++ resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==}++ resolution: {integrity: sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==}+ engines: {node: '>=6.0'}+ peerDependencies:+ supports-color: '*'+ peerDependenciesMeta:+ supports-color:+ optional: true++ resolution: {integrity: sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==}+ engines: {node: '>=0.4.0'}++ resolution: {integrity: sha512-pGjwhsmsp4kL2RTz08wcOlGN83otlqHeD/Z5T8GXZB+/YcpQ/dgo+lbU8ZsGxV0HIvqqxo9l7mqYwyYMD9bKDg==}+ engines: {node: '>=0.10'}+ hasBin: true++ resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==}+ engines: {node: '>= 0.4'}++ resolution: {integrity: sha512-0Drusm6MVRXSOJpGbaSVgcQsuB4hEkMpHXaVstcPmhu5LIedxs1xNK/nIxmQIU/RPC0+1/o0AVZfBTkTNJOdUw==}++ resolution: {integrity: sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==}++ resolution: {integrity: sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==}+ engines: {node: '>=6'}++ resolution: {integrity: sha512-sqQamAnR14VgCr1A618A3sGrygcpK+HEbenA/HiEAkkUwcZIIB/tgWqHFxWgOyDh4nB4JCRimh79dR5Ywc9MDQ==}++ resolution: {integrity: sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==}+ engines: {node: '>= 0.4'}++ resolution: {integrity: sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==}+ engines: {node: '>= 0.4'}++ resolution: {integrity: sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==}+ engines: {node: '>= 0.4'}++ resolution: {integrity: sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==}+ engines: {node: '>= 0.4'}++ resolution: {integrity: sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==}+ engines: {node: '>=6'}++ resolution: {integrity: sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==}++ resolution: {integrity: sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==}+ engines: {node: '>=8.6.0'}++ resolution: {integrity: sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==}++ resolution: {integrity: sha512-eRnCtTTtGZFpQCwhJiUOuxPQWRXVKYDn0b2PeHfXL6/Zi53SLAzAHfVhVWK2AryC/WH05kGfxhFIPvTF0SXQzg==}+ engines: {node: '>= 4.9.1'}++ resolution: {integrity: sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==}++ resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==}+ engines: {node: '>=12.0.0'}+ peerDependencies:+ picomatch: ^3 || ^4+ peerDependenciesMeta:+ picomatch:+ optional: true++ resolution: {integrity: sha512-TPVFSDE7q91Dlk1xpFLvFllf8r0HyOMOlnWy7Z2HBku5H3KhIeOGInexrIeg2D64DosVB/JXkrrk6N/7Wriq4A==}++ resolution: {integrity: sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-l/K33newPTZMTGAnnzaiqSl6NnH7Namh8jBNjrgjprWxGmZUuxx/sJNIRaijOh3n7q7ESbhNZC+pvVZMFdeU4A==}++ resolution: {integrity: sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==}++ resolution: {integrity: sha512-deG2P0JfjrTxl50XGCDyfI97ZGVCxIpfKYmfyrQ54n5FO/0gfIES8C/Psl6kWVDolizcaaxZJnTS0QSMxvnsBQ==}+ engines: {node: '>=4.0'}+ peerDependencies:+ debug: '*'+ peerDependenciesMeta:+ debug:+ optional: true++ resolution: {integrity: sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==}+ engines: {node: '>= 6'}++ resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}+ engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}+ os: [darwin]++ resolution: {integrity: sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==}++ resolution: {integrity: sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==}+ engines: {node: '>=6.9.0'}++ resolution: {integrity: sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==}+ engines: {node: '>= 0.4'}++ resolution: {integrity: sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==}+ engines: {node: '>= 0.4'}++ resolution: {integrity: sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==}+ engines: {node: '>= 6'}++ resolution: {integrity: sha512-NGbfmJBp9x8IxyJSd1P+otYK8vonoJactOogrVfFRIAEY1ukil8RSKDz2Yo7wh1oihl51l/r6W4epkeKJHqL8A==}+ engines: {node: '>=6'}++ resolution: {integrity: sha512-awConJSVCHVGND6x3tmMaKcQvwXLhjdkmomy2W+Goaui8YPgYgXJZewhg3fWC+DlfqqQuWg8AwqjGTD2nAPVWg==}+ engines: {node: '>=6'}++ resolution: {integrity: sha512-jhIXaOzy1sb8IyocaruWSn1TjmnBVs8Ayhcy83rmxNJ8q2uWKCAj3CnJY+KpGSXCueAPc0i05kVvVKtP1t9S3g==}+ engines: {node: '>=10'}++ resolution: {integrity: sha512-xYfnw62CKG8nLkZBfWbhWwDw02CHty86jfPcc2cr3ZfeuK9ysoVPPEUxf21bAD/rWAgk52SuBrLJlefNy8mvFg==}++ resolution: {integrity: sha512-uHJgbwAMwNFf5mLst7IWLNg14x1CkeqglJb/K3doi4dw6q2IvAAmM/Y81kevy83wP+Sst+nutFTYOGg3d1lsxg==}++ resolution: {integrity: sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==}+ engines: {node: '>= 0.4'}++ resolution: {integrity: sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==}+ engines: {node: '>= 0.4'}++ resolution: {integrity: sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==}+ engines: {node: '>= 0.4'}++ resolution: {integrity: sha512-fWltioiy5zsSAs9ouEnvhsVJeAXRybGCNNv0lvzpzNOSDbULXRy7ivFWwCCv4I5Am6kSo75hmbsCduOoc2/K4w==}+ engines: {node: '>=20'}++ resolution: {integrity: sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==}+ engines: {node: '>= 0.4'}++ resolution: {integrity: sha512-pi1ynXIMFx/uIIwpWJ/5CEtOHLGtnUB0WhGeeYT+fKcQ+WCQbm3/rrkAXnpfph++PgepNqPdTC2WTj8A6k6zoQ==}++ resolution: {integrity: sha512-ztqyC3kLto0e9WbNp0aeP+M3kTt+nbaIveGmUxAtZa+8iFgKLUOD4YKM5j+f3QD89bra7UeumolZHKuOXnTmeQ==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==}+ engines: {node: '>= 4'}++ resolution: {integrity: sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg==}+ engines: {node: '>= 4'}++ resolution: {integrity: sha512-p6u1bG3YSnINT5RQmx/yRZBpenIl30kVxkTLDyHLIMk0gict704Q9n+thfDI7lTRm9vXdDYutVzXhzcThxTnXA==}++ resolution: {integrity: sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==}+ engines: {node: '>=6'}++ resolution: {integrity: sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==}+ engines: {node: '>=0.8.19'}++ resolution: {integrity: sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==}++ resolution: {integrity: sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==}++ resolution: {integrity: sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==}+ engines: {node: '>=0.10.0'}++ resolution: {integrity: sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==}+ engines: {node: '>=0.10.0'}++ resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==}+ engines: {node: '>=0.12.0'}++ resolution: {integrity: sha512-VRSzKkbMm5jMDoKLbltAkFQ5Qr7VDiTFGXxYFXXowVj387GeGNOCsOH6Msy00SGZ3Fp84b1Naa1psqgcCIEP5Q==}+ engines: {node: '>=0.10.0'}++ resolution: {integrity: sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==}++ resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==}++ resolution: {integrity: sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==}+ hasBin: true++ resolution: {integrity: sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==}+ engines: {node: '>=6'}+ hasBin: true++ resolution: {integrity: sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==}++ resolution: {integrity: sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==}++ resolution: {integrity: sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==}+ engines: {node: '>=6'}+ hasBin: true++ resolution: {integrity: sha512-FA5LmZVF1VziNc0bIdCSA1IoSVnDCqE8HJIZZv2/W8YmoAM50+tnUgJR/gQZwEeIMleuIOnRnHA/UaZRNeV4iQ==}++ resolution: {integrity: sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==}+ engines: {node: '>=0.10.0'}++ resolution: {integrity: sha512-JCDrsP4Z1Sb9JwG0aJ8Eo2r7k4Ou5MwmThS/6lcIe1ICyb7UBJKGRIUUdqc2ASdE/42lgz6zFUnzAIhtXnBVrQ==}++ resolution: {integrity: sha512-BH9sEdOCahSgmkVhBLeU7Hc9DWeZ1Eb6wNS6Da8igvUwAe0sqROHddIlvU06q3WyXVEOYDZ6ykBZQnjTbmo4+A==}+ engines: {node: '>= 12.0.0'}+ cpu: [arm64]+ os: [android]++ resolution: {integrity: sha512-ylTcDJBN3Hp21TdhRT5zBOIi73P6/W0qwvlFEk22fkdXchtNTOU4Qc37SkzV+EKYxLouZ6M4LG9NfZ1qkhhBWA==}+ engines: {node: '>= 12.0.0'}+ cpu: [arm64]+ os: [darwin]++ resolution: {integrity: sha512-oBZgKchomuDYxr7ilwLcyms6BCyLn0z8J0+ZZmfpjwg9fRVZIR5/GMXd7r9RH94iDhld3UmSjBM6nXWM2TfZTQ==}+ engines: {node: '>= 12.0.0'}+ cpu: [x64]+ os: [darwin]++ resolution: {integrity: sha512-c2bH6xTrf4BDpK8MoGG4Bd6zAMZDAXS569UxCAGcA7IKbHNMlhGQ89eRmvpIUGfKWNVdbhSbkQaWhEoMGmGslA==}+ engines: {node: '>= 12.0.0'}+ cpu: [x64]+ os: [freebsd]++ resolution: {integrity: sha512-eVdpxh4wYcm0PofJIZVuYuLiqBIakQ9uFZmipf6LF/HRj5Bgm0eb3qL/mr1smyXIS1twwOxNWndd8z0E374hiA==}+ engines: {node: '>= 12.0.0'}+ cpu: [arm]+ os: [linux]++ resolution: {integrity: sha512-UK65WJAbwIJbiBFXpxrbTNArtfuznvxAJw4Q2ZGlU8kPeDIWEX1dg3rn2veBVUylA2Ezg89ktszWbaQnxD/e3A==}+ engines: {node: '>= 12.0.0'}+ cpu: [arm64]+ os: [linux]++ resolution: {integrity: sha512-5Vh9dGeblpTxWHpOx8iauV02popZDsCYMPIgiuw97OJ5uaDsL86cnqSFs5LZkG3ghHoX5isLgWzMs+eD1YzrnA==}+ engines: {node: '>= 12.0.0'}+ cpu: [arm64]+ os: [linux]++ resolution: {integrity: sha512-Cfd46gdmj1vQ+lR6VRTTadNHu6ALuw2pKR9lYq4FnhvgBc4zWY1EtZcAc6EffShbb1MFrIPfLDXD6Xprbnni4w==}+ engines: {node: '>= 12.0.0'}+ cpu: [x64]+ os: [linux]++ resolution: {integrity: sha512-XJaLUUFXb6/QG2lGIW6aIk6jKdtjtcffUT0NKvIqhSBY3hh9Ch+1LCeH80dR9q9LBjG3ewbDjnumefsLsP6aiA==}+ engines: {node: '>= 12.0.0'}+ cpu: [x64]+ os: [linux]++ resolution: {integrity: sha512-FZn+vaj7zLv//D/192WFFVA0RgHawIcHqLX9xuWiQt7P0PtdFEVaxgF9rjM/IRYHQXNnk61/H/gb2Ei+kUQ4xQ==}+ engines: {node: '>= 12.0.0'}+ cpu: [arm64]+ os: [win32]++ resolution: {integrity: sha512-5g1yc73p+iAkid5phb4oVFMB45417DkRevRbt/El/gKXJk4jid+vPFF/AXbxn05Aky8PapwzZrdJShv5C0avjw==}+ engines: {node: '>= 12.0.0'}+ cpu: [x64]+ os: [win32]++ resolution: {integrity: sha512-utfs7Pr5uJyyvDETitgsaqSyjCb2qNRAtuqUeWIAKztsOYdcACf2KtARYXg2pSvhkt+9NfoaNY7fxjl6nuMjIQ==}+ engines: {node: '>= 12.0.0'}++ resolution: {integrity: sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==}++ resolution: {integrity: sha512-jttmRe7bRse52OsWIMDLaXxWqRAmtIUccAQ3garviCqJjafXOfNMO0yMfNpdD6zbGaTU0P5Nz7e7gAT6cKmJRw==}++ resolution: {integrity: sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==}++ resolution: {integrity: sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==}+ engines: {node: '>= 0.4'}++ resolution: {integrity: sha512-APMBEanjybaPzUrfqU0IMU5I0AswKMH7k8OTLs0vvV4KZpExkTkY87nR/zpbuTPj+gARop7aGUbl11pnDfW6xg==}++ resolution: {integrity: sha512-IEn+pegP1aManZuckezWCO+XZQDplx1366JoVhTpMpBB1sPey/SbveZQUosKiKiGYjg1wH4pMlNgXbCiYgihQA==}++ resolution: {integrity: sha512-T2LPsjgUE/tgMmRXREVmwsux89DwWfNjiynOeXuLd2mX6jphGQ2YE3Ukz7LQ2VOFKiVZU/Ee1GqzHiipZCjymw==}++ resolution: {integrity: sha512-pxQJQzB6djGPXh08dacEloMFopsOqGVRKFPYvPOt9XDZ1HasbgDZA74CJGreSU4G3Ak7EFJGoiH2auq+yXISgA==}+ engines: {node: '>=18'}++ resolution: {integrity: sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==}+ engines: {node: '>= 8'}++ resolution: {integrity: sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==}+ engines: {node: '>=8.6'}++ resolution: {integrity: sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==}+ engines: {node: '>= 0.6'}++ resolution: {integrity: sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==}+ engines: {node: '>= 0.6'}++ resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==}++ resolution: {integrity: sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==}+ engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}+ hasBin: true++ resolution: {integrity: sha512-5m3bsyrjFWE1xf7nz7YXdN4udnVtXK6/Yfgn5qnahL6bCkf2yKt4k3nuTKAtT4r3IG8JNR2ncsIMdZuAzJjHQQ==}++ resolution: {integrity: sha512-nmh3lCkYZ3grZvqcCH+fjmQ7X+H0OeZgP40OierEaAptX4XofMh5kwNbWh7lBduUzCcV/8kZ+NDLCwm2iorIlA==}++ resolution: {integrity: sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==}+ engines: {node: '>=0.10.0'}++ resolution: {integrity: sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==}+ engines: {node: '>=6'}++ resolution: {integrity: sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==}++ resolution: {integrity: sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==}+ engines: {node: '>=8.6'}++ resolution: {integrity: sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==}+ engines: {node: '>=12'}++ resolution: {integrity: sha512-3sOlxmbKcSHMjlUXQZKQ06jOswE7oVkXPxmZdoB1r5l0q6gTFTQSHxNxOrCccElbW7dxNytifNEo8qidX2Vsig==}++ resolution: {integrity: sha512-0sglIs9Wmkzbr8lQwEyIzlDOOC9bGmfVKcJTaxv3vMmd3uo4o4DerC3En0bnmgceeql9BfC8hRkp7cg0fjdVqw==}++ resolution: {integrity: sha512-0AioNCJZ2DPYz5ABT6bddIqlhgwhpHZ/l65YAYo0BCIn0xiDpsnTHz0gnoTGk0OXZW0JRs+cDwL8u/teRdz+8A==}+ engines: {node: '>=18.0'}+ peerDependencies:+ postcss: ^8.4.31++ resolution: {integrity: sha512-AjKOeiwAitL/MXxQW2DliT28EKukvvbEWx3LBmJIRN8KfBGZbRTxNYW0kSqi1COiTZ57nZ9NW06S6ux//N1c9A==}+ engines: {node: '>=12.0'}+ peerDependencies:+ postcss: ^8.4.29++ resolution: {integrity: sha512-orRsuYpJVw8LdAwqqLykBj9ecS5/cRHlI5+nvTo8LcCKmzDmqVORXtOIYEEQuL9D4BxtA1lm5isAqzQZCoQ6Eg==}+ engines: {node: '>=4'}++ resolution: {integrity: sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==}++ resolution: {integrity: sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==}+ engines: {node: ^10 || ^12 || >=14}++ resolution: {integrity: sha512-D+zkORCbA9f1tdWRK0RaCR3GPv50cMxcrz4X8k5LTSUD1Dkw47mKJEZQNunItRTkWwgtaUSo1RVFRIG9ZXiFYg==}++ resolution: {integrity: sha512-kXuQdQTB6oN3KhI6V4acnBSZx8D2I4xzZvn9+wFLLFCoBNQY/sFnCW6c43OL7pOQ2HvGV4lnWIXNmgfp7cTWhQ==}+ engines: {node: '>=20'}++ resolution: {integrity: sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==}++ resolution: {integrity: sha512-ibrK8llX2a4eOskq1mXKu/TGZj9qzomO+sNfO98M6d9zIPOEhlBkMkBUBLd1vgS0gQsLDBzA+8jJBVXDnfHmJg==}+ peerDependencies:+ react: ^19.2.1++ resolution: {integrity: sha512-gdlJjD7NWr0IfkPlaREN2d9uUZUlksrfOx7SX62VRerwXbMY6ftGCIZua1VG1aXFNOimhISsTq+Owp725b9SiA==}+ peerDependencies:+ react: '>=16.13.1'++ resolution: {integrity: sha512-VzSlpBHnLanVw79mOxyq98hWDi6DlxK9qPiZ1bAK6bLurMBCaxO/jjyYUrRx9+JGLc/NbnwOmyE/W5Qglbb2QA==}+ peerDependencies:+ babel-runtime: ^5.3.3+ react: '>=0.12.0'++ resolution: {integrity: sha512-MEFcXdkP3dLo8uumGI5xN3lDFNsRtrjbOEKDLD7yv76v4wpnEq2Lt2qeHaQOr34I/wPN3s3+N08WkQ+CW37Xiw==}+ peerDependencies:+ react: '*'++ resolution: {integrity: sha512-QgT5//D3jfjJb6Gsjxv0Slpj23ip+HtOpnNgnb2S5zU3CB26G/IDPGoy4RJB42wzFE46DRsstbW6tKHoKbhAxw==}+ engines: {node: '>=0.10.0'}++ resolution: {integrity: sha512-JNBANI6ChGVjA5bwsUIwJk7LHKmqB4JYnYfzFwyp2t12Izva11elds2jx7Yfoup2zssedntwU0oZ5DEmk5Sdaw==}+ engines: {node: '>=20.0.0'}+ peerDependencies:+ react: '>=18'+ react-dom: '>=18'++ resolution: {integrity: sha512-gHL89dRa3kwlUYtRQ+m8NmxGI6CgqN+k4XyGjwcFoQwwCWF6xXpOCUlDovkXClS0d0XJN/5q7kc5W3kiFEd0Yw==}+ engines: {node: '>=20.0.0'}+ peerDependencies:+ react: '>=18'+ react-dom: '>=18'+ peerDependenciesMeta:+ react-dom:+ optional: true++ resolution: {integrity: sha512-DGrYcCWK7tvYMnWh79yrPHt+vdx9tY+1gPZa7nJQtO/p8bLTDaHp4dzwEhQB7pZ4Xe3ok4XKuEPrVuc+wlpkmw==}+ engines: {node: '>=0.10.0'}++ resolution: {integrity: sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg==}+ engines: {node: '>= 14.18.0'}++ resolution: {integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==}+ engines: {node: '>=0.10.0'}++ resolution: {integrity: sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==}+ engines: {node: '>=4'}++ resolution: {integrity: sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==}+ engines: {iojs: '>=1.0.0', node: '>=0.10.0'}++ resolution: {integrity: sha512-u09tdk/huMiN8xwoiBbig197jKdCamQTtOruSalOzbqGje3jdHiV0njQlAW0YvzoahkirFePNQ4RYlfnRQpXZA==}+ engines: {node: ^20.19.0 || >=22.12.0}+ hasBin: true+ peerDependencies:+ '@types/node': ^20.19.0 || >=22.12.0+ esbuild: ^0.25.0+ jiti: '>=1.21.0'+ less: ^4.0.0+ sass: ^1.70.0+ sass-embedded: ^1.70.0+ stylus: '>=0.54.8'+ sugarss: ^5.0.0+ terser: ^5.16.0+ tsx: ^4.8.1+ yaml: ^2.4.2+ peerDependenciesMeta:+ '@types/node':+ optional: true+ esbuild:+ optional: true+ jiti:+ optional: true+ less:+ optional: true+ sass:+ optional: true+ sass-embedded:+ optional: true+ stylus:+ optional: true+ sugarss:+ optional: true+ terser:+ optional: true+ tsx:+ optional: true+ yaml:+ optional: true++ resolution: {integrity: sha512-JFULvCNl/anKn99eKjOSEubi0lLmNqQDAjyEMME2T4CwezUDL0i6t1O9xZsu2OMehPnV2caNefWpGF+8TnzB6A==}+ engines: {node: ^20.19.0 || >=22.12.0}+ hasBin: true++ resolution: {integrity: sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==}++ resolution: {integrity: sha512-9QMjhLq+UkOg/4bb8Lt8A+hJZvY3t+9xeZMKSBtBEgxrXA3ed5Ts4NDreUkYgJP1BTmrscQE/xYhf7iShow6lw==}+ engines: {node: '>=14.0.0'}+ hasBin: true++ resolution: {integrity: sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q==}++ resolution: {integrity: sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==}+ hasBin: true++ resolution: {integrity: sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw==}++ resolution: {integrity: sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==}+ engines: {node: '>=14'}++ resolution: {integrity: sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-qMCMfhY040cVHT43K9BFygqYbUPFZKHOg7K73mtTWJRb8pyP3fzf4Ixd5SzdEJQ6MRUg/WBnOLxghZtKKurENQ==}+ engines: {node: '>=10'}++ resolution: {integrity: sha512-W6ZN4p58k8aDKA4XPcx2hpIQXBRAgyiWVkYhT7CvK6D3iAu7xjvVyhQHg2/iaKJZ1XVJ4r7XuwGL+WGEK37i9w==}+ peerDependencies:+ react: ^18.0.0 || ^19.0.0 || ^19.0.0-rc+ react-dom: ^18.0.0 || ^19.0.0 || ^19.0.0-rc++ resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==}+ engines: {node: '>=0.10.0'}++ resolution: {integrity: sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-Gr2qLiyvJGKeDk0E/+awNTrZB/UtNVPLqCDOr07na/sLekZwm26Br6yYIeBYz3ulsEcQgs5j+2IIMXCC+wsaQA==}+ engines: {node: 14.* || 16.* || >= 18}+ hasBin: true+ peerDependencies:+ stylelint: '>=15.0.0'++ resolution: {integrity: sha512-aUTHhPPWCvFyWaxtckJlCPaXTDFsp4pKO8evXNCsW9OwsaUWyMd6jvcUhSmfGWPrTddvzNqK4rS/UuSLcbVGdQ==}+ engines: {node: '>=20'}+ peerDependencies:+ postcss: ^8.3.3+ stylelint: ^16.24.0+ peerDependenciesMeta:+ postcss:+ optional: true++ resolution: {integrity: sha512-WaMSdEiPfZTSFVoYmJbxorJfA610O0tlYuU2aEwY33UQhSPgFbClrVJYWvy3jGJx+XW37O+LyNLiZOEXhKhJmA==}+ engines: {node: '>=18.12.0'}+ peerDependencies:+ stylelint: ^16.23.0++ resolution: {integrity: sha512-/FHECLUu+med/e6OaPFpprG86ShC4SYT7Tzb2PTVdDjJsehhFBOioSlWqYFqJxmGPIwO3AMBxNo+kY3dxrbczA==}+ engines: {node: '>=20'}+ peerDependencies:+ postcss: ^8.3.3+ stylelint: ^16.23.1+ peerDependenciesMeta:+ postcss:+ optional: true++ resolution: {integrity: sha512-b7Fja59EYHRNOTa3aXiuWnhUWXFU2Nfg6h61bLfAb5GS5fX3LMUD0U5t4S8N/4tpHQg3Acs2UVPR9jy2l1g/3A==}+ engines: {node: '>=18.12.0'}+ peerDependencies:+ stylelint: ^16.23.0++ resolution: {integrity: sha512-kZPwFUJkfup2gP1enlrS2h9U5+T5wFoqzJ1n/56AlpwSj28kmFe7ww/QFydvPsg5gLjWchAwWWBLtterynZrOw==}+ engines: {node: '>=18.12.0'}+ peerDependencies:+ stylelint: ^16.8.2++ resolution: {integrity: sha512-v20V59/crfc8sVTAtge0mdafI3AdnzQ2KsWe6v523L4OA1bJO02S7MO2oyXDCS6iWb9ckIPnqAFVItqSBQr7jw==}+ engines: {node: '>=18.12.0'}+ hasBin: true++ resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==}+ engines: {node: '>=8'}++ resolution: {integrity: sha512-zFObLMyZeEwzAoKCyu1B91U79K2t7ApXuQfo8OuxwXLDgcKxuwM+YvcbIhm6QWqz7mHUH1TVytR1PwVVjEuMig==}+ engines: {node: '>=14.18'}++ resolution: {integrity: sha512-ovssysQTa+luh7A5Weu3Rta6FJlFBBbInjOh722LIt6klpU2/HtdUbszju/G4devcvk8PGt7FCLv5wftu3THUA==}++ resolution: {integrity: sha512-9kY+CygyYM6j02t5YFHbNz2FN5QmYGv9zAjVp4lCDjlCw7amdckXlEt/bjMhUIfj4ThGRE4gCUH5+yGnNuPo5A==}+ engines: {node: '>=10.0.0'}++ resolution: {integrity: sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==}+ engines: {node: '>=12.0.0'}++ resolution: {integrity: sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==}+ engines: {node: '>=8.0'}++ resolution: {integrity: sha512-ks6Vjr/jEw0P1gmOVwutM3B7fWxoWBL2KRDb1JfqGVawBmO5UsvmWOQFGHBPl5yxYz4eERr19E6L7NMv+Fej4w==}+ engines: {node: ^18 || >=20}+ hasBin: true+ peerDependencies:+ typescript: ^5.0.0+ peerDependenciesMeta:+ typescript:+ optional: true++ resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}++ resolution: {integrity: sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==}+ engines: {node: '>=14.17'}+ hasBin: true++ resolution: {integrity: sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==}++ resolution: {integrity: sha512-E85pfNzMQ9jpKkA7+TJAi4TJN+tBCuWh5rUcS/sv6cFi+1q9LYDwDI5dpUL0u/73EElyQ8d3TEaeW4sPedBqYA==}+ hasBin: true+ peerDependencies:+ browserslist: '>= 4.21.0'++ resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==}++ resolution: {integrity: sha512-cYj0LRuLV2c2sMqhqhGpaO3LretdtMn/BVX4cPLanIZuwwrkVl+lK84E/miEXkCHWXuq65rhNN4rXsBcOB3S4w==}+ peerDependencies:+ vite: '*'+ peerDependenciesMeta:+ vite:+ optional: true++ resolution: {integrity: sha512-HxJdYWq1MTIQbJ3nw0cqssHoTNU267KlrDuGZ1WYlxDStUtKUhOaJmh112/TZmHxxUfuJqPXSOm7tDyas0OSIQ==}+ hasBin: true++ resolution: {integrity: sha512-+QU2zd6OTD8XWIJCbffaiQeH9U73qIqafo1x6V1snCWYGJf6cVE0cDR4D8xRzcEnfI21IFrUPzPGtcPf8AC+Rw==}+ engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0}++ resolution: {integrity: sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==}++ resolution: {integrity: sha512-AvvthqfqrAhNH9dnfmrfKzX5upOdjUVJYFqNSlkmGf64gRaTzlPwz99IHYnVs28qYAybvAlBV+H7pn0saFY4Ig==}++ resolution: {integrity: sha512-ALBtUj0AfjJt3uNRQoL1tL2tMvj6Gp/6e39dnfT6uzpelGru8v1tPOGBzayOWbPJvujM8JojDk3E1LxeFisBNg==}+ engines: {node: '>=12.20.0'}+ peerDependencies:+ '@types/react': '>=18.0.0'+ immer: '>=9.0.6'+ react: '>=18.0.0'+ use-sync-external-store: '>=1.2.0'+ peerDependenciesMeta:+ '@types/react':+ optional: true+ immer:+ optional: true+ react:+ optional: true+ use-sync-external-store:+ optional: true++snapshots:++ '@babel/[email protected]':+ dependencies:+ '@babel/helper-validator-identifier': 7.28.5+ js-tokens: 4.0.0+ picocolors: 1.1.1++ '@babel/[email protected]': {}++ '@babel/[email protected]':+ dependencies:+ '@babel/code-frame': 7.27.1+ '@babel/generator': 7.28.5+ '@babel/helper-compilation-targets': 7.27.2+ '@babel/helper-module-transforms': 7.28.3(@babel/[email protected])+ '@babel/helpers': 7.28.4+ '@babel/parser': 7.28.5+ '@babel/template': 7.27.2+ '@babel/traverse': 7.28.5+ '@babel/types': 7.28.5+ '@jridgewell/remapping': 2.3.5+ convert-source-map: 2.0.0+ debug: 4.4.3+ gensync: 1.0.0-beta.2+ json5: 2.2.3+ semver: 6.3.1+ transitivePeerDependencies:+ - supports-color++ '@babel/[email protected]':+ dependencies:+ '@babel/parser': 7.28.5+ '@babel/types': 7.28.5+ '@jridgewell/gen-mapping': 0.3.13+ '@jridgewell/trace-mapping': 0.3.31+ jsesc: 3.1.0++ '@babel/[email protected]':+ dependencies:+ '@babel/compat-data': 7.28.5+ '@babel/helper-validator-option': 7.27.1+ browserslist: 4.28.1+ lru-cache: 5.1.1+ semver: 6.3.1++ '@babel/[email protected]': {}++ '@babel/[email protected]':+ dependencies:+ '@babel/traverse': 7.28.5+ '@babel/types': 7.28.5+ transitivePeerDependencies:+ - supports-color++ '@babel/[email protected](@babel/[email protected])':+ dependencies:+ '@babel/core': 7.28.5+ '@babel/helper-module-imports': 7.27.1+ '@babel/helper-validator-identifier': 7.28.5+ '@babel/traverse': 7.28.5+ transitivePeerDependencies:+ - supports-color++ '@babel/[email protected]': {}++ '@babel/[email protected]': {}++ '@babel/[email protected]': {}++ '@babel/[email protected]': {}++ '@babel/[email protected]':+ dependencies:+ '@babel/template': 7.27.2+ '@babel/types': 7.28.5++ '@babel/[email protected]':+ dependencies:+ '@babel/types': 7.28.5++ '@babel/[email protected](@babel/[email protected])':+ dependencies:+ '@babel/core': 7.28.5+ '@babel/helper-plugin-utils': 7.27.1++ '@babel/[email protected](@babel/[email protected])':+ dependencies:+ '@babel/core': 7.28.5+ '@babel/helper-plugin-utils': 7.27.1++ '@babel/[email protected]': {}++ '@babel/[email protected]':+ dependencies:+ '@babel/code-frame': 7.27.1+ '@babel/parser': 7.28.5+ '@babel/types': 7.28.5++ '@babel/[email protected]':+ dependencies:+ '@babel/code-frame': 7.27.1+ '@babel/generator': 7.28.5+ '@babel/helper-globals': 7.28.0+ '@babel/parser': 7.28.5+ '@babel/template': 7.27.2+ '@babel/types': 7.28.5+ debug: 4.4.3+ transitivePeerDependencies:+ - supports-color++ '@babel/[email protected]':+ dependencies:+ '@babel/helper-string-parser': 7.27.1+ '@babel/helper-validator-identifier': 7.28.5++ '@biomejs/[email protected]':+ optionalDependencies:+ '@biomejs/cli-darwin-arm64': 2.3.8+ '@biomejs/cli-darwin-x64': 2.3.8+ '@biomejs/cli-linux-arm64': 2.3.8+ '@biomejs/cli-linux-arm64-musl': 2.3.8+ '@biomejs/cli-linux-x64': 2.3.8+ '@biomejs/cli-linux-x64-musl': 2.3.8+ '@biomejs/cli-win32-arm64': 2.3.8+ '@biomejs/cli-win32-x64': 2.3.8++ '@biomejs/[email protected]':+ optional: true++ '@biomejs/[email protected]':+ optional: true++ '@biomejs/[email protected]':+ optional: true++ '@biomejs/[email protected]':+ optional: true++ '@biomejs/[email protected]':+ optional: true++ '@biomejs/[email protected]':+ optional: true++ '@biomejs/[email protected]':+ optional: true++ '@biomejs/[email protected]':+ optional: true++ '@cacheable/[email protected]':+ dependencies:+ '@cacheable/utils': 2.3.2+ '@keyv/bigmap': 1.3.0([email protected])+ hookified: 1.14.0+ keyv: 5.5.5++ '@cacheable/[email protected]':+ dependencies:+ hashery: 1.3.0+ keyv: 5.5.5++ '@csstools/[email protected](@csstools/[email protected])':+ dependencies:+ '@csstools/css-tokenizer': 3.0.4++ '@csstools/[email protected]': {}++ '@csstools/[email protected]': {}++ '@csstools/[email protected](@csstools/[email protected](@csstools/[email protected]))(@csstools/[email protected])':+ dependencies:+ '@csstools/css-parser-algorithms': 3.0.5(@csstools/[email protected])+ '@csstools/css-tokenizer': 3.0.4++ '@csstools/[email protected]([email protected])':+ dependencies:+ postcss-selector-parser: 7.1.1++ '@dual-bundle/[email protected]': {}++ '@emnapi/[email protected]':+ dependencies:+ '@emnapi/wasi-threads': 1.1.0+ tslib: 2.8.1+ optional: true++ '@emnapi/[email protected]':+ dependencies:+ tslib: 2.8.1+ optional: true++ '@emnapi/[email protected]':+ dependencies:+ tslib: 2.8.1+ optional: true++ '@jridgewell/[email protected]':+ dependencies:+ '@jridgewell/sourcemap-codec': 1.5.5+ '@jridgewell/trace-mapping': 0.3.31++ '@jridgewell/[email protected]':+ dependencies:+ '@jridgewell/gen-mapping': 0.3.13+ '@jridgewell/trace-mapping': 0.3.31++ '@jridgewell/[email protected]': {}++ '@jridgewell/[email protected]': {}++ '@jridgewell/[email protected]':+ dependencies:+ '@jridgewell/resolve-uri': 3.1.2+ '@jridgewell/sourcemap-codec': 1.5.5++ '@keyv/[email protected]([email protected])':+ dependencies:+ hashery: 1.3.0+ hookified: 1.14.0+ keyv: 5.5.5++ '@keyv/[email protected]': {}++ '@napi-rs/[email protected]':+ dependencies:+ '@emnapi/core': 1.7.1+ '@emnapi/runtime': 1.7.1+ '@tybys/wasm-util': 0.10.1+ optional: true++ '@nodelib/[email protected]':+ dependencies:+ '@nodelib/fs.stat': 2.0.5+ run-parallel: 1.2.0++ '@nodelib/[email protected]': {}++ '@nodelib/[email protected]':+ dependencies:+ '@nodelib/fs.scandir': 2.1.5+ fastq: 1.19.1++ '@oxc-project/[email protected]': {}++ '@oxc-project/[email protected]': {}++ '@parcel/[email protected]':+ optional: true++ '@parcel/[email protected]':+ optional: true++ '@parcel/[email protected]':+ optional: true++ '@parcel/[email protected]':+ optional: true++ '@parcel/[email protected]':+ optional: true++ '@parcel/[email protected]':+ optional: true++ '@parcel/[email protected]':+ optional: true++ '@parcel/[email protected]':+ optional: true++ '@parcel/[email protected]':+ optional: true++ '@parcel/[email protected]':+ optional: true++ '@parcel/[email protected]':+ optional: true++ '@parcel/[email protected]':+ optional: true++ '@parcel/[email protected]':+ optional: true++ '@parcel/[email protected]':+ dependencies:+ detect-libc: 1.0.3+ is-glob: 4.0.3+ micromatch: 4.0.8+ node-addon-api: 7.1.1+ optionalDependencies:+ '@parcel/watcher-android-arm64': 2.5.1+ '@parcel/watcher-darwin-arm64': 2.5.1+ '@parcel/watcher-darwin-x64': 2.5.1+ '@parcel/watcher-freebsd-x64': 2.5.1+ '@parcel/watcher-linux-arm-glibc': 2.5.1+ '@parcel/watcher-linux-arm-musl': 2.5.1+ '@parcel/watcher-linux-arm64-glibc': 2.5.1+ '@parcel/watcher-linux-arm64-musl': 2.5.1+ '@parcel/watcher-linux-x64-glibc': 2.5.1+ '@parcel/watcher-linux-x64-musl': 2.5.1+ '@parcel/watcher-win32-arm64': 2.5.1+ '@parcel/watcher-win32-ia32': 2.5.1+ '@parcel/watcher-win32-x64': 2.5.1+ optional: true++ '@rolldown/[email protected]':+ optional: true++ '@rolldown/[email protected]':+ optional: true++ '@rolldown/[email protected]':+ optional: true++ '@rolldown/[email protected]':+ optional: true++ '@rolldown/[email protected]':+ optional: true++ '@rolldown/[email protected]':+ optional: true++ '@rolldown/[email protected]':+ optional: true++ '@rolldown/[email protected]':+ optional: true++ '@rolldown/[email protected]':+ optional: true++ '@rolldown/[email protected]':+ optional: true++ '@rolldown/[email protected]':+ dependencies:+ '@napi-rs/wasm-runtime': 1.1.0+ optional: true++ '@rolldown/[email protected]':+ optional: true++ '@rolldown/[email protected]':+ optional: true++ '@rolldown/[email protected]':+ optional: true++ '@rolldown/[email protected]': {}++ '@rolldown/[email protected]': {}++ '@tanstack/[email protected]': {}++ '@tanstack/[email protected]': {}++ dependencies:+ '@tanstack/query-devtools': 5.91.1+ '@tanstack/react-query': 5.90.12([email protected])+ react: 19.2.1++ '@tanstack/[email protected]([email protected])':+ dependencies:+ '@tanstack/query-core': 5.90.12+ react: 19.2.1++ '@tybys/[email protected]':+ dependencies:+ tslib: 2.8.1+ optional: true++ '@types/[email protected]':+ dependencies:+ '@babel/parser': 7.28.5+ '@babel/types': 7.28.5+ '@types/babel__generator': 7.27.0+ '@types/babel__template': 7.4.4+ '@types/babel__traverse': 7.28.0++ '@types/[email protected]':+ dependencies:+ '@babel/types': 7.28.5++ '@types/[email protected]':+ dependencies:+ '@babel/parser': 7.28.5+ '@babel/types': 7.28.5++ '@types/[email protected]':+ dependencies:+ '@babel/types': 7.28.5++ '@types/[email protected]':+ dependencies:+ undici-types: 7.16.0++ '@types/[email protected](@types/[email protected])':+ dependencies:+ '@types/react': 19.2.7++ '@types/[email protected]':+ dependencies:+ csstype: 3.2.3++ dependencies:+ '@babel/core': 7.28.5+ '@babel/plugin-transform-react-jsx-self': 7.27.1(@babel/[email protected])+ '@babel/plugin-transform-react-jsx-source': 7.27.1(@babel/[email protected])+ '@rolldown/pluginutils': 1.0.0-beta.53+ '@types/babel__core': 7.20.5+ react-refresh: 0.18.0+ transitivePeerDependencies:+ - supports-color++ dependencies:+ fast-deep-equal: 3.1.3+ fast-uri: 3.1.0+ json-schema-traverse: 1.0.0+ require-from-string: 2.0.2++ [email protected]: {}++ dependencies:+ color-convert: 2.0.1++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ dependencies:+ follow-redirects: 1.15.11+ form-data: 4.0.5+ proxy-from-env: 1.1.0+ transitivePeerDependencies:+ - debug++ dependencies:+ core-js: 1.2.7++ [email protected]: {}++ [email protected]: {}++ dependencies:+ fill-range: 7.1.1++ dependencies:+ baseline-browser-mapping: 2.9.5+ caniuse-lite: 1.0.30001759+ electron-to-chromium: 1.5.267+ node-releases: 2.0.27+ update-browserslist-db: 1.2.2([email protected])++ dependencies:+ '@cacheable/memory': 2.0.6+ '@cacheable/utils': 2.3.2+ hookified: 1.14.0+ keyv: 5.5.5+ qified: 0.5.3++ dependencies:+ es-errors: 1.3.0+ function-bind: 1.1.2++ [email protected]: {}++ [email protected]: {}++ dependencies:+ readdirp: 4.1.2++ dependencies:+ color-name: 1.1.4++ [email protected]: {}++ [email protected]: {}++ dependencies:+ delayed-stream: 1.0.0++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ dependencies:+ env-paths: 2.2.1+ import-fresh: 3.3.1+ js-yaml: 4.1.1+ parse-json: 5.2.0+ optionalDependencies:+ typescript: 5.9.3++ [email protected]: {}++ dependencies:+ mdn-data: 2.12.2+ source-map-js: 1.2.1++ [email protected]: {}++ [email protected]: {}++ dependencies:+ ms: 2.1.3++ [email protected]: {}++ optional: true++ [email protected]: {}++ dependencies:+ path-type: 4.0.0++ dependencies:+ call-bind-apply-helpers: 1.0.2+ es-errors: 1.3.0+ gopd: 1.2.0++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ dependencies:+ is-arrayish: 0.2.1++ [email protected]: {}++ [email protected]: {}++ dependencies:+ es-errors: 1.3.0++ dependencies:+ es-errors: 1.3.0+ get-intrinsic: 1.3.0+ has-tostringtag: 1.0.2+ hasown: 2.0.2++ [email protected]: {}++ [email protected]: {}++ dependencies:+ '@nodelib/fs.stat': 2.0.5+ '@nodelib/fs.walk': 1.2.8+ glob-parent: 5.1.2+ merge2: 1.4.1+ micromatch: 4.0.8++ [email protected]: {}++ [email protected]: {}++ dependencies:+ reusify: 1.1.0++ optionalDependencies:+ picomatch: 4.0.3++ dependencies:+ flat-cache: 6.1.19++ dependencies:+ to-regex-range: 5.0.1++ dependencies:+ cacheable: 2.3.0+ flatted: 3.3.3+ hookified: 1.14.0++ [email protected]: {}++ [email protected]: {}++ dependencies:+ asynckit: 0.4.0+ combined-stream: 1.0.8+ es-set-tostringtag: 2.1.0+ hasown: 2.0.2+ mime-types: 2.1.35++ optional: true++ [email protected]: {}++ [email protected]: {}++ dependencies:+ call-bind-apply-helpers: 1.0.2+ es-define-property: 1.0.1+ es-errors: 1.3.0+ es-object-atoms: 1.1.1+ function-bind: 1.1.2+ get-proto: 1.0.1+ gopd: 1.2.0+ has-symbols: 1.1.0+ hasown: 2.0.2+ math-intrinsics: 1.1.0++ dependencies:+ dunder-proto: 1.0.1+ es-object-atoms: 1.1.1++ dependencies:+ is-glob: 4.0.3++ dependencies:+ global-prefix: 3.0.0++ dependencies:+ ini: 1.3.8+ kind-of: 6.0.3+ which: 1.3.1++ dependencies:+ array-union: 2.1.0+ dir-glob: 3.0.1+ fast-glob: 3.3.3+ ignore: 5.3.2+ merge2: 1.4.1+ slash: 3.0.0++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ dependencies:+ has-symbols: 1.1.0++ dependencies:+ hookified: 1.14.0++ dependencies:+ function-bind: 1.1.2++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ dependencies:+ parent-module: 1.0.1+ resolve-from: 4.0.0++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ dependencies:+ is-extglob: 2.1.1++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ dependencies:+ argparse: 2.0.1++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ dependencies:+ '@keyv/serialize': 1.1.1++ [email protected]: {}++ [email protected]: {}++ optional: true++ optional: true++ optional: true++ optional: true++ optional: true++ optional: true++ optional: true++ optional: true++ optional: true++ optional: true++ optional: true++ dependencies:+ detect-libc: 2.1.2+ optionalDependencies:+ lightningcss-android-arm64: 1.30.2+ lightningcss-darwin-arm64: 1.30.2+ lightningcss-darwin-x64: 1.30.2+ lightningcss-freebsd-x64: 1.30.2+ lightningcss-linux-arm-gnueabihf: 1.30.2+ lightningcss-linux-arm64-gnu: 1.30.2+ lightningcss-linux-arm64-musl: 1.30.2+ lightningcss-linux-x64-gnu: 1.30.2+ lightningcss-linux-x64-musl: 1.30.2+ lightningcss-win32-arm64-msvc: 1.30.2+ lightningcss-win32-x64-msvc: 1.30.2++ [email protected]: {}++ [email protected]: {}++ dependencies:+ yallist: 3.1.1++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ dependencies:+ braces: 3.0.3+ picomatch: 2.3.1++ [email protected]: {}++ dependencies:+ mime-db: 1.52.0++ [email protected]: {}++ [email protected]: {}++ optional: true++ [email protected]: {}++ [email protected]: {}++ dependencies:+ callsites: 3.1.0++ dependencies:+ '@babel/code-frame': 7.27.1+ error-ex: 1.3.4+ json-parse-even-better-errors: 2.3.1+ lines-and-columns: 1.2.4++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ dependencies:+ postcss: 8.5.6++ dependencies:+ postcss: 8.5.6++ dependencies:+ cssesc: 3.0.0+ util-deprecate: 1.0.2++ [email protected]: {}++ dependencies:+ nanoid: 3.3.11+ picocolors: 1.1.1+ source-map-js: 1.2.1++ [email protected]: {}++ dependencies:+ hookified: 1.14.0++ [email protected]: {}++ dependencies:+ react: 19.2.1+ scheduler: 0.27.0++ dependencies:+ '@babel/runtime': 7.28.4+ react: 19.2.1++ dependencies:+ babel-runtime: 5.8.38+ react: 19.2.1++ dependencies:+ react: 19.2.1++ [email protected]: {}++ dependencies:+ react: 19.2.1+ react-dom: 19.2.1([email protected])++ dependencies:+ cookie: 1.1.1+ react: 19.2.1+ set-cookie-parser: 2.7.2+ optionalDependencies:+ react-dom: 19.2.1([email protected])++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ dependencies:+ '@oxc-project/runtime': 0.97.0+ fdir: 6.5.0([email protected])+ lightningcss: 1.30.2+ picomatch: 4.0.3+ postcss: 8.5.6+ rolldown: 1.0.0-beta.50+ tinyglobby: 0.2.15+ optionalDependencies:+ '@types/node': 24.10.2+ fsevents: 2.3.3+ sass: 1.95.0++ dependencies:+ '@oxc-project/types': 0.97.0+ '@rolldown/pluginutils': 1.0.0-beta.50+ optionalDependencies:+ '@rolldown/binding-android-arm64': 1.0.0-beta.50+ '@rolldown/binding-darwin-arm64': 1.0.0-beta.50+ '@rolldown/binding-darwin-x64': 1.0.0-beta.50+ '@rolldown/binding-freebsd-x64': 1.0.0-beta.50+ '@rolldown/binding-linux-arm-gnueabihf': 1.0.0-beta.50+ '@rolldown/binding-linux-arm64-gnu': 1.0.0-beta.50+ '@rolldown/binding-linux-arm64-musl': 1.0.0-beta.50+ '@rolldown/binding-linux-x64-gnu': 1.0.0-beta.50+ '@rolldown/binding-linux-x64-musl': 1.0.0-beta.50+ '@rolldown/binding-openharmony-arm64': 1.0.0-beta.50+ '@rolldown/binding-wasm32-wasi': 1.0.0-beta.50+ '@rolldown/binding-win32-arm64-msvc': 1.0.0-beta.50+ '@rolldown/binding-win32-ia32-msvc': 1.0.0-beta.50+ '@rolldown/binding-win32-x64-msvc': 1.0.0-beta.50++ dependencies:+ queue-microtask: 1.2.3++ dependencies:+ chokidar: 4.0.3+ immutable: 5.1.4+ source-map-js: 1.2.1+ optionalDependencies:+ '@parcel/watcher': 2.5.1++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ [email protected]: {}++ dependencies:+ ansi-styles: 4.3.0+ astral-regex: 2.0.0+ is-fullwidth-code-point: 3.0.0++ dependencies:+ react: 19.2.1+ react-dom: 19.2.1([email protected])++ [email protected]: {}++ dependencies:+ emoji-regex: 8.0.0+ is-fullwidth-code-point: 3.0.0+ strip-ansi: 6.0.1++ dependencies:+ ansi-regex: 5.0.1++ dependencies:+ stylelint: 16.26.1([email protected])++ dependencies:+ postcss-scss: 4.0.9([email protected])+ stylelint: 16.26.1([email protected])+ stylelint-config-recommended: 17.0.0([email protected]([email protected]))+ stylelint-scss: 6.13.0([email protected]([email protected]))+ optionalDependencies:+ postcss: 8.5.6++ dependencies:+ stylelint: 16.26.1([email protected])++ dependencies:+ stylelint: 16.26.1([email protected])+ stylelint-config-recommended-scss: 16.0.2([email protected])([email protected]([email protected]))+ stylelint-config-standard: 39.0.1([email protected]([email protected]))+ optionalDependencies:+ postcss: 8.5.6++ dependencies:+ stylelint: 16.26.1([email protected])+ stylelint-config-recommended: 17.0.0([email protected]([email protected]))++ dependencies:+ css-tree: 3.1.0+ is-plain-object: 5.0.0+ known-css-properties: 0.37.0+ mdn-data: 2.25.0+ postcss-media-query-parser: 0.2.3+ postcss-resolve-nested-selector: 0.1.6+ postcss-selector-parser: 7.1.1+ postcss-value-parser: 4.2.0+ stylelint: 16.26.1([email protected])++ dependencies:+ '@csstools/css-parser-algorithms': 3.0.5(@csstools/[email protected])+ '@csstools/css-syntax-patches-for-csstree': 1.0.20+ '@csstools/css-tokenizer': 3.0.4+ '@csstools/media-query-list-parser': 4.0.3(@csstools/[email protected](@csstools/[email protected]))(@csstools/[email protected])+ '@csstools/selector-specificity': 5.0.0([email protected])+ '@dual-bundle/import-meta-resolve': 4.2.1+ balanced-match: 2.0.0+ colord: 2.9.3+ cosmiconfig: 9.0.0([email protected])+ css-functions-list: 3.2.3+ css-tree: 3.1.0+ debug: 4.4.3+ fast-glob: 3.3.3+ fastest-levenshtein: 1.0.16+ file-entry-cache: 11.1.1+ global-modules: 2.0.0+ globby: 11.1.0+ globjoin: 0.1.4+ html-tags: 3.3.1+ ignore: 7.0.5+ imurmurhash: 0.1.4+ is-plain-object: 5.0.0+ known-css-properties: 0.37.0+ mathml-tag-names: 2.1.3+ meow: 13.2.0+ micromatch: 4.0.8+ normalize-path: 3.0.0+ picocolors: 1.1.1+ postcss: 8.5.6+ postcss-resolve-nested-selector: 0.1.6+ postcss-safe-parser: 7.0.1([email protected])+ postcss-selector-parser: 7.1.1+ postcss-value-parser: 4.2.0+ resolve-from: 5.0.0+ string-width: 4.2.3+ supports-hyperlinks: 3.2.0+ svg-tags: 1.0.0+ table: 6.9.0+ write-file-atomic: 5.0.1+ transitivePeerDependencies:+ - supports-color+ - typescript++ dependencies:+ has-flag: 4.0.0++ dependencies:+ has-flag: 4.0.0+ supports-color: 7.2.0++ [email protected]: {}++ dependencies:+ ajv: 8.17.1+ lodash.truncate: 4.4.2+ slice-ansi: 4.0.0+ string-width: 4.2.3+ strip-ansi: 6.0.1++ dependencies:+ fdir: 6.5.0([email protected])+ picomatch: 4.0.3++ dependencies:+ is-number: 7.0.0++ optionalDependencies:+ typescript: 5.9.3++ optional: true++ [email protected]: {}++ [email protected]: {}++ dependencies:+ browserslist: 4.28.1+ escalade: 3.2.0+ picocolors: 1.1.1++ [email protected]: {}++ [email protected]([email protected](@types/[email protected])([email protected]))([email protected]):+ dependencies:+ debug: 4.4.3+ globrex: 0.1.2+ tsconfck: 3.1.6([email protected])+ optionalDependencies:+ transitivePeerDependencies:+ - supports-color+ - typescript++ dependencies:+ isexe: 2.0.0++ dependencies:+ imurmurhash: 0.1.4+ signal-exit: 4.1.0++ [email protected]: {}++ [email protected]: {}++ optionalDependencies:+ '@types/react': 19.2.7+ react: 19.2.1diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/android-chrome-192x192.png b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/android-chrome-192x192.pngnew file mode 100644index 00000000..6a31898fBinary files /dev/null and b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/android-chrome-192x192.png differdiff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/android-chrome-512x512.png b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/android-chrome-512x512.pngnew file mode 100644index 00000000..e79bc036Binary files /dev/null and b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/android-chrome-512x512.png differdiff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/apple-touch-icon.png b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/apple-touch-icon.pngnew file mode 100644index 00000000..be0c040aBinary files /dev/null and b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/apple-touch-icon.png differdiff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/favicon-16x16.png b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/favicon-16x16.pngnew file mode 100644index 00000000..32c2cf96Binary files /dev/null and b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/favicon-16x16.png differdiff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/favicon-32x32.png b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/favicon-32x32.pngnew file mode 100644index 00000000..87c75f42Binary files /dev/null and b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/favicon-32x32.png differdiff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/favicon.ico b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/favicon.iconew file mode 100644index 00000000..6c43eeacBinary files /dev/null and b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/favicon.ico differdiff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/site.webmanifest b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/site.webmanifestnew file mode 100644index 00000000..1dd91123--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/public/assets/site.webmanifest@@ -0,0 +1 @@+{"name":"","short_name":"","icons":[{"src":"/android-chrome-192x192.png","sizes":"192x192","type":"image/png"},{"src":"/android-chrome-512x512.png","sizes":"512x512","type":"image/png"}],"theme_color":"#ffffff","background_color":"#ffffff","display":"standalone"}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/App.tsx b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/App.tsxnew file mode 100644index 00000000..a7d82d6a--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/App.tsx@@ -0,0 +1,36 @@+// ===========================+// Β©AngelaMos | 2026+// App.tsx+// ===========================++import { QueryClientProvider } from '@tanstack/react-query'+import { ReactQueryDevtools } from '@tanstack/react-query-devtools'+import { RouterProvider } from 'react-router-dom'+import { Toaster } from 'sonner'++import { queryClient } from '@/core/api'+import { router } from '@/core/app/routers'+import '@/core/app/toast.module.scss'++export default function App(): React.ReactElement {+ return (+ <QueryClientProvider client={queryClient}>+ <div className="app">+ <RouterProvider router={router} />+ <Toaster+ position="top-right"+ duration={2000}+ theme="dark"+ toastOptions={{+ style: {+ background: 'hsl(0, 0%, 12.2%)',+ border: '1px solid hsl(0, 0%, 18%)',+ color: 'hsl(0, 0%, 98%)',+ },+ }}+ />+ </div>+ <ReactQueryDevtools initialIsOpen={false} />+ </QueryClientProvider>+ )+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/api/hooks/index.ts b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/api/hooks/index.tsnew file mode 100644index 00000000..6221af9a--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/api/hooks/index.ts@@ -0,0 +1,4 @@+// ===================+// Β© AngelaMos | 2026+// index.ts+// ===================diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/api/index.ts b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/api/index.tsnew file mode 100644index 00000000..0840a7c1--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/api/index.ts@@ -0,0 +1,7 @@+// ===================+// Β© AngelaMos | 2025+// index.ts+// ===================++export * from './hooks'+export * from './types'diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/api/types/index.ts b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/api/types/index.tsnew file mode 100644index 00000000..6221af9a--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/api/types/index.ts@@ -0,0 +1,4 @@+// ===================+// Β© AngelaMos | 2026+// index.ts+// ===================diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/components/index.tsx b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/components/index.tsxnew file mode 100644index 00000000..6b0a7329--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/components/index.tsx@@ -0,0 +1,4 @@+/**+ * Β©AngelaMos | 2025+ * index.tsx+ */diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/config.ts b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/config.tsnew file mode 100644index 00000000..87c9647a--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/config.ts@@ -0,0 +1,68 @@+// ===================+// Β© AngelaMos | 2026+// config.ts+// ===================+const API_VERSION = 'v1'++export const API_ENDPOINTS = {+ USERS: {+ BASE: `/${API_VERSION}/users`,+ BY_ID: (id: string) => `/${API_VERSION}/users/${id}`,+ },+} as const++export const QUERY_KEYS = {+ USERS: {+ ALL: ['users'] as const,+ BY_ID: (id: string) => [...QUERY_KEYS.USERS.ALL, 'detail', id] as const,+ },+} as const++export const ROUTES = {+ HOME: '/',+ DASHBOARD: '/dashboard',+ SETTINGS: '/settings',+} as const++export const STORAGE_KEYS = {+ UI: 'ui-storage',+} as const++export const QUERY_CONFIG = {+ STALE_TIME: {+ USER: 1000 * 60 * 5,+ STATIC: Infinity,+ FREQUENT: 1000 * 30,+ },+ GC_TIME: {+ DEFAULT: 1000 * 60 * 30,+ LONG: 1000 * 60 * 60,+ },+ RETRY: {+ DEFAULT: 3,+ NONE: 0,+ },+} as const++export const HTTP_STATUS = {+ OK: 200,+ CREATED: 201,+ NO_CONTENT: 204,+ BAD_REQUEST: 400,+ UNAUTHORIZED: 401,+ FORBIDDEN: 403,+ NOT_FOUND: 404,+ CONFLICT: 409,+ TOO_MANY_REQUESTS: 429,+ INTERNAL_SERVER: 500,+} as const++export const PAGINATION = {+ DEFAULT_PAGE: 1,+ DEFAULT_SIZE: 20,+ MAX_SIZE: 100,+} as const++export type ApiEndpoint = typeof API_ENDPOINTS+export type QueryKey = typeof QUERY_KEYS+export type Route = typeof ROUTESdiff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/api/api.config.ts b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/api/api.config.tsnew file mode 100644index 00000000..f48a4d08--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/api/api.config.ts@@ -0,0 +1,17 @@+// ===================+// Β© AngelaMos | 2026+// api.config.ts+// ===================++import axios, { type AxiosInstance } from 'axios'++const getBaseURL = (): string => {+ return import.meta.env.VITE_API_URL ?? '/api'+}++export const apiClient: AxiosInstance = axios.create({+ baseURL: getBaseURL(),+ timeout: 15000,+ headers: { 'Content-Type': 'application/json' },+ withCredentials: true,+})diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/api/errors.ts b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/api/errors.tsnew file mode 100644index 00000000..fde5ec65--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/api/errors.ts@@ -0,0 +1,114 @@+/**+ * Β©AngelaMos | 2025+ * errors.ts+ */++import type { AxiosError } from 'axios'++export const ApiErrorCode = {+ NETWORK_ERROR: 'NETWORK_ERROR',+ VALIDATION_ERROR: 'VALIDATION_ERROR',+ AUTHENTICATION_ERROR: 'AUTHENTICATION_ERROR',+ AUTHORIZATION_ERROR: 'AUTHORIZATION_ERROR',+ NOT_FOUND: 'NOT_FOUND',+ CONFLICT: 'CONFLICT',+ RATE_LIMITED: 'RATE_LIMITED',+ SERVER_ERROR: 'SERVER_ERROR',+ UNKNOWN_ERROR: 'UNKNOWN_ERROR',+} as const++export type ApiErrorCode = (typeof ApiErrorCode)[keyof typeof ApiErrorCode]++export class ApiError extends Error {+ readonly code: ApiErrorCode+ readonly statusCode: number+ readonly details?: Record<string, string[]>++ constructor(+ message: string,+ code: ApiErrorCode,+ statusCode: number,+ details?: Record<string, string[]>+ ) {+ super(message)+ this.name = 'ApiError'+ this.code = code+ this.statusCode = statusCode+ this.details = details+ }++ getUserMessage(): string {+ const messages: Record<ApiErrorCode, string> = {+ [ApiErrorCode.NETWORK_ERROR]:+ 'Unable to connect. Please check your internet connection.',+ [ApiErrorCode.VALIDATION_ERROR]: 'Please check your input and try again.',+ [ApiErrorCode.AUTHENTICATION_ERROR]:+ 'Your session has expired. Please log in again.',+ [ApiErrorCode.AUTHORIZATION_ERROR]:+ 'You do not have permission to perform this action.',+ [ApiErrorCode.NOT_FOUND]: 'The requested resource was not found.',+ [ApiErrorCode.CONFLICT]:+ 'This operation conflicts with an existing resource.',+ [ApiErrorCode.RATE_LIMITED]:+ 'Too many requests. Please wait a moment and try again.',+ [ApiErrorCode.SERVER_ERROR]:+ 'Something went wrong on our end. Please try again later.',+ [ApiErrorCode.UNKNOWN_ERROR]:+ 'An unexpected error occurred. Please try again.',+ }+ return messages[this.code]+ }+}++interface ApiErrorResponse {+ detail?: string | { msg: string; type: string }[]+ message?: string+}++export function transformAxiosError(error: AxiosError<unknown>): ApiError {+ if (!error.response) {+ return new ApiError('Network error', ApiErrorCode.NETWORK_ERROR, 0)+ }++ const { status } = error.response+ const data = error.response.data as ApiErrorResponse | undefined+ let message = 'An error occurred'+ let details: Record<string, string[]> | undefined++ if (data?.detail) {+ if (typeof data.detail === 'string') {+ message = data.detail+ } else if (Array.isArray(data.detail)) {+ details = { validation: [] }+ data.detail.forEach((err) => {+ details?.validation.push(err.msg)+ })+ message = 'Validation error'+ }+ } else if (data?.message) {+ message = data.message+ }++ const codeMap: Record<number, ApiErrorCode> = {+ 400: ApiErrorCode.VALIDATION_ERROR,+ 401: ApiErrorCode.AUTHENTICATION_ERROR,+ 403: ApiErrorCode.AUTHORIZATION_ERROR,+ 404: ApiErrorCode.NOT_FOUND,+ 409: ApiErrorCode.CONFLICT,+ 429: ApiErrorCode.RATE_LIMITED,+ 500: ApiErrorCode.SERVER_ERROR,+ 502: ApiErrorCode.SERVER_ERROR,+ 503: ApiErrorCode.SERVER_ERROR,+ 504: ApiErrorCode.SERVER_ERROR,+ }++ const code = codeMap[status] || ApiErrorCode.UNKNOWN_ERROR++ return new ApiError(message, code, status, details)+}++declare module '@tanstack/react-query' {+ interface Register {+ defaultError: ApiError+ }+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/api/index.ts b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/api/index.tsnew file mode 100644index 00000000..1818cd7e--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/api/index.ts@@ -0,0 +1,8 @@+// ===================+// Β© AngelaMos | 2025+// index.ts+// ===================++export * from './api.config'+export * from './errors'+export * from './query.config'diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/api/query.config.ts b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/api/query.config.tsnew file mode 100644index 00000000..8244b22d--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/api/query.config.ts@@ -0,0 +1,105 @@+// ===================+// Β© AngelaMos | 2025+// query.config.ts+// ===================++import { MutationCache, QueryCache, QueryClient } from '@tanstack/react-query'+import { toast } from 'sonner'+import { QUERY_CONFIG } from '@/config'+import { ApiError, ApiErrorCode } from './errors'++const NO_RETRY_ERROR_CODES: readonly ApiErrorCode[] = [+ ApiErrorCode.AUTHENTICATION_ERROR,+ ApiErrorCode.AUTHORIZATION_ERROR,+ ApiErrorCode.NOT_FOUND,+ ApiErrorCode.VALIDATION_ERROR,+] as const++const shouldRetryQuery = (failureCount: number, error: Error): boolean => {+ if (error instanceof ApiError) {+ if (NO_RETRY_ERROR_CODES.includes(error.code)) {+ return false+ }+ }+ return failureCount < QUERY_CONFIG.RETRY.DEFAULT+}++const calculateRetryDelay = (attemptIndex: number): number => {+ const baseDelay = 1000+ const maxDelay = 30000+ return Math.min(baseDelay * 2 ** attemptIndex, maxDelay)+}++const handleQueryCacheError = (+ error: Error,+ query: { state: { data: unknown } }+): void => {+ if (query.state.data !== undefined) {+ const message =+ error instanceof ApiError+ ? error.getUserMessage()+ : 'Background update failed'+ toast.error(message)+ }+}++const handleMutationCacheError = (+ error: Error,+ _variables: unknown,+ _context: unknown,+ mutation: { options: { onError?: unknown } }+): void => {+ if (mutation.options.onError === undefined) {+ const message =+ error instanceof ApiError ? error.getUserMessage() : 'Operation failed'+ toast.error(message)+ }+}++export const QUERY_STRATEGIES = {+ standard: {+ staleTime: QUERY_CONFIG.STALE_TIME.USER,+ gcTime: QUERY_CONFIG.GC_TIME.DEFAULT,+ },+ frequent: {+ staleTime: QUERY_CONFIG.STALE_TIME.FREQUENT,+ gcTime: QUERY_CONFIG.GC_TIME.DEFAULT,+ refetchInterval: QUERY_CONFIG.STALE_TIME.FREQUENT,+ },+ static: {+ staleTime: QUERY_CONFIG.STALE_TIME.STATIC,+ gcTime: QUERY_CONFIG.GC_TIME.LONG,+ refetchOnMount: false,+ refetchOnWindowFocus: false,+ },+ auth: {+ staleTime: QUERY_CONFIG.STALE_TIME.USER,+ gcTime: QUERY_CONFIG.GC_TIME.DEFAULT,+ retry: QUERY_CONFIG.RETRY.NONE,+ },+} as const++export type QueryStrategy = keyof typeof QUERY_STRATEGIES++export const queryClient = new QueryClient({+ defaultOptions: {+ queries: {+ staleTime: QUERY_CONFIG.STALE_TIME.USER,+ gcTime: QUERY_CONFIG.GC_TIME.DEFAULT,+ retry: shouldRetryQuery,+ retryDelay: calculateRetryDelay,+ refetchOnWindowFocus: true,+ refetchOnMount: true,+ refetchOnReconnect: true,+ },+ mutations: {+ retry: QUERY_CONFIG.RETRY.NONE,+ },+ },+ queryCache: new QueryCache({+ onError: handleQueryCacheError,+ }),+ mutationCache: new MutationCache({+ onError: handleMutationCacheError,+ }),+})diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/app/routers.tsx b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/app/routers.tsxnew file mode 100644index 00000000..d17138ce--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/app/routers.tsx@@ -0,0 +1,34 @@+// ===================+// Β© AngelaMos | 2026+// routers.tsx+// ===================++import { createBrowserRouter, type RouteObject } from 'react-router-dom'+import { ROUTES } from '@/config'+import { Shell } from './shell'++const routes: RouteObject[] = [+ {+ path: ROUTES.HOME,+ lazy: () => import('@/pages/landing'),+ },+ {+ element: <Shell />,+ children: [+ {+ path: ROUTES.DASHBOARD,+ lazy: () => import('@/pages/dashboard'),+ },+ {+ path: ROUTES.SETTINGS,+ lazy: () => import('@/pages/settings'),+ },+ ],+ },+ {+ path: '*',+ lazy: () => import('@/pages/landing'),+ },+]++export const router = createBrowserRouter(routes)diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/app/shell.module.scss b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/app/shell.module.scssnew file mode 100644index 00000000..3466896a--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/app/shell.module.scss@@ -0,0 +1,4 @@+// ===================+// Β© AngelaMos | 2026+// shell.module.scss+// ===================diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/app/shell.tsx b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/app/shell.tsxnew file mode 100644index 00000000..3296f38f--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/app/shell.tsx@@ -0,0 +1,116 @@+/**+ * Β©AngelaMos | 2026+ * shell.tsx+ */++import { Suspense } from 'react'+import { ErrorBoundary } from 'react-error-boundary'+import { GiCardAceClubs, GiCardJoker } from 'react-icons/gi'+import { LuChevronLeft, LuChevronRight, LuMenu } from 'react-icons/lu'+import { NavLink, Outlet, useLocation } from 'react-router-dom'+import { ROUTES } from '@/config'+import { useUIStore } from '@/core/lib'+import styles from './shell.module.scss'++const NAV_ITEMS = [+ { path: ROUTES.DASHBOARD, label: 'Dashboard', icon: GiCardJoker },+ { path: ROUTES.SETTINGS, label: 'Settings', icon: GiCardAceClubs },+]++function ShellErrorFallback({ error }: { error: Error }): React.ReactElement {+ return (+ <div className={styles.error}>+ <h2>Something went wrong</h2>+ <pre>{error.message}</pre>+ </div>+ )+}++function ShellLoading(): React.ReactElement {+ return <div className={styles.loading}>Loading...</div>+}++function getPageTitle(pathname: string): string {+ const item = NAV_ITEMS.find((i) => i.path === pathname)+ return item?.label ?? 'Dashboard'+}++export function Shell(): React.ReactElement {+ const location = useLocation()+ const { sidebarOpen, sidebarCollapsed, toggleSidebar, toggleSidebarCollapsed } =+ useUIStore()++ const pageTitle = getPageTitle(location.pathname)++ return (+ <div className={styles.shell}>+ <aside+ className={`${styles.sidebar} ${sidebarOpen ? styles.open : ''} ${sidebarCollapsed ? styles.collapsed : ''}`}+ >+ <div className={styles.sidebarHeader}>+ <span className={styles.logo}>NavBar Template</span>+ <button+ type="button"+ className={styles.collapseBtn}+ onClick={toggleSidebarCollapsed}+ aria-label={sidebarCollapsed ? 'Expand sidebar' : 'Collapse sidebar'}+ >+ {sidebarCollapsed ? <LuChevronRight /> : <LuChevronLeft />}+ </button>+ </div>++ <nav className={styles.nav}>+ {NAV_ITEMS.map((item) => (+ <NavLink+ key={item.path}+ to={item.path}+ className={({ isActive }) =>+ `${styles.navItem} ${isActive ? styles.active : ''}`+ }+ onClick={() => sidebarOpen && toggleSidebar()}+ >+ <item.icon className={styles.navIcon} />+ <span className={styles.navLabel}>{item.label}</span>+ </NavLink>+ ))}+ </nav>+ </aside>++ {sidebarOpen && (+ <button+ type="button"+ className={styles.overlay}+ onClick={toggleSidebar}+ onKeyDown={(e) => e.key === 'Escape' && toggleSidebar()}+ aria-label="Close sidebar"+ />+ )}++ <div+ className={`${styles.main} ${sidebarCollapsed ? styles.collapsed : ''}`}+ >+ <header className={styles.header}>+ <div className={styles.headerLeft}>+ <button+ type="button"+ className={styles.menuBtn}+ onClick={toggleSidebar}+ aria-label="Toggle menu"+ >+ <LuMenu />+ </button>+ <h1 className={styles.pageTitle}>{pageTitle}</h1>+ </div>+ </header>++ <main className={styles.content}>+ <ErrorBoundary FallbackComponent={ShellErrorFallback}>+ <Suspense fallback={<ShellLoading />}>+ <Outlet />+ </Suspense>+ </ErrorBoundary>+ </main>+ </div>+ </div>+ )+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/app/toast.module.scss b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/app/toast.module.scssnew file mode 100644index 00000000..62a8ee32--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/app/toast.module.scss@@ -0,0 +1,4 @@+// ===================+// Β© AngelaMos | 2026+// toast.module.scss+// ===================diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/lib/index.ts b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/lib/index.tsnew file mode 100644index 00000000..cdee46e2--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/lib/index.ts@@ -0,0 +1,6 @@+// ===================+// Β© AngelaMos | 2026+// index.ts+// ===================++export * from './shell.ui.store'diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/lib/shell.ui.store.ts b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/lib/shell.ui.store.tsnew file mode 100644index 00000000..d601a53b--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/core/lib/shell.ui.store.ts@@ -0,0 +1,63 @@+/**+ * Β©AngelaMos | 2025+ * ui.store.ts+ */++import { create } from 'zustand'+import { devtools, persist } from 'zustand/middleware'++type Theme = 'light' | 'dark' | 'system'++interface UIState {+ theme: Theme+ sidebarOpen: boolean+ sidebarCollapsed: boolean+ setTheme: (theme: Theme) => void+ toggleSidebar: () => void+ setSidebarOpen: (open: boolean) => void+ toggleSidebarCollapsed: () => void+}++export const useUIStore = create<UIState>()(+ devtools(+ persist(+ (set) => ({+ theme: 'dark',+ sidebarOpen: false,+ sidebarCollapsed: false,++ setTheme: (theme) => set({ theme }, false, 'ui/setTheme'),++ toggleSidebar: () =>+ set(+ (state) => ({ sidebarOpen: !state.sidebarOpen }),+ false,+ 'ui/toggleSidebar'+ ),++ setSidebarOpen: (open) =>+ set({ sidebarOpen: open }, false, 'ui/setSidebarOpen'),++ toggleSidebarCollapsed: () =>+ set(+ (state) => ({ sidebarCollapsed: !state.sidebarCollapsed }),+ false,+ 'ui/toggleSidebarCollapsed'+ ),+ }),+ {+ name: 'ui-storage',+ partialize: (state) => ({+ theme: state.theme,+ sidebarCollapsed: state.sidebarCollapsed,+ }),+ }+ ),+ { name: 'UIStore' }+ )+)++export const useTheme = (): Theme => useUIStore((s) => s.theme)+export const useSidebarOpen = (): boolean => useUIStore((s) => s.sidebarOpen)+export const useSidebarCollapsed = (): boolean =>+ useUIStore((s) => s.sidebarCollapsed)diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/main.tsx b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/main.tsxnew file mode 100644index 00000000..1b1f2c8a--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/main.tsx@@ -0,0 +1,15 @@+// ===========================+// Β©AngelaMos | 2025+// main.tsx+// ===========================++import { StrictMode } from 'react'+import { createRoot } from 'react-dom/client'+import App from './App'+import './styles.scss'++createRoot(document.getElementById('root')!).render(+ <StrictMode>+ <App />+ </StrictMode>+)diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/dashboard/dashboard.module.scss b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/dashboard/dashboard.module.scssnew file mode 100644index 00000000..cbf1f90a--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/dashboard/dashboard.module.scss@@ -0,0 +1,4 @@+// ===================+// Β© AngelaMos | 2026+// dashboard.module.scss+// ===================diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/dashboard/index.tsx b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/dashboard/index.tsxnew file mode 100644index 00000000..ca908891--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/dashboard/index.tsx@@ -0,0 +1,62 @@+/**+ * Β©AngelaMos | 2026+ * index.tsx+ */++import styles from './dashboard.module.scss'++const AVAILABLE_STORES = [+ {+ name: 'useUIStore()',+ file: 'core/lib/shell.ui.store.ts',+ description: 'Theme, sidebar open/collapsed state',+ },+]++const SUGGESTED_FEATURES = [+ 'Stats and metrics',+ 'Recent activity feed',+ 'Quick actions',+ 'Charts and analytics',+ 'Notifications overview',+ 'Task/project summary',+]++export function Component(): React.ReactElement {+ return (+ <div className={styles.page}>+ <div className={styles.container}>+ <div className={styles.header}>+ <h1 className={styles.title}>Welcome</h1>+ <p className={styles.subtitle}>+ Template page β build your dashboard here+ </p>+ </div>++ <section className={styles.section}>+ <h2 className={styles.sectionTitle}>Available Stores</h2>+ <div className={styles.grid}>+ {AVAILABLE_STORES.map((store) => (+ <div key={store.name} className={styles.card}>+ <code className={styles.hookName}>{store.name}</code>+ <p className={styles.description}>{store.description}</p>+ <span className={styles.file}>{store.file}</span>+ </div>+ ))}+ </div>+ </section>++ <section className={styles.section}>+ <h2 className={styles.sectionTitle}>Suggested Features</h2>+ <ul className={styles.list}>+ {SUGGESTED_FEATURES.map((feature) => (+ <li key={feature}>{feature}</li>+ ))}+ </ul>+ </section>+ </div>+ </div>+ )+}++Component.displayName = 'Dashboard'diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/landing/index.tsx b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/landing/index.tsxnew file mode 100644index 00000000..7ec81be5--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/landing/index.tsx@@ -0,0 +1,12 @@+// ===================+// Β© AngelaMos | 2026+// index.tsx+// ===================++import styles from './landing.module.scss'++export function Component(): React.ReactElement {+ return <div className={styles.page} />+}++Component.displayName = 'Landing'diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/landing/landing.module.scss b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/landing/landing.module.scssnew file mode 100644index 00000000..164f39a0--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/landing/landing.module.scss@@ -0,0 +1,4 @@+// ===================+// Β© AngelaMos | 2026+// landing.module.scss+// ===================diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/settings/index.tsx b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/settings/index.tsxnew file mode 100644index 00000000..9c8dc9a5--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/settings/index.tsx@@ -0,0 +1,56 @@+/**+ * Β©AngelaMos | 2026+ * index.tsx+ */++import styles from './settings.module.scss'++const AVAILABLE_STORES = [+ {+ name: 'useUIStore()',+ file: 'core/lib/shell.ui.store.ts',+ description: 'Theme, sidebar open/collapsed state',+ },+]++export function Component(): React.ReactElement {+ return (+ <div className={styles.page}>+ <div className={styles.container}>+ <div className={styles.header}>+ <h1 className={styles.title}>Settings</h1>+ <p className={styles.subtitle}>+ Template page β available stores for building your settings UI+ </p>+ </div>++ <section className={styles.section}>+ <h2 className={styles.sectionTitle}>Available Stores</h2>+ <div className={styles.grid}>+ {AVAILABLE_STORES.map((store) => (+ <div key={store.name} className={styles.card}>+ <code className={styles.hookName}>{store.name}</code>+ <p className={styles.description}>{store.description}</p>+ <div className={styles.meta}>+ <span className={styles.file}>{store.file}</span>+ </div>+ </div>+ ))}+ </div>+ </section>++ <section className={styles.section}>+ <h2 className={styles.sectionTitle}>Suggested Features</h2>+ <ul className={styles.list}>+ <li>Profile form</li>+ <li>Theme toggle (dark/light)</li>+ <li>Notification settings</li>+ <li>Application preferences</li>+ </ul>+ </section>+ </div>+ </div>+ )+}++Component.displayName = 'Settings'diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/settings/settings.module.scss b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/settings/settings.module.scssnew file mode 100644index 00000000..e95e0f88--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/pages/settings/settings.module.scss@@ -0,0 +1,4 @@+// ===================+// Β© AngelaMos | 2026+// settings.module.scss+// ===================diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles.scss b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles.scssnew file mode 100644index 00000000..240ec555--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles.scss@@ -0,0 +1,23 @@+// ===================+// Β© AngelaMos | 2026+// styles.scss+// ===================++@forward 'styles/tokens';+@forward 'styles/fonts';+@forward 'styles/mixins';++@use 'styles/reset';++#root {+ min-height: 100vh;+ min-height: 100dvh;+ display: flex;+ flex-direction: column;+}++.app {+ flex: 1;+ display: flex;+ flex-direction: column;+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles/_fonts.scss b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles/_fonts.scssnew file mode 100644index 00000000..4f517884--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles/_fonts.scss@@ -0,0 +1,12 @@+// ===================+// Β© AngelaMos | 2025+// _fonts.scss+// ===================++@use 'tokens' as *;++$font-sans: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Inter', Roboto,+ 'Helvetica Neue', Arial, sans-serif;++$font-mono: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas,+ 'Liberation Mono', monospace;diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles/_index.scss b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles/_index.scssnew file mode 100644index 00000000..ac5a8266--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles/_index.scss@@ -0,0 +1,8 @@+// ===================+// Β© AngelaMos | 2025+// _index.scss+// ===================++@forward 'tokens';+@forward 'fonts';+@forward 'mixins';diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles/_mixins.scss b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles/_mixins.scssnew file mode 100644index 00000000..6b5b1ba9--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles/_mixins.scss@@ -0,0 +1,120 @@+// ===================+// Β© AngelaMos | 2025+// _mixins.scss+// ===================++@use 'sass:map';+@use 'sass:list';+@use 'tokens' as *;++$breakpoints: (+ 'xs': $breakpoint-xs,+ 'sm': $breakpoint-sm,+ 'md': $breakpoint-md,+ 'lg': $breakpoint-lg,+ 'xl': $breakpoint-xl,+ '2xl': $breakpoint-2xl,+);++@mixin breakpoint-up($size) {+ @media (min-width: map.get($breakpoints, $size)) {+ @content;+ }+}++@mixin breakpoint-down($size) {+ @media (width < map.get($breakpoints, $size)) {+ @content;+ }+}++@mixin flex-center {+ display: flex;+ align-items: center;+ justify-content: center;+}++@mixin flex-between {+ display: flex;+ align-items: center;+ justify-content: space-between;+}++@mixin flex-column {+ display: flex;+ flex-direction: column;+}++@mixin flex-column-center {+ display: flex;+ flex-direction: column;+ align-items: center;+ justify-content: center;+}++@mixin sr-only {+ position: absolute;+ width: 1px;+ height: 1px;+ margin: -1px;+ padding: 0;+ overflow: hidden;+ clip: rect(0 0 0 0);+ clip-path: inset(50%);+ white-space: nowrap;+ border: 0;+}++@mixin truncate {+ overflow: hidden;+ text-overflow: ellipsis;+ white-space: nowrap;+}++@mixin line-clamp($lines: 2) {+ display: -webkit-box;+ -webkit-line-clamp: #{$lines};+ -webkit-box-orient: vertical;+ overflow: hidden;+}++@mixin transition-fast {+ transition-property: background-color, border-color, color, opacity;+ transition-duration: $duration-fast;+ transition-timing-function: $ease-out;+}++@mixin transition-normal {+ transition-property: background-color, border-color, color, opacity;+ transition-duration: $duration-normal;+ transition-timing-function: $ease-out;+}++@mixin absolute-fill {+ position: absolute;+ inset: 0;+}++@mixin absolute-center {+ position: absolute;+ top: 50%;+ left: 50%;+ transform: translate(-50%, -50%);+}++@mixin hover {+ @media (hover: hover) and (pointer: fine) {+ &:hover {+ @content;+ }+ }+}++@mixin hide-scrollbar {+ -ms-overflow-style: none;+ scrollbar-width: none;++ &::-webkit-scrollbar {+ display: none;+ }+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles/_reset.scss b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles/_reset.scssnew file mode 100644index 00000000..a9cbdc17--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles/_reset.scss@@ -0,0 +1,105 @@+// ===================+// Β© AngelaMos | 2026+// _reset.scss+// ===================++*,+*::before,+*::after {+ box-sizing: border-box;+}++* {+ margin: 0;+ padding: 0;+ -webkit-tap-highlight-color: transparent;+}++html {+ font-size: 16px;+ -moz-text-size-adjust: none;+ -webkit-text-size-adjust: none;+ text-size-adjust: none;+ overflow-x: hidden;+}++@media (prefers-reduced-motion: no-preference) {+ html {+ interpolate-size: allow-keywords;+ scroll-behavior: smooth;+ }+}++body {+ min-height: 100vh;+ min-height: 100dvh;+ line-height: 1.5;+ text-rendering: optimizeLegibility;+ -webkit-font-smoothing: antialiased;+ -moz-osx-font-smoothing: grayscale;+ overflow-x: hidden;+ background-color: #fff;+ color: #000;+}++h1,+h2,+h3,+h4,+h5,+h6 {+ line-height: 1.2;+ text-wrap: balance;+ overflow-wrap: break-word;+}++p {+ text-wrap: pretty;+ overflow-wrap: break-word;+}++img,+picture,+video,+canvas,+svg {+ display: block;+ max-width: 100%;+ height: auto;+}++input,+button,+textarea,+select {+ font: inherit;+ color: inherit;+}++button {+ background: none;+ border: none;+ cursor: pointer;+ text-align: inherit;+ font-family: inherit;+}++[hidden] {+ display: none !important;+}++[disabled] {+ cursor: not-allowed;+ opacity: 0.5;+}++@media (prefers-reduced-motion: reduce) {+ *,+ *::before,+ *::after {+ animation-duration: 0.01ms !important;+ animation-iteration-count: 1 !important;+ transition-duration: 0.01ms !important;+ scroll-behavior: auto !important;+ }+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles/_tokens.scss b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles/_tokens.scssnew file mode 100644index 00000000..be1f6dd6--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/src/styles/_tokens.scss@@ -0,0 +1,168 @@+// ===================+// Β© AngelaMos | 2025+// _tokens.scss+// ===================++// ============================================================================+// SPACING (8px base system)+// ============================================================================+$space-0: 0;+$space-px: 1px;+$space-0-5: 0.125rem;+$space-1: 0.25rem;+$space-1-5: 0.375rem;+$space-2: 0.5rem;+$space-2-5: 0.625rem;+$space-3: 0.75rem;+$space-3-5: 0.875rem;+$space-4: 1rem;+$space-5: 1.25rem;+$space-6: 1.5rem;+$space-7: 1.75rem;+$space-8: 2rem;+$space-9: 2.25rem;+$space-10: 2.5rem;+$space-11: 2.75rem;+$space-12: 3rem;+$space-14: 3.5rem;+$space-16: 4rem;+$space-20: 5rem;+$space-24: 6rem;+$space-28: 7rem;+$space-32: 8rem;++// ============================================================================+// TYPOGRAPHY SCALE+// ============================================================================+$font-size-3xs: 0.625rem;+$font-size-2xs: 0.6875rem;+$font-size-xs: 0.75rem;+$font-size-sm: 0.875rem;+$font-size-base: 1rem;+$font-size-lg: 1.125rem;+$font-size-xl: 1.25rem;+$font-size-2xl: 1.5rem;+$font-size-3xl: 1.875rem;+$font-size-4xl: 2.25rem;+$font-size-5xl: 3rem;++// ============================================================================+// FONT WEIGHTS+// ============================================================================+$font-weight-regular: 400;+$font-weight-medium: 500;+$font-weight-semibold: 600;++// ============================================================================+// LINE HEIGHTS+// ============================================================================+$line-height-none: 1;+$line-height-tight: 1.2;+$line-height-snug: 1.375;+$line-height-normal: 1.5;+$line-height-relaxed: 1.625;++// ============================================================================+// LETTER SPACING+// ============================================================================+$tracking-tighter: -0.05em;+$tracking-tight: -0.025em;+$tracking-normal: 0;+$tracking-wide: 0.025em;+$tracking-wider: 0.05em;++// ============================================================================+// COLORS+// ============================================================================+$white: hsl(0, 0%, 100%);+$black: hsl(0, 0%, 0%);++// Auth+$bg-page: hsl(0, 0%, 10.5%);+$bg-card: hsl(0, 0%, 6.2%);++// Home/landing+$bg-landing: hsl(0, 0%, 10.8%);++$bg-default: hsl(0, 0%, 7.1%);+$bg-alternative: hsl(0, 0%, 5.9%);+$bg-surface-75: hsl(0, 0%, 9%);+$bg-surface-100: hsl(0, 0%, 12.2%);+$bg-surface-200: hsl(0, 0%, 14.1%);+$bg-surface-300: hsl(0, 0%, 16.1%);+$bg-control: hsl(0, 0%, 10%);+$bg-selection: hsl(0, 0%, 19.2%);+$bg-overlay: hsl(0, 0%, 14.1%);+$bg-overlay-hover: hsl(0, 0%, 18%);++$border-muted: hsl(0, 0%, 11.1%);+$border-default: hsl(0, 0%, 18%);+$border-strong: hsl(0, 0%, 22.4%);+$border-stronger: hsl(0, 0%, 27.1%);+$border-control: hsl(0, 0%, 22.4%);++$text-default: hsl(0, 0%, 98%);+$text-light: hsl(0, 0%, 70.6%);+$text-lighter: hsl(0, 0%, 53.7%);+$text-muted: hsl(0, 0%, 30.2%);++$error-default: hsl(0, 72%, 51%);+$error-light: hsl(0, 72%, 65%);++// ============================================================================+// BORDER RADIUS+// ============================================================================+$radius-none: 0;+$radius-xs: 2px;+$radius-sm: 4px;+$radius-md: 6px;+$radius-lg: 8px;+$radius-xl: 12px;+$radius-full: 9999px;++// ============================================================================+// Z-INDEX SCALE+// ============================================================================+$z-hide: -1;+$z-base: 0;+$z-dropdown: 100;+$z-sticky: 200;+$z-fixed: 300;+$z-overlay: 400;+$z-modal: 500;+$z-popover: 600;+$z-tooltip: 700;+$z-toast: 800;+$z-max: 9999;++// ============================================================================+// TRANSITIONS+// ============================================================================+$duration-instant: 0ms;+$duration-fast: 100ms;+$duration-normal: 150ms;+$duration-slow: 200ms;++$ease-out: cubic-bezier(0, 0, 0.2, 1);+$ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);++// ============================================================================+// BREAKPOINTS+// ============================================================================+$breakpoint-xs: 360px;+$breakpoint-sm: 480px;+$breakpoint-md: 768px;+$breakpoint-lg: 1024px;+$breakpoint-xl: 1280px;+$breakpoint-2xl: 1536px;++// ============================================================================+// CONTAINER WIDTHS+// ============================================================================+$container-xs: 20rem;+$container-sm: 24rem;+$container-md: 28rem;+$container-lg: 32rem;+$container-xl: 36rem;+$container-2xl: 42rem;+$container-full: 100%;diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/stylelint.config.js b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/stylelint.config.jsnew file mode 100644index 00000000..56ebd7bc--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/stylelint.config.js@@ -0,0 +1,107 @@+// Β©AngelaMos | 2025+// stylelint.config.js++/** @type {import('stylelint').Config} */+export default {+ extends: ['stylelint-config-standard-scss', 'stylelint-config-prettier-scss'],+ rules: {+ 'block-no-empty': true,+ 'declaration-no-important': true,+ 'color-no-invalid-hex': true,+ 'property-no-unknown': true,+ 'selector-pseudo-class-no-unknown': [+ true,+ {+ ignorePseudoClasses: ['global'],+ },+ ],++ 'selector-class-pattern': [+ '^[a-z]([a-z0-9-]+)?(__[a-z0-9]([a-z0-9-]+)?)?(--[a-z0-9]([a-z0-9-]+)?)?$|^[a-z][a-zA-Z0-9]*$',+ {+ message:+ 'Selector should be in BEM format (e.g., .block__element--modifier) or CSS Modules camelCase (e.g., .testButton)',+ },+ ],++ 'value-keyword-case': [+ 'lower',+ {+ camelCaseSvgKeywords: true,+ ignoreKeywords: [+ 'BlinkMacSystemFont',+ 'SFMono-Regular',+ 'Menlo',+ 'Monaco',+ 'Consolas',+ 'Roboto',+ 'Arial',+ 'Helvetica',+ 'Times',+ 'Georgia',+ 'Verdana',+ 'Tahoma',+ 'Trebuchet',+ 'Impact',+ 'Comic',+ ],+ },+ ],++ 'property-no-vendor-prefix': [+ true,+ {+ ignoreProperties: ['text-size-adjust', 'appearance', 'backdrop-filter'],+ },+ ],+ 'value-no-vendor-prefix': true,+ 'selector-no-vendor-prefix': true,++ 'property-no-deprecated': [+ true,+ {+ ignoreProperties: ['clip'],+ },+ ],++ 'container-name-pattern': null,+ 'layer-name-pattern': null,++ 'scss/at-rule-no-unknown': true,+ 'scss/declaration-nested-properties-no-divided-groups': true,+ 'scss/dollar-variable-no-missing-interpolation': true,+ 'scss/dollar-variable-empty-line-before': null,++ 'declaration-empty-line-before': null,+ 'custom-property-empty-line-before': null,++ 'no-descending-specificity': null,++ 'media-feature-name-no-unknown': [+ true,+ {+ ignoreMediaFeatureNames: ['map'],+ },+ ],++ 'color-function-notation': null,+ 'hue-degree-notation': null,+ },+ ignoreFiles: [+ 'node_modules/**',+ 'dist/**',+ 'build/**',+ '**/*.js',+ '**/*.ts',+ '**/*.tsx',+ ],+ overrides: [+ {+ files: ['**/styles/_reset.scss', '**/styles/_fonts.scss'],+ rules: {+ 'declaration-no-important': null,+ 'scss/comment-no-empty': null,+ },+ },+ ],+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/tsconfig.app.json b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/tsconfig.app.jsonnew file mode 100644index 00000000..afe17f60--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/tsconfig.app.json@@ -0,0 +1,31 @@+{+ "compilerOptions": {+ "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",+ "target": "ES2022",+ "useDefineForClassFields": true,+ "lib": ["ES2022", "DOM", "DOM.Iterable"],+ "module": "ESNext",+ "types": ["vite/client"],+ "skipLibCheck": true,++ "moduleResolution": "bundler",+ "allowImportingTsExtensions": true,+ "verbatimModuleSyntax": true,+ "moduleDetection": "force",+ "noEmit": true,+ "jsx": "react-jsx",++ "strict": true,+ "noUnusedLocals": true,+ "noUnusedParameters": true,+ "erasableSyntaxOnly": true,+ "noFallthroughCasesInSwitch": true,+ "noUncheckedSideEffectImports": true,++ "baseUrl": ".",+ "paths": {+ "@/*": ["./src/*"]+ }+ },+ "include": ["src"]+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/tsconfig.json b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/tsconfig.jsonnew file mode 100644index 00000000..1ffef600--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/tsconfig.json@@ -0,0 +1,7 @@+{+ "files": [],+ "references": [+ { "path": "./tsconfig.app.json" },+ { "path": "./tsconfig.node.json" }+ ]+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/tsconfig.node.json b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/tsconfig.node.jsonnew file mode 100644index 00000000..a96b3e59--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/tsconfig.node.json@@ -0,0 +1,24 @@+{+ "compilerOptions": {+ "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",+ "target": "ES2023",+ "lib": ["ES2023"],+ "module": "ESNext",+ "types": ["node"],+ "skipLibCheck": true,++ "moduleResolution": "bundler",+ "allowImportingTsExtensions": true,+ "verbatimModuleSyntax": true,+ "moduleDetection": "force",+ "noEmit": true,++ "strict": true,+ "noUnusedLocals": true,+ "noUnusedParameters": true,+ "erasableSyntaxOnly": true,+ "noFallthroughCasesInSwitch": true,+ "noUncheckedSideEffectImports": true+ },+ "include": ["vite.config.ts"]+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/vite.config.ts b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/vite.config.tsnew file mode 100644index 00000000..a8d5d478--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/frontend/vite.config.ts@@ -0,0 +1,71 @@+/**+ * Β©AngelaMos | 2025+ * vite.config.ts+ */++import path from 'node:path'+import react from '@vitejs/plugin-react'+import { defineConfig, loadEnv } from 'vite'+import tsconfigPaths from 'vite-tsconfig-paths'++export default defineConfig(({ mode }) => {+ const env = loadEnv(mode, path.resolve(__dirname, '..'), '')+ const isDev = mode === 'development'++ return {+ plugins: [react(), tsconfigPaths()],++ resolve: {+ alias: {+ '@': path.resolve(__dirname, './src'),+ },+ },++ css: {+ preprocessorOptions: {+ scss: {},+ },+ },++ server: {+ port: 5173,+ host: '0.0.0.0',+ proxy: {+ '/api': {+ target: env.VITE_API_TARGET || 'http://localhost:8000',+ changeOrigin: true,+ rewrite: (p) => p.replace(/^\/api/, ''),+ },+ },+ },++ build: {+ target: 'esnext',+ cssTarget: 'chrome100',+ sourcemap: isDev ? true : 'hidden',+ minify: 'oxc',+ rollupOptions: {+ output: {+ manualChunks(id: string): string | undefined {+ if (id.includes('node_modules')) {+ if (id.includes('react-dom') || id.includes('react-router')) {+ return 'vendor-react'+ }+ if (id.includes('@tanstack/react-query')) {+ return 'vendor-query'+ }+ if (id.includes('zustand')) {+ return 'vendor-state'+ }+ }+ return undefined+ },+ },+ },+ },++ preview: {+ port: 4173,+ },+ }+})diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/docker/tlsfp.dev b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/docker/tlsfp.devnew file mode 100644index 00000000..8fe684cc--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/docker/tlsfp.dev@@ -0,0 +1,23 @@+# =============================================================================+# Β©AngelaMos | 2026+# tlsfp.dev+# =============================================================================+# Development Dockerfile: toolchain plus cargo-watch, source mounted at runtime.+# The compose service mounts the workspace at /workspace and a cached target+# volume, so this image only provides the build environment, not the code.+# =============================================================================+# syntax=docker/dockerfile:1++FROM rust:1-bookworm++RUN apt-get update \+ && apt-get install -y --no-install-recommends libpcap-dev \+ && rm -rf /var/lib/apt/lists/*++RUN cargo install cargo-watch++WORKDIR /workspace++EXPOSE 8080++CMD ["cargo", "watch", "-x", "run --bin tlsfp -- serve 0.0.0.0:8080"]diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/docker/tlsfp.prod b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/docker/tlsfp.prodnew file mode 100644index 00000000..7fc630a3--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/docker/tlsfp.prod@@ -0,0 +1,51 @@+# =============================================================================+# Β©AngelaMos | 2026+# tlsfp.prod+# =============================================================================+# Production Dockerfile: builds the tlsfp binary, ships a slim runtime.+# The pcap crate links libpcap, so the builder needs libpcap-dev and the+# runtime needs libpcap0.8. rusqlite is bundled, so no system SQLite.+# =============================================================================+# syntax=docker/dockerfile:1++# ============================================================================+# BUILD STAGE+# ============================================================================+FROM rust:1-bookworm AS builder++RUN apt-get update \+ && apt-get install -y --no-install-recommends libpcap-dev \+ && rm -rf /var/lib/apt/lists/*++WORKDIR /build++COPY Cargo.toml Cargo.lock ./+COPY crates ./crates++RUN --mount=type=cache,target=/usr/local/cargo/registry \+ --mount=type=cache,target=/build/target \+ cargo build --release --bin tlsfp \+ && cp target/release/tlsfp /usr/local/bin/tlsfp \+ && strip /usr/local/bin/tlsfp++# ============================================================================+# RUNTIME STAGE+# ============================================================================+FROM debian:bookworm-slim AS runtime++RUN apt-get update \+ && apt-get install -y --no-install-recommends libpcap0.8 ca-certificates \+ && rm -rf /var/lib/apt/lists/* \+ && useradd --system --uid 10001 --no-create-home tlsfp \+ && mkdir -p /data \+ && chown tlsfp:tlsfp /data++COPY --from=builder /usr/local/bin/tlsfp /usr/local/bin/tlsfp++USER tlsfp+WORKDIR /data++EXPOSE 8080++ENTRYPOINT ["tlsfp"]+CMD ["serve", "0.0.0.0:8080"]diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/docker/vite.dev b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/docker/vite.devnew file mode 100644index 00000000..2c0ce699--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/docker/vite.dev@@ -0,0 +1,25 @@+# =============================================================================+# Β©AngelaMos | 2026+# vite.dev+# =============================================================================+# Development Dockerfile for Vite/React frontend+# Features: pnpm, HMR support, polling for Docker file watching+# =============================================================================+# syntax=docker/dockerfile:1++FROM node:22-slim++RUN corepack enable && corepack prepare [email protected] --activate++WORKDIR /app++COPY package.json pnpm-lock.yaml* .npmrc* ./++RUN --mount=type=cache,target=/root/.local/share/pnpm/store \+ pnpm install --frozen-lockfile++COPY . .++EXPOSE 5173++CMD ["pnpm", "dev", "--host", "0.0.0.0"]diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/docker/vite.prod b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/docker/vite.prodnew file mode 100644index 00000000..69d025f4--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/docker/vite.prod@@ -0,0 +1,59 @@+# =============================================================================+# Β©AngelaMos | 2026+# vite.prod+# =============================================================================+# Production Dockerfile: builds Vite app, serves via Nginx+# =============================================================================+# syntax=docker/dockerfile:1++# ============================================================================+# BUILD STAGE+# ============================================================================+FROM node:22-slim AS builder++RUN corepack enable && corepack prepare [email protected] --activate++WORKDIR /app++COPY frontend/package.json frontend/pnpm-lock.yaml* frontend/.npmrc* ./++RUN --mount=type=cache,target=/root/.local/share/pnpm/store \+ pnpm install --frozen-lockfile++COPY frontend/ .++ARG VITE_API_URL=/api+ARG VITE_APP_TITLE="JA3/JA4 TLS Fingerprinting"++ENV VITE_API_URL=${VITE_API_URL} \+ VITE_APP_TITLE=${VITE_APP_TITLE}++RUN pnpm build++# ============================================================================+# PRODUCTION STAGE+# ============================================================================+FROM nginx:1.27-alpine AS production++RUN rm -rf /usr/share/nginx/html/* && \+ rm /etc/nginx/conf.d/default.conf++COPY --from=builder /app/dist /usr/share/nginx/html++COPY --chown=nginx:nginx infra/nginx/nginx.prod.conf /etc/nginx/nginx.conf+COPY --chown=nginx:nginx infra/nginx/prod.nginx /etc/nginx/conf.d/default.conf++RUN chown -R nginx:nginx /usr/share/nginx/html && \+ chown -R nginx:nginx /var/cache/nginx && \+ chown -R nginx:nginx /var/log/nginx && \+ touch /var/run/nginx.pid && \+ chown -R nginx:nginx /var/run/nginx.pid++USER nginx++EXPOSE 80++HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \+ CMD wget --no-verbose --tries=1 --spider http://localhost:80/health || exit 1++CMD ["nginx", "-g", "daemon off;"]diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/nginx/dev.nginx b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/nginx/dev.nginxnew file mode 100644index 00000000..fff68d6b--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/nginx/dev.nginx@@ -0,0 +1,49 @@+# =============================================================================+# Β©AngelaMos | 2026+# dev.nginx+# =============================================================================+# Development server block: proxies to Vite dev server with HMR.+# /api is resolved at request time so nginx still boots when the backend+# (the `backend` compose profile) is not running, returning 502 until it is.++server {+ listen 80;+ listen [::]:80;+ server_name _;++ access_log /var/log/nginx/access.log main_timed;+ error_log /var/log/nginx/error.log debug;++ add_header Cache-Control "no-store, no-cache, must-revalidate" always;++ location /health {+ access_log off;+ return 200 "healthy\n";+ add_header Content-Type text/plain;+ }++ location /api/ {+ resolver 127.0.0.11 ipv6=off valid=10s;+ set $tlsfp_upstream tlsfp;+ proxy_pass http://$tlsfp_upstream:8080;+ proxy_http_version 1.1;+ proxy_set_header Host $host;+ proxy_set_header X-Real-IP $remote_addr;+ proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;+ proxy_set_header X-Forwarded-Proto $scheme;+ proxy_read_timeout 30s;+ }++ location / {+ proxy_pass http://frontend_dev;+ proxy_http_version 1.1;+ proxy_set_header Upgrade $http_upgrade;+ proxy_set_header Connection $connection_upgrade;+ proxy_set_header Host $host;+ proxy_set_header X-Real-IP $remote_addr;+ proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;++ proxy_read_timeout 60s;+ proxy_buffering off;+ }+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/nginx/nginx.conf b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/nginx/nginx.confnew file mode 100644index 00000000..eddade54--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/nginx/nginx.conf@@ -0,0 +1,76 @@+# AngelaMos | 2026+# nginx.conf+# Development nginx configuration++user nginx;+worker_processes auto;+worker_rlimit_nofile 65535;++error_log /var/log/nginx/error.log warn;+pid /var/run/nginx.pid;++events {+ worker_connections 4096;+ multi_accept on;+ use epoll;+}++http {+ include /etc/nginx/mime.types;+ default_type application/octet-stream;++ map $http_upgrade $connection_upgrade {+ default upgrade;+ '' close;+ }++ upstream frontend_dev {+ server frontend:5173;+ keepalive 8;+ }++ limit_req_zone $binary_remote_addr zone=api_limit:10m rate=10r/s;+ limit_conn_zone $binary_remote_addr zone=conn_limit:10m;+ limit_req_status 429;++ log_format main_timed '$remote_addr - $remote_user [$time_local] '+ '"$request" $status $body_bytes_sent '+ '"$http_referer" "$http_user_agent" '+ 'rt=$request_time uct="$upstream_connect_time" '+ 'uht="$upstream_header_time" urt="$upstream_response_time"';++ sendfile on;+ tcp_nopush on;+ tcp_nodelay on;+ keepalive_timeout 65;+ types_hash_max_size 2048;+ server_tokens off;++ client_body_buffer_size 128k;+ client_header_buffer_size 16k;+ client_max_body_size 10m;+ large_client_header_buffers 4 16k;++ client_body_timeout 12s;+ client_header_timeout 12s;+ send_timeout 10s;++ gzip on;+ gzip_vary on;+ gzip_proxied any;+ gzip_comp_level 6;+ gzip_min_length 256;+ gzip_types+ text/plain+ text/css+ text/xml+ text/javascript+ application/json+ application/javascript+ application/xml+rss+ application/atom+xml+ image/svg+xml;+ gzip_disable "msie6";++ include /etc/nginx/conf.d/*.conf;+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/nginx/nginx.prod.conf b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/nginx/nginx.prod.confnew file mode 100644index 00000000..f73ad69b--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/nginx/nginx.prod.conf@@ -0,0 +1,65 @@+# AngelaMos | 2026+# nginx.prod.conf+# Production nginx configuration++worker_processes auto;+worker_rlimit_nofile 65535;++error_log /var/log/nginx/error.log warn;+pid /var/run/nginx.pid;++events {+ worker_connections 4096;+ multi_accept on;+ use epoll;+}++http {+ include /etc/nginx/mime.types;+ default_type application/octet-stream;++ limit_req_zone $binary_remote_addr zone=api_limit:10m rate=10r/s;+ limit_conn_zone $binary_remote_addr zone=conn_limit:10m;+ limit_req_status 429;++ log_format main_timed '$remote_addr - $remote_user [$time_local] '+ '"$request" $status $body_bytes_sent '+ '"$http_referer" "$http_user_agent" '+ 'rt=$request_time uct="$upstream_connect_time" '+ 'uht="$upstream_header_time" urt="$upstream_response_time"';++ sendfile on;+ tcp_nopush on;+ tcp_nodelay on;+ keepalive_timeout 65;+ types_hash_max_size 2048;+ server_tokens off;++ client_body_buffer_size 128k;+ client_header_buffer_size 16k;+ client_max_body_size 10m;+ large_client_header_buffers 4 16k;++ client_body_timeout 12s;+ client_header_timeout 12s;+ send_timeout 10s;++ gzip on;+ gzip_vary on;+ gzip_proxied any;+ gzip_comp_level 6;+ gzip_min_length 256;+ gzip_types+ text/plain+ text/css+ text/xml+ text/javascript+ application/json+ application/javascript+ application/xml+rss+ application/atom+xml+ image/svg+xml;+ gzip_disable "msie6";++ include /etc/nginx/conf.d/*.conf;+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/nginx/prod.nginx b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/nginx/prod.nginxnew file mode 100644index 00000000..9469a1e4--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/infra/nginx/prod.nginx@@ -0,0 +1,70 @@+# =============================================================================+# Β©AngelaMos | 2026+# prod.nginx+# =============================================================================+# Production server block: serves built static files and proxies /api.+# Note: SSL handled by Cloudflare, not here.+# /api is resolved at request time so nginx still boots when the backend+# (the `backend` compose profile) is not running, returning 502 until it is.++server {+ listen 80;+ listen [::]:80;+ server_name _;++ root /usr/share/nginx/html;+ index index.html;++ access_log /var/log/nginx/access.log main_timed buffer=32k flush=5s;+ error_log /var/log/nginx/error.log warn;++ add_header X-Frame-Options "SAMEORIGIN" always;+ add_header X-Content-Type-Options "nosniff" always;+ add_header X-XSS-Protection "1; mode=block" always;+ add_header Referrer-Policy "strict-origin-when-cross-origin" always;+ add_header Permissions-Policy "geolocation=(), microphone=(), camera=()" always;++ location /health {+ access_log off;+ return 200 "healthy\n";+ add_header Content-Type text/plain;+ }++ location /api/ {+ resolver 127.0.0.11 ipv6=off valid=10s;+ set $tlsfp_upstream tlsfp;+ proxy_pass http://$tlsfp_upstream:8080;+ proxy_http_version 1.1;+ proxy_set_header Host $host;+ proxy_set_header X-Real-IP $remote_addr;+ proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;+ proxy_set_header X-Forwarded-Proto $scheme;+ proxy_set_header CF-Connecting-IP $http_cf_connecting_ip;+ proxy_read_timeout 30s;+ limit_req zone=api_limit burst=20 nodelay;+ }++ location /assets/ {+ expires 1y;+ add_header Cache-Control "public, immutable";+ access_log off;+ try_files $uri =404;+ }++ location ~* \.(jpg|jpeg|png|gif|ico|svg|webp|avif|woff|woff2|ttf|eot|otf)$ {+ expires 1y;+ add_header Cache-Control "public, immutable";+ access_log off;+ }++ location / {+ add_header Cache-Control "no-cache, must-revalidate";+ try_files $uri $uri/ /index.html;+ }++ location ~ /\. {+ deny all;+ access_log off;+ log_not_found off;+ }+}diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/install.sh b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/install.shnew file mode 100755index 00000000..a6e80c7b--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/install.sh@@ -0,0 +1,95 @@+#!/usr/bin/env bash+# Β©AngelaMos | 2026+# install.sh++set -euo pipefail++GREEN='\033[0;32m'+YELLOW='\033[0;33m'+RED='\033[0;31m'+CYAN='\033[0;36m'+NC='\033[0m'++info() { printf "${CYAN}==>${NC} %s\n" "$1"; }+ok() { printf "${GREEN}OK${NC} %s\n" "$1"; }+warn() { printf "${YELLOW}WARN${NC} %s\n" "$1"; }+fail() { printf "${RED}ERROR${NC} %s\n" "$1" >&2; exit 1; }++JA4DB_URL="${JA4DB_URL:-https://ja4db.com/api/read/}"+JA4DB_TIMEOUT="${JA4DB_TIMEOUT:-180}"++SETCAP=0+for arg in "$@"; do+ case "$arg" in+ --live) SETCAP=1 ;;+ -h|--help)+ cat <<'EOF'+Usage: ./install.sh [--live]++Builds the release binary, seeds the bundled intelligence feeds, and pulls the+ja4db.com enrichment feed. Pass --live to also grant the capabilities live+capture needs (this step uses sudo).+EOF+ exit 0+ ;;+ *) fail "unknown argument: $arg (try --help)" ;;+ esac+done++cd "$(dirname "$0")"++command -v cargo >/dev/null 2>&1 || fail "cargo not found; install Rust from https://rustup.rs"++info "Building the release binary"+cargo build --release+BIN="$PWD/target/release/tlsfp"+[ -x "$BIN" ] || fail "build succeeded but $BIN is missing"+ok "built $BIN"++info "Seeding the bundled feeds (abuse.ch SSLBL, salesforce/ja3, curated C2)"+"$BIN" intel seed+ok "bundled feeds loaded"++info "Fetching the ja4db.com enrichment feed"+if ! command -v curl >/dev/null 2>&1; then+ warn "curl not found; skipping ja4db. The bundled feeds still work."+else+ TMP="$(mktemp)"+ trap 'rm -f "$TMP"' EXIT+ if curl -fsSL --max-time "$JA4DB_TIMEOUT" "$JA4DB_URL" -o "$TMP"; then+ "$BIN" intel import "$TMP"+ ok "ja4db imported"+ else+ warn "could not reach $JA4DB_URL (it is large and often slow)."+ warn "the bundled feeds still work; retry later with:"+ printf " %s intel import <(curl -fsSL %s)\n" "$BIN" "$JA4DB_URL"+ fi+fi++if [ "$SETCAP" -eq 1 ]; then+ info "Granting live capture capabilities (needs sudo)"+ if command -v setcap >/dev/null 2>&1; then+ if sudo setcap cap_net_raw,cap_net_admin=eip "$BIN"; then+ ok "live capture enabled for $BIN"+ else+ warn "setcap failed; run live capture under sudo, or grant it later with:"+ printf " sudo setcap cap_net_raw,cap_net_admin=eip %s\n" "$BIN"+ fi+ else+ warn "setcap not found (install libcap2-bin); run live capture under sudo instead"+ fi+fi++printf "\n"+ok "Done. The binary is at $BIN"+cat <<EOF++Next steps:+ $BIN intel stats show what the database holds+ $BIN intel lookup ja3 <hash> look one fingerprint up+ $BIN pcap --intel <file.pcap> fingerprint a capture and flag known intel+ $BIN live --intel <iface> the same, live (needs --live above or sudo)++To put tlsfp on your PATH:+ cargo install --path crates/tlsfp+EOFdiff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/justfile b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/justfilenew file mode 100644index 00000000..53103bce--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/justfile@@ -0,0 +1,199 @@+# =============================================================================+# Β©AngelaMos | 2026+# justfile+# =============================================================================++set dotenv-filename := ".env.development"+set dotenv-load+set export+set shell := ["bash", "-uc"]+set windows-shell := ["powershell.exe", "-NoLogo", "-Command"]++project := file_name(justfile_directory())+version := `git describe --tags --always 2>/dev/null || echo "dev"`++# =============================================================================+# Default+# =============================================================================++default:+ @just --list --unsorted++# =============================================================================+# Frontend Linting+# =============================================================================++[group('lint')]+biome *ARGS:+ cd frontend && pnpm biome check . {{ARGS}}++[group('lint')]+biome-fix:+ cd frontend && pnpm biome check --write .++[group('lint')]+stylelint *ARGS:+ cd frontend && pnpm stylelint '**/*.scss' {{ARGS}}++[group('lint')]+stylelint-fix:+ cd frontend && pnpm stylelint '**/*.scss' --fix++[group('lint')]+tsc *ARGS:+ cd frontend && pnpm tsc --noEmit {{ARGS}}++# =============================================================================+# Backend (Rust)+# =============================================================================++[group('backend')]+build-backend:+ cargo build --release --bin tlsfp++[group('backend')]+run-backend *ARGS:+ cargo run --bin tlsfp -- {{ARGS}}++[group('backend')]+test-backend:+ cargo test --workspace++[group('backend')]+clippy:+ cargo clippy --workspace --all-targets -- -D warnings++[group('backend')]+fmt:+ cargo fmt --all++[group('backend')]+fmt-check:+ cargo fmt --all -- --check++# =============================================================================+# Docker Compose (Production)+# =============================================================================++[group('prod')]+up *ARGS:+ docker compose --env-file .env up {{ARGS}}++[group('prod')]+start *ARGS:+ docker compose --env-file .env up -d {{ARGS}}++[group('prod')]+down *ARGS:+ docker compose --env-file .env down {{ARGS}}++[group('prod')]+stop:+ docker compose --env-file .env stop++[group('prod')]+build *ARGS:+ docker compose --env-file .env build {{ARGS}}++[group('prod')]+rebuild:+ docker compose --env-file .env build --no-cache++[group('prod')]+logs *SERVICE:+ docker compose --env-file .env logs -f {{SERVICE}}++[group('prod')]+ps:+ docker compose --env-file .env ps++# =============================================================================+# Docker Compose (Production + Cloudflare Tunnel)+# =============================================================================++[group('tunnel')]+tunnel-up *ARGS:+ docker compose --env-file .env -f compose.yml -f cloudflared.compose.yml up {{ARGS}}++[group('tunnel')]+tunnel-start *ARGS:+ docker compose --env-file .env -f compose.yml -f cloudflared.compose.yml up -d {{ARGS}}++[group('tunnel')]+tunnel-down *ARGS:+ docker compose --env-file .env -f compose.yml -f cloudflared.compose.yml down {{ARGS}}++[group('tunnel')]+tunnel-logs:+ docker compose --env-file .env -f compose.yml -f cloudflared.compose.yml logs -f cloudflared++# =============================================================================+# Docker Compose (Development)+# =============================================================================++[group('dev')]+dev-up *ARGS:+ docker compose -f dev.compose.yml up {{ARGS}}++[group('dev')]+dev-start *ARGS:+ docker compose -f dev.compose.yml up -d {{ARGS}}++[group('dev')]+dev-down *ARGS:+ docker compose -f dev.compose.yml down {{ARGS}}++[group('dev')]+dev-stop:+ docker compose -f dev.compose.yml stop++[group('dev')]+dev-build *ARGS:+ docker compose -f dev.compose.yml build {{ARGS}}++[group('dev')]+dev-rebuild:+ docker compose -f dev.compose.yml build --no-cache++[group('dev')]+dev-logs *SERVICE:+ docker compose -f dev.compose.yml logs -f {{SERVICE}}++[group('dev')]+dev-ps:+ docker compose -f dev.compose.yml ps++# =============================================================================+# Docker Compose (with backend profile)+# =============================================================================++[group('backend')]+dev-up-backend *ARGS:+ docker compose -f dev.compose.yml --profile backend up {{ARGS}}++[group('backend')]+up-backend *ARGS:+ docker compose --env-file .env --profile backend up {{ARGS}}++# =============================================================================+# Utilities+# =============================================================================++[group('util')]+init:+ bash scripts/init.sh++[group('util')]+ports:+ bash scripts/randomize-ports.sh++[group('util')]+info:+ @echo "Project: {{project}}"+ @echo "Version: {{version}}"+ @echo "OS: {{os()}} ({{arch()}})"++[group('util')]+clean:+ -rm -rf frontend/.biome_cache+ @echo "Cache directories cleaned"diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/scripts/init.sh b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/scripts/init.shnew file mode 100755index 00000000..d258d33e--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/scripts/init.sh@@ -0,0 +1,87 @@+#!/usr/bin/env bash+# =============================================================================+# AngelaMos | 2026+# init.sh+# =============================================================================+# Run once after copying the template.+# Prompts for a project name, randomizes ports, updates all the right files.++set -euo pipefail++DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"++# ββ prompt ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ+echo ""+read -rp "Project name (kebab-case): " RAW++SLUG="$(echo "$RAW" | tr '[:upper:]' '[:lower:]' | tr ' ' '-' | tr -cd '[:alnum:]-')"+[[ -z "$SLUG" ]] && { echo "Error: empty name" >&2; exit 1; }++TITLE="$(echo "$SLUG" | tr '-' ' ' | python3 -c "import sys; print(sys.stdin.read().strip().title())")"++# ββ ports βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ+mapfile -t ports < <(python3 -c "+import random+for p in random.sample(range(10000, 65001), 4): print(p)+")++PROD_NGINX=${ports[0]}+PROD_FRONTEND=${ports[1]}+DEV_NGINX=${ports[2]}+DEV_FRONTEND=${ports[3]}++echo ""+echo " slug: $SLUG"+echo " title: $TITLE"+echo " prod nginx: $PROD_NGINX"+echo " prod frontend: $PROD_FRONTEND"+echo " dev nginx: $DEV_NGINX"+echo " dev frontend: $DEV_FRONTEND"+echo ""++# ββ .env (prod) βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ+sed -i "s|^APP_NAME=.*|APP_NAME=$SLUG|" "$DIR/.env"+sed -i "s|^VITE_APP_TITLE=.*|VITE_APP_TITLE=$TITLE|" "$DIR/.env"+sed -i "s|^NGINX_HOST_PORT=.*|NGINX_HOST_PORT=$PROD_NGINX|" "$DIR/.env"+sed -i "s|^FRONTEND_HOST_PORT=.*|FRONTEND_HOST_PORT=$PROD_FRONTEND|" "$DIR/.env"+echo " updated .env"++# ββ .env.development ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ+sed -i "s|^APP_NAME=.*|APP_NAME=$SLUG-dev|" "$DIR/.env.development"+sed -i "s|^VITE_APP_TITLE=.*|VITE_APP_TITLE=\"$TITLE (Dev)\"|" "$DIR/.env.development"+sed -i "s|^NGINX_HOST_PORT=.*|NGINX_HOST_PORT=$DEV_NGINX|" "$DIR/.env.development"+sed -i "s|^FRONTEND_HOST_PORT=.*|FRONTEND_HOST_PORT=$DEV_FRONTEND|" "$DIR/.env.development"+echo " updated .env.development"++# ββ .env.example ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ+sed -i "s|^APP_NAME=.*|APP_NAME=$SLUG|" "$DIR/.env.example"+sed -i "s|^VITE_APP_TITLE=.*|VITE_APP_TITLE=$TITLE|" "$DIR/.env.example"+sed -i "s|^NGINX_HOST_PORT=.*|NGINX_HOST_PORT=$PROD_NGINX|" "$DIR/.env.example"+sed -i "s|^FRONTEND_HOST_PORT=.*|FRONTEND_HOST_PORT=$PROD_FRONTEND|" "$DIR/.env.example"+echo " updated .env.example"++# ββ compose.yml βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ+sed -i "s|\${APP_NAME:-[a-z0-9-]*}|\${APP_NAME:-$SLUG}|g" "$DIR/compose.yml"+sed -i "s|\${NGINX_HOST_PORT:-[0-9]\+}|\${NGINX_HOST_PORT:-$PROD_NGINX}|g" "$DIR/compose.yml"+echo " updated compose.yml"++# ββ dev.compose.yml βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ+sed -i "s|\${APP_NAME:-[a-z0-9-]*}|\${APP_NAME:-$SLUG}|g" "$DIR/dev.compose.yml"+sed -i "s|\${NGINX_HOST_PORT:-[0-9]\+}|\${NGINX_HOST_PORT:-$DEV_NGINX}|g" "$DIR/dev.compose.yml"+sed -i "s|\${FRONTEND_HOST_PORT:-[0-9]\+}|\${FRONTEND_HOST_PORT:-$DEV_FRONTEND}|g" "$DIR/dev.compose.yml"+echo " updated dev.compose.yml"++# ββ cloudflared.compose.yml βββββββββββββββββββββββββββββββββββββββββββββββββββ+sed -i "s|\${APP_NAME:-[a-z0-9-]*}|\${APP_NAME:-$SLUG}|g" "$DIR/cloudflared.compose.yml"+echo " updated cloudflared.compose.yml"++# ββ frontend/package.json βββββββββββββββββββββββββββββββββββββββββββββββββββββ+sed -i "s|\"name\": \".*\"|\"name\": \"$SLUG\"|" "$DIR/frontend/package.json"+echo " updated frontend/package.json"++# ββ frontend/index.html βββββββββββββββββββββββββββββββββββββββββββββββββββββββ+sed -i "s|Full Stack Template No Auth|$TITLE|g" "$DIR/frontend/index.html"+echo " updated frontend/index.html"++echo ""+echo "Done. Go build something."diff --git a/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/scripts/randomize-ports.sh b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/scripts/randomize-ports.shnew file mode 100755index 00000000..95348d01--- /dev/null+++ b/PROJECTS/intermediate/ja3-ja4-tls-fingerprinting/scripts/randomize-ports.sh@@ -0,0 +1,56 @@+#!/usr/bin/env bash+# =============================================================================+# AngelaMos | 2026+# randomize-ports.sh+# =============================================================================+# Picks 4 unique random ports (10000-65000) and updates:+# .env -> prod nginx + frontend ports+# .env.development -> dev nginx + frontend ports+# compose.yml -> prod default fallbacks+# dev.compose.yml -> dev default fallbacks++set -euo pipefail++DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"++mapfile -t ports < <(python3 -c "+import random+sample = random.sample(range(10000, 65001), 4)+for p in sample: print(p)+")++PROD_NGINX=${ports[0]}+PROD_FRONTEND=${ports[1]}+DEV_NGINX=${ports[2]}+DEV_FRONTEND=${ports[3]}++echo "New ports:"+echo " prod nginx: $PROD_NGINX"+echo " prod frontend: $PROD_FRONTEND"+echo " dev nginx: $DEV_NGINX"+echo " dev frontend: $DEV_FRONTEND"+echo ""++update_env() {+ local file="$1" nginx_port="$2" frontend_port="$3"+ sed -i "s/^NGINX_HOST_PORT=.*/NGINX_HOST_PORT=$nginx_port/" "$file"+ sed -i "s/^FRONTEND_HOST_PORT=.*/FRONTEND_HOST_PORT=$frontend_port/" "$file"+ echo " updated $file"+}++update_compose_defaults() {+ local file="$1" nginx_port="$2" frontend_port="${3:-}"+ sed -i "s/\${NGINX_HOST_PORT:-[0-9]\+}/\${NGINX_HOST_PORT:-$nginx_port}/g" "$file"+ if [[ -n "$frontend_port" ]]; then+ sed -i "s/\${FRONTEND_HOST_PORT:-[0-9]\+}/\${FRONTEND_HOST_PORT:-$frontend_port}/g" "$file"+ fi+ echo " updated $file"+}++update_env "$DIR/.env" "$PROD_NGINX" "$PROD_FRONTEND"+update_env "$DIR/.env.development" "$DEV_NGINX" "$DEV_FRONTEND"+update_compose_defaults "$DIR/compose.yml" "$PROD_NGINX"+update_compose_defaults "$DIR/dev.compose.yml" "$DEV_NGINX" "$DEV_FRONTEND"++echo ""+echo "Done."