@geenius/tools 0.1.0 → 0.3.0

package/packages/convex/shared/src/extract.ts

@@ -1,75 +0,0 @@
-// @geenius-tools/convex-errors — src/extract.ts
-
-import { ConvexError } from 'convex/values'
-import type { AppErrorCode, AppErrorPayload, ValidationError } from './types'
-import { HTTP_STATUS_MAP } from './types'
-
-/**
- * Check if an error is a ConvexError with AppErrorPayload.
- */
-export function isAppError(error: unknown): error is ConvexError<AppErrorPayload> {
-    return error instanceof ConvexError && typeof (error.data as AppErrorPayload)?.code === 'string'
-}
-
-/**
- * Extract AppErrorPayload from a ConvexError, or return null.
- */
-export function extractAppError(error: unknown): AppErrorPayload | null {
-    if (isAppError(error)) {
-        return error.data
-    }
-    return null
-}
-
-/**
- * Get the error code from a ConvexError, or 'INTERNAL' as fallback.
- */
-export function getErrorCode(error: unknown): AppErrorCode {
-    const payload = extractAppError(error)
-    return payload?.code ?? 'INTERNAL'
-}
-
-/**
- * Get the error message from a ConvexError, or a fallback string.
- */
-export function getErrorMsg(error: unknown, fallback = 'An unexpected error occurred'): string {
-    const payload = extractAppError(error)
-    return payload?.message ?? (error instanceof Error ? error.message : fallback)
-}
-
-/**
- * Get validation errors from a ConvexError, or empty array.
- */
-export function getValidationErrors(error: unknown): ValidationError[] {
-    const payload = extractAppError(error)
-    return payload?.validationErrors ?? []
-}
-
-/**
- * Get HTTP status code for a ConvexError.
- */
-export function getHttpStatus(error: unknown): number {
-    const code = getErrorCode(error)
-    return HTTP_STATUS_MAP[code] ?? 500
-}
-
-/**
- * Convert an error to a JSON-serializable response object.
- * Useful for HTTP error responses.
- */
-export function toErrorResponse(error: unknown): {
-    status: number
-    body: { error: AppErrorPayload }
-} {
-    const payload = extractAppError(error)
-    const code = payload?.code ?? 'INTERNAL'
-    return {
-        status: HTTP_STATUS_MAP[code] ?? 500,
-        body: {
-            error: payload ?? {
-                code: 'INTERNAL',
-                message: error instanceof Error ? error.message : 'Unknown error',
-            },
-        },
-    }
-}

package/packages/convex/shared/src/index.ts

@@ -1,41 +0,0 @@
-// @geenius-tools/convex-errors — src/index.ts
-
-// Types
-export type {
-    AppErrorCode,
-    AppErrorPayload,
-    ValidationError,
-} from './types'
-export { HTTP_STATUS_MAP } from './types'
-
-// Error throwers
-export {
-    unauthenticated,
-    forbidden,
-    notFound,
-    badRequest,
-    conflict,
-    internal,
-    featureDisabled,
-    rateLimited,
-    validationError,
-    withErrorMeta,
-} from './throw'
-
-// Error messages
-export {
-    DEFAULT_ERROR_MESSAGES,
-    configureErrorMessages,
-    getErrorMessage,
-} from './messages'
-
-// Error extraction (for frontend)
-export {
-    isAppError,
-    extractAppError,
-    getErrorCode,
-    getErrorMsg,
-    getValidationErrors,
-    getHttpStatus,
-    toErrorResponse,
-} from './extract'

package/packages/convex/shared/src/messages.ts

@@ -1,45 +0,0 @@
-// @geenius-tools/convex-errors — src/messages.ts
-
-import type { AppErrorCode } from './types'
-
-/**
- * Default English error messages.
- * Override these by passing your own messages to `configureErrorMessages()`.
- */
-export const DEFAULT_ERROR_MESSAGES: Record<AppErrorCode, string> = {
-    UNAUTHENTICATED: 'Please sign in to continue.',
-    FORBIDDEN: 'You do not have permission for this action.',
-    NOT_FOUND: 'The requested resource was not found.',
-    BAD_REQUEST: 'Invalid request. Please check your input.',
-    CONFLICT: 'Action not possible (conflict with existing data).',
-    INTERNAL: 'An internal error occurred. Please try again later.',
-    VALIDATION_ERROR: 'Please check your input and try again.',
-    RATE_LIMITED: 'Too many requests. Please try again later.',
-    FEATURE_DISABLED: 'This feature is currently disabled.',
-}
-
-let currentMessages: Record<AppErrorCode, string> = { ...DEFAULT_ERROR_MESSAGES }
-
-/**
- * Override default error messages (e.g., for i18n / localization).
- *
- * @example
- * ```ts
- * configureErrorMessages({
- *   UNAUTHENTICATED: 'Bitte melde dich an, um fortzufahren.',
- *   FORBIDDEN: 'Du hast keine Berechtigung für diese Aktion.',
- * })
- * ```
- */
-export function configureErrorMessages(
-    messages: Partial<Record<AppErrorCode, string>>,
-): void {
-    currentMessages = { ...currentMessages, ...messages }
-}
-
-/**
- * Get the current error message for a given code.
- */
-export function getErrorMessage(code: AppErrorCode): string {
-    return currentMessages[code]
-}

package/packages/convex/shared/src/security.ts

@@ -1,112 +0,0 @@
-// @geenius-tools/convex-wrappers — src/security.ts
-
-import type { RateLimitConfig, PrivacyConfig } from './types'
-
-/**
- * Simple in-memory rate limiter for development/prototyping.
- * In production, you'd want to use Convex's built-in rate limiting
- * or a persistent store.
- *
- * This provides the core rate limit checking logic.
- * The actual Convex integration is left to the consumer to wire up.
- *
- * @example
- * ```ts
- * import { checkRateLimit } from '@geenius-tools/convex-wrappers'
- *
- * // In your mutation wrapper:
- * const isAllowed = checkRateLimit({
- *   key: userId,
- *   maxRequests: 10,
- *   windowMs: 60_000,
- * })
- * if (!isAllowed) {
- *   rateLimited('Too many requests')
- * }
- * ```
- */
-const rateLimitStore = new Map<string, { count: number; resetAt: number }>()
-
-export function checkRateLimit(params: {
-    key: string
-    maxRequests: number
-    windowMs: number
-}): boolean {
-    const { key, maxRequests, windowMs } = params
-    const now = Date.now()
-    const entry = rateLimitStore.get(key)
-
-    if (!entry || now > entry.resetAt) {
-        rateLimitStore.set(key, { count: 1, resetAt: now + windowMs })
-        return true
-    }
-
-    if (entry.count >= maxRequests) {
-        return false
-    }
-
-    entry.count++
-    return true
-}
-
-/**
- * Clear rate limit for a specific key (e.g., after successful auth).
- */
-export function clearRateLimit(key: string): void {
-    rateLimitStore.delete(key)
-}
-
-/**
- * Validate that a user has one of the required roles.
- */
-export function requireRoles(
-    user: { role?: string; roleType?: string; roles?: string[] },
-    requiredRoles: readonly string[],
-): void {
-    const userRoles = [
-        user.role,
-        user.roleType,
-        ...(user.roles ?? []),
-    ].filter(Boolean) as string[]
-
-    const hasRole = requiredRoles.some((r) => userRoles.includes(r))
-    if (!hasRole) {
-        throw new Error(
-            `Forbidden: user has roles [${userRoles.join(', ')}] but needs one of [${requiredRoles.join(', ')}]`,
-        )
-    }
-}
-
-/**
- * Redact args based on privacy config.
- */
-export function redactArgs(
-    args: Record<string, unknown>,
-    privacy: PrivacyConfig,
-): Record<string, unknown> {
-    if (privacy.mode === 'none') return args
-
-    const sensitive = new Set(
-        privacy.sensitiveFields ?? ['password', 'token', 'secret', 'apiKey'],
-    )
-
-    const result: Record<string, unknown> = {}
-    for (const [key, value] of Object.entries(args)) {
-        if (sensitive.has(key)) {
-            result[key] = privacy.mode === 'hash' ? `[HASHED:${hashSimple(String(value))}]` : '[REDACTED]'
-        } else {
-            result[key] = value
-        }
-    }
-    return result
-}
-
-function hashSimple(input: string): string {
-    let hash = 0
-    for (let i = 0; i < input.length; i++) {
-        const char = input.charCodeAt(i)
-        hash = (hash << 5) - hash + char
-        hash |= 0
-    }
-    return Math.abs(hash).toString(36)
-}

package/packages/convex/shared/src/throw.ts

@@ -1,184 +0,0 @@
-// @geenius-tools/convex-errors — src/throw.ts
-
-import { ConvexError, type Value } from 'convex/values'
-import type { AppErrorCode, AppErrorPayload, ValidationError } from './types'
-import { getErrorMessage } from './messages'
-
-/**
- * Internal function to throw a ConvexError with AppErrorPayload.
- */
-function throwAppError(
-    code: AppErrorCode,
-    message?: string,
-    details?: Record<string, Value>,
-    validationErrors?: ValidationError[],
-    metadata?: AppErrorPayload['_metadata'],
-): never {
-    const payload: AppErrorPayload = {
-        code,
-        message: message || getErrorMessage(code),
-        details,
-        validationErrors,
-        _metadata: {
-            timestamp: new Date().toISOString(),
-            ...metadata,
-        },
-    }
-    throw new ConvexError<AppErrorPayload>(payload)
-}
-
-/**
- * Throw UNAUTHENTICATED error (401).
- * Use when user is not authenticated.
- */
-export function unauthenticated(
-    message?: string,
-    details?: Record<string, Value>,
-): never {
-    throwAppError('UNAUTHENTICATED', message, details)
-}
-
-/**
- * Throw FORBIDDEN error (403).
- * Use when user lacks permission for the action.
- */
-export function forbidden(
-    message?: string,
-    details?: Record<string, Value>,
-): never {
-    throwAppError('FORBIDDEN', message, details)
-}
-
-/**
- * Throw NOT_FOUND error (404).
- * Use when a requested resource doesn't exist.
- */
-export function notFound(
-    message?: string,
-    details?: Record<string, Value>,
-): never {
-    throwAppError('NOT_FOUND', message, details)
-}
-
-/**
- * Throw BAD_REQUEST error (400).
- * Use for invalid input or business rule violations.
- */
-export function badRequest(
-    message?: string,
-    details?: Record<string, Value>,
-): never {
-    throwAppError('BAD_REQUEST', message, details)
-}
-
-/**
- * Throw CONFLICT error (409).
- * Use for state conflicts (e.g., optimistic concurrency control failures).
- */
-export function conflict(
-    message?: string,
-    details?: Record<string, Value>,
-): never {
-    throwAppError('CONFLICT', message, details)
-}
-
-/**
- * Throw INTERNAL error (500).
- * Use for internal server errors and unexpected conditions.
- */
-export function internal(
-    message?: string,
-    details?: Record<string, Value>,
-): never {
-    throwAppError('INTERNAL', message, details)
-}
-
-/**
- * Throw FEATURE_DISABLED error.
- * Use when a feature flag is off.
- */
-export function featureDisabled(
-    message?: string,
-    details?: Record<string, Value>,
-): never {
-    throwAppError('FEATURE_DISABLED', message, details)
-}
-
-/**
- * Throw RATE_LIMITED error (429).
- * Use when rate limits are exceeded.
- */
-export function rateLimited(
-    message?: string,
-    details?: Record<string, Value>,
-): never {
-    throwAppError('RATE_LIMITED', message, details)
-}
-
-/**
- * Throw VALIDATION_ERROR (422).
- * Use for form validation errors with field-level details.
- *
- * @example
- * ```ts
- * const errors: ValidationError[] = []
- * if (!email.includes('@')) {
- *   errors.push({ field: 'email', message: 'Invalid email address' })
- * }
- * if (errors.length > 0) {
- *   validationError(errors, 'Please check your input')
- * }
- * ```
- */
-export function validationError(
-    validationErrors: ValidationError[],
-    message?: string,
-    details?: Record<string, Value>,
-): never {
-    throwAppError('VALIDATION_ERROR', message, details, validationErrors)
-}
-
-/**
- * Create error helpers pre-enriched with metadata.
- *
- * @example
- * ```ts
- * const err = withErrorMeta({
- *   functionName: 'users.update',
- *   requestId: 'abc123',
- * })
- * err.notFound('User not found')
- * ```
- */
-export function withErrorMeta(meta: {
-    functionName?: string
-    requestId?: string
-    userId?: string
-}) {
-    const mergeDetails = (d?: Record<string, Value>): Record<string, Value> => ({
-        ...(d ?? {}),
-        ...meta,
-    })
-
-    return {
-        unauthenticated: (m?: string, d?: Record<string, Value>) =>
-            unauthenticated(m, mergeDetails(d)),
-        forbidden: (m?: string, d?: Record<string, Value>) =>
-            forbidden(m, mergeDetails(d)),
-        notFound: (m?: string, d?: Record<string, Value>) =>
-            notFound(m, mergeDetails(d)),
-        badRequest: (m?: string, d?: Record<string, Value>) =>
-            badRequest(m, mergeDetails(d)),
-        conflict: (m?: string, d?: Record<string, Value>) =>
-            conflict(m, mergeDetails(d)),
-        internal: (m?: string, d?: Record<string, Value>) =>
-            internal(m, mergeDetails(d)),
-        validationError: (
-            ve: ValidationError[],
-            m?: string,
-            d?: Record<string, Value>,
-        ) => validationError(ve, m, mergeDetails(d)),
-        rateLimited: (m?: string, d?: Record<string, Value>) =>
-            rateLimited(m, mergeDetails(d)),
-    }
-}

package/packages/convex/shared/src/types.ts

@@ -1,57 +0,0 @@
-// @geenius-tools/convex-errors — src/types.ts
-
-import type { Value } from 'convex/values'
-
-/**
- * Standard error codes for Convex applications.
- */
-export type AppErrorCode =
-    | 'UNAUTHENTICATED'
-    | 'FORBIDDEN'
-    | 'NOT_FOUND'
-    | 'BAD_REQUEST'
-    | 'CONFLICT'
-    | 'INTERNAL'
-    | 'VALIDATION_ERROR'
-    | 'RATE_LIMITED'
-    | 'FEATURE_DISABLED'
-
-/**
- * A field-level validation error.
- */
-export type ValidationError = {
-    field: string
-    message: string
-    code?: string
-}
-
-/**
- * Structured payload thrown via `ConvexError<AppErrorPayload>`.
- */
-export type AppErrorPayload = {
-    code: AppErrorCode
-    message?: string
-    details?: Record<string, Value>
-    validationErrors?: ValidationError[]
-    _metadata?: {
-        timestamp: string
-        functionName?: string
-        userId?: string
-        requestId?: string
-    }
-}
-
-/**
- * HTTP status code mapping for error codes.
- */
-export const HTTP_STATUS_MAP: Record<AppErrorCode, number> = {
-    UNAUTHENTICATED: 401,
-    FORBIDDEN: 403,
-    NOT_FOUND: 404,
-    BAD_REQUEST: 400,
-    CONFLICT: 409,
-    INTERNAL: 500,
-    VALIDATION_ERROR: 422,
-    RATE_LIMITED: 429,
-    FEATURE_DISABLED: 403,
-}

package/packages/convex/shared/src/utils.ts

@@ -1,58 +0,0 @@
-// @geenius-tools/convex-wrappers — src/utils.ts
-
-/**
- * Generate a unique request ID for tracing.
- */
-export function makeRequestId(): string {
-    const timestamp = Date.now().toString(36)
-    const random = Math.random().toString(36).substring(2, 8)
-    return `req_${timestamp}_${random}`
-}
-
-/**
- * Redact sensitive fields from an object for logging.
- */
-export function redactForLogging(
-    args: Record<string, unknown>,
-    config: { sensitiveFields?: string[] },
-): Record<string, unknown> {
-    const sensitiveFields = new Set(
-        config.sensitiveFields ?? ['password', 'token', 'secret', 'apiKey', 'accessToken'],
-    )
-
-    const result: Record<string, unknown> = {}
-    for (const [key, value] of Object.entries(args)) {
-        if (sensitiveFields.has(key)) {
-            result[key] = '[REDACTED]'
-        } else {
-            result[key] = value
-        }
-    }
-    return result
-}
-
-/**
- * Extract userId from args (for trusted internal calls).
- * Throws if userId is missing.
- */
-export function extractRequiredUserId(
-    args: Record<string, unknown>,
-    context: string,
-): string {
-    const userId = args.userId
-    if (!userId || typeof userId !== 'string') {
-        throw new Error(`Missing userId in ${context}`)
-    }
-    return userId
-}
-
-/**
- * Extract optional userId from args.
- */
-export function extractOptionalUserId(
-    args: Record<string, unknown>,
-): string | undefined {
-    const userId = args.userId
-    if (!userId || typeof userId !== 'string') return undefined
-    return userId
-}

package/packages/convex/shared/tsconfig.json

@@ -1,28 +0,0 @@
-{
-    "compilerOptions": {
-        "target": "ES2022",
-        "module": "ESNext",
-        "moduleResolution": "bundler",
-        "lib": [
-            "ES2022"
-        ],
-        "strict": true,
-        "esModuleInterop": true,
-        "skipLibCheck": true,
-        "forceConsistentCasingInFileNames": true,
-        "resolveJsonModule": true,
-        "isolatedModules": true,
-        "declaration": true,
-        "declarationMap": true,
-        "sourceMap": true,
-        "outDir": "./dist",
-        "rootDir": "./src"
-    },
-    "include": [
-        "src"
-    ],
-    "exclude": [
-        "node_modules",
-        "dist"
-    ]
-}

package/packages/convex/shared/tsup.config.ts

@@ -1,12 +0,0 @@
-import { defineConfig } from 'tsup'
-
-export default defineConfig({
-    entry: { index: 'src/index.ts' },
-    outDir: 'dist',
-    format: ['esm'],
-    dts: true,
-    sourcemap: true,
-    clean: true,
-    treeshake: true,
-    external: ['convex'],
-})

package/packages/devtools/package.json

@@ -1,27 +0,0 @@
-{
-  "name": "@geenius-tools/devtools",
-  "version": "0.1.0",
-  "type": "module",
-  "description": "Development tooling utilities for Geenius projects",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "scripts": {
-    "build": "tsup",
-    "type-check": "tsc --noEmit",
-    "clean": "rm -rf dist .turbo"
-  },
-  "devDependencies": {
-    "typescript": "~6.0.2",
-    "tsup": "^8.0.1"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "license": "MIT"
-}

package/packages/devtools/react/package.json

@@ -1,53 +0,0 @@
-{
-  "name": "@geenius-tools/devtools-react",
-  "version": "0.1.0",
-  "private": false,
-  "type": "module",
-  "description": "React dev-tools UI — floating toolbar, performance panel, inspector, GitHub issues",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "src"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "clean": "rm -rf dist",
-    "type-check": "tsc --noEmit",
-    "prepublishOnly": "pnpm clean && pnpm build"
-  },
-  "dependencies": {
-    "@geenius-tools/logger": "workspace:*"
-  },
-  "devDependencies": {
-    "@geenius-ui/react": "workspace:*",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "lucide-react": "^0.577.0",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
-    "tsup": "^8.5.1",
-    "typescript": "~5.9.3"
-  },
-  "peerDependencies": {
-    "@geenius-ui/react": "workspace:*",
-    "lucide-react": ">=0.300.0",
-    "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0"
-  },
-  "author": "Antigravity HQ",
-  "engines": {
-    "node": ">=20.0.0"
-  }
-}