From 049045d3cd4a1b2e2307f051a140f373e2e78a66 Mon Sep 17 00:00:00 2001
From: Darshan <itznotabug@gmail.com>
Date: Fri, 31 Jan 2025 17:56:50 +0530
Subject: [PATCH] fix: throw a 404 if an `id` is not found in
 `api.components.schemas`.

---
 src/lib/utils/specs.ts                                 | 10 +++++++++-
 .../references/[version]/models/[model]/+page.svelte   |  1 +
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/src/lib/utils/specs.ts b/src/lib/utils/specs.ts
index 61e5c61708..11b7ad4c15 100644
--- a/src/lib/utils/specs.ts
+++ b/src/lib/utils/specs.ts
@@ -1,5 +1,6 @@
 import { OpenAPIV3 } from 'openapi-types';
 import { Platform, type Service } from './references';
+import { error } from '@sveltejs/kit';
 
 export type SDKMethod = {
     'rate-limit': number;
@@ -195,7 +196,14 @@ export function getSchema(id: string, api: OpenAPIV3.Document): OpenAPIV3.Schema
     if (schema) {
         return schema;
     }
-    throw new Error(`Schema doesn't exist for id: ${id}`);
+
+    /**
+     * It is better to show a `404` if no schema exists for a given `id`,
+     * rather than a 500 internal server error which is, misleading in cases like this.
+     *
+     * It is quite possible that the user just wandered around here with a wrong docs link!
+     */
+    error(404, { message: `Not found` });
 }
 
 const specs = import.meta.glob(
diff --git a/src/routes/docs/references/[version]/models/[model]/+page.svelte b/src/routes/docs/references/[version]/models/[model]/+page.svelte
index d3a99508ab..e398e640da 100644
--- a/src/routes/docs/references/[version]/models/[model]/+page.svelte
+++ b/src/routes/docs/references/[version]/models/[model]/+page.svelte
@@ -43,6 +43,7 @@
                         <Td>
                             {property.description}
                             {#if property.relatedModels}
+                                <!-- eslint-disable-next-line svelte/no-at-html-tags -->
                                 Can be one of: {@html parse(property.relatedModels)}
                             {/if}
                         </Td>