@rawan-temo/prisma-zod-generator 3.3.1-config-coercion.0

package/lib/types/safety.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Safety system configuration types
+ */
+/**
+ * Safety levels provide preset configurations for different use cases
+ */
+export type SafetyLevel = 'strict' | 'standard' | 'permissive' | 'disabled';
+/**
+ * Granular safety configuration options for advanced control
+ */
+export interface SafetyOptions {
+    /**
+     * Overall safety level preset
+     * @default 'standard'
+     */
+    level?: SafetyLevel;
+    /**
+     * Master switch to enable/disable all safety features
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Allow generation in directories with dangerous names (src, lib, components, etc.)
+     * @default false (warnings shown)
+     */
+    allowDangerousPaths?: boolean;
+    /**
+     * Allow generation in project root directories (containing package.json, etc.)
+     * @default false (hard block)
+     */
+    allowProjectRoots?: boolean;
+    /**
+     * Allow generation in directories containing user files
+     * @default false (warnings/blocks based on count)
+     */
+    allowUserFiles?: boolean;
+    /**
+     * Skip manifest tracking and cleanup
+     * @default false
+     */
+    skipManifest?: boolean;
+    /**
+     * Only show warnings, never block generation
+     * @default false
+     */
+    warningsOnly?: boolean;
+    /**
+     * Custom dangerous path patterns to check (in addition to built-in ones)
+     */
+    customDangerousPaths?: string[];
+    /**
+     * Custom project file patterns to check (in addition to built-in ones)
+     */
+    customProjectFiles?: string[];
+    /**
+     * Maximum number of user files allowed before blocking (ignored if allowUserFiles is true)
+     * @default 5
+     */
+    maxUserFiles?: number;
+}
+/**
+ * Resolved safety configuration after applying defaults and level presets
+ */
+export interface ResolvedSafetyConfig {
+    enabled: boolean;
+    allowDangerousPaths: boolean;
+    allowProjectRoots: boolean;
+    allowUserFiles: boolean;
+    skipManifest: boolean;
+    warningsOnly: boolean;
+    customDangerousPaths: string[];
+    customProjectFiles: string[];
+    maxUserFiles: number;
+    level: SafetyLevel;
+}
+/**
+ * Safety check result with configuration-aware decisions
+ */
+export interface ConfigurableSafetyResult {
+    isSafe: boolean;
+    warnings: string[];
+    errors: string[];
+    blocked: boolean;
+    bypassReason?: string;
+}

package/lib/types/safety.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Safety system configuration types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=safety.js.map

package/lib/types/safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../src/types/safety.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/lib/types/variants.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Variant Management System Types
+ * Defines TypeScript interfaces for schema variant generation system
+ */
+import { DMMF } from '@prisma/generator-helper';
+/**
+ * Supported schema variant types
+ */
+export declare enum VariantType {
+    PURE = "pure",// Raw model schema
+    INPUT = "input",// API input validation
+    RESULT = "result"
+}
+/**
+ * File naming configuration for variants
+ */
+export interface NamingConfig {
+    suffix: string;
+    schemaNameSuffix: string;
+    typeNameSuffix: string;
+}
+/**
+ * Field exclusion rules for variants
+ */
+export interface FieldExclusionRule {
+    excludeFields?: string[];
+    excludeFieldTypes?: string[];
+    excludeRelations?: boolean;
+    excludeAutoGenerated?: boolean;
+    excludeWithAttributes?: string[];
+}
+/**
+ * Validation customization for variants
+ */
+export interface ValidationCustomization {
+    fieldValidations?: Record<string, string>;
+    additionalValidations?: Record<string, string[]>;
+    disableInlineValidations?: boolean;
+    validationTemplates?: Record<string, string>;
+    partial?: boolean;
+}
+/**
+ * Schema generation options for variants
+ */
+export interface SchemaGenerationOptions {
+    includeDocumentation?: boolean;
+    includeExamples?: boolean;
+    generateTypes?: boolean;
+    includeStatistics?: boolean;
+    customImports?: string[];
+}
+/**
+ * Configuration for a single variant
+ */
+export interface VariantConfig {
+    type: VariantType;
+    enabled: boolean;
+    naming: NamingConfig;
+    fieldExclusions: FieldExclusionRule;
+    validationCustomizations: ValidationCustomization;
+    schemaOptions: SchemaGenerationOptions;
+    priority: number;
+}
+/**
+ * Global variant management configuration
+ */
+export interface VariantManagerConfig {
+    outputDirectory: string;
+    enableVariants: boolean;
+    variantDefaults: Record<VariantType, Partial<VariantConfig>>;
+    modelOverrides: Record<string, Partial<Record<VariantType, Partial<VariantConfig>>>>;
+    globalNaming: {
+        useModelPrefix: boolean;
+        usePascalCase: boolean;
+        customSeparator?: string;
+    };
+}
+/**
+ * Variant generation result
+ */
+export interface VariantGenerationResult {
+    variantType: VariantType;
+    fileName: string;
+    filePath: string;
+    schemaName: string;
+    typeName: string;
+    content: string;
+    dependencies: string[];
+    exports: Set<string>;
+    imports: Set<string>;
+    fieldCount: number;
+    excludedFieldCount: number;
+    validationCount: number;
+    errors: string[];
+}
+/**
+ * Collection of all variant results for a model
+ */
+export interface ModelVariantCollection {
+    modelName: string;
+    variants: Record<VariantType, VariantGenerationResult | null>;
+    dependencies: Set<string>;
+    crossVariantReferences: Record<VariantType, VariantType[]>;
+    indexFile: {
+        fileName: string;
+        content: string;
+        exports: Set<string>;
+    };
+    generationSummary: {
+        totalVariants: number;
+        successfulVariants: number;
+        failedVariants: number;
+        totalErrors: number;
+        processingTime: number;
+    };
+}
+/**
+ * Variant manager interface
+ */
+export interface VariantManager {
+    generateModelVariants(model: DMMF.Model, config?: Partial<VariantManagerConfig>): Promise<ModelVariantCollection>;
+    generateVariant(model: DMMF.Model, variantType: VariantType, config?: Partial<VariantConfig>): Promise<VariantGenerationResult>;
+    validateConfig(config: VariantManagerConfig): {
+        isValid: boolean;
+        errors: string[];
+        warnings: string[];
+    };
+    getDefaultConfig(variantType: VariantType): VariantConfig;
+    resolveDependencies(collections: ModelVariantCollection[]): {
+        dependencyOrder: string[];
+        circularDependencies: string[][];
+        unresolvedDependencies: string[];
+    };
+}

package/lib/types/variants.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Variant Management System Types
+ * Defines TypeScript interfaces for schema variant generation system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VariantType = void 0;
+/**
+ * Supported schema variant types
+ */
+var VariantType;
+(function (VariantType) {
+    VariantType["PURE"] = "pure";
+    VariantType["INPUT"] = "input";
+    VariantType["RESULT"] = "result";
+})(VariantType || (exports.VariantType = VariantType = {}));
+/*
+ * The four DEFAULT_* constant tables that used to live here (naming configs,
+ * field exclusions, validation customizations, schema options) were read only by
+ * src/variants/{generator,config,exports}.ts and src/utils/naming.ts — an
+ * abandoned second implementation of the variants feature. The shipped one lives
+ * in prisma-generator.ts, transformer.ts, generators/model.ts and
+ * utils/naming-resolver.ts. All five files were removed, so the tables went with
+ * them; `VariantConfig` below is what config/parser.ts and config/defaults.ts
+ * actually use.
+ */
+//# sourceMappingURL=variants.js.map

package/lib/types/variants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variants.js","sourceRoot":"","sources":["../../src/types/variants.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH;;GAEG;AACH,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,4BAAa,CAAA;IACb,8BAAe,CAAA;IACf,gCAAiB,CAAA;AACnB,CAAC,EAJW,WAAW,2BAAX,WAAW,QAItB;AAyKD;;;;;;;;;GASG"}

package/lib/types.d.ts

@@ -0,0 +1,13 @@
+import type { DMMF as PrismaDMMF } from '@prisma/generator-helper';
+export type TransformerParams = {
+    enumTypes?: SchemaEnumWithValues[];
+    fields?: PrismaDMMF.SchemaArg[];
+    name?: string;
+    models?: PrismaDMMF.Model[];
+    modelOperations?: PrismaDMMF.ModelMapping[];
+    isDefaultPrismaClientOutput?: boolean;
+    prismaClientOutputPath?: string;
+};
+export type SchemaEnumWithValues = PrismaDMMF.SchemaEnum & {
+    values: string[];
+};

package/lib/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/lib/utils/businessSecurity.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The gate `license.ts` consults before letting a paid feature run.
+ *
+ * This file described itself as "comprehensive protection against business logic
+ * vulnerabilities including authorization bypasses, privilege escalation, and data leakage",
+ * and was 520 lines of exactly that shape: an authorization rule registry, tenant-isolation
+ * checks, a recursive `sanitizeData` for sensitive fields, and an audit log.
+ *
+ * None of it was reachable. `validateFeatureAccess` is the only thing any caller uses; the
+ * registry, the sanitiser and the audit log had no readers at all, so nothing was being
+ * protected by them. What is left is the licence gate itself, which is real and tested in
+ * tests/business-security-gate.test.ts.
+ */
+import { LicenseInfo } from '../license';
+export interface SecurityContext {
+    userId: string;
+    roles: string[];
+    tenantId?: string;
+    permissions: string[];
+    sessionId: string;
+    isAdmin: boolean;
+    licenseInfo?: LicenseInfo;
+}
+export declare class BusinessSecurityError extends Error {
+    readonly errorType: 'authorization' | 'tenant_isolation' | 'privilege_escalation' | 'data_leakage';
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(message: string, errorType: 'authorization' | 'tenant_isolation' | 'privilege_escalation' | 'data_leakage', context?: Record<string, unknown> | undefined);
+}
+/**
+ * Business Logic Security Manager
+ */
+export declare class BusinessSecurity {
+    /**
+     * Validate feature access with comprehensive checks
+     */
+    validateFeatureAccess(feature: string, license: LicenseInfo | null, context: SecurityContext): {
+        allowed: boolean;
+        reason?: string;
+    };
+    private getFeaturePlans;
+    private getMinimumPlan;
+    private describePlan;
+    private validateSecurityContext;
+}
+/**
+ * Global business security instance
+ */
+export declare const businessSecurity: BusinessSecurity;

package/lib/utils/businessSecurity.js

@@ -0,0 +1,129 @@
+"use strict";
+/**
+ * The gate `license.ts` consults before letting a paid feature run.
+ *
+ * This file described itself as "comprehensive protection against business logic
+ * vulnerabilities including authorization bypasses, privilege escalation, and data leakage",
+ * and was 520 lines of exactly that shape: an authorization rule registry, tenant-isolation
+ * checks, a recursive `sanitizeData` for sensitive fields, and an audit log.
+ *
+ * None of it was reachable. `validateFeatureAccess` is the only thing any caller uses; the
+ * registry, the sanitiser and the audit log had no readers at all, so nothing was being
+ * protected by them. What is left is the licence gate itself, which is real and tested in
+ * tests/business-security-gate.test.ts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.businessSecurity = exports.BusinessSecurity = exports.BusinessSecurityError = void 0;
+class BusinessSecurityError extends Error {
+    constructor(message, errorType, context) {
+        super(message);
+        this.errorType = errorType;
+        this.context = context;
+        this.name = 'BusinessSecurityError';
+    }
+}
+exports.BusinessSecurityError = BusinessSecurityError;
+/**
+ * Business Logic Security Manager
+ */
+class BusinessSecurity {
+    /**
+     * Validate feature access with comprehensive checks
+     */
+    validateFeatureAccess(feature, license, context) {
+        var _a;
+        // Step 1: License validation
+        if (!license) {
+            return { allowed: false, reason: 'No valid license found' };
+        }
+        // Step 2: Feature-to-plan mapping (corrected logic)
+        const featurePlans = this.getFeaturePlans();
+        const requiredPlans = featurePlans.get(feature);
+        if (!requiredPlans) {
+            return { allowed: false, reason: `Unknown feature: ${feature}` };
+        }
+        if (!requiredPlans.includes(license.plan)) {
+            const minPlan = this.getMinimumPlan(requiredPlans);
+            const requiredName = this.describePlan(minPlan);
+            const currentName = this.describePlan(license.plan);
+            return {
+                allowed: false,
+                reason: `Feature '${feature}' requires ${requiredName} plan or higher, current: ${currentName}`,
+            };
+        }
+        // Step 3: Additional security checks
+        if (license.status && license.status !== 'active') {
+            return { allowed: false, reason: `License status: ${license.status}` };
+        }
+        const expiry = (_a = license.valid_until) !== null && _a !== void 0 ? _a : new Date(license.validUntil);
+        if (new Date() > expiry) {
+            return { allowed: false, reason: 'License has expired' };
+        }
+        // Step 4: Context validation
+        if (!this.validateSecurityContext(context)) {
+            return { allowed: false, reason: 'Invalid security context' };
+        }
+        // A successful access used to be appended to an in-memory `auditLog` array. Nothing ever
+        // read it — the only accessor, getAuditLog(), had no caller — so it grew for the life of the
+        // process and was discarded. That is not an audit trail; if one is wanted it needs a sink
+        // that outlives the run.
+        return { allowed: true };
+    }
+    // Private helper methods
+    getFeaturePlans() {
+        return new Map([
+            ['policies', ['professional', 'business', 'enterprise']],
+            ['server-actions', ['starter', 'professional', 'business', 'enterprise']],
+            ['sdk-publisher', ['professional', 'business', 'enterprise']],
+            ['drift-guard', ['professional', 'business', 'enterprise']],
+            ['contract-testing-pack', ['business', 'enterprise']],
+            ['postgres-rls-pack', ['professional', 'business', 'enterprise']],
+            ['form-ux', ['starter', 'professional', 'business', 'enterprise']],
+            ['api-docs-pack', ['business', 'enterprise']],
+            ['multi-tenant-kit', ['enterprise']],
+            ['performance-pack', ['professional', 'business', 'enterprise']],
+            ['data-factories', ['business', 'enterprise']],
+        ]);
+    }
+    getMinimumPlan(plans) {
+        const hierarchy = ['starter', 'professional', 'business', 'enterprise'];
+        for (const plan of hierarchy) {
+            if (plans.includes(plan)) {
+                return plan;
+            }
+        }
+        return 'enterprise';
+    }
+    describePlan(plan) {
+        switch (plan) {
+            case 'starter':
+                return 'Starter';
+            case 'professional':
+                return 'Professional';
+            case 'business':
+                return 'Business';
+            case 'enterprise':
+                return 'Enterprise';
+            default:
+                return plan;
+        }
+    }
+    validateSecurityContext(context) {
+        return !!(context.userId &&
+            context.sessionId &&
+            Array.isArray(context.roles) &&
+            Array.isArray(context.permissions));
+    }
+}
+exports.BusinessSecurity = BusinessSecurity;
+/**
+ * Global business security instance
+ */
+exports.businessSecurity = new BusinessSecurity();
+/*
+ * secureBusinessLogic, a method decorator wrapping calls in an authorisation check, was removed
+ * as unreachable — no caller inside or outside this module. The live entry point is the
+ * `businessSecurity` singleton's validateFeatureAccess, which license.ts calls directly and
+ * tests/business-security-gate.test.ts covers.
+ */
+//# sourceMappingURL=businessSecurity.js.map

package/lib/utils/businessSecurity.js.map

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

package/lib/utils/circular-dependency-detector.d.ts

@@ -0,0 +1,42 @@
+import type { DMMF as PrismaDMMF } from '@prisma/generator-helper';
+/**
+ * Result of circular dependency detection
+ */
+export interface CircularDependencyResult {
+    /** Map of model name -> set of relation field names that should be excluded to break cycles */
+    excludedRelations: Map<string, Set<string>>;
+    /** List of detected cycles for debugging */
+    cycles: string[][];
+}
+/**
+ * Detects circular dependencies in Prisma model relationships and determines
+ * which relations should be excluded to break the cycles.
+ */
+export declare class CircularDependencyDetector {
+    private models;
+    private relationGraph;
+    constructor(models: PrismaDMMF.Model[]);
+    /**
+     * Build a graph of all model relationships
+     */
+    private buildRelationGraph;
+    /**
+     * Detect problematic circular dependencies (not just any cycle).
+     * Only considers cycles that would cause TypeScript compilation issues.
+     */
+    private detectProblematicCycles;
+    /**
+     * Determine which relations to exclude to break cycles.
+     * Strategy: For bidirectional relationships, prefer to exclude optional relations
+     * over required ones, and exclude "back-references" over "forward-references".
+     */
+    private determineExclusions;
+    /**
+     * Detect circular dependencies and return which relations should be excluded
+     */
+    detect(): CircularDependencyResult;
+}
+/**
+ * Utility function to detect circular dependencies in Prisma models
+ */
+export declare function detectCircularDependencies(models: PrismaDMMF.Model[]): CircularDependencyResult;