app/lib/search/visibility.mjs

Functions

Imports

It imports no other module of this repo. Imported by app/db/client.ts, app/db/dictionary.ts, app/db/pages.ts, app/db/posts.ts, app/db/procedures.ts, app/db/publications.ts, app/lib/content/corpus.mjs, app/lib/editor/post-rows.server.ts, app/lib/search/ask.server.ts, app/lib/search/records.mjs, app/lib/search/search.server.ts.

Source

1// Ask has no per-item status, so it must filter at UPLOAD time and composes this rather than restating
2// the rule. The FTS build includes drafts on purpose; classic search filters at query time.
3
4/** One spelling: a typo in a status literal fails OPEN on a filter. */
5export const PUBLISHED_STATUS = "published";
6
7/**
8 * @param {boolean | undefined} draft
9 * @returns {string}
10 */
11export function statusForDraft(draft) {
12  return draft === true ? "draft" : PUBLISHED_STATUS;
13}
14
15/**
16 * A missing publishAt means publish immediately, not never. An unparseable one is NOT visible: fail
17 * closed, since the other way a draft answers a public question on Ask.
18 *
19 * @param {{ status?: string, publishAt?: string | Date | number | null }} post
20 * @param {number} nowMs
21 * @returns {boolean}
22 */
23export function isPubliclyVisible(post, nowMs = Date.now()) {
24  if (post.status !== PUBLISHED_STATUS) return false;
25
26  const at = post.publishAt;
27  if (at === null || at === undefined || at === "") return true;
28
29  const when = at instanceof Date ? at.getTime() : typeof at === "number" ? at : Date.parse(at);
30  if (Number.isNaN(when)) return false;
31
32  return when <= nowMs;
33}