@b00dea/cockpit 0.0.0-bootstrap.0 → 0.1.0

package/dist/environment/templates.d.ts

@@ -0,0 +1,140 @@
+import { type EnvironmentFile as EnvironmentFileDeclaration } from '../schema.js';
+import { ENVIRONMENT_CODES, type EnvironmentObservation, type StackId } from './contract.js';
+export declare const observationDeclarations: readonly [{
+    readonly id: 'environment-key-freshness';
+    readonly owner: "environment-template-seeding";
+    readonly postures: readonly ["environment"];
+    readonly stages: readonly [{
+        readonly stage: 'bootstrap';
+        readonly disposition: 'required';
+    }, {
+        readonly stage: 'steady';
+        readonly disposition: 'required';
+    }];
+    readonly code: "ENVIRONMENT_KEYS_STALE";
+    readonly isIssued: typeof isTemplateObservation;
+    readonly issuedAt: typeof observationIssuedAt;
+}, {
+    readonly id: 'secret-file-presence';
+    readonly owner: "environment-template-seeding";
+    readonly postures: readonly ["environment"];
+    readonly stages: readonly [{
+        readonly stage: 'bootstrap';
+        readonly disposition: 'required';
+    }, {
+        readonly stage: 'steady';
+        readonly disposition: 'required';
+    }];
+    readonly code: "ENVIRONMENT_FILE_NOT_FOUND";
+    readonly isIssued: typeof isTemplateObservation;
+    readonly issuedAt: typeof observationIssuedAt;
+}, {
+    readonly id: 'sibling-presence';
+    readonly owner: "environment-template-seeding";
+    readonly postures: readonly ["environment"];
+    readonly stages: readonly [{
+        readonly stage: 'bootstrap';
+        readonly disposition: 'required';
+    }, {
+        readonly stage: 'steady';
+        readonly disposition: 'required';
+    }];
+    readonly code: "SIBLING_MISSING";
+    readonly isIssued: typeof isTemplateObservation;
+    readonly issuedAt: typeof observationIssuedAt;
+}];
+declare function isTemplateObservation(value: unknown): value is EnvironmentObservation;
+declare function observationIssuedAt(value: unknown): number | undefined;
+export declare function observeSiblingPresence(input: {
+    readonly stackId: StackId;
+    readonly observedAt: string;
+    readonly siblingRoot: string;
+    readonly sibling: unknown;
+}): Promise<EnvironmentObservation>;
+type EnvironmentFileSide = 'template' | 'instance';
+type InspectionCode = typeof ENVIRONMENT_CODES.ENVIRONMENT_FILE_NOT_FOUND | typeof ENVIRONMENT_CODES.ENVIRONMENT_FILE_UNREADABLE | typeof ENVIRONMENT_CODES.ENVIRONMENT_FILE_TOO_LARGE | typeof ENVIRONMENT_CODES.ENVIRONMENT_FILE_MALFORMED | typeof ENVIRONMENT_CODES.TEMPLATE_PATH_OUTSIDE_ROOT;
+export type EnvironmentKeyInspection = {
+    kind: 'fresh' | 'stale' | 'absent';
+    templatePath: string;
+    instancePath: string;
+    requiredKeys: readonly string[];
+    presentKeys: readonly string[];
+    missingKeys: readonly string[];
+    unexpectedKeys: readonly string[];
+} | {
+    kind: 'unreadable';
+    file: EnvironmentFileSide;
+    path: string;
+    code: Exclude<InspectionCode, typeof ENVIRONMENT_CODES.ENVIRONMENT_FILE_MALFORMED>;
+} | {
+    kind: 'malformed';
+    file: EnvironmentFileSide;
+    path: string;
+    line: number;
+    code: typeof ENVIRONMENT_CODES.ENVIRONMENT_FILE_MALFORMED;
+};
+export declare function inspectEnvironmentKeys(input: {
+    siblingRoot: string;
+    templatePath: string;
+    instancePath: string;
+    maxBytes?: number;
+}): Promise<EnvironmentKeyInspection>;
+export declare function observeEnvironmentKeys(input: {
+    readonly stackId: StackId;
+    readonly observedAt: string;
+    readonly siblingRoot: string;
+    readonly declaration: unknown;
+}): Promise<readonly EnvironmentObservation[]>;
+/** Health admits one row per code; aggregate here so every declaration retains owner-issued evidence. */
+export declare function observeTemplateHealth(input: {
+    readonly stackId: StackId;
+    readonly observedAt: string;
+    readonly siblingRoot: string;
+    readonly siblings: readonly unknown[];
+}): Promise<readonly EnvironmentObservation[]>;
+interface FileIdentity {
+    dev: string;
+    ino: string;
+    mode: string;
+    size: string;
+    mtimeNs: string;
+    ctimeNs: string;
+}
+export type EnvironmentSeedPlan = {
+    kind: 'none';
+} | {
+    kind: 'unchanged';
+    siblingRoot: string;
+    destination: string;
+} | {
+    kind: 'refusal';
+    code: SeedRefusalCode;
+    path: string;
+} | {
+    kind: 'ready';
+    siblingRoot: string;
+    canonicalRoot: string;
+    source: string;
+    destination: string;
+    rootIdentity: FileIdentity;
+    sourceIdentity: FileIdentity;
+    destinationParentIdentity: FileIdentity;
+};
+type SeedRefusalCode = typeof ENVIRONMENT_CODES.TEMPLATE_NOT_FOUND | typeof ENVIRONMENT_CODES.TEMPLATE_NOT_TRACKED | typeof ENVIRONMENT_CODES.TEMPLATE_IGNORED | typeof ENVIRONMENT_CODES.TEMPLATE_PATH_OUTSIDE_ROOT | typeof ENVIRONMENT_CODES.INSTANCE_NOT_IGNORED | typeof ENVIRONMENT_CODES.ENVIRONMENT_SEED_PRECONDITION_CHANGED | typeof ENVIRONMENT_CODES.ENVIRONMENT_SEED_FAILED;
+export type EnvironmentSeedResult = {
+    kind: 'none';
+} | {
+    kind: 'created' | 'unchanged';
+    siblingRoot: string;
+    destination: string;
+} | {
+    kind: 'refusal';
+    code: SeedRefusalCode;
+    path: string;
+};
+export declare function planEnvironmentSeed(input: {
+    siblingRoot: string;
+    environmentFile?: EnvironmentFileDeclaration;
+}): Promise<EnvironmentSeedPlan>;
+export declare function seedEnvironmentInstanceSync(plan: EnvironmentSeedPlan): EnvironmentSeedResult;
+export {};