legal-markdown-js 0.1.0

package/dist/utils/logger.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * @fileoverview Lightweight Logging Utility for Legal Markdown Processing
+ *
+ * This module provides a simple, efficient logging utility for the Legal Markdown
+ * processing system. It offers structured logging with different levels and
+ * optional data context support.
+ *
+ * Features:
+ * - Multiple log levels (debug, info, warn, error)
+ * - Debug mode controlled by environment variable
+ * - Structured logging with contextual data
+ * - Console-based output with formatted prefixes
+ * - Optional data parameter for detailed logging
+ * - Lightweight with no external dependencies
+ *
+ * @example
+ * ```typescript
+ * import { logger } from './logger';
+ *
+ * // Basic logging
+ * logger.info('Processing legal document');
+ * logger.warn('Missing field detected');
+ * logger.error('Failed to parse YAML');
+ *
+ * // Logging with context data
+ * logger.debug('Field processed', { fieldName: 'client.name', value: 'Acme Corp' });
+ * logger.info('Document exported', { format: 'pdf', size: '2.3MB' });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+/**
+ * Simple logger utility for Legal Markdown processing
+ *
+ * Provides structured logging with different levels and optional context data.
+ * Debug logging is only enabled when DEBUG environment variable is set.
+ *
+ * @constant {Object} logger
+ * @example
+ * ```typescript
+ * import { logger } from './logger';
+ *
+ * // Set DEBUG=true in environment to see debug logs
+ * logger.debug('Processing started', { file: 'contract.md' });
+ * logger.info('Document processed successfully');
+ * logger.warn('Optional field missing', { field: 'client.address' });
+ * logger.error('Processing failed', { error: 'Invalid syntax' });
+ * ```
+ */
+exports.logger = {
+    /**
+     * Log debug messages (only shown when DEBUG environment variable is set)
+     *
+     * @method debug
+     * @param {string} message - The debug message to log
+     * @param {any} [data] - Optional contextual data to include with the log
+     * @returns {void}
+     * @example
+     * ```typescript
+     * // Enable debug mode: DEBUG=true node app.js
+     * logger.debug('Processing field', { name: 'client.name', type: 'string' });
+     * logger.debug('Import resolved', { path: './shared/header.md' });
+     * ```
+     */
+    debug: (message, data) => {
+        // Browser-compatible debug check
+        const isDebugEnabled = typeof process !== 'undefined' && process.env && process.env.DEBUG;
+        if (isDebugEnabled) {
+            console.debug(`[DEBUG] ${message}`, data || '');
+        }
+    },
+    /**
+     * Log informational messages
+     *
+     * @method info
+     * @param {string} message - The informational message to log
+     * @param {any} [data] - Optional contextual data to include with the log
+     * @returns {void}
+     * @example
+     * ```typescript
+     * logger.info('Document processing completed');
+     * logger.info('Export successful', { format: 'html', path: './output.html' });
+     * ```
+     */
+    info: (message, data) => {
+        console.info(`[INFO] ${message}`, data || '');
+    },
+    /**
+     * Log warning messages
+     *
+     * @method warn
+     * @param {string} message - The warning message to log
+     * @param {any} [data] - Optional contextual data to include with the log
+     * @returns {void}
+     * @example
+     * ```typescript
+     * logger.warn('Missing optional field', { field: 'client.phone' });
+     * logger.warn('Import file not found', { path: './missing.md' });
+     * ```
+     */
+    warn: (message, data) => {
+        console.warn(`[WARN] ${message}`, data || '');
+    },
+    /**
+     * Log error messages
+     *
+     * @method error
+     * @param {string} message - The error message to log
+     * @param {any} [data] - Optional contextual data to include with the log
+     * @returns {void}
+     * @example
+     * ```typescript
+     * logger.error('Failed to parse YAML frontmatter', { error: 'Invalid syntax' });
+     * logger.error('Document processing failed', { file: 'contract.md', reason: 'Missing imports' });
+     * ```
+     */
+    error: (message, data) => {
+        console.error(`[ERROR] ${message}`, data || '');
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;;;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,MAAM,GAAG;IACpB;;;;;;;;;;;;;OAaG;IACH,KAAK,EAAE,CAAC,OAAe,EAAE,IAAU,EAAE,EAAE;QACrC,iCAAiC;QACjC,MAAM,cAAc,GAAG,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;QAC1F,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,EAAE,CAAC,OAAe,EAAE,IAAU,EAAE,EAAE;QACpC,OAAO,CAAC,IAAI,CAAC,UAAU,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,EAAE,CAAC,OAAe,EAAE,IAAU,EAAE,EAAE;QACpC,OAAO,CAAC,IAAI,CAAC,UAAU,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,EAAE,CAAC,OAAe,EAAE,IAAU,EAAE,EAAE;QACrC,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;CACF,CAAC"}

package/dist/web/bundle-standalone.js

@@ -0,0 +1,28 @@
+/**
+ * Standalone bundle entry point for Legal Markdown
+ * This creates a browser-compatible bundle that can be used without a server
+ */
+
+// Import the main library
+const { processLegalMarkdown } = require('../index');
+
+// Create a self-contained bundle for browsers
+(function() {
+    // Convert the async function to work in browser context
+    window.LegalMarkdown = {
+        processLegalMarkdown: async function(content, options = {}) {
+            try {
+                // Use the actual library
+                return await processLegalMarkdown(content, options);
+            } catch (error) {
+                console.error('Legal Markdown processing error:', error);
+                throw error;
+            }
+        }
+    };
+    
+    // Also export for CommonJS if available
+    if (typeof module !== 'undefined' && module.exports) {
+        module.exports = window.LegalMarkdown;
+    }
+})();

package/dist/web/bundle.js

@@ -0,0 +1,17 @@
+/**
+ * Browser bundle entry point for Legal Markdown
+ * This file creates a browser-compatible version of the legal-markdown library
+ */
+
+// Import the main library
+const { processLegalMarkdown } = require('../index');
+
+// Create a browser-compatible API
+window.LegalMarkdown = {
+    processLegalMarkdown: processLegalMarkdown
+};
+
+// Export for CommonJS environments too
+if (typeof module !== 'undefined' && module.exports) {
+    module.exports = window.LegalMarkdown;
+}