@decantr/registry 1.0.0-beta.8 → 1.0.0

package/README.md

@@ -0,0 +1,56 @@
+# @decantr/registry
+
+Support status: `core-supported`  
+Release channel: `stable`
+
+Registry contracts, schemas, API client, ranking helpers, and content utilities for Decantr.
+
+## Install
+
+```bash
+npm install @decantr/registry
+```
+
+## What It Exports
+
+- strong types for patterns, themes, blueprints, archetypes, shells, and intelligence metadata
+- `RegistryAPIClient` for server-side and tool-side registry access
+- `@decantr/registry/client` for web-safe API usage
+- public schema exports for registry content and summary responses
+- ranking and sorting helpers for public registry content
+
+## Example
+
+Node/runtime usage:
+
+```ts
+import { RegistryAPIClient } from '@decantr/registry';
+
+const client = new RegistryAPIClient({ baseUrl: 'https://api.decantr.ai/v1' });
+const results = await client.search({ query: 'dashboard', type: 'blueprint' });
+```
+
+Browser-safe usage:
+
+```ts
+import { createRegistryClient } from '@decantr/registry/client';
+
+const client = createRegistryClient({ baseUrl: 'https://api.decantr.ai/v1' });
+const summary = await client.getIntelligenceSummary();
+```
+
+## Related Schemas
+
+This package owns the canonical registry schemas published under `@decantr/registry/schema/*`.
+
+## Compatibility
+
+`@decantr/registry` is part of the stable public Decantr package surface in the `1.x` line.
+
+- exported schema paths and documented client entrypoints are expected to remain stable across `1.x`
+- additive response fields may be introduced without breaking the stable contract
+- breaking client, schema, or path changes require a major version
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,115 @@
+import { e as ApiContentType, ak as SearchParams, x as ContentListResponse, aa as PublicContentRecord, P as Pattern, A as Archetype, T as Theme, B as Blueprint, S as Shell, al as SearchResponse, ad as PublicUserProfile, ac as PublicContentSummary, ax as UserProfile, ae as PublishPayload, af as PublishResponse, Y as OwnedContentSummary, ao as ShowcaseManifestResponse, aq as ShowcaseShortlistResponse, ap as ShowcaseShortlistReport, ah as RegistryIntelligenceSummaryResponse, F as ExecutionPackBundleResponse, aF as HostedSelectedExecutionPackRequest, aG as SelectedExecutionPackResponse, H as ExecutionPackManifest, Q as HostedFileCritiqueRequest, N as FileCritiqueReport, U as HostedProjectAuditRequest, a7 as ProjectAuditReport } from './content-types-BJFuxWNj.js';
+export { c as API_CONTENT_TYPES, d as API_CONTENT_TYPE_TO_CONTENT_TYPE, n as CONTENT_INTELLIGENCE_SOURCES, o as CONTENT_TYPES, p as CONTENT_TYPE_TO_API_CONTENT_TYPE, r as ContentBenchmarkConfidence, t as ContentGoldenUsage, u as ContentIntelligenceMetadata, v as ContentIntelligenceSource, w as ContentItem, y as ContentVerificationStatus, Z as PUBLIC_CONTENT_SOURCES, ab as PublicContentSource, ag as RegistryIntelligenceSummaryBucket, an as ShowcaseManifestEntry, ar as ShowcaseShortlistSummary, as as ShowcaseVerificationEntry, aB as isApiContentType, aC as isContentIntelligenceSource, aD as isContentType, aE as isPublicContentSource } from './content-types-BJFuxWNj.js';
+import { EssenceFile } from '@decantr/essence-spec';
+
+interface RegistryAPIClientOptions {
+    baseUrl?: string;
+    apiKey?: string;
+    accessToken?: string;
+    timeoutMs?: number;
+    cacheTtlMs?: number;
+}
+declare class RegistryAPIError extends Error {
+    status: number;
+    details?: unknown;
+    constructor(status: number, message: string, details?: unknown);
+}
+declare class RegistryAPIClient {
+    private baseUrl;
+    private apiKey;
+    private accessToken;
+    private timeoutMs;
+    private cacheTtlMs;
+    private cache;
+    constructor(options?: RegistryAPIClientOptions);
+    private buildHeaders;
+    private fetchWithTimeout;
+    private request;
+    private getCached;
+    private setCache;
+    clearCache(): void;
+    checkHealth(): Promise<boolean>;
+    listContent<T = Record<string, unknown>>(type: ApiContentType, params?: {
+        namespace?: string;
+        source?: SearchParams['source'];
+        sort?: string;
+        recommended?: boolean;
+        intelligenceSource?: SearchParams['intelligenceSource'];
+        limit?: number;
+        offset?: number;
+    }): Promise<ContentListResponse<T>>;
+    getContent<T = Record<string, unknown>>(type: ApiContentType, namespace: string, slug: string): Promise<T>;
+    getPublicContentRecord<TData = Record<string, unknown>>(type: ApiContentType, namespace: string, slug: string): Promise<PublicContentRecord<TData>>;
+    getContentRecord<TData = Record<string, unknown>>(type: ApiContentType, namespace: string, slug: string): Promise<PublicContentRecord<TData>>;
+    getPattern(namespace: string, slug: string): Promise<Pattern>;
+    getArchetype(namespace: string, slug: string): Promise<Archetype>;
+    getTheme(namespace: string, slug: string): Promise<Theme>;
+    getBlueprint(namespace: string, slug: string): Promise<Blueprint>;
+    getShell(namespace: string, slug: string): Promise<Shell>;
+    search(params: SearchParams): Promise<SearchResponse>;
+    getPublicUserProfile(username: string): Promise<PublicUserProfile>;
+    getPublicUserContent(username: string, params?: {
+        type?: string;
+        source?: SearchParams['source'];
+        sort?: string;
+        recommended?: boolean;
+        intelligenceSource?: SearchParams['intelligenceSource'];
+        limit?: number;
+        offset?: number;
+    }): Promise<ContentListResponse<PublicContentSummary>>;
+    getProfile(): Promise<UserProfile>;
+    publishContent(payload: PublishPayload): Promise<PublishResponse>;
+    getMyContent(): Promise<ContentListResponse<OwnedContentSummary>>;
+    getAccessiblePrivateContent(params?: {
+        type?: string;
+        scope?: 'all' | 'personal' | 'organization';
+        q?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<ContentListResponse<OwnedContentSummary>>;
+    getSchema(name?: string): Promise<Record<string, unknown>>;
+    getShowcaseManifest(): Promise<ShowcaseManifestResponse>;
+    getShowcaseShortlist(): Promise<ShowcaseShortlistResponse>;
+    getShowcaseShortlistVerification(): Promise<ShowcaseShortlistReport>;
+    getRegistryIntelligenceSummary(params?: {
+        namespace?: string;
+    }): Promise<RegistryIntelligenceSummaryResponse>;
+    compileExecutionPacks(essence: EssenceFile, params?: {
+        namespace?: string;
+    }): Promise<ExecutionPackBundleResponse>;
+    selectExecutionPack(input: HostedSelectedExecutionPackRequest, params?: {
+        namespace?: string;
+    }): Promise<SelectedExecutionPackResponse>;
+    getExecutionPackManifest(essence: EssenceFile, params?: {
+        namespace?: string;
+    }): Promise<ExecutionPackManifest>;
+    critiqueFile(input: HostedFileCritiqueRequest, params?: {
+        namespace?: string;
+    }): Promise<FileCritiqueReport>;
+    auditProject(input: HostedProjectAuditRequest, params?: {
+        namespace?: string;
+    }): Promise<ProjectAuditReport>;
+}
+interface RegistryClientOptions {
+    baseUrl?: string;
+}
+interface SearchResult {
+    id: string;
+    type: string;
+    name: string;
+    description: string;
+    version: string;
+    tags: string[];
+}
+interface RegistryClient {
+    search(query: string, type?: string): Promise<SearchResult[]>;
+    fetch(type: string, id: string, version?: string): Promise<unknown>;
+}
+declare function createRegistryClient(options?: RegistryClientOptions): RegistryClient;
+
+type PublicContentSort = 'recommended' | 'recent' | 'name';
+declare function normalizePublicContentSort(value: string | null | undefined): PublicContentSort;
+declare function comparePublicContent(a: PublicContentSummary, b: PublicContentSummary, sort?: PublicContentSort): number;
+declare function sortPublicContent<T extends PublicContentSummary>(items: T[], sort?: PublicContentSort): T[];
+
+export { ApiContentType, ContentListResponse, OwnedContentSummary, PublicContentRecord, type PublicContentSort, PublicContentSummary, PublicUserProfile, PublishPayload, PublishResponse, RegistryAPIClient, type RegistryAPIClientOptions, RegistryAPIError, type RegistryClient, type RegistryClientOptions, RegistryIntelligenceSummaryResponse, SearchParams, SearchResponse, type SearchResult, ShowcaseManifestResponse, ShowcaseShortlistReport, ShowcaseShortlistResponse, UserProfile, comparePublicContent, createRegistryClient, normalizePublicContentSort, sortPublicContent };