@receiz/sdk 97.0.0 → 97.2.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.
package/dist/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { buildReceizIdContinueRequest, createReceizIdIdentity, projectReceizIdentityAccount, readReceizIdentityArtifact, signReceizIdentityLoginProof, verifyReceizIdentityLoginProof, type ReceizDeviceIdentity, type ReceizIdContinueOptions } from "./identity.js";
2
2
  export * from "./identity.js";
3
- export declare const RECEIZ_SDK_VERSION = "97.0.0";
3
+ export declare const RECEIZ_SDK_VERSION = "97.2.0";
4
4
  export declare const RECEIZ_DEFAULT_BASE_URL = "https://receiz.com";
5
5
  export declare const RECEIZ_WEBHOOK_SIGNATURE_HEADER = "x-receiz-signature";
6
6
  export declare const RECEIZ_WEBHOOK_TIMESTAMP_HEADER = "x-receiz-timestamp";
@@ -95,7 +95,7 @@ export type DocumentSealResponseMetadata = {
95
95
  proofBundle?: ReceizProofBundle | null;
96
96
  [key: string]: unknown;
97
97
  };
98
- export type PublicProofRecord = {
98
+ export type PublicProofRecord<TData extends JsonObject = JsonObject> = {
99
99
  ok?: boolean;
100
100
  id?: string;
101
101
  sourceUrl?: string;
@@ -106,7 +106,7 @@ export type PublicProofRecord = {
106
106
  appObjectId?: string | null;
107
107
  createdAt?: string;
108
108
  record?: JsonObject | null;
109
- data?: JsonObject | null;
109
+ data?: TData | null;
110
110
  proof?: JsonObject | null;
111
111
  [key: string]: unknown;
112
112
  };
@@ -122,14 +122,14 @@ export type PublicProofRegistryFeed = {
122
122
  signature?: string;
123
123
  [key: string]: unknown;
124
124
  };
125
- export type ReceizPublicProjectionRecord = PublicProofRecord & {
125
+ export type ReceizPublicProjectionRecord<TData extends JsonObject = JsonObject> = PublicProofRecord<TData> & {
126
126
  schema?: string | null;
127
127
  state?: string | null;
128
128
  platform?: string | null;
129
129
  appNamespace?: string | null;
130
130
  appObjectId?: string | null;
131
131
  record?: JsonObject | null;
132
- data?: JsonObject | null;
132
+ data?: TData | null;
133
133
  };
134
134
  export type ReceizAppStateRecord = {
135
135
  id: string;
@@ -170,24 +170,319 @@ export type ReceizAppStatePublishRecordOptions = {
170
170
  externalCreatorId?: string;
171
171
  signature?: string;
172
172
  };
173
- export type ReceizAppStateFeedResponse = {
173
+ export type ReceizAppStateFeedOptions = {
174
+ schema?: string;
175
+ namespace?: string;
176
+ externalCreatorId?: string;
177
+ };
178
+ export type ReceizPublicStoreStateRecordInput = {
179
+ id?: string;
180
+ sourceUrl: string;
181
+ externalCreatorId?: string;
182
+ title?: string;
183
+ namespace?: string;
184
+ state?: string;
185
+ schema?: string;
186
+ platform?: string;
187
+ record?: JsonObject | null;
188
+ data: JsonObject;
189
+ [key: string]: unknown;
190
+ };
191
+ export type ReceizAppStateFeedResponse<TData extends JsonObject = JsonObject> = {
174
192
  ok: boolean;
175
193
  accepted?: number;
176
194
  rejected?: number;
177
- records?: ReceizPublicProjectionRecord[];
195
+ records?: ReceizPublicProjectionRecord<TData>[];
178
196
  error?: string;
179
197
  [key: string]: unknown;
180
198
  };
181
- export type ReceizAppStateRecordResponse = {
199
+ export type ReceizAppStateRecordResponse<TData extends JsonObject = JsonObject> = {
200
+ ok: boolean;
201
+ record: ReceizPublicProjectionRecord<TData> | null;
202
+ [key: string]: unknown;
203
+ };
204
+ export type ReceizAppStateCollectionResponse<TData extends JsonObject = JsonObject> = {
205
+ ok: boolean;
206
+ records: ReceizPublicProjectionRecord<TData>[];
207
+ [key: string]: unknown;
208
+ };
209
+ export type ReceizAppStateRestoreOptions = {
210
+ schema?: string;
211
+ state?: string;
212
+ requiredDataKey?: string;
213
+ };
214
+ export type ReceizAppStateRestoreResult<TData extends JsonObject = JsonObject> = {
215
+ ok: boolean;
216
+ record: ReceizPublicProjectionRecord<TData> | null;
217
+ data: TData | null;
218
+ error?: string;
219
+ };
220
+ export type ReceizAppStateTenantPublishInput = {
221
+ tenantHost: string;
222
+ creatorReceizId?: string;
223
+ externalCreatorId?: string;
224
+ title?: string;
225
+ schema?: string;
226
+ schemaVersion?: number;
227
+ platform?: string;
228
+ state: JsonObject;
229
+ record?: JsonObject | null;
230
+ data?: JsonObject;
231
+ sourceUrl?: string;
232
+ id?: string;
233
+ namespace?: string;
234
+ projectionState?: string;
235
+ visibility?: "public" | "private";
236
+ idempotencyKey?: string;
237
+ [key: string]: unknown;
238
+ };
239
+ export type ReceizAppStatePublishInput = ReceizAppStateFeed | ReceizAppStateTenantPublishInput;
240
+ export type ReceizAppStateResolveInput = ReceizAppStateRestoreOptions & {
241
+ url?: string;
242
+ host?: string;
243
+ tenantHost?: string;
244
+ id?: string;
245
+ namespace?: string;
246
+ creatorReceizId?: string;
247
+ receizId?: string;
248
+ migrateTo?: number;
249
+ };
250
+ export type ReceizAppStateResolveResult<TData extends JsonObject = JsonObject> = ReceizAppStateRestoreResult<TData> & {
251
+ records?: ReceizPublicProjectionRecord<TData>[];
252
+ };
253
+ export type ReceizCapabilityKey = "identity" | "wallet" | "payments" | "proofStore" | "media" | "domains" | "twin" | "commerce" | "rewards" | "events" | "search" | "permissions" | "jobs" | "audit" | "risk" | "compliance" | "portability" | "notifications" | "offline" | "releases";
254
+ export type ReceizCapabilityStatus = "available" | "missing" | "unknown";
255
+ export type ReceizCapability = {
256
+ available: boolean;
257
+ status: ReceizCapabilityStatus;
258
+ reason?: string;
259
+ fixUrl?: string;
260
+ [key: string]: unknown;
261
+ };
262
+ export type ReceizCapabilities = {
263
+ ok: true;
264
+ schema: "receiz.sdk.capabilities.v1";
265
+ baseUrl: string;
266
+ tenantHost?: string;
267
+ scopes: string[];
268
+ capabilities: Record<ReceizCapabilityKey, ReceizCapability>;
269
+ };
270
+ export type ReceizCapabilitiesOptions = {
271
+ tenantHost?: string;
272
+ callbackUrl?: string;
273
+ scopes?: string[];
274
+ };
275
+ export type ReceizDoctorIssue = {
276
+ code: string;
277
+ message: string;
278
+ fixUrl?: string;
279
+ };
280
+ export type ReceizDoctorReport = {
182
281
  ok: boolean;
183
- record: ReceizPublicProjectionRecord | null;
282
+ schema: "receiz.sdk.doctor.v1";
283
+ baseUrl: string;
284
+ tenantHost?: string;
285
+ capabilities: ReceizCapabilities["capabilities"];
286
+ missing: ReceizDoctorIssue[];
287
+ warnings: ReceizDoctorIssue[];
288
+ fixes: ReceizDoctorIssue[];
289
+ };
290
+ export type ReceizCommerceCartItem = {
291
+ id: string;
292
+ title?: string;
293
+ quantity: number;
294
+ amountUsd?: string;
295
+ amountUsdCents?: string;
296
+ [key: string]: unknown;
297
+ };
298
+ export type ReceizCommerceCart = {
299
+ items: ReceizCommerceCartItem[];
300
+ [key: string]: unknown;
301
+ };
302
+ export type ReceizOneClickCheckoutRequest = {
303
+ tenantHost: string;
304
+ orderId?: string;
305
+ amountUsd: string;
306
+ currency?: "usd";
307
+ walletFirst?: boolean;
308
+ cardFallback?: boolean;
309
+ customerReceizId?: string;
310
+ customerEmail?: string;
311
+ cart?: ReceizCommerceCart;
312
+ successUrl?: string;
313
+ cancelUrl?: string;
314
+ idempotencyKey?: string;
184
315
  [key: string]: unknown;
185
316
  };
186
- export type ReceizAppStateCollectionResponse = {
317
+ export type ReceizOneClickCheckoutResponse = {
187
318
  ok: boolean;
188
- records: ReceizPublicProjectionRecord[];
319
+ tenantHost: string;
320
+ orderId?: string;
321
+ funding: {
322
+ totalUsdCents: string;
323
+ walletAppliedUsdCents: string;
324
+ cardDeltaUsdCents: string;
325
+ walletFirst: boolean;
326
+ cardFallback: boolean;
327
+ };
328
+ wallet?: ConnectWalletResponse | null;
329
+ checkoutSession?: CheckoutSessionResponse | null;
330
+ proofObject?: JsonObject | null;
331
+ events: JsonObject[];
332
+ error?: string;
333
+ [key: string]: unknown;
334
+ };
335
+ export type ReceizMediaUploadOptions = {
336
+ tenantHost?: string;
337
+ purpose?: string;
338
+ filename?: string;
339
+ idempotencyKey?: string;
340
+ metadata?: JsonObject;
341
+ };
342
+ export type ReceizMediaUploadResponse = {
343
+ ok: boolean;
344
+ media?: JsonObject | null;
345
+ proof?: JsonObject | null;
346
+ error?: string;
347
+ [key: string]: unknown;
348
+ };
349
+ export type ReceizEventSubscribeRequest = {
350
+ tenantHost?: string;
351
+ types: string[];
352
+ webhookUrl?: string;
353
+ idempotencyKey?: string;
354
+ replayFrom?: string;
355
+ [key: string]: unknown;
356
+ };
357
+ export type ReceizProofQuery = {
358
+ namespace?: string;
359
+ tenantHost?: string;
360
+ type?: string;
361
+ customerReceizId?: string;
362
+ cursor?: string;
363
+ limit?: number;
364
+ [key: string]: unknown;
365
+ };
366
+ export type ReceizJobRequest = {
367
+ tenantHost?: string;
368
+ kind: string;
369
+ payload: JsonObject;
370
+ runAfter?: string;
371
+ idempotencyKey?: string;
189
372
  [key: string]: unknown;
190
373
  };
374
+ export type ReceizIdempotencyOptions = {
375
+ idempotencyKey?: string;
376
+ };
377
+ export type ReceizTenantRuntimeRequest = JsonObject & {
378
+ tenantHost?: string;
379
+ idempotencyKey?: string;
380
+ };
381
+ export type ReceizCustomerSessionRequest = ReceizTenantRuntimeRequest & {
382
+ tenantHost: string;
383
+ customerReceizId?: string;
384
+ scopes?: string[];
385
+ };
386
+ export type ReceizMerchantOnboardRequest = ReceizTenantRuntimeRequest & {
387
+ tenantHost: string;
388
+ receizId?: string;
389
+ displayName?: string;
390
+ defaultStore?: JsonObject;
391
+ };
392
+ export type ReceizCommerceRuntimeRequest = ReceizTenantRuntimeRequest & {
393
+ tenantHost: string;
394
+ };
395
+ export type ReceizPermissionRole = "owner" | "admin" | "staff" | "fulfillment" | "support" | "customer" | string;
396
+ export type ReceizPermissionGrantRequest = ReceizTenantRuntimeRequest & {
397
+ tenantHost: string;
398
+ actorReceizId: string;
399
+ role: ReceizPermissionRole;
400
+ };
401
+ export type ReceizPermissionCheckRequest = ReceizTenantRuntimeRequest & {
402
+ tenantHost: string;
403
+ actorReceizId: string;
404
+ permission: string;
405
+ };
406
+ export type ReceizAuditAppendRequest = ReceizTenantRuntimeRequest & {
407
+ tenantHost: string;
408
+ action: string;
409
+ actorReceizId?: string;
410
+ };
411
+ export type ReceizSearchRequest = ReceizTenantRuntimeRequest & {
412
+ tenantHost?: string;
413
+ query?: string;
414
+ cursor?: string;
415
+ limit?: number;
416
+ };
417
+ export type ReceizMediaTransformRequest = ReceizTenantRuntimeRequest & {
418
+ tenantHost?: string;
419
+ mediaId: string;
420
+ resize?: JsonObject;
421
+ optimize?: JsonObject;
422
+ blurPlaceholder?: boolean;
423
+ altText?: string;
424
+ metadata?: JsonObject;
425
+ };
426
+ export type ReceizReleasePinRequest = ReceizTenantRuntimeRequest & {
427
+ tenantHost: string;
428
+ rails: Record<string, string>;
429
+ };
430
+ export type ReceizOfflineProofQueueItem = {
431
+ id: string;
432
+ kind: "app_state.publish" | "connect.record" | "webhook.event" | string;
433
+ payload: JsonObject;
434
+ idempotencyKey?: string;
435
+ createdAt?: string;
436
+ attempts?: number;
437
+ lastError?: JsonObject | null;
438
+ };
439
+ export type ReceizOfflineProofQueueSnapshot = {
440
+ schema: "receiz.sdk.offline_proof_queue.v1";
441
+ ownerId?: string | null;
442
+ createdAt: string;
443
+ updatedAt: string;
444
+ pending: ReceizOfflineProofQueueItem[];
445
+ settled: ReceizOfflineProofQueueItem[];
446
+ failed: ReceizOfflineProofQueueItem[];
447
+ };
448
+ export type ReceizOfflineProofQueueStorageValue = string | ReceizOfflineProofQueueSnapshot | null | undefined;
449
+ export type ReceizOfflineProofQueueStorage = {
450
+ read(): ReceizOfflineProofQueueStorageValue | Promise<ReceizOfflineProofQueueStorageValue>;
451
+ write(snapshot: ReceizOfflineProofQueueSnapshot): void | Promise<void>;
452
+ remove?(): void | Promise<void>;
453
+ };
454
+ export type ReceizOfflineProofQueueOptions = {
455
+ ownerId?: string | null;
456
+ storage?: ReceizOfflineProofQueueStorage;
457
+ snapshot?: ReceizOfflineProofQueueSnapshot;
458
+ };
459
+ export type ReceizInMemoryOfflineProofQueueStorage = ReceizOfflineProofQueueStorage & {
460
+ readText(): string | null;
461
+ };
462
+ export type ReceizSandboxStoreOptions = {
463
+ tenantHost: string;
464
+ products?: number;
465
+ seed?: string;
466
+ };
467
+ export type ReceizSandboxStore = {
468
+ ok: true;
469
+ schema: "receiz.sdk.sandbox.store.v1";
470
+ tenantHost: string;
471
+ state: {
472
+ brand: string;
473
+ products: JsonObject[];
474
+ rewards: JsonObject[];
475
+ };
476
+ };
477
+ export type ReceizSandboxCheckoutOptions = {
478
+ amountUsd: string;
479
+ outcome?: "success" | "failure";
480
+ };
481
+ export type ReceizWebhookVerifyRequestOptions = {
482
+ secret: string;
483
+ toleranceSeconds?: number;
484
+ nowMs?: number;
485
+ };
191
486
  export type WalletLedgerEvent = {
192
487
  id: string;
193
488
  kind: "transfer" | "note_mint" | "note_claim" | string;
@@ -986,10 +1281,19 @@ export declare function receizAppStateUrlFromHost(hostOrUrl: string): string;
986
1281
  export declare function receizAppStateNamespaceFromUrl(sourceUrl: string): string;
987
1282
  export declare function receizAppStateObjectIdFromUrl(sourceUrl: string, prefix?: string): string;
988
1283
  export declare function createReceizAppStateRecord(input: ReceizAppStateRecordInput): ReceizAppStateRecord;
1284
+ export declare function createReceizAppStateFeed(records: Array<ReceizAppStateRecord | ReceizAppStateRecordInput>, options?: ReceizAppStateFeedOptions): ReceizAppStateFeed;
1285
+ export declare function createReceizPublicStoreStateRecord(input: ReceizPublicStoreStateRecordInput): ReceizAppStateRecord;
1286
+ export declare function createReceizTenantAppStateRecord(input: ReceizAppStateTenantPublishInput): ReceizAppStateRecord;
1287
+ export declare function normalizeReceizHost(hostOrUrl: string): string;
1288
+ export declare function verifyReceizWebhookRequest(request: Request, options: ReceizWebhookVerifyRequestOptions): Promise<boolean>;
1289
+ export declare function extractReceizAppStateData<TData extends JsonObject = JsonObject>(input: ReceizAppStateRecordResponse<TData> | ReceizPublicProjectionRecord<TData> | null | undefined, options?: ReceizAppStateRestoreOptions): TData | null;
1290
+ export declare function restoreReceizAppStateProjection<TData extends JsonObject = JsonObject>(input: ReceizAppStateRecordResponse<TData> | ReceizPublicProjectionRecord<TData> | null | undefined, options?: ReceizAppStateRestoreOptions): ReceizAppStateRestoreResult<TData>;
989
1291
  export declare class ReceizClient {
990
1292
  readonly baseUrl: string;
991
1293
  private readonly accessToken;
992
1294
  private readonly fetchImpl;
1295
+ readonly doctor: (options?: ReceizCapabilitiesOptions) => Promise<ReceizDoctorReport>;
1296
+ readonly capabilities: (options?: ReceizCapabilitiesOptions) => Promise<ReceizCapabilities>;
993
1297
  readonly verification: {
994
1298
  verifyArtifact: (file: Blob) => Promise<DocumentVerifyResponse>;
995
1299
  sealArtifact: (file: Blob, options?: {
@@ -998,27 +1302,41 @@ export declare class ReceizClient {
998
1302
  conformance: () => Promise<JsonObject>;
999
1303
  };
1000
1304
  readonly publicProof: {
1001
- observe: (body: PublicProofObserveRequest) => Promise<PublicProofRecord>;
1002
- byUrl: (url: string) => Promise<PublicProofRecord>;
1003
- byId: (id: string) => Promise<PublicProofRecord>;
1305
+ observe: (body: PublicProofObserveRequest) => Promise<PublicProofRecord<JsonObject>>;
1306
+ byUrl: (url: string) => Promise<PublicProofRecord<JsonObject>>;
1307
+ byId: (id: string) => Promise<PublicProofRecord<JsonObject>>;
1004
1308
  byCreator: (externalCreatorId: string) => Promise<{
1005
1309
  ok: boolean;
1006
1310
  records: PublicProofRecord[];
1007
1311
  }>;
1008
1312
  registryFeed: (feed: PublicProofRegistryFeed, options?: {
1009
1313
  signature?: string;
1010
- }) => Promise<ReceizAppStateFeedResponse>;
1314
+ }) => Promise<ReceizAppStateFeedResponse<JsonObject>>;
1011
1315
  };
1012
1316
  readonly appState: {
1013
- publish: (feed: ReceizAppStateFeed, options?: {
1317
+ publish: (input: ReceizAppStatePublishInput, options?: {
1014
1318
  signature?: string;
1015
- }) => Promise<ReceizAppStateFeedResponse>;
1016
- publishRecord: (record: ReceizAppStateRecord | ReceizAppStateRecordInput, options?: ReceizAppStatePublishRecordOptions) => Promise<ReceizAppStateFeedResponse>;
1017
- byUrl: (url: string) => Promise<ReceizAppStateRecordResponse>;
1018
- byHost: (host: string) => Promise<ReceizAppStateRecordResponse>;
1019
- byCreator: (receizId: string) => Promise<ReceizAppStateCollectionResponse>;
1020
- byNamespace: (namespace: string) => Promise<ReceizAppStateCollectionResponse>;
1021
- byId: (id: string) => Promise<ReceizAppStateRecordResponse>;
1319
+ idempotencyKey?: string;
1320
+ }) => Promise<ReceizAppStateFeedResponse<JsonObject>>;
1321
+ publishRecord: (record: ReceizAppStateRecord | ReceizAppStateRecordInput, options?: ReceizAppStatePublishRecordOptions) => Promise<ReceizAppStateFeedResponse<JsonObject>>;
1322
+ resolve: <TData extends JsonObject = JsonObject>(input: ReceizAppStateResolveInput) => Promise<ReceizAppStateResolveResult<TData>>;
1323
+ byUrl: (url: string) => Promise<ReceizAppStateRecordResponse<JsonObject>>;
1324
+ byHost: (host: string) => Promise<ReceizAppStateRecordResponse<JsonObject>>;
1325
+ byCreator: (receizId: string) => Promise<ReceizAppStateCollectionResponse<JsonObject>>;
1326
+ byNamespace: (namespace: string) => Promise<ReceizAppStateCollectionResponse<JsonObject>>;
1327
+ byId: (id: string) => Promise<ReceizAppStateRecordResponse<JsonObject>>;
1328
+ restoreByUrl: <TData extends JsonObject = JsonObject>(url: string, options?: ReceizAppStateRestoreOptions) => Promise<ReceizAppStateRestoreResult<TData>>;
1329
+ restoreByHost: <TData extends JsonObject = JsonObject>(host: string, options?: ReceizAppStateRestoreOptions) => Promise<ReceizAppStateRestoreResult<TData>>;
1330
+ restoreById: <TData extends JsonObject = JsonObject>(id: string, options?: ReceizAppStateRestoreOptions) => Promise<ReceizAppStateRestoreResult<TData>>;
1331
+ createRecord: typeof createReceizAppStateRecord;
1332
+ createTenantRecord: typeof createReceizTenantAppStateRecord;
1333
+ createFeed: typeof createReceizAppStateFeed;
1334
+ createPublicStoreRecord: typeof createReceizPublicStoreStateRecord;
1335
+ urlFromHost: typeof receizAppStateUrlFromHost;
1336
+ namespaceFromUrl: typeof receizAppStateNamespaceFromUrl;
1337
+ objectIdFromUrl: typeof receizAppStateObjectIdFromUrl;
1338
+ extractData: typeof extractReceizAppStateData;
1339
+ restoreProjection: typeof restoreReceizAppStateProjection;
1022
1340
  };
1023
1341
  readonly sports: {
1024
1342
  conformance: () => Promise<JsonObject>;
@@ -1105,12 +1423,167 @@ export declare class ReceizClient {
1105
1423
  bootstrap: (username: string) => Promise<JsonObject>;
1106
1424
  authorizeUrl: (options: ReceizAuthorizeUrlOptions) => string;
1107
1425
  };
1426
+ readonly customers: {
1427
+ session: (body: ReceizCustomerSessionRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1428
+ portal: (body: ReceizTenantRuntimeRequest) => Promise<JsonObject>;
1429
+ orders: (query?: ReceizSearchRequest) => Promise<JsonObject>;
1430
+ rewards: (query?: ReceizSearchRequest) => Promise<JsonObject>;
1431
+ assets: (query?: ReceizSearchRequest) => Promise<JsonObject>;
1432
+ };
1433
+ readonly merchants: {
1434
+ onboard: (body: ReceizMerchantOnboardRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1435
+ profile: (query?: {
1436
+ tenantHost?: string;
1437
+ }) => Promise<JsonObject>;
1438
+ capabilities: (query?: {
1439
+ tenantHost?: string;
1440
+ }) => Promise<JsonObject>;
1441
+ };
1442
+ readonly commerce: {
1443
+ oneClickCheckout: (body: ReceizOneClickCheckoutRequest) => Promise<ReceizOneClickCheckoutResponse>;
1444
+ refunds: {
1445
+ create: (body: ReceizCommerceRuntimeRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1446
+ };
1447
+ subscriptions: {
1448
+ create: (body: ReceizCommerceRuntimeRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1449
+ cancel: (subscriptionId: string, body: ReceizCommerceRuntimeRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1450
+ };
1451
+ shipping: {
1452
+ quote: (body: ReceizCommerceRuntimeRequest) => Promise<JsonObject>;
1453
+ update: (body: ReceizCommerceRuntimeRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1454
+ };
1455
+ tax: {
1456
+ quote: (body: ReceizCommerceRuntimeRequest) => Promise<JsonObject>;
1457
+ };
1458
+ discounts: {
1459
+ create: (body: ReceizCommerceRuntimeRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1460
+ redeem: (body: ReceizCommerceRuntimeRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1461
+ };
1462
+ giftCards: {
1463
+ issue: (body: ReceizCommerceRuntimeRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1464
+ redeem: (body: ReceizCommerceRuntimeRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1465
+ };
1466
+ accessPasses: {
1467
+ issue: (body: ReceizCommerceRuntimeRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1468
+ verify: (body: ReceizCommerceRuntimeRequest) => Promise<JsonObject>;
1469
+ };
1470
+ inventory: {
1471
+ reserve: (body: ReceizCommerceRuntimeRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1472
+ adjust: (body: ReceizCommerceRuntimeRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1473
+ };
1474
+ fulfillment: {
1475
+ update: (body: ReceizCommerceRuntimeRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1476
+ };
1477
+ payouts: {
1478
+ create: (body: ReceizCommerceRuntimeRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1479
+ status: (query?: {
1480
+ tenantHost?: string;
1481
+ payoutId?: string;
1482
+ }) => Promise<JsonObject>;
1483
+ };
1484
+ };
1108
1485
  readonly payments: {
1109
1486
  embeddedCheckout: (body: CheckoutRequest) => Promise<CheckoutSessionResponse>;
1110
1487
  embeddedNoteClaim: (body: JsonObject) => Promise<JsonObject>;
1111
1488
  };
1489
+ readonly media: {
1490
+ upload: (file: Blob, options?: ReceizMediaUploadOptions) => Promise<ReceizMediaUploadResponse>;
1491
+ transform: (body: ReceizMediaTransformRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1492
+ objectUrl: (query: {
1493
+ bucket: string;
1494
+ path: string;
1495
+ }) => string;
1496
+ };
1497
+ readonly domains: {
1498
+ normalizeHost: typeof normalizeReceizHost;
1499
+ tenantUrl: typeof receizAppStateUrlFromHost;
1500
+ namespace: typeof receizAppStateNamespaceFromUrl;
1501
+ objectId: typeof receizAppStateObjectIdFromUrl;
1502
+ resolveTenant: <TData extends JsonObject = JsonObject>(host: string, options?: ReceizAppStateRestoreOptions) => Promise<ReceizAppStateRestoreResult<TData>>;
1503
+ reserveSubdomain: (body: JsonObject, options?: {
1504
+ idempotencyKey?: string;
1505
+ }) => Promise<JsonObject>;
1506
+ verifyCustomDomain: (body: JsonObject, options?: {
1507
+ idempotencyKey?: string;
1508
+ }) => Promise<JsonObject>;
1509
+ status: (query?: {
1510
+ host?: string;
1511
+ domain?: string;
1512
+ }) => Promise<JsonObject>;
1513
+ };
1514
+ readonly events: {
1515
+ subscribe: (body: ReceizEventSubscribeRequest) => Promise<JsonObject>;
1516
+ replay: (body: ReceizTenantRuntimeRequest) => Promise<JsonObject>;
1517
+ list: (query?: ReceizSearchRequest) => Promise<JsonObject>;
1518
+ ack: (eventId: string, body?: ReceizTenantRuntimeRequest) => Promise<JsonObject>;
1519
+ };
1520
+ readonly proof: {
1521
+ query: (query: ReceizProofQuery) => Promise<JsonObject>;
1522
+ };
1523
+ readonly jobs: {
1524
+ enqueue: (body: ReceizJobRequest) => Promise<JsonObject>;
1525
+ status: (jobId: string) => Promise<JsonObject>;
1526
+ cancel: (jobId: string, body?: ReceizTenantRuntimeRequest) => Promise<JsonObject>;
1527
+ list: (query?: ReceizSearchRequest) => Promise<JsonObject>;
1528
+ };
1529
+ readonly permissions: {
1530
+ grant: (body: ReceizPermissionGrantRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1531
+ revoke: (body: ReceizPermissionGrantRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1532
+ check: (body: ReceizPermissionCheckRequest) => Promise<JsonObject>;
1533
+ roles: (query?: {
1534
+ tenantHost?: string;
1535
+ }) => Promise<JsonObject>;
1536
+ };
1537
+ readonly audit: {
1538
+ append: (body: ReceizAuditAppendRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1539
+ query: (query?: ReceizSearchRequest) => Promise<JsonObject>;
1540
+ export: (query?: ReceizSearchRequest) => Promise<JsonObject>;
1541
+ };
1542
+ readonly risk: {
1543
+ scorePayment: (body: ReceizCommerceRuntimeRequest) => Promise<JsonObject>;
1544
+ scoreAccountRecovery: (body: ReceizTenantRuntimeRequest) => Promise<JsonObject>;
1545
+ velocity: (body: ReceizTenantRuntimeRequest) => Promise<JsonObject>;
1546
+ proofActivity: (body: ReceizTenantRuntimeRequest) => Promise<JsonObject>;
1547
+ };
1548
+ readonly compliance: {
1549
+ exportOrders: (query: ReceizSearchRequest) => Promise<JsonObject>;
1550
+ exportTaxes: (query: ReceizSearchRequest) => Promise<JsonObject>;
1551
+ exportPayouts: (query: ReceizSearchRequest) => Promise<JsonObject>;
1552
+ exportCustomers: (query: ReceizSearchRequest) => Promise<JsonObject>;
1553
+ exportAudit: (query: ReceizSearchRequest) => Promise<JsonObject>;
1554
+ };
1555
+ readonly portability: {
1556
+ exportStore: (query: {
1557
+ tenantHost: string;
1558
+ }) => Promise<JsonObject>;
1559
+ importStore: (body: ReceizTenantRuntimeRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1560
+ };
1561
+ readonly search: {
1562
+ query: (body: ReceizSearchRequest) => Promise<JsonObject>;
1563
+ products: (body: ReceizSearchRequest) => Promise<JsonObject>;
1564
+ pages: (body: ReceizSearchRequest) => Promise<JsonObject>;
1565
+ blog: (body: ReceizSearchRequest) => Promise<JsonObject>;
1566
+ orders: (body: ReceizSearchRequest) => Promise<JsonObject>;
1567
+ customers: (body: ReceizSearchRequest) => Promise<JsonObject>;
1568
+ proofObjects: (body: ReceizSearchRequest) => Promise<JsonObject>;
1569
+ };
1570
+ readonly notifications: {
1571
+ send: (body: ReceizTenantRuntimeRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1572
+ subscribe: (body: ReceizTenantRuntimeRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1573
+ templates: (query?: {
1574
+ tenantHost?: string;
1575
+ }) => Promise<JsonObject>;
1576
+ };
1577
+ readonly releases: {
1578
+ pin: (body: ReceizReleasePinRequest, options?: ReceizIdempotencyOptions) => Promise<JsonObject>;
1579
+ check: (query?: {
1580
+ tenantHost?: string;
1581
+ }) => Promise<JsonObject>;
1582
+ supported: () => Promise<JsonObject>;
1583
+ };
1112
1584
  readonly webhooks: {
1113
1585
  sign: typeof createReceizWebhookSignature;
1586
+ verify: typeof verifyReceizWebhookRequest;
1114
1587
  verifySignature: typeof verifyReceizWebhookSignature;
1115
1588
  signaturePayload: typeof buildReceizWebhookSignaturePayload;
1116
1589
  assertEvent: typeof assertReceizWebhookEvent;
@@ -1314,6 +1787,24 @@ export declare class ReceizClient {
1314
1787
  assetManifest: typeof projectReceizAssetManifest;
1315
1788
  sportsCardManifest: typeof projectReceizSportsCardManifest;
1316
1789
  };
1790
+ readonly sandbox: {
1791
+ seedStore: (options: ReceizSandboxStoreOptions) => ReceizSandboxStore;
1792
+ wallet: (options?: {
1793
+ balanceUsdCents?: string;
1794
+ balancePhiMicro?: string;
1795
+ }) => {
1796
+ ok: boolean;
1797
+ userId: string;
1798
+ balanceUsdCents: string;
1799
+ balancePhiMicro: string;
1800
+ };
1801
+ checkout: (options: ReceizSandboxCheckoutOptions) => {
1802
+ ok: boolean;
1803
+ checkoutSessionId: string;
1804
+ status: string;
1805
+ amountUsd: string;
1806
+ };
1807
+ };
1317
1808
  readonly proofMemory: {
1318
1809
  createRegister: typeof createReceizProofRegister;
1319
1810
  createMemory: typeof createReceizProofMemory;
@@ -1322,6 +1813,12 @@ export declare class ReceizClient {
1322
1813
  assertSnapshot: typeof assertReceizProofRegisterSnapshot;
1323
1814
  additionsQuery: typeof receizProofMemoryAdditionsQuery;
1324
1815
  };
1816
+ readonly offline: {
1817
+ createQueue: typeof createReceizOfflineProofQueue;
1818
+ createInMemoryStorage: typeof createReceizInMemoryOfflineProofQueueStorage;
1819
+ createLocalStorage: typeof createReceizLocalStorageOfflineProofQueueStorage;
1820
+ assertSnapshot: typeof assertReceizOfflineProofQueueSnapshot;
1821
+ };
1325
1822
  constructor(options?: ReceizClientOptions);
1326
1823
  request<T>(path: string, options?: RequestOptions): Promise<T>;
1327
1824
  verifyArtifact(file: Blob): Promise<DocumentVerifyResponse>;
@@ -1335,8 +1832,15 @@ export declare class ReceizClient {
1335
1832
  }): Promise<WalletLedgerFeed>;
1336
1833
  observePublicProof(body: PublicProofObserveRequest): Promise<PublicProofRecord>;
1337
1834
  readPublicProofByUrl(url: string): Promise<PublicProofRecord>;
1835
+ inspectCapabilities(options?: ReceizCapabilitiesOptions): Promise<ReceizCapabilities>;
1836
+ runDoctor(options?: ReceizCapabilitiesOptions): Promise<ReceizDoctorReport>;
1338
1837
  publishAppState(feed: ReceizAppStateFeed, options?: {
1339
1838
  signature?: string;
1839
+ idempotencyKey?: string;
1840
+ }): Promise<ReceizAppStateFeedResponse>;
1841
+ publishAppStateInput(input: ReceizAppStatePublishInput, options?: {
1842
+ signature?: string;
1843
+ idempotencyKey?: string;
1340
1844
  }): Promise<ReceizAppStateFeedResponse>;
1341
1845
  publishAppStateRecord(record: ReceizAppStateRecord | ReceizAppStateRecordInput, options?: ReceizAppStatePublishRecordOptions): Promise<ReceizAppStateFeedResponse>;
1342
1846
  readAppStateByUrl(url: string): Promise<ReceizAppStateRecordResponse>;
@@ -1344,9 +1848,17 @@ export declare class ReceizClient {
1344
1848
  readAppStateByCreator(receizId: string): Promise<ReceizAppStateCollectionResponse>;
1345
1849
  readAppStateByNamespace(namespace: string): Promise<ReceizAppStateCollectionResponse>;
1346
1850
  readAppStateById(id: string): Promise<ReceizAppStateRecordResponse>;
1851
+ restoreAppStateByUrl<TData extends JsonObject = JsonObject>(url: string, options?: ReceizAppStateRestoreOptions): Promise<ReceizAppStateRestoreResult<TData>>;
1852
+ restoreAppStateByHost<TData extends JsonObject = JsonObject>(host: string, options?: ReceizAppStateRestoreOptions): Promise<ReceizAppStateRestoreResult<TData>>;
1853
+ restoreAppStateById<TData extends JsonObject = JsonObject>(id: string, options?: ReceizAppStateRestoreOptions): Promise<ReceizAppStateRestoreResult<TData>>;
1854
+ resolveAppState<TData extends JsonObject = JsonObject>(input: ReceizAppStateResolveInput): Promise<ReceizAppStateResolveResult<TData>>;
1855
+ oneClickCheckout(body: ReceizOneClickCheckoutRequest): Promise<ReceizOneClickCheckoutResponse>;
1856
+ uploadMedia(file: Blob, options?: ReceizMediaUploadOptions): Promise<ReceizMediaUploadResponse>;
1857
+ eventSubscribe(body: ReceizEventSubscribeRequest): Promise<JsonObject>;
1347
1858
  sportsConformance(): Promise<JsonObject>;
1348
1859
  signalCircuitConformance(): Promise<JsonObject>;
1349
1860
  delegated<T>(path: string, options?: Omit<RequestOptions, "bearerToken">): Promise<T>;
1861
+ private delegatedWrite;
1350
1862
  private delegatedBlob;
1351
1863
  private delegatedTwinMindImport;
1352
1864
  private streamJsonEvents;
@@ -1413,6 +1925,29 @@ export declare function createReceizProofMemory(options?: ReceizProofMemoryOptio
1413
1925
  export declare function createReceizInMemoryProofMemoryStorage(initialValue?: ReceizProofMemoryStorageValue): ReceizInMemoryProofMemoryStorage;
1414
1926
  export declare function createReceizLocalStorageProofMemoryStorage(key?: string, storage?: Pick<Storage, "getItem" | "setItem" | "removeItem"> | null | undefined): ReceizProofMemoryStorage;
1415
1927
  export declare function receizProofMemoryAdditionsQuery(value: ReceizProofRegister | ReceizProofRegisterSnapshot | ReceizProofMemory, limit?: number): ReceizProofMemoryAdditionsQuery;
1928
+ export declare function assertReceizOfflineProofQueueSnapshot(value: unknown): ReceizOfflineProofQueueSnapshot;
1929
+ export declare class ReceizOfflineProofQueue {
1930
+ readonly ownerId: string | null;
1931
+ readonly createdAt: string;
1932
+ private pendingItems;
1933
+ private settledItems;
1934
+ private failedItems;
1935
+ private readonly storage;
1936
+ constructor(options?: ReceizOfflineProofQueueOptions);
1937
+ enqueue(item: ReceizOfflineProofQueueItem): this;
1938
+ snapshot(): ReceizOfflineProofQueueSnapshot;
1939
+ flush(): Promise<ReceizOfflineProofQueueSnapshot>;
1940
+ clear(): Promise<void>;
1941
+ replay(client: ReceizClient): Promise<{
1942
+ ok: boolean;
1943
+ settled: number;
1944
+ failed: number;
1945
+ }>;
1946
+ toJSON(): ReceizOfflineProofQueueSnapshot;
1947
+ }
1948
+ export declare function createReceizOfflineProofQueue(options?: ReceizOfflineProofQueueOptions): Promise<ReceizOfflineProofQueue>;
1949
+ export declare function createReceizInMemoryOfflineProofQueueStorage(initialValue?: ReceizOfflineProofQueueStorageValue): ReceizInMemoryOfflineProofQueueStorage;
1950
+ export declare function createReceizLocalStorageOfflineProofQueueStorage(key?: string, storage?: Pick<Storage, "getItem" | "setItem" | "removeItem"> | null | undefined): ReceizOfflineProofQueueStorage;
1416
1951
  export declare function buildReceizWebhookSignaturePayload(input: {
1417
1952
  timestamp: string;
1418
1953
  body: string | ArrayBuffer | Uint8Array | JsonObject;