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

package/src/utils/hash.ts

@@ -0,0 +1,9 @@
+import { createHash } from "node:crypto";
+
+export function sha256Hex(value: string): string {
+  return createHash("sha256").update(value).digest("hex");
+}
+
+export function sha256Short(value: string, length = 16): string {
+  return sha256Hex(value).slice(0, length);
+}

package/src/utils/ids.ts

@@ -0,0 +1,12 @@
+import { sha256Short } from "./hash.ts";
+
+export function createStableId(prefix: string, parts: string[]): string {
+  return `${prefix}-${sha256Short(parts.join("\0"))}`;
+}
+
+export function sanitizeStorageId(value: string, fallbackPrefix: string): string {
+  const sanitized = value.replace(/[^a-zA-Z0-9._-]/g, "-").slice(0, 120);
+  return sanitized === "" || sanitized === "." || sanitized === ".."
+    ? `${fallbackPrefix}-local`
+    : sanitized;
+}

package/src/utils/index.ts

@@ -0,0 +1,7 @@
+export * from "./errors.ts";
+export * from "./fs.ts";
+export * from "./hash.ts";
+export * from "./ids.ts";
+export * from "./parsing.ts";
+export * from "./text.ts";
+export * from "./time.ts";

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();
+}