@arkiv-network/sdk 0.7.0 → 0.8.0-dev.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.
Files changed (210) hide show
  1. package/README.md +29 -16
  2. package/dist/attr/index.cjs +34 -0
  3. package/dist/attr/index.d.cts +2 -0
  4. package/dist/attr/index.d.ts +2 -0
  5. package/dist/attr/index.js +3 -0
  6. package/dist/attr-BDZ-APg5.js +809 -0
  7. package/dist/attr-BDZ-APg5.js.map +1 -0
  8. package/dist/attr-BvxHN99W.cjs +1029 -0
  9. package/dist/chains/index.cjs +2 -3
  10. package/dist/chains/index.d.cts +39 -77
  11. package/dist/chains/index.d.cts.map +1 -1
  12. package/dist/chains/index.d.ts +22 -60
  13. package/dist/chains/index.d.ts.map +1 -1
  14. package/dist/chains/index.js +2 -2
  15. package/dist/chains-BJrZs6sG.js +57 -0
  16. package/dist/chains-BJrZs6sG.js.map +1 -0
  17. package/dist/chains-BYRTTipa.cjs +73 -0
  18. package/dist/changeOwnership-B7bEgla4.d.cts +509 -0
  19. package/dist/changeOwnership-B7bEgla4.d.cts.map +1 -0
  20. package/dist/changeOwnership-DwgtdSFc.d.ts +509 -0
  21. package/dist/changeOwnership-DwgtdSFc.d.ts.map +1 -0
  22. package/dist/entity/index.cjs +19 -0
  23. package/dist/entity/index.d.cts +4 -0
  24. package/dist/entity/index.d.ts +4 -0
  25. package/dist/entity/index.js +6 -0
  26. package/dist/entity-B0t6sN7F.cjs +71 -0
  27. package/dist/entity-BIp_df9u.js +67 -0
  28. package/dist/entity-BIp_df9u.js.map +1 -0
  29. package/dist/entity-CFhbAv0R.js +70 -0
  30. package/dist/entity-CFhbAv0R.js.map +1 -0
  31. package/dist/entity-wfBnZd91.cjs +98 -0
  32. package/dist/errors-D-eJkGVc.cjs +56 -0
  33. package/dist/errors-DGB8AgT2.js +33 -0
  34. package/dist/errors-DGB8AgT2.js.map +1 -0
  35. package/dist/expiry-BUYIXTGb.cjs +135 -0
  36. package/dist/expiry-BxOlvVWC.d.ts +79 -0
  37. package/dist/expiry-BxOlvVWC.d.ts.map +1 -0
  38. package/dist/expiry-DGRzrSan.js +95 -0
  39. package/dist/expiry-DGRzrSan.js.map +1 -0
  40. package/dist/expiry-DRV29F1r.d.cts +79 -0
  41. package/dist/expiry-DRV29F1r.d.cts.map +1 -0
  42. package/dist/flags-0Vl5rrHq.d.cts +41 -0
  43. package/dist/flags-0Vl5rrHq.d.cts.map +1 -0
  44. package/dist/flags-Ct8k0gpB.cjs +43 -0
  45. package/dist/flags-ZtlvOIIk.js +33 -0
  46. package/dist/flags-ZtlvOIIk.js.map +1 -0
  47. package/dist/flags-wmcMoAnN.d.ts +41 -0
  48. package/dist/flags-wmcMoAnN.d.ts.map +1 -0
  49. package/dist/index-Cgw1u5aY.d.cts +278 -0
  50. package/dist/index-Cgw1u5aY.d.cts.map +1 -0
  51. package/dist/index-ClgIuxJ8.d.ts +159 -0
  52. package/dist/index-ClgIuxJ8.d.ts.map +1 -0
  53. package/dist/index-D0CmtiWT.d.cts +159 -0
  54. package/dist/index-D0CmtiWT.d.cts.map +1 -0
  55. package/dist/index-D8LZt-3J.d.cts +417 -0
  56. package/dist/index-D8LZt-3J.d.cts.map +1 -0
  57. package/dist/index-DVYFaXNV.d.ts +417 -0
  58. package/dist/index-DVYFaXNV.d.ts.map +1 -0
  59. package/dist/index-VCqgn29D.d.ts +278 -0
  60. package/dist/index-VCqgn29D.d.ts.map +1 -0
  61. package/dist/index.cjs +675 -357
  62. package/dist/index.d.cts +251 -203
  63. package/dist/index.d.cts.map +1 -1
  64. package/dist/index.d.ts +251 -203
  65. package/dist/index.d.ts.map +1 -1
  66. package/dist/index.js +626 -355
  67. package/dist/index.js.map +1 -1
  68. package/dist/payload-Bnw1hrvb.cjs +83 -0
  69. package/dist/payload-CIxSn_DW.js +67 -0
  70. package/dist/payload-CIxSn_DW.js.map +1 -0
  71. package/dist/payload-Dgx3PQeK.d.ts +94 -0
  72. package/dist/payload-Dgx3PQeK.d.ts.map +1 -0
  73. package/dist/payload-P0nWyjLg.d.cts +94 -0
  74. package/dist/payload-P0nWyjLg.d.cts.map +1 -0
  75. package/dist/query/index.cjs +24 -149
  76. package/dist/query/index.d.cts +5 -3
  77. package/dist/query/index.d.ts +5 -3
  78. package/dist/query/index.js +6 -137
  79. package/dist/queryBuilder-BXDvX1K_.cjs +1123 -0
  80. package/dist/queryBuilder-CbLL4pG5.js +963 -0
  81. package/dist/queryBuilder-CbLL4pG5.js.map +1 -0
  82. package/dist/selection-BvK6yX0g.d.cts +433 -0
  83. package/dist/selection-BvK6yX0g.d.cts.map +1 -0
  84. package/dist/selection-fpmI3ADQ.d.ts +433 -0
  85. package/dist/selection-fpmI3ADQ.d.ts.map +1 -0
  86. package/dist/types/index.cjs +4 -1
  87. package/dist/types/index.d.cts +7 -2
  88. package/dist/types/index.d.ts +7 -2
  89. package/dist/types/index.js +4 -1
  90. package/dist/utils/index.cjs +4 -17
  91. package/dist/utils/index.d.cts +3 -17
  92. package/dist/utils/index.d.ts +3 -17
  93. package/dist/utils/index.js +4 -18
  94. package/package.json +26 -5
  95. package/src/actions/public/getEntity.ts +27 -43
  96. package/src/actions/public/getEntityNonce.ts +30 -0
  97. package/src/actions/public/predictEntityKeys.test.ts +143 -0
  98. package/src/actions/public/predictEntityKeys.ts +138 -0
  99. package/src/actions/public/query.ts +33 -69
  100. package/src/actions/public/watchEntityEvents.test.ts +414 -0
  101. package/src/actions/public/watchEntityEvents.ts +225 -0
  102. package/src/actions/wallet/changeOwnership.ts +8 -8
  103. package/src/actions/wallet/createEntity.ts +104 -26
  104. package/src/actions/wallet/deleteEntity.ts +2 -3
  105. package/src/actions/wallet/extendEntity.ts +39 -16
  106. package/src/actions/wallet/mutateEntities.test.ts +76 -0
  107. package/src/actions/wallet/mutateEntities.ts +29 -74
  108. package/src/actions/wallet/patchEntity.ts +90 -0
  109. package/src/attr/attributes.test.ts +120 -0
  110. package/src/attr/attributes.ts +190 -0
  111. package/src/attr/codec.test.ts +162 -0
  112. package/src/attr/codec.ts +220 -0
  113. package/src/attr/decimal.ts +86 -0
  114. package/src/attr/errors.ts +145 -0
  115. package/src/attr/index.ts +50 -0
  116. package/src/attr/names.ts +106 -0
  117. package/src/attr/types.ts +150 -0
  118. package/src/attr/values.test.ts +271 -0
  119. package/src/attr/values.ts +502 -0
  120. package/src/chains/cheesecake.ts +22 -0
  121. package/src/chains/index.ts +1 -2
  122. package/src/clients/createPublicClient.test.ts +3 -5
  123. package/src/clients/createPublicClient.ts +5 -4
  124. package/src/clients/createWalletClient.test.ts +2 -2
  125. package/src/clients/createWalletClient.ts +13 -7
  126. package/src/clients/decorators/arkivPublic.ts +160 -139
  127. package/src/clients/decorators/arkivWallet.ts +91 -95
  128. package/src/consts.ts +2 -1
  129. package/src/entity/create.test.ts +184 -0
  130. package/src/entity/errors.ts +38 -0
  131. package/src/entity/events.ts +16 -0
  132. package/src/entity/expiry.test.ts +195 -0
  133. package/src/entity/expiry.ts +181 -0
  134. package/src/entity/flags.ts +65 -0
  135. package/src/entity/index.ts +14 -0
  136. package/src/entity/key.ts +68 -0
  137. package/src/entity/operations.ts +134 -0
  138. package/src/entity/params.ts +15 -0
  139. package/src/errors.ts +33 -28
  140. package/src/index.ts +6 -0
  141. package/src/query/engine.ts +59 -134
  142. package/src/query/errors.ts +151 -0
  143. package/src/query/expression.test.ts +286 -0
  144. package/src/query/expression.ts +493 -0
  145. package/src/query/index.ts +40 -4
  146. package/src/query/injection.test.ts +151 -0
  147. package/src/query/queryBuilder.test.ts +322 -637
  148. package/src/query/queryBuilder.ts +126 -359
  149. package/src/query/queryResult.ts +54 -51
  150. package/src/query/selection.test.ts +48 -98
  151. package/src/query/selection.ts +77 -65
  152. package/src/types/entity.test.ts +44 -155
  153. package/src/types/entity.ts +62 -44
  154. package/src/types/events.ts +64 -23
  155. package/src/types/index.ts +20 -16
  156. package/src/types/rpcSchema.ts +70 -33
  157. package/src/utils/arkivTransactions.test.ts +681 -38
  158. package/src/utils/arkivTransactions.ts +249 -104
  159. package/src/utils/chains.test.ts +21 -24
  160. package/src/utils/compression.ts +1 -1
  161. package/src/utils/entities.test.ts +62 -0
  162. package/src/utils/entities.ts +111 -29
  163. package/src/utils/expirationTime.ts +114 -10
  164. package/src/utils/logger.ts +2 -2
  165. package/src/utils/payload.ts +4 -2
  166. package/src/utils/revert.test.ts +99 -0
  167. package/src/utils/revert.ts +145 -0
  168. package/dist/chains-BifaY04V.cjs +0 -108
  169. package/dist/chains-CrtkVbBh.js +0 -86
  170. package/dist/chains-CrtkVbBh.js.map +0 -1
  171. package/dist/consts-AUoL-v42.cjs +0 -18
  172. package/dist/consts-BV4PR-de.js +0 -7
  173. package/dist/consts-BV4PR-de.js.map +0 -1
  174. package/dist/entity-B6g_EPm1.d.cts +0 -382
  175. package/dist/entity-B6g_EPm1.d.cts.map +0 -1
  176. package/dist/entity-qoLMAuuk.d.ts +0 -382
  177. package/dist/entity-qoLMAuuk.d.ts.map +0 -1
  178. package/dist/index-DdspxNAA.d.ts +0 -481
  179. package/dist/index-DdspxNAA.d.ts.map +0 -1
  180. package/dist/index-Ds9dwqb5.d.cts +0 -481
  181. package/dist/index-Ds9dwqb5.d.cts.map +0 -1
  182. package/dist/payload-B2kFJyah.d.ts +0 -6
  183. package/dist/payload-B2kFJyah.d.ts.map +0 -1
  184. package/dist/payload-CJN8fTvX.d.cts +0 -6
  185. package/dist/payload-CJN8fTvX.d.cts.map +0 -1
  186. package/dist/payload-Claf2jUO.js +0 -13
  187. package/dist/payload-Claf2jUO.js.map +0 -1
  188. package/dist/payload-DpA5PA-w.cjs +0 -23
  189. package/dist/query/index.js.map +0 -1
  190. package/dist/queryBuilder-D2uwP9jI.js +0 -704
  191. package/dist/queryBuilder-D2uwP9jI.js.map +0 -1
  192. package/dist/queryBuilder-UW2MCaX4.cjs +0 -792
  193. package/dist/utils/index.d.cts.map +0 -1
  194. package/dist/utils/index.d.ts.map +0 -1
  195. package/dist/utils/index.js.map +0 -1
  196. package/src/actions/public/buildQuery.ts +0 -10
  197. package/src/actions/public/subscribeEntityEvents.ts +0 -119
  198. package/src/actions/wallet/updateEntity.ts +0 -60
  199. package/src/chains/braga.ts +0 -26
  200. package/src/chains/kaolin.ts +0 -29
  201. package/src/query/engine.test.ts +0 -526
  202. package/src/query/predicate.test.ts +0 -461
  203. package/src/query/predicate.ts +0 -144
  204. package/src/query/queryResult.test.ts +0 -270
  205. package/src/query/selectQueryBuilder.test.ts +0 -210
  206. package/src/types/attributes.ts +0 -16
  207. package/src/utils/validation.test.ts +0 -60
  208. package/src/utils/validation.ts +0 -32
  209. /package/dist/{types-H-TSmRpm.js → types-Bx1EKe0v.js} +0 -0
  210. /package/dist/{types-o3zWarRp.cjs → types-CKPddlfS.cjs} +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"payload-CIxSn_DW.js","names":[],"sources":["../src/utils/expirationTime.ts","../src/utils/payload.ts"],"sourcesContent":["import { InvalidExpiryError } from \"../entity/errors\"\nimport { type Expiry, type Lifetime, makeExpiry, toBlocks } from \"../entity/expiry\"\nimport { MAX_EXPIRES_AT } from \"../entity/params\"\n\n/**\n * The optional floor a deadline can carry.\n *\n * `atLeast` takes a duration — one of the `from*` helpers — and never another deadline, so\n * `atBlock(x, { atLeast: atBlock(y) })` does not compile. Two deadlines are not a thing the engine\n * can resolve.\n */\nexport type DeadlineOptions = {\n /** Live at least this long from now, even if the deadline is sooner. */\n atLeast?: Lifetime | undefined\n}\n\nfunction lifetimeOf(seconds: number): Lifetime {\n return makeExpiry(toBlocks(seconds), 0n) as Lifetime\n}\n\nfunction deadlineOf(expiresAt: bigint | Date, options?: DeadlineOptions): Expiry {\n return makeExpiry(options?.atLeast?.minLifetime ?? 0n, expiresAt)\n}\n\n/**\n * Builds the `expires` of a create or an extension.\n *\n * Every helper returns the `{ minLifetime, expiresAt }` pair the ABI carries, so what you write is\n * what goes on the wire. The `from*` helpers fill `minLifetime` and leave `expiresAt` at `0n`;\n * {@link ExpirationTime.atBlock} and {@link ExpirationTime.atDate} do the reverse. The engine takes\n * whichever comes later, which is why a deadline can also carry a floor.\n *\n * Values are plain data — no methods, no prototype — so they log, clone and compare like any other\n * object.\n *\n * @example The 90% case: a duration, and nothing else to think about.\n * await client.createEntity({ payload, contentType, expires: ExpirationTime.fromDays(30) })\n *\n * @example An exact block, or a wall-clock date.\n * expires: ExpirationTime.atBlock(1_200_000n)\n * expires: ExpirationTime.atDate(new Date(\"2027-01-01\"))\n *\n * @example A deadline that still guarantees a minimum life.\n * expires: ExpirationTime.atBlock(1_200_000n, { atLeast: ExpirationTime.fromDays(1) })\n */\nexport const ExpirationTime = {\n /**\n * A raw number of seconds. Must be a whole number of blocks' worth — see the other helpers, which\n * all produce one by construction.\n *\n * @throws {InvalidExpiryError} If the duration is not a positive multiple of the block time.\n */\n fromSeconds: (seconds: number): Lifetime => lifetimeOf(seconds),\n fromMinutes: (minutes: number): Lifetime => lifetimeOf(minutes * 60),\n fromHours: (hours: number): Lifetime => lifetimeOf(hours * 60 * 60),\n fromDays: (days: number): Lifetime => lifetimeOf(days * 24 * 60 * 60),\n fromWeeks: (weeks: number): Lifetime => lifetimeOf(weeks * 7 * 24 * 60 * 60),\n fromMonths: (months: number): Lifetime => lifetimeOf(months * 30 * 24 * 60 * 60),\n fromYears: (years: number): Lifetime => lifetimeOf(years * 365 * 24 * 60 * 60),\n\n /**\n * A number of blocks, for callers who think in the chain's own unit. Always exact — there is no\n * conversion to be approximate about.\n *\n * @throws {InvalidExpiryError} If the count is not a positive whole number.\n */\n fromBlocks: (blocks: number): Lifetime => {\n if (!Number.isInteger(blocks) || blocks <= 0) {\n throw new InvalidExpiryError(\n `a lifetime must be a positive whole number of blocks, got ${blocks}`,\n )\n }\n return makeExpiry(BigInt(blocks), 0n) as Lifetime\n },\n\n /**\n * An absolute block height.\n *\n * @param block - The block the entity expires at.\n * @param options - Optionally, a floor: `{ atLeast: ExpirationTime.fromDays(1) }`.\n * @throws {InvalidExpiryError} If the height is negative.\n */\n atBlock: (block: bigint, options?: DeadlineOptions): Expiry => {\n if (typeof block !== \"bigint\" || block < 0n) {\n throw new InvalidExpiryError(`a deadline must be a non-negative block height, got ${block}`)\n }\n return deadlineOf(block, options)\n },\n\n /**\n * A wall-clock instant, placed against the block the transaction is built on.\n *\n * A date cannot land on a block boundary in general, so it rounds **up** to the next block: the\n * entity lives until at least the instant asked for. This is why a date is never rejected for\n * \"not being a whole number of blocks\" the way a duration is — it becomes a block height, not a\n * duration.\n *\n * @param date - When the entity should expire.\n * @param options - Optionally, a floor: `{ atLeast: ExpirationTime.fromDays(1) }`.\n * @throws {InvalidExpiryError} If the value is not a valid `Date`.\n */\n atDate: (date: Date, options?: DeadlineOptions): Expiry => {\n if (!(date instanceof Date) || Number.isNaN(date.getTime())) {\n throw new InvalidExpiryError(`a deadline must be a valid Date, got ${String(date)}`)\n }\n return deadlineOf(date, options)\n },\n\n /**\n * An entity that should never expire.\n *\n * This is `atBlock(MAX_EXPIRES_AT)` — the largest expiry the `uint64` field holds — and the\n * engine treats it as an ordinary deadline rather than a special case. There is no permanence\n * flag; a block height no chain will reach is what permanence is.\n */\n permanent: (): Expiry => deadlineOf(MAX_EXPIRES_AT),\n}\n","import { stringToBytes, toBytes } from \"viem\"\n\nexport function jsonToPayload(json: object): Uint8Array {\n return toBytes(JSON.stringify(json))\n}\n\nexport function stringToPayload(data: string): Uint8Array {\n // stringToBytes, not toBytes: toBytes hex-decodes hex-looking strings, which\n // would corrupt payloads like \"0xab\" instead of UTF-8 encoding them\n return stringToBytes(data)\n}\n"],"mappings":";;;;;AAgBA,SAAS,WAAW,SAA2B;AAC7C,QAAO,WAAW,SAAS,QAAQ,EAAE,GAAG;;AAG1C,SAAS,WAAW,WAA0B,SAAmC;AAC/E,QAAO,WAAW,SAAS,SAAS,eAAe,IAAI,UAAU;;;;;;;;;;;;;;;;;;;;;;;AAwBnE,MAAa,iBAAiB;CAO5B,cAAc,YAA8B,WAAW,QAAQ;CAC/D,cAAc,YAA8B,WAAW,UAAU,GAAG;CACpE,YAAY,UAA4B,WAAW,QAAQ,KAAK,GAAG;CACnE,WAAW,SAA2B,WAAW,OAAO,KAAK,KAAK,GAAG;CACrE,YAAY,UAA4B,WAAW,QAAQ,IAAI,KAAK,KAAK,GAAG;CAC5E,aAAa,WAA6B,WAAW,SAAS,KAAK,KAAK,KAAK,GAAG;CAChF,YAAY,UAA4B,WAAW,QAAQ,MAAM,KAAK,KAAK,GAAG;CAQ9E,aAAa,WAA6B;AACxC,MAAI,CAAC,OAAO,UAAU,OAAO,IAAI,UAAU,EACzC,OAAM,IAAI,mBACR,6DAA6D,SAC9D;AAEH,SAAO,WAAW,OAAO,OAAO,EAAE,GAAG;;CAUvC,UAAU,OAAe,YAAsC;AAC7D,MAAI,OAAO,UAAU,YAAY,QAAQ,GACvC,OAAM,IAAI,mBAAmB,uDAAuD,QAAQ;AAE9F,SAAO,WAAW,OAAO,QAAQ;;CAenC,SAAS,MAAY,YAAsC;AACzD,MAAI,EAAE,gBAAgB,SAAS,OAAO,MAAM,KAAK,SAAS,CAAC,CACzD,OAAM,IAAI,mBAAmB,wCAAwC,OAAO,KAAK,GAAG;AAEtF,SAAO,WAAW,MAAM,QAAQ;;CAUlC,iBAAyB,WAAW,eAAe;CACpD;;;;AClHD,SAAgB,cAAc,MAA0B;AACtD,QAAO,QAAQ,KAAK,UAAU,KAAK,CAAC;;AAGtC,SAAgB,gBAAgB,MAA0B;AAGxD,QAAO,cAAc,KAAK"}
@@ -0,0 +1,94 @@
1
+ import { i as Lifetime, n as Expiry } from "./expiry-BxOlvVWC.js";
2
+
3
+ //#region src/utils/expirationTime.d.ts
4
+
5
+ /**
6
+ * The optional floor a deadline can carry.
7
+ *
8
+ * `atLeast` takes a duration — one of the `from*` helpers — and never another deadline, so
9
+ * `atBlock(x, { atLeast: atBlock(y) })` does not compile. Two deadlines are not a thing the engine
10
+ * can resolve.
11
+ */
12
+ type DeadlineOptions = {
13
+ /** Live at least this long from now, even if the deadline is sooner. */
14
+ atLeast?: Lifetime | undefined;
15
+ };
16
+ /**
17
+ * Builds the `expires` of a create or an extension.
18
+ *
19
+ * Every helper returns the `{ minLifetime, expiresAt }` pair the ABI carries, so what you write is
20
+ * what goes on the wire. The `from*` helpers fill `minLifetime` and leave `expiresAt` at `0n`;
21
+ * {@link ExpirationTime.atBlock} and {@link ExpirationTime.atDate} do the reverse. The engine takes
22
+ * whichever comes later, which is why a deadline can also carry a floor.
23
+ *
24
+ * Values are plain data — no methods, no prototype — so they log, clone and compare like any other
25
+ * object.
26
+ *
27
+ * @example The 90% case: a duration, and nothing else to think about.
28
+ * await client.createEntity({ payload, contentType, expires: ExpirationTime.fromDays(30) })
29
+ *
30
+ * @example An exact block, or a wall-clock date.
31
+ * expires: ExpirationTime.atBlock(1_200_000n)
32
+ * expires: ExpirationTime.atDate(new Date("2027-01-01"))
33
+ *
34
+ * @example A deadline that still guarantees a minimum life.
35
+ * expires: ExpirationTime.atBlock(1_200_000n, { atLeast: ExpirationTime.fromDays(1) })
36
+ */
37
+ declare const ExpirationTime: {
38
+ /**
39
+ * A raw number of seconds. Must be a whole number of blocks' worth — see the other helpers, which
40
+ * all produce one by construction.
41
+ *
42
+ * @throws {InvalidExpiryError} If the duration is not a positive multiple of the block time.
43
+ */
44
+ fromSeconds: (seconds: number) => Lifetime;
45
+ fromMinutes: (minutes: number) => Lifetime;
46
+ fromHours: (hours: number) => Lifetime;
47
+ fromDays: (days: number) => Lifetime;
48
+ fromWeeks: (weeks: number) => Lifetime;
49
+ fromMonths: (months: number) => Lifetime;
50
+ fromYears: (years: number) => Lifetime;
51
+ /**
52
+ * A number of blocks, for callers who think in the chain's own unit. Always exact — there is no
53
+ * conversion to be approximate about.
54
+ *
55
+ * @throws {InvalidExpiryError} If the count is not a positive whole number.
56
+ */
57
+ fromBlocks: (blocks: number) => Lifetime;
58
+ /**
59
+ * An absolute block height.
60
+ *
61
+ * @param block - The block the entity expires at.
62
+ * @param options - Optionally, a floor: `{ atLeast: ExpirationTime.fromDays(1) }`.
63
+ * @throws {InvalidExpiryError} If the height is negative.
64
+ */
65
+ atBlock: (block: bigint, options?: DeadlineOptions) => Expiry;
66
+ /**
67
+ * A wall-clock instant, placed against the block the transaction is built on.
68
+ *
69
+ * A date cannot land on a block boundary in general, so it rounds **up** to the next block: the
70
+ * entity lives until at least the instant asked for. This is why a date is never rejected for
71
+ * "not being a whole number of blocks" the way a duration is — it becomes a block height, not a
72
+ * duration.
73
+ *
74
+ * @param date - When the entity should expire.
75
+ * @param options - Optionally, a floor: `{ atLeast: ExpirationTime.fromDays(1) }`.
76
+ * @throws {InvalidExpiryError} If the value is not a valid `Date`.
77
+ */
78
+ atDate: (date: Date, options?: DeadlineOptions) => Expiry;
79
+ /**
80
+ * An entity that should never expire.
81
+ *
82
+ * This is `atBlock(MAX_EXPIRES_AT)` — the largest expiry the `uint64` field holds — and the
83
+ * engine treats it as an ordinary deadline rather than a special case. There is no permanence
84
+ * flag; a block height no chain will reach is what permanence is.
85
+ */
86
+ permanent: () => Expiry;
87
+ };
88
+ //#endregion
89
+ //#region src/utils/payload.d.ts
90
+ declare function jsonToPayload(json: object): Uint8Array;
91
+ declare function stringToPayload(data: string): Uint8Array;
92
+ //#endregion
93
+ export { ExpirationTime as i, stringToPayload as n, DeadlineOptions as r, jsonToPayload as t };
94
+ //# sourceMappingURL=payload-Dgx3PQeK.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"payload-Dgx3PQeK.d.ts","names":[],"sources":["../src/utils/expirationTime.ts","../src/utils/payload.ts"],"sourcesContent":[],"mappings":";;;;;;AAWA;AAkCA;;;;AAU4B,KA5ChB,eAAA,GA4CgB;EACE;EACE,OAAA,CAAA,EA5CpB,QA4CoB,GAAA,SAAA;CACF;;;;;;;;;;;;ACxD9B;AAIA;;;;;;;;;cDuCa;;;;;;;oCAOqB;oCACA;gCACJ;8BACF;gCACE;kCACE;gCACF;;;;;;;kCAQE;;;;;;;;qCAgBK,oBAAkB;;;;;;;;;;;;;iBAmBtC,gBAAgB,oBAAkB;;;;;;;;mBAclC;;;;iBCjHD,aAAA,gBAA6B;iBAI7B,eAAA,gBAA+B"}
@@ -0,0 +1,94 @@
1
+ import { i as Lifetime, n as Expiry } from "./expiry-DRV29F1r.cjs";
2
+
3
+ //#region src/utils/expirationTime.d.ts
4
+
5
+ /**
6
+ * The optional floor a deadline can carry.
7
+ *
8
+ * `atLeast` takes a duration — one of the `from*` helpers — and never another deadline, so
9
+ * `atBlock(x, { atLeast: atBlock(y) })` does not compile. Two deadlines are not a thing the engine
10
+ * can resolve.
11
+ */
12
+ type DeadlineOptions = {
13
+ /** Live at least this long from now, even if the deadline is sooner. */
14
+ atLeast?: Lifetime | undefined;
15
+ };
16
+ /**
17
+ * Builds the `expires` of a create or an extension.
18
+ *
19
+ * Every helper returns the `{ minLifetime, expiresAt }` pair the ABI carries, so what you write is
20
+ * what goes on the wire. The `from*` helpers fill `minLifetime` and leave `expiresAt` at `0n`;
21
+ * {@link ExpirationTime.atBlock} and {@link ExpirationTime.atDate} do the reverse. The engine takes
22
+ * whichever comes later, which is why a deadline can also carry a floor.
23
+ *
24
+ * Values are plain data — no methods, no prototype — so they log, clone and compare like any other
25
+ * object.
26
+ *
27
+ * @example The 90% case: a duration, and nothing else to think about.
28
+ * await client.createEntity({ payload, contentType, expires: ExpirationTime.fromDays(30) })
29
+ *
30
+ * @example An exact block, or a wall-clock date.
31
+ * expires: ExpirationTime.atBlock(1_200_000n)
32
+ * expires: ExpirationTime.atDate(new Date("2027-01-01"))
33
+ *
34
+ * @example A deadline that still guarantees a minimum life.
35
+ * expires: ExpirationTime.atBlock(1_200_000n, { atLeast: ExpirationTime.fromDays(1) })
36
+ */
37
+ declare const ExpirationTime: {
38
+ /**
39
+ * A raw number of seconds. Must be a whole number of blocks' worth — see the other helpers, which
40
+ * all produce one by construction.
41
+ *
42
+ * @throws {InvalidExpiryError} If the duration is not a positive multiple of the block time.
43
+ */
44
+ fromSeconds: (seconds: number) => Lifetime;
45
+ fromMinutes: (minutes: number) => Lifetime;
46
+ fromHours: (hours: number) => Lifetime;
47
+ fromDays: (days: number) => Lifetime;
48
+ fromWeeks: (weeks: number) => Lifetime;
49
+ fromMonths: (months: number) => Lifetime;
50
+ fromYears: (years: number) => Lifetime;
51
+ /**
52
+ * A number of blocks, for callers who think in the chain's own unit. Always exact — there is no
53
+ * conversion to be approximate about.
54
+ *
55
+ * @throws {InvalidExpiryError} If the count is not a positive whole number.
56
+ */
57
+ fromBlocks: (blocks: number) => Lifetime;
58
+ /**
59
+ * An absolute block height.
60
+ *
61
+ * @param block - The block the entity expires at.
62
+ * @param options - Optionally, a floor: `{ atLeast: ExpirationTime.fromDays(1) }`.
63
+ * @throws {InvalidExpiryError} If the height is negative.
64
+ */
65
+ atBlock: (block: bigint, options?: DeadlineOptions) => Expiry;
66
+ /**
67
+ * A wall-clock instant, placed against the block the transaction is built on.
68
+ *
69
+ * A date cannot land on a block boundary in general, so it rounds **up** to the next block: the
70
+ * entity lives until at least the instant asked for. This is why a date is never rejected for
71
+ * "not being a whole number of blocks" the way a duration is — it becomes a block height, not a
72
+ * duration.
73
+ *
74
+ * @param date - When the entity should expire.
75
+ * @param options - Optionally, a floor: `{ atLeast: ExpirationTime.fromDays(1) }`.
76
+ * @throws {InvalidExpiryError} If the value is not a valid `Date`.
77
+ */
78
+ atDate: (date: Date, options?: DeadlineOptions) => Expiry;
79
+ /**
80
+ * An entity that should never expire.
81
+ *
82
+ * This is `atBlock(MAX_EXPIRES_AT)` — the largest expiry the `uint64` field holds — and the
83
+ * engine treats it as an ordinary deadline rather than a special case. There is no permanence
84
+ * flag; a block height no chain will reach is what permanence is.
85
+ */
86
+ permanent: () => Expiry;
87
+ };
88
+ //#endregion
89
+ //#region src/utils/payload.d.ts
90
+ declare function jsonToPayload(json: object): Uint8Array;
91
+ declare function stringToPayload(data: string): Uint8Array;
92
+ //#endregion
93
+ export { ExpirationTime as i, stringToPayload as n, DeadlineOptions as r, jsonToPayload as t };
94
+ //# sourceMappingURL=payload-P0nWyjLg.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"payload-P0nWyjLg.d.cts","names":[],"sources":["../src/utils/expirationTime.ts","../src/utils/payload.ts"],"sourcesContent":[],"mappings":";;;;;;AAWA;AAkCA;;;;AAU4B,KA5ChB,eAAA,GA4CgB;EACE;EACE,OAAA,CAAA,EA5CpB,QA4CoB,GAAA,SAAA;CACF;;;;;;;;;;;;ACxD9B;AAIA;;;;;;;;;cDuCa;;;;;;;oCAOqB;oCACA;gCACJ;8BACF;gCACE;kCACE;gCACF;;;;;;;kCAQE;;;;;;;;qCAgBK,oBAAkB;;;;;;;;;;;;;iBAmBtC,gBAAgB,oBAAkB;;;;;;;;mBAclC;;;;iBCjHD,aAAA,gBAA6B;iBAI7B,eAAA,gBAA+B"}
@@ -1,152 +1,27 @@
1
- const require_queryBuilder = require('../queryBuilder-UW2MCaX4.cjs');
2
- require('../consts-AUoL-v42.cjs');
1
+ require('../attr-BvxHN99W.cjs');
2
+ const require_queryBuilder = require('../queryBuilder-BXDvX1K_.cjs');
3
+ require('../errors-D-eJkGVc.cjs');
4
+ require('../flags-Ct8k0gpB.cjs');
5
+ require('../entity-B0t6sN7F.cjs');
3
6
 
4
- //#region src/query/predicate.ts
5
- function or(...predicates) {
6
- return {
7
- type: "or",
8
- predicates: predicates.flat()
9
- };
10
- }
11
- function and(...predicates) {
12
- return {
13
- type: "and",
14
- predicates: predicates.flat()
15
- };
16
- }
17
- /**
18
- * Creates an equality predicate
19
- * @param key - The key to compare
20
- * @param value - The value to compare
21
- * @returns The equality predicate
22
- *
23
- * @example
24
- * const predicate = eq("name", "John")
25
- * // result = { type: "eq", key: "name", value: "John" }
26
- */
27
- function eq(key, value) {
28
- return {
29
- type: "eq",
30
- key,
31
- value
32
- };
33
- }
34
- /**
35
- * Creates a not equal predicate
36
- * @param key - The key to compare
37
- * @param value - The value to compare
38
- * @returns The not equal predicate
39
- *
40
- * @example
41
- * const predicate = neq("name", "John")
42
- * // result = { type: "neq", key: "name", value: "John" }
43
- */
44
- function neq(key, value) {
45
- return {
46
- type: "neq",
47
- key,
48
- value
49
- };
50
- }
51
- /**
52
- * Creates a greater than predicate
53
- * @param key - The key to compare
54
- * @param value - The value to compare
55
- * @returns The greater than predicate
56
- *
57
- * @example
58
- * const predicate = gt("name", "John")
59
- * // result = { type: "gt", key: "name", value: "John" }
60
- */
61
- function gt(key, value) {
62
- return {
63
- type: "gt",
64
- key,
65
- value
66
- };
67
- }
68
- /**
69
- * Creates a greater than or equal predicate
70
- * @param key - The key to compare
71
- * @param value - The value to compare
72
- * @returns The greater than or equal predicate
73
- *
74
- * @example
75
- * const predicate = gte("name", "John")
76
- * // result = { type: "gte", key: "name", value: "John" }
77
- */
78
- function gte(key, value) {
79
- return {
80
- type: "gte",
81
- key,
82
- value
83
- };
84
- }
85
- /**
86
- * Creates a less than predicate
87
- * @param key - The key to compare
88
- * @param value - The value to compare
89
- * @returns The less than predicate
90
- *
91
- * @example
92
- * const predicate = lt("name", "John")
93
- * // result = { type: "lt", key: "name", value: "John" }
94
- */
95
- function lt(key, value) {
96
- return {
97
- type: "lt",
98
- key,
99
- value
100
- };
101
- }
102
- /**
103
- * Creates a less than or equal predicate
104
- * @param key - The key to compare
105
- * @param value - The value to compare
106
- * @returns The less than or equal predicate
107
- *
108
- * @example
109
- * const predicate = lte("name", "John")
110
- * // result = { type: "lte", key: "name", value: "John" }
111
- */
112
- function lte(key, value) {
113
- return {
114
- type: "lte",
115
- key,
116
- value
117
- };
118
- }
119
- /**
120
- * Creates a not predicate
121
- * @param key - The key to compare
122
- * @returns The not predicate
123
- *
124
- * @example
125
- * const predicate = not("name")
126
- * // result = { type: "not", key: "name", value: "" }
127
- */
128
- function not(key) {
129
- return {
130
- type: "not",
131
- key,
132
- value: ""
133
- };
134
- }
135
-
136
- //#endregion
137
- exports.BaseQueryBuilder = require_queryBuilder.BaseQueryBuilder;
138
- exports.QueryBuilder = require_queryBuilder.QueryBuilder;
7
+ exports.InvalidPredicateError = require_queryBuilder.InvalidPredicateError;
8
+ exports.MAX_LIMIT = require_queryBuilder.MAX_LIMIT;
9
+ exports.QueryError = require_queryBuilder.QueryError;
139
10
  exports.QueryResult = require_queryBuilder.QueryResult;
140
11
  exports.SelectQueryBuilder = require_queryBuilder.SelectQueryBuilder;
141
- exports.and = and;
142
- exports.asc = require_queryBuilder.asc;
143
- exports.desc = require_queryBuilder.desc;
144
- exports.eq = eq;
145
- exports.gt = gt;
146
- exports.gte = gte;
147
- exports.lt = lt;
148
- exports.lte = lte;
149
- exports.neq = neq;
150
- exports.not = not;
151
- exports.or = or;
152
- exports.selectionToIncludeData = require_queryBuilder.selectionToIncludeData;
12
+ exports.UnsupportedOperatorError = require_queryBuilder.UnsupportedOperatorError;
13
+ exports.and = require_queryBuilder.and;
14
+ exports.eq = require_queryBuilder.eq;
15
+ exports.exists = require_queryBuilder.exists;
16
+ exports.gt = require_queryBuilder.gt;
17
+ exports.gte = require_queryBuilder.gte;
18
+ exports.hasType = require_queryBuilder.hasType;
19
+ exports.lt = require_queryBuilder.lt;
20
+ exports.lte = require_queryBuilder.lte;
21
+ exports.ne = require_queryBuilder.ne;
22
+ exports.not = require_queryBuilder.not;
23
+ exports.or = require_queryBuilder.or;
24
+ exports.render = require_queryBuilder.render;
25
+ exports.runQuery = require_queryBuilder.runQuery;
26
+ exports.startsWith = require_queryBuilder.startsWith;
27
+ exports.toRpcSelect = require_queryBuilder.toRpcSelect;
@@ -1,3 +1,5 @@
1
- import "../entity-B6g_EPm1.cjs";
2
- import { C as neq, S as lte, T as or, _ as and, a as asc, b as gte, c as FullEntity, d as SelectionFields, f as selectionToIncludeData, g as PredicateType, h as PredicateContainerType, i as SelectQueryBuilder, l as ProjectedEntity, m as Predicate, n as OrderByAttribute, o as desc, p as QueryResult, r as QueryBuilder, s as EntitySelection, t as BaseQueryBuilder, u as SelectArg, v as eq, w as not, x as lt, y as gt } from "../index-Ds9dwqb5.cjs";
3
- export { BaseQueryBuilder, EntitySelection, FullEntity, OrderByAttribute, Predicate, PredicateContainerType, PredicateType, ProjectedEntity, QueryBuilder, QueryResult, SelectArg, SelectQueryBuilder, SelectionFields, and, asc, desc, eq, gt, gte, lt, lte, neq, not, or, selectionToIncludeData };
1
+ import "../index-D8LZt-3J.cjs";
2
+ import "../flags-0Vl5rrHq.cjs";
3
+ import { C as lte, D as render, E as or, O as startsWith, S as lt, T as not, _ as eq, a as SelectionFields, b as gte, c as ComparisonNode, d as Expression, f as NotNode, g as and, h as TypeOfNode, i as SelectArg, l as ComparisonOperator, m as StartsWithNode, n as FullEntity, o as toRpcSelect, p as OrNode, r as ProjectedEntity, s as AndNode, t as EntitySelection, u as ExistsNode, v as exists, w as ne, x as hasType, y as gt } from "../selection-BvK6yX0g.cjs";
4
+ import { a as QueryErrorKind, c as QueryRequest, i as QueryError, l as QueryResponse, n as QueryResult, o as UnsupportedOperatorError, r as InvalidPredicateError, s as MAX_LIMIT, t as SelectQueryBuilder, u as runQuery } from "../index-Cgw1u5aY.cjs";
5
+ export { AndNode, ComparisonNode, ComparisonOperator, EntitySelection, ExistsNode, Expression, FullEntity, InvalidPredicateError, MAX_LIMIT, NotNode, OrNode, ProjectedEntity, QueryError, QueryErrorKind, QueryRequest, QueryResponse, QueryResult, SelectArg, SelectQueryBuilder, SelectionFields, StartsWithNode, TypeOfNode, UnsupportedOperatorError, and, eq, exists, gt, gte, hasType, lt, lte, ne, not, or, render, runQuery, startsWith, toRpcSelect };
@@ -1,3 +1,5 @@
1
- import "../entity-qoLMAuuk.js";
2
- import { C as neq, S as lte, T as or, _ as and, a as asc, b as gte, c as FullEntity, d as SelectionFields, f as selectionToIncludeData, g as PredicateType, h as PredicateContainerType, i as SelectQueryBuilder, l as ProjectedEntity, m as Predicate, n as OrderByAttribute, o as desc, p as QueryResult, r as QueryBuilder, s as EntitySelection, t as BaseQueryBuilder, u as SelectArg, v as eq, w as not, x as lt, y as gt } from "../index-DdspxNAA.js";
3
- export { BaseQueryBuilder, EntitySelection, FullEntity, OrderByAttribute, Predicate, PredicateContainerType, PredicateType, ProjectedEntity, QueryBuilder, QueryResult, SelectArg, SelectQueryBuilder, SelectionFields, and, asc, desc, eq, gt, gte, lt, lte, neq, not, or, selectionToIncludeData };
1
+ import "../index-DVYFaXNV.js";
2
+ import "../flags-wmcMoAnN.js";
3
+ import { C as lte, D as render, E as or, O as startsWith, S as lt, T as not, _ as eq, a as SelectionFields, b as gte, c as ComparisonNode, d as Expression, f as NotNode, g as and, h as TypeOfNode, i as SelectArg, l as ComparisonOperator, m as StartsWithNode, n as FullEntity, o as toRpcSelect, p as OrNode, r as ProjectedEntity, s as AndNode, t as EntitySelection, u as ExistsNode, v as exists, w as ne, x as hasType, y as gt } from "../selection-fpmI3ADQ.js";
4
+ import { a as QueryErrorKind, c as QueryRequest, i as QueryError, l as QueryResponse, n as QueryResult, o as UnsupportedOperatorError, r as InvalidPredicateError, s as MAX_LIMIT, t as SelectQueryBuilder, u as runQuery } from "../index-VCqgn29D.js";
5
+ export { AndNode, ComparisonNode, ComparisonOperator, EntitySelection, ExistsNode, Expression, FullEntity, InvalidPredicateError, MAX_LIMIT, NotNode, OrNode, ProjectedEntity, QueryError, QueryErrorKind, QueryRequest, QueryResponse, QueryResult, SelectArg, SelectQueryBuilder, SelectionFields, StartsWithNode, TypeOfNode, UnsupportedOperatorError, and, eq, exists, gt, gte, hasType, lt, lte, ne, not, or, render, runQuery, startsWith, toRpcSelect };
@@ -1,138 +1,7 @@
1
- import { a as desc, i as asc, n as QueryBuilder, o as selectionToIncludeData, r as SelectQueryBuilder, s as QueryResult, t as BaseQueryBuilder } from "../queryBuilder-D2uwP9jI.js";
2
- import "../consts-BV4PR-de.js";
1
+ import "../attr-BDZ-APg5.js";
2
+ import { _ as MAX_LIMIT, a as eq, b as QueryError, c as gte, d as lte, f as ne, g as startsWith, h as render, i as and, l as hasType, m as or, n as QueryResult, o as exists, p as not, r as toRpcSelect, s as gt, t as SelectQueryBuilder, u as lt, v as runQuery, x as UnsupportedOperatorError, y as InvalidPredicateError } from "../queryBuilder-CbLL4pG5.js";
3
+ import "../errors-DGB8AgT2.js";
4
+ import "../flags-ZtlvOIIk.js";
5
+ import "../entity-BIp_df9u.js";
3
6
 
4
- //#region src/query/predicate.ts
5
- function or(...predicates) {
6
- return {
7
- type: "or",
8
- predicates: predicates.flat()
9
- };
10
- }
11
- function and(...predicates) {
12
- return {
13
- type: "and",
14
- predicates: predicates.flat()
15
- };
16
- }
17
- /**
18
- * Creates an equality predicate
19
- * @param key - The key to compare
20
- * @param value - The value to compare
21
- * @returns The equality predicate
22
- *
23
- * @example
24
- * const predicate = eq("name", "John")
25
- * // result = { type: "eq", key: "name", value: "John" }
26
- */
27
- function eq(key, value) {
28
- return {
29
- type: "eq",
30
- key,
31
- value
32
- };
33
- }
34
- /**
35
- * Creates a not equal predicate
36
- * @param key - The key to compare
37
- * @param value - The value to compare
38
- * @returns The not equal predicate
39
- *
40
- * @example
41
- * const predicate = neq("name", "John")
42
- * // result = { type: "neq", key: "name", value: "John" }
43
- */
44
- function neq(key, value) {
45
- return {
46
- type: "neq",
47
- key,
48
- value
49
- };
50
- }
51
- /**
52
- * Creates a greater than predicate
53
- * @param key - The key to compare
54
- * @param value - The value to compare
55
- * @returns The greater than predicate
56
- *
57
- * @example
58
- * const predicate = gt("name", "John")
59
- * // result = { type: "gt", key: "name", value: "John" }
60
- */
61
- function gt(key, value) {
62
- return {
63
- type: "gt",
64
- key,
65
- value
66
- };
67
- }
68
- /**
69
- * Creates a greater than or equal predicate
70
- * @param key - The key to compare
71
- * @param value - The value to compare
72
- * @returns The greater than or equal predicate
73
- *
74
- * @example
75
- * const predicate = gte("name", "John")
76
- * // result = { type: "gte", key: "name", value: "John" }
77
- */
78
- function gte(key, value) {
79
- return {
80
- type: "gte",
81
- key,
82
- value
83
- };
84
- }
85
- /**
86
- * Creates a less than predicate
87
- * @param key - The key to compare
88
- * @param value - The value to compare
89
- * @returns The less than predicate
90
- *
91
- * @example
92
- * const predicate = lt("name", "John")
93
- * // result = { type: "lt", key: "name", value: "John" }
94
- */
95
- function lt(key, value) {
96
- return {
97
- type: "lt",
98
- key,
99
- value
100
- };
101
- }
102
- /**
103
- * Creates a less than or equal predicate
104
- * @param key - The key to compare
105
- * @param value - The value to compare
106
- * @returns The less than or equal predicate
107
- *
108
- * @example
109
- * const predicate = lte("name", "John")
110
- * // result = { type: "lte", key: "name", value: "John" }
111
- */
112
- function lte(key, value) {
113
- return {
114
- type: "lte",
115
- key,
116
- value
117
- };
118
- }
119
- /**
120
- * Creates a not predicate
121
- * @param key - The key to compare
122
- * @returns The not predicate
123
- *
124
- * @example
125
- * const predicate = not("name")
126
- * // result = { type: "not", key: "name", value: "" }
127
- */
128
- function not(key) {
129
- return {
130
- type: "not",
131
- key,
132
- value: ""
133
- };
134
- }
135
-
136
- //#endregion
137
- export { BaseQueryBuilder, QueryBuilder, QueryResult, SelectQueryBuilder, and, asc, desc, eq, gt, gte, lt, lte, neq, not, or, selectionToIncludeData };
138
- //# sourceMappingURL=index.js.map
7
+ export { InvalidPredicateError, MAX_LIMIT, QueryError, QueryResult, SelectQueryBuilder, UnsupportedOperatorError, and, eq, exists, gt, gte, hasType, lt, lte, ne, not, or, render, runQuery, startsWith, toRpcSelect };