alepha 0.13.0 → 0.13.2

package/dist/orm/index.js

@@ -1,5 +1,5 @@
 import { createRequire } from "node:module";
-import { $atom, $context, $env, $hook, $inject, $module, $use, Alepha, AlephaError, Descriptor, KIND, TypeBoxValue, createDescriptor, createPagination, pageQuerySchema, pageSchema, pageSchema as pageSchema$1, t } from "alepha";
+import { $atom, $context, $env, $hook, $inject, $module, $use, Alepha, AlephaError, KIND, Primitive, TypeBoxValue, createPagination, createPrimitive, pageQuerySchema, pageSchema, pageSchema as pageSchema$1, t } from "alepha";
 import { AlephaDateTime, DateTimeProvider } from "alepha/datetime";
 import * as drizzle from "drizzle-orm";
 import { and, arrayContained, arrayContains, arrayOverlaps, asc, between, desc, eq, getTableName, gt, gte, ilike, inArray, isNotNull, isNull, isSQLWrapper, like, lt, lte, ne, not, notBetween, notIlike, notInArray, notLike, or, sql, sql as sql$1 } from "drizzle-orm";
@@ -73,9 +73,9 @@ const updateSchema = (schema$1) => {
 };
 
 //#endregion
-//#region src/orm/descriptors/$entity.ts
+//#region src/orm/primitives/$entity.ts
 /**
-* Creates a database entity descriptor that defines table structure using TypeBox schemas.
+* Creates a database entity primitive that defines table structure using TypeBox schemas.
 *
 * @example
 * ```ts
@@ -93,15 +93,15 @@ const updateSchema = (schema$1) => {
 * ```
 */
 const $entity = (options) => {
-	return new EntityDescriptor(options);
+	return new EntityPrimitive(options);
 };
-var EntityDescriptor = class EntityDescriptor {
+var EntityPrimitive = class EntityPrimitive {
 	options;
 	constructor(options) {
 		this.options = options;
 	}
 	alias(alias$1) {
-		const aliased = new EntityDescriptor(this.options);
+		const aliased = new EntityPrimitive(this.options);
 		return new Proxy(aliased, { get(target, prop, receiver) {
 			if (prop === "$alias") return alias$1;
 			return Reflect.get(target, prop, receiver);
@@ -128,7 +128,7 @@ var EntityDescriptor = class EntityDescriptor {
 		return updateSchema(this.options.schema);
 	}
 };
-$entity[KIND] = EntityDescriptor;
+$entity[KIND] = EntityPrimitive;
 
 //#endregion
 //#region src/orm/errors/DbError.ts
@@ -1462,7 +1462,7 @@ var RepositoryProvider = class {
 };
 
 //#endregion
-//#region src/orm/descriptors/$repository.ts
+//#region src/orm/primitives/$repository.ts
 /**
 * Get the repository for the given entity.
 */
@@ -1472,14 +1472,14 @@ const $repository = (entity) => {
 };
 
 //#endregion
-//#region src/orm/descriptors/$sequence.ts
+//#region src/orm/primitives/$sequence.ts
 /**
-* Creates a PostgreSQL sequence descriptor for generating unique numeric values.
+* Creates a PostgreSQL sequence primitive for generating unique numeric values.
 */
 const $sequence = (options = {}) => {
-	return createDescriptor(SequenceDescriptor, options);
+	return createPrimitive(SequencePrimitive, options);
 };
-var SequenceDescriptor = class extends Descriptor {
+var SequencePrimitive = class extends Primitive {
 	provider = this.$provider();
 	onInit() {
 		this.provider.registerSequence(this);
@@ -1497,7 +1497,7 @@ var SequenceDescriptor = class extends Descriptor {
 		return this.options.provider ?? this.alepha.inject(DatabaseProvider);
 	}
 };
-$sequence[KIND] = SequenceDescriptor;
+$sequence[KIND] = SequencePrimitive;
 
 //#endregion
 //#region src/orm/providers/DrizzleKitProvider.ts
@@ -1701,7 +1701,7 @@ const byte = customType({ dataType: () => "bytea" });
 //#endregion
 //#region src/orm/services/ModelBuilder.ts
 /**
-* Abstract base class for transforming Alepha Descriptors (Entity, Sequence, etc...)
+* Abstract base class for transforming Alepha Primitives (Entity, Sequence, etc...)
 * into drizzle models (tables, enums, sequences, etc...).
 */
 var ModelBuilder = class {
@@ -1715,7 +1715,7 @@ var ModelBuilder = class {
 	* Build the table configuration function for any database.
 	* This includes indexes, foreign keys, constraints, and custom config.
 	*
-	* @param entity - The entity descriptor
+	* @param entity - The entity primitive
 	* @param builders - Database-specific builder functions
 	* @param tableResolver - Function to resolve entity references to table columns
 	* @param customConfigHandler - Optional handler for custom config
@@ -2362,32 +2362,6 @@ var PglitePostgresProvider = class PglitePostgresProvider extends DatabaseProvid
 	}
 };
 
-//#endregion
-//#region src/orm/descriptors/$transaction.ts
-/**
-* Creates a transaction descriptor for database operations requiring atomicity and consistency.
-*
-* This descriptor provides a convenient way to wrap database operations in PostgreSQL
-* transactions, ensuring ACID properties and automatic retry logic for version conflicts.
-* It integrates seamlessly with the repository pattern and provides built-in handling
-* for optimistic locking scenarios with automatic retry on version mismatches.
-*
-* **Important Notes**:
-* - All operations within the transaction handler are atomic
-* - Automatic retry on `PgVersionMismatchError` for optimistic locking
-* - Pass `{ tx }` option to all repository operations within the transaction
-* - Transactions are automatically rolled back on any unhandled error
-* - Use appropriate isolation levels based on your consistency requirements
-*/
-const $transaction = (opts) => {
-	const { alepha } = $context();
-	const provider = alepha.inject(DatabaseProvider);
-	return $retry({
-		when: (err) => err instanceof DbVersionMismatchError,
-		handler: (...args) => provider.db.transaction(async (tx) => opts.handler(tx, ...args), opts.config)
-	});
-};
-
 //#endregion
 //#region src/orm/helpers/parseQueryString.ts
 /**
@@ -2697,6 +2671,32 @@ function buildQueryString(where) {
 	return parts.join("&");
 }
 
+//#endregion
+//#region src/orm/primitives/$transaction.ts
+/**
+* Creates a transaction primitive for database operations requiring atomicity and consistency.
+*
+* This primitive provides a convenient way to wrap database operations in PostgreSQL
+* transactions, ensuring ACID properties and automatic retry logic for version conflicts.
+* It integrates seamlessly with the repository pattern and provides built-in handling
+* for optimistic locking scenarios with automatic retry on version mismatches.
+*
+* **Important Notes**:
+* - All operations within the transaction handler are atomic
+* - Automatic retry on `PgVersionMismatchError` for optimistic locking
+* - Pass `{ tx }` option to all repository operations within the transaction
+* - Transactions are automatically rolled back on any unhandled error
+* - Use appropriate isolation levels based on your consistency requirements
+*/
+const $transaction = (opts) => {
+	const { alepha } = $context();
+	const provider = alepha.inject(DatabaseProvider);
+	return $retry({
+		when: (err) => err instanceof DbVersionMismatchError,
+		handler: (...args) => provider.db.transaction(async (tx) => opts.handler(tx, ...args), opts.config)
+	});
+};
+
 //#endregion
 //#region src/orm/providers/PostgresTypeProvider.ts
 var PostgresTypeProvider = class {
@@ -2733,9 +2733,9 @@ var PostgresTypeProvider = class {
 	*
 	* This is used to track the version of a row in the database.
 	*
-	* You can use it for optimistic concurrency control (OCC) with {@link RepositoryDescriptor#save}.
+	* You can use it for optimistic concurrency control (OCC) with {@link RepositoryPrimitive#save}.
 	*
-	* @see {@link RepositoryDescriptor#save}
+	* @see {@link RepositoryPrimitive#save}
 	* @see {@link PgVersionMismatchError}
 	*/
 	version = (options = {}) => this.default(pgAttr(t.integer(options), PG_VERSION), 0);
@@ -2782,7 +2782,7 @@ var PostgresTypeProvider = class {
 	};
 	/**
 	* Creates a page schema for a given object schema.
-	* It's used by {@link RepositoryDescriptor#paginate} method.
+	* It's used by {@link RepositoryPrimitive#paginate} method.
 	*/
 	page = (resource, options) => {
 		return pageSchema$1(resource, options);
@@ -2840,7 +2840,7 @@ const legacyIdSchema = pgAttr(pgAttr(pgAttr(t.integer(), PG_PRIMARY_KEY), PG_SER
 */
 const AlephaPostgres = $module({
 	name: "alepha.postgres",
-	descriptors: [$sequence, $entity],
+	primitives: [$sequence, $entity],
 	services: [
 		AlephaDateTime,
 		DatabaseProvider,
@@ -2887,5 +2887,5 @@ const AlephaPostgres = $module({
 });
 
 //#endregion
-export { $entity, $repository, $sequence, $transaction, AlephaPostgres, DatabaseProvider, DbConflictError, DbEntityNotFoundError, DbError, DbMigrationError, DbVersionMismatchError, DrizzleKitProvider, EntityDescriptor, NodePostgresProvider, NodeSqliteProvider, PG_CREATED_AT, PG_DEFAULT, PG_DELETED_AT, PG_ENUM, PG_IDENTITY, PG_PRIMARY_KEY, PG_REF, PG_SERIAL, PG_UPDATED_AT, PG_VERSION, PostgresTypeProvider, Repository, RepositoryProvider, SequenceDescriptor, buildQueryString, drizzle, getAttrFields, insertSchema, legacyIdSchema, nodeSqliteOptions, pageQuerySchema, pageSchema, parseQueryString, pg, pgAttr, schema, sql, updateSchema };
+export { $entity, $repository, $sequence, $transaction, AlephaPostgres, DatabaseProvider, DbConflictError, DbEntityNotFoundError, DbError, DbMigrationError, DbVersionMismatchError, DrizzleKitProvider, EntityPrimitive, NodePostgresProvider, NodeSqliteProvider, PG_CREATED_AT, PG_DEFAULT, PG_DELETED_AT, PG_ENUM, PG_IDENTITY, PG_PRIMARY_KEY, PG_REF, PG_SERIAL, PG_UPDATED_AT, PG_VERSION, PostgresTypeProvider, Repository, RepositoryProvider, SequencePrimitive, buildQueryString, drizzle, getAttrFields, insertSchema, legacyIdSchema, nodeSqliteOptions, pageQuerySchema, pageSchema, parseQueryString, pg, pgAttr, schema, sql, updateSchema };
 //# sourceMappingURL=index.js.map