@nymphjs/nymph 1.0.0-beta.6 → 1.0.0-beta.60

package/src/Nymph.types.ts

@@ -1,5 +1,5 @@
-import { EntityConstructor, EntityInterface } from './Entity.types';
-import Nymph from './Nymph';
+import type { EntityConstructor, EntityInterface } from './Entity.types';
+import type Nymph from './Nymph';
 
 export type NymphEventType =
   | 'connect'
@@ -9,25 +9,38 @@ export type NymphEventType =
   | 'beforeGetEntities'
   | 'beforeSaveEntity'
   | 'afterSaveEntity'
+  | 'failedSaveEntity'
   | 'beforeDeleteEntity'
   | 'afterDeleteEntity'
+  | 'failedDeleteEntity'
   | 'beforeDeleteEntityByID'
   | 'afterDeleteEntityByID'
+  | 'failedDeleteEntityByID'
   | 'beforeNewUID'
   | 'afterNewUID'
+  | 'failedNewUID'
   | 'beforeSetUID'
   | 'afterSetUID'
+  | 'failedSetUID'
   | 'beforeRenameUID'
   | 'afterRenameUID'
+  | 'failedRenameUID'
   | 'beforeDeleteUID'
-  | 'afterDeleteUID';
+  | 'afterDeleteUID'
+  | 'failedDeleteUID'
+  | 'beforeStartTransaction'
+  | 'afterStartTransaction'
+  | 'beforeCommitTransaction'
+  | 'afterCommitTransaction'
+  | 'beforeRollbackTransaction'
+  | 'afterRollbackTransaction';
 export type NymphConnectCallback = (
   nymph: Nymph,
-  result: Promise<boolean>
+  result: Promise<boolean>,
 ) => Promise<void>;
 export type NymphDisconnectCallback = (
   nymph: Nymph,
-  result: Promise<boolean>
+  result: Promise<boolean>,
 ) => Promise<void>;
 /**
  * The NymphQueryCallback will be called on both top level and qref queries.
@@ -43,76 +56,131 @@ export type NymphDisconnectCallback = (
 export type NymphQueryCallback = (
   nymph: Nymph,
   options: Options,
-  selectors: FormattedSelector[]
+  selectors: FormattedSelector[],
 ) => void;
 export type NymphBeforeGetEntityCallback = (
   nymph: Nymph,
   options: Options,
-  selectors: Selector[]
+  selectors: Selector[],
 ) => Promise<void>;
 export type NymphBeforeGetEntitiesCallback = (
   nymph: Nymph,
   options: Options,
-  selectors: Selector[]
+  selectors: Selector[],
 ) => Promise<void>;
 export type NymphBeforeSaveEntityCallback = (
   nymph: Nymph,
-  entity: EntityInterface
+  entity: EntityInterface,
 ) => Promise<void>;
 export type NymphAfterSaveEntityCallback = (
   nymph: Nymph,
-  result: Promise<boolean>
+  result: Promise<boolean>,
+) => Promise<void>;
+export type NymphFailedSaveEntityCallback = (
+  nymph: Nymph,
+  error: any,
 ) => Promise<void>;
 export type NymphBeforeDeleteEntityCallback = (
   nymph: Nymph,
-  entity: EntityInterface
+  entity: EntityInterface,
 ) => Promise<void>;
 export type NymphAfterDeleteEntityCallback = (
   nymph: Nymph,
-  result: Promise<boolean>
+  result: Promise<boolean>,
+) => Promise<void>;
+export type NymphFailedDeleteEntityCallback = (
+  nymph: Nymph,
+  error: any,
 ) => Promise<void>;
 export type NymphBeforeDeleteEntityByIDCallback = (
   nymph: Nymph,
   guid: string,
-  className?: string
+  className?: string,
 ) => Promise<void>;
 export type NymphAfterDeleteEntityByIDCallback = (
   nymph: Nymph,
-  result: Promise<boolean>
+  result: Promise<boolean>,
+) => Promise<void>;
+export type NymphFailedDeleteEntityByIDCallback = (
+  nymph: Nymph,
+  error: any,
 ) => Promise<void>;
 export type NymphBeforeNewUIDCallback = (
   nymph: Nymph,
-  name: string
+  name: string,
 ) => Promise<void>;
 export type NymphAfterNewUIDCallback = (
   nymph: Nymph,
-  result: Promise<number | null>
+  result: Promise<number | null>,
+) => Promise<void>;
+export type NymphFailedNewUIDCallback = (
+  nymph: Nymph,
+  error: any,
 ) => Promise<void>;
 export type NymphBeforeSetUIDCallback = (
   nymph: Nymph,
   name: string,
-  value: number
+  value: number,
 ) => Promise<void>;
 export type NymphAfterSetUIDCallback = (
   nymph: Nymph,
-  result: Promise<boolean>
+  result: Promise<boolean>,
+) => Promise<void>;
+export type NymphFailedSetUIDCallback = (
+  nymph: Nymph,
+  error: any,
 ) => Promise<void>;
 export type NymphBeforeRenameUIDCallback = (
   nymph: Nymph,
   oldName: string,
-  newName: string
+  newName: string,
 ) => Promise<void>;
 export type NymphAfterRenameUIDCallback = (
   nymph: Nymph,
-  result: Promise<boolean>
+  result: Promise<boolean>,
+) => Promise<void>;
+export type NymphFailedRenameUIDCallback = (
+  nymph: Nymph,
+  error: any,
 ) => Promise<void>;
 export type NymphBeforeDeleteUIDCallback = (
   nymph: Nymph,
-  name: string
+  name: string,
 ) => Promise<void>;
 export type NymphAfterDeleteUIDCallback = (
   nymph: Nymph,
-  result: Promise<boolean>
+  result: Promise<boolean>,
+) => Promise<void>;
+export type NymphFailedDeleteUIDCallback = (
+  nymph: Nymph,
+  error: any,
+) => Promise<void>;
+export type NymphBeforeStartTransactionCallback = (
+  nymph: Nymph,
+  name: string,
+) => Promise<void>;
+export type NymphAfterStartTransactionCallback = (
+  nymph: Nymph,
+  name: string,
+  result: Nymph,
+) => Promise<void>;
+export type NymphBeforeCommitTransactionCallback = (
+  nymph: Nymph,
+  name: string,
+) => Promise<void>;
+export type NymphAfterCommitTransactionCallback = (
+  nymph: Nymph,
+  name: string,
+  result: boolean,
+) => Promise<void>;
+export type NymphBeforeRollbackTransactionCallback = (
+  nymph: Nymph,
+  name: string,
+) => Promise<void>;
+export type NymphAfterRollbackTransactionCallback = (
+  nymph: Nymph,
+  name: string,
+  result: boolean,
 ) => Promise<void>;
 
 export type Options<T extends EntityConstructor = EntityConstructor> = {
@@ -120,7 +188,7 @@ export type Options<T extends EntityConstructor = EntityConstructor> = {
   limit?: number;
   offset?: number;
   reverse?: boolean;
-  sort?: 'cdate' | 'mdate';
+  sort?: 'cdate' | 'mdate' | string;
   return?: 'entity' | 'guid' | 'count';
   source?: string;
   skipCache?: boolean;
@@ -309,9 +377,12 @@ export interface TilmeldInterface {
   init(nymph: Nymph): void;
   clone(): TilmeldInterface;
   gatekeeper(ability?: string): boolean;
-  authenticate(): void;
+  authenticate(skipXsrfToken?: boolean, skipRenew?: boolean): Promise<boolean>;
   clearSession(): void;
   extractToken(token: string): Promise<any>;
-  fillSession(user: any): void;
-  checkClientUIDPermissions(name: string, type?: TilmeldAccessLevels): boolean;
+  fillSession(user: any): Promise<void>;
+  checkClientUIDPermissions(
+    name: string,
+    type?: TilmeldAccessLevels,
+  ): Promise<boolean>;
 }

package/src/conf/d.ts

@@ -21,4 +21,12 @@ export interface Config {
    * return a 404 error.
    */
   emptyListError: boolean;
+  /**
+   * A function to log debug messages. By default, uses the `debug` package.
+   */
+  debugLog: (source: string, message: string) => void;
+  /**
+   * A function to log error messages. By default, uses the `debug` package.
+   */
+  debugError: (source: string, message: string) => void;
 }

package/src/conf/defaults.ts

@@ -1,8 +1,32 @@
+import createDebug, { type Debugger } from 'debug';
 import { Config } from './d';
 
+const debuggers: { [k: string]: { log: Debugger; error: Debugger } } = {};
+
+function getDebuggers(source: string) {
+  if (source in debuggers) {
+    return debuggers[source];
+  }
+
+  debuggers[source] = {
+    log: createDebug(`nymphjs:log:${source}`),
+    error: createDebug(`nymphjs:error:${source}`),
+  };
+
+  debuggers[source].log.log = console.log.bind(console);
+
+  return debuggers[source];
+}
+
 export default {
   cache: false,
   cacheThreshold: 4,
   cacheLimit: 50,
   emptyListError: false,
+  debugLog: (source, message) => {
+    getDebuggers(source).log(message);
+  },
+  debugError: (source, message) => {
+    getDebuggers(source).error(message);
+  },
 } as Config;