pluginpkg

Aug 17, 2026

Changes in this version

+ const OpaqueSurfaceDocumentSchemaVersion

+ const PackageSignatureAlgorithmEd25519

+ const PackageSignaturePath

+ const PackageSignatureSchemaVersion

+ var ErrAssetStoreClosed = errors.New("package asset store is closed")

+ var ErrInvalidAssetPath = errors.New("package asset path is invalid")

+ var ErrPackageAssetNotFound = errors.New("package asset not found")

+ var ErrPresentationIconUnavailable = errors.New("presentation icon is unavailable")

+ func WritePackage(ctx context.Context, w io.Writer, pkg Package) error

+ type Asset struct

+ Content []byte

+ Entry Entry

+ type AssetStore interface

+ Close func() error

+ DeletePackage func(ctx context.Context, packageHash string) error

+ Durable func() bool

+ PutOwnedPackage func(ctx context.Context, pkg *Package) error

+ ReadAsset func(ctx context.Context, packageHash string, assetPath string) (Asset, error)

+ ReadPackageMetadata func(ctx context.Context, packageHash string) ([]Entry, error)

+ type Entry struct

+ ContentType string

+ Mode string

+ Path string

+ SHA256 string

+ Size int64

+ type FileAssetStore struct

+ func NewFileAssetStore(root string) (*FileAssetStore, error)

+ func (*FileAssetStore) Durable() bool

+ func (s *FileAssetStore) Close() error

+ func (s *FileAssetStore) DeletePackage(_ context.Context, packageHash string) error

+ func (s *FileAssetStore) PutOwnedPackage(ctx context.Context, pkg *Package) error

+ func (s *FileAssetStore) ReadAsset(ctx context.Context, packageHash string, assetPath string) (Asset, error)

+ func (s *FileAssetStore) ReadPackageMetadata(ctx context.Context, packageHash string) ([]Entry, error)

+ type MemoryAssetStore struct

+ func NewMemoryAssetStore() *MemoryAssetStore

+ func (*MemoryAssetStore) Durable() bool

+ func (s *MemoryAssetStore) Close() error

+ func (s *MemoryAssetStore) DeletePackage(_ context.Context, packageHash string) error

+ func (s *MemoryAssetStore) PutOwnedPackage(_ context.Context, pkg *Package) error

+ func (s *MemoryAssetStore) ReadAsset(_ context.Context, packageHash string, assetPath string) (Asset, error)

+ func (s *MemoryAssetStore) ReadPackageMetadata(_ context.Context, packageHash string) ([]Entry, error)

+ type OpaqueSurfaceAsset struct

+ BindingID string

+ ContentType string

+ LogicalIDs []string

+ Path string

+ SHA256 string

+ Size int64

+ type OpaqueSurfaceAssetReader func(assetPath string) (Asset, error)

+ type OpaqueSurfaceDocument struct

+ Assets []OpaqueSurfaceAsset

+ BodyHTML string

+ CriticalBytes int64

+ Direction string

+ EntryPath string

+ EntrySHA256 string

+ Language string

+ SchemaVersion string

+ Styles []OpaqueSurfaceStyle

+ Title string

+ Worker OpaqueSurfaceWorker

+ func BuildOpaqueSurfaceDocument(entryPath string, readAsset OpaqueSurfaceAssetReader) (OpaqueSurfaceDocument, error)

+ type OpaqueSurfaceStyle struct

+ Content string

+ Path string

+ SHA256 string

+ type OpaqueSurfaceWorker struct

+ Content string

+ Path string

+ SHA256 string

+ Type OpaqueSurfaceWorkerType

+ type OpaqueSurfaceWorkerType string

+ const OpaqueSurfaceWorkerClassic

+ type Package struct

+ CanonicalManifest string

+ CanonicalManifestBytes []byte

+ Entries []Entry

+ EntriesHash string

+ Files map[string][]byte

+ Manifest manifest.Manifest

+ ManifestHash string

+ PackageHash string

+ PackageSignature *PackageSignature

+ SignatureFiles map[string][]byte

+ func BuildFromDir(ctx context.Context, srcDir string, w io.Writer, limits ReadLimits) (Package, error)

+ func Read(ctx context.Context, r io.ReaderAt, size int64, limits ReadLimits) (Package, error)

+ func ReadFile(ctx context.Context, filename string, limits ReadLimits) (Package, error)

+ type PackageSignature struct

+ Algorithm string

+ EntriesHash string

+ KeyID string

+ ManifestHash string

+ PackageHash string

+ PluginID string

+ PublisherID string

+ SchemaVersion string

+ Signature string

+ SignedAt string

+ type PresentationIconAsset struct

+ Height int

+ MediaType string

+ Path string

+ SHA256 string

+ Size int64

+ Width int

+ func ReadPresentationIcon(pkg Package) (PresentationIconAsset, []byte, error)

+ type ReadLimits struct

+ func DefaultReadLimits() ReadLimits

+ func (l ReadLimits) WithMaxCompressionRatio(value int64) (ReadLimits, error)

+ func (l ReadLimits) WithMaxEntryBytes(value int64) (ReadLimits, error)

+ func (l ReadLimits) WithMaxFiles(value int) (ReadLimits, error)

+ func (l ReadLimits) WithMaxPathBytes(value int) (ReadLimits, error)

+ func (l ReadLimits) WithMaxUncompressedBytes(value int64) (ReadLimits, error)

+ type ValidationError struct

+ Cause error

+ Code ValidationErrorCode

+ Message string

+ Path string

+ Pointer string

+ Reason string

+ func (e *ValidationError) Details() map[string]any

+ func (e *ValidationError) Error() string

+ func (e *ValidationError) Unwrap() error

+ type ValidationErrorCode string

+ const ValidationCodeManifestInvalid

+ const ValidationCodePackageInvalid

+ const ValidationCodePackagePathForbidden

+ const ValidationCodePackageTooLarge