@neurana/sdk 1.0.0

package/lib/utils/file-utils.js

@@ -0,0 +1,138 @@
+import { ValidationError } from '../errors.js';
+import { VALIDATION } from '../constants/index.js';
+const MIME_TYPES = {
+    '.ts': 'text/typescript',
+    '.tsx': 'text/typescript',
+    '.js': 'application/javascript',
+    '.jsx': 'application/javascript',
+    '.json': 'application/json',
+    '.yaml': 'text/yaml',
+    '.yml': 'text/yaml',
+    '.py': 'text/x-python',
+    '.md': 'text/markdown',
+    '.html': 'text/html',
+    '.css': 'text/css',
+    '.txt': 'text/plain',
+    '.xml': 'application/xml',
+    '.csv': 'text/csv',
+    '.sql': 'application/sql',
+    '.graphql': 'application/graphql',
+    '.prisma': 'text/plain',
+};
+const LANGUAGE_MAP = {
+    '.ts': 'typescript',
+    '.tsx': 'typescript',
+    '.js': 'javascript',
+    '.jsx': 'javascript',
+    '.json': 'json',
+    '.yaml': 'yaml',
+    '.yml': 'yaml',
+    '.py': 'python',
+    '.md': 'markdown',
+    '.html': 'html',
+    '.css': 'css',
+    '.sql': 'sql',
+    '.graphql': 'graphql',
+};
+const SAFE_FILENAME_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
+const SAFE_KEY_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9._/-]*$/;
+const DANGEROUS_EXTENSIONS = new Set([
+    '.exe', '.bat', '.cmd', '.sh', '.ps1',
+    '.dll', '.so', '.dylib', '.bin',
+    '.msi', '.com', '.vbs', '.scr',
+]);
+const MAX_KEY_LENGTH = 256;
+const MAX_FILENAME_LENGTH = 255;
+export function getFileExtension(fileName) {
+    const lastDot = fileName.lastIndexOf('.');
+    if (lastDot === -1 || lastDot === fileName.length - 1) {
+        return '';
+    }
+    return fileName.slice(lastDot).toLowerCase();
+}
+export function getMimeType(fileName) {
+    const ext = getFileExtension(fileName);
+    return MIME_TYPES[ext] ?? 'application/octet-stream';
+}
+export function getLanguage(fileName) {
+    const ext = getFileExtension(fileName);
+    return LANGUAGE_MAP[ext] ?? 'plaintext';
+}
+export function isAllowedExtension(fileName) {
+    const ext = getFileExtension(fileName);
+    return VALIDATION.ALLOWED_FILE_EXTENSIONS.includes(ext);
+}
+export function isDangerousExtension(fileName) {
+    const ext = getFileExtension(fileName);
+    return DANGEROUS_EXTENSIONS.has(ext);
+}
+export function validateFileName(fileName) {
+    if (!fileName || typeof fileName !== 'string') {
+        throw new ValidationError('fileName is required');
+    }
+    const trimmed = fileName.trim();
+    if (trimmed.length === 0) {
+        throw new ValidationError('fileName cannot be empty');
+    }
+    if (trimmed.length > MAX_FILENAME_LENGTH) {
+        throw new ValidationError(`fileName exceeds max length of ${MAX_FILENAME_LENGTH}`);
+    }
+    if (!SAFE_FILENAME_PATTERN.test(trimmed)) {
+        throw new ValidationError('fileName contains invalid characters');
+    }
+    if (trimmed.includes('..') || trimmed.includes('/') || trimmed.includes('\\')) {
+        throw new ValidationError('fileName contains path separators');
+    }
+    if (isDangerousExtension(trimmed)) {
+        throw new ValidationError('File type not allowed for security reasons');
+    }
+    return trimmed;
+}
+export function validateFileKey(key) {
+    if (!key || typeof key !== 'string') {
+        throw new ValidationError('key is required');
+    }
+    const trimmed = key.trim();
+    if (trimmed.length === 0) {
+        throw new ValidationError('key cannot be empty');
+    }
+    if (trimmed.length > MAX_KEY_LENGTH) {
+        throw new ValidationError(`key exceeds max length of ${MAX_KEY_LENGTH}`);
+    }
+    if (trimmed.includes('..')) {
+        throw new ValidationError('key contains path traversal');
+    }
+    if (!SAFE_KEY_PATTERN.test(trimmed)) {
+        throw new ValidationError('key contains invalid characters');
+    }
+    return trimmed;
+}
+export function validateFileSize(size, maxSize) {
+    if (size <= 0) {
+        throw new ValidationError('File content cannot be empty');
+    }
+    if (size > maxSize) {
+        const maxMB = (maxSize / (1024 * 1024)).toFixed(1);
+        throw new ValidationError(`File size exceeds maximum of ${maxMB}MB`);
+    }
+}
+export function getContentSize(content) {
+    if (typeof content === 'string') {
+        return Buffer.byteLength(content, 'utf-8');
+    }
+    return content.length;
+}
+export function encodeToBase64(content) {
+    if (typeof content === 'string') {
+        return Buffer.from(content, 'utf-8').toString('base64');
+    }
+    return Buffer.from(content).toString('base64');
+}
+export function formatFileSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=file-utils.js.map

package/lib/utils/file-utils.js.map

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

package/lib/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { getFileExtension, getMimeType, getLanguage, isAllowedExtension, isDangerousExtension, validateFileName, validateFileKey, validateFileSize, getContentSize, encodeToBase64, formatFileSize, } from './file-utils.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/lib/utils/index.js

@@ -0,0 +1,2 @@
+export { getFileExtension, getMimeType, getLanguage, isAllowedExtension, isDangerousExtension, validateFileName, validateFileKey, validateFileSize, getContentSize, encodeToBase64, formatFileSize, } from './file-utils.js';
+//# sourceMappingURL=index.js.map

package/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@neurana/sdk",
+  "version": "1.0.0",
+  "description": "Official Neurana SDK - AI Workflow Automation Platform",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "del-cli lib && tsc",
+    "test": "node --import tsx --test tests/unit/**/*.test.ts",
+    "test:watch": "node --import tsx --test --watch tests/unit/**/*.test.ts",
+    "test:integration": "RUN_INTEGRATION_TESTS=true node --import tsx --test tests/integration/**/*.test.ts",
+    "test:coverage": "c8 npm test",
+    "test:all": "npm test && npm run test:integration",
+    "lint": "eslint src tests",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run lint && npm run typecheck && npm run build && npm test"
+  },
+  "keywords": [
+    "neurana",
+    "workflow",
+    "automation",
+    "ai",
+    "sdk",
+    "api",
+    "serverless",
+    "orchestration",
+    "step-functions",
+    "aws",
+    "lambda",
+    "typescript",
+    "javascript",
+    "nodejs",
+    "workflow-engine",
+    "workflow-automation",
+    "task-automation",
+    "process-automation",
+    "business-automation",
+    "etl",
+    "data-pipeline",
+    "webhooks",
+    "integrations",
+    "no-code",
+    "low-code",
+    "zapier-alternative",
+    "n8n-alternative",
+    "make-alternative"
+  ],
+  "author": "Neurana",
+  "license": "MIT",
+  "homepage": "https://neurana.io",
+  "bugs": {
+    "url": "https://github.com/neurana/sdk/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/neurana/sdk.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^20.0.0",
+    "c8": "^9.0.0",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.6.0",
+    "typescript-eslint": "^8.52.0"
+  }
+}