@things-factory/figure-service 10.1.40 → 10.1.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-service",
-  "version": "10.1.40",
+  "version": "10.1.42",
   "publishConfig": {
     "access": "public",
     "@things-factory:registry": "https://registry.npmjs.org"
@@ -23,7 +23,7 @@
     "migration:create": "node ../../node_modules/typeorm/cli.js migration:create ./server/migrations/migration"
   },
   "dependencies": {
-    "@hatiolab/figure-model": "^0.1.40",
+    "@hatiolab/figure-model": "^0.1.42",
     "@operato/typeorm-history": "^10.0.0",
     "@things-factory/ai-client-base": "^10.1.39",
     "@things-factory/auth-base": "^10.1.40",
@@ -33,5 +33,5 @@
     "graphql-upload": "^15.0.2",
     "koa-router": "^7.4.0"
   },
-  "gitHead": "51c5d804c14ad8fcc6d4707e6ef80c9deede2766"
+  "gitHead": "982aa01403b979c4e348fd207a3fb4d1a7b5f521"
 }

package/server/service/figure/figure-gate.test.ts

@@ -120,8 +120,13 @@ describe('release gate — the base box', () => {
 
     expect(finding?.message).toMatch(/mm/)
     expect(finding?.why).toBeTruthy()
-    /* 화면의 칸 이름으로 부른다 — 저작자는 `base.y` 를 본 적이 없고 Y 라고 적힌 칸을 본다. */
-    expect(finding?.how).toMatch(/기준 상자의 Y/)
+    /*
+      화면의 칸 이름으로 부른다 — 저작자는 `base.y` 를 본 적이 없고 Y 라고 적힌 칸을 본다. 이 부품은 바닥 아래로
+      넘었고, 기준 상자의 밑면은 Y 0 에 고정이라 상자 크기로는 닿지 않는다 — 고칠 길은 부품을 올리는 것뿐이다
+      (figure-model 0.1.39, ADR-0065).
+    */
+    expect(finding?.how).toMatch(/Y 로 \d+(\.\d+)?mm 올리세요/)
+    expect(finding?.how).not.toMatch(/기준 상자의 Y 를 \d+/)
   })
 
   it('carries them for the placement face too', () => {

package/server/service/figure/figure-inspect-db.test.ts

@@ -128,3 +128,13 @@ describe('inspectFigureDraft — the verdict while editing', () => {
     expect(declaration).toContain('category: "figure", privilege: "query"')
   })
 })
+
+describe('format — which modeller a screen opens', () => {
+  it('reads the format off the stored source; a source it cannot identify has none', () => {
+    const query = new FigureQuery()
+    expect(query.format({ source: sound() } as any)).toBe('v3')
+    expect(query.format({ source: JSON.stringify({ version: 2, parts: [] }) } as any)).toBe('v2')
+    expect(query.format({ source: 'not json' } as any)).toBeNull()
+    expect(query.format({} as any)).toBeNull()
+  })
+})

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

@@ -1,5 +1,5 @@
 import { In } from 'typeorm'
-import { Args, Arg, Ctx, Directive, Query, Resolver, UseMiddleware } from 'type-graphql'
+import { Args, Arg, Ctx, Directive, FieldResolver, Query, Resolver, Root, UseMiddleware } from 'type-graphql'
 import { GraphQLJSON } from 'graphql-scalars'
 import { compile } from '@hatiolab/figure-model'
 
@@ -14,12 +14,29 @@ import {
 
 import { Figure } from './figure.js'
 import { FigureHistory } from './figure-history.js'
-import { consumablePayloadOf, inspectAnySource } from './figure-format.js'
+import { consumablePayloadOf, formatOf, inspectAnySource } from './figure-format.js'
 import { FigureInspection, FigureList } from './figure-type.js'
 
 @Resolver(Figure)
 @UseMiddleware(SpeakRefusals)
 export class FigureQuery {
+  /**
+   * Which format the stored source is in — so a screen opens the modeller that can edit it.
+   *
+   * The catalogue sent every figure to the V2 modeller. A converted figure there fails to open, and the V3 modeller
+   * could only be reached by typing its address (2026-09-24). The row does not say; the source does (`formatOf`).
+   * A source the server cannot identify has no format rather than a guessed one.
+   */
+  @FieldResolver(type => String, { nullable: true, description: "The format of the stored source: 'v2' or 'v3'." })
+  format(@Root() figure: Figure): string | null {
+    if (!figure.source) return null
+    try {
+      return formatOf(figure.source)
+    } catch {
+      return null
+    }
+  }
+
   @Directive('@privilege(category: "figure", privilege: "query", domainOwnerGranted: true)')
   @Query(returns => Figure, { nullable: true, description: 'Finds a single figure by its ID.' })
   async figure(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<Figure> {