@nymphjs/nymph 1.0.0-beta.111 → 1.0.0-beta.112

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.0.0-beta.112](https://forge.sciactive.com/sciactive/nymphjs/compare/v1.0.0-beta.111...v1.0.0-beta.112) (2026-04-03)
+
+### Features
+
+- add acRequest query option ([600b617](https://forge.sciactive.com/sciactive/nymphjs/commits/600b617692b7ba0824e6ee91c0c9f9c29156fbe3))
+
 # [1.0.0-beta.111](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.110...v1.0.0-beta.111) (2026-03-10)
 
 **Note:** Version bump only for package @nymphjs/nymph

package/dist/Nymph.types.d.ts

@@ -91,6 +91,13 @@ export type Options<T extends EntityConstructor = EntityConstructor> = {
      * If true, Nymph will skip the cache and retrieve the entity from the DB.
      */
     skipCache?: boolean;
+    /**
+     * The level(s) of access control requested.
+     *
+     * Limiting the access control can significantly improve the performance of
+     * the query.
+     */
+    acRequest?: TilmeldAccessRequest;
     /**
      * If true, Tilmeld will not filter returned entities according to access
      * controls. (If Tilmeld is installed.) (This is always set to false by the
@@ -222,6 +229,49 @@ export declare enum TilmeldAccessLevels {
     WRITE_ACCESS = 2,
     FULL_ACCESS = 4
 }
+export declare enum TilmeldAccessRequest {
+    /**
+     * The default level, any possible entity readable by the user.
+     *
+     * This is the same as or-ing together all of the levels listed below.
+     */
+    ALL_LEVELS = 0,
+    /**
+     * Owned by and accessible to the user.
+     *
+     * This is always enabled, so not including it has no effect. It's here to
+     * allow the selection of _only_ user owned entities.
+     */
+    USER_OWNED = 1,
+    /**
+     * Owned by and accessible to the user's primary group.
+     */
+    PRIMARY_GROUP_OWNED = 2,
+    /**
+     * Owned by and accessible to one of the user's secondary groups.
+     */
+    SECONDARY_GROUP_OWNED = 4,
+    /**
+     * The user is listed in an access control list.
+     */
+    USER_ACCESSIBLE = 8,
+    /**
+     * The user's primary group is listed in an access control list.
+     */
+    PRIMARY_GROUP_ACCESSIBLE = 16,
+    /**
+     * One of the user's secondary groups is listed in an access control list.
+     */
+    SECONDARY_GROUP_ACCESSIBLE = 32,
+    /**
+     * The entity is accessible to any user.
+     */
+    OTHER_ACCESSIBLE = 64,
+    /**
+     * The entity is not owned by anyone.
+     */
+    UNOWNED = 128
+}
 export interface TilmeldInterface {
     nymph: Nymph;
     request: any;

package/dist/Nymph.types.js

@@ -6,4 +6,48 @@ export var TilmeldAccessLevels;
     // Keeping 3 open in case we ever need one between write and full.
     TilmeldAccessLevels[TilmeldAccessLevels["FULL_ACCESS"] = 4] = "FULL_ACCESS";
 })(TilmeldAccessLevels || (TilmeldAccessLevels = {}));
+export var TilmeldAccessRequest;
+(function (TilmeldAccessRequest) {
+    /**
+     * The default level, any possible entity readable by the user.
+     *
+     * This is the same as or-ing together all of the levels listed below.
+     */
+    TilmeldAccessRequest[TilmeldAccessRequest["ALL_LEVELS"] = 0] = "ALL_LEVELS";
+    /**
+     * Owned by and accessible to the user.
+     *
+     * This is always enabled, so not including it has no effect. It's here to
+     * allow the selection of _only_ user owned entities.
+     */
+    TilmeldAccessRequest[TilmeldAccessRequest["USER_OWNED"] = 1] = "USER_OWNED";
+    /**
+     * Owned by and accessible to the user's primary group.
+     */
+    TilmeldAccessRequest[TilmeldAccessRequest["PRIMARY_GROUP_OWNED"] = 2] = "PRIMARY_GROUP_OWNED";
+    /**
+     * Owned by and accessible to one of the user's secondary groups.
+     */
+    TilmeldAccessRequest[TilmeldAccessRequest["SECONDARY_GROUP_OWNED"] = 4] = "SECONDARY_GROUP_OWNED";
+    /**
+     * The user is listed in an access control list.
+     */
+    TilmeldAccessRequest[TilmeldAccessRequest["USER_ACCESSIBLE"] = 8] = "USER_ACCESSIBLE";
+    /**
+     * The user's primary group is listed in an access control list.
+     */
+    TilmeldAccessRequest[TilmeldAccessRequest["PRIMARY_GROUP_ACCESSIBLE"] = 16] = "PRIMARY_GROUP_ACCESSIBLE";
+    /**
+     * One of the user's secondary groups is listed in an access control list.
+     */
+    TilmeldAccessRequest[TilmeldAccessRequest["SECONDARY_GROUP_ACCESSIBLE"] = 32] = "SECONDARY_GROUP_ACCESSIBLE";
+    /**
+     * The entity is accessible to any user.
+     */
+    TilmeldAccessRequest[TilmeldAccessRequest["OTHER_ACCESSIBLE"] = 64] = "OTHER_ACCESSIBLE";
+    /**
+     * The entity is not owned by anyone.
+     */
+    TilmeldAccessRequest[TilmeldAccessRequest["UNOWNED"] = 128] = "UNOWNED";
+})(TilmeldAccessRequest || (TilmeldAccessRequest = {}));
 //# sourceMappingURL=Nymph.types.js.map

package/dist/Nymph.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"Nymph.types.js","sourceRoot":"","sources":["../src/Nymph.types.ts"],"names":[],"mappings":"AAgaA,MAAM,CAAN,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,uEAAa,CAAA;IACb,2EAAe,CAAA;IACf,6EAAgB,CAAA;IAChB,kEAAkE;IAClE,2EAAe,CAAA;AACjB,CAAC,EANW,mBAAmB,KAAnB,mBAAmB,QAM9B"}
+{"version":3,"file":"Nymph.types.js","sourceRoot":"","sources":["../src/Nymph.types.ts"],"names":[],"mappings":"AAuaA,MAAM,CAAN,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,uEAAa,CAAA;IACb,2EAAe,CAAA;IACf,6EAAgB,CAAA;IAChB,kEAAkE;IAClE,2EAAe,CAAA;AACjB,CAAC,EANW,mBAAmB,KAAnB,mBAAmB,QAM9B;AAED,MAAM,CAAN,IAAY,oBA0CX;AA1CD,WAAY,oBAAoB;IAC9B;;;;OAIG;IACH,2EAAc,CAAA;IACd;;;;;OAKG;IACH,2EAAc,CAAA;IACd;;OAEG;IACH,6FAAuB,CAAA;IACvB;;OAEG;IACH,iGAAyB,CAAA;IACzB;;OAEG;IACH,qFAAmB,CAAA;IACnB;;OAEG;IACH,wGAA6B,CAAA;IAC7B;;OAEG;IACH,4GAA+B,CAAA;IAC/B;;OAEG;IACH,wFAAqB,CAAA;IACrB;;OAEG;IACH,uEAAa,CAAA;AACf,CAAC,EA1CW,oBAAoB,KAApB,oBAAoB,QA0C/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nymphjs/nymph",
-  "version": "1.0.0-beta.111",
+  "version": "1.0.0-beta.112",
   "description": "Nymph.js - Nymph ORM",
   "type": "module",
   "main": "dist/index.js",
@@ -23,15 +23,15 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/sciactive/nymphjs.git"
+    "url": "git+https://forge.sciactive.com/sciactive/nymphjs.git"
   },
   "author": "Hunter Perrin <hperrin@gmail.com>",
   "bugs": {
-    "url": "https://github.com/sciactive/nymphjs/issues"
+    "url": "https://forge.sciactive.com/sciactive/nymphjs/issues"
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "@nymphjs/guid": "^1.0.0-beta.111",
+    "@nymphjs/guid": "^1.0.0-beta.112",
     "@sciactive/tokenizer": "^3.0.2",
     "debug": "^4.4.3",
     "joi": "^18.0.2",
@@ -51,5 +51,5 @@
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3"
   },
-  "gitHead": "8028358367d8fd89bb434f122b243bec4c71f2e1"
+  "gitHead": "20157c196abcc9dcc70c1dff207cbea35a32f69f"
 }

package/src/Nymph.types.ts

@@ -230,6 +230,13 @@ export type Options<T extends EntityConstructor = EntityConstructor> = {
    * If true, Nymph will skip the cache and retrieve the entity from the DB.
    */
   skipCache?: boolean;
+  /**
+   * The level(s) of access control requested.
+   *
+   * Limiting the access control can significantly improve the performance of
+   * the query.
+   */
+  acRequest?: TilmeldAccessRequest;
   /**
    * If true, Tilmeld will not filter returned entities according to access
    * controls. (If Tilmeld is installed.) (This is always set to false by the
@@ -422,6 +429,50 @@ export enum TilmeldAccessLevels {
   FULL_ACCESS = 4,
 }
 
+export enum TilmeldAccessRequest {
+  /**
+   * The default level, any possible entity readable by the user.
+   *
+   * This is the same as or-ing together all of the levels listed below.
+   */
+  ALL_LEVELS = 0,
+  /**
+   * Owned by and accessible to the user.
+   *
+   * This is always enabled, so not including it has no effect. It's here to
+   * allow the selection of _only_ user owned entities.
+   */
+  USER_OWNED = 1,
+  /**
+   * Owned by and accessible to the user's primary group.
+   */
+  PRIMARY_GROUP_OWNED = 2,
+  /**
+   * Owned by and accessible to one of the user's secondary groups.
+   */
+  SECONDARY_GROUP_OWNED = 4,
+  /**
+   * The user is listed in an access control list.
+   */
+  USER_ACCESSIBLE = 8,
+  /**
+   * The user's primary group is listed in an access control list.
+   */
+  PRIMARY_GROUP_ACCESSIBLE = 16,
+  /**
+   * One of the user's secondary groups is listed in an access control list.
+   */
+  SECONDARY_GROUP_ACCESSIBLE = 32,
+  /**
+   * The entity is accessible to any user.
+   */
+  OTHER_ACCESSIBLE = 64,
+  /**
+   * The entity is not owned by anyone.
+   */
+  UNOWNED = 128,
+}
+
 export interface TilmeldInterface {
   nymph: Nymph;
   request: any;