@nymphjs/client 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/client

package/dist/Nymph.types.d.ts

@@ -94,6 +94,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;
 };
 export type Clause<C> = C | Exclude<C, undefined>[];
 export type OrWithTime<T> = T | [string, null, string];
@@ -174,4 +181,47 @@ export type Selector = {
     selector?: Clause<Selector>;
     '!selector'?: Selector['selector'];
 };
+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 {};

package/dist/Nymph.types.js

@@ -1,2 +1,45 @@
-export {};
+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":""}
+{"version":3,"file":"Nymph.types.js","sourceRoot":"","sources":["../src/Nymph.types.ts"],"names":[],"mappings":"AAoOA,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/client",
-  "version": "1.0.0-beta.111",
+  "version": "1.0.0-beta.112",
   "description": "Nymph.js - Client",
   "type": "module",
   "main": "dist/index.js",
@@ -23,11 +23,11 @@
   },
   "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": {
@@ -43,5 +43,5 @@
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3"
   },
-  "gitHead": "8028358367d8fd89bb434f122b243bec4c71f2e1"
+  "gitHead": "20157c196abcc9dcc70c1dff207cbea35a32f69f"
 }

package/src/Nymph.types.ts

@@ -99,6 +99,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;
 };
 
 export type Clause<C> = C | Exclude<C, undefined>[];
@@ -218,3 +225,47 @@ export type Selector = {
   selector?: Clause<Selector>;
   '!selector'?: Selector['selector'];
 };
+
+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,
+}