@opengeni/core 3.0.1 → 3.1.2

package/dist/{chunk-H7X52RI2.js → chunk-QI2M2B2K.js}

@@ -25,15 +25,39 @@ import {
   editableArtifactSnapshotId,
   editableArtifactStateHash,
   validateEditableArtifactActor
-} from "./chunk-VCZFFEPB.js";
+} from "./chunk-7T2SZ7BI.js";
 
 // src/domain/editable-artifacts/durable-export.ts
 import { createHash } from "crypto";
 var EDITABLE_ARTIFACT_EXPORT_MAX_DOWNLOAD_BYTES = 512 * 1024 * 1024;
 var EDITABLE_ARTIFACT_EXPORT_MAX_OPTIONS_BYTES = 256 * 1024;
+var EDITABLE_ARTIFACT_EXPORT_FORMATS = Object.freeze({
+  spreadsheet: Object.freeze(["xlsx"]),
+  document: Object.freeze([]),
+  presentation: Object.freeze([])
+});
+function describeEditableArtifactExportFormats() {
+  return describeConfiguredExportFormats(EDITABLE_ARTIFACT_EXPORT_FORMATS);
+}
+function describeConfiguredExportFormats(configuredFormats) {
+  const entries = Object.entries(configuredFormats);
+  const supported = entries.filter(([, formats]) => formats.length > 0).map(([modality, formats]) => `${modality} \u2192 ${formats.join(", ")}`);
+  const none = entries.filter(([, formats]) => formats.length === 0).map(([modality]) => modality);
+  return [
+    supported.length > 0 ? `Supported exports: ${supported.join("; ")}.` : "No exports are available.",
+    none.length > 0 ? `${none.join(" and ")} artifacts cannot be exported yet (no PDF, DOCX, PPTX, or image export); share the live artifact with its artifactReference link instead.` : ""
+  ].filter(Boolean).join(" ");
+}
+function unsupportedEditableArtifactExport(modality, format, formats = EDITABLE_ARTIFACT_EXPORT_FORMATS) {
+  const listed = formats[modality].includes(format);
+  return new EditableArtifactDurableExportError(
+    "unsupported_format",
+    listed ? `unsupported_format: this deployment does not serve a ${format} export of a ${modality} artifact with these options; retry with options omitted. ${describeConfiguredExportFormats(formats)}` : `unsupported_format: a ${modality} artifact cannot be exported as ${format}. ${describeConfiguredExportFormats(formats)}`
+  );
+}
 var EditableArtifactDurableExportError = class extends Error {
-  constructor(code) {
-    super(code);
+  constructor(code, message) {
+    super(message ?? code);
     this.code = code;
     this.name = "EditableArtifactDurableExportError";
   }
@@ -47,6 +71,30 @@ var EditableArtifactDurableExportService = class {
   constructor(dependencies) {
     this.dependencies = dependencies;
   }
+  describeFormats() {
+    const formats = this.dependencies.profiles.supportedFormats;
+    return formats ? describeConfiguredExportFormats(formats) : "Export formats are determined by this deployment's configured exporter; unsupported format/options combinations are refused before pinning.";
+  }
+  /** Read-only exact preflight: no snapshot, ID allocation, or store write. */
+  async preflight(input) {
+    const format = materializationFormat(input.format);
+    const options = exactOptions(input.options ?? Object.freeze({}));
+    const profile = await this.dependencies.profiles.resolve({
+      modality: input.modality,
+      format,
+      options
+    });
+    if (!profile) {
+      const formats = this.dependencies.profiles.supportedFormats;
+      if (formats) throw unsupportedEditableArtifactExport(input.modality, format, formats);
+      throw new EditableArtifactDurableExportError(
+        "unsupported_format",
+        `unsupported_format: this deployment does not serve ${input.modality} \u2192 ${format} with these options. ${this.describeFormats()}`
+      );
+    }
+    validateProfile(profile, input.modality, format);
+    return profile;
+  }
   async pinVersion(input) {
     const context = normalizeContext(input);
     const idempotencyKey = portableIdempotencyKey(input.idempotencyKey);
@@ -88,13 +136,11 @@ var EditableArtifactDurableExportService = class {
     const format = materializationFormat(input.format);
     const options = exactOptions(input.options ?? Object.freeze({}));
     const version = await this.getVersion(context, versionId);
-    const profile = await this.dependencies.profiles.resolve({
+    const profile = await this.preflight({
       modality: version.modality,
       format,
       options
     });
-    if (!profile) throw new EditableArtifactDurableExportError("unsupported_format");
-    validateProfile(profile, version.modality, format);
     const requestHash = hashPublicRequest("materialize", [
       idempotencyKey,
       versionId,
@@ -453,6 +499,9 @@ var EditableArtifactAgentApplication = class {
   constructor(dependencies) {
     this.dependencies = dependencies;
   }
+  describeExportFormats() {
+    return this.dependencies.exports.describeFormats();
+  }
   async list(input) {
     const context = agentContext(input);
     const limit = boundedLimit(input.limit ?? 64);
@@ -541,8 +590,18 @@ var EditableArtifactAgentApplication = class {
     const queryBytes = encodeQuery(input.request);
     const responseBytes = await this.dependencies.inspector.query({ state, queryBytes });
     const projection = decodeQueryResponse(input.request.modality, responseBytes);
+    const inspectionReceiptId = state.modality === "document" ? await this.dependencies.recordInspection?.({
+      ...context,
+      artifact: projectArtifact(state.artifact),
+      queryHash: createHash2("sha256").update(queryBytes).digest("hex"),
+      queryKind: input.request.query.kind
+    }) : void 0;
     await this.touch(context, artifactId);
-    return Object.freeze({ artifact: projectArtifact(state.artifact), projection });
+    return Object.freeze({
+      artifact: projectArtifact(state.artifact),
+      projection,
+      ...inspectionReceiptId ? { inspectionReceiptId } : {}
+    });
   }
   async apply(input) {
     const context = agentContext(input);
@@ -644,6 +703,11 @@ var EditableArtifactAgentApplication = class {
       actor: context.actor,
       artifactId
     });
+    await this.dependencies.exports.preflight({
+      modality: artifact.modality,
+      format: input.format,
+      ...input.options ? { options: input.options } : {}
+    });
     const version = await this.dependencies.exports.pinVersion({
       scope: context.scope,
       actor: context.actor,
@@ -772,6 +836,7 @@ function commandProtocolVersion(modality) {
 function projectArtifact(artifact) {
   return Object.freeze({
     id: artifact.id,
+    artifactReference: `[Open report](/workspaces/${artifact.scope.workspaceId}/artifacts/editable/${artifact.id})`,
     modality: artifact.modality,
     title: artifact.title,
     lifecycle: artifact.lifecycle,
@@ -1223,6 +1288,9 @@ var InMemoryEditableArtifactStore = class {
     });
   }
   async readTransactionBasis(scope, artifactId, request) {
+    if (request.authorizeCommit) {
+      throw new TypeError("Transactional artifact authority requires a PostgreSQL store");
+    }
     const normalizedScope = editableArtifactScope(scope);
     const normalizedArtifactId = editableArtifactId(artifactId);
     const key = aggregateKey(normalizedScope, normalizedArtifactId);
@@ -1272,6 +1340,9 @@ var InMemoryEditableArtifactStore = class {
     });
   }
   async tryCommitAppliedTransaction(request) {
+    if (request.authorizeCommit) {
+      throw new TypeError("Transactional artifact authority requires a PostgreSQL store");
+    }
     const scope = editableArtifactScope(request.scope);
     const artifactId = editableArtifactId(request.artifactId);
     const key = aggregateKey(scope, artifactId);
@@ -2365,6 +2436,10 @@ function editableArtifactMaterializationKey(input) {
 export {
   EDITABLE_ARTIFACT_EXPORT_MAX_DOWNLOAD_BYTES,
   EDITABLE_ARTIFACT_EXPORT_MAX_OPTIONS_BYTES,
+  EDITABLE_ARTIFACT_EXPORT_FORMATS,
+  describeEditableArtifactExportFormats,
+  describeConfiguredExportFormats,
+  unsupportedEditableArtifactExport,
   EditableArtifactDurableExportError,
   EditableArtifactDurableExportService,
   editableArtifactMaterializationMimeType,
@@ -2386,4 +2461,4 @@ export {
   EditableArtifactGenesisPipeline,
   editableArtifactMaterializationKey
 };
-//# sourceMappingURL=chunk-H7X52RI2.js.map
+//# sourceMappingURL=chunk-QI2M2B2K.js.map