Delete

Node Removal

To Simply delete an instance relations:

• Pass the instance you want to delete to FrostApi.delete().
• The second parameter is DisconnectOptions. It defaults to "all", So it disconnects all relations unless you supply an empty map {} or a specific map you require. for more details Check the Disconnect Section

src/index.ts

import { User } from "src/data/user"
import { Profile } from "src/data/profile"
import { FrostApp } from "src/data/frost"

...

const { id: userId } = (await FrostApp.users.delete(user))

Disconnect

This is similar to Disconnect in the Update Section. So you don't have to re-read it if you're already familiar with it. The only difference is that here it defaults to "all"

To Specify the relations you want to disconnect along with the delete, all you have to do is:

• When you pass the instance to the delete function, pass a second parameter of the type DisconnectOptions
  • The possible values for DisconnectOptions are:
  • The string "all", this will disconnect all relations
  • A map between:
    • [property name with the relation you want to connect]
    • and one of the following options:
    • The string "all" or the boolean true to disconnect all connected instances in the selected relations (e.g: { posts: 'all', profile: true })
    • ID(s) of the instance(s) you want to disconnect (e.g: { posts: ['...','...',...], profile: "..." })

caution

If the property name in the DisconnectOptions map is referring to a property with an array type (ie; many). then the value should be an array of the ids. otherwise (ie; One) then the value can be a single string.

Please check out DisconnectOptions, it contains more detailed examples.

info

Reminder: The second parameter (disconnect options) defaults to "all"

src/index.ts

import { User } from "src/data/user"import { Profile } from "src/data/profile"import { Post } from "src/data/post"import { FrostApp } from "src/data/frost"const user = (await FrostApp.users.find(userId))// Example 1: this will disconnect all relationsawait FrostApp.users.delete(user)//Orawait FrostApp.users.delete(user,"all")// Example 2: this will disconnect nothingawait FrostApp.users.delete(user,{})// Example 3: this will disconnect all posts and profilesawait FrostApp.users.delete(user,{ posts: "all", profile: true})// Example 4: this will disconnect the specific posts in the list and the single profileawait FrostApp.users.delete(user,{ posts: ["...","...",...], profile: "..."})