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.
- package/CHANGE_LOG.md +867 -0
- package/README.md +1 -0
- package/db_setup_postgres.sql +652 -0
- package/db_setup_sqlite.sql +341 -0
- package/dist/index.d.ts +24 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +24 -0
- package/dist/jobs/maintenance-jobs.d.ts +83 -0
- package/dist/jobs/maintenance-jobs.d.ts.map +1 -0
- package/dist/jobs/maintenance-jobs.js +123 -0
- package/dist/lib/domain-dns.d.ts +15 -0
- package/dist/lib/domain-dns.d.ts.map +1 -0
- package/dist/lib/domain-dns.js +27 -0
- package/dist/lib/domain-token.d.ts +23 -0
- package/dist/lib/domain-token.d.ts.map +1 -0
- package/dist/lib/domain-token.js +42 -0
- package/dist/lib/hook-bus.d.ts +165 -0
- package/dist/lib/hook-bus.d.ts.map +1 -0
- package/dist/lib/hook-bus.js +90 -0
- package/dist/lib/index.d.ts +8 -0
- package/dist/lib/index.d.ts.map +1 -1
- package/dist/lib/index.js +8 -0
- package/dist/lib/revisions.d.ts +10 -0
- package/dist/lib/revisions.d.ts.map +1 -0
- package/dist/lib/revisions.js +18 -0
- package/dist/lib/safe-url.d.ts +8 -0
- package/dist/lib/safe-url.d.ts.map +1 -0
- package/dist/lib/safe-url.js +32 -0
- package/dist/lib/sections.d.ts +59 -0
- package/dist/lib/sections.d.ts.map +1 -0
- package/dist/lib/sections.js +303 -0
- package/dist/lib/site-identity.d.ts +45 -0
- package/dist/lib/site-identity.d.ts.map +1 -0
- package/dist/lib/site-identity.js +116 -0
- package/dist/lib/status.d.ts +25 -0
- package/dist/lib/status.d.ts.map +1 -0
- package/dist/lib/status.js +58 -0
- package/dist/lib/theme-schema.d.ts +51 -0
- package/dist/lib/theme-schema.d.ts.map +1 -0
- package/dist/lib/theme-schema.js +112 -0
- package/dist/lib/theme-validate.d.ts +48 -0
- package/dist/lib/theme-validate.d.ts.map +1 -0
- package/dist/lib/theme-validate.js +149 -0
- package/dist/next/byline-routes.d.ts +67 -0
- package/dist/next/byline-routes.d.ts.map +1 -0
- package/dist/next/byline-routes.js +235 -0
- package/dist/next/domain-routes.d.ts +9 -0
- package/dist/next/domain-routes.d.ts.map +1 -0
- package/dist/next/domain-routes.js +39 -0
- package/dist/next/post-routes.d.ts +100 -0
- package/dist/next/post-routes.d.ts.map +1 -0
- package/dist/next/post-routes.js +291 -0
- package/dist/render/engine.d.ts +41 -0
- package/dist/render/engine.d.ts.map +1 -0
- package/dist/render/engine.js +91 -0
- package/dist/render/fallback-theme/templates/404.liquid +1 -0
- package/dist/render/fallback-theme/templates/default.liquid +1 -0
- package/dist/render/fallback-theme.d.ts +3 -0
- package/dist/render/fallback-theme.d.ts.map +1 -0
- package/dist/render/fallback-theme.js +34 -0
- package/dist/render/html.d.ts +10 -0
- package/dist/render/html.d.ts.map +1 -0
- package/dist/render/html.js +29 -0
- package/dist/render/index.d.ts +13 -0
- package/dist/render/index.d.ts.map +1 -0
- package/dist/render/index.js +23 -0
- package/dist/render/resolve.d.ts +23 -0
- package/dist/render/resolve.d.ts.map +1 -0
- package/dist/render/resolve.js +32 -0
- package/dist/render/tags/faq.d.ts +9 -0
- package/dist/render/tags/faq.d.ts.map +1 -0
- package/dist/render/tags/faq.js +31 -0
- package/dist/render/tags/image.d.ts +12 -0
- package/dist/render/tags/image.d.ts.map +1 -0
- package/dist/render/tags/image.js +56 -0
- package/dist/render/tags/index.d.ts +3 -0
- package/dist/render/tags/index.d.ts.map +1 -0
- package/dist/render/tags/index.js +16 -0
- package/dist/render/tags/menu.d.ts +11 -0
- package/dist/render/tags/menu.d.ts.map +1 -0
- package/dist/render/tags/menu.js +74 -0
- package/dist/render/tags/related-posts.d.ts +11 -0
- package/dist/render/tags/related-posts.d.ts.map +1 -0
- package/dist/render/tags/related-posts.js +34 -0
- package/dist/render/tags/section-list.d.ts +9 -0
- package/dist/render/tags/section-list.d.ts.map +1 -0
- package/dist/render/tags/section-list.js +71 -0
- package/dist/render/tags/seo-head.d.ts +16 -0
- package/dist/render/tags/seo-head.d.ts.map +1 -0
- package/dist/render/tags/seo-head.js +73 -0
- package/dist/render/tags/toc.d.ts +15 -0
- package/dist/render/tags/toc.d.ts.map +1 -0
- package/dist/render/tags/toc.js +72 -0
- package/dist/render/types.d.ts +167 -0
- package/dist/render/types.d.ts.map +1 -0
- package/dist/render/types.js +13 -0
- package/dist/repository/bylines.d.ts +56 -0
- package/dist/repository/bylines.d.ts.map +1 -0
- package/dist/repository/bylines.js +284 -0
- package/dist/repository/domains.d.ts +67 -0
- package/dist/repository/domains.d.ts.map +1 -0
- package/dist/repository/domains.js +173 -0
- package/dist/repository/media.d.ts +45 -0
- package/dist/repository/media.d.ts.map +1 -0
- package/dist/repository/media.js +248 -0
- package/dist/repository/menus.d.ts +58 -0
- package/dist/repository/menus.d.ts.map +1 -0
- package/dist/repository/menus.js +311 -0
- package/dist/repository/posts.d.ts +171 -0
- package/dist/repository/posts.d.ts.map +1 -0
- package/dist/repository/posts.js +791 -0
- package/dist/repository/site-files.d.ts +15 -0
- package/dist/repository/site-files.d.ts.map +1 -0
- package/dist/repository/site-files.js +73 -0
- package/dist/repository/tags.d.ts +51 -0
- package/dist/repository/tags.d.ts.map +1 -0
- package/dist/repository/tags.js +282 -0
- package/dist/repository/themes.d.ts +45 -0
- package/dist/repository/themes.d.ts.map +1 -0
- package/dist/repository/themes.js +285 -0
- package/dist/seo/hazo-seo-sitemap-source.d.ts +63 -0
- package/dist/seo/hazo-seo-sitemap-source.d.ts.map +1 -0
- package/dist/seo/hazo-seo-sitemap-source.js +85 -0
- package/dist/seo/index.d.ts +1 -0
- package/dist/seo/index.d.ts.map +1 -1
- package/dist/seo/index.js +6 -0
- package/dist/service/bylines.d.ts +21 -0
- package/dist/service/bylines.d.ts.map +1 -0
- package/dist/service/bylines.js +48 -0
- package/dist/service/cdn-hooks.d.ts +20 -0
- package/dist/service/cdn-hooks.d.ts.map +1 -0
- package/dist/service/cdn-hooks.js +38 -0
- package/dist/service/domains.d.ts +49 -0
- package/dist/service/domains.d.ts.map +1 -0
- package/dist/service/domains.js +98 -0
- package/dist/service/media.d.ts +79 -0
- package/dist/service/media.d.ts.map +1 -0
- package/dist/service/media.js +225 -0
- package/dist/service/menus.d.ts +43 -0
- package/dist/service/menus.d.ts.map +1 -0
- package/dist/service/menus.js +165 -0
- package/dist/service/posts.d.ts +70 -0
- package/dist/service/posts.d.ts.map +1 -0
- package/dist/service/posts.js +291 -0
- package/dist/service/seo-hooks.d.ts +18 -0
- package/dist/service/seo-hooks.d.ts.map +1 -0
- package/dist/service/seo-hooks.js +108 -0
- package/dist/service/site-files.d.ts +20 -0
- package/dist/service/site-files.d.ts.map +1 -0
- package/dist/service/site-files.js +71 -0
- package/dist/service/tags.d.ts +20 -0
- package/dist/service/tags.d.ts.map +1 -0
- package/dist/service/tags.js +41 -0
- package/dist/service/themes.d.ts +85 -0
- package/dist/service/themes.d.ts.map +1 -0
- package/dist/service/themes.js +416 -0
- package/dist/types/index.d.ts +953 -0
- package/dist/types/index.d.ts.map +1 -1
- package/dist/ui/content-status-badge.d.ts +7 -0
- package/dist/ui/content-status-badge.d.ts.map +1 -0
- package/dist/ui/content-status-badge.js +16 -0
- package/dist/ui/index.d.ts +1 -0
- package/dist/ui/index.d.ts.map +1 -1
- package/dist/ui/index.js +1 -0
- package/package.json +37 -26
package/db_setup_sqlite.sql
CHANGED
|
@@ -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
|
package/dist/index.d.ts.map
CHANGED
|
@@ -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"}
|