@things-factory/shell 10.0.0-zeta.8 → 10.0.0

package/tests/list-param-operators.test.ts

@@ -0,0 +1,87 @@
+import 'reflect-metadata'
+import { Column, DataSource, Entity, PrimaryColumn, Repository } from 'typeorm'
+
+import { getQueryBuilderFromListParams } from '../server/utils/get-query-builder-from-list-params.js'
+import { ListParam } from '../server/service/common-types/list-param.js'
+
+/**
+ * 목록 필터 연산자의 SQL 이식성 회귀 테스트.
+ *
+ * 배경: 과거 boolean 연산자가 `IS TRUE/FALSE`(MSSQL/Oracle 미지원), 그리고
+ *      `IS PRESENT/BLANK/EMPTY NUMERIC ID`(어떤 DB 에서도 무효) 를 raw SQL 로 방출했다.
+ *      파라미터 바인딩 기반의 이식성 SQL 로 교체한 뒤, SQLite 에서 실제 실행 결과를 고정한다.
+ */
+
+@Entity()
+class Widget {
+  @PrimaryColumn({ type: 'integer' })
+  id!: number
+
+  @Column({ type: 'boolean', nullable: true })
+  flag!: boolean | null
+
+  @Column({ type: 'text', nullable: true })
+  title!: string | null
+
+  @Column({ type: 'integer', nullable: true })
+  refId!: number | null
+}
+
+let dataSource: DataSource
+let repository: Repository<Widget>
+
+beforeAll(async () => {
+  dataSource = new DataSource({
+    type: 'better-sqlite3',
+    database: ':memory:',
+    synchronize: true,
+    entities: [Widget]
+  })
+  await dataSource.initialize()
+  repository = dataSource.getRepository(Widget)
+
+  await repository.save([
+    { id: 1, flag: true, title: 'a', refId: 10 },
+    { id: 2, flag: false, title: '', refId: null },
+    { id: 3, flag: null, title: null, refId: 0 }
+  ])
+})
+
+afterAll(async () => {
+  await dataSource?.destroy()
+})
+
+/** 단일 필터로 조회한 결과 id 목록(정렬) */
+async function idsFor(name: string, operator: string): Promise<number[]> {
+  const params = { filters: [{ name, operator, value: null }] } as unknown as ListParam
+  const qb = getQueryBuilderFromListParams({ repository, params })
+  const rows = await qb.getMany()
+  return rows.map(r => r.id).sort((a, b) => a - b)
+}
+
+describe('list-param filter operators — SQLite 실행 결과 (이식성 SQL)', () => {
+  it('is_true / is_false (boolean 파라미터 바인딩)', async () => {
+    expect(await idsFor('flag', 'is_true')).toEqual([1])
+    expect(await idsFor('flag', 'is_false')).toEqual([2])
+  })
+
+  it('is_not_true / is_not_false (NULL 포함 의미 보존)', async () => {
+    // NOT TRUE = false 또는 NULL, NOT FALSE = true 또는 NULL
+    expect(await idsFor('flag', 'is_not_true')).toEqual([2, 3])
+    expect(await idsFor('flag', 'is_not_false')).toEqual([1, 3])
+  })
+
+  it('is_present / is_blank (값 있음 / 없음)', async () => {
+    expect(await idsFor('title', 'is_present')).toEqual([1, 2]) // IS NOT NULL ('' 은 not null)
+    expect(await idsFor('title', 'is_blank')).toEqual([3]) // IS NULL
+  })
+
+  it('is_empty_num_id (NULL 또는 0)', async () => {
+    expect(await idsFor('refId', 'is_empty_num_id')).toEqual([2, 3])
+  })
+
+  it('is_null / is_not_null (기존 연산자 회귀 확인)', async () => {
+    expect(await idsFor('flag', 'is_null')).toEqual([3])
+    expect(await idsFor('flag', 'is_not_null')).toEqual([1, 2])
+  })
+})

package/tests/manifest-contract.test.ts

@@ -0,0 +1,38 @@
+import type { ThingsFactoryClientConfig, ThingsFactoryServerModule } from '@things-factory/env'
+
+/**
+ * 모듈 매니페스트 계약 파일럿 (P1 4단계).
+ *
+ * 실제 모듈이 취하는 형태(클라이언트 config / 서버 export)가 매니페스트 타입을 만족하는지
+ * 컴파일 타임(ts-jest)에 고정한다. 형태가 계약과 어긋나면 이 스위트가 컴파일에 실패한다.
+ *
+ * 참고: things-factory.config.js 는 babel(preset-typescript)로 컴파일되어 타입이 검사되지 않으므로
+ *       (satisfies 도 그냥 제거됨), 계약 검증은 이처럼 tsc/ts-jest 가 타입 체크하는 지점에서 한다.
+ *       모듈이 자발적으로 계약을 채택하려면 tsc 로 검사되는 코드(서버 export 등)에서 satisfies 를 쓰거나
+ *       이와 같은 타입 어서션을 두면 된다.
+ */
+
+// 클라이언트 매니페스트 — shell 의 실제 things-factory.config 형태
+const clientConfig = {
+  bootstrap: () => {},
+  route: (page: string) => page,
+  routes: [{ tagname: 'page-404', page: 'page404' }]
+} satisfies ThingsFactoryClientConfig
+
+// 서버 모듈 — 대표적인 named export 형태(schema/entities/migrations/initMiddlewares)
+const serverModule = {
+  schema: { resolverClasses: [class SampleResolver {}], typeDefs: {}, resolvers: {}, directives: {} },
+  entities: [class SampleEntity {}],
+  migrations: [],
+  subscribers: [],
+  initMiddlewares: (_app: unknown) => {}
+} satisfies ThingsFactoryServerModule
+
+describe('모듈 매니페스트 계약 (P1)', () => {
+  it('클라이언트/서버 형태가 매니페스트 타입을 만족한다 (컴파일 타임 검증)', () => {
+    expect(clientConfig.routes.length).toBe(1)
+    expect(clientConfig.routes[0].tagname).toBe('page-404')
+    expect(Array.isArray(serverModule.entities)).toBe(true)
+    expect(typeof serverModule.initMiddlewares).toBe('function')
+  })
+})

package/client/store.ts

@@ -1,15 +0,0 @@
-import { configureStore } from '@reduxjs/toolkit'
-
-import app from './reducers/app.js'
-import route from './reducers/route.js'
-
-export const store = configureStore({
-  // set false due to causing severe conflicts with redux-devtools.
-  // devTools: false // process.env['NODE-ENV'] !== 'production'
-  devTools: process.env['NODE-ENV'] !== 'production'
-})
-
-store.addReducers({
-  app,
-  route
-})