nucleus-core-ts 0.10.13 → 0.10.15

package/dist/src/Nucleus/routes/entity/searchCondition.d.ts

@@ -14,11 +14,15 @@ import { type SQL } from 'drizzle-orm';
  *
  * So the term is split, and the shape is inverted where it matters:
  *
- *   AND over words( OR over columns( column contains word ) )
+ *   AND over words( OR over columns( a word in the column STARTS with it ) )
  *
  * Every word must appear SOMEWHERE, not all in the same column. That also makes
  * word order irrelevant, which is right: nobody should have to know whether the
  * directory stores "Ayşe Yılmaz" or "Yılmaz, Ayşe".
+ *
+ * `WORD_START` below is the second half of the lesson, and it cost a second
+ * report from the same screen: splitting the term is not enough if each piece
+ * may then match in the middle of a word.
  */
 /**
  * A ceiling on how many words one search may ask about.

package/package.json

@@ -1,126 +1,126 @@
 {
-	"name": "nucleus-core-ts",
-	"version": "0.10.13",
-	"description": "Production-ready, enterprise-grade TypeScript framework for building multi-tenant APIs",
-	"author": "Hidayet Can Özcan <hidayetcan@gmail.com>",
-	"license": "SEE LICENSE IN LICENSE",
-	"keywords": [
-		"backend",
-		"framework",
-		"drizzle",
-		"typescript"
-	],
-	"files": [
-		"bin",
-		"dist",
-		"schemas",
-		"scripts",
-		"infra/templates",
-		"infra/scripts/generate-project.ts",
-		"src/system.tables.json",
-		"src/Services/SchemaTables/resolveEntities.ts",
-		"src/Services/Logger/auditTaxonomy.ts",
-		"public",
-		"LICENSE"
-	],
-	"module": "dist/index.js",
-	"type": "module",
-	"types": "dist/index.d.ts",
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"import": "./dist/index.js"
-		},
-		"./server": {
-			"types": "./dist/server.d.ts",
-			"import": "./dist/server.js"
-		},
-		"./client": {
-			"types": "./dist/client.d.ts",
-			"import": "./dist/client.js"
-		},
-		"./fe": {
-			"types": "./dist/fe/index.d.ts",
-			"import": "./dist/fe/index.js"
-		},
-		"./fe/auth": {
-			"types": "./dist/fe/components/AuthGuard/index.d.ts",
-			"import": "./dist/fe/components/AuthGuard/index.js"
-		},
-		"./proxy": {
-			"types": "./dist/src/Client/Proxy/index.d.ts",
-			"import": "./dist/src/Client/Proxy/index.js"
-		}
-	},
-	"scripts": {
-		"test": "bun test src scripts fe",
-		"build": "bun run scripts/build.ts",
-		"build:quick": "bun run build:js && bun run build:types",
-		"build:js": "bun build ./index.ts ./server.ts ./client.ts ./fe/index.ts ./src/Client/Proxy/index.ts --outdir=dist --target=bun --format=esm --splitting --minify --external react --external react-dom --external gsap --external @gsap/react --external h-state --external drizzle-orm --external drizzle-kit --external ioredis --external googleapis --external @dapr/dapr --external pg --external @xyflow/react --external @xyflow/system --external @azure/communication-email --external nodemailer --external @azure/identity --external stripe --external sharp",
-		"build:types": "tsc --declaration --emitDeclarationOnly --outDir dist --skipLibCheck",
-		"version:patch": "bun run scripts/version.ts patch",
-		"version:minor": "bun run scripts/version.ts minor",
-		"version:major": "bun run scripts/version.ts major",
-		"publish:npm": "bun run scripts/publish.ts",
-		"publish:dry": "bun run scripts/publish.ts --dry-run",
-		"release": "bun run version:patch && bun run publish:npm",
-		"release:minor": "bun run version:minor && bun run publish:npm",
-		"release:major": "bun run version:major && bun run publish:npm",
-		"generate:schemas": "bun run scripts/generate-types-schema.ts",
-		"lint": "biome check . --write",
-		"lint:fix": "biome check --config-path ./biome.json --write",
-		"prepublishOnly": "bun run scripts/verify-publishable.ts"
-	},
-	"bin": {
-		"nucleus-core-ts": "./bin/cli.ts",
-		"nucleus": "./bin/cli.ts",
-		"nucleus-generate": "./bin/cli.ts"
-	},
-	"devDependencies": {
-		"@biomejs/biome": "2.5.10",
-		"googleapis": "^171.4.0",
-		"@types/bun": "latest",
-		"@types/pg": "latest",
-		"@types/react": "latest",
-		"@happy-dom/global-registrator": "^20.11.2",
-		"@types/react-dom": "latest",
-		"bun-plugin-tailwind": "latest",
-		"drizzle-kit": "latest",
-		"javascript-obfuscator": "latest",
-		"lucide-react": "latest",
-		"nodemailer": "^9.0.3"
-	},
-	"peerDependencies": {
-		"typescript": "latest",
-		"@dapr/dapr": "latest",
-		"react": "latest",
-		"react-dom": "latest",
-		"pg": "latest",
-		"tailwindcss": "latest",
-		"tailwind-merge": "latest",
-		"clsx": "latest",
-		"googleapis": "*"
-	},
-	"dependencies": {
-		"@sinclair/typebox": "0.34.47",
-		"@gsap/react": "latest",
-		"@simplewebauthn/server": "^13.3.0",
-		"@xyflow/react": "latest",
-		"drizzle-orm": "latest",
-		"gsap": "latest",
-		"h-state": "latest",
-		"ioredis": "latest",
-		"reflect-metadata": "^0.2.2"
-	},
-	"optionalDependencies": {
-		"@azure/communication-email": "latest",
-		"@marsaud/smb2": "^0.18.0",
-		"sharp": "^0.33.0",
-		"stripe": "latest"
-	},
-	"peerDependenciesMeta": {
-		"googleapis": {
-			"optional": true
-		}
-	}
+  "name": "nucleus-core-ts",
+  "version": "0.10.15",
+  "description": "Production-ready, enterprise-grade TypeScript framework for building multi-tenant APIs",
+  "author": "Hidayet Can Özcan <hidayetcan@gmail.com>",
+  "license": "SEE LICENSE IN LICENSE",
+  "keywords": [
+    "backend",
+    "framework",
+    "drizzle",
+    "typescript"
+  ],
+  "files": [
+    "bin",
+    "dist",
+    "schemas",
+    "scripts",
+    "infra/templates",
+    "infra/scripts/generate-project.ts",
+    "src/system.tables.json",
+    "src/Services/SchemaTables/resolveEntities.ts",
+    "src/Services/Logger/auditTaxonomy.ts",
+    "public",
+    "LICENSE"
+  ],
+  "module": "dist/index.js",
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./fe": {
+      "types": "./dist/fe/index.d.ts",
+      "import": "./dist/fe/index.js"
+    },
+    "./fe/auth": {
+      "types": "./dist/fe/components/AuthGuard/index.d.ts",
+      "import": "./dist/fe/components/AuthGuard/index.js"
+    },
+    "./proxy": {
+      "types": "./dist/src/Client/Proxy/index.d.ts",
+      "import": "./dist/src/Client/Proxy/index.js"
+    }
+  },
+  "scripts": {
+    "test": "bun test src scripts fe",
+    "build": "bun run scripts/build.ts",
+    "build:quick": "bun run build:js && bun run build:types",
+    "build:js": "bun build ./index.ts ./server.ts ./client.ts ./fe/index.ts ./src/Client/Proxy/index.ts --outdir=dist --target=bun --format=esm --splitting --minify --external react --external react-dom --external gsap --external @gsap/react --external h-state --external drizzle-orm --external drizzle-kit --external ioredis --external googleapis --external @dapr/dapr --external pg --external @xyflow/react --external @xyflow/system --external @azure/communication-email --external nodemailer --external @azure/identity --external stripe --external sharp",
+    "build:types": "tsc --declaration --emitDeclarationOnly --outDir dist --skipLibCheck",
+    "version:patch": "bun run scripts/version.ts patch",
+    "version:minor": "bun run scripts/version.ts minor",
+    "version:major": "bun run scripts/version.ts major",
+    "publish:npm": "bun run scripts/publish.ts",
+    "publish:dry": "bun run scripts/publish.ts --dry-run",
+    "release": "bun run version:patch && bun run publish:npm",
+    "release:minor": "bun run version:minor && bun run publish:npm",
+    "release:major": "bun run version:major && bun run publish:npm",
+    "generate:schemas": "bun run scripts/generate-types-schema.ts",
+    "lint": "biome check . --write",
+    "lint:fix": "biome check --config-path ./biome.json --write",
+    "prepublishOnly": "bun run scripts/verify-publishable.ts"
+  },
+  "bin": {
+    "nucleus-core-ts": "./bin/cli.ts",
+    "nucleus": "./bin/cli.ts",
+    "nucleus-generate": "./bin/cli.ts"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.10",
+    "googleapis": "^171.4.0",
+    "@types/bun": "latest",
+    "@types/pg": "latest",
+    "@types/react": "latest",
+    "@happy-dom/global-registrator": "^20.11.2",
+    "@types/react-dom": "latest",
+    "bun-plugin-tailwind": "latest",
+    "drizzle-kit": "latest",
+    "javascript-obfuscator": "latest",
+    "lucide-react": "latest",
+    "nodemailer": "^9.0.3"
+  },
+  "peerDependencies": {
+    "typescript": "latest",
+    "@dapr/dapr": "latest",
+    "react": "latest",
+    "react-dom": "latest",
+    "pg": "latest",
+    "tailwindcss": "latest",
+    "tailwind-merge": "latest",
+    "clsx": "latest",
+    "googleapis": "*"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "0.34.47",
+    "@gsap/react": "latest",
+    "@simplewebauthn/server": "^13.3.0",
+    "@xyflow/react": "latest",
+    "drizzle-orm": "latest",
+    "gsap": "latest",
+    "h-state": "latest",
+    "ioredis": "latest",
+    "reflect-metadata": "^0.2.2"
+  },
+  "optionalDependencies": {
+    "@azure/communication-email": "latest",
+    "@marsaud/smb2": "^0.18.0",
+    "sharp": "^0.33.0",
+    "stripe": "latest"
+  },
+  "peerDependenciesMeta": {
+    "googleapis": {
+      "optional": true
+    }
+  }
 }

package/scripts/generate-schema.test.ts

@@ -1,5 +1,10 @@
 import { describe, expect, it } from 'bun:test'
-import { generateColumnCode, generateTableCode, selectEmittedTables } from './generate-schema'
+import {
+  generateColumnCode,
+  generateRelationsFile,
+  generateTableCode,
+  selectEmittedTables,
+} from './generate-schema'
 
 const table = (table_name: string) => ({ table_name })
 
@@ -214,3 +219,57 @@ describe('table-level constraints', () => {
     expect(code).not.toContain('check(')
   })
 })
+
+describe('generateRelationsFile', () => {
+  const branchTable = {
+    table_name: 'survey_branches',
+    columns: [
+      {
+        name: 'trigger_question_id',
+        type: 'uuid',
+        references: { table: 'survey_questions', column: 'id' },
+      },
+      {
+        name: 'target_question_id',
+        type: 'uuid',
+        references: { table: 'survey_questions', column: 'id' },
+      },
+      {
+        name: 'survey_id',
+        type: 'uuid',
+        references: { table: 'surveys', column: 'id' },
+      },
+    ],
+  }
+
+  it('names two references to the SAME table after their columns', () => {
+    /*
+     * Both used to be emitted as `surveyQuestions:`, so the object literal had
+     * the same key twice and the generated file did not compile — a config
+     * change that produces broken output rather than a wrong result. A branch
+     * whose trigger and target are both questions is what found it; `created_by`
+     * with `updated_by` would have found it just as well.
+     */
+    const code = generateRelationsFile([
+      branchTable,
+      { table_name: 'survey_questions' },
+      { table_name: 'surveys' },
+    ] as never)
+
+    expect(code).toContain('triggerQuestion: one(surveyQuestions')
+    expect(code).toContain('targetQuestion: one(surveyQuestions')
+    expect(code.match(/surveyQuestions: one\(/g)).toBeNull()
+  })
+
+  it('and leaves a lone reference named after its table, as before', () => {
+    // The control: renaming everything would churn every existing generated
+    // file and rename relations consumers already query by.
+    const code = generateRelationsFile([
+      branchTable,
+      { table_name: 'survey_questions' },
+      { table_name: 'surveys' },
+    ] as never)
+
+    expect(code).toContain('surveys: one(surveys')
+  })
+})

package/scripts/generate-schema.ts

@@ -607,7 +607,7 @@ function topologicalSort(tables: TableDef[], allTableNames: string[]): TableDef[
   return result
 }
 
-function generateRelationsFile(tables: TableDef[]): string {
+export function generateRelationsFile(tables: TableDef[]): string {
   const allTableNames = new Set(tables.map((t) => t.table_name))
   const relationsByTable: Map<
     string,
@@ -640,9 +640,37 @@ function generateRelationsFile(tables: TableDef[]): string {
     const fromTable = toCamelCase(tableName)
     code += `export const ${fromTable}Relations = relations(${fromTable}, ({ one, many }) => ({\n`
 
+    /*
+     * How many of this table's foreign keys point at the same table.
+     *
+     * The relation used to be named after the TARGET TABLE, which is fine until
+     * a table references the same one twice — and then the generator emits two
+     * properties with the same key and the output does not compile:
+     *
+     *   surveyQuestions: one(surveyQuestions, { fields: [...triggerQuestionId] }),
+     *   surveyQuestions: one(surveyQuestions, { fields: [...targetQuestionId] }),
+     *
+     * That is not an exotic shape. `created_by`/`updated_by`, `from_user`/
+     * `to_user`, and here a branch's trigger question and its target question
+     * all land on it. Found when survey branching grew a second kind of target.
+     */
+    const referencesToTable = new Map<string, number>()
+    for (const rel of rels) {
+      referencesToTable.set(rel.to, (referencesToTable.get(rel.to) ?? 0) + 1)
+    }
+
     for (const rel of rels) {
       const toTable = toCamelCase(rel.to)
-      const relationName = rel.isSelf ? 'parent' : toTable
+      // Only the ambiguous ones are renamed, so a config with one reference per
+      // table generates exactly what it generated before.
+      const ambiguous = (referencesToTable.get(rel.to) ?? 0) > 1
+      const relationName = ambiguous
+        ? // `trigger_question_id` -> `triggerQuestion`: the column says which of
+          // the two this is, which is the only thing that tells them apart.
+          toCamelCase(rel.fromCol.replace(/_id$/, ''))
+        : rel.isSelf
+          ? 'parent'
+          : toTable
       const fields = `${fromTable}.${toCamelCase(rel.fromCol)}`
       const references = `${toTable}.${toCamelCase(rel.toCol)}`
 

package/scripts/version.ts

@@ -27,7 +27,14 @@ async function readPackageJson(): Promise<PackageJson> {
 }
 
 async function writePackageJson(pkg: PackageJson): Promise<void> {
-  await writeFile('package.json', `${JSON.stringify(pkg, null, '\t')}\n`)
+  /*
+   * Two spaces, because that is what `biome.json` asks for.
+   *
+   * This wrote tabs, which reformatted the WHOLE file on every release and made
+   * the Lint gate fail on the release commit itself — a red CI caused by cutting
+   * a version, with a diff of 126 lines hiding the one line that changed.
+   */
+  await writeFile('package.json', `${JSON.stringify(pkg, null, 2)}\n`)
 }
 
 function parseVersion(version: string): {