This is a helper package for pgsql-parser
. it provides getEnum
function, and contains the Postgres Enums as JSON baked into the package
pgsql-enums
is a utility package designed to support pgsql-parser
by providing easy access to PostgreSQL enumeration types in JSON format. This package facilitates the conversion between string and integer representations of PostgreSQL enums, enhancing the usability of ASTs generated by pgsql-parser
.
NOTE: This is the legacy library for helpers and enums for pgsql-parser
, created long before pg-proto-parser was developed. The plan is to gradually deprecate this library and transition towards using @pgsql/enums
and @pgsql/utils
for more modern and efficient PostgreSQL parsing and utility functions.
- Enum Conversion: Offers functions to convert PostgreSQL enums from string to integer and vice versa.
- Predefined Enums: Contains predefined JSON mappings for PostgreSQL enums, readily accessible for use in your projects.
- Easy Integration: Designed to work seamlessly with
pgsql-parser
, simplifying the handling of enum values in the AST.
npm install pgsql-enums
import { toInt, toStr } from 'pgsql-enums';
const str = toStr['A_Expr_Kind']['10']; // Returns the string representation of the enum value 10
const num = toInt['A_Expr_Kind']['AEXPR_LIKE']; // Returns the numeric representation of the enum value 'AEXPR_LIKE'
Enums are provided in two JSON structures: one for converting from string to integer and another for converting from integer to string.
{
"A_Expr_Kind": {
"AEXPR_OP": 0,
"AEXPR_OP_ANY": 1,
...
}
}
{
"A_Expr_Kind": {
"0": "AEXPR_OP",
"1": "AEXPR_OP_ANY",
...
}
}
A constant object mapping PostgreSQL internal object type identifiers to their readable names. Use this to convert type codes into human-readable format.
import { TYPE_NAMES } from 'pgsql-enums';
console.log(TYPE_NAMES.OBJECT_TABLE); // Outputs 'TABLE'
console.log(TYPE_NAMES.OBJECT_INDEX); // Outputs 'INDEX'
console.log(TYPE_NAMES.OBJECT_VIEW); // Outputs 'VIEW'
import { objtypeName } from 'pgsql-enums';
console.log(objtypeName('OBJECT_TABLE')); // Outputs 'TABLE'
console.log(objtypeName('OBJECT_INDEX')); // Outputs 'INDEX'
console.log(objtypeName('OBJECT_VIEW')); // Outputs 'VIEW'
import { getConstraintFromConstrType } from 'pgsql-enums';
console.log(getConstraintFromConstrType('CONSTR_PRIMARY')); // Outputs 'PRIMARY KEY'
console.log(getConstraintFromConstrType('CONSTR_UNIQUE')); // Outputs 'UNIQUE'
console.log(getConstraintFromConstrType('CONSTR_CHECK')); // Outputs 'CHECK'
- pgsql-parser: The real PostgreSQL parser for Node.js, providing symmetric parsing and deparsing of SQL statements with actual PostgreSQL parser integration.
- pgsql-deparser: A streamlined tool designed for converting PostgreSQL ASTs back into SQL queries, focusing solely on deparser functionality to complement
pgsql-parser
. - pgsql-enums: A utility package offering easy access to PostgreSQL enumeration types in JSON format, aiding in string and integer conversions of enums used within ASTs to compliment
pgsql-parser
- @pgsql/enums: Provides PostgreSQL AST enums in TypeScript, enhancing type safety and usability in projects interacting with PostgreSQL AST nodes.
- @pgsql/types: Offers TypeScript type definitions for PostgreSQL AST nodes, facilitating type-safe construction, analysis, and manipulation of ASTs.
- @pgsql/utils: A comprehensive utility library for PostgreSQL, offering type-safe AST node creation and enum value conversions, simplifying the construction and manipulation of PostgreSQL ASTs.
- pg-proto-parser: A TypeScript tool that parses PostgreSQL Protocol Buffers definitions to generate TypeScript interfaces, utility functions, and JSON mappings for enums.
- libpg-query: The real PostgreSQL parser exposed for Node.js, used primarily in
pgsql-parser
for parsing and deparsing SQL queries.
AS DESCRIBED IN THE LICENSES, THE SOFTWARE IS PROVIDED “AS IS”, AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND.
No developer or entity involved in creating Software will be liable for any claims or damages whatsoever associated with your use, inability to use, or your interaction with other users of the Software code or Software CLI, including any direct, indirect, incidental, special, exemplary, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens, or anything else of value.