@tnid/core 0.0.2 → 0.0.4

package/README.md

@@ -1,4 +1,4 @@
-# TNID Typescript
+# @tnid/core
 
 Type-safe, named, unique identifiers (TNIDs) for TypeScript.
 
@@ -23,14 +23,12 @@ deno add npm:@tnid/core
 
 ## Platform Support
 
-| Platform | Minimum Version |
-| -------- | --------------- |
-| Node.js  | 20+             |
-| Deno     | 1.0+            |
-| Bun      | 1.0+            |
-| Browsers | ES2020+         |
+Requires `globalThis.crypto` (Web Crypto API):
 
-Requires `globalThis.crypto` (Web Crypto API).
+- Node.js 20+
+- Deno 1.0+
+- Bun 1.0+
+- Modern browsers (ES2020+)
 
 ## Quick Start
 
@@ -65,8 +63,7 @@ const fromUuid: UserId = UserId.parseUuidString(uuid);
 - **UUID compatible**: Store in any UUID column, use with existing UUID tooling
 - **Time-ordered (V0)**: Sortable by creation time, like UUIDv7
 - **High-entropy (V1)**: Maximum randomness, like UUIDv4
-- **String-backed**: At runtime, TNIDs are their string representation (e.g.
-  `user.Br2flcNDfF6LYICnT`). Use as Map keys, in JSON, or compare with `===`
+- **String-backed**: At runtime, TNIDs are their string representation
 
 ```typescript
 const id = UserId.new_v0();
@@ -82,8 +79,6 @@ JSON.stringify({ userId: id }); // {"userId":"user.Br2flcNDfF6LYICnT"}
 id === otherUserId; // true/false
 ```
 
----
-
 ## API Reference
 
 ### Exports
@@ -92,9 +87,9 @@ id === otherUserId; // true/false
 import {
   Case, // "lower" | "upper"
   DynamicTnid, // Runtime TNID operations (type + namespace)
-  Tnid, // Factory creator function
-  NamedTnid, // Named TNID interface
-  TnidType, // Type helper to extract ID type from factory
+  Tnid, // NamedTnid creator function
+  NamedTnid, // NamedTnid interface
+  TnidType, // Type helper to extract ID type
   // Types only:
   TnidValue, // Branded string type
   TnidVariant, // "v0" | "v1" | "v2" | "v3"
@@ -102,11 +97,9 @@ import {
 } from "@tnid/core";
 ```
 
----
-
 ### `Tnid(name)`
 
-Creates a factory for TNIDs with a specific name. The name is validated at
+Creates a `NamedTnid` for a specific name. The name is validated at
 **compile time**.
 
 ```typescript
@@ -117,90 +110,57 @@ const ItemId = Tnid("item");
 
 #### Name Rules
 
-- **Length**: 1-4 characters
-- **Valid characters**: `0-4` and `a-z` (31 characters total)
-- **Case**: lowercase only
+- 1-4 characters
+- Only `0-4` and `a-z` (31 characters total)
+- Lowercase only
 
 ```typescript
 // Valid names
-Tnid("user"); // ✓
-Tnid("a"); // ✓
-Tnid("1234"); // ✓
-Tnid("a1b2"); // ✓
+Tnid("user"); // OK
+Tnid("a"); // OK
+Tnid("1234"); // OK
+Tnid("a1b2"); // OK
 
 // Compile errors
-Tnid("users"); // ✗ too long (max 4)
-Tnid("User"); // ✗ uppercase not allowed
-Tnid("a-b"); // ✗ hyphen not allowed
-Tnid("5"); // ✗ only digits 0-4
-Tnid(""); // ✗ empty not allowed
+Tnid("users"); // too long (max 4)
+Tnid("User"); // uppercase not allowed
+Tnid("a-b"); // hyphen not allowed
+Tnid("5"); // only digits 0-4
+Tnid(""); // empty not allowed
 ```
 
----
-
 ### `NamedTnid<Name>` (returned by `Tnid()`)
 
-The object returned by `Tnid(name)` has these methods:
-
-#### Properties
-
-| Property | Type   | Description                                |
-| -------- | ------ | ------------------------------------------ |
-| `name`   | `Name` | The TNID name this creates IDs for |
-
-#### Generation Methods
-
-| Method                                   | Returns           | Description                                       |
-| ---------------------------------------- | ----------------- | ------------------------------------------------- |
-| `new_v0()`                               | `TnidValue<Name>` | Generate a time-ordered ID (like UUIDv7)          |
-| `new_v1()`                               | `TnidValue<Name>` | Generate a high-entropy random ID (like UUIDv4)   |
-| `v0_from_parts(timestampMs, randomBits)` | `TnidValue<Name>` | Create V0 from explicit parts (for testing)       |
-| `v1_from_parts(randomBits)`              | `TnidValue<Name>` | Create V1 from explicit random bits (for testing) |
-
-#### Parsing Methods
-
-| Method                  | Returns           | Throws                           | Description             |
-| ----------------------- | ----------------- | -------------------------------- | ----------------------- |
-| `parse(s)`              | `TnidValue<Name>` | If invalid or name mismatch      | Parse a TNID string     |
-| `parseUuidString(uuid)` | `TnidValue<Name>` | If invalid UUID or name mismatch | Parse a UUID hex string |
-
-#### Utility Methods
-
-| Method                    | Returns       | Description                            |
-| ------------------------- | ------------- | -------------------------------------- |
-| `variant(id)`             | `TnidVariant` | Get the variant (`"v0"`, `"v1"`, etc.) |
-| `toUuidString(id, case?)` | `string`      | Convert to UUID hex format             |
-| `nameHex()`               | `string`      | Get the name as a 5-char hex string    |
-
-#### Example
+#### Generation
 
 ```typescript
 const UserId = Tnid("user");
 type UserId = TnidType<typeof UserId>;
 
-// Generation
-const id: UserId = UserId.new_v0(); // "user.Br2flcNDfF6LYICnT"
-const id2: UserId = UserId.new_v1(); // "user.EUBcUw4T9x3KNOll-"
+UserId.new_v0();                        // time-ordered ID
+UserId.new_v1();                        // high-entropy random ID
+UserId.v0_from_parts(1234567890n, 0n);  // V0 with explicit timestamp/random
+UserId.v1_from_parts(0n);               // V1 with explicit random bits
+```
 
-// Parsing
-const parsed: UserId = UserId.parse("user.Br2flcNDfF6LYICnT");
-const fromUuid: UserId = UserId.parseUuidString(
-  "d6157329-4640-8e30-8012-345678901234",
-);
-
-// Utilities
-UserId.variant(id); // "v0"
-UserId.toUuidString(id); // "d6157329-4640-8e30-8012-..."
-UserId.toUuidString(id, "upper"); // "D6157329-4640-8E30-8012-..."
-UserId.nameHex(); // "d6157"
-
-// Property
-UserId.name; // "user"
+#### Parsing
+
+```typescript
+UserId.parse("user.Br2flcNDfF6LYICnT");              // parse TNID string
+UserId.parseUuidString("d6157329-4640-8e30-...");    // parse UUID hex string
 ```
 
----
+#### Inspection and Conversion
+
+```typescript
+UserId.name;                      // "user" - the TNID name
+UserId.variant(id);               // "v0" or "v1" - get the variant
+UserId.toUuidString(id);          // "d6157329-4640-8e30-..." - convert to UUID
+UserId.toUuidString(id, "upper"); // "D6157329-4640-8E30-..." - uppercase UUID
+UserId.nameHex();                 // "d6157" - name as 5-char hex
+```
 
-### `TnidType<Factory>`
+### `TnidType<T>`
 
 Type helper to extract the `TnidValue` type from a `NamedTnid`.
 
@@ -216,131 +176,47 @@ function getUser(id: UserId): User { ... }
 function getPost(id: PostId): Post { ... }
 ```
 
----
-
 ### `DynamicTnid`
 
-For working with TNIDs when the name isn't known at compile time. This is both a
-**type** and a **namespace**.
-
-#### As a Type
-
-`DynamicTnid` accepts any TNID regardless of name:
+For working with TNIDs when the name isn't known at compile time.
 
 ```typescript
+// As a type - accepts any TNID
 function logAnyId(id: DynamicTnid) {
   console.log(DynamicTnid.getName(id), id);
 }
 
-const userId: UserId = UserId.new_v0();
-const postId: PostId = PostId.new_v0();
+// Generation with runtime names
+DynamicTnid.new_v0("user");           // time-ordered (alias: new_time_ordered)
+DynamicTnid.new_v1("user");           // high-entropy (alias: new_high_entropy)
 
-logAnyId(userId); // works
-logAnyId(postId); // works
-```
+// Generation with explicit values (useful for testing/migrations)
+DynamicTnid.new_v0_with_time("user", new Date("2024-01-15"));
+DynamicTnid.new_v0_with_parts("user", 1705312800000n, 123n);
+DynamicTnid.new_v1_with_random("user", 0x123456789abcdef0123456789n);
 
-#### Namespace Methods
+// Parsing any TNID
+DynamicTnid.parse("post.EUBcUw4T9x3KNOll-");
+DynamicTnid.parse_uuid_string("d6157329-4640-...");
 
-##### Generation
-
-| Method                                         | Returns       | Description                                |
-| ---------------------------------------------- | ------------- | ------------------------------------------ |
-| `new_v0(name)`                                 | `DynamicTnid` | Generate time-ordered ID with runtime name |
-| `new_v1(name)`                                 | `DynamicTnid` | Generate high-entropy ID with runtime name |
-| `new_time_ordered(name)`                       | `DynamicTnid` | Alias for `new_v0`                         |
-| `new_high_entropy(name)`                       | `DynamicTnid` | Alias for `new_v1`                         |
-| `new_v0_with_time(name, date)`                 | `DynamicTnid` | V0 with specific timestamp                 |
-| `new_v0_with_parts(name, epochMillis, random)` | `DynamicTnid` | V0 with explicit parts                     |
-| `new_v1_with_random(name, randomBits)`         | `DynamicTnid` | V1 with explicit random bits               |
-
-##### Parsing
-
-| Method                    | Returns       | Throws     | Description           |
-| ------------------------- | ------------- | ---------- | --------------------- |
-| `parse(s)`                | `DynamicTnid` | If invalid | Parse any TNID string |
-| `parse_uuid_string(uuid)` | `DynamicTnid` | If invalid | Parse UUID to TNID    |
-
-##### Inspection
-
-| Method                    | Returns       | Description              |
-| ------------------------- | ------------- | ------------------------ |
-| `getName(id)`             | `string`      | Extract the name portion |
-| `getNameHex(id)`          | `string`      | Get name as 5-char hex   |
-| `getVariant(id)`          | `TnidVariant` | Get the variant          |
-| `toUuidString(id, case?)` | `string`      | Convert to UUID hex      |
-
-#### Example
-
-```typescript
-// Runtime name - useful for dynamic/generic code
-const entityType = "user"; // from config, API, etc.
-const id = DynamicTnid.new_v0(entityType);
-
-// Parse any TNID without knowing its type
-const unknown = DynamicTnid.parse("post.EUBcUw4T9x3KNOll-");
-console.log(DynamicTnid.getName(unknown)); // "post"
-console.log(DynamicTnid.getVariant(unknown)); // "v1"
-
-// Create with specific timestamp
-const backdated = DynamicTnid.new_v0_with_time("log", new Date("2024-01-01"));
-
-// Convert to UUID
-const uuid = DynamicTnid.toUuidString(id);
+// Inspection
+DynamicTnid.getName(id);              // "user"
+DynamicTnid.getNameHex(id);           // "d6157"
+DynamicTnid.getVariant(id);           // "v0" or "v1"
+DynamicTnid.toUuidString(id);         // UUID hex string
 ```
 
----
-
 ### `UuidLike`
 
-For working with UUID hex strings that may or may not be valid TNIDs. This is
-both a **type** and a **namespace**.
-
-#### As a Type
-
-`UuidLike` represents any valid UUID hex string (format:
-`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`):
+For working with UUID hex strings that may or may not be valid TNIDs.
 
 ```typescript
-function storeInDatabase(uuid: UuidLike) { ... }
+UuidLike.fromTnid(id);        // convert TNID to UUID string
+UuidLike.parse(s);            // parse any UUID (validates format only)
+UuidLike.toTnid(uuid);        // convert UUID to TNID (throws if invalid)
+UuidLike.toUpperCase(uuid);   // convert to uppercase
 ```
 
-#### Namespace Methods
-
-| Method              | Returns       | Throws              | Description                         |
-| ------------------- | ------------- | ------------------- | ----------------------------------- |
-| `fromTnid(id)`      | `UuidLike`    | -                   | Convert TNID to UUID string         |
-| `parse(s)`          | `UuidLike`    | If invalid format   | Parse any UUID string (format only) |
-| `toTnid(uuid)`      | `DynamicTnid` | If not a valid TNID | Convert UUID to TNID                |
-| `toUpperCase(uuid)` | `UuidLike`    | -                   | Convert to uppercase                |
-
-#### Example
-
-```typescript
-const UserId = Tnid("user");
-const id = UserId.new_v0();
-
-// TNID to UUID
-const uuid: UuidLike = UuidLike.fromTnid(id);
-// "d6157329-4640-8e30-8012-345678901234"
-
-// Parse any UUID (doesn't validate TNID structure)
-const anyUuid = UuidLike.parse("550e8400-e29b-41d4-a716-446655440000");
-
-// Convert back to TNID (validates it's a valid TNID)
-try {
-  const tnid = UuidLike.toTnid(uuid); // works
-  const fail = UuidLike.toTnid(anyUuid); // throws - not a TNID
-} catch (e) {
-  console.log("Not a valid TNID");
-}
-
-// Case conversion
-const upper = UuidLike.toUpperCase(uuid);
-// "D6157329-4640-8E30-8012-345678901234"
-```
-
----
-
 ## Variants
 
 ### V0 (Time-Ordered)
@@ -349,23 +225,11 @@ const upper = UuidLike.toUpperCase(uuid);
 - 57 bits: random
 - **Use case**: When you need chronological sorting (logs, events, feeds)
 
-```typescript
-const id = UserId.new_v0();
-// IDs created later sort after earlier ones
-```
-
 ### V1 (High-Entropy)
 
 - 100 bits: random
 - **Use case**: When you need maximum uniqueness/unpredictability
 
-```typescript
-const id = UserId.new_v1();
-// Maximum entropy, no time component
-```
-
----
-
 ## Type Safety
 
 Different TNID types are completely incompatible at compile time:
@@ -380,44 +244,31 @@ const userId: UserId = UserId.new_v0();
 const postId: PostId = PostId.new_v0();
 
 // Compile errors - types don't match
-const wrong1: UserId = postId;           // ✗
-const wrong2: PostId = userId;           // ✗
+const wrong1: UserId = postId;           // Error
+const wrong2: PostId = userId;           // Error
 function getUser(id: UserId) { ... }
-getUser(postId);                         // ✗
+getUser(postId);                         // Error
 
 // DynamicTnid accepts any TNID
-const dynamic: DynamicTnid = userId;     // ✓
-const dynamic2: DynamicTnid = postId;    // ✓
+const dynamic: DynamicTnid = userId;     // OK
+const dynamic2: DynamicTnid = postId;    // OK
 ```
 
-### Preventing Forgery
-
 Plain strings cannot be assigned to TNID types:
 
 ```typescript
-const UserId = Tnid("user");
-type UserId = TnidType<typeof UserId>;
-
 // Compile errors - plain strings not allowed
-const fake1: UserId = "user.Br2flcNDfF6LYICnT"; // ✗
-const fake2: UserId = someString; // ✗
+const fake: UserId = "user.Br2flcNDfF6LYICnT"; // Error
 
 // Must use parse() or new_*() to get a valid TNID
-const valid: UserId = UserId.parse("user.Br2flcNDfF6LYICnT"); // ✓
+const valid: UserId = UserId.parse("user.Br2flcNDfF6LYICnT"); // OK
 ```
 
----
-
 ## UUID Compatibility
 
-TNIDs are valid UUIDv8 identifiers. You can:
-
-- Store in UUID database columns
-- Use with UUID-aware tools and libraries
-- Convert freely between TNID and UUID formats
+TNIDs are valid UUIDv8 identifiers:
 
 ```typescript
-const UserId = Tnid("user");
 const id = UserId.new_v0();
 
 // To UUID
@@ -426,94 +277,14 @@ const uuid = UserId.toUuidString(id);
 
 // From UUID
 const back = UserId.parseUuidString(uuid);
-// back === id
 
 // Store in database as UUID
 await db.query("INSERT INTO users (id) VALUES ($1)", [uuid]);
-
-// Retrieve and convert back
-const row = await db.query("SELECT id FROM users WHERE ...");
-const userId = UserId.parseUuidString(row.id);
-```
-
----
-
-## Common Patterns
-
-### Define ID types for your domain
-
-```typescript
-// ids.ts
-import { Tnid, TnidType } from "@tnid/core";
-
-export const UserId = Tnid("user");
-export type UserId = TnidType<typeof UserId>;
-
-export const PostId = Tnid("post");
-export type PostId = TnidType<typeof PostId>;
-
-export const OrgId = Tnid("org");
-export type OrgId = TnidType<typeof OrgId>;
-```
-
-### Use in function signatures
-
-```typescript
-import { PostId, UserId } from "./ids";
-
-interface Post {
-  id: PostId;
-  authorId: UserId;
-  title: string;
-}
-
-function createPost(authorId: UserId, title: string): Post {
-  return {
-    id: PostId.new_v0(),
-    authorId,
-    title,
-  };
-}
-```
-
-### Generic functions with DynamicTnid
-
-```typescript
-import { DynamicTnid } from "@tnid/core";
-
-function logEntity(id: DynamicTnid) {
-  const name = DynamicTnid.getName(id);
-  const variant = DynamicTnid.getVariant(id);
-  console.log(`[${name}:${variant}] ${id}`);
-}
-
-// Works with any TNID
-logEntity(userId); // "[user:v0] user.Br2..."
-logEntity(postId); // "[post:v1] post.EU..."
 ```
 
-### Parsing from external sources
-
-```typescript
-import { UserId } from "./ids";
-
-// From API request
-app.get("/users/:id", (req, res) => {
-  try {
-    const id = UserId.parse(req.params.id);
-    const user = await getUser(id);
-    res.json(user);
-  } catch {
-    res.status(400).json({ error: "Invalid user ID" });
-  }
-});
-
-// From database UUID column
-const row = await db.query("SELECT id FROM users WHERE email = $1", [email]);
-const userId = UserId.parseUuidString(row.id);
-```
+## Related Packages
 
----
+- **@tnid/encryption** - Format-preserving encryption to convert V0 (time-ordered) to V1 (random-looking) IDs
 
 ## License
 

package/esm/dynamic.d.ts

@@ -3,34 +3,36 @@ import type { Case, TnidValue, TnidVariant } from "./types.js";
 export type DynamicTnid = TnidValue<string>;
 declare function getTnidVariantImpl(id: DynamicTnid): TnidVariant;
 declare function toUuidStringImpl(id: DynamicTnid, upperCase?: boolean): string;
-/** Static methods for working with any TNID regardless of name. */
-export declare const DynamicTnid: {
+/** Interface for DynamicTnid static methods. */
+export interface DynamicTnidNamespace {
     /** Generate a new time-sortable TNID (variant 0) with runtime name validation. */
-    readonly new_v0: (name: string) => DynamicTnid;
+    new_v0(name: string): DynamicTnid;
     /** Alias for new_v0. */
-    readonly new_time_ordered: (name: string) => DynamicTnid;
+    new_time_ordered(name: string): DynamicTnid;
     /** Generate a new time-sortable TNID with a specific timestamp. */
-    readonly new_v0_with_time: (name: string, time: Date) => DynamicTnid;
+    new_v0_with_time(name: string, time: Date): DynamicTnid;
     /** Generate a new time-sortable TNID with explicit timestamp and random components. */
-    readonly new_v0_with_parts: (name: string, epochMillis: bigint, random: bigint) => DynamicTnid;
+    new_v0_with_parts(name: string, epochMillis: bigint, random: bigint): DynamicTnid;
     /** Generate a new high-entropy TNID (variant 1) with runtime name validation. */
-    readonly new_v1: (name: string) => DynamicTnid;
+    new_v1(name: string): DynamicTnid;
     /** Alias for new_v1. */
-    readonly new_high_entropy: (name: string) => DynamicTnid;
+    new_high_entropy(name: string): DynamicTnid;
     /** Generate a new high-entropy TNID with explicit random bits. */
-    readonly new_v1_with_random: (name: string, randomBits: bigint) => DynamicTnid;
+    new_v1_with_random(name: string, randomBits: bigint): DynamicTnid;
     /** Parse any valid TNID string. */
-    readonly parse: (s: string) => DynamicTnid;
+    parse(s: string): DynamicTnid;
     /** Parse a UUID hex string into a DynamicTnid (validates TNID structure). */
-    readonly parse_uuid_string: (uuid: string) => DynamicTnid;
+    parse_uuid_string(uuid: string): DynamicTnid;
     /** Get the name from a TNID. */
-    readonly getName: (id: DynamicTnid) => string;
+    getName(id: DynamicTnid): string;
     /** Get the name encoded as a 5-character hex string. */
-    readonly getNameHex: (id: DynamicTnid) => string;
+    getNameHex(id: DynamicTnid): string;
     /** Get the variant of a TNID. */
-    readonly getVariant: (id: DynamicTnid) => TnidVariant;
+    getVariant(id: DynamicTnid): TnidVariant;
     /** Convert to UUID hex string format. */
-    readonly toUuidString: (id: DynamicTnid, caseFormat?: Case) => string;
-};
+    toUuidString(id: DynamicTnid, caseFormat?: Case): string;
+}
+/** Static methods for working with any TNID regardless of name. */
+export declare const DynamicTnid: DynamicTnidNamespace;
 export { getTnidVariantImpl, toUuidStringImpl, };
 //# sourceMappingURL=dynamic.d.ts.map

package/esm/dynamic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic.d.ts","sourceRoot":"","sources":["../src/dynamic.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE/D,gEAAgE;AAChE,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAgB5C,iBAAS,kBAAkB,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CASxD;AAiBD,iBAAS,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,GAAE,OAAe,GAAG,MAAM,CAmB7E;AAmDD,mEAAmE;AACnE,eAAO,MAAM,WAAW;IACtB,kFAAkF;4BACrE,MAAM,KAAG,WAAW;IAYjC,wBAAwB;sCACD,MAAM,KAAG,WAAW;IAI3C,mEAAmE;sCAC5C,MAAM,QAAQ,IAAI,KAAG,WAAW;IAavD,uFAAuF;uCAE/E,MAAM,eACC,MAAM,UACX,MAAM,KACb,WAAW;IAYd,iFAAiF;4BACpE,MAAM,KAAG,WAAW;IAYjC,wBAAwB;sCACD,MAAM,KAAG,WAAW;IAI3C,kEAAkE;wCACzC,MAAM,cAAc,MAAM,KAAG,WAAW;IAYjE,mCAAmC;wBAC1B,MAAM,KAAG,WAAW;IAI7B,6EAA6E;uCACrD,MAAM,KAAG,WAAW;IAI5C,gCAAgC;2BACpB,WAAW,KAAG,MAAM;IAIhC,wDAAwD;8BACzC,WAAW,KAAG,MAAM;IAInC,iCAAiC;8BAClB,WAAW,KAAG,WAAW;IAIxC,yCAAyC;gCACxB,WAAW,eAAc,IAAI,KAAa,MAAM;CAGzD,CAAC;AAGX,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,CAAC"}
+{"version":3,"file":"dynamic.d.ts","sourceRoot":"","sources":["../src/dynamic.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE/D,gEAAgE;AAChE,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAgB5C,iBAAS,kBAAkB,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CASxD;AAiBD,iBAAS,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,GAAE,OAAe,GAAG,MAAM,CAmB7E;AAmDD,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAClC,wBAAwB;IACxB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5C,mEAAmE;IACnE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,WAAW,CAAC;IACxD,uFAAuF;IACvF,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAClF,iFAAiF;IACjF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAClC,wBAAwB;IACxB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5C,kEAAkE;IAClE,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC;IAClE,mCAAmC;IACnC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9B,6EAA6E;IAC7E,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7C,gCAAgC;IAChC,OAAO,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAAC;IACjC,wDAAwD;IACxD,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAAC;IACpC,iCAAiC;IACjC,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CAAC;IACzC,yCAAyC;IACzC,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1D;AAED,mEAAmE;AACnE,eAAO,MAAM,WAAW,EAAE,oBA8GzB,CAAC;AAGF,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,CAAC"}

package/esm/dynamic.js

@@ -80,9 +80,6 @@ function parseDynamicUuidStringImpl(uuid) {
     }
     return valueToTnidString(value);
 }
-// -----------------------------------------------------------------------------
-// DynamicTnid Namespace
-// -----------------------------------------------------------------------------
 /** Static methods for working with any TNID regardless of name. */
 export const DynamicTnid = {
     /** Generate a new time-sortable TNID (variant 0) with runtime name validation. */

package/esm/uuidlike.d.ts

@@ -3,15 +3,17 @@ import type { DynamicTnid } from "./dynamic.js";
 export type UuidLike = string & {
     __uuidlike: true;
 };
-/** Wrapper for UUID hex strings that may or may not be valid TNIDs. */
-export declare const UuidLike: {
+/** Interface for UuidLike static methods. */
+export interface UuidLikeNamespace {
     /** Create from a TNID (always valid). */
-    readonly fromTnid: (id: DynamicTnid) => UuidLike;
+    fromTnid(id: DynamicTnid): UuidLike;
     /** Parse UUID hex string (format validation only, not TNID validation). */
-    readonly parse: (s: string) => UuidLike;
+    parse(s: string): UuidLike;
     /** Try to convert to DynamicTnid (validates TNID structure). */
-    readonly toTnid: (uuid: UuidLike) => DynamicTnid;
+    toTnid(uuid: UuidLike): DynamicTnid;
     /** Format as uppercase UUID hex string. */
-    readonly toUpperCase: (uuid: UuidLike) => UuidLike;
-};
+    toUpperCase(uuid: UuidLike): UuidLike;
+}
+/** Wrapper for UUID hex strings that may or may not be valid TNIDs. */
+export declare const UuidLike: UuidLikeNamespace;
 //# sourceMappingURL=uuidlike.d.ts.map

package/esm/uuidlike.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uuidlike.d.ts","sourceRoot":"","sources":["../src/uuidlike.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,oGAAoG;AACpG,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,UAAU,EAAE,IAAI,CAAA;CAAE,CAAC;AAWrD,uEAAuE;AACvE,eAAO,MAAM,QAAQ;IACnB,yCAAyC;4BAC5B,WAAW,KAAG,QAAQ;IAInC,2EAA2E;wBAClE,MAAM,KAAG,QAAQ;IAQ1B,gEAAgE;4BACnD,QAAQ,KAAG,WAAW;IAanC,2CAA2C;iCACzB,QAAQ,KAAG,QAAQ;CAG7B,CAAC"}
+{"version":3,"file":"uuidlike.d.ts","sourceRoot":"","sources":["../src/uuidlike.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,oGAAoG;AACpG,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,UAAU,EAAE,IAAI,CAAA;CAAE,CAAC;AAWrD,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,EAAE,WAAW,GAAG,QAAQ,CAAC;IACpC,2EAA2E;IAC3E,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,gEAAgE;IAChE,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;IACpC,2CAA2C;IAC3C,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACvC;AAED,uEAAuE;AACvE,eAAO,MAAM,QAAQ,EAAE,iBAiCtB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tnid/core",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Type-safe, named, unique identifiers (TNIDs) - UUID-compatible IDs with embedded type names",
   "keywords": [
     "uuid",
@@ -24,6 +24,10 @@
     ".": {
       "import": "./esm/index.js",
       "require": "./script/index.js"
+    },
+    "./uuid": {
+      "import": "./esm/uuid.js",
+      "require": "./script/uuid.js"
     }
   },
   "scripts": {},
@@ -33,5 +37,6 @@
   "engines": {
     "node": ">=20"
   },
+  "dependencies": {},
   "_generatedBy": "dnt@dev"
 }

package/script/dynamic.d.ts

@@ -3,34 +3,36 @@ import type { Case, TnidValue, TnidVariant } from "./types.js";
 export type DynamicTnid = TnidValue<string>;
 declare function getTnidVariantImpl(id: DynamicTnid): TnidVariant;
 declare function toUuidStringImpl(id: DynamicTnid, upperCase?: boolean): string;
-/** Static methods for working with any TNID regardless of name. */
-export declare const DynamicTnid: {
+/** Interface for DynamicTnid static methods. */
+export interface DynamicTnidNamespace {
     /** Generate a new time-sortable TNID (variant 0) with runtime name validation. */
-    readonly new_v0: (name: string) => DynamicTnid;
+    new_v0(name: string): DynamicTnid;
     /** Alias for new_v0. */
-    readonly new_time_ordered: (name: string) => DynamicTnid;
+    new_time_ordered(name: string): DynamicTnid;
     /** Generate a new time-sortable TNID with a specific timestamp. */
-    readonly new_v0_with_time: (name: string, time: Date) => DynamicTnid;
+    new_v0_with_time(name: string, time: Date): DynamicTnid;
     /** Generate a new time-sortable TNID with explicit timestamp and random components. */
-    readonly new_v0_with_parts: (name: string, epochMillis: bigint, random: bigint) => DynamicTnid;
+    new_v0_with_parts(name: string, epochMillis: bigint, random: bigint): DynamicTnid;
     /** Generate a new high-entropy TNID (variant 1) with runtime name validation. */
-    readonly new_v1: (name: string) => DynamicTnid;
+    new_v1(name: string): DynamicTnid;
     /** Alias for new_v1. */
-    readonly new_high_entropy: (name: string) => DynamicTnid;
+    new_high_entropy(name: string): DynamicTnid;
     /** Generate a new high-entropy TNID with explicit random bits. */
-    readonly new_v1_with_random: (name: string, randomBits: bigint) => DynamicTnid;
+    new_v1_with_random(name: string, randomBits: bigint): DynamicTnid;
     /** Parse any valid TNID string. */
-    readonly parse: (s: string) => DynamicTnid;
+    parse(s: string): DynamicTnid;
     /** Parse a UUID hex string into a DynamicTnid (validates TNID structure). */
-    readonly parse_uuid_string: (uuid: string) => DynamicTnid;
+    parse_uuid_string(uuid: string): DynamicTnid;
     /** Get the name from a TNID. */
-    readonly getName: (id: DynamicTnid) => string;
+    getName(id: DynamicTnid): string;
     /** Get the name encoded as a 5-character hex string. */
-    readonly getNameHex: (id: DynamicTnid) => string;
+    getNameHex(id: DynamicTnid): string;
     /** Get the variant of a TNID. */
-    readonly getVariant: (id: DynamicTnid) => TnidVariant;
+    getVariant(id: DynamicTnid): TnidVariant;
     /** Convert to UUID hex string format. */
-    readonly toUuidString: (id: DynamicTnid, caseFormat?: Case) => string;
-};
+    toUuidString(id: DynamicTnid, caseFormat?: Case): string;
+}
+/** Static methods for working with any TNID regardless of name. */
+export declare const DynamicTnid: DynamicTnidNamespace;
 export { getTnidVariantImpl, toUuidStringImpl, };
 //# sourceMappingURL=dynamic.d.ts.map

package/script/dynamic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic.d.ts","sourceRoot":"","sources":["../src/dynamic.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE/D,gEAAgE;AAChE,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAgB5C,iBAAS,kBAAkB,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CASxD;AAiBD,iBAAS,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,GAAE,OAAe,GAAG,MAAM,CAmB7E;AAmDD,mEAAmE;AACnE,eAAO,MAAM,WAAW;IACtB,kFAAkF;4BACrE,MAAM,KAAG,WAAW;IAYjC,wBAAwB;sCACD,MAAM,KAAG,WAAW;IAI3C,mEAAmE;sCAC5C,MAAM,QAAQ,IAAI,KAAG,WAAW;IAavD,uFAAuF;uCAE/E,MAAM,eACC,MAAM,UACX,MAAM,KACb,WAAW;IAYd,iFAAiF;4BACpE,MAAM,KAAG,WAAW;IAYjC,wBAAwB;sCACD,MAAM,KAAG,WAAW;IAI3C,kEAAkE;wCACzC,MAAM,cAAc,MAAM,KAAG,WAAW;IAYjE,mCAAmC;wBAC1B,MAAM,KAAG,WAAW;IAI7B,6EAA6E;uCACrD,MAAM,KAAG,WAAW;IAI5C,gCAAgC;2BACpB,WAAW,KAAG,MAAM;IAIhC,wDAAwD;8BACzC,WAAW,KAAG,MAAM;IAInC,iCAAiC;8BAClB,WAAW,KAAG,WAAW;IAIxC,yCAAyC;gCACxB,WAAW,eAAc,IAAI,KAAa,MAAM;CAGzD,CAAC;AAGX,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,CAAC"}
+{"version":3,"file":"dynamic.d.ts","sourceRoot":"","sources":["../src/dynamic.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE/D,gEAAgE;AAChE,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAgB5C,iBAAS,kBAAkB,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CASxD;AAiBD,iBAAS,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,GAAE,OAAe,GAAG,MAAM,CAmB7E;AAmDD,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAClC,wBAAwB;IACxB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5C,mEAAmE;IACnE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,WAAW,CAAC;IACxD,uFAAuF;IACvF,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAClF,iFAAiF;IACjF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAClC,wBAAwB;IACxB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5C,kEAAkE;IAClE,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC;IAClE,mCAAmC;IACnC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9B,6EAA6E;IAC7E,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7C,gCAAgC;IAChC,OAAO,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAAC;IACjC,wDAAwD;IACxD,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAAC;IACpC,iCAAiC;IACjC,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CAAC;IACzC,yCAAyC;IACzC,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1D;AAED,mEAAmE;AACnE,eAAO,MAAM,WAAW,EAAE,oBA8GzB,CAAC;AAGF,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,CAAC"}

package/script/dynamic.js

@@ -85,9 +85,6 @@ function parseDynamicUuidStringImpl(uuid) {
     }
     return (0, uuid_js_1.valueToTnidString)(value);
 }
-// -----------------------------------------------------------------------------
-// DynamicTnid Namespace
-// -----------------------------------------------------------------------------
 /** Static methods for working with any TNID regardless of name. */
 exports.DynamicTnid = {
     /** Generate a new time-sortable TNID (variant 0) with runtime name validation. */

package/script/uuidlike.d.ts

@@ -3,15 +3,17 @@ import type { DynamicTnid } from "./dynamic.js";
 export type UuidLike = string & {
     __uuidlike: true;
 };
-/** Wrapper for UUID hex strings that may or may not be valid TNIDs. */
-export declare const UuidLike: {
+/** Interface for UuidLike static methods. */
+export interface UuidLikeNamespace {
     /** Create from a TNID (always valid). */
-    readonly fromTnid: (id: DynamicTnid) => UuidLike;
+    fromTnid(id: DynamicTnid): UuidLike;
     /** Parse UUID hex string (format validation only, not TNID validation). */
-    readonly parse: (s: string) => UuidLike;
+    parse(s: string): UuidLike;
     /** Try to convert to DynamicTnid (validates TNID structure). */
-    readonly toTnid: (uuid: UuidLike) => DynamicTnid;
+    toTnid(uuid: UuidLike): DynamicTnid;
     /** Format as uppercase UUID hex string. */
-    readonly toUpperCase: (uuid: UuidLike) => UuidLike;
-};
+    toUpperCase(uuid: UuidLike): UuidLike;
+}
+/** Wrapper for UUID hex strings that may or may not be valid TNIDs. */
+export declare const UuidLike: UuidLikeNamespace;
 //# sourceMappingURL=uuidlike.d.ts.map

package/script/uuidlike.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uuidlike.d.ts","sourceRoot":"","sources":["../src/uuidlike.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,oGAAoG;AACpG,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,UAAU,EAAE,IAAI,CAAA;CAAE,CAAC;AAWrD,uEAAuE;AACvE,eAAO,MAAM,QAAQ;IACnB,yCAAyC;4BAC5B,WAAW,KAAG,QAAQ;IAInC,2EAA2E;wBAClE,MAAM,KAAG,QAAQ;IAQ1B,gEAAgE;4BACnD,QAAQ,KAAG,WAAW;IAanC,2CAA2C;iCACzB,QAAQ,KAAG,QAAQ;CAG7B,CAAC"}
+{"version":3,"file":"uuidlike.d.ts","sourceRoot":"","sources":["../src/uuidlike.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,oGAAoG;AACpG,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,UAAU,EAAE,IAAI,CAAA;CAAE,CAAC;AAWrD,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,EAAE,WAAW,GAAG,QAAQ,CAAC;IACpC,2EAA2E;IAC3E,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,gEAAgE;IAChE,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;IACpC,2CAA2C;IAC3C,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACvC;AAED,uEAAuE;AACvE,eAAO,MAAM,QAAQ,EAAE,iBAiCtB,CAAC"}