semola 0.5.3 → 0.5.4

package/dist/lib/prompts/index.mjs

@@ -1,6 +1,366 @@
-import { createNodePromptRuntime } from "../../prompts/core/runtime.mjs";
-import { runPromptSession } from "../../prompts/core/session.mjs";
+import { err, mightThrow, mightThrowSync, ok } from "../errors/index.mjs";
 import { styleText } from "node:util";
+//#region src/lib/prompts/core/keys.ts
+const ESC = "\x1B";
+const CSI = "\x1B[";
+const ESC_BACKSPACE = `${ESC}\u007F`;
+const CHAR_KEY_MAP = new Map(Object.values({
+	enterCr: {
+		value: "\r",
+		name: "enter"
+	},
+	enterLf: {
+		value: "\n",
+		name: "enter"
+	},
+	ctrlA: {
+		value: "
",
+		name: "ctrl_a"
+	},
+	ctrlC: {
+		value: "",
+		name: "ctrl_c"
+	},
+	ctrlBackspace: {
+		value: "",
+		name: "ctrl_backspace"
+	},
+	backspace: {
+		value: "",
+		name: "backspace"
+	},
+	tab: {
+		value: "	",
+		name: "tab"
+	},
+	space: {
+		value: " ",
+		name: "space"
+	}
+}).map((entry) => [entry.value, { name: entry.name }]));
+const KNOWN_SEQUENCES = [
+	{
+		sequence: "\x1B[1;2D",
+		key: { name: "shift_left" }
+	},
+	{
+		sequence: "\x1B[1;2C",
+		key: { name: "shift_right" }
+	},
+	{
+		sequence: "\x1B[1;5D",
+		key: { name: "ctrl_left" }
+	},
+	{
+		sequence: "\x1B[1;5C",
+		key: { name: "ctrl_right" }
+	},
+	{
+		sequence: "\x1B[1;6D",
+		key: { name: "shift_ctrl_left" }
+	},
+	{
+		sequence: "\x1B[1;6C",
+		key: { name: "shift_ctrl_right" }
+	},
+	{
+		sequence: "\x1B[3~",
+		key: { name: "delete" }
+	},
+	{
+		sequence: "\x1B[H",
+		key: { name: "home" }
+	},
+	{
+		sequence: "\x1B[F",
+		key: { name: "end" }
+	},
+	{
+		sequence: "\x1B[A",
+		key: { name: "up" }
+	},
+	{
+		sequence: "\x1B[B",
+		key: { name: "down" }
+	},
+	{
+		sequence: "\x1B[C",
+		key: { name: "right" }
+	},
+	{
+		sequence: "\x1B[D",
+		key: { name: "left" }
+	}
+];
+const isControlChar = (char) => {
+	return char <= "" || char === "";
+};
+const isCsiFinalByte = (char) => {
+	if (!char) return false;
+	if (char >= "A" && char <= "Z") return true;
+	if (char >= "a" && char <= "z") return true;
+	if (char === "~") return true;
+	return false;
+};
+const readCsiLength = (remaining) => {
+	if (!remaining.startsWith(CSI)) return null;
+	let index = 2;
+	while (index < remaining.length) {
+		if (isCsiFinalByte(remaining[index] ?? "")) return {
+			length: index + 1,
+			incomplete: false
+		};
+		index += 1;
+	}
+	return {
+		length: 0,
+		incomplete: true
+	};
+};
+const parseKeys = (chunk) => {
+	const keys = [];
+	let cursor = 0;
+	while (cursor < chunk.length) {
+		const remaining = chunk.slice(cursor);
+		if (remaining.startsWith(ESC_BACKSPACE)) {
+			keys.push({ name: "ctrl_backspace" });
+			cursor += 2;
+			continue;
+		}
+		const knownSequence = KNOWN_SEQUENCES.find((entry) => remaining.startsWith(entry.sequence));
+		if (knownSequence) {
+			keys.push(knownSequence.key);
+			cursor += knownSequence.sequence.length;
+			continue;
+		}
+		const csiLength = readCsiLength(remaining);
+		if (csiLength) {
+			if (csiLength.incomplete) return {
+				keys,
+				remaining: chunk.slice(cursor)
+			};
+			cursor += csiLength.length;
+			continue;
+		}
+		const char = chunk[cursor] ?? "";
+		switch (char) {
+			case ESC:
+				if (cursor === chunk.length - 1) keys.push({ name: "escape" });
+				break;
+			default: {
+				const key = CHAR_KEY_MAP.get(char);
+				if (key) keys.push(key);
+				else if (!isControlChar(char)) keys.push({
+					name: "character",
+					value: char
+				});
+			}
+		}
+		cursor += 1;
+	}
+	return {
+		keys,
+		remaining: ""
+	};
+};
+//#endregion
+//#region src/lib/prompts/core/runtime.ts
+const HIDE_CURSOR = "\x1B[?25l";
+const SHOW_CURSOR = "\x1B[?25h";
+const countLines = (text) => {
+	let count = 1;
+	for (let i = 0; i < text.length; i++) if (text[i] === "\n") count += 1;
+	return count;
+};
+var NodePromptRuntime = class {
+	stdin;
+	stdout;
+	queue = [];
+	waiters = [];
+	initialized = false;
+	previousLines = 0;
+	buffer = "";
+	constructor(stdin = process.stdin, stdout = process.stdout) {
+		this.stdin = stdin;
+		this.stdout = stdout;
+	}
+	isInteractive() {
+		return Boolean(this.stdin.isTTY && this.stdout.isTTY && typeof this.stdin.setRawMode === "function");
+	}
+	init() {
+		if (!this.isInteractive()) return err("PromptEnvironmentError", "Interactive prompts require a TTY with raw mode support");
+		if (this.initialized) return ok(void 0);
+		const [initError] = mightThrowSync(() => {
+			this.stdin.setRawMode(true);
+			this.stdin.setEncoding("utf8");
+			this.stdin.resume();
+			this.stdin.on("data", this.onData);
+			this.stdout.write(HIDE_CURSOR);
+		});
+		if (initError) return err("PromptIOError", "Unable to initialize prompt runtime");
+		this.initialized = true;
+		return ok(void 0);
+	}
+	readKey() {
+		const queued = this.queue.shift();
+		if (queued) return Promise.resolve(ok(queued));
+		return new Promise((resolve) => {
+			this.waiters.push(resolve);
+		});
+	}
+	render(frame) {
+		const [renderError] = mightThrowSync(() => {
+			if (this.previousLines > 1) this.stdout.write(`\u001B[${this.previousLines - 1}A`);
+			this.stdout.write("\r\x1B[J");
+			this.stdout.write(frame);
+			this.previousLines = countLines(frame);
+		});
+		if (renderError) return err("PromptIOError", "Unable to render prompt frame");
+		return ok(void 0);
+	}
+	done(frame) {
+		const [doneError] = mightThrowSync(() => {
+			if (this.previousLines > 1) this.stdout.write(`\u001B[${this.previousLines - 1}A`);
+			this.stdout.write("\r\x1B[J");
+			this.stdout.write(`${frame}\n`);
+			this.previousLines = 0;
+		});
+		if (doneError) return err("PromptIOError", "Unable to finalize prompt frame");
+		return ok(void 0);
+	}
+	close() {
+		if (!this.initialized) return ok(void 0);
+		this.initialized = false;
+		const [closeError] = mightThrowSync(() => {
+			this.stdin.off("data", this.onData);
+			this.stdin.setRawMode(false);
+			this.stdin.pause?.();
+			this.stdout.write(SHOW_CURSOR);
+		});
+		if (closeError) return err("PromptIOError", "Unable to close prompt runtime");
+		return ok(void 0);
+	}
+	interrupt() {
+		this.close();
+		process.exit(0);
+	}
+	onData = (chunk) => {
+		const value = typeof chunk === "string" ? chunk : chunk.toString("utf8");
+		const combined = `${this.buffer}${value}`;
+		this.buffer = "";
+		const [parseError, result] = mightThrowSync(() => parseKeys(combined));
+		if (parseError || !result) {
+			for (const waiter of this.waiters.splice(0)) waiter(err("PromptIOError", "Failed to parse input"));
+			return;
+		}
+		this.buffer = result.remaining;
+		for (const key of result.keys) {
+			const waiter = this.waiters.shift();
+			if (waiter) waiter(ok(key));
+			else this.queue.push(key);
+		}
+	};
+};
+const createNodePromptRuntime = () => {
+	return new NodePromptRuntime();
+};
+//#endregion
+//#region src/lib/prompts/core/session.ts
+const CANCEL_MESSAGE = "Interrupted, bye!";
+const resolveOutput = async (options, value) => {
+	if (!options.transform) return ok(value);
+	const [transformError, transformed] = await mightThrow(Promise.resolve().then(() => options.transform?.(value)));
+	if (transformError || transformed === null || transformed === void 0) return err("PromptIOError", "Prompt transform callback failed unexpectedly");
+	return ok(transformed);
+};
+const runValidation = async (options, value) => {
+	if (!options.validate) return ok(null);
+	const [validationError, validationMessage] = await mightThrow(Promise.resolve().then(() => options.validate?.(value)));
+	if (validationError) return err("PromptIOError", "Prompt validate callback failed unexpectedly");
+	if (typeof validationMessage === "string" && validationMessage.length > 0) return ok(validationMessage);
+	return ok(null);
+};
+const isCancelKey = (key) => {
+	if (key.name === "ctrl_c") return true;
+	if (key.name === "escape") return true;
+	return false;
+};
+const runPromptSession = async (params) => {
+	const [initError] = params.runtime.init();
+	if (initError) return err(initError.type, initError.message);
+	let state = params.initialState;
+	let errorMessage = null;
+	const closeAndDone = (message) => {
+		const [closeErr] = params.runtime.close();
+		if (closeErr) return err(closeErr.type, closeErr.message);
+		const [doneErr] = params.runtime.done(message);
+		if (doneErr) return err(doneErr.type, doneErr.message);
+		return null;
+	};
+	while (true) {
+		const [renderError] = params.runtime.render(params.render({
+			options: params.options,
+			state,
+			errorMessage
+		}));
+		if (renderError) {
+			params.runtime.close();
+			return err(renderError.type, renderError.message);
+		}
+		const [readError, key] = await params.runtime.readKey();
+		if (readError || !key) {
+			params.runtime.close();
+			return err(readError?.type ?? "PromptIOError", readError?.message ?? "Unable to read prompt input");
+		}
+		if (isCancelKey(key)) {
+			const [closeError] = params.runtime.close();
+			if (closeError) return err(closeError.type, closeError.message);
+			const [doneError] = params.runtime.done(`✖ ${CANCEL_MESSAGE}`);
+			if (doneError) return err(doneError.type, doneError.message);
+			if (params.runtime.interrupt) {
+				const [interruptError] = params.runtime.interrupt(CANCEL_MESSAGE);
+				if (interruptError) return err(interruptError.type, interruptError.message);
+			}
+			return err("PromptCancelledError", CANCEL_MESSAGE);
+		}
+		if (key.name !== "enter") {
+			state = params.onKey(state, key);
+			errorMessage = null;
+			continue;
+		}
+		const submitResult = params.onSubmit(state);
+		if ("errorMessage" in submitResult) {
+			errorMessage = submitResult.errorMessage;
+			continue;
+		}
+		const rawValue = submitResult.value;
+		const [validationRunError, validationErrorMessage] = await runValidation(params.options, rawValue);
+		if (validationRunError) {
+			const closeDoneErr = closeAndDone(`✖ ${params.options.message}`);
+			if (closeDoneErr) return closeDoneErr;
+			return err(validationRunError.type, validationRunError.message);
+		}
+		if (validationErrorMessage) {
+			errorMessage = validationErrorMessage;
+			continue;
+		}
+		const [transformError, finalValue] = await resolveOutput(params.options, rawValue);
+		if (transformError) {
+			const closeDoneErr = closeAndDone(`✖ ${params.options.message}`);
+			if (closeDoneErr) return closeDoneErr;
+			return err(transformError.type, transformError.message);
+		}
+		if (finalValue === null) return err("PromptIOError", "Unable to transform prompt value");
+		const closeDoneErr = closeAndDone(params.complete({
+			options: params.options,
+			state,
+			value: finalValue
+		}));
+		if (closeDoneErr) return closeDoneErr;
+		return ok(finalValue);
+	}
+};
+//#endregion
 //#region src/lib/prompts/index.ts
 const pointer = (active) => {
 	return active ? paint("cyan", "❯") : " ";
@@ -401,5 +761,3 @@ const multiselect = async (options, runtime) => {
 };
 //#endregion
 export { confirm, input, multiselect, number, password, select };
-
-//# sourceMappingURL=index.mjs.map

package/dist/lib/pubsub/index.d.cts

@@ -1,5 +1,11 @@
-import { MessageHandler, PubSubOptions } from "../../pubsub/types.cjs";
-
+//#region src/lib/pubsub/types.d.ts
+type PubSubOptions = {
+  subscriber: Bun.RedisClient;
+  publisher: Bun.RedisClient;
+  channel: string;
+};
+type MessageHandler<T> = (message: T, channel: string) => void | Promise<void>;
+//#endregion
 //#region src/lib/pubsub/index.d.ts
 declare class PubSub<T extends Record<string, unknown>> {
   private options;
@@ -32,5 +38,4 @@ declare class PubSub<T extends Record<string, unknown>> {
   isActive(): boolean;
 }
 //#endregion
-export { PubSub };
-//# sourceMappingURL=index.d.cts.map
+export { PubSub };

package/dist/lib/pubsub/index.d.mts

@@ -1,5 +1,11 @@
-import { MessageHandler, PubSubOptions } from "../../pubsub/types.mjs";
-
+//#region src/lib/pubsub/types.d.ts
+type PubSubOptions = {
+  subscriber: Bun.RedisClient;
+  publisher: Bun.RedisClient;
+  channel: string;
+};
+type MessageHandler<T> = (message: T, channel: string) => void | Promise<void>;
+//#endregion
 //#region src/lib/pubsub/index.d.ts
 declare class PubSub<T extends Record<string, unknown>> {
   private options;
@@ -32,5 +38,4 @@ declare class PubSub<T extends Record<string, unknown>> {
   isActive(): boolean;
 }
 //#endregion
-export { PubSub };
-//# sourceMappingURL=index.d.mts.map
+export { PubSub };

package/dist/lib/pubsub/index.mjs

@@ -114,5 +114,3 @@ var PubSub = class {
 };
 //#endregion
 export { PubSub };
-
-//# sourceMappingURL=index.mjs.map

package/dist/lib/queue/index.d.cts

@@ -1,5 +1,48 @@
-import { QueueOptions } from "../../queue/types.cjs";
-
+//#region src/lib/queue/types.d.ts
+type Job<T> = {
+  id: string;
+  data: T;
+  attempts: number;
+  maxRetries: number;
+  createdAt: number;
+};
+type RetryContext<T> = {
+  job: Job<T>;
+  error: string;
+  nextRetryDelayMs: number;
+  retriesRemaining: number;
+  backoffMultiplier: number;
+};
+type ErrorContext<T> = {
+  job: Job<T>;
+  lastError: string;
+  totalDurationMs: number;
+  totalAttempts: number;
+  errorHistory: Array<{
+    attempt: number;
+    error: string;
+    timestamp: number;
+  }>;
+};
+type ParseErrorContext = {
+  rawJobData: string;
+  parseError: string;
+  timestamp: number;
+};
+type QueueOptions<T> = {
+  name: string;
+  redis: Bun.RedisClient;
+  handler: (data: T, signal?: AbortSignal) => void | Promise<void>;
+  onSuccess?: (job: Job<T>) => void | Promise<void>;
+  onRetry?: (context: RetryContext<T>) => void | Promise<void>;
+  onError?: (context: ErrorContext<T>) => void | Promise<void>;
+  onParseError?: (context: ParseErrorContext) => void | Promise<void>;
+  retries?: number;
+  timeout?: number;
+  concurrency?: number;
+  pollInterval?: number;
+};
+//#endregion
 //#region src/lib/queue/index.d.ts
 declare class Queue<T> {
   private options;
@@ -10,10 +53,10 @@ declare class Queue<T> {
   private concurrency;
   private pollInterval;
   constructor(options: QueueOptions<T>);
-  enqueue(data: T): Promise<readonly [{
+  enqueue(data: T): Promise<readonly [null, string] | readonly [{
     readonly type: "QueueError";
     readonly message: string;
-  }, null] | readonly [null, string]>;
+  }, null]>;
   stop(): Promise<void>;
   private waitForPollInterval;
   private serializeJob;
@@ -28,5 +71,4 @@ declare class Queue<T> {
   private retryJob;
 }
 //#endregion
-export { Queue };
-//# sourceMappingURL=index.d.cts.map
+export { Queue };

package/dist/lib/queue/index.d.mts

@@ -1,5 +1,48 @@
-import { QueueOptions } from "../../queue/types.mjs";
-
+//#region src/lib/queue/types.d.ts
+type Job<T> = {
+  id: string;
+  data: T;
+  attempts: number;
+  maxRetries: number;
+  createdAt: number;
+};
+type RetryContext<T> = {
+  job: Job<T>;
+  error: string;
+  nextRetryDelayMs: number;
+  retriesRemaining: number;
+  backoffMultiplier: number;
+};
+type ErrorContext<T> = {
+  job: Job<T>;
+  lastError: string;
+  totalDurationMs: number;
+  totalAttempts: number;
+  errorHistory: Array<{
+    attempt: number;
+    error: string;
+    timestamp: number;
+  }>;
+};
+type ParseErrorContext = {
+  rawJobData: string;
+  parseError: string;
+  timestamp: number;
+};
+type QueueOptions<T> = {
+  name: string;
+  redis: Bun.RedisClient;
+  handler: (data: T, signal?: AbortSignal) => void | Promise<void>;
+  onSuccess?: (job: Job<T>) => void | Promise<void>;
+  onRetry?: (context: RetryContext<T>) => void | Promise<void>;
+  onError?: (context: ErrorContext<T>) => void | Promise<void>;
+  onParseError?: (context: ParseErrorContext) => void | Promise<void>;
+  retries?: number;
+  timeout?: number;
+  concurrency?: number;
+  pollInterval?: number;
+};
+//#endregion
 //#region src/lib/queue/index.d.ts
 declare class Queue<T> {
   private options;
@@ -10,10 +53,10 @@ declare class Queue<T> {
   private concurrency;
   private pollInterval;
   constructor(options: QueueOptions<T>);
-  enqueue(data: T): Promise<readonly [{
+  enqueue(data: T): Promise<readonly [null, string] | readonly [{
     readonly type: "QueueError";
     readonly message: string;
-  }, null] | readonly [null, string]>;
+  }, null]>;
   stop(): Promise<void>;
   private waitForPollInterval;
   private serializeJob;
@@ -28,5 +71,4 @@ declare class Queue<T> {
   private retryJob;
 }
 //#endregion
-export { Queue };
-//# sourceMappingURL=index.d.mts.map
+export { Queue };

package/dist/lib/queue/index.mjs

@@ -179,5 +179,3 @@ var Queue = class {
 };
 //#endregion
 export { Queue };
-
-//# sourceMappingURL=index.mjs.map

package/dist/lib/workflow/index.d.cts

@@ -1,7 +1,85 @@
-import { StepHandler, Workflow, WorkflowError, WorkflowExecution, WorkflowHandlerContext, WorkflowMeta, WorkflowMetaField, WorkflowOptions, WorkflowStartOptions, WorkflowStartResult, WorkflowStatus } from "../../workflow/types.cjs";
-
+//#region src/lib/workflow/types.d.ts
+type WorkflowStatus = "pending" | "running" | "completed" | "failed" | "cancelled";
+type WorkflowErrorType = "WorkflowError" | "WorkflowNotFoundError" | "WorkflowStateError" | "WorkflowSerializationError" | "WorkflowLockError" | "WorkflowExecutionError" | "WorkflowCancelledError";
+type WorkflowError = {
+  type: WorkflowErrorType;
+  message: string;
+};
+type StepSnapshot = {
+  name: string;
+  completedAt: number;
+};
+type WorkflowExecution<TInput, TResult> = {
+  id: string;
+  name: string;
+  status: WorkflowStatus;
+  input: TInput;
+  result: TResult | null;
+  error: string | null;
+  createdAt: number;
+  updatedAt: number;
+  completedAt: number | null;
+  failedAt: number | null;
+  cancelledAt: number | null;
+  steps: StepSnapshot[];
+};
+type StepHandler<TInput, TStep> = (input: TInput, signal: AbortSignal) => TStep | Promise<TStep>;
+type WorkflowHandlerContext<TInput> = {
+  input: TInput;
+  executionId: string;
+  signal: AbortSignal;
+  step: <TStep>(name: string, handler: StepHandler<TInput, TStep>) => Promise<TStep>;
+};
+type SerializeValue<T> = (value: T) => string;
+type DeserializeValue<T> = (raw: string) => T;
+type WorkflowOptions<TInput, TResult> = {
+  name: string;
+  redis: Bun.RedisClient;
+  handler: (context: WorkflowHandlerContext<TInput>) => TResult | Promise<TResult>;
+  lockTTL?: number;
+  serializeInput?: SerializeValue<TInput>;
+  deserializeInput?: DeserializeValue<TInput>;
+  serializeResult?: SerializeValue<TResult>;
+  deserializeResult?: DeserializeValue<TResult>;
+  serializeStepOutput?: SerializeValue<unknown>;
+  deserializeStepOutput?: DeserializeValue<unknown>;
+};
+type WorkflowStartOptions = {
+  executionId?: string;
+};
+type WorkflowStartResult = {
+  executionId: string;
+  status: WorkflowStatus;
+};
+type WorkflowCancelResult = {
+  status: WorkflowStatus;
+  executionId: string;
+  updatedAt: number;
+  cancelledAt: number;
+  createdAt: number;
+};
+type WorkflowMeta = {
+  status: string;
+  input: string;
+  result: string;
+  error: string;
+  createdAt: string;
+  updatedAt: string;
+  completedAt: string;
+  failedAt: string;
+  cancelledAt: string;
+  steps: string;
+};
+type WorkflowMetaField = keyof WorkflowMeta;
+type Workflow<TInput, TResult> = {
+  start: (input: TInput, options?: WorkflowStartOptions) => Promise<readonly [WorkflowError | null, WorkflowStartResult | null]>;
+  run: (input: TInput, options?: WorkflowStartOptions) => Promise<readonly [WorkflowError | null, TResult | null]>;
+  resume: (executionId: string) => Promise<readonly [WorkflowError | null, WorkflowStartResult | null]>;
+  get: (executionId: string) => Promise<readonly [WorkflowError | null, WorkflowExecution<TInput, TResult> | null]>;
+  cancel: (executionId: string) => Promise<readonly [WorkflowError | null, WorkflowCancelResult | null]>;
+};
+//#endregion
 //#region src/lib/workflow/index.d.ts
 declare const defineWorkflow: <TInput, TResult = void>(options: WorkflowOptions<TInput, TResult>) => Workflow<TInput, TResult>;
 //#endregion
-export { type StepHandler, type Workflow, type WorkflowError, type WorkflowExecution, type WorkflowHandlerContext, type WorkflowMeta, type WorkflowMetaField, type WorkflowOptions, type WorkflowStartOptions, type WorkflowStartResult, type WorkflowStatus, defineWorkflow };
-//# sourceMappingURL=index.d.cts.map
+export { type StepHandler, type Workflow, type WorkflowError, type WorkflowExecution, type WorkflowHandlerContext, type WorkflowMeta, type WorkflowMetaField, type WorkflowOptions, type WorkflowStartOptions, type WorkflowStartResult, type WorkflowStatus, defineWorkflow };