@adobe/spacecat-shared-data-access 3.80.0 → 3.81.0

package/src/models/ticket-suggestion/ticket-suggestion.model.js

@@ -0,0 +1,36 @@
+/*
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import BaseModel from '../base/base.model.js';
+
+/**
+ * TicketSuggestion — bridge record linking a Suggestion to the Ticket created for it.
+ *
+ * Enforces 1:1 in v1: `UNIQUE (suggestion_id)` at the DB level prevents the same
+ * suggestion from being ticketed twice. In v2, the constraint relaxes to
+ * `UNIQUE (suggestion_id, ticket_id)` to support grouped ticket creation (M:N).
+ *
+ * `suggestionId` is a logical reference (stored as TEXT), not a Postgres FK.
+ * Suggestions live in DynamoDB/ElectroDB — there is no Postgres FK to enforce.
+ * Application-layer validation ensures the suggestion exists before creating this record.
+ *
+ * `opportunityId` is stored for direct opportunity-scoped queries without requiring
+ * a JOIN through the Ticket row.
+ *
+ * @class TicketSuggestion
+ * @extends BaseModel
+ */
+class TicketSuggestion extends BaseModel {
+  static ENTITY_NAME = 'TicketSuggestion';
+}
+
+export default TicketSuggestion;

package/src/models/ticket-suggestion/ticket-suggestion.schema.js

@@ -0,0 +1,53 @@
+/*
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+/* c8 ignore start */
+
+import SchemaBuilder from '../base/schema.builder.js';
+import TicketSuggestion from './ticket-suggestion.model.js';
+import TicketSuggestionCollection from './ticket-suggestion.collection.js';
+
+// GSI on suggestionId powers findBySuggestionId() — used to check if a
+// suggestion has already been ticketed before attempting to create a duplicate.
+const schema = new SchemaBuilder(TicketSuggestion, TicketSuggestionCollection)
+  // ticket_suggestions is append-only — the DB grants no UPDATE privilege (bridge rows are
+  // immutable once created; delete and recreate if wrong). Disabling updates at the model
+  // layer surfaces a clean ValidationError instead of an opaque PostgREST 403.
+  .allowUpdates(false)
+  // ticket_suggestions is append-only — no updated_at or updated_by columns in the DB.
+  // Suppress the SchemaBuilder auto-added attributes so they are not included in INSERTs.
+  .addAttribute('updatedAt', {
+    type: 'string', required: false, readOnly: true, postgrestIgnore: true,
+  })
+  .addAttribute('updatedBy', { type: 'string', required: false, postgrestIgnore: true })
+  .addReference('belongs_to', 'Ticket')
+  .addAttribute('suggestionId', {
+    type: 'string',
+    required: true,
+    readOnly: true,
+  })
+  .addAttribute('opportunityId', {
+    type: 'string',
+    required: true,
+    readOnly: true,
+  })
+  .addAttribute('createdBy', {
+    type: 'string',
+    required: true,
+    readOnly: true,
+  })
+  .addIndex(
+    { composite: ['suggestionId'] },
+    { composite: [] },
+  );
+
+export default schema.build();

package/src/service/index.d.ts

@@ -44,6 +44,11 @@ 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 { IdempotencyKeyCollection } from '../models/idempotency-key';
+import type { OAuthNonceCollection } from '../models/oauth-nonce';
+import type { TaskManagementConnectionCollection } from '../models/task-management-connection';
+import type { TicketCollection } from '../models/ticket';
+import type { TicketSuggestionCollection } from '../models/ticket-suggestion';
 import type { TrialUserCollection } from '../models/trial-user';
 import type { TrialUserActivityCollection } from '../models/trial-user-activity';
 
@@ -94,6 +99,11 @@ export interface DataAccess {
   SiteTopForm: SiteTopFormCollection;
   SiteTopPage: SiteTopPageCollection;
   Suggestion: SuggestionCollection;
+  IdempotencyKey: IdempotencyKeyCollection;
+  OAuthNonce: OAuthNonceCollection;
+  TaskManagementConnection: TaskManagementConnectionCollection;
+  Ticket: TicketCollection;
+  TicketSuggestion: TicketSuggestionCollection;
   TrialUser: TrialUserCollection;
   TrialUserActivity: TrialUserActivityCollection;
 }