gesttalt 0.7.5 → 0.7.7

package/README.md

@@ -13,9 +13,20 @@ npm install gesttalt
 ```js
 const {
   createSnippet,
+  listSnippets,
   readSnippet,
   updateSnippet,
   deleteSnippet,
+  createPost,
+  listPosts,
+  readPost,
+  updatePost,
+  deletePost,
+  createNote,
+  listNotes,
+  readNote,
+  updateNote,
+  deleteNote,
 } = require('gesttalt');
 
 const projectDir = '.';
@@ -29,6 +40,7 @@ const path = createSnippet(
   'example.zig'
 );
 
+const snippets = listSnippets(projectDir);
 const snippet = readSnippet(projectDir, timestamp);
 console.log(snippet);
 
@@ -37,16 +49,31 @@ updateSnippet(projectDir, timestamp, {
 });
 
 deleteSnippet(projectDir, timestamp);
+
+const postPath = createPost(projectDir, 'hello-world', 'Hello', 'My first post', {
+  tags: ['zig', 'oauth2'],
+});
+const posts = listPosts(projectDir);
+const post = readPost(projectDir, 'hello-world');
+updatePost(projectDir, 'hello-world', { title: 'Updated title' });
+deletePost(projectDir, 'hello-world');
+
+const notePath = createNote(projectDir, timestamp, { body: 'Quick update' });
+const notes = listNotes(projectDir);
+const note = readNote(projectDir, String(timestamp));
+updateNote(projectDir, String(timestamp), { body: 'Edited' });
+deleteNote(projectDir, String(timestamp));
 ```
 
 ## Browser
 
-This package ships a WASM build for browser runtimes. Because snippets CRUD requires filesystem access, you must provide a WASI-compatible runtime with a mounted directory for the project.
+This package ships a WASM build for browser runtimes with an in-memory storage backend. To persist data across reloads, enable the browser storage helper.
 
 ```js
-import { init, createSnippet } from 'gesttalt';
+import { init, enableBrowserStorage, createSnippet } from 'gesttalt';
 
 await init();
+await enableBrowserStorage('/project');
 createSnippet('/project', 1735148400, 'Example snippet', 'const x = 1;', 'example.zig');
 ```
 
@@ -77,9 +104,20 @@ npm test
 ## API
 
 - `createSnippet(projectDir, timestamp, description, body, filename)`
+- `listSnippets(projectDir)`
 - `readSnippet(projectDir, timestamp)`
 - `updateSnippet(projectDir, timestamp, update)`
 - `deleteSnippet(projectDir, timestamp)`
+- `createPost(projectDir, slug, title, description, options)`
+- `listPosts(projectDir)`
+- `readPost(projectDir, slug)`
+- `updatePost(projectDir, slug, update)`
+- `deletePost(projectDir, slug)`
+- `createNote(projectDir, timestamp, options)`
+- `listNotes(projectDir)`
+- `readNote(projectDir, id)`
+- `updateNote(projectDir, id, update)`
+- `deleteNote(projectDir, id)`
 
 ## License
 

package/browser.mjs

@@ -1,4 +1,4 @@
-// Browser-only WASM module for Gesttalt snippets
+// Browser-only WASM module for Gesttalt content (snippets/posts/notes).
 
 let wasmModule = null;
 let wasmReady = false;
@@ -6,17 +6,26 @@ let initPromise = null;
 
 const errorMessages = {
   1: 'Invalid timestamp',
-  2: 'Duplicate snippet',
-  3: 'Snippet not found',
+  2: 'Duplicate content',
+  3: 'Content not found',
   4: 'Invalid extension',
   5: 'Invalid description',
   6: 'Invalid filename',
   7: 'Parse error',
   8: 'I/O error',
   9: 'Out of memory',
+  10: 'Invalid slug',
+  11: 'Invalid date',
+  12: 'Missing title',
+  13: 'Missing description',
+  14: 'Invalid argument',
   100: 'Unknown error',
 };
 
+let storageEnabled = false;
+let storageKey = null;
+let storageProjectDir = '';
+
 export class GesttaltError extends Error {
   constructor(code, message) {
     super(message);
@@ -75,6 +84,82 @@ function readResult(exports, memory) {
   return resultStr;
 }
 
+function writeOptional(exports, memory, value) {
+  if (value == null) return { ptr: 0, len: 0 };
+  return writeString(exports, memory, value);
+}
+
+function storageListWasm(prefix) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+  const prefixBuf = writeString(exports, memory, prefix);
+  const rc = exports.storage_list(prefixBuf.ptr, prefixBuf.len);
+  exports.dealloc(prefixBuf.ptr, prefixBuf.len);
+  throwForCode(rc);
+  return readResult(exports, memory);
+}
+
+function storageGetWasm(path) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+  const pathBuf = writeString(exports, memory, path);
+  const rc = exports.storage_get(pathBuf.ptr, pathBuf.len);
+  exports.dealloc(pathBuf.ptr, pathBuf.len);
+  throwForCode(rc);
+  return readResult(exports, memory);
+}
+
+function storagePutWasm(path, content, overwrite) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+  const pathBuf = writeString(exports, memory, path);
+  const contentBuf = writeString(exports, memory, content);
+  const rc = exports.storage_put(pathBuf.ptr, pathBuf.len, contentBuf.ptr, contentBuf.len, overwrite ? 1 : 0);
+  exports.dealloc(pathBuf.ptr, pathBuf.len);
+  exports.dealloc(contentBuf.ptr, contentBuf.len);
+  throwForCode(rc);
+}
+
+function storageDump(projectDir) {
+  const prefix = projectDir || '';
+  const listJson = storageListWasm(prefix);
+  const paths = listJson ? JSON.parse(listJson) : [];
+  const entries = {};
+  for (const path of paths) {
+    entries[path] = storageGetWasm(path);
+  }
+  return entries;
+}
+
+function storageRestore(projectDir, entries) {
+  for (const [path, content] of Object.entries(entries)) {
+    if (projectDir && !path.startsWith(projectDir)) continue;
+    storagePutWasm(path, content, true);
+  }
+}
+
+function persistStorage() {
+  if (!storageEnabled) return;
+  if (typeof localStorage === 'undefined') return;
+  const entries = storageDump(storageProjectDir);
+  localStorage.setItem(storageKey, JSON.stringify(entries));
+}
+
+export async function enableBrowserStorage(projectDir, key) {
+  await init();
+  storageProjectDir = projectDir || '';
+  storageKey = key || `gesttalt:${storageProjectDir || 'default'}`;
+  storageEnabled = true;
+  if (typeof localStorage === 'undefined') return;
+  const raw = localStorage.getItem(storageKey);
+  if (!raw) return;
+  const entries = JSON.parse(raw);
+  storageRestore(storageProjectDir, entries);
+}
+
 function createSnippetWasm(projectDir, timestamp, description, body, filename) {
   ensureWasmReady();
   const exports = wasmModule.exports;
@@ -102,6 +187,19 @@ function createSnippetWasm(projectDir, timestamp, description, body, filename) {
   return readResult(exports, memory);
 }
 
+function listSnippetsWasm(projectDir) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+
+  const project = writeString(exports, memory, projectDir);
+  const rc = exports.snippet_list(project.ptr, project.len);
+  exports.dealloc(project.ptr, project.len);
+
+  throwForCode(rc);
+  return readResult(exports, memory);
+}
+
 function readSnippetWasm(projectDir, timestamp) {
   ensureWasmReady();
   const exports = wasmModule.exports;
@@ -153,8 +251,201 @@ function deleteSnippetWasm(projectDir, timestamp) {
   throwForCode(rc);
 }
 
+function createPostWasm(projectDir, slug, title, description, tags, date) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+
+  const project = writeString(exports, memory, projectDir);
+  const slugBuf = writeString(exports, memory, slug);
+  const titleBuf = writeString(exports, memory, title);
+  const descBuf = writeString(exports, memory, description);
+  const tagsBuf = writeOptional(exports, memory, tags);
+  const dateBuf = writeOptional(exports, memory, date);
+
+  const rc = exports.post_create(
+    project.ptr, project.len,
+    slugBuf.ptr, slugBuf.len,
+    titleBuf.ptr, titleBuf.len,
+    descBuf.ptr, descBuf.len,
+    tagsBuf.ptr, tagsBuf.len,
+    dateBuf.ptr, dateBuf.len
+  );
+
+  exports.dealloc(project.ptr, project.len);
+  exports.dealloc(slugBuf.ptr, slugBuf.len);
+  exports.dealloc(titleBuf.ptr, titleBuf.len);
+  exports.dealloc(descBuf.ptr, descBuf.len);
+  if (tagsBuf.ptr) exports.dealloc(tagsBuf.ptr, tagsBuf.len);
+  if (dateBuf.ptr) exports.dealloc(dateBuf.ptr, dateBuf.len);
+
+  throwForCode(rc);
+  return readResult(exports, memory);
+}
+
+function listPostsWasm(projectDir) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+  const project = writeString(exports, memory, projectDir);
+  const rc = exports.post_list(project.ptr, project.len);
+  exports.dealloc(project.ptr, project.len);
+  throwForCode(rc);
+  return readResult(exports, memory);
+}
+
+function readPostWasm(projectDir, slug) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+  const project = writeString(exports, memory, projectDir);
+  const slugBuf = writeString(exports, memory, slug);
+  const rc = exports.post_read(project.ptr, project.len, slugBuf.ptr, slugBuf.len);
+  exports.dealloc(project.ptr, project.len);
+  exports.dealloc(slugBuf.ptr, slugBuf.len);
+  throwForCode(rc);
+  return readResult(exports, memory);
+}
+
+function updatePostWasm(projectDir, slug, updates = {}) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+  const project = writeString(exports, memory, projectDir);
+  const slugBuf = writeString(exports, memory, slug);
+  const titleBuf = writeOptional(exports, memory, updates.title);
+  const descBuf = writeOptional(exports, memory, updates.description);
+  const tagsBuf = writeOptional(exports, memory, updates.tags);
+  const addTagsBuf = writeOptional(exports, memory, updates.addTags);
+  const removeTagsBuf = writeOptional(exports, memory, updates.removeTags);
+
+  const rc = exports.post_update(
+    project.ptr, project.len,
+    slugBuf.ptr, slugBuf.len,
+    titleBuf.ptr, titleBuf.len,
+    descBuf.ptr, descBuf.len,
+    tagsBuf.ptr, tagsBuf.len,
+    addTagsBuf.ptr, addTagsBuf.len,
+    removeTagsBuf.ptr, removeTagsBuf.len
+  );
+
+  exports.dealloc(project.ptr, project.len);
+  exports.dealloc(slugBuf.ptr, slugBuf.len);
+  if (titleBuf.ptr) exports.dealloc(titleBuf.ptr, titleBuf.len);
+  if (descBuf.ptr) exports.dealloc(descBuf.ptr, descBuf.len);
+  if (tagsBuf.ptr) exports.dealloc(tagsBuf.ptr, tagsBuf.len);
+  if (addTagsBuf.ptr) exports.dealloc(addTagsBuf.ptr, addTagsBuf.len);
+  if (removeTagsBuf.ptr) exports.dealloc(removeTagsBuf.ptr, removeTagsBuf.len);
+
+  throwForCode(rc);
+}
+
+function deletePostWasm(projectDir, slug) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+  const project = writeString(exports, memory, projectDir);
+  const slugBuf = writeString(exports, memory, slug);
+  const rc = exports.post_delete(project.ptr, project.len, slugBuf.ptr, slugBuf.len);
+  exports.dealloc(project.ptr, project.len);
+  exports.dealloc(slugBuf.ptr, slugBuf.len);
+  throwForCode(rc);
+}
+
+function createNoteWasm(projectDir, timestamp, slug, body) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+  const project = writeString(exports, memory, projectDir);
+  const slugBuf = writeOptional(exports, memory, slug);
+  const bodyBuf = writeOptional(exports, memory, body);
+
+  const rc = exports.note_create(
+    project.ptr, project.len,
+    BigInt(timestamp),
+    slugBuf.ptr, slugBuf.len,
+    bodyBuf.ptr, bodyBuf.len
+  );
+
+  exports.dealloc(project.ptr, project.len);
+  if (slugBuf.ptr) exports.dealloc(slugBuf.ptr, slugBuf.len);
+  if (bodyBuf.ptr) exports.dealloc(bodyBuf.ptr, bodyBuf.len);
+
+  throwForCode(rc);
+  return readResult(exports, memory);
+}
+
+function listNotesWasm(projectDir) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+  const project = writeString(exports, memory, projectDir);
+  const rc = exports.note_list(project.ptr, project.len);
+  exports.dealloc(project.ptr, project.len);
+  throwForCode(rc);
+  return readResult(exports, memory);
+}
+
+function readNoteWasm(projectDir, id) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+  const project = writeString(exports, memory, projectDir);
+  const idBuf = writeString(exports, memory, id);
+  const rc = exports.note_read(project.ptr, project.len, idBuf.ptr, idBuf.len);
+  exports.dealloc(project.ptr, project.len);
+  exports.dealloc(idBuf.ptr, idBuf.len);
+  throwForCode(rc);
+  return readResult(exports, memory);
+}
+
+function updateNoteWasm(projectDir, id, updates = {}) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+  const project = writeString(exports, memory, projectDir);
+  const idBuf = writeString(exports, memory, id);
+  const slugBuf = writeOptional(exports, memory, updates.slug);
+  const bodyBuf = writeOptional(exports, memory, updates.body);
+  const clearSlug = updates.clearSlug ? 1 : 0;
+
+  const rc = exports.note_update(
+    project.ptr, project.len,
+    idBuf.ptr, idBuf.len,
+    slugBuf.ptr, slugBuf.len,
+    clearSlug,
+    bodyBuf.ptr, bodyBuf.len
+  );
+
+  exports.dealloc(project.ptr, project.len);
+  exports.dealloc(idBuf.ptr, idBuf.len);
+  if (slugBuf.ptr) exports.dealloc(slugBuf.ptr, slugBuf.len);
+  if (bodyBuf.ptr) exports.dealloc(bodyBuf.ptr, bodyBuf.len);
+
+  throwForCode(rc);
+}
+
+function deleteNoteWasm(projectDir, id) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+  const project = writeString(exports, memory, projectDir);
+  const idBuf = writeString(exports, memory, id);
+  const rc = exports.note_delete(project.ptr, project.len, idBuf.ptr, idBuf.len);
+  exports.dealloc(project.ptr, project.len);
+  exports.dealloc(idBuf.ptr, idBuf.len);
+  throwForCode(rc);
+}
+
 export function createSnippet(projectDir, timestamp, description, body, filename) {
-  return createSnippetWasm(projectDir, timestamp, description, body, filename);
+  const result = createSnippetWasm(projectDir, timestamp, description, body, filename);
+  persistStorage();
+  return result;
+}
+
+export function listSnippets(projectDir) {
+  const json = listSnippetsWasm(projectDir);
+  return json ? JSON.parse(json) : [];
 }
 
 export function readSnippet(projectDir, timestamp) {
@@ -166,11 +457,79 @@ export function updateSnippet(projectDir, timestamp, update = {}) {
   const description = update.description ?? null;
   const body = update.body ?? null;
   const filename = update.filename ?? null;
-  return updateSnippetWasm(projectDir, timestamp, description, body, filename);
+  const result = updateSnippetWasm(projectDir, timestamp, description, body, filename);
+  persistStorage();
+  return result;
 }
 
 export function deleteSnippet(projectDir, timestamp) {
-  return deleteSnippetWasm(projectDir, timestamp);
+  const result = deleteSnippetWasm(projectDir, timestamp);
+  persistStorage();
+  return result;
+}
+
+export function createPost(projectDir, slug, title, description, options = {}) {
+  const tags = Array.isArray(options.tags) ? options.tags.join(', ') : (options.tags ?? null);
+  const date = options.date ?? null;
+  const result = createPostWasm(projectDir, slug, title, description, tags, date);
+  persistStorage();
+  return result;
+}
+
+export function listPosts(projectDir) {
+  const json = listPostsWasm(projectDir);
+  return json ? JSON.parse(json) : [];
+}
+
+export function readPost(projectDir, slug) {
+  const json = readPostWasm(projectDir, slug);
+  return json ? JSON.parse(json) : null;
+}
+
+export function updatePost(projectDir, slug, updates = {}) {
+  const payload = { ...updates };
+  if (Array.isArray(payload.tags)) payload.tags = payload.tags.join(', ');
+  if (Array.isArray(payload.addTags)) payload.addTags = payload.addTags.join(', ');
+  if (Array.isArray(payload.removeTags)) payload.removeTags = payload.removeTags.join(', ');
+  const result = updatePostWasm(projectDir, slug, payload);
+  persistStorage();
+  return result;
+}
+
+export function deletePost(projectDir, slug) {
+  const result = deletePostWasm(projectDir, slug);
+  persistStorage();
+  return result;
+}
+
+export function createNote(projectDir, timestamp, options = {}) {
+  const slug = options.slug ?? null;
+  const body = options.body ?? null;
+  const result = createNoteWasm(projectDir, timestamp, slug, body);
+  persistStorage();
+  return result;
+}
+
+export function listNotes(projectDir) {
+  const json = listNotesWasm(projectDir);
+  return json ? JSON.parse(json) : [];
+}
+
+export function readNote(projectDir, id) {
+  const json = readNoteWasm(projectDir, id);
+  return json ? JSON.parse(json) : null;
+}
+
+export function updateNote(projectDir, id, updates = {}) {
+  const result = updateNoteWasm(projectDir, id, updates);
+  persistStorage();
+  return result;
+}
+
+export function deleteNote(projectDir, id) {
+  const result = deleteNoteWasm(projectDir, id);
+  persistStorage();
+  return result;
 }
 
 export function isNative() {
@@ -181,4 +540,25 @@ export function isWasm() {
   return wasmReady;
 }
 
-export default { init, createSnippet, readSnippet, updateSnippet, deleteSnippet, isNative, isWasm, GesttaltError };
+export default {
+  init,
+  enableBrowserStorage,
+  createSnippet,
+  listSnippets,
+  readSnippet,
+  updateSnippet,
+  deleteSnippet,
+  createPost,
+  listPosts,
+  readPost,
+  updatePost,
+  deletePost,
+  createNote,
+  listNotes,
+  readNote,
+  updateNote,
+  deleteNote,
+  isNative,
+  isWasm,
+  GesttaltError,
+};

package/index.d.ts

@@ -12,11 +12,55 @@ export interface SnippetUpdate {
   filename?: string;
 }
 
+export interface PostListItem {
+  date: string;
+  slug: string;
+  title: string;
+  tags: string[];
+}
+
+export interface Post {
+  date: string;
+  slug: string;
+  title: string;
+  description: string;
+  tags: string[];
+  content: string;
+}
+
+export interface PostUpdate {
+  title?: string;
+  description?: string;
+  tags?: string | string[];
+  addTags?: string | string[];
+  removeTags?: string | string[];
+}
+
+export interface NoteListItem {
+  date: string;
+  id: string;
+  slug?: string | null;
+}
+
+export interface Note {
+  date: string;
+  id: string;
+  slug?: string | null;
+  content: string;
+}
+
+export interface NoteUpdate {
+  slug?: string | null;
+  clearSlug?: boolean;
+  body?: string | null;
+}
+
 export class GesttaltError extends Error {
   code: number;
 }
 
 export function init(): Promise<void>;
+export function enableBrowserStorage(projectDir: string, key?: string): Promise<void>;
 
 export function createSnippet(
   projectDir: string,
@@ -26,6 +70,8 @@ export function createSnippet(
   filename: string
 ): string;
 
+export function listSnippets(projectDir: string): Snippet[];
+
 export function readSnippet(projectDir: string, timestamp: number): Snippet | null;
 
 export function updateSnippet(
@@ -36,5 +82,49 @@ export function updateSnippet(
 
 export function deleteSnippet(projectDir: string, timestamp: number): void;
 
+export function createPost(
+  projectDir: string,
+  slug: string,
+  title: string,
+  description: string,
+  options?: {
+    tags?: string | string[];
+    date?: string | null;
+  }
+): string;
+
+export function listPosts(projectDir: string): PostListItem[];
+
+export function readPost(projectDir: string, slug: string): Post | null;
+
+export function updatePost(
+  projectDir: string,
+  slug: string,
+  update?: PostUpdate
+): void;
+
+export function deletePost(projectDir: string, slug: string): void;
+
+export function createNote(
+  projectDir: string,
+  timestamp: number,
+  options?: {
+    slug?: string | null;
+    body?: string | null;
+  }
+): string;
+
+export function listNotes(projectDir: string): NoteListItem[];
+
+export function readNote(projectDir: string, id: string): Note | null;
+
+export function updateNote(
+  projectDir: string,
+  id: string,
+  update?: NoteUpdate
+): void;
+
+export function deleteNote(projectDir: string, id: string): void;
+
 export function isNative(): boolean;
 export function isWasm(): boolean;