added cookie consent and policies

ozziest · ozziest · commit 869bbcb54914 · 2025-07-12T17:50:27.000+02:00
diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
@@ -48,21 +48,16 @@ export default defineConfig({
     ],
 
     footer: {
-      message: "Released under the MIT License.",
+      message:
+        'Released under the MIT License. | <a href="/privacy-policy">Privacy Policy</a> | <a href="/cookie-policy">Cookie Policy</a> | <a style="cursor: pointer" data-cc="show-preferencesModal">Cookie preferences</a>',
       copyright: "Copyright © 2020-present",
     },
 
     search: { provider: "local" },
   },
 
   head: [
-    [
-      "link",
-      {
-        rel: "stylesheet",
-        href: "https://cdn.jsdelivr.net/gh/orestbida/cookieconsent@3.1.0/dist/cookieconsent.css",
-      },
-    ],
+    ["link", { rel: "stylesheet", href: "/cookieconsent.css" }],
     ["script", { defer: "", src: "/init.js" }],
     [
       "script",
@@ -80,7 +75,7 @@ export default defineConfig({
         window.dataLayer = window.dataLayer || [];
         function gtag(){dataLayer.push(arguments);}
         gtag('js', new Date());
-        gtag('config', 'G-67G9G0VBCC');
+        gtag('config', 'G-67G9G0VBCC', { anonymize_ip: true });
       `,
     ],
   ],
diff --git a/docs/.vitepress/theme/index.ts b/docs/.vitepress/theme/index.ts
@@ -5,6 +5,7 @@ import { observeCodeBlocks } from "./observe-code-blocks";
 
 export default {
   ...DefaultTheme,
+
   enhanceApp({ router }) {
     if (typeof window !== "undefined") {
       onMounted(() => {
diff --git a/docs/cookie-policy.md b/docs/cookie-policy.md
@@ -0,0 +1,70 @@
+---
+sidebar: false
+editLink: false
+outline: false
+prev: false
+next: false
+---
+
+# Cookie Policy
+
+_Last updated: July 12, 2025_
+
+This website uses cookies to enhance your browsing experience and to collect anonymous analytics data. This policy explains what cookies are, which ones we use, and how you can manage your preferences.
+
+## 1. What are cookies?
+
+Cookies are small text files stored on your device when you visit a website. They allow websites to remember your actions and preferences (such as language or session settings) over a period of time.
+
+Cookies can be:
+
+- **First-party cookies** – set by the website you are visiting
+- **Third-party cookies** – set by an external provider (like Google Analytics)
+
+They can also be:
+
+- **Session cookies** – deleted when you close your browser
+- **Persistent cookies** – stored for a defined period
+
+## 2. How we use cookies
+
+This site uses only the following types of cookies:
+
+### Strictly necessary cookies
+
+These cookies are required for basic functionality, such as remembering your cookie preferences. They do not track you or store any personally identifiable information.
+
+| Name      | Domain                | Expiration | Description                        |
+| --------- | --------------------- | ---------- | ---------------------------------- |
+| cc_cookie | validator.axe-api.com | 6 months   | Remembers your cookie preferences. |
+
+### Performance and analytics cookies
+
+These cookies help us understand how visitors use the site so we can improve it. All data collected is anonymized. These cookies are set **only if you accept analytics cookies** via the cookie banner.
+
+| Name   | Domain     | Expiration | Description                                                                  |
+| ------ | ---------- | ---------- | ---------------------------------------------------------------------------- |
+| ^\_ga  | google.com | 2 years    | Used to distinguish users by assigning a unique client ID.                   |
+| ^_ga_  | google.com | 2 years    | Used by Google Analytics 4 to persist session state for a specific property. |
+| ^\_gid | google.com | 24 hours   | Used to distinguish users and track user behavior for 24 hours.              |
+| ^\_gat | google.com | 1 minute   | Used to throttle request rate to Google Analytics servers.                   |
+
+All Google Analytics cookies are configured to **anonymize IP addresses**.
+
+For more information, see [Google’s cookie usage documentation](https://developers.google.com/analytics/devguides/collection/gtagjs/cookie-usage).
+
+## 3. How to manage your preferences
+
+You can change or withdraw your cookie consent at any time by clicking the **“Cookie preferences”** link in the footer of the site.
+
+You can also delete or block cookies via your browser settings. For guidance on how to do this, visit [www.aboutcookies.org](https://www.aboutcookies.org/).
+
+Please note that blocking certain cookies may affect the functionality of the site.
+
+## 4. Changes to this policy
+
+We may update this Cookie Policy from time to time. Changes will be posted on this page with an updated revision date.
+
+---
+
+If you have any questions about our use of cookies, feel free to contact us at [i.ozguradem@gmail.com](mailto:i.ozguradem@gmail.com).
diff --git a/docs/getting-started.md b/docs/getting-started.md
@@ -1,3 +1,7 @@
+---
+footer: true
+---
+
 # Getting started
 
 ## Installation
@@ -21,11 +25,7 @@ import { validate, setLocales, en } from "robust-validator";
 
 setLocales(en);
 
-const data = {
-  email: "not-a-valid-email",
-  name: "John",
-  surname: "Doe",
-};
+const data = { email: "not-a-valid-email", name: "John", surname: "Doe" };
 
 const definition = {
   email: "required|email",
@@ -50,11 +50,7 @@ import {
 
 setLocales(en);
 
-const data = {
-  email: "not-a-valid-email",
-  name: "John",
-  surname: "Doe",
-};
+const data = { email: "not-a-valid-email", name: "John", surname: "Doe" };
 
 const definition = {
   email: [required(), email()],
@@ -74,18 +70,9 @@ By the example, you would get the following response:
 {
   "isValid": false,
   "isInvalid": true,
-  "fields": {
-    "email": false,
-    "name": true,
-    "surname": true
-  },
+  "fields": { "email": false, "name": true, "surname": true },
   "errors": {
-    "email": [
-      {
-        "rule": "required",
-        "message": "The field is required."
-      }
-    ]
+    "email": [{ "rule": "required", "message": "The field is required." }]
   }
 }
 ```
@@ -104,31 +91,10 @@ setLocales(en);
 const data = {
   secret: "some secret",
   users: [
-    {
-      addresses: [
-        {
-          city: "New York",
-        },
-        {
-          city: "Istanbul",
-        },
-      ],
-    },
-    {
-      addresses: [
-        {
-          city: "New York",
-        },
-        {
-          street: "Wall Street",
-        },
-      ],
-    },
+    { addresses: [{ city: "New York" }, { city: "Istanbul" }] },
+    { addresses: [{ city: "New York" }, { street: "Wall Street" }] },
   ],
-  permissons: {
-    read: true,
-    write: true,
-  },
+  permissons: { read: true, write: true },
 };
 
 const definition = {
@@ -155,23 +121,12 @@ And this is the content of the `result` variable:
     "permissons.delete": false
   },
   "errors": {
-    "secret": [
-      {
-        "rule": "min",
-        "message": "The field must be at least 100."
-      }
-    ],
+    "secret": [{ "rule": "min", "message": "The field must be at least 100." }],
     "users.1.addresses.1.city": [
-      {
-        "rule": "required",
-        "message": "The field is required."
-      }
+      { "rule": "required", "message": "The field is required." }
     ],
     "permissons.delete": [
-      {
-        "rule": "required",
-        "message": "The field is required."
-      }
+      { "rule": "required", "message": "The field is required." }
     ]
   }
 }
diff --git a/docs/privacy-policy.md b/docs/privacy-policy.md
@@ -0,0 +1,81 @@
+---
+sidebar: false
+editLink: false
+outline: false
+prev: false
+next: false
+---
+
+# Privacy Policy
+
+_Last updated: July 12, 2025_
+
+We respect your privacy and are committed to protecting any data you share with us. This privacy policy explains what information we collect, how we use it, and your rights regarding that information.
+
+## 1. Who we are
+
+This website is a documentation site operated by Özgür Adem Işıklı. It does not include forms, logins, or other features that directly collect personal data from users.
+
+If you have questions about this policy or your data, you can contact us at [i.ozguradem@gmail.com](mailto:i.ozguradem@gmail.com).
+
+## 2. What data we collect
+
+We do **not** collect personal data such as your name, email address, or IP address directly.
+
+However, we use Google Analytics to collect anonymized usage statistics that help us understand how visitors interact with our website.
+
+## 3. Use of cookies
+
+This site uses:
+
+- **Strictly necessary cookies** to ensure the website functions properly
+- **Analytics cookies**, which are optional and used only with your consent
+
+Analytics cookies are not loaded unless you explicitly accept them through the cookie consent banner.
+
+See our [Cookie Policy](/cookie-policy) for detailed information.
+
+## 4. Data collected via Google Analytics
+
+Google Analytics may collect the following types of information:
+
+- Pages visited
+- Time spent on each page
+- Referring website or URL
+- Browser and device type
+- Approximate geolocation (city-level)
+
+We have configured Google Analytics to **anonymize IP addresses**, so your full IP address is never stored or processed.
+
+All collected data is aggregated and cannot be used to identify you personally.
+
+## 5. Legal basis for processing
+
+In accordance with Article 6(1)(a) of the GDPR, we process analytics data only after obtaining your **explicit consent**.
+
+You can withdraw your consent at any time using the "Cookie Settings" link in the website footer.
+
+## 6. Data sharing
+
+We do **not** sell, rent, or share your personal data.
+
+We share anonymized usage data with Google LLC through Google Analytics. You can read more about how Google uses this data in their [Privacy Policy](https://policies.google.com/privacy).
+
+## 7. Your rights under GDPR
+
+You have the right to:
+
+- Access the data we hold about you (if any)
+- Request correction or deletion of your data
+- Withdraw your consent at any time
+- Lodge a complaint with your local data protection authority
+
+Since this website does not store personal information or use user accounts, most of these rights are not applicable in practice. However, we are happy to respond to any questions or requests you may have.
+
+## 8. Changes to this policy
+
+We may update this Privacy Policy from time to time. Any changes will be posted on this page with an updated revision date.
+
+---
+
+If you have any questions about this policy, feel free to contact us at [i.ozguradem@gmail.com](mailto:i.ozguradem@gmail.com).
diff --git a/docs/public/cookieconsent.css b/docs/public/cookieconsent.css
diff --git a/docs/public/cookieconsent.umd.js b/docs/public/cookieconsent.umd.js
diff --git a/docs/public/init.js b/docs/public/init.js
@@ -11,9 +11,7 @@ function loadScript(src) {
 }
 
 // Usage
-loadScript(
-  "https://cdn.jsdelivr.net/gh/orestbida/cookieconsent@3.1.0/dist/cookieconsent.umd.js",
-).then(() => {
+loadScript("/cookieconsent.umd.js").then(() => {
   CookieConsent.run({
     categories: {
       necessary: { enabled: true, readOnly: true },
