@powerlines/core 0.43.30 → 0.44.0

package/dist/types/log.d.cts

@@ -0,0 +1,90 @@
+import { BaseContext } from "./context.cjs";
+import { Mode, WorkspaceConfig } from "./config.cjs";
+import { PartialKeys, RequiredKeys } from "@stryke/types/base";
+
+//#region src/types/log.d.ts
+type LogLevel = "silent" | "error" | "warn" | "info" | "debug" | "trace";
+type LogCategory = "general" | "fs" | "performance" | "config" | "plugins" | "hooks" | "env" | "ipc" | "babel" | "network";
+declare const LogLevels: {
+  readonly SILENT: "silent";
+  readonly ERROR: "error";
+  readonly WARN: "warn";
+  readonly INFO: "info";
+  readonly DEBUG: "debug";
+  readonly TRACE: "trace";
+};
+declare const LogCategories: {
+  readonly GENERAL: "general";
+  readonly FS: "fs";
+  readonly PERFORMANCE: "performance";
+  readonly CONFIG: "config";
+  readonly PLUGINS: "plugins";
+  readonly HOOKS: "hooks";
+  readonly ENV: "env";
+  readonly IPC: "ipc";
+  readonly BABEL: "babel";
+  readonly NETWORK: "network";
+};
+interface LogMeta {
+  /**
+   * A unique identifier for the log message, which can be used to correlate related log entries across different parts of the system or different executions.
+   */
+  logId: string;
+  /**
+   * The log level label indicating the severity of the log message.
+   */
+  level: LogLevel;
+  /**
+   * The category of the log message, which can be used to classify and filter log entries based on their purpose or origin.
+   */
+  category: LogCategory;
+  /**
+   * The timestamp when the IPC message was created, represented as the number of milliseconds since the Unix epoch.
+   */
+  timestamp: number;
+  /**
+   * A unique identifier for the current execution instance, which can be used for logging and other purposes to distinguish between different executions in the same process.
+   */
+  executionId?: string;
+  /**
+   * The zero-based index of the current execution within the sequence of executions in the same process.
+   */
+  executionIndex?: number;
+  /**
+   * Optional environment identifier to specify the context or environment in which the message is being processed.
+   */
+  environment?: string;
+  /**
+   * Optional plugin name to specify the source plugin of the log message.
+   */
+  plugin?: string;
+  /**
+   * The name of the logger or source of the log message, which can be used to identify the origin of the log entry.
+   */
+  source?: string;
+}
+type Logger = (meta: LogMeta, ...args: string[]) => void;
+type LogFnConfig = Omit<Partial<LogMeta>, "logId" | "level" | "timestamp"> & {
+  mode?: Mode;
+  command?: string;
+  logLevel?: LogLevelUserConfig | LogLevelResolvedConfig;
+  colors?: WorkspaceConfig["colors"];
+};
+type LogFnMeta = LogLevel | PartialKeys<LogMeta, "logId" | "category" | "timestamp">;
+type LogFn = (meta: LogFnMeta, ...args: string[]) => void;
+type CreateLoggerFunction<TContext extends BaseContext = BaseContext> = (context: TContext) => Logger;
+type LogLevelUserConfig = LogLevel | RequiredKeys<Record<LogCategory, LogLevel | boolean | undefined>, "general">;
+type LogLevelResolvedConfig = Record<LogCategory, LogLevel>;
+declare type __ΩLogLevel = any[];
+declare type __ΩLogCategory = any[];
+declare type __ΩLogMeta = any[];
+declare type __ΩLogger = any[];
+declare type __ΩLogFnConfig = any[];
+declare type __ΩLogFnMeta = any[];
+declare type __ΩLogFn = any[];
+declare type __ΩCreateLoggerFunction = any[];
+declare type __ΩLogLevelUserConfig = any[];
+declare type __ΩLogLevelResolvedConfig = any[];
+//#endregion
+export { CreateLoggerFunction, LogCategories, LogCategory, LogFn, LogFnConfig, LogFnMeta, LogLevel, LogLevelResolvedConfig, LogLevelUserConfig, LogLevels, LogMeta, Logger, __ΩCreateLoggerFunction, __ΩLogCategory, __ΩLogFn, __ΩLogFnConfig, __ΩLogFnMeta, __ΩLogLevel, __ΩLogLevelResolvedConfig, __ΩLogLevelUserConfig, __ΩLogMeta, __ΩLogger };
+//# sourceMappingURL=log.d.cts.map

package/dist/types/log.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.cts","names":[],"sources":["../../src/types/log.ts"],"mappings":";;;;;KAsBY,QAAA;AAAA,KAEA,WAAA;AAAA,cAYC,SAAA;EAAA;;;;;;;cASA,aAAA;EAAA;;;;;;;;;;;UAaI,OAAA;;AAbjB;;EAiBE,KAAA;EANQ;;;EAUR,KAAA,EAAO,QAAA;;;;EAIP,QAAA,EAAU,WAAA;;;;EAIV,SAAA;;AAhBF;;EAoBE,WAAA;EARqB;;;EAYrB,cAAA;EAZA;;;EAgBA,WAAA;EAJA;;;EAQA,MAAA;EAIM;;AAGR;EAHE,MAAA;AAAA;AAAA,KAGU,MAAA,IAAU,IAAA,EAAM,OAAA,KAAY,IAAA;AAAA,KAE5B,WAAA,GAAc,IAAA,CACxB,OAAA,CAAQ,OAAA;EAGR,IAAA,GAAO,IAAA;EACP,OAAA;EACA,QAAA,GAAW,kBAAA,GAAqB,sBAAA;EAChC,MAAA,GAAS,eAAA;AAAA;AAAA,KAGC,SAAA,GACR,QAAA,GACA,WAAA,CAAY,OAAA;AAAA,KAEJ,KAAA,IAAS,IAAA,EAAM,SAAA,KAAc,IAAA;AAAA,KAE7B,oBAAA,kBAAsC,WAAA,GAAc,WAAA,KAC9D,OAAA,EAAS,QAAA,KACN,MAAA;AAAA,KAEO,kBAAA,GACR,QAAA,GACA,YAAA,CACE,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA,KAId,sBAAA,GAAyB,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA"}

package/dist/types/log.d.mts

@@ -0,0 +1,90 @@
+import { BaseContext } from "./context.mjs";
+import { Mode, WorkspaceConfig } from "./config.mjs";
+import { PartialKeys, RequiredKeys } from "@stryke/types/base";
+
+//#region src/types/log.d.ts
+type LogLevel = "silent" | "error" | "warn" | "info" | "debug" | "trace";
+type LogCategory = "general" | "fs" | "performance" | "config" | "plugins" | "hooks" | "env" | "ipc" | "babel" | "network";
+declare const LogLevels: {
+  readonly SILENT: "silent";
+  readonly ERROR: "error";
+  readonly WARN: "warn";
+  readonly INFO: "info";
+  readonly DEBUG: "debug";
+  readonly TRACE: "trace";
+};
+declare const LogCategories: {
+  readonly GENERAL: "general";
+  readonly FS: "fs";
+  readonly PERFORMANCE: "performance";
+  readonly CONFIG: "config";
+  readonly PLUGINS: "plugins";
+  readonly HOOKS: "hooks";
+  readonly ENV: "env";
+  readonly IPC: "ipc";
+  readonly BABEL: "babel";
+  readonly NETWORK: "network";
+};
+interface LogMeta {
+  /**
+   * A unique identifier for the log message, which can be used to correlate related log entries across different parts of the system or different executions.
+   */
+  logId: string;
+  /**
+   * The log level label indicating the severity of the log message.
+   */
+  level: LogLevel;
+  /**
+   * The category of the log message, which can be used to classify and filter log entries based on their purpose or origin.
+   */
+  category: LogCategory;
+  /**
+   * The timestamp when the IPC message was created, represented as the number of milliseconds since the Unix epoch.
+   */
+  timestamp: number;
+  /**
+   * A unique identifier for the current execution instance, which can be used for logging and other purposes to distinguish between different executions in the same process.
+   */
+  executionId?: string;
+  /**
+   * The zero-based index of the current execution within the sequence of executions in the same process.
+   */
+  executionIndex?: number;
+  /**
+   * Optional environment identifier to specify the context or environment in which the message is being processed.
+   */
+  environment?: string;
+  /**
+   * Optional plugin name to specify the source plugin of the log message.
+   */
+  plugin?: string;
+  /**
+   * The name of the logger or source of the log message, which can be used to identify the origin of the log entry.
+   */
+  source?: string;
+}
+type Logger = (meta: LogMeta, ...args: string[]) => void;
+type LogFnConfig = Omit<Partial<LogMeta>, "logId" | "level" | "timestamp"> & {
+  mode?: Mode;
+  command?: string;
+  logLevel?: LogLevelUserConfig | LogLevelResolvedConfig;
+  colors?: WorkspaceConfig["colors"];
+};
+type LogFnMeta = LogLevel | PartialKeys<LogMeta, "logId" | "category" | "timestamp">;
+type LogFn = (meta: LogFnMeta, ...args: string[]) => void;
+type CreateLoggerFunction<TContext extends BaseContext = BaseContext> = (context: TContext) => Logger;
+type LogLevelUserConfig = LogLevel | RequiredKeys<Record<LogCategory, LogLevel | boolean | undefined>, "general">;
+type LogLevelResolvedConfig = Record<LogCategory, LogLevel>;
+declare type __ΩLogLevel = any[];
+declare type __ΩLogCategory = any[];
+declare type __ΩLogMeta = any[];
+declare type __ΩLogger = any[];
+declare type __ΩLogFnConfig = any[];
+declare type __ΩLogFnMeta = any[];
+declare type __ΩLogFn = any[];
+declare type __ΩCreateLoggerFunction = any[];
+declare type __ΩLogLevelUserConfig = any[];
+declare type __ΩLogLevelResolvedConfig = any[];
+//#endregion
+export { CreateLoggerFunction, LogCategories, LogCategory, LogFn, LogFnConfig, LogFnMeta, LogLevel, LogLevelResolvedConfig, LogLevelUserConfig, LogLevels, LogMeta, Logger, __ΩCreateLoggerFunction, __ΩLogCategory, __ΩLogFn, __ΩLogFnConfig, __ΩLogFnMeta, __ΩLogLevel, __ΩLogLevelResolvedConfig, __ΩLogLevelUserConfig, __ΩLogMeta, __ΩLogger };
+//# sourceMappingURL=log.d.mts.map

package/dist/types/log.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.mts","names":[],"sources":["../../src/types/log.ts"],"mappings":";;;;;KAsBY,QAAA;AAAA,KAEA,WAAA;AAAA,cAYC,SAAA;EAAA;;;;;;;cASA,aAAA;EAAA;;;;;;;;;;;UAaI,OAAA;;AAbjB;;EAiBE,KAAA;EANQ;;;EAUR,KAAA,EAAO,QAAA;;;;EAIP,QAAA,EAAU,WAAA;;;;EAIV,SAAA;;AAhBF;;EAoBE,WAAA;EARqB;;;EAYrB,cAAA;EAZA;;;EAgBA,WAAA;EAJA;;;EAQA,MAAA;EAIM;;AAGR;EAHE,MAAA;AAAA;AAAA,KAGU,MAAA,IAAU,IAAA,EAAM,OAAA,KAAY,IAAA;AAAA,KAE5B,WAAA,GAAc,IAAA,CACxB,OAAA,CAAQ,OAAA;EAGR,IAAA,GAAO,IAAA;EACP,OAAA;EACA,QAAA,GAAW,kBAAA,GAAqB,sBAAA;EAChC,MAAA,GAAS,eAAA;AAAA;AAAA,KAGC,SAAA,GACR,QAAA,GACA,WAAA,CAAY,OAAA;AAAA,KAEJ,KAAA,IAAS,IAAA,EAAM,SAAA,KAAc,IAAA;AAAA,KAE7B,oBAAA,kBAAsC,WAAA,GAAc,WAAA,KAC9D,OAAA,EAAS,QAAA,KACN,MAAA;AAAA,KAEO,kBAAA,GACR,QAAA,GACA,YAAA,CACE,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA,KAId,sBAAA,GAAyB,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA"}

package/dist/types/log.mjs

@@ -0,0 +1,25 @@
+//#region src/types/log.ts
+const LogLevels = {
+	SILENT: "silent",
+	ERROR: "error",
+	WARN: "warn",
+	INFO: "info",
+	DEBUG: "debug",
+	TRACE: "trace"
+};
+const LogCategories = {
+	GENERAL: "general",
+	FS: "fs",
+	PERFORMANCE: "performance",
+	CONFIG: "config",
+	PLUGINS: "plugins",
+	HOOKS: "hooks",
+	ENV: "env",
+	IPC: "ipc",
+	BABEL: "babel",
+	NETWORK: "network"
+};
+
+//#endregion
+export { LogCategories, LogLevels };
+//# sourceMappingURL=log.mjs.map

package/dist/types/log.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.mjs","names":[],"sources":["../../src/types/log.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { PartialKeys, RequiredKeys } from \"@stryke/types/base\";\nimport { Mode, WorkspaceConfig } from \"./config\";\nimport { BaseContext } from \"./context\";\n\nexport type LogLevel = \"silent\" | \"error\" | \"warn\" | \"info\" | \"debug\" | \"trace\";\n\nexport type LogCategory =\n  | \"general\"\n  | \"fs\"\n  | \"performance\"\n  | \"config\"\n  | \"plugins\"\n  | \"hooks\"\n  | \"env\"\n  | \"ipc\"\n  | \"babel\"\n  | \"network\";\n\nexport const LogLevels = {\n  SILENT: \"silent\",\n  ERROR: \"error\",\n  WARN: \"warn\",\n  INFO: \"info\",\n  DEBUG: \"debug\",\n  TRACE: \"trace\"\n} as const;\n\nexport const LogCategories = {\n  GENERAL: \"general\",\n  FS: \"fs\",\n  PERFORMANCE: \"performance\",\n  CONFIG: \"config\",\n  PLUGINS: \"plugins\",\n  HOOKS: \"hooks\",\n  ENV: \"env\",\n  IPC: \"ipc\",\n  BABEL: \"babel\",\n  NETWORK: \"network\"\n} as const;\n\nexport interface LogMeta {\n  /**\n   * A unique identifier for the log message, which can be used to correlate related log entries across different parts of the system or different executions.\n   */\n  logId: string;\n  /**\n   * The log level label indicating the severity of the log message.\n   */\n  level: LogLevel;\n  /**\n   * The category of the log message, which can be used to classify and filter log entries based on their purpose or origin.\n   */\n  category: LogCategory;\n  /**\n   * The timestamp when the IPC message was created, represented as the number of milliseconds since the Unix epoch.\n   */\n  timestamp: number;\n  /**\n   * A unique identifier for the current execution instance, which can be used for logging and other purposes to distinguish between different executions in the same process.\n   */\n  executionId?: string;\n  /**\n   * The zero-based index of the current execution within the sequence of executions in the same process.\n   */\n  executionIndex?: number;\n  /**\n   * Optional environment identifier to specify the context or environment in which the message is being processed.\n   */\n  environment?: string;\n  /**\n   * Optional plugin name to specify the source plugin of the log message.\n   */\n  plugin?: string;\n  /**\n   * The name of the logger or source of the log message, which can be used to identify the origin of the log entry.\n   */\n  source?: string;\n}\n\nexport type Logger = (meta: LogMeta, ...args: string[]) => void;\n\nexport type LogFnConfig = Omit<\n  Partial<LogMeta>,\n  \"logId\" | \"level\" | \"timestamp\"\n> & {\n  mode?: Mode;\n  command?: string;\n  logLevel?: LogLevelUserConfig | LogLevelResolvedConfig;\n  colors?: WorkspaceConfig[\"colors\"];\n};\n\nexport type LogFnMeta =\n  | LogLevel\n  | PartialKeys<LogMeta, \"logId\" | \"category\" | \"timestamp\">;\n\nexport type LogFn = (meta: LogFnMeta, ...args: string[]) => void;\n\nexport type CreateLoggerFunction<TContext extends BaseContext = BaseContext> = (\n  context: TContext\n) => Logger;\n\nexport type LogLevelUserConfig =\n  | LogLevel\n  | RequiredKeys<\n      Record<LogCategory, LogLevel | boolean | undefined>,\n      \"general\"\n    >;\n\nexport type LogLevelResolvedConfig = Record<LogCategory, LogLevel>;\n"],"mappings":";AAoCA,MAAa,YAAY;CACvB,QAAQ;CACR,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP,OAAO;CACR;AAED,MAAa,gBAAgB;CAC3B,SAAS;CACT,IAAI;CACJ,aAAa;CACb,QAAQ;CACR,SAAS;CACT,OAAO;CACP,KAAK;CACL,KAAK;CACL,OAAO;CACP,SAAS;CACV"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/core",
-  "version": "0.43.30",
+  "version": "0.44.0",
   "private": false,
   "description": "An internal core package for Powerlines - please use the `powerlines` package for public usage.",
   "homepage": "https://stormsoftware.com",
@@ -569,5 +569,5 @@
     "typescript": "^6.0.3"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "36f3385b33024e00aafb6c4a10e7a2e3c896aad5"
+  "gitHead": "0c0e8330c47e0ba315ba3367a13a51a576fd9811"
 }