sonamu 0.9.13 → 0.9.14

package/src/types/__tests__/entity-json-schema-search-text.test.ts

@@ -60,6 +60,45 @@ describe("EntityJsonSchema searchText/opclass validation", () => {
     expect(legacyResult.success).toBe(true);
   });
 
+  test("index where predicate는 raw SQL 문자열로 허용하되 빈 문자열은 거부해야 한다", () => {
+    const baseEntity = createBaseEntity();
+    const partialIndex = {
+      ...baseEntity,
+      indexes: [
+        {
+          ...baseEntity.indexes[0],
+          where: "deleted_at IS NULL",
+        },
+      ],
+    };
+    const partialResult = EntityJsonSchema.safeParse(partialIndex);
+    expect(partialResult.success).toBe(true);
+
+    const emptyPredicate = {
+      ...baseEntity,
+      indexes: [
+        {
+          ...baseEntity.indexes[0],
+          where: "",
+        },
+      ],
+    };
+    const emptyResult = EntityJsonSchema.safeParse(emptyPredicate);
+    expect(emptyResult.success).toBe(false);
+
+    const blankPredicate = {
+      ...baseEntity,
+      indexes: [
+        {
+          ...baseEntity.indexes[0],
+          where: "   ",
+        },
+      ],
+    };
+    const blankResult = EntityJsonSchema.safeParse(blankPredicate);
+    expect(blankResult.success).toBe(false);
+  });
+
   test("searchText source column 존재/타입 검증이 동작해야 한다", () => {
     const unknownSource = createBaseEntity();
     unknownSource.props[4] = {

package/src/types/types.ts

@@ -410,6 +410,8 @@ export type EntityIndex = {
   name: string;
   using?: "btree" | "hash" | "gin" | "gist" | "pgroonga";
   nullsNotDistinct?: boolean; // unique index only
+  /** PostgreSQL partial index predicate. Raw SQL WHERE expression without the WHERE keyword. */
+  where?: string;
   /**
    * HNSW (Hierarchical Navigable Small World) 인덱스: 각 노드의 최대 연결 수
    *
@@ -832,6 +834,8 @@ export type MigrationIndex = {
   name: string;
   using?: "btree" | "hash" | "gin" | "gist" | "pgroonga";
   nullsNotDistinct?: boolean;
+  /** PostgreSQL partial index predicate. Raw SQL WHERE expression without the WHERE keyword. */
+  where?: string;
   /** HNSW (Hierarchical Navigable Small World): 각 노드의 최대 연결 수 */
   m?: number;
   /** HNSW (Hierarchical Navigable Small World): 구성 시 탐색 범위 */
@@ -1495,6 +1499,7 @@ const EntityIndexSchema = z
     name: z.string().min(1).max(63),
     using: z.enum(["btree", "hash", "gin", "gist", "pgroonga"]).optional(),
     nullsNotDistinct: z.boolean().optional(),
+    where: z.string().trim().min(1).optional(),
     m: z.number().optional(),
     efConstruction: z.number().optional(),
     lists: z.number().optional(),

package/src/ui/entity.instructions.md

@@ -336,8 +336,11 @@
 2. 모든 엔티티는 `EntityNameOrderBy`, `EntityNameSearchField` Enum을 필수로 포함해야 합니다.
 3. 엔티티 내에서 사용하는 Enum ID는 엔티티 이름을 접두어로 사용합니다. (예: UserStatus, ProductType)
 4. indexes가 지정되지 않으면 빈 배열로 반환합니다.
-5. subsets이 지정되지 않으면 `{ "A": ["id"] }`로 반환합니다.
-6. relation 필드명은 `_id` 접미어 대신 관련 엔티티를 나타내는 이름을 사용합니다. (예: "user", "author", "category")
+5. partial index가 필요하면 index에 `where`를 raw SQL predicate로 지정합니다. (예:
+   `"where": "deleted_at IS NULL"`)
+6. `where`는 PostgreSQL partial index predicate로 그대로 사용되므로 사용자 입력을 조합하지 않습니다.
+7. subsets이 지정되지 않으면 `{ "A": ["id"] }`로 반환합니다.
+8. relation 필드명은 `_id` 접미어 대신 관련 엔티티를 나타내는 이름을 사용합니다. (예: "user", "author", "category")
 
 ### Property Rules
 
@@ -511,7 +514,8 @@
     {
       "name": "products_status_index",
       "type": "index",
-      "columns": [{ "name": "status" }]
+      "columns": [{ "name": "status" }],
+      "where": "status = 'active'"
     }
   ],
   "subsets": {