meadow-integration 1.0.20 → 1.0.21

package/package.json

@@ -1,11 +1,12 @@
 {
     "name": "meadow-integration",
-    "version": "1.0.20",
+    "version": "1.0.21",
     "description": "Meadow Data Integration",
     "bin": {
         "mdwint": "source/cli/Meadow-Integration-CLI-Run.js"
     },
     "main": "source/Meadow-Integration.js",
+    "browser": "source/Meadow-Integration-Browser.js",
     "scripts": {
         "test": "npx quack test",
         "start": "node source/cli/Meadow-Integration-CLI-Run.js",
@@ -16,7 +17,8 @@
     "author": "steven velozo <steven@velozo.com>",
     "license": "MIT",
     "devDependencies": {
-        "quackage": "^1.0.64"
+        "meadow-connection-sqlite": "^1.0.18",
+        "quackage": "^1.0.65"
     },
     "mocha": {
         "diff": true,
@@ -37,16 +39,18 @@
         ]
     },
     "dependencies": {
-        "fable": "^3.1.63",
+        "fable": "^3.1.67",
         "fable-serviceproviderbase": "^3.0.19",
         "fast-xml-parser": "^4.4.1",
         "meadow": "^2.0.33",
         "meadow-connection-mssql": "^1.0.16",
         "meadow-connection-mysql": "^1.0.14",
         "orator": "^6.0.4",
-        "orator-serviceserver-restify": "^2.0.9",
+        "orator-serviceserver-restify": "^2.0.10",
+        "pict-section-flow": "^0.0.17",
         "pict-service-commandlineutility": "^1.0.19",
         "pict-sessionmanager": "^1.0.2",
+        "pict-view": "^1.0.67",
         "xlsx": "^0.18.5"
     }
 }

package/source/Meadow-Integration-Browser.js

@@ -0,0 +1,31 @@
+/**
+ * Meadow-Integration Browser Entry Point
+ *
+ * Browser-safe exports only — no database drivers, no server-side
+ * connection managers, no file system access.
+ *
+ * Use this entry point in browser bundles:
+ *   const libMI = require('meadow-integration/source/Meadow-Integration-Browser.js');
+ *
+ * Or add to package.json "browser" field for automatic resolution.
+ */
+
+'use strict';
+
+const libMeadowMappingEditorView = require(`./views/PictView-MeadowMappingEditor.js`);
+const libMappingEditorSchemaUtils = require(`./views/MappingEditor-SchemaUtils.js`);
+const libFlowCardMappingSource = require(`./views/flow-cards/FlowCard-MappingSource.js`);
+const libFlowCardMappingTarget = require(`./views/flow-cards/FlowCard-MappingTarget.js`);
+const libFlowCardTemplateExpression = require(`./views/flow-cards/FlowCard-TemplateExpression.js`);
+const libFlowCardSolverExpression = require(`./views/flow-cards/FlowCard-SolverExpression.js`);
+
+module.exports =
+{
+	// Visual mapping editor components
+	MeadowMappingEditorView: libMeadowMappingEditorView,
+	MappingEditorSchemaUtils: libMappingEditorSchemaUtils,
+	FlowCardMappingSource: libFlowCardMappingSource,
+	FlowCardMappingTarget: libFlowCardMappingTarget,
+	FlowCardTemplateExpression: libFlowCardTemplateExpression,
+	FlowCardSolverExpression: libFlowCardSolverExpression,
+};

package/source/Meadow-Integration.js

@@ -18,6 +18,13 @@ const libFileParserXLSX = require(`./services/parser/Service-FileParser-XLSX.js`
 const libFileParserXML = require(`./services/parser/Service-FileParser-XML.js`);
 const libFileParserFixedWidth = require(`./services/parser/Service-FileParser-FixedWidth.js`);
 
+const libMeadowMappingEditorView = require(`./views/PictView-MeadowMappingEditor.js`);
+const libMappingEditorSchemaUtils = require(`./views/MappingEditor-SchemaUtils.js`);
+const libFlowCardMappingSource = require(`./views/flow-cards/FlowCard-MappingSource.js`);
+const libFlowCardMappingTarget = require(`./views/flow-cards/FlowCard-MappingTarget.js`);
+const libFlowCardTemplateExpression = require(`./views/flow-cards/FlowCard-TemplateExpression.js`);
+const libFlowCardSolverExpression = require(`./views/flow-cards/FlowCard-SolverExpression.js`);
+
 module.exports = (
 	{
 		TabularCheck: libTabularCheck,
@@ -38,5 +45,13 @@ module.exports = (
 		FileParserJSON: libFileParserJSON,
 		FileParserXLSX: libFileParserXLSX,
 		FileParserXML: libFileParserXML,
-		FileParserFixedWidth: libFileParserFixedWidth
+		FileParserFixedWidth: libFileParserFixedWidth,
+
+		// Visual mapping editor components (for browser bundles)
+		MeadowMappingEditorView: libMeadowMappingEditorView,
+		MappingEditorSchemaUtils: libMappingEditorSchemaUtils,
+		FlowCardMappingSource: libFlowCardMappingSource,
+		FlowCardMappingTarget: libFlowCardMappingTarget,
+		FlowCardTemplateExpression: libFlowCardTemplateExpression,
+		FlowCardSolverExpression: libFlowCardSolverExpression
 	});

package/source/services/certainty/Service-CertaintyAccumulator.js

@@ -0,0 +1,402 @@
+/**
+ * Service-CertaintyAccumulator
+ *
+ * Evidence accumulation engine for data integration certainty scoring.
+ *
+ * Tracks two certainty dimensions per field per record (GUID):
+ *
+ *   1. Cross-dataset presence:  1 - ∏(1 - weight_i)
+ *      Strong signal — independent datasets corroborating a value.
+ *
+ *   2. Within-dataset ratio:  log(count + 1) / log(datasetSize + 1)
+ *      Weak signal — repetition within a single dataset has diminishing returns.
+ *
+ *   3. Composite:  (w_presence × presence) + (w_ratio × ratio)
+ *      Configurable weights; default 70% presence, 30% ratio.
+ *
+ * Evidence is tracked at the FIELD level.  Record-level certainty is
+ * derived on the fly as the mean of its field composites.
+ *
+ * Designed to plug into Facto's MultiSet projection pipeline at the
+ * merge decision point, replacing the simple linear confidence tracker.
+ *
+ * @module Service-CertaintyAccumulator
+ */
+
+'use strict';
+
+const libFableServiceProviderBase = require('fable-serviceproviderbase');
+
+class MeadowIntegrationCertaintyAccumulator extends libFableServiceProviderBase
+{
+	constructor(pFable, pOptions, pServiceHash)
+	{
+		super(pFable, pOptions, pServiceHash);
+
+		this.serviceType = 'CertaintyAccumulator';
+	}
+
+	// ─────────────────────────────────────────────
+	//  Context lifecycle
+	// ─────────────────────────────────────────────
+
+	/**
+	 * Create a new accumulation context for a merge pipeline.
+	 *
+	 * @param {object} [pConfig] — optional overrides
+	 * @param {number} [pConfig.PresenceWeight=0.7]
+	 * @param {number} [pConfig.RatioWeight=0.3]
+	 * @returns {object} AccumulationContext
+	 */
+	newAccumulationContext(pConfig)
+	{
+		let tmpConfig = (typeof pConfig === 'object' && pConfig !== null) ? pConfig : {};
+
+		let tmpPresenceWeight = (typeof tmpConfig.PresenceWeight === 'number') ? tmpConfig.PresenceWeight : 0.7;
+		let tmpRatioWeight    = (typeof tmpConfig.RatioWeight === 'number') ? tmpConfig.RatioWeight : 0.3;
+
+		// Normalize so they sum to 1.0
+		let tmpSum = tmpPresenceWeight + tmpRatioWeight;
+		if (tmpSum > 0 && tmpSum !== 1.0)
+		{
+			tmpPresenceWeight = tmpPresenceWeight / tmpSum;
+			tmpRatioWeight    = tmpRatioWeight / tmpSum;
+		}
+
+		return {
+			Weights:
+			{
+				presence: tmpPresenceWeight,
+				ratio:    tmpRatioWeight,
+			},
+
+			// Per-GUID, per-field evidence
+			// { [GUID]: { [fieldName]: { value, sources: [...] } } }
+			FieldEvidence: {},
+
+			// Per-dataset metadata
+			// { [stepLabel]: { weight, totalRecords, uniqueGUIDs } }
+			DatasetContributions: {},
+		};
+	}
+
+	// ─────────────────────────────────────────────
+	//  Evidence accumulation
+	// ─────────────────────────────────────────────
+
+	/**
+	 * Record evidence from a single dataset/step for a specific GUID.
+	 *
+	 * Call this once per GUID per step, after the merge strategy has
+	 * decided the action but before updating the accumulated comprehension.
+	 *
+	 * @param {object} pContext — the AccumulationContext
+	 * @param {string} pGUID — record GUID
+	 * @param {object} pNewRecord — incoming record from this step
+	 * @param {object|null} pExistingRecord — previously merged record (null if first seen)
+	 * @param {string} pMergeAction — e.g. 'Created', 'Merged', 'Merged_Reinforced', 'Skipped_*'
+	 * @param {object} pStepInfo — source metadata
+	 * @param {number} pStepInfo.ReliabilityWeight — DatasetSource weight (0–1)
+	 * @param {number} pStepInfo.DatasetSize — total records in this source dataset
+	 * @param {number} [pStepInfo.RecordCountInDataset=1] — how many times this GUID appeared in the dataset
+	 * @param {string} pStepInfo.StepLabel — human-readable source label
+	 * @param {number} pStepInfo.StepOrdinal — sequential step number
+	 */
+	accumulateEvidence(pContext, pGUID, pNewRecord, pExistingRecord, pMergeAction, pStepInfo)
+	{
+		if (!pContext || !pGUID || !pNewRecord)
+		{
+			return;
+		}
+
+		let tmpStepInfo = pStepInfo || {};
+		let tmpWeight      = (typeof tmpStepInfo.ReliabilityWeight === 'number') ? tmpStepInfo.ReliabilityWeight : 0.5;
+		let tmpDatasetSize = tmpStepInfo.DatasetSize || 1;
+		let tmpCount       = tmpStepInfo.RecordCountInDataset || 1;
+		let tmpStepLabel   = tmpStepInfo.StepLabel || 'unknown';
+		let tmpStepOrdinal = tmpStepInfo.StepOrdinal || 0;
+
+		// Track dataset contributions
+		if (!pContext.DatasetContributions[tmpStepLabel])
+		{
+			pContext.DatasetContributions[tmpStepLabel] =
+			{
+				weight:       tmpWeight,
+				totalRecords: tmpDatasetSize,
+				uniqueGUIDs:  0,
+			};
+		}
+		pContext.DatasetContributions[tmpStepLabel].uniqueGUIDs++;
+
+		// Initialize GUID evidence if needed
+		if (!pContext.FieldEvidence[pGUID])
+		{
+			pContext.FieldEvidence[pGUID] = {};
+		}
+		let tmpGUIDEvidence = pContext.FieldEvidence[pGUID];
+
+		// Record evidence for each field in the new record
+		let tmpFieldNames = Object.keys(pNewRecord);
+		for (let i = 0; i < tmpFieldNames.length; i++)
+		{
+			let tmpFieldName = tmpFieldNames[i];
+			let tmpValue     = pNewRecord[tmpFieldName];
+
+			// Skip GUID fields and internal metadata
+			if (tmpFieldName.startsWith('GUID') || tmpFieldName.startsWith('_'))
+			{
+				continue;
+			}
+
+			if (!tmpGUIDEvidence[tmpFieldName])
+			{
+				tmpGUIDEvidence[tmpFieldName] =
+				{
+					value:   tmpValue,
+					sources: [],
+				};
+			}
+
+			tmpGUIDEvidence[tmpFieldName].sources.push(
+			{
+				weight:      tmpWeight,
+				count:       tmpCount,
+				datasetSize: tmpDatasetSize,
+				stepLabel:   tmpStepLabel,
+				stepOrdinal: tmpStepOrdinal,
+				value:       tmpValue,
+			});
+		}
+	}
+
+	// ─────────────────────────────────────────────
+	//  Certainty computation
+	// ─────────────────────────────────────────────
+
+	/**
+	 * Compute field-level certainty scores for a single GUID.
+	 *
+	 * @param {object} pContext — the AccumulationContext
+	 * @param {string} pGUID — record GUID
+	 * @returns {object} — { fields: { fieldName: { presence, ratio, composite, agreeing, conflicting } }, recordComposite }
+	 */
+	computeCertainty(pContext, pGUID)
+	{
+		if (!pContext || !pContext.FieldEvidence[pGUID])
+		{
+			return { fields: {}, recordComposite: 0.5 };
+		}
+
+		let tmpGUIDEvidence = pContext.FieldEvidence[pGUID];
+		let tmpFieldNames   = Object.keys(tmpGUIDEvidence);
+		let tmpFields       = {};
+		let tmpCompositeSum = 0;
+		let tmpFieldCount   = 0;
+
+		for (let i = 0; i < tmpFieldNames.length; i++)
+		{
+			let tmpFieldName    = tmpFieldNames[i];
+			let tmpFieldData    = tmpGUIDEvidence[tmpFieldName];
+			let tmpSources      = tmpFieldData.sources;
+			let tmpCurrentValue = tmpFieldData.value;
+
+			// ── Cross-dataset presence ──────────────────────────
+			// Only count sources where the value AGREES with the current value.
+			// Conflicting sources don't contribute to presence.
+			let tmpAgreeingSources    = [];
+			let tmpConflictingSources = [];
+
+			for (let j = 0; j < tmpSources.length; j++)
+			{
+				if (this._valuesMatch(tmpSources[j].value, tmpCurrentValue))
+				{
+					tmpAgreeingSources.push(tmpSources[j]);
+				}
+				else
+				{
+					tmpConflictingSources.push(tmpSources[j]);
+				}
+			}
+
+			// presence = 1 - ∏(1 - weight_i) for agreeing sources
+			let tmpUncertainty = 1.0;
+			for (let j = 0; j < tmpAgreeingSources.length; j++)
+			{
+				tmpUncertainty *= (1.0 - tmpAgreeingSources[j].weight);
+			}
+			let tmpPresence = 1.0 - tmpUncertainty;
+
+			// Penalize if there are conflicting sources
+			if (tmpConflictingSources.length > 0)
+			{
+				let tmpConflictPenalty = tmpConflictingSources.length / (tmpAgreeingSources.length + tmpConflictingSources.length);
+				tmpPresence *= (1.0 - (tmpConflictPenalty * 0.5));
+			}
+
+			// ── Within-dataset ratio (best source) ──────────────
+			// Use the strongest ratio from any agreeing source
+			let tmpBestRatio = 0;
+			for (let j = 0; j < tmpAgreeingSources.length; j++)
+			{
+				let tmpSrc   = tmpAgreeingSources[j];
+				let tmpRatio = Math.log(tmpSrc.count + 1) / Math.log(tmpSrc.datasetSize + 1);
+				if (tmpRatio > tmpBestRatio)
+				{
+					tmpBestRatio = tmpRatio;
+				}
+			}
+
+			// ── Composite ───────────────────────────────────────
+			let tmpComposite = (pContext.Weights.presence * tmpPresence) +
+				(pContext.Weights.ratio * tmpBestRatio);
+
+			// Clamp to [0, 1]
+			tmpComposite = Math.max(0, Math.min(1, tmpComposite));
+
+			tmpFields[tmpFieldName] =
+			{
+				presence:    Math.round(tmpPresence * 10000) / 10000,
+				ratio:       Math.round(tmpBestRatio * 10000) / 10000,
+				composite:   Math.round(tmpComposite * 10000) / 10000,
+				agreeing:    tmpAgreeingSources.length,
+				conflicting: tmpConflictingSources.length,
+			};
+
+			tmpCompositeSum += tmpComposite;
+			tmpFieldCount++;
+		}
+
+		let tmpRecordComposite = tmpFieldCount > 0
+			? Math.round((tmpCompositeSum / tmpFieldCount) * 10000) / 10000
+			: 0.5;
+
+		return {
+			fields:          tmpFields,
+			recordComposite: tmpRecordComposite,
+		};
+	}
+
+	/**
+	 * Bulk compute certainty for all GUIDs in the context.
+	 *
+	 * @param {object} pContext — the AccumulationContext
+	 * @returns {object} — { [GUID]: CertaintyResult }
+	 */
+	computeAllCertainties(pContext)
+	{
+		if (!pContext || !pContext.FieldEvidence)
+		{
+			return {};
+		}
+
+		let tmpResults = {};
+		let tmpGUIDs   = Object.keys(pContext.FieldEvidence);
+
+		for (let i = 0; i < tmpGUIDs.length; i++)
+		{
+			tmpResults[tmpGUIDs[i]] = this.computeCertainty(pContext, tmpGUIDs[i]);
+		}
+
+		return tmpResults;
+	}
+
+	// ─────────────────────────────────────────────
+	//  CertaintyIndex entry generation
+	// ─────────────────────────────────────────────
+
+	/**
+	 * Generate CertaintyIndex entries for a single GUID.
+	 * Creates one entry per field per dimension (presence, ratio, composite).
+	 *
+	 * @param {object} pContext — the AccumulationContext
+	 * @param {string} pGUID — record GUID
+	 * @param {number} pIDRecord — Facto Record ID to link entries to
+	 * @returns {Array} — array of { IDRecord, CertaintyValue, Dimension, Justification }
+	 */
+	generateCertaintyEntries(pContext, pGUID, pIDRecord)
+	{
+		let tmpCertainty = this.computeCertainty(pContext, pGUID);
+		let tmpEntries   = [];
+
+		let tmpFieldNames = Object.keys(tmpCertainty.fields);
+		for (let i = 0; i < tmpFieldNames.length; i++)
+		{
+			let tmpFieldName = tmpFieldNames[i];
+			let tmpField     = tmpCertainty.fields[tmpFieldName];
+
+			let tmpJustification = JSON.stringify(
+			{
+				agreeing:    tmpField.agreeing,
+				conflicting: tmpField.conflicting,
+				weights:     pContext.Weights,
+			});
+
+			tmpEntries.push(
+			{
+				IDRecord:       pIDRecord,
+				CertaintyValue: tmpField.presence,
+				Dimension:      `field:${tmpFieldName}:presence`,
+				Justification:  tmpJustification,
+			});
+
+			tmpEntries.push(
+			{
+				IDRecord:       pIDRecord,
+				CertaintyValue: tmpField.ratio,
+				Dimension:      `field:${tmpFieldName}:ratio`,
+				Justification:  tmpJustification,
+			});
+
+			tmpEntries.push(
+			{
+				IDRecord:       pIDRecord,
+				CertaintyValue: tmpField.composite,
+				Dimension:      `field:${tmpFieldName}:composite`,
+				Justification:  tmpJustification,
+			});
+		}
+
+		return tmpEntries;
+	}
+
+	// ─────────────────────────────────────────────
+	//  Internal helpers
+	// ─────────────────────────────────────────────
+
+	/**
+	 * Compare two values for equality.
+	 * Handles strings, numbers, nulls, and undefined.
+	 * String comparisons are case-insensitive and trimmed.
+	 */
+	_valuesMatch(pValueA, pValueB)
+	{
+		// Both null/undefined
+		if (pValueA == null && pValueB == null)
+		{
+			return true;
+		}
+
+		// One null, other not
+		if (pValueA == null || pValueB == null)
+		{
+			return false;
+		}
+
+		// Both strings — case-insensitive, trimmed
+		if (typeof pValueA === 'string' && typeof pValueB === 'string')
+		{
+			return pValueA.trim().toLowerCase() === pValueB.trim().toLowerCase();
+		}
+
+		// Numeric comparison with tolerance
+		if (typeof pValueA === 'number' && typeof pValueB === 'number')
+		{
+			return Math.abs(pValueA - pValueB) < 0.0001;
+		}
+
+		// Fall back to strict equality
+		return pValueA === pValueB;
+	}
+}
+
+module.exports = MeadowIntegrationCertaintyAccumulator;

package/source/services/clone/Meadow-Service-Sync-Entity-Initial.js

@@ -43,6 +43,11 @@ class MeadowSyncEntityInitial extends libFableServiceProviderBase
 		this.MaxRecordsPerEntity = this.options.MaxRecordsPerEntity || 0;
 		this.UseAdvancedIDPagination = this.options.UseAdvancedIDPagination || false;
 
+		// Optional query string appended to deleted record API requests.
+		// Used to work around older APIs where FBV~Deleted~EQ~1 does not
+		// override the automatic Deleted=0 filter (e.g. "includeDeleted=true").
+		this.SyncDeletedRecordsQueryString = this.options.SyncDeletedRecordsQueryString || '';
+
 		this.Meadow = false;
 
 		this.operation = new libMeadowOperation(this.fable);
@@ -119,7 +124,7 @@ class MeadowSyncEntityInitial extends libFableServiceProviderBase
 					{
 						this.log.warn(`${this.EntitySchema.TableName}: Index creation error: ${pIndexError}`);
 					}
-					return fValidateAndCallback(pIndexError || pCreateError);
+					return fCallback(pIndexError || pCreateError);
 				});
 			});
 		}
@@ -170,6 +175,12 @@ class MeadowSyncEntityInitial extends libFableServiceProviderBase
 		return tmpRecordToCommit;
 	}
 
+	_appendDeletedQueryString(pURL)
+	{
+		if (!this.SyncDeletedRecordsQueryString) return pURL;
+		return pURL + (pURL.indexOf('?') > -1 ? '&' : '?') + this.SyncDeletedRecordsQueryString;
+	}
+
 	syncDeletedRecords(fCallback)
 	{
 		const tmpDeletedColumn = this.EntitySchema.Columns.find((c) => c.Column == 'Deleted');
@@ -183,7 +194,9 @@ class MeadowSyncEntityInitial extends libFableServiceProviderBase
 
 		// Get the count of deleted records from the server.
 		// The explicit FBV~Deleted~EQ~1 filter overrides foxhound's automatic Deleted=0 filter.
-		this.fable.MeadowCloneRestClient.getJSON(`${this.EntitySchema.TableName}s/Count/FilteredTo/FBV~Deleted~EQ~1`,
+		// On older APIs where this doesn't work, SyncDeletedRecordsQueryString provides a
+		// fallback (e.g. "includeDeleted=true") that disables server-side delete tracking.
+		this.fable.MeadowCloneRestClient.getJSON(this._appendDeletedQueryString(`${this.EntitySchema.TableName}s/Count/FilteredTo/FBV~Deleted~EQ~1`),
 			(pError, pResponse, pBody) =>
 			{
 				if (pError || !pBody || !pBody.hasOwnProperty('Count'))
@@ -208,7 +221,7 @@ class MeadowSyncEntityInitial extends libFableServiceProviderBase
 				const tmpDeleteURLPartials = [];
 				for (let i = 0; i < tmpDeleteCap; i += this.PageSize)
 				{
-					tmpDeleteURLPartials.push(`${this.EntitySchema.TableName}s/FilteredTo/FBV~Deleted~EQ~1~FSF~${this.DefaultIdentifier}~ASC~ASC/${i}/${this.PageSize}`);
+					tmpDeleteURLPartials.push(this._appendDeletedQueryString(`${this.EntitySchema.TableName}s/FilteredTo/FBV~Deleted~EQ~1~FSF~${this.DefaultIdentifier}~ASC~ASC/${i}/${this.PageSize}`));
 				}
 
 				this.fable.Utility.eachLimit(tmpDeleteURLPartials, 1,

package/source/services/clone/Meadow-Service-Sync-Entity-Ongoing.js

@@ -42,6 +42,11 @@ class MeadowSyncEntityOngoing extends libFableServiceProviderBase
 		this.SyncDeletedRecords = this.options.SyncDeletedRecords || false;
 		this.MaxRecordsPerEntity = this.options.MaxRecordsPerEntity || 0;
 
+		// Optional query string appended to deleted record API requests.
+		// Used to work around older APIs where FBV~Deleted~EQ~1 does not
+		// override the automatic Deleted=0 filter (e.g. "includeDeleted=true").
+		this.SyncDeletedRecordsQueryString = this.options.SyncDeletedRecordsQueryString || '';
+
 		// Minimum range size for bisection -- when a range is this small or smaller,
 		// pull all records in the range from the server instead of subdividing further.
 		this.BisectMinRangeSize = this.options.BisectMinRangeSize || 1000;
@@ -645,6 +650,12 @@ class MeadowSyncEntityOngoing extends libFableServiceProviderBase
 
 	// ---- Deleted records sync ----
 
+	_appendDeletedQueryString(pURL)
+	{
+		if (!this.SyncDeletedRecordsQueryString) return pURL;
+		return pURL + (pURL.indexOf('?') > -1 ? '&' : '?') + this.SyncDeletedRecordsQueryString;
+	}
+
 	syncDeletedRecords(fCallback)
 	{
 		const tmpDeletedColumn = this.EntitySchema.Columns.find((c) => c.Column == 'Deleted');
@@ -657,7 +668,9 @@ class MeadowSyncEntityOngoing extends libFableServiceProviderBase
 		this.fable.log.info(`Checking for deleted records on server for ${this.EntitySchema.TableName}...`);
 
 		// The explicit FBV~Deleted~EQ~1 filter overrides foxhound's automatic Deleted=0 filter.
-		this.fable.MeadowCloneRestClient.getJSON(`${this.EntitySchema.TableName}s/Count/FilteredTo/FBV~Deleted~EQ~1`,
+		// On older APIs where this doesn't work, SyncDeletedRecordsQueryString provides a
+		// fallback (e.g. "includeDeleted=true") that disables server-side delete tracking.
+		this.fable.MeadowCloneRestClient.getJSON(this._appendDeletedQueryString(`${this.EntitySchema.TableName}s/Count/FilteredTo/FBV~Deleted~EQ~1`),
 			(pError, pResponse, pBody) =>
 			{
 				if (pError || !pBody || !pBody.hasOwnProperty('Count'))
@@ -682,7 +695,7 @@ class MeadowSyncEntityOngoing extends libFableServiceProviderBase
 				const tmpDeleteURLPartials = [];
 				for (let i = 0; i < tmpDeleteCap; i += this.PageSize)
 				{
-					tmpDeleteURLPartials.push(`${this.EntitySchema.TableName}s/FilteredTo/FBV~Deleted~EQ~1~FSF~${this.DefaultIdentifier}~ASC~ASC/${i}/${this.PageSize}`);
+					tmpDeleteURLPartials.push(this._appendDeletedQueryString(`${this.EntitySchema.TableName}s/FilteredTo/FBV~Deleted~EQ~1~FSF~${this.DefaultIdentifier}~ASC~ASC/${i}/${this.PageSize}`));
 				}
 
 				this.fable.Utility.eachLimit(tmpDeleteURLPartials, 1,

package/source/services/clone/Meadow-Service-Sync.js

@@ -89,6 +89,20 @@ class MeadowSync extends libFableServiceProviderBase
 			this.DateTimePrecisionMS = parseInt(this.options.DateTimePrecisionMS, 10) || 1000;
 		}
 
+		// Optional query string appended to deleted record API requests for all entities.
+		// Used to work around older APIs where FBV~Deleted~EQ~1 does not override the
+		// automatic Deleted=0 filter (e.g. "includeDeleted=true").
+		// Can be overridden per-entity via SyncEntityOptions.
+		this.SyncDeletedRecordsQueryString = '';
+		if (this.fable.ProgramConfiguration.hasOwnProperty('SyncDeletedRecordsQueryString'))
+		{
+			this.SyncDeletedRecordsQueryString = this.fable.ProgramConfiguration.SyncDeletedRecordsQueryString;
+		}
+		else if (this.options.hasOwnProperty('SyncDeletedRecordsQueryString'))
+		{
+			this.SyncDeletedRecordsQueryString = this.options.SyncDeletedRecordsQueryString;
+		}
+
 		this.MeadowSchema = false;
 		this.MeadowSchemaTableList = false;
 
@@ -124,11 +138,18 @@ class MeadowSync extends libFableServiceProviderBase
 						ConnectionPool: this.options.ConnectionPool,
 						PageSize: this.options.PageSize || 100,
 						SyncDeletedRecords: this.SyncDeletedRecords,
+						SyncDeletedRecordsQueryString: this.SyncDeletedRecordsQueryString,
 						MaxRecordsPerEntity: this.MaxRecordsPerEntity,
 						DateTimePrecisionMS: this.DateTimePrecisionMS,
 						UseAdvancedIDPagination: this.UseAdvancedIDPagination,
 					};
 
+					// Apply per-entity option overrides if configured
+					if (this.SyncEntityOptions.hasOwnProperty(tmpEntitySchema.TableName))
+					{
+						Object.assign(tmpSyncEntityOptions, this.SyncEntityOptions[tmpEntitySchema.TableName]);
+					}
+
 					let tmpSyncEntity;
 
 					if (this.SyncMode == 'Ongoing')