joist-core 2.3.0 → 2.4.0-next.2

package/build/rules.js

@@ -1,231 +1,216 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ValidationErrors = exports.ValidationCode = void 0;
-exports.newRequiredRule = newRequiredRule;
-exports.cannotBeUpdated = cannotBeUpdated;
-exports.cannotBeChanged = cannotBeChanged;
-exports.isCannotBeUpdatedRule = isCannotBeUpdatedRule;
-exports.mustBeSubType = mustBeSubType;
-exports.minValueRule = minValueRule;
-exports.maxValueRule = maxValueRule;
-exports.rangeValueRule = rangeValueRule;
-const EntityManager_1 = require("./EntityManager");
-const fields_1 = require("./fields");
-const relations_1 = require("./relations");
-const utils_1 = require("./utils");
-var ValidationCode;
-(function (ValidationCode) {
-    ValidationCode["required"] = "required";
-    ValidationCode["cannotBeUpdated"] = "not-updatable";
-    ValidationCode["cannotBeChanged"] = "not-changeable";
-    ValidationCode["numeric"] = "not-numeric";
-    ValidationCode["minValue"] = "under-min";
-    ValidationCode["maxValue"] = "over-max";
-})(ValidationCode || (exports.ValidationCode = ValidationCode = {}));
+import { getField } from "./fields.js";
+import { isLoadedReference } from "./relations/Reference.js";
+import { isAsyncReactiveField } from "./relations/AsyncReactiveField.js";
+import "./relations/index.js";
+import { groupBy, maybePromiseThen } from "./utils.js";
+import "./typeMap.js";
+import "./changes.js";
+import { getEmInternalApi } from "./EntityManager.js";
+import "./Entity.js";
+//#region src/rules.ts
+let ValidationCode = /* @__PURE__ */ function(ValidationCode) {
+	ValidationCode["required"] = "required";
+	ValidationCode["cannotBeUpdated"] = "not-updatable";
+	ValidationCode["cannotBeChanged"] = "not-changeable";
+	ValidationCode["numeric"] = "not-numeric";
+	ValidationCode["minValue"] = "under-min";
+	ValidationCode["maxValue"] = "over-max";
+	return ValidationCode;
+}({});
 function errorMessage(errors) {
-    if (errors.length === 1) {
-        return `Validation error: ${errors[0].entity.toString()} ${errors[0].message}`;
-    }
-    else {
-        const message = [...(0, utils_1.groupBy)(errors, (e) => e.entity.toString()).entries()]
-            .map(([entityToString, errors]) => `${entityToString} ${errors.map((e) => e.message).join(", ")}`)
-            .join(", ");
-        return `Validation errors (${errors.length}): ${message}`;
-    }
+	if (errors.length === 1) return `Validation error: ${errors[0].entity.toString()} ${errors[0].message}`;
+	else {
+		const message = [...groupBy(errors, (e) => e.entity.toString()).entries()].map(([entityToString, errors]) => `${entityToString} ${errors.map((e) => e.message).join(", ")}`).join(", ");
+		return `Validation errors (${errors.length}): ${message}`;
+	}
 }
-class ValidationErrors extends Error {
-    errors;
-    toJSON;
-    constructor(messageOrErrors) {
-        super(typeof messageOrErrors === "string" ? messageOrErrors : errorMessage(messageOrErrors));
-        this.errors = typeof messageOrErrors === "string" ? [{ message: messageOrErrors }] : messageOrErrors;
-        // Jest clones without prototype, so explictly setting this as a property rather than a class method
-        // https://github.com/jestjs/jest/issues/11958
-        this.toJSON = () => `ValidationErrors: ${this.message}`;
-    }
-}
-exports.ValidationErrors = ValidationErrors;
+var ValidationErrors = class extends Error {
+	errors;
+	toJSON;
+	constructor(messageOrErrors) {
+		super(typeof messageOrErrors === "string" ? messageOrErrors : errorMessage(messageOrErrors));
+		this.errors = typeof messageOrErrors === "string" ? [{ message: messageOrErrors }] : messageOrErrors;
+		this.toJSON = () => `ValidationErrors: ${this.message}`;
+	}
+};
 function ruleWithOpts(opts, fn) {
-    return (entity) => {
-        // Since all of our rules are sync, we run the rule first, then check if we should have run it second since this
-        // may be an async operation.  This way we can avoid running promises if we don't have to.
-        const result = fn(entity);
-        if (result === undefined)
-            return;
-        const { unless, if: _if } = opts ?? {};
-        if (unless === undefined && _if === undefined)
-            return result;
-        const shouldRun = [unless ?? (() => false), _if ?? (() => true)].map((fn) => fn(entity));
-        return (0, utils_1.maybePromiseThen)(shouldRun.some((r) => r instanceof Promise) ? Promise.all(shouldRun) : shouldRun, ([unless, _if]) => (!unless && _if ? result : undefined));
-    };
+	return (entity) => {
+		const result = fn(entity);
+		if (result === void 0) return;
+		const { unless, if: _if } = opts ?? {};
+		if (unless === void 0 && _if === void 0) return result;
+		const shouldRun = [unless ?? (() => false), _if ?? (() => true)].map((fn) => fn(entity));
+		return maybePromiseThen(shouldRun.some((r) => r instanceof Promise) ? Promise.all(shouldRun) : shouldRun, ([unless, _if]) => !unless && _if ? result : void 0);
+	};
 }
 /**
- * Creates a validation rule for required fields.
- *
- * This is added automatically by codegen to entities based on FK not-nulls.
- */
+* Creates a validation rule for required fields.
+*
+* This is added automatically by codegen to entities based on FK not-nulls.
+*/
 function newRequiredRule(key, opts = {}) {
-    return ruleWithOpts(opts, (entity) => {
-        // Use getField so that we peer through relations
-        if ((0, fields_1.getField)(entity, key) === undefined) {
-            // Sanity check for AsyncReactiveFields--this should be cheap to just always do; alternatively we could
-            // have a RQF-specific `rqfRequiredRule` so that other `newRequiredRule` users don't pay the cost of these
-            // two `if` checks`.
-            if (entity.isNewEntity && (0, relations_1.isAsyncReactiveField)(entity[key])) {
-                throw new Error(`AsyncReactiveField ${entity.constructor.name}.${key} must have a default value, either in the database or with config.setDefault (see the 4th step in https://joist-orm.io/modeling/reactive-fields/#async-reactive-fields.`);
-            }
-            return { field: key, code: ValidationCode.required, message: `${key} is required` };
-        }
-    });
+	return ruleWithOpts(opts, (entity) => {
+		if (getField(entity, key) === void 0) {
+			if (entity.isNewEntity && isAsyncReactiveField(entity[key])) throw new Error(`AsyncReactiveField ${entity.constructor.name}.${key} must have a default value, either in the database or with config.setDefault (see the 4th step in https://joist-orm.io/modeling/reactive-fields/#async-reactive-fields.`);
+			return {
+				field: key,
+				code: "required",
+				message: `${key} is required`
+			};
+		}
+	});
+}
+/**
+* Like `newRequiredRule`, but for `lazy` columns (i.e. codegen only wires this up for `lazy` fields).
+*
+* On an already-persisted entity that hasn't loaded the column, we skip the check rather than force-load
+* (or falsely fail) a value that was required when the row was last saved. It still fires on create and
+* when the field is explicitly loaded-then-unset.
+*/
+function newRequiredLazyFieldRule(key, opts = {}) {
+	return ruleWithOpts(opts, (entity) => {
+		if (!entity.isNewEntity && !entity[key].isLoaded) return;
+		if (getField(entity, key) === void 0) return {
+			field: key,
+			code: "required",
+			message: `${key} is required`
+		};
+	});
 }
 function cannotBeUpdated(field, optsOrUnless) {
-    const opts = typeof optsOrUnless === "function" ? { unless: optsOrUnless } : (optsOrUnless ?? {});
-    const fn = ruleWithOpts(opts, (entity) => {
-        // For now putting the `EntityChanges` cast here to avoid breaking cannotBeUpdated rules
-        // on base types, see Publisher.ts's `cannotBeUpdated("type")` repro.
-        if (entity.changes[field].hasUpdated) {
-            const value = entity[field];
-            // If we're being changed b/c of an em.merge, that is okay
-            if ((0, relations_1.isLoadedReference)(value) && (0, EntityManager_1.getEmInternalApi)(entity.em).isMerging(value.get))
-                return;
-            return { field, code: ValidationCode.cannotBeUpdated, message: `${field} cannot be updated` };
-        }
-        return;
-    });
-    return Object.assign(fn, { field, immutable: opts.unless === undefined && opts.if === undefined });
+	const opts = typeof optsOrUnless === "function" ? { unless: optsOrUnless } : optsOrUnless ?? {};
+	const fn = ruleWithOpts(opts, (entity) => {
+		if (entity.changes[field].hasUpdated) {
+			const value = entity[field];
+			if (isLoadedReference(value) && getEmInternalApi(entity.em).isMerging(value.get)) return;
+			return {
+				field,
+				code: "not-updatable",
+				message: `${field} cannot be updated`
+			};
+		}
+	});
+	return Object.assign(fn, {
+		field,
+		immutable: opts.unless === void 0 && opts.if === void 0
+	});
 }
 /**
- * Creates a validation rule that a field cannot be changed once set.
- *
- * If the optional `unless` function returns true, then the update is allowed.
- */
+* Creates a validation rule that a field cannot be changed once set.
+*
+* If the optional `unless` function returns true, then the update is allowed.
+*/
 function cannotBeChanged(field, opts) {
-    return ruleWithOpts(opts, (entity) => {
-        const changes = entity.changes[field];
-        if (changes.kind === "m2m" || changes.kind === "o2m" || changes.kind === "m2mEnum") {
-            throw new Error("cannotBeChanged is only supported on primitive & m2o fields");
-        }
-        else if (changes.hasUpdated) {
-            const originalValue = changes.originalValue;
-            if (originalValue === undefined)
-                return;
-            const value = (0, fields_1.getField)(entity, field);
-            if ((0, EntityManager_1.getEmInternalApi)(entity.em).isMerging(value))
-                return;
-            return { field, code: ValidationCode.cannotBeChanged, message: `${field} cannot be changed` };
-        }
-        return;
-    });
+	return ruleWithOpts(opts, (entity) => {
+		const changes = entity.changes[field];
+		if (changes.kind === "m2m" || changes.kind === "o2m" || changes.kind === "m2mEnum") throw new Error("cannotBeChanged is only supported on primitive & m2o fields");
+		else if (changes.hasUpdated) {
+			if (changes.originalValue === void 0) return;
+			const value = getField(entity, field);
+			if (getEmInternalApi(entity.em).isMerging(value)) return;
+			return {
+				field,
+				code: "not-changeable",
+				message: `${field} cannot be changed`
+			};
+		}
+	});
 }
 function isCannotBeUpdatedRule(rule) {
-    return "field" in rule && "immutable" in rule;
+	return "field" in rule && "immutable" in rule;
 }
 /** For STI, enforces subtype-specific relations/FKs at runtime. */
 function mustBeSubType(relationName, opts = {}) {
-    return ruleWithOpts(opts, (entity) => {
-        const m2o = entity[relationName];
-        const other = m2o.get;
-        const otherCstr = m2o.otherMeta.cstr;
-        if (other && !(other instanceof otherCstr)) {
-            return `${relationName} must be a ${otherCstr.name} not ${other}`;
-        }
-    });
+	return ruleWithOpts(opts, (entity) => {
+		const m2o = entity[relationName];
+		const other = m2o.get;
+		const otherCstr = m2o.otherMeta.cstr;
+		if (other && !(other instanceof otherCstr)) return `${relationName} must be a ${otherCstr.name} not ${other}`;
+	});
 }
 /**
- * Creates a validation rule that a field value cannot be smaller than a
- * certain value.
- *
- * @param field The field to validate
- * @param minValue The inclusive minimum value. e.g 0 range is [0, Infinity]
- * @param opts Optional validation rule options that control when the rule should run:
- *   - unless: Function that returns true to skip validation
- *   - if: Function that returns true to run validation
- *
- * @example
- * // Age cannot be smaller than 0
- * config.addRule(minValueRule("age", 0));
- */
+* Creates a validation rule that a field value cannot be smaller than a
+* certain value.
+*
+* @param field The field to validate
+* @param minValue The inclusive minimum value. e.g 0 range is [0, Infinity]
+* @param opts Optional validation rule options that control when the rule should run:
+*   - unless: Function that returns true to skip validation
+*   - if: Function that returns true to run validation
+*
+* @example
+* // Age cannot be smaller than 0
+* config.addRule(minValueRule("age", 0));
+*/
 function minValueRule(field, minValue, opts = {}) {
-    return ruleWithOpts(opts, (entity) => {
-        const value = entity[field];
-        // Ignore undefined and null values. These should be handled by required rules
-        if (value === undefined || value === null)
-            return;
-        // Show an error when the value type is not a number
-        if (typeof value !== "number") {
-            return { field, code: ValidationCode.numeric, message: `${field} must be a number` };
-        }
-        // Show an error when the value is smaller than the minimum value
-        if (value < minValue) {
-            return {
-                field,
-                code: ValidationCode.minValue,
-                message: `${field} must be greater than or equal to ${minValue}`,
-            };
-        }
-        return;
-    });
+	return ruleWithOpts(opts, (entity) => {
+		const value = entity[field];
+		if (value === void 0 || value === null) return;
+		if (typeof value !== "number") return {
+			field,
+			code: "not-numeric",
+			message: `${field} must be a number`
+		};
+		if (value < minValue) return {
+			field,
+			code: "under-min",
+			message: `${field} must be greater than or equal to ${minValue}`
+		};
+	});
 }
 /**
- * Creates a validation rule that a field value cannot be greater than a
- * certain value.
- *
- * @param field The field to validate
- * @param maxValue The include maximum value. e.g 10 range is [-Infinity, 10]
- * @param opts Optional validation rule options that control when the rule should run:
- *   - unless: Function that returns true to skip validation
- *   - if: Function that returns true to run validation
- *
- * @example
- * // Age cannot be greater than 150
- * config.addRule(maxValueRule("age", 150));
- */
+* Creates a validation rule that a field value cannot be greater than a
+* certain value.
+*
+* @param field The field to validate
+* @param maxValue The include maximum value. e.g 10 range is [-Infinity, 10]
+* @param opts Optional validation rule options that control when the rule should run:
+*   - unless: Function that returns true to skip validation
+*   - if: Function that returns true to run validation
+*
+* @example
+* // Age cannot be greater than 150
+* config.addRule(maxValueRule("age", 150));
+*/
 function maxValueRule(field, maxValue, opts = {}) {
-    return ruleWithOpts(opts, (entity) => {
-        const value = entity[field];
-        // Ignore undefined and null values. These should be handled by required rules
-        if (value === undefined || value === null)
-            return;
-        // Show an error when the value type is not a number
-        if (typeof value !== "number") {
-            return { field, code: ValidationCode.numeric, message: `${field} must be a number` };
-        }
-        // Show an error when the value is smaller than the minimum value
-        if (value > maxValue) {
-            return {
-                field,
-                code: ValidationCode.maxValue,
-                message: `${field} must be smaller than or equal to ${maxValue}`,
-            };
-        }
-        return;
-    });
+	return ruleWithOpts(opts, (entity) => {
+		const value = entity[field];
+		if (value === void 0 || value === null) return;
+		if (typeof value !== "number") return {
+			field,
+			code: "not-numeric",
+			message: `${field} must be a number`
+		};
+		if (value > maxValue) return {
+			field,
+			code: "over-max",
+			message: `${field} must be smaller than or equal to ${maxValue}`
+		};
+	});
 }
 /**
- * Creates a validation rule that a field value must be within a range of
- * certain values
- *
- * @param field The field to validate
- * @param minValue The inclusive minimum value. e.g  0 [0,   Infinity]
- * @param maxValue The include maximum value.   e.g 10 [-Infinity, 10]
- * @param opts Optional validation rule options that control when the rule should run:
- *   - unless: Function that returns true to skip validation
- *   - if: Function that returns true to run validation * @example
- *
- * // Age must be between 0 and 150
- * config.addRule(rangeValueRule("age", 0, 150));
- */
+* Creates a validation rule that a field value must be within a range of
+* certain values
+*
+* @param field The field to validate
+* @param minValue The inclusive minimum value. e.g  0 [0,   Infinity]
+* @param maxValue The include maximum value.   e.g 10 [-Infinity, 10]
+* @param opts Optional validation rule options that control when the rule should run:
+*   - unless: Function that returns true to skip validation
+*   - if: Function that returns true to run validation * @example
+*
+* // Age must be between 0 and 150
+* config.addRule(rangeValueRule("age", 0, 150));
+*/
 function rangeValueRule(field, minValue, maxValue, opts = {}) {
-    return ruleWithOpts(opts, (entity) => {
-        // Check min and max value rules.  Because these are called without opts, it should be safe to treat them as sync.
-        const minValueResult = minValueRule(field, minValue)(entity);
-        const maxValueResult = maxValueRule(field, maxValue)(entity);
-        // Return any errors or nothing
-        if (minValueResult)
-            return minValueResult;
-        if (maxValueResult)
-            return maxValueResult;
-        return;
-    });
+	return ruleWithOpts(opts, (entity) => {
+		const minValueResult = minValueRule(field, minValue)(entity);
+		const maxValueResult = maxValueRule(field, maxValue)(entity);
+		if (minValueResult) return minValueResult;
+		if (maxValueResult) return maxValueResult;
+	});
 }
+//#endregion
+export { ValidationCode, ValidationErrors, cannotBeChanged, cannotBeUpdated, isCannotBeUpdatedRule, maxValueRule, minValueRule, mustBeSubType, newRequiredLazyFieldRule, newRequiredRule, rangeValueRule };
+
 //# sourceMappingURL=rules.js.map

package/build/rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"rules.js","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rules.js","names":[],"sources":["../src/rules.ts"],"sourcesContent":["import { type Changes, type EntityChanges } from \"src/changes.ts\";\nimport { type Entity } from \"src/Entity.ts\";\nimport { getEmInternalApi } from \"src/EntityManager.ts\";\nimport { getField } from \"src/fields.ts\";\nimport type { ReactiveHint } from \"src/reactivity/reactiveHints.ts\";\nimport { type ManyToOneReferenceImpl, isAsyncReactiveField, isLoadedReference } from \"src/relations/index.ts\";\nimport { type FieldsOf } from \"src/typeMap.ts\";\nimport { type MaybePromise, groupBy, maybePromiseThen } from \"src/utils.ts\";\n\nexport enum ValidationCode {\n  required = \"required\",\n  cannotBeUpdated = \"not-updatable\",\n  cannotBeChanged = \"not-changeable\",\n  numeric = \"not-numeric\",\n  minValue = \"under-min\",\n  maxValue = \"over-max\",\n}\n\n/**\n * The return type of `ValidationRule` lambdas.\n *\n * We're flexible and allow rules to return a variety of shapes, like just a string, string[], etc.\n *\n * Returning `undefined` means the rule passed.\n */\nexport type ValidationRuleResult = string | string[] | GenericError | GenericError[] | undefined | void;\n\n/** An entity validation rule. */\nexport type ValidationRule<T extends Entity> = (entity: T) => MaybePromise<ValidationRuleResult>;\n\n/** Internal metadata for an async/reactive validation rule. */\nexport type ValidationRuleInternal<T extends Entity> = {\n  name: string;\n  hint: ReactiveHint<T> | undefined;\n  fn: ValidationRule<T>;\n};\n\n/** A generic error which contains a message, and optional field/codes. */\nexport type GenericError = { message: string; field?: string; code?: string };\n\n/** Combines the GenericError with the `entity` that caused it. */\nexport type ValidationError = { entity: Entity } & GenericError;\n\nexport type ValidationRuleOptsFn<T extends Entity> = (entity: T) => MaybePromise<boolean>;\nexport type ValidationRuleOpts<T extends Entity> = {\n  unless?: ValidationRuleOptsFn<T>;\n  if?: ValidationRuleOptsFn<T>;\n};\n\nfunction errorMessage(errors: ValidationError[]): string {\n  if (errors.length === 1) {\n    return `Validation error: ${errors[0].entity.toString()} ${errors[0].message}`;\n  } else {\n    const message = [...groupBy(errors, (e) => e.entity.toString()).entries()]\n      .map(([entityToString, errors]) => `${entityToString} ${errors.map((e) => e.message).join(\", \")}`)\n      .join(\", \");\n    return `Validation errors (${errors.length}): ${message}`;\n  }\n}\n\nexport class ValidationErrors extends Error {\n  public errors: Array<GenericError | ValidationError>;\n  public readonly toJSON: () => string;\n  constructor(errors: ValidationError[]);\n  constructor(message: string);\n  constructor(messageOrErrors: ValidationError[] | string) {\n    super(typeof messageOrErrors === \"string\" ? messageOrErrors : errorMessage(messageOrErrors));\n    this.errors = typeof messageOrErrors === \"string\" ? [{ message: messageOrErrors }] : messageOrErrors;\n    // Jest clones without prototype, so explictly setting this as a property rather than a class method\n    // https://github.com/jestjs/jest/issues/11958\n    this.toJSON = () => `ValidationErrors: ${this.message}`;\n  }\n}\n\nfunction ruleWithOpts<T extends Entity>(\n  opts: ValidationRuleOpts<T> | undefined,\n  fn: (entity: T) => ValidationRuleResult,\n): ValidationRule<T> {\n  return (entity) => {\n    // Since all of our rules are sync, we run the rule first, then check if we should have run it second since this\n    // may be an async operation.  This way we can avoid running promises if we don't have to.\n    const result = fn(entity);\n    if (result === undefined) return;\n    const { unless, if: _if } = opts ?? {};\n    if (unless === undefined && _if === undefined) return result;\n    const shouldRun = [unless ?? (() => false), _if ?? (() => true)].map((fn) => fn(entity));\n    return maybePromiseThen(\n      shouldRun.some((r) => r instanceof Promise) ? Promise.all(shouldRun) : (shouldRun as boolean[]),\n      ([unless, _if]) => (!unless && _if ? result : undefined),\n    );\n  };\n}\n\n/**\n * The fields of `F` that have their own column, i.e. what a required rule can check.\n *\n * The filter is an allow-list (\"keep kinds primitive/enum/m2o/poly\"), not a deny-list (\"drop kind\n * o2o\"), because of how it degrades when `T` is generic/uninferred: `FieldsOf<T>` is then `never`,\n * and `never extends X` is true for any `X`, so an allow-list keeps every key (permissive, exactly\n * like the unfiltered `keyof FieldsOf<T>` before it) while a deny-list would drop every key and\n * break valid calls like `newRequiredRule(\"city\")`.\n */\ntype ColumnBackedFields<F> = {\n  [K in keyof F as F[K] extends { kind: \"primitive\" | \"enum\" | \"m2o\" | \"poly\" } ? K : never]: F[K];\n};\n\n/**\n * Creates a validation rule for required fields.\n *\n * This is added automatically by codegen to entities based on FK not-nulls.\n */\nexport function newRequiredRule<T extends Entity>(\n  key: keyof ColumnBackedFields<FieldsOf<T>> & string,\n  opts: ValidationRuleOpts<T> = {},\n): ValidationRule<T> {\n  return ruleWithOpts(opts, (entity) => {\n    // Use getField so that we peer through relations\n    if (getField(entity, key) === undefined) {\n      // Sanity check for AsyncReactiveFields--this should be cheap to just always do; alternatively we could\n      // have a RQF-specific `rqfRequiredRule` so that other `newRequiredRule` users don't pay the cost of these\n      // two `if` checks`.\n      if (entity.isNewEntity && isAsyncReactiveField((entity as any)[key])) {\n        throw new Error(\n          `AsyncReactiveField ${entity.constructor.name}.${key} must have a default value, either in the database or with config.setDefault (see the 4th step in https://joist-orm.io/modeling/reactive-fields/#async-reactive-fields.`,\n        );\n      }\n      return { field: key, code: ValidationCode.required, message: `${key} is required` };\n    }\n  });\n}\n\n/**\n * Like `newRequiredRule`, but for `lazy` columns (i.e. codegen only wires this up for `lazy` fields).\n *\n * On an already-persisted entity that hasn't loaded the column, we skip the check rather than force-load\n * (or falsely fail) a value that was required when the row was last saved. It still fires on create and\n * when the field is explicitly loaded-then-unset.\n */\nexport function newRequiredLazyFieldRule<T extends Entity>(\n  key: keyof FieldsOf<T> & string,\n  opts: ValidationRuleOpts<T> = {},\n): ValidationRule<T> {\n  return ruleWithOpts(opts, (entity) => {\n    if (!entity.isNewEntity && !(entity as any)[key].isLoaded) return;\n    if (getField(entity, key) === undefined) {\n      return { field: key, code: ValidationCode.required, message: `${key} is required` };\n    }\n  });\n}\n\n/**\n * Creates a validation rule that a field cannot be updated; it can only be set on creation.\n *\n * If the optional `unless` function returns true, then the update is allowed.\n */\nexport function cannotBeUpdated<T extends Entity, K extends keyof Changes<T> & string>(\n  field: K,\n  opts?: ValidationRuleOpts<T>,\n): CannotBeUpdatedRule<T>;\nexport function cannotBeUpdated<T extends Entity, K extends keyof Changes<T> & string>(\n  field: K,\n  unless?: ValidationRuleOptsFn<T>,\n): CannotBeUpdatedRule<T>;\nexport function cannotBeUpdated<T extends Entity, K extends keyof Changes<T> & string>(\n  field: K,\n  optsOrUnless?: ValidationRuleOpts<T> | ValidationRuleOptsFn<T>,\n): CannotBeUpdatedRule<T> {\n  const opts = typeof optsOrUnless === \"function\" ? { unless: optsOrUnless } : (optsOrUnless ?? {});\n  const fn = ruleWithOpts(opts, (entity: T) => {\n    // For now putting the `EntityChanges` cast here to avoid breaking cannotBeUpdated rules\n    // on base types, see Publisher.ts's `cannotBeUpdated(\"type\")` repro.\n    if ((entity as any as EntityChanges<T>).changes[field].hasUpdated) {\n      const value = (entity as any)[field];\n      // If we're being changed b/c of an em.merge, that is okay\n      if (isLoadedReference(value) && getEmInternalApi(entity.em).isMerging(value.get)) return;\n      return { field, code: ValidationCode.cannotBeUpdated, message: `${field} cannot be updated` };\n    }\n    return;\n  });\n  return Object.assign(fn, { field, immutable: opts.unless === undefined && opts.if === undefined });\n}\n\n/**\n * Creates a validation rule that a field cannot be changed once set.\n *\n * If the optional `unless` function returns true, then the update is allowed.\n */\nexport function cannotBeChanged<T extends Entity, K extends keyof Changes<T> & string>(\n  field: K,\n  opts?: ValidationRuleOpts<T>,\n): ValidationRule<T> {\n  return ruleWithOpts(opts, (entity: T) => {\n    const changes = (entity as any as EntityChanges<T>).changes[field];\n    if (changes.kind === \"m2m\" || changes.kind === \"o2m\" || changes.kind === \"m2mEnum\") {\n      throw new Error(\"cannotBeChanged is only supported on primitive & m2o fields\");\n    } else if (changes.hasUpdated) {\n      const originalValue = changes.originalValue;\n      if (originalValue === undefined) return;\n      const value = getField(entity, field);\n      if (getEmInternalApi(entity.em).isMerging(value)) return;\n      return { field, code: ValidationCode.cannotBeChanged, message: `${field} cannot be changed` };\n    }\n    return;\n  });\n}\n\ntype CannotBeUpdatedRule<T extends Entity> = ValidationRule<T> & { field: string; immutable: boolean };\n\nexport function isCannotBeUpdatedRule(rule: Function): rule is CannotBeUpdatedRule<any> {\n  return \"field\" in rule && \"immutable\" in rule;\n}\n\n/** For STI, enforces subtype-specific relations/FKs at runtime. */\nexport function mustBeSubType<T extends Entity, K extends keyof Changes<T> & string>(\n  relationName: K,\n  opts: ValidationRuleOpts<T> = {},\n): ValidationRule<T> {\n  return ruleWithOpts(opts, (entity) => {\n    const m2o = (entity as any)[relationName] as ManyToOneReferenceImpl<any, any, any>;\n    const other = m2o.get;\n    const otherCstr = m2o.otherMeta.cstr;\n    if (other && !(other instanceof otherCstr)) {\n      return `${relationName} must be a ${otherCstr.name} not ${other}`;\n    }\n  });\n}\n\n/**\n * Creates a validation rule that a field value cannot be smaller than a\n * certain value.\n *\n * @param field The field to validate\n * @param minValue The inclusive minimum value. e.g 0 range is [0, Infinity]\n * @param opts Optional validation rule options that control when the rule should run:\n *   - unless: Function that returns true to skip validation\n *   - if: Function that returns true to run validation\n *\n * @example\n * // Age cannot be smaller than 0\n * config.addRule(minValueRule(\"age\", 0));\n */\nexport function minValueRule<T extends Entity, K extends keyof T & string>(\n  field: K,\n  minValue: number,\n  opts: ValidationRuleOpts<T> = {},\n): ValidationRule<T> {\n  return ruleWithOpts(opts, (entity) => {\n    const value = entity[field];\n    // Ignore undefined and null values. These should be handled by required rules\n    if (value === undefined || value === null) return;\n    // Show an error when the value type is not a number\n    if (typeof value !== \"number\") {\n      return { field, code: ValidationCode.numeric, message: `${field} must be a number` };\n    }\n    // Show an error when the value is smaller than the minimum value\n    if (value < minValue) {\n      return {\n        field,\n        code: ValidationCode.minValue,\n        message: `${field} must be greater than or equal to ${minValue}`,\n      };\n    }\n    return;\n  });\n}\n\n/**\n * Creates a validation rule that a field value cannot be greater than a\n * certain value.\n *\n * @param field The field to validate\n * @param maxValue The include maximum value. e.g 10 range is [-Infinity, 10]\n * @param opts Optional validation rule options that control when the rule should run:\n *   - unless: Function that returns true to skip validation\n *   - if: Function that returns true to run validation\n *\n * @example\n * // Age cannot be greater than 150\n * config.addRule(maxValueRule(\"age\", 150));\n */\nexport function maxValueRule<T extends Entity, K extends keyof T & string>(\n  field: K,\n  maxValue: number,\n  opts: ValidationRuleOpts<T> = {},\n): ValidationRule<T> {\n  return ruleWithOpts(opts, (entity) => {\n    const value = entity[field];\n    // Ignore undefined and null values. These should be handled by required rules\n    if (value === undefined || value === null) return;\n    // Show an error when the value type is not a number\n    if (typeof value !== \"number\") {\n      return { field, code: ValidationCode.numeric, message: `${field} must be a number` };\n    }\n    // Show an error when the value is smaller than the minimum value\n    if (value > maxValue) {\n      return {\n        field,\n        code: ValidationCode.maxValue,\n        message: `${field} must be smaller than or equal to ${maxValue}`,\n      };\n    }\n    return;\n  });\n}\n\n/**\n * Creates a validation rule that a field value must be within a range of\n * certain values\n *\n * @param field The field to validate\n * @param minValue The inclusive minimum value. e.g  0 [0,   Infinity]\n * @param maxValue The include maximum value.   e.g 10 [-Infinity, 10]\n * @param opts Optional validation rule options that control when the rule should run:\n *   - unless: Function that returns true to skip validation\n *   - if: Function that returns true to run validation * @example\n *\n * // Age must be between 0 and 150\n * config.addRule(rangeValueRule(\"age\", 0, 150));\n */\nexport function rangeValueRule<T extends Entity, K extends keyof T & string>(\n  field: K,\n  minValue: number,\n  maxValue: number,\n  opts: ValidationRuleOpts<T> = {},\n): ValidationRule<T> {\n  return ruleWithOpts(opts, (entity) => {\n    // Check min and max value rules.  Because these are called without opts, it should be safe to treat them as sync.\n    const minValueResult = minValueRule<T, K>(field, minValue)(entity) as ValidationRuleResult;\n    const maxValueResult = maxValueRule<T, K>(field, maxValue)(entity) as ValidationRuleResult;\n    // Return any errors or nothing\n    if (minValueResult) return minValueResult;\n    if (maxValueResult) return maxValueResult;\n    return;\n  });\n}\n"],"mappings":";;;;;;;;;;AASA,IAAY,iBAAL,yBAAA,gBAAA;CACL,eAAA,cAAA;CACA,eAAA,qBAAA;CACA,eAAA,qBAAA;CACA,eAAA,aAAA;CACA,eAAA,cAAA;CACA,eAAA,cAAA;;AACF,EAAA,CAAA,CAAA;AAiCA,SAAS,aAAa,QAAmC;CACvD,IAAI,OAAO,WAAW,GACpB,OAAO,qBAAqB,OAAO,EAAE,CAAC,OAAO,SAAS,EAAE,GAAG,OAAO,EAAE,CAAC;MAChE;EACL,MAAM,UAAU,CAAC,GAAG,QAAQ,SAAS,MAAM,EAAE,OAAO,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CACvE,KAAK,CAAC,gBAAgB,YAAY,GAAG,eAAe,GAAG,OAAO,KAAK,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CACjG,KAAK,IAAI;EACZ,OAAO,sBAAsB,OAAO,OAAO,KAAK;CAClD;AACF;AAEA,IAAa,mBAAb,cAAsC,MAAM;CAC1C;CACA;CAGA,YAAY,iBAA6C;EACvD,MAAM,OAAO,oBAAoB,WAAW,kBAAkB,aAAa,eAAe,CAAC;EAC3F,KAAK,SAAS,OAAO,oBAAoB,WAAW,CAAC,EAAE,SAAS,gBAAgB,CAAC,IAAI;EAGrF,KAAK,eAAe,qBAAqB,KAAK;CAChD;AACF;AAEA,SAAS,aACP,MACA,IACmB;CACnB,QAAQ,WAAW;EAGjB,MAAM,SAAS,GAAG,MAAM;EACxB,IAAI,WAAW,KAAA,GAAW;EAC1B,MAAM,EAAE,QAAQ,IAAI,QAAQ,QAAQ,CAAC;EACrC,IAAI,WAAW,KAAA,KAAa,QAAQ,KAAA,GAAW,OAAO;EACtD,MAAM,YAAY,CAAC,iBAAiB,QAAQ,cAAc,KAAK,CAAC,CAAC,KAAK,OAAO,GAAG,MAAM,CAAC;EACvF,OAAO,iBACL,UAAU,MAAM,MAAM,aAAa,OAAO,IAAI,QAAQ,IAAI,SAAS,IAAK,YACvE,CAAC,QAAQ,SAAU,CAAC,UAAU,MAAM,SAAS,KAAA,CAChD;CACF;AACF;;;;;;AAoBA,SAAgB,gBACd,KACA,OAA8B,CAAC,GACZ;CACnB,OAAO,aAAa,OAAO,WAAW;EAEpC,IAAI,SAAS,QAAQ,GAAG,MAAM,KAAA,GAAW;GAIvC,IAAI,OAAO,eAAe,qBAAsB,OAAe,IAAI,GACjE,MAAM,IAAI,MACR,sBAAsB,OAAO,YAAY,KAAK,GAAG,IAAI,wKACvD;GAEF,OAAO;IAAE,OAAO;IAAK,MAAA;IAA+B,SAAS,GAAG,IAAI;GAAc;EACpF;CACF,CAAC;AACH;;;;;;;;AASA,SAAgB,yBACd,KACA,OAA8B,CAAC,GACZ;CACnB,OAAO,aAAa,OAAO,WAAW;EACpC,IAAI,CAAC,OAAO,eAAe,CAAE,OAAe,IAAI,CAAC,UAAU;EAC3D,IAAI,SAAS,QAAQ,GAAG,MAAM,KAAA,GAC5B,OAAO;GAAE,OAAO;GAAK,MAAA;GAA+B,SAAS,GAAG,IAAI;EAAc;CAEtF,CAAC;AACH;AAeA,SAAgB,gBACd,OACA,cACwB;CACxB,MAAM,OAAO,OAAO,iBAAiB,aAAa,EAAE,QAAQ,aAAa,IAAK,gBAAgB,CAAC;CAC/F,MAAM,KAAK,aAAa,OAAO,WAAc;EAG3C,IAAK,OAAmC,QAAQ,MAAM,CAAC,YAAY;GACjE,MAAM,QAAS,OAAe;GAE9B,IAAI,kBAAkB,KAAK,KAAK,iBAAiB,OAAO,EAAE,CAAC,CAAC,UAAU,MAAM,GAAG,GAAG;GAClF,OAAO;IAAE;IAAO,MAAA;IAAsC,SAAS,GAAG,MAAM;GAAoB;EAC9F;CAEF,CAAC;CACD,OAAO,OAAO,OAAO,IAAI;EAAE;EAAO,WAAW,KAAK,WAAW,KAAA,KAAa,KAAK,OAAO,KAAA;CAAU,CAAC;AACnG;;;;;;AAOA,SAAgB,gBACd,OACA,MACmB;CACnB,OAAO,aAAa,OAAO,WAAc;EACvC,MAAM,UAAW,OAAmC,QAAQ;EAC5D,IAAI,QAAQ,SAAS,SAAS,QAAQ,SAAS,SAAS,QAAQ,SAAS,WACvE,MAAM,IAAI,MAAM,6DAA6D;OACxE,IAAI,QAAQ,YAAY;GAE7B,IADsB,QAAQ,kBACR,KAAA,GAAW;GACjC,MAAM,QAAQ,SAAS,QAAQ,KAAK;GACpC,IAAI,iBAAiB,OAAO,EAAE,CAAC,CAAC,UAAU,KAAK,GAAG;GAClD,OAAO;IAAE;IAAO,MAAA;IAAsC,SAAS,GAAG,MAAM;GAAoB;EAC9F;CAEF,CAAC;AACH;AAIA,SAAgB,sBAAsB,MAAkD;CACtF,OAAO,WAAW,QAAQ,eAAe;AAC3C;;AAGA,SAAgB,cACd,cACA,OAA8B,CAAC,GACZ;CACnB,OAAO,aAAa,OAAO,WAAW;EACpC,MAAM,MAAO,OAAe;EAC5B,MAAM,QAAQ,IAAI;EAClB,MAAM,YAAY,IAAI,UAAU;EAChC,IAAI,SAAS,EAAE,iBAAiB,YAC9B,OAAO,GAAG,aAAa,aAAa,UAAU,KAAK,OAAO;CAE9D,CAAC;AACH;;;;;;;;;;;;;;;AAgBA,SAAgB,aACd,OACA,UACA,OAA8B,CAAC,GACZ;CACnB,OAAO,aAAa,OAAO,WAAW;EACpC,MAAM,QAAQ,OAAO;EAErB,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM;EAE3C,IAAI,OAAO,UAAU,UACnB,OAAO;GAAE;GAAO,MAAA;GAA8B,SAAS,GAAG,MAAM;EAAmB;EAGrF,IAAI,QAAQ,UACV,OAAO;GACL;GACA,MAAA;GACA,SAAS,GAAG,MAAM,oCAAoC;EACxD;CAGJ,CAAC;AACH;;;;;;;;;;;;;;;AAgBA,SAAgB,aACd,OACA,UACA,OAA8B,CAAC,GACZ;CACnB,OAAO,aAAa,OAAO,WAAW;EACpC,MAAM,QAAQ,OAAO;EAErB,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM;EAE3C,IAAI,OAAO,UAAU,UACnB,OAAO;GAAE;GAAO,MAAA;GAA8B,SAAS,GAAG,MAAM;EAAmB;EAGrF,IAAI,QAAQ,UACV,OAAO;GACL;GACA,MAAA;GACA,SAAS,GAAG,MAAM,oCAAoC;EACxD;CAGJ,CAAC;AACH;;;;;;;;;;;;;;;AAgBA,SAAgB,eACd,OACA,UACA,UACA,OAA8B,CAAC,GACZ;CACnB,OAAO,aAAa,OAAO,WAAW;EAEpC,MAAM,iBAAiB,aAAmB,OAAO,QAAQ,CAAC,CAAC,MAAM;EACjE,MAAM,iBAAiB,aAAmB,OAAO,QAAQ,CAAC,CAAC,MAAM;EAEjE,IAAI,gBAAgB,OAAO;EAC3B,IAAI,gBAAgB,OAAO;CAE7B,CAAC;AACH"}

package/build/runtimeConfig.cjs

@@ -0,0 +1,25 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_utils = require("./utils.cjs");
+//#region src/runtimeConfig.ts
+let runtimeConfig = void 0;
+function getRuntimeConfig() {
+	return runtimeConfig ?? require_utils.fail("setRuntimeConfig in metadata.ts has not been invoked yet");
+}
+/** Returns the runtime config if generated metadata has initialized it. */
+function maybeGetRuntimeConfig() {
+	return runtimeConfig;
+}
+/**
+* Called by the code-generated `metadata.ts` to pass along `joist-config.json` values.
+*
+* This avoids having to load/parse/ship the `joist-config.json` file at runtime.
+*/
+function setRuntimeConfig(config) {
+	runtimeConfig = config;
+}
+//#endregion
+exports.getRuntimeConfig = getRuntimeConfig;
+exports.maybeGetRuntimeConfig = maybeGetRuntimeConfig;
+exports.setRuntimeConfig = setRuntimeConfig;
+
+//# sourceMappingURL=runtimeConfig.cjs.map

package/build/runtimeConfig.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeConfig.cjs","names":["fail"],"sources":["../src/runtimeConfig.ts"],"sourcesContent":["import { fail } from \"src/utils.ts\";\n\nlet runtimeConfig: RuntimeConfig | undefined = undefined;\n\nexport function getRuntimeConfig(): RuntimeConfig {\n  return runtimeConfig ?? fail(\"setRuntimeConfig in metadata.ts has not been invoked yet\");\n}\n\n/** Returns the runtime config if generated metadata has initialized it. */\nexport function maybeGetRuntimeConfig(): RuntimeConfig | undefined {\n  return runtimeConfig;\n}\n\n/**\n * Holds any `joist-config.json` values that we want to access at runtime.\n */\nexport type RuntimeConfig = {\n  /** The process-wide tagged-id separator; explicit `undefined` means no separator, while omission defaults to `:`. */\n  tagDelimiter?: string | undefined;\n  temporal:\n    | false\n    | {\n        /** The application's default time zone, i.e. when we say \"now\", and store it as yyyy-MM-dd, what time zone should we use? */\n        timeZone: string;\n      };\n};\n\n/**\n * Called by the code-generated `metadata.ts` to pass along `joist-config.json` values.\n *\n * This avoids having to load/parse/ship the `joist-config.json` file at runtime.\n */\nexport function setRuntimeConfig(config: RuntimeConfig) {\n  runtimeConfig = config;\n}\n"],"mappings":";;;AAEA,IAAI,gBAA2C,KAAA;AAE/C,SAAgB,mBAAkC;CAChD,OAAO,iBAAiBA,cAAAA,KAAK,0DAA0D;AACzF;;AAGA,SAAgB,wBAAmD;CACjE,OAAO;AACT;;;;;;AAqBA,SAAgB,iBAAiB,QAAuB;CACtD,gBAAgB;AAClB"}

package/build/runtimeConfig.d.cts

@@ -0,0 +1,24 @@
+//#region src/runtimeConfig.d.ts
+declare function getRuntimeConfig(): RuntimeConfig;
+/** Returns the runtime config if generated metadata has initialized it. */
+declare function maybeGetRuntimeConfig(): RuntimeConfig | undefined;
+/**
+ * Holds any `joist-config.json` values that we want to access at runtime.
+ */
+type RuntimeConfig = {
+  /** The process-wide tagged-id separator; explicit `undefined` means no separator, while omission defaults to `:`. */
+  tagDelimiter?: string | undefined;
+  temporal: false | {
+    /** The application's default time zone, i.e. when we say "now", and store it as yyyy-MM-dd, what time zone should we use? */
+    timeZone: string;
+  };
+};
+/**
+ * Called by the code-generated `metadata.ts` to pass along `joist-config.json` values.
+ *
+ * This avoids having to load/parse/ship the `joist-config.json` file at runtime.
+ */
+declare function setRuntimeConfig(config: RuntimeConfig): void;
+//#endregion
+export { RuntimeConfig, getRuntimeConfig, maybeGetRuntimeConfig, setRuntimeConfig };
+//# sourceMappingURL=runtimeConfig.d.cts.map

package/build/runtimeConfig.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeConfig.d.cts","names":[],"sources":["../src/runtimeConfig.ts"],"mappings":";iBAIgB,oBAAoB;;iBAKpB,yBAAyB;;;;KAO7B;;EAEV;EACA;;IAIM;;;;;;;;iBASQ,iBAAiB,QAAQ"}

package/build/runtimeConfig.d.mts

@@ -0,0 +1,24 @@
+//#region src/runtimeConfig.d.ts
+declare function getRuntimeConfig(): RuntimeConfig;
+/** Returns the runtime config if generated metadata has initialized it. */
+declare function maybeGetRuntimeConfig(): RuntimeConfig | undefined;
+/**
+ * Holds any `joist-config.json` values that we want to access at runtime.
+ */
+type RuntimeConfig = {
+  /** The process-wide tagged-id separator; explicit `undefined` means no separator, while omission defaults to `:`. */
+  tagDelimiter?: string | undefined;
+  temporal: false | {
+    /** The application's default time zone, i.e. when we say "now", and store it as yyyy-MM-dd, what time zone should we use? */
+    timeZone: string;
+  };
+};
+/**
+ * Called by the code-generated `metadata.ts` to pass along `joist-config.json` values.
+ *
+ * This avoids having to load/parse/ship the `joist-config.json` file at runtime.
+ */
+declare function setRuntimeConfig(config: RuntimeConfig): void;
+//#endregion
+export { RuntimeConfig, getRuntimeConfig, maybeGetRuntimeConfig, setRuntimeConfig };
+//# sourceMappingURL=runtimeConfig.d.mts.map

package/build/runtimeConfig.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeConfig.d.mts","names":[],"sources":["../src/runtimeConfig.ts"],"mappings":";iBAIgB,oBAAoB;;iBAKpB,yBAAyB;;;;KAO7B;;EAEV;EACA;;IAIM;;;;;;;;iBASQ,iBAAiB,QAAQ"}

package/build/runtimeConfig.js

@@ -1,18 +1,22 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRuntimeConfig = getRuntimeConfig;
-exports.setRuntimeConfig = setRuntimeConfig;
-const utils_1 = require("./utils");
-let runtimeConfig = undefined;
+import { fail } from "./utils.js";
+//#region src/runtimeConfig.ts
+let runtimeConfig = void 0;
 function getRuntimeConfig() {
-    return runtimeConfig ?? (0, utils_1.fail)("setRuntimeConfig in metadata.ts has not been invoked yet");
+	return runtimeConfig ?? fail("setRuntimeConfig in metadata.ts has not been invoked yet");
+}
+/** Returns the runtime config if generated metadata has initialized it. */
+function maybeGetRuntimeConfig() {
+	return runtimeConfig;
 }
 /**
- * Called by the code-generated `metadata.ts` to pass along `joist-config.json` values.
- *
- * This avoids having to load/parse/ship the `joist-config.json` file at runtime.
- */
+* Called by the code-generated `metadata.ts` to pass along `joist-config.json` values.
+*
+* This avoids having to load/parse/ship the `joist-config.json` file at runtime.
+*/
 function setRuntimeConfig(config) {
-    runtimeConfig = config;
+	runtimeConfig = config;
 }
+//#endregion
+export { getRuntimeConfig, maybeGetRuntimeConfig, setRuntimeConfig };
+
 //# sourceMappingURL=runtimeConfig.js.map

package/build/runtimeConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeConfig.js","sourceRoot":"","sources":["../src/runtimeConfig.ts"],"names":[],"mappings":";;AAIA,4CAEC;AAmBD,4CAEC;AA3BD,mCAA+B;AAE/B,IAAI,aAAa,GAA8B,SAAS,CAAC;AAEzD,SAAgB,gBAAgB;IAC9B,OAAO,aAAa,IAAI,IAAA,YAAI,EAAC,0DAA0D,CAAC,CAAC;AAC3F,CAAC;AAcD;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,MAAqB;IACpD,aAAa,GAAG,MAAM,CAAC;AACzB,CAAC"}
+{"version":3,"file":"runtimeConfig.js","names":[],"sources":["../src/runtimeConfig.ts"],"sourcesContent":["import { fail } from \"src/utils.ts\";\n\nlet runtimeConfig: RuntimeConfig | undefined = undefined;\n\nexport function getRuntimeConfig(): RuntimeConfig {\n  return runtimeConfig ?? fail(\"setRuntimeConfig in metadata.ts has not been invoked yet\");\n}\n\n/** Returns the runtime config if generated metadata has initialized it. */\nexport function maybeGetRuntimeConfig(): RuntimeConfig | undefined {\n  return runtimeConfig;\n}\n\n/**\n * Holds any `joist-config.json` values that we want to access at runtime.\n */\nexport type RuntimeConfig = {\n  /** The process-wide tagged-id separator; explicit `undefined` means no separator, while omission defaults to `:`. */\n  tagDelimiter?: string | undefined;\n  temporal:\n    | false\n    | {\n        /** The application's default time zone, i.e. when we say \"now\", and store it as yyyy-MM-dd, what time zone should we use? */\n        timeZone: string;\n      };\n};\n\n/**\n * Called by the code-generated `metadata.ts` to pass along `joist-config.json` values.\n *\n * This avoids having to load/parse/ship the `joist-config.json` file at runtime.\n */\nexport function setRuntimeConfig(config: RuntimeConfig) {\n  runtimeConfig = config;\n}\n"],"mappings":";;AAEA,IAAI,gBAA2C,KAAA;AAE/C,SAAgB,mBAAkC;CAChD,OAAO,iBAAiB,KAAK,0DAA0D;AACzF;;AAGA,SAAgB,wBAAmD;CACjE,OAAO;AACT;;;;;;AAqBA,SAAgB,iBAAiB,QAAuB;CACtD,gBAAgB;AAClB"}