Method patch

packages/@stdlib/data/src/data-abstraction.ts:543–638

(
    prefix: DataPrefix_,
    suffix: string,
    model: Partial<InstanceType<Awaited<ReturnType<Model>>>>,
    params?: {
      cacheOnly?: boolean;

      trx?: TransactionOrKnex;
      dtrx?: DataTransaction;
    },
  )

  }

  async patch<
    DataPrefix_ extends DataPrefix,
    Model extends DataHashes_[DataPrefix_]['model'],
  >(
    prefix: DataPrefix_,
    suffix: string,
    model: Partial<InstanceType<Awaited<ReturnType<Model>>>>,
    params?: {
      cacheOnly?: boolean;

      trx?: TransactionOrKnex;
      dtrx?: DataTransaction;
    },
  ) {
    // Collect the extra columns of all fields affected

    const extraColumns = new Set<string>();

    await Promise.allSettled(
      Object.entries(this.dataHashes[prefix].fields).map(
        async ([_fieldName, fieldInfos]) => {
          let modelHasSomeFieldColumns = false;

          for (const column of fieldInfos.columns ?? []) {
            if (column in model) {
              modelHasSomeFieldColumns = true;
              break;
            }
          }

          if (modelHasSomeFieldColumns) {
            for (const column of fieldInfos.columns ?? []) {
              if (!(column in model)) {
                extraColumns.add(column);
              }
            }
          }
        },
      ),
    );

    if (!params?.cacheOnly) {
      let patchQuery: any = (await this.dataHashes[prefix].model())
        .query(params?.dtrx?.trx ?? params?.trx)
        .findById(splitStr(suffix, ':'))
        .patch(model);

      if (extraColumns.size > 0) {
        patchQuery = patchQuery.returning(Array.from(extraColumns));
      }

      model = { ...model, ...(await patchQuery) };
    } else if (extraColumns.size > 0) {
      model = {
        ...model,
        ...(await this.dataHashes[prefix].model())
          .query(params?.dtrx?.trx ?? params?.trx)
          .findById(splitStr(suffix, ':'))