@pegasusheavy/nestjs-prisma-graphql 1.4.3 → 1.6.0

package/dist/handlers/register-all-types.d.ts

@@ -0,0 +1,13 @@
+import type { EventArguments } from '../types.js';
+/**
+ * Generate the register-all-types.ts file that imports all generated types
+ * to ensure their registerType() calls are executed.
+ *
+ * This file must be imported early in the application, before any code
+ * tries to use getType() for lazy type resolution.
+ *
+ * This solves the ESM bundling issue where CJS would return valid bundles
+ * but ESM complains about broken dependency cycles.
+ */
+export declare function generateRegisterAllTypes(args: EventArguments): void;
+//# sourceMappingURL=register-all-types.d.ts.map

package/dist/handlers/register-all-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-all-types.d.ts","sourceRoot":"","sources":["../../src/handlers/register-all-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAuGnE"}

package/dist/handlers/register-all-types.js

@@ -0,0 +1,99 @@
+import { relativePath } from '../helpers/relative-path.js';
+/**
+ * Generate the register-all-types.ts file that imports all generated types
+ * to ensure their registerType() calls are executed.
+ *
+ * This file must be imported early in the application, before any code
+ * tries to use getType() for lazy type resolution.
+ *
+ * This solves the ESM bundling issue where CJS would return valid bundles
+ * but ESM complains about broken dependency cycles.
+ */
+export function generateRegisterAllTypes(args) {
+    const { config, output, project } = args;
+    if (!config.esmCompatible) {
+        return;
+    }
+    const rootDirectory = project.getDirectory(output) ?? project.createDirectory(output);
+    // Use .js extension if outputFilePattern uses .js, otherwise .ts
+    const extension = config.outputFilePattern?.includes('.js') ? '.js' : '.ts';
+    const sourceFile = rootDirectory.createSourceFile(`register-all-types${extension}`, undefined, {
+        overwrite: true,
+    });
+    // Collect all generated source files that have registerType() calls
+    const importPaths = [];
+    const typeNames = [];
+    // Get all source files in the output directory
+    // Support both .ts (default) and .js (when outputFilePattern uses .js)
+    const allSourceFiles = project.getSourceFiles(`${output}/**/*.{ts,js}`);
+    for (const file of allSourceFiles) {
+        const filePath = file.getFilePath();
+        // Skip utility files and the register file itself
+        if (filePath.endsWith('type-registry.ts') ||
+            filePath.endsWith('register-all-types.ts') ||
+            filePath.endsWith('index.ts')) {
+            continue;
+        }
+        // Check if this file has a registerType() call
+        const fileText = file.getText();
+        const registerMatch = /registerType\(['"]([^'"]+)['"]/.exec(fileText);
+        if (registerMatch) {
+            // Get relative path from register-all-types.ts to this file
+            let relPath = relativePath(sourceFile.getFilePath(), filePath);
+            // Add .js extension for ESM module resolution
+            if (!relPath.endsWith('.js')) {
+                relPath += '.js';
+            }
+            importPaths.push(relPath);
+            typeNames.push(registerMatch[1]);
+        }
+    }
+    // Sort for consistent output
+    importPaths.sort();
+    typeNames.sort();
+    // Generate the file content with proper ESM handling
+    const fileContent = `/**
+ * ESM Type Registration Module
+ *
+ * This file registers all generated types with the type registry to solve
+ * ESM circular dependency issues. In ESM, unlike CommonJS, circular imports
+ * can result in undefined values because modules are evaluated in a different order.
+ *
+ * IMPORTANT: Import this file at the very top of your application entry point,
+ * BEFORE any other code that uses the generated types.
+ *
+ * Example usage in main.ts:
+ *
+ *   // This MUST be the first import
+ *   import './@generated/register-all-types.js';
+ *
+ *   // Now you can safely import and use generated types
+ *   import { NestFactory } from '@nestjs/core';
+ *   import { AppModule } from './app.module.js';
+ *
+ * Why this is needed:
+ * - ESM uses "live bindings" where imports reference the actual export
+ * - With circular deps (User -> Post -> User), one module isn't ready when imported
+ * - CJS would give a partial object that fills in later; ESM gives undefined
+ * - This registry pattern defers type resolution until runtime when all modules are loaded
+ */
+
+import { markRegistrationComplete } from './type-registry.js';
+
+// Import all generated type files to trigger their registerType() calls
+// These are side-effect imports that populate the type registry
+${importPaths.map(p => `import '${p}';`).join('\n')}
+
+// Mark registration as complete to enable warning messages
+markRegistrationComplete();
+
+// Export type names for validation (optional)
+export const registeredTypes = [
+${typeNames.map(n => `  '${n}',`).join('\n')}
+] as const;
+
+export type RegisteredTypeName = typeof registeredTypes[number];
+`;
+    sourceFile.addStatements(fileContent);
+}
+//# sourceMappingURL=register-all-types.js.map

package/dist/handlers/register-all-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-all-types.js","sourceRoot":"","sources":["../../src/handlers/register-all-types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAoB;IAC3D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEzC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAEtF,iEAAiE;IACjE,MAAM,SAAS,GAAG,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5E,MAAM,UAAU,GAAG,aAAa,CAAC,gBAAgB,CAC/C,qBAAqB,SAAS,EAAE,EAChC,SAAS,EACT;QACE,SAAS,EAAE,IAAI;KAChB,CACF,CAAC;IAEF,oEAAoE;IACpE,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,+CAA+C;IAC/C,uEAAuE;IACvE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,MAAM,eAAe,CAAC,CAAC;IAExE,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAEpC,kDAAkD;QAClD,IACE,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACrC,QAAQ,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAC1C,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAC7B,CAAC;YACD,SAAS;QACX,CAAC;QAED,+CAA+C;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAChC,MAAM,aAAa,GAAG,gCAAgC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtE,IAAI,aAAa,EAAE,CAAC;YAClB,4DAA4D;YAC5D,IAAI,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC;YAC/D,8CAA8C;YAC9C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,OAAO,IAAI,KAAK,CAAC;YACnB,CAAC;YACD,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1B,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,WAAW,CAAC,IAAI,EAAE,CAAC;IACnB,SAAS,CAAC,IAAI,EAAE,CAAC;IAEjB,qDAAqD;IACrD,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BpB,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;EAOjD,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;CAI3C,CAAC;IAEA,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;AACxC,CAAC"}

package/dist/handlers/register-enum.d.ts

@@ -0,0 +1,3 @@
+import type { EventArguments, SchemaEnum } from '../types.js';
+export declare function registerEnum(enumType: SchemaEnum, args: EventArguments): void;
+//# sourceMappingURL=register-enum.d.ts.map

package/dist/handlers/register-enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-enum.d.ts","sourceRoot":"","sources":["../../src/handlers/register-enum.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAO9D,wBAAgB,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CA0E7E"}

package/dist/handlers/register-enum.js

@@ -0,0 +1,65 @@
+import { StructureKind } from 'ts-morph';
+import { ImportDeclarationMap } from '../helpers/import-declaration-map.js';
+import { extractEnumValueDocs } from './prisma-enum-doc.js';
+export function registerEnum(enumType, args) {
+    const { config, enums, getSourceFile } = args;
+    // Type-safe extraction of enum name from SchemaEnum
+    // Access the name property through unknown to avoid unsafe member access
+    const enumTypeAsRecord = enumType;
+    const rawName = enumTypeAsRecord.name;
+    const enumName = typeof rawName === 'string' ? rawName : String(rawName);
+    const enumValue = enums[enumName];
+    if (!config.emitBlocks.prismaEnums && enumValue === undefined) {
+        return;
+    }
+    const dataModelEnum = enumValue;
+    const enumTypesData = (dataModelEnum?.values ?? []).map(v => ({
+        name: v.name,
+        documentation: undefined,
+    }));
+    const sourceFile = getSourceFile({
+        name: enumName,
+        type: 'enum',
+    });
+    const importDeclarations = new ImportDeclarationMap();
+    importDeclarations.set('registerEnumType', {
+        moduleSpecifier: '@nestjs/graphql',
+        namedImports: [{ name: 'registerEnumType' }],
+    });
+    // Extract valuesMap from enum documentation
+    const valuesMap = extractEnumValueDocs(enumTypesData);
+    // Remove entries with no description or deprecationReason
+    const filteredValuesMap = Object.fromEntries(Object.entries(valuesMap).filter(([, v]) => Object.keys(v).length > 0));
+    // Format only if needed
+    const hasValuesMap = Object.keys(filteredValuesMap).length > 0;
+    const formattedValuesMap = hasValuesMap
+        ? JSON.stringify(filteredValuesMap, null, 2).replace(/"([^"]+)":/g, '$1:')
+        : '';
+    const valuesMapEntry = hasValuesMap ? `, valuesMap: ${formattedValuesMap}` : '';
+    // Type-safe extraction of enum values
+    // Access the values property through unknown to avoid unsafe member access
+    const enumTypeRecord = enumType;
+    const rawValues = enumTypeRecord.values;
+    const enumValues = Array.isArray(rawValues)
+        ? rawValues.map((v) => String(v))
+        : [];
+    const enumStructure = {
+        isExported: true,
+        kind: StructureKind.Enum,
+        members: enumValues.map((v) => ({
+            initializer: JSON.stringify(v),
+            name: v,
+        })),
+        name: enumName,
+    };
+    const enumTypeName = enumName;
+    sourceFile.set({
+        statements: [
+            ...importDeclarations.toStatements(),
+            enumStructure,
+            '\n',
+            `registerEnumType(${enumTypeName}, { name: '${enumTypeName}', description: ${JSON.stringify(dataModelEnum?.documentation)}${valuesMapEntry} })`,
+        ],
+    });
+}
+//# sourceMappingURL=register-enum.js.map

package/dist/handlers/register-enum.js.map

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

package/dist/handlers/require-single-fields-in-whereunique-input.d.ts

@@ -0,0 +1,3 @@
+import type { EventEmitter } from '../types.js';
+export declare function requireSingleFieldsInWhereUniqueInput(eventEmitter: EventEmitter): void;
+//# sourceMappingURL=require-single-fields-in-whereunique-input.d.ts.map

package/dist/handlers/require-single-fields-in-whereunique-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-single-fields-in-whereunique-input.d.ts","sourceRoot":"","sources":["../../src/handlers/require-single-fields-in-whereunique-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAa,MAAM,aAAa,CAAC;AAI3E,wBAAgB,qCAAqC,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAEtF"}

package/dist/handlers/require-single-fields-in-whereunique-input.js

@@ -0,0 +1,15 @@
+import { isWhereUniqueInputType } from '../helpers/is-where-unique-input-type.js';
+export function requireSingleFieldsInWhereUniqueInput(eventEmitter) {
+    eventEmitter.on('BeforeInputType', beforeInputType);
+}
+function beforeInputType(args) {
+    const { inputType } = args;
+    if (!isWhereUniqueInputType(inputType.name) || inputType.fields.length !== 1) {
+        return;
+    }
+    for (const field of inputType.fields) {
+        field.isRequired = true;
+        field.isNullable = false;
+    }
+}
+//# sourceMappingURL=require-single-fields-in-whereunique-input.js.map

package/dist/handlers/require-single-fields-in-whereunique-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-single-fields-in-whereunique-input.js","sourceRoot":"","sources":["../../src/handlers/require-single-fields-in-whereunique-input.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAElF,MAAM,UAAU,qCAAqC,CAAC,YAA0B;IAC9E,YAAY,CAAC,EAAE,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,eAAe,CAAC,IAA+C;IACtE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAE3B,IAAI,CAAC,sBAAsB,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7E,OAAO;IACT,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACrC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;QACxB,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/handlers/type-registry.d.ts

@@ -0,0 +1,14 @@
+import type { EventArguments } from '../types.js';
+/**
+ * Generate the type-registry.ts file that provides lazy type resolution
+ * for circular dependencies in ESM environments.
+ *
+ * This solves the ESM bundling issue where CJS would return valid bundles
+ * but ESM complains about broken dependency cycles. In ESM, circular imports
+ * can result in undefined values because module evaluation order differs from CJS.
+ *
+ * The registry pattern defers type resolution until runtime when all modules
+ * have been fully initialized.
+ */
+export declare function generateTypeRegistry(args: EventArguments): void;
+//# sourceMappingURL=type-registry.d.ts.map

package/dist/handlers/type-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-registry.d.ts","sourceRoot":"","sources":["../../src/handlers/type-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CA+I/D"}

package/dist/handlers/type-registry.js

@@ -0,0 +1,151 @@
+/**
+ * Generate the type-registry.ts file that provides lazy type resolution
+ * for circular dependencies in ESM environments.
+ *
+ * This solves the ESM bundling issue where CJS would return valid bundles
+ * but ESM complains about broken dependency cycles. In ESM, circular imports
+ * can result in undefined values because module evaluation order differs from CJS.
+ *
+ * The registry pattern defers type resolution until runtime when all modules
+ * have been fully initialized.
+ */
+export function generateTypeRegistry(args) {
+    const { config, output, project } = args;
+    if (!config.esmCompatible) {
+        return;
+    }
+    const rootDirectory = project.getDirectory(output) ?? project.createDirectory(output);
+    const sourceFile = rootDirectory.createSourceFile('type-registry.ts', undefined, {
+        overwrite: true,
+    });
+    // Generate a comprehensive type registry with error handling and forwardRef support
+    const registryCode = `/**
+ * Type Registry for ESM Circular Dependency Resolution
+ *
+ * In ESM, circular dependencies behave differently than CommonJS:
+ * - CJS: Modules get a partial/incomplete export object that gets filled in
+ * - ESM: Imports are "live bindings" but can be undefined if not yet initialized
+ *
+ * This registry solves this by:
+ * 1. Deferring type resolution until runtime (after all modules are loaded)
+ * 2. Providing a forwardRef pattern for GraphQL field type declarations
+ * 3. Validating all types are registered before they're needed
+ */
+
+const registry = new Map<string, unknown>();
+const pendingResolutions = new Map<string, Array<(type: unknown) => void>>();
+let registrationComplete = false;
+
+/**
+ * Register a type with the registry.
+ * This should be called at module load time after the class is defined.
+ */
+export function registerType(name: string, type: unknown): void {
+  if (type === undefined) {
+    console.warn(\`[nestjs-prisma-graphql] Warning: Registering undefined type for "\${name}". This may indicate a circular dependency issue.\`);
+  }
+  registry.set(name, type);
+
+  // Resolve any pending forwardRef callbacks
+  const pending = pendingResolutions.get(name);
+  if (pending) {
+    for (const callback of pending) {
+      callback(type);
+    }
+    pendingResolutions.delete(name);
+  }
+}
+
+/**
+ * Get a type from the registry.
+ * Returns the type if registered, undefined otherwise.
+ *
+ * For use in \\@Field(() => getType('TypeName')) decorators.
+ */
+export function getType<T = unknown>(name: string): T {
+  const type = registry.get(name);
+  if (type === undefined && registrationComplete) {
+    console.warn(\`[nestjs-prisma-graphql] Warning: Type "\${name}" not found in registry. Ensure register-all-types is imported before using generated types.\`);
+  }
+  return type as T;
+}
+
+/**
+ * Create a forward reference to a type that may not be registered yet.
+ * This is useful for handling circular dependencies where type A references type B
+ * and type B references type A.
+ *
+ * Usage: \\@Field(() => forwardRef('Post'))
+ */
+export function forwardRef<T = unknown>(name: string): () => T {
+  return () => {
+    const type = registry.get(name);
+    if (type === undefined) {
+      throw new Error(
+        \`[nestjs-prisma-graphql] Type "\${name}" not registered. \\n\` +
+        \`This usually means:\\n\` +
+        \`  1. The register-all-types.ts file was not imported early enough\\n\` +
+        \`  2. There's a circular dependency that couldn't be resolved\\n\` +
+        \`  3. The type file failed to load\\n\\n\` +
+        \`Make sure to import 'register-all-types' at the top of your main.ts or app.module.ts\`
+      );
+    }
+    return type as T;
+  };
+}
+
+/**
+ * Lazily resolve a type, returning a thunk that can be called later.
+ * This is the safest pattern for circular references in ESM.
+ *
+ * Usage: \\@Field(lazyType('Post'))
+ */
+export function lazyType<T = unknown>(name: string): () => T {
+  return () => getType<T>(name);
+}
+
+/**
+ * Mark registration as complete. Called after all types are imported.
+ * This enables warning messages for missing types.
+ */
+export function markRegistrationComplete(): void {
+  registrationComplete = true;
+
+  // Warn about any unresolved forward refs
+  if (pendingResolutions.size > 0) {
+    const missing = Array.from(pendingResolutions.keys()).join(', ');
+    console.warn(\`[nestjs-prisma-graphql] Warning: Unresolved forward references: \${missing}\`);
+  }
+}
+
+/**
+ * Get all registered type names (useful for debugging)
+ */
+export function getRegisteredTypes(): string[] {
+  return Array.from(registry.keys());
+}
+
+/**
+ * Check if a type is registered
+ */
+export function isTypeRegistered(name: string): boolean {
+  return registry.has(name);
+}
+
+/**
+ * Validate that all expected types are registered.
+ * Throws an error if any types are missing.
+ */
+export function validateRegistry(expectedTypes: string[]): void {
+  const missing = expectedTypes.filter(name => !registry.has(name));
+  if (missing.length > 0) {
+    throw new Error(
+      \`[nestjs-prisma-graphql] Missing type registrations: \${missing.join(', ')}\\n\` +
+      \`Ensure register-all-types.ts is imported before using these types.\`
+    );
+  }
+}
+`;
+    sourceFile.addStatements(registryCode);
+}
+//# sourceMappingURL=type-registry.js.map

package/dist/handlers/type-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-registry.js","sourceRoot":"","sources":["../../src/handlers/type-registry.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAoB;IACvD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEzC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAEtF,MAAM,UAAU,GAAG,aAAa,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,SAAS,EAAE;QAC/E,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,oFAAoF;IACpF,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8HtB,CAAC;IAEA,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;AACzC,CAAC"}

package/dist/handlers/warning.d.ts

@@ -0,0 +1,2 @@
+export declare function warning(message: string | string[]): void;
+//# sourceMappingURL=warning.d.ts.map

package/dist/handlers/warning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warning.d.ts","sourceRoot":"","sources":["../../src/handlers/warning.ts"],"names":[],"mappings":"AAQA,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAOxD"}

package/dist/handlers/warning.js

@@ -0,0 +1,14 @@
+const globalConsole = globalThis.console;
+const log = (msg) => {
+    globalConsole.log(msg);
+};
+export function warning(message) {
+    if (Array.isArray(message)) {
+        log('nestjs-prisma-graphql:');
+        log(message.join('\n'));
+    }
+    else {
+        log(`nestjs-prisma-graphql: ${message}`);
+    }
+}
+//# sourceMappingURL=warning.js.map

package/dist/handlers/warning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warning.js","sourceRoot":"","sources":["../../src/handlers/warning.ts"],"names":[],"mappings":"AAGA,MAAM,aAAa,GAAgC,UAAU,CAAC,OAAO,CAAC;AACtE,MAAM,GAAG,GAAgB,CAAC,GAAW,EAAQ,EAAE;IAC7C,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,UAAU,OAAO,CAAC,OAA0B;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,wBAAwB,CAAC,CAAC;QAC9B,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/dist/helpers/create-comment.d.ts

@@ -0,0 +1,3 @@
+import type { ObjectSettings } from '../types.js';
+export declare function createComment(documentation: string, settings?: ObjectSettings): string;
+//# sourceMappingURL=create-comment.d.ts.map

package/dist/helpers/create-comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-comment.d.ts","sourceRoot":"","sources":["../../src/helpers/create-comment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,MAAM,CA2BtF"}

package/dist/helpers/create-comment.js

@@ -0,0 +1,23 @@
+export function createComment(documentation, settings) {
+    const documentationLines = documentation.split('\n');
+    const commentLines = ['/**'];
+    for (const line of documentationLines) {
+        commentLines.push(` * ${line}`);
+    }
+    const fieldArgs = settings?.fieldArguments();
+    let deprecationReason;
+    if (fieldArgs === undefined) {
+        deprecationReason = undefined;
+    }
+    else {
+        deprecationReason = fieldArgs.deprecationReason;
+    }
+    if (deprecationReason !== undefined &&
+        deprecationReason !== null &&
+        deprecationReason.length > 0) {
+        commentLines.push(` * @deprecated ${deprecationReason}`);
+    }
+    commentLines.push(' */\n');
+    return commentLines.join('\n');
+}
+//# sourceMappingURL=create-comment.js.map

package/dist/helpers/create-comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-comment.js","sourceRoot":"","sources":["../../src/helpers/create-comment.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAC,aAAqB,EAAE,QAAyB;IAC5E,MAAM,kBAAkB,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,CAAC;QACtC,YAAY,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC7C,IAAI,iBAAqC,CAAC;IAC1C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,iBAAiB,GAAG,SAAS,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,iBAAiB,GAAG,SAAS,CAAC,iBAAuC,CAAC;IACxE,CAAC;IAED,IACE,iBAAiB,KAAK,SAAS;QAC/B,iBAAiB,KAAK,IAAI;QAC1B,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAC5B,CAAC;QACD,YAAY,CAAC,IAAI,CAAC,kBAAkB,iBAAiB,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE3B,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/dist/helpers/create-config.d.ts

@@ -0,0 +1,51 @@
+import type { ImportNameSpec, ObjectSetting } from '../types.js';
+import { ReExport } from '../handlers/re-export.js';
+type ConfigFieldSetting = Partial<Omit<ObjectSetting, 'name'>>;
+interface DecorateElement {
+    isMatchField: (s: string) => boolean;
+    isMatchType: (s: string) => boolean;
+    from: string;
+    name: string;
+    arguments?: string[];
+    namedImport: boolean;
+    defaultImport?: string | true;
+    namespaceImport?: string;
+}
+interface CustomImport {
+    from: string;
+    name: string;
+    namedImport: boolean;
+    defaultImport?: string | true;
+    namespaceImport?: string;
+}
+export declare function createConfig(data: Record<string, unknown>): {
+    $warnings: string[];
+    combineScalarFilters: boolean;
+    customImport: CustomImport[];
+    decorate: DecorateElement[];
+    emitBlocks: Record<string, boolean>;
+    emitCompiled: boolean;
+    emitSingle: boolean;
+    esmCompatible: boolean;
+    esmSuppressTypeErrors: boolean;
+    fields: Record<string, ConfigFieldSetting | undefined>;
+    graphqlScalars: Record<string, ImportNameSpec | undefined>;
+    noAtomicOperations: boolean;
+    noTypeId: boolean;
+    omitModelsCount: boolean;
+    outputFilePattern: string;
+    prismaClientImport: string;
+    purgeOutput: boolean;
+    reExport: ReExport;
+    requireSingleFieldsInWhereUniqueInput: boolean;
+    tsConfigFilePath: string | undefined;
+    unsafeCompatibleWhereUniqueInput: boolean;
+    useInputType: ConfigInputItem[];
+};
+interface ConfigInputItem {
+    typeName: string;
+    ALL?: string;
+    [index: string]: string | undefined;
+}
+export {};
+//# sourceMappingURL=create-config.d.ts.map

package/dist/helpers/create-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-config.d.ts","sourceRoot":"","sources":["../../src/helpers/create-config.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGpD,KAAK,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;AAC/D,UAAU,eAAe;IACvB,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACrC,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AACD,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC3D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC,CAAC;IACvD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC,CAAC;IAC3D,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,qCAAqC,EAAE,OAAO,CAAC;IAC/C,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,gCAAgC,EAAE,OAAO,CAAC;IAC1C,YAAY,EAAE,eAAe,EAAE,CAAC;CACjC,CAgJA;AAED,UAAU,eAAe;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACrC"}