docs: add JSDoc headers to all externally exported store functions

src/store/delivery/list.js

@@ -2,6 +2,17 @@ import { DELIVERY_TYPE, LIST_DELIVERIES } from '../../sql/delivery.js';
 import resolveCompanyAccess from '../companyuser/resolveCompanyAccess.js';
 import { shapeSummary } from './helpers.js';
 
+/**
+ * Lists the deliveries of a company.
+ *
+ * @param {object} pool - The mssql connection pool.
+ * @returns {Function} An async function that lists deliveries.
+ *
+ * @example
+ * const fn = list(pool);
+ * const deliveries = await fn(42, 1);
+ * // => [{ id, number, type, entityId, date }]
+ */
 export default function list(pool) {
   const access = resolveCompanyAccess(pool);