zeti-framework-backend 0.2.4

package/dist/scripts/index.d.ts

@@ -0,0 +1,34 @@
+import { a as ZetiConfigInternal } from '../config-VWgz0Iq_.js';
+import 'hono';
+import 'ioredis';
+import 'hono/http-exception';
+
+interface GenerateRegistryOptions {
+    controllersPath: string;
+    indexPath: string;
+    startMarker?: string;
+    endMarker?: string;
+    /** Se true, escreve apenas os imports no arquivo (para .zeti/registry.ts) */
+    outputMode?: 'inject' | 'standalone';
+}
+declare function generateRegistry(options: GenerateRegistryOptions): Promise<void>;
+
+interface GenerateSwaggerTypesOptions {
+    controllersPath: string;
+    outputPath: string;
+}
+declare function generateSwaggerTypes(options: GenerateSwaggerTypesOptions): Promise<void>;
+
+interface RunPrebuildOptions {
+    projectRoot?: string;
+    zetiConfig?: ZetiConfigInternal;
+    controllersPath?: string;
+    registryPath?: string;
+    swaggerOutputPath?: string;
+    prismaImport?: string;
+    /** Forçar regeneração mesmo se não houver mudanças */
+    force?: boolean;
+}
+declare function runPrebuild(options?: RunPrebuildOptions): Promise<void>;
+
+export { type GenerateRegistryOptions, type GenerateSwaggerTypesOptions, type RunPrebuildOptions, generateRegistry, generateSwaggerTypes, runPrebuild };

package/dist/scripts/index.js

@@ -0,0 +1,12 @@
+import {
+  generateRegistry,
+  generateSwaggerTypes,
+  runPrebuild
+} from "../chunk-KIOZSPU2.js";
+import "../chunk-7D4SUZUM.js";
+export {
+  generateRegistry,
+  generateSwaggerTypes,
+  runPrebuild
+};
+//# sourceMappingURL=index.js.map

package/dist/scripts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/swagger/index.d.ts

@@ -0,0 +1,10 @@
+export { S as SwaggerGeneratorOptions, a as SwaggerRegistry, g as generateSwagger } from '../generator-CK-ZmWQj.js';
+import { ZodTypeAny } from 'zod';
+import 'hono';
+import '../config-VWgz0Iq_.js';
+import 'ioredis';
+import 'hono/http-exception';
+
+declare function zodToJsonSchema(schema: ZodTypeAny): any;
+
+export { zodToJsonSchema };

package/dist/swagger/index.js

@@ -0,0 +1,14 @@
+import {
+  SwaggerRegistry
+} from "../chunk-K2E6XKVB.js";
+import {
+  generateSwagger,
+  zodToJsonSchema
+} from "../chunk-TTILJJ3O.js";
+import "../chunk-7D4SUZUM.js";
+export {
+  SwaggerRegistry,
+  generateSwagger,
+  zodToJsonSchema
+};
+//# sourceMappingURL=index.js.map

package/dist/swagger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/tenants/index.d.ts

@@ -0,0 +1,146 @@
+import { Context } from 'hono';
+import { h as ZetiDatabaseConfig, m as ZetiPrismaConfig, b as ZetiPrismaConnectionConfig, T as TenantSelection, C as ConnectionStrategy } from '../config-VWgz0Iq_.js';
+import 'ioredis';
+import 'hono/http-exception';
+
+interface TenantMetrics {
+    totalTenants: number;
+    activeConnections: number;
+    cachedConnections: number;
+    connectionPoolSize: number;
+    cacheHits: number;
+    cacheMisses: number;
+    errors: number;
+    lastCleanup?: Date;
+    uptime: number;
+}
+declare class MetricsCollector {
+    private metrics;
+    private startTime;
+    private cacheHitCount;
+    private cacheMissCount;
+    private errorCount;
+    incrementCacheHit(): void;
+    incrementCacheMiss(): void;
+    incrementError(): void;
+    updateMetrics(data: {
+        totalTenants?: number;
+        activeConnections?: number;
+        cachedConnections?: number;
+        connectionPoolSize?: number;
+        lastCleanup?: Date;
+    }): void;
+    getMetrics(): TenantMetrics;
+    reset(): void;
+}
+
+/**
+ * TenantManager com suporte a Modos de Operação (single/dynamic)
+ *
+ * Características:
+ * - Cache por URL (hash MD5) para reutilizar instâncias base
+ * - Detecção automática de models com tenantId via DMMF
+ * - $extends leve aplicado por request (sem cache)
+ * - Suporte a workers (sem Context do Hono)
+ */
+declare class TenantManager {
+    private readonly MAX_RECOMMENDED_DATABASES;
+    private databaseConnections;
+    private specialDatabases;
+    private baseClients;
+    private clients;
+    private modelFieldsCache;
+    private config;
+    private databaseConfig;
+    private prismaConnectionConfig?;
+    private metrics;
+    private cleanupInterval?;
+    constructor(databaseConfig: ZetiDatabaseConfig, prismaConfig: ZetiPrismaConfig, specialDatabases?: Record<string, string>, prismaConnectionConfig?: ZetiPrismaConnectionConfig);
+    /**
+     * Obtém cliente contextual baseado na estratégia de conexão.
+     *
+     * Suporta duas formas de definir escopo de segurança:
+     * 1. Via `tenantSelector` no config (modo dynamic)
+     * 2. Via `context.set('securityScope', scope)` no middleware
+     *
+     * O securityScope do middleware tem PRIORIDADE sobre o tenantSelector.
+     *
+     * @param context - Context do Hono (request)
+     * @returns PrismaClient com ou sem $extends de segurança
+     */
+    getContextualClient(context: Context): Promise<any>;
+    /**
+     * Obtém cliente para workers (sem Context do Hono).
+     *
+     * @param selection - TenantSelection manual
+     * @returns PrismaClient com ou sem $extends de tenant
+     */
+    getClientForWorker(selection?: TenantSelection): any;
+    /**
+     * Obtém cliente base (sem extensões de segurança).
+     * Usado pelo middleware global para disponibilizar db aos middlewares do usuário.
+     *
+     * @returns PrismaClient base
+     */
+    getBaseClient(): Promise<any>;
+    /**
+     * Obtém ou cria cliente base cacheado por URL.
+     *
+     * @param url - Connection string do banco
+     * @returns PrismaClient base (sem extensions)
+     */
+    getOrCreateBaseClient(url: string): any;
+    /**
+     * Aplica $extends com VALIDAÇÃO de campos de segurança.
+     *
+     * Esta abordagem:
+     * - VALIDA que o campo passado é igual ao do escopo de segurança
+     * - Adiciona o campo ao WHERE em queries de leitura (filtro de segurança)
+     * - FALHA se o campo não for passado ou for diferente em create/update
+     *
+     * Isso garante que:
+     * 1. O desenvolvedor sempre passa explicitamente o campo
+     * 2. Não é possível acessar/modificar dados de outro contexto
+     *
+     * @param baseClient - Cliente Prisma base
+     * @param scopeFields - Campos do escopo de segurança (ex: { tenantId: 'abc', productId: 'xyz' })
+     * @param urlHash - Hash da URL do banco para cache de campos
+     */
+    private applySecurityExtension;
+    /**
+     * Detecta todos os campos de cada model via DMMF.
+     * Resultado é cacheado por URL hash.
+     *
+     * Isso permite validação genérica de qualquer campo retornado pelo tenantSelector.
+     */
+    private detectModelFields;
+    /**
+     * Gera hash MD5 da URL para usar como chave de cache.
+     * Isso evita expor credenciais em logs.
+     */
+    private hashUrl;
+    /**
+     * Modo legado - usa lógica antiga baseada em databaseId.
+     */
+    private getLegacyClient;
+    private startCleanupInterval;
+    private cleanupExpiredConnections;
+    private cleanupCache;
+    getMetrics(): TenantMetrics;
+    getTenantDatabase(databaseId: string): Promise<any>;
+    getSpecialDatabase(key: string): any;
+    private getOrCreateClient;
+    isValidDatabase(databaseId: string): boolean;
+    getAllDatabases(): string[];
+    /**
+     * Retorna a estratégia de conexão configurada.
+     */
+    getConnectionStrategy(): ConnectionStrategy;
+    /**
+     * Verifica se está usando o novo modo de operação.
+     */
+    isUsingConnectionConfig(): boolean;
+    shutdown(): Promise<void>;
+}
+
+export { MetricsCollector, TenantManager, type TenantMetrics };

package/dist/tenants/index.js

@@ -0,0 +1,10 @@
+import {
+  MetricsCollector,
+  TenantManager
+} from "../chunk-LCNZVWVO.js";
+import "../chunk-7D4SUZUM.js";
+export {
+  MetricsCollector,
+  TenantManager
+};
+//# sourceMappingURL=index.js.map

package/dist/tenants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "zeti-framework-backend",
+  "version": "0.2.4",
+  "description": "Framework Hono com suporte a multi-tenancy, Prisma e Swagger automático",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "zeti": "./dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./swagger": {
+      "import": "./dist/swagger/index.js",
+      "types": "./dist/swagger/index.d.ts"
+    },
+    "./tenants": {
+      "import": "./dist/tenants/index.js",
+      "types": "./dist/tenants/index.d.ts"
+    },
+    "./scripts": {
+      "import": "./dist/scripts/index.js",
+      "types": "./dist/scripts/index.d.ts"
+    },
+    "./cli": {
+      "import": "./dist/cli/index.js",
+      "types": "./dist/cli/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "test:types": "tsc -p tsconfig.typing-tests.json"
+  },
+  "keywords": [
+    "hono",
+    "prisma",
+    "multi-tenant",
+    "swagger",
+    "typescript",
+    "framework"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@hono/node-server": "^1.12.0",
+    "@hono/swagger-ui": "^0.4.0",
+    "@hono/zod-openapi": "^1.2.0",
+    "@prisma/adapter-pg": "^7.2.0",
+    "@hono/zod-validator": "^0.4.0",
+    "dotenv": "^16.4.5",
+    "zod": "^3.23.0",
+    "pg": "^8.17.1",
+    "fast-glob": "^3.3.2"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^25.0.9",
+    "@types/pg": "^8.16.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "@prisma/client": "^7.0.0",
+    "hono": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@prisma/client": {
+      "optional": false
+    },
+    "hono": {
+      "optional": false
+    }
+  }
+}