@dereekb/model 13.12.1 → 13.12.3

package/index.cjs.js

@@ -2934,34 +2934,126 @@ function _ts_generator(thisArg, body) {
 
 /**
  * ArkType schema for a valid ISO 8601 day string (e.g., "2024-01-15").
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, date, iso8601, day, string
+ *
+ * @example
+ * ```ts
+ * type({ startsOn: iso8601DayStringType });
+ * ```
  */ var iso8601DayStringType = arktype.type('string > 0').narrow(function(val, ctx) {
     return val != null && util.isISO8601DayString(val) || ctx.mustBe('a valid ISO 8601 day string');
 });
 
+/**
+ * A number greater than or equal to 0.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, non-negative
+ * @dbxUtilRelated non-negative-integer
+ *
+ * @example
+ * ```ts
+ * type({ price: NON_NEGATIVE_NUMBER });
+ * ```
+ */ var NON_NEGATIVE_NUMBER = 'number >= 0';
+/**
+ * A non-negative integer.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, non-negative, integer
+ * @dbxUtilRelated non-negative-number
+ *
+ * @example
+ * ```ts
+ * type({ count: NON_NEGATIVE_INTEGER });
+ * ```
+ */ var NON_NEGATIVE_INTEGER = 'number.integer >= 0';
 /**
  * ArkType schema for a valid minute of the day (0-1439).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, minute-of-day, time
+ *
+ * @example
+ * ```ts
+ * type({ startMinute: minuteOfDayType });
+ * ```
  */ var minuteOfDayType = arktype.type('number').narrow(function(val, ctx) {
     return val != null && util.isMinuteOfDay(val) || ctx.mustBe('a valid minute of the day (0-1439)');
 });
 
 /**
  * ArkType schema for a valid E.164 phone number without an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, string
+ * @dbxUtilRelated e164-phone-number-with-optional-extension-type, e164-phone-number-with-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberType });
+ * ```
  */ var e164PhoneNumberType = arktype.type('string > 0').narrow(function(val, ctx) {
     return val != null && util.isE164PhoneNumber(val, false) || ctx.mustBe('a valid E.164 phone number without an extension');
 });
 /**
  * ArkType schema for a valid E.164 phone number, optionally with an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, extension, string
+ * @dbxUtilRelated e164-phone-number-type, e164-phone-number-with-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberWithOptionalExtensionType });
+ * ```
  */ var e164PhoneNumberWithOptionalExtensionType = arktype.type('string > 0').narrow(function(val, ctx) {
     return val != null && util.isE164PhoneNumber(val, true) || ctx.mustBe('a valid E.164 phone number');
 });
 /**
  * ArkType schema for a valid E.164 phone number that includes an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, extension, string
+ * @dbxUtilRelated e164-phone-number-type, e164-phone-number-with-optional-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberWithExtensionType });
+ * ```
  */ var e164PhoneNumberWithExtensionType = arktype.type('string > 0').narrow(function(val, ctx) {
     return val != null && util.isE164PhoneNumberWithExtension(val) || ctx.mustBe('a valid E.164 phone number with an extension');
 });
 
 /**
  * ArkType schema for a valid {@link LatLngPoint} with lat in [-90, 90] and lng in [-180, 180].
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, lat-lng, point, geo, coordinates
+ * @dbxUtilRelated lat-lng-string-type
+ *
+ * @example
+ * ```ts
+ * type({ location: latLngPointType });
+ * ```
  */ var latLngPointType = arktype.type({
     lat: '-90 <= number <= 90',
     lng: '-180 <= number <= 180'
@@ -2970,20 +3062,92 @@ function _ts_generator(thisArg, body) {
 });
 /**
  * ArkType schema for a valid {@link LatLngString} (comma-separated lat/lng, e.g. "30.5,-96.3").
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, lat-lng, geo, coordinates, string
+ * @dbxUtilRelated lat-lng-point-type
+ *
+ * @example
+ * ```ts
+ * type({ location: latLngStringType });
+ * ```
  */ var latLngStringType = arktype.type('string > 0').narrow(function(val, ctx) {
     return val != null && util.isLatLngString(val) || ctx.mustBe('a valid lat,lng string (e.g. "30.5,-96.3")');
 });
 
+/**
+ * A string with at least one character (non-empty).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, string, non-empty, required
+ * @dbxUtilRelated email-string, non-empty-string-with-max-length
+ *
+ * @example
+ * ```ts
+ * type({ name: NON_EMPTY_STRING });
+ * ```
+ */ var NON_EMPTY_STRING = 'string > 0';
+/**
+ * A valid email address string.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, string, email
+ *
+ * @example
+ * ```ts
+ * type({ email: EMAIL_STRING });
+ * ```
+ */ var EMAIL_STRING = 'string.email';
+/**
+ * Creates an ArkType string definition for a non-empty string with a maximum length.
+ *
+ * Composes {@link NON_EMPTY_STRING} with an upper-bound length constraint, producing a
+ * DSL fragment that can be interpolated directly into an ArkType `type({ ... })` schema.
+ *
+ * @param maxLength - The maximum number of characters allowed (inclusive).
+ * @returns The ArkType string definition.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind factory
+ * @dbxUtilTags validator, arktype, string, non-empty, max-length, bounded
+ * @dbxUtilRelated non-empty-string
+ *
+ * @example
+ * ```ts
+ * const userType = type({
+ *   displayName: nonEmptyStringWithMaxLength(64)
+ * });
+ * ```
+ *
+ * @__NO_SIDE_EFFECTS__
+ */ function nonEmptyStringWithMaxLength(maxLength) {
+    return "".concat(NON_EMPTY_STRING, " & string <= ").concat(maxLength);
+}
+
 /**
  * Creates an ArkType schema that validates an array has no duplicate keys.
  *
  * @param readKey - Function that extracts the key from each array element.
  * @returns An ArkType schema that narrows `T[]` to ensure uniqueness.
  *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind factory
+ * @dbxUtilTags validator, arktype, array, unique, uniqueness, keyed
+ *
  * @example
  * ```typescript
  * const uniqueItemsType = uniqueKeyedType((item: Item) => item.id);
  * ```
+ *
+ * @__NO_SIDE_EFFECTS__
  */ function uniqueKeyedType(readKey) {
     var isUniqueKeyed = util.isUniqueKeyedFunction(readKey);
     return arktype.type('unknown[]').narrow(function(val, ctx) {
@@ -2993,11 +3157,33 @@ function _ts_generator(thisArg, body) {
 
 /**
  * ArkType schema for a valid website URL (with or without protocol prefix).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, url, website, string
+ * @dbxUtilRelated website-url-with-prefix-type
+ *
+ * @example
+ * ```ts
+ * type({ website: websiteUrlType });
+ * ```
  */ var websiteUrlType = arktype.type('string > 0').narrow(function(val, ctx) {
     return val != null && util.isWebsiteUrl(val) || ctx.mustBe('a valid website URL');
 });
 /**
  * ArkType schema for a valid website URL that starts with `http://` or `https://`.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, url, website, prefix, https, string
+ * @dbxUtilRelated website-url-type
+ *
+ * @example
+ * ```ts
+ * type({ website: websiteUrlWithPrefixType });
+ * ```
  */ var websiteUrlWithPrefixType = arktype.type('string > 0').narrow(function(val, ctx) {
     return val != null && util.isWebsiteUrlWithPrefix(val) || ctx.mustBe('a valid website URL starting with http:// or https://');
 });
@@ -3013,6 +3199,7 @@ exports.AbstractModelPermissionService = AbstractModelPermissionService;
 exports.CASHAPP_BASE_URL = CASHAPP_BASE_URL;
 exports.CASHAPP_USERNAME_PREFIX = CASHAPP_USERNAME_PREFIX;
 exports.CASHAPP_WEBSITE_LINK_TYPE = CASHAPP_WEBSITE_LINK_TYPE;
+exports.EMAIL_STRING = EMAIL_STRING;
 exports.EMAIL_URL_WEBSITE_LINK_TYPE = EMAIL_URL_WEBSITE_LINK_TYPE;
 exports.EMPTY_ARKTYPE_TYPE = EMPTY_ARKTYPE_TYPE;
 exports.FACEBOOK_BASE_URL = FACEBOOK_BASE_URL;
@@ -3027,6 +3214,9 @@ exports.GRANTED_UPDATE_ROLE_KEY = GRANTED_UPDATE_ROLE_KEY;
 exports.GrantedRoleMapReaderInstance = GrantedRoleMapReaderInstance;
 exports.INSTAGRAM_BASE_URL = INSTAGRAM_BASE_URL;
 exports.INSTAGRAM_WEBSITE_LINK_TYPE = INSTAGRAM_WEBSITE_LINK_TYPE;
+exports.NON_EMPTY_STRING = NON_EMPTY_STRING;
+exports.NON_NEGATIVE_INTEGER = NON_NEGATIVE_INTEGER;
+exports.NON_NEGATIVE_NUMBER = NON_NEGATIVE_NUMBER;
 exports.NO_ACCESS_ROLE_KEY = NO_ACCESS_ROLE_KEY;
 exports.PAYPAL_BASE_URL = PAYPAL_BASE_URL;
 exports.PAYPAL_WEBSITE_LINK_TYPE = PAYPAL_WEBSITE_LINK_TYPE;
@@ -3096,6 +3286,7 @@ exports.modelIdType = modelIdType;
 exports.modelKeyType = modelKeyType;
 exports.noAccessContextGrantedModelRoles = noAccessContextGrantedModelRoles;
 exports.noAccessRoleMap = noAccessRoleMap;
+exports.nonEmptyStringWithMaxLength = nonEmptyStringWithMaxLength;
 exports.paypalProfileUrl = paypalProfileUrl;
 exports.paypalProfileUrlToWebsiteLink = paypalProfileUrlToWebsiteLink;
 exports.phoneNumberToWebsiteLink = phoneNumberToWebsiteLink;

package/index.esm.js

@@ -2932,34 +2932,126 @@ function _ts_generator(thisArg, body) {
 
 /**
  * ArkType schema for a valid ISO 8601 day string (e.g., "2024-01-15").
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, date, iso8601, day, string
+ *
+ * @example
+ * ```ts
+ * type({ startsOn: iso8601DayStringType });
+ * ```
  */ var iso8601DayStringType = type('string > 0').narrow(function(val, ctx) {
     return val != null && isISO8601DayString(val) || ctx.mustBe('a valid ISO 8601 day string');
 });
 
+/**
+ * A number greater than or equal to 0.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, non-negative
+ * @dbxUtilRelated non-negative-integer
+ *
+ * @example
+ * ```ts
+ * type({ price: NON_NEGATIVE_NUMBER });
+ * ```
+ */ var NON_NEGATIVE_NUMBER = 'number >= 0';
+/**
+ * A non-negative integer.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, non-negative, integer
+ * @dbxUtilRelated non-negative-number
+ *
+ * @example
+ * ```ts
+ * type({ count: NON_NEGATIVE_INTEGER });
+ * ```
+ */ var NON_NEGATIVE_INTEGER = 'number.integer >= 0';
 /**
  * ArkType schema for a valid minute of the day (0-1439).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, minute-of-day, time
+ *
+ * @example
+ * ```ts
+ * type({ startMinute: minuteOfDayType });
+ * ```
  */ var minuteOfDayType = type('number').narrow(function(val, ctx) {
     return val != null && isMinuteOfDay(val) || ctx.mustBe('a valid minute of the day (0-1439)');
 });
 
 /**
  * ArkType schema for a valid E.164 phone number without an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, string
+ * @dbxUtilRelated e164-phone-number-with-optional-extension-type, e164-phone-number-with-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberType });
+ * ```
  */ var e164PhoneNumberType = type('string > 0').narrow(function(val, ctx) {
     return val != null && isE164PhoneNumber(val, false) || ctx.mustBe('a valid E.164 phone number without an extension');
 });
 /**
  * ArkType schema for a valid E.164 phone number, optionally with an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, extension, string
+ * @dbxUtilRelated e164-phone-number-type, e164-phone-number-with-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberWithOptionalExtensionType });
+ * ```
  */ var e164PhoneNumberWithOptionalExtensionType = type('string > 0').narrow(function(val, ctx) {
     return val != null && isE164PhoneNumber(val, true) || ctx.mustBe('a valid E.164 phone number');
 });
 /**
  * ArkType schema for a valid E.164 phone number that includes an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, extension, string
+ * @dbxUtilRelated e164-phone-number-type, e164-phone-number-with-optional-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberWithExtensionType });
+ * ```
  */ var e164PhoneNumberWithExtensionType = type('string > 0').narrow(function(val, ctx) {
     return val != null && isE164PhoneNumberWithExtension(val) || ctx.mustBe('a valid E.164 phone number with an extension');
 });
 
 /**
  * ArkType schema for a valid {@link LatLngPoint} with lat in [-90, 90] and lng in [-180, 180].
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, lat-lng, point, geo, coordinates
+ * @dbxUtilRelated lat-lng-string-type
+ *
+ * @example
+ * ```ts
+ * type({ location: latLngPointType });
+ * ```
  */ var latLngPointType = type({
     lat: '-90 <= number <= 90',
     lng: '-180 <= number <= 180'
@@ -2968,20 +3060,92 @@ function _ts_generator(thisArg, body) {
 });
 /**
  * ArkType schema for a valid {@link LatLngString} (comma-separated lat/lng, e.g. "30.5,-96.3").
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, lat-lng, geo, coordinates, string
+ * @dbxUtilRelated lat-lng-point-type
+ *
+ * @example
+ * ```ts
+ * type({ location: latLngStringType });
+ * ```
  */ var latLngStringType = type('string > 0').narrow(function(val, ctx) {
     return val != null && isLatLngString(val) || ctx.mustBe('a valid lat,lng string (e.g. "30.5,-96.3")');
 });
 
+/**
+ * A string with at least one character (non-empty).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, string, non-empty, required
+ * @dbxUtilRelated email-string, non-empty-string-with-max-length
+ *
+ * @example
+ * ```ts
+ * type({ name: NON_EMPTY_STRING });
+ * ```
+ */ var NON_EMPTY_STRING = 'string > 0';
+/**
+ * A valid email address string.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, string, email
+ *
+ * @example
+ * ```ts
+ * type({ email: EMAIL_STRING });
+ * ```
+ */ var EMAIL_STRING = 'string.email';
+/**
+ * Creates an ArkType string definition for a non-empty string with a maximum length.
+ *
+ * Composes {@link NON_EMPTY_STRING} with an upper-bound length constraint, producing a
+ * DSL fragment that can be interpolated directly into an ArkType `type({ ... })` schema.
+ *
+ * @param maxLength - The maximum number of characters allowed (inclusive).
+ * @returns The ArkType string definition.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind factory
+ * @dbxUtilTags validator, arktype, string, non-empty, max-length, bounded
+ * @dbxUtilRelated non-empty-string
+ *
+ * @example
+ * ```ts
+ * const userType = type({
+ *   displayName: nonEmptyStringWithMaxLength(64)
+ * });
+ * ```
+ *
+ * @__NO_SIDE_EFFECTS__
+ */ function nonEmptyStringWithMaxLength(maxLength) {
+    return "".concat(NON_EMPTY_STRING, " & string <= ").concat(maxLength);
+}
+
 /**
  * Creates an ArkType schema that validates an array has no duplicate keys.
  *
  * @param readKey - Function that extracts the key from each array element.
  * @returns An ArkType schema that narrows `T[]` to ensure uniqueness.
  *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind factory
+ * @dbxUtilTags validator, arktype, array, unique, uniqueness, keyed
+ *
  * @example
  * ```typescript
  * const uniqueItemsType = uniqueKeyedType((item: Item) => item.id);
  * ```
+ *
+ * @__NO_SIDE_EFFECTS__
  */ function uniqueKeyedType(readKey) {
     var isUniqueKeyed = isUniqueKeyedFunction(readKey);
     return type('unknown[]').narrow(function(val, ctx) {
@@ -2991,13 +3155,35 @@ function _ts_generator(thisArg, body) {
 
 /**
  * ArkType schema for a valid website URL (with or without protocol prefix).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, url, website, string
+ * @dbxUtilRelated website-url-with-prefix-type
+ *
+ * @example
+ * ```ts
+ * type({ website: websiteUrlType });
+ * ```
  */ var websiteUrlType = type('string > 0').narrow(function(val, ctx) {
     return val != null && isWebsiteUrl(val) || ctx.mustBe('a valid website URL');
 });
 /**
  * ArkType schema for a valid website URL that starts with `http://` or `https://`.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, url, website, prefix, https, string
+ * @dbxUtilRelated website-url-type
+ *
+ * @example
+ * ```ts
+ * type({ website: websiteUrlWithPrefixType });
+ * ```
  */ var websiteUrlWithPrefixType = type('string > 0').narrow(function(val, ctx) {
     return val != null && isWebsiteUrlWithPrefix(val) || ctx.mustBe('a valid website URL starting with http:// or https://');
 });
 
-export { ADDRESS_CITY_MAX_LENGTH, ADDRESS_COUNTRY_MAX_LENGTH, ADDRESS_LINE_MAX_LENGTH, ADDRESS_STATE_CODE_MAX_LENGTH, ADDRESS_STATE_MAX_LENGTH, ADDRESS_ZIP_MAX_LENGTH, ARKTYPE_DATE_DTO_TYPE, AbstractModelPermissionService, CASHAPP_BASE_URL, CASHAPP_USERNAME_PREFIX, CASHAPP_WEBSITE_LINK_TYPE, EMAIL_URL_WEBSITE_LINK_TYPE, EMPTY_ARKTYPE_TYPE, FACEBOOK_BASE_URL, FACEBOOK_WEBSITE_LINK_TYPE, FULL_ACCESS_ROLE_KEY, GRANTED_ADMIN_ROLE_KEY, GRANTED_DELETE_ROLE_KEY, GRANTED_OWNER_ROLE_KEY, GRANTED_READ_ROLE_KEY, GRANTED_SYS_ADMIN_ROLE_KEY, GRANTED_UPDATE_ROLE_KEY, GrantedRoleMapReaderInstance, INSTAGRAM_BASE_URL, INSTAGRAM_WEBSITE_LINK_TYPE, NO_ACCESS_ROLE_KEY, PAYPAL_BASE_URL, PAYPAL_WEBSITE_LINK_TYPE, PHONE_URL_WEBSITE_LINK_TYPE, SNAPCHAT_BASE_URL, SNAPCHAT_WEBSITE_LINK_ISOLATE_PROFILE_ID, SNAPCHAT_WEBSITE_LINK_TYPE, SPOTIFY_BASE_URL, SPOTIFY_WEBSITE_LINK_ISOLATE_PROFILE_ID, SPOTIFY_WEBSITE_LINK_TYPE, TIKTOK_BASE_URL, TIKTOK_USERNAME_PREFIX, TIKTOK_WEBSITE_LINK_TYPE, TWITTER_BASE_URL, TWITTER_WEBSITE_LINK_TYPE, UNKNOWN_WEBSITE_LINK_TYPE, VENMO_BASE_URL, VENMO_WEBSITE_LINK_ISOLATE_PROFILE_ID, VENMO_WEBSITE_LINK_TYPE, WEBSITE_FILE_LINK_DATA_MAX_LENGTH, WEBSITE_FILE_LINK_DATA_REGEX, WEBSITE_FILE_LINK_ENCODE_SEPARATOR, WEBSITE_FILE_LINK_MIME_TYPE_MAX_LENGTH, WEBSITE_FILE_LINK_MIME_TYPE_REGEX, WEBSITE_FILE_LINK_NAME_MAX_LENGTH, WEBSITE_FILE_LINK_TYPE_MAX_LENGTH, WEBSITE_FILE_LINK_TYPE_REGEX, WEBSITE_FILE_LINK_WEBSITE_LINK_TYPE, WEBSITE_LINK_ENCODED_DATA_MAX_LENGTH, WEBSITE_LINK_ISOLATE_BASE_URL_PROFILE_ID, WEBSITE_LINK_TYPE_MAX_LENGTH, WEBSITE_LINK_TYPE_REGEX, WEBSITE_URL_WEBSITE_LINK_TYPE, YOUTUBE_BASE_URL, YOUTUBE_WEBSITE_LINK_ISOLATE_PROFILE_ID, YOUTUBE_WEBSITE_LINK_TYPE, arktypeToJsonSchemaForExport, basicSyncEntityCommonTypeSynchronizerInstanceFactory, cashappProfileUrl, cashappProfileUrlToWebsiteLink, clearable, contextGrantedModelRoles, decodeWebsiteLinkEncodedDataToWebsiteFileLink, e164PhoneNumberType, e164PhoneNumberWithExtensionType, e164PhoneNumberWithOptionalExtensionType, emailAddressToWebsiteLink, emptyType, encodeWebsiteFileLinkToWebsiteLinkEncodedData, facebookProfileUrl, facebookProfileUrlToWebsiteLink, fullAccessGrantedModelRoles, fullAccessRoleMap, grantedRoleKeysMapFromArray, grantedRoleMapReader, instagramProfileUrl, instagramProfileUrlToWebsiteLink, isFullAccessRoleMap, isGrantedAdminLevelRole, isNoAccessRoleMap, isValidWebsiteLinkType, iso8601DayStringType, latLngPointType, latLngStringType, minuteOfDayType, modelIdType, modelKeyType, noAccessContextGrantedModelRoles, noAccessRoleMap, paypalProfileUrl, paypalProfileUrlToWebsiteLink, phoneNumberToWebsiteLink, pruneFalseUnionBranches, snapchatProfileUrl, snapchatProfileUrlToWebsiteLink, spotifyProfileUrl, spotifyProfileUrlToWebsiteLink, syncEntityCommonTypeIdPairFactory, syncEntityFactory, syncEntitySynchronizer, targetModelIdParamsType, targetModelParamsType, tiktokProfileUrl, tiktokProfileUrlToWebsiteLink, toTransformAndValidateFunctionResult, toTransformAndValidateFunctionResultFactory, transformAndValidateFunctionResultFactory, transformAndValidateObject, transformAndValidateObjectFactory, transformAndValidateObjectResult, transformAndValidateResultFactory, twitterProfileUrl, twitterProfileUrlToWebsiteLink, uniqueKeyedType, unitedStatesAddressWithStateCodeType, unitedStatesAddressWithStateStringType, usernameFromUsernameOrWebsiteWithBaseUrlUsername, usernameFromUsernameOrWebsiteWithOneOffBaseUrlUsername, usernameOrWebsiteUrlToWebsiteUrl, venmoProfileUrl, venmoProfileUrlToWebsiteLink, websiteFileLinkToWebsiteLink, websiteFileLinkType, websiteLinkToWebsiteLinkFile, websiteLinkType, websiteUrlToWebsiteLink, websiteUrlType, websiteUrlWithPrefixType, youtubeProfileUrl, youtubeProfileUrlToWebsiteLink };
+export { ADDRESS_CITY_MAX_LENGTH, ADDRESS_COUNTRY_MAX_LENGTH, ADDRESS_LINE_MAX_LENGTH, ADDRESS_STATE_CODE_MAX_LENGTH, ADDRESS_STATE_MAX_LENGTH, ADDRESS_ZIP_MAX_LENGTH, ARKTYPE_DATE_DTO_TYPE, AbstractModelPermissionService, CASHAPP_BASE_URL, CASHAPP_USERNAME_PREFIX, CASHAPP_WEBSITE_LINK_TYPE, EMAIL_STRING, EMAIL_URL_WEBSITE_LINK_TYPE, EMPTY_ARKTYPE_TYPE, FACEBOOK_BASE_URL, FACEBOOK_WEBSITE_LINK_TYPE, FULL_ACCESS_ROLE_KEY, GRANTED_ADMIN_ROLE_KEY, GRANTED_DELETE_ROLE_KEY, GRANTED_OWNER_ROLE_KEY, GRANTED_READ_ROLE_KEY, GRANTED_SYS_ADMIN_ROLE_KEY, GRANTED_UPDATE_ROLE_KEY, GrantedRoleMapReaderInstance, INSTAGRAM_BASE_URL, INSTAGRAM_WEBSITE_LINK_TYPE, NON_EMPTY_STRING, NON_NEGATIVE_INTEGER, NON_NEGATIVE_NUMBER, NO_ACCESS_ROLE_KEY, PAYPAL_BASE_URL, PAYPAL_WEBSITE_LINK_TYPE, PHONE_URL_WEBSITE_LINK_TYPE, SNAPCHAT_BASE_URL, SNAPCHAT_WEBSITE_LINK_ISOLATE_PROFILE_ID, SNAPCHAT_WEBSITE_LINK_TYPE, SPOTIFY_BASE_URL, SPOTIFY_WEBSITE_LINK_ISOLATE_PROFILE_ID, SPOTIFY_WEBSITE_LINK_TYPE, TIKTOK_BASE_URL, TIKTOK_USERNAME_PREFIX, TIKTOK_WEBSITE_LINK_TYPE, TWITTER_BASE_URL, TWITTER_WEBSITE_LINK_TYPE, UNKNOWN_WEBSITE_LINK_TYPE, VENMO_BASE_URL, VENMO_WEBSITE_LINK_ISOLATE_PROFILE_ID, VENMO_WEBSITE_LINK_TYPE, WEBSITE_FILE_LINK_DATA_MAX_LENGTH, WEBSITE_FILE_LINK_DATA_REGEX, WEBSITE_FILE_LINK_ENCODE_SEPARATOR, WEBSITE_FILE_LINK_MIME_TYPE_MAX_LENGTH, WEBSITE_FILE_LINK_MIME_TYPE_REGEX, WEBSITE_FILE_LINK_NAME_MAX_LENGTH, WEBSITE_FILE_LINK_TYPE_MAX_LENGTH, WEBSITE_FILE_LINK_TYPE_REGEX, WEBSITE_FILE_LINK_WEBSITE_LINK_TYPE, WEBSITE_LINK_ENCODED_DATA_MAX_LENGTH, WEBSITE_LINK_ISOLATE_BASE_URL_PROFILE_ID, WEBSITE_LINK_TYPE_MAX_LENGTH, WEBSITE_LINK_TYPE_REGEX, WEBSITE_URL_WEBSITE_LINK_TYPE, YOUTUBE_BASE_URL, YOUTUBE_WEBSITE_LINK_ISOLATE_PROFILE_ID, YOUTUBE_WEBSITE_LINK_TYPE, arktypeToJsonSchemaForExport, basicSyncEntityCommonTypeSynchronizerInstanceFactory, cashappProfileUrl, cashappProfileUrlToWebsiteLink, clearable, contextGrantedModelRoles, decodeWebsiteLinkEncodedDataToWebsiteFileLink, e164PhoneNumberType, e164PhoneNumberWithExtensionType, e164PhoneNumberWithOptionalExtensionType, emailAddressToWebsiteLink, emptyType, encodeWebsiteFileLinkToWebsiteLinkEncodedData, facebookProfileUrl, facebookProfileUrlToWebsiteLink, fullAccessGrantedModelRoles, fullAccessRoleMap, grantedRoleKeysMapFromArray, grantedRoleMapReader, instagramProfileUrl, instagramProfileUrlToWebsiteLink, isFullAccessRoleMap, isGrantedAdminLevelRole, isNoAccessRoleMap, isValidWebsiteLinkType, iso8601DayStringType, latLngPointType, latLngStringType, minuteOfDayType, modelIdType, modelKeyType, noAccessContextGrantedModelRoles, noAccessRoleMap, nonEmptyStringWithMaxLength, paypalProfileUrl, paypalProfileUrlToWebsiteLink, phoneNumberToWebsiteLink, pruneFalseUnionBranches, snapchatProfileUrl, snapchatProfileUrlToWebsiteLink, spotifyProfileUrl, spotifyProfileUrlToWebsiteLink, syncEntityCommonTypeIdPairFactory, syncEntityFactory, syncEntitySynchronizer, targetModelIdParamsType, targetModelParamsType, tiktokProfileUrl, tiktokProfileUrlToWebsiteLink, toTransformAndValidateFunctionResult, toTransformAndValidateFunctionResultFactory, transformAndValidateFunctionResultFactory, transformAndValidateObject, transformAndValidateObjectFactory, transformAndValidateObjectResult, transformAndValidateResultFactory, twitterProfileUrl, twitterProfileUrlToWebsiteLink, uniqueKeyedType, unitedStatesAddressWithStateCodeType, unitedStatesAddressWithStateStringType, usernameFromUsernameOrWebsiteWithBaseUrlUsername, usernameFromUsernameOrWebsiteWithOneOffBaseUrlUsername, usernameOrWebsiteUrlToWebsiteUrl, venmoProfileUrl, venmoProfileUrlToWebsiteLink, websiteFileLinkToWebsiteLink, websiteFileLinkType, websiteLinkToWebsiteLinkFile, websiteLinkType, websiteUrlToWebsiteLink, websiteUrlType, websiteUrlWithPrefixType, youtubeProfileUrl, youtubeProfileUrlToWebsiteLink };

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@dereekb/model",
-  "version": "13.12.1",
+  "version": "13.12.3",
   "sideEffects": false,
   "peerDependencies": {
-    "@dereekb/util": "13.12.1",
+    "@dereekb/util": "13.12.3",
     "arktype": "^2.2.0",
     "make-error": "^1.3.6"
   },

package/src/lib/validator/date.d.ts

@@ -1,4 +1,14 @@
 /**
  * ArkType schema for a valid ISO 8601 day string (e.g., "2024-01-15").
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, date, iso8601, day, string
+ *
+ * @example
+ * ```ts
+ * type({ startsOn: iso8601DayStringType });
+ * ```
  */
 export declare const iso8601DayStringType: import("arktype/internal/variants/string.ts").StringType<string, {}>;

package/src/lib/validator/index.d.ts

@@ -2,5 +2,6 @@ export * from './date';
 export * from './number';
 export * from './phone';
 export * from './point';
+export * from './string';
 export * from './unique';
 export * from './url';

package/src/lib/validator/number.d.ts

@@ -1,4 +1,44 @@
+/**
+ * A number greater than or equal to 0.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, non-negative
+ * @dbxUtilRelated non-negative-integer
+ *
+ * @example
+ * ```ts
+ * type({ price: NON_NEGATIVE_NUMBER });
+ * ```
+ */
+export declare const NON_NEGATIVE_NUMBER: "number >= 0";
+/**
+ * A non-negative integer.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, non-negative, integer
+ * @dbxUtilRelated non-negative-number
+ *
+ * @example
+ * ```ts
+ * type({ count: NON_NEGATIVE_INTEGER });
+ * ```
+ */
+export declare const NON_NEGATIVE_INTEGER: "number.integer >= 0";
 /**
  * ArkType schema for a valid minute of the day (0-1439).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, number, minute-of-day, time
+ *
+ * @example
+ * ```ts
+ * type({ startMinute: minuteOfDayType });
+ * ```
  */
 export declare const minuteOfDayType: import("arktype/internal/variants/number.ts").NumberType<number, {}>;

package/src/lib/validator/phone.d.ts

@@ -1,12 +1,45 @@
 /**
  * ArkType schema for a valid E.164 phone number without an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, string
+ * @dbxUtilRelated e164-phone-number-with-optional-extension-type, e164-phone-number-with-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberType });
+ * ```
  */
 export declare const e164PhoneNumberType: import("arktype/internal/variants/string.ts").StringType<string, {}>;
 /**
  * ArkType schema for a valid E.164 phone number, optionally with an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, extension, string
+ * @dbxUtilRelated e164-phone-number-type, e164-phone-number-with-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberWithOptionalExtensionType });
+ * ```
  */
 export declare const e164PhoneNumberWithOptionalExtensionType: import("arktype/internal/variants/string.ts").StringType<string, {}>;
 /**
  * ArkType schema for a valid E.164 phone number that includes an extension.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, phone, e164, extension, string
+ * @dbxUtilRelated e164-phone-number-type, e164-phone-number-with-optional-extension-type
+ *
+ * @example
+ * ```ts
+ * type({ phone: e164PhoneNumberWithExtensionType });
+ * ```
  */
 export declare const e164PhoneNumberWithExtensionType: import("arktype/internal/variants/string.ts").StringType<string, {}>;

package/src/lib/validator/point.d.ts

@@ -1,5 +1,16 @@
 /**
  * ArkType schema for a valid {@link LatLngPoint} with lat in [-90, 90] and lng in [-180, 180].
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, lat-lng, point, geo, coordinates
+ * @dbxUtilRelated lat-lng-string-type
+ *
+ * @example
+ * ```ts
+ * type({ location: latLngPointType });
+ * ```
  */
 export declare const latLngPointType: import("arktype/internal/variants/object.ts").ObjectType<{
     lat: number;
@@ -7,5 +18,16 @@ export declare const latLngPointType: import("arktype/internal/variants/object.t
 }, {}>;
 /**
  * ArkType schema for a valid {@link LatLngString} (comma-separated lat/lng, e.g. "30.5,-96.3").
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, lat-lng, geo, coordinates, string
+ * @dbxUtilRelated lat-lng-point-type
+ *
+ * @example
+ * ```ts
+ * type({ location: latLngStringType });
+ * ```
  */
 export declare const latLngStringType: import("arktype/internal/variants/string.ts").StringType<string, {}>;

package/src/lib/validator/string.d.ts

@@ -0,0 +1,54 @@
+/**
+ * A string with at least one character (non-empty).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, string, non-empty, required
+ * @dbxUtilRelated email-string, non-empty-string-with-max-length
+ *
+ * @example
+ * ```ts
+ * type({ name: NON_EMPTY_STRING });
+ * ```
+ */
+export declare const NON_EMPTY_STRING: "string > 0";
+/**
+ * A valid email address string.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, string, email
+ *
+ * @example
+ * ```ts
+ * type({ email: EMAIL_STRING });
+ * ```
+ */
+export declare const EMAIL_STRING: "string.email";
+/**
+ * Creates an ArkType string definition for a non-empty string with a maximum length.
+ *
+ * Composes {@link NON_EMPTY_STRING} with an upper-bound length constraint, producing a
+ * DSL fragment that can be interpolated directly into an ArkType `type({ ... })` schema.
+ *
+ * @param maxLength - The maximum number of characters allowed (inclusive).
+ * @returns The ArkType string definition.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind factory
+ * @dbxUtilTags validator, arktype, string, non-empty, max-length, bounded
+ * @dbxUtilRelated non-empty-string
+ *
+ * @example
+ * ```ts
+ * const userType = type({
+ *   displayName: nonEmptyStringWithMaxLength(64)
+ * });
+ * ```
+ *
+ * @__NO_SIDE_EFFECTS__
+ */
+export declare function nonEmptyStringWithMaxLength<N extends number>(maxLength: N): `string > 0 & string <= ${N}`;

package/src/lib/validator/unique.d.ts

@@ -5,9 +5,16 @@ import { type ReadKeyFunction } from '@dereekb/util';
  * @param readKey - Function that extracts the key from each array element.
  * @returns An ArkType schema that narrows `T[]` to ensure uniqueness.
  *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind factory
+ * @dbxUtilTags validator, arktype, array, unique, uniqueness, keyed
+ *
  * @example
  * ```typescript
  * const uniqueItemsType = uniqueKeyedType((item: Item) => item.id);
  * ```
+ *
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function uniqueKeyedType<T>(readKey: ReadKeyFunction<T>): import("arktype/internal/variants/array.ts").ArrayType<unknown[], {}>;

package/src/lib/validator/url.d.ts

@@ -1,8 +1,30 @@
 /**
  * ArkType schema for a valid website URL (with or without protocol prefix).
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, url, website, string
+ * @dbxUtilRelated website-url-with-prefix-type
+ *
+ * @example
+ * ```ts
+ * type({ website: websiteUrlType });
+ * ```
  */
 export declare const websiteUrlType: import("arktype/internal/variants/string.ts").StringType<string, {}>;
 /**
  * ArkType schema for a valid website URL that starts with `http://` or `https://`.
+ *
+ * @dbxUtil
+ * @dbxUtilCategory validator
+ * @dbxUtilKind const
+ * @dbxUtilTags validator, arktype, url, website, prefix, https, string
+ * @dbxUtilRelated website-url-type
+ *
+ * @example
+ * ```ts
+ * type({ website: websiteUrlWithPrefixType });
+ * ```
  */
 export declare const websiteUrlWithPrefixType: import("arktype/internal/variants/string.ts").StringType<string, {}>;