ts-prorm-orm 1.1.0 → 1.2.0

package/dist/decorators/hstore.d.ts

@@ -0,0 +1,96 @@
+/**
+ * HStore Decorator for the ORM
+ *
+ * Provides PostgreSQL HStore key-value type support.
+ * Requires: CREATE EXTENSION IF NOT EXISTS hstore
+ *
+ * Usage:
+ *
+ *   // Basic HStore column
+ *   @HStore()
+ *   attributes: Record<string, string>;
+ *
+ *   // With options
+ *   @HStore({ allowNull: false })
+ *   metadata: Record<string, any>;
+ */
+/**
+ * Options for HStore column type
+ */
+export interface HStoreDecoratorOptions {
+    /** Whether to use native HStore or JSONB fallback */
+    useNative?: boolean;
+    /** Whether the column allows null */
+    allowNull?: boolean;
+    /** Default value for the column */
+    defaultValue?: Record<string, any>;
+    /** Comment for the column */
+    comment?: string;
+    /** Custom column name in the database */
+    field?: string;
+}
+/**
+ * Metadata stored on the property
+ */
+export interface HStoreMetadata {
+    options: HStoreDecoratorOptions;
+}
+/**
+ * HStore decorator for PostgreSQL HStore columns
+ *
+ * @param options - Optional HStore column options
+ *
+ * @example
+ * // Basic HStore column
+ * class Product extends Model {
+ *   @HStore()
+ *   attributes: Record<string, string>;
+ * }
+ *
+ * // With options
+ * class Product extends Model {
+ *   @HStore({ allowNull: false })
+ *   metadata: Record<string, any>;
+ * }
+ */
+export declare function HStore(options?: HStoreDecoratorOptions): PropertyDecorator;
+/**
+ * Get HStore metadata for a property
+ *
+ * @param target - The target class
+ * @param propertyKey - The property name
+ * @returns HStore metadata or undefined if not found
+ */
+export declare function getHStoreMetadata(target: object, propertyKey: string | symbol): HStoreMetadata | undefined;
+/**
+ * Get all HStore metadata for a class
+ *
+ * @param target - The target class
+ * @returns Map of property names to HStore metadata
+ */
+export declare function getAllHStoreMetadata(target: object): Map<string, HStoreMetadata>;
+/**
+ * Check if a property is an HStore column
+ *
+ * @param target - The target class
+ * @param propertyKey - The property name
+ * @returns True if the property is an HStore column
+ */
+export declare function isHStoreColumn(target: object, propertyKey: string | symbol): boolean;
+/**
+ * Clear HStore metadata (useful for testing)
+ */
+export declare function clearHStoreMetadata(): void;
+/**
+ * Get the SQL to create the HStore extension
+ *
+ * @returns SQL to create the hstore extension
+ */
+export declare function getHStoreExtensionSQL(): string;
+/**
+ * Build the default value SQL for HStore
+ *
+ * @param defaultValue - The default value object
+ * @returns SQL for the default value
+ */
+export declare function buildHStoreDefaultSQL(defaultValue?: Record<string, any>): string | undefined;

package/dist/decorators/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * TypeScript Decorators / Annotations for ts-prorm-orm
+ *
+ * Exports all decorator utilities organized by category:
+ *
+ *  Encryption  — @Secure / @SecureField for password hashing
+ *  Procedures  — @Procedure / @SqlFunction for stored procedures & SQL functions
+ *  Views       — @View for mapping a Model class to a database view
+ *  Permissions — @CanView / @CannotView / @Permission / @CanWrite / @CannotWrite
+ */
+export { Secure, SecureField, setEncryptionAdapter, getEncryptionAdapter, hashSecureFields, verifySecureField, applySecureHooks, getSecureFields, createBcryptAdapter, createArgon2Adapter, } from './encryption';
+export type { EncryptionAdapter, SecureOptions, SecureFieldMeta } from './encryption';
+export { Procedure, SqlFunction, ProcedureRegistry } from './procedure';
+export type { ProcedureOptions, SqlFunctionOptions, ProcedureParam, ProcedureParamMode, } from './procedure';
+export { View, ViewRegistry, getViewOptions, MaterializedView, MaterializedViewRegistry, getMaterializedViewOptions, } from './view';
+export type { ViewOptions, MaterializedViewDecoratorOptions, RefreshStrategy } from './view';
+export { Engine, EngineRegistry, getEngineOptions } from './engine';
+export type { EngineOptions } from './engine';
+export { CanView, CannotView, CanWrite, CannotWrite, Permission, PermissionRegistry, canViewField, canWriteField, getAllowedAttributes, filterByPermissions, filterWriteByPermissions, withPermissions, } from './permissions';
+export type { PermissionRule, PermissionOptions } from './permissions';
+export { Check, CheckColumn, CheckTable, operatorToSQL, getCheckConstraints, getTableCheckConstraints, getAllCheckConstraints, buildCheckConstraintSQL, buildAllCheckConstraints, clearCheckConstraints, } from './check';
+export type { CheckOperator, CheckConstraintOptions, CheckColumnOptions, CheckTableOptions, FieldCheckConstraint, RowCheckConstraint, StoredCheckConstraint, } from './check';
+export { Generated, Identity, getGeneratedMetadata, getIdentityMetadata, getAllGeneratedMetadata, getAllIdentityMetadata, isGeneratedColumn, isIdentityColumn, buildGeneratedSQL, isStored, } from './generated';
+export type { GeneratedOptions, GeneratedMetadata, GeneratedType } from './generated';
+export { ForeignKeyChecks, DatabaseSetting, getForeignKeyChecksSetting, getDatabaseSettings, isForeignKeyChecksDisabled, getAllDatabaseSettings, generateSettingsSQL, createSettingsContext, } from './database-settings';
+export type { ForeignKeyChecksOptions, DatabaseSettingOptions, ModelDatabaseSettings, DatabaseSettingValue, } from './database-settings';
+export { CollateEnum, Collate, Locale } from './collate';
+export type { CollateType, LocaleType, DatabaseOptions, CollateOptions, TableCollateOptions, OrderByOptions, } from './collate';
+export { Database, TableCollate, OrderBy, SetCollate, getCollateMetadata, getColumnCollate, getDatabaseOptions, getTableCollateOptions, getOrderByOptions, generateCreateDatabaseSQL, generateAlterTableCollateSQL, generateColumnCollateSQL, clearCollateMetadata, } from './collate';
+export { ORMDecorators, ALL_DECORATORS, MODEL_DECORATORS, CONSTRAINT_DECORATORS, ASSOCIATION_DECORATORS, HOOK_DECORATORS, VALIDATION_DECORATORS, POSTGRES_DECORATORS, SETTINGS_DECORATORS, } from './orm-decorators';
+export type { ORMDecoratorName } from './orm-decorators';
+export { Comment, CommentRegistry, getTableComment, getFieldComment, getAllFieldComments, setIndexComment, getIndexComment, getAllIndexComments, setConstraintComment, getConstraintComment, getAllConstraintComments, generateCommentSQL, generateIndexCommentSQL, generateConstraintCommentSQL, } from './comment';
+export type { CommentOptions } from './comment';
+export { Default, getDefaultFields, getDefaultForField, toPrormDefault, applyDefaultValues, applyDefaultHooks, uuidDefault, nowDefault, randomIntDefault, computedDefault, } from './default';
+export type { DefaultValueOptions, DefaultStaticValue, DefaultFunction, DefaultSequence, DefaultDatabaseFn, DefaultLiteral, DefaultFieldMeta, } from './default';
+export { Timezone, Timezone as TimezoneEnum, setTimezoneContext, getTimezoneContext, clearTimezoneContext, resolveTimezoneFromContext, convertToTimezone, convertFromTimezone, formatDateTimezone, parseDate, convertOnRead, convertOnWrite, applyTimezoneToQuery, convertWhereToTimezone, getEffectiveTimezone, getTimezoneFields, getTimezoneForField, getTableTimezone, getDefaultTimezone, getAllTimezoneFields, convertInstanceOnRead, convertInstanceOnWrite, applyTimezoneHooks, } from './timezone';
+export type { TimezoneOptions, TableTimezoneOptions, TimezoneFieldMeta, TimezoneContext, TimezoneFormat, TimezoneStoreAs, TimezoneSource, } from './timezone';
+export { OnDelete, OnUpdate, References, Deferrable, Unique, AutoIncrement, Identity as IdentityDecorator, GeneratedAlways, Exclusion, getForeignKeyMetadata, getAllForeignKeyMetadata, getUniqueMetadata, getAllUniqueMetadata, getAutoIncrementMetadata, getAllAutoIncrementMetadata, getIdentityMetadata as getIdentityMetadataForeignKey, getAllIdentityMetadata as getAllIdentityMetadataForeignKey, getGeneratedAlwaysMetadata, getAllGeneratedAlwaysMetadata, getExclusionMetadata, getAllExclusionMetadata, buildOnDeleteSQL, buildOnUpdateSQL, buildReferencesSQL, buildDeferrableSQL, buildAutoIncrementSQL, buildIdentitySQL, buildGeneratedAlwaysSQL, buildExclusionSQL, } from './fk-constraints';
+export type { ForeignKeyAction, DeferrableType, IdentityType, ReferencesOptions, DeferrableOptions, AutoIncrementOptions, IdentityOptions, GeneratedAlwaysOptions, ExclusionOptions, ForeignKeyMetadata, UniqueMetadata, AutoIncrementMetadata, IdentityMetadata, GeneratedAlwaysMetadata, ExclusionMetadata, } from './fk-constraints';
+export { Storage, Tablespace, TablespaceOptions as TablespaceOptionsFn, Clustered, Compression, ReplicaIdentity, Statistics, OnCommit, Inherits, ColumnStorage, getStorageOptions, getTablespaceOptions, getClusteredOptions, getCompressionOptions, getReplicaIdentityOptions, getStatisticsOptions, getOnCommitOption, getInheritsOptions, getColumnStorageOptions, generateStorageSQL, generateTablespaceSQL, generateClusteredSQL, generateCompressionSQL, generateReplicaIdentitySQL, generateStatisticsSQL, generateInheritsSQL, Partition, getPartitionOptions, generatePartitionSQL, generatePartitionBoundSQL, } from './storage';
+export type { StorageOptions, StorageEngine, RowFormat, TablespaceOptions, ClusteredOptions, ClusterType, CompressionOptions, CompressionAlgorithm, ReplicaIdentityOptions, ReplicaIdentityType, StatisticsOptions, OnCommitOption, InheritsOptions, ColumnStorageOptions, } from './storage';
+export { UseIndex, ForceIndex, IgnoreIndex, Tablesample, Distinct, DistinctOn, WithLock, StatementTimeout, IdleInTransactionTimeout, Cursor, Fetch, FetchWith, getQueryHints, getLockOptions, getStatementTimeout, getIdleInTransactionTimeout, getCursorOptions, getFetchOptions, getDistinctOnColumns, getTablesampleOptions, isDistinctEnabled, generateIndexHintSQL, generateLockSQL, generateStatementTimeoutSQL, generateIdleInTransactionTimeoutSQL, generateTablesampleSQL, generateDistinctOnSQL, generateCursorSQL, } from './query-options';
+export type { WithLockOptions, LockMode, StatementTimeoutOptions, IdleInTransactionTimeoutOptions, CursorOptions, CursorHoldable, TablesampleOptions, TablesampleMethod, IndexHintOptions, QueryHintType, QueryOptions, } from './query-options';
+export { Spatial, getSpatialMetadata, getAllSpatialMetadata, isSpatialColumn, generateSpatialIndexSQL, } from './spatial';
+export type { SpatialMetadata } from './spatial';
+export { JSONColumn, getJSONColumnMetadata, getAllJSONColumnMetadata, isJSONColumn, generateJSONExtractSQL, generateJSONSetSQL, generateJSONRemoveSQL, } from './json-column';
+export type { JSONColumnMetadata } from './json-column';
+export { SetColumn, SetColumnWithOptions, getSetColumnMetadata, getAllSetColumnMetadata, isSetColumn, generateSetFindInSetSQL, } from './set-column';
+export type { SetColumnMetadata } from './set-column';
+export { UUID, getUUIDMetadata, getAllUUIDMetadata, isUUIDColumn, clearUUIDMetadata, getUUIDExtensionSQL, buildUUIDDefaultSQL, } from './uuid';
+export type { UUIDDecoratorOptions, UUIDMetadata } from './uuid';
+export { JSONB, getJSONBMetadata, getAllJSONBMetadata, isJSONBColumn, clearJSONBMetadata, } from './jsonb';
+export type { JSONBDecoratorOptions, JSONBMetadata } from './jsonb';
+export { HStore, getHStoreMetadata, getAllHStoreMetadata, isHStoreColumn, clearHStoreMetadata, getHStoreExtensionSQL, buildHStoreDefaultSQL, } from './hstore';
+export type { HStoreDecoratorOptions, HStoreMetadata } from './hstore';
+export { Range, getRangeMetadata, getAllRangeMetadata, isRangeColumn, clearRangeMetadata, buildRangeLiteral, getRangeContainedBySQL, getRangeOverlapSQL, } from './range';
+export type { RangeSubtype, RangeDecoratorOptions, RangeMetadata } from './range';

package/dist/decorators/index.js

@@ -10,12 +10,12 @@
  *  Permissions — @CanView / @CannotView / @Permission / @CanWrite / @CannotWrite
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.processBelongsToManyDecorators = exports.getAllBelongsToMany = exports.getBelongsToMany = exports.BelongsToMany = exports.processBelongsToDecorators = exports.getAllBelongsTo = exports.getBelongsTo = exports.BelongsTo = exports.processHasOneDecorators = exports.getAllHasOne = exports.getHasOne = exports.HasOne = exports.processHasManyDecorators = exports.getAllHasMany = exports.getHasMany = exports.HasMany = exports.withPermissions = exports.filterWriteByPermissions = exports.filterByPermissions = exports.getAllowedAttributes = exports.canWriteField = exports.canViewField = exports.PermissionRegistry = exports.Permission = exports.CannotWrite = exports.CanWrite = exports.CannotView = exports.CanView = exports.getEngineOptions = exports.EngineRegistry = exports.Engine = exports.getMaterializedViewOptions = exports.MaterializedViewRegistry = exports.MaterializedView = exports.getViewOptions = exports.ViewRegistry = exports.View = exports.ProcedureRegistry = exports.SqlFunction = exports.Procedure = exports.createArgon2Adapter = exports.createBcryptAdapter = exports.getSecureFields = exports.applySecureHooks = exports.verifySecureField = exports.hashSecureFields = exports.getEncryptionAdapter = exports.setEncryptionAdapter = exports.SecureField = exports.Secure = void 0;
-exports.HOOK_DECORATORS = exports.ASSOCIATION_DECORATORS = exports.CONSTRAINT_DECORATORS = exports.MODEL_DECORATORS = exports.ALL_DECORATORS = exports.ORMDecorators = exports.clearCollateMetadata = exports.generateColumnCollateSQL = exports.generateAlterTableCollateSQL = exports.generateCreateDatabaseSQL = exports.getOrderByOptions = exports.getTableCollateOptions = exports.getDatabaseOptions = exports.getColumnCollate = exports.getCollateMetadata = exports.SetCollate = exports.OrderBy = exports.TableCollate = exports.Database = exports.Locale = exports.Collate = exports.CollateEnum = exports.createSettingsContext = exports.generateSettingsSQL = exports.getAllDatabaseSettings = exports.isForeignKeyChecksDisabled = exports.getDatabaseSettings = exports.getForeignKeyChecksSetting = exports.DatabaseSetting = exports.ForeignKeyChecks = exports.isStored = exports.buildGeneratedSQL = exports.isIdentityColumn = exports.isGeneratedColumn = exports.getAllIdentityMetadata = exports.getAllGeneratedMetadata = exports.getIdentityMetadata = exports.getGeneratedMetadata = exports.Identity = exports.Generated = exports.clearCheckConstraints = exports.buildAllCheckConstraints = exports.buildCheckConstraintSQL = exports.getAllCheckConstraints = exports.getTableCheckConstraints = exports.getCheckConstraints = exports.operatorToSQL = exports.CheckTable = exports.CheckColumn = exports.Check = void 0;
-exports.applyTimezoneHooks = exports.convertInstanceOnWrite = exports.convertInstanceOnRead = exports.getAllTimezoneFields = exports.getDefaultTimezone = exports.getTableTimezone = exports.getTimezoneForField = exports.getTimezoneFields = exports.getEffectiveTimezone = exports.convertWhereToTimezone = exports.applyTimezoneToQuery = exports.convertOnWrite = exports.convertOnRead = exports.parseDate = exports.formatDateTimezone = exports.convertFromTimezone = exports.convertToTimezone = exports.resolveTimezoneFromContext = exports.clearTimezoneContext = exports.getTimezoneContext = exports.setTimezoneContext = exports.TimezoneEnum = exports.Timezone = exports.computedDefault = exports.randomIntDefault = exports.nowDefault = exports.uuidDefault = exports.applyDefaultHooks = exports.applyDefaultValues = exports.toPrormDefault = exports.getDefaultForField = exports.getDefaultFields = exports.Default = exports.generateConstraintCommentSQL = exports.generateIndexCommentSQL = exports.generateCommentSQL = exports.getAllConstraintComments = exports.getConstraintComment = exports.setConstraintComment = exports.getAllIndexComments = exports.getIndexComment = exports.setIndexComment = exports.getAllFieldComments = exports.getFieldComment = exports.getTableComment = exports.CommentRegistry = exports.Comment = exports.SETTINGS_DECORATORS = exports.POSTGRES_DECORATORS = exports.VALIDATION_DECORATORS = void 0;
-exports.generateTablespaceSQL = exports.generateStorageSQL = exports.getColumnStorageOptions = exports.getInheritsOptions = exports.getOnCommitOption = exports.getStatisticsOptions = exports.getReplicaIdentityOptions = exports.getCompressionOptions = exports.getClusteredOptions = exports.getTablespaceOptions = exports.getStorageOptions = exports.ColumnStorage = exports.Inherits = exports.OnCommit = exports.Statistics = exports.ReplicaIdentity = exports.Compression = exports.Clustered = exports.TablespaceOptionsFn = exports.Tablespace = exports.Storage = exports.buildExclusionSQL = exports.buildGeneratedAlwaysSQL = exports.buildIdentitySQL = exports.buildAutoIncrementSQL = exports.buildDeferrableSQL = exports.buildReferencesSQL = exports.buildOnUpdateSQL = exports.buildOnDeleteSQL = exports.getAllExclusionMetadata = exports.getExclusionMetadata = exports.getAllGeneratedAlwaysMetadata = exports.getGeneratedAlwaysMetadata = exports.getAllIdentityMetadataForeignKey = exports.getIdentityMetadataForeignKey = exports.getAllAutoIncrementMetadata = exports.getAutoIncrementMetadata = exports.getAllUniqueMetadata = exports.getUniqueMetadata = exports.getAllForeignKeyMetadata = exports.getForeignKeyMetadata = exports.Exclusion = exports.GeneratedAlways = exports.IdentityDecorator = exports.AutoIncrement = exports.Unique = exports.Deferrable = exports.References = exports.OnUpdate = exports.OnDelete = void 0;
-exports.SetColumn = exports.generateJSONRemoveSQL = exports.generateJSONSetSQL = exports.generateJSONExtractSQL = exports.isJSONColumn = exports.getAllJSONColumnMetadata = exports.getJSONColumnMetadata = exports.JSONColumn = exports.generateSpatialIndexSQL = exports.isSpatialColumn = exports.getAllSpatialMetadata = exports.getSpatialMetadata = exports.Spatial = exports.generateCursorSQL = exports.generateDistinctOnSQL = exports.generateTablesampleSQL = exports.generateIdleInTransactionTimeoutSQL = exports.generateStatementTimeoutSQL = exports.generateLockSQL = exports.generateIndexHintSQL = exports.isDistinctEnabled = exports.getTablesampleOptions = exports.getDistinctOnColumns = exports.getFetchOptions = exports.getCursorOptions = exports.getIdleInTransactionTimeout = exports.getStatementTimeout = exports.getLockOptions = exports.getQueryHints = exports.FetchWith = exports.Fetch = exports.Cursor = exports.IdleInTransactionTimeout = exports.StatementTimeout = exports.WithLock = exports.DistinctOn = exports.Distinct = exports.Tablesample = exports.IgnoreIndex = exports.ForceIndex = exports.UseIndex = exports.generatePartitionBoundSQL = exports.generatePartitionSQL = exports.getPartitionOptions = exports.Partition = exports.generateInheritsSQL = exports.generateStatisticsSQL = exports.generateReplicaIdentitySQL = exports.generateCompressionSQL = exports.generateClusteredSQL = void 0;
-exports.getRangeOverlapSQL = exports.getRangeContainedBySQL = exports.buildRangeLiteral = exports.clearRangeMetadata = exports.isRangeColumn = exports.getAllRangeMetadata = exports.getRangeMetadata = exports.Range = exports.buildHStoreDefaultSQL = exports.getHStoreExtensionSQL = exports.clearHStoreMetadata = exports.isHStoreColumn = exports.getAllHStoreMetadata = exports.getHStoreMetadata = exports.HStore = exports.clearJSONBMetadata = exports.isJSONBColumn = exports.getAllJSONBMetadata = exports.getJSONBMetadata = exports.JSONB = exports.buildUUIDDefaultSQL = exports.getUUIDExtensionSQL = exports.clearUUIDMetadata = exports.isUUIDColumn = exports.getAllUUIDMetadata = exports.getUUIDMetadata = exports.UUID = exports.generateSetFindInSetSQL = exports.isSetColumn = exports.getAllSetColumnMetadata = exports.getSetColumnMetadata = exports.SetColumnWithOptions = void 0;
+exports.getAllIdentityMetadata = exports.getAllGeneratedMetadata = exports.getIdentityMetadata = exports.getGeneratedMetadata = exports.Identity = exports.Generated = exports.clearCheckConstraints = exports.buildAllCheckConstraints = exports.buildCheckConstraintSQL = exports.getAllCheckConstraints = exports.getTableCheckConstraints = exports.getCheckConstraints = exports.operatorToSQL = exports.CheckTable = exports.CheckColumn = exports.Check = exports.withPermissions = exports.filterWriteByPermissions = exports.filterByPermissions = exports.getAllowedAttributes = exports.canWriteField = exports.canViewField = exports.PermissionRegistry = exports.Permission = exports.CannotWrite = exports.CanWrite = exports.CannotView = exports.CanView = exports.getEngineOptions = exports.EngineRegistry = exports.Engine = exports.getMaterializedViewOptions = exports.MaterializedViewRegistry = exports.MaterializedView = exports.getViewOptions = exports.ViewRegistry = exports.View = exports.ProcedureRegistry = exports.SqlFunction = exports.Procedure = exports.createArgon2Adapter = exports.createBcryptAdapter = exports.getSecureFields = exports.applySecureHooks = exports.verifySecureField = exports.hashSecureFields = exports.getEncryptionAdapter = exports.setEncryptionAdapter = exports.SecureField = exports.Secure = void 0;
+exports.generateIndexCommentSQL = exports.generateCommentSQL = exports.getAllConstraintComments = exports.getConstraintComment = exports.setConstraintComment = exports.getAllIndexComments = exports.getIndexComment = exports.setIndexComment = exports.getAllFieldComments = exports.getFieldComment = exports.getTableComment = exports.CommentRegistry = exports.Comment = exports.SETTINGS_DECORATORS = exports.POSTGRES_DECORATORS = exports.VALIDATION_DECORATORS = exports.HOOK_DECORATORS = exports.ASSOCIATION_DECORATORS = exports.CONSTRAINT_DECORATORS = exports.MODEL_DECORATORS = exports.ALL_DECORATORS = exports.ORMDecorators = exports.clearCollateMetadata = exports.generateColumnCollateSQL = exports.generateAlterTableCollateSQL = exports.generateCreateDatabaseSQL = exports.getOrderByOptions = exports.getTableCollateOptions = exports.getDatabaseOptions = exports.getColumnCollate = exports.getCollateMetadata = exports.SetCollate = exports.OrderBy = exports.TableCollate = exports.Database = exports.Locale = exports.Collate = exports.CollateEnum = exports.createSettingsContext = exports.generateSettingsSQL = exports.getAllDatabaseSettings = exports.isForeignKeyChecksDisabled = exports.getDatabaseSettings = exports.getForeignKeyChecksSetting = exports.DatabaseSetting = exports.ForeignKeyChecks = exports.isStored = exports.buildGeneratedSQL = exports.isIdentityColumn = exports.isGeneratedColumn = void 0;
+exports.getIdentityMetadataForeignKey = exports.getAllAutoIncrementMetadata = exports.getAutoIncrementMetadata = exports.getAllUniqueMetadata = exports.getUniqueMetadata = exports.getAllForeignKeyMetadata = exports.getForeignKeyMetadata = exports.Exclusion = exports.GeneratedAlways = exports.IdentityDecorator = exports.AutoIncrement = exports.Unique = exports.Deferrable = exports.References = exports.OnUpdate = exports.OnDelete = exports.applyTimezoneHooks = exports.convertInstanceOnWrite = exports.convertInstanceOnRead = exports.getAllTimezoneFields = exports.getDefaultTimezone = exports.getTableTimezone = exports.getTimezoneForField = exports.getTimezoneFields = exports.getEffectiveTimezone = exports.convertWhereToTimezone = exports.applyTimezoneToQuery = exports.convertOnWrite = exports.convertOnRead = exports.parseDate = exports.formatDateTimezone = exports.convertFromTimezone = exports.convertToTimezone = exports.resolveTimezoneFromContext = exports.clearTimezoneContext = exports.getTimezoneContext = exports.setTimezoneContext = exports.TimezoneEnum = exports.Timezone = exports.computedDefault = exports.randomIntDefault = exports.nowDefault = exports.uuidDefault = exports.applyDefaultHooks = exports.applyDefaultValues = exports.toPrormDefault = exports.getDefaultForField = exports.getDefaultFields = exports.Default = exports.generateConstraintCommentSQL = void 0;
+exports.WithLock = exports.DistinctOn = exports.Distinct = exports.Tablesample = exports.IgnoreIndex = exports.ForceIndex = exports.UseIndex = exports.generatePartitionBoundSQL = exports.generatePartitionSQL = exports.getPartitionOptions = exports.Partition = exports.generateInheritsSQL = exports.generateStatisticsSQL = exports.generateReplicaIdentitySQL = exports.generateCompressionSQL = exports.generateClusteredSQL = exports.generateTablespaceSQL = exports.generateStorageSQL = exports.getColumnStorageOptions = exports.getInheritsOptions = exports.getOnCommitOption = exports.getStatisticsOptions = exports.getReplicaIdentityOptions = exports.getCompressionOptions = exports.getClusteredOptions = exports.getTablespaceOptions = exports.getStorageOptions = exports.ColumnStorage = exports.Inherits = exports.OnCommit = exports.Statistics = exports.ReplicaIdentity = exports.Compression = exports.Clustered = exports.TablespaceOptionsFn = exports.Tablespace = exports.Storage = exports.buildExclusionSQL = exports.buildGeneratedAlwaysSQL = exports.buildIdentitySQL = exports.buildAutoIncrementSQL = exports.buildDeferrableSQL = exports.buildReferencesSQL = exports.buildOnUpdateSQL = exports.buildOnDeleteSQL = exports.getAllExclusionMetadata = exports.getExclusionMetadata = exports.getAllGeneratedAlwaysMetadata = exports.getGeneratedAlwaysMetadata = exports.getAllIdentityMetadataForeignKey = void 0;
+exports.isJSONBColumn = exports.getAllJSONBMetadata = exports.getJSONBMetadata = exports.JSONB = exports.buildUUIDDefaultSQL = exports.getUUIDExtensionSQL = exports.clearUUIDMetadata = exports.isUUIDColumn = exports.getAllUUIDMetadata = exports.getUUIDMetadata = exports.UUID = exports.generateSetFindInSetSQL = exports.isSetColumn = exports.getAllSetColumnMetadata = exports.getSetColumnMetadata = exports.SetColumnWithOptions = exports.SetColumn = exports.generateJSONRemoveSQL = exports.generateJSONSetSQL = exports.generateJSONExtractSQL = exports.isJSONColumn = exports.getAllJSONColumnMetadata = exports.getJSONColumnMetadata = exports.JSONColumn = exports.generateSpatialIndexSQL = exports.isSpatialColumn = exports.getAllSpatialMetadata = exports.getSpatialMetadata = exports.Spatial = exports.generateCursorSQL = exports.generateDistinctOnSQL = exports.generateTablesampleSQL = exports.generateIdleInTransactionTimeoutSQL = exports.generateStatementTimeoutSQL = exports.generateLockSQL = exports.generateIndexHintSQL = exports.isDistinctEnabled = exports.getTablesampleOptions = exports.getDistinctOnColumns = exports.getFetchOptions = exports.getCursorOptions = exports.getIdleInTransactionTimeout = exports.getStatementTimeout = exports.getLockOptions = exports.getQueryHints = exports.FetchWith = exports.Fetch = exports.Cursor = exports.IdleInTransactionTimeout = exports.StatementTimeout = void 0;
+exports.getRangeOverlapSQL = exports.getRangeContainedBySQL = exports.buildRangeLiteral = exports.clearRangeMetadata = exports.isRangeColumn = exports.getAllRangeMetadata = exports.getRangeMetadata = exports.Range = exports.buildHStoreDefaultSQL = exports.getHStoreExtensionSQL = exports.clearHStoreMetadata = exports.isHStoreColumn = exports.getAllHStoreMetadata = exports.getHStoreMetadata = exports.HStore = exports.clearJSONBMetadata = void 0;
 // ── Encryption ─────────────────────────────────────────────────────────────
 var encryption_1 = require("./encryption");
 Object.defineProperty(exports, "Secure", { enumerable: true, get: function () { return encryption_1.Secure; } });
@@ -60,30 +60,14 @@ Object.defineProperty(exports, "getAllowedAttributes", { enumerable: true, get:
 Object.defineProperty(exports, "filterByPermissions", { enumerable: true, get: function () { return permissions_1.filterByPermissions; } });
 Object.defineProperty(exports, "filterWriteByPermissions", { enumerable: true, get: function () { return permissions_1.filterWriteByPermissions; } });
 Object.defineProperty(exports, "withPermissions", { enumerable: true, get: function () { return permissions_1.withPermissions; } });
-// ── HasMany ───────────────────────────────────────────────────────────────────
-var has_many_1 = require("./has-many");
-Object.defineProperty(exports, "HasMany", { enumerable: true, get: function () { return has_many_1.HasMany; } });
-Object.defineProperty(exports, "getHasMany", { enumerable: true, get: function () { return has_many_1.getHasMany; } });
-Object.defineProperty(exports, "getAllHasMany", { enumerable: true, get: function () { return has_many_1.getAllHasMany; } });
-Object.defineProperty(exports, "processHasManyDecorators", { enumerable: true, get: function () { return has_many_1.processHasManyDecorators; } });
-// ── HasOne ───────────────────────────────────────────────────────────────────
-var has_one_1 = require("./has-one");
-Object.defineProperty(exports, "HasOne", { enumerable: true, get: function () { return has_one_1.HasOne; } });
-Object.defineProperty(exports, "getHasOne", { enumerable: true, get: function () { return has_one_1.getHasOne; } });
-Object.defineProperty(exports, "getAllHasOne", { enumerable: true, get: function () { return has_one_1.getAllHasOne; } });
-Object.defineProperty(exports, "processHasOneDecorators", { enumerable: true, get: function () { return has_one_1.processHasOneDecorators; } });
-// ── BelongsTo ─────────────────────────────────────────────────────────────────
-var belongs_to_1 = require("./belongs-to");
-Object.defineProperty(exports, "BelongsTo", { enumerable: true, get: function () { return belongs_to_1.BelongsTo; } });
-Object.defineProperty(exports, "getBelongsTo", { enumerable: true, get: function () { return belongs_to_1.getBelongsTo; } });
-Object.defineProperty(exports, "getAllBelongsTo", { enumerable: true, get: function () { return belongs_to_1.getAllBelongsTo; } });
-Object.defineProperty(exports, "processBelongsToDecorators", { enumerable: true, get: function () { return belongs_to_1.processBelongsToDecorators; } });
-// ── BelongsToMany ─────────────────────────────────────────────────────────────
-var belongs_to_many_1 = require("./belongs-to-many");
-Object.defineProperty(exports, "BelongsToMany", { enumerable: true, get: function () { return belongs_to_many_1.BelongsToMany; } });
-Object.defineProperty(exports, "getBelongsToMany", { enumerable: true, get: function () { return belongs_to_many_1.getBelongsToMany; } });
-Object.defineProperty(exports, "getAllBelongsToMany", { enumerable: true, get: function () { return belongs_to_many_1.getAllBelongsToMany; } });
-Object.defineProperty(exports, "processBelongsToManyDecorators", { enumerable: true, get: function () { return belongs_to_many_1.processBelongsToManyDecorators; } });
+// ── Association decorators ────────────────────────────────────────────────────
+// @HasOne / @HasMany / @BelongsTo / @BelongsToMany live in `src/models/decorators.ts`
+// and are exported from the package root. A second, parallel implementation used to
+// live here (./has-one, ./has-many, ./belongs-to, ./belongs-to-many); it stored its
+// metadata under keys that `addModel()` never read, so annotating a model with those
+// versions registered no association, created no foreign key, and left `include`
+// unable to resolve the relation. They have been removed - which of the two you got
+// previously depended on import order.
 // ── Check Constraints ────────────────────────────────────────────────────────
 var check_1 = require("./check");
 Object.defineProperty(exports, "Check", { enumerable: true, get: function () { return check_1.Check; } });

package/dist/decorators/json-column.d.ts

@@ -0,0 +1,47 @@
+/**
+ * JSON Column decorator for MySQL native JSON type
+ *
+ * @example
+ * class Document extends Model {
+ *   @JSONColumn()
+ *   data: DataTypes.JSONCOLUMN;
+ *
+ *   @JSONColumn({ validate: true })
+ *   config: DataTypes.JSONCOLUMN;
+ * }
+ */
+import { JSONColumnOptions } from '../types';
+export interface JSONColumnMetadata {
+    validate?: boolean;
+    unescapedUnicode?: boolean;
+    compact?: boolean;
+}
+/**
+ * Decorator to mark a field as a JSON column
+ * @param options - Options for the JSON column
+ */
+export declare function JSONColumn(options?: JSONColumnOptions): PropertyDecorator;
+/**
+ * Get JSON column metadata for a field
+ */
+export declare function getJSONColumnMetadata(target: object, propertyKey: string): JSONColumnMetadata | undefined;
+/**
+ * Get all JSON column metadata for a model
+ */
+export declare function getAllJSONColumnMetadata(target: object): Map<string, JSONColumnMetadata>;
+/**
+ * Check if a field is marked as JSON column
+ */
+export declare function isJSONColumn(target: object, propertyKey: string): boolean;
+/**
+ * Generate SQL for extracting JSON path
+ */
+export declare function generateJSONExtractSQL(columnName: string, path: string, unquote?: boolean): string;
+/**
+ * Generate SQL for setting JSON value
+ */
+export declare function generateJSONSetSQL(columnName: string, path: string, value: string): string;
+/**
+ * Generate SQL for removing JSON value
+ */
+export declare function generateJSONRemoveSQL(columnName: string, path: string): string;

package/dist/decorators/jsonb.d.ts

@@ -0,0 +1,83 @@
+/**
+ * JSONB Decorator for the ORM
+ *
+ * Provides PostgreSQL JSONB type support.
+ * JSONB is different from JSON - it's stored in binary format and is indexable.
+ *
+ * Usage:
+ *
+ *   // Basic JSONB column
+ *   @JSONB()
+ *   metadata: object;
+ *
+ *   // With validation
+ *   @JSONB({ validate: true })
+ *   config: object;
+ */
+/**
+ * Options for JSONB column type
+ */
+export interface JSONBDecoratorOptions {
+    /** Whether to validate JSON structure */
+    validate?: boolean;
+    /** Whether the column allows null */
+    allowNull?: boolean;
+    /** Default value for the column */
+    defaultValue?: any;
+    /** Comment for the column */
+    comment?: string;
+    /** Custom column name in the database */
+    field?: string;
+}
+/**
+ * Metadata stored on the property
+ */
+export interface JSONBMetadata {
+    options: JSONBDecoratorOptions;
+}
+/**
+ * JSONB decorator for PostgreSQL JSONB columns
+ *
+ * @param options - Optional JSONB column options
+ *
+ * @example
+ * // Basic JSONB column
+ * class Document extends Model {
+ *   @JSONB()
+ *   data: object;
+ * }
+ *
+ * // With validation
+ * class Config extends Model {
+ *   @JSONB({ validate: true })
+ *   settings: object;
+ * }
+ */
+export declare function JSONB(options?: JSONBDecoratorOptions): PropertyDecorator;
+/**
+ * Get JSONB metadata for a property
+ *
+ * @param target - The target class
+ * @param propertyKey - The property name
+ * @returns JSONB metadata or undefined if not found
+ */
+export declare function getJSONBMetadata(target: object, propertyKey: string | symbol): JSONBMetadata | undefined;
+/**
+ * Get all JSONB metadata for a class
+ *
+ * @param target - The target class
+ * @returns Map of property names to JSONB metadata
+ */
+export declare function getAllJSONBMetadata(target: object): Map<string, JSONBMetadata>;
+/**
+ * Check if a property is a JSONB column
+ *
+ * @param target - The target class
+ * @param propertyKey - The property name
+ * @returns True if the property is a JSONB column
+ */
+export declare function isJSONBColumn(target: object, propertyKey: string | symbol): boolean;
+/**
+ * Clear JSONB metadata (useful for testing)
+ */
+export declare function clearJSONBMetadata(): void;