@scrawn/core 0.0.2

package/dist/utils/logger.d.ts

@@ -0,0 +1,10 @@
+export declare class ScrawnLogger {
+    private context;
+    constructor(context?: string);
+    private log;
+    info(msg: string, data?: any): void;
+    warn(msg: string, data?: any): void;
+    error(msg: string, err?: any): void;
+    debug(msg: string, data?: any): void;
+}
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAsBA,qBAAa,YAAY;IACX,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE,MAAiB;IAE9C,OAAO,CAAC,GAAG;IAiCX,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAI5B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAI5B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG;IAI5B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;CAG9B"}

package/dist/utils/logger.js

@@ -0,0 +1,62 @@
+import fs from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+import pino from 'pino';
+import { ScrawnConfig } from 'src/config.js';
+// ensure log file directory exists
+const logFilePath = path.resolve(process.cwd(), 'scrawn.log');
+fs.mkdirSync(path.dirname(logFilePath), { recursive: true });
+// create pino instance writing to file
+const baseLogger = pino({
+    name: 'scrawn',
+    level: ScrawnConfig.logging.enableDebug ? 'debug' : 'info',
+    timestamp: pino.stdTimeFunctions.isoTime,
+}, pino.destination(logFilePath));
+export class ScrawnLogger {
+    constructor(context = 'Scrawn') {
+        this.context = context;
+    }
+    log(level, message, ...args) {
+        const timestamp = `[${new Date().toLocaleTimeString('en-IN', { timeZone: 'Asia/Kolkata' })}]`;
+        const prefix = `[${this.context}]`;
+        let colorizedPrefix;
+        switch (level) {
+            case 'info':
+                colorizedPrefix = chalk.cyan(`${timestamp} ${prefix}`);
+                baseLogger.info({ context: this.context, ...args[0] }, message);
+                break;
+            case 'warn':
+                colorizedPrefix = chalk.yellow(`${timestamp} ${prefix}`);
+                baseLogger.warn({ context: this.context, ...args[0] }, message);
+                break;
+            case 'error':
+                colorizedPrefix = chalk.redBright(`${timestamp} ${prefix}`);
+                baseLogger.error({ context: this.context, ...args[0] }, message);
+                break;
+            case 'debug':
+                colorizedPrefix = chalk.magenta(`${timestamp} ${prefix}`);
+                baseLogger.debug({ context: this.context, ...args[0] }, message);
+                break;
+            default:
+                colorizedPrefix = `${timestamp} ${prefix}`;
+        }
+        // skip debug unless enabled
+        if (level === 'debug' && !process.env.SCRAWN_DEBUG)
+            return;
+        // print to console with color
+        console.log(`${colorizedPrefix} ${message}`);
+    }
+    info(msg, data) {
+        this.log('info', msg, data);
+    }
+    warn(msg, data) {
+        this.log('warn', msg, data);
+    }
+    error(msg, err) {
+        this.log('error', msg, err instanceof Error ? { err: err.message, stack: err.stack } : err);
+    }
+    debug(msg, data) {
+        this.log('debug', msg, 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":"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"}

package/dist/utils/pathMatcher.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Match a path against a pattern with wildcard support.
+ *
+ * Supports:
+ * - Exact match: /api/users
+ * - Single segment wildcard (*): /api/star matches /api/users but not /api/users/123
+ * - Multi-segment wildcard (**): /api/starstar matches /api/users, /api/users/123, etc.
+ * - Mixed patterns: /api/star/profile, /api/starstar/data, starstar.php, etc.
+ *
+ * @param path - The request path to match
+ * @param pattern - The pattern to match against
+ * @returns true if the path matches the pattern
+ *
+ * @example
+ * ```typescript
+ * matchPath('/api/users', '/api/users') // true - exact match
+ * matchPath('/api/users', '/api/*') // true - single segment wildcard
+ * matchPath('/api/users/123', '/api/*') // false - too many segments
+ * matchPath('/api/users/123', '/api/**') // true - multi-segment wildcard
+ * matchPath('/api/v1/users/data', '/api/** /data') // true - mixed pattern
+ * matchPath('/index.php', '**.php') // true - file extension match
+ * ```
+ */
+export declare function matchPath(path: string, pattern: string): boolean;
+//# sourceMappingURL=pathMatcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pathMatcher.d.ts","sourceRoot":"","sources":["../../src/utils/pathMatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAuBhE"}

package/dist/utils/pathMatcher.js

@@ -0,0 +1,46 @@
+/**
+ * Match a path against a pattern with wildcard support.
+ *
+ * Supports:
+ * - Exact match: /api/users
+ * - Single segment wildcard (*): /api/star matches /api/users but not /api/users/123
+ * - Multi-segment wildcard (**): /api/starstar matches /api/users, /api/users/123, etc.
+ * - Mixed patterns: /api/star/profile, /api/starstar/data, starstar.php, etc.
+ *
+ * @param path - The request path to match
+ * @param pattern - The pattern to match against
+ * @returns true if the path matches the pattern
+ *
+ * @example
+ * ```typescript
+ * matchPath('/api/users', '/api/users') // true - exact match
+ * matchPath('/api/users', '/api/*') // true - single segment wildcard
+ * matchPath('/api/users/123', '/api/*') // false - too many segments
+ * matchPath('/api/users/123', '/api/**') // true - multi-segment wildcard
+ * matchPath('/api/v1/users/data', '/api/** /data') // true - mixed pattern
+ * matchPath('/index.php', '**.php') // true - file extension match
+ * ```
+ */
+export function matchPath(path, pattern) {
+    // Exact match
+    if (path === pattern)
+        return true;
+    // No wildcards, no match
+    if (!pattern.includes('*'))
+        return false;
+    // Convert pattern to regex
+    // Escape special regex characters except * and /
+    let regexPattern = pattern
+        .replace(/[.+?^${}()|[\]\\]/g, '\\$&')
+        // Replace ** with a placeholder to handle it separately
+        .replace(/\*\*/g, '___DOUBLE_STAR___')
+        // Replace * with single segment match (anything except /)
+        .replace(/\*/g, '[^/]+')
+        // Replace ** placeholder with multi-segment match (anything including /)
+        .replace(/___DOUBLE_STAR___/g, '.*');
+    // Ensure we match the full path
+    regexPattern = `^${regexPattern}$`;
+    const regex = new RegExp(regexPattern);
+    return regex.test(path);
+}
+//# sourceMappingURL=pathMatcher.js.map

package/dist/utils/pathMatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathMatcher.js","sourceRoot":"","sources":["../../src/utils/pathMatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAe;IACrD,cAAc;IACd,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAElC,yBAAyB;IACzB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAEzC,2BAA2B;IAC3B,iDAAiD;IACjD,IAAI,YAAY,GAAG,OAAO;SACvB,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC;QACtC,wDAAwD;SACvD,OAAO,CAAC,OAAO,EAAE,mBAAmB,CAAC;QACtC,0DAA0D;SACzD,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;QACxB,yEAAyE;SACxE,OAAO,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;IAEvC,gCAAgC;IAChC,YAAY,GAAG,IAAI,YAAY,GAAG,CAAC;IAEnC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@scrawn/core",
+  "version": "0.0.2",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "node -e \"require('fs').rmSync('dist', {recursive: true, force: true})\"",
+    "gen": "cd proto && bunx buf generate"
+  },
+  "dependencies": {
+    "@bufbuild/protobuf": "^1.10.0",
+    "@bufbuild/protoc-gen-es": "^1.10.0",
+    "@connectrpc/connect": "^1.7.0",
+    "@connectrpc/connect-node": "^1.7.0",
+    "@connectrpc/protoc-gen-connect-es": "^1.7.0",
+    "@connectrpc/validate": "^0.2.0",
+    "buf": "bufbuild/buf",
+    "chalk": "^5.6.2",
+    "pino": "^10.1.0",
+    "typescript": "^5.9.3",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.0"
+  },
+  "files": [
+    "dist"
+  ]
+}