@dailephd/my-frontend-observer 0.9.1 → 0.10.0

package/dist/artifacts/visualChangeWorkflowArtifactReader.d.ts

@@ -0,0 +1,9 @@
+import type { VisualChangeWorkflowArtifact } from '../domain/visualChangeWorkflow.js';
+export type ReadVisualChangeWorkflowArtifactResult = {
+    ok: true;
+    artifact: VisualChangeWorkflowArtifact;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function readVisualChangeWorkflowArtifact(manifestPath: string): Promise<ReadVisualChangeWorkflowArtifactResult>;

package/dist/artifacts/visualChangeWorkflowArtifactReader.js

@@ -0,0 +1,47 @@
+import { lstat, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { VISUAL_CHANGE_WORKFLOW_ARTIFACT_KIND, VISUAL_CHANGE_WORKFLOW_SCHEMA_VERSION, isValidVisualChangeWorkflowArtifact } from '../domain/visualChangeWorkflow.js';
+import { computeVisualChangeBindingsSha256, serializeVisualChangeBindings, VISUAL_CHANGE_WORKFLOW_BINDINGS_FILENAME } from './visualChangeWorkflowArtifactWriter.js';
+export async function readVisualChangeWorkflowArtifact(manifestPath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(manifestPath, 'utf8'));
+    }
+    catch (error) {
+        return { ok: false, reason: `failed to read or parse visual-change workflow manifest: ${error instanceof Error ? error.message : String(error)}` };
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return { ok: false, reason: 'visual-change workflow manifest must be an object' };
+    const envelope = parsed;
+    if (envelope.artifactKind !== VISUAL_CHANGE_WORKFLOW_ARTIFACT_KIND)
+        return { ok: false, reason: 'visual-change workflow artifact kind mismatch' };
+    if (envelope.schemaVersion !== VISUAL_CHANGE_WORKFLOW_SCHEMA_VERSION)
+        return { ok: false, reason: `unsupported visual-change workflow schema version "${String(envelope.schemaVersion)}"` };
+    const validation = isValidVisualChangeWorkflowArtifact(parsed);
+    if (!validation.valid)
+        return { ok: false, reason: `visual-change workflow structural validation failed: ${validation.reason}` };
+    const artifact = parsed;
+    if (artifact.scope.entryMode === 'reference') {
+        if (artifact.bindings?.path !== VISUAL_CHANGE_WORKFLOW_BINDINGS_FILENAME)
+            return { ok: false, reason: 'unsupported bindings path' };
+        const bindingsPath = path.join(path.dirname(manifestPath), VISUAL_CHANGE_WORKFLOW_BINDINGS_FILENAME);
+        try {
+            const info = await lstat(bindingsPath);
+            if (!info.isFile())
+                return { ok: false, reason: 'bindings.json is not a regular file' };
+            const bytes = await readFile(bindingsPath);
+            if (computeVisualChangeBindingsSha256(bytes) !== artifact.bindings.sha256)
+                return { ok: false, reason: 'bindings.json digest mismatch' };
+            const declarations = JSON.parse(bytes.toString('utf8'));
+            if (serializeVisualChangeBindings(declarations) !== bytes.toString('utf8'))
+                return { ok: false, reason: 'bindings.json is not canonical' };
+            if (JSON.stringify(declarations) !== JSON.stringify(artifact.scope.bindings) || !Array.isArray(declarations) || declarations.length !== artifact.bindings.declarationCount)
+                return { ok: false, reason: 'bindings.json declarations/count do not match manifest scope' };
+        }
+        catch (error) {
+            return { ok: false, reason: `failed to verify bindings.json: ${error instanceof Error ? error.message : String(error)}` };
+        }
+    }
+    return { ok: true, artifact };
+}
+//# sourceMappingURL=visualChangeWorkflowArtifactReader.js.map

package/dist/artifacts/visualChangeWorkflowArtifactReader.js.map

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

package/dist/artifacts/visualChangeWorkflowArtifactWriter.d.ts

@@ -0,0 +1,20 @@
+import type { Diagnostic } from '../domain/diagnostics.js';
+import type { VisualChangeWorkflowArtifact } from '../domain/visualChangeWorkflow.js';
+export declare const VISUAL_CHANGE_WORKFLOW_MANIFEST_FILENAME = "manifest.json";
+export declare const VISUAL_CHANGE_WORKFLOW_BINDINGS_FILENAME = "bindings.json";
+export interface WriteVisualChangeWorkflowArtifactOptions {
+    cwd?: string;
+    beforeRename?: (tempRoot: string) => void | Promise<void>;
+}
+export type PersistedVisualChangeWorkflowResult = {
+    ok: true;
+    artifactRoot: string;
+    manifestPath: string;
+    bindingsPath?: string;
+} | {
+    ok: false;
+    diagnostics: Diagnostic[];
+};
+export declare function computeVisualChangeBindingsSha256(bytes: string | Uint8Array): string;
+export declare function serializeVisualChangeBindings(bindings: readonly unknown[]): string;
+export declare function writeVisualChangeWorkflowArtifact(artifact: VisualChangeWorkflowArtifact, outputLocation: string, options?: WriteVisualChangeWorkflowArtifactOptions): Promise<PersistedVisualChangeWorkflowResult>;

package/dist/artifacts/visualChangeWorkflowArtifactWriter.js

@@ -0,0 +1,41 @@
+import { access, mkdir, rename, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { DIAGNOSTIC_SEVERITY } from '../domain/diagnostics.js';
+import { isValidVisualChangeWorkflowArtifact } from '../domain/visualChangeWorkflow.js';
+import { canonicalVisualChangeJson } from '../domain/visualChangeWorkflowIdentity.js';
+export const VISUAL_CHANGE_WORKFLOW_MANIFEST_FILENAME = 'manifest.json';
+export const VISUAL_CHANGE_WORKFLOW_BINDINGS_FILENAME = 'bindings.json';
+export function computeVisualChangeBindingsSha256(bytes) { return createHash('sha256').update(typeof bytes === 'string' ? Buffer.from(bytes) : bytes).digest('hex'); }
+export function serializeVisualChangeBindings(bindings) { return `${canonicalVisualChangeJson(bindings)}\n`; }
+const exists = (candidate) => access(candidate).then(() => true, () => false);
+function failure(message) { return { ok: false, diagnostics: [{ code: 'artifact-write-failure', severity: DIAGNOSTIC_SEVERITY['artifact-write-failure'], message }] }; }
+export async function writeVisualChangeWorkflowArtifact(artifact, outputLocation, options = {}) {
+    const validation = isValidVisualChangeWorkflowArtifact(artifact);
+    if (!validation.valid)
+        return failure(`refusing to persist an invalid VisualChangeWorkflowArtifact: ${validation.reason}`);
+    const outputRoot = path.resolve(options.cwd ?? process.cwd(), outputLocation);
+    const finalRoot = path.join(outputRoot, artifact.visualChangeWorkflowId);
+    const tempRoot = path.join(outputRoot, `.tmp-${artifact.visualChangeWorkflowId}`);
+    if (await exists(finalRoot))
+        return failure(`a visual-change workflow already exists at "${artifact.visualChangeWorkflowId}"; refusing to overwrite it`);
+    try {
+        await rm(tempRoot, { recursive: true, force: true });
+        await mkdir(tempRoot, { recursive: true });
+        if (artifact.scope.entryMode === 'reference') {
+            const content = serializeVisualChangeBindings(artifact.scope.bindings);
+            if (computeVisualChangeBindingsSha256(content) !== artifact.bindings?.sha256)
+                throw new Error('bindings digest does not match canonical declarations');
+            await writeFile(path.join(tempRoot, VISUAL_CHANGE_WORKFLOW_BINDINGS_FILENAME), content, 'utf8');
+        }
+        await writeFile(path.join(tempRoot, VISUAL_CHANGE_WORKFLOW_MANIFEST_FILENAME), `${JSON.stringify(artifact, null, 2)}\n`, 'utf8');
+        await options.beforeRename?.(tempRoot);
+        await rename(tempRoot, finalRoot);
+        return { ok: true, artifactRoot: finalRoot, manifestPath: path.join(finalRoot, VISUAL_CHANGE_WORKFLOW_MANIFEST_FILENAME), ...(artifact.scope.entryMode === 'reference' ? { bindingsPath: path.join(finalRoot, VISUAL_CHANGE_WORKFLOW_BINDINGS_FILENAME) } : {}) };
+    }
+    catch (error) {
+        await rm(tempRoot, { recursive: true, force: true }).catch(() => undefined);
+        return failure(`failed to persist visual-change workflow: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=visualChangeWorkflowArtifactWriter.js.map

package/dist/artifacts/visualChangeWorkflowArtifactWriter.js.map

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