@syncmatters/script-api 1.0.5 → 1.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncmatters/script-api",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "TypeScript type definitions for the SyncMatters script API (types only - scripts execute on the SyncMatters platform)",
   "types": "./index.d.ts",
   "exports": {
@@ -20,7 +20,7 @@
   "license": "MIT",
   "author": "SyncMatters",
   "homepage": "https://syncmatters.com",
-  "typesContentHash": "8c1e30614914088ef6397a1efbc237ea02bc438bc168ec2f27bc27ea96762cbe",
+  "typesContentHash": "87164fc7d9ba4a7b759acaa21737560cfb815a277721adbff4ab10a0ade8f806",
   "dependencies": {
     "@types/node": "*"
   }

package/sdk-test/sdk-test.d.ts

@@ -208,6 +208,10 @@ export interface ConnectorTestResult {
     testConnection?: "Passed" | "Not tested" | "Failed: Fatal error during testing" | "Failed: Test connection response did not report success";
     objectsStatus?: "Passed" | "Partial: Only selected objects tested" | "Partial: Only selected objects tested, not all features can be tested" | "Partial: Only selected object tests run" | "Partial: Only selected objects tested, only selected object tests run" | "Partial: Not all features/objects can be tested" | "Not tested" | "Failed: Fatal error during testing" | "Failed: One or more objects failed tests";
     objects: ObjectTestResult[];
+    /** Diagnostic details for connection-level stages, keyed by stage (testConnection, metaRefresh). */
+    details?: {
+        [stage: string]: TestDetail[];
+    };
 }
 export interface ObjectTestResult {
     objectId: string;
@@ -251,6 +255,10 @@ export interface ObjectTestResult {
     deleteFatalError?: CaughtError;
     fieldMetadata?: "Passed" | "Not tested" | "Failed: One or more fields have metadata issues";
     fieldMetadataIssues: FieldMetadataIssue[];
+    /** Diagnostic details keyed by feature (list, idsFilter, checkpointFilter, upsert, upsertClean, delete, fieldMetadata). */
+    details?: {
+        [feature: string]: TestDetail[];
+    };
 }
 export interface FieldMetadataIssue {
     operation: "query" | "upsert" | "delete";
@@ -264,6 +272,8 @@ export interface MatchRuleTestResult {
     notTestedReason?: string;
     errorRowId?: string;
     fatalError?: CaughtError;
+    /** Diagnostic details for this rule. */
+    details?: TestDetail[];
 }
 export interface RelatedFilterTestResult {
     relationshipId: string;
@@ -272,12 +282,28 @@ export interface RelatedFilterTestResult {
     notTestedReason?: string;
     errorRowId?: string;
     fatalError?: CaughtError;
+    /** Diagnostic details for this relationship. */
+    details?: TestDetail[];
 }
 /** Details from caught error that blocked test completion */
 export interface CaughtError {
     message?: string;
     stack?: string;
 }
+/**
+ * A diagnostic detail captured while testing; mirrors what the test harness logs (a message plus
+ * the inputs/outputs the message relates to). Details are saved with the test result so the
+ * harness i/o can be reviewed alongside statuses; the platform scrubs them after a short
+ * retention window, statuses remain.
+ */
+export interface TestDetail {
+    level: "info" | "error";
+    message: string;
+    /** Inputs/outputs relating to the message (e.g. filter ids used, rows returned). */
+    data?: unknown;
+    /** Set when the data payload was dropped to honour the capture size budget. */
+    truncated?: boolean;
+}
 /** Options passed when requesting data that will be used for an upsert test. */
 export interface UpsertOptions {
     meta: API.ObjectMeta;