@teamscala/service-boot 0.23.326 → 0.23.327
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/package.json +532 -524
- package/src/agreement-gate.d.ts +19 -0
- package/src/agreement-gate.ts +3 -12
- package/src/asset-cache-key.d.ts +11 -0
- package/src/asset-optimize.d.ts +17 -0
- package/src/asset-proxy.d.ts +11 -0
- package/src/asset-social-card.d.ts +17 -0
- package/src/attach-agreement-magic.d.ts +20 -0
- package/src/attach-portal-members.d.ts +23 -0
- package/src/attach-proposal-accept.d.ts +26 -0
- package/src/attach-proposal-magic.d.ts +18 -0
- package/src/attach-transfers-upload.d.ts +27 -0
- package/src/auth-gate.d.ts +28 -0
- package/src/auth-gate.ts +6 -68
- package/src/bind-page-handler.d.ts +18 -0
- package/src/build-client-assets/input-hashing.d.ts +25 -0
- package/src/build-client-assets/source-candidates.d.ts +27 -0
- package/src/build-client-assets.d.ts +50 -0
- package/src/build-client-assets.test.ts +1 -1
- package/src/build-client-assets.ts +1 -1
- package/src/compose-page-title.d.ts +41 -0
- package/src/content-gate/access.d.ts +15 -0
- package/src/content-gate/config-types.d.ts +99 -0
- package/src/content-gate/gate.d.ts +13 -0
- package/src/content-gate/parse-cookie.d.ts +9 -0
- package/src/content-gate/token.d.ts +48 -0
- package/src/content-page-floor.d.ts +39 -0
- package/src/discover-blocks.d.ts +28 -0
- package/src/discover-blocks.ts +1 -1
- package/src/expand-roster.d.ts +34 -0
- package/src/fn-routers/agreement-completion-email.d.ts +14 -0
- package/src/fn-routers/agreement-send-router.d.ts +82 -0
- package/src/fn-routers/ai-health-router.d.ts +35 -0
- package/src/fn-routers/auth-router.d.ts +47 -0
- package/src/fn-routers/cache-admin-router.d.ts +57 -0
- package/src/fn-routers/chat-session-router.d.ts +219 -0
- package/src/fn-routers/email-defaults.d.ts +1 -0
- package/src/fn-routers/email-link-ttl.d.ts +1 -0
- package/src/fn-routers/index.d.ts +18 -0
- package/src/fn-routers/index.ts +0 -2
- package/src/fn-routers/panel-data-router.d.ts +19 -0
- package/src/fn-routers/persist-chat-messages.d.ts +36 -0
- package/src/fn-routers/plans-router.d.ts +25 -0
- package/src/fn-routers/proposal-send-router.d.ts +58 -0
- package/src/fn-routers/public-agreement-router.d.ts +289 -0
- package/src/fn-routers/public-assessment-router.d.ts +68 -0
- package/src/fn-routers/public-gpt-session-router.d.ts +143 -0
- package/src/fn-routers/sign-in-flow-router.d.ts +107 -0
- package/src/fn-routers/task-sync-assign.d.ts +305 -0
- package/src/fn-routers/task-sync-assign.test.ts +1 -2
- package/src/fn-routers/task-sync-assign.ts +4 -4
- package/src/fn-routers/task-sync-bind.test.ts +18 -18
- package/src/fn-routers/task-sync-brief.d.ts +96 -0
- package/src/fn-routers/task-sync-brief.test.ts +17 -20
- package/src/fn-routers/task-sync-brief.ts +14 -15
- package/src/fn-routers/task-sync-dispatch.d.ts +61 -0
- package/src/fn-routers/task-sync-dispatch.test.ts +33 -51
- package/src/fn-routers/task-sync-dispatch.ts +124 -0
- package/src/fn-routers/task-sync-lane.d.ts +49 -0
- package/src/fn-routers/task-sync-lane.ts +125 -0
- package/src/fn-routers/task-sync-projection.d.ts +121 -0
- package/src/fn-routers/task-sync-projection.test.ts +0 -26
- package/src/fn-routers/task-sync-projection.ts +0 -51
- package/src/fn-routers/task-sync-rename.d.ts +91 -0
- package/src/fn-routers/task-sync-router.d.ts +424 -0
- package/src/fn-routers/task-sync-router.test.ts +2 -14
- package/src/fn-routers/task-sync-router.ts +1106 -0
- package/src/fn-routers/tasks-router.d.ts +25 -0
- package/src/fn-routers/user-preferences-router.d.ts +77 -0
- package/src/fn-routers/work-items-router.d.ts +102 -0
- package/src/gate-ttls.d.ts +6 -0
- package/src/gpt-gate.d.ts +25 -0
- package/src/handlers/bun-stable-watch.d.ts +1 -0
- package/src/handlers/pane-outbox-drain.d.ts +1 -0
- package/src/handlers/projects-digest.d.ts +26 -0
- package/src/handlers/prune-stale-data.d.ts +30 -0
- package/src/handlers/registry-stale-inactive-sweep.d.ts +1 -0
- package/src/handlers/scala-tools-currency-watch.d.ts +1 -0
- package/src/handlers/singleton-tools-currency-watch.d.ts +1 -0
- package/src/handlers/singleton-tools-currency-watch.ts +11 -114
- package/src/handlers/sweep-event-log.d.ts +1 -0
- package/src/handlers/sweep-host-cache.d.ts +1 -0
- package/src/handlers/sweep-host-cache.ts +26 -143
- package/src/handlers/upstream-issue-sync.d.ts +1 -0
- package/src/handlers/whatsapp-liveness-logic.d.ts +34 -0
- package/src/handlers/whatsapp-liveness.d.ts +4 -0
- package/src/hono-error-handler.d.ts +25 -0
- package/src/install-harness.d.ts +45 -0
- package/src/install-logging.d.ts +34 -0
- package/src/install-logging.ts +0 -3
- package/src/load-service-install-row.d.ts +24 -0
- package/src/load-service-prisma-client.d.ts +18 -0
- package/src/mount-orpc-router.d.ts +15 -0
- package/src/mount-orpc-router.ts +1 -1
- package/src/mount-server-packages.d.ts +29 -0
- package/src/mount.d.ts +9 -0
- package/src/mutable-app-ref.d.ts +44 -0
- package/src/page-route-shell-types.d.ts +12 -0
- package/src/page-server-orpc/audit-revert-router.d.ts +37 -0
- package/src/page-server-orpc/hub-mcp-client.d.ts +12 -0
- package/src/page-server-orpc/portal-diagnostics-router.d.ts +49 -0
- package/src/page-server-orpc/puck-pages-router.d.ts +58 -0
- package/src/page-server-orpc/server-client.d.ts +16 -0
- package/src/page-server-orpc/templates-router.d.ts +34 -0
- package/src/page-server-orpc/user-preferences-router.d.ts +79 -0
- package/src/pg-boss-handler-registry.d.ts +27 -0
- package/src/pg-boss-mount.d.ts +42 -0
- package/src/proposal-authorized-emails.d.ts +28 -0
- package/src/proposal-chat-inject.d.ts +17 -0
- package/src/proposal-gate.d.ts +18 -0
- package/src/read-html-template.d.ts +38 -0
- package/src/read-viewport-from-request.d.ts +18 -0
- package/src/readiness-gate.d.ts +16 -0
- package/src/register-api-routes.d.ts +18 -0
- package/src/register-crash-handlers.d.ts +15 -0
- package/src/register-page-routes.d.ts +27 -0
- package/src/register-page-routes.ts +3 -0
- package/src/register-page-server-client.d.ts +11 -0
- package/src/register-registry-page-route/ai-chat-prefetch.d.ts +13 -0
- package/src/register-registry-page-route/graph-cache.d.ts +30 -0
- package/src/register-registry-page-route/meta-title.d.ts +2 -0
- package/src/register-registry-page-route/proposal-approval-email-token.d.ts +14 -0
- package/src/register-registry-page-route/proposal-brand-stamping.d.ts +28 -0
- package/src/register-registry-page-route/resolve-page-data.d.ts +1 -0
- package/src/register-registry-page-route.d.ts +27 -0
- package/src/register-static-assets.d.ts +13 -0
- package/src/register-ws-routes.d.ts +28 -0
- package/src/resolve-app-base-url.d.ts +13 -0
- package/src/resolve-brand-favicon.d.ts +28 -0
- package/src/resolve-brand-favicon.ts +1 -1
- package/src/resolve-from-loader-config.d.ts +32 -0
- package/src/resolve-service-context.d.ts +17 -0
- package/src/resolve-service-port.d.ts +75 -0
- package/src/resolve-theme-mode.d.ts +42 -0
- package/src/resolvers/fetch-org-brand.d.ts +2 -0
- package/src/resolvers/portal-route-paths.d.ts +39 -0
- package/src/resolvers/website-by-host-map.d.ts +12 -0
- package/src/resource-chat-inject.d.ts +46 -0
- package/src/resource-not-found.d.ts +60 -0
- package/src/resource-not-found.ts +0 -10
- package/src/run-boot-hook-list.d.ts +19 -0
- package/src/run-boot-hooks.d.ts +31 -0
- package/src/scala-tools-currency-watchdog.d.ts +10 -0
- package/src/security-headers.d.ts +12 -0
- package/src/serve/serve.d.ts +46 -0
- package/src/serve/stamp-transport-identity.d.ts +32 -0
- package/src/serve/stamp-transport-identity.ts +2 -14
- package/src/server-error-page.d.ts +29 -0
- package/src/start-scheduled-jobs.d.ts +18 -0
- package/src/two-phase-boot.d.ts +136 -0
- package/src/two-phase-boot.ts +17 -85
- package/src/two-phase-health-gate.test.ts +2 -13
- package/src/types.d.ts +46 -0
- package/src/ui-service.d.ts +46 -0
- package/src/ws-boot-self-test.d.ts +19 -0
- package/src/auth-gate.test.ts +0 -70
- package/src/fn-routers/task-sync-close.test.ts +0 -44
- package/src/fn-routers/task-sync-close.ts +0 -82
- package/src/fn-routers/task-sync-lane.test.ts +0 -36
- package/src/handlers/sweep-host-cache.test.ts +0 -133
- package/src/serve/stamp-transport-identity.test.ts +0 -24
- package/src/two-phase-health-gate-client-only.test.ts +0 -77
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @system service-boot
|
|
3
|
+
* @status handwritten
|
|
4
|
+
* @edit edit directly
|
|
5
|
+
*
|
|
6
|
+
* The config contracts that PROGRAM a content gate. Each gated content type
|
|
7
|
+
* (agreement, proposal, …) is one ContentGateConfig + one AccessConfig — no
|
|
8
|
+
* bespoke gate functions per type; the engine (gate.ts) and the access mounter
|
|
9
|
+
* (access.ts) are the single shared primitive driven by these.
|
|
10
|
+
*/
|
|
11
|
+
type Resolved = Record<string, unknown>;
|
|
12
|
+
/** Drives the SSR-time gate (gate.ts / runContentGate). */
|
|
13
|
+
export interface ContentGateConfig {
|
|
14
|
+
/** Cookie that carries this gate's access token (e.g. "ag_token"). */
|
|
15
|
+
cookieName: string;
|
|
16
|
+
/**
|
|
17
|
+
* The gated resource id from the resolved graph, or "" when this gate does
|
|
18
|
+
* not apply to the current page (the engine then no-ops). This is also how a
|
|
19
|
+
* gate detects "is this my kind of page". Async to allow DB-backed resolution
|
|
20
|
+
* (e.g. agreement gate resolving the UUID from the page→agreement association
|
|
21
|
+
* when no pre-placed gate block exists).
|
|
22
|
+
*/
|
|
23
|
+
getResourceId(resolved: Resolved): string | Promise<string>;
|
|
24
|
+
/**
|
|
25
|
+
* Verify the cookie's token for this resource → the verified identity
|
|
26
|
+
* ({email, optional display name}), or null. Token-agnostic by design:
|
|
27
|
+
* proposals use the shared content-gate token; agreements keep their existing
|
|
28
|
+
* token (also minted by the signing ORPC), so the engine never assumes one
|
|
29
|
+
* token format. Allow-list gates return just {email}; the GPT lead-capture
|
|
30
|
+
* gate also returns the captured name (carried in its token).
|
|
31
|
+
*/
|
|
32
|
+
verifyToken(token: string | undefined, resourceId: string, nowMs: number): {
|
|
33
|
+
email: string;
|
|
34
|
+
name?: string;
|
|
35
|
+
} | null;
|
|
36
|
+
/**
|
|
37
|
+
* BAKED-IN unified auth. When a gate provides this resolver, the engine
|
|
38
|
+
* AUTOMATICALLY releases a logged-in viewer whose session email is in the
|
|
39
|
+
* authorized set — with no valid token and no per-gate code. This is the
|
|
40
|
+
* platform default for EVERY gated resource: any application surface with
|
|
41
|
+
* authentication gets "a signed-in, authorized viewer is never re-asked for
|
|
42
|
+
* their email/OTP" for free, just by exposing its authorized-email set (the
|
|
43
|
+
* same resolver its AccessConfig uses). Not called when the session is
|
|
44
|
+
* anonymous. Omit only for open-capture gates that have no authorized set.
|
|
45
|
+
*/
|
|
46
|
+
resolveAuthorizedEmails?(resourceId: string): Promise<Set<string>>;
|
|
47
|
+
/**
|
|
48
|
+
* OPTIONAL OVERRIDE of the baked-in session check above — for the rare gate
|
|
49
|
+
* whose session→identity rule isn't simply "session email ∈ authorized set".
|
|
50
|
+
* When present it wins; otherwise the engine uses `resolveAuthorizedEmails`.
|
|
51
|
+
* Called only when no valid access token is present.
|
|
52
|
+
*/
|
|
53
|
+
sessionAuthorize?(resolved: Resolved, resourceId: string): {
|
|
54
|
+
email: string;
|
|
55
|
+
name?: string;
|
|
56
|
+
} | null | Promise<{
|
|
57
|
+
email: string;
|
|
58
|
+
name?: string;
|
|
59
|
+
} | null>;
|
|
60
|
+
/** Reveal + seed the verified viewer's identity/session (token was valid). */
|
|
61
|
+
onAuthorized(resolved: Resolved, resourceId: string, identity: {
|
|
62
|
+
email: string;
|
|
63
|
+
name?: string;
|
|
64
|
+
}): void | Promise<void>;
|
|
65
|
+
/** Withhold content (strip/inject the gate) — token absent/invalid. Async-
|
|
66
|
+
* capable so a gate can load its display/behaviour settings from a registry
|
|
67
|
+
* row (DB-driven, not hardcoded); sync implementations remain valid. */
|
|
68
|
+
onUnauthorized(resolved: Resolved, resourceId: string): void | Promise<void>;
|
|
69
|
+
}
|
|
70
|
+
/** Drives the public access endpoint (access.ts / attachContentGateAccess). */
|
|
71
|
+
export interface AccessConfig {
|
|
72
|
+
/** Route to mount, e.g. "/api/proposal-access". */
|
|
73
|
+
path: string;
|
|
74
|
+
/** Cookie to set on a match. */
|
|
75
|
+
cookieName: string;
|
|
76
|
+
/** Cookie lifetime in ms (Max-Age). */
|
|
77
|
+
ttlMs: number;
|
|
78
|
+
/** Form field carrying the resource id, e.g. "proposalId". */
|
|
79
|
+
recordIdField: string;
|
|
80
|
+
/**
|
|
81
|
+
* Open lead-capture gate: ANY non-empty email is accepted (no allow-list).
|
|
82
|
+
* For surfaces whose "gate" captures a visitor rather than authorizing one
|
|
83
|
+
* against a fixed set (the public GPT). When true, `resolveAuthorizedEmails`
|
|
84
|
+
* is not called. Default/omitted = allow-list mode (proposals, agreements).
|
|
85
|
+
*/
|
|
86
|
+
openCapture?: boolean;
|
|
87
|
+
/**
|
|
88
|
+
* The authorized email set for a resource (lowercased), checked server-side.
|
|
89
|
+
* Not called when `openCapture` is true.
|
|
90
|
+
*/
|
|
91
|
+
resolveAuthorizedEmails(resourceId: string): Promise<Set<string>>;
|
|
92
|
+
/**
|
|
93
|
+
* Mint the access token for a matched email (token-agnostic per gate).
|
|
94
|
+
* `name` is the optional captured display name (open-capture gates carry it
|
|
95
|
+
* in the token; allow-list gates ignore it).
|
|
96
|
+
*/
|
|
97
|
+
signToken(resourceId: string, email: string, nowMs: number, name?: string): string | null;
|
|
98
|
+
}
|
|
99
|
+
export {};
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @system service-boot
|
|
3
|
+
* @status handwritten
|
|
4
|
+
* @edit edit directly
|
|
5
|
+
*
|
|
6
|
+
* The content-gate ENGINE. Runs in the page loader after the resource graph
|
|
7
|
+
* resolves, BEFORE SSR. Orchestration only — the per-type behaviour (which
|
|
8
|
+
* resource, who's authorized, what to seed, how to withhold) is supplied by a
|
|
9
|
+
* ContentGateConfig, so agreements/proposals/future gates are configs, not new
|
|
10
|
+
* functions. The single place that decides whether gated bytes reach the HTML.
|
|
11
|
+
*/
|
|
12
|
+
import type { ContentGateConfig } from "./config-types.ts";
|
|
13
|
+
export declare function runContentGate(resolved: Record<string, unknown>, cookieHeader: string | null, nowMs: number, config: ContentGateConfig): Promise<void>;
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @system service-boot
|
|
3
|
+
* @status handwritten
|
|
4
|
+
* @edit edit directly
|
|
5
|
+
*
|
|
6
|
+
* Parse a single cookie value out of a raw Cookie header — shared by the
|
|
7
|
+
* content-gate engine and any gate config.
|
|
8
|
+
*/
|
|
9
|
+
export declare function parseCookie(header: string | null, name: string): string | undefined;
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @system service-boot
|
|
3
|
+
* @status handwritten
|
|
4
|
+
* @edit edit directly
|
|
5
|
+
*
|
|
6
|
+
* The single signed, short-lived access token for EVERY content gate (agreement,
|
|
7
|
+
* proposal, and any future gated content). A gate withholds page content
|
|
8
|
+
* server-side until the request carries a valid token for that resource; this is
|
|
9
|
+
* the only thing that releases the content into the SSR, so without it a gated
|
|
10
|
+
* page is never readable/scrapable by a link holder.
|
|
11
|
+
*
|
|
12
|
+
* HMAC-SHA256 (Bun-native) over {c:cookieName, r:resourceId, e:email, x:exp}.
|
|
13
|
+
* `cookieName` is bound INTO the payload so a token minted for one gate
|
|
14
|
+
* (e.g. ag_token) can never satisfy another gate's check (e.g. prop_token).
|
|
15
|
+
*
|
|
16
|
+
* Secret resolver, in preference order: AUTH_SECRET → ENCRYPTION_KEY →
|
|
17
|
+
* DATABASE_URL (first one ≥16 chars). A gate signs AND verifies inside one
|
|
18
|
+
* service, so it only needs a stable per-deployment secret; the fallback keeps a
|
|
19
|
+
* gate working on a service that was never given AUTH_SECRET (e.g. the former
|
|
20
|
+
* public-only proposals viewer) instead of failing closed and locking out every
|
|
21
|
+
* authorized viewer. Any service that has AUTH_SECRET transparently prefers it.
|
|
22
|
+
* Fail-closed: no usable secret yields null (no token, no access).
|
|
23
|
+
*/
|
|
24
|
+
/** Mint a token proving `email` is authorized for `resourceId` under `cookieName`. */
|
|
25
|
+
export declare function signAccessToken(cookieName: string, resourceId: string, email: string, nowMs: number, ttlMs: number,
|
|
26
|
+
/**
|
|
27
|
+
* Optional display name to carry in the token (the public GPT lead-capture
|
|
28
|
+
* gate uses this so a returning visitor's name is known at SSR — first paint
|
|
29
|
+
* renders the full identity, not just the email). Allow-list gates
|
|
30
|
+
* (proposals/agreements) omit it.
|
|
31
|
+
*/
|
|
32
|
+
name?: string): string | null;
|
|
33
|
+
/**
|
|
34
|
+
* Validate a token for `cookieName` + `resourceId`. Returns the verified email
|
|
35
|
+
* on success, null otherwise (bad signature, wrong gate, wrong resource,
|
|
36
|
+
* expired, no secret).
|
|
37
|
+
*/
|
|
38
|
+
export declare function verifyAccessToken(token: string | undefined | null, cookieName: string, resourceId: string, nowMs: number): string | null;
|
|
39
|
+
/**
|
|
40
|
+
* Like `verifyAccessToken` but returns the full verified identity ({email, name})
|
|
41
|
+
* so a gate that carries a display name in the token (the public GPT lead-capture
|
|
42
|
+
* gate) can seed the visitor's name — not just the email — at SSR. Same
|
|
43
|
+
* signature/expiry/gate-binding checks; null on any failure.
|
|
44
|
+
*/
|
|
45
|
+
export declare function verifyAccessTokenIdentity(token: string | undefined | null, cookieName: string, resourceId: string, nowMs: number): {
|
|
46
|
+
email: string;
|
|
47
|
+
name?: string;
|
|
48
|
+
} | null;
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @system service-boot
|
|
3
|
+
* @status handwritten
|
|
4
|
+
* @edit edit directly
|
|
5
|
+
*
|
|
6
|
+
* Pure decision: does a CONTENT route (no resource_type) whose loader resolved
|
|
7
|
+
* a `page` body source warrant the branded not-found floor? Extracted from
|
|
8
|
+
* register-registry-page-route so the rule is unit-testable independent of the
|
|
9
|
+
* Hono/DB/graph machinery that wraps it (the fix's correctness does not depend
|
|
10
|
+
* on the publish — verify-before-done).
|
|
11
|
+
*
|
|
12
|
+
* Three outcomes:
|
|
13
|
+
* - no page row (deleted/unmatched path, e.g. /roadmap) → dead-link 404 floor
|
|
14
|
+
* - page row exists but zero content blocks → empty-page 200 floor
|
|
15
|
+
* - otherwise → null (render normally)
|
|
16
|
+
*
|
|
17
|
+
* The "Vision Toolbar" leak this closes: a content catchall synthesized an empty
|
|
18
|
+
* page for an unmatched path and served a cacheable 200; resource-not-found-is-
|
|
19
|
+
* the-root-floor only fired for resource_type routes, so dead content links fell
|
|
20
|
+
* through. See resource-not-found.ts for the floor + operator ruling 2026-07-21.
|
|
21
|
+
*/
|
|
22
|
+
import { PrimaryResourceMissingError } from "./resource-not-found.ts";
|
|
23
|
+
/**
|
|
24
|
+
* A page ROW exists but its body has zero content blocks — a content gap, not a
|
|
25
|
+
* dead link. True only when the row is present yet `puck_data` is absent or its
|
|
26
|
+
* `content` array is empty. Handles string (raw) and object (normalized) puck_data.
|
|
27
|
+
*/
|
|
28
|
+
export declare function pageBodyIsEmpty(page: unknown): boolean;
|
|
29
|
+
/**
|
|
30
|
+
* Decide whether a content route should fall to the branded not-found floor.
|
|
31
|
+
* Returns the error to throw (mapped to the floor by bind-page-handler), or null
|
|
32
|
+
* to render normally. `hasResourceType` routes are handled by the existing
|
|
33
|
+
* resource_type missing check (caller-side) — they return null here.
|
|
34
|
+
*/
|
|
35
|
+
export declare function decideContentPageFloor(opts: {
|
|
36
|
+
hasResourceType: boolean;
|
|
37
|
+
hasPageContentSource: boolean;
|
|
38
|
+
page: unknown;
|
|
39
|
+
}): PrimaryResourceMissingError | null;
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @system ui-service-boot
|
|
3
|
+
* @status handwritten
|
|
4
|
+
* @edit edit directly
|
|
5
|
+
*
|
|
6
|
+
* Surgical block discovery: at boot, queries every block_schema row in the
|
|
7
|
+
* registry whose componentPath starts with one of the service's declared
|
|
8
|
+
* block_packages, then dynamic-imports each one. Per-block try/catch — one
|
|
9
|
+
* dead componentPath logs and skips, the rest still register and the page
|
|
10
|
+
* renders the surviving blocks. This replaces the static
|
|
11
|
+
* `.scala-install/page-manifest.ts` codegen output, which had the failure
|
|
12
|
+
* mode of a single dead block_schema row crashing the whole manifest at
|
|
13
|
+
* compile time.
|
|
14
|
+
*
|
|
15
|
+
* Empty block_packages is NOT fatal here: it falls back to scanning all
|
|
16
|
+
* active block_schema (uninstalled packages skip via the per-block try/catch),
|
|
17
|
+
* so a service whose row is unpopulated but whose blocks are installed still
|
|
18
|
+
* renders. The real "booted with zero blocks" fail-closed is at the call site
|
|
19
|
+
* (loaded.length === 0 → BootFatalError). A DB-unreachable error still throws —
|
|
20
|
+
* no fallback to a package-side puckBlocks scan, which masked blockless boots.
|
|
21
|
+
*/
|
|
22
|
+
import type { RendererComponentEntry } from "./types.ts";
|
|
23
|
+
export interface DiscoveredBlocks {
|
|
24
|
+
components: Record<string, RendererComponentEntry>;
|
|
25
|
+
loaded: string[];
|
|
26
|
+
skipped: string[];
|
|
27
|
+
}
|
|
28
|
+
export declare function discoverBlocks(blockPackages: string[]): Promise<DiscoveredBlocks>;
|
package/src/discover-blocks.ts
CHANGED
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
import { existsSync } from "node:fs";
|
|
24
24
|
import { join } from "node:path";
|
|
25
25
|
import { BlockSchemaConfigSchema } from "@teamscala/db-validation/registry-schemas/block-schema";
|
|
26
|
-
import { getServerClient } from "
|
|
26
|
+
import { getServerClient } from "@teamscala/orpc/server-client-registry";
|
|
27
27
|
import * as v from "valibot";
|
|
28
28
|
import type { RendererComponentEntry } from "./types.ts";
|
|
29
29
|
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @system server-boot
|
|
3
|
+
* @status handwritten
|
|
4
|
+
* @edit edit directly
|
|
5
|
+
*
|
|
6
|
+
* Server-side roster expansion — the executor that handles "render N of block X
|
|
7
|
+
* per data row" so the page never needs a domain-specific panel/list block. A
|
|
8
|
+
* block authored with `props.dataRepeat: "parties"` is a TEMPLATE; before SSR
|
|
9
|
+
* this clones it once per roster item into its parent slot (top-level content or
|
|
10
|
+
* any Container's `content` slot), then drops the marker. Each clone:
|
|
11
|
+
* - sets `role` + `dataKey` to the item's key, so a prop-driven block (the
|
|
12
|
+
* SignatureField cell) finds its own party with no per-clone wiring;
|
|
13
|
+
* - substitutes `{{name}}` / `{{role}}` / `{{company}}` / `{{date}}` /
|
|
14
|
+
* `{{status}}` placeholders in any string prop (so a recipient row is plain
|
|
15
|
+
* `Container` + `Text` primitives — the copy lives on the page, not here).
|
|
16
|
+
* `{{status}}` resolves from the template's own `signedLabel` /
|
|
17
|
+
* `awaitingLabel` props (DB-driven copy), never hardcoded.
|
|
18
|
+
* Generic over any roster; the agreement page passes its parties.
|
|
19
|
+
*/
|
|
20
|
+
export interface RosterItem {
|
|
21
|
+
key: string;
|
|
22
|
+
role: string;
|
|
23
|
+
name: string;
|
|
24
|
+
title: string | null;
|
|
25
|
+
company: string | null;
|
|
26
|
+
signedAt: string | null;
|
|
27
|
+
signature: string | null;
|
|
28
|
+
}
|
|
29
|
+
/** Agreement-level tokens (one substitution, not per-party). */
|
|
30
|
+
export interface RosterMeta {
|
|
31
|
+
[token: string]: string;
|
|
32
|
+
}
|
|
33
|
+
/** Expand roster templates + bind agreement-meta placeholders across regions. */
|
|
34
|
+
export declare function expandRosterTemplates(resolved: Record<string, unknown>, parties: RosterItem[], meta?: RosterMeta): void;
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @system service-boot
|
|
3
|
+
* @status handwritten
|
|
4
|
+
* @edit edit directly
|
|
5
|
+
*
|
|
6
|
+
* Completion delivery. When an agreement is fully EXECUTED (every party has
|
|
7
|
+
* signed), email each party their executed copy + a note to download the
|
|
8
|
+
* Certificate of Completion. Each link is a per-party magic-link (no email gate,
|
|
9
|
+
* no OTP — see attach-agreement-magic.ts). Best-effort and self-contained: it
|
|
10
|
+
* loads its own data and swallows every error, so a send failure is logged and
|
|
11
|
+
* NEVER undoes the signature (the payment-setup non-fatal rule, applied to mail).
|
|
12
|
+
* Fire-and-forget from the sign handler: `void sendAgreementCompletionEmails(...)`.
|
|
13
|
+
*/
|
|
14
|
+
export declare function sendAgreementCompletionEmails(agreementId: string, baseUrl: string): Promise<void>;
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @system service-boot
|
|
3
|
+
* @status handwritten
|
|
4
|
+
* @edit edit directly
|
|
5
|
+
*
|
|
6
|
+
* fn.agreementSend.send — authenticated "send for signature" procedure. Emails
|
|
7
|
+
* each party of an agreement a link to its signing page, stamps the lifecycle
|
|
8
|
+
* (sent_to / sent_at, status draft→sent), and returns a per-recipient result.
|
|
9
|
+
*
|
|
10
|
+
* Off-the-shelf path per building-applications: this is server logic beyond
|
|
11
|
+
* CRUD, so it is a typed ORPC procedure (not a bespoke endpoint), and it sends
|
|
12
|
+
* through the shared Resend adapter (@teamscala/api-resend) — the same surface
|
|
13
|
+
* @teamscala/auth uses for OTP — never a new email integration.
|
|
14
|
+
*
|
|
15
|
+
* Per-org sender: emails go FROM the org's display name on the platform's
|
|
16
|
+
* verified Resend domain ("<Org> via Sign <verified-addr>"), with reply_to set
|
|
17
|
+
* to the org's contact_email, so replies reach the org without each org needing
|
|
18
|
+
* its own verified domain. When an org later verifies its own sending domain,
|
|
19
|
+
* resolveSender is the single place to switch the FROM address.
|
|
20
|
+
*
|
|
21
|
+
* Sending is privileged (it reaches real inboxes), so the procedure requires an
|
|
22
|
+
* authenticated caller — the localhost super-admin bypass authorises operator /
|
|
23
|
+
* portal-SSR callers; the public signing page cannot invoke it.
|
|
24
|
+
*/
|
|
25
|
+
import * as v from "valibot";
|
|
26
|
+
interface User {
|
|
27
|
+
id: string;
|
|
28
|
+
organisationId: string | null;
|
|
29
|
+
}
|
|
30
|
+
interface Context {
|
|
31
|
+
user: User | null | undefined;
|
|
32
|
+
headers: Headers;
|
|
33
|
+
resolveUser?: (headers: Headers, prisma: any) => Promise<User | null>;
|
|
34
|
+
prisma: any;
|
|
35
|
+
}
|
|
36
|
+
export declare const agreementSendRouter: {
|
|
37
|
+
send: import("@orpc/server").DecoratedProcedure<import("@orpc/server").MergedInitialContext<Context & Record<never, never>, Context, Context>, import("@orpc/server").MergedCurrentContext<Context, {
|
|
38
|
+
headers: Headers;
|
|
39
|
+
resolveUser?: (headers: Headers, prisma: any) => Promise<User | null>;
|
|
40
|
+
prisma: any;
|
|
41
|
+
user: User;
|
|
42
|
+
}>, v.ObjectSchema<{
|
|
43
|
+
readonly agreementId: v.StringSchema<undefined>;
|
|
44
|
+
/** Public base URL of the signing site, e.g. https://sign-dev.scala.business (no trailing slash). */
|
|
45
|
+
readonly baseUrl: v.StringSchema<undefined>;
|
|
46
|
+
}, undefined>, import("@orpc/contract").Schema<{
|
|
47
|
+
ok: false;
|
|
48
|
+
error: string;
|
|
49
|
+
sentAt?: undefined;
|
|
50
|
+
url?: undefined;
|
|
51
|
+
sent?: undefined;
|
|
52
|
+
} | {
|
|
53
|
+
error?: undefined;
|
|
54
|
+
ok: boolean;
|
|
55
|
+
sentAt: string | null;
|
|
56
|
+
url: string;
|
|
57
|
+
sent: {
|
|
58
|
+
email: string;
|
|
59
|
+
ok: boolean;
|
|
60
|
+
id?: string;
|
|
61
|
+
error?: string;
|
|
62
|
+
}[];
|
|
63
|
+
}, {
|
|
64
|
+
ok: false;
|
|
65
|
+
error: string;
|
|
66
|
+
sentAt?: undefined;
|
|
67
|
+
url?: undefined;
|
|
68
|
+
sent?: undefined;
|
|
69
|
+
} | {
|
|
70
|
+
error?: undefined;
|
|
71
|
+
ok: boolean;
|
|
72
|
+
sentAt: string | null;
|
|
73
|
+
url: string;
|
|
74
|
+
sent: {
|
|
75
|
+
email: string;
|
|
76
|
+
ok: boolean;
|
|
77
|
+
id?: string;
|
|
78
|
+
error?: string;
|
|
79
|
+
}[];
|
|
80
|
+
}>, Record<never, never>, Record<never, never>>;
|
|
81
|
+
};
|
|
82
|
+
export {};
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @system service-boot
|
|
3
|
+
* @status handwritten
|
|
4
|
+
* @edit edit directly
|
|
5
|
+
*
|
|
6
|
+
* `fn.aiHealth` — the AI-availability probe the shared chat hook
|
|
7
|
+
* (`useAIHealthCheck`) polls before showing the chat's health dot. It resolves
|
|
8
|
+
* the same DB-driven default model the chat engine uses (`ai-default-model`
|
|
9
|
+
* config → an active `llm_model` row) and reports `{status, mcp, gateway}`;
|
|
10
|
+
* `status:"ok"` means the chat has a usable model configured.
|
|
11
|
+
*
|
|
12
|
+
* Unauthed (a public GPT surface polls it too) and a LIGHTWEIGHT registry read
|
|
13
|
+
* via the request `prisma` — deliberately NO `@teamscala/chat-completion` import,
|
|
14
|
+
* so wiring this universal procedure never pulls the AI stack into every
|
|
15
|
+
* service. Registered into the `fn` namespace by registerFnRouters, so any
|
|
16
|
+
* chat-capable service answers it instead of 404-ing.
|
|
17
|
+
*/
|
|
18
|
+
interface Context {
|
|
19
|
+
prisma: {
|
|
20
|
+
registry_entries: {
|
|
21
|
+
findFirst: (args: unknown) => Promise<{
|
|
22
|
+
config?: unknown;
|
|
23
|
+
id?: string;
|
|
24
|
+
} | null>;
|
|
25
|
+
};
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
export interface AiHealthResponse {
|
|
29
|
+
status: "ok" | "error";
|
|
30
|
+
mcp: boolean;
|
|
31
|
+
gateway: boolean;
|
|
32
|
+
error?: string;
|
|
33
|
+
}
|
|
34
|
+
export declare const aiHealthHandler: import("@orpc/server").DecoratedProcedure<Context & Record<never, never>, Context, import("@orpc/contract").Schema<unknown, unknown>, import("@orpc/contract").Schema<AiHealthResponse, AiHealthResponse>, Record<never, never>, Record<never, never>>;
|
|
35
|
+
export {};
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @system service-boot
|
|
3
|
+
* @status handwritten
|
|
4
|
+
* @edit edit directly
|
|
5
|
+
*
|
|
6
|
+
* ORPC procedures for auth checks (isOrgAdmin, resolveAdminOverride).
|
|
7
|
+
* Extracted from @teamscala/orpc/fn-router — primitives tier must not
|
|
8
|
+
* contain application-specific auth logic.
|
|
9
|
+
*/
|
|
10
|
+
interface User {
|
|
11
|
+
id: string;
|
|
12
|
+
name?: string | null;
|
|
13
|
+
email?: string;
|
|
14
|
+
organisationId: string | null;
|
|
15
|
+
}
|
|
16
|
+
interface Context {
|
|
17
|
+
user: User | null | undefined;
|
|
18
|
+
headers: Headers;
|
|
19
|
+
resolveUser?: (headers: Headers, prisma: any) => Promise<User | null>;
|
|
20
|
+
prisma: any;
|
|
21
|
+
orgId?: string | null;
|
|
22
|
+
}
|
|
23
|
+
declare const authed: import("@orpc/server").BuilderWithMiddlewares<import("@orpc/server").MergedInitialContext<Context & Record<never, never>, Context, Context>, import("@orpc/server").MergedCurrentContext<Context, {
|
|
24
|
+
headers: Headers;
|
|
25
|
+
resolveUser?: (headers: Headers, prisma: any) => Promise<User | null>;
|
|
26
|
+
prisma: any;
|
|
27
|
+
user: User;
|
|
28
|
+
orgId: string | null | undefined;
|
|
29
|
+
}>, import("@orpc/contract").Schema<unknown, unknown>, import("@orpc/contract").Schema<unknown, unknown>, Record<never, never>, Record<never, never>>;
|
|
30
|
+
export declare const authRouter: {
|
|
31
|
+
isOrgAdmin: import("@orpc/server").DecoratedProcedure<import("@orpc/server").MergedInitialContext<Context & Record<never, never>, Context, Context>, import("@orpc/server").MergedCurrentContext<Context, {
|
|
32
|
+
headers: Headers;
|
|
33
|
+
resolveUser?: (headers: Headers, prisma: any) => Promise<User | null>;
|
|
34
|
+
prisma: any;
|
|
35
|
+
user: User;
|
|
36
|
+
orgId: string | null | undefined;
|
|
37
|
+
}>, import("@orpc/contract").Schema<unknown, unknown>, import("@orpc/contract").Schema<boolean, boolean>, Record<never, never>, Record<never, never>>;
|
|
38
|
+
resolveAdminOverride: import("@orpc/server").DecoratedProcedure<import("@orpc/server").MergedInitialContext<Context & Record<never, never>, Context, Context>, import("@orpc/server").MergedCurrentContext<Context, {
|
|
39
|
+
headers: Headers;
|
|
40
|
+
resolveUser?: (headers: Headers, prisma: any) => Promise<User | null>;
|
|
41
|
+
prisma: any;
|
|
42
|
+
user: User;
|
|
43
|
+
orgId: string | null | undefined;
|
|
44
|
+
}>, import("@orpc/contract").Schema<unknown, unknown>, import("@orpc/contract").Schema<string | null, string | null>, Record<never, never>, Record<never, never>>;
|
|
45
|
+
};
|
|
46
|
+
export type { Context, User };
|
|
47
|
+
export { authed };
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @system service-boot
|
|
3
|
+
* @status handwritten
|
|
4
|
+
* @edit edit directly
|
|
5
|
+
*
|
|
6
|
+
* `fn.cacheAdmin` — ORPC procedures for in-process cache enable/disable/flush.
|
|
7
|
+
* Replaces the former `/api/data/cache-monitor/*` HANDLER_MAP entries
|
|
8
|
+
* (orpc-is-the-only-api: every API surface is a typed ORPC procedure, never a
|
|
9
|
+
* hand-written Hono route). Calls through @teamscala/cache/registry — the
|
|
10
|
+
* platform-singleton cache surface (cache-is-the-only-cache).
|
|
11
|
+
*/
|
|
12
|
+
import * as v from "valibot";
|
|
13
|
+
export declare const cacheAdminRouter: {
|
|
14
|
+
enable: import("@orpc/server").DecoratedProcedure<import("@orpc/server").MergedInitialContext<import("./auth-router.ts").Context & Record<never, never>, import("./auth-router.ts").Context, import("./auth-router.ts").Context>, import("@orpc/server").MergedCurrentContext<import("./auth-router.ts").Context, {
|
|
15
|
+
headers: Headers;
|
|
16
|
+
resolveUser?: (headers: Headers, prisma: any) => Promise<import("./auth-router.ts").User | null>;
|
|
17
|
+
prisma: any;
|
|
18
|
+
user: import("./auth-router.ts").User;
|
|
19
|
+
orgId: string | null | undefined;
|
|
20
|
+
}>, v.ObjectSchema<{
|
|
21
|
+
readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
22
|
+
}, undefined>, import("@orpc/contract").Schema<{
|
|
23
|
+
ok: boolean;
|
|
24
|
+
name: string;
|
|
25
|
+
}, {
|
|
26
|
+
ok: boolean;
|
|
27
|
+
name: string;
|
|
28
|
+
}>, Record<never, never>, Record<never, never>>;
|
|
29
|
+
disable: import("@orpc/server").DecoratedProcedure<import("@orpc/server").MergedInitialContext<import("./auth-router.ts").Context & Record<never, never>, import("./auth-router.ts").Context, import("./auth-router.ts").Context>, import("@orpc/server").MergedCurrentContext<import("./auth-router.ts").Context, {
|
|
30
|
+
headers: Headers;
|
|
31
|
+
resolveUser?: (headers: Headers, prisma: any) => Promise<import("./auth-router.ts").User | null>;
|
|
32
|
+
prisma: any;
|
|
33
|
+
user: import("./auth-router.ts").User;
|
|
34
|
+
orgId: string | null | undefined;
|
|
35
|
+
}>, v.ObjectSchema<{
|
|
36
|
+
readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
37
|
+
}, undefined>, import("@orpc/contract").Schema<{
|
|
38
|
+
ok: boolean;
|
|
39
|
+
name: string;
|
|
40
|
+
}, {
|
|
41
|
+
ok: boolean;
|
|
42
|
+
name: string;
|
|
43
|
+
}>, Record<never, never>, Record<never, never>>;
|
|
44
|
+
flush: import("@orpc/server").DecoratedProcedure<import("@orpc/server").MergedInitialContext<import("./auth-router.ts").Context & Record<never, never>, import("./auth-router.ts").Context, import("./auth-router.ts").Context>, import("@orpc/server").MergedCurrentContext<import("./auth-router.ts").Context, {
|
|
45
|
+
headers: Headers;
|
|
46
|
+
resolveUser?: (headers: Headers, prisma: any) => Promise<import("./auth-router.ts").User | null>;
|
|
47
|
+
prisma: any;
|
|
48
|
+
user: import("./auth-router.ts").User;
|
|
49
|
+
orgId: string | null | undefined;
|
|
50
|
+
}>, v.ObjectSchema<{
|
|
51
|
+
readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
52
|
+
}, undefined>, import("@orpc/contract").Schema<{
|
|
53
|
+
flushed: number;
|
|
54
|
+
}, {
|
|
55
|
+
flushed: number;
|
|
56
|
+
}>, Record<never, never>, Record<never, never>>;
|
|
57
|
+
};
|