@vertebr/react 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,103 @@
+export type FieldType = "string" | "number" | "boolean" | "datetime" | "richtext" | "enum" | "enum[]" | "file[]";
+export type FieldSchema = {
+    type: FieldType;
+    label?: string;
+    required?: boolean;
+    readOnly?: boolean;
+    unique?: boolean;
+    min?: number;
+    max?: number;
+    default?: unknown;
+    options?: string[];
+};
+export type EnvironmentAuthPublic = {
+    required: boolean;
+    claimKey?: string;
+    roles?: string[];
+    client?: {
+        provider: "firebase";
+        config: {
+            apiKey: string;
+            authDomain: string;
+            projectId: string;
+            appId: string;
+            messagingSenderId?: string;
+        };
+        methods?: Array<"email" | "google">;
+    };
+};
+export type AdminEnvironment = {
+    id: string;
+    label: string;
+    tone?: "neutral" | "warn" | "danger";
+    auth?: EnvironmentAuthPublic;
+};
+export type CatalogResource = {
+    id: string;
+    label: string;
+    schema: Record<string, FieldSchema>;
+    permissions: {
+        create?: boolean;
+        update?: boolean;
+        delete?: boolean;
+    };
+};
+export type CatalogConfig = {
+    id: string;
+    label: string;
+    schema: Record<string, FieldSchema>;
+};
+export type BootstrapResponse = {
+    ok: boolean;
+    brand: string;
+    defaultEnvironment: string;
+    environments: AdminEnvironment[];
+};
+export type CatalogResponse = {
+    ok: boolean;
+    brand: string;
+    environment: string;
+    environments: AdminEnvironment[];
+    defaultEnvironment: string;
+    resources: CatalogResource[];
+    configs: CatalogConfig[];
+    metrics?: {
+        id: string;
+        label: string;
+    } | null;
+};
+export type ResourceActionMeta = {
+    label: string;
+    input?: Record<string, FieldType>;
+};
+export type ResourceListResponse = {
+    id: string;
+    label: string;
+    schema: Record<string, FieldSchema>;
+    environment?: string;
+    permissions: CatalogResource["permissions"];
+    actions?: Record<string, ResourceActionMeta>;
+    items: Record<string, unknown>[];
+};
+export type MetricCard = {
+    id: string;
+    label: string;
+    value: string | number;
+    hint?: string;
+    tone?: "neutral" | "ok" | "warn" | "danger";
+};
+export type MetricsResponse = {
+    ok: boolean;
+    id: string;
+    label: string;
+    environment?: string;
+    metrics: MetricCard[];
+};
+export type ConfigResponse = {
+    id: string;
+    label: string;
+    schema: Record<string, FieldSchema>;
+    environment?: string;
+    value: Record<string, unknown>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,UAAU,GACV,UAAU,GACV,MAAM,GACN,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,UAAU,CAAC;QACrB,MAAM,EAAE;YACN,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;YACnB,SAAS,EAAE,MAAM,CAAC;YAClB,KAAK,EAAE,MAAM,CAAC;YACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B,CAAC;QACF,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;KACrC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IACrC,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,WAAW,EAAE;QACX,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC7C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/useVertebrControls.d.ts

@@ -0,0 +1,34 @@
+import { type ReactNode } from "react";
+export type VertebrControlsMap = Record<string, Record<string, unknown>>;
+type ControlsContextValue = {
+    environment: string;
+    controls: VertebrControlsMap;
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+};
+export type VertebrControlsProviderProps = {
+    /** Vertebr API base, e.g. `/admin/api`. */
+    apiBase?: string;
+    /** Active app environment (qual / production). */
+    environment: string;
+    children: ReactNode;
+};
+/**
+ * Loads all public Vertebr controls for the storefront once and shares them.
+ */
+export declare function VertebrControlsProvider({ apiBase, environment, children, }: VertebrControlsProviderProps): import("react").JSX.Element;
+/**
+ * Read a public Vertebr control by id.
+ * Falls back to `fallback` while loading or if the control is missing.
+ */
+export declare function useVertebrConfig<T extends Record<string, unknown>>(id: string, fallback: T): {
+    data: T;
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+};
+/** Access the full public controls map (for gates like comingSoon). */
+export declare function useVertebrControls(): ControlsContextValue;
+export {};
+//# sourceMappingURL=useVertebrControls.d.ts.map

package/dist/useVertebrControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVertebrControls.d.ts","sourceRoot":"","sources":["../src/useVertebrControls.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEzE,KAAK,oBAAoB,GAAG;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAIF,MAAM,MAAM,4BAA4B,GAAG;IACzC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AA2BF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,OAAsB,EACtB,WAAW,EACX,QAAQ,GACT,EAAE,4BAA4B,+BA8B9B;AAYD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,CAAC,GACV;IACD,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAMA;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,IAAI,oBAAoB,CAEzD"}

package/dist/useVertebrControls.js

@@ -0,0 +1,67 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useState, } from "react";
+import { VERTEBR_ENV_HEADER } from "./client";
+const ControlsContext = createContext(null);
+async function fetchPublicControls(apiBase, environment) {
+    const base = apiBase.replace(/\/$/, "");
+    const response = await fetch(`${base}/public/controls`, {
+        headers: {
+            Accept: "application/json",
+            [VERTEBR_ENV_HEADER]: environment,
+        },
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(text || `Failed to load controls (${response.status})`);
+    }
+    const body = (await response.json());
+    return body.configs ?? {};
+}
+/**
+ * Loads all public Vertebr controls for the storefront once and shares them.
+ */
+export function VertebrControlsProvider({ apiBase = "/admin/api", environment, children, }) {
+    const [controls, setControls] = useState({});
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const refresh = useCallback(async () => {
+        setLoading(true);
+        setError(null);
+        try {
+            const next = await fetchPublicControls(apiBase, environment);
+            setControls(next);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error("Failed to load controls"));
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [apiBase, environment]);
+    useEffect(() => {
+        void refresh();
+    }, [refresh]);
+    const value = useMemo(() => ({ environment, controls, loading, error, refresh }), [environment, controls, loading, error, refresh]);
+    return (_jsx(ControlsContext.Provider, { value: value, children: children }));
+}
+function useControlsContext() {
+    const ctx = useContext(ControlsContext);
+    if (!ctx) {
+        throw new Error("useVertebrConfig must be used within VertebrControlsProvider");
+    }
+    return ctx;
+}
+/**
+ * Read a public Vertebr control by id.
+ * Falls back to `fallback` while loading or if the control is missing.
+ */
+export function useVertebrConfig(id, fallback) {
+    const { controls, loading, error, refresh } = useControlsContext();
+    const raw = controls[id];
+    const data = { ...fallback, ...(raw ?? {}) };
+    return { data, loading, error, refresh };
+}
+/** Access the full public controls map (for gates like comingSoon). */
+export function useVertebrControls() {
+    return useControlsContext();
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@vertebr/react",
+  "version": "0.1.0",
+  "description": "Vertebr admin dashboard UI",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && cp src/styles.css dist/styles.css",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run typecheck && npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yaboijams/vertebr.git",
+    "directory": "packages/react"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@hookform/resolvers": "^5.2.1",
+    "@radix-ui/react-label": "^2.1.7",
+    "@radix-ui/react-select": "^2.3.7",
+    "@radix-ui/react-separator": "^1.1.7",
+    "@radix-ui/react-switch": "^1.2.5",
+    "@tanstack/react-table": "^8.21.3",
+    "react-hook-form": "^7.62.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "typescript": "^5.9.2"
+  },
+  "license": "MIT"
+}