Version 1.1.0

🚀 Version 1.1.0 - Release Notes

We're excited to announce version 1.1.0 of the MakeImpact JavaScript SDK! This release introduces powerful new tracking capabilities and enhancements to help you monitor the complete lifecycle of your environmental impacts.

🆕 What's New in v1.1.0

🔍 Impact Tracking API

The headline feature of this release is the new Track API that provides real-time visibility into the entire lifecycle of your environmental impacts.

Key Capabilities:

• Real-time Status Updates: Monitor impacts from initiation through completion
• Project Location & Maps: Get geographic details with embedded Google Maps URLs
• Agent Assignment: See which organization or agent is executing your impact
• Impact Documentation: Access videos and photos of your completed impacts
• Live Session Access: Join scheduled live sessions to see your impact in action
• Donation Flow Tracking: Monitor when donations are received and sent to projects
• Test Transaction Detection: Easily identify sandbox/test transactions

Example Usage:

// Create an impact
const plantResponse = await sdk.plantTree({ amount: 1 });

// Track its complete lifecycle
const trackingInfo = await sdk.track({
  userID: plantResponse.userID,
  timeUTC: plantResponse.timeUTC,
});

console.log(`Tracking ID: ${trackingInfo.trackingID}`);
console.log(`Status: ${trackingInfo.impactCompleted ? 'Completed' : 'In Progress'}`);
console.log(`Location: ${trackingInfo.projectLocation}`);
console.log(`View Map: ${trackingInfo.locationMap}`);

Tracking Response Fields:

• trackingID - Unique identifier for this specific impact
• impactInitiated - Timestamp when impact was created
• Impact metrics: treePlanted, wasteRemoved, carbonCaptured, moneyDonated
• assignedAgent - Organization executing the impact
• projectLocation - Detailed location description
• locationMap - Google Maps embed URL
• impactCompleted - Completion timestamp
• impactVideo - URL to impact documentation video
• liveSessionDate - Scheduled live session timestamp
• donationAvailable / donationSent - Donation flow timestamps

📧 Email Notification Control

Added notify parameter to all impact creation methods, giving you control over customer email confirmations.

// Disable email notification
await sdk.plantTree({ 
  amount: 1, 
  customerEmail: "user@example.com",
  notify: false // Customer won't receive email
});

// Enable email notification (default behavior)
await sdk.plantTree({ 
  amount: 1, 
  customerEmail: "user@example.com",
  notify: true
});

Note: Email notifications are always disabled in the sandbox environment regardless of this setting.

✨ Features

Environmental Impact Actions

• Plant Trees: Support reforestation efforts via simple API calls
• Clean Ocean: Remove ocean waste with automated contributions
• Capture Carbon: Offset carbon emissions seamlessly
• Donate Money: Fund causes with direct donations

Data Access & Reporting

• Retrieve Records: Query historical impact activity
• Customer Tracking: Link impact to individual users or accounts
• Impact Summaries: View total contributions across categories

Configuration & Integration

• Sandbox & Production Support: Test safely before going live
• Typed Parameters (TypeScript): Autocomplete & type safety out of the box
• Built-in Error Handling: Standardized error messages and codes

🔧 Technical Details

• ES Modules and CommonJS compatible
• Written in TypeScript, works in JavaScript too
• Tree-shakeable for optimized bundling
• Zero external dependencies
• Works in Node.js, Vite, Webpack, or modern frontend stacks

📚 Documentation

Refer to the README.md for full documentation and code examples covering all supported API features.

🎯 Getting Started

import { OneClickImpact, Environment } from "makeimpact";

// Initialize the SDK with your API key
const sdk = new OneClickImpact("your_api_key");

// Plant a tree
const response = await sdk.plantTree({ amount: 1 });
console.log(`Successfully planted ${response.treePlanted} tree(s)!`);

Full Changelog: v1.0.1...v1.1.0

Version 1.0.1

🚀 Version 1.0.1 - Release

We're excited to announce the first official release of the MakeImpact JavaScript SDK! This package allows developers to easily integrate environmental impact actions into web apps, servers, or any JavaScript-based workflows.

✨ Features

Environmental Impact Actions

• Plant Trees: Support reforestation efforts via simple API calls
• Clean Ocean: Remove ocean waste with automated contributions
• Capture Carbon: Offset carbon emissions seamlessly
• Donate Money: Fund causes with direct donations

Data Access & Reporting

• Retrieve Records: Query historical impact activity
• Customer Tracking: Link impact to individual users or accounts
• Impact Summaries: View total contributions across categories

Configuration & Integration

• Sandbox & Production Support: Test safely before going live
• Typed Parameters (TypeScript): Autocomplete & type safety out of the box
• Built-in Error Handling: Standardized error messages and codes

🔧 Technical Details

• ES Modules and CommonJS compatible
• Written in TypeScript, works in JavaScript too
• Tree-shakeable for optimized bundling
• Zero external dependencies
• Works in Node.js, Vite, Webpack, or modern frontend stacks

📚 Documentation

Refer to the README.md for full documentation and code examples covering all supported API features.

🎯 Getting Started

import { OneClickImpact, Environment } from "makeimpact";

// Initialize the SDK with your API key
const sdk = new OneClickImpact("your_api_key");

// Plant a tree
const response = await sdk.plantTree({ amount: 1 });
console.log(`Successfully planted ${response.treePlanted} tree(s)!`);