# Newtonsoft.Json

**Kind:** Service

**Source:** `Pams/HelperTool/HelperTool.csproj` (line 1)

**Part of:** [Pams](subsystem-pams)

NuGet package dependency

`Newtonsoft.Json` is a NuGet package dependency declared by `Pams/HelperTool/HelperTool.csproj`. The HelperTool uses it to serialize .NET objects to JSON and deserialize JSON content into typed .NET models when reading or exchanging data.

## Diagram

```mermaid
sequenceDiagram
    participant HelperTool
    participant NewtonsoftJson as Newtonsoft.Json
    participant JsonData as JSON Data

    HelperTool->>NewtonsoftJson: Serialize .NET object
    NewtonsoftJson-->>JsonData: JSON text
    JsonData->>NewtonsoftJson: JSON text
    NewtonsoftJson-->>HelperTool: Deserialize typed object
```

## Usage

```typescript
type HelperToolRequest = {
  name: string;
  enabled: boolean;
};

const request: HelperToolRequest = {
  name: "Example",
  enabled: true,
};

const json = JSON.stringify(request);
const parsed = JSON.parse(json) as HelperToolRequest;

console.log(parsed.name);
```

## AI Coding Instructions

- Keep `Newtonsoft.Json` references declared through `Pams/HelperTool/HelperTool.csproj`.
- Use explicit .NET models when deserializing JSON so expected fields and types are clear.
- Handle invalid or missing JSON input before deserializing external content.
- Keep JSON property naming consistent with the data format consumed by HelperTool.