# ember-data-fork

> The default blueprint for ember-cli addons.

Latest version **0.0.17** (published 2022-10-17) · MIT license · 0 weekly downloads

## Install

```sh
npm install ember-data-fork
pnpm add ember-data-fork
yarn add ember-data-fork
bun add ember-data-fork
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.17 |
| Published | 2022-10-17 |
| First published | 2019-07-31 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | 12.* \|\| 14.* \|\| >= 16 |
| Dependencies | 3 |
| Unpacked size | 12.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | jembezmamy |
| Keywords | ember-addon |

## Links

- npm: https://www.npmjs.com/package/ember-data-fork
- npm.io page: https://npm.io/package/ember-data-fork

## Dependencies (3)

- [ember-cli-babel](https://npm.io/package/ember-cli-babel.md) ^7.26.10
- [ember-cli-htmlbars](https://npm.io/package/ember-cli-htmlbars.md) ^5.7.2
- [ember-deep-buffered-proxy](https://npm.io/package/ember-deep-buffered-proxy.md) ^0.0.10

## Recent versions

- 0.0.17 (latest) — 2022-10-17
- 0.0.16 — 2022-10-05
- 0.0.15 — 2022-06-29
- 0.0.14 — 2022-06-29
- 0.0.13 — 2022-05-23
- 0.0.12 — 2021-06-21
- 0.0.11 — 2021-03-08
- 0.0.10 — 2020-11-04
- 0.0.9 — 2020-04-18
- 0.0.8 — 2019-11-05
- 0.0.7 — 2019-11-04
- 0.0.6 — 2019-10-23
- 0.0.5 — 2019-09-04
- 0.0.4 — 2019-08-14
- 0.0.3 — 2019-08-09
- … 3 more at https://npm.io/package/ember-data-fork/versions

## README

Ember Data Fork
==============================================================================

[![Build Status](https://travis-ci.org/nibynic/ember-data-fork.svg?branch=master)](https://travis-ci.org/nibynic/ember-data-fork)
[![Maintainability](https://api.codeclimate.com/v1/badges/73f9b98e8181fbe1bf60/maintainability)](https://codeclimate.com/github/nibynic/ember-data-fork/maintainability)
[![npm version](https://badge.fury.io/js/ember-data-fork.svg)](https://badge.fury.io/js/ember-data-fork)

Track Ember Data model changes, accept or reject them with a simple fork interface.


Compatibility
------------------------------------------------------------------------------

* Ember.js v3.24 or above
* Ember CLI v3.24 or above
* Node.js v12 or above


Installation
------------------------------------------------------------------------------

```
ember install ember-data-fork
```


Usage
------------------------------------------------------------------------------

Just call `fork()` on your model and then use the returned fork in the same way as
you would use Ember Data models.

```javascript
import { fork } from 'ember-data-fork';

let model = this.store.findRecord('person', 1);
let myFork = fork(model);

myFork.set('firstName', 'Lenny');
myFork.children.addObject(
  this.store.createRecord('person', {
    firstName: 'Oliver'
  })
);

myFork.isDirty; // true

// now you can:
myFork.rollback(); // reset to the initial state
myFork.apply(); // apply changes on the model
myFork.save(); // apply changes and save all changed models
```

### Saving data

When you call `save()` on the fork, it will collect all modified models and save
them in a sequence (starting from the deepest levels of nesting).
If any of these saves fails, Ember Data Fork will try to revert models and fork
to the state from before the save.

### Deleting records

You can call `deleteRecord()` on a fork. This won't delete source model until you
call `save()` on the fork.

```javascript
import { fork } from 'ember-data-fork';

let model = this.store.findRecord('person', 1);
let myFork = fork(model);

myFork.deleteRecord();

myFork.isDeleted; // true
model.isDeleted; // false

myFork.save();

model.isDeleted; // true
```

To revert unsaved deletion just call `rollbackDelete()`.

```javascript
import { fork } from 'ember-data-fork';

let model = this.store.findRecord('person', 1);
let myFork = fork(model);

myFork.deleteRecord();

myFork.isDeleted; // true
model.isDeleted; // false

myFork.rollbackDelete();

myFork.isDeleted; // false
model.isDeleted; // false
```

Contributing
------------------------------------------------------------------------------

See the [Contributing](CONTRIBUTING.md) guide for details.


License
------------------------------------------------------------------------------

This project is licensed under the [MIT License](LICENSE.md).

---
_Source: https://npm.io/package/ember-data-fork · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
