tiny-uuid-gen 0.1.0

package/README.md

@@ -0,0 +1,100 @@
+# tiny-uuid
+
+UUID v4 generator in 200 bytes. Zero dependencies.
+
+## Why?
+
+| Package | Size |
+|---------|------|
+| uuid | 8KB |
+| **tiny-uuid** | **200B** |
+
+That's **40x smaller**.
+
+## Install
+
+```bash
+npm install tiny-uuid-gen
+```
+
+## Usage
+
+```javascript
+import { uuid } from 'tiny-uuid-gen';
+
+const id = uuid();
+// "550e8400-e29b-41d4-a716-446655440000"
+```
+
+### CommonJS
+
+```javascript
+const uuid = require('tiny-uuid-gen');
+
+const id = uuid();
+```
+
+### TypeScript
+
+Full TypeScript support included.
+
+```typescript
+import { uuid } from 'tiny-uuid-gen';
+
+const id: string = uuid();
+```
+
+## API
+
+### `uuid(): string`
+
+Generates a random UUID v4.
+
+Returns: `xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`
+
+Where:
+- `x` = random hex digit
+- `4` = version 4 (random)
+- `y` = variant (8, 9, a, or b)
+
+## When to use
+
+Use tiny-uuid when:
+- You just need random UUIDs
+- Bundle size matters
+- No crypto requirements
+
+Use `uuid` package when:
+- You need v1 (timestamp) or v5 (namespace)
+- You need cryptographically secure randomness
+- You're in a security-critical context
+
+## How it works
+
+```javascript
+export function uuid() {
+  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
+    const r = Math.random() * 16 | 0;
+    return (c === 'x' ? r : (r & 0x3 | 0x8)).toString(16);
+  });
+}
+```
+
+That's it. 5 lines.
+
+## Spec Compliance
+
+Follows RFC 4122 format:
+- Version nibble: `4` (random)
+- Variant bits: `10xx` (8/9/a/b)
+
+Note: Uses `Math.random()`, not `crypto.getRandomValues()`.
+For security-critical applications, use the full `uuid` package.
+
+## More Tools
+
+See all dev tools: https://takawasi-social.com/en/
+
+## License
+
+MIT

package/index.cjs

@@ -0,0 +1,14 @@
+/**
+ * Generate a random UUID v4.
+ * @returns {string} UUID in format xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+ */
+function uuid() {
+  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
+    const r = Math.random() * 16 | 0;
+    return (c === 'x' ? r : (r & 0x3 | 0x8)).toString(16);
+  });
+}
+
+module.exports = uuid;
+module.exports.uuid = uuid;
+module.exports.default = uuid;

package/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generate a random UUID v4.
+ * @returns UUID in format xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+ */
+export function uuid(): string;
+
+export default uuid;

package/index.js

@@ -0,0 +1,12 @@
+/**
+ * Generate a random UUID v4.
+ * @returns {string} UUID in format xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+ */
+export function uuid() {
+  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
+    const r = Math.random() * 16 | 0;
+    return (c === 'x' ? r : (r & 0x3 | 0x8)).toString(16);
+  });
+}
+
+export default uuid;

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "tiny-uuid-gen",
+  "version": "0.1.0",
+  "description": "UUID v4 generator in 200 bytes. Zero dependencies.",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "require": "./index.cjs",
+      "types": "./index.d.ts"
+    }
+  },
+  "files": [
+    "index.js",
+    "index.cjs",
+    "index.d.ts"
+  ],
+  "keywords": [
+    "uuid",
+    "tiny",
+    "minimal",
+    "lightweight",
+    "v4",
+    "random"
+  ],
+  "author": "takawasi",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/takawasi/tiny-uuid"
+  },
+  "scripts": {
+    "test": "node test.js",
+    "size": "gzip -c index.js | wc -c"
+  }
+}