@things-factory/figure-service 10.1.3 → 10.1.6

package/server/service/figure/figure.ts

@@ -45,9 +45,21 @@ export class Figure {
   @Field(type => ID, { nullable: true, description: 'Unique identifier for the figure.' })
   readonly id?: string
 
-  @Column({ nullable: true, default: 1 })
-  @Field(type => Int, { nullable: true, description: 'Revision counter, incremented on each save.' })
-  version?: number = 1
+  /**
+   * 발행된 판의 번호 — **발행할 때만 올라간다.**
+   *
+   * 저장 횟수가 아니다. 저작 중에는 몇 번을 고쳐 저장하든 그대로이고, `draft` 가 `released` 가
+   * 되는 순간에만 하나 오른다. 소비처가 「몇 번째 판을 쓰고 있나」를 이 값으로 말한다.
+   *
+   * 한 번도 발행되지 않았으면 **0** 이다. 1 로 시작하면 아직 아무에게도 약속하지 않은 초안이
+   * 첫 판인 것처럼 보인다.
+   */
+  @Column({ nullable: true, default: 0 })
+  @Field(type => Int, {
+    nullable: true,
+    description: 'Published version. Raised when the figure is released, not when it is saved. 0 means never released.'
+  })
+  version?: number = 0
 
   @ManyToOne(type => Domain)
   @Field(type => Domain, { nullable: true, description: 'The domain this figure belongs to.' })

package/server/service/figure/index.ts

@@ -1,6 +1,9 @@
 import { Figure } from './figure.js'
+import { FigureHistory } from './figure-history.js'
 import { FigureQuery } from './figure-query.js'
 import { FigureMutation } from './figure-mutation.js'
+import { FigureHistoryEntitySubscriber } from './event-subscriber.js'
 
-export const entities = [Figure]
+export const entities = [Figure, FigureHistory]
 export const resolvers = [FigureQuery, FigureMutation]
+export const subscribers = [FigureHistoryEntitySubscriber]

package/server/service/index.ts

@@ -2,9 +2,30 @@
 export * from './figure/figure.js'
 export * from './figure/figure-type.js'
 export * from './figure/figure-source.js'
+export * from './figure/figure-history.js'
 
 // Entities, resolvers
-import { entities as FigureEntities, resolvers as FigureResolvers } from './figure/index.js'
+import {
+  entities as FigureEntities,
+  resolvers as FigureResolvers,
+  subscribers as FigureSubscribers
+} from './figure/index.js'
 
 export const entities = [...FigureEntities]
-export const resolvers = [...FigureResolvers]
+
+/* 판본 스냅샷을 뜨는 구독자. 셸이 이 이름으로 모아 TypeORM 에 등록한다(board-service 와 같다). */
+export const subscribers = [...FigureSubscribers]
+
+/*
+ * The shell reads `schema.resolverClasses` from every module — nothing else.
+ *
+ *     shell/dist-server/schema.js   orderedModuleNames.map(dep => loader(dep).schema)
+ *
+ * This module used to export the classes as a bare `resolvers` array, a name the shell never looks
+ * at. The table was migrated and the resolver classes were compiled, and still every query failed
+ * with `Cannot query field "figures" on type "Query"` — the field was not in the schema at all.
+ * board-service, ops-master and font-base all export the shape below.
+ */
+export const schema = {
+  resolverClasses: [...FigureResolvers]
+}