tiny-essentials 1.28.18 → 1.29.0

package/dist/v1/regexp/Username/templates/BlueSky.d.mts

@@ -0,0 +1,35 @@
+/**
+ * @typedef {import('../jsDoc.mjs').UsernameRegexTemplate} UsernameRegexTemplate
+ */
+export type UsernameRegexTemplate = import('../jsDoc.mjs').UsernameRegexTemplate;
+/**
+ * Bluesky / AT Protocol
+ */
+declare const BlueSkyRegex: Readonly<{
+    /**
+     * User Identifier (Handle)
+     * Format: @user.bsky.social (or custom domains)
+     * @type {UsernameRegexTemplate}
+     */
+    handle: UsernameRegexTemplate;
+    /**
+     * Decentralized Identifier (DID) - The actual identity in the database
+     * Format: did:plc:1234567890abcdefghi or did:web:domain.com
+     * @type {UsernameRegexTemplate}
+     */
+    did: UsernameRegexTemplate;
+    /**
+     * AT URI (Points to specific records such as posts, profiles, feeds)
+     * Format: at://did:plc:1234567890abcdefghi/app.bsky.feed.post/3jklmn56pqr2
+     * @type {UsernameRegexTemplate}
+     */
+    atUri: UsernameRegexTemplate;
+    /**
+     * Standard Hashtags
+     * Format: #hashtag
+     * @type {UsernameRegexTemplate}
+     */
+    hashtag: UsernameRegexTemplate;
+}>;
+export default BlueSkyRegex;
+//# sourceMappingURL=BlueSky.d.mts.map

package/dist/v1/regexp/Username/templates/BlueSky.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlueSky.d.mts","sourceRoot":"","sources":["../../../../../src/v1/regexp/Username/templates/BlueSky.mjs"],"names":[],"mappings":"AAAA;;GAEG;AADA,YAAwD,qBAAqB,GAAnE,OAAO,cAAc,EAAE,qBAAqB,CAAuB;AAGhF;;GAEG;AACH,QAAA,MAAM,YAAY;IAChB;;;;OAIG;YADO,qBAAqB;IAQ/B;;;;OAIG;SADO,qBAAqB;IAQ/B;;;;OAIG;WADO,qBAAqB;IAQ/B;;;;OAIG;aADO,qBAAqB;EAO/B,CAAC;eAEY,YAAY"}

package/dist/v1/regexp/Username/templates/BlueSky.mjs

@@ -0,0 +1,52 @@
+/**
+ * @typedef {import('../jsDoc.mjs').UsernameRegexTemplate} UsernameRegexTemplate
+ */
+/**
+ * Bluesky / AT Protocol
+ */
+const BlueSkyRegex = Object.freeze({
+    /**
+     * User Identifier (Handle)
+     * Format: @user.bsky.social (or custom domains)
+     * @type {UsernameRegexTemplate}
+     */
+    handle: {
+        prefix: '@',
+        validValues: '[a-zA-Z0-9-]',
+        length: [1, 63],
+        domainPattern: '(?:\\.[a-zA-Z0-9-]+)+',
+    },
+    /**
+     * Decentralized Identifier (DID) - The actual identity in the database
+     * Format: did:plc:1234567890abcdefghi or did:web:domain.com
+     * @type {UsernameRegexTemplate}
+     */
+    did: {
+        prefix: 'did:',
+        validValues: '[a-z]', // Captures the method (e.g., "plc" or "web")
+        length: [3, 4],
+        domainPattern: ':[a-zA-Z0-9.-]+', // Captures the rest of the unique identifier
+    },
+    /**
+     * AT URI (Points to specific records such as posts, profiles, feeds)
+     * Format: at://did:plc:1234567890abcdefghi/app.bsky.feed.post/3jklmn56pqr2
+     * @type {UsernameRegexTemplate}
+     */
+    atUri: {
+        prefix: 'at://',
+        validValues: '[a-zA-Z0-9.:-]', // Captures the authority (can be the DID or a Handle)
+        length: [1, 253],
+        domainPattern: '\\/[a-zA-Z0-9.-]+\\/[a-zA-Z0-9.-]+', // Captures the collection and the record ID (rkey)
+    },
+    /**
+     * Standard Hashtags
+     * Format: #hashtag
+     * @type {UsernameRegexTemplate}
+     */
+    hashtag: {
+        prefix: '#',
+        validValues: '[a-zA-Z0-9_]',
+        length: [1, 64],
+    },
+});
+export default BlueSkyRegex;

package/dist/v1/regexp/Username/templates/Discord.cjs

@@ -0,0 +1,505 @@
+'use strict';
+
+/**
+ * @typedef {import('../jsDoc.mjs').UsernameRegexTemplate} UsernameRegexTemplate
+ */
+
+/**
+ * A Discord snowflake identifier (17 to 22 digits).
+ * @type {string}
+ */
+const SNOWFLAKE = '[0-9]{17,22}';
+
+/**
+ * An optional URL query string, including the leading "?".
+ * Keeps tracking parameters (e.g. "?utm_source=discord") inside the match.
+ * @type {string}
+ */
+const OPTIONAL_QUERY_STRING = '(?:\\?[^\\s#]*)?';
+
+/**
+ * A Discord CDN host, matching both the primary and the media subdomain.
+ * @type {string}
+ */
+const CDN_HOST = 'https?://(?:cdn\\.discordapp\\.com|media\\.discordapp\\.net)';
+
+/**
+ * A Discord CDN image extension.
+ * @type {string}
+ */
+const CDN_EXT = '\\.(?:jpg|jpeg|png|webp|gif|avif)';
+
+/**
+ * A Discord CDN asset hash (hex or base64url, optionally animated).
+ * @type {string}
+ */
+const CDN_HASH = '[A-Za-z0-9_-]+';
+
+/**
+ * The Discord spoiler delimiter.
+ * @type {string}
+ */
+const SPOILER = '||';
+
+/**
+ * Matches any character that may appear inside a spoiler, including single
+ * pipes. Two consecutive pipes terminate the spoiler and are therefore excluded.
+ * @type {string}
+ */
+const SPOILER_CONTENT = '[^|]|\\|(?!\\|)';
+
+/**
+ * The prefix Discord prepends to attachments marked as spoilers.
+ * @type {string}
+ */
+const MEDIA_SPOILER_PREFIX = 'SPOILER_';
+
+/**
+ * A Discord attachment filename, including its extension.
+ * @type {string}
+ */
+const CDN_FILENAME = '[^\\s/?#]+';
+
+/**
+ * Discord Protocol
+ */
+const DiscordRegex = Object.freeze({
+  /**
+   * Spoiler Code
+   * Format: ||hidden text||
+   * @type {UsernameRegexTemplate}
+   */
+  spoiler: {
+    prefix: SPOILER,
+    validValues: SPOILER_CONTENT,
+    length: [1, 2000],
+    domain: SPOILER,
+  },
+
+  /**
+   * Media Spoiler Filename
+   * Format: SPOILER_filename.ext
+   * @type {UsernameRegexTemplate}
+   */
+  mediaSpoiler: {
+    prefix: MEDIA_SPOILER_PREFIX,
+    validValues: '[^\\s]',
+    length: [1, 256],
+    domainPattern: '\\.[a-zA-Z0-9]+',
+  },
+
+  /**
+   * Standard User Mention Code
+   * Format: <@USER_ID>
+   * @type {UsernameRegexTemplate}
+   */
+  userMention: {
+    prefix: '<@',
+    validValues: '[0-9]',
+    length: [17, 22],
+    domain: '>',
+  },
+
+  /**
+   * User Mention Code (Nickname/Server Nickname)
+   * Format: <@!USER_ID>
+   * @type {UsernameRegexTemplate}
+   */
+  nicknameMention: {
+    prefix: '<@!',
+    validValues: '[0-9]',
+    length: [17, 22],
+    domain: '>',
+  },
+
+  /**
+   * Role Mention Code
+   * Format: <@&ROLE_ID>
+   * @type {UsernameRegexTemplate}
+   */
+  roleMention: {
+    prefix: '<@&',
+    validValues: '[0-9]',
+    length: [17, 22],
+    domain: '>',
+  },
+
+  /**
+   * Channel Mention Code (Covers all types: Text, Voice, Forum, Stage, etc.)
+   * Format: <#CHANNEL_ID>
+   * @type {UsernameRegexTemplate}
+   */
+  channelMention: {
+    prefix: '<#',
+    validValues: '[0-9]',
+    length: [17, 22],
+    domain: '>',
+  },
+
+  /**
+   * Standard Custom Emoji Code
+   * Format: <:name:ID>
+   * @type {UsernameRegexTemplate}
+   */
+  customEmoji: {
+    prefix: '<:',
+    validValues: '[a-zA-Z0-9_]',
+    length: [2, 32],
+    domainPattern: ':[0-9]{17,22}>',
+  },
+
+  /**
+   * Animated Custom Emoji Code
+   * Format: <a:name:ID>
+   * @type {UsernameRegexTemplate}
+   */
+  animatedEmoji: {
+    prefix: '<a:',
+    validValues: '[a-zA-Z0-9_]',
+    length: [2, 32],
+    domainPattern: ':[0-9]{17,22}>',
+  },
+
+  /**
+   * Timestamp Code
+   * Format: <t:TIMESTAMP:STYLE> or <t:TIMESTAMP>
+   * Styles: t, T, d, D, f, F, R, s, S
+   * @type {UsernameRegexTemplate}
+   */
+  timestamp: {
+    prefix: '<t:',
+    validValues: '[0-9]',
+    length: [1, 15],
+    domainPattern: '(?::[tTdDfFRsS])?>',
+  },
+
+  /**
+   * Slash Command Mention Code
+   * Format: </name:ID> or </name subcommand:ID>
+   * @type {UsernameRegexTemplate}
+   */
+  slashCommand: {
+    prefix: '</',
+    validValues: '[a-zA-Z0-9_ -]',
+    length: [1, 100],
+    domainPattern: ':[0-9]{17,22}>',
+  },
+
+  /**
+   * Message Link
+   * Format: https://discord.com/channels/GUILD_ID/CHANNEL_ID/MESSAGE_ID
+   * The guild segment accepts a snowflake or the literal "@me" for direct messages.
+   * @type {UsernameRegexTemplate}
+   */
+  messageLink: {
+    start: `https?://(?:www\\.)?discord(?:app)?\\.com/channels/(?:@me|${SNOWFLAKE})/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/${SNOWFLAKE}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * Server Invite Link
+   * Format: discord.gg/code or https://discord.gg/code
+   * Supports both discord.gg and discord.com/invite/ formats.
+   * @type {UsernameRegexTemplate}
+   */
+  inviteLink: {
+    // Used by moderation bots to detect scammers and invite spammers.
+    pure: [
+      '((discordapp|discord)\\s?\\.\\s?co(m)?\\s?\\W\\s?(invite|servers)\\s?\\W)',
+      '(discord\\s?\\.\\s?gg\\s?\\W)',
+    ],
+    // Standard URL detectors.
+    start: '(?:https?://)?(?:discord\\.gg/|(discord|discordapp)\\.com/(invite|servers)/)',
+    validValues: '[a-zA-Z0-9_-]',
+    length: [2, 300],
+    // Keeps "?utm_source=..." and friends attached to the invite code.
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * Game Profile Mention Code
+   * Format: <@$GAME_ID>
+   * @type {UsernameRegexTemplate}
+   */
+  gameProfile: {
+    prefix: '<@$',
+    validValues: '[0-9]',
+    length: [17, 22],
+    domain: '>',
+  },
+
+  /**
+   * Guild Navigation Code
+   * Format: <id:TYPE> or <id:linked-roles:ROLE_ID>
+   * Types: customize, browse, guide, linked-roles
+   * @type {UsernameRegexTemplate}
+   */
+  guildNavigation: {
+    prefix: '<id:',
+    validValues: '[a-z-]',
+    length: [1, 12],
+    domainPattern: '(?::[0-9]{17,22})?>',
+  },
+
+  /**
+   * CDN: Attachment
+   * Format: https://cdn.discordapp.com/attachments/CHANNEL_ID/ATTACHMENT_ID/FILENAME
+   * The filename may carry the "SPOILER_" prefix when the upload was marked as a spoiler.
+   * @type {UsernameRegexTemplate}
+   */
+  cdnAttachment: {
+    start: `${CDN_HOST}/attachments/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/[0-9]{17,22}/${CDN_FILENAME}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Custom Emoji
+   * Format: https://cdn.discordapp.com/emojis/EMOJI_ID.png
+   * @type {UsernameRegexTemplate}
+   */
+  cdnEmoji: {
+    start: `${CDN_HOST}/emojis/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: CDN_EXT,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Guild Icon
+   * Format: https://cdn.discordapp.com/icons/GUILD_ID/HASH.png
+   * @type {UsernameRegexTemplate}
+   */
+  cdnGuildIcon: {
+    start: `${CDN_HOST}/icons/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/${CDN_HASH}${CDN_EXT}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Guild Splash
+   * @type {UsernameRegexTemplate}
+   */
+  cdnGuildSplash: {
+    start: `${CDN_HOST}/splashes/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/${CDN_HASH}${CDN_EXT}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Guild Discovery Splash
+   * @type {UsernameRegexTemplate}
+   */
+  cdnGuildDiscoverySplash: {
+    start: `${CDN_HOST}/discovery-splashes/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/${CDN_HASH}${CDN_EXT}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Banner (shared by Guild Banner and User Banner).
+   * @type {UsernameRegexTemplate}
+   */
+  cdnBanner: {
+    start: `${CDN_HOST}/banners/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/${CDN_HASH}${CDN_EXT}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Default User Avatar
+   * @type {UsernameRegexTemplate}
+   */
+  cdnDefaultUserAvatar: {
+    start: `${CDN_HOST}/embed/avatars/`,
+    validValues: '[0-9]',
+    length: [1, 2],
+    domainPattern: CDN_EXT,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: User Avatar
+   * @type {UsernameRegexTemplate}
+   */
+  cdnUserAvatar: {
+    start: `${CDN_HOST}/avatars/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/${CDN_HASH}${CDN_EXT}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Guild Member Avatar
+   * @type {UsernameRegexTemplate}
+   */
+  cdnGuildMemberAvatar: {
+    start: `${CDN_HOST}/guilds/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/users/[0-9]{17,22}/avatars/${CDN_HASH}${CDN_EXT}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Guild Member Banner
+   * @type {UsernameRegexTemplate}
+   */
+  cdnGuildMemberBanner: {
+    start: `${CDN_HOST}/guilds/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/users/[0-9]{17,22}/banners/${CDN_HASH}${CDN_EXT}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Avatar Decoration Preset
+   * @type {UsernameRegexTemplate}
+   */
+  cdnAvatarDecoration: {
+    start: `${CDN_HOST}/avatar-decoration-presets/`,
+    validValues: '[A-Za-z0-9_-]',
+    length: [1, 64],
+    domainPattern: CDN_EXT,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Application Icon or Cover (shared path).
+   * @type {UsernameRegexTemplate}
+   */
+  cdnApplicationIcon: {
+    start: `${CDN_HOST}/app-icons/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/${CDN_HASH}${CDN_EXT}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Application Asset
+   * @type {UsernameRegexTemplate}
+   */
+  cdnApplicationAsset: {
+    start: `${CDN_HOST}/app-assets/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/${CDN_HASH}${CDN_EXT}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Achievement Icon
+   * @type {UsernameRegexTemplate}
+   */
+  cdnAchievementIcon: {
+    start: `${CDN_HOST}/app-assets/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/achievements/[0-9]{17,22}/icons/${CDN_HASH}${CDN_EXT}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Store Page Asset
+   * @type {UsernameRegexTemplate}
+   */
+  cdnStorePageAsset: {
+    start: `${CDN_HOST}/app-assets/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/store/${CDN_HASH}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Sticker Pack Banner
+   * Format: https://cdn.discordapp.com/app-assets/APP_ID/store/HASH.png
+   * @type {UsernameRegexTemplate}
+   */
+  cdnStickerPackBanner: {
+    start: `${CDN_HOST}/app-assets/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/store/${CDN_HASH}${CDN_EXT}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Team Icon
+   * @type {UsernameRegexTemplate}
+   */
+  cdnTeamIcon: {
+    start: `${CDN_HOST}/team-icons/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/${CDN_HASH}${CDN_EXT}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Sticker
+   * @type {UsernameRegexTemplate}
+   */
+  cdnSticker: {
+    start: `${CDN_HOST}/stickers/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: CDN_EXT,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Role Icon
+   * @type {UsernameRegexTemplate}
+   */
+  cdnRoleIcon: {
+    start: `${CDN_HOST}/role-icons/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/${CDN_HASH}${CDN_EXT}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Guild Scheduled Event Cover
+   * @type {UsernameRegexTemplate}
+   */
+  cdnGuildScheduledEventCover: {
+    start: `${CDN_HOST}/guild-events/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/${CDN_HASH}${CDN_EXT}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+
+  /**
+   * CDN: Guild Tag Badge
+   * @type {UsernameRegexTemplate}
+   */
+  cdnGuildTagBadge: {
+    start: `${CDN_HOST}/guild-tag-badges/`,
+    validValues: '[0-9]',
+    length: [17, 22],
+    domainPattern: `/${CDN_HASH}${CDN_EXT}`,
+    end: OPTIONAL_QUERY_STRING,
+  },
+});
+
+module.exports = DiscordRegex;