@geenius/tools 0.1.0 → 0.3.0

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,11 +0,0 @@
----
-name: Feature Request
-about: Suggest a new feature
-labels: enhancement
----
-
-## Problem
-
-## Proposed solution
-
-## Alternatives considered

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,10 +0,0 @@
-## What
-
-## Why
-
-## How
-
-## Checklist
-- [ ] Tests added/updated
-- [ ] `pnpm changeset` run (if applicable)
-- [ ] Documentation updated

package/.github/dependabot.yml

@@ -1,11 +0,0 @@
-version: 2
-updates:
-  - package-ecosystem: "npm"
-    directory: "/"
-    schedule:
-      interval: "weekly"
-    open-pull-requests-limit: 10
-  - package-ecosystem: "github-actions"
-    directory: "/"
-    schedule:
-      interval: "weekly"

package/.github/workflows/ci.yml

@@ -1,23 +0,0 @@
-name: CI
-on:
-  pull_request:
-    branches: [main]
-  push:
-    branches: [main]
-
-jobs:
-  check:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v4
-        with:
-          version: 10
-      - uses: actions/setup-node@v4
-        with:
-          node-version-file: '.nvmrc'
-          cache: 'pnpm'
-      - run: pnpm install --frozen-lockfile
-      - run: pnpm build
-      - run: pnpm lint
-      - run: pnpm test

package/.github/workflows/release.yml

@@ -1,29 +0,0 @@
-name: Release
-on:
-  push:
-    branches: [main]
-
-concurrency: ${{ github.workflow }}-${{ github.ref }}
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v4
-        with:
-          version: 10
-      - uses: actions/setup-node@v4
-        with:
-          node-version-file: '.nvmrc'
-          cache: 'pnpm'
-          registry-url: 'https://registry.npmjs.org'
-      - run: pnpm install --frozen-lockfile
-      - run: pnpm build
-      - uses: changesets/action@v1
-        with:
-          publish: pnpm changeset publish
-          version: pnpm changeset version
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.node-version

@@ -1 +0,0 @@
-20

package/.nvmrc

@@ -1 +0,0 @@
-22

package/.prettierrc

@@ -1,7 +0,0 @@
-{
-  "semi": false,
-  "singleQuote": true,
-  "trailingComma": "all",
-  "printWidth": 120,
-  "tabWidth": 2
-}

package/.project/ACCOUNT.yaml

@@ -1,4 +0,0 @@
-owner: Mehdi Nabhani
-email: mehdi@geenius.app
-github: mxn2020
-organization: geenius

package/.project/IDEAS.yaml

@@ -1,7 +0,0 @@
-ideas:
-  - title: "CLI scaffolding"
-    description: "Add a create command to geenius-cli for this package"
-    priority: medium
-  - title: "Vue adapter"
-    description: "Add Vue 3 support alongside React and SolidJS"
-    priority: low

package/.project/PROJECT.yaml

@@ -1,11 +0,0 @@
-name: geenius-tools
-description: "Geenius Tools — Reusable dev tools for React, Solid, and Convex"
-category: library
-priority: high
-tags:
-  - geenius
-  - npm-package
-  - react
-  - solidjs
-deploy_url: null
-npm_scope: "@geenius-tools"

package/.project/ROADMAP.yaml

@@ -1,15 +0,0 @@
-version: "0.1"
-milestones:
-  - name: "v0.1.0 — Initial Release"
-    status: in-progress
-    items:
-      - "Core shared types and logic"
-      - "React hooks and components"
-      - "SolidJS primitives"
-      - "npm publishing via Changesets"
-  - name: "v0.2.0 — Stability"
-    status: planned
-    items:
-      - "Test coverage ≥ 50%"
-      - "API documentation"
-      - "Convex adapter"

package/CODE_OF_CONDUCT.md

@@ -1,26 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment:
-- Using welcoming and inclusive language
-- Being respectful of differing viewpoints and experiences
-- Gracefully accepting constructive criticism
-- Focusing on what is best for the community
-
-Examples of unacceptable behavior:
-- Trolling, insulting/derogatory comments, and personal or political attacks
-- Public or private harassment
-- Publishing others' private information without explicit permission
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the project maintainers at support@geenius.app. All complaints will be reviewed and investigated.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.

package/CONTRIBUTING.md

@@ -1,69 +0,0 @@
-# Contributing to @geenius-tools
-
-Thank you for your interest in contributing! This guide will help you get started.
-
-## Development Setup
-
-```bash
-# Clone the repository
-git clone https://github.com/mxn2020/geenius-tools.git
-cd geenius-tools
-
-# Install dependencies
-pnpm install
-
-# Build all packages
-pnpm build
-
-# Run tests
-pnpm test
-
-# Lint
-pnpm lint
-```
-
-## Project Structure
-
-```
-packages/
-  convex-errors/     — Convex error handling utilities
-  convex-wrappers/   — Convex function wrappers
-  devtools-react/    — React developer tools panel
-  env/               — Environment variable utilities
-  errors-react/      — React error boundaries and displays
-  errors-solidjs/    — SolidJS error handling
-  logger/            — Structured logging
-  logger-react/      — React logging hooks
-  logger-solid/      — SolidJS logging hooks
-  perf-react/        — React performance monitoring
-  perf-solidjs/      — SolidJS performance monitoring
-```
-
-## Contribution Workflow
-
-1. **Fork** the repository
-2. **Create a branch** for your change: `git checkout -b feat/my-feature`
-3. **Make your changes** and add tests
-4. **Ensure checks pass**: `pnpm lint && pnpm test && pnpm build`
-5. **Commit** with a conventional message: `feat: add metrics collector`
-6. **Push** and open a Pull Request
-
-## Commit Convention
-
-We follow [Conventional Commits](https://www.conventionalcommits.org/):
-- `feat:` — New feature or utility
-- `fix:` — Bug fix
-- `docs:` — Documentation only
-- `refactor:` — Code change that neither fixes a bug nor adds a feature
-- `test:` — Adding or updating tests
-- `chore:` — Tooling, CI, dependencies
-
-## Code Style
-
-- TypeScript strict mode
-- Prettier for formatting
-- ESLint for linting
-
-## Questions?
-
-Open an issue or reach out at support@geenius.app.

package/SECURITY.md

@@ -1,18 +0,0 @@
-# Security Policy
-
-## Supported Versions
-
-| Version | Supported          |
-|---------|-------------------|
-| 0.0.x   | ✅ Yes             |
-
-## Reporting a Vulnerability
-
-If you discover a security vulnerability, please report it responsibly:
-
-1. **Do NOT** open a public GitHub issue
-2. **Email** security@geenius.app with details
-3. Include steps to reproduce, impact assessment, and any suggested fix
-4. You will receive a response within **48 hours**
-
-We will coordinate disclosure and credit you (if desired) once the issue is resolved.

package/SUPPORT.md

@@ -1,14 +0,0 @@
-# Support
-
-## Getting Help
-
-- **Documentation**: See the [README](./README.md) for usage and API reference
-- **Issues**: [Open a GitHub issue](https://github.com/mxn2020/geenius-tools/issues) for bugs or feature requests
-- **Discussions**: Use [GitHub Discussions](https://github.com/mxn2020/geenius-tools/discussions) for questions and community support
-- **Email**: support@geenius.app for private inquiries
-
-## Response Times
-
-- **Bug reports**: Within 48 hours
-- **Feature requests**: Reviewed weekly
-- **Security issues**: Within 24 hours (see [SECURITY.md](./SECURITY.md))

package/packages/convex/shared/package.json

@@ -1,42 +0,0 @@
-{
-  "name": "@geenius-tools/convex",
-  "version": "0.1.0",
-  "private": false,
-  "type": "module",
-  "description": "Typed error system for Convex applications",
-  "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"
-  },
-  "peerDependencies": {
-    "convex": ">=1.0.0"
-  },
-  "devDependencies": {
-    "convex": "^1.34.0",
-    "tsup": "^8.5.1",
-    "typescript": "~5.9.3"
-  },
-  "author": "Antigravity HQ",
-  "engines": {
-    "node": ">=20.0.0"
-  }
-}

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

@@ -1,5 +0,0 @@
-// @geenius-tools/convex-wrappers — src/audit/index.ts
-
-export { auditLogFields, auditLogIndexes } from './schema'
-export { writeAudit, generateSearchableText, computeDiff } from './write'
-export { auditPreset } from './presets'

package/packages/convex/shared/src/audit/presets.ts

@@ -1,165 +0,0 @@
-// @geenius-tools/convex-wrappers — src/audit/presets.ts
-
-import type { AuditLogEntry } from '../types'
-import { computeDiff } from './write'
-
-/**
- * Audit log presets — reusable patterns for common mutation audit scenarios.
- *
- * These return factory functions compatible with the mutation wrapper's
- * `.audit()` builder, producing `AuditLogEntry` payloads automatically.
- *
- * @example
- * ```ts
- * // In your Convex mutation:
- * import { auditPreset } from '@geenius-tools/convex-wrappers'
- *
- * export const updateOrderStatus = authedMutation()
- *   .name('orders.updateStatus')
- *   .args({ orderId: v.id('orders'), status: v.string() })
- *   .audit(auditPreset.entityStatus({
- *     entityTable: 'orders',
- *     entityId: (args) => args.orderId,
- *     action: 'update_status',
- *     before: async (ctx, args) => {
- *       const order = await ctx.db.get(args.orderId)
- *       return order?.status
- *     },
- *     after: (args) => args.status,
- *   }))
- *   .handler(async (ctx, args) => { ... })
- * ```
- */
-export const auditPreset = {
-    /**
-     * Preset for status changes (before → after).
-     * Generates a diff showing `{ status: { from, to } }`.
-     */
-    entityStatus<TArgs, TResult = unknown>(params: {
-        entityTable: string
-        entityId: (args: TArgs) => string
-        action: string
-        before?: (ctx: any, args: TArgs) => Promise<unknown> | unknown
-        after: ((args: TArgs, result: TResult) => unknown) | unknown
-        reason?: (args: TArgs) => string | undefined
-    }) {
-        return (args: TArgs) => ({
-            onSuccess: async (callParams: {
-                ctx: any
-                args: TArgs
-                result: TResult
-                requestId: string
-                userId?: string
-                user?: any
-                flags: Record<string, boolean>
-            }): Promise<Omit<AuditLogEntry, 'createdAt'> | null> => {
-                const { ctx, result, requestId, user } = callParams
-
-                const beforeVal = params.before
-                    ? await params.before(ctx, args)
-                    : undefined
-
-                const afterVal =
-                    typeof params.after === 'function'
-                        ? (params.after as (args: TArgs, result: TResult) => unknown)(args, result)
-                        : params.after
-
-                return {
-                    actorId: user?._id,
-                    role: user?.role ?? 'system',
-                    actorRoles: user?.roles ?? (user?.role ? [user.role] : undefined),
-                    action: params.action,
-                    entityTable: params.entityTable,
-                    entityId: params.entityId(args),
-                    beforeJson: beforeVal === undefined ? undefined : JSON.stringify(beforeVal),
-                    afterJson: afterVal === undefined ? undefined : JSON.stringify(afterVal),
-                    diffJson: JSON.stringify({ status: { from: beforeVal, to: afterVal } }),
-                    reason: params.reason ? params.reason(args) : undefined,
-                    requestId,
-                }
-            },
-        })
-    },
-
-    /**
-     * Preset for entity patches (partial updates with full before/after + diff).
-     */
-    entityPatch<TArgs, TResult = unknown>(params: {
-        entityTable: string
-        entityId: (args: TArgs) => string
-        action: string
-        before: (ctx: any, args: TArgs) => Promise<Record<string, unknown>>
-        patch: (args: TArgs, result: TResult) => Record<string, unknown>
-        reason?: (args: TArgs) => string | undefined
-    }) {
-        return (args: TArgs) => ({
-            onSuccess: async (callParams: {
-                ctx: any
-                args: TArgs
-                result: TResult
-                requestId: string
-                userId?: string
-                user?: any
-                flags: Record<string, boolean>
-            }): Promise<Omit<AuditLogEntry, 'createdAt'> | null> => {
-                const { ctx, result, requestId, user } = callParams
-
-                const beforeObj = await params.before(ctx, args)
-                const patchObj = params.patch(args, result)
-                const afterObj = { ...beforeObj, ...patchObj }
-                const diff = computeDiff(beforeObj, afterObj)
-
-                return {
-                    actorId: user?._id,
-                    role: user?.role ?? 'system',
-                    actorRoles: user?.roles ?? (user?.role ? [user.role] : undefined),
-                    action: params.action,
-                    entityTable: params.entityTable,
-                    entityId: params.entityId(args),
-                    beforeJson: JSON.stringify(beforeObj),
-                    afterJson: JSON.stringify(afterObj),
-                    diffJson: JSON.stringify(diff),
-                    reason: params.reason?.(args),
-                    requestId,
-                }
-            },
-        })
-    },
-
-    /**
-     * Preset for simple create/delete actions (no before/after diff needed).
-     */
-    entityAction<TArgs>(params: {
-        entityTable: string
-        entityId: (args: TArgs) => string
-        action: string
-        description?: (args: TArgs) => string | undefined
-        reason?: (args: TArgs) => string | undefined
-    }) {
-        return (_args: TArgs) => ({
-            onSuccess: async (callParams: {
-                ctx: any
-                args: TArgs
-                result: unknown
-                requestId: string
-                userId?: string
-                user?: any
-                flags: Record<string, boolean>
-            }): Promise<Omit<AuditLogEntry, 'createdAt'> | null> => {
-                const { args, requestId, user } = callParams
-
-                return {
-                    actorId: user?._id,
-                    role: user?.role ?? 'system',
-                    actorRoles: user?.roles ?? (user?.role ? [user.role] : undefined),
-                    action: params.action,
-                    entityTable: params.entityTable,
-                    entityId: params.entityId(args),
-                    description: params.description?.(args),
-                    reason: params.reason?.(args),
-                    requestId,
-                }
-            },
-        })
-    },
-}

package/packages/convex/shared/src/audit/schema.ts

@@ -1,85 +0,0 @@
-// @geenius-tools/convex-wrappers — src/audit/schema.ts
-
-/**
- * Audit log table schema definition for Convex.
- *
- * Usage: Import and spread into your Convex schema definition.
- *
- * @example
- * ```ts
- * // convex/schema.ts
- * import { defineSchema, defineTable } from 'convex/server'
- * import { auditLogFields, auditLogIndexes } from '@geenius-tools/convex-wrappers/audit'
- *
- * export default defineSchema({
- *   auditLogs: defineTable(auditLogFields)
- *     .index('by_entity', auditLogIndexes.by_entity)
- *     .index('by_entityTable', auditLogIndexes.by_entityTable)
- *     .index('by_action', auditLogIndexes.by_action)
- *     .index('by_createdAt', auditLogIndexes.by_createdAt)
- *     .searchIndex('search_auditLogs', auditLogIndexes.search),
- * })
- * ```
- */
-
-import { v } from 'convex/values'
-
-/**
- * Field validators for the auditLogs table.
- */
-export const auditLogFields = {
-    /** The user who performed the action */
-    actorId: v.optional(v.id('users')),
-    /** Role of the actor (e.g., 'admin', 'user', 'system') */
-    role: v.string(),
-    /** Array of roles the actor had at time of action */
-    actorRoles: v.optional(v.array(v.string())),
-
-    /** Action that was performed (e.g., 'create', 'update', 'delete') */
-    action: v.string(),
-
-    /** Table the entity belongs to */
-    entityTable: v.string(),
-    /** ID of the affected entity */
-    entityId: v.optional(v.string()),
-    /** Type classification of the entity */
-    entityType: v.optional(v.string()),
-    /** Human-readable title of the entity */
-    entityTitle: v.optional(v.string()),
-
-    /** JSON snapshot of the entity before the action */
-    beforeJson: v.optional(v.string()),
-    /** JSON snapshot of the entity after the action */
-    afterJson: v.optional(v.string()),
-    /** JSON diff of changes */
-    diffJson: v.optional(v.string()),
-
-    /** Reason for the action (e.g., admin note) */
-    reason: v.optional(v.string()),
-    /** Human-readable description */
-    description: v.optional(v.string()),
-    /** Request tracing ID */
-    requestId: v.optional(v.string()),
-
-    /** Additional context-specific metadata */
-    metadata: v.optional(v.any()),
-
-    /** ISO timestamp of when the action occurred */
-    createdAt: v.string(),
-    /** Concatenated searchable text for full-text search */
-    searchableText: v.optional(v.string()),
-}
-
-/**
- * Recommended indexes for the auditLogs table.
- */
-export const auditLogIndexes = {
-    by_entity: ['entityTable', 'entityId'] as const,
-    by_entityTable: ['entityTable'] as const,
-    by_action: ['action'] as const,
-    by_createdAt: ['createdAt'] as const,
-    search: {
-        searchField: 'searchableText' as const,
-        filterFields: ['entityTable', 'action'] as const,
-    },
-}

package/packages/convex/shared/src/audit/write.ts

@@ -1,102 +0,0 @@
-// @geenius-tools/convex-wrappers — src/audit/write.ts
-
-import type { AuditLogEntry } from '../types'
-
-/**
- * Generate searchable text from an audit log entry.
- * Concatenates key fields for full-text search indexing.
- */
-export function generateSearchableText(params: {
-    action?: string
-    table?: string
-    id?: string
-    title?: string
-    description?: string
-    reason?: string
-    actorName?: string
-    [key: string]: unknown
-}): string {
-    return [
-        params.action,
-        params.table,
-        params.id,
-        params.title,
-        params.description,
-        params.reason,
-        params.actorName,
-    ]
-        .filter(Boolean)
-        .join(' ')
-}
-
-/**
- * Write an audit log entry to the database.
- *
- * This is a generic helper — you pass in your Convex MutationCtx.
- * It auto-generates `createdAt` and `searchableText` if not provided.
- *
- * @example
- * ```ts
- * import { writeAudit } from '@geenius-tools/convex-wrappers'
- *
- * // Inside a Convex mutation:
- * await writeAudit(ctx, {
- *   actorId: user._id,
- *   role: 'admin',
- *   action: 'update',
- *   entityTable: 'orders',
- *   entityId: orderId,
- *   entityTitle: 'Order #123',
- *   beforeJson: JSON.stringify(before),
- *   afterJson: JSON.stringify(after),
- * })
- * ```
- */
-export async function writeAudit(
-    ctx: { db: { insert: (table: string, doc: Record<string, unknown>) => Promise<unknown> } },
-    entry: Omit<AuditLogEntry, 'createdAt'> & { createdAt?: string; searchableText?: string },
-): Promise<void> {
-    const createdAt = entry.createdAt ?? new Date().toISOString()
-
-    const searchableText =
-        entry.searchableText ??
-        generateSearchableText({
-            action: entry.action,
-            table: entry.entityTable,
-            id: entry.entityId,
-            title: entry.entityTitle,
-            description: entry.description,
-            reason: entry.reason,
-        })
-
-    await ctx.db.insert('auditLogs', {
-        ...entry,
-        createdAt,
-        searchableText,
-    })
-}
-
-/**
- * Compute a JSON diff between before and after objects.
- * Returns an object with only the changed fields.
- */
-export function computeDiff(
-    before: Record<string, unknown> | null | undefined,
-    after: Record<string, unknown> | null | undefined,
-): Record<string, { from: unknown; to: unknown }> {
-    const diff: Record<string, { from: unknown; to: unknown }> = {}
-    const allKeys = new Set([
-        ...Object.keys(before ?? {}),
-        ...Object.keys(after ?? {}),
-    ])
-
-    for (const key of allKeys) {
-        const fromVal = (before as Record<string, unknown>)?.[key]
-        const toVal = (after as Record<string, unknown>)?.[key]
-        if (JSON.stringify(fromVal) !== JSON.stringify(toVal)) {
-            diff[key] = { from: fromVal, to: toVal }
-        }
-    }
-
-    return diff
-}