@nacre.work/api 0.24.0 → 0.25.0

package/dist/server.js

@@ -2405,6 +2405,49 @@ async function handle(req, res, options) {
             send(res, 204, null, requestId);
             return;
         }
+        const retryMatch = pathMatch(/^\/v1\/documents\/([^/]+)\/retry$/, instance);
+        if (req.method === 'POST' && retryMatch) {
+            const id = retryMatch[1];
+            if (options.documents.retry === undefined) {
+                const problem = notFound(instance, requestId);
+                send(res, problem.status, problem.toJSON(), requestId);
+                return;
+            }
+            const outcome = await options.documents.retry(auth, id);
+            await options.audit.write({
+                orgId: auth.orgId,
+                actor: `${auth.principal.type}:${auth.principal.id}`,
+                action: 'retry_document',
+                result: outcome === 'requeued' ? 'allow' : 'deny',
+                target: { document_id: id },
+                detail: { document_id: id, outcome },
+                requestId,
+            });
+            if (outcome === 'unreachable') {
+                const problem = notFound(instance, requestId);
+                send(res, problem.status, problem.toJSON(), requestId);
+                return;
+            }
+            if (outcome === 'not-failed') {
+                const problem = new Problem({
+                    type: 'https://nacre.work/errors/conflict',
+                    title: 'Conflict',
+                    status: 409,
+                    detail: 'This document has not failed, so there is nothing to retry. ' +
+                        'Only a document whose status is `failed` can be requeued this way; ' +
+                        'send it again through POST /v1/documents to re-index one that has not.',
+                    instance,
+                    requestId,
+                });
+                send(res, problem.status, problem.toJSON(), requestId);
+                return;
+            }
+            // `204`, and never the document, for the same reason the PATCH beside it
+            // does: rule 6 means a caller may hold `write` without `read`, so a body
+            // describing what was requeued would be a read this caller has not got.
+            send(res, 204, null, requestId);
+            return;
+        }
         if (req.method === 'PATCH' && documentMatch) {
             const id = documentMatch[1];
             if (options.documents.updateMetadata === undefined) {