@spacefast/common 0.0.6 → 0.0.8

package/dist/docs/error-docs.js

@@ -5,7 +5,7 @@
 // and pages never go missing. apps/www renders the HTML pages and writes the
 // `.md` twins from the same entries.
 import { BRAND } from "../brand.js";
-import { ERROR_CODES, errorDocsUrl, } from "../contracts/error-codes.js";
+import { errorDocsUrl } from "../contracts/error-codes.js";
 // Restore upgrade-oriented recovery copy here when paid plan checkout is live.
 export const ERROR_DOCS = {
     abuse_report_invalid_transition: {
@@ -48,6 +48,10 @@ export const ERROR_DOCS = {
         summary: "Too many unclaimed anonymous spaces are already active for this client.",
         fix: "Log in to publish into an authenticated space, or claim/delete an existing anonymous space before creating another.",
     },
+    api_key_scope_underivable: {
+        summary: "A concrete access policy could not be derived from the requested scope and permissions.",
+        fix: "Point scope at a resource you can already reach (an existing space owned by a team) and request permissions your credential already has.",
+    },
     archive_body_required: {
         summary: "This request must carry an archive body but none was provided.",
         fix: "Send the zip bytes as the request body with the matching content-type header.",
@@ -424,6 +428,10 @@ export const ERROR_DOCS = {
         summary: "The version upload declares the same file path twice.",
         fix: "Deduplicate the file list so every path appears once.",
     },
+    enforcement_policy_overlap: {
+        summary: "Enforcement policy severity ranges overlap within a category.",
+        fix: "Adjust the category ranges so each severity is covered by at most one policy.",
+    },
     expired_token: {
         summary: "The token has expired.",
         fix: "Request a new token and retry.",
@@ -768,6 +776,10 @@ export const ERROR_DOCS = {
         summary: "The uploaded archive exceeds the maximum allowed size.",
         fix: "Reduce the archive size or use a version upload session for big publishes.",
     },
+    publish_base_changed: {
+        summary: "Someone published new space settings after the base you loaded, so saving would overwrite their change.",
+        fix: "Reload the latest settings, review the difference, and save again; pass force only to overwrite deliberately.",
+    },
     publish_config_unsupported: {
         summary: "The publish carries configuration this endpoint does not support.",
         fix: "Move the configuration into sf.jsonc or the space settings.",
@@ -928,6 +940,18 @@ export const ERROR_DOCS = {
         summary: "The device login is being polled faster than the advised interval.",
         fix: "Increase the polling interval; aggressive polling invalidates the flow.",
     },
+    slug_invalid: {
+        summary: "The slug does not meet the structural rules for managed names.",
+        fix: "Use lowercase letters, numbers, and single dashes within the allowed length; the error message identifies the failed rule.",
+    },
+    slug_reserved: {
+        summary: "The slug is reserved for infrastructure, product, or impersonation protection.",
+        fix: "Choose a different name that is not reserved by the shared slug policy.",
+    },
+    slug_unavailable: {
+        summary: "The slug is already in use within the relevant ownership scope.",
+        fix: "Choose another slug or use the available suggestion returned by the API.",
+    },
     space_already_claimed: {
         summary: "The space was already claimed; a claim can only succeed once.",
         fix: "If you are the agent that published this space, exchange your claim token once at POST /v1/anonymous-claim/exchange for a durable access token and keep publishing to the same spaceId. Otherwise ask the owner for access — do not publish a duplicate space.",
@@ -952,6 +976,10 @@ export const ERROR_DOCS = {
         summary: "The space still has an active version, which blocks this operation.",
         fix: "Delete or supersede the active version first.",
     },
+    space_hostname_identity_missing: {
+        summary: "The space is missing its persisted default hostname identity.",
+        fix: "Contact support. Retrying cannot safely recreate a permanent hostname identity.",
+    },
     space_import_archive_invalid: {
         summary: `The import archive is not a valid ${BRAND.productName} export.`,
         fix: "Export the source space again and upload the unmodified archive.",
@@ -1272,6 +1300,10 @@ export const ERROR_DOCS = {
         summary: "Zero endpoints are activating.",
         fix: "Wait for the dedicated runtime move to complete, then retry the request.",
     },
+    zero_ai_unavailable: {
+        summary: "The local Zero AI service is not configured.",
+        fix: "Configure an AI handler for zero dev before calling the AI service.",
+    },
     zero_artifact_abi_mismatch: {
         summary: "The Zero endpoint artifact was built for a different runner ABI.",
         fix: `Rebuild and republish the Zero project with the current ${BRAND.productName} CLI and runtime.`,
@@ -1284,6 +1316,10 @@ export const ERROR_DOCS = {
         summary: "The Zero endpoint artifact could not be parsed.",
         fix: "Rebuild the Zero project; do not edit generated artifact JSON by hand.",
     },
+    zero_artifact_missing: {
+        summary: "A Zero route points to an endpoint artifact that is missing.",
+        fix: "Declare the endpoint in zero_endpoints, then rebuild and publish again.",
+    },
     zero_artifact_path_invalid: {
         summary: "The Zero endpoint artifact path is invalid.",
         fix: "Rebuild the Zero routes so all artifact paths stay inside the version bundle.",
@@ -1292,6 +1328,10 @@ export const ERROR_DOCS = {
         summary: "The Zero endpoint artifact could not be read by the runtime.",
         fix: "Verify the version finalized with all generated Zero files present.",
     },
+    zero_artifact_untrusted: {
+        summary: "A Zero route points to an uploaded artifact that the runtime did not compile.",
+        fix: "Declare the endpoint in zero_endpoints so finalize generates trusted bytecode.",
+    },
     zero_auth_unavailable: {
         summary: "Hosted Zero auth is not configured for this deployment.",
         fix: "Finalize the Zero version with hosted auth URLs or use guest/local auth.",
@@ -1332,6 +1372,10 @@ export const ERROR_DOCS = {
         summary: "The Zero endpoint bytecode file could not be read.",
         fix: "Verify the version finalized with the generated bytecode files present.",
     },
+    zero_capabilities_encode_failed: {
+        summary: "The runtime could not encode the Zero endpoint capabilities.",
+        fix: "Rebuild with valid capability metadata; report the failure if it persists.",
+    },
     zero_client_bundle_not_loaded: {
         summary: "The local Zero dev client bundle has not been generated or loaded.",
         fix: "Restart zero dev or run a fresh local build before loading the client route.",
@@ -1404,6 +1448,22 @@ export const ERROR_DOCS = {
         summary: "The Zero database dump query parameters are invalid.",
         fix: "Use valid table, limit, and cursor parameters.",
     },
+    zero_endpoint_compile_failed: {
+        summary: "The runtime could not compile the Zero endpoint bytecode.",
+        fix: "Inspect the compile diagnostics, fix the endpoint source, and publish again.",
+    },
+    zero_endpoint_conflict: {
+        summary: "Two Zero routes resolve to the same runtime path.",
+        fix: "Remove the duplicate generated or explicit lookup route and publish again.",
+    },
+    zero_endpoint_duplicate: {
+        summary: "Two Zero endpoints declare the same method and route.",
+        fix: "Give each endpoint a unique method and route before publishing again.",
+    },
+    zero_endpoint_id_duplicate: {
+        summary: "Two Zero endpoints declare the same endpoint id.",
+        fix: "Give every endpoint a unique endpoint id before publishing again.",
+    },
     zero_endpoint_index_invalid: {
         summary: "The Zero endpoint index does not contain valid endpoint mappings.",
         fix: "Rebuild and republish the Zero project.",
@@ -1420,6 +1480,10 @@ export const ERROR_DOCS = {
         summary: "The Zero endpoint index could not be read.",
         fix: "Verify the version finalized with zero/endpoints-index.json present.",
     },
+    zero_endpoint_invalid: {
+        summary: "A Zero endpoint definition or its database metadata is invalid.",
+        fix: "Fix the endpoint method, route, source, capabilities, or database metadata and publish again.",
+    },
     zero_endpoint_mismatch: {
         summary: "The requested Zero endpoint does not match the endpoint artifact.",
         fix: "Rebuild routes and artifacts together and redeploy the version.",
@@ -1428,6 +1492,14 @@ export const ERROR_DOCS = {
         summary: "No Zero endpoint artifact exists for this endpoint id.",
         fix: "Check the route path and rebuild the Zero endpoint index.",
     },
+    zero_endpoints_invalid: {
+        summary: "The Zero endpoints payload is invalid.",
+        fix: "Send an endpoint array within the supported count and size limits.",
+    },
+    zero_endpoints_too_many: {
+        summary: "The Zero endpoints payload exceeds the supported endpoint count.",
+        fix: "Reduce the project to at most 128 Zero endpoints, then publish again.",
+    },
     zero_requires_dedicated_plan: {
         summary: "Zero endpoints require a plan with dedicated runtime isolation.",
         fix: "Upgrade the team to a plan that includes Zero and dedicated runtime, then publish again.",
@@ -1464,10 +1536,18 @@ export const ERROR_DOCS = {
         summary: "The Zero log query parameters are invalid.",
         fix: "Use valid cursor, limit, mutationName, and requestId parameters.",
     },
+    zero_lookup_invalid: {
+        summary: "The Zero lookup map contains an invalid path or action.",
+        fix: "Use normalized relative paths and valid finalized Zero actions.",
+    },
     zero_method_not_allowed: {
         summary: "The request method is not allowed for this Zero endpoint.",
         fix: "Call the endpoint with one of the methods declared by the Zero route.",
     },
+    zero_migration_failed: {
+        summary: "The Zero database migration command failed during finalize.",
+        fix: "Inspect the migration and database logs, fix the schema issue, and publish again.",
+    },
     zero_query_name_missing: {
         summary: "A Zero realtime query subscription did not include a query name.",
         fix: "Send a query.subscribe frame with a valid query name.",
@@ -1520,6 +1600,22 @@ export const ERROR_DOCS = {
         summary: "The Zero endpoint response exceeds the runtime size limit.",
         fix: "Return a smaller response body or paginate the data.",
     },
+    zero_routes_invalid: {
+        summary: "The Zero routes artifact is invalid.",
+        fix: "Rebuild the generated routes and publish the version again.",
+    },
+    zero_run_compile_failed: {
+        summary: "The runtime could not compile a Zero run handler.",
+        fix: "Inspect the compile diagnostics, fix the run-handler source, and publish again.",
+    },
+    zero_run_duplicate: {
+        summary: "Two Zero run handlers declare the same run id.",
+        fix: "Give every run handler a unique run id before publishing again.",
+    },
+    zero_run_invalid: {
+        summary: "A Zero run-handler definition is invalid.",
+        fix: "Fix the run id, source, capabilities, or database metadata and publish again.",
+    },
     zero_run_operation_unsupported: {
         summary: "The hosted Zero runtime does not support this run operation yet.",
         fix: "Use a generated endpoint or deploy a generated run handler for this operation.",
@@ -1564,6 +1660,22 @@ export const ERROR_DOCS = {
         summary: "The Zero runner process could not be started.",
         fix: "Verify the runner binary is installed and executable in the runtime.",
     },
+    zero_runs_invalid: {
+        summary: "The Zero run-handler payload is invalid.",
+        fix: "Send a valid array of generated run handlers and publish again.",
+    },
+    zero_runs_require_runtime_compiler: {
+        summary: "Zero run handlers require the Rust runtime compiler.",
+        fix: "Install the current runtime compiler and finalize the version again.",
+    },
+    zero_runs_too_many: {
+        summary: "The Zero run-handler payload exceeds the supported handler count.",
+        fix: "Reduce the project to at most 128 Zero run handlers, then publish again.",
+    },
+    zero_shopify_unavailable: {
+        summary: "The local Zero Shopify service is not configured.",
+        fix: "Configure a Shopify handler for zero dev before calling the Shopify service.",
+    },
     zero_source_compile_failed: {
         summary: "The Zero endpoint source fallback failed to compile.",
         fix: "Fix the endpoint source and rebuild bytecode.",

package/dist/slug-policy/blocklist.d.ts

@@ -0,0 +1,4 @@
+export declare const INFRA_SLUG_BLOCKLIST: readonly ["www", "www1", "www2", "www3", "web", "mail", "webmail", "smtp", "imap", "pop", "mx", "mx1", "mx2", "ns", "ns1", "ns2", "ns3", "ns4", "dns", "ftp", "ssh", "vpn", "git", "svn", "cdn", "assets", "static", "img", "images", "files", "media", "local", "localhost", "host", "server", "remote", "portal", "owa", "exchange", "gov", "nic", "whois"];
+export declare const PRODUCT_PLATFORM_SLUG_BLOCKLIST: readonly ["spacefast", "stattic", "viewfast", "view-fast", "sf", "my", "api", "app", "apps", "admin", "superadmin", "dashboard", "console", "login", "logout", "auth", "oauth", "sso", "signup", "signin", "register", "claim", "billing", "checkout", "mcp", "cli", "sdk", "cast", "preview", "previews", "internal", "ops", "handbook"];
+export declare const TRADEMARK_EXACT_SLUG_BLOCKLIST: readonly ["automattic", "wordpress", "woocommerce", "jetpack", "wpcloud", "google", "facebook", "instagram", "twitter", "x", "tiktok", "youtube", "amazon", "apple", "microsoft", "netflix", "paypal", "stripe", "visa", "mastercard", "coinbase", "metamask", "openai", "anthropic", "claude", "github", "gitlab", "vercel", "netlify", "cloudflare"];
+export declare const SUBSTRING_SLUG_BLOCKLIST: readonly ["spacefast", "stattic", "automattic", "wordpress", "paypal"];

package/dist/slug-policy/blocklist.js

@@ -0,0 +1,122 @@
+// Infrastructure hostnames reserved by WordPress.com managed-subdomain policy.
+export const INFRA_SLUG_BLOCKLIST = [
+    "www",
+    "www1",
+    "www2",
+    "www3",
+    "web",
+    "mail",
+    "webmail",
+    "smtp",
+    "imap",
+    "pop",
+    "mx",
+    "mx1",
+    "mx2",
+    "ns",
+    "ns1",
+    "ns2",
+    "ns3",
+    "ns4",
+    "dns",
+    "ftp",
+    "ssh",
+    "vpn",
+    "git",
+    "svn",
+    "cdn",
+    "assets",
+    "static",
+    "img",
+    "images",
+    "files",
+    "media",
+    "local",
+    "localhost",
+    "host",
+    "server",
+    "remote",
+    "portal",
+    "owa",
+    "exchange",
+    "gov",
+    "nic",
+    "whois",
+];
+// Spacefast product, platform, and public surface names.
+export const PRODUCT_PLATFORM_SLUG_BLOCKLIST = [
+    "spacefast",
+    "stattic",
+    "viewfast",
+    "view-fast",
+    "sf",
+    "my",
+    "api",
+    "app",
+    "apps",
+    "admin",
+    "superadmin",
+    "dashboard",
+    "console",
+    "login",
+    "logout",
+    "auth",
+    "oauth",
+    "sso",
+    "signup",
+    "signin",
+    "register",
+    "claim",
+    "billing",
+    "checkout",
+    "mcp",
+    "cli",
+    "sdk",
+    "cast",
+    "preview",
+    "previews",
+    "internal",
+    "ops",
+    "handbook",
+];
+// Exact trademark and impersonation names reserved in every managed namespace.
+export const TRADEMARK_EXACT_SLUG_BLOCKLIST = [
+    "automattic",
+    "wordpress",
+    "woocommerce",
+    "jetpack",
+    "wpcloud",
+    "google",
+    "facebook",
+    "instagram",
+    "twitter",
+    "x",
+    "tiktok",
+    "youtube",
+    "amazon",
+    "apple",
+    "microsoft",
+    "netflix",
+    "paypal",
+    "stripe",
+    "visa",
+    "mastercard",
+    "coinbase",
+    "metamask",
+    "openai",
+    "anthropic",
+    "claude",
+    "github",
+    "gitlab",
+    "vercel",
+    "netlify",
+    "cloudflare",
+];
+// Minimal substring rules for high-risk product and impersonation strings.
+export const SUBSTRING_SLUG_BLOCKLIST = [
+    "spacefast",
+    "stattic",
+    "automattic",
+    "wordpress",
+    "paypal",
+];

package/dist/slug-policy/index.d.ts

@@ -0,0 +1,17 @@
+export { INFRA_SLUG_BLOCKLIST, PRODUCT_PLATFORM_SLUG_BLOCKLIST, SUBSTRING_SLUG_BLOCKLIST, TRADEMARK_EXACT_SLUG_BLOCKLIST, } from "./blocklist.js";
+export type SlugPolicyOptions = {
+    maxLength?: number;
+};
+export type SlugPolicyVerdict = {
+    ok: true;
+    normalized: string;
+} | {
+    ok: false;
+    reason: "slug_invalid" | "slug_reserved";
+    detail: string;
+};
+export declare const SLUG_MIN_LENGTH = 3;
+export declare const TEAM_SLUG_MAX_LENGTH = 63;
+export declare const SPACE_SLUG_MAX_LENGTH = 55;
+export declare function evaluateSlugCandidate(input: string, options?: SlugPolicyOptions): SlugPolicyVerdict;
+export declare function slugPolicyFailureSurvivesSuffix(normalized: string): boolean;

package/dist/slug-policy/index.js

@@ -0,0 +1,86 @@
+import { MANAGEMENT_LABEL_PREFIX } from "../config/domains.js";
+import { INFRA_SLUG_BLOCKLIST, PRODUCT_PLATFORM_SLUG_BLOCKLIST, SUBSTRING_SLUG_BLOCKLIST, TRADEMARK_EXACT_SLUG_BLOCKLIST, } from "./blocklist.js";
+export { INFRA_SLUG_BLOCKLIST, PRODUCT_PLATFORM_SLUG_BLOCKLIST, SUBSTRING_SLUG_BLOCKLIST, TRADEMARK_EXACT_SLUG_BLOCKLIST, } from "./blocklist.js";
+export const SLUG_MIN_LENGTH = 3;
+export const TEAM_SLUG_MAX_LENGTH = 63;
+export const SPACE_SLUG_MAX_LENGTH = 55;
+const infraReservedSlugs = new Set(INFRA_SLUG_BLOCKLIST);
+const productPlatformReservedSlugs = new Set(PRODUCT_PLATFORM_SLUG_BLOCKLIST);
+const trademarkExactReservedSlugs = new Set(TRADEMARK_EXACT_SLUG_BLOCKLIST);
+export function evaluateSlugCandidate(input, options = {}) {
+    const maxLength = options.maxLength ?? TEAM_SLUG_MAX_LENGTH;
+    // Explicit user choices are rejected rather than silently reshaped. Case,
+    // surrounding whitespace, and diacritics are the only accepted canonicalization.
+    const casefolded = input
+        .trim()
+        .normalize("NFD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase();
+    if (!/^[a-z0-9-]+$/.test(casefolded)) {
+        return invalid("Slug may only contain lowercase letters, numbers, and dashes.");
+    }
+    const structuralCandidate = casefolded;
+    if (structuralCandidate.includes("--")) {
+        return invalid("Slug cannot contain -- because it is the version/branch hostname separator.");
+    }
+    const normalized = casefolded.replace(/^-+|-+$/g, "");
+    const structuralVerdict = evaluateStructuralRules(normalized, structuralCandidate, maxLength);
+    if (!structuralVerdict.ok) {
+        return structuralVerdict;
+    }
+    const reservedVerdict = evaluateReservedRules(normalized);
+    if (!reservedVerdict.ok) {
+        return reservedVerdict;
+    }
+    return { ok: true, normalized };
+}
+function evaluateStructuralRules(normalized, structuralCandidate, maxLength) {
+    if (normalized.length < SLUG_MIN_LENGTH) {
+        return invalid(`Slug must be at least ${SLUG_MIN_LENGTH} characters.`);
+    }
+    if (normalized.length > maxLength) {
+        return invalid(`Slug must be ${maxLength} characters or fewer.`);
+    }
+    if (structuralCandidate.startsWith("-") || structuralCandidate.endsWith("-")) {
+        return invalid("Slug cannot start or end with a dash.");
+    }
+    if (/^[0-9]+$/.test(normalized)) {
+        return invalid("Slug cannot be all numeric.");
+    }
+    if (normalized.startsWith(MANAGEMENT_LABEL_PREFIX)) {
+        return reserved(`Slug cannot start with reserved prefix ${MANAGEMENT_LABEL_PREFIX}.`);
+    }
+    return { ok: true, normalized };
+}
+// A substring reservation survives numeric suffixing (`paypal-2` still
+// contains `paypal`). Suggestion generators use this structured signal to
+// abandon the base instead of exhausting every suffix.
+function matchingReservedSubstring(normalized) {
+    return SUBSTRING_SLUG_BLOCKLIST.find((reservedSubstring) => normalized.includes(reservedSubstring));
+}
+export function slugPolicyFailureSurvivesSuffix(normalized) {
+    return (matchingReservedSubstring(normalized) !== undefined ||
+        normalized.startsWith(MANAGEMENT_LABEL_PREFIX));
+}
+function evaluateReservedRules(normalized) {
+    if (infraReservedSlugs.has(normalized)) {
+        return reserved("Slug is reserved for infrastructure.");
+    }
+    if (productPlatformReservedSlugs.has(normalized)) {
+        return reserved("Slug is reserved for Spacefast product and platform use.");
+    }
+    if (trademarkExactReservedSlugs.has(normalized)) {
+        return reserved("Slug is reserved for trademark and impersonation protection.");
+    }
+    const substringRule = matchingReservedSubstring(normalized);
+    if (substringRule) {
+        return reserved(`Slug contains reserved substring ${substringRule}.`);
+    }
+    return { ok: true, normalized };
+}
+function invalid(detail) {
+    return { ok: false, reason: "slug_invalid", detail };
+}
+function reserved(detail) {
+    return { ok: false, reason: "slug_reserved", detail };
+}

package/dist/utils/concurrency.d.ts

@@ -1 +1,2 @@
 export declare function mapConcurrent<T, R>(items: readonly T[], limit: number, mapper: (item: T, index: number) => Promise<R>): Promise<R[]>;
+export declare function findConcurrent<T>(items: readonly T[], limit: number, predicate: (item: T, index: number) => Promise<boolean>): Promise<T | undefined>;

package/dist/utils/concurrency.js

@@ -16,3 +16,25 @@ export async function mapConcurrent(items, limit, mapper) {
     await Promise.all(Array.from({ length: Math.min(limit, items.length) }, worker));
     return results;
 }
+// Runs predicates in bounded batches while preserving Array.find semantics:
+// the earliest matching item wins, and only a rejection before that match is
+// observable. Later batches are never started after a match is found.
+export async function findConcurrent(items, limit, predicate) {
+    if (!Number.isInteger(limit) || limit < 1) {
+        throw new Error("Concurrency limit must be a positive integer.");
+    }
+    for (let offset = 0; offset < items.length; offset += limit) {
+        const batch = items.slice(offset, offset + limit);
+        // eslint-disable-next-line no-await-in-loop -- batches are sequential so a match stops later work.
+        const results = await Promise.allSettled(batch.map((item, index) => predicate(item, offset + index)));
+        for (const [index, result] of results.entries()) {
+            if (result.status === "rejected") {
+                throw result.reason;
+            }
+            if (result.value) {
+                return batch[index];
+            }
+        }
+    }
+    return undefined;
+}

package/dist/utils/email.d.ts

@@ -0,0 +1 @@
+export declare function canonicalizeEmail(value: string): string;

package/dist/utils/email.js

@@ -0,0 +1,3 @@
+export function canonicalizeEmail(value) {
+    return value.trim().toLowerCase().normalize("NFC");
+}

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

@@ -28,6 +28,7 @@ export declare const qk: {
     space: (id: string) => readonly ["spaces", string];
     spaceByRef: (teamRef: string, spaceRef: string) => readonly ["spaces", "by-ref", string, string];
     spaceVersions: (id: string) => readonly ["spaces", string, "versions"];
+    spaceVersionsHistory: (id: string) => readonly ["spaces", string, "versions", "history"];
     spaceCollaboration: (id: string) => readonly ["spaces", string, "collaboration"];
     spaceCollaborationEmbedConfig: (id: string) => readonly ["spaces", string, "collaboration", "embed-config"];
     spaceAnnotations: (id: string) => readonly ["spaces", string, "annotations"];

package/dist/utils/query-keys.js

@@ -33,6 +33,10 @@ export const qk = {
     space: (id) => ["spaces", id],
     spaceByRef: (teamRef, spaceRef) => ["spaces", "by-ref", teamRef, spaceRef],
     spaceVersions: (id) => ["spaces", id, "versions"],
+    // The cursor-paginated history read (distinct cache shape from the plain,
+    // capped-at-50 `spaceVersions` list above) — nested under the same prefix so
+    // `invalidateQueries({ queryKey: qk.spaceVersions(id) })` still reaches it.
+    spaceVersionsHistory: (id) => [...qk.spaceVersions(id), "history"],
     spaceCollaboration: (id) => ["spaces", id, "collaboration"],
     spaceCollaborationEmbedConfig: (id) => ["spaces", id, "collaboration", "embed-config"],
     spaceAnnotations: (id) => ["spaces", id, "annotations"],

package/dist/utils/sf-config-v1.d.ts

@@ -0,0 +1,2 @@
+import { type CompileSfConfigV1Options, type SfConfigV1CompileResult } from "../contracts/sf-config-v1.js";
+export declare function compileSfConfigV1(source: string, options?: CompileSfConfigV1Options): SfConfigV1CompileResult;