@molecule/api-resource-article 1.2.1 → 1.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
3
3
  Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
4
4
  Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
5
5
  To change this document, edit the module-level JSDoc in src/index.ts.
6
- Generated: 2026-11-07T08:32:12.976Z
6
+ Generated: 2026-11-10T00:54:38.649Z
7
7
  -->
8
8
 
9
9
  # @molecule/api-resource-article
@@ -48,6 +48,20 @@ create separate maps with separate options. The static `requestHandlerMap` keeps
48
48
  native flat-body/raw-article format. Use service functions for a different domain workflow.
49
49
  Read Quick Start for filter mapping and early responses.
50
50
 
51
+ **Need only a lookup in a custom route?** `findArticleRow(slug)` returns the stored
52
+ `ArticleRow` or `null`. `getArticleBySlug(slug, viewerId?)` returns an `Article` or
53
+ `null`, with ordered tags, favorite count and the viewer's `favorited` state.
54
+ Both read this package's `articles` table. Keep your route, author-profile lookup
55
+ and response projection local; call these functions instead of copying the slug query.
56
+
57
+ ```typescript
58
+ import { findArticleRow } from '@molecule/api-resource-article'
59
+
60
+ const slug = 'release-notes'
61
+ const row = await findArticleRow(slug)
62
+ // Map row (or null) into this API's response. Use getArticleBySlug for hydrated fields.
63
+ ```
64
+
51
65
  > **Auto-generated, AI-first package reference** for the [molecule.dev](https://molecule.dev) ecosystem.
52
66
  > It is written to be read by coding agents as much as by people, and is generated from this
53
67
  > package's source — edit `src/index.ts` JSDoc, not this file.
package/dist/index.d.ts CHANGED
@@ -38,6 +38,20 @@
38
38
  * native flat-body/raw-article format. Use service functions for a different domain workflow.
39
39
  * Read Quick Start for filter mapping and early responses.
40
40
  *
41
+ * **Need only a lookup in a custom route?** `findArticleRow(slug)` returns the stored
42
+ * `ArticleRow` or `null`. `getArticleBySlug(slug, viewerId?)` returns an `Article` or
43
+ * `null`, with ordered tags, favorite count and the viewer's `favorited` state.
44
+ * Both read this package's `articles` table. Keep your route, author-profile lookup
45
+ * and response projection local; call these functions instead of copying the slug query.
46
+ *
47
+ * ```typescript
48
+ * import { findArticleRow } from '@molecule/api-resource-article'
49
+ *
50
+ * const slug = 'release-notes'
51
+ * const row = await findArticleRow(slug)
52
+ * // Map row (or null) into this API's response. Use getArticleBySlug for hydrated fields.
53
+ * ```
54
+ *
41
55
  * @module
42
56
  * @example
43
57
  * ```typescript
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyJG;AAEH,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuKG;AAEH,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA"}
package/dist/index.js CHANGED
@@ -38,6 +38,20 @@
38
38
  * native flat-body/raw-article format. Use service functions for a different domain workflow.
39
39
  * Read Quick Start for filter mapping and early responses.
40
40
  *
41
+ * **Need only a lookup in a custom route?** `findArticleRow(slug)` returns the stored
42
+ * `ArticleRow` or `null`. `getArticleBySlug(slug, viewerId?)` returns an `Article` or
43
+ * `null`, with ordered tags, favorite count and the viewer's `favorited` state.
44
+ * Both read this package's `articles` table. Keep your route, author-profile lookup
45
+ * and response projection local; call these functions instead of copying the slug query.
46
+ *
47
+ * ```typescript
48
+ * import { findArticleRow } from '@molecule/api-resource-article'
49
+ *
50
+ * const slug = 'release-notes'
51
+ * const row = await findArticleRow(slug)
52
+ * // Map row (or null) into this API's response. Use getArticleBySlug for hydrated fields.
53
+ * ```
54
+ *
41
55
  * @module
42
56
  * @example
43
57
  * ```typescript
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@molecule/api-resource-article",
3
- "version": "1.2.1",
3
+ "version": "1.2.2",
4
4
  "description": "Articles and blog posts: unique slugs, tags, favorites, a followed-authors feed, and filtered, paginated lists",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",