@kwirthmagnify/kwirth-common-back 0.5.52 → 0.5.53

package/dist/IExtension.d.ts

@@ -1,4 +1,22 @@
 import { IExtensionExportOptions, IExtensionImportResult } from '@kwirthmagnify/kwirth-common';
+/**
+ * What an extension writes its log with. The core builds it knowing who the extension is, so the
+ * line comes out identified — '[prov] [ERRO] [longhorn] ...' — and the extension only writes the
+ * message.
+ *
+ * It lives here, and not next to one family's contract, because the need is the same for all of
+ * them: before this, anything that was not a channel had only `console.log`, which comes out with no
+ * timestamp, no level and no component, and turns a failure into something that reads like a routine
+ * trace.
+ *
+ * Three levels and no more. An `info` nobody can filter out is what buries a log, and a failure that
+ * goes out as `info` is a failure nobody sees.
+ */
+export interface IExtensionLogger {
+    info(message: unknown): void;
+    warning(message: unknown): void;
+    error(message: unknown): void;
+}
 export interface IExtension {
     exportConfig?(options: IExtensionExportOptions): Promise<unknown>;
     importConfig?(config: unknown): Promise<IExtensionImportResult>;

package/dist/IProvider.d.ts

@@ -1,5 +1,5 @@
 import { KwirthData, IConfigFieldDef } from '@kwirthmagnify/kwirth-common';
-import { IExtension } from './IExtension';
+import { IExtension, IExtensionLogger } from './IExtension';
 /**
  * Minimal interface representing the channel side that providers interact with.
  * Providers only need to call processProviderEvent on their subscribers.
@@ -119,17 +119,11 @@ export interface IProviderStats {
     errors?: number;
 }
 /**
- * What a provider writes its log with. The core builds it and hands it over with 'setLogger', so the
- * id is already in place and the provider only writes the message.
- *
- * Three levels and no more: an 'info' that nobody can filter out is what buries a log, and a failure
- * that goes out as 'info' is a failure nobody sees.
+ * What a provider writes its log with. It is the common extension logger — the need turned out to be
+ * the same for senders, so it lives in IExtension. Kept as a name of its own because it is already
+ * published and providers compile against it.
  */
-export interface IProviderLogger {
-    info(message: unknown): void;
-    warning(message: unknown): void;
-    error(message: unknown): void;
-}
+export type IProviderLogger = IExtensionLogger;
 /**
  * Interface that all provider plugins must implement.
  * Use 'any' for clusterInfo to avoid pulling in kubernetes/docker dependencies.

package/dist/ISender.d.ts

@@ -1,5 +1,5 @@
 import { ISenderMessage, ISenderConfig, ISenderAccess, ISenderStoredConfig, ISenderResult, TConfigFieldType, IConfigFieldDef, IExtensionNodeMeta } from '@kwirthmagnify/kwirth-common';
-import { IExtension } from './IExtension';
+import { IExtension, IExtensionLogger } from './IExtension';
 export { ISenderMessage, ISenderConfig, ISenderAccess, ISenderStoredConfig, ISenderResult };
 /** @deprecated usa TConfigFieldType, comun a todas las extensiones. */
 export type SenderFieldType = TConfigFieldType;
@@ -17,6 +17,18 @@ export interface ISender extends IExtension {
     getConfigSchema?(): ISenderFieldDef[];
     getNodeMeta?(): ISenderNodeMeta;
     send(configName: string, message: ISenderMessage): Promise<ISenderResult | void>;
+    /**
+     * The core hands the sender a logger that already knows who it is, as soon as it builds it.
+     *
+     * OPTIONAL and read defensively, like the rest: a sender that does not implement it keeps writing
+     * wherever it was writing, and an older core that never calls it leaves the sender on its own
+     * fallback.
+     *
+     * ⚠️ This is for what the sender says ABOUT ITSELF — a delivery that failed, a configuration it
+     * could not read. It is not the place for what it delivers: a sender's job is to put a message
+     * somewhere, and that somewhere is decided by its configuration, not by this.
+     */
+    setLogger?(logger: IExtensionLogger): void;
     sendBatch?(configName: string, messages: ISenderMessage[]): Promise<ISenderResult | void>;
     fetchStatus?(configName: string, externalId: string): Promise<string | undefined>;
     evalFilter?(configName: string, message: ISenderMessage, forward: () => Promise<void>): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kwirthmagnify/kwirth-common-back",
-  "version": "0.5.52",
+  "version": "0.5.53",
   "description": "Backend interfaces for building Kwirth provider and channel plugins",
   "scripts": {
     "build": "tsc",