@pingleware/bestbooks-core
Advanced tools
The core component for BestBooks Accounting Application Framework
Description for @pingleware/bestbooks-core:
@pingleware/bestbooks-core is the foundation of the BestBooks Accounting Framework, providing essential tools and utilities to build robust, extensible accounting applications. Designed with developers in mind, this core library simplifies the creation of accounting features such as general ledger management, transaction tracking, and financial reporting.
Key Features:
Perfect for developers looking to create modern accounting solutions, @pingleware/bestbooks-core empowers you to build scalable and customizable financial software with ease.
To install @pingleware/bestbooks-core, use npm:
npm install @pingleware/bestbooks-core
Here's a quick example to get you started:
const { Ledger } = require('@pingleware/bestbooks-core');
// Create a new ledger
const ledger = new Ledger();
// Add accounts
ledger.addAccount('Cash', 'Asset');
ledger.addAccount('Revenue', 'Income');
// Record a transaction
ledger.recordTransaction({
date: '2024-12-10',
description: 'Service Revenue',
debit: { account: 'Cash', amount: 1000 },
credit: { account: 'Revenue', amount: 1000 },
});
// Display the ledger
console.log(ledger.getAccounts());
For detailed documentation, visit the BestBooks Documentation.
We welcome contributions! Please read our Contributing Guide for details on how to get involved.
This project is licensed under the CC-BY-4.0 License. See the LICENSE file for details.
If you have any questions or need assistance, visit support
TDD will be utilized during the development and maintenance, using the mocha test framework. A good example of use cases can be found in each test. Execution delays have been added in the tests to compensate for latency in the database updates and response.
You can run the entire test suite using the command,
npm test
or an individual test script by using the command,
npm test test/TEST_SCRIPT_FILENAME.test.js
mocha [spec..]
Run tests with Mocha
Commands
mocha inspect [spec..] Run tests with Mocha [default]
mocha init <path> create a client-side Mocha setup at <path>
Rules & Behavior
--allow-uncaught Allow uncaught errors to propagate [boolean]
-A, --async-only Require all tests to use a callback (async)
or return a Promise [boolean]
-b, --bail Abort ("bail") after first test failure
[boolean]
--check-leaks Check for global variable leaks [boolean]
--delay Delay initial execution of root suite
[boolean]
--dry-run Report tests without executing them[boolean]
--exit Force Mocha to quit after tests complete
[boolean]
--pass-on-failing-test-suite Not fail test run if tests were failed
[boolean] [default: false]
--fail-zero Fail test run if no test(s) encountered
[boolean]
--forbid-only Fail if exclusive test(s) encountered
[boolean]
--forbid-pending Fail if pending test(s) encountered[boolean]
--global, --globals List of allowed global variables [array]
-j, --jobs Number of concurrent jobs for --parallel;
use 1 to run in serial
[number] [default: (number of CPU cores - 1)]
-p, --parallel Run tests in parallel [boolean]
--retries Retry failed tests this many times [number]
-s, --slow Specify "slow" test threshold (in
milliseconds) [string] [default: 75]
-t, --timeout, --timeouts Specify test timeout threshold (in
milliseconds) [string] [default: 2000]
-u, --ui Specify user interface
[string] [default: "bdd"]
Reporting & Output
-c, --color, --colors Force-enable color output [boolean]
--diff Show diff on failure
[boolean] [default: true]
--full-trace Display full stack traces [boolean]
--inline-diffs Display actual/expected differences
inline within each string [boolean]
-R, --reporter Specify reporter to use
[string] [default: "spec"]
-O, --reporter-option, Reporter-specific options
--reporter-options (<k=v,[k1=v1,..]>) [array]
Configuration
--config Path to config file [string] [default: (nearest rc file)]
-n, --node-option Node or V8 option (no leading "--") [array]
--package Path to package.json for config [string]
File Handling
--extension File extension(s) to load
[array] [default: ["js","cjs","mjs"]]
--file Specify file(s) to be loaded prior to root suite
execution [array] [default: (none)]
--ignore, --exclude Ignore file(s) or glob pattern(s)
[array] [default: (none)]
--recursive Look for tests in subdirectories [boolean]
-r, --require Require module [array] [default: (none)]
-S, --sort Sort test files [boolean]
-w, --watch Watch files in the current working directory for
changes [boolean]
--watch-files List of paths or globs to watch [array]
--watch-ignore List of paths or globs to exclude from watching
[array] [default: ["node_modules",".git"]]
Test Filters
-f, --fgrep Only run tests containing this string [string]
-g, --grep Only run tests matching this string or regexp [string]
-i, --invert Inverts --grep and --fgrep matches [boolean]
Positional Arguments
spec One or more files, directories, or globs to test
[array] [default: ["test"]]
Other Options
-h, --help Show usage information & exit [boolean]
-V, --version Show version number & exit [boolean]
--list-interfaces List built-in user interfaces & exit [boolean]
--list-reporters List built-in reporters & exit [boolean]
Mocha Resources
Chat: https://discord.gg/KeDn2uXhER
GitHub: https://github.com/mochajs/mocha.git
Docs: https://mochajs.org/
The BestBooks packages prefix the name with @pingleware, for PressPage Entertainment Inc DBA PINGLEWARE which is the branded operations responsible for IT development.
When Chairman Gensler testified at the House Financial Services Committee, he was ask a question to define Ether, see at https://www.coindesk.com/video/sec-chair-gensler-refuses-to-say-if-ether-is-a-security-during-house-hearing/, he could not define whether ether is a commodity or security, according to then Professor Gensler at MIT Blockchain course (https://ocw.mit.edu/courses/15-s12-blockchain-and-money-fall-2018/), Professor Gensler explains that both Bitcoin and Ether are not securiies but a unit of account.
Actually Ether like Bitcoin, like Cash is neither a commodity or security. Ether like Bitcoin and Cash and all other foreign currency denominations is a unit of account and is consider a liquid asset like Cash on the balance sheet.
Hence, Digital Currency is derived as a Cash asset for which Bitcoin and Ether is derived from DigitalCurrency class.
The log file is named bestbooks.log and resides in the system directory identified as .bestbooks located in the home directory. On a Mac, to view dot directories, open finder and and press CTRL-CMD-. (the dot or period key). Toggle this key combination will toggle the view of the dot directories
There are three levels of logging
| Level | Description | Example |
|---|---|---|
| warn | For warning, non-critical messages | 2024-04-06T09:42:55.628Z [WARN] {} |
| info | For informational messages | 2024-04-06T09:42:55.586Z [INFO] INSERT OR IGNORE INTO ledger (company_id,office_id,account_name,account_code,txdate,note,credit,balance) VALUES (0,0,'Google Adsense Revenue',(SELECT code FROM accounts WHERE name='Google Adsense Revenue'),'2013-05-27','Service Adjustment','71.12',(SELECT IIF(SUM(debit)-SUM(credit),SUM(debit)-SUM(credit)+71.12,71.12) FROM ledger WHERE account_name='Google Adsense Revenue')); |
| error | For critical messages | 2024-04-06T09:42:55.628Z [ERROR] {} |
| cat | For consolidated audit trail | 2024-04-06T09:42:55.628Z [CAT] {} |
| For mail messages | 2024-04-06T09:42:55.628Z [MAIL] {} |
Creating a chart of accounts in accordance with GAAP is the first step towards GAAP complaince and including entries for FOREX trading to create operational budgets as well as digital currencies
1100 - Current Assets
1110 - Cash and Cash Equivalents
1111 - Petty Cash
1112 - Checking Account
1113 - Savings Account
1114 - Money Market Account
1115 - FOREX Trading Accounts
1120 - Digital Currencies
1130 - Accounts Receivable
1140 - Inventory
1150 - Prepaid Expenses
1160 - Other Current Assets
1200 - Non-Current Assets
1210 - Property, Plant, and Equipment (PP&E)
1220 - Intangible Assets
1230 - Long-term Investments
1240 - Other Non-Current Assets
1242 - Long-term FOREX Investments
1250 - Other Non-Current Assets
2100 - Current Liabilities
2110 - Accounts Payable
2120 - Short-term Debt
2130 - Accrued Liabilities
2140 - Deferred Revenue (current)
2150 - Other Current Liabilities
2200 - Non-Current Liabilities
4100 - Sales Revenue
4200 - Other Revenue
The Disclosures table holds crucial financial information that must comply with regulatory and accounting standards. It is designed to track the company's public disclosures related to financial statements, which are required for audits, SEC filings, and general financial transparency.
Disclosures TableTracking Financial Disclosures Compliance
The primary use case for the Disclosures table is to ensure that financial disclosures (such as income statements, balance sheets, and cash flow statements) are compliant with applicable standards like GAAP, GAAS, and SEC regulations.
Example:
The company must disclose the financial health of the company by publishing a Cash Flow Statement. The table tracks whether the disclosure was made on time, whether it's compliant, and if any issues were found (like missing notes or improper methodology).
Disclosure Record:
{
"name": "Cash Flow Statement",
"description": "Cash Flow Statement for FY 2023",
"is_compliant": 1,
"date_disclosed": "2023-01-15",
"compliance_note": "Compliant"
}
Monitoring Non-Compliant Disclosures
Identifying and monitoring disclosures that have failed to comply with the necessary accounting or regulatory standards is critical for audits and assessments.
Example:
If an Income Statement lacks proper notes on revenue recognition, the audit team may flag this as non-compliant, and the company will be required to correct it before final approval.
Non-compliant Disclosure Record:
{
"name": "Income Statement",
"description": "Income Statement for FY 2023",
"is_compliant": 0,
"date_disclosed": "2023-03-01",
"compliance_note": "Methodology not disclosed"
}
Reporting on Disclosure History
The Disclosures table can provide a historical record of all financial statements and other disclosures the company has made over a period of time. This helps auditors and regulatory bodies to review the company’s compliance with financial reporting over time.
Example:
The audit team retrieves all financial disclosures made by the company over the last five years to confirm continuous compliance.
Historical Disclosure Records:
[
{
"name": "Balance Sheet",
"description": "Balance Sheet for FY 2022",
"is_compliant": 1,
"date_disclosed": "2022-03-01",
"compliance_note": "Compliant"
},
{
"name": "Income Statement",
"description": "Income Statement for FY 2022",
"is_compliant": 1,
"date_disclosed": "2022-03-01",
"compliance_note": "Compliant"
}
]
Generating Compliance Reports for Audits
The disclosures data can be used to generate detailed reports for external audits, including management and public audit reports. These reports indicate whether the company is in compliance with disclosure requirements, pinpointing areas of improvement.
Example:
A Management Audit Report is generated, summarizing which disclosures were compliant and which required corrective actions.
Audit Report Example:
{
"total_disclosures": 10,
"compliant_disclosures": 9,
"non_compliant_disclosures": 1,
"non_compliant_details": [
{
"disclosure": "Income Statement",
"compliance_note": "Methodology not disclosed"
}
]
}
Ensuring Timeliness of Disclosures
The Disclosures table allows tracking the timeliness of financial disclosures, which is important for SEC reporting deadlines. Late filings can lead to penalties or regulatory scrutiny.
Example:
The Balance Sheet for Q2 is supposed to be disclosed by the end of the quarter. If it is delayed beyond the disclosure deadline, the company may face penalties.
Late Disclosure Record:
{
"name": "Balance Sheet",
"description": "Balance Sheet for Q2 2023",
"is_compliant": 0,
"date_disclosed": "2023-07-15",
"compliance_note": "Late submission"
}
Tracking Disclosure Corrections
Companies may need to revise their disclosures if auditors or regulators find errors. Tracking when disclosures were corrected helps maintain an audit trail.
Example:
The Cash Flow Statement initially failed to disclose a cash outflow correctly. After a revision, it was marked as compliant.
Corrected Disclosure Record:
{
"name": "Cash Flow Statement",
"description": "Revised Cash Flow Statement for FY 2023",
"is_compliant": 1,
"date_disclosed": "2023-04-01",
"compliance_note": "Revised disclosure"
}
Tracking Key Financial Metrics and Their Presentation
Ensure that key financial metrics such as earnings per share (EPS), total assets, liabilities, and cash flows are properly disclosed and are consistent across the disclosures.
Example:
The company's Equity Statement must include the proper breakdown of share transactions and equity changes. If some key equity metrics are omitted, it would be considered non-compliant.
Equity Statement Disclosure:
{
"name": "Equity Statement",
"description": "Equity Statement for FY 2023",
"is_compliant": 1,
"date_disclosed": "2023-01-15",
"compliance_note": "Includes EPS, dividends, and other changes in equity"
}
Ensuring Compliance with Regulatory Changes
As regulations evolve, the company must ensure that disclosures are updated to reflect new accounting standards or regulatory requirements.
Example:
New SEC regulations may require additional disclosure of Related Party Transactions. The Disclosures table tracks whether this new requirement has been implemented.
Related Party Transaction Disclosure:
{
"name": "Related Party Transactions",
"description": "Disclosures of transactions with related parties for FY 2023",
"is_compliant": 1,
"date_disclosed": "2023-01-15",
"compliance_note": "Compliant with new SEC regulations"
}
Support for Public Disclosure Reporting
The Disclosures table is also useful for generating Public Disclosure Audit Reports, which summarize the financial information made available to investors and the public, ensuring transparency and accountability.
Example:
A Public Disclosure Report is generated to confirm that all mandatory filings have been made and publicly disclosed by the company in accordance with SEC regulations.
Public Disclosure Report Example:
{
"total_disclosures": 12,
"compliant_disclosures": 11,
"non_compliant_disclosures": 1,
"non_compliant_details": [
{
"disclosure": "Income Statement",
"compliance_note": "Disclosure methodology missing"
}
],
"date": "2023-12-31"
}
These use cases are essential for maintaining financial transparency, ensuring regulatory compliance, and assisting in internal and external audits.
The Conservatism Principle should be applied and potentially updated when a ledger transaction is added, based on the type and certainty of the transaction. The principle specifically requires that:
Expenses and Liabilities:
These are to be recorded as soon as they are probable, even if the exact amount is uncertain. Therefore, when any transaction classified as an expense or liability is added to the ledger, it should be immediately flagged as "conservative." Revenues and Assets:
These should only be recorded when they are certain. When a transaction classified as revenue or an asset is added, it should be flagged as "non-conservative" unless there is a high level of certainty regarding the transaction. In practical terms, when a new transaction is added to the ledger, the system should evaluate the nature of the transaction and apply or update the conservatism flag based on this logic.
When to Update Conservatism in the Ledger Expenses and Liabilities should be updated and flagged immediately when they are recorded in the ledger (e.g., estimated costs, potential legal settlements, contingent liabilities).
Revenues and Assets should be deferred or marked as uncertain until they are realized or certain (e.g., expected future sales, unrealized asset gains).
Process to Update Conservatism Principle on Ledger Transactions Evaluate Transaction Type:
If the transaction is an expense or liability, the conservatism principle should immediately flag it as conservative. If the transaction is revenue or asset, it should be flagged as non-conservative until certainty is achieved (i.e., confirmation of actual receipt or asset ownership). Update the Transaction Record:
The transaction should be inserted into the ledger with the corresponding conservatism flag (is_conservative) based on the evaluation.
The Going Concern Assumption in accounting is the assumption that a company will continue to operate in the foreseeable future and not be forced to halt its operations or liquidate its assets. In an audit or financial assessment, this principle is crucial because it affects the valuation of assets, liabilities, and other financial items.
The logic for this can be applied by monitoring specific financial indicators that could suggest that the company may no longer continue as a going concern. These indicators might include:
Financial Indicators:
[
{
"id": 1,
"indicator_name": "debt_to_equity_ratio",
"value": 4.5,
"threshold": 3.0,
"status": "critical",
"recorded_at": "2024-10-12"
},
{
"id": 2,
"indicator_name": "net_profit_margin",
"value": 0.1,
"threshold": 0.05,
"status": "normal",
"recorded_at": "2024-10-12"
}
]
Evaluate the Going Concern Assumption
{
"going_concern": true,
"message": "Company is operating as a going concern."
}
In accounting terms, COG (Cost of Goods) and SPROCKET don't directly relate, but we can reinterpret your question to address possible conceptual analogies or clarify their relevance in a financial or operational context.
In accounting, a sprocket might metaphorically represent operational components or processes that "drive" an organization's functionality—particularly those connected to supply chains or production processes. For instance:
| Aspect | COG (Cost of Goods) | Sprocket (Operational Analogy) |
|---|---|---|
| Focus | Financial measurement of production costs. | Operational or logistical cost drivers. |
| Role in Business | Calculates profitability of goods sold. | Drives supply chain efficiency and output. |
| Example Use | Raw material, labor costs. | Transportation, machinery maintenance. |
If you're asking about a specific accounting analogy or need further clarification, feel free to elaborate!
When a piece of software is useful there should never be an end-of-life doctrine. The goal of this software is to achieve immortality ;). When this software has reached that stage, this project may appear abandon but the opposit is true. This software (in release not alpha, beta or gamma) has achieve that state where maintenance is no longer required.
Patrick O. Ingle
FAQs
The core component for BestBooks Accounting Application Framework
The npm package @pingleware/bestbooks-core receives a total of 25 weekly downloads. As such, @pingleware/bestbooks-core popularity was classified as not popular.
We found that @pingleware/bestbooks-core demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Socket researchers uncover a malicious npm package posing as a tool for detecting vulnerabilities in Etherium smart contracts.
Security News
Research
A supply chain attack on Rspack's npm packages injected cryptomining malware, potentially impacting thousands of developers.
Research
Security News
Socket researchers discovered a malware campaign on npm delivering the Skuld infostealer via typosquatted packages, exposing sensitive data.