toolbox-browser-api-integration

스타12

포크9

업데이트2026년 7월 7일 14:51

Implementation patterns for the Vault Toolbox Browser Extension (Manifest V3).

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

출처

veeva

veeva/Vault-Toolbox

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Skill: toolbox-browser-api-integration

This skill provides the procedural knowledge for integrating Vault APIs within a Manifest V3 Chrome Extension.

1. Authentication Flow (Manifest V3)

Storage: Session ID is stored in an HTTP-only Chrome cookie (vaultToolboxSessionId) scoped to the vaultDNS.
Authorization: The request wrapper intercepts calls to query the cookie API (chrome.cookies.get) and inject the Authorization header.
Keep-Alive: Use useVaultSessionKeepAlive.ts to periodically ping the /keep-alive endpoint.

2. API Architecture

Facade Pattern: Centralized in src/app/services/ApiService.js.
VAPIL Entry (Default): Reusable APIs (Metadata, Query) MUST be added to src/app/services/vapil/.
Direct Fetch Forbidden: Never use window.fetch directly; use the request wrapper in VaultRequest.js.
Credentials: Always set credentials: 'omit' in the request wrapper.

3. Telemetry & Normalization

ApiService.js MUST normalize all errors and include telemetry:

{ 
  responseStatus: 'FAILURE', 
  errors: [{ type: 'ErrorType', message: 'Readable message' }],
  responseTelemetry: { responseSizeInKB, executionTimeInMS }
}

이 저장소의 다른 Skills

같은 저장소

toolbox-browser-brainstormer

veeva/Vault-Toolbox

Specialized design challenges for the Vault Toolbox Browser Extension, focusing on VQL prototyping.

2026-07-0712

toolbox-browser-code-reviewer

veeva/Vault-Toolbox

Specialized audit for the Vault Toolbox Browser Extension, focusing on Island Architecture and UI visibility.

2026-07-0712

toolbox-browser-data-grid

veeva/Vault-Toolbox

Specialized data grid implementation for the Vault Toolbox Browser Extension using TanStack Table/Virtual.

2026-07-0712

toolbox-browser-feature-designer

veeva/Vault-Toolbox

Specialized design requirements for the Vault Toolbox Browser Extension, focusing on UI visibility.

2026-07-0712

toolbox-browser-testing

veeva/Vault-Toolbox

Specialized testing and dev-server protocol for the Vault Toolbox Browser Extension.

2026-07-0712

toolbox-browser-tool-builder

veeva/Vault-Toolbox

Specialized scaffolding and shell integration for the Vault Toolbox Browser Extension.

2026-07-0712

name	toolbox-browser-api-integration
description	Implementation patterns for the Vault Toolbox Browser Extension (Manifest V3).
applicable_apps	["toolbox-browser"]

Skill: toolbox-browser-api-integration

This skill provides the procedural knowledge for integrating Vault APIs within a Manifest V3 Chrome Extension.

1. Authentication Flow (Manifest V3)

Storage: Session ID is stored in an HTTP-only Chrome cookie (vaultToolboxSessionId) scoped to the vaultDNS.
Authorization: The request wrapper intercepts calls to query the cookie API (chrome.cookies.get) and inject the Authorization header.
Keep-Alive: Use useVaultSessionKeepAlive.ts to periodically ping the /keep-alive endpoint.

2. API Architecture

Facade Pattern: Centralized in src/app/services/ApiService.js.
VAPIL Entry (Default): Reusable APIs (Metadata, Query) MUST be added to src/app/services/vapil/.
Direct Fetch Forbidden: Never use window.fetch directly; use the request wrapper in VaultRequest.js.
Credentials: Always set credentials: 'omit' in the request wrapper.

3. Telemetry & Normalization

ApiService.js MUST normalize all errors and include telemetry:

{ 
  responseStatus: 'FAILURE', 
  errors: [{ type: 'ErrorType', message: 'Readable message' }],
  responseTelemetry: { responseSizeInKB, executionTimeInMS }
}