createDocumentIfNotExists 🆕

Create a document if not exists.

Signature

MySQL

createDocumentIfNotExists(session: MySQLSession, values: Partial<IDocument<S>>): Promise<IDocument<S>>;

MySQLX

createDocumentIfNotExists(session: MySQLXSession, values: Partial<IDocument<S>>): Promise<IDocument<S>>;

Example

MySQL

// employeeRouter.{ts|js}
import { employeeController } from './employeeController';
import { CRUDMySQL } from 'crud-node';
import { employeeSchema } from './schemas/employee';

// Executes operations in a single transaction
const transacted = true;
const employeeController = new CRUDMySQL(db, employeeSchema);

await db.usingSession(async (session) => {
  const payload = {
    email: '[e-mail]',
    firstName: 'Leslie',
    lastName: 'Brett',
  };
  const data = await employeeController.createDocumentIfNotExists(session, payload);
  return data;
}, transacted);

MySQLX

// employeeRouter.{ts|js}
import { employeeController } from './employeeController';
import { CRUDMySQLX } from 'crud-node';
import { employeeSchema } from './schemas/employee';

// Executes operations in a single transaction
const transacted = true;
const employeeController = new CRUDMySQLX(db, employeeSchema);

await db.usingSession(async (session) => {
  const payload = {
    email: '[e-mail]',
    firstName: 'Leslie',
    lastName: 'Brett',
  };
  const data = await employeeController.createDocumentIfNotExists(session, payload);
  return data;
}, transacted);