schematic-pg 0.1.4 → 0.1.5

package/README.md

@@ -203,6 +203,14 @@ cd my-app
 
 Edit `app.schema`, then generate code and start the API:
 
+```bash
+make dev
+# → starts PostgreSQL, generates code, bootstraps the DB, and runs the dev server
+# → http://localhost:3000
+```
+
+Or run each step individually:
+
 ```bash
 # Start PostgreSQL (PostGIS-enabled, matches .env defaults)
 docker compose up -d
@@ -225,6 +233,7 @@ The `init` command creates everything you need to get running:
 | `app.schema` | Starter schema (one `User` model) — edit this |
 | `.env` | `DATABASE_URL`, JWT settings |
 | `docker-compose.yml` | Local PostGIS PostgreSQL on `:5432` |
+| `Makefile` | `make dev` — docker compose + generate + db:bootstrap + dev |
 | `tsconfig.json` | TypeScript config for `generated/` and `src/routes/` |
 | `package.json` | `schematic-pg` + runtime deps (`hono`, `pg`, `zod`, …) |
 | `src/routes/health.ts` | Example custom route mounted at `/health` |
@@ -286,6 +295,7 @@ schematic-pg dev [schema]   # generate:client + generate:api, then start generat
 Equivalent npm scripts in a project created by `init`:
 
 ```bash
+make dev           # docker compose up -d + generate + db:bootstrap + dev
 npm run dev        # schematic-pg dev
 npm run generate   # schematic-pg generate
 ```

package/dist/api-generator/utils/filter-operators.d.ts

@@ -11,4 +11,5 @@ export declare function getFilterFieldKind(field: Field, schema: Schema): Filter
 export declare function getFilterOperators(kind: FilterFieldKind): FilterOperator[];
 export declare function buildFilterFieldMeta(field: Field, schema: Schema): FilterFieldMeta;
 export declare function queryParamKey(fieldName: string, operator: FilterOperator): string;
+export declare function toQueryBooleanZodType(): string;
 export declare function toFilterZodType(type: TypeExpr, field: Field, schema: Schema, operator: FilterOperator, coerce?: boolean): string;

package/dist/api-generator/utils/filter-operators.js

@@ -54,6 +54,12 @@ export function queryParamKey(fieldName, operator) {
     }
     return `${fieldName}_${operator}`;
 }
+export function toQueryBooleanZodType() {
+    return `z.preprocess(
+    (value) => (typeof value === 'string' ? value.toLowerCase() : value),
+    z.union([z.boolean(), z.enum(['true', 'false'])]).transform((value) => value === true || value === 'true'),
+  )`;
+}
 export function toFilterZodType(type, field, schema, operator, coerce = false) {
     const prefix = coerce ? 'z.coerce.' : 'z.';
     const enumType = schema.enums.find((enumDef) => enumDef.name === type.name);
@@ -77,7 +83,7 @@ export function toFilterZodType(type, field, schema, operator, coerce = false) {
         case 'SMALLINT':
             return `${prefix}number().int()`;
         case 'BOOLEAN':
-            return `${prefix}boolean()`;
+            return toQueryBooleanZodType();
         case 'TIMESTAMP':
             return 'z.coerce.date()';
         case 'DECIMAL':

package/dist/api-generator/zod-schema-generator.js

@@ -86,8 +86,7 @@ export class ZodSchemaGenerator {
         const lines = [];
         for (const operator of meta.operators) {
             const key = queryParamKey(field.name, operator);
-            const useCoerce = operator !== 'equals' || field.type.name !== 'BOOLEAN';
-            const zodType = toFilterZodType(field.type, field, this.schema, operator, useCoerce);
+            const zodType = toFilterZodType(field.type, field, this.schema, operator, true);
             lines.push(`${key}: ${zodType}.optional(),`);
         }
         return lines;

package/dist/cli/init.js

@@ -3,12 +3,13 @@ import { PACKAGE_NAME } from '../constants.js';
 import { existsSync } from 'node:fs';
 import { mkdir, readdir, writeFile } from 'node:fs/promises';
 import path from 'node:path';
-import { APP_SCHEMA_TEMPLATE, createPackageJsonTemplate, DOCKER_COMPOSE_TEMPLATE, ENV_TEMPLATE, GITIGNORE_TEMPLATE, HEALTH_ROUTE_TEMPLATE, TSCONFIG_TEMPLATE, } from './templates.js';
+import { APP_SCHEMA_TEMPLATE, createPackageJsonTemplate, DOCKER_COMPOSE_TEMPLATE, ENV_TEMPLATE, GITIGNORE_TEMPLATE, HEALTH_ROUTE_TEMPLATE, MAKEFILE_TEMPLATE, TSCONFIG_TEMPLATE, } from './templates.js';
 const INIT_FILES = [
     { relativePath: 'app.schema', content: APP_SCHEMA_TEMPLATE },
     { relativePath: '.env', content: ENV_TEMPLATE },
     { relativePath: '.gitignore', content: GITIGNORE_TEMPLATE },
     { relativePath: 'docker-compose.yml', content: DOCKER_COMPOSE_TEMPLATE },
+    { relativePath: 'Makefile', content: MAKEFILE_TEMPLATE },
     { relativePath: 'tsconfig.json', content: TSCONFIG_TEMPLATE },
     { relativePath: 'src/routes/health.ts', content: HEALTH_ROUTE_TEMPLATE },
 ];
@@ -101,6 +102,9 @@ export async function runInit(args) {
     if (skipInstall) {
         console.log('  npm install');
     }
+    console.log('  make dev');
+    console.log('');
+    console.log('  # or run individually:');
     console.log('  docker compose up -d');
     console.log(`  npx ${PACKAGE_NAME} generate`);
     console.log(`  npx ${PACKAGE_NAME} db:bootstrap`);

package/dist/cli/templates.d.ts

@@ -1,7 +1,8 @@
-export declare const APP_SCHEMA_TEMPLATE = "models {\n  model User {\n    id:        UUID        @id @default(gen_random_uuid())\n    email:     VARCHAR(255) @unique\n    name:      VARCHAR(150)\n    createdAt: TIMESTAMP   @default(now())\n  }\n}\n";
+export declare const APP_SCHEMA_TEMPLATE = "extensions {\n\n}\n\nenums {\n\n}\n\nmodels {\n  model User {\n    id:        UUID        @id @default(gen_random_uuid())\n    email:     VARCHAR(255) @unique\n    name:      VARCHAR(150)\n    createdAt: TIMESTAMP   @default(now())\n  }\n}\n";
 export declare const ENV_TEMPLATE = "DATABASE_URL=postgresql://postgrest:postgrest@localhost:5432/postgrest\nJWT_SECRET=\nJWT_ROLE_CLAIM=role\nJWT_USER_ID_CLAIM=sub\n";
 export declare const GITIGNORE_TEMPLATE = "node_modules/\ndist/\n.env\ndocker_data/\n.DS_Store\n*.log\nnpm-debug.log*\n";
 export declare const DOCKER_COMPOSE_TEMPLATE = "services:\n  postgres:\n    image: postgis/postgis:16-3.4\n    container_name: schematic-pg-postgres\n    restart: unless-stopped\n    ports:\n      - \"5432:5432\"\n    environment:\n      POSTGRES_USER: postgrest\n      POSTGRES_PASSWORD: postgrest\n      POSTGRES_DB: postgrest\n    volumes:\n      - ./docker_data/postgres:/var/lib/postgresql/data\n    healthcheck:\n      test: [\"CMD-SHELL\", \"pg_isready -U postgrest -d postgrest\"]\n      interval: 5s\n      timeout: 5s\n      retries: 5\n";
 export declare const TSCONFIG_TEMPLATE = "{\n  \"compilerOptions\": {\n    \"target\": \"ES2022\",\n    \"module\": \"NodeNext\",\n    \"moduleResolution\": \"NodeNext\",\n    \"strict\": true,\n    \"esModuleInterop\": true,\n    \"skipLibCheck\": true,\n    \"outDir\": \"dist\",\n    \"rootDir\": \".\"\n  },\n  \"include\": [\"generated/**/*\", \"src/**/*\"]\n}\n";
+export declare const MAKEFILE_TEMPLATE = ".PHONY: dev\n\ndev:\n\tdocker compose up -d\n\tnpx schematic-pg generate\n\tnpx schematic-pg db:bootstrap\n\tnpx schematic-pg dev\n";
 export declare const HEALTH_ROUTE_TEMPLATE = "import { Hono } from 'hono';\nimport type { AppEnv } from 'schematic-pg/api/types';\n\nconst router = new Hono<AppEnv>();\nrouter.get('/', (c) => c.json({ ok: true }));\nexport default router;\n";
 export declare function createPackageJsonTemplate(projectName: string): string;

package/dist/cli/templates.js

@@ -1,5 +1,13 @@
 import { PACKAGE_NAME, PACKAGE_VERSION } from '../constants.js';
-export const APP_SCHEMA_TEMPLATE = `models {
+export const APP_SCHEMA_TEMPLATE = `extensions {
+
+}
+
+enums {
+
+}
+
+models {
   model User {
     id:        UUID        @id @default(gen_random_uuid())
     email:     VARCHAR(255) @unique
@@ -54,6 +62,14 @@ export const TSCONFIG_TEMPLATE = `{
   "include": ["generated/**/*", "src/**/*"]
 }
 `;
+export const MAKEFILE_TEMPLATE = `.PHONY: dev
+
+dev:
+\tdocker compose up -d
+\tnpx ${PACKAGE_NAME} generate
+\tnpx ${PACKAGE_NAME} db:bootstrap
+\tnpx ${PACKAGE_NAME} dev
+`;
 export const HEALTH_ROUTE_TEMPLATE = `import { Hono } from 'hono';
 import type { AppEnv } from '${PACKAGE_NAME}/api/types';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "schematic-pg",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Single-file backend framework for PostgreSQL and Node.js",
   "type": "module",
   "license": "MIT",