[andreacw5]

Wave W1 of platform plan docs/platform/plans/02-api-contract-cutover.md (Articuno part). Do not merge: merges only in the W4 cutover, together with fileharbor, gatherly, @heyatom/client 1.0.0 and the consumers.

Changes

• @heyatom/nest-common ^0.3.0 → ^0.4.0; global TransformInterceptor (APP_INTERCEPTOR).
• Every non-paginated 2xx JSON body → { data }. Paginated lists unchanged ({ data, meta }, passed through by the paginate() marker). 204s unchanged.
• GET /articles/{id}/translations and GET /admin/articles/{id}/translations: bare array → { data: [...] }.
• GET /admin/webhooks: the controller spread the page to map rows, dropping the marker (would have become {data:{data,meta}}); rebuilt with markPaginated, with a spec.
• Swagger: all 2xx @ApiResponse/@ApiOkResponse/@ApiCreatedResponse({ type }) → ApiOkData / ApiCreatedData. openapi.json regenerated.
• @NoTransform() exemptions: none (no file/stream/redirect/external-format endpoint).

Shapes changed (old X → new)

• POST /articles → {data: ArticleDto}
• GET /articles/{slug} → {data: ArticleDto}
• PATCH /articles/{id} → {data: ArticleDto}
• POST /banned-words → {data: BannedWordDto}
• POST /articles/{id}/translations → {data: ArticleTranslationDto}
• GET /articles/{id}/translations → {data: [ArticleTranslationSummaryDto]}
• GET /articles/{id}/translations/{languageCode} → {data: ArticleTranslationDto}
• PATCH /articles/{id}/translations/{languageCode} → {data: ArticleTranslationDto}
• POST /bookmarks/{articleId} → {data: BookmarkToggleResultDto}
• POST /categories → {data: CategoryDto}
• GET /categories/{slug} → {data: CategoryDto}
• PATCH /categories/{id} → {data: CategoryDto}
• POST /comments → {data: CommentDto}
• GET /comments/{id} → {data: CommentDto}
• PATCH /comments/{id} → {data: CommentDto}
• POST /interactions/articles/{articleId}/like → {data: LikeToggleResultDto}
• GET /interactions/articles/{articleId}/status → {data: ArticleInteractionStatusDto}
• POST /reports → {data: ReportDto}
• PATCH /reports/{id}/status → {data: ReportDto}
• POST /tags → {data: TagDto}
• GET /tags/{slug} → {data: TagDto}
• PATCH /tags/{id} → {data: TagDto}
• POST /users/sync → {data: UserDto}
• GET /health/live → {data: {...}} (health, body free per api.md §6)
• GET /health/ready → {data: {...}} (health, body free per api.md §6)
• POST /admin/articles → {data: ArticleDto}
• GET /admin/articles/{key} → {data: ArticleDto}
• PATCH /admin/articles/{id} → {data: ArticleDto}
• POST /admin/articles/{id}/translations → {data: ArticleTranslationDto}
• GET /admin/articles/{id}/translations → {data: [ArticleTranslationSummaryDto]}
• GET /admin/articles/{id}/translations/{languageCode} → {data: ArticleTranslationDto}
• PATCH /admin/articles/{id}/translations/{languageCode} → {data: ArticleTranslationDto}
• POST /admin/tags → {data: TagDto}
• GET /admin/tags/{id} → {data: TagDto}
• PATCH /admin/tags/{id} → {data: TagDto}
• POST /admin/categories → {data: CategoryDto}
• GET /admin/categories/{id} → {data: CategoryDto}
• PATCH /admin/categories/{id} → {data: CategoryDto}
• POST /admin/banned-words → {data: BannedWordDto}
• POST /admin/reports → {data: ReportDto}
• GET /admin/reports/{id} → {data: ReportDto}
• PATCH /admin/reports/{id}/status → {data: ReportDto}
• GET /admin/audits/{id} → {data: AuditLogDto}
• GET /admin/users/{id} → {data: UserListItemDto}
• PATCH /admin/users/{id}/status → {data: UserListItemDto}
• GET /admin/comments/{id} → {data: CommentDto}
• PATCH /admin/comments/{id} → {data: CommentDto}
• GET /admin/webhooks/{id} → {data: WebhookEventDto}
• POST /admin/webhooks/{id}/resend → {data: WebhookEventDto}
• POST /admin/webhooks/resend-all-failed → {data: WebhookResendAllResultDto}
• GET /admin/stats/dashboard → {data: DashboardStatsDto}

Checks

• command grep -rnE "@Api(Ok|Created)Response\(\{ type" src → empty
• build, lint OK; specs: admin controllers, app module, new admin-webhooks spec

W3 — FileHarbor via @heyatom/client

• src/modules/fileharbor/: HTTP moves from @nestjs/axios + form-data to FileHarborClient (@heyatom/client/fileharbor), one client per call (endpoint and API key are per tenant, so not the global Nest module). FileHarborService keeps its policy: MIME/size checks, endpoint check, id extraction, 404 on delete = already deleted.
• Mapping: POST {endpoint}/images (form description, creatorId) → uploadImage(file, { description }, { userId }) → .data.fullPath (FileHarbor's new { data } envelope); DELETE {endpoint}/images/:id → deleteImage(id); error.response?.status === 404 → HeyAtomHttpError.status === 404.
• The old axios options were deliberate, so the client gets fileHarborFetch: no redirects (redirect: 'manual', the tenant key never follows a Location) and a 1 MB response cap; timeouts stay 15 s (delete) / 30 s (upload). Their test moves from webhook-http.spec.ts into fileharbor.service.spec.ts.
• Removed: fileharbor/dto/file-harbor.dto.ts, webhook/webhook-http.spec.ts, deps @nestjs/axios, axios, form-data. No env change (Articuno never had FILEHARBOR_URL / FILEHARBOR_API_KEY).
• @heyatom/client is file:/Users/atombolato/Developer/heyatom/heyatom-client until the W4 release: CI cannot install it, red until then (expected).

Note: the branch also carries 6536961 docs(brand): add Articuno logo kit, which was already on it and is not on develop.

🤖 Generated with Claude Code