@motiadev/core 0.14.0-beta.164 → 0.14.0-beta.165-707935

package/dist/src/observability/stream-tracer.mjs

@@ -0,0 +1,98 @@
+import { createTrace } from "./create-trace.mjs";
+
+//#region src/observability/stream-tracer.ts
+var StreamTracer = class StreamTracer {
+	constructor(manager, traceGroup, trace, logger) {
+		this.manager = manager;
+		this.traceGroup = traceGroup;
+		this.trace = trace;
+		logger.addListener(async (level, msg, args) => {
+			await this.addEvent({
+				type: "log",
+				timestamp: Date.now(),
+				level,
+				message: msg,
+				metadata: args
+			});
+		});
+	}
+	async end(err) {
+		if (this.trace.endTime) return;
+		this.trace.status = err ? "failed" : "completed";
+		this.trace.endTime = Date.now();
+		this.trace.error = err;
+		await this.manager.updateTrace();
+		await this.recomputeTraceGroupStatus();
+		await this.manager.updateTraceGroup();
+	}
+	async recomputeTraceGroupStatus() {
+		const allTracesFromStorage = await this.manager.getAllTracesForGroup();
+		const currentTraceIndex = allTracesFromStorage.findIndex((t) => t.id === this.trace.id);
+		const allTraces = [...allTracesFromStorage];
+		if (currentTraceIndex >= 0) allTraces[currentTraceIndex] = this.trace;
+		else allTraces.push(this.trace);
+		const completedCount = allTraces.filter((t) => t.status === "completed").length;
+		const failedCount = allTraces.filter((t) => t.status === "failed").length;
+		const runningCount = allTraces.filter((t) => t.status === "running").length;
+		this.traceGroup.metadata.completedSteps = completedCount;
+		this.traceGroup.metadata.activeSteps = runningCount;
+		if (failedCount > 0) this.traceGroup.status = "failed";
+		else if (runningCount === 0 && completedCount > 0) {
+			this.traceGroup.status = "completed";
+			if (!this.traceGroup.endTime) this.traceGroup.endTime = Date.now();
+		} else this.traceGroup.status = "running";
+	}
+	async stateOperation(operation, input) {
+		await this.addEvent({
+			type: "state",
+			timestamp: Date.now(),
+			operation,
+			data: input
+		});
+	}
+	async emitOperation(topic, data, success) {
+		await this.addEvent({
+			type: "emit",
+			timestamp: Date.now(),
+			topic,
+			success,
+			data
+		});
+	}
+	async streamOperation(streamName, operation, input) {
+		if (operation === "set") {
+			const lastEvent = this.trace.events[this.trace.events.length - 1];
+			if (lastEvent && lastEvent.type === "stream" && lastEvent.streamName === streamName && lastEvent.data.groupId === input.groupId && lastEvent.data.id === input.id) {
+				lastEvent.calls++;
+				lastEvent.data.data = input.data;
+				lastEvent.maxTimestamp = Date.now();
+				this.traceGroup.lastActivity = lastEvent.maxTimestamp;
+				await this.manager.updateTrace();
+				await this.manager.updateTraceGroup();
+				return;
+			}
+		}
+		await this.addEvent({
+			type: "stream",
+			timestamp: Date.now(),
+			operation,
+			data: input,
+			streamName,
+			calls: 1
+		});
+	}
+	child(step, logger) {
+		const trace = createTrace(this.traceGroup, step);
+		return new StreamTracer(this.manager.child(trace), this.traceGroup, trace, logger);
+	}
+	async addEvent(event) {
+		this.trace.events.push(event);
+		this.traceGroup.lastActivity = event.timestamp;
+		await this.manager.updateTrace();
+		await this.manager.updateTraceGroup();
+	}
+};
+
+//#endregion
+export { StreamTracer };
+//# sourceMappingURL=stream-tracer.mjs.map

package/dist/src/observability/stream-tracer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-tracer.mjs","names":["manager: TraceManager","traceGroup: TraceGroup","trace: Trace"],"sources":["../../../src/observability/stream-tracer.ts"],"sourcesContent":["import type { Logger } from '../logger'\nimport type { Step } from '../types'\nimport { createTrace } from './create-trace'\nimport type { Tracer } from './index'\nimport type { TraceManager } from './trace-manager'\nimport type { StateOperation, StreamOperation, Trace, TraceError, TraceEvent, TraceGroup } from './types'\n\nexport class StreamTracer implements Tracer {\n  constructor(\n    private readonly manager: TraceManager,\n    private readonly traceGroup: TraceGroup,\n    private readonly trace: Trace,\n    logger: Logger,\n  ) {\n    logger.addListener(async (level, msg, args) => {\n      await this.addEvent({\n        type: 'log',\n        timestamp: Date.now(),\n        level,\n        message: msg,\n        metadata: args,\n      })\n    })\n  }\n\n  async end(err?: TraceError) {\n    if (this.trace.endTime) {\n      return\n    }\n\n    this.trace.status = err ? 'failed' : 'completed'\n    this.trace.endTime = Date.now()\n    this.trace.error = err\n\n    await this.manager.updateTrace()\n    await this.recomputeTraceGroupStatus()\n    await this.manager.updateTraceGroup()\n  }\n\n  private async recomputeTraceGroupStatus() {\n    const allTracesFromStorage = await this.manager.getAllTracesForGroup()\n\n    const currentTraceIndex = allTracesFromStorage.findIndex((t) => t.id === this.trace.id)\n    const allTraces = [...allTracesFromStorage]\n\n    if (currentTraceIndex >= 0) {\n      allTraces[currentTraceIndex] = this.trace\n    } else {\n      allTraces.push(this.trace)\n    }\n\n    const completedCount = allTraces.filter((t) => t.status === 'completed').length\n    const failedCount = allTraces.filter((t) => t.status === 'failed').length\n    const runningCount = allTraces.filter((t) => t.status === 'running').length\n\n    this.traceGroup.metadata.completedSteps = completedCount\n    this.traceGroup.metadata.activeSteps = runningCount\n\n    if (failedCount > 0) {\n      this.traceGroup.status = 'failed'\n    } else if (runningCount === 0 && completedCount > 0) {\n      this.traceGroup.status = 'completed'\n      if (!this.traceGroup.endTime) {\n        this.traceGroup.endTime = Date.now()\n      }\n    } else {\n      this.traceGroup.status = 'running'\n    }\n  }\n\n  async stateOperation(operation: StateOperation, input: unknown) {\n    await this.addEvent({\n      type: 'state',\n      timestamp: Date.now(),\n      operation,\n      data: input,\n    })\n  }\n\n  async emitOperation(topic: string, data: unknown, success: boolean) {\n    await this.addEvent({\n      type: 'emit',\n      timestamp: Date.now(),\n      topic,\n      success,\n      data,\n    })\n  }\n\n  async streamOperation(\n    streamName: string,\n    operation: StreamOperation,\n    input: { groupId: string; id: string; data?: unknown },\n  ) {\n    if (operation === 'set') {\n      const lastEvent = this.trace.events[this.trace.events.length - 1]\n\n      if (\n        lastEvent &&\n        lastEvent.type === 'stream' &&\n        lastEvent.streamName === streamName &&\n        lastEvent.data.groupId === input.groupId &&\n        lastEvent.data.id === input.id\n      ) {\n        lastEvent.calls++\n        lastEvent.data.data = input.data\n        lastEvent.maxTimestamp = Date.now()\n\n        this.traceGroup.lastActivity = lastEvent.maxTimestamp\n        await this.manager.updateTrace()\n        await this.manager.updateTraceGroup()\n\n        return\n      }\n    }\n\n    await this.addEvent({\n      type: 'stream',\n      timestamp: Date.now(),\n      operation,\n      data: input,\n      streamName,\n      calls: 1,\n    })\n  }\n\n  child(step: Step, logger: Logger) {\n    const trace = createTrace(this.traceGroup, step)\n    const manager = this.manager.child(trace)\n\n    return new StreamTracer(manager, this.traceGroup, trace, logger)\n  }\n\n  private async addEvent(event: TraceEvent) {\n    this.trace.events.push(event)\n    this.traceGroup.lastActivity = event.timestamp\n\n    await this.manager.updateTrace()\n    await this.manager.updateTraceGroup()\n  }\n}\n"],"mappings":";;;AAOA,IAAa,eAAb,MAAa,aAA+B;CAC1C,YACE,AAAiBA,SACjB,AAAiBC,YACjB,AAAiBC,OACjB,QACA;EAJiB;EACA;EACA;AAGjB,SAAO,YAAY,OAAO,OAAO,KAAK,SAAS;AAC7C,SAAM,KAAK,SAAS;IAClB,MAAM;IACN,WAAW,KAAK,KAAK;IACrB;IACA,SAAS;IACT,UAAU;IACX,CAAC;IACF;;CAGJ,MAAM,IAAI,KAAkB;AAC1B,MAAI,KAAK,MAAM,QACb;AAGF,OAAK,MAAM,SAAS,MAAM,WAAW;AACrC,OAAK,MAAM,UAAU,KAAK,KAAK;AAC/B,OAAK,MAAM,QAAQ;AAEnB,QAAM,KAAK,QAAQ,aAAa;AAChC,QAAM,KAAK,2BAA2B;AACtC,QAAM,KAAK,QAAQ,kBAAkB;;CAGvC,MAAc,4BAA4B;EACxC,MAAM,uBAAuB,MAAM,KAAK,QAAQ,sBAAsB;EAEtE,MAAM,oBAAoB,qBAAqB,WAAW,MAAM,EAAE,OAAO,KAAK,MAAM,GAAG;EACvF,MAAM,YAAY,CAAC,GAAG,qBAAqB;AAE3C,MAAI,qBAAqB,EACvB,WAAU,qBAAqB,KAAK;MAEpC,WAAU,KAAK,KAAK,MAAM;EAG5B,MAAM,iBAAiB,UAAU,QAAQ,MAAM,EAAE,WAAW,YAAY,CAAC;EACzE,MAAM,cAAc,UAAU,QAAQ,MAAM,EAAE,WAAW,SAAS,CAAC;EACnE,MAAM,eAAe,UAAU,QAAQ,MAAM,EAAE,WAAW,UAAU,CAAC;AAErE,OAAK,WAAW,SAAS,iBAAiB;AAC1C,OAAK,WAAW,SAAS,cAAc;AAEvC,MAAI,cAAc,EAChB,MAAK,WAAW,SAAS;WAChB,iBAAiB,KAAK,iBAAiB,GAAG;AACnD,QAAK,WAAW,SAAS;AACzB,OAAI,CAAC,KAAK,WAAW,QACnB,MAAK,WAAW,UAAU,KAAK,KAAK;QAGtC,MAAK,WAAW,SAAS;;CAI7B,MAAM,eAAe,WAA2B,OAAgB;AAC9D,QAAM,KAAK,SAAS;GAClB,MAAM;GACN,WAAW,KAAK,KAAK;GACrB;GACA,MAAM;GACP,CAAC;;CAGJ,MAAM,cAAc,OAAe,MAAe,SAAkB;AAClE,QAAM,KAAK,SAAS;GAClB,MAAM;GACN,WAAW,KAAK,KAAK;GACrB;GACA;GACA;GACD,CAAC;;CAGJ,MAAM,gBACJ,YACA,WACA,OACA;AACA,MAAI,cAAc,OAAO;GACvB,MAAM,YAAY,KAAK,MAAM,OAAO,KAAK,MAAM,OAAO,SAAS;AAE/D,OACE,aACA,UAAU,SAAS,YACnB,UAAU,eAAe,cACzB,UAAU,KAAK,YAAY,MAAM,WACjC,UAAU,KAAK,OAAO,MAAM,IAC5B;AACA,cAAU;AACV,cAAU,KAAK,OAAO,MAAM;AAC5B,cAAU,eAAe,KAAK,KAAK;AAEnC,SAAK,WAAW,eAAe,UAAU;AACzC,UAAM,KAAK,QAAQ,aAAa;AAChC,UAAM,KAAK,QAAQ,kBAAkB;AAErC;;;AAIJ,QAAM,KAAK,SAAS;GAClB,MAAM;GACN,WAAW,KAAK,KAAK;GACrB;GACA,MAAM;GACN;GACA,OAAO;GACR,CAAC;;CAGJ,MAAM,MAAY,QAAgB;EAChC,MAAM,QAAQ,YAAY,KAAK,YAAY,KAAK;AAGhD,SAAO,IAAI,aAFK,KAAK,QAAQ,MAAM,MAAM,EAER,KAAK,YAAY,OAAO,OAAO;;CAGlE,MAAc,SAAS,OAAmB;AACxC,OAAK,MAAM,OAAO,KAAK,MAAM;AAC7B,OAAK,WAAW,eAAe,MAAM;AAErC,QAAM,KAAK,QAAQ,aAAa;AAChC,QAAM,KAAK,QAAQ,kBAAkB"}

package/dist/src/observability/trace-manager.mjs

@@ -0,0 +1,27 @@
+//#region src/observability/trace-manager.ts
+var TraceManager = class TraceManager {
+	constructor(traceStream, traceGroupStream, traceGroup, trace) {
+		this.traceStream = traceStream;
+		this.traceGroupStream = traceGroupStream;
+		this.traceGroup = traceGroup;
+		this.trace = trace;
+		this.updateTrace().catch(() => {});
+		this.updateTraceGroup().catch(() => {});
+	}
+	async updateTrace() {
+		await this.traceStream.set(this.traceGroup.id, this.trace.id, this.trace);
+	}
+	async updateTraceGroup() {
+		await this.traceGroupStream.set("default", this.traceGroup.id, this.traceGroup);
+	}
+	async getAllTracesForGroup() {
+		return await this.traceStream.getGroup(this.traceGroup.id);
+	}
+	child(trace) {
+		return new TraceManager(this.traceStream, this.traceGroupStream, this.traceGroup, trace);
+	}
+};
+
+//#endregion
+export { TraceManager };
+//# sourceMappingURL=trace-manager.mjs.map

package/dist/src/observability/trace-manager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-manager.mjs","names":["traceStream: MotiaStream<Trace>","traceGroupStream: MotiaStream<TraceGroup>","traceGroup: TraceGroup","trace: Trace"],"sources":["../../../src/observability/trace-manager.ts"],"sourcesContent":["import type { MotiaStream } from '../types-stream'\nimport type { Trace, TraceGroup } from './types'\n\nexport class TraceManager {\n  constructor(\n    private readonly traceStream: MotiaStream<Trace>,\n    private readonly traceGroupStream: MotiaStream<TraceGroup>,\n    private readonly traceGroup: TraceGroup,\n    private readonly trace: Trace,\n  ) {\n    this.updateTrace().catch(() => {})\n    this.updateTraceGroup().catch(() => {})\n  }\n\n  async updateTrace() {\n    await this.traceStream.set(this.traceGroup.id, this.trace.id, this.trace)\n  }\n\n  async updateTraceGroup() {\n    await this.traceGroupStream.set('default', this.traceGroup.id, this.traceGroup)\n  }\n\n  async getAllTracesForGroup(): Promise<Trace[]> {\n    return await this.traceStream.getGroup(this.traceGroup.id)\n  }\n\n  child(trace: Trace) {\n    return new TraceManager(this.traceStream, this.traceGroupStream, this.traceGroup, trace)\n  }\n}\n"],"mappings":";AAGA,IAAa,eAAb,MAAa,aAAa;CACxB,YACE,AAAiBA,aACjB,AAAiBC,kBACjB,AAAiBC,YACjB,AAAiBC,OACjB;EAJiB;EACA;EACA;EACA;AAEjB,OAAK,aAAa,CAAC,YAAY,GAAG;AAClC,OAAK,kBAAkB,CAAC,YAAY,GAAG;;CAGzC,MAAM,cAAc;AAClB,QAAM,KAAK,YAAY,IAAI,KAAK,WAAW,IAAI,KAAK,MAAM,IAAI,KAAK,MAAM;;CAG3E,MAAM,mBAAmB;AACvB,QAAM,KAAK,iBAAiB,IAAI,WAAW,KAAK,WAAW,IAAI,KAAK,WAAW;;CAGjF,MAAM,uBAAyC;AAC7C,SAAO,MAAM,KAAK,YAAY,SAAS,KAAK,WAAW,GAAG;;CAG5D,MAAM,OAAc;AAClB,SAAO,IAAI,aAAa,KAAK,aAAa,KAAK,kBAAkB,KAAK,YAAY,MAAM"}

package/dist/src/observability/tracer.mjs

@@ -0,0 +1,88 @@
+import { createTrace } from "./create-trace.mjs";
+import { RedisTraceStreamAdapter } from "./redis-trace-stream-adapter.mjs";
+import { StreamTracer } from "./stream-tracer.mjs";
+import { TraceManager } from "./trace-manager.mjs";
+
+//#region src/observability/tracer.ts
+const MAX_TRACE_GROUPS = process.env.MOTIA_MAX_TRACE_GROUPS ? Number.parseInt(process.env.MOTIA_MAX_TRACE_GROUPS, 10) : 50;
+var BaseTracerFactory = class {
+	constructor(traceStream, traceGroupStream) {
+		this.traceStream = traceStream;
+		this.traceGroupStream = traceGroupStream;
+	}
+	async getAllGroups() {
+		return await this.traceGroupStream.getGroup("default");
+	}
+	async deleteGroup(group) {
+		const traces = await this.traceStream.getGroup(group.id);
+		for (const trace of traces) await this.traceStream.delete(group.id, trace.id);
+		await this.traceGroupStream.delete("default", group.id);
+	}
+	async clear() {
+		const groups = await this.getAllGroups();
+		for (const group of groups) await this.deleteGroup(group);
+	}
+	async createTracer(traceId, step, logger) {
+		const traceGroup = {
+			id: traceId,
+			name: step.config.name,
+			lastActivity: Date.now(),
+			metadata: {
+				completedSteps: 0,
+				activeSteps: 0,
+				totalSteps: 0
+			},
+			correlationId: void 0,
+			status: "running",
+			startTime: Date.now()
+		};
+		const groups = await this.getAllGroups();
+		if (groups.length >= MAX_TRACE_GROUPS) {
+			const groupsToDelete = groups.sort((a, b) => a.startTime - b.startTime).slice(0, groups.length - MAX_TRACE_GROUPS + 1);
+			for (const group of groupsToDelete) await this.deleteGroup(group);
+		}
+		const trace = createTrace(traceGroup, step);
+		return new StreamTracer(new TraceManager(this.traceStream, this.traceGroupStream, traceGroup, trace), traceGroup, trace, logger);
+	}
+	async attachToTrace(traceId, step, logger) {
+		const existingGroup = await this.traceGroupStream.get("default", traceId);
+		if (!existingGroup) return this.createTracer(traceId, step, logger);
+		const trace = createTrace(existingGroup, step);
+		return new StreamTracer(new TraceManager(this.traceStream, this.traceGroupStream, existingGroup, trace), existingGroup, trace, logger);
+	}
+};
+const createTracerFactory = (lockedData) => {
+	if (!lockedData.redisClient) throw new Error("Redis client is required for tracer factory. Please provide a redisClient when creating LockedData.");
+	const traceStreamName = "motia-trace";
+	const traceStreamAdapter = new RedisTraceStreamAdapter(traceStreamName, lockedData.redisClient);
+	const traceStream = lockedData.createStream({
+		filePath: traceStreamName,
+		hidden: true,
+		config: {
+			name: traceStreamName,
+			baseConfig: {
+				storageType: "custom",
+				factory: () => traceStreamAdapter
+			},
+			schema: null
+		}
+	})();
+	const traceGroupName = "motia-trace-group";
+	const traceGroupStreamAdapter = new RedisTraceStreamAdapter(traceGroupName, lockedData.redisClient);
+	return new BaseTracerFactory(traceStream, lockedData.createStream({
+		filePath: traceGroupName,
+		hidden: true,
+		config: {
+			name: traceGroupName,
+			baseConfig: {
+				storageType: "custom",
+				factory: () => traceGroupStreamAdapter
+			},
+			schema: null
+		}
+	})());
+};
+
+//#endregion
+export { createTracerFactory };
+//# sourceMappingURL=tracer.mjs.map

package/dist/src/observability/tracer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.mjs","names":["traceStream: MotiaStream<Trace>","traceGroupStream: MotiaStream<TraceGroup>","traceGroup: TraceGroup","traceStreamAdapter: MotiaStream<Trace>","traceGroupStreamAdapter: MotiaStream<TraceGroup>"],"sources":["../../../src/observability/tracer.ts"],"sourcesContent":["import { FileStreamAdapterManager } from '../adapters/defaults/stream/file-stream-adapter-manager'\nimport type { LockedData } from '../locked-data'\nimport type { Logger } from '../logger'\nimport type { Step } from '../types'\nimport type { MotiaStream } from '../types-stream'\nimport { createTrace } from './create-trace'\nimport type { TracerFactory } from './index'\nimport { RedisTraceStreamAdapter } from './redis-trace-stream-adapter'\nimport { StreamTracer } from './stream-tracer'\nimport { TraceManager } from './trace-manager'\nimport type { Trace, TraceGroup } from './types'\n\nconst MAX_TRACE_GROUPS = process.env.MOTIA_MAX_TRACE_GROUPS //\n  ? Number.parseInt(process.env.MOTIA_MAX_TRACE_GROUPS, 10)\n  : 50\n\nexport class BaseTracerFactory implements TracerFactory {\n  constructor(\n    private readonly traceStream: MotiaStream<Trace>,\n    private readonly traceGroupStream: MotiaStream<TraceGroup>,\n  ) {}\n\n  private async getAllGroups() {\n    return await this.traceGroupStream.getGroup('default')\n  }\n\n  private async deleteGroup(group: TraceGroup) {\n    const traces = await this.traceStream.getGroup(group.id)\n\n    for (const trace of traces) {\n      await this.traceStream.delete(group.id, trace.id)\n    }\n    await this.traceGroupStream.delete('default', group.id)\n  }\n\n  async clear() {\n    const groups = await this.getAllGroups()\n\n    for (const group of groups) {\n      await this.deleteGroup(group)\n    }\n  }\n\n  async createTracer(traceId: string, step: Step, logger: Logger) {\n    const traceGroup: TraceGroup = {\n      id: traceId,\n      name: step.config.name,\n      lastActivity: Date.now(),\n      metadata: {\n        completedSteps: 0,\n        activeSteps: 0,\n        totalSteps: 0,\n      },\n      correlationId: undefined,\n      status: 'running',\n      startTime: Date.now(),\n    }\n\n    const groups = await this.getAllGroups()\n\n    if (groups.length >= MAX_TRACE_GROUPS) {\n      const groupsToDelete = groups\n        .sort((a, b) => a.startTime - b.startTime) // date ascending\n        .slice(0, groups.length - MAX_TRACE_GROUPS + 1)\n\n      for (const group of groupsToDelete) {\n        await this.deleteGroup(group)\n      }\n    }\n\n    const trace = createTrace(traceGroup, step)\n    const manager = new TraceManager(this.traceStream, this.traceGroupStream, traceGroup, trace)\n\n    return new StreamTracer(manager, traceGroup, trace, logger)\n  }\n\n  async attachToTrace(traceId: string, step: Step, logger: Logger) {\n    const existingGroup = await this.traceGroupStream.get('default', traceId)\n\n    if (!existingGroup) {\n      return this.createTracer(traceId, step, logger)\n    }\n\n    const trace = createTrace(existingGroup, step)\n    const manager = new TraceManager(this.traceStream, this.traceGroupStream, existingGroup, trace)\n\n    return new StreamTracer(manager, existingGroup, trace, logger)\n  }\n}\n\nexport const createTracerFactory = (lockedData: LockedData): TracerFactory => {\n  if (!lockedData.redisClient) {\n    throw new Error(\n      'Redis client is required for tracer factory. Please provide a redisClient when creating LockedData.',\n    )\n  }\n\n  const traceStreamName = 'motia-trace'\n  const traceStreamAdapter: MotiaStream<Trace> = new RedisTraceStreamAdapter(traceStreamName, lockedData.redisClient)\n\n  const traceStream = lockedData.createStream<Trace>({\n    filePath: traceStreamName,\n    hidden: true,\n    config: {\n      name: traceStreamName,\n      baseConfig: { storageType: 'custom', factory: () => traceStreamAdapter },\n      schema: null as never,\n    },\n  })()\n\n  const traceGroupName = 'motia-trace-group'\n  const traceGroupStreamAdapter: MotiaStream<TraceGroup> = new RedisTraceStreamAdapter(\n    traceGroupName,\n    lockedData.redisClient,\n  )\n\n  const traceGroupStream = lockedData.createStream<TraceGroup>({\n    filePath: traceGroupName,\n    hidden: true,\n    config: {\n      name: traceGroupName,\n      baseConfig: { storageType: 'custom', factory: () => traceGroupStreamAdapter },\n      schema: null as never,\n    },\n  })()\n\n  return new BaseTracerFactory(traceStream, traceGroupStream)\n}\n"],"mappings":";;;;;;AAYA,MAAM,mBAAmB,QAAQ,IAAI,yBACjC,OAAO,SAAS,QAAQ,IAAI,wBAAwB,GAAG,GACvD;AAEJ,IAAa,oBAAb,MAAwD;CACtD,YACE,AAAiBA,aACjB,AAAiBC,kBACjB;EAFiB;EACA;;CAGnB,MAAc,eAAe;AAC3B,SAAO,MAAM,KAAK,iBAAiB,SAAS,UAAU;;CAGxD,MAAc,YAAY,OAAmB;EAC3C,MAAM,SAAS,MAAM,KAAK,YAAY,SAAS,MAAM,GAAG;AAExD,OAAK,MAAM,SAAS,OAClB,OAAM,KAAK,YAAY,OAAO,MAAM,IAAI,MAAM,GAAG;AAEnD,QAAM,KAAK,iBAAiB,OAAO,WAAW,MAAM,GAAG;;CAGzD,MAAM,QAAQ;EACZ,MAAM,SAAS,MAAM,KAAK,cAAc;AAExC,OAAK,MAAM,SAAS,OAClB,OAAM,KAAK,YAAY,MAAM;;CAIjC,MAAM,aAAa,SAAiB,MAAY,QAAgB;EAC9D,MAAMC,aAAyB;GAC7B,IAAI;GACJ,MAAM,KAAK,OAAO;GAClB,cAAc,KAAK,KAAK;GACxB,UAAU;IACR,gBAAgB;IAChB,aAAa;IACb,YAAY;IACb;GACD,eAAe;GACf,QAAQ;GACR,WAAW,KAAK,KAAK;GACtB;EAED,MAAM,SAAS,MAAM,KAAK,cAAc;AAExC,MAAI,OAAO,UAAU,kBAAkB;GACrC,MAAM,iBAAiB,OACpB,MAAM,GAAG,MAAM,EAAE,YAAY,EAAE,UAAU,CACzC,MAAM,GAAG,OAAO,SAAS,mBAAmB,EAAE;AAEjD,QAAK,MAAM,SAAS,eAClB,OAAM,KAAK,YAAY,MAAM;;EAIjC,MAAM,QAAQ,YAAY,YAAY,KAAK;AAG3C,SAAO,IAAI,aAFK,IAAI,aAAa,KAAK,aAAa,KAAK,kBAAkB,YAAY,MAAM,EAE3D,YAAY,OAAO,OAAO;;CAG7D,MAAM,cAAc,SAAiB,MAAY,QAAgB;EAC/D,MAAM,gBAAgB,MAAM,KAAK,iBAAiB,IAAI,WAAW,QAAQ;AAEzE,MAAI,CAAC,cACH,QAAO,KAAK,aAAa,SAAS,MAAM,OAAO;EAGjD,MAAM,QAAQ,YAAY,eAAe,KAAK;AAG9C,SAAO,IAAI,aAFK,IAAI,aAAa,KAAK,aAAa,KAAK,kBAAkB,eAAe,MAAM,EAE9D,eAAe,OAAO,OAAO;;;AAIlE,MAAa,uBAAuB,eAA0C;AAC5E,KAAI,CAAC,WAAW,YACd,OAAM,IAAI,MACR,sGACD;CAGH,MAAM,kBAAkB;CACxB,MAAMC,qBAAyC,IAAI,wBAAwB,iBAAiB,WAAW,YAAY;CAEnH,MAAM,cAAc,WAAW,aAAoB;EACjD,UAAU;EACV,QAAQ;EACR,QAAQ;GACN,MAAM;GACN,YAAY;IAAE,aAAa;IAAU,eAAe;IAAoB;GACxE,QAAQ;GACT;EACF,CAAC,EAAE;CAEJ,MAAM,iBAAiB;CACvB,MAAMC,0BAAmD,IAAI,wBAC3D,gBACA,WAAW,YACZ;AAYD,QAAO,IAAI,kBAAkB,aAVJ,WAAW,aAAyB;EAC3D,UAAU;EACV,QAAQ;EACR,QAAQ;GACN,MAAM;GACN,YAAY;IAAE,aAAa;IAAU,eAAe;IAAyB;GAC7E,QAAQ;GACT;EACF,CAAC,EAAE,CAEuD"}

package/dist/src/observability/types.d.mts

@@ -0,0 +1,14 @@
+import "../types.mjs";
+
+//#region src/observability/types.d.ts
+
+type TraceError = {
+  message: string;
+  code?: string | number;
+  stack?: string;
+};
+type StateOperation = 'get' | 'getGroup' | 'set' | 'delete' | 'clear';
+type StreamOperation = 'get' | 'getGroup' | 'set' | 'delete' | 'clear' | 'send';
+//#endregion
+export { StateOperation, StreamOperation, TraceError };
+//# sourceMappingURL=types.d.mts.map

package/dist/src/observability/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/observability/types.ts"],"sourcesContent":[],"mappings":";;;;KAiBY,UAAA;;;;;KAqBA,cAAA;KACA,eAAA"}

package/dist/src/pretty-print.mjs

@@ -0,0 +1,50 @@
+import pc from "picocolors";
+
+//#region src/pretty-print.ts
+const stepTag = (step) => pc.bold(pc.cyan(step));
+const timestampTag = (timestamp) => pc.gray(timestamp);
+const traceIdTag = (traceId) => pc.gray(traceId);
+const levelTags = {
+	error: pc.red("[ERROR]"),
+	info: pc.blue("[INFO]"),
+	warn: pc.yellow("[WARN]"),
+	debug: pc.gray("[DEBUG]"),
+	trace: pc.gray("[TRACE]")
+};
+const numericTag = (value) => pc.green(value);
+const stringTag = (value) => pc.cyan(value);
+const booleanTag = (value) => pc.blue(value);
+const arrayBrackets = ["[", "]"].map((s) => pc.gray(s));
+const objectBrackets = ["{", "}"].map((s) => pc.gray(s));
+const prettyPrintObject = (obj, depth = 0, parentIsLast = false, prefix = "") => {
+	const tab = prefix + (depth === 0 ? "" : parentIsLast ? "│ " : "│ ");
+	if (depth > 2) return `${tab} └ ${pc.gray("[...]")}`;
+	const entries = Object.entries(obj);
+	return entries.map(([key, value], index) => {
+		const isLast = index === entries.length - 1;
+		const isObject = typeof value === "object" && value !== null;
+		const prefix$1 = isLast && !isObject ? "└" : "├";
+		if (isObject) {
+			const subObject = prettyPrintObject(value, depth + 1, isLast, tab);
+			const [start, end] = Array.isArray(value) ? arrayBrackets : objectBrackets;
+			return `${tab}${prefix$1} ${key}: ${start}\n${subObject}\n${tab}${isLast ? "└" : "│"} ${end}`;
+		}
+		let printedValue = value;
+		if (typeof value === "number") printedValue = numericTag(String(value));
+		else if (typeof value === "boolean") printedValue = booleanTag(String(value));
+		else if (typeof value === "string") printedValue = stringTag(value);
+		return `${tab}${prefix$1} ${key}: ${printedValue}`;
+	}).join("\n");
+};
+const prettyPrint = (json, excludeDetails = false) => {
+	const { time, traceId, msg, flows, level, step, ...details } = json;
+	const levelTag = levelTags[level];
+	const timestamp = timestampTag(`[${new Date(time).toLocaleTimeString()}]`);
+	const objectHasKeys = Object.keys(details).length > 0;
+	console.log(`${timestamp} ${traceIdTag(traceId)} ${levelTag} ${stepTag(step)} ${msg}`);
+	if (objectHasKeys && !excludeDetails) console.log(prettyPrintObject(details));
+};
+
+//#endregion
+export { prettyPrint };
+//# sourceMappingURL=pretty-print.mjs.map

package/dist/src/pretty-print.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pretty-print.mjs","names":["levelTags: Record<string, string>","prefix"],"sources":["../../src/pretty-print.ts"],"sourcesContent":["import pc from 'picocolors'\n\nconst stepTag = (step: string) => pc.bold(pc.cyan(step))\nconst timestampTag = (timestamp: string) => pc.gray(timestamp)\nconst traceIdTag = (traceId: string) => pc.gray(traceId)\n\nconst levelTags: Record<string, string> = {\n  error: pc.red('[ERROR]'),\n  info: pc.blue('[INFO]'),\n  warn: pc.yellow('[WARN]'),\n  debug: pc.gray('[DEBUG]'),\n  trace: pc.gray('[TRACE]'),\n}\n\nconst numericTag = (value: string) => pc.green(value)\nconst stringTag = (value: string) => pc.cyan(value)\nconst booleanTag = (value: string) => pc.blue(value)\n\nconst arrayBrackets = ['[', ']'].map((s) => pc.gray(s))\nconst objectBrackets = ['{', '}'].map((s) => pc.gray(s))\n\nconst prettyPrintObject = (obj: Record<string, any>, depth = 0, parentIsLast = false, prefix = ''): string => {\n  const tab = prefix + (depth === 0 ? '' : parentIsLast ? '│ ' : '│ ')\n\n  if (depth > 2) {\n    return `${tab} └ ${pc.gray('[...]')}`\n  }\n\n  const entries = Object.entries(obj)\n\n  return entries\n    .map(([key, value], index) => {\n      const isLast = index === entries.length - 1\n      const isObject = typeof value === 'object' && value !== null\n      const prefix = isLast && !isObject ? '└' : '├'\n\n      if (isObject) {\n        const subObject = prettyPrintObject(value, depth + 1, isLast, tab)\n        const [start, end] = Array.isArray(value) ? arrayBrackets : objectBrackets\n\n        return `${tab}${prefix} ${key}: ${start}\\n${subObject}\\n${tab}${isLast ? '└' : '│'} ${end}`\n      }\n\n      let printedValue = value\n\n      if (typeof value === 'number') {\n        printedValue = numericTag(String(value))\n      } else if (typeof value === 'boolean') {\n        printedValue = booleanTag(String(value))\n      } else if (typeof value === 'string') {\n        printedValue = stringTag(value)\n      }\n\n      return `${tab}${prefix} ${key}: ${printedValue}`\n    })\n    .join('\\n')\n}\n\nexport const prettyPrint = (json: Record<string, any>, excludeDetails = false): void => {\n  const { time, traceId, msg, flows, level, step, ...details } = json\n  const levelTag = levelTags[level]\n  const timestamp = timestampTag(`[${new Date(time).toLocaleTimeString()}]`)\n  const objectHasKeys = Object.keys(details).length > 0\n\n  console.log(`${timestamp} ${traceIdTag(traceId)} ${levelTag} ${stepTag(step)} ${msg}`)\n\n  if (objectHasKeys && !excludeDetails) {\n    console.log(prettyPrintObject(details))\n  }\n}\n"],"mappings":";;;AAEA,MAAM,WAAW,SAAiB,GAAG,KAAK,GAAG,KAAK,KAAK,CAAC;AACxD,MAAM,gBAAgB,cAAsB,GAAG,KAAK,UAAU;AAC9D,MAAM,cAAc,YAAoB,GAAG,KAAK,QAAQ;AAExD,MAAMA,YAAoC;CACxC,OAAO,GAAG,IAAI,UAAU;CACxB,MAAM,GAAG,KAAK,SAAS;CACvB,MAAM,GAAG,OAAO,SAAS;CACzB,OAAO,GAAG,KAAK,UAAU;CACzB,OAAO,GAAG,KAAK,UAAU;CAC1B;AAED,MAAM,cAAc,UAAkB,GAAG,MAAM,MAAM;AACrD,MAAM,aAAa,UAAkB,GAAG,KAAK,MAAM;AACnD,MAAM,cAAc,UAAkB,GAAG,KAAK,MAAM;AAEpD,MAAM,gBAAgB,CAAC,KAAK,IAAI,CAAC,KAAK,MAAM,GAAG,KAAK,EAAE,CAAC;AACvD,MAAM,iBAAiB,CAAC,KAAK,IAAI,CAAC,KAAK,MAAM,GAAG,KAAK,EAAE,CAAC;AAExD,MAAM,qBAAqB,KAA0B,QAAQ,GAAG,eAAe,OAAO,SAAS,OAAe;CAC5G,MAAM,MAAM,UAAU,UAAU,IAAI,KAAK,eAAe,OAAO;AAE/D,KAAI,QAAQ,EACV,QAAO,GAAG,IAAI,KAAK,GAAG,KAAK,QAAQ;CAGrC,MAAM,UAAU,OAAO,QAAQ,IAAI;AAEnC,QAAO,QACJ,KAAK,CAAC,KAAK,QAAQ,UAAU;EAC5B,MAAM,SAAS,UAAU,QAAQ,SAAS;EAC1C,MAAM,WAAW,OAAO,UAAU,YAAY,UAAU;EACxD,MAAMC,WAAS,UAAU,CAAC,WAAW,MAAM;AAE3C,MAAI,UAAU;GACZ,MAAM,YAAY,kBAAkB,OAAO,QAAQ,GAAG,QAAQ,IAAI;GAClE,MAAM,CAAC,OAAO,OAAO,MAAM,QAAQ,MAAM,GAAG,gBAAgB;AAE5D,UAAO,GAAG,MAAMA,SAAO,GAAG,IAAI,IAAI,MAAM,IAAI,UAAU,IAAI,MAAM,SAAS,MAAM,IAAI,GAAG;;EAGxF,IAAI,eAAe;AAEnB,MAAI,OAAO,UAAU,SACnB,gBAAe,WAAW,OAAO,MAAM,CAAC;WAC/B,OAAO,UAAU,UAC1B,gBAAe,WAAW,OAAO,MAAM,CAAC;WAC/B,OAAO,UAAU,SAC1B,gBAAe,UAAU,MAAM;AAGjC,SAAO,GAAG,MAAMA,SAAO,GAAG,IAAI,IAAI;GAClC,CACD,KAAK,KAAK;;AAGf,MAAa,eAAe,MAA2B,iBAAiB,UAAgB;CACtF,MAAM,EAAE,MAAM,SAAS,KAAK,OAAO,OAAO,MAAM,GAAG,YAAY;CAC/D,MAAM,WAAW,UAAU;CAC3B,MAAM,YAAY,aAAa,IAAI,IAAI,KAAK,KAAK,CAAC,oBAAoB,CAAC,GAAG;CAC1E,MAAM,gBAAgB,OAAO,KAAK,QAAQ,CAAC,SAAS;AAEpD,SAAQ,IAAI,GAAG,UAAU,GAAG,WAAW,QAAQ,CAAC,GAAG,SAAS,GAAG,QAAQ,KAAK,CAAC,GAAG,MAAM;AAEtF,KAAI,iBAAiB,CAAC,eACpB,SAAQ,IAAI,kBAAkB,QAAQ,CAAC"}

package/dist/src/printer.d.mts

@@ -0,0 +1,65 @@
+import { Stream } from "./types-stream.mjs";
+import { ValidationError } from "./step-validator.mjs";
+import { Step } from "./types.mjs";
+
+//#region src/printer.d.ts
+declare class Printer {
+  private readonly baseDir;
+  constructor(baseDir: string);
+  stepTag: string;
+  flowTag: string;
+  registered: string;
+  building: string;
+  built: string;
+  updated: string;
+  removed: string;
+  printEventInputValidationError(emit: {
+    topic: string;
+  }, details: {
+    missingFields?: string[];
+    extraFields?: string[];
+    typeMismatches?: string[];
+  }): void;
+  printInvalidEmit(step: Step, emit: string): void;
+  printStepCreated(step: Step): void;
+  printStepUpdated(step: Step): void;
+  printStepRemoved(step: Step): void;
+  printFlowCreated(flowName: string): void;
+  printFlowUpdated(flowName: string): void;
+  printFlowRemoved(flowName: string): void;
+  printStreamCreated(stream: Stream): void;
+  printStreamUpdated(stream: Stream): void;
+  printStreamRemoved(stream: Stream): void;
+  printInvalidEmitConfiguration(step: Step, emit: string): void;
+  printInvalidSchema(topic: string, step: Step[]): void;
+  printValidationError(stepPath: string, validationError: ValidationError): void;
+  getRelativePath(filePath: string): string;
+  getStepType(step: Step): string;
+  getStepPath(step: Step): string;
+  getStreamPath(stream: Stream): string;
+  printPluginLog(message: string): void;
+  printPluginWarn(message: string): void;
+  printPluginError(message: string, ...args: unknown[]): void;
+}
+declare class NoPrinter extends Printer {
+  constructor();
+  printEventInputValidationError(): void;
+  printInvalidEmit(): void;
+  printStepCreated(): void;
+  printStepUpdated(): void;
+  printStepRemoved(): void;
+  printFlowCreated(): void;
+  printFlowUpdated(): void;
+  printFlowRemoved(): void;
+  printStepType(): void;
+  printStepPath(): void;
+  printStreamCreated(): void;
+  printStreamUpdated(): void;
+  printStreamRemoved(): void;
+  printPluginLog(): void;
+  printPluginWarn(): void;
+  printPluginError(): void;
+}
+//#endregion
+export { NoPrinter, Printer };
+//# sourceMappingURL=printer.d.mts.map

package/dist/src/printer.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"printer.d.mts","names":[],"sources":["../../src/printer.ts"],"sourcesContent":[],"mappings":";;;;;cAsBa,OAAA;;EAAA,WAAO,CAAA,OAAA,EAAA,MAAA;EA0CK,OAAA,EAAA,MAAA;EAMA,OAAA,EAAA,MAAA;EAIA,UAAA,EAAA,MAAA;EAIA,QAAA,EAAA,MAAA;EAgBI,KAAA,EAAA,MAAA;EAIA,OAAA,EAAA,MAAA;EAIA,OAAA,EAAA,MAAA;EAIS,8BAAA,CAAA,IAAA,EAAA;IAMI,KAAA,EAAA,MAAA;EAOgB,CAAA,EAAA,OAAA,EAAA;IAkBtC,aAAA,CAAA,EAAA,MAAA,EAAA;IASA,WAAA,CAAA,EAAA,MAAA,EAAA;IAKI,cAAA,CAAA,EAAA,MAAA,EAAA;EAAM,CAAA,CAAA,EAAA,IAAA;EAqBjB,gBAAU,CAAA,IAAA,EA5GE,IA4GM,EAAA,IAAO,EAAA,MAAA,CAAA,EAAA,IAAA;yBAtGb;yBAIA;yBAIA;;;;6BAgBI;6BAIA;6BAIA;sCAIS;0CAMI;0DAOgB;;oBAkBtC;oBASA;wBAKI;;;;;cAqBX,SAAA,SAAkB,OAAA"}

package/dist/src/printer.mjs

@@ -0,0 +1,147 @@
+import { isApiStep, isCronStep, isEventStep, isNoopStep } from "./guards.mjs";
+import pc from "picocolors";
+import path from "path";
+
+//#region src/printer.ts
+const stepTag = pc.bold(pc.magenta("Step"));
+const flowTag = pc.bold(pc.blue("Flow"));
+const streamTag = pc.bold(pc.green("Stream"));
+const registered = pc.green("➜ [REGISTERED]");
+const building = pc.yellow("⚡ [BUILDING]");
+const built = pc.green("✓ [BUILT]");
+const updated = pc.yellow("➜ [UPDATED]");
+const removed = pc.red("➜ [REMOVED]");
+const invalidEmit = pc.red("➜ [INVALID EMIT]");
+const error = pc.red("[ERROR]");
+const warning = pc.yellow("[WARNING]");
+const warnIcon = pc.yellow("⚠");
+const infoIcon = pc.blue("ℹ");
+const errorIcon = pc.red("✖");
+var Printer = class {
+	constructor(baseDir) {
+		this.baseDir = baseDir;
+		this.stepTag = stepTag;
+		this.flowTag = flowTag;
+		this.registered = registered;
+		this.building = building;
+		this.built = built;
+		this.updated = updated;
+		this.removed = removed;
+	}
+	printEventInputValidationError(emit, details) {
+		const emitPath = pc.bold(pc.cyan(`Emit ${emit.topic}`));
+		console.log(`${warnIcon} ${warning} ${emitPath} validation issues:`);
+		if (!(details.missingFields?.length || details.extraFields?.length || details.typeMismatches?.length)) {
+			console.log(`${pc.yellow("│")} No issues found.`);
+			console.log(`${pc.yellow("└─")} Validation passed.`);
+			return;
+		}
+		if (details.missingFields?.length) console.log(`${pc.yellow("│")} ${pc.yellow(`⚠ Missing fields: ${details.missingFields.join(", ")}`)}`);
+		if (details.extraFields?.length) console.log(`${pc.yellow("│")} ${pc.yellow(`⚠ Extra fields: ${details.extraFields.join(", ")}`)}`);
+		if (details.typeMismatches?.length) console.log(`${pc.yellow("│")} ${pc.yellow(`⚠ Type mismatches: ${details.typeMismatches.join(", ")}`)}`);
+		console.log(`${pc.yellow("└─")} ${pc.yellow("Payload does not match schema.")}`);
+	}
+	printInvalidEmit(step, emit) {
+		console.log(`${invalidEmit} ${stepTag} ${this.getStepType(step)} ${this.getStepPath(step)} tried to emit an event not defined in the step config: ${pc.yellow(emit)}`);
+	}
+	printStepCreated(step) {
+		console.log(`${registered} ${stepTag} ${this.getStepType(step)} ${this.getStepPath(step)} registered`);
+	}
+	printStepUpdated(step) {
+		console.log(`${updated} ${stepTag} ${this.getStepType(step)} ${this.getStepPath(step)} updated`);
+	}
+	printStepRemoved(step) {
+		console.log(`${removed} ${stepTag} ${this.getStepType(step)} ${this.getStepPath(step)} removed`);
+	}
+	printFlowCreated(flowName) {
+		console.log(`${registered} ${flowTag} ${pc.bold(pc.cyan(flowName))} registered`);
+	}
+	printFlowUpdated(flowName) {
+		console.log(`${updated} ${flowTag} ${pc.bold(pc.cyan(flowName))} updated`);
+	}
+	printFlowRemoved(flowName) {
+		console.log(`${removed} ${flowTag} ${pc.bold(pc.cyan(flowName))} removed`);
+	}
+	printStreamCreated(stream) {
+		console.log(`${registered} ${streamTag} ${this.getStreamPath(stream)} registered`);
+	}
+	printStreamUpdated(stream) {
+		console.log(`${updated} ${streamTag} ${this.getStreamPath(stream)} updated`);
+	}
+	printStreamRemoved(stream) {
+		console.log(`${removed} ${streamTag} ${this.getStreamPath(stream)} removed`);
+	}
+	printInvalidEmitConfiguration(step, emit) {
+		console.log(`${warnIcon} ${warning} ${stepTag} ${this.getStepType(step)} ${this.getStepPath(step)} emits to ${pc.yellow(emit)}, but there is no subscriber defined`);
+	}
+	printInvalidSchema(topic, step) {
+		console.log(`${error} Topic ${pc.bold(pc.blue(topic))} has incompatible schemas in the following steps:`);
+		step.forEach((step$1) => {
+			console.log(`${pc.red("  ✖")} ${this.getStepPath(step$1)}`);
+		});
+	}
+	printValidationError(stepPath, validationError) {
+		const relativePath = this.getRelativePath(stepPath);
+		console.log(`${error} ${pc.bold(pc.cyan(relativePath))}`);
+		validationError.errors?.forEach((error$1) => {
+			if (error$1.path) console.log(`${pc.red("│")} ${pc.yellow(`✖ ${error$1.path}`)}: ${error$1.message}`);
+			else console.log(`${pc.red("│")} ${pc.yellow("✖")} ${error$1.message}`);
+		});
+		console.log(`${pc.red("└─")} ${pc.red(validationError.error)}  `);
+	}
+	getRelativePath(filePath) {
+		return path.relative(this.baseDir, filePath);
+	}
+	getStepType(step) {
+		if (isApiStep(step)) return pc.gray("(API)");
+		if (isEventStep(step)) return pc.gray("(Event)");
+		if (isCronStep(step)) return pc.gray("(Cron)");
+		if (isNoopStep(step)) return pc.gray("(Noop)");
+		return pc.gray("(Unknown)");
+	}
+	getStepPath(step) {
+		const stepPath = this.getRelativePath(step.filePath);
+		return pc.bold(pc.cyan(stepPath));
+	}
+	getStreamPath(stream) {
+		const streamPath = this.getRelativePath(stream.filePath);
+		return pc.bold(pc.magenta(streamPath));
+	}
+	printPluginLog(message) {
+		const pluginTag = pc.bold(pc.cyan("[motia-plugins]"));
+		console.log(`${infoIcon} ${pluginTag} ${message}`);
+	}
+	printPluginWarn(message) {
+		const pluginTag = pc.bold(pc.cyan("[motia-plugins]"));
+		console.warn(`${warnIcon} ${pluginTag} ${pc.yellow(message)}`);
+	}
+	printPluginError(message, ...args) {
+		const pluginTag = pc.bold(pc.cyan("[motia-plugins]"));
+		console.error(`${errorIcon} ${pluginTag} ${pc.red(message)}`, ...args);
+	}
+};
+var NoPrinter = class extends Printer {
+	constructor() {
+		super("");
+	}
+	printEventInputValidationError() {}
+	printInvalidEmit() {}
+	printStepCreated() {}
+	printStepUpdated() {}
+	printStepRemoved() {}
+	printFlowCreated() {}
+	printFlowUpdated() {}
+	printFlowRemoved() {}
+	printStepType() {}
+	printStepPath() {}
+	printStreamCreated() {}
+	printStreamUpdated() {}
+	printStreamRemoved() {}
+	printPluginLog() {}
+	printPluginWarn() {}
+	printPluginError() {}
+};
+
+//#endregion
+export { NoPrinter, Printer };
+//# sourceMappingURL=printer.mjs.map

package/dist/src/printer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"printer.mjs","names":["baseDir: string","step","error"],"sources":["../../src/printer.ts"],"sourcesContent":["import path from 'path'\nimport pc from 'picocolors'\nimport { isApiStep, isCronStep, isEventStep, isNoopStep } from './guards'\nimport type { ValidationError } from './step-validator'\nimport type { Step } from './types'\nimport type { Stream } from './types-stream'\n\nconst stepTag = pc.bold(pc.magenta('Step'))\nconst flowTag = pc.bold(pc.blue('Flow'))\nconst streamTag = pc.bold(pc.green('Stream'))\nconst registered = pc.green('➜ [REGISTERED]')\nconst building = pc.yellow('⚡ [BUILDING]')\nconst built = pc.green('✓ [BUILT]')\nconst updated = pc.yellow('➜ [UPDATED]')\nconst removed = pc.red('➜ [REMOVED]')\nconst invalidEmit = pc.red('➜ [INVALID EMIT]')\nconst error = pc.red('[ERROR]')\nconst warning = pc.yellow('[WARNING]')\nconst warnIcon = pc.yellow('⚠')\nconst infoIcon = pc.blue('ℹ')\nconst errorIcon = pc.red('✖')\n\nexport class Printer {\n  constructor(private readonly baseDir: string) {}\n\n  stepTag = stepTag\n  flowTag = flowTag\n  registered = registered\n  building = building\n  built = built\n  updated = updated\n  removed = removed\n\n  printEventInputValidationError(\n    emit: { topic: string },\n    details: { missingFields?: string[]; extraFields?: string[]; typeMismatches?: string[] },\n  ) {\n    const emitPath = pc.bold(pc.cyan(`Emit ${emit.topic}`))\n\n    console.log(`${warnIcon} ${warning} ${emitPath} validation issues:`)\n\n    const hasAny = details.missingFields?.length || details.extraFields?.length || details.typeMismatches?.length\n\n    if (!hasAny) {\n      console.log(`${pc.yellow('│')} No issues found.`)\n      console.log(`${pc.yellow('└─')} Validation passed.`)\n      return\n    }\n\n    if (details.missingFields?.length) {\n      console.log(`${pc.yellow('│')} ${pc.yellow(`⚠ Missing fields: ${details.missingFields.join(', ')}`)}`)\n    }\n\n    if (details.extraFields?.length) {\n      console.log(`${pc.yellow('│')} ${pc.yellow(`⚠ Extra fields: ${details.extraFields.join(', ')}`)}`)\n    }\n\n    if (details.typeMismatches?.length) {\n      console.log(`${pc.yellow('│')} ${pc.yellow(`⚠ Type mismatches: ${details.typeMismatches.join(', ')}`)}`)\n    }\n\n    console.log(`${pc.yellow('└─')} ${pc.yellow('Payload does not match schema.')}`)\n  }\n\n  printInvalidEmit(step: Step, emit: string) {\n    console.log(\n      `${invalidEmit} ${stepTag} ${this.getStepType(step)} ${this.getStepPath(step)} tried to emit an event not defined in the step config: ${pc.yellow(emit)}`,\n    )\n  }\n\n  printStepCreated(step: Step) {\n    console.log(`${registered} ${stepTag} ${this.getStepType(step)} ${this.getStepPath(step)} registered`)\n  }\n\n  printStepUpdated(step: Step) {\n    console.log(`${updated} ${stepTag} ${this.getStepType(step)} ${this.getStepPath(step)} updated`)\n  }\n\n  printStepRemoved(step: Step) {\n    console.log(`${removed} ${stepTag} ${this.getStepType(step)} ${this.getStepPath(step)} removed`)\n  }\n\n  printFlowCreated(flowName: string) {\n    console.log(`${registered} ${flowTag} ${pc.bold(pc.cyan(flowName))} registered`)\n  }\n\n  printFlowUpdated(flowName: string) {\n    console.log(`${updated} ${flowTag} ${pc.bold(pc.cyan(flowName))} updated`)\n  }\n\n  printFlowRemoved(flowName: string) {\n    console.log(`${removed} ${flowTag} ${pc.bold(pc.cyan(flowName))} removed`)\n  }\n\n  printStreamCreated(stream: Stream) {\n    console.log(`${registered} ${streamTag} ${this.getStreamPath(stream)} registered`)\n  }\n\n  printStreamUpdated(stream: Stream) {\n    console.log(`${updated} ${streamTag} ${this.getStreamPath(stream)} updated`)\n  }\n\n  printStreamRemoved(stream: Stream) {\n    console.log(`${removed} ${streamTag} ${this.getStreamPath(stream)} removed`)\n  }\n\n  printInvalidEmitConfiguration(step: Step, emit: string) {\n    console.log(\n      `${warnIcon} ${warning} ${stepTag} ${this.getStepType(step)} ${this.getStepPath(step)} emits to ${pc.yellow(emit)}, but there is no subscriber defined`,\n    )\n  }\n\n  printInvalidSchema(topic: string, step: Step[]) {\n    console.log(`${error} Topic ${pc.bold(pc.blue(topic))} has incompatible schemas in the following steps:`)\n    step.forEach((step) => {\n      console.log(`${pc.red('  ✖')} ${this.getStepPath(step)}`)\n    })\n  }\n\n  printValidationError(stepPath: string, validationError: ValidationError) {\n    const relativePath = this.getRelativePath(stepPath)\n\n    console.log(`${error} ${pc.bold(pc.cyan(relativePath))}`)\n    validationError.errors?.forEach((error) => {\n      if (error.path) {\n        console.log(`${pc.red('│')} ${pc.yellow(`✖ ${error.path}`)}: ${error.message}`)\n      } else {\n        console.log(`${pc.red('│')} ${pc.yellow('✖')} ${error.message}`)\n      }\n    })\n    console.log(`${pc.red('└─')} ${pc.red(validationError.error)}  `)\n  }\n\n  getRelativePath(filePath: string) {\n    return path.relative(this.baseDir, filePath)\n  }\n\n  getStepType(step: Step) {\n    if (isApiStep(step)) return pc.gray('(API)')\n    if (isEventStep(step)) return pc.gray('(Event)')\n    if (isCronStep(step)) return pc.gray('(Cron)')\n    if (isNoopStep(step)) return pc.gray('(Noop)')\n\n    return pc.gray('(Unknown)')\n  }\n\n  getStepPath(step: Step) {\n    const stepPath = this.getRelativePath(step.filePath)\n    return pc.bold(pc.cyan(stepPath))\n  }\n\n  getStreamPath(stream: Stream) {\n    const streamPath = this.getRelativePath(stream.filePath)\n    return pc.bold(pc.magenta(streamPath))\n  }\n\n  printPluginLog(message: string) {\n    const pluginTag = pc.bold(pc.cyan('[motia-plugins]'))\n    console.log(`${infoIcon} ${pluginTag} ${message}`)\n  }\n\n  printPluginWarn(message: string) {\n    const pluginTag = pc.bold(pc.cyan('[motia-plugins]'))\n    console.warn(`${warnIcon} ${pluginTag} ${pc.yellow(message)}`)\n  }\n\n  printPluginError(message: string, ...args: unknown[]) {\n    const pluginTag = pc.bold(pc.cyan('[motia-plugins]'))\n    console.error(`${errorIcon} ${pluginTag} ${pc.red(message)}`, ...args)\n  }\n}\n\nexport class NoPrinter extends Printer {\n  constructor() {\n    super('')\n  }\n\n  printEventInputValidationError() {}\n\n  printInvalidEmit() {}\n  printStepCreated() {}\n  printStepUpdated() {}\n  printStepRemoved() {}\n  printFlowCreated() {}\n  printFlowUpdated() {}\n  printFlowRemoved() {}\n  printStepType() {}\n  printStepPath() {}\n\n  printStreamCreated() {}\n  printStreamUpdated() {}\n  printStreamRemoved() {}\n\n  printPluginLog() {}\n  printPluginWarn() {}\n  printPluginError() {}\n}\n"],"mappings":"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"}

package/dist/src/process-communication/communication-config.mjs

@@ -0,0 +1,26 @@
+//#region src/process-communication/communication-config.ts
+function createCommunicationConfig(command, projectRoot) {
+	const type = command === "python" && process.platform === "win32" ? "rpc" : "ipc";
+	const spawnOptions = { stdio: type === "rpc" ? [
+		"pipe",
+		"pipe",
+		"inherit"
+	] : [
+		"inherit",
+		"inherit",
+		"inherit",
+		"ipc"
+	] };
+	if (command === "python") spawnOptions.env = {
+		...process.env,
+		PYTHONPATH: projectRoot || process.cwd()
+	};
+	return {
+		type,
+		spawnOptions
+	};
+}
+
+//#endregion
+export { createCommunicationConfig };
+//# sourceMappingURL=communication-config.mjs.map

package/dist/src/process-communication/communication-config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"communication-config.mjs","names":["spawnOptions: SpawnOptions"],"sources":["../../../src/process-communication/communication-config.ts"],"sourcesContent":["import type { SpawnOptions } from 'child_process'\n\nexport type CommunicationType = 'rpc' | 'ipc'\n\nexport interface CommunicationConfig {\n  type: CommunicationType\n  spawnOptions: SpawnOptions\n}\n\nexport function createCommunicationConfig(command: string, projectRoot?: string): CommunicationConfig {\n  const type = command === 'python' && process.platform === 'win32' ? 'rpc' : 'ipc'\n\n  const spawnOptions: SpawnOptions = {\n    stdio:\n      type === 'rpc'\n        ? ['pipe', 'pipe', 'inherit'] // RPC: capture stdout\n        : ['inherit', 'inherit', 'inherit', 'ipc'], // IPC: include IPC channel\n  }\n\n  if (command === 'python') {\n    spawnOptions.env = {\n      ...process.env,\n      PYTHONPATH: projectRoot || process.cwd(),\n    }\n  }\n\n  return { type, spawnOptions }\n}\n"],"mappings":";AASA,SAAgB,0BAA0B,SAAiB,aAA2C;CACpG,MAAM,OAAO,YAAY,YAAY,QAAQ,aAAa,UAAU,QAAQ;CAE5E,MAAMA,eAA6B,EACjC,OACE,SAAS,QACL;EAAC;EAAQ;EAAQ;EAAU,GAC3B;EAAC;EAAW;EAAW;EAAW;EAAM,EAC/C;AAED,KAAI,YAAY,SACd,cAAa,MAAM;EACjB,GAAG,QAAQ;EACX,YAAY,eAAe,QAAQ,KAAK;EACzC;AAGH,QAAO;EAAE;EAAM;EAAc"}