@graphql-markdown/core/dist/directives/normalize.js

GraphQL-Markdown core package for generating Markdown documentation from a GraphQL schema.

"use strict";
/**
 * Directive name normalization and processing utilities.
 *
 * This module consolidates utilities for handling directive names from multiple
 * sources (CLI, config file, etc.) ensuring consistent normalization across
 * the application.
 *
 * @packageDocumentation
 */
Object.defineProperty(exports, "__esModule", { value: true });
exports.combineDirectiveNames = exports.uniqueDirectiveNames = exports.normalizeDirectiveNames = void 0;
/**
 * Normalizes directive names from multiple sources into a single flattened array.
 *
 * This function:
 * 1. Accepts multiple directive name arrays from different sources
 * 2. Filters out null/undefined values and empty arrays
 * 3. Flattens them into a single array
 * 4. Returns the normalized array (may contain duplicates if sources contain duplicates)
 *
 * Useful when combining directives from CLI, config file, and environment sources.
 *
 * @param sources - Multiple arrays of directive names or undefined/null values
 * @returns A single array of normalized directive names (may contain duplicates)
 *
 * @example
 * ```typescript
 * import { normalizeDirectiveNames } from "@graphql-markdown/core/directives/normalize";
 *
 * const cliDirectives = ["@example", "@internal"];
 * const configDirectives = ["@auth"];
 *
 * const all = normalizeDirectiveNames(cliDirectives, configDirectives);
 * // Result: ["@example", "@internal", "@auth"]
 *
 * // Safely handles undefined:
 * const safe = normalizeDirectiveNames(cliDirectives, undefined, configDirectives);
 * // Result: ["@example", "@internal", "@auth"]
 * ```
 */
const normalizeDirectiveNames = (...sources) => {
    return sources
        .filter((s) => {
        return Array.isArray(s) && s.length > 0;
    })
        .flat();
};
exports.normalizeDirectiveNames = normalizeDirectiveNames;
/**
 * Removes duplicate directive names from an array while preserving order.
 *
 * @param directives - Array of directive names that may contain duplicates
 * @returns A new array with duplicate directive names removed
 *
 * @example
 * ```typescript
 * import { uniqueDirectiveNames } from "@graphql-markdown/core/directives/normalize";
 *
 * const directives = ["@auth", "@example", "@auth", "@internal"];
 * const unique = uniqueDirectiveNames(directives);
 * // Result: ["@auth", "@example", "@internal"]
 * ```
 */
const uniqueDirectiveNames = (directives) => {
    return Array.from(new Set(directives));
};
exports.uniqueDirectiveNames = uniqueDirectiveNames;
/**
 * Combines and deduplicates directive names from multiple sources in one step.
 *
 * This is a convenience function that combines normalizeDirectiveNames
 * with uniqueDirectiveNames for the common case where you need both
 * normalization and deduplication.
 *
 * @param sources - Multiple arrays of directive names or undefined/null values
 * @returns A single array of deduplicated directive names
 *
 * @example
 * ```typescript
 * import { combineDirectiveNames } from "@graphql-markdown/core/directives/normalize";
 *
 * const cliDirectives = ["@example", "@internal"];
 * const configDirectives = ["@auth", "@example"]; // @example is duplicate
 *
 * const all = combineDirectiveNames(cliDirectives, configDirectives);
 * // Result: ["@example", "@internal", "@auth"]
 * ```
 */
const combineDirectiveNames = (...sources) => {
    return (0, exports.uniqueDirectiveNames)((0, exports.normalizeDirectiveNames)(...sources));
};
exports.combineDirectiveNames = combineDirectiveNames;