@molecule/api-resource 1.0.6 → 1.0.7

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-10-23T21:27:14.472Z
+Generated: 2026-10-26T04:23:42.740Z
 -->
 
 # @molecule/api-resource
@@ -307,11 +307,14 @@ export const create = ({ name, tableName, schema }: types.Resource) => {
 ```
 
 ```typescript
-function create({
+function create<
+  CreateProps extends Record<string, unknown> = Record<string, unknown>,
+  CreatedProps extends types.Props & CreateProps = types.Props & CreateProps,
+>({
   name,
   tableName,
   schema,
-}: types.Resource<unknown>): ({
+}: types.Resource): ({
   props: createProps,
   id,
 }: {
@@ -372,7 +375,13 @@ export const del = ({ name, tableName, schema }: types.Resource) => {
 ```
 
 ```typescript
-function del({ name, tableName }: DeletedResource): ({ id }: { id: Props['id'] }) => Promise<
+function del<
+  Props extends types.Props = types.Props,
+  DeletedResource extends types.Resource<Props> = types.Resource<Props>,
+>({
+  name,
+  tableName,
+}: DeletedResource): ({ id }: { id: Props['id'] }) => Promise<
   | { statusCode: number; body: { error: string; errorKey: string; props?: undefined } }
   | {
       statusCode: number
@@ -394,7 +403,10 @@ Creates a request handler to be used to query resources.
 Uses the bonded DataStore from `@molecule/api-database` for database-agnostic operations.
 
 ```typescript
-function query({
+function query<
+  Props extends types.Props = types.Props,
+  QueriedResource extends types.Resource = types.Resource,
+>({
   tableName,
 }: QueriedResource): (
   req: MoleculeRequest,
@@ -432,7 +444,10 @@ export const read = ({ name, tableName, schema }: types.Resource) => {
 ```
 
 ```typescript
-function read({
+function read<
+  ReadProps extends types.Props = types.Props,
+  ReadResource extends types.Resource<ReadProps> = types.Resource<ReadProps>,
+>({
   tableName,
 }: ReadResource): ({
   id,
@@ -504,11 +519,18 @@ export const update = ({ name, tableName, schema }: types.Resource) => {
 ```
 
 ```typescript
-function update({
+function update<
+  UpdateProps extends Record<string, unknown> = Record<string, unknown>,
+  UpdatedProps extends Pick<types.Props, `updatedAt`> & UpdateProps = Pick<
+    types.Props,
+    `updatedAt`
+  > &
+    UpdateProps,
+>({
   name,
   tableName,
   schema,
-}: types.Resource<unknown>): ({
+}: types.Resource): ({
   id,
   props: updateProps,
 }: {
@@ -597,9 +619,7 @@ Creates a Zod schema for the standard `{ statusCode, body }` response
 returned by resource CRUD operations.
 
 ```typescript
-function responseSchema(
-  propsSchema: T,
-): z.ZodTypeAny<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>
+function responseSchema<T extends z.ZodTypeAny>(propsSchema: T): z.ZodTypeAny
 ```
 
 - `propsSchema` — The Zod schema for the resource's props (e.g. `userPropsSchema`).
@@ -612,9 +632,7 @@ Creates a Zod schema that validates a resource descriptor object
 (`{ name, tableName, schema }`).
 
 ```typescript
-function resourceSchema(
-  _propsSchema: T,
-): z.ZodTypeAny<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>
+function resourceSchema<T extends z.ZodTypeAny>(_propsSchema: T): z.ZodTypeAny
 ```
 
 - `_propsSchema` — The Zod schema for the resource's props (used for type inference only).
@@ -627,10 +645,7 @@ Validates data against a Zod schema, throwing an `Error` with a
 human-readable message listing all validation failures if invalid.
 
 ```typescript
-function validate(
-  schema: z.ZodSchema<T, unknown, z.core.$ZodTypeInternals<T, unknown>>,
-  data: unknown,
-): T
+function validate<T>(schema: z.ZodSchema<T>, data: unknown): T
 ```
 
 - `schema` — The Zod schema to validate against.
@@ -644,8 +659,8 @@ Validates data against a Zod schema without throwing. Returns a discriminated
 union: `{ success: true, data }` on success or `{ success: false, error }` on failure.
 
 ```typescript
-function safeParse(
-  schema: z.ZodSchema<T, unknown, z.core.$ZodTypeInternals<T, unknown>>,
+function safeParse<T>(
+  schema: z.ZodSchema<T>,
   data: unknown,
 ): { success: true; data: T } | { success: false; error: z.ZodError }
 ```
@@ -661,9 +676,9 @@ Creates a schema where all fields are optional, suitable for validating
 partial update payloads where only changed fields are sent.
 
 ```typescript
-function partial(
-  schema: z.ZodObject<T, z.core.$strip>,
-): z.ZodObject<{ [K in keyof T]: z.ZodOptional<T[K]> }, z.core.$strip>
+function partial<T extends z.ZodRawShape>(
+  schema: z.ZodObject<T>,
+): z.ZodObject<{ [K in keyof T]: z.ZodOptional<T[K]> }>
 ```
 
 - `schema` — The Zod object schema to make partial.
@@ -676,10 +691,10 @@ Creates a schema with only the specified fields, useful for create payloads
 where only a subset of the full props should be provided by the client.
 
 ```typescript
-function pick(
-  schema: z.ZodObject<T, z.core.$strip>,
+function pick<T extends z.ZodRawShape, K extends keyof T>(
+  schema: z.ZodObject<T>,
   keys: readonly K[],
-): z.ZodObject<Pick<T, K>, z.core.$strip>
+): z.ZodObject<Pick<T, K>>
 ```
 
 - `schema` — The Zod object schema to pick from.
@@ -839,8 +854,17 @@ const getValidProps: <Props>({
   schema,
   props,
 }: {
+  /**
+   * The name of the resource (used in error messages).
+   */
   name: string
+  /**
+   * The Zod schema used when validating props.
+   */
   schema: ZodSchema<Props>
+  /**
+   * The `props` to be validated.
+   */
   props: unknown
 }) => Props
 ```
@@ -860,7 +884,15 @@ Validates data against a Zod schema without throwing, returning a discriminated
 const safeParse: <T>(
   schema: ZodSchema<T>,
   data: unknown,
-) => { success: true; data: T } | { success: false; error: ZodError }
+) =>
+  | {
+      success: true
+      data: T
+    }
+  | {
+      success: false
+      error: ZodError
+    }
 ```
 
 - `schema` — The Zod schema to validate against.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/api-resource",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Resource CRUD operations and utilities for molecule.dev.",
   "type": "module",
   "main": "dist/index.js",
@@ -39,10 +39,10 @@
     "zod": "4.6.7"
   },
   "devDependencies": {
-    "@molecule/api-bond": "1.0.3",
-    "@molecule/api-database": "1.1.5",
+    "@molecule/api-bond": "1.0.4",
+    "@molecule/api-database": "1.2.1",
     "@molecule/api-locales-resource": "1.0.2",
-    "@molecule/api-utilities-validation": "1.0.3",
+    "@molecule/api-utilities-validation": "1.0.4",
     "@types/node": "26.6.5",
     "typescript": "6.0.3",
     "vitest": "4.1.12"