feat(data-access): expose postgrestClient for direct PostgREST queries

[ekremney]

Summary

• Exposes the underlying PostgrestClient instance under a services namespace on the object returned by createDataAccess(), enabling direct PostgREST queries against tables that are not modeled as entities (e.g. analytics views, brand presence tables)
• Adds full TypeScript typings for all 32 entity collections on the DataAccess interface (previously typed as object)
• Re-exports 5 previously missing collection types from models/index.d.ts (ApiKey, AuditUrl, PageCitability, PageIntent, Project)

Motivation

Some API endpoints need to query PostgREST tables that don't have corresponding entity models in the data-access layer (e.g. brand_presence_executions, brand_metrics_weekly). Previously, developers resorted to reaching into collection internals like Site.postgrestService to get the raw client. This change makes it a first-class, typed API under a services namespace that cleanly separates infrastructure from entity collections.

Usage

// Entity collections stay top-level
const { Site, Organization } = context.dataAccess;
const site = await Site.findById(siteId);

// Infrastructure services live under the services namespace
const { postgrestClient } = context.dataAccess.services;

// Direct queries against non-entity tables
const { data, error } = await postgrestClient
  .from('brand_presence_executions')
  .select('execution_date, visibility_score, sentiment')
  .eq('site_id', siteId)
  .gte('execution_date', '2025-01-01')
  .order('execution_date', { ascending: false })
  .limit(100);

Full IDE autocomplete is available for the entire PostgREST query builder chain (.from(), .select(), .eq(), .gte(), .order(), .range(), .rpc(), etc.).

Test plan

• Existing unit tests updated to verify services.postgrestClient is present and is the correct instance
• All 1522 unit tests passing
• Lint passing

🤖 Generated with Claude Code

[github-actions]

This PR will trigger a minor release when merged.

[solaris007]

🎉 This PR is included in version @adobe/spacecat-shared-data-access-v3.6.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀