Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

fix(docs): Add defensive null checks and array validation across toolkit files

Sushmithamallesh0431ec81eb18
diff --git a/docs/app/(home)/toolkits/[[...slug]]/page.tsx b/docs/app/(home)/toolkits/[[...slug]]/page.tsx
index 6bf5f3378..e0de9f6a0 100644
--- a/docs/app/(home)/toolkits/[[...slug]]/page.tsx
+++ b/docs/app/(home)/toolkits/[[...slug]]/page.tsx
@@ -41,7 +41,7 @@ async function fetchDetailedTools(toolkitSlug: string): Promise<Tool[] | null> {
const rawItems = data.items || data;
const items = Array.isArray(rawItems) ? rawItems : [];
- return items.map((tool: any) => {
+ return items.filter((tool: any) => tool && typeof tool === 'object').map((tool: any) => {
// Extract parameters from JSON Schema format
const inputSchema = tool.input_parameters || tool.parameters;
const outputSchema = tool.output_parameters || tool.response;
@@ -154,7 +154,7 @@ export async function generateMetadata({ params }: { params: Promise<{ slug?: st
const toolkit = toolkits.find((t) => t.slug === slug[0]);
if (toolkit) {
return {
- title: `${toolkit.name.trim()} - Composio Toolkit`,
+ title: `${toolkit.name?.trim() || toolkit.slug} - Composio Toolkit`,
description: toolkit.description,
};
}
diff --git a/docs/components/toolkits/auth-details-section.tsx b/docs/components/toolkits/auth-details-section.tsx
index 399d20316..efcaa9814 100644
--- a/docs/components/toolkits/auth-details-section.tsx
+++ b/docs/components/toolkits/auth-details-section.tsx
@@ -47,11 +47,12 @@ function fieldsToTypeTable(fields: AuthConfigField[]): Record<string, {
}
function getAllFields(detail: AuthConfigDetail): AuthConfigField[] {
+ if (!detail?.fields) return [];
return [
- ...detail.fields.auth_config_creation.required,
- ...detail.fields.auth_config_creation.optional,
- ...detail.fields.connected_account_initiation.required,
- ...detail.fields.connected_account_initiation.optional,
+ ...(detail.fields.auth_config_creation?.required || []),
+ ...(detail.fields.auth_config_creation?.optional || []),
+ ...(detail.fields.connected_account_initiation?.required || []),
+ ...(detail.fields.connected_account_initiation?.optional || []),
];
}
@@ -62,7 +63,7 @@ export function AuthDetailsSection({ authConfigDetails }: AuthDetailsSectionProp
// Filter out auth modes with no fields in either section
const validDetails = authConfigDetails.filter((detail) => {
- return getAllFields(detail).length > 0;
+ return detail && getAllFields(detail).length > 0;
});
if (validDetails.length === 0) {
diff --git a/docs/components/toolkits/toolkit-detail.tsx b/docs/components/toolkits/toolkit-detail.tsx
index 126dabe4b..9d34045cb 100644
--- a/docs/components/toolkits/toolkit-detail.tsx
+++ b/docs/components/toolkits/toolkit-detail.tsx
@@ -24,7 +24,7 @@ function ToolkitIcon({ toolkit }: { toolkit: Toolkit }) {
backgroundSize: '60%',
} : undefined}
>
- {!toolkit.logo && toolkit.name.trim().charAt(0).toUpperCase()}
+ {!toolkit.logo && (toolkit.name?.trim() || toolkit.slug).charAt(0).toUpperCase()}
</div>
);
}
@@ -133,22 +133,24 @@ export function ToolkitDetail({ toolkit, tools, triggers, path }: ToolkitDetailP
const [activeTab, setActiveTab] = useState<'tools' | 'triggers'>('tools');
const filteredTools = useMemo(() => {
- if (!toolSearch) return tools;
+ const toolsArray = tools || [];
+ if (!toolSearch) return toolsArray;
const search = toolSearch.toLowerCase();
- return tools.filter(
+ return toolsArray.filter(
(tool) =>
- tool.name.toLowerCase().includes(search) ||
- tool.slug.toLowerCase().includes(search)
+ tool.name?.toLowerCase().includes(search) ||
+ tool.slug?.toLowerCase().includes(search)
);
}, [tools, toolSearch]);
const filteredTriggers = useMemo(() => {
- if (!toolSearch) return triggers;
+ const triggersArray = triggers || [];
+ if (!toolSearch) return triggersArray;
const search = toolSearch.toLowerCase();
- return triggers.filter(
+ return triggersArray.filter(
(trigger) =>
- trigger.name.toLowerCase().includes(search) ||
- trigger.slug.toLowerCase().includes(search)
+ trigger.name?.toLowerCase().includes(search) ||
+ trigger.slug?.toLowerCase().includes(search)
);
}, [triggers, toolSearch]);
@@ -184,7 +186,7 @@ export function ToolkitDetail({ toolkit, tools, triggers, path }: ToolkitDetailP
{/* Title row */}
<div className="flex flex-wrap items-center justify-between gap-2">
<div className="flex flex-wrap items-center gap-2">
- <h1 className="text-xl font-bold tracking-tight text-fd-foreground">{toolkit.name.trim()}</h1>
+ <h1 className="text-xl font-bold tracking-tight text-fd-foreground">{(toolkit.name?.trim() || toolkit.slug)}</h1>
<button
onClick={copySlug}
className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground"
@@ -218,7 +220,7 @@ export function ToolkitDetail({ toolkit, tools, triggers, path }: ToolkitDetailP
target="_blank"
className="inline-flex items-center gap-1.5 rounded-md border border-orange-500/30 bg-orange-500/10 px-3 py-1.5 text-sm font-medium text-orange-600 transition-colors hover:bg-orange-500/20 dark:text-orange-400"
>
- Try {toolkit.name.trim()}
+ Try {(toolkit.name?.trim() || toolkit.slug)}
<ExternalLink className="h-3.5 w-3.5" />
</Link>
</div>
diff --git a/docs/components/toolkits/toolkits-landing.tsx b/docs/components/toolkits/toolkits-landing.tsx
index ce06367d3..1a630d5d1 100644
--- a/docs/components/toolkits/toolkits-landing.tsx
+++ b/docs/components/toolkits/toolkits-landing.tsx
@@ -129,11 +129,11 @@ export function ToolkitsLanding() {
// First sort all toolkits alphabetically (trim to handle leading spaces)
const sorted = [...filteredToolkits].sort((a, b) =>
- a.name.trim().localeCompare(b.name.trim())
+ (a.name?.trim() || '').localeCompare(b.name?.trim() || '')
);
sorted.forEach((toolkit) => {
- const firstChar = toolkit.name.trim().charAt(0).toUpperCase();
+ const firstChar = (toolkit.name?.trim() || '#').charAt(0).toUpperCase();
// Group all numbers under '#'
const letter = /[0-9]/.test(firstChar) ? '#' : firstChar;
if (!groups[letter]) {
diff --git a/docs/scripts/generate-toolkits.ts b/docs/scripts/generate-toolkits.ts
index 3deb92294..f843e9679 100644
--- a/docs/scripts/generate-toolkits.ts
+++ b/docs/scripts/generate-toolkits.ts
@@ -133,9 +133,10 @@ async function fetchToolsForToolkit(slug: string): Promise<Tool[]> {
if (!response.ok) return [];
const data = await response.json();
- const items = data.items || data || [];
+ const rawItems = data.items || data;
+ const items = Array.isArray(rawItems) ? rawItems : [];
- return items.map((raw: any) => ({
+ return items.filter((raw: any) => raw && typeof raw === 'object').map((raw: any) => ({
slug: raw.slug || '',
name: raw.name || raw.display_name || raw.slug || '',
description: raw.description || '',
@@ -153,9 +154,10 @@ async function fetchTriggersForToolkit(slug: string): Promise<Trigger[]> {
if (!response.ok) return [];
const data = await response.json();
- const items = data.items || data || [];
+ const rawItems = data.items || data;
+ const items = Array.isArray(rawItems) ? rawItems : [];
- return items.map((raw: any) => ({
+ return items.filter((raw: any) => raw && typeof raw === 'object').map((raw: any) => ({
slug: raw.slug || '',
name: raw.name || raw.display_name || raw.slug || '',
description: raw.description || '',