baraqex 1.0.8 → 1.0.10

package/dist/server/templates.d.ts

@@ -0,0 +1,31 @@
+/**
+ * HTML template generators for server-side rendering
+ */
+export interface DocumentOptions {
+    title?: string;
+    description?: string;
+    lang?: string;
+    charset?: string;
+    viewport?: string;
+    scripts?: string[];
+    styles?: string[];
+    meta?: Record<string, string>;
+    bodyClasses?: string;
+    htmlAttrs?: Record<string, string>;
+    bodyAttrs?: Record<string, string>;
+    initialData?: any;
+    componentName?: string;
+}
+/**
+ * Generate a complete HTML document
+ */
+export declare function generateDocument(content: string, options?: DocumentOptions): string;
+/**
+ * Generate an error page
+ */
+export declare function generateErrorPage(statusCode: number, message: string, error?: Error): string;
+/**
+ * Generate a loading page
+ */
+export declare function generateLoadingPage(message?: string): string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/server/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/server/templates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,eAAoB,GAC5B,MAAM,CAyER;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,GACZ,MAAM,CAgGR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,MAAqB,GAAG,MAAM,CAyC1E"}

package/dist/server/templates.js

@@ -0,0 +1,208 @@
+/**
+ * HTML template generators for server-side rendering
+ */
+/**
+ * Generate a complete HTML document
+ */
+export function generateDocument(content, options = {}) {
+    const { title = 'Frontend Hamroun App', description = '', lang = 'en', charset = 'UTF-8', viewport = 'width=device-width, initial-scale=1.0', scripts = [], styles = [], meta = {}, bodyClasses = '', htmlAttrs = {}, bodyAttrs = {}, initialData = {}, componentName = '' } = options;
+    // Generate HTML attributes
+    const htmlAttributes = Object.entries(htmlAttrs)
+        .map(([key, value]) => `${key}="${escapeHtml(value)}"`)
+        .join(' ');
+    // Generate body attributes
+    const bodyAttributes = Object.entries(bodyAttrs)
+        .map(([key, value]) => `${key}="${escapeHtml(value)}"`)
+        .join(' ');
+    // Generate meta tags
+    const metaTags = [
+        `<meta charset="${charset}">`,
+        `<meta name="viewport" content="${viewport}">`,
+        description ? `<meta name="description" content="${escapeHtml(description)}">` : ''
+    ];
+    // Add custom meta tags
+    Object.entries(meta).forEach(([name, content]) => {
+        metaTags.push(`<meta name="${escapeHtml(name)}" content="${escapeHtml(content)}">`);
+    });
+    // Generate script tags
+    const scriptTags = scripts.map(src => {
+        if (src.startsWith('<script')) {
+            return src; // Allow inline scripts
+        }
+        return `<script src="${escapeHtml(src)}" ${src.endsWith('.js') ? 'type="module"' : ''} defer></script>`;
+    });
+    // Generate style tags
+    const styleTags = styles.map(href => {
+        if (href.startsWith('<style')) {
+            return href; // Allow inline styles
+        }
+        return `<link rel="stylesheet" href="${escapeHtml(href)}">`;
+    });
+    // Create initial data script
+    const initialDataScript = Object.keys(initialData).length > 0 ?
+        `<script id="__APP_DATA__" type="application/json">${escapeHtml(JSON.stringify(initialData))}</script>` : '';
+    // Create the complete HTML document
+    return `<!DOCTYPE html>
+<html lang="${lang}" ${htmlAttributes}>
+<head>
+  ${metaTags.filter(Boolean).join('\n  ')}
+  <title>${escapeHtml(title)}</title>
+  ${styleTags.join('\n  ')}
+</head>
+<body class="${bodyClasses}" ${bodyAttributes}>
+  <div id="app-root" data-ssr-root${componentName ? ` data-component="${escapeHtml(componentName)}"` : ''}>${content}</div>
+  ${initialDataScript}
+  ${scriptTags.join('\n  ')}
+</body>
+</html>`;
+}
+/**
+ * Generate an error page
+ */
+export function generateErrorPage(statusCode, message, error) {
+    const errorMessages = {
+        400: 'Bad Request',
+        401: 'Unauthorized',
+        403: 'Forbidden',
+        404: 'Not Found',
+        500: 'Internal Server Error'
+    };
+    const title = `${statusCode} - ${errorMessages[statusCode] || 'Error'}`;
+    // Generate error details (only in development)
+    const isDev = process.env.NODE_ENV !== 'production';
+    const errorDetails = isDev && error ? `
+    <div class="error-details">
+      <pre>${escapeHtml(error.stack || error.message)}</pre>
+    </div>
+  ` : '';
+    // Create error content
+    const content = `
+    <div class="error-container">
+      <h1>${statusCode}</h1>
+      <h2>${escapeHtml(errorMessages[statusCode] || 'Error')}</h2>
+      <p>${escapeHtml(message)}</p>
+      ${errorDetails}
+      <a href="/" class="home-link">Back to Home</a>
+    </div>
+  `;
+    // Add error page styling
+    const styles = [`<style>
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;
+      display: flex;
+      justify-content: center;
+      align-items: center;
+      min-height: 100vh;
+      margin: 0;
+      background-color: #f7f7f7;
+      color: #333;
+    }
+    .error-container {
+      text-align: center;
+      padding: 2rem;
+      border-radius: 8px;
+      background-color: white;
+      box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
+      max-width: 600px;
+      width: 100%;
+    }
+    h1 {
+      font-size: 6rem;
+      margin: 0;
+      color: #e74c3c;
+    }
+    h2 {
+      margin-top: 0;
+      margin-bottom: 1rem;
+      color: #333;
+    }
+    .error-details {
+      text-align: left;
+      margin: 2rem 0;
+      padding: 1rem;
+      background-color: #f8f8f8;
+      border-radius: 4px;
+      overflow: auto;
+    }
+    pre {
+      margin: 0;
+      font-family: monospace;
+      font-size: 0.85rem;
+      white-space: pre-wrap;
+    }
+    .home-link {
+      display: inline-block;
+      margin-top: 1.5rem;
+      padding: 0.75rem 1.5rem;
+      background-color: #3498db;
+      color: white;
+      text-decoration: none;
+      border-radius: 4px;
+      transition: background-color 0.2s;
+    }
+    .home-link:hover {
+      background-color: #2980b9;
+    }
+  </style>`];
+    return generateDocument(content, {
+        title,
+        description: `Error ${statusCode}: ${errorMessages[statusCode] || 'Error'}`,
+        bodyClasses: 'error-page',
+        styles
+    });
+}
+/**
+ * Generate a loading page
+ */
+export function generateLoadingPage(message = 'Loading...') {
+    const content = `
+    <div class="loading-container">
+      <div class="spinner"></div>
+      <p>${escapeHtml(message)}</p>
+    </div>
+  `;
+    const styles = [`<style>
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;
+      display: flex;
+      justify-content: center;
+      align-items: center;
+      min-height: 100vh;
+      margin: 0;
+      background-color: #f7f7f7;
+      color: #333;
+    }
+    .loading-container {
+      text-align: center;
+    }
+    .spinner {
+      width: 50px;
+      height: 50px;
+      border: 5px solid rgba(0, 0, 0, 0.1);
+      border-radius: 50%;
+      border-top-color: #3498db;
+      animation: spin 1s ease-in-out infinite;
+      margin: 0 auto 20px;
+    }
+    @keyframes spin {
+      to { transform: rotate(360deg); }
+    }
+  </style>`];
+    return generateDocument(content, {
+        title: 'Loading',
+        bodyClasses: 'loading-page',
+        styles
+    });
+}
+/**
+ * Escape HTML special characters
+ */
+function escapeHtml(text) {
+    return String(text)
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#039;');
+}
+//# sourceMappingURL=templates.js.map

package/dist/server/templates.js.map

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

package/dist/server/types.d.ts

@@ -0,0 +1,39 @@
+export interface ServerConfig {
+    port?: number;
+    apiDir?: string;
+    pagesDir?: string;
+    staticDir?: string;
+    enableCors?: boolean;
+    corsOptions?: any;
+    db?: {
+        url: string;
+        type: 'mongodb' | 'mysql' | 'postgres';
+    };
+    auth?: {
+        secret: string;
+        expiresIn?: string;
+    };
+}
+export interface Server {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getExpressApp(): any;
+    getDatabase(): any;
+    getAuth(): any;
+}
+export interface User {
+    id: string | number;
+    username: string;
+    password?: string;
+    email?: string;
+    roles?: string[];
+    [key: string]: any;
+}
+export interface DbConfig {
+    url: string;
+    type: 'mongodb' | 'mysql' | 'postgres';
+}
+export interface MiddlewareFunction {
+    (req: any, res: any, next: any): void | Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,EAAE,CAAC,EAAE;QACH,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;KACxC,CAAC;IACF,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,aAAa,IAAI,GAAG,CAAC;IACrB,WAAW,IAAI,GAAG,CAAC;IACnB,OAAO,IAAI,GAAG,CAAC;CAChB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD"}

package/dist/server/types.js

@@ -0,0 +1,4 @@
+// Type definitions without actual implementation
+// These can be safely imported in any environment
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/types.js.map

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

package/dist/server/utils.d.ts

@@ -0,0 +1,71 @@
+import { Request, Response } from 'express';
+/**
+ * Utility functions for server-side operations
+ */
+/**
+ * Safely parse JSON with error handling
+ */
+export declare function safeJsonParse<T>(json: string, fallback: T): T;
+/**
+ * Generate a secure random token
+ */
+export declare function generateToken(length?: number): string;
+/**
+ * Hash a string using SHA-256
+ */
+export declare function hashString(input: string, salt?: string): string;
+/**
+ * Get pagination parameters from request
+ */
+export declare function getPagination(req: Request): {
+    page: number;
+    limit: number;
+    skip: number;
+};
+/**
+ * Standard success response format
+ */
+export declare function sendSuccess<T>(res: Response, data: T, message?: string): Response;
+/**
+ * Standard error response format
+ */
+export declare function sendError(res: Response, message?: string, statusCode?: number, errors?: any): Response;
+/**
+ * Validate required fields in request body
+ */
+export declare function validateFields(req: Request, requiredFields: string[]): {
+    valid: boolean;
+    missing: string[];
+};
+/**
+ * Handle file upload validation
+ */
+export declare function validateFileUpload(file: any, // Using 'any' to avoid the Express.Multer dependency
+options?: {
+    maxSize?: number;
+    allowedTypes?: string[];
+}): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Get server environment information
+ */
+export declare function getEnvironmentInfo(): Record<string, any>;
+/**
+ * Check if a directory is empty
+ */
+export declare function isDirectoryEmpty(dirPath: string): Promise<boolean>;
+/**
+ * Create directory if it doesn't exist
+ */
+export declare function ensureDirectory(dirPath: string): Promise<void>;
+/**
+ * Write JSON to file
+ */
+export declare function writeJsonFile(filePath: string, data: any): Promise<void>;
+/**
+ * Read JSON from file
+ */
+export declare function readJsonFile<T>(filePath: string, defaultValue: T): Promise<T>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/server/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/server/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAK5C;;GAEG;AAEH;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAM7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAW,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAMzF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,MAAkB,GAAG,QAAQ,CAM5F;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,QAAQ,EACb,OAAO,GAAE,MAA4B,EACrC,UAAU,GAAE,MAAY,EACxB,MAAM,CAAC,EAAE,GAAG,GACX,QAAQ,CAMV;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,OAAO,EACZ,cAAc,EAAE,MAAM,EAAE,GACvB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAUvC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,GAAG,EAAE,qDAAqD;AAChE,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GACL;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAyBpC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CASxD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQxE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAOnF"}

package/dist/server/utils.js

@@ -0,0 +1,156 @@
+import crypto from 'crypto';
+import fs from 'fs/promises';
+import path from 'path';
+/**
+ * Utility functions for server-side operations
+ */
+/**
+ * Safely parse JSON with error handling
+ */
+export function safeJsonParse(json, fallback) {
+    try {
+        return JSON.parse(json);
+    }
+    catch (error) {
+        return fallback;
+    }
+}
+/**
+ * Generate a secure random token
+ */
+export function generateToken(length = 32) {
+    return crypto.randomBytes(length).toString('hex');
+}
+/**
+ * Hash a string using SHA-256
+ */
+export function hashString(input, salt = '') {
+    return crypto.createHash('sha256').update(input + salt).digest('hex');
+}
+/**
+ * Get pagination parameters from request
+ */
+export function getPagination(req) {
+    const page = Math.max(1, parseInt(req.query.page) || 1);
+    const limit = Math.max(1, Math.min(100, parseInt(req.query.limit) || 20));
+    const skip = (page - 1) * limit;
+    return { page, limit, skip };
+}
+/**
+ * Standard success response format
+ */
+export function sendSuccess(res, data, message = 'Success') {
+    return res.json({
+        success: true,
+        message,
+        data
+    });
+}
+/**
+ * Standard error response format
+ */
+export function sendError(res, message = 'An error occurred', statusCode = 400, errors) {
+    return res.status(statusCode).json({
+        success: false,
+        message,
+        errors: errors || undefined
+    });
+}
+/**
+ * Validate required fields in request body
+ */
+export function validateFields(req, requiredFields) {
+    const missing = requiredFields.filter(field => {
+        const value = req.body[field];
+        return value === undefined || value === null || value === '';
+    });
+    return {
+        valid: missing.length === 0,
+        missing
+    };
+}
+/**
+ * Handle file upload validation
+ */
+export function validateFileUpload(file, // Using 'any' to avoid the Express.Multer dependency
+options = {}) {
+    if (!file) {
+        return { valid: false, error: 'No file provided' };
+    }
+    // Check file size
+    if (options.maxSize && file.size > options.maxSize) {
+        return {
+            valid: false,
+            error: `File too large. Maximum size allowed is ${options.maxSize / 1024 / 1024}MB`
+        };
+    }
+    // Check file type
+    if (options.allowedTypes && options.allowedTypes.length > 0) {
+        const fileType = file.mimetype;
+        if (!options.allowedTypes.includes(fileType)) {
+            return {
+                valid: false,
+                error: `Invalid file type. Allowed types: ${options.allowedTypes.join(', ')}`
+            };
+        }
+    }
+    return { valid: true };
+}
+/**
+ * Get server environment information
+ */
+export function getEnvironmentInfo() {
+    return {
+        nodeVersion: process.version,
+        platform: process.platform,
+        arch: process.arch,
+        memory: process.memoryUsage(),
+        uptime: process.uptime(),
+        env: process.env.NODE_ENV || 'development'
+    };
+}
+/**
+ * Check if a directory is empty
+ */
+export async function isDirectoryEmpty(dirPath) {
+    try {
+        const files = await fs.readdir(dirPath);
+        return files.length === 0;
+    }
+    catch (error) {
+        // Directory doesn't exist or can't be read
+        return true;
+    }
+}
+/**
+ * Create directory if it doesn't exist
+ */
+export async function ensureDirectory(dirPath) {
+    try {
+        await fs.access(dirPath);
+    }
+    catch (error) {
+        // Directory doesn't exist, create it
+        await fs.mkdir(dirPath, { recursive: true });
+    }
+}
+/**
+ * Write JSON to file
+ */
+export async function writeJsonFile(filePath, data) {
+    await ensureDirectory(path.dirname(filePath));
+    await fs.writeFile(filePath, JSON.stringify(data, null, 2), 'utf8');
+}
+/**
+ * Read JSON from file
+ */
+export async function readJsonFile(filePath, defaultValue) {
+    try {
+        const data = await fs.readFile(filePath, 'utf8');
+        return safeJsonParse(data, defaultValue);
+    }
+    catch (error) {
+        return defaultValue;
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/server/utils.js.map

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

package/dist/server/wasm.d.ts

@@ -0,0 +1,10 @@
+import { GoWasmInstance, GoWasmOptions } from '../wasm.js';
+/**
+ * Initialize the Node.js environment for running Go WASM modules
+ */
+export declare function initNodeWasm(): Promise<void>;
+/**
+ * Load a Go WASM module from a file path for server-side usage
+ */
+export declare function loadGoWasmFromFile(wasmFilePath: string, options?: GoWasmOptions): Promise<GoWasmInstance>;
+//# sourceMappingURL=wasm.d.ts.map

package/dist/server/wasm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm.d.ts","sourceRoot":"","sources":["../../src/server/wasm.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAK3D;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CA0BlD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,cAAc,CAAC,CA4FzB"}

package/dist/server/wasm.js

@@ -0,0 +1,117 @@
+/**
+ * Server-side Go WASM integration for Node.js
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+// Global flag to ensure we only initialize WASM once
+let initialized = false;
+/**
+ * Initialize the Node.js environment for running Go WASM modules
+ */
+export async function initNodeWasm() {
+    if (initialized)
+        return;
+    try {
+        // Check if node requires WASM flags
+        const nodeVersion = process.version;
+        const majorVersion = parseInt(nodeVersion.slice(1).split('.')[0], 10);
+        // Node.js version check for WASM flags requirement
+        if (majorVersion < 16) {
+            console.warn('[WASM] Note: Node.js version < 16 detected. ' +
+                'You may need --experimental-wasm-bigint flag for Go WASM modules.');
+        }
+        // Global WASM environment setup for Node.js
+        globalThis.TextEncoder = globalThis.TextEncoder || TextEncoder;
+        globalThis.TextDecoder = globalThis.TextDecoder || TextDecoder;
+        // Mark as initialized
+        initialized = true;
+    }
+    catch (error) {
+        console.error('[WASM] Failed to initialize Node.js WASM environment:', error);
+        throw error;
+    }
+}
+/**
+ * Load a Go WASM module from a file path for server-side usage
+ */
+export async function loadGoWasmFromFile(wasmFilePath, options = {}) {
+    try {
+        // Initialize Node.js WASM environment
+        await initNodeWasm();
+        // Get __dirname equivalent in ESM
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = path.dirname(__filename);
+        // Load Go runtime
+        const goRuntimePath = options.goWasmPath ||
+            path.join(__dirname, '..', '..', 'templates', 'go', 'wasm_exec_node.js');
+        // Import the Go runtime
+        const { Go } = await import(goRuntimePath);
+        const go = new Go();
+        // Load WASM binary
+        const wasmBuffer = await fs.readFile(wasmFilePath);
+        const wasmModule = await WebAssembly.compile(wasmBuffer);
+        // Create imports object
+        const finalImportObject = {
+            ...go.importObject,
+            ...options.importObject
+        };
+        // Instantiate the WASM module
+        const instance = await WebAssembly.instantiate(wasmModule, finalImportObject);
+        // Initialize Go runtime
+        go.run(instance);
+        // Extract exported functions
+        const exports = instance.exports;
+        const functions = {};
+        // Generate wrapper functions for all exports that are functions
+        for (const key in exports) {
+            if (typeof exports[key] === 'function') {
+                // Fix the type assertion
+                const exportedFunc = exports[key];
+                functions[key] = (...args) => exportedFunc(...args);
+                if (options.debug) {
+                    const originalFn = functions[key];
+                    functions[key] = (...args) => {
+                        console.log(`[WASM] Calling ${key}(${args.join(', ')})`);
+                        const result = originalFn(...args);
+                        console.log(`[WASM] ${key} returned:`, result);
+                        return result;
+                    };
+                }
+            }
+        }
+        // Also capture global functions exported by Go
+        for (const key in global) {
+            if (key.startsWith('go') && typeof global[key] === 'function') {
+                // Fix the type assertion
+                const globalFunc = global[key];
+                functions[key] = (...args) => globalFunc(...args);
+                if (options.debug) {
+                    const originalFn = functions[key];
+                    functions[key] = (...args) => {
+                        console.log(`[WASM] Calling global ${key}(${args.join(', ')})`);
+                        const result = originalFn(...args);
+                        console.log(`[WASM] ${key} returned:`, result);
+                        return result;
+                    };
+                }
+            }
+        }
+        const wasmInstance = {
+            instance,
+            module: wasmModule,
+            exports,
+            functions
+        };
+        // Run onLoad callback if provided
+        if (options.onLoad) {
+            options.onLoad(wasmInstance);
+        }
+        return wasmInstance;
+    }
+    catch (error) {
+        console.error('[WASM] Failed to load Go WASM module:', error);
+        throw error;
+    }
+}
+//# sourceMappingURL=wasm.js.map