hazo_notes 1.0.0

package/dist/utils/file_utils.js

@@ -0,0 +1,128 @@
+/**
+ * File utility functions for hazo_notes
+ */
+/**
+ * Generate a sequential file number (e.g., "0001", "0002")
+ */
+export function generate_file_no(existing_files) {
+    const max_no = existing_files.reduce((max, file) => {
+        const num = parseInt(file.file_no, 10);
+        return isNaN(num) ? max : Math.max(max, num);
+    }, 0);
+    return String(max_no + 1).padStart(4, '0');
+}
+/**
+ * Convert File object to base64 string
+ */
+export async function file_to_base64(file) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => {
+            const result = reader.result;
+            // Remove data URL prefix (e.g., "data:image/png;base64,")
+            const base64 = result.split(',')[1] || result;
+            resolve(base64);
+        };
+        reader.onerror = () => reject(new Error('Failed to read file'));
+        reader.readAsDataURL(file);
+    });
+}
+/**
+ * Get MIME type from filename extension
+ */
+export function get_mime_type(filename) {
+    const ext = filename.split('.').pop()?.toLowerCase() || '';
+    const mime_types = {
+        // Images
+        png: 'image/png',
+        jpg: 'image/jpeg',
+        jpeg: 'image/jpeg',
+        gif: 'image/gif',
+        webp: 'image/webp',
+        svg: 'image/svg+xml',
+        // Documents
+        pdf: 'application/pdf',
+        doc: 'application/msword',
+        docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+        xls: 'application/vnd.ms-excel',
+        xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+        txt: 'text/plain',
+        csv: 'text/csv',
+        // Archives
+        zip: 'application/zip',
+        rar: 'application/vnd.rar',
+    };
+    return mime_types[ext] || 'application/octet-stream';
+}
+/**
+ * Check if file type is allowed
+ */
+export function is_allowed_file_type(filename, allowed_types) {
+    const ext = filename.split('.').pop()?.toLowerCase() || '';
+    return allowed_types.map(t => t.toLowerCase()).includes(ext);
+}
+/**
+ * Check if file is an image (can be embedded)
+ */
+export function is_image_file(filename) {
+    const ext = filename.split('.').pop()?.toLowerCase() || '';
+    return ['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg'].includes(ext);
+}
+/**
+ * Format file size for display
+ */
+export function format_file_size(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(1))} ${sizes[i]}`;
+}
+/**
+ * Parse note text and extract file references
+ * Returns array of { type: 'embed' | 'attach', file_no: string }
+ */
+export function parse_file_references(note_text) {
+    const references = [];
+    // Match <<embed:0001>> pattern
+    const embed_regex = /<<embed:(\d+)>>/g;
+    let match;
+    while ((match = embed_regex.exec(note_text)) !== null) {
+        references.push({ type: 'embed', file_no: match[1] });
+    }
+    // Match <<attach:0001>> pattern
+    const attach_regex = /<<attach:(\d+)>>/g;
+    while ((match = attach_regex.exec(note_text)) !== null) {
+        references.push({ type: 'attachment', file_no: match[1] });
+    }
+    return references;
+}
+/**
+ * Create file reference syntax for inserting into note text
+ */
+export function create_file_reference(file_no, embed_type) {
+    return embed_type === 'embed' ? `<<embed:${file_no}>>` : `<<attach:${file_no}>>`;
+}
+/**
+ * Validate file before upload
+ */
+export function validate_file(file, options) {
+    // Check file size
+    const max_bytes = options.max_size_mb * 1024 * 1024;
+    if (file.size > max_bytes) {
+        return {
+            valid: false,
+            error: `File size (${format_file_size(file.size)}) exceeds maximum allowed (${options.max_size_mb} MB)`,
+        };
+    }
+    // Check file type
+    if (!is_allowed_file_type(file.name, options.allowed_types)) {
+        return {
+            valid: false,
+            error: `File type not allowed. Allowed types: ${options.allowed_types.join(', ')}`,
+        };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=file_utils.js.map

package/dist/utils/file_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_utils.js","sourceRoot":"","sources":["../../src/utils/file_utils.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Utility functions for hazo_notes
+ */
+export { cn } from './cn.js';
+export { generate_file_no, file_to_base64, get_mime_type, is_allowed_file_type, is_image_file, format_file_size, parse_file_references, create_file_reference, validate_file, } from './file_utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,GACd,MAAM,iBAAiB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,6 @@
+/**
+ * Utility functions for hazo_notes
+ */
+export { cn } from './cn.js';
+export { generate_file_no, file_to_base64, get_mime_type, is_allowed_file_type, is_image_file, format_file_size, parse_file_references, create_file_reference, validate_file, } from './file_utils.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,GACd,MAAM,iBAAiB,CAAC"}

package/migrations/001_create_hazo_notes_table.sql

@@ -0,0 +1,77 @@
+-- Migration: Create hazo_notes table
+-- Version: 001
+-- Description: Initial table creation for notes system with JSONB storage
+-- Compatible with: PostgreSQL 13+, SQLite 3.38+ (with JSON1 extension)
+
+-- ============================================================================
+-- PostgreSQL Version
+-- ============================================================================
+
+-- Create the hazo_notes table
+CREATE TABLE IF NOT EXISTS hazo_notes (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  ref_id UUID NOT NULL,
+  note JSONB NOT NULL DEFAULT '[]'::jsonb,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+  changed_at TIMESTAMPTZ,
+  note_count INTEGER NOT NULL DEFAULT 0
+);
+
+-- Create index on ref_id for efficient lookups
+CREATE INDEX IF NOT EXISTS idx_hazo_notes_ref_id ON hazo_notes(ref_id);
+
+-- Add comments for documentation
+COMMENT ON TABLE hazo_notes IS 'Stores notes linked to any entity via ref_id. Notes are stored as JSONB array with user attribution and optional file attachments.';
+COMMENT ON COLUMN hazo_notes.id IS 'Primary key UUID';
+COMMENT ON COLUMN hazo_notes.ref_id IS 'UUID reference to the parent entity (e.g., form field, document, task)';
+COMMENT ON COLUMN hazo_notes.note IS 'JSONB array of note entries: [{userid, created_at, note_text, note_files}]';
+COMMENT ON COLUMN hazo_notes.created_at IS 'Timestamp when the notes row was first created';
+COMMENT ON COLUMN hazo_notes.changed_at IS 'Timestamp of the last modification to the notes';
+COMMENT ON COLUMN hazo_notes.note_count IS 'Denormalized count of notes for quick access without parsing JSONB';
+
+-- ============================================================================
+-- SQLite Version (for test-app)
+-- Run this in SQLite instead of the PostgreSQL version above
+-- ============================================================================
+
+/*
+-- SQLite version (uncomment to use):
+
+CREATE TABLE IF NOT EXISTS hazo_notes (
+  id TEXT PRIMARY KEY,
+  ref_id TEXT NOT NULL,
+  note TEXT NOT NULL DEFAULT '[]',
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  changed_at TEXT,
+  note_count INTEGER NOT NULL DEFAULT 0
+);
+
+CREATE INDEX IF NOT EXISTS idx_hazo_notes_ref_id ON hazo_notes(ref_id);
+*/
+
+-- ============================================================================
+-- Note Entry JSONB Schema Reference
+-- ============================================================================
+/*
+Each element in the `note` JSONB array follows this structure:
+
+{
+  "userid": "550e8400-e29b-41d4-a716-446655440000",
+  "created_at": "2026-01-07T12:30:00.000Z",
+  "note_text": "This is the note content. See attachment: <<attach:0001>>",
+  "note_files": [
+    {
+      "file_no": "0001",
+      "embed_type": "attachment",
+      "filename": "document.pdf",
+      "filedata": "base64_encoded_content_or_file_path",
+      "mime_type": "application/pdf",
+      "file_size": 12345
+    }
+  ]
+}
+
+File references in note_text:
+- <<embed:0001>> - Renders file inline (images displayed directly)
+- <<attach:0001>> - Renders as downloadable link
+*/

package/package.json

@@ -0,0 +1,119 @@
+{
+  "name": "hazo_notes",
+  "version": "1.0.0",
+  "description": "Database-backed notes system with file attachment support for the hazo ecosystem",
+  "type": "module",
+  "main": "./dist/index.client.js",
+  "module": "./dist/index.client.js",
+  "types": "./dist/index.client.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.client.js",
+      "types": "./dist/index.client.d.ts"
+    },
+    "./api": {
+      "import": "./dist/api/index.js",
+      "types": "./dist/api/index.d.ts"
+    },
+    "./hooks": {
+      "import": "./dist/hooks/index.js",
+      "types": "./dist/hooks/index.d.ts"
+    },
+    "./components": {
+      "import": "./dist/components/index.js",
+      "types": "./dist/components/index.d.ts"
+    },
+    "./lib": {
+      "import": "./dist/lib/index.js",
+      "types": "./dist/lib/index.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "templates",
+    "migrations",
+    "README.md",
+    "SETUP_CHECKLIST.md"
+  ],
+  "workspaces": [
+    "test-app"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev:package": "tsc -p tsconfig.build.json --watch",
+    "dev:test-app": "npm run build && cd test-app && npm run dev",
+    "build:test-app": "npm run build && cd test-app && npm run build",
+    "clean": "rm -rf dist",
+    "prebuild": "npm run clean",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pub12/hazo_notes.git"
+  },
+  "keywords": [
+    "notes",
+    "hazo",
+    "react",
+    "typescript",
+    "nextjs",
+    "file-attachments"
+  ],
+  "author": "Pubs Abayasiri",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/pub12/hazo_notes/issues"
+  },
+  "homepage": "https://github.com/pub12/hazo_notes#readme",
+  "dependencies": {
+    "clsx": "^2.1.1",
+    "hazo_config": "^1.0.0",
+    "server-only": "^0.0.1",
+    "tailwind-merge": "^2.5.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "hazo_logs": "^1.0.0",
+    "next": "^14.2.33",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "@radix-ui/react-dialog": "^1.0.0",
+    "@radix-ui/react-popover": "^1.0.0",
+    "hazo_auth": "^5.0.0",
+    "hazo_connect": "^2.3.1",
+    "hazo_logs": "^1.0.0",
+    "next": ">=14.0.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "react-icons": "^5.0.0",
+    "tailwindcss": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "hazo_auth": {
+      "optional": true
+    },
+    "hazo_connect": {
+      "optional": true
+    },
+    "hazo_logs": {
+      "optional": true
+    },
+    "@radix-ui/react-popover": {
+      "optional": true
+    },
+    "@radix-ui/react-dialog": {
+      "optional": true
+    },
+    "react-icons": {
+      "optional": true
+    }
+  }
+}

package/templates/config/hazo_notes_config.ini

@@ -0,0 +1,43 @@
+# hazo_notes Configuration Template
+# Copy this file to your application's config/ directory
+# Path: config/hazo_notes_config.ini
+
+[ui]
+# Background color for notes panel (Tailwind CSS class)
+# Examples: bg-yellow-100, bg-blue-50, bg-gray-100
+background_color = bg-yellow-100
+
+# Panel presentation style
+# Options: popover | slide_panel
+panel_style = popover
+
+# Save behavior
+# Options:
+#   explicit - User clicks Save/Cancel buttons
+#   auto - Note saved automatically when panel closes or on blur
+save_mode = explicit
+
+[storage]
+# File storage mode
+# Options:
+#   jsonb - Store files as Base64 in database (simpler, good for small files)
+#   filesystem - Store files on server filesystem (better for large files)
+file_storage_mode = jsonb
+
+# Path for filesystem storage (only used when file_storage_mode = filesystem)
+# Must be an absolute path or relative to your application root
+file_storage_path = /uploads/notes
+
+[files]
+# Maximum file size in MB
+max_file_size_mb = 10
+
+# Allowed file types (comma-separated extensions, no dots)
+allowed_file_types = pdf,png,jpg,jpeg,gif,doc,docx
+
+# Maximum files per single note entry
+max_files_per_note = 5
+
+[logging]
+# Log file path (relative to application root)
+logfile = logs/hazo_notes.log