@molecule/api-resource 1.0.0

package/LICENSE

@@ -0,0 +1,115 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work.
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship.
+
+      "Contribution" shall mean any work of authorship, including the
+      original version of the Work and any modifications or additions
+      to that Work, that is intentionally submitted to the Licensor for
+      inclusion in the Work by the copyright owner or by an individual or
+      Legal Entity authorized to submit on behalf of the copyright owner.
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      patent license to make, have made, use, offer to sell, sell, import,
+      and otherwise transfer the Work.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file.
+
+   5. Submission of Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND.
+
+   8. Limitation of Liability. In no event and under no legal theory shall
+      any Contributor be liable to You for damages.
+
+   9. Accepting Warranty or Additional Liability.
+
+   Copyright 2026 Molecule Dev, Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/browser-guard.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browser-guard.d.ts.map

package/dist/browser-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-guard.d.ts","sourceRoot":"","sources":["../src/browser-guard.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,CAAA"}

package/dist/browser-guard.js

@@ -0,0 +1,19 @@
+/**
+ * Browser guard — `@molecule/api-resource` is SERVER-ONLY.
+ *
+ * Generated by scripts/gen-browser-guards.mjs (workspace root) — edit THAT, not this.
+ * Evaluating a server package in a browser bundle is always an import-graph mistake
+ * (node APIs, secrets); without this guard it surfaces as a cryptic downstream crash
+ * ("Buffer is not defined") far from the culprit. Throwing here names the package and
+ * the fix at the exact moment the client bundle evaluates it. jsdom tests and SSR are
+ * unaffected: the throw requires browser globals AND the absence of a node runtime.
+ */
+const g = globalThis;
+if (g.window !== undefined && g.document !== undefined && !g.process?.versions?.node) {
+    throw new Error('@molecule/api-resource is SERVER-ONLY: it was bundled into browser/client code. Import it only ' +
+        'from server code (a server route/function or your API), or dynamic-import it inside ' +
+        'the server handler — never from components or shared client modules, and never ' +
+        'polyfill Buffer/process to silence this.');
+}
+export {};
+//# sourceMappingURL=browser-guard.js.map

package/dist/browser-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-guard.js","sourceRoot":"","sources":["../src/browser-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,GAAG,UAIT,CAAA;AACD,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACrF,MAAM,IAAI,KAAK,CACb,iGAAiG;QAC/F,sFAAsF;QACtF,iFAAiF;QACjF,0CAA0C,CAC7C,CAAA;AACH,CAAC"}

package/dist/create.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Resource create operation.
+ *
+ * @module
+ */
+import type * as types from './types.js';
+/**
+ * Creates a handler to create a resource.
+ *
+ * Uses the bonded DataStore from `@molecule/api-database` for database-agnostic operations.
+ *
+ * Example usage:
+ * ```ts
+ * import { create as resourceCreate } from '@molecule/api-resource'
+ * import type * as types from '../../types.js'
+ *
+ * export const create = ({ name, tableName, schema }: types.Resource) => {
+ *   const create = resourceCreate({ name, tableName, schema })
+ *
+ *   return async (req: MoleculeRequest) => {
+ *     const props = req.body
+ *     return await create({ 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 insert the new row into.
+ * @param resource.schema - Zod schema to validate the incoming props against.
+ * @returns A curried async function that accepts `{ props, id? }` and returns a `{ statusCode, body }` response.
+ */
+export declare const create: <CreateProps extends Record<string, unknown> = Record<string, unknown>, CreatedProps extends types.Props & CreateProps = types.Props & CreateProps>({ name, tableName, schema, }: types.Resource) => ({ props: createProps, id, }: {
+    /**
+     * The properties of the resource to be created.
+     *
+     * Usually from `req.body`.
+     */
+    props: CreateProps;
+    /**
+     * Defaults a new UUID when not provided.
+     */
+    id?: CreatedProps["id"];
+}) => Promise<{
+    statusCode: number;
+    body: {
+        error: string;
+        errorKey: string;
+        props?: undefined;
+    };
+} | {
+    statusCode: number;
+    body: {
+        props: CreatedProps;
+        error?: undefined;
+        errorKey?: undefined;
+    };
+}>;
+//# sourceMappingURL=create.d.ts.map

package/dist/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../src/create.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAGxC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,MAAM,GAEf,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,YAAY,SAAS,KAAK,CAAC,KAAK,GAAG,WAAW,GAAG,KAAK,CAAC,KAAK,GAAG,WAAW,EAC1E,8BAIC,KAAK,CAAC,QAAQ,MACV,6BAGJ;IACD;;;;OAIG;IACH,KAAK,EAAE,WAAW,CAAA;IAClB;;OAEG;IACH,EAAE,CAAC,EAAE,YAAY,CAAC,IAAI,CAAC,CAAA;CACxB;;;;;;;;;;;;;;EAyDA,CAAA"}

package/dist/create.js

@@ -0,0 +1,87 @@
+/**
+ * Resource create operation.
+ *
+ * @module
+ */
+import { v4 as uuid } from 'uuid';
+import { getLogger } from '@molecule/api-bond';
+const logger = getLogger();
+import { create as storeCreate } from '@molecule/api-database';
+import { t } from '@molecule/api-i18n';
+import { getValidProps } from './utilities/index.js';
+/**
+ * Creates a handler to create a resource.
+ *
+ * Uses the bonded DataStore from `@molecule/api-database` for database-agnostic operations.
+ *
+ * Example usage:
+ * ```ts
+ * import { create as resourceCreate } from '@molecule/api-resource'
+ * import type * as types from '../../types.js'
+ *
+ * export const create = ({ name, tableName, schema }: types.Resource) => {
+ *   const create = resourceCreate({ name, tableName, schema })
+ *
+ *   return async (req: MoleculeRequest) => {
+ *     const props = req.body
+ *     return await create({ 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 insert the new row into.
+ * @param resource.schema - Zod schema to validate the incoming props against.
+ * @returns A curried async function that accepts `{ props, id? }` and returns a `{ statusCode, body }` response.
+ */
+export const create = ({ name, tableName, schema, }) => async ({ props: createProps, id, }) => {
+    // TypeScript 5+ requires explicit unknown cast for generic type conversions
+    let props = createProps;
+    try {
+        // Assign an `id` to this types.
+        id = id || uuid();
+        props.id = id;
+        // Always set server-controlled timestamps — never trust client-supplied values.
+        const now = new Date().toISOString();
+        props.createdAt = now;
+        props.updatedAt = now;
+        // Validate the new resource's `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 {
+        // Insert the new resource into the database via the bonded DataStore.
+        const result = await storeCreate(tableName, props);
+        if (!result.affected) {
+            throw new Error(`Failed to insert data into ${tableName}.`);
+        }
+        // If we made it here, the data was successfully inserted into the database.
+        return { statusCode: 201, body: { props } };
+    }
+    catch (error) {
+        logger.error(error);
+        return {
+            statusCode: error.statusCode || 400,
+            body: {
+                error: t('resource.error.unableToCreate', { name }, { defaultValue: `Unable to create ${name}.` }),
+                errorKey: 'resource.error.unableToCreate',
+            },
+        };
+    }
+};
+//# sourceMappingURL=create.js.map

package/dist/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../src/create.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,CAAA;AAGjC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;AAC1B,OAAO,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAA;AAGtC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,MAAM,GACjB,CAGE,EACA,IAAI,EACJ,SAAS,EACT,MAAM,GACS,EAAE,EAAE,CACrB,KAAK,EAAE,EACL,KAAK,EAAE,WAAW,EAClB,EAAE,GAYH,EAAE,EAAE;IACH,4EAA4E;IAC5E,IAAI,KAAK,GAAG,WAAsC,CAAA;IAElD,IAAI,CAAC;QACH,gCAAgC;QAChC,EAAE,GAAG,EAAE,IAAI,IAAI,EAAE,CAAA;QACjB,KAAK,CAAC,EAAE,GAAG,EAAE,CAAA;QAEb,gFAAgF;QAChF,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QACpC,KAAK,CAAC,SAAS,GAAG,GAAG,CAAA;QACrB,KAAK,CAAC,SAAS,GAAG,GAAG,CAAA;QAErB,uCAAuC;QACvC,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,sEAAsE;QACtE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,KAA2C,CAAC,CAAA;QAExF,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,8BAA8B,SAAS,GAAG,CAAC,CAAA;QAC7D,CAAC;QAED,4EAA4E;QAC5E,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/createRequestHandler.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Wraps resource handler functions into Express-compatible middleware.
+ *
+ * Resource handlers return `{ statusCode, headers?, body }` objects instead of
+ * calling `res.status().send()` directly, making them easier to test and
+ * reuse across different HTTP frameworks (Express, Lambda, etc.).
+ *
+ * @module
+ */
+import type { MoleculeNextFunction, MoleculeRequest, MoleculeResponse } from './http-types.js';
+/**
+ * A resource handler function that processes a request and returns a structured
+ * response object. If it returns `null` or `undefined`, the request is passed
+ * to the next middleware via `next()`.
+ *
+ * @param req - The incoming HTTP request.
+ * @param res - The HTTP response (available but handlers should return a Response instead of calling `res` directly).
+ */
+export type Handler = (req: MoleculeRequest, res: MoleculeResponse) => Promise<Response | null | undefined> | Response | null | undefined;
+/**
+ * Structured response object returned by resource handlers. Contains the HTTP
+ * status code, optional headers, and the response body payload.
+ */
+export interface Response {
+    /**
+     * HTTP status code to return.
+     */
+    statusCode: number;
+    /**
+     * Optional map of HTTP header keys to values.
+     */
+    headers?: Record<string, string>;
+    /**
+     * The response payload to return.
+     */
+    body: any;
+}
+/**
+ * Wraps a resource handler into Express-compatible middleware. Calls the handler,
+ * then applies `statusCode`, `headers`, and `body` to the response. If the handler
+ * returns null/undefined, calls `next()`. Catches errors and forwards them as
+ * i18n-translated error messages.
+ *
+ * @param handler - The resource handler function to wrap.
+ * @returns An Express-compatible middleware function `(req, res, next) => void`.
+ */
+export declare const createRequestHandler: (handler: Handler) => (req: MoleculeRequest, res: MoleculeResponse, next: MoleculeNextFunction) => Promise<void>;
+//# sourceMappingURL=createRequestHandler.d.ts.map

package/dist/createRequestHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRequestHandler.d.ts","sourceRoot":"","sources":["../src/createRequestHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAI9F;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG,CACpB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,gBAAgB,KAClB,OAAO,CAAC,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAA;AAEvE;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC;;OAEG;IACH,IAAI,EAAE,GAAG,CAAA;CACV;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAC9B,SAAS,OAAO,MACV,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,kBAkB7E,CAAA"}

package/dist/createRequestHandler.js

@@ -0,0 +1,42 @@
+/**
+ * Wraps resource handler functions into Express-compatible middleware.
+ *
+ * Resource handlers return `{ statusCode, headers?, body }` objects instead of
+ * calling `res.status().send()` directly, making them easier to test and
+ * reuse across different HTTP frameworks (Express, Lambda, etc.).
+ *
+ * @module
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { getLogger } from '@molecule/api-bond';
+const logger = getLogger();
+import { t } from '@molecule/api-i18n';
+/**
+ * Wraps a resource handler into Express-compatible middleware. Calls the handler,
+ * then applies `statusCode`, `headers`, and `body` to the response. If the handler
+ * returns null/undefined, calls `next()`. Catches errors and forwards them as
+ * i18n-translated error messages.
+ *
+ * @param handler - The resource handler function to wrap.
+ * @returns An Express-compatible middleware function `(req, res, next) => void`.
+ */
+export const createRequestHandler = (handler) => async (req, res, next) => {
+    try {
+        const response = await handler(req, res);
+        if (response) {
+            if (response.headers) {
+                res.set(response.headers);
+            }
+            res.status(response.statusCode);
+            res.send(response.body);
+        }
+        else {
+            next();
+        }
+    }
+    catch (error) {
+        logger.error(error);
+        next(t('resource.error.unknownError', undefined, { defaultValue: 'Something went wrong.' }));
+    }
+};
+//# sourceMappingURL=createRequestHandler.js.map

package/dist/createRequestHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRequestHandler.js","sourceRoot":"","sources":["../src/createRequestHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,uDAAuD;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAG9C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAA;AAkCtC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAC/B,CAAC,OAAgB,EAAE,EAAE,CACrB,KAAK,EAAE,GAAoB,EAAE,GAAqB,EAAE,IAA0B,EAAE,EAAE;IAChF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QAExC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;YAC3B,CAAC;YAED,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;YAC/B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACzB,CAAC;aAAM,CAAC;YACN,IAAI,EAAE,CAAA;QACR,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACnB,IAAI,CAAC,CAAC,CAAC,6BAA6B,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAA;IAC9F,CAAC;AACH,CAAC,CAAA"}

package/dist/del.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Resource delete operation.
+ *
+ * @module
+ */
+import type * as types from './types.js';
+/**
+ * Creates a handler to delete a resource by its `id`.
+ *
+ * > **Note:** We use `del` everywhere instead of `delete` since `delete` is a reserved keyword in JavaScript.
+ *
+ * Uses the bonded DataStore from `@molecule/api-database` for database-agnostic operations.
+ *
+ * Example usage:
+ * ```ts
+ * import { del as resourceDel } from '@molecule/api-resource'
+ * import type * as types from '../../types.js'
+ *
+ * export const del = ({ name, tableName, schema }: types.Resource) => {
+ *   const del = resourceDel({ name, tableName, schema })
+ *
+ *   return async (req: MoleculeRequest) => {
+ *     const id = req.params.id
+ *     return await del({ id })
+ *   }
+ * }
+ * ```
+ * @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 delete the row from.
+ * @returns A curried async function that accepts `{ id }` and returns a `{ statusCode, body }` response.
+ */
+export declare const del: <Props extends types.Props = types.Props, DeletedResource extends types.Resource<Props> = types.Resource<Props>>({ name, tableName, }: DeletedResource) => ({ id, }: {
+    /**
+     * The `id` of the resource to be deleted.
+     */
+    id: Props["id"];
+}) => Promise<{
+    statusCode: number;
+    body: {
+        error: string;
+        errorKey: string;
+        props?: undefined;
+    };
+} | {
+    statusCode: number;
+    body: {
+        props: {
+            id: Props["id"];
+        };
+        error?: undefined;
+        errorKey?: undefined;
+    };
+}>;
+//# sourceMappingURL=del.d.ts.map

package/dist/del.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"del.d.ts","sourceRoot":"","sources":["../src/del.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,GAAG,GAEZ,KAAK,SAAS,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EACvC,eAAe,SAAS,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EACrE,sBAGC,eAAe,MACX,SAEJ;IACD;;OAEG;IACH,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;CAChB;;;;;;;;;;;;;;;;EA+BA,CAAA"}

package/dist/del.js

@@ -0,0 +1,63 @@
+/**
+ * Resource delete operation.
+ *
+ * @module
+ */
+import { getLogger } from '@molecule/api-bond';
+const logger = getLogger();
+import { deleteById } from '@molecule/api-database';
+import { t } from '@molecule/api-i18n';
+/**
+ * Creates a handler to delete a resource by its `id`.
+ *
+ * > **Note:** We use `del` everywhere instead of `delete` since `delete` is a reserved keyword in JavaScript.
+ *
+ * Uses the bonded DataStore from `@molecule/api-database` for database-agnostic operations.
+ *
+ * Example usage:
+ * ```ts
+ * import { del as resourceDel } from '@molecule/api-resource'
+ * import type * as types from '../../types.js'
+ *
+ * export const del = ({ name, tableName, schema }: types.Resource) => {
+ *   const del = resourceDel({ name, tableName, schema })
+ *
+ *   return async (req: MoleculeRequest) => {
+ *     const id = req.params.id
+ *     return await del({ id })
+ *   }
+ * }
+ * ```
+ * @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 delete the row from.
+ * @returns A curried async function that accepts `{ id }` and returns a `{ statusCode, body }` response.
+ */
+export const del = ({ name, tableName, }) => async ({ id, }) => {
+    try {
+        // Delete the resource from the database via the bonded DataStore.
+        const result = await deleteById(tableName, id);
+        if (!result || !result.affected) {
+            return {
+                statusCode: 404,
+                body: {
+                    error: t('resource.error.notFound', undefined, { defaultValue: 'Not found.' }),
+                    errorKey: 'resource.error.notFound',
+                },
+            };
+        }
+        // If we made it here, updates to the database were successful.
+        return { statusCode: 200, body: { props: { id } } };
+    }
+    catch (error) {
+        logger.error(error);
+        return {
+            statusCode: error.statusCode || 400,
+            body: {
+                error: t('resource.error.unableToDelete', { name }, { defaultValue: `Unable to delete ${name}.` }),
+                errorKey: 'resource.error.unableToDelete',
+            },
+        };
+    }
+};
+//# sourceMappingURL=del.js.map

package/dist/del.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"del.js","sourceRoot":"","sources":["../src/del.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,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;AAItC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,GAAG,GACd,CAGE,EACA,IAAI,EACJ,SAAS,GACO,EAAE,EAAE,CACtB,KAAK,EAAE,EACL,EAAE,GAMH,EAAE,EAAE;IACH,IAAI,CAAC;QACH,kEAAkE;QAClE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;QAE9C,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAChC,OAAO;gBACL,UAAU,EAAE,GAAG;gBACf,IAAI,EAAE;oBACJ,KAAK,EAAE,CAAC,CAAC,yBAAyB,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;oBAC9E,QAAQ,EAAE,yBAAyB;iBACpC;aACF,CAAA;QACH,CAAC;QAED,+DAA+D;QAC/D,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAA;IACrD,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/http-types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Framework-agnostic HTTP types for molecule.dev resource handlers.
+ *
+ * These are structural subtypes of Express types — Express objects satisfy them
+ * without adapters. Allows resource handlers to be used with any HTTP framework
+ * (Express, Fastify, Hono, etc.) by depending on these interfaces instead of Express directly.
+ *
+ * @module
+ */
+/**
+ * Framework-agnostic HTTP request interface. Structurally compatible with Express's
+ * `Request` — Express objects satisfy this interface without adapters, but the type
+ * doesn't depend on Express, allowing use with Fastify, Hono, or Lambda.
+ */
+export interface MoleculeRequest {
+    body: any;
+    params: Record<string, string>;
+    query: Record<string, any>;
+    headers: Record<string, string | string[] | undefined>;
+    cookies?: Record<string, string>;
+    /**
+     * Client IP address. Populated by Express (honoring `trust proxy`) and other
+     * frameworks; optional because it isn't guaranteed in every adapter. Used for
+     * IP-keyed rate limiting on auth endpoints.
+     */
+    ip?: string;
+    on?(event: string, listener: (...args: unknown[]) => void): void;
+}
+/**
+ * Framework-agnostic HTTP response interface. Structurally compatible with Express's
+ * `Response` — includes `status()`, `json()`, `send()`, `set()`, cookie methods,
+ * streaming (`write`), and `locals` for per-request data sharing.
+ */
+export interface MoleculeResponse {
+    status(code: number): this;
+    json(body: unknown): void;
+    send(body: unknown): void;
+    end(): void;
+    set(headers: Record<string, string>): void;
+    setHeader(name: string, value: string): void;
+    cookie(name: string, value: string, options?: Record<string, unknown>): void;
+    write(chunk: string | Buffer): boolean;
+    flushHeaders?(): void;
+    locals: Record<string, any>;
+}
+/**
+ * Framework-agnostic next function. Call with no arguments to pass to the next
+ * middleware, or with an error to trigger error-handling middleware.
+ *
+ * @param err - Optional error to forward to error-handling middleware.
+ */
+export type MoleculeNextFunction = (err?: unknown) => void;
+/**
+ * Framework-agnostic middleware function signature matching Express's
+ * `(req, res, next) => void` pattern.
+ */
+export type MoleculeRequestHandler = (req: MoleculeRequest, res: MoleculeResponse, next: MoleculeNextFunction) => void | Promise<void>;
+//# sourceMappingURL=http-types.d.ts.map

package/dist/http-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-types.d.ts","sourceRoot":"","sources":["../src/http-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,GAAG,CAAA;IACT,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAA;CACjE;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IACzB,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IACzB,GAAG,IAAI,IAAI,CAAA;IACX,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IAC1C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC5E,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IACtC,YAAY,CAAC,IAAI,IAAI,CAAA;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC5B;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;AAE1D;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACnC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,oBAAoB,KACvB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA"}

package/dist/http-types.js

@@ -0,0 +1,11 @@
+/**
+ * Framework-agnostic HTTP types for molecule.dev resource handlers.
+ *
+ * These are structural subtypes of Express types — Express objects satisfy them
+ * without adapters. Allows resource handlers to be used with any HTTP framework
+ * (Express, Fastify, Hono, etc.) by depending on these interfaces instead of Express directly.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=http-types.js.map

package/dist/http-types.js.map

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

package/dist/i18n.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Locale registration for the resource package.
+ *
+ * @module
+ */
+/**
+ * Sentinel value confirming that locale translations for the resource package
+ * have been registered (or attempted). Always `true` after this module loads.
+ */
+export declare const i18nRegistered = true;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH;;;GAGG;AACH,eAAO,MAAM,cAAc,OAAO,CAAA"}

package/dist/i18n.js

@@ -0,0 +1,19 @@
+/**
+ * Locale registration for the resource package.
+ *
+ * @module
+ */
+import { registerLocaleModule } from '@molecule/api-i18n';
+try {
+    const locales = await import('@molecule/api-locales-resource');
+    registerLocaleModule(locales);
+}
+catch (_error) {
+    // Locale package not available (not built or not installed).
+}
+/**
+ * Sentinel value confirming that locale translations for the resource package
+ * have been registered (or attempted). Always `true` after this module loads.
+ */
+export const i18nRegistered = true;
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAEzD,IAAI,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAA;IAC9D,oBAAoB,CAAC,OAAO,CAAC,CAAA;AAC/B,CAAC;AAAC,OAAO,MAAM,EAAE,CAAC;IAChB,6DAA6D;AAC/D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAA"}