@elytracms/studio 0.0.86 → 0.0.88

package/dist/lib/data/data-store.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"data-store.js","sourceRoot":"","sources":["../../../src/lib/data/data-store.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useMemo, useReducer, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport {\n  SourceRegistry,\n  captureSample,\n  inferSchema,\n  resolveBinding,\n  resolveCondition,\n  tokensForSchema,\n} from '@elytracms/core/data-binding'\nimport type {\n  BindingResolution,\n  ConditionResolution,\n  DataSource,\n  InferredSchema,\n  PayloadStore,\n  RepeaterItemContext,\n} from '@elytracms/core/data-binding'\nimport type { BindingReference, Condition, JsonValue } from '@elytracms/core/project-graph'\nimport { getStudioOperations } from '../operations'\nimport type { OperationResult, OperationsClient } from '../operations'\nimport { useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query'\nimport { createRequiredContext } from '@elytracms/studio/lib/required-context'\nimport { STUDIO_SYSTEM_COLLECTION_IDS } from '../operations/session-hydration'\nimport { resolveDeploymentCollections } from '../workspace'\nimport { hasContentSession } from './collection-content'\nimport { captureSourceSample, cmsSourceForCollection } from './sample-capture'\nimport { deleteDataSource, loadDataSources, saveDataSource } from './sources-store'\n\n/**\n * The project's live data layer (brief §4.6, §7.5, EC-167). Holds the source\n * registry the Builder's Content tab binds through, plus the captured payloads\n * that drive binding resolution. One uniform model across CMS queries, data\n * providers, and the built-in REST/Convex kinds — resolution, sampling,\n * inference and tokenization treat them all identically.\n *\n * There is no source-authoring UI (EC-167): sources exist because code declared\n * them (registered data providers), the schema implied them (per-collection CMS\n * queries), or an editor flow provisioned them (repeating sections, template\n * pages).\n *\n * Persistence: when mounted with a `projectId`, the store hydrates the\n * project's persisted source records (the `cms-data-sources` system collection,\n * see `sources-store.ts`) over the deterministic playground seeds — persisted\n * wins by id, but never over a source provisioned/removed in THIS session —\n * and every provision/remove writes through `@elytracms/core/operations`. Without a\n * `projectId` (tests, fixtures) the store is pure session state, exactly as\n * before.\n */\nexport interface DataStore {\n  sources: DataSource[]\n  registry: SourceRegistry\n  payloads: PayloadStore\n  knownSourceIds: ReadonlySet<string>\n\n  getSource: (id: string) => DataSource | undefined\n  removeSource: (id: string) => void\n  /**\n   * Create or replace a source with a known id + config and capture its sample\n   * immediately (EC-166/EC-167): repeating sections and template pages\n   * provision their per-scope CMS query / provider sources through this.\n   */\n  provisionSource: (source: DataSource) => void\n\n  /**\n   * The latest persistence failure in plain language, or `null`. Persistence\n   * is best-effort on top of the live session (the canvas keeps working on\n   * session state), but a failure is recorded here — visible, never silent.\n   */\n  persistError: string | null\n\n  /** The stable path tokens a source exposes from its inferred schema (EC-085). */\n  tokensOf: (id: string) => string[]\n  schemaOf: (id: string) => InferredSchema | undefined\n  sampleOf: (id: string) => JsonValue | undefined\n\n  /** Resolve a binding to a renderer-ready resolution (value/props/condition/issue). */\n  resolve: (ref: BindingReference, item?: RepeaterItemContext) => BindingResolution\n  /** Resolve a binding to the concrete value the renderer injects (EC-086–089). */\n  resolveValue: (ref: BindingReference, item?: RepeaterItemContext) => JsonValue | undefined\n  /** Evaluate a condition against the captured payloads (EC-088). */\n  resolveCondition: (condition: Condition, item?: RepeaterItemContext) => ConditionResolution\n}\n\nexport interface DataState {\n  sources: DataSource[]\n  /**\n   * Ids provisioned or removed in THIS session. Hydration (which resolves\n   * asynchronously) never overrides them — the editor's latest action wins\n   * over whatever was persisted before it.\n   */\n  sessionIds: ReadonlySet<string>\n}\n\nexport type DataAction =\n  | { type: 'remove'; id: string }\n  | { type: 'provision'; source: DataSource }\n  /** Merge the project's persisted source records in (persisted wins over seeds). */\n  | { type: 'hydrate'; sources: DataSource[] }\n\nfunction upsert(sources: DataSource[], source: DataSource): DataSource[] {\n  const exists = sources.some((s) => s.id === source.id)\n  return exists ? sources.map((s) => (s.id === source.id ? source : s)) : [...sources, source]\n}\n\n/**\n * A persisted record hydrates as-is when it carries its captured sample;\n * otherwise recapture. Exception (EC-177 gap 1): with a hydrated content\n * session configured (Convex mode), CMS sources ALWAYS recapture by replaying\n * their stored query over the live documents — a sample captured by an earlier\n * session may carry stale (or fixture-derived) entries.\n */\nfunction withSample(source: DataSource): DataSource {\n  if (source.kind === 'cms' && hasContentSession()) {\n    const sample = captureSourceSample(source)\n    return sample !== undefined ? captureSample(source, sample) : source\n  }\n  if (source.sample !== undefined) return source\n  // No persisted sample: try an honest capture (a provider runs; anything the\n  // studio can't fetch returns undefined) — never fabricate.\n  const sample = captureSourceSample(source)\n  return sample !== undefined ? captureSample(source, sample) : source\n}\n\n/**\n * The store's reducer, exported because hydration/session-precedence semantics\n * live here and the app's test harness has no DOM to drive effects through.\n */\nexport function dataStateReducer(state: DataState, action: DataAction): DataState {\n  switch (action.type) {\n    case 'remove':\n      return {\n        ...state,\n        sources: state.sources.filter((s) => s.id !== action.id),\n        sessionIds: new Set([...state.sessionIds, action.id]),\n      }\n    case 'provision': {\n      // Upsert by id; attach a sample only if one can be captured honestly (a\n      // provider run, or live CMS content) — otherwise the source carries none.\n      const sample = captureSourceSample(action.source)\n      const provisioned = sample !== undefined ? captureSample(action.source, sample) : action.source\n      return {\n        ...state,\n        sources: upsert(state.sources, provisioned),\n        sessionIds: new Set([...state.sessionIds, provisioned.id]),\n      }\n    }\n    case 'hydrate': {\n      let sources = state.sources\n      for (const source of action.sources) {\n        if (state.sessionIds.has(source.id)) continue // this session already decided\n        sources = upsert(sources, withSample(source))\n      }\n      return sources === state.sources ? state : { ...state, sources }\n    }\n    default:\n      return state\n  }\n}\n\nconst { Context: DataContext, useRequired: useData } = createRequiredContext<DataStore>('Data')\n\n/**\n * The session's starting state: EMPTY. The studio seeds no sample sources (Oli,\n * 2026-06-19) — real sources arrive from the project's config collections (the\n * hydrate effect, Convex mode) or are added by the author. Nothing is faked.\n */\nexport function initialDataState(): DataState {\n  return { sources: [], sessionIds: new Set() }\n}\n\nexport interface DataProviderProps {\n  children: ReactNode\n  /**\n   * When set, the store hydrates from and persists to this project's\n   * `cms-data-sources` system collection (through `@elytracms/core/operations`).\n   * Without it the store is pure session state (tests, fixtures).\n   */\n  projectId?: string\n}\n\nexport function DataProvider({ children, projectId }: DataProviderProps) {\n  const [state, dispatch] = useReducer(dataStateReducer, undefined, initialDataState)\n  const [persistError, setPersistError] = useState<string | null>(null)\n\n  // EC-192: surface every config-driven content collection as a pickable CMS\n  // source, so the binding/condition pickers list what actually exists — the\n  // same collection set the CMS uses (`resolveDeploymentCollections`) — rather\n  // than only the demo fixture sources. Merged additively (the `hydrate` upsert\n  // skips session-decided ids and recaptures live samples in Convex mode); studio\n  // SYSTEM collections (routes/redirects/saved views/data sources) are excluded.\n  useEffect(() => {\n    if (projectId === undefined) return\n    const collections = resolveDeploymentCollections().filter(\n      (collection) => !STUDIO_SYSTEM_COLLECTION_IDS.has(collection.id),\n    )\n    if (collections.length === 0) return\n    dispatch({ type: 'hydrate', sources: collections.map(cmsSourceForCollection) })\n  }, [projectId])\n\n  // Hydrate the project's persisted sources through the one operations-backed\n  // query cache (EC-308/AD-17). Sources provisioned by other sessions on the\n  // same project show up here; the playground seeds stay for everything not\n  // persisted. The reducer's `hydrate` keeps session precedence — a source\n  // provisioned/removed in THIS session always wins over the hydrated list.\n  const cache = useOperationCache()\n  const sourcesQuery = useOperationQuery<DataSource[]>({\n    queryKey: ['dataSources', projectId ?? '∅'],\n    loader: async (operations) => {\n      const result = await loadDataSources(operations, projectId as string)\n      if (!result.ok) throw new Error(result.error.message)\n      return result.value\n    },\n    enabled: projectId !== undefined,\n  })\n  const hydratedSources = sourcesQuery.data\n  useEffect(() => {\n    if (hydratedSources) dispatch({ type: 'hydrate', sources: hydratedSources })\n  }, [hydratedSources])\n  const sourcesError = sourcesQuery.isError ? sourcesQuery.error : null\n  useEffect(() => {\n    if (sourcesError)\n      setPersistError(sourcesError instanceof Error ? sourcesError.message : 'Loading data sources failed.')\n  }, [sourcesError])\n\n  // Best-effort persistence on top of the live session: the canvas keeps\n  // working on session state; a failed write surfaces via `persistError`. On a\n  // confirmed write, invalidate the hydration query so a later remount\n  // re-hydrates the provisioned/removed source rather than a stale list.\n  const persist = useCallback(\n    (write: (operations: OperationsClient, projectId: string) => Promise<OperationResult<void>>) => {\n      if (projectId === undefined) return\n      void getStudioOperations()\n        .then(({ operations }) => write(operations, projectId))\n        .then((result) => {\n          if (!result.ok) {\n            setPersistError(result.error.message)\n            return\n          }\n          void cache.invalidate(['dataSources', projectId])\n        })\n        .catch((error: unknown) => {\n          setPersistError(error instanceof Error ? error.message : 'Saving the data source failed.')\n        })\n    },\n    [projectId, cache],\n  )\n\n  const store = useMemo<DataStore>(() => {\n    const registry = SourceRegistry.from(state.sources)\n    const payloads: Record<string, JsonValue> = {}\n    for (const source of state.sources) {\n      if (source.sample !== undefined) payloads[source.id] = source.sample\n    }\n    const knownSourceIds = registry.knownSourceIds()\n    const ctx = { payloads, registry }\n\n    const getSource = (id: string) => registry.get(id)\n    const resolve = (ref: BindingReference, item?: RepeaterItemContext) =>\n      resolveBinding(ref, ctx, item)\n\n    return {\n      sources: state.sources,\n      registry,\n      payloads,\n      knownSourceIds,\n      getSource,\n      removeSource: (id) => {\n        dispatch({ type: 'remove', id })\n        persist((operations, pid) => deleteDataSource(operations, pid, id))\n      },\n      provisionSource: (source) => {\n        dispatch({ type: 'provision', source })\n        // Persist exactly what the session resolves: the source plus any sample\n        // that can be captured honestly (a provider run / live CMS content) —\n        // never a fabricated one. Matches the `provision` reducer.\n        const sample = captureSourceSample(source)\n        const provisioned = sample !== undefined ? captureSample(source, sample) : source\n        persist((operations, pid) => saveDataSource(operations, pid, provisioned))\n      },\n      persistError,\n      tokensOf: (id) => {\n        const schema = getSource(id)?.schema\n        return schema ? tokensForSchema(schema) : []\n      },\n      schemaOf: (id) => {\n        const source = getSource(id)\n        if (source?.schema) return source.schema\n        if (source?.sample !== undefined) return inferSchema(source.sample)\n        return undefined\n      },\n      sampleOf: (id) => getSource(id)?.sample,\n      resolve,\n      resolveValue: (ref, item) => {\n        const r = resolve(ref, item)\n        switch (r.kind) {\n          case 'value':\n            return r.value\n          case 'props':\n            return r.props\n          case 'condition':\n            return r.pass\n          case 'issue':\n            return undefined\n          default: {\n            const never: never = r\n            return never\n          }\n        }\n      },\n      resolveCondition: (condition, item) => resolveCondition(condition, ctx, item),\n    }\n  }, [state, persist, persistError])\n\n  return <DataContext.Provider value={store}>{children}</DataContext.Provider>\n}\n\nexport { useData }\n"]}

package/dist/lib/data/providers.d.ts

@@ -1,143 +0,0 @@
-import { z } from 'zod';
-import type { ConvexSource, DataSource } from '@elytracms/core/data-binding';
-import type { JsonValue } from '@elytracms/core/project-graph';
-/**
- * Typed data providers (EC-167, vision AD-9). External data is a developer
- * concern expressed exactly like a component: a provider is a plain function
- * plus a manifest (id, title, description, output schema, optional params)
- * registered in code. Editors never see providers as anything technical — the
- * Content tab offers them next to CMS collections, labeled by their
- * plain-language titles, and provider results resolve through the unchanged
- * `@elytracms/core/data-binding` engine.
- *
- * Registration mirrors how component manifests register: project code defines
- * providers and registers them in-process here. In a host repository the same
- * definitions would be extracted into synced manifests (the EC-147 component
- * manifest sync path) with the function itself executed behind the
- * project-owned adapter — an honest gap today: this playground registry IS the
- * project code, so "sync" is a direct import.
- *
- * Bridging into the engine: a provider is addressed as a `convex`-kind data
- * source whose `functionRef` is `provider:<id>` — a provider is exactly a
- * typed server function, and the engine's source vocabulary already models
- * that. Resolution, sampling, inference, tokens, and broken-binding issues all
- * apply unchanged. (See NOTES: the engine could gain a first-class `provider`
- * source kind as a purely additive change.)
- */
-/** A scalar an editor can put into a provider param control. */
-export type ProviderParamValue = string | number | boolean;
-/** One choice of a `choice`-kind param. */
-export interface ProviderParamChoice {
-    value: string;
-    label: string;
-}
-/**
- * A provider param, surfaced to editors as one plain control (no syntax, no
- * JSON): `choice` renders a select over {@link choices}; the scalar kinds
- * render a matching input.
- */
-export interface ProviderParamSpec {
-    name: string;
-    /** Plain-language control label, e.g. "Department". */
-    label: string;
-    kind: 'text' | 'number' | 'boolean' | 'choice';
-    /** For `choice` params: the closed set of offered values. */
-    choices?: ProviderParamChoice[];
-    defaultValue: ProviderParamValue;
-}
-/** Arguments a provider runs with (param name → value). */
-export type ProviderArgs = Record<string, JsonValue>;
-/** The manifest half of a provider — everything the builder surfaces. */
-export interface DataProviderManifest {
-    /** Stable provider id, e.g. `pricing-plans`. */
-    id: string;
-    /** Plain-language title editors pick, e.g. "Pricing plans". */
-    title: string;
-    description: string;
-    /** Zod schema of the payload; every run is validated against it. */
-    output: z.ZodType<JsonValue>;
-    params?: ProviderParamSpec[];
-}
-/** A data provider: a typed function plus its manifest. */
-export interface DataProvider {
-    manifest: DataProviderManifest;
-    /** Produce the payload. Deterministic here; a host repo may make this async behind its adapter. */
-    fetch: (args: ProviderArgs) => JsonValue;
-}
-/**
- * Define a provider with the output type checked against the schema — the
- * provider-side mirror of `defineDataSourceAdapter` (EC-132) and component
- * `ComponentManifest` definitions.
- */
-export declare function defineDataProvider<T extends JsonValue>(provider: {
-    manifest: Omit<DataProviderManifest, 'output'> & {
-        output: z.ZodType<T>;
-    };
-    fetch: (args: ProviderArgs) => T;
-}): DataProvider;
-/** A structured registration issue — duplicates are reported, never thrown. */
-export interface ProviderRegistrationIssue {
-    code: 'duplicate' | 'invalid-id';
-    message: string;
-    ref: string;
-}
-/**
- * Registry of data providers keyed by id. First registration wins; duplicates
- * and malformed ids are recorded as structured issues (component-registry
- * semantics).
- */
-export declare class DataProviderRegistry {
-    private readonly byId;
-    readonly issues: ProviderRegistrationIssue[];
-    constructor(providers?: Iterable<DataProvider>);
-    register(provider: DataProvider): void;
-    get(id: string): DataProvider | undefined;
-    list(): DataProvider[];
-    get size(): number;
-}
-/** The outcome of one provider run: a validated payload or a plain-language issue. */
-export type ProviderRun = {
-    ok: true;
-    value: JsonValue;
-} | {
-    ok: false;
-    message: string;
-};
-/** Default args of a provider (its params' declared defaults). */
-export declare function defaultProviderArgs(manifest: DataProviderManifest): ProviderArgs;
-/**
- * Run a provider and validate the result against its output schema. A thrown
- * error or a schema mismatch comes back as a plain-language issue — the
- * binding layer renders a visible fallback, never a crash.
- */
-export declare function runProvider(provider: DataProvider, args?: ProviderArgs): ProviderRun;
-/** Shared project-wide provider sources: `provider.<providerId>`. */
-export declare const PROVIDER_SOURCE_PREFIX = "provider.";
-export declare function providerSourceIdFor(providerId: string): string;
-/** The provider a source is backed by, or undefined for non-provider sources. */
-export declare function providerIdOfSource(source: DataSource | undefined): string | undefined;
-/**
- * The engine-shaped source addressing a provider. `args` carry the editor's
- * param choices; `id` defaults to the shared project-wide source.
- */
-export declare function providerSourceFor(provider: DataProvider, args?: ProviderArgs, id?: string, label?: string): ConvexSource;
-/** Example provider: a static, code-owned pricing table (think Stripe prices). */
-export declare const pricingPlansProvider: DataProvider;
-/** Example provider with a param: job listings filterable by department. */
-export declare const jobListingsProvider: DataProvider;
-/**
- * The project's provider registry. In a deployed studio this hydrates from
- * synced provider manifests (the component-manifest sync path); in the
- * playground the project code registers directly.
- */
-export declare const projectDataProviders: DataProviderRegistry;
-export declare function listDataProviders(): DataProvider[];
-export declare function getDataProvider(id: string): DataProvider | undefined;
-/**
- * The payload a provider-backed source serves, or `null` when the provider is
- * unregistered or failing — a `null` sample makes every binding against it a
- * visible plain-language issue instead of a crash.
- */
-export declare function providerPayload(providerId: string, args?: ProviderArgs): JsonValue;
-/** A provider's canonical sample (its default-args run), or undefined when failing. */
-export declare function providerSample(provider: DataProvider): JsonValue | undefined;

package/dist/lib/data/providers.js

@@ -1,255 +0,0 @@
-import { z } from 'zod';
-/**
- * Define a provider with the output type checked against the schema — the
- * provider-side mirror of `defineDataSourceAdapter` (EC-132) and component
- * `ComponentManifest` definitions.
- */
-export function defineDataProvider(provider) {
-    return provider;
-}
-const PROVIDER_ID_PATTERN = /^[a-z][a-z0-9-]*$/;
-/**
- * Registry of data providers keyed by id. First registration wins; duplicates
- * and malformed ids are recorded as structured issues (component-registry
- * semantics).
- */
-export class DataProviderRegistry {
-    byId = new Map();
-    issues = [];
-    constructor(providers = []) {
-        for (const provider of providers)
-            this.register(provider);
-    }
-    register(provider) {
-        const id = provider.manifest.id;
-        if (!PROVIDER_ID_PATTERN.test(id)) {
-            this.issues.push({
-                code: 'invalid-id',
-                ref: id,
-                message: `Provider id "${id}" must be lower-case and dash-separated (e.g. "pricing-plans").`,
-            });
-            return;
-        }
-        if (this.byId.has(id)) {
-            this.issues.push({
-                code: 'duplicate',
-                ref: id,
-                message: `Duplicate provider id "${id}" — keeping the first registration.`,
-            });
-            return;
-        }
-        this.byId.set(id, provider);
-    }
-    get(id) {
-        return this.byId.get(id);
-    }
-    list() {
-        return [...this.byId.values()];
-    }
-    get size() {
-        return this.byId.size;
-    }
-}
-/** Default args of a provider (its params' declared defaults). */
-export function defaultProviderArgs(manifest) {
-    return Object.fromEntries((manifest.params ?? []).map((p) => [p.name, p.defaultValue]));
-}
-/**
- * Run a provider and validate the result against its output schema. A thrown
- * error or a schema mismatch comes back as a plain-language issue — the
- * binding layer renders a visible fallback, never a crash.
- */
-export function runProvider(provider, args) {
-    const title = provider.manifest.title;
-    let raw;
-    try {
-        raw = provider.fetch(args ?? defaultProviderArgs(provider.manifest));
-    }
-    catch {
-        return {
-            ok: false,
-            message: `“${title}” couldn't load right now — the project code reported a problem. Anything showing it stays empty until it's fixed.`,
-        };
-    }
-    const parsed = provider.manifest.output.safeParse(raw);
-    if (!parsed.success) {
-        return {
-            ok: false,
-            message: `“${title}” returned data in an unexpected shape, so it can't be shown. The project code and its declared output no longer agree.`,
-        };
-    }
-    return { ok: true, value: parsed.data };
-}
-// ---------------------------------------------------------------------------
-// Bridging providers into the binding engine's source vocabulary
-// ---------------------------------------------------------------------------
-/** Shared project-wide provider sources: `provider.<providerId>`. */
-export const PROVIDER_SOURCE_PREFIX = 'provider.';
-/** The functionRef namespace marking a source as provider-backed. */
-const PROVIDER_FUNCTION_PREFIX = 'provider:';
-export function providerSourceIdFor(providerId) {
-    return `${PROVIDER_SOURCE_PREFIX}${providerId}`;
-}
-/** The provider a source is backed by, or undefined for non-provider sources. */
-export function providerIdOfSource(source) {
-    if (source === undefined || source.kind !== 'convex')
-        return undefined;
-    const ref = source.config.functionRef;
-    return ref.startsWith(PROVIDER_FUNCTION_PREFIX)
-        ? ref.slice(PROVIDER_FUNCTION_PREFIX.length)
-        : undefined;
-}
-/**
- * The engine-shaped source addressing a provider. `args` carry the editor's
- * param choices; `id` defaults to the shared project-wide source.
- */
-export function providerSourceFor(provider, args, id, label) {
-    return {
-        kind: 'convex',
-        id: id ?? providerSourceIdFor(provider.manifest.id),
-        label: label ?? provider.manifest.title,
-        config: {
-            operation: 'query',
-            functionRef: `${PROVIDER_FUNCTION_PREFIX}${provider.manifest.id}`,
-            args: args ?? defaultProviderArgs(provider.manifest),
-        },
-    };
-}
-// ---------------------------------------------------------------------------
-// The project's registered providers (project-owned, code-first)
-// ---------------------------------------------------------------------------
-const pricingPlanSchema = z.object({
-    id: z.string(),
-    name: z.string(),
-    monthlyPrice: z.number(),
-    summary: z.string(),
-    featured: z.boolean(),
-});
-/** Example provider: a static, code-owned pricing table (think Stripe prices). */
-export const pricingPlansProvider = defineDataProvider({
-    manifest: {
-        id: 'pricing-plans',
-        title: 'Pricing plans',
-        description: 'The pricing tiers exactly as the billing code defines them.',
-        output: z.array(pricingPlanSchema),
-    },
-    fetch: () => [
-        {
-            id: 'starter',
-            name: 'Starter',
-            monthlyPrice: 19,
-            summary: 'For solo builders shipping their first site.',
-            featured: false,
-        },
-        {
-            id: 'studio',
-            name: 'Studio',
-            monthlyPrice: 49,
-            summary: 'For teams that publish every week.',
-            featured: true,
-        },
-        {
-            id: 'enterprise',
-            name: 'Enterprise',
-            monthlyPrice: 199,
-            summary: 'For organizations with compliance needs.',
-            featured: false,
-        },
-    ],
-});
-const jobListingSchema = z.object({
-    id: z.string(),
-    title: z.string(),
-    department: z.string(),
-    location: z.string(),
-    remote: z.boolean(),
-});
-const JOB_LISTINGS = [
-    {
-        id: 'job-fe',
-        title: 'Frontend Engineer',
-        department: 'Engineering',
-        location: 'Berlin',
-        remote: true,
-    },
-    {
-        id: 'job-be',
-        title: 'Backend Engineer',
-        department: 'Engineering',
-        location: 'Amsterdam',
-        remote: true,
-    },
-    {
-        id: 'job-pd',
-        title: 'Product Designer',
-        department: 'Design',
-        location: 'Berlin',
-        remote: false,
-    },
-    {
-        id: 'job-cm',
-        title: 'Content Marketer',
-        department: 'Marketing',
-        location: 'Remote',
-        remote: true,
-    },
-];
-/** Example provider with a param: job listings filterable by department. */
-export const jobListingsProvider = defineDataProvider({
-    manifest: {
-        id: 'job-listings',
-        title: 'Job listings',
-        description: 'Open roles from the hiring system, optionally narrowed to one department.',
-        output: z.array(jobListingSchema),
-        params: [
-            {
-                name: 'department',
-                label: 'Department',
-                kind: 'choice',
-                choices: [
-                    { value: 'all', label: 'All departments' },
-                    { value: 'Engineering', label: 'Engineering' },
-                    { value: 'Design', label: 'Design' },
-                    { value: 'Marketing', label: 'Marketing' },
-                ],
-                defaultValue: 'all',
-            },
-        ],
-    },
-    fetch: ({ department }) => typeof department === 'string' && department !== 'all'
-        ? JOB_LISTINGS.filter((job) => job.department === department)
-        : [...JOB_LISTINGS],
-});
-/**
- * The project's provider registry. In a deployed studio this hydrates from
- * synced provider manifests (the component-manifest sync path); in the
- * playground the project code registers directly.
- */
-export const projectDataProviders = new DataProviderRegistry([
-    pricingPlansProvider,
-    jobListingsProvider,
-]);
-export function listDataProviders() {
-    return projectDataProviders.list();
-}
-export function getDataProvider(id) {
-    return projectDataProviders.get(id);
-}
-/**
- * The payload a provider-backed source serves, or `null` when the provider is
- * unregistered or failing — a `null` sample makes every binding against it a
- * visible plain-language issue instead of a crash.
- */
-export function providerPayload(providerId, args) {
-    const provider = getDataProvider(providerId);
-    if (provider === undefined)
-        return null;
-    const run = runProvider(provider, args);
-    return run.ok ? run.value : null;
-}
-/** A provider's canonical sample (its default-args run), or undefined when failing. */
-export function providerSample(provider) {
-    const run = runProvider(provider);
-    return run.ok ? run.value : undefined;
-}
-//# sourceMappingURL=providers.js.map

package/dist/lib/data/providers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../../src/lib/data/providers.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod'\nimport type { ConvexSource, DataSource } from '@elytracms/core/data-binding'\nimport type { JsonValue } from '@elytracms/core/project-graph'\n\n/**\n * Typed data providers (EC-167, vision AD-9). External data is a developer\n * concern expressed exactly like a component: a provider is a plain function\n * plus a manifest (id, title, description, output schema, optional params)\n * registered in code. Editors never see providers as anything technical — the\n * Content tab offers them next to CMS collections, labeled by their\n * plain-language titles, and provider results resolve through the unchanged\n * `@elytracms/core/data-binding` engine.\n *\n * Registration mirrors how component manifests register: project code defines\n * providers and registers them in-process here. In a host repository the same\n * definitions would be extracted into synced manifests (the EC-147 component\n * manifest sync path) with the function itself executed behind the\n * project-owned adapter — an honest gap today: this playground registry IS the\n * project code, so \"sync\" is a direct import.\n *\n * Bridging into the engine: a provider is addressed as a `convex`-kind data\n * source whose `functionRef` is `provider:<id>` — a provider is exactly a\n * typed server function, and the engine's source vocabulary already models\n * that. Resolution, sampling, inference, tokens, and broken-binding issues all\n * apply unchanged. (See NOTES: the engine could gain a first-class `provider`\n * source kind as a purely additive change.)\n */\n\n/** A scalar an editor can put into a provider param control. */\nexport type ProviderParamValue = string | number | boolean\n\n/** One choice of a `choice`-kind param. */\nexport interface ProviderParamChoice {\n  value: string\n  label: string\n}\n\n/**\n * A provider param, surfaced to editors as one plain control (no syntax, no\n * JSON): `choice` renders a select over {@link choices}; the scalar kinds\n * render a matching input.\n */\nexport interface ProviderParamSpec {\n  name: string\n  /** Plain-language control label, e.g. \"Department\". */\n  label: string\n  kind: 'text' | 'number' | 'boolean' | 'choice'\n  /** For `choice` params: the closed set of offered values. */\n  choices?: ProviderParamChoice[]\n  defaultValue: ProviderParamValue\n}\n\n/** Arguments a provider runs with (param name → value). */\nexport type ProviderArgs = Record<string, JsonValue>\n\n/** The manifest half of a provider — everything the builder surfaces. */\nexport interface DataProviderManifest {\n  /** Stable provider id, e.g. `pricing-plans`. */\n  id: string\n  /** Plain-language title editors pick, e.g. \"Pricing plans\". */\n  title: string\n  description: string\n  /** Zod schema of the payload; every run is validated against it. */\n  output: z.ZodType<JsonValue>\n  params?: ProviderParamSpec[]\n}\n\n/** A data provider: a typed function plus its manifest. */\nexport interface DataProvider {\n  manifest: DataProviderManifest\n  /** Produce the payload. Deterministic here; a host repo may make this async behind its adapter. */\n  fetch: (args: ProviderArgs) => JsonValue\n}\n\n/**\n * Define a provider with the output type checked against the schema — the\n * provider-side mirror of `defineDataSourceAdapter` (EC-132) and component\n * `ComponentManifest` definitions.\n */\nexport function defineDataProvider<T extends JsonValue>(provider: {\n  manifest: Omit<DataProviderManifest, 'output'> & { output: z.ZodType<T> }\n  fetch: (args: ProviderArgs) => T\n}): DataProvider {\n  return provider as DataProvider\n}\n\n// ---------------------------------------------------------------------------\n// Registration (mirrors the component-registry contract)\n// ---------------------------------------------------------------------------\n\n/** A structured registration issue — duplicates are reported, never thrown. */\nexport interface ProviderRegistrationIssue {\n  code: 'duplicate' | 'invalid-id'\n  message: string\n  ref: string\n}\n\nconst PROVIDER_ID_PATTERN = /^[a-z][a-z0-9-]*$/\n\n/**\n * Registry of data providers keyed by id. First registration wins; duplicates\n * and malformed ids are recorded as structured issues (component-registry\n * semantics).\n */\nexport class DataProviderRegistry {\n  private readonly byId = new Map<string, DataProvider>()\n  readonly issues: ProviderRegistrationIssue[] = []\n\n  constructor(providers: Iterable<DataProvider> = []) {\n    for (const provider of providers) this.register(provider)\n  }\n\n  register(provider: DataProvider): void {\n    const id = provider.manifest.id\n    if (!PROVIDER_ID_PATTERN.test(id)) {\n      this.issues.push({\n        code: 'invalid-id',\n        ref: id,\n        message: `Provider id \"${id}\" must be lower-case and dash-separated (e.g. \"pricing-plans\").`,\n      })\n      return\n    }\n    if (this.byId.has(id)) {\n      this.issues.push({\n        code: 'duplicate',\n        ref: id,\n        message: `Duplicate provider id \"${id}\" — keeping the first registration.`,\n      })\n      return\n    }\n    this.byId.set(id, provider)\n  }\n\n  get(id: string): DataProvider | undefined {\n    return this.byId.get(id)\n  }\n\n  list(): DataProvider[] {\n    return [...this.byId.values()]\n  }\n\n  get size(): number {\n    return this.byId.size\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Running a provider (never throws, never crashes a surface)\n// ---------------------------------------------------------------------------\n\n/** The outcome of one provider run: a validated payload or a plain-language issue. */\nexport type ProviderRun =\n  | { ok: true; value: JsonValue }\n  | { ok: false; message: string }\n\n/** Default args of a provider (its params' declared defaults). */\nexport function defaultProviderArgs(manifest: DataProviderManifest): ProviderArgs {\n  return Object.fromEntries((manifest.params ?? []).map((p) => [p.name, p.defaultValue]))\n}\n\n/**\n * Run a provider and validate the result against its output schema. A thrown\n * error or a schema mismatch comes back as a plain-language issue — the\n * binding layer renders a visible fallback, never a crash.\n */\nexport function runProvider(provider: DataProvider, args?: ProviderArgs): ProviderRun {\n  const title = provider.manifest.title\n  let raw: JsonValue\n  try {\n    raw = provider.fetch(args ?? defaultProviderArgs(provider.manifest))\n  } catch {\n    return {\n      ok: false,\n      message: `“${title}” couldn't load right now — the project code reported a problem. Anything showing it stays empty until it's fixed.`,\n    }\n  }\n  const parsed = provider.manifest.output.safeParse(raw)\n  if (!parsed.success) {\n    return {\n      ok: false,\n      message: `“${title}” returned data in an unexpected shape, so it can't be shown. The project code and its declared output no longer agree.`,\n    }\n  }\n  return { ok: true, value: parsed.data }\n}\n\n// ---------------------------------------------------------------------------\n// Bridging providers into the binding engine's source vocabulary\n// ---------------------------------------------------------------------------\n\n/** Shared project-wide provider sources: `provider.<providerId>`. */\nexport const PROVIDER_SOURCE_PREFIX = 'provider.'\n\n/** The functionRef namespace marking a source as provider-backed. */\nconst PROVIDER_FUNCTION_PREFIX = 'provider:'\n\nexport function providerSourceIdFor(providerId: string): string {\n  return `${PROVIDER_SOURCE_PREFIX}${providerId}`\n}\n\n/** The provider a source is backed by, or undefined for non-provider sources. */\nexport function providerIdOfSource(source: DataSource | undefined): string | undefined {\n  if (source === undefined || source.kind !== 'convex') return undefined\n  const ref = source.config.functionRef\n  return ref.startsWith(PROVIDER_FUNCTION_PREFIX)\n    ? ref.slice(PROVIDER_FUNCTION_PREFIX.length)\n    : undefined\n}\n\n/**\n * The engine-shaped source addressing a provider. `args` carry the editor's\n * param choices; `id` defaults to the shared project-wide source.\n */\nexport function providerSourceFor(\n  provider: DataProvider,\n  args?: ProviderArgs,\n  id?: string,\n  label?: string,\n): ConvexSource {\n  return {\n    kind: 'convex',\n    id: id ?? providerSourceIdFor(provider.manifest.id),\n    label: label ?? provider.manifest.title,\n    config: {\n      operation: 'query',\n      functionRef: `${PROVIDER_FUNCTION_PREFIX}${provider.manifest.id}`,\n      args: args ?? defaultProviderArgs(provider.manifest),\n    },\n  }\n}\n\n// ---------------------------------------------------------------------------\n// The project's registered providers (project-owned, code-first)\n// ---------------------------------------------------------------------------\n\nconst pricingPlanSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  monthlyPrice: z.number(),\n  summary: z.string(),\n  featured: z.boolean(),\n})\n\n/** Example provider: a static, code-owned pricing table (think Stripe prices). */\nexport const pricingPlansProvider = defineDataProvider({\n  manifest: {\n    id: 'pricing-plans',\n    title: 'Pricing plans',\n    description: 'The pricing tiers exactly as the billing code defines them.',\n    output: z.array(pricingPlanSchema),\n  },\n  fetch: () => [\n    {\n      id: 'starter',\n      name: 'Starter',\n      monthlyPrice: 19,\n      summary: 'For solo builders shipping their first site.',\n      featured: false,\n    },\n    {\n      id: 'studio',\n      name: 'Studio',\n      monthlyPrice: 49,\n      summary: 'For teams that publish every week.',\n      featured: true,\n    },\n    {\n      id: 'enterprise',\n      name: 'Enterprise',\n      monthlyPrice: 199,\n      summary: 'For organizations with compliance needs.',\n      featured: false,\n    },\n  ],\n})\n\nconst jobListingSchema = z.object({\n  id: z.string(),\n  title: z.string(),\n  department: z.string(),\n  location: z.string(),\n  remote: z.boolean(),\n})\n\nconst JOB_LISTINGS = [\n  {\n    id: 'job-fe',\n    title: 'Frontend Engineer',\n    department: 'Engineering',\n    location: 'Berlin',\n    remote: true,\n  },\n  {\n    id: 'job-be',\n    title: 'Backend Engineer',\n    department: 'Engineering',\n    location: 'Amsterdam',\n    remote: true,\n  },\n  {\n    id: 'job-pd',\n    title: 'Product Designer',\n    department: 'Design',\n    location: 'Berlin',\n    remote: false,\n  },\n  {\n    id: 'job-cm',\n    title: 'Content Marketer',\n    department: 'Marketing',\n    location: 'Remote',\n    remote: true,\n  },\n] as const\n\n/** Example provider with a param: job listings filterable by department. */\nexport const jobListingsProvider = defineDataProvider({\n  manifest: {\n    id: 'job-listings',\n    title: 'Job listings',\n    description: 'Open roles from the hiring system, optionally narrowed to one department.',\n    output: z.array(jobListingSchema),\n    params: [\n      {\n        name: 'department',\n        label: 'Department',\n        kind: 'choice',\n        choices: [\n          { value: 'all', label: 'All departments' },\n          { value: 'Engineering', label: 'Engineering' },\n          { value: 'Design', label: 'Design' },\n          { value: 'Marketing', label: 'Marketing' },\n        ],\n        defaultValue: 'all',\n      },\n    ],\n  },\n  fetch: ({ department }) =>\n    typeof department === 'string' && department !== 'all'\n      ? JOB_LISTINGS.filter((job) => job.department === department)\n      : [...JOB_LISTINGS],\n})\n\n/**\n * The project's provider registry. In a deployed studio this hydrates from\n * synced provider manifests (the component-manifest sync path); in the\n * playground the project code registers directly.\n */\nexport const projectDataProviders = new DataProviderRegistry([\n  pricingPlansProvider,\n  jobListingsProvider,\n])\n\nexport function listDataProviders(): DataProvider[] {\n  return projectDataProviders.list()\n}\n\nexport function getDataProvider(id: string): DataProvider | undefined {\n  return projectDataProviders.get(id)\n}\n\n/**\n * The payload a provider-backed source serves, or `null` when the provider is\n * unregistered or failing — a `null` sample makes every binding against it a\n * visible plain-language issue instead of a crash.\n */\nexport function providerPayload(providerId: string, args?: ProviderArgs): JsonValue {\n  const provider = getDataProvider(providerId)\n  if (provider === undefined) return null\n  const run = runProvider(provider, args)\n  return run.ok ? run.value : null\n}\n\n/** A provider's canonical sample (its default-args run), or undefined when failing. */\nexport function providerSample(provider: DataProvider): JsonValue | undefined {\n  const run = runProvider(provider)\n  return run.ok ? run.value : undefined\n}\n"]}

package/dist/lib/data/sample-capture.d.ts

@@ -1,30 +0,0 @@
-import type { DataSource } from '@elytracms/core/data-binding';
-import type { JsonValue } from '@elytracms/core/project-graph';
-import type { CollectionDef } from '@elytracms/core/cms-core';
-/**
- * Data-source sample capture (EC-083/EC-166/EC-167). The hosted builder is
- * separate from the site it exports: actually performing a REST fetch / external
- * query happens behind the project-owned adapters in the deployed site, NOT here.
- * So the studio captures a sample ONLY when it can do so honestly — it never
- * fabricates data (Oli, 2026-06-19; cf. backend-mode's "never silently swap in
- * in-memory storage", and the v1 "static props, bindings parked" direction):
- *
- * - a provider-backed source runs its registered provider (real project code);
- * - a CMS source replays its stored query over the live content session (Convex
- *   mode — EC-177 gap 1), so section/template previews show what delivery serves;
- * - anything else — an external source with no in-studio data path — returns
- *   `undefined`. The source then carries no sample, and the binding UI shows an
- *   honest "no sample yet" state instead of inventing rows that aren't there.
- */
-export declare function captureSourceSample(source: DataSource): JsonValue | undefined;
-/**
- * A live CMS data source for one config-driven collection (EC-192). The binding
- * and condition pickers enumerate `data.sources`; deriving one source per
- * configured content collection — the same set the CMS uses
- * (`resolveDeploymentCollections`) — means what an editor can bind matches what
- * actually exists. The sample is captured by replaying the collection's list
- * query through the canonical content engine, so when a content session is
- * configured (Convex mode) the inferred field tokens are the collection's real
- * fields; with no session the source is listed but carries no sample.
- */
-export declare function cmsSourceForCollection(collection: CollectionDef): DataSource;

package/dist/lib/data/sample-capture.js

@@ -1,70 +0,0 @@
-import { captureSample } from '@elytracms/core/data-binding';
-import { humanizeName } from '../utils.js';
-import { listQueryOfConfig } from '../bindings/section-bindings.js';
-import { getCollectionDocument, hasContentSession, playgroundCollection, runCollectionListQuery, } from './collection-content.js';
-import { providerIdOfSource, providerPayload } from './providers.js';
-/**
- * Data-source sample capture (EC-083/EC-166/EC-167). The hosted builder is
- * separate from the site it exports: actually performing a REST fetch / external
- * query happens behind the project-owned adapters in the deployed site, NOT here.
- * So the studio captures a sample ONLY when it can do so honestly — it never
- * fabricates data (Oli, 2026-06-19; cf. backend-mode's "never silently swap in
- * in-memory storage", and the v1 "static props, bindings parked" direction):
- *
- * - a provider-backed source runs its registered provider (real project code);
- * - a CMS source replays its stored query over the live content session (Convex
- *   mode — EC-177 gap 1), so section/template previews show what delivery serves;
- * - anything else — an external source with no in-studio data path — returns
- *   `undefined`. The source then carries no sample, and the binding UI shows an
- *   honest "no sample yet" state instead of inventing rows that aren't there.
- */
-export function captureSourceSample(source) {
-    const providerId = providerIdOfSource(source);
-    if (providerId !== undefined) {
-        return providerPayload(providerId, source.kind === 'convex' ? source.config.args : undefined);
-    }
-    if (source.kind === 'cms') {
-        return cmsDeliverySample(source.config);
-    }
-    return undefined;
-}
-/**
- * A live CMS data source for one config-driven collection (EC-192). The binding
- * and condition pickers enumerate `data.sources`; deriving one source per
- * configured content collection — the same set the CMS uses
- * (`resolveDeploymentCollections`) — means what an editor can bind matches what
- * actually exists. The sample is captured by replaying the collection's list
- * query through the canonical content engine, so when a content session is
- * configured (Convex mode) the inferred field tokens are the collection's real
- * fields; with no session the source is listed but carries no sample.
- */
-export function cmsSourceForCollection(collection) {
-    const source = {
-        kind: 'cms',
-        id: `cms.${collection.id}`,
-        label: humanizeName(collection.id),
-        config: { collectionId: collection.id, filter: {}, limit: 20 },
-    };
-    const sample = captureSourceSample(source);
-    return sample !== undefined ? captureSample(source, sample) : source;
-}
-/**
- * Replay a CMS source's stored query over the configured content session, in
- * delivery shape (EC-166). Returns `undefined` when no session serves the
- * collection (playground / no backend) — the caller then leaves the source
- * sample-less rather than fabricating one. A query the engine rejects — or one
- * matching nothing — yields an empty list / `null`, never a crash.
- */
-function cmsDeliverySample(config) {
-    if (!hasContentSession())
-        return undefined;
-    if (playgroundCollection(config.collectionId) === undefined)
-        return undefined;
-    if (config.documentId !== undefined) {
-        const result = getCollectionDocument(config.collectionId, config.documentId);
-        return result.document ?? null;
-    }
-    const result = runCollectionListQuery(config.collectionId, listQueryOfConfig(config));
-    return result.ok ? result.documents : [];
-}
-//# sourceMappingURL=sample-capture.js.map

package/dist/lib/data/sample-capture.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sample-capture.js","sourceRoot":"","sources":["../../../src/lib/data/sample-capture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAI5D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAEhE,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAEjE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAkB;IACpD,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;IAC7C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAC/F,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO,iBAAiB,CAAC,MAAM,CAAC,MAAwB,CAAC,CAAA;IAC3D,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAyB;IAC9D,MAAM,MAAM,GAAe;QACzB,IAAI,EAAE,KAAK;QACX,EAAE,EAAE,OAAO,UAAU,CAAC,EAAE,EAAE;QAC1B,KAAK,EAAE,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;QAClC,MAAM,EAAE,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;KAC/D,CAAA;IACD,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAA;IAC1C,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;AACtE,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,MAAsB;IAC/C,IAAI,CAAC,iBAAiB,EAAE;QAAE,OAAO,SAAS,CAAA;IAC1C,IAAI,oBAAoB,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC7E,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;QAC5E,OAAQ,MAAM,CAAC,QAAiC,IAAI,IAAI,CAAA;IAC1D,CAAC;IACD,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,YAAY,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAA;IACrF,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAE,MAAM,CAAC,SAAkC,CAAC,CAAC,CAAC,EAAE,CAAA;AACpE,CAAC","sourcesContent":["import { captureSample } from '@elytracms/core/data-binding'\nimport type { DataSource } from '@elytracms/core/data-binding'\nimport type { JsonValue } from '@elytracms/core/project-graph'\nimport type { CollectionDef } from '@elytracms/core/cms-core'\nimport { humanizeName } from '../utils'\nimport { listQueryOfConfig } from '../bindings/section-bindings'\nimport type { QueryCmsConfig } from '../bindings/section-bindings'\nimport {\n  getCollectionDocument,\n  hasContentSession,\n  playgroundCollection,\n  runCollectionListQuery,\n} from './collection-content'\nimport { providerIdOfSource, providerPayload } from './providers'\n\n/**\n * Data-source sample capture (EC-083/EC-166/EC-167). The hosted builder is\n * separate from the site it exports: actually performing a REST fetch / external\n * query happens behind the project-owned adapters in the deployed site, NOT here.\n * So the studio captures a sample ONLY when it can do so honestly — it never\n * fabricates data (Oli, 2026-06-19; cf. backend-mode's \"never silently swap in\n * in-memory storage\", and the v1 \"static props, bindings parked\" direction):\n *\n * - a provider-backed source runs its registered provider (real project code);\n * - a CMS source replays its stored query over the live content session (Convex\n *   mode — EC-177 gap 1), so section/template previews show what delivery serves;\n * - anything else — an external source with no in-studio data path — returns\n *   `undefined`. The source then carries no sample, and the binding UI shows an\n *   honest \"no sample yet\" state instead of inventing rows that aren't there.\n */\nexport function captureSourceSample(source: DataSource): JsonValue | undefined {\n  const providerId = providerIdOfSource(source)\n  if (providerId !== undefined) {\n    return providerPayload(providerId, source.kind === 'convex' ? source.config.args : undefined)\n  }\n  if (source.kind === 'cms') {\n    return cmsDeliverySample(source.config as QueryCmsConfig)\n  }\n  return undefined\n}\n\n/**\n * A live CMS data source for one config-driven collection (EC-192). The binding\n * and condition pickers enumerate `data.sources`; deriving one source per\n * configured content collection — the same set the CMS uses\n * (`resolveDeploymentCollections`) — means what an editor can bind matches what\n * actually exists. The sample is captured by replaying the collection's list\n * query through the canonical content engine, so when a content session is\n * configured (Convex mode) the inferred field tokens are the collection's real\n * fields; with no session the source is listed but carries no sample.\n */\nexport function cmsSourceForCollection(collection: CollectionDef): DataSource {\n  const source: DataSource = {\n    kind: 'cms',\n    id: `cms.${collection.id}`,\n    label: humanizeName(collection.id),\n    config: { collectionId: collection.id, filter: {}, limit: 20 },\n  }\n  const sample = captureSourceSample(source)\n  return sample !== undefined ? captureSample(source, sample) : source\n}\n\n/**\n * Replay a CMS source's stored query over the configured content session, in\n * delivery shape (EC-166). Returns `undefined` when no session serves the\n * collection (playground / no backend) — the caller then leaves the source\n * sample-less rather than fabricating one. A query the engine rejects — or one\n * matching nothing — yields an empty list / `null`, never a crash.\n */\nfunction cmsDeliverySample(config: QueryCmsConfig): JsonValue | undefined {\n  if (!hasContentSession()) return undefined\n  if (playgroundCollection(config.collectionId) === undefined) return undefined\n  if (config.documentId !== undefined) {\n    const result = getCollectionDocument(config.collectionId, config.documentId)\n    return (result.document as unknown as JsonValue) ?? null\n  }\n  const result = runCollectionListQuery(config.collectionId, listQueryOfConfig(config))\n  return result.ok ? (result.documents as unknown as JsonValue) : []\n}\n"]}

package/dist/lib/data/sources-store.d.ts

@@ -1,42 +0,0 @@
-import type { DataSource } from '@elytracms/core/data-binding';
-import type { CmsDocument, CollectionDef } from '@elytracms/core/cms-core';
-import type { OperationResult, OperationsClient } from '../operations/index.js';
-/**
- * Data-source persistence for the Builder's data layer (LIVE-mode gap fix).
- *
- * EC-166/EC-167 made the builder provision per-section (`cms.section.<nodeId>`)
- * and per-template (`cms.template.<pageId>`) CMS sources, but only as session
- * state — the live delivery chain (`convex/delivery.ts` →
- * `apps/example-site/lib/live-content.ts`) had nothing to carry. Following the
- * EC-170 routing-store / EC-169 views-store pattern, sources persist as
- * documents in ONE system collection, one document per source, and every
- * mutation goes through the *existing* `@elytracms/core/operations` commands
- * (`schema.upsertCollection`, `documents.upsert`, `documents.delete`) — no new
- * operations surface, no direct repository access.
- *
- * The record round-trips the FULL canonical `DataSource` shape (including the
- * captured `sample` + inferred `schema` envelope and the cms config's `sort`):
- * `@elytracms/core/data-binding`'s `dataSourceSchema` is the source of truth, applied
- * on both write and read, so a malformed stored record is dropped on load —
- * never a crash, never a half-parsed source.
- */
-export declare const DATA_SOURCES_COLLECTION = "cms-data-sources";
-/** System collection holding one document per persisted {@link DataSource}. */
-export declare const dataSourcesCollectionDef: CollectionDef;
-export declare function sourceToDocument(source: DataSource): CmsDocument;
-export declare function documentToSource(document: CmsDocument): DataSource | undefined;
-/** Load every persisted data source of a project (malformed records dropped). */
-export declare function loadDataSources(operations: OperationsClient, projectId: string): Promise<OperationResult<DataSource[]>>;
-/**
- * Make sure the system collection exists in the project's CMS schema so
- * `documents.upsert` accepts source documents. Idempotent.
- */
-export declare function ensureDataSourcesCollection(_operations: OperationsClient, _projectId: string): Promise<OperationResult<void>>;
-/** Create or update a persisted data source (operations command). */
-export declare function saveDataSource(operations: OperationsClient, projectId: string, source: DataSource): Promise<OperationResult<void>>;
-/**
- * Delete a persisted data source. A source that was never persisted (pure
- * session state, e.g. a seed) deletes as a no-op — `not-found` is success
- * here, since the goal state ("no persisted record") already holds.
- */
-export declare function deleteDataSource(operations: OperationsClient, projectId: string, sourceId: string): Promise<OperationResult<void>>;