@t4h.framework/orm 0.2.0 → 0.4.0

package/.ai/skills/framework-orm/SKILL.md

@@ -0,0 +1,325 @@
+---
+name: framework-orm
+description: >-
+  Guides correct use of @t4h.framework/orm in T4H Framework workflows: entity
+  decorators (@Entity, @Property, @Index), the ORM model (create, find, findOne,
+  exists), Ref and RefCollection, query operators, constraint validation, ORM
+  activities, and ORMClaim wiring. Use when defining database entities, persisting
+  or querying rows in workflows, implementing ORMClaim providers, testing ORM
+  activities with Claim.run, or working in packages/orm.
+---
+
+# @t4h.framework/orm
+
+ORM activities, claim, and models for database operations within workflows. Package path: `framework/packages/orm`. Peer dependency: `@t4h.framework/core`.
+
+Import from `src/orm.ts` only — do not reference unexported modules:
+
+```typescript
+import {
+  Entity, Property, Index, ORM, Ref, RefCollection,
+  ORMClaim, ConstraintError,
+  ORMCreateActivity, ORMFindActivity, ORMFindOneActivity,
+  ORMGetSnapshotActivity, ORMUpdateActivity, ORMRemoveActivity,
+  getEntityMetadata, getEntityTableName, getEntityProperties,
+  type EntityInsertData, type EntityPartialData, type FindWhere,
+  type SerializableCreateInput, type SerializableFindInput,
+  type SerializableGetSnapshotInput, type SerializableUpdateInput,
+  type SerializableRemoveInput,
+} from '@t4h.framework/orm'
+```
+
+Node `>=22`. See [README.md](../../../README.md).
+
+---
+
+## Architecture
+
+`Workflow` → `ORM` / `Ref` methods (`History.bind` on ORM activities) → `ORMClaim` (runtime database adapter).
+
+| Layer | Role |
+|-------|------|
+| **ORM** | High-level API; applies defaults + constraints before activities |
+| **Ref** / **RefCollection** | Row handles returned by create/find |
+| **Activities** | `SyncActivity` classes delegating to `ORMClaim` |
+| **ORMClaim** | Abstract claim; runtime provides concrete DB implementation |
+
+All ORM activities use `new Claim({ orm: ORMClaim })` and delegate in `run()`.
+
+---
+
+## Defining entities
+
+Enable decorator metadata in the project `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  }
+}
+```
+
+Import `reflect-metadata` where decorators are evaluated (Property decorator imports it).
+
+### @Entity
+
+```typescript
+@Entity({ tableName: 'users' })
+class User {
+  @Property({ type: 'string' })
+  public name!: string
+
+  @Property({ type: 'string' })
+  public email!: string
+
+  @Property({ type: 'boolean', default: true })
+  public active!: boolean
+}
+```
+
+- `tableName` is optional; defaults to the class name (`User` → `"User"`).
+- Use `getEntityTableName(User)` or rely on ORM to resolve the table name.
+
+### @Property
+
+Options: `type?`, `nullable?` (default required), `default?`, `index?` (adds index metadata).
+
+Omit `type` to infer from design metadata (`String`→`string`, `Number`→`number`, etc.). Declare domain types (`uuid`) explicitly. Validated types: `string`, `uuid`, `number`, `boolean`, `array`, `date`, `object`. No `type` → skip type validation.
+
+### @Index
+
+Class-level composite indexes:
+
+```typescript
+@Index({ properties: ['tenantId', 'email'], name: 'accounts_tenant_email_idx' })
+class Account { /* ... */ }
+```
+
+`properties` must be non-empty or the decorator throws. Per-property `@Property({ index: true })` also registers `{ properties: [propertyKey] }`.
+
+---
+
+## ORM configuration
+
+`ORM` extends `SerializableClass` — instances can be serialized for workflow persistence.
+
+```typescript
+const orm = new ORM({
+  connectionString: 'postgresql://localhost:5432/mydb',
+  entities: [User, Product],
+})
+```
+
+- `entities`: array of entity **constructors** (decorated classes).
+- `config.entities` stores resolved `EntityMetadata` (table name, properties map, indexes).
+
+Restore from serialized state:
+
+```typescript
+const orm = await ORM.fromSerializable(serialized, v => v)
+```
+
+---
+
+## CRUD in workflows
+
+ORM methods bind activities via `History.bind` — calls inside a workflow are **reconciler-driven** (replay-safe).
+
+### Create
+
+```typescript
+// Single row → Ref<T>
+const userRef = await orm.create(User, {
+  name: 'John',
+  email: 'john@example.com',
+  active: true,
+})
+
+// Batch → RefCollection<T>
+const usersRef = await orm.create(User, [
+  { name: 'Alice', email: 'alice@example.com', active: true },
+  { name: 'Bob', email: 'bob@example.com', active: true },
+])
+```
+
+Defaults are applied before persistence (`applyDefaultProperties`). Omitted fields with `@Property({ default })` are filled in.
+
+### Find
+
+```typescript
+const userRef = await orm.findOne(User, {
+  where: { email: 'john@example.com' },
+  orderBy: { name: 'asc' },
+}) // Ref<User> | null
+
+const usersRef = await orm.find(User, {
+  where: { active: true },
+  orderBy: { name: 'asc' },
+  limit: 10,
+  offset: 0,
+}) // RefCollection<User>
+
+const exists = await orm.exists(User, {
+  where: { email: 'john@example.com' },
+}) // boolean (delegates to findOne)
+```
+
+`findOne` activity internally calls `claim.find` with `limit: 1`.
+
+### Ref operations
+
+```typescript
+const snapshot = await userRef.getSnapshot() // T | null — entity instance via Reflect.construct
+await userRef.update({ name: 'Jane' })         // partial patch only
+await userRef.remove()
+```
+
+`getSnapshot` returns `null` when the row no longer exists. `update` validates only keys present in the patch.
+
+**RefCollection:** `toArray()`, `length`, `at(i)`, async `forEach`/`map`/`filter`, `Symbol.iterator`.
+
+---
+
+## Query operators
+
+`where` uses `FindWhere<T>` — implicit equality or operator objects:
+
+```typescript
+await orm.find(User, {
+  where: {
+    name: 'John',                    // $eq (implicit)
+    active: { $ne: false },
+    email: { $like: '%@example%' },
+    age: { $gte: 18, $lt: 65 },
+    status: { $in: ['active', 'pending'] },
+    $or: [{ name: 'Alice' }, { name: 'Bob' }],
+    $and: [{ active: true }, { age: { $gte: 18 } }],
+  },
+})
+```
+
+Available operators: `$eq`, `$ne`, `$in`, `$nin`, `$not`, `$gt`, `$gte`, `$lt`, `$lte`, `$like`, `$ilike`, `$and`, `$or`.
+
+---
+
+## Constraint validation
+
+Validation runs in the ORM library (`ORM.create` and `Ref.update`), **not** in `ORMClaim` implementations. Failures throw `ConstraintError`.
+
+### Create pipeline
+
+1. `applyDefaultProperties` — fills `default` for `undefined` fields
+2. `assertPropertyTypeConstraint` — validates declared types
+3. `assertNonNullablePropertyConstraint` — required fields must be present
+
+### Update pipeline
+
+1. Defaults only for keys present in the patch
+2. Same asserts, scoped to patch keys via `{ keys: Object.keys(data) }`
+
+### Handling errors
+
+```typescript
+import { ConstraintError, ORM } from '@t4h.framework/orm'
+
+try {
+  await orm.create(User, { email: 'bad' } as EntityInsertData<User>)
+} catch (error) {
+  if (error instanceof ConstraintError) {
+    // e.g. 'Property "name" is required'
+    // e.g. 'Property "name" must be of type string'
+  }
+}
+```
+
+Constraint checks run **before** activities are invoked — failed creates/updates never reach `ORMClaim`.
+
+---
+
+## ORMClaim (runtime dependency)
+
+Runtime must register a concrete implementation:
+
+```typescript
+{ provide: ORMClaim, value: new MyORMClaimImpl() }
+```
+
+Contract:
+
+```typescript
+abstract class ORMClaim<R extends SerializableRowRef> {
+  abstract find(input: SerializableFindInput): R[] | Promise<R[]>
+  abstract create(input: SerializableCreateInput): R[] | Promise<R[]>
+  abstract getSnapshot(input: SerializableGetSnapshotInput<R>): SerializedRow | null | Promise<SerializedRow | null>
+  abstract update(input: SerializableUpdateInput<R>): void | Promise<void>
+  abstract remove(input: SerializableRemoveInput<R>): void | Promise<void>
+}
+```
+
+Activity inputs always include `orm` + `table`; create adds `data[]`, find adds `where` (+ optional `orderBy`/`limit`/`offset`), snapshot/update/remove add `ref` (opaque `Serializable` row handle). Update also includes partial `data`.
+
+Access claim-backed activity logic only inside `Claim.run` or workflow `History.run` context.
+
+---
+
+## Activities
+
+All extend `SyncActivity` and delegate to `ORMClaim`:
+
+| Activity | Input | Output |
+|----------|-------|--------|
+| `ORMCreateActivity` | `SerializableCreateInput` | `SerializableRowRef[]` |
+| `ORMFindActivity` | `SerializableFindInput` | `SerializableRowRef[]` |
+| `ORMFindOneActivity` | `SerializableFindInput` | `SerializableRowRef \| null` |
+| `ORMGetSnapshotActivity` | `SerializableGetSnapshotInput` | `SerializedRow \| null` |
+| `ORMUpdateActivity` | `SerializableUpdateInput` | `void` |
+| `ORMRemoveActivity` | `SerializableRemoveInput` | `void` |
+
+Prefer **`ORM` / `Ref` APIs** in workflow code — they apply constraints and return typed handles. Use activities directly only for advanced/testing scenarios.
+
+---
+
+## Workflow example
+
+From `examples/basic/src/workflows/orm.ts` — define entities, instantiate `ORM` with `connectionString` + `entities`, use inside `Workflow`:
+
+```typescript
+export const orm = new ORM({ connectionString: '...', entities: [User] })
+
+export const ormWorkflow = new Workflow({ id: 'orm' }, async () => {
+  await orm.create(User, { name: 'John', email: 'john@example.com', age: 20 })
+  const user = await orm.findOne(User, { where: { email: 'john@example.com' } })
+  await user?.update({ name: 'John Updated' })
+  await user?.remove()
+  return { user }
+})
+```
+
+Ensure the runtime provides `ORMClaim`.
+
+---
+
+## Testing
+
+Run: `yarn test` in `packages/orm`.
+
+**ORM / Ref unit tests** — mock `History.bind` by activity name (`ORMCreateActivity`, `ORMFindOneActivity`, etc.) per `src/models/__tests__/ORM.spec.ts`. Assert `ConstraintError` before activities run: `expect(mockCreate).not.toHaveBeenCalled()`.
+
+**Activity unit tests** — wrap `activity.run(input)` in `Claim.run([{ provide: ORMClaim, value: mockClaim }], fn)` per `src/activities/__tests__/ORMCreateActivity.spec.ts`.
+
+**Workflow integration** — `WorkflowTesting.run` with a mocked `ORMClaim` provider (see **framework-core** skill).
+
+---
+
+## Checklist for agents
+
+1. **`@Entity` + `@Property`** with `experimentalDecorators` + `emitDecoratorMetadata`.
+2. Register entities in **`ORM({ entities: [...] })`**; runtime provides **`ORMClaim`**.
+3. Use **`orm` / `Ref` APIs** in workflows — not raw SQL or direct claim calls.
+4. Handle **`ConstraintError`**; validation runs before activities.
+5. **`Ref.update`** is partial; **`getSnapshot`** returns entity instances.
+6. Test with **`History.bind` mocks** or **`Claim.run` + ORMClaim mock**; only use exported APIs.
+
+See also: `packages/orm/README.md`, `examples/basic/src/workflows/orm.ts`.

package/README.md

@@ -64,6 +64,60 @@ class User {
 })
 ```
 
+When `type` is omitted, it is inferred from the TypeScript property type if the project enables `emitDecoratorMetadata` (and imports `reflect-metadata`). Domain types such as `uuid` must be declared explicitly.
+
+If `nullable` is omitted, the property is required at runtime validation.
+
+### TypeScript configuration for entity classes
+
+Projects that define entities with `@Property()` should enable:
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  }
+}
+```
+
+## Constraints
+
+Row validation runs in the ORM library (`ORM.create` and `Ref.update`), not in `ORMClaim` implementations. Failed checks throw `ConstraintError`.
+
+### Pipeline
+
+**Create** (full row, after defaults):
+
+1. `applyDefaultProperties` — fills `default` for `undefined` fields
+2. `assertPropertyTypeConstraint` — validates declared types
+3. `assertNonNullablePropertyConstraint` — required fields must be present
+4. `assertUniqueConstraint` — no duplicates in the batch, then no conflicting row in storage via `orm.exists`
+
+**Update** (partial patch only):
+
+1. Defaults only for keys present in the patch
+2. Same asserts, scoped to patch keys
+3. Unique checks skip values unchanged vs `getSnapshot()` (same row keeps its current unique value)
+
+### Supported property types
+
+`string`, `uuid`, `number`, `boolean`, `array`, `date`, `object`. Properties without `type` skip type validation.
+
+### Example
+
+```typescript
+import { ConstraintError, ORM } from '@t4h.framework/orm'
+
+try {
+  await orm.create(User, { email: 'taken@example.com' })
+} catch (error) {
+  if (error instanceof ConstraintError) {
+    // handle validation failure
+  }
+}
+```
+
 ## ORM Model
 
 The `ORM` class provides a high-level API for database operations. It wraps the underlying activities (`ORMCreateActivity`, `ORMFindActivity`, `ORMFindOneActivity`).

package/dist/activities/ORMGetSnapshotActivity.d.ts

@@ -3,11 +3,11 @@ import type { SerializableGetSnapshotInput, SerializableRowRef, SerializedRow }
 declare const CLAIMS_KEY: unique symbol;
 export declare class ORMGetSnapshotActivity extends SyncActivity<[
     input: SerializableGetSnapshotInput<SerializableRowRef>
-], SerializableGetSnapshotInput<SerializableRowRef>, SerializedRow, SerializedRow> {
+], SerializableGetSnapshotInput<SerializableRowRef>, SerializedRow | null, SerializedRow | null> {
     private readonly [CLAIMS_KEY];
     toInput(input: SerializableGetSnapshotInput<SerializableRowRef>): SerializableGetSnapshotInput<SerializableRowRef>;
-    run(input: SerializableGetSnapshotInput<SerializableRowRef>): SerializedRow | Promise<SerializedRow>;
-    toOutput(output: SerializedRow): SerializedRow;
+    run(input: SerializableGetSnapshotInput<SerializableRowRef>): SerializedRow | Promise<SerializedRow | null> | null;
+    toOutput(output: SerializedRow | null): SerializedRow | null;
 }
 export {};
 //# sourceMappingURL=ORMGetSnapshotActivity.d.ts.map

package/dist/activities/ORMGetSnapshotActivity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ORMGetSnapshotActivity.d.ts","sourceRoot":"","sources":["../../src/activities/ORMGetSnapshotActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAS,MAAM,qBAAqB,CAAA;AAGzD,OAAO,KAAK,EACV,4BAA4B,EAC5B,kBAAkB,EAClB,aAAa,EACd,MAAM,mBAAmB,CAAA;AAE1B,QAAA,MAAM,UAAU,eAA6C,CAAA;AAE7D,qBAAa,sBAAuB,SAAQ,YAAY,CACtD;IAAC,KAAK,EAAE,4BAA4B,CAAC,kBAAkB,CAAC;CAAC,EACzD,4BAA4B,CAAC,kBAAkB,CAAC,EAChD,aAAa,EACb,aAAa,CACd;IACC,OAAO,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,CAE3B;IAEK,OAAO,CACZ,KAAK,EAAE,4BAA4B,CAAC,kBAAkB,CAAC,GACtD,4BAA4B,CAAC,kBAAkB,CAAC;IAI5C,GAAG,CAAC,KAAK,EAAE,4BAA4B,CAAC,kBAAkB,CAAC;IAI3D,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa;CAGtD"}
+{"version":3,"file":"ORMGetSnapshotActivity.d.ts","sourceRoot":"","sources":["../../src/activities/ORMGetSnapshotActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAS,MAAM,qBAAqB,CAAA;AAGzD,OAAO,KAAK,EACV,4BAA4B,EAC5B,kBAAkB,EAClB,aAAa,EACd,MAAM,mBAAmB,CAAA;AAE1B,QAAA,MAAM,UAAU,eAA6C,CAAA;AAE7D,qBAAa,sBAAuB,SAAQ,YAAY,CACtD;IAAC,KAAK,EAAE,4BAA4B,CAAC,kBAAkB,CAAC;CAAC,EACzD,4BAA4B,CAAC,kBAAkB,CAAC,EAChD,aAAa,GAAG,IAAI,EACpB,aAAa,GAAG,IAAI,CACrB;IACC,OAAO,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,CAE3B;IAEK,OAAO,CACZ,KAAK,EAAE,4BAA4B,CAAC,kBAAkB,CAAC,GACtD,4BAA4B,CAAC,kBAAkB,CAAC;IAI5C,GAAG,CAAC,KAAK,EAAE,4BAA4B,CAAC,kBAAkB,CAAC;IAI3D,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,aAAa,GAAG,IAAI;CAGpE"}

package/dist/activities/ORMGetSnapshotActivity.js.map

@@ -1 +1 @@
-{"version":3,"file":"ORMGetSnapshotActivity.js","sourceRoot":"","sources":["../../src/activities/ORMGetSnapshotActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAEzD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAOhD,MAAM,UAAU,GAAG,MAAM,CAAC,kCAAkC,CAAC,CAAA;AAE7D,MAAM,OAAO,sBAAuB,SAAQ,YAK3C;IACkB,CAAC,UAAU,CAAC,GAAG,IAAI,KAAK,CAAC;QACxC,GAAG,EAAE,QAAQ;KACd,CAAC,CAAA;IAEK,OAAO,CACZ,KAAuD;QAEvD,OAAO,KAAK,CAAA;IACd,CAAC;IAEM,GAAG,CAAC,KAAuD;QAChE,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;IAChD,CAAC;IAEM,QAAQ,CAAC,MAAqB;QACnC,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}
+{"version":3,"file":"ORMGetSnapshotActivity.js","sourceRoot":"","sources":["../../src/activities/ORMGetSnapshotActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAEzD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAOhD,MAAM,UAAU,GAAG,MAAM,CAAC,kCAAkC,CAAC,CAAA;AAE7D,MAAM,OAAO,sBAAuB,SAAQ,YAK3C;IACkB,CAAC,UAAU,CAAC,GAAG,IAAI,KAAK,CAAC;QACxC,GAAG,EAAE,QAAQ;KACd,CAAC,CAAA;IAEK,OAAO,CACZ,KAAuD;QAEvD,OAAO,KAAK,CAAA;IACd,CAAC;IAEM,GAAG,CAAC,KAAuD;QAChE,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;IAChD,CAAC;IAEM,QAAQ,CAAC,MAA4B;QAC1C,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

package/dist/claims/ORMClaim.d.ts

@@ -2,7 +2,7 @@ import type { SerializableCreateInput, SerializableFindInput, SerializableGetSna
 export declare abstract class ORMClaim<R extends SerializableRowRef> {
     abstract find(input: SerializableFindInput): R[] | Promise<R[]>;
     abstract create(input: SerializableCreateInput): R[] | Promise<R[]>;
-    abstract getSnapshot(input: SerializableGetSnapshotInput<R>): SerializedRow | Promise<SerializedRow>;
+    abstract getSnapshot(input: SerializableGetSnapshotInput<R>): SerializedRow | null | Promise<SerializedRow | null>;
     abstract update(input: SerializableUpdateInput<R>): void | Promise<void>;
     abstract remove(input: SerializableRemoveInput<R>): void | Promise<void>;
 }

package/dist/claims/ORMClaim.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ORMClaim.d.ts","sourceRoot":"","sources":["../../src/claims/ORMClaim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACd,MAAM,mBAAmB,CAAA;AAE1B,8BAAsB,QAAQ,CAAC,CAAC,SAAS,kBAAkB;aACzC,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;aAEtD,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;aAE1D,WAAW,CACzB,KAAK,EAAE,4BAA4B,CAAC,CAAC,CAAC,GACrC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;aAEzB,MAAM,CACpB,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAChC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;aAEP,MAAM,CACpB,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAChC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CACxB"}
+{"version":3,"file":"ORMClaim.d.ts","sourceRoot":"","sources":["../../src/claims/ORMClaim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACd,MAAM,mBAAmB,CAAA;AAE1B,8BAAsB,QAAQ,CAAC,CAAC,SAAS,kBAAkB;aACzC,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;aAEtD,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;aAE1D,WAAW,CACzB,KAAK,EAAE,4BAA4B,CAAC,CAAC,CAAC,GACrC,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;aAEvC,MAAM,CACpB,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAChC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;aAEP,MAAM,CACpB,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAChC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CACxB"}

package/dist/constraints/__tests__/create-entity-metadata.d.ts

@@ -0,0 +1,3 @@
+import type { EntityMetadata, PropertyMetadata } from '../../decorators/metadata.js';
+export declare function createEntityMetadata(properties: Record<string, Omit<PropertyMetadata, 'name'>>): EntityMetadata;
+//# sourceMappingURL=create-entity-metadata.d.ts.map

package/dist/constraints/__tests__/create-entity-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-entity-metadata.d.ts","sourceRoot":"","sources":["../../../src/constraints/__tests__/create-entity-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EACjB,MAAM,8BAA8B,CAAA;AAErC,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,GACzD,cAAc,CAUhB"}

package/dist/constraints/__tests__/create-entity-metadata.js

@@ -0,0 +1,10 @@
+export function createEntityMetadata(properties) {
+    return {
+        indexes: [],
+        properties: new Map(Object.entries(properties).map(([name, meta]) => [
+            name,
+            { name, indexes: [], ...meta },
+        ])),
+    };
+}
+//# sourceMappingURL=create-entity-metadata.js.map

package/dist/constraints/__tests__/create-entity-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-entity-metadata.js","sourceRoot":"","sources":["../../../src/constraints/__tests__/create-entity-metadata.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,oBAAoB,CAClC,UAA0D;IAE1D,OAAO;QACL,OAAO,EAAE,EAAE;QACX,UAAU,EAAE,IAAI,GAAG,CACjB,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;YAC/C,IAAI;YACJ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE;SAC/B,CAAC,CACH;KACF,CAAA;AACH,CAAC"}

package/dist/constraints/apply-default-properties.d.ts

@@ -0,0 +1,7 @@
+import type { EntityMetadata, SerializedRow } from '../orm.js';
+export declare function applyDefaultProperties(rows: SerializedRow[] | SerializedRow, entity: EntityMetadata, keys?: string[]): {
+    [x: string]: import("@t4h.framework/core").Serializable;
+} | {
+    [x: string]: import("@t4h.framework/core").Serializable;
+}[];
+//# sourceMappingURL=apply-default-properties.d.ts.map

package/dist/constraints/apply-default-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-default-properties.d.ts","sourceRoot":"","sources":["../../src/constraints/apply-default-properties.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAmB9D,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,EAAE,GAAG,aAAa,EACrC,MAAM,EAAE,cAAc,EACtB,IAAI,CAAC,EAAE,MAAM,EAAE;;;;IAMhB"}

package/dist/constraints/apply-default-properties.js

@@ -0,0 +1,16 @@
+function applyDefaultPropertiesToRow(raw, entity, keys) {
+    const row = { ...raw };
+    for (const [name, meta] of entity.properties.entries()) {
+        if (keys && !keys.includes(name))
+            continue;
+        if (row[name] === undefined && meta.default !== undefined)
+            row[name] = meta.default;
+    }
+    return row;
+}
+export function applyDefaultProperties(rows, entity, keys) {
+    if (Array.isArray(rows))
+        return rows.map(raw => applyDefaultPropertiesToRow(raw, entity, keys));
+    return applyDefaultPropertiesToRow(rows, entity, keys);
+}
+//# sourceMappingURL=apply-default-properties.js.map

package/dist/constraints/apply-default-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-default-properties.js","sourceRoot":"","sources":["../../src/constraints/apply-default-properties.ts"],"names":[],"mappings":"AAEA,SAAS,2BAA2B,CAClC,GAAkB,EAClB,MAAsB,EACtB,IAAe;IAEf,MAAM,GAAG,GAAG,EAAE,GAAG,GAAG,EAAE,CAAA;IAEtB,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAQ;QAE1C,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YACvD,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAA;IAC5B,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,IAAqC,EACrC,MAAsB,EACtB,IAAe;IAEf,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,2BAA2B,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;IAExE,OAAO,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;AACxD,CAAC"}

package/dist/constraints/assert-constraints.d.ts

@@ -0,0 +1,7 @@
+import { type EntityConstructor, type SerializedRow } from '../orm.js';
+interface AssertConstraintsOptions {
+    keys?: string[];
+}
+export declare function assertConstraints<T>(entity: EntityConstructor<T>, rows: SerializedRow[], options?: AssertConstraintsOptions): Promise<void>;
+export {};
+//# sourceMappingURL=assert-constraints.d.ts.map

package/dist/constraints/assert-constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-constraints.d.ts","sourceRoot":"","sources":["../../src/constraints/assert-constraints.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,WAAW,CAAA;AAIlB,UAAU,wBAAwB;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC5B,IAAI,EAAE,aAAa,EAAE,EACrB,OAAO,CAAC,EAAE,wBAAwB,iBAWnC"}

package/dist/constraints/assert-constraints.js

@@ -0,0 +1,13 @@
+import { getEntityMetadata, } from '../orm.js';
+import { assertNonNullablePropertyConstraint } from './assert-non-nullable-property-constraint.js';
+import { assertPropertyTypeConstraint } from './assert-property-type-constraint.js';
+export async function assertConstraints(entity, rows, options) {
+    const entityMetadata = getEntityMetadata(entity);
+    assertPropertyTypeConstraint(rows, entityMetadata, {
+        keys: options?.keys,
+    });
+    assertNonNullablePropertyConstraint(rows, entityMetadata, {
+        keys: options?.keys,
+    });
+}
+//# sourceMappingURL=assert-constraints.js.map

package/dist/constraints/assert-constraints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-constraints.js","sourceRoot":"","sources":["../../src/constraints/assert-constraints.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAGlB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,mCAAmC,EAAE,MAAM,8CAA8C,CAAA;AAClG,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAA;AAMnF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA4B,EAC5B,IAAqB,EACrB,OAAkC;IAElC,MAAM,cAAc,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAEhD,4BAA4B,CAAC,IAAI,EAAE,cAAc,EAAE;QACjD,IAAI,EAAE,OAAO,EAAE,IAAI;KACpB,CAAC,CAAA;IAEF,mCAAmC,CAAC,IAAI,EAAE,cAAc,EAAE;QACxD,IAAI,EAAE,OAAO,EAAE,IAAI;KACpB,CAAC,CAAA;AACJ,CAAC"}

package/dist/constraints/assert-non-nullable-property-constraint.d.ts

@@ -0,0 +1,7 @@
+import type { EntityMetadata, SerializedRow } from '../orm.js';
+interface AssertNonNullablePropertyConstraintOptions {
+    keys?: string[];
+}
+export declare function assertNonNullablePropertyConstraint(rows: SerializedRow[], entity: EntityMetadata, options?: AssertNonNullablePropertyConstraintOptions): void;
+export {};
+//# sourceMappingURL=assert-non-nullable-property-constraint.d.ts.map

package/dist/constraints/assert-non-nullable-property-constraint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-non-nullable-property-constraint.d.ts","sourceRoot":"","sources":["../../src/constraints/assert-non-nullable-property-constraint.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAE9D,UAAU,0CAA0C;IAClD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,aAAa,EAAE,EACrB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,0CAA0C,QAYrD"}

package/dist/constraints/assert-non-nullable-property-constraint.js

@@ -0,0 +1,14 @@
+import { ConstraintError } from '../errors/ConstraintError.js';
+export function assertNonNullablePropertyConstraint(rows, entity, options) {
+    rows.forEach(row => {
+        for (const [name, meta] of entity.properties.entries()) {
+            if (options?.keys && !options.keys.includes(name))
+                continue;
+            if (meta.nullable)
+                continue;
+            if (row[name] === null || row[name] === undefined)
+                throw new ConstraintError(`Property "${name}" is required`);
+        }
+    });
+}
+//# sourceMappingURL=assert-non-nullable-property-constraint.js.map

package/dist/constraints/assert-non-nullable-property-constraint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-non-nullable-property-constraint.js","sourceRoot":"","sources":["../../src/constraints/assert-non-nullable-property-constraint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAO9D,MAAM,UAAU,mCAAmC,CACjD,IAAqB,EACrB,MAAsB,EACtB,OAAoD;IAEpD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QACjB,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,OAAO,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,SAAQ;YAE3D,IAAI,IAAI,CAAC,QAAQ;gBAAE,SAAQ;YAE3B,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS;gBAC/C,MAAM,IAAI,eAAe,CAAC,aAAa,IAAI,eAAe,CAAC,CAAA;QAC/D,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/constraints/assert-property-type-constraint.d.ts

@@ -0,0 +1,7 @@
+import type { EntityMetadata, SerializedRow } from '../orm.js';
+interface AssertPropertyTypeConstraintOptions {
+    keys?: string[];
+}
+export declare function assertPropertyTypeConstraint(rows: SerializedRow[], entity: EntityMetadata, options?: AssertPropertyTypeConstraintOptions): void;
+export {};
+//# sourceMappingURL=assert-property-type-constraint.d.ts.map

package/dist/constraints/assert-property-type-constraint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-property-type-constraint.d.ts","sourceRoot":"","sources":["../../src/constraints/assert-property-type-constraint.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAgB9D,UAAU,mCAAmC;IAC3C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,aAAa,EAAE,EACrB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,mCAAmC,QAyB9C"}

package/dist/constraints/assert-property-type-constraint.js

@@ -0,0 +1,30 @@
+import { ConstraintError } from '../errors/ConstraintError.js';
+const UUID_REGEX = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+const PROPERTY_TYPE = {
+    string: (value) => typeof value === 'string',
+    uuid: (value) => typeof value === 'string' && UUID_REGEX.test(value),
+    number: (value) => typeof value === 'number' && !Number.isNaN(value),
+    boolean: (value) => typeof value === 'boolean',
+    array: (value) => Array.isArray(value),
+    date: (value) => value instanceof Date || typeof value === 'string',
+    object: (value) => typeof value === 'object' && value !== null && !Array.isArray(value),
+};
+export function assertPropertyTypeConstraint(rows, entity, options) {
+    rows.forEach(row => {
+        for (const [name, meta] of entity.properties.entries()) {
+            if (options?.keys && !options.keys.includes(name))
+                continue;
+            const value = row[name];
+            if (!meta.type)
+                continue;
+            if (value === undefined || value === null)
+                continue;
+            const validator = PROPERTY_TYPE[meta.type];
+            if (!validator)
+                throw new ConstraintError(`Property "${name}" has unsupported type "${meta.type}"`);
+            if (!validator(value))
+                throw new ConstraintError(`Property "${name}" must be of type ${meta.type}`);
+        }
+    });
+}
+//# sourceMappingURL=assert-property-type-constraint.js.map

package/dist/constraints/assert-property-type-constraint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-property-type-constraint.js","sourceRoot":"","sources":["../../src/constraints/assert-property-type-constraint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAG9D,MAAM,UAAU,GACd,+EAA+E,CAAA;AAEjF,MAAM,aAAa,GAAG;IACpB,MAAM,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ;IACrD,IAAI,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;IAC7E,MAAM,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;IAC7E,OAAO,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,SAAS;IACvD,KAAK,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;IAC/C,IAAI,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,YAAY,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;IAC5E,MAAM,EAAE,CAAC,KAAc,EAAE,EAAE,CACzB,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;CACvE,CAAA;AAMD,MAAM,UAAU,4BAA4B,CAC1C,IAAqB,EACrB,MAAsB,EACtB,OAA6C;IAE7C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QACjB,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,OAAO,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,SAAQ;YAE3D,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAA;YAEvB,IAAI,CAAC,IAAI,CAAC,IAAI;gBAAE,SAAQ;YAExB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAQ;YAEnD,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,IAAkC,CAAC,CAAA;YAExE,IAAI,CAAC,SAAS;gBACZ,MAAM,IAAI,eAAe,CACvB,aAAa,IAAI,2BAA2B,IAAI,CAAC,IAAI,GAAG,CACzD,CAAA;YAEH,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;gBACnB,MAAM,IAAI,eAAe,CACvB,aAAa,IAAI,qBAAqB,IAAI,CAAC,IAAI,EAAE,CAClD,CAAA;QACL,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/constraints/assert-unique-constraint.d.ts

@@ -0,0 +1,11 @@
+import type { Serializable } from '@t4h.framework/core';
+import type { EntityMetadata, SerializedRow } from '../orm.js';
+import type { FindWhere } from '../typings/FindWhere.js';
+interface AssertUniqueConstraintOptions<T> {
+    keys?: string[];
+    validator: (where: FindWhere<T>) => Promise<unknown>;
+    isUnchanged?: (name: string, value: Serializable) => boolean;
+}
+export declare function assertUniqueConstraint<T>(rows: SerializedRow[], entity: EntityMetadata, options: AssertUniqueConstraintOptions<T>): Promise<void>;
+export {};
+//# sourceMappingURL=assert-unique-constraint.d.ts.map

package/dist/constraints/assert-unique-constraint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-unique-constraint.d.ts","sourceRoot":"","sources":["../../src/constraints/assert-unique-constraint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGvD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD,UAAU,6BAA6B,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACpD,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAA;CAC7D;AA6BD,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,IAAI,EAAE,aAAa,EAAE,EACrB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,6BAA6B,CAAC,CAAC,CAAC,iBA6B1C"}

package/dist/constraints/assert-unique-constraint.js

@@ -0,0 +1,41 @@
+import { ConstraintError } from '../errors/ConstraintError.js';
+function assertUniqueWithinBatch(rows, entity, keys) {
+    entity.properties.entries().forEach(([name, meta]) => {
+        if (keys && !keys.includes(name))
+            return;
+        if (!meta.unique)
+            return;
+        const seen = new Set();
+        rows.forEach(row => {
+            const value = row[name];
+            if (value === undefined || value === null)
+                return;
+            if (seen.has(value))
+                throw new ConstraintError(`Unique constraint violation for property "${name}" with value "${value}" (duplicate in batch)`);
+            seen.add(value);
+        });
+    });
+}
+export async function assertUniqueConstraint(rows, entity, options) {
+    assertUniqueWithinBatch(rows, entity, options?.keys);
+    await Promise.all(rows.map(async (row) => {
+        for (const [name, meta] of entity.properties.entries()) {
+            if (options?.keys && !options.keys.includes(name))
+                continue;
+            if (!meta.unique)
+                continue;
+            const value = row[name];
+            if (value === undefined || value === null)
+                continue;
+            if (options.isUnchanged?.(name, value))
+                continue;
+            const result = await options.validator({
+                [name]: value,
+            });
+            if (result === undefined || result === null)
+                continue;
+            throw new ConstraintError(`Unique constraint violation for property "${name}" with value "${value}"`);
+        }
+    }));
+}
+//# sourceMappingURL=assert-unique-constraint.js.map

package/dist/constraints/assert-unique-constraint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-unique-constraint.js","sourceRoot":"","sources":["../../src/constraints/assert-unique-constraint.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAU9D,SAAS,uBAAuB,CAC9B,IAAqB,EACrB,MAAsB,EACtB,IAAe;IAEf,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;QACnD,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAM;QAExC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAM;QAExB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAgB,CAAA;QAEpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACjB,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAA;YAEvB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAM;YAEjD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;gBACjB,MAAM,IAAI,eAAe,CACvB,6CAA6C,IAAI,iBAAiB,KAAK,wBAAwB,CAChG,CAAA;YAEH,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACjB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAqB,EACrB,MAAsB,EACtB,OAAyC;IAEzC,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IAEpD,MAAM,OAAO,CAAC,GAAG,CACf,IAAI,CAAC,GAAG,CAAC,KAAK,EAAC,GAAG,EAAC,EAAE;QACnB,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,OAAO,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,SAAQ;YAE3D,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,SAAQ;YAE1B,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAA;YAEvB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAQ;YAEnD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC;gBAAE,SAAQ;YAEhD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC;gBACrC,CAAC,IAAI,CAAC,EAAE,KAAK;aACE,CAAC,CAAA;YAElB,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;gBAAE,SAAQ;YAErD,MAAM,IAAI,eAAe,CACvB,6CAA6C,IAAI,iBAAiB,KAAK,GAAG,CAC3E,CAAA;QACH,CAAC;IACH,CAAC,CAAC,CACH,CAAA;AACH,CAAC"}

package/dist/decorators/Index.d.ts

@@ -0,0 +1,6 @@
+export interface IndexMetadata {
+    properties: string[];
+    name?: string;
+}
+export declare function Index(options: IndexMetadata): ClassDecorator;
+//# sourceMappingURL=Index.d.ts.map

package/dist/decorators/Index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Index.d.ts","sourceRoot":"","sources":["../../src/decorators/Index.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAS5D"}

package/dist/decorators/Index.js

@@ -0,0 +1,10 @@
+import { getEntityMetadata } from './metadata.js';
+export function Index(options) {
+    return target => {
+        if (!options.properties.length)
+            throw new Error('Index properties cannot be empty');
+        const metadata = getEntityMetadata(target);
+        metadata.indexes.push(options);
+    };
+}
+//# sourceMappingURL=Index.js.map

package/dist/decorators/Index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Index.js","sourceRoot":"","sources":["../../src/decorators/Index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAOjD,MAAM,UAAU,KAAK,CAAC,OAAsB;IAC1C,OAAO,MAAM,CAAC,EAAE;QACd,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM;YAC5B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;QAErD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAkC,CAAC,CAAA;QAEtE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAChC,CAAC,CAAA;AACH,CAAC"}

package/dist/decorators/Property.d.ts

@@ -1,3 +1,4 @@
+import 'reflect-metadata';
 import { type PropertyMetadata } from './metadata.js';
 export type PropertyOptions = Omit<PropertyMetadata, 'name'>;
 export declare function Property(options?: PropertyOptions): PropertyDecorator;

package/dist/decorators/Property.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Property.d.ts","sourceRoot":"","sources":["../../src/decorators/Property.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAExE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAA;AAE5D,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,iBAAiB,CASrE"}
+{"version":3,"file":"Property.d.ts","sourceRoot":"","sources":["../../src/decorators/Property.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAEzB,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAExE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAA;AAW5D,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,iBAAiB,CAoBrE"}

package/dist/decorators/Property.js

@@ -1,10 +1,26 @@
+import 'reflect-metadata';
 import { getEntityMetadata } from './metadata.js';
+const DESIGN_TYPE = new Map([
+    [String, 'string'],
+    [Number, 'number'],
+    [Boolean, 'boolean'],
+    [Array, 'array'],
+    [Date, 'date'],
+    [Object, 'object'],
+]);
 export function Property(options) {
     return (target, propertyKey) => {
         const metadata = getEntityMetadata(target.constructor);
+        const resolved = { ...options };
+        if (!resolved.type) {
+            const designType = Reflect.getMetadata('design:type', target, propertyKey);
+            resolved.type = DESIGN_TYPE.get(designType);
+        }
+        if (resolved.index)
+            metadata.indexes.push({ properties: [propertyKey] });
         metadata.properties.set(propertyKey, {
             name: propertyKey,
-            ...options,
+            ...resolved,
         });
     };
 }

package/dist/decorators/Property.js.map

@@ -1 +1 @@
-{"version":3,"file":"Property.js","sourceRoot":"","sources":["../../src/decorators/Property.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAyB,MAAM,eAAe,CAAA;AAIxE,MAAM,UAAU,QAAQ,CAAC,OAAyB;IAChD,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,WAA4B,CAAC,CAAA;QAEvE,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,WAAqB,EAAE;YAC7C,IAAI,EAAE,WAAqB;YAC3B,GAAG,OAAO;SACX,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"Property.js","sourceRoot":"","sources":["../../src/decorators/Property.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAEzB,OAAO,EAAE,iBAAiB,EAAyB,MAAM,eAAe,CAAA;AAIxE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAkB;IAC3C,CAAC,MAAM,EAAE,QAAQ,CAAC;IAClB,CAAC,MAAM,EAAE,QAAQ,CAAC;IAClB,CAAC,OAAO,EAAE,SAAS,CAAC;IACpB,CAAC,KAAK,EAAE,OAAO,CAAC;IAChB,CAAC,IAAI,EAAE,MAAM,CAAC;IACd,CAAC,MAAM,EAAE,QAAQ,CAAC;CACnB,CAAC,CAAA;AAEF,MAAM,UAAU,QAAQ,CAAC,OAAyB;IAChD,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,WAA4B,CAAC,CAAA;QAEvE,MAAM,QAAQ,GAAoB,EAAE,GAAG,OAAO,EAAE,CAAA;QAEhD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,CAAA;YAE1E,QAAQ,CAAC,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QAC7C,CAAC;QAED,IAAI,QAAQ,CAAC,KAAK;YAChB,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC,WAAqB,CAAC,EAAE,CAAC,CAAA;QAEhE,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,WAAqB,EAAE;YAC7C,IAAI,EAAE,WAAqB;YAC3B,GAAG,QAAQ;SACZ,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC"}

package/dist/decorators/metadata.d.ts

@@ -1,13 +1,16 @@
+import type { Serializable } from '@t4h.framework/core';
+import type { IndexMetadata } from './Index.js';
 export interface EntityMetadata {
     tableName?: string;
     properties: Map<string, PropertyMetadata>;
+    indexes: Array<IndexMetadata>;
 }
 export interface PropertyMetadata {
     name: string;
     type?: string;
     nullable?: boolean;
-    unique?: boolean;
-    default?: unknown;
+    default?: Serializable;
+    index?: boolean;
 }
 export declare function getEntityMetadata(target: new (...args: any[]) => any): EntityMetadata;
 export declare function getEntityTableName(target: new (...args: any[]) => any): string;

package/dist/decorators/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/decorators/metadata.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAID,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAClC,cAAc,CAShB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAClC,MAAM,CAIR;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAClC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAE/B"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/decorators/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACzC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAID,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAClC,cAAc,CAShB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAClC,MAAM,CAIR;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAClC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAE/B"}

package/dist/decorators/metadata.js

@@ -2,7 +2,7 @@ const entityMetadataMap = new WeakMap();
 export function getEntityMetadata(target) {
     let metadata = entityMetadataMap.get(target.prototype);
     if (!metadata) {
-        metadata = { properties: new Map() };
+        metadata = { properties: new Map(), indexes: [] };
         entityMetadataMap.set(target.prototype, metadata);
     }
     return metadata;

package/dist/decorators/metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/decorators/metadata.ts"],"names":[],"mappings":"AAaA,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAA0B,CAAA;AAE/D,MAAM,UAAU,iBAAiB,CAC/B,MAAmC;IAEnC,IAAI,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAEtD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,EAAE,UAAU,EAAE,IAAI,GAAG,EAAE,EAAE,CAAA;QACpC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IACnD,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAAmC;IAEnC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAE1C,OAAO,QAAQ,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAmC;IAEnC,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAA;AAC7C,CAAC"}
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/decorators/metadata.ts"],"names":[],"mappings":"AAkBA,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAA0B,CAAA;AAE/D,MAAM,UAAU,iBAAiB,CAC/B,MAAmC;IAEnC,IAAI,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAEtD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,EAAE,UAAU,EAAE,IAAI,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;QACjD,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IACnD,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAAmC;IAEnC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAE1C,OAAO,QAAQ,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAmC;IAEnC,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAA;AAC7C,CAAC"}

package/dist/errors/ConstraintError.d.ts

@@ -0,0 +1,4 @@
+export declare class ConstraintError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=ConstraintError.d.ts.map

package/dist/errors/ConstraintError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConstraintError.d.ts","sourceRoot":"","sources":["../../src/errors/ConstraintError.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAInC"}

package/dist/errors/ConstraintError.js

@@ -0,0 +1,7 @@
+export class ConstraintError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ConstraintError';
+    }
+}
+//# sourceMappingURL=ConstraintError.js.map

package/dist/errors/ConstraintError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConstraintError.js","sourceRoot":"","sources":["../../src/errors/ConstraintError.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF"}

package/dist/models/ORM.d.ts

@@ -1,11 +1,12 @@
-import { SerializableClass } from '@t4h.framework/core';
+import { SerializableClass, type PromiseLikeType } from '@t4h.framework/core';
 import { Ref } from './Ref.js';
 import { RefCollection } from './RefCollection.js';
+import { type EntityMetadata } from '../decorators/metadata.js';
 import type { FindWhere } from '../typings/FindWhere.js';
 import type { EntityConstructor, EntityData, EntityInsertData } from '../typings/ORM.js';
 export interface ORMConfig {
     connectionString: string;
-    entities: EntityConstructor[];
+    entities: EntityMetadata[];
 }
 export interface FindOneOptions<T> {
     where: FindWhere<T>;
@@ -19,9 +20,28 @@ export interface FindOptions<T> extends FindOneOptions<T> {
 }
 export declare class ORM extends SerializableClass {
     readonly config: ORMConfig;
-    toSerializable(): string;
-    protected fromSerializable(connectionString: string): void;
-    constructor(config: ORMConfig);
+    toSerializable(): {
+        connectionString: string;
+        entities: {
+            tableName: string | undefined;
+            indexes: {
+                properties: string[];
+                name: string | undefined;
+            }[];
+            properties: {
+                name: string;
+                type: string | undefined;
+                nullable: boolean | undefined;
+                default: import("@t4h.framework/core").Serializable;
+                index: boolean | undefined;
+            }[];
+        }[];
+    };
+    protected fromSerializable(serializable: PromiseLikeType<ReturnType<this['toSerializable']>>): void;
+    constructor(config: {
+        connectionString: string;
+        entities: EntityConstructor[];
+    });
     create<T>(entity: EntityConstructor<T>, data: EntityInsertData<T>): Promise<Ref<T>>;
     create<T>(entity: EntityConstructor<T>, data: EntityInsertData<T>[]): Promise<RefCollection<T>>;
     findOne<T>(entity: EntityConstructor<T>, options: FindOneOptions<T>): Promise<Ref<T> | null>;

package/dist/models/ORM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ORM.d.ts","sourceRoot":"","sources":["../../src/models/ORM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEhE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAKlD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAGjB,MAAM,mBAAmB,CAAA;AAM1B,MAAM,WAAW,SAAS;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,iBAAiB,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IACnB,OAAO,CAAC,EAAE;SAAG,CAAC,IAAI,MAAM,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM;KAAE,CAAA;CAC1D;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,GAAI,SAAQ,iBAAiB;aASZ,MAAM,EAAE,SAAS;IARtC,cAAc;IAIrB,SAAS,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI;gBAI9B,MAAM,EAAE,SAAS;IAIhC,MAAM,CAAC,CAAC,EACnB,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC5B,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEL,MAAM,CAAC,CAAC,EACnB,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC5B,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,GAC1B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAoBf,OAAO,CAAC,CAAC,EACpB,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC5B,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAaZ,IAAI,CAAC,CAAC,EACjB,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC5B,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAaf,MAAM,CAAC,CAAC,EACnB,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC5B,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,OAAO,CAAC;CAGpB"}
+{"version":3,"file":"ORM.d.ts","sourceRoot":"","sources":["../../src/models/ORM.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,iBAAiB,EACjB,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAMlD,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAGjB,MAAM,mBAAmB,CAAA;AAM1B,MAAM,WAAW,SAAS;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,cAAc,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IACnB,OAAO,CAAC,EAAE;SAAG,CAAC,IAAI,MAAM,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM;KAAE,CAAA;CAC1D;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,GAAI,SAAQ,iBAAiB;IACxC,SAAgB,MAAM,EAAG,SAAS,CAAA;IAE3B,cAAc;;;;;;;;;;;;;;;;;IAsBrB,SAAS,CAAC,gBAAgB,CACxB,YAAY,EAAE,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAChE,IAAI;gBAeK,MAAM,EAAE;QAClB,gBAAgB,EAAE,MAAM,CAAA;QACxB,QAAQ,EAAE,iBAAiB,EAAE,CAAA;KAC9B;IAaY,MAAM,CAAC,CAAC,EACnB,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC5B,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEL,MAAM,CAAC,CAAC,EACnB,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC5B,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,GAC1B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IA0Bf,OAAO,CAAC,CAAC,EACpB,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC5B,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAaZ,IAAI,CAAC,CAAC,EACjB,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC5B,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAaf,MAAM,CAAC,CAAC,EACnB,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC5B,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,OAAO,CAAC;CAGpB"}

package/dist/models/ORM.js

@@ -1,28 +1,63 @@
-import { History, SerializableClass } from '@t4h.framework/core';
+import { History, SerializableClass, } from '@t4h.framework/core';
 import { Ref } from './Ref.js';
 import { RefCollection } from './RefCollection.js';
 import { ORMCreateActivity } from '../activities/ORMCreateActivity.js';
 import { ORMFindActivity } from '../activities/ORMFindActivity.js';
 import { ORMFindOneActivity } from '../activities/ORMFindOneActivity.js';
-import { getEntityTableName } from '../decorators/metadata.js';
+import { applyDefaultProperties } from '../constraints/apply-default-properties.js';
+import { assertConstraints } from '../constraints/assert-constraints.js';
+import { getEntityMetadata, getEntityTableName, } from '../decorators/metadata.js';
 const create = History.bind(ORMCreateActivity);
 const find = History.bind(ORMFindActivity);
 const findOne = History.bind(ORMFindOneActivity);
 export class ORM extends SerializableClass {
     config;
     toSerializable() {
-        return this.config.connectionString;
+        return {
+            connectionString: this.config.connectionString,
+            entities: this.config.entities.map(entity => ({
+                tableName: entity.tableName,
+                indexes: entity.indexes.map(index => ({
+                    properties: index.properties,
+                    name: index.name,
+                })),
+                properties: Array.from(entity.properties.entries()).map(([name, property]) => ({
+                    name,
+                    type: property.type,
+                    nullable: property.nullable,
+                    default: property.default,
+                    index: property.index,
+                })),
+            })),
+        };
     }
-    fromSerializable(connectionString) {
-        Object.assign(this, { config: { connectionString } });
+    fromSerializable(serializable) {
+        Object.assign(this, {
+            config: {
+                connectionString: serializable.connectionString,
+                entities: serializable.entities.map(entity => ({
+                    tableName: entity.tableName,
+                    indexes: entity.indexes,
+                    properties: new Map(entity.properties.map(property => [property.name, property])),
+                })),
+            },
+        });
     }
     constructor(config) {
         super();
-        this.config = config;
+        if (!config)
+            return;
+        Object.assign(this, {
+            config: {
+                connectionString: config.connectionString,
+                entities: config.entities.map(entity => getEntityMetadata(entity)),
+            },
+        });
     }
     async create(entity, data) {
         const isBatch = Array.isArray(data);
-        const rows = isBatch ? data : [data];
+        const rows = applyDefaultProperties(isBatch ? data : [data], getEntityMetadata(entity));
+        await assertConstraints(entity, rows);
         const result = await create({
             orm: this,
             table: getEntityTableName(entity),

package/dist/models/ORM.js.map

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

package/dist/models/Ref.d.ts

@@ -5,7 +5,7 @@ export declare class Ref<T> {
     private readonly entity;
     private readonly ref;
     constructor(orm: ORM, entity: EntityConstructor<T>, ref: SerializableRowRef);
-    getSnapshot(): Promise<T>;
+    getSnapshot(): Promise<T | null>;
     update(data: EntityPartialData<T>): Promise<void>;
     remove(): Promise<void>;
 }

package/dist/models/Ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Ref.d.ts","sourceRoot":"","sources":["../../src/models/Ref.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAKnC,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAEnB,MAAM,mBAAmB,CAAA;AAM1B,qBAAa,GAAG,CAAC,CAAC;IAEd,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAFH,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC5B,GAAG,EAAE,kBAAkB;IAG7B,WAAW,IAAI,OAAO,CAAC,CAAC,CAAC;IAczB,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASjD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAOrC"}
+{"version":3,"file":"Ref.d.ts","sourceRoot":"","sources":["../../src/models/Ref.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAUnC,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAEnB,MAAM,mBAAmB,CAAA;AAM1B,qBAAa,GAAG,CAAC,CAAC;IAEd,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAFH,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC5B,GAAG,EAAE,kBAAkB;IAG7B,WAAW,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAgBhC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAOrC"}

package/dist/models/Ref.js

@@ -2,7 +2,9 @@ import { History } from '@t4h.framework/core';
 import { ORMGetSnapshotActivity } from '../activities/ORMGetSnapshotActivity.js';
 import { ORMRemoveActivity } from '../activities/ORMRemoveActivity.js';
 import { ORMUpdateActivity } from '../activities/ORMUpdateActivity.js';
-import { getEntityTableName } from '../decorators/metadata.js';
+import { applyDefaultProperties } from '../constraints/apply-default-properties.js';
+import { assertConstraints } from '../constraints/assert-constraints.js';
+import { getEntityMetadata, getEntityTableName, } from '../decorators/metadata.js';
 const getSnapshotOp = History.bind(ORMGetSnapshotActivity);
 const update = History.bind(ORMUpdateActivity);
 const remove = History.bind(ORMRemoveActivity);
@@ -21,16 +23,23 @@ export class Ref {
             table: getEntityTableName(this.entity),
             ref: this.ref,
         });
+        if (result === null)
+            return null;
         const entity = Reflect.construct(this.entity, []);
         Object.assign(entity, result);
         return entity;
     }
     async update(data) {
+        const keys = Object.keys(data);
+        const row = applyDefaultProperties(data, getEntityMetadata(this.entity), keys);
+        await assertConstraints(this.entity, [row], {
+            keys,
+        });
         await update({
             orm: this.orm,
             table: getEntityTableName(this.entity),
             ref: this.ref,
-            data: data,
+            data: row,
         });
     }
     async remove() {

package/dist/models/Ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"Ref.js","sourceRoot":"","sources":["../../src/models/Ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAG7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAA;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAQ9D,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;AAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;AAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;AAE9C,MAAM,OAAO,GAAG;IAEK;IACA;IACA;IAHnB,YACmB,GAAQ,EACR,MAA4B,EAC5B,GAAuB;QAFvB,QAAG,GAAH,GAAG,CAAK;QACR,WAAM,GAAN,MAAM,CAAsB;QAC5B,QAAG,GAAH,GAAG,CAAoB;IACvC,CAAC;IAEG,KAAK,CAAC,WAAW;QACtB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;YACjC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC;YACtC,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAW,CAAA;QAE3D,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAE7B,OAAO,MAAW,CAAA;IACpB,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,IAA0B;QAC5C,MAAM,MAAM,CAAC;YACX,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC;YACtC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAqB;SAC5B,CAAC,CAAA;IACJ,CAAC;IAEM,KAAK,CAAC,MAAM;QACjB,MAAM,MAAM,CAAC;YACX,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC;YACtC,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAA;IACJ,CAAC;CACF"}
+{"version":3,"file":"Ref.js","sourceRoot":"","sources":["../../src/models/Ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAG7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAA;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAA;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AACxE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,2BAA2B,CAAA;AAQlC,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;AAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;AAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;AAE9C,MAAM,OAAO,GAAG;IAEK;IACA;IACA;IAHnB,YACmB,GAAQ,EACR,MAA4B,EAC5B,GAAuB;QAFvB,QAAG,GAAH,GAAG,CAAK;QACR,WAAM,GAAN,MAAM,CAAsB;QAC5B,QAAG,GAAH,GAAG,CAAoB;IACvC,CAAC;IAEG,KAAK,CAAC,WAAW;QACtB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;YACjC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC;YACtC,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAA;QAEF,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAEhC,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAW,CAAA;QAE3D,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAE7B,OAAO,MAAW,CAAA;IACpB,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,IAA0B;QAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAE9B,MAAM,GAAG,GAAG,sBAAsB,CAChC,IAAqB,EACrB,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,EAC9B,IAAI,CACY,CAAA;QAElB,MAAM,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE;YAC1C,IAAI;SACL,CAAC,CAAA;QAEF,MAAM,MAAM,CAAC;YACX,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC;YACtC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,GAAG;SACV,CAAC,CAAA;IACJ,CAAC;IAEM,KAAK,CAAC,MAAM;QACjB,MAAM,MAAM,CAAC;YACX,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC;YACtC,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/orm.d.ts

@@ -1,11 +1,14 @@
 export * from './claims/ORMClaim.js';
+export * from './errors/ConstraintError.js';
 export * from './decorators/Entity.js';
+export * from './decorators/Index.js';
 export * from './decorators/Property.js';
 export * from './decorators/metadata.js';
 export * from './models/ORM.js';
 export * from './models/Ref.js';
 export * from './models/RefCollection.js';
 export * from './activities/ORMCreateActivity.js';
+export * from './activities/ORMFindOneActivity.js';
 export * from './activities/ORMRemoveActivity.js';
 export * from './activities/ORMFindActivity.js';
 export * from './activities/ORMGetSnapshotActivity.js';

package/dist/orm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orm.d.ts","sourceRoot":"","sources":["../src/orm.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AAEpC,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AAExC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AAEzC,cAAc,mCAAmC,CAAA;AACjD,cAAc,mCAAmC,CAAA;AACjD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,wCAAwC,CAAA;AACtD,cAAc,mCAAmC,CAAA;AAEjD,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"orm.d.ts","sourceRoot":"","sources":["../src/orm.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AAEpC,cAAc,6BAA6B,CAAA;AAE3C,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AAExC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AAEzC,cAAc,mCAAmC,CAAA;AACjD,cAAc,oCAAoC,CAAA;AAClD,cAAc,mCAAmC,CAAA;AACjD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,wCAAwC,CAAA;AACtD,cAAc,mCAAmC,CAAA;AAEjD,cAAc,kBAAkB,CAAA"}

package/dist/orm.js

@@ -1,11 +1,14 @@
 export * from './claims/ORMClaim.js';
+export * from './errors/ConstraintError.js';
 export * from './decorators/Entity.js';
+export * from './decorators/Index.js';
 export * from './decorators/Property.js';
 export * from './decorators/metadata.js';
 export * from './models/ORM.js';
 export * from './models/Ref.js';
 export * from './models/RefCollection.js';
 export * from './activities/ORMCreateActivity.js';
+export * from './activities/ORMFindOneActivity.js';
 export * from './activities/ORMRemoveActivity.js';
 export * from './activities/ORMFindActivity.js';
 export * from './activities/ORMGetSnapshotActivity.js';

package/dist/orm.js.map

@@ -1 +1 @@
-{"version":3,"file":"orm.js","sourceRoot":"","sources":["../src/orm.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AAEpC,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AAExC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AAEzC,cAAc,mCAAmC,CAAA;AACjD,cAAc,mCAAmC,CAAA;AACjD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,wCAAwC,CAAA;AACtD,cAAc,mCAAmC,CAAA;AAEjD,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"orm.js","sourceRoot":"","sources":["../src/orm.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AAEpC,cAAc,6BAA6B,CAAA;AAE3C,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AAExC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AAEzC,cAAc,mCAAmC,CAAA;AACjD,cAAc,oCAAoC,CAAA;AAClD,cAAc,mCAAmC,CAAA;AACjD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,wCAAwC,CAAA;AACtD,cAAc,mCAAmC,CAAA;AAEjD,cAAc,kBAAkB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t4h.framework/orm",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "ORM module for the T4H Framework",
   "homepage": "https://github.com/tech4humans-brasil/framework/tree/main/packages/orm",
   "bugs": "https://github.com/tech4humans-brasil/framework/issues",
@@ -20,7 +20,8 @@
   "types": "./dist/orm.d.ts",
   "files": [
     "dist",
-    "LICENSE"
+    "LICENSE",
+    ".ai"
   ],
   "scripts": {
     "build": "tsc --project tsconfig.build.json",
@@ -31,14 +32,15 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@t4h.framework/core": "^0.2.0"
+    "reflect-metadata": "^0.2.2"
   },
   "devDependencies": {
+    "@t4h.framework/core": "^0.6.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   },
   "peerDependencies": {
-    "@t4h.framework/core": "^0.2.0"
+    "@t4h.framework/core": "^0.6.0"
   },
   "packageManager": "yarn@4.12.0",
   "engines": {