@rhino-dev/rhino-nestjs 0.2.5

package/dist/cli/commands/generate.command.d.ts

@@ -0,0 +1,6 @@
+import { type ReadlineInterface } from '../utils/prompt';
+export interface GenerateDeps {
+    rl?: ReadlineInterface;
+    cwd?: string;
+}
+export declare function runGenerate(deps?: GenerateDeps): Promise<void>;

package/dist/cli/commands/generate.command.js

@@ -0,0 +1,212 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGenerate = runGenerate;
+/**
+ * rhino generate
+ *
+ * Interactive wizard that asks:
+ *   - What to create: model | policy | scope
+ *   - Name (PascalCase)
+ *   - Columns (for model only)
+ *
+ * Writes a stub file under the right directory.
+ */
+const path = __importStar(require("path"));
+const prompt_1 = require("../utils/prompt");
+const io_1 = require("../utils/io");
+async function runGenerate(deps = {}) {
+    const cwd = deps.cwd ?? process.cwd();
+    const rl = deps.rl ?? (0, prompt_1.createInterface)();
+    console.log('\n  Rhino :: Generate\n');
+    const kind = await (0, prompt_1.selectFromList)(rl, 'What would you like to generate?', ['model', 'policy', 'scope'], 0);
+    const rawName = await (0, prompt_1.ask)(rl, `  Name (PascalCase, e.g. "BlogPost"): `);
+    const name = toPascalCase(rawName);
+    if (!name) {
+        console.error('  Error: name is required.');
+        rl.close();
+        process.exit(1);
+    }
+    switch (kind) {
+        case 'model':
+            await generateModel(rl, cwd, name);
+            break;
+        case 'policy':
+            generatePolicy(cwd, name);
+            break;
+        case 'scope':
+            generateScope(cwd, name);
+            break;
+        default:
+            console.error(`  Unknown type: ${kind}`);
+            rl.close();
+            process.exit(1);
+    }
+    rl.close();
+}
+// -----------------------------------------------------------------------
+// Model
+// -----------------------------------------------------------------------
+async function generateModel(rl, cwd, name) {
+    const columnsRaw = await (0, prompt_1.ask)(rl, '  Columns (comma-separated, e.g. "title:string, body:text, published:boolean") []: ');
+    const columns = parseColumns(columnsRaw);
+    const destPath = path.join(cwd, 'src', 'models', `${name}.model.ts`);
+    if ((0, io_1.fileExists)(destPath)) {
+        console.log(`  Skipped: ${destPath} already exists.`);
+        return;
+    }
+    const content = renderModelStub(name, columns);
+    (0, io_1.writeFileSafely)(destPath, content);
+    console.log(`  Created: ${destPath}`);
+}
+function parseColumns(raw) {
+    if (!raw.trim())
+        return [];
+    return raw
+        .split(',')
+        .map((col) => col.trim())
+        .filter(Boolean)
+        .map((col) => {
+        const [name, type = 'string'] = col.split(':').map((s) => s.trim());
+        return { name: toCamelCase(name), type };
+    });
+}
+function renderModelStub(name, columns) {
+    const fieldLines = columns
+        .map((c) => `  ${c.name}?: ${mapTsType(c.type)};`)
+        .join('\n');
+    return `/**
+ * ${name} model stub — generated by \`npx rhino generate\`
+ * Register in rhino.setup.ts:
+ *   ${toCamelCase(name)}s: { model: '${name}' }
+ */
+import { RhinoModel } from '@rhino-dev/rhino-nestjs';
+
+@RhinoModel()
+export class ${name} {
+  id!: number;
+${fieldLines ? fieldLines + '\n' : ''}  createdAt?: Date;
+  updatedAt?: Date;
+}
+`;
+}
+// -----------------------------------------------------------------------
+// Policy
+// -----------------------------------------------------------------------
+function generatePolicy(cwd, name) {
+    const destPath = path.join(cwd, 'src', 'policies', `${name}.policy.ts`);
+    if ((0, io_1.fileExists)(destPath)) {
+        console.log(`  Skipped: ${destPath} already exists.`);
+        return;
+    }
+    const content = renderPolicyStub(name);
+    (0, io_1.writeFileSafely)(destPath, content);
+    console.log(`  Created: ${destPath}`);
+}
+function renderPolicyStub(name) {
+    return `/**
+ * ${name} policy stub — generated by \`npx rhino generate\`
+ * Extend ResourcePolicy and override the methods you need.
+ */
+import { ResourcePolicy } from '@rhino-dev/rhino-nestjs';
+
+export class ${name}Policy extends ResourcePolicy {
+  // override index(user: any): boolean { ... }
+  // override show(user: any, record: any): boolean { ... }
+  // override store(user: any): boolean { ... }
+  // override update(user: any, record: any): boolean { ... }
+  // override destroy(user: any, record: any): boolean { ... }
+}
+`;
+}
+// -----------------------------------------------------------------------
+// Scope
+// -----------------------------------------------------------------------
+function generateScope(cwd, name) {
+    const destPath = path.join(cwd, 'src', 'scopes', `${name}.scope.ts`);
+    if ((0, io_1.fileExists)(destPath)) {
+        console.log(`  Skipped: ${destPath} already exists.`);
+        return;
+    }
+    const content = renderScopeStub(name);
+    (0, io_1.writeFileSafely)(destPath, content);
+    console.log(`  Created: ${destPath}`);
+}
+function renderScopeStub(name) {
+    return `/**
+ * ${name} scope stub — generated by \`npx rhino generate\`
+ * Implement the \`apply\` method to filter / order the default query.
+ */
+import type { RhinoScope } from '@rhino-dev/rhino-nestjs';
+
+export class ${name}Scope implements RhinoScope {
+  apply(query: Record<string, any>, _context: any): Record<string, any> {
+    // Example: return { ...query, where: { ...query.where, deletedAt: null } };
+    return query;
+  }
+}
+`;
+}
+// -----------------------------------------------------------------------
+// String helpers
+// -----------------------------------------------------------------------
+function toPascalCase(str) {
+    if (!str)
+        return '';
+    return str
+        .replace(/[-_\s]+(.)/g, (_, c) => c.toUpperCase())
+        .replace(/^(.)/, (c) => c.toUpperCase());
+}
+function toCamelCase(str) {
+    const pascal = toPascalCase(str);
+    return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+function mapTsType(prismaType) {
+    const map = {
+        string: 'string',
+        text: 'string',
+        int: 'number',
+        integer: 'number',
+        float: 'number',
+        decimal: 'number',
+        boolean: 'boolean',
+        bool: 'boolean',
+        date: 'Date',
+        datetime: 'Date',
+        json: 'Record<string, unknown>',
+    };
+    return map[prismaType.toLowerCase()] ?? 'string';
+}
+//# sourceMappingURL=generate.command.js.map

package/dist/cli/commands/generate.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.command.js","sourceRoot":"","sources":["../../../src/cli/commands/generate.command.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/install.command.d.ts

@@ -0,0 +1,8 @@
+import { type ReadlineInterface } from '../utils/prompt';
+export interface InstallDeps {
+    rl?: ReadlineInterface;
+    cwd?: string;
+    /** Override skill source dir (for tests). */
+    skillsSourceDir?: string;
+}
+export declare function runInstall(deps?: InstallDeps): Promise<void>;

package/dist/cli/commands/install.command.js

@@ -0,0 +1,205 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInstall = runInstall;
+/**
+ * rhino install
+ *
+ * Interactive setup wizard.  Prompts the user to:
+ *   (a) configure a model-registration stub file
+ *   (b) enable multi-tenant mode
+ *   (c) set the org identifier column
+ *   (d) scaffold an audit-trail Prisma model
+ *   (e) install .claude/commands/ AI skill files from stubs/skills
+ *
+ * Writes a stub config to src/rhino.setup.ts.
+ * Appends an AuditLog Prisma model snippet to prisma/schema.prisma.
+ */
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const prompt_1 = require("../utils/prompt");
+const io_1 = require("../utils/io");
+const AUDIT_LOG_SNIPPET = `
+model AuditLog {
+  id         Int      @id @default(autoincrement())
+  userId     Int?
+  action     String   // create | update | delete
+  modelName  String
+  modelId    String
+  oldValues  Json?
+  newValues  Json?
+  ipAddress  String?
+  createdAt  DateTime @default(now())
+}
+`;
+async function runInstall(deps = {}) {
+    const cwd = deps.cwd ?? process.cwd();
+    const rl = deps.rl ?? (0, prompt_1.createInterface)();
+    console.log('\n  Rhino :: Install :: Let\'s build something great\n');
+    // ---------------------------------------------------------------
+    // (a) Model registration stub
+    // ---------------------------------------------------------------
+    const wantStub = await (0, prompt_1.confirm)(rl, 'Create a model-registration stub file (src/rhino.setup.ts)?', true);
+    if (wantStub) {
+        const stubPath = path.join(cwd, 'src', 'rhino.setup.ts');
+        if ((0, io_1.fileExists)(stubPath)) {
+            console.log(`  Skipped: ${stubPath} already exists.`);
+        }
+        else {
+            const stubContent = generateSetupStub(false, 'id');
+            (0, io_1.writeFileSafely)(stubPath, stubContent);
+            console.log(`  Created: ${stubPath}`);
+        }
+    }
+    // ---------------------------------------------------------------
+    // (b) Multi-tenant
+    // ---------------------------------------------------------------
+    const wantMultiTenant = await (0, prompt_1.confirm)(rl, 'Enable multi-tenant support (Organizations, Roles)?', false);
+    let orgIdentifierColumn = 'id';
+    if (wantMultiTenant) {
+        const col = await (0, prompt_1.ask)(rl, '  Which column identifies organizations? (id / slug / uuid) [id]: ');
+        orgIdentifierColumn = col || 'id';
+        // Re-write the setup stub if it was already written
+        const stubPath = path.join(cwd, 'src', 'rhino.setup.ts');
+        if ((0, io_1.fileExists)(stubPath)) {
+            const newContent = generateSetupStub(true, orgIdentifierColumn);
+            (0, io_1.writeFileSafely)(stubPath, newContent);
+            console.log(`  Updated: ${stubPath} (multi-tenant enabled)`);
+        }
+    }
+    // ---------------------------------------------------------------
+    // (d) Audit trail
+    // ---------------------------------------------------------------
+    const wantAudit = await (0, prompt_1.confirm)(rl, 'Scaffold an AuditLog model in prisma/schema.prisma?', false);
+    if (wantAudit) {
+        const schemaPath = path.join(cwd, 'prisma', 'schema.prisma');
+        if ((0, io_1.fileExists)(schemaPath)) {
+            const existing = fs.readFileSync(schemaPath, 'utf8');
+            if (existing.includes('AuditLog')) {
+                console.log('  Skipped: AuditLog already present in prisma/schema.prisma.');
+            }
+            else {
+                fs.appendFileSync(schemaPath, `\n${AUDIT_LOG_SNIPPET}`, 'utf8');
+                console.log(`  Appended AuditLog model to: ${schemaPath}`);
+            }
+        }
+        else {
+            console.log('  Could not find prisma/schema.prisma — please add the following snippet manually:');
+            console.log(AUDIT_LOG_SNIPPET);
+        }
+    }
+    // ---------------------------------------------------------------
+    // (e) AI skill files
+    // ---------------------------------------------------------------
+    const wantSkills = await (0, prompt_1.confirm)(rl, 'Install Rhino AI skills for Claude Code (.claude/commands/)?', true);
+    if (wantSkills) {
+        await installSkills(cwd, deps.skillsSourceDir);
+    }
+    rl.close();
+    console.log('\n  Rhino installed successfully!\n');
+    console.log('  Next steps:');
+    console.log('    1. Review src/rhino.setup.ts');
+    console.log('    2. Add your blueprints to .rhino/blueprints/');
+    console.log('    3. Run: npx rhino blueprint\n');
+}
+// -----------------------------------------------------------------------
+// Helpers
+// -----------------------------------------------------------------------
+function generateSetupStub(multiTenant, orgIdentifierColumn) {
+    return `/**
+ * Rhino setup — generated by \`npx rhino install\`
+ * Adjust this file to match your application's model configuration.
+ */
+import { RhinoModule } from '@rhino-dev/rhino-nestjs';
+// import { PrismaService } from './prisma/prisma.service';
+
+export const rhinoConfig = {
+  models: {
+    // Register your models here, e.g.:
+    // users: { model: 'User', policy: UserPolicy },
+  },
+  routeGroups: {
+    default: {
+      prefix: '',
+      models: '*' as const,
+    },
+  },
+  multiTenant: {
+    enabled: ${multiTenant},
+    organizationIdentifierColumn: '${orgIdentifierColumn}',
+  },
+  auth: {
+    jwtSecret: process.env.JWT_SECRET ?? 'change-me',
+    jwtExpiresIn: '7d',
+    userModel: 'user',
+    emailField: 'email',
+    passwordField: 'password',
+  },
+};
+
+// Add to your AppModule imports:
+// RhinoModule.forRoot(rhinoConfig)
+`;
+}
+async function installSkills(cwd, overrideSource) {
+    // The skills dir is shipped alongside the package under stubs/skills.
+    // Resolve relative to this file so it works from both source and dist.
+    const skillsSourceDir = overrideSource ??
+        path.resolve(__dirname, '..', '..', '..', 'stubs', 'skills');
+    const destDir = path.join(cwd, '.claude', 'commands');
+    fs.mkdirSync(destDir, { recursive: true });
+    if (!(0, io_1.fileExists)(skillsSourceDir)) {
+        console.log('  No skill files found (stubs/skills directory missing). Skipping.');
+        return;
+    }
+    const files = fs
+        .readdirSync(skillsSourceDir)
+        .filter((f) => f.startsWith('rhino-') && f.endsWith('.md'));
+    if (files.length === 0) {
+        console.log('  No rhino-*.md skill files found. Skipping.');
+        return;
+    }
+    let installed = 0;
+    for (const file of files) {
+        const src = path.join(skillsSourceDir, file);
+        const dest = path.join(destDir, file);
+        fs.copyFileSync(src, dest);
+        console.log(`  Installed: .claude/commands/${file}`);
+        installed++;
+    }
+    console.log(`\n  ${installed} Rhino skills installed to .claude/commands/`);
+    console.log('  Run any skill in Claude Code: /rhino-feature, /rhino-review, etc.');
+}
+//# sourceMappingURL=install.command.js.map

package/dist/cli/commands/install.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.command.js","sourceRoot":"","sources":["../../../src/cli/commands/install.command.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * Rhino CLI entry point.
+ *
+ * Usage:
+ *   npx rhino install
+ *   npx rhino generate
+ *   npx rhino blueprint [--force] [--dry-run] [--model=slug]
+ *   npx rhino export-postman [--output=file.json] [--base-url=http://localhost:3000/api]
+ *   npx rhino export-types [--output=path/to/types.d.ts]
+ */
+/** Extract --key=value or presence of --flag from argv. */
+export declare function parseFlags(argv: string[]): Record<string, string | true>;
+/** Return the first positional arg (not starting with --) after index `from`. */
+export declare function extractCommand(argv: string[]): string | undefined;
+export declare function printHelp(): void;
+export declare function main(argv?: string[]): Promise<void>;

package/dist/cli/index.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Rhino CLI entry point.
+ *
+ * Usage:
+ *   npx rhino install
+ *   npx rhino generate
+ *   npx rhino blueprint [--force] [--dry-run] [--model=slug]
+ *   npx rhino export-postman [--output=file.json] [--base-url=http://localhost:3000/api]
+ *   npx rhino export-types [--output=path/to/types.d.ts]
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFlags = parseFlags;
+exports.extractCommand = extractCommand;
+exports.printHelp = printHelp;
+exports.main = main;
+const install_command_1 = require("./commands/install.command");
+const generate_command_1 = require("./commands/generate.command");
+const blueprint_command_1 = require("./commands/blueprint.command");
+const export_postman_command_1 = require("./commands/export-postman.command");
+const export_types_command_1 = require("./commands/export-types.command");
+// -----------------------------------------------------------------------
+// Flag parsing helpers
+// -----------------------------------------------------------------------
+/** Extract --key=value or presence of --flag from argv. */
+function parseFlags(argv) {
+    const flags = {};
+    for (const arg of argv) {
+        if (!arg.startsWith('--'))
+            continue;
+        const withoutDashes = arg.slice(2);
+        const eqIdx = withoutDashes.indexOf('=');
+        if (eqIdx === -1) {
+            flags[withoutDashes] = true;
+        }
+        else {
+            flags[withoutDashes.slice(0, eqIdx)] = withoutDashes.slice(eqIdx + 1);
+        }
+    }
+    return flags;
+}
+/** Return the first positional arg (not starting with --) after index `from`. */
+function extractCommand(argv) {
+    return argv.find((a) => !a.startsWith('--') && !a.startsWith('-'));
+}
+// -----------------------------------------------------------------------
+// Help
+// -----------------------------------------------------------------------
+function printHelp() {
+    console.log(`
+  rhino <command> [options]
+
+  Commands:
+    install          Interactive setup wizard
+    generate         Generate a model, policy, or scope stub
+    blueprint        Generate code from YAML blueprints
+    export-postman   Export a Postman collection
+    export-types     Export TypeScript type definitions
+
+  Options (by command):
+    blueprint
+      --force          Re-generate even if unchanged
+      --dry-run        Preview without writing files
+      --model=<slug>   Process a single blueprint by slug
+
+    export-postman
+      --output=<file>       Output path (default: postman_collection.json)
+      --base-url=<url>      Base URL (default: http://localhost:3000/api)
+
+    export-types
+      --output=<file>       Output path (default: src/types/rhino.d.ts)
+`);
+}
+// -----------------------------------------------------------------------
+// Main dispatcher
+// -----------------------------------------------------------------------
+async function main(argv = process.argv.slice(2)) {
+    const command = extractCommand(argv);
+    const flags = parseFlags(argv);
+    switch (command) {
+        case 'install':
+            await (0, install_command_1.runInstall)();
+            break;
+        case 'generate':
+            await (0, generate_command_1.runGenerate)();
+            break;
+        case 'blueprint':
+            await (0, blueprint_command_1.runBlueprint)({
+                force: flags['force'] === true,
+                dryRun: flags['dry-run'] === true,
+                model: typeof flags['model'] === 'string' ? flags['model'] : undefined,
+            });
+            break;
+        case 'export-postman':
+            await (0, export_postman_command_1.runExportPostman)({
+                output: typeof flags['output'] === 'string' ? flags['output'] : undefined,
+                baseUrl: typeof flags['base-url'] === 'string' ? flags['base-url'] : undefined,
+            });
+            break;
+        case 'export-types':
+            await (0, export_types_command_1.runExportTypes)({
+                output: typeof flags['output'] === 'string' ? flags['output'] : undefined,
+            });
+            break;
+        default:
+            printHelp();
+            if (command !== undefined) {
+                // Unknown command — exit with error
+                console.error(`  Unknown command: ${command}\n`);
+                process.exit(1);
+            }
+            break;
+    }
+}
+// Run only when invoked directly (not when require()'d in tests).
+if (require.main === module) {
+    main().catch((err) => {
+        console.error(err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/cli/utils/io.d.ts

@@ -0,0 +1,12 @@
+/** Return true when a file (or directory) exists. */
+export declare function fileExists(filePath: string): boolean;
+/**
+ * Write content to a file, creating parent directories as needed.
+ * Writes to a tmp path first then renames for an atomic-ish write.
+ */
+export declare function writeFileSafely(filePath: string, content: string): void;
+/**
+ * Append `content` to `filePath` only when the exact string is not
+ * already present (prevents duplicate entries on re-runs).
+ */
+export declare function appendIfMissing(filePath: string, content: string): void;