@terreno/api 0.11.7 → 0.11.9

package/dist/openApiValidator.js

@@ -96,18 +96,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isOpenApiValidatorConfigured = isOpenApiValidatorConfigured;
-exports.configureOpenApiValidator = configureOpenApiValidator;
-exports.getOpenApiValidatorConfig = getOpenApiValidatorConfig;
-exports.resetOpenApiValidatorConfig = resetOpenApiValidatorConfig;
-exports.validateRequestBody = validateRequestBody;
-exports.validateQueryParams = validateQueryParams;
-exports.createValidator = createValidator;
-exports.validateResponseData = validateResponseData;
-exports.getSchemaFromModel = getSchemaFromModel;
-exports.validateModelRequestBody = validateModelRequestBody;
-exports.createModelValidators = createModelValidators;
-exports.buildQuerySchemaFromFields = buildQuerySchemaFromFields;
+exports.buildQuerySchemaFromFields = exports.createModelValidators = exports.validateModelRequestBody = exports.getSchemaFromModel = exports.validateResponseData = exports.createValidator = exports.validateQueryParams = exports.validateRequestBody = exports.resetOpenApiValidatorConfig = exports.getOpenApiValidatorConfig = exports.configureOpenApiValidator = exports.isOpenApiValidatorConfigured = void 0;
 var ajv_1 = __importDefault(require("ajv"));
 var ajv_formats_1 = __importDefault(require("ajv-formats"));
 var mongoose_to_swagger_1 = __importDefault(require("mongoose-to-swagger"));
@@ -128,9 +117,10 @@ var globalConfig = {
  * Check whether `configureOpenApiValidator()` has been called.
  * Validation middleware is a no-op when this returns false.
  */
-function isOpenApiValidatorConfigured() {
+var isOpenApiValidatorConfigured = function () {
     return isConfigured;
-}
+};
+exports.isOpenApiValidatorConfigured = isOpenApiValidatorConfigured;
 /**
  * Configure the global OpenAPI validator settings.
  * Calling this function activates validation — middleware that was previously
@@ -148,7 +138,7 @@ function isOpenApiValidatorConfigured() {
  * });
  * ```
  */
-function configureOpenApiValidator(config) {
+var configureOpenApiValidator = function (config) {
     if (config === void 0) { config = {}; }
     isConfigured = true;
     globalConfig = __assign(__assign({}, globalConfig), config);
@@ -156,19 +146,21 @@ function configureOpenApiValidator(config) {
     ajvCache.clear();
     validatorCache.clear();
     logger_1.logger.debug("OpenAPI validator configured: ".concat(JSON.stringify(globalConfig)));
-}
+};
+exports.configureOpenApiValidator = configureOpenApiValidator;
 /**
  * Get the current global validator configuration.
  */
-function getOpenApiValidatorConfig() {
+var getOpenApiValidatorConfig = function () {
     return __assign({}, globalConfig);
-}
+};
+exports.getOpenApiValidatorConfig = getOpenApiValidatorConfig;
 /**
  * Reset the global validator configuration to defaults.
  * Also resets `isConfigured` to false.
  * Useful for testing.
  */
-function resetOpenApiValidatorConfig() {
+var resetOpenApiValidatorConfig = function () {
     isConfigured = false;
     globalConfig = {
         coerceTypes: true,
@@ -179,13 +171,14 @@ function resetOpenApiValidatorConfig() {
     };
     ajvCache.clear();
     validatorCache.clear();
-}
+};
+exports.resetOpenApiValidatorConfig = resetOpenApiValidatorConfig;
 // Lazy AJV instance cache keyed by coerceTypes + removeAdditional
 var ajvCache = new Map();
 /**
  * Get or create an AJV instance with the current config settings.
  */
-function getAjvInstance() {
+var getAjvInstance = function () {
     var _a, _b, _c, _d;
     var key = "coerce:".concat((_a = globalConfig.coerceTypes) !== null && _a !== void 0 ? _a : true, ",remove:").concat((_b = globalConfig.removeAdditional) !== null && _b !== void 0 ? _b : true);
     var instance = ajvCache.get(key);
@@ -202,15 +195,15 @@ function getAjvInstance() {
         ajvCache.set(key, instance);
     }
     return instance;
-}
+};
 // Cache compiled validators by schema hash + config key
 var validatorCache = new Map();
 /**
  * Generate a simple hash for a schema to use as a cache key.
  */
-function hashSchema(schema) {
+var hashSchema = function (schema) {
     return JSON.stringify(schema);
-}
+};
 var VALID_JSON_SCHEMA_TYPES = new Set([
     "string",
     "number",
@@ -229,7 +222,7 @@ var MONGOOSE_TYPE_MAP = {
  * Recursively replace non-standard mongoose-to-swagger types with valid JSON Schema types
  * so AJV can compile the schema.
  */
-function sanitizeSchemaForAjv(schema) {
+var sanitizeSchemaForAjv = function (schema) {
     var e_1, _a;
     if (!schema || typeof schema !== "object") {
         return schema;
@@ -274,14 +267,14 @@ function sanitizeSchemaForAjv(schema) {
         result.additionalProperties = sanitizeSchemaForAjv(result.additionalProperties);
     }
     return result;
-}
+};
 /**
  * Get or create a compiled validator for a schema.
  * Uses the current config so changes take effect on next call.
  * Sanitizes non-standard mongoose-to-swagger types before compilation.
  * Returns null if the schema still cannot be compiled after sanitization.
  */
-function getValidator(schema) {
+var getValidator = function (schema) {
     var _a, _b;
     var ajv = getAjvInstance();
     var configKey = "coerce:".concat((_a = globalConfig.coerceTypes) !== null && _a !== void 0 ? _a : true, ",remove:").concat((_b = globalConfig.removeAdditional) !== null && _b !== void 0 ? _b : true);
@@ -301,11 +294,11 @@ function getValidator(schema) {
         validatorCache.set(hash, null);
         return null;
     }
-}
+};
 /**
  * Format AJV errors into a human-readable string.
  */
-function formatValidationErrors(errors) {
+var formatValidationErrors = function (errors) {
     return errors
         .map(function (err) {
         var path = err.instancePath || "/";
@@ -313,13 +306,13 @@ function formatValidationErrors(errors) {
         return "".concat(path, ": ").concat(message);
     })
         .join("; ");
-}
+};
 /**
  * Convert OpenApiSchemaProperty to a full OpenApiSchema suitable for AJV.
  * Strips `required` from individual properties (OpenAPI-style) and moves it
  * to the schema-level `required` array (JSON Schema-style) for AJV compatibility.
  */
-function propertiesToSchema(properties, requiredFields) {
+var propertiesToSchema = function (properties, requiredFields) {
     var e_2, _a;
     // Extract required fields from properties that have required: true
     var autoRequired = Object.entries(properties)
@@ -359,7 +352,7 @@ function propertiesToSchema(properties, requiredFields) {
         schema.additionalProperties = false;
     }
     return schema;
-}
+};
 /**
  * Creates middleware that validates the request body against an OpenAPI schema.
  *
@@ -370,7 +363,7 @@ function propertiesToSchema(properties, requiredFields) {
  * @param options - Optional configuration for this validator
  * @returns Express middleware function
  */
-function validateRequestBody(schema, options) {
+var validateRequestBody = function (schema, options) {
     var fullSchema = propertiesToSchema(schema, options === null || options === void 0 ? void 0 : options.required);
     return function (req, _res, next) {
         var _a, _b, _c;
@@ -447,7 +440,8 @@ function validateRequestBody(schema, options) {
         }
         next();
     };
-}
+};
+exports.validateRequestBody = validateRequestBody;
 /**
  * Creates middleware that validates query parameters against an OpenAPI schema.
  *
@@ -455,7 +449,7 @@ function validateRequestBody(schema, options) {
  * @param options - Optional configuration for this validator
  * @returns Express middleware function
  */
-function validateQueryParams(schema, options) {
+var validateQueryParams = function (schema, options) {
     var fullSchema = propertiesToSchema(schema);
     return function (req, _res, next) {
         var _a, _b, _c, _d;
@@ -513,7 +507,8 @@ function validateQueryParams(schema, options) {
         }
         next();
     };
-}
+};
+exports.validateQueryParams = validateQueryParams;
 /**
  * Creates a combined validation middleware for both body and query parameters.
  *
@@ -531,12 +526,12 @@ function validateQueryParams(schema, options) {
  * ], handler);
  * ```
  */
-function createValidator(options) {
+var createValidator = function (options) {
     var bodyValidator = options.body
-        ? validateRequestBody(options.body, { enabled: options.enabled })
+        ? (0, exports.validateRequestBody)(options.body, { enabled: options.enabled })
         : null;
     var queryValidator = options.query
-        ? validateQueryParams(options.query, { enabled: options.enabled })
+        ? (0, exports.validateQueryParams)(options.query, { enabled: options.enabled })
         : null;
     return function (req, res, next) {
         // Run body validation first
@@ -562,7 +557,8 @@ function createValidator(options) {
             next();
         }
     };
-}
+};
+exports.createValidator = createValidator;
 /**
  * Validates response data against a schema.
  * This is primarily for development/testing to ensure responses match documentation.
@@ -571,7 +567,7 @@ function createValidator(options) {
  * @param schema - The expected schema
  * @returns Object with valid flag and any errors
  */
-function validateResponseData(data, schema) {
+var validateResponseData = function (data, schema) {
     if (!globalConfig.validateResponses) {
         return { valid: true };
     }
@@ -588,7 +584,8 @@ function validateResponseData(data, schema) {
         return { errors: validator.errors, valid: false };
     }
     return { valid: true };
-}
+};
+exports.validateResponseData = validateResponseData;
 var m2sOptions = {
     props: ["readOnly", "required", "enum", "default"],
 };
@@ -600,19 +597,20 @@ var m2sOptions = {
  * @param model - A Mongoose model
  * @returns Schema properties suitable for validation
  */
-function getSchemaFromModel(model) {
+var getSchemaFromModel = function (model) {
     var modelSwagger = (0, mongoose_to_swagger_1.default)(model, m2sOptions);
     (0, populate_1.fixMixedFields)(model.schema, modelSwagger.properties);
     return modelSwagger.properties;
-}
+};
+exports.getSchemaFromModel = getSchemaFromModel;
 /**
  * Extract required field names from a Mongoose model's swagger schema.
  */
-function getRequiredFieldsFromModel(model) {
+var getRequiredFieldsFromModel = function (model) {
     var _a;
     var modelSwagger = (0, mongoose_to_swagger_1.default)(model, m2sOptions);
     return (_a = modelSwagger.required) !== null && _a !== void 0 ? _a : [];
-}
+};
 /**
  * Creates a request body validator middleware from a Mongoose model.
  * This is a convenience function that combines getSchemaFromModel and validateRequestBody.
@@ -621,9 +619,9 @@ function getRequiredFieldsFromModel(model) {
  * @param options - Optional configuration for the validator
  * @returns Express middleware function
  */
-function validateModelRequestBody(model, options) {
+var validateModelRequestBody = function (model, options) {
     var _a, _b;
-    var schema = getSchemaFromModel(model);
+    var schema = (0, exports.getSchemaFromModel)(model);
     var requiredFields = getRequiredFieldsFromModel(model);
     if ((_a = options === null || options === void 0 ? void 0 : options.excludeFields) === null || _a === void 0 ? void 0 : _a.length) {
         var excluded_1 = new Set(options.excludeFields);
@@ -633,8 +631,9 @@ function validateModelRequestBody(model, options) {
         }));
         requiredFields = requiredFields.filter(function (f) { return !excluded_1.has(f); });
     }
-    return validateRequestBody(schema, __assign(__assign({}, options), { required: __spreadArray(__spreadArray([], __read(((_b = options === null || options === void 0 ? void 0 : options.required) !== null && _b !== void 0 ? _b : [])), false), __read(requiredFields), false) }));
-}
+    return (0, exports.validateRequestBody)(schema, __assign(__assign({}, options), { required: __spreadArray(__spreadArray([], __read(((_b = options === null || options === void 0 ? void 0 : options.required) !== null && _b !== void 0 ? _b : [])), false), __read(requiredFields), false) }));
+};
+exports.validateModelRequestBody = validateModelRequestBody;
 /**
  * Creates validation middleware for use with modelRouter.
  * Returns an object with middleware for each operation type.
@@ -643,21 +642,22 @@ function validateModelRequestBody(model, options) {
  * @param options - Configuration options
  * @returns Object with create and update validation middleware
  */
-function createModelValidators(model, options) {
-    var schema = getSchemaFromModel(model);
+var createModelValidators = function (model, options) {
+    var schema = (0, exports.getSchemaFromModel)(model);
     return {
-        create: validateRequestBody(schema, {
+        create: (0, exports.validateRequestBody)(schema, {
             enabled: options === null || options === void 0 ? void 0 : options.validateCreate,
             onAdditionalPropertiesRemoved: options === null || options === void 0 ? void 0 : options.onAdditionalPropertiesRemoved,
             onError: options === null || options === void 0 ? void 0 : options.onError,
         }),
-        update: validateRequestBody(schema, {
+        update: (0, exports.validateRequestBody)(schema, {
             enabled: options === null || options === void 0 ? void 0 : options.validateUpdate,
             onAdditionalPropertiesRemoved: options === null || options === void 0 ? void 0 : options.onAdditionalPropertiesRemoved,
             onError: options === null || options === void 0 ? void 0 : options.onError,
         }),
     };
-}
+};
+exports.createModelValidators = createModelValidators;
 /**
  * Build a query parameter schema from a model's Mongoose schema and queryFields array.
  * Always includes pagination parameters (limit, page, sort).
@@ -666,10 +666,10 @@ function createModelValidators(model, options) {
  * @param queryFields - Array of field names allowed for querying
  * @returns Schema properties suitable for query validation
  */
-function buildQuerySchemaFromFields(model, queryFields) {
+var buildQuerySchemaFromFields = function (model, queryFields) {
     var e_3, _a;
     if (queryFields === void 0) { queryFields = []; }
-    var modelSchema = getSchemaFromModel(model);
+    var modelSchema = (0, exports.getSchemaFromModel)(model);
     var querySchema = {
         limit: { type: "number" },
         page: { type: "number" },
@@ -697,4 +697,5 @@ function buildQuerySchemaFromFields(model, queryFields) {
         finally { if (e_3) throw e_3.error; }
     }
     return querySchema;
-}
+};
+exports.buildQuerySchemaFromFields = buildQuerySchemaFromFields;

package/dist/plugins.d.ts

@@ -1,4 +1,4 @@
-import { type Document, type Schema, SchemaType, type SchemaTypeOptions } from "mongoose";
+import mongoose, { type Document, type FilterQuery, type Schema, SchemaType, type SchemaTypeOptions } from "mongoose";
 import { type APIErrorConstructor } from "./errors";
 export interface BaseUser {
     admin: boolean;
@@ -31,6 +31,17 @@ export declare const firebaseJWTPlugin: (schema: Schema) => void;
  * @param schema Mongoose Schema
  */
 export declare const findOneOrNone: <T>(schema: Schema<T>) => void;
+/**
+ * Helper that performs a `findOneOrNone` lookup against any Mongoose model. Returns the matching
+ * document, `null` if none match, or throws if more than one matches. If the model's schema has
+ * the {@link findOneOrNone} plugin applied, the plugin static is used; otherwise the lookup is
+ * performed directly via `model.find(...)`. Prefer this helper from framework code where the
+ * consumer's model may or may not have the plugin installed.
+ * @param model Mongoose Model
+ * @param query Mongoose query object
+ * @param errorArgs Optional overrides for the thrown {@link APIError} when multiple match
+ */
+export declare const findOneOrNoneFor: <T>(model: mongoose.Model<T>, query: FilterQuery<T>, errorArgs?: Partial<APIErrorConstructor>) => Promise<(Document & T) | null>;
 /**
  * This adds a static method `Model.findExactlyOne` to the schema. This or findOneOrNone should replace `Model.findOne`
  * in most instances.

package/dist/plugins.js

@@ -95,7 +95,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
     }
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DateOnly = exports.upsertPlugin = exports.findExactlyOne = exports.findOneOrNone = exports.firebaseJWTPlugin = exports.createdUpdatedPlugin = exports.isDisabledPlugin = exports.isDeletedPlugin = exports.baseUserPlugin = void 0;
+exports.DateOnly = exports.upsertPlugin = exports.findExactlyOne = exports.findOneOrNoneFor = exports.findOneOrNone = exports.firebaseJWTPlugin = exports.createdUpdatedPlugin = exports.isDisabledPlugin = exports.isDeletedPlugin = exports.baseUserPlugin = void 0;
 var luxon_1 = require("luxon");
 var mongoose_1 = __importStar(require("mongoose"));
 var errors_1 = require("./errors");
@@ -199,6 +199,39 @@ var findOneOrNone = function (schema) {
     };
 };
 exports.findOneOrNone = findOneOrNone;
+/**
+ * Helper that performs a `findOneOrNone` lookup against any Mongoose model. Returns the matching
+ * document, `null` if none match, or throws if more than one matches. If the model's schema has
+ * the {@link findOneOrNone} plugin applied, the plugin static is used; otherwise the lookup is
+ * performed directly via `model.find(...)`. Prefer this helper from framework code where the
+ * consumer's model may or may not have the plugin installed.
+ * @param model Mongoose Model
+ * @param query Mongoose query object
+ * @param errorArgs Optional overrides for the thrown {@link APIError} when multiple match
+ */
+var findOneOrNoneFor = function (model, query, errorArgs) { return __awaiter(void 0, void 0, void 0, function () {
+    var withStatic, results;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                withStatic = model;
+                if (typeof withStatic.findOneOrNone === "function") {
+                    return [2 /*return*/, withStatic.findOneOrNone(query, errorArgs)];
+                }
+                return [4 /*yield*/, model.find(query)];
+            case 1:
+                results = _a.sent();
+                if (results.length === 0) {
+                    return [2 /*return*/, null];
+                }
+                if (results.length > 1) {
+                    throw new errors_1.APIError(__assign({ detail: "query: ".concat(JSON.stringify(query)), status: 500, title: "".concat(model.modelName, ".findOne query returned multiple documents") }, errorArgs));
+                }
+                return [2 /*return*/, results[0]];
+        }
+    });
+}); };
+exports.findOneOrNoneFor = findOneOrNoneFor;
 /**
  * This adds a static method `Model.findExactlyOne` to the schema. This or findOneOrNone should replace `Model.findOne`
  * in most instances.

package/dist/plugins.test.js

@@ -74,6 +74,28 @@ stuffSchema.plugin(plugins_1.findExactlyOne);
 stuffSchema.plugin(plugins_1.upsertPlugin);
 stuffSchema.plugin(plugins_1.createdUpdatedPlugin);
 var StuffModel = (0, mongoose_1.model)("Stuff", stuffSchema);
+(0, bun_test_1.describe)("baseUserPlugin", function () {
+    (0, bun_test_1.it)("adds admin and email fields to the schema", function () {
+        var testSchema = new mongoose_1.Schema({});
+        // biome-ignore lint/suspicious/noExplicitAny: test schema
+        (0, plugins_1.baseUserPlugin)(testSchema);
+        var adminPath = testSchema.path("admin");
+        (0, bun_test_1.expect)(adminPath).toBeDefined();
+        (0, bun_test_1.expect)(adminPath.options.default).toBe(false);
+        var emailPath = testSchema.path("email");
+        (0, bun_test_1.expect)(emailPath).toBeDefined();
+        (0, bun_test_1.expect)(emailPath.options.index).toBe(true);
+    });
+});
+(0, bun_test_1.describe)("firebaseJWTPlugin", function () {
+    (0, bun_test_1.it)("adds firebaseId field to the schema", function () {
+        var testSchema = new mongoose_1.Schema({});
+        (0, plugins_1.firebaseJWTPlugin)(testSchema);
+        var firebaseIdPath = testSchema.path("firebaseId");
+        (0, bun_test_1.expect)(firebaseIdPath).toBeDefined();
+        (0, bun_test_1.expect)(firebaseIdPath.options.index).toBe(true);
+    });
+});
 (0, bun_test_1.describe)("createdUpdate", function () {
     (0, bun_test_1.it)("sets created and updated on save", function () { return __awaiter(void 0, void 0, void 0, function () {
         var stuff;
@@ -256,6 +278,188 @@ var StuffModel = (0, mongoose_1.model)("Stuff", stuffSchema);
         });
     }); });
 });
+var bareThingSchema = new mongoose_1.Schema({
+    name: { description: "The name of the bare item", type: String },
+    ownerId: { description: "The owner of the bare item", type: String },
+});
+var BareThingModel = (0, mongoose_1.model)("BareThing", bareThingSchema);
+(0, bun_test_1.describe)("findOneOrNoneFor", function () {
+    (0, bun_test_1.beforeEach)(function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, StuffModel.deleteMany({})];
+                case 1:
+                    _a.sent();
+                    return [4 /*yield*/, BareThingModel.deleteMany({})];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, (0, tests_1.setupDb)()];
+                case 3:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.describe)("when the schema has the findOneOrNone plugin", function () {
+        var things;
+        (0, bun_test_1.beforeEach)(function () { return __awaiter(void 0, void 0, void 0, function () {
+            var _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0: return [4 /*yield*/, Promise.all([
+                            StuffModel.create({ name: "Things", ownerId: "123" }),
+                            StuffModel.create({ name: "StuffNThings", ownerId: "123" }),
+                        ])];
+                    case 1:
+                        _a = __read.apply(void 0, [_b.sent(), 1]), things = _a[0];
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+        (0, bun_test_1.it)("returns null with no matches", function () { return __awaiter(void 0, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, (0, plugins_1.findOneOrNoneFor)(StuffModel, { name: "OtherStuff" })];
+                    case 1:
+                        result = _a.sent();
+                        (0, bun_test_1.expect)(result).toBeNull();
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+        (0, bun_test_1.it)("returns a single match", function () { return __awaiter(void 0, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, (0, plugins_1.findOneOrNoneFor)(StuffModel, { name: "Things" })];
+                    case 1:
+                        result = _a.sent();
+                        (0, bun_test_1.expect)(result).not.toBeNull();
+                        (0, bun_test_1.expect)(result === null || result === void 0 ? void 0 : result._id.toString()).toBe(things._id.toString());
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+        (0, bun_test_1.it)("throws when multiple documents match", function () { return __awaiter(void 0, void 0, void 0, function () {
+            var fn;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        fn = function () { return (0, plugins_1.findOneOrNoneFor)(StuffModel, { ownerId: "123" }); };
+                        return [4 /*yield*/, (0, bun_test_1.expect)(fn()).rejects.toThrow(/Stuff\.findOne query returned multiple documents/)];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+        (0, bun_test_1.it)("forwards errorArgs to the thrown APIError", function () { return __awaiter(void 0, void 0, void 0, function () {
+            var fn, error_2;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        fn = function () {
+                            return (0, plugins_1.findOneOrNoneFor)(StuffModel, { ownerId: "123" }, { status: 400, title: "Oh no!" });
+                        };
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, fn()];
+                    case 2:
+                        _a.sent();
+                        throw new Error("Expected promise to reject");
+                    case 3:
+                        error_2 = _a.sent();
+                        (0, bun_test_1.expect)(error_2.title).toBe("Oh no!");
+                        (0, bun_test_1.expect)(error_2.status).toBe(400);
+                        return [3 /*break*/, 4];
+                    case 4: return [2 /*return*/];
+                }
+            });
+        }); });
+    });
+    (0, bun_test_1.describe)("when the schema does NOT have the findOneOrNone plugin", function () {
+        var bareThings;
+        (0, bun_test_1.beforeEach)(function () { return __awaiter(void 0, void 0, void 0, function () {
+            var _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0: return [4 /*yield*/, Promise.all([
+                            BareThingModel.create({ name: "Things", ownerId: "123" }),
+                            BareThingModel.create({ name: "StuffNThings", ownerId: "123" }),
+                        ])];
+                    case 1:
+                        _a = __read.apply(void 0, [_b.sent(), 1]), bareThings = _a[0];
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+        (0, bun_test_1.it)("returns null with no matches", function () { return __awaiter(void 0, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, (0, plugins_1.findOneOrNoneFor)(BareThingModel, { name: "OtherStuff" })];
+                    case 1:
+                        result = _a.sent();
+                        (0, bun_test_1.expect)(result).toBeNull();
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+        (0, bun_test_1.it)("returns a single match", function () { return __awaiter(void 0, void 0, void 0, function () {
+            var result;
+            var _a, _b;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0: return [4 /*yield*/, (0, plugins_1.findOneOrNoneFor)(BareThingModel, { name: "Things" })];
+                    case 1:
+                        result = _c.sent();
+                        (0, bun_test_1.expect)(result).not.toBeNull();
+                        (0, bun_test_1.expect)((_a = result === null || result === void 0 ? void 0 : result._id) === null || _a === void 0 ? void 0 : _a.toString()).toBe((_b = bareThings._id) === null || _b === void 0 ? void 0 : _b.toString());
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+        (0, bun_test_1.it)("throws when multiple documents match", function () { return __awaiter(void 0, void 0, void 0, function () {
+            var fn;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        fn = function () { return (0, plugins_1.findOneOrNoneFor)(BareThingModel, { ownerId: "123" }); };
+                        return [4 /*yield*/, (0, bun_test_1.expect)(fn()).rejects.toThrow(/BareThing\.findOne query returned multiple documents/)];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+        (0, bun_test_1.it)("forwards errorArgs to the thrown APIError", function () { return __awaiter(void 0, void 0, void 0, function () {
+            var fn, error_3;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        fn = function () {
+                            return (0, plugins_1.findOneOrNoneFor)(BareThingModel, { ownerId: "123" }, { status: 400, title: "Oh no!" });
+                        };
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, fn()];
+                    case 2:
+                        _a.sent();
+                        throw new Error("Expected promise to reject");
+                    case 3:
+                        error_3 = _a.sent();
+                        (0, bun_test_1.expect)(error_3.title).toBe("Oh no!");
+                        (0, bun_test_1.expect)(error_3.status).toBe(400);
+                        return [3 /*break*/, 4];
+                    case 4: return [2 /*return*/];
+                }
+            });
+        }); });
+    });
+});
 (0, bun_test_1.describe)("findExactlyOne", function () {
     var things;
     (0, bun_test_1.beforeEach)(function () { return __awaiter(void 0, void 0, void 0, function () {
@@ -323,7 +527,7 @@ var StuffModel = (0, mongoose_1.model)("Stuff", stuffSchema);
         });
     }); });
     (0, bun_test_1.it)("throws custom error with two matches.", function () { return __awaiter(void 0, void 0, void 0, function () {
-        var fn, error_2;
+        var fn, error_4;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
@@ -337,11 +541,11 @@ var StuffModel = (0, mongoose_1.model)("Stuff", stuffSchema);
                     // If the promise doesn't reject, the test should fail
                     throw new Error("Expected promise to reject");
                 case 3:
-                    error_2 = _a.sent();
+                    error_4 = _a.sent();
                     // Check if the error has title and status properties
-                    (0, bun_test_1.expect)(error_2.title).toBe("Oh no!");
-                    (0, bun_test_1.expect)(error_2.status).toBe(400);
-                    (0, bun_test_1.expect)(error_2.detail).toBe('query: {"ownerId":"123"}');
+                    (0, bun_test_1.expect)(error_4.title).toBe("Oh no!");
+                    (0, bun_test_1.expect)(error_4.status).toBe(400);
+                    (0, bun_test_1.expect)(error_4.detail).toBe('query: {"ownerId":"123"}');
                     return [3 /*break*/, 4];
                 case 4: return [2 /*return*/];
             }
@@ -504,7 +708,7 @@ var StuffModel = (0, mongoose_1.model)("Stuff", stuffSchema);
 });
 (0, bun_test_1.describe)("DateOnly", function () {
     (0, bun_test_1.it)("throws error with invalid date", function () { return __awaiter(void 0, void 0, void 0, function () {
-        var error_3;
+        var error_5;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
@@ -518,8 +722,8 @@ var StuffModel = (0, mongoose_1.model)("Stuff", stuffSchema);
                     _a.sent();
                     return [3 /*break*/, 3];
                 case 2:
-                    error_3 = _a.sent();
-                    (0, bun_test_1.expect)(error_3.message).toMatch(/Cast to DateOnly failed/);
+                    error_5 = _a.sent();
+                    (0, bun_test_1.expect)(error_5.message).toMatch(/Cast to DateOnly failed/);
                     return [2 /*return*/];
                 case 3: throw new Error("Expected error was not thrown");
             }