@d0-it/core

d0-it - simple and hackable templates and code generation.

_THIS IS ALPHA - USE AT OWN RISK!_

Installation

npm install @d0-it/core

Packages

| Package | Description | Status |
| :------------------------------------------------- | :---------------------------------------: | ------------------: |
| @d0-it/core | Main core utilities and functions | Working |
| @d0-it/code | Mutate and inject code | Not Working |
| @d0-it/from | Plugins to input from different filetypes | Basic Functionality |
| @d0-it/graphql | Functions to manipulate graphql | Basic Functionality |
| @d0-it/prettier | Output code and clean up | Basic Functionality |
| @d0-it/pull | Download or pull code | Basic Functionality |
| @d0-it/typescript | AST and processors for typescript | Not Working |
| @d0-it/walker | Plugin to create AST visitors | Basic Functionality |

Examples

See e2e-tests package

$3

``typescript
it('generate a type - flexible typing', async () => {
let fileName = rndFileName();
let outFileName = rndFileNameTS();

await writeFile(
fileName,
/ graphql /
type Post {
id: ID!
comments: [Comment]
content: String
}

type Comment {
id: ID!
postId: ID!
message: String
}

);

const gqlTypeToTs = (type: string) => {
switch (type) {
case 'String':
return 'string';
case 'Int':
return 'number';
case 'Float':
return 'number';
case 'ID':
return 'string';
default:
return type;
}
};

let resCtx: any = await d0(ctx => {
return sequence([
loadGraphQL('gql', fileName),
graphQLSummary('summary', ctx => ctx.gql),
each(
ctx => ctx.summary,
[
item =>
eachEntry(
() => item.fields,
[
(name, type) =>
push(
'typeMaps',
ctx =>
${name}${type.nullable ? '?' : ''}: ${gqlTypeToTs(type.type)}${type.array ? '[]' : ''}
),
],
{
merge: (s, t) => ({ ...t, [item.name]: s.typeMaps.join(';\n') }),
}
),
(item, ctx) => {
return sequence([
push('typescript', ctx => export type ${item.name} = { ${ctx[item.name]} };\n),
]);
},
]
),
pretty('result', ctx => ctx.typescript.join('\n'), { parser: 'typescript', filepath: '1.ts' }),
output(outFileName, ctx => ctx.result),
]);
});

expect(resCtx.result).toEqual(export type Post = { id: string; comments?: Comment[]; content?: string };

export type Comment = { id: string; postId: string; message?: string };
);

const fileResult = await readFile(outFileName, 'utf8');
expect(fileResult).toEqual(export type Post = { id: string; comments?: Comment[]; content?: string };

export type Comment = { id: string; postId: string; message?: string };
);
});
`

$3

`typescript
it('generate a type - strongly typed', async () => {
let fileName = rndFileName();
let outFileName = rndFileNameTS();

await writeFile(
fileName,
/ graphql /
type Post {
id: ID!
comments: [Comment]
content: String
}

type Comment {
id: ID!
postId: ID!
message: String
}

);

type jsTypeDefinition = {
name: string;
type: string;
fields: Record<
string,
{
type: string;
nullable: boolean;
array: boolean;
arguments?: Record<
string,
{
type: string;
nullable: boolean;
array: boolean;
defaultValue?: any;
}
>;
}
>;
};

type ProcessingContext = {
result: string;
typescript: string;
summary: jsTypeDefinition[];
gql: DocumentNode;
};

type d0s = BaseD0s & CoreD0s & GraphQLD0s & PrettyD0s;

let resCtx = await d0, ProcessingContext>(async (ctx, d0) => {
return await d0.sequence([
d0.loadGraphQL('gql', fileName),
d0.graphQLSummary('summary', ctx => ctx.gql),
d0.template('typescript', ({ summary }) => {
let ts = '';

const gqlTypeToTs = (type: string) => {
switch (type) {
case 'String':
return 'string';
case 'Int':
return 'number';
case 'Float':
return 'number';
case 'ID':
return 'string';
default:
return type;
}
};

for (let type of summary) {
let props = Object.entries(type.fields).map(
([k, v]) => ${k}${v.nullable ? '?' : ''}: ${gqlTypeToTs(v.type)}${v.array ? '[]' : ''};
);
ts += export type ${type.name} = {
${props.join('\n')}
}\n;
}
return ts;
}),
d0.pretty('result', ctx => ctx.typescript, { parser: 'typescript', filepath: '1.ts' }),
d0.output(outFileName, ctx => ctx.result),
]);
});

expect(resCtx.result).toEqual(export type Post = {
id: string;
comments?: Comment[];
content?: string;
};
export type Comment = {
id: string;
postId: string;
message?: string;
};
);

const fileResult = await readFile(outFileName, 'utf8');
expect(fileResult).toEqual(export type Post = {
id: string;
comments?: Comment[];
content?: string;
};
export type Comment = {
id: string;
postId: string;
message?: string;
};
);
});
``