@rhino-dev/rhino-nestjs 0.2.5

package/dist/blueprint/generators/resource-definition-generator.d.ts

@@ -0,0 +1,52 @@
+import type { Blueprint } from '../blueprint-parser';
+/**
+ * Generates a TypeScript file that exports a `ModelRegistration` object.
+ *
+ * The output file:
+ *  - imports `z` from zod and `ModelRegistration` from the library
+ *  - builds `validationStore` and `validationUpdate` as `Record<string, ZodSchema>`
+ *    keyed by role (from `permissions.*.create_fields` / `update_fields`)
+ *  - sets `allowedFilters`, `allowedSorts`, `allowedSearch` from column flags
+ *  - sets `belongsToOrganization`, `softDeletes`, `hasAuditTrail` flags
+ *
+ * Design decisions:
+ *  - Field entries with value `'required'` → `z.string()` (non-optional)
+ *  - Field entries with value `'nullable'` → `z.string().nullable().optional()`
+ *  - Field entries with value `'sometimes'` → `z.string().optional()`
+ *  - When create_fields / update_fields is `['*']` or empty, we emit a
+ *    passthrough schema `z.object({}).passthrough()` as a permissive default.
+ *  - If all roles share the same schema we still emit a role-keyed map for
+ *    uniformity (the runtime ValidationService uses the map form).
+ */
+export declare class ResourceDefinitionGenerator {
+    generate(blueprint: Blueprint): string;
+    /**
+     * Build a map of role → Zod schema code string for a given field surface
+     * ('create_fields' or 'update_fields').
+     */
+    private buildRoleSchemas;
+    private buildZodSchema;
+    /**
+     * BP-003: derive presence from a column's `nullable` flag when no explicit
+     * modifier was given.
+     *
+     *   nullable: false, no default → 'required' on create, 'sometimes' on update
+     *   nullable: false, has default → 'sometimes' on both (DB will fill in)
+     *   nullable: true               → 'nullable' on both surfaces
+     *
+     * Fallback to 'optional' when the column isn't declared (unlikely but safe).
+     */
+    private inferPresenceFromColumn;
+    /**
+     * Determine the Zod type for a single field based on its column definition and presence modifier.
+     *
+     * Presence values:
+     *   'required'  → z.string()           (must be present, not null)
+     *   'nullable'  → z.string().nullable().optional()
+     *   'sometimes' → z.string().optional()
+     *   'optional'  → z.string().optional()  (when presence not specified)
+     */
+    private zodTypeForColumn;
+    private zodBaseType;
+    private camelCase;
+}

package/dist/blueprint/generators/resource-definition-generator.js

@@ -0,0 +1,229 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceDefinitionGenerator = void 0;
+// ---------------------------------------------------------------------------
+// ResourceDefinitionGenerator
+// ---------------------------------------------------------------------------
+/**
+ * Generates a TypeScript file that exports a `ModelRegistration` object.
+ *
+ * The output file:
+ *  - imports `z` from zod and `ModelRegistration` from the library
+ *  - builds `validationStore` and `validationUpdate` as `Record<string, ZodSchema>`
+ *    keyed by role (from `permissions.*.create_fields` / `update_fields`)
+ *  - sets `allowedFilters`, `allowedSorts`, `allowedSearch` from column flags
+ *  - sets `belongsToOrganization`, `softDeletes`, `hasAuditTrail` flags
+ *
+ * Design decisions:
+ *  - Field entries with value `'required'` → `z.string()` (non-optional)
+ *  - Field entries with value `'nullable'` → `z.string().nullable().optional()`
+ *  - Field entries with value `'sometimes'` → `z.string().optional()`
+ *  - When create_fields / update_fields is `['*']` or empty, we emit a
+ *    passthrough schema `z.object({}).passthrough()` as a permissive default.
+ *  - If all roles share the same schema we still emit a role-keyed map for
+ *    uniformity (the runtime ValidationService uses the map form).
+ */
+class ResourceDefinitionGenerator {
+    generate(blueprint) {
+        const lines = [];
+        lines.push(`// Generated by Rhino Blueprint — do not edit directly.`);
+        lines.push(`// Source: .rhino/blueprints/${blueprint.source_file}`);
+        lines.push(`import { z } from 'zod';`);
+        lines.push(`import type { ModelRegistration } from '@rhino-dev/rhino-nestjs';`);
+        lines.push('');
+        // Policy import (generated separately)
+        lines.push(`import { ${blueprint.model}Policy } from '../policies/${blueprint.model}Policy';`);
+        lines.push('');
+        // Zod schemas per role
+        const storeSchemas = this.buildRoleSchemas(blueprint, 'create_fields');
+        const updateSchemas = this.buildRoleSchemas(blueprint, 'update_fields');
+        lines.push('// ---------------------------------------------------------------------------');
+        lines.push('// Validation schemas per role');
+        lines.push('// ---------------------------------------------------------------------------');
+        lines.push('');
+        lines.push('const validationStore: Record<string, z.ZodTypeAny> = {');
+        for (const [role, schemaCode] of Object.entries(storeSchemas)) {
+            lines.push(`  ${role}: ${schemaCode},`);
+        }
+        lines.push('};');
+        lines.push('');
+        lines.push('const validationUpdate: Record<string, z.ZodTypeAny> = {');
+        for (const [role, schemaCode] of Object.entries(updateSchemas)) {
+            lines.push(`  ${role}: ${schemaCode},`);
+        }
+        lines.push('};');
+        lines.push('');
+        // Allowed query options from column flags
+        const allowedFilters = blueprint.columns.filter((c) => c.filterable).map((c) => c.name);
+        const allowedSorts = blueprint.columns.filter((c) => c.sortable).map((c) => c.name);
+        const allowedSearch = blueprint.columns.filter((c) => c.searchable).map((c) => c.name);
+        lines.push('// ---------------------------------------------------------------------------');
+        lines.push('// ModelRegistration');
+        lines.push('// ---------------------------------------------------------------------------');
+        lines.push('');
+        lines.push(`export const ${this.camelCase(blueprint.slug)}Registration: ModelRegistration = {`);
+        lines.push(`  model: '${this.camelCase(blueprint.model)}',`);
+        lines.push(`  policy: ${blueprint.model}Policy,`);
+        lines.push(`  validationStore,`);
+        lines.push(`  validationUpdate,`);
+        if (allowedFilters.length > 0) {
+            lines.push(`  allowedFilters: ${JSON.stringify(allowedFilters)},`);
+        }
+        if (allowedSorts.length > 0) {
+            lines.push(`  allowedSorts: ${JSON.stringify(allowedSorts)},`);
+        }
+        if (allowedSearch.length > 0) {
+            lines.push(`  allowedSearch: ${JSON.stringify(allowedSearch)},`);
+        }
+        lines.push(`  belongsToOrganization: ${blueprint.options.belongs_to_organization},`);
+        lines.push(`  softDeletes: ${blueprint.options.soft_deletes},`);
+        lines.push(`  hasAuditTrail: ${blueprint.options.audit_trail},`);
+        if (blueprint.options.has_uuid) {
+            // BP-005: surface the flag so ResourceService.castId preserves string IDs
+            lines.push(`  hasUuid: true,`);
+        }
+        // BP-004: emit `owner` / `fkConstraints` from YAML when declared so
+        // ValidationService.verifyTenantFks (and the FK chain walker) can do
+        // cross-tenant validation without a hand-authored override.
+        const ownerStr = blueprint.options.owner_chain ?? blueprint.options.owner ?? null;
+        if (ownerStr) {
+            lines.push(`  owner: ${JSON.stringify(ownerStr)},`);
+        }
+        if (blueprint.fk_constraints?.length > 0) {
+            lines.push(`  fkConstraints: ${JSON.stringify(blueprint.fk_constraints)},`);
+        }
+        if (blueprint.options.except_actions?.length > 0) {
+            lines.push(`  exceptActions: ${JSON.stringify(blueprint.options.except_actions)},`);
+        }
+        lines.push(`};`);
+        lines.push('');
+        return lines.join('\n');
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Build a map of role → Zod schema code string for a given field surface
+     * ('create_fields' or 'update_fields').
+     */
+    buildRoleSchemas(blueprint, surface) {
+        const result = {};
+        for (const [role, perm] of Object.entries(blueprint.permissions)) {
+            result[role] = this.buildZodSchema(perm, surface, blueprint.columns);
+        }
+        return result;
+    }
+    buildZodSchema(perm, surface, columns) {
+        const fields = perm[surface];
+        // Wildcard → passthrough permissive schema
+        if (Array.isArray(fields) && fields[0] === '*') {
+            return `z.object({}).passthrough()`;
+        }
+        // Array form (no presence modifiers) — BP-003: infer required from
+        // the column's `nullable: false` declaration. This lets blueprints
+        // express "required title" purely via the column definition, without
+        // forcing the object form { title: required } on every permission.
+        if (Array.isArray(fields)) {
+            if (fields.length === 0)
+                return `z.object({})`;
+            const entries = fields.map((f) => {
+                const col = columns.find((c) => c.name === f);
+                // For create surface: non-nullable column → required; nullable → optional/nullable.
+                // For update surface: always optional (partial update semantics); keep nullable.
+                const presence = this.inferPresenceFromColumn(col, surface);
+                return `    ${f}: ${this.zodTypeForColumn(f, columns, presence)}`;
+            });
+            return `z.object({\n${entries.join(',\n')},\n  })`;
+        }
+        // Object form: { fieldName: 'required' | 'nullable' | 'sometimes' }
+        const entries = Object.entries(fields ?? {}).map(([field, presence]) => {
+            const zodType = this.zodTypeForColumn(field, columns, presence);
+            return `    ${field}: ${zodType}`;
+        });
+        // Empty object — role has no writable fields (e.g. read-only roles)
+        if (entries.length === 0)
+            return `z.object({})`;
+        return `z.object({\n${entries.join(',\n')},\n  })`;
+    }
+    /**
+     * BP-003: derive presence from a column's `nullable` flag when no explicit
+     * modifier was given.
+     *
+     *   nullable: false, no default → 'required' on create, 'sometimes' on update
+     *   nullable: false, has default → 'sometimes' on both (DB will fill in)
+     *   nullable: true               → 'nullable' on both surfaces
+     *
+     * Fallback to 'optional' when the column isn't declared (unlikely but safe).
+     */
+    inferPresenceFromColumn(col, surface) {
+        if (!col)
+            return 'optional';
+        if (col.nullable)
+            return 'nullable';
+        // BP-003 followup: columns with a default value can be omitted on create
+        // — the DB (or Prisma @default) supplies the value.
+        if (col.default !== null && col.default !== undefined)
+            return 'sometimes';
+        return surface === 'create_fields' ? 'required' : 'sometimes';
+    }
+    /**
+     * Determine the Zod type for a single field based on its column definition and presence modifier.
+     *
+     * Presence values:
+     *   'required'  → z.string()           (must be present, not null)
+     *   'nullable'  → z.string().nullable().optional()
+     *   'sometimes' → z.string().optional()
+     *   'optional'  → z.string().optional()  (when presence not specified)
+     */
+    zodTypeForColumn(fieldName, columns, presence) {
+        const col = columns.find((c) => c.name === fieldName);
+        const baseType = col ? this.zodBaseType(col) : 'z.string()';
+        switch (presence) {
+            case 'required':
+                return baseType;
+            case 'nullable':
+                return `${baseType}.nullable().optional()`;
+            case 'sometimes':
+            case 'optional':
+                return `${baseType}.optional()`;
+            default:
+                return `${baseType}.optional()`;
+        }
+    }
+    zodBaseType(col) {
+        switch (col.type) {
+            case 'string':
+            case 'text':
+            case 'uuid':
+                return 'z.string()';
+            case 'integer':
+            case 'bigInteger':
+            case 'foreignId':
+                return 'z.number().int()';
+            case 'float':
+            case 'decimal':
+                return 'z.number()';
+            case 'boolean':
+                return 'z.boolean()';
+            case 'date':
+            case 'datetime':
+            case 'timestamp':
+                return 'z.string().datetime({ offset: true }).or(z.date())';
+            case 'json':
+                return 'z.record(z.unknown())';
+            case 'enum':
+                if (col.values?.length) {
+                    const vals = col.values.map((v) => `'${v}'`).join(', ');
+                    return `z.enum([${vals}])`;
+                }
+                return 'z.string()';
+            default:
+                return 'z.string()';
+        }
+    }
+    camelCase(str) {
+        return str.replace(/[-_](.)/g, (_, c) => c.toUpperCase());
+    }
+}
+exports.ResourceDefinitionGenerator = ResourceDefinitionGenerator;
+//# sourceMappingURL=resource-definition-generator.js.map

package/dist/blueprint/generators/resource-definition-generator.js.map

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

package/dist/blueprint/generators/seeder-generator.d.ts

@@ -0,0 +1,21 @@
+import type { Blueprint } from '../blueprint-parser';
+/**
+ * Generates a TypeScript seeder file for a Blueprint resource.
+ *
+ * The generated file exports an async `seed` function that creates a small
+ * number of sample rows via the Prisma client.
+ *
+ * Design decisions:
+ *  - We generate 3 sample rows with slightly varied data.
+ *  - `organizationId` defaults to 1 when `belongs_to_organization` is true.
+ *  - The seeder is a plain async function — not a NestJS service — so it can
+ *    be run standalone via `ts-node src/seeders/<Model>Seeder.ts`.
+ */
+export declare class SeederGenerator {
+    generate(blueprint: Blueprint): string;
+    private buildRow;
+    private sampleValue;
+    private humanize;
+    private formatObject;
+    private camelCase;
+}

package/dist/blueprint/generators/seeder-generator.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SeederGenerator = void 0;
+// ---------------------------------------------------------------------------
+// SeederGenerator
+// ---------------------------------------------------------------------------
+/**
+ * Generates a TypeScript seeder file for a Blueprint resource.
+ *
+ * The generated file exports an async `seed` function that creates a small
+ * number of sample rows via the Prisma client.
+ *
+ * Design decisions:
+ *  - We generate 3 sample rows with slightly varied data.
+ *  - `organizationId` defaults to 1 when `belongs_to_organization` is true.
+ *  - The seeder is a plain async function — not a NestJS service — so it can
+ *    be run standalone via `ts-node src/seeders/<Model>Seeder.ts`.
+ */
+class SeederGenerator {
+    generate(blueprint) {
+        const { model, options, columns } = blueprint;
+        const prismaModel = this.camelCase(model);
+        const lines = [];
+        lines.push(`// Generated by Rhino Blueprint — do not edit directly.`);
+        lines.push(`// Source: .rhino/blueprints/${blueprint.source_file}`);
+        lines.push(`import { PrismaClient } from '@prisma/client';`);
+        lines.push(``);
+        lines.push(`const prisma = new PrismaClient();`);
+        lines.push(``);
+        lines.push(`/**`);
+        lines.push(` * Seed sample ${model} rows.`);
+        lines.push(` * Run: npx ts-node src/seeders/${model}Seeder.ts`);
+        lines.push(` */`);
+        lines.push(`export async function seed(): Promise<void> {`);
+        lines.push(`  console.log('Seeding ${model}...');`);
+        lines.push(``);
+        const rows = [1, 2, 3].map((i) => this.buildRow(blueprint, i));
+        for (let i = 0; i < rows.length; i++) {
+            lines.push(`  await prisma.${prismaModel}.upsert({`);
+            // BP-005: UUID-PK models need string ids, not integer ids.
+            if (blueprint.options.has_uuid) {
+                const uuid = `00000000-0000-0000-0000-00000000000${i + 1}`;
+                lines.push(`    where: { id: '${uuid}' },`);
+            }
+            else {
+                lines.push(`    where: { id: ${i + 1} },`);
+            }
+            lines.push(`    update: {},`);
+            lines.push(`    create: ${this.formatObject(rows[i], 4)},`);
+            lines.push(`  });`);
+            lines.push(``);
+        }
+        lines.push(`  console.log('✓ ${model} seeded (${rows.length} rows)');`);
+        lines.push(`}`);
+        lines.push(``);
+        lines.push(`// Allow running directly`);
+        lines.push(`if (require.main === module) {`);
+        lines.push(`  seed()`);
+        lines.push(`    .catch(console.error)`);
+        lines.push(`    .finally(() => prisma.$disconnect());`);
+        lines.push(`}`);
+        lines.push(``);
+        return lines.join('\n');
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    buildRow(blueprint, index) {
+        // BP-005: UUID-PK models use deterministic UUID strings so seed is
+        // idempotent (upsert where id:'00...001' etc.).
+        const id = blueprint.options.has_uuid
+            ? `00000000-0000-0000-0000-00000000000${index}`
+            : index;
+        const row = { id };
+        if (blueprint.options.belongs_to_organization) {
+            row['organizationId'] = 1;
+        }
+        for (const col of blueprint.columns) {
+            row[col.name] = this.sampleValue(col, index);
+        }
+        return row;
+    }
+    sampleValue(col, index) {
+        if (col.default !== null && col.default !== undefined) {
+            // Use default when available
+            return col.default;
+        }
+        switch (col.type) {
+            case 'string':
+                return `Sample ${this.humanize(col.name)} ${index}`;
+            case 'text':
+                return `Sample ${this.humanize(col.name)} content for row ${index}.`;
+            case 'integer':
+            case 'bigInteger':
+                return index * 10;
+            case 'foreignId':
+                return 1; // reference first record
+            case 'float':
+            case 'decimal':
+                return parseFloat((index * 9.99).toFixed(2));
+            case 'boolean':
+                return index % 2 === 1;
+            case 'date':
+            case 'datetime':
+            case 'timestamp':
+                return new Date(`2024-0${index}-01T00:00:00Z`).toISOString();
+            case 'json':
+                return { sample: true, index };
+            case 'uuid':
+                return `00000000-0000-0000-0000-00000000000${index}`;
+            case 'enum':
+                return col.values?.[0] ?? 'draft';
+            default:
+                return `value_${index}`;
+        }
+    }
+    humanize(name) {
+        return name.replace(/[_-]/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase());
+    }
+    formatObject(obj, indent) {
+        const pad = ' '.repeat(indent);
+        const innerPad = ' '.repeat(indent + 2);
+        const entries = Object.entries(obj).map(([k, v]) => {
+            const val = JSON.stringify(v);
+            return `${innerPad}${k}: ${val}`;
+        });
+        return `{\n${entries.join(',\n')},\n${pad}}`;
+    }
+    camelCase(str) {
+        const pascal = str.replace(/[-_](.)/g, (_, c) => c.toUpperCase());
+        return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+    }
+}
+exports.SeederGenerator = SeederGenerator;
+//# sourceMappingURL=seeder-generator.js.map

package/dist/blueprint/generators/seeder-generator.js.map

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

package/dist/blueprint/generators/test-generator.d.ts

@@ -0,0 +1,28 @@
+import type { Blueprint } from '../blueprint-parser';
+/**
+ * Generates a Jest spec for a blueprint resource.
+ *
+ * Produces a self-contained file using the library's `buildEnv` helper, which
+ * the library ships under `test/helpers/make-controller.ts`. Consumer apps
+ * can copy that helper into their own test tree or replace the import path
+ * with their own equivalent — a comment in the generated file explains how.
+ *
+ * Tests produced:
+ *   1. CRUD happy-path (index / show / store / update / destroy)
+ *   2. 403 when a restricted role attempts a write action
+ *   3. 404 for cross-tenant access (when `belongs_to_organization: true`)
+ *
+ * Controller invocation uses the real `GlobalController` public method
+ * signatures:  `index(modelSlug, query, req)`, `show(modelSlug, id, query, req)`,
+ * `store(modelSlug, body, req)`, `update(modelSlug, id, body, req)`,
+ * `destroy(modelSlug, id, req)`.
+ */
+export declare class TestGenerator {
+    generate(blueprint: Blueprint): string;
+    private permissionsFor;
+    private buildSampleRow;
+    private buildCreatePayload;
+    private buildUpdatePayload;
+    private sampleValue;
+    private camelCase;
+}