@things-factory/shell 10.1.121 → 10.1.123

package/dist-server/typeorm/money-column.d.ts

@@ -0,0 +1,34 @@
+import { ColumnOptions, ValueTransformer } from 'typeorm';
+/**
+ * `decimal` 컬럼을 숫자로 읽고 쓰는 변환기.
+ *
+ * Postgres·MySQL 은 `decimal` 을 **문자열**로 돌려준다(정밀도를 지키려고). 그대로 두면
+ * GraphQL `Float` 필드와 합산 코드가 `'1200.00' + 300` 같은 글자 이어붙이기를 한다.
+ * 그래서 읽을 때 숫자로 바꾼다. 비어 있음(`null`·`undefined`)은 그대로 둔다 — 0 으로 만들지 않는다.
+ */
+export declare const decimalTransformer: ValueTransformer;
+/**
+ * 금액 컬럼 — `decimal(18, 2)`.
+ *
+ * ## 왜 `decimal` 인가
+ *
+ * - 형식을 적지 않은 `number` 컬럼은 32비트 정수가 된다. 원 단위로는 정확하지만 한 칸에
+ *   약 21억까지이고 소수(센트)를 못 담는다.
+ * - `float` 은 0.1 을 정확히 담지 못한다. 수천 줄을 더하면 은행 잔액과 어긋난다.
+ * - `decimal` 은 SQL 표준이라 다섯 드라이버(postgres·mysql/mariadb·sqlite·mssql·oracle)가 모두 받는다.
+ *   18자리 중 소수 2자리 — 원화 금액 전부와 외화 센트를 담는다.
+ *
+ * sqlite 는 자릿수를 강제하지 않는다(NUMERIC 친화형). 정수 원화는 정확하지만 소수 금액은
+ * 내부에서 실수로 담길 수 있다 — 소수 금액의 정확성은 서버 DB 를 전제로 한다.
+ *
+ * ## 쓰는 법
+ *
+ * ```ts
+ * @Column({ nullable: true, ...moneyColumn() })
+ * @Field(type => Float, { nullable: true })
+ * supplyAmount?: number
+ * ```
+ *
+ * `nullable`·`default` 같은 나머지 옵션은 호출하는 쪽이 정한다. GraphQL 필드는 `Float` 로 둔다.
+ */
+export declare function moneyColumn(options?: ColumnOptions): ColumnOptions;

package/dist-server/typeorm/money-column.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decimalTransformer = void 0;
+exports.moneyColumn = moneyColumn;
+/**
+ * `decimal` 컬럼을 숫자로 읽고 쓰는 변환기.
+ *
+ * Postgres·MySQL 은 `decimal` 을 **문자열**로 돌려준다(정밀도를 지키려고). 그대로 두면
+ * GraphQL `Float` 필드와 합산 코드가 `'1200.00' + 300` 같은 글자 이어붙이기를 한다.
+ * 그래서 읽을 때 숫자로 바꾼다. 비어 있음(`null`·`undefined`)은 그대로 둔다 — 0 으로 만들지 않는다.
+ */
+exports.decimalTransformer = {
+    to: (value) => (value === undefined ? undefined : value === null || value === '' ? null : Number(value)),
+    from: (value) => (value === null || value === undefined ? value : Number(value))
+};
+/**
+ * 금액 컬럼 — `decimal(18, 2)`.
+ *
+ * ## 왜 `decimal` 인가
+ *
+ * - 형식을 적지 않은 `number` 컬럼은 32비트 정수가 된다. 원 단위로는 정확하지만 한 칸에
+ *   약 21억까지이고 소수(센트)를 못 담는다.
+ * - `float` 은 0.1 을 정확히 담지 못한다. 수천 줄을 더하면 은행 잔액과 어긋난다.
+ * - `decimal` 은 SQL 표준이라 다섯 드라이버(postgres·mysql/mariadb·sqlite·mssql·oracle)가 모두 받는다.
+ *   18자리 중 소수 2자리 — 원화 금액 전부와 외화 센트를 담는다.
+ *
+ * sqlite 는 자릿수를 강제하지 않는다(NUMERIC 친화형). 정수 원화는 정확하지만 소수 금액은
+ * 내부에서 실수로 담길 수 있다 — 소수 금액의 정확성은 서버 DB 를 전제로 한다.
+ *
+ * ## 쓰는 법
+ *
+ * ```ts
+ * @Column({ nullable: true, ...moneyColumn() })
+ * @Field(type => Float, { nullable: true })
+ * supplyAmount?: number
+ * ```
+ *
+ * `nullable`·`default` 같은 나머지 옵션은 호출하는 쪽이 정한다. GraphQL 필드는 `Float` 로 둔다.
+ */
+function moneyColumn(options = {}) {
+    return { type: 'decimal', precision: 18, scale: 2, transformer: exports.decimalTransformer, ...options };
+}
+//# sourceMappingURL=money-column.js.map

package/dist-server/typeorm/money-column.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money-column.js","sourceRoot":"","sources":["../../server/typeorm/money-column.ts"],"names":[],"mappings":";;;AAsCA,kCAEC;AAtCD;;;;;;GAMG;AACU,QAAA,kBAAkB,GAAqB;IAClD,EAAE,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjH,IAAI,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;CAC1F,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,WAAW,CAAC,UAAyB,EAAE;IACrD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,0BAAkB,EAAE,GAAG,OAAO,EAAE,CAAA;AAClG,CAAC","sourcesContent":["import { ColumnOptions, ValueTransformer } from 'typeorm'\n\n/**\n * `decimal` 컬럼을 숫자로 읽고 쓰는 변환기.\n *\n * Postgres·MySQL 은 `decimal` 을 **문자열**로 돌려준다(정밀도를 지키려고). 그대로 두면\n * GraphQL `Float` 필드와 합산 코드가 `'1200.00' + 300` 같은 글자 이어붙이기를 한다.\n * 그래서 읽을 때 숫자로 바꾼다. 비어 있음(`null`·`undefined`)은 그대로 둔다 — 0 으로 만들지 않는다.\n */\nexport const decimalTransformer: ValueTransformer = {\n  to: (value: unknown) => (value === undefined ? undefined : value === null || value === '' ? null : Number(value)),\n  from: (value: unknown) => (value === null || value === undefined ? value : Number(value))\n}\n\n/**\n * 금액 컬럼 — `decimal(18, 2)`.\n *\n * ## 왜 `decimal` 인가\n *\n * - 형식을 적지 않은 `number` 컬럼은 32비트 정수가 된다. 원 단위로는 정확하지만 한 칸에\n *   약 21억까지이고 소수(센트)를 못 담는다.\n * - `float` 은 0.1 을 정확히 담지 못한다. 수천 줄을 더하면 은행 잔액과 어긋난다.\n * - `decimal` 은 SQL 표준이라 다섯 드라이버(postgres·mysql/mariadb·sqlite·mssql·oracle)가 모두 받는다.\n *   18자리 중 소수 2자리 — 원화 금액 전부와 외화 센트를 담는다.\n *\n * sqlite 는 자릿수를 강제하지 않는다(NUMERIC 친화형). 정수 원화는 정확하지만 소수 금액은\n * 내부에서 실수로 담길 수 있다 — 소수 금액의 정확성은 서버 DB 를 전제로 한다.\n *\n * ## 쓰는 법\n *\n * ```ts\n * @Column({ nullable: true, ...moneyColumn() })\n * @Field(type => Float, { nullable: true })\n * supplyAmount?: number\n * ```\n *\n * `nullable`·`default` 같은 나머지 옵션은 호출하는 쪽이 정한다. GraphQL 필드는 `Float` 로 둔다.\n */\nexport function moneyColumn(options: ColumnOptions = {}): ColumnOptions {\n  return { type: 'decimal', precision: 18, scale: 2, transformer: decimalTransformer, ...options }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/shell",
-  "version": "10.1.121",
+  "version": "10.1.123",
   "description": "Core module for framework",
   "bin": {
     "things-factory": "bin/things-factory",
@@ -56,7 +56,7 @@
     "@things-factory/ejs-remote": "^10.1.20",
     "@things-factory/env": "^10.1.20",
     "@things-factory/operato-license-checker": "^4.0.4",
-    "@things-factory/styles": "^10.1.121",
+    "@things-factory/styles": "^10.1.123",
     "@things-factory/utils": "^10.1.20",
     "@types/koa": "^3.0.1",
     "@types/koa-bodyparser": "^4.3.13",
@@ -126,5 +126,5 @@
     "pg": "^8.7.3",
     "sqlite3": "^5.0.8"
   },
-  "gitHead": "23536a73b10f103048a2c893d3960b2a4e0f03dd"
+  "gitHead": "9781f1eb37a7e6a37285878cff16f8683747eb7a"
 }

package/tests/money-column.test.ts

@@ -0,0 +1,34 @@
+import { decimalTransformer, moneyColumn } from '../server/typeorm/money-column'
+
+/**
+ * Money is a `decimal(18, 2)` column read back as a number.
+ *
+ * Postgres and MySQL hand `decimal` back as a string. Left alone, a sum over rows becomes string
+ * concatenation ('1200.00' + 300 = '1200.00300') and the GraphQL Float field receives text.
+ */
+describe('a money column', () => {
+  it('is decimal(18, 2) with the number transformer', () => {
+    expect(moneyColumn()).toEqual({ type: 'decimal', precision: 18, scale: 2, transformer: decimalTransformer })
+  })
+
+  it('keeps the options the caller gives', () => {
+    expect(moneyColumn({ nullable: true, default: 0 })).toMatchObject({ type: 'decimal', nullable: true, default: 0 })
+  })
+
+  it('reads a driver string as a number', () => {
+    expect(decimalTransformer.from('1200.00')).toBe(1200)
+    expect(decimalTransformer.from('-71200000.50')).toBe(-71200000.5)
+  })
+
+  it('leaves an empty value empty, never 0', () => {
+    expect(decimalTransformer.from(null)).toBeNull()
+    expect(decimalTransformer.from(undefined)).toBeUndefined()
+    expect(decimalTransformer.to(null)).toBeNull()
+    expect(decimalTransformer.to('')).toBeNull()
+    expect(decimalTransformer.to(undefined)).toBeUndefined()
+  })
+
+  it('writes a number given as text as a number', () => {
+    expect(decimalTransformer.to('658630')).toBe(658630)
+  })
+})

package/tests/styles-sources-load.test.ts

@@ -0,0 +1,75 @@
+import { spawnSync } from 'child_process'
+import { readdirSync, readFileSync, statSync } from 'fs'
+import path from 'path'
+import ts from 'typescript'
+
+/*
+ * @things-factory/styles is published as source: no build, no compiler. A backtick in a comment inside a
+ * css`` template ends the template early, and nothing catches it until an app bundles the file -
+ * 10.1.121 shipped that way (surface-styles.js, a path written in backticks in a comment), and every
+ * app that loads the package failed to bundle (2026-10-05, ADR-0117).
+ *
+ * Each style file is loaded by node on its own. index.js is left out: it imports without extensions,
+ * which the bundler resolves and node does not.
+ */
+const SRC = path.resolve(__dirname, '../../styles/src')
+
+const styleFiles = () => readdirSync(SRC).filter(name => name.endsWith('.js') && name !== 'index.js')
+
+describe('@things-factory/styles sources', () => {
+  it('has style files to load - an empty list would make the check below pass on nothing', () => {
+    expect(styleFiles().length).toBeGreaterThan(3)
+  })
+
+  it.each(styleFiles())('%s loads as a module', name => {
+    const file = path.join(SRC, name)
+    const run = spawnSync(process.execPath, ['--input-type=module', '-e', `await import(${JSON.stringify(file)})`], {
+      cwd: SRC,
+      encoding: 'utf8'
+    })
+    expect(run.stderr.split('\n').filter(line => /Error|Unexpected/.test(line))).toEqual([])
+    expect(run.status).toBe(0)
+  })
+})
+
+/*
+ * The same hole elsewhere (counted 2026-10-05): files that go out with no compiler reading them before
+ * publish - component-ui has no build script at all (its .ts is compiled only inside each app's bundle),
+ * and two .js entries that the packages' tsc does not read. They are parsed here for syntax; a template
+ * cut short by a backtick is a syntax error to the parser.
+ */
+const PACKAGES = path.resolve(__dirname, '../..')
+
+function filesUnder(dir: string): string[] {
+  const out: string[] = []
+  for (const name of readdirSync(dir)) {
+    if (name === 'node_modules' || name.startsWith('dist')) continue
+    const full = path.join(dir, name)
+    if (statSync(full).isDirectory()) out.push(...filesUnder(full))
+    else if (/\.(ts|js)$/.test(name) && !name.endsWith('.d.ts')) out.push(full)
+  }
+  return out
+}
+
+const UNCOMPILED = [
+  ...filesUnder(path.join(PACKAGES, 'component-ui/client')),
+  path.join(PACKAGES, 'board-service/client/entries/headless-scene-components.js'),
+  path.join(PACKAGES, 'shell/client/entries/public/home.js')
+]
+
+describe('client files no compiler reads before publish', () => {
+  it('found the files - an empty list would pass on nothing', () => {
+    expect(UNCOMPILED.length).toBeGreaterThan(5)
+  })
+
+  it.each(UNCOMPILED.map(file => path.relative(PACKAGES, file)))('%s parses', relative => {
+    const file = path.join(PACKAGES, relative)
+    const result = ts.transpileModule(readFileSync(file, 'utf8'), {
+      fileName: file,
+      reportDiagnostics: true,
+      compilerOptions: { target: ts.ScriptTarget.ES2022, module: ts.ModuleKind.ESNext, experimentalDecorators: true, allowJs: true }
+    })
+    const syntax = (result.diagnostics ?? []).map(d => ts.flattenDiagnosticMessageText(d.messageText, '\n'))
+    expect(syntax).toEqual([])
+  })
+})