@tarsis/toolkit 0.4.1 → 0.4.2-beta.0

package/dist/server.cjs

@@ -0,0 +1,170 @@
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const move = (source, start, end) => {
+  const item = source[start];
+  const result = source.slice(0);
+  result.splice(start, 1);
+  result.splice(end, 0, item);
+  return result;
+};
+
+const times = (fn, size) => Array.from({ length: size }, (_, index) => fn(index));
+
+const logRank = {
+  silent: 0,
+  error: 1,
+  warn: 2,
+  info: 3,
+  debug: 4
+};
+const getEnvLogLevel = () => {
+  if (typeof process === "undefined") return "info";
+  const envLevel = process.env.LOG_LEVEL?.toLowerCase();
+  return envLevel && Object.prototype.hasOwnProperty.call(logRank, envLevel) ? envLevel : "info";
+};
+let currentLevel = getEnvLogLevel();
+const setLogLevel = (level) => {
+  if (Object.prototype.hasOwnProperty.call(logRank, level)) {
+    currentLevel = level;
+  }
+};
+const getTimestamp = () => {
+  const now = /* @__PURE__ */ new Date();
+  return now.toTimeString().split(" ")[0] + "." + now.getMilliseconds().toString().padStart(3, "0");
+};
+const shouldLog = (level) => {
+  return logRank[level] <= logRank[currentLevel];
+};
+let sessionId = null;
+let requestId = null;
+const setSessionId = (id) => {
+  sessionId = id;
+};
+const setRequestId = (id) => {
+  requestId = id;
+};
+const clearSession = () => {
+  sessionId = null;
+  requestId = null;
+};
+const getSessionInfo = () => {
+  const parts = [];
+  if (sessionId) parts.push(`session:${sessionId}`);
+  if (requestId) parts.push(`req:${requestId}`);
+  return parts.length > 0 ? `[${parts.join("|")}]` : "";
+};
+class BaseLogger {
+  prefix;
+  emoji;
+  constructor(prefix, emoji) {
+    this.prefix = prefix;
+    this.emoji = emoji;
+  }
+  log(level, emoji, msg, fn = console.log, data) {
+    if (shouldLog(level)) {
+      const sessionInfo = getSessionInfo();
+      const logMessage = `[${getTimestamp()}] ${emoji} ${this.prefix ? `[${this.prefix}] ` : ""}${msg}${sessionInfo}`;
+      fn(logMessage);
+      if (data && shouldLog(level)) {
+        console.dir(data, { depth: null });
+      }
+    }
+  }
+  info(msg, data) {
+    this.log("info", this.emoji, msg, console.log, data);
+  }
+  debug(msg, data) {
+    this.log("debug", this.emoji, msg, console.debug, data);
+  }
+  success(msg, data) {
+    this.log("info", "✅", msg, console.log, data);
+  }
+  warn(msg, data) {
+    this.log("warn", "⚠️", msg, console.warn, data);
+  }
+  error(msg, detail) {
+    this.log("error", "❌", msg, console.error, detail);
+  }
+  scope(msg, data) {
+    this.log("debug", "🔹", msg, console.debug, data);
+  }
+  dir(data) {
+    if (shouldLog("debug")) {
+      this.log("debug", "📦", "Object:", console.debug);
+      console.dir(data, { depth: null });
+    }
+  }
+  time(label) {
+    const start = performance.now();
+    return {
+      end: (data) => {
+        const duration = performance.now() - start;
+        this.info(`${label} completed in ${duration.toFixed(2)}ms`, data);
+      }
+    };
+  }
+}
+const logger = new BaseLogger("", "ℹ️");
+const componentLogger = new BaseLogger("Component", "🧩");
+const hookLogger = new BaseLogger("Hook", "🪝");
+const animationLogger = new BaseLogger("Animation", "🎬");
+const eventLogger = new BaseLogger("Event", "⚡");
+const apiLogger = new BaseLogger("API", "🌐");
+const storageLogger = new BaseLogger("Storage", "💾");
+const utilsLogger = new BaseLogger("Utils", "🔧");
+const getCurrentLogLevel = () => currentLevel;
+const isDebugEnabled = () => shouldLog("debug");
+
+const noop = (..._args) => {
+};
+
+const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+const is = (type) => (x) => Object(x) instanceof type;
+
+const isNonNullable = (value) => value !== void 0 && value !== null;
+
+const notReachable = (arg) => {
+  throw new Error(`"${arg}" should never be reached`);
+};
+
+const keys = (value) => {
+  const primitiveKeys = Object.keys(
+    value
+  );
+  const symbolKeys = Object.getOwnPropertySymbols(value).filter(
+    (sym) => Object.getOwnPropertyDescriptor(value, sym)?.enumerable
+  );
+  return [...primitiveKeys, ...symbolKeys];
+};
+
+const values = (input) => {
+  return keys(input).map((key) => input[key]);
+};
+
+exports.BaseLogger = BaseLogger;
+exports.animationLogger = animationLogger;
+exports.apiLogger = apiLogger;
+exports.clearSession = clearSession;
+exports.componentLogger = componentLogger;
+exports.eventLogger = eventLogger;
+exports.getCurrentLogLevel = getCurrentLogLevel;
+exports.hookLogger = hookLogger;
+exports.is = is;
+exports.isDebugEnabled = isDebugEnabled;
+exports.isNonNullable = isNonNullable;
+exports.keys = keys;
+exports.logger = logger;
+exports.move = move;
+exports.noop = noop;
+exports.notReachable = notReachable;
+exports.setLogLevel = setLogLevel;
+exports.setRequestId = setRequestId;
+exports.setSessionId = setSessionId;
+exports.storageLogger = storageLogger;
+exports.times = times;
+exports.utilsLogger = utilsLogger;
+exports.values = values;
+exports.wait = wait;

package/dist/server.d.ts

@@ -0,0 +1,72 @@
+export declare const animationLogger: BaseLogger;
+
+export declare const apiLogger: BaseLogger;
+
+export declare class BaseLogger {
+    protected prefix: string;
+    protected emoji: string;
+    constructor(prefix: string, emoji: string);
+    private log;
+    info(msg: string, data?: unknown): void;
+    debug(msg: string, data?: unknown): void;
+    success(msg: string, data?: unknown): void;
+    warn(msg: string, data?: unknown): void;
+    error(msg: string, detail?: unknown): void;
+    scope(msg: string, data?: unknown): void;
+    dir<T>(data: T): void;
+    time(label: string): {
+        end: (data?: unknown) => void;
+    };
+}
+
+export declare const clearSession: () => void;
+
+export declare const componentLogger: BaseLogger;
+
+declare type Constructor<T> = new (...args: any[]) => T;
+
+export declare const eventLogger: BaseLogger;
+
+export declare const getCurrentLogLevel: () => LogLevel;
+
+export declare const hookLogger: BaseLogger;
+
+export declare const is: <T>(type: Constructor<T>) => (x: T) => boolean;
+
+export declare const isDebugEnabled: () => boolean;
+
+export declare const isNonNullable: <T>(value: T) => value is NonNullable<T>;
+
+export declare const keys: <T extends Record<string | number | symbol, any>>(value: T) => Array<`${keyof T & (string | number | boolean)}` | (keyof T & symbol)>;
+
+export declare const logger: BaseLogger;
+
+/**
+ * Advanced logger utility for the toolkit
+ * Provides consistent logging interface across components with emojis, session tracking, and performance timing
+ */
+export declare type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
+
+export declare const move: <T>(source: T[], start: number, end: number) => T[];
+
+export declare const noop: (..._args: unknown[]) => void;
+
+export declare const notReachable: (arg: never) => never;
+
+export declare const setLogLevel: (level: LogLevel) => void;
+
+export declare const setRequestId: (id: string) => void;
+
+export declare const setSessionId: (id: string) => void;
+
+export declare const storageLogger: BaseLogger;
+
+export declare const times: <T>(fn: (index: number) => T, size: number) => T[];
+
+export declare const utilsLogger: BaseLogger;
+
+export declare const values: <T extends Record<string | number | symbol, any>>(input: T) => Array<T[keyof T]>;
+
+export declare const wait: (ms: number) => Promise<unknown>;
+
+export { }

package/dist/server.js

@@ -0,0 +1,143 @@
+const move = (source, start, end) => {
+  const item = source[start];
+  const result = source.slice(0);
+  result.splice(start, 1);
+  result.splice(end, 0, item);
+  return result;
+};
+
+const times = (fn, size) => Array.from({ length: size }, (_, index) => fn(index));
+
+const logRank = {
+  silent: 0,
+  error: 1,
+  warn: 2,
+  info: 3,
+  debug: 4
+};
+const getEnvLogLevel = () => {
+  if (typeof process === "undefined") return "info";
+  const envLevel = process.env.LOG_LEVEL?.toLowerCase();
+  return envLevel && Object.prototype.hasOwnProperty.call(logRank, envLevel) ? envLevel : "info";
+};
+let currentLevel = getEnvLogLevel();
+const setLogLevel = (level) => {
+  if (Object.prototype.hasOwnProperty.call(logRank, level)) {
+    currentLevel = level;
+  }
+};
+const getTimestamp = () => {
+  const now = /* @__PURE__ */ new Date();
+  return now.toTimeString().split(" ")[0] + "." + now.getMilliseconds().toString().padStart(3, "0");
+};
+const shouldLog = (level) => {
+  return logRank[level] <= logRank[currentLevel];
+};
+let sessionId = null;
+let requestId = null;
+const setSessionId = (id) => {
+  sessionId = id;
+};
+const setRequestId = (id) => {
+  requestId = id;
+};
+const clearSession = () => {
+  sessionId = null;
+  requestId = null;
+};
+const getSessionInfo = () => {
+  const parts = [];
+  if (sessionId) parts.push(`session:${sessionId}`);
+  if (requestId) parts.push(`req:${requestId}`);
+  return parts.length > 0 ? `[${parts.join("|")}]` : "";
+};
+class BaseLogger {
+  prefix;
+  emoji;
+  constructor(prefix, emoji) {
+    this.prefix = prefix;
+    this.emoji = emoji;
+  }
+  log(level, emoji, msg, fn = console.log, data) {
+    if (shouldLog(level)) {
+      const sessionInfo = getSessionInfo();
+      const logMessage = `[${getTimestamp()}] ${emoji} ${this.prefix ? `[${this.prefix}] ` : ""}${msg}${sessionInfo}`;
+      fn(logMessage);
+      if (data && shouldLog(level)) {
+        console.dir(data, { depth: null });
+      }
+    }
+  }
+  info(msg, data) {
+    this.log("info", this.emoji, msg, console.log, data);
+  }
+  debug(msg, data) {
+    this.log("debug", this.emoji, msg, console.debug, data);
+  }
+  success(msg, data) {
+    this.log("info", "✅", msg, console.log, data);
+  }
+  warn(msg, data) {
+    this.log("warn", "⚠️", msg, console.warn, data);
+  }
+  error(msg, detail) {
+    this.log("error", "❌", msg, console.error, detail);
+  }
+  scope(msg, data) {
+    this.log("debug", "🔹", msg, console.debug, data);
+  }
+  dir(data) {
+    if (shouldLog("debug")) {
+      this.log("debug", "📦", "Object:", console.debug);
+      console.dir(data, { depth: null });
+    }
+  }
+  time(label) {
+    const start = performance.now();
+    return {
+      end: (data) => {
+        const duration = performance.now() - start;
+        this.info(`${label} completed in ${duration.toFixed(2)}ms`, data);
+      }
+    };
+  }
+}
+const logger = new BaseLogger("", "ℹ️");
+const componentLogger = new BaseLogger("Component", "🧩");
+const hookLogger = new BaseLogger("Hook", "🪝");
+const animationLogger = new BaseLogger("Animation", "🎬");
+const eventLogger = new BaseLogger("Event", "⚡");
+const apiLogger = new BaseLogger("API", "🌐");
+const storageLogger = new BaseLogger("Storage", "💾");
+const utilsLogger = new BaseLogger("Utils", "🔧");
+const getCurrentLogLevel = () => currentLevel;
+const isDebugEnabled = () => shouldLog("debug");
+
+const noop = (..._args) => {
+};
+
+const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+const is = (type) => (x) => Object(x) instanceof type;
+
+const isNonNullable = (value) => value !== void 0 && value !== null;
+
+const notReachable = (arg) => {
+  throw new Error(`"${arg}" should never be reached`);
+};
+
+const keys = (value) => {
+  const primitiveKeys = Object.keys(
+    value
+  );
+  const symbolKeys = Object.getOwnPropertySymbols(value).filter(
+    (sym) => Object.getOwnPropertyDescriptor(value, sym)?.enumerable
+  );
+  return [...primitiveKeys, ...symbolKeys];
+};
+
+const values = (input) => {
+  return keys(input).map((key) => input[key]);
+};
+
+export { BaseLogger, animationLogger, apiLogger, clearSession, componentLogger, eventLogger, getCurrentLogLevel, hookLogger, is, isDebugEnabled, isNonNullable, keys, logger, move, noop, notReachable, setLogLevel, setRequestId, setSessionId, storageLogger, times, utilsLogger, values, wait };