template-saas/apps/backend/node_modules/@hapi/address/esm/domain.js
rckrdmrd 26f0e52ca7 feat: Initial commit - template-saas
Template base para proyectos SaaS multi-tenant.

Estructura inicial:
- apps/backend (NestJS API)
- apps/frontend (React/Vite)
- apps/database (PostgreSQL DDL)
- docs/ (Documentación)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 04:41:24 -06:00

141 lines
4.6 KiB
JavaScript

import * as Url from 'url';
import { errorCode } from './errors';
const MIN_DOMAIN_SEGMENTS = 2;
const NON_ASCII_RX = /[^\x00-\x7f]/;
const DOMAIN_CONTROL_RX = /[\x00-\x20@\:\/\\#!\$&\'\(\)\*\+,;=\?]/; // Control + space + separators
const TLD_SEGMENT_RX = /^[a-zA-Z](?:[a-zA-Z0-9\-]*[a-zA-Z0-9])?$/;
const DOMAIN_SEGMENT_RX = /^[a-zA-Z0-9](?:[a-zA-Z0-9\-]*[a-zA-Z0-9])?$/;
const DOMAIN_UNDERSCORE_SEGMENT_RX = /^[a-zA-Z0-9_](?:[a-zA-Z0-9\-]*[a-zA-Z0-9])?$/;
const URL_IMPL = Url.URL || URL; // $lab:coverage:ignore$
function isTldsAllow(tlds) {
return !!tlds.allow;
}
/**
* Analyzes a string to verify it is a valid domain name.
*
* @param domain - the domain name to validate.
* @param options - optional settings.
*
* @return - undefined when valid, otherwise an object with single error key with a string message value.
*/
export function analyzeDomain(domain, options = {}) {
if (!domain) {
// Catch null / undefined
return errorCode('DOMAIN_NON_EMPTY_STRING');
}
if (typeof domain !== 'string') {
throw new Error('Invalid input: domain must be a string');
}
if (domain.length > 256) {
return errorCode('DOMAIN_TOO_LONG');
}
const ascii = !NON_ASCII_RX.test(domain);
if (!ascii) {
if (options.allowUnicode === false) {
// Defaults to true
return errorCode('DOMAIN_INVALID_UNICODE_CHARS');
}
domain = domain.normalize('NFC');
}
if (DOMAIN_CONTROL_RX.test(domain)) {
return errorCode('DOMAIN_INVALID_CHARS');
}
domain = punycode(domain);
// https://tools.ietf.org/html/rfc1035 section 2.3.1
if (options.allowFullyQualified && domain[domain.length - 1] === '.') {
domain = domain.slice(0, -1);
}
const minDomainSegments = options.minDomainSegments || MIN_DOMAIN_SEGMENTS;
const segments = domain.split('.');
if (segments.length < minDomainSegments) {
return errorCode('DOMAIN_SEGMENTS_COUNT');
}
if (options.maxDomainSegments) {
if (segments.length > options.maxDomainSegments) {
return errorCode('DOMAIN_SEGMENTS_COUNT_MAX');
}
}
const tlds = options.tlds;
if (tlds) {
const tld = segments[segments.length - 1].toLowerCase();
if (isTldsAllow(tlds)) {
if (!tlds.allow.has(tld)) {
return errorCode('DOMAIN_FORBIDDEN_TLDS');
}
}
else if (tlds.deny.has(tld)) {
return errorCode('DOMAIN_FORBIDDEN_TLDS');
}
}
for (let i = 0; i < segments.length; ++i) {
const segment = segments[i];
if (!segment.length) {
return errorCode('DOMAIN_EMPTY_SEGMENT');
}
if (segment.length > 63) {
return errorCode('DOMAIN_LONG_SEGMENT');
}
if (i < segments.length - 1) {
if (options.allowUnderscore) {
if (!DOMAIN_UNDERSCORE_SEGMENT_RX.test(segment)) {
return errorCode('DOMAIN_INVALID_CHARS');
}
}
else {
if (!DOMAIN_SEGMENT_RX.test(segment)) {
return errorCode('DOMAIN_INVALID_CHARS');
}
}
}
else {
if (!TLD_SEGMENT_RX.test(segment)) {
return errorCode('DOMAIN_INVALID_TLDS_CHARS');
}
}
}
return null;
}
/**
* Analyzes a string to verify it is a valid domain name.
*
* @param domain - the domain name to validate.
* @param options - optional settings.
*
* @return - true when valid, otherwise false.
*/
export function isDomainValid(domain, options) {
return !analyzeDomain(domain, options);
}
function punycode(domain) {
if (domain.includes('%')) {
domain = domain.replace(/%/g, '%25');
}
try {
return new URL_IMPL(`http://${domain}`).host;
}
catch (err) {
return domain;
}
}
export function validateDomainOptions(options) {
if (!options) {
return;
}
if (typeof options.tlds !== 'object') {
throw new Error('Invalid options: tlds must be a boolean or an object');
}
if (isTldsAllow(options.tlds)) {
if (options.tlds.allow instanceof Set === false) {
throw new Error('Invalid options: tlds.allow must be a Set object or true');
}
if (options.tlds.deny) {
throw new Error('Invalid options: cannot specify both tlds.allow and tlds.deny lists');
}
}
else {
if (options.tlds.deny instanceof Set === false) {
throw new Error('Invalid options: tlds.deny must be a Set object');
}
}
}
//# sourceMappingURL=domain.js.map