@sudobility/entity_service 1.0.1

package/dist/utils/slug-generator.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * @fileoverview Entity Slug Generation Utilities
+ * @description Functions for generating unique entity slugs and invitation tokens
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateEntitySlug = generateEntitySlug;
+exports.generateInvitationToken = generateInvitationToken;
+exports.normalizeSlug = normalizeSlug;
+exports.validateSlug = validateSlug;
+exports.generateUniqueSlug = generateUniqueSlug;
+exports.calculateInvitationExpiry = calculateInvitationExpiry;
+/** Characters allowed in entity slugs (lowercase alphanumeric) */
+const SLUG_CHARS = 'abcdefghijklmnopqrstuvwxyz0123456789';
+/** Default length for generated entity slugs */
+const DEFAULT_SLUG_LENGTH = 8;
+/** Length for invitation tokens (hex characters) */
+const INVITATION_TOKEN_LENGTH = 32;
+/**
+ * Generate a random entity slug.
+ * @param length - Length of the slug (default 8, max 12)
+ * @returns A random alphanumeric slug
+ */
+function generateEntitySlug(length = DEFAULT_SLUG_LENGTH) {
+    const actualLength = Math.min(Math.max(length, 8), 12);
+    let slug = '';
+    for (let i = 0; i < actualLength; i++) {
+        slug += SLUG_CHARS[Math.floor(Math.random() * SLUG_CHARS.length)];
+    }
+    return slug;
+}
+/**
+ * Generate a unique invitation token.
+ * @returns A 64-character hex string
+ */
+function generateInvitationToken() {
+    const bytes = new Uint8Array(INVITATION_TOKEN_LENGTH);
+    crypto.getRandomValues(bytes);
+    return Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('');
+}
+/**
+ * Normalize a user-provided slug to valid format.
+ * Converts to lowercase and removes invalid characters.
+ * @param input - The user-provided slug
+ * @returns Normalized slug
+ */
+function normalizeSlug(input) {
+    return input
+        .toLowerCase()
+        .replace(/[^a-z0-9]/g, '')
+        .slice(0, 12);
+}
+/**
+ * Validate that a slug meets the requirements.
+ * @param slug - The slug to validate
+ * @returns Whether the slug is valid
+ */
+function validateSlug(slug) {
+    return /^[a-z0-9]{8,12}$/.test(slug);
+}
+/**
+ * Generate a slug with a numeric suffix to avoid collisions.
+ * @param baseSlug - The base slug to append suffix to
+ * @param existingSlugs - Set of existing slugs to avoid
+ * @returns A unique slug with suffix if needed
+ */
+function generateUniqueSlug(baseSlug, existingSlugs) {
+    const normalized = normalizeSlug(baseSlug).slice(0, 8);
+    if (!existingSlugs.has(normalized) && validateSlug(normalized)) {
+        return normalized;
+    }
+    // Try adding numeric suffixes
+    for (let i = 1; i < 1000; i++) {
+        const suffix = i.toString();
+        const candidate = (normalized.slice(0, 12 - suffix.length) + suffix).slice(0, 12);
+        if (!existingSlugs.has(candidate) && validateSlug(candidate)) {
+            return candidate;
+        }
+    }
+    // Fall back to random slug
+    return generateEntitySlug();
+}
+/**
+ * Calculate invitation expiry date (7 days from now).
+ * @returns ISO 8601 string for expiry date
+ */
+function calculateInvitationExpiry() {
+    const expiryDate = new Date();
+    expiryDate.setDate(expiryDate.getDate() + 7);
+    return expiryDate.toISOString();
+}
+//# sourceMappingURL=slug-generator.js.map

package/dist/utils/slug-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug-generator.js","sourceRoot":"","sources":["../../src/utils/slug-generator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@sudobility/entity_service",
+  "version": "1.0.1",
+  "description": "Shared entity/organization management library for multi-tenant workspaces",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./middleware/hono": {
+      "import": "./dist/middleware/hono.js",
+      "require": "./dist/middleware/hono.cjs",
+      "types": "./dist/middleware/hono.d.ts"
+    },
+    "./schema": {
+      "import": "./dist/schema/entities.js",
+      "require": "./dist/schema/entities.cjs",
+      "types": "./dist/schema/entities.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "bun run build:esm && bun run build:cjs",
+    "build:esm": "bunx tsc -p tsconfig.esm.json",
+    "build:cjs": "bunx tsc -p tsconfig.cjs.json && bun run build:cjs-rename",
+    "build:cjs-rename": "find dist -name '*.js' -not -name '*.cjs' -exec sh -c 'cp \"$1\" \"${1%.js}.cjs\"' _ {} \\;",
+    "clean": "rm -rf dist",
+    "dev": "bunx tsc --watch",
+    "test": "bun test",
+    "lint": "bunx eslint src/",
+    "lint:fix": "bunx eslint src/ --fix",
+    "typecheck": "bunx tsc --noEmit",
+    "format": "bunx prettier --write \"src/**/*.ts\"",
+    "format:check": "bunx prettier --check \"src/**/*.ts\"",
+    "verify": "bun run typecheck && bun run lint && bun run build",
+    "prepublishOnly": "bun run clean && bun run verify"
+  },
+  "files": [
+    "dist/**/*",
+    "CLAUDE.md"
+  ],
+  "keywords": [
+    "entity",
+    "organization",
+    "workspace",
+    "multi-tenant",
+    "hono",
+    "drizzle"
+  ],
+  "author": "Sudobility",
+  "license": "MIT",
+  "peerDependencies": {
+    "@sudobility/types": "^1.9.40",
+    "drizzle-orm": "^0.45.0",
+    "hono": "^4.0.0"
+  },
+  "devDependencies": {
+    "@sudobility/types": "^1.9.40",
+    "@types/bun": "latest",
+    "@types/node": "^24.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.50.0",
+    "@typescript-eslint/parser": "^8.50.0",
+    "drizzle-orm": "^0.45.0",
+    "eslint": "^9.39.0",
+    "eslint-plugin-import": "^2.32.0",
+    "hono": "^4.10.0",
+    "postgres": "^3.4.0",
+    "prettier": "^3.7.0",
+    "typescript": "^5.9.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}