@things-factory/figure-service 10.1.117 → 10.1.122

package/dist-server/service/figure/figure-package-export.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FIGURE_PACKAGE_MAX = void 0;
+exports.figurePackageOf = figurePackageOf;
+const tslib_1 = require("tslib");
+const jszip_1 = tslib_1.__importDefault(require("jszip"));
+const typeorm_1 = require("typeorm");
+const figure_model_1 = require("@hatiolab/figure-model");
+const shell_1 = require("@things-factory/shell");
+const figure_js_1 = require("./figure.js");
+const figure_history_js_1 = require("./figure-history.js");
+const figure_thumbnail_store_js_1 = require("./figure-thumbnail-store.js");
+/** The most releases one package carries. */
+exports.FIGURE_PACKAGE_MAX = 200;
+/**
+ * Released figures as one package file a board server imports (ADR-0114 결정 3·16).
+ *
+ * Only released versions travel, read from the release history -- the draft being edited is never exported. The
+ * figures are the ones this domain can read: its own and its parent's, the scope of `figureBlueprint`.
+ */
+async function figurePackageOf(request) {
+    const refs = [...new Set(request.refs)];
+    if (refs.length === 0 || refs.length > exports.FIGURE_PACKAGE_MAX) {
+        throw new shell_1.Refusal('figure-package-size', { count: refs.length, max: exports.FIGURE_PACKAGE_MAX }, 'a package carries 1 to {max} releases, not {count}.');
+    }
+    const files = request.files ?? (0, figure_thumbnail_store_js_1.thumbnailFiles)();
+    const releases = [];
+    const blobs = new Map();
+    for (const text of refs) {
+        const ref = (0, figure_model_1.parseFigureRef)(text);
+        if (!ref)
+            throw new shell_1.Refusal('figure-ref-malformed', { ref: text }, '{ref} is not a release reference of the form namespace/type@version.');
+        const { figure, history } = await releaseOf(ref, request.domain);
+        if (history.thumbnailHash && !blobs.has(history.thumbnailHash)) {
+            const picture = await (0, figure_thumbnail_store_js_1.thumbnailAttachmentOf)({ getRepository: shell_1.getRepository }, figure.domainId, history.thumbnailHash);
+            if (picture) {
+                const bytes = await files.read(picture.path);
+                if ((0, figure_thumbnail_store_js_1.sha256Of)(bytes) === history.thumbnailHash)
+                    blobs.set(history.thumbnailHash, { bytes, contentType: picture.mimetype });
+            }
+        }
+        releases.push(packageReleaseOf(ref, figure, history, blobs));
+    }
+    const packed = (0, figure_model_1.writeFigurePackage)({
+        source: { url: request.sourceUrl, domain: request.domain.subdomain ?? '' },
+        exportedAt: (request.now ?? new Date()).toISOString(),
+        exportedBy: request.exportedBy,
+        releases,
+        blobs
+    }, bytes => (0, figure_thumbnail_store_js_1.sha256Of)(Buffer.from(bytes)));
+    const zip = new jszip_1.default();
+    for (const [path, bytes] of packed)
+        zip.file(path, bytes, { createFolders: false });
+    const bytes = await zip.generateAsync({ type: 'nodebuffer', compression: 'DEFLATE' });
+    const name = refs.length === 1 ? `${refs[0].replace(/[/@]/g, '_')}.figpkg` : `figures-${refs.length}.figpkg`;
+    return { name, bytes };
+}
+async function releaseOf(ref, domain) {
+    const figure = await (0, shell_1.getRepository)(figure_js_1.Figure).findOne({
+        where: { domain: { id: (0, typeorm_1.In)([domain.id, domain.parentId].filter(Boolean)) }, type: ref.type, namespace: ref.namespace }
+    });
+    const history = figure
+        ? await (0, shell_1.getRepository)(figure_history_js_1.FigureHistory).findOne({ where: { originalId: figure.id, state: 'released', version: ref.version } })
+        : null;
+    if (!figure || !history?.source) {
+        throw new shell_1.Refusal('figure-package-release-not-found', { ref: (0, figure_model_1.formatFigureRef)(ref) }, '{ref} is not a release this domain can read.');
+    }
+    return { figure, history };
+}
+function packageReleaseOf(ref, figure, history, blobs) {
+    const json = (text) => (text ? JSON.parse(text) : null);
+    return {
+        ref: (0, figure_model_1.formatFigureRef)(ref),
+        name: history.name ?? figure.name ?? (0, figure_model_1.formatFigureRef)(ref),
+        names: history.names ?? null,
+        description: history.description ?? null,
+        category: history.category ?? null,
+        source: history.source,
+        assetFormat: history.assetFormat ?? json(history.source)?.version ?? '',
+        kernelVersion: history.kernelVersion ?? null,
+        metrics: json(history.metrics),
+        topView: json(history.topView),
+        changes: json(history.changes),
+        thumbnail: history.thumbnailHash && blobs.has(history.thumbnailHash) ? history.thumbnailHash : null,
+        deprecated: !!figure.deprecated,
+        supersededBy: figure.supersededBy && figure.namespace ? `${figure.namespace}/${figure.supersededBy}` : null,
+        releasedAt: new Date(history.createdAt ?? Date.now()).toISOString()
+    };
+}
+//# sourceMappingURL=figure-package-export.js.map

package/dist-server/service/figure/figure-package-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figure-package-export.js","sourceRoot":"","sources":["../../../server/service/figure/figure-package-export.ts"],"names":[],"mappings":"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","sourcesContent":["import JSZip from 'jszip'\nimport { In } from 'typeorm'\n\nimport {\n  formatFigureRef,\n  parseFigureRef,\n  writeFigurePackage,\n  type FigurePackageBlobFile,\n  type FigurePackageRelease,\n  type FigureRef\n} from '@hatiolab/figure-model'\nimport { getRepository, Refusal } from '@things-factory/shell'\n\nimport { Figure } from './figure.js'\nimport { FigureHistory } from './figure-history.js'\nimport { sha256Of, thumbnailAttachmentOf, thumbnailFiles, type ThumbnailFiles } from './figure-thumbnail-store.js'\n\n/** The most releases one package carries. */\nexport const FIGURE_PACKAGE_MAX = 200\n\nexport interface FigurePackageRequest {\n  readonly refs: readonly string[]\n  readonly domain: { id: string; parentId?: string; subdomain?: string }\n  readonly exportedBy: string | null\n  /** The address a board server can get these releases from again (`figure.publicUrl`). */\n  readonly sourceUrl: string\n  readonly now?: Date\n  readonly files?: ThumbnailFiles\n}\n\n/**\n * Released figures as one package file a board server imports (ADR-0114 결정 3·16).\n *\n * Only released versions travel, read from the release history -- the draft being edited is never exported. The\n * figures are the ones this domain can read: its own and its parent's, the scope of `figureBlueprint`.\n */\nexport async function figurePackageOf(request: FigurePackageRequest): Promise<{ name: string; bytes: Buffer }> {\n  const refs = [...new Set(request.refs)]\n  if (refs.length === 0 || refs.length > FIGURE_PACKAGE_MAX) {\n    throw new Refusal('figure-package-size', { count: refs.length, max: FIGURE_PACKAGE_MAX }, 'a package carries 1 to {max} releases, not {count}.')\n  }\n\n  const files = request.files ?? thumbnailFiles()\n  const releases: FigurePackageRelease[] = []\n  const blobs = new Map<string, FigurePackageBlobFile>()\n\n  for (const text of refs) {\n    const ref = parseFigureRef(text)\n    if (!ref) throw new Refusal('figure-ref-malformed', { ref: text }, '{ref} is not a release reference of the form namespace/type@version.')\n    const { figure, history } = await releaseOf(ref, request.domain)\n    if (history.thumbnailHash && !blobs.has(history.thumbnailHash)) {\n      const picture = await thumbnailAttachmentOf({ getRepository }, figure.domainId!, history.thumbnailHash)\n      if (picture) {\n        const bytes = await files.read(picture.path)\n        if (sha256Of(bytes) === history.thumbnailHash) blobs.set(history.thumbnailHash, { bytes, contentType: picture.mimetype })\n      }\n    }\n    releases.push(packageReleaseOf(ref, figure, history, blobs))\n  }\n\n  const packed = writeFigurePackage(\n    {\n      source: { url: request.sourceUrl, domain: request.domain.subdomain ?? '' },\n      exportedAt: (request.now ?? new Date()).toISOString(),\n      exportedBy: request.exportedBy,\n      releases,\n      blobs\n    },\n    bytes => sha256Of(Buffer.from(bytes))\n  )\n\n  const zip = new JSZip()\n  for (const [path, bytes] of packed) zip.file(path, bytes, { createFolders: false })\n  const bytes = await zip.generateAsync({ type: 'nodebuffer', compression: 'DEFLATE' })\n  const name = refs.length === 1 ? `${refs[0]!.replace(/[/@]/g, '_')}.figpkg` : `figures-${refs.length}.figpkg`\n  return { name, bytes }\n}\n\nasync function releaseOf(ref: FigureRef, domain: FigurePackageRequest['domain']): Promise<{ figure: Figure; history: FigureHistory }> {\n  const figure = await getRepository(Figure).findOne({\n    where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, type: ref.type, namespace: ref.namespace }\n  })\n  const history = figure\n    ? await getRepository(FigureHistory).findOne({ where: { originalId: figure.id, state: 'released', version: ref.version } })\n    : null\n  if (!figure || !history?.source) {\n    throw new Refusal('figure-package-release-not-found', { ref: formatFigureRef(ref) }, '{ref} is not a release this domain can read.')\n  }\n  return { figure, history }\n}\n\nfunction packageReleaseOf(\n  ref: FigureRef,\n  figure: Figure,\n  history: FigureHistory,\n  blobs: ReadonlyMap<string, FigurePackageBlobFile>\n): FigurePackageRelease {\n  const json = (text: string | null | undefined) => (text ? JSON.parse(text) : null)\n  return {\n    ref: formatFigureRef(ref),\n    name: history.name ?? figure.name ?? formatFigureRef(ref),\n    names: history.names ?? null,\n    description: history.description ?? null,\n    category: history.category ?? null,\n    source: history.source!,\n    assetFormat: history.assetFormat ?? json(history.source)?.version ?? '',\n    kernelVersion: history.kernelVersion ?? null,\n    metrics: json(history.metrics),\n    topView: json(history.topView),\n    changes: json(history.changes),\n    thumbnail: history.thumbnailHash && blobs.has(history.thumbnailHash) ? history.thumbnailHash : null,\n    deprecated: !!figure.deprecated,\n    supersededBy: figure.supersededBy && figure.namespace ? `${figure.namespace}/${figure.supersededBy}` : null,\n    releasedAt: new Date(history.createdAt ?? Date.now()).toISOString()\n  }\n}\n"]}

package/dist-server/service/figure/figure-query.d.ts

@@ -78,4 +78,12 @@ export declare class FigureQuery {
      * 그 문을 낼 사람이 이 단락을 읽고 그때 정하면 된다.
      */
     figureBlueprint(type: string, context: ResolverContext, pinned?: number): Promise<any>;
+    /**
+     * Released figures a board asks for together, by full name `{namespace}/{type}` (ADR-0114 결정 14).
+     *
+     * One answer per name: an item, or a refusal that names why. A refusal never takes another item away -- the board
+     * draws what it got and a stand-in with the reason for the rest. This server keeps its policy: the latest release,
+     * shadowed by the child domain as `figureBlueprint` does. `release` is null; a type map is the board server's.
+     */
+    figureBlueprints(types: string[], context: ResolverContext): Promise<any>;
 }

package/dist-server/service/figure/figure-query.js

@@ -6,6 +6,7 @@ const typeorm_1 = require("typeorm");
 const type_graphql_1 = require("type-graphql");
 const graphql_scalars_1 = require("graphql-scalars");
 const shell_1 = require("@things-factory/shell");
+const figure_model_1 = require("@hatiolab/figure-model");
 const figure_js_1 = require("./figure.js");
 const figure_history_js_1 = require("./figure-history.js");
 const figure_format_js_1 = require("./figure-format.js");
@@ -226,6 +227,49 @@ let FigureQuery = class FigureQuery {
             throw new shell_1.Refusal('figure-release-does-not-compile', { type, figureId: figure.id, version }, 'the released source of {type} does not compile. open it in the modeller and release it again.');
         }
     }
+    /**
+     * Released figures a board asks for together, by full name `{namespace}/{type}` (ADR-0114 결정 14).
+     *
+     * One answer per name: an item, or a refusal that names why. A refusal never takes another item away -- the board
+     * draws what it got and a stand-in with the reason for the rest. This server keeps its policy: the latest release,
+     * shadowed by the child domain as `figureBlueprint` does. `release` is null; a type map is the board server's.
+     */
+    async figureBlueprints(types, context) {
+        const { domain } = context.state;
+        const names = [...new Set(types)];
+        if (names.length > FIGURE_BLUEPRINTS_MAX) {
+            throw new shell_1.Refusal('figure-names-too-many', { count: names.length, max: FIGURE_BLUEPRINTS_MAX }, 'at most {max} figure names can be asked at once, not {count}.');
+        }
+        const items = [];
+        const refused = [];
+        /* Plain text: a board draws the reason on a canvas, so a name with `/` is not escaped. */
+        const refuse = (type, refusal) => refused.push({
+            type,
+            code: refusal.code,
+            message: context.t
+                ? context.t((0, shell_1.refusalKey)(refusal.code), { ...refusal.params, defaultValue: refusal.message, interpolation: { escapeValue: false } })
+                : refusal.message
+        });
+        for (const type of names) {
+            const name = (0, figure_model_1.parseFigureName)(type);
+            if (!name) {
+                refuse(type, new shell_1.Refusal('figure-name-malformed', { type }, '{type} is not a full figure name of the form namespace/type.'));
+                continue;
+            }
+            const found = (await releasedSourceOfName(domain.id, name)) ?? (domain.parentId ? await releasedSourceOfName(domain.parentId, name) : null);
+            if (!found) {
+                refuse(type, new shell_1.Refusal('figure-not-released', { type }, 'no release is published here.'));
+                continue;
+            }
+            try {
+                items.push({ type, ref: (0, figure_model_1.formatFigureRef)({ ...name, version: found.version }), asset: (0, figure_format_js_1.consumablePayloadOf)(found.source).asset });
+            }
+            catch {
+                refuse(type, new shell_1.Refusal('figure-release-does-not-compile', { type, figureId: found.figure.id, version: found.version }, 'the released source of {type} does not compile. open it in the modeller and release it again.'));
+            }
+        }
+        return { release: null, items, refused };
+    }
 };
 exports.FigureQuery = FigureQuery;
 tslib_1.__decorate([
@@ -324,10 +368,27 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:paramtypes", [String, Object, Number]),
     tslib_1.__metadata("design:returntype", Promise)
 ], FigureQuery.prototype, "figureBlueprint", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "figure-published", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => graphql_scalars_1.GraphQLJSON, {
+        description: 'Released figures asked together by full name {namespace}/{type}: { release: null, items: [{ type, ref, asset }], refused: [{ type, code, message }] }. The latest release of each; one refusal never removes another item.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('types', type => [String], { description: 'Full figure names {namespace}/{type}. At most 500.' })),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Array, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FigureQuery.prototype, "figureBlueprints", null);
 exports.FigureQuery = FigureQuery = tslib_1.__decorate([
     (0, type_graphql_1.Resolver)(figure_js_1.Figure),
     (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
 ], FigureQuery);
+const FIGURE_BLUEPRINTS_MAX = 500;
+/** The released source of a full name in one domain: the type there, published under that namespace. */
+async function releasedSourceOfName(domainId, name) {
+    const found = await releasedSourceOf(domainId, name.type);
+    return found && found.figure.namespace === name.namespace ? found : null;
+}
 /** One numbered release of a figure, or null when it has none by that number. */
 async function releaseNumbered(figure, version) {
     const row = await (0, shell_1.getRepository)(figure_history_js_1.FigureHistory).findOne({

package/dist-server/service/figure/figure-query.js.map

@@ -1 +1 @@
-{"version":3,"file":"figure-query.js","sourceRoot":"","sources":["../../../server/service/figure/figure-query.ts"],"names":[],"mappings":"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","sourcesContent":["import { In } from 'typeorm'\nimport { Args, Arg, Ctx, Directive, Int, Query, Resolver, UseMiddleware } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\n\nimport {\n  Domain,\n  getQueryBuilderFromListParams,\n  getRepository,\n  ListParam,\n  Refusal,\n  SpeakRefusals\n} from '@things-factory/shell'\n\nimport { Figure } from './figure.js'\nimport { FigureHistory } from './figure-history.js'\nimport { consumablePayloadOf, inspectSource } from './figure-format.js'\nimport { FigureInspection, FigureList, FigureProposalOutcome } from './figure-type.js'\nimport { FigureReplacedDraft } from './figure-replaced-draft.js'\nimport { replacedDraftsOf } from './figure-revert.js'\nimport { proposalOutcomeOf } from './figure-proposal.js'\n\n@Resolver(Figure)\n@UseMiddleware(SpeakRefusals)\nexport class FigureQuery {\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => Figure, { nullable: true, description: 'Finds a single figure by its ID.' })\n  async figure(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<Figure> {\n    const { domain } = context.state\n\n    // 부모 도메인의 Figure 도 보인다 — Board 와 같은 범위 규칙이다.\n    return await getRepository(Figure).findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id }\n    })\n  }\n\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => FigureList, { description: 'Lists figures. Sortable by score, triangles, name, updatedAt.' })\n  async figures(@Args() params: ListParam, @Ctx() context: ResolverContext): Promise<FigureList> {\n    const { domain } = context.state\n\n    const queryBuilder = getQueryBuilderFromListParams({\n      repository: getRepository(Figure),\n      params,\n      domain,\n      alias: 'figure',\n      /*\n        `tags` 도 찾을 수 있어야 한다 — 태그의 값은 붙이는 데 있지 않고 **찾는 데** 있다.\n\n        `simple-json` 이라 칸에는 `[\"반출\",\"자동\"]` 이 통째로 들어 있고, LIKE 는 그 글자를\n        본다. 「반출」로 찾으면 걸린다. 정확히 그 태그만 걸리는 것은 아니지만(이름에 「반출」이\n        든 도형도 걸린다) 찾기로는 그것이 오히려 낫다.\n      */\n      searchables: ['type', 'name', 'description', 'category', 'tags']\n    })\n\n    const [items, total] = await queryBuilder.getManyAndCount()\n\n    return { items, total }\n  }\n\n  /**\n   * 등록된 타입 이름 목록.\n   *\n   * 저작 화면이 **새 타입 이름이 이미 쓰이는지** 물어보는 데 쓴다. `type` 은 저장되는\n   * 식별자라 만든 뒤에 고칠 수 없으므로, 만들기 전에 알려 줘야 한다.\n   *\n   * `state` 로 걸러지지 않는다 — `draft` 인 Figure 의 이름도 이미 점유된 것이다.\n   */\n  /**\n   * 발행된 판들 — 최근 것부터.\n   *\n   * 저작 중 저장은 여기 없다. 판본은 발행에서만 생기므로(`releaseFigure`), 이 목록이 곧\n   * 「이 도형이 몇 번 약속되었나」다.\n   */\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => [FigureHistory], { description: 'Released versions of a figure, newest first.' })\n  async figureVersions(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FigureHistory[]> {\n    const { domain } = context.state\n\n    return await getRepository(FigureHistory).find({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, originalId: id },\n      relations: ['updater'],\n      order: { version: 'DESC' },\n      take: 10\n    })\n  }\n\n  /**\n   * 지금 소비처가 쓰는 판.\n   *\n   * 도형의 현재 정본은 저작 중일 수 있다(초안). 배치된 것이 보는 것은 **마지막으로 발행된 판**이고,\n   * 그것을 이 자리가 답한다.\n   */\n  /** What became of an AI proposal: the figures a save put it into (ADR-0097 §5.6 item 5). */\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => [FigureProposalOutcome], {\n    description: 'The figures an AI proposal was saved into, oldest first. None: it was not saved, or not in this domain.'\n  })\n  async figureProposalOutcome(@Arg('proposalKey') proposalKey: string, @Ctx() context: ResolverContext): Promise<FigureProposalOutcome[]> {\n    const { domain, tx } = context.state\n    return await proposalOutcomeOf(getRepository(Figure, tx).manager, domain, proposalKey)\n  }\n\n  /** The drafts reverts kept for a figure, newest first -- apart from its released versions (ADR-0097 §5.6). */\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => [FigureReplacedDraft], { description: 'Drafts kept when a revert wrote over them, newest first. Not released versions.' })\n  async figureReplacedDrafts(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FigureReplacedDraft[]> {\n    const { domain, tx } = context.state\n    return await replacedDraftsOf(getRepository(FigureReplacedDraft, tx).manager, domain, id)\n  }\n\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => FigureHistory, { nullable: true, description: 'The most recently released version of a figure.' })\n  async figureReleased(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FigureHistory> {\n    const { domain } = context.state\n\n    return await getRepository(FigureHistory).findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, originalId: id },\n      order: { version: 'DESC' }\n    })\n  }\n\n  /**\n   * 발행해도 되나 — **누르기 전에** 묻는 자리.\n   *\n   * 판정은 `figure-gate.ts` 가 하고 이 자리는 정본을 꺼내 넘긴다. 같은 판정을 `releaseFigure` 도\n   * 부른다 — 화면이 물어 보고 통과했더라도 그 사이에 정본이 바뀌었을 수 있으므로, 막는 것은 언제나\n   * 뮤테이션이다. 이 질의는 **이유를 미리 보여 주기 위한 것**이고 허가증이 아니다.\n   */\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => FigureInspection, { description: 'Whether a figure may be released, with the reasons.' })\n  async inspectFigure(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FigureInspection> {\n    const { domain } = context.state\n\n    const figure = await getRepository(Figure).findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id },\n      /*\n        `type` is read too. A asset carries no type, so the temporary-type refusal reads the row's; with only\n        id and source selected it saw `undefined`, the panel enabled 「발행하기」, and the release mutation — which\n        loads the whole row — refused on the press (2026-09-24).\n      */\n      select: { id: true, source: true, type: true }\n    })\n\n    if (!figure) {\n      throw new Error(`Figure ${id} 를 찾을 수 없다`)\n    }\n\n    /*\n      **화면이 발행 문과 같은 것을 본다.** 직전 발행판을 여기서도 함께 넘기지 않으면, 저작 화면은\n      조용한데 발행을 누른 순간 계약 위반으로 막힌다 — 그때는 이미 열 군데를 고친 뒤다.\n    */\n    const released = await getRepository(FigureHistory)\n      .createQueryBuilder('history')\n      .where('history.originalId = :id', { id })\n      .orderBy('history.version', 'DESC')\n      .limit(1)\n      .getOne()\n\n    return inspectSource(figure.source, released?.source, context.t, figure.type)\n  }\n\n  /**\n   * The same judgement for a source that has not been saved — what the modeller shows **while** the author edits.\n   *\n   * Without it a author saw nothing until they saved and opened the release panel. The judgement runs here, not\n   * in the browser, because the sentences are made from the request's language (`inspectAnySource` with `context.t`)\n   * and a second copy on the screen would drift from the one the release refuses with. When `id` names a saved\n   * figure, its row type and last release are read as `inspectFigure` does; a figure never saved has neither.\n   */\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => FigureInspection, { description: 'Whether an unsaved figure source would be released, with the reasons.' })\n  async inspectFigureDraft(\n    @Arg('source') source: string,\n    @Ctx() context: ResolverContext,\n    @Arg('id', { nullable: true }) id?: string\n  ): Promise<FigureInspection> {\n    const { domain } = context.state\n    if (!id) return inspectSource(source, null, context.t)\n\n    const figure = await getRepository(Figure).findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id },\n      select: { id: true, type: true }\n    })\n    if (!figure) throw new Error(`Figure ${id} 를 찾을 수 없다`)\n\n    const released = await getRepository(FigureHistory)\n      .createQueryBuilder('history')\n      .where('history.originalId = :id', { id })\n      .orderBy('history.version', 'DESC')\n      .limit(1)\n      .getOne()\n\n    return inspectSource(source, released?.source, context.t, figure.type)\n  }\n\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => [String], { description: 'All figure type names in scope — used to check name collisions before create.' })\n  async figureTypeNames(@Ctx() context: ResolverContext): Promise<string[]> {\n    const { domain } = context.state\n\n    const rows = await getRepository(Figure).find({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) } },\n      select: { type: true }\n    })\n\n    return rows.map(r => r.type).filter(Boolean)\n  }\n\n  /**\n   * 소비처(operato-board, operato-twin, things-scene)가 발행된 도형을 받아 가는 문.\n   *\n   * 이름은 보드와의 계약이라 그대로 둔다(바꾸는 일은 따로 한다). 돌려주는 것은 자산이다 —\n   * `{ type, asset }`. 그리는 쪽(`registerFigure`)이 커널로 컴파일한다.\n   *\n   * ## 규칙\n   * 1. 소비처는 초안(draft)을 볼 수 없다 — **반드시 발행된(released) 판만 전달**한다.\n   * 2. 현재 Figure가 released 상태이면 현재 source를 넘긴다.\n   * 3. 현재 Figure가 저작 중(draft)이더라도 이전에 발행된 이력(FigureHistory)이 있으면\n   *    가장 최근의 released 판본을 넘긴다.\n   * 4. 한 번도 발행된 적 없는 초안 자산이거나 존재하지 않는 타입인 경우 null을 반환하여\n   *    미완성 자산이 씬 화면에 유출되는 것을 엄격히 차단한다.\n   * 5. 도메인 상속 시 자식 도메인의 타입이 부모 도메인의 동일 타입을 항상 오버라이드한다.\n   * 6. 권한은 저작(`figure`)과 **다른 category** 인 `figure-published` 다. 소비처 사용자에게\n   *    저작 권한을 요구하면 board·twin 의 팔레트가 안 뜨고, 그렇다고 선언을 비우면 이 집에서는\n   *    로그인조차 안 한 사람에게 열린다(`auth-rebuild.md` §1). `<module>-published` 는\n   *    「그 모듈이 발행한 것을 남이 읽는 문」이라는 규약이다 — 아키텍트 판정(2026-09-15).\n   *\n   * ## 열거는 막혀 있다 — 지금은 우연이다\n   *\n   * 이 문의 열쇠는 `type` 하나뿐이라 이름을 모르면 못 꺼낸다. 그런데 그것이 **설계가 아니다** —\n   * 목록을 내는 `figures`·`figureTypeNames` 가 `figure` category 로 잠겨 있어서 결과적으로\n   * 그런 것뿐이다. 나중에 누가 소비처용 목록 문을 하나 더 열고 `figure-published` 를 붙이면\n   * 열거가 함께 열리고, 「이름을 알아야 한다」에 기대고 있던 가정이 조용히 사라진다.\n   * 그 문을 낼 사람이 이 단락을 읽고 그때 정하면 된다.\n   */\n  /*\n    This directive is attached by schema assembly, so a test that calls the resolver method\n    directly never exercises it. `figure-blueprint-query.test.ts` reads this source for the\n    declaration instead — see the test named for it there.\n  */\n  @Directive('@privilege(category: \"figure-published\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => GraphQLJSON, {\n    nullable: true,\n    description:\n      'A released figure for its consumers (board, twin, things-scene): { type, version, asset }. The latest release, or the one numbered `version` for a consumer that pins releases (ADR-0104). Only returns released figures.'\n  })\n  async figureBlueprint(\n    @Arg('type') type: string,\n    @Ctx() context: ResolverContext,\n    @Arg('version', type => Int, { nullable: true, description: 'A release number. Absent: the latest release.' }) pinned?: number\n  ): Promise<any> {\n    const { domain } = context.state\n\n    /*\n      A child domain shadows the same type in its parent, which is how a tenant replaces the standard\n      CONVEYOR with its own. Only a released version shadows. When the child has just a draft, the\n      parent's release is used, so starting a draft never makes placed figures disappear (chief\n      architect ruling, 2026-09-17). This used to skip the fallback as soon as a child row existed and\n      return null.\n    */\n    const latest =\n      (await releasedSourceOf(domain.id, type)) ?? (domain.parentId ? await releasedSourceOf(domain.parentId, type) : null)\n\n    if (!latest) {\n      return null\n    }\n\n    /*\n      A pinned release is read from the same figure the latest comes from -- the shadowing rule decides whose\n      releases these are, then the number picks one. Releases are never deleted, so a number once handed out is\n      always there; a number that never was is refused by name rather than answered with another release.\n    */\n    const found = pinned === undefined || pinned === null || pinned === latest.version ? latest : await releaseNumbered(latest.figure, pinned)\n    if (!found) {\n      throw new Refusal(\n        'figure-release-not-found',\n        { type, version: pinned, latest: latest.version },\n        '{type} has no release {version}. its latest release is {latest}.'\n      )\n    }\n\n    const { figure, source: sourceToCompile, version } = found\n\n    try {\n      const text = typeof sourceToCompile === 'string' ? sourceToCompile : JSON.stringify(sourceToCompile)\n      return { type, version, asset: consumablePayloadOf(text).asset }\n    } catch (err) {\n      console.error(`[figureBlueprint] 타입 '${type}' (figure id: ${figure.id}) 자산 컴파일 실패:`, err)\n\n      /*\n        Null says one thing here: nobody published this type (ADR-0063 결정 2 보탬). A released figure\n        whose stored source no longer compiles is a different fact, and answering null for it makes the\n        board draw a stand-in with the reason nowhere on screen — the author published, the catalogue\n        says released, and the only trace is the line above. That is the silence ADR-0053 refuses.\n\n        The board asks per type inside a Promise.all and collects a rejection into `failed`, so this\n        refusal costs that one figure its drawing and the scene still opens.\n      */\n      throw new Refusal(\n        'figure-release-does-not-compile',\n        { type, figureId: figure.id, version },\n        'the released source of {type} does not compile. open it in the modeller and release it again.'\n      )\n    }\n  }\n}\n\n/** One numbered release of a figure, or null when it has none by that number. */\nasync function releaseNumbered(figure: Figure, version: number): Promise<{ figure: Figure; source: string; version: number } | null> {\n  const row = await getRepository(FigureHistory).findOne({\n    where: { originalId: figure.id, state: 'released', version }\n  })\n  return row?.source ? { figure, source: row.source, version: row.version } : null\n}\n\n/**\n * Finds the released source of a type in one domain, or null.\n *\n * A released row gives its own source; a draft row gives the source of its latest released history.\n * A figure that was never released gives null, because drafts never reach consumers.\n */\nasync function releasedSourceOf(\n  domainId: string,\n  type: string\n): Promise<{ figure: Figure; source: string; version: number } | null> {\n  const figure = await getRepository(Figure).findOne({ where: { domain: { id: domainId }, type } })\n  if (!figure) return null\n\n  if (figure.state === 'released' && figure.source) {\n    return { figure, source: figure.source, version: figure.version }\n  }\n\n  const latestReleased = await getRepository(FigureHistory).findOne({\n    where: { domain: { id: domainId }, originalId: figure.id, state: 'released' },\n    order: { version: 'DESC' }\n  })\n\n  /* The version travels with the source: a refusal names the edition that does not compile, and the\n     row's own version is the draft being edited, not the one the board was handed. */\n  return latestReleased?.source\n    ? { figure, source: latestReleased.source, version: latestReleased.version }\n    : null\n}\n"]}
+{"version":3,"file":"figure-query.js","sourceRoot":"","sources":["../../../server/service/figure/figure-query.ts"],"names":[],"mappings":"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","sourcesContent":["import { In } from 'typeorm'\nimport { Args, Arg, Ctx, Directive, Int, Query, Resolver, UseMiddleware } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\n\nimport {\n  Domain,\n  getQueryBuilderFromListParams,\n  getRepository,\n  ListParam,\n  Refusal,\n  SpeakRefusals,\n  refusalKey\n} from '@things-factory/shell'\nimport { formatFigureRef, parseFigureName, type FigureName } from '@hatiolab/figure-model'\n\nimport { Figure } from './figure.js'\nimport { FigureHistory } from './figure-history.js'\nimport { consumablePayloadOf, inspectSource } from './figure-format.js'\nimport { FigureInspection, FigureList, FigureProposalOutcome } from './figure-type.js'\nimport { FigureReplacedDraft } from './figure-replaced-draft.js'\nimport { replacedDraftsOf } from './figure-revert.js'\nimport { proposalOutcomeOf } from './figure-proposal.js'\n\n@Resolver(Figure)\n@UseMiddleware(SpeakRefusals)\nexport class FigureQuery {\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => Figure, { nullable: true, description: 'Finds a single figure by its ID.' })\n  async figure(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<Figure> {\n    const { domain } = context.state\n\n    // 부모 도메인의 Figure 도 보인다 — Board 와 같은 범위 규칙이다.\n    return await getRepository(Figure).findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id }\n    })\n  }\n\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => FigureList, { description: 'Lists figures. Sortable by score, triangles, name, updatedAt.' })\n  async figures(@Args() params: ListParam, @Ctx() context: ResolverContext): Promise<FigureList> {\n    const { domain } = context.state\n\n    const queryBuilder = getQueryBuilderFromListParams({\n      repository: getRepository(Figure),\n      params,\n      domain,\n      alias: 'figure',\n      /*\n        `tags` 도 찾을 수 있어야 한다 — 태그의 값은 붙이는 데 있지 않고 **찾는 데** 있다.\n\n        `simple-json` 이라 칸에는 `[\"반출\",\"자동\"]` 이 통째로 들어 있고, LIKE 는 그 글자를\n        본다. 「반출」로 찾으면 걸린다. 정확히 그 태그만 걸리는 것은 아니지만(이름에 「반출」이\n        든 도형도 걸린다) 찾기로는 그것이 오히려 낫다.\n      */\n      searchables: ['type', 'name', 'description', 'category', 'tags']\n    })\n\n    const [items, total] = await queryBuilder.getManyAndCount()\n\n    return { items, total }\n  }\n\n  /**\n   * 등록된 타입 이름 목록.\n   *\n   * 저작 화면이 **새 타입 이름이 이미 쓰이는지** 물어보는 데 쓴다. `type` 은 저장되는\n   * 식별자라 만든 뒤에 고칠 수 없으므로, 만들기 전에 알려 줘야 한다.\n   *\n   * `state` 로 걸러지지 않는다 — `draft` 인 Figure 의 이름도 이미 점유된 것이다.\n   */\n  /**\n   * 발행된 판들 — 최근 것부터.\n   *\n   * 저작 중 저장은 여기 없다. 판본은 발행에서만 생기므로(`releaseFigure`), 이 목록이 곧\n   * 「이 도형이 몇 번 약속되었나」다.\n   */\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => [FigureHistory], { description: 'Released versions of a figure, newest first.' })\n  async figureVersions(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FigureHistory[]> {\n    const { domain } = context.state\n\n    return await getRepository(FigureHistory).find({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, originalId: id },\n      relations: ['updater'],\n      order: { version: 'DESC' },\n      take: 10\n    })\n  }\n\n  /**\n   * 지금 소비처가 쓰는 판.\n   *\n   * 도형의 현재 정본은 저작 중일 수 있다(초안). 배치된 것이 보는 것은 **마지막으로 발행된 판**이고,\n   * 그것을 이 자리가 답한다.\n   */\n  /** What became of an AI proposal: the figures a save put it into (ADR-0097 §5.6 item 5). */\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => [FigureProposalOutcome], {\n    description: 'The figures an AI proposal was saved into, oldest first. None: it was not saved, or not in this domain.'\n  })\n  async figureProposalOutcome(@Arg('proposalKey') proposalKey: string, @Ctx() context: ResolverContext): Promise<FigureProposalOutcome[]> {\n    const { domain, tx } = context.state\n    return await proposalOutcomeOf(getRepository(Figure, tx).manager, domain, proposalKey)\n  }\n\n  /** The drafts reverts kept for a figure, newest first -- apart from its released versions (ADR-0097 §5.6). */\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => [FigureReplacedDraft], { description: 'Drafts kept when a revert wrote over them, newest first. Not released versions.' })\n  async figureReplacedDrafts(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FigureReplacedDraft[]> {\n    const { domain, tx } = context.state\n    return await replacedDraftsOf(getRepository(FigureReplacedDraft, tx).manager, domain, id)\n  }\n\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => FigureHistory, { nullable: true, description: 'The most recently released version of a figure.' })\n  async figureReleased(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FigureHistory> {\n    const { domain } = context.state\n\n    return await getRepository(FigureHistory).findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, originalId: id },\n      order: { version: 'DESC' }\n    })\n  }\n\n  /**\n   * 발행해도 되나 — **누르기 전에** 묻는 자리.\n   *\n   * 판정은 `figure-gate.ts` 가 하고 이 자리는 정본을 꺼내 넘긴다. 같은 판정을 `releaseFigure` 도\n   * 부른다 — 화면이 물어 보고 통과했더라도 그 사이에 정본이 바뀌었을 수 있으므로, 막는 것은 언제나\n   * 뮤테이션이다. 이 질의는 **이유를 미리 보여 주기 위한 것**이고 허가증이 아니다.\n   */\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => FigureInspection, { description: 'Whether a figure may be released, with the reasons.' })\n  async inspectFigure(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FigureInspection> {\n    const { domain } = context.state\n\n    const figure = await getRepository(Figure).findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id },\n      /*\n        `type` is read too. A asset carries no type, so the temporary-type refusal reads the row's; with only\n        id and source selected it saw `undefined`, the panel enabled 「발행하기」, and the release mutation — which\n        loads the whole row — refused on the press (2026-09-24).\n      */\n      select: { id: true, source: true, type: true }\n    })\n\n    if (!figure) {\n      throw new Error(`Figure ${id} 를 찾을 수 없다`)\n    }\n\n    /*\n      **화면이 발행 문과 같은 것을 본다.** 직전 발행판을 여기서도 함께 넘기지 않으면, 저작 화면은\n      조용한데 발행을 누른 순간 계약 위반으로 막힌다 — 그때는 이미 열 군데를 고친 뒤다.\n    */\n    const released = await getRepository(FigureHistory)\n      .createQueryBuilder('history')\n      .where('history.originalId = :id', { id })\n      .orderBy('history.version', 'DESC')\n      .limit(1)\n      .getOne()\n\n    return inspectSource(figure.source, released?.source, context.t, figure.type)\n  }\n\n  /**\n   * The same judgement for a source that has not been saved — what the modeller shows **while** the author edits.\n   *\n   * Without it a author saw nothing until they saved and opened the release panel. The judgement runs here, not\n   * in the browser, because the sentences are made from the request's language (`inspectAnySource` with `context.t`)\n   * and a second copy on the screen would drift from the one the release refuses with. When `id` names a saved\n   * figure, its row type and last release are read as `inspectFigure` does; a figure never saved has neither.\n   */\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => FigureInspection, { description: 'Whether an unsaved figure source would be released, with the reasons.' })\n  async inspectFigureDraft(\n    @Arg('source') source: string,\n    @Ctx() context: ResolverContext,\n    @Arg('id', { nullable: true }) id?: string\n  ): Promise<FigureInspection> {\n    const { domain } = context.state\n    if (!id) return inspectSource(source, null, context.t)\n\n    const figure = await getRepository(Figure).findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id },\n      select: { id: true, type: true }\n    })\n    if (!figure) throw new Error(`Figure ${id} 를 찾을 수 없다`)\n\n    const released = await getRepository(FigureHistory)\n      .createQueryBuilder('history')\n      .where('history.originalId = :id', { id })\n      .orderBy('history.version', 'DESC')\n      .limit(1)\n      .getOne()\n\n    return inspectSource(source, released?.source, context.t, figure.type)\n  }\n\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => [String], { description: 'All figure type names in scope — used to check name collisions before create.' })\n  async figureTypeNames(@Ctx() context: ResolverContext): Promise<string[]> {\n    const { domain } = context.state\n\n    const rows = await getRepository(Figure).find({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) } },\n      select: { type: true }\n    })\n\n    return rows.map(r => r.type).filter(Boolean)\n  }\n\n  /**\n   * 소비처(operato-board, operato-twin, things-scene)가 발행된 도형을 받아 가는 문.\n   *\n   * 이름은 보드와의 계약이라 그대로 둔다(바꾸는 일은 따로 한다). 돌려주는 것은 자산이다 —\n   * `{ type, asset }`. 그리는 쪽(`registerFigure`)이 커널로 컴파일한다.\n   *\n   * ## 규칙\n   * 1. 소비처는 초안(draft)을 볼 수 없다 — **반드시 발행된(released) 판만 전달**한다.\n   * 2. 현재 Figure가 released 상태이면 현재 source를 넘긴다.\n   * 3. 현재 Figure가 저작 중(draft)이더라도 이전에 발행된 이력(FigureHistory)이 있으면\n   *    가장 최근의 released 판본을 넘긴다.\n   * 4. 한 번도 발행된 적 없는 초안 자산이거나 존재하지 않는 타입인 경우 null을 반환하여\n   *    미완성 자산이 씬 화면에 유출되는 것을 엄격히 차단한다.\n   * 5. 도메인 상속 시 자식 도메인의 타입이 부모 도메인의 동일 타입을 항상 오버라이드한다.\n   * 6. 권한은 저작(`figure`)과 **다른 category** 인 `figure-published` 다. 소비처 사용자에게\n   *    저작 권한을 요구하면 board·twin 의 팔레트가 안 뜨고, 그렇다고 선언을 비우면 이 집에서는\n   *    로그인조차 안 한 사람에게 열린다(`auth-rebuild.md` §1). `<module>-published` 는\n   *    「그 모듈이 발행한 것을 남이 읽는 문」이라는 규약이다 — 아키텍트 판정(2026-09-15).\n   *\n   * ## 열거는 막혀 있다 — 지금은 우연이다\n   *\n   * 이 문의 열쇠는 `type` 하나뿐이라 이름을 모르면 못 꺼낸다. 그런데 그것이 **설계가 아니다** —\n   * 목록을 내는 `figures`·`figureTypeNames` 가 `figure` category 로 잠겨 있어서 결과적으로\n   * 그런 것뿐이다. 나중에 누가 소비처용 목록 문을 하나 더 열고 `figure-published` 를 붙이면\n   * 열거가 함께 열리고, 「이름을 알아야 한다」에 기대고 있던 가정이 조용히 사라진다.\n   * 그 문을 낼 사람이 이 단락을 읽고 그때 정하면 된다.\n   */\n  /*\n    This directive is attached by schema assembly, so a test that calls the resolver method\n    directly never exercises it. `figure-blueprint-query.test.ts` reads this source for the\n    declaration instead — see the test named for it there.\n  */\n  @Directive('@privilege(category: \"figure-published\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => GraphQLJSON, {\n    nullable: true,\n    description:\n      'A released figure for its consumers (board, twin, things-scene): { type, version, asset }. The latest release, or the one numbered `version` for a consumer that pins releases (ADR-0104). Only returns released figures.'\n  })\n  async figureBlueprint(\n    @Arg('type') type: string,\n    @Ctx() context: ResolverContext,\n    @Arg('version', type => Int, { nullable: true, description: 'A release number. Absent: the latest release.' }) pinned?: number\n  ): Promise<any> {\n    const { domain } = context.state\n\n    /*\n      A child domain shadows the same type in its parent, which is how a tenant replaces the standard\n      CONVEYOR with its own. Only a released version shadows. When the child has just a draft, the\n      parent's release is used, so starting a draft never makes placed figures disappear (chief\n      architect ruling, 2026-09-17). This used to skip the fallback as soon as a child row existed and\n      return null.\n    */\n    const latest =\n      (await releasedSourceOf(domain.id, type)) ?? (domain.parentId ? await releasedSourceOf(domain.parentId, type) : null)\n\n    if (!latest) {\n      return null\n    }\n\n    /*\n      A pinned release is read from the same figure the latest comes from -- the shadowing rule decides whose\n      releases these are, then the number picks one. Releases are never deleted, so a number once handed out is\n      always there; a number that never was is refused by name rather than answered with another release.\n    */\n    const found = pinned === undefined || pinned === null || pinned === latest.version ? latest : await releaseNumbered(latest.figure, pinned)\n    if (!found) {\n      throw new Refusal(\n        'figure-release-not-found',\n        { type, version: pinned, latest: latest.version },\n        '{type} has no release {version}. its latest release is {latest}.'\n      )\n    }\n\n    const { figure, source: sourceToCompile, version } = found\n\n    try {\n      const text = typeof sourceToCompile === 'string' ? sourceToCompile : JSON.stringify(sourceToCompile)\n      return { type, version, asset: consumablePayloadOf(text).asset }\n    } catch (err) {\n      console.error(`[figureBlueprint] 타입 '${type}' (figure id: ${figure.id}) 자산 컴파일 실패:`, err)\n\n      /*\n        Null says one thing here: nobody published this type (ADR-0063 결정 2 보탬). A released figure\n        whose stored source no longer compiles is a different fact, and answering null for it makes the\n        board draw a stand-in with the reason nowhere on screen — the author published, the catalogue\n        says released, and the only trace is the line above. That is the silence ADR-0053 refuses.\n\n        The board asks per type inside a Promise.all and collects a rejection into `failed`, so this\n        refusal costs that one figure its drawing and the scene still opens.\n      */\n      throw new Refusal(\n        'figure-release-does-not-compile',\n        { type, figureId: figure.id, version },\n        'the released source of {type} does not compile. open it in the modeller and release it again.'\n      )\n    }\n  }\n\n  /**\n   * Released figures a board asks for together, by full name `{namespace}/{type}` (ADR-0114 결정 14).\n   *\n   * One answer per name: an item, or a refusal that names why. A refusal never takes another item away -- the board\n   * draws what it got and a stand-in with the reason for the rest. This server keeps its policy: the latest release,\n   * shadowed by the child domain as `figureBlueprint` does. `release` is null; a type map is the board server's.\n   */\n  @Directive('@privilege(category: \"figure-published\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => GraphQLJSON, {\n    description:\n      'Released figures asked together by full name {namespace}/{type}: { release: null, items: [{ type, ref, asset }], refused: [{ type, code, message }] }. The latest release of each; one refusal never removes another item.'\n  })\n  async figureBlueprints(\n    @Arg('types', type => [String], { description: 'Full figure names {namespace}/{type}. At most 500.' }) types: string[],\n    @Ctx() context: ResolverContext\n  ): Promise<any> {\n    const { domain } = context.state\n    const names = [...new Set(types)]\n    if (names.length > FIGURE_BLUEPRINTS_MAX) {\n      throw new Refusal('figure-names-too-many', { count: names.length, max: FIGURE_BLUEPRINTS_MAX }, 'at most {max} figure names can be asked at once, not {count}.')\n    }\n\n    const items: { type: string; ref: string; asset: unknown }[] = []\n    const refused: { type: string; code: string; message: string }[] = []\n    /* Plain text: a board draws the reason on a canvas, so a name with `/` is not escaped. */\n    const refuse = (type: string, refusal: Refusal) =>\n      refused.push({\n        type,\n        code: refusal.code,\n        message: context.t\n          ? context.t(refusalKey(refusal.code), { ...refusal.params, defaultValue: refusal.message, interpolation: { escapeValue: false } })\n          : refusal.message\n      })\n\n    for (const type of names) {\n      const name = parseFigureName(type)\n      if (!name) {\n        refuse(type, new Refusal('figure-name-malformed', { type }, '{type} is not a full figure name of the form namespace/type.'))\n        continue\n      }\n      const found =\n        (await releasedSourceOfName(domain.id, name)) ?? (domain.parentId ? await releasedSourceOfName(domain.parentId, name) : null)\n      if (!found) {\n        refuse(type, new Refusal('figure-not-released', { type }, 'no release is published here.'))\n        continue\n      }\n      try {\n        items.push({ type, ref: formatFigureRef({ ...name, version: found.version }), asset: consumablePayloadOf(found.source).asset })\n      } catch {\n        refuse(\n          type,\n          new Refusal(\n            'figure-release-does-not-compile',\n            { type, figureId: found.figure.id, version: found.version },\n            'the released source of {type} does not compile. open it in the modeller and release it again.'\n          )\n        )\n      }\n    }\n\n    return { release: null, items, refused }\n  }\n}\n\nconst FIGURE_BLUEPRINTS_MAX = 500\n\n/** The released source of a full name in one domain: the type there, published under that namespace. */\nasync function releasedSourceOfName(domainId: string, name: FigureName) {\n  const found = await releasedSourceOf(domainId, name.type)\n  return found && found.figure.namespace === name.namespace ? found : null\n}\n\n/** One numbered release of a figure, or null when it has none by that number. */\nasync function releaseNumbered(figure: Figure, version: number): Promise<{ figure: Figure; source: string; version: number } | null> {\n  const row = await getRepository(FigureHistory).findOne({\n    where: { originalId: figure.id, state: 'released', version }\n  })\n  return row?.source ? { figure, source: row.source, version: row.version } : null\n}\n\n/**\n * Finds the released source of a type in one domain, or null.\n *\n * A released row gives its own source; a draft row gives the source of its latest released history.\n * A figure that was never released gives null, because drafts never reach consumers.\n */\nasync function releasedSourceOf(\n  domainId: string,\n  type: string\n): Promise<{ figure: Figure; source: string; version: number } | null> {\n  const figure = await getRepository(Figure).findOne({ where: { domain: { id: domainId }, type } })\n  if (!figure) return null\n\n  if (figure.state === 'released' && figure.source) {\n    return { figure, source: figure.source, version: figure.version }\n  }\n\n  const latestReleased = await getRepository(FigureHistory).findOne({\n    where: { domain: { id: domainId }, originalId: figure.id, state: 'released' },\n    order: { version: 'DESC' }\n  })\n\n  /* The version travels with the source: a refusal names the edition that does not compile, and the\n     row's own version is the draft being edited, not the one the board was handed. */\n  return latestReleased?.source\n    ? { figure, source: latestReleased.source, version: latestReleased.version }\n    : null\n}\n"]}

package/dist-server/service/figure/figure-rename.js

@@ -28,7 +28,7 @@ function renameDraftType(current, wanted, facts) {
       is held to it -- every type in the development data already keeps it (56 of 56, 2026-09-27), and none is renamed.
     */
     if (!figure_model_1.TYPE_PATTERN.test(next) || next.length < figure_model_1.TYPE_LENGTH.min || next.length > figure_model_1.TYPE_LENGTH.max) {
-        throw new FigureRenameRefused('malformed-type', `type 「${next}」 는 대문자로 시작하고 대문자·숫자·밑줄만 쓰며 ${figure_model_1.TYPE_LENGTH.min}~${figure_model_1.TYPE_LENGTH.max}자여야 한다`);
+        throw new FigureRenameRefused('malformed-type', `type 「${next}」 는 소문자로 시작하고 소문자·숫자·하이픈 하나씩만 쓰며 ${figure_model_1.TYPE_LENGTH.min}~${figure_model_1.TYPE_LENGTH.max}자여야 한다`);
     }
     if ((facts.version ?? 0) > 0 || facts.hasHistory) {
         throw new FigureRenameRefused('already-released', '발행된 도형의 type 은 바꿀 수 없다 — 이미 배치된 도면이 이 이름을 가리킨다');

package/dist-server/service/figure/figure-rename.js.map

@@ -1 +1 @@
-{"version":3,"file":"figure-rename.js","sourceRoot":"","sources":["../../../server/service/figure/figure-rename.ts"],"names":[],"mappings":";;;AAiDA,0CAmCC;AAUD,kCAcC;AA5GD,yDAAkE;AAiClE,MAAa,mBAAoB,SAAQ,KAAK;IAC5C,YACW,IAAyE,EAClF,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAA;QAHL,SAAI,GAAJ,IAAI,CAAqE;QAIlF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AARD,kDAQC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAC7B,OAAyC,EACzC,MAAc,EACd,KAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;IAE1B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,mBAAmB,CAAC,YAAY,EAAE,qCAAqC,CAAC,CAAA;IACpF,CAAC;IAED;;;MAGE;IACF,IAAI,CAAC,2BAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,0BAAW,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,GAAG,0BAAW,CAAC,GAAG,EAAE,CAAC;QAC/F,MAAM,IAAI,mBAAmB,CAC3B,gBAAgB,EAChB,SAAS,IAAI,+BAA+B,0BAAW,CAAC,GAAG,IAAI,0BAAW,CAAC,GAAG,QAAQ,CACvF,CAAA;IACH,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACjD,MAAM,IAAI,mBAAmB,CAC3B,kBAAkB,EAClB,gDAAgD,CACjD,CAAA;IACH,CAAC;IAED,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,MAAM,IAAI,mBAAmB,CAAC,YAAY,EAAE,SAAS,IAAI,sBAAsB,CAAC,CAAA;IAClF,CAAC;IAED,qGAAqG;IACrG,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAA;AAC/C,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,WAAW,CAC/B,YAGC,EACD,MAAyC,EACzC,MAAsB,EACtB,MAAc;IAEd,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;IAC1B,MAAM,UAAU,GAAG,CAAC,MAAM,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;IACjG,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAEpH,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,EAAE,CAAA;AACnG,CAAC","sourcesContent":["import { TYPE_LENGTH, TYPE_PATTERN } from '@hatiolab/figure-model'\n/**\n * 초안의 타입을 고치는 규칙 — ADR-0063 결정 4.\n *\n * ## 왜 발행 전에만인가\n *\n * `type` 은 도면에 적히는 이름이다. 도면은 `{ type, left, top, width, height }` 만 갖고 늘 최신\n * 발행판을 그리므로, 발행된 도형의 이름을 바꾸면 이미 배치된 도면이 아무 오류 없이 빈 자리가\n * 된다. 한 번도 발행되지 않은 도형은 그려질 자리가 없으니 가리키는 도면도 있을 수 없다.\n *\n * ## 왜 열어야 했나\n *\n * 닫아 두었더니 저작자가 이름을 **한 번도** 정하지 못했다. 새 Figure 에는 기계가 지은 이름이\n * 붙고(`FIGURE_MU6RJH47`) 칸에 자물쇠가 걸려서, 그 이름이 그대로 도면에 적히는 이름이 됐다.\n * 그렇게 남은 초안이 14 개다.\n *\n * ## 셈은 여기, 질의는 부르는 쪽\n *\n * 이 파일은 저장소를 모른다 — 판 번호 · 이력 유무 · 같은 이름의 주인을 **사실로 받는다.**\n * 그래야 규칙을 DB 없이 시험한다. 문(`figure-mutation.ts`)이 그 셋을 읽어 넘긴다.\n */\n\n\n/** 이름을 바꿀 때 알아야 하는 사실. 부르는 쪽이 저장소에서 읽어 온다. */\nexport interface RenameFacts {\n  /** 발행 판 번호. 0 이면 한 번도 발행되지 않았다. */\n  version?: number\n  /** 판본이 하나라도 있나. 되돌리기로 판 번호가 도로 낮아져도 이력은 남는다. */\n  hasHistory: boolean\n  /** 같은 도메인에서 그 이름을 이미 쓰는 **다른** 도형이 있나. */\n  takenByAnother: boolean\n}\n\nexport class FigureRenameRefused extends Error {\n  constructor(\n    readonly code: 'empty-type' | 'malformed-type' | 'already-released' | 'type-taken',\n    message: string\n  ) {\n    super(message)\n    this.name = 'FigureRenameRefused'\n  }\n}\n\n/**\n * 고친 이름과 정본. 못 고치면 **까닭과 함께 던진다** — 조용히 옛 이름으로 두지 않는다.\n *\n * 정본 안에도 `type` 이 있어서 함께 고친다. 한쪽만 고치면 저장된 JSON 과 행이 다른 이름을\n * 말하고, 발행할 때 어느 쪽이 도면에 적히는지가 갈린다.\n */\nexport function renameDraftType(\n  current: { type: string; source: string },\n  wanted: string,\n  facts: RenameFacts\n): { type: string; source: string } {\n  const next = wanted.trim()\n\n  if (!next) {\n    throw new FigureRenameRefused('empty-type', 'type 이 비어 있다 — 도면에 적히는 이름이라 비울 수 없다')\n  }\n\n  /*\n    The shape the modeller has always asked for, now asked here too (designer 2026-09-27, Q-D3): only a type being set\n    is held to it -- every type in the development data already keeps it (56 of 56, 2026-09-27), and none is renamed.\n  */\n  if (!TYPE_PATTERN.test(next) || next.length < TYPE_LENGTH.min || next.length > TYPE_LENGTH.max) {\n    throw new FigureRenameRefused(\n      'malformed-type',\n      `type 「${next}」 는 대문자로 시작하고 대문자·숫자·밑줄만 쓰며 ${TYPE_LENGTH.min}~${TYPE_LENGTH.max}자여야 한다`\n    )\n  }\n\n  if ((facts.version ?? 0) > 0 || facts.hasHistory) {\n    throw new FigureRenameRefused(\n      'already-released',\n      '발행된 도형의 type 은 바꿀 수 없다 — 이미 배치된 도면이 이 이름을 가리킨다'\n    )\n  }\n\n  if (facts.takenByAnother) {\n    throw new FigureRenameRefused('type-taken', `type 「${next}」 는 이 도메인에서 이미 쓰고 있다`)\n  }\n\n  /* The asset carries no `type`: the name a board uses is the row's alone, so only the row changes. */\n  return { type: next, source: current.source }\n}\n\n/**\n * 사실 셋을 저장소에서 읽는다.\n *\n * 규칙에서 떼어 둔 자리이지만 **질의의 모양이 틀리면 저작자에게는 저장 실패로만 보인다.**\n * 실제로 그랬다 — 판본을 `figure: { id }` 로 물었고, `FigureHistory` 는 관계 칸이 아니라\n * `originalId` 로 가리킨다. TypeORM 이 「그런 속성이 없다」로 던졌고 화면에는 영문 오류 한 줄이\n * 떴다. 그래서 이 함수를 내보내 sqlite 를 들고 왕복까지 본다.\n */\nexport async function renameFacts(\n  repositories: {\n    figures: { findOne(options: any): Promise<{ id?: string } | null> }\n    histories: { count(options: any): Promise<number> }\n  },\n  figure: { id?: string; version?: number },\n  domain: { id: string },\n  wanted: string\n): Promise<RenameFacts> {\n  const next = wanted.trim()\n  const hasHistory = (await repositories.histories.count({ where: { originalId: figure.id } })) > 0\n  const taken = next ? await repositories.figures.findOne({ where: { domain: { id: domain.id }, type: next } }) : null\n\n  return { version: figure.version, hasHistory, takenByAnother: !!taken && taken.id !== figure.id }\n}\n"]}
+{"version":3,"file":"figure-rename.js","sourceRoot":"","sources":["../../../server/service/figure/figure-rename.ts"],"names":[],"mappings":";;;AAiDA,0CAmCC;AAUD,kCAcC;AA5GD,yDAAkE;AAiClE,MAAa,mBAAoB,SAAQ,KAAK;IAC5C,YACW,IAAyE,EAClF,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAA;QAHL,SAAI,GAAJ,IAAI,CAAqE;QAIlF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AARD,kDAQC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAC7B,OAAyC,EACzC,MAAc,EACd,KAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;IAE1B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,mBAAmB,CAAC,YAAY,EAAE,qCAAqC,CAAC,CAAA;IACpF,CAAC;IAED;;;MAGE;IACF,IAAI,CAAC,2BAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,0BAAW,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,GAAG,0BAAW,CAAC,GAAG,EAAE,CAAC;QAC/F,MAAM,IAAI,mBAAmB,CAC3B,gBAAgB,EAChB,SAAS,IAAI,oCAAoC,0BAAW,CAAC,GAAG,IAAI,0BAAW,CAAC,GAAG,QAAQ,CAC5F,CAAA;IACH,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACjD,MAAM,IAAI,mBAAmB,CAC3B,kBAAkB,EAClB,gDAAgD,CACjD,CAAA;IACH,CAAC;IAED,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,MAAM,IAAI,mBAAmB,CAAC,YAAY,EAAE,SAAS,IAAI,sBAAsB,CAAC,CAAA;IAClF,CAAC;IAED,qGAAqG;IACrG,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAA;AAC/C,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,WAAW,CAC/B,YAGC,EACD,MAAyC,EACzC,MAAsB,EACtB,MAAc;IAEd,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;IAC1B,MAAM,UAAU,GAAG,CAAC,MAAM,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;IACjG,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAEpH,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,EAAE,CAAA;AACnG,CAAC","sourcesContent":["import { TYPE_LENGTH, TYPE_PATTERN } from '@hatiolab/figure-model'\n/**\n * 초안의 타입을 고치는 규칙 — ADR-0063 결정 4.\n *\n * ## 왜 발행 전에만인가\n *\n * `type` 은 도면에 적히는 이름이다. 도면은 `{ type, left, top, width, height }` 만 갖고 늘 최신\n * 발행판을 그리므로, 발행된 도형의 이름을 바꾸면 이미 배치된 도면이 아무 오류 없이 빈 자리가\n * 된다. 한 번도 발행되지 않은 도형은 그려질 자리가 없으니 가리키는 도면도 있을 수 없다.\n *\n * ## 왜 열어야 했나\n *\n * 닫아 두었더니 저작자가 이름을 **한 번도** 정하지 못했다. 새 Figure 에는 기계가 지은 이름이\n * 붙고(`FIGURE_MU6RJH47`) 칸에 자물쇠가 걸려서, 그 이름이 그대로 도면에 적히는 이름이 됐다.\n * 그렇게 남은 초안이 14 개다.\n *\n * ## 셈은 여기, 질의는 부르는 쪽\n *\n * 이 파일은 저장소를 모른다 — 판 번호 · 이력 유무 · 같은 이름의 주인을 **사실로 받는다.**\n * 그래야 규칙을 DB 없이 시험한다. 문(`figure-mutation.ts`)이 그 셋을 읽어 넘긴다.\n */\n\n\n/** 이름을 바꿀 때 알아야 하는 사실. 부르는 쪽이 저장소에서 읽어 온다. */\nexport interface RenameFacts {\n  /** 발행 판 번호. 0 이면 한 번도 발행되지 않았다. */\n  version?: number\n  /** 판본이 하나라도 있나. 되돌리기로 판 번호가 도로 낮아져도 이력은 남는다. */\n  hasHistory: boolean\n  /** 같은 도메인에서 그 이름을 이미 쓰는 **다른** 도형이 있나. */\n  takenByAnother: boolean\n}\n\nexport class FigureRenameRefused extends Error {\n  constructor(\n    readonly code: 'empty-type' | 'malformed-type' | 'already-released' | 'type-taken',\n    message: string\n  ) {\n    super(message)\n    this.name = 'FigureRenameRefused'\n  }\n}\n\n/**\n * 고친 이름과 정본. 못 고치면 **까닭과 함께 던진다** — 조용히 옛 이름으로 두지 않는다.\n *\n * 정본 안에도 `type` 이 있어서 함께 고친다. 한쪽만 고치면 저장된 JSON 과 행이 다른 이름을\n * 말하고, 발행할 때 어느 쪽이 도면에 적히는지가 갈린다.\n */\nexport function renameDraftType(\n  current: { type: string; source: string },\n  wanted: string,\n  facts: RenameFacts\n): { type: string; source: string } {\n  const next = wanted.trim()\n\n  if (!next) {\n    throw new FigureRenameRefused('empty-type', 'type 이 비어 있다 — 도면에 적히는 이름이라 비울 수 없다')\n  }\n\n  /*\n    The shape the modeller has always asked for, now asked here too (designer 2026-09-27, Q-D3): only a type being set\n    is held to it -- every type in the development data already keeps it (56 of 56, 2026-09-27), and none is renamed.\n  */\n  if (!TYPE_PATTERN.test(next) || next.length < TYPE_LENGTH.min || next.length > TYPE_LENGTH.max) {\n    throw new FigureRenameRefused(\n      'malformed-type',\n      `type 「${next}」 는 소문자로 시작하고 소문자·숫자·하이픈 하나씩만 쓰며 ${TYPE_LENGTH.min}~${TYPE_LENGTH.max}자여야 한다`\n    )\n  }\n\n  if ((facts.version ?? 0) > 0 || facts.hasHistory) {\n    throw new FigureRenameRefused(\n      'already-released',\n      '발행된 도형의 type 은 바꿀 수 없다 — 이미 배치된 도면이 이 이름을 가리킨다'\n    )\n  }\n\n  if (facts.takenByAnother) {\n    throw new FigureRenameRefused('type-taken', `type 「${next}」 는 이 도메인에서 이미 쓰고 있다`)\n  }\n\n  /* The asset carries no `type`: the name a board uses is the row's alone, so only the row changes. */\n  return { type: next, source: current.source }\n}\n\n/**\n * 사실 셋을 저장소에서 읽는다.\n *\n * 규칙에서 떼어 둔 자리이지만 **질의의 모양이 틀리면 저작자에게는 저장 실패로만 보인다.**\n * 실제로 그랬다 — 판본을 `figure: { id }` 로 물었고, `FigureHistory` 는 관계 칸이 아니라\n * `originalId` 로 가리킨다. TypeORM 이 「그런 속성이 없다」로 던졌고 화면에는 영문 오류 한 줄이\n * 떴다. 그래서 이 함수를 내보내 sqlite 를 들고 왕복까지 본다.\n */\nexport async function renameFacts(\n  repositories: {\n    figures: { findOne(options: any): Promise<{ id?: string } | null> }\n    histories: { count(options: any): Promise<number> }\n  },\n  figure: { id?: string; version?: number },\n  domain: { id: string },\n  wanted: string\n): Promise<RenameFacts> {\n  const next = wanted.trim()\n  const hasHistory = (await repositories.histories.count({ where: { originalId: figure.id } })) > 0\n  const taken = next ? await repositories.figures.findOne({ where: { domain: { id: domain.id }, type: next } }) : null\n\n  return { version: figure.version, hasHistory, takenByAnother: !!taken && taken.id !== figure.id }\n}\n"]}

package/dist-server/service/figure/figure-thumbnail-store.d.ts

@@ -15,6 +15,8 @@ export interface ThumbnailFiles {
         contents?: Buffer;
     }>;
     send(koa: any, path: string, next: () => Promise<any>): Promise<void>;
+    /** The bytes kept at a path -- what a figure package carries. */
+    read(path: string): Promise<Buffer>;
 }
 export declare const attachmentFiles: ThumbnailFiles;
 export declare const thumbnailFiles: () => ThumbnailFiles;

package/dist-server/service/figure/figure-thumbnail-store.js

@@ -42,7 +42,8 @@ exports.attachmentFiles = {
         const { id, path, size, contents } = await attachment_base_1.STORAGE.uploadFile({ file, context });
         return { id, path, size, contents };
     },
-    send: (koa, path, next) => attachment_base_1.STORAGE.sendFile(koa, path, next)
+    send: (koa, path, next) => attachment_base_1.STORAGE.sendFile(koa, path, next),
+    read: async (path) => Buffer.from(await attachment_base_1.STORAGE.readFile(path))
 };
 /*
  * The files in use: attachment-base's storage, unless a test gives its own. One seam for every writer and the router,

package/dist-server/service/figure/figure-thumbnail-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"figure-thumbnail-store.js","sourceRoot":"","sources":["../../../server/service/figure/figure-thumbnail-store.ts"],"names":[],"mappings":";;;AAwBA,sCAGC;AA+BD,8CAIC;AAKD,sDAEC;AAMD,sCA+BC;AA1GD,mCAAmC;AACnC,mCAAiC;AAEjC,qEAAqE;AAErE;;;;;;;;;;;;;;GAcG;AAEU,QAAA,kBAAkB,GAAG,kBAAkB,CAAA;AAEpD,yFAAyF;AACzF,SAAgB,aAAa,CAAC,OAAe;IAC3C,MAAM,OAAO,GAAG,8BAA8B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC5D,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AAC/F,CAAC;AAEM,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAA9E,QAAA,QAAQ,YAAsE;AAQ9E,QAAA,eAAe,GAAmB;IAC7C,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO;QACtC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;YAC3B,gBAAgB,EAAE,GAAG,EAAE,CAAC,iBAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;YAC9C,QAAQ,EAAE,IAAI;YACd,QAAQ;YACR,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAA;QACF,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,yBAAO,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;QAChF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;IACrC,CAAC;IACD,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,yBAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC;CAC7D,CAAA;AAED;;;GAGG;AACH,IAAI,KAAK,GAAmB,uBAAe,CAAA;AACpC,MAAM,cAAc,GAAG,GAAmB,EAAE,CAAC,KAAK,CAAA;AAA5C,QAAA,cAAc,kBAA8B;AACzD,+EAA+E;AAC/E,SAAgB,iBAAiB,CAAC,KAAqB;IACrD,MAAM,GAAG,GAAG,KAAK,CAAA;IACjB,KAAK,GAAG,KAAK,CAAA;IACb,OAAO,GAAG,CAAA;AACZ,CAAC;AAID,wEAAwE;AACjE,KAAK,UAAU,qBAAqB,CAAC,EAAM,EAAE,QAAgB,EAAE,IAAY;IAChF,OAAO,CAAC,MAAM,EAAE,CAAC,aAAa,CAAC,4BAAU,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,0BAAkB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,SAAS,CAAA;AACrJ,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,aAAa,CACjC,EAAM,EACN,MAAsB,EACtB,IAAa,EACb,OAAe,EACf,QAAwB,IAAA,sBAAc,GAAE;IAExC,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;IACtC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IAChF,MAAM,IAAI,GAAG,IAAA,gBAAQ,EAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACpC,IAAI,MAAM,qBAAqB,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACjE,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAA;IAC9D,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,GAAG,EAAE,CAAA;IAC7B,+GAA+G;IAC/G,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;IAC/F,MAAM,EAAE,CAAC,aAAa,CAAC,4BAAU,CAAC,CAAC,IAAI,CAAC;QACtC,MAAM;QACN,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI;QACJ,QAAQ,EAAE,OAAO,CAAC,IAAI;QACtB,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,0BAAkB;QAC3B,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QACtB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC,CAAA;IACF,OAAO,IAAI,CAAA;AACb,CAAC","sourcesContent":["import { createHash } from 'crypto'\nimport { Readable } from 'stream'\n\nimport { Attachment, STORAGE } from '@things-factory/attachment-base'\n\n/*\n * A figure's picture, kept by attachment-base and named by its content (ADR-0104 decision 6, chief architect's ruling\n * 2026-10-02).\n *\n *   stored    by attachment-base's storage (file, S3, database -- whichever the install configures), one attachment\n *             per (domain, content): refType `figure-thumbnail`, refBy the SHA-256 of the bytes. A figure, its\n *             releases and the drafts a revert kept carry that hash, never the bytes.\n *   served    only through `/figure-thumbnail/:id`, behind the figure query permission -- never through attachment-\n *             base's public `/attachment/:path`, which checks nothing (a known gap, recorded in ADR-0104).\n *   the same  content twice in one domain is one attachment, read by its hash. Two writers that both find none both\n *             write one; either serves the same bytes, so the result is the same (ruling, condition 2).\n *\n * The file is written before the row that names it: a file cannot be rolled back, so it goes first, and a row that\n * fails to commit leaves a file the next write of the same content writes again.\n */\n\nexport const THUMBNAIL_REF_TYPE = 'figure-thumbnail'\n\n/** `data:image/webp;base64,....` as its type and bytes; undefined when it is not one. */\nexport function decodeDataUrl(dataUrl: string): { type: string; bytes: Buffer } | undefined {\n  const matched = /^data:([^;,]+);base64,(.*)$/s.exec(dataUrl)\n  return matched ? { type: matched[1]!, bytes: Buffer.from(matched[2]!, 'base64') } : undefined\n}\n\nexport const sha256Of = (bytes: Buffer) => createHash('sha256').update(bytes).digest('hex')\n\n/** Where the bytes go: attachment-base's storage. Tests give another. */\nexport interface ThumbnailFiles {\n  put(bytes: Buffer, mimetype: string, name: string, context: any): Promise<{ id: string; path: string; size: number; contents?: Buffer }>\n  send(koa: any, path: string, next: () => Promise<any>): Promise<void>\n}\n\nexport const attachmentFiles: ThumbnailFiles = {\n  async put(bytes, mimetype, name, context) {\n    const file = Promise.resolve({\n      createReadStream: () => Readable.from([bytes]),\n      filename: name,\n      mimetype,\n      encoding: 'binary'\n    })\n    const { id, path, size, contents } = await STORAGE.uploadFile({ file, context })\n    return { id, path, size, contents }\n  },\n  send: (koa, path, next) => STORAGE.sendFile(koa, path, next)\n}\n\n/*\n * The files in use: attachment-base's storage, unless a test gives its own. One seam for every writer and the router,\n * so a test of a save or a revert need not reach into each.\n */\nlet inUse: ThumbnailFiles = attachmentFiles\nexport const thumbnailFiles = (): ThumbnailFiles => inUse\n/** For tests: use these files until set back; returns the ones it replaced. */\nexport function useThumbnailFiles(files: ThumbnailFiles): ThumbnailFiles {\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 thumbnailAttachmentOf(tx: Tx, domainId: string, hash: string): Promise<Attachment | undefined> {\n  return (await tx.getRepository(Attachment).findOne({ where: { domain: { id: domainId }, refType: THUMBNAIL_REF_TYPE, refBy: hash } })) ?? undefined\n}\n\n/**\n * Keeps a picture and gives its hash. Refused when it is not a data URL -- a picture the server cannot read is one it\n * must not keep under a name.\n */\nexport async function keepThumbnail(\n  tx: Tx,\n  domain: { id: string },\n  user: unknown,\n  dataUrl: string,\n  files: ThumbnailFiles = thumbnailFiles()\n): Promise<string> {\n  const decoded = decodeDataUrl(dataUrl)\n  if (!decoded) throw new Error('썸네일은 data URL(data:image/...;base64,...) 이어야 한다')\n  const hash = sha256Of(decoded.bytes)\n  if (await thumbnailAttachmentOf(tx, domain.id, hash)) return hash\n  const ext = decoded.type.split('/')[1]?.split('+')[0] || 'bin'\n  const name = `${hash}.${ext}`\n  /* The file first: it cannot be rolled back. The row that names it comes after, in the caller's transaction. */\n  const put = await files.put(decoded.bytes, decoded.type, 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: decoded.type,\n    encoding: 'binary',\n    refType: THUMBNAIL_REF_TYPE,\n    refBy: hash,\n    category: 'image',\n    size: String(put.size),\n    path: put.path,\n    ...(put.contents ? { contents: put.contents } : {})\n  })\n  return hash\n}\n\n"]}
+{"version":3,"file":"figure-thumbnail-store.js","sourceRoot":"","sources":["../../../server/service/figure/figure-thumbnail-store.ts"],"names":[],"mappings":";;;AAwBA,sCAGC;AAkCD,8CAIC;AAKD,sDAEC;AAMD,sCA+BC;AA7GD,mCAAmC;AACnC,mCAAiC;AAEjC,qEAAqE;AAErE;;;;;;;;;;;;;;GAcG;AAEU,QAAA,kBAAkB,GAAG,kBAAkB,CAAA;AAEpD,yFAAyF;AACzF,SAAgB,aAAa,CAAC,OAAe;IAC3C,MAAM,OAAO,GAAG,8BAA8B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC5D,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AAC/F,CAAC;AAEM,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAA9E,QAAA,QAAQ,YAAsE;AAU9E,QAAA,eAAe,GAAmB;IAC7C,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO;QACtC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;YAC3B,gBAAgB,EAAE,GAAG,EAAE,CAAC,iBAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;YAC9C,QAAQ,EAAE,IAAI;YACd,QAAQ;YACR,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAA;QACF,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,yBAAO,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;QAChF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;IACrC,CAAC;IACD,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,yBAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC;IAC5D,IAAI,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,yBAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;CAC9D,CAAA;AAED;;;GAGG;AACH,IAAI,KAAK,GAAmB,uBAAe,CAAA;AACpC,MAAM,cAAc,GAAG,GAAmB,EAAE,CAAC,KAAK,CAAA;AAA5C,QAAA,cAAc,kBAA8B;AACzD,+EAA+E;AAC/E,SAAgB,iBAAiB,CAAC,KAAqB;IACrD,MAAM,GAAG,GAAG,KAAK,CAAA;IACjB,KAAK,GAAG,KAAK,CAAA;IACb,OAAO,GAAG,CAAA;AACZ,CAAC;AAID,wEAAwE;AACjE,KAAK,UAAU,qBAAqB,CAAC,EAAM,EAAE,QAAgB,EAAE,IAAY;IAChF,OAAO,CAAC,MAAM,EAAE,CAAC,aAAa,CAAC,4BAAU,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,0BAAkB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,SAAS,CAAA;AACrJ,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,aAAa,CACjC,EAAM,EACN,MAAsB,EACtB,IAAa,EACb,OAAe,EACf,QAAwB,IAAA,sBAAc,GAAE;IAExC,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;IACtC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IAChF,MAAM,IAAI,GAAG,IAAA,gBAAQ,EAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACpC,IAAI,MAAM,qBAAqB,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACjE,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAA;IAC9D,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,GAAG,EAAE,CAAA;IAC7B,+GAA+G;IAC/G,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;IAC/F,MAAM,EAAE,CAAC,aAAa,CAAC,4BAAU,CAAC,CAAC,IAAI,CAAC;QACtC,MAAM;QACN,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI;QACJ,QAAQ,EAAE,OAAO,CAAC,IAAI;QACtB,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,0BAAkB;QAC3B,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QACtB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC,CAAA;IACF,OAAO,IAAI,CAAA;AACb,CAAC","sourcesContent":["import { createHash } from 'crypto'\nimport { Readable } from 'stream'\n\nimport { Attachment, STORAGE } from '@things-factory/attachment-base'\n\n/*\n * A figure's picture, kept by attachment-base and named by its content (ADR-0104 decision 6, chief architect's ruling\n * 2026-10-02).\n *\n *   stored    by attachment-base's storage (file, S3, database -- whichever the install configures), one attachment\n *             per (domain, content): refType `figure-thumbnail`, refBy the SHA-256 of the bytes. A figure, its\n *             releases and the drafts a revert kept carry that hash, never the bytes.\n *   served    only through `/figure-thumbnail/:id`, behind the figure query permission -- never through attachment-\n *             base's public `/attachment/:path`, which checks nothing (a known gap, recorded in ADR-0104).\n *   the same  content twice in one domain is one attachment, read by its hash. Two writers that both find none both\n *             write one; either serves the same bytes, so the result is the same (ruling, condition 2).\n *\n * The file is written before the row that names it: a file cannot be rolled back, so it goes first, and a row that\n * fails to commit leaves a file the next write of the same content writes again.\n */\n\nexport const THUMBNAIL_REF_TYPE = 'figure-thumbnail'\n\n/** `data:image/webp;base64,....` as its type and bytes; undefined when it is not one. */\nexport function decodeDataUrl(dataUrl: string): { type: string; bytes: Buffer } | undefined {\n  const matched = /^data:([^;,]+);base64,(.*)$/s.exec(dataUrl)\n  return matched ? { type: matched[1]!, bytes: Buffer.from(matched[2]!, 'base64') } : undefined\n}\n\nexport const sha256Of = (bytes: Buffer) => createHash('sha256').update(bytes).digest('hex')\n\n/** Where the bytes go: attachment-base's storage. Tests give another. */\nexport interface ThumbnailFiles {\n  put(bytes: Buffer, mimetype: string, name: string, context: any): Promise<{ id: string; path: string; size: number; contents?: Buffer }>\n  send(koa: any, path: string, next: () => Promise<any>): Promise<void>\n  /** The bytes kept at a path -- what a figure package carries. */\n  read(path: string): Promise<Buffer>\n}\n\nexport const attachmentFiles: ThumbnailFiles = {\n  async put(bytes, mimetype, name, context) {\n    const file = Promise.resolve({\n      createReadStream: () => Readable.from([bytes]),\n      filename: name,\n      mimetype,\n      encoding: 'binary'\n    })\n    const { id, path, size, contents } = await STORAGE.uploadFile({ file, context })\n    return { id, path, size, contents }\n  },\n  send: (koa, path, next) => STORAGE.sendFile(koa, path, next),\n  read: async path => Buffer.from(await STORAGE.readFile(path))\n}\n\n/*\n * The files in use: attachment-base's storage, unless a test gives its own. One seam for every writer and the router,\n * so a test of a save or a revert need not reach into each.\n */\nlet inUse: ThumbnailFiles = attachmentFiles\nexport const thumbnailFiles = (): ThumbnailFiles => inUse\n/** For tests: use these files until set back; returns the ones it replaced. */\nexport function useThumbnailFiles(files: ThumbnailFiles): ThumbnailFiles {\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 thumbnailAttachmentOf(tx: Tx, domainId: string, hash: string): Promise<Attachment | undefined> {\n  return (await tx.getRepository(Attachment).findOne({ where: { domain: { id: domainId }, refType: THUMBNAIL_REF_TYPE, refBy: hash } })) ?? undefined\n}\n\n/**\n * Keeps a picture and gives its hash. Refused when it is not a data URL -- a picture the server cannot read is one it\n * must not keep under a name.\n */\nexport async function keepThumbnail(\n  tx: Tx,\n  domain: { id: string },\n  user: unknown,\n  dataUrl: string,\n  files: ThumbnailFiles = thumbnailFiles()\n): Promise<string> {\n  const decoded = decodeDataUrl(dataUrl)\n  if (!decoded) throw new Error('썸네일은 data URL(data:image/...;base64,...) 이어야 한다')\n  const hash = sha256Of(decoded.bytes)\n  if (await thumbnailAttachmentOf(tx, domain.id, hash)) return hash\n  const ext = decoded.type.split('/')[1]?.split('+')[0] || 'bin'\n  const name = `${hash}.${ext}`\n  /* The file first: it cannot be rolled back. The row that names it comes after, in the caller's transaction. */\n  const put = await files.put(decoded.bytes, decoded.type, 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: decoded.type,\n    encoding: 'binary',\n    refType: THUMBNAIL_REF_TYPE,\n    refBy: hash,\n    category: 'image',\n    size: String(put.size),\n    path: put.path,\n    ...(put.contents ? { contents: put.contents } : {})\n  })\n  return hash\n}\n\n"]}

package/dist-server/service/figure/figure.d.ts

@@ -38,6 +38,11 @@ export declare class Figure {
      * `Board.type`(main/sub/popup)과 뜻이 전혀 다르다. 혼동하지 않는다.
      */
     type?: string;
+    /**
+     * The namespace the figure is published under, copied from the domain setting `figure-namespace` when the figure is
+     * made. With the type it forms the full name `{namespace}/{type}` boards store (ADR-0114). Never changes.
+     */
+    namespace?: string;
     name?: string;
     description?: string;
     names?: Record<string, string>;

package/dist-server/service/figure/figure.js

@@ -63,6 +63,11 @@ tslib_1.__decorate([
     (0, type_graphql_1.Field)({ description: 'Component type name. A stored identifier — unique per domain and immutable once created.' }),
     tslib_1.__metadata("design:type", String)
 ], Figure.prototype, "type", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Namespace of the full name {namespace}/{type}. Copied from the domain setting when created; never changes.' }),
+    tslib_1.__metadata("design:type", String)
+], Figure.prototype, "namespace", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.Column)(),
     (0, type_graphql_1.Field)({ description: 'Display name shown to authors. Safe to rename.' }),

package/dist-server/service/figure/figure.js.map

@@ -1 +1 @@
-{"version":3,"file":"figure.js","sourceRoot":"","sources":["../../../server/service/figure/figure.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Column,\n  CreateDateColumn,\n  DeleteDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\nimport { Field, Float, ID, Int, ObjectType } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\n\nimport { User } from '@things-factory/auth-base'\nimport { Domain, longTextColumn } from '@things-factory/shell'\n\n/**\n * Figure — 저작된 3D 컴포넌트 한 종류.\n *\n * `Board` 를 준용한다. 다른 점만 주석으로 적는다.\n *\n * ## 무엇을 담나 — 도형 자산이다, 씬 모델이 아니다\n *\n * 형식은 `@hatiolab/figure-model` 이 정한다(`figure-asset-1`). 씬 컴포넌트 트리를 담지 않는다.\n * 컴파일한 것도 저장하지 않는다 — 원본에서 파생되므로 소비하는 쪽이 커널로 컴파일한다. 저장하면 원본과 갈린다.\n *\n * 그래서 부품·움직임·자리 같은 것을 컬럼으로 두지 않는다 — 전부 `source` 안에 이미 있다. 두 벌이면 갈린다.\n *\n * 설계: `docs/design/figure-modules.md` §2\n */\n@Entity()\n@Index('ix_figure_1', (figure: Figure) => [figure.domain, figure.type], {\n  unique: true,\n  where: '\"deleted_at\" IS NULL'\n})\n@Index('ix_figure_2', (figure: Figure) => [figure.domain, figure.category])\n@ObjectType({ description: 'An authored 3D component type — its figure asset plus its metadata.' })\nexport class Figure {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { nullable: true, description: 'Unique identifier for the figure.' })\n  readonly id?: string\n\n  /**\n   * 발행된 판의 번호 — **발행할 때만 올라간다.**\n   *\n   * 저장 횟수가 아니다. 저작 중에는 몇 번을 고쳐 저장하든 그대로이고, `draft` 가 `released` 가\n   * 되는 순간에만 하나 오른다. 소비처가 「몇 번째 판을 쓰고 있나」를 이 값으로 말한다.\n   *\n   * 한 번도 발행되지 않았으면 **0** 이다. 1 로 시작하면 아직 아무에게도 약속하지 않은 초안이\n   * 첫 판인 것처럼 보인다.\n   */\n  @Column({ nullable: true, default: 0 })\n  @Field(type => Int, {\n    nullable: true,\n    description: 'Published version. Raised when the figure is released, not when it is saved. 0 means never released.'\n  })\n  version?: number = 0\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true, description: 'The domain this figure belongs to.' })\n  domain?: Domain\n\n  @RelationId((figure: Figure) => figure.domain)\n  domainId?: string\n\n  /**\n   * 컴포넌트 타입 이름. **저장되는 식별자다.**\n   *\n   * 배치된 도면이 이 이름으로 타입을 찾는다. 바꾸면 그 도면은 타입을 못 찾아\n   * **오류 없이 빈 화면**이 된다. 그래서 만들 때 정하고 잠근다 — 고칠 수 있는 것은\n   * 표시 이름(`name`)뿐이다. 수정 리졸버가 이 필드를 받지 않는다.\n   *\n   * `Board.type`(main/sub/popup)과 뜻이 전혀 다르다. 혼동하지 않는다.\n   */\n  @Column()\n  @Field({ description: 'Component type name. A stored identifier — unique per domain and immutable once created.' })\n  type?: string\n\n  @Column()\n  @Field({ description: 'Display name shown to authors. Safe to rename.' })\n  name?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'A detailed description for the figure.' })\n  description?: string\n\n  /*\n    언어별 표시 이름(ADR-0104 결정 6). 없는 언어는 `name` 을 보인다. 식별자는 여전히 `type` 이다 — 이름은 몇 번을\n    바꿔도 도면이 가리키는 것이 달라지지 않는다.\n  */\n  @Column('simple-json', { nullable: true, default: null })\n  @Field(type => GraphQLJSON, { nullable: true, description: 'Display names by language, e.g. { \"en\": \"...\", \"ko\": \"...\" }. A language not here shows `name`.' })\n  names?: Record<string, string>\n\n  /*\n    퇴역(ADR-0104 결정 6). 표시일 뿐이다 — 발행판은 지우지 않고 받는 쪽은 그대로 받는다. 무엇으로 대신하라는지는\n    `supersededBy`(그 도메인의 type)가 말한다. 퇴역은 저장이 아니라 `setFigureDeprecation` 이 정하고, 발행을 풀지 않는다.\n  */\n  @Column({ nullable: true, default: false })\n  @Field({ nullable: true, description: 'Retired: still released and still served, but not to be chosen for new work.' })\n  deprecated?: boolean\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'The type to use instead of a retired figure.' })\n  supersededBy?: string\n\n  /**\n   * 분류 하나. **팔레트에서 묶어 보이는 기준이다.**\n   *\n   * 도형 하나에 하나뿐이다 — 팔레트는 목록을 한 벌로 나눠 보여 주므로, 한 도형이 두 묶음에\n   * 동시에 있으면 저작자가 같은 것을 두 번 만난다.\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Classification code used to group figures in the palette. One per figure.' })\n  category?: string\n\n  /**\n   * 태그. **여럿 붙는다.**\n   *\n   * 분류와 다른 일을 한다. 분류는 「이것이 무엇인가」를 한 번 정하는 것이고, 태그는 「어디에\n   * 걸리는가」를 여러 갈래로 적는 것이다 — 컨베이어이면서 반출 구역의 것일 수 있다. 그래서\n   * 분류로는 못 하는 찾기가 된다.\n   *\n   * `simple-json` 으로 담는다. 사내 선례가 그것이고(`ops-master` · `organization` ·\n   * `personalization`), 드라이버마다 배열 타입이 다른 것을 피한다.\n   */\n  /* `simple-json` 과 `default: null` 은 사내 선례 그대로다 — board-template · attachment 가 같은 모양이다. */\n  @Column('simple-json', { nullable: true, default: null })\n  @Field(type => [String], { nullable: true, description: 'Free-form tags. A figure may carry several.' })\n  tags?: string[]\n\n  @Column({ nullable: true, default: 'draft' })\n  @Field({ nullable: true, description: \"Lifecycle state — 'draft' figures do not appear in the board palette.\" })\n  state?: 'draft' | 'released'\n\n  /**\n   * The figure asset JSON (`figure-asset-1`).\n   *\n   * `Board.model` 자리이지만 이름을 바꿨다 — 「씬 모델이 아니다」를 필드 이름이\n   * 드러내야 한다.\n   */\n  @Column({ nullable: true, ...longTextColumn() })\n  @Field({ nullable: true, description: 'The figure asset JSON (figure-asset-1) authored by the modeller.' })\n  source?: string\n\n  // ── 파생값 — 저장하는 이유가 하나뿐이다 ──────────────────────────────────\n  //\n  // 셋 다 `source` 에서 계산된다. 그런데도 컬럼으로 두는 이유는 **목록 화면이\n  // 정렬·필터를 해야** 하기 때문이다. JSON 을 파싱해 정렬할 수는 없다.\n  //\n  // 저장할 때 `figure-model` 로 계산해 채운다. **클라이언트가 준 값을 받지 않는다** —\n  // 받으면 거짓이 들어오고, 목록이 실물과 다른 것을 보여 준다.\n\n  /** 재활용 점수 0~100. `scoreOf()` 가 계산한다. */\n  @Column({ type: 'float', nullable: true })\n  @Field(type => Float, { nullable: true, description: 'Reuse score 0-100, computed from source on save.' })\n  score?: number\n\n  /** 삼각형 수. `costOf()` 가 계산한다. */\n  @Column({ nullable: true })\n  @Field(type => Int, { nullable: true, description: 'Triangle count, computed from source on save.' })\n  triangles?: number\n\n  /** 재질 묶음 수 — 인스턴스당 draw call 의 근거. */\n  @Column({ nullable: true })\n  @Field(type => Int, { nullable: true, description: 'Material group count — the basis of per-instance draw calls.' })\n  groups?: number\n\n  /** 기준정보 항목 정의. Figure 를 배치할 때 인스턴스가 채우는 자리. */\n  @Column({ nullable: true, ...longTextColumn() })\n  @Field({ nullable: true, description: 'JSON definition of the master-data fields an instance of this figure carries.' })\n  properties?: string\n\n  @Column({ nullable: true, ...longTextColumn() })\n  @Field({ nullable: true, description: 'A base64 encoded thumbnail image of the figure.' })\n  thumbnail?: string\n\n  /*\n   * 그림의 내용 해시(SHA-256). 그림 자체는 attachment-base 가 갖고(refType `figure-thumbnail`, refBy 이 해시),\n   * `/figure-thumbnail/:id` 가 권한을 본 뒤 내준다(ADR-0104 결정 6). `thumbnail` 칸은 옛 base64 가 남은 행을\n   * 기동 때 옮기기 위한 칸이다 — 옮긴 뒤에는 비어 있고, 새 그림은 그 칸에 쓰지 않는다.\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'SHA-256 of the thumbnail picture; the picture is served by /figure-thumbnail/:id.' })\n  thumbnailHash?: string\n\n  /**\n   * 썸네일이 **썸네일로서** 마지막으로 갱신된 시각. `updatedAt` 과는 별개 도메인이다 —\n   * 이름·설명만 고쳤을 때는 갱신되지 않는다. `Board` 와 같은 방식.\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Timestamp of the last thumbnail generation. Separate lifecycle from updatedAt.' })\n  thumbnailUpdatedAt?: Date\n\n  @Column({ type: 'float', nullable: true, default: 0 })\n  @Field(type => Float, { nullable: true, description: 'Sort order within a listing.' })\n  sortOrder?: number\n\n  @CreateDateColumn()\n  @Field({ nullable: true, description: 'Creation timestamp.' })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true, description: 'Last update timestamp.' })\n  updatedAt?: Date\n\n  @DeleteDateColumn()\n  @Field({ nullable: true, description: 'Soft-delete timestamp.' })\n  deletedAt?: Date\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'The user who created this figure.' })\n  creator?: User\n\n  @RelationId((figure: Figure) => figure.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'The user who last updated this figure.' })\n  updater?: User\n\n  @RelationId((figure: Figure) => figure.updater)\n  updaterId?: string\n}\n"]}
+{"version":3,"file":"figure.js","sourceRoot":"","sources":["../../../server/service/figure/figure.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Column,\n  CreateDateColumn,\n  DeleteDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\nimport { Field, Float, ID, Int, ObjectType } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\n\nimport { User } from '@things-factory/auth-base'\nimport { Domain, longTextColumn } from '@things-factory/shell'\n\n/**\n * Figure — 저작된 3D 컴포넌트 한 종류.\n *\n * `Board` 를 준용한다. 다른 점만 주석으로 적는다.\n *\n * ## 무엇을 담나 — 도형 자산이다, 씬 모델이 아니다\n *\n * 형식은 `@hatiolab/figure-model` 이 정한다(`figure-asset-1`). 씬 컴포넌트 트리를 담지 않는다.\n * 컴파일한 것도 저장하지 않는다 — 원본에서 파생되므로 소비하는 쪽이 커널로 컴파일한다. 저장하면 원본과 갈린다.\n *\n * 그래서 부품·움직임·자리 같은 것을 컬럼으로 두지 않는다 — 전부 `source` 안에 이미 있다. 두 벌이면 갈린다.\n *\n * 설계: `docs/design/figure-modules.md` §2\n */\n@Entity()\n@Index('ix_figure_1', (figure: Figure) => [figure.domain, figure.type], {\n  unique: true,\n  where: '\"deleted_at\" IS NULL'\n})\n@Index('ix_figure_2', (figure: Figure) => [figure.domain, figure.category])\n@ObjectType({ description: 'An authored 3D component type — its figure asset plus its metadata.' })\nexport class Figure {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { nullable: true, description: 'Unique identifier for the figure.' })\n  readonly id?: string\n\n  /**\n   * 발행된 판의 번호 — **발행할 때만 올라간다.**\n   *\n   * 저장 횟수가 아니다. 저작 중에는 몇 번을 고쳐 저장하든 그대로이고, `draft` 가 `released` 가\n   * 되는 순간에만 하나 오른다. 소비처가 「몇 번째 판을 쓰고 있나」를 이 값으로 말한다.\n   *\n   * 한 번도 발행되지 않았으면 **0** 이다. 1 로 시작하면 아직 아무에게도 약속하지 않은 초안이\n   * 첫 판인 것처럼 보인다.\n   */\n  @Column({ nullable: true, default: 0 })\n  @Field(type => Int, {\n    nullable: true,\n    description: 'Published version. Raised when the figure is released, not when it is saved. 0 means never released.'\n  })\n  version?: number = 0\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true, description: 'The domain this figure belongs to.' })\n  domain?: Domain\n\n  @RelationId((figure: Figure) => figure.domain)\n  domainId?: string\n\n  /**\n   * 컴포넌트 타입 이름. **저장되는 식별자다.**\n   *\n   * 배치된 도면이 이 이름으로 타입을 찾는다. 바꾸면 그 도면은 타입을 못 찾아\n   * **오류 없이 빈 화면**이 된다. 그래서 만들 때 정하고 잠근다 — 고칠 수 있는 것은\n   * 표시 이름(`name`)뿐이다. 수정 리졸버가 이 필드를 받지 않는다.\n   *\n   * `Board.type`(main/sub/popup)과 뜻이 전혀 다르다. 혼동하지 않는다.\n   */\n  @Column()\n  @Field({ description: 'Component type name. A stored identifier — unique per domain and immutable once created.' })\n  type?: string\n\n  /**\n   * The namespace the figure is published under, copied from the domain setting `figure-namespace` when the figure is\n   * made. With the type it forms the full name `{namespace}/{type}` boards store (ADR-0114). Never changes.\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Namespace of the full name {namespace}/{type}. Copied from the domain setting when created; never changes.' })\n  namespace?: string\n\n  @Column()\n  @Field({ description: 'Display name shown to authors. Safe to rename.' })\n  name?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'A detailed description for the figure.' })\n  description?: string\n\n  /*\n    언어별 표시 이름(ADR-0104 결정 6). 없는 언어는 `name` 을 보인다. 식별자는 여전히 `type` 이다 — 이름은 몇 번을\n    바꿔도 도면이 가리키는 것이 달라지지 않는다.\n  */\n  @Column('simple-json', { nullable: true, default: null })\n  @Field(type => GraphQLJSON, { nullable: true, description: 'Display names by language, e.g. { \"en\": \"...\", \"ko\": \"...\" }. A language not here shows `name`.' })\n  names?: Record<string, string>\n\n  /*\n    퇴역(ADR-0104 결정 6). 표시일 뿐이다 — 발행판은 지우지 않고 받는 쪽은 그대로 받는다. 무엇으로 대신하라는지는\n    `supersededBy`(그 도메인의 type)가 말한다. 퇴역은 저장이 아니라 `setFigureDeprecation` 이 정하고, 발행을 풀지 않는다.\n  */\n  @Column({ nullable: true, default: false })\n  @Field({ nullable: true, description: 'Retired: still released and still served, but not to be chosen for new work.' })\n  deprecated?: boolean\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'The type to use instead of a retired figure.' })\n  supersededBy?: string\n\n  /**\n   * 분류 하나. **팔레트에서 묶어 보이는 기준이다.**\n   *\n   * 도형 하나에 하나뿐이다 — 팔레트는 목록을 한 벌로 나눠 보여 주므로, 한 도형이 두 묶음에\n   * 동시에 있으면 저작자가 같은 것을 두 번 만난다.\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Classification code used to group figures in the palette. One per figure.' })\n  category?: string\n\n  /**\n   * 태그. **여럿 붙는다.**\n   *\n   * 분류와 다른 일을 한다. 분류는 「이것이 무엇인가」를 한 번 정하는 것이고, 태그는 「어디에\n   * 걸리는가」를 여러 갈래로 적는 것이다 — 컨베이어이면서 반출 구역의 것일 수 있다. 그래서\n   * 분류로는 못 하는 찾기가 된다.\n   *\n   * `simple-json` 으로 담는다. 사내 선례가 그것이고(`ops-master` · `organization` ·\n   * `personalization`), 드라이버마다 배열 타입이 다른 것을 피한다.\n   */\n  /* `simple-json` 과 `default: null` 은 사내 선례 그대로다 — board-template · attachment 가 같은 모양이다. */\n  @Column('simple-json', { nullable: true, default: null })\n  @Field(type => [String], { nullable: true, description: 'Free-form tags. A figure may carry several.' })\n  tags?: string[]\n\n  @Column({ nullable: true, default: 'draft' })\n  @Field({ nullable: true, description: \"Lifecycle state — 'draft' figures do not appear in the board palette.\" })\n  state?: 'draft' | 'released'\n\n  /**\n   * The figure asset JSON (`figure-asset-1`).\n   *\n   * `Board.model` 자리이지만 이름을 바꿨다 — 「씬 모델이 아니다」를 필드 이름이\n   * 드러내야 한다.\n   */\n  @Column({ nullable: true, ...longTextColumn() })\n  @Field({ nullable: true, description: 'The figure asset JSON (figure-asset-1) authored by the modeller.' })\n  source?: string\n\n  // ── 파생값 — 저장하는 이유가 하나뿐이다 ──────────────────────────────────\n  //\n  // 셋 다 `source` 에서 계산된다. 그런데도 컬럼으로 두는 이유는 **목록 화면이\n  // 정렬·필터를 해야** 하기 때문이다. JSON 을 파싱해 정렬할 수는 없다.\n  //\n  // 저장할 때 `figure-model` 로 계산해 채운다. **클라이언트가 준 값을 받지 않는다** —\n  // 받으면 거짓이 들어오고, 목록이 실물과 다른 것을 보여 준다.\n\n  /** 재활용 점수 0~100. `scoreOf()` 가 계산한다. */\n  @Column({ type: 'float', nullable: true })\n  @Field(type => Float, { nullable: true, description: 'Reuse score 0-100, computed from source on save.' })\n  score?: number\n\n  /** 삼각형 수. `costOf()` 가 계산한다. */\n  @Column({ nullable: true })\n  @Field(type => Int, { nullable: true, description: 'Triangle count, computed from source on save.' })\n  triangles?: number\n\n  /** 재질 묶음 수 — 인스턴스당 draw call 의 근거. */\n  @Column({ nullable: true })\n  @Field(type => Int, { nullable: true, description: 'Material group count — the basis of per-instance draw calls.' })\n  groups?: number\n\n  /** 기준정보 항목 정의. Figure 를 배치할 때 인스턴스가 채우는 자리. */\n  @Column({ nullable: true, ...longTextColumn() })\n  @Field({ nullable: true, description: 'JSON definition of the master-data fields an instance of this figure carries.' })\n  properties?: string\n\n  @Column({ nullable: true, ...longTextColumn() })\n  @Field({ nullable: true, description: 'A base64 encoded thumbnail image of the figure.' })\n  thumbnail?: string\n\n  /*\n   * 그림의 내용 해시(SHA-256). 그림 자체는 attachment-base 가 갖고(refType `figure-thumbnail`, refBy 이 해시),\n   * `/figure-thumbnail/:id` 가 권한을 본 뒤 내준다(ADR-0104 결정 6). `thumbnail` 칸은 옛 base64 가 남은 행을\n   * 기동 때 옮기기 위한 칸이다 — 옮긴 뒤에는 비어 있고, 새 그림은 그 칸에 쓰지 않는다.\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'SHA-256 of the thumbnail picture; the picture is served by /figure-thumbnail/:id.' })\n  thumbnailHash?: string\n\n  /**\n   * 썸네일이 **썸네일로서** 마지막으로 갱신된 시각. `updatedAt` 과는 별개 도메인이다 —\n   * 이름·설명만 고쳤을 때는 갱신되지 않는다. `Board` 와 같은 방식.\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Timestamp of the last thumbnail generation. Separate lifecycle from updatedAt.' })\n  thumbnailUpdatedAt?: Date\n\n  @Column({ type: 'float', nullable: true, default: 0 })\n  @Field(type => Float, { nullable: true, description: 'Sort order within a listing.' })\n  sortOrder?: number\n\n  @CreateDateColumn()\n  @Field({ nullable: true, description: 'Creation timestamp.' })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true, description: 'Last update timestamp.' })\n  updatedAt?: Date\n\n  @DeleteDateColumn()\n  @Field({ nullable: true, description: 'Soft-delete timestamp.' })\n  deletedAt?: Date\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'The user who created this figure.' })\n  creator?: User\n\n  @RelationId((figure: Figure) => figure.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'The user who last updated this figure.' })\n  updater?: User\n\n  @RelationId((figure: Figure) => figure.updater)\n  updaterId?: string\n}\n"]}