@crawlee/types 4.0.0-beta.40 → 4.0.0-beta.42

package/index.d.ts

@@ -3,4 +3,5 @@ export * from './utility-types.js';
 export * from './browser.js';
 export * from './http-client.js';
 export * from './session.js';
+export * from './logger.js';
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/index.js

@@ -3,4 +3,5 @@ export * from './utility-types.js';
 export * from './browser.js';
 export * from './http-client.js';
 export * from './session.js';
+export * from './logger.js';
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/logger.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Configuration options for Crawlee logger implementations.
+ */
+export interface CrawleeLoggerOptions {
+    /** Prefix to be prepended to each logged line. */
+    prefix?: string | null;
+}
+/**
+ * Interface for Crawlee logger implementations.
+ * This allows users to inject custom loggers (e.g., Winston, Pino) while maintaining
+ * compatibility with the default `@apify/log` implementation.
+ */
+export interface CrawleeLogger {
+    /**
+     * Returns the logger configuration.
+     */
+    getOptions(): CrawleeLoggerOptions;
+    /**
+     * Configures logger options.
+     */
+    setOptions(options: Partial<CrawleeLoggerOptions>): void;
+    /**
+     * Creates a new instance of logger that inherits settings from a parent logger.
+     */
+    child(options: Partial<CrawleeLoggerOptions>): CrawleeLogger;
+    /**
+     * Logs an `ERROR` message.
+     */
+    error(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Logs an `ERROR` level message with a nicely formatted exception.
+     */
+    exception(exception: Error, message: string, data?: Record<string, unknown>): void;
+    /**
+     * Logs a `SOFT_FAIL` level message.
+     */
+    softFail(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Logs a `WARNING` level message.
+     */
+    warning(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Logs a `WARNING` level message only once.
+     */
+    warningOnce(message: string): void;
+    /**
+     * Logs an `INFO` message.
+     */
+    info(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Logs a `DEBUG` message.
+     */
+    debug(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Logs a `PERF` level message for performance tracking.
+     */
+    perf(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Logs given message only once as WARNING for deprecated features.
+     */
+    deprecated(message: string): void;
+    /**
+     * Logs a message at the given level. Useful when the log level is determined dynamically.
+     */
+    logWithLevel(level: number, message: string, data?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC1B;;OAEG;IACH,UAAU,IAAI,oBAAoB,CAAC;IAEnC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC;IAEzD;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,aAAa,CAAC;IAE7D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE7D;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEnF;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEhE;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE/D;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE5D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE7D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE5D;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACtF"}

package/logger.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.js.map

package/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@crawlee/types",
-    "version": "4.0.0-beta.40",
+    "version": "4.0.0-beta.42",
     "description": "Shared types for the crawlee projects",
     "engines": {
         "node": ">=22.0.0"
@@ -53,5 +53,5 @@
             }
         }
     },
-    "gitHead": "679534db27d04c0acf4737700bb979c040845762"
+    "gitHead": "fe1827977c6ca78c509f2a7e1106c48b20c1cbf2"
 }