{"id":18640,"library":"orquestrador-database-code7","title":"Orquestrador Database Code7","description":"Configures, sets up database models and implements CRUD methods. Version 3.0.0-beta.0.2636 is a pre-release with beta stability, likely used in the Orchy stack. Release cadence is tied to the Orchy ecosystem, with frequent beta updates. Differentiator: opinionated database configuration for Code7's microservices architecture, models with built-in CRUD, and full TypeScript support. Not meant for general-purpose use, but for integrated systems within the Code7 platform.","status":"active","version":"3.0.0-beta.0.2636","language":"javascript","source_language":"en","source_url":"https://github.com/code7-xlab/orchy-database-code7","tags":["javascript","orchy-base","database","database configuration","typescript"],"install":[{"cmd":"npm install orquestrador-database-code7","lang":"bash","label":"npm"},{"cmd":"yarn add orquestrador-database-code7","lang":"bash","label":"yarn"},{"cmd":"pnpm add orquestrador-database-code7","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"ESM-only; CommonJS require will fail.","wrong":"const db = require('orquestrador-database-code7')","symbol":"orquestrador-database-code7","correct":"import { configureDatabase } from 'orquestrador-database-code7'"},{"note":"The correct export is `createModel`, not `Model`.","wrong":"import { Model } from 'orquestrador-database-code7'","symbol":"createModel","correct":"import { createModel } from 'orquestrador-database-code7'"},{"note":"DatabaseConfig is a TypeScript type, so use `import type`.","wrong":"import { DatabaseConfig } from 'orquestrador-database-code7'","symbol":"DatabaseConfig","correct":"import type { DatabaseConfig } from 'orquestrador-database-code7'"}],"quickstart":{"code":"import { configureDatabase, createModel, crudMethods } from 'orquestrador-database-code7';\n\nconst config = {\n  type: 'postgres',\n  host: process.env.DB_HOST ?? 'localhost',\n  port: Number(process.env.DB_PORT) ?? 5432,\n  username: process.env.DB_USER ?? 'user',\n  password: process.env.DB_PASS ?? 'pass',\n  database: process.env.DB_NAME ?? 'mydb',\n};\n\nconst db = configureDatabase(config);\nconst User = createModel('User', {\n  name: String,\n  email: String,\n});\n\nconst methods = crudMethods(User);\n\nasync function main() {\n  const user = await methods.create({ name: 'Jane', email: 'jane@example.com' });\n  const users = await methods.find({});\n  console.log(users);\n}\n\nmain();","lang":"typescript","description":"Configures a Postgres database, creates a User model with CRUD methods, then creates and fetches records."},"warnings":[{"fix":"Migrate to version 3.x: update imports and use `configureDatabase` instead of `setupDatabase`.","message":"Version 2.x API is deprecated. Upgrade to 3.x beta for new API.","severity":"deprecated","affected_versions":">=2.0.0 <3.0.0"},{"fix":"Replace `import { setupDatabase }` with `import { configureDatabase }` and adjust parameters.","message":"`setupDatabase` renamed to `configureDatabase` in v3.0.0-beta.","severity":"breaking","affected_versions":">=3.0.0-beta"},{"fix":"Always explicitly set environment variables or use a config object with validation.","message":"The package expects environment variables; missing DB_HOST causes silent fallback to localhost which may not be intended.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"After v4, call `User.create()` and `User.find()` directly instead of using `crudMethods`.","message":"`crudMethods` will be removed in v4; use model instance methods directly.","severity":"deprecated","affected_versions":">=3.0.0-beta <4.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run `npm install orquestrador-database-code7@beta` and ensure import path is correct.","cause":"Package not installed or typo in require/import.","error":"Error: Cannot find module 'orquestrador-database-code7'"},{"fix":"Use `import { configureDatabase } from 'orquestrador-database-code7'` instead of `import configureDatabase from ...`.","cause":"Incorrect import: using named import as default.","error":"TypeError: db.configureDatabase is not a function"},{"fix":"Ensure you pass a config object with valid `host`, `port`, etc., or set environment variables DB_HOST, DB_PORT, DB_USER, DB_PASS, DB_NAME.","cause":"Missing database configuration object or environment variable.","error":"TypeError: Cannot read properties of undefined (reading 'host')"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}