@zudojs/constants 1.1.3 → 1.2.0

package/dist/cache/cacheControl.type.d.ts

@@ -50,4 +50,3 @@ export interface CacheControlOptions {
  * non-negative finite integer
  */
 export declare function buildCacheControl(options: CacheControlOptions): string;
-//# sourceMappingURL=cacheControl.type.d.ts.map

package/dist/cache/cacheControl.type.js

@@ -73,4 +73,3 @@ export function buildCacheControl(options) {
     }
     return parts.join(", ");
 }
-//# sourceMappingURL=cacheControl.type.js.map

package/dist/cache/cacheStrategy.type.d.ts

@@ -22,4 +22,3 @@ export declare const CacheStrategies: Readonly<{
     /** Cache indefinitely, never revalidate */
     readonly IMMUTABLE: "immutable";
 }>;
-//# sourceMappingURL=cacheStrategy.type.d.ts.map

package/dist/cache/cacheStrategy.type.js

@@ -20,4 +20,3 @@ export const CacheStrategies = Object.freeze({
     /** Cache indefinitely, never revalidate */
     IMMUTABLE: "immutable",
 });
-//# sourceMappingURL=cacheStrategy.type.js.map

package/dist/cache/index.d.ts

@@ -5,4 +5,3 @@
  */
 export { type CacheStrategy, CacheStrategies } from "./cacheStrategy.type.js";
 export { CacheDuration, type CacheControlOptions, buildCacheControl, } from "./cacheControl.type.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.js

@@ -5,4 +5,3 @@
  */
 export { CacheStrategies } from "./cacheStrategy.type.js";
 export { CacheDuration, buildCacheControl, } from "./cacheControl.type.js";
-//# sourceMappingURL=index.js.map

package/dist/common/common.constant.d.ts

@@ -1,10 +1,10 @@
 /**
- * Common default values, limits, sentinel constants, and branded-type
- * factories.
+ * Common default values, limits, sentinel constants, and branded string
+ * factories. Identifier factories live in `common.identifier.ts`.
  *
  * @module common/common
  */
-import { type UserId, type EventId, type RequestId, type CorrelationId, type SessionId, type MessageId, type MessageCausationId, type TokenId, type Url, type HexString, type Base64String, type JsonString } from "./common.type.js";
+import type { Url, HexString, Base64String, JsonString } from "./common.type.js";
 /** Sentinel value indicating absence of a value. */
 export declare const NONE: "NONE";
 /** Sentinel value indicating an uninitialized state. */
@@ -89,38 +89,6 @@ export declare const Sentinel: Readonly<{
     /** Wildcard for matching all */
     readonly WILDCARD: "*";
 }>;
-/**
- * Create a branded UserId from a raw string.
- */
-export declare function createUserId(id: string): UserId;
-/**
- * Create a branded EventId from a raw string.
- */
-export declare function createEventId(id: string): EventId;
-/**
- * Create a branded RequestId from a raw string.
- */
-export declare function createRequestId(id: string): RequestId;
-/**
- * Create a branded CorrelationId from a raw string.
- */
-export declare function createCorrelationId(id: string): CorrelationId;
-/**
- * Create a branded SessionId from a raw string.
- */
-export declare function createSessionId(id: string): SessionId;
-/**
- * Create a branded MessageId from a raw string.
- */
-export declare function createMessageId(id: string): MessageId;
-/**
- * Create a branded MessageCausationId from a raw string.
- */
-export declare function createMessageCausationId(id: string): MessageCausationId;
-/**
- * Create a branded TokenId from a raw string.
- */
-export declare function createTokenId(id: string): TokenId;
 /**
  * Create a branded Url from a raw string.
  *
@@ -145,4 +113,3 @@ export declare function createBase64String(base64: string): Base64String;
  * @throws {InvalidConstantError} if the input is not parseable JSON.
  */
 export declare function createJsonString(json: string): JsonString;
-//# sourceMappingURL=common.constant.d.ts.map

package/dist/common/common.constant.js

@@ -1,10 +1,9 @@
 /**
- * Common default values, limits, sentinel constants, and branded-type
- * factories.
+ * Common default values, limits, sentinel constants, and branded string
+ * factories. Identifier factories live in `common.identifier.ts`.
  *
  * @module common/common
  */
-import {} from "./common.type.js";
 import { ContentTypes, Charset } from "../http/httpContentType.type.js";
 import { InvalidConstantError } from "../constantsErrors/constantsError.base.js";
 /** Sentinel value indicating absence of a value. */
@@ -91,54 +90,6 @@ export const Sentinel = Object.freeze({
     /** Wildcard for matching all */
     WILDCARD: "*",
 });
-/**
- * Create a branded UserId from a raw string.
- */
-export function createUserId(id) {
-    return id;
-}
-/**
- * Create a branded EventId from a raw string.
- */
-export function createEventId(id) {
-    return id;
-}
-/**
- * Create a branded RequestId from a raw string.
- */
-export function createRequestId(id) {
-    return id;
-}
-/**
- * Create a branded CorrelationId from a raw string.
- */
-export function createCorrelationId(id) {
-    return id;
-}
-/**
- * Create a branded SessionId from a raw string.
- */
-export function createSessionId(id) {
-    return id;
-}
-/**
- * Create a branded MessageId from a raw string.
- */
-export function createMessageId(id) {
-    return id;
-}
-/**
- * Create a branded MessageCausationId from a raw string.
- */
-export function createMessageCausationId(id) {
-    return id;
-}
-/**
- * Create a branded TokenId from a raw string.
- */
-export function createTokenId(id) {
-    return id;
-}
 /**
  * Create a branded Url from a raw string.
  *
@@ -186,4 +137,3 @@ export function createJsonString(json) {
     }
     return json;
 }
-//# sourceMappingURL=common.constant.js.map

package/dist/common/common.factory.d.ts

@@ -44,4 +44,3 @@ export declare function createTimestamp(iso: string): Timestamp;
  * @throws {InvalidConstantError} if the input is not a valid email address.
  */
 export declare function createEmailAddress(email: string): EmailAddress;
-//# sourceMappingURL=common.factory.d.ts.map

package/dist/common/common.factory.js

@@ -93,4 +93,3 @@ export function createEmailAddress(email) {
     }
     return email;
 }
-//# sourceMappingURL=common.factory.js.map

package/dist/common/common.identifier.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Branded identifier factories.
+ *
+ * Each factory checks that it was handed a non-empty string before applying
+ * the brand. The brand is compile-time only (see {@link Brand}), so without
+ * this check `createUserId("")` and `createUserId(123 as never)` produced a
+ * "UserId" that no consumer could tell apart from a real one until it
+ * reached a database or a URL.
+ *
+ * @module common/identifier
+ */
+import type { UserId, EventId, RequestId, CorrelationId, SessionId, MessageId, MessageCausationId, TokenId } from "./common.type.js";
+/**
+ * Asserts that an identifier is a non-empty string.
+ *
+ * The value itself is never echoed: identifiers include session and token
+ * ids, which must not land in a log line through an error message.
+ *
+ * @throws {InvalidConstantError} when `id` is not a string or is empty.
+ */
+export declare function assertIdentifier(id: unknown, label: string): asserts id is string;
+/**
+ * Create a branded UserId from a raw string.
+ *
+ * @throws {InvalidConstantError} if the input is not a non-empty string.
+ */
+export declare function createUserId(id: string): UserId;
+/**
+ * Create a branded EventId from a raw string.
+ *
+ * @throws {InvalidConstantError} if the input is not a non-empty string.
+ */
+export declare function createEventId(id: string): EventId;
+/**
+ * Create a branded RequestId from a raw string.
+ *
+ * @throws {InvalidConstantError} if the input is not a non-empty string.
+ */
+export declare function createRequestId(id: string): RequestId;
+/**
+ * Create a branded CorrelationId from a raw string.
+ *
+ * @throws {InvalidConstantError} if the input is not a non-empty string.
+ */
+export declare function createCorrelationId(id: string): CorrelationId;
+/**
+ * Create a branded SessionId from a raw string.
+ *
+ * @throws {InvalidConstantError} if the input is not a non-empty string.
+ */
+export declare function createSessionId(id: string): SessionId;
+/**
+ * Create a branded MessageId from a raw string.
+ *
+ * @throws {InvalidConstantError} if the input is not a non-empty string.
+ */
+export declare function createMessageId(id: string): MessageId;
+/**
+ * Create a branded MessageCausationId from a raw string.
+ *
+ * @throws {InvalidConstantError} if the input is not a non-empty string.
+ */
+export declare function createMessageCausationId(id: string): MessageCausationId;
+/**
+ * Create a branded TokenId from a raw string.
+ *
+ * @throws {InvalidConstantError} if the input is not a non-empty string.
+ */
+export declare function createTokenId(id: string): TokenId;

package/dist/common/common.identifier.js

@@ -0,0 +1,100 @@
+/**
+ * Branded identifier factories.
+ *
+ * Each factory checks that it was handed a non-empty string before applying
+ * the brand. The brand is compile-time only (see {@link Brand}), so without
+ * this check `createUserId("")` and `createUserId(123 as never)` produced a
+ * "UserId" that no consumer could tell apart from a real one until it
+ * reached a database or a URL.
+ *
+ * @module common/identifier
+ */
+import { InvalidConstantError } from "../constantsErrors/constantsError.base.js";
+/**
+ * Asserts that an identifier is a non-empty string.
+ *
+ * The value itself is never echoed: identifiers include session and token
+ * ids, which must not land in a log line through an error message.
+ *
+ * @throws {InvalidConstantError} when `id` is not a string or is empty.
+ */
+export function assertIdentifier(id, label) {
+    if (typeof id !== "string") {
+        throw new InvalidConstantError(`${label} must be a non-empty string, received ${id === null ? "null" : typeof id}.`);
+    }
+    if (id.length === 0) {
+        throw new InvalidConstantError(`${label} must be a non-empty string.`);
+    }
+}
+/**
+ * Create a branded UserId from a raw string.
+ *
+ * @throws {InvalidConstantError} if the input is not a non-empty string.
+ */
+export function createUserId(id) {
+    assertIdentifier(id, "UserId");
+    return id;
+}
+/**
+ * Create a branded EventId from a raw string.
+ *
+ * @throws {InvalidConstantError} if the input is not a non-empty string.
+ */
+export function createEventId(id) {
+    assertIdentifier(id, "EventId");
+    return id;
+}
+/**
+ * Create a branded RequestId from a raw string.
+ *
+ * @throws {InvalidConstantError} if the input is not a non-empty string.
+ */
+export function createRequestId(id) {
+    assertIdentifier(id, "RequestId");
+    return id;
+}
+/**
+ * Create a branded CorrelationId from a raw string.
+ *
+ * @throws {InvalidConstantError} if the input is not a non-empty string.
+ */
+export function createCorrelationId(id) {
+    assertIdentifier(id, "CorrelationId");
+    return id;
+}
+/**
+ * Create a branded SessionId from a raw string.
+ *
+ * @throws {InvalidConstantError} if the input is not a non-empty string.
+ */
+export function createSessionId(id) {
+    assertIdentifier(id, "SessionId");
+    return id;
+}
+/**
+ * Create a branded MessageId from a raw string.
+ *
+ * @throws {InvalidConstantError} if the input is not a non-empty string.
+ */
+export function createMessageId(id) {
+    assertIdentifier(id, "MessageId");
+    return id;
+}
+/**
+ * Create a branded MessageCausationId from a raw string.
+ *
+ * @throws {InvalidConstantError} if the input is not a non-empty string.
+ */
+export function createMessageCausationId(id) {
+    assertIdentifier(id, "MessageCausationId");
+    return id;
+}
+/**
+ * Create a branded TokenId from a raw string.
+ *
+ * @throws {InvalidConstantError} if the input is not a non-empty string.
+ */
+export function createTokenId(id) {
+    assertIdentifier(id, "TokenId");
+    return id;
+}

package/dist/common/common.lifecycle.d.ts

@@ -60,4 +60,3 @@ export declare const LIFECYCLE_DEFAULT_RETRY_ATTEMPTS: 3;
 export declare const LIFECYCLE_DEFAULT_RETRY_DELAY = 500;
 /** Maximum retry delay (ms). */
 export declare const LIFECYCLE_DEFAULT_RETRY_MAX_DELAY = 10000;
-//# sourceMappingURL=common.lifecycle.d.ts.map

package/dist/common/common.lifecycle.js

@@ -95,4 +95,3 @@ export const LIFECYCLE_DEFAULT_RETRY_ATTEMPTS = DefaultRetry.MAX_ATTEMPTS;
 export const LIFECYCLE_DEFAULT_RETRY_DELAY = 500;
 /** Maximum retry delay (ms). */
 export const LIFECYCLE_DEFAULT_RETRY_MAX_DELAY = 10_000;
-//# sourceMappingURL=common.lifecycle.js.map

package/dist/common/common.schema.d.ts

@@ -80,4 +80,3 @@ export declare const SCHEMA_STRING_FORMATS: Readonly<{
     readonly HEX_COLOR: RegExp;
     readonly PHONE: RegExp;
 }>;
-//# sourceMappingURL=common.schema.d.ts.map

package/dist/common/common.schema.js

@@ -85,4 +85,3 @@ export const SCHEMA_STRING_FORMATS = Object.freeze({
     HEX_COLOR: ValidationPattern.HEX_COLOR,
     PHONE: ValidationPattern.PHONE,
 });
-//# sourceMappingURL=common.schema.js.map

package/dist/common/common.serialization.d.ts

@@ -58,4 +58,3 @@ export declare const SerializationTags: Readonly<{
 }>;
 /** Current serialization schema version. */
 export declare const SERIALIZATION_SCHEMA_VERSION = 1;
-//# sourceMappingURL=common.serialization.d.ts.map

package/dist/common/common.serialization.js

@@ -60,4 +60,3 @@ export const SerializationTags = Object.freeze({
 });
 /** Current serialization schema version. */
 export const SERIALIZATION_SCHEMA_VERSION = 1;
-//# sourceMappingURL=common.serialization.js.map

package/dist/common/common.type.d.ts

@@ -8,6 +8,15 @@
  *
  * Brands prevent accidental assignment between structurally identical types
  * (e.g. a UserId cannot be passed where an EventId is expected).
+ *
+ * The brand is compile-time only. At runtime a `UserId` is a plain string:
+ * `__brand` is never present as a property, `typeof` and `JSON.stringify`
+ * see an ordinary string, and any value cast with `as UserId` passes the
+ * type. The key is a string rather than a `unique symbol` on purpose: two
+ * copies of `@zudojs/constants` (or a consumer that declares its own
+ * `Brand<string, "UserId">`) stay assignable to each other, which a symbol
+ * brand would forbid. Runtime checks belong in the `create*Id` factories,
+ * which reject empty and non-string input.
  */
 export type Brand<T, B extends string> = T & {
     readonly __brand: B;
@@ -44,4 +53,3 @@ export type HexString = Brand<string, "HexString">;
 export type Base64String = Brand<string, "Base64String">;
 /** JSON-serialized string. */
 export type JsonString = Brand<string, "JsonString">;
-//# sourceMappingURL=common.type.d.ts.map

package/dist/common/common.type.js

@@ -4,4 +4,3 @@
  * @module common/common
  */
 export {};
-//# sourceMappingURL=common.type.js.map

package/dist/common/index.d.ts

@@ -4,9 +4,9 @@
  * @module common
  */
 export { type Brand, type EntityId, type UserId, type EventId, type RequestId, type CorrelationId, type SessionId, type TenantId, type MessageId, type MessageCausationId, type TokenId, type Timestamp, type Url, type EmailAddress, type HexString, type Base64String, type JsonString, } from "./common.type.js";
-export { NONE, UNINITIALIZED, EMPTY, Limits, Defaults, Sentinel, createUserId, createEventId, createRequestId, createCorrelationId, createSessionId, createMessageId, createMessageCausationId, createTokenId, createUrl, createHexString, createBase64String, createJsonString, } from "./common.constant.js";
+export { NONE, UNINITIALIZED, EMPTY, Limits, Defaults, Sentinel, createUrl, createHexString, createBase64String, createJsonString, } from "./common.constant.js";
+export { assertIdentifier, createUserId, createEventId, createRequestId, createCorrelationId, createSessionId, createMessageId, createMessageCausationId, createTokenId, } from "./common.identifier.js";
 export { createTenantId, createTimestamp, createEmailAddress, TENANT_ID_PATTERN, MAX_TENANT_ID_LENGTH, } from "./common.factory.js";
 export { SerializationFormat, SerializationContentType, SerializationLimits, SerializationTags, SERIALIZATION_SCHEMA_VERSION, } from "./common.serialization.js";
 export { SchemaIssueCode, SCHEMA_DEFAULT_MAX_DEPTH, SCHEMA_DEFAULT_MAX_STRING_LENGTH, SCHEMA_DEFAULT_MAX_ARRAY_LENGTH, SCHEMA_DEFAULT_MAX_OBJECT_KEYS, SCHEMA_FORBIDDEN_KEYS, SCHEMA_STRING_FORMATS, } from "./common.schema.js";
 export { LifecycleState, LifecyclePhase, LIFECYCLE_VALID_TRANSITIONS, LIFECYCLE_DEFAULT_TIMEOUT, LIFECYCLE_DEFAULT_START_TIMEOUT, LIFECYCLE_DEFAULT_STOP_TIMEOUT, LIFECYCLE_DEFAULT_SHUTDOWN_TIMEOUT, LIFECYCLE_DEFAULT_CONCURRENCY, LIFECYCLE_DEFAULT_RETRY_ATTEMPTS, LIFECYCLE_DEFAULT_RETRY_DELAY, LIFECYCLE_DEFAULT_RETRY_MAX_DELAY, } from "./common.lifecycle.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/common/index.js

@@ -4,9 +4,9 @@
  * @module common
  */
 export {} from "./common.type.js";
-export { NONE, UNINITIALIZED, EMPTY, Limits, Defaults, Sentinel, createUserId, createEventId, createRequestId, createCorrelationId, createSessionId, createMessageId, createMessageCausationId, createTokenId, createUrl, createHexString, createBase64String, createJsonString, } from "./common.constant.js";
+export { NONE, UNINITIALIZED, EMPTY, Limits, Defaults, Sentinel, createUrl, createHexString, createBase64String, createJsonString, } from "./common.constant.js";
+export { assertIdentifier, createUserId, createEventId, createRequestId, createCorrelationId, createSessionId, createMessageId, createMessageCausationId, createTokenId, } from "./common.identifier.js";
 export { createTenantId, createTimestamp, createEmailAddress, TENANT_ID_PATTERN, MAX_TENANT_ID_LENGTH, } from "./common.factory.js";
 export { SerializationFormat, SerializationContentType, SerializationLimits, SerializationTags, SERIALIZATION_SCHEMA_VERSION, } from "./common.serialization.js";
 export { SchemaIssueCode, SCHEMA_DEFAULT_MAX_DEPTH, SCHEMA_DEFAULT_MAX_STRING_LENGTH, SCHEMA_DEFAULT_MAX_ARRAY_LENGTH, SCHEMA_DEFAULT_MAX_OBJECT_KEYS, SCHEMA_FORBIDDEN_KEYS, SCHEMA_STRING_FORMATS, } from "./common.schema.js";
 export { LifecycleState, LifecyclePhase, LIFECYCLE_VALID_TRANSITIONS, LIFECYCLE_DEFAULT_TIMEOUT, LIFECYCLE_DEFAULT_START_TIMEOUT, LIFECYCLE_DEFAULT_STOP_TIMEOUT, LIFECYCLE_DEFAULT_SHUTDOWN_TIMEOUT, LIFECYCLE_DEFAULT_CONCURRENCY, LIFECYCLE_DEFAULT_RETRY_ATTEMPTS, LIFECYCLE_DEFAULT_RETRY_DELAY, LIFECYCLE_DEFAULT_RETRY_MAX_DELAY, } from "./common.lifecycle.js";
-//# sourceMappingURL=index.js.map

package/dist/constantsErrors/constantsError.base.d.ts

@@ -7,4 +7,3 @@
  * @module constantsErrors
  */
 export { InvalidConstantError, ConstantContextError } from "@zudojs/errors";
-//# sourceMappingURL=constantsError.base.d.ts.map

package/dist/constantsErrors/constantsError.base.js

@@ -7,4 +7,3 @@
  * @module constantsErrors
  */
 export { InvalidConstantError, ConstantContextError } from "@zudojs/errors";
-//# sourceMappingURL=constantsError.base.js.map

package/dist/constantsErrors/index.d.ts

@@ -4,4 +4,3 @@
  * @module constantsErrors
  */
 export { InvalidConstantError, ConstantContextError, } from "./constantsError.base.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/constantsErrors/index.js

@@ -4,4 +4,3 @@
  * @module constantsErrors
  */
 export { InvalidConstantError, ConstantContextError, } from "./constantsError.base.js";
-//# sourceMappingURL=index.js.map

package/dist/environment/environment.constant.d.ts

@@ -51,4 +51,3 @@ export declare function isDevelopment(envOverride?: Record<string, string | unde
  * Check whether the current environment is test.
  */
 export declare function isTest(envOverride?: Record<string, string | undefined>): boolean;
-//# sourceMappingURL=environment.constant.d.ts.map

package/dist/environment/environment.constant.js

@@ -71,4 +71,3 @@ export function isDevelopment(envOverride) {
 export function isTest(envOverride) {
     return resolveEnvironment(envOverride) === "test";
 }
-//# sourceMappingURL=environment.constant.js.map

package/dist/environment/environment.type.d.ts

@@ -20,4 +20,3 @@ export declare const ENVIRONMENTS: ReadonlySet<Environment>;
  * Check whether a string is a valid Environment value.
  */
 export declare function isValidEnvironment(value: string): value is Environment;
-//# sourceMappingURL=environment.type.d.ts.map

package/dist/environment/environment.type.js

@@ -21,4 +21,3 @@ export const ENVIRONMENTS = new ImmutableSet(Object.values(Environments));
 export function isValidEnvironment(value) {
     return ENVIRONMENTS.has(value);
 }
-//# sourceMappingURL=environment.type.js.map

package/dist/environment/index.d.ts

@@ -5,4 +5,3 @@
  */
 export { type Environment, Environments, ENVIRONMENTS, isValidEnvironment, } from "./environment.type.js";
 export { NODE_ENV_KEY, type ResolveEnvironmentOptions, resolveEnvironment, isProduction, isDevelopment, isTest, } from "./environment.constant.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/environment/index.js

@@ -5,4 +5,3 @@
  */
 export { Environments, ENVIRONMENTS, isValidEnvironment, } from "./environment.type.js";
 export { NODE_ENV_KEY, resolveEnvironment, isProduction, isDevelopment, isTest, } from "./environment.constant.js";
-//# sourceMappingURL=index.js.map

package/dist/http/httpContentType.type.d.ts

@@ -62,4 +62,3 @@ export declare const Charset: Readonly<{
  * provided but empty/blank.
  */
 export declare function buildContentType(mimeType: AnyContentType, charset?: string): string;
-//# sourceMappingURL=httpContentType.type.d.ts.map

package/dist/http/httpContentType.type.js

@@ -68,4 +68,3 @@ export function buildContentType(mimeType, charset) {
     }
     return `${mimeType}; charset=${charset}`;
 }
-//# sourceMappingURL=httpContentType.type.js.map

package/dist/http/httpHeader.type.d.ts

@@ -44,4 +44,3 @@ export type HttpHeaderName = (typeof HttpHeader)[keyof typeof HttpHeader];
  * {@link HttpHeader} catalogue (still autocompletes the known names).
  */
 export type AnyHttpHeaderName = HttpHeaderName | (string & {});
-//# sourceMappingURL=httpHeader.type.d.ts.map

package/dist/http/httpHeader.type.js

@@ -37,4 +37,3 @@ export const HttpHeader = Object.freeze({
     X_API_KEY: "X-Api-Key",
     X_CORRELATION_ID: "X-Correlation-Id",
 });
-//# sourceMappingURL=httpHeader.type.js.map

package/dist/http/httpMethod.type.d.ts

@@ -25,4 +25,3 @@ export declare const HTTP_METHODS: ReadonlySet<HttpMethod>;
 export declare const SAFE_HTTP_METHODS: ReadonlySet<HttpMethod>;
 /** HTTP methods that are idempotent. Immutable at runtime. */
 export declare const IDEMPOTENT_HTTP_METHODS: ReadonlySet<HttpMethod>;
-//# sourceMappingURL=httpMethod.type.d.ts.map

package/dist/http/httpMethod.type.js

@@ -35,4 +35,3 @@ export const IDEMPOTENT_HTTP_METHODS = new ImmutableSet([
     HttpMethods.OPTIONS,
     HttpMethods.TRACE,
 ]);
-//# sourceMappingURL=httpMethod.type.js.map

package/dist/http/httpStatus.type.d.ts

@@ -96,4 +96,3 @@ export declare function isServerError(code: number): boolean;
  * Check whether a status code represents any error (4xx or 5xx).
  */
 export declare function isErrorStatus(code: number): boolean;
-//# sourceMappingURL=httpStatus.type.d.ts.map

package/dist/http/httpStatus.type.js

@@ -104,4 +104,3 @@ export function isServerError(code) {
 export function isErrorStatus(code) {
     return isClientError(code) || isServerError(code);
 }
-//# sourceMappingURL=httpStatus.type.js.map

package/dist/http/index.d.ts

@@ -7,4 +7,3 @@ export { type HttpMethod, HttpMethods, HTTP_METHODS, SAFE_HTTP_METHODS, IDEMPOTE
 export { type HttpStatusCode, type AnyHttpStatusCode, HttpStatus, isSuccessStatus, isRedirectStatus, isClientError, isServerError, isErrorStatus, } from "./httpStatus.type.js";
 export { type HttpHeaderName, type AnyHttpHeaderName, HttpHeader, } from "./httpHeader.type.js";
 export { type ContentType, type AnyContentType, ContentTypes, Charset, buildContentType, } from "./httpContentType.type.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/http/index.js

@@ -7,4 +7,3 @@ export { HttpMethods, HTTP_METHODS, SAFE_HTTP_METHODS, IDEMPOTENT_HTTP_METHODS,
 export { HttpStatus, isSuccessStatus, isRedirectStatus, isClientError, isServerError, isErrorStatus, } from "./httpStatus.type.js";
 export { HttpHeader, } from "./httpHeader.type.js";
 export { ContentTypes, Charset, buildContentType, } from "./httpContentType.type.js";
-//# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -18,4 +18,3 @@ export * from "./cache/index.js";
 export * from "./priority/index.js";
 export * from "./constantsErrors/index.js";
 export * from "./runtime/index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -18,4 +18,3 @@ export * from "./cache/index.js";
 export * from "./priority/index.js";
 export * from "./constantsErrors/index.js";
 export * from "./runtime/index.js";
-//# sourceMappingURL=index.js.map

package/dist/internal/immutableSet.d.ts

@@ -41,4 +41,3 @@ export declare class ImmutableSet<T> implements ReadonlySet<T> {
     /** @throws {TypeError} always — this set is immutable. */
     clear(): never;
 }
-//# sourceMappingURL=immutableSet.d.ts.map

package/dist/internal/immutableSet.js

@@ -68,4 +68,3 @@ export class ImmutableSet {
     }
 }
 Object.freeze(ImmutableSet.prototype);
-//# sourceMappingURL=immutableSet.js.map

package/dist/priority/index.d.ts

@@ -4,4 +4,3 @@
  * @module priority
  */
 export { type Priority, Priorities, PriorityWeight, comparePriority, } from "./priority.type.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/priority/index.js

@@ -4,4 +4,3 @@
  * @module priority
  */
 export { Priorities, PriorityWeight, comparePriority, } from "./priority.type.js";
-//# sourceMappingURL=index.js.map

package/dist/priority/priority.type.d.ts

@@ -31,4 +31,3 @@ export declare const PriorityWeight: Readonly<{
  * @returns Negative if a is more urgent, positive if b is more urgent, 0 if equal
  */
 export declare function comparePriority(a: Priority, b: Priority): number;
-//# sourceMappingURL=priority.type.d.ts.map

package/dist/priority/priority.type.js

@@ -31,4 +31,3 @@ export const PriorityWeight = Object.freeze({
 export function comparePriority(a, b) {
     return PriorityWeight[b] - PriorityWeight[a];
 }
-//# sourceMappingURL=priority.type.js.map

package/dist/runtime/clock.d.ts

@@ -5,6 +5,10 @@
  */
 /**
  * Provides deterministic time for testing.
+ *
+ * @deprecated Import `Clock` from `@zudojs/types`, the owning package. This
+ * copy differs in shape (it adds `Date()`) and is kept only so existing
+ * imports keep compiling; it will be removed in the next major.
  */
 export interface Clock {
     /**
@@ -21,6 +25,8 @@ export interface Clock {
 }
 /**
  * A mock {@link Clock} whose time can be advanced or set explicitly.
+ *
+ * @deprecated Use `FixedClock` from `@zudojs/types`.
  */
 export interface MockClock extends Clock {
     /**
@@ -35,6 +41,8 @@ export interface MockClock extends Clock {
 }
 /**
  * Default clock using real system time.
+ *
+ * @deprecated Import `systemClock` from `@zudojs/types`.
  */
 export declare const systemClock: Clock;
 /**
@@ -42,6 +50,7 @@ export declare const systemClock: Clock;
  *
  * The clock starts at `fixedTime` and stays there until `advance(ms)` or
  * `set(time)` is called.
+ *
+ * @deprecated Use `FixedClock` from `@zudojs/types`.
  */
 export declare function createMockClock(fixedTime?: number): MockClock;
-//# sourceMappingURL=clock.d.ts.map

package/dist/runtime/clock.js

@@ -5,6 +5,8 @@
  */
 /**
  * Default clock using real system time.
+ *
+ * @deprecated Import `systemClock` from `@zudojs/types`.
  */
 export const systemClock = {
     now: () => Date.now(),
@@ -15,6 +17,8 @@ export const systemClock = {
  *
  * The clock starts at `fixedTime` and stays there until `advance(ms)` or
  * `set(time)` is called.
+ *
+ * @deprecated Use `FixedClock` from `@zudojs/types`.
  */
 export function createMockClock(fixedTime = 0) {
     let time = fixedTime;
@@ -29,4 +33,3 @@ export function createMockClock(fixedTime = 0) {
         },
     };
 }
-//# sourceMappingURL=clock.js.map

package/dist/runtime/index.d.ts

@@ -1,10 +1,13 @@
 /**
  * Injectable Clock and Random interfaces for deterministic testing.
  *
+ * @deprecated `@zudojs/types` owns `Clock`, `Random`, `systemClock` and
+ * `systemRandom` (see the type ownership table). Everything here is kept so
+ * existing imports keep compiling and will be removed in the next major.
+ *
  * @module runtime
  */
 export { systemClock, createMockClock } from "./clock.js";
 export type { Clock, MockClock } from "./clock.js";
 export { systemRandom, createMockRandom } from "./random.js";
 export type { Random, RandomSource, MockRandom } from "./random.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.js

@@ -1,8 +1,11 @@
 /**
  * Injectable Clock and Random interfaces for deterministic testing.
  *
+ * @deprecated `@zudojs/types` owns `Clock`, `Random`, `systemClock` and
+ * `systemRandom` (see the type ownership table). Everything here is kept so
+ * existing imports keep compiling and will be removed in the next major.
+ *
  * @module runtime
  */
 export { systemClock, createMockClock } from "./clock.js";
 export { systemRandom, createMockRandom } from "./random.js";
-//# sourceMappingURL=index.js.map

package/dist/runtime/random.d.ts

@@ -11,7 +11,11 @@
  * so a predictable test double could be injected where tokens are minted.
  */
 declare const SecureRandomBrand: unique symbol;
-/** The randomness operations shared by {@link Random} and {@link MockRandom}. */
+/**
+ * The randomness operations shared by {@link Random} and {@link MockRandom}.
+ *
+ * @deprecated Use the `Random`/`PseudoRandom` pair from `@zudojs/types`.
+ */
 export interface RandomSource {
     /**
      * Returns a random float between 0 (inclusive) and 1 (exclusive).
@@ -35,8 +39,9 @@ export interface RandomSource {
  * salts. Branded: only {@link systemRandom} (or an implementation cast
  * deliberately) satisfies it, and {@link MockRandom} never does.
  *
- * The richer, separately-branded `Random` in `@zudojs/types` is the
- * long-term owner of this contract.
+ * @deprecated Import `Random` from `@zudojs/types`, the owning package. The
+ * two interfaces have different method sets; this one is kept only so
+ * existing imports keep compiling and will be removed in the next major.
  */
 export interface Random extends RandomSource {
     /** @internal Marks the implementation as unpredictable. */
@@ -45,6 +50,8 @@ export interface Random extends RandomSource {
 /**
  * A seeded, fully predictable generator for tests.
  *
+ * @deprecated Use `SeededRandom` from `@zudojs/types`.
+ *
  * Structurally distinct from {@link Random} (it lacks the security brand and
  * carries `deterministic: true`), so the compiler rejects it wherever a
  * secure generator is required.
@@ -56,6 +63,8 @@ export interface MockRandom extends RandomSource {
 /**
  * Default random backed by `node:crypto` (CSPRNG).
  *
+ * @deprecated Import `systemRandom` from `@zudojs/types`.
+ *
  * Every method — including `random()` — draws from the platform CSPRNG, so
  * this singleton is safe to use for tokens, session IDs, salts, and other
  * security-sensitive values. `random()` builds a 53-bit float in `[0, 1)`
@@ -65,10 +74,11 @@ export declare const systemRandom: Random;
 /**
  * Creates a mock random with a seeded sequence for deterministic testing.
  *
+ * @deprecated Use `SeededRandom` from `@zudojs/types`.
+ *
  * Uses a 32-bit linear congruential generator (Numerical Recipes constants)
  * with `Math.imul` for exact 32-bit arithmetic. Outputs are always in
  * `[0, 1)`. Not cryptographically secure — tests only.
  */
 export declare function createMockRandom(seed?: number): MockRandom;
 export {};
-//# sourceMappingURL=random.d.ts.map

package/dist/runtime/random.js

@@ -11,6 +11,8 @@ const RANDOM_FLOAT_WORDS = new Uint32Array(2);
 /**
  * Default random backed by `node:crypto` (CSPRNG).
  *
+ * @deprecated Import `systemRandom` from `@zudojs/types`.
+ *
  * Every method — including `random()` — draws from the platform CSPRNG, so
  * this singleton is safe to use for tokens, session IDs, salts, and other
  * security-sensitive values. `random()` builds a 53-bit float in `[0, 1)`
@@ -39,6 +41,8 @@ export const systemRandom = {
 /**
  * Creates a mock random with a seeded sequence for deterministic testing.
  *
+ * @deprecated Use `SeededRandom` from `@zudojs/types`.
+ *
  * Uses a 32-bit linear congruential generator (Numerical Recipes constants)
  * with `Math.imul` for exact 32-bit arithmetic. Outputs are always in
  * `[0, 1)`. Not cryptographically secure — tests only.
@@ -70,4 +74,3 @@ export function createMockRandom(seed = 1) {
         },
     };
 }
-//# sourceMappingURL=random.js.map

package/dist/time/index.d.ts

@@ -5,4 +5,3 @@
  */
 export { type TimeUnit, TimeUnits } from "./time.unit.type.js";
 export { TimeMs, DefaultTimeout, DefaultRetry, toMilliseconds, formatDuration, } from "./time.constant.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/time/index.js

@@ -5,4 +5,3 @@
  */
 export { TimeUnits } from "./time.unit.type.js";
 export { TimeMs, DefaultTimeout, DefaultRetry, toMilliseconds, formatDuration, } from "./time.constant.js";
-//# sourceMappingURL=index.js.map

package/dist/time/time.constant.d.ts

@@ -73,8 +73,12 @@ export declare function toMilliseconds(value: number, unit: "milliseconds" | "se
 /**
  * Format a millisecond duration to a human-readable string.
  *
+ * Shows the two most significant units and truncates the rest, so
+ * `formatDuration(90_500)` is "1m 30s" and `formatDuration(3_599_999)` is
+ * "59m 59s". A negative duration is formatted like its absolute value with a
+ * leading minus sign ("-1m 30s"); it used to fall through to "-90000ms".
+ *
  * @param ms - Duration in milliseconds
  * @returns Human-readable string (e.g. "5s", "2m 30s", "1h 15m")
  */
 export declare function formatDuration(ms: number): string;
-//# sourceMappingURL=time.constant.d.ts.map

package/dist/time/time.constant.js

@@ -86,10 +86,17 @@ export function toMilliseconds(value, unit) {
 /**
  * Format a millisecond duration to a human-readable string.
  *
+ * Shows the two most significant units and truncates the rest, so
+ * `formatDuration(90_500)` is "1m 30s" and `formatDuration(3_599_999)` is
+ * "59m 59s". A negative duration is formatted like its absolute value with a
+ * leading minus sign ("-1m 30s"); it used to fall through to "-90000ms".
+ *
  * @param ms - Duration in milliseconds
  * @returns Human-readable string (e.g. "5s", "2m 30s", "1h 15m")
  */
 export function formatDuration(ms) {
+    if (ms < 0)
+        return `-${formatDuration(-ms)}`;
     if (ms < TimeMs.SECOND)
         return `${ms}ms`;
     if (ms < TimeMs.MINUTE)
@@ -108,4 +115,3 @@ export function formatDuration(ms) {
     const h = Math.floor((ms % TimeMs.DAY) / TimeMs.HOUR);
     return h > 0 ? `${d}d ${h}h` : `${d}d`;
 }
-//# sourceMappingURL=time.constant.js.map

package/dist/time/time.unit.type.d.ts

@@ -15,4 +15,3 @@ export declare const TimeUnits: Readonly<{
     readonly HOURS: "hours";
     readonly DAYS: "days";
 }>;
-//# sourceMappingURL=time.unit.type.d.ts.map

package/dist/time/time.unit.type.js

@@ -13,4 +13,3 @@ export const TimeUnits = Object.freeze({
     HOURS: "hours",
     DAYS: "days",
 });
-//# sourceMappingURL=time.unit.type.js.map

package/dist/validation/index.d.ts

@@ -5,4 +5,3 @@
  */
 export { ValidationPattern } from "./validation.pattern.type.js";
 export { ValidationLength, ValidationRange } from "./validation.constant.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.js

@@ -5,4 +5,3 @@
  */
 export { ValidationPattern } from "./validation.pattern.type.js";
 export { ValidationLength, ValidationRange } from "./validation.constant.js";
-//# sourceMappingURL=index.js.map

package/dist/validation/validation.constant.d.ts

@@ -58,4 +58,3 @@ export declare const ValidationRange: Readonly<{
      */
     readonly MAX_RETRIES: 10;
 }>;
-//# sourceMappingURL=validation.constant.d.ts.map

package/dist/validation/validation.constant.js

@@ -59,4 +59,3 @@ export const ValidationRange = Object.freeze({
      */
     MAX_RETRIES: Limits.MAX_RETRY_ATTEMPTS,
 });
-//# sourceMappingURL=validation.constant.js.map

package/dist/validation/validation.pattern.type.d.ts

@@ -69,4 +69,3 @@ export declare const ValidationPattern: Readonly<{
      */
     readonly FILE_NAME: RegExp;
 }>;
-//# sourceMappingURL=validation.pattern.type.d.ts.map

package/dist/validation/validation.pattern.type.js

@@ -69,4 +69,3 @@ export const ValidationPattern = Object.freeze({
      */
     FILE_NAME: /^(?!\.{1,2}$)(?!(?:CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(?:\.|$))(?!.*[. ]$)[^<>:"/\\|?*\x00-\x1f]+$/i,
 });
-//# sourceMappingURL=validation.pattern.type.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zudojs/constants",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "description": "Shared constants, enums, and type-safe literals for the Zudojs framework.",
   "license": "MIT",
   "author": {
@@ -26,7 +26,7 @@
     "!dist/.tsbuildinfo"
   ],
   "dependencies": {
-    "@zudojs/errors": "1.3.1"
+    "@zudojs/errors": "1.4.0"
   },
   "engines": {
     "node": ">=24.0.0"