@adobe/spacecat-shared-data-access 3.46.0 → 3.48.0

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+## [@adobe/spacecat-shared-data-access-v3.48.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v3.47.0...@adobe/spacecat-shared-data-access-v3.48.0) (2026-04-08)
+
+### Features
+
+* **data-access:** add INACTIVE status, reviews field, and REVIEW_DECISIONS to PlgOnboarding ([#1516](https://github.com/adobe/spacecat-shared/issues/1516)) ([8f038e9](https://github.com/adobe/spacecat-shared/commit/8f038e93287da51acf0e586f3e786aeb00d4a0d3))
+
+## [@adobe/spacecat-shared-data-access-v3.47.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v3.46.0...@adobe/spacecat-shared-data-access-v3.47.0) (2026-04-07)
+
+### Features
+
+* add PRE_ONBOARD tier to entitlement model ([#1514](https://github.com/adobe/spacecat-shared/issues/1514)) ([bc4e8f3](https://github.com/adobe/spacecat-shared/commit/bc4e8f36549ab1fe6a03d39d7dec6b4b1f67d229))
+
+### Bug Fixes
+
+* **data-access:** remove stale ElectroDB/DynamoDB v2 references ([#1509](https://github.com/adobe/spacecat-shared/issues/1509)) ([ddd180f](https://github.com/adobe/spacecat-shared/commit/ddd180fb5350a14a04583f7c55f89873ed3a3929))
+* update geo experiment schema for experimentation engine ([#1512](https://github.com/adobe/spacecat-shared/issues/1512)) ([58315cd](https://github.com/adobe/spacecat-shared/commit/58315cd973c373b399429bf11ff1b958d3cfe9c8))
+
 ## [@adobe/spacecat-shared-data-access-v3.46.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v3.45.2...@adobe/spacecat-shared-data-access-v3.46.0) (2026-04-07)
 
 ### Features

package/README.md

@@ -1,11 +1,9 @@
-# Spacecat Shared Data Access (v3)
+# Spacecat Shared Data Access
 
 `@adobe/spacecat-shared-data-access` is the shared data-access layer used by Spacecat services.
 
-This package is **v3 Postgres-first**:
 - Primary datastore: **Postgres via PostgREST** (`@supabase/postgrest-js`)
 - Optional secondary datastore: **S3** (for `Configuration`)
-- No ElectroDB/DynamoDB runtime dependency in v3 behavior
 
 ## Installation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spacecat-shared-data-access",
-  "version": "3.46.0",
+  "version": "3.48.0",
   "description": "Shared modules of the Spacecat Services - Data Access",
   "type": "module",
   "engines": {
@@ -10,9 +10,9 @@
   "main": "src/index.js",
   "types": "src/index.d.ts",
   "scripts": {
-    "test:it": "npm run test:it:legacy && npm run test:it:postgrest",
-    "test:it:legacy": "IT_SEED_MODE=none mocha --require ./test/it/fixtures.js --spec \"test/it/**/*.test.js\" --ignore \"test/it/postgrest/**/*.test.js\"",
-    "test:it:postgrest": "IT_SEED_MODE=tenant-sql mocha --require ./test/it/fixtures.js --spec \"test/it/postgrest/**/*.test.js\"",
+    "test:it": "npm run test:it:self-seeded && npm run test:it:tenant-seeded",
+    "test:it:self-seeded": "IT_SEED_MODE=none mocha --require ./test/it/fixtures.js --spec \"test/it/**/*.test.js\" --ignore \"test/it/postgrest/**/*.test.js\"",
+    "test:it:tenant-seeded": "IT_SEED_MODE=tenant-sql mocha --require ./test/it/fixtures.js --spec \"test/it/postgrest/**/*.test.js\"",
     "test": "c8 mocha --spec \"test/unit/**/*.test.js\"",
     "test:debug": "mocha --inspect-brk --require ./test/setup-env.js --spec \"test/unit/**/*.test.js\"",
     "test:debug:config": "mocha --inspect-brk --require ./test/setup-env.js --spec \"test/unit/models/site/config.test.js\"",

package/src/models/api-key/api-key.schema.js

@@ -18,12 +18,6 @@ import SchemaBuilder from '../base/schema.builder.js';
 import ApiKey from './api-key.model.js';
 import ApiKeyCollection from './api-key.collection.js';
 
-/*
-Schema Doc: https://electrodb.dev/en/modeling/schema/
-Attribute Doc: https://electrodb.dev/en/modeling/attributes/
-Indexes Doc: https://electrodb.dev/en/modeling/indexes/
- */
-
 const schema = new SchemaBuilder(ApiKey, ApiKeyCollection)
   .addAttribute('hashedApiKey', {
     type: 'string',

package/src/models/audit/audit.schema.js

@@ -18,12 +18,6 @@ import SchemaBuilder from '../base/schema.builder.js';
 import Audit from './audit.model.js';
 import AuditCollection from './audit.collection.js';
 
-/*
-Schema Doc: https://electrodb.dev/en/modeling/schema/
-Attribute Doc: https://electrodb.dev/en/modeling/attributes/
-Indexes Doc: https://electrodb.dev/en/modeling/indexes/
- */
-
 const schema = new SchemaBuilder(Audit, AuditCollection)
   .addReference('belongs_to', 'Site', ['auditType', 'auditedAt'])
   .addReference('has_one', 'LatestAudit', ['auditType'], { required: false })
@@ -35,7 +29,7 @@ const schema = new SchemaBuilder(Audit, AuditCollection)
     required: true,
     validate: (value) => isNonEmptyObject(value) || isArray(value),
     set: (value, attributes) => {
-      // as the electroDb validate function does not provide access to the model instance
+      // as the validate function does not provide access to the model instance
       // we need to call the validate function from the model on setting the value
       Audit.validateAuditResult(value, attributes.auditType);
       return value;

package/src/models/audit-url/audit-url.model.js

@@ -79,7 +79,7 @@ class AuditUrl extends BaseModel {
 
   /**
    * Generates the composite keys for the AuditUrl model.
-   * Required for ElectroDB operations with composite primary key (siteId + url).
+   * Required for operations with composite primary key (siteId + url).
    * @returns {Object} - The composite keys.
    */
   generateCompositeKeys() {

package/src/models/audit-url/audit-url.schema.js

@@ -19,10 +19,6 @@ import AuditUrl from './audit-url.model.js';
 import AuditUrlCollection from './audit-url.collection.js';
 
 /*
-Schema Doc: https://electrodb.dev/en/modeling/schema/
-Attribute Doc: https://electrodb.dev/en/modeling/attributes/
-Indexes Doc: https://electrodb.dev/en/modeling/indexes/
-
 Data Access Patterns:
 1. Get all URLs for a site: allBySiteId(siteId)
 2. Get all URLs for a site by byCustomer: allBySiteIdAndByCustomer(siteId, byCustomer) - uses GSI

package/src/models/base/entity.registry.js

@@ -172,7 +172,7 @@ class EntityRegistry {
 
   static getEntities() {
     return Object.keys(this.entities).reduce((acc, key) => {
-      acc[key] = this.entities[key].schema.toElectroDBSchema();
+      acc[key] = this.entities[key].schema.toSchema();
       return acc;
     }, {});
   }
@@ -186,7 +186,7 @@ class EntityRegistry {
   }
 }
 
-// Register ElectroDB-based entities only (Configuration is handled separately)
+// Register entities (Configuration is handled separately via S3)
 EntityRegistry.registerEntity(ApiKeySchema, ApiKeyCollection);
 EntityRegistry.registerEntity(AsyncJobSchema, AsyncJobCollection);
 EntityRegistry.registerEntity(ContactSalesLeadSchema, ContactSalesLeadCollection);

package/src/models/base/index.d.ts

@@ -121,7 +121,7 @@ export interface Schema {
   getServiceName(): string;
   getVersion(): number;
   toAccessorConfigs(): object[];
-  toElectroDBSchema(): object;
+  toSchema(): object;
 }
 
 export interface SchemaBuilder {

package/src/models/base/schema.builder.js

@@ -39,9 +39,7 @@ const ID_ATTRIBUTE_DATA = {
   postgrestField: 'id',
   required: true,
   readOnly: true,
-  // https://electrodb.dev/en/modeling/attributes/#default
   default: () => crypto.randomUUID(),
-  // https://electrodb.dev/en/modeling/attributes/#attribute-validation
   validate: (value) => isValidUUID(value),
 };
 
@@ -141,7 +139,7 @@ class SchemaBuilder {
     // will be populated by build() from rawIndexes
     this.indexes = {};
 
-    // this is not part of the ElectroDB schema spec, but we use it to store reference data
+    // this is not part of the standard schema spec, but we use it to store reference data
     this.references = [];
 
     this.#initialize();

package/src/models/base/schema.js

@@ -365,12 +365,12 @@ class Schema {
   }
 
   /**
-   * Transforms the stored schema model into a format directly usable by ElectroDB.
+   * Transforms the stored schema model into a serializable format.
    * Here, you could do any final adjustments or transformations needed before returning.
    *
-   * @returns {object} ElectroDB-compatible schema.
+   * @returns {object} Serialized schema.
    */
-  toElectroDBSchema() {
+  toSchema() {
     return {
       model: {
         entity: this.getModelName(),

package/src/models/configuration/configuration.collection.js

@@ -24,7 +24,7 @@ const S3_CONFIG_KEY = 'config/spacecat/global-config.json';
 
 /**
  * ConfigurationCollection - A standalone collection class for managing Configuration entities.
- * Unlike other collections, this does not use ElectroDB or DynamoDB.
+ * Unlike other collections, this uses S3 instead of PostgREST.
  * Configuration is stored as a versioned JSON object in S3.
  *
  * @class ConfigurationCollection

package/src/models/configuration/configuration.model.js

@@ -18,7 +18,7 @@ import { Entitlement } from '../entitlement/index.js';
 /**
  * Configuration - A standalone class representing the global Configuration entity.
  * This is a singleton entity stored in S3 with versioning.
- * Unlike other entities, Configuration does not use ElectroDB or DynamoDB.
+ * Unlike other entities, Configuration uses S3 instead of PostgREST.
  *
  * @class Configuration
  */

package/src/models/configuration/configuration.schema.js

@@ -13,7 +13,7 @@
 /**
  * Configuration Schema
  *
- * Unlike other entities, Configuration does not use ElectroDB and is stored in S3.
+ * Unlike other entities, Configuration is stored in S3 instead of PostgREST.
  * Validation is handled by Joi schemas defined below.
  */
 

package/src/models/consumer/consumer.schema.js

@@ -16,12 +16,6 @@ import SchemaBuilder from '../base/schema.builder.js';
 import Consumer from './consumer.model.js';
 import ConsumerCollection from './consumer.collection.js';
 
-/*
-Schema Doc: https://electrodb.dev/en/modeling/schema/
-Attribute Doc: https://electrodb.dev/en/modeling/attributes/
-Indexes Doc: https://electrodb.dev/en/modeling/indexes/
- */
-
 const schema = new SchemaBuilder(Consumer, ConsumerCollection)
   .addAttribute('clientId', {
     type: 'string',

package/src/models/entitlement/entitlement.model.js

@@ -26,6 +26,7 @@ class Entitlement extends BaseModel {
     FREE_TRIAL: 'FREE_TRIAL',
     PAID: 'PAID',
     PLG: 'PLG',
+    PRE_ONBOARD: 'PRE_ONBOARD',
   };
 
   static PRODUCT_CODES = {

package/src/models/entitlement/entitlement.schema.js

@@ -14,12 +14,6 @@ import SchemaBuilder from '../base/schema.builder.js';
 import Entitlement from './entitlement.model.js';
 import EntitlementCollection from './entitlement.collection.js';
 
-/*
-Schema Doc: https://electrodb.dev/en/modeling/schema/
-Attribute Doc: https://electrodb.dev/en/modeling/attributes/
-Indexes Doc: https://electrodb.dev/en/modeling/indexes/
- */
-
 const schema = new SchemaBuilder(Entitlement, EntitlementCollection)
   // Reference to Organization (many-to-one relationship)
   .addReference('belongs_to', 'Organization')

package/src/models/entitlement/index.d.ts

@@ -15,7 +15,7 @@ import type {
 } from '../index';
 
 export type EntitlementStatus = 'ACTIVE' | 'SUSPENDED' | 'ENDED';
-export type EntitlementTier = 'FREE_TRIAL' | 'PAID' | 'PLG';
+export type EntitlementTier = 'FREE_TRIAL' | 'PAID' | 'PLG' | 'PRE_ONBOARD';
 export type EntitlementProductCode = 'LLMO' | 'ASO' | 'ACO';
 
 export interface Entitlement extends BaseModel {

package/src/models/experiment/experiment.schema.js

@@ -20,12 +20,6 @@ import SchemaBuilder from '../base/schema.builder.js';
 import Experiment from './experiment.model.js';
 import ExperimentCollection from './experiment.collection.js';
 
-/*
-Schema Doc: https://electrodb.dev/en/modeling/schema/
-Attribute Doc: https://electrodb.dev/en/modeling/attributes/
-Indexes Doc: https://electrodb.dev/en/modeling/indexes/
- */
-
 const schema = new SchemaBuilder(Experiment, ExperimentCollection)
   .addReference('belongs_to', 'Site', ['expId', 'url', 'updatedAt'])
   .addAttribute('conversionEventName', {

package/src/models/fix-entity/fix-entity.schema.js

@@ -17,12 +17,6 @@ import FixEntity from './fix-entity.model.js';
 import FixEntityCollection from './fix-entity.collection.js';
 import Suggestion from '../suggestion/suggestion.model.js';
 
-/*
-Schema Doc: https://electrodb.dev/en/modeling/schema/
-Attribute Doc: https://electrodb.dev/en/modeling/attributes/
-Indexes Doc: https://electrodb.dev/en/modeling/indexes/
- */
-
 const schema = new SchemaBuilder(FixEntity, FixEntityCollection)
   .addReference('has_many', 'FixEntitySuggestion', ['updatedAt'], { removeDependents: true })
   .addReference('belongs_to', 'Opportunity', ['status'])

package/src/models/fix-entity-suggestion/fix-entity-suggestion.schema.js

@@ -14,12 +14,6 @@ import SchemaBuilder from '../base/schema.builder.js';
 import FixEntitySuggestion from './fix-entity-suggestion.model.js';
 import FixEntitySuggestionCollection from './fix-entity-suggestion.collection.js';
 
-/*
-Schema Doc: https://electrodb.dev/en/modeling/schema/
-Attribute Doc: https://electrodb.dev/en/modeling/attributes/
-Indexes Doc: https://electrodb.dev/en/modeling/indexes/
- */
-
 const schema = new SchemaBuilder(FixEntitySuggestion, FixEntitySuggestionCollection)
   .withPrimaryPartitionKeys(['suggestionId'])
   .withPrimarySortKeys(['fixEntityId'])

package/src/models/geo-experiment/geo-experiment.collection.js

@@ -12,6 +12,7 @@
 
 import { hasText } from '@adobe/spacecat-shared-utils';
 import BaseCollection from '../base/base.collection.js';
+import GeoExperiment from './geo-experiment.model.js';
 
 class GeoExperimentCollection extends BaseCollection {
   static COLLECTION_NAME = 'GeoExperimentCollection';
@@ -38,6 +39,27 @@ class GeoExperimentCollection extends BaseCollection {
       cursor: result.cursor,
     };
   }
+
+  /**
+   * Gets all geo experiments that are currently active (GENERATING_BASELINE or IN_PROGRESS).
+   * Used by the experimentation engine to discover which experiments to process on each cron tick.
+   *
+   * @param {object} [options={}] - Query options (limit, cursor, order).
+   * @returns {Promise<GeoExperiment[]>} Array of active experiments.
+   */
+  async allActive(options = {}) {
+    const activeStatuses = [
+      GeoExperiment.STATUSES.GENERATING_BASELINE,
+      GeoExperiment.STATUSES.IN_PROGRESS,
+    ];
+    return this.all(
+      {},
+      {
+        ...options,
+        where: (attrs, op) => op.in(attrs.status, activeStatuses),
+      },
+    );
+  }
 }
 
 export default GeoExperimentCollection;

package/src/models/geo-experiment/geo-experiment.model.js

@@ -29,13 +29,47 @@ class GeoExperiment extends BaseModel {
   };
 
   static PHASES = {
-    PRE_ANALYSIS_SUBMITTED: 'pre_analysis_submitted',
+    PRE_ANALYSIS_STARTED: 'pre_analysis_started',
     PRE_ANALYSIS_DONE: 'pre_analysis_done',
     DEPLOYMENT_STARTED: 'deployment_started',
-    DEPLOYMENT_COMPLETED: 'deployment_completed',
-    POST_ANALYSIS_SUBMITTED: 'post_analysis_submitted',
+    DEPLOYMENT_DONE: 'deployment_done',
+    POST_ANALYSIS_STARTED: 'post_analysis_started',
     POST_ANALYSIS_DONE: 'post_analysis_done',
   };
+
+  /**
+   * Name of the environment variable that holds per-strategy schedule configuration.
+   * The value is a JSON string keyed by strategy type, each with 'pre' and 'post' phase configs.
+   * Both the API service (writes config into experiment metadata) and the experimentation engine
+   * (reads config from metadata) reference this constant so the name stays in sync.
+   *
+   * @type {string}
+   */
+  static SCHEDULE_CONFIG_ENV_VAR = 'EXPERIMENT_SCHEDULE_CONFIG';
+
+  /**
+   * Well-known keys used within a GeoExperiment's metadata object.
+   * Centralised here so all consumers reference the same key names.
+   *
+   * @type {{ SCHEDULE_CONFIG: string }}
+   */
+  static METADATA_KEYS = {
+    SCHEDULE_CONFIG: 'scheduleConfig',
+  };
+
+  /**
+   * Field names within a schedule config block (pre or post phase).
+   * Both the API service (writes) and the experimentation engine (reads) import
+   * these so a rename in one place propagates automatically to the other.
+   *
+   * @type {{ CRON_EXPRESSION: string, EXPIRY_MS: string, PLATFORMS: string, PROVIDER_IDS: string }}
+   */
+  static SCHEDULE_CONFIG_KEYS = {
+    CRON_EXPRESSION: 'cronExpression',
+    EXPIRY_MS: 'expiryMs',
+    PLATFORMS: 'platforms',
+    PROVIDER_IDS: 'providerIds',
+  };
 }
 
 export default GeoExperiment;

package/src/models/geo-experiment/geo-experiment.schema.js

@@ -43,8 +43,9 @@ const schema = new SchemaBuilder(GeoExperiment, GeoExperimentCollection)
     required: true,
   })
   .addAttribute('phase', {
-    type: Object.values(GeoExperiment.PHASES),
+    type: 'string',
     required: true,
+    validate: (value) => hasText(value),
   })
   .addAttribute('suggestionIds', {
     type: 'list',

package/src/models/geo-experiment/index.d.ts

@@ -68,4 +68,5 @@ export interface GeoExperimentCollection extends BaseCollection<GeoExperiment> {
     opportunityId: string,
     options?: QueryOptions,
   ): Promise<GeoExperiment | null>;
+  allActive(options?: QueryOptions): Promise<GeoExperiment[]>;
 }

package/src/models/import-job/import-job.schema.js

@@ -72,12 +72,6 @@ const validateOptions = (options) => {
   return true;
 };
 
-/*
-Schema Doc: https://electrodb.dev/en/modeling/schema/
-Attribute Doc: https://electrodb.dev/en/modeling/attributes/
-Indexes Doc: https://electrodb.dev/en/modeling/indexes/
- */
-
 const schema = new SchemaBuilder(ImportJob, ImportJobCollection)
   .addReference('has_many', 'ImportUrls')
   .addAttribute('baseURL', {

package/src/models/import-url/import-url.schema.js

@@ -19,12 +19,6 @@ import ImportUrl from './import-url.model.js';
 import ImportUrlCollection from './import-url.collection.js';
 import { ImportJob } from '../import-job/index.js';
 
-/*
-Schema Doc: https://electrodb.dev/en/modeling/schema/
-Attribute Doc: https://electrodb.dev/en/modeling/attributes/
-Indexes Doc: https://electrodb.dev/en/modeling/indexes/
- */
-
 const schema = new SchemaBuilder(ImportUrl, ImportUrlCollection)
   .withRecordExpiry(ImportUrl.IMPORT_URL_EXPIRES_IN_DAYS)
   .addReference('belongs_to', 'ImportJob', ['status'])

package/src/models/key-event/key-event.schema.js

@@ -18,12 +18,6 @@ import SchemaBuilder from '../base/schema.builder.js';
 import KeyEvent from './key-event.model.js';
 import KeyEventCollection from './key-event.collection.js';
 
-/*
-Schema Doc: https://electrodb.dev/en/modeling/schema/
-Attribute Doc: https://electrodb.dev/en/modeling/attributes/
-Indexes Doc: https://electrodb.dev/en/modeling/indexes/
- */
-
 const schema = new SchemaBuilder(KeyEvent, KeyEventCollection)
   .addReference('belongs_to', 'Site', ['time'])
   .addAttribute('name', {

package/src/models/latest-audit/latest-audit.schema.js

@@ -19,12 +19,6 @@ import SchemaBuilder from '../base/schema.builder.js';
 import LatestAudit from './latest-audit.model.js';
 import LatestAuditCollection from './latest-audit.collection.js';
 
-/*
-Schema Doc: https://electrodb.dev/en/modeling/schema/
-Attribute Doc: https://electrodb.dev/en/modeling/attributes/
-Indexes Doc: https://electrodb.dev/en/modeling/indexes/
- */
-
 const schema = new SchemaBuilder(LatestAudit, LatestAuditCollection)
   .withPrimaryPartitionKeys(['siteId'])
   .withPrimarySortKeys(['auditType'])
@@ -39,7 +33,7 @@ const schema = new SchemaBuilder(LatestAudit, LatestAuditCollection)
     required: true,
     validate: (value) => isNonEmptyObject(value) || isArray(value),
     set: (value, attributes) => {
-      // as the electroDb validate function does not provide access to the model instance
+      // as the validate function does not provide access to the model instance
       // we need to call the validate function from the model on setting the value
       Audit.validateAuditResult(value, attributes.auditType);
       return value;

package/src/models/opportunity/opportunity.schema.js

@@ -18,12 +18,6 @@ import SchemaBuilder from '../base/schema.builder.js';
 import Opportunity from './opportunity.model.js';
 import OpportunityCollection from './opportunity.collection.js';
 
-/*
-Schema Doc: https://electrodb.dev/en/modeling/schema/
-Attribute Doc: https://electrodb.dev/en/modeling/attributes/
-Indexes Doc: https://electrodb.dev/en/modeling/indexes/
- */
-
 const schema = new SchemaBuilder(Opportunity, OpportunityCollection)
   .addReference('belongs_to', 'Site', ['status', 'updatedAt'])
   .addReference('belongs_to', 'Audit', ['updatedAt'], { required: false })

package/src/models/organization/organization.schema.js

@@ -19,12 +19,6 @@ import SchemaBuilder from '../base/schema.builder.js';
 import Organization from './organization.model.js';
 import OrganizationCollection from './organization.collection.js';
 
-/*
-Schema Doc: https://electrodb.dev/en/modeling/schema/
-Attribute Doc: https://electrodb.dev/en/modeling/attributes/
-Indexes Doc: https://electrodb.dev/en/modeling/indexes/
- */
-
 const schema = new SchemaBuilder(Organization, OrganizationCollection)
   // this will add an attribute 'organizationId' as well as an index 'byOrganizationId'
   .addReference('has_many', 'Sites')

package/src/models/page-citability/page-citability.schema.js

@@ -16,12 +16,6 @@ import SchemaBuilder from '../base/schema.builder.js';
 import PageCitability from './page-citability.model.js';
 import PageCitabilityCollection from './page-citability.collection.js';
 
-/*
-  Schema: https://electrodb.dev/en/modeling/schema/
-  Attributes: https://electrodb.dev/en/modeling/attributes/
-  Indexes: https://electrodb.dev/en/modeling/indexes/
-*/
-
 const schema = new SchemaBuilder(PageCitability, PageCitabilityCollection)
   // link back to Site entity
   .addReference('belongs_to', 'Site')

package/src/models/page-intent/README.md

@@ -25,7 +25,7 @@ The `PageIntent` entity persists each page’s metadata. Key attributes include:
     - `TRANSACTIONAL`
     - `COMMERCIAL`
 - **`topic`** (string) – arbitrary topic label for the page.
-- **`createdAt`, `updatedAt`** (ISO timestamp) – automatically maintained by ElectroDB.
+- **`createdAt`, `updatedAt`** (ISO timestamp) – automatically maintained by the framework.
 
 ## Best Practices
 

package/src/models/page-intent/page-intent.schema.js

@@ -16,12 +16,6 @@ import SchemaBuilder from '../base/schema.builder.js';
 import PageIntent from './page-intent.model.js';
 import PageIntentCollection from './page-intent.collection.js';
 
-/*
-  Schema: https://electrodb.dev/en/modeling/schema/
-  Attributes: https://electrodb.dev/en/modeling/attributes/
-  Indexes: https://electrodb.dev/en/modeling/indexes/
-*/
-
 const schema = new SchemaBuilder(PageIntent, PageIntentCollection)
   // link back to Site entity
   .addReference('belongs_to', 'Site')

package/src/models/plg-onboarding/index.d.ts

@@ -18,7 +18,18 @@ export type PlgOnboardingStatus =
   | 'ONBOARDED'
   | 'ERROR'
   | 'WAITING_FOR_IP_ALLOWLISTING'
-  | 'WAITLISTED';
+  | 'WAITLISTED'
+  | 'INACTIVE';
+
+export type PlgOnboardingReviewDecision = 'BYPASSED' | 'UPHELD';
+
+export interface PlgOnboardingReview {
+  reason: string;
+  decision: PlgOnboardingReviewDecision;
+  reviewedBy: string;
+  reviewedAt: string;
+  justification: string;
+}
 
 export interface PlgOnboarding extends BaseModel {
   getImsOrgId(): string;
@@ -31,6 +42,7 @@ export interface PlgOnboarding extends BaseModel {
   getError(): object | null;
   getBotBlocker(): object | null;
   getWaitlistReason(): string | null;
+  getReviews(): PlgOnboardingReview[] | null;
   getCompletedAt(): string | null;
   setStatus(status: PlgOnboardingStatus): PlgOnboarding;
   setSiteId(siteId: string): PlgOnboarding;
@@ -39,6 +51,7 @@ export interface PlgOnboarding extends BaseModel {
   setError(error: object): PlgOnboarding;
   setBotBlocker(botBlocker: object): PlgOnboarding;
   setWaitlistReason(waitlistReason: string): PlgOnboarding;
+  setReviews(reviews: PlgOnboardingReview[]): PlgOnboarding;
   setCompletedAt(completedAt: string): PlgOnboarding;
 }
 

package/src/models/plg-onboarding/plg-onboarding.model.js

@@ -33,6 +33,12 @@ class PlgOnboarding extends BaseModel {
     ERROR: 'ERROR',
     WAITING_FOR_IP_ALLOWLISTING: 'WAITING_FOR_IP_ALLOWLISTING',
     WAITLISTED: 'WAITLISTED',
+    INACTIVE: 'INACTIVE',
+  };
+
+  static REVIEW_DECISIONS = {
+    BYPASSED: 'BYPASSED',
+    UPHELD: 'UPHELD',
   };
 }
 

package/src/models/plg-onboarding/plg-onboarding.schema.js

@@ -17,12 +17,6 @@ import SchemaBuilder from '../base/schema.builder.js';
 import PlgOnboarding from './plg-onboarding.model.js';
 import PlgOnboardingCollection from './plg-onboarding.collection.js';
 
-/*
-Schema Doc: https://electrodb.dev/en/modeling/schema/
-Attribute Doc: https://electrodb.dev/en/modeling/attributes/
-Indexes Doc: https://electrodb.dev/en/modeling/indexes/
-*/
-
 const schema = new SchemaBuilder(PlgOnboarding, PlgOnboardingCollection)
   .addAttribute('imsOrgId', {
     type: 'string',
@@ -86,6 +80,25 @@ const schema = new SchemaBuilder(PlgOnboarding, PlgOnboardingCollection)
     type: 'string',
     required: false,
   })
+  .addAttribute('reviews', {
+    type: 'list',
+    required: false,
+    items: {
+      type: 'map',
+      properties: {
+        reason: { type: 'string' },
+        decision: { type: 'string' },
+        reviewedBy: { type: 'string' },
+        reviewedAt: { type: 'string' },
+        justification: { type: 'string' },
+      },
+    },
+    validate: (value) => {
+      if (!Array.isArray(value)) return false;
+      const valid = Object.values(PlgOnboarding.REVIEW_DECISIONS);
+      return value.every((r) => valid.includes(r.decision) && isIsoDate(r.reviewedAt));
+    },
+  })
   .addAttribute('completedAt', {
     type: 'string',
     validate: (value) => !value || isIsoDate(value),