@epilot/cli 0.1.86 → 0.1.88

package/README.md

@@ -29,7 +29,7 @@ npm install -g @epilot/cli
 
 <!-- usage-help -->
 ```
-epilot v0.1.86 — CLI for epilot APIs
+epilot v0.1.88 — CLI for epilot APIs
 
 USAGE
   epilot <api> <operationId> [params...] [flags]

package/definitions/app.json

@@ -2256,7 +2256,8 @@
                 "type": "string",
                 "enum": [
                   "tab",
-                  "group"
+                  "group",
+                  "widget"
                 ]
               },
               "allowed_schemas": {
@@ -3711,7 +3712,7 @@
           },
           "require_password_confirmation": {
             "type": "boolean",
-            "description": "Whether the portal user must confirm their current password before the change email request is handed over to the third-party system. When true, the portal collects and verifies the current password before calling the hook. Treated as true when `change_mode` is `synchronous`, since the portal re-creates the login with the confirmed password. Skipped either way for portal users whose identity is managed by an identity provider: an SSO login has no password to confirm.\n",
+            "description": "Whether the portal user must confirm their current password before the change email request is handed over to the third-party system. When true, the portal collects and verifies the current password before calling the hook. Skipped for portal users whose identity is managed by an identity provider: an SSO login has no password to confirm. When no password is confirmed and `change_mode` is `synchronous`, the re-created login gets a random password and the portal user signs in through their identity provider, or sets a new password via the email code flow.\n",
             "default": true
           },
           "explanation": {

package/definitions/deduplication.json

@@ -102,6 +102,193 @@
           }
         }
       }
+    },
+    "/v1/detect-duplicates": {
+      "post": {
+        "operationId": "detectDuplicates",
+        "summary": "detectDuplicates",
+        "description": "Detects potential duplicate entities for the given entity using the schema's prioritized uniqueness rules. Returns matches with a confidence score.",
+        "tags": [],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/DetectDuplicatesRequestBody"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Potential duplicates ranked by rule priority",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DetectDuplicatesResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/uniqueness-criteria": {
+      "get": {
+        "operationId": "listUniquenessCriteria",
+        "summary": "listUniquenessCriteria",
+        "description": "Lists UniquenessCriteria for the requesting organization. Optionally filtered by schema.",
+        "tags": [],
+        "parameters": [
+          {
+            "name": "schema",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Filter results to a specific entity schema."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Array of UniquenessCriteria records",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UniquenessCriteriaListResponse"
+                }
+              }
+            }
+          }
+        }
+      },
+      "post": {
+        "operationId": "createUniquenessCriteria",
+        "summary": "createUniquenessCriteria",
+        "description": "Creates a new UniquenessCriteria record.",
+        "tags": [],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UniquenessCriteriaCreateBody"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Created record",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UniquenessCriteria"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/uniqueness-criteria/{schema}": {
+      "get": {
+        "operationId": "getUniquenessCriteria",
+        "summary": "getUniquenessCriteria",
+        "description": "Fetch a single UniquenessCriteria record.",
+        "tags": [],
+        "parameters": [
+          {
+            "name": "schema",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Entity schema slug."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The criteria record",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UniquenessCriteria"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Record not found"
+          }
+        }
+      },
+      "put": {
+        "operationId": "updateUniquenessCriteria",
+        "summary": "updateUniquenessCriteria",
+        "description": "Replace the matchRules on an existing UniquenessCriteria record.",
+        "tags": [],
+        "parameters": [
+          {
+            "name": "schema",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Entity schema slug."
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UniquenessCriteriaUpdateBody"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Updated record",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UniquenessCriteria"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Record not found"
+          }
+        }
+      },
+      "delete": {
+        "operationId": "deleteUniquenessCriteria",
+        "summary": "deleteUniquenessCriteria",
+        "description": "Delete a UniquenessCriteria record.",
+        "tags": [],
+        "parameters": [
+          {
+            "name": "schema",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Entity schema slug."
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Record deleted"
+          },
+          "404": {
+            "description": "Record not found"
+          }
+        }
+      }
     }
   },
   "components": {
@@ -120,20 +307,26 @@
           "type": "object",
           "properties": {
             "toKeep": {
-              "type": "string"
+              "type": "string",
+              "minLength": 1,
+              "description": "Entity id to keep and merge the duplicates into"
             },
             "toDelete": {
               "type": "array",
               "items": {
-                "type": "string"
-              }
+                "type": "string",
+                "minLength": 1
+              },
+              "minItems": 1,
+              "description": "Non-empty list of duplicate entity ids to merge into toKeep and delete"
             }
           },
           "required": [
             "toKeep",
             "toDelete"
           ]
-        }
+        },
+        "minItems": 1
       },
       "DeduplicateRequestResponse": {
         "type": "array",
@@ -303,6 +496,205 @@
           "updatedAt"
         ],
         "description": "Represents an async deduplication job"
+      },
+      "DetectDuplicatesRequestBody": {
+        "type": "object",
+        "properties": {
+          "schema": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Entity schema to search (e.g. 'contact'). Must have UniquenessCriteria configured for the calling org."
+          },
+          "entity": {
+            "type": "object",
+            "additionalProperties": {},
+            "description": "The entity to look up potential duplicates for. Attribute values are extracted from this entity per the schema's match rules; system fields such as '_id' are supported. A rule is evaluated when at least one of its attributes resolves to a non-empty value on this entity; attributes without a value require candidates to also lack a value for them."
+          }
+        },
+        "required": [
+          "schema",
+          "entity"
+        ]
+      },
+      "DetectDuplicatesResponse": {
+        "type": "object",
+        "properties": {
+          "matches": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/DetectedDuplicateMatch"
+            }
+          }
+        },
+        "required": [
+          "matches"
+        ]
+      },
+      "DetectedDuplicateMatch": {
+        "type": "object",
+        "properties": {
+          "entity": {
+            "$ref": "#/components/schemas/Entity"
+          },
+          "confidence": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1,
+            "description": "Confidence score for the match, between 0 and 1."
+          },
+          "matched_attributes": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "minItems": 1,
+            "description": "Names of the attributes that matched on the rule that produced this hit."
+          }
+        },
+        "required": [
+          "entity",
+          "confidence",
+          "matched_attributes"
+        ]
+      },
+      "UniquenessCriteriaListResponse": {
+        "type": "object",
+        "properties": {
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/UniquenessCriteria"
+            }
+          }
+        },
+        "required": [
+          "items"
+        ]
+      },
+      "UniquenessCriteria": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Unique identifier of the criteria record."
+          },
+          "orgId": {
+            "type": "string",
+            "description": "Organization the criteria belong to."
+          },
+          "schema": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Entity schema these criteria apply to (e.g. 'contact')."
+          },
+          "matchRules": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/MatchRule"
+            },
+            "minItems": 1,
+            "description": "Ordered list of match rules. Order is the evaluation priority."
+          },
+          "createdAt": {
+            "type": "string",
+            "description": "ISO 8601 timestamp of record creation.",
+            "format": "date-time"
+          },
+          "updatedAt": {
+            "type": "string",
+            "description": "ISO 8601 timestamp of last update.",
+            "format": "date-time"
+          }
+        },
+        "required": [
+          "id",
+          "orgId",
+          "schema",
+          "matchRules",
+          "createdAt",
+          "updatedAt"
+        ],
+        "description": "Defines what makes an entity of a given schema unique within an organization."
+      },
+      "MatchRule": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "maxLength": 100,
+            "description": "Optional human-readable label for the rule. Purely descriptive; not used during matching."
+          },
+          "attributes": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/MatchAttribute"
+            },
+            "minItems": 1,
+            "description": "Attributes that must all match for this rule to fire. Attributes without a value on the source entity must also have no value on a matching candidate."
+          },
+          "confidence": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1,
+            "description": "Confidence assigned to matches produced by this rule, between 0 and 1."
+          }
+        },
+        "required": [
+          "attributes",
+          "confidence"
+        ],
+        "description": "One way to identify the same entity. Evaluated in order; first rule whose attributes are all available and that returns hits wins."
+      },
+      "MatchAttribute": {
+        "type": "object",
+        "properties": {
+          "attribute": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Name of the entity attribute to match on. Its query path is resolved from the entity schema at query time."
+          }
+        },
+        "required": [
+          "attribute"
+        ],
+        "description": "One attribute participating in a match rule. Wrapped as an object so per-attribute options can be added later."
+      },
+      "UniquenessCriteriaCreateBody": {
+        "type": "object",
+        "properties": {
+          "schema": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Entity schema these criteria apply to."
+          },
+          "matchRules": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/MatchRule"
+            },
+            "minItems": 1
+          }
+        },
+        "required": [
+          "schema",
+          "matchRules"
+        ]
+      },
+      "UniquenessCriteriaUpdateBody": {
+        "type": "object",
+        "properties": {
+          "matchRules": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/MatchRule"
+            },
+            "minItems": 1
+          }
+        },
+        "required": [
+          "matchRules"
+        ]
       }
     }
   },

package/dist/bin/epilot.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "../chunk-5D7GCYYX.js";
+} from "../chunk-TGXMWYHZ.js";
 
 // bin/epilot.ts
 import { runMain } from "citty";
@@ -11,7 +11,7 @@ import { defineCommand } from "citty";
 var main = defineCommand({
   meta: {
     name: "epilot",
-    version: "0.1.86",
+    version: "0.1.88",
     description: "CLI for epilot APIs"
   },
   args: {
@@ -30,8 +30,8 @@ var main = defineCommand({
     auth: () => import("../auth-4HG7B2GC.js").then((m) => m.default),
     profile: () => import("../profile-OZJL5ZPT.js").then((m) => m.default),
     config: () => import("../config-DGZIMLZK.js").then((m) => m.default),
-    completion: () => import("../completion-N6A4VCAE.js").then((m) => m.default),
-    upgrade: () => import("../upgrade-KGIYMI4T.js").then((m) => m.default),
+    completion: () => import("../completion-NXJUERAR.js").then((m) => m.default),
+    upgrade: () => import("../upgrade-34IXMLDG.js").then((m) => m.default),
     "access-token": () => import("../access-token-WWE6BDJH.js").then((m) => m.default),
     address: () => import("../address-EH3C4CVB.js").then((m) => m.default),
     "address-suggestions": () => import("../address-suggestions-RRSLOBFW.js").then((m) => m.default),
@@ -134,13 +134,13 @@ process.stderr.on("error", (err) => {
   if (err.code === "EPIPE") process.exit(0);
   throw err;
 });
-var VERSION = true ? "0.1.86" : (await null).default.version;
+var VERSION = true ? "0.1.88" : (await null).default.version;
 var reorderedArgv = hoistFlagsAfterSubcommand(process.argv.slice(2));
 process.argv = [process.argv[0], process.argv[1], ...reorderedArgv];
 var args = process.argv.slice(2);
 var completionsIdx = args.indexOf("--_completions");
 if (completionsIdx >= 0) {
-  const { handleCompletions } = await import("../completion-N6A4VCAE.js");
+  const { handleCompletions } = await import("../completion-NXJUERAR.js");
   handleCompletions(args[completionsIdx + 1], args[completionsIdx + 2]);
   process.exit(0);
 }

package/dist/{chunk-5D7GCYYX.js → chunk-TGXMWYHZ.js}

@@ -489,8 +489,18 @@ var API_LIST = [
     kebabName: "deduplication",
     title: "Deduplication API",
     serverUrl: "https://deduplication.sls.epilot.io",
-    operationCount: 3,
-    operationIds: ["deduplicate", "deduplicateAsync", "getDeduplicationJob"]
+    operationCount: 9,
+    operationIds: [
+      "deduplicate",
+      "deduplicateAsync",
+      "getDeduplicationJob",
+      "detectDuplicates",
+      "listUniquenessCriteria",
+      "createUniquenessCriteria",
+      "getUniquenessCriteria",
+      "updateUniquenessCriteria",
+      "deleteUniquenessCriteria"
+    ]
   },
   {
     apiName: "design",

package/dist/{completion-N6A4VCAE.js → completion-NXJUERAR.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "./chunk-5D7GCYYX.js";
+} from "./chunk-TGXMWYHZ.js";
 import {
   DIM,
   GREEN,

package/dist/{upgrade-KGIYMI4T.js → upgrade-34IXMLDG.js}

@@ -72,7 +72,7 @@ ${GREEN}${BOLD}Upgraded to @epilot/cli@${latest}${RESET}
   }
 });
 var getCurrentVersion = () => {
-  if (true) return "0.1.86";
+  if (true) return "0.1.88";
   try {
     const output = execSync("npm ls -g @epilot/cli --depth=0 --json 2>/dev/null", {
       encoding: "utf-8",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/cli",
-  "version": "0.1.86",
+  "version": "0.1.88",
   "description": "CLI for epilot APIs",
   "type": "module",
   "bin": {