arkormx 0.2.0 → 0.2.2

package/dist/cli.mjs

@@ -103,7 +103,7 @@ var TableBuilder = class {
 	* 
 	* @param name      The name of the integer column.
 	* @param options   Additional options for the integer column.
-	* @returns 
+	* @returns         The current TableBuilder instance for chaining.
 	*/
 	integer(name, options = {}) {
 		return this.column(name, "integer", options);
@@ -113,7 +113,7 @@ var TableBuilder = class {
 	* 
 	* @param name      The name of the big integer column.
 	* @param options   Additional options for the big integer column.
-	* @returns 
+	* @returns         The current TableBuilder instance for chaining.
 	*/
 	bigInteger(name, options = {}) {
 		return this.column(name, "bigInteger", options);
@@ -123,17 +123,29 @@ var TableBuilder = class {
 	* 
 	* @param name      The name of the float column.
 	* @param options   Additional options for the float column.
-	* @returns 
+	* @returns         The current TableBuilder instance for chaining.
 	*/
 	float(name, options = {}) {
 		return this.column(name, "float", options);
 	}
 	/**
+	* Marks a column as unique in the table.
+	* 
+	* @param name Optional explicit column name. 
+	* When omitted, applies to the latest defined column.
+	* @returns The current TableBuilder instance for chaining.
+	*/
+	unique(name) {
+		const column = this.resolveColumn(name);
+		column.unique = true;
+		return this;
+	}
+	/**
 	* Defines a boolean column in the table.
 	* 
 	* @param name      The name of the boolean column. 
 	* @param options   Additional options for the boolean column.
-	* @returns 
+	* @returns         The current TableBuilder instance for chaining.
 	*/
 	boolean(name, options = {}) {
 		return this.column(name, "boolean", options);

package/dist/index.cjs

@@ -194,7 +194,7 @@ var TableBuilder = class {
 	* 
 	* @param name      The name of the integer column.
 	* @param options   Additional options for the integer column.
-	* @returns 
+	* @returns         The current TableBuilder instance for chaining.
 	*/
 	integer(name, options = {}) {
 		return this.column(name, "integer", options);
@@ -204,7 +204,7 @@ var TableBuilder = class {
 	* 
 	* @param name      The name of the big integer column.
 	* @param options   Additional options for the big integer column.
-	* @returns 
+	* @returns         The current TableBuilder instance for chaining.
 	*/
 	bigInteger(name, options = {}) {
 		return this.column(name, "bigInteger", options);
@@ -214,17 +214,29 @@ var TableBuilder = class {
 	* 
 	* @param name      The name of the float column.
 	* @param options   Additional options for the float column.
-	* @returns 
+	* @returns         The current TableBuilder instance for chaining.
 	*/
 	float(name, options = {}) {
 		return this.column(name, "float", options);
 	}
 	/**
+	* Marks a column as unique in the table.
+	* 
+	* @param name Optional explicit column name. 
+	* When omitted, applies to the latest defined column.
+	* @returns The current TableBuilder instance for chaining.
+	*/
+	unique(name) {
+		const column = this.resolveColumn(name);
+		column.unique = true;
+		return this;
+	}
+	/**
 	* Defines a boolean column in the table.
 	* 
 	* @param name      The name of the boolean column. 
 	* @param options   Additional options for the boolean column.
-	* @returns 
+	* @returns         The current TableBuilder instance for chaining.
 	*/
 	boolean(name, options = {}) {
 		return this.column(name, "boolean", options);
@@ -2203,9 +2215,14 @@ const defineFactory = (model, definition) => {
 * @since 0.1.0
 */
 var ModelNotFoundException = class extends ArkormException {
-	constructor(message = "No query results for the given model.") {
+	modelName;
+	constructor(modelName, message = "No query results for the given model.") {
 		super(message);
 		this.name = "ModelNotFoundException";
+		this.modelName = modelName;
+	}
+	getModelName() {
+		return this.modelName;
 	}
 };
 
@@ -3605,7 +3622,7 @@ var QueryBuilder = class QueryBuilder {
 	*/
 	async firstOrFail() {
 		const model = await this.first();
-		if (!model) throw new ModelNotFoundException("Record not found.");
+		if (!model) throw new ModelNotFoundException(this.model.name, "Record not found.");
 		return model;
 	}
 	async find(value, key = "id") {
@@ -3638,7 +3655,7 @@ var QueryBuilder = class QueryBuilder {
 	*/
 	async valueOrFail(column) {
 		const result = await this.value(column);
-		if (result == null) throw new ModelNotFoundException("Record not found.");
+		if (result == null) throw new ModelNotFoundException(this.model.name, "Record not found.");
 		return result;
 	}
 	/**

package/dist/index.d.cts

@@ -2351,7 +2351,7 @@ declare class TableBuilder {
    *
    * @param name      The name of the integer column.
    * @param options   Additional options for the integer column.
-   * @returns
+   * @returns         The current TableBuilder instance for chaining.
    */
   integer(name: string, options?: Partial<SchemaColumn>): this;
   /**
@@ -2359,7 +2359,7 @@ declare class TableBuilder {
    *
    * @param name      The name of the big integer column.
    * @param options   Additional options for the big integer column.
-   * @returns
+   * @returns         The current TableBuilder instance for chaining.
    */
   bigInteger(name: string, options?: Partial<SchemaColumn>): this;
   /**
@@ -2367,15 +2367,23 @@ declare class TableBuilder {
    *
    * @param name      The name of the float column.
    * @param options   Additional options for the float column.
-   * @returns
+   * @returns         The current TableBuilder instance for chaining.
    */
   float(name: string, options?: Partial<SchemaColumn>): this;
+  /**
+   * Marks a column as unique in the table.
+   *
+   * @param name Optional explicit column name.
+   * When omitted, applies to the latest defined column.
+   * @returns The current TableBuilder instance for chaining.
+   */
+  unique(name?: string): this;
   /**
    * Defines a boolean column in the table.
    *
    * @param name      The name of the boolean column.
    * @param options   Additional options for the boolean column.
-   * @returns
+   * @returns         The current TableBuilder instance for chaining.
    */
   boolean(name: string, options?: Partial<SchemaColumn>): this;
   /**
@@ -2630,7 +2638,9 @@ declare class ArkormException extends Error {
  * @since 0.1.0
  */
 declare class ModelNotFoundException extends ArkormException {
-  constructor(message?: string);
+  private modelName;
+  constructor(modelName: string, message?: string);
+  getModelName(): string;
 }
 //#endregion
 //#region src/helpers/migrations.d.ts

package/dist/index.d.mts

@@ -2351,7 +2351,7 @@ declare class TableBuilder {
    *
    * @param name      The name of the integer column.
    * @param options   Additional options for the integer column.
-   * @returns
+   * @returns         The current TableBuilder instance for chaining.
    */
   integer(name: string, options?: Partial<SchemaColumn>): this;
   /**
@@ -2359,7 +2359,7 @@ declare class TableBuilder {
    *
    * @param name      The name of the big integer column.
    * @param options   Additional options for the big integer column.
-   * @returns
+   * @returns         The current TableBuilder instance for chaining.
    */
   bigInteger(name: string, options?: Partial<SchemaColumn>): this;
   /**
@@ -2367,15 +2367,23 @@ declare class TableBuilder {
    *
    * @param name      The name of the float column.
    * @param options   Additional options for the float column.
-   * @returns
+   * @returns         The current TableBuilder instance for chaining.
    */
   float(name: string, options?: Partial<SchemaColumn>): this;
+  /**
+   * Marks a column as unique in the table.
+   *
+   * @param name Optional explicit column name.
+   * When omitted, applies to the latest defined column.
+   * @returns The current TableBuilder instance for chaining.
+   */
+  unique(name?: string): this;
   /**
    * Defines a boolean column in the table.
    *
    * @param name      The name of the boolean column.
    * @param options   Additional options for the boolean column.
-   * @returns
+   * @returns         The current TableBuilder instance for chaining.
    */
   boolean(name: string, options?: Partial<SchemaColumn>): this;
   /**
@@ -2630,7 +2638,9 @@ declare class ArkormException extends Error {
  * @since 0.1.0
  */
 declare class ModelNotFoundException extends ArkormException {
-  constructor(message?: string);
+  private modelName;
+  constructor(modelName: string, message?: string);
+  getModelName(): string;
 }
 //#endregion
 //#region src/helpers/migrations.d.ts

package/dist/index.mjs

@@ -165,7 +165,7 @@ var TableBuilder = class {
 	* 
 	* @param name      The name of the integer column.
 	* @param options   Additional options for the integer column.
-	* @returns 
+	* @returns         The current TableBuilder instance for chaining.
 	*/
 	integer(name, options = {}) {
 		return this.column(name, "integer", options);
@@ -175,7 +175,7 @@ var TableBuilder = class {
 	* 
 	* @param name      The name of the big integer column.
 	* @param options   Additional options for the big integer column.
-	* @returns 
+	* @returns         The current TableBuilder instance for chaining.
 	*/
 	bigInteger(name, options = {}) {
 		return this.column(name, "bigInteger", options);
@@ -185,17 +185,29 @@ var TableBuilder = class {
 	* 
 	* @param name      The name of the float column.
 	* @param options   Additional options for the float column.
-	* @returns 
+	* @returns         The current TableBuilder instance for chaining.
 	*/
 	float(name, options = {}) {
 		return this.column(name, "float", options);
 	}
 	/**
+	* Marks a column as unique in the table.
+	* 
+	* @param name Optional explicit column name. 
+	* When omitted, applies to the latest defined column.
+	* @returns The current TableBuilder instance for chaining.
+	*/
+	unique(name) {
+		const column = this.resolveColumn(name);
+		column.unique = true;
+		return this;
+	}
+	/**
 	* Defines a boolean column in the table.
 	* 
 	* @param name      The name of the boolean column. 
 	* @param options   Additional options for the boolean column.
-	* @returns 
+	* @returns         The current TableBuilder instance for chaining.
 	*/
 	boolean(name, options = {}) {
 		return this.column(name, "boolean", options);
@@ -2174,9 +2186,14 @@ const defineFactory = (model, definition) => {
 * @since 0.1.0
 */
 var ModelNotFoundException = class extends ArkormException {
-	constructor(message = "No query results for the given model.") {
+	modelName;
+	constructor(modelName, message = "No query results for the given model.") {
 		super(message);
 		this.name = "ModelNotFoundException";
+		this.modelName = modelName;
+	}
+	getModelName() {
+		return this.modelName;
 	}
 };
 
@@ -3576,7 +3593,7 @@ var QueryBuilder = class QueryBuilder {
 	*/
 	async firstOrFail() {
 		const model = await this.first();
-		if (!model) throw new ModelNotFoundException("Record not found.");
+		if (!model) throw new ModelNotFoundException(this.model.name, "Record not found.");
 		return model;
 	}
 	async find(value, key = "id") {
@@ -3609,7 +3626,7 @@ var QueryBuilder = class QueryBuilder {
 	*/
 	async valueOrFail(column) {
 		const result = await this.value(column);
-		if (result == null) throw new ModelNotFoundException("Record not found.");
+		if (result == null) throw new ModelNotFoundException(this.model.name, "Record not found.");
 		return result;
 	}
 	/**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkormx",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Modern TypeScript-first ORM for Node.js.",
   "keywords": [
     "orm",