PR_26177_CHARLIE_010-sprites-api-db-foundation

[ToolboxAid]

Summary

• Adds the server-side Sprites Postgres service and /api/sprites/records contract.
• Adds grouped Sprites DDL/DML/seed database artifacts.
• Registers Sprites product tables in provider/database snapshot metadata.
• Adds targeted service and Local API contract tests.

Contract

• GET /api/sprites/records
• GET /api/sprites/records/:key
• POST /api/sprites/records
• POST /api/sprites/records/:key
• POST /api/sprites/records/:key/archive
• POST /api/sprites/records/:key/delete

Guest reads are allowed. Writes require a signed-in server API session actor. The server owns ULID keys and audit fields. Sprites stores Palette/Colors key references only through paletteColorKeys and rejects reusable color-definition payloads.

Validation

• PASS: node ./scripts/run-node-test-files.mjs tests/dev-runtime/SpritesPostgresService.test.mjs tests/api/sprites/contract.test.mjs
• PASS: git diff --check
• PASS: no start_of_day changes.
• PASS: no UI changes.
• Playwright impacted: No.
• Note: tests/dev-runtime/SupabaseProductDataCutover.test.mjs was attempted twice because product table metadata changed; it timed out before producing a failure payload. Required targeted Sprites API/unit validation passed.

Artifacts

• docs_build/dev/reports/PR_26177_CHARLIE_010-sprites-api-db-foundation.md
• docs_build/dev/reports/PR_26177_CHARLIE_010-sprites-api-db-foundation_branch-validation.md
• docs_build/dev/reports/PR_26177_CHARLIE_010-sprites-api-db-foundation_requirements-checklist.md
• docs_build/dev/reports/PR_26177_CHARLIE_010-sprites-api-db-foundation_validation-lane.md
• docs_build/dev/reports/PR_26177_CHARLIE_010-sprites-api-db-foundation_manual-validation-notes.md
• tmp/PR_26177_CHARLIE_010-sprites-api-db-foundation_delta.zip