hekireki 0.7.5 → 0.7.6

package/dist/cli/index.d.ts

@@ -1,14 +1,57 @@
 //#region src/cli/index.d.ts
-type Result<T> = {
+declare const HELP_TEXT = "\u26A1\uFE0F hekireki - Prisma schema tools\n\nUsage:\n  hekireki <command> [options]\n\nCommands:\n  docs serve    Start a local server to view the documentation\n\nOptions:\n  -p, --port <port>    Specify the port (default: 5858)\n  -h, --help           Show help\n\nExamples:\n  hekireki docs serve\n  hekireki docs serve -p 3000";
+declare const DOCS_HELP_TEXT = "\u26A1\uFE0F hekireki docs - Documentation tools\n\nUsage:\n  hekireki docs serve [options]\n\nCommands:\n  serve    Start a local server to view the documentation\n\nOptions:\n  -p, --port <port>    Specify the port (default: 5858)\n  -h, --help           Show help\n\nExamples:\n  hekireki docs serve\n  hekireki docs serve -p 3000";
+/**
+ * Parse port from CLI arguments.
+ */
+declare const parsePort: (args: readonly string[]) => {
+  readonly ok: true;
+  readonly value: number;
+} | {
+  readonly ok: false;
+  readonly error: string;
+};
+/**
+ * Parse CLI arguments for docs serve command.
+ */
+declare const parseDocsServeArgs: (args: readonly string[]) => {
+  readonly ok: true;
+  readonly value: {
+    readonly port: number;
+  };
+} | {
+  readonly ok: false;
+  readonly error: string;
+};
+/**
+ * Handle docs subcommand.
+ */
+declare const handleDocs: (args: readonly string[]) => {
+  readonly ok: true;
+  readonly value: string;
+} | {
+  readonly ok: false;
+  readonly error: string;
+};
+/**
+ * Main CLI dispatcher (pure — takes args, returns Result).
+ */
+declare const hekirekiCli: (args: readonly string[]) => {
   readonly ok: true;
-  readonly value: T;
+  readonly value: string;
 } | {
   readonly ok: false;
   readonly error: string;
 };
 /**
- * Main CLI entry point for hekireki.
+ * Main CLI entry point for hekireki (reads process.argv).
  */
-declare const hekireki: () => Result<string>;
+declare const hekireki: () => {
+  readonly ok: true;
+  readonly value: string;
+} | {
+  readonly ok: false;
+  readonly error: string;
+};
 //#endregion
-export { hekireki };
+export { DOCS_HELP_TEXT, HELP_TEXT, handleDocs, hekireki, hekirekiCli, parseDocsServeArgs, parsePort };

package/dist/cli/index.js

@@ -137,10 +137,9 @@ const handleDocs = (args) => {
 */
 const commands = { docs: handleDocs };
 /**
-* Main CLI entry point for hekireki.
+* Main CLI dispatcher (pure — takes args, returns Result).
 */
-const hekireki = () => {
-	const args = process.argv.slice(2);
+const hekirekiCli = (args) => {
 	const command = args[0];
 	if (!command || command === "-h" || command === "--help") return {
 		ok: true,
@@ -153,6 +152,12 @@ const hekireki = () => {
 	};
 	return handler(args.slice(1));
 };
+/**
+* Main CLI entry point for hekireki (reads process.argv).
+*/
+const hekireki = () => {
+	return hekirekiCli(process.argv.slice(2));
+};
 const result = hekireki();
 if (result.ok) console.log(result.value);
 else {
@@ -161,4 +166,4 @@ else {
 }
 
 //#endregion
-export { hekireki };
+export { DOCS_HELP_TEXT, HELP_TEXT, handleDocs, hekireki, hekirekiCli, parseDocsServeArgs, parsePort };

package/dist/generator/ajv/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { t as fmt } from "../../format-DwiYldCm.js";
-import { a as makeCommentBlock, c as makeValidationExtractor, f as mkdir, l as parseDocumentWithoutAnnotations, p as writeFile, t as getBool } from "../../utils-BGe939v0.js";
-import { n as validationSchemas, t as makeRelationsOnly } from "../../prisma-CfcdmYJs.js";
+import { l as makeValidationExtractor, m as writeFile, n as getBool, o as makeCommentBlock, p as mkdir, u as parseDocumentWithoutAnnotations } from "../../utils-3ot3YB3D.js";
+import { n as validationSchemas, t as makeRelationsOnly } from "../../prisma-o4IvnEUh.js";
 import path from "node:path";
 import pkg from "@prisma/generator-helper";
 
@@ -37,13 +37,13 @@ const PRISMA_TO_AJV = {
 * @param modelFields - The fields of the model
 * @param comment - Whether to include JSDoc comments in the generated code
 */
-function makeAjvSchemas(modelFields, comment) {
+function makeAjvSchemas(modelFields, comment, objectType) {
 	const modelName = modelFields[0].modelName;
 	const properties = modelFields.map((field) => {
 		return `${comment ? makeCommentBlock(field.comment, 4) : ""}    ${field.fieldName}: ${field.validation ?? "{ type: 'unknown' as const }"},`;
 	}).join("\n");
 	const requiredFields = modelFields.filter((f) => f.isRequired).map((f) => f.fieldName);
-	return `export const ${modelName}Schema = {\n  type: 'object' as const,\n  properties: {\n${properties}\n  },${requiredFields.length > 0 ? `\n  required: [${requiredFields.map((f) => `'${f}'`).join(", ")}] as const,` : ""}\n  additionalProperties: false,\n} as const`;
+	return `export const ${modelName}Schema = {\n  type: 'object' as const,\n  properties: {\n${properties}\n  },${requiredFields.length > 0 ? `\n  required: [${requiredFields.map((f) => `'${f}'`).join(", ")}] as const,` : ""}\n  additionalProperties: ${objectType === "loose" ? "true" : "false"},\n} as const`;
 }
 /**
 * Generate JSON Schema relation object definition

package/dist/generator/arktype/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { t as fmt } from "../../format-DwiYldCm.js";
-import { a as makeCommentBlock, c as makeValidationExtractor, f as mkdir, l as parseDocumentWithoutAnnotations, p as writeFile, t as getBool, u as schemaFromFields } from "../../utils-BGe939v0.js";
-import { n as validationSchemas, t as makeRelationsOnly } from "../../prisma-CfcdmYJs.js";
+import { d as schemaFromFields, l as makeValidationExtractor, m as writeFile, n as getBool, o as makeCommentBlock, p as mkdir, u as parseDocumentWithoutAnnotations } from "../../utils-3ot3YB3D.js";
+import { n as validationSchemas, t as makeRelationsOnly } from "../../prisma-o4IvnEUh.js";
 import path from "node:path";
 import pkg from "@prisma/generator-helper";
 
@@ -18,8 +18,8 @@ function makeArktypeInfer(modelName) {
 * @param modelName - The model name for the schema
 * @param fields - The formatted field definitions string
 */
-function makeArktypeSchema(modelName, fields) {
-	return `export const ${modelName}Schema = type({\n${fields}\n})`;
+function makeArktypeSchema(modelName, fields, objectType) {
+	return `export const ${modelName}Schema = type({${objectType === "strict" ? "\n  \"+\": \"reject\",\n" : objectType === "loose" ? "\n  \"+\": \"ignore\",\n" : "\n"}${fields}\n})`;
 }
 /**
 * Generate ArkType property definitions
@@ -55,8 +55,8 @@ const PRISMA_TO_ARKTYPE = {
 * @param modelFields - The fields of the model
 * @param comment - Whether to include JSDoc comments in the generated code
 */
-function makeArktypeSchemas(modelFields, comment) {
-	return schemaFromFields(modelFields, comment, makeArktypeSchema, makeArktypeProperties);
+function makeArktypeSchemas(modelFields, comment, objectType) {
+	return schemaFromFields(modelFields, comment, makeArktypeSchema, makeArktypeProperties, objectType);
 }
 /**
 * Generate ArkType relation schema definition

package/dist/generator/dbml/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { d as stripAnnotations, f as mkdir, m as writeFileBinary, n as getString, p as writeFile } from "../../utils-BGe939v0.js";
+import { f as stripAnnotations, h as writeFileBinary, m as writeFile, p as mkdir, r as getString } from "../../utils-3ot3YB3D.js";
 import path from "node:path";
 import pkg from "@prisma/generator-helper";
 import { Resvg } from "@resvg/resvg-js";

package/dist/generator/drizzle/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { t as fmt } from "../../format-DwiYldCm.js";
-import { f as mkdir, p as writeFile, s as makeSnakeCase } from "../../utils-BGe939v0.js";
+import { c as makeSnakeCase, m as writeFile, p as mkdir } from "../../utils-3ot3YB3D.js";
 import path from "node:path";
 import pkg from "@prisma/generator-helper";
 

package/dist/generator/ecto/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { f as mkdir, p as writeFile, s as makeSnakeCase } from "../../utils-BGe939v0.js";
+import { c as makeSnakeCase, m as writeFile, p as mkdir } from "../../utils-3ot3YB3D.js";
 import { join } from "node:path";
 import pkg from "@prisma/generator-helper";
 

package/dist/generator/effect/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { t as fmt } from "../../format-DwiYldCm.js";
-import { a as makeCommentBlock, c as makeValidationExtractor, f as mkdir, l as parseDocumentWithoutAnnotations, p as writeFile, t as getBool, u as schemaFromFields } from "../../utils-BGe939v0.js";
-import { n as validationSchemas, t as makeRelationsOnly } from "../../prisma-CfcdmYJs.js";
+import { d as schemaFromFields, l as makeValidationExtractor, m as writeFile, n as getBool, o as makeCommentBlock, p as mkdir, u as parseDocumentWithoutAnnotations } from "../../utils-3ot3YB3D.js";
+import { n as validationSchemas, t as makeRelationsOnly } from "../../prisma-o4IvnEUh.js";
 import path from "node:path";
 import pkg from "@prisma/generator-helper";
 

package/dist/generator/gorm/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { f as mkdir, n as getString, p as writeFile, s as makeSnakeCase } from "../../utils-BGe939v0.js";
+import { c as makeSnakeCase, m as writeFile, p as mkdir, r as getString } from "../../utils-3ot3YB3D.js";
 import path, { dirname } from "node:path";
 import pkg from "@prisma/generator-helper";
 

package/dist/generator/mermaid-er/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { d as stripAnnotations, f as mkdir, p as writeFile } from "../../utils-BGe939v0.js";
+import { f as stripAnnotations, m as writeFile, p as mkdir } from "../../utils-3ot3YB3D.js";
 import path from "node:path";
 import pkg from "@prisma/generator-helper";
 

package/dist/generator/sea-orm/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { f as mkdir, n as getString, p as writeFile, s as makeSnakeCase } from "../../utils-BGe939v0.js";
+import { c as makeSnakeCase, m as writeFile, p as mkdir, r as getString } from "../../utils-3ot3YB3D.js";
 import { join } from "node:path";
 import pkg from "@prisma/generator-helper";
 

package/dist/generator/sqlalchemy/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { f as mkdir, p as writeFile, s as makeSnakeCase } from "../../utils-BGe939v0.js";
+import { c as makeSnakeCase, m as writeFile, p as mkdir } from "../../utils-3ot3YB3D.js";
 import path, { dirname } from "node:path";
 import pkg from "@prisma/generator-helper";
 

package/dist/generator/typebox/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { t as fmt } from "../../format-DwiYldCm.js";
-import { a as makeCommentBlock, c as makeValidationExtractor, f as mkdir, l as parseDocumentWithoutAnnotations, p as writeFile, t as getBool, u as schemaFromFields } from "../../utils-BGe939v0.js";
-import { n as validationSchemas, t as makeRelationsOnly } from "../../prisma-CfcdmYJs.js";
+import { d as schemaFromFields, l as makeValidationExtractor, m as writeFile, n as getBool, o as makeCommentBlock, p as mkdir, u as parseDocumentWithoutAnnotations } from "../../utils-3ot3YB3D.js";
+import { n as validationSchemas, t as makeRelationsOnly } from "../../prisma-o4IvnEUh.js";
 import path from "node:path";
 import pkg from "@prisma/generator-helper";
 
@@ -18,8 +18,9 @@ function makeTypeBoxInfer(modelName) {
 * @param modelName - The model name for the schema
 * @param fields - The formatted field definitions string
 */
-function makeTypeBoxSchema(modelName, fields) {
-	return `export const ${modelName}Schema = Type.Object({\n${fields}\n})`;
+function makeTypeBoxSchema(modelName, fields, objectType) {
+	const obj = `Type.Object({\n${fields}\n})`;
+	return objectType === "strict" ? `export const ${modelName}Schema = Type.Strict(${obj})` : `export const ${modelName}Schema = ${obj}`;
 }
 /**
 * Generate TypeBox property definitions with optional wrapping
@@ -58,8 +59,8 @@ const PRISMA_TO_TYPEBOX = {
 * @param modelFields - The fields of the model
 * @param comment - Whether to include JSDoc comments in the generated code
 */
-function makeTypeBoxSchemas(modelFields, comment) {
-	return schemaFromFields(modelFields, comment, makeTypeBoxSchema, makeTypeBoxProperties);
+function makeTypeBoxSchemas(modelFields, comment, objectType) {
+	return schemaFromFields(modelFields, comment, makeTypeBoxSchema, makeTypeBoxProperties, objectType);
 }
 /**
 * Generate TypeBox relation schema definition

package/dist/generator/valibot/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { t as fmt } from "../../format-DwiYldCm.js";
-import { c as makeValidationExtractor, f as mkdir, l as parseDocumentWithoutAnnotations, o as makePropertiesGenerator, p as writeFile, t as getBool, u as schemaFromFields } from "../../utils-BGe939v0.js";
-import { n as validationSchemas, t as makeRelationsOnly } from "../../prisma-CfcdmYJs.js";
+import { d as schemaFromFields, l as makeValidationExtractor, m as writeFile, n as getBool, p as mkdir, s as makePropertiesGenerator, u as parseDocumentWithoutAnnotations } from "../../utils-3ot3YB3D.js";
+import { n as validationSchemas, t as makeRelationsOnly } from "../../prisma-o4IvnEUh.js";
 import path from "node:path";
 import pkg from "@prisma/generator-helper";
 
@@ -9,8 +9,8 @@ import pkg from "@prisma/generator-helper";
 function makeValibotInfer(modelName) {
 	return `export type ${modelName} = v.InferOutput<typeof ${modelName}Schema>`;
 }
-function makeValibotSchema(modelName, fields) {
-	return `export const ${modelName}Schema = v.object({\n${fields}\n})`;
+function makeValibotSchema(modelName, fields, objectType) {
+	return `export const ${modelName}Schema = v.${objectType === "strict" ? "strictObject" : objectType === "loose" ? "looseObject" : "object"}({\n${fields}\n})`;
 }
 function makeValibotEnumExpression(values) {
 	return `picklist([${values.map((v) => `'${v}'`).join(", ")}])`;
@@ -26,8 +26,8 @@ const PRISMA_TO_VALIBOT = {
 	Json: "unknown()",
 	Bytes: "any()"
 };
-function makeValibotSchemas(modelFields, comment) {
-	return schemaFromFields(modelFields, comment, makeValibotSchema, makePropertiesGenerator("v", (expr, isRequired) => isRequired ? expr : `v.exactOptional(${expr})`));
+function makeValibotSchemas(modelFields, comment, objectType) {
+	return schemaFromFields(modelFields, comment, makeValibotSchema, makePropertiesGenerator("v", (expr, isRequired) => isRequired ? expr : `v.exactOptional(${expr})`), objectType);
 }
 function makeValibotRelations(model, relProps, options) {
 	if (relProps.length === 0) return null;

package/dist/generator/zod/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { t as fmt } from "../../format-DwiYldCm.js";
-import { c as makeValidationExtractor, f as mkdir, l as parseDocumentWithoutAnnotations, n as getString, o as makePropertiesGenerator, p as writeFile, t as getBool, u as schemaFromFields } from "../../utils-BGe939v0.js";
-import { n as validationSchemas, t as makeRelationsOnly } from "../../prisma-CfcdmYJs.js";
+import { d as schemaFromFields, l as makeValidationExtractor, m as writeFile, n as getBool, p as mkdir, r as getString, s as makePropertiesGenerator, u as parseDocumentWithoutAnnotations } from "../../utils-3ot3YB3D.js";
+import { n as validationSchemas, t as makeRelationsOnly } from "../../prisma-o4IvnEUh.js";
 import path from "node:path";
 import pkg from "@prisma/generator-helper";
 
@@ -9,8 +9,8 @@ import pkg from "@prisma/generator-helper";
 function makeZodInfer(modelName) {
 	return `export type ${modelName} = z.infer<typeof ${modelName}Schema>`;
 }
-function makeZodSchema(modelName, fields) {
-	return `export const ${modelName}Schema = z.object({\n${fields}\n})`;
+function makeZodSchema(modelName, fields, objectType) {
+	return `export const ${modelName}Schema = z.${objectType === "strict" ? "strictObject" : objectType === "loose" ? "looseObject" : "object"}({\n${fields}\n})`;
 }
 function makeZodEnumExpression(values) {
 	return `enum([${values.map((v) => `'${v}'`).join(", ")}])`;
@@ -26,8 +26,8 @@ const PRISMA_TO_ZOD = {
 	Json: "unknown()",
 	Bytes: "any()"
 };
-function makeZodSchemas(modelFields, comment) {
-	return schemaFromFields(modelFields, comment, makeZodSchema, makePropertiesGenerator("z", (expr, isRequired) => isRequired ? expr : `${expr}.exactOptional()`));
+function makeZodSchemas(modelFields, comment, objectType) {
+	return schemaFromFields(modelFields, comment, makeZodSchema, makePropertiesGenerator("z", (expr, isRequired) => isRequired ? expr : `${expr}.exactOptional()`), objectType);
 }
 function makeZodRelations(model, relProps, options) {
 	if (relProps.length === 0) return null;

package/dist/{prisma-CfcdmYJs.js → prisma-o4IvnEUh.js}

@@ -1,4 +1,4 @@
-import { i as isFields, r as groupByModel } from "./utils-BGe939v0.js";
+import { a as isFields, i as groupByModel, t as extractObjectType } from "./utils-3ot3YB3D.js";
 
 //#region src/helper/prisma.ts
 function collectRelationProps(models) {
@@ -61,10 +61,13 @@ function validationSchemas(models, type, comment, config) {
 		fieldName: f.name
 	})));
 	if (config.onWarning) for (const { modelName, fieldName } of missing) config.onWarning(`Warning: Field "${modelName}.${fieldName}" has no ${config.annotationPrefix} annotation and will be omitted from the schema`);
-	const schemas = Object.values(groupByModel(isFields(modelFields))).map((fields) => ({
-		schema: config.schemas(fields, comment),
-		inferType: type ? config.inferType(fields[0].modelName) : ""
-	})).flatMap(({ schema, inferType }) => [schema, inferType].filter(Boolean)).join("\n\n");
+	const schemas = Object.values(groupByModel(isFields(modelFields))).map((fields) => {
+		const objectType = extractObjectType(fields[0].documentation, config.annotationPrefix);
+		return {
+			schema: config.schemas(fields, comment, objectType),
+			inferType: type ? config.inferType(fields[0].modelName) : ""
+		};
+	}).flatMap(({ schema, inferType }) => [schema, inferType].filter(Boolean)).join("\n\n");
 	return config.importStatement ? [
 		config.importStatement,
 		"",

package/dist/{utils-BGe939v0.js → utils-3ot3YB3D.js}

@@ -84,10 +84,22 @@ function groupByModel(validFields) {
 function isFields(modelFields) {
 	return modelFields.flat().filter((field) => field.validation !== null);
 }
-function schemaFromFields(modelFields, comment, schemaBuilder, propertiesGenerator) {
+/**
+* Extract object type (strict/loose) from model documentation.
+*/
+function extractObjectType(documentation, prefix) {
+	if (!documentation) return void 0;
+	const lines = documentation.split("\n").map((l) => l.trim());
+	const prefixWithoutAt = prefix.slice(1);
+	const match = lines.find((line) => line.includes(`${prefixWithoutAt}strictObject`) || line.includes(`${prefixWithoutAt}looseObject`));
+	if (!match) return void 0;
+	if (match.includes("strictObject")) return "strict";
+	if (match.includes("looseObject")) return "loose";
+}
+function schemaFromFields(modelFields, comment, schemaBuilder, propertiesGenerator, objectType) {
 	const modelName = modelFields[0].modelName;
-	return schemaBuilder(modelName, propertiesGenerator(modelFields, comment));
+	return schemaBuilder(modelName, propertiesGenerator(modelFields, comment), objectType);
 }
 
 //#endregion
-export { makeCommentBlock as a, makeValidationExtractor as c, stripAnnotations as d, mkdir as f, isFields as i, parseDocumentWithoutAnnotations as l, writeFileBinary as m, getString as n, makePropertiesGenerator as o, writeFile as p, groupByModel as r, makeSnakeCase as s, getBool as t, schemaFromFields as u };
+export { isFields as a, makeSnakeCase as c, schemaFromFields as d, stripAnnotations as f, writeFileBinary as h, groupByModel as i, makeValidationExtractor as l, writeFile as m, getBool as n, makeCommentBlock as o, mkdir as p, getString as r, makePropertiesGenerator as s, extractObjectType as t, parseDocumentWithoutAnnotations as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hekireki",
-  "version": "0.7.5",
+  "version": "0.7.6",
   "description": "Hekireki is a tool that generates validation schemas for Zod, Valibot, ArkType, and Effect Schema, as well as ER diagrams and DBML, from Prisma schemas annotated with comments.",
   "keywords": [
     "ajv",