@lesliechan721/aw 0.1.0-beta.5 → 0.1.0-beta.50

package/dist/src/utils/catalog-generation-service.d.ts

@@ -0,0 +1,172 @@
+import type { CatalogActivationMode, CatalogGenerationActiveV1, CatalogGenerationCandidateComparison, CatalogGenerationCandidateEvidence, CatalogGenerationLastSyncV1, CatalogGenerationSyncResult, CatalogManifestV7, CatalogSource } from '../types.js';
+import { type CatalogStoreEntry } from './catalog-generation-store.js';
+export { removeCatalogSourceGenerationState } from './catalog-generation-state.js';
+import { catalogGitProviderInternal } from './git-catalog-provider.js';
+import { catalogPathProviderInternal } from './path-catalog-provider.js';
+import { type CatalogCapabilityCompatibility } from './catalog-capability-projection.js';
+import { inspectCatalogSourceImpact } from './catalog-source-impact.js';
+export interface CatalogGenerationProviderSet {
+    git: typeof catalogGitProviderInternal.resolve;
+    path: typeof catalogPathProviderInternal.resolve;
+}
+export interface CatalogGenerationServiceRuntime {
+    providers?: CatalogGenerationProviderSet;
+    probeGitRef?: typeof catalogGitProviderInternal.probeRef;
+    now?: () => Date;
+    validatedStoreEntries?: Map<string, CatalogStoreEntry>;
+    validatingStoreEntries?: Map<string, Promise<CatalogStoreEntry>>;
+    afterCandidateResolved?: () => Promise<void>;
+    afterRecoveryStorePublished?: () => Promise<void>;
+    afterInactiveStoreRepairPrepared?: () => Promise<void>;
+    inspectSourceImpact?: typeof inspectCatalogSourceImpact;
+}
+export interface CatalogGenerationProbeResult {
+    sourceId: string;
+    candidate: CatalogGenerationCandidateEvidence;
+    manifest: CatalogManifestV7;
+}
+export type CatalogGenerationFreshnessState = 'current' | 'updateAvailable' | 'localChangesAvailable' | 'versionConflict' | 'rollbackDetected' | 'incompatible' | 'fixed';
+export interface CatalogGenerationFreshnessResult {
+    sourceId: string;
+    state: CatalogGenerationFreshnessState;
+    activeVersion?: string;
+    activeResolvedCommit?: string;
+    candidate?: CatalogGenerationCandidateEvidence;
+    errorCode?: 'catalogLogicalIdentityChanged';
+    reusableCandidate?: CatalogGenerationReusableCandidate;
+}
+export interface CatalogGenerationReusableCandidate {
+    probe: CatalogGenerationProbeResult;
+    sourceConfigFingerprint: string;
+    activeStoreKey: string | null;
+}
+export interface CatalogGenerationStatusEntry {
+    sourceId: string;
+    configuredSourceIdentity: string;
+    active?: CatalogGenerationActiveV1;
+    activeReady: boolean;
+    configMatchesActive: boolean;
+    catalogVersion?: string;
+    channel?: 'latest' | 'beta';
+    storeKey?: string;
+    lastSync?: CatalogGenerationLastSyncV1;
+    compatibility: CatalogCapabilityCompatibility | null;
+    errorCode?: string;
+}
+export interface CatalogGenerationStatusPayload {
+    catalogGenerationStatusSchemaVersion: 2;
+    sources: CatalogGenerationStatusEntry[];
+}
+export declare function compareCatalogGenerationCandidates(expected: CatalogGenerationCandidateEvidence, actual: CatalogGenerationCandidateEvidence): CatalogGenerationCandidateComparison;
+export declare function compareCatalogGenerationFreshness(options: {
+    sourceType: CatalogSource['type'];
+    active?: {
+        logicalIdentity: string;
+        catalogVersion: string;
+        snapshotDigest: string;
+        resolvedCommit: string;
+    };
+    candidate: CatalogGenerationCandidateEvidence;
+}): Omit<CatalogGenerationFreshnessResult, 'sourceId'>;
+export declare function probeCatalogSourceGeneration(options: {
+    sourceId: string;
+    source?: CatalogSource;
+    cliVersion: string;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+}): Promise<CatalogGenerationProbeResult>;
+export declare function probeCatalogSourceRepairGeneration(options: {
+    sourceId: string;
+    cliVersion: string;
+    expectedActive?: CatalogGenerationActiveV1;
+    expectedConfigDigest?: string;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+}): Promise<CatalogGenerationProbeResult>;
+export declare function probeCatalogSourceFreshness(options: {
+    sourceId: string;
+    cliVersion: string;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    fullValidation?: boolean;
+    runtime?: CatalogGenerationServiceRuntime;
+}): Promise<CatalogGenerationFreshnessResult>;
+export declare function recordCatalogGenerationCheck(options: {
+    probe: CatalogGenerationProbeResult;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+}): Promise<CatalogGenerationSyncResult>;
+export declare function activateCatalogSourceGeneration(options: {
+    sourceId: string;
+    cliVersion: string;
+    cwd?: string;
+    activationMode?: CatalogActivationMode;
+    impactConfirmed?: boolean;
+    impactMode?: 'generation' | 'identityChange';
+    expectedImpactDigest?: string;
+    expectedCandidate?: CatalogGenerationCandidateEvidence;
+    expectedActive?: CatalogGenerationActiveV1 | null;
+    expectedConfigDigest?: string;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+}): Promise<CatalogGenerationSyncResult>;
+export declare function recoverCatalogGenerationStateAndActivate(options: {
+    sourceId: string;
+    cliVersion: string;
+    cwd?: string;
+    impactConfirmed?: boolean;
+    expectedImpactDigest?: string;
+    expectedCandidate: CatalogGenerationCandidateEvidence;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+}): Promise<CatalogGenerationSyncResult>;
+export declare function repairCatalogSourceGeneration(options: {
+    sourceId: string;
+    cliVersion: string;
+    cwd?: string;
+    expectedCandidate?: CatalogGenerationCandidateEvidence;
+    expectedActive?: CatalogGenerationActiveV1 | null;
+    expectedConfigDigest?: string;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+}): Promise<CatalogGenerationSyncResult>;
+export declare function replaceDamagedCatalogSourceGeneration(options: {
+    sourceId: string;
+    cliVersion: string;
+    cwd?: string;
+    expectedCandidate?: CatalogGenerationCandidateEvidence;
+    expectedActive: CatalogGenerationActiveV1;
+    expectedConfigDigest: string;
+    impactConfirmed?: boolean;
+    expectedImpactDigest?: string;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+}): Promise<CatalogGenerationSyncResult>;
+export declare function syncCatalogSourceGeneration(options: {
+    sourceId: string;
+    cliVersion: string;
+    cwd?: string;
+    check?: boolean;
+    impactConfirmed?: boolean;
+    replaceDamaged?: boolean;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+    expectedCandidate?: CatalogGenerationCandidateEvidence;
+    expectedActive?: CatalogGenerationActiveV1 | null;
+    expectedConfigDigest?: string;
+    expectedImpactDigest?: string;
+}): Promise<CatalogGenerationSyncResult>;
+export declare function readCatalogGenerationStatus(options?: {
+    sourceId?: string;
+    env?: NodeJS.ProcessEnv;
+    validatedStoreEntries?: Map<string, CatalogStoreEntry>;
+    validatingStoreEntries?: Map<string, Promise<CatalogStoreEntry>>;
+}): Promise<CatalogGenerationStatusPayload>;