hazo_blog 2.0.0 → 2.16.0

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.
Files changed (165) hide show
  1. package/CHANGE_LOG.md +867 -0
  2. package/README.md +1 -0
  3. package/db_setup_postgres.sql +652 -0
  4. package/db_setup_sqlite.sql +341 -0
  5. package/dist/index.d.ts +24 -0
  6. package/dist/index.d.ts.map +1 -1
  7. package/dist/index.js +24 -0
  8. package/dist/jobs/maintenance-jobs.d.ts +83 -0
  9. package/dist/jobs/maintenance-jobs.d.ts.map +1 -0
  10. package/dist/jobs/maintenance-jobs.js +123 -0
  11. package/dist/lib/domain-dns.d.ts +15 -0
  12. package/dist/lib/domain-dns.d.ts.map +1 -0
  13. package/dist/lib/domain-dns.js +27 -0
  14. package/dist/lib/domain-token.d.ts +23 -0
  15. package/dist/lib/domain-token.d.ts.map +1 -0
  16. package/dist/lib/domain-token.js +42 -0
  17. package/dist/lib/hook-bus.d.ts +165 -0
  18. package/dist/lib/hook-bus.d.ts.map +1 -0
  19. package/dist/lib/hook-bus.js +90 -0
  20. package/dist/lib/index.d.ts +8 -0
  21. package/dist/lib/index.d.ts.map +1 -1
  22. package/dist/lib/index.js +8 -0
  23. package/dist/lib/revisions.d.ts +10 -0
  24. package/dist/lib/revisions.d.ts.map +1 -0
  25. package/dist/lib/revisions.js +18 -0
  26. package/dist/lib/safe-url.d.ts +8 -0
  27. package/dist/lib/safe-url.d.ts.map +1 -0
  28. package/dist/lib/safe-url.js +32 -0
  29. package/dist/lib/sections.d.ts +59 -0
  30. package/dist/lib/sections.d.ts.map +1 -0
  31. package/dist/lib/sections.js +303 -0
  32. package/dist/lib/site-identity.d.ts +45 -0
  33. package/dist/lib/site-identity.d.ts.map +1 -0
  34. package/dist/lib/site-identity.js +116 -0
  35. package/dist/lib/status.d.ts +25 -0
  36. package/dist/lib/status.d.ts.map +1 -0
  37. package/dist/lib/status.js +58 -0
  38. package/dist/lib/theme-schema.d.ts +51 -0
  39. package/dist/lib/theme-schema.d.ts.map +1 -0
  40. package/dist/lib/theme-schema.js +112 -0
  41. package/dist/lib/theme-validate.d.ts +48 -0
  42. package/dist/lib/theme-validate.d.ts.map +1 -0
  43. package/dist/lib/theme-validate.js +149 -0
  44. package/dist/next/byline-routes.d.ts +67 -0
  45. package/dist/next/byline-routes.d.ts.map +1 -0
  46. package/dist/next/byline-routes.js +235 -0
  47. package/dist/next/domain-routes.d.ts +9 -0
  48. package/dist/next/domain-routes.d.ts.map +1 -0
  49. package/dist/next/domain-routes.js +39 -0
  50. package/dist/next/post-routes.d.ts +100 -0
  51. package/dist/next/post-routes.d.ts.map +1 -0
  52. package/dist/next/post-routes.js +291 -0
  53. package/dist/render/engine.d.ts +41 -0
  54. package/dist/render/engine.d.ts.map +1 -0
  55. package/dist/render/engine.js +91 -0
  56. package/dist/render/fallback-theme/templates/404.liquid +1 -0
  57. package/dist/render/fallback-theme/templates/default.liquid +1 -0
  58. package/dist/render/fallback-theme.d.ts +3 -0
  59. package/dist/render/fallback-theme.d.ts.map +1 -0
  60. package/dist/render/fallback-theme.js +34 -0
  61. package/dist/render/html.d.ts +10 -0
  62. package/dist/render/html.d.ts.map +1 -0
  63. package/dist/render/html.js +29 -0
  64. package/dist/render/index.d.ts +13 -0
  65. package/dist/render/index.d.ts.map +1 -0
  66. package/dist/render/index.js +23 -0
  67. package/dist/render/resolve.d.ts +23 -0
  68. package/dist/render/resolve.d.ts.map +1 -0
  69. package/dist/render/resolve.js +32 -0
  70. package/dist/render/tags/faq.d.ts +9 -0
  71. package/dist/render/tags/faq.d.ts.map +1 -0
  72. package/dist/render/tags/faq.js +31 -0
  73. package/dist/render/tags/image.d.ts +12 -0
  74. package/dist/render/tags/image.d.ts.map +1 -0
  75. package/dist/render/tags/image.js +56 -0
  76. package/dist/render/tags/index.d.ts +3 -0
  77. package/dist/render/tags/index.d.ts.map +1 -0
  78. package/dist/render/tags/index.js +16 -0
  79. package/dist/render/tags/menu.d.ts +11 -0
  80. package/dist/render/tags/menu.d.ts.map +1 -0
  81. package/dist/render/tags/menu.js +74 -0
  82. package/dist/render/tags/related-posts.d.ts +11 -0
  83. package/dist/render/tags/related-posts.d.ts.map +1 -0
  84. package/dist/render/tags/related-posts.js +34 -0
  85. package/dist/render/tags/section-list.d.ts +9 -0
  86. package/dist/render/tags/section-list.d.ts.map +1 -0
  87. package/dist/render/tags/section-list.js +71 -0
  88. package/dist/render/tags/seo-head.d.ts +16 -0
  89. package/dist/render/tags/seo-head.d.ts.map +1 -0
  90. package/dist/render/tags/seo-head.js +73 -0
  91. package/dist/render/tags/toc.d.ts +15 -0
  92. package/dist/render/tags/toc.d.ts.map +1 -0
  93. package/dist/render/tags/toc.js +72 -0
  94. package/dist/render/types.d.ts +167 -0
  95. package/dist/render/types.d.ts.map +1 -0
  96. package/dist/render/types.js +13 -0
  97. package/dist/repository/bylines.d.ts +56 -0
  98. package/dist/repository/bylines.d.ts.map +1 -0
  99. package/dist/repository/bylines.js +284 -0
  100. package/dist/repository/domains.d.ts +67 -0
  101. package/dist/repository/domains.d.ts.map +1 -0
  102. package/dist/repository/domains.js +173 -0
  103. package/dist/repository/media.d.ts +45 -0
  104. package/dist/repository/media.d.ts.map +1 -0
  105. package/dist/repository/media.js +248 -0
  106. package/dist/repository/menus.d.ts +58 -0
  107. package/dist/repository/menus.d.ts.map +1 -0
  108. package/dist/repository/menus.js +311 -0
  109. package/dist/repository/posts.d.ts +171 -0
  110. package/dist/repository/posts.d.ts.map +1 -0
  111. package/dist/repository/posts.js +791 -0
  112. package/dist/repository/site-files.d.ts +15 -0
  113. package/dist/repository/site-files.d.ts.map +1 -0
  114. package/dist/repository/site-files.js +73 -0
  115. package/dist/repository/tags.d.ts +51 -0
  116. package/dist/repository/tags.d.ts.map +1 -0
  117. package/dist/repository/tags.js +282 -0
  118. package/dist/repository/themes.d.ts +45 -0
  119. package/dist/repository/themes.d.ts.map +1 -0
  120. package/dist/repository/themes.js +285 -0
  121. package/dist/seo/hazo-seo-sitemap-source.d.ts +63 -0
  122. package/dist/seo/hazo-seo-sitemap-source.d.ts.map +1 -0
  123. package/dist/seo/hazo-seo-sitemap-source.js +85 -0
  124. package/dist/seo/index.d.ts +1 -0
  125. package/dist/seo/index.d.ts.map +1 -1
  126. package/dist/seo/index.js +6 -0
  127. package/dist/service/bylines.d.ts +21 -0
  128. package/dist/service/bylines.d.ts.map +1 -0
  129. package/dist/service/bylines.js +48 -0
  130. package/dist/service/cdn-hooks.d.ts +20 -0
  131. package/dist/service/cdn-hooks.d.ts.map +1 -0
  132. package/dist/service/cdn-hooks.js +38 -0
  133. package/dist/service/domains.d.ts +49 -0
  134. package/dist/service/domains.d.ts.map +1 -0
  135. package/dist/service/domains.js +98 -0
  136. package/dist/service/media.d.ts +79 -0
  137. package/dist/service/media.d.ts.map +1 -0
  138. package/dist/service/media.js +225 -0
  139. package/dist/service/menus.d.ts +43 -0
  140. package/dist/service/menus.d.ts.map +1 -0
  141. package/dist/service/menus.js +165 -0
  142. package/dist/service/posts.d.ts +70 -0
  143. package/dist/service/posts.d.ts.map +1 -0
  144. package/dist/service/posts.js +291 -0
  145. package/dist/service/seo-hooks.d.ts +18 -0
  146. package/dist/service/seo-hooks.d.ts.map +1 -0
  147. package/dist/service/seo-hooks.js +108 -0
  148. package/dist/service/site-files.d.ts +20 -0
  149. package/dist/service/site-files.d.ts.map +1 -0
  150. package/dist/service/site-files.js +71 -0
  151. package/dist/service/tags.d.ts +20 -0
  152. package/dist/service/tags.d.ts.map +1 -0
  153. package/dist/service/tags.js +41 -0
  154. package/dist/service/themes.d.ts +85 -0
  155. package/dist/service/themes.d.ts.map +1 -0
  156. package/dist/service/themes.js +416 -0
  157. package/dist/types/index.d.ts +953 -0
  158. package/dist/types/index.d.ts.map +1 -1
  159. package/dist/ui/content-status-badge.d.ts +7 -0
  160. package/dist/ui/content-status-badge.d.ts.map +1 -0
  161. package/dist/ui/content-status-badge.js +16 -0
  162. package/dist/ui/index.d.ts +1 -0
  163. package/dist/ui/index.d.ts.map +1 -1
  164. package/dist/ui/index.js +1 -0
  165. package/package.json +37 -26
@@ -10,7 +10,17 @@
10
10
  -- hazo_blog_categories — single category per post (v1.6; not yet wired to v2 posts)
11
11
  -- hazo_blog_tags — free-form tags (many-to-many with posts; v1.6, not yet wired to v2 posts)
12
12
  -- hazo_blog_post_tags — post↔tag join
13
+ -- hazo_blog_bylines — named author attribution for hazo_blog_posts (v2, Phase 1a issue 08)
14
+ -- hazo_blog_post_bylines — post↔byline join (ordered)
15
+ -- hazo_blog_media — processed/stored media assets (v2, Phase 1a issue 10)
16
+ -- hazo_blog_media_usage — which content field references a hazo_blog_media row
13
17
  -- hazo_blog_settings — package-owned display/behavior settings
18
+ -- hazo_blog_menus — named navigation menus (v2, Phase 1b issue 04)
19
+ -- hazo_blog_menu_items — menu entries, self-referencing for unlimited nesting
20
+ -- hazo_blog_themes — registered themes, built-in or per-site upload (Phase 1b issue 06)
21
+ -- hazo_blog_theme_versions — version history for a theme
22
+ -- hazo_blog_site_theme — the theme currently active for a site (one row per scope_id)
23
+ -- hazo_blog_site_files — versioned per-site files, e.g. custom CSS (Phase 1b issue 09)
14
24
  --
15
25
  -- Multi-tenancy: hazo_blog_posts/hazo_blog_revisions require a `scope_id`
16
26
  -- (NOT NULL, as of v2.0.0) — add-on/single-site mode stamps hazo_auth's
@@ -77,6 +87,12 @@ CREATE TABLE IF NOT EXISTS hazo_blog_posts (
77
87
  _rev INTEGER NOT NULL DEFAULT 1,
78
88
  live_revision_id TEXT,
79
89
  draft_revision_id TEXT,
90
+ -- Content lifecycle stage (Phase 1a issue 07): draft/in_review/queued/
91
+ -- scheduled/published/trashed. Defaults to 'draft'. Validated transitions
92
+ -- live in the app layer (src/lib/status.ts's isValidStatusTransition),
93
+ -- not a DB CHECK constraint — see db_setup_postgres.sql's comment on the
94
+ -- same column.
95
+ status TEXT NOT NULL DEFAULT 'draft',
80
96
  deleted_at TEXT,
81
97
  template TEXT,
82
98
  locale TEXT DEFAULT NULL, -- BCP-47 locale; NULL = default locale
@@ -86,6 +102,19 @@ CREATE TABLE IF NOT EXISTS hazo_blog_posts (
86
102
  og_image TEXT,
87
103
  noindex INTEGER NOT NULL DEFAULT 0, -- 0/1
88
104
  canonical_override TEXT,
105
+ -- Loose reference to hazo_blog_categories (Phase 1a issue 12) — "primary
106
+ -- category", singular. No FK (same convention as every other
107
+ -- optional/legacy cross-table reference in this package); see
108
+ -- Post.category_id's doc-comment (src/types/index.ts) for why this
109
+ -- deliberately reuses the SAME legacy table the v1.6 BlogPost.category_id
110
+ -- pointed at rather than a new v2 category system.
111
+ category_id TEXT,
112
+ -- Page-layout section list (ticket 05/Phase 1b issue 05) — JSON array of
113
+ -- `{type, version, key, settings, hidden}`, rendered in order by
114
+ -- `{% section_list %}`. See Post.sections_json's doc-comment
115
+ -- (src/types/index.ts) for why this lives on the post row, not a
116
+ -- revision.
117
+ sections_json TEXT NOT NULL DEFAULT '[]',
89
118
  created_at TEXT NOT NULL DEFAULT (datetime('now')),
90
119
  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
91
120
  published_at TEXT,
@@ -95,10 +124,14 @@ CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_posts_scope_slug_locale
95
124
  ON hazo_blog_posts (scope_id, slug, COALESCE(locale, ''));
96
125
  CREATE INDEX IF NOT EXISTS idx_hazo_blog_posts_scope_type
97
126
  ON hazo_blog_posts (scope_id, type);
127
+ CREATE INDEX IF NOT EXISTS idx_hazo_blog_posts_status
128
+ ON hazo_blog_posts (status);
98
129
  CREATE INDEX IF NOT EXISTS idx_hazo_blog_posts_deleted_at
99
130
  ON hazo_blog_posts (deleted_at);
100
131
  CREATE INDEX IF NOT EXISTS idx_hazo_blog_posts_publish_at
101
132
  ON hazo_blog_posts (publish_at);
133
+ CREATE INDEX IF NOT EXISTS idx_hazo_blog_posts_category_id
134
+ ON hazo_blog_posts (category_id);
102
135
 
103
136
  -- Stub FTS5 index for add-on (SQLite) mode — see db_setup_postgres.sql's
104
137
  -- search_vector/GIN index for the real multi-tenant implementation. Kept in
@@ -141,6 +174,117 @@ CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_post_tags_unique
141
174
  ON hazo_blog_post_tags (post_id, tag_id);
142
175
  CREATE INDEX IF NOT EXISTS idx_hazo_blog_post_tags_tag ON hazo_blog_post_tags (tag_id);
143
176
 
177
+ -- hazo_blog_bylines (v2, Phase 1a issue 08) — named author attribution,
178
+ -- independent of hazo_auth login accounts: real users, guests, and imported
179
+ -- WordPress authors all get a row here. scope_id is NOT NULL, same rule as
180
+ -- hazo_blog_posts — every byline belongs to exactly one tenant and is never
181
+ -- queryable cross-tenant (see src/repository/bylines.ts).
182
+ --
183
+ -- user_id is a loose, nullable reference to a hazo_auth user id — NOT a DB
184
+ -- FK: hazo_auth is an OPTIONAL peer of this package (see package.json's
185
+ -- peerDependenciesMeta), so this table can't own a REFERENCES clause into a
186
+ -- users table that may not exist. Validated at the application layer
187
+ -- if/when hazo_auth is present (see resolvePostScope's optional_import
188
+ -- convention in src/service/posts.ts).
189
+ CREATE TABLE IF NOT EXISTS hazo_blog_bylines (
190
+ id TEXT PRIMARY KEY,
191
+ scope_id TEXT NOT NULL,
192
+ name TEXT NOT NULL,
193
+ slug TEXT NOT NULL,
194
+ bio TEXT,
195
+ avatar_url TEXT,
196
+ user_id TEXT,
197
+ created_at TEXT NOT NULL DEFAULT (datetime('now')),
198
+ updated_at TEXT NOT NULL DEFAULT (datetime('now'))
199
+ );
200
+ CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_bylines_scope_slug
201
+ ON hazo_blog_bylines (scope_id, slug);
202
+
203
+ -- hazo_blog_post_bylines — post↔byline join, ordered by `position` for
204
+ -- display (e.g. "By A, B & C"). Surrogate `id` PK, not composite
205
+ -- `(post_id, byline_id)` — same reasoning as hazo_blog_post_tags above:
206
+ -- hazo_connect's CrudService only deletes by a single PK, so a composite key
207
+ -- wouldn't be deletable through the documented API.
208
+ CREATE TABLE IF NOT EXISTS hazo_blog_post_bylines (
209
+ id TEXT PRIMARY KEY,
210
+ post_id TEXT NOT NULL REFERENCES hazo_blog_posts(id) ON DELETE CASCADE,
211
+ byline_id TEXT NOT NULL REFERENCES hazo_blog_bylines(id) ON DELETE CASCADE,
212
+ position INTEGER NOT NULL DEFAULT 0
213
+ );
214
+ CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_post_bylines_unique
215
+ ON hazo_blog_post_bylines (post_id, byline_id);
216
+ CREATE INDEX IF NOT EXISTS idx_hazo_blog_post_bylines_byline
217
+ ON hazo_blog_post_bylines (byline_id);
218
+ CREATE INDEX IF NOT EXISTS idx_hazo_blog_post_bylines_post_position
219
+ ON hazo_blog_post_bylines (post_id, position);
220
+
221
+ -- hazo_blog_media (v2, Phase 1a issue 10) — one row per distinct uploaded
222
+ -- file per tenant, deduplicated by (scope_id, hash): the same bytes
223
+ -- uploaded twice to the SAME scope return the existing row; the same bytes
224
+ -- uploaded to a DIFFERENT scope get their own row (dedup is per-tenant, not
225
+ -- global). scope_id is NOT NULL, same rule as hazo_blog_posts/bylines.
226
+ --
227
+ -- focal_point/tags/ai_data/variants are JSON (object/array/object/object
228
+ -- respectively) stored as TEXT on SQLite — see
229
+ -- src/repository/media.ts's parseJsonColumn. variants maps a
230
+ -- "{width}-{format}" key (e.g. "640-avif") to that variant's storage_key;
231
+ -- storage_key (this table's own column) is the SAME value as one entry of
232
+ -- variants — the "primary" variant (widest width, AVIF) chosen to represent
233
+ -- this media item at a glance. See src/service/media.ts's
234
+ -- pickPrimaryVariantKey.
235
+ CREATE TABLE IF NOT EXISTS hazo_blog_media (
236
+ id TEXT PRIMARY KEY,
237
+ scope_id TEXT NOT NULL,
238
+ filename TEXT NOT NULL,
239
+ mime_type TEXT NOT NULL,
240
+ size_bytes INTEGER NOT NULL,
241
+ width INTEGER NOT NULL,
242
+ height INTEGER NOT NULL,
243
+ hash TEXT NOT NULL,
244
+ blurhash TEXT NOT NULL,
245
+ dominant_colour TEXT NOT NULL,
246
+ focal_point TEXT, -- JSON {x, y} or NULL
247
+ alt TEXT,
248
+ caption TEXT,
249
+ tags TEXT NOT NULL DEFAULT '[]', -- JSON array of strings
250
+ ai_data TEXT NOT NULL DEFAULT '{}', -- JSON object
251
+ variants TEXT NOT NULL DEFAULT '{}', -- JSON object: "{width}-{format}" -> storage_key
252
+ storage_key TEXT NOT NULL,
253
+ created_at TEXT NOT NULL DEFAULT (datetime('now')),
254
+ updated_at TEXT NOT NULL DEFAULT (datetime('now'))
255
+ );
256
+ -- Dedup key: unique PER SCOPE, not globally — the same file uploaded to two
257
+ -- different tenants must not dedup across them.
258
+ CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_media_scope_hash
259
+ ON hazo_blog_media (scope_id, hash);
260
+ CREATE INDEX IF NOT EXISTS idx_hazo_blog_media_scope_created
261
+ ON hazo_blog_media (scope_id, created_at);
262
+
263
+ -- hazo_blog_media_usage — which content field references a hazo_blog_media
264
+ -- row, maintained on every content save (src/service/posts.ts's
265
+ -- createPost/updatePost, via src/service/media.ts's
266
+ -- syncMediaUsageForEntity). Surrogate `id` PK, not composite
267
+ -- `(entity_type, entity_id, field)` — same reasoning as
268
+ -- hazo_blog_post_tags/hazo_blog_post_bylines above: hazo_connect's
269
+ -- CrudService only deletes by a single PK.
270
+ CREATE TABLE IF NOT EXISTS hazo_blog_media_usage (
271
+ id TEXT PRIMARY KEY,
272
+ media_id TEXT NOT NULL REFERENCES hazo_blog_media(id) ON DELETE CASCADE,
273
+ entity_type TEXT NOT NULL,
274
+ entity_id TEXT NOT NULL,
275
+ field TEXT NOT NULL,
276
+ scope_id TEXT NOT NULL
277
+ );
278
+ -- One media reference per (entity_type, entity_id, field) at a time.
279
+ CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_media_usage_unique
280
+ ON hazo_blog_media_usage (entity_type, entity_id, field);
281
+ -- "Where used" lookups, keyed from the content side.
282
+ CREATE INDEX IF NOT EXISTS idx_hazo_blog_media_usage_entity
283
+ ON hazo_blog_media_usage (entity_type, entity_id);
284
+ -- Reverse lookups, keyed from the media side (used/unused filter).
285
+ CREATE INDEX IF NOT EXISTS idx_hazo_blog_media_usage_media
286
+ ON hazo_blog_media_usage (media_id);
287
+
144
288
  -- package-owned display/behavior settings, e.g. which blog index layout is
145
289
  -- active — one row per (scope_id, setting_key)
146
290
  CREATE TABLE IF NOT EXISTS hazo_blog_settings (
@@ -153,3 +297,200 @@ CREATE TABLE IF NOT EXISTS hazo_blog_settings (
153
297
  );
154
298
  CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_settings_scope_key
155
299
  ON hazo_blog_settings (scope_id, setting_key);
300
+
301
+ -- hazo_blog_app_site_domains (Phase 1a issue 14) — custom domains that serve
302
+ -- a tenant's public site. scope_id is NOT NULL here (unlike most other
303
+ -- tables in this file) for the same reason as hazo_blog_posts/bylines/media:
304
+ -- every row must belong to exactly one concrete tenant, because this table
305
+ -- IS the security boundary for unauthenticated public host-based routing
306
+ -- (Host header -> domain row -> scope_id, with NO membership check at all —
307
+ -- see hazo_blog's own CLAUDE.md / the platform's lib/host-resolution.ts).
308
+ --
309
+ -- `domain` is unique GLOBALLY (across every scope) among VERIFIED rows only
310
+ -- — a domain can only ever point at one tenant's content at a time (that's
311
+ -- what DNS + TLS already enforce out in the world); allowing a verified
312
+ -- domain string under two different scope_ids would let a second tenant
313
+ -- silently shadow/hijack the first's domain in this table even though only
314
+ -- one of them could actually prove ownership via DNS. The uniqueness is
315
+ -- deliberately partial (verified rows only), not a plain unique index: an
316
+ -- UNVERIFIED claim must never block a different tenant from also claiming
317
+ -- (and verifying) the same domain string, or the first claimant could
318
+ -- squat it forever without ever proving ownership — a denial-of-service.
319
+ -- Multiple unverified rows for the same domain are allowed to coexist;
320
+ -- whichever passes DNS TXT verification first wins, and `verifyDomain`
321
+ -- (../src/service/domains.ts) deletes the losing unverified siblings. This
322
+ -- is a deliberate deviation from this file's usual `(scope_id, slug)`-style
323
+ -- compound uniqueness.
324
+ --
325
+ -- `verified`/`is_primary` are 0/1 (SQLite has no native boolean). "Only one
326
+ -- primary domain per scope" is enforced at the service layer
327
+ -- (src/service/domains.ts's setPrimaryDomain), not a DB constraint — same
328
+ -- convention as every other invariant in this schema (see hazo_blog_posts'
329
+ -- `status` column comment).
330
+ CREATE TABLE IF NOT EXISTS hazo_blog_app_site_domains (
331
+ id TEXT PRIMARY KEY,
332
+ scope_id TEXT NOT NULL,
333
+ domain TEXT NOT NULL,
334
+ verified INTEGER NOT NULL DEFAULT 0, -- 0/1
335
+ is_primary INTEGER NOT NULL DEFAULT 0, -- 0/1
336
+ created_at TEXT NOT NULL DEFAULT (datetime('now'))
337
+ );
338
+ CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_app_site_domains_domain_verified
339
+ ON hazo_blog_app_site_domains (domain) WHERE verified = 1;
340
+ CREATE INDEX IF NOT EXISTS idx_hazo_blog_app_site_domains_scope
341
+ ON hazo_blog_app_site_domains (scope_id);
342
+
343
+ -- hazo_blog_menus (Phase 1b issue 04) — named navigation menus (e.g. "main",
344
+ -- "footer"), rendered by the `{% menu "handle" %}` Liquid tag
345
+ -- (`hazo_blog/render`'s `registerPlatformTags`). `scope_id` is NOT NULL
346
+ -- here, unlike hazo_blog_categories/tags/settings above — a deliberate
347
+ -- deviation from this file's own "every other table carries a NULLABLE
348
+ -- scope_id" convention (see this file's header comment). Menus are
349
+ -- multi-tenant-platform-first, not an add-on-mode (GoTimer/kinstripe)
350
+ -- feature: there is no useful "global menu" concept the way a shared
351
+ -- legacy category/tag can be, and v1.6 add-on consumers (pinned below
352
+ -- 2.x) never pull this DDL at all, so there's no back-compat reason to
353
+ -- allow a NULL scope here the way hazo_blog_posts/bylines/media/
354
+ -- app_site_domains didn't either — same reasoning as those tables'
355
+ -- NOT NULL scope_id.
356
+ CREATE TABLE IF NOT EXISTS hazo_blog_menus (
357
+ id TEXT PRIMARY KEY,
358
+ scope_id TEXT NOT NULL,
359
+ name TEXT NOT NULL,
360
+ handle TEXT NOT NULL,
361
+ created_at TEXT NOT NULL DEFAULT (datetime('now')),
362
+ updated_at TEXT NOT NULL DEFAULT (datetime('now'))
363
+ );
364
+ -- One menu per `(scope_id, handle)` — `{% menu "handle" %}` looks a menu up
365
+ -- by handle within a single tenant's scope, so a duplicate handle in the
366
+ -- same scope would make that lookup ambiguous.
367
+ CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_menus_scope_handle
368
+ ON hazo_blog_menus (scope_id, handle);
369
+
370
+ -- hazo_blog_menu_items — one entry in a menu. Self-referencing `parent_id`
371
+ -- gives unlimited nesting depth (admin UI: indent/outdent; render: nested
372
+ -- `<ul>`). `ON DELETE CASCADE` on both `menu_id` and `parent_id` means
373
+ -- deleting a menu (or any item) removes its entire subtree in one
374
+ -- statement — same reasoning `hazo_blog_post_bylines`/`hazo_blog_media`
375
+ -- already rely on for their own cascades.
376
+ --
377
+ -- `item_type` distinguishes a REFERENCE item (`ref_type`/`ref_id` point at
378
+ -- a live post/page/category row; `label`/`url` are unused except `label`
379
+ -- as an optional override of the resolved title) from a CUSTOM item
380
+ -- (`label`/`url` are the item's own data; `ref_type`/`ref_id` are unused).
381
+ -- Enforced at the service/repository layer (`src/repository/menus.ts`),
382
+ -- not a DB CHECK constraint — same "invariant enforced in application
383
+ -- code, not SQL" convention as hazo_blog_posts' `status` column comment
384
+ -- and hazo_blog_app_site_domains' `is_primary` uniqueness.
385
+ CREATE TABLE IF NOT EXISTS hazo_blog_menu_items (
386
+ id TEXT PRIMARY KEY,
387
+ menu_id TEXT NOT NULL REFERENCES hazo_blog_menus(id) ON DELETE CASCADE,
388
+ scope_id TEXT NOT NULL,
389
+ parent_id TEXT REFERENCES hazo_blog_menu_items(id) ON DELETE CASCADE,
390
+ position INTEGER NOT NULL DEFAULT 0,
391
+ item_type TEXT NOT NULL DEFAULT 'custom', -- 'reference' | 'custom'
392
+ ref_type TEXT, -- 'post' | 'page' | 'category' — reference items only
393
+ ref_id TEXT, -- id of the referenced row — reference items only
394
+ label TEXT, -- item text; override of the resolved title for reference items, required for custom items
395
+ url TEXT, -- required for custom items; unused for reference items (resolved at render time)
396
+ css_class TEXT,
397
+ target TEXT, -- e.g. '_blank'
398
+ created_at TEXT NOT NULL DEFAULT (datetime('now')),
399
+ updated_at TEXT NOT NULL DEFAULT (datetime('now'))
400
+ );
401
+ -- Drives both `listMenuItems` (ordered tree build) and `reorderMenuItems`.
402
+ CREATE INDEX IF NOT EXISTS idx_hazo_blog_menu_items_menu_parent_position
403
+ ON hazo_blog_menu_items (menu_id, parent_id, position);
404
+
405
+ -- hazo_blog_themes (Phase 1b issue 06) — a registered theme. `scope_id`
406
+ -- NULL = built-in/global (scanned from the `hazo_blog_themes` package at
407
+ -- boot, visible to every site); non-NULL = that site's own zip upload,
408
+ -- visible ONLY to it. No DB-level UNIQUE(scope_id, handle) here — Postgres
409
+ -- (and SQLite) treat every NULL as distinct for uniqueness purposes, so a
410
+ -- composite unique index including a nullable scope_id would NOT actually
411
+ -- prevent two different built-in themes from sharing a handle; that's
412
+ -- enforced in application code instead (`src/repository/themes.ts`'s
413
+ -- `findBuiltInByHandle` upsert-by-handle check), same "invariant enforced
414
+ -- in application code, not SQL" convention this file's own
415
+ -- hazo_blog_menu_items comment documents for `item_type`.
416
+ --
417
+ -- `version`/`storage_path` always mirror this theme's CURRENT (latest)
418
+ -- version; `hazo_blog_theme_versions` keeps every version ever installed,
419
+ -- including this one, for history.
420
+ CREATE TABLE IF NOT EXISTS hazo_blog_themes (
421
+ id TEXT PRIMARY KEY,
422
+ scope_id TEXT, -- NULL = built-in/global
423
+ name TEXT NOT NULL,
424
+ handle TEXT NOT NULL,
425
+ version TEXT NOT NULL,
426
+ author TEXT NOT NULL,
427
+ licence TEXT NOT NULL,
428
+ description TEXT,
429
+ screenshots TEXT NOT NULL DEFAULT '[]', -- JSON array of URLs/paths
430
+ source TEXT NOT NULL, -- 'built-in' | 'upload'
431
+ storage_path TEXT NOT NULL, -- built-in: local fs dir; upload: R2 key prefix
432
+ created_at TEXT NOT NULL DEFAULT (datetime('now'))
433
+ );
434
+ CREATE INDEX IF NOT EXISTS idx_hazo_blog_themes_scope
435
+ ON hazo_blog_themes (scope_id);
436
+
437
+ -- hazo_blog_theme_versions — one row per version ever installed for a
438
+ -- theme (ticket's own "version history" requirement). `ON DELETE CASCADE`
439
+ -- so deleting a theme (`ThemeRepository.deleteTheme`, which also does this
440
+ -- explicitly itself for engines without enforced FK cascades) takes its
441
+ -- version history with it.
442
+ CREATE TABLE IF NOT EXISTS hazo_blog_theme_versions (
443
+ id TEXT PRIMARY KEY,
444
+ theme_id TEXT NOT NULL REFERENCES hazo_blog_themes(id) ON DELETE CASCADE,
445
+ version TEXT NOT NULL,
446
+ storage_path TEXT NOT NULL,
447
+ created_at TEXT NOT NULL DEFAULT (datetime('now'))
448
+ );
449
+ CREATE INDEX IF NOT EXISTS idx_hazo_blog_theme_versions_theme
450
+ ON hazo_blog_theme_versions (theme_id, created_at);
451
+
452
+ -- hazo_blog_site_theme — the theme currently ACTIVE for a site. ONE row
453
+ -- per `scope_id`, enforced by the UNIQUE index below PLUS upsert semantics
454
+ -- in `ThemeRepository.setSiteTheme` (selects the existing row for this
455
+ -- scope and updates it in place, never inserts a second one) — there is
456
+ -- no separate "is_active" flag to go out of sync with: the row's mere
457
+ -- existence for a scope IS that scope's active theme.
458
+ CREATE TABLE IF NOT EXISTS hazo_blog_site_theme (
459
+ id TEXT PRIMARY KEY,
460
+ scope_id TEXT NOT NULL,
461
+ theme_id TEXT NOT NULL REFERENCES hazo_blog_themes(id) ON DELETE CASCADE,
462
+ settings TEXT NOT NULL DEFAULT '{}', -- JSON object, keyed by theme.json settings[].key
463
+ activated_at TEXT NOT NULL DEFAULT (datetime('now'))
464
+ );
465
+ CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_site_theme_scope
466
+ ON hazo_blog_site_theme (scope_id);
467
+
468
+ -- hazo_blog_site_files (Phase 1b issue 09) — versioned per-site files, e.g.
469
+ -- the Settings -> Appearance custom CSS textarea. `scope_id` NOT NULL, same
470
+ -- "platform-multi-tenant-first" reasoning as hazo_blog_menus/
471
+ -- hazo_blog_site_theme above — there's no useful "global" custom CSS.
472
+ --
473
+ -- VERSIONING: every save INSERTS a new row (never an UPDATE of `content`)
474
+ -- with `version` one higher than the previous current row for this
475
+ -- `(scope_id, kind)`, and flips the previous current row's `is_current` to
476
+ -- 0 in the same `SiteFileRepository.setCurrentFile` call — full edit
477
+ -- history for free, at the cost of one extra row per (infrequent, admin-
478
+ -- only) save. "At most one current row per (scope_id, kind)" is enforced in
479
+ -- APPLICATION code (select-current, flip, insert-new), not a DB constraint
480
+ -- — same convention as hazo_blog_app_site_domains.is_primary/
481
+ -- hazo_blog_menu_items.item_type (see those tables' own comments).
482
+ CREATE TABLE IF NOT EXISTS hazo_blog_site_files (
483
+ id TEXT PRIMARY KEY,
484
+ scope_id TEXT NOT NULL,
485
+ kind TEXT NOT NULL, -- e.g. 'custom_css' — see SiteFileKind
486
+ content TEXT NOT NULL DEFAULT '',
487
+ version INTEGER NOT NULL DEFAULT 1,
488
+ is_current INTEGER NOT NULL DEFAULT 1, -- 0/1 (SQLite has no native boolean)
489
+ created_at TEXT NOT NULL DEFAULT (datetime('now'))
490
+ );
491
+ -- Full version history is retrievable; one row per (scope_id, kind, version).
492
+ CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_site_files_scope_kind_version
493
+ ON hazo_blog_site_files (scope_id, kind, version);
494
+ -- The common lookup: "give me the current row for this site+kind".
495
+ CREATE INDEX IF NOT EXISTS idx_hazo_blog_site_files_current
496
+ ON hazo_blog_site_files (scope_id, kind, is_current);
package/dist/index.d.ts CHANGED
@@ -1,8 +1,32 @@
1
1
  export * from "./types/index.js";
2
2
  export * from "./lib/index.js";
3
3
  export { createBlogRepository, type BlogRepository, type RepositoryOptions, type ListQuery, } from "./repository/index.js";
4
+ export { createPostRepository, findDueScheduledPosts, purgeTrashedPosts, CategoryNotFoundError, PostConflictError, PostInvalidStatusTransitionError, PostNoDraftRevisionError, PostNoLiveRevisionError, PostNotFoundError, type PostRepository, } from "./repository/posts.js";
5
+ export { createPostService, resolvePostScope, ScopeUnresolvedError, CustomFieldValidationError, type PostService, } from "./service/posts.js";
6
+ export { registerSeoHooks } from "./service/seo-hooks.js";
7
+ export { createBylineRepository, BylineNotFoundError, PostNotFoundForBylineError, type BylineRepository, } from "./repository/bylines.js";
8
+ export { createBylineService, type BylineService } from "./service/bylines.js";
9
+ export { createTagRepository, TagNotFoundError, PostNotFoundForTagError, type TagRepository, } from "./repository/tags.js";
10
+ export { createTagService, type TagService } from "./service/tags.js";
11
+ export { createDomainRepository, deleteCompetingUnverifiedClaims, findDomainByHost, DomainNotFoundError, DomainAlreadyRegisteredError, type DomainRepository, } from "./repository/domains.js";
12
+ export { createDomainService, resolveScopeByDomain, type DomainService, type DomainVerificationInstructions, } from "./service/domains.js";
13
+ export { createMenuRepository, MenuNotFoundError, MenuItemNotFoundError, MenuHandleConflictError, MenuItemValidationError, type MenuRepository, } from "./repository/menus.js";
14
+ export { createMenuService, buildResolvedMenuTree, type MenuService } from "./service/menus.js";
15
+ export { createThemeRepository, listVisibleThemes, ThemeNotFoundError, type ThemeRepository, } from "./repository/themes.js";
16
+ export { createThemeService, ThemeNotActiveError, ThemeSettingsValidationError, ThemeStorageNotConfiguredError, ThemeMaterializationUnsupportedError, type ThemeService, type CreateThemeServiceDeps, type InstallBuiltInThemesResult, } from "./service/themes.js";
17
+ export { createSiteFileRepository, type SiteFileRepository, } from "./repository/site-files.js";
18
+ export { createSiteFileService, CustomCssTooLargeError, MAX_CUSTOM_CSS_BYTES, type SiteFileService, } from "./service/site-files.js";
19
+ export { registerCdnHooks } from "./service/cdn-hooks.js";
20
+ export { domainVerificationToken, domainVerificationRecordName, DOMAIN_VERIFICATION_TXT_LABEL, INSECURE_DEV_FALLBACK_SECRET, } from "./lib/domain-token.js";
21
+ export { verifyDomainTxtRecord, type ResolveTxt } from "./lib/domain-dns.js";
22
+ export { createMediaRepository, MediaNotFoundError, type MediaRepository, type InsertMediaInput, } from "./repository/media.js";
23
+ export { createMediaService, MediaUnsupportedFormatError, MediaStorageNotConfiguredError, type MediaService, type CreateMediaServiceDeps, type ProcessedMediaVariants, } from "./service/media.js";
24
+ export { createAutoPublishScheduledPostsJob, createPurgeTrashedPostsJob, registerBlogMaintenanceJobs, type RegisterBlogMaintenanceJobsOptions, type RegisterBlogMaintenanceJobsDeps, type BlogMaintenanceWorkerHandle, } from "./jobs/maintenance-jobs.js";
4
25
  export { createBlogService, resolveConfig, BlogSettingsUnavailableError, type BlogService, type TranslatePostResult, type TranslatePostUsage, type TranslatePostSegmentResult, type ReviewTranslatedPostResult, type ReviewTranslatedPostUsage, } from "./service/index.js";
5
26
  export * from "./seo/index.js";
6
27
  export { createBlogManageRoutes, createBlogManageSlugRoutes, createBlogAdminRoutes, createBlogSettingsRoutes, createBlogTranslateRoutes, createBlogReviewRoutes, createBlogSearchRoute, createBlogFeedRoute, createBlogSitemapRoute, } from "./next/routes.js";
28
+ export { createDomainAskRoute } from "./next/domain-routes.js";
7
29
  export { createBlogImageUploadRoute, type CreateBlogImageUploadRouteDeps, } from "./next/image-upload.js";
30
+ export { createPostManageRoutes, createPostItemRoutes, createPostCompareRoutes, createPostPublishRoutes, createPostDiscardRoutes, createPostStatusRoutes, createPostTrashRoutes, createPostRestoreRoutes, } from "./next/post-routes.js";
31
+ export { createBylineManageRoutes, createBylineItemRoutes, createBylinePostsRoutes, createPostBylinesRoutes, createPostBylineItemRoutes, createPostBylinesReorderRoutes, } from "./next/byline-routes.js";
8
32
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,kBAAkB,CAAC;AAGjC,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,SAAS,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,4BAA4B,EAC5B,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,GAC/B,MAAM,oBAAoB,CAAC;AAG5B,cAAc,gBAAgB,CAAC;AAI/B,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,0BAA0B,EAC1B,KAAK,8BAA8B,GACpC,MAAM,wBAAwB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -7,10 +7,34 @@ export * from "./types/index.js";
7
7
  export * from "./lib/index.js";
8
8
  // Storage + business logic.
9
9
  export { createBlogRepository, } from "./repository/index.js";
10
+ export { createPostRepository, findDueScheduledPosts, purgeTrashedPosts, CategoryNotFoundError, PostConflictError, PostInvalidStatusTransitionError, PostNoDraftRevisionError, PostNoLiveRevisionError, PostNotFoundError, } from "./repository/posts.js";
11
+ export { createPostService, resolvePostScope, ScopeUnresolvedError, CustomFieldValidationError, } from "./service/posts.js";
12
+ export { registerSeoHooks } from "./service/seo-hooks.js";
13
+ export { createBylineRepository, BylineNotFoundError, PostNotFoundForBylineError, } from "./repository/bylines.js";
14
+ export { createBylineService } from "./service/bylines.js";
15
+ export { createTagRepository, TagNotFoundError, PostNotFoundForTagError, } from "./repository/tags.js";
16
+ export { createTagService } from "./service/tags.js";
17
+ export { createDomainRepository, deleteCompetingUnverifiedClaims, findDomainByHost, DomainNotFoundError, DomainAlreadyRegisteredError, } from "./repository/domains.js";
18
+ export { createDomainService, resolveScopeByDomain, } from "./service/domains.js";
19
+ export { createMenuRepository, MenuNotFoundError, MenuItemNotFoundError, MenuHandleConflictError, MenuItemValidationError, } from "./repository/menus.js";
20
+ export { createMenuService, buildResolvedMenuTree } from "./service/menus.js";
21
+ export { createThemeRepository, listVisibleThemes, ThemeNotFoundError, } from "./repository/themes.js";
22
+ export { createThemeService, ThemeNotActiveError, ThemeSettingsValidationError, ThemeStorageNotConfiguredError, ThemeMaterializationUnsupportedError, } from "./service/themes.js";
23
+ export { createSiteFileRepository, } from "./repository/site-files.js";
24
+ export { createSiteFileService, CustomCssTooLargeError, MAX_CUSTOM_CSS_BYTES, } from "./service/site-files.js";
25
+ export { registerCdnHooks } from "./service/cdn-hooks.js";
26
+ export { domainVerificationToken, domainVerificationRecordName, DOMAIN_VERIFICATION_TXT_LABEL, INSECURE_DEV_FALLBACK_SECRET, } from "./lib/domain-token.js";
27
+ export { verifyDomainTxtRecord } from "./lib/domain-dns.js";
28
+ export { createMediaRepository, MediaNotFoundError, } from "./repository/media.js";
29
+ export { createMediaService, MediaUnsupportedFormatError, MediaStorageNotConfiguredError, } from "./service/media.js";
30
+ export { createAutoPublishScheduledPostsJob, createPurgeTrashedPostsJob, registerBlogMaintenanceJobs, } from "./jobs/maintenance-jobs.js";
10
31
  export { createBlogService, resolveConfig, BlogSettingsUnavailableError, } from "./service/index.js";
11
32
  // SEO emission helpers (also available via the `hazo_blog/seo` subpath).
12
33
  export * from "./seo/index.js";
13
34
  // Route-handler factories — React-free, so API routes can import them without
14
35
  // pulling in the React page components from `hazo_blog/next`.
15
36
  export { createBlogManageRoutes, createBlogManageSlugRoutes, createBlogAdminRoutes, createBlogSettingsRoutes, createBlogTranslateRoutes, createBlogReviewRoutes, createBlogSearchRoute, createBlogFeedRoute, createBlogSitemapRoute, } from "./next/routes.js";
37
+ export { createDomainAskRoute } from "./next/domain-routes.js";
16
38
  export { createBlogImageUploadRoute, } from "./next/image-upload.js";
39
+ export { createPostManageRoutes, createPostItemRoutes, createPostCompareRoutes, createPostPublishRoutes, createPostDiscardRoutes, createPostStatusRoutes, createPostTrashRoutes, createPostRestoreRoutes, } from "./next/post-routes.js";
40
+ export { createBylineManageRoutes, createBylineItemRoutes, createBylinePostsRoutes, createPostBylinesRoutes, createPostBylineItemRoutes, createPostBylinesReorderRoutes, } from "./next/byline-routes.js";
@@ -0,0 +1,83 @@
1
+ import type { BlogConfig } from "../types/index.js";
2
+ type JobsServerModule = typeof import("hazo_jobs/server");
3
+ type MaintenanceJob<TPayload = unknown> = import("hazo_jobs").MaintenanceJob<TPayload>;
4
+ /** hazo_jobs' raw-SQL adapter contract (`JobsClientOptions.connect`'s `adapter` branch) — see `RegisterBlogMaintenanceJobsOptions.rawAdapter`'s doc-comment for why this is NOT the same shape as a `hazo_connect` adapter. */
5
+ type JobsRawAdapter = {
6
+ raw: (sql: string, values?: unknown[]) => Promise<unknown[]>;
7
+ };
8
+ /**
9
+ * Promotes every due `'scheduled'` post (`publish_at <= now`) to
10
+ * `'published'`, one tenant's `PostRepository` at a time — each row
11
+ * `findDueScheduledPosts` returns carries its own `scope_id`, since the
12
+ * sweep itself is cross-tenant (see that function's doc-comment). Reuses
13
+ * `PostRepository.setStatus`, so a due post is promoted exactly the way a
14
+ * manual "Publish now" click would promote it (including draft promotion —
15
+ * see `setStatus`'s doc-comment on the publishDraft interaction). A failure
16
+ * on one post is logged and skipped rather than aborting the rest of the
17
+ * sweep — the same "one bad row doesn't abort the batch" shape hazo_jobs'
18
+ * own `seo_experiment_advance` maintenance job uses.
19
+ */
20
+ export declare function createAutoPublishScheduledPostsJob(config: BlogConfig): MaintenanceJob;
21
+ /**
22
+ * Permanently deletes every `'trashed'` post whose `deleted_at` is older
23
+ * than `payload.retainDays` (default 30) — see `purgeTrashedPosts`'s
24
+ * doc-comment for why this needs no per-scope loop.
25
+ */
26
+ export declare function createPurgeTrashedPostsJob(config: BlogConfig): MaintenanceJob<{
27
+ retainDays: number;
28
+ }>;
29
+ export interface RegisterBlogMaintenanceJobsOptions {
30
+ /** Passed through to `createJobsClient`'s `dialect` — e.g. `"sqlite"`/`"pg"`. Omit to use hazo_jobs' own default (`"pg"`). */
31
+ dialect?: "pg" | "sqlite";
32
+ /** Passed through to `client.worker({ workerId })`. Default `"hazo-blog-maintenance"`. */
33
+ workerId?: string;
34
+ /**
35
+ * The raw-SQL adapter hazo_jobs' `createJobsClient({ connect: { adapter } })`
36
+ * requires: `{ raw(sql, values?): Promise<rows[]> }` — a DIFFERENT, lower-level
37
+ * contract than the `hazo_connect` adapter `config.getHazoConnect()` returns
38
+ * (the one `createPostRepository` builds a query-builder CRUD service over).
39
+ * Confirmed by actually type-checking this file against hazo_jobs' real
40
+ * `.d.ts`, not assumed: `hazo_connect`'s **Postgres** adapter happens to
41
+ * also expose a working `.raw(text, values)` escape hatch (see
42
+ * `../repository/posts.ts`'s `maintainSearchVector`), so for a Postgres host
43
+ * `config.getHazoConnect()` satisfies this contract as-is and `rawAdapter`
44
+ * can be omitted. `hazo_connect`'s **SQLite** adapter does NOT (`.rawQuery`,
45
+ * a different shape) — a SQLite/add-on-mode host MUST pass its own raw
46
+ * wrapper here (hazo_jobs' README's SQLite quick-start shows exactly this:
47
+ * `{ raw: async (sql, values) => db.prepare(sql).all/run(...) }` over
48
+ * `better-sqlite3`). Omitted ⇒ falls back to `config.getHazoConnect()`.
49
+ */
50
+ rawAdapter?: JobsRawAdapter;
51
+ }
52
+ export interface RegisterBlogMaintenanceJobsDeps {
53
+ /** Test seam — see the file header. Defaults to a real `import("hazo_jobs/server").catch(() => null)`. */
54
+ loadJobs?: () => Promise<JobsServerModule | null>;
55
+ }
56
+ export interface BlogMaintenanceWorkerHandle {
57
+ /** The underlying hazo_jobs `Worker` (`client.worker(...)`'s return value) — call `.stop()` to end the poll loop. */
58
+ worker: ReturnType<Awaited<ReturnType<JobsServerModule["createJobsClient"]>>["worker"]>;
59
+ /**
60
+ * Resolves only when `worker.stop()` is called (hazo_jobs'
61
+ * `register_maintenance_jobs` contract — "Resolves only when
62
+ * worker.stop() is called"). Deliberately NOT awaited inside this
63
+ * function, so callers get `worker` back immediately. Intended for a
64
+ * long-running Node process (a standalone worker script / its own
65
+ * deployment), not a Next.js request handler — awaiting `ready` inside an
66
+ * API route would hang the request for the worker's entire lifetime.
67
+ */
68
+ ready: Promise<void>;
69
+ }
70
+ /**
71
+ * Wires both maintenance jobs above into one hazo_jobs worker and starts it.
72
+ * Returns `null` when `hazo_jobs` isn't installed (optional peer) — same
73
+ * degrade-gracefully shape as `createBlogImageUploadRoute`'s `loadImages`
74
+ * seam, except there's no HTTP request to 501 here: this is meant to be
75
+ * called once, at process start, from the host's own worker entry point
76
+ * (e.g. a small standalone script deployed alongside the Next.js app), not
77
+ * from inside a request handler. See `RegisterBlogMaintenanceJobsOptions.rawAdapter`'s
78
+ * doc-comment for the one thing a SQLite/add-on-mode host must supply that a
79
+ * Postgres host doesn't.
80
+ */
81
+ export declare function registerBlogMaintenanceJobs(config: BlogConfig, options?: RegisterBlogMaintenanceJobsOptions, deps?: RegisterBlogMaintenanceJobsDeps): Promise<BlogMaintenanceWorkerHandle | null>;
82
+ export {};
83
+ //# sourceMappingURL=maintenance-jobs.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"maintenance-jobs.d.ts","sourceRoot":"","sources":["../../src/jobs/maintenance-jobs.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,KAAK,gBAAgB,GAAG,cAAc,kBAAkB,CAAC,CAAC;AAC1D,KAAK,cAAc,CAAC,QAAQ,GAAG,OAAO,IAAI,OAAO,WAAW,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;AACvF,+NAA+N;AAC/N,KAAK,cAAc,GAAG;IAAE,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC;AAEvF;;;;;;;;;;;GAWG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CAyBrF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAarG;AAED,MAAM,WAAW,kCAAkC;IACjD,8HAA8H;IAC9H,OAAO,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC;IAC1B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,MAAM,WAAW,+BAA+B;IAC9C,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CACnD;AAUD,MAAM,WAAW,2BAA2B;IAC1C,qHAAqH;IACrH,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxF;;;;;;;;OAQG;IACH,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,kCAAuC,EAChD,IAAI,GAAE,+BAAoC,GACzC,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAoB7C"}