@things-factory/figure-service 10.1.15 → 10.1.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-service",
-  "version": "10.1.15",
+  "version": "10.1.16",
   "publishConfig": {
     "access": "public",
     "@things-factory:registry": "https://registry.npmjs.org"
@@ -26,12 +26,12 @@
     "@hatiolab/figure-model": "^0.1.17",
     "@operato/typeorm-history": "^10.0.0",
     "@things-factory/ai-client-base": "^10.1.8",
-    "@things-factory/auth-base": "^10.1.7",
+    "@things-factory/auth-base": "^10.1.16",
     "@things-factory/env": "^10.1.3",
-    "@things-factory/shell": "^10.1.7",
+    "@things-factory/shell": "^10.1.16",
     "graphql-scalars": "^1.22.4",
     "graphql-upload": "^15.0.2",
     "koa-router": "^7.4.0"
   },
-  "gitHead": "0186eb7ec008781fd9f80b6f59379a91e0908820"
+  "gitHead": "aff86bc162b42c1d933711f7bc85a073f1ddcd29"
 }

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

@@ -175,4 +175,33 @@ describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)를 위
     expect(result.groups[0].members[0].name).toBe('box-1')
     expect(result.groups[0].members[0].transform.size.x).toBe(100)
   })
+
+  /*
+    Every test above calls the resolver method directly, so none of them passes through the
+    `@privilege` directive — that is attached when the schema is assembled. They stay green
+    whether the declaration is there or not.
+
+    Without a declaration this field is open to callers who have not even signed in
+    (`auth-rebuild.md` §1), so that gap is the thing worth guarding. The check reads the source
+    rather than the compiled output because the declaration is authored there, and it pins the
+    category: `figure` is the authoring permission, and requiring it here would leave board and
+    twin users with an empty palette. Someone who hits that wall will be tempted to delete this
+    line; the failure message is for them.
+  */
+  it('declares figure-published on the consumer door, not the authoring permission', () => {
+    const { readFileSync } = require('fs')
+    const { join } = require('path')
+    const source = readFileSync(join(__dirname, 'figure-query.ts'), 'utf-8')
+
+    const at = source.indexOf('async figureBlueprint')
+    expect(at).toBeGreaterThan(-1)
+
+    const preceding = source.slice(0, at)
+    const directive = preceding.lastIndexOf("@Directive('@privilege(")
+    const declaration = preceding.slice(directive, preceding.indexOf('\n', directive))
+
+    expect(declaration).toContain('category: "figure-published"')
+    expect(declaration).toContain('privilege: "query"')
+    expect(declaration).toContain('domainOwnerGranted: true')
+  })
 })

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

@@ -140,9 +140,25 @@ export class FigureQuery {
    * 4. 한 번도 발행된 적 없는 초안 자산이거나 존재하지 않는 타입인 경우 null을 반환하여
    *    미완성 자산이 씬 화면에 유출되는 것을 엄격히 차단한다.
    * 5. 도메인 상속 시 자식 도메인의 타입이 부모 도메인의 동일 타입을 항상 오버라이드한다.
-   * 6. 소비처(board, twin, things-scene) 사용자에게 저작 권한(figure:query)이 없어도
-   *    발행된 청사진을 열람할 수 있도록 도메인 인증 상태에서 열람을 허용한다.
+   * 6. 권한은 저작(`figure`)과 **다른 category** 인 `figure-published` 다. 소비처 사용자에게
+   *    저작 권한을 요구하면 board·twin 의 팔레트가 안 뜨고, 그렇다고 선언을 비우면 이 집에서는
+   *    로그인조차 안 한 사람에게 열린다(`auth-rebuild.md` §1). `<module>-published` 는
+   *    「그 모듈이 발행한 것을 남이 읽는 문」이라는 규약이다 — 아키텍트 판정(2026-09-15).
+   *
+   * ## 열거는 막혀 있다 — 지금은 우연이다
+   *
+   * 이 문의 열쇠는 `type` 하나뿐이라 이름을 모르면 못 꺼낸다. 그런데 그것이 **설계가 아니다** —
+   * 목록을 내는 `figures`·`figureTypeNames` 가 `figure` category 로 잠겨 있어서 결과적으로
+   * 그런 것뿐이다. 나중에 누가 소비처용 목록 문을 하나 더 열고 `figure-published` 를 붙이면
+   * 열거가 함께 열리고, 「이름을 알아야 한다」에 기대고 있던 가정이 조용히 사라진다.
+   * 그 문을 낼 사람이 이 단락을 읽고 그때 정하면 된다.
    */
+  /*
+    This directive is attached by schema assembly, so a test that calls the resolver method
+    directly never exercises it. `figure-blueprint-query.test.ts` reads this source for the
+    declaration instead — see the test named for it there.
+  */
+  @Directive('@privilege(category: "figure-published", privilege: "query", domainOwnerGranted: true)')
   @Query(returns => GraphQLJSON, {
     nullable: true,
     description: 'Compiled FigureBlueprint for external consumers (board, twin, things-scene). Only returns released figures.'