@adobe/spacecat-shared-data-access 3.5.0 → 3.6.1

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [@adobe/spacecat-shared-data-access-v3.6.1](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v3.6.0...@adobe/spacecat-shared-data-access-v3.6.1) (2026-03-03)
+
+### Bug Fixes
+
+* stage changes wrt to spacecat-shared ([#1394](https://github.com/adobe/spacecat-shared/issues/1394)) ([7145fb0](https://github.com/adobe/spacecat-shared/commit/7145fb037e5b809d4552889c291b6f8688655b88))
+
+## [@adobe/spacecat-shared-data-access-v3.6.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v3.5.0...@adobe/spacecat-shared-data-access-v3.6.0) (2026-03-02)
+
+### Features
+
+* **data-access:** expose postgrestClient for direct PostgREST queries ([#1396](https://github.com/adobe/spacecat-shared/issues/1396)) ([307711c](https://github.com/adobe/spacecat-shared/commit/307711cfed7a3f2fc15f17afe31a48b21213a8e4))
+
 ## [@adobe/spacecat-shared-data-access-v3.5.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v3.4.2...@adobe/spacecat-shared-data-access-v3.5.0) (2026-03-02)
 
 ### Features

package/CLAUDE.md

@@ -21,7 +21,8 @@ Lambda/ECS service
 | File | Purpose |
 |------|---------|
 | `src/index.js` | Default export: `dataAccessWrapper(fn)` for Helix/Lambda handlers |
-| `src/service/index.js` | `createDataAccess(config, log?, client?)` factory |
+| `src/service/index.js` | `createDataAccess(config, log?, client?)` factory — returns entity collections + `services.postgrestClient` |
+| `src/service/index.d.ts` | `DataAccess` and `DataAccessServices` type definitions |
 | `src/models/base/schema.builder.js` | DSL for defining entity schemas (attributes, references, indexes) |
 | `src/models/base/base.model.js` | Base entity class (auto-generated getters/setters, save, remove) |
 | `src/models/base/base.collection.js` | Base collection class (findById, all, query, count) |
@@ -152,6 +153,22 @@ npm run test:it
 - PostgREST calls are stubbed via sinon
 - Each entity model and collection has its own test file
 
+## Direct PostgREST Queries
+
+`dataAccess.services.postgrestClient` exposes the raw `@supabase/postgrest-js` `PostgrestClient` for querying tables that don't have entity models (e.g. analytics views, reporting tables):
+
+```js
+const { postgrestClient } = context.dataAccess.services;
+
+const { data, error } = await postgrestClient
+  .from('brand_presence_executions')
+  .select('*')
+  .eq('site_id', siteId)
+  .limit(100);
+```
+
+This is the same client instance used internally by entity collections — same URL, auth, and schema.
+
 ## Common Patterns
 
 ### Collection query with WHERE clause

package/README.md

@@ -16,9 +16,10 @@ npm install @adobe/spacecat-shared-data-access
 ## What You Get
 
 The package provides:
-- `createDataAccess(config, log?, client?)`
+- `createDataAccess(config, log?, client?)` — returns entity collections + `services.postgrestClient`
 - `dataAccessWrapper(fn)` (default export) for Helix/Lambda style handlers
 - Entity collections/models with stable external API shape for services
+- `services.postgrestClient` for direct PostgREST queries against non-entity tables
 
 ## Quick Start
 
@@ -89,6 +90,29 @@ The wrapper reads from `context.env`:
 - `S3_CONFIG_BUCKET`
 - `AWS_REGION`
 
+## Direct PostgREST Queries
+
+For querying PostgREST tables that are not modeled as entities (e.g. analytics views, reporting tables), the `postgrestClient` is available under `dataAccess.services`:
+
+```js
+const { Site } = dataAccess;                             // entity collections
+const { postgrestClient } = dataAccess.services;         // raw PostgREST client
+
+// Use entity collections as usual
+const site = await Site.findById(siteId);
+
+// 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);
+```
+
+This is the same `@supabase/postgrest-js` `PostgrestClient` instance used internally by the entity collections. Full IDE autocomplete is available for the query builder chain.
+
 ## Field Mapping Behavior
 
 Public model API remains camelCase while Postgres/PostgREST tables are snake_case.
@@ -383,7 +407,10 @@ export MYSTICAT_DATA_SERVICE_REPOSITORY=682033462621.dkr.ecr.us-east-1.amazonaws
 
 Type definitions are shipped from:
 - `src/index.d.ts`
-- `src/models/**/index.d.ts`
+- `src/service/index.d.ts` — `DataAccess` and `DataAccessServices` interfaces
+- `src/models/**/index.d.ts` — per-entity collection and model interfaces
+
+The `DataAccess` interface provides full typing for all entity collections and `services.postgrestClient` (typed as `PostgrestClient` from `@supabase/postgrest-js`).
 
 Use the package directly in TS projects; no extra setup required.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spacecat-shared-data-access",
-  "version": "3.5.0",
+  "version": "3.6.1",
   "description": "Shared modules of the Spacecat Services - Data Access",
   "type": "module",
   "engines": {

package/src/index.d.ts

@@ -13,3 +13,4 @@
 export type * from './errors';
 export type * from './models';
 export type * from './util';
+export type { DataAccess } from './service';

package/src/models/index.d.ts

@@ -10,31 +10,36 @@
  * governing permissions and limitations under the License.
  */
 
-export type * from './audit';
+export type * from './api-key';
 export type * from './async-job';
-export type * from './configuration';
+export type * from './audit';
+export type * from './audit-url';
 export type * from './base';
+export type * from './configuration';
 export type * from './consumer';
+export type * from './entitlement';
+export type * from './experiment';
 export type * from './fix-entity';
 export type * from './fix-entity-suggestion';
-export type * from './experiment';
-export type * from './entitlement';
 export type * from './import-job';
 export type * from './import-url';
 export type * from './key-event';
 export type * from './latest-audit';
 export type * from './opportunity';
 export type * from './organization';
+export type * from './page-citability';
+export type * from './page-intent';
+export type * from './project';
+export type * from './report';
 export type * from './scrape-job';
 export type * from './scrape-url';
+export type * from './sentiment-guideline';
+export type * from './sentiment-topic';
 export type * from './site';
 export type * from './site-candidate';
 export type * from './site-enrollment';
 export type * from './site-top-form';
 export type * from './site-top-page';
 export type * from './suggestion';
-export type * from './report';
 export type * from './trial-user';
-export type * from './trial-user-activity';
-export type * from './sentiment-guideline';
-export type * from './sentiment-topic';
+export type * from './trial-user-activity';

package/src/models/site/config.js

@@ -344,6 +344,12 @@ export const configSchema = Joi.object({
   edgeOptimizeConfig: Joi.object({
     enabled: Joi.boolean().optional(),
     opted: Joi.number().optional(),
+    stagingDomains: Joi.array().items(
+      Joi.object({
+        domain: Joi.string().required(),
+        id: Joi.string().required(),
+      }),
+    ).optional(),
   }).optional(),
   contentAiConfig: Joi.object({
     index: Joi.string().optional(),

package/src/service/index.d.ts

@@ -10,6 +10,41 @@
  * governing permissions and limitations under the License.
  */
 
+import type PostgrestClient from '@supabase/postgrest-js/dist/cjs/PostgrestClient';
+
+import type { ApiKeyCollection } from '../models/api-key';
+import type { AsyncJobCollection } from '../models/async-job';
+import type { AuditCollection } from '../models/audit';
+import type { AuditUrlCollection } from '../models/audit-url';
+import type { ConfigurationCollection } from '../models/configuration';
+import type { ConsumerCollection } from '../models/consumer';
+import type { EntitlementCollection } from '../models/entitlement';
+import type { ExperimentCollection } from '../models/experiment';
+import type { FixEntityCollection } from '../models/fix-entity';
+import type { FixEntitySuggestionCollection } from '../models/fix-entity-suggestion';
+import type { ImportJobCollection } from '../models/import-job';
+import type { ImportUrlCollection } from '../models/import-url';
+import type { KeyEventCollection } from '../models/key-event';
+import type { LatestAuditCollection } from '../models/latest-audit';
+import type { OpportunityCollection } from '../models/opportunity';
+import type { OrganizationCollection } from '../models/organization';
+import type { PageCitabilityCollection } from '../models/page-citability';
+import type { PageIntentCollection } from '../models/page-intent';
+import type { ProjectCollection } from '../models/project';
+import type { ReportCollection } from '../models/report';
+import type { ScrapeJobCollection } from '../models/scrape-job';
+import type { ScrapeUrlCollection } from '../models/scrape-url';
+import type { SentimentGuidelineCollection } from '../models/sentiment-guideline';
+import type { SentimentTopicCollection } from '../models/sentiment-topic';
+import type { SiteCollection } from '../models/site';
+import type { SiteCandidateCollection } from '../models/site-candidate';
+import type { SiteEnrollmentCollection } from '../models/site-enrollment';
+import type { SiteTopFormCollection } from '../models/site-top-form';
+import type { SiteTopPageCollection } from '../models/site-top-page';
+import type { SuggestionCollection } from '../models/suggestion';
+import type { TrialUserCollection } from '../models/trial-user';
+import type { TrialUserActivityCollection } from '../models/trial-user-activity';
+
 interface DataAccessConfig {
   postgrestUrl: string;
   postgrestSchema?: string;
@@ -19,8 +54,48 @@ interface DataAccessConfig {
   region?: string;
 }
 
+export interface DataAccessServices {
+  postgrestClient: PostgrestClient;
+}
+
+export interface DataAccess {
+  services: DataAccessServices;
+  ApiKey: ApiKeyCollection;
+  AsyncJob: AsyncJobCollection;
+  Audit: AuditCollection;
+  AuditUrl: AuditUrlCollection;
+  Configuration: ConfigurationCollection;
+  Consumer: ConsumerCollection;
+  Entitlement: EntitlementCollection;
+  Experiment: ExperimentCollection;
+  FixEntity: FixEntityCollection;
+  FixEntitySuggestion: FixEntitySuggestionCollection;
+  ImportJob: ImportJobCollection;
+  ImportUrl: ImportUrlCollection;
+  KeyEvent: KeyEventCollection;
+  LatestAudit: LatestAuditCollection;
+  Opportunity: OpportunityCollection;
+  Organization: OrganizationCollection;
+  PageCitability: PageCitabilityCollection;
+  PageIntent: PageIntentCollection;
+  Project: ProjectCollection;
+  Report: ReportCollection;
+  ScrapeJob: ScrapeJobCollection;
+  ScrapeUrl: ScrapeUrlCollection;
+  SentimentGuideline: SentimentGuidelineCollection;
+  SentimentTopic: SentimentTopicCollection;
+  Site: SiteCollection;
+  SiteCandidate: SiteCandidateCollection;
+  SiteEnrollment: SiteEnrollmentCollection;
+  SiteTopForm: SiteTopFormCollection;
+  SiteTopPage: SiteTopPageCollection;
+  Suggestion: SuggestionCollection;
+  TrialUser: TrialUserCollection;
+  TrialUserActivity: TrialUserActivityCollection;
+}
+
 export function createDataAccess(
   config: DataAccessConfig,
   logger: object,
   client?: object,
-): object;
+): DataAccess;

package/src/service/index.js

@@ -98,5 +98,10 @@ export const createDataAccess = (config, log = console, client = undefined) => {
   const services = createServices(postgrestService, config);
   const entityRegistry = new EntityRegistry(services, config, log);
 
-  return entityRegistry.getCollections();
+  return {
+    ...entityRegistry.getCollections(),
+    services: {
+      postgrestClient: postgrestService,
+    },
+  };
 };