Add Zod runtime validation schemas for hooks

[Copilot]

Implements runtime validation for hook types, enabling validation of dynamically loaded hook configurations (e.g., from YAML/JSON sources).

Changes

• hook.zod.ts: Zod schemas mirroring all interfaces from hook.ts

  • HookOperationSchema, HookTimingSchema, HookAPISchema
  • Context schemas: BaseHookContextSchema, RetrievalHookContextSchema, MutationHookContextSchema, UpdateHookContextSchema
  • ObjectHookDefinitionSchema for validating complete hook definitions
  • Exported inferred types for each schema

• Dependencies: Added zod@^3.22.4 to @objectql/types

• Tests: Comprehensive validation coverage (test/hook.zod.test.ts)

Usage

import { ObjectHookDefinitionSchema } from '@objectql/types';

// Validate hook definition loaded from external source
const hookConfig = loadFromYAML('project.hook.yml');
const validated = ObjectHookDefinitionSchema.parse(hookConfig);

// Runtime validation catches misconfigurations
const invalid = { beforeCreate: 'not-a-function' };
ObjectHookDefinitionSchema.parse(invalid); // throws ZodError

Complements compile-time TypeScript checking with runtime guarantees, particularly useful for metadata-driven architectures where hook definitions originate from configuration files.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• fonts.googleapis.com
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/objectql/objectql/apps/site/node_modules/.bin/../next/dist/bin/next build ndation/types/sr-g ndat�� ndation/types/src/query.ts ndation/types/src/index.ts ndation/types/src/driver.ts ndation/types/srsh ndation/types/sr-c ndation/types/srnode install.js ndation/types/src/formula.ts ndat�� ndation/types/src/validation.ts vers/sql/package.json p/bin/git (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

继续现有的hook实现编写hook.zod

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
objectql-site	Ready	Preview, Comment	Jan 24, 2026 0:41am

[github-actions]

⚠️ No Changeset Found

This PR does not include a changeset file.
If this PR includes user-facing changes, please add a changeset by running:

pnpm changeset

[Copilot]

Pull request overview

This PR introduces Zod-based runtime validation schemas for hook-related types in @objectql/types, enabling validation of hook configurations loaded from external metadata (YAML/JSON) alongside existing TypeScript compile-time checks.

Changes:

• Added hook.zod.ts with Zod schemas mirroring hook.ts hook types (operations, timings, contexts, and object hook definitions) plus inferred helper types.
• Exported the new Zod schemas from the @objectql/types entrypoint and added Jest tests in hook.zod.test.ts to cover valid/invalid operations, contexts, and hook definitions.
• Introduced a zod runtime dependency in the @objectql/types package and wired it into the workspace lockfile.

Reviewed changes

Copilot reviewed 4 out of 5 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
packages/foundation/types/src/hook.zod.ts	Defines Zod schemas and inferred types for hook operations, timing, API, contexts, handlers, and object hook definitions, paralleling hook.ts.
packages/foundation/types/src/index.ts	Re-exports the new Zod schemas/types from the @objectql/types public API.
packages/foundation/types/test/hook.zod.test.ts	Adds Jest tests to validate the behavior of the new Zod schemas for valid/invalid inputs and various hook scenarios.
packages/foundation/types/package.json	Declares zod as a runtime dependency of @objectql/types.
pnpm-lock.yaml	Updates the workspace lockfile to include the resolved zod version for packages/foundation/types.

Files not reviewed (1)

• pnpm-lock.yaml: Language not supported

[Copilot]

Adding Zod-based runtime schemas into @objectql/types breaks the package’s role as a pure type/contract layer and couples consumers of the type definitions to a concrete validation library. To preserve the protocol layering (types-only here, runtime logic elsewhere), these schemas should live in a runtime-oriented package (e.g. core/runtime) that imports the interfaces from hook.ts, rather than being implemented directly in the types package.

[Copilot]

The test description "should reject unknown hook names" contradicts the actual expectation (ObjectHookDefinitionSchema.parse is expected not to throw for an invalidHook property). This mismatch can confuse readers about the intended behavior; please rename the test to reflect that unknown hook names are currently accepted (or change the assertion if the behavior is supposed to be strict).

[Copilot]

Unused variable mockAPI.

Suggested change

	const mockAPI = {
	find: async () => [],
	findOne: async () => ({}),
	count: async () => 0,
	create: async () => ({}),
	update: async () => ({}),
	delete: async () => ({}),
	};