Hiperspace 2.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package Hiperspace --version 2.0.0                
NuGet\Install-Package Hiperspace -Version 2.0.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Hiperspace" Version="2.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Hiperspace --version 2.0.0                
#r "nuget: Hiperspace, 2.0.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Hiperspace as a Cake Addin
#addin nuget:?package=Hiperspace&version=2.0.0

// Install Hiperspace as a Cake Tool
#tool nuget:?package=Hiperspace&version=2.0.0                

Hiperspace

Hiperspace is an Object technology that uses a key-addressable store to expand an application data-model beyond the limits of memory that can be directly referenced in main memory.

Elements are not duplicated or changing to match database shapes.
Elements are serialized directly using Protocol Buffers to and from key/value structure for storage in memory stores including CXL expanded and pooled memory, shared cache , local SSD or key-value durable databases.
Elements that are not currently being used are released from main memory, and transparently (and quickly) reloaded when referenced. Memory stores allows petabytes of data to be addressed.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on Hiperspace:

Package Downloads
Hiperspace.Heap

Hiperspace heap store for session, edge and testing purposes

Hiperspace.Rocks

HiperSpace RocksDB adaptor

Hiperspace.SQL

# Hiperspace.SQL Hiperspace.SQL is a full SQL query engine for Hiperspace, supporting the full range of joins, aggregations, and subqueries. Hiperspace.SQL provides the same query functionality as a .NET client can use with LINQ queries, but without the need to write code in C#/F# Hiperspace fully supports point-in-time "time travel" queries that are not possible with Python Data-Frames or DuckDB ## Features - Hiperspace.SQL is not limited to queries of columns within a table, but supports the full navigation of properties of Hiperspace elements - Where a column is a complex object it is returned as a JSON object - Executing a batch of SQL statements return columnar data frames (dictionary of column-name and array of values) - Explain SQL returns the execution plan, detailing the SetSPaces accessed and keys used for search (Key, Index, Scan) - The Parquet method returns a Parquet file that can be used with any Apache Parquet library, or added to DuckDB OLAP store

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.1.0 57 1/24/2025
2.0.0 29 1/14/2025
1.3.9 114 11/15/2024
1.3.3 100 11/1/2024
1.3.1 162 10/18/2024
1.3.0 135 10/5/2024
1.2.31 152 9/15/2024
1.2.26 123 9/1/2024
1.2.18 87 8/6/2024
1.2.12 89 7/26/2024
1.2.9 125 7/19/2024
1.2.8 132 7/15/2024
1.2.4 148 7/4/2024
1.2.0 158 5/30/2024
1.0.46 101 5/11/2024
1.0.40 121 4/22/2024
1.0.34 169 3/14/2024
1.0.28 165 2/26/2024
1.0.27 152 2/16/2024
1.0.24 206 1/11/2024
1.0.23 190 1/1/2024
1.0.1 192 11/18/2023

## Overview
This Version is a major refactor, taking into consideration lessons learned from implementing hyperspace with blazer web assembly.  It was hoped that .NET 9 would include greater compatibility with runtime type creation (used by protobuf-net for serialisation classes) or that protobuf-net "Ahead of time" (AOT) code generation would be included, but switching to direct protobuf serialization has the additional benefit of simplify usage with {Android, iOS, [Unity](https://unity.com/), zOS, [Meadow](https://www.wildernesslabs.co/)}. **Hiperspace** is the only domain-oriented object mapping technology that can be deployed into these environments, providing transparent sharing of elements between edge devices and server context.

The companion change to [HiLang](HiLang) includes the generation of serialization code for domain models.

### Security enhancement
Previously the predicates provided to **Horizon**  filters look an instance of an element and return true if it was within the horizon of the subspace.  This has been expanded to allow three types of Horizon Filter
* `new Horizon<Element_Type> ( element => element.Valid == true)'  a horizon predicate with the element only
* `new Horizon<Element_Type> ( (element, read) => element.Valid == true || read)'  a horizon predicate with a flag to indicate a read operation
* `new Horizon<Element_Type> ( (element, context, read) => element.Valid == true || read)'  a horizon predicate with a context parameter and a flag to indicate a read operation
* `new Horizon<Element_Type> ( (element, context, user, read) => element.Valid == true || user?.IsInRole("BULK"))'  a horizon predicate with a context parameter, user IPrinciple and a flag to indicate a read operation

Subspace has three labels added to support enhanced security

| Label name  | Description |
| ------------- | ------------- |
| Context        | Context that the space was opened with e.g. "Front Office", "Risk", "Settlement" |
| User           | an optional `IPrincipal` for access control |
| Remote     | Was the subspace opened remotely, and security/validation need to be re-applied on the server |


### Protobuf-net
[protobuf-net](protobuf-net) dependency for all .NET assemblies have been changed to [protobuf-net.Core](protobuf-net.Core) which does not include dynamic generation of serialization/deserialization code.

### Web applications

Web applications can take advantage of the HiperSpace shared between the web-client (or desktop applications) and the server session for the user with full lazy loading as required.

Hiperspace elements are transferred using [gRPC-Web](https://github.com/grpc/grpc-web)  for web-clients {browser, Android, iOS, [Unity](https://unity.com/)}  and [gRPC](https://grpc.io/) for desktop applications.
gRPC-Web packets are exchanged space efficient binary messages without JSON text conversion