@molecule/api-resource-meeting 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,18 @@
+/**
+ * Browser guard — `@molecule/api-resource-meeting` 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-meeting 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 {};

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * `@molecule/api-resource-meeting` — meeting CRUD + action items.
+ *
+ * Tracks scheduled/in_progress/completed/cancelled meetings with
+ * attendees, optional recording URL, transcript, and AI-friendly
+ * summary slot. Action items nest under meetings and track
+ * completion + assignee + due date + source excerpt.
+ *
+ * Extracted from the ai-meeting-notes flagship.
+ *
+ * @example
+ * ```ts
+ * import { createMeetingRouter } from '@molecule/api-resource-meeting'
+ * app.use('/meetings', createMeetingRouter())
+ * // GET|POST / · GET|PUT|DELETE /:id
+ * // GET|POST /:id/action-items · PUT|DELETE /:id/action-items/:itemId
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { createActionItem, createMeetingForOwner } from '@molecule/api-resource-meeting'
+ *
+ * const meeting = await createMeetingForOwner(userId, {
+ *   title: 'Sprint planning',
+ *   scheduled_at: '2026-08-01T10:00:00Z',
+ * })
+ * await createActionItem(meeting.id, userId, { description: 'Send recap' })
+ * ```
+ *
+ * @remarks
+ * Tables: `src/__setup__/meetings.sql` creates `meetings` +
+ * `meeting_action_items`. An mlcl-scaffolded API replays `__setup__/*.sql`
+ * automatically on migrate; anywhere else run it once — nothing at runtime
+ * creates them.
+ *
+ * The router does not authenticate — it reads the caller from
+ * `res.locals.session` (populated by your global auth middleware) and 401s
+ * without a session. All service functions are owner-scoped
+ * (`…ForOwner(…, ownerId)` / `(meetingId, ownerId, …)`) and return `null`
+ * for rows the caller doesn't own — always pass the AUTHENTICATED user's id.
+ *
+ * @module
+ */
+export * from './browser-guard.js';
+export * from './routes.js';
+export * from './service.js';
+export * from './types.js';
+export * from './validation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,48 @@
+/**
+ * `@molecule/api-resource-meeting` — meeting CRUD + action items.
+ *
+ * Tracks scheduled/in_progress/completed/cancelled meetings with
+ * attendees, optional recording URL, transcript, and AI-friendly
+ * summary slot. Action items nest under meetings and track
+ * completion + assignee + due date + source excerpt.
+ *
+ * Extracted from the ai-meeting-notes flagship.
+ *
+ * @example
+ * ```ts
+ * import { createMeetingRouter } from '@molecule/api-resource-meeting'
+ * app.use('/meetings', createMeetingRouter())
+ * // GET|POST / · GET|PUT|DELETE /:id
+ * // GET|POST /:id/action-items · PUT|DELETE /:id/action-items/:itemId
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { createActionItem, createMeetingForOwner } from '@molecule/api-resource-meeting'
+ *
+ * const meeting = await createMeetingForOwner(userId, {
+ *   title: 'Sprint planning',
+ *   scheduled_at: '2026-08-01T10:00:00Z',
+ * })
+ * await createActionItem(meeting.id, userId, { description: 'Send recap' })
+ * ```
+ *
+ * @remarks
+ * Tables: `src/__setup__/meetings.sql` creates `meetings` +
+ * `meeting_action_items`. An mlcl-scaffolded API replays `__setup__/*.sql`
+ * automatically on migrate; anywhere else run it once — nothing at runtime
+ * creates them.
+ *
+ * The router does not authenticate — it reads the caller from
+ * `res.locals.session` (populated by your global auth middleware) and 401s
+ * without a session. All service functions are owner-scoped
+ * (`…ForOwner(…, ownerId)` / `(meetingId, ownerId, …)`) and return `null`
+ * for rows the caller doesn't own — always pass the AUTHENTICATED user's id.
+ *
+ * @module
+ */
+export * from './browser-guard.js';
+export * from './routes.js';
+export * from './service.js';
+export * from './types.js';
+export * from './validation.js';

package/dist/routes.d.ts

@@ -0,0 +1,4 @@
+import { Router } from 'express';
+/** Creates and returns an Express Router with all meeting and action-item CRUD routes. */
+export declare function createMeetingRouter(): Router;
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoD,MAAM,EAAE,MAAM,SAAS,CAAA;AA2BlF,0FAA0F;AAC1F,wBAAgB,mBAAmB,IAAI,MAAM,CA8I5C"}

package/dist/routes.js

@@ -0,0 +1,125 @@
+import { Router } from 'express';
+import { getParamId, requireUser } from '@molecule/api-bonds-default-express';
+import { t } from '@molecule/api-i18n';
+import { validateBody as validateBodyRaw } from '@molecule/api-middleware-validation';
+import { createActionItem, createMeetingForOwner, deleteActionItem, deleteMeetingForOwner, getMeetingForOwner, listActionItems, listMeetingsForOwner, updateActionItem, updateMeetingForOwner, } from './service.js';
+import { actionItemCreateSchema, actionItemUpdateSchema, meetingCreateSchema, meetingUpdateSchema, } from './validation.js';
+const validateBody = validateBodyRaw;
+/** Creates and returns an Express Router with all meeting and action-item CRUD routes. */
+export function createMeetingRouter() {
+    const router = Router();
+    router.get('/', async (req, res) => {
+        const userId = requireUser(res);
+        if (!userId)
+            return;
+        const q = req.query;
+        res.json(await listMeetingsForOwner(userId, {
+            status: typeof q.status === 'string'
+                ? q.status
+                : undefined,
+            page: typeof q.page === 'string' ? Number(q.page) : undefined,
+            limit: typeof q.limit === 'string' ? Number(q.limit) : undefined,
+        }));
+    });
+    router.post('/', validateBody(meetingCreateSchema), async (req, res) => {
+        const userId = requireUser(res);
+        if (!userId)
+            return;
+        res
+            .status(201)
+            .json(await createMeetingForOwner(userId, req.body));
+    });
+    router.get('/:id', async (req, res) => {
+        const userId = requireUser(res);
+        if (!userId)
+            return;
+        const m = await getMeetingForOwner(getParamId(req), userId);
+        if (!m) {
+            res
+                .status(404)
+                .json({ error: t('meeting.notFound', undefined, { defaultValue: 'Meeting not found' }) });
+            return;
+        }
+        res.json(m);
+    });
+    router.put('/:id', validateBody(meetingUpdateSchema), async (req, res) => {
+        const userId = requireUser(res);
+        if (!userId)
+            return;
+        const m = await updateMeetingForOwner(getParamId(req), userId, req.body);
+        if (!m) {
+            res
+                .status(404)
+                .json({ error: t('meeting.notFound', undefined, { defaultValue: 'Meeting not found' }) });
+            return;
+        }
+        res.json(m);
+    });
+    router.delete('/:id', async (req, res) => {
+        const userId = requireUser(res);
+        if (!userId)
+            return;
+        const ok = await deleteMeetingForOwner(getParamId(req), userId);
+        if (!ok) {
+            res
+                .status(404)
+                .json({ error: t('meeting.notFound', undefined, { defaultValue: 'Meeting not found' }) });
+            return;
+        }
+        res.status(204).end();
+    });
+    // Action items
+    router.get('/:id/action-items', async (req, res) => {
+        const userId = requireUser(res);
+        if (!userId)
+            return;
+        const items = await listActionItems(getParamId(req), userId);
+        if (items === null) {
+            res
+                .status(404)
+                .json({ error: t('meeting.notFound', undefined, { defaultValue: 'Meeting not found' }) });
+            return;
+        }
+        res.json(items);
+    });
+    router.post('/:id/action-items', validateBody(actionItemCreateSchema), async (req, res) => {
+        const userId = requireUser(res);
+        if (!userId)
+            return;
+        const item = await createActionItem(getParamId(req), userId, req.body);
+        if (!item) {
+            res
+                .status(404)
+                .json({ error: t('meeting.notFound', undefined, { defaultValue: 'Meeting not found' }) });
+            return;
+        }
+        res.status(201).json(item);
+    });
+    router.put('/:id/action-items/:itemId', validateBody(actionItemUpdateSchema), async (req, res) => {
+        const userId = requireUser(res);
+        if (!userId)
+            return;
+        const item = await updateActionItem(getParamId(req, 'itemId'), getParamId(req), userId, req.body);
+        if (!item) {
+            res.status(404).json({
+                error: t('actionItem.notFound', undefined, { defaultValue: 'Action item not found' }),
+            });
+            return;
+        }
+        res.json(item);
+    });
+    router.delete('/:id/action-items/:itemId', async (req, res) => {
+        const userId = requireUser(res);
+        if (!userId)
+            return;
+        const ok = await deleteActionItem(getParamId(req, 'itemId'), getParamId(req), userId);
+        if (!ok) {
+            res.status(404).json({
+                error: t('actionItem.notFound', undefined, { defaultValue: 'Action item not found' }),
+            });
+            return;
+        }
+        res.status(204).end();
+    });
+    return router;
+}

package/dist/service.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Meeting service — meetings + action items, with optional AI-assisted
+ * summarization/extraction.
+ *
+ * @module
+ */
+import type { ActionItemRow, MeetingRow, MeetingStatus } from './types.js';
+/** Returns a paginated list of meetings belonging to the given owner, optionally filtered by status. */
+export declare function listMeetingsForOwner(ownerId: string, opts?: {
+    status?: MeetingStatus;
+    page?: number;
+    limit?: number;
+}): Promise<{
+    data: MeetingRow[];
+    total: number;
+}>;
+/** Fetches a single meeting by ID, returning null if it does not exist or does not belong to the owner. */
+export declare function getMeetingForOwner(meetingId: string, ownerId: string): Promise<MeetingRow | null>;
+/** Creates a new meeting record owned by the given owner and returns the inserted row. */
+export declare function createMeetingForOwner(ownerId: string, data: {
+    title: string;
+    description?: string | null;
+    scheduled_at?: string | null;
+    attendees?: Array<{
+        name: string;
+        email?: string;
+    }>;
+}): Promise<MeetingRow>;
+/** Applies a partial patch to a meeting, recomputing duration_seconds when both timestamps are present, and returns the updated row or null if not found/owned. */
+export declare function updateMeetingForOwner(meetingId: string, ownerId: string, patch: Partial<MeetingRow>): Promise<MeetingRow | null>;
+/** Deletes a meeting by ID if it belongs to the given owner; returns true on success, false if not found or not owned. */
+export declare function deleteMeetingForOwner(meetingId: string, ownerId: string): Promise<boolean>;
+/** Returns all action items for a meeting in creation order, or null if the meeting is not found/owned. */
+export declare function listActionItems(meetingId: string, ownerId: string): Promise<ActionItemRow[] | null>;
+/** Creates a new action item under a meeting owned by the given owner; returns the inserted row or null if the meeting is not found/owned. */
+export declare function createActionItem(meetingId: string, ownerId: string, data: {
+    description: string;
+    assignee?: string | null;
+    due_date?: string | null;
+    source_excerpt?: string | null;
+}): Promise<ActionItemRow | null>;
+/** Applies a partial patch to an action item; returns the updated row or null if the meeting or item is not found/owned. */
+export declare function updateActionItem(itemId: string, meetingId: string, ownerId: string, patch: Partial<ActionItemRow>): Promise<ActionItemRow | null>;
+/** Deletes an action item by ID if its parent meeting belongs to the given owner; returns true on success, false if not found or not owned. */
+export declare function deleteActionItem(itemId: string, meetingId: string, ownerId: string): Promise<boolean>;
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAK1E,wGAAwG;AACxG,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IACJ,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACV,GACL,OAAO,CAAC;IAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAYhD;AAED,2GAA2G;AAC3G,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAI5B;AAED,0FAA0F;AAC1F,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IACJ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACpD,GACA,OAAO,CAAC,UAAU,CAAC,CAgBrB;AAED,mKAAmK;AACnK,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GACzB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAc5B;AAED,0HAA0H;AAC1H,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKhG;AAED,2GAA2G;AAC3G,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,CAOjC;AAED,8IAA8I;AAC9I,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IACJ,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,GACA,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAY/B;AAED,4HAA4H;AAC5H,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAC5B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAO/B;AAED,+IAA+I;AAC/I,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAOlB"}

package/dist/service.js

@@ -0,0 +1,121 @@
+/**
+ * Meeting service — meetings + action items, with optional AI-assisted
+ * summarization/extraction.
+ *
+ * @module
+ */
+import { count, create, deleteById, findById, findMany, updateById, } from '@molecule/api-database';
+const MEETINGS_TABLE = 'meetings';
+const ACTION_ITEMS_TABLE = 'meeting_action_items';
+/** Returns a paginated list of meetings belonging to the given owner, optionally filtered by status. */
+export async function listMeetingsForOwner(ownerId, opts = {}) {
+    const page = opts.page ?? 1;
+    const limit = opts.limit ?? 50;
+    const where = [{ field: 'owner_id', operator: '=', value: ownerId }];
+    if (opts.status)
+        where.push({ field: 'status', operator: '=', value: opts.status });
+    const orderBy = [{ field: 'scheduled_at', direction: 'desc' }];
+    const offset = (page - 1) * limit;
+    const [data, total] = await Promise.all([
+        findMany(MEETINGS_TABLE, { where, orderBy, limit, offset }),
+        count(MEETINGS_TABLE, where),
+    ]);
+    return { data, total };
+}
+/** Fetches a single meeting by ID, returning null if it does not exist or does not belong to the owner. */
+export async function getMeetingForOwner(meetingId, ownerId) {
+    const row = await findById(MEETINGS_TABLE, meetingId);
+    if (!row || row.owner_id !== ownerId)
+        return null;
+    return row;
+}
+/** Creates a new meeting record owned by the given owner and returns the inserted row. */
+export async function createMeetingForOwner(ownerId, data) {
+    const result = await create(MEETINGS_TABLE, {
+        owner_id: ownerId,
+        title: data.title,
+        description: data.description ?? null,
+        status: data.scheduled_at ? 'scheduled' : 'completed',
+        scheduled_at: data.scheduled_at ?? null,
+        started_at: null,
+        ended_at: null,
+        duration_seconds: 0,
+        recording_url: null,
+        transcript: null,
+        summary: null,
+        attendees: data.attendees ?? [],
+    });
+    return result.data;
+}
+/** Applies a partial patch to a meeting, recomputing duration_seconds when both timestamps are present, and returns the updated row or null if not found/owned. */
+export async function updateMeetingForOwner(meetingId, ownerId, patch) {
+    const existing = await findById(MEETINGS_TABLE, meetingId);
+    if (!existing || existing.owner_id !== ownerId)
+        return null;
+    const updates = { ...patch };
+    // Compute duration if both timestamps now set
+    if ((patch.started_at || existing.started_at) && (patch.ended_at || existing.ended_at)) {
+        const startedAt = new Date(String(patch.started_at ?? existing.started_at)).getTime();
+        const endedAt = new Date(String(patch.ended_at ?? existing.ended_at)).getTime();
+        if (Number.isFinite(startedAt) && Number.isFinite(endedAt) && endedAt > startedAt) {
+            updates.duration_seconds = Math.round((endedAt - startedAt) / 1000);
+        }
+    }
+    await updateById(MEETINGS_TABLE, meetingId, updates);
+    return findById(MEETINGS_TABLE, meetingId);
+}
+/** Deletes a meeting by ID if it belongs to the given owner; returns true on success, false if not found or not owned. */
+export async function deleteMeetingForOwner(meetingId, ownerId) {
+    const row = await findById(MEETINGS_TABLE, meetingId);
+    if (!row || row.owner_id !== ownerId)
+        return false;
+    await deleteById(MEETINGS_TABLE, meetingId);
+    return true;
+}
+/** Returns all action items for a meeting in creation order, or null if the meeting is not found/owned. */
+export async function listActionItems(meetingId, ownerId) {
+    const meeting = await getMeetingForOwner(meetingId, ownerId);
+    if (!meeting)
+        return null;
+    return findMany(ACTION_ITEMS_TABLE, {
+        where: [{ field: 'meeting_id', operator: '=', value: meetingId }],
+        orderBy: [{ field: 'created_at', direction: 'asc' }],
+    });
+}
+/** Creates a new action item under a meeting owned by the given owner; returns the inserted row or null if the meeting is not found/owned. */
+export async function createActionItem(meetingId, ownerId, data) {
+    const meeting = await getMeetingForOwner(meetingId, ownerId);
+    if (!meeting)
+        return null;
+    const result = await create(ACTION_ITEMS_TABLE, {
+        meeting_id: meetingId,
+        description: data.description,
+        assignee: data.assignee ?? null,
+        due_date: data.due_date ?? null,
+        is_completed: false,
+        source_excerpt: data.source_excerpt ?? null,
+    });
+    return result.data;
+}
+/** Applies a partial patch to an action item; returns the updated row or null if the meeting or item is not found/owned. */
+export async function updateActionItem(itemId, meetingId, ownerId, patch) {
+    const meeting = await getMeetingForOwner(meetingId, ownerId);
+    if (!meeting)
+        return null;
+    const existing = await findById(ACTION_ITEMS_TABLE, itemId);
+    if (!existing || existing.meeting_id !== meetingId)
+        return null;
+    await updateById(ACTION_ITEMS_TABLE, itemId, patch);
+    return findById(ACTION_ITEMS_TABLE, itemId);
+}
+/** Deletes an action item by ID if its parent meeting belongs to the given owner; returns true on success, false if not found or not owned. */
+export async function deleteActionItem(itemId, meetingId, ownerId) {
+    const meeting = await getMeetingForOwner(meetingId, ownerId);
+    if (!meeting)
+        return false;
+    const item = await findById(ACTION_ITEMS_TABLE, itemId);
+    if (!item || item.meeting_id !== meetingId)
+        return false;
+    await deleteById(ACTION_ITEMS_TABLE, itemId);
+    return true;
+}

package/dist/types.d.ts

@@ -0,0 +1,36 @@
+/** Lifecycle states a meeting can occupy from creation through completion. */
+export type MeetingStatus = 'scheduled' | 'in_progress' | 'completed' | 'cancelled';
+/** Raw database row shape for a meeting record. */
+export interface MeetingRow {
+    id: string;
+    owner_id: string;
+    title: string;
+    description: string | null;
+    status: MeetingStatus;
+    scheduled_at: string | Date | null;
+    started_at: string | Date | null;
+    ended_at: string | Date | null;
+    duration_seconds: number;
+    recording_url: string | null;
+    transcript: string | null;
+    summary: string | null;
+    attendees: Array<{
+        name: string;
+        email?: string;
+    }>;
+    created_at: string | Date;
+    updated_at: string | Date;
+}
+/** Raw database row shape for an action item linked to a meeting. */
+export interface ActionItemRow {
+    id: string;
+    meeting_id: string;
+    description: string;
+    assignee: string | null;
+    due_date: string | Date | null;
+    is_completed: boolean;
+    source_excerpt: string | null;
+    created_at: string | Date;
+    updated_at: string | Date;
+}
+//# 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,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,CAAA;AAEnF,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,EAAE,aAAa,CAAA;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAClC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAC9B,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAC9B,YAAY,EAAE,OAAO,CAAA;IACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/validation.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+/** All valid status values a meeting can be in. */
+export declare const MEETING_STATUSES: readonly ["scheduled", "in_progress", "completed", "cancelled"];
+/** Zod schema for validating meeting creation payloads. */
+export declare const meetingCreateSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    scheduled_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    attendees: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/** Zod schema for validating meeting update payloads. */
+export declare const meetingUpdateSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        scheduled: "scheduled";
+        in_progress: "in_progress";
+        completed: "completed";
+        cancelled: "cancelled";
+    }>>;
+    scheduled_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    started_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ended_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    recording_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    transcript: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    attendees: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/** Zod schema for validating action item creation payloads. */
+export declare const actionItemCreateSchema: z.ZodObject<{
+    description: z.ZodString;
+    assignee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    due_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    source_excerpt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/** Zod schema for validating action item update payloads. */
+export declare const actionItemUpdateSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    assignee: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    due_date: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    source_excerpt: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    is_completed: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,iEAAkE,CAAA;AAE/F,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB;;;;;;;;iBAO9B,CAAA;AAEF,yDAAyD;AACzD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;iBAa9B,CAAA;AAEF,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAA;AAEF,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB;;;;;;iBAEjC,CAAA"}

package/dist/validation.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+/** All valid status values a meeting can be in. */
+export const MEETING_STATUSES = ['scheduled', 'in_progress', 'completed', 'cancelled'];
+/** Zod schema for validating meeting creation payloads. */
+export const meetingCreateSchema = z.object({
+    title: z.string().min(1).max(255),
+    description: z.string().max(2000).nullable().optional(),
+    scheduled_at: z.string().nullable().optional(),
+    attendees: z
+        .array(z.object({ name: z.string().min(1), email: z.string().email().optional() }))
+        .optional(),
+});
+/** Zod schema for validating meeting update payloads. */
+export const meetingUpdateSchema = z.object({
+    title: z.string().min(1).max(255).optional(),
+    description: z.string().max(2000).nullable().optional(),
+    status: z.enum(MEETING_STATUSES).optional(),
+    scheduled_at: z.string().nullable().optional(),
+    started_at: z.string().nullable().optional(),
+    ended_at: z.string().nullable().optional(),
+    recording_url: z.string().url().nullable().optional(),
+    transcript: z.string().nullable().optional(),
+    summary: z.string().nullable().optional(),
+    attendees: z
+        .array(z.object({ name: z.string().min(1), email: z.string().email().optional() }))
+        .optional(),
+});
+/** Zod schema for validating action item creation payloads. */
+export const actionItemCreateSchema = z.object({
+    description: z.string().min(1).max(2000),
+    assignee: z.string().nullable().optional(),
+    due_date: z.string().nullable().optional(),
+    source_excerpt: z.string().nullable().optional(),
+});
+/** Zod schema for validating action item update payloads. */
+export const actionItemUpdateSchema = actionItemCreateSchema.partial().extend({
+    is_completed: z.boolean().optional(),
+});

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@molecule/api-resource-meeting",
+  "version": "1.0.0",
+  "description": "Meeting capture + transcription + action-item extraction",
+  "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"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "molecule",
+    "meeting",
+    "transcription",
+    "notes",
+    "resource"
+  ],
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/express": "5.0.6",
+    "@types/node": "26.1.2",
+    "express": "5.2.1",
+    "typescript": "6.0.3",
+    "vitest": "4.1.10",
+    "zod": "4.4.3"
+  },
+  "peerDependencies": {
+    "@molecule/api-bonds-default-express": "^1.0.0",
+    "@molecule/api-database": "^1.0.0",
+    "@molecule/api-i18n": "^1.0.0",
+    "@molecule/api-middleware-validation": "^1.0.0",
+    "express": "^5.0.0",
+    "zod": "^4.0.0"
+  }
+}