@wener/common 2.0.2 → 2.0.5

package/src/fs/tests/runFileSystemTest.ts

@@ -0,0 +1,289 @@
+import { expect } from 'vitest';
+import { FileSystemError, FileSystemErrorCode } from '../FileSystemError';
+import type { IFileSystem, IServerFileSystem } from '../IFileSystem';
+
+export type RunFileSystemTestOptions = {
+	writableStream?: boolean;
+	readableStream?: boolean;
+	readStream?: boolean;
+	writeStream?: boolean;
+	abort?: boolean;
+};
+
+export async function runFileSystemTest(fs: IFileSystem | IServerFileSystem, options: RunFileSystemTestOptions = {}) {
+	const { writableStream = true, readableStream = true, readStream = true, writeStream = true, abort = true } = options;
+	// should be implemented
+	const stat = await fs.stat('/README.txt');
+	expect(stat).toMatchObject({
+		path: '/README.txt',
+		directory: '/',
+		name: 'README.txt',
+		kind: 'file',
+		size: 5,
+	});
+	await fs.mkdir('/');
+	const entries = await fs.readdir('/');
+	expect(entries.some((e) => e.name === 'README.txt')).toBe(true);
+	await fs.mkdir('/test');
+
+	if (fs.getUrl) {
+		expect(fs.getUrl(await fs.stat('/README.txt'))).toBeTypeOf('string');
+	}
+
+	// should handle AbortSignal
+	if (abort) {
+		const controller = new AbortController();
+		controller.abort();
+
+		await expect(fs.stat('/README.txt', { signal: controller.signal })).rejects.toThrow(Error);
+		await expect(fs.readdir('/', { signal: controller.signal })).rejects.toThrow(Error);
+		await expect(fs.mkdir('/test', { signal: controller.signal })).rejects.toThrow(Error);
+		await expect(fs.readFile('/README.txt', { signal: controller.signal })).rejects.toThrow(Error);
+		await expect(fs.writeFile('/test.txt', 'test', { signal: controller.signal })).rejects.toThrow(Error);
+		await expect(fs.rm('/README.txt', { signal: controller.signal })).rejects.toThrow(Error);
+		await expect(fs.rename('/README.txt', '/new.txt', { signal: controller.signal })).rejects.toThrow(Error);
+		await expect(fs.copy('/README.txt', '/copy.txt', { signal: controller.signal })).rejects.toThrow(Error);
+	}
+
+	// should validate input parameters
+	await expect(fs.stat('')).rejects.toThrow(FileSystemError);
+	await expect(fs.stat('')).rejects.toMatchObject({ code: FileSystemErrorCode.EINVAL });
+	await expect(fs.stat(null as any)).rejects.toThrow(FileSystemError);
+	await expect(fs.stat(null as any)).rejects.toMatchObject({ code: FileSystemErrorCode.EINVAL });
+	await expect(fs.stat(undefined as any)).rejects.toThrow(FileSystemError);
+	await expect(fs.stat(undefined as any)).rejects.toMatchObject({ code: FileSystemErrorCode.EINVAL });
+	await expect(fs.stat(123 as any)).rejects.toThrow(FileSystemError);
+	await expect(fs.stat(123 as any)).rejects.toMatchObject({ code: FileSystemErrorCode.EINVAL });
+
+	await expect(fs.writeFile('', 'test')).rejects.toThrow(FileSystemError);
+	await expect(fs.writeFile('', 'test')).rejects.toMatchObject({ code: FileSystemErrorCode.EINVAL });
+	await expect(fs.writeFile('/test', null as any)).rejects.toThrow(FileSystemError);
+	await expect(fs.writeFile('/test', null as any)).rejects.toMatchObject({ code: FileSystemErrorCode.EINVAL });
+	await expect(fs.writeFile('/test', undefined as any)).rejects.toThrow(FileSystemError);
+	await expect(fs.writeFile('/test', undefined as any)).rejects.toMatchObject({ code: FileSystemErrorCode.EINVAL });
+	await expect(fs.writeFile('/', 'test')).rejects.toThrow(FileSystemError);
+	await expect(fs.writeFile('/', 'test')).rejects.toMatchObject({ code: FileSystemErrorCode.EINVAL });
+
+	// should support streaming operations
+	const serverFs = fs as IServerFileSystem;
+	if (readStream && 'createReadStream' in fs) {
+		await fs.writeFile('/stream.txt', 'Hello, World!');
+
+		// Test createReadStream
+		const readStreamObj = serverFs.createReadStream('/stream.txt');
+		expect(readStreamObj).toBeDefined();
+
+		const chunks: Buffer[] = [];
+		for await (const chunk of readStreamObj) {
+			chunks.push(chunk);
+		}
+		expect(Buffer.concat(chunks).toString()).toBe('Hello, World!');
+
+		// Test createReadStream with range
+		const rangeStream = serverFs.createReadStream('/stream.txt', { range: { start: 0, end: 4 } });
+		const rangeChunks: Buffer[] = [];
+		for await (const chunk of rangeStream) {
+			rangeChunks.push(chunk);
+		}
+		expect(Buffer.concat(rangeChunks).toString()).toBe('Hello');
+	}
+
+	if (writeStream && 'createWriteStream' in fs) {
+		// Test createWriteStream
+		const writeStreamObj = serverFs.createWriteStream('/write-test.txt');
+		expect(writeStreamObj).toBeDefined();
+
+		writeStreamObj.write('Test content');
+		writeStreamObj.end();
+
+		await new Promise((resolve) => writeStreamObj.on('finish', resolve));
+		expect(await fs.readFile('/write-test.txt', { encoding: 'text' })).toBe('Test content');
+	}
+
+	// should support Web Streams API
+	if (readableStream && fs.createReadableStream) {
+		await fs.writeFile('/webstream.txt', 'Web Stream Test');
+
+		// Test createReadableStream
+		const readableStreamObj = fs.createReadableStream('/webstream.txt');
+		expect(readableStreamObj).toBeDefined();
+
+		const reader = readableStreamObj.getReader();
+		const { value } = await reader.read();
+		expect(value?.toString()).toBe('Web Stream Test');
+	}
+
+	if (writableStream && fs.createWritableStream) {
+		// Test createWritableStream
+		const writableStreamObj = fs.createWritableStream('/web-write-test.txt');
+		expect(writableStreamObj).toBeDefined();
+
+		const writer = writableStreamObj.getWriter();
+		await writer.write(Buffer.from('Web Stream Write Test'));
+		await writer.close();
+
+		expect(await fs.readFile('/web-write-test.txt', { encoding: 'text' })).toBe('Web Stream Write Test');
+	}
+
+	// should handle streaming errors
+	if (abort && readStream && 'createReadStream' in fs) {
+		const controller2 = new AbortController();
+
+		// Test read stream with abort
+		const readStreamObj = serverFs.createReadStream('/README.txt', { signal: controller2.signal });
+		controller2.abort();
+
+		await expect(
+			new Promise((_, reject) => {
+				readStreamObj.on('error', reject);
+			}),
+		).rejects.toThrow(Error);
+	}
+
+	if (abort && writeStream && 'createWriteStream' in fs) {
+		// Test write stream with abort
+		const controller3 = new AbortController();
+		const writeStreamObj = serverFs.createWriteStream('/abort-test.txt', { signal: controller3.signal });
+		controller3.abort();
+
+		await expect(
+			new Promise((_, reject) => {
+				writeStreamObj.on('error', reject);
+				writeStreamObj.write('test');
+			}),
+		).rejects.toThrow(Error);
+	}
+
+	// should handle file operations correctly
+	// Test file creation
+	await fs.writeFile('/newfile.txt', 'New content');
+	expect(await fs.exists('/newfile.txt')).toBe(true);
+
+	const stat2 = await fs.stat('/newfile.txt');
+	expect(stat2.kind).toBe('file');
+	expect(stat2.size).toBe(11); // "New content" is 11 bytes
+
+	// Test file reading
+	const content = await fs.readFile('/newfile.txt', { encoding: 'text' });
+	expect(content).toBe('New content');
+
+	// Test file reading as binary
+	const binary = await fs.readFile('/newfile.txt');
+	expect(Buffer.from(binary).toString()).toBe('New content');
+
+	// Test file overwrite
+	await fs.writeFile('/newfile.txt', 'Updated content');
+	expect(await fs.readFile('/newfile.txt', { encoding: 'text' })).toBe('Updated content');
+
+	// Test file overwrite protection
+	await expect(fs.writeFile('/newfile.txt', 'Should fail', { overwrite: false })).rejects.toThrow(FileSystemError);
+	await expect(fs.writeFile('/newfile.txt', 'Should fail', { overwrite: false })).rejects.toMatchObject({
+		code: FileSystemErrorCode.EEXIST,
+	});
+
+	// Test large file write (should use file_node_content table)
+	// Create ~1KB data to test large file handling
+	const largeData = 'x'.repeat(1024); // 1KB of data
+	await fs.writeFile('/largefile.txt', largeData);
+	const largeFileStat = await fs.stat('/largefile.txt');
+	expect(largeFileStat.size).toBe(1024);
+	const largeFileContent = await fs.readFile('/largefile.txt', { encoding: 'text' });
+	expect(largeFileContent).toBe(largeData);
+	expect(largeFileContent.length).toBe(1024);
+
+	// should handle directory operations correctly
+	// Test directory creation
+	await fs.mkdir('/newdir');
+	expect(await fs.exists('/newdir')).toBe(true);
+
+	const stat3 = await fs.stat('/newdir');
+	expect(stat3.kind).toBe('directory');
+
+	// Test recursive directory creation
+	await fs.mkdir('/deep/nested/dir', { recursive: true });
+	expect(await fs.exists('/deep/nested/dir')).toBe(true);
+
+	// Test non-recursive directory creation failure
+	await expect(fs.mkdir('/another/deep/dir')).rejects.toThrow(FileSystemError);
+	await expect(fs.mkdir('/another/deep/dir')).rejects.toMatchObject({ code: FileSystemErrorCode.ENOENT });
+
+	// Test directory listing
+	await fs.writeFile('/newdir/file1.txt', 'File 1');
+	await fs.writeFile('/newdir/file2.txt', 'File 2');
+
+	const contents = await fs.readdir('/newdir');
+	expect(contents).toHaveLength(2);
+	expect(contents.map((f) => f.name)).toContain('file1.txt');
+	expect(contents.map((f) => f.name)).toContain('file2.txt');
+
+	// should handle file removal correctly
+	await fs.writeFile('/toremove.txt', 'Remove me');
+	expect(await fs.exists('/toremove.txt')).toBe(true);
+
+	await fs.rm('/toremove.txt');
+	expect(await fs.exists('/toremove.txt')).toBe(false);
+
+	// Test force removal
+	await expect(fs.rm('/nonexistent.txt')).rejects.toThrow(FileSystemError);
+	await expect(fs.rm('/nonexistent.txt')).rejects.toMatchObject({ code: FileSystemErrorCode.ENOENT });
+	await fs.rm('/nonexistent.txt', { force: true }); // Should not throw
+
+	// Test recursive removal
+	await fs.mkdir('/dirwithfiles', { recursive: true });
+	await fs.writeFile('/dirwithfiles/file.txt', 'content');
+	await expect(fs.rm('/dirwithfiles')).rejects.toThrow(FileSystemError);
+	await expect(fs.rm('/dirwithfiles')).rejects.toMatchObject({ code: FileSystemErrorCode.ENOTEMPTY });
+	await fs.rm('/dirwithfiles', { recursive: true });
+	expect(await fs.exists('/dirwithfiles')).toBe(false);
+
+	// should handle file rename correctly
+	await fs.writeFile('/rename.txt', 'Original content');
+	expect(await fs.exists('/rename.txt')).toBe(true);
+
+	await fs.rename('/rename.txt', '/renamed.txt');
+	expect(await fs.exists('/rename.txt')).toBe(false);
+	expect(await fs.exists('/renamed.txt')).toBe(true);
+	expect(await fs.readFile('/renamed.txt', { encoding: 'text' })).toBe('Original content');
+
+	// should handle file copy correctly
+	await fs.writeFile('/copy.txt', 'Copy me');
+	expect(await fs.exists('/copy.txt')).toBe(true);
+
+	await fs.copy('/copy.txt', '/copied.txt');
+	expect(await fs.exists('/copy.txt')).toBe(true);
+	expect(await fs.exists('/copied.txt')).toBe(true);
+	expect(await fs.readFile('/copied.txt', { encoding: 'text' })).toBe('Copy me');
+
+	// Test copy overwrite
+	await fs.writeFile('/target2.txt', 'Target content');
+	await expect(fs.copy('/copy.txt', '/target2.txt')).rejects.toThrow(FileSystemError);
+	await expect(fs.copy('/copy.txt', '/target2.txt')).rejects.toMatchObject({ code: FileSystemErrorCode.EEXIST });
+	await fs.copy('/copy.txt', '/target2.txt', { overwrite: true });
+	expect(await fs.readFile('/target2.txt', { encoding: 'text' })).toBe('Copy me');
+
+	// should handle edge cases correctly
+	// Test root directory operations
+	await expect(fs.stat('/')).resolves.toBeDefined();
+	await expect(fs.readdir('/')).resolves.toBeDefined();
+	await fs.mkdir('/'); // Should not throw
+
+	// Test path normalization
+	await fs.writeFile('/normalize.txt', 'test');
+	expect(await fs.exists('/normalize.txt')).toBe(true);
+	expect(await fs.exists('/./normalize.txt')).toBe(true);
+	// Note: the exists method may return true for files with trailing slashes due to normalization
+
+	// Test error cases
+	await expect(fs.stat('/nonexistent')).rejects.toThrow(FileSystemError);
+	await expect(fs.stat('/nonexistent')).rejects.toMatchObject({ code: FileSystemErrorCode.ENOENT });
+	await expect(fs.readdir('/nonexistent')).rejects.toThrow(FileSystemError);
+	await expect(fs.readdir('/nonexistent')).rejects.toMatchObject({ code: FileSystemErrorCode.ENOENT });
+	await expect(fs.readFile('/nonexistent')).rejects.toThrow(FileSystemError);
+	await expect(fs.readFile('/nonexistent')).rejects.toMatchObject({ code: FileSystemErrorCode.ENOENT });
+	await expect(fs.rm('/nonexistent')).rejects.toThrow(FileSystemError);
+	await expect(fs.rm('/nonexistent')).rejects.toMatchObject({ code: FileSystemErrorCode.ENOENT });
+	await expect(fs.rename('/nonexistent', '/new')).rejects.toThrow(FileSystemError);
+	await expect(fs.rename('/nonexistent', '/new')).rejects.toMatchObject({ code: FileSystemErrorCode.ENOENT });
+	await expect(fs.copy('/nonexistent', '/new')).rejects.toThrow(FileSystemError);
+	await expect(fs.copy('/nonexistent', '/new')).rejects.toMatchObject({ code: FileSystemErrorCode.ENOENT });
+}

package/src/fs/types.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod/v4';
+
+type EnumValues<T> = T[Exclude<keyof T, '__proto__'>];
+export const FileKind = Object.freeze({
+	__proto__: null,
+	directory: 'directory',
+	file: 'file',
+});
+export type FileKind = EnumValues<typeof FileKind>;
+export const FileKindSchema = z.enum(['directory', 'file']);
+
+export type ReaddirOptions = z.infer<typeof ReaddirOptionsSchema>;
+export const ReaddirOptionsSchema = z.object({
+	recursive: z.boolean().optional(),
+	depth: z.number().optional(),
+	glob: z.string().optional(),
+	kind: FileKindSchema.optional(),
+	cursor: z.string().optional(),
+	hidden: z.boolean().default(false),
+});
+
+export type FileUrlOptions = z.infer<typeof FileUrlOptionsSchema>;
+export const FileUrlOptionsSchema = z.object({
+	size: z.coerce.number().optional(),
+	width: z.number().optional(),
+	height: z.number().optional(),
+	quality: z.number().optional(),
+	thumbnail: z.boolean().optional(),
+});

package/src/fs/utils/getFileUrl.ts

@@ -0,0 +1,44 @@
+import type { IFileStat, IFileSystem } from '../IFileSystem';
+import type { FileUrlOptions } from '../types';
+
+export function getFileUrl(
+	fs: IFileSystem,
+	needle?: IFileStat | string,
+	{
+		...options
+	}: FileUrlOptions & {
+		fs?: IFileSystem;
+	} = {},
+) {
+	const [file, path] = resolveFilePath(needle);
+	if (!path || !needle) return;
+
+	let out: string | undefined;
+	if (fs?.getUrl) {
+		try {
+			out = fs.getUrl(needle, options);
+		} catch (e) {
+			console.error(`failed to get file url`, needle, e);
+		}
+	}
+	if (!out && file) {
+		out = file.meta?.url || (file as any).url;
+	}
+	return out;
+}
+
+export function resolveFilePath(needle: IFileStat): [IFileStat, string];
+export function resolveFilePath(needle: string): [undefined, string];
+export function resolveFilePath(needle?: IFileStat | string): [IFileStat | undefined, string | undefined];
+export function resolveFilePath(needle?: IFileStat | string): [IFileStat | undefined, string | undefined] {
+	if (!needle) {
+		return [undefined, undefined];
+	}
+	let file = typeof needle === 'string' ? undefined : needle;
+	let path = typeof needle === 'string' ? needle : needle.path;
+
+	if (file && !path) {
+		path = file.path;
+	}
+	return [file, path];
+}

package/src/fs/utils.ts

@@ -0,0 +1,23 @@
+import { ArrayBuffers, classOf } from '@wener/utils';
+import type { IFileStat, WritableData } from './IFileSystem';
+
+export function resolveData(data: WritableData) {
+	let buf: Uint8Array;
+	if (typeof data === 'string') {
+		buf = ArrayBuffers.toUint8Array(ArrayBuffers.from(data, 'utf8') as BufferSource);
+	} else if (data instanceof ArrayBuffer) {
+		buf = new Uint8Array(data);
+	} else if (data instanceof Uint8Array) {
+		buf = data;
+	} else {
+		throw new Error(`unable to resolve data: ${typeof data} ${classOf(data)}`);
+	}
+	return buf;
+}
+
+export function getPath(f: IFileStat | string) {
+	if (typeof f === 'string') {
+		return f;
+	}
+	return f.path;
+}

package/src/fs/webdav/index.ts

@@ -0,0 +1 @@
+export { createWebDavFileSystem } from '../createWebDavFileSystem';

package/src/jsonschema/JsonSchema.ts

@@ -1,26 +1,25 @@
 import type { Static, TSchema } from '@sinclair/typebox';
+import { isNil } from '@wener/utils';
 import Ajv, { type ErrorObject, type Options } from 'ajv';
 import addFormats from 'ajv-formats';
-// import localize from 'ajv-i18n/localize/zh';
 import addKeywords from 'ajv-keywords';
-import { isNil } from 'es-toolkit';
 import { match, P } from 'ts-pattern';
 import type { JsonSchemaDef } from './types';
 
-function _createAjv(opt: Options) {
+function _createValidator(opt: Options) {
 	const ajv = new Ajv(opt);
 	addKeywords(ajv);
 	addFormats(ajv);
 	return ajv;
 }
 
-type ValidateOptions = { mutate?: boolean; clone?: boolean; ajv?: Ajv };
+type ValidateOptions = { mutate?: boolean; clone?: boolean; validator?: Ajv };
 
 type ValidateResult<T> =
 	| { data: T; success: true; message: undefined }
 	| { data: undefined; success: false; message: string; errors: ErrorObject[] };
 
-function validate({ schema, data, mutate, clone, ajv }: ValidateOptions & { schema: any; data: any }) {
+function validate({ schema, data, mutate, clone, validator }: ValidateOptions & { schema: any; data: any }) {
 	let opts: Options = {
 		// strict: 'log',
 		strict: true,
@@ -35,11 +34,11 @@ function validate({ schema, data, mutate, clone, ajv }: ValidateOptions & { sche
 		data = structuredClone(data);
 	}
 
-	if (!ajv) {
-		ajv = JsonSchema.createAjv(opts);
+	if (!validator) {
+		validator = JsonSchema.createValidator(opts);
 	}
 
-	const validate = ajv.compile(schema);
+	const validate = validator.compile(schema);
 
 	// consider reusing validate instance
 
@@ -47,119 +46,128 @@ function validate({ schema, data, mutate, clone, ajv }: ValidateOptions & { sche
 	const errors = validate.errors;
 	// localize(errors);
 
-	return { data, success: valid, message: ajv.errorsText(errors), errors: errors };
+	return { data, success: valid, message: validator.errorsText(errors), errors: errors };
 }
 
 type TypeOfSchema<S> = S extends TSchema ? Static<S> : any;
 
-export namespace JsonSchema {
-	export let schemas: JsonSchemaDef[] = [];
-
-	export let createAjv = _createAjv;
-
-	export function addSchema(
-		schema: JsonSchemaDef,
-		{
-			onConflict = 'throw',
-		}: {
-			onConflict?: 'throw' | 'ignore' | 'replace' | ((old: JsonSchemaDef, neo: JsonSchemaDef) => JsonSchemaDef);
-		} = {},
-	) {
-		if (!schema.$id) throw new Error('Schema must have $id');
-		switch (onConflict) {
-			case 'ignore':
-				onConflict = (old) => old;
-				break;
-			case 'replace':
-				onConflict = (_, neo) => neo;
-				break;
-			case 'throw':
-				onConflict = (old, neo) => {
-					throw new Error(`Schema ${neo.$id} already exists`);
-				};
-				break;
-		}
-		let idx = schemas.findIndex((s) => s.$id === schema.$id);
-		if (idx >= 0) {
-			schemas[idx] = onConflict(schemas[idx], schema);
-		} else {
-			schemas.push(schema);
-		}
+let schemas: JsonSchemaDef[] = [];
+
+let createValidator = _createValidator;
+
+function addSchema(
+	schema: JsonSchemaDef,
+	{
+		onConflict = 'throw',
+	}: {
+		onConflict?: 'throw' | 'ignore' | 'replace' | ((old: JsonSchemaDef, neo: JsonSchemaDef) => JsonSchemaDef);
+	} = {},
+) {
+	if (!schema.$id) throw new Error('Schema must have $id');
+	switch (onConflict) {
+		case 'ignore':
+			onConflict = (old) => old;
+			break;
+		case 'replace':
+			onConflict = (_, neo) => neo;
+			break;
+		case 'throw':
+			onConflict = (_old, neo) => {
+				throw new Error(`Schema ${neo.$id} already exists`);
+			};
+			break;
 	}
-
-	/**
-	 * Check data is valid, will not use default
-	 */
-	export function check<S>(schema: S, data: any): ValidateResult<TypeOfSchema<S>> {
-		return validate({ schema, data, mutate: false, clone: true }) as any;
+	let idx = schemas.findIndex((s) => s.$id === schema.$id);
+	if (idx >= 0) {
+		schemas[idx] = onConflict(schemas[idx], schema);
+	} else {
+		schemas.push(schema);
 	}
+}
 
-	/**
-	 * Parse data with default value and coerceTypes
-	 */
-	export function safeParse<S>(schema: S, data: any): ValidateResult<TypeOfSchema<S>> {
-		return validate({ schema, data, mutate: true, clone: true }) as any;
-	}
+/**
+ * Check data is valid, will not use default
+ */
+function check<S>(schema: S, data: any): ValidateResult<TypeOfSchema<S>> {
+	return validate({ schema, data, mutate: false, clone: true }) as any;
+}
 
-	export function parse<S>(schema: S, data: any): TypeOfSchema<S> {
-		const { data: out, message, errors } = validate({ schema, data, mutate: true, clone: true });
-		if (errors) {
-			throw new Error(message);
-		}
-		return out;
+/**
+ * Parse data with default value and coerceTypes
+ */
+function safeParse<S>(schema: S, data: any): ValidateResult<TypeOfSchema<S>> {
+	return validate({ schema, data, mutate: true, clone: true }) as any;
+}
+
+function parse<S>(schema: S, data: any): TypeOfSchema<S> {
+	const { data: out, message, errors } = validate({ schema, data, mutate: true, clone: true });
+	if (errors) {
+		throw new Error(message);
 	}
+	return out;
+}
 
-	export function create<S>(schema: S, data?: any): TypeOfSchema<S> {
-		// will not ensure value match the rule
-		return match(schema as JsonSchemaDef)
-			.returnType<any>()
-			.with({ const: P.nonNullable }, (v) => v)
-			.with({ default: P.select() }, (v) => v)
-			.with({ anyOf: P.nonNullable }, (schema) => {
-				return create(schema.anyOf[0]);
-			})
-			.with({ oneOf: P.nonNullable }, (schema) => {
-				return create(schema.oneOf[0]);
-			})
-			.with({ type: 'string' }, (schema) => '')
-			.with({ type: P.union('number', 'integer') }, (schema) => 0)
-			.with({ type: 'object' }, (schema) => {
-				let out = validate({ schema, data: data ?? {}, mutate: true });
-				if (!out.success) {
-					// fallback
-					let obj = data || {};
-					schema.required?.forEach((key) => {
-						if (!(key in obj)) {
-							let last = obj[key];
-							let prop = schema.properties?.[key];
-							if (prop && isNil(last)) obj[key] = JsonSchema.create(prop, last);
-						}
-					});
-					out = validate({ schema, data: obj, mutate: true });
-					if (!out.success) {
-						console.warn(`Failed to create object with schema: ${out.message}`);
+function create<S>(schema: S, data?: any): TypeOfSchema<S> {
+	// will not ensure value match the rule
+	return match(schema as JsonSchemaDef)
+		.returnType<any>()
+		.with({ const: P.nonNullable }, (v) => v)
+		.with({ default: P.select() }, (v) => v)
+		.with({ anyOf: P.nonNullable }, (schema) => {
+			return create(schema.anyOf[0]);
+		})
+		.with({ oneOf: P.nonNullable }, (schema) => {
+			return create(schema.oneOf[0]);
+		})
+		.with({ type: 'string' }, (_schema) => '')
+		.with({ type: P.union('number', 'integer') }, (_schema) => 0)
+		.with({ type: 'object' }, (schema: JsonSchemaDef) => {
+			let out = validate({ schema, data: data ?? {}, mutate: true });
+			if (!out.success) {
+				// fallback
+				let obj = data || {};
+				schema.required?.forEach((key) => {
+					if (!(key in obj)) {
+						let last = obj[key];
+						let prop = schema.properties?.[key];
+						if (prop && isNil(last)) obj[key] = JsonSchema.create(prop, last);
 					}
+				});
+				out = validate({ schema, data: obj, mutate: true });
+				if (!out.success) {
+					console.warn(`Failed to create object with schema: ${out.message}`);
 				}
-				return out.data;
-			})
-			.with({ type: 'null' }, () => null)
-			.with({ type: 'boolean' }, (schema) => false)
-			.with({ type: 'array' }, (schema) => [])
-			.otherwise(() => {
-				return undefined;
-			});
-	}
+			}
+			return out.data;
+		})
+		.with({ type: 'null' }, () => null)
+		.with({ type: 'boolean' }, (_schema) => false)
+		.with({ type: 'array' }, (_schema) => [])
+		.otherwise(() => {
+			return undefined;
+		});
+}
 
-	export function isPrimitiveType(schema: any): boolean {
-		return match(schema as JsonSchemaDef)
-			.returnType<boolean>()
-			.with({ type: P.union('number', 'integer', 'string', 'boolean') }, () => true)
-			.with({ anyOf: P.nonNullable }, (schema) => {
-				return isPrimitiveType(schema.anyOf[0]);
-			})
-			.with({ oneOf: P.nonNullable }, (schema) => {
-				return isPrimitiveType(schema.oneOf[0]);
-			})
-			.otherwise(() => false);
-	}
+function isPrimitiveType(schema: any): boolean {
+	return match(schema as JsonSchemaDef)
+		.returnType<boolean>()
+		.with({ type: P.union('number', 'integer', 'string', 'boolean') }, () => true)
+		.with({ anyOf: P.nonNullable }, (schema) => {
+			return isPrimitiveType(schema.anyOf[0]);
+		})
+		.with({ oneOf: P.nonNullable }, (schema) => {
+			return isPrimitiveType(schema.oneOf[0]);
+		})
+		.otherwise(() => false);
 }
+
+export const JsonSchema = {
+	createValidator,
+	addSchema,
+	schemas,
+	check,
+	safeParse,
+	parse,
+	create,
+	isPrimitiveType,
+} as const;