@nuasite/collections-admin 0.43.0-beta.4 → 0.43.0-beta.8

package/dist/types/client.js

@@ -1,134 +0,0 @@
-/**
- * Typed read-only client over the cms-sidecar `/cms/v1` HTTP contract.
- *
- * The host (webmaster BFF, or a local dev proxy in F7) mounts the sidecar under
- * an `apiBase` and adds the `/cms/v1` prefix itself — so this client requests
- * `${apiBase}/project`, `${apiBase}/collections`, etc. (never `/cms/v1/...`).
- *
- * The structural model (collections/entries/fields) is reused 1:1 from
- * `@nuasite/cms-types`. The thin HTTP envelope (project model, sparse entries
- * list, error codes) mirrors the sidecar's wire types; it is declared here
- * because those types are not part of the `@nuasite/cms-types` contract surface.
- */
-// ============================================================================
-// Client error
-// ============================================================================
-/**
- * Thrown for any non-2xx response. Carries the parsed sidecar error code so the
- * UI can distinguish auth failures (`unauthorized`/`forbidden`) from a missing
- * collection/entry (`not_found`) or a generic failure.
- */
-export class CmsClientError extends Error {
-    status;
-    code;
-    constructor(status, code, message) {
-        super(message);
-        this.status = status;
-        this.code = code;
-        this.name = 'CmsClientError';
-    }
-    /** Session cookie missing/expired upstream — the user must re-authenticate. */
-    get isUnauthorized() {
-        return this.code === 'unauthorized' || this.status === 401;
-    }
-    /** Authenticated but lacks access to this project. */
-    get isForbidden() {
-        return this.code === 'forbidden' || this.status === 403;
-    }
-    get isNotFound() {
-        return this.code === 'not_found' || this.status === 404;
-    }
-}
-// ============================================================================
-// Client
-// ============================================================================
-function isApiError(value) {
-    return typeof value === 'object'
-        && value !== null
-        && 'error' in value
-        && typeof value.error === 'string'
-        && 'code' in value
-        && typeof value.code === 'string';
-}
-const KNOWN_ERROR_CODES = [
-    'not_found',
-    'conflict',
-    'validation',
-    'parse_error',
-    'io_error',
-    'unsupported',
-    'unauthorized',
-];
-function isErrorCode(value) {
-    return KNOWN_ERROR_CODES.includes(value);
-}
-export function createClient(apiBase) {
-    // Normalise: drop a trailing slash so `${base}${path}` joins cleanly.
-    const base = apiBase.endsWith('/') ? apiBase.slice(0, -1) : apiBase;
-    async function request(path) {
-        const response = await fetch(`${base}${path}`, {
-            method: 'GET',
-            credentials: 'include',
-            headers: { accept: 'application/json' },
-        });
-        if (!response.ok) {
-            throw await toError(response);
-        }
-        // Successful responses are always JSON in the read-only surface.
-        const value = await response.json();
-        return value;
-    }
-    async function toError(response) {
-        // 403 is produced by the BFF (project scope), not the sidecar, so it has no
-        // sidecar `code`; surface it as a distinct `forbidden`.
-        if (response.status === 403) {
-            const message = await readErrorMessage(response, 'You do not have access to this project.');
-            return new CmsClientError(403, 'forbidden', message);
-        }
-        const body = await response.json().catch(() => null);
-        if (isApiError(body) && isErrorCode(body.code)) {
-            return new CmsClientError(response.status, body.code, body.error);
-        }
-        if (response.status === 401) {
-            return new CmsClientError(401, 'unauthorized', 'Your session has expired. Please reload.');
-        }
-        return new CmsClientError(response.status, 'unknown', `Request failed (${response.status})`);
-    }
-    async function readErrorMessage(response, fallback) {
-        const body = await response.json().catch(() => null);
-        if (isApiError(body))
-            return body.error;
-        if (typeof body === 'object' && body !== null && 'error' in body) {
-            const err = body.error;
-            if (typeof err === 'object' && err !== null && 'message' in err && typeof err.message === 'string') {
-                return err.message;
-            }
-        }
-        return fallback;
-    }
-    return {
-        getProject() {
-            return request('/project');
-        },
-        getCollections() {
-            return request('/collections');
-        },
-        getEntries(collection, options = {}) {
-            const params = new URLSearchParams();
-            if (options.fields !== undefined)
-                params.set('fields', options.fields);
-            if (options.draft !== undefined)
-                params.set('draft', options.draft);
-            if (options.cursor !== undefined)
-                params.set('cursor', options.cursor);
-            if (options.limit !== undefined)
-                params.set('limit', String(options.limit));
-            const query = params.toString();
-            const suffix = query === '' ? '' : `?${query}`;
-            return request(`/collections/${encodeURIComponent(collection)}/entries${suffix}`);
-        },
-        getEntry(collection, slug) {
-            return request(`/collections/${encodeURIComponent(collection)}/entries/${encodeURIComponent(slug)}`);
-        },
-    };
-}

package/dist/types/field-view.d.ts

@@ -1,17 +0,0 @@
-/**
- * Read-only field rendering, driven by a collection's `FieldDefinition`.
- *
- * Scalar types (text/number/boolean/date/select/image/url/email/tel/color) show
- * their value directly; structural types (array/object/reference) show their
- * structure. Nothing here mutates — editing arrives in F3.2.
- */
-import type { FieldDefinition } from '@nuasite/cms-types';
-export declare function FieldValueView({ field, raw }: {
-    field: FieldDefinition;
-    raw: string | undefined;
-}): import("react").JSX.Element;
-export declare function FieldRow({ field, raw }: {
-    field: FieldDefinition;
-    raw: string | undefined;
-}): import("react").JSX.Element;
-//# sourceMappingURL=field-view.d.ts.map

package/dist/types/field-view.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"field-view.d.ts","sourceRoot":"","sources":["../../src/field-view.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,oBAAoB,CAAA;AAgDpE,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,+BAmBjG;AAED,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,+BAU3F"}

package/dist/types/field-view.js

@@ -1,77 +0,0 @@
-/**
- * Read-only field rendering, driven by a collection's `FieldDefinition`.
- *
- * Scalar types (text/number/boolean/date/select/image/url/email/tel/color) show
- * their value directly; structural types (array/object/reference) show their
- * structure. Nothing here mutates — editing arrives in F3.2.
- */
-/**
- * Frontmatter values arrive from the sidecar already stringified
- * (`{ value: string; line: number }`). For structural types the string is a
- * JSON payload; we parse it best-effort for a structured render and fall back to
- * the raw string when it is not JSON.
- */
-function parseStructured(raw) {
-    const trimmed = raw.trim();
-    if (trimmed === '')
-        return undefined;
-    if (!(trimmed.startsWith('{') || trimmed.startsWith('[')))
-        return raw;
-    try {
-        return JSON.parse(trimmed);
-    }
-    catch {
-        return raw;
-    }
-}
-function StructuredValue({ raw }) {
-    const parsed = parseStructured(raw);
-    if (parsed === undefined) {
-        return <span className="nua-cadmin-field-empty">—</span>;
-    }
-    if (typeof parsed === 'string') {
-        return <span>{parsed}</span>;
-    }
-    return <pre className="nua-cadmin-field-structured">{JSON.stringify(parsed, null, 2)}</pre>;
-}
-function BooleanValue({ raw }) {
-    const on = raw === 'true' || raw === '1' || raw.toLowerCase() === 'yes';
-    return <span className={on ? 'nua-cadmin-bool-on' : 'nua-cadmin-bool-off'}>{on ? 'Yes' : 'No'}</span>;
-}
-function ImageValue({ raw }) {
-    if (raw === '')
-        return <span className="nua-cadmin-field-empty">—</span>;
-    const looksLikeUrl = /^(https?:\/\/|\/)/.test(raw);
-    return (<div>
-			{looksLikeUrl ? <img className="nua-cadmin-img" src={raw} alt=""/> : null}
-			<div className="nua-cadmin-cell-mono">{raw}</div>
-		</div>);
-}
-const STRUCTURAL_TYPES = new Set(['array', 'object', 'reference']);
-export function FieldValueView({ field, raw }) {
-    if (raw === undefined || raw === '') {
-        return <div className="nua-cadmin-field-value nua-cadmin-field-empty">—</div>;
-    }
-    let content;
-    switch (field.type) {
-        case 'boolean':
-            content = <BooleanValue raw={raw}/>;
-            break;
-        case 'image':
-        case 'file':
-            content = <ImageValue raw={raw}/>;
-            break;
-        default:
-            content = STRUCTURAL_TYPES.has(field.type) ? <StructuredValue raw={raw}/> : <span>{raw}</span>;
-    }
-    return <div className="nua-cadmin-field-value">{content}</div>;
-}
-export function FieldRow({ field, raw }) {
-    return (<div className="nua-cadmin-field">
-			<div className="nua-cadmin-field-label">
-				<span>{field.name}</span>
-				<span className="nua-cadmin-field-type">{field.type}{field.required ? " · required" : ""}</span>
-			</div>
-			<FieldValueView field={field} raw={raw}/>
-		</div>);
-}

package/dist/types/form-model.d.ts

@@ -1,61 +0,0 @@
-/**
- * Pure draft model + field coercion for the entry editor (cms-headless F3.2).
- *
- * The sidecar speaks two slightly different frontmatter shapes:
- *  - `GET …/entries/:slug` returns `frontmatter: Record<string, { value: string; line: number }>`,
- *    where `value` is already stringified (objects/arrays are JSON).
- *  - `PATCH …` accepts `frontmatter?: Record<string, unknown>` of *native* values (merged), and a
- *    `409` `serverFrontmatter` is likewise native (not stringified).
- *
- * The editor works on a single native draft (`EntryDraft`): `frontmatter` is a
- * `Record<string, unknown>` of native JS values keyed by field name, plus the
- * markdown `body`. This module converts to/from the wire and coerces raw input
- * (form strings) into the native value a `FieldType` expects. Keeping it pure
- * (no React/DOM) makes the mapping unit-testable.
- */
-import type { CollectionEntry, FieldDefinition, FieldType } from '@nuasite/cms-types';
-/** The editor's in-memory state: native frontmatter values + the markdown body. */
-export interface EntryDraft {
-    frontmatter: Record<string, unknown>;
-    body: string;
-}
-/**
- * Parse one stringified frontmatter `value` (from `GET …/entries/:slug`) into the
- * native value a field of `type` expects. Structural types (object/array) and
- * unknowns fall back to a best-effort `JSON.parse`; scalars are coerced per type.
- */
-export declare function parseWireValue(type: FieldType, raw: string): unknown;
-/**
- * Build a native draft from a loaded entry, driven by the collection's fields.
- * Frontmatter keys present on the entry but absent from the inferred schema are
- * preserved verbatim (as raw strings) so a save never silently drops them.
- */
-export declare function draftFromEntry(entry: CollectionEntry, fields: FieldDefinition[]): EntryDraft;
-/**
- * Build a fresh draft for a create form from the collection's fields, seeding
- * each field with its `defaultValue` (when present) or a type-appropriate blank.
- */
-export declare function draftForCreate(fields: FieldDefinition[]): EntryDraft;
-/** A type-appropriate empty value used to seed create forms. */
-export declare function blankValue(type: FieldType): unknown;
-/**
- * Adopt a server-provided native frontmatter map (from a `409` `serverFrontmatter`)
- * into a draft, re-coercing per field where a definition exists.
- */
-export declare function draftFromServerFrontmatter(serverFrontmatter: Record<string, unknown>, serverBody: string | undefined, fields: FieldDefinition[]): EntryDraft;
-/**
- * Coerce a raw form-control string into the native value a field expects. Used by
- * the widgets, whose `<input>` values are always strings.
- */
-export declare function coerceInput(type: FieldType, raw: string): unknown;
-/** Render a native value back to a string for a text/number/date/select control. */
-export declare function valueToInput(value: unknown): string;
-/** Read a value as a boolean for toggle widgets, tolerating string encodings. */
-export declare function valueToBoolean(value: unknown): boolean;
-/** Read a value as an array of items for repeater widgets. */
-export declare function valueToArray(value: unknown): unknown[];
-/** Read a value as an object for nested-group widgets. */
-export declare function valueToObject(value: unknown): Record<string, unknown>;
-/** Immutably set a top-level frontmatter key in a draft. */
-export declare function setDraftField(draft: EntryDraft, name: string, value: unknown): EntryDraft;
-//# sourceMappingURL=form-model.d.ts.map

package/dist/types/form-model.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"form-model.d.ts","sourceRoot":"","sources":["../../src/form-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAErF,mFAAmF;AACnF,MAAM,WAAW,UAAU;IAC1B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,IAAI,EAAE,MAAM,CAAA;CACZ;AAMD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAgBpE;AAcD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,UAAU,CAQ5F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,UAAU,CAWpE;AAED,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAWnD;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACzC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,MAAM,EAAE,eAAe,EAAE,GACvB,UAAU,CAUZ;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAkBjE;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKnD;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAItD;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,CAEtD;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErE;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,UAAU,CAEzF"}

package/dist/types/index.js

@@ -1,8 +0,0 @@
-/**
- * `@nuasite/collections-admin` — read-only collections SPA over the cms-sidecar
- * `/cms/v1` HTTP contract (cms-headless F3.1). Host-agnostic: mount
- * `<CollectionsAdminApp apiBase={…} />` and it drives its own internal view-state
- * navigation. Self-contained styles ship at `./styles.css` (imported by the app).
- */
-export { CollectionsAdminApp } from './app';
-export { CmsClientError, createClient, } from './client';