@decantr/content 3.8.0

package/dist/index.d.ts

@@ -0,0 +1,178 @@
+declare const CONTENT_TYPES: readonly ["pattern", "theme", "blueprint", "archetype", "shell"];
+type ContentType = (typeof CONTENT_TYPES)[number];
+declare const API_CONTENT_TYPES: readonly ["patterns", "themes", "blueprints", "archetypes", "shells"];
+type ApiContentType = (typeof API_CONTENT_TYPES)[number];
+declare const CONTENT_TYPE_TO_API_CONTENT_TYPE: Record<ContentType, ApiContentType>;
+declare const API_CONTENT_TYPE_TO_CONTENT_TYPE: Record<ApiContentType, ContentType>;
+declare const CONTENT_TYPE_TO_DIRECTORY: Record<ContentType, ApiContentType>;
+declare const CONTENT_SCHEMA_FILES: Record<ContentType | 'common', string>;
+declare const OFFICIAL_CONTENT_NAMESPACE = "@official";
+declare const OFFICIAL_CONTENT_OWNER_NAME = "Decantr";
+declare const OFFICIAL_CONTENT_OWNER_USERNAME = "decantr";
+declare const OFFICIAL_CONTENT_PUBLISHED_AT = "2026-07-02T00:00:00.000Z";
+declare const PUBLIC_BLUEPRINT_SETS: readonly ["all", "featured", "certified", "labs"];
+type PublicBlueprintSet = (typeof PUBLIC_BLUEPRINT_SETS)[number];
+declare const PUBLIC_CONTENT_SOURCES: readonly ["official", "community", "organization"];
+type PublicContentSource = (typeof PUBLIC_CONTENT_SOURCES)[number];
+declare const CONTENT_INTELLIGENCE_SOURCES: readonly ["authored", "benchmark", "hybrid"];
+type ContentIntelligenceSource = (typeof CONTENT_INTELLIGENCE_SOURCES)[number];
+type PublicContentSort = 'recommended' | 'recent' | 'name';
+type JsonObject = Record<string, unknown>;
+interface BlueprintPortfolioArtifact {
+    status: 'none' | 'planned' | 'candidate' | 'certified';
+    showcase?: string;
+    notes?: string;
+}
+interface BlueprintPortfolioMetadata {
+    visibility: 'featured' | 'public' | 'labs' | 'hidden';
+    maturity: 'certified-flagship' | 'supported-contract' | 'experimental' | 'fold-candidate' | 'legacy-hidden';
+    rationale: string;
+    recommended_alternative?: string;
+    artifact: BlueprintPortfolioArtifact;
+}
+interface ContentIntelligenceMetadata {
+    source: ContentIntelligenceSource;
+    verification_status: 'unknown' | 'pending' | 'build-green' | 'build-red' | 'smoke-green' | 'smoke-red';
+    last_verified_at?: string | null;
+    target_coverage: string[];
+    benchmark_confidence: 'none' | 'low' | 'medium' | 'high';
+    confidence_tier: 'low' | 'medium' | 'high' | 'verified';
+    golden_usage: 'none' | 'showcase' | 'shortlisted';
+    quality_score: number | null;
+    confidence_score: number | null;
+    recommended: boolean;
+    evidence: string[];
+    recommendation_reasons: string[];
+    recommendation_blockers: string[];
+}
+interface PublicContentSummary {
+    id: string;
+    slug: string;
+    namespace: string;
+    type: ContentType;
+    version?: string;
+    name?: string;
+    description?: string;
+    published_at?: string;
+    owner_name?: string | null;
+    owner_username?: string | null;
+    thumbnail_url?: string | null;
+    blueprint_portfolio?: BlueprintPortfolioMetadata | null;
+    intelligence?: ContentIntelligenceMetadata | null;
+}
+interface PublicContentRecord<TData extends JsonObject = JsonObject> {
+    id: string;
+    slug: string;
+    namespace: string;
+    type: ContentType;
+    version: string;
+    data: TData;
+    visibility: 'public';
+    status: 'published';
+    created_at: string;
+    updated_at: string;
+    published_at: string;
+    owner_name: string;
+    owner_username: string;
+    thumbnail_url: string | null;
+    intelligence?: ContentIntelligenceMetadata | null;
+}
+interface ContentListResponse<T = PublicContentSummary> {
+    items: T[];
+    total: number;
+    limit?: number;
+    offset?: number;
+}
+interface SearchResponse {
+    results: PublicContentSummary[];
+    total: number;
+    limit?: number;
+    offset?: number;
+}
+interface SearchContentOptions {
+    q?: string;
+    type?: ContentType | ApiContentType;
+    namespace?: string | null;
+    source?: PublicContentSource;
+    sort?: string | null;
+    recommended?: boolean;
+    intelligenceSource?: ContentIntelligenceSource;
+    blueprintSet?: PublicBlueprintSet;
+    labs?: boolean;
+    limit?: number;
+    offset?: number;
+}
+interface ListContentOptions {
+    type?: ContentType | ApiContentType;
+    namespace?: string | null;
+    source?: PublicContentSource;
+    sort?: string | null;
+    recommended?: boolean;
+    intelligenceSource?: ContentIntelligenceSource;
+    blueprintSet?: PublicBlueprintSet;
+    labs?: boolean;
+    limit?: number;
+    offset?: number;
+}
+interface ResolvedContent<TData extends JsonObject = JsonObject> {
+    item: TData;
+    source: 'core' | 'local';
+    path: string;
+}
+interface ContentResolver {
+    resolve<T extends ContentType>(type: T, id: string): Promise<ResolvedContent | null>;
+}
+interface RegistryIntelligenceSummaryBucket {
+    total_public_items: number;
+    with_intelligence: number;
+    recommended: number;
+    authored: number;
+    benchmark: number;
+    hybrid: number;
+    missing_source: number;
+    smoke_green: number;
+    build_green: number;
+    high_confidence: number;
+    verified_confidence: number;
+}
+interface RegistryIntelligenceSummaryResponse {
+    $schema: string;
+    generated_at: string;
+    namespace: string | null;
+    totals: RegistryIntelligenceSummaryBucket;
+    by_type: Record<ContentType, RegistryIntelligenceSummaryBucket>;
+}
+interface ContentValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+declare function getContentPackageRoot(): string;
+declare function isContentType(value: unknown): value is ContentType;
+declare function isApiContentType(value: unknown): value is ApiContentType;
+declare function isPublicBlueprintSet(value: unknown): value is PublicBlueprintSet;
+declare function isPublicContentSource(value: unknown): value is PublicContentSource;
+declare function isContentIntelligenceSource(value: unknown): value is ContentIntelligenceSource;
+declare function normalizeContentType(value: ContentType | ApiContentType): ContentType;
+declare function getContentSchema(type: ContentType | 'common'): JsonObject;
+declare function listContentSchemas(): Array<{
+    type: ContentType | 'common';
+    file: string;
+    schema: JsonObject;
+}>;
+declare function listContentRecords(options?: ListContentOptions): ContentListResponse;
+declare function searchContent(options?: SearchContentOptions): SearchResponse;
+declare function getContentRecord(type: ContentType | ApiContentType, slug: string, namespace?: string): PublicContentRecord | null;
+declare function resolveContent(type: ContentType | ApiContentType, slug: string, namespace?: string): ResolvedContent | null;
+declare function createContentResolver(namespace?: string): ContentResolver;
+declare function buildContentIntelligenceSummary(namespace?: string | null): RegistryIntelligenceSummaryResponse;
+declare function validateContentData(type: ContentType | ApiContentType, data: unknown): ContentValidationResult;
+declare function validateOfficialCorpus(): ContentValidationResult;
+declare function getContentCatalog(): PublicContentRecord[];
+declare function clearContentCatalogCache(): void;
+declare function getBlueprintPortfolioMetadata(value: unknown): BlueprintPortfolioMetadata | null;
+declare function deriveContentIntelligence(type: ContentType, data: JsonObject): ContentIntelligenceMetadata | null;
+declare function sortPublicContent<T extends PublicContentSummary>(items: T[], sort?: PublicContentSort): T[];
+declare function comparePublicContent(left: PublicContentSummary, right: PublicContentSummary, sort?: PublicContentSort): number;
+declare function normalizePublicContentSort(value: string | null | undefined): PublicContentSort;
+
+export { API_CONTENT_TYPES, API_CONTENT_TYPE_TO_CONTENT_TYPE, type ApiContentType, type BlueprintPortfolioArtifact, type BlueprintPortfolioMetadata, CONTENT_INTELLIGENCE_SOURCES, CONTENT_SCHEMA_FILES, CONTENT_TYPES, CONTENT_TYPE_TO_API_CONTENT_TYPE, CONTENT_TYPE_TO_DIRECTORY, type ContentIntelligenceMetadata, type ContentIntelligenceSource, type ContentListResponse, type ContentResolver, type ContentType, type ContentValidationResult, type JsonObject, type ListContentOptions, OFFICIAL_CONTENT_NAMESPACE, OFFICIAL_CONTENT_OWNER_NAME, OFFICIAL_CONTENT_OWNER_USERNAME, OFFICIAL_CONTENT_PUBLISHED_AT, PUBLIC_BLUEPRINT_SETS, PUBLIC_CONTENT_SOURCES, type PublicBlueprintSet, type PublicContentRecord, type PublicContentSort, type PublicContentSource, type PublicContentSummary, type RegistryIntelligenceSummaryBucket, type RegistryIntelligenceSummaryResponse, type ResolvedContent, type SearchContentOptions, type SearchResponse, buildContentIntelligenceSummary, clearContentCatalogCache, comparePublicContent, createContentResolver, deriveContentIntelligence, getBlueprintPortfolioMetadata, getContentCatalog, getContentPackageRoot, getContentRecord, getContentSchema, isApiContentType, isContentIntelligenceSource, isContentType, isPublicBlueprintSet, isPublicContentSource, listContentRecords, listContentSchemas, normalizeContentType, normalizePublicContentSort, resolveContent, searchContent, sortPublicContent, validateContentData, validateOfficialCorpus };