YPE-1099: React-Hooks-Add useLanguage hook to get information for a specific language.

[bmanquen]

Add a hook to get a specific language.

[changeset-bot]

🦋 Changeset detected

Latest commit: 18efea4

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 4 packages

Name	Type
@youversion/platform-react-hooks	Minor
@youversion/platform-core	Minor
@youversion/platform-react-ui	Minor
nextjs	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[chatgpt-codex-connector]

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Credits must be used to enable repository wide code reviews.

[greptile-apps]

Greptile Overview

Greptile Summary

Added useLanguage hook to fetch a single language by ID from the Platform API, along with a refactored useLanguagesClient hook for better code reuse.

Key Changes

• Created useLanguage hook following the established pattern from useVersion (fetches single language by ID)
• Extracted useLanguagesClient hook from useLanguages to eliminate duplicate client creation logic
• Renamed default_bible_version_id to default_bible_id in the Language schema for better API consistency
• Refactored useLanguages to use the new useLanguagesClient hook (DRY principle)
• Added comprehensive test coverage for both new hooks
• Enhanced vitest coverage configuration to track all source files

Architecture

The implementation properly follows the established monorepo patterns: core package contains the API client and schemas (pure TypeScript), hooks package provides React integration, and workspace dependencies use the workspace:* protocol. The new hooks follow the same composition pattern as existing hooks like useVersion and useBibleClient.

Confidence Score: 5/5

• This PR is safe to merge with no identified issues
• The implementation follows all established patterns, includes comprehensive tests, maintains proper dependency order, and improves code quality through refactoring. The schema change is backward-compatible within the same version bump, and all changes are well-tested.
• No files require special attention

Important Files Changed

Filename	Overview
packages/core/src/schemas/language.ts	Renamed default_bible_version_id to default_bible_id for consistency
packages/hooks/src/useLanguageClient.ts	New client hook for LanguagesClient following established pattern from useBibleClient
packages/hooks/src/useLanguage.ts	New hook to fetch a single language by ID, following pattern from useVersion hook
packages/hooks/src/useLanguages.ts	Refactored to use useLanguagesClient hook, removing duplicate client creation logic
packages/hooks/vitest.config.ts	Added coverage configuration to include all source files and generate comprehensive reports

Sequence Diagram

sequenceDiagram
    participant App as React Component
    participant useLanguage as useLanguage Hook
    participant useLanguagesClient as useLanguagesClient Hook
    participant useApiData as useApiData Hook
    participant LanguagesClient as LanguagesClient
    participant ApiClient as ApiClient
    participant API as Platform API

    App->>useLanguage: Call useLanguage(languageId, options)
    useLanguage->>useLanguagesClient: Get LanguagesClient instance
    useLanguagesClient->>YouVersionContext: useContext()
    YouVersionContext-->>useLanguagesClient: {appKey, apiHost, installationId}
    useLanguagesClient->>ApiClient: new ApiClient(config)
    ApiClient-->>useLanguagesClient: apiClient instance
    useLanguagesClient->>LanguagesClient: new LanguagesClient(apiClient)
    LanguagesClient-->>useLanguagesClient: languagesClient instance
    useLanguagesClient-->>useLanguage: Return memoized client
    
    useLanguage->>useApiData: Call with fetch function and deps
    useApiData->>LanguagesClient: getLanguage(languageId)
    LanguagesClient->>LanguagesClient: Validate languageId (Zod schema)
    LanguagesClient->>ApiClient: get(`/v1/languages/${languageId}`)
    ApiClient->>API: HTTP GET /v1/languages/{languageId}
    API-->>ApiClient: Language data
    ApiClient-->>LanguagesClient: Language object
    LanguagesClient-->>useApiData: Language object
    useApiData-->>useLanguage: {data, loading, error, refetch}
    useLanguage-->>App: {language, loading, error, refetch}

Loading

[greptile-apps]

_{1 file reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}

[greptile-apps]

Additional Comments (1)

packages/hooks/src/index.ts
Missing exports for new hooks - add these lines:

export * from './useLanguages';
export * from './useLanguage';
export * from './useLanguageClient';

Prompt To Fix With AI

This is a comment left during a code review.
Path: packages/hooks/src/index.ts
Line: 20:20

Comment:
Missing exports for new hooks - add these lines:

```suggestion
export * from './useLanguages';
export * from './useLanguage';
export * from './useLanguageClient';
```

How can I resolve this? If you propose a fix, please make it concise.

[bmanquen]

@greptileai

[greptile-apps]

_{No files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}