# @wyattjoh/jsr

[![JSR](https://jsr.io/badges/@wyattjoh/jsr)](https://jsr.io/@wyattjoh/jsr) [![JSR Score](https://jsr.io/badges/@wyattjoh/jsr/score)](https://jsr.io/@wyattjoh/jsr) [![JSR Scope](https://jsr.io/badges/@wyattjoh)](https://jsr.io/@wyattjoh)

A Deno library for interacting with the JSR (JavaScript Registry) API. This package provides a clean, type-safe API for searching packages, managing versions, and accessing registry metadata.

## Installation

```bash
deno add @wyattjoh/jsr
```

## Usage

```typescript
import {
  createJSRConfig,
  getPackage,
  getPackageVersion,
  listPackageVersions,
  searchPackages,
} from "@wyattjoh/jsr";

// Create a configuration
const config = createJSRConfig({
  apiToken: "your-api-token", // optional, for authenticated operations
});

// Search for packages
const results = await searchPackages(config, "react", 10);

// Get package details
const pkg = await getPackage(config, "deno", "std");

// Get specific version
const version = await getPackageVersion(config, "deno", "std", "1.0.0");

// List all versions
const versions = await listPackageVersions(config, "deno", "std");
```

## Features

- **Package Search**: Full-text search across the JSR registry
- **Package Management**: Create, update, and delete packages (with auth)
- **Version Control**: Manage package versions and dependencies
- **Scope Management**: Create and manage JSR scopes
- **Member Management**: Invite and manage scope members
- **Type-Safe**: Full TypeScript support with Zod validation
- **Comprehensive API**: Complete coverage of JSR API endpoints

## API Reference

### Configuration

```typescript
createJSRConfig(options?: ConfigOptions): JSRConfig
testConnection(config: JSRConfig): Promise<boolean>
```

### Packages

```typescript
searchPackages(config: JSRConfig, query?: string, limit?: number, page?: number): Promise<SearchResults>
getPackage(config: JSRConfig, scope: string, name: string): Promise<Package>
getPackageVersion(config: JSRConfig, scope: string, name: string, version: string): Promise<PackageVersion>
listPackageVersions(config: JSRConfig, scope: string, name: string, limit?: number, page?: number): Promise<PackageVersion[]>
getPackageMetadata(config: JSRConfig, scope: string, name: string): Promise<PackageMetadata>
getPackageDependencies(config: JSRConfig, scope: string, name: string, version: string): Promise<Dependencies>
getPackageScore(config: JSRConfig, scope: string, name: string): Promise<PackageScore>
getPackageDependents(config: JSRConfig, scope: string, name: string, options?: DependentsOptions): Promise<Dependents>
createPackage(config: JSRConfig, scope: string, name: string, description?: string): Promise<Package>
updatePackage(config: JSRConfig, scope: string, name: string, updates: PackageUpdates): Promise<Package>
deletePackage(config: JSRConfig, scope: string, name: string): Promise<void>
```

### Package Versions

```typescript
createPackageVersion(config: JSRConfig, scope: string, name: string, version: string, config?: object, files?: File[]): Promise<PackageVersion>
updatePackageVersion(config: JSRConfig, scope: string, name: string, version: string, yanked: boolean): Promise<PackageVersion>
```

### Scopes

```typescript
getScope(config: JSRConfig, scope: string): Promise<Scope>
listScopePackages(config: JSRConfig, scope: string, limit?: number, page?: number): Promise<Package[]>
createScope(config: JSRConfig, scope: string, description?: string): Promise<Scope>
updateScope(config: JSRConfig, scope: string, settings: ScopeSettings): Promise<Scope>
deleteScope(config: JSRConfig, scope: string): Promise<void>
```

### Members & Invites

```typescript
listScopeMembers(config: JSRConfig, scope: string): Promise<ScopeMember[]>
addScopeMember(config: JSRConfig, scope: string, githubLogin: string): Promise<void>
updateScopeMember(config: JSRConfig, scope: string, userId: string, isAdmin: boolean): Promise<void>
removeScopeMember(config: JSRConfig, scope: string, userId: string): Promise<void>
listScopeInvites(config: JSRConfig, scope: string): Promise<ScopeInvite[]>
deleteScopeInvite(config: JSRConfig, scope: string, userId: string): Promise<void>
acceptScopeInvite(config: JSRConfig, scope: string): Promise<void>
declineScopeInvite(config: JSRConfig, scope: string): Promise<void>
```

### Users

```typescript
getCurrentUser(config: JSRConfig): Promise<User>
getCurrentUserScopes(config: JSRConfig): Promise<Scope[]>
getCurrentUserScopeMember(config: JSRConfig, scope: string): Promise<ScopeMember>
getCurrentUserInvites(config: JSRConfig): Promise<ScopeInvite[]>
getUser(config: JSRConfig, id: string): Promise<User>
getUserScopes(config: JSRConfig, id: string): Promise<Scope[]>
```

### Registry

```typescript
listPackages(config: JSRConfig, options?: ListOptions): Promise<Package[]>
getStats(config: JSRConfig): Promise<RegistryStats>
```

### Publishing

```typescript
getPublishingTask(config: JSRConfig, taskId: string): Promise<PublishingTask>
```

### Authorization

```typescript
createAuthorization(config: JSRConfig, params: AuthorizationParams): Promise<Authorization>
getAuthorizationDetails(config: JSRConfig, code: string): Promise<AuthorizationDetails>
approveAuthorization(config: JSRConfig, code: string): Promise<void>
denyAuthorization(config: JSRConfig, code: string): Promise<void>
exchangeAuthorizationCode(config: JSRConfig, code: string, exchangeToken: string): Promise<TokenResponse>
```

## Authentication

Some operations require authentication via JSR API token:

```typescript
import { createJSRConfig, createPackage } from "@wyattjoh/jsr";

// Create a config with your JSR API token
const config = createJSRConfig({
  apiToken: "your-api-token",
});

// Now you can perform authenticated operations
await createPackage(config, "my-scope", "my-package", "Package description");
```

## Configuration

The client can be configured with custom URLs:

```typescript
import { createJSRConfig } from "@wyattjoh/jsr";

const config = createJSRConfig({
  apiUrl: "https://api.jsr.io",
  registryUrl: "https://jsr.io",
  apiToken: "your-api-token", // optional
});
```

## Requirements

- Deno 2.x or later
- Network access to JSR API
- JSR API token for authenticated operations

## License

MIT