Nymph.js 1.0.0-beta.113
    Preparing search index...

    The MySQL Nymph database driver.

    Hierarchy

    • default
      • MySQLDriver
    Index

    Constructors

    • Parameters

      • config: Partial<MySQLDriverConfig>
      • Optionallink: Pool
      • Optionaltransaction: MySQLDriverTransaction

      Returns MySQLDriver

    Properties

    connected: boolean = false
    entityCache: {
        [k: string]: {
            cdate: number;
            data: EntityData;
            mdate: number;
            sdata: SerializedEntityData;
            tags: string[];
        };
    }

    A cache to make entity retrieval faster.

    entityCount: { [k: string]: number }

    A counter for the entity cache to determine the most accessed entities.

    link: Pool
    nymph: Nymph
    prefix: string
    tokenizer: Tokenizer
    transaction: MySQLDriverTransaction | null = null

    Methods

    • Parameters

      • etype: string
      • definition: { name: string; property: string; scope: "tokens" | "data" | "references" }

      Returns Promise<boolean>

    • Parameters

      • etype: string
      • data: EntityData
      • sdata: SerializedEntityData
      • selectors: Selector[]
      • Optionalguid: string | null
      • Optionaltags: string[] | null

      Returns boolean

    • Parameters

      • name: string

      Returns void

    • Remove all copies of an entity from the cache.

      Parameters

      • guid: string

        The GUID of the entity to remove.

      Returns void

    • This is used internally by Nymph. Don't call it yourself.

      Returns MySQLDriver

      A clone of this instance.

    • Parameters

      • name: string

      Returns Promise<boolean>

    • Connect to the MySQL database.

      Returns Promise<true>

      Whether this instance is connected to a MySQL database.

    • Parameters

      • entity: EntityInterface

      Returns Promise<boolean>

    • Parameters

      • guid: string
      • OptionalclassName: string | EntityConstructor | null

      Returns Promise<boolean>

    • Parameters

      • etype: string
      • scope: "tokens" | "data" | "references"
      • name: string

      Returns Promise<boolean>

    • Parameters

      • name: string

      Returns Promise<boolean>

    • Disconnect from the MySQL database.

      Returns Promise<false>

      Whether this instance is connected to a MySQL database.

    • Search through a value for an entity reference.

      Parameters

      • value: any

        Any value to search.

      • entity:
            | string
            | EntityInterface
            | EntityReference
            | (string | EntityInterface | EntityReference)[]

        An entity, GUID, or array of either to search for.

      Returns boolean

      True if the reference is found, false otherwise.

    • Parameters

      • filename: string

      Returns Promise<boolean>

    • Returns AsyncGenerator<
          { content: string; type: "comment"
          | "uid"
          | "entity" },
          void,
          false | undefined,
      >

    • Returns Promise<boolean>

    • Parameters

      • svalue: string

      Returns string[]

    • Parameters

      • selectors: Selector[]
      • Optionaloptions: Options

      Returns { qrefs: [Options, ...FormattedSelector[]][]; selectors: FormattedSelector[] }

    • Type Parameters

      • T extends EntityConstructor = EntityConstructor

      Parameters

      • options: Options<T> & { return: "count" }
      • ...selectors: Selector[]

      Returns Promise<number>

    • Type Parameters

      • T extends EntityConstructor = EntityConstructor

      Parameters

      • options: Options<T> & { return: "guid" }
      • ...selectors: Selector[]

      Returns Promise<string[]>

    • Type Parameters

      • T extends EntityConstructor = EntityConstructor

      Parameters

      • options: Options<T> & { return: "object" }
      • ...selectors: Selector[]

      Returns Promise<EntityObjectType<T>[]>

    • Type Parameters

      • T extends EntityConstructor = EntityConstructor

      Parameters

      • Optionaloptions: Options<T>
      • ...selectors: Selector[]

      Returns Promise<EntityInstanceType<T>[]>

    • Type Parameters

      • T extends EntityConstructor = EntityConstructor

      Parameters

      • options: Options<T> & { return: "count" }
      • selectors: Selector[]
      • performQueryCallback: (
            data: {
                etype: string;
                options: Options<T>;
                selectors: FormattedSelector[];
            },
        ) => { result: any }
      • rowFetchCallback: () => any
      • freeResultCallback: () => void
      • getCountCallback: (row: any) => number
      • getGUIDCallback: (row: any) => string
      • getTagsAndDatesCallback: (row: any) => { cdate: number; mdate: number; tags: string[] }
      • getDataNameAndSValueCallback: (row: any) => { name: string; svalue: string }

      Returns { process: () => number | Error; result: any }

    • Type Parameters

      • T extends EntityConstructor = EntityConstructor

      Parameters

      • options: Options<T> & { return: "guid" }
      • selectors: Selector[]
      • performQueryCallback: (
            data: {
                etype: string;
                options: Options<T>;
                selectors: FormattedSelector[];
            },
        ) => { result: any }
      • rowFetchCallback: () => any
      • freeResultCallback: () => void
      • getCountCallback: (row: any) => number
      • getGUIDCallback: (row: any) => string
      • getTagsAndDatesCallback: (row: any) => { cdate: number; mdate: number; tags: string[] }
      • getDataNameAndSValueCallback: (row: any) => { name: string; svalue: string }

      Returns { process: () => Error | string[]; result: any }

    • Type Parameters

      • T extends EntityConstructor = EntityConstructor

      Parameters

      • options: Options<T> & { return: "object" }
      • selectors: Selector[]
      • performQueryCallback: (
            data: {
                etype: string;
                options: Options<T>;
                selectors: FormattedSelector[];
            },
        ) => { result: any }
      • rowFetchCallback: () => any
      • freeResultCallback: () => void
      • getCountCallback: (row: any) => number
      • getGUIDCallback: (row: any) => string
      • getTagsAndDatesCallback: (row: any) => { cdate: number; mdate: number; tags: string[] }
      • getDataNameAndSValueCallback: (row: any) => { name: string; svalue: string }

      Returns { process: () => Error | EntityObjectType<T>[]; result: any }

    • Type Parameters

      • T extends EntityConstructor = EntityConstructor

      Parameters

      • options: Options<T>
      • selectors: Selector[]
      • performQueryCallback: (
            data: {
                etype: string;
                options: Options<T>;
                selectors: FormattedSelector[];
            },
        ) => { result: any }
      • rowFetchCallback: () => any
      • freeResultCallback: () => void
      • getCountCallback: (row: any) => number
      • getGUIDCallback: (row: any) => string
      • getTagsAndDatesCallback: (row: any) => { cdate: number; mdate: number; tags: string[] }
      • getDataNameAndSValueCallback: (row: any) => { name: string; svalue: string }

      Returns { process: () => Error | EntityInstanceType<T>[]; result: any }

    • Returns Promise<string[]>

    • Parameters

      • etype: string

      Returns Promise<
          {
              name: string;
              property: string;
              scope: "tokens"
              | "data"
              | "references";
          }[],
      >

    • Parameters

      • name: string

      Returns Promise<number | null>

    • Parameters

      • filename: string
      • Optionaltransaction: boolean

      Returns Promise<boolean>

    • Parameters

      • text: string
      • Optionaltransaction: boolean

      Returns Promise<boolean>

    • Parameters

      • lines: Iterable<string>
      • Optionaltransaction: boolean

      Returns Promise<boolean>

    • Parameters

      • entity: {
            cdate: number;
            etype: string;
            guid: string;
            mdate: number;
            sdata: SerializedEntityData;
            tags: string[];
        }

      Returns Promise<void>

    • Parameters

      • entity: {
            cdate: number;
            etype: string;
            guid: string;
            mdate: number;
            sdata: SerializedEntityData;
            tags: string[];
        }

      Returns Promise<void>

    • Parameters

      • entity: {
            cdate: number;
            etype: string;
            guid: string;
            mdate: number;
            sdata: SerializedEntityData;
            tags: string[];
        }

      Returns Promise<void>

    • Parameters

      • __namedParameters: { name: string; value: number }

      Returns Promise<void>

    • Initialize the Nymph driver.

      This is meant to be called internally by Nymph. Don't call this directly.

      Parameters

      • nymph: Nymph

        The Nymph instance.

      Returns void

    • Parameters

      • name: string

      Returns Promise<MySQLDriverTransaction>

    • Returns Promise<boolean>

    • Check connection status.

      Returns boolean

      Whether this instance is connected to a MySQL database.

    • Parameters

      • selectors: FormattedSelector[]
      • callback: (
            data: { key: string; typeIsNot: boolean; typeIsOr: boolean; value: any },
        ) => string

      Returns string[]

    • Parameters

      • migrationType: "tilmeldColumns" | "tokenTables" | "tilmeldRemoveOldRows"

      Returns Promise<void>

    • Returns Promise<false | "json" | "tokens" | "tilmeldColumns">

    • Parameters

      • name: string

      Returns Promise<number | null>

    • Parameters

      • options: Options
      • formattedSelectors: FormattedSelector[]
      • etype: string

      Returns { result: any }

    • Parameters

      • pattern: string
      • subject: string
      • OptionalcaseInsensitive: boolean

      Returns boolean

    • Pull an entity from the cache.

      Parameters

      • guid: string

        The entity's GUID.

      Returns
          | {
              cdate: number;
              data: EntityData;
              guid: string;
              mdate: number;
              sdata: SerializedEntityData;
              tags: string[];
          }
          | null

      The entity's data or null if it's not cached.

    • Push an entity onto the cache.

      Parameters

      • guid: string

        The entity's GUID.

      • cdate: number

        The entity's cdate.

      • mdate: number

        The entity's mdate.

      • tags: string[]

        The entity's tags.

      • data: EntityData

        The entity's data.

      • sdata: SerializedEntityData

        The entity's sdata.

      Returns void

    • Parameters

      • etype: string
      • data: EntityData
      • sdata: SerializedEntityData

      Returns {
          acFull: string[] | null;
          acGroup: number | null;
          acOther: number | null;
          acRead: string[] | null;
          acUser: number | null;
          acWrite: string[] | null;
          group: string | null;
          user: string | null;
      }

    • Parameters

      • oldName: string
      • newName: string

      Returns Promise<boolean>

    • Parameters

      • name: string

      Returns Promise<boolean>

    • Parameters

      • entity: EntityInterface

      Returns Promise<boolean>

    • Parameters

      • entity: EntityInterface
      • saveNewEntityCallback: (
            data: {
                cdate: number;
                data: EntityData;
                entity: EntityInterface;
                etype: string;
                guid: string;
                sdata: SerializedEntityData;
                tags: string[];
                uniques: string[];
            },
        ) => Promise<boolean>
      • saveExistingEntityCallback: (
            data: {
                data: EntityData;
                entity: EntityInterface;
                etype: string;
                guid: string;
                mdate: number;
                sdata: SerializedEntityData;
                tags: string[];
                uniques: string[];
            },
        ) => Promise<boolean>
      • OptionalstartTransactionCallback: (() => Promise<void>) | null
      • OptionalcommitTransactionCallback: ((success: boolean) => Promise<boolean>) | null

      Returns Promise<boolean>

    • Parameters

      • name: string
      • curUid: number

      Returns Promise<boolean>

    • Parameters

      • name: string

      Returns Promise<Nymph>

    • Parameters

      • input: string

      Returns string

    • Parameters

      • input: string

      Returns string