@superbee/core 0.2.0-pre.30 → 0.2.0-pre.32

package/dist/recipe-set-preflight.d.ts

@@ -0,0 +1,139 @@
+export declare const RECIPE_PREFLIGHT_SCHEMA: "recipe-set-preflight/v1";
+export declare const RECIPE_PREFLIGHT_DIGEST_SCHEME: "fixture-envelope-v1/utf16-code-unit-sorted-keys-and-file-paths/sha256";
+export interface ArtifactFile {
+    path: string;
+    bytes: string;
+    digest: string;
+}
+export interface RecipeArtifact {
+    identity: {
+        publisher: string;
+        recipeId: string;
+        release: string;
+    };
+    files: ArtifactFile[];
+}
+export interface SelectedRecipe {
+    key: string;
+    publisher: string;
+    recipeId: string;
+    release: string;
+    role: 'base' | 'extension';
+    artifactDigest: string;
+    artifact?: RecipeArtifact | null;
+}
+export interface Requirement {
+    id: string;
+    provider: string;
+    kind: string;
+    required: boolean;
+    fields?: string[];
+    links?: {
+        label: string;
+        target: {
+            provider: string;
+            kind: string;
+        };
+    }[];
+    unsupported?: string[];
+    [operator: string]: unknown;
+}
+export interface Consumer {
+    id: string;
+    owner: string;
+    descriptorDigest: string;
+    requirements: Requirement[] | null;
+}
+export interface Endpoint {
+    id: string;
+    consumer: string;
+    requirement: string;
+    placement: 'local' | 'qualified';
+    alias?: string;
+}
+/** Selected-provider evidence, separate from the complete placement collision inventory. */
+export interface Observation {
+    id: string;
+    provider: string;
+    scope: string;
+    bundleId?: string;
+    expectedBundleId?: string;
+    availability: 'available' | 'unavailable' | 'unknown';
+    complete: boolean;
+    observedVersion?: string;
+    definitions: {
+        id: string;
+        bytes: string;
+    }[];
+}
+export interface PlacementInventory {
+    id: string;
+    scope: string;
+    bundleId?: string;
+    expectedBundleId?: string;
+    availability: 'available' | 'unavailable' | 'unknown';
+    complete: boolean;
+    observedVersion?: string;
+    files: {
+        path: string;
+        bytes: string;
+    }[];
+}
+export interface RecipePreflightInput {
+    schema: typeof RECIPE_PREFLIGHT_SCHEMA;
+    selected: SelectedRecipe[];
+    consumers: Consumer[];
+    endpoints: Endpoint[];
+    observations: Observation[];
+    placementInventories?: PlacementInventory[];
+}
+export interface PreflightIssue {
+    level: 'partial' | 'refused';
+    code: string;
+    at: string;
+}
+export interface PreflightResult {
+    schema: 'recipe-set-preflight-result/v1';
+    verdict: 'valid' | 'partial' | 'refused';
+    structuralComplete: boolean;
+    scope: 'declared-structural-input-only';
+    digestScheme: typeof RECIPE_PREFLIGHT_DIGEST_SCHEME;
+    inputs: {
+        selected: {
+            key: string;
+            publisher: string;
+            recipeId: string;
+            release: string;
+            artifactDigest: string;
+        }[];
+        consumers: {
+            id: string;
+            descriptorDigest: string;
+        }[];
+        observations: {
+            id: string;
+            observedVersion?: string;
+        }[];
+        placementInventories: {
+            id: string;
+            observedVersion?: string;
+        }[];
+    };
+    externalConsumers: 'unknown-out-of-scope';
+    issues: PreflightIssue[];
+    parserWarnings: {
+        provider: string;
+        code: string;
+        field?: string;
+    }[];
+}
+/** This envelope identity is separate from Core source/definition digests and Studio packaging. */
+export declare function recipePreflightDigest(value: unknown): string;
+/** Async for a uniform portable consumer contract; performs no IO, writes, or permission checks. */
+export declare function preflightRecipeSet(value: unknown): Promise<PreflightResult>;
+/** Human guidance is separate from deterministic diagnostics, so adapters need not invent it. */
+export declare function explainRecipePreflightIssue(code: string): {
+    message: string;
+    action: string;
+};
+//# sourceMappingURL=recipe-set-preflight.d.ts.map

package/dist/recipe-set-preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-set-preflight.d.ts","sourceRoot":"","sources":["../src/recipe-set-preflight.ts"],"names":[],"mappings":"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"}