npm - @spacefast/common - Versions diffs - 0.0.9 → 0.0.11 - Mend

@spacefast/common 0.0.9 → 0.0.11

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 (78) hide show

package/dist/contracts/activity.d.ts +1 -1
package/dist/contracts/activity.js +11 -6
package/dist/contracts/annotations.d.ts +2 -0
package/dist/contracts/annotations.js +2 -1
package/dist/contracts/api-keys.d.ts +4 -0
package/dist/contracts/api-keys.js +4 -0
package/dist/contracts/archives.d.ts +2 -8
package/dist/contracts/archives.js +3 -8
package/dist/contracts/builds.d.ts +1 -0
package/dist/contracts/builds.js +5 -0
package/dist/contracts/comments.d.ts +309 -0
package/dist/contracts/comments.js +200 -0
package/dist/contracts/device-auth.d.ts +221 -1
package/dist/contracts/device-auth.js +106 -4
package/dist/contracts/device-team-scope.d.ts +10 -0
package/dist/contracts/device-team-scope.js +17 -0
package/dist/contracts/error-code-meta.d.ts +52 -0
package/dist/contracts/error-code-meta.js +13 -0
package/dist/contracts/error-codes.d.ts +1 -1
package/dist/contracts/error-codes.js +13 -0
package/dist/contracts/features.d.ts +37 -38
package/dist/contracts/features.js +51 -59
package/dist/contracts/generated-feature-launch-entries.d.ts +2 -2
package/dist/contracts/generated-feature-launch-entries.js +6 -6
package/dist/contracts/ids.d.ts +1 -1
package/dist/contracts/ids.js +1 -1
package/dist/contracts/oauth-resources.d.ts +7 -0
package/dist/contracts/oauth-resources.js +10 -2
package/dist/contracts/operations.d.ts +1 -3
package/dist/contracts/operations.js +5 -1
package/dist/contracts/pages.d.ts +70 -0
package/dist/contracts/pages.js +89 -0
package/dist/contracts/publishes.d.ts +5 -0
package/dist/contracts/publishes.js +25 -8
package/dist/contracts/resources.d.ts +14 -62
package/dist/contracts/runtime-api.d.ts +13 -15
package/dist/contracts/runtime-api.js +12 -70
package/dist/contracts/space-config.d.ts +32 -90
package/dist/contracts/space-config.js +49 -54
package/dist/contracts/spaces.d.ts +47 -187
package/dist/contracts/spaces.js +19 -3
package/dist/contracts/superadmin-spaces.d.ts +14 -62
package/dist/contracts/superadmin-teams.d.ts +79 -0
package/dist/contracts/superadmin-teams.js +36 -0
package/dist/contracts/superadmin.d.ts +2 -0
package/dist/contracts/superadmin.js +1 -0
package/dist/contracts/teams.d.ts +1 -0
package/dist/contracts/teams.js +8 -0
package/dist/contracts/theme-json.js +4 -5
package/dist/dashboard-paths/index.d.ts +31 -0
package/dist/dashboard-paths/index.js +80 -0
package/dist/docs/agent-handoff-document.d.ts +15 -0
package/dist/docs/agent-handoff-document.js +179 -0
package/dist/docs/agent-setup.d.ts +12 -1
package/dist/docs/agent-setup.js +30 -16
package/dist/docs/catalog.d.ts +2 -2
package/dist/docs/catalog.js +2 -2
package/dist/docs/error-docs.js +52 -0
package/dist/utils/asset-fingerprint.d.ts +53 -0
package/dist/utils/asset-fingerprint.js +574 -0
package/dist/utils/credential-policy.d.ts +5 -0
package/dist/utils/credential-policy.js +31 -8
package/dist/utils/pages.d.ts +53 -0
package/dist/utils/pages.js +274 -0
package/dist/utils/query-keys.d.ts +4 -3
package/dist/utils/query-keys.js +4 -3
package/dist/utils/space-config.d.ts +2 -2
package/dist/utils/space-config.js +1 -1
package/dist/utils/wpcom-auth-redirects.d.ts +0 -4
package/dist/utils/wpcom-auth-redirects.js +0 -6
package/dist/vocabulary.d.ts +2 -2
package/package.json +6 -1
package/dist/contracts/space-theme.d.ts +0 -25
package/dist/contracts/space-theme.js +0 -49
package/dist/utils/gate-theme.d.ts +0 -61
package/dist/utils/gate-theme.js +0 -217
package/dist/utils/space-theme.d.ts +0 -18
package/dist/utils/space-theme.js +0 -98

package/dist/utils/pages.d.ts ADDED Viewed

@@ -0,0 +1,53 @@
+import { type CustomPageId, type SitePageId } from "../contracts/pages.js";
+export type PageTheme = {
+    accent?: string | undefined;
+    background?: string | undefined;
+    font?: string | undefined;
+    logo?: string | undefined;
+    name?: string | undefined;
+    hideSpacefastBranding?: boolean | undefined;
+};
+export type PageFileEntry = {
+    name: string;
+    href: string;
+    size?: string;
+    directory?: boolean;
+};
+export type PagePreviewFile = {
+    name: string;
+    href: string;
+    downloadHref?: string;
+    size?: string;
+    mime?: string;
+};
+export type PageExpansionContext = {
+    page: SitePageId | "layout";
+    theme?: PageTheme;
+    content?: string;
+    passwordAction?: string;
+    passwordError?: string;
+    loginHref?: string;
+    files?: readonly PageFileEntry[];
+    file?: PagePreviewFile;
+};
+export type PageDiagnostic = {
+    severity: "warning" | "error";
+    code: "page_source_too_large" | "unknown_page_template" | "unknown_page_element" | "page_element_not_allowed" | "page_document_required" | "layout_missing_content" | "password_form_missing" | "index_files_missing" | "page_indexable";
+    message: string;
+    path: string;
+};
+export declare function escapePageHtml(value: string): string;
+export declare function expandPageHtml(source: string, context: PageExpansionContext): string;
+export declare function validatePageSources(input: {
+    pages: Readonly<Record<string, string>>;
+    layouts?: Readonly<Record<string, string>>;
+}): PageDiagnostic[];
+export declare function isCompleteHtmlDocument(source: string): boolean;
+export declare function applyPageLayout(layout: string | null, content: string, context: Omit<PageExpansionContext, "page" | "content">): string;
+export declare function inferPageThemeFromThemeJson(raw: string): Partial<PageTheme>;
+export declare function defaultPageBody(id: SitePageId): string;
+export declare const DEFAULT_PAGE_TEMPLATES: Readonly<Record<SitePageId, string>>;
+export declare const DEFAULT_LAYOUT_TEMPLATE = "<!doctype html>\n<html lang=\"en\">\n<head><meta charset=\"utf-8\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1\"><title><sf-name></sf-name></title></head>\n<body>\n  <header><a href=\"/\"><sf-logo></sf-logo><sf-name></sf-name></a></header>\n  <main><sf-content></sf-content></main>\n</body>\n</html>\n";
+export declare function defaultPageTemplate(id: SitePageId): string;
+export declare function pageIdFromFilename(filename: string): CustomPageId | null;
+export declare function allDefaultPageTemplates(): Readonly<Record<SitePageId, string>>;

package/dist/utils/pages.js ADDED Viewed

@@ -0,0 +1,274 @@
+import { CUSTOM_PAGE_IDS, PAGE_ELEMENTS, PAGE_LAYOUT_FILE, PAGE_SOURCE_MAX_BYTES, SITE_PAGE_IDS, } from "../contracts/pages.js";
+const encoder = new TextEncoder();
+const knownElements = new Set(PAGE_ELEMENTS);
+const customPageIds = new Set(CUSTOM_PAGE_IDS);
+export function escapePageHtml(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#039;");
+}
+function themeStyle(theme) {
+    const declarations = [
+        theme.accent ? `--sf-accent:${theme.accent}` : "",
+        theme.background ? `--sf-bg:${theme.background}` : "",
+        theme.font ? `--sf-font:${theme.font}` : "",
+    ].filter(Boolean);
+    return declarations.length > 0 ? `<style>:root{${declarations.join(";")}}</style>` : "";
+}
+function renderFiles(files) {
+    if (files.length === 0)
+        return '<p class="sf-empty">Nothing here yet.</p>';
+    return `<ul class="sf-files">${files
+        .map((file) => `<li><a href="${escapePageHtml(file.href)}">${file.directory ? "↳ " : ""}${escapePageHtml(file.name)}</a>${file.size ? `<span>${escapePageHtml(file.size)}</span>` : ""}</li>`)
+        .join("")}</ul>`;
+}
+function renderFile(file) {
+    if (!file)
+        return '<p class="sf-empty">File unavailable.</p>';
+    const href = escapePageHtml(file.href);
+    const image = file.mime?.startsWith("image/")
+        ? `<img class="sf-preview" src="${href}" alt="${escapePageHtml(file.name)}">`
+        : `<iframe class="sf-preview" src="${href}" title="${escapePageHtml(file.name)}"></iframe>`;
+    return `${image}<dl class="sf-file-meta"><div><dt>Name</dt><dd>${escapePageHtml(file.name)}</dd></div>${file.size ? `<div><dt>Size</dt><dd>${escapePageHtml(file.size)}</dd></div>` : ""}${file.mime ? `<div><dt>Type</dt><dd>${escapePageHtml(file.mime)}</dd></div>` : ""}</dl><a class="sf-button" href="${escapePageHtml(file.downloadHref ?? file.href)}" download>Download</a>`;
+}
+function renderElement(element, context) {
+    switch (element) {
+        case "sf-content":
+            return context.content ?? "";
+        case "sf-password-form":
+            return `${context.passwordError ? `<p class="sf-error" role="alert">${escapePageHtml(context.passwordError)}</p>` : ""}<form class="sf-form" method="post" action="${escapePageHtml(context.passwordAction ?? "")}"><label>Password<input name="_pw" type="password" required autocomplete="current-password"></label><button type="submit">Continue</button></form>`;
+        case "sf-login":
+            return `<a class="sf-button" href="${escapePageHtml(context.loginHref ?? "/__spacefast/access/login")}">Log in</a>`;
+        case "sf-files":
+            return renderFiles(context.files ?? []);
+        case "sf-file":
+            return renderFile(context.file);
+        case "sf-logo":
+            return context.theme?.logo
+                ? `<img class="sf-logo" src="${escapePageHtml(context.theme.logo)}" alt="">`
+                : "";
+        case "sf-name":
+            return escapePageHtml(context.theme?.name ?? "This space");
+    }
+    return "";
+}
+const ELEMENT_PATTERN = /<\s*(sf-[a-z0-9-]+)\b[^>]*>(?:\s*<\s*\/\s*\1\s*>)?|<\s*(sf-[a-z0-9-]+)\b[^>]*\/\s*>/gi;
+export function expandPageHtml(source, context) {
+    let output = source.replace(ELEMENT_PATTERN, (_match, paired, unary) => {
+        const name = (paired ?? unary)?.toLowerCase();
+        return name && knownElements.has(name) ? renderElement(name, context) : _match;
+    });
+    const tokens = themeStyle(context.theme ?? {});
+    if (tokens) {
+        output = /<\s*\/\s*head\s*>/i.test(output)
+            ? output.replace(/<\s*\/\s*head\s*>/i, `${tokens}</head>`)
+            : `${tokens}${output}`;
+    }
+    return output;
+}
+function foundElements(source) {
+    const result = new Set();
+    for (const match of source.matchAll(/<\s*(sf-[a-z0-9-]+)\b/gi))
+        result.add((match[1] ?? "").toLowerCase());
+    return [...result];
+}
+export function validatePageSources(input) {
+    const diagnostics = [];
+    for (const [sourcePath, source] of Object.entries(input.pages)) {
+        const path = sourcePath.includes("_pages/") ? sourcePath : `_pages/${sourcePath}`;
+        const filename = path.slice(path.lastIndexOf("_pages/") + 7);
+        const id = filename.replace(/\.html$/i, "");
+        if (!customPageIds.has(id) || filename !== `${id}.html`) {
+            diagnostics.push({
+                severity: "error",
+                code: "unknown_page_template",
+                message: `${path} is not a supported page template.`,
+                path,
+            });
+            continue;
+        }
+        if (encoder.encode(source).length > PAGE_SOURCE_MAX_BYTES) {
+            diagnostics.push({
+                severity: "error",
+                code: "page_source_too_large",
+                message: `${path} exceeds the ${PAGE_SOURCE_MAX_BYTES} byte limit.`,
+                path,
+            });
+        }
+        if (!isCompleteHtmlDocument(source))
+            diagnostics.push({
+                severity: "error",
+                code: "page_document_required",
+                message: `${path} must be a complete HTML document beginning with <!doctype html>.`,
+                path,
+            });
+        for (const element of foundElements(source)) {
+            if (!knownElements.has(element))
+                diagnostics.push({
+                    severity: "error",
+                    code: "unknown_page_element",
+                    message: `Unknown Pages element <${element}>.`,
+                    path,
+                });
+            const allowed = element === "sf-logo" ||
+                element === "sf-name" ||
+                (id === "password" && element === "sf-password-form") ||
+                (id === "index" && element === "sf-files") ||
+                (id === "preview" && element === "sf-file");
+            if (knownElements.has(element) && !allowed)
+                diagnostics.push({
+                    severity: "error",
+                    code: "page_element_not_allowed",
+                    message: `<${element}> is not valid in the ${id} page.`,
+                    path,
+                });
+        }
+        if (id === "password" &&
+            !/<\s*sf-password-form\b/i.test(source) &&
+            !/<\s*input\b[^>]*\bname\s*=\s*["']_pw["']/i.test(source)) {
+            diagnostics.push({
+                severity: "error",
+                code: "password_form_missing",
+                message: "The password page needs <sf-password-form> or a form input named _pw.",
+                path,
+            });
+        }
+        if (id === "index" && !/<\s*sf-files\b/i.test(source))
+            diagnostics.push({
+                severity: "warning",
+                code: "index_files_missing",
+                message: "The index page does not render <sf-files>.",
+                path,
+            });
+        if ((id === "password" || id === "denied") &&
+            /<\s*meta\b[^>]*\bname\s*=\s*["']robots["'][^>]*\bcontent\s*=\s*["'][^"']*\bindex\b/i.test(source))
+            diagnostics.push({
+                severity: "warning",
+                code: "page_indexable",
+                message: "Gate pages are served with noindex and should not declare themselves indexable.",
+                path,
+            });
+    }
+    for (const [path, source] of Object.entries(input.layouts ?? {})) {
+        if (encoder.encode(source).length > PAGE_SOURCE_MAX_BYTES)
+            diagnostics.push({
+                severity: "error",
+                code: "page_source_too_large",
+                message: `${path} exceeds the ${PAGE_SOURCE_MAX_BYTES} byte limit.`,
+                path,
+            });
+        const elements = foundElements(source);
+        for (const element of elements) {
+            if (!knownElements.has(element))
+                diagnostics.push({
+                    severity: "error",
+                    code: "unknown_page_element",
+                    message: `Unknown Pages element <${element}>.`,
+                    path,
+                });
+            else if (element !== "sf-content" && element !== "sf-logo" && element !== "sf-name")
+                diagnostics.push({
+                    severity: "error",
+                    code: "page_element_not_allowed",
+                    message: `<${element}> is not valid in _layout.html.`,
+                    path,
+                });
+        }
+        const contentCount = [...source.matchAll(/<\s*sf-content\b/gi)].length;
+        if (contentCount !== 1)
+            diagnostics.push({
+                severity: "error",
+                code: "layout_missing_content",
+                message: `${PAGE_LAYOUT_FILE} needs exactly one <sf-content> element.`,
+                path,
+            });
+    }
+    return diagnostics;
+}
+export function isCompleteHtmlDocument(source) {
+    return /^\s*<!doctype\s+html\b/i.test(source);
+}
+export function applyPageLayout(layout, content, context) {
+    if (!layout || isCompleteHtmlDocument(content))
+        return expandPageHtml(content, { ...context, page: "layout" });
+    return expandPageHtml(layout, { ...context, page: "layout", content });
+}
+export function inferPageThemeFromThemeJson(raw) {
+    try {
+        const value = JSON.parse(raw);
+        if (!value || typeof value !== "object")
+            return {};
+        const settings = value.settings;
+        if (!settings || typeof settings !== "object")
+            return {};
+        const color = settings.color;
+        const typography = settings.typography;
+        const palette = color && typeof color === "object" ? color.palette : null;
+        const fonts = typography && typeof typography === "object"
+            ? typography.fontFamilies
+            : null;
+        const inferred = {};
+        if (Array.isArray(palette)) {
+            for (const entry of palette) {
+                if (!entry || typeof entry !== "object")
+                    continue;
+                const slug = entry.slug;
+                const entryColor = entry.color;
+                if (typeof entryColor !== "string")
+                    continue;
+                if ((slug === "accent" || slug === "primary") && inferred.accent === undefined)
+                    inferred.accent = entryColor;
+                if (slug === "background")
+                    inferred.background = entryColor;
+            }
+        }
+        if (Array.isArray(fonts)) {
+            const first = fonts.find((entry) => entry &&
+                typeof entry === "object" &&
+                typeof entry.fontFamily === "string");
+            if (first)
+                inferred.font = first.fontFamily;
+        }
+        return inferred;
+    }
+    catch {
+        return {};
+    }
+}
+export function defaultPageBody(id) {
+    const source = DEFAULT_PAGE_TEMPLATES[id];
+    return source.match(/<body[^>]*>([\s\S]*?)<\/body>/i)?.[1] ?? source;
+}
+const sharedCss = `:root{color-scheme:light dark;--sf-accent:#ff603d;--sf-bg:#faf9f7;--sf-fg:#1c1b1a;--sf-muted:#6b6862;--sf-card:#fff;--sf-border:#e5e2dc;--sf-font:Inter,ui-sans-serif,system-ui,sans-serif}*{box-sizing:border-box}body{margin:0;background:var(--sf-bg);color:var(--sf-fg);font:16px/1.55 var(--sf-font);min-height:100vh;display:grid;place-items:center;padding:24px}.sf-shell{width:min(100%,640px)}.sf-card{background:var(--sf-card);border:1px solid var(--sf-border);border-radius:18px;padding:clamp(24px,5vw,48px);box-shadow:0 18px 55px #1c1b1a12}h1{font-size:clamp(2rem,7vw,3.5rem);line-height:1;letter-spacing:-.05em;margin:16px 0}p{color:var(--sf-muted)}a{color:var(--sf-accent)}.sf-brand{display:flex;align-items:center;gap:10px;font-weight:650}.sf-logo{width:28px;height:28px;object-fit:contain}.sf-badge{margin-top:28px;font-size:12px;color:var(--sf-muted)}.sf-badge a{text-decoration:none}.sf-form label{display:grid;gap:8px;font-weight:600}.sf-form input{width:100%;margin-top:6px;padding:12px 14px;border:1px solid var(--sf-border);border-radius:10px;background:transparent;color:inherit;font:inherit}.sf-form button,.sf-button{display:inline-block;border:0;border-radius:10px;background:var(--sf-accent);color:#fff;padding:12px 16px;font:600 14px/1 var(--sf-font);text-decoration:none;margin-top:14px;cursor:pointer}.sf-error{color:#b42318}.sf-files{list-style:none;padding:0;margin:24px 0}.sf-files li{display:flex;border-top:1px solid var(--sf-border)}.sf-files a{padding:12px 0;flex:1;text-decoration:none}.sf-files span{padding:12px 0;color:var(--sf-muted);font-size:13px}.sf-preview{width:100%;min-height:320px;border:1px solid var(--sf-border);border-radius:10px;object-fit:contain;background:#fff}.sf-file-meta div{display:flex;justify-content:space-between;border-bottom:1px solid var(--sf-border);padding:8px 0}.sf-file-meta dt{color:var(--sf-muted)}.sf-file-meta dd{margin:0}@media(prefers-color-scheme:dark){:root{--sf-bg:#16151a;--sf-fg:#e8e6e3;--sf-muted:#a8a49c;--sf-card:#1e1d23;--sf-border:#343239}.sf-card{box-shadow:0 18px 55px #0005}}`;
+function document(title, body, noindex = false) {
+    return `<!doctype html>\n<html lang="en">\n<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">${noindex ? '<meta name="robots" content="noindex">' : ""}<title>${title}</title><style>${sharedCss}</style></head>\n<body><main class="sf-shell"><section class="sf-card">${body}</section></main></body>\n</html>\n`;
+}
+const badge = '<p class="sf-badge">Hosted with <a href="https://spacefast.com">Spacefast</a></p>';
+export const DEFAULT_PAGE_TEMPLATES = {
+    "404": document("Page not found", '<div class="sf-brand"><sf-logo></sf-logo><sf-name></sf-name></div><h1>Lost in space.</h1><p>This page doesn’t exist. Check the address or head back home.</p><a class="sf-button" href="/">Go home</a>' +
+        badge),
+    password: document("Password required", '<div class="sf-brand"><sf-logo></sf-logo><sf-name></sf-name></div><h1>This one’s private.</h1><p>Enter the password to keep going.</p><sf-password-form></sf-password-form>' +
+        badge, true),
+    denied: document("Access denied", '<div class="sf-brand"><sf-logo></sf-logo><sf-name></sf-name></div><h1>Not for this account.</h1><p>You don’t have access to this page.</p>' +
+        badge, true),
+    login: document("Log in", '<div class="sf-brand"><sf-logo></sf-logo><sf-name></sf-name></div><h1>Log in to continue.</h1><p>This space knows its people.</p><sf-login></sf-login>' +
+        badge, true),
+    index: document("Files", '<div class="sf-brand"><sf-logo></sf-logo><sf-name></sf-name></div><h1>Files</h1><sf-files></sf-files>' +
+        badge),
+    preview: document("File preview", '<div class="sf-brand"><sf-logo></sf-logo><sf-name></sf-name></div><h1>Preview</h1><sf-file></sf-file>' +
+        badge),
+};
+export const DEFAULT_LAYOUT_TEMPLATE = `<!doctype html>\n<html lang="en">\n<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title><sf-name></sf-name></title></head>\n<body>\n  <header><a href="/"><sf-logo></sf-logo><sf-name></sf-name></a></header>\n  <main><sf-content></sf-content></main>\n</body>\n</html>\n`;
+export function defaultPageTemplate(id) {
+    return DEFAULT_PAGE_TEMPLATES[id];
+}
+export function pageIdFromFilename(filename) {
+    const id = filename.replace(/\.html$/, "");
+    return customPageIds.has(id) ? id : null;
+}
+export function allDefaultPageTemplates() {
+    return Object.fromEntries(SITE_PAGE_IDS.map((id) => [id, DEFAULT_PAGE_TEMPLATES[id]]));
+}

package/dist/utils/query-keys.d.ts CHANGED Viewed

@@ -5,10 +5,10 @@ export declare const qk: {
     accountConnections: () => readonly ["account", "connections"];
     accountInvitations: () => readonly ["account", "invitations"];
     apiTokens: (teamId?: string) => readonly ["api-tokens"] | readonly ["api-tokens", string];
-    agentAccounts: () => readonly ["agent-accounts"];
+    agentAccounts: (teamId: string) => readonly ["agent-accounts", string];
     myShelf: () => readonly ["my-shelf"];
-    mcpDashboard: () => readonly ["mcp", "dashboard"];
-    mcpApproval: (id: string) => readonly ["mcp", "approval", string];
+    mcpDashboard: (teamId: string) => readonly ["mcp", "dashboard", string];
+    mcpApproval: (teamId: string, id: string) => readonly ["mcp", "approval", string, string];
     teams: () => readonly ["teams", "list"];
     team: (ref: string) => readonly ["teams", "by-ref", string];
     teamMembers: (id: string) => readonly ["teams", string, "members"];
@@ -75,6 +75,7 @@ export declare const qk: {
     spaceFirewall: (id: string) => readonly ["spaces", string, "access", "firewall"];
     spaceAccessViews: (id: string, since?: string) => readonly ["spaces", string, "access", "views", string];
     teamServiceTokens: (teamId: string) => readonly ["teams", string, "access", "service-tokens"];
+    teamAgentHandoffs: (teamId: string) => readonly ["teams", string, "agent-handoffs"];
     teamAccessDefaults: (teamId: string) => readonly ["teams", string, "access", "defaults"];
     teamAccessConnections: (teamId: string) => readonly ["teams", string, "access", "connections"];
     domain: (teamId: string, ref: string) => readonly ["teams", string, "domains", string];

package/dist/utils/query-keys.js CHANGED Viewed

@@ -7,10 +7,10 @@ export const qk = {
     // Results are team-filtered, so the team lands in the key; calling with no
     // teamId yields the bare prefix (personal scope, and invalidate-all sweeps).
     apiTokens: (teamId) => teamId === undefined ? ["api-tokens"] : ["api-tokens", teamId],
-    agentAccounts: () => ["agent-accounts"],
+    agentAccounts: (teamId) => ["agent-accounts", teamId],
     myShelf: () => ["my-shelf"],
-    mcpDashboard: () => ["mcp", "dashboard"],
-    mcpApproval: (id) => ["mcp", "approval", id],
+    mcpDashboard: (teamId) => ["mcp", "dashboard", teamId],
+    mcpApproval: (teamId, id) => ["mcp", "approval", teamId, id],
     // The teams LIST gets its own leaf so invalidating it never cascades into
     // ["teams", id, ...] resource queries (members, spaces, domains, ...).
     teams: () => ["teams", "list"],
@@ -93,6 +93,7 @@ export const qk = {
     spaceFirewall: (id) => ["spaces", id, "access", "firewall"],
     spaceAccessViews: (id, since) => ["spaces", id, "access", "views", since ?? ""],
     teamServiceTokens: (teamId) => ["teams", teamId, "access", "service-tokens"],
+    teamAgentHandoffs: (teamId) => ["teams", teamId, "agent-handoffs"],
     teamAccessDefaults: (teamId) => ["teams", teamId, "access", "defaults"],
     teamAccessConnections: (teamId) => ["teams", teamId, "access", "connections"],
     domain: (teamId, ref) => ["teams", teamId, "domains", ref],

package/dist/utils/space-config.d.ts CHANGED Viewed

@@ -42,8 +42,8 @@ export type ResolvedServingConfig = {
     listing: boolean;
     viewer: boolean;
     meta: NonNullable<SpaceConfig["meta"]> | null;
-    /** Gate-page theme tokens (access-plan §5.7 tier 1); null when unset. */
-    pagesTheme: NonNullable<NonNullable<SpaceConfig["pages"]>["theme"]> | null;
+    /** Theme tokens for every Spacefast-authored page; null when unset. */
+    pageTheme: NonNullable<SpaceConfig["theme"]> | null;
     /** Hidden experimental build-pipeline flag; false keeps today's behavior. */
     experimentalGutenberg: boolean;
     /** Resolved inject snippets; only honored when experimentalGutenberg is true. */

package/dist/utils/space-config.js CHANGED Viewed

@@ -393,7 +393,7 @@ export function resolveEffectiveSpaceConfig(input) {
         // The single-file viewer rides the listing bundle (artifact-style spaces).
         viewer: listing,
         meta: merged.meta ?? null,
-        pagesTheme: merged.pages?.theme && Object.keys(merged.pages.theme).length > 0 ? merged.pages.theme : null,
+        pageTheme: merged.theme && Object.keys(merged.theme).length > 0 ? merged.theme : null,
         experimentalGutenberg: merged.experimental_gutenberg === true,
         inject: merged.inject ?? null,
     };

package/dist/utils/wpcom-auth-redirects.d.ts CHANGED Viewed

@@ -1,8 +1,6 @@
 export type LoginIntentSearch = {
     direct?: boolean | undefined;
     returnTo?: string | undefined;
-    /** Route straight to WordPress.com's signup page instead of its login page. */
-    signup?: boolean | undefined;
 };
 /**
  * Optional query params WordPress.com's OAuth2 authorize endpoint understands
@@ -21,8 +19,6 @@ export type WpcomAuthorizeExtras = {
      * our side loops them straight back into the same account.
      */
     switchAccount?: boolean | undefined;
-    /** `new-user=1`: routes straight to the WP.com signup page. */
-    signup?: boolean | undefined;
 };
 export declare function decorateWpcomAuthorizeUrl(authorizeUrl: string, extras?: WpcomAuthorizeExtras): string;
 export declare function buildDashboardLoginPath(input: LoginIntentSearch): string;

package/dist/utils/wpcom-auth-redirects.js CHANGED Viewed

@@ -14,9 +14,6 @@ export function decorateWpcomAuthorizeUrl(authorizeUrl, extras = {}) {
     if (extras.switchAccount) {
         url.searchParams.set("implicit", "false");
     }
-    if (extras.signup) {
-        url.searchParams.set("new-user", "1");
-    }
     return url.toString();
 }
 export function buildDashboardLoginPath(input) {
@@ -36,9 +33,6 @@ export function buildWpcomAuthStartPath(input) {
     if (returnTo) {
         url.searchParams.set("returnTo", returnTo);
     }
-    if (input.signup) {
-        url.searchParams.set("signup", "1");
-    }
     if (input.oauthQuery) {
         url.searchParams.set("oauth_query", input.oauthQuery);
     }

package/dist/vocabulary.d.ts CHANGED Viewed

@@ -150,7 +150,7 @@ export declare const EXTERNAL_TERM_ALLOWLIST: readonly [{
 }];
 /**
  * AMENDMENT (DECIDED 2026-07-02): the deploy vocabulary stays, as documented,
- * first-class ALIASES of the canonical vocabulary — `deploy` is an alias of
+ * first-class ALIASES of the canonical vocabulary — `deploy` is an exact alias of
  * `publish` (the verb) and `deployments` is an alias of `versions` (the noun).
  * The canonical lifecycle nouns are unchanged: version / channel / build.
  *
@@ -158,7 +158,7 @@ export declare const EXTERNAL_TERM_ALLOWLIST: readonly [{
  *
  *   - `sf deploy` / `sf deployments` stay listed and documented; every surface
  *     that presents them names the canonical command first and marks the
- *     deploy form as an alias.
+ *     deploy form as an exact alias with no independent behavior.
  *   - Wherever the alias is introduced, attach DEPLOY_ALIAS_DISAMBIGUATION
  *     (the one sanctioned disambiguation sentence) so readers land on the
  *     canonical nouns.

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@spacefast/common",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "license": "MIT",
   "description": "Shared TypeScript contracts and utilities for Spacefast packages.",
   "repository": {
@@ -64,6 +64,11 @@
       "import": "./dist/slug-policy/index.js",
       "default": "./dist/slug-policy/index.js"
     },
+    "./dashboard-paths": {
+      "types": "./dist/dashboard-paths/index.d.ts",
+      "import": "./dist/dashboard-paths/index.js",
+      "default": "./dist/dashboard-paths/index.js"
+    },
     "./agents/*": {
       "types": "./dist/agents/*.d.ts",
       "import": "./dist/agents/*.js",

package/dist/contracts/space-theme.d.ts DELETED Viewed

@@ -1,25 +0,0 @@
-import { z } from "zod";
-export declare const spaceThemeSchema: z.ZodObject<{
-    color: z.ZodOptional<z.ZodObject<{
-        palette: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            slug: z.ZodString;
-            color: z.ZodString;
-            name: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
-    typography: z.ZodOptional<z.ZodObject<{
-        fontSizes: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            slug: z.ZodString;
-            size: z.ZodString;
-            name: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>;
-        fontFamily: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    spacing: z.ZodOptional<z.ZodObject<{
-        spacingScale: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            slug: z.ZodString;
-            size: z.ZodString;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type SpaceTheme = z.infer<typeof spaceThemeSchema>;

package/dist/contracts/space-theme.js DELETED Viewed

@@ -1,49 +0,0 @@
-import { z } from "zod";
-// SpaceTheme (internal-docs/platform.md "SpaceTheme"): a validated preset
-// subset of WordPress theme.json. Presets only — no arbitrary CSS. The
-// finalize-time compiler (wave B1) additionally validates every value against
-// the safe-value grammar (no url()/@import/expression()/data: URIs) and drops
-// invalid keys with a warning diagnostic.
-const presetSlug = z
-    .string()
-    .min(1)
-    .max(64)
-    .regex(/^[a-z0-9-]+$/, { message: "Preset slugs are lowercase alphanumerics and dashes." });
-export const spaceThemeSchema = z.object({
-    color: z
-        .object({
-        palette: z
-            .array(z.object({
-            slug: presetSlug,
-            color: z.string().min(1).max(128),
-            name: z.string().min(1).max(128).optional(),
-        }))
-            .max(64)
-            .optional(),
-    })
-        .optional(),
-    typography: z
-        .object({
-        fontSizes: z
-            .array(z.object({
-            slug: presetSlug,
-            size: z.string().min(1).max(64),
-            name: z.string().min(1).max(128).optional(),
-        }))
-            .max(64)
-            .optional(),
-        fontFamily: z.string().min(1).max(256).optional(),
-    })
-        .optional(),
-    spacing: z
-        .object({
-        spacingScale: z
-            .array(z.object({
-            slug: presetSlug,
-            size: z.string().min(1).max(64),
-        }))
-            .max(64)
-            .optional(),
-    })
-        .optional(),
-});

package/dist/utils/gate-theme.d.ts DELETED Viewed

@@ -1,61 +0,0 @@
-import { type SpacePagesTheme } from "../contracts/space-config.js";
-export type GateThemeDiagnostic = {
-    severity: "info" | "warning" | "error";
-    code: string;
-    message: string;
-    path?: string | undefined;
-    details?: Record<string, unknown> | undefined;
-};
-/** Bound on the raw `theme.json` / `sf.theme.jsonc` file size at finalize. */
-export declare const GATE_THEME_FILE_MAX_BYTES: number;
-/** Bound on the compiled additive CSS custom-property block. */
-export declare const GATE_THEME_VARS_MAX_BYTES: number;
-export type ParsedThemeJson = {
-    /** Gate-page tokens derivable from named palette slugs (accent/primary/background). */
-    theme: Partial<SpacePagesTheme>;
-    /** `--wp--preset--color--{slug}` / `--wp--preset--font-family--{slug}` declarations. */
-    themeVars: string | null;
-    diagnostics: GateThemeDiagnostic[];
-};
-/**
- * Parses a `theme.json` file's `settings.color.palette` /
- * `settings.typography.fontFamilies` into gate-page tokens (accent/background
- * derived from conventionally-named slugs: `accent`|`primary`, `background`)
- * plus a full CSS custom-property block for every safe palette/font-family
- * entry. Any problem (oversized, invalid JSON, invalid shape) warns and
- * yields an empty result — the next tier down still applies.
- */
-export declare function parseThemeJsonFile(raw: string): ParsedThemeJson;
-export type ParsedSfThemeJsonc = {
-    theme: Partial<SpacePagesTheme>;
-    diagnostics: GateThemeDiagnostic[];
-};
-/**
- * Parses the `sf.theme.jsonc` escape hatch: same JSONC tolerance and the same
- * validated token grammar as `spacefast.jsonc "pages.theme"`
- * (`spacePagesThemeSchema`), just from a dedicated file. Any problem warns
- * and yields an empty result.
- */
-export declare function parseSfThemeJsonc(raw: string): ParsedSfThemeJsonc;
-export type CompiledGateTheme = {
-    /** Merged accent/background/logo/name/fontFamily; empty object when every tier is unset. */
-    theme: Partial<SpacePagesTheme>;
-    /** Additive `--wp--preset--*` declarations from theme.json (advanced surface for custom pages). */
-    themeVars: string | null;
-    diagnostics: GateThemeDiagnostic[];
-};
-/**
- * Compiles the full tier-3 cascade into the flat token shape the runtime
- * already reads. `base` is the existing free-tier `spacefast.jsonc
- * "pages.theme"` (already validated by `spaceConfigSchema` upstream — passed
- * through as-is). `sf.theme.jsonc` only applies when `advancedThemingEntitled`
- * is true; when it is present but NOT entitled, the tier is skipped with an
- * info diagnostic (fail-safe by omission — the compiled artifact simply
- * reflects the lower, entitled tiers, per access-plan §9).
- */
-export declare function mergeGateTheme(input: {
-    base: SpacePagesTheme | null;
-    themeJsonRaw: string | null;
-    sfThemeJsoncRaw: string | null;
-    advancedThemingEntitled: boolean;
-}): CompiledGateTheme;