@proteos/sdk 0.52.0 → 0.53.0

package/dist/{types-DHhuGDpV.d.ts → types-D5P6yk1L.d.ts}

@@ -2086,7 +2086,7 @@ interface MetaListOptions extends ListOptions {
  * full set; format/structural variation lives on `Attribute.meta` (see
  * `AttributeMeta` below), not on the type discriminator.
  */
-type AttributeType = 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object' | 'datetime' | 'enum' | 'relation' | 'user' | 'principal' | 'currency' | 'knowledge-text' | 'file';
+type AttributeType = 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object' | 'datetime' | 'enum' | 'relation' | 'user' | 'principal' | 'currency' | 'knowledge-text' | 'file' | 'contact-address';
 /**
  * Attribute-level permissions: restricting a FIELD rather than a record — a
  * salary column readable only by the people team, a margin column writable only
@@ -2299,6 +2299,35 @@ declare const CurrencyAttributeMetaSchema: z.ZodObject<{
     default_currency_code?: string | undefined;
     allowed_currency_codes?: string[] | undefined;
 }>;
+/**
+ * Which endpoint a `contact-address` attribute holds. The record-capable
+ * subset of the conversation contact-address kinds — what a human types.
+ */
+type ContactAddressAttributeKind = 'email' | 'phone' | 'linkedin_public_identifier';
+/**
+ * Metadata for a `contact-address`-typed attribute: ONE canonical reachable
+ * address of the person the record represents. The stored value is a plain
+ * string canonicalized on write (lowercased email, E.164 phone with a leading
+ * `+`, LinkedIn public identifier — a pasted profile URL is reduced to its
+ * `/in/<slug>`; displayed as https://www.linkedin.com/in/<slug>; LinkedIn
+ * profile ids such as ACoAA… are refused — the platform learns them itself).
+ * Records carrying such values bind to exactly one conversation contact;
+ * `kind` is REQUIRED. Mirror of the Go `metamodel.ContactAddressAttributeMeta`.
+ */
+interface ContactAddressAttributeMeta {
+    kind: ContactAddressAttributeKind;
+    description?: string;
+}
+declare const ContactAddressAttributeMetaSchema: z.ZodObject<{
+    kind: z.ZodEnum<["email", "phone", "linkedin_public_identifier"]>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "email" | "phone" | "linkedin_public_identifier";
+    description?: string | undefined;
+}, {
+    kind: "email" | "phone" | "linkedin_public_identifier";
+    description?: string | undefined;
+}>;
 /**
  * Metadata for a `knowledge-text`-typed attribute. The value is a
  * {@link KnowledgeNodeRef}; the data-service materializes client-sent text
@@ -2337,7 +2366,7 @@ declare const FileAttributeMetaSchema: z.ZodObject<{
  * appropriate shape based on `Attribute.type`; runtime consumers can
  * narrow via the `type` field.
  */
-type AttributeMeta = StringAttributeMeta | NumberAttributeMeta | DatetimeAttributeMeta | ArrayAttributeMeta | ObjectAttributeMeta | EnumAttributeMeta | RelationAttributeMeta | UserAttributeMeta | PrincipalAttributeMeta | CurrencyAttributeMeta | KnowledgeTextAttributeMeta | FileAttributeMeta;
+type AttributeMeta = StringAttributeMeta | NumberAttributeMeta | DatetimeAttributeMeta | ArrayAttributeMeta | ObjectAttributeMeta | EnumAttributeMeta | RelationAttributeMeta | UserAttributeMeta | PrincipalAttributeMeta | CurrencyAttributeMeta | KnowledgeTextAttributeMeta | FileAttributeMeta | ContactAddressAttributeMeta;
 /**
  * Entity attribute definition. Mirrors `model.Attribute` in the Go SDK.
  */
@@ -2525,6 +2554,13 @@ declare function parseUserMeta(attr: Attribute): UserAttributeMeta | null;
  * with no meta still resolves to an empty `{}` rather than null.
  */
 declare function parseFileMeta(attr: Attribute): FileAttributeMeta | null;
+/**
+ * Returns the typed `ContactAddressAttributeMeta` when `attr` is a
+ * contact-address attribute with a valid kind; null otherwise. Unlike the
+ * `{}`-defaulting parsers, `kind` is required — an attribute without one
+ * cannot be canonicalized, so it resolves to null (shape of parseRelationMeta).
+ */
+declare function parseContactAddressMeta(attr: Attribute): ContactAddressAttributeMeta | null;
 /**
  * A single operation a resource may be publicly exposed for. Independent set
  * (not a level): a resource can be public for `write` without `read`. Only
@@ -2535,6 +2571,28 @@ type PublicAccessOperation = 'read' | 'write' | 'delete';
  * Entity definition.
  * Note: Entity uses `slug` as its primary identifier, not `id`.
  */
+/**
+ * What happens when a record's contact-address value already belongs to a
+ * contact linked to ANOTHER record of the same entity: `reject` fails the
+ * write (409 `record_duplicate`); `flag` (default) accepts it and raises a
+ * record duplicate pair for review.
+ */
+type ContactBindingDuplicatePolicy = 'reject' | 'flag';
+/**
+ * The entity-level contact-binding setting — meaningful only for entities
+ * with `contact-address` attributes; absent on the wire means `flag`. Mirror
+ * of the Go `metamodel.ContactBinding`.
+ */
+interface EntityContactBinding {
+    duplicate_policy: ContactBindingDuplicatePolicy;
+}
+declare const EntityContactBindingSchema: z.ZodObject<{
+    duplicate_policy: z.ZodEnum<["reject", "flag"]>;
+}, "strip", z.ZodTypeAny, {
+    duplicate_policy: "reject" | "flag";
+}, {
+    duplicate_policy: "reject" | "flag";
+}>;
 interface Entity extends AuditFields {
     slug: string;
     name: string;
@@ -2548,6 +2606,11 @@ interface Entity extends AuditFields {
      * (default).
      */
     public_record_access: PublicAccessOperation[];
+    /**
+     * Contact-binding setting (see `EntityContactBinding`). Optional: a Go
+     * build that predates the setting omits it, which means `flag`.
+     */
+    contact_binding?: EntityContactBinding;
     module_slug: string;
     /**
      * Liquid template that renders a human-readable title for an instance
@@ -2590,6 +2653,13 @@ declare const EntitySchema: z.ZodObject<{
     description: z.ZodString;
     is_remote: z.ZodBoolean;
     public_record_access: z.ZodDefault<z.ZodArray<z.ZodEnum<["read", "write", "delete"]>, "many">>;
+    contact_binding: z.ZodOptional<z.ZodObject<{
+        duplicate_policy: z.ZodEnum<["reject", "flag"]>;
+    }, "strip", z.ZodTypeAny, {
+        duplicate_policy: "reject" | "flag";
+    }, {
+        duplicate_policy: "reject" | "flag";
+    }>>;
     module_slug: z.ZodString;
     title_template: z.ZodDefault<z.ZodString>;
     attributes: z.ZodArray<z.ZodObject<{
@@ -2734,6 +2804,9 @@ declare const EntitySchema: z.ZodObject<{
     public_record_access: ("read" | "write" | "delete")[];
     module_slug: string;
     title_template: string;
+    contact_binding?: {
+        duplicate_policy: "reject" | "flag";
+    } | undefined;
 }, {
     name: string;
     created_at: string;
@@ -2775,6 +2848,9 @@ declare const EntitySchema: z.ZodObject<{
     is_remote: boolean;
     module_slug: string;
     public_record_access?: ("read" | "write" | "delete")[] | undefined;
+    contact_binding?: {
+        duplicate_policy: "reject" | "flag";
+    } | undefined;
     title_template?: string | undefined;
 }>;
 /**
@@ -2812,6 +2888,13 @@ declare const EntityWithSchemaSchema: z.ZodObject<{
     description: z.ZodString;
     is_remote: z.ZodBoolean;
     public_record_access: z.ZodDefault<z.ZodArray<z.ZodEnum<["read", "write", "delete"]>, "many">>;
+    contact_binding: z.ZodOptional<z.ZodObject<{
+        duplicate_policy: z.ZodEnum<["reject", "flag"]>;
+    }, "strip", z.ZodTypeAny, {
+        duplicate_policy: "reject" | "flag";
+    }, {
+        duplicate_policy: "reject" | "flag";
+    }>>;
     module_slug: z.ZodString;
     title_template: z.ZodDefault<z.ZodString>;
     attributes: z.ZodArray<z.ZodObject<{
@@ -2959,6 +3042,9 @@ declare const EntityWithSchemaSchema: z.ZodObject<{
     module_slug: string;
     title_template: string;
     schema: Record<string, unknown>;
+    contact_binding?: {
+        duplicate_policy: "reject" | "flag";
+    } | undefined;
 }, {
     name: string;
     created_at: string;
@@ -3001,6 +3087,9 @@ declare const EntityWithSchemaSchema: z.ZodObject<{
     module_slug: string;
     schema: Record<string, unknown>;
     public_record_access?: ("read" | "write" | "delete")[] | undefined;
+    contact_binding?: {
+        duplicate_policy: "reject" | "flag";
+    } | undefined;
     title_template?: string | undefined;
 }>;
 /**
@@ -3025,6 +3114,10 @@ interface CreateEntityRequest {
      * the field resets it to private.
      */
     public_record_access?: PublicAccessOperation[];
+    /**
+     * Contact-binding setting; full-replacement on upsert (omitted = `flag`).
+     */
+    contact_binding?: EntityContactBinding;
     module_slug: string;
     description: string;
     title_template?: string;
@@ -3037,6 +3130,7 @@ interface UpdateEntityRequest {
     name?: string;
     is_remote?: boolean;
     public_record_access?: PublicAccessOperation[];
+    contact_binding?: EntityContactBinding;
     module_slug?: string;
     description?: string;
     title_template?: string;
@@ -3462,8 +3556,8 @@ declare const PageActionSchema: z.ZodObject<{
     workflow?: string | undefined;
     inputs?: Record<string, string> | undefined;
     skip_confirmation?: boolean | undefined;
-    action?: string | undefined;
     kind?: "workflow" | "action" | undefined;
+    action?: string | undefined;
 }, {
     label: string;
     icon: string;
@@ -3472,8 +3566,8 @@ declare const PageActionSchema: z.ZodObject<{
     workflow?: string | undefined;
     inputs?: Record<string, string> | undefined;
     skip_confirmation?: boolean | undefined;
-    action?: string | undefined;
     kind?: "workflow" | "action" | undefined;
+    action?: string | undefined;
 }>;
 /**
  * Whether a list's rows can be checked, and whether the checkboxes show from
@@ -3596,8 +3690,8 @@ declare const ListSchema: z.ZodObject<{
         workflow?: string | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
-        action?: string | undefined;
         kind?: "workflow" | "action" | undefined;
+        action?: string | undefined;
     }, {
         label: string;
         icon: string;
@@ -3606,8 +3700,8 @@ declare const ListSchema: z.ZodObject<{
         workflow?: string | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
-        action?: string | undefined;
         kind?: "workflow" | "action" | undefined;
+        action?: string | undefined;
     }>, "many">>;
     selection_mode: z.ZodOptional<z.ZodEnum<["on_demand", "always", "off"]>>;
     sorting: z.ZodArray<z.ZodObject<{
@@ -3655,8 +3749,8 @@ declare const ListSchema: z.ZodObject<{
         workflow?: string | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
-        action?: string | undefined;
         kind?: "workflow" | "action" | undefined;
+        action?: string | undefined;
     }[] | undefined;
     selection_mode?: "on_demand" | "always" | "off" | undefined;
 }, {
@@ -3693,8 +3787,8 @@ declare const ListSchema: z.ZodObject<{
         workflow?: string | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
-        action?: string | undefined;
         kind?: "workflow" | "action" | undefined;
+        action?: string | undefined;
     }[] | undefined;
     selection_mode?: "on_demand" | "always" | "off" | undefined;
 }>;
@@ -3966,8 +4060,8 @@ declare const PageSchema: z.ZodObject<{
         workflow?: string | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
-        action?: string | undefined;
         kind?: "workflow" | "action" | undefined;
+        action?: string | undefined;
     }, {
         label: string;
         icon: string;
@@ -3976,8 +4070,8 @@ declare const PageSchema: z.ZodObject<{
         workflow?: string | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
-        action?: string | undefined;
         kind?: "workflow" | "action" | undefined;
+        action?: string | undefined;
     }>, "many">;
     layout: z.ZodObject<{
         version: z.ZodLiteral<1>;
@@ -4063,8 +4157,8 @@ declare const PageSchema: z.ZodObject<{
         workflow?: string | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
-        action?: string | undefined;
         kind?: "workflow" | "action" | undefined;
+        action?: string | undefined;
     }[];
     layout: {
         version: 1;
@@ -4105,8 +4199,8 @@ declare const PageSchema: z.ZodObject<{
         workflow?: string | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
-        action?: string | undefined;
         kind?: "workflow" | "action" | undefined;
+        action?: string | undefined;
     }[];
     layout: {
         version: 1;
@@ -5087,8 +5181,8 @@ declare const ListExtensionSchema: z.ZodObject<{
         workflow?: string | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
-        action?: string | undefined;
         kind?: "workflow" | "action" | undefined;
+        action?: string | undefined;
     }, {
         label: string;
         icon: string;
@@ -5097,8 +5191,8 @@ declare const ListExtensionSchema: z.ZodObject<{
         workflow?: string | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
-        action?: string | undefined;
         kind?: "workflow" | "action" | undefined;
+        action?: string | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     key: string;
@@ -5134,8 +5228,8 @@ declare const ListExtensionSchema: z.ZodObject<{
         workflow?: string | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
-        action?: string | undefined;
         kind?: "workflow" | "action" | undefined;
+        action?: string | undefined;
     }[];
     org_id: string;
 }, {
@@ -5172,8 +5266,8 @@ declare const ListExtensionSchema: z.ZodObject<{
         workflow?: string | undefined;
         inputs?: Record<string, string> | undefined;
         skip_confirmation?: boolean | undefined;
-        action?: string | undefined;
         kind?: "workflow" | "action" | undefined;
+        action?: string | undefined;
     }[];
     org_id: string;
 }>;
@@ -5612,4 +5706,4 @@ declare function isCurrentUserDefault(value: unknown): value is CurrentUserDefau
 /** Only the identity-valued attribute types can carry the sentinel. */
 declare function acceptsCurrentUserDefault(type: AttributeType): boolean;
 
-export { DEFAULT_PAGE_SIZE as $, type AuditFields as A, type ComponentService as B, CURRENT_USER_DEFAULT as C, type CreateAppConfigurationRequest as D, type CreateAppRequest as E, type FileRef as F, type CreateComponentRequest as G, type CreateDesignReferenceRequest as H, type CreateEntityExtensionRequest as I, type CreateEntityRequest as J, type CreateListExtensionRequest as K, type ListOptions as L, type CreateListRequest as M, type CreateListViewRequest as N, type CreateMenuConfigurationExtensionRequest as O, PageIterator as P, type CreateMenuConfigurationRequest as Q, type CreatePageExtensionRequest as R, type CreatePageRequest as S, type CreateVariableRequest as T, type UserRef as U, type CurrencyAttributeMeta as V, CurrencyAttributeMetaSchema as W, type CurrencySymbolSide as X, type CurrencyValue as Y, type CurrentUserDefault as Z, DEFAULT_OPTIONS as _, type Attribute as a, type MenuConfigurationService as a$, DONE as a0, type DeployModuleRequest as a1, type DesignReference as a2, type DesignReferenceContent as a3, DesignReferenceSchema as a4, type DesignReferenceService as a5, type Done as a6, type Entity as a7, type EntityExtension as a8, EntityExtensionSchema as a9, type ListExtensionService as aA, type ListFn as aB, type ListListExtensionsOptions as aC, type ListListViewsOptions as aD, type ListListsOptions as aE, type ListMenuConfigurationExtensionsOptions as aF, type ListMenuConfigurationsOptions as aG, type ListModulesOptions as aH, type ListPageExtensionsOptions as aI, type ListPagesOptions as aJ, ListSchema as aK, type ListService as aL, type ListVariablesOptions as aM, type ListView as aN, ListViewSchema as aO, type ListViewService as aP, type LogicalOperator as aQ, MENU_CONFIGURATION_EXTENSION_ANCHOR_ITEMS as aR, type MenuConfiguration as aS, type MenuConfigurationExtension as aT, type MenuConfigurationExtensionPlacement as aU, MenuConfigurationExtensionPlacementSchema as aV, type MenuConfigurationExtensionPosition as aW, MenuConfigurationExtensionPositionSchema as aX, MenuConfigurationExtensionSchema as aY, type MenuConfigurationExtensionService as aZ, MenuConfigurationSchema as a_, type EntityExtensionService as aa, EntitySchema as ab, type EntityService as ac, type EntityWithSchema as ad, EntityWithSchemaSchema as ae, type EnumAttributeMeta as af, type EnumValue as ag, type ExtensionPosition as ah, ExtensionPositionSchema as ai, type FileAttributeMeta as aj, FileRefSchema as ak, type FilterElement as al, FilterElementSchema as am, type FilterGroup as an, FilterGroupSchema as ao, type List as ap, type ListAppConfigurationsOptions as aq, type ListAppsOptions as ar, type ListComponentsOptions as as, type ListDesignReferencesOptions as at, type ListEntitiesOptions as au, type ListEntityExtensionsOptions as av, type ListExtension as aw, type ListExtensionColumnPlacement as ax, ListExtensionColumnPlacementSchema as ay, ListExtensionSchema as az, type ListResult as b, createIterator as b$, type MenuItem as b0, MenuItemSchema as b1, MenuItemType as b2, MetaClient as b3, type MetaListOptions as b4, type Module as b5, ModuleSchema as b6, type ModuleService as b7, type ModuleStatus as b8, type OnDeleteAction as b9, ResponseMetaSchema as bA, type SortConfig as bB, SortConfigSchema as bC, type SortDirection as bD, type Timestamps as bE, type TokenProvider as bF, type UpdateAppConfigurationRequest as bG, type UpdateAppRequest as bH, type UpdateComponentRequest as bI, type UpdateDesignReferenceRequest as bJ, type UpdateEntityExtensionRequest as bK, type UpdateEntityRequest as bL, type UpdateListExtensionRequest as bM, type UpdateListRequest as bN, type UpdateListViewRequest as bO, type UpdateMenuConfigurationExtensionRequest as bP, type UpdateMenuConfigurationRequest as bQ, type UpdatePageExtensionRequest as bR, type UpdatePageRequest as bS, type UpdateVariableRequest as bT, UserRefSchema as bU, type UserType as bV, type Variable as bW, VariableSchema as bX, type VariableService as bY, acceptsCurrentUserDefault as bZ, allCurrencyCodes as b_, OnDeleteActionSchema as ba, PAGE_EXTENSION_ANCHOR_MAIN as bb, PAGE_EXTENSION_ANCHOR_SIDE_PANEL as bc, PLATFORM_ATTRIBUTE_NAMES as bd, PLATFORM_USER_ID as be, type Page as bf, type PageAction as bg, type PageActionKind as bh, PageActionSchema as bi, type PageExtension as bj, type PageExtensionPlacement as bk, PageExtensionPlacementSchema as bl, PageExtensionSchema as bm, type PageExtensionService as bn, type PageLayout as bo, PageLayoutSchema as bp, PageSchema as bq, type PageService as br, type PageType as bs, type PublicPageComponent as bt, type PublicPageResponse as bu, type RelationAttributeMeta as bv, RelationAttributeMetaSchema as bw, type RequestOptions as bx, type ResolvedClientOptions as by, type ResponseMeta as bz, ProteosClient as c, UserAttributeMetaSchema as c$, createListResultSchema as c0, currencyLabel as c1, currencySymbol as c2, currencySymbolSide as c3, formatAmount as c4, formatMoney as c5, isCurrentUserDefault as c6, isPlatformAttributeName as c7, localeNumberSeparators as c8, parseAmount as c9, LayoutTabSchema as cA, type ListElement as cB, type NumberAttributeMeta as cC, type ObjectAttributeMeta as cD, PAGE_BACKGROUND_TOKENS as cE, type PageBackgroundToken as cF, type PageLayoutSidePanel as cG, PageLayoutSidePanelSchema as cH, type PageStyle as cI, PageStyleSchema as cJ, type PrincipalAttributeMeta as cK, type PrincipalType as cL, type RecordFilterElement as cM, type RelatedListElement as cN, type RelatedRecordElement as cO, type ResponsiveSizing as cP, type RowElement as cQ, type SectionElement as cR, type SizeValue as cS, SizeValueSchema as cT, type SizingProps as cU, type StringAttributeMeta as cV, type StringFormat as cW, type TabsElement as cX, type TextElement as cY, type TextVariant as cZ, type UserAttributeMeta as c_, parseCurrencyMeta as ca, parseFileMeta as cb, parseRelationMeta as cc, platformAttributes as cd, resolveOptions as ce, type AttributeForLookup as cf, type AttributeMeta as cg, BUILT_IN_CONTROLS as ch, type BuiltInControlSlug as ci, type CardElement as cj, type ColumnElement as ck, type CommonProps as cl, type ComponentElement as cm, type ControlBucket as cn, type DatetimeAttributeMeta as co, type DatetimeFormat as cp, type DividerElement as cq, type FieldElement as cr, FileAttributeMetaSchema as cs, type LayoutAlign as ct, type LayoutElement as cu, LayoutElementSchema as cv, LayoutElementType as cw, type LayoutGap as cx, type LayoutJustify as cy, type LayoutTab as cz, type PrincipalRef as d, type WorkflowTriggerElement as d0, isBuiltInControl as d1, lookupCompatibleControls as d2, lookupControls as d3, lookupPrimaryControl as d4, parsePrincipalMeta as d5, parseUserMeta as d6, type PublicAccessOperation as e, type App as f, type AppConfiguration as g, AppConfigurationSchema as h, type AppConfigurationService as i, type AppHome as j, AppHomeSchema as k, type AppHomeType as l, AppSchema as m, type AppService as n, type ArrayAttributeMeta as o, type AttributeAccessRule as p, type AttributeRestrictions as q, AttributeSchema as r, type AttributeType as s, AuditFieldsSchema as t, type ClientOptions as u, type Column as v, ColumnSchema as w, type ComparisonOperator as x, type Component as y, ComponentSchema as z };
+export { type CurrencySymbolSide as $, type AuditFields as A, type ComponentService as B, CURRENT_USER_DEFAULT as C, type ContactAddressAttributeKind as D, type ContactAddressAttributeMeta as E, type FileRef as F, ContactAddressAttributeMetaSchema as G, type ContactBindingDuplicatePolicy as H, type CreateAppConfigurationRequest as I, type CreateAppRequest as J, type CreateComponentRequest as K, type ListOptions as L, type CreateDesignReferenceRequest as M, type CreateEntityExtensionRequest as N, type CreateEntityRequest as O, PageIterator as P, type CreateListExtensionRequest as Q, type CreateListRequest as R, type CreateListViewRequest as S, type CreateMenuConfigurationExtensionRequest as T, type UserRef as U, type CreateMenuConfigurationRequest as V, type CreatePageExtensionRequest as W, type CreatePageRequest as X, type CreateVariableRequest as Y, type CurrencyAttributeMeta as Z, CurrencyAttributeMetaSchema as _, type Attribute as a, MenuConfigurationExtensionPlacementSchema as a$, type CurrencyValue as a0, type CurrentUserDefault as a1, DEFAULT_OPTIONS as a2, DEFAULT_PAGE_SIZE as a3, DONE as a4, type DeployModuleRequest as a5, type DesignReference as a6, type DesignReferenceContent as a7, DesignReferenceSchema as a8, type DesignReferenceService as a9, type ListEntitiesOptions as aA, type ListEntityExtensionsOptions as aB, type ListExtension as aC, type ListExtensionColumnPlacement as aD, ListExtensionColumnPlacementSchema as aE, ListExtensionSchema as aF, type ListExtensionService as aG, type ListFn as aH, type ListListExtensionsOptions as aI, type ListListViewsOptions as aJ, type ListListsOptions as aK, type ListMenuConfigurationExtensionsOptions as aL, type ListMenuConfigurationsOptions as aM, type ListModulesOptions as aN, type ListPageExtensionsOptions as aO, type ListPagesOptions as aP, ListSchema as aQ, type ListService as aR, type ListVariablesOptions as aS, type ListView as aT, ListViewSchema as aU, type ListViewService as aV, type LogicalOperator as aW, MENU_CONFIGURATION_EXTENSION_ANCHOR_ITEMS as aX, type MenuConfiguration as aY, type MenuConfigurationExtension as aZ, type MenuConfigurationExtensionPlacement as a_, type Done as aa, type Entity as ab, type EntityContactBinding as ac, EntityContactBindingSchema as ad, type EntityExtension as ae, EntityExtensionSchema as af, type EntityExtensionService as ag, EntitySchema as ah, type EntityService as ai, type EntityWithSchema as aj, EntityWithSchemaSchema as ak, type EnumAttributeMeta as al, type EnumValue as am, type ExtensionPosition as an, ExtensionPositionSchema as ao, type FileAttributeMeta as ap, FileRefSchema as aq, type FilterElement as ar, FilterElementSchema as as, type FilterGroup as at, FilterGroupSchema as au, type List as av, type ListAppConfigurationsOptions as aw, type ListAppsOptions as ax, type ListComponentsOptions as ay, type ListDesignReferencesOptions as az, type ListResult as b, type UserType as b$, type MenuConfigurationExtensionPosition as b0, MenuConfigurationExtensionPositionSchema as b1, MenuConfigurationExtensionSchema as b2, type MenuConfigurationExtensionService as b3, MenuConfigurationSchema as b4, type MenuConfigurationService as b5, type MenuItem as b6, MenuItemSchema as b7, MenuItemType as b8, MetaClient as b9, type PublicPageResponse as bA, type RelationAttributeMeta as bB, RelationAttributeMetaSchema as bC, type RequestOptions as bD, type ResolvedClientOptions as bE, type ResponseMeta as bF, ResponseMetaSchema as bG, type SortConfig as bH, SortConfigSchema as bI, type SortDirection as bJ, type Timestamps as bK, type TokenProvider as bL, type UpdateAppConfigurationRequest as bM, type UpdateAppRequest as bN, type UpdateComponentRequest as bO, type UpdateDesignReferenceRequest as bP, type UpdateEntityExtensionRequest as bQ, type UpdateEntityRequest as bR, type UpdateListExtensionRequest as bS, type UpdateListRequest as bT, type UpdateListViewRequest as bU, type UpdateMenuConfigurationExtensionRequest as bV, type UpdateMenuConfigurationRequest as bW, type UpdatePageExtensionRequest as bX, type UpdatePageRequest as bY, type UpdateVariableRequest as bZ, UserRefSchema as b_, type MetaListOptions as ba, type Module as bb, ModuleSchema as bc, type ModuleService as bd, type ModuleStatus as be, type OnDeleteAction as bf, OnDeleteActionSchema as bg, PAGE_EXTENSION_ANCHOR_MAIN as bh, PAGE_EXTENSION_ANCHOR_SIDE_PANEL as bi, PLATFORM_ATTRIBUTE_NAMES as bj, PLATFORM_USER_ID as bk, type Page as bl, type PageAction as bm, type PageActionKind as bn, PageActionSchema as bo, type PageExtension as bp, type PageExtensionPlacement as bq, PageExtensionPlacementSchema as br, PageExtensionSchema as bs, type PageExtensionService as bt, type PageLayout as bu, PageLayoutSchema as bv, PageSchema as bw, type PageService as bx, type PageType as by, type PublicPageComponent as bz, ProteosClient as c, type SizingProps as c$, type Variable as c0, VariableSchema as c1, type VariableService as c2, acceptsCurrentUserDefault as c3, allCurrencyCodes as c4, createIterator as c5, createListResultSchema as c6, currencyLabel as c7, currencySymbol as c8, currencySymbolSide as c9, type LayoutAlign as cA, type LayoutElement as cB, LayoutElementSchema as cC, LayoutElementType as cD, type LayoutGap as cE, type LayoutJustify as cF, type LayoutTab as cG, LayoutTabSchema as cH, type ListElement as cI, type NumberAttributeMeta as cJ, type ObjectAttributeMeta as cK, PAGE_BACKGROUND_TOKENS as cL, type PageBackgroundToken as cM, type PageLayoutSidePanel as cN, PageLayoutSidePanelSchema as cO, type PageStyle as cP, PageStyleSchema as cQ, type PrincipalAttributeMeta as cR, type PrincipalType as cS, type RecordFilterElement as cT, type RelatedListElement as cU, type RelatedRecordElement as cV, type ResponsiveSizing as cW, type RowElement as cX, type SectionElement as cY, type SizeValue as cZ, SizeValueSchema as c_, formatAmount as ca, formatMoney as cb, isCurrentUserDefault as cc, isPlatformAttributeName as cd, localeNumberSeparators as ce, parseAmount as cf, parseContactAddressMeta as cg, parseCurrencyMeta as ch, parseFileMeta as ci, parseRelationMeta as cj, platformAttributes as ck, resolveOptions as cl, type AttributeForLookup as cm, type AttributeMeta as cn, BUILT_IN_CONTROLS as co, type BuiltInControlSlug as cp, type CardElement as cq, type ColumnElement as cr, type CommonProps as cs, type ComponentElement as ct, type ControlBucket as cu, type DatetimeAttributeMeta as cv, type DatetimeFormat as cw, type DividerElement as cx, type FieldElement as cy, FileAttributeMetaSchema as cz, type PrincipalRef as d, type StringAttributeMeta as d0, type StringFormat as d1, type TabsElement as d2, type TextElement as d3, type TextVariant as d4, type UserAttributeMeta as d5, UserAttributeMetaSchema as d6, type WorkflowTriggerElement as d7, isBuiltInControl as d8, lookupCompatibleControls as d9, lookupControls as da, lookupPrimaryControl as db, parsePrincipalMeta as dc, parseUserMeta as dd, type PublicAccessOperation as e, type App as f, type AppConfiguration as g, AppConfigurationSchema as h, type AppConfigurationService as i, type AppHome as j, AppHomeSchema as k, type AppHomeType as l, AppSchema as m, type AppService as n, type ArrayAttributeMeta as o, type AttributeAccessRule as p, type AttributeRestrictions as q, AttributeSchema as r, type AttributeType as s, AuditFieldsSchema as t, type ClientOptions as u, type Column as v, ColumnSchema as w, type ComparisonOperator as x, type Component as y, ComponentSchema as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteos/sdk",
-  "version": "0.52.0",
+  "version": "0.53.0",
   "license": "Apache-2.0",
   "description": "TypeScript SDK for the Proteos platform",
   "repository": {
@@ -66,8 +66,8 @@
     "tsup": "^8.3.0",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0",
-    "@proteos/biome-config": "0.0.0",
-    "@proteos/tsconfig": "0.0.0"
+    "@proteos/tsconfig": "0.0.0",
+    "@proteos/biome-config": "0.0.0"
   },
   "scripts": {
     "build": "tsup",

package/src/conversation/types.ts

@@ -1264,6 +1264,11 @@ export type ContactAddressKind =
   | 'email'
   | 'phone'
   | 'slack'
+  /** LinkedIn's stable profile id (ACoAA… / ACwAA… / AE…) — what sending needs. */
+  | 'linkedin_id'
+  /** The `/in/<slug>` public identifier — what humans and records hold. */
+  | 'linkedin_public_identifier'
+  /** Legacy alias of `linkedin_id` (rows written before the kind split); read-only. */
   | 'linkedin'
   | 'telegram'
   | 'instagram'
@@ -1501,10 +1506,25 @@ export interface AttachContactAddressRequest {
   name?: string
 }
 
+/** How a contact→record edge came to be: a user's explicit link, or the
+ * binding maintained from the record's contact-address attributes (exactly one
+ * per record; never unlinked by hand). */
+export type ContactRecordLinkSource = 'manual' | 'record'
+
+/** One canonical address key of a contact (the dedup backbone). */
+export interface ContactAddressKey {
+  kind: ContactAddressKind
+  value: string
+  scope?: string
+  raw_value?: string
+}
+
 /**
  * A directed edge from a contact to a business record (entity_slug +
  * record_id). Bare — no role; the relationship's semantics come from the
- * target entity. Immutable once created.
+ * target entity. A `manual` link is immutable once created; a `record`
+ * binding repoints/refreshes as the record's addresses change and carries the
+ * keys the record contributed (`address_keys`).
  */
 export interface ContactRecordLink {
   id: string
@@ -1512,8 +1532,12 @@ export interface ContactRecordLink {
   contact_id: string
   entity_slug: string
   record_id: string
+  source: ContactRecordLinkSource
+  address_keys?: ContactAddressKey[]
   created_at: string
   created_by: UserRef
+  updated_at?: string
+  updated_by?: UserRef
 }
 
 export interface CreateContactRecordLinkRequest {
@@ -1526,6 +1550,7 @@ export interface ListContactRecordLinksQuery extends PaginationQuery {
   contact_id?: string
   entity_slug?: string
   record_id?: string
+  source?: ContactRecordLinkSource
 }
 
 export interface MergeContactsRequest {
@@ -1792,9 +1817,17 @@ export type SendingPeriod = 'rolling_24h' | 'rolling_7d' | 'rolling_30d'
  * ONE kind of act performed through a channel connection — shared by a
  * limit's `action` (what it counts), a channel action's `action_type` (what
  * was performed) and the eligibility check. `message` is the plain send
- * (valid on a limit, never on a channel action row).
- */
-export type ChannelActionType = 'message' | 'invitation' | 'inmail' | 'profile_visit'
+ * (valid on a limit, never on a channel action row). `profile_lookup` is the
+ * silent twin of `profile_visit`: one provider read the platform performs to
+ * learn a person's full identity (LinkedIn profile id + public identifier),
+ * ledgered and limited like any other act.
+ */
+export type ChannelActionType =
+  | 'message'
+  | 'invitation'
+  | 'inmail'
+  | 'profile_visit'
+  | 'profile_lookup'
 export type Weekday =
   | 'monday'
   | 'tuesday'

package/src/data/index.ts

@@ -1,6 +1,11 @@
 import type { ProteosClient } from '../client.js'
 import { type QueryService, QueryServiceImpl } from './queries.js'
-import { type RecordService, RecordServiceImpl } from './records.js'
+import {
+  type RecordDuplicateService,
+  RecordDuplicateServiceImpl,
+  type RecordService,
+  RecordServiceImpl,
+} from './records.js'
 
 /**
  * Facade for the data-service (records + raw-SQL query API).
@@ -16,10 +21,13 @@ import { type RecordService, RecordServiceImpl } from './records.js'
 export class DataClient {
   readonly records: RecordService
   readonly queries: QueryService
+  /** Duplicate pairs of an entity's records (raised by contact binding). */
+  readonly recordDuplicates: RecordDuplicateService
 
   constructor(client: ProteosClient) {
     this.records = new RecordServiceImpl(client)
     this.queries = new QueryServiceImpl(client)
+    this.recordDuplicates = new RecordDuplicateServiceImpl(client)
   }
 }
 
@@ -33,15 +41,20 @@ export type {
   QueryValidateMeta,
   QueryValidateResponse,
 } from './queries.js'
-export type { RecordService } from './records.js'
+export type { RecordDuplicateService, RecordService } from './records.js'
 export type {
   BatchTransactionError,
   BatchTransactionStatus,
   BatchUpsertRecordsResponse,
   BatchUpsertTransaction,
   BatchUpsertTransactionResult,
+  ListRecordDuplicatesQuery,
   ListRecordsOptions,
+  PublishContactObservationsResponse,
   RecordData,
+  RecordDuplicate,
+  RecordDuplicateSource,
+  RecordDuplicateStatus,
 } from './types.js'
 
 // Re-export Zod schemas

package/src/data/records.ts

@@ -4,8 +4,11 @@ import type { ListResult } from '../types/common.js'
 import type {
   BatchUpsertRecordsResponse,
   BatchUpsertTransaction,
+  ListRecordDuplicatesQuery,
   ListRecordsOptions,
+  PublishContactObservationsResponse,
   RecordData,
+  RecordDuplicate,
 } from './types.js'
 
 const RECORDS_BASE_PATH = '/data/v1/records'
@@ -92,6 +95,26 @@ export interface RecordService {
    * (bare refs) on this path.
    */
   getPublic(orgId: string, entitySlug: string, id: string): Promise<RecordData>
+  /**
+   * Replays ONE page of the entity's records as record_contact_observation
+   * events (the backfill after an attribute became contact-address). Requires
+   * unscoped write on the entity; loop until `page + 1 >= pages_total`.
+   */
+  publishContactObservations(
+    entitySlug: string,
+    options?: { page?: number; page_size?: number },
+  ): Promise<PublishContactObservationsResponse>
+}
+
+/**
+ * Record duplicates — "these two records may be the same thing" pairs of one
+ * entity (see `RecordDuplicate`). Reading = entity read, dismissing = entity write.
+ */
+export interface RecordDuplicateService {
+  list(entitySlug: string, query?: ListRecordDuplicatesQuery): Promise<ListResult<RecordDuplicate>>
+  get(entitySlug: string, id: string): Promise<RecordDuplicate>
+  /** Closes a pair as "not a duplicate" (409 `record_duplicate_not_open` when already closed). */
+  dismiss(entitySlug: string, id: string): Promise<RecordDuplicate>
 }
 
 /**
@@ -149,6 +172,17 @@ export class RecordServiceImpl implements RecordService {
     )
   }
 
+  async publishContactObservations(
+    entitySlug: string,
+    options: { page?: number; page_size?: number } = {},
+  ): Promise<PublishContactObservationsResponse> {
+    return this.client.requestWithQuery<PublishContactObservationsResponse>(
+      'POST',
+      `${RECORDS_BASE_PATH}/${entitySlug}/contact-observations`,
+      options,
+    )
+  }
+
   listPublic(
     orgId: string,
     entitySlug: string,
@@ -180,3 +214,32 @@ export class RecordServiceImpl implements RecordService {
     )
   }
 }
+
+export class RecordDuplicateServiceImpl implements RecordDuplicateService {
+  constructor(private readonly client: ProteosClient) {}
+
+  async list(
+    entitySlug: string,
+    query: ListRecordDuplicatesQuery = {},
+  ): Promise<ListResult<RecordDuplicate>> {
+    return this.client.requestWithQuery<ListResult<RecordDuplicate>>(
+      'GET',
+      `${RECORDS_BASE_PATH}/${entitySlug}/duplicates`,
+      query,
+    )
+  }
+
+  async get(entitySlug: string, id: string): Promise<RecordDuplicate> {
+    return this.client.request<RecordDuplicate>(
+      'GET',
+      `${RECORDS_BASE_PATH}/${entitySlug}/duplicates/${encodeURIComponent(id)}`,
+    )
+  }
+
+  async dismiss(entitySlug: string, id: string): Promise<RecordDuplicate> {
+    return this.client.request<RecordDuplicate>(
+      'POST',
+      `${RECORDS_BASE_PATH}/${entitySlug}/duplicates/${encodeURIComponent(id)}/dismiss`,
+    )
+  }
+}

package/src/data/types.ts

@@ -96,3 +96,55 @@ export const BatchUpsertTransactionResultSchema = z.object({
 export const BatchUpsertRecordsResponseSchema = z.object({
   results: z.array(BatchUpsertTransactionResultSchema),
 })
+
+// ── Record duplicates ─────────────────────────────────────────────────────────
+
+/** How a duplicate pair was detected. `contact_binding` = two records bound to
+ * the same conversation contact through their contact-address attributes. */
+export type RecordDuplicateSource = 'contact_binding' | (string & {})
+
+export type RecordDuplicateStatus = 'open' | 'dismissed' | 'resolved'
+
+/**
+ * "These two records of one entity may be the same thing." Asymmetric:
+ * `primary_record_id` is the record to keep, `secondary_record_id` the
+ * newcomer. A group of colliding records has ONE primary and one row per other
+ * member (four records = three rows). `evidence` is shaped by `source` — for
+ * `contact_binding`: `{ contact_id, address_keys: [{kind, value}] }`.
+ */
+export interface RecordDuplicate {
+  id: string
+  org_id: string
+  entity_slug: string
+  primary_record_id: string
+  secondary_record_id: string
+  source: RecordDuplicateSource
+  evidence: Record<string, unknown>
+  status: RecordDuplicateStatus
+  resolved_by?: { type: string; id: string }
+  resolved_at?: string
+  created_at: string
+  created_by: { type: string; id: string }
+  updated_at: string
+  updated_by: { type: string; id: string }
+}
+
+export interface ListRecordDuplicatesQuery {
+  /** Only pairs this record takes part in (either side). */
+  record_id?: string
+  /** Defaults to `open` on the server. */
+  status?: RecordDuplicateStatus
+  page?: number
+  page_size?: number
+}
+
+/** ONE page of an entity's records replayed as contact observations. */
+export interface PublishContactObservationsResponse {
+  entity_slug: string
+  page: number
+  page_size: number
+  pages_total: number
+  items_total: number
+  published: number
+  skipped: number
+}