The Complete Production SOP: How to Deploy and Run Nano ID Secure URL-Friendly Unique String IDs in Autonomous AI Agents

---
name: "nanoid-url-friendly-unique-id"
description: "Generate tiny, secure, URL-friendly unique string identifiers 2x faster than UUID v4."
metadata:
  author: "Andrey Sitnik"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "generate nanoid"
  - "custom alphabet nanoid"
  - "nanoid vs uuid"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: true
  net_access: false
---

# Nano ID Secure URL-Friendly Unique String IDs

Implements Nano ID: generating 21-character collision-resistant IDs, custom alphabets (customAlphabet), non-secure mode for high-throughput non-cryptographic scenarios, and replacing bloated UUIDs in database primary keys.

## When to Invoke
Invoke this skill whenever you need to:
- generate nanoid
- custom alphabet nanoid
- nanoid vs uuid

## Execution SOP & Rules
1. Install package: pnpm add nanoid.
2. Generate default ID: import { nanoid } from 'nanoid'; const id = nanoid(); // 'V1StGXR8_Z5jdHi6B-myT'.
3. Create custom alphabet generator: const generateCode = customAlphabet('0123456789ABCDEF', 8).
4. Verify cryptographic security: Nano ID uses crypto.getRandomValues() to prevent predictable generation.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.

import { customAlphabet, nanoid } from 'nanoid';

// Default 21-character cryptographic ID (A-Za-z0-9_-)
export const generatePublicId = (): string => nanoid();

// 12-character URL-safe alphanumeric code without ambiguous characters
const urlSafeAlphabet = '0123456789abcdefghijklmnopqrstuvwxyz';
export const generateSlugId = customAlphabet(urlSafeAlphabet, 12);

// 6-digit numeric OTP generator
const numericAlphabet = '0123456789';
export const generateOtpCode = customAlphabet(numericAlphabet, 6);

import { describe, it, expect } from 'vitest';
import { generatePublicId, generateSlugId, generateOtpCode } from '../src/utils/id-generator';

describe('Nano ID Generator Suite', () => {
  it('should generate valid default 21-char Nano IDs', () => {
    const id = generatePublicId();
    expect(id).toHaveLength(21);
    expect(id).toMatch(/^[A-Za-z0-9_-]{21}$/);
  });

  it('should generate unique 12-char slug IDs with no collisions in 10k set', () => {
    const set = new Set<string>();
    for (let i = 0; i < 10000; i++) {
      const slug = generateSlugId();
      expect(slug).toHaveLength(12);
      expect(slug).toMatch(/^[0-9a-z]{12}$/);
      set.add(slug);
    }
    expect(set.size).toBe(10000);
  });

  it('should produce numeric OTP codes matching length 6', () => {
    const otp = generateOtpCode();
    expect(otp).toHaveLength(6);
    expect(otp).toMatch(/^\d{6}$/);
  });
});