@mj-biz-apps/contracts-entities 0.2.0 → 0.4.0

package/dist/ContractEntity.d.ts

@@ -57,6 +57,26 @@ export declare function IsSameContractLevel(myParentID: string | null | undefine
  *     provision is one problem rather than two.
  */
 export declare function FindDuplicateProvisionIDs(provisionIDs: readonly unknown[]): string[];
+/**
+ * R-12 — `CK_Contract_Dates` as a predicate: is this pair of dates definitely out of order?
+ *
+ * MIRRORS THE CONSTRAINT EXACTLY, which is `EndDate IS NULL OR EffectiveDate IS NULL OR EndDate >=
+ * EffectiveDate`. So this returns true ONLY when both dates are readable and the end really does fall
+ * before the start. Three consequences worth stating, because each is a way the obvious version would
+ * be wrong:
+ *
+ *   * EQUAL DATES PASS. A contract that starts and ends on the same day is a real one-day agreement.
+ *     Refusing it would reject rows the database accepts — worse than the error being replaced.
+ *   * EITHER MISSING PASSES. Half-filled dates are the normal state of a form mid-edit, and the
+ *     constraint itself allows them.
+ *   * UNREADABLE PASSES. Typed `Date | null`, but a form binding can put a string here, and comparing
+ *     a string to a Date compares nonsense rather than throwing. Anything that will not parse is
+ *     treated as "not yet known" rather than as an error on a field still being typed.
+ *
+ * Exported and pure so it can be asserted directly, the way `IsSameContractLevel` above is — not
+ * restated in a test, which is a copy that can drift from the rule it claims to check.
+ */
+export declare function IsEndBeforeEffective(effectiveDate: unknown, endDate: unknown): boolean;
 export declare class ContractEntity extends mjBizAppsContractsContractEntity {
     /**
      * `HasModifications` is MONOTONIC: it must be true when modification rows exist, and it is never
@@ -73,6 +93,22 @@ export declare class ContractEntity extends mjBizAppsContractsContractEntity {
      * on a contract whose paper really was negotiated. A human sets it false, or it stays true.
      */
     Validate(): ValidationResult;
+    /**
+     * R-12 — `CK_Contract_Dates` in words, before the database says it in SQL.
+     *
+     * The constraint has always existed, so the data was never at risk; what the user got was the raw
+     * violation text naming a constraint and no field. This runs in the browser AND on the server
+     * (`Validate()` is shared), so the message arrives on the End Date field before a save is attempted.
+     *
+     * THE PREDICATE MIRRORS THE CONSTRAINT EXACTLY — `EndDate IS NULL OR EffectiveDate IS NULL OR
+     * EndDate >= EffectiveDate`. Both-null and either-null pass, and equal dates pass: a contract that
+     * starts and ends on the same day is a real one-day agreement, and refusing it here would reject
+     * rows the database accepts, which is worse than the error it replaces.
+     *
+     * The constraint STAYS. This is the friendly path, not the enforcement: a write that reaches the
+     * table by some other route still meets the check.
+     */
+    private refuseEndBeforeEffective;
     /**
      * R-10 — two modifications of the SAME provision, caught among the rows in hand.
      *

package/dist/ContractEntity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContractEntity.d.ts","sourceRoot":"","sources":["../src/ContractEntity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAwD,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE9G,OAAO,EAAE,gCAAgC,EAAE,MAAM,+BAA+B,CAAC;AAEjF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAM5H;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,EAAE,CAWpF;AAED,qBACa,cAAe,SAAQ,gCAAgC;IAChE;;;;;;;;;;;;;OAaG;IACa,QAAQ,IAAI,gBAAgB;IAuB5C;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,kCAAkC;IAkB1C;;;;;;;;;;;;;;;;;;;OAmBG;IACH;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,OAAO,CAAC,4BAA4B;IAmBpC;;;;OAIG;IACH,SAAS,CAAC,uBAAuB,UAAS;IAE1C;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,yBAAyB;IAIjC;;;;;;;;;;;OAWG;IACI,SAAS,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI;CAgBpD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}
+{"version":3,"file":"ContractEntity.d.ts","sourceRoot":"","sources":["../src/ContractEntity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAwD,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE9G,OAAO,EAAE,gCAAgC,EAAE,MAAM,+BAA+B,CAAC;AAEjF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAM5H;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,EAAE,CAWpF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAUtF;AAED,qBACa,cAAe,SAAQ,gCAAgC;IAChE;;;;;;;;;;;;;OAaG;IACa,QAAQ,IAAI,gBAAgB;IAwB5C;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,wBAAwB;IAchC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,kCAAkC;IAkB1C;;;;;;;;;;;;;;;;;;;OAmBG;IACH;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,OAAO,CAAC,4BAA4B;IAmBpC;;;;OAIG;IACH,SAAS,CAAC,uBAAuB,UAAS;IAE1C;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,yBAAyB;IAIjC;;;;;;;;;;;OAWG;IACI,SAAS,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI;CAgBpD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/ContractEntity.js

@@ -85,6 +85,38 @@ export function FindDuplicateProvisionIDs(provisionIDs) {
     }
     return duplicates;
 }
+/**
+ * R-12 — `CK_Contract_Dates` as a predicate: is this pair of dates definitely out of order?
+ *
+ * MIRRORS THE CONSTRAINT EXACTLY, which is `EndDate IS NULL OR EffectiveDate IS NULL OR EndDate >=
+ * EffectiveDate`. So this returns true ONLY when both dates are readable and the end really does fall
+ * before the start. Three consequences worth stating, because each is a way the obvious version would
+ * be wrong:
+ *
+ *   * EQUAL DATES PASS. A contract that starts and ends on the same day is a real one-day agreement.
+ *     Refusing it would reject rows the database accepts — worse than the error being replaced.
+ *   * EITHER MISSING PASSES. Half-filled dates are the normal state of a form mid-edit, and the
+ *     constraint itself allows them.
+ *   * UNREADABLE PASSES. Typed `Date | null`, but a form binding can put a string here, and comparing
+ *     a string to a Date compares nonsense rather than throwing. Anything that will not parse is
+ *     treated as "not yet known" rather than as an error on a field still being typed.
+ *
+ * Exported and pure so it can be asserted directly, the way `IsSameContractLevel` above is — not
+ * restated in a test, which is a copy that can drift from the rule it claims to check.
+ */
+export function IsEndBeforeEffective(effectiveDate, endDate) {
+    const at = (v) => {
+        if (v === null || v === undefined || v === '')
+            return null;
+        const t = v instanceof Date ? v.getTime() : new Date(v).getTime();
+        return Number.isFinite(t) ? t : null;
+    };
+    const effective = at(effectiveDate);
+    const end = at(endDate);
+    if (effective === null || end === null)
+        return false;
+    return end < effective;
+}
 let ContractEntity = class ContractEntity extends mjBizAppsContractsContractEntity {
     constructor() {
         super(...arguments);
@@ -119,8 +151,30 @@ let ContractEntity = class ContractEntity extends mjBizAppsContractsContractEnti
                 `the agreement really is standard.`, this.HasModifications, ValidationErrorType.Failure));
         }
         this.refuseDuplicateStagedModifications(result);
+        this.refuseEndBeforeEffective(result);
         return result;
     }
+    /**
+     * R-12 — `CK_Contract_Dates` in words, before the database says it in SQL.
+     *
+     * The constraint has always existed, so the data was never at risk; what the user got was the raw
+     * violation text naming a constraint and no field. This runs in the browser AND on the server
+     * (`Validate()` is shared), so the message arrives on the End Date field before a save is attempted.
+     *
+     * THE PREDICATE MIRRORS THE CONSTRAINT EXACTLY — `EndDate IS NULL OR EffectiveDate IS NULL OR
+     * EndDate >= EffectiveDate`. Both-null and either-null pass, and equal dates pass: a contract that
+     * starts and ends on the same day is a real one-day agreement, and refusing it here would reject
+     * rows the database accepts, which is worse than the error it replaces.
+     *
+     * The constraint STAYS. This is the friendly path, not the enforcement: a write that reaches the
+     * table by some other route still meets the check.
+     */
+    refuseEndBeforeEffective(result) {
+        if (!IsEndBeforeEffective(this.EffectiveDate, this.EndDate))
+            return;
+        result.Success = false;
+        result.Errors.push(new ValidationErrorInfo('EndDate', 'End Date must be on or after the Effective Date.', this.EndDate, ValidationErrorType.Failure));
+    }
     /**
      * R-10 — two modifications of the SAME provision, caught among the rows in hand.
      *

package/dist/ContractEntity.js.map

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

package/dist/index.d.ts

@@ -27,4 +27,6 @@ export * from './required-field-prose.js';
 export * from './ContractTypeEntity.js';
 export * from './value-list-validation.js';
 export * from './contract-state.js';
+/** Which contracts the Supersedes picker may offer, and how it names them (#28 item 4). */
+export * from './supersede-candidates.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,cAAc,+BAA+B,CAAC;AAI9C,cAAc,kBAAkB,CAAC;AAIjC,cAAc,sCAAsC,CAAC;AAIrD,cAAc,mCAAmC,CAAC;AAIlD,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AAIvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AAMxC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,cAAc,+BAA+B,CAAC;AAI9C,cAAc,kBAAkB,CAAC;AAIjC,cAAc,sCAAsC,CAAC;AAIrD,cAAc,mCAAmC,CAAC;AAIlD,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AAIvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AAMxC,cAAc,kBAAkB,CAAC;AAEjC,2FAA2F;AAC3F,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -41,6 +41,8 @@ export * from './value-list-validation.js';
  * would contradict the form on screen — and because StateSQL() is what the migration's CASE is checked
  * against by contract-state.test.ts. */
 export * from './contract-state.js';
+/** Which contracts the Supersedes picker may offer, and how it names them (#28 item 4). */
+export * from './supersede-candidates.js';
 /* NOTE on `src/generated/remote_operations.ts`: CodeGen writes it, and it is deliberately NOT
  * re-exported. v2 ships zero remote operations (plan §6.3), so every symbol in that file is an
  * MJ-CORE operation (AISkill, PredictiveStudio, TaskGraph, …) emitted into every app's file

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,cAAc,+BAA+B,CAAC;AAE9C;kFACkF;AAClF,cAAc,kBAAkB,CAAC;AAEjC;qGACqG;AACrG,cAAc,sCAAsC,CAAC;AAErD;wEACwE;AACxE,cAAc,mCAAmC,CAAC;AAElD;wGACwG;AACxG,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AAEvC;2FAC2F;AAC3F,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AAExC;;;wCAGwC;AACxC,cAAc,kBAAkB,CAAC;AAEjC;;;;oFAIoF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,cAAc,+BAA+B,CAAC;AAE9C;kFACkF;AAClF,cAAc,kBAAkB,CAAC;AAEjC;qGACqG;AACrG,cAAc,sCAAsC,CAAC;AAErD;wEACwE;AACxE,cAAc,mCAAmC,CAAC;AAElD;wGACwG;AACxG,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AAEvC;2FAC2F;AAC3F,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AAExC;;;wCAGwC;AACxC,cAAc,kBAAkB,CAAC;AAEjC,2FAA2F;AAC3F,cAAc,wBAAwB,CAAC;AAEvC;;;;oFAIoF"}

package/dist/supersede-candidates.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview Which contracts the Supersedes picker may offer, and how it names them.
+ *
+ * contracts#28 item 4 states the rule as four conditions, all of which must hold. A candidate is a
+ * contract that is:
+ *
+ *   1. the SAME CUSTOMER as this contract — {@link SameCustomerClause}
+ *   2. at the SAME LEVEL — `IsSameContractLevel`, in `ContractEntity.ts`, where it already lived
+ *   3. NOT already superseded — a plain `SupersededByContractID IS NULL`
+ *   4. not this contract — a plain `ID <> …`
+ *
+ * WHY THESE LIVE HERE AND NOT ON THE PANEL. `supersede.panel.ts` is an Angular component, so anything
+ * declared inside it can only be asserted by standing up Angular's DI — importing it from a unit test
+ * fails with "the injectable 'PlatformLocation' needs to be compiled using the JIT compiler". Rules 3
+ * and 4 have nothing to decide, but 1 and the label format both do, and both are stated as final in
+ * the issue, which makes them worth pinning. Rule 2 was already here for the same reason.
+ *
+ * The panel still owns the QUERY. These own the decisions inside it.
+ *
+ * @module @mj-biz-apps/contracts-entities
+ */
+/**
+ * The same-customer clause — rule 1 — or one that deliberately matches nothing.
+ *
+ * A re-papering replaces one customer's agreement with another agreement for THAT customer. Offering
+ * another customer's contract is not merely untidy: linking it points one organisation's lineage at
+ * another's, so the successor's terms read as governing a party that never signed them, and the
+ * predecessor's customer loses the trail to whatever replaced their agreement.
+ *
+ * AN ABSENT CUSTOMER YIELDS NOTHING, NOT EVERYTHING, and the direction is the whole point.
+ * `CustomerOrganizationID` is NOT NULL on Contract, so a missing value never means "this contract has
+ * no customer" — it means the record could not be read. Widening to every contract at that moment
+ * would offer the whole book precisely when the caller knows least, which is the failure rule 1
+ * exists to prevent.
+ */
+export declare function SameCustomerClause(customerID: string | null | undefined): string;
+/**
+ * The option label: `<ContractNumber> — <Description>`, falling back to the contract type.
+ *
+ * Quoted as final in the issue. The description is what a person recognises — "Platform licence, 2026
+ * renewal" — while the type is a category several contracts share, so a list labelled by type reads
+ * as several copies of the same row.
+ *
+ * The description is TRIMMED before the emptiness test, because blank descriptions are common on
+ * imported records and a label reading `CTR-0007 —   ` looks like missing data rather than an
+ * uncategorised agreement. The second fallback to "Contract" exists so a row with neither can never
+ * render a dangling dash.
+ */
+export declare function ContractOptionLabel(c: {
+    ContractNumber: string;
+    ContractType: string | null;
+    Description: string | null;
+}): string;
+//# sourceMappingURL=supersede-candidates.d.ts.map

package/dist/supersede-candidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supersede-candidates.d.ts","sourceRoot":"","sources":["../src/supersede-candidates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAMhF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,MAAM,CAGT"}

package/dist/supersede-candidates.js

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview Which contracts the Supersedes picker may offer, and how it names them.
+ *
+ * contracts#28 item 4 states the rule as four conditions, all of which must hold. A candidate is a
+ * contract that is:
+ *
+ *   1. the SAME CUSTOMER as this contract — {@link SameCustomerClause}
+ *   2. at the SAME LEVEL — `IsSameContractLevel`, in `ContractEntity.ts`, where it already lived
+ *   3. NOT already superseded — a plain `SupersededByContractID IS NULL`
+ *   4. not this contract — a plain `ID <> …`
+ *
+ * WHY THESE LIVE HERE AND NOT ON THE PANEL. `supersede.panel.ts` is an Angular component, so anything
+ * declared inside it can only be asserted by standing up Angular's DI — importing it from a unit test
+ * fails with "the injectable 'PlatformLocation' needs to be compiled using the JIT compiler". Rules 3
+ * and 4 have nothing to decide, but 1 and the label format both do, and both are stated as final in
+ * the issue, which makes them worth pinning. Rule 2 was already here for the same reason.
+ *
+ * The panel still owns the QUERY. These own the decisions inside it.
+ *
+ * @module @mj-biz-apps/contracts-entities
+ */
+/**
+ * The same-customer clause — rule 1 — or one that deliberately matches nothing.
+ *
+ * A re-papering replaces one customer's agreement with another agreement for THAT customer. Offering
+ * another customer's contract is not merely untidy: linking it points one organisation's lineage at
+ * another's, so the successor's terms read as governing a party that never signed them, and the
+ * predecessor's customer loses the trail to whatever replaced their agreement.
+ *
+ * AN ABSENT CUSTOMER YIELDS NOTHING, NOT EVERYTHING, and the direction is the whole point.
+ * `CustomerOrganizationID` is NOT NULL on Contract, so a missing value never means "this contract has
+ * no customer" — it means the record could not be read. Widening to every contract at that moment
+ * would offer the whole book precisely when the caller knows least, which is the failure rule 1
+ * exists to prevent.
+ */
+export function SameCustomerClause(customerID) {
+    const id = (customerID ?? '').trim();
+    if (!id)
+        return '1 = 0';
+    // The value reaches an `ExtraFilter` as a string. It is a UUID by construction, so this should
+    // never fire — which is exactly why dropping it would go unnoticed.
+    return `CustomerOrganizationID = '${id.replace(/'/g, "''")}'`;
+}
+/**
+ * The option label: `<ContractNumber> — <Description>`, falling back to the contract type.
+ *
+ * Quoted as final in the issue. The description is what a person recognises — "Platform licence, 2026
+ * renewal" — while the type is a category several contracts share, so a list labelled by type reads
+ * as several copies of the same row.
+ *
+ * The description is TRIMMED before the emptiness test, because blank descriptions are common on
+ * imported records and a label reading `CTR-0007 —   ` looks like missing data rather than an
+ * uncategorised agreement. The second fallback to "Contract" exists so a row with neither can never
+ * render a dangling dash.
+ */
+export function ContractOptionLabel(c) {
+    const described = (c.Description ?? '').trim();
+    return `${c.ContractNumber} — ${described || c.ContractType || 'Contract'}`;
+}
+//# sourceMappingURL=supersede-candidates.js.map

package/dist/supersede-candidates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supersede-candidates.js","sourceRoot":"","sources":["../src/supersede-candidates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAqC;IACpE,MAAM,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,EAAE;QAAE,OAAO,OAAO,CAAC;IACxB,+FAA+F;IAC/F,oEAAoE;IACpE,OAAO,6BAA6B,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AAClE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAAC,CAInC;IACG,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,OAAO,GAAG,CAAC,CAAC,cAAc,MAAM,SAAS,IAAI,CAAC,CAAC,YAAY,IAAI,UAAU,EAAE,CAAC;AAChF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mj-biz-apps/contracts-entities",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "Generated entity subclasses for the app schema. TODO(template): rename package + description.",
   "main": "dist/index.js",
@@ -18,7 +18,8 @@
     "@memberjunction/global": "^6.1.0-edge.4"
   },
   "devDependencies": {
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
   },
   "files": [
     "/dist"
@@ -28,6 +29,6 @@
   },
   "scripts": {
     "build": "tsc && tsc-alias -f",
-    "test": "echo \"No tests configured yet\""
+    "test": "vitest run --passWithNoTests"
   }
 }