@things-factory/figure-service 10.1.70 → 10.1.72

package/scripts/templates.test.mts

@@ -0,0 +1,89 @@
+/*
+ * Every recipe template, verified (ADR-0095 amended: model first, verified, then the recipe).
+ *
+ *   node --test scripts/templates.test.mts
+ *
+ * For each template: its files are what its models build; each model passes the release gate, holds at half and twice
+ * its host, and moves through every control's range; the recipe put into a new host shows exactly each model; and the
+ * words and the picture are there.
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { existsSync, readdirSync, readFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+import { applyV3Proposal, applyV3Recipe, checkV3Recipe, compileV3Asset, inspectV3Asset, serializeV3Asset } from '@hatiolab/figure-model'
+import type { V3Asset } from '@hatiolab/figure-model'
+
+import { buildTemplate, modelFileOf, RECIPES } from './build-templates.mts'
+import { host } from '../recipes/_lib/model.mts'
+
+const names = readdirSync(RECIPES).filter(n => !n.startsWith('_') && existsSync(join(RECIPES, n, 'build.mts'))).sort()
+
+/** The bodies of a figure, rounded: what a person sees, to compare two figures by. */
+const bodies = (asset: V3Asset, state: Record<string, number> = {}) =>
+  (compileV3Asset(asset).evaluate(state).geometry as unknown as Array<{ id: string; visible?: boolean; pose: { t: number[] }; shape: { dimensions: Record<string, number> } }>)
+    .map(g => ({ id: g.id, shown: g.visible !== false, t: g.pose.t.map(v => Math.round(v)), d: Object.fromEntries(Object.entries(g.shape.dimensions).map(([k, v]) => [k, Math.round(v)])) }))
+    .sort((a, b) => a.id.localeCompare(b.id))
+/** A model's parts named as a recipe names them, so the two can be laid side by side. */
+const renamed = (list: ReturnType<typeof bodies>, id: string, parts: string[]) =>
+  list
+    .map(b => ({ ...b, id: parts.reduce((text, p) => text.replace(new RegExp(`(^|[^\\w-])${p.replace(/[-]/g, '\\-')}(?=[^\\w-]|$)`, 'g'), `$1${id}-${p}`), b.id) }))
+    .sort((a, b) => a.id.localeCompare(b.id))
+const partsOf = (asset: V3Asset) => asset.appearance.map(a => a.target).filter(t => t !== 'host')
+/** How high the model's host stands off the floor: the new host stands the same. */
+const hostGap = (asset: V3Asset) => {
+  const gap = asset.joints?.find(j => j.body1.part === 'host')?.origin?.gap
+  return typeof gap === 'number' ? gap : 0
+}
+const hostSize = (asset: V3Asset) => ({ x: asset.designInputs['host.size.x']!, y: asset.designInputs['host.size.y']!, z: asset.designInputs['host.size.z']! })
+const withHost = (asset: V3Asset, k: number) => ({ ...asset, designInputs: { ...asset.designInputs, ...Object.fromEntries(['x', 'y', 'z'].map(a => [`host.size.${a}`, asset.designInputs[`host.size.${a}`]! * k])) } })
+
+for (const name of names) {
+  test(`${name}: the files are what the models build`, async () => {
+    const { models, recipe } = await buildTemplate(name)
+    assert.deepEqual(JSON.parse(readFileSync(join(RECIPES, name, 'recipe.json'), 'utf-8')), JSON.parse(JSON.stringify(recipe)), 'recipe.json is up to date -- run scripts/build-templates.mts')
+    for (const { values, asset } of models) assert.equal(readFileSync(join(RECIPES, name, 'models', modelFileOf(values)), 'utf-8'), serializeV3Asset(asset), `models/${modelFileOf(values)} is up to date`)
+  })
+
+  test(`${name}: each model passes the gate, holds at half and twice its host, and moves through its controls`, async () => {
+    const { models } = await buildTemplate(name)
+    for (const { values, asset } of models) {
+      const at = JSON.stringify(values)
+      const declared = applyV3Proposal(asset, [{ kind: 'fit-room', placement: 'floor' } as never])
+      assert.deepEqual(inspectV3Asset(declared).violations, [], `${at}: the release gate`)
+      for (const k of [0.5, 2]) assert.doesNotThrow(() => compileV3Asset(withHost(asset, k)).evaluate(), `${at}: host × ${k}`)
+      for (const input of asset.document.model.inputs.filter(i => i.role === 'state'))
+        for (const v of [input.min!, input.max!]) assert.doesNotThrow(() => compileV3Asset(asset).evaluate({ [input.id]: v }), `${at}: ${input.id} at ${v}`)
+    }
+  })
+
+  test(`${name}: the recipe put into a new host shows each model, shut and at every control's end`, async () => {
+    const { models, recipe } = await buildTemplate(name)
+    assert.doesNotThrow(() => checkV3Recipe(structuredClone(recipe)))
+    for (const { values, asset } of models) {
+      const put = applyV3Recipe(host(hostSize(asset), 'Template check', hostGap(asset)), recipe, { target: 'host', values })
+      assert.deepEqual(bodies(put.asset), renamed(bodies(asset), put.id, partsOf(asset)), `${JSON.stringify(values)}: as the model`)
+      for (const input of asset.document.model.inputs.filter(i => i.role === 'state'))
+        assert.deepEqual(bodies(put.asset, { [`${put.id}-${input.id}`]: input.max! }), renamed(bodies(asset, { [input.id]: input.max! }), put.id, partsOf(asset)), `${JSON.stringify(values)}: ${input.id} at its end`)
+    }
+  })
+
+  test(`${name}: the words and the picture are there`, () => {
+    for (const file of ['guide.ko.md', 'guide.en.md', 'facts.md', 'thumbnail.png']) assert.ok(existsSync(join(RECIPES, name, file)), `${file}`)
+  })
+}
+
+/* The palette is the figure's, shared by every template put into it: one colour name, one colour, across all of them. */
+test('no two templates give one colour name two colours', async () => {
+  const seen = new Map<string, { value: string; by: string }>()
+  for (const name of names) {
+    const { recipe } = await buildTemplate(name)
+    for (const step of recipe.steps.filter(s => s.kind === 'set-material'))
+      for (const [token, value] of Object.entries((step.palette ?? {}) as Record<string, string>)) {
+        const before = seen.get(token)
+        assert.ok(!before || before.value === value, `${token}: ${before?.by} says ${before?.value}, ${name} says ${value}`)
+        seen.set(token, { value, by: name })
+      }
+  }
+})

package/server/index.ts

@@ -11,17 +11,13 @@ import { registerFigureToolCategories } from './service/figure/figure-tools.js'
 registerFigureToolCategories()
 
 /*
- * The built-in recipes into the system domain, as auth-base fills its privileges: once, and again gives the same result
- * (ADR-0095 condition 2). A recipe that fails its check is said here, not half put in.
+ * The recipe templates are read once at start (ADR-0095, amended): what was served, and any file whose form is wrong,
+ * said here rather than found by a person as a missing template.
  */
-import { seedBuiltInRecipes } from './service/figure-recipe/figure-recipe-store.js'
-process.on('bootstrap-module-start' as any, async () => {
-  try {
-    const { added, skipped, refused } = await seedBuiltInRecipes()
-    console.log(`[figure-service:bootstrap] recipes added ${added.length}, already there ${skipped.length}${refused.length ? `, refused: ${refused.join(' | ')}` : ''}`)
-  } catch (error) {
-    console.error('[figure-service:bootstrap] recipes were not seeded:', error)
-  }
+import { recipeTemplates } from './service/figure-recipe/figure-recipe-templates.js'
+process.on('bootstrap-module-start' as any, () => {
+  const { templates, refused } = recipeTemplates()
+  console.log(`[figure-service:bootstrap] recipe templates ${templates.length}${refused.length ? `, left out: ${refused.join(' | ')}` : ''}`)
 })
 
 export * from './service/index.js'

package/server/routers/figure-thumbnail-router.ts

@@ -4,7 +4,10 @@ import { In } from 'typeorm'
 import { checkPermission } from '@things-factory/auth-base'
 import { getRepository } from '@things-factory/shell'
 
+import { readFileSync } from 'fs'
+
 import { Figure } from '../service/figure/figure.js'
+import { recipeTemplates } from '../service/figure-recipe/figure-recipe-templates.js'
 
 /**
  * 썸네일을 **그림으로** 내보내는 길.
@@ -108,3 +111,24 @@ figureThumbnailRouter.get('/figure-thumbnail/:id', async (context, next) => {
 
   context.body = decoded.buffer
 })
+
+/**
+ * A recipe template's thumbnail (ADR-0095 amended): the file drawn from its model, served behind the same door as the
+ * templates themselves. The file changes only with a release, so a day's private cache is enough.
+ */
+figureThumbnailRouter.get('/figure-recipe-thumbnail/:name', async context => {
+  const { domain, user, unsafeIP, prohibitedPrivileges } = context.state
+  const allowed = await checkPermission({ category: 'figure', privilege: 'query', owner: true }, user, domain, unsafeIP, prohibitedPrivileges)
+  if (!allowed) {
+    context.status = 403
+    return
+  }
+  const template = recipeTemplates().templates.find(t => t.recipe.name === context.params.name)
+  if (!template?.thumbnail) {
+    context.status = 404
+    return
+  }
+  context.type = 'image/png'
+  context.set('Cache-Control', 'private, max-age=86400')
+  context.body = readFileSync(template.thumbnail)
+})

package/server/service/figure-recipe/figure-recipe-resolver.ts

@@ -1,42 +1,38 @@
-import { Arg, Ctx, Directive, Mutation, Query, Resolver, UseMiddleware } from 'type-graphql'
+import { Arg, Directive, Query, Resolver, UseMiddleware } from 'type-graphql'
 
 import { SpeakRefusals } from '@things-factory/shell'
 
-import { FigureRecipe } from './figure-recipe.js'
-import { deleteRecipe, recipesFor, saveRecipe, setRecipeState } from './figure-recipe-store.js'
+import { FigureRecipeTemplate } from './figure-recipe-type.js'
+import { inLanguage, recipeTemplates, type RecipeTemplate } from './figure-recipe-templates.js'
 
-@Resolver(FigureRecipe)
+const view = (t: RecipeTemplate, lang: string | undefined, withGuide: boolean): FigureRecipeTemplate => ({
+  name: t.recipe.name,
+  category: t.category,
+  tags: t.tags,
+  target: t.recipe.target,
+  title: inLanguage(t.recipe.title, lang),
+  description: inLanguage(t.recipe.description, lang),
+  source: JSON.stringify(t.recipe),
+  ...(withGuide ? { guide: inLanguage(t.guides, lang) } : {}),
+  hasThumbnail: !!t.thumbnail
+})
+
+@Resolver(FigureRecipeTemplate)
 @UseMiddleware(SpeakRefusals)
-export class FigureRecipeResolver {
+export class FigureRecipeTemplateQuery {
   @Directive('@privilege(category: "figure", privilege: "query", domainOwnerGranted: true)')
-  @Query(returns => [FigureRecipe], { description: "The recipes this domain sees: its own and its parent's (its own stand in by name). Released ones unless all is asked." })
-  async figureRecipes(@Arg('all', { nullable: true, description: 'Drafts as well.' }) all: boolean, @Ctx() context: ResolverContext): Promise<FigureRecipe[]> {
-    return await recipesFor(context.state.domain, all ? undefined : 'released')
-  }
-
-  @Directive('@privilege(category: "figure", privilege: "mutation", domainOwnerGranted: true)')
-  @Mutation(returns => FigureRecipe, { description: 'Saves a recipe into this domain by its name, after putting it into an empty room with its defaults (ADR-0095).' })
-  async saveFigureRecipe(
-    @Arg('source', { description: 'The recipe JSON (figure-model V3Recipe).' }) source: string,
-    @Arg('state', { nullable: true, description: "'draft' or 'released' (the default)." }) state: string,
-    @Ctx() context: ResolverContext
-  ): Promise<FigureRecipe> {
-    return await saveRecipe(context.state.domain, source, state === 'draft' ? 'draft' : 'released')
+  @Query(returns => [FigureRecipeTemplate], { description: 'The recipe templates the product ships, in the language asked. Guides are left out of the list.' })
+  figureRecipeTemplates(@Arg('lang', { nullable: true, description: 'The language of the titles (ko, en, …).' }) lang: string): FigureRecipeTemplate[] {
+    return recipeTemplates().templates.map(t => view(t, lang, false))
   }
 
-  @Directive('@privilege(category: "figure", privilege: "mutation", domainOwnerGranted: true)')
-  @Mutation(returns => FigureRecipe, { description: "Releases a recipe of this domain's own, or takes it back to draft. A parent's recipe is copied in to be changed." })
-  async setFigureRecipeState(
-    @Arg('name', { description: 'The recipe name.' }) name: string,
-    @Arg('state', { description: "'draft' or 'released'." }) state: string,
-    @Ctx() context: ResolverContext
-  ): Promise<FigureRecipe> {
-    return await setRecipeState(context.state.domain, name, state === 'draft' ? 'draft' : 'released')
-  }
-
-  @Directive('@privilege(category: "figure", privilege: "mutation", domainOwnerGranted: true)')
-  @Mutation(returns => Boolean, { description: "Deletes a recipe of this domain's own. Figures it was put into keep their parts." })
-  async deleteFigureRecipe(@Arg('name', { description: 'The recipe name.' }) name: string, @Ctx() context: ResolverContext): Promise<boolean> {
-    return await deleteRecipe(context.state.domain, name)
+  @Directive('@privilege(category: "figure", privilege: "query", domainOwnerGranted: true)')
+  @Query(returns => FigureRecipeTemplate, { nullable: true, description: 'One recipe template with its guide, in the language asked.' })
+  figureRecipeTemplate(
+    @Arg('name', { description: 'The template name.' }) name: string,
+    @Arg('lang', { nullable: true, description: 'The language of the words (ko, en, …).' }) lang: string
+  ): FigureRecipeTemplate | null {
+    const t = recipeTemplates().templates.find(one => one.recipe.name === name)
+    return t ? view(t, lang, true) : null
   }
 }

package/server/service/figure-recipe/figure-recipe-templates.test.ts

@@ -0,0 +1,47 @@
+/**
+ * 조각 템플릿 — 제품이 싣는 정적 파일(ADR-0095 고침). 기동 때는 형식만 읽으므로, 빈 방에 실제로 넣어 보는 것은 여기서 한다.
+ * 템플릿이 100개가 되어도 이 시험 하나가 전부를 넣어 본다.
+ */
+import { mkdtempSync, mkdirSync, writeFileSync } from 'fs'
+import { tmpdir } from 'os'
+import { join } from 'path'
+
+import { checkV3Recipe } from '@hatiolab/figure-model'
+
+import { inLanguage, recipeTemplates, RECIPE_DIR } from './figure-recipe-templates'
+
+describe('조각 템플릿 — 정적 파일', () => {
+  it('★ 실린 템플릿은 전부 형식이 맞고, 폴더 이름이 곧 이름이며, 기본값으로 빈 방에 들어가 발행 검사를 지난다', () => {
+    const { templates, refused } = recipeTemplates(RECIPE_DIR)
+    expect(refused).toEqual([])
+    const folders = require('fs').readdirSync(RECIPE_DIR, { withFileTypes: true }).filter((e: any) => e.isDirectory() && !e.name.startsWith('_')).map((e: any) => e.name).sort()
+    expect(templates.map(t => t.recipe.name)).toEqual(folders)
+    expect(templates.length).toBeGreaterThanOrEqual(22)
+    for (const t of templates) {
+      expect(() => checkV3Recipe(structuredClone(t.recipe))).not.toThrow()
+      expect(t.category).not.toBe('other')
+      for (const p of t.recipe.params) expect(Object.keys(p.hint ?? {}).sort()).toEqual(['en', 'ko'])
+      expect(Object.keys(t.guides).sort()).toEqual(['en', 'ko'])
+      expect(t.thumbnail).not.toBeNull()
+    }
+  })
+
+  it('★ 형식이 틀린 파일은 빠지고 이름과 까닭이 남는다 — 반쯤 내주지 않는다', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'recipes-'))
+    mkdirSync(join(dir, 'broken'))
+    writeFileSync(join(dir, 'broken', 'recipe.json'), JSON.stringify({ name: 'broken', title: { en: 'x' }, target: 'part', params: [], steps: [] }))
+    mkdirSync(join(dir, 'misnamed'))
+    writeFileSync(join(dir, 'misnamed', 'recipe.json'), JSON.stringify({ name: 'other', title: { en: 'x' }, target: 'part', params: [], steps: [{ kind: 'add-part' }] }))
+    const { templates, refused } = recipeTemplates(dir)
+    expect(templates).toEqual([])
+    expect(refused).toEqual([expect.stringMatching(/^broken: .*one step or more/), expect.stringMatching(/^misnamed: .*named other/)])
+  })
+
+  it('★ 말은 물은 언어로 — 없으면 그 언어의 기본, 그다음 영어', () => {
+    const words = { ko: '미닫이 문', en: 'sliding door' }
+    expect(inLanguage(words, 'ko')).toBe('미닫이 문')
+    expect(inLanguage(words, 'ko-KR')).toBe('미닫이 문')
+    expect(inLanguage(words, 'ja')).toBe('sliding door')
+    expect(inLanguage(undefined, 'ko')).toBe('')
+  })
+})

package/server/service/figure-recipe/figure-recipe-templates.ts

@@ -0,0 +1,70 @@
+import { existsSync, readdirSync, readFileSync } from 'fs'
+import { join, resolve } from 'path'
+
+import { parseV3Recipe } from '@hatiolab/figure-model'
+import type { V3Recipe } from '@hatiolab/figure-model'
+
+/**
+ * The recipe templates the product ships (ADR-0095, amended 2026-09-26): static files, served, not managed.
+ *
+ *     recipes/<name>/recipe.json        the command list, its parameters, category, tags, titles
+ *     recipes/<name>/guide.<lang>.md    how to use it, per language (English stands in for a missing one)
+ *     recipes/<name>/thumbnail.png      drawn by a script from the recipe put into the test room
+ *
+ * There is no table and no screen that changes them: a template is added or changed as a file, with the code. The
+ * start reads their form only; putting each into the test room is the tests' work (`figure-recipe-templates.test.ts`).
+ */
+export interface RecipeTemplate {
+  recipe: V3Recipe
+  category: string
+  tags: string[]
+  /** Guides by language code, as written. */
+  guides: Record<string, string>
+  thumbnail: string | null
+}
+
+/** The folder the templates are in: `recipes/` at the package root, beside `server/` and `dist-server/`. */
+export const RECIPE_DIR = resolve(__dirname, '..', '..', '..', 'recipes')
+
+let loaded: { templates: RecipeTemplate[]; refused: string[] } | null = null
+
+/** Every template, read once. One whose form is wrong is left out and named, not half served. */
+export function recipeTemplates(dir: string = RECIPE_DIR): { templates: RecipeTemplate[]; refused: string[] } {
+  if (loaded && dir === RECIPE_DIR) return loaded
+  const templates: RecipeTemplate[] = []
+  const refused: string[] = []
+  /* A folder starting with _ holds what the models are built with, not a template. */
+  const folders = existsSync(dir) ? readdirSync(dir, { withFileTypes: true }).filter(e => e.isDirectory() && !e.name.startsWith('_')).map(e => e.name).sort() : []
+  for (const folder of folders) {
+    const at = join(dir, folder)
+    try {
+      const raw = JSON.parse(readFileSync(join(at, 'recipe.json'), 'utf-8'))
+      const recipe = parseV3Recipe(raw)
+      if (recipe.name !== folder) throw new Error(`the recipe is named ${recipe.name}, its folder ${folder}`)
+      const guides: Record<string, string> = {}
+      for (const file of readdirSync(at)) {
+        const lang = /^guide\.([a-zA-Z-]+)\.md$/.exec(file)?.[1]
+        if (lang) guides[lang] = readFileSync(join(at, file), 'utf-8')
+      }
+      templates.push({
+        recipe,
+        category: typeof raw.category === 'string' ? raw.category : 'other',
+        tags: Array.isArray(raw.tags) ? raw.tags.filter((t: unknown) => typeof t === 'string') : [],
+        guides,
+        thumbnail: existsSync(join(at, 'thumbnail.png')) ? join(at, 'thumbnail.png') : null
+      })
+    } catch (error) {
+      refused.push(`${folder}: ${error instanceof Error ? error.message : String(error)}`)
+    }
+  }
+  const result = { templates, refused }
+  if (dir === RECIPE_DIR) loaded = result
+  return result
+}
+
+/** A word in the language asked: that language, its base (`ko` for `ko-KR`), English, then the first there is. */
+export function inLanguage(words: Record<string, string> | undefined, lang: string | undefined): string {
+  if (!words) return ''
+  const asked = lang || 'en'
+  return words[asked] ?? words[asked.split('-')[0]!] ?? words.en ?? Object.values(words)[0] ?? ''
+}

package/server/service/figure-recipe/figure-recipe-type.ts

@@ -0,0 +1,31 @@
+import { Field, ObjectType } from 'type-graphql'
+
+@ObjectType({ description: 'A recipe template the product ships: parts, their fastenings and motion, put onto a part in one step (ADR-0095).' })
+export class FigureRecipeTemplate {
+  @Field({ description: 'The template name: lower case, digits and hyphens.' })
+  name: string
+
+  @Field({ description: 'The category it is listed under (door, conveyor, …).' })
+  category: string
+
+  @Field(type => [String], { description: 'Words it is found by.' })
+  tags: string[]
+
+  @Field({ description: "'part' when it is put onto a chosen part, 'figure' when onto the whole figure." })
+  target: string
+
+  @Field({ description: 'Its title in the language asked (English stands in).' })
+  title: string
+
+  @Field({ description: 'Its one-line description in the language asked (English stands in).' })
+  description: string
+
+  @Field({ description: 'The recipe JSON (figure-model V3Recipe), as the modeller applies it.' })
+  source: string
+
+  @Field({ nullable: true, description: 'How to use it, as Markdown, in the language asked (English stands in). Only when one template is asked for.' })
+  guide?: string
+
+  @Field({ description: 'Whether it has a thumbnail image.' })
+  hasThumbnail: boolean
+}

package/server/service/figure-recipe/index.ts

@@ -1,5 +1,3 @@
-import { FigureRecipe } from './figure-recipe.js'
-import { FigureRecipeResolver } from './figure-recipe-resolver.js'
+import { FigureRecipeTemplateQuery } from './figure-recipe-resolver.js'
 
-export const entities = [FigureRecipe]
-export const resolvers = [FigureRecipeResolver]
+export const resolvers = [FigureRecipeTemplateQuery]

package/server/service/index.ts

@@ -3,8 +3,8 @@ export * from './figure/figure.js'
 export * from './figure/figure-type.js'
 export * from './figure/figure-format.js'
 export * from './figure/figure-history.js'
-export * from './figure-recipe/figure-recipe.js'
-export { recipesFor, saveRecipe, seedBuiltInRecipes, builtInRecipes } from './figure-recipe/figure-recipe-store.js'
+export * from './figure-recipe/figure-recipe-type.js'
+export { recipeTemplates, inLanguage, RECIPE_DIR } from './figure-recipe/figure-recipe-templates.js'
 
 // Entities, resolvers
 import {
@@ -12,9 +12,9 @@ import {
   resolvers as FigureResolvers,
   subscribers as FigureSubscribers
 } from './figure/index.js'
-import { entities as RecipeEntities, resolvers as RecipeResolvers } from './figure-recipe/index.js'
+import { resolvers as RecipeResolvers } from './figure-recipe/index.js'
 
-export const entities = [...FigureEntities, ...RecipeEntities]
+export const entities = [...FigureEntities]
 
 /* 판본 스냅샷을 뜨는 구독자. 셸이 이 이름으로 모아 TypeORM 에 등록한다(board-service 와 같다). */
 export const subscribers = [...FigureSubscribers]

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

@@ -1,41 +0,0 @@
-import { Domain } from '@things-factory/shell';
-import { FigureRecipe } from './figure-recipe.js';
-/**
- * The recipes a domain sees (ADR-0095 condition 2): its own and its parent's, as figures are read. A recipe of the
- * domain's own stands in for the parent's of the same name.
- */
-export declare function recipesFor(domain: {
-    id: string;
-    parentId?: string | null;
-}, state?: 'released'): Promise<FigureRecipe[]>;
-/**
- * A recipe saved into a domain, by its name: checked first by putting it into the test room with its defaults
- * (figure-model `checkV3Recipe`). Refused, it is not saved and the kernel's sentence goes back as it is.
- */
-export declare function saveRecipe(domain: Domain, source: unknown, state?: 'draft' | 'released'): Promise<FigureRecipe>;
-/** Released or back to draft: only released recipes are offered in the modeller. */
-export declare function setRecipeState(domain: {
-    id: string;
-}, name: string, state: 'draft' | 'released'): Promise<FigureRecipe>;
-/**
- * A recipe of the domain's own taken away. Figures it was put into keep their parts -- nothing ties them to it
- * (ADR-0095). Where the parent has one by that name, the parent's is seen again.
- */
-export declare function deleteRecipe(domain: {
-    id: string;
-}, name: string): Promise<boolean>;
-/** The recipes figure-model ships (`recipes/*.json`), as they are. */
-export declare function builtInRecipes(): Array<{
-    name: string;
-    source: string;
-}>;
-/**
- * The built-in recipes put into the system domain (ADR-0095 condition 2): once, and again gives the same result -- a
- * recipe already there by name is skipped, not overwritten, so a system recipe someone changed stays as they left it.
- * Each is checked as a saved one is; one that fails is left out and said, not half put in.
- */
-export declare function seedBuiltInRecipes(): Promise<{
-    added: string[];
-    skipped: string[];
-    refused: string[];
-}>;

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

@@ -1,105 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.recipesFor = recipesFor;
-exports.saveRecipe = saveRecipe;
-exports.setRecipeState = setRecipeState;
-exports.deleteRecipe = deleteRecipe;
-exports.builtInRecipes = builtInRecipes;
-exports.seedBuiltInRecipes = seedBuiltInRecipes;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const typeorm_1 = require("typeorm");
-const figure_model_1 = require("@hatiolab/figure-model");
-const shell_1 = require("@things-factory/shell");
-const figure_recipe_js_1 = require("./figure-recipe.js");
-/**
- * The recipes a domain sees (ADR-0095 condition 2): its own and its parent's, as figures are read. A recipe of the
- * domain's own stands in for the parent's of the same name.
- */
-async function recipesFor(domain, state) {
-    const ids = [domain.id, domain.parentId].filter(Boolean);
-    const rows = await (0, shell_1.getRepository)(figure_recipe_js_1.FigureRecipe).find({
-        where: { domain: { id: (0, typeorm_1.In)(ids) }, ...(state ? { state } : {}) },
-        relations: ['domain'],
-        order: { name: 'ASC' }
-    });
-    const byName = new Map();
-    for (const row of rows) {
-        const mine = row.domainId === domain.id || row.domain?.id === domain.id;
-        if (mine || !byName.has(row.name))
-            byName.set(row.name, row);
-    }
-    return [...byName.values()];
-}
-/**
- * A recipe saved into a domain, by its name: checked first by putting it into the test room with its defaults
- * (figure-model `checkV3Recipe`). Refused, it is not saved and the kernel's sentence goes back as it is.
- */
-async function saveRecipe(domain, source, state = 'released') {
-    const recipe = (0, figure_model_1.checkV3Recipe)(typeof source === 'string' ? JSON.parse(source) : source);
-    const repository = (0, shell_1.getRepository)(figure_recipe_js_1.FigureRecipe);
-    const existing = await repository.findOne({ where: { domain: { id: domain.id }, name: recipe.name } });
-    return await repository.save({ ...(existing ?? {}), domain, name: recipe.name, source: JSON.stringify(recipe), state });
-}
-/**
- * A recipe of the domain's own, by name. A parent's recipe is not the domain's to change: it is copied in under the same
- * name (`saveRecipe`), and the copy stands in for it.
- */
-async function ownRecipe(domain, name) {
-    const row = await (0, shell_1.getRepository)(figure_recipe_js_1.FigureRecipe).findOne({ where: { domain: { id: domain.id }, name } });
-    if (!row)
-        throw new Error(`${name} is not a recipe of this domain; a parent's recipe is copied here to be changed`);
-    return row;
-}
-/** Released or back to draft: only released recipes are offered in the modeller. */
-async function setRecipeState(domain, name, state) {
-    const row = await ownRecipe(domain, name);
-    return await (0, shell_1.getRepository)(figure_recipe_js_1.FigureRecipe).save({ ...row, state });
-}
-/**
- * A recipe of the domain's own taken away. Figures it was put into keep their parts -- nothing ties them to it
- * (ADR-0095). Where the parent has one by that name, the parent's is seen again.
- */
-async function deleteRecipe(domain, name) {
-    const row = await ownRecipe(domain, name);
-    await (0, shell_1.getRepository)(figure_recipe_js_1.FigureRecipe).softRemove(row);
-    return true;
-}
-/** The recipes figure-model ships (`recipes/*.json`), as they are. */
-function builtInRecipes() {
-    const dir = (0, path_1.join)((0, path_1.dirname)(require.resolve('@hatiolab/figure-model/package.json')), 'recipes');
-    return (0, fs_1.readdirSync)(dir)
-        .filter(file => file.endsWith('.json'))
-        .sort()
-        .map(file => {
-        const source = (0, fs_1.readFileSync)((0, path_1.join)(dir, file), 'utf-8');
-        return { name: JSON.parse(source).name, source };
-    });
-}
-/**
- * The built-in recipes put into the system domain (ADR-0095 condition 2): once, and again gives the same result -- a
- * recipe already there by name is skipped, not overwritten, so a system recipe someone changed stays as they left it.
- * Each is checked as a saved one is; one that fails is left out and said, not half put in.
- */
-async function seedBuiltInRecipes() {
-    const system = await (0, shell_1.getRepository)(shell_1.Domain).findOne({ where: { systemFlag: true } });
-    const result = { added: [], skipped: [], refused: [] };
-    if (!system)
-        return result;
-    const repository = (0, shell_1.getRepository)(figure_recipe_js_1.FigureRecipe);
-    for (const { name, source } of builtInRecipes()) {
-        if (await repository.count({ where: { domain: { id: system.id }, name } })) {
-            result.skipped.push(name);
-            continue;
-        }
-        try {
-            await saveRecipe(system, source);
-            result.added.push(name);
-        }
-        catch (error) {
-            result.refused.push(`${name}: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    return result;
-}
-//# sourceMappingURL=figure-recipe-store.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"figure-recipe-store.js","sourceRoot":"","sources":["../../../server/service/figure-recipe/figure-recipe-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { readdirSync, readFileSync } from 'fs'\nimport { dirname, join } from 'path'\nimport { In } from 'typeorm'\n\nimport { checkV3Recipe } from '@hatiolab/figure-model'\nimport { Domain, getRepository } from '@things-factory/shell'\n\nimport { FigureRecipe } from './figure-recipe.js'\n\n/**\n * The recipes a domain sees (ADR-0095 condition 2): its own and its parent's, as figures are read. A recipe of the\n * domain's own stands in for the parent's of the same name.\n */\nexport async function recipesFor(domain: { id: string; parentId?: string | null }, state?: 'released'): Promise<FigureRecipe[]> {\n  const ids = [domain.id, domain.parentId].filter(Boolean) as string[]\n  const rows = await getRepository(FigureRecipe).find({\n    where: { domain: { id: In(ids) }, ...(state ? { state } : {}) },\n    relations: ['domain'],\n    order: { name: 'ASC' }\n  })\n  const byName = new Map<string, FigureRecipe>()\n  for (const row of rows) {\n    const mine = row.domainId === domain.id || (row.domain as Domain | undefined)?.id === domain.id\n    if (mine || !byName.has(row.name!)) byName.set(row.name!, row)\n  }\n  return [...byName.values()]\n}\n\n/**\n * A recipe saved into a domain, by its name: checked first by putting it into the test room with its defaults\n * (figure-model `checkV3Recipe`). Refused, it is not saved and the kernel's sentence goes back as it is.\n */\nexport async function saveRecipe(domain: Domain, source: unknown, state: 'draft' | 'released' = 'released'): Promise<FigureRecipe> {\n  const recipe = checkV3Recipe(typeof source === 'string' ? JSON.parse(source) : source)\n  const repository = getRepository(FigureRecipe)\n  const existing = await repository.findOne({ where: { domain: { id: domain.id }, name: recipe.name } })\n  return await repository.save({ ...(existing ?? {}), domain, name: recipe.name, source: JSON.stringify(recipe), state })\n}\n\n/**\n * A recipe of the domain's own, by name. A parent's recipe is not the domain's to change: it is copied in under the same\n * name (`saveRecipe`), and the copy stands in for it.\n */\nasync function ownRecipe(domain: { id: string }, name: string): Promise<FigureRecipe> {\n  const row = await getRepository(FigureRecipe).findOne({ where: { domain: { id: domain.id }, name } })\n  if (!row) throw new Error(`${name} is not a recipe of this domain; a parent's recipe is copied here to be changed`)\n  return row\n}\n\n/** Released or back to draft: only released recipes are offered in the modeller. */\nexport async function setRecipeState(domain: { id: string }, name: string, state: 'draft' | 'released'): Promise<FigureRecipe> {\n  const row = await ownRecipe(domain, name)\n  return await getRepository(FigureRecipe).save({ ...row, state })\n}\n\n/**\n * A recipe of the domain's own taken away. Figures it was put into keep their parts -- nothing ties them to it\n * (ADR-0095). Where the parent has one by that name, the parent's is seen again.\n */\nexport async function deleteRecipe(domain: { id: string }, name: string): Promise<boolean> {\n  const row = await ownRecipe(domain, name)\n  await getRepository(FigureRecipe).softRemove(row)\n  return true\n}\n\n/** The recipes figure-model ships (`recipes/*.json`), as they are. */\nexport function builtInRecipes(): Array<{ name: string; source: string }> {\n  const dir = join(dirname(require.resolve('@hatiolab/figure-model/package.json')), 'recipes')\n  return readdirSync(dir)\n    .filter(file => file.endsWith('.json'))\n    .sort()\n    .map(file => {\n      const source = readFileSync(join(dir, file), 'utf-8')\n      return { name: JSON.parse(source).name, source }\n    })\n}\n\n/**\n * The built-in recipes put into the system domain (ADR-0095 condition 2): once, and again gives the same result -- a\n * recipe already there by name is skipped, not overwritten, so a system recipe someone changed stays as they left it.\n * Each is checked as a saved one is; one that fails is left out and said, not half put in.\n */\nexport async function seedBuiltInRecipes(): Promise<{ added: string[]; skipped: string[]; refused: string[] }> {\n  const system = await getRepository(Domain).findOne({ where: { systemFlag: true } })\n  const result = { added: [] as string[], skipped: [] as string[], refused: [] as string[] }\n  if (!system) return result\n  const repository = getRepository(FigureRecipe)\n  for (const { name, source } of builtInRecipes()) {\n    if (await repository.count({ where: { domain: { id: system.id }, name } })) {\n      result.skipped.push(name)\n      continue\n    }\n    try {\n      await saveRecipe(system, source)\n      result.added.push(name)\n    } catch (error) {\n      result.refused.push(`${name}: ${error instanceof Error ? error.message : String(error)}`)\n    }\n  }\n  return result\n}\n"]}

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

@@ -1,19 +0,0 @@
-import { Domain } from '@things-factory/shell';
-/**
- * FigureRecipe — 조각 하나(ADR-0095).
- *
- * 조각은 매개변수가 붙은 제안 명령 목록이다. 형식은 `@hatiolab/figure-model` 의 `V3Recipe` 가 정하고, 여기에는
- * 그 원본을 통째로 담는다 — Figure 가 자산을 `source` 로 담는 것과 같다. 매개변수 · 명령을 컬럼으로 두지 않는다.
- * 넣은 뒤의 부품은 조각과 이어지지 않으므로, 이 행을 고치거나 지워도 도형은 바뀌지 않는다.
- */
-export declare class FigureRecipe {
-    readonly id?: string;
-    domain?: Domain;
-    domainId?: string;
-    name?: string;
-    source?: string;
-    state?: 'draft' | 'released';
-    createdAt?: Date;
-    updatedAt?: Date;
-    deletedAt?: Date;
-}