@warmhub/sdk-ts 0.157.0 → 0.158.1

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.
package/dist/index.d.ts CHANGED
@@ -167,6 +167,7 @@ type CommitRealOperationResult$1 = {
167
167
  status: 'applied' | 'noop';
168
168
  version?: number;
169
169
  dataHash?: string;
170
+ fileId?: string;
170
171
  } | {
171
172
  opIndex: number;
172
173
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -315,6 +316,12 @@ type CommitValidateInput$1 = {
315
316
  data: unknown;
316
317
  affirmedTargets?: Array<string>;
317
318
  skipExisting?: boolean;
319
+ file?: {
320
+ size?: number;
321
+ sha256?: string;
322
+ mediaType?: string;
323
+ filename?: string;
324
+ };
318
325
  kind?: never;
319
326
  shape?: never;
320
327
  } | {
@@ -323,6 +330,12 @@ type CommitValidateInput$1 = {
323
330
  shapes: Array<string>;
324
331
  data: unknown;
325
332
  affirmedTargets?: Array<string>;
333
+ file?: {
334
+ size?: number;
335
+ sha256?: string;
336
+ mediaType?: string;
337
+ filename?: string;
338
+ };
326
339
  expectedVersion?: number;
327
340
  leaseId?: string;
328
341
  kind?: never;
@@ -362,16 +375,19 @@ type CommitValidateInput$1 = {
362
375
  operation: 'redact';
363
376
  name: string;
364
377
  expectedVersion: number;
378
+ file?: never;
365
379
  } | {
366
380
  operation: 'remove';
367
381
  name: string;
368
382
  expectedVersion: number;
383
+ file?: never;
369
384
  } | {
370
385
  operation: 'rewrite';
371
386
  name: string;
372
387
  version: number;
373
388
  shapes: Array<string>;
374
389
  data: unknown;
390
+ file?: never;
375
391
  }>;
376
392
  includeWouldBeBody?: boolean;
377
393
  };
@@ -433,6 +449,11 @@ type CommitValidateResult$1 = {
433
449
  version?: number;
434
450
  dataHash?: string;
435
451
  wouldBeBody?: unknown;
452
+ file?: {
453
+ fileId: '00000000-0000-0000-0000-000000000000';
454
+ status: 'pending';
455
+ generation: 1;
456
+ };
436
457
  effects?: Array<{
437
458
  effectIndex: number;
438
459
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -469,6 +490,11 @@ type CommitValidateResult$1 = {
469
490
  version?: number;
470
491
  dataHash?: string;
471
492
  wouldBeBody?: unknown;
493
+ file?: {
494
+ fileId: '00000000-0000-0000-0000-000000000000';
495
+ status: 'pending';
496
+ generation: 1;
497
+ };
472
498
  } | {
473
499
  effectIndex: number;
474
500
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -706,6 +732,11 @@ type CommitValidateResult$1 = {
706
732
  version?: number;
707
733
  dataHash?: string;
708
734
  wouldBeBody?: unknown;
735
+ file?: {
736
+ fileId: '00000000-0000-0000-0000-000000000000';
737
+ status: 'pending';
738
+ generation: 1;
739
+ };
709
740
  } | {
710
741
  effectIndex: number;
711
742
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -874,6 +905,7 @@ type OperationEventReceipt$1 = {
874
905
  status: 'applied' | 'noop';
875
906
  version?: number;
876
907
  dataHash?: string;
908
+ fileId?: string;
877
909
  } | {
878
910
  opIndex: number;
879
911
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -1037,6 +1069,7 @@ type OperationEventReceiptV2 = {
1037
1069
  status: 'applied' | 'noop';
1038
1070
  version?: number;
1039
1071
  dataHash?: string;
1072
+ fileId?: string;
1040
1073
  } | {
1041
1074
  opIndex: number;
1042
1075
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -1329,6 +1362,7 @@ type ComponentInstallResult$1 = {
1329
1362
  status: 'applied' | 'noop';
1330
1363
  version?: number;
1331
1364
  dataHash?: string;
1365
+ fileId?: string;
1332
1366
  } | {
1333
1367
  opIndex: number;
1334
1368
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -1513,6 +1547,7 @@ type ComponentUninstallResult$1 = {
1513
1547
  status: 'applied' | 'noop';
1514
1548
  version?: number;
1515
1549
  dataHash?: string;
1550
+ fileId?: string;
1516
1551
  } | {
1517
1552
  opIndex: number;
1518
1553
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -1630,8 +1665,11 @@ type GrantCreateInput = {
1630
1665
  repoName: string;
1631
1666
  idempotencyKey: string;
1632
1667
  recipient: {
1633
- kind: 'member';
1668
+ kind: 'user';
1634
1669
  email: string;
1670
+ } | {
1671
+ kind: 'user';
1672
+ externalId: string;
1635
1673
  } | {
1636
1674
  kind: 'component';
1637
1675
  orgName: string;
@@ -1788,6 +1826,12 @@ type StreamAppendInput$1 = {
1788
1826
  data: unknown;
1789
1827
  affirmedTargets?: Array<string>;
1790
1828
  skipExisting?: boolean;
1829
+ file?: {
1830
+ size?: number;
1831
+ sha256?: string;
1832
+ mediaType?: string;
1833
+ filename?: string;
1834
+ };
1791
1835
  kind?: never;
1792
1836
  shape?: never;
1793
1837
  } | {
@@ -1796,6 +1840,12 @@ type StreamAppendInput$1 = {
1796
1840
  shapes: Array<string>;
1797
1841
  data: unknown;
1798
1842
  affirmedTargets?: Array<string>;
1843
+ file?: {
1844
+ size?: number;
1845
+ sha256?: string;
1846
+ mediaType?: string;
1847
+ filename?: string;
1848
+ };
1799
1849
  expectedVersion?: number;
1800
1850
  leaseId?: string;
1801
1851
  kind?: never;
@@ -1836,7 +1886,36 @@ type StreamAppendInput$1 = {
1836
1886
  submissionId: string;
1837
1887
  };
1838
1888
  type StreamAppendResult$1 = {
1839
- event: {
1889
+ allocatedTokenRanges: Array<{
1890
+ start: number;
1891
+ end: number;
1892
+ }>;
1893
+ repoSeq?: number;
1894
+ createdByEmail?: string;
1895
+ appendTotalMs?: number;
1896
+ appendResolveRepoMs?: number;
1897
+ appendApplyMs?: number;
1898
+ applySubphases?: {
1899
+ addThingMs?: number;
1900
+ addAssertionMs?: number;
1901
+ addAssertionResolveAboutMs?: number;
1902
+ reviseThingMs?: number;
1903
+ reviseAssertionMs?: number;
1904
+ reviseCollectionMs?: number;
1905
+ preparePinnedLoadShapeFieldsMs?: number;
1906
+ preparePinnedPinWrefsMs?: number;
1907
+ preparePinnedValidateMs?: number;
1908
+ operationLoopMs?: number;
1909
+ persistMs?: number;
1910
+ persistThingsMs?: number;
1911
+ persistVersionsMs?: number;
1912
+ persistAssertionsMs?: number;
1913
+ persistUpdatesMs?: number;
1914
+ persistOutboxMs?: number;
1915
+ refInsertMs?: number;
1916
+ refSourceCount?: number;
1917
+ };
1918
+ event?: {
1840
1919
  committedAt: string;
1841
1920
  eventDigest: string;
1842
1921
  operationCount: number;
@@ -1846,8 +1925,8 @@ type StreamAppendResult$1 = {
1846
1925
  };
1847
1926
  repoSeq: string;
1848
1927
  } | null;
1849
- eventRequestId: string;
1850
- operations: Array<{
1928
+ eventRequestId?: string;
1929
+ operations?: Array<{
1851
1930
  opIndex: number;
1852
1931
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
1853
1932
  name: string;
@@ -1884,6 +1963,7 @@ type StreamAppendResult$1 = {
1884
1963
  status: 'applied' | 'noop';
1885
1964
  version?: number;
1886
1965
  dataHash?: string;
1966
+ fileId?: string;
1887
1967
  } | {
1888
1968
  opIndex: number;
1889
1969
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -1969,162 +2049,11 @@ type StreamAppendResult$1 = {
1969
2049
  retryable?: boolean;
1970
2050
  }>;
1971
2051
  }>;
1972
- outcome: 'event' | 'no_event';
1973
- requestDigest: string;
1974
- schemaVersion: 'operation-event-receipt/v2';
2052
+ outcome?: 'event' | 'no_event';
2053
+ requestDigest?: string;
2054
+ schemaVersion?: 'operation-event-receipt/v2';
1975
2055
  submissionId?: string;
1976
2056
  pruned?: true;
1977
- allocatedTokenRanges: Array<{
1978
- start: number;
1979
- end: number;
1980
- }>;
1981
- results: Array<{
1982
- opIndex: number;
1983
- operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
1984
- name: string;
1985
- submittedName?: string;
1986
- resolvedName?: string;
1987
- warnings?: {
1988
- undeclaredFields?: Array<string>;
1989
- undeclaredFieldsTruncated?: true;
1990
- totalUndeclared?: number;
1991
- coalescedWrefs?: Array<{
1992
- fieldPath: string;
1993
- wref: string;
1994
- reason: string;
1995
- }>;
1996
- coalescedWrefsTruncated?: true;
1997
- totalCoalescedWrefs?: number;
1998
- deprecations?: Array<{
1999
- shape: string;
2000
- message: string;
2001
- removalMilestone: string;
2002
- }>;
2003
- ignoredVersionPins?: Array<{
2004
- fieldPath: string;
2005
- wref: string;
2006
- binding: 'identity';
2007
- }>;
2008
- shapeless?: true;
2009
- };
2010
- affirmations?: {
2011
- added: Array<string>;
2012
- removed: Array<string>;
2013
- ignored: Array<string>;
2014
- };
2015
- status: 'applied' | 'noop';
2016
- version?: number;
2017
- dataHash?: string;
2018
- } | {
2019
- opIndex: number;
2020
- operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
2021
- name: string;
2022
- submittedName?: string;
2023
- resolvedName?: string;
2024
- warnings?: {
2025
- undeclaredFields?: Array<string>;
2026
- undeclaredFieldsTruncated?: true;
2027
- totalUndeclared?: number;
2028
- coalescedWrefs?: Array<{
2029
- fieldPath: string;
2030
- wref: string;
2031
- reason: string;
2032
- }>;
2033
- coalescedWrefsTruncated?: true;
2034
- totalCoalescedWrefs?: number;
2035
- deprecations?: Array<{
2036
- shape: string;
2037
- message: string;
2038
- removalMilestone: string;
2039
- }>;
2040
- ignoredVersionPins?: Array<{
2041
- fieldPath: string;
2042
- wref: string;
2043
- binding: 'identity';
2044
- }>;
2045
- shapeless?: true;
2046
- };
2047
- affirmations?: {
2048
- added: Array<string>;
2049
- removed: Array<string>;
2050
- ignored: Array<string>;
2051
- };
2052
- status: 'error';
2053
- errors: Array<{
2054
- code: string;
2055
- message: string;
2056
- path?: string;
2057
- details?: {
2058
- reason: 'expected_version_mismatch';
2059
- expectedVersion: number;
2060
- currentVersion: number;
2061
- } | {
2062
- reason: 'lease_held';
2063
- leaseExpiresAt: string;
2064
- } | {
2065
- reason: 'validation_failed';
2066
- issues: Array<{
2067
- path: string;
2068
- message: string;
2069
- }>;
2070
- } | {
2071
- reason: 'rate_limit_reset';
2072
- retryAfterSeconds: number;
2073
- resetAt: string;
2074
- } | {
2075
- reason: 'cursor_fence_unavailable';
2076
- cause: 'not_ready' | 'below_floor' | 'above_head';
2077
- retryFromStart: true;
2078
- } | {
2079
- reason: 'dependency_failed';
2080
- producerOpIndexes: Array<number>;
2081
- } | {
2082
- reason: 'name_taken';
2083
- name: string;
2084
- takenBy?: {
2085
- durableId: string;
2086
- };
2087
- } | {
2088
- reason: 'target_removed';
2089
- targetDurableId: string;
2090
- fieldPath?: string;
2091
- } | {
2092
- reason: 'target_redacted';
2093
- targetDurableId: string;
2094
- fieldPath?: string;
2095
- } | {
2096
- reason: 'legacy-wrefs-window-ended';
2097
- } | {
2098
- reason: 'invalid_token';
2099
- };
2100
- retryable?: boolean;
2101
- }>;
2102
- }>;
2103
- repoSeq?: number;
2104
- createdByEmail?: string;
2105
- appendTotalMs?: number;
2106
- appendResolveRepoMs?: number;
2107
- appendApplyMs?: number;
2108
- applySubphases?: {
2109
- addThingMs?: number;
2110
- addAssertionMs?: number;
2111
- addAssertionResolveAboutMs?: number;
2112
- reviseThingMs?: number;
2113
- reviseAssertionMs?: number;
2114
- reviseCollectionMs?: number;
2115
- preparePinnedLoadShapeFieldsMs?: number;
2116
- preparePinnedPinWrefsMs?: number;
2117
- preparePinnedValidateMs?: number;
2118
- operationLoopMs?: number;
2119
- persistMs?: number;
2120
- persistThingsMs?: number;
2121
- persistVersionsMs?: number;
2122
- persistAssertionsMs?: number;
2123
- persistUpdatesMs?: number;
2124
- persistOutboxMs?: number;
2125
- refInsertMs?: number;
2126
- refSourceCount?: number;
2127
- };
2128
2057
  receipt: {
2129
2058
  event: {
2130
2059
  committedAt: string;
@@ -2174,6 +2103,7 @@ type StreamAppendResult$1 = {
2174
2103
  status: 'applied' | 'noop';
2175
2104
  version?: number;
2176
2105
  dataHash?: string;
2106
+ fileId?: string;
2177
2107
  } | {
2178
2108
  opIndex: number;
2179
2109
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -2265,6 +2195,129 @@ type StreamAppendResult$1 = {
2265
2195
  submissionId?: string;
2266
2196
  pruned?: true;
2267
2197
  };
2198
+ results?: Array<{
2199
+ opIndex: number;
2200
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
2201
+ name: string;
2202
+ submittedName?: string;
2203
+ resolvedName?: string;
2204
+ warnings?: {
2205
+ undeclaredFields?: Array<string>;
2206
+ undeclaredFieldsTruncated?: true;
2207
+ totalUndeclared?: number;
2208
+ coalescedWrefs?: Array<{
2209
+ fieldPath: string;
2210
+ wref: string;
2211
+ reason: string;
2212
+ }>;
2213
+ coalescedWrefsTruncated?: true;
2214
+ totalCoalescedWrefs?: number;
2215
+ deprecations?: Array<{
2216
+ shape: string;
2217
+ message: string;
2218
+ removalMilestone: string;
2219
+ }>;
2220
+ ignoredVersionPins?: Array<{
2221
+ fieldPath: string;
2222
+ wref: string;
2223
+ binding: 'identity';
2224
+ }>;
2225
+ shapeless?: true;
2226
+ };
2227
+ affirmations?: {
2228
+ added: Array<string>;
2229
+ removed: Array<string>;
2230
+ ignored: Array<string>;
2231
+ };
2232
+ status: 'applied' | 'noop';
2233
+ version?: number;
2234
+ dataHash?: string;
2235
+ fileId?: string;
2236
+ } | {
2237
+ opIndex: number;
2238
+ operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
2239
+ name: string;
2240
+ submittedName?: string;
2241
+ resolvedName?: string;
2242
+ warnings?: {
2243
+ undeclaredFields?: Array<string>;
2244
+ undeclaredFieldsTruncated?: true;
2245
+ totalUndeclared?: number;
2246
+ coalescedWrefs?: Array<{
2247
+ fieldPath: string;
2248
+ wref: string;
2249
+ reason: string;
2250
+ }>;
2251
+ coalescedWrefsTruncated?: true;
2252
+ totalCoalescedWrefs?: number;
2253
+ deprecations?: Array<{
2254
+ shape: string;
2255
+ message: string;
2256
+ removalMilestone: string;
2257
+ }>;
2258
+ ignoredVersionPins?: Array<{
2259
+ fieldPath: string;
2260
+ wref: string;
2261
+ binding: 'identity';
2262
+ }>;
2263
+ shapeless?: true;
2264
+ };
2265
+ affirmations?: {
2266
+ added: Array<string>;
2267
+ removed: Array<string>;
2268
+ ignored: Array<string>;
2269
+ };
2270
+ status: 'error';
2271
+ errors: Array<{
2272
+ code: string;
2273
+ message: string;
2274
+ path?: string;
2275
+ details?: {
2276
+ reason: 'expected_version_mismatch';
2277
+ expectedVersion: number;
2278
+ currentVersion: number;
2279
+ } | {
2280
+ reason: 'lease_held';
2281
+ leaseExpiresAt: string;
2282
+ } | {
2283
+ reason: 'validation_failed';
2284
+ issues: Array<{
2285
+ path: string;
2286
+ message: string;
2287
+ }>;
2288
+ } | {
2289
+ reason: 'rate_limit_reset';
2290
+ retryAfterSeconds: number;
2291
+ resetAt: string;
2292
+ } | {
2293
+ reason: 'cursor_fence_unavailable';
2294
+ cause: 'not_ready' | 'below_floor' | 'above_head';
2295
+ retryFromStart: true;
2296
+ } | {
2297
+ reason: 'dependency_failed';
2298
+ producerOpIndexes: Array<number>;
2299
+ } | {
2300
+ reason: 'name_taken';
2301
+ name: string;
2302
+ takenBy?: {
2303
+ durableId: string;
2304
+ };
2305
+ } | {
2306
+ reason: 'target_removed';
2307
+ targetDurableId: string;
2308
+ fieldPath?: string;
2309
+ } | {
2310
+ reason: 'target_redacted';
2311
+ targetDurableId: string;
2312
+ fieldPath?: string;
2313
+ } | {
2314
+ reason: 'legacy-wrefs-window-ended';
2315
+ } | {
2316
+ reason: 'invalid_token';
2317
+ };
2318
+ retryable?: boolean;
2319
+ }>;
2320
+ }>;
2268
2321
  };
2269
2322
  type StreamingSubmissionRow$1 = {
2270
2323
  opIndex: number;
@@ -2303,6 +2356,7 @@ type StreamingSubmissionRow$1 = {
2303
2356
  status: 'applied' | 'noop';
2304
2357
  version?: number;
2305
2358
  dataHash?: string;
2359
+ fileId?: string;
2306
2360
  type: 'result';
2307
2361
  chunkOrdinal: number;
2308
2362
  submissionIndex: number;
@@ -2438,7 +2492,12 @@ type StreamingSubmissionRow$1 = {
2438
2492
  message?: string;
2439
2493
  };
2440
2494
  type CommitApplyCompatibilityResult$1 = {
2441
- event: {
2495
+ committer?: string;
2496
+ createdByEmail?: string;
2497
+ message?: string;
2498
+ operationCount: number;
2499
+ repoSeq?: number;
2500
+ event?: {
2442
2501
  committedAt: string;
2443
2502
  eventDigest: string;
2444
2503
  operationCount: number;
@@ -2448,18 +2507,8 @@ type CommitApplyCompatibilityResult$1 = {
2448
2507
  };
2449
2508
  repoSeq: string;
2450
2509
  } | null;
2451
- eventRequestId: string;
2452
- outcome: 'event' | 'no_event';
2453
- requestDigest: string;
2454
- schemaVersion: 'operation-event-receipt/v2';
2455
- submissionId?: string;
2456
- pruned?: true;
2457
- committer?: string;
2458
- createdByEmail?: string;
2459
- message?: string;
2460
- operationCount: number;
2461
- repoSeq?: number;
2462
- operations: Array<{
2510
+ eventRequestId?: string;
2511
+ operations?: Array<{
2463
2512
  opIndex: number;
2464
2513
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
2465
2514
  name: string;
@@ -2496,6 +2545,7 @@ type CommitApplyCompatibilityResult$1 = {
2496
2545
  status: 'applied' | 'noop';
2497
2546
  version?: number;
2498
2547
  dataHash?: string;
2548
+ fileId?: string;
2499
2549
  } | {
2500
2550
  opIndex: number;
2501
2551
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -2581,6 +2631,11 @@ type CommitApplyCompatibilityResult$1 = {
2581
2631
  retryable?: boolean;
2582
2632
  }>;
2583
2633
  }>;
2634
+ outcome?: 'event' | 'no_event';
2635
+ requestDigest?: string;
2636
+ schemaVersion?: 'operation-event-receipt/v2';
2637
+ submissionId?: string;
2638
+ pruned?: true;
2584
2639
  receipt: {
2585
2640
  event: {
2586
2641
  committedAt: string;
@@ -2630,6 +2685,7 @@ type CommitApplyCompatibilityResult$1 = {
2630
2685
  status: 'applied' | 'noop';
2631
2686
  version?: number;
2632
2687
  dataHash?: string;
2688
+ fileId?: string;
2633
2689
  } | {
2634
2690
  opIndex: number;
2635
2691
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -2723,7 +2779,37 @@ type CommitApplyCompatibilityResult$1 = {
2723
2779
  };
2724
2780
  };
2725
2781
  type CollectionMutationCompatibilityResult = {
2726
- event: {
2782
+ type?: 'arc' | 'bond' | 'set' | 'list' | 'pair';
2783
+ wref?: string;
2784
+ version?: number;
2785
+ memberCount?: number;
2786
+ dataHash?: string;
2787
+ operationCount?: number;
2788
+ status?: 'created' | 'updated' | 'noop';
2789
+ warnings?: {
2790
+ undeclaredFields?: Array<string>;
2791
+ undeclaredFieldsTruncated?: true;
2792
+ totalUndeclared?: number;
2793
+ coalescedWrefs?: Array<{
2794
+ fieldPath: string;
2795
+ wref: string;
2796
+ reason: string;
2797
+ }>;
2798
+ coalescedWrefsTruncated?: true;
2799
+ totalCoalescedWrefs?: number;
2800
+ deprecations?: Array<{
2801
+ shape: string;
2802
+ message: string;
2803
+ removalMilestone: string;
2804
+ }>;
2805
+ ignoredVersionPins?: Array<{
2806
+ fieldPath: string;
2807
+ wref: string;
2808
+ binding: 'identity';
2809
+ }>;
2810
+ shapeless?: true;
2811
+ };
2812
+ event?: {
2727
2813
  committedAt: string;
2728
2814
  eventDigest: string;
2729
2815
  operationCount: number;
@@ -2733,8 +2819,8 @@ type CollectionMutationCompatibilityResult = {
2733
2819
  };
2734
2820
  repoSeq: string;
2735
2821
  } | null;
2736
- eventRequestId: string;
2737
- operations: Array<{
2822
+ eventRequestId?: string;
2823
+ operations?: Array<{
2738
2824
  opIndex: number;
2739
2825
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
2740
2826
  name: string;
@@ -2771,6 +2857,7 @@ type CollectionMutationCompatibilityResult = {
2771
2857
  status: 'applied' | 'noop';
2772
2858
  version?: number;
2773
2859
  dataHash?: string;
2860
+ fileId?: string;
2774
2861
  } | {
2775
2862
  opIndex: number;
2776
2863
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -2856,41 +2943,11 @@ type CollectionMutationCompatibilityResult = {
2856
2943
  retryable?: boolean;
2857
2944
  }>;
2858
2945
  }>;
2859
- outcome: 'event' | 'no_event';
2860
- requestDigest: string;
2861
- schemaVersion: 'operation-event-receipt/v2';
2946
+ outcome?: 'event' | 'no_event';
2947
+ requestDigest?: string;
2948
+ schemaVersion?: 'operation-event-receipt/v2';
2862
2949
  submissionId?: string;
2863
2950
  pruned?: true;
2864
- type?: 'arc' | 'bond' | 'set' | 'list' | 'pair';
2865
- wref?: string;
2866
- version?: number;
2867
- memberCount?: number;
2868
- dataHash?: string;
2869
- operationCount?: number;
2870
- status?: 'created' | 'updated' | 'noop';
2871
- warnings?: {
2872
- undeclaredFields?: Array<string>;
2873
- undeclaredFieldsTruncated?: true;
2874
- totalUndeclared?: number;
2875
- coalescedWrefs?: Array<{
2876
- fieldPath: string;
2877
- wref: string;
2878
- reason: string;
2879
- }>;
2880
- coalescedWrefsTruncated?: true;
2881
- totalCoalescedWrefs?: number;
2882
- deprecations?: Array<{
2883
- shape: string;
2884
- message: string;
2885
- removalMilestone: string;
2886
- }>;
2887
- ignoredVersionPins?: Array<{
2888
- fieldPath: string;
2889
- wref: string;
2890
- binding: 'identity';
2891
- }>;
2892
- shapeless?: true;
2893
- };
2894
2951
  receipt: {
2895
2952
  event: {
2896
2953
  committedAt: string;
@@ -2940,6 +2997,7 @@ type CollectionMutationCompatibilityResult = {
2940
2997
  status: 'applied' | 'noop';
2941
2998
  version?: number;
2942
2999
  dataHash?: string;
3000
+ fileId?: string;
2943
3001
  } | {
2944
3002
  opIndex: number;
2945
3003
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -3033,7 +3091,8 @@ type CollectionMutationCompatibilityResult = {
3033
3091
  };
3034
3092
  };
3035
3093
  type RemoveCompatibilityResult = {
3036
- event: {
3094
+ removed: true;
3095
+ event?: {
3037
3096
  committedAt: string;
3038
3097
  eventDigest: string;
3039
3098
  operationCount: number;
@@ -3043,8 +3102,8 @@ type RemoveCompatibilityResult = {
3043
3102
  };
3044
3103
  repoSeq: string;
3045
3104
  } | null;
3046
- eventRequestId: string;
3047
- operations: Array<{
3105
+ eventRequestId?: string;
3106
+ operations?: Array<{
3048
3107
  opIndex: number;
3049
3108
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
3050
3109
  name: string;
@@ -3081,6 +3140,7 @@ type RemoveCompatibilityResult = {
3081
3140
  status: 'applied' | 'noop';
3082
3141
  version?: number;
3083
3142
  dataHash?: string;
3143
+ fileId?: string;
3084
3144
  } | {
3085
3145
  opIndex: number;
3086
3146
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -3166,12 +3226,11 @@ type RemoveCompatibilityResult = {
3166
3226
  retryable?: boolean;
3167
3227
  }>;
3168
3228
  }>;
3169
- outcome: 'event' | 'no_event';
3170
- requestDigest: string;
3171
- schemaVersion: 'operation-event-receipt/v2';
3229
+ outcome?: 'event' | 'no_event';
3230
+ requestDigest?: string;
3231
+ schemaVersion?: 'operation-event-receipt/v2';
3172
3232
  submissionId?: string;
3173
3233
  pruned?: true;
3174
- removed: true;
3175
3234
  receipt: {
3176
3235
  event: {
3177
3236
  committedAt: string;
@@ -3221,6 +3280,7 @@ type RemoveCompatibilityResult = {
3221
3280
  status: 'applied' | 'noop';
3222
3281
  version?: number;
3223
3282
  dataHash?: string;
3283
+ fileId?: string;
3224
3284
  } | {
3225
3285
  opIndex: number;
3226
3286
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -3314,7 +3374,8 @@ type RemoveCompatibilityResult = {
3314
3374
  };
3315
3375
  };
3316
3376
  type RenameCompatibilityResult = {
3317
- event: {
3377
+ renamed: true;
3378
+ event?: {
3318
3379
  committedAt: string;
3319
3380
  eventDigest: string;
3320
3381
  operationCount: number;
@@ -3324,8 +3385,8 @@ type RenameCompatibilityResult = {
3324
3385
  };
3325
3386
  repoSeq: string;
3326
3387
  } | null;
3327
- eventRequestId: string;
3328
- operations: Array<{
3388
+ eventRequestId?: string;
3389
+ operations?: Array<{
3329
3390
  opIndex: number;
3330
3391
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
3331
3392
  name: string;
@@ -3362,6 +3423,7 @@ type RenameCompatibilityResult = {
3362
3423
  status: 'applied' | 'noop';
3363
3424
  version?: number;
3364
3425
  dataHash?: string;
3426
+ fileId?: string;
3365
3427
  } | {
3366
3428
  opIndex: number;
3367
3429
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -3447,12 +3509,11 @@ type RenameCompatibilityResult = {
3447
3509
  retryable?: boolean;
3448
3510
  }>;
3449
3511
  }>;
3450
- outcome: 'event' | 'no_event';
3451
- requestDigest: string;
3452
- schemaVersion: 'operation-event-receipt/v2';
3512
+ outcome?: 'event' | 'no_event';
3513
+ requestDigest?: string;
3514
+ schemaVersion?: 'operation-event-receipt/v2';
3453
3515
  submissionId?: string;
3454
3516
  pruned?: true;
3455
- renamed: true;
3456
3517
  receipt: {
3457
3518
  event: {
3458
3519
  committedAt: string;
@@ -3502,6 +3563,7 @@ type RenameCompatibilityResult = {
3502
3563
  status: 'applied' | 'noop';
3503
3564
  version?: number;
3504
3565
  dataHash?: string;
3566
+ fileId?: string;
3505
3567
  } | {
3506
3568
  opIndex: number;
3507
3569
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -3595,7 +3657,10 @@ type RenameCompatibilityResult = {
3595
3657
  };
3596
3658
  };
3597
3659
  type RewriteCompatibilityResult = {
3598
- event: {
3660
+ status?: 'applied' | 'noop';
3661
+ version?: number;
3662
+ dataHash?: string;
3663
+ event?: {
3599
3664
  committedAt: string;
3600
3665
  eventDigest: string;
3601
3666
  operationCount: number;
@@ -3605,8 +3670,8 @@ type RewriteCompatibilityResult = {
3605
3670
  };
3606
3671
  repoSeq: string;
3607
3672
  } | null;
3608
- eventRequestId: string;
3609
- operations: Array<{
3673
+ eventRequestId?: string;
3674
+ operations?: Array<{
3610
3675
  opIndex: number;
3611
3676
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
3612
3677
  name: string;
@@ -3643,6 +3708,7 @@ type RewriteCompatibilityResult = {
3643
3708
  status: 'applied' | 'noop';
3644
3709
  version?: number;
3645
3710
  dataHash?: string;
3711
+ fileId?: string;
3646
3712
  } | {
3647
3713
  opIndex: number;
3648
3714
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -3728,14 +3794,11 @@ type RewriteCompatibilityResult = {
3728
3794
  retryable?: boolean;
3729
3795
  }>;
3730
3796
  }>;
3731
- outcome: 'event' | 'no_event';
3732
- requestDigest: string;
3733
- schemaVersion: 'operation-event-receipt/v2';
3797
+ outcome?: 'event' | 'no_event';
3798
+ requestDigest?: string;
3799
+ schemaVersion?: 'operation-event-receipt/v2';
3734
3800
  submissionId?: string;
3735
3801
  pruned?: true;
3736
- status?: 'applied' | 'noop';
3737
- version?: number;
3738
- dataHash?: string;
3739
3802
  receipt: {
3740
3803
  event: {
3741
3804
  committedAt: string;
@@ -3785,6 +3848,7 @@ type RewriteCompatibilityResult = {
3785
3848
  status: 'applied' | 'noop';
3786
3849
  version?: number;
3787
3850
  dataHash?: string;
3851
+ fileId?: string;
3788
3852
  } | {
3789
3853
  opIndex: number;
3790
3854
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -3878,7 +3942,11 @@ type RewriteCompatibilityResult = {
3878
3942
  };
3879
3943
  };
3880
3944
  type ShapeChangeCompatibilityResult = {
3881
- event: {
3945
+ name?: string;
3946
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'noop';
3947
+ version?: number;
3948
+ dataHash?: string;
3949
+ event?: {
3882
3950
  committedAt: string;
3883
3951
  eventDigest: string;
3884
3952
  operationCount: number;
@@ -3888,8 +3956,8 @@ type ShapeChangeCompatibilityResult = {
3888
3956
  };
3889
3957
  repoSeq: string;
3890
3958
  } | null;
3891
- eventRequestId: string;
3892
- operations: Array<{
3959
+ eventRequestId?: string;
3960
+ operations?: Array<{
3893
3961
  opIndex: number;
3894
3962
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
3895
3963
  name: string;
@@ -3926,6 +3994,7 @@ type ShapeChangeCompatibilityResult = {
3926
3994
  status: 'applied' | 'noop';
3927
3995
  version?: number;
3928
3996
  dataHash?: string;
3997
+ fileId?: string;
3929
3998
  } | {
3930
3999
  opIndex: number;
3931
4000
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -4011,15 +4080,11 @@ type ShapeChangeCompatibilityResult = {
4011
4080
  retryable?: boolean;
4012
4081
  }>;
4013
4082
  }>;
4014
- outcome: 'event' | 'no_event';
4015
- requestDigest: string;
4016
- schemaVersion: 'operation-event-receipt/v2';
4083
+ outcome?: 'event' | 'no_event';
4084
+ requestDigest?: string;
4085
+ schemaVersion?: 'operation-event-receipt/v2';
4017
4086
  submissionId?: string;
4018
4087
  pruned?: true;
4019
- name?: string;
4020
- operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'noop';
4021
- version?: number;
4022
- dataHash?: string;
4023
4088
  receipt: {
4024
4089
  event: {
4025
4090
  committedAt: string;
@@ -4069,6 +4134,7 @@ type ShapeChangeCompatibilityResult = {
4069
4134
  status: 'applied' | 'noop';
4070
4135
  version?: number;
4071
4136
  dataHash?: string;
4137
+ fileId?: string;
4072
4138
  } | {
4073
4139
  opIndex: number;
4074
4140
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -4162,7 +4228,12 @@ type ShapeChangeCompatibilityResult = {
4162
4228
  };
4163
4229
  };
4164
4230
  type ShapeRemoveCompatibilityResult = {
4165
- event: {
4231
+ name?: string;
4232
+ operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'noop';
4233
+ version?: number;
4234
+ dataHash?: string;
4235
+ removed: true;
4236
+ event?: {
4166
4237
  committedAt: string;
4167
4238
  eventDigest: string;
4168
4239
  operationCount: number;
@@ -4172,8 +4243,8 @@ type ShapeRemoveCompatibilityResult = {
4172
4243
  };
4173
4244
  repoSeq: string;
4174
4245
  } | null;
4175
- eventRequestId: string;
4176
- operations: Array<{
4246
+ eventRequestId?: string;
4247
+ operations?: Array<{
4177
4248
  opIndex: number;
4178
4249
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
4179
4250
  name: string;
@@ -4210,6 +4281,7 @@ type ShapeRemoveCompatibilityResult = {
4210
4281
  status: 'applied' | 'noop';
4211
4282
  version?: number;
4212
4283
  dataHash?: string;
4284
+ fileId?: string;
4213
4285
  } | {
4214
4286
  opIndex: number;
4215
4287
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -4295,16 +4367,11 @@ type ShapeRemoveCompatibilityResult = {
4295
4367
  retryable?: boolean;
4296
4368
  }>;
4297
4369
  }>;
4298
- outcome: 'event' | 'no_event';
4299
- requestDigest: string;
4300
- schemaVersion: 'operation-event-receipt/v2';
4370
+ outcome?: 'event' | 'no_event';
4371
+ requestDigest?: string;
4372
+ schemaVersion?: 'operation-event-receipt/v2';
4301
4373
  submissionId?: string;
4302
4374
  pruned?: true;
4303
- name?: string;
4304
- operation?: 'add' | 'revise' | 'retract' | 'reaffirm' | 'noop';
4305
- version?: number;
4306
- dataHash?: string;
4307
- removed: true;
4308
4375
  receipt: {
4309
4376
  event: {
4310
4377
  committedAt: string;
@@ -4354,6 +4421,7 @@ type ShapeRemoveCompatibilityResult = {
4354
4421
  status: 'applied' | 'noop';
4355
4422
  version?: number;
4356
4423
  dataHash?: string;
4424
+ fileId?: string;
4357
4425
  } | {
4358
4426
  opIndex: number;
4359
4427
  operation: 'add' | 'revise' | 'retract' | 'reaffirm' | 'rename' | 'redact' | 'remove' | 'restore' | 'rewrite';
@@ -6256,9 +6324,9 @@ declare function createKeepShapesResolver(read: ThingShapesReader): (operations:
6256
6324
  *
6257
6325
  * @internal
6258
6326
  */
6259
- declare function streamAppendResultStatus(result: StreamAppendResult$1['results'][number]): 'applied' | 'noop' | 'error';
6327
+ declare function streamAppendResultStatus(result: StreamAppendResult$1['receipt']['operations'][number]): 'applied' | 'noop' | 'error';
6260
6328
  /** @internal */
6261
- declare function countStreamAppendResultStatuses(results: StreamAppendResult$1['results']): {
6329
+ declare function countStreamAppendResultStatuses(results: StreamAppendResult$1['receipt']['operations']): {
6262
6330
  applied: number;
6263
6331
  noop: number;
6264
6332
  error: number;
@@ -6297,6 +6365,8 @@ type ShapesChoice = {
6297
6365
  readonly shapes?: never;
6298
6366
  readonly keepShapes?: never;
6299
6367
  };
6368
+ /** Marks a write as a file; each hint is pinned for the upload. */
6369
+ type FileInput = NonNullable<AddOperation['file']>;
6300
6370
  /**
6301
6371
  * Input to `OperationBuilder.add(name, input)`.
6302
6372
  * @see https://docs.warmhub.ai/sdk-reference/type-aliases/addinput/
@@ -6314,6 +6384,8 @@ type AddInput = ShapesChoice & {
6314
6384
  readonly affirmedTargets?: readonly string[];
6315
6385
  /** When true, an existing target returns `noop` instead of failing. */
6316
6386
  readonly skipExisting?: boolean;
6387
+ /** Marks the write as a file: its version lands pending until upload. */
6388
+ readonly file?: FileInput;
6317
6389
  };
6318
6390
  /**
6319
6391
  * Input to `OperationBuilder.revise(name, input)`.
@@ -6341,6 +6413,8 @@ type ReviseInput = (ShapesChoice | {
6341
6413
  readonly data: unknown;
6342
6414
  /** The complete affirmation set for the changed claim. */
6343
6415
  readonly affirmedTargets?: readonly string[];
6416
+ /** Marks the write as a file: its version lands pending until upload. */
6417
+ readonly file?: FileInput;
6344
6418
  /**
6345
6419
  * Apply only if the Thing is still at this version; a stale value is a
6346
6420
  * `CONFLICT` with `details.reason = 'expected_version_mismatch'`.
@@ -10306,8 +10380,8 @@ declare class WarmHubClient {
10306
10380
  */
10307
10381
  rename: (orgName: string, repoName: string, name: string, newName: string, opts: RenameOptions) => Promise<RenameResult>;
10308
10382
  /**
10309
- * Permanently remove a Thing and all its versions. Requires an
10310
- * unrestricted `things:delete` grant.
10383
+ * Permanently remove a Thing and all its versions. Requires
10384
+ * `things:delete` with a whole-repository selection.
10311
10385
  *
10312
10386
  * `wref` is a local wref (`Shape/name` or `Shape`) or a durable ID in this
10313
10387
  * repo; a retracted Thing is named by its durable ID. References to the
@@ -10317,8 +10391,8 @@ declare class WarmHubClient {
10317
10391
  remove: (orgName: string, repoName: string, wref: string, opts: RemoveOptions) => Promise<RemoveResult>;
10318
10392
  /**
10319
10393
  * Irreversibly erase one Thing's canonical content and former name while
10320
- * preserving its durable identity and inbound references. Requires an
10321
- * unrestricted `things:redact` grant.
10394
+ * preserving its durable identity and inbound references. Requires
10395
+ * `things:redact` with a whole-repository selection.
10322
10396
  *
10323
10397
  * `durableId` must be the bare durable ID from a prior read, never a wref.
10324
10398
  * This core operation does not erase backups, completed exports, logs, or
@@ -10328,8 +10402,9 @@ declare class WarmHubClient {
10328
10402
  redact: (orgName: string, repoName: string, durableId: string, opts: RedactOptions) => Promise<RedactResult>;
10329
10403
  /**
10330
10404
  * Replace the body of one exact version in place, to correct bad data.
10331
- * Requires an unrestricted `things:rewrite` grant. The version number
10332
- * does not change and no version is minted; revise to record a new state.
10405
+ * Requires `things:rewrite` with a whole-repository selection. The version
10406
+ * number does not change and no version is minted; revise to record a new
10407
+ * state.
10333
10408
  *
10334
10409
  * `wref` is the Thing's name or a durable ID in this repo. `opts.shapes`
10335
10410
  * is the version's declared Shapes plus `CorrectedThing`. `opts.data` is