[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M793GKWFV6RB9B3TN2EB73KB":3,"skill-same:01M793GKWFV6RB9B3TN2EB73KB":56},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":33,"commitSha":34,"skillDirectory":35,"forksCount":36,"repositoryHtmlUrl":37,"repositoryHomepageUrl":6,"ownerHtmlUrl":38,"ownerBlogUrl":39,"ownerDescription":40,"updatedAt":41,"install":42,"resources":55},"01M793GKWFV6RB9B3TN2EB73KB","navan-sdk-patterns",null,"Build a typed API wrapper around Navan REST endpoints since no official SDK exists.\nUse when you need production-grade API access with auto token refresh, retry logic, and typed responses.\nTrigger with \"navan sdk patterns\", \"navan api wrapper\", \"navan client class\", \"navan typed client\".","jukeyman\u002Fjukeyman-skills","jukeyman","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F142960420?v=4","01M78FR4Y3DHMMCBCC0GXXNB3F","RICK JEFFERSON","01M78FR4Z8RVQRAD31Y5J7V6EB",1,"MIT","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--navan-pack--navan-sdk-patterns\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: navan-sdk-patterns\ndescription: |\n  Build a typed API wrapper around Navan REST endpoints since no official SDK exists.\n  Use when you need production-grade API access with auto token refresh, retry logic, and typed responses.\n  Trigger with \"navan sdk patterns\", \"navan api wrapper\", \"navan client class\", \"navan typed client\".\nallowed-tools: Read, Write, Edit, Bash(npm:*), Grep\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\ntags: [saas, navan, travel]\ncompatible-with: claude-code\n---\n\n# Navan SDK Patterns\n\n## Overview\n\nBuild a typed API wrapper around Navan REST endpoints since no official SDK exists (`@navan\u002Fsdk` is not a real package). These patterns provide automatic token lifecycle management, typed responses, retry middleware, and centralized error handling.\n\n**Purpose:** Create a reusable NavanAPI class encapsulating authentication, request handling, and error recovery.\n\n## Prerequisites\n\n- Completed `navan-install-auth` with working OAuth 2.0 credentials\n- TypeScript 5+ project with `dotenv` installed\n- Familiarity with the Navan endpoints from `navan-hello-world`\n\n## Instructions\n\n### Step 1: Define Response Interfaces\n\nType the known API response shapes so every call returns structured data:\n\n```typescript\n\u002F\u002F navan-types.ts\nexport interface NavanTrip {\n  uuid: string;\n  traveler_name: string;\n  origin: string;\n  destination: string;\n  departure_date: string;\n  return_date: string;\n  booking_status: string;\n  booking_type: 'flight' | 'hotel' | 'car';\n}\n\nexport interface NavanUser {\n  id: string;\n  email: string;\n  first_name: string;\n  last_name: string;\n  department: string;\n  role: string;\n}\n\nexport interface NavanApiError {\n  status: number;\n  message: string;\n  endpoint: string;\n  timestamp: string;\n}\n```\n\n### Step 2: Build the NavanAPI Wrapper Class\n\nCreate a singleton client with automatic token management:\n\n```typescript\n\u002F\u002F navan-client.ts\nimport 'dotenv\u002Fconfig';\nimport type { NavanTrip, NavanUser, NavanApiError } from '.\u002Fnavan-types';\n\nexport class NavanAPI {\n  private baseUrl: string;\n  private clientId: string;\n  private clientSecret: string;\n  private accessToken: string | null = null;\n  private tokenExpiry: number = 0;\n\n  constructor() {\n    this.baseUrl = process.env.NAVAN_BASE_URL ?? 'https:\u002F\u002Fapi.navan.com';\n    this.clientId = process.env.NAVAN_CLIENT_ID ?? '';\n    this.clientSecret = process.env.NAVAN_CLIENT_SECRET ?? '';\n    if (!this.clientId || !this.clientSecret) {\n      throw new Error('NAVAN_CLIENT_ID and NAVAN_CLIENT_SECRET must be set');\n    }\n  }\n\n  \u002F** Acquire or refresh the OAuth 2.0 bearer token *\u002F\n  private async authenticate(): Promise\u003Cstring> {\n    if (this.accessToken && Date.now() \u003C this.tokenExpiry) {\n      return this.accessToken;\n    }\n\n    const response = await fetch(`${this.baseUrl}\u002Fta-auth\u002Foauth\u002Ftoken`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application\u002Fx-www-form-urlencoded' },\n      body: new URLSearchParams({\n        grant_type: 'client_credentials',\n        client_id: this.clientId,\n        client_secret: this.clientSecret,\n      }),\n    });\n\n    if (!response.ok) {\n      throw this.toApiError(response.status, 'Authentication failed', '\u002Fta-auth\u002Foauth\u002Ftoken');\n    }\n\n    const data = await response.json();\n    this.accessToken = data.access_token;\n    \u002F\u002F Buffer 60 seconds before actual expiry\n    this.tokenExpiry = Date.now() + (data.expires_in - 60) * 1000;\n    return this.accessToken!;\n  }\n\n  \u002F** Core request method with auth, retries, and error handling *\u002F\n  private async request\u003CT>(endpoint: string, options: RequestInit = {}): Promise\u003CT> {\n    const token = await this.authenticate();\n    const url = `${this.baseUrl}${endpoint}`;\n\n    for (let attempt = 0; attempt \u003C 3; attempt++) {\n      const response = await fetch(url, {\n        ...options,\n        headers: {\n          Authorization: `Bearer ${token}`,\n          'Content-Type': 'application\u002Fjson',\n          ...options.headers,\n        },\n      });\n\n      if (response.ok) return response.json() as Promise\u003CT>;\n\n      \u002F\u002F Retry on 429 (rate limit) and 503 (maintenance)\n      if ((response.status === 429 || response.status === 503) && attempt \u003C 2) {\n        const delay = Math.pow(2, attempt + 1) * 1000; \u002F\u002F 2s, 4s\n        await new Promise((r) => setTimeout(r, delay));\n        continue;\n      }\n\n      \u002F\u002F Re-auth on 401 (expired token)\n      if (response.status === 401 && attempt \u003C 2) {\n        this.accessToken = null;\n        this.tokenExpiry = 0;\n        continue;\n      }\n\n      throw this.toApiError(response.status, await response.text(), endpoint);\n    }\n\n    throw this.toApiError(0, 'Max retries exceeded', endpoint);\n  }\n\n  private toApiError(status: number, message: string, endpoint: string): NavanApiError {\n    return { status, message, endpoint, timestamp: new Date().toISOString() };\n  }\n\n  \u002F\u002F --- Public API methods ---\n\n  async getBookings(page = 0, size = 50): Promise\u003CNavanTrip[]> {\n    const data = await this.request\u003C{ data: NavanTrip[] }>(`\u002Fv1\u002Fbookings?page=${page}&size=${size}`);\n    return data.data ?? [];\n  }\n\n  async getUsers(): Promise\u003CNavanUser[]> {\n    const data = await this.request\u003C{ data: NavanUser[] }>('\u002Fv1\u002Fusers');\n    return data.data ?? [];\n  }\n}\n```\n\n### Step 3: Implement a Singleton Factory\n\nEnsure one client instance per process to reuse the token:\n\n```typescript\n\u002F\u002F navan-singleton.ts\nimport { NavanAPI } from '.\u002Fnavan-client';\n\nlet instance: NavanAPI | null = null;\n\nexport function getNavanClient(): NavanAPI {\n  if (!instance) instance = new NavanAPI();\n  return instance;\n}\n\n\u002F\u002F Usage\nconst navan = getNavanClient();\nconst bookings = await navan.getBookings();\nconst users = await navan.getUsers();\n```\n\n### Step 4: Add Error Handling Middleware\n\nWrap API calls with structured error handling for calling code:\n\n```typescript\n\u002F\u002F navan-safe.ts\nimport type { NavanApiError } from '.\u002Fnavan-types';\n\ntype Result\u003CT> = { ok: true; data: T } | { ok: false; error: NavanApiError };\n\nexport async function safeCall\u003CT>(fn: () => Promise\u003CT>): Promise\u003CResult\u003CT>> {\n  try {\n    const data = await fn();\n    return { ok: true, data };\n  } catch (err) {\n    const apiError = err as NavanApiError;\n    console.error(`Navan API error [${apiError.status}] ${apiError.endpoint}: ${apiError.message}`);\n    return { ok: false, error: apiError };\n  }\n}\n\n\u002F\u002F Usage\nconst result = await safeCall(() => navan.getUserTrips());\nif (result.ok) {\n  console.log(`Found ${result.data.length} trips`);\n} else {\n  console.error(`Failed: ${result.error.message}`);\n}\n```\n\n### Step 5: Python Equivalent Pattern\n\n```python\n# navan_client.py\nimport os\nimport time\nimport requests\nfrom dataclasses import dataclass\nfrom dotenv import load_dotenv\n\nload_dotenv()\n\n@dataclass\nclass NavanAPIError(Exception):\n    status: int\n    message: str\n    endpoint: str\n\nclass NavanAPI:\n    def __init__(self):\n        self.base_url = os.environ.get(\"NAVAN_BASE_URL\", \"https:\u002F\u002Fapi.navan.com\")\n        self.client_id = os.environ[\"NAVAN_CLIENT_ID\"]\n        self.client_secret = os.environ[\"NAVAN_CLIENT_SECRET\"]\n        self._token: str | None = None\n        self._token_expiry: float = 0\n\n    def _authenticate(self) -> str:\n        if self._token and time.time() \u003C self._token_expiry:\n            return self._token\n        resp = requests.post(f\"{self.base_url}\u002Fta-auth\u002Foauth\u002Ftoken\", data={\n            \"grant_type\": \"client_credentials\",\n            \"client_id\": self.client_id,\n            \"client_secret\": self.client_secret,\n        })\n        resp.raise_for_status()\n        data = resp.json()\n        self._token = data[\"access_token\"]\n        self._token_expiry = time.time() + data.get(\"expires_in\", 3600) - 60\n        return self._token\n\n    def _request(self, method: str, endpoint: str, **kwargs) -> dict:\n        token = self._authenticate()\n        for attempt in range(3):\n            resp = requests.request(method, f\"{self.base_url}{endpoint}\",\n                headers={\"Authorization\": f\"Bearer {token}\"}, **kwargs)\n            if resp.ok:\n                return resp.json()\n            if resp.status_code in (429, 503) and attempt \u003C 2:\n                time.sleep(2 ** (attempt + 1))\n                continue\n            if resp.status_code == 401 and attempt \u003C 2:\n                self._token = None\n                token = self._authenticate()\n                continue\n            raise NavanAPIError(resp.status_code, resp.text, endpoint)\n        raise NavanAPIError(0, \"Max retries exceeded\", endpoint)\n\n    def get_bookings(self, page: int = 0, size: int = 50) -> list[dict]:\n        return self._request(\"GET\", f\"\u002Fv1\u002Fbookings?page={page}&size={size}\").get(\"data\", [])\n\n    def get_users(self) -> list[dict]:\n        return self._request(\"GET\", \"\u002Fv1\u002Fusers\").get(\"data\", [])\n```\n\n## Output\n\nSuccessful implementation produces:\n- A typed `NavanAPI` class with automatic token refresh and retry logic\n- Response interfaces for trips, users, and errors\n- A singleton factory for client reuse across the application\n- A `safeCall` wrapper for structured error handling in calling code\n\n## Error Handling\n\n| Error | Code | Cause | Solution |\n|-------|------|-------|----------|\n| Invalid credentials | 401 | Expired token or wrong secrets | Client auto-retries with fresh token; check .env |\n| Forbidden | 403 | Insufficient permissions or wrong tier | Verify admin role; check Navan plan tier |\n| Not found | 404 | Invalid endpoint path | Verify endpoint against known paths in this guide |\n| Rate limited | 429 | Too many requests | Client auto-retries with exponential backoff |\n| Server error | 500 | Navan service issue | Client auto-retries; escalate if persistent |\n| Maintenance | 503 | Navan downtime | Client auto-retries; check for scheduled windows |\n\n## Examples\n\n**Fetch all bookings with error handling:**\n\n```typescript\nconst navan = getNavanClient();\nconst result = await safeCall(() => navan.getBookings());\nif (result.ok) {\n  const flights = result.data.filter((t) => t.booking_type === 'flight');\n  console.log(`${flights.length} flight bookings found`);\n}\n```\n\n## Resources\n\n- [Navan Help Center](https:\u002F\u002Fapp.navan.com\u002Fapp\u002Fhelpcenter) — primary documentation hub\n- [Navan TMC API Docs](https:\u002F\u002Fapp.navan.com\u002Fapp\u002Fhelpcenter\u002Farticles\u002Ftravel\u002Fadmin\u002Fother-integrations\u002Fnavan-tmc-api-integration-documentation) — endpoint reference\n- [Navan Integrations](https:\u002F\u002Fnavan.com\u002Fintegrations) — integration partner ecosystem\n- [Navan Security](https:\u002F\u002Fnavan.com\u002Fsecurity) — SOC 2 Type II, ISO 27001, PCI DSS Level 1\n\n## Next Steps\n\nWith your typed wrapper in place, see `navan-common-errors` for a comprehensive error reference, or `navan-local-dev-loop` to set up token caching and request logging for development.\n","# Navan SDK Patterns\n\n## Overview\n\nBuild a typed API wrapper around Navan REST endpoints since no official SDK exists (`@navan\u002Fsdk` is not a real package). These patterns provide automatic token lifecycle management, typed responses, retry middleware, and centralized error handling.\n\n**Purpose:** Create a reusable NavanAPI class encapsulating authentication, request handling, and error recovery.\n\n## Prerequisites\n\n- Completed `navan-install-auth` with working OAuth 2.0 credentials\n- TypeScript 5+ project with `dotenv` installed\n- Familiarity with the Navan endpoints from `navan-hello-world`\n\n## Instructions\n\n### Step 1: Define Response Interfaces\n\nType the known API response shapes so every call returns structured data:\n\n```typescript\n\u002F\u002F navan-types.ts\nexport interface NavanTrip {\n  uuid: string;\n  traveler_name: string;\n  origin: string;\n  destination: string;\n  departure_date: string;\n  return_date: string;\n  booking_status: string;\n  booking_type: 'flight' | 'hotel' | 'car';\n}\n\nexport interface NavanUser {\n  id: string;\n  email: string;\n  first_name: string;\n  last_name: string;\n  department: string;\n  role: string;\n}\n\nexport interface NavanApiError {\n  status: number;\n  message: string;\n  endpoint: string;\n  timestamp: string;\n}\n```\n\n### Step 2: Build the NavanAPI Wrapper Class\n\nCreate a singleton client with automatic token management:\n\n```typescript\n\u002F\u002F navan-client.ts\nimport 'dotenv\u002Fconfig';\nimport type { NavanTrip, NavanUser, NavanApiError } from '.\u002Fnavan-types';\n\nexport class NavanAPI {\n  private baseUrl: string;\n  private clientId: string;\n  private clientSecret: string;\n  private accessToken: string | null = null;\n  private tokenExpiry: number = 0;\n\n  constructor() {\n    this.baseUrl = process.env.NAVAN_BASE_URL ?? 'https:\u002F\u002Fapi.navan.com';\n    this.clientId = process.env.NAVAN_CLIENT_ID ?? '';\n    this.clientSecret = process.env.NAVAN_CLIENT_SECRET ?? '';\n    if (!this.clientId || !this.clientSecret) {\n      throw new Error('NAVAN_CLIENT_ID and NAVAN_CLIENT_SECRET must be set');\n    }\n  }\n\n  \u002F** Acquire or refresh the OAuth 2.0 bearer token *\u002F\n  private async authenticate(): Promise\u003Cstring> {\n    if (this.accessToken && Date.now() \u003C this.tokenExpiry) {\n      return this.accessToken;\n    }\n\n    const response = await fetch(`${this.baseUrl}\u002Fta-auth\u002Foauth\u002Ftoken`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application\u002Fx-www-form-urlencoded' },\n      body: new URLSearchParams({\n        grant_type: 'client_credentials',\n        client_id: this.clientId,\n        client_secret: this.clientSecret,\n      }),\n    });\n\n    if (!response.ok) {\n      throw this.toApiError(response.status, 'Authentication failed', '\u002Fta-auth\u002Foauth\u002Ftoken');\n    }\n\n    const data = await response.json();\n    this.accessToken = data.access_token;\n    \u002F\u002F Buffer 60 seconds before actual expiry\n    this.tokenExpiry = Date.now() + (data.expires_in - 60) * 1000;\n    return this.accessToken!;\n  }\n\n  \u002F** Core request method with auth, retries, and error handling *\u002F\n  private async request\u003CT>(endpoint: string, options: RequestInit = {}): Promise\u003CT> {\n    const token = await this.authenticate();\n    const url = `${this.baseUrl}${endpoint}`;\n\n    for (let attempt = 0; attempt \u003C 3; attempt++) {\n      const response = await fetch(url, {\n        ...options,\n        headers: {\n          Authorization: `Bearer ${token}`,\n          'Content-Type': 'application\u002Fjson',\n          ...options.headers,\n        },\n      });\n\n      if (response.ok) return response.json() as Promise\u003CT>;\n\n      \u002F\u002F Retry on 429 (rate limit) and 503 (maintenance)\n      if ((response.status === 429 || response.status === 503) && attempt \u003C 2) {\n        const delay = Math.pow(2, attempt + 1) * 1000; \u002F\u002F 2s, 4s\n        await new Promise((r) => setTimeout(r, delay));\n        continue;\n      }\n\n      \u002F\u002F Re-auth on 401 (expired token)\n      if (response.status === 401 && attempt \u003C 2) {\n        this.accessToken = null;\n        this.tokenExpiry = 0;\n        continue;\n      }\n\n      throw this.toApiError(response.status, await response.text(), endpoint);\n    }\n\n    throw this.toApiError(0, 'Max retries exceeded', endpoint);\n  }\n\n  private toApiError(status: number, message: string, endpoint: string): NavanApiError {\n    return { status, message, endpoint, timestamp: new Date().toISOString() };\n  }\n\n  \u002F\u002F --- Public API methods ---\n\n  async getBookings(page = 0, size = 50): Promise\u003CNavanTrip[]> {\n    const data = await this.request\u003C{ data: NavanTrip[] }>(`\u002Fv1\u002Fbookings?page=${page}&size=${size}`);\n    return data.data ?? [];\n  }\n\n  async getUsers(): Promise\u003CNavanUser[]> {\n    const data = await this.request\u003C{ data: NavanUser[] }>('\u002Fv1\u002Fusers');\n    return data.data ?? [];\n  }\n}\n```\n\n### Step 3: Implement a Singleton Factory\n\nEnsure one client instance per process to reuse the token:\n\n```typescript\n\u002F\u002F navan-singleton.ts\nimport { NavanAPI } from '.\u002Fnavan-client';\n\nlet instance: NavanAPI | null = null;\n\nexport function getNavanClient(): NavanAPI {\n  if (!instance) instance = new NavanAPI();\n  return instance;\n}\n\n\u002F\u002F Usage\nconst navan = getNavanClient();\nconst bookings = await navan.getBookings();\nconst users = await navan.getUsers();\n```\n\n### Step 4: Add Error Handling Middleware\n\nWrap API calls with structured error handling for calling code:\n\n```typescript\n\u002F\u002F navan-safe.ts\nimport type { NavanApiError } from '.\u002Fnavan-types';\n\ntype Result\u003CT> = { ok: true; data: T } | { ok: false; error: NavanApiError };\n\nexport async function safeCall\u003CT>(fn: () => Promise\u003CT>): Promise\u003CResult\u003CT>> {\n  try {\n    const data = await fn();\n    return { ok: true, data };\n  } catch (err) {\n    const apiError = err as NavanApiError;\n    console.error(`Navan API error [${apiError.status}] ${apiError.endpoint}: ${apiError.message}`);\n    return { ok: false, error: apiError };\n  }\n}\n\n\u002F\u002F Usage\nconst result = await safeCall(() => navan.getUserTrips());\nif (result.ok) {\n  console.log(`Found ${result.data.length} trips`);\n} else {\n  console.error(`Failed: ${result.error.message}`);\n}\n```\n\n### Step 5: Python Equivalent Pattern\n\n```python\n# navan_client.py\nimport os\nimport time\nimport requests\nfrom dataclasses import dataclass\nfrom dotenv import load_dotenv\n\nload_dotenv()\n\n@dataclass\nclass NavanAPIError(Exception):\n    status: int\n    message: str\n    endpoint: str\n\nclass NavanAPI:\n    def __init__(self):\n        self.base_url = os.environ.get(\"NAVAN_BASE_URL\", \"https:\u002F\u002Fapi.navan.com\")\n        self.client_id = os.environ[\"NAVAN_CLIENT_ID\"]\n        self.client_secret = os.environ[\"NAVAN_CLIENT_SECRET\"]\n        self._token: str | None = None\n        self._token_expiry: float = 0\n\n    def _authenticate(self) -> str:\n        if self._token and time.time() \u003C self._token_expiry:\n            return self._token\n        resp = requests.post(f\"{self.base_url}\u002Fta-auth\u002Foauth\u002Ftoken\", data={\n            \"grant_type\": \"client_credentials\",\n            \"client_id\": self.client_id,\n            \"client_secret\": self.client_secret,\n        })\n        resp.raise_for_status()\n        data = resp.json()\n        self._token = data[\"access_token\"]\n        self._token_expiry = time.time() + data.get(\"expires_in\", 3600) - 60\n        return self._token\n\n    def _request(self, method: str, endpoint: str, **kwargs) -> dict:\n        token = self._authenticate()\n        for attempt in range(3):\n            resp = requests.request(method, f\"{self.base_url}{endpoint}\",\n                headers={\"Authorization\": f\"Bearer {token}\"}, **kwargs)\n            if resp.ok:\n                return resp.json()\n            if resp.status_code in (429, 503) and attempt \u003C 2:\n                time.sleep(2 ** (attempt + 1))\n                continue\n            if resp.status_code == 401 and attempt \u003C 2:\n                self._token = None\n                token = self._authenticate()\n                continue\n            raise NavanAPIError(resp.status_code, resp.text, endpoint)\n        raise NavanAPIError(0, \"Max retries exceeded\", endpoint)\n\n    def get_bookings(self, page: int = 0, size: int = 50) -> list[dict]:\n        return self._request(\"GET\", f\"\u002Fv1\u002Fbookings?page={page}&size={size}\").get(\"data\", [])\n\n    def get_users(self) -> list[dict]:\n        return self._request(\"GET\", \"\u002Fv1\u002Fusers\").get(\"data\", [])\n```\n\n## Output\n\nSuccessful implementation produces:\n- A typed `NavanAPI` class with automatic token refresh and retry logic\n- Response interfaces for trips, users, and errors\n- A singleton factory for client reuse across the application\n- A `safeCall` wrapper for structured error handling in calling code\n\n## Error Handling\n\n| Error | Code | Cause | Solution |\n|-------|------|-------|----------|\n| Invalid credentials | 401 | Expired token or wrong secrets | Client auto-retries with fresh token; check .env |\n| Forbidden | 403 | Insufficient permissions or wrong tier | Verify admin role; check Navan plan tier |\n| Not found | 404 | Invalid endpoint path | Verify endpoint against known paths in this guide |\n| Rate limited | 429 | Too many requests | Client auto-retries with exponential backoff |\n| Server error | 500 | Navan service issue | Client auto-retries; escalate if persistent |\n| Maintenance | 503 | Navan downtime | Client auto-retries; check for scheduled windows |\n\n## Examples\n\n**Fetch all bookings with error handling:**\n\n```typescript\nconst navan = getNavanClient();\nconst result = await safeCall(() => navan.getBookings());\nif (result.ok) {\n  const flights = result.data.filter((t) => t.booking_type === 'flight');\n  console.log(`${flights.length} flight bookings found`);\n}\n```\n\n## Resources\n\n- [Navan Help Center](https:\u002F\u002Fapp.navan.com\u002Fapp\u002Fhelpcenter) — primary documentation hub\n- [Navan TMC API Docs](https:\u002F\u002Fapp.navan.com\u002Fapp\u002Fhelpcenter\u002Farticles\u002Ftravel\u002Fadmin\u002Fother-integrations\u002Fnavan-tmc-api-integration-documentation) — endpoint reference\n- [Navan Integrations](https:\u002F\u002Fnavan.com\u002Fintegrations) — integration partner ecosystem\n- [Navan Security](https:\u002F\u002Fnavan.com\u002Fsecurity) — SOC 2 Type II, ISO 27001, PCI DSS Level 1\n\n## Next Steps\n\nWith your typed wrapper in place, see `navan-common-errors` for a comprehensive error reference, or `navan-local-dev-loop` to set up token caching and request logging for development.\n",{"name":5,"tags":24,"author":28,"license":15,"version":29,"description":30,"allowed-tools":31,"compatible-with":32},[25,26,27],"saas","navan","travel","Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Build a typed API wrapper around Navan REST endpoints since no official SDK exists.\nUse when you need production-grade API access with auto token refresh, retry logic, and typed responses.\nTrigger with \"navan sdk patterns\", \"navan api wrapper\", \"navan client class\", \"navan typed client\".\n","Read, Write, Edit, Bash(npm:*), Grep","claude-code","main","99825ad3f3bcc6597ddcc7294a14e6e922f2b67b","skills\u002Fsaas-packs--navan-pack--navan-sdk-patterns",0,"https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills","https:\u002F\u002Fgithub.com\u002Fjukeyman","https:\u002F\u002FRJBUSINESSSOLUTIONS.ORG","Credit and Finance Expert | Developer\r\n\r\nI'm Rick Jefferson, a seasoned credit and finance expert with over a decade of experience in financial literacy,","2026-07-13 07:03:29",{"source":8,"skillName":5,"commands":43,"prompt":53,"zipAvailable":54},[44,47,50],{"tool":45,"command":46},"npx","npx skills add jukeyman\u002Fjukeyman-skills --skill navan-sdk-patterns",{"tool":48,"command":49},"bunx","bunx skills add jukeyman\u002Fjukeyman-skills --skill navan-sdk-patterns",{"tool":51,"command":52},"pnpm","pnpm dlx skills add jukeyman\u002Fjukeyman-skills --skill navan-sdk-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--navan-pack--navan-sdk-patterns\u002FSKILL.md",true,[],[57,64,71,78,85,93],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M79ANS2SM329NEP5ZCX106RR","zustand-store-creator","Create zustand store creator operations. Auto-activating skill for Frontend Development.\nTriggers on: zustand store creator, zustand store creator\nPart of the Frontend Development skill category. Use when working with zustand store creator functionality. Trigger with phrases like \"zustand store creator\", \"zustand creator\", \"zustand\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzustand-store-creator\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M79AMZKP4YDEZ7EHG1Y7PP74","zero-trust-config-helper","Configure with zero trust config helper operations. Auto-activating skill for Security Advanced.\nTriggers on: zero trust config helper, zero trust config helper\nPart of the Security Advanced skill category. Use when configuring systems or services. Trigger with phrases like \"zero trust config helper\", \"zero helper\", \"zero\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzero-trust-config-helper\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M79AMJSBCEJQNBTYNAHYN5HM","zapier-integration-helper","Assist with zapier integration helper operations. Auto-activating skill for Business Automation.\nTriggers on: zapier integration helper, zapier integration helper\nPart of the Business Automation skill category. Use when working with APIs or building integrations. Trigger with phrases like \"zapier integration helper\", \"zapier helper\", \"zapier\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzapier-integration-helper\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M79AHJZGVMARS13VFQYRR1MP","yaml-config-validator","Validate yaml config validator operations. Auto-activating skill for DevOps Basics.\nTriggers on: yaml config validator, yaml config validator\nPart of the DevOps Basics skill category. Use when configuring systems or services. Trigger with phrases like \"yaml config validator\", \"yaml validator\", \"yaml\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fyaml-config-validator\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":89,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M79AHGDZRN0020RDQSQDPAM8","xvary-stock-research","Thesis-driven equity analysis from public SEC EDGAR and market data; \u002Fanalyze, \u002Fscore, \u002Fcompare workflows with bundled Python tools (Claude Code, Cursor, Codex).","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M79AHCYJ9FV9RMHQ24HDRN33","xss-vulnerability-scanner","Scan xss vulnerability scanner operations. Auto-activating skill for Security Fundamentals.\nTriggers on: xss vulnerability scanner, xss vulnerability scanner\nPart of the Security Fundamentals skill category. Use when working with xss vulnerability scanner functionality. Trigger with phrases like \"xss vulnerability scanner\", \"xss scanner\", \"xss\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxss-vulnerability-scanner\u002FSKILL.md",[],[]]