The FirefallClient library offers a streamlined way to interact with the Firefall API, enabling applications to fetch insights, recommendations, and codes based on provided prompts. Designed with simplicity and efficiency in mind, this client handles all aspects of communication with the Firefall API, including request authentication, error handling, and response parsing.

To use the FirefallClient, you need to configure it with the following parameters:

• FIREFALL_API_ENDPOINT: The endpoint URL for the Firefall API.
• FIREFALL_API_KEY: Your API key for accessing the Firefall API.
• FIREFALL_API_CAPABILITY_NAME: The capability name for the Firefall API.

These parameters can be set through environment variables or passed directly to the FirefallClient.createFrom method.

Additionally, the configuration for the @adobe/spacecat-shared-ims-client library is required to fetch the service access token from the IMS API:

• IMS_HOST: The hostname of the IMS API.
• IMS_CLIENT_ID: Your IMS client ID.
• IMS_CLIENT_CODE: Your IMS client code, used for authentication.
• IMS_CLIENT_SECRET: Your IMS client secret, used for authentication.

import FirefallClient from 'path/to/firefall-client';

// Assuming environment variables are set
const context = {
  env: process.env,
  log: console, // Using console for logging in this example
};

try {
  const client = FirefallClient.createFrom(context);
  console.log('FirefallClient created successfully.');
} catch (error) {
  console.error('Error creating FirefallClient:', error.message);
}

async function fetchInsights(prompt) {
  try {
    const client = FirefallClient.createFrom({
      env: {
        FIREFALL_API_ENDPOINT: 'https://api.firefall.example.com',
        FIREFALL_API_KEY: 'yourApiKey',
        FIREFALL_API_CAPABILITY_NAME: 'yourCapabilityName',
        IMS_HOST: 'ims.example.com',
        IMS_CLIENT_ID: 'yourClientId',
        IMS_CLIENT_CODE: 'yourClientCode',
        IMS_CLIENT_SECRET: 'yourClientSecret',
      },
      log: console,
    });

    const insights = await client.fetch(prompt);
    console.log('Insights:', insights);
  } catch (error) {
    console.error('Failed to fetch insights:', error.message);
  }
}

fetchInsights('How can we improve customer satisfaction?');

Ensure that you replace 'path/to/firefall-client' with the actual path to the FirefallClient class in your project and adjust the configuration parameters according to your Firefall API credentials.

To run tests:

npm test

Lint your code:

npm run lint

To remove node_modules and package-lock.json:

npm run clean

• Repository: GitHub
• Issue Tracking: GitHub Issues
• License: Apache-2.0