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.

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

// 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.

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

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

const directus = createDirectus<Schema>('http://localhost:8055').with(rest())

Installation

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

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

or

npm install -g directus-sdk-typegen

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.

CLI Usage

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

npx directus-sdk-typegen --url <DIRECTUS_API_URL> --token <DIRECTUS_API_TOKEN> --output <OUTPUT_FILE_PATH>

Options

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

Library Usage

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

// 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();

// 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.