@lssm/example.wealth-snapshot 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217073102

package/dist/contracts/index.js

@@ -1 +1,429 @@
-import{l as e}from"../libs/schema/dist/ScalarTypeEnum.js";import{n as t}from"../libs/schema/dist/SchemaModel.js";import"../libs/schema/dist/index.js";import{n,t as r}from"../libs/contracts/dist/spec.js";import"../libs/contracts/dist/index.js";const i=[`examples.wealth-snapshot`],a=t({name:`Account`,description:`Account model`,fields:{id:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},type:{type:e.String_unsecure(),isOptional:!1},currency:{type:e.String_unsecure(),isOptional:!1},balance:{type:e.Float_unsecure(),isOptional:!1}}}),o=t({name:`Asset`,description:`Asset model`,fields:{id:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},category:{type:e.String_unsecure(),isOptional:!1},value:{type:e.Float_unsecure(),isOptional:!1},currency:{type:e.String_unsecure(),isOptional:!1}}}),s=t({name:`Liability`,description:`Liability model`,fields:{id:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},category:{type:e.String_unsecure(),isOptional:!1},balance:{type:e.Float_unsecure(),isOptional:!1},currency:{type:e.String_unsecure(),isOptional:!1}}}),c=t({name:`Goal`,description:`Goal model`,fields:{id:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},targetAmount:{type:e.Float_unsecure(),isOptional:!1},currentAmount:{type:e.Float_unsecure(),isOptional:!1},currency:{type:e.String_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1}}}),l=t({name:`NetWorthSnapshot`,description:`Net worth snapshot model`,fields:{asOf:{type:e.DateTime(),isOptional:!1},totalAssets:{type:e.Float_unsecure(),isOptional:!1},totalLiabilities:{type:e.Float_unsecure(),isOptional:!1},netWorth:{type:e.Float_unsecure(),isOptional:!1},currency:{type:e.String_unsecure(),isOptional:!1}}}),u=t({name:`CreateAccountInput`,description:`Create account input`,fields:{name:{type:e.String_unsecure(),isOptional:!1},type:{type:e.String_unsecure(),isOptional:!1},currency:{type:e.String_unsecure(),isOptional:!0},balance:{type:e.Float_unsecure(),isOptional:!0},orgId:{type:e.String_unsecure(),isOptional:!1}}}),d=t({name:`AddAssetInput`,description:`Add asset input`,fields:{accountId:{type:e.String_unsecure(),isOptional:!0},name:{type:e.String_unsecure(),isOptional:!1},category:{type:e.String_unsecure(),isOptional:!1},value:{type:e.Float_unsecure(),isOptional:!1},currency:{type:e.String_unsecure(),isOptional:!0},orgId:{type:e.String_unsecure(),isOptional:!1}}}),f=t({name:`AddLiabilityInput`,description:`Add liability input`,fields:{accountId:{type:e.String_unsecure(),isOptional:!0},name:{type:e.String_unsecure(),isOptional:!1},category:{type:e.String_unsecure(),isOptional:!1},balance:{type:e.Float_unsecure(),isOptional:!1},currency:{type:e.String_unsecure(),isOptional:!0},orgId:{type:e.String_unsecure(),isOptional:!1}}}),p=t({name:`UpdateGoalInput`,description:`Update goal progress`,fields:{goalId:{type:e.String_unsecure(),isOptional:!1},currentAmount:{type:e.Float_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!0}}}),m=t({name:`CreateGoalInput`,description:`Create goal input`,fields:{name:{type:e.String_unsecure(),isOptional:!1},targetAmount:{type:e.Float_unsecure(),isOptional:!1},currency:{type:e.String_unsecure(),isOptional:!0},targetDate:{type:e.DateTime(),isOptional:!0},orgId:{type:e.String_unsecure(),isOptional:!1}}}),h=t({name:`NetWorthQueryInput`,description:`Filter for net worth snapshots`,fields:{orgId:{type:e.String_unsecure(),isOptional:!1},from:{type:e.DateTime(),isOptional:!0},to:{type:e.DateTime(),isOptional:!0}}}),g=r({meta:{name:`wealth.account.create`,version:1,stability:`stable`,owners:[...i],tags:[`wealth`,`account`,`create`],description:`Create a financial account.`,goal:`Track account balances.`,context:`Onboarding/import.`},io:{input:u,output:a},policy:{auth:`user`}}),_=r({meta:{name:`wealth.asset.add`,version:1,stability:`stable`,owners:[...i],tags:[`wealth`,`asset`,`add`],description:`Add an asset position.`,goal:`Track holdings.`,context:`Asset onboarding/update.`},io:{input:d,output:o},policy:{auth:`user`}}),v=r({meta:{name:`wealth.liability.add`,version:1,stability:`stable`,owners:[...i],tags:[`wealth`,`liability`,`add`],description:`Add a liability.`,goal:`Track debts.`,context:`Debt onboarding/update.`},io:{input:f,output:s},policy:{auth:`user`}}),y=r({meta:{name:`wealth.goal.create`,version:1,stability:`stable`,owners:[...i],tags:[`wealth`,`goal`,`create`],description:`Create a financial goal.`,goal:`Track progress toward goals.`,context:`Planning.`},io:{input:m,output:c},policy:{auth:`user`}}),b=r({meta:{name:`wealth.goal.update`,version:1,stability:`stable`,owners:[...i],tags:[`wealth`,`goal`,`update`],description:`Update goal progress.`,goal:`Keep progress current.`,context:`Periodic update.`},io:{input:p,output:c},policy:{auth:`user`}}),x=n({meta:{name:`wealth.networth.get`,version:1,stability:`stable`,owners:[...i],tags:[`wealth`,`networth`],description:`Get net worth snapshots for a period.`,goal:`Render charts and indicators.`,context:`Dashboard.`},io:{input:h,output:t({name:`NetWorthQueryOutput`,description:`Snapshots + latest indicators`,fields:{snapshots:{type:l,isArray:!0,isOptional:!1},latest:{type:l,isOptional:!0}}})},policy:{auth:`user`}});export{a as AccountModel,_ as AddAssetContract,v as AddLiabilityContract,o as AssetModel,g as CreateAccountContract,y as CreateGoalContract,x as GetNetWorthContract,c as GoalModel,s as LiabilityModel,l as NetWorthSnapshotModel,b as UpdateGoalContract};
+import { ScalarTypeEnum } from "../libs/schema/dist/ScalarTypeEnum.js";
+import { defineSchemaModel } from "../libs/schema/dist/SchemaModel.js";
+import "../libs/schema/dist/index.js";
+import { defineCommand, defineQuery } from "../libs/contracts/dist/spec.js";
+import "../libs/contracts/dist/index.js";
+
+//#region src/contracts/index.ts
+const OWNERS = ["examples.wealth-snapshot"];
+const AccountModel = defineSchemaModel({
+	name: "Account",
+	description: "Account model",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		type: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		currency: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		balance: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const AssetModel = defineSchemaModel({
+	name: "Asset",
+	description: "Asset model",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		category: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		value: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		currency: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const LiabilityModel = defineSchemaModel({
+	name: "Liability",
+	description: "Liability model",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		category: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		balance: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		currency: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const GoalModel = defineSchemaModel({
+	name: "Goal",
+	description: "Goal model",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		targetAmount: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		currentAmount: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		currency: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const NetWorthSnapshotModel = defineSchemaModel({
+	name: "NetWorthSnapshot",
+	description: "Net worth snapshot model",
+	fields: {
+		asOf: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		totalAssets: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		totalLiabilities: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		netWorth: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		currency: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const CreateAccountInput = defineSchemaModel({
+	name: "CreateAccountInput",
+	description: "Create account input",
+	fields: {
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		type: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		currency: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		balance: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const AddAssetInput = defineSchemaModel({
+	name: "AddAssetInput",
+	description: "Add asset input",
+	fields: {
+		accountId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		category: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		value: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		currency: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const AddLiabilityInput = defineSchemaModel({
+	name: "AddLiabilityInput",
+	description: "Add liability input",
+	fields: {
+		accountId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		category: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		balance: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		currency: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const UpdateGoalInput = defineSchemaModel({
+	name: "UpdateGoalInput",
+	description: "Update goal progress",
+	fields: {
+		goalId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		currentAmount: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const CreateGoalInput = defineSchemaModel({
+	name: "CreateGoalInput",
+	description: "Create goal input",
+	fields: {
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		targetAmount: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		currency: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		targetDate: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const NetWorthQueryInput = defineSchemaModel({
+	name: "NetWorthQueryInput",
+	description: "Filter for net worth snapshots",
+	fields: {
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		from: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		to: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		}
+	}
+});
+const CreateAccountContract = defineCommand({
+	meta: {
+		name: "wealth.account.create",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"wealth",
+			"account",
+			"create"
+		],
+		description: "Create a financial account.",
+		goal: "Track account balances.",
+		context: "Onboarding/import."
+	},
+	io: {
+		input: CreateAccountInput,
+		output: AccountModel
+	},
+	policy: { auth: "user" }
+});
+const AddAssetContract = defineCommand({
+	meta: {
+		name: "wealth.asset.add",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"wealth",
+			"asset",
+			"add"
+		],
+		description: "Add an asset position.",
+		goal: "Track holdings.",
+		context: "Asset onboarding/update."
+	},
+	io: {
+		input: AddAssetInput,
+		output: AssetModel
+	},
+	policy: { auth: "user" }
+});
+const AddLiabilityContract = defineCommand({
+	meta: {
+		name: "wealth.liability.add",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"wealth",
+			"liability",
+			"add"
+		],
+		description: "Add a liability.",
+		goal: "Track debts.",
+		context: "Debt onboarding/update."
+	},
+	io: {
+		input: AddLiabilityInput,
+		output: LiabilityModel
+	},
+	policy: { auth: "user" }
+});
+const CreateGoalContract = defineCommand({
+	meta: {
+		name: "wealth.goal.create",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"wealth",
+			"goal",
+			"create"
+		],
+		description: "Create a financial goal.",
+		goal: "Track progress toward goals.",
+		context: "Planning."
+	},
+	io: {
+		input: CreateGoalInput,
+		output: GoalModel
+	},
+	policy: { auth: "user" }
+});
+const UpdateGoalContract = defineCommand({
+	meta: {
+		name: "wealth.goal.update",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"wealth",
+			"goal",
+			"update"
+		],
+		description: "Update goal progress.",
+		goal: "Keep progress current.",
+		context: "Periodic update."
+	},
+	io: {
+		input: UpdateGoalInput,
+		output: GoalModel
+	},
+	policy: { auth: "user" }
+});
+const GetNetWorthContract = defineQuery({
+	meta: {
+		name: "wealth.networth.get",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: ["wealth", "networth"],
+		description: "Get net worth snapshots for a period.",
+		goal: "Render charts and indicators.",
+		context: "Dashboard."
+	},
+	io: {
+		input: NetWorthQueryInput,
+		output: defineSchemaModel({
+			name: "NetWorthQueryOutput",
+			description: "Snapshots + latest indicators",
+			fields: {
+				snapshots: {
+					type: NetWorthSnapshotModel,
+					isArray: true,
+					isOptional: false
+				},
+				latest: {
+					type: NetWorthSnapshotModel,
+					isOptional: true
+				}
+			}
+		})
+	},
+	policy: { auth: "user" }
+});
+
+//#endregion
+export { AccountModel, AddAssetContract, AddLiabilityContract, AssetModel, CreateAccountContract, CreateGoalContract, GetNetWorthContract, GoalModel, LiabilityModel, NetWorthSnapshotModel, UpdateGoalContract };

package/dist/docs/index.js

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

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

@@ -1,4 +1,21 @@
-import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contracts/dist/docs/index.js";e([{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
+import { registerDocBlocks } from "../libs/contracts/dist/docs/registry.js";
+import "../libs/contracts/dist/docs/index.js";
+
+//#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.
@@ -12,7 +29,17 @@ import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contr
 
 ## 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
+`
+	},
+	{
+		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.
 
@@ -22,7 +49,17 @@ import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contr
 
 ## 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
+- 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.
 
@@ -34,7 +71,21 @@ import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contr
 ## 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
+- 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.
@@ -46,4 +97,8 @@ import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contr
 ## 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.`}]);
+- Use Feature Flags for new indicators/alert rules; default safe/off.`
+	}
+]);
+
+//#endregion