Merge branch 'master' into st/docs/add-cache-utxo-to-provider-section

.changeset/chilly-dolphins-call.md

@@ -0,0 +1,2 @@
+---
+---

.changeset/four-seas-stare.md

@@ -0,0 +1,5 @@
+---
+"fuels": minor
+---
+
+feat!: separate `onSuccess` events for the Fuels CLI

.changeset/stale-crabs-shop.md

@@ -0,0 +1,4 @@
+---
+---
+
+chore: add the triage label for new issues

.changeset/wild-maps-build.md

@@ -0,0 +1,6 @@
+---
+"@fuel-ts/utils": patch
+"@fuel-ts/account": patch
+---
+
+fix: sync chain config schema

.github/ISSUE_TEMPLATE/bug.yaml

@@ -1,7 +1,6 @@
 name: 🐛 Bug Report
 description: Something is wrong with fuels-ts.
-labels:
-  - "bug"
+labels: ["bug", "triage"]
 body:
   - type: markdown
     attributes:

.github/ISSUE_TEMPLATE/feature.yaml

@@ -1,6 +1,6 @@
 name: 🚀 Feature request
 description: Suggest an idea for this project.
-labels: ["enhancement"]
+labels: ["enhancement", "triage"]
 body:
   - type: textarea
     attributes:

.github/workflows/test.yaml

@@ -66,7 +66,7 @@ jobs:
         run: sh ./scripts/tests-ui.sh
 
       - name: Wait for release to succeed
-        if: github.ref_name == 'master' || github.head_ref == 'changesets-release/master'
+        if: github.ref_name == 'master' || github.head_ref == 'changeset-release/master'
         uses: lewagon/[email protected]
         with:
           ref: "refs/heads/master"
@@ -75,13 +75,13 @@ jobs:
           wait-interval: 30
 
       - name: Run tests (with published version)
-        if: github.ref_name == 'master' || github.head_ref == 'changesets-release/master'
+        if: github.ref_name == 'master' || github.head_ref == 'changeset-release/master'
         run: pnpm test:integration
         env:
           PUBLISHED_NPM_TAG: next
 
       - name: Run UI tests (with published version)
-        if: github.ref_name == 'master' || github.head_ref == 'changesets-release/master'
+        if: github.ref_name == 'master' || github.head_ref == 'changeset-release/master'
         run: sh ./scripts/tests-ui-integration.sh
         env:
           PUBLISHED_NPM_TAG: next

apps/demo-fuels/fuels.config.full.ts

@@ -1,6 +1,6 @@
 /* eslint-disable no-console */
 import { createConfig } from 'fuels';
-import type { CommandEvent, ContractDeployOptions, FuelsConfig } from 'fuels';
+import type { ContractDeployOptions, DeployedContract, FuelsConfig } from 'fuels';
 
 const MY_FIRST_DEPLOYED_CONTRACT_NAME = '';
 
@@ -84,15 +84,35 @@ export default createConfig({
   },
   // #endregion deployConfig-fn
 
-  // #region onSuccess
-  onSuccess: (event: CommandEvent, config: FuelsConfig) => {
-    console.log('fuels:onSuccess', { event, config });
+  // #region onBuild
+  onBuild: (config: FuelsConfig) => {
+    console.log('fuels:onBuild', { config });
   },
-  // #endregion onSuccess
+  // #endregion onBuild
+
+  // #region onDeploy
+  // #import { DeployedContract, FuelsConfig };
+
+  onDeploy: (config: FuelsConfig, data: DeployedContract[]) => {
+    console.log('fuels:onDeploy', { config, data });
+  },
+  // #endregion onDeploy
+
+  // #region onDev
+  onDev: (config: FuelsConfig) => {
+    console.log('fuels:onDev', { config });
+  },
+  // #endregion onDev
+
+  // #region onNode
+  onNode: (config: FuelsConfig) => {
+    console.log('fuels:onNode', { config });
+  },
+  // #endregion onNode
 
   // #region onFailure
-  onFailure: (error: Error, config: FuelsConfig) => {
-    console.log('fuels:onFailure', { error, config });
+  onFailure: (config: FuelsConfig, error: Error) => {
+    console.log('fuels:onFailure', { config, error });
   },
   // #endregion onFailure
 

apps/docs/src/guide/fuels-cli/config-file.md

@@ -121,25 +121,55 @@ Or use a function for crafting dynamic deployment flows:
 
 <<< @../../../demo-fuels/fuels.config.full.ts#deployConfig-fn{ts:line-numbers}
 
-## `onSuccess`
+## `onBuild`
 
-Pass a callback function to be called after a successful run.
+A callback function that is called after a build event has been successful.
 
 Parameters:
 
-- `event` — The event that triggered this execution
 - `config` — The loaded config (`fuels.config.ts`)
 
-<<< @../../../demo-fuels/fuels.config.full.ts#onSuccess{ts:line-numbers}
+<<< @../../../demo-fuels/fuels.config.full.ts#onBuild{ts:line-numbers}
+
+## `onDeploy`
+
+A callback function that is called after a deployment event has been successful.
+
+Parameters:
+
+- `config` — The loaded config (`fuels.config.ts`)
+- `data` — The data (an array of deployed contracts)
+
+<<< @../../../demo-fuels/fuels.config.full.ts#onDeploy{ts:line-numbers}
+
+## `onDev`
+
+A callback function that is called after the [`fuels dev`](./commands.md#fuels-dev) command has successfully restarted.
+
+Parameters:
+
+- `config` — The loaded config (`fuels.config.ts`)
+
+<<< @../../../demo-fuels/fuels.config.full.ts#onDev{ts:line-numbers}
+
+## `onNode`
+
+A callback function that is called after the [`fuels node`](./commands.md#fuels-node) command has successfully refreshed.
+
+Parameters:
+
+- `config` — The loaded config (`fuels.config.ts`)
+
+<<< @../../../demo-fuels/fuels.config.full.ts#onNode{ts:line-numbers}
 
 ## `onFailure`
 
 Pass a callback function to be called in case of errors.
 
 Parameters:
 
-- `error` — Original error object
 - `config` — The loaded config (`fuels.config.ts`)
+- `error` — Original error object
 
 <<< @../../../demo-fuels/fuels.config.full.ts#onFailure{ts:line-numbers}
 

packages/account/src/providers/fuel-core-schema.graphql

@@ -442,6 +442,8 @@ type GasCosts {
   xor: U64!
   xori: U64!
   alocDependentCost: DependentCost!
+  cfe: DependentCost!
+  cfeiDependentCost: DependentCost!
   call: DependentCost!
   ccp: DependentCost!
   croo: DependentCost!

packages/account/src/providers/operations.graphql

@@ -398,6 +398,12 @@ fragment GasCostsFragment on GasCosts {
   alocDependentCost {
     ...DependentCostFragment
   }
+  cfe {
+    ...DependentCostFragment
+  }
+  cfeiDependentCost {
+    ...DependentCostFragment
+  }
   call {
     ...DependentCostFragment
   }

packages/account/test/fixtures/chain.ts

@@ -140,9 +140,19 @@ export const MOCK_CHAIN: GqlChainInfoFragment = {
       xor: '1',
       xori: '1',
       alocDependentCost: {
-        type: 'LightOperation',
+        type: 'HeavyOperation',
         base: '2',
-        unitsPerGas: '214',
+        gasPerUnit: '0',
+      },
+      cfe: {
+        type: 'HeavyOperation',
+        base: '2',
+        gasPerUnit: '0',
+      },
+      cfeiDependentCost: {
+        type: 'HeavyOperation',
+        base: '2',
+        gasPerUnit: '0',
       },
       call: {
         type: 'LightOperation',

packages/fuels/src/cli/commands/build/index.test.ts

@@ -0,0 +1,48 @@
+import { fuelsConfig } from '../../../../test/fixtures/fuels.config';
+import { mockLogger } from '../../../../test/utils/mockLogger';
+
+import { build } from '.';
+import * as buildSwayProgramsMod from './buildSwayPrograms';
+import * as generateTypesMod from './generateTypes';
+
+/**
+ * @group node
+ */
+describe('build', () => {
+  const mockAll = () => {
+    const { log } = mockLogger();
+
+    const onBuild = vi.fn();
+
+    const buildSwayPrograms = vi
+      .spyOn(buildSwayProgramsMod, 'buildSwayPrograms')
+      .mockResolvedValue();
+    const generateTypes = vi.spyOn(generateTypesMod, 'generateTypes').mockResolvedValue();
+
+    return {
+      onBuild,
+      log,
+      buildSwayPrograms,
+      generateTypes,
+    };
+  };
+
+  test('should build sway programs and generate types', async () => {
+    const { log, buildSwayPrograms, generateTypes } = mockAll();
+
+    await build(fuelsConfig);
+
+    expect(log).toHaveBeenCalledWith('Building..');
+    expect(buildSwayPrograms).toHaveBeenCalled();
+    expect(generateTypes).toHaveBeenCalled();
+  });
+
+  test('should call onBuild callback', async () => {
+    const { onBuild } = mockAll();
+    const config = { ...fuelsConfig, onBuild };
+
+    await build(config);
+
+    expect(onBuild).toHaveBeenCalledWith(config);
+  });
+});

packages/fuels/src/cli/commands/build/index.ts

@@ -13,9 +13,9 @@ export async function build(config: FuelsConfig, program?: Command) {
 
   await buildSwayPrograms(config);
   await generateTypes(config);
+  config.onBuild?.(config);
 
   const options = program?.opts();
-
   if (options?.deploy) {
     const fuelCore = await autoStartFuelCore(config);
     await deploy(config);

packages/fuels/src/cli/commands/deploy/index.test.ts

@@ -0,0 +1,40 @@
+import type { Provider } from '@fuel-ts/account';
+import { Wallet } from '@fuel-ts/account';
+import { FUEL_NETWORK_URL } from '@fuel-ts/account/configs';
+
+import { fuelsConfig } from '../../../../test/fixtures/fuels.config';
+import type { DeployedContract } from '../../types';
+
+import { deploy } from '.';
+import * as createWalletMod from './createWallet';
+import * as saveContractIdsMod from './saveContractIds';
+
+/**
+ * @group node
+ */
+describe('deploy', () => {
+  const mockAll = () => {
+    const onDeploy = vi.fn();
+
+    const provider = { url: FUEL_NETWORK_URL } as Provider;
+    const wallet = Wallet.fromPrivateKey('0x01', provider);
+    const createWallet = vi.spyOn(createWalletMod, 'createWallet').mockResolvedValue(wallet);
+
+    vi.spyOn(saveContractIdsMod, 'saveContractIds').mockResolvedValue();
+
+    return {
+      onDeploy,
+      createWallet,
+    };
+  };
+
+  test('should call onDeploy callback', async () => {
+    const { onDeploy } = mockAll();
+    const expectedContracts: DeployedContract[] = [];
+    const config = { ...fuelsConfig, contracts: [], onDeploy };
+
+    await deploy(config);
+
+    expect(onDeploy).toHaveBeenCalledWith(config, expectedContracts);
+  });
+});

packages/fuels/src/cli/commands/deploy/index.ts

@@ -52,6 +52,7 @@ export async function deploy(config: FuelsConfig) {
   }
 
   await saveContractIds(contracts, config.output);
+  config.onDeploy?.(config, contracts);
 
   return contracts;
 }

packages/fuels/src/cli/commands/dev/index.test.ts

@@ -30,6 +30,7 @@ describe('dev', () => {
   function mockAll() {
     const { autoStartFuelCore, fuelCore, killChildProcess } = mockStartFuelCore();
 
+    const onDev = vi.fn();
     const onFailure = vi.fn();
 
     const withConfigErrorHandler = vi
@@ -50,6 +51,7 @@ describe('dev', () => {
       fuelCore,
       killChildProcess,
       loadConfig,
+      onDev,
       onFailure,
       withConfigErrorHandler,
     };
@@ -66,6 +68,15 @@ describe('dev', () => {
     expect(deploy).toHaveBeenCalledTimes(1);
   });
 
+  test('should call `onDev` callback on success', async () => {
+    const { onDev } = mockAll();
+    const config: FuelsConfig = { ...fuelsConfig, onDev };
+
+    await dev(config);
+
+    expect(onDev).toHaveBeenCalledWith(config);
+  });
+
   it('dev should handle and log error from `buildAndDeploy`', async () => {
     const { error } = mockLogger();
 

packages/fuels/src/cli/commands/dev/index.ts

@@ -3,7 +3,7 @@ import { watch } from 'chokidar';
 import { globSync } from 'glob';
 
 import { loadConfig } from '../../config/loadConfig';
-import type { FuelsConfig } from '../../types';
+import { type FuelsConfig } from '../../types';
 import { error, log } from '../../utils/logger';
 import { build } from '../build';
 import { deploy } from '../deploy';
@@ -18,7 +18,10 @@ export const closeAllFileHandlers = (handlers: FSWatcher[]) => {
 
 export const buildAndDeploy = async (config: FuelsConfig) => {
   await build(config);
-  return deploy(config);
+  const deployedContracts = await deploy(config);
+  config.onDev?.(config);
+
+  return deployedContracts;
 };
 
 export const getConfigFilepathsToWatch = (config: FuelsConfig) => {