@evo-dev/core 0.0.1-alpha.3 → 0.0.1-alpha.4

package/src/utils/parsing.ts

@@ -0,0 +1,11 @@
+export function optionalString(value: unknown): string | null {
+  return typeof value === "string" && value.trim() !== "" ? value : null;
+}
+
+export function optionalBoolean(value: unknown, fallback: boolean): boolean {
+  return typeof value === "boolean" ? value : fallback;
+}
+
+export function positiveInteger(value: unknown, fallback: number): number {
+  return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : fallback;
+}

package/src/utils/text.ts

@@ -0,0 +1,18 @@
+export function sanitizeSummary(value: string): string {
+  const trimmed = value.replace(/\s+/g, " ").trim();
+  return trimmed.length === 0 ? "Session memory event observed." : trimmed.slice(0, 600);
+}
+
+export function truncateUtf8Tail(
+  value: string,
+  maxBytes: number,
+): { content: string; truncated: boolean } {
+  if (Buffer.byteLength(value, "utf8") <= maxBytes) {
+    return { content: value, truncated: false };
+  }
+  let content = value.slice(Math.max(0, value.length - maxBytes));
+  while (Buffer.byteLength(content, "utf8") > maxBytes && content.length > 0) {
+    content = content.slice(1);
+  }
+  return { content, truncated: true };
+}

package/src/utils/time.ts

@@ -0,0 +1,5 @@
+export function normalizeTimestamp(value?: string | Date): string {
+  if (value instanceof Date) return value.toISOString();
+  if (typeof value === "string" && value.trim() !== "") return new Date(value).toISOString();
+  return new Date().toISOString();
+}