5
* - `--output-dir`: Output directory for the generated TypeScript type stubs.
6
* - `--toolkits`: Filter output to only include the specified toolkits. Can be specified multiple times (e.g., --toolkits gmail --toolkits slack)
7
*
8
+ * Environment variables:
9
+ * - `COMPOSIO_TOOLKIT_VERSION_<TOOLKIT>`: Override a toolkit version (e.g., COMPOSIO_TOOLKIT_VERSION_GMAIL=20250901_00).
10
+ * Use "latest" or unset to use the latest version.
11
+ *
12
* Invariants:
13
* - The `--output-dir` cannot refer to a path inside `node_modules`
14
* - If `--output-dir` is not specified, the command will use `findComposioCoreGeneratedPath` to locate the `@composio/core` package
19
* and stored along with the generated TypeScript files. CJS is not supported.
20
*/
21
18
-import { Command, Flag } from 'effect/cli';
19
-import { Array, Data, Effect, Option, pipe } from 'effect';
22
+import { Array, Effect, Match, Option, pipe } from 'effect';
23
import * as FileSystem from 'effect/FileSystem';
24
import * as Path from 'effect/Path';
22
-import { Match } from 'effect';
25
import {
26
ComposioToolkitsRepository,
27
type ComposioToolkitsRepositoryShape,
28
} from 'src/services/composio-clients';
29
import { logMetrics } from 'src/effects/log-metrics';
30
import { NodeProcess } from 'src/services/node-process';
29
-import type { GetCmdParams } from 'src/type-utils';
31
import { jsFindComposioCoreGenerated } from 'src/effects/find-composio-core-generated';
32
import { generationOutcome, loadGenerationRuntime } from 'src/effects/generation-runtime';
33
import type { Toolkit } from 'src/models/toolkits';
42
import { validateToolkitVersionOverrides } from 'src/effects/validate-toolkit-versions';
43
import { TerminalUI, type SpinnerHandle } from 'src/services/terminal-ui';
44
import { CommandInputError, commandInputError } from 'src/commands/errors';
44
-
45
-export class TypeScriptGenerationWriteError extends Data.TaggedError(
46
- 'commands/TypeScriptGenerationWriteError'
47
-)<{
48
- readonly cause: unknown;
49
- readonly filePath: string;
50
- readonly message: string;
51
-}> {}
45
+import { TypeScriptGenerationWriteError } from './generate.ts.errors';
46
+
47
+export type GenerateTsParams = {
48
+ readonly outputDir: Option.Option<string>;
49
+ readonly compact: boolean;
50
+ readonly transpiled: boolean;
51
+ readonly typeTools: boolean;
52
+ readonly toolkits: ReadonlyArray<string>;
53
+};
54
55
const invalidGenerateValue = commandInputError('generate ts');
56
55
-export const outputOpt = Flag.optional(Flag.Directory('output-dir')).pipe(
56
- Flag.withAlias('o'),
57
- Flag.withDescription('Output directory for the generated TypeScript type stubs.')
58
-);
59
-
60
-export const compact = Flag.Boolean('compact').pipe(
61
- Flag.withDefault(false),
62
- Flag.withDescription('Emit a single TypeScript file')
63
-);
64
-
65
-export const transpiled = Flag.Boolean('transpiled').pipe(
66
- Flag.withDefault(false),
67
- Flag.withDescription('Whether to emit transpiled JavaScript alongside TypeScript files')
68
-);
69
-
70
-export const typeTools = Flag.Boolean('type-tools').pipe(
71
- Flag.withDefault(false),
72
- Flag.withDescription(
73
- 'Generate typed input/output schemas for each tool (slower, fetches full tool definitions)'
74
- )
75
-);
76
-
77
-export const toolkitsOpt = Flag.String('toolkits').pipe(
78
- Flag.atLeast(0),
79
- Flag.withDescription(
80
- 'Only generate types for specific toolkits (e.g., --toolkits gmail --toolkits slack)'
81
- )
82
-);
83
-
84
-const _tsCmd$Generate = Command.make('generate', {
85
- outputOpt,
86
- compact,
87
- transpiled: transpiled,
88
- typeTools,
89
- toolkitsOpt,
90
-}).pipe(
91
- Command.withDescription(
92
- 'Generate TypeScript types for toolkits, tools, and triggers from the Composio API.\n\n' +
93
- 'Environment Variables:\n' +
94
- ' COMPOSIO_TOOLKIT_VERSION_<TOOLKIT> Override toolkit version (e.g., COMPOSIO_TOOLKIT_VERSION_GMAIL=20250901_00)\n' +
95
- ' Use "latest" or unset to use the latest version.'
96
- )
97
-);
98
-
57
/**
58
* Result type for fetching toolkit data
59
*/
300
}
301
302
/**
345
- * Shared handler for TypeScript generation commands.
346
- * Resolves the `transpiled` default based on whether `--output-dir` was provided.
303
+ * `--transpiled` defaults to true only when `--output-dir` is absent: the stubs then land
304
+ * in `node_modules`, where JavaScript must exist alongside the TypeScript files. An explicit
305
+ * `--transpiled` always wins.
306
*/
348
-export const handleTsGenerate = (params: GetCmdParams<typeof _tsCmd$Generate>) => {
349
- // Determine if we should compile based on the rules:
350
- // - If --output-dir is specified, default transpiled to false unless overridden
351
- // - If no --output-dir, default transpiled to true unless overridden
352
- const shouldCompile = params.transpiled || !Option.isSome(params.outputOpt);
353
-
354
- return generateTypescriptTypeStubs({
355
- ...params,
356
- transpiled: shouldCompile,
357
- });
358
-};
307
+export const resolveTranspiled = ({
308
+ transpiled,
309
+ outputDir,
310
+}: Pick<GenerateTsParams, 'transpiled' | 'outputDir'>): boolean =>
311
+ transpiled || Option.isNone(outputDir);
312
+
313
+export const runGenerateTs = (params: GenerateTsParams) =>
314
+ generateTypescriptTypeStubs({ ...params, transpiled: resolveTranspiled(params) });
315
360
-export function generateTypescriptTypeStubs({
361
- outputOpt,
362
- compact,
363
- typeTools,
364
- transpiled = false,
365
- toolkitsOpt,
366
-}: GetCmdParams<typeof _tsCmd$Generate> & { transpiled?: boolean }) {
316
+export function generateTypescriptTypeStubs(params: GenerateTsParams) {
317
return Effect.gen(function* () {
318
const ui = yield* TerminalUI;
319
const fs = yield* FileSystem.FileSystem;
320
const process = yield* NodeProcess;
321
const cwd = process.cwd;
322
const client = yield* ComposioToolkitsRepository;
323
+ const { compact, typeTools, transpiled } = params;
324
325
yield* ui.intro('composio generate ts');
326
327
// Determine the actual output directory
377
- const outputDir = yield* outputOpt.pipe(
328
+ const outputDir = yield* params.outputDir.pipe(
329
Option.match({
330
// If no output directory is specified, use the default, and make sure it exists
331
onNone: () => jsFindComposioCoreGenerated(cwd),
342
const versionOverrides = yield* getToolkitVersionOverrides;
343
344
// Normalize toolkit slugs if specified (lowercase for API filtering)
394
- const toolkitSlugsFilter = Array.isReadonlyArrayNonEmpty(toolkitsOpt)
395
- ? toolkitsOpt.map(s => s.toLowerCase())
345
+ const toolkitSlugsFilter = Array.isReadonlyArrayNonEmpty(params.toolkits)
346
+ ? params.toolkits.map(s => s.toLowerCase())
347
: null;
348
349
// Validate toolkit version overrides before fetching data
425
})
426
);
427
477
- yield* Option.isNone(outputOpt)
428
+ yield* Option.isNone(params.outputDir)
429
? ui.note(
430
'import { Toolkits } from "@composio/core/generated"',
431
'Import your generated types'