Directus SDK Types Generator

Opinionated CLI tool and library to generate TypeScript types from Directus collections to use with the Directus SDK.

Generates the individual interfaces for the Directus collections and a Schema type that collects all the interfaces together for use with the Directus SDK.

Example

Generate the types from the CLI.

``bash
npx directus-sdk-typegen -u http://localhost:8055 -t your-token-here -o ./my-schema.ts
`

`typescript
// my-schema.ts
export interface Event {
/* @required /
id: string;
status?: 'draft' | 'active' | 'past';
sort?: number | null;
user_created?: DirectusUser | string | null;
date_created?: string | null;
user_updated?: DirectusUser | string | null;
date_updated?: string | null;
/* @description Name of the event. @required /
title: string;
/* @required /
slug: string;
/* @description When does this event start? @required /
start_at: string;
/* @description When does this event end? /
end_at?: string | null;
/* @description Short description of the event. Used in SEO meta description. /
description?: string | null;
featured_image?: DirectusFile | string | null;
timezone?: string | null;
location?: 'whereby' | 'youtube' | 'other' | null;
location_url?: string | null;
location_youtube?: string | null;
recording_url?: string | null;
content?: string | null;
location_whereby?: any | null;
custom_registration_questions?: EventCustomRegistrationQuestion[] | string[];
emails?: EventEmail[] | string[];
feedback?: EventFeedback[] | string[];
registrants?: EventRegistration[] | string[];
hosts?: EventHost[] | string[];
}

export interface Schema {
events: Event[]
}
`

Then use the generated types with the Directus SDK.

`typescript
import type { Schema } from './my-schema';

import {
createDirectus,
rest
} from '@directus/sdk';

const directus = createDirectus('http://localhost:8055').with(rest())
`

Installation

You can run the CLI tool using npx or install it globally.

`bash
npx directus-sdk-typegen -u http://localhost:8055 -t your-token-here -o ./my-schema.ts
`

or

`bash
npm install -g directus-sdk-typegen
`

`bash
directus-sdk-typegen -u http://localhost:8055 -t your-token-here -o ./my-schema.ts
`

Usage

You can use the Directus Type Generator as a CLI tool or as a library in your Node.js application.

$3

To generate TypeScript types from Directus collections, use the following command:

`bash
npx directus-sdk-typegen --url --token --output
`

#### Options
- -o, --output : Specify the output file path including filename (default: ./directus-schema.ts).
- -u, --url : Directus API URL (default: http://localhost:8055).
- -t, --token : Directus API token. Needs Adminstrator permissions (default: your-token-here).

$3

You can also use the generator programmatically in your Node.js application:

`typescript
// Output to a file
import { generateDirectusTypes } from 'directus-sdk-typegen';

async function generateTypes() {
try {
await generateDirectusTypes({
outputPath: './my-schema.ts',
directusUrl: 'http://localhost:8055',
directusToken: 'your-token-here',
});
} catch (error) {
console.error('Failed to generate types:', error);
}
}

generateTypes();
`

`typescript
// Return types as a variable
import { generateDirectusTypes } from 'directus-sdk-typegen';

async function generateTypes() {
try {
const types = await generateDirectusTypes({
directusUrl: 'http://localhost:8055',
directusToken: 'your-token-here',
});
// Do something else with the types
console.log(types);
} catch (error) {
console.error('Failed to generate types:', error);
}
}
``

Contributing

Happy to accept contributions that improve the types generated! But please open an issue first to discuss changes.

License

This project is licensed under the MIT License.