Metadata Persistence

Metadata Scope Enum

Defines the lifecycle and mutability of a metadata item.

Source: packages/spec/src/system/metadata-persistence.zod.ts

TypeScript Usage

import { MetadataCollectionInfo, MetadataExportOptions, MetadataFallbackStrategy, MetadataFormat, MetadataImportOptions, MetadataLoadOptions, MetadataLoadResult, MetadataLoaderContract, MetadataManagerConfig, MetadataRecord, MetadataSaveOptions, MetadataSaveResult, MetadataScope, MetadataSource, MetadataState, MetadataStats, MetadataWatchEvent, PackagePublishResult } from '@objectstack/spec/system';
import type { MetadataCollectionInfo, MetadataExportOptions, MetadataFallbackStrategy, MetadataFormat, MetadataImportOptions, MetadataLoadOptions, MetadataLoadResult, MetadataLoaderContract, MetadataManagerConfig, MetadataRecord, MetadataSaveOptions, MetadataSaveResult, MetadataScope, MetadataSource, MetadataState, MetadataStats, MetadataWatchEvent, PackagePublishResult } from '@objectstack/spec/system';

// Validate data
const result = MetadataCollectionInfo.parse(data);

MetadataCollectionInfo

Properties

Property	Type	Required
type	`string`	✅
count	`number`	✅
namespaces	`string[]`	✅

MetadataExportOptions

Properties

Property	Type	Required	Description
types	`string[]`	optional
namespaces	`string[]`	optional
output	`string`	✅	Output directory or file
format	`Enum<'json' \| 'yaml' \| 'yml' \| 'ts' \| 'js' \| 'typescript' \| 'javascript'>`	✅

MetadataFallbackStrategy

Allowed Values

filesystem
memory
none

MetadataFormat

Allowed Values

json
yaml
yml
ts
js
typescript
javascript

MetadataImportOptions

Properties

Property	Type	Required	Description
source	`string`	✅	Input directory or file
strategy	`Enum<'merge' \| 'replace' \| 'skip'>`	✅
validate	`boolean`	✅

MetadataLoadOptions

Properties

Property	Type	Required	Description
scope	`Enum<'system' \| 'platform' \| 'user'>`	optional
namespace	`string`	optional
raw	`boolean`	optional	Return raw file content instead of parsed JSON
cache	`boolean`	optional
useCache	`boolean`	optional
validate	`boolean`	optional
ifNoneMatch	`string`	optional
recursive	`boolean`	optional
limit	`number`	optional
patterns	`string[]`	optional
loader	`string`	optional	Specific loader to use (e.g. filesystem, database)

MetadataLoadResult

Properties

Property	Type	Required
data	`any`	✅
stats	`Object`	optional
format	`Enum<'json' \| 'yaml' \| 'yml' \| 'ts' \| 'js' \| 'typescript' \| 'javascript'>`	optional
source	`string`	optional
fromCache	`boolean`	optional
etag	`string`	optional
notModified	`boolean`	optional
loadTime	`number`	optional

MetadataLoaderContract

Properties

Property	Type	Required	Description
name	`string`	✅
protocol	`Enum<'file:' \| 'http:' \| 's3:' \| 'datasource:' \| 'memory:'>`	✅	Loader protocol identifier
description	`string`	optional
supportedFormats	`string[]`	optional
supportsWatch	`boolean`	optional
supportsWrite	`boolean`	optional
supportsCache	`boolean`	optional
capabilities	`Object`	✅

MetadataManagerConfig

Properties

Property	Type	Required	Description
datasource	`string`	optional	Datasource name reference for database persistence
tableName	`string`	✅	Database table name for metadata storage
fallback	`Enum<'filesystem' \| 'memory' \| 'none'>`	✅	Fallback strategy when datasource is unavailable
rootDir	`string`	optional	Root directory for filesystem-based metadata
formats	`Enum<'json' \| 'yaml' \| 'yml' \| 'ts' \| 'js' \| 'typescript' \| 'javascript'>[]`	optional	Enabled metadata formats
watch	`boolean`	optional	Enable file watching for filesystem loaders
cache	`boolean`	optional	Enable metadata caching
watchOptions	`Object`	optional	File watcher options

MetadataRecord

Properties

Property	Type	Required	Description
id	`string`	✅
name	`string`	✅
type	`string`	✅
namespace	`string`	✅
packageId	`string`	optional	Package ID that owns/delivered this metadata
managedBy	`Enum<'package' \| 'platform' \| 'user'>`	optional	Who manages this metadata record lifecycle
scope	`Enum<'system' \| 'platform' \| 'user'>`	✅
metadata	`Record<string, any>`	✅
extends	`string`	optional	Name of the parent metadata to extend/override
strategy	`Enum<'merge' \| 'replace'>`	✅
owner	`string`	optional
state	`Enum<'draft' \| 'active' \| 'archived' \| 'deprecated'>`	✅
tenantId	`string`	optional	Tenant identifier for multi-tenant isolation
version	`number`	✅	Record version for optimistic concurrency control
checksum	`string`	optional	Content checksum for change detection
source	`Enum<'filesystem' \| 'database' \| 'api' \| 'migration'>`	optional	Origin of this metadata record
tags	`string[]`	optional	Classification tags for filtering and grouping
publishedDefinition	`any`	optional	Snapshot of the last published definition
publishedAt	`string`	optional	When this metadata was last published
publishedBy	`string`	optional	Who published this version
createdBy	`string`	optional
createdAt	`string`	optional	Creation timestamp
updatedBy	`string`	optional
updatedAt	`string`	optional	Last update timestamp

MetadataSaveOptions

Properties

Property	Type	Required	Description
format	`Enum<'json' \| 'yaml' \| 'yml' \| 'ts' \| 'js' \| 'typescript' \| 'javascript'>`	optional
create	`boolean`	✅
overwrite	`boolean`	✅
path	`string`	optional
prettify	`boolean`	optional
indent	`number`	optional
sortKeys	`boolean`	optional
backup	`boolean`	optional
atomic	`boolean`	optional
loader	`string`	optional	Specific loader to use (e.g. filesystem, database)

MetadataSaveResult

Properties

Property	Type	Required
success	`boolean`	✅
path	`string`	optional
stats	`Object`	optional
etag	`string`	optional
size	`number`	optional
saveTime	`number`	optional
backupPath	`string`	optional

MetadataScope

Allowed Values

system
platform
user

MetadataSource

Allowed Values

filesystem
database
api
migration

MetadataState

Allowed Values

draft
active
archived
deprecated

MetadataStats

Properties

Property	Type	Required
path	`string`	optional
size	`number`	optional
mtime	`string`	optional
hash	`string`	optional
etag	`string`	optional
modifiedAt	`string`	optional
format	`Enum<'json' \| 'yaml' \| 'yml' \| 'ts' \| 'js' \| 'typescript' \| 'javascript'>`	optional

MetadataWatchEvent

Properties

Property	Type	Required
type	`Enum<'add' \| 'change' \| 'unlink' \| 'added' \| 'changed' \| 'deleted'>`	✅
path	`string`	✅
name	`string`	optional
stats	`Object`	optional
metadataType	`string`	optional
data	`any`	optional
timestamp	`string`	optional

PackagePublishResult

Properties

Property	Type	Required	Description
success	`boolean`	✅	Whether the publish succeeded
packageId	`string`	✅	The package ID that was published
version	`integer`	✅	New version number after publish
publishedAt	`string`	✅	Publish timestamp
itemsPublished	`integer`	✅	Total metadata items published
validationErrors	`Object[]`	optional	Validation errors if publish failed

On this page