@agfpd/iapeer-memory-core 0.1.1

package/src/utils.ts

@@ -0,0 +1,69 @@
+import crypto from "node:crypto";
+import path from "node:path";
+
+// Hash the FULL file content. Was a 4096-char prefix hash — that skipped
+// reindexing whenever an append-only note (План / Фаза / Список — a
+// first-class vault genre that grows downward) changed below the prefix
+// window, leaving vault_search / embeddings on the stale tail. Markdown is
+// cheap; correctness over the micro-optimisation. If profiling ever demands
+// it, gate a full hash behind size+mtime, never trust a prefix as the source
+// of truth.
+export function hashContent(content: string): string {
+  return crypto.createHash("sha256").update(content).digest("hex");
+}
+
+export function nowIso(): string {
+  return new Date().toISOString();
+}
+
+export function normalizeRelativePath(input: string): string {
+  return input.split(path.sep).join("/").normalize("NFD");
+}
+
+/**
+ * Normalize a path to NFD for iCloud/macOS compatibility.
+ * macOS stores filenames in NFD (decomposed), but user input and code often uses NFC.
+ */
+export function normalizePath(input: string): string {
+  return input.normalize("NFD");
+}
+
+export function noteTitleFromPath(relativePath: string): string {
+  const base = path.basename(relativePath, path.extname(relativePath));
+  return base.trim();
+}
+
+export function toJson(value: unknown): string {
+  return JSON.stringify(value ?? null);
+}
+
+export function fromJson<T>(value: string | null, fallback: T): T {
+  if (!value) return fallback;
+  try {
+    return JSON.parse(value) as T;
+  } catch {
+    return fallback;
+  }
+}
+
+/**
+ * Split a raw user query into the bare search tokens — same normalisation the
+ * FTS path uses (strip control chars + FTS-significant punctuation, split on
+ * whitespace), minus the `"tok"*` wrapping. Shared so the FTS query and the
+ * query-aware snippet builder tokenise identically: the snippet highlights
+ * exactly the words FTS treated as terms, без расхождений.
+ */
+export function queryTokens(query: string): string[] {
+  return query
+    .replace(/[\x00-\x1f]/g, " ")
+    .replace(/["(){}[\]:!^~@#$%&|\\<>=+;,./\-]/g, " ")
+    .trim()
+    .split(/\s+/)
+    .filter(Boolean);
+}
+
+export function escapeFtsQuery(query: string): string {
+  return queryTokens(query)
+    .map((token) => `"${token}"*`)
+    .join(" ");
+}

package/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "lib": [
+      "ESNext"
+    ],
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "types": [
+      "bun"
+    ],
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "allowImportingTsExtensions": false,
+    "verbatimModuleSyntax": false,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true
+  },
+  "include": [
+    "src/**/*.ts",
+    "tests/**/*.ts"
+  ]
+}