@lessly/sdk-app 9.1.0 → 10.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/dist/analytics/index.d.cts +1 -1
  2. package/dist/analytics/index.d.ts +1 -1
  3. package/dist/brain/index.cjs +0 -10
  4. package/dist/brain/index.cjs.map +1 -1
  5. package/dist/brain/index.d.cts +2 -10
  6. package/dist/brain/index.d.ts +2 -10
  7. package/dist/brain/index.js +1 -9
  8. package/dist/brain/index.js.map +1 -1
  9. package/dist/{client.gen-LEUVRZRQ.d.cts → client.gen-XqieBmDz.d.cts} +1102 -223
  10. package/dist/{client.gen-LEUVRZRQ.d.ts → client.gen-XqieBmDz.d.ts} +1102 -223
  11. package/dist/consent/index.d.cts +1 -1
  12. package/dist/consent/index.d.ts +1 -1
  13. package/dist/deployment/index.d.cts +1 -1
  14. package/dist/deployment/index.d.ts +1 -1
  15. package/dist/index.cjs +512 -40
  16. package/dist/index.cjs.map +1 -1
  17. package/dist/index.d.cts +1 -1
  18. package/dist/index.d.ts +1 -1
  19. package/dist/index.js +512 -40
  20. package/dist/index.js.map +1 -1
  21. package/dist/mail/index.d.cts +2 -2
  22. package/dist/mail/index.d.ts +2 -2
  23. package/dist/organization/index.d.cts +1 -1
  24. package/dist/organization/index.d.ts +1 -1
  25. package/dist/playground/index.cjs +66 -0
  26. package/dist/playground/index.cjs.map +1 -0
  27. package/dist/playground/index.d.cts +52 -0
  28. package/dist/playground/index.d.ts +52 -0
  29. package/dist/playground/index.js +53 -0
  30. package/dist/playground/index.js.map +1 -0
  31. package/dist/realtime/index.cjs +126 -0
  32. package/dist/realtime/index.cjs.map +1 -0
  33. package/dist/realtime/index.d.cts +100 -0
  34. package/dist/realtime/index.d.ts +100 -0
  35. package/dist/realtime/index.js +101 -0
  36. package/dist/realtime/index.js.map +1 -0
  37. package/dist/tracking/index.d.cts +1 -1
  38. package/dist/tracking/index.d.ts +1 -1
  39. package/dist/waitlist/index.d.cts +1 -1
  40. package/dist/waitlist/index.d.ts +1 -1
  41. package/package.json +12 -2
  42. package/src/gen/bindings.gen.ts +512 -40
  43. package/src/gen/brain/index.ts +1 -1
  44. package/src/gen/brain/queryOptions.gen.ts +0 -14
  45. package/src/gen/client.gen.ts +146 -8
  46. package/src/gen/manifest.gen.ts +1 -1
  47. package/src/gen/playground/index.ts +3 -0
  48. package/src/gen/playground/queryOptions.gen.ts +86 -0
  49. package/src/gen/realtime/index.ts +3 -0
  50. package/src/gen/realtime/queryOptions.gen.ts +158 -0
  51. package/src/gen/types.gen.ts +994 -106
@@ -56,9 +56,15 @@ snapshotId?: string
56
56
  export type BrainBackupStatusOutput = ({
57
57
  id: string
58
58
  error: (string | null)
59
- status: ("running" | "completed" | "failed")
59
+ /**
60
+ * 'running' | 'completed' | 'failed'
61
+ */
62
+ status: string
60
63
  gcsPath: string
61
- trigger: ("scheduled" | "manual" | "pre-restore")
64
+ /**
65
+ * 'scheduled' | 'manual' | 'pre-restore'
66
+ */
67
+ trigger: string
62
68
  createdAt: string
63
69
  edgeCount: (number | null)
64
70
  nodeCount: (number | null)
@@ -77,9 +83,15 @@ export interface BrainBackupsListInput {
77
83
  export type BrainBackupsListOutput = {
78
84
  id: string
79
85
  error: (string | null)
80
- status: ("running" | "completed" | "failed")
86
+ /**
87
+ * 'running' | 'completed' | 'failed'
88
+ */
89
+ status: string
81
90
  gcsPath: string
82
- trigger: ("scheduled" | "manual" | "pre-restore")
91
+ /**
92
+ * 'scheduled' | 'manual' | 'pre-restore'
93
+ */
94
+ trigger: string
83
95
  createdAt: string
84
96
  edgeCount: (number | null)
85
97
  nodeCount: (number | null)
@@ -536,107 +548,6 @@ mimeType: string
536
548
  }[]
537
549
  }[]
538
550
 
539
- export interface BrainKnowledgeEntityMemoriesInput {
540
- /**
541
- * Max memories (default 50)
542
- */
543
- limit?: number
544
- /**
545
- * Read scope; 'both' (default) unions shared + your private
546
- */
547
- scope?: ("shared" | "private" | "both")
548
- /**
549
- * Pagination offset
550
- */
551
- offset?: number
552
- /**
553
- * Entity id, name, or alias to fetch backing memories for
554
- */
555
- entity_ref: string
556
- }
557
-
558
- export interface BrainKnowledgeEntityMemoriesOutput {
559
- total: number
560
- entity: ({
561
- score?: number
562
- aliases: string[]
563
- entity_id: string
564
- description: (string | null)
565
- entity_type: string
566
- display_name: string
567
- canonical_name: string
568
- evidence_count: number
569
- } | null)
570
- memories: {
571
- /**
572
- * Consumer-facing label derived from the layer; 'unknown' for an unrecognised layer
573
- */
574
- kind: ("schema" | "intention" | "identity" | "basic" | "fact" | "summary" | "knowledge" | "raw" | "unknown")
575
- tags: string[]
576
- /**
577
- * Engine memory layer (l0_basic_info…l7_intention)
578
- */
579
- layer: ("l6_schema" | "l7_intention" | "l4_identity" | "l0_basic_info" | "l2_fact" | "l3_summary" | "l5_knowledge" | "l1_raw")
580
- custom: {
581
- [k: string]: unknown
582
- }
583
- status: string
584
- content: string
585
- user_id: string
586
- agent_id: string
587
- memory_at: (number | null)
588
- memory_id: string
589
- speculate: (string | null)
590
- session_id: string
591
- gmt_created: number
592
- /**
593
- * Source authority (highest→lowest): policy > official > team > informal
594
- */
595
- source_authority: ("policy" | "official" | "team" | "informal")
596
- source_raw_memory_id: (string | null)
597
- }[]
598
- elapsed_ms: number
599
- request_id: string
600
- }
601
-
602
- export interface BrainKnowledgeGraphInput {
603
- /**
604
- * Max nodes (default 5000). When the cap applies the HIGHEST-DEGREE nodes are kept, so a small limit (e.g. 100) returns the hub concepts — that is usually what you want
605
- */
606
- limit?: number
607
- /**
608
- * Read scope; 'both' (default) unions shared + your private
609
- */
610
- scope?: ("shared" | "private" | "both")
611
- }
612
-
613
- export interface BrainKnowledgeGraphOutput {
614
- edges: {
615
- reason: (string | null)
616
- source: string
617
- target: string
618
- symmetric: boolean
619
- relation_type: string
620
- }[]
621
- nodes: {
622
- id: string
623
- degree: number
624
- aliases: string[]
625
- description: (string | null)
626
- entity_type: string
627
- display_name: string
628
- canonical_name: string
629
- evidence_count: number
630
- }[]
631
- totals: {
632
- edgeCount: number
633
- nodeCount: number
634
- }
635
- truncated: boolean
636
- elapsed_ms: number
637
- request_id: string
638
- }
639
-
640
551
  export interface BrainKnowledgeNeighborhoodInput {
641
552
  /**
642
553
  * Hops to expand (engine clamps to 3)
@@ -1017,7 +928,10 @@ restoreId: string
1017
928
 
1018
929
  export type BrainRestoreStatusOutput = ({
1019
930
  error: (string | null)
1020
- status: ("pending" | "wiped" | "importing" | "completed" | "failed")
931
+ /**
932
+ * 'pending' | 'wiped' | 'importing' | 'completed' | 'failed'
933
+ */
934
+ status: string
1021
935
  edgeCount: (number | null)
1022
936
  nodeCount: (number | null)
1023
937
  productId: string
@@ -13274,6 +13188,980 @@ name: string
13274
13188
  activeProductId: (string | null)
13275
13189
  }
13276
13190
 
13191
+ export interface PlaygroundAnalyticsOverviewInput {
13192
+ /**
13193
+ * Max records per entity in recent[]; omit for the endpoint default
13194
+ */
13195
+ limit?: number
13196
+ }
13197
+
13198
+ export interface PlaygroundAnalyticsOverviewOutput {
13199
+ ok: boolean
13200
+ minted: boolean
13201
+ overview?: unknown
13202
+ http_status: number
13203
+ }
13204
+
13205
+ export interface PlaygroundBillingEntitlementsInput {
13206
+
13207
+ }
13208
+
13209
+ export interface PlaygroundBillingEntitlementsOutput {
13210
+ ok: boolean
13211
+ minted: boolean
13212
+ http_status: number
13213
+ entitlements?: unknown
13214
+ }
13215
+
13216
+ export interface PlaygroundBillingRecordUsageInput {
13217
+ /**
13218
+ * Quantity of events to record against playground-events (SUM); defaults to 1
13219
+ */
13220
+ value?: number
13221
+ }
13222
+
13223
+ export interface PlaygroundBillingRecordUsageOutput {
13224
+ minted: boolean
13225
+ accepted: (number | null)
13226
+ recorded: boolean
13227
+ duplicates: (number | null)
13228
+ http_status: number
13229
+ }
13230
+
13231
+ export interface PlaygroundClickupCreateTaskInput {
13232
+ /**
13233
+ * Task title; defaults to a fixture label
13234
+ */
13235
+ name?: string
13236
+ /**
13237
+ * ClickUp list id; falls back to CLICKUP_TEST_LIST_ID
13238
+ */
13239
+ listId?: string
13240
+ }
13241
+
13242
+ export interface PlaygroundClickupCreateTaskOutput {
13243
+ minted: boolean
13244
+ task_id: (string | null)
13245
+ list_status: number
13246
+ vend_status: number
13247
+ clickup_status: number
13248
+ installation_count: number
13249
+ }
13250
+
13251
+ export interface PlaygroundClickupGetLastWebhookInput {
13252
+
13253
+ }
13254
+
13255
+ export type PlaygroundClickupGetLastWebhookOutput = ({
13256
+ payload: string
13257
+ event_id: string
13258
+ provider: string
13259
+ verified: boolean
13260
+ product_id: string
13261
+ occurred_at: string
13262
+ connector_id: string
13263
+ clickup_event: (string | null)
13264
+ receipt_count: number
13265
+ } | {
13266
+ found: false
13267
+ })
13268
+
13269
+ export interface PlaygroundClickupGetOverviewInput {
13270
+
13271
+ }
13272
+
13273
+ export interface PlaygroundClickupGetOverviewOutput {
13274
+ team: ({
13275
+ teamId: string
13276
+ teamName: string
13277
+ } | null)
13278
+ lists: PlaygroundClickupGetOverviewOutputItems[]
13279
+ tasks: {
13280
+ id: string
13281
+ name: string
13282
+ status: (string | null)
13283
+ }[]
13284
+ minted: boolean
13285
+ spaces: PlaygroundClickupGetOverviewOutputItems[]
13286
+ list_status: number
13287
+ vend_status: number
13288
+ lists_status: number
13289
+ tasks_status: number
13290
+ spaces_status: number
13291
+ folders_status: number
13292
+ installation_count: number
13293
+ }
13294
+ export interface PlaygroundClickupGetOverviewOutputItems {
13295
+ id: string
13296
+ name: string
13297
+ }
13298
+
13299
+ export interface PlaygroundGdriveGetLastChangeInput {
13300
+
13301
+ }
13302
+
13303
+ export type PlaygroundGdriveGetLastChangeOutput = ({
13304
+ file_id: string
13305
+ removed: boolean
13306
+ file_name: (string | null)
13307
+ mime_type: (string | null)
13308
+ product_id: string
13309
+ occurred_at: string
13310
+ connector_id: string
13311
+ resource_state: string
13312
+ } | {
13313
+ found: false
13314
+ })
13315
+
13316
+ export interface PlaygroundGdriveReadFileInput {
13317
+ /**
13318
+ * Drive file id; falls back to GDRIVE_TEST_FILE_ID, then the first picked file
13319
+ */
13320
+ fileId?: string
13321
+ }
13322
+
13323
+ export interface PlaygroundGdriveReadFileOutput {
13324
+ minted: boolean
13325
+ file_id: (string | null)
13326
+ file_name: (string | null)
13327
+ mime_type: (string | null)
13328
+ file_count: number
13329
+ get_status: number
13330
+ list_status: number
13331
+ vend_status: number
13332
+ content_bytes: (number | null)
13333
+ }
13334
+
13335
+ export interface PlaygroundGoogleadsReadCustomerInput {
13336
+
13337
+ }
13338
+
13339
+ export interface PlaygroundGoogleadsReadCustomerOutput {
13340
+ minted: boolean
13341
+ vended: boolean
13342
+ customer_id: (string | null)
13343
+ vend_status: number
13344
+ result_count: number
13345
+ search_status: number
13346
+ login_customer_id: (string | null)
13347
+ }
13348
+
13349
+ export interface PlaygroundLifecycleGetStateInput {
13350
+
13351
+ }
13352
+
13353
+ export interface PlaygroundLifecycleGetStateOutput {
13354
+ blocked: boolean
13355
+ archived: boolean
13356
+ productId: string
13357
+ lastBlockTransition: ({
13358
+ eventId: string
13359
+ eventName: string
13360
+ productId: string
13361
+ occurredAt: string
13362
+ recordedAt: string
13363
+ receiptCount: number
13364
+ organizationId: string
13365
+ cascadedFromOrg: boolean
13366
+ } | null)
13367
+ lastArchiveTransition: ({
13368
+ eventId: string
13369
+ eventName: string
13370
+ productId: string
13371
+ occurredAt: string
13372
+ recordedAt: string
13373
+ receiptCount: number
13374
+ organizationId: string
13375
+ cascadedFromOrg: boolean
13376
+ } | null)
13377
+ }
13378
+
13379
+ export interface PlaygroundLifecycleListEventsInput {
13380
+
13381
+ }
13382
+
13383
+ export type PlaygroundLifecycleListEventsOutput = {
13384
+ eventId: string
13385
+ eventName: string
13386
+ productId: string
13387
+ occurredAt: string
13388
+ recordedAt: string
13389
+ receiptCount: number
13390
+ organizationId: string
13391
+ cascadedFromOrg: boolean
13392
+ }[]
13393
+
13394
+ export interface PlaygroundWebhookGetLastInput {
13395
+
13396
+ }
13397
+
13398
+ export type PlaygroundWebhookGetLastOutput = ({
13399
+ payload?: unknown
13400
+ event_id: string
13401
+ provider: string
13402
+ verified: boolean
13403
+ product_id: string
13404
+ occurred_at: string
13405
+ connector_id: string
13406
+ delivery_count: number
13407
+ } | {
13408
+ found: false
13409
+ })
13410
+
13411
+ export interface RealtimeGrantCreateInput {
13412
+ /**
13413
+ * Operations granted on matching channels
13414
+ *
13415
+ * @minItems 1
13416
+ */
13417
+ ops: [("subscribe" | "publish" | "presence" | "history"), ...(("subscribe" | "publish" | "presence" | "history"))[]]
13418
+ /**
13419
+ * Channel pattern, e.g. "chat:*" ("*" matches exactly one segment)
13420
+ */
13421
+ pattern: string
13422
+ /**
13423
+ * Identity id the grant applies to, or "*" for every identity in the product
13424
+ */
13425
+ subject: string
13426
+ }
13427
+
13428
+ export interface RealtimeGrantCreateOutput {
13429
+ id: string
13430
+ ops: ("subscribe" | "publish" | "presence" | "history")[]
13431
+ pattern: string
13432
+ subject: string
13433
+ createdAt: string
13434
+ }
13435
+
13436
+ export interface RealtimeGrantListInput {
13437
+ /**
13438
+ * Filter grants by subject
13439
+ */
13440
+ subject?: string
13441
+ }
13442
+
13443
+ export interface RealtimeGrantListOutput {
13444
+ grants: {
13445
+ id: string
13446
+ ops: ("subscribe" | "publish" | "presence" | "history")[]
13447
+ pattern: string
13448
+ subject: string
13449
+ createdAt: string
13450
+ }[]
13451
+ }
13452
+
13453
+ export interface RealtimeGrantRevokeInput {
13454
+ /**
13455
+ * Grant id to revoke
13456
+ */
13457
+ id: string
13458
+ }
13459
+
13460
+ export interface RealtimeGrantRevokeOutput {
13461
+ revoked: true
13462
+ }
13463
+
13464
+ export interface RealtimeHistoryGetInput {
13465
+ /**
13466
+ * Cursor: stream epoch the offset belongs to
13467
+ */
13468
+ epoch?: string
13469
+ /**
13470
+ * Window: return the last N entries
13471
+ */
13472
+ last_n?: number
13473
+ /**
13474
+ * Cursor: resume strictly after this offset (requires epoch)
13475
+ */
13476
+ offset?: string
13477
+ /**
13478
+ * Channel to read history from
13479
+ */
13480
+ channel: string
13481
+ /**
13482
+ * Window: return entries newer than now minus this many milliseconds
13483
+ */
13484
+ last_ms?: number
13485
+ }
13486
+
13487
+ export interface RealtimeHistoryGetOutput {
13488
+ /**
13489
+ * Current stream epoch, or null when the channel has no history yet
13490
+ */
13491
+ epoch: (string | null)
13492
+ /**
13493
+ * Channel the history was read from
13494
+ */
13495
+ channel: string
13496
+ /**
13497
+ * Entries in stream order
13498
+ */
13499
+ entries: {
13500
+ /**
13501
+ * Message id from the envelope
13502
+ */
13503
+ id: string
13504
+ /**
13505
+ * Publish timestamp (ms)
13506
+ */
13507
+ ts: number
13508
+ /**
13509
+ * Store-and-link reference for payloads over the inline cap
13510
+ */
13511
+ ref?: {
13512
+ /**
13513
+ * Stored body size in bytes
13514
+ */
13515
+ size: number
13516
+ /**
13517
+ * Object key in the product-scoped bucket
13518
+ */
13519
+ bucket_key: string
13520
+ /**
13521
+ * Stored content type
13522
+ */
13523
+ content_type?: string
13524
+ }
13525
+ /**
13526
+ * Inline payload (absent when ref is present)
13527
+ */
13528
+ data?: {
13529
+ [k: string]: unknown
13530
+ }
13531
+ /**
13532
+ * Stream offset of the entry
13533
+ */
13534
+ offset: string
13535
+ }[]
13536
+ /**
13537
+ * false when the cursor epoch mismatches or entries aged out — client must resync
13538
+ */
13539
+ recovered: boolean
13540
+ }
13541
+
13542
+ export interface RealtimeMessagesPublishInput {
13543
+ /**
13544
+ * JSON payload delivered to channel subscribers
13545
+ */
13546
+ data: {
13547
+ [k: string]: unknown
13548
+ }
13549
+ /**
13550
+ * Channel to publish the message to
13551
+ */
13552
+ channel: string
13553
+ }
13554
+
13555
+ export interface RealtimeMessagesPublishOutput {
13556
+ /**
13557
+ * Stream epoch of the stored message (present when history is on)
13558
+ */
13559
+ epoch?: string
13560
+ /**
13561
+ * Stream offset of the stored message (present when history is on)
13562
+ */
13563
+ offset?: string
13564
+ /**
13565
+ * Channel the message was published to
13566
+ */
13567
+ channel: string
13568
+ /**
13569
+ * Publish acknowledged by the fan-out backend
13570
+ */
13571
+ published: true
13572
+ }
13573
+
13574
+ export interface RealtimeNamespaceCreateInput {
13575
+ /**
13576
+ * Namespace name (the part of a channel name before the first colon)
13577
+ */
13578
+ name: string
13579
+ /**
13580
+ * History retention policy for channels in this namespace
13581
+ */
13582
+ history?: ("none" | "last-message" | "window")
13583
+ /**
13584
+ * Whether presence is enabled on channels in this namespace
13585
+ */
13586
+ presence?: boolean
13587
+ /**
13588
+ * public: any authenticated identity may subscribe without a grant
13589
+ */
13590
+ visibility?: ("public" | "authorized")
13591
+ /**
13592
+ * Whether clients may publish events directly
13593
+ */
13594
+ clientEvents?: boolean
13595
+ /**
13596
+ * Whether only identified (non-anonymous) identities get capabilities
13597
+ */
13598
+ identifiedOnly?: boolean
13599
+ /**
13600
+ * Whether payloads must be end-to-end encrypted
13601
+ */
13602
+ encryptionRequired?: boolean
13603
+ /**
13604
+ * Retention window in seconds; required when history is "window"
13605
+ */
13606
+ historyWindowSeconds?: number
13607
+ }
13608
+
13609
+ export interface RealtimeNamespaceCreateOutput {
13610
+ id: string
13611
+ name: string
13612
+ history: ("none" | "last-message" | "window")
13613
+ presence: boolean
13614
+ createdAt: string
13615
+ updatedAt: string
13616
+ visibility: ("public" | "authorized")
13617
+ clientEvents: boolean
13618
+ identifiedOnly: boolean
13619
+ encryptionRequired: boolean
13620
+ historyWindowSeconds: (number | null)
13621
+ }
13622
+
13623
+ export interface RealtimeNamespaceDeleteInput {
13624
+ /**
13625
+ * Namespace name
13626
+ */
13627
+ name: string
13628
+ }
13629
+
13630
+ export interface RealtimeNamespaceDeleteOutput {
13631
+ deleted: true
13632
+ }
13633
+
13634
+ export interface RealtimeNamespaceGetInput {
13635
+ /**
13636
+ * Namespace name
13637
+ */
13638
+ name: string
13639
+ }
13640
+
13641
+ export interface RealtimeNamespaceGetOutput {
13642
+ id: string
13643
+ name: string
13644
+ history: ("none" | "last-message" | "window")
13645
+ presence: boolean
13646
+ createdAt: string
13647
+ updatedAt: string
13648
+ visibility: ("public" | "authorized")
13649
+ clientEvents: boolean
13650
+ identifiedOnly: boolean
13651
+ encryptionRequired: boolean
13652
+ historyWindowSeconds: (number | null)
13653
+ }
13654
+
13655
+ export interface RealtimeNamespaceListInput {
13656
+
13657
+ }
13658
+
13659
+ export interface RealtimeNamespaceListOutput {
13660
+ namespaces: {
13661
+ id: string
13662
+ name: string
13663
+ history: ("none" | "last-message" | "window")
13664
+ presence: boolean
13665
+ createdAt: string
13666
+ updatedAt: string
13667
+ visibility: ("public" | "authorized")
13668
+ clientEvents: boolean
13669
+ identifiedOnly: boolean
13670
+ encryptionRequired: boolean
13671
+ historyWindowSeconds: (number | null)
13672
+ }[]
13673
+ }
13674
+
13675
+ export interface RealtimeNamespaceUpdateInput {
13676
+ /**
13677
+ * Namespace name to update
13678
+ */
13679
+ name: string
13680
+ /**
13681
+ * History retention policy for channels in this namespace
13682
+ */
13683
+ history?: ("none" | "last-message" | "window")
13684
+ /**
13685
+ * Whether presence is enabled on channels in this namespace
13686
+ */
13687
+ presence?: boolean
13688
+ /**
13689
+ * public: any authenticated identity may subscribe without a grant
13690
+ */
13691
+ visibility?: ("public" | "authorized")
13692
+ /**
13693
+ * Whether clients may publish events directly
13694
+ */
13695
+ clientEvents?: boolean
13696
+ /**
13697
+ * Whether only identified (non-anonymous) identities get capabilities
13698
+ */
13699
+ identifiedOnly?: boolean
13700
+ /**
13701
+ * Whether payloads must be end-to-end encrypted
13702
+ */
13703
+ encryptionRequired?: boolean
13704
+ /**
13705
+ * Retention window in seconds; required when history is "window"
13706
+ */
13707
+ historyWindowSeconds?: number
13708
+ }
13709
+
13710
+ export interface RealtimeNamespaceUpdateOutput {
13711
+ id: string
13712
+ name: string
13713
+ history: ("none" | "last-message" | "window")
13714
+ presence: boolean
13715
+ createdAt: string
13716
+ updatedAt: string
13717
+ visibility: ("public" | "authorized")
13718
+ clientEvents: boolean
13719
+ identifiedOnly: boolean
13720
+ encryptionRequired: boolean
13721
+ historyWindowSeconds: (number | null)
13722
+ }
13723
+
13724
+ export interface RealtimePresenceEnterInput {
13725
+ /**
13726
+ * Arbitrary JSON metadata for the member (<=10KB serialized)
13727
+ */
13728
+ info?: {
13729
+ [k: string]: unknown
13730
+ }
13731
+ /**
13732
+ * Channel name, "namespace:rest"
13733
+ */
13734
+ channel: string
13735
+ /**
13736
+ * Act for a synthetic member id instead of the caller identity (backend integrations)
13737
+ */
13738
+ member_id?: string
13739
+ /**
13740
+ * Presence entry TTL in seconds (1-3600)
13741
+ */
13742
+ ttl_seconds?: number
13743
+ }
13744
+
13745
+ export interface RealtimePresenceEnterOutput {
13746
+ /**
13747
+ * The entered/updated member
13748
+ */
13749
+ member: {
13750
+ /**
13751
+ * Last update timestamp (ms epoch)
13752
+ */
13753
+ ts: number
13754
+ /**
13755
+ * Arbitrary JSON metadata for the member
13756
+ */
13757
+ info?: {
13758
+ [k: string]: unknown
13759
+ }
13760
+ /**
13761
+ * Member identity
13762
+ */
13763
+ identity: string
13764
+ /**
13765
+ * Number of live sockets for this identity
13766
+ */
13767
+ connections: number
13768
+ }
13769
+ /**
13770
+ * Channel name
13771
+ */
13772
+ channel: string
13773
+ }
13774
+
13775
+ export interface RealtimePresenceGetInput {
13776
+ /**
13777
+ * Channel name, "namespace:rest"
13778
+ */
13779
+ channel: string
13780
+ }
13781
+
13782
+ export interface RealtimePresenceGetOutput {
13783
+ /**
13784
+ * Channel name
13785
+ */
13786
+ channel: string
13787
+ /**
13788
+ * Current roster, deduplicated by identity
13789
+ */
13790
+ members: {
13791
+ /**
13792
+ * Last update timestamp (ms epoch)
13793
+ */
13794
+ ts: number
13795
+ /**
13796
+ * Arbitrary JSON metadata for the member
13797
+ */
13798
+ info?: {
13799
+ [k: string]: unknown
13800
+ }
13801
+ /**
13802
+ * Member identity
13803
+ */
13804
+ identity: string
13805
+ /**
13806
+ * Number of live sockets for this identity
13807
+ */
13808
+ connections: number
13809
+ }[]
13810
+ }
13811
+
13812
+ export interface RealtimePresenceLeaveInput {
13813
+ /**
13814
+ * Channel name, "namespace:rest"
13815
+ */
13816
+ channel: string
13817
+ /**
13818
+ * Act for a synthetic member id instead of the caller identity (backend integrations)
13819
+ */
13820
+ member_id?: string
13821
+ }
13822
+
13823
+ export interface RealtimePresenceLeaveOutput {
13824
+ /**
13825
+ * Channel name
13826
+ */
13827
+ channel: string
13828
+ /**
13829
+ * Whether the member was removed
13830
+ */
13831
+ removed: boolean
13832
+ }
13833
+
13834
+ export interface RealtimePresenceStatsInput {
13835
+ /**
13836
+ * Channel name, "namespace:rest"
13837
+ */
13838
+ channel: string
13839
+ }
13840
+
13841
+ export interface RealtimePresenceStatsOutput {
13842
+ /**
13843
+ * Channel name
13844
+ */
13845
+ channel: string
13846
+ /**
13847
+ * Number of distinct identities present
13848
+ */
13849
+ members: number
13850
+ }
13851
+
13852
+ export interface RealtimePresenceUpdateInput {
13853
+ /**
13854
+ * Arbitrary JSON metadata for the member (<=10KB serialized)
13855
+ */
13856
+ info?: {
13857
+ [k: string]: unknown
13858
+ }
13859
+ /**
13860
+ * Channel name, "namespace:rest"
13861
+ */
13862
+ channel: string
13863
+ /**
13864
+ * Act for a synthetic member id instead of the caller identity (backend integrations)
13865
+ */
13866
+ member_id?: string
13867
+ /**
13868
+ * Presence entry TTL in seconds (1-3600)
13869
+ */
13870
+ ttl_seconds?: number
13871
+ }
13872
+
13873
+ export interface RealtimePresenceUpdateOutput {
13874
+ /**
13875
+ * The entered/updated member
13876
+ */
13877
+ member: {
13878
+ /**
13879
+ * Last update timestamp (ms epoch)
13880
+ */
13881
+ ts: number
13882
+ /**
13883
+ * Arbitrary JSON metadata for the member
13884
+ */
13885
+ info?: {
13886
+ [k: string]: unknown
13887
+ }
13888
+ /**
13889
+ * Member identity
13890
+ */
13891
+ identity: string
13892
+ /**
13893
+ * Number of live sockets for this identity
13894
+ */
13895
+ connections: number
13896
+ }
13897
+ /**
13898
+ * Channel name
13899
+ */
13900
+ channel: string
13901
+ }
13902
+
13903
+ export interface RealtimeStatusGetInput {
13904
+
13905
+ }
13906
+
13907
+ export interface RealtimeStatusGetOutput {
13908
+ /**
13909
+ * Redis fan-out connectivity
13910
+ */
13911
+ redis: ("connected" | "disconnected" | "unconfigured")
13912
+ /**
13913
+ * API liveness marker
13914
+ */
13915
+ service: "ok"
13916
+ /**
13917
+ * WebSocket URL of the realtime gateway
13918
+ */
13919
+ gatewayUrl: string
13920
+ /**
13921
+ * Whether the token signing key is present
13922
+ */
13923
+ signingKeyConfigured: boolean
13924
+ }
13925
+
13926
+ export interface RealtimeTokensCreateInput {
13927
+ /**
13928
+ * Concrete channels to filter the resolved capabilities to; omit to receive all capabilities the identity has
13929
+ *
13930
+ * @minItems 1
13931
+ * @maxItems 32
13932
+ */
13933
+ channels?: [string, ...(string)[]]
13934
+ }
13935
+
13936
+ export interface RealtimeTokensCreateOutput {
13937
+ /**
13938
+ * Signed EdDSA capability JWT (60s TTL)
13939
+ */
13940
+ token: string
13941
+ /**
13942
+ * WebSocket URL of the realtime gateway to connect to
13943
+ */
13944
+ gatewayUrl: string
13945
+ }
13946
+
13947
+ export interface RealtimeWebhookCreateInput {
13948
+ /**
13949
+ * Endpoint that receives signed lifecycle POSTs (https in production)
13950
+ */
13951
+ url: string
13952
+ /**
13953
+ * Lifecycle event types this webhook receives
13954
+ *
13955
+ * @minItems 1
13956
+ */
13957
+ events: [("channel.occupied" | "channel.vacated" | "presence.member-added" | "presence.member-removed"), ...(("channel.occupied" | "channel.vacated" | "presence.member-added" | "presence.member-removed"))[]]
13958
+ /**
13959
+ * Free-form note
13960
+ */
13961
+ description?: string
13962
+ }
13963
+
13964
+ export interface RealtimeWebhookCreateOutput {
13965
+ /**
13966
+ * Full signing secret — returned only once, at creation. Store it now.
13967
+ */
13968
+ secret: string
13969
+ webhook: {
13970
+ id: string
13971
+ url: string
13972
+ active: boolean
13973
+ events: string[]
13974
+ /**
13975
+ * Secret metadata only — never the secret itself
13976
+ */
13977
+ secrets: {
13978
+ /**
13979
+ * Visible secret prefix — matches the X-Realtime-Key header
13980
+ */
13981
+ prefix: string
13982
+ createdAt: string
13983
+ /**
13984
+ * When this secret stops verifying; null = current signer
13985
+ */
13986
+ expiresAt: (string | null)
13987
+ }[]
13988
+ createdAt: string
13989
+ updatedAt: string
13990
+ description: (string | null)
13991
+ }
13992
+ }
13993
+
13994
+ export interface RealtimeWebhookDeleteInput {
13995
+ /**
13996
+ * Webhook id
13997
+ */
13998
+ webhookId: string
13999
+ }
14000
+
14001
+ export interface RealtimeWebhookDeleteOutput {
14002
+ deleted: true
14003
+ }
14004
+
14005
+ export interface RealtimeWebhookDeliveriesListInput {
14006
+ /**
14007
+ * Max deliveries to return (newest first)
14008
+ */
14009
+ limit?: number
14010
+ /**
14011
+ * Webhook id
14012
+ */
14013
+ webhookId: string
14014
+ }
14015
+
14016
+ export interface RealtimeWebhookDeliveriesListOutput {
14017
+ deliveries: {
14018
+ id: string
14019
+ status: ("pending" | "succeeded" | "failed")
14020
+ /**
14021
+ * Source lifecycle event idempotencyKey
14022
+ */
14023
+ eventId: string
14024
+ attempts: number
14025
+ createdAt: string
14026
+ eventType: string
14027
+ lastError: (string | null)
14028
+ lastAttemptAt: (string | null)
14029
+ responseStatus: (number | null)
14030
+ }[]
14031
+ }
14032
+
14033
+ export interface RealtimeWebhookGetInput {
14034
+ /**
14035
+ * Webhook id
14036
+ */
14037
+ webhookId: string
14038
+ }
14039
+
14040
+ export interface RealtimeWebhookGetOutput {
14041
+ id: string
14042
+ url: string
14043
+ active: boolean
14044
+ events: string[]
14045
+ /**
14046
+ * Secret metadata only — never the secret itself
14047
+ */
14048
+ secrets: {
14049
+ /**
14050
+ * Visible secret prefix — matches the X-Realtime-Key header
14051
+ */
14052
+ prefix: string
14053
+ createdAt: string
14054
+ /**
14055
+ * When this secret stops verifying; null = current signer
14056
+ */
14057
+ expiresAt: (string | null)
14058
+ }[]
14059
+ createdAt: string
14060
+ updatedAt: string
14061
+ description: (string | null)
14062
+ }
14063
+
14064
+ export interface RealtimeWebhookListInput {
14065
+
14066
+ }
14067
+
14068
+ export interface RealtimeWebhookListOutput {
14069
+ webhooks: {
14070
+ id: string
14071
+ url: string
14072
+ active: boolean
14073
+ events: string[]
14074
+ /**
14075
+ * Secret metadata only — never the secret itself
14076
+ */
14077
+ secrets: {
14078
+ /**
14079
+ * Visible secret prefix — matches the X-Realtime-Key header
14080
+ */
14081
+ prefix: string
14082
+ createdAt: string
14083
+ /**
14084
+ * When this secret stops verifying; null = current signer
14085
+ */
14086
+ expiresAt: (string | null)
14087
+ }[]
14088
+ createdAt: string
14089
+ updatedAt: string
14090
+ description: (string | null)
14091
+ }[]
14092
+ }
14093
+
14094
+ export interface RealtimeWebhookSecretRotateInput {
14095
+ /**
14096
+ * Webhook id
14097
+ */
14098
+ webhookId: string
14099
+ }
14100
+
14101
+ export interface RealtimeWebhookSecretRotateOutput {
14102
+ /**
14103
+ * Visible prefix of the new secret (X-Realtime-Key)
14104
+ */
14105
+ prefix: string
14106
+ /**
14107
+ * New full signing secret — returned only once. Store it now.
14108
+ */
14109
+ secret: string
14110
+ /**
14111
+ * When the rotated-out secret stops verifying (grace window)
14112
+ */
14113
+ previousExpiresAt: (string | null)
14114
+ }
14115
+
14116
+ export interface RealtimeWebhookUpdateInput {
14117
+ /**
14118
+ * Endpoint that receives signed lifecycle POSTs (https in production)
14119
+ */
14120
+ url?: string
14121
+ /**
14122
+ * Inactive webhooks receive no deliveries
14123
+ */
14124
+ active?: boolean
14125
+ /**
14126
+ * Lifecycle event types this webhook receives
14127
+ *
14128
+ * @minItems 1
14129
+ */
14130
+ events?: [("channel.occupied" | "channel.vacated" | "presence.member-added" | "presence.member-removed"), ...(("channel.occupied" | "channel.vacated" | "presence.member-added" | "presence.member-removed"))[]]
14131
+ /**
14132
+ * Webhook id to update
14133
+ */
14134
+ webhookId: string
14135
+ /**
14136
+ * Free-form note
14137
+ */
14138
+ description?: (string | null)
14139
+ }
14140
+
14141
+ export interface RealtimeWebhookUpdateOutput {
14142
+ id: string
14143
+ url: string
14144
+ active: boolean
14145
+ events: string[]
14146
+ /**
14147
+ * Secret metadata only — never the secret itself
14148
+ */
14149
+ secrets: {
14150
+ /**
14151
+ * Visible secret prefix — matches the X-Realtime-Key header
14152
+ */
14153
+ prefix: string
14154
+ createdAt: string
14155
+ /**
14156
+ * When this secret stops verifying; null = current signer
14157
+ */
14158
+ expiresAt: (string | null)
14159
+ }[]
14160
+ createdAt: string
14161
+ updatedAt: string
14162
+ description: (string | null)
14163
+ }
14164
+
13277
14165
  export interface TrackingApiKeysCreateInput {
13278
14166
  name: string
13279
14167
  }