@owlmeans/basic-ids 0.1.18-rc.36 → 0.1.18-rc.37

package/README.md

@@ -11,13 +11,13 @@ Utilities for generating cryptographically secure random IDs and UUIDs.
 ## Installation
 
 ```bash
-bun add @owlmeans/basic-ids@^0.1.18-rc.36
+bun add @owlmeans/basic-ids@^0.1.18-rc.37
 ```
 
 ## Usage
 
 ```typescript
-import { createIdOfLength, createRandomPrefix, uuid } from '@owlmeans/basic-ids'
+import { createIdOfLength, createRandomPrefix, idHelper } from '@owlmeans/basic-ids'
 
 // Generate a 12-character Base58 ID (default encoding)
 const runId = createIdOfLength(12)
@@ -26,7 +26,7 @@ const runId = createIdOfLength(12)
 const prefix = createRandomPrefix(6)
 
 // Standard UUID v4
-const id = uuid()
+const id = idHelper.uuid()
 ```
 
 With explicit encoding:
@@ -47,7 +47,7 @@ Returns a random ID of exactly `length` characters (default: 6) in `format` enco
 
 Returns a random string encoded from `length` random bytes (default: 6 bytes).
 
-### `uuid(): string`
+### `idHelper.uuid(): string`
 
 Returns a UUID v4 string.
 
@@ -65,7 +65,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.48
+npx @owlmeans/agent-skills@^0.1.18-rc.49
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/basic-ids",
-  "version": "0.1.18-rc.36",
-  "generatedAt": "2026-10-05T08:32:19.130Z",
+  "version": "0.1.18-rc.37",
+  "generatedAt": "2026-10-05T21:03:06.408Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/basic-ids/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: basic-ids
-description: How to use @owlmeans/basic-ids — createIdOfLength and createRandomPrefix for random identifiers, uuid for v4 UUIDs, and generateWordSlug / nextSlugCandidate for human-readable two-word slugs. Auto-invoked when importing ID generation utilities or naming a new record, nonce or organization slug.
+description: How to use @owlmeans/basic-ids — createIdOfLength and createRandomPrefix for random identifiers, idHelper.uuid for v4 UUIDs, and idHelper.generateWordSlug / idHelper.nextSlugCandidate for human-readable two-word slugs. Auto-invoked when importing ID generation utilities or naming a new record, nonce or organization slug.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/basic-ids
 
 **Layer:** Core
-**Install:** `"@owlmeans/basic-ids": "^0.1.18-rc.36"` in `dependencies`
+**Install:** `"@owlmeans/basic-ids": "^0.1.18-rc.37"` in `dependencies`
 
 ## Key Exports
 
@@ -16,9 +16,9 @@ user-invocable: false
 |--------|-------------|
 | `createIdOfLength(length?, style?)` | A random id of exactly `length` characters (default 6) |
 | `createRandomPrefix(bytes?, style?)` | Encode `bytes` random bytes (default 6); length varies with the encoding |
-| `uuid()` | A v4 UUID string |
-| `generateWordSlug()` | A readable two-word slug — `civil-format`, `raised-earth` |
-| `nextSlugCandidate(base, attempt)` | The n-th candidate for an occupied slug — `brisk-otter`, `brisk-otter-2` |
+| `idHelper.uuid()` | A v4 UUID string |
+| `idHelper.generateWordSlug()` | A readable two-word slug — `civil-format`, `raised-earth` |
+| `idHelper.nextSlugCandidate(base, attempt)` | The n-th candidate for an occupied slug — `brisk-otter`, `brisk-otter-2` |
 | `IdStyle` | `Base58` (default) and `Base64` (url-safe, unpadded) |
 | `WORD_SLUG_SEPARATOR` (`'-'`), `WORDLIST_SIZE` (2048) | Slug shape and thesaurus size |
 | `WORDLIST_A` / `WORDLIST_B` | The descriptive and subject halves the slug is drawn from |
@@ -26,11 +26,11 @@ user-invocable: false
 ## Random identifiers
 
 ```typescript
-import { createIdOfLength, IdStyle, uuid } from '@owlmeans/basic-ids'
+import { createIdOfLength, IdStyle, idHelper } from '@owlmeans/basic-ids'
 
 const id = createIdOfLength(16)                    // 16 Base58 chars
 const nonce = createIdOfLength(32, IdStyle.Base64) // 32 url-safe Base64 chars
-const recordId = uuid()
+const recordId = idHelper.uuid()
 ```
 
 `createIdOfLength` asks for twice the bytes and truncates, so the result is exactly the requested
@@ -40,21 +40,23 @@ however many characters that produced.
 
 ## Readable slugs
 
-`generateWordSlug` picks one descriptive word and one subject word out of 2048 each, joined by a
-hyphen. The result is a valid DNS label and a valid Kubernetes object-name segment, so the same
-value can address a host, a namespace and an OIDC client without a second sanitising pass — which
-is why an organization entity's `entitySlug` is generated this way rather than as a random string.
+`idHelper.generateWordSlug` picks one descriptive word and one subject word out of 2048 each,
+joined by a hyphen. The result is a valid DNS label and a valid Kubernetes object-name segment, so
+the same value can address a host, a namespace and an OIDC client without a second sanitising
+pass — which is why an organization entity's `entitySlug` is generated this way rather than as a
+random string.
 
 Two words carry 22 bits of entropy. That is **not** enough to be unguessable, and deliberately so:
 uniqueness is settled by a unique index or a registry claim, never by entropy. Walk
-`nextSlugCandidate` until the store accepts one, and never use a slug where a secret is needed.
+`idHelper.nextSlugCandidate` until the store accepts one, and never use a slug where a secret is
+needed.
 
 ```typescript
-import { generateWordSlug, nextSlugCandidate } from '@owlmeans/basic-ids'
+import { idHelper } from '@owlmeans/basic-ids'
 
-const base = generateWordSlug()
+const base = idHelper.generateWordSlug()
 for (let attempt = 1; attempt <= 10; ++attempt) {
-  const candidate = nextSlugCandidate(base, attempt)   // attempt 1 is the bare name
+  const candidate = idHelper.nextSlugCandidate(base, attempt)   // attempt 1 is the bare name
   if (await claim(candidate)) return candidate
 }
 ```

package/build/helper/types.d.ts

@@ -0,0 +1,25 @@
+/** Identifiers read by people and machines: UUIDs and human-readable word slugs. */
+export interface IdHelper {
+    /** A UUID v4. */
+    uuid: () => string;
+    /**
+     * A human-readable slug: one descriptive word, one subject word — `civil-format`, `raised-earth`.
+     *
+     * This exists because the values it replaces are read by people. An organization slug turns up in
+     * hostnames, OIDC client ids and support conversations, and a 16-character Base58 string is
+     * unquotable over the phone and unrecognisable in a list. Two words out of 2048 each give 22 bits
+     * of entropy — far short of a secret, and deliberately so: uniqueness here is settled by a unique
+     * index and `nextSlugCandidate`, not by entropy. Never use this for anything that must be
+     * unguessable (nonces, secrets, tokens) — `createIdOfLength` is that function.
+     */
+    generateWordSlug: () => string;
+    /**
+     * The n-th candidate for an occupied slug: `brisk-otter`, `brisk-otter-2`, `brisk-otter-3`.
+     *
+     * The first attempt is the bare name — a suffix appears only once something already answers to it,
+     * so the common case keeps the name it was given. Callers own the availability test (a unique
+     * index, a registry claim) and walk this until one is free.
+     */
+    nextSlugCandidate: (base: string, attempt: number) => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/helper/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/helper/types.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,WAAW,QAAQ;IACvB,iBAAiB;IACjB,IAAI,EAAE,MAAM,MAAM,CAAA;IAClB;;;;;;;;;OASG;IACH,gBAAgB,EAAE,MAAM,MAAM,CAAA;IAC9B;;;;;;OAMG;IACH,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAA;CAC7D"}

package/build/helper/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/helper/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/helper/types.ts"],"names":[],"mappings":""}

package/build/helper.d.ts

@@ -1,24 +1,10 @@
-import { IdStyle } from './consts.js';
-export declare const createRandomPrefix: (length?: number, format?: IdStyle) => string;
-export declare const createIdOfLength: (length?: number, format?: IdStyle) => string;
+import type { IdHelper } from './helper/types.js';
+export declare const createIdHelper: () => IdHelper;
+export declare const idHelper: IdHelper;
+/** @deprecated compat:factory-refactor — use `idHelper.uuid()` */
 export declare const uuid: () => string;
-/**
- * A human-readable slug: one descriptive word, one subject word — `civil-format`, `raised-earth`.
- *
- * This exists because the values it replaces are read by people. An organization slug turns up in
- * hostnames, OIDC client ids and support conversations, and a 16-character Base58 string is
- * unquotable over the phone and unrecognisable in a list. Two words out of 2048 each give 22 bits
- * of entropy — far short of a secret, and deliberately so: uniqueness here is settled by a unique
- * index and `nextSlugCandidate`, not by entropy. Never use this for anything that must be
- * unguessable (nonces, secrets, tokens) — `createIdOfLength` is that function.
- */
+/** @deprecated compat:factory-refactor — use `idHelper.generateWordSlug()` */
 export declare const generateWordSlug: () => string;
-/**
- * The n-th candidate for an occupied slug: `brisk-otter`, `brisk-otter-2`, `brisk-otter-3`.
- *
- * The first attempt is the bare name — a suffix appears only once something already answers to it,
- * so the common case keeps the name it was given. Callers own the availability test (a unique
- * index, a registry claim) and walk this until one is free.
- */
+/** @deprecated compat:factory-refactor — use `idHelper.nextSlugCandidate(…)` */
 export declare const nextSlugCandidate: (base: string, attempt: number) => string;
 //# sourceMappingURL=helper.d.ts.map

package/build/helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAsC,MAAM,aAAa,CAAA;AAKzE,eAAO,MAAM,kBAAkB,YAAY,MAAM,WAAc,OAAO,KAAoB,MASzF,CAAA;AAED,eAAO,MAAM,gBAAgB,YAAY,MAAM,WAAc,OAAO,KAAoB,MAEvF,CAAA;AAED,eAAO,MAAM,IAAI,QAAO,MAAc,CAAA;AAEtC;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,QAAO,MAInC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,SAAU,MAAM,WAAW,MAAM,KAAG,MACF,CAAA"}
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEjD,eAAO,MAAM,cAAc,QAAO,QA2BjC,CAAA;AAED,eAAO,MAAM,QAAQ,UAAmB,CAAA;AAExC,kEAAkE;AAClE,eAAO,MAAM,IAAI,QAAO,MAAyB,CAAA;AAEjD,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,QAAO,MAAqC,CAAA;AAEzE,gFAAgF;AAChF,eAAO,MAAM,iBAAiB,SAAU,MAAM,WAAW,MAAM,KAAG,MAAmD,CAAA"}

package/build/helper.js

@@ -1,55 +1,33 @@
 import { randomBytes } from '@noble/hashes/utils.js';
-import { base58, base64urlnopad } from '@scure/base';
-import { IdStyle, WORDLIST_SIZE, WORD_SLUG_SEPARATOR } from './consts.js';
-import { WORDLIST_A } from './wordlists/list-a.js';
-import { WORDLIST_B } from './wordlists/list-b.js';
+import { WORDLIST_SIZE, WORD_SLUG_SEPARATOR } from './consts.js';
+import { WORDLIST_A, WORDLIST_B } from './wordlists/consts.js';
 import { v4 } from 'uuid';
-export const createRandomPrefix = (length = 6, format = IdStyle.Base58) => {
-    const rand = randomBytes(length);
-    switch (format) {
-        case IdStyle.Base64:
-            return base64urlnopad.encode(rand);
-        case IdStyle.Base58:
-        default:
-            return base58.encode(rand);
-    }
-};
-export const createIdOfLength = (length = 6, format = IdStyle.Base58) => {
-    return createRandomPrefix(length * 2, format).slice(0, length);
-};
-export const uuid = () => v4();
-/**
- * A human-readable slug: one descriptive word, one subject word — `civil-format`, `raised-earth`.
- *
- * This exists because the values it replaces are read by people. An organization slug turns up in
- * hostnames, OIDC client ids and support conversations, and a 16-character Base58 string is
- * unquotable over the phone and unrecognisable in a list. Two words out of 2048 each give 22 bits
- * of entropy — far short of a secret, and deliberately so: uniqueness here is settled by a unique
- * index and `nextSlugCandidate`, not by entropy. Never use this for anything that must be
- * unguessable (nonces, secrets, tokens) — `createIdOfLength` is that function.
- */
-export const generateWordSlug = () => {
-    const [a, b] = pickWords(2);
-    return `${WORDLIST_A[a]}${WORD_SLUG_SEPARATOR}${WORDLIST_B[b]}`;
-};
-/**
- * The n-th candidate for an occupied slug: `brisk-otter`, `brisk-otter-2`, `brisk-otter-3`.
- *
- * The first attempt is the bare name — a suffix appears only once something already answers to it,
- * so the common case keeps the name it was given. Callers own the availability test (a unique
- * index, a registry claim) and walk this until one is free.
- */
-export const nextSlugCandidate = (base, attempt) => attempt < 2 ? base : `${base}${WORD_SLUG_SEPARATOR}${attempt}`;
-/**
- * Uniform indices into a 2048-entry list. 2048 is a power of two, so masking 16 random bits down
- * to 11 is unbiased — no rejection loop, and no modulo skew toward the front of the list.
- */
-const pickWords = (count) => {
-    const bytes = randomBytes(count * 2);
-    const indices = [];
-    for (let i = 0; i < count; ++i) {
-        indices.push(((bytes[i * 2] << 8) | bytes[i * 2 + 1]) & (WORDLIST_SIZE - 1));
-    }
-    return indices;
+export const createIdHelper = () => {
+    /**
+     * Uniform indices into a 2048-entry list. 2048 is a power of two, so masking 16 random bits down
+     * to 11 is unbiased — no rejection loop, and no modulo skew toward the front of the list.
+     */
+    const pickWords = (count) => {
+        const bytes = randomBytes(count * 2);
+        const indices = [];
+        for (let i = 0; i < count; ++i) {
+            indices.push(((bytes[i * 2] << 8) | bytes[i * 2 + 1]) & (WORDLIST_SIZE - 1));
+        }
+        return indices;
+    };
+    const uuid = () => v4();
+    const generateWordSlug = () => {
+        const [a, b] = pickWords(2);
+        return `${WORDLIST_A[a]}${WORD_SLUG_SEPARATOR}${WORDLIST_B[b]}`;
+    };
+    const nextSlugCandidate = (base, attempt) => attempt < 2 ? base : `${base}${WORD_SLUG_SEPARATOR}${attempt}`;
+    return { uuid, generateWordSlug, nextSlugCandidate };
 };
+export const idHelper = createIdHelper();
+/** @deprecated compat:factory-refactor — use `idHelper.uuid()` */
+export const uuid = () => idHelper.uuid();
+/** @deprecated compat:factory-refactor — use `idHelper.generateWordSlug()` */
+export const generateWordSlug = () => idHelper.generateWordSlug();
+/** @deprecated compat:factory-refactor — use `idHelper.nextSlugCandidate(…)` */
+export const nextSlugCandidate = (base, attempt) => idHelper.nextSlugCandidate(base, attempt);
 //# sourceMappingURL=helper.js.map

package/build/helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAA;AAEzB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,GAAW,CAAC,EAAE,MAAM,GAAY,OAAO,CAAC,MAAM,EAAU,EAAE;IACjG,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAChC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO,CAAC,MAAM;YACjB,OAAO,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACpC,KAAK,OAAO,CAAC,MAAM,CAAC;QACpB;YACE,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,GAAW,CAAC,EAAE,MAAM,GAAY,OAAO,CAAC,MAAM,EAAU,EAAE;IAC/F,OAAO,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;AAChE,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,GAAW,EAAE,CAAC,EAAE,EAAE,CAAA;AAEtC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAW,EAAE;IAC3C,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;IAE3B,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,mBAAmB,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,CAAA;AACjE,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAE,OAAe,EAAU,EAAE,CACzE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,mBAAmB,GAAG,OAAO,EAAE,CAAA;AAEhE;;;GAGG;AACH,MAAM,SAAS,GAAG,CAAC,KAAa,EAAY,EAAE;IAC5C,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;IACpC,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAA;IAC9E,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAA;AAGzB,MAAM,CAAC,MAAM,cAAc,GAAG,GAAa,EAAE;IAC3C;;;OAGG;IACH,MAAM,SAAS,GAAG,CAAC,KAAa,EAAY,EAAE;QAC5C,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;QACpC,MAAM,OAAO,GAAa,EAAE,CAAA;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAA;QAC9E,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;IAED,MAAM,IAAI,GAAG,GAAW,EAAE,CAAC,EAAE,EAAE,CAAA;IAE/B,MAAM,gBAAgB,GAAG,GAAW,EAAE;QACpC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;QAE3B,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,mBAAmB,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,CAAA;IACjE,CAAC,CAAA;IAED,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAE,OAAe,EAAU,EAAE,CAClE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,mBAAmB,GAAG,OAAO,EAAE,CAAA;IAEhE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAA;AACtD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;AAExC,kEAAkE;AAClE,MAAM,CAAC,MAAM,IAAI,GAAG,GAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;AAEjD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAW,EAAE,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAA;AAEzE,gFAAgF;AAChF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAE,OAAe,EAAU,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA"}

package/build/index.d.ts

@@ -1,5 +1,6 @@
+export type * from './helper/types.js';
 export * from './helper.js';
+export * from './random.js';
 export * from './consts.js';
-export * from './wordlists/list-a.js';
-export * from './wordlists/list-b.js';
+export * from './wordlists/consts.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,mBAAmB,mBAAmB,CAAA;AACtC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,uBAAuB,CAAA"}

package/build/index.js

@@ -1,5 +1,5 @@
 export * from './helper.js';
+export * from './random.js';
 export * from './consts.js';
-export * from './wordlists/list-a.js';
-export * from './wordlists/list-b.js';
+export * from './wordlists/consts.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,uBAAuB,CAAA"}

package/build/random.d.ts

@@ -0,0 +1,4 @@
+import { IdStyle } from './consts.js';
+export declare const createRandomPrefix: (length?: number, format?: IdStyle) => string;
+export declare const createIdOfLength: (length?: number, format?: IdStyle) => string;
+//# sourceMappingURL=random.d.ts.map

package/build/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../src/random.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC,eAAO,MAAM,kBAAkB,YAAY,MAAM,WAAc,OAAO,KAAoB,MASzF,CAAA;AAED,eAAO,MAAM,gBAAgB,YAAY,MAAM,WAAc,OAAO,KAAoB,MAEvF,CAAA"}

package/build/random.js

@@ -0,0 +1,17 @@
+import { randomBytes } from '@noble/hashes/utils.js';
+import { base58, base64urlnopad } from '@scure/base';
+import { IdStyle } from './consts.js';
+export const createRandomPrefix = (length = 6, format = IdStyle.Base58) => {
+    const rand = randomBytes(length);
+    switch (format) {
+        case IdStyle.Base64:
+            return base64urlnopad.encode(rand);
+        case IdStyle.Base58:
+        default:
+            return base58.encode(rand);
+    }
+};
+export const createIdOfLength = (length = 6, format = IdStyle.Base58) => {
+    return createRandomPrefix(length * 2, format).slice(0, length);
+};
+//# sourceMappingURL=random.js.map

package/build/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../src/random.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,GAAW,CAAC,EAAE,MAAM,GAAY,OAAO,CAAC,MAAM,EAAU,EAAE;IACjG,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAChC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO,CAAC,MAAM;YACjB,OAAO,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACpC,KAAK,OAAO,CAAC,MAAM,CAAC;QACpB;YACE,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,GAAW,CAAC,EAAE,MAAM,GAAY,OAAO,CAAC,MAAM,EAAU,EAAE;IAC/F,OAAO,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;AAChE,CAAC,CAAA"}

package/build/wordlists/consts.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Descriptive half of a word slug — adjectives and adverbs.
+ *
+ * Exactly 2048 words (11 bits of entropy per pick), each lowercase ASCII, 3-8 characters, and
+ * unique within this list. The two lists share no word, so the halves of a slug can never repeat.
+ *
+ * Curated by `scripts/curate-wordlists.ts` from the Moby part-of-speech list, screened against
+ * profanity, stopword, negative-sentiment and proper-noun sources. Regenerate with that script
+ * rather than editing by hand: `tests/word-slug.spec.ts` enforces the invariants above, and a
+ * hand-edit that breaks the 2048 count silently biases slug generation.
+ */
+export declare const WORDLIST_A: string[];
+/**
+ * Subject half of a word slug — verbs and nouns.
+ *
+ * Exactly 2048 words (11 bits of entropy per pick), each lowercase ASCII, 3-8 characters, and
+ * unique within this list. The two lists share no word, so the halves of a slug can never repeat.
+ *
+ * Curated by `scripts/curate-wordlists.ts` from the Moby part-of-speech list, screened against
+ * profanity, stopword, negative-sentiment and proper-noun sources. Regenerate with that script
+ * rather than editing by hand: `tests/word-slug.spec.ts` enforces the invariants above, and a
+ * hand-edit that breaks the 2048 count silently biases slug generation.
+ */
+export declare const WORDLIST_B: string[];
+//# sourceMappingURL=consts.d.ts.map

package/build/wordlists/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/wordlists/consts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,EAiQ9B,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,EAiQ9B,CAAA"}