Refactor: Better Projections

Directory.Build.props

@@ -1,11 +1,12 @@
 <Project>
     <PropertyGroup>
-        <TargetFramework>net7.0</TargetFramework>
+        <TargetFrameworks>net7.0;net8.0</TargetFrameworks>
         <Nullable>enable</Nullable>
-		<ImplicitUsings>enable</ImplicitUsings>
-	</PropertyGroup>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <LangVersion>12</LangVersion>
+    </PropertyGroup>
 
-	<ItemGroup>
-		<PackageReference Include="System.Linq.Async" Version="6.0.1" />
-	</ItemGroup>
+    <ItemGroup>
+        <PackageReference Include="System.Linq.Async" Version="6.0.1"/>
+    </ItemGroup>
 </Project>

EntityDb.sln

@@ -18,8 +18,6 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "EntityDb.Mvc", "src\EntityD
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "EntityDb.Redis", "src\EntityDb.Redis\EntityDb.Redis.csproj", "{F7BB95AE-A032-4170-89E3-E8A1D492EFB5}"
 EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "EntityDb.Void", "src\EntityDb.Void\EntityDb.Void.csproj", "{C4239113-18BE-4418-87A8-E9617EF0A2DF}"
-EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "test", "test", "{92484C44-2754-4C1D-BD46-98D83E4020EE}"
 	ProjectSection(SolutionItems) = preProject
 		test\Directory.Build.props = test\Directory.Build.props
@@ -37,19 +35,17 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 	ProjectSection(SolutionItems) = preProject
 		Directory.Build.props = Directory.Build.props
 		global.json = global.json
+		ICON.png = ICON.png
+		LICENSE.txt = LICENSE.txt
+		README.md = README.md
+		SECURITY.md = SECURITY.md
 	EndProjectSection
 EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "EntityDb.InMemory", "src\EntityDb.InMemory\EntityDb.InMemory.csproj", "{31C5BEDB-9B04-4FE4-9AF5-AE682C0E7643}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "EntityDb.Npgsql", "src\EntityDb.Npgsql\EntityDb.Npgsql.csproj", "{2AADF21D-4F26-4BD6-852A-B28208863FDD}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "EntityDb.SqlDb", "src\EntityDb.SqlDb\EntityDb.SqlDb.csproj", "{F2491666-31D1-47B5-A493-F25E167D1FDF}"
-EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "EntityDb.Json", "src\EntityDb.Json\EntityDb.Json.csproj", "{4936FFE0-98E5-43A2-89C9-0415A13CAA9B}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "EntityDb.Provisioner", "src\EntityDb.Provisioner\EntityDb.Provisioner.csproj", "{26FCDB9D-0DE3-4BB9-858D-3E2C3EF763E3}"
 EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "EntityDb.EntityFramework", "src\EntityDb.EntityFramework\EntityDb.EntityFramework.csproj", "{199606BF-6283-4684-A224-4DA7E80D8F45}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EntityDb.Aws", "src\EntityDb.Aws\EntityDb.Aws.csproj", "{71EF2C8C-F6BF-4CE3-91A4-62F8C7C9FB8B}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
@@ -77,10 +73,6 @@ Global
 		{F7BB95AE-A032-4170-89E3-E8A1D492EFB5}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{F7BB95AE-A032-4170-89E3-E8A1D492EFB5}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{F7BB95AE-A032-4170-89E3-E8A1D492EFB5}.Release|Any CPU.Build.0 = Release|Any CPU
-		{C4239113-18BE-4418-87A8-E9617EF0A2DF}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{C4239113-18BE-4418-87A8-E9617EF0A2DF}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{C4239113-18BE-4418-87A8-E9617EF0A2DF}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{C4239113-18BE-4418-87A8-E9617EF0A2DF}.Release|Any CPU.Build.0 = Release|Any CPU
 		{CF316519-525E-4A67-BF12-1FDDF802B878}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{CF316519-525E-4A67-BF12-1FDDF802B878}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{CF316519-525E-4A67-BF12-1FDDF802B878}.Release|Any CPU.ActiveCfg = Release|Any CPU
@@ -97,18 +89,6 @@ Global
 		{FA2AD2E9-84DA-4667-BF46-140B0B050563}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{FA2AD2E9-84DA-4667-BF46-140B0B050563}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{FA2AD2E9-84DA-4667-BF46-140B0B050563}.Release|Any CPU.Build.0 = Release|Any CPU
-		{31C5BEDB-9B04-4FE4-9AF5-AE682C0E7643}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{31C5BEDB-9B04-4FE4-9AF5-AE682C0E7643}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{31C5BEDB-9B04-4FE4-9AF5-AE682C0E7643}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{31C5BEDB-9B04-4FE4-9AF5-AE682C0E7643}.Release|Any CPU.Build.0 = Release|Any CPU
-		{2AADF21D-4F26-4BD6-852A-B28208863FDD}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{2AADF21D-4F26-4BD6-852A-B28208863FDD}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{2AADF21D-4F26-4BD6-852A-B28208863FDD}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{2AADF21D-4F26-4BD6-852A-B28208863FDD}.Release|Any CPU.Build.0 = Release|Any CPU
-		{F2491666-31D1-47B5-A493-F25E167D1FDF}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{F2491666-31D1-47B5-A493-F25E167D1FDF}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{F2491666-31D1-47B5-A493-F25E167D1FDF}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{F2491666-31D1-47B5-A493-F25E167D1FDF}.Release|Any CPU.Build.0 = Release|Any CPU
 		{4936FFE0-98E5-43A2-89C9-0415A13CAA9B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{4936FFE0-98E5-43A2-89C9-0415A13CAA9B}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{4936FFE0-98E5-43A2-89C9-0415A13CAA9B}.Release|Any CPU.ActiveCfg = Release|Any CPU
@@ -117,10 +97,10 @@ Global
 		{26FCDB9D-0DE3-4BB9-858D-3E2C3EF763E3}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{26FCDB9D-0DE3-4BB9-858D-3E2C3EF763E3}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{26FCDB9D-0DE3-4BB9-858D-3E2C3EF763E3}.Release|Any CPU.Build.0 = Release|Any CPU
-		{199606BF-6283-4684-A224-4DA7E80D8F45}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{199606BF-6283-4684-A224-4DA7E80D8F45}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{199606BF-6283-4684-A224-4DA7E80D8F45}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{199606BF-6283-4684-A224-4DA7E80D8F45}.Release|Any CPU.Build.0 = Release|Any CPU
+		{71EF2C8C-F6BF-4CE3-91A4-62F8C7C9FB8B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{71EF2C8C-F6BF-4CE3-91A4-62F8C7C9FB8B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{71EF2C8C-F6BF-4CE3-91A4-62F8C7C9FB8B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{71EF2C8C-F6BF-4CE3-91A4-62F8C7C9FB8B}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -131,17 +111,13 @@ Global
 		{0BEA3379-6637-44F2-8332-7EA81B02BBBF} = {ABACFBCC-B59F-4616-B6CC-99C37AEC8960}
 		{8A485A1A-54E4-48AD-9B35-97D286F432CE} = {ABACFBCC-B59F-4616-B6CC-99C37AEC8960}
 		{F7BB95AE-A032-4170-89E3-E8A1D492EFB5} = {ABACFBCC-B59F-4616-B6CC-99C37AEC8960}
-		{C4239113-18BE-4418-87A8-E9617EF0A2DF} = {ABACFBCC-B59F-4616-B6CC-99C37AEC8960}
 		{CF316519-525E-4A67-BF12-1FDDF802B878} = {92484C44-2754-4C1D-BD46-98D83E4020EE}
 		{8D9C0976-BF78-439A-BBCB-3CFC2EEF1A0F} = {92484C44-2754-4C1D-BD46-98D83E4020EE}
 		{B8B6E5A5-5154-4629-9A38-9F0E65575F30} = {92484C44-2754-4C1D-BD46-98D83E4020EE}
 		{FA2AD2E9-84DA-4667-BF46-140B0B050563} = {92484C44-2754-4C1D-BD46-98D83E4020EE}
-		{31C5BEDB-9B04-4FE4-9AF5-AE682C0E7643} = {ABACFBCC-B59F-4616-B6CC-99C37AEC8960}
-		{2AADF21D-4F26-4BD6-852A-B28208863FDD} = {ABACFBCC-B59F-4616-B6CC-99C37AEC8960}
-		{F2491666-31D1-47B5-A493-F25E167D1FDF} = {ABACFBCC-B59F-4616-B6CC-99C37AEC8960}
 		{4936FFE0-98E5-43A2-89C9-0415A13CAA9B} = {ABACFBCC-B59F-4616-B6CC-99C37AEC8960}
 		{26FCDB9D-0DE3-4BB9-858D-3E2C3EF763E3} = {ABACFBCC-B59F-4616-B6CC-99C37AEC8960}
-		{199606BF-6283-4684-A224-4DA7E80D8F45} = {ABACFBCC-B59F-4616-B6CC-99C37AEC8960}
+		{71EF2C8C-F6BF-4CE3-91A4-62F8C7C9FB8B} = {ABACFBCC-B59F-4616-B6CC-99C37AEC8960}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {E9D288EE-9351-4018-ABE8-B0968AEB0465}

LICENSE.txt

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 - 2022 entitydb.io
+Copyright (c) 2021 - 2024 entitydb.io
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -25,86 +25,107 @@ information on the statement. (If I'm wrong, you should consider getting a new b
 
 ## How does EntityDb.NET implement Event Sourcing?
 
-There are several core objects at the heart of this implementation. Encalsulating these objects are various repositories.
+There are several core objects at the heart of this implementation. Encapsulating these objects are various
+repositories.
 
-1. Transaction Repository
-   - Agents
-   - Commands
-   - Tags
-   - Leases
-2. Snapshot Repository
-   - Snapshots
-2. Entity Repository
-   - Transaction Repository
-   - Optional: Snapshot Repository
-3. Projection Repository
-   - Transaction Repository
-   - Optional: Snapshot Repository
+1. Source Repository
+    - Agent Signatures
+    - Deltas
+    - Tags
+    - Leases
+2. State Repository
+    - States
+3. Stream Repository
+4. Entity Repository
+5. Projection Repository
 
-### Transactions
+### Sources
 
-A transaction represents an atomic operation on multiple entities. A transaction is committed atomically or not
-at all. If some step in the transaction fails, the entire transaction should fail.
+A source represents an atomic operation on one or more states.
+If any message in the source cannot be committed, the entire source
+cannot be committed.
 
-### Agents
+### Agent Signatures
 
-An agent is an actor that can execute transactions. For example, if a transaction is initiated via an HTTP API, you
-might use the `HttpContextAgent` - it's signature includes headers and connection information, and it uses the
-ClaimsPrincipal to decide if an agent has a particular role required for authorized commands.
+An agent is an actor that can record sources and interact with states. Whenever a source is committed,
+the signature of the agent is recorded with it.
 
-### Commands
+For example, if a source is initiated via an HTTP API, you
+might use the `HttpContextAgent` - it's signature includes headers and connection information.
 
-A command represents the intent to perform some operation on a single entity. Going back to the bank account example,
-one command could be `PerformDeposit` while another could be `PerformWithdrawl`. The things that you can do are
-commands.
+### Deltas
+
+A delta represents a change in state. Literally anything can be a delta.
+
+Going back to the bank account example,
+one delta could be `PerformDeposit` while another could be `PerformWithdrawl`. The things that you can do (commands),
+as well as things that are done elsewhere (events), are deltas.
 
 ### Tags
 
-A tag is a way to index entities by some piece of information. A tag can have a label and a value, both of which are
-strings. Many accounts are typed, and you could represent this with a tag where `Label` is `Type` and `Value`
+A tag is a way to index sources by some piece of information contained within. A tag can have a label and a value, both
+of which are
+strings.
+
+Many accounts are typed, and you could represent this with a tag where `Label` is `Type` and `Value`
 is `Savings` or `Checking`. You could then run a query to get the account id of all accounts where `Label` is `Type`
-and `Value` is `Savings`. The number of savings accounts in the system would be the number of entity ids.
+and `Value` is `Savings`. The number of savings accounts in the system would be the number of state ids.
 
 ### Leases
 
-A lease is like a tag, except that it has a uniqueness constraint. Many banks have online portals, allowing bank members
+A lease is like a tag, except that it has a uniqueness constraint. In addition to a label and value, leases also have
+a scope.
+
+Many banks have online portals, allowing bank members
 to see their accounts on the internet. From the bank's perspective, all of the accounts should be tied to a member id,
-probably a guid. But the member will not want to remember nor lookup this guid - they will want to use a username. What
-you can do in EntityDb is make a lease for member entities where the entity id is the member id, the `Label`
-is `Username`
-and the `Value` is whatever username the member wants to use. If an attempt to commit a transaction is made that would
-violate the uniqueness constraint, it will be rejected. (This is obnoxious behavior for the user, though, so the bank
-should check before attempting to commit to see if the username is available and give immediate feedback to choose a
+probably a guid. But the member will not want to remember nor lookup this id - they will want to use a username. What
+you can do in EntityDb is make a lease for members where the `Scope` is `Global`, the `Label`
+is `Username`, and the `Value` is whatever username the member wants to use. If an attempt to commit a source is made
+that would violate the uniqueness constraint, the commit will fail. (However, this is bad UX, so the bank
+should check that the username is available before attempting to commit and give immediate feedback to choose a
 different username).
 
-### Snapshots
+### State
 
-A snapshot is a stateful object at a given point in time. They always have an identifier and a version number.
-Together, the identifier and version number called a pointer. You can request different versions of a given snapshot
-by using different pointers!
+A state is an object at a given point in time. Each state has a unique identifier, and across time each state
+has a multiple versions. Together, the identifier and a single version are called a pointer, and you can refer to a
+state
+at a given point in time by using the associated pointer.
 
-In the context of snapshots, the reserved version number is reserved for pointing to the latest snapshot.
-So if you want the latest version, you use a pointer with the exact id and the reserved version number.
-If you want a specific version, you can create pointer with the exact id and version number you want.
+The default version, `Version.Zero` is given special meaning in certain scenarios. When attempting to load a state, it
+means
+that the state does not exist. When attempting to modify a state, it means that the previous version of the state is
+irrelevant.
 
-The balance on your bank account is a snapshot. You can build that snapshot by summing all of the deposits and
-withdrawls on your account. If you look at the bank statements, you will most likely see the snapshot of each bank
+The balance on your bank account is a state. You can build that state by summing all of the deposits and
+withdrawls on your account. If you look at the bank statements, you will most likely see the state of each bank
 account for that statement, along with all of the deposits, withdrawls, and interest.
 
-### Entities
+### Stream Repository
+
+A stream repository is specialized at producing sources when the order of messages
+is out of the control of the application.
+
+A great use case for a stream is to capture events coming from 3rd party, or even from
+a different domain of your own suite of applications.
+
+Sorry - I have not yet completed my thoughts of how to apply the banking metaphor here.
+
+### Entity Repository
+
+An entity repository is specialized at producing sources when the order of messages
+is completely in the control of the application, and consuming sources to generate
+a state that determines the validity of requests.
+
+A great use case for an entity is to capture commands.
 
-An entity is conceptually an aggregate root inside of a bounded context, and it extends the concept of a snapshot.
 In the banking example, there are multiple entities. You have a membership at the bank. That's an entity. You probably
 have a checking account. That's an entity. And you might even have a savings account. That is also an entity!
 
-Which bounded contexts these entiies live in is up to the business.
+### Projection Repository
 
-### Projections
+A projection repository does not produce sources, it only consumes them.
 
-A projection is an aggregate, but notably _not_ the aggregate root, and it too extends the concept of a snapshot.
-In the banking example, one example of a projection could be your entire account balance. It can be anything, though!
+In the banking example, one example of a projection could be your entire balance across all accounts. It can be
+anything, though!
 You are not constrained in what data you want to use for your projection.
-
-### Communications
-
-- Coming Soon!<sup>TM</sup>

SECURITY.md

@@ -2,11 +2,12 @@
 
 ## Supported Versions
 
-Version | Supported
-|---|---|
-\>= 8.0 | :white_check_mark:
-< 8.0 | :x:
+ Version | Supported          
+|---------|--------------------|
+ \>= 8.0 | :white_check_mark: 
+ < 8.0   | :x:                
 
 ## Reporting a Vulnerability
 
-Please report vulnerabilities [here](https://github.com/entitydb-io/EntityDb.NET/issues/new?assignees=&labels=&template=bug_report.md&title=[VULNERABILITY]%20)
+Please report
+vulnerabilities [here](https://github.com/entitydb-io/EntityDb.NET/issues/new?assignees=&labels=&template=bug_report.md&title=[VULNERABILITY]%20)

global.json

@@ -1,6 +1,6 @@
 {
   "sdk": {
-    "version": "7.0.201",
+    "version": "8.0.100",
     "allowPrerelease": false,
     "rollForward": "disable"
   }

src/Directory.Build.props

@@ -13,7 +13,7 @@
         <SymbolPackageFormat>snupkg</SymbolPackageFormat>
         <Authors>Chris Philips</Authors>
         <Company>entitydb.io</Company>
-        <Copyright>2021 - 2022 © entitydb.io</Copyright>
+        <Copyright>2021 - 2024 © entitydb.io</Copyright>
         <RepositoryUrl>https://github.com/entitydb-io/entitydb</RepositoryUrl>
         <RepositoryType>git</RepositoryType>
         <NeutralLanguage>en</NeutralLanguage>