@highlightxyz/sdk 0.1.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 (54) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +28 -0
  3. package/lib/client.d.ts +10 -0
  4. package/lib/client.d.ts.map +1 -0
  5. package/lib/client.js +8 -0
  6. package/lib/index.d.ts +2 -0
  7. package/lib/index.d.ts.map +1 -0
  8. package/lib/index.js +1 -0
  9. package/lib/v1/gen/client/client.gen.d.ts +3 -0
  10. package/lib/v1/gen/client/client.gen.d.ts.map +1 -0
  11. package/lib/v1/gen/client/client.gen.js +234 -0
  12. package/lib/v1/gen/client/index.d.ts +9 -0
  13. package/lib/v1/gen/client/index.d.ts.map +1 -0
  14. package/lib/v1/gen/client/index.js +6 -0
  15. package/lib/v1/gen/client/types.gen.d.ts +118 -0
  16. package/lib/v1/gen/client/types.gen.d.ts.map +1 -0
  17. package/lib/v1/gen/client/types.gen.js +2 -0
  18. package/lib/v1/gen/client/utils.gen.d.ts +34 -0
  19. package/lib/v1/gen/client/utils.gen.d.ts.map +1 -0
  20. package/lib/v1/gen/client/utils.gen.js +228 -0
  21. package/lib/v1/gen/client.gen.d.ts +13 -0
  22. package/lib/v1/gen/client.gen.d.ts.map +1 -0
  23. package/lib/v1/gen/client.gen.js +3 -0
  24. package/lib/v1/gen/core/auth.gen.d.ts +19 -0
  25. package/lib/v1/gen/core/auth.gen.d.ts.map +1 -0
  26. package/lib/v1/gen/core/auth.gen.js +14 -0
  27. package/lib/v1/gen/core/bodySerializer.gen.d.ts +26 -0
  28. package/lib/v1/gen/core/bodySerializer.gen.d.ts.map +1 -0
  29. package/lib/v1/gen/core/bodySerializer.gen.js +57 -0
  30. package/lib/v1/gen/core/params.gen.d.ts +44 -0
  31. package/lib/v1/gen/core/params.gen.d.ts.map +1 -0
  32. package/lib/v1/gen/core/params.gen.js +100 -0
  33. package/lib/v1/gen/core/pathSerializer.gen.d.ts +34 -0
  34. package/lib/v1/gen/core/pathSerializer.gen.d.ts.map +1 -0
  35. package/lib/v1/gen/core/pathSerializer.gen.js +106 -0
  36. package/lib/v1/gen/core/queryKeySerializer.gen.d.ts +19 -0
  37. package/lib/v1/gen/core/queryKeySerializer.gen.d.ts.map +1 -0
  38. package/lib/v1/gen/core/queryKeySerializer.gen.js +92 -0
  39. package/lib/v1/gen/core/serverSentEvents.gen.d.ts +72 -0
  40. package/lib/v1/gen/core/serverSentEvents.gen.d.ts.map +1 -0
  41. package/lib/v1/gen/core/serverSentEvents.gen.js +133 -0
  42. package/lib/v1/gen/core/types.gen.d.ts +79 -0
  43. package/lib/v1/gen/core/types.gen.d.ts.map +1 -0
  44. package/lib/v1/gen/core/types.gen.js +2 -0
  45. package/lib/v1/gen/core/utils.gen.d.ts +20 -0
  46. package/lib/v1/gen/core/utils.gen.d.ts.map +1 -0
  47. package/lib/v1/gen/core/utils.gen.js +87 -0
  48. package/lib/v1/gen/sdk.gen.d.ts +689 -0
  49. package/lib/v1/gen/sdk.gen.d.ts.map +1 -0
  50. package/lib/v1/gen/sdk.gen.js +1116 -0
  51. package/lib/v1/gen/types.gen.d.ts +2960 -0
  52. package/lib/v1/gen/types.gen.d.ts.map +1 -0
  53. package/lib/v1/gen/types.gen.js +118 -0
  54. package/package.json +69 -0
@@ -0,0 +1,689 @@
1
+ import { type Client, type Options as Options2, type TDataShape } from "./client";
2
+ import { type ApiKeyCreateErrors, type ApiKeyCreateResponses, type ApiKeyListErrors, type ApiKeyListResponses, type ApiKeyRevokeErrors, type ApiKeyRevokeResponses, CaptureSettingsTrigger, type CollectionAddSaleErrors, type CollectionAddSaleResponses, type CollectionBidSaleErrors, type CollectionBidSaleResponses, type CollectionClaimSaleErrors, type CollectionClaimSaleResponses, type CollectionConfirmBidErrors, type CollectionConfirmBidResponses, type CollectionConfirmSaleErrors, type CollectionConfirmSaleResponses, type CollectionCreateErrors, type CollectionCreateResponses, type CollectionDeleteSaleErrors, type CollectionDeleteSaleResponses, type CollectionDeployConfirmErrors, type CollectionDeployConfirmResponses, type CollectionDeployErrors, type CollectionDeployResponses, type CollectionDeployStatusErrors, type CollectionDeployStatusResponses, type CollectionFinalizeBaseUriErrors, type CollectionFinalizeBaseUriResponses, type CollectionGetErrors, type CollectionGetResponses, type CollectionGetSalesErrors, type CollectionGetSalesResponses, type CollectionListErrors, type CollectionListResponses, CollectionType, type CollectionUpdateEditionDetailsErrors, type CollectionUpdateEditionDetailsResponses, type CollectionUpdateGenerativeDetailsErrors, type CollectionUpdateGenerativeDetailsResponses, type CollectionUpdateSaleErrors, type CollectionUpdateSaleResponses, type CollectionUpdateSeriesDetailsErrors, type CollectionUpdateSeriesDetailsResponses, type ConfigChainsResponses, type ConfigSystemContractErrors, type ConfigSystemContractResponses, type ContractGetErrors, type ContractGetResponses, type ContractListErrors, type ContractListResponses, ContractStandard, type GateCreateErrors, type GateCreateResponses, type GateGetErrors, type GateGetResponses, type GateListErrors, type GateListResponses, GateMatchMode, type GateRemoveErrors, type GateRemoveResponses, type GateUpdateErrors, type GateUpdateResponses, GenerativeEditionType, type HealthGetResponses, type MechanicAddDeploymentErrors, type MechanicAddDeploymentResponses, type MechanicCreateErrors, type MechanicCreateResponses, type MechanicGetErrors, type MechanicGetResponses, type MechanicListResponses, type MechanicRemoveDeploymentErrors, type MechanicRemoveDeploymentResponses, type MechanicUpdateErrors, type MechanicUpdateResponses, type MediaCreateUploadSessionErrors, type MediaCreateUploadSessionResponses, type MediaDeleteErrors, type MediaDeleteResponses, type MediaGetChildErrors, type MediaGetChildResponses, type MediaGetErrors, type MediaGetResponses, MediaKind, type MediaListChildrenErrors, type MediaListChildrenResponses, type MediaProcessErrors, type MediaProcessResponses, type MediaPublishErrors, type MediaPublishResponses, MediaScope, type MediaUploadErrors, type MediaUploadResponses, type PostIndexerChainsByChainIdActivateResponses, type PostIndexerChainsByChainIdPollResponses, type PostIndexerChainsByChainIdResetResponses, SaleAccessMode, SaleType, SelectorType, type TokenGetErrors, type TokenGetResponses, type TokenListErrors, type TokenListResponses, type UserSigninErrors, type UserSigninResponses, type UserSiweNonceErrors, type UserSiweNonceResponses } from "./types.gen";
3
+ export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = Options2<TData, ThrowOnError> & {
4
+ /**
5
+ * You can provide a client instance returned by `createClient()` instead of
6
+ * individual options. This might be also useful if you want to implement a
7
+ * custom client.
8
+ */
9
+ client?: Client;
10
+ /**
11
+ * You can pass arbitrary values through the `meta` object. This can be
12
+ * used to access values that aren't defined as part of the SDK function.
13
+ */
14
+ meta?: Record<string, unknown>;
15
+ };
16
+ declare class HeyApiClient {
17
+ protected client: Client;
18
+ constructor(args?: {
19
+ client?: Client;
20
+ });
21
+ }
22
+ declare class HeyApiRegistry<T> {
23
+ private readonly defaultKey;
24
+ private readonly instances;
25
+ get(key?: string): T;
26
+ set(value: T, key?: string): void;
27
+ }
28
+ export declare class Collection extends HeyApiClient {
29
+ /**
30
+ * List collections
31
+ *
32
+ * Get a paginated list of collections.
33
+ */
34
+ list<ThrowOnError extends boolean = false>(parameters: {
35
+ page?: number;
36
+ limit?: number;
37
+ sortBy?: "CREATED_DATE" | "NAME";
38
+ sortDirection?: "ASC" | "DESC";
39
+ status?: "Draft" | "InProgress" | "Live" | "Migrated" | "Disabled";
40
+ blockchains: Array<number>;
41
+ testnet: boolean;
42
+ types: Array<"OpenEdition" | "LimitedEdition" | "OneOfOne" | "Series" | "GenerativeSeries">;
43
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionListResponses, CollectionListErrors, ThrowOnError, "fields">;
44
+ /**
45
+ * Create collection
46
+ *
47
+ * Create a draft collection and bind it to an existing or new draft contract.
48
+ */
49
+ create<ThrowOnError extends boolean = false>(parameters: {
50
+ name: string;
51
+ description: string;
52
+ contractId?: string;
53
+ contract?: {
54
+ chainId: number;
55
+ name: string;
56
+ symbol: string;
57
+ standard: ContractStandard;
58
+ };
59
+ logoMediaId: string;
60
+ image: string;
61
+ type: CollectionType;
62
+ royalty?: {
63
+ address: string;
64
+ amount: number;
65
+ };
66
+ tokenManager?: string;
67
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionCreateResponses, CollectionCreateErrors, ThrowOnError, "fields">;
68
+ /**
69
+ * Get collection
70
+ *
71
+ * Get a collection by its highlight ID.
72
+ */
73
+ get<ThrowOnError extends boolean = false>(parameters: {
74
+ highlightId: string;
75
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionGetResponses, CollectionGetErrors, ThrowOnError, "fields">;
76
+ /**
77
+ * Finalize collection base URI to Arweave
78
+ *
79
+ * Publish the collection's token-metadata base URI Directory to Arweave. Call once the collection is complete (sellout or manual trigger) to freeze metadata permanently. Idempotent — safe to call if already archived.
80
+ */
81
+ finalizeBaseUri<ThrowOnError extends boolean = false>(parameters: {
82
+ highlightId: string;
83
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionFinalizeBaseUriResponses, CollectionFinalizeBaseUriErrors, ThrowOnError, "fields">;
84
+ /**
85
+ * Update generative draft details
86
+ *
87
+ * Update generative-specific details for an existing draft.
88
+ */
89
+ updateGenerativeDetails<ThrowOnError extends boolean = false>(parameters: {
90
+ highlightId: string;
91
+ generative: {
92
+ size: number;
93
+ codeMediaId: string;
94
+ isCurated?: boolean;
95
+ isGpuRendering?: boolean;
96
+ editionType?: GenerativeEditionType;
97
+ allowedHashes?: Array<string>;
98
+ requiredParams?: Array<string>;
99
+ captureSettings?: {
100
+ trigger: CaptureSettingsTrigger;
101
+ delay?: number;
102
+ selector?: string;
103
+ selectorType?: SelectorType;
104
+ viewPortHeight?: number;
105
+ viewPortWidth?: number;
106
+ };
107
+ };
108
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionUpdateGenerativeDetailsResponses, CollectionUpdateGenerativeDetailsErrors, ThrowOnError, "fields">;
109
+ /**
110
+ * Update series draft details
111
+ *
112
+ * Update series-specific details for an existing draft.
113
+ */
114
+ updateSeriesDetails<ThrowOnError extends boolean = false>(parameters: {
115
+ highlightId: string;
116
+ series: {
117
+ size: number;
118
+ isCollectorsChoice?: boolean;
119
+ assetsMediaId?: string;
120
+ };
121
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionUpdateSeriesDetailsResponses, CollectionUpdateSeriesDetailsErrors, ThrowOnError, "fields">;
122
+ /**
123
+ * Update edition draft details
124
+ *
125
+ * Update edition-specific details for an existing draft.
126
+ */
127
+ updateEditionDetails<ThrowOnError extends boolean = false>(parameters: {
128
+ highlightId: string;
129
+ edition: {
130
+ size: number;
131
+ name?: string;
132
+ description?: string;
133
+ imageMediaId: string;
134
+ animationMediaId?: string | null;
135
+ attributes?: Array<{
136
+ traitType: string;
137
+ value: string;
138
+ }>;
139
+ };
140
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionUpdateEditionDetailsResponses, CollectionUpdateEditionDetailsErrors, ThrowOnError, "fields">;
141
+ /**
142
+ * Get collection sales
143
+ *
144
+ * Get all sales for a collection.
145
+ */
146
+ getSales<ThrowOnError extends boolean = false>(parameters: {
147
+ highlightId: string;
148
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionGetSalesResponses, CollectionGetSalesErrors, ThrowOnError, "fields">;
149
+ /**
150
+ * Add a sale to a collection
151
+ *
152
+ * Add a new sale to a collection. Draft collections can have one sale at a time. For live collections, gated sales go live immediately; public sales return a contract execution for on-chain registration.
153
+ */
154
+ addSale<ThrowOnError extends boolean = false>(parameters: {
155
+ highlightId: string;
156
+ name?: string | null;
157
+ type: SaleType;
158
+ startAt: string;
159
+ endAt?: string | null;
160
+ price: string;
161
+ currency: string;
162
+ maxPerTransaction: number;
163
+ maxPerWallet: number;
164
+ maxTotal: number;
165
+ paymentRecipient: string;
166
+ accessMode?: SaleAccessMode;
167
+ gateId?: string | null;
168
+ gasSponsored?: boolean;
169
+ mechanicId?: string | null;
170
+ typeConfig?: unknown | null;
171
+ collectorMessage?: string | null;
172
+ customMintFee?: string | null;
173
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionAddSaleResponses, CollectionAddSaleErrors, ThrowOnError, "fields">;
174
+ /**
175
+ * Delete a sale
176
+ *
177
+ * Delete a draft sale from a collection. Live sales cannot be deleted — use update to pause or set an end date instead.
178
+ */
179
+ deleteSale<ThrowOnError extends boolean = false>(parameters: {
180
+ highlightId: string;
181
+ saleId: string;
182
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionDeleteSaleResponses, CollectionDeleteSaleErrors, ThrowOnError, "fields">;
183
+ /**
184
+ * Update a sale
185
+ *
186
+ * Update an existing sale. Draft sales can be updated freely. Live public sales return a contract execution for on-chain updates when on-chain fields change.
187
+ */
188
+ updateSale<ThrowOnError extends boolean = false>(parameters: {
189
+ highlightId: string;
190
+ saleId: string;
191
+ name?: string | null;
192
+ startAt?: string;
193
+ endAt?: string | null;
194
+ price?: string;
195
+ currency?: string;
196
+ maxPerTransaction?: number;
197
+ maxPerWallet?: number;
198
+ maxTotal?: number;
199
+ paymentRecipient?: string;
200
+ paused?: boolean;
201
+ collectorMessage?: string | null;
202
+ customMintFee?: string | null;
203
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionUpdateSaleResponses, CollectionUpdateSaleErrors, ThrowOnError, "fields">;
204
+ /**
205
+ * Claim collection sale
206
+ *
207
+ * Build a claim transaction configuration for a collector sale action.
208
+ */
209
+ claimSale<ThrowOnError extends boolean = false>(parameters: {
210
+ highlightId: string;
211
+ saleId: string;
212
+ amount: number;
213
+ tokenIds?: Array<number>;
214
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionClaimSaleResponses, CollectionClaimSaleErrors, ThrowOnError, "fields">;
215
+ /**
216
+ * Bid on ranked auction sale
217
+ *
218
+ * Build a bid transaction configuration for a ranked auction sale. Returns contract execution data for placing or updating a bid.
219
+ */
220
+ bidSale<ThrowOnError extends boolean = false>(parameters: {
221
+ highlightId: string;
222
+ saleId: string;
223
+ bidAmount: string;
224
+ bidId?: number;
225
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionBidSaleResponses, CollectionBidSaleErrors, ThrowOnError, "fields">;
226
+ /**
227
+ * Confirm ranked auction bid
228
+ *
229
+ * Record a confirmed on-chain bid for a ranked auction sale. Called after the bid transaction is confirmed on-chain.
230
+ */
231
+ confirmBid<ThrowOnError extends boolean = false>(parameters: {
232
+ highlightId: string;
233
+ saleId: string;
234
+ txHash: string;
235
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionConfirmBidResponses, CollectionConfirmBidErrors, ThrowOnError, "fields">;
236
+ /**
237
+ * Confirm sale deployment
238
+ *
239
+ * Confirm on-chain deployment of a public sale added to a live collection. Extracts the vector ID from the transaction receipt and sets the sale status to Live.
240
+ */
241
+ confirmSale<ThrowOnError extends boolean = false>(parameters: {
242
+ highlightId: string;
243
+ saleId: string;
244
+ txHash: string;
245
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionConfirmSaleResponses, CollectionConfirmSaleErrors, ThrowOnError, "fields">;
246
+ /**
247
+ * Initiate collection deployment
248
+ *
249
+ * Start the deployment workflow for a draft collection.
250
+ */
251
+ deploy<ThrowOnError extends boolean = false>(parameters: {
252
+ highlightId: string;
253
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionDeployResponses, CollectionDeployErrors, ThrowOnError, "fields">;
254
+ /**
255
+ * Get deployment status
256
+ *
257
+ * Get the current deployment status for a collection.
258
+ */
259
+ deployStatus<ThrowOnError extends boolean = false>(parameters: {
260
+ highlightId: string;
261
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionDeployStatusResponses, CollectionDeployStatusErrors, ThrowOnError, "fields">;
262
+ /**
263
+ * Confirm deployment transaction
264
+ *
265
+ * Submit the transaction hash for a deployment awaiting confirmation.
266
+ */
267
+ deployConfirm<ThrowOnError extends boolean = false>(parameters: {
268
+ highlightId: string;
269
+ txHash: string;
270
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionDeployConfirmResponses, CollectionDeployConfirmErrors, ThrowOnError, "fields">;
271
+ }
272
+ export declare class Token extends HeyApiClient {
273
+ /**
274
+ * List tokens
275
+ *
276
+ * Get a paginated list of minted tokens for a collection. Returns tokens for public collections without authentication. Supports filtering by owner address.
277
+ */
278
+ list<ThrowOnError extends boolean = false>(parameters: {
279
+ highlightId: string;
280
+ page?: number;
281
+ limit?: number;
282
+ sort?: "tokenId" | "name" | "mintedAt" | "createdAt";
283
+ order?: "asc" | "desc";
284
+ ownerAddress?: string;
285
+ search?: string;
286
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<TokenListResponses, TokenListErrors, ThrowOnError, "fields">;
287
+ /**
288
+ * Get token
289
+ *
290
+ * Get a single minted token by its on-chain token ID. Returns token details for public collections without authentication.
291
+ */
292
+ get<ThrowOnError extends boolean = false>(parameters: {
293
+ highlightId: string;
294
+ tokenId: string;
295
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<TokenGetResponses, TokenGetErrors, ThrowOnError, "fields">;
296
+ }
297
+ export declare class Config extends HeyApiClient {
298
+ /**
299
+ * List chains
300
+ *
301
+ * Get the list of supported chains and their configuration.
302
+ */
303
+ chains<ThrowOnError extends boolean = false>(options?: Options<never, ThrowOnError>): import("./client").RequestResult<ConfigChainsResponses, unknown, ThrowOnError, "fields">;
304
+ /**
305
+ * Get system contract
306
+ *
307
+ * Get a configured system contract address for a chain and contract type.
308
+ */
309
+ systemContract<ThrowOnError extends boolean = false>(parameters: {
310
+ chainId: number;
311
+ type: "CollectionFactory" | "MintManager" | "AuctionManager" | "PermissionsRegistry" | "EditionsMetadataRenderer" | "NonTransferableTokenManager" | "ConsensualNonTransferableTokenManager" | "ConsensualNonTransferableTokenManager2" | "GenerativeSeriesImplementation" | "SeriesImplementation" | "MultipleEditionsImplementation" | "MultipleEditionsDFSImplementation" | "SingleEditionImplementation" | "SingleEditionDFSImplementation" | "MinimalForwarder" | "Observability" | "RandomSeriesImplementation" | "MintFeeOracle" | "GengineObservability" | "ReferralManager" | "RazorWorksImplementation" | "EditionsDFS1155Implementation" | "ObservabilityV2" | "BitstreamSeedManager";
312
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<ConfigSystemContractResponses, ConfigSystemContractErrors, ThrowOnError, "fields">;
313
+ }
314
+ export declare class Contract extends HeyApiClient {
315
+ /**
316
+ * List contracts
317
+ *
318
+ * Get a cursor-paginated list of contracts.
319
+ */
320
+ list<ThrowOnError extends boolean = false>(parameters?: {
321
+ limit?: number;
322
+ cursor?: string;
323
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<ContractListResponses, ContractListErrors, ThrowOnError, "fields">;
324
+ /**
325
+ * Get contract
326
+ *
327
+ * Get a contract by its ID.
328
+ */
329
+ get<ThrowOnError extends boolean = false>(parameters: {
330
+ contractId: string;
331
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<ContractGetResponses, ContractGetErrors, ThrowOnError, "fields">;
332
+ }
333
+ export declare class Gate extends HeyApiClient {
334
+ /**
335
+ * List gates
336
+ *
337
+ * List all gates for the authenticated user.
338
+ */
339
+ list<ThrowOnError extends boolean = false>(options?: Options<never, ThrowOnError>): import("./client").RequestResult<GateListResponses, GateListErrors, ThrowOnError, "fields">;
340
+ /**
341
+ * Create gate
342
+ *
343
+ * Create a new gate with conditions.
344
+ */
345
+ create<ThrowOnError extends boolean = false>(parameters: {
346
+ name: string;
347
+ matchMode?: GateMatchMode;
348
+ conditions: Array<{
349
+ type: "ALLOWLIST";
350
+ config: {
351
+ addresses: Array<string>;
352
+ };
353
+ } | {
354
+ type: "TOKEN_OWNERSHIP";
355
+ config: {
356
+ contractAddress: string;
357
+ chainId: number;
358
+ minAmount?: number;
359
+ };
360
+ } | {
361
+ type: "SPECIFIC_TOKEN";
362
+ config: {
363
+ contractAddress: string;
364
+ chainId: number;
365
+ tokenId: string;
366
+ };
367
+ } | {
368
+ type: "TOKEN_ATTRIBUTE";
369
+ config: {
370
+ contractAddress: string;
371
+ chainId: number;
372
+ traitType: string;
373
+ traitValue: string;
374
+ };
375
+ } | {
376
+ type: "CURRENCY_BALANCE";
377
+ config: {
378
+ chainId: number;
379
+ contractAddress?: string;
380
+ minBalance: string;
381
+ };
382
+ } | {
383
+ type: "FARCASTER_FOLLOW";
384
+ config: {
385
+ fid: number;
386
+ };
387
+ }>;
388
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<GateCreateResponses, GateCreateErrors, ThrowOnError, "fields">;
389
+ /**
390
+ * Delete gate
391
+ *
392
+ * Delete a gate and all its conditions.
393
+ */
394
+ remove<ThrowOnError extends boolean = false>(parameters: {
395
+ gateId: string;
396
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<GateRemoveResponses, GateRemoveErrors, ThrowOnError, "fields">;
397
+ /**
398
+ * Get gate
399
+ *
400
+ * Get a gate by its ID.
401
+ */
402
+ get<ThrowOnError extends boolean = false>(parameters: {
403
+ gateId: string;
404
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<GateGetResponses, GateGetErrors, ThrowOnError, "fields">;
405
+ /**
406
+ * Update gate
407
+ *
408
+ * Update a gate's name, match mode, or conditions.
409
+ */
410
+ update<ThrowOnError extends boolean = false>(parameters: {
411
+ gateId: string;
412
+ name?: string;
413
+ matchMode?: GateMatchMode;
414
+ conditions?: Array<{
415
+ type: "ALLOWLIST";
416
+ config: {
417
+ addresses: Array<string>;
418
+ };
419
+ } | {
420
+ type: "TOKEN_OWNERSHIP";
421
+ config: {
422
+ contractAddress: string;
423
+ chainId: number;
424
+ minAmount?: number;
425
+ };
426
+ } | {
427
+ type: "SPECIFIC_TOKEN";
428
+ config: {
429
+ contractAddress: string;
430
+ chainId: number;
431
+ tokenId: string;
432
+ };
433
+ } | {
434
+ type: "TOKEN_ATTRIBUTE";
435
+ config: {
436
+ contractAddress: string;
437
+ chainId: number;
438
+ traitType: string;
439
+ traitValue: string;
440
+ };
441
+ } | {
442
+ type: "CURRENCY_BALANCE";
443
+ config: {
444
+ chainId: number;
445
+ contractAddress?: string;
446
+ minBalance: string;
447
+ };
448
+ } | {
449
+ type: "FARCASTER_FOLLOW";
450
+ config: {
451
+ fid: number;
452
+ };
453
+ }>;
454
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<GateUpdateResponses, GateUpdateErrors, ThrowOnError, "fields">;
455
+ }
456
+ export declare class Mechanic extends HeyApiClient {
457
+ /**
458
+ * List mechanics
459
+ *
460
+ * List all registered mechanics. Optionally filter by built-in status.
461
+ */
462
+ list<ThrowOnError extends boolean = false>(parameters?: {
463
+ builtIn?: boolean | string;
464
+ type?: "SEED_BASED_MINT" | "DISCRETE_DUTCH_AUCTION" | "RANKED_AUCTION" | "GASLESS" | "CUSTOM";
465
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MechanicListResponses, unknown, ThrowOnError, "fields">;
466
+ /**
467
+ * Create mechanic
468
+ *
469
+ * Register a new custom mechanic contract.
470
+ */
471
+ create<ThrowOnError extends boolean = false>(parameters: {
472
+ slug: string;
473
+ name: string;
474
+ description?: string | null;
475
+ configSchema?: unknown | null;
476
+ encodingAbi?: unknown | null;
477
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MechanicCreateResponses, MechanicCreateErrors, ThrowOnError, "fields">;
478
+ /**
479
+ * Get mechanic
480
+ *
481
+ * Get a mechanic by its ID.
482
+ */
483
+ get<ThrowOnError extends boolean = false>(parameters: {
484
+ mechanicId: string;
485
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MechanicGetResponses, MechanicGetErrors, ThrowOnError, "fields">;
486
+ /**
487
+ * Update mechanic
488
+ *
489
+ * Update a custom mechanic. Built-in mechanics cannot be modified.
490
+ */
491
+ update<ThrowOnError extends boolean = false>(parameters: {
492
+ mechanicId: string;
493
+ name?: string;
494
+ description?: string | null;
495
+ configSchema?: unknown | null;
496
+ encodingAbi?: unknown | null;
497
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MechanicUpdateResponses, MechanicUpdateErrors, ThrowOnError, "fields">;
498
+ /**
499
+ * Remove mechanic deployment
500
+ *
501
+ * Remove a mechanic contract deployment from a specific chain.
502
+ */
503
+ removeDeployment<ThrowOnError extends boolean = false>(parameters: {
504
+ mechanicId: string;
505
+ chainId: number;
506
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MechanicRemoveDeploymentResponses, MechanicRemoveDeploymentErrors, ThrowOnError, "fields">;
507
+ /**
508
+ * Add mechanic deployment
509
+ *
510
+ * Register a mechanic contract deployment on a specific chain. Upserts if a deployment already exists for the chain.
511
+ */
512
+ addDeployment<ThrowOnError extends boolean = false>(parameters: {
513
+ mechanicId: string;
514
+ chainId: number;
515
+ address: string;
516
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MechanicAddDeploymentResponses, MechanicAddDeploymentErrors, ThrowOnError, "fields">;
517
+ }
518
+ export declare class Media extends HeyApiClient {
519
+ /**
520
+ * Create media upload session
521
+ *
522
+ * Create a media asset and return the worker upload URL the client should PUT bytes to. Call /:mediaId/process once the PUT completes.
523
+ */
524
+ createUploadSession<ThrowOnError extends boolean = false>(parameters: {
525
+ kind: MediaKind;
526
+ scope?: MediaScope;
527
+ fileName: string;
528
+ mimeType: string;
529
+ fileSize: number;
530
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MediaCreateUploadSessionResponses, MediaCreateUploadSessionErrors, ThrowOnError, "fields">;
531
+ /**
532
+ * Upload media bytes
533
+ *
534
+ * Stream the file body to the worker, which writes it to storage and immediately drives the asset through processing. File assets come back Ready; Directory assets come back Processing (zip extraction running). Call /:mediaId/process to retry a Failed Directory.
535
+ */
536
+ upload<ThrowOnError extends boolean = false>(parameters: {
537
+ mediaId: string;
538
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MediaUploadResponses, MediaUploadErrors, ThrowOnError, "fields">;
539
+ /**
540
+ * Process a media asset
541
+ *
542
+ * Drive the media asset toward Ready. Call after PUTting bytes to /:mediaId/upload to finalize the upload (File assets become Ready; Directory assets trigger zip extraction). Idempotent — assets that are already Ready or currently Processing are returned as-is. Failed Directory assets re-trigger extraction.
543
+ */
544
+ process<ThrowOnError extends boolean = false>(parameters: {
545
+ mediaId: string;
546
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MediaProcessResponses, MediaProcessErrors, ThrowOnError, "fields">;
547
+ /**
548
+ * List children of a Directory media asset
549
+ *
550
+ * Returns a paginated list of File children (e.g. per-token metadata or extracted archive files).
551
+ */
552
+ listChildren<ThrowOnError extends boolean = false>(parameters: {
553
+ mediaId: string;
554
+ cursor?: string;
555
+ limit?: number;
556
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MediaListChildrenResponses, MediaListChildrenErrors, ThrowOnError, "fields">;
557
+ /**
558
+ * Delete a media asset
559
+ *
560
+ * Delete the media asset and its R2 objects. Arweave archive locations remain on-chain (immutable) but are no longer referenced. Fails with 409 if still referenced by a collection contract or generative collection code.
561
+ */
562
+ delete<ThrowOnError extends boolean = false>(parameters: {
563
+ mediaId: string;
564
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MediaDeleteResponses, MediaDeleteErrors, ThrowOnError, "fields">;
565
+ /**
566
+ * Get media asset
567
+ *
568
+ * Get media asset details including kind, locations, and status.
569
+ */
570
+ get<ThrowOnError extends boolean = false>(parameters: {
571
+ mediaId: string;
572
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MediaGetResponses, MediaGetErrors, ThrowOnError, "fields">;
573
+ /**
574
+ * Publish media to archive
575
+ *
576
+ * Mirror the media asset to its immutable archive provider (Arweave). File media publishes the single blob; Directory media publishes a manifest of all children. Idempotent — returns early if already archived.
577
+ */
578
+ publish<ThrowOnError extends boolean = false>(parameters: {
579
+ mediaId: string;
580
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MediaPublishResponses, MediaPublishErrors, ThrowOnError, "fields">;
581
+ /**
582
+ * Get a child File Entity by path
583
+ *
584
+ * Returns the child File's full Entity (with locations and status). Use `entity.url` to fetch bytes directly from the storage provider.
585
+ */
586
+ getChild<ThrowOnError extends boolean = false>(parameters: {
587
+ mediaId: string;
588
+ path: string;
589
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MediaGetChildResponses, MediaGetChildErrors, ThrowOnError, "fields">;
590
+ }
591
+ export declare class Siwe extends HeyApiClient {
592
+ /**
593
+ * Issue a SIWE nonce
594
+ *
595
+ * Issues a single-use, short-lived nonce for use as the `nonce` field of a SIWE (EIP-4361) message.
596
+ */
597
+ nonce<ThrowOnError extends boolean = false>(options?: Options<never, ThrowOnError>): import("./client").RequestResult<UserSiweNonceResponses, UserSiweNonceErrors, ThrowOnError, "fields">;
598
+ }
599
+ export declare class User extends HeyApiClient {
600
+ /**
601
+ * Sign in user
602
+ *
603
+ * Sign in with a provider credential (Privy id_token or SIWE message + signature) and receive access/refresh tokens plus user.
604
+ */
605
+ signin<ThrowOnError extends boolean = false>(parameters: {
606
+ body: {
607
+ providerType: "Privy";
608
+ token: string;
609
+ } | {
610
+ providerType: "Siwe";
611
+ message: string;
612
+ signature: string;
613
+ };
614
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<UserSigninResponses, UserSigninErrors, ThrowOnError, "fields">;
615
+ private _siwe?;
616
+ get siwe(): Siwe;
617
+ }
618
+ export declare class ApiKey extends HeyApiClient {
619
+ /**
620
+ * List API keys
621
+ *
622
+ * List all API keys for the authenticated account.
623
+ */
624
+ list<ThrowOnError extends boolean = false>(options?: Options<never, ThrowOnError>): import("./client").RequestResult<ApiKeyListResponses, ApiKeyListErrors, ThrowOnError, "fields">;
625
+ /**
626
+ * Create API key
627
+ *
628
+ * Create a new API key. The plaintext key is returned only once in this response.
629
+ */
630
+ create<ThrowOnError extends boolean = false>(parameters: {
631
+ name: string;
632
+ expiresAt?: string;
633
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<ApiKeyCreateResponses, ApiKeyCreateErrors, ThrowOnError, "fields">;
634
+ /**
635
+ * Revoke API key
636
+ *
637
+ * Revoke an API key. Revoked keys can no longer authenticate requests.
638
+ */
639
+ revoke<ThrowOnError extends boolean = false>(parameters: {
640
+ apiKeyId: string;
641
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<ApiKeyRevokeResponses, ApiKeyRevokeErrors, ThrowOnError, "fields">;
642
+ }
643
+ export declare class Health extends HeyApiClient {
644
+ /**
645
+ * Health check
646
+ *
647
+ * Check if the service is healthy.
648
+ */
649
+ get<ThrowOnError extends boolean = false>(options?: Options<never, ThrowOnError>): import("./client").RequestResult<HealthGetResponses, unknown, ThrowOnError, "fields">;
650
+ }
651
+ export declare class HighlightClient extends HeyApiClient {
652
+ static readonly __registry: HeyApiRegistry<HighlightClient>;
653
+ constructor(args?: {
654
+ client?: Client;
655
+ key?: string;
656
+ });
657
+ postIndexerChainsByChainIdActivate<ThrowOnError extends boolean = false>(parameters: {
658
+ chainId: number;
659
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<PostIndexerChainsByChainIdActivateResponses, unknown, ThrowOnError, "fields">;
660
+ postIndexerChainsByChainIdReset<ThrowOnError extends boolean = false>(parameters: {
661
+ chainId: number;
662
+ blockNumber: number;
663
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<PostIndexerChainsByChainIdResetResponses, unknown, ThrowOnError, "fields">;
664
+ postIndexerChainsByChainIdPoll<ThrowOnError extends boolean = false>(parameters: {
665
+ chainId: number;
666
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<PostIndexerChainsByChainIdPollResponses, unknown, ThrowOnError, "fields">;
667
+ private _collection?;
668
+ get collection(): Collection;
669
+ private _token?;
670
+ get token(): Token;
671
+ private _config?;
672
+ get config(): Config;
673
+ private _contract?;
674
+ get contract(): Contract;
675
+ private _gate?;
676
+ get gate(): Gate;
677
+ private _mechanic?;
678
+ get mechanic(): Mechanic;
679
+ private _media?;
680
+ get media(): Media;
681
+ private _user?;
682
+ get user(): User;
683
+ private _apiKey?;
684
+ get apiKey(): ApiKey;
685
+ private _health?;
686
+ get health(): Health;
687
+ }
688
+ export {};
689
+ //# sourceMappingURL=sdk.gen.d.ts.map