tigerbeetle-node 0.16.77 → 0.17.0

package/README.md

@@ -109,8 +109,8 @@ const account = {
   timestamp: 0n,
 };
 
-const account_errors = await client.createAccounts([account]);
-// Error handling omitted.
+const account_results = await client.createAccounts([account]);
+// Results handling omitted.
 ```
 
 See details for the recommended ID scheme in
@@ -167,21 +167,23 @@ const account1 = {
   flags: AccountFlags.history,
 };
 
-const account_errors = await client.createAccounts([account0, account1]);
-// Error handling omitted.
+const account_results = await client.createAccounts([account0, account1]);
+// Results handling omitted.
 ```
 
 ### Response and Errors
 
-The response is an empty array if all accounts were
-created successfully. If the response is non-empty, each
-object in the response array contains error information
-for an account that failed. The error object contains an
-error code and the index of the account in the request
-batch.
-
-See all error conditions in the [create_accounts
-reference](https://docs.tigerbeetle.com/reference/requests/create_accounts).
+The response is an array containing the _status code_ and the _timestamp_ of
+each account in the request batch:
+- Successfully created accounts with the status
+  [`created`](https://docs.tigerbeetle.com/reference/requests/create_accounts#created)
+  return the timestamp assigned to the `Account` object.
+- Already existing accounts with the result
+  [`exists`](https://docs.tigerbeetle.com/reference/requests/create_accounts#exists)
+  return the timestamp of the original existing object.
+- Failed accounts return the status code along with the timestamp when the validation
+  occurred. See all error conditions in the
+  [create_accounts reference](https://docs.tigerbeetle.com/reference/requests/create_accounts#status).
 
 ```javascript
 const account0 = {
@@ -230,18 +232,18 @@ const account2 = {
   flags: 0,
 };
 
-const account_errors = await client.createAccounts([account0, account1, account2]);
-for (const error of account_errors) {
-  switch (error.result) {
-    case CreateAccountError.exists:
-      console.error(`Batch account at ${error.index} already exists.`);
+const account_results = await client.createAccounts([account0, account1, account2]);
+for (let i = 0; i < account_results.length; i++) {
+  switch (account_results[i].status) {
+    case CreateAccountStatus.created:
+      console.error(`Batch account at ${i} successfully created with timestamp ${account_results[i].timestamp}.`);
+      break;
+    case CreateAccountStatus.exists:
+      console.error(`Batch account at ${i} already exists with timestamp ${account_results[i].timestamp}.`);
       break;
     default:
-      console.error(
-        `Batch account at ${error.index} failed to create: ${
-          CreateAccountError[error.result]
-        }.`,
-      );
+      console.error(`Batch account at ${i} failed to create: ${account_results[i].status}`);
+      break;
   }
 }
 ```
@@ -290,8 +292,8 @@ const transfers = [{
   timestamp: 0n,
 }];
 
-const transfer_errors = await client.createTransfers(transfers);
-// Error handling omitted.
+const transfers_results = await client.createTransfers(transfers);
+// Results handling omitted.
 ```
 
 See details for the recommended ID scheme in
@@ -299,14 +301,17 @@ See details for the recommended ID scheme in
 
 ### Response and Errors
 
-The response is an empty array if all transfers were created
-successfully. If the response is non-empty, each object in the
-response array contains error information for a transfer that
-failed. The error object contains an error code and the index of the
-transfer in the request batch.
-
-See all error conditions in the [create_transfers
-reference](https://docs.tigerbeetle.com/reference/requests/create_transfers).
+The response is an array containing the _status code_ and the _timestamp_ of
+each transfer in the request batch:
+- Successfully created transfers with the result
+  [`created`](https://docs.tigerbeetle.com/reference/requests/create_transfers#created)
+  return the timestamp assigned to the `Transfer` object.
+- Already existing transfers with the result
+  [`exists`](https://docs.tigerbeetle.com/reference/requests/create_transfers#exists)
+  return the timestamp of the original existing object.
+- Failed transfers return the status code along with the timestamp when the validation
+  occurred. See all error conditions in the
+  [create_transfers reference](https://docs.tigerbeetle.com/reference/requests/create_transfers#status).
 
 ```javascript
 const transfers = [{
@@ -355,18 +360,18 @@ const transfers = [{
   timestamp: 0n,
 }];
 
-const transfer_errors = await client.createTransfers(batch);
-for (const error of transfer_errors) {
-  switch (error.result) {
-    case CreateTransferError.exists:
-      console.error(`Batch transfer at ${error.index} already exists.`);
+const transfers_results = await client.createTransfers(batch);
+for (let i = 0; i < transfers_results.length; i++) {
+  switch (transfers_results[i].status) {
+    case CreateTransferStatus.created:
+      console.error(`Batch transfer at ${i} successfully created with timestamp ${transfers_results[i].timestamp}.`);
+      break;
+    case CreateTransferStatus.exists:
+      console.error(`Batch transfer at ${i} already exists with timestamp ${transfers_results[i].timestamp}.`);
       break;
     default:
-      console.error(
-        `Batch transfer at ${error.index} failed to create: ${
-          CreateTransferError[error.result]
-        }.`,
-      );
+      console.error(`Batch transfer at ${i} failed to create: ${transfers_results[i].status}`);
+      break;
   }
 }
 ```
@@ -380,32 +385,26 @@ the `CreateTransferError` object for a human-readable string.
 
 TigerBeetle performance is maximized when you batch
 API requests.
+
 A client instance shared across multiple threads/tasks can automatically
 batch concurrent requests, but the application must still send as many events
 as possible in a single call.
+
 For example, if you insert 1 million transfers sequentially, one at a time,
 the insert rate will be a *fraction* of the potential, because the client will
 wait for a reply between each one.
-
-```javascript
-const batch = []; // Array of transfer to create.
-for (let i = 0; i < batch.len; i++) {
-  const transfer_errors = await client.createTransfers(batch[i]);
-  // Error handling omitted.
-}
-```
-
 Instead, **always batch as much as you can**.
+
 The maximum batch size is set in the TigerBeetle server. The default is 8189.
 
 ```javascript
 const batch = []; // Array of transfer to create.
 const BATCH_SIZE = 8189;
 for (let i = 0; i < batch.length; i += BATCH_SIZE) {
-  const transfer_errors = await client.createTransfers(
+  const transfers_results = await client.createTransfers(
     batch.slice(i, Math.min(batch.length, BATCH_SIZE)),
   );
-  // Error handling omitted.
+  // Results handling omitted.
 }
 ```
 
@@ -467,8 +466,8 @@ const transfer1 = {
 };
 
 // Create the transfer
-const transfer_errors = await client.createTransfers([transfer0, transfer1]);
-// Error handling omitted.
+const transfers_results = await client.createTransfers([transfer0, transfer1]);
+// Results handling omitted.
 ```
 
 ### Two-Phase Transfers
@@ -504,8 +503,8 @@ const transfer0 = {
   timestamp: 0n,
 };
 
-let transfer_errors = await client.createTransfers([transfer0]);
-// Error handling omitted.
+let transfers_results = await client.createTransfers([transfer0]);
+// Results handling omitted.
 
 const transfer1 = {
   id: 7n,
@@ -524,8 +523,8 @@ const transfer1 = {
   timestamp: 0n,
 };
 
-transfer_errors = await client.createTransfers([transfer1]);
-// Error handling omitted.
+transfers_results = await client.createTransfers([transfer1]);
+// Results handling omitted.
 ```
 
 #### Void a Pending Transfer
@@ -553,8 +552,8 @@ const transfer0 = {
   timestamp: 0n,
 };
 
-let transfer_errors = await client.createTransfers([transfer0]);
-// Error handling omitted.
+let transfers_results = await client.createTransfers([transfer0]);
+// Results handling omitted.
 
 const transfer1 = {
   id: 9n,
@@ -572,8 +571,8 @@ const transfer1 = {
   timestamp: 0n,
 };
 
-transfer_errors = await client.createTransfers([transfer1]);
-// Error handling omitted.
+transfers_results = await client.createTransfers([transfer1]);
+// Results handling omitted.
 ```
 
 ## Transfer Lookup
@@ -752,8 +751,8 @@ batch.push({ id: 3n, /* ..., */ flags: 0 });
 batch.push({ id: 3n, /* ..., */ flags: linkedFlag });
 batch.push({ id: 4n, /* ..., */ flags: 0 });
 
-const transfer_errors = await client.createTransfers(batch);
-// Error handling omitted.
+const transfers_results = await client.createTransfers(batch);
+// Results handling omitted.
 ```
 
 ## Imported Events
@@ -794,8 +793,8 @@ for (let index = 0; i < historical_accounts.length; i++) {
   accounts.push(account);
 }
 
-const account_errors = await client.createAccounts(accounts);
-// Error handling omitted.
+const account_results = await client.createAccounts(accounts);
+// Results handling omitted.
 
 // Then, load and import all transfers with their timestamps from the historical source.
 const transfers = [];
@@ -815,8 +814,8 @@ for (let index = 0; i < historical_transfers.length; i++) {
   transfers.push(transfer);
 }
 
-const transfer_errors = await client.createTransfers(transfers);
-// Error handling omitted.
+const transfers_results = await client.createTransfers(transfers);
+// Results handling omitted.
 
 // Since it is a linked chain, in case of any error the entire batch is rolled back and can be retried
 // with the same historical timestamps without regressing the cluster timestamp.

package/dist/benchmark.js

@@ -99,16 +99,16 @@ const runBenchmark = async () => {
     const start = Date.now();
     for (let i = 0; i < transfers.length; i++) {
         const ms1 = Date.now();
-        const transferErrors = await client.createTransfers(transfers[i]);
-        (0, assert_1.default)(transferErrors.length === 0);
+        const transferResults = await client.createTransfers(transfers[i]);
+        (0, assert_1.default)(transferResults.length === transfers[i].length);
         const ms2 = Date.now();
         const createTransferLatency = ms2 - ms1;
         if (createTransferLatency > maxCreateTransfersLatency) {
             maxCreateTransfersLatency = createTransferLatency;
         }
         if (IS_TWO_PHASE_TRANSFER) {
-            const commitErrors = await client.createTransfers(posts[i]);
-            (0, assert_1.default)(commitErrors.length === 0);
+            const postTransferResults = await client.createTransfers(posts[i]);
+            (0, assert_1.default)(postTransferResults.length === posts[i].length);
             const ms3 = Date.now();
             const commitTransferLatency = ms3 - ms2;
             if (commitTransferLatency > maxCommitTransfersLatency) {

package/dist/benchmark.js.map

@@ -1 +1 @@
-{"version":3,"file":"benchmark.js","sourceRoot":"","sources":["../src/benchmark.ts"],"names":[],"mappings":"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","sourcesContent":["import assert from 'assert'\nimport {\n  Account,\n  createClient,\n  Transfer,\n  TransferFlags,\n} from '.'\n\nconst MAX_TRANSFERS = 51200\n// CI runs benchmark.ts against a \"--development\" replica.\nconst MAX_REQUEST_BATCH_SIZE = 253\nconst IS_TWO_PHASE_TRANSFER = false\n\nconst client = createClient({\n  cluster_id: 0n,\n  replica_addresses: [process.env.TB_ADDRESS || '3000']\n})\n\nconst TRANSFER_SIZE = 128\nconst accountA: Account = {\n  id: 137n,\n  debits_pending: 0n,\n  debits_posted: 0n,\n  credits_pending: 0n,\n  credits_posted: 0n,\n  user_data_128: 0n,\n  user_data_64: 0n,\n  user_data_32: 0,\n  reserved: 0,\n  ledger: 1,\n  code: 1,\n  flags: 0,\n  timestamp: 0n,\n}\n\nconst accountB: Account = {\n  id: 138n,\n  debits_pending: 0n,\n  debits_posted: 0n,\n  credits_pending: 0n,\n  credits_posted: 0n,\n  user_data_128: 0n,\n  user_data_64: 0n,\n  user_data_32: 0,\n  reserved: 0,\n  ledger: 1,\n  code: 1,\n  flags: 0,\n  timestamp: 0n,\n}\n\nconst runBenchmark = async () => {\n  console.log(`pre-allocating ${MAX_TRANSFERS} transfers and posts...`)\n  const transfers: Transfer[][] = []\n  const posts: Transfer[][] = []\n\n  let count = 0\n  while (count < MAX_TRANSFERS) {\n    const pendingBatch: Transfer[] = []\n    const postBatch: Transfer[] = []\n    for (let i = 0; i < MAX_REQUEST_BATCH_SIZE; i++) {\n      if (count === MAX_TRANSFERS) break\n\n      count += 1\n      pendingBatch.push({\n        id: BigInt(count),\n        debit_account_id: accountA.id,\n        credit_account_id: accountB.id,\n        amount: 1n,\n        pending_id: 0n,\n        user_data_128: 0n,\n        user_data_64: 0n,\n        user_data_32: 0,\n        timeout: IS_TWO_PHASE_TRANSFER ? 2 : 0,\n        code: 1,\n        ledger: 1,\n        flags: IS_TWO_PHASE_TRANSFER ? TransferFlags.pending : 0,\n        timestamp: 0n,\n      })\n\n      if (IS_TWO_PHASE_TRANSFER) {\n        postBatch.push({\n          id: BigInt(MAX_TRANSFERS + count),\n          debit_account_id: accountA.id,\n          credit_account_id: accountB.id,\n          amount: 1n,\n          pending_id: BigInt(count),\n          user_data_128: 0n,\n          user_data_64: 0n,\n          user_data_32: 0,\n          timeout: 0,\n          code: 1,\n          ledger: 1,\n          flags: IS_TWO_PHASE_TRANSFER ? TransferFlags.post_pending_transfer : 0,\n          timestamp: 0n,\n        })\n      }\n    }\n\n    transfers.push(pendingBatch)\n    if (IS_TWO_PHASE_TRANSFER) posts.push(postBatch)\n  }\n  assert(count === MAX_TRANSFERS)\n\n  console.log(`starting benchmark. MAX_TRANSFERS=${MAX_TRANSFERS} REQUEST_BATCH_SIZE=${MAX_REQUEST_BATCH_SIZE} NUMBER_OF_BATCHES=${transfers.length}`)\n  let maxCreateTransfersLatency = 0\n  let maxCommitTransfersLatency = 0\n  const start = Date.now()\n\n  for (let i = 0; i < transfers.length; i++) {\n    const ms1 = Date.now()\n\n    const transferErrors = await client.createTransfers(transfers[i])\n    assert(transferErrors.length === 0)\n\n    const ms2 = Date.now()\n    const createTransferLatency = ms2 - ms1\n    if (createTransferLatency > maxCreateTransfersLatency) {\n      maxCreateTransfersLatency = createTransferLatency\n    }\n\n    if (IS_TWO_PHASE_TRANSFER) {\n      const commitErrors = await client.createTransfers(posts[i])\n      assert(commitErrors.length === 0)\n\n      const ms3 = Date.now()\n      const commitTransferLatency = ms3 - ms2\n      if (commitTransferLatency > maxCommitTransfersLatency) {\n        maxCommitTransfersLatency = commitTransferLatency\n      }\n    }\n  }\n\n  const ms = Date.now() - start\n\n  return {\n    ms,\n    maxCommitTransfersLatency,\n    maxCreateTransfersLatency\n  }\n}\n\nconst main = async () => {\n  console.log(\"creating the accounts...\")\n  await client.createAccounts([accountA, accountB])\n  const accountResults = await client.lookupAccounts([accountA.id, accountB.id])\n  assert(accountResults.length === 2)\n  assert(accountResults[0].debits_posted === 0n)\n  assert(accountResults[1].debits_posted === 0n)\n\n  const benchmark = await runBenchmark()\n\n  const accounts = await client.lookupAccounts([accountA.id, accountB.id])\n  const result = Math.floor((1000 * MAX_TRANSFERS)/benchmark.ms)\n  console.log(\"=============================\")\n  console.log(`${IS_TWO_PHASE_TRANSFER ? 'two-phase ' : ''}transfers per second: ${result}`)\n  console.log(`create transfers max p100 latency per 10 000 transfers = ${benchmark.maxCreateTransfersLatency}ms`)\n  console.log(`commit transfers max p100 latency per 10 000 transfers = ${benchmark.maxCommitTransfersLatency}ms`)\n  assert(accounts.length === 2)\n  assert(accounts[0].debits_posted === BigInt(MAX_TRANSFERS))\n  assert(accounts[1].credits_posted === BigInt(MAX_TRANSFERS))\n}\n\nmain().catch(error => {\n  console.log(error)\n}).finally(async () => {\n  await client.destroy()\n})\n"]}
+{"version":3,"file":"benchmark.js","sourceRoot":"","sources":["../src/benchmark.ts"],"names":[],"mappings":"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","sourcesContent":["import assert from 'assert'\nimport {\n  Account,\n  createClient,\n  Transfer,\n  TransferFlags,\n} from '.'\n\nconst MAX_TRANSFERS = 51200\n// CI runs benchmark.ts against a \"--development\" replica.\nconst MAX_REQUEST_BATCH_SIZE = 253\nconst IS_TWO_PHASE_TRANSFER = false\n\nconst client = createClient({\n  cluster_id: 0n,\n  replica_addresses: [process.env.TB_ADDRESS || '3000']\n})\n\nconst TRANSFER_SIZE = 128\nconst accountA: Account = {\n  id: 137n,\n  debits_pending: 0n,\n  debits_posted: 0n,\n  credits_pending: 0n,\n  credits_posted: 0n,\n  user_data_128: 0n,\n  user_data_64: 0n,\n  user_data_32: 0,\n  reserved: 0,\n  ledger: 1,\n  code: 1,\n  flags: 0,\n  timestamp: 0n,\n}\n\nconst accountB: Account = {\n  id: 138n,\n  debits_pending: 0n,\n  debits_posted: 0n,\n  credits_pending: 0n,\n  credits_posted: 0n,\n  user_data_128: 0n,\n  user_data_64: 0n,\n  user_data_32: 0,\n  reserved: 0,\n  ledger: 1,\n  code: 1,\n  flags: 0,\n  timestamp: 0n,\n}\n\nconst runBenchmark = async () => {\n  console.log(`pre-allocating ${MAX_TRANSFERS} transfers and posts...`)\n  const transfers: Transfer[][] = []\n  const posts: Transfer[][] = []\n\n  let count = 0\n  while (count < MAX_TRANSFERS) {\n    const pendingBatch: Transfer[] = []\n    const postBatch: Transfer[] = []\n    for (let i = 0; i < MAX_REQUEST_BATCH_SIZE; i++) {\n      if (count === MAX_TRANSFERS) break\n\n      count += 1\n      pendingBatch.push({\n        id: BigInt(count),\n        debit_account_id: accountA.id,\n        credit_account_id: accountB.id,\n        amount: 1n,\n        pending_id: 0n,\n        user_data_128: 0n,\n        user_data_64: 0n,\n        user_data_32: 0,\n        timeout: IS_TWO_PHASE_TRANSFER ? 2 : 0,\n        code: 1,\n        ledger: 1,\n        flags: IS_TWO_PHASE_TRANSFER ? TransferFlags.pending : 0,\n        timestamp: 0n,\n      })\n\n      if (IS_TWO_PHASE_TRANSFER) {\n        postBatch.push({\n          id: BigInt(MAX_TRANSFERS + count),\n          debit_account_id: accountA.id,\n          credit_account_id: accountB.id,\n          amount: 1n,\n          pending_id: BigInt(count),\n          user_data_128: 0n,\n          user_data_64: 0n,\n          user_data_32: 0,\n          timeout: 0,\n          code: 1,\n          ledger: 1,\n          flags: IS_TWO_PHASE_TRANSFER ? TransferFlags.post_pending_transfer : 0,\n          timestamp: 0n,\n        })\n      }\n    }\n\n    transfers.push(pendingBatch)\n    if (IS_TWO_PHASE_TRANSFER) posts.push(postBatch)\n  }\n  assert(count === MAX_TRANSFERS)\n\n  console.log(`starting benchmark. MAX_TRANSFERS=${MAX_TRANSFERS} REQUEST_BATCH_SIZE=${MAX_REQUEST_BATCH_SIZE} NUMBER_OF_BATCHES=${transfers.length}`)\n  let maxCreateTransfersLatency = 0\n  let maxCommitTransfersLatency = 0\n  const start = Date.now()\n\n  for (let i = 0; i < transfers.length; i++) {\n    const ms1 = Date.now()\n\n    const transferResults = await client.createTransfers(transfers[i])\n    assert(transferResults.length === transfers[i].length)\n\n    const ms2 = Date.now()\n    const createTransferLatency = ms2 - ms1\n    if (createTransferLatency > maxCreateTransfersLatency) {\n      maxCreateTransfersLatency = createTransferLatency\n    }\n\n    if (IS_TWO_PHASE_TRANSFER) {\n      const postTransferResults = await client.createTransfers(posts[i])\n      assert(postTransferResults.length === posts[i].length)\n\n      const ms3 = Date.now()\n      const commitTransferLatency = ms3 - ms2\n      if (commitTransferLatency > maxCommitTransfersLatency) {\n        maxCommitTransfersLatency = commitTransferLatency\n      }\n    }\n  }\n\n  const ms = Date.now() - start\n\n  return {\n    ms,\n    maxCommitTransfersLatency,\n    maxCreateTransfersLatency\n  }\n}\n\nconst main = async () => {\n  console.log(\"creating the accounts...\")\n  await client.createAccounts([accountA, accountB])\n  const accountResults = await client.lookupAccounts([accountA.id, accountB.id])\n  assert(accountResults.length === 2)\n  assert(accountResults[0].debits_posted === 0n)\n  assert(accountResults[1].debits_posted === 0n)\n\n  const benchmark = await runBenchmark()\n\n  const accounts = await client.lookupAccounts([accountA.id, accountB.id])\n  const result = Math.floor((1000 * MAX_TRANSFERS)/benchmark.ms)\n  console.log(\"=============================\")\n  console.log(`${IS_TWO_PHASE_TRANSFER ? 'two-phase ' : ''}transfers per second: ${result}`)\n  console.log(`create transfers max p100 latency per 10 000 transfers = ${benchmark.maxCreateTransfersLatency}ms`)\n  console.log(`commit transfers max p100 latency per 10 000 transfers = ${benchmark.maxCommitTransfersLatency}ms`)\n  assert(accounts.length === 2)\n  assert(accounts[0].debits_posted === BigInt(MAX_TRANSFERS))\n  assert(accounts[1].credits_posted === BigInt(MAX_TRANSFERS))\n}\n\nmain().catch(error => {\n  console.log(error)\n}).finally(async () => {\n  await client.destroy()\n})\n"]}

package/dist/bindings.d.ts

@@ -59,8 +59,8 @@ export type Transfer = {
     flags: number;
     timestamp: bigint;
 };
-export declare enum CreateAccountError {
-    ok = 0,
+export declare enum CreateAccountStatus {
+    created = 4294967295,
     linked_event_failed = 1,
     linked_event_chain_open = 2,
     imported_event_expected = 22,
@@ -88,8 +88,8 @@ export declare enum CreateAccountError {
     code_must_not_be_zero = 14,
     imported_event_timestamp_must_not_regress = 26
 }
-export declare enum CreateTransferError {
-    ok = 0,
+export declare enum CreateTransferStatus {
+    created = 4294967295,
     linked_event_failed = 1,
     linked_event_chain_open = 2,
     imported_event_expected = 56,
@@ -158,13 +158,13 @@ export declare enum CreateTransferError {
     exceeds_credits = 54,
     exceeds_debits = 55
 }
-export type CreateAccountsError = {
-    index: number;
-    result: CreateAccountError;
+export type CreateAccountResult = {
+    timestamp: bigint;
+    status: CreateAccountStatus;
 };
-export type CreateTransfersError = {
-    index: number;
-    result: CreateTransferError;
+export type CreateTransferResult = {
+    timestamp: bigint;
+    status: CreateTransferStatus;
 };
 export type AccountFilter = {
     account_id: bigint;
@@ -198,12 +198,12 @@ export type AccountBalance = {
 export declare enum Operation {
     pulse = 128,
     get_change_events = 137,
-    create_accounts = 138,
-    create_transfers = 139,
     lookup_accounts = 140,
     lookup_transfers = 141,
     get_account_transfers = 142,
     get_account_balances = 143,
     query_accounts = 144,
-    query_transfers = 145
+    query_transfers = 145,
+    create_accounts = 146,
+    create_transfers = 147
 }