Skip to main content

PlayerCodeVersion

An immutable published version of a code listing. Snapshots ARTIFACT HASHES from the author’s compiled module versions — never source (OQ-1). A version with both server and client hashes is a bundle: installing it on a grid also attaches the client half for visitor consent (D2).

type PlayerCodeVersion {
  versionId: String!
  listingId: String!
  appId: BigInt!
  versionNo: Int!
  serverArtifactHashes: [String!]!
  clientArtifactHashes: [String!]!
  capabilitySummaryJson: String!
  capabilityHash: String!
  openSource: Boolean!
  licenseText: String
  createdAt: DateTime!
}

Fields​

PlayerCodeVersion.versionId ● String! non-null scalar​

UUID of this published version.

PlayerCodeVersion.listingId ● String! non-null scalar​

UUID of the listing this version belongs to.

PlayerCodeVersion.appId ● BigInt! non-null scalar​

Numeric app id (denormalized from the listing).

PlayerCodeVersion.versionNo ● Int! non-null scalar​

Monotonic version number within the listing.

PlayerCodeVersion.serverArtifactHashes ● [String!]! non-null scalar​

Artifact hashes of the server-target modules in this version (empty for client-only listings).

PlayerCodeVersion.clientArtifactHashes ● [String!]! non-null scalar​

Artifact hashes of the client-target modules in this version (empty for server-only listings).

PlayerCodeVersion.capabilitySummaryJson ● String! non-null scalar​

JSON capability summary DERIVED from the artifacts by the compile pipeline (imported host families, invoke contracts, presentation hooks, egress budgets). Never self-declared; this is what installers consent to.

PlayerCodeVersion.capabilityHash ● String! non-null scalar​

sha256 of the canonical capability summary. Installs record the hash they consented to; a widened summary on a newer version forces re-consent.

PlayerCodeVersion.openSource ● Boolean! non-null scalar​

Whether this version’s source is open. Open-sourcing a version is irreversible for that version; later versions may return to closed.

PlayerCodeVersion.licenseText ● String scalar​

Author license terms shown at acquisition (platform enforces access, not downstream legal terms).

PlayerCodeVersion.createdAt ● DateTime! non-null scalar​

When the version was published.

Returned By​

appPlayerCodeListingVersions query