Parse.com REST API Client for Node.js

0.3.8 · abandoned · verified Tue Apr 21

This `node-parse-api` library serves as a Node.js client for the Parse.com REST API, offering functionalities like data insertion, user management (login, registration), file uploads, and querying objects. At version 0.3.8, it reflects an early period of Node.js and the Parse.com platform. A critical aspect of this package is its tight coupling to the original Parse.com hosted service, which was officially shut down in January 2017. Consequently, while the package itself is available, its primary utility for connecting to `api.parse.com` is obsolete. There is no indication of active development or a release cadence, and it is likely abandoned, primarily existing as historical reference for developers who might have used the original Parse.com platform. Its design predates modern JavaScript module systems, relying exclusively on CommonJS.

Common errors

```
Error: connect ECONNREFUSED
```
cause The application is attempting to connect to `api.parse.com` which is no longer active, or a misconfigured self-hosted Parse Server is unreachable.

fix This library is designed for the defunct Parse.com service. If attempting to connect to a self-hosted Parse Server, this specific library might not be suitable or require internal modifications (e.g., `Parse._api_host`). Consider using the official `@parse/node` or `parse` npm packages instead.
```
TypeError: app.insert is not a function
```
cause The `Parse` object was not correctly instantiated as a client instance, or the imported `Parse` object is not the expected constructor.

fix Ensure you are instantiating the `Parse` client correctly after requiring it: `const { Parse } = require('node-parse-api'); const app = new Parse(APP_ID, MASTER_KEY);`
```
Cannot find module 'node-parse-api'
```
cause The package has not been installed or is not correctly linked in the project.

fix Run `npm install node-parse-api` to add the package to your project dependencies.

Warnings

breaking The Parse.com hosted service, which this library directly targets (`api.parse.com`), was officially shut down on January 28, 2017. This package is **not functional** for its original purpose of connecting to the cloud-hosted Parse.com backend.
Fix: This package is effectively obsolete for its original purpose. Developers should migrate to an alternative Parse Server client (e.g., the official `parse` npm package which targets self-hosted Parse Server instances) or a completely different backend solution.
gotcha This package is not actively maintained. It was last published almost a decade ago and targets very old Node.js runtimes (specified as `>= 0.4.0`). Using it with modern Node.js versions may lead to unexpected behavior, compatibility issues, or security vulnerabilities due to unpatched dependencies.
Fix: Avoid using this package in new projects. For historical projects, a full migration to a modern Parse SDK or another backend is strongly recommended.
gotcha The library explicitly uses CommonJS `require()` syntax. It does not natively support ES Modules (`import`) and attempting to use `import { Parse } from 'node-parse-api';` in an ESM-only context will result in a runtime error.
Fix: Ensure your project is configured for CommonJS, or use `const { Parse } = require('node-parse-api');` in a context where CommonJS interoperability is supported.

Install

npm install node-parse-api npm
yarn add node-parse-api yarn
pnpm add node-parse-api pnpm

Imports

Parse
wrong:
```
import { Parse } from 'node-parse-api';
```
correct:
```
const { Parse } = require('node-parse-api');
```
This package exports a named 'Parse' property from its main module. It is CommonJS only and does not support ES Modules directly.
ParseClient (instance)
wrong:
```
const ParseClient = new require('node-parse-api').Parse(APP_ID, MASTER_KEY);
```
correct:
```
const ParseClient = new Parse(APP_ID, MASTER_KEY);
```
The 'Parse' constructor should be used after being destructured from the `require` call for cleaner syntax and to avoid re-requiring the module.

Quickstart

Initializes the Parse API client with an App ID and Master Key and demonstrates inserting a new object into a Parse class. Note: This library targets the now-defunct Parse.com service.

const { Parse } = require('node-parse-api');

const APP_ID = process.env.PARSE_APP_ID ?? '';
const MASTER_KEY = process.env.PARSE_MASTER_KEY ?? '';

// Ensure environment variables are set or replace with actual values (not recommended for production)
if (!APP_ID || !MASTER_KEY) {
  console.error('PARSE_APP_ID and PARSE_MASTER_KEY environment variables must be set.');
  process.exit(1);
}

const app = new Parse(APP_ID, MASTER_KEY);

// Insert an object into a 'Foo' class
app.insert('Foo', { foo: 'bar', timestamp: new Date() }, function (err, response) {
  if (err) {
    console.error('Error inserting object:', err);
    return;
  }
  console.log('Successfully inserted object:', response);
  // A real application would typically have more operations here.
  // Given Parse.com is shut down, this example is primarily illustrative.
});

view raw JSON →