Skip to content
Project referenceDevelopmentEngine ccf7d03f
Authored
  • Logical asset identities, runtime lookup, residency and retained artifact reads.

Inno.Assets separates an asset’s identity and canonical object from its loaded resources and immutable artifact bytes. Runtime consumers use logical paths or persistent IDs; they do not need an authoring cache’s physical directory.

Start with loading and retaining assets or reading retained artifact bytes. Importing and source mutation belong to Inno.Assets.Pipeline.

AssetDatabase borrows its content store. It loads deployed content but does not run importers, create authoring directories or own the store’s final disposal. The host retires asset services before releasing that store.

A lookup returns the current canonical asset. AssetLease<TAsset> expresses explicit residency retention; retaining a managed object reference is not a replacement for the owner’s loading, dependency and release protocol. Residency coordinates preparation, dependency retention, preload budgets, cancellation and retirement. RetentionScope groups retention owned by one caller.

RetirementPendingException preserves an unfinished value and its cleanup callback for the owning lifecycle to advance. A terminal release failure is not permission to invoke the same destructive release repeatedly. Do not discard an owner because its first disposal attempt could not finish.

Runtime budget-eviction retries preserve the same release state; they must not decrement a lease count twice. Asset and artifact leases retain pending values and callbacks, while a retention scope uses the shared Core lifetime protocol.

Missing assets retain persistent identity, stable type identity, neutral property bytes and dependencies. Recovery participates in the shared generation transaction. Values containing references require the owner’s complete serialization context, not an unrelated global serializer. Reference recovery explains how saved intent survives an unavailable generation.

AssetArtifactInfo contains a content-addressed key, output name, hash and length; it does not expose a physical location. ArtifactLease.OpenRead() obtains a stream with an independent retention pin. Disposing the outer lease does not invalidate an already opened stream; the caller must still close that stream.

Closing a provider prevents new acquisitions. Missing content and corrupt content are different failures, neither represented by an empty successful payload. ArtifactRetention.GetRetainedKeys() is a snapshot for coordinated collection, not proof that no reader can arrive later. Retention counts do not independently authorize physical cache deletion.

Hosts receive explicit IAssetLookup, IAssetResidency and artifact lookup contracts. The script-facing Assets facade resolves services from the active runtime session and owns no second database. Assets.LocalPath uses the scripting compiler’s canonical caller location so source-local paths follow a project into an installed plugin; an arbitrary host filesystem path is not that identity.

The reference describes the CLR surface. Actual script projections are separately selected; do not assume that every host owner or infrastructure type is exported.

Asset types and member contracts cover lookup, paths, leases, residency, neutral state and the built-in text/binary asset values.

The compiler-selected script declarations are separate from this project’s host CLR surface. Read the script calling guide and the associated module contracts before using a projected member.

Project: Inno.Assets
Source: src/content/assets/Inno.Assets/Inno.Assets.csproj

Type API Description
ArtifactLease engine Keeps one verified immutable artifact generation available for an explicit lifetime.
ArtifactRetention engine Counts explicit leases over immutable artifact keys independently of asset object residency.
AssetArtifactInfo engine Describes one named output in an immutable artifact bundle.
AssetArtifactKey engine Identifies one immutable content-addressed artifact bundle.
AssetChange engine Describes one committed asset database change.
AssetChangeKind engine Identifies a committed asset database change.
AssetChangeSet engine Contains one atomically committed asset database revision.
AssetDatabase engine Loads canonical runtime assets exclusively from a verified catalog and content-addressed artifact bundles.

Separates immutable artifact preparation from owner-thread asset materialization.
AssetDependency engine Describes a persistent direct dependency on another asset.
AssetDependencyCollection engine Collects direct asset dependencies encountered by a serialization operation.
AssetExecutionContext engine Binds one host-owned asset lookup to the current asynchronous script execution context.
AssetImportStatus engine Identifies the current source and import state of an asset.
AssetInfo engine Provides an immutable public snapshot of one cataloged asset.
AssetLease<TAsset> engine Keeps one canonical asset generation resident for an explicit lifetime.
AssetObject engine Provides the common runtime identity and payload contract for imported assets.
AssetPath engine Addresses one asset without conflating isolated source mounts.
AssetPreparationStatistics engine Reports owner-thread cold-load admission and unique encoded IO reservations without retaining assets or tasks.
AssetPropertySnapshot engine Contains native properties and automatically captured asset dependencies without retaining their owner or typed object.
AssetReferenceInfo engine Provides a stable diagnostic snapshot of references known to the asset pipeline.
AssetReferenceKind engine Identifies a reference source known to the asset pipeline.
AssetReferenceLocation engine Describes one engine-known reference location for an asset.
AssetReferenceProtocol engine Defines the open cross-domain protocol used to resolve persistent asset identities.
AssetResidencyProvider engine Provides controlled lease construction to concrete asset residency implementations.
AssetResidencyStatistics engine Reports current explicit runtime asset residency accounting.
AssetRuntimeContentInfo engine Describes one deployed runtime-only asset content snapshot.
AssetRuntimeOwner engine Grants one database exclusive mutation authority over the asset instances it initializes.
AssetSerializationContext engine Creates complete asset-aware converter contexts from an owner-provided reference generation.
AssetSourceId engine Identifies one isolated asset source mount.
AssetSourceKind engine Identifies the durable source role recorded by an asset metadata sidecar.
Assets engine Provides script-facing asset queries through the lookup bound to the current runtime session.
BinaryAsset engine Describes an imported opaque binary payload.
IAssetArtifactLookup engine Resolves verified named outputs from immutable asset artifact bundles.
IAssetLookup engine Defines the read-only asset lookup boundary shared by authoring and deployed runtime databases.
IAssetPropertyStateResolver engine Restores nested neutral asset properties with the owning database’s converter generation and references.
IAssetReferenceResolver engine Resolves persistent asset references against one isolated asset database generation.
IAssetResidency engine Exposes explicit asynchronous asset and artifact residency ownership.
RetentionScope engine Owns multiple asset, artifact, or subsystem leases as one reverse-order lifetime.
TextAsset engine Stores decoded text content and its language hint.
ArtifactLease Runtime Keeps one verified immutable artifact generation available for an explicit lifetime.
AssetArtifactInfo Runtime Describes one named output in an immutable artifact bundle.
AssetArtifactKey Runtime Identifies one immutable content-addressed artifact bundle.
AssetChange Runtime Describes one committed asset database change.
AssetChangeKind Runtime Identifies a committed asset database change.
AssetChangeSet Runtime Contains one atomically committed asset database revision.
AssetDependency Runtime Describes a persistent direct dependency on another asset.
AssetImportStatus Runtime Identifies the current source and import state of an asset.
AssetInfo Runtime Provides an immutable public snapshot of one cataloged asset.
AssetLease<TAsset> Runtime Keeps one canonical asset generation resident for an explicit lifetime.
AssetObject Runtime Provides the common runtime identity and payload contract for imported assets.
AssetPath Runtime Addresses one asset without conflating isolated source mounts.
AssetPropertySnapshot Runtime Contains native properties and automatically captured asset dependencies without retaining their owner or typed object.
AssetReferenceInfo Runtime Provides a stable diagnostic snapshot of references known to the asset pipeline.
AssetReferenceKind Runtime Identifies a reference source known to the asset pipeline.
AssetReferenceLocation Runtime Describes one engine-known reference location for an asset.
AssetResidencyStatistics Runtime Reports current explicit runtime asset residency accounting.
AssetSourceId Runtime Identifies one isolated asset source mount.
AssetSourceKind Runtime Identifies the durable source role recorded by an asset metadata sidecar.
Assets Runtime Provides script-facing asset queries through the lookup bound to the current runtime session.
BinaryAsset Runtime Describes an imported opaque binary payload.
RetentionScope Runtime Owns multiple asset, artifact, or subsystem leases as one reverse-order lifetime.
TextAsset Runtime Stores decoded text content and its language hint.