Merge branch 'main' into alex/update-sub-processors

Author: alex72508

astro.config.mjs

@@ -35,6 +35,7 @@ export default defineConfig({
     enabled: false
   },
   redirects: {
+    "/sitemap.xml": "/sitemap-0.xml",
     "/developer-tools/kinde-api/register-manage-apis/":
       "/developer-tools/your-apis/register-manage-apis/",
     "/developer-tools/kinde-api/protect-your-api/": 
@@ -60,7 +61,203 @@ export default defineConfig({
     "/design/pages/set-language-for-pages/":
       "/design/content-customization/set-language-for-pages/",
     "/design/pages/internationalization/":
-      "/design/content-customization/set-language-for-pages/"
+      "/design/content-customization/set-language-for-pages/",
+    
+    // Section-level redirects to prevent 404s when users truncate URLs
+    "/authenticate/":
+      "/authenticate/about-auth/about-authentication/",
+    "/billing/":
+      "/billing/about-billing/about-billing/",
+    "/build/":
+      "/build/applications/about-applications/",
+    "/design/":
+      "/design/brand/global-brand-defaults/",
+    "/developer-tools/":
+      "/developer-tools/about/our-sdks/",
+    "/get-started/":
+      "/get-started/apis-and-sdks/about-kinde-apis/",
+    "/integrate/":
+      "/integrate/connected-apps/add-connected-apps/",
+    "/machine-to-machine-applications/":
+      "/machine-to-machine-applications/about-m2m/authenticate-with-m2m/",
+    "/manage-your-account/":
+      "/manage-your-account/business-information/update-your-details/",
+    "/manage-users/":
+      "/manage-users/about/manage-users-across-organizations/",
+    "/properties/":
+      "/properties/about-properties/application-properties/",
+    "/releases/":
+      "/releases/about/about-feature-flags/",
+    "/trust-center/":
+      "/trust-center/agreements/terms-of-service/",
+    "/workflows/":
+      "/workflows/about-workflows/",
+    
+    // Authenticate section subfolder redirects
+    "/authenticate/about-auth/":
+      "/authenticate/about-auth/about-authentication/",
+    "/authenticate/auth-guides/":
+      "/authenticate/auth-guides/enterprise-connections-identity/",
+    "/authenticate/authentication-methods/":
+      "/authenticate/authentication-methods/email-authentication/",
+    "/authenticate/custom-configurations/":
+      "/authenticate/custom-configurations/authentication-experience/",
+    "/authenticate/enterprise-connections/":
+      "/authenticate/enterprise-connections/about-enterprise-connections/",
+    "/authenticate/manage-authentication/":
+      "/authenticate/manage-authentication/authenticated-sessions-across-multiple-applications/",
+    "/authenticate/multi-factor-auth/":
+      "/authenticate/multi-factor-auth/about-multi-factor-authentication/",
+    "/authenticate/social-sign-in/":
+      "/authenticate/social-sign-in/add-social-sign-in/",
+    
+    // Billing section subfolder redirects
+    "/billing/about-billing/":
+      "/billing/about-billing/about-billing/",
+    "/billing/billing-user-experience/":
+      "/billing/billing-user-experience/add-pricing-table/",
+    "/billing/get-started/":
+      "/billing/get-started/add-billing-role/",
+    "/billing/manage-plans/":
+      "/billing/manage-plans/about-plans/",
+    "/billing/manage-subscribers/":
+      "/billing/manage-subscribers/add-metered-usage/",
+    "/billing/payment-management/":
+      "/billing/payment-management/manage-stripe-connection/",
+    "/billing/pricing/":
+      "/billing/pricing/pricing-models/",
+    
+    // Build section subfolder redirects
+    "/build/applications/":
+      "/build/applications/about-applications/",
+    "/build/domains/":
+      "/build/domains/pointing-your-domain/",
+    "/build/env-variables/":
+      "/build/env-variables/add-manage-env-variables/",
+    "/build/environments/":
+      "/build/environments/environments/",
+    "/build/organizations/":
+      "/build/organizations/add-and-manage-organizations/",
+    "/build/set-up-options/":
+      "/build/set-up-options/access-policies/",
+    "/build/tokens/":
+      "/build/tokens/about-access-tokens/",
+    
+    // Design section subfolder redirects
+    "/design/brand/":
+      "/design/brand/global-brand-defaults/",
+    "/design/content-customization/":
+      "/design/content-customization/how-content-is-managed/",
+    "/design/customize-with-code/":
+      "/design/customize-with-code/connect-repo/",
+    "/design/pages/":
+      "/design/pages/page-layout/",
+    
+    // Developer tools section subfolder redirects
+    "/developer-tools/about/":
+      "/developer-tools/about/our-sdks/",
+    "/developer-tools/account-api/":
+      "/developer-tools/account-api/about-account-api/",
+    "/developer-tools/guides/":
+      "/developer-tools/guides/code-sync-errors/",
+    "/developer-tools/kinde-api/":
+      "/developer-tools/kinde-api/about-m2m-scopes/",
+    "/developer-tools/sdks/backend/":
+      "/developer-tools/sdks/backend/apollo-graphql/",
+    "/developer-tools/sdks/frontend/":
+      "/developer-tools/sdks/frontend/javascript-sdk/",
+    "/developer-tools/sdks/native/":
+      "/developer-tools/sdks/native/android-sdk/",
+    "/developer-tools/your-apis/":
+      "/developer-tools/your-apis/access-to-your-api/",
+    
+    // Get started section subfolder redirects
+    "/get-started/apis-and-sdks/":
+      "/get-started/apis-and-sdks/about-kinde-apis/",
+    "/get-started/connect/":
+      "/get-started/connect/callback-urls/",
+    "/get-started/guides/":
+      "/get-started/guides/byo-code/",
+    "/get-started/learn-about-kinde/":
+      "/get-started/learn-about-kinde/kinde-product-security/",
+    "/get-started/switch-to-kinde/":
+      "/get-started/switch-to-kinde/auth0-to-kinde/",
+    "/get-started/team-and-account/":
+      "/get-started/team-and-account/add-team-members/",
+    
+    // Integrate section subfolder redirects
+    "/integrate/connected-apps/":
+      "/integrate/connected-apps/add-connected-apps/",
+    "/integrate/third-party-tools/":
+      "/integrate/third-party-tools/cloudflare-zero-trust/",
+    "/integrate/webhooks/":
+      "/integrate/webhooks/about-webhooks/",
+    
+    // Machine-to-machine applications section subfolder redirects
+    "/machine-to-machine-applications/m2m-application-setup/":
+      "/machine-to-machine-applications/m2m-application-setup/add-feature-flags-to-m2m-applications/",
+    "/machine-to-machine-applications/m2m-token-customization/":
+      "/machine-to-machine-applications/m2m-token-customization/customize-m2m-tokens/",
+    "/machine-to-machine-applications/m2m-workflow-automation/":
+      "/machine-to-machine-applications/m2m-workflow-automation/m2m-workflow/",
+    "/machine-to-machine-applications/organization-scoped-m2m-apps/":
+      "/machine-to-machine-applications/organization-scoped-m2m-apps/enforce-org-m2m-access-in-your-api/",
+    "/machine-to-machine-applications/troubleshooting-m2m/":
+      "/machine-to-machine-applications/troubleshooting-m2m/troubleshoot-m2m-token-errors/",
+    
+    // Manage your account section subfolder redirects
+    "/manage-your-account/business-information/":
+      "/manage-your-account/business-information/change-your-business-time-zone/",
+    "/manage-your-account/profile-and-plan/":
+      "/manage-your-account/profile-and-plan/change-kinde-plan/",
+    "/manage-your-account/your-data/":
+      "/manage-your-account/your-data/check-your-mau/",
+    
+    // Manage users section subfolder redirects
+    "/manage-users/access-control/":
+      "/manage-users/access-control/accept-policies-signup/",
+    "/manage-users/add-and-edit/":
+      "/manage-users/add-and-edit/add-and-edit-users/",
+    "/manage-users/roles-and-permissions/":
+      "/manage-users/roles-and-permissions/apply-roles-and-permissions-to-users/",
+    "/manage-users/view-activity/":
+      "/manage-users/view-activity/hotjar/",
+    
+    // Properties section subfolder redirects
+    "/properties/work-with-properties/":
+      "/properties/work-with-properties/manage-properties/",
+    
+    // Releases section subfolder redirects
+    "/releases/about/":
+      "/releases/about/about-feature-flags/",
+    "/releases/feature-flags/":
+      "/releases/feature-flags/add-feature-flag/",
+    "/releases/guides/":
+      "/releases/guides/guide-to-app-store-approvals/",
+    
+    // Trust center section subfolder redirects
+    "/trust-center/agreements/":
+      "/trust-center/agreements/end-user-licence-agreement/",
+    "/trust-center/kinde-performance/":
+      "/trust-center/kinde-performance/service-status/",
+    "/trust-center/privacy-and-compliance/":
+      "/trust-center/privacy-and-compliance/compliance/",
+    "/trust-center/security/":
+      "/trust-center/security/security-at-kinde/",
+    
+    // Workflows section subfolder redirects
+    "/workflows/bindings/":
+      "/workflows/bindings/access-token-binding/",
+    "/workflows/configuration/":
+      "/workflows/configuration/bindings/",
+    "/workflows/example-workflows/":
+      "/workflows/example-workflows/existing-password-provided-workflow/",
+    "/workflows/getting-started/":
+      "/workflows/getting-started/connect-repo-for-workflows/",
+    "/workflows/manage-workflows/":
+      "/workflows/manage-workflows/create-workflow/",
+    "/workflows/observability/":
+      "/workflows/observability/workflow-build-logs/",
   },
   markdown: {
     rehypePlugins: [
@@ -120,7 +317,12 @@ export default defineConfig({
       applyBaseStyles: false
     }),
     icon(),
-    sitemap(),
+    sitemap({
+      filter: (page) => !page.includes('404'),
+      customPages: [
+        'https://docs.kinde.com/'
+      ]
+    }),
     AutoImport({
       imports: [
         "./src/components/SDKSelector.astro",

customHttp.yml

@@ -44,7 +44,8 @@ customHeaders:
           'sha256-8JLcQFZQruxl3jMUwogr3y5/GMmZPAc+j2mNi7gywmw='
           'sha256-w78n7W12c94ck4KhBCBA4NrjqkbDvSutqee+u+no0Tg='
           'sha256-/4BQzbQ0kgR1l13wtSM3rZ7nSvyV3PX/ShEfhZA1WoQ='
-          'sha256-zB5rUhTjHzt+r/RjhhI8CyMb5Y63k+J7ICVfQ7iHJqA=' 'self'
+          'sha256-zB5rUhTjHzt+r/RjhhI8CyMb5Y63k+J7ICVfQ7iHJqA='
+          'sha256-fFmtUWM/kGeUru+1rcCArLmnXKoEjis5I/dYQkZA+HM=' 'self'
           widgets.kinde.com kinde.com
           https://cdn.jsdelivr.net/npm/@scalar/[email protected]/dist/browser/standalone.min.js
       - key: Strict-Transport-Security

public/robots.txt

@@ -0,0 +1,5 @@
+User-agent: *
+Allow: /
+
+# Sitemap
+Sitemap: https://docs.kinde.com/sitemap-0.xml

scripts/validate-links.js

@@ -9,6 +9,48 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 const distFolder = path.join(__dirname, "../dist");
+const astroConfigPath = path.join(__dirname, "../astro.config.mjs");
+
+// Function to extract redirect destinations from astro.config.mjs
+function getRedirectDestinations() {
+  try {
+    const configContent = fs.readFileSync(astroConfigPath, "utf-8");
+    
+    // Extract the redirects object using regex
+    const redirectsMatch = configContent.match(/redirects:\s*{([^}]+)}/s);
+    if (!redirectsMatch) {
+      console.log(chalk.yellow("No redirects found in astro.config.mjs"));
+      return [];
+    }
+    
+    const redirectsSection = redirectsMatch[1];
+    
+    // Extract all destination URLs (the values after the colons)
+    const destinationMatches = redirectsSection.match(/:\s*"([^"]+)"/g);
+    if (!destinationMatches) {
+      console.log(chalk.yellow("No redirect destinations found in astro.config.mjs"));
+      return [];
+    }
+    
+    // Clean up the matches to get just the URLs
+    const destinations = destinationMatches.map(match => {
+      // Remove the ': "' prefix and '"' suffix
+      return match.replace(/:\s*"/, '').replace(/"$/, '');
+    });
+    
+    console.log(chalk.blue(`Found ${destinations.length} redirect destinations`));
+    return destinations;
+    
+  } catch (error) {
+    console.error(chalk.red(`Error reading astro.config.mjs: ${error.message}`));
+    return [];
+  }
+}
+
+// Function to check if a URL is a redirect destination
+function isRedirectDestination(url, redirectDestinations) {
+  return redirectDestinations.includes(url);
+}
 
 // Function to read all HTML files from a directory
 function readHtmlFiles(dir) {
@@ -63,7 +105,7 @@ function anchorExists(html, anchor) {
 }
 
 // Function to validate links
-function validateLinks(htmlFiles) {
+function validateLinks(htmlFiles, redirectDestinations) {
   let invalidLinks = [];
 
   htmlFiles.forEach((file) => {
@@ -74,6 +116,13 @@ function validateLinks(htmlFiles) {
       // Split by the first occurrence of `#` to allow fragments with slashes
       const [pathWithoutHash, ...hashParts] = link.split("#");
       const hash = hashParts.length ? hashParts.join("#") : null;
+      
+      // Check if this is a redirect destination - if so, skip validation
+      if (isRedirectDestination(pathWithoutHash, redirectDestinations)) {
+        console.log(chalk.yellow(`Skipping redirect destination: ${pathWithoutHash}`));
+        return;
+      }
+      
       const resolvedPath = path.join(distFolder, pathWithoutHash);
       const normalizedPath = path.normalize(resolvedPath);
       const ext = path.extname(normalizedPath);
@@ -109,6 +158,9 @@ function validateLinks(htmlFiles) {
 
 // Main function
 function main() {
+  // Get redirect destinations from astro.config.mjs
+  const redirectDestinations = getRedirectDestinations();
+  
   const htmlFiles = readHtmlFiles(distFolder);
   const allLinks = new Set();
 
@@ -118,7 +170,7 @@ function main() {
     links.forEach((link) => allLinks.add(link));
   });
 
-  const invalidLinks = validateLinks(htmlFiles);
+  const invalidLinks = validateLinks(htmlFiles, redirectDestinations);
 
   if (invalidLinks.length > 0) {
     console.log(chalk.red("Invalid Links:"));

src/components/APICards.astro

@@ -11,7 +11,7 @@
       aria-hidden="true"
       class="mt-12 text-inherit underline decoration-inherit underline-offset-[6px] transition-all hover:text-current"
     >
-      Explore the Management API reference
+      Explore the Management API
     </p>
     <a
       href="/kinde-apis/management/"
@@ -25,13 +25,13 @@
   >
     <h3>Account API</h3>
     <p>
-      For managing the currently signed-in user, includes e.g their profile, roles, permissions, billing info and revoking tokens
+      For managing the data of signed-in users, including their profile, roles, permissions, billing info and tokens
     </p>
     <p
       aria-hidden="true"
       class="mt-12 text-inherit underline decoration-inherit underline-offset-[6px] transition-all hover:text-current"
     >
-      Explore the Account API reference
+      Explore the Account API
     </p>
     <a
       href="/kinde-apis/frontend/"