@things-factory/figure-library 10.1.121

package/dist-server/service/library/derived.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.derivedOfSource = derivedOfSource;
+exports.derivedIsStale = derivedIsStale;
+const figure_model_1 = require("@hatiolab/figure-model");
+/**
+ * Reads a source with this server's kernel. A source it cannot read is kept (ADR-0114 결정 5) and marked; the size is
+ * then unknown, never guessed.
+ */
+function derivedOfSource(source) {
+    try {
+        const asset = (0, figure_model_1.parseFigureAsset)(source);
+        (0, figure_model_1.compileFigureAsset)(asset);
+        const { width, depth } = authoredPlanOf(asset);
+        return { formatSupported: true, checkedKernel: figure_model_1.FIGURE_KERNEL_VERSION, width, depth };
+    }
+    catch {
+        return { formatSupported: false, checkedKernel: figure_model_1.FIGURE_KERNEL_VERSION, width: null, depth: null };
+    }
+}
+/** Whether a row's derived values were made by another kernel than this server's and must be made again. */
+function derivedIsStale(row) {
+    return row.checkedKernel !== figure_model_1.FIGURE_KERNEL_VERSION;
+}
+/**
+ * The plan size a figure is placed at: its size inputs when it declares them (what the scene scales against), else the
+ * extent of its top view at the authored size.
+ */
+function authoredPlanOf(asset) {
+    const input = (axis) => {
+        const value = asset.designInputs?.[figure_model_1.FIGURE_SIZE_INPUTS[axis]];
+        return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : null;
+    };
+    const width = input('x');
+    const depth = input('z');
+    if (width !== null && depth !== null)
+        return { width, depth };
+    const points = (0, figure_model_1.figureTopViewOf)(asset, null).shapes.flatMap(shape => shape.outline);
+    if (!points.length)
+        return { width: null, depth: null };
+    const span = (i) => Math.max(...points.map(p => p[i])) - Math.min(...points.map(p => p[i]));
+    const round = (value) => (value > 0 ? Math.round(value * 1000) / 1000 : null);
+    return { width: width ?? round(span(0)), depth: depth ?? round(span(1)) };
+}
+//# sourceMappingURL=derived.js.map

package/dist-server/service/library/derived.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derived.js","sourceRoot":"","sources":["../../../server/service/library/derived.ts"],"names":[],"mappings":";;AAcA,0CASC;AAGD,wCAEC;AA5BD,yDAA2J;AAU3J;;;GAGG;AACH,SAAgB,eAAe,CAAC,MAAc;IAC5C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAA,+BAAgB,EAAC,MAAM,CAAC,CAAA;QACtC,IAAA,iCAAkB,EAAC,KAAK,CAAC,CAAA;QACzB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;QAC9C,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,EAAE,oCAAqB,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;IACtF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,oCAAqB,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IACnG,CAAC;AACH,CAAC;AAED,4GAA4G;AAC5G,SAAgB,cAAc,CAAC,GAAsC;IACnE,OAAO,GAAG,CAAC,aAAa,KAAK,oCAAqB,CAAA;AACpD,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,KAAkB;IACxC,MAAM,KAAK,GAAG,CAAC,IAAe,EAAE,EAAE;QAChC,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC,iCAAkB,CAAC,IAAI,CAAC,CAAC,CAAA;QAC5D,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;IACxF,CAAC,CAAA;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;IACxB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;IACxB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;IAE7D,MAAM,MAAM,GAAG,IAAA,8BAAe,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAClF,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IACvD,MAAM,IAAI,GAAG,CAAC,CAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAClG,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACrF,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC3E,CAAC","sourcesContent":["import { compileFigureAsset, FIGURE_KERNEL_VERSION, FIGURE_SIZE_INPUTS, figureTopViewOf, parseFigureAsset, type FigureAsset } from '@hatiolab/figure-model'\n\n/** What this server derives from a release's source: whether its kernel reads it, and its authored size. */\nexport interface DerivedOfSource {\n  formatSupported: boolean\n  checkedKernel: string\n  width: number | null\n  depth: number | null\n}\n\n/**\n * Reads a source with this server's kernel. A source it cannot read is kept (ADR-0114 결정 5) and marked; the size is\n * then unknown, never guessed.\n */\nexport function derivedOfSource(source: string): DerivedOfSource {\n  try {\n    const asset = parseFigureAsset(source)\n    compileFigureAsset(asset)\n    const { width, depth } = authoredPlanOf(asset)\n    return { formatSupported: true, checkedKernel: FIGURE_KERNEL_VERSION, width, depth }\n  } catch {\n    return { formatSupported: false, checkedKernel: FIGURE_KERNEL_VERSION, width: null, depth: null }\n  }\n}\n\n/** Whether a row's derived values were made by another kernel than this server's and must be made again. */\nexport function derivedIsStale(row: { checkedKernel?: string | null }): boolean {\n  return row.checkedKernel !== FIGURE_KERNEL_VERSION\n}\n\n/**\n * The plan size a figure is placed at: its size inputs when it declares them (what the scene scales against), else the\n * extent of its top view at the authored size.\n */\nfunction authoredPlanOf(asset: FigureAsset): { width: number | null; depth: number | null } {\n  const input = (axis: 'x' | 'z') => {\n    const value = asset.designInputs?.[FIGURE_SIZE_INPUTS[axis]]\n    return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : null\n  }\n  const width = input('x')\n  const depth = input('z')\n  if (width !== null && depth !== null) return { width, depth }\n\n  const points = figureTopViewOf(asset, null).shapes.flatMap(shape => shape.outline)\n  if (!points.length) return { width: null, depth: null }\n  const span = (i: 0 | 1) => Math.max(...points.map(p => p[i])) - Math.min(...points.map(p => p[i]))\n  const round = (value: number) => (value > 0 ? Math.round(value * 1000) / 1000 : null)\n  return { width: width ?? round(span(0)), depth: depth ?? round(span(1)) }\n}\n"]}

package/dist-server/service/library/import.d.ts

@@ -0,0 +1,30 @@
+import { EntityManager } from 'typeorm';
+import { type LibraryFiles } from './library-files';
+export type ImportOutcomeKind = 'added' | 'skipped' | 'refused';
+export interface ImportOutcome {
+    ref: string;
+    outcome: ImportOutcomeKind;
+    code?: string;
+    /** For a skipped release: the fields the package gave differently from the row already here. */
+    differs?: string[];
+}
+export interface ImportResult {
+    /** Problems that refuse the whole package; nothing is imported when there is one. */
+    problems: {
+        code: string;
+        path?: string;
+    }[];
+    outcomes: ImportOutcome[];
+}
+/**
+ * Imports a figure package into this domain's library (ADR-0114 결정 5 · 16).
+ *
+ * A release is known by its reference and the hash of its source, nothing else. Not here: added, its dependency files
+ * kept, and put into the candidate map. The same source: skipped, the row left as it is, the fields that differ named.
+ * Another source under the same reference: refused. A format this server cannot read is still imported.
+ */
+export declare function importFigurePackage(tx: EntityManager, domain: {
+    id: string;
+}, user: unknown, bytes: Buffer, packageName: string, files?: LibraryFiles): Promise<ImportResult>;
+/** A file the import was given is not a package at all. */
+export declare function assertPackageName(name: string): void;

package/dist-server/service/library/import.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.importFigurePackage = importFigurePackage;
+exports.assertPackageName = assertPackageName;
+const tslib_1 = require("tslib");
+const jszip_1 = tslib_1.__importDefault(require("jszip"));
+const figure_model_1 = require("@hatiolab/figure-model");
+const shell_1 = require("@things-factory/shell");
+const figure_library_release_1 = require("../figure-library-release/figure-library-release");
+const derived_1 = require("./derived");
+const library_files_1 = require("./library-files");
+const type_map_1 = require("./type-map");
+const json = (value) => (value == null ? null : JSON.stringify(value));
+/**
+ * Imports a figure package into this domain's library (ADR-0114 결정 5 · 16).
+ *
+ * A release is known by its reference and the hash of its source, nothing else. Not here: added, its dependency files
+ * kept, and put into the candidate map. The same source: skipped, the row left as it is, the fields that differ named.
+ * Another source under the same reference: refused. A format this server cannot read is still imported.
+ */
+async function importFigurePackage(tx, domain, user, bytes, packageName, files = (0, library_files_1.libraryFiles)()) {
+    let zip;
+    try {
+        zip = await jszip_1.default.loadAsync(bytes);
+    }
+    catch {
+        return { problems: [{ code: 'package-unreadable' }], outcomes: [] };
+    }
+    const packed = new Map();
+    for (const [path, entry] of Object.entries(zip.files))
+        if (!entry.dir)
+            packed.set(path, await entry.async('uint8array'));
+    const read = (0, figure_model_1.readFigurePackage)(packed, library_files_1.sha256Of);
+    if (read.problems.length)
+        return { problems: read.problems.map(p => ({ code: p.code, path: p.path })), outcomes: [] };
+    const outcomes = read.refused.map(p => ({ ref: p.ref ?? '', outcome: 'refused', code: p.code }));
+    const entries = new Map(read.manifest.releases.map(entry => [entry.ref, entry]));
+    const repository = tx.getRepository(figure_library_release_1.FigureLibraryRelease);
+    for (const release of read.releases) {
+        const entry = entries.get(release.ref);
+        const contentHash = entry.contentHash;
+        const existing = await repository.findOne({ where: { domain: { id: domain.id }, ref: release.ref } });
+        if (existing) {
+            if (existing.contentHash !== contentHash) {
+                outcomes.push({ ref: release.ref, outcome: 'refused', code: 'figure-import-conflict' });
+                continue;
+            }
+            const differs = differingFields(existing, release, entry.blobs);
+            outcomes.push({ ref: release.ref, outcome: 'skipped', ...(differs.length ? { code: 'skipped-metadata-differs', differs } : {}) });
+            continue;
+        }
+        for (const blob of entry.blobs) {
+            const file = read.blobs.get(blob.hash);
+            await (0, library_files_1.keepLibraryFile)(tx, domain, user, { hash: blob.hash, bytes: file.bytes, contentType: file.contentType }, files);
+        }
+        const ref = (0, figure_model_1.parseFigureRef)(release.ref);
+        const saved = await repository.save({
+            domain,
+            name: release.name,
+            description: release.description ?? undefined,
+            ref: release.ref,
+            namespace: ref.namespace,
+            type: ref.type,
+            version: ref.version,
+            names: release.names ?? undefined,
+            category: release.category ?? undefined,
+            source: release.source,
+            contentHash,
+            assetFormat: release.assetFormat,
+            kernelVersion: release.kernelVersion ?? undefined,
+            metrics: json(release.metrics) ?? undefined,
+            topView: json(release.topView) ?? undefined,
+            changes: json(release.changes) ?? undefined,
+            ...(0, derived_1.derivedOfSource)(release.source),
+            dependencies: entry.blobs.map(blob => ({ ...blob })),
+            deprecated: !!release.deprecated,
+            supersededBy: release.supersededBy ?? undefined,
+            sourceUrl: read.manifest.source.url,
+            sourceDomain: read.manifest.source.domain,
+            packageName,
+            releasedAt: release.releasedAt ? new Date(release.releasedAt) : undefined,
+            creator: user,
+            updater: user
+        });
+        await (0, type_map_1.putIntoCandidate)(tx, domain, user, saved);
+        outcomes.push({ ref: release.ref, outcome: 'added' });
+    }
+    return { problems: [], outcomes };
+}
+/** The fields a package gives for an existing release that differ from the row: reported, never written. */
+function differingFields(row, release, blobs) {
+    const same = (a, b) => JSON.stringify(a ?? null) === JSON.stringify(b ?? null);
+    const parsed = (text) => (text ? JSON.parse(text) : null);
+    const pairs = [
+        ['name', row.name, release.name],
+        ['names', row.names, release.names],
+        ['description', row.description, release.description],
+        ['category', row.category, release.category],
+        ['assetFormat', row.assetFormat, release.assetFormat],
+        ['kernelVersion', row.kernelVersion, release.kernelVersion],
+        ['metrics', parsed(row.metrics), release.metrics],
+        ['topView', parsed(row.topView), release.topView],
+        ['changes', parsed(row.changes), release.changes],
+        ['dependencies', (row.dependencies ?? []).map(d => d.hash), blobs.map(b => b.hash)],
+        ['deprecated', !!row.deprecated, !!release.deprecated],
+        ['supersededBy', row.supersededBy, release.supersededBy]
+    ];
+    return pairs.filter(([, a, b]) => !same(a, b)).map(([field]) => field);
+}
+/** A file the import was given is not a package at all. */
+function assertPackageName(name) {
+    if (!/\.(figpkg|zip)$/i.test(name)) {
+        throw new shell_1.Refusal('figure-package-invalid', { name }, '{name} is not a figure package (.figpkg).');
+    }
+}
+//# sourceMappingURL=import.js.map

package/dist-server/service/library/import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../../server/service/library/import.ts"],"names":[],"mappings":"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","sourcesContent":["import JSZip from 'jszip'\nimport { EntityManager } from 'typeorm'\n\nimport { parseFigureRef, readFigurePackage, type FigurePackageRelease } from '@hatiolab/figure-model'\nimport { Refusal } from '@things-factory/shell'\n\nimport { FigureLibraryRelease } from '../figure-library-release/figure-library-release'\nimport { derivedOfSource } from './derived'\nimport { keepLibraryFile, libraryFiles, sha256Of, type LibraryFiles } from './library-files'\nimport { putIntoCandidate } from './type-map'\n\nexport type ImportOutcomeKind = 'added' | 'skipped' | 'refused'\n\nexport interface ImportOutcome {\n  ref: string\n  outcome: ImportOutcomeKind\n  code?: string\n  /** For a skipped release: the fields the package gave differently from the row already here. */\n  differs?: string[]\n}\n\nexport interface ImportResult {\n  /** Problems that refuse the whole package; nothing is imported when there is one. */\n  problems: { code: string; path?: string }[]\n  outcomes: ImportOutcome[]\n}\n\nconst json = (value: unknown) => (value == null ? null : JSON.stringify(value))\n\n/**\n * Imports a figure package into this domain's library (ADR-0114 결정 5 · 16).\n *\n * A release is known by its reference and the hash of its source, nothing else. Not here: added, its dependency files\n * kept, and put into the candidate map. The same source: skipped, the row left as it is, the fields that differ named.\n * Another source under the same reference: refused. A format this server cannot read is still imported.\n */\nexport async function importFigurePackage(\n  tx: EntityManager,\n  domain: { id: string },\n  user: unknown,\n  bytes: Buffer,\n  packageName: string,\n  files: LibraryFiles = libraryFiles()\n): Promise<ImportResult> {\n  let zip: JSZip\n  try {\n    zip = await JSZip.loadAsync(bytes)\n  } catch {\n    return { problems: [{ code: 'package-unreadable' }], outcomes: [] }\n  }\n  const packed = new Map<string, Uint8Array>()\n  for (const [path, entry] of Object.entries(zip.files)) if (!entry.dir) packed.set(path, await entry.async('uint8array'))\n\n  const read = readFigurePackage(packed, sha256Of)\n  if (read.problems.length) return { problems: read.problems.map(p => ({ code: p.code, path: p.path })), outcomes: [] }\n\n  const outcomes: ImportOutcome[] = read.refused.map(p => ({ ref: p.ref ?? '', outcome: 'refused', code: p.code }))\n  const entries = new Map(read.manifest!.releases.map(entry => [entry.ref, entry]))\n  const repository = tx.getRepository(FigureLibraryRelease)\n\n  for (const release of read.releases) {\n    const entry = entries.get(release.ref)!\n    const contentHash = entry.contentHash\n    const existing = await repository.findOne({ where: { domain: { id: domain.id }, ref: release.ref } })\n    if (existing) {\n      if (existing.contentHash !== contentHash) {\n        outcomes.push({ ref: release.ref, outcome: 'refused', code: 'figure-import-conflict' })\n        continue\n      }\n      const differs = differingFields(existing, release, entry.blobs)\n      outcomes.push({ ref: release.ref, outcome: 'skipped', ...(differs.length ? { code: 'skipped-metadata-differs', differs } : {}) })\n      continue\n    }\n\n    for (const blob of entry.blobs) {\n      const file = read.blobs.get(blob.hash)!\n      await keepLibraryFile(tx, domain, user, { hash: blob.hash, bytes: file.bytes, contentType: file.contentType }, files)\n    }\n    const ref = parseFigureRef(release.ref)!\n    const saved = await repository.save({\n      domain,\n      name: release.name,\n      description: release.description ?? undefined,\n      ref: release.ref,\n      namespace: ref.namespace,\n      type: ref.type,\n      version: ref.version,\n      names: release.names ?? undefined,\n      category: release.category ?? undefined,\n      source: release.source,\n      contentHash,\n      assetFormat: release.assetFormat,\n      kernelVersion: release.kernelVersion ?? undefined,\n      metrics: json(release.metrics) ?? undefined,\n      topView: json(release.topView) ?? undefined,\n      changes: json(release.changes) ?? undefined,\n      ...derivedOfSource(release.source),\n      dependencies: entry.blobs.map(blob => ({ ...blob })),\n      deprecated: !!release.deprecated,\n      supersededBy: release.supersededBy ?? undefined,\n      sourceUrl: read.manifest!.source.url,\n      sourceDomain: read.manifest!.source.domain,\n      packageName,\n      releasedAt: release.releasedAt ? new Date(release.releasedAt) : undefined,\n      creator: user,\n      updater: user\n    } as Partial<FigureLibraryRelease>)\n    await putIntoCandidate(tx, domain, user, saved as FigureLibraryRelease)\n    outcomes.push({ ref: release.ref, outcome: 'added' })\n  }\n\n  return { problems: [], outcomes }\n}\n\n/** The fields a package gives for an existing release that differ from the row: reported, never written. */\nfunction differingFields(row: FigureLibraryRelease, release: FigurePackageRelease, blobs: readonly { hash: string }[]): string[] {\n  const same = (a: unknown, b: unknown) => JSON.stringify(a ?? null) === JSON.stringify(b ?? null)\n  const parsed = (text?: string | null) => (text ? JSON.parse(text) : null)\n  const pairs: [string, unknown, unknown][] = [\n    ['name', row.name, release.name],\n    ['names', row.names, release.names],\n    ['description', row.description, release.description],\n    ['category', row.category, release.category],\n    ['assetFormat', row.assetFormat, release.assetFormat],\n    ['kernelVersion', row.kernelVersion, release.kernelVersion],\n    ['metrics', parsed(row.metrics), release.metrics],\n    ['topView', parsed(row.topView), release.topView],\n    ['changes', parsed(row.changes), release.changes],\n    ['dependencies', (row.dependencies ?? []).map(d => d.hash), blobs.map(b => b.hash)],\n    ['deprecated', !!row.deprecated, !!release.deprecated],\n    ['supersededBy', row.supersededBy, release.supersededBy]\n  ]\n  return pairs.filter(([, a, b]) => !same(a, b)).map(([field]) => field)\n}\n\n/** A file the import was given is not a package at all. */\nexport function assertPackageName(name: string): void {\n  if (!/\\.(figpkg|zip)$/i.test(name)) {\n    throw new Refusal('figure-package-invalid', { name }, '{name} is not a figure package (.figpkg).')\n  }\n}\n"]}

package/dist-server/service/library/inspection.d.ts

@@ -0,0 +1,63 @@
+import { EntityManager } from 'typeorm';
+import { FigureLibraryRelease } from '../figure-library-release/figure-library-release';
+import { type LibraryFiles } from './library-files';
+type Domain = {
+    id: string;
+};
+/** How much of the domain's boards a line touches. */
+export interface Reach {
+    boards: number;
+    nodes: number;
+}
+/** Brings a row's derived values up to this server's kernel, writing them back when they changed. */
+export declare function freshen(tx: EntityManager, release: FigureLibraryRelease): Promise<FigureLibraryRelease>;
+/** The dependency files of a release that are missing or whose bytes no longer hash to their name. */
+export declare function dependencyFaults(tx: EntityManager, release: FigureLibraryRelease, files?: LibraryFiles): Promise<{
+    hash: string;
+    fault: 'missing' | 'corrupt';
+}[]>;
+/** Figure nodes across the domain's boards: per name, how many boards and nodes use it. */
+export declare function reachOf(tx: EntityManager, domain: Domain): Promise<Map<string, Reach>>;
+/**
+ * The check before activation (ADR-0114 결정 8): the candidate against the active map and every board of the domain.
+ * It reports and never blocks; the activation screen shows it and asks to confirm.
+ */
+export declare function typeMapCheck(tx: EntityManager, domain: Domain, files?: LibraryFiles): Promise<{
+    candidate: {
+        version: number;
+        revision: number;
+    };
+    active: {
+        version: number;
+        revision: number;
+    };
+    missing: {
+        boards: number;
+        nodes: number;
+        name: string;
+    }[];
+    added: {
+        boards: number;
+        nodes: number;
+        name: string;
+        ref: string;
+    }[];
+    changed: any[];
+    deprecated: any[];
+    unsupported: any[];
+    dependencies: any[];
+}>;
+export type RequirementStatus = 'drawn' | 'not-in-type-map' | 'release-unavailable' | 'dependency-missing' | 'format-unsupported';
+/**
+ * What one board needs from the active map (ADR-0114 결정 8): each figure it holds, its status and node count. A
+ * figure not in the library has dependencies this server cannot know.
+ */
+export declare function boardRequirements(tx: EntityManager, domain: Domain, boardId: string, files?: LibraryFiles): Promise<{
+    board: string;
+    typeMap: {
+        version: number;
+        revision: number;
+    };
+    figures: any[];
+}>;
+export {};

package/dist-server/service/library/inspection.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.freshen = freshen;
+exports.dependencyFaults = dependencyFaults;
+exports.reachOf = reachOf;
+exports.typeMapCheck = typeMapCheck;
+exports.boardRequirements = boardRequirements;
+const figure_model_1 = require("@hatiolab/figure-model");
+const board_service_1 = require("@things-factory/board-service");
+const figure_library_release_1 = require("../figure-library-release/figure-library-release");
+const figure_type_map_1 = require("../figure-type-map/figure-type-map");
+const derived_1 = require("./derived");
+const board_walk_1 = require("./board-walk");
+const library_files_1 = require("./library-files");
+const type_map_1 = require("./type-map");
+/** Brings a row's derived values up to this server's kernel, writing them back when they changed. */
+async function freshen(tx, release) {
+    if (!(0, derived_1.derivedIsStale)(release))
+        return release;
+    const derived = (0, derived_1.derivedOfSource)(release.source);
+    await tx.getRepository(figure_library_release_1.FigureLibraryRelease).update({ id: release.id }, derived);
+    return Object.assign(release, derived);
+}
+/** The dependency files of a release that are missing or whose bytes no longer hash to their name. */
+async function dependencyFaults(tx, release, files = (0, library_files_1.libraryFiles)()) {
+    const faults = [];
+    for (const dependency of release.dependencies ?? []) {
+        const attachment = await (0, library_files_1.libraryFileOf)(tx, release.domainId, dependency.hash);
+        if (!attachment) {
+            faults.push({ hash: dependency.hash, fault: 'missing' });
+            continue;
+        }
+        try {
+            const bytes = await files.read(attachment.path);
+            if ((0, library_files_1.sha256Of)(bytes) !== dependency.hash)
+                faults.push({ hash: dependency.hash, fault: 'corrupt' });
+        }
+        catch {
+            faults.push({ hash: dependency.hash, fault: 'missing' });
+        }
+    }
+    return faults;
+}
+/** Figure nodes across the domain's boards: per name, how many boards and nodes use it. */
+async function reachOf(tx, domain) {
+    const reach = new Map();
+    const boards = await tx.getRepository(board_service_1.Board).find({ where: { domain: { id: domain.id } }, select: { id: true, model: true } });
+    for (const board of boards) {
+        for (const [name, nodes] of (0, board_walk_1.figureNodesOf)(board.model)) {
+            const now = reach.get(name) ?? { boards: 0, nodes: 0 };
+            reach.set(name, { boards: now.boards + 1, nodes: now.nodes + nodes });
+        }
+    }
+    return reach;
+}
+/**
+ * The check before activation (ADR-0114 결정 8): the candidate against the active map and every board of the domain.
+ * It reports and never blocks; the activation screen shows it and asks to confirm.
+ */
+async function typeMapCheck(tx, domain, files) {
+    const candidate = await (0, type_map_1.mapOfState)(tx, domain, figure_type_map_1.FigureTypeMapState.CANDIDATE);
+    if (!candidate)
+        return null;
+    const active = await (0, type_map_1.mapOfState)(tx, domain, figure_type_map_1.FigureTypeMapState.ACTIVE);
+    const next = new Map((await (0, type_map_1.entriesOf)(tx, candidate)).map(line => [line.name, line.release]));
+    const now = new Map(active ? (await (0, type_map_1.entriesOf)(tx, active)).map(line => [line.name, line.release]) : []);
+    const reach = await reachOf(tx, domain);
+    const at = (name) => reach.get(name) ?? { boards: 0, nodes: 0 };
+    const missing = [...reach.keys()].filter(name => !next.has(name)).map(name => ({ name, ...at(name) }));
+    const added = [...next.keys()].filter(name => !now.has(name)).map(name => ({ name, ref: next.get(name).ref, ...at(name) }));
+    const changed = [];
+    for (const [name, release] of next) {
+        const before = now.get(name);
+        if (!before || before.id === release.id)
+            continue;
+        changed.push({ name, from: before.ref, to: release.ref, contract: contractOf(before, release), ...at(name) });
+    }
+    const deprecated = [];
+    const unsupported = [];
+    const dependencies = [];
+    for (const [name, release] of next) {
+        const fresh = await freshen(tx, release);
+        if (fresh.deprecated)
+            deprecated.push({ name, ref: fresh.ref, supersededBy: fresh.supersededBy ?? null, ...at(name) });
+        if (!fresh.formatSupported)
+            unsupported.push({ name, ref: fresh.ref, assetFormat: fresh.assetFormat, ...at(name) });
+        const faults = await dependencyFaults(tx, fresh, files);
+        if (faults.length)
+            dependencies.push({ name, ref: fresh.ref, faults, ...at(name) });
+    }
+    return {
+        candidate: { version: candidate.version, revision: candidate.revision },
+        active: active ? { version: active.version, revision: active.revision } : null,
+        missing,
+        added,
+        changed,
+        deprecated,
+        unsupported,
+        dependencies
+    };
+}
+/** The contract changes between two releases, or `uncheckable` when this server cannot read either. */
+function contractOf(before, after) {
+    try {
+        return { checked: true, changes: (0, figure_model_1.figureContractChanges)((0, figure_model_1.parseFigureAsset)(before.source), (0, figure_model_1.parseFigureAsset)(after.source)) };
+    }
+    catch {
+        return { checked: false, changes: [] };
+    }
+}
+/**
+ * What one board needs from the active map (ADR-0114 결정 8): each figure it holds, its status and node count. A
+ * figure not in the library has dependencies this server cannot know.
+ */
+async function boardRequirements(tx, domain, boardId, files) {
+    const board = await tx.getRepository(board_service_1.Board).findOne({ where: { id: boardId, domain: { id: domain.id } }, select: { id: true, model: true } });
+    if (!board)
+        return null;
+    const active = await (0, type_map_1.mapOfState)(tx, domain, figure_type_map_1.FigureTypeMapState.ACTIVE);
+    const lines = new Map(active ? (await (0, type_map_1.entriesOf)(tx, active)).map(line => [line.name, line]) : []);
+    const figures = [];
+    for (const [name, nodes] of (0, board_walk_1.figureNodesOf)(board.model)) {
+        const line = lines.get(name);
+        let status = 'drawn';
+        let ref = null;
+        let dependencies = 'unknown';
+        if (!line)
+            status = 'not-in-type-map';
+        else if (!line.release)
+            status = 'release-unavailable';
+        else {
+            const release = await freshen(tx, line.release);
+            ref = release.ref;
+            dependencies = release.dependencies ?? [];
+            if ((await dependencyFaults(tx, release, files)).length)
+                status = 'dependency-missing';
+            else if (!release.formatSupported)
+                status = 'format-unsupported';
+        }
+        figures.push({ name, status, ref, nodes, dependencies });
+    }
+    return { board: board.id, typeMap: active ? { version: active.version, revision: active.revision } : null, figures };
+}
+//# sourceMappingURL=inspection.js.map

package/dist-server/service/library/inspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection.js","sourceRoot":"","sources":["../../../server/service/library/inspection.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntityManager } from 'typeorm'\n\nimport { figureContractChanges, parseFigureAsset } from '@hatiolab/figure-model'\nimport { Board } from '@things-factory/board-service'\n\nimport { FigureLibraryRelease } from '../figure-library-release/figure-library-release'\nimport { FigureTypeMapState } from '../figure-type-map/figure-type-map'\nimport { derivedIsStale, derivedOfSource } from './derived'\nimport { figureNodesOf } from './board-walk'\nimport { libraryFileOf, libraryFiles, sha256Of, type LibraryFiles } from './library-files'\nimport { entriesOf, mapOfState } from './type-map'\n\ntype Domain = { id: string }\n\n/** How much of the domain's boards a line touches. */\nexport interface Reach {\n  boards: number\n  nodes: number\n}\n\n/** Brings a row's derived values up to this server's kernel, writing them back when they changed. */\nexport async function freshen(tx: EntityManager, release: FigureLibraryRelease): Promise<FigureLibraryRelease> {\n  if (!derivedIsStale(release)) return release\n  const derived = derivedOfSource(release.source)\n  await tx.getRepository(FigureLibraryRelease).update({ id: release.id }, derived)\n  return Object.assign(release, derived)\n}\n\n/** The dependency files of a release that are missing or whose bytes no longer hash to their name. */\nexport async function dependencyFaults(\n  tx: EntityManager,\n  release: FigureLibraryRelease,\n  files: LibraryFiles = libraryFiles()\n): Promise<{ hash: string; fault: 'missing' | 'corrupt' }[]> {\n  const faults: { hash: string; fault: 'missing' | 'corrupt' }[] = []\n  for (const dependency of release.dependencies ?? []) {\n    const attachment = await libraryFileOf(tx, release.domainId!, dependency.hash)\n    if (!attachment) {\n      faults.push({ hash: dependency.hash, fault: 'missing' })\n      continue\n    }\n    try {\n      const bytes = await files.read(attachment.path)\n      if (sha256Of(bytes) !== dependency.hash) faults.push({ hash: dependency.hash, fault: 'corrupt' })\n    } catch {\n      faults.push({ hash: dependency.hash, fault: 'missing' })\n    }\n  }\n  return faults\n}\n\n/** Figure nodes across the domain's boards: per name, how many boards and nodes use it. */\nexport async function reachOf(tx: EntityManager, domain: Domain): Promise<Map<string, Reach>> {\n  const reach = new Map<string, Reach>()\n  const boards = await tx.getRepository(Board).find({ where: { domain: { id: domain.id } }, select: { id: true, model: true } })\n  for (const board of boards) {\n    for (const [name, nodes] of figureNodesOf(board.model)) {\n      const now = reach.get(name) ?? { boards: 0, nodes: 0 }\n      reach.set(name, { boards: now.boards + 1, nodes: now.nodes + nodes })\n    }\n  }\n  return reach\n}\n\n/**\n * The check before activation (ADR-0114 결정 8): the candidate against the active map and every board of the domain.\n * It reports and never blocks; the activation screen shows it and asks to confirm.\n */\nexport async function typeMapCheck(tx: EntityManager, domain: Domain, files?: LibraryFiles) {\n  const candidate = await mapOfState(tx, domain, FigureTypeMapState.CANDIDATE)\n  if (!candidate) return null\n  const active = await mapOfState(tx, domain, FigureTypeMapState.ACTIVE)\n\n  const next = new Map((await entriesOf(tx, candidate)).map(line => [line.name, line.release!]))\n  const now = new Map(active ? (await entriesOf(tx, active)).map(line => [line.name, line.release!]) : [])\n  const reach = await reachOf(tx, domain)\n  const at = (name: string): Reach => reach.get(name) ?? { boards: 0, nodes: 0 }\n\n  const missing = [...reach.keys()].filter(name => !next.has(name)).map(name => ({ name, ...at(name) }))\n  const added = [...next.keys()].filter(name => !now.has(name)).map(name => ({ name, ref: next.get(name)!.ref, ...at(name) }))\n  const changed = []\n  for (const [name, release] of next) {\n    const before = now.get(name)\n    if (!before || before.id === release.id) continue\n    changed.push({ name, from: before.ref, to: release.ref, contract: contractOf(before, release), ...at(name) })\n  }\n  const deprecated = []\n  const unsupported = []\n  const dependencies = []\n  for (const [name, release] of next) {\n    const fresh = await freshen(tx, release)\n    if (fresh.deprecated) deprecated.push({ name, ref: fresh.ref, supersededBy: fresh.supersededBy ?? null, ...at(name) })\n    if (!fresh.formatSupported) unsupported.push({ name, ref: fresh.ref, assetFormat: fresh.assetFormat, ...at(name) })\n    const faults = await dependencyFaults(tx, fresh, files)\n    if (faults.length) dependencies.push({ name, ref: fresh.ref, faults, ...at(name) })\n  }\n\n  return {\n    candidate: { version: candidate.version, revision: candidate.revision },\n    active: active ? { version: active.version, revision: active.revision } : null,\n    missing,\n    added,\n    changed,\n    deprecated,\n    unsupported,\n    dependencies\n  }\n}\n\n/** The contract changes between two releases, or `uncheckable` when this server cannot read either. */\nfunction contractOf(before: FigureLibraryRelease, after: FigureLibraryRelease) {\n  try {\n    return { checked: true, changes: figureContractChanges(parseFigureAsset(before.source), parseFigureAsset(after.source)) }\n  } catch {\n    return { checked: false, changes: [] }\n  }\n}\n\nexport type RequirementStatus = 'drawn' | 'not-in-type-map' | 'release-unavailable' | 'dependency-missing' | 'format-unsupported'\n\n/**\n * What one board needs from the active map (ADR-0114 결정 8): each figure it holds, its status and node count. A\n * figure not in the library has dependencies this server cannot know.\n */\nexport async function boardRequirements(tx: EntityManager, domain: Domain, boardId: string, files?: LibraryFiles) {\n  const board = await tx.getRepository(Board).findOne({ where: { id: boardId, domain: { id: domain.id } }, select: { id: true, model: true } })\n  if (!board) return null\n  const active = await mapOfState(tx, domain, FigureTypeMapState.ACTIVE)\n  const lines = new Map(active ? (await entriesOf(tx, active)).map(line => [line.name, line]) : [])\n\n  const figures = []\n  for (const [name, nodes] of figureNodesOf(board.model)) {\n    const line = lines.get(name)\n    let status: RequirementStatus = 'drawn'\n    let ref: string | null = null\n    let dependencies: unknown = 'unknown'\n    if (!line) status = 'not-in-type-map'\n    else if (!line.release) status = 'release-unavailable'\n    else {\n      const release = await freshen(tx, line.release)\n      ref = release.ref\n      dependencies = release.dependencies ?? []\n      if ((await dependencyFaults(tx, release, files)).length) status = 'dependency-missing'\n      else if (!release.formatSupported) status = 'format-unsupported'\n    }\n    figures.push({ name, status, ref, nodes, dependencies })\n  }\n  return { board: board.id, typeMap: active ? { version: active.version, revision: active.revision } : null, figures }\n}\n"]}

package/dist-server/service/library/library-files.d.ts

@@ -0,0 +1,32 @@
+import { Attachment } from '@things-factory/attachment-base';
+/** Attachments that hold the files imported releases depend on, one per (domain, content hash). */
+export declare const LIBRARY_FILE_REF_TYPE = "figure-library-file";
+export declare const sha256Of: (bytes: Uint8Array) => string;
+/** Where the bytes go: attachment-base's storage. Tests give another. */
+export interface LibraryFiles {
+    put(bytes: Buffer, mimetype: string, name: string, context: any): Promise<{
+        id: string;
+        path: string;
+        size: number;
+        contents?: Buffer;
+    }>;
+    read(path: string): Promise<Buffer>;
+}
+export declare const attachmentFiles: LibraryFiles;
+export declare const libraryFiles: () => LibraryFiles;
+/** For tests: use these files until set back; returns the ones it replaced. */
+export declare function useLibraryFiles(files: LibraryFiles): LibraryFiles;
+type Tx = {
+    getRepository: (target: any) => any;
+};
+/** The attachment holding this content in this domain, or undefined. */
+export declare function libraryFileOf(tx: Tx, domainId: string, hash: string): Promise<Attachment | undefined>;
+/** Keeps one dependency file under its hash; a file already kept in this domain is not written again. */
+export declare function keepLibraryFile(tx: Tx, domain: {
+    id: string;
+}, user: unknown, file: {
+    hash: string;
+    bytes: Uint8Array;
+    contentType: string;
+}, files?: LibraryFiles): Promise<void>;
+export {};

package/dist-server/service/library/library-files.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.libraryFiles = exports.attachmentFiles = exports.sha256Of = exports.LIBRARY_FILE_REF_TYPE = void 0;
+exports.useLibraryFiles = useLibraryFiles;
+exports.libraryFileOf = libraryFileOf;
+exports.keepLibraryFile = keepLibraryFile;
+const crypto_1 = require("crypto");
+const stream_1 = require("stream");
+const attachment_base_1 = require("@things-factory/attachment-base");
+/** Attachments that hold the files imported releases depend on, one per (domain, content hash). */
+exports.LIBRARY_FILE_REF_TYPE = 'figure-library-file';
+const sha256Of = (bytes) => (0, crypto_1.createHash)('sha256').update(bytes).digest('hex');
+exports.sha256Of = sha256Of;
+exports.attachmentFiles = {
+    async put(bytes, mimetype, name, context) {
+        const file = Promise.resolve({ createReadStream: () => stream_1.Readable.from([bytes]), filename: name, mimetype, encoding: 'binary' });
+        const { id, path, size, contents } = await attachment_base_1.STORAGE.uploadFile({ file, context });
+        return { id, path, size, contents };
+    },
+    read: async (path) => Buffer.from(await attachment_base_1.STORAGE.readFile(path))
+};
+let inUse = exports.attachmentFiles;
+const libraryFiles = () => inUse;
+exports.libraryFiles = libraryFiles;
+/** For tests: use these files until set back; returns the ones it replaced. */
+function useLibraryFiles(files) {
+    const was = inUse;
+    inUse = files;
+    return was;
+}
+/** The attachment holding this content in this domain, or undefined. */
+async function libraryFileOf(tx, domainId, hash) {
+    return (await tx.getRepository(attachment_base_1.Attachment).findOne({ where: { domain: { id: domainId }, refType: exports.LIBRARY_FILE_REF_TYPE, refBy: hash } })) ?? undefined;
+}
+/** Keeps one dependency file under its hash; a file already kept in this domain is not written again. */
+async function keepLibraryFile(tx, domain, user, file, files = (0, exports.libraryFiles)()) {
+    if (await libraryFileOf(tx, domain.id, file.hash))
+        return;
+    const ext = file.contentType.split('/')[1]?.split('+')[0] || 'bin';
+    const name = `${file.hash}.${ext}`;
+    const put = await files.put(Buffer.from(file.bytes), file.contentType, name, { state: { domain, user, tx } });
+    await tx.getRepository(attachment_base_1.Attachment).save({
+        domain,
+        creator: user,
+        updater: user,
+        id: put.id,
+        name,
+        mimetype: file.contentType,
+        encoding: 'binary',
+        refType: exports.LIBRARY_FILE_REF_TYPE,
+        refBy: file.hash,
+        category: file.contentType.startsWith('image/') ? 'image' : 'etc',
+        size: String(put.size),
+        path: put.path,
+        ...(put.contents ? { contents: put.contents } : {})
+    });
+}
+//# sourceMappingURL=library-files.js.map

package/dist-server/service/library/library-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-files.js","sourceRoot":"","sources":["../../../server/service/library/library-files.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from 'crypto'\nimport { Readable } from 'stream'\n\nimport { Attachment, STORAGE } from '@things-factory/attachment-base'\n\n/** Attachments that hold the files imported releases depend on, one per (domain, content hash). */\nexport const LIBRARY_FILE_REF_TYPE = 'figure-library-file'\n\nexport const sha256Of = (bytes: Uint8Array) => createHash('sha256').update(bytes).digest('hex')\n\n/** Where the bytes go: attachment-base's storage. Tests give another. */\nexport interface LibraryFiles {\n  put(bytes: Buffer, mimetype: string, name: string, context: any): Promise<{ id: string; path: string; size: number; contents?: Buffer }>\n  read(path: string): Promise<Buffer>\n}\n\nexport const attachmentFiles: LibraryFiles = {\n  async put(bytes, mimetype, name, context) {\n    const file = Promise.resolve({ createReadStream: () => Readable.from([bytes]), filename: name, mimetype, encoding: 'binary' })\n    const { id, path, size, contents } = await STORAGE.uploadFile({ file, context })\n    return { id, path, size, contents }\n  },\n  read: async path => Buffer.from(await STORAGE.readFile(path))\n}\n\nlet inUse: LibraryFiles = attachmentFiles\nexport const libraryFiles = (): LibraryFiles => inUse\n/** For tests: use these files until set back; returns the ones it replaced. */\nexport function useLibraryFiles(files: LibraryFiles): LibraryFiles {\n  const was = inUse\n  inUse = files\n  return was\n}\n\ntype Tx = { getRepository: (target: any) => any }\n\n/** The attachment holding this content in this domain, or undefined. */\nexport async function libraryFileOf(tx: Tx, domainId: string, hash: string): Promise<Attachment | undefined> {\n  return (await tx.getRepository(Attachment).findOne({ where: { domain: { id: domainId }, refType: LIBRARY_FILE_REF_TYPE, refBy: hash } })) ?? undefined\n}\n\n/** Keeps one dependency file under its hash; a file already kept in this domain is not written again. */\nexport async function keepLibraryFile(\n  tx: Tx,\n  domain: { id: string },\n  user: unknown,\n  file: { hash: string; bytes: Uint8Array; contentType: string },\n  files: LibraryFiles = libraryFiles()\n): Promise<void> {\n  if (await libraryFileOf(tx, domain.id, file.hash)) return\n  const ext = file.contentType.split('/')[1]?.split('+')[0] || 'bin'\n  const name = `${file.hash}.${ext}`\n  const put = await files.put(Buffer.from(file.bytes), file.contentType, name, { state: { domain, user, tx } })\n  await tx.getRepository(Attachment).save({\n    domain,\n    creator: user,\n    updater: user,\n    id: put.id,\n    name,\n    mimetype: file.contentType,\n    encoding: 'binary',\n    refType: LIBRARY_FILE_REF_TYPE,\n    refBy: file.hash,\n    category: file.contentType.startsWith('image/') ? 'image' : 'etc',\n    size: String(put.size),\n    path: put.path,\n    ...(put.contents ? { contents: put.contents } : {})\n  })\n}\n"]}

package/dist-server/service/library/type-map.d.ts

@@ -0,0 +1,35 @@
+import { EntityManager } from 'typeorm';
+import { FigureLibraryRelease } from '../figure-library-release/figure-library-release';
+import { FigureTypeMap, FigureTypeMapState } from '../figure-type-map/figure-type-map';
+import { FigureTypeMapEntry } from '../figure-type-map/figure-type-map-entry';
+type Domain = {
+    id: string;
+};
+/** The full name a release is the release of. */
+export declare const fullNameOf: (release: Pick<FigureLibraryRelease, "namespace" | "type">) => string;
+export declare function mapOfState(tx: EntityManager, domain: Domain, state: FigureTypeMapState): Promise<FigureTypeMap | null>;
+export declare function entriesOf(tx: EntityManager, map: FigureTypeMap): Promise<FigureTypeMapEntry[]>;
+/**
+ * The domain's candidate. With `create`, a domain without one gets a new release numbered after the last, holding the
+ * active map's lines (ADR-0114 결정 6: editing starts from what draws now).
+ */
+export declare function candidateOf(tx: EntityManager, domain: Domain, user: unknown, create: boolean): Promise<FigureTypeMap | null>;
+export interface CandidateLine {
+    name: string;
+    releaseId: string;
+}
+/**
+ * Checks lines against the library (ADR-0114 결정 15): one line per name, a release of this domain's library, and the
+ * release of that very name. Refused whole by the first fault, named.
+ */
+export declare function assertLines(tx: EntityManager, domain: Domain, lines: readonly CandidateLine[]): Promise<Map<string, FigureLibraryRelease>>;
+/** Replaces the candidate's lines; each save raises the revision an open preview compares (결정 12). */
+export declare function saveCandidate(tx: EntityManager, domain: Domain, user: unknown, lines: readonly CandidateLine[], description?: string): Promise<FigureTypeMap>;
+/** Puts an imported release into the candidate: a new line, or its figure's line moved to it (결정 7). */
+export declare function putIntoCandidate(tx: EntityManager, domain: Domain, user: unknown, release: FigureLibraryRelease): Promise<void>;
+/**
+ * Makes a release ACTIVE in one transaction: the candidate after a check, or an ARCHIVED one to roll back. The active
+ * one before becomes ARCHIVED; a candidate left aside by a roll back stays a candidate (ADR-0114 결정 6).
+ */
+export declare function activate(tx: EntityManager, domain: Domain, user: unknown, version: number): Promise<FigureTypeMap>;
+export {};