@jordanalec/dtk 1.0.0

package/dist/add.js

@@ -0,0 +1,89 @@
+import { Command } from 'commander';
+import { readFile, writeFile, mkdir, access } from 'fs/promises';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+import { injectAtSentinel } from './utils/patch.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = join(__dirname, '../templates');
+const PLUGIN_MAP = {
+    'aws-sqs': 'aws-sqs',
+    'aws-sns': 'aws-sns',
+    'aws-dynamo': 'aws-dynamo',
+    'aws-s3': 'aws-s3',
+    'open-ai': 'open-ai',
+};
+export const addCommand = new Command('add')
+    .description('Add a service plugin to the project')
+    .argument('<plugin>', `Plugin to add. Available: ${Object.keys(PLUGIN_MAP).join(', ')}`)
+    .action(async (plugin) => {
+    const pluginKey = PLUGIN_MAP[plugin];
+    if (!pluginKey) {
+        console.error(`Unknown plugin: "${plugin}". Available: ${Object.keys(PLUGIN_MAP).join(', ')}`);
+        process.exit(1);
+    }
+    const pluginDir = join(TEMPLATES_DIR, 'plugins', pluginKey);
+    const manifest = JSON.parse(await readFile(join(pluginDir, 'plugin.json'), 'utf8'));
+    const destDir = process.cwd();
+    for (const file of manifest.files) {
+        const dest = join(destDir, file.dest);
+        await mkdir(dirname(dest), { recursive: true });
+        let content = await readFile(join(pluginDir, file.src), 'utf8');
+        for (const { from, to } of manifest.transforms?.[file.src] ?? []) {
+            content = content.replaceAll(from, to);
+        }
+        await writeFile(dest, content, 'utf8');
+        console.log(`  created  ${file.dest}`);
+    }
+    for (const [targetFile, sentinels] of Object.entries(manifest.patches)) {
+        const filePath = join(destDir, targetFile);
+        let content = await readFile(filePath, 'utf8');
+        for (const [sentinel, lines] of Object.entries(sentinels)) {
+            for (const line of Array.isArray(lines) ? lines : [lines]) {
+                content = injectAtSentinel(content, sentinel, line);
+            }
+        }
+        await writeFile(filePath, content, 'utf8');
+        console.log(`  patched  ${targetFile}`);
+    }
+    if (manifest.env) {
+        const fragment = (await readFile(join(pluginDir, manifest.env), 'utf8')).trim();
+        const envPath = join(destDir, '.env.template');
+        const envExists = await access(envPath).then(() => true).catch(() => false);
+        const envContent = envExists ? await readFile(envPath, 'utf8') : '';
+        const missingLines = fragment.split('\n').map(l => l.trim()).filter(l => l && !envContent.includes(l));
+        if (missingLines.length > 0) {
+            const base = envContent.trimEnd();
+            await writeFile(envPath, (base ? base + '\n' : '') + missingLines.join('\n') + '\n', 'utf8');
+            console.log(`  ${envExists ? 'updated' : 'created'}  .env.template`);
+        }
+    }
+    if (manifest.example) {
+        const runbookDest = join(destDir, 'src', 'runbooks', `${plugin}.ts`);
+        const alreadyExists = await access(runbookDest).then(() => true).catch(() => false);
+        if (!alreadyExists) {
+            await mkdir(dirname(runbookDest), { recursive: true });
+            await writeFile(runbookDest, await readFile(join(pluginDir, manifest.example), 'utf8'), 'utf8');
+            console.log(`  created  src/runbooks/${plugin}.ts`);
+            const pkgPath = join(destDir, 'package.json');
+            const pkg = JSON.parse(await readFile(pkgPath, 'utf8'));
+            const scriptKey = `runbook:${plugin}`;
+            if (!pkg.scripts[scriptKey]) {
+                pkg.scripts[scriptKey] = `tsx src/runbooks/${plugin}.ts`;
+                await writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+                console.log(`  updated  package.json (added ${scriptKey})`);
+            }
+        }
+        else {
+            console.log(`  skipped  src/runbooks/${plugin}.ts (already exists)`);
+        }
+    }
+    console.log(`\nPlugin "${plugin}" added.`);
+    if (manifest.dependencies) {
+        const deps = Object.entries(manifest.dependencies)
+            .map(([k, v]) => `${k}@${v}`)
+            .join(' ');
+        console.log(`Installing dependencies: npm install ${deps}`);
+        execSync(`npm install ${deps}`, { cwd: destDir, stdio: 'inherit' });
+    }
+});

package/dist/cli.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { initCommand } from './init.js';
+import { addCommand } from './add.js';
+const program = new Command();
+program
+    .name('dtk')
+    .description('Developer toolkit scaffolder')
+    .version('0.0.1');
+program.addCommand(initCommand);
+program.addCommand(addCommand);
+program.parse();

package/dist/init.js

@@ -0,0 +1,20 @@
+import { Command } from 'commander';
+import { cp } from 'fs/promises';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = join(__dirname, '../templates');
+const ROOT_FILES = ['.env.template', '.gitignore', 'tsconfig.json', 'tsconfig.test.json', 'jest.config.ts', 'package.json', 'README.md', 'GUIDE.md'];
+export const initCommand = new Command('init')
+    .description('Scaffold a new dtk project in the current directory')
+    .action(async () => {
+    const initDir = join(TEMPLATES_DIR, 'init');
+    const dest = process.cwd();
+    await cp(join(initDir, 'src'), join(dest, 'src'), { recursive: true });
+    for (const file of ROOT_FILES) {
+        await cp(join(initDir, file), join(dest, file));
+    }
+    console.log('Project scaffolded. Installing dependencies...');
+    execSync('npm install', { cwd: dest, stdio: 'inherit' });
+});

package/dist/utils/patch.js

@@ -0,0 +1,8 @@
+export function injectAtSentinel(content, sentinel, line) {
+    const marker = `// dtk:${sentinel}`;
+    if (!content.includes(marker))
+        throw new Error(`Sentinel not found: ${marker}`);
+    if (content.includes(line.trim()))
+        return content;
+    return content.replace(marker, `${line}\n${marker}`);
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@jordanalec/dtk",
+  "version": "1.0.0",
+  "description": "CLI scaffolding tool for generating self-contained TypeScript runbook projects",
+  "keywords": [
+    "cli",
+    "runbook",
+    "typescript",
+    "scaffolding",
+    "devtools"
+  ],
+  "author": "JordanAlec",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JordanAlec/dtk.git"
+  },
+  "homepage": "https://github.com/JordanAlec/dtk#readme",
+  "type": "module",
+  "bin": {
+    "dtk": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node node_modules/jest/bin/jest.js"
+  },
+  "dependencies": {
+    "commander": "^14.0.3"
+  },
+  "devDependencies": {
+    "@aws-sdk/client-dynamodb": "^3.1041.0",
+    "@aws-sdk/client-s3": "^3.1041.0",
+    "@aws-sdk/client-sns": "^3.1040.0",
+    "@aws-sdk/client-sqs": "^3.1040.0",
+    "@aws-sdk/s3-request-presigner": "^3.1041.0",
+    "@aws-sdk/util-dynamodb": "^3.996.2",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.0.0",
+    "axios": "^1.6.0",
+    "dotenv": "^16.4.0",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.9",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/templates/init/.env.template

@@ -0,0 +1,2 @@
+# Environment variables for this project
+# Copy this file to .env and fill in values