@elytracms/studio 0.0.1

package/dist/lib/persistence/backend-mode.js

@@ -0,0 +1,120 @@
+/**
+ * Studio backend mode resolution (EC-153). Convex is the **default and primary**
+ * persistence backend; the deterministic in-memory adapter is demoted to an
+ * explicit, labeled **playground** mode and is never an automatic fallback:
+ *
+ * - `VITE_CONVEX_URL` set → Convex mode (the production/dev default).
+ * - `VITE_ELYTRA_MODE=playground` → playground mode (seeded in-memory adapter,
+ *   local + ephemeral). The flag wins over a configured URL — explicit beats
+ *   implicit — so a checked-out `.env.local` can be flipped without deleting it.
+ * - Neither → **misconfigured**: the studio renders a deterministic boot-error
+ *   screen (see `BackendGate`) telling the developer exactly what to set.
+ *   Likewise, a Convex backend that is unreachable at runtime is a visible
+ *   error state — the studio never silently swaps in in-memory storage.
+ */
+export const MODE_ENV_VAR = 'VITE_ELYTRA_MODE';
+export const PLAYGROUND_MODE = 'playground';
+export const CONVEX_URL_ENV_VAR = 'VITE_CONVEX_URL';
+function viteEnv() {
+    if (typeof import.meta === 'undefined')
+        return {};
+    return import.meta.env ?? {};
+}
+function nodeEnv() {
+    return typeof process !== 'undefined' ? (process.env ?? {}) : {};
+}
+function readEnv(env, key) {
+    const value = env[key];
+    return value && value.trim() !== '' ? value.trim() : undefined;
+}
+let envOverride = null;
+/**
+ * Test seam: pin the env the selectors see. `vi.stubEnv` cannot reach the
+ * `import.meta.env` snapshot Vitest hands this module, so suites that exercise
+ * `selectPersistenceAdapter`/`selectAuthAdapter` against specific configurations
+ * use this instead — keeping results independent of any developer `.env.local`.
+ */
+export function setStudioEnvOverrideForTests(env) {
+    envOverride = env;
+}
+/** Resolve the configured studio env (Vite client env wins over process.env). */
+export function studioEnv() {
+    return envOverride ?? { ...nodeEnv(), ...viteEnv() };
+}
+/**
+ * Pure mode decision — testable with a plain env record. The app calls it with
+ * {@link studioEnv}; `CONVEX_URL` (Node-side alias) is honored for SSR/tools.
+ */
+export function resolveBackendConfig(env = studioEnv()) {
+    const mode = readEnv(env, MODE_ENV_VAR);
+    if (mode === PLAYGROUND_MODE)
+        return { kind: 'playground' };
+    if (mode !== undefined) {
+        return {
+            kind: 'misconfigured',
+            reason: 'unknown-mode',
+            detail: `${MODE_ENV_VAR}="${mode}" is not a known mode. The only supported value is "${PLAYGROUND_MODE}"; unset it to run against Convex.`,
+        };
+    }
+    const url = readEnv(env, CONVEX_URL_ENV_VAR) ?? readEnv(env, 'CONVEX_URL');
+    if (url)
+        return { kind: 'convex', url };
+    return {
+        kind: 'misconfigured',
+        reason: 'missing-convex-url',
+        detail: `No persistence backend is configured. Set ${CONVEX_URL_ENV_VAR} to your Convex deployment URL (see docs/backend-setup.md), or opt into the ephemeral local playground with ${MODE_ENV_VAR}=${PLAYGROUND_MODE}.`,
+    };
+}
+/** True when the studio runs in the explicit, labeled playground mode. */
+export function isPlaygroundMode() {
+    return resolveBackendConfig().kind === 'playground';
+}
+// ---------------------------------------------------------------------------
+// Dev auto-login (unattended testing — NOT an auth bypass)
+// ---------------------------------------------------------------------------
+/** `email:password` for unattended dev sign-in (gitignored `.env.local`). */
+export const DEV_LOGIN_ENV_VAR = 'VITE_ELYTRA_DEV_LOGIN';
+/**
+ * Is this a Vite *dev* build? `import.meta.env.DEV` is statically `true` under
+ * `vite dev` and statically `false` in any production build — so gating dev
+ * auto-login on it means the whole feature **dead-code-eliminates** out of a
+ * production bundle, even if `VITE_ELYTRA_DEV_LOGIN` were somehow present.
+ */
+function isViteDevBuild() {
+    if (typeof import.meta === 'undefined')
+        return false;
+    return import.meta.env?.DEV === true;
+}
+/**
+ * Dev-only unattended auth — **not a bypass**. When `VITE_ELYTRA_DEV_LOGIN=
+ * email:password` is set in a dev build, the studio auto-signs-in with those
+ * credentials on load (see {@link DevAutoLoginAdapter}) so local/automated
+ * testing skips the sign-in screen while still establishing a REAL backend
+ * session: Convex's server-side `requireRole` guards still apply, so the dev
+ * user must exist and be a member. Returns null in production builds (gated by
+ * {@link isViteDevBuild}) and when unset/malformed, so it can never weaken a
+ * deployed app. `isDevBuild` is a parameter purely so the decision is unit
+ * testable (`import.meta.env.DEV` is not reachable via `vi.stubEnv`).
+ *
+ * `password` may itself contain `:` — only the first colon separates the fields.
+ */
+export function resolveDevAutoLogin(env = studioEnv(), isDevBuild = isViteDevBuild()) {
+    if (!isDevBuild)
+        return null;
+    const raw = readEnv(env, DEV_LOGIN_ENV_VAR);
+    if (!raw)
+        return null;
+    const separator = raw.indexOf(':');
+    if (separator <= 0)
+        return null;
+    const email = raw.slice(0, separator).trim();
+    const password = raw.slice(separator + 1);
+    if (!email || !password)
+        return null;
+    return { email, password };
+}
+/** True when dev auto-login is configured (dev build only) — for the UI marker. */
+export function isDevAutoLoginActive() {
+    return resolveDevAutoLogin() !== null;
+}
+//# sourceMappingURL=backend-mode.js.map

package/dist/lib/persistence/backend-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-mode.js","sourceRoot":"","sources":["../../../src/lib/persistence/backend-mode.ts"],"names":[],"mappings":"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"}

package/dist/lib/persistence/convex-adapter.d.ts

@@ -0,0 +1,34 @@
+import type { ConvexHttpClient } from 'convex/browser';
+import type { CollectionDef } from '@elytracms/cms-core';
+import type { AssetRepository, BackendStatus, BackendValidationInput, BackendValidationResult, BlobStorageAdapter, CliTokenRepository, CmsRepository, GraphRepository, MembersRepository, PersistenceAdapter, PublishingRepository, ReferenceIndexRepository } from '@elytracms/persistence';
+/**
+ * Convex-backed {@link PersistenceAdapter} (brief §10, EC-039). Every repository
+ * is implemented against the Convex functions in `apps/builder/convex/*`, mapping
+ * results and failures onto the provider-neutral contracts + error taxonomies.
+ */
+export declare class ConvexPersistenceAdapter implements PersistenceAdapter {
+    private readonly client;
+    readonly graphs: GraphRepository;
+    readonly cms: CmsRepository;
+    readonly assets: AssetRepository;
+    readonly publishing: PublishingRepository;
+    /** Reference index — outbound/inbound entries per variant (EC-155, AD-6). */
+    readonly references: ReferenceIndexRepository;
+    /** Per-project membership roles (EC-150). */
+    readonly members: MembersRepository;
+    /** Revocable CLI sync tokens, stored hashed (EC-150). */
+    readonly cliTokens: CliTokenRepository;
+    /** Convex file storage behind the EC-133 blob boundary (EC-151). */
+    readonly blobs: BlobStorageAdapter;
+    /**
+     * @param client      the Convex client bound to this deployment (one project).
+     * @param projectId   the slug of this deployment's one project (EC-179). Used to
+     *   stamp deployment-scoped member records onto the still-project-keyed contract.
+     * @param collections the active project's config-owned CMS collections (EC-183,
+     *   AD-11), from `elytra.config.ts`. The backend has no `cmsSchemas` table, so
+     *   the CMS repository serves the schema from these.
+     */
+    constructor(client: ConvexHttpClient, projectId: string, collections?: readonly CollectionDef[]);
+    status(): Promise<BackendStatus>;
+    validate(input: BackendValidationInput): BackendValidationResult;
+}