@nanokajs/core 0.1.4 → 1.0.1

package/dist/config.js

@@ -1,4 +1,4 @@
-export { t } from './chunk-F5OBRXXY.js';
+export { t } from './chunk-UYXRKFAR.js';
 
 // src/config.ts
 function defineConfig(config) {

package/dist/{factories-CDsk1Hdt.d.ts → factories-Cmvx0495.d.ts}

@@ -1,6 +1,7 @@
 import { SQLiteColumnBuilderBase } from 'drizzle-orm/sqlite-core';
 import { z } from 'zod';
 
+type FieldPolicy = 'serverOnly' | 'writeOnly' | 'readOnly';
 interface FieldModifiers {
     optional?: boolean;
     primary?: boolean;
@@ -10,6 +11,7 @@ interface FieldModifiers {
     format?: 'email' | 'uuid';
     min?: number;
     max?: number;
+    policy?: FieldPolicy;
 }
 type FieldKind = 'string' | 'uuid' | 'number' | 'integer' | 'boolean' | 'timestamp' | 'json';
 /**
@@ -60,7 +62,7 @@ interface Field<TS = unknown, Mods extends FieldModifiers = {}, ZB extends z.Zod
  * type T1 = InferFieldType<typeof t.string()> // string
  * type T2 = InferFieldType<typeof t.string().optional()> // string | undefined
  */
-type InferFieldType<F> = F extends Field<infer T, FieldModifiers, z.ZodTypeAny> ? T : never;
+type InferFieldType<F> = F extends Field<infer T, FieldModifiers, z.ZodTypeAny> ? T : F extends Field<infer T, FieldModifiers, any> ? T : never;
 
 /**
  * Abstract base class for field builders.
@@ -94,7 +96,7 @@ declare abstract class BaseFieldBuilder<TS, Mods extends FieldModifiers = {}, ZB
     protected applyModifiersToZod(baseSchema: z.ZodTypeAny): z.ZodTypeAny;
 }
 
-declare class StringFieldBuilder<TS = string, Mods extends FieldModifiers = {}, ZB extends z.ZodType<TS, z.ZodTypeDef, TS> = z.ZodType<TS, z.ZodTypeDef, TS>> extends BaseFieldBuilder<TS, Mods, ZB> {
+declare class StringFieldBuilder<TS = string, Mods extends FieldModifiers = {}, ZB extends z.ZodTypeAny = z.ZodTypeAny> extends BaseFieldBuilder<TS, Mods, ZB> {
     readonly kind: "string";
     get zodBase(): ZB;
     drizzleColumn(name: string): SQLiteColumnBuilderBase;
@@ -141,8 +143,17 @@ declare class StringFieldBuilder<TS = string, Mods extends FieldModifiers = {},
     max(this: StringFieldBuilder<TS, Mods>, n: number): StringFieldBuilder<TS, Mods & {
         max: number;
     }>;
+    serverOnly(this: StringFieldBuilder<TS, Mods>): StringFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'serverOnly';
+    }>;
+    writeOnly(this: StringFieldBuilder<TS, Mods>): StringFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'writeOnly';
+    }>;
+    readOnly(this: StringFieldBuilder<TS, Mods>): StringFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'readOnly';
+    }>;
 }
-declare class UuidFieldBuilder<TS = string, Mods extends FieldModifiers = {}, ZB extends z.ZodType<TS, z.ZodTypeDef, TS> = z.ZodType<TS, z.ZodTypeDef, TS>> extends BaseFieldBuilder<TS, Mods, ZB> {
+declare class UuidFieldBuilder<TS = string, Mods extends FieldModifiers = {}, ZB extends z.ZodTypeAny = z.ZodTypeAny> extends BaseFieldBuilder<TS, Mods, ZB> {
     readonly kind: "uuid";
     get zodBase(): ZB;
     drizzleColumn(name: string): SQLiteColumnBuilderBase;
@@ -183,8 +194,17 @@ declare class UuidFieldBuilder<TS = string, Mods extends FieldModifiers = {}, ZB
     max(this: UuidFieldBuilder<TS, Mods>, n: number): UuidFieldBuilder<TS, Mods & {
         max: number;
     }>;
+    serverOnly(this: UuidFieldBuilder<TS, Mods>): UuidFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'serverOnly';
+    }>;
+    writeOnly(this: UuidFieldBuilder<TS, Mods>): UuidFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'writeOnly';
+    }>;
+    readOnly(this: UuidFieldBuilder<TS, Mods>): UuidFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'readOnly';
+    }>;
 }
-declare class NumberFieldBuilder<TS = number, Mods extends FieldModifiers = {}, ZB extends z.ZodType<TS, z.ZodTypeDef, TS> = z.ZodType<TS, z.ZodTypeDef, TS>> extends BaseFieldBuilder<TS, Mods, ZB> {
+declare class NumberFieldBuilder<TS = number, Mods extends FieldModifiers = {}, ZB extends z.ZodTypeAny = z.ZodTypeAny> extends BaseFieldBuilder<TS, Mods, ZB> {
     readonly kind: "number";
     get zodBase(): ZB;
     drizzleColumn(name: string): SQLiteColumnBuilderBase;
@@ -225,8 +245,17 @@ declare class NumberFieldBuilder<TS = number, Mods extends FieldModifiers = {},
     max(this: NumberFieldBuilder<TS, Mods>, n: number): NumberFieldBuilder<TS, Mods & {
         max: number;
     }>;
+    serverOnly(this: NumberFieldBuilder<TS, Mods>): NumberFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'serverOnly';
+    }>;
+    writeOnly(this: NumberFieldBuilder<TS, Mods>): NumberFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'writeOnly';
+    }>;
+    readOnly(this: NumberFieldBuilder<TS, Mods>): NumberFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'readOnly';
+    }>;
 }
-declare class IntegerFieldBuilder<TS = number, Mods extends FieldModifiers = {}, ZB extends z.ZodType<TS, z.ZodTypeDef, TS> = z.ZodType<TS, z.ZodTypeDef, TS>> extends BaseFieldBuilder<TS, Mods, ZB> {
+declare class IntegerFieldBuilder<TS = number, Mods extends FieldModifiers = {}, ZB extends z.ZodTypeAny = z.ZodTypeAny> extends BaseFieldBuilder<TS, Mods, ZB> {
     readonly kind: "integer";
     get zodBase(): ZB;
     drizzleColumn(name: string): SQLiteColumnBuilderBase;
@@ -267,8 +296,17 @@ declare class IntegerFieldBuilder<TS = number, Mods extends FieldModifiers = {},
     max(this: IntegerFieldBuilder<TS, Mods>, n: number): IntegerFieldBuilder<TS, Mods & {
         max: number;
     }>;
+    serverOnly(this: IntegerFieldBuilder<TS, Mods>): IntegerFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'serverOnly';
+    }>;
+    writeOnly(this: IntegerFieldBuilder<TS, Mods>): IntegerFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'writeOnly';
+    }>;
+    readOnly(this: IntegerFieldBuilder<TS, Mods>): IntegerFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'readOnly';
+    }>;
 }
-declare class BooleanFieldBuilder<TS = boolean, Mods extends FieldModifiers = {}, ZB extends z.ZodType<TS, z.ZodTypeDef, TS> = z.ZodType<TS, z.ZodTypeDef, TS>> extends BaseFieldBuilder<TS, Mods, ZB> {
+declare class BooleanFieldBuilder<TS = boolean, Mods extends FieldModifiers = {}, ZB extends z.ZodTypeAny = z.ZodTypeAny> extends BaseFieldBuilder<TS, Mods, ZB> {
     readonly kind: "boolean";
     get zodBase(): ZB;
     drizzleColumn(name: string): SQLiteColumnBuilderBase;
@@ -297,8 +335,17 @@ declare class BooleanFieldBuilder<TS = boolean, Mods extends FieldModifiers = {}
     default(this: BooleanFieldBuilder<TS, Mods>, value: TS | (() => TS)): BooleanFieldBuilder<TS, Mods & {
         hasDefault: true;
     }>;
+    serverOnly(this: BooleanFieldBuilder<TS, Mods>): BooleanFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'serverOnly';
+    }>;
+    writeOnly(this: BooleanFieldBuilder<TS, Mods>): BooleanFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'writeOnly';
+    }>;
+    readOnly(this: BooleanFieldBuilder<TS, Mods>): BooleanFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'readOnly';
+    }>;
 }
-declare class TimestampFieldBuilder<TS = Date, Mods extends FieldModifiers = {}, ZB extends z.ZodType<TS, z.ZodTypeDef, Date | string | number> = z.ZodType<TS, z.ZodTypeDef, Date | string | number>> extends BaseFieldBuilder<TS, Mods, ZB> {
+declare class TimestampFieldBuilder<TS = Date, Mods extends FieldModifiers = {}, ZB extends z.ZodTypeAny = z.ZodTypeAny> extends BaseFieldBuilder<TS, Mods, ZB> {
     readonly kind: "timestamp";
     get zodBase(): ZB;
     drizzleColumn(name: string): SQLiteColumnBuilderBase;
@@ -327,15 +374,26 @@ declare class TimestampFieldBuilder<TS = Date, Mods extends FieldModifiers = {},
     default(this: TimestampFieldBuilder<TS, Mods>, value: TS | (() => TS)): TimestampFieldBuilder<TS, Mods & {
         hasDefault: true;
     }>;
+    serverOnly(this: TimestampFieldBuilder<TS, Mods>): TimestampFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'serverOnly';
+    }>;
+    writeOnly(this: TimestampFieldBuilder<TS, Mods>): TimestampFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'writeOnly';
+    }>;
+    readOnly(this: TimestampFieldBuilder<TS, Mods>): TimestampFieldBuilder<TS, Omit<Mods, 'policy'> & {
+        policy: 'readOnly';
+    }>;
 }
 /**
  * JSON フィールドビルダー。
  *
- * ⚠️ セキュリティ警告: zod ベースは `z.unknown()` のため、API に晒す際は
- * `validator()` で除外するか、別途検証が必須。
+ * `t.json(zodSchema)` 形式で Zod スキーマを渡すと runtime 検証が走る。
+ * スキーマ省略時は `z.unknown()` で後方互換を維持する。
  */
-declare class JsonFieldBuilder<T = unknown, TS = T, Mods extends FieldModifiers = {}, ZB extends z.ZodType<TS, z.ZodTypeDef, TS> = z.ZodType<TS, z.ZodTypeDef, TS>> extends BaseFieldBuilder<TS, Mods, ZB> {
+declare class JsonFieldBuilder<T = unknown, TS = T, Mods extends FieldModifiers = {}, ZB extends z.ZodTypeAny = z.ZodTypeAny> extends BaseFieldBuilder<TS, Mods, ZB> {
     readonly kind: "json";
+    private readonly _zodSchema;
+    constructor(modifiers?: Mods, zodSchema?: z.ZodTypeAny);
     get zodBase(): ZB;
     drizzleColumn(name: string): SQLiteColumnBuilderBase;
     protected cloneWithModifiers<NewMods extends FieldModifiers>(mods: NewMods): JsonFieldBuilder<T, TS, NewMods>;
@@ -363,7 +421,18 @@ declare class JsonFieldBuilder<T = unknown, TS = T, Mods extends FieldModifiers
     default(this: JsonFieldBuilder<T, TS, Mods>, value: TS | (() => TS)): JsonFieldBuilder<T, TS, Mods & {
         hasDefault: true;
     }>;
+    serverOnly(this: JsonFieldBuilder<T, TS, Mods>): JsonFieldBuilder<T, TS, Omit<Mods, 'policy'> & {
+        policy: 'serverOnly';
+    }>;
+    writeOnly(this: JsonFieldBuilder<T, TS, Mods>): JsonFieldBuilder<T, TS, Omit<Mods, 'policy'> & {
+        policy: 'writeOnly';
+    }>;
+    readOnly(this: JsonFieldBuilder<T, TS, Mods>): JsonFieldBuilder<T, TS, Omit<Mods, 'policy'> & {
+        policy: 'readOnly';
+    }>;
 }
+declare function jsonField<S extends z.ZodTypeAny>(schema: S): JsonFieldBuilder<z.infer<S>, z.infer<S>, {}>;
+declare function jsonField<T = unknown>(): JsonFieldBuilder<T, T, {}>;
 /**
  * Field DSL factory for building type-safe database fields.
  *
@@ -374,6 +443,7 @@ declare class JsonFieldBuilder<T = unknown, TS = T, Mods extends FieldModifiers
  * const ageField = t.integer().min(0).max(150)
  * const createdAtField = t.timestamp().default(() => new Date())
  * const dataField = t.json<{ foo: string }>()
+ * const dataField2 = t.json(z.object({ foo: z.string() }))  // runtime validation
  */
 declare const t: {
     string(): StringFieldBuilder<string, {}>;
@@ -383,20 +453,17 @@ declare const t: {
     boolean(): BooleanFieldBuilder<boolean, {}>;
     timestamp(): TimestampFieldBuilder<Date, {}>;
     /**
-     * JSON フィールド。任意の JSON 値を受け入れる（Zod 内部表現は `z.unknown()`）。
+     * JSON フィールド。
+     *
+     * `t.json(zodSchema)` 形式で Zod スキーマを渡すと runtime 検証が走る。
+     * スキーマ省略時は `z.unknown()` で後方互換を維持する。
      *
-     * ⚠️ セキュリティ警告:
-     * このフィールドの zod ベースは `z.unknown()` のため、型パラメータ `T` で
-     * 指定した制約は **コンパイル時のみ** 適用され、validator() 経由でも
-     * runtime バリデーションは行われません。API 入力として晒す場合は:
-     *   - `model.validator(target, { omit: ['<json field name>'] })` で除外する、または
-     *   - ハンドラ側で別途 Zod スキーマを使って手動検証する、
-     * のいずれかを必ず実施してください。型パラメータが `unknown` 以外の値を
-     * runtime で保証することはありません。
+     * `t.json(z.object({ foo: z.string() }))` でオブジェクト形状の runtime 検証が可能。
      *
-     * Phase 2 以降で `t.json(zodSchema)` 形式の引数追加を検討中。
+     * @note codegen (`nanoka generate`) は `t.json(zodSchema)` を渡しても `$type<unknown>()` のまま出力する。
+     * Drizzle 型が欲しい場合は生成後に手動で書き換えるか `as` を使うこと。
      */
-    json<T = unknown>(): JsonFieldBuilder<T, T, {}>;
+    json: typeof jsonField;
 };
 
-export { type Field as F, type InferFieldType as I, type FieldModifiers as a, t };
+export { type Field as F, type InferFieldType as I, type FieldPolicy as a, type FieldModifiers as b, t };