@buenojs/bueno 0.8.10 → 0.8.11

package/dist/cli/utils/strings.js

@@ -0,0 +1,190 @@
+/**
+ * String Utility Functions for Bueno CLI
+ *
+ * Provides string transformation helpers for code generation
+ */
+/**
+ * Convert string to camelCase
+ */
+export function camelCase(str) {
+    return str
+        .replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ""))
+        .replace(/^(.)/, (c) => c.toLowerCase());
+}
+/**
+ * Convert string to PascalCase
+ */
+export function pascalCase(str) {
+    return str
+        .replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ""))
+        .replace(/^(.)/, (c) => c.toUpperCase());
+}
+/**
+ * Convert string to kebab-case
+ */
+export function kebabCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, "$1-$2")
+        .replace(/[-_\s]+/g, "-")
+        .toLowerCase();
+}
+/**
+ * Convert string to snake_case
+ */
+export function snakeCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, "$1_$2")
+        .replace(/[-\s]+/g, "_")
+        .toLowerCase();
+}
+/**
+ * Convert string to UPPER_CASE
+ */
+export function upperCase(str) {
+    return snakeCase(str).toUpperCase();
+}
+/**
+ * Convert string to lower_case
+ */
+export function lowerCase(str) {
+    return snakeCase(str).toLowerCase();
+}
+/**
+ * Capitalize first letter
+ */
+export function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+/**
+ * Pluralize a word (simple implementation)
+ */
+export function pluralize(word) {
+    if (word.endsWith("y") &&
+        !["ay", "ey", "iy", "oy", "uy"].some((e) => word.endsWith(e))) {
+        return word.slice(0, -1) + "ies";
+    }
+    if (word.endsWith("s") ||
+        word.endsWith("x") ||
+        word.endsWith("z") ||
+        word.endsWith("ch") ||
+        word.endsWith("sh")) {
+        return word + "es";
+    }
+    return word + "s";
+}
+/**
+ * Singularize a word (simple implementation)
+ */
+export function singularize(word) {
+    if (word.endsWith("ies")) {
+        return word.slice(0, -3) + "y";
+    }
+    if (word.endsWith("es")) {
+        // Check for s, x, z, ch, sh endings
+        const withoutEs = word.slice(0, -2);
+        if (withoutEs.endsWith("s") ||
+            withoutEs.endsWith("x") ||
+            withoutEs.endsWith("z") ||
+            withoutEs.endsWith("ch") ||
+            withoutEs.endsWith("sh")) {
+            return withoutEs;
+        }
+    }
+    if (word.endsWith("s") && !word.endsWith("ss")) {
+        return word.slice(0, -1);
+    }
+    return word;
+}
+/**
+ * Check if string is a valid identifier
+ */
+export function isValidIdentifier(str) {
+    return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(str);
+}
+/**
+ * Check if string is a valid file name
+ */
+export function isValidFileName(str) {
+    return !/[<>:"/\\|?*\x00-\x1f]/.test(str);
+}
+/**
+ * Truncate string with ellipsis
+ */
+export function truncate(str, maxLength) {
+    if (str.length <= maxLength)
+        return str;
+    return str.slice(0, maxLength - 3) + "...";
+}
+/**
+ * Pad string to center
+ */
+export function padCenter(str, length, char = " ") {
+    const padding = length - str.length;
+    if (padding <= 0)
+        return str;
+    const left = Math.floor(padding / 2);
+    const right = padding - left;
+    return char.repeat(left) + str + char.repeat(right);
+}
+/**
+ * Remove file extension
+ */
+export function removeExtension(filename) {
+    const lastDot = filename.lastIndexOf(".");
+    if (lastDot === -1 || lastDot === 0)
+        return filename;
+    return filename.slice(0, lastDot);
+}
+/**
+ * Get file extension
+ */
+export function getExtension(filename) {
+    const lastDot = filename.lastIndexOf(".");
+    if (lastDot === -1 || lastDot === 0)
+        return "";
+    return filename.slice(lastDot + 1);
+}
+/**
+ * Generate a unique ID
+ */
+export function generateId(length = 8) {
+    const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+    let result = "";
+    for (let i = 0; i < length; i++) {
+        result += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return result;
+}
+/**
+ * Escape string for use in template literals
+ */
+export function escapeTemplateString(str) {
+    return str.replace(/[`\\$]/g, "\\$&");
+}
+/**
+ * Escape string for use in regular expressions
+ */
+export function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Indent a multiline string
+ */
+export function indent(str, spaces = 2) {
+    const indentation = " ".repeat(spaces);
+    return str
+        .split("\n")
+        .map((line) => (line.trim() ? indentation + line : line))
+        .join("\n");
+}
+/**
+ * Strip leading/trailing whitespace from each line
+ */
+export function stripLines(str) {
+    return str
+        .split("\n")
+        .map((line) => line.trim())
+        .join("\n")
+        .replace(/\n{3,}/g, "\n\n");
+}
+//# sourceMappingURL=strings.js.map

package/dist/cli/utils/strings.js.map

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

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

@@ -0,0 +1,15 @@
+/**
+ * Version Utility
+ *
+ * Gets the current version of @buenojs/bueno from package.json
+ */
+/**
+ * Get the current version of @buenojs/bueno
+ * Reads from package.json at runtime
+ */
+export declare function getBuenoVersion(): string;
+/**
+ * Get the bueno dependency entry for package.json
+ */
+export declare function getBuenoDependency(): Record<string, string>;
+//# sourceMappingURL=version.d.ts.map

package/dist/cli/utils/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAsBxC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI3D"}

package/dist/cli/utils/version.js

@@ -0,0 +1,38 @@
+/**
+ * Version Utility
+ *
+ * Gets the current version of @buenojs/bueno from package.json
+ */
+import { readFileSync } from "fs";
+import { join } from "path";
+let cachedVersion = null;
+/**
+ * Get the current version of @buenojs/bueno
+ * Reads from package.json at runtime
+ */
+export function getBuenoVersion() {
+    if (cachedVersion) {
+        return cachedVersion;
+    }
+    try {
+        // Try to read from the package.json in the bueno package
+        const packageJsonPath = join(import.meta.dir, "..", "..", "..", "package.json");
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+        cachedVersion = `^${packageJson.version}`;
+        return cachedVersion;
+    }
+    catch {
+        // Fallback to a default version if package.json can't be read
+        console.warn("Could not read version from package.json, using default");
+        return "^0.8.0";
+    }
+}
+/**
+ * Get the bueno dependency entry for package.json
+ */
+export function getBuenoDependency() {
+    return {
+        "@buenojs/bueno": getBuenoVersion(),
+    };
+}
+//# sourceMappingURL=version.js.map

package/dist/cli/utils/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/cli/utils/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,IAAI,aAAa,GAAkB,IAAI,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC9B,IAAI,aAAa,EAAE,CAAC;QACnB,OAAO,aAAa,CAAC;IACtB,CAAC;IAED,IAAI,CAAC;QACJ,yDAAyD;QACzD,MAAM,eAAe,GAAG,IAAI,CAC3B,MAAM,CAAC,IAAI,CAAC,GAAG,EACf,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,cAAc,CACd,CAAC;QACF,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;QACvE,aAAa,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QAC1C,OAAO,aAAa,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACR,8DAA8D;QAC9D,OAAO,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;QACxE,OAAO,QAAQ,CAAC;IACjB,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IACjC,OAAO;QACN,gBAAgB,EAAE,eAAe,EAAE;KACnC,CAAC;AACH,CAAC"}

package/dist/config/env-validation.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Environment variable validation for Bueno Framework
+ */
+import type { ValidationResult } from "../validation";
+/**
+ * Validate environment variables against the Bueno schema
+ *
+ * @param envVars - Environment variables to validate
+ * @returns Validation result with transformed values or error details
+ */
+export declare function validateEnvVars(envVars: Record<string, string>): ValidationResult;
+/**
+ * Validate and load environment variables from .env files
+ *
+ * @param options - Options for loading and validating environment variables
+ * @returns Validation result with transformed values or error details
+ */
+export declare function validateAndLoadEnv(options?: {
+    /** Custom list of env files to load */
+    files?: string[];
+    /** Whether to also load NODE_ENV-specific file */
+    loadNodeEnv?: boolean;
+    /** Base directory for env files */
+    cwd?: string;
+    /** Whether to merge with existing Bun.env */
+    mergeWithProcess?: boolean;
+}): Promise<ValidationResult>;
+/**
+ * Get validation error messages as a single string
+ *
+ * @param result - Validation result
+ * @returns Formatted error message or null if valid
+ */
+export declare function getValidationErrorMessage(result: ValidationResult): string | null;
+/**
+ * Check if required environment variables are set
+ *
+ * @param envVars - Environment variables to check
+ * @returns True if all required variables are present and valid
+ */
+export declare function hasRequiredEnvVars(envVars: Record<string, string>): boolean;
+/**
+ * Get missing required environment variables
+ *
+ * @param envVars - Environment variables to check
+ * @returns Array of missing required variable names
+ */
+export declare function getMissingEnvVars(envVars: Record<string, string>): string[];
+//# sourceMappingURL=env-validation.d.ts.map

package/dist/config/env-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-validation.d.ts","sourceRoot":"","sources":["../../src/config/env-validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAItD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,gBAAgB,CAElB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IAClD,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkB5B;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,gBAAgB,GACtB,MAAM,GAAG,IAAI,CAMf;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAG3E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAW3E"}

package/dist/config/env-validation.js

@@ -0,0 +1,77 @@
+/**
+ * Environment variable validation for Bueno Framework
+ */
+import { validateEnvSync } from "../validation";
+import { envSchema } from "../validation/schemas";
+/**
+ * Validate environment variables against the Bueno schema
+ *
+ * @param envVars - Environment variables to validate
+ * @returns Validation result with transformed values or error details
+ */
+export function validateEnvVars(envVars) {
+    return validateEnvSync(envSchema, envVars);
+}
+/**
+ * Validate and load environment variables from .env files
+ *
+ * @param options - Options for loading and validating environment variables
+ * @returns Validation result with transformed values or error details
+ */
+export async function validateAndLoadEnv(options) {
+    try {
+        // Load environment variables from files
+        const { loadEnvFiles } = await import("./env");
+        const rawEnvVars = await loadEnvFiles(options);
+        // Validate the environment variables
+        return validateEnvVars(rawEnvVars);
+    }
+    catch (error) {
+        return {
+            success: false,
+            issues: [
+                {
+                    message: `Failed to load and validate environment variables: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+        };
+    }
+}
+/**
+ * Get validation error messages as a single string
+ *
+ * @param result - Validation result
+ * @returns Formatted error message or null if valid
+ */
+export function getValidationErrorMessage(result) {
+    if (result.success) {
+        return null;
+    }
+    return result.issues.map((issue) => issue.message).join("\n");
+}
+/**
+ * Check if required environment variables are set
+ *
+ * @param envVars - Environment variables to check
+ * @returns True if all required variables are present and valid
+ */
+export function hasRequiredEnvVars(envVars) {
+    const result = validateEnvVars(envVars);
+    return result.success;
+}
+/**
+ * Get missing required environment variables
+ *
+ * @param envVars - Environment variables to check
+ * @returns Array of missing required variable names
+ */
+export function getMissingEnvVars(envVars) {
+    const result = validateEnvVars(envVars);
+    if (result.success) {
+        return [];
+    }
+    return result.issues
+        .filter((issue) => issue.message.includes("This environment variable is required"))
+        .map((issue) => issue.path?.[0] || "unknown");
+}
+//# sourceMappingURL=env-validation.js.map

package/dist/config/env-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-validation.js","sourceRoot":"","sources":["../../src/config/env-validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC9B,OAA+B;IAE/B,OAAO,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OASxC;IACA,IAAI,CAAC;QACJ,wCAAwC;QACxC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QAE/C,qCAAqC;QACrC,OAAO,eAAe,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO;YACN,OAAO,EAAE,KAAK;YACd,MAAM,EAAE;gBACP;oBACC,OAAO,EAAE,sDAAsD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;iBACzH;aACD;SACD,CAAC;IACH,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACxC,MAAwB;IAExB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA+B;IACjE,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC,OAAO,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA+B;IAChE,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACX,CAAC;IAED,OAAO,MAAM,CAAC,MAAM;SAClB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,uCAAuC,CAAC,CAC/D;SACA,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC;AAChD,CAAC"}

package/dist/config/env.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Environment variable handling for Bueno Framework
+ */
+import type { BuenoConfig, DeepPartial, EnvMapping } from "./types";
+/**
+ * Environment variable source information
+ */
+export interface EnvSourceInfo {
+    /** Environment variable name */
+    name: string;
+    /** Value of the environment variable */
+    value: string;
+    /** File the variable was loaded from */
+    source?: string;
+}
+/**
+ * Loaded environment data
+ */
+export interface LoadedEnv {
+    /** Raw environment variables loaded */
+    raw: Record<string, string>;
+    /** Transformed configuration from environment */
+    config: DeepPartial<BuenoConfig>;
+    /** Source information for each variable */
+    sources: Map<string, EnvSourceInfo>;
+}
+/**
+ * Get the current NODE_ENV
+ */
+export declare function getNodeEnv(): string;
+/**
+ * Get environment-specific .env file name
+ */
+export declare function getEnvFileName(): string;
+/**
+ * Load environment variables from multiple .env files
+ * Files are loaded in priority order, with later files overriding earlier ones
+ */
+export declare function loadEnvFiles(options?: {
+    /** Custom list of env files to load */
+    files?: string[];
+    /** Whether to also load NODE_ENV-specific file */
+    loadNodeEnv?: boolean;
+    /** Base directory for env files */
+    cwd?: string;
+}): Promise<Record<string, string>>;
+/**
+ * Validate environment variables before loading
+ *
+ * @param envVars - Environment variables to validate
+ * @returns Validation result with transformed values or error details
+ */
+export declare function validateEnvVars(envVars: Record<string, string>): Promise<ValidationResult>;
+/**
+ * Load and validate environment variables with detailed error reporting
+ *
+ * @param options - Options for loading and validating environment variables
+ * @returns Loaded environment data with validation result
+ */
+export declare function loadAndValidateEnv(options?: {
+    /** Custom list of env files to load */
+    files?: string[];
+    /** Whether to also load NODE_ENV-specific file */
+    loadNodeEnv?: boolean;
+    /** Base directory for env files */
+    cwd?: string;
+    /** Whether to merge with existing Bun.env */
+    mergeWithProcess?: boolean;
+    /** Custom environment variable mappings */
+    mappings?: EnvMapping[];
+}): Promise<{
+    loaded: LoadedEnv;
+    valid: boolean;
+    errors?: string;
+}>;
+/**
+ * Get environment variable value from Bun.env
+ */
+export declare function getEnvVar(name: string): string | undefined;
+/**
+ * Set environment variable in Bun.env
+ */
+export declare function setEnvVar(name: string, value: string): void;
+/**
+ * Delete environment variable from Bun.env
+ */
+export declare function deleteEnvVar(name: string): void;
+/**
+ * Transform environment variables to configuration object
+ */
+export declare function envToConfig(envVars: Record<string, string>, mappings?: EnvMapping[]): DeepPartial<BuenoConfig>;
+/**
+ * Load environment variables and transform to configuration
+ */
+export declare function loadEnv(options?: {
+    /** Custom list of env files to load */
+    files?: string[];
+    /** Whether to load NODE_ENV-specific file */
+    loadNodeEnv?: boolean;
+    /** Base directory for env files */
+    cwd?: string;
+    /** Whether to merge with existing Bun.env */
+    mergeWithProcess?: boolean;
+    /** Custom environment variable mappings */
+    mappings?: EnvMapping[];
+}): Promise<LoadedEnv>;
+/**
+ * Get all environment variables related to Bueno configuration
+ */
+export declare function getBuenoEnvVars(): Record<string, string>;
+/**
+ * Check if running in development mode
+ */
+export declare function isDevelopment(): boolean;
+/**
+ * Check if running in production mode
+ */
+export declare function isProduction(): boolean;
+/**
+ * Check if running in test mode
+ */
+export declare function isTest(): boolean;
+/**
+ * Create a custom environment variable mapping
+ */
+export declare function createEnvMapping(envVar: string, configKey: string, transform?: (value: string) => unknown): EnvMapping;
+/**
+ * Parse a boolean environment variable
+ */
+export declare function parseEnvBoolean(value: string): boolean;
+/**
+ * Parse a number environment variable
+ */
+export declare function parseEnvNumber(value: string): number;
+/**
+ * Parse a JSON environment variable
+ */
+export declare function parseEnvJSON<T = unknown>(value: string): T;
+/**
+ * Parse an array environment variable (comma-separated)
+ */
+export declare function parseEnvArray(value: string): string[];
+/**
+ * Environment config mapping for standard Bueno config
+ */
+export declare const envConfigMapping: EnvConfigMapping[];
+/**
+ * Environment config mapping interface
+ */
+export interface EnvConfigMapping {
+    envVar: string;
+    configKey: string;
+    transform?: (value: string) => unknown;
+}
+/**
+ * Get a config value from environment variables using the mapping
+ */
+export declare function getEnvConfig(mappings?: EnvConfigMapping[]): DeepPartial<BuenoConfig>;
+/**
+ * Get an environment variable value
+ */
+export declare function getEnvValue(key: string, defaultValue?: string): string | undefined;
+/**
+ * Set an environment variable value
+ */
+export declare function setEnvValue(key: string, value: string): void;
+//# sourceMappingURL=env.d.ts.map

package/dist/config/env.d.ts.map

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