NextGenSoftware.OASIS.API.Providers.GoogleCloudOASIS
2.0.5
See the version list below for details.
dotnet add package NextGenSoftware.OASIS.API.Providers.GoogleCloudOASIS --version 2.0.5
NuGet\Install-Package NextGenSoftware.OASIS.API.Providers.GoogleCloudOASIS -Version 2.0.5
<PackageReference Include="NextGenSoftware.OASIS.API.Providers.GoogleCloudOASIS" Version="2.0.5" />
<PackageVersion Include="NextGenSoftware.OASIS.API.Providers.GoogleCloudOASIS" Version="2.0.5" />
<PackageReference Include="NextGenSoftware.OASIS.API.Providers.GoogleCloudOASIS" />
paket add NextGenSoftware.OASIS.API.Providers.GoogleCloudOASIS --version 2.0.5
#r "nuget: NextGenSoftware.OASIS.API.Providers.GoogleCloudOASIS, 2.0.5"
#:package NextGenSoftware.OASIS.API.Providers.GoogleCloudOASIS@2.0.5
#addin nuget:?package=NextGenSoftware.OASIS.API.Providers.GoogleCloudOASIS&version=2.0.5
#tool nuget:?package=NextGenSoftware.OASIS.API.Providers.GoogleCloudOASIS&version=2.0.5
NextGen Software WEB4 OASIS API Google Cloud OASIS Provider
GoogleCloudOASIS uses the Google Cloud SDKs. Canonical OASIS avatar/detail/holon persistence uses Firestore; optional Cloud Storage and BigQuery clients are separate capabilities, not covered by Firestore-only evidence.
Username/email exports resolve the current avatar identity; version selects exported holon roots, not the avatar's independent history. Use the current username/email even for older holons. Linked children keep independent versions. Explicit versioned avatar lookups still support historical identity fields. Negative export versions fail before identity I/O.
Current direct verification
Single-holon hard deletes also validate the SDK acknowledgement timestamp before publishing deletion success. Invalid acknowledgement retains reconciliation-required evidence even when independent inspection shows the original was deleted; do not replay it blindly. Existing server precondition conflicts remain known rejections. Transactional avatar deletion acknowledgement and durable recovery still require separate verification.
Avatar export roots are selected by CreatedByAvatarId, not merely ParentHolonId. Native regressions cover ID, username and email routes synchronously and asynchronously. Existing descendant projection is unchanged; this does not establish an authorization policy for graph descendants.
Use the retained local runner Scripts/TestHosts/Run-ReusableGoogleTests.ps1. It requires the already-installed Firestore emulator, reuses cached dependencies/fixed outputs, takes an exclusive environment lease and stops its owned Java process afterward. No implicit installation or production credentials. Test results are scoped to native Firestore SDK calls, not hosted cloud authorization, charges or complete provider/interface certification.
Trusted application subclasses are projected into canonical Core DTOs before saving, including selected recursive graph nodes through the shared planner. Stored JSON continues to use the restricted type binder; consumer-only CLR type names are not a persistence contract. Avatar-detail provider keys are stored and published only after acknowledgement. Arbitrary explicit-interface/proxy implementations and extra application-specific fields are not certified by these subclass tests.
Historical reads currently reject positive versions. General concurrency, acknowledgement/recovery, all fields/options/interfaces, Cloud Storage/BigQuery and hosted/API/release gates remain open. Activation can perform service-side health/setup operations; Firestore tests disable Cloud Storage/BigQuery and use the loopback emulator. Current evidence and limitations: Docs/WIP/HyperDrive-Providers/HYPERDRIVE_V2_CURRENT_RELEASE_GATES.md.
Single-record saves now require a nonnull SDK WriteResult with a nondefault native server UpdateTime before publishing caller IDs/keys. This validates the acknowledgement, not application CreatedDate metadata. Missing/uninitialized acknowledgements retain the attempted document path and reconciliation marker; no server transaction ID is invented. Inspect original state before retrying. The check adds no extra native requests and does not provide durable recovery or certify every mutation path.
Initial Release targeting OASIS API v2.3.1 (Current LIVE REST version):
https://api.oasisplatform.world
Full documentation and source code can be found here:
https://github.com/NextGenSoftwareUK/OASIS
Make sure you check out the Overview and Benefits Of Building On The WEB 4 OASIS API sections above! 😃 Thank you!
Anonymous public Cloud Storage metadata CQL
GoogleCloudPublicMetadataSource is a separate read-only adapter over the existing CQL interfaces. Its public constructor always creates the pinned SDK's anonymous client. It reads object metadata, with SDK retries disabled and no billing-project setting; it never downloads imagery or creates/uploads/deletes cloud objects. Canonical Firestore persistence remains a separate capability.
Configure one to eight distinct printable-ASCII keys (maximum128characters each), a bounded general-purpose bucket name and a stable nonempty source-owner GUID. Retain that GUID with the catalogue: it participates in the deterministic native-to-holon ID. The current native sample uses three official public Landsat objects and needs no Google account, emulator or new runtime.
// Read these values from the retained source configuration.
// Changing sourceOwner would change the mapped holon identities.
using var source = new GoogleCloudPublicMetadataSource(
bucketName,
sourceKeys,
sourceOwner);
var activated = await source.ActivateQuerySourceAsync(cancellationToken);
if (activated.IsError)
throw new InvalidOperationException(activated.Message, activated.Exception);
// Select several native objects by their metadata key.
// Use sourceKeys.Take(2).ToArray() to show the smaller subset.
var selectedKeys = sourceKeys;
var query = CosmicQuery<Holon>
.Create(CosmicQueryScope.Named(ProviderType.GoogleCloudOASIS).Result)
.Where(holon => selectedKeys.Contains(
CosmicQueryMetadata.Value<string>(
holon,
GoogleCloudPublicMetadataSource.ObjectKeyMetadata)))
.Result;
// The common planner checks the adapter's actual capabilities before I/O.
var planned = CosmicQueryPlanner.Plan(
query,
ProviderType.GoogleCloudOASIS,
new[] { new CosmicQueryTarget(ProviderType.GoogleCloudOASIS, source.QueryCapabilities) });
if (planned.IsError)
throw new InvalidOperationException(planned.Message);
var rows = await source.ExecuteCosmicQueryAsync(
planned.Result,
cancellationToken: cancellationToken);
if (rows.IsError)
throw new InvalidOperationException(rows.Message, rows.Exception);
Supported source filters are GCSObjectKey equality and bounded membership; paging follows complete selection validation. General Name/Description filters, ordering, aggregate or arbitrary bucket-scan queries are rejected at planning. Output includes name/description and native bucket/key/ETag/generation/size/checksum metadata. Size, generation and metageneration are decimal strings to preserve native integer precision in WEB4/JavaScript. A failed/invalid selected response publishes no partial page.
Verification on31October2026:17controlled cases and1real anonymous SDK/CQL case (three records/two-record subset), no skips. WEB4 task code now registers this as an isolated optional read source via CQL_GCS_PUBLIC_SOURCE_JSON; independent query-only permission/tariff and host read policy are required. The exact JSON schema is schema, bucket, keys, owner with schema1; credentials, billing projects and endpoint overrides are rejected. This is not deployed in the hosted sandbox, and actual Mongo pairing remains unverified. Do not describe it as hosted CQL/Firestore parity. Official public-data access and public datasets.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Google.Api.Gax.Rest (>= 4.9.0)
- Google.Cloud.BigQuery.V2 (>= 3.7.0)
- Google.Cloud.Firestore (>= 3.7.0)
- Google.Cloud.Storage.V1 (>= 4.11.0)
- Microsoft.Extensions.Configuration.Json (>= 5.0.0)
- NextGenSoftware.OASIS.API.Core (>= 2.0.6)
- NextGenSoftware.OASIS.API.DNA (>= 2.0.5)
- NextGenSoftware.OASIS.Common (>= 2.0.5)
- NextGenSoftware.OASIS.Providers.Shared.KeyValueStorage (>= 2.0.1)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on NextGenSoftware.OASIS.API.Providers.GoogleCloudOASIS:
| Package | Downloads |
|---|---|
|
NextGenSoftware.OASIS.OASISBootLoader
The OASIS BootLoader provides a single entry point to initialise the entire OASIS ecosystem in any .NET application. Reads OASISDNA configuration, registers and activates all configured providers, sets up Auto-FailOver/LoadBalancing, and returns a ready-to-use OASIS instance. Integrate 55+ decentralised networks into your app with just a few lines of code. Part of the OASIS Omniverse at https://oasisomniverse.one |
GitHub repositories
This package is not used by any popular GitHub repositories.
NextGenSoftware.OASIS.API.Providers.GoogleCloudOASIS v2.0.5
WEB4 OASIS API GoogleCloudOASIS Provider is one of the many WEB2/WEB3 providers that plug in and integtate into the OASIS.
What's new since v2.0.4
- Add anonymous Google Cloud metadata CQL with native three-record proof (623d6e3)
- Align Firestore ID reads with tombstone visibility contract (aff0616)
- Align Firestore native holon deletion projection with canonical state (3d732c7)
- Align Google detail selectors with canonical case-insensitive identity (079aaaf)
- Bind Firestore acknowledgement counts and reconcile null Oracle writes (cc941f6)
- Classify persisted cloud JSON corruption at shared storage boundary (388ccb4)
- Correct Google activation credentials and resource error handling (3027747)
- Correct Google metadata All and Any collection matching (7b22f3c)
- Correct GoogleCloud returned read counts with retained Firestore proof (8ff89e4)
- Delete Google avatar and detail together in native transaction (924754e)
- Distinguish inactive Firestore avatars from committed tombstones (1ffe111)
- Enable native-verified Firestore historical data queries (3a184cc)
- Enroll isolated Google CQL read profiles with explicit permission and pricing (06e7aec)
- feat(firestore): atomically commit conditional graphs and durable operation receipts (823aada)
- feat(firestore): export all validated stored record versions (76ff67f)
- feat(firestore): retain protected write preparations with native operation fencing (7609a16)
- Fence uncertain Google detail write attempts from V2 replay (85ff037)
- Fix Firestore deleted avatar detail visibility with native verification (a4bfe85)
- Fix Firestore root visibility for inactive records and tombstones (dce8eb2)
- Fix Google holon provider-key reads to use stored document identity (6098054)
- Fix Google nearby partial-coordinate integrity and type validation (93bb628)
- fix: expose cloud capabilities for Cosmos Firestore and BigQuery (82d92cc)
- fix(cloud): implement Azure and Firestore avatar token lookups (10b69b2)
- fix(cloud): reject ambiguous Azure and Firestore wallet keys (143193d)
- fix(firestore): publish committed provider revisions after ordinary batch saves (8fbbd08)
- fix(firestore): remove invented aggregate request padding (a2cf885)
- fix(firestore): retain planned roles in conditional history writer (b4cf93e)
- fix(firestore): validate scalar document size before native writes (e9f1a60)
- fix(google): acknowledge paired lifecycle writes through one transaction owner (59022ae)
- fix(google): canonicalize trusted inputs and persist detail provider keys (994f08c)
- fix(google): decouple export root versions from avatar history (453d0e5)
- fix(google): enforce depth limits from parent-query selection (8396657)
- fix(google): guard related identity lifecycle in single-attempt transactions (573427a)
- fix(google): own canonical search scope before Firestore reads (992b913)
- fix(google): prevent tombstone resurrection in canonical saves (3582b8c)
- fix(google): prune foreign descendants from scoped graph reads (56745c8)
- fix(google): reject disabled-service activation and verify boot configuration (076fb68)
- fix(google): reject invalid holon types before storage access (d2d055d)
- fix(google): reject misleading credential-based storage overloads (a957bae)
- fix(google): report conditional entity acknowledgements and lifecycle conflicts (3d41215)
- fix(google): require authoritative Firestore save timestamps (2fd3938)
- fix(google): select avatar export roots by creator (65c25c5)
- fix(google): validate collection identity before historical selection (b3c6b3c)
- fix(google): validate native holon delete acknowledgements (dfcf119)
- fix(providers): reuse exact JSON objects in DynamoDB and Firestore history (d1e1459)
- fix(providers): share validated conditional acknowledgement assembly (b88181d)
- fix(storage): scope historical embedded graph exports by owner (0422e00)
- Guard acknowledged Google and AWS record publication with shared identity checks (b37ad59)
- Honor Google holon collection filters and graph options (4ae298a)
- Honor Google single holon child graph read options (3ed265e)
Full changelog
https://github.com/NextGenSoftwareUK/OASIS/commits/master/Providers/Cloud/NextGenSoftware.OASIS.API.Providers.GoogleCloudOASIS