{"id":41685,"library":"orm-firebird","title":"orm-firebird","description":"ORM for Firebird databases with a Sequelize-inspired API (models, Op, include, hooks, scopes, transactions). Current version 0.1.1 is an early release with limited adoption. The library is Node.js-only (no browser support), requires node-firebird driver, ships TypeScript declarations, and focuses on providing a familiar ORM pattern for Firebird developers. Release cadence is unclear; major breaking changes may occur in minor versions. Differentiator: targeted Firebird support with sequelize-like syntax, unlike generic SQL query builders.","status":"active","version":"0.1.1","language":"javascript","source_language":"en","source_url":"https://github.com/kenio/orius-firebird-node","tags":["javascript","firebird","orm","sequelize-like","typescript","nodejs"],"install":[{"cmd":"npm install orm-firebird","lang":"bash","label":"npm"},{"cmd":"yarn add orm-firebird","lang":"bash","label":"yarn"},{"cmd":"pnpm add orm-firebird","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Firebird native driver; required at runtime to connect to Firebird database servers.","package":"node-firebird","optional":false}],"imports":[{"note":"Named export; default export does not exist. In CommonJS, use destructuring with .OrmFirebird.","wrong":"const OrmFirebird = require('orm-firebird').OrmFirebird","symbol":"OrmFirebird","correct":"import { OrmFirebird } from 'orm-firebird'"},{"note":"Model is a named export, not a default export. CommonJS: const { Model } = require('orm-firebird').","wrong":"import Model from 'orm-firebird'","symbol":"Model","correct":"import { Model } from 'orm-firebird'"},{"note":"DataTypes is a named export. CommonJS: const { DataTypes } = require('orm-firebird').","wrong":"import DataTypes from 'orm-firebird'","symbol":"DataTypes","correct":"import { DataTypes } from 'orm-firebird'"}],"quickstart":{"code":"import { OrmFirebird, Model, DataTypes, syncOrmFirebird } from 'orm-firebird';\n\nconst orm = new OrmFirebird({\n  host: process.env.FB_HOST ?? '127.0.0.1',\n  port: parseInt(process.env.FB_PORT ?? '3050'),\n  database: process.env.FB_DATABASE ?? 'TEST',\n  user: process.env.FB_USER ?? 'SYSDBA',\n  password: process.env.FB_PASSWORD ?? 'masterkey',\n  encoding: 'UTF8',\n  maxPool: 5,\n  logging: false\n});\n\nclass User extends Model {}\nUser.init({\n  USER_ID: { type: DataTypes.BIGINT(), primaryKey: true, autoIncrement: true },\n  LOGIN: { type: DataTypes.STRING(60), allowNull: false },\n  EMAIL: { type: DataTypes.STRING(150), allowNull: true }\n}, {\n  sequelize: orm,\n  tableName: 'USERS'\n});\n\nasync function main() {\n  await orm.authenticate();\n  console.log('Connected.');\n  const result = await syncOrmFirebird(orm, { logging: false });\n  console.log('Sync complete:', result.createdTables);\n  await orm.close();\n}\nmain().catch(console.error);","lang":"typescript","description":"Complete example: connect to Firebird, define a model with DataTypes, synchronize schema, and handle errors."},"warnings":[{"fix":"Use 'maxPool' instead of 'poolSize' in the constructor config.","message":"OrmFirebird constructor options changed between 0.0.x and 0.1.0: 'poolSize' renamed to 'maxPool'.","severity":"breaking","affected_versions":"<0.1.0"},{"fix":"Use 'dryRun: true' to preview SQL before executing destructive operations.","message":"The 'syncOrmFirebird' function's 'force' option may drop and recreate tables; use with caution in production.","severity":"deprecated","affected_versions":">=0.1.0"},{"fix":"Pass { sequelize: orm } as the second argument to Model.init() instead of passing orm as a separate argument.","message":"Model.init() requires a 'sequelize' key in the second options object (the ORM instance), not a direct parameter.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Use named imports: import { OrmFirebird } from 'orm-firebird' instead of import OrmFirebird from 'orm-firebird'.","message":"Default export removed in 0.1.0; all exports are now named (OrmFirebird, Model, DataTypes, etc.).","severity":"breaking","affected_versions":">=0.1.0"}],"env_vars":null,"search_vec":"'0.1.1':22 'adopt':29 'api':13 'break':62 'browser':36 'builder':82 'cadenc':58 'chang':63 'current':20 'databas':7 'declar':45 'develop':56 'differenti':69 'driver':42 'earli':25 'familiar':51 'firebird':3,6,41,55,71,84 'focus':47 'generic':79 'hook':17 'includ':16 'inspir':12 'javascript':83 'librari':31 'like':76,88 'limit':28 'major':61 'may':64 'minor':67 'model':14 'node':40 'node-firebird':39 'node.js':33 'nodej':90 'occur':65 'op':15 'orm':2,4,52,85 'orm-firebird':1 'pattern':53 'provid':49 'queri':81 'releas':26,57 'requir':38 'scope':18 'sequel':11,75,87 'sequelize-inspir':10 'sequelize-lik':74,86 'ship':43 'sql':80 'support':37,72 'syntax':77 'target':70 'transact':19 'typescript':44,89 'unclear':60 'unlik':78 'version':21,68","created_at":"2026-06-04T18:53:36.804943+00:00","updated_at":"2026-06-04T18:53:36.804943+00:00","problems":[{"fix":"Run: npm install node-firebird","cause":"Missing required peer dependency 'node-firebird'.","error":"Error: Cannot find module 'node-firebird'"},{"fix":"Double-check Firebird server is running and credentials are correct. Use process.env variables for security.","cause":"Incorrect host, port, database, user, or password in OrmFirebird constructor.","error":"Error: Invalid database path or credentials"},{"fix":"Use: import { Model } from 'orm-firebird' (not import Model from 'orm-firebird')","cause":"Model imported incorrectly (likely default import instead of named).","error":"Error: Model.init is not a function"},{"fix":"Use: import { DataTypes } from 'orm-firebird' then DataTypes.BIGINT()","cause":"DataTypes imported incorrectly or used as default import.","error":"Error: Cannot read properties of undefined (reading 'BIGINT')"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/kenio/orius-firebird-node/blob/main/packages/orm/README.md","github":"https://github.com/kenio/orius-firebird-node","docs":null,"changelog":null,"pypi":null,"npm":"orm-firebird","openapi_spec":null,"status_page":null,"smithery":null,"categories":["database"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-04","next_check":"2026-09-02","install_tag":null}}