@molecule/api-resource-article 1.2.2 → 1.2.4

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-10T00:54:38.649Z
6
+ Generated: 2026-11-12T17:31:34.825Z
7
7
  -->
8
8
 
9
9
  # @molecule/api-resource-article
@@ -30,6 +30,11 @@ and `tags` in the package.
30
30
  can batch-load author profiles, omit fields from list items, rename pagination
31
31
  keys, wrap results, or translate error statuses and bodies. It receives errors
32
32
  and empty deletes too. Set the authenticated user on `res.locals.session.userId`.
33
+ For profile projection, pass the page's `authorId`s once to
34
+ `getPublicProfiles(ids)` from `@molecule/api-resource-user` and
35
+ `getFollowedIds(viewerId, 'user', ids)` from `@molecule/api-resource-follow`.
36
+ Join those maps while projecting the page. This keeps the page at two relationship
37
+ queries even when many entries share an author; per-entry lookups repeat the same work.
33
38
 
34
39
  ```typescript
35
40
  import { createArticleHandlers } from '@molecule/api-resource-article'
@@ -748,6 +753,9 @@ Peer dependencies:
748
753
  call `allTags()` for that endpoint, and pass a `limit` only where the caller
749
754
  asked for the N most-used. The package's own `GET /articles/tags` route does
750
755
  exactly this: no `?limit=` is the whole list.
756
+ Catalog counts scan bounded pages through the bonded database; a provider's
757
+ single-read safety cap never truncates the catalog or its popularity counts.
758
+
751
759
  - **Lists are newest first and paginated** — `{ data, total, limit, offset }`,
752
760
  at most 100 per page. `createArticle` stamps `createdAt` strictly increasing
753
761
  and `updateArticle` always moves `updatedAt` forward, so newest-first order
package/dist/index.d.ts CHANGED
@@ -21,6 +21,11 @@
21
21
  * can batch-load author profiles, omit fields from list items, rename pagination
22
22
  * keys, wrap results, or translate error statuses and bodies. It receives errors
23
23
  * and empty deletes too. Set the authenticated user on `res.locals.session.userId`.
24
+ * For profile projection, pass the page's `authorId`s once to
25
+ * `getPublicProfiles(ids)` from `@molecule/api-resource-user` and
26
+ * `getFollowedIds(viewerId, 'user', ids)` from `@molecule/api-resource-follow`.
27
+ * Join those maps while projecting the page. This keeps the page at two relationship
28
+ * queries even when many entries share an author; per-entry lookups repeat the same work.
24
29
  *
25
30
  * ```typescript
26
31
  * import { createArticleHandlers } from '@molecule/api-resource-article'
@@ -133,6 +138,9 @@
133
138
  * call `allTags()` for that endpoint, and pass a `limit` only where the caller
134
139
  * asked for the N most-used. The package's own `GET /articles/tags` route does
135
140
  * exactly this: no `?limit=` is the whole list.
141
+ * Catalog counts scan bounded pages through the bonded database; a provider's
142
+ * single-read safety cap never truncates the catalog or its popularity counts.
143
+ *
136
144
  * - **Lists are newest first and paginated** — `{ data, total, limit, offset }`,
137
145
  * at most 100 per page. `createArticle` stamps `createdAt` strictly increasing
138
146
  * and `updateArticle` always moves `updatedAt` forward, so newest-first order
@@ -1 +1 @@
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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+KG;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
@@ -21,6 +21,11 @@
21
21
  * can batch-load author profiles, omit fields from list items, rename pagination
22
22
  * keys, wrap results, or translate error statuses and bodies. It receives errors
23
23
  * and empty deletes too. Set the authenticated user on `res.locals.session.userId`.
24
+ * For profile projection, pass the page's `authorId`s once to
25
+ * `getPublicProfiles(ids)` from `@molecule/api-resource-user` and
26
+ * `getFollowedIds(viewerId, 'user', ids)` from `@molecule/api-resource-follow`.
27
+ * Join those maps while projecting the page. This keeps the page at two relationship
28
+ * queries even when many entries share an author; per-entry lookups repeat the same work.
24
29
  *
25
30
  * ```typescript
26
31
  * import { createArticleHandlers } from '@molecule/api-resource-article'
@@ -133,6 +138,9 @@
133
138
  * call `allTags()` for that endpoint, and pass a `limit` only where the caller
134
139
  * asked for the N most-used. The package's own `GET /articles/tags` route does
135
140
  * exactly this: no `?limit=` is the whole list.
141
+ * Catalog counts scan bounded pages through the bonded database; a provider's
142
+ * single-read safety cap never truncates the catalog or its popularity counts.
143
+ *
136
144
  * - **Lists are newest first and paginated** — `{ data, total, limit, offset }`,
137
145
  * at most 100 per page. `createArticle` stamps `createdAt` strictly increasing
138
146
  * and `updateArticle` always moves `updatedAt` forward, so newest-first order
package/dist/service.js CHANGED
@@ -404,14 +404,23 @@ export async function popularTags(limit = 20) {
404
404
  * @returns Every tag in use.
405
405
  */
406
406
  const countTagRows = async () => {
407
- const rows = await findMany(ARTICLE_TAGS, {
408
- orderBy: TAGS_IN_ARTICLE_ORDER,
409
- select: ['tag'],
410
- limit: 50_000,
411
- });
412
407
  const counts = new Map();
413
- for (const r of rows)
414
- counts.set(r.tag, (counts.get(r.tag) ?? 0) + 1);
408
+ // DataStore providers cap a single read. Count every page in a total order, so
409
+ // the complete catalog and leaderboard counts never silently become a prefix.
410
+ const pageSize = 1_000;
411
+ for (let offset = 0;;) {
412
+ const rows = await findMany(ARTICLE_TAGS, {
413
+ orderBy: [{ field: 'id', direction: 'asc' }],
414
+ select: ['tag'],
415
+ limit: pageSize,
416
+ offset,
417
+ });
418
+ for (const row of rows)
419
+ counts.set(row.tag, (counts.get(row.tag) ?? 0) + 1);
420
+ if (rows.length < pageSize)
421
+ break;
422
+ offset += rows.length;
423
+ }
415
424
  return [...counts.entries()]
416
425
  .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
417
426
  .map(([tag, n]) => ({ tag, count: n }));
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@molecule/api-resource-article",
3
- "version": "1.2.2",
3
+ "version": "1.2.4",
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",
@@ -35,7 +35,7 @@
35
35
  "devDependencies": {
36
36
  "@molecule/api-database": "1.2.2",
37
37
  "@molecule/api-database-sqlite": "1.4.3",
38
- "@molecule/api-resource-follow": "1.0.11",
38
+ "@molecule/api-resource-follow": "1.1.0",
39
39
  "@molecule/api-resource-reaction": "1.0.7",
40
40
  "@molecule/api-slug": "1.0.3",
41
41
  "@types/express": "5.0.6",