@declaro/data 2.0.0-beta.49 → 2.0.0-beta.50

package/dist/ts/domain/interfaces/repository.d.ts

@@ -6,9 +6,9 @@ export interface IRepository<TSchema extends AnyModelSchema> {
      * Loads a single element based on the provided lookup.
      *
      * @param input - The lookup criteria for the element.
-     * @returns A promise resolving to the detailed element.
+     * @returns A promise resolving to the detailed element or null if not found.
      */
-    load(input: InferLookup<TSchema>): Promise<InferDetail<TSchema>>;
+    load(input: InferLookup<TSchema>): Promise<InferDetail<TSchema> | null>;
     /**
      * Loads multiple elements based on the provided lookups.
      *

package/dist/ts/test/mock/repositories/mock-memory-repository.d.ts

@@ -12,7 +12,7 @@ export declare class MockMemoryRepository<TSchema extends AnyModelSchema> implem
     protected entityMetadata: IModelEntityMetadata<any>;
     protected nextId: number;
     constructor(args: IMockMemoryRepositoryArgs<TSchema>);
-    load(input: InferLookup<TSchema>): Promise<InferDetail<TSchema>>;
+    load(input: InferLookup<TSchema>): Promise<InferDetail<TSchema> | null>;
     loadMany(inputs: InferLookup<TSchema>[]): Promise<InferDetail<TSchema>[]>;
     search(input: InferFilters<TSchema>, pagination?: IPaginationInput): Promise<InferSearchResults<TSchema>>;
     remove(lookup: InferLookup<TSchema>): Promise<InferSummary<TSchema>>;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@declaro/data",
-    "version": "2.0.0-beta.49",
+    "version": "2.0.0-beta.50",
     "description": "A data-mapper framework for managing application data across integrated systems.",
     "main": "dist/node/index.cjs",
     "module": "dist/browser/index.js",
@@ -20,8 +20,8 @@
         "@declaro/core": "^2.0.0-beta.46"
     },
     "devDependencies": {
-        "@declaro/auth": "^2.0.0-beta.49",
-        "@declaro/core": "^2.0.0-beta.49",
+        "@declaro/auth": "^2.0.0-beta.50",
+        "@declaro/core": "^2.0.0-beta.50",
         "typescript": "^5.8.3",
         "uuid": "^11.1.0",
         "zod": "^3.25.67"
@@ -41,5 +41,5 @@
         },
         "require": "./dist/node/index.cjs"
     },
-    "gitHead": "2c7216f977daaf71bb84e3080cf7904c97ad8eb4"
+    "gitHead": "b112b03419fd64dd882c114fd88c8928224d2649"
 }

package/src/domain/interfaces/repository.ts

@@ -14,9 +14,9 @@ export interface IRepository<TSchema extends AnyModelSchema> {
      * Loads a single element based on the provided lookup.
      *
      * @param input - The lookup criteria for the element.
-     * @returns A promise resolving to the detailed element.
+     * @returns A promise resolving to the detailed element or null if not found.
      */
-    load(input: InferLookup<TSchema>): Promise<InferDetail<TSchema>>
+    load(input: InferLookup<TSchema>): Promise<InferDetail<TSchema> | null>
 
     /**
      * Loads multiple elements based on the provided lookups.

package/src/domain/services/model-service.test.ts

@@ -72,7 +72,7 @@ describe('ModelService', () => {
         const removedRecord = await service.remove({ id: 42 })
 
         expect(removedRecord).toEqual(input)
-        await expect(repository.load({ id: 42 })).rejects.toThrow('Item not found')
+        expect(await repository.load({ id: 42 })).toBeNull()
     })
 
     it('should restore a record', async () => {
@@ -137,4 +137,13 @@ describe('ModelService', () => {
         expect(afterRestoreSpy).toHaveBeenCalledTimes(1)
         expect(afterRestoreSpy).toHaveBeenCalledWith(expect.objectContaining({ type: 'books::book.afterRestore' }))
     })
+
+    it('should throw an error when attempting to remove a non-existent record', async () => {
+        await expect(service.remove({ id: 999 })).rejects.toThrow('Item not found')
+    })
+
+    it('should throw an error when attempting to update a non-existent record', async () => {
+        const updatedInput = { title: 'Updated Book', author: 'Updated Author', publishedDate: new Date() }
+        await expect(service.update({ id: 999 }, updatedInput)).rejects.toThrow('Item not found')
+    })
 })

package/src/domain/services/read-only-model-service.test.ts

@@ -83,8 +83,10 @@ describe('ReadOnlyModelService', () => {
         expect(record).toEqual(input)
     })
 
-    it('should throw an error when loading a non-existent record', async () => {
-        await expect(service.load({ id: 42 })).rejects.toThrow('Item not found')
+    it('should return null when loading a non-existent record', async () => {
+        const record = await service.load({ id: 999 })
+
+        expect(record).toBeNull()
     })
 
     it('should load multiple records', async () => {

package/src/test/mock/repositories/mock-memory-repository.test.ts

@@ -52,7 +52,8 @@ describe('MockMemoryRepository', () => {
         const removedItem = await repository.remove({ id: createdItem.id })
 
         expect(removedItem).toEqual(input)
-        await expect(repository.load({ id: createdItem.id })).rejects.toThrow('Item not found')
+        const loadedItem = await repository.load({ id: createdItem.id })
+        expect(loadedItem).toBeNull()
     })
 
     it('should restore a removed item', async () => {
@@ -92,4 +93,9 @@ describe('MockMemoryRepository', () => {
         expect(await repository.load({ id: createdItem1.id })).toEqual(createdItem1)
         expect(await repository.load({ id: createdItem2.id })).toEqual(createdItem2)
     })
+
+    it('should return null when loading a non-existent item', async () => {
+        const result = await repository.load({ id: 999 })
+        expect(result).toBeNull()
+    })
 })

package/src/test/mock/repositories/mock-memory-repository.ts

@@ -28,17 +28,13 @@ export class MockMemoryRepository<TSchema extends AnyModelSchema> implements IRe
         }
     }
 
-    async load(input: InferLookup<TSchema>): Promise<InferDetail<TSchema>> {
+    async load(input: InferLookup<TSchema>): Promise<InferDetail<TSchema> | null> {
         if (!this.entityMetadata?.primaryKey) {
             throw new Error('Primary key is not defined in the schema metadata')
         }
 
         const item = await this.data.get(input[this.entityMetadata.primaryKey])
-        if (!item) {
-            throw new Error('Item not found')
-        }
-
-        return item
+        return item || null
     }
     async loadMany(inputs: InferLookup<TSchema>[]): Promise<InferDetail<TSchema>[]> {
         if (!this.entityMetadata?.primaryKey) {