
```ts
// Create a DrupalClient.
const drupal = new DrupalClient("http://drupal.org", {
	auth: {} // Authentication
	fetcher: {} // Custom fetcher
	cache: {} // Cache support
	serializer: {} // Custom serializer
})
```

```ts
// Fetch an article.
const article = await drupal.getResource(
	"node--article",
	"907034d4-ab35-4949-84e4-d2b7afed82df"
)
```

```ts
// Create an article
const article = await drupal.createResource("node--article", {
	attributes: {
		title: "Title of Article",
		body: {
			value: "<p>Content of body field</p>",
			format: "full_html",
		},
	},
})
```


JSON:API Client


```tsx
// Fetch an article.
const article = await drupal.getResource(
	"node--article",
	"907034d4-ab35-4949-84e4-d2b7afed82df"
)
```

```ts
// Fetch a collection of terms.
const tags = await drupal.getResourceCollection("taxonomy_term--tags")
```

```ts
// Fetch a menu.
const main = await drupal.getMenu("main")
```

```ts
// Fetch a view.
const recentContent = await drupal.getView("content_recent--block")
```

```ts
// Use filters.
const sortedPublishArticles = await drupal.getResourceCollection("node--article", {
	params: {
		"filter[status]": "1",
		sorted: "-created",
	},
})
```


Data Fetching


```ts
// Create an article.
const article = await drupal.createResource("node--article", {
	attributes: {
		title: "Title of Article",
		body: {
			value: "<p>Content of body field</p>",
			format: "full_html",
		},
	},
})
```

```ts
// Update article.
const article = await drupal.updateResource(
	"node--article",
	"a937dd34-5407-4fff-8594-fccaaa5bb72a",
	{
		data: {
			attributes: {
				title: "Title of Article",
			},
		},
	}
)
```

```ts
// Delete article.
const deleted = await drupal.deleteResource(
	"node--article",
	"a937dd34-5407-4fff-8594-fccaaa5bb72a"
)
```


CRUD Support


```ts
// Get the `es` translation for a page by uuid.
const page = await drupal.getResource(
	"node--page",
	"07464e9f-9221-4a4f-b7f2-01389408e6c8",
	{
		locale: "es",
		defaultLocale: "en",
	}
)
```

```ts
// Fetch a collection of translated articles.
const articles = await drupal.getResourceCollection("node--article", {
	locale: "es",
	defaultLocale: "en",
})
```

```ts
// Fetch translated menu items.
const main = await drupal.getMenu("main", {
	locale: "es",
	defaultLocale: "en",
})
```


Internationalization


```ts
// Bearer token.
export const drupal = new DrupalClient(process.env.NEXT_PUBLIC_DRUPAL_BASE_URL, {
	auth: {
		clientId: process.env.DRUPAL_CLIENT_ID,
		clientSecret: process.env.DRUPAL_CLIENT_SECRET,
	},
})
```

```ts
// Basic.
export const drupal = new DrupalClient(process.env.NEXT_PUBLIC_DRUPAL_BASE_URL, {
	auth: {
		username: process.env.DRUPAL_USERNAME,
		password: process.env.DRUPAL_PASSWORD,
	},
})
```

```ts
// Bring your own.
export const drupal = new DrupalClient(process.env.NEXT_PUBLIC_DRUPAL_BASE_URL, {
	auth: () => {
		// Do something and return an Authorization header.
	},
})
```


Authentication


```ts
// DrupalNode
const article = await drupal.getResource<DrupalNode>(
	"node--article",
	"907034d4-ab35-4949-84e4-d2b7afed82df"
)
```

```ts
// DrupalTaxonomyTerm
const tags = await drupal.getResourceCollection<DrupalTaxonomyTerm[]>(
	"taxonomy_term--tags"
)
```

```ts
// Any resource type.
const resources = await drupal.getResourceCollection<JsonApiResource[]>("entity--bundle")
```


Getting Started

Architecture

Configuration

Building Pages

Cross Content

Caching

Front

Features

Vactory Next Optimisation

Vactory Next Changelog

Deployment

Vactory V4 NextJs

Static / Dynamic content

Instant Publishing

Multi-theme

Authentication

Webforms

Search API

Internationalization

CI/CD

Security