@sdk-it/cli 0.15.0 → 0.17.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js
CHANGED
|
@@ -8,12 +8,29 @@ import { Command } from "commander";
|
|
|
8
8
|
import { execFile, execSync } from "node:child_process";
|
|
9
9
|
import { generate } from "@sdk-it/dart";
|
|
10
10
|
|
|
11
|
-
// packages/
|
|
11
|
+
// packages/spec/dist/lib/loaders/local-loader.js
|
|
12
12
|
import { readFile } from "node:fs/promises";
|
|
13
13
|
import { extname } from "node:path";
|
|
14
14
|
import { parse } from "yaml";
|
|
15
|
-
async function
|
|
15
|
+
async function loadLocal(location) {
|
|
16
16
|
const extName = extname(location);
|
|
17
|
+
const text = await readFile(location, "utf-8");
|
|
18
|
+
switch (extName) {
|
|
19
|
+
case ".json":
|
|
20
|
+
return JSON.parse(text);
|
|
21
|
+
case ".yaml":
|
|
22
|
+
case ".yml":
|
|
23
|
+
return parse(text);
|
|
24
|
+
default:
|
|
25
|
+
throw new Error(`Unsupported file extension: ${extName}`);
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
// packages/spec/dist/lib/loaders/remote-loader.js
|
|
30
|
+
import { extname as extname2 } from "node:path";
|
|
31
|
+
import { parse as parse2 } from "yaml";
|
|
32
|
+
async function loadRemote(location) {
|
|
33
|
+
const extName = extname2(location);
|
|
17
34
|
const response = await fetch(location);
|
|
18
35
|
switch (extName) {
|
|
19
36
|
case ".json":
|
|
@@ -21,33 +38,19 @@ async function loadRemote(location) {
|
|
|
21
38
|
case ".yaml":
|
|
22
39
|
case ".yml": {
|
|
23
40
|
const text = await response.text();
|
|
24
|
-
return
|
|
41
|
+
return parse2(text);
|
|
25
42
|
}
|
|
26
43
|
default:
|
|
27
44
|
try {
|
|
28
45
|
return response.json();
|
|
29
46
|
} catch {
|
|
30
47
|
const text = await response.text();
|
|
31
|
-
return
|
|
48
|
+
return parse2(text);
|
|
32
49
|
}
|
|
33
50
|
}
|
|
34
51
|
}
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
switch (extName) {
|
|
38
|
-
case ".json":
|
|
39
|
-
return import(location, { with: { type: "json" } }).then(
|
|
40
|
-
(mod) => mod.default
|
|
41
|
-
);
|
|
42
|
-
case ".yaml":
|
|
43
|
-
case ".yml": {
|
|
44
|
-
const text = await await readFile(location, "utf-8");
|
|
45
|
-
return parse(text);
|
|
46
|
-
}
|
|
47
|
-
default:
|
|
48
|
-
throw new Error(`Unsupported file extension: ${extName}`);
|
|
49
|
-
}
|
|
50
|
-
}
|
|
52
|
+
|
|
53
|
+
// packages/spec/dist/lib/loaders/load-spec.js
|
|
51
54
|
function loadSpec(location) {
|
|
52
55
|
const [protocol] = location.split(":");
|
|
53
56
|
if (protocol === "http" || protocol === "https") {
|
|
@@ -56,6 +59,9 @@ function loadSpec(location) {
|
|
|
56
59
|
return loadLocal(location);
|
|
57
60
|
}
|
|
58
61
|
|
|
62
|
+
// packages/spec/dist/lib/operation.js
|
|
63
|
+
import { camelcase } from "stringcase";
|
|
64
|
+
|
|
59
65
|
// packages/cli/src/lib/options.ts
|
|
60
66
|
import { Option } from "commander";
|
|
61
67
|
var specOption = new Option(
|
|
@@ -72,14 +78,16 @@ var dart_default = new Command("dart").description("Generate Dart SDK").addOptio
|
|
|
72
78
|
const spec = await loadSpec(options.spec);
|
|
73
79
|
await generate(spec, {
|
|
74
80
|
output: options.output,
|
|
75
|
-
mode: options.mode || "
|
|
81
|
+
mode: options.mode || "full",
|
|
76
82
|
name: options.name,
|
|
77
|
-
formatCode: ({
|
|
83
|
+
formatCode: ({ output }) => {
|
|
78
84
|
if (options.formatter) {
|
|
79
85
|
const [command, ...args] = options.formatter.split(" ");
|
|
80
|
-
execFile(command, args, {
|
|
86
|
+
execFile(command, args, {
|
|
87
|
+
env: { ...process.env, SDK_IT_OUTPUT: output }
|
|
88
|
+
});
|
|
81
89
|
} else {
|
|
82
|
-
execSync("dart format $SDK_IT_OUTPUT", {
|
|
90
|
+
execSync("dart format $SDK_IT_OUTPUT ", {
|
|
83
91
|
env: { ...process.env, SDK_IT_OUTPUT: output },
|
|
84
92
|
stdio: options.verbose ? "inherit" : "pipe"
|
|
85
93
|
});
|
|
@@ -117,7 +125,9 @@ var typescript_default = new Command2("typescript").alias("ts").description("Gen
|
|
|
117
125
|
formatCode: ({ env, output }) => {
|
|
118
126
|
if (options.formatter) {
|
|
119
127
|
const [command, ...args] = options.formatter.split(" ");
|
|
120
|
-
execFile2(command, args, {
|
|
128
|
+
execFile2(command, args, {
|
|
129
|
+
env: { ...env, SDK_IT_OUTPUT: output }
|
|
130
|
+
});
|
|
121
131
|
} else if (options.defaultFormatter) {
|
|
122
132
|
execSync2("npx -y prettier $SDK_IT_OUTPUT --write", {
|
|
123
133
|
env: {
|
package/dist/index.js.map
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
|
-
"sources": ["../src/lib/cli.ts", "../src/lib/langs/dart.ts", "
|
|
4
|
-
"sourcesContent": ["#!/usr/bin/env node\nimport { Command, program } from 'commander';\n\nimport dart from './langs/dart.ts';\nimport typescript from './langs/typescript.ts';\n\nconst generate = new Command('generate')\n .addCommand(typescript)\n .addCommand(dart);\nconst cli = program\n .description(`CLI tool to interact with SDK-IT.`)\n .addCommand(generate, { isDefault: true })\n .addCommand(\n new Command('_internal').action(() => {\n // do nothing\n }),\n { hidden: true },\n )\n .parse(process.argv);\n\nexport default cli;\n", "import { Command } from 'commander';\nimport { execFile, execSync } from 'node:child_process';\n\nimport { generate } from '@sdk-it/dart';\n\nimport { loadSpec } from '../loader.ts';\nimport { outputOption, specOption } from '../options.ts';\n\ninterface Options {\n spec: string;\n output: string;\n language: string;\n mode?: 'full' | 'minimal';\n name?: string;\n useTsExtension: boolean;\n /**\n * Command to run the formatter.\n * @example 'biome check $SDK_IT_OUTPUT --write'\n * @example 'prettier $SDK_IT_OUTPUT --write'\n */\n formatter?: string;\n verbose: boolean;\n}\n\nexport default new Command('dart')\n .description('Generate Dart SDK')\n .addOption(specOption.makeOptionMandatory(true))\n .addOption(outputOption.makeOptionMandatory(true))\n .option('-l, --language <language>', 'Programming language for the SDK')\n // .option(\n // '-m, --mode <mode>',\n // 'full: generate a full project including package.json and tsconfig.json. useful for monorepo/workspaces minimal: generate only the client sdk',\n // )\n .option('-n, --name <name>', 'Name of the generated client', 'Client')\n .option('-v, --verbose', 'Verbose output', false)\n // .option('--formatter <formatter>', 'Formatter to use for the generated code')\n .action(async (options: Options) => {\n const spec = await loadSpec(options.spec);\n await generate(spec, {\n output: options.output,\n mode: options.mode || 'minimal',\n name: options.name,\n formatCode: ({ env, output }) => {\n if (options.formatter) {\n const [command, ...args] = options.formatter.split(' ');\n execFile(command, args, { env: { ...env, SDK_IT_OUTPUT: output } });\n } else {\n execSync('dart format $SDK_IT_OUTPUT', {\n env: { ...process.env, SDK_IT_OUTPUT: output },\n stdio: options.verbose ? 'inherit' : 'pipe',\n });\n }\n },\n });\n });\n", "import { readFile } from 'node:fs/promises';\nimport { extname } from 'node:path';\nimport type { OpenAPIObject } from 'openapi3-ts/oas31';\nimport { parse } from 'yaml';\n\nexport async function loadRemote(location: string) {\n const extName = extname(location);\n const response = await fetch(location);\n switch (extName) {\n case '.json':\n return response.json();\n case '.yaml':\n case '.yml': {\n const text = await response.text();\n return parse(text);\n }\n default:\n try {\n // try to parse it as json first\n return response.json();\n } catch {\n // parse as yaml\n const text = await response.text();\n return parse(text);\n }\n }\n}\nexport async function loadLocal(location: string) {\n const extName = extname(location);\n switch (extName) {\n case '.json':\n return import(location, { with: { type: 'json' } }).then(\n (mod) => mod.default,\n );\n case '.yaml':\n case '.yml': {\n const text = await await readFile(location, 'utf-8');\n return parse(text);\n }\n default:\n throw new Error(`Unsupported file extension: ${extName}`);\n }\n}\n\nexport function loadSpec(location: string): Promise<OpenAPIObject> {\n const [protocol] = location.split(':');\n if (protocol === 'http' || protocol === 'https') {\n return loadRemote(location);\n }\n return loadLocal(location);\n}\n", "import { Option } from 'commander';\n\nexport const specOption = new Option(\n '-s, --spec <spec>',\n 'Path to OpenAPI specification file',\n);\n\nexport const outputOption = new Option(\n '-o, --output <output>',\n 'Output directory for the generated SDK',\n);\n", "import { Command } from 'commander';\nimport { execFile, execSync } from 'node:child_process';\n\nimport { generate } from '@sdk-it/typescript';\n\nimport { loadSpec } from '../loader.ts';\nimport { outputOption, specOption } from '../options.ts';\n\ninterface Options {\n spec: string;\n output: string;\n language: string;\n mode?: 'full' | 'minimal';\n name?: string;\n useTsExtension: boolean;\n /**\n * Command to run the formatter.\n * @example 'biome check $SDK_IT_OUTPUT --write'\n * @example 'prettier $SDK_IT_OUTPUT --write'\n */\n formatter?: string;\n framework?: string;\n install: boolean;\n verbose: boolean;\n defaultFormatter: boolean;\n}\n\nexport default new Command('typescript')\n .alias('ts')\n .description('Generate TypeScript SDK')\n .addOption(specOption.makeOptionMandatory(true))\n .addOption(outputOption.makeOptionMandatory(true))\n .option(\n '--useTsExtension [value]',\n 'Use .ts extension for generated files',\n (value) => (value === 'false' ? false : true),\n true,\n )\n .option('-l, --language <language>', 'Programming language for the SDK')\n .option(\n '-m, --mode <mode>',\n 'full: generate a full project including package.json and tsconfig.json. useful for monorepo/workspaces minimal: generate only the client sdk',\n )\n .option('-n, --name <name>', 'Name of the generated client', 'Client')\n .option(\n '-f, --framework <framework>',\n 'Framework that is integrating with the SDK',\n )\n .option('--formatter <formatter>', 'Formatter to use for the generated code')\n .option(\n '--install',\n 'Install dependencies using npm (only in full mode)',\n true,\n )\n .option('--no-default-formatter', 'Do not use the default formatter')\n .option('--no-install', 'Do not install dependencies')\n .option('-v, --verbose', 'Verbose output', false)\n .action(async (options: Options) => {\n const spec = await loadSpec(options.spec);\n await generate(spec, {\n output: options.output,\n mode: options.mode || 'minimal',\n name: options.name,\n useTsExtension: options.useTsExtension,\n formatCode: ({ env, output }) => {\n if (options.formatter) {\n const [command, ...args] = options.formatter.split(' ');\n execFile(command, args, { env: { ...env, SDK_IT_OUTPUT: output } });\n } else if (options.defaultFormatter) {\n execSync('npx -y prettier $SDK_IT_OUTPUT --write', {\n env: {\n ...env,\n SDK_IT_OUTPUT: output,\n NODE_OPTIONS: '--experimental-strip-types',\n },\n stdio: options.verbose ? 'inherit' : 'pipe',\n });\n }\n },\n });\n\n // Install dependencies if in full mode and install option is enabled\n\n if (options.install && options.mode === 'full') {\n console.log('Installing dependencies...');\n execSync('npm install', {\n cwd: options.output,\n stdio: options.verbose ? 'inherit' : 'pipe',\n });\n }\n });\n"],
|
|
5
|
-
"mappings": ";;;AACA,SAAS,WAAAA,UAAS,eAAe;;;ACDjC,SAAS,eAAe;AACxB,SAAS,UAAU,gBAAgB;AAEnC,SAAS,gBAAgB;;;ACHzB,SAAS,gBAAgB;AACzB,SAAS,eAAe;
|
|
6
|
-
"names": ["Command", "Command", "execFile", "execSync", "generate", "Command", "generate", "execFile", "execSync", "generate", "Command"]
|
|
3
|
+
"sources": ["../src/lib/cli.ts", "../src/lib/langs/dart.ts", "../../spec/src/lib/loaders/local-loader.ts", "../../spec/src/lib/loaders/remote-loader.ts", "../../spec/src/lib/loaders/load-spec.ts", "../../spec/src/lib/operation.ts", "../src/lib/options.ts", "../src/lib/langs/typescript.ts"],
|
|
4
|
+
"sourcesContent": ["#!/usr/bin/env node\nimport { Command, program } from 'commander';\n\nimport dart from './langs/dart.ts';\nimport typescript from './langs/typescript.ts';\n\nconst generate = new Command('generate')\n .addCommand(typescript)\n .addCommand(dart);\nconst cli = program\n .description(`CLI tool to interact with SDK-IT.`)\n .addCommand(generate, { isDefault: true })\n .addCommand(\n new Command('_internal').action(() => {\n // do nothing\n }),\n { hidden: true },\n )\n .parse(process.argv);\n\nexport default cli;\n", "import { Command } from 'commander';\nimport { execFile, execSync } from 'node:child_process';\n\nimport { generate } from '@sdk-it/dart';\nimport { loadSpec } from '@sdk-it/spec';\n\nimport { outputOption, specOption } from '../options.ts';\n\ninterface Options {\n spec: string;\n output: string;\n language: string;\n mode?: 'full' | 'minimal';\n name?: string;\n useTsExtension: boolean;\n /**\n * Command to run the formatter.\n * @example 'biome check $SDK_IT_OUTPUT --write'\n * @example 'prettier $SDK_IT_OUTPUT --write'\n */\n formatter?: string;\n verbose: boolean;\n}\n\nexport default new Command('dart')\n .description('Generate Dart SDK')\n .addOption(specOption.makeOptionMandatory(true))\n .addOption(outputOption.makeOptionMandatory(true))\n .option('-l, --language <language>', 'Programming language for the SDK')\n // .option(\n // '-m, --mode <mode>',\n // 'full: generate a full project including package.json and tsconfig.json. useful for monorepo/workspaces minimal: generate only the client sdk',\n // )\n .option('-n, --name <name>', 'Name of the generated client', 'Client')\n .option('-v, --verbose', 'Verbose output', false)\n // .option('--formatter <formatter>', 'Formatter to use for the generated code')\n .action(async (options: Options) => {\n const spec = await loadSpec(options.spec);\n await generate(spec, {\n output: options.output,\n mode: options.mode || 'full',\n name: options.name,\n formatCode: ({ output }) => {\n if (options.formatter) {\n const [command, ...args] = options.formatter.split(' ');\n execFile(command, args, {\n env: { ...process.env, SDK_IT_OUTPUT: output },\n });\n } else {\n execSync('dart format $SDK_IT_OUTPUT ', {\n env: { ...process.env, SDK_IT_OUTPUT: output },\n stdio: options.verbose ? 'inherit' : 'pipe',\n });\n // execSync('dart fix --apply $SDK_IT_OUTPUT ', {\n // env: { ...process.env, SDK_IT_OUTPUT: output },\n // stdio: options.verbose ? 'inherit' : 'pipe',\n // });\n }\n },\n });\n });\n", "import { readFile } from 'node:fs/promises';\nimport { extname } from 'node:path';\nimport { parse } from 'yaml';\n\nexport async function loadLocal(location: string) {\n const extName = extname(location);\n const text = await readFile(location, 'utf-8');\n switch (extName) {\n case '.json':\n return JSON.parse(text);\n case '.yaml':\n case '.yml':\n return parse(text);\n default:\n throw new Error(`Unsupported file extension: ${extName}`);\n }\n}\n", "import { extname } from 'node:path';\nimport type { OpenAPIObject } from 'openapi3-ts/oas31';\nimport { parse } from 'yaml';\n\nexport async function loadRemote(location: string): Promise<OpenAPIObject> {\n const extName = extname(location);\n const response = await fetch(location);\n switch (extName) {\n case '.json':\n return response.json() as Promise<OpenAPIObject>;\n case '.yaml':\n case '.yml': {\n const text = await response.text();\n return parse(text);\n }\n default:\n try {\n // try to parse it as json first\n return response.json() as Promise<OpenAPIObject>;\n } catch {\n // parse as yaml\n const text = await response.text();\n return parse(text) as Promise<OpenAPIObject>;\n }\n }\n}\n", "import type { OpenAPIObject } from 'openapi3-ts/oas31';\n\nimport { loadLocal } from './local-loader.js';\nimport { loadRemote } from './remote-loader.js';\n\nexport function loadSpec(location: string): Promise<OpenAPIObject> {\n const [protocol] = location.split(':');\n if (protocol === 'http' || protocol === 'https') {\n return loadRemote(location);\n }\n return loadLocal(location);\n}\n", "import type {\n OpenAPIObject,\n OperationObject,\n ParameterObject,\n ReferenceObject,\n} from 'openapi3-ts/oas31';\nimport { camelcase } from 'stringcase';\n\nexport const defaults: Partial<GenerateSdkConfig> &\n Required<Pick<GenerateSdkConfig, 'operationId' | 'tag'>> = {\n operationId: (operation, path, method) => {\n if (operation.operationId) {\n return camelcase(operation.operationId);\n }\n const metadata = operation['x-oaiMeta'];\n if (metadata && metadata.name) {\n return camelcase(metadata.name);\n }\n return camelcase(\n [method, ...path.replace(/[\\\\/\\\\{\\\\}]/g, ' ').split(' ')]\n .filter(Boolean)\n .join(' ')\n .trim(),\n );\n },\n tag: (operation, path) => {\n return operation.tags?.[0] || determineGenericTag(path, operation);\n },\n};\n\nexport type TunedOperationObject = OperationObject & {\n operationId: string;\n parameters: (ParameterObject | ReferenceObject)[];\n};\n\nexport interface OperationEntry {\n name?: string;\n method: string;\n path: string;\n groupName: string;\n tag: string;\n}\nexport type Operation = {\n entry: OperationEntry;\n operation: TunedOperationObject;\n};\n\nexport function forEachOperation<T>(\n config: GenerateSdkConfig,\n callback: (entry: OperationEntry, operation: TunedOperationObject) => T,\n) {\n const result: T[] = [];\n for (const [path, pathItem] of Object.entries(config.spec.paths ?? {})) {\n const { parameters = [], ...methods } = pathItem;\n\n // Convert Express-style routes (:param) to OpenAPI-style routes ({param})\n const fixedPath = path.replace(/:([^/]+)/g, '{$1}');\n\n for (const [method, operation] of Object.entries(methods) as [\n string,\n OperationObject,\n ][]) {\n const formatOperationId = config.operationId ?? defaults.operationId;\n const formatTag = config.tag ?? defaults.tag;\n const operationName = formatOperationId(operation, fixedPath, method);\n const operationTag = formatTag(operation, fixedPath);\n const metadata = operation['x-oaiMeta'] ?? {};\n result.push(\n callback(\n {\n name: metadata.name,\n method,\n path: fixedPath,\n groupName: operationTag,\n tag: operationTag,\n },\n {\n ...operation,\n parameters: [...parameters, ...(operation.parameters ?? [])],\n operationId: operationName,\n },\n ),\n );\n }\n }\n return result;\n}\n\nexport interface GenerateSdkConfig {\n spec: OpenAPIObject;\n operationId?: (\n operation: OperationObject,\n path: string,\n method: string,\n ) => string;\n tag?: (operation: OperationObject, path: string) => string;\n}\n\n// --- Function Definition (determineGenericTag, sanitizeTag, reservedKeywords, commonVerbs) ---\n/**\n * Set of reserved TypeScript keywords and common verbs potentially used as tags.\n */\nconst reservedKeywords = new Set([\n 'abstract',\n 'arguments',\n 'await',\n 'boolean',\n 'break',\n 'byte',\n 'case',\n 'catch',\n 'char',\n 'class',\n 'const',\n 'continue',\n 'debugger',\n 'default',\n 'delete',\n 'do',\n 'double',\n 'else',\n 'enum',\n 'eval',\n 'export',\n 'extends',\n 'false',\n 'final',\n 'finally',\n 'float',\n 'for',\n 'function',\n 'goto',\n 'if',\n 'implements',\n 'import',\n 'in',\n 'instanceof',\n 'int',\n 'interface',\n 'let',\n 'long',\n 'native',\n 'new',\n 'null',\n 'package',\n 'private',\n 'protected',\n 'public',\n 'return',\n 'short',\n 'static',\n 'super',\n 'switch',\n 'synchronized',\n 'this',\n 'throw',\n 'throws',\n 'transient',\n 'true',\n 'try',\n 'typeof',\n 'var',\n 'void',\n 'volatile',\n 'while',\n 'with',\n 'yield',\n // Potentially problematic identifiers / Common Verbs used as tags\n 'object',\n 'string',\n 'number',\n 'any',\n 'unknown',\n 'never',\n 'get',\n 'list',\n 'create',\n 'update',\n 'delete',\n 'post',\n 'put',\n 'patch',\n 'do',\n 'send',\n 'add',\n 'remove',\n 'set',\n 'find',\n 'search',\n 'check',\n 'make', // Added make, check\n]);\n\n/**\n * Sanitizes a potential tag name (assumed to be already camelCased)\n * to avoid conflicts with reserved keywords or invalid starting characters (numbers).\n * Appends an underscore if the tag matches a reserved keyword.\n * Prepends an underscore if the tag starts with a number.\n * @param camelCasedTag The potential tag name, already camelCased.\n * @returns The sanitized tag name.\n */\nfunction sanitizeTag(camelCasedTag: string): string {\n // Prepend underscore if starts with a number\n if (/^\\d/.test(camelCasedTag)) {\n return `_${camelCasedTag}`;\n }\n // Append underscore if it's a reserved keyword\n return reservedKeywords.has(camelCasedTag)\n ? `${camelCasedTag}_`\n : camelCasedTag;\n}\n\n/**\n * Attempts to determine a generic tag for an OpenAPI operation based on path and operationId.\n * Rules and fallbacks are documented within the code.\n * @param pathString The path string.\n * @param operation The OpenAPI Operation Object.\n * @returns A sanitized, camelCased tag name string.\n */\nexport function determineGenericTag(\n pathString: string,\n operation: OperationObject,\n): string {\n const operationId = operation.operationId || '';\n const VERSION_REGEX = /^[vV]\\d+$/;\n const commonVerbs = new Set([\n // Verbs to potentially strip from operationId prefix\n 'get',\n 'list',\n 'create',\n 'update',\n 'delete',\n 'post',\n 'put',\n 'patch',\n 'do',\n 'send',\n 'add',\n 'remove',\n 'set',\n 'find',\n 'search',\n 'check',\n 'make', // Added make\n ]);\n\n const segments = pathString.split('/').filter(Boolean);\n\n const potentialCandidates = segments.filter(\n (segment) =>\n segment &&\n !segment.startsWith('{') &&\n !segment.endsWith('}') &&\n !VERSION_REGEX.test(segment),\n );\n\n // --- Heuristic 1: Last non-'@' path segment ---\n for (let i = potentialCandidates.length - 1; i >= 0; i--) {\n const segment = potentialCandidates[i];\n if (!segment.startsWith('@')) {\n // Sanitize just before returning\n return sanitizeTag(camelcase(segment));\n }\n }\n\n const canFallbackToPathSegment = potentialCandidates.length > 0;\n\n // --- Heuristic 2: OperationId parsing ---\n if (operationId) {\n const lowerOpId = operationId.toLowerCase();\n const parts = operationId\n .replace(/([a-z])([A-Z])/g, '$1_$2')\n .replace(/([A-Z])([A-Z][a-z])/g, '$1_$2')\n .replace(/([a-zA-Z])(\\d)/g, '$1_$2')\n .replace(/(\\d)([a-zA-Z])/g, '$1_$2')\n .toLowerCase()\n .split(/[_-\\s]+/);\n\n const validParts = parts.filter(Boolean);\n\n // Quick skip: If opId is just a verb and we can use Heuristic 3, prefer that.\n if (\n commonVerbs.has(lowerOpId) &&\n validParts.length === 1 &&\n canFallbackToPathSegment\n ) {\n // Proceed directly to Heuristic 3\n }\n // Only process if there are valid parts and the quick skip didn't happen\n else if (validParts.length > 0) {\n const firstPart = validParts[0];\n const isFirstPartVerb = commonVerbs.has(firstPart);\n\n // Case 2a: Starts with verb, has following parts\n if (isFirstPartVerb && validParts.length > 1) {\n const verbPrefixLength = firstPart.length;\n let nextPartStartIndex = -1;\n if (operationId.length > verbPrefixLength) {\n // Simplified check for next part start\n const charAfterPrefix = operationId[verbPrefixLength];\n if (charAfterPrefix >= 'A' && charAfterPrefix <= 'Z') {\n nextPartStartIndex = verbPrefixLength;\n } else if (charAfterPrefix >= '0' && charAfterPrefix <= '9') {\n nextPartStartIndex = verbPrefixLength;\n } else if (['_', '-'].includes(charAfterPrefix)) {\n nextPartStartIndex = verbPrefixLength + 1;\n } else {\n const match = operationId\n .substring(verbPrefixLength)\n .match(/[A-Z0-9]/);\n if (match && match.index !== undefined) {\n nextPartStartIndex = verbPrefixLength + match.index;\n }\n if (\n nextPartStartIndex === -1 &&\n operationId.length > verbPrefixLength\n ) {\n nextPartStartIndex = verbPrefixLength; // Default guess\n }\n }\n }\n\n if (\n nextPartStartIndex !== -1 &&\n nextPartStartIndex < operationId.length\n ) {\n const remainingOriginalSubstring =\n operationId.substring(nextPartStartIndex);\n const potentialTag = camelcase(remainingOriginalSubstring);\n if (potentialTag) {\n // Sanitize just before returning\n return sanitizeTag(potentialTag);\n }\n }\n\n // Fallback: join remaining lowercased parts\n const potentialTagJoined = camelcase(validParts.slice(1).join('_'));\n if (potentialTagJoined) {\n // Sanitize just before returning\n return sanitizeTag(potentialTagJoined);\n }\n }\n\n // Case 2b: Doesn't start with verb, or only one part (might be verb)\n const potentialTagFull = camelcase(operationId);\n if (potentialTagFull) {\n const isResultSingleVerb = validParts.length === 1 && isFirstPartVerb;\n\n // Avoid returning only a verb if Heuristic 3 is possible\n if (!(isResultSingleVerb && canFallbackToPathSegment)) {\n if (potentialTagFull.length > 0) {\n // Sanitize just before returning\n return sanitizeTag(potentialTagFull);\n }\n }\n }\n\n // Case 2c: Further fallbacks within OpId if above failed/skipped\n const firstPartCamel = camelcase(firstPart);\n if (firstPartCamel) {\n const isFirstPartCamelVerb = commonVerbs.has(firstPartCamel);\n if (\n !isFirstPartCamelVerb ||\n validParts.length === 1 ||\n !canFallbackToPathSegment\n ) {\n // Sanitize just before returning\n return sanitizeTag(firstPartCamel);\n }\n }\n if (\n isFirstPartVerb &&\n validParts.length > 1 &&\n validParts[1] &&\n canFallbackToPathSegment\n ) {\n const secondPartCamel = camelcase(validParts[1]);\n if (secondPartCamel) {\n // Sanitize just before returning\n return sanitizeTag(secondPartCamel);\n }\n }\n } // End if(validParts.length > 0) after quick skip check\n } // End if(operationId)\n\n // --- Heuristic 3: First path segment (stripping '@') ---\n if (potentialCandidates.length > 0) {\n let firstCandidate = potentialCandidates[0];\n if (firstCandidate.startsWith('@')) {\n firstCandidate = firstCandidate.substring(1);\n }\n if (firstCandidate) {\n // Sanitize just before returning\n return sanitizeTag(camelcase(firstCandidate));\n }\n }\n\n // --- Heuristic 4: Default ---\n console.warn(\n `Could not determine a suitable tag for path: ${pathString}, operationId: ${operationId}. Using 'unknown'.`,\n );\n return 'unknown'; // 'unknown' is safe\n}\n\nexport function parseJsonContentType(contentType: string | null | undefined) {\n if (!contentType) {\n return null;\n }\n\n // 1. Trim whitespace\n let mainType = contentType.trim();\n\n // 2. Remove parameters (anything after the first ';')\n const semicolonIndex = mainType.indexOf(';');\n if (semicolonIndex !== -1) {\n mainType = mainType.substring(0, semicolonIndex).trim(); // Trim potential space before ';'\n }\n\n // 3. Convert to lowercase for case-insensitive comparison\n mainType = mainType.toLowerCase();\n\n if (mainType.endsWith('/json')) {\n return mainType.split('/')[1];\n } else if (mainType.endsWith('+json')) {\n return mainType.split('+')[1];\n }\n return null;\n}\n\n/**\n * Checks if a given content type string represents Server-Sent Events (SSE).\n * Handles case-insensitivity, parameters (like charset), and leading/trailing whitespace.\n *\n * @param contentType The content type string to check (e.g., from a Content-Type header).\n * @returns True if the content type is 'text/event-stream', false otherwise.\n */\nexport function isSseContentType(\n contentType: string | null | undefined,\n): boolean {\n if (!contentType) {\n return false; // Handle null, undefined, or empty string\n }\n\n // 1. Trim whitespace from the input string\n let mainType = contentType.trim();\n\n // 2. Find the position of the first semicolon (if any) to remove parameters\n const semicolonIndex = mainType.indexOf(';');\n if (semicolonIndex !== -1) {\n // Extract the part before the semicolon and trim potential space\n mainType = mainType.substring(0, semicolonIndex).trim();\n }\n\n // 3. Convert the main type part to lowercase for case-insensitive comparison\n mainType = mainType.toLowerCase();\n\n // 4. Compare against the standard SSE MIME type\n return mainType === 'text/event-stream';\n}\n\nexport function isStreamingContentType(\n contentType: string | null | undefined,\n): boolean {\n return contentType === 'application/octet-stream';\n}\n\nexport function isSuccessStatusCode(statusCode: number | string): boolean {\n statusCode = Number(statusCode);\n return statusCode >= 200 && statusCode < 300;\n}\n", "import { Option } from 'commander';\n\nexport const specOption = new Option(\n '-s, --spec <spec>',\n 'Path to OpenAPI specification file',\n);\n\nexport const outputOption = new Option(\n '-o, --output <output>',\n 'Output directory for the generated SDK',\n);\n", "import { Command } from 'commander';\nimport { execFile, execSync } from 'node:child_process';\n\nimport { loadSpec } from '@sdk-it/spec';\nimport { generate } from '@sdk-it/typescript';\n\nimport { outputOption, specOption } from '../options.ts';\n\ninterface Options {\n spec: string;\n output: string;\n language: string;\n mode?: 'full' | 'minimal';\n name?: string;\n useTsExtension: boolean;\n /**\n * Command to run the formatter.\n * @example 'biome check $SDK_IT_OUTPUT --write'\n * @example 'prettier $SDK_IT_OUTPUT --write'\n */\n formatter?: string;\n framework?: string;\n install: boolean;\n verbose: boolean;\n defaultFormatter: boolean;\n}\n\nexport default new Command('typescript')\n .alias('ts')\n .description('Generate TypeScript SDK')\n .addOption(specOption.makeOptionMandatory(true))\n .addOption(outputOption.makeOptionMandatory(true))\n .option(\n '--useTsExtension [value]',\n 'Use .ts extension for generated files',\n (value) => (value === 'false' ? false : true),\n true,\n )\n .option('-l, --language <language>', 'Programming language for the SDK')\n .option(\n '-m, --mode <mode>',\n 'full: generate a full project including package.json and tsconfig.json. useful for monorepo/workspaces minimal: generate only the client sdk',\n )\n .option('-n, --name <name>', 'Name of the generated client', 'Client')\n .option(\n '-f, --framework <framework>',\n 'Framework that is integrating with the SDK',\n )\n .option('--formatter <formatter>', 'Formatter to use for the generated code')\n .option(\n '--install',\n 'Install dependencies using npm (only in full mode)',\n true,\n )\n .option('--no-default-formatter', 'Do not use the default formatter')\n .option('--no-install', 'Do not install dependencies')\n .option('-v, --verbose', 'Verbose output', false)\n .action(async (options: Options) => {\n const spec = await loadSpec(options.spec);\n await generate(spec, {\n output: options.output,\n mode: options.mode || 'minimal',\n name: options.name,\n useTsExtension: options.useTsExtension,\n formatCode: ({ env, output }) => {\n if (options.formatter) {\n const [command, ...args] = options.formatter.split(' ');\n execFile(command, args, {\n env: { ...env, SDK_IT_OUTPUT: output },\n });\n } else if (options.defaultFormatter) {\n execSync('npx -y prettier $SDK_IT_OUTPUT --write', {\n env: {\n ...env,\n SDK_IT_OUTPUT: output,\n NODE_OPTIONS: '--experimental-strip-types',\n },\n stdio: options.verbose ? 'inherit' : 'pipe',\n });\n }\n },\n });\n\n // Install dependencies if in full mode and install option is enabled\n\n if (options.install && options.mode === 'full') {\n console.log('Installing dependencies...');\n execSync('npm install', {\n cwd: options.output,\n stdio: options.verbose ? 'inherit' : 'pipe',\n });\n }\n });\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
|
+
"names": ["Command", "extname", "parse", "Command", "execFile", "execSync", "generate", "Command", "generate", "execFile", "execSync", "generate", "Command"]
|
|
7
7
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dart.d.ts","sourceRoot":"","sources":["../../../src/lib/langs/dart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;;AAwBpC,
|
|
1
|
+
{"version":3,"file":"dart.d.ts","sourceRoot":"","sources":["../../../src/lib/langs/dart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;;AAwBpC,wBAoCK"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../../src/lib/langs/typescript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;;AA2BpC,
|
|
1
|
+
{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../../src/lib/langs/typescript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;;AA2BpC,wBAiEK"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sdk-it/cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.17.0",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"main": "./dist/index.js",
|
|
6
6
|
"module": "./dist/index.js",
|
|
@@ -20,10 +20,9 @@
|
|
|
20
20
|
],
|
|
21
21
|
"dependencies": {
|
|
22
22
|
"commander": "^13.1.0",
|
|
23
|
-
"@sdk-it/typescript": "0.
|
|
24
|
-
"
|
|
25
|
-
"@sdk-it/
|
|
26
|
-
"openapi3-ts": "4.4.0"
|
|
23
|
+
"@sdk-it/typescript": "0.17.0",
|
|
24
|
+
"@sdk-it/dart": "0.17.0",
|
|
25
|
+
"@sdk-it/spec": "0.17.0"
|
|
27
26
|
},
|
|
28
27
|
"publishConfig": {
|
|
29
28
|
"access": "public"
|
package/dist/lib/loader.d.ts
DELETED
|
@@ -1,5 +0,0 @@
|
|
|
1
|
-
import type { OpenAPIObject } from 'openapi3-ts/oas31';
|
|
2
|
-
export declare function loadRemote(location: string): Promise<any>;
|
|
3
|
-
export declare function loadLocal(location: string): Promise<any>;
|
|
4
|
-
export declare function loadSpec(location: string): Promise<OpenAPIObject>;
|
|
5
|
-
//# sourceMappingURL=loader.d.ts.map
|
package/dist/lib/loader.d.ts.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/lib/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,gBAqBhD;AACD,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,gBAe/C;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAMjE"}
|