npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

iso-finance-js

v0.0.5

Published

Financial module for node, angular and Javascript

Downloads

6

Readme

node-finance

node-finance is a Node module that provides basic finance methods. node-finance is implemented where it can be used synchronously or asynchronously. To use it asynchronously, pass in a callback at the end of a function.

FUNCTIONS

PVofLumpSum

Calculates the present value of a lump sum received in the future. Arguments include:

  • rate (required) - the interest rate per period
  • NPER (required) - total number of periods
  • FV (optional) - the future value or lump sum to be received

PV

Calculates the present value of an investment resulting from a series of regular payments. Arguments include:

  • rate (required) - the interest rate per period
  • NPER (required) - total number of payment periods
  • PMT (required) the regular payment made each period
  • type (optional) - wether payments made 0 - at the end of each period or 1 - at the start of each period (including a payment at the start of the term)

PVofPerpetuity

Calculates the present value of an investment with an unlimited number of regular payments. Arguments include:

  • rate (required) - the interest rate per period
  • NPER (required) - total number of payment periods
  • PMT (required) the regular payment made each period

CumulativeInterestPaid

Calculate the total interest paid on a loan in specified periodic payments. Arguments include:

  • rate (required) - interest rate specified as a percentage, e.g., 10.5
  • periods (required) - the total number of payment periods in the term
  • pv (required) - the initial sum borrowed
  • start (optional) - the first period to include. Periods are numbered beginning with 1
  • end (optional) - the last period to include
  • type (optional) - when payments are made:
    • 0 - at the end of each period
    • 1 - at the start of each period (including a payment at the start of the term)
  • callback (optional) - callback for asynchronous processing using Node's CommonJS format

FV

Calculates future value of an investment based on equal periodic payments. Arugments include:

  • rate (required) - the periodic interest rate
  • NPER (required) - the number of periods
  • PMT (required) - the equal periodic payments
  • type (optional) - whether the payment is due at the beginning (1) or the end (0) of a period

NPER

Caculates the number of periods for an investment based on periodic, constant payments and a constant interest rate. Arguments include:

  • rate (required) - the periodic interest rate
  • PMT (required) - the constant payment paid in each period
  • FV (required) - the future value of the last period
  • type (optional) - whether the payment is due at the beginning (1) or the end (0) of a period

PMT

Calculates the payment for a loan with the following parameters.

  • PV is loan amount
  • NPER is the number of periods
  • rate is the rate per period
  • type (optional) - whether the payment is due at the beginning (1) or the end (0) of a period

GenAmortizationSchedule

This function generates an amortization schedule. The schedule is returned as a Javascript object.

The function accepts the following arguments:

  • amount (required): the starting principal amount of the loan
  • months (required): the number of whole months over which the loan extends
  • rate (required): the annual interest rate of the loan expressed as a percentage, e.g., 10.5
  • firstPaymentDate (optional): the date the first payment will be made
  • frequency (optional): the payment frequency, which can be any of the following: semimonthly - twice a month monthly - once each month bimonthly - every two months quarterly - every quarter semiannually - ever 6 months annually - ever 12 months none or one - only one payment at the end of the loan - typically don't mix this with balloonDate
  • balloonDate (optional): the date a balloon payment will be made. This date will be forced to earliest corresponding payment date. This date will be ignored if it is greater than the term (months) of the loan.

The return object contains an array, with each array element containing the following fields:

  • paymentNumber - the number for a payment
  • principle: the principal balance remaining at the end of the period
  • accumulatedInterest: the interest accumulate from all previous periods through this period
  • payment: the periodic payment the borrower is required to pay
  • paymentToPrinciple: the amount of the payment allocated to paying down the principal
  • paymentToInterest: the amount of the payment allocated to paying interest
  • date: the date of the payment for the period

Payments

Calculates the number of payments for a loan. This is different than NPER. NPER calculates the number of periods used in an annuity or loan from a financial perspective. This function looks at how frequently a customer chooses to make payments. This function has the following arguments: * NPER (required) - the number of periods used in calculating interest for a loan * frequency (optional): the payment frequency, which can be any of the following: - semimonthly - twice a month - monthly - once each month - bimonthly - every two months - quarterly - every quarter - semiannually - ever 6 months - annually - ever 12 months - none or one - only one payment at the end of the loan - typically don't mix this with balloonDate