# Strapi Content Source

The `strapiSource` content source is used to fetch data from Strapi CMS. It supports Strapi v3, v4, and v5, with automatic pagination and customizable query parameters.

## Usage

To use the `strapiSource` content source, include it in the list of content sources in your configuration:

```typescript
import { strapiSource } from '@bluecadet/launchpad/content/sources/strapi';

export default defineConfig({
  plugins: [
    content({
      sources: [
        strapiSource({
          id: 'myStrapiSource',
          baseUrl: 'http://localhost:1337',
          identifier: 'admin@example.com',
          password: 'your-password',
          queries: ['api/articles', 'api/categories']
        })
      ]
    })
  ]
});
```

## Options

### `id`

- **Type:** `string`
- **Required**

Specifies the unique identifier for this source. This will be used as the download path.

### `version`

- **Type:** `"3" | "4" | "5"`
- **Default:** `"5"`

Specifies the Strapi version. Supports version 3, 4, or 5. Strapi v5 flattens entry attributes to the top level of each entry (alongside a `documentId`), rather than nesting them under `attributes` as v4 does; this source passes v5 entries through as-is. If you’re on an older Strapi instance, set this explicitly to `"3"` or `"4"`.

### `baseUrl`

- **Type:** `string`
- **Required**

The base URL of your Strapi CMS (with or without trailing slash).

### `queries`

- **Type:** `(string | { contentType: string, params: Record<string, any> })[]`
- **Required**

Queries for each type of content you want to fetch. You can specify either:

- A string URL path (e.g. `"api/articles"`)
- An object with `contentType` and `params` for more control over the query parameters

### `identifier`

- **Type:** `string`
- **Required if token not provided**

Username or email for authentication. Should be configured via environment variables.

### `password`

- **Type:** `string`
- **Required if token not provided**

Password for authentication. Should be configured via environment variables.

### `token`

- **Type:** `string`
- **Required if identifier/password not provided**

A previously generated JWT token for authentication.

### `limit`

- **Type:** `number`
- **Default:** `100`

Maximum number of entries to fetch per page.

### `maxNumPages`

- **Type:** `number`
- **Default:** `1000`

Maximum number of pages to fetch.

### `pageNumZeroPad`

- **Type:** `number`
- **Default:** `2`

Number of zeros to pad each JSON filename index with.