@proteos/sdk 0.52.0 → 0.53.0

package/src/index.ts

@@ -271,6 +271,7 @@ export type {
   ConsentStatus,
   Contact,
   ContactAddress,
+  ContactAddressKey,
   ContactAddressKind,
   ContactAddressSource,
   ContactErasureRequest,
@@ -278,6 +279,8 @@ export type {
   ContactGroupService,
   ContactGroupSource,
   ContactMergeProposal,
+  ContactRecordLink,
+  ContactRecordLinkSource,
   ContactRef,
   ContactService,
   ContactSource,
@@ -304,6 +307,7 @@ export type {
   CreateAgentListenerRequest,
   CreateConnectionRequest,
   CreateContactGroupRequest,
+  CreateContactRecordLinkRequest,
   CreateContactRequest,
   CreateConversationBriefRequest,
   CreateConversationFilterRequest,
@@ -345,6 +349,7 @@ export type {
   ListContactAddressesQuery,
   ListContactGroupsQuery,
   ListContactMergeProposalsQuery,
+  ListContactRecordLinksQuery,
   ListContactsQuery,
   ListConversationBriefsQuery,
   ListConversationFilterEventsQuery,
@@ -449,7 +454,9 @@ export type {
   BatchUpsertRecordsResponse,
   BatchUpsertTransaction,
   BatchUpsertTransactionResult,
+  ListRecordDuplicatesQuery,
   ListRecordsOptions,
+  PublishContactObservationsResponse,
   QueryExecuteMeta,
   QueryExecuteResponse,
   QueryRow,
@@ -457,6 +464,10 @@ export type {
   QueryValidateMeta,
   QueryValidateResponse,
   RecordData,
+  RecordDuplicate,
+  RecordDuplicateService,
+  RecordDuplicateSource,
+  RecordDuplicateStatus,
   RecordService,
 } from './data/index.js'
 // Data client (data-service)
@@ -602,6 +613,10 @@ export type {
   // Component types
   Component,
   ComponentService,
+  // Currency attribute meta + value
+  ContactAddressAttributeKind,
+  ContactAddressAttributeMeta,
+  ContactBindingDuplicatePolicy,
   CreateAppConfigurationRequest,
   CreateAppRequest,
   CreateComponentRequest,
@@ -616,7 +631,6 @@ export type {
   CreatePageExtensionRequest,
   CreatePageRequest,
   CreateVariableRequest,
-  // Currency attribute meta + value
   CurrencyAttributeMeta,
   CurrencySymbolSide,
   CurrencyValue,
@@ -628,6 +642,7 @@ export type {
   DesignReferenceService,
   // Entity types
   Entity,
+  EntityContactBinding,
   EntityExtension,
   EntityExtensionService,
   EntityService,
@@ -726,12 +741,14 @@ export {
   allCurrencyCodes,
   ColumnSchema,
   ComponentSchema,
+  ContactAddressAttributeMetaSchema,
   CURRENT_USER_DEFAULT,
   CurrencyAttributeMetaSchema,
   currencyLabel,
   currencySymbol,
   currencySymbolSide,
   DesignReferenceSchema,
+  EntityContactBindingSchema,
   EntityExtensionSchema,
   EntitySchema,
   EntityWithSchemaSchema,
@@ -766,6 +783,7 @@ export {
   PageSchema,
   PLATFORM_ATTRIBUTE_NAMES,
   parseAmount,
+  parseContactAddressMeta,
   parseCurrencyMeta,
   parseFileMeta,
   parseRelationMeta,

package/src/meta/index.ts

@@ -182,6 +182,10 @@ export type {
   ComparisonOperator,
   // Component types
   Component,
+  // Currency attribute meta + value
+  ContactAddressAttributeKind,
+  ContactAddressAttributeMeta,
+  ContactBindingDuplicatePolicy,
   CreateAppConfigurationRequest,
   CreateAppRequest,
   CreateComponentRequest,
@@ -196,7 +200,6 @@ export type {
   CreatePageExtensionRequest,
   CreatePageRequest,
   CreateVariableRequest,
-  // Currency attribute meta + value
   CurrencyAttributeMeta,
   CurrencyValue,
   CurrentUserDefault,
@@ -208,6 +211,7 @@ export type {
   DesignReferenceContent,
   // Entity types
   Entity,
+  EntityContactBinding,
   // EntityExtension types
   EntityExtension,
   EntityWithSchema,
@@ -305,9 +309,11 @@ export {
   acceptsCurrentUserDefault,
   ColumnSchema,
   ComponentSchema,
+  ContactAddressAttributeMetaSchema,
   CURRENT_USER_DEFAULT,
   CurrencyAttributeMetaSchema,
   DesignReferenceSchema,
+  EntityContactBindingSchema,
   EntityExtensionSchema,
   EntitySchema,
   EntityWithSchemaSchema,
@@ -337,6 +343,7 @@ export {
   PageExtensionSchema,
   PageSchema,
   PLATFORM_ATTRIBUTE_NAMES,
+  parseContactAddressMeta,
   parseCurrencyMeta,
   parseFileMeta,
   parsePrincipalMeta,

package/src/meta/layout/control-registry.json

@@ -1,6 +1,6 @@
 {
   "_comment": "SOURCE OF TRUTH for the page-layout control registry. Each entry under `controls` declares the primary control slug and the full compatible list for one (type[+format|+items.type]) combination. Renderer dispatches off `primary`; inspector picker dispatches off `compatible`. Edit this file then run `go run ./scripts/codegen/page-layout-registry` from the repo root to regenerate packages/go/model/page_layout_registry_gen.go.",
-  "_attributeTypes": "Top-level keys MUST match the Go canonical AttributeType union in packages/go/model/meta/attribute.go (string \u00b7 number \u00b7 integer \u00b7 boolean \u00b7 array \u00b7 object \u00b7 datetime \u00b7 enum \u00b7 relation \u00b7 user \u00b7 currency \u00b7 knowledge-text \u00b7 file). `byFormat` keys for `string` MUST match StringFormat (email \u00b7 uri \u00b7 uuid \u00b7 hostname \u00b7 ipv4 \u00b7 ipv6). `byFormat` keys for `datetime` MUST match DatetimeFormat (date-time \u00b7 date \u00b7 time \u00b7 duration). `byItemsType` for `array` keys on the item Attribute's type. A null `primary` with empty `compatible` means \"render-only fallback\" \u2014 see plan \u00a73.2.5.",
+  "_attributeTypes": "Top-level keys MUST match the Go canonical AttributeType union in packages/go/model/meta/attribute.go (string \u00b7 number \u00b7 integer \u00b7 boolean \u00b7 array \u00b7 object \u00b7 datetime \u00b7 enum \u00b7 relation \u00b7 user \u00b7 principal \u00b7 currency \u00b7 knowledge-text \u00b7 file \u00b7 contact-address). `byFormat` keys for `string` MUST match StringFormat (email \u00b7 uri \u00b7 uuid \u00b7 hostname \u00b7 ipv4 \u00b7 ipv6). `byFormat` keys for `datetime` MUST match DatetimeFormat (date-time \u00b7 date \u00b7 time \u00b7 duration). `byItemsType` for `array` keys on the item Attribute's type. A null `primary` with empty `compatible` means \"render-only fallback\" \u2014 see plan \u00a73.2.5.",
   "_slugRoster": "v1 ships only lib-backed slugs. Slugs without a backing @proteos/ui component (markdown \u00b7 json-editor \u00b7 slider \u00b7 stepper \u00b7 percent \u00b7 user-card) are intentionally omitted; they return when the matching lib primitive ships. See plan \u00a73.2.4 / \u00a77.3. The `user-picker` slug is backed by the web client's UserCombobox (account/user-service people picker). The `currency` slug is backed by the web client's currency control (CurrencyInput: decimal amount + ISO-4217 picker).",
   "builtInControls": [
     "text",
@@ -26,7 +26,8 @@
     "knowledge-text",
     "file",
     "file-viewer",
-    "record-filter"
+    "record-filter",
+    "contact-address"
   ],
   "controls": {
     "string": {
@@ -175,6 +176,13 @@
         "currency"
       ]
     },
+    "contact-address": {
+      "primary": "contact-address",
+      "compatible": [
+        "contact-address",
+        "text"
+      ]
+    },
     "knowledge-text": {
       "primary": "knowledge-text",
       "compatible": [

package/src/meta/types.ts

@@ -48,6 +48,7 @@ export type AttributeType =
   | 'currency'
   | 'knowledge-text'
   | 'file'
+  | 'contact-address'
 
 /**
  * Attribute-level permissions: restricting a FIELD rather than a record — a
@@ -287,6 +288,32 @@ export const CurrencyAttributeMetaSchema = z.object({
   allowed_currency_codes: z.array(z.string()).optional(),
 })
 
+/**
+ * Which endpoint a `contact-address` attribute holds. The record-capable
+ * subset of the conversation contact-address kinds — what a human types.
+ */
+export 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`.
+ */
+export interface ContactAddressAttributeMeta {
+  kind: ContactAddressAttributeKind
+  description?: string
+}
+
+export const ContactAddressAttributeMetaSchema = z.object({
+  kind: z.enum(['email', 'phone', 'linkedin_public_identifier']),
+  description: z.string().optional(),
+})
+
 /**
  * The value of a `knowledge-text`-typed attribute: a reference to the
  * knowledge node (knowledge-service) that owns the text body. The record
@@ -354,6 +381,7 @@ export type AttributeMeta =
   | CurrencyAttributeMeta
   | KnowledgeTextAttributeMeta
   | FileAttributeMeta
+  | ContactAddressAttributeMeta
 
 /**
  * Entity attribute definition. Mirrors `model.Attribute` in the Go SDK.
@@ -572,6 +600,18 @@ export function parseFileMeta(attr: Attribute): FileAttributeMeta | null {
   return parsed.success ? parsed.data : {}
 }
 
+/**
+ * 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).
+ */
+export function parseContactAddressMeta(attr: Attribute): ContactAddressAttributeMeta | null {
+  if (attr.type !== 'contact-address') return null
+  const parsed = ContactAddressAttributeMetaSchema.safeParse(attr.meta)
+  return parsed.success ? parsed.data : 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
@@ -585,6 +625,27 @@ export const PublicAccessOperationSchema = z.enum(['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.
+ */
+export 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`.
+ */
+export interface EntityContactBinding {
+  duplicate_policy: ContactBindingDuplicatePolicy
+}
+
+export const EntityContactBindingSchema = z.object({
+  duplicate_policy: z.enum(['reject', 'flag']),
+})
+
 export interface Entity extends AuditFields {
   slug: string
   name: string
@@ -598,6 +659,11 @@ export 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
@@ -620,6 +686,7 @@ export const EntitySchema = AuditFieldsSchema.extend({
   // Default keeps older API responses (pre-`public_record_access` rollout)
   // parsing cleanly.
   public_record_access: z.array(PublicAccessOperationSchema).default([]),
+  contact_binding: EntityContactBindingSchema.optional(),
   module_slug: z.string(),
   // Default keeps older API responses (pre-`title_template` rollout) parsing
   // cleanly — the field is non-optional in the TS surface but tolerant on
@@ -662,6 +729,10 @@ export 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
@@ -675,6 +746,7 @@ export interface UpdateEntityRequest {
   name?: string
   is_remote?: boolean
   public_record_access?: PublicAccessOperation[]
+  contact_binding?: EntityContactBinding
   module_slug?: string
   description?: string
   title_template?: string