@contractspec/example.wealth-snapshot 1.44.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,14 @@
+# @contractspec/example.wealth-snapshot
+
+Website: https://contractspec.io/
+
+
+Wealth Snapshot mini-app for accounts, assets, liabilities, and goals.
+
+Highlights:
+
+- Personal/household accounts with balances and currencies
+- Assets & liabilities with categories and valuations
+- Net worth and indicators (runway, savings rate) derived from events
+- Goals tracking with progress and target dates
+- Notifications for threshold crossings and overdue goals

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./wealth-snapshot.docblock.js";

package/dist/docs/wealth-snapshot.docblock.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/wealth-snapshot.docblock.js

@@ -0,0 +1,104 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/wealth-snapshot.docblock.ts
+registerDocBlocks([
+	{
+		id: "docs.examples.wealth-snapshot",
+		title: "Wealth Snapshot",
+		summary: "Simple wealth overview with accounts, assets, liabilities, goals, and net-worth snapshots.",
+		kind: "reference",
+		visibility: "public",
+		route: "/docs/examples/wealth-snapshot",
+		tags: [
+			"finance",
+			"net-worth",
+			"goals"
+		],
+		body: `## Features
+
+- Accounts with balances/currencies.
+- Assets & liabilities categorized for net worth.
+- Goals with target amounts/dates and status.
+- Net worth snapshots for charting; events emitted for analytics.
+
+## Modules reused
+- Identity/RBAC for scoping to household/org
+- Notifications for threshold crossings/goal reminders
+- Audit trail for financial changes
+
+## Presentations
+- Dashboard, accounts list, assets list, liabilities list, goals list (React + Markdown targets).
+`
+	},
+	{
+		id: "docs.examples.wealth-snapshot.goal",
+		title: "Wealth Snapshot — Goal",
+		summary: "Why this personal/household finance template exists.",
+		kind: "goal",
+		visibility: "public",
+		route: "/docs/examples/wealth-snapshot/goal",
+		tags: ["finance", "goal"],
+		body: `## Why it matters
+- Provides a regenerable net-worth and goals view without bespoke finance code.
+- Keeps accounts/assets/liabilities/goals consistent across surfaces with PII care.
+
+## Business/Product goal
+- Deliver clear net-worth visibility, goal tracking, and alerting for thresholds.
+- Support safe regeneration while keeping currency/units explicit.
+
+## Success criteria
+- Spec changes to assets/liabilities/goals regenerate UI/API/events cleanly.
+- PII and sensitive values are marked and redacted where needed.`
+	},
+	{
+		id: "docs.examples.wealth-snapshot.usage",
+		title: "Wealth Snapshot — Usage",
+		summary: "How to seed, extend, and regenerate wealth tracking safely.",
+		kind: "usage",
+		visibility: "public",
+		route: "/docs/examples/wealth-snapshot/usage",
+		tags: ["finance", "usage"],
+		body: `## Setup
+1) Seed (if provided) or add accounts/assets/liabilities/goals via UI.
+2) Configure Notifications for goal reminders/threshold alerts; Audit for changes.
+
+## Extend & regenerate
+1) Adjust schemas for asset classes, liability terms, goal metrics; keep currency/units explicit.
+2) Regenerate to update dashboards and events; mark PII paths (account numbers, holder names).
+3) Use Feature Flags to trial new indicators or alerting rules.
+
+## Guardrails
+- Emit events for asset/liability/goal changes; log in Audit Trail.
+- Redact sensitive identifiers in presentations.
+- Keep calculations (net worth) transparent and driven by spec fields.`
+	},
+	{
+		id: "docs.examples.wealth-snapshot.constraints",
+		title: "Wealth Snapshot — Constraints & Safety",
+		summary: "Internal guardrails for finance data, PII, and regeneration semantics.",
+		kind: "reference",
+		visibility: "internal",
+		route: "/docs/examples/wealth-snapshot/constraints",
+		tags: [
+			"finance",
+			"constraints",
+			"internal"
+		],
+		body: `## Constraints
+- Net worth and goal calculations must stay spec-driven; avoid hidden math.
+- Events to emit: asset.created/updated, liability.created/updated, goal.created/updated, snapshot.recorded.
+- Regeneration should not alter currency/unit semantics without explicit spec change.
+
+## PII & Sensitivity
+- Mark account identifiers, holder names, and addresses as PII; redact in presentations.
+- Avoid exposing raw balances in MCP/web without policy checks; prefer summaries.
+
+## Verification
+- Add fixtures for currency/unit changes and snapshot calculations.
+- Ensure Audit Trail covers all financial mutations; Notifications optional for goals/thresholds.
+- Use Feature Flags for new indicators/alert rules; default safe/off.`
+	}
+]);
+
+//#endregion
+//# sourceMappingURL=wealth-snapshot.docblock.js.map

package/dist/docs/wealth-snapshot.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wealth-snapshot.docblock.js","names":[],"sources":["../../src/docs/wealth-snapshot.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst wealthSnapshotDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.examples.wealth-snapshot',\n    title: 'Wealth Snapshot',\n    summary:\n      'Simple wealth overview with accounts, assets, liabilities, goals, and net-worth snapshots.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/wealth-snapshot',\n    tags: ['finance', 'net-worth', 'goals'],\n    body: `## Features\n\n- Accounts with balances/currencies.\n- Assets & liabilities categorized for net worth.\n- Goals with target amounts/dates and status.\n- Net worth snapshots for charting; events emitted for analytics.\n\n## Modules reused\n- Identity/RBAC for scoping to household/org\n- Notifications for threshold crossings/goal reminders\n- Audit trail for financial changes\n\n## Presentations\n- Dashboard, accounts list, assets list, liabilities list, goals list (React + Markdown targets).\n`,\n  },\n  {\n    id: 'docs.examples.wealth-snapshot.goal',\n    title: 'Wealth Snapshot — Goal',\n    summary: 'Why this personal/household finance template exists.',\n    kind: 'goal',\n    visibility: 'public',\n    route: '/docs/examples/wealth-snapshot/goal',\n    tags: ['finance', 'goal'],\n    body: `## Why it matters\n- Provides a regenerable net-worth and goals view without bespoke finance code.\n- Keeps accounts/assets/liabilities/goals consistent across surfaces with PII care.\n\n## Business/Product goal\n- Deliver clear net-worth visibility, goal tracking, and alerting for thresholds.\n- Support safe regeneration while keeping currency/units explicit.\n\n## Success criteria\n- Spec changes to assets/liabilities/goals regenerate UI/API/events cleanly.\n- PII and sensitive values are marked and redacted where needed.`,\n  },\n  {\n    id: 'docs.examples.wealth-snapshot.usage',\n    title: 'Wealth Snapshot — Usage',\n    summary: 'How to seed, extend, and regenerate wealth tracking safely.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/wealth-snapshot/usage',\n    tags: ['finance', 'usage'],\n    body: `## Setup\n1) Seed (if provided) or add accounts/assets/liabilities/goals via UI.\n2) Configure Notifications for goal reminders/threshold alerts; Audit for changes.\n\n## Extend & regenerate\n1) Adjust schemas for asset classes, liability terms, goal metrics; keep currency/units explicit.\n2) Regenerate to update dashboards and events; mark PII paths (account numbers, holder names).\n3) Use Feature Flags to trial new indicators or alerting rules.\n\n## Guardrails\n- Emit events for asset/liability/goal changes; log in Audit Trail.\n- Redact sensitive identifiers in presentations.\n- Keep calculations (net worth) transparent and driven by spec fields.`,\n  },\n  {\n    id: 'docs.examples.wealth-snapshot.constraints',\n    title: 'Wealth Snapshot — Constraints & Safety',\n    summary:\n      'Internal guardrails for finance data, PII, and regeneration semantics.',\n    kind: 'reference',\n    visibility: 'internal',\n    route: '/docs/examples/wealth-snapshot/constraints',\n    tags: ['finance', 'constraints', 'internal'],\n    body: `## Constraints\n- Net worth and goal calculations must stay spec-driven; avoid hidden math.\n- Events to emit: asset.created/updated, liability.created/updated, goal.created/updated, snapshot.recorded.\n- Regeneration should not alter currency/unit semantics without explicit spec change.\n\n## PII & Sensitivity\n- Mark account identifiers, holder names, and addresses as PII; redact in presentations.\n- Avoid exposing raw balances in MCP/web without policy checks; prefer summaries.\n\n## Verification\n- Add fixtures for currency/unit changes and snapshot calculations.\n- Ensure Audit Trail covers all financial mutations; Notifications optional for goals/thresholds.\n- Use Feature Flags for new indicators/alert rules; default safe/off.`,\n  },\n];\n\nregisterDocBlocks(wealthSnapshotDocBlocks);\n"],"mappings":";;;AAgGA,kBA7F4C;CAC1C;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAW;GAAa;GAAQ;EACvC,MAAM;;;;;;;;;;;;;;;EAeP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,WAAW,OAAO;EACzB,MAAM;;;;;;;;;;;EAWP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,WAAW,QAAQ;EAC1B,MAAM;;;;;;;;;;;;;EAaP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAW;GAAe;GAAW;EAC5C,MAAM;;;;;;;;;;;;;EAaP;CACF,CAEyC"}

package/dist/entities/index.d.ts

@@ -0,0 +1,132 @@
+import * as _contractspec_lib_schema58 from "@contractspec/lib.schema";
+import { ModuleSchemaContribution } from "@contractspec/lib.schema";
+
+//#region src/entities/index.d.ts
+declare const AccountTypeEnum: _contractspec_lib_schema58.EntityEnumDef;
+declare const AssetCategoryEnum: _contractspec_lib_schema58.EntityEnumDef;
+declare const LiabilityCategoryEnum: _contractspec_lib_schema58.EntityEnumDef;
+declare const GoalStatusEnum: _contractspec_lib_schema58.EntityEnumDef;
+declare const AccountEntity: _contractspec_lib_schema58.EntitySpec<{
+  id: _contractspec_lib_schema58.EntityScalarField;
+  name: _contractspec_lib_schema58.EntityScalarField;
+  type: _contractspec_lib_schema58.EntityEnumField;
+  currency: _contractspec_lib_schema58.EntityScalarField;
+  balance: _contractspec_lib_schema58.EntityScalarField;
+  institution: _contractspec_lib_schema58.EntityScalarField;
+  orgId: _contractspec_lib_schema58.EntityScalarField;
+  ownerId: _contractspec_lib_schema58.EntityScalarField;
+  createdAt: _contractspec_lib_schema58.EntityScalarField;
+  updatedAt: _contractspec_lib_schema58.EntityScalarField;
+}>;
+declare const AssetEntity: _contractspec_lib_schema58.EntitySpec<{
+  id: _contractspec_lib_schema58.EntityScalarField;
+  accountId: _contractspec_lib_schema58.EntityScalarField;
+  name: _contractspec_lib_schema58.EntityScalarField;
+  category: _contractspec_lib_schema58.EntityEnumField;
+  value: _contractspec_lib_schema58.EntityScalarField;
+  currency: _contractspec_lib_schema58.EntityScalarField;
+  orgId: _contractspec_lib_schema58.EntityScalarField;
+  metadata: _contractspec_lib_schema58.EntityScalarField;
+  updatedAt: _contractspec_lib_schema58.EntityScalarField;
+  createdAt: _contractspec_lib_schema58.EntityScalarField;
+  account: _contractspec_lib_schema58.EntityRelationField;
+}>;
+declare const LiabilityEntity: _contractspec_lib_schema58.EntitySpec<{
+  id: _contractspec_lib_schema58.EntityScalarField;
+  accountId: _contractspec_lib_schema58.EntityScalarField;
+  name: _contractspec_lib_schema58.EntityScalarField;
+  category: _contractspec_lib_schema58.EntityEnumField;
+  balance: _contractspec_lib_schema58.EntityScalarField;
+  currency: _contractspec_lib_schema58.EntityScalarField;
+  interestRate: _contractspec_lib_schema58.EntityScalarField;
+  orgId: _contractspec_lib_schema58.EntityScalarField;
+  metadata: _contractspec_lib_schema58.EntityScalarField;
+  updatedAt: _contractspec_lib_schema58.EntityScalarField;
+  createdAt: _contractspec_lib_schema58.EntityScalarField;
+  account: _contractspec_lib_schema58.EntityRelationField;
+}>;
+declare const GoalEntity: _contractspec_lib_schema58.EntitySpec<{
+  id: _contractspec_lib_schema58.EntityScalarField;
+  name: _contractspec_lib_schema58.EntityScalarField;
+  targetAmount: _contractspec_lib_schema58.EntityScalarField;
+  currentAmount: _contractspec_lib_schema58.EntityScalarField;
+  currency: _contractspec_lib_schema58.EntityScalarField;
+  targetDate: _contractspec_lib_schema58.EntityScalarField;
+  status: _contractspec_lib_schema58.EntityEnumField;
+  orgId: _contractspec_lib_schema58.EntityScalarField;
+  ownerId: _contractspec_lib_schema58.EntityScalarField;
+  createdAt: _contractspec_lib_schema58.EntityScalarField;
+  updatedAt: _contractspec_lib_schema58.EntityScalarField;
+}>;
+declare const NetWorthSnapshotEntity: _contractspec_lib_schema58.EntitySpec<{
+  id: _contractspec_lib_schema58.EntityScalarField;
+  asOf: _contractspec_lib_schema58.EntityScalarField;
+  totalAssets: _contractspec_lib_schema58.EntityScalarField;
+  totalLiabilities: _contractspec_lib_schema58.EntityScalarField;
+  netWorth: _contractspec_lib_schema58.EntityScalarField;
+  currency: _contractspec_lib_schema58.EntityScalarField;
+  orgId: _contractspec_lib_schema58.EntityScalarField;
+  createdAt: _contractspec_lib_schema58.EntityScalarField;
+}>;
+declare const wealthSnapshotEntities: (_contractspec_lib_schema58.EntitySpec<{
+  id: _contractspec_lib_schema58.EntityScalarField;
+  name: _contractspec_lib_schema58.EntityScalarField;
+  type: _contractspec_lib_schema58.EntityEnumField;
+  currency: _contractspec_lib_schema58.EntityScalarField;
+  balance: _contractspec_lib_schema58.EntityScalarField;
+  institution: _contractspec_lib_schema58.EntityScalarField;
+  orgId: _contractspec_lib_schema58.EntityScalarField;
+  ownerId: _contractspec_lib_schema58.EntityScalarField;
+  createdAt: _contractspec_lib_schema58.EntityScalarField;
+  updatedAt: _contractspec_lib_schema58.EntityScalarField;
+}> | _contractspec_lib_schema58.EntitySpec<{
+  id: _contractspec_lib_schema58.EntityScalarField;
+  accountId: _contractspec_lib_schema58.EntityScalarField;
+  name: _contractspec_lib_schema58.EntityScalarField;
+  category: _contractspec_lib_schema58.EntityEnumField;
+  value: _contractspec_lib_schema58.EntityScalarField;
+  currency: _contractspec_lib_schema58.EntityScalarField;
+  orgId: _contractspec_lib_schema58.EntityScalarField;
+  metadata: _contractspec_lib_schema58.EntityScalarField;
+  updatedAt: _contractspec_lib_schema58.EntityScalarField;
+  createdAt: _contractspec_lib_schema58.EntityScalarField;
+  account: _contractspec_lib_schema58.EntityRelationField;
+}> | _contractspec_lib_schema58.EntitySpec<{
+  id: _contractspec_lib_schema58.EntityScalarField;
+  accountId: _contractspec_lib_schema58.EntityScalarField;
+  name: _contractspec_lib_schema58.EntityScalarField;
+  category: _contractspec_lib_schema58.EntityEnumField;
+  balance: _contractspec_lib_schema58.EntityScalarField;
+  currency: _contractspec_lib_schema58.EntityScalarField;
+  interestRate: _contractspec_lib_schema58.EntityScalarField;
+  orgId: _contractspec_lib_schema58.EntityScalarField;
+  metadata: _contractspec_lib_schema58.EntityScalarField;
+  updatedAt: _contractspec_lib_schema58.EntityScalarField;
+  createdAt: _contractspec_lib_schema58.EntityScalarField;
+  account: _contractspec_lib_schema58.EntityRelationField;
+}> | _contractspec_lib_schema58.EntitySpec<{
+  id: _contractspec_lib_schema58.EntityScalarField;
+  name: _contractspec_lib_schema58.EntityScalarField;
+  targetAmount: _contractspec_lib_schema58.EntityScalarField;
+  currentAmount: _contractspec_lib_schema58.EntityScalarField;
+  currency: _contractspec_lib_schema58.EntityScalarField;
+  targetDate: _contractspec_lib_schema58.EntityScalarField;
+  status: _contractspec_lib_schema58.EntityEnumField;
+  orgId: _contractspec_lib_schema58.EntityScalarField;
+  ownerId: _contractspec_lib_schema58.EntityScalarField;
+  createdAt: _contractspec_lib_schema58.EntityScalarField;
+  updatedAt: _contractspec_lib_schema58.EntityScalarField;
+}> | _contractspec_lib_schema58.EntitySpec<{
+  id: _contractspec_lib_schema58.EntityScalarField;
+  asOf: _contractspec_lib_schema58.EntityScalarField;
+  totalAssets: _contractspec_lib_schema58.EntityScalarField;
+  totalLiabilities: _contractspec_lib_schema58.EntityScalarField;
+  netWorth: _contractspec_lib_schema58.EntityScalarField;
+  currency: _contractspec_lib_schema58.EntityScalarField;
+  orgId: _contractspec_lib_schema58.EntityScalarField;
+  createdAt: _contractspec_lib_schema58.EntityScalarField;
+}>)[];
+declare const wealthSnapshotSchemaContribution: ModuleSchemaContribution;
+//#endregion
+export { AccountEntity, AccountTypeEnum, AssetCategoryEnum, AssetEntity, GoalEntity, GoalStatusEnum, LiabilityCategoryEnum, LiabilityEntity, NetWorthSnapshotEntity, wealthSnapshotEntities, wealthSnapshotSchemaContribution };
+//# sourceMappingURL=index.d.ts.map

package/dist/entities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/entities/index.ts"],"sourcesContent":[],"mappings":";;;;cAUa,iBAKX,0BAAA,CAL0B;cAOf,mBAKX,0BAAA,CAL4B;cAOjB,uBAKX,0BAAA,CALgC;AAdrB,cAqBA,cAhBX,EAqBA,0BAAA,CALyB,aAhBzB;AAEW,cAqBA,aAhBX,6BAgBwB,UAhBxB,CAAA;EAEW,EAAA,EAiCX,0BAAA,CAAA,iBA5BA;EAEW,IAAA,8CAAc;EAOd,IAAA,4CAmBX;EAAA,QAAA,8CAAA;;;;;;;;cAEW,wCAAW;MAyBtB,0BAAA,CAAA;yDA9CwB;EAAA,IAAA,8CAAA;EAqBb,QAAA,4CAyBX;EAAA,KAAA,8CAAA;;;;;;;;cAEW,4CAAe;MA+B1B,0BAAA,CAAA;;oDA1DsB;EAAA,QAAA,4CAAA;EA2BX,OAAA,8CA+BX;EAAA,QAAA,8CAAA;;;;;;;;cAEW,uCAAU;MAiCrB,0BAAA,CAAA;;;6DAlE0B;EAAA,QAAA,8CAAA;EAiCf,UAAA,8CAiCX;EAAA,MAAA,4CAAA;;;;;;cAEW,mDAAsB;MAgBjC,0BAAA,CAAA;;;;wDAnDqB;EAAA,QAAA,8CAAA;EAmCV,KAAA,8CAgBX;EAAA,SAAA,8CAAA;;cAEW,oDAAsB;MAMlC,0BAAA,CAAA;;;;;2DAxBkC;EAAA,KAAA,8CAAA;EAkBtB,OAAA,8CAMZ;EAAA,SAAA,8CAAA;;;MANkC,0BAAA,CAAA;;;;;;;wDAAA;EAAA,SAAA,8CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAQtB,kCAAkC"}

package/dist/entities/index.js

@@ -0,0 +1,230 @@
+import { defineEntity, defineEntityEnum, field, index } from "@contractspec/lib.schema";
+
+//#region src/entities/index.ts
+const schema = "lssm_wealth_snapshot";
+const AccountTypeEnum = defineEntityEnum({
+	name: "AccountType",
+	schema,
+	values: [
+		"CHECKING",
+		"SAVINGS",
+		"INVESTMENT",
+		"CREDIT_CARD",
+		"LOAN"
+	],
+	description: "Account categories for holdings and debts."
+});
+const AssetCategoryEnum = defineEntityEnum({
+	name: "AssetCategory",
+	schema,
+	values: [
+		"CASH",
+		"EQUITY",
+		"REAL_ESTATE",
+		"CRYPTO",
+		"OTHER"
+	],
+	description: "Asset categories."
+});
+const LiabilityCategoryEnum = defineEntityEnum({
+	name: "LiabilityCategory",
+	schema,
+	values: [
+		"CREDIT_CARD",
+		"LOAN",
+		"MORTGAGE",
+		"TAX",
+		"OTHER"
+	],
+	description: "Liability categories."
+});
+const GoalStatusEnum = defineEntityEnum({
+	name: "GoalStatus",
+	schema,
+	values: [
+		"ACTIVE",
+		"ON_TRACK",
+		"AT_RISK",
+		"OFF_TRACK",
+		"COMPLETED"
+	],
+	description: "Goal health/status."
+});
+const AccountEntity = defineEntity({
+	name: "Account",
+	description: "Financial account representing holdings or debts.",
+	schema,
+	map: "account",
+	fields: {
+		id: field.id({ description: "Account ID" }),
+		name: field.string({ description: "Account name" }),
+		type: field.enum("AccountType", { description: "Account type" }),
+		currency: field.string({
+			description: "Currency code",
+			default: "\"USD\""
+		}),
+		balance: field.decimal({ description: "Current balance" }),
+		institution: field.string({
+			description: "Institution",
+			isOptional: true
+		}),
+		orgId: field.string({ description: "Org/household id" }),
+		ownerId: field.string({
+			description: "Owner user id",
+			isOptional: true
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt()
+	},
+	enums: [AccountTypeEnum],
+	indexes: [
+		index.on(["orgId"]),
+		index.on(["type"]),
+		index.on(["ownerId"])
+	]
+});
+const AssetEntity = defineEntity({
+	name: "Asset",
+	description: "Individual asset position.",
+	schema,
+	map: "asset",
+	fields: {
+		id: field.id({ description: "Asset ID" }),
+		accountId: field.foreignKey({
+			description: "Holding account",
+			isOptional: true
+		}),
+		name: field.string({ description: "Asset name" }),
+		category: field.enum("AssetCategory", { description: "Asset category" }),
+		value: field.decimal({ description: "Current value" }),
+		currency: field.string({
+			description: "Currency",
+			default: "\"USD\""
+		}),
+		orgId: field.string({ description: "Org/household id" }),
+		metadata: field.json({
+			description: "Metadata",
+			isOptional: true
+		}),
+		updatedAt: field.updatedAt(),
+		createdAt: field.createdAt(),
+		account: field.belongsTo("Account", ["accountId"], ["id"], { onDelete: "SetNull" })
+	},
+	enums: [AssetCategoryEnum],
+	indexes: [index.on(["orgId"]), index.on(["category"])]
+});
+const LiabilityEntity = defineEntity({
+	name: "Liability",
+	description: "Debt or obligation.",
+	schema,
+	map: "liability",
+	fields: {
+		id: field.id({ description: "Liability ID" }),
+		accountId: field.foreignKey({
+			description: "Liability account",
+			isOptional: true
+		}),
+		name: field.string({ description: "Liability name" }),
+		category: field.enum("LiabilityCategory", { description: "Liability category" }),
+		balance: field.decimal({ description: "Outstanding balance" }),
+		currency: field.string({
+			description: "Currency",
+			default: "\"USD\""
+		}),
+		interestRate: field.decimal({
+			description: "Interest rate (e.g., 0.05 for 5%)",
+			isOptional: true
+		}),
+		orgId: field.string({ description: "Org/household id" }),
+		metadata: field.json({
+			description: "Metadata",
+			isOptional: true
+		}),
+		updatedAt: field.updatedAt(),
+		createdAt: field.createdAt(),
+		account: field.belongsTo("Account", ["accountId"], ["id"], { onDelete: "SetNull" })
+	},
+	enums: [LiabilityCategoryEnum],
+	indexes: [index.on(["orgId"]), index.on(["category"])]
+});
+const GoalEntity = defineEntity({
+	name: "Goal",
+	description: "Financial goal with target amount/date.",
+	schema,
+	map: "goal",
+	fields: {
+		id: field.id({ description: "Goal ID" }),
+		name: field.string({ description: "Goal name" }),
+		targetAmount: field.decimal({ description: "Target amount" }),
+		currentAmount: field.decimal({
+			description: "Current progress amount",
+			default: 0
+		}),
+		currency: field.string({
+			description: "Currency",
+			default: "\"USD\""
+		}),
+		targetDate: field.dateTime({
+			description: "Target completion date",
+			isOptional: true
+		}),
+		status: field.enum("GoalStatus", {
+			description: "Goal status",
+			default: "ACTIVE"
+		}),
+		orgId: field.string({ description: "Org/household id" }),
+		ownerId: field.string({
+			description: "Owner user id",
+			isOptional: true
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt()
+	},
+	enums: [GoalStatusEnum],
+	indexes: [
+		index.on(["orgId"]),
+		index.on(["status"]),
+		index.on(["targetDate"])
+	]
+});
+const NetWorthSnapshotEntity = defineEntity({
+	name: "NetWorthSnapshot",
+	description: "Aggregated net worth snapshot for a date.",
+	schema,
+	map: "networth_snapshot",
+	fields: {
+		id: field.id({ description: "Snapshot ID" }),
+		asOf: field.dateTime({ description: "Snapshot date" }),
+		totalAssets: field.decimal({ description: "Total assets" }),
+		totalLiabilities: field.decimal({ description: "Total liabilities" }),
+		netWorth: field.decimal({ description: "Net worth" }),
+		currency: field.string({
+			description: "Currency",
+			default: "\"USD\""
+		}),
+		orgId: field.string({ description: "Org/household id" }),
+		createdAt: field.createdAt()
+	},
+	indexes: [index.unique(["orgId", "asOf"], { name: "networth_unique" })]
+});
+const wealthSnapshotEntities = [
+	AccountEntity,
+	AssetEntity,
+	LiabilityEntity,
+	GoalEntity,
+	NetWorthSnapshotEntity
+];
+const wealthSnapshotSchemaContribution = {
+	moduleId: "@contractspec/example.wealth-snapshot",
+	entities: wealthSnapshotEntities,
+	enums: [
+		AccountTypeEnum,
+		AssetCategoryEnum,
+		LiabilityCategoryEnum,
+		GoalStatusEnum
+	]
+};
+
+//#endregion
+export { AccountEntity, AccountTypeEnum, AssetCategoryEnum, AssetEntity, GoalEntity, GoalStatusEnum, LiabilityCategoryEnum, LiabilityEntity, NetWorthSnapshotEntity, wealthSnapshotEntities, wealthSnapshotSchemaContribution };
+//# sourceMappingURL=index.js.map

package/dist/entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["wealthSnapshotSchemaContribution: ModuleSchemaContribution"],"sources":["../../src/entities/index.ts"],"sourcesContent":["import {\n  defineEntity,\n  defineEntityEnum,\n  field,\n  index,\n} from '@contractspec/lib.schema';\nimport type { ModuleSchemaContribution } from '@contractspec/lib.schema';\n\nconst schema = 'lssm_wealth_snapshot';\n\nexport const AccountTypeEnum = defineEntityEnum({\n  name: 'AccountType',\n  schema,\n  values: ['CHECKING', 'SAVINGS', 'INVESTMENT', 'CREDIT_CARD', 'LOAN'] as const,\n  description: 'Account categories for holdings and debts.',\n});\n\nexport const AssetCategoryEnum = defineEntityEnum({\n  name: 'AssetCategory',\n  schema,\n  values: ['CASH', 'EQUITY', 'REAL_ESTATE', 'CRYPTO', 'OTHER'] as const,\n  description: 'Asset categories.',\n});\n\nexport const LiabilityCategoryEnum = defineEntityEnum({\n  name: 'LiabilityCategory',\n  schema,\n  values: ['CREDIT_CARD', 'LOAN', 'MORTGAGE', 'TAX', 'OTHER'] as const,\n  description: 'Liability categories.',\n});\n\nexport const GoalStatusEnum = defineEntityEnum({\n  name: 'GoalStatus',\n  schema,\n  values: ['ACTIVE', 'ON_TRACK', 'AT_RISK', 'OFF_TRACK', 'COMPLETED'] as const,\n  description: 'Goal health/status.',\n});\n\nexport const AccountEntity = defineEntity({\n  name: 'Account',\n  description: 'Financial account representing holdings or debts.',\n  schema,\n  map: 'account',\n  fields: {\n    id: field.id({ description: 'Account ID' }),\n    name: field.string({ description: 'Account name' }),\n    type: field.enum('AccountType', { description: 'Account type' }),\n    currency: field.string({ description: 'Currency code', default: '\"USD\"' }),\n    balance: field.decimal({ description: 'Current balance' }),\n    institution: field.string({ description: 'Institution', isOptional: true }),\n    orgId: field.string({ description: 'Org/household id' }),\n    ownerId: field.string({ description: 'Owner user id', isOptional: true }),\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n  },\n  enums: [AccountTypeEnum],\n  indexes: [index.on(['orgId']), index.on(['type']), index.on(['ownerId'])],\n});\n\nexport const AssetEntity = defineEntity({\n  name: 'Asset',\n  description: 'Individual asset position.',\n  schema,\n  map: 'asset',\n  fields: {\n    id: field.id({ description: 'Asset ID' }),\n    accountId: field.foreignKey({\n      description: 'Holding account',\n      isOptional: true,\n    }),\n    name: field.string({ description: 'Asset name' }),\n    category: field.enum('AssetCategory', { description: 'Asset category' }),\n    value: field.decimal({ description: 'Current value' }),\n    currency: field.string({ description: 'Currency', default: '\"USD\"' }),\n    orgId: field.string({ description: 'Org/household id' }),\n    metadata: field.json({ description: 'Metadata', isOptional: true }),\n    updatedAt: field.updatedAt(),\n    createdAt: field.createdAt(),\n    account: field.belongsTo('Account', ['accountId'], ['id'], {\n      onDelete: 'SetNull',\n    }),\n  },\n  enums: [AssetCategoryEnum],\n  indexes: [index.on(['orgId']), index.on(['category'])],\n});\n\nexport const LiabilityEntity = defineEntity({\n  name: 'Liability',\n  description: 'Debt or obligation.',\n  schema,\n  map: 'liability',\n  fields: {\n    id: field.id({ description: 'Liability ID' }),\n    accountId: field.foreignKey({\n      description: 'Liability account',\n      isOptional: true,\n    }),\n    name: field.string({ description: 'Liability name' }),\n    category: field.enum('LiabilityCategory', {\n      description: 'Liability category',\n    }),\n    balance: field.decimal({ description: 'Outstanding balance' }),\n    currency: field.string({ description: 'Currency', default: '\"USD\"' }),\n    interestRate: field.decimal({\n      description: 'Interest rate (e.g., 0.05 for 5%)',\n      isOptional: true,\n    }),\n    orgId: field.string({ description: 'Org/household id' }),\n    metadata: field.json({ description: 'Metadata', isOptional: true }),\n    updatedAt: field.updatedAt(),\n    createdAt: field.createdAt(),\n    account: field.belongsTo('Account', ['accountId'], ['id'], {\n      onDelete: 'SetNull',\n    }),\n  },\n  enums: [LiabilityCategoryEnum],\n  indexes: [index.on(['orgId']), index.on(['category'])],\n});\n\nexport const GoalEntity = defineEntity({\n  name: 'Goal',\n  description: 'Financial goal with target amount/date.',\n  schema,\n  map: 'goal',\n  fields: {\n    id: field.id({ description: 'Goal ID' }),\n    name: field.string({ description: 'Goal name' }),\n    targetAmount: field.decimal({ description: 'Target amount' }),\n    currentAmount: field.decimal({\n      description: 'Current progress amount',\n      default: 0,\n    }),\n    currency: field.string({ description: 'Currency', default: '\"USD\"' }),\n    targetDate: field.dateTime({\n      description: 'Target completion date',\n      isOptional: true,\n    }),\n    status: field.enum('GoalStatus', {\n      description: 'Goal status',\n      default: 'ACTIVE',\n    }),\n    orgId: field.string({ description: 'Org/household id' }),\n    ownerId: field.string({ description: 'Owner user id', isOptional: true }),\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n  },\n  enums: [GoalStatusEnum],\n  indexes: [\n    index.on(['orgId']),\n    index.on(['status']),\n    index.on(['targetDate']),\n  ],\n});\n\nexport const NetWorthSnapshotEntity = defineEntity({\n  name: 'NetWorthSnapshot',\n  description: 'Aggregated net worth snapshot for a date.',\n  schema,\n  map: 'networth_snapshot',\n  fields: {\n    id: field.id({ description: 'Snapshot ID' }),\n    asOf: field.dateTime({ description: 'Snapshot date' }),\n    totalAssets: field.decimal({ description: 'Total assets' }),\n    totalLiabilities: field.decimal({ description: 'Total liabilities' }),\n    netWorth: field.decimal({ description: 'Net worth' }),\n    currency: field.string({ description: 'Currency', default: '\"USD\"' }),\n    orgId: field.string({ description: 'Org/household id' }),\n    createdAt: field.createdAt(),\n  },\n  indexes: [index.unique(['orgId', 'asOf'], { name: 'networth_unique' })],\n});\n\nexport const wealthSnapshotEntities = [\n  AccountEntity,\n  AssetEntity,\n  LiabilityEntity,\n  GoalEntity,\n  NetWorthSnapshotEntity,\n];\n\nexport const wealthSnapshotSchemaContribution: ModuleSchemaContribution = {\n  moduleId: '@contractspec/example.wealth-snapshot',\n  // schema,\n  entities: wealthSnapshotEntities,\n  enums: [\n    AccountTypeEnum,\n    AssetCategoryEnum,\n    LiabilityCategoryEnum,\n    GoalStatusEnum,\n  ],\n};\n"],"mappings":"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"}