Service claw file service

claw-file-service

Rendered from .ai/manifests/ on every publish. Rules for this service: CLAUDE.md · guide: service guide.

Property	Value
Directory	apps/claw-file-service
Port	4006
Database	postgresql
Test files	82 (vitest)
Internal packages	@claw/shared-auth, @claw/shared-constants, @claw/shared-entitlements, @claw/shared-rabbitmq, @claw/shared-types, @claw/shared-utilities

Persistence models

• File
• FileChunk
• PublishedArtifact

HTTP API (35)

Method	Route	Source
GET	/artifacts	artifacts.controller.ts
POST	/artifacts	artifacts.controller.ts
DELETE	/artifacts/:id	artifacts.controller.ts
GET	/files	files.controller.ts
DELETE	/files/:id	files.controller.ts
GET	/files/:id	files.controller.ts
GET	/files/:id/archive-entries	file-archive.controller.ts
POST	/files/:id/archive-password	file-archive.controller.ts
GET	/files/:id/chunks	files.controller.ts
POST	/files/:id/processing/cancel	files.controller.ts
GET	/files/download/:id	files.controller.ts
POST	/files/extract-text	files.controller.ts
POST	/files/upload	files.controller.ts
DELETE	/files/upload/chunked/:uploadId	files.controller.ts
POST	/files/upload/chunked/:uploadId/chunks/:index	files.controller.ts
POST	/files/upload/chunked/:uploadId/complete	files.controller.ts
GET	/files/upload/chunked/:uploadId/status	files.controller.ts
POST	/files/upload/chunked/init	files.controller.ts
GET	/health	health.controller.ts
DELETE	/internal/files/:id	files-internal.controller.ts
GET	/internal/files/:id/chunks	files-internal.controller.ts
GET	/internal/files/:id/content	files-internal.controller.ts
GET	/internal/files/:id/ingestion-state	files-internal.controller.ts
POST	/internal/files/:id/video-frames	files-internal.controller.ts
GET	/internal/files/download-internal/:id	files-internal.controller.ts
GET	/internal/files/download/:id	files-internal.controller.ts
GET	/internal/files/metadata-internal/:id	files-internal.controller.ts
POST	/internal/files/publish-copy	files-internal.controller.ts
DELETE	/internal/files/published-copy/:id	files-internal.controller.ts
POST	/internal/files/store-generated-audio	files-internal.controller.ts
POST	/internal/files/store-generated-video	files-internal.controller.ts
POST	/internal/files/store-image	files-internal.controller.ts
POST	/internal/files/upload-internal	files-internal.controller.ts
GET	/metrics	metrics.controller.ts
GET	/public/artifacts/:publicId	public-artifacts.controller.ts

Events (inferred from source; verify before a critical change)

• Publishes: file.archive_expanded, file.chunked, file.deleted, file.downloaded, file.extraction_failed, file.failed, file.ocr_completed, file.ocr_failed, file.ocr_started, file.retention_expired, file.transcribe_completed, file.transcribe_failed, file.transcribe_requested, file.upload_completed, file.upload_started, file.uploaded, file.video_process_completed, file.video_process_failed, file.video_process_requested, log.server
• Consumes: none found