@auraindustry/aurajs 0.0.7 → 0.1.0

package/src/dev-cli-inspect.mjs

@@ -0,0 +1,92 @@
+import { buildRuntimeInspectorSnapshotReport } from './conformance.mjs';
+
+export const RUNTIME_INSPECTOR_SNAPSHOT_SCHEMA_VERSION = 'aurajs.runtime-inspector-snapshot.v2';
+
+export class DevCliInspectError extends Error {
+  constructor(reasonCode, message, details = {}) {
+    super(message);
+    this.name = 'DevCliInspectError';
+    this.reasonCode = reasonCode;
+    this.details = details;
+  }
+}
+
+export async function runInspectExportFlow({
+  parsed,
+  projectRoot,
+  loadConfig,
+  runHeadlessInspectExport,
+}) {
+  const config = await loadConfig({ projectRoot, mode: 'build' });
+  const file = parsed.file || config.build.entry;
+
+  const inspectResult = await runHeadlessInspectExport({
+    projectRoot,
+    file,
+    frames: parsed.frames,
+    mode: parsed.mode,
+  });
+
+  if (!inspectResult || typeof inspectResult !== 'object') {
+    throw new DevCliInspectError(
+      'inspect_export_runtime_failed',
+      'Inspect export runtime returned an invalid result.',
+    );
+  }
+
+  const runtimeInspectorSnapshot = inspectResult.runtimeInspectorSnapshot;
+  if (!runtimeInspectorSnapshot || typeof runtimeInspectorSnapshot !== 'object') {
+    throw new DevCliInspectError(
+      'inspect_export_runtime_failed',
+      'Inspect export runtime did not provide a runtime inspector snapshot.',
+      { inspectResult },
+    );
+  }
+
+  const report = buildRuntimeInspectorSnapshotReport({
+    generatedAt: null,
+    mode: parsed.mode,
+    conformanceReportPath: null,
+    runtimeInspectorSnapshot,
+    hostBinary: null,
+    authoringState: inspectResult.authoringState || inspectResult.authoring3d || null,
+  });
+
+  if (!report || typeof report !== 'object') {
+    throw new DevCliInspectError(
+      'inspect_export_invalid_payload',
+      'Inspect export runtime produced an invalid report payload.',
+      { inspectResult, runtimeInspectorSnapshot },
+    );
+  }
+
+  if (report.schemaVersion !== parsed.schemaVersion) {
+    throw new DevCliInspectError(
+      'schema_version_mismatch',
+      `Inspector export schema "${report.schemaVersion}" does not match requested schema "${parsed.schemaVersion}".`,
+      { exported: report.schemaVersion, requested: parsed.schemaVersion },
+    );
+  }
+
+  if (report.status !== 'pass') {
+    throw new DevCliInspectError(
+      typeof report.reasonCode === 'string' ? report.reasonCode : 'inspect_export_unavailable',
+      report.error
+        ? `Inspect export failed: ${report.error}`
+        : 'Inspect export failed.',
+      { report, inspectResult },
+    );
+  }
+
+  return {
+    file,
+    report,
+    inspectResult,
+  };
+}
+
+export function serializeRuntimeInspectorReport(report, compact = false) {
+  return compact
+    ? `${JSON.stringify(report)}\n`
+    : `${JSON.stringify(report, null, 2)}\n`;
+}

package/src/dev-cli-state.mjs

@@ -0,0 +1,80 @@
+export class DevCliStateError extends Error {
+  constructor(reasonCode, message, details = {}) {
+    super(message);
+    this.name = 'DevCliStateError';
+    this.reasonCode = reasonCode;
+    this.details = details;
+  }
+}
+
+export async function runStateStepFlow({
+  parsed,
+  projectRoot,
+  loadConfig,
+  readJsonInputFile,
+  runHeadlessStateStep,
+}) {
+  const config = await loadConfig({ projectRoot, mode: 'build' });
+  const file = parsed.file || config.build.entry;
+  const inputPayload = parsed.statePath
+    ? readJsonInputFile(parsed.statePath, 'state step payload', 'state_step_input')
+    : null;
+
+  const stepResult = await runHeadlessStateStep({
+    projectRoot,
+    file,
+    frames: parsed.frames,
+    mode: parsed.mode,
+    frameIndex: parsed.frames,
+    payload: inputPayload,
+    verifyInput: parsed.verify,
+    rollbackOnFail: parsed.rollbackOnFail,
+    guardrails: {
+      maxMutations: parsed.maxOps,
+      maxPayloadBytes: parsed.maxBytes,
+      maxRuntimeMs: parsed.maxRuntimeMs,
+    },
+  });
+
+  if (!stepResult || typeof stepResult !== 'object') {
+    throw new DevCliStateError(
+      'state_step_runtime_failed',
+      'State step runtime returned an invalid result.',
+    );
+  }
+  if (stepResult.ok !== true) {
+    throw new DevCliStateError(
+      typeof stepResult.reasonCode === 'string' ? stepResult.reasonCode : 'state_step_failed',
+      stepResult.detail
+        ? `State step operation failed: ${stepResult.detail}`
+        : 'State step operation failed.',
+      { stepResult },
+    );
+  }
+  if (!stepResult.payload || typeof stepResult.payload !== 'object') {
+    throw new DevCliStateError(
+      'state_step_invalid_payload',
+      'State step runtime returned an invalid payload.',
+      { stepResult },
+    );
+  }
+  if (stepResult.payload.schemaVersion !== parsed.schemaVersion) {
+    throw new DevCliStateError(
+      'schema_version_mismatch',
+      `State step schema "${stepResult.payload.schemaVersion}" does not match requested schema "${parsed.schemaVersion}".`,
+      { exported: stepResult.payload.schemaVersion, requested: parsed.schemaVersion },
+    );
+  }
+
+  return {
+    file,
+    payload: stepResult.payload,
+    stepResult,
+  };
+}
+
+export function serializeCanonicalStatePayload(payload, compact = false) {
+  return compact
+    ? `${JSON.stringify(payload)}\n`
+    : `${JSON.stringify(payload, null, 2)}\n`;
+}