linkgress-orm 0.0.1

package/dist/database/types.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Configuration types for database clients
+ * These are based on the actual pg and postgres libraries but defined here
+ * to avoid requiring the packages at compile time.
+ */
+/**
+ * Connection pool configuration for node-postgres (pg) library
+ * @see https://node-postgres.com/apis/pool
+ */
+export interface PoolConfig {
+    /**
+     * Database host (default: localhost)
+     */
+    host?: string;
+    /**
+     * Database server port (default: 5432)
+     */
+    port?: number;
+    /**
+     * Database name
+     */
+    database?: string;
+    /**
+     * Database user
+     */
+    user?: string;
+    /**
+     * Database password
+     */
+    password?: string;
+    /**
+     * Connection string (alternative to individual options)
+     * Format: postgres://user:password@host:port/database
+     */
+    connectionString?: string;
+    /**
+     * Maximum number of clients in the pool (default: 10)
+     */
+    max?: number;
+    /**
+     * Minimum number of clients in the pool (default: 0)
+     */
+    min?: number;
+    /**
+     * Number of milliseconds to wait before timing out when connecting a new client (default: 0 - no timeout)
+     */
+    connectionTimeoutMillis?: number;
+    /**
+     * Number of milliseconds a client must sit idle in the pool before being closed (default: 10000)
+     */
+    idleTimeoutMillis?: number;
+    /**
+     * Maximum number of milliseconds to wait for a query to complete (default: 0 - no timeout)
+     */
+    query_timeout?: number;
+    /**
+     * Maximum number of milliseconds to wait for a connection (default: 0 - no timeout)
+     */
+    statement_timeout?: number;
+    /**
+     * Number of milliseconds before a query will time out (default: 0 - no timeout)
+     */
+    idle_in_transaction_session_timeout?: number;
+    /**
+     * Application name for logging (default: undefined)
+     */
+    application_name?: string;
+    /**
+     * Whether to use SSL (default: false)
+     */
+    ssl?: boolean | {
+        rejectUnauthorized?: boolean;
+        ca?: string;
+        key?: string;
+        cert?: string;
+    };
+    /**
+     * Custom types parser
+     */
+    types?: any;
+    /**
+     * Whether to allow exiting the pool (default: true)
+     */
+    allowExitOnIdle?: boolean;
+}
+/**
+ * Connection options for postgres.js library
+ * @see https://github.com/porsager/postgres
+ */
+export interface PostgresOptions {
+    /**
+     * Database host (default: localhost)
+     */
+    host?: string;
+    /**
+     * Database server port (default: 5432)
+     */
+    port?: number;
+    /**
+     * Database name
+     */
+    database?: string;
+    /**
+     * Database user (default: process.env.USER)
+     */
+    user?: string;
+    /**
+     * Username (alias for user)
+     */
+    username?: string;
+    /**
+     * Database password
+     */
+    password?: string;
+    /**
+     * Pass phrase for encrypted key
+     */
+    pass?: string;
+    /**
+     * Maximum number of connections (default: 10)
+     */
+    max?: number;
+    /**
+     * Minimum number of idle connections (default: 0)
+     */
+    min?: number;
+    /**
+     * Idle connection timeout in seconds (default: undefined)
+     */
+    idle_timeout?: number;
+    /**
+     * Connection timeout in seconds (default: undefined)
+     */
+    connect_timeout?: number;
+    /**
+     * Max lifetime of a connection in seconds (default: 3600)
+     */
+    max_lifetime?: number;
+    /**
+     * Timeout for queries in seconds (default: undefined)
+     */
+    timeout?: number;
+    /**
+     * SSL configuration (default: false)
+     */
+    ssl?: boolean | 'require' | 'allow' | 'prefer' | 'verify-full' | {
+        rejectUnauthorized?: boolean;
+        ca?: string;
+        key?: string;
+        cert?: string;
+    };
+    /**
+     * Whether to use prepared statements (default: true)
+     */
+    prepare?: boolean;
+    /**
+     * Transform column names (default: undefined)
+     */
+    transform?: {
+        column?: (column: string) => string;
+        value?: (value: any) => any;
+        row?: (row: any) => any;
+    };
+    /**
+     * Custom types mapping
+     */
+    types?: any;
+    /**
+     * Connection properties
+     */
+    connection?: {
+        application_name?: string;
+        [key: string]: any;
+    };
+    /**
+     * Called when connection is established
+     */
+    onnotice?: (notice: any) => void;
+    /**
+     * Called when connection is closed
+     */
+    onclose?: (connectionId: number) => void;
+    /**
+     * Called for query logging
+     */
+    debug?: boolean | ((connection: number, query: string, params: any[], types: any[]) => void);
+    /**
+     * Fetch array mode (default: false)
+     */
+    fetch_types?: boolean;
+    /**
+     * Publications for logical replication
+     */
+    publications?: string;
+    /**
+     * Target session attributes (default: any)
+     */
+    target_session_attrs?: 'any' | 'read-write' | 'read-only' | 'primary' | 'standby' | 'prefer-standby';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/database/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/database/types.ts"],"names":[],"mappings":"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"}

package/dist/database/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Configuration types for database clients
+ * These are based on the actual pg and postgres libraries but defined here
+ * to avoid requiring the packages at compile time.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/database/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/database/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/entity/base-entity.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Base class for all entities
+ * Provides common functionality and ensures proper type handling
+ */
+export declare abstract class DbEntity {
+    /** @internal */
+    static readonly __isEntity = true;
+    /** @internal */
+    static __tableName?: string;
+    /** @internal */
+    static __tableBuilder?: any;
+    /**
+     * Converts entity to plain object
+     */
+    toJSON(): Record<string, any>;
+    /**
+     * Creates entity from plain object
+     */
+    static fromJSON<T extends DbEntity>(this: new () => T, data: Record<string, any>): T;
+}
+//# sourceMappingURL=base-entity.d.ts.map

package/dist/entity/base-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-entity.d.ts","sourceRoot":"","sources":["../../src/entity/base-entity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,8BAAsB,QAAQ;IAC5B,gBAAgB;IAChB,MAAM,CAAC,QAAQ,CAAC,UAAU,QAAQ;IAElC,gBAAgB;IAChB,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE5B,gBAAgB;IAChB,MAAM,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC;IAE5B;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAI7B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC;CAKrF"}

package/dist/entity/base-entity.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DbEntity = void 0;
+/**
+ * Base class for all entities
+ * Provides common functionality and ensures proper type handling
+ */
+class DbEntity {
+    /**
+     * Converts entity to plain object
+     */
+    toJSON() {
+        return { ...this };
+    }
+    /**
+     * Creates entity from plain object
+     */
+    static fromJSON(data) {
+        const instance = new this();
+        Object.assign(instance, data);
+        return instance;
+    }
+}
+exports.DbEntity = DbEntity;
+/** @internal */
+DbEntity.__isEntity = true;
+//# sourceMappingURL=base-entity.js.map

package/dist/entity/base-entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-entity.js","sourceRoot":"","sources":["../../src/entity/base-entity.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAsB,QAAQ;IAU5B;;OAEG;IACH,MAAM;QACJ,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAwC,IAAyB;QAC9E,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;;AAxBH,4BAyBC;AAxBC,gBAAgB;AACA,mBAAU,GAAG,IAAI,CAAC"}

package/dist/entity/db-column.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Database column wrapper that provides type-safe query operations
+ * while automatically unwrapping to the underlying type in results
+ *
+ * DbColumn implements the FieldRef interface so it can be used in conditions
+ */
+export declare class DbColumn<TValue> {
+    /** @internal */
+    readonly __isDbColumn = true;
+    /** @internal */
+    readonly __fieldName: string;
+    /** @internal */
+    readonly __dbColumnName: string;
+    /** @internal */
+    readonly __valueType: TValue;
+    constructor(
+    /** @internal */
+    columnName: string);
+    /**
+     * This is a compile-time only type - at runtime this is never called
+     * The actual value is returned by the query execution
+     */
+    valueOf(): TValue;
+}
+/**
+ * Type helper to unwrap DbColumn types to their underlying values
+ */
+export type UnwrapDbColumns<T> = T extends DbColumn<infer V> ? V : T extends object ? {
+    [K in keyof T]: T[K] extends DbColumn<infer V> ? V : T[K] extends (infer U)[] | undefined ? U extends DbEntity ? UnwrapDbColumns<U>[] : T[K] : T[K] extends DbEntity | undefined ? UnwrapDbColumns<NonNullable<T[K]>> : T[K];
+} : T;
+/**
+ * Helper to check if a type includes DbColumn
+ */
+type IncludesDbColumn<T> = T extends DbColumn<any> ? true : T extends DbColumn<any> | undefined ? true : T extends undefined | DbColumn<any> ? true : false;
+/**
+ * Helper to unwrap DbColumn from potentially optional type
+ */
+type UnwrapOptionalDbColumn<T> = T extends DbColumn<infer V> | undefined ? V : T extends DbColumn<infer V> ? V : never;
+/**
+ * Type helper to extract only DbColumn properties from an entity
+ * This is used for insert/update operations where only actual columns are needed,
+ * excluding navigation properties
+ */
+export type ExtractDbColumns<T> = {
+    [K in keyof T as IncludesDbColumn<T[K]> extends true ? K : never]: UnwrapOptionalDbColumn<T[K]>;
+};
+/**
+ * Type for insert data - only includes DbColumn properties, unwrapped to their values
+ */
+export type InsertData<TEntity> = Partial<ExtractDbColumns<TEntity>>;
+/**
+ * Marker to indicate DbEntity type (imported to avoid circular dependency)
+ */
+interface DbEntity {
+}
+/**
+ * Check if a value is a DbColumn
+ */
+export declare function isDbColumn(value: any): value is DbColumn<any>;
+export {};
+//# sourceMappingURL=db-column.d.ts.map

package/dist/entity/db-column.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-column.d.ts","sourceRoot":"","sources":["../../src/entity/db-column.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,QAAQ,CAAC,MAAM;IAC1B,gBAAgB;IAChB,QAAQ,CAAC,YAAY,QAAQ;IAE7B,gBAAgB;IAChB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,gBAAgB;IAChB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,gBAAgB;IAChB,QAAQ,CAAC,WAAW,EAAG,MAAM,CAAC;;IAG5B,gBAAgB;IAChB,UAAU,EAAE,MAAM;IAMpB;;;OAGG;IACH,OAAO,IAAI,MAAM;CAGlB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,CAAC,GACxD,CAAC,GACD,CAAC,SAAS,MAAM,GAChB;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,CAAC,GAC1C,CAAC,GACD,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,GACpC,CAAC,SAAS,QAAQ,GAChB,eAAe,CAAC,CAAC,CAAC,EAAE,GACpB,CAAC,CAAC,CAAC,CAAC,GACN,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,GAAG,SAAS,GACjC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAClC,CAAC,CAAC,CAAC,CAAC;CACT,GACD,CAAC,CAAC;AAEN;;GAEG;AACH,KAAK,gBAAgB,CAAC,CAAC,IACrB,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,GAC9B,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,GAC1C,CAAC,SAAS,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,GAC1C,KAAK,CAAC;AAER;;GAEG;AACH,KAAK,sBAAsB,CAAC,CAAC,IAC3B,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,GAC3C,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAC/B,KAAK,CAAC;AAER;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;KAC/B,CAAC,IAAI,MAAM,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAChG,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;AAErE;;GAEG;AACH,UAAU,QAAQ;CAEjB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,QAAQ,CAAC,GAAG,CAAC,CAE7D"}

package/dist/entity/db-column.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DbColumn = void 0;
+exports.isDbColumn = isDbColumn;
+/**
+ * Database column wrapper that provides type-safe query operations
+ * while automatically unwrapping to the underlying type in results
+ *
+ * DbColumn implements the FieldRef interface so it can be used in conditions
+ */
+class DbColumn {
+    constructor(
+    /** @internal */
+    columnName) {
+        /** @internal */
+        this.__isDbColumn = true;
+        this.__fieldName = columnName;
+        this.__dbColumnName = columnName;
+    }
+    /**
+     * This is a compile-time only type - at runtime this is never called
+     * The actual value is returned by the query execution
+     */
+    valueOf() {
+        throw new Error('DbColumn.valueOf() should never be called at runtime');
+    }
+}
+exports.DbColumn = DbColumn;
+/**
+ * Check if a value is a DbColumn
+ */
+function isDbColumn(value) {
+    return value && typeof value === 'object' && value.__isDbColumn === true;
+}
+//# sourceMappingURL=db-column.js.map

package/dist/entity/db-column.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-column.js","sourceRoot":"","sources":["../../src/entity/db-column.ts"],"names":[],"mappings":";;;AAgGA,gCAEC;AAlGD;;;;;GAKG;AACH,MAAa,QAAQ;IAanB;IACE,gBAAgB;IAChB,UAAkB;QAdpB,gBAAgB;QACP,iBAAY,GAAG,IAAI,CAAC;QAe3B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;CACF;AA5BD,4BA4BC;AA2DD;;GAEG;AACH,SAAgB,UAAU,CAAC,KAAU;IACnC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC;AAC3E,CAAC"}