Cms Collection Compatibility

1'use strict';
2const {canonical}=require('./mapping-field-contract.js');
3function plannedMetadataMatches(actual,expected) {
4  if (expected===undefined || expected===null) return true;
5  if (Array.isArray(expected) || typeof expected!=='object') return canonical(actual)===canonical(expected);
6  return actual && typeof actual==='object' && Object.entries(expected).every(([k,v])=>plannedMetadataMatches(actual[k],v));
7}
8// REST DataCollection/Field/Permissions shapes, not an SDK object or a list-ID hit.
9function collectionCompatibility(actual, expected) {
10  const problems=[];
11  if (!actual || actual.id!==expected.id) problems.push('collection identity missing/mismatched');
12  if (!actual?.permissions || !expected.permissions || ['read','insert','update','remove'].some(k=>!expected.permissions[k] || actual.permissions[k]!==expected.permissions[k])) problems.push('permissions missing/mismatched');
13  const fields=new Map((actual?.fields || []).map(f=>[f.key,f]));
14  for (const want of expected.fields || []) {
15    const found=fields.get(want.key);
16    if (!found || found.type!==want.type || Boolean(found.required)!==Boolean(want.required) || found.readOnly===true || found.immutable===true ||
17      !plannedMetadataMatches(found.typeMetadata,want.typeMetadata)) problems.push(`field ${want.key} is missing/incompatible`);
18  }
19  if ((actual?.fields || []).some(f=>f.required && !f.systemField && !(expected.fields || []).some(w=>w.key===f.key))) problems.push('additional required fields need an explicit mapping');
20  return {ok:problems.length===0,problems};
21}
22function assertCollectionCompatibility(actual, expected) {
23  const result=collectionCompatibility(actual,expected);
24  if (!result.ok) throw Object.assign(new Error(`CMS collection ${expected.id}: ${result.problems.join('; ')}`),{
25    blockerCode:'CMS_COLLECTION_INCOMPATIBLE',recommendedAction:'Inspect the existing definition and revise mapping/setup through the current review. Do not delete or recreate the collection.'});
26}
27module.exports={collectionCompatibility,assertCollectionCompatibility};