tags script fixed / tester script updated.

JasminDreasond · JasminDreasond · commit b41c709d4af9 · 2025-07-03T04:47:58.000-03:00
diff --git a/docs/PuddySqlTags.md b/docs/PuddySqlTags.md
@@ -190,7 +190,7 @@ Sets the alias used in `EXISTS` subqueries (commonly `'value'`).
 Sets the SQL expression used for `json_each()` parsing, such as:
 
 ```sql
-json_array_elements_text(tags)
+json_each(tags)
 ```
 
 ---
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -61,6 +61,7 @@
     "prettier": "3.6.2",
     "rollup": "^4.44.1",
     "rollup-preserve-directives": "^1.1.3",
+    "safe-stable-stringify": "^2.5.0",
     "tslib": "^2.8.1",
     "typescript": "^5.8.3",
     "webpack": "^5.99.6",
diff --git a/src/PuddySqlQuery.mjs b/src/PuddySqlQuery.mjs
@@ -142,9 +142,9 @@ import PuddySqlTags from './PuddySqlTags.mjs';
  *
  * @typedef {Object} BoostValue
  * @property {string[]} [columns] - List of columns to apply the boost on.
- * @property {string} operator - Operator used in the condition (e.g., '=', 'LIKE').
- * @property {string|string[]} value - Value to match in the condition.
- * @property {number} weight - Weight factor to boost results matching the condition.
+ * @property {string} [operator='LIKE'] - Operator used in the condition (e.g., '=', 'LIKE').
+ * @property {string|string[]} [value] - Value to match in the condition.
+ * @property {number} [weight=1] - Weight factor to boost results matching the condition.
  */
 
 /**
@@ -619,13 +619,15 @@ class PuddySqlQuery {
 
       // Boost
       for (const boost of boostArray) {
+        // Validator
         const { columns, operator = 'LIKE', value, weight = 1 } = boost;
         if (typeof operator !== 'string')
           throw new Error(`operator requires an string value. Got: ${typeof operator}`);
         const opValue = operator.toUpperCase();
         if (typeof weight !== 'number' || Number.isNaN(weight))
           throw new Error(`Boost 'weight' must be a valid number. Got: ${weight}`);
 
+        // No columns mode
         if (!columns) {
           if (typeof value !== 'string')
             throw new Error(
@@ -637,9 +639,11 @@ class PuddySqlQuery {
           continue;
         }
 
+        // Check columns
         if (!Array.isArray(columns) || columns.some((col) => typeof col !== 'string'))
           throw new Error(`Boost 'columns' must be a string or array of strings. Got: ${columns}`);
 
+        // In mode
         if (opValue === 'IN') {
           if (!Array.isArray(value))
             throw new Error(`'${opValue}' operator requires an array value. Got: ${typeof value}`);
@@ -649,7 +653,10 @@ class PuddySqlQuery {
             return `${col} IN (${inList})`;
           });
           cases.push(`WHEN ${conditions.join(' OR ')} THEN ${weight}`);
-        } else {
+        } 
+        
+        // Other modes
+        else {
           if (typeof value !== 'string')
             throw new Error(`'${opValue}' operator requires an string value. Got: ${typeof value}`);
 
diff --git a/src/PuddySqlTags.mjs b/src/PuddySqlTags.mjs
@@ -69,7 +69,7 @@ class PuddySqlTags {
    *
    * @type {string|null}
    */
-  #jsonEach = 'json_array_elements_text';
+  #jsonEach = 'json_each';
 
   /** @type {SpecialQuery[]} */
   #specialQueries = [];
diff --git a/src/old/tag.js b/src/old/tag.js
@@ -51,7 +51,7 @@ class TinySqlTags {
     this.parseLimit = -1;
 
     // json_each
-    this.jsonEach = 'json_array_elements_text';
+    this.jsonEach = 'json_each';
     this.specialQueries = [];
 
     this.wildcardA = '*';
diff --git a/test/index.mjs b/test/index.mjs
@@ -3,13 +3,13 @@
 // This test script initializes a SQLite3 database in memory,
 // creates a small test table, and runs various queries to demonstrate functionality.
 
-// import path from 'path';
-// import { fileURLToPath } from 'url';
+import stringify from 'safe-stable-stringify';
+import { ColorSafeStringify } from 'tiny-essentials';
 import PuddySql from '../dist/index.mjs';
 
-// 🌐 Path Setup
-// const __filename = fileURLToPath(import.meta.url);
-// const __dirname = path.dirname(__filename);
+const colorJsonSafe = new ColorSafeStringify();
+const colorSafeStringify = (json, space = 0) =>
+  colorJsonSafe.colorize(stringify(json, null, space));
 
 // 🚀 Create SQL Engine Instance
 const db = new PuddySql.Instance();
@@ -38,90 +38,129 @@ const db = new PuddySql.Instance();
 
   // 📤 Fetching All Records
   console.log('\n📃 All Records:\n');
-  const allItems = await table.getAll();
-  console.table(allItems);
+  console.table(await table.getAll());
 
   // 🔍 Find by ID
   console.log('\n🔍 Getting record with ID = 1\n');
-  const oneItem = await table.get('1');
-  console.dir(oneItem);
+  console.log(colorSafeStringify(await table.get('1')));
 
   // 🔁 Update an Entry
   console.log('\n📝 Updating ID = 4 (yay = true)\n');
   await table.set('4', { yay: true });
-  const updated = await table.get('4');
-  console.dir(updated);
+  console.log(colorSafeStringify(await table.get('4')));
 
   console.log('\n📝 Updating ID = 4 (yay = false)\n');
   await table.set('4', { yay: false });
-  const updated2 = await table.get('4');
-  console.dir(updated2);
+  console.log(colorSafeStringify(await table.get('4')));
 
   // ❌ Delete an Entry
   console.log('\n🗑️ Deleting ID = 2\n');
   await table.delete('2');
-  const afterDelete = await table.getAll();
-  console.table(afterDelete);
+  console.table(await table.getAll());
 
   // 🔎 Advanced Search: prompt = pudding
   console.log('\n🔎 Search: prompt = pudding\n');
-  const search1 = await table.search({
-    q: {
-      group: 'AND',
-      conditions: [{ column: 'prompt', value: '🍮 pudding' }],
-    },
-  });
-  console.dir(search1);
+  console.log(
+    colorSafeStringify(
+      await table.search({
+        q: {
+          group: 'AND',
+          conditions: [{ column: 'prompt', value: '🍮 pudding' }],
+        },
+      }),
+      1,
+    ),
+  );
 
   // 🔎 OR Search: prompt = pudding OR yay = false
   console.log('\n🔎 OR Search: pudding or yay = false\n');
-  const search2 = await table.search({
-    q: {
-      group: 'OR',
-      conditions: [
-        { column: 'prompt', value: '🍮 pudding' },
-        { column: 'yay', value: false },
-      ],
-    },
-  });
-  console.dir(search2);
+  console.log(
+    colorSafeStringify(
+      await table.search({
+        q: {
+          group: 'OR',
+          conditions: [
+            { column: 'prompt', value: '🍮 pudding' },
+            { column: 'yay', value: false },
+          ],
+        },
+      }),
+      1,
+    ),
+  );
 
   // 📚 Paginated Search
   console.log('\n📚 Paginated Search (2 per page)\n');
-  const paged = await table.search({
-    q: {},
-    perPage: 2,
-    page: 1,
-    order: 'id ASC',
-  });
-  console.table(paged.items);
+  const page1 = await table.search({ q: {}, perPage: 2, page: 1, order: 'id ASC' });
+  console.table(page1.items);
 
   console.log('\n📚 Paginated Search (Page 2)\n');
-  const paged2 = await table.search({
-    q: {},
-    perPage: 2,
-    page: 2,
-    order: 'id ASC',
-  });
-  console.table(paged2.items);
-  console.table(paged2);
+  const page2 = await table.search({ q: {}, perPage: 2, page: 2, order: 'id ASC' });
+  console.table(page2.items);
+  console.table({ totalPages: page2.totalPages, totalItems: page2.totalItems });
 
   // 📌 Get amount (first 3)
   console.log('\n📌 Getting first 3 records\n');
-  const few = await table.getAmount(3);
-  console.table(few);
+  console.table(await table.getAmount(3));
 
   // 🧹 Advanced delete: delete all yay = false
   console.log('\n🧹 Deleting all yay = false...\n');
-  const deleted = await table.advancedDelete({
-    yay: { value: false },
-  });
+  const deleted = await table.advancedDelete({ yay: { value: false } });
   console.log(`Deleted rows: ${deleted}`);
 
   // 🧾 Final state
   console.log('\n🧾 Final Records:\n');
-  const final = await table.getAll();
-  console.table(final);
+  console.table(await table.getAll());
 
+  // 🏷️ Tags System Tests
+  console.log('\n🏷️ Creating tagged_posts table...\n');
+  const tagTable = await db.initTable({ name: 'tagged_posts', id: 'id' }, [
+    ['id', 'TEXT', 'PRIMARY KEY'],
+    ['title', 'TEXT'],
+    ['tags', 'TAGS'],
+  ]);
+
+  const tagManager = tagTable.getTagEditor('tags');
+
+  await tagTable.set('a1', { title: 'Post 1', tags: ['cute', 'funny'] });
+  await tagTable.set('a2', { title: 'Post 2', tags: ['serious'] });
+  await tagTable.set('a3', { title: 'Post 3', tags: ['cute', 'deep'] });
+  const tagItems = await tagTable.getAll();
+  console.table(tagItems);
+
+  console.log('\n🔖 Search: has tag "cute"\n');
+  console.table(
+    await tagTable.search({
+      tagsQ: { column: 'tags', include: ['cute'] },
+    }),
+  );
+
+  console.log('\n🧠 Advanced Tag Search: cute AND not serious\n');
+  console.table(
+    await tagTable.search({
+      tagsQ: { column: 'tags', include: ['cute', '!serious'] }
+    }),
+  );
+
+  console.log('\n⚡ Boosted Tag Search (cute *2, deep *3)\n');
+  console.table(
+    await tagTable.search({
+      select: {
+        boost: {
+          alias: 'p',
+          value: [
+          { columns: ['tags'], value: 'deep', weight: 3 },
+          { columns: ['tags'], value: 'cute', weight: 2 },
+        ]
+        }
+      },
+      tagsQ: { 
+        column: 'tags', 
+        include: ['cute', 'deep'],
+      },
+    }),
+  );
+
+  console.log('\n✅ All tag tests done.\n');
   console.log('\n✅ Done.\n');
 })();

Original file line number	Diff line number	Diff line change
`@@ -69,7 +69,7 @@ class PuddySqlTags {`
`69`	`69`	`*`
`70`	`70`	`* @type {string\|null}`
`71`	`71`	`*/`
`72`		`- #jsonEach = 'json_array_elements_text';`
	`72`	`+ #jsonEach = 'json_each';`
`73`	`73`
`74`	`74`	`/** @type {SpecialQuery[]} */`
`75`	`75`	`#specialQueries = [];`