@oxy.so/contracts 1.1.1 → 1.3.0

package/dist/types/username.d.ts

@@ -106,6 +106,29 @@ export declare const USERNAME_MIN_LENGTH = 3;
 export declare const USERNAME_MAX_LENGTH = 30;
 /** The 400 / inline-validation copy for every path that rejects a handle. */
 export declare const USERNAME_INVALID_MESSAGE: string;
+/**
+ * Exact-match handles nobody may newly claim, regardless of account kind.
+ *
+ * This is NOT a namespace tightening like the bot suffix — it is a list of
+ * names withheld from `users_lower_username_key` before anybody asks for
+ * them. Compared against the same normalization the unique index applies
+ * (`lower(btrim(username))`), so `Admin`, ` ADMIN ` and `admin` are the one
+ * name this list means.
+ *
+ * `oxy`, `mention`, `homiio`, `clarity`, `faircoin`, `astro` and `mercaria`
+ * are deliberately NOT here: each already has an `organization`/`project`
+ * row, so the unique index already refuses a second one, and `oxy` is the
+ * name `USERNAME_MIN_LENGTH` is pinned against in
+ * `__tests__/username.test.ts` — listing it would make
+ * `usernameSchema.safeParse('oxy')` fail and falsify that comment. A brand
+ * with no account of its own yet (measured 2026-09-18: Alia, Allo, TNP,
+ * Kaana, Bloom) has no row to protect it, so it is listed until one exists.
+ */
+export declare const RESERVED_USERNAMES: ReadonlySet<string>;
+/** The 400 / inline-validation copy for a handle on {@link RESERVED_USERNAMES}. */
+export declare const RESERVED_USERNAME_MESSAGE = "This username is reserved and cannot be registered";
+/** The 400 / inline-validation copy for a handle that is only digits. */
+export declare const NUMERIC_USERNAME_MESSAGE = "Username cannot be only numbers";
 /**
  * Alphanumeric runs joined by single separators, as a SOURCE string.
  *
@@ -136,7 +159,7 @@ export declare const USERNAME_PATTERN_SOURCE = "^[A-Za-z0-9]+(?:[-_][A-Za-z0-9]+
  * they never chose. Every write path validates through THIS object; nothing
  * re-implements it.
  */
-export declare const usernameSchema: z.ZodString;
+export declare const usernameSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
 /**
  * Whether a candidate handle is storable — the boolean form, for input surfaces
  * that show a message as somebody types rather than throwing.
@@ -230,7 +253,7 @@ export declare const BOT_USERNAME_INVALID_MESSAGE = "A bot account's username mu
  * `community-maestro`, `community-pulse`, `garden-helper`, `luna`, `verity`).
  * They go on loading and resolving; only a NEW handle is held to this.
  */
-export declare const botUsernameSchema: z.ZodEffects<z.ZodString, string, string>;
+export declare const botUsernameSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, string, string>;
 /**
  * The policy that governs a handle, given the kind of account that will hold it.
  *