docs: expand input and output object types in API signatures

src/store/manifestattachment/add.js

@@ -16,7 +16,7 @@ export default function add(pool) {
    * @param {string} input.mimetype - The MIME type of the file (e.g. `'application/pdf'`).
    * @param {string} input.name - The file name.
    * @param {Buffer} input.content - The file content.
-   * @returns {Promise<object>} The created attachment record.
+   * @returns {Promise<{id: number, manifestId: number, fileId: number, mimetype: string, name: string}>} The created attachment record.
    * @throws {Error} If the manifest is not found or file input is invalid.
    *
    * @example

src/store/manifestattachment/getById.js

@@ -13,7 +13,7 @@ export default function getById(pool) {
    * @param {number} googleAuthId - The id of the Google auth user.
    * @param {number} manifestId - The manifest ID.
    * @param {number} id - The attachment ID or file ID.
-   * @returns {Promise<object>} The attachment record with binary content.
+   * @returns {Promise<{id: number, manifestId: number, fileId: number, mimetype: string, name: string, content: Buffer}>} The attachment record with binary content.
    * @throws {Error} If the manifest or attachment is not found, or user is not authorized.
    *
    * @example

src/store/manifestattachment/listByManifestId.js

@@ -23,7 +23,7 @@ export default function listByManifestId(pool) {
    *
    * @param {number} googleAuthId - The id of the Google auth user.
    * @param {number} manifestId - The manifest ID.
-   * @returns {Promise<Array<object>>} A list of attachment metadata objects.
+   * @returns {Promise<Array<{id: number, manifestId: number, fileId: number, mimetype: string, name: string, size: number}>>} A list of attachment metadata objects.
    * @throws {Error} If the manifest is not found or the user is not authorized.
    *
    * @example