Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
43 commits
Select commit Hold shift + click to select a range
fab1222
refactor(typescript): begin Connection account surface migration
purpshell Nov 15, 2026
d80b581
wip(connections): port TypeScript and Go consumers and storage schema 3
purpshell Nov 15, 2026
efc5a51
wip(connections): bind canonical SDK routes and source evidence
purpshell Nov 15, 2026
d3f2eb1
Rename Python account resources and storage to Connections
purpshell Nov 15, 2026
a1581d0
Match Connection method fields to the call event contract
purpshell Nov 15, 2026
203c76d
Bind Go Connection types and storage provenance to the current contract
purpshell Nov 15, 2026
90e3d6d
Migrate PHP account resources and customer storage to Connections
purpshell Nov 15, 2026
960a5ca
Migrate Rust and .NET consumers to Connection contracts
purpshell Nov 15, 2026
581fff7
Reconcile Connection SDK routes and six-language coverage
purpshell Nov 16, 2026
fe83375
Correct native verification and schema package descriptions
purpshell Nov 16, 2026
39f91fb
Export compiled Connection documentation programs for all SDKs
purpshell Nov 16, 2026
2be942d
Update package guides and Testing examples to the Connection contract
purpshell Nov 16, 2026
d8223da
Bind compiled Connection documentation to the final package guides
purpshell Nov 16, 2026
ef2a629
Use Connection labels and sender props in browser UI
purpshell Nov 16, 2026
046fae6
Bind source-only snippets to final Connection UI source
purpshell Nov 16, 2026
1889f70
Merge current SDK main and preserve Connection styling and cache guards
purpshell Nov 16, 2026
cc0ab02
Format Connection SDK sources for required checks
purpshell Nov 16, 2026
25065ec
Clarify the fixed client boundary of the Connection picker
purpshell Nov 16, 2026
f7ff949
Bind Connection SDK contracts to the checked API producer
purpshell Nov 16, 2026
e8809ae
Regenerate current SDK projections and strict producer pin checks
purpshell Nov 16, 2026
6fbbdca
Bind SDK consumers to the checked Connection shared source
purpshell Nov 16, 2026
532c8d1
Keep native supplement assertions on the actual Connection producer
purpshell Nov 16, 2026
a872e65
Export six-language documentation programs from the checked Connectio…
purpshell Nov 17, 2026
abbcc86
fix: expose connection methods and preserve retained stream reads
purpshell Nov 17, 2026
0abcfdb
docs: export native-checked connection snippets
purpshell Nov 17, 2026
be8cc1e
Merge main into Connection SDK migration
purpshell Nov 17, 2026
fea8a59
Bind Connection examples to preserved SDK main composition
purpshell Nov 17, 2026
0d95651
test: run storage upgrade and held release checks on supported Node v…
purpshell Nov 17, 2026
b4692bf
chore: bind SDK projections to the checked Connection repair source
purpshell Nov 17, 2026
d9fe383
Regenerate source-bound Connection examples after CI repairs
purpshell Nov 17, 2026
a9d23f9
Align strict native contract fixtures with the checked API source
purpshell Nov 17, 2026
c613344
Keep temporary Rust packaging metadata out of source inputs
purpshell Nov 17, 2026
58cb9f8
Preserve restricted Supabase writer setup and nullable SQL writes
purpshell Nov 17, 2026
ce96a56
Document schema marker access for installed Supabase presets
purpshell Nov 17, 2026
0301c72
Bind native SDK contracts to the qualified Connection backend
purpshell Nov 17, 2026
93352af
Export six-language examples from the qualified Connection SDK source
purpshell Nov 17, 2026
87cebfb
Bind SDK provenance to the reviewed regional guard successor
purpshell Nov 17, 2026
797815a
Export verified programs bound to the reviewed Connection guard source
purpshell Nov 17, 2026
925930d
Validate the resolved PostgreSQL host before native role tests
purpshell Nov 17, 2026
3f16282
chore: bind SDK source to qualified retained Connection producer
purpshell Nov 17, 2026
aa77867
chore: regenerate six-language examples for retained Connection source
purpshell Nov 17, 2026
63cca58
chore(sdk): bind qualified retained-state API source
purpshell Nov 17, 2026
d3affdf
chore(sdk): regenerate qualified retained-state examples
purpshell Nov 17, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
1 change: 1 addition & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
* text=auto eol=lf
28 changes: 14 additions & 14 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
## Unreleased

- Client tokens cover a messaging frontend. All six SDKs, the drop-in handler
and the UI Kit accept the new session actions `conversations_read`,
and the UI Kit accept the new Connection actions `conversations_read`,
`conversations_manage`, `labels_read`, `labels_manage`, `contacts_manage`,
`profile_read`, `profile_manage`, `channels_read`, `channels_manage`,
`business_read` and `presence_write`. Customer-scoped tokens accept every
Expand All @@ -12,17 +12,17 @@
- UI Kit: `client.messaging()` gains `chats` (history, archive, disappearing
messages, edit and delete), `labels`, `profile` (profile and privacy),
`channels`, `catalog`, `presence.set`, contact block, unblock and info, and
`groups.setPicture` (base64). Browser Calls take `clientTokenSession` so a
Customer token names the number it calls from.
`groups.setPicture` (base64). Browser Calls take `clientTokenConnection` so a
Customer token names the Connection it calls from.

- A number's call history with the other party's identity: `GET
/messaging/{session}/calls` in all six SDKs (`calls.list`,
`SessionCalls().List` in Go, `Calls.ListAsync` in .NET). `peer` carries the
- A Connection's call history with the other party's identity: `GET
/messaging/{connection}/calls` in all six SDKs (`calls.list`,
`ConnectionCalls().List` in Go, `Calls.ListAsync` in .NET). `peer` carries the
user ID, phone number and username. Records are served from the number's
data region; client tokens need the new `read_calls` action. Platform call
records are unchanged and keep `peerRef`. Requires the matching API change.
- UI Kit call log: `<CallLog/>`, `<pmfa-call-log>` and an Inbox Chats/Calls
switch read the number's calls from the API, merge repeat calls as WhatsApp
switch read the Connection's calls from the API, merge repeat calls as WhatsApp
does and offer call back. `ContactListView` now takes `className` and
`classNames`; `ContactList` and `<pmfa-contact-list>` show the Contacts list
on their own.
Expand All @@ -43,7 +43,7 @@
back both. Relayed group messages no longer rename the chat after their
sender.
- Client tokens: `groups_read` and `groups_manage` in all six server SDKs,
the drop-in handler and the UI Kit, for session and Customer tokens. Requires the
the drop-in handler and the UI Kit, for Connection and Customer tokens. Requires the
matching API change; until it is accepted the API refuses these actions.
- UI Kit calls: toggle buttons no longer report `aria-pressed` alongside an
action label ("Turn camera on", pressed).
Expand All @@ -70,17 +70,17 @@
replacement contacts at once and can be moved in the document. A group read
that finishes after leaving no longer marks the group ready again.

- Breaking: Test number phone and event methods use the Number-scoped routes
- Breaking: Test Connection phone and event methods use the Connection-scoped routes
in API contract revision `f180dc1ee2`. `testing.getPhone`, `sendPhoneMessage`
and `unlinkPhoneDevice` take a Number ID and no project argument, and
`testing.triggerEvent(numberId, body)` omits body `session` and accepts
`fromNumber`. `listEventFixtures()` has no project argument. History fixtures
and `unlinkPhoneDevice` take a Connection ID and no project argument, and
`testing.triggerEvent(connectionId, body)` omits body `connection` and accepts
`fromConnection`. `listEventFixtures()` has no project argument. History fixtures
keep their project argument and use
`/messaging/projects/{projectId}/test-history-fixtures`. Real Numbers return
`/messaging/projects/{projectId}/test-history-fixtures`. Real Connections return
`404 resource_not_found`. Scope names remain `sandbox:read` / `sandbox:write`.
Applies to all six SDKs. Source-only and unpublished.

- UI Kit: give `CallNumberPicker` built-in themes, appearance variables and
- UI Kit: give `CallConnectionPicker` built-in themes, appearance variables and
styling slots. It supports `classNames` and unstyled mode without a host
stylesheet.
- UI Kit: remove `TemplateManager`, `SessionStatus`, `ConnectWhatsAppButton`,
Expand Down
141 changes: 73 additions & 68 deletions README.md

Large diffs are not rendered by default.

69 changes: 44 additions & 25 deletions contracts/abprops-capabilities.json
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
{
"repository": "polymorfa/polymorfa",
"sourceCommit": "2f9efad933b3a7a455f73245a566c827ac004608",
"sourceCommit": "15db8b1c9d88e2ceccb58c851e731feabb659a39",
"sourcePath": "apps/api/docs/openapi.json",
"sourceSha256": "53b2c76e344052152b3fc627a478adcd79130b7876d528aac8056b13e555b127",
"sourceSha256": "e84c7ff814c6b59ca7f32c3fda1aedbed3f672e728910adb883f0aa8c6cf3ab7",
"published": false,
"scope": "Group capability read and canonical session capability webhook only. Other SDK contracts retain their recorded source revisions.",
"scope": "Group capability read and canonical Connection capability webhook only. Other SDK contracts retain their recorded source revisions.",
"openapi": "3.0.3",
"paths": {
"/messaging/{session}/groups/{id}/capabilities": {
"/messaging/{connection}/groups/{id}/capabilities": {
"get": {
"operationId": "getGroupCapabilities",
"tags": ["Groups"],
Expand All @@ -24,7 +24,7 @@
"type": "string"
},
"required": true,
"name": "session",
"name": "connection",
"in": "path"
},
{
Expand All @@ -39,7 +39,7 @@
],
"responses": {
"200": {
"description": "Account-bound stored group capabilities. Unknown until successful number and group syncs for the linked account. Requires current group membership and the enrolled number-capabilities beta.",
"description": "Account-bound stored group capabilities. Unknown until successful connection and group syncs for the linked account. Requires current group membership and the enrolled connection-capabilities beta.",
"content": {
"application/json": {
"schema": {
Expand Down Expand Up @@ -252,9 +252,6 @@
}
}
},
"x-mint": {
"content": "<Badge color=\"green\" icon=\"laptop\">Linked Device API</Badge> <Badge color=\"yellow\" icon=\"key\">groups:read</Badge>"
},
"x-protocols": ["Linked Device API"],
"description": "**Protocols:** Linked Device API\n\n**Required scope:** `groups:read`"
}
Expand Down Expand Up @@ -344,6 +341,7 @@
"invalid_request_error",
"authentication_error",
"permission_error",
"billing_error",
"conflict_error",
"rate_limit_error",
"api_error",
Expand All @@ -353,11 +351,16 @@
"code": {
"type": "string",
"enum": [
"zero_knowledge_connection",
"invalid_parameter",
"invalid_credential",
"entitlement_required",
"cloud_template_authority_restricted",
"gate_limit_reached",
"billing_credit_required",
"addon_required",
"safe_mode_not_entitled",
"warmup_plan_not_entitled",
"method_not_allowed",
"permission_denied",
"missing_scope",
Expand All @@ -370,17 +373,21 @@
"stream_cursor_expired",
"stream_connection_limit_reached",
"state_conflict",
"team_deletion_scheduled",
"hybrid_routing_paused",
"hybrid_choice_required",
"hybrid_transition_ineligible",
"hybrid_automation_unavailable",
"hybrid_group_linked_devices_unavailable",
"hybrid_transport_unavailable",
"hybrid_target_reference_unavailable",
"send_outcome_unknown",
"terms_acceptance_required",
"terms_activation_blocked",
"idempotency_conflict",
"idempotency_in_progress",
"idempotency_completed",
"idempotency_outcome_unknown",
"idempotency_replay_unavailable",
"call_claimed",
"call_not_ringing",
"connection_limit",
Expand All @@ -395,7 +402,7 @@
"order_status_transition_invalid",
"order_cancellation_failed",
"call_opt_out_limit",
"number_restricted",
"connection_restricted",
"sip_trunk_in_use",
"sip_trunk_revision_conflict",
"sip_trunk_limit",
Expand All @@ -413,16 +420,21 @@
"upstream_failure",
"service_unavailable",
"credential_verification_unavailable",
"session_not_ready",
"connection_not_ready",
"command_dispatch_failed",
"result_unknown",
"parent_bsuid_not_supported",
"recipient_not_on_whatsapp",
"conversation_window_closed",
"template_not_approved",
"media_too_large",
"whatsapp_rate_limited",
"new_chat_limit_reached",
"marketing_disabled_on_cloud_api",
"whatsapp_account_restricted",
"whatsapp_authorization_required",
"whatsapp_payment_method_required",
"whatsapp_number_not_registered",
"whatsapp_groups_ineligible",
"whatsapp_group_creation_paused",
"whatsapp_group_limit_reached",
Expand Down Expand Up @@ -476,40 +488,43 @@
},
"required": ["error", "data", "docs"]
},
"SessionCapabilitiesUpdatedEvent": {
"ConnectionCapabilitiesUpdatedEvent": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique event identifier"
"description": "Unique event identifier",
"example": "0190f2a4-6c1e-7b9d-9f3a-2e8c4d5b6a71"
},
"session": {
"connection": {
"type": "string",
"description": "Session that produced this event"
"description": "Connection that produced this event",
"example": "739182640518203"
},
"externalId": {
"type": "string",
"description": "Integrator reference from the QuickLink that created this session. Included on session lifecycle events when supplied."
"description": "Integrator reference from the QuickLink that created this connection. Included on connection lifecycle events when supplied."
},
"timestamp": {
"type": "string",
"description": "ISO 8601 timestamp"
"description": "ISO 8601 timestamp",
"example": "2026-10-19T14:03:22.000Z"
},
"event": {
"type": "string",
"enum": ["session.capabilities_updated"],
"enum": ["connection.capabilities_updated"],
"description": "Event type"
},
"payload": {
"$ref": "#/components/schemas/SessionCapabilitiesUpdatedPayload"
"$ref": "#/components/schemas/ConnectionCapabilitiesUpdatedPayload"
}
},
"required": ["id", "session", "timestamp", "event", "payload"]
"required": ["id", "connection", "timestamp", "event", "payload"]
},
"SessionCapabilitiesUpdatedPayload": {
"ConnectionCapabilitiesUpdatedPayload": {
"type": "object",
"properties": {
"session": {
"connection": {
"type": "string",
"maxLength": 256
},
Expand Down Expand Up @@ -588,7 +603,7 @@
}
},
"required": [
"session",
"connection",
"projectId",
"status",
"syncedAt",
Expand All @@ -601,5 +616,9 @@
}
}
},
"family": "messaging"
"family": "messaging",
"previousExport": {
"path": "contracts/history/pre-connections/abprops-capabilities.json",
"sha256": "4eae2c0370fe97e4a6302191e54b18ecc984e9e23ff8ba778cefa8dc9a6c349d"
}
}
Loading
Loading