@kargojs/cli 0.1.0

package/dist/utils/log.js

@@ -0,0 +1,16 @@
+import pc from 'picocolors';
+export const log = {
+    info: (msg) => console.log(`  ${pc.blue('ℹ')}  ${msg}`),
+    success: (msg) => console.log(`  ${pc.green('✔')}  ${msg}`),
+    warn: (msg) => console.log(`  ${pc.yellow('⚠')}  ${msg}`),
+    error: (msg) => console.error(`  ${pc.red('✖')}  ${msg}`),
+    file: (path) => console.log(`  ${pc.gray('+')}  ${pc.cyan(path)}`),
+    step: (msg) => console.log(`\n  ${pc.bold(msg)}`),
+    blank: () => console.log(),
+};
+export function banner(name, version) {
+    console.log();
+    console.log(`  ${pc.bold(pc.blue('◆ Kargo'))} ${pc.gray(`v${version}`)}`);
+    console.log(`  ${pc.gray(name)}`);
+    console.log();
+}

package/dist/utils/register-resource.d.ts

@@ -0,0 +1,22 @@
+export interface RegisterResourceOptions {
+    appModulePath: string;
+    pascalName: string;
+    resourcePath: string;
+    servicePath: string;
+}
+export interface RegisterResourceResult {
+    success: boolean;
+    reason?: string;
+}
+/**
+ * Adds the two import statements and a `{ resource: XResource, service: XService }`
+ * entry to app.module.ts's `KargoModule.forRoot({ resources: [...] })` array using
+ * a real TS AST edit (via ts-morph), so it works regardless of the file's existing
+ * formatting/comments/multi-line layout.
+ *
+ * Returns { success: false, reason } — never throws or partially edits the file —
+ * when app.module.ts doesn't match the expected shape (e.g. heavily customized),
+ * so the caller can fall back to printing manual instructions instead.
+ */
+export declare function registerResource(opts: RegisterResourceOptions): RegisterResourceResult;
+//# sourceMappingURL=register-resource.d.ts.map

package/dist/utils/register-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-resource.d.ts","sourceRoot":"","sources":["../../src/utils/register-resource.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,sBAAsB,CA+DtF"}

package/dist/utils/register-resource.js

@@ -0,0 +1,71 @@
+import { Project, SyntaxKind, QuoteKind } from 'ts-morph';
+import { relative, dirname } from 'node:path';
+function toImportSpecifier(fromDir, toFileAbsPath) {
+    let rel = relative(fromDir, toFileAbsPath).replace(/\\/g, '/').replace(/\.ts$/, '.js');
+    if (!rel.startsWith('.'))
+        rel = `./${rel}`;
+    return rel;
+}
+/**
+ * Adds the two import statements and a `{ resource: XResource, service: XService }`
+ * entry to app.module.ts's `KargoModule.forRoot({ resources: [...] })` array using
+ * a real TS AST edit (via ts-morph), so it works regardless of the file's existing
+ * formatting/comments/multi-line layout.
+ *
+ * Returns { success: false, reason } — never throws or partially edits the file —
+ * when app.module.ts doesn't match the expected shape (e.g. heavily customized),
+ * so the caller can fall back to printing manual instructions instead.
+ */
+export function registerResource(opts) {
+    const project = new Project({
+        manipulationSettings: { quoteKind: QuoteKind.Single },
+    });
+    let sourceFile;
+    try {
+        sourceFile = project.addSourceFileAtPath(opts.appModulePath);
+    }
+    catch {
+        return { success: false, reason: `Could not read ${opts.appModulePath}` };
+    }
+    const callExpr = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression).find((c) => {
+        const expr = c.getExpression();
+        if (expr.getKind() !== SyntaxKind.PropertyAccessExpression)
+            return false;
+        const pae = expr.asKindOrThrow(SyntaxKind.PropertyAccessExpression);
+        return pae.getName() === 'forRoot' && pae.getExpression().getText() === 'KargoModule';
+    });
+    if (!callExpr) {
+        return { success: false, reason: 'Could not find a KargoModule.forRoot(...) call' };
+    }
+    const objArg = callExpr.getArguments()[0];
+    if (!objArg || objArg.getKind() !== SyntaxKind.ObjectLiteralExpression) {
+        return { success: false, reason: 'KargoModule.forRoot(...) argument is not an object literal' };
+    }
+    const resourcesProp = objArg
+        .asKindOrThrow(SyntaxKind.ObjectLiteralExpression)
+        .getProperty('resources');
+    if (!resourcesProp || resourcesProp.getKind() !== SyntaxKind.PropertyAssignment) {
+        return { success: false, reason: 'Could not find a `resources: [...]` property' };
+    }
+    const arrayLiteral = resourcesProp
+        .asKindOrThrow(SyntaxKind.PropertyAssignment)
+        .getInitializerIfKind(SyntaxKind.ArrayLiteralExpression);
+    if (!arrayLiteral) {
+        return { success: false, reason: '`resources` is not an array literal' };
+    }
+    const moduleDir = dirname(opts.appModulePath);
+    const resourceImport = toImportSpecifier(moduleDir, opts.resourcePath);
+    const serviceImport = toImportSpecifier(moduleDir, opts.servicePath);
+    sourceFile.addImportDeclaration({
+        namedImports: [`${opts.pascalName}Resource`],
+        moduleSpecifier: resourceImport,
+    });
+    sourceFile.addImportDeclaration({
+        namedImports: [`${opts.pascalName}Service`],
+        moduleSpecifier: serviceImport,
+    });
+    arrayLiteral.addElement(`{ resource: ${opts.pascalName}Resource, service: ${opts.pascalName}Service }`);
+    sourceFile.formatText({ indentSize: 2 });
+    sourceFile.saveSync();
+    return { success: true };
+}

package/dist/utils/strings.d.ts

@@ -0,0 +1,31 @@
+export declare function toPascalCase(str: string): string;
+export declare function toCamelCase(str: string): string;
+export declare function toKebabCase(str: string): string;
+export declare function toSnakeCase(str: string): string;
+export declare function toTitleCase(str: string): string;
+/** Very simple English pluralisation (covers the common cases). */
+export declare function toPlural(str: string): string;
+export declare function toSingular(str: string): string;
+/** All name variants for a resource name (e.g. "BlogPost"). */
+export interface ResourceNames {
+    /** BlogPost */
+    pascal: string;
+    /** blogPost */
+    camel: string;
+    /** blog-post */
+    kebab: string;
+    /** blog_post */
+    snake: string;
+    /** Blog Post */
+    title: string;
+    /** BlogPosts (plural pascal) */
+    pluralPascal: string;
+    /** blogPosts (plural camel) */
+    pluralCamel: string;
+    /** blog-posts (plural kebab) */
+    pluralKebab: string;
+    /** Blog Posts */
+    pluralTitle: string;
+}
+export declare function resourceNames(input: string): ResourceNames;
+//# sourceMappingURL=strings.d.ts.map

package/dist/utils/strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/utils/strings.ts"],"names":[],"mappings":"AAWA,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED,mEAAmE;AACnE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK9C;AAED,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf,eAAe;IACf,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAa1D"}

package/dist/utils/strings.js

@@ -0,0 +1,63 @@
+/** Normalise any casing to an array of lowercase words. */
+function words(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1 $2') // camelCase → camel Case
+        .replace(/[_\-\s]+/g, ' ') // separators → space
+        .trim()
+        .toLowerCase()
+        .split(' ')
+        .filter(Boolean);
+}
+export function toPascalCase(str) {
+    return words(str)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join('');
+}
+export function toCamelCase(str) {
+    const w = words(str);
+    return w
+        .map((word, i) => (i === 0 ? word : word.charAt(0).toUpperCase() + word.slice(1)))
+        .join('');
+}
+export function toKebabCase(str) {
+    return words(str).join('-');
+}
+export function toSnakeCase(str) {
+    return words(str).join('_');
+}
+export function toTitleCase(str) {
+    return words(str)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+}
+/** Very simple English pluralisation (covers the common cases). */
+export function toPlural(str) {
+    if (/[^aeiou]y$/i.test(str))
+        return str.slice(0, -1) + 'ies';
+    if (/(s|x|z|ch|sh)$/i.test(str))
+        return str + 'es';
+    if (!str.endsWith('s'))
+        return str + 's';
+    return str;
+}
+export function toSingular(str) {
+    if (/ies$/i.test(str))
+        return str.slice(0, -3) + 'y';
+    if (/(ses|xes|zes|ches|shes)$/i.test(str))
+        return str.slice(0, -2);
+    if (str.endsWith('s') && !str.endsWith('ss'))
+        return str.slice(0, -1);
+    return str;
+}
+export function resourceNames(input) {
+    const pascal = toPascalCase(toSingular(input));
+    const camel = toCamelCase(toSingular(input));
+    const kebab = toKebabCase(toSingular(input));
+    const snake = toSnakeCase(toSingular(input));
+    const title = toTitleCase(toSingular(input));
+    const pluralPascal = toPascalCase(toPlural(pascal));
+    const pluralCamel = toCamelCase(toPlural(pascal));
+    const pluralKebab = toKebabCase(toPlural(pascal));
+    const pluralTitle = toTitleCase(toPlural(pascal));
+    return { pascal, camel, kebab, snake, title, pluralPascal, pluralCamel, pluralKebab, pluralTitle };
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@kargojs/cli",
+  "version": "0.1.0",
+  "description": "CLI for the Kargo admin framework — scaffold projects and resources",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "kargo": "./bin/kargo.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist", "bin"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "check-types": "tsc --noEmit"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "picocolors": "^1.1.1",
+    "ts-morph": "^28.0.0"
+  },
+  "devDependencies": {
+    "@repo/typescript-config": "*",
+    "@types/node": "^22.0.0",
+    "typescript": "7.0.2"
+  }
+}