@molecule/api-resource 1.0.0

package/dist/schema.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Zod schemas and validation utilities for resource operations.
+ *
+ * Every resource extends `basePropsSchema` which defines the `id`,
+ * `createdAt`, and `updatedAt` fields common to all database records.
+ *
+ * @module
+ */
+import { z } from 'zod';
+/**
+ * Base Zod schema with the three fields every resource row must have:
+ * `id` (UUID), `createdAt` (ISO datetime), and `updatedAt` (ISO datetime).
+ */
+export declare const basePropsSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+/**
+ * TypeScript type inferred from `basePropsSchema`, containing `id`, `createdAt`, and `updatedAt`.
+ */
+export type BaseProps = z.infer<typeof basePropsSchema>;
+/**
+ * Creates a Zod schema for the standard `{ statusCode, body }` response
+ * returned by resource CRUD operations.
+ *
+ * @param propsSchema - The Zod schema for the resource's props (e.g. `userPropsSchema`).
+ * @returns A Zod schema that validates `{ statusCode: number, body: { props? } | T[] }`.
+ */
+export declare const responseSchema: <T extends z.ZodTypeAny>(propsSchema: T) => z.ZodTypeAny;
+/**
+ * Creates a Zod schema that validates a resource descriptor object
+ * (`{ name, tableName, schema }`).
+ *
+ * @param _propsSchema - The Zod schema for the resource's props (used for type inference only).
+ * @returns A Zod schema that validates the resource descriptor shape.
+ */
+export declare const resourceSchema: <T extends z.ZodTypeAny>(_propsSchema: T) => z.ZodTypeAny;
+/**
+ * Validates data against a Zod schema, throwing an `Error` with a
+ * human-readable message listing all validation failures if invalid.
+ *
+ * @param schema - The Zod schema to validate against.
+ * @param data - The data to validate.
+ * @returns The parsed and typed data if validation succeeds.
+ * @throws {Error} Error with comma-separated validation issue descriptions.
+ */
+export declare const validate: <T>(schema: z.ZodSchema<T>, data: unknown) => T;
+/**
+ * Validates data against a Zod schema without throwing. Returns a discriminated
+ * union: `{ success: true, data }` on success or `{ success: false, error }` on failure.
+ *
+ * @param schema - The Zod schema to validate against.
+ * @param data - The data to validate.
+ * @returns A discriminated union indicating success with parsed data, or failure with a `ZodError`.
+ */
+export declare const safeParse: <T>(schema: z.ZodSchema<T>, data: unknown) => {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: z.ZodError;
+};
+/**
+ * Creates a schema where all fields are optional, suitable for validating
+ * partial update payloads where only changed fields are sent.
+ *
+ * @param schema - The Zod object schema to make partial.
+ * @returns A new Zod schema with all fields marked optional.
+ */
+export declare const partial: <T extends z.ZodRawShape>(schema: z.ZodObject<T>) => z.ZodObject<{ [K in keyof T]: z.ZodOptional<T[K]>; }>;
+/**
+ * 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.
+ *
+ * @param schema - The Zod object schema to pick from.
+ * @param keys - The field names to include in the new schema.
+ * @returns A new Zod schema containing only the picked fields.
+ */
+export declare const pick: <T extends z.ZodRawShape, K extends keyof T>(schema: z.ZodObject<T>, keys: readonly K[]) => z.ZodObject<Pick<T, K>>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;iBAe1B,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEvD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,aAAa,CAAC,KAAG,CAAC,CAAC,UAUtE,CAAA;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,cAAc,CAAC,KAAG,CAAC,CAAC,UAKvE,CAAA;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,OAAO,KAAG,CAOnE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EACzB,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,MAAM,OAAO,KACZ;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAA;CAElE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAC7C,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KACrB,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAE,CAErD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,MAAM,CAAC,EAC7D,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,MAAM,SAAS,CAAC,EAAE,KACjB,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAMxB,CAAA"}

package/dist/schema.js

@@ -0,0 +1,112 @@
+/**
+ * Zod schemas and validation utilities for resource operations.
+ *
+ * Every resource extends `basePropsSchema` which defines the `id`,
+ * `createdAt`, and `updatedAt` fields common to all database records.
+ *
+ * @module
+ */
+import { z } from 'zod';
+/**
+ * Base Zod schema with the three fields every resource row must have:
+ * `id` (UUID), `createdAt` (ISO datetime), and `updatedAt` (ISO datetime).
+ */
+export const basePropsSchema = z.object({
+    /**
+     * Usually a UUID.
+     */
+    id: z.string().uuid(),
+    /**
+     * When the resource was created.
+     * Usually an ISO 8601 timestamp.
+     */
+    createdAt: z.string().datetime(),
+    /**
+     * When the resource was last updated.
+     * Usually an ISO 8601 timestamp.
+     */
+    updatedAt: z.string().datetime(),
+});
+/**
+ * Creates a Zod schema for the standard `{ statusCode, body }` response
+ * returned by resource CRUD operations.
+ *
+ * @param propsSchema - The Zod schema for the resource's props (e.g. `userPropsSchema`).
+ * @returns A Zod schema that validates `{ statusCode: number, body: { props? } | T[] }`.
+ */
+export const responseSchema = (propsSchema) => z.object({
+    statusCode: z.number(),
+    body: z.union([
+        z.object({
+            props: propsSchema.optional(),
+            error: z.string().optional(),
+        }),
+        z.array(propsSchema),
+    ]),
+});
+/**
+ * Creates a Zod schema that validates a resource descriptor object
+ * (`{ name, tableName, schema }`).
+ *
+ * @param _propsSchema - The Zod schema for the resource's props (used for type inference only).
+ * @returns A Zod schema that validates the resource descriptor shape.
+ */
+export const resourceSchema = (_propsSchema) => z.object({
+    name: z.string(),
+    tableName: z.string(),
+    schema: z.custom(() => true),
+});
+/**
+ * Validates data against a Zod schema, throwing an `Error` with a
+ * human-readable message listing all validation failures if invalid.
+ *
+ * @param schema - The Zod schema to validate against.
+ * @param data - The data to validate.
+ * @returns The parsed and typed data if validation succeeds.
+ * @throws {Error} Error with comma-separated validation issue descriptions.
+ */
+export const validate = (schema, data) => {
+    const result = schema.safeParse(data);
+    if (!result.success) {
+        const errors = result.error.issues.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ');
+        throw new Error(`Validation failed: ${errors}`);
+    }
+    return result.data;
+};
+/**
+ * Validates data against a Zod schema without throwing. Returns a discriminated
+ * union: `{ success: true, data }` on success or `{ success: false, error }` on failure.
+ *
+ * @param schema - The Zod schema to validate against.
+ * @param data - The data to validate.
+ * @returns A discriminated union indicating success with parsed data, or failure with a `ZodError`.
+ */
+export const safeParse = (schema, data) => {
+    return schema.safeParse(data);
+};
+/**
+ * Creates a schema where all fields are optional, suitable for validating
+ * partial update payloads where only changed fields are sent.
+ *
+ * @param schema - The Zod object schema to make partial.
+ * @returns A new Zod schema with all fields marked optional.
+ */
+export const partial = (schema) => {
+    return schema.partial();
+};
+/**
+ * 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.
+ *
+ * @param schema - The Zod object schema to pick from.
+ * @param keys - The field names to include in the new schema.
+ * @returns A new Zod schema containing only the picked fields.
+ */
+export const pick = (schema, keys) => {
+    const shape = {};
+    for (const key of keys) {
+        shape[key] = schema.shape[key];
+    }
+    return z.object(shape);
+};
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC;;OAEG;IACH,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB;;;OAGG;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC;;;OAGG;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAA;AAOF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAyB,WAAc,EAAgB,EAAE,CACrF,CAAC,CAAC,MAAM,CAAC;IACP,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC;QACZ,CAAC,CAAC,MAAM,CAAC;YACP,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE;YAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B,CAAC;QACF,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;KACrB,CAAC;CACH,CAAC,CAAA;AAEJ;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAyB,YAAe,EAAgB,EAAE,CACtF,CAAC,CAAC,MAAM,CAAC;IACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAI,GAAG,EAAE,CAAC,IAAI,CAAC;CAChC,CAAC,CAAA;AAEJ;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAI,MAAsB,EAAE,IAAa,EAAK,EAAE;IACtE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7F,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,EAAE,CAAC,CAAA;IACjD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAA;AACpB,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,MAAsB,EACtB,IAAa,EACuD,EAAE;IACtE,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AAC/B,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,MAAsB,EACgC,EAAE;IACxD,OAAO,MAAM,CAAC,OAAO,EAAE,CAAA;AACzB,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAClB,MAAsB,EACtB,IAAkB,EACO,EAAE;IAC3B,MAAM,KAAK,GAAG,EAA6B,CAAA;IAC3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,GAAa,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC1C,CAAC;IACD,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAuC,CAAA;AAC9D,CAAC,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Core type definitions for the resource CRUD framework.
+ *
+ * Defines the `Props`, `Resource`, and `Response` interfaces used by
+ * the `create`, `read`, `update`, `del`, and `query` handler factories.
+ *
+ * @module
+ */
+import type { z } from 'zod';
+import type { BaseProps } from './schema.js';
+export type { BaseProps };
+/**
+ * The resource's properties to be stored in the database.
+ *
+ * Used by CRUD operations for type inference.
+ */
+export interface Props {
+    /**
+     * Usually a UUID.
+     */
+    id: string;
+    /**
+     * When the resource was created.
+     *
+     * Usually an ISO 8601 timestamp.
+     */
+    createdAt: string;
+    /**
+     * When the resource was last updated.
+     *
+     * Usually an ISO 8601 timestamp.
+     */
+    updatedAt: string;
+}
+/**
+ * An object describing the resource.
+ *
+ * The schema can be a Zod schema (z.ZodTypeAny) for new code,
+ * or any other schema type for backward compatibility.
+ */
+export interface Resource<T = unknown> {
+    /**
+     * The name of the resource.
+     *
+     * @example User
+     */
+    name: string;
+    /**
+     * The database table name for the resource.
+     *
+     * @example users
+     */
+    tableName: string;
+    /**
+     * The schema used when validating props.
+     *
+     * Can be a Zod schema (z.ZodTypeAny) or other schema formats.
+     */
+    schema: T;
+}
+/**
+ * An object describing the resource with a Zod schema.
+ *
+ * Use this type when you want to enforce Zod schema usage.
+ */
+export interface ZodResource<T extends z.ZodTypeAny = z.ZodTypeAny> {
+    name: string;
+    tableName: string;
+    schema: T;
+}
+/**
+ * Standard response from resource operations.
+ */
+export interface Response<T = unknown> {
+    /**
+     * HTTP status code to return.
+     */
+    statusCode: number;
+    /**
+     * The response payload.
+     */
+    body: {
+        props?: T;
+        error?: string;
+        errorKey?: string;
+    } | T[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAG5C,YAAY,EAAE,SAAS,EAAE,CAAA;AAEzB;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IACV;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACnC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,MAAM,EAAE,CAAC,CAAA;CACV;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IAChE,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,CAAC,CAAA;CACV;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACnC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,IAAI,EACA;QACE,KAAK,CAAC,EAAE,CAAC,CAAA;QACT,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,GACD,CAAC,EAAE,CAAA;CACR"}

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * Core type definitions for the resource CRUD framework.
+ *
+ * Defines the `Props`, `Resource`, and `Response` interfaces used by
+ * the `create`, `read`, `update`, `del`, and `query` handler factories.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/update.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Resource update operation.
+ *
+ * @module
+ */
+import type * as types from './types.js';
+/**
+ * Creates a handler to update a resource by its `id` and some `props`.
+ *
+ * Uses the bonded DataStore from `@molecule/api-database` for database-agnostic operations.
+ *
+ * Example usage:
+ * ```ts
+ * import { update as resourceUpdate } from '@molecule/api-resource'
+ * import type * as types from '../../types.js'
+ *
+ * export const update = ({ name, tableName, schema }: types.Resource) => {
+ *   const update = resourceUpdate({ name, tableName, schema })
+ *
+ *   return async (req: MoleculeRequest) => {
+ *     const id = req.params.id
+ *     const props = req.body
+ *     return await update({ id, props })
+ *   }
+ * }
+ * ```
+ * @param resource - The resource descriptor.
+ * @param resource.name - Human-readable resource name used in error messages (e.g. `'User'`).
+ * @param resource.tableName - Database table to update the row in.
+ * @param resource.schema - Zod schema to validate the incoming props against.
+ * @returns A curried async function that accepts `{ id, props }` and returns a `{ statusCode, body }` response.
+ */
+export declare const 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) => ({ id, props: updateProps, }: {
+    /**
+     * The `id` of the resource to be updated.
+     */
+    id: UpdatedProps["id"] | types.Props["id"];
+    /**
+     * The properties to be updated.
+     *
+     * Usually from `req.body`.
+     */
+    props: UpdateProps;
+}) => Promise<{
+    statusCode: number;
+    body: {
+        error: string;
+        errorKey: string;
+        props?: undefined;
+    };
+} | {
+    statusCode: number;
+    body: {
+        props: UpdatedProps;
+        error?: undefined;
+        errorKey?: undefined;
+    };
+}>;
+//# sourceMappingURL=update.d.ts.map

package/dist/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAGxC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,MAAM,GAEf,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,YAAY,SAAS,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,WAAW,GAAG,IAAI,CACtE,KAAK,CAAC,KAAK,EACX,WAAW,CACZ,GACC,WAAW,EACb,8BAIC,KAAK,CAAC,QAAQ,MACV,6BAGJ;IACD;;OAEG;IACH,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC1C;;;;OAIG;IACH,KAAK,EAAE,WAAW,CAAA;CACnB;;;;;;;;;;;;;;EAuDA,CAAA"}

package/dist/update.js

@@ -0,0 +1,82 @@
+/**
+ * Resource update operation.
+ *
+ * @module
+ */
+import { getLogger } from '@molecule/api-bond';
+const logger = getLogger();
+import { updateById } from '@molecule/api-database';
+import { t } from '@molecule/api-i18n';
+import { getValidProps } from './utilities/index.js';
+/**
+ * Creates a handler to update a resource by its `id` and some `props`.
+ *
+ * Uses the bonded DataStore from `@molecule/api-database` for database-agnostic operations.
+ *
+ * Example usage:
+ * ```ts
+ * import { update as resourceUpdate } from '@molecule/api-resource'
+ * import type * as types from '../../types.js'
+ *
+ * export const update = ({ name, tableName, schema }: types.Resource) => {
+ *   const update = resourceUpdate({ name, tableName, schema })
+ *
+ *   return async (req: MoleculeRequest) => {
+ *     const id = req.params.id
+ *     const props = req.body
+ *     return await update({ id, props })
+ *   }
+ * }
+ * ```
+ * @param resource - The resource descriptor.
+ * @param resource.name - Human-readable resource name used in error messages (e.g. `'User'`).
+ * @param resource.tableName - Database table to update the row in.
+ * @param resource.schema - Zod schema to validate the incoming props against.
+ * @returns A curried async function that accepts `{ id, props }` and returns a `{ statusCode, body }` response.
+ */
+export const update = ({ name, tableName, schema, }) => async ({ id, props: updateProps, }) => {
+    // TypeScript 5+ requires explicit unknown cast for generic type conversions
+    let props = updateProps;
+    try {
+        // Describe when the resource was updated.
+        props.updatedAt = new Date().toISOString();
+        // Validate the new `props`.
+        props = getValidProps({
+            name,
+            schema: schema,
+            props,
+        });
+    }
+    catch (error) {
+        // The provided `props` failed validation.
+        return {
+            statusCode: 400,
+            body: {
+                error: error
+                    ? String(error)
+                    : t('resource.error.unknownError', undefined, { defaultValue: 'Unknown error.' }),
+                errorKey: 'resource.error.unknownError',
+            },
+        };
+    }
+    try {
+        // Update the resource in the database via the bonded DataStore.
+        const result = await updateById(tableName, id, props);
+        if (!result.affected) {
+            throw new Error(`Unable to update ${tableName} by id: ${id}`);
+        }
+        // If we made it here, updates to the database were successful.
+        return { statusCode: 200, body: { props } };
+    }
+    catch (error) {
+        logger.error(error);
+        return {
+            statusCode: error.statusCode || 400,
+            body: {
+                error: t('resource.error.unableToUpdate', { name }, { defaultValue: `Unable to update ${name}.` }),
+                errorKey: 'resource.error.unableToUpdate',
+            },
+        };
+    }
+};
+//# sourceMappingURL=update.js.map

package/dist/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAA;AAGtC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,MAAM,GACjB,CAOE,EACA,IAAI,EACJ,SAAS,EACT,MAAM,GACS,EAAE,EAAE,CACrB,KAAK,EAAE,EACL,EAAE,EACF,KAAK,EAAE,WAAW,GAYnB,EAAE,EAAE;IACH,4EAA4E;IAC5E,IAAI,KAAK,GAAG,WAAsC,CAAA;IAElD,IAAI,CAAC;QACH,0CAA0C;QAC1C,KAAK,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QAE1C,4BAA4B;QAC5B,KAAK,GAAG,aAAa,CAAe;YAClC,IAAI;YACJ,MAAM,EAAE,MAA4C;YACpD,KAAK;SACN,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,0CAA0C;QAC1C,OAAO;YACL,UAAU,EAAE,GAAG;YACf,IAAI,EAAE;gBACJ,KAAK,EAAE,KAAK;oBACV,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;oBACf,CAAC,CAAC,CAAC,CAAC,6BAA6B,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC;gBACnF,QAAQ,EAAE,6BAA6B;aACxC;SACF,CAAA;IACH,CAAC;IAED,IAAI,CAAC;QACH,gEAAgE;QAChE,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,SAAS,EACT,EAAY,EACZ,KAA2C,CAC5C,CAAA;QAED,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,oBAAoB,SAAS,WAAW,EAAE,EAAE,CAAC,CAAA;QAC/D,CAAC;QAED,+DAA+D;QAC/D,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,CAAA;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACnB,OAAO;YACL,UAAU,EAAG,KAAiC,CAAC,UAAU,IAAI,GAAG;YAChE,IAAI,EAAE;gBACJ,KAAK,EAAE,CAAC,CACN,+BAA+B,EAC/B,EAAE,IAAI,EAAE,EACR,EAAE,YAAY,EAAE,oBAAoB,IAAI,GAAG,EAAE,CAC9C;gBACD,QAAQ,EAAE,+BAA+B;aAC1C;SACF,CAAA;IACH,CAAC;AACH,CAAC,CAAA"}

package/dist/utilities/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resource utilities.
+ *
+ * Re-exports validation utilities from `@molecule/api-utilities-validation`.
+ *
+ * @module
+ */
+export * from '@molecule/api-utilities-validation';
+//# sourceMappingURL=index.d.ts.map

package/dist/utilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,oCAAoC,CAAA"}

package/dist/utilities/index.js

@@ -0,0 +1,9 @@
+/**
+ * Resource utilities.
+ *
+ * Re-exports validation utilities from `@molecule/api-utilities-validation`.
+ *
+ * @module
+ */
+export * from '@molecule/api-utilities-validation';
+//# sourceMappingURL=index.js.map

package/dist/utilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,oCAAoC,CAAA"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@molecule/api-resource",
+  "version": "1.0.0",
+  "description": "Resource CRUD operations and utilities for molecule.dev.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "import": "./dist/schema.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "molecule",
+    "resource",
+    "crud"
+  ],
+  "license": "Apache-2.0",
+  "dependencies": {
+    "uuid": "14.0.1",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@molecule/api-bond": "1.0.0",
+    "@molecule/api-database": "1.0.0",
+    "@molecule/api-locales-resource": "1.0.0",
+    "@molecule/api-utilities-validation": "1.0.0",
+    "@types/node": "26.1.2",
+    "typescript": "6.0.3",
+    "vitest": "4.1.10"
+  },
+  "peerDependencies": {
+    "@molecule/api-bond": "^1.0.0",
+    "@molecule/api-database": "^1.0.0",
+    "@molecule/api-i18n": "^1.0.0",
+    "@molecule/api-locales-resource": "^1.0.0",
+    "@molecule/api-utilities-validation": "^1.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/molecule-dev/molecule.git",
+    "directory": "packages/api/infrastructure/resource"
+  },
+  "homepage": "https://github.com/molecule-dev/molecule/tree/main/packages/api/infrastructure/resource",
+  "bugs": "https://github.com/molecule-dev/molecule/issues",
+  "publishConfig": {
+    "access": "public"
+  }
+}