docs: document storage APIs and environments

Add JSDoc public API, visibility, and runtime environment metadata for the storage package exports.

Author: frankpagan

src/array.js

@@ -13,6 +13,8 @@ import {
 
 /**
  * "array" operations mapped to SQL Tables.
+ * @private
+ * @environment server
  */
 function array(method, data) {
     const storageName = data.storageConfig?.name;

src/database.js

@@ -13,6 +13,8 @@ import {
 
 /**
  * "database" operations mapped to SQLite Files (emulated catalogs).
+ * @private
+ * @environment server
  */
 function database(method, data) {
     const storageName = data.storageConfig?.name;

src/index.js

@@ -23,6 +23,8 @@ import object from "./object.js";
  * Routes CRUD requests to appropriate SQLite database, array, or object modules.
  * @param {Object} data - CRUD request payload containing method, database, array, organization_id, etc.
  * @returns {Promise<Object>} Execution result from SQLite / libSQL database layer
+ * @public
+ * @environment server
  */
 export async function send(data) {
     if (!data || !data.method) {
@@ -37,4 +39,11 @@ export async function send(data) {
     throw new Error(`Unsupported query target type: "${type}" in method "${data.method}"`);
 }
 
-export default { send };
+export default { send };
+
+/**
+ * Lightweight SQLite CRUD wrapper and multi-tenant state routing client for the CoCreate ecosystem.
+ *
+ * @module sqlite
+ * @environment server
+ */

src/object.js

@@ -13,6 +13,8 @@ import {
 
 /**
  * "object" operations mapped to SQL Rows.
+ * @private
+ * @environment server
  */
 function object(method, data) {
     const storageName = data.storageConfig?.name;

src/utilities.js

@@ -30,6 +30,8 @@ const organizations = {};
  * Dynamically resolves or caches a long-lived libSQL Database Client.
  * Supports standard local SQLite files ("file:local.db"), in-memory paths (":memory:"),
  * and remote Turso connections ("libsql://...") with cloud tokens.
+ * @private
+ * @environment server
  */
 async function dbClient(data) {
 	const storageUrl = data.storageConfig?.databaseUrl || data.storageConfig?.url;
@@ -106,6 +108,8 @@ process.on("orgDeleted", (organization_id) => {
 
 /**
  * Safe transaction helper to update unstructured payloads with MongoDB behavior inside libSQL.
+ * @private
+ * @environment server
  */
 async function executeUpdateTransaction(db, arrayName, docId, rawUpdateInput, requestData) {
 	try {
@@ -166,6 +170,8 @@ async function executeUpdateTransaction(db, arrayName, docId, rawUpdateInput, re
 
 /**
  * Applies MongoDB update operators recursively to maintain unified schema manipulation behaviors.
+ * @private
+ * @environment server
  */
 function applyMongoUpdate(record, updatePayload) {
 	let target = { ...record };
@@ -256,6 +262,8 @@ function applyMongoUpdate(record, updatePayload) {
 
 /**
  * Translates standard MongoDB JSON filters into native SQLite query filters.
+ * @private
+ * @environment server
  */
 function compileFilterToSQL(filter, organizationId) {
 	let clauses = ["organization_id = ?"];
@@ -326,6 +334,8 @@ function compileFilterToSQL(filter, organizationId) {
 
 /**
  * Resolves SQLite columns and rows back into unified JSON format.
+ * @private
+ * @environment server
  */
 function parseSqlRow(row) {
 	if (!row) return null;
@@ -367,6 +377,8 @@ function deleteNestedValue(obj, path) {
 
 /**
  * Syncs the output response data arrays back cleanly.
+ * @private
+ * @environment server
  */
 function createData(data, array, type) {
 	if (data[type] && data[type][0] && data[type][0].isFilter === "isEmptyObjectFilter") {