@gridfox/codegen 0.2.0

package/dist/validate/renderCrudTest.js

@@ -0,0 +1,180 @@
+const planLiteral = (plan) => JSON.stringify(plan, null, 2);
+export const buildCrudTestSource = (plan) => {
+    return `import { gridfoxTables } from '../generated/tables.js'
+
+declare const process: {
+  env: Record<string, string | undefined>
+  exitCode?: number
+}
+
+const apiKey = process.env.GRIDFOX_API_KEY
+if (!apiKey) {
+  throw new Error('Missing GRIDFOX_API_KEY')
+}
+
+const apiBaseUrl = process.env.GRIDFOX_API_BASE_URL ?? 'https://api.gridfox.com'
+
+const plan = ${planLiteral(plan)} as const
+
+const request = async (method: string, path: string, body?: unknown): Promise<Response> => {
+  return fetch(new URL(path, apiBaseUrl), {
+    method,
+    headers: {
+      'content-type': 'application/json',
+      'gridfox-api-key': apiKey
+    },
+    body: body === undefined ? undefined : JSON.stringify(body)
+  })
+}
+
+const assert = (condition: unknown, message: string): void => {
+  if (!condition) {
+    throw new Error(message)
+  }
+}
+
+const normalizeKey = (value: string): string => value.toLowerCase().replace(/\\s+/g, '')
+
+const asRecord = (value: unknown): Record<string, unknown> => {
+  if (!value || typeof value !== 'object') {
+    return {}
+  }
+  return value as Record<string, unknown>
+}
+
+const getFieldValue = (record: Record<string, unknown>, fieldName: string): unknown => {
+  const target = normalizeKey(fieldName)
+  for (const [key, value] of Object.entries(record)) {
+    if (normalizeKey(key) === target) {
+      return value
+    }
+  }
+  return undefined
+}
+
+const valuesEqual = (expected: unknown, actual: unknown): boolean => {
+  if (Array.isArray(expected) && Array.isArray(actual)) {
+    if (expected.length !== actual.length) {
+      return false
+    }
+    const left = [...expected].map((entry) => JSON.stringify(entry)).sort()
+    const right = [...actual].map((entry) => JSON.stringify(entry)).sort()
+    return left.every((entry, index) => entry === right[index])
+  }
+  return JSON.stringify(expected) === JSON.stringify(actual)
+}
+
+const replaceReferencePlaceholder = (payload: Record<string, unknown>, referenceValue: string): Record<string, unknown> => {
+  const out: Record<string, unknown> = {}
+  for (const [fieldName, value] of Object.entries(payload)) {
+    if (value === '__GRIDFOX_REFERENCE_VALUE__') {
+      out[fieldName] = referenceValue
+      continue
+    }
+    if (Array.isArray(value)) {
+      out[fieldName] = value.map((entry) => (entry === '__GRIDFOX_REFERENCE_VALUE__' ? referenceValue : entry))
+      continue
+    }
+    out[fieldName] = value
+  }
+  return out
+}
+
+const assertExpectedFields = (
+  record: Record<string, unknown>,
+  expectedValues: Record<string, unknown>,
+  label: string
+): void => {
+  for (const [fieldName, expected] of Object.entries(expectedValues)) {
+    const actual = getFieldValue(record, fieldName)
+    assert(
+      valuesEqual(expected, actual),
+      label + ': expected field "' + fieldName + '" to equal ' + JSON.stringify(expected) + '; got ' + JSON.stringify(actual)
+    )
+  }
+}
+
+const main = async (): Promise<void> => {
+  const selectedTable = gridfoxTables.find((table) => table.tableName === plan.tableName)
+  if (!selectedTable) {
+    throw new Error('Selected table "' + plan.tableName + '" was not found in generated registry')
+  }
+
+  assert(
+    selectedTable.referenceFieldName === plan.referenceFieldName,
+    'Reference field mismatch: plan=' + plan.referenceFieldName + ' generated=' + selectedTable.referenceFieldName
+  )
+
+  const referenceValue = 'real-test-' + Date.now() + '-' + Math.random().toString(36).slice(2, 10)
+
+  const createPayload = replaceReferencePlaceholder(plan.createPayload as Record<string, unknown>, referenceValue)
+  const updatePayload = replaceReferencePlaceholder(plan.updatePayload as Record<string, unknown>, referenceValue)
+
+  const createResponse = await request('POST', '/data/' + encodeURIComponent(selectedTable.tableName), createPayload)
+  assert(createResponse.status === 201, 'Create failed: expected 201, got ' + createResponse.status)
+
+  try {
+    const createBody = (await createResponse.json()) as { referenceFieldValue?: unknown }
+    assert(
+      createBody.referenceFieldValue === referenceValue,
+      'Create response referenceFieldValue mismatch: expected ' +
+        referenceValue +
+        ', got ' +
+        JSON.stringify(createBody.referenceFieldValue)
+    )
+
+    const getAfterCreate = await request(
+      'GET',
+      '/data/' + encodeURIComponent(selectedTable.tableName) + '/' + encodeURIComponent(referenceValue)
+    )
+    assert(getAfterCreate.status === 200, 'Get-after-create failed: expected 200, got ' + getAfterCreate.status)
+
+    const createdRecord = asRecord(await getAfterCreate.json())
+    assertExpectedFields(
+      createdRecord,
+      replaceReferencePlaceholder(plan.verifyAfterCreate as Record<string, unknown>, referenceValue),
+      'after create'
+    )
+
+    const updateResponse = await request(
+      'PUT',
+      '/data/' + encodeURIComponent(selectedTable.tableName) + '/' + encodeURIComponent(referenceValue),
+      updatePayload
+    )
+    assert(updateResponse.status === 204, 'Update failed: expected 204, got ' + updateResponse.status)
+
+    const getAfterUpdate = await request(
+      'GET',
+      '/data/' + encodeURIComponent(selectedTable.tableName) + '/' + encodeURIComponent(referenceValue)
+    )
+    assert(getAfterUpdate.status === 200, 'Get-after-update failed: expected 200, got ' + getAfterUpdate.status)
+
+    const updatedRecord = asRecord(await getAfterUpdate.json())
+    assertExpectedFields(
+      updatedRecord,
+      replaceReferencePlaceholder(plan.verifyAfterUpdate as Record<string, unknown>, referenceValue),
+      'after update'
+    )
+  } finally {
+    const deleteResponse = await request(
+      'DELETE',
+      '/data/' + encodeURIComponent(selectedTable.tableName) + '/' + encodeURIComponent(referenceValue)
+    )
+    assert(deleteResponse.status === 204, 'Delete cleanup failed: expected 204, got ' + deleteResponse.status)
+  }
+
+  const getAfterDelete = await request(
+    'GET',
+    '/data/' + encodeURIComponent(selectedTable.tableName) + '/' + encodeURIComponent(referenceValue)
+  )
+  assert(getAfterDelete.status === 404, 'Get-after-delete failed: expected 404, got ' + getAfterDelete.status)
+
+  console.log('Real CRUD checks passed against table "' + plan.tableName + '"')
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error))
+  process.exitCode = 1
+})
+`;
+};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@gridfox/codegen",
+  "version": "0.2.0",
+  "description": "Schema-driven Gridfox TypeScript code generator",
+  "type": "module",
+  "license": "ISC",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "gridfox": "dist/cli/main.js",
+    "gridfox-codegen": "dist/cli/main.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    ".env.example"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [],
+  "author": "",
+  "dependencies": {
+    "cac": "^7.0.0",
+    "change-case": "^5.4.4",
+    "prettier": "^3.8.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.5",
+    "execa": "^9.6.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "test": "pnpm run build && vitest run",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{ recursive: true, force: true })\"",
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "node dist/cli/main.js --help",
+    "test:real": "pnpm run build && node dist/cli/main.js validate",
+    "test:watch": "vitest",
+    "test:integration": "pnpm run build && vitest run tests/integration",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "generate": "pnpm run build && node dist/cli/main.js"
+  }
+}