@constl/bohr-db/src/nested.ts

Type-safe databases for OrbitDB.

import { Ajv, type ValidateFunction, type JSONSchemaType } from "ajv";
import {
  joinKey,
  splitKey,
  type NestedDatabaseType,
  asJoinedKey,
  type NestedValue,
} from "@orbitdb/nested-db";

import type {
  ExtractKeys,
  ExtractKeysAsList,
  GetValueFromKey,
  GetValueFromKeyList,
  GetValueFromNestedKey,
  RecursivePartial,
} from "./types.ts";
import {
  getJoinedKey,
  removeUndefinedProperties,
  type NoUndefinedField,
} from "./utils.ts";
import type { DagCborEncodable } from "@orbitdb/core";

export type TypedNested<T extends NestedValue> = Omit<
  NestedDatabaseType,
  "put" | "set" | "insert" | "del" | "get" | "move" | "all"
> & {
  insert(value: RecursivePartial<T>): Promise<string[]>;
  insert<K extends ExtractKeys<T>>(
    key: K,
    value: RecursivePartial<GetValueFromKey<T, K>>,
  ): Promise<string[]>;
  insert<K extends ExtractKeysAsList<T>>(
    key: K,
    value: RecursivePartial<GetValueFromKeyList<T, K>>,
  ): Promise<string[]>;

  put<K extends ExtractKeys<T>>(
    key: K,
    value: GetValueFromKey<T, K>,
  ): Promise<string[]>;
  put<K extends ExtractKeysAsList<T>>(
    key: K,
    value: GetValueFromKeyList<T, K>,
  ): Promise<string[]>;
  set: TypedNested<T>["put"];

  del<K extends ExtractKeys<T> | ExtractKeysAsList<T>>(key: K): Promise<string>;

  get<K extends ExtractKeys<T>>(
    key: K,
  ): Promise<GetValueFromKey<T, K> | undefined>;
  get<K extends ExtractKeysAsList<T>>(
    key: K,
  ): Promise<GetValueFromKeyList<T, K> | undefined>;

  all: () => Promise<RecursivePartial<T>>;
};

const nestedCache = new WeakMap<
  NestedDatabaseType,
  WeakMap<JSONSchemaType<unknown>, TypedNested<NestedValue>>
>();

export const typedNested = <T extends NestedValue>({
  db,
  schema,
}: {
  db: NestedDatabaseType;
  schema: JSONSchemaType<RecursivePartial<T>>;
}): TypedNested<T> => {
  let dbCache = nestedCache.get(db);
  if (dbCache) {
    const cached = dbCache.get(schema as JSONSchemaType<unknown>);
    if (cached) return cached as TypedNested<T>;
  } else {
    nestedCache.set(db, new WeakMap());
    dbCache = nestedCache.get(db);
  }
  const ajv = new Ajv({ allowUnionTypes: true });
  const rootValidator = ajv.compile<RecursivePartial<T>>(schema);

  const validators: { [key in ExtractKeys<T>]?: ValidateFunction } = {};
  const getValidator = <K extends ExtractKeys<T>>(
    key: K,
  ): ValidateFunction<GetValueFromKey<T, K>> => {
    let branchSchema = schema;
    for (const k of splitKey(key)) {
      if (branchSchema.additionalProperties === true) {
        validators[key] = (() => true) as unknown as ValidateFunction;
        break;
      }
      branchSchema =
        branchSchema.properties?.[k] || branchSchema.additionalProperties;
    }

    if (!validators[key]) {
      validators[key] = ajv.compile(branchSchema);
    }
    return validators[key] as ValidateFunction<GetValueFromKey<T, K>>;
  };

  const supportedKey = (
    key: string | string[],
  ): key is ExtractKeys<T> | ExtractKeysAsList<T> => {
    const keyComponents = typeof key === "string" ? splitKey(key) : key;
    let schemaBranch = schema;
    for (const k of keyComponents) {
      if (schemaBranch.additionalProperties) return true;
      // .? is necessary if schemaBranch does not have `properties`
      if (schemaBranch.properties?.[k] === undefined) return false;
      schemaBranch = schemaBranch.properties[k];
    }
    return true;
  };

  const proxy = new Proxy(db, {
    get(target, prop) {
      if (prop === "get") {
        const typedGet = async <
          K extends ExtractKeysAsList<T> | ExtractKeys<T>,
        >(
          key: K,
        ): Promise<GetValueFromNestedKey<T, K> | undefined> => {
          const joinedKey = (
            typeof key === "string"
              ? key
              : getJoinedKey(key as ExtractKeysAsList<T>)
          ) as ExtractKeys<T>;
          if (!supportedKey(key))
            throw new Error(`Unsupported key ${joinedKey}.`);

          const value = await target.get(key);
          const valueValidator = getValidator(joinedKey);
          if (valueValidator(value))
            return value as GetValueFromNestedKey<T, K>;
          return undefined;
        };
        return typedGet;
      } else if (prop === "del") {
        const typedDel: TypedNested<T>["del"] = async (...args) => {
          const [key] = args;
          const joinedKey = typeof key === "string" ? key : joinKey(key);
          if (!supportedKey(key))
            throw new Error(`Unsupported key ${joinedKey}.`);

          return target.del(key);
        };
        return typedDel;
      } else if (prop === "all") {
        const typedAll: TypedNested<T>["all"] = async () => {
          const jsonValue = await db.all();
          if (rootValidator(jsonValue)) {
            return jsonValue as unknown as RecursivePartial<T>;
          }
          throw new Error(JSON.stringify(rootValidator.errors, undefined, 2));
        };
        return typedAll;
      } else if (prop === "insert") {
        const typedInsert = async <
          K extends ExtractKeys<T> | ExtractKeysAsList<T> | RecursivePartial<T>,
        >(
          keyOrValue: K,
          value?: K extends ExtractKeys<T>
            ? GetValueFromKey<T, K>
            : K extends ExtractKeysAsList<T>
              ? GetValueFromKeyList<T, K>
              : undefined,
        ): Promise<string> => {
          if (typeof keyOrValue === "string" || Array.isArray(keyOrValue)) {
            const joinedKey = asJoinedKey(keyOrValue) as ExtractKeys<T>;

            if (!supportedKey(joinedKey))
              throw new Error(`Unsupported key ${joinedKey}.`);

            const valueValidator = getValidator(joinedKey);

            if (valueValidator(value)) {
              return await target.insert(
                joinedKey,
                value as unknown as NoUndefinedField<T>,
              );
            } else {
              throw new Error(
                JSON.stringify(valueValidator.errors, undefined, 2),
              );
            }
          } else {
            // @ts-expect-error types in progress
            const data = removeUndefinedProperties(keyOrValue);

            if (rootValidator(data)) {
              return await db.insert(data as unknown as NoUndefinedField<T>);
            } else {
              const firstError = rootValidator.errors?.[0];
              // Provide better error message
              if (
                firstError?.message?.includes(
                  "must NOT have additional properties",
                )
              ) {
                throw new Error(
                  `Unsupported key ${firstError.instancePath.replace(/^\//, "")}/${firstError.params.additionalProperty}.`,
                );
              }
              throw new Error(
                JSON.stringify(rootValidator.errors, undefined, 2),
              );
            }
          }
        };
        return typedInsert;
      } else if (prop === "set" || prop === "put") {
        const typedPut = async <
          K extends ExtractKeysAsList<T> | ExtractKeys<T>,
        >(
          key: K,
          value: GetValueFromNestedKey<T, K>,
        ): Promise<string> => {
          const joinedKey = (
            typeof key === "string"
              ? key
              : getJoinedKey(key as ExtractKeysAsList<T>)
          ) as ExtractKeys<T>;
          if (!supportedKey(key))
            throw new Error(`Unsupported key ${joinedKey}.`);

          const valueValidator = getValidator(joinedKey);
          if (valueValidator(value)) {
            return await target.put(
              joinedKey,
              value as { [key: string]: DagCborEncodable },
            );
          } else {
            throw new Error(
              JSON.stringify(valueValidator.errors, undefined, 2),
            );
          }
        };
        return typedPut;
      }

      return target[prop as keyof typeof target];
    },
  }) as unknown as TypedNested<T>;

  dbCache!.set(
    schema as JSONSchemaType<unknown>,
    proxy as TypedNested<NestedValue>,
  );
  return proxy;
};